@c4a/context-cli 0.7.0 → 0.7.4

package/plugins/skills/context-markdown-indexer/tests/fixtures/profiles.json

@@ -9,7 +9,7 @@
     "logical_unit_ref": "node:anonymous-domain-reference",
     "canonical_facts": { "target": { "eligible": true } },
     "artifact_policy_variant": "standard",
-    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:source-authority"], "evidence_refs": ["evidence:anonymous-domain-reference-source"] }],
+    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:reader-purpose"], "evidence_refs": ["evidence:anonymous-domain-reference-source"] }],
     "evidence_refs": ["evidence:anonymous-domain-reference-source"]
   },
   {
@@ -22,7 +22,7 @@
     "logical_unit_ref": "node:anonymous-product-requirements",
     "canonical_facts": { "target": { "eligible": true } },
     "artifact_policy_variant": "standard",
-    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:source-authority"], "evidence_refs": ["evidence:anonymous-product-requirements-source"] }],
+    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:reader-purpose"], "evidence_refs": ["evidence:anonymous-product-requirements-source"] }],
     "evidence_refs": ["evidence:anonymous-product-requirements-source"]
   },
   {
@@ -35,7 +35,7 @@
     "logical_unit_ref": "node:anonymous-technical-guide",
     "canonical_facts": { "target": { "eligible": true } },
     "artifact_policy_variant": "standard",
-    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:source-authority"], "evidence_refs": ["evidence:anonymous-technical-guide-source"] }],
+    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:reader-structure"], "evidence_refs": ["evidence:anonymous-technical-guide-source"] }],
     "evidence_refs": ["evidence:anonymous-technical-guide-source"]
   },
   {
@@ -48,7 +48,7 @@
     "logical_unit_ref": "node:anonymous-user-and-developer-guide",
     "canonical_facts": { "target": { "eligible": true } },
     "artifact_policy_variant": "standard",
-    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:source-authority"], "evidence_refs": ["evidence:anonymous-user-and-developer-guide-source"] }],
+    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:reader-operation"], "evidence_refs": ["evidence:anonymous-user-and-developer-guide-source"] }],
     "evidence_refs": ["evidence:anonymous-user-and-developer-guide-source"]
   },
   {
@@ -61,7 +61,7 @@
     "logical_unit_ref": "node:anonymous-public-api-reference",
     "canonical_facts": { "target": { "eligible": true } },
     "artifact_policy_variant": "standard",
-    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:source-authority"], "evidence_refs": ["evidence:anonymous-public-api-reference-source"] }],
+    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:reader-contract"], "evidence_refs": ["evidence:anonymous-public-api-reference-source"] }],
     "evidence_refs": ["evidence:anonymous-public-api-reference-source"]
   },
   {
@@ -74,7 +74,7 @@
     "logical_unit_ref": "node:anonymous-runbook",
     "canonical_facts": { "target": { "eligible": true } },
     "artifact_policy_variant": "standard",
-    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:source-authority"], "evidence_refs": ["evidence:anonymous-runbook-source"] }],
+    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:reader-operation"], "evidence_refs": ["evidence:anonymous-runbook-source"] }],
     "evidence_refs": ["evidence:anonymous-runbook-source"]
   },
   {
@@ -87,7 +87,7 @@
     "logical_unit_ref": "node:anonymous-faq-support",
     "canonical_facts": { "target": { "eligible": true } },
     "artifact_policy_variant": "standard",
-    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:source-authority"], "evidence_refs": ["evidence:anonymous-faq-support-source"] }],
+    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:reader-purpose"], "evidence_refs": ["evidence:anonymous-faq-support-source"] }],
     "evidence_refs": ["evidence:anonymous-faq-support-source"]
   },
   {
@@ -100,7 +100,7 @@
     "logical_unit_ref": "node:anonymous-standard-policy",
     "canonical_facts": { "target": { "eligible": true } },
     "artifact_policy_variant": "standard",
-    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:source-authority"], "evidence_refs": ["evidence:anonymous-standard-policy-source"] }],
+    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:reader-contract"], "evidence_refs": ["evidence:anonymous-standard-policy-source"] }],
     "evidence_refs": ["evidence:anonymous-standard-policy-source"]
   },
   {
@@ -113,7 +113,7 @@
     "logical_unit_ref": "node:anonymous-decision-record",
     "canonical_facts": { "target": { "eligible": true } },
     "artifact_policy_variant": "standard",
-    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:source-authority"], "evidence_refs": ["evidence:anonymous-decision-record-source"] }],
+    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:reader-purpose"], "evidence_refs": ["evidence:anonymous-decision-record-source"] }],
     "evidence_refs": ["evidence:anonymous-decision-record-source"]
   },
   {
@@ -126,7 +126,7 @@
     "logical_unit_ref": "node:anonymous-incident-review",
     "canonical_facts": { "target": { "eligible": true } },
     "artifact_policy_variant": "standard",
-    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:source-authority"], "evidence_refs": ["evidence:anonymous-incident-review-source"] }],
+    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:reader-operation"], "evidence_refs": ["evidence:anonymous-incident-review-source"] }],
     "evidence_refs": ["evidence:anonymous-incident-review-source"]
   },
   {
@@ -139,7 +139,7 @@
     "logical_unit_ref": "node:anonymous-test-validation",
     "canonical_facts": { "target": { "eligible": true } },
     "artifact_policy_variant": "standard",
-    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:source-authority"], "evidence_refs": ["evidence:anonymous-test-validation-source"] }],
+    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:reader-operation"], "evidence_refs": ["evidence:anonymous-test-validation-source"] }],
     "evidence_refs": ["evidence:anonymous-test-validation-source"]
   },
   {
@@ -152,7 +152,7 @@
     "logical_unit_ref": "node:anonymous-release-migration-guide",
     "canonical_facts": { "target": { "eligible": true } },
     "artifact_policy_variant": "standard",
-    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:source-authority"], "evidence_refs": ["evidence:anonymous-release-migration-guide-source"] }],
+    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:reader-operation"], "evidence_refs": ["evidence:anonymous-release-migration-guide-source"] }],
     "evidence_refs": ["evidence:anonymous-release-migration-guide-source"]
   },
   {
@@ -165,7 +165,7 @@
     "logical_unit_ref": "node:anonymous-documentation-site",
     "canonical_facts": { "target": { "eligible": true } },
     "artifact_policy_variant": "standard",
-    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:source-authority"], "evidence_refs": ["evidence:anonymous-documentation-site-source"] }],
+    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:reader-purpose"], "evidence_refs": ["evidence:anonymous-documentation-site-source"] }],
     "evidence_refs": ["evidence:anonymous-documentation-site-source"]
   }
 ]

