@c4a/context-cli 0.6.16 → 0.6.18

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (29) hide show
  1. package/README.md +2 -1
  2. package/README.zh-CN.md +2 -2
  3. package/cli.js +4859 -3834
  4. package/docs/document-optimization.md +10 -14
  5. package/docs/document-optimization.zh-CN.md +9 -13
  6. package/package.json +2 -2
  7. package/plugins/VERSION +1 -1
  8. package/plugins/claude/.claude-plugin/plugin.json +1 -1
  9. package/plugins/claude/commands/context.md +27 -13
  10. package/plugins/codex/.codex-plugin/plugin.json +2 -2
  11. package/plugins/codex/skills/context/SKILL.md +27 -13
  12. package/plugins/cursor/.cursor-plugin/plugin.json +1 -1
  13. package/plugins/cursor/commands/c4a-context.md +27 -13
  14. package/plugins/skills/c4a-context/SKILL.md +27 -13
  15. package/providers/context/actions/apply-forced-review.yaml +5 -0
  16. package/providers/context/actions/revise-code-index-audit.yaml +5 -0
  17. package/providers/context/actions/submit-code-index-audit.yaml +6 -0
  18. package/providers/context/codes.yaml +3 -0
  19. package/providers/context/graphs/workspace.yaml +51 -1
  20. package/providers/context/manifest.json +70 -16
  21. package/providers/context/provider.yaml +1 -1
  22. package/providers/context/resources/dialogue/knowledge-review.md +9 -0
  23. package/providers/context/resources/manuals/reference/project-api.md +9 -2
  24. package/providers/context/resources/procedures/close-and-build.md +8 -0
  25. package/providers/context/resources/procedures/code-extraction.md +14 -0
  26. package/providers/context/resources/procedures/code-index-audit.md +43 -0
  27. package/providers/context/resources/procedures/knowledge-review.md +6 -0
  28. package/providers/context/resources/views/code-index-audit.yaml +6 -0
  29. package/providers/context/schemas/code-index-audit-decision.schema.json +94 -0
@@ -1,19 +1,21 @@
1
1
  # Document revisions
2
2
 
3
- Document optimization is an optional build phase for source-backed prose. It
4
- repairs presentation-level Markdown without changing the approved knowledge
5
- page.
3
+ New workspaces enable conservative document optimization by default. It is a
4
+ build phase for source-backed prose that repairs presentation-level Markdown,
5
+ links, and obvious local errors without changing the approved knowledge page or
6
+ broadly rewriting its meaning.
6
7
 
7
- Enable it during initialization:
8
+ To opt out during initialization:
8
9
 
9
10
  ```bash
10
- context init context --optimize-docs
11
+ context init context --no-optimize-docs
11
12
  ```
12
13
 
13
- Or enable it in an existing workspace:
14
+ Existing workspaces retain their current setting. Change it explicitly with:
14
15
 
15
16
  ```bash
16
17
  context optimize-docs enable
18
+ context optimize-docs disable
17
19
  context status --format json
18
20
  ```
19
21
 
@@ -52,11 +54,5 @@ broad document optimization was disabled, this entry activates only the target
52
54
  page and keeps every other eligible page out of the pending batch. If upstream
53
55
  content changes, the revision becomes a conflict and must be reviewed again.
54
56
 
55
- Disable and restore baseline output with:
56
-
57
- ```bash
58
- context optimize-docs disable
59
- ```
60
-
61
- Revision pages move to Context runtime recovery storage, and the next build
62
- uses approved knowledge directly.
57
+ Disabling moves active revision pages to Context runtime recovery storage. The
58
+ next build uses approved knowledge directly.
@@ -1,18 +1,19 @@
1
1
  # 文档修订页
2
2
 
3
- 文档编译优化是面向来源可追溯正文的可选构建阶段。它只修复 Markdown
4
- 排版和明显的局部问题,不修改正式知识页。
3
+ 新工作区默认开启保守的文档编译优化。它是面向来源可追溯正文的构建阶段,只修复
4
+ Markdown 排版、链接和明显的局部错误,不修改正式知识页,也不大段改写原意。
5
5
 
6
- 初始化时开启:
6
+ 初始化时如需关闭:
7
7
 
8
8
  ```bash
9
- context init context --optimize-docs
9
+ context init context --no-optimize-docs
10
10
  ```
