Implemented debug artifacts for the distributor notification adapter

docs/internal/app-orchestration.md

@@ -81,12 +81,17 @@ Single-report generation follows this order:
 14. Save metadata with the managed report path.
 15. If distributor notification is enabled, notify using the managed report
     path as the source file.
+16. Save a distributor notification debug artifact and update metadata with its
+    path.
 
 If render preflight returns both a result and an error, preflight JSON and
 metadata are persisted before the error is returned. If Scriptorium report
 generation returns an error after writing output, the managed report and
 metadata remain inspectable. Notification is not attempted after Weather API,
 briefing, prompt input, render, Scriptorium run, or metadata-save failures.
+When notification is attempted, the debug artifact records request identity,
+accepted upload fields, distributor status fields, raw status report JSON when
+available, and redacted failure context.
 `--out` copies are never used as notification source files.
 
 ## Batch Workflow

docs/internal/distributor-adapter.md

@@ -8,7 +8,8 @@ This document describes the distributor upload adapter in
 The adapter submits generated weatherreporter Markdown reports to a configured
 distributor HTTP upload endpoint. It isolates distributor package types,
 token-env lookup, upload client construction, source-bundle file mapping,
-timeout handling, and upload error wrapping from app orchestration.
+timeout handling, status polling, and upload error wrapping from app
+orchestration.
 
 ## Inputs And Outputs
 
@@ -21,12 +22,14 @@ Inputs:
 - idempotency key
 - source Markdown report path
 - bundle-relative Markdown path
+- bundle created timestamp
 - context for cancellation
 
 Outputs:
 
 - accepted distributor run ID
-- accepted distributor status
+- accepted distributor upload status
+- distributor run status, status polling error, and raw run report JSON when available
 - weatherreporter-owned idempotency conflict error when applicable
 
 ## Boundaries
@@ -66,11 +69,21 @@ The adapter calls distributor `UploadFiles` with exactly one file:
 
 - source path: the managed Markdown report path selected by app orchestration
 - bundle path: the rendered bundle-relative report path
+- created: the report generation timestamp
 
 The adapter creates a distributor upload client with the configured endpoint,
 bearer token, and timeout-backed HTTP client. It also wraps the upload context
 with the configured timeout when the timeout is greater than zero.
 
+After upload acceptance, the adapter polls distributor `Status` for the accepted
+run ID until the run reaches `succeeded` or `failed`, or until the configured
+timeout expires. It returns the latest status, error text, and raw report JSON in
+weatherreporter-owned types so app orchestration can persist them in the
+notification debug artifact. Status lookup failures or timeout before a terminal
+state are kept as debug status errors on an otherwise accepted upload. A
+terminal distributor run status of `failed` is returned as a notification failure
+with the status report preserved.
+
 ## Failure Behavior
 
 The adapter validates required endpoint, token env name, token value, bundle ID,

docs/internal/state.md

@@ -47,6 +47,7 @@ converts adapter render results into that shape before saving.
 - `workspace.reports_dir`
 - `workspace.data_packages_dir`
 - `workspace.preflight_dir`
+- `workspace.notifications_dir`
 
 Workspace subdirectories must be relative paths that stay under
 `workspace.root`.
@@ -62,12 +63,14 @@ valid-period start date for JSON artifacts, and the RunID.
   snapshots/<artifact_group>/<YYYY-MM-DD>/<run_id>.metadata.json
   data-packages/<artifact_group>/<YYYY-MM-DD>/<run_id>.data_package.json
   preflight/<artifact_group>/<YYYY-MM-DD>/<run_id>.render.json
+  notifications/<artifact_group>/<YYYY-MM-DD>/<run_id>.distributor.json
   reports/<artifact_group>/<run_id>.md
 ```
 
 Metadata is stored beside briefing snapshots and links the briefing, data
-package, preflight, report paths, and configured prompt location. Report
-listing walks metadata files under the snapshots directory.
+package, preflight, report paths, notification path when attempted, and
+configured prompt location. Report listing walks metadata files under the
+snapshots directory.
 
 ## Prior Lookup
 
@@ -89,6 +92,8 @@ current report definition.
 Durable JSON writes use shared atomic file helpers. Managed Markdown reports are
 prepared by creating their parent directory; Scriptorium writes the report body
 to the prepared path. Extra Markdown copies are handled by app orchestration.
+Distributor notification debug artifacts are written atomically when
+notification is attempted.
 
 Inspection helpers read existing metadata, briefing, and data package files.
 Missing metadata directories return no inspection records or no prior snapshot