package/plugins/skills/context-markdown-indexer/tests/fixtures/routing.json

@@ -146,6 +146,128 @@
           ]
         }
       ]
+    },
+    {
+      "id": "anonymous-product-intent",
+      "profile": "product-requirements",
+      "source_role": "authoritative-document",
+      "density_mode": "meso",
+      "candidate_signal": "coherent-product-outcome",
+      "candidate_resolution": "dismiss-with-rationale",
+      "artifacts": [{
+        "artifact_id": "product-intent",
+        "artifact_kind": "content",
+        "boundary_decision": "retain-section-group",
+        "sections": [{ "section_key": "outcome", "owner_indexer_id": "anonymous-markdown-indexer", "document_kind": "product-requirements", "reader_goal": "understand-product-intent", "artifact_kind": "content" }]
+      }]
+    },
+    {
+      "id": "anonymous-public-api-contract",
+      "profile": "public-api-reference",
+      "source_role": "authoritative-document",
+      "density_mode": "meso",
+      "candidate_signal": "contract-and-policy-boundaries",
+      "candidate_resolution": "accept-correction",
+      "artifacts": [
+        { "artifact_id": "api-reference", "artifact_kind": "content", "boundary_decision": "promote-reader-artifact", "sections": [{ "section_key": "operations", "owner_indexer_id": "anonymous-markdown-indexer", "document_kind": "public-api-reference", "reader_goal": "look-up-public-contract", "artifact_kind": "content" }] },
+        { "artifact_id": "contract-policy", "artifact_kind": "content", "boundary_decision": "promote-reader-artifact", "sections": [{ "section_key": "compatibility", "owner_indexer_id": "anonymous-markdown-indexer", "document_kind": "public-contract-policy", "reader_goal": "follow-public-contract-policy", "artifact_kind": "content" }] }
+      ]
+    },
+    {
+      "id": "anonymous-operational-runbook",
+      "profile": "runbook",
+      "source_role": "operational-document",
+      "density_mode": "micro",
+      "candidate_signal": "ordered-recovery-task",
+      "candidate_resolution": "keep-unresolved",
+      "artifacts": [{
+        "artifact_id": "recovery-procedure",
+        "artifact_kind": "content",
+        "boundary_decision": "retain-section-group",
+        "sections": [{ "section_key": "recover", "owner_indexer_id": "anonymous-markdown-indexer", "document_kind": "runbook", "reader_goal": "operate-or-recover-system", "artifact_kind": "content" }]
+      }]
+    },
+    {
+      "id": "anonymous-support-answers",
+      "profile": "faq-support",
+      "source_role": "supporting-document",
+      "density_mode": "micro",
+      "candidate_signal": "independent-reader-question",
+      "candidate_resolution": "accept-correction",
+      "artifacts": [{
+        "artifact_id": "support-answer",
+        "artifact_kind": "content",
+        "boundary_decision": "promote-reader-artifact",
+        "sections": [{ "section_key": "answer", "owner_indexer_id": "anonymous-markdown-indexer", "document_kind": "faq-support", "reader_goal": "resolve-reader-question", "artifact_kind": "content" }]
+      }]
+    },
+    {
+      "id": "anonymous-standard-policy",
+      "profile": "standard-policy",
+      "source_role": "authoritative-document",
+      "density_mode": "single-pass",
+      "candidate_signal": "single-normative-scope",
+      "candidate_resolution": "dismiss-with-rationale",
+      "artifacts": [{
+        "artifact_id": "policy",
+        "artifact_kind": "content",
+        "boundary_decision": "retain-section-group",
+        "sections": [{ "section_key": "requirements", "owner_indexer_id": "anonymous-markdown-indexer", "document_kind": "standard-policy", "reader_goal": "follow-standard-or-policy", "artifact_kind": "content" }]
+      }]
+    },
+    {
+      "id": "anonymous-architecture-decision",
+      "profile": "decision-record",
+      "source_role": "decision-record",
+      "density_mode": "single-pass",
+      "candidate_signal": "decision-with-tradeoffs",
+      "candidate_resolution": "dismiss-with-rationale",
+      "artifacts": [{
+        "artifact_id": "decision",
+        "artifact_kind": "content",
+        "boundary_decision": "retain-section-group",
+        "sections": [{ "section_key": "tradeoffs", "owner_indexer_id": "anonymous-markdown-indexer", "document_kind": "decision-record", "reader_goal": "understand-decision-and-tradeoffs", "artifact_kind": "content" }]
+      }]
+    },
+    {
+      "id": "anonymous-incident-learning",
+      "profile": "incident-review",
+      "source_role": "operational-document",
+      "density_mode": "macro",
+      "candidate_signal": "timeline-and-remediation",
+      "candidate_resolution": "accept-correction",
+      "artifacts": [{
+        "artifact_id": "incident-review",
+        "artifact_kind": "content",
+        "boundary_decision": "retain-section-group",
+        "sections": [{ "section_key": "learning", "owner_indexer_id": "anonymous-markdown-indexer", "document_kind": "incident-review", "reader_goal": "learn-from-incident", "artifact_kind": "content" }]
+      }]
+    },
+    {
+      "id": "anonymous-validation-record",
+      "profile": "test-validation",
+      "source_role": "supporting-document",
+      "density_mode": "meso",
+      "candidate_signal": "acceptance-result",
+      "candidate_resolution": "keep-unresolved",
+      "artifacts": [{
+        "artifact_id": "validation",
+        "artifact_kind": "content",
+        "boundary_decision": "retain-section-group",
+        "sections": [{ "section_key": "result", "owner_indexer_id": "anonymous-markdown-indexer", "document_kind": "test-validation", "reader_goal": "verify-behavior-or-acceptance", "artifact_kind": "content" }]
+      }]
+    },
+    {
+      "id": "anonymous-release-migration",
+      "profile": "release-migration-guide",
+      "source_role": "authoritative-document",
+      "density_mode": "macro",
+      "candidate_signal": "release-and-migration-tasks",
+      "candidate_resolution": "accept-correction",
+      "artifacts": [
+        { "artifact_id": "release-change", "artifact_kind": "content", "boundary_decision": "promote-reader-artifact", "sections": [{ "section_key": "change", "owner_indexer_id": "anonymous-markdown-indexer", "document_kind": "release-guide", "reader_goal": "understand-release-change", "artifact_kind": "content" }] },
+        { "artifact_id": "migration-task", "artifact_kind": "content", "boundary_decision": "promote-reader-artifact", "sections": [{ "section_key": "steps", "owner_indexer_id": "anonymous-markdown-indexer", "document_kind": "migration-guide", "reader_goal": "complete-migration", "artifact_kind": "content" }] }
+      ]
     }
   ]
 }

