Refresh documentation and policies and simplify releases

docs/internal/llm-runtime.md

@@ -11,44 +11,36 @@ All runtime LLM calls go through `contracts.StructuredLLMClient`.
 Primary adapter:
 - `internal/framework/llm/OpenAICompatibleClient`
 
-## Request/Response Behavior
+## Adapter and Response Schema Registry
 
-The OpenAI-compatible adapter sends chat completions requests with:
-- model;
-- messages;
-- `response_format.type = json_schema`;
-- strict schema envelope (`name`, `schema`, `strict=true`).
+The adapter implements the [LLM wire contract](../integrations/openai-compatible-llm.md).
+It maps internal structured requests to HTTP messages and decodes provider content
+into the supplied Go output target. Endpoint, authentication, response shapes, and
+retry conditions are defined in that contract rather than repeated here.
 
-The response is decoded into the requested structured output target.
+`internal/framework/responseschema` stores the per-call response schema definitions
+and diagnostic metadata. Proposal generation and validation choose their schema
+before invoking the client. Provider strict mode does not replace local checks.
 
-## Response Schema Registry
+## Error Classification
 
-Structured response schemas are registered in `internal/framework/responseschema`:
-- `correction_set`
-- `validator_decision_set`
-
-Each schema includes stable diagnostics metadata (`id`, `version`, `name`, `sha256`).
-
-## Retries and Error Handling
-
-Adapter retries apply to retryable conditions (for example transport/decoding/retryable status classes) up to configured `max_retries`.
-
-Errors are sanitized to redact configured API-key values before surfacing.
-
-Malformed structured output detection is shared through `internal/framework/structuredoutput` and is used by:
-- proposal generation;
-- LLM-backed validators.
+The adapter marks retryable errors internally and uses context state and attempt
+count to decide whether to retry. It sanitizes errors before returning them.
+`internal/framework/structuredoutput` classifies malformed output for proposal
+and validator call sites, which can turn those errors into warnings and rejected
+section/batch work. Other errors propagate through the runner.
 
 ## Scheduling and Concurrency
 
 `internal/framework/llm/Scheduler` provides FIFO, context-aware permit gating.
 
-Runner composes scheduler limits across:
-- total LLM concurrency;
-- proposal LLM concurrency;
-- validation LLM concurrency.
+CLI orchestration composes global and stage schedulers; runner instrumentation
+measures them. Limit definitions and inheritance belong to
+[configuration](../config.md#concurrency).
 
-Scheduler release is guarded to avoid permit leaks on cancellation/error.
+Scheduler release is guarded to avoid permit leaks on cancellation/error. Runner
+collects utilization observations; their serialized shape is defined by the
+[output-file contract](../integrations/output-files.md#utilization-diagnostics).
 
 ## Diagnostics and Redaction
 
@@ -58,6 +50,14 @@ Configured secrets are derived from `llm.ConfiguredSecrets(cfg)` and redacted fr
 - diagnostics payloads;
 - surfaced runtime/adapter errors.
 
+## Changing LLM Integration or Scheduling
+
+Review client, scheduler, redaction, and structured-output malformed-response
+coverage alongside runner orchestration and utilization tests. Use the
+[testing policy](../policy/testing.md) to select sufficient checks; preserve the
+[LLM integration contract](../integrations/openai-compatible-llm.md) and
+[architecture invariants](../policy/architecture.md#correction-and-concurrency-invariants).
+
 ## Key Tests
 
 - `internal/framework/llm/openai_compatible_client_test.go`
@@ -65,3 +65,4 @@ Configured secrets are derived from `llm.ConfiguredSecrets(cfg)` and redacted fr
 - `internal/framework/llm/diagnostics_test.go`
 - `internal/framework/responseschema/registry_test.go`
 - `internal/framework/structuredoutput/malformed_test.go`
+- `internal/framework/runner/*_test.go` (orchestration and utilization)