11
11
 
12
- 已有工作区可以运行:
12
+ 已有工作区保持当前设置,可显式调整:
13
13
 
14
14
  ```bash
15
15
  context optimize-docs enable
16
+ context optimize-docs disable
16
17
  context status --format json
17
18
  ```
18
19
 
@@ -42,13 +43,8 @@ CLI 只在目标唯一时创建或复用该页修订,并由 Agent Graph 返回
42
43
  否则询问用户。Agent 只编辑面向读者的正文,不修改来源信息和
43
44
  `context:section` 边界,随后运行 `context optimize-docs validate`。校验成功后,
44
45
  请求自动结束;若产物因此过期,下一条 Route 会直接提示重新构建。即使工作区
45
- 此前没有开启整库文档编译优化,这个入口也只激活目标页面,不会让其他页面进入
46
+ 此前关闭了整库文档编译优化,这个入口也只激活目标页面,不会让其他页面进入
46
47
  待优化队列。上游内容变化后,旧修订页会成为冲突,不会被静默应用。
47
48
 
48
- 关闭并恢复基础构建结果:
49
-
50
- ```bash
51
- context optimize-docs disable
52
- ```
53
-
54
- 修订页会被移动到 Context 的运行时恢复目录,下一次构建直接使用正式知识。
49
+ 关闭后,修订页会被移动到 Context 的运行时恢复目录,下一次构建直接使用正式
50
+ 知识。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@c4a/context-cli",
3
- "version": "0.6.16",
3
+ "version": "0.6.18",
4
4
  "type": "module",
5
5
  "description": "Local runtime and Agent integration for traceable knowledge production",
6
6
  "license": "MIT",
@@ -24,7 +24,7 @@
24
24
  },