package/providers/context/actions/advance-current-indexer-lifecycle.yaml

@@ -0,0 +1,6 @@
+schema: agent-graph.action.v1
+id: advance-current-indexer-lifecycle
+description: Advance deterministic Indexer setup, fallback, recovery, and finalization to the next semantic step or Gate.
+runner: command
+effect: write
+command: context run --format json

package/providers/context/actions/configure-indexer-providers.yaml

@@ -3,4 +3,4 @@ id: configure-indexer-providers
 runner: agent
 effect: write
 skill: skills/configure-indexer-providers/SKILL.md
-outputSchema: schemas/indexer-provider-route-input.schema.json
+outputSchema: schemas/indexer-agent-step-result.schema.json

package/providers/context/actions/materialize-indexer-workset-view.yaml

@@ -0,0 +1,7 @@
+schema: agent-graph.action.v1
+id: materialize-indexer-workset-view
+runner: host
+effect: read
+handler: context.materialize-indexer-workset-view/v1
+inputSchema: schemas/indexer-workset-view-materialization-request.schema.json
+outputSchema: schemas/indexer-authorized-workset-view.schema.json

package/providers/context/actions/run-indexer-lifecycle.yaml

@@ -0,0 +1,7 @@
+schema: agent-graph.action.v1
+id: run-indexer-lifecycle
+description: Continue the unique registry-and-Provider Indexer lifecycle until current Candidates exist.
+runner: agent
+effect: write
+skill: skills/run-indexer-lifecycle/SKILL.md
+outputSchema: schemas/indexer-lifecycle-continuation.schema.json

