@c4a/context-cli 0.6.18 → 0.6.19

package/docs/document-optimization.md

@@ -1,9 +1,8 @@
 # Document revisions
 
-New workspaces enable conservative document optimization by default. It is a
-build phase for source-backed prose that repairs presentation-level Markdown,
-links, and obvious local errors without changing the approved knowledge page or
-broadly rewriting its meaning.
+New workspaces enable source-constrained editorial revision by default. It is a
+build phase for source-backed prose that improves publication value and
+readability without changing the approved knowledge page or inventing facts.
 
 To opt out during initialization:
 
@@ -19,9 +18,22 @@ context optimize-docs disable
 context status --format json
 ```
 
-When enabled, the workflow plans only new or changed fragments. The Agent may
-keep a fragment unchanged or apply a conservative replacement. Only changed
-pages receive a full revision beside their approved page:
+When enabled, the workflow plans only new or changed source Sections. For each
+Section the CLI reports mechanical signals and allowed actions. The Agent may
+keep it, repair local presentation, reshape it within the same source boundary,
+or omit it when the CLI confirms a non-knowledge reason. Only changed pages
+receive a full revision beside their approved page:
+
+Signals are review leads rather than a complete readability verdict. The Agent
+must read every Section. Keeping a signaled Section requires a concrete,
+decision-only assessment explaining why each signal is a false positive or why
+editing would reduce source fidelity. The assessment names every reported
+signal code so the CLI can verify complete coverage; it is never published.
+Time, cost, workload, batch size, or delivery pressure are not valid keep or
+defer reasons. Fully managed operation applies all safe repairs, reshapes, and
+eligible omissions autonomously; only genuinely unavailable semantic input is
+batched for the user. A large fragment set must meet the same quality standard
+as a single fragment.
 
 ```text
 knowledge/guides/setup.md
@@ -32,10 +44,21 @@ The `__revision.md` suffix is reserved. Default knowledge discovery, structure,
 search, and package selection exclude revision files. Validation and build
 associate a revision with its sibling base page and apply it under the original
 package path. A revision stores only the base digest that cannot be inferred;
-its path and revised fragments are derived. Unchanged fragments inside a full
+its path and revised Sections are derived. Unchanged Sections inside a full
 revision are inferred. A page with no changes stores only one derived negative
 cache key below `.tmp/context-runtime/document-optimization/`; replacement
-prose and fragment metadata are not duplicated there.
+prose and Section metadata are not duplicated there.
+
+Typical repair candidates are Markdown syntax, spacing, empty table rows, and
+descriptive labels for links whose purpose is already present. Reshape handles
+wide tables, long cells, mixed images and links, or long prose by creating a
+clearer structure inside the same Section. Unanswered question sets, empty
+placeholders, decision-free drafts, duplicates, and obsolete-only Sections may
+be omitted. Questions with answers, limitations with an action, and
+deprecations with a replacement remain knowledge. Link targets, images, code,
+commands, numbers, identifiers, conditions, and source references are protected
+through validation. Ambiguous currency, ownership, or sensitive values appear
+together in the plan's `input_requests` and require one batched user decision.
 
 After capture, review, or build, a user may ask conversationally to correct one
 existing knowledge page. Start the correction by title, approved path, or
@@ -47,8 +70,9 @@ context revise "<title, approved path, or ViewRef>" --format json
 
 Context starts `route.document-revision.requested` only after resolving one
 page. Ambiguous requests return candidates instead of guessing. Edit
-reader-visible prose without changing provenance or `context:section`
-boundaries, then run `context optimize-docs validate`. A valid correction ends
+reader-visible prose within existing `context:section` boundaries without
+changing provenance or protected values, then run `context optimize-docs
+validate`. A valid correction ends
 the request and the next Route offers a package build when output is stale. If
 broad document optimization was disabled, this entry activates only the target
 page and keeps every other eligible page out of the pending batch. If upstream

package/docs/document-optimization.zh-CN.md

@@ -1,7 +1,7 @@
 # 文档修订页
 
-新工作区默认开启保守的文档编译优化。它是面向来源可追溯正文的构建阶段，只修复
-Markdown 排版、链接和明显的局部错误，不修改正式知识页，也不大段改写原意。
+新工作区默认开启来源约束的编辑修订。它是面向来源可追溯正文的构建阶段，在不修改
+正式知识页、不补写事实的前提下，提高发布内容的知识价值和可读性。
 
 初始化时如需关闭：
 
