diff --git a/docs/config.md b/docs/config.md index 75abb47a..f86db6b8 100644 --- a/docs/config.md +++ b/docs/config.md @@ -352,8 +352,11 @@ with an empty chain; a nonempty list replaces it in listed order. Null is not an empty list. Validator bindings accept only `module`, optional LLM-backed `llm_profile`, and `options`; they have no separate producer mode, semantic-turn allowance, references, or nested validators. Each validator executes once per -candidate assessment. Intrinsic typed codec/source checks remain even with an -empty configured chain. +candidate assessment. Intrinsic codec/schema checks remain with an empty chain, +as do source parsing, plan materialization, and necessary module/fallback/cache +construction checks. Ordinary artifact citation existence/containment checks +are supplied by configured validators and can be omitted by chain replacement. +See [default chains](#production-validator-keys-and-default-chains). The `json` output options are: diff --git a/docs/internal/pipeline.md b/docs/internal/pipeline.md index 33b130f9..3f9a7a96 100644 --- a/docs/internal/pipeline.md +++ b/docs/internal/pipeline.md @@ -73,8 +73,10 @@ chunks. Source, references, annotations, and metadata views are isolated too. [Assessment values](../../internal/framework/contracts/assessment.go) distinguish approval, semantic rejection, failure, and unavailable judgment. An empty configured -chain adds no ordinary acceptance criteria, but cannot remove intrinsic codec or -source-addressing checks. Rejection guidance is module-authored, ordered, and +chain adds no ordinary acceptance criteria. Intrinsic codecs, source parsing, +materialization, and necessary module/fallback/cache checks remain; ordinary +artifact citation checks depend on the [configured chain](../config.md#module-bindings-and-validators). +Rejection guidance is module-authored, ordered, and deduplicated separately from reason codes/operator messages. Invalid guidance is a contract failure, not invented correction text. LLM validators execute directly on the shared engine and do not own another semantic loop. diff --git a/docs/policy/architecture.md b/docs/policy/architecture.md index b2a5b5d1..d407e921 100644 --- a/docs/policy/architecture.md +++ b/docs/policy/architecture.md @@ -228,8 +228,10 @@ initiates fallback. Exact mode and turn controls belong in [Configuration](../co Default validator chains remain central production composition policy. Configuration can replace a stage-local default, including with an explicit empty -chain. Configured order is authoritative. Intrinsic codec/source correctness -still applies with an empty chain. +chain. Configured order is authoritative. Intrinsic codec validation, source +parsing, plan materialization, and necessary module/fallback/cache construction +checks remain. Ordinary artifact citation existence/containment checks depend on +the configured chain; see [validator configuration](../config.md#module-bindings-and-validators). ## Native Execution Boundary diff --git a/docs/roadmap/implementation.md b/docs/roadmap/implementation.md index 2dbc9f8c..c408b258 100644 --- a/docs/roadmap/implementation.md +++ b/docs/roadmap/implementation.md @@ -502,7 +502,9 @@ Stage 27 adds cache selection to this same helper, not a parallel executor. execution options, and operation-scoped assessors. The runner consumes native helper outcomes without outer retries or revalidation; deterministic modules produce once and are assessed directly, with an optional module-owned fallback -function. Final codec/source checks remain mandatory. Fallback eligibility follows +function. Final codec checks remain mandatory; ordinary artifact citation checks +depend on configured validators. Necessary source parsing/materialization and +module/fallback/cache construction checks remain. Fallback eligibility follows chunk ancestry, lane results, and actual generated-reference consumers without tainting unrelated work; emitting operations contribute once to fallback_count. Removed superseded attempt/correction hooks and their debug/policy projections. diff --git a/docs/roadmap/remediation.md b/docs/roadmap/remediation.md index a5e162cd..9a6aa97c 100644 --- a/docs/roadmap/remediation.md +++ b/docs/roadmap/remediation.md @@ -91,6 +91,10 @@ impact is smaller than the document/cache indexing findings below. ## Finding 2: Narrow The Documented Empty-Validator-Chain Guarantee +**Status: Complete.** Architecture, configuration, pipeline internals, and the +active plan now distinguish intrinsic checks from configurable citation checks. +Documentation links and whitespace were checked; runtime behavior is unchanged. + Priority: P2. Relevant stages: 11, 38, 39, and 42. ### Evidence And Impact