Add report artifact inspection commands

docs/cli.md

@@ -50,6 +50,12 @@ weatherreporter generate weekend
 weatherreporter generate storm --start 2026-05-29T18:00 --end 2026-05-30T06:00
 weatherreporter run morning
 weatherreporter run evening
+weatherreporter inspect reports
+weatherreporter inspect metadata RUN_ID
+weatherreporter inspect briefing RUN_ID
+weatherreporter inspect data-package RUN_ID
+weatherreporter inspect prior RUN_ID
+weatherreporter inspect sources RUN_ID
 ```
 
 `generate daily`, `generate tomorrow`, `generate three-day`,
@@ -63,6 +69,9 @@ an independent report failure, print a JSON aggregate summary to stdout, write
 compact report status logs to stderr, and return nonzero when any report
 failed.
 
+`inspect` commands read the configured workspace and emit JSON to stdout. They
+do not fetch weather data or invoke `scriptorium`.
+
 ## Flags
 
 - `-h`, `--help`: show help.
@@ -74,6 +83,25 @@ failed.
 - `--date YYYY-MM-DD`: optional date for `generate daily`; defaults to the current local date in the configured timezone.
 - `--start TIME`: required start time for `generate storm`.
 - `--end TIME`: required end time for `generate storm`.
+- `--limit N`: maximum report records for `inspect reports`; defaults to 20,
+  and `0` means no limit.
 
 Storm times accept `YYYY-MM-DDTHH:MM` in the configured timezone or RFC3339
 timestamps with explicit offsets.
+
+## Inspection
+
+```sh
+weatherreporter inspect reports --limit 10
+weatherreporter inspect metadata 20260529T100000.000000000Z_daily_today
+weatherreporter inspect briefing 20260529T100000.000000000Z_daily_today
+weatherreporter inspect data-package 20260529T100000.000000000Z_daily_today
+weatherreporter inspect prior 20260529T100000.000000000Z_daily_today
+weatherreporter inspect sources 20260529T100000.000000000Z_daily_today
+```
+
+`inspect reports` lists recent generated runs with artifact paths and warning
+counts. The other commands require a RunID. `inspect prior` returns the prior
+comparable snapshot metadata selected from stored metadata, or `null` when no
+prior comparable snapshot exists. `inspect sources` shows source provenance and
+source warnings without dumping full weather payloads.