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.

docs/internal/state.md

@@ -27,6 +27,8 @@ Outputs:
 - metadata JSON
 - prior comparable snapshot metadata when available
 - prior briefing package when loaded by path
+- recent report records for inspection
+- metadata and data package lookup by RunID
 
 ## Boundaries
 
@@ -54,8 +56,10 @@ date and returns the latest earlier compatible run. Daily Today and Daily
 Tomorrow are compatible with each other; 3-Day Outlook is compatible with prior
 3-Day Outlook snapshots; Weekend Outlook is compatible with prior Weekend
 Outlook snapshots for the same weekend window. The store can load a briefing
-snapshot by path for structured comparison. The store prepares the managed
-Markdown report path before `scriptorium run` writes it.
+snapshot by path for structured comparison. The store can list metadata-backed
+report records and load metadata or data packages by RunID for inspection. The
+store prepares the managed Markdown report path before `scriptorium run` writes
+it.
 
 ## Failure Behavior
 

docs/operations.md

@@ -123,6 +123,26 @@ Each generated report writes metadata that links:
 Run summaries include each report ID, prompt ID, RunID, status, error text when
 applicable, valid period, and artifact paths known to the application.
 
+## Inspection
+
+Use `weatherreporter inspect reports` to list recent generated runs from the
+configured workspace. The output includes RunID, report ID, valid period,
+metadata path, briefing path, report path, and source warning count.
+
+Run-specific inspection commands emit JSON for a single RunID:
+
+```text
+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
+```
+
+`inspect prior` shows the prior comparable snapshot selected from stored
+metadata, or `null` when none exists. `inspect sources` shows source provenance
+and source warnings without dumping full weather payloads.
+
 ## Recent Changes
 
 When a prior comparable Daily briefing snapshot exists for the same valid local