@@ -17,8 +17,9 @@ context optimize-docs disable
 context status --format json
 ```
 
-开启后，工作流只规划新增或发生变化的片段。Agent 可以保持片段不变，或提交
-保守的局部替换。只有实际改写的页面才在原文旁生成完整修订页：
+开启后，工作流只规划新增或发生变化的来源 Section。CLI 为每个 Section 枚举机械
+信号和允许动作；Agent 可以保持不变、局部修复、在同一来源边界内重排，或在 CLI
+确认其属于无知识价值内容时省略。只有实际变化的页面才在原文旁生成完整修订页：
 
 ```text
 knowledge/guides/setup.md
@@ -27,9 +28,28 @@ knowledge/guides/setup__revision.md
 
 `__revision.md` 是保留后缀。默认知识发现、结构、检索和包选择都排除修订页；
 校验和构建根据文件名把它关联回同目录原文，并仍按原文件名输出。修订页只额外
-记录无法推导的原文摘要；原文路径和修订片段由文件名与正文差异推导。完整修订
-页中未变化的片段直接推导为 `keep`；整页都不修改时，运行时只保存一个页级负
-缓存键，不重复保存改写正文或片段元数据。
+记录无法推导的原文摘要；原文路径和修订 Section 由文件名与正文差异推导。完整修订
+页中未变化的 Section 直接推导为 `keep`；整页都不修改时，运行时只保存一个页级负
+缓存键，不重复保存改写正文或 Section 元数据。
+
+局部修复适用于 Markdown、空白、空表格行，以及来源已经说明用途的链接名称。结构
+重排适用于宽表格、长单元格、图片与链接混排或过长段落，但不能跨 Section 搬运事实。
+未回答的问题集合、空占位、没有结论的草稿、重复内容和只有旧稿的 Section 可以省略；
+有答案的问句、有影响和动作的限制、带替代方案的废弃说明仍属于知识。链接目标、图片、
+代码、命令、数字、标识符、条件和来源引用由 CLI 机械保护。事实时效、职责或敏感值不
+明确时，CLI 会把相关 Section 集中列入计划的 `input_requests`，工作流只询问用户一次，
+不会自动省略。
+
+机械信号只是审阅线索，不代表最终结论，也不是完整的可读性检查。Agent 必须阅读每个
+Section；若对带信号的 Section 选择 `keep`，需要在本次决策中逐段说明信号为何误报，
+或修改为何会损害来源忠实度，并在说明中逐一写出对应的信号 code，供 CLI 机械核对覆盖
+是否完整。CLI 会拒绝没有具体说明或漏掉信号的 `keep`，但这段说明只用于当前决策审计，
+不会写入正式知识、修订页或构建产物。部分信号误报也不能成为整批保持不变的理由。
+
+时间、成本、工作量、批次规模或赶进度都不是 `keep`、跳过或延期的有效理由。全托管
+模式下，Agent 应自动完成所有安全的局部修复、结构重排和允许省略，直到当前批次收敛；
+只有确实无法从当前 Section 或来源证据取得的语义信息，才集中向用户询问一次。片段多
+不能降低质量标准，也不能把整批默认判为 `keep`。
 
 工作区采集、审核或构建完成后，用户可以直接通过对话要求修正某篇知识。Agent
 先使用标题、正式知识路径或 ViewRef 启动修订：
@@ -40,8 +60,8 @@ context revise "<标题、正式知识路径或 ViewRef>" --format json
 
 CLI 只在目标唯一时创建或复用该页修订，并由 Agent Graph 返回
 `route.document-revision.requested`。若有多个候选，Agent 必须依据当前对话选定，
-否则询问用户。Agent 只编辑面向读者的正文，不修改来源信息和
-`context:section` 边界，随后运行 `context optimize-docs validate`。校验成功后，
+否则询问用户。Agent 只在已有 `context:section` 内编辑面向读者的正文，不修改来源
+信息、Section 边界和受保护值，随后运行 `context optimize-docs validate`。校验成功后，
 请求自动结束；若产物因此过期，下一条 Route 会直接提示重新构建。即使工作区
 此前关闭了整库文档编译优化，这个入口也只激活目标页面，不会让其他页面进入
 待优化队列。上游内容变化后，旧修订页会成为冲突，不会被静默应用。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c4a/context-cli",