package/providers/context/actions/run-indexer-post-author-composer.yaml

@@ -4,4 +4,4 @@ runner: agent
 effect: write
 skill: skills/run-indexer-post-author-composer/SKILL.md
 inputSchema: schemas/indexer-post-author-fragment-request.schema.json
-outputSchema: schemas/indexer-post-author-fragment-result.schema.json
+outputSchema: schemas/indexer-agent-step-result.schema.json

package/providers/context/codes.yaml

@@ -3,10 +3,6 @@ codes:
   - { code: diagnostic.project-entry-invalid, kind: diagnostic, severity: error, summary: The Context project entry cannot be loaded., document: resources/diagnostics/workspace-state.md }
   - { code: diagnostic.workspace-state-invalid, kind: diagnostic, severity: error, summary: Context cannot establish valid lifecycle facts for the workspace., document: resources/diagnostics/workspace-state.md }
   - { code: diagnostic.structure-snapshot-invalid, kind: diagnostic, severity: error, summary: An active source-bound structure snapshot is invalid., document: resources/diagnostics/workspace-state.md }
-  - { code: diagnostic.phase-source-unresolved, kind: diagnostic, severity: error, summary: A document lifecycle phase cannot resolve its canonical source., document: resources/diagnostics/workspace-state.md }
-  - { code: diagnostic.structure-route-unresolved, kind: diagnostic, severity: error, summary: A staged structure cannot resolve to one source and collection lifecycle., document: resources/diagnostics/workspace-state.md }
-  - { code: diagnostic.compile-route-ambiguous, kind: diagnostic, severity: error, summary: More than one compile lifecycle owns the same source and collection., document: resources/diagnostics/workspace-state.md }
-  - { code: diagnostic.structure-snapshot-missing, kind: diagnostic, severity: error, summary: A compile batch references a missing confirmed structure snapshot., document: resources/diagnostics/workspace-state.md }
   - { code: diagnostic.verify-failed, kind: diagnostic, severity: error, summary: Verification found one or more blocking findings., document: resources/diagnostics/verification.md }
   - { code: diagnostic.projection-stale, kind: diagnostic, severity: info, summary: Approved knowledge changed and deterministic close must refresh its derived projection., document: resources/diagnostics/projection-stale.md }
   - { code: diagnostic.evidence-degraded, kind: diagnostic, severity: warning, summary: Approved knowledge has evidence that cannot currently be rechecked., document: resources/diagnostics/verification.md }
