Support internal reasoning effort overrides

docs/internal/cli.md

@@ -61,6 +61,12 @@ construction errors are returned before a pipeline is prepared. Configuration
 field definitions remain in [Configuration](../config.md#promptkit-profiles);
 the adapter mechanics remain in [LLM Runtime](llm.md).
 
+The factory also accepts `LLMRuntimeOverrides`, whose reasoning pointer
+preserves inherit, replace, and clear states across the composition boundary.
+Run orchestration currently passes the zero value, so production execution
+inherits the selected PromptKit profile. No command flag or Notarius
+configuration field exposes this internal override yet.
+
 ## Run Orchestration
 
 After parsing and validating a run invocation, the CLI performs this ordered

docs/internal/llm.md

@@ -36,6 +36,13 @@ validated raw bytes rather than re-encoding the decoded target. An empty
 optional material is represented as one space so its named input is retained
 by PromptKit.
 
+Client construction may also receive a run-wide reasoning-effort override from
+the CLI factory boundary. The adapter copies the caller-owned pointer and
+creates a fresh PromptKit execution override for each request: a nil pointer
+inherits the selected profile, a non-empty value replaces it, and an empty
+value clears inherited reasoning. Ordinary CLI execution currently supplies no
+override, so profile behavior remains unchanged.
+
 An empty request profile lets the prompt select its configured default. The CLI
 prepares every explicitly selected binding profile before a run begins, so a
 missing explicit profile fails before stage execution. Calls record the profile