Add Promptkit configuration and inspection seams

docs/config.md

@@ -145,6 +145,21 @@ source keys are `observations`, `current`, `narrative`, `alerts`, `discussion`,
 | `timeout` | `2m` | Must be greater than zero. |
 | `extra_args` | empty | Optional extra arguments passed to Scriptorium commands. |
 
+### `promptkit`
+
+Promptkit configuration prepares the local executor and prompt/profile checks.
+Scriptorium remains the active generator until the Promptkit execution workflow
+is enabled.
+
+| Field | Default | Rules |
+| --- | --- | --- |
+| `profile` | empty | Optional explicit execution profile. Otherwise the prompt's declared default is used. |
+| `profile_file` | empty | Optional external profile file. Cannot be combined with `profile_dir`. |
+| `profile_dir` | empty | Optional external profile directory. Cannot be combined with `profile_file`. |
+| `timeout` | `2m` | Must be greater than zero. |
+| `local.endpoint` | empty | Optional absolute URL for the conventional local backend. A blank endpoint leaves it unregistered. |
+| `local.concurrency_limit` | `1` | Maximum local backend concurrency. `0` is unlimited; negative values are invalid. |
+
 ### `workspace`
 
 | Field | Default |

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)