@@ -22,36 +18,19 @@ codes:
   - { code: route.capture.configuration-required, kind: route-reason, summary: Registered document sources are missing capture declarations., document: resources/procedures/project-configuration.md }
   - { code: route.capture.permission-required, kind: route-reason, summary: External document capture requires source-read permission., document: resources/procedures/document-capture.md }
   - { code: route.capture.pending-target, kind: route-reason, summary: Capture the next declared document target., document: resources/procedures/document-capture.md }
-  - { code: route.extract.scope-required, kind: route-reason, summary: Code extraction scope has not been confirmed., document: resources/procedures/code-extraction.md }
-  - { code: route.extract.configuration-required, kind: route-reason, summary: Registered repository sources are missing extraction declarations., document: resources/procedures/project-configuration.md }
-  - { code: route.extract.capability-required, kind: route-reason, summary: One or more code index units require missing material or a narrower plan., document: resources/procedures/code-extraction.md }
-  - { code: route.extract.preview-required, kind: route-reason, summary: Preview all pending code index units before candidate writes., document: resources/procedures/code-extraction.md }
-  - { code: route.extract.ownership-required, kind: route-reason, summary: Revise the index plan so every projected page has one output owner., document: resources/procedures/code-extraction.md }
-  - { code: route.extract.scale-limit-exceeded, kind: route-reason, summary: At least one index unit exceeds the supported page limit., document: resources/procedures/code-extraction.md }
-  - { code: route.extract.pending-target, kind: route-reason, summary: Extract the next pending code target before another workflow family., document: resources/procedures/code-extraction.md }
-  - { code: route.extract.audit-input-required, kind: route-reason, summary: The code-index audit requires specific source or protocol material that is not currently available., document: resources/procedures/code-index-audit.md }
-  - { code: route.extract.audit-guidance-required, kind: route-reason, summary: One or more code-index units still fail absolute quality bounds after three revisions and require one aggregated human direction., document: resources/procedures/code-index-audit.md }
-  - { code: route.extract.audit-revision-required, kind: route-reason, summary: Revise the code-index plan and content for issues confirmed by the Agent audit., document: resources/procedures/code-index-audit.md }
-  - { code: route.extract.audit-required, kind: route-reason, summary: The complete proposed code index requires one Agent semantic audit decision., document: resources/procedures/code-index-audit.md }
-  - { code: route.extract.codeindex-migration-required, kind: route-reason, summary: This workspace still uses the legacy codegraph collection and must be migrated deterministically before code extraction continues., document: resources/procedures/code-extraction.md }
-  - { code: route.document.classification-required, kind: route-reason, summary: A captured document needs an evidence-backed collection decision., document: resources/procedures/document-classification.md }
-  - { code: route.prose.configuration-required, kind: route-reason, summary: A document target is missing a complete prose lifecycle declaration., document: resources/procedures/project-configuration.md }
-  - { code: route.structure.pending-target, kind: route-reason, summary: Prepare the next document structure slot from source evidence., document: resources/procedures/prose-align.md }
-  - { code: route.structure.confirmation-required, kind: route-reason, summary: A staged structure is waiting for confirmation., document: resources/procedures/prose-align.md }
-  - { code: route.structure.confirm, kind: route-reason, summary: Persist the confirmed structure slot., document: resources/procedures/prose-align.md }
-  - { code: route.compile.pending-target, kind: route-reason, summary: Compile the next planned source-bound knowledge view., document: resources/procedures/prose-compile.md }
-  - { code: route.review.identity-conflict, kind: route-reason, summary: Preserve approved ViewRef and path identity before Review., document: resources/procedures/knowledge-review.md }
   - { code: route.review.decision-required, kind: route-reason, summary: The complete current candidate batch needs one review decision set., document: resources/procedures/knowledge-review.md }
   - { code: route.review.apply-managed, kind: route-reason, summary: Apply the current candidate batch under explicit session-managed authority., document: resources/procedures/knowledge-review.md }
   - { code: route.close.projection-stale, kind: route-reason, summary: Rebuild the deterministic approved structure projection., document: resources/procedures/close-and-build.md }
   - { code: route.package.output-required, kind: route-reason, summary: Approved knowledge has no confirmed package output., document: resources/procedures/package-output.md }
   - { code: route.package.configuration-required, kind: route-reason, summary: Declare the confirmed package output in the Context project., document: resources/procedures/package-output.md }
   - { code: route.package.template-review-required, kind: route-reason, summary: "Replace or edit package templates, or explicitly accept the generic defaults.", document: resources/procedures/package-output.md }
