Project terminal execution observations into shared reports

docs/internal/adapters.md

@@ -23,6 +23,8 @@ described by its tagged
   and errors to HTTP DTOs.
 - `internal/format` renders `promptkit.PreparedRun` values as deterministic text
   or JSON.
+- `internal/report` maps Promptkit's terminal execution event to a small
+  application-owned value without invoking the engine or writing output.
 
 ## Wiring Flows
 
@@ -71,6 +73,11 @@ Failure mapping uses `errors.Is` against Promptkit's public sentinels and the
 HTTP reader's Scriptorium-owned containment and size errors. Wrapped reader
 errors preserve their identity through Promptkit's artifact-load boundary.
 
+The report collector is per invocation. It ignores nonterminal events and
+copies terminal aggregates once, including usage presence and completeness.
+It retains no history or shared state; adapters decide whether to attach it and
+how to present its snapshot.
+
 ## Package-Local Guarantees
 
 - Adapters contain no copied framework types or orchestration.

docs/internal/overview.md

@@ -12,6 +12,7 @@ public behavior belongs in the linked contracts.
 | `internal/config` | Discovers and strictly decodes application configuration and applies built-in and CLI precedence. | [configuration contract](../config.md), [adapter internals](adapters.md) |
 | `internal/defaults` | Holds Scriptorium-owned application and HTTP defaults. | [configuration contract](../config.md) |
 | `internal/format` | Formats Promptkit prepared-run and prompt/profile inspection values for CLI text or JSON output. | [CLI contract](../cli.md), [adapter internals](adapters.md) |
+| `internal/report` | Projects one terminal Promptkit observation into Scriptorium-owned execution metadata. | [adapter internals](adapters.md) |
 
 Framework implementation packages are provided by
 [Promptkit v0.11.0](https://gitea.maximumdirect.net/eric/promptkit/src/tag/v0.11.0/docs/consumers/pkg-promptkit.md)