25
25
  "dependencies": {
26
26
  "@c4a/agent-graph": "0.2.6",
27
- "@c4a/context": "0.6.16",
27
+ "@c4a/context": "0.6.18",
28
28
  "commander": "^11.0.0",
29
29
  "fast-xml-parser": "^5.10.1",
30
30
  "handlebars": "^4.7.8",
package/plugins/VERSION CHANGED
@@ -1 +1 @@
1
- 0.6.16
1
+ 0.6.18
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "c4a",
3
3
  "description": "Start or continue a project-local knowledge workspace through one graph-routed entry.",
4
- "version": "0.6.16",
4
+ "version": "0.6.18",
5
5
  "author": {
6
6
  "name": "c4a"
7
7
  },
@@ -28,12 +28,12 @@ context entry [project-dir] --language <language> --format json
28
28
 
29
29
  Use the user's explicit language choice when present; otherwise pass `zh-CN`
30
30
  for a Chinese conversation and `en` for an English conversation. Pass
31
- `project-dir`, `--name`, `--dev`, `--debug`, or `--optimize-docs` only when the
32
- user explicitly requested that initialization choice. Treat requests to enable
33
- document compilation optimization, document formatting optimization, or
34
- equivalent conservative build-time cleanup as `--optimize-docs`. Pass
35
- `--managed` only after the user
36
- explicitly authorizes fully managed operation in this conversation.
31
+ `project-dir`, `--name`, `--dev`, or `--debug` only when the user explicitly
32
+ requested that initialization choice. New workspaces enable conservative
33
+ document compilation optimization by default. Pass `--no-optimize-docs` only
34
+ when the user explicitly asks to disable it during initialization. Pass
35
+ `--managed` only after the user explicitly authorizes fully managed operation
36
+ in this conversation.
37
37
 
38
38
  If the `context` process itself cannot start because the command is missing
39
39
  (`ENOENT`, or shell exit 127 explicitly identifying `context` as the missing
@@ -90,13 +90,19 @@ before workflow evaluation. Debugging records traces below
90
90
  `.tmp/context-runtime/debug/` but does not grant workflow authority or provide
91
91
  source evidence.
92
92
 
93
- Enable document optimization only when the user explicitly requests it. If
94
- initialization is required, pass `--optimize-docs` through `context entry`; for
95
- an existing workspace, run `context optimize-docs enable` before workflow
96
- evaluation. The feature keeps approved pages source-faithful and stores only
97
- changed full-page revisions beside them as `knowledge/**/*__revision.md`.
98
- Default knowledge discovery excludes those reserved sidecars; validation and
99
- package compilation apply them to the matching base page.
93
+ Document optimization is enabled by default for newly initialized workspaces.
94
+ It conservatively repairs formatting, Markdown, links, and obvious local errors
95
+ without broadly rewriting source-backed prose. It keeps approved pages
96
+ source-faithful and stores only changed full-page revisions beside them as
97
+ `knowledge/**/*__revision.md`. Default knowledge discovery excludes those
98
+ reserved sidecars; validation and package compilation apply them to the
99
+ matching base page.
100
+
101
+ For an existing workspace, respect its current `package.json` setting. Run
102
+ `context optimize-docs enable` or `context optimize-docs disable` only when the
103
+ user explicitly changes that preference. If initialization is required and the
104
+ user opts out, pass `--no-optimize-docs` through `context entry`; otherwise let
105
+ the default initialization command enable it.
100
106
  Follow the resulting Route instead of editing approved knowledge or package
101
107
  output by hand.
102
108
 
@@ -133,6 +139,11 @@ Treat `workflow.current` as the current-step authority:
133
139
  `inspection_action` resource only while inspecting the decision, and read a
134
140
  `resolution_action` resource only after the user confirms the Gate. Neither
135
141
  replaces ordinary required resources.
142
+ For ordinary Knowledge Review, follow the Route-selected dialogue: do not
143
+ advertise force approval in the initial prompt. If the user cannot access
144
+ the report, only their exact current-conversation reply `强制批准` authorizes
145
+ the returned force-approval resolution command; generic approval wording
146
+ does not.
136
147
  3. Execute only `commands` returned by the Route, preserving revision and
137
148
  authority flags exactly. A command marked `after-human-confirmation` waits
138
149
  for the current Gate decision. Run a command whose `execution.target` is `agent-host`
@@ -140,6 +151,9 @@ Treat `workflow.current` as the current-step authority:
140
151
  not inside a restricted child sandbox. Follow the Route-selected procedure
141
152
  for its audit and approval contract; never invent a payload, destination, or
142
153
  substitute command.
154
+ A Context command is complete only after its process returns an exit code and
155
+ receipt. If the host reports that it is still running, keep polling that same
156
+ invocation; never start a second Context write command in parallel.
143
157
  Treat a code-extraction batch preview as one Route action. Read its complete
144
158
  index-unit report and keep same-kind capability or scale decisions in the
145
159
  single returned Gate; do not ask about modules one by one. A non-delegatable
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "c4a",
3
- "version": "0.6.16",
3
+ "version": "0.6.18",
4
4
  "description": "Start or continue a project-local knowledge workspace through one graph-routed entry.",
5
5
  "author": {
6
6
  "name": "c4a"
@@ -18,7 +18,7 @@
18
18
  "skills": "./skills/",
19
19
  "interface": {
20
20
  "displayName": "C4A Context",
21
- "shortDescription": "Initialize and advance a local, source-linked project knowledge workspace.\nv0.6.16",
21
+ "shortDescription": "Initialize and advance a local, source-linked project knowledge workspace.\nv0.6.18",
22
22
  "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.",
23
23
  "developerName": "c4a",
24
24
  "category": "Productivity",
@@ -40,12 +40,12 @@ context entry [project-dir] --language <language> --format json
40
40
 
41
41
  Use the user's explicit language choice when present; otherwise pass `zh-CN`
42
42
  for a Chinese conversation and `en` for an English conversation. Pass
43
- `project-dir`, `--name`, `--dev`, `--debug`, or `--optimize-docs` only when the
44
- user explicitly requested that initialization choice. Treat requests to enable
45
- document compilation optimization, document formatting optimization, or
46
- equivalent conservative build-time cleanup as `--optimize-docs`. Pass
47
- `--managed` only after the user
48
- explicitly authorizes fully managed operation in this conversation.
43
+ `project-dir`, `--name`, `--dev`, or `--debug` only when the user explicitly
44
+ requested that initialization choice. New workspaces enable conservative
45
+ document compilation optimization by default. Pass `--no-optimize-docs` only
46
+ when the user explicitly asks to disable it during initialization. Pass
47
+ `--managed` only after the user explicitly authorizes fully managed operation
48
+ in this conversation.
49
49
 
50
50
  If the `context` process itself cannot start because the command is missing
51
51
  (`ENOENT`, or shell exit 127 explicitly identifying `context` as the missing
@@ -102,13 +102,19 @@ before workflow evaluation. Debugging records traces below
102
102
  `.tmp/context-runtime/debug/` but does not grant workflow authority or provide
103
103
  source evidence.
104
104
 
105
- Enable document optimization only when the user explicitly requests it. If
106
- initialization is required, pass `--optimize-docs` through `context entry`; for
107
- an existing workspace, run `context optimize-docs enable` before workflow
108
- evaluation. The feature keeps approved pages source-faithful and stores only
109
- changed full-page revisions beside them as `knowledge/**/*__revision.md`.
110
- Default knowledge discovery excludes those reserved sidecars; validation and
111
- package compilation apply them to the matching base page.
105
+ Document optimization is enabled by default for newly initialized workspaces.
106
+ It conservatively repairs formatting, Markdown, links, and obvious local errors
107
+ without broadly rewriting source-backed prose. It keeps approved pages
108
+ source-faithful and stores only changed full-page revisions beside them as
109
+ `knowledge/**/*__revision.md`. Default knowledge discovery excludes those
110
+ reserved sidecars; validation and package compilation apply them to the
111
+ matching base page.
112
+
113
+ For an existing workspace, respect its current `package.json` setting. Run
114
+ `context optimize-docs enable` or `context optimize-docs disable` only when the
115
+ user explicitly changes that preference. If initialization is required and the
116
+ user opts out, pass `--no-optimize-docs` through `context entry`; otherwise let
117
+ the default initialization command enable it.
112
118
  Follow the resulting Route instead of editing approved knowledge or package
113
119
  output by hand.
114
120
 
@@ -145,6 +151,11 @@ Treat `workflow.current` as the current-step authority:
145
151
  `inspection_action` resource only while inspecting the decision, and read a
146
152
  `resolution_action` resource only after the user confirms the Gate. Neither
147
153
  replaces ordinary required resources.
154
+ For ordinary Knowledge Review, follow the Route-selected dialogue: do not
155
+ advertise force approval in the initial prompt. If the user cannot access
156
+ the report, only their exact current-conversation reply `强制批准` authorizes
157
+ the returned force-approval resolution command; generic approval wording
158
+ does not.
148
159
  3. Execute only `commands` returned by the Route, preserving revision and
149
160
  authority flags exactly. A command marked `after-human-confirmation` waits
150
161
  for the current Gate decision. Run a command whose `execution.target` is `agent-host`
@@ -152,6 +163,9 @@ Treat `workflow.current` as the current-step authority:
152
163
  not inside a restricted child sandbox. Follow the Route-selected procedure
153
164
  for its audit and approval contract; never invent a payload, destination, or
154
165
  substitute command.
166
+ A Context command is complete only after its process returns an exit code and
167
+ receipt. If the host reports that it is still running, keep polling that same
168
+ invocation; never start a second Context write command in parallel.
155
169
  Treat a code-extraction batch preview as one Route action. Read its complete
156
170
  index-unit report and keep same-kind capability or scale decisions in the
157
171
  single returned Gate; do not ask about modules one by one. A non-delegatable
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "c4a",
3
3
  "displayName": "C4A Context",
4
- "version": "0.6.16",
4
+ "version": "0.6.18",
5
5
  "description": "Start or continue a project-local knowledge workspace through one graph-routed entry.",
6
6
  "author": {
7
7
  "name": "Context4AI",
@@ -32,12 +32,12 @@ context entry [project-dir] --language <language> --format json
32
32
 
33
33
  Use the user's explicit language choice when present; otherwise pass `zh-CN`
34
34
  for a Chinese conversation and `en` for an English conversation. Pass
35
- `project-dir`, `--name`, `--dev`, `--debug`, or `--optimize-docs` only when the
36
- user explicitly requested that initialization choice. Treat requests to enable
37
- document compilation optimization, document formatting optimization, or
38
- equivalent conservative build-time cleanup as `--optimize-docs`. Pass
39
- `--managed` only after the user
40
- explicitly authorizes fully managed operation in this conversation.
35
+ `project-dir`, `--name`, `--dev`, or `--debug` only when the user explicitly
36
+ requested that initialization choice. New workspaces enable conservative
37
+ document compilation optimization by default. Pass `--no-optimize-docs` only
38
+ when the user explicitly asks to disable it during initialization. Pass
39
+ `--managed` only after the user explicitly authorizes fully managed operation
40
+ in this conversation.
41
41
 
42
42
  If the `context` process itself cannot start because the command is missing
43
43
  (`ENOENT`, or shell exit 127 explicitly identifying `context` as the missing
@@ -94,13 +94,19 @@ before workflow evaluation. Debugging records traces below
94
94
  `.tmp/context-runtime/debug/` but does not grant workflow authority or provide
95
95
  source evidence.
96
96
 
97
- Enable document optimization only when the user explicitly requests it. If
98
- initialization is required, pass `--optimize-docs` through `context entry`; for
99
- an existing workspace, run `context optimize-docs enable` before workflow
100
- evaluation. The feature keeps approved pages source-faithful and stores only
101
- changed full-page revisions beside them as `knowledge/**/*__revision.md`.
102
- Default knowledge discovery excludes those reserved sidecars; validation and
103
- package compilation apply them to the matching base page.
97
+ Document optimization is enabled by default for newly initialized workspaces.
98
+ It conservatively repairs formatting, Markdown, links, and obvious local errors
99
+ without broadly rewriting source-backed prose. It keeps approved pages
100
+ source-faithful and stores only changed full-page revisions beside them as
101
+ `knowledge/**/*__revision.md`. Default knowledge discovery excludes those
102
+ reserved sidecars; validation and package compilation apply them to the
103
+ matching base page.
104
+
105
+ For an existing workspace, respect its current `package.json` setting. Run
106
+ `context optimize-docs enable` or `context optimize-docs disable` only when the
107
+ user explicitly changes that preference. If initialization is required and the
108
+ user opts out, pass `--no-optimize-docs` through `context entry`; otherwise let
109
+ the default initialization command enable it.
104
110
  Follow the resulting Route instead of editing approved knowledge or package
105
111
  output by hand.
106
112
 
@@ -137,6 +143,11 @@ Treat `workflow.current` as the current-step authority:
137
143
  `inspection_action` resource only while inspecting the decision, and read a
138
144
  `resolution_action` resource only after the user confirms the Gate. Neither
139
145
  replaces ordinary required resources.
146
+ For ordinary Knowledge Review, follow the Route-selected dialogue: do not
147
+ advertise force approval in the initial prompt. If the user cannot access
148
+ the report, only their exact current-conversation reply `强制批准` authorizes
149
+ the returned force-approval resolution command; generic approval wording
150
+ does not.
140
151
  3. Execute only `commands` returned by the Route, preserving revision and
141
152
  authority flags exactly. A command marked `after-human-confirmation` waits
142
153
  for the current Gate decision. Run a command whose `execution.target` is `agent-host`
@@ -144,6 +155,9 @@ Treat `workflow.current` as the current-step authority:
144
155
  not inside a restricted child sandbox. Follow the Route-selected procedure
145
156
  for its audit and approval contract; never invent a payload, destination, or
146
157
  substitute command.
158
+ A Context command is complete only after its process returns an exit code and
159
+ receipt. If the host reports that it is still running, keep polling that same
160
+ invocation; never start a second Context write command in parallel.
147
161
  Treat a code-extraction batch preview as one Route action. Read its complete
148
162
  index-unit report and keep same-kind capability or scale decisions in the
149
163
  single returned Gate; do not ask about modules one by one. A non-delegatable
@@ -40,12 +40,12 @@ context entry [project-dir] --language <language> --format json
40
40
 
41
41
  Use the user's explicit language choice when present; otherwise pass `zh-CN`
42
42
  for a Chinese conversation and `en` for an English conversation. Pass
43
- `project-dir`, `--name`, `--dev`, `--debug`, or `--optimize-docs` only when the
44
- user explicitly requested that initialization choice. Treat requests to enable
45
- document compilation optimization, document formatting optimization, or
46
- equivalent conservative build-time cleanup as `--optimize-docs`. Pass
47
- `--managed` only after the user
48
- explicitly authorizes fully managed operation in this conversation.
43
+ `project-dir`, `--name`, `--dev`, or `--debug` only when the user explicitly
44
+ requested that initialization choice. New workspaces enable conservative
45
+ document compilation optimization by default. Pass `--no-optimize-docs` only
46
+ when the user explicitly asks to disable it during initialization. Pass
47
+ `--managed` only after the user explicitly authorizes fully managed operation
48
+ in this conversation.
49
49
 
50
50
  If the `context` process itself cannot start because the command is missing
51
51
  (`ENOENT`, or shell exit 127 explicitly identifying `context` as the missing
@@ -102,13 +102,19 @@ before workflow evaluation. Debugging records traces below
102
102
  `.tmp/context-runtime/debug/` but does not grant workflow authority or provide
103
103
  source evidence.
104
104
 
105
- Enable document optimization only when the user explicitly requests it. If
106
- initialization is required, pass `--optimize-docs` through `context entry`; for
107
- an existing workspace, run `context optimize-docs enable` before workflow
108
- evaluation. The feature keeps approved pages source-faithful and stores only
109
- changed full-page revisions beside them as `knowledge/**/*__revision.md`.
110
- Default knowledge discovery excludes those reserved sidecars; validation and
111
- package compilation apply them to the matching base page.
105
+ Document optimization is enabled by default for newly initialized workspaces.
106
+ It conservatively repairs formatting, Markdown, links, and obvious local errors
107
+ without broadly rewriting source-backed prose. It keeps approved pages
108
+ source-faithful and stores only changed full-page revisions beside them as
109
+ `knowledge/**/*__revision.md`. Default knowledge discovery excludes those
110
+ reserved sidecars; validation and package compilation apply them to the
111
+ matching base page.
112
+
113
+ For an existing workspace, respect its current `package.json` setting. Run
114
+ `context optimize-docs enable` or `context optimize-docs disable` only when the
115
+ user explicitly changes that preference. If initialization is required and the
116
+ user opts out, pass `--no-optimize-docs` through `context entry`; otherwise let
117
+ the default initialization command enable it.
112
118
  Follow the resulting Route instead of editing approved knowledge or package
113
119
  output by hand.
114
120
 
@@ -145,6 +151,11 @@ Treat `workflow.current` as the current-step authority:
145
151
  `inspection_action` resource only while inspecting the decision, and read a
146
152
  `resolution_action` resource only after the user confirms the Gate. Neither
147
153
  replaces ordinary required resources.
154
+ For ordinary Knowledge Review, follow the Route-selected dialogue: do not
155
+ advertise force approval in the initial prompt. If the user cannot access
156
+ the report, only their exact current-conversation reply `强制批准` authorizes
157
+ the returned force-approval resolution command; generic approval wording
158
+ does not.
148
159
  3. Execute only `commands` returned by the Route, preserving revision and
149
160
  authority flags exactly. A command marked `after-human-confirmation` waits
150
161
  for the current Gate decision. Run a command whose `execution.target` is `agent-host`
@@ -152,6 +163,9 @@ Treat `workflow.current` as the current-step authority:
152
163
  not inside a restricted child sandbox. Follow the Route-selected procedure
153
164
  for its audit and approval contract; never invent a payload, destination, or
154
165
  substitute command.
166
+ A Context command is complete only after its process returns an exit code and
167
+ receipt. If the host reports that it is still running, keep polling that same
168
+ invocation; never start a second Context write command in parallel.
155
169
  Treat a code-extraction batch preview as one Route action. Read its complete
156
170
  index-unit report and keep same-kind capability or scale decisions in the
157
171
  single returned Gate; do not ask about modules one by one. A non-delegatable
@@ -0,0 +1,5 @@
1
+ schema: agent-graph.action.v1
2
+ id: apply-forced-review
3
+ runner: host
4
+ effect: write
5
+ handler: context.review.force-approve-current
@@ -0,0 +1,5 @@
1
+ schema: agent-graph.action.v1
2
+ id: revise-code-index-audit
3
+ runner: host
4
+ effect: write
5
+ handler: context.project.revise-code-index
@@ -0,0 +1,6 @@
1
+ schema: agent-graph.action.v1
2
+ id: submit-code-index-audit
3
+ runner: host
4
+ effect: write
5
+ handler: context.code-index-audit.submit
6
+ inputSchema: schemas/code-index-audit-decision.schema.json
@@ -29,6 +29,9 @@ codes:
29
29
  - { 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 }
30
30
  - { 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 }
31
31
  - { 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 }
32
+ - { 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 }
33
+ - { 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 }
34
+ - { 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 }
32
35
  - { code: route.document.classification-required, kind: route-reason, summary: A captured document needs an evidence-backed collection decision., document: resources/procedures/document-classification.md }
33
36
  - { 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 }
34
37
  - { code: route.structure.pending-target, kind: route-reason, summary: Prepare the next document structure slot from source evidence., document: resources/procedures/prose-align.md }
@@ -172,6 +172,7 @@ nodes:
172
172
  kind: gate
173
173
  reasonCode: route.review.decision-required
174
174
  inspectionAction: actions/inspect-review.yaml
175
+ resolutionAction: actions/apply-forced-review.yaml
175
176
  delegated:
176
177
  inspection: skip
177
178
  resolutionAction: actions/apply-managed-review.yaml
@@ -440,6 +441,51 @@ nodes:
440
441
  - resources/procedures/code-extraction.md
441
442
  - resources/views/source-boundary.yaml
442
443
 
444
+ - id: resolve-code-index-audit-input
445
+ kind: gate
446
+ reasonCode: route.extract.audit-input-required
447
+ resolutionAction: actions/submit-code-index-audit.yaml
448
+ gate:
449
+ id: code-index-audit-input
450
+ prompt: Provide the specific missing source or protocol material required to complete the code-index audit.
451
+ delegatable: false
452
+ satisfiedBy:
453
+ - path: extract.audit_input_required
454
+ equals: false
455
+ resources:
456
+ required:
457
+ - resources/procedures/code-index-audit.md
458
+ - resources/dialogue/human-gates.md
459
+ - resources/views/code-index-audit.yaml
460
+
461
+ - id: revise-code-index-audit
462
+ kind: action
463
+ reasonCode: route.extract.audit-revision-required
464
+ action: actions/revise-code-index-audit.yaml
465
+ satisfiedBy:
466
+ - path: extract.audit_revision_required
467
+ equals: false
468
+ resources:
469
+ required:
470
+ - resources/procedures/code-index-audit.md
471
+ - resources/semantic/code-index/classification.md
472
+ - resources/views/code-index-audit.yaml
473
+ recommended:
474
+ - resources/manuals/reference/code-extractors.md
475
+
476
+ - id: audit-code-index
477
+ kind: action
478
+ reasonCode: route.extract.audit-required
479
+ action: actions/submit-code-index-audit.yaml
480
+ satisfiedBy:
481
+ - path: extract.audit_resolved
482
+ equals: true
483
+ resources:
484
+ required:
485
+ - resources/procedures/code-index-audit.md
486
+ - resources/semantic/code-index/classification.md
487
+ - resources/views/code-index-audit.yaml
488
+
443
489
  - id: classify-document
444
490
  kind: gate
445
491
  reasonCode: route.document.classification-required
@@ -501,6 +547,7 @@ nodes:
501
547
  kind: gate
502
548
  reasonCode: route.review.decision-required
503
549
  inspectionAction: actions/inspect-review.yaml
550
+ resolutionAction: actions/apply-forced-review.yaml
504
551
  delegated:
505
552
  inspection: skip
506
553
  resolutionAction: actions/apply-managed-review.yaml
@@ -689,7 +736,10 @@ edges:
689
736
  - { from: preview-extraction-batch, to: repair-extraction-ownership }
690
737
  - { from: repair-extraction-ownership, to: revise-extraction-scale }
691
738
  - { from: revise-extraction-scale, to: extract-next }
692
- - { from: extract-next, to: review-current-batch }
739
+ - { from: extract-next, to: resolve-code-index-audit-input }
740
+ - { from: resolve-code-index-audit-input, to: revise-code-index-audit, kind: gatedBy }
741
+ - { from: revise-code-index-audit, to: audit-code-index }
742
+ - { from: audit-code-index, to: review-current-batch }
693
743
  - { from: review-current-batch, to: apply-managed-review, kind: gatedBy }
694
744
  - { from: apply-managed-review, to: classify-document }
695
745
  - { from: classify-document, to: configure-prose-lifecycle, kind: gatedBy }