-  - { code: route.document-revision.requested, kind: route-reason, summary: Apply and validate the user's requested correction on one approved knowledge page., document: resources/procedures/document-revision.md }
-  - { code: route.document-optimization.pending, kind: route-reason, summary: Resolve the current source-faithful document revision batch before building packages., document: resources/procedures/document-optimization.md }
-  - { code: route.document-optimization.guidance-required, kind: route-reason, summary: The same document revision quality problem remains after three attempts and requires one aggregated human direction., document: resources/procedures/document-optimization.md }
   - { code: route.build.package-stale, kind: route-reason, summary: Build the declared package outputs from current approved knowledge., document: resources/procedures/close-and-build.md }
   - { code: route.logs.delivery-pending, kind: route-reason, summary: Send locally queued runtime logs through the configured generic sink., document: resources/procedures/close-and-build.md }
+  - { code: route.indexer.lifecycle-required, kind: route-reason, summary: Continue the sole registry-and-Provider indexing lifecycle until current Candidates exist. }
+  - { code: route.indexer.lifecycle-advance, kind: route-reason, summary: Advance deterministic Indexer lifecycle state to the next Agent step or user Gate. }
+  - { code: route.indexer.semantic-structure-review, kind: route-reason, summary: Review the complete semantic structure and create-or-enrich targets before Author work starts. }
+  - { code: route.indexer.recovery-required, kind: route-reason, summary: "Resolve a persisted source, material, or execution failure before retrying the Indexer lifecycle." }
+  - { code: route.indexer.layout-confirmation-required, kind: route-reason, summary: Confirm the proposed knowledge layout change or reject it with revision feedback. }
   - { code: route.indexer.agent-step, kind: route-reason, summary: Run one digest-bound Indexer workset with the static Context Agent Action. }
   - { code: route.indexer.provider-configuration, kind: route-reason, summary: Configure an exact path-free Provider selection from currently visible Indexer Skills. }
   - { code: route.indexer.markdown-capture-validation, kind: route-reason, summary: Require exact current document capture before discovering a semantic Markdown Provider. }
@@ -64,12 +43,11 @@ codes:
   - { code: route.indexer.customization-validation, kind: route-reason, summary: Validate and content-address stage one exact minimal customization draft without project source writes. }
   - { code: route.indexer.customization-project-preparation, kind: route-reason, summary: Resolve the exact Providers and stage one CAS-bound customization project proposal. }
   - { code: route.indexer.project-observation, kind: route-reason, summary: Observe the complete applied target set and rerun finalized selection validation. }
-  - { code: route.indexer.contract-overlay-validation, kind: route-reason, summary: Recompute data-only contract overlay conformance and resolve its trust path. }
+  - { code: route.indexer.contract-overlay-validation, kind: route-reason, summary: Recompute data-only contract overlay conformance and issue a digest-bound validation receipt. }
   - { code: route.indexer.requirement-confirmation-routing, kind: route-reason, summary: Revalidate the comparator report and select the ordinary or contraction confirmation Gate. }
   - { code: route.indexer.requirement-confirmation, kind: route-reason, summary: "Confirm an initial, equivalent, or strengthening requirement workset." }
   - { code: route.indexer.requirement-contraction, kind: route-reason, summary: Require non-delegable human confirmation for contraction or incomparable obligation replacement. }
-  - { code: route.indexer.contract-overlay-authorization, kind: route-reason, summary: Authorize one exact current-project contract overlay after conformance passes. }
-  - { code: route.indexer.overlay-question-proposal, kind: route-reason, summary: Propose namespaced question bindings from one current trusted overlay. }
+  - { code: route.indexer.overlay-question-proposal, kind: route-reason, summary: Propose namespaced question bindings from one current validated overlay. }
   - { code: route.indexer.overlay-question-rebind, kind: route-reason, summary: Revalidate an overlay requirement and build one coupled registry proposal. }
   - { code: route.indexer.dependency-authorization, kind: route-reason, summary: Authorize one exact staged dependency intent set with install scripts disabled. }
   - { code: route.indexer.program-execution-authorization, kind: route-reason, summary: Authorize one exact non-allowlisted Provider program for trusted non-sandboxed execution. }
@@ -99,25 +77,7 @@ codes:
   - { code: route.indexer.post-author-observation, kind: route-reason, summary: Join current composer worksets with their ledger and publish independent completion Facts. }
   - { code: route.indexer.post-author-composition, kind: route-reason, summary: Compose the current result envelope after every selected composer is accepted. }
   - { code: route.indexer.result-reconciliation, kind: route-reason, summary: Recompute per-domain completion and emit exact capability or material gaps before reporting success. }
-  - { code: route.indexer.material-question-workset, kind: route-reason, summary: Build immutable question-target pairs and derive exact answer eligibility from current registry authority. }
-  - { code: route.indexer.material-answer-run-preparation, kind: route-reason, summary: Recover content-addressed material-answer runs and accepted empty or non-empty Results. }
-  - { code: route.indexer.material-answer-observation, kind: route-reason, summary: "Publish material-answer counts, next refs, candidates, and unresolved question keys." }
-  - { code: route.indexer.material-answer-run-start, kind: route-reason, summary: Persist one exact pending or stale material-answer run before dispatch. }
-  - { code: route.indexer.material-answer-agent-step, kind: route-reason, summary: Run one semantic-operation-gated material-answer request without rerunning main extraction. }
-  - { code: route.indexer.material-answer-run-acceptance, kind: route-reason, summary: Validate current source-span read receipts and atomically accept one material-answer Result. }
-  - { code: route.indexer.material-answer-run-failure, kind: route-reason, summary: Persist one exact material-answer failure without accepting partial evidence. }
-  - { code: route.indexer.material-answer-review, kind: route-reason, summary: Approve or reject only one exact material-answer evidence binding; final reader content remains unapproved. }
-  - { code: route.indexer.material-gap-audit, kind: route-reason, summary: Read-only recompute the expected retained material-gap ledger and route pre-Review drift to checkpoint or post-Review closure to close. }
-  - { code: route.indexer.material-gap-checkpoint, kind: route-reason, summary: Recompute and durably checkpoint the retained material-gap ledger before any blocking outcome. }
-  - { code: route.indexer.material-answer-review-checkpoint, kind: route-reason, summary: Persist one exact answer-approved successor under retained ledger CAS. }
-  - { code: route.indexer.candidate-review-readiness, kind: route-reason, summary: Prove exact precompile and postcompile mechanical audits are current for the effective candidate revision. }
   - { code: route.indexer.candidate-compile, kind: route-reason, summary: Compile Candidate Artifacts from the exact accepted author IndexerResult set and authorized layout. }
   - { code: route.indexer.incremental-impact, kind: route-reason, summary: "Report exact logical-unit, Artifact, and Section impact from complete current Merkle dependency views." }
-  - { code: route.indexer.profile-revision, kind: route-reason, summary: Revise one exact candidate set against the recorded runtime profile failure without changing baseline authority. }
-  - { code: route.indexer.profile-revision-record, kind: route-reason, summary: Record one distinct result revision under the stable problem lineage and three-attempt ledger CAS. }
-  - { code: route.indexer.profile-failure-report, kind: route-reason, summary: "Persist the complete module, artifact, metric, attempt, missing-input, and capability-loss report after three failures." }
-  - { code: route.indexer.profile-override, kind: route-reason, summary: Require the user to force approve one exact current runtime profile risk through a non-delegable Gate. }
-  - { code: route.indexer.candidate-review, kind: route-reason, summary: Review the exact current candidate set only after the mechanical audit readiness proof passes. }
-  - { code: route.indexer.material-gap-evaluation, kind: route-reason, summary: Derive layout and main Review admission from the current retained ledger. }
-  - { code: route.indexer.material-answer-actualization, kind: route-reason, summary: Map answer-approved landings to current Artifact or Section identities and checkpoint the result. }
-  - { code: route.indexer.approved-knowledge-close, kind: route-reason, summary: Atomically close approved Indexer structure with exact resolved material-answer provenance. }
+  - { code: route.indexer.candidate-review, kind: route-reason, summary: Review the exact current candidate set only after current mechanical validation passes. }
+  - { code: route.indexer.approved-knowledge-close, kind: route-reason, summary: Atomically close approved Indexer structure after required material gaps are resolved. }