Add Promptkit configuration and inspection seams

docs/internal/app-orchestration.md

@@ -23,6 +23,12 @@ protocols, and report definitions belong in [the CLI reference](../cli.md),
 [the configuration reference](../config.md), [operations](../operations.md),
 and their focused integration and internal documents.
 
+`InspectPromptExecution` is a side-effect-free preflight helper for the prompt
+workflow. It verifies the exact report prompt version, its required YAML input,
+the generated-text JSON Schema contract, the selected profile, and any required
+environment credential before collection or persistence begins. It returns only
+safe project-owned identity and provenance values.
+
 ## Single-Report Workflow
 
 `GenerateDetailed` first collects weather data, then resolves the requested

docs/internal/cli.md

@@ -12,6 +12,11 @@ CLI overrides, obtains the current time, and constructs either an
 `app.GenerateRequest` or an `app.BatchRequest`. It delegates generation and
 batch execution to `internal/app`.
 
+`Runner` also owns a project-owned prompt-executor factory seam. Its production
+factory maps `promptkit` configuration to the Promptkit adapter, while tests can
+inject a factory without importing dependency types. Construction is retained as
+a separate seam until the generation workflow begins using that executor.
+
 For inspection, it loads configuration, builds the appropriate app inspection
 request, and writes the returned value. Inspection is read-only; the inspected
 artifact types and user invocation remain owned by the [CLI reference](../cli.md)