-  "version": "0.6.18",
+  "version": "0.6.19",
   "type": "module",
   "description": "Local runtime and Agent integration for traceable knowledge production",
   "license": "MIT",
@@ -24,7 +24,7 @@
   },
   "dependencies": {
     "@c4a/agent-graph": "0.2.6",
-    "@c4a/context": "0.6.18",
+    "@c4a/context": "0.6.19",
     "commander": "^11.0.0",
     "fast-xml-parser": "^5.10.1",
     "handlebars": "^4.7.8",

package/plugins/VERSION

@@ -1 +1 @@
-0.6.18
+0.6.19

package/plugins/claude/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "c4a",
   "description": "Start or continue a project-local knowledge workspace through one graph-routed entry.",
-  "version": "0.6.18",
+  "version": "0.6.19",
   "author": {
     "name": "c4a"
   },

package/plugins/claude/commands/context.md

@@ -26,6 +26,18 @@ Run:
 context entry [project-dir] --language <language> --format json
 ```
 
+If the request does not already choose ordinary review or fully managed
+operation, first use the read-only entry result to state a short execution
+plan, then ask the user to choose once. Explain that ordinary review pauses at
+human Gates and presents HTML reports, while fully managed operation resolves
+delegatable Gates within this conversation but still stops for permissions,
+hard validation, or non-delegatable decisions. Prefer the host's native choice
+UI. When initialization already needs a confirmation or missing option, combine
+the mode choice with that question instead of adding another round. Keep the
+answer only in this conversation and do not ask again after initialization,
+capture, or resume. An explicit request for review, human confirmation, fully
+managed work, or no further review already resolves this choice.
+
 Use the user's explicit language choice when present; otherwise pass `zh-CN`
 for a Chinese conversation and `en` for an English conversation. Pass
 `project-dir`, `--name`, `--dev`, or `--debug` only when the user explicitly
@@ -91,12 +103,14 @@ before workflow evaluation. Debugging records traces below
 source evidence.
 
 Document optimization is enabled by default for newly initialized workspaces.
-It conservatively repairs formatting, Markdown, links, and obvious local errors
-without broadly rewriting source-backed prose. It keeps approved pages
-source-faithful and stores only changed full-page revisions beside them as
-`knowledge/**/*__revision.md`. Default knowledge discovery excludes those
-reserved sidecars; validation and package compilation apply them to the
-matching base page.
+It performs source-constrained editorial revision: the CLI identifies
+readability and knowledge-value signals, and the Agent may keep, repair,
+reshape, or safely omit content only inside its existing source Section. It
+must preserve facts, link targets, images, code, numbers, identifiers, and
+source evidence. Approved pages remain source-faithful; only changed full-page
+revisions are stored beside them as `knowledge/**/*__revision.md`. Default
+knowledge discovery excludes those reserved sidecars, and internal editorial
+audit state is not included in package output.
 
 For an existing workspace, respect its current `package.json` setting. Run
 `context optimize-docs enable` or `context optimize-docs disable` only when the
@@ -123,6 +137,14 @@ The managed loop executes only Route-selected work and returns the current
 host execution, diagnostics, or a non-unique plan needs attention. Resume from
 that returned Route; never reconstruct a command from an earlier step.
 
+Code knowledge is published under `codeindex`. Context mechanically audits each
+module's input analysis, stable boundaries, facts, explanation, evidence scope,
+and page shape without producing a total score. In fully managed operation,
+follow returned repair actions automatically; after three failed revisions of
+the same module problem, stop at the one aggregated human-guidance Gate. If a
+legacy workspace returns `route.extract.codeindex-migration-required`, execute
+only its migration command; do not rename `codegraph` paths manually.
+
 ### Follow the current Route
 
 Treat `workflow.current` as the current-step authority:
@@ -168,6 +190,14 @@ Explain, ask, confirm, and summarize in the user's current conversation
 language. Keep commands, flags, paths, ids, status values, JSONL keys,
 `source_ref` values, and copied CLI tokens unchanged.
 
+Keep a conversation-local list of HTML review reports that the user actually
+used to make a review decision. Preserve each exact report URL or local path
+and its reviewed scope when the Route provides them. In the final completion
+summary, include one compact `Review reports` section containing those exact
+references. Do not scan workspace internals to reconstruct the list, persist a
+second ledger, invent a public URL, or describe an inaccessible report or a
+fully managed/force approval as user-reviewed.
+
 When the user explicitly asks to publish a completed build, treat publication
 as a downstream distribution step outside the Context Route. Use only an
 explicitly installed distribution tool and its documented complete-output

package/plugins/codex/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "c4a",
-  "version": "0.6.18",
+  "version": "0.6.19",
   "description": "Start or continue a project-local knowledge workspace through one graph-routed entry.",
   "author": {
     "name": "c4a"
@@ -18,7 +18,7 @@
   "skills": "./skills/",
   "interface": {
     "displayName": "C4A Context",
-    "shortDescription": "Initialize and advance a local, source-linked project knowledge workspace.\nv0.6.18",
+    "shortDescription": "Initialize and advance a local, source-linked project knowledge workspace.\nv0.6.19",
     "longDescription": "Create a Context workspace and use agent-guided next steps to register sources, run extraction, review candidates, build package outputs, and verify health without silently mutating source repositories.",
     "developerName": "c4a",
     "category": "Productivity",

package/plugins/codex/skills/context/SKILL.md

@@ -38,6 +38,18 @@ Run:
 context entry [project-dir] --language <language> --format json
 ```
 
+If the request does not already choose ordinary review or fully managed
+operation, first use the read-only entry result to state a short execution
+plan, then ask the user to choose once. Explain that ordinary review pauses at
+human Gates and presents HTML reports, while fully managed operation resolves
+delegatable Gates within this conversation but still stops for permissions,
+hard validation, or non-delegatable decisions. Prefer the host's native choice
+UI. When initialization already needs a confirmation or missing option, combine
+the mode choice with that question instead of adding another round. Keep the
+answer only in this conversation and do not ask again after initialization,
+capture, or resume. An explicit request for review, human confirmation, fully
+managed work, or no further review already resolves this choice.
+
 Use the user's explicit language choice when present; otherwise pass `zh-CN`
 for a Chinese conversation and `en` for an English conversation. Pass
 `project-dir`, `--name`, `--dev`, or `--debug` only when the user explicitly
@@ -103,12 +115,14 @@ before workflow evaluation. Debugging records traces below
 source evidence.
 
 Document optimization is enabled by default for newly initialized workspaces.
-It conservatively repairs formatting, Markdown, links, and obvious local errors
-without broadly rewriting source-backed prose. It keeps approved pages
-source-faithful and stores only changed full-page revisions beside them as
-`knowledge/**/*__revision.md`. Default knowledge discovery excludes those
-reserved sidecars; validation and package compilation apply them to the
-matching base page.
+It performs source-constrained editorial revision: the CLI identifies
+readability and knowledge-value signals, and the Agent may keep, repair,
+reshape, or safely omit content only inside its existing source Section. It
+must preserve facts, link targets, images, code, numbers, identifiers, and
+source evidence. Approved pages remain source-faithful; only changed full-page
+revisions are stored beside them as `knowledge/**/*__revision.md`. Default
+knowledge discovery excludes those reserved sidecars, and internal editorial
+audit state is not included in package output.
 
 For an existing workspace, respect its current `package.json` setting. Run
 `context optimize-docs enable` or `context optimize-docs disable` only when the
@@ -135,6 +149,14 @@ The managed loop executes only Route-selected work and returns the current
 host execution, diagnostics, or a non-unique plan needs attention. Resume from
 that returned Route; never reconstruct a command from an earlier step.
 
+Code knowledge is published under `codeindex`. Context mechanically audits each
+module's input analysis, stable boundaries, facts, explanation, evidence scope,
+and page shape without producing a total score. In fully managed operation,
+follow returned repair actions automatically; after three failed revisions of
+the same module problem, stop at the one aggregated human-guidance Gate. If a
+legacy workspace returns `route.extract.codeindex-migration-required`, execute
+only its migration command; do not rename `codegraph` paths manually.
+
 ### Follow the current Route
 
 Treat `workflow.current` as the current-step authority:
@@ -180,6 +202,14 @@ Explain, ask, confirm, and summarize in the user's current conversation
 language. Keep commands, flags, paths, ids, status values, JSONL keys,
 `source_ref` values, and copied CLI tokens unchanged.
 
+Keep a conversation-local list of HTML review reports that the user actually
+used to make a review decision. Preserve each exact report URL or local path
+and its reviewed scope when the Route provides them. In the final completion
+summary, include one compact `Review reports` section containing those exact
+references. Do not scan workspace internals to reconstruct the list, persist a
+second ledger, invent a public URL, or describe an inaccessible report or a
+fully managed/force approval as user-reviewed.
+
 When the user explicitly asks to publish a completed build, treat publication
 as a downstream distribution step outside the Context Route. Use only an
 explicitly installed distribution tool and its documented complete-output

package/plugins/cursor/.cursor-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "c4a",
   "displayName": "C4A Context",
-  "version": "0.6.18",
+  "version": "0.6.19",
   "description": "Start or continue a project-local knowledge workspace through one graph-routed entry.",
   "author": {
     "name": "Context4AI",

package/plugins/cursor/commands/c4a-context.md

@@ -30,6 +30,18 @@ Run:
 context entry [project-dir] --language <language> --format json
 ```
 
+If the request does not already choose ordinary review or fully managed
+operation, first use the read-only entry result to state a short execution
+plan, then ask the user to choose once. Explain that ordinary review pauses at
+human Gates and presents HTML reports, while fully managed operation resolves
+delegatable Gates within this conversation but still stops for permissions,
+hard validation, or non-delegatable decisions. Prefer the host's native choice
+UI. When initialization already needs a confirmation or missing option, combine
+the mode choice with that question instead of adding another round. Keep the
+answer only in this conversation and do not ask again after initialization,
+capture, or resume. An explicit request for review, human confirmation, fully
+managed work, or no further review already resolves this choice.
+
 Use the user's explicit language choice when present; otherwise pass `zh-CN`
 for a Chinese conversation and `en` for an English conversation. Pass
 `project-dir`, `--name`, `--dev`, or `--debug` only when the user explicitly
@@ -95,12 +107,14 @@ before workflow evaluation. Debugging records traces below
 source evidence.
 
 Document optimization is enabled by default for newly initialized workspaces.
-It conservatively repairs formatting, Markdown, links, and obvious local errors
-without broadly rewriting source-backed prose. It keeps approved pages
-source-faithful and stores only changed full-page revisions beside them as
-`knowledge/**/*__revision.md`. Default knowledge discovery excludes those
-reserved sidecars; validation and package compilation apply them to the
-matching base page.
+It performs source-constrained editorial revision: the CLI identifies
+readability and knowledge-value signals, and the Agent may keep, repair,
+reshape, or safely omit content only inside its existing source Section. It
+must preserve facts, link targets, images, code, numbers, identifiers, and
+source evidence. Approved pages remain source-faithful; only changed full-page
+revisions are stored beside them as `knowledge/**/*__revision.md`. Default
+knowledge discovery excludes those reserved sidecars, and internal editorial
+audit state is not included in package output.
 
 For an existing workspace, respect its current `package.json` setting. Run
 `context optimize-docs enable` or `context optimize-docs disable` only when the
@@ -127,6 +141,14 @@ The managed loop executes only Route-selected work and returns the current
 host execution, diagnostics, or a non-unique plan needs attention. Resume from
 that returned Route; never reconstruct a command from an earlier step.
 
+Code knowledge is published under `codeindex`. Context mechanically audits each
+module's input analysis, stable boundaries, facts, explanation, evidence scope,
+and page shape without producing a total score. In fully managed operation,
+follow returned repair actions automatically; after three failed revisions of
+the same module problem, stop at the one aggregated human-guidance Gate. If a
+legacy workspace returns `route.extract.codeindex-migration-required`, execute
+only its migration command; do not rename `codegraph` paths manually.
+
 ### Follow the current Route
 
 Treat `workflow.current` as the current-step authority:
@@ -172,6 +194,14 @@ Explain, ask, confirm, and summarize in the user's current conversation
 language. Keep commands, flags, paths, ids, status values, JSONL keys,
 `source_ref` values, and copied CLI tokens unchanged.
 
+Keep a conversation-local list of HTML review reports that the user actually
+used to make a review decision. Preserve each exact report URL or local path
+and its reviewed scope when the Route provides them. In the final completion
+summary, include one compact `Review reports` section containing those exact
+references. Do not scan workspace internals to reconstruct the list, persist a
+second ledger, invent a public URL, or describe an inaccessible report or a
+fully managed/force approval as user-reviewed.
+
 When the user explicitly asks to publish a completed build, treat publication
 as a downstream distribution step outside the Context Route. Use only an
 explicitly installed distribution tool and its documented complete-output

package/plugins/skills/c4a-context/SKILL.md

@@ -38,6 +38,18 @@ Run:
 context entry [project-dir] --language <language> --format json
 ```
 
+If the request does not already choose ordinary review or fully managed
+operation, first use the read-only entry result to state a short execution
+plan, then ask the user to choose once. Explain that ordinary review pauses at
+human Gates and presents HTML reports, while fully managed operation resolves
+delegatable Gates within this conversation but still stops for permissions,
+hard validation, or non-delegatable decisions. Prefer the host's native choice
+UI. When initialization already needs a confirmation or missing option, combine
+the mode choice with that question instead of adding another round. Keep the
+answer only in this conversation and do not ask again after initialization,
+capture, or resume. An explicit request for review, human confirmation, fully
+managed work, or no further review already resolves this choice.
+
 Use the user's explicit language choice when present; otherwise pass `zh-CN`
 for a Chinese conversation and `en` for an English conversation. Pass
 `project-dir`, `--name`, `--dev`, or `--debug` only when the user explicitly
@@ -103,12 +115,14 @@ before workflow evaluation. Debugging records traces below
 source evidence.
 
 Document optimization is enabled by default for newly initialized workspaces.
-It conservatively repairs formatting, Markdown, links, and obvious local errors
-without broadly rewriting source-backed prose. It keeps approved pages
-source-faithful and stores only changed full-page revisions beside them as
-`knowledge/**/*__revision.md`. Default knowledge discovery excludes those
-reserved sidecars; validation and package compilation apply them to the
-matching base page.
+It performs source-constrained editorial revision: the CLI identifies
+readability and knowledge-value signals, and the Agent may keep, repair,
+reshape, or safely omit content only inside its existing source Section. It
+must preserve facts, link targets, images, code, numbers, identifiers, and
+source evidence. Approved pages remain source-faithful; only changed full-page
+revisions are stored beside them as `knowledge/**/*__revision.md`. Default
+knowledge discovery excludes those reserved sidecars, and internal editorial
+audit state is not included in package output.
 
 For an existing workspace, respect its current `package.json` setting. Run
 `context optimize-docs enable` or `context optimize-docs disable` only when the
@@ -135,6 +149,14 @@ The managed loop executes only Route-selected work and returns the current
 host execution, diagnostics, or a non-unique plan needs attention. Resume from
 that returned Route; never reconstruct a command from an earlier step.
 
+Code knowledge is published under `codeindex`. Context mechanically audits each
+module's input analysis, stable boundaries, facts, explanation, evidence scope,
+and page shape without producing a total score. In fully managed operation,
+follow returned repair actions automatically; after three failed revisions of
+the same module problem, stop at the one aggregated human-guidance Gate. If a
+legacy workspace returns `route.extract.codeindex-migration-required`, execute
+only its migration command; do not rename `codegraph` paths manually.
+
 ### Follow the current Route
 
 Treat `workflow.current` as the current-step authority:
@@ -180,6 +202,14 @@ Explain, ask, confirm, and summarize in the user's current conversation
 language. Keep commands, flags, paths, ids, status values, JSONL keys,
 `source_ref` values, and copied CLI tokens unchanged.
 
+Keep a conversation-local list of HTML review reports that the user actually
+used to make a review decision. Preserve each exact report URL or local path
+and its reviewed scope when the Route provides them. In the final completion
+summary, include one compact `Review reports` section containing those exact
+references. Do not scan workspace internals to reconstruct the list, persist a
+second ledger, invent a public URL, or describe an inaccessible report or a
+fully managed/force approval as user-reviewed.
+
 When the user explicitly asks to publish a completed build, treat publication
 as a downstream distribution step outside the Context Route. Use only an
 explicitly installed distribution tool and its documented complete-output

package/providers/context/actions/apply-code-index-guidance.yaml

@@ -0,0 +1,5 @@
+schema: agent-graph.action.v1
+id: apply-code-index-guidance
+runner: host
+effect: write
+handler: context.project.apply-code-index-guidance

package/providers/context/actions/maintain-evidence.yaml

@@ -2,5 +2,5 @@ schema: agent-graph.action.v1
 id: maintain-evidence
 runner: command
 effect: write
-command: context review maintain --input - --format json
+command: context review maintain --input .tmp/agent-payloads/evidence-maintenance.json --format json
 inputSchema: schemas/evidence-maintenance-input.schema.json

package/providers/context/actions/migrate-codeindex.yaml

@@ -0,0 +1,5 @@
+schema: agent-graph.action.v1
+id: migrate-codeindex
+runner: host
+effect: write
+handler: context.code-index.migrate

package/providers/context/actions/register-source-batch.yaml

@@ -3,5 +3,5 @@ id: register-source-batch
 description: Register the source batch explicitly confirmed in the current conversation.
 runner: command
 effect: write
-command: context source add batch --input - --format json
+command: context source add batch --input .tmp/agent-payloads/source-batch.json --format json
 inputSchema: schemas/source-batch-input.schema.json

package/providers/context/actions/restore-repository-sources.yaml

@@ -3,5 +3,5 @@ id: restore-repository-sources
 description: Restore registered repository sources from user-confirmed local paths or explicit clones.
 runner: command
 effect: external
-command: context source restore --input - --format json
+command: context source restore --input .tmp/agent-payloads/repository-source-recovery.json --format json
 inputSchema: schemas/repository-source-recovery.schema.json

package/providers/context/codes.yaml

@@ -30,8 +30,10 @@ codes:
   - { 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 }

package/providers/context/graphs/workspace.yaml

@@ -384,6 +384,17 @@ nodes:
       recommended:
         - resources/manuals/reference/code-extractors.md
 
+  - id: migrate-codeindex
+    kind: action
+    reasonCode: route.extract.codeindex-migration-required
+    action: actions/migrate-codeindex.yaml
+    satisfiedBy:
+      - path: extract.migration_required
+        equals: false
+    resources:
+      required:
+        - resources/procedures/code-extraction.md
+
   - id: preview-extraction-batch
     kind: action
     reasonCode: route.extract.preview-required
@@ -458,6 +469,23 @@ nodes:
         - resources/dialogue/human-gates.md
         - resources/views/code-index-audit.yaml
 
+  - id: resolve-code-index-audit-guidance
+    kind: gate
+    reasonCode: route.extract.audit-guidance-required
+    resolutionAction: actions/apply-code-index-guidance.yaml
+    gate:
+      id: code-index-audit-guidance
+      prompt: Review the aggregated three-round code-index quality report and provide one scope, profile, source-material, or indexing direction for the failed modules.
+      delegatable: false
+    satisfiedBy:
+      - path: extract.audit_guidance_required
+        equals: false
+    resources:
+      required:
+        - resources/procedures/code-index-audit.md
+        - resources/dialogue/human-gates.md
+        - resources/views/code-index-audit.yaml
+
   - id: revise-code-index-audit
     kind: action
     reasonCode: route.extract.audit-revision-required
@@ -731,13 +759,15 @@ edges:
   - { from: authorize-document-capture, to: capture-next, kind: gatedBy }
   - { from: capture-next, to: choose-extraction-scope }
   - { from: choose-extraction-scope, to: configure-code-extraction, kind: gatedBy }
-  - { from: configure-code-extraction, to: resolve-extraction-capability }
+  - { from: configure-code-extraction, to: migrate-codeindex }
+  - { from: migrate-codeindex, to: resolve-extraction-capability }
   - { from: resolve-extraction-capability, to: preview-extraction-batch }
   - { from: preview-extraction-batch, to: repair-extraction-ownership }
   - { from: repair-extraction-ownership, to: revise-extraction-scale }
   - { from: revise-extraction-scale, to: extract-next }
   - { from: extract-next, to: resolve-code-index-audit-input }
-  - { from: resolve-code-index-audit-input, to: revise-code-index-audit, kind: gatedBy }
+  - { from: resolve-code-index-audit-input, to: resolve-code-index-audit-guidance, kind: gatedBy }
+  - { from: resolve-code-index-audit-guidance, to: revise-code-index-audit, kind: gatedBy }
   - { from: revise-code-index-audit, to: audit-code-index }
   - { from: audit-code-index, to: review-current-batch }
   - { from: review-current-batch, to: apply-managed-review, kind: gatedBy }