@c4a/context-cli 0.7.0 → 0.7.4

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 (219) hide show
  1. package/README.md +18 -39
  2. package/README.zh-CN.md +13 -27
  3. package/cli.js +59230 -80555
  4. package/indexers/bundles/context-code-indexer/SKILL.md +30 -3
  5. package/indexers/bundles/context-code-indexer/context-indexer.yaml +3 -8
  6. package/indexers/bundles/context-code-indexer/references/indexer.md +110 -7
  7. package/indexers/bundles/context-code-indexer/references/metrics.md +143 -37
  8. package/indexers/bundles/context-code-indexer/templates/adapter-integration.md +2 -2
  9. package/indexers/bundles/context-code-indexer/templates/component-library.md +8 -0
  10. package/indexers/bundles/context-code-indexer/templates/gateway-facade.md +16 -0
  11. package/indexers/bundles/context-markdown-indexer/SKILL.md +13 -3
  12. package/indexers/bundles/context-markdown-indexer/context-indexer.yaml +20 -7
  13. package/indexers/bundles/context-markdown-indexer/references/indexer.md +33 -4
  14. package/indexers/bundles/context-markdown-indexer/references/semantic-planning.md +30 -14
  15. package/indexers/bundles/context-markdown-indexer/references/structure-and-artifacts.md +6 -0
  16. package/indexers/bundles/context-markdown-indexer/tests/fixtures/anonymous.json +1 -1
  17. package/indexers/bundles/context-markdown-indexer/tests/fixtures/profiles.json +13 -13
  18. package/indexers/bundles/context-markdown-indexer/tests/fixtures/routing.json +122 -0
  19. package/indexers/contracts/operator-contract.json +2 -2
  20. package/indexers/contracts/profile-contract.json +3819 -454
  21. package/indexers/release-manifest.json +22 -22
  22. package/package.json +13 -3
  23. package/plugins/VERSION +1 -1
  24. package/plugins/claude/.claude-plugin/plugin.json +1 -1
  25. package/plugins/claude/commands/context.md +44 -85
  26. package/plugins/codex/.codex-plugin/plugin.json +2 -2
  27. package/plugins/codex/skills/context/SKILL.md +44 -85
  28. package/plugins/cursor/.cursor-plugin/plugin.json +1 -1
  29. package/plugins/cursor/commands/c4a-context.md +44 -85
  30. package/plugins/skills/context/SKILL.md +44 -85
  31. package/plugins/skills/context-code-indexer/SKILL.md +30 -3
  32. package/plugins/skills/context-code-indexer/context-indexer.yaml +3 -8
  33. package/plugins/skills/context-code-indexer/references/indexer.md +110 -7
  34. package/plugins/skills/context-code-indexer/references/metrics.md +143 -37
  35. package/plugins/skills/context-code-indexer/templates/adapter-integration.md +2 -2
  36. package/plugins/skills/context-code-indexer/templates/component-library.md +8 -0
  37. package/plugins/skills/context-code-indexer/templates/gateway-facade.md +16 -0
  38. package/plugins/skills/context-markdown-indexer/SKILL.md +13 -3
  39. package/plugins/skills/context-markdown-indexer/context-indexer.yaml +20 -7
  40. package/plugins/skills/context-markdown-indexer/references/indexer.md +33 -4
  41. package/plugins/skills/context-markdown-indexer/references/semantic-planning.md +30 -14
  42. package/plugins/skills/context-markdown-indexer/references/structure-and-artifacts.md +6 -0
  43. package/plugins/skills/context-markdown-indexer/tests/fixtures/anonymous.json +1 -1
  44. package/plugins/skills/context-markdown-indexer/tests/fixtures/profiles.json +13 -13
  45. package/plugins/skills/context-markdown-indexer/tests/fixtures/routing.json +122 -0
  46. package/providers/context/actions/advance-current-indexer-lifecycle.yaml +6 -0
  47. package/providers/context/actions/configure-indexer-providers.yaml +1 -1
  48. package/providers/context/actions/materialize-indexer-workset-view.yaml +7 -0
  49. package/providers/context/actions/run-indexer-lifecycle.yaml +7 -0
  50. package/providers/context/actions/run-indexer-post-author-composer.yaml +1 -1
  51. package/providers/context/codes.yaml +9 -49
  52. package/providers/context/graphs/indexer.yaml +75 -592
  53. package/providers/context/graphs/workspace.yaml +25 -500
  54. package/providers/context/manifest.json +110 -1199
  55. package/providers/context/provider.yaml +2 -2
  56. package/providers/context/resources/diagnostics/projection-stale.md +0 -1
  57. package/providers/context/resources/dialogue/human-gates.md +3 -3
  58. package/providers/context/resources/manuals/reference/package-templates.md +2 -3
  59. package/providers/context/resources/manuals/reference/project-api.md +52 -985
  60. package/providers/context/resources/procedures/close-and-build.md +8 -23
  61. package/providers/context/resources/procedures/knowledge-review.md +13 -4
  62. package/providers/context/resources/procedures/source-capture-detailed.md +6 -8
  63. package/providers/context/resources/views/authorized-indexer-workset-view.yaml +15 -0
  64. package/providers/context/resources/views/package-current.yaml +1 -1
  65. package/providers/context/resources/views/resolved-indexer-instructions.yaml +1 -1
  66. package/providers/context/resources/views/review-current.yaml +1 -1
  67. package/providers/context/resources/views/source-boundary.yaml +1 -1
  68. package/providers/context/resources/views/source-current.yaml +1 -1
  69. package/providers/context/resources/views/verification-current.yaml +1 -1
  70. package/providers/context/resources/views/workspace-current.yaml +1 -1
  71. package/providers/context/schemas/indexer-agent-step-input.schema.json +2 -2
  72. package/providers/context/schemas/indexer-agent-step-result.schema.json +298 -32
  73. package/providers/context/schemas/indexer-authorized-workset-view.schema.json +65 -0
  74. package/providers/context/schemas/indexer-contract-overlay-validation-input.schema.json +0 -42
  75. package/providers/context/schemas/indexer-contract-overlay-validation-result.schema.json +27 -122
  76. package/providers/context/schemas/indexer-lifecycle-continuation.schema.json +15 -0
  77. package/providers/context/schemas/indexer-main-lifecycle-input.schema.json +13 -20
  78. package/providers/context/schemas/indexer-main-lifecycle-output.schema.json +17 -2
  79. package/providers/context/schemas/indexer-materialized-resource.schema.json +8 -1
  80. package/providers/context/schemas/indexer-overlay-question-proposal-input.schema.json +55 -6
  81. package/providers/context/schemas/indexer-overlay-question-rebind-input.schema.json +4 -4
  82. package/providers/context/schemas/indexer-workset-view-materialization-request.schema.json +32 -0
  83. package/providers/context/skills/configure-indexer-providers/SKILL.md +40 -27
  84. package/providers/context/skills/run-indexer-agent-step/SKILL.md +34 -8
  85. package/providers/context/skills/run-indexer-lifecycle/SKILL.md +37 -0
  86. package/providers/context/skills/run-indexer-post-author-composer/SKILL.md +38 -9
  87. package/docs/document-optimization.md +0 -82
  88. package/docs/document-optimization.zh-CN.md +0 -70
  89. package/indexers/capability-manifest.json +0 -40
  90. package/indexers/contracts/hard-rule-conformance.json +0 -2644
  91. package/providers/context/actions/accept-main-index-run.yaml +0 -7
  92. package/providers/context/actions/accept-material-answer-run.yaml +0 -7
  93. package/providers/context/actions/accept-post-author-composer-run.yaml +0 -7
  94. package/providers/context/actions/actualize-material-answer-bindings.yaml +0 -8
  95. package/providers/context/actions/align-next.yaml +0 -6
  96. package/providers/context/actions/apply-code-index-guidance.yaml +0 -5
  97. package/providers/context/actions/apply-document-optimization-guidance.yaml +0 -5
  98. package/providers/context/actions/apply-structure-confirmation.yaml +0 -5
  99. package/providers/context/actions/audit-material-gap-state.yaml +0 -8
  100. package/providers/context/actions/audit-projected-artifact-fan-out.yaml +0 -8
  101. package/providers/context/actions/authorize-indexer-contract-overlay.yaml +0 -7
  102. package/providers/context/actions/build-main-index-author-worksets.yaml +0 -7
  103. package/providers/context/actions/build-main-index-catalog-fallback.yaml +0 -7
  104. package/providers/context/actions/build-main-index-partition-worksets.yaml +0 -7
  105. package/providers/context/actions/build-material-question-workset.yaml +0 -7
  106. package/providers/context/actions/build-post-author-composer-worksets.yaml +0 -7
  107. package/providers/context/actions/build-question-target-inventory.yaml +0 -7
  108. package/providers/context/actions/build-subject-catalog.yaml +0 -7
  109. package/providers/context/actions/build-target-resolution-views.yaml +0 -7
  110. package/providers/context/actions/checkpoint-material-answer-review.yaml +0 -8
  111. package/providers/context/actions/checkpoint-material-gaps.yaml +0 -8
  112. package/providers/context/actions/close-indexer-approved-knowledge.yaml +0 -8
  113. package/providers/context/actions/compile-next.yaml +0 -5
  114. package/providers/context/actions/compose-indexer-post-author-fragments.yaml +0 -7
  115. package/providers/context/actions/configure-code-extraction.yaml +0 -5
  116. package/providers/context/actions/configure-prose-lifecycle.yaml +0 -5
  117. package/providers/context/actions/converge-main-index-partition-run.yaml +0 -7
  118. package/providers/context/actions/evaluate-material-gaps.yaml +0 -8
  119. package/providers/context/actions/extract-next.yaml +0 -5
  120. package/providers/context/actions/fail-main-index-run.yaml +0 -7
  121. package/providers/context/actions/fail-material-answer-run.yaml +0 -7
  122. package/providers/context/actions/fail-post-author-composer-run.yaml +0 -7
  123. package/providers/context/actions/inspect-code-extraction.yaml +0 -5
  124. package/providers/context/actions/inspect-document-classification.yaml +0 -5
  125. package/providers/context/actions/inspect-index-candidate-review-readiness.yaml +0 -8
  126. package/providers/context/actions/inspect-index-profile-failure.yaml +0 -7
  127. package/providers/context/actions/inspect-material-answer-review.yaml +0 -8
  128. package/providers/context/actions/inspect-structure.yaml +0 -5
  129. package/providers/context/actions/migrate-codeindex.yaml +0 -5
  130. package/providers/context/actions/observe-main-index-run-ledger.yaml +0 -7
  131. package/providers/context/actions/observe-material-answer-runs.yaml +0 -7
  132. package/providers/context/actions/observe-post-author-composer-worksets.yaml +0 -7
  133. package/providers/context/actions/optimize-documents.yaml +0 -6
  134. package/providers/context/actions/override-index-profile-audit.yaml +0 -7
  135. package/providers/context/actions/prepare-main-index-run-ledger.yaml +0 -7
  136. package/providers/context/actions/prepare-material-answer-runs.yaml +0 -7
  137. package/providers/context/actions/preview-extraction-batch.yaml +0 -5
  138. package/providers/context/actions/reconcile-indexer-results.yaml +0 -7
  139. package/providers/context/actions/reconcile-review-identities.yaml +0 -5
  140. package/providers/context/actions/record-index-profile-revision.yaml +0 -7
  141. package/providers/context/actions/report-index-profile-failure.yaml +0 -7
  142. package/providers/context/actions/resolve-effective-composers.yaml +0 -7
  143. package/providers/context/actions/review-material-answer-candidate.yaml +0 -8
  144. package/providers/context/actions/revise-code-index-audit.yaml +0 -5
  145. package/providers/context/actions/revise-document.yaml +0 -5
  146. package/providers/context/actions/revise-index-output.yaml +0 -7
  147. package/providers/context/actions/run-material-answer-indexers.yaml +0 -7
  148. package/providers/context/actions/start-main-index-run.yaml +0 -7
  149. package/providers/context/actions/start-material-answer-run.yaml +0 -7
  150. package/providers/context/actions/start-post-author-composer-run.yaml +0 -7
  151. package/providers/context/actions/submit-code-index-audit.yaml +0 -6
  152. package/providers/context/resources/dialogue/code-extraction.md +0 -87
  153. package/providers/context/resources/dialogue/document-classification.md +0 -33
  154. package/providers/context/resources/dialogue/structure-confirmation.md +0 -44
  155. package/providers/context/resources/dialogue/workflow-mode-after-capture.md +0 -25
  156. package/providers/context/resources/manuals/reference/code-extractors.md +0 -152
  157. package/providers/context/resources/procedures/code-extraction.md +0 -188
  158. package/providers/context/resources/procedures/code-index-audit.md +0 -113
  159. package/providers/context/resources/procedures/document-classification.md +0 -22
  160. package/providers/context/resources/procedures/document-optimization.md +0 -110
  161. package/providers/context/resources/procedures/document-revision.md +0 -36
  162. package/providers/context/resources/procedures/prose-align.md +0 -68
  163. package/providers/context/resources/procedures/prose-compile.md +0 -23
  164. package/providers/context/resources/semantic/align/candidate-resolution.md +0 -106
  165. package/providers/context/resources/semantic/align/density-profile.md +0 -41
  166. package/providers/context/resources/semantic/align/gates.md +0 -276
  167. package/providers/context/resources/semantic/align/structure-planning.md +0 -337
  168. package/providers/context/resources/semantic/code-index/classification.md +0 -270
  169. package/providers/context/resources/semantic/code-index/templates/adapter.md +0 -118
  170. package/providers/context/resources/semantic/code-index/templates/api-service.md +0 -116
  171. package/providers/context/resources/semantic/code-index/templates/background-runtime.md +0 -109
  172. package/providers/context/resources/semantic/code-index/templates/cli-tool.md +0 -129
  173. package/providers/context/resources/semantic/code-index/templates/contract-source.md +0 -73
  174. package/providers/context/resources/semantic/code-index/templates/contracts-and-chains.md +0 -81
  175. package/providers/context/resources/semantic/code-index/templates/cross-module-chain.md +0 -78
  176. package/providers/context/resources/semantic/code-index/templates/derived-source.md +0 -116
  177. package/providers/context/resources/semantic/code-index/templates/domain-service.md +0 -109
  178. package/providers/context/resources/semantic/code-index/templates/event-flow.md +0 -62
  179. package/providers/context/resources/semantic/code-index/templates/monorepo-container.md +0 -124
  180. package/providers/context/resources/semantic/code-index/templates/persistence-boundary.md +0 -56
  181. package/providers/context/resources/semantic/code-index/templates/plugin-extension.md +0 -52
  182. package/providers/context/resources/semantic/code-index/templates/protocol-boundary.md +0 -88
  183. package/providers/context/resources/semantic/code-index/templates/sdk-library.md +0 -132
  184. package/providers/context/resources/semantic/code-index/templates/web-application.md +0 -145
  185. package/providers/context/resources/semantic/compile/index.md +0 -31
  186. package/providers/context/resources/views/code-index-audit.yaml +0 -6
  187. package/providers/context/resources/views/document-optimization-current.yaml +0 -6
  188. package/providers/context/resources/views/extraction-preview.yaml +0 -6
  189. package/providers/context/resources/views/structure-current.yaml +0 -6
  190. package/providers/context/schemas/code-index-audit-decision.schema.json +0 -94
  191. package/providers/context/schemas/document-optimization-decisions.schema.json +0 -57
  192. package/providers/context/schemas/indexer-candidate-review-readiness-input.schema.json +0 -46
  193. package/providers/context/schemas/indexer-candidate-review-readiness-output.schema.json +0 -104
  194. package/providers/context/schemas/indexer-contract-overlay-authorization-input.schema.json +0 -32
  195. package/providers/context/schemas/indexer-contract-overlay-authorization-result.schema.json +0 -121
  196. package/providers/context/schemas/indexer-material-answer-lifecycle-input.schema.json +0 -90
  197. package/providers/context/schemas/indexer-material-answer-lifecycle-output.schema.json +0 -80
  198. package/providers/context/schemas/indexer-material-answer-review-inspection-input.schema.json +0 -32
  199. package/providers/context/schemas/indexer-material-answer-review-inspection-output.schema.json +0 -32
  200. package/providers/context/schemas/indexer-material-answer-review-resolution-input.schema.json +0 -19
  201. package/providers/context/schemas/indexer-material-answer-review-resolution-output.schema.json +0 -87
  202. package/providers/context/schemas/indexer-material-gap-lifecycle-input.schema.json +0 -86
  203. package/providers/context/schemas/indexer-material-gap-lifecycle-output.schema.json +0 -19
  204. package/providers/context/schemas/indexer-post-author-fragment-result.schema.json +0 -18
  205. package/providers/context/schemas/indexer-post-author-lifecycle-input.schema.json +0 -94
  206. package/providers/context/schemas/indexer-post-author-lifecycle-output.schema.json +0 -72
  207. package/providers/context/schemas/indexer-profile-failure-inspection-input.schema.json +0 -13
  208. package/providers/context/schemas/indexer-profile-failure-inspection-result.schema.json +0 -19
  209. package/providers/context/schemas/indexer-profile-failure-report-input.schema.json +0 -22
  210. package/providers/context/schemas/indexer-profile-failure-report-result.schema.json +0 -49
  211. package/providers/context/schemas/indexer-profile-override-decision.schema.json +0 -20
  212. package/providers/context/schemas/indexer-profile-override-result.schema.json +0 -49
  213. package/providers/context/schemas/indexer-profile-revision-agent-input.schema.json +0 -18
  214. package/providers/context/schemas/indexer-profile-revision-record-input.schema.json +0 -31
  215. package/providers/context/schemas/indexer-profile-revision-record-result.schema.json +0 -45
  216. package/providers/context/schemas/indexer-result-reconciliation-input.schema.json +0 -59
  217. package/providers/context/schemas/indexer-result-reconciliation-output.schema.json +0 -43
  218. package/providers/context/schemas/prose-structure-batch.schema.json +0 -35
  219. package/providers/context/skills/revise-index-output/SKILL.md +0 -12
@@ -74,137 +74,19 @@ nodes:
74
74
  - resources/views/verification-current.yaml
75
75
  recommended: [resources/diagnostics/verification.md]
76
76
 
77
- - id: resume-prose-lifecycle
78
- kind: action
79
- reasonCode: route.prose.configuration-required
80
- action: actions/configure-prose-lifecycle.yaml
81
- satisfiedBy:
82
- - path: resume.prose_declarations_complete
83
- equals: true
84
- resources:
85
- required:
86
- - resources/procedures/project-configuration.md
87
- - resources/procedures/document-classification.md
88
- - resources/views/structure-current.yaml
89
- - resources/manuals/reference/project-api.md
90
-
91
- - id: confirm-structure
92
- kind: gate
93
- reasonCode: route.structure.confirmation-required
94
- inspectionAction: actions/inspect-structure.yaml
95
- resolutionAction: actions/apply-structure-confirmation.yaml
96
- delegated:
97
- inspection: skip
98
- resources:
99
- required: []
100
- recommended: []
101
- gate:
102
- id: structure-confirmation
103
- prompt: Confirm the proposed knowledge structure before candidates are compiled.
104
- authority: context.structure-confirmation
105
- delegatable: true
106
- satisfiedBy:
107
- - path: resume.structure_confirmation_resolved
108
- equals: true
109
- resources:
110
- required:
111
- - resources/procedures/prose-align.md
112
- - resources/dialogue/human-gates.md
113
- - resources/dialogue/structure-confirmation.md
114
- - resources/views/structure-current.yaml
115
-
116
- - id: resume-align-next
117
- kind: action
118
- reasonCode: route.structure.pending-target
119
- action: actions/align-next.yaml
120
- satisfiedBy:
121
- - path: resume.structure_refresh_required
122
- exists: false
123
- resources:
124
- required:
125
- - resources/procedures/prose-align.md
126
- - resources/views/structure-current.yaml
127
- recommended:
128
- - resources/semantic/align/structure-planning.md
129
- - resources/semantic/align/gates.md
130
- - resources/semantic/align/density-profile.md
131
- - resources/semantic/align/candidate-resolution.md
132
-
133
- - id: apply-structure-confirmation
134
- kind: action
135
- reasonCode: route.structure.confirm
136
- action: actions/apply-structure-confirmation.yaml
137
- satisfiedBy:
138
- - path: resume.structure_confirmed
139
- equals: true
140
- resources:
141
- required:
142
- - resources/procedures/prose-align.md
143
- - resources/views/structure-current.yaml
144
-
145
- - id: compile-next
77
+ - id: close-approved-knowledge
146
78
  kind: action
147
- reasonCode: route.compile.pending-target
148
- action: actions/compile-next.yaml
79
+ reasonCode: route.close.projection-stale
80
+ action: actions/close-approved-knowledge.yaml
149
81
  satisfiedBy:
150
- - path: resume.compile_complete
82
+ - path: close.current
151
83
  equals: true
152
84
  resources:
153
85
  required:
154
- - resources/procedures/prose-compile.md
86
+ - resources/procedures/close-and-build.md
87
+ - resources/views/verification-current.yaml
155
88
  recommended:
156
- - resources/views/structure-current.yaml
157
- - resources/semantic/compile/index.md
158
-
159
- - id: resolve-review-identities
160
- kind: action
161
- reasonCode: route.review.identity-conflict
162
- action: actions/reconcile-review-identities.yaml
163
- satisfiedBy:
164
- - path: review.identity_conflicts_present
165
- exists: false
166
- resources:
167
- required:
168
- - resources/procedures/knowledge-review.md
169
- - resources/views/review-current.yaml
170
-
171
- - id: resume-review-current-batch
172
- kind: gate
173
- reasonCode: route.review.decision-required
174
- inspectionAction: actions/inspect-review.yaml
175
- resolutionAction: actions/apply-forced-review.yaml
176
- delegated:
177
- inspection: skip
178
- resolutionAction: actions/apply-managed-review.yaml
179
- resources:
180
- required: []
181
- recommended: []
182
- gate:
183
- id: knowledge-review
184
- prompt: Review the complete current document candidate batch before it enters approved knowledge.
185
- authority: context.knowledge-review
186
- delegatable: true
187
- satisfiedBy:
188
- - path: resume.knowledge_review_resolved
189
- equals: true
190
- resources:
191
- required:
192
- - resources/procedures/knowledge-review.md
193
- - resources/dialogue/human-gates.md
194
- - resources/dialogue/knowledge-review.md
195
- - resources/views/review-current.yaml
196
-
197
- - id: apply-resumed-review
198
- kind: action
199
- reasonCode: route.review.apply-managed
200
- action: actions/apply-managed-review.yaml
201
- satisfiedBy:
202
- - path: resume.review_gate_clear
203
- equals: true
204
- resources:
205
- required:
206
- - resources/procedures/knowledge-review.md
207
- - resources/views/review-current.yaml
89
+ - resources/diagnostics/projection-stale.md
208
90
 
209
91
  - id: choose-source-boundary
210
92
  kind: gate
@@ -300,277 +182,13 @@ nodes:
300
182
  - resources/procedures/source-capture-detailed.md
301
183
  - resources/manuals/guides/lark-resources.md
302
184
 
303
- - id: choose-extraction-scope
304
- kind: gate
305
- reasonCode: route.extract.scope-required
306
- inspectionAction: actions/inspect-code-extraction.yaml
307
- delegated:
308
- resources:
309
- required:
310
- - resources/procedures/code-extraction.md
311
- - resources/dialogue/code-extraction.md
312
- - resources/semantic/code-index/classification.md
313
- - resources/views/source-current.yaml
314
- recommended:
315
- - resources/procedures/source-capture-detailed.md
316
- gate:
317
- id: extraction-scope
318
- prompt: Confirm which registered code modules and symbol boundaries should enter code knowledge.
319
- authority: context.extraction-scope
320
- delegatable: true
321
- satisfiedBy:
322
- - path: gates.extraction_scope_resolved
323
- equals: true
324
- resources:
325
- required:
326
- - resources/procedures/code-extraction.md
327
- - resources/dialogue/human-gates.md
328
- - resources/dialogue/code-extraction.md
329
- - resources/semantic/code-index/classification.md
330
- - resources/dialogue/workflow-mode-after-capture.md
331
- - resources/views/source-current.yaml
332
- recommended:
333
- - resources/procedures/source-capture-detailed.md
334
-
335
- - id: configure-code-extraction
336
- kind: action
337
- reasonCode: route.extract.configuration-required
338
- action: actions/configure-code-extraction.yaml
339
- satisfiedBy:
340
- - path: extract.declarations_complete
341
- equals: true
342
- - path: extract.plans_complete
343
- equals: true
344
- resources:
345
- required:
346
- - resources/procedures/project-configuration.md
347
- - resources/procedures/code-extraction.md
348
- - resources/semantic/code-index/classification.md
349
- - resources/views/source-current.yaml
350
- - resources/manuals/reference/code-extractors.md
351
- recommended:
352
- - resources/semantic/code-index/templates/web-application.md
353
- - resources/semantic/code-index/templates/api-service.md
354
- - resources/semantic/code-index/templates/domain-service.md
355
- - resources/semantic/code-index/templates/background-runtime.md
356
- - resources/semantic/code-index/templates/sdk-library.md
357
- - resources/semantic/code-index/templates/cli-tool.md
358
- - resources/semantic/code-index/templates/adapter.md
359
- - resources/semantic/code-index/templates/monorepo-container.md
360
- - resources/semantic/code-index/templates/contract-source.md
361
- - resources/semantic/code-index/templates/derived-source.md
362
- - resources/semantic/code-index/templates/protocol-boundary.md
363
- - resources/semantic/code-index/templates/event-flow.md
364
- - resources/semantic/code-index/templates/persistence-boundary.md
365
- - resources/semantic/code-index/templates/plugin-extension.md
366
- - resources/semantic/code-index/templates/cross-module-chain.md
367
-
368
- - id: resolve-extraction-capability
369
- kind: gate
370
- reasonCode: route.extract.capability-required
371
- resolutionAction: actions/configure-code-extraction.yaml
372
- gate:
373
- id: extraction-capability
374
- prompt: Revise the batch index plan or provide the missing material required for reliable code knowledge.
375
- authority: context.extraction-capability
376
- delegatable: false
377
- satisfiedBy:
378
- - path: extract.capability_clear
379
- equals: true
380
- resources:
381
- required:
382
- - resources/procedures/code-extraction.md
383
- - resources/views/source-current.yaml
384
- recommended:
385
- - resources/manuals/reference/code-extractors.md
386
- - resources/semantic/code-index/templates/contracts-and-chains.md
387
-
388
- - id: migrate-codeindex
389
- kind: action
390
- reasonCode: route.extract.codeindex-migration-required
391
- action: actions/migrate-codeindex.yaml
392
- satisfiedBy:
393
- - path: extract.migration_required
394
- equals: false
395
- resources:
396
- required:
397
- - resources/procedures/code-extraction.md
398
-
399
- - id: preview-extraction-batch
400
- kind: action
401
- reasonCode: route.extract.preview-required
402
- action: actions/preview-extraction-batch.yaml
403
- satisfiedBy:
404
- - path: extract.preview_current
405
- equals: true
406
- resources:
407
- required:
408
- - resources/procedures/code-extraction.md
409
- - resources/views/source-current.yaml
410
-
411
- - id: repair-extraction-ownership
185
+ - id: run-indexer-lifecycle
412
186
  kind: action
413
- reasonCode: route.extract.ownership-required
414
- action: actions/configure-code-extraction.yaml
187
+ reasonCode: route.indexer.lifecycle-required
188
+ action: actions/run-indexer-lifecycle.yaml
415
189
  satisfiedBy:
416
- - path: extract.ownership_clear
190
+ - path: indexer.lifecycle_current
417
191
  equals: true
418
- resources:
419
- required:
420
- - resources/procedures/project-configuration.md
421
- - resources/procedures/code-extraction.md
422
- - resources/views/extraction-preview.yaml
423
- - resources/manuals/reference/code-extractors.md
424
-
425
- - id: revise-extraction-scale
426
- kind: gate
427
- reasonCode: route.extract.scale-limit-exceeded
428
- resolutionAction: actions/configure-code-extraction.yaml
429
- gate:
430
- id: extraction-scale
431
- prompt: Revise the affected index units before formal extraction writes candidates.
432
- authority: context.extraction-scale
433
- delegatable: false
434
- satisfiedBy:
435
- - path: extract.scale_clear
436
- equals: true
437
- resources:
438
- required:
439
- - resources/procedures/code-extraction.md
440
- - resources/views/extraction-preview.yaml
441
- recommended:
442
- - resources/manuals/reference/code-extractors.md
443
-
444
- - id: extract-next
445
- kind: action
446
- reasonCode: route.extract.pending-target
447
- action: actions/extract-next.yaml
448
- satisfiedBy:
449
- - path: extract.complete
450
- equals: true
451
- resources:
452
- required:
453
- - resources/procedures/code-extraction.md
454
- - resources/views/source-boundary.yaml
455
-
456
- - id: resolve-code-index-audit-input
457
- kind: gate
458
- reasonCode: route.extract.audit-input-required
459
- resolutionAction: actions/submit-code-index-audit.yaml
460
- gate:
461
- id: code-index-audit-input
462
- prompt: Provide the specific missing source or protocol material required to complete the code-index audit.
463
- delegatable: false
464
- satisfiedBy:
465
- - path: extract.audit_input_required
466
- equals: false
467
- resources:
468
- required:
469
- - resources/procedures/code-index-audit.md
470
- - resources/dialogue/human-gates.md
471
- - resources/views/code-index-audit.yaml
472
-
473
- - id: resolve-code-index-audit-guidance
474
- kind: gate
475
- reasonCode: route.extract.audit-guidance-required
476
- resolutionAction: actions/apply-code-index-guidance.yaml
477
- gate:
478
- id: code-index-audit-guidance
479
- prompt: Review the aggregated three-round code-index quality report and provide one scope, profile, source-material, or indexing direction for the failed modules.
480
- delegatable: false
481
- satisfiedBy:
482
- - path: extract.audit_guidance_required
483
- equals: false
484
- resources:
485
- required:
486
- - resources/procedures/code-index-audit.md
487
- - resources/dialogue/human-gates.md
488
- - resources/views/code-index-audit.yaml
489
-
490
- - id: revise-code-index-audit
491
- kind: action
492
- reasonCode: route.extract.audit-revision-required
493
- action: actions/revise-code-index-audit.yaml
494
- satisfiedBy:
495
- - path: extract.audit_revision_required
496
- equals: false
497
- resources:
498
- required:
499
- - resources/procedures/code-index-audit.md
500
- - resources/semantic/code-index/classification.md
501
- - resources/views/code-index-audit.yaml
502
- recommended:
503
- - resources/manuals/reference/code-extractors.md
504
-
505
- - id: audit-code-index
506
- kind: action
507
- reasonCode: route.extract.audit-required
508
- action: actions/submit-code-index-audit.yaml
509
- satisfiedBy:
510
- - path: extract.audit_resolved
511
- equals: true
512
- resources:
513
- required:
514
- - resources/procedures/code-index-audit.md
515
- - resources/semantic/code-index/classification.md
516
- - resources/views/code-index-audit.yaml
517
-
518
- - id: classify-document
519
- kind: gate
520
- reasonCode: route.document.classification-required
521
- inspectionAction: actions/inspect-document-classification.yaml
522
- delegated:
523
- resources:
524
- required:
525
- - resources/procedures/document-classification.md
526
- - resources/dialogue/document-classification.md
527
- - resources/views/source-current.yaml
528
- gate:
529
- id: document-classification
530
- prompt: Confirm the evidence-backed knowledge collection for the next captured document.
531
- authority: context.document-classification
532
- delegatable: true
533
- satisfiedBy:
534
- - path: gates.document_classification_resolved
535
- equals: true
536
- resources:
537
- required:
538
- - resources/procedures/document-classification.md
539
- - resources/dialogue/human-gates.md
540
- - resources/dialogue/document-classification.md
541
- - resources/dialogue/workflow-mode-after-capture.md
542
- - resources/views/source-current.yaml
543
-
544
- - id: configure-prose-lifecycle
545
- kind: action
546
- reasonCode: route.prose.configuration-required
547
- action: actions/configure-prose-lifecycle.yaml
548
- satisfiedBy:
549
- - path: prose.declarations_complete
550
- equals: true
551
- resources:
552
- required:
553
- - resources/procedures/project-configuration.md
554
- - resources/procedures/document-classification.md
555
- - resources/views/structure-current.yaml
556
- - resources/manuals/reference/project-api.md
557
-
558
- - id: align-next
559
- kind: action
560
- reasonCode: route.structure.pending-target
561
- action: actions/align-next.yaml
562
- satisfiedBy:
563
- - path: align.prepared
564
- equals: true
565
- resources:
566
- required:
567
- - resources/procedures/prose-align.md
568
- - resources/views/structure-current.yaml
569
- recommended:
570
- - resources/semantic/align/structure-planning.md
571
- - resources/semantic/align/gates.md
572
- - resources/semantic/align/density-profile.md
573
- - resources/semantic/align/candidate-resolution.md
574
192
 
575
193
  - id: review-current-batch
576
194
  kind: gate
@@ -578,10 +196,10 @@ nodes:
578
196
  inspectionAction: actions/inspect-review.yaml
579
197
  resolutionAction: actions/apply-forced-review.yaml
580
198
  delegated:
581
- inspection: skip
582
199
  resolutionAction: actions/apply-managed-review.yaml
583
200
  resources:
584
- required: []
201
+ required:
202
+ - resources/views/review-current.yaml
585
203
  recommended: []
586
204
  gate:
587
205
  id: knowledge-review
@@ -598,32 +216,6 @@ nodes:
598
216
  - resources/dialogue/knowledge-review.md
599
217
  - resources/views/review-current.yaml
600
218
 
601
- - id: apply-managed-review
602
- kind: action
603
- reasonCode: route.review.apply-managed
604
- action: actions/apply-managed-review.yaml
605
- satisfiedBy:
606
- - path: review.gate_clear
607
- equals: true
608
- resources:
609
- required:
610
- - resources/procedures/knowledge-review.md
611
- - resources/views/review-current.yaml
612
-
613
- - id: close-approved-knowledge
614
- kind: action
615
- reasonCode: route.close.projection-stale
616
- action: actions/close-approved-knowledge.yaml
617
- satisfiedBy:
618
- - path: close.current
619
- equals: true
620
- resources:
621
- required:
622
- - resources/procedures/close-and-build.md
623
- - resources/views/verification-current.yaml
624
- recommended:
625
- - resources/diagnostics/projection-stale.md
626
-
627
219
  - id: choose-package-output
628
220
  kind: gate
629
221
  reasonCode: route.package.output-required
@@ -664,18 +256,6 @@ nodes:
664
256
  - resources/manuals/reference/package-templates.md
665
257
  - resources/manuals/reference/template-variables.md
666
258
 
667
- - id: build-next
668
- kind: action
669
- reasonCode: route.build.package-stale
670
- action: actions/build-next.yaml
671
- satisfiedBy:
672
- - path: packages.current
673
- equals: true
674
- resources:
675
- required:
676
- - resources/procedures/close-and-build.md
677
- - resources/views/package-current.yaml
678
-
679
259
  - id: review-package-template
680
260
  kind: gate
681
261
  reasonCode: route.package.template-review-required
@@ -699,46 +279,17 @@ nodes:
699
279
  - resources/views/package-current.yaml
700
280
  - resources/manuals/reference/package-templates.md
701
281
 
702
- - id: optimize-documents
282
+ - id: build-next
703
283
  kind: action
704
- reasonCode: route.document-optimization.pending
705
- action: actions/optimize-documents.yaml
284
+ reasonCode: route.build.package-stale
285
+ action: actions/build-next.yaml
706
286
  satisfiedBy:
707
- - path: document_optimization.current
287
+ - path: packages.current
708
288
  equals: true
709
289
  resources:
710
290
  required:
711
- - resources/procedures/document-optimization.md
712
- - resources/views/document-optimization-current.yaml
713
-
714
- - id: resolve-document-optimization-guidance
715
- kind: gate
716
- reasonCode: route.document-optimization.guidance-required
717
- resolutionAction: actions/apply-document-optimization-guidance.yaml
718
- gate:
719
- id: document-optimization-guidance
720
- prompt: Review the aggregated three-round document revision failures and provide one content-organization, source-fidelity, or missing-material direction for the affected Sections.
721
- delegatable: false
722
- satisfiedBy:
723
- - path: document_optimization.guidance_required
724
- equals: false
725
- resources:
726
- required:
727
- - resources/procedures/document-optimization.md
728
- - resources/dialogue/human-gates.md
729
- - resources/views/document-optimization-current.yaml
730
-
731
- - id: revise-document
732
- kind: action
733
- reasonCode: route.document-revision.requested
734
- action: actions/revise-document.yaml
735
- satisfiedBy:
736
- - path: document_optimization.revision_requested
737
- exists: false
738
- resources:
739
- required:
740
- - resources/procedures/document-revision.md
741
- - resources/views/document-optimization-current.yaml
291
+ - resources/procedures/close-and-build.md
292
+ - resources/views/package-current.yaml
742
293
 
743
294
  - id: flush-logs-after-build
744
295
  kind: action
@@ -760,43 +311,17 @@ edges:
760
311
  - { from: repair-workspace-state, to: repair-verification }
761
312
  - { from: repair-verification, to: choose-evidence-maintenance }
762
313
  - { from: choose-evidence-maintenance, to: maintain-evidence, kind: gatedBy }
763
- - { from: maintain-evidence, to: close-approved-knowledge }
764
- - { from: close-approved-knowledge, to: resume-prose-lifecycle }
765
- - { from: resume-prose-lifecycle, to: resume-align-next }
766
- - { from: resume-align-next, to: confirm-structure }
767
- - { from: confirm-structure, to: apply-structure-confirmation, kind: gatedBy }
768
- - { from: apply-structure-confirmation, to: compile-next }
769
- - { from: compile-next, to: resolve-review-identities }
770
- - { from: resolve-review-identities, to: resume-review-current-batch }
771
- - { from: resume-review-current-batch, to: apply-resumed-review, kind: gatedBy }
772
- - { from: apply-resumed-review, to: revise-document }
773
- - { from: revise-document, to: choose-source-boundary }
314
+ - { from: maintain-evidence, to: choose-source-boundary }
774
315
  - { from: choose-source-boundary, to: ensure-repository-sources, kind: gatedBy }
775
316
  - { from: ensure-repository-sources, to: configure-document-capture }
776
317
  - { from: configure-document-capture, to: authorize-document-capture }
777
318
  - { from: authorize-document-capture, to: capture-next, kind: gatedBy }
778
- - { from: capture-next, to: choose-extraction-scope }
779
- - { from: choose-extraction-scope, to: configure-code-extraction, kind: gatedBy }
780
- - { from: configure-code-extraction, to: migrate-codeindex }
781
- - { from: migrate-codeindex, to: resolve-extraction-capability }
782
- - { from: resolve-extraction-capability, to: preview-extraction-batch }
783
- - { from: preview-extraction-batch, to: repair-extraction-ownership }
784
- - { from: repair-extraction-ownership, to: revise-extraction-scale }
785
- - { from: revise-extraction-scale, to: extract-next }
786
- - { from: extract-next, to: resolve-code-index-audit-input }
787
- - { from: resolve-code-index-audit-input, to: resolve-code-index-audit-guidance, kind: gatedBy }
788
- - { from: resolve-code-index-audit-guidance, to: revise-code-index-audit, kind: gatedBy }
789
- - { from: revise-code-index-audit, to: audit-code-index }
790
- - { from: audit-code-index, to: review-current-batch }
791
- - { from: review-current-batch, to: apply-managed-review, kind: gatedBy }
792
- - { from: apply-managed-review, to: classify-document }
793
- - { from: classify-document, to: configure-prose-lifecycle, kind: gatedBy }
794
- - { from: configure-prose-lifecycle, to: align-next }
795
- - { from: align-next, to: choose-package-output }
319
+ - { from: capture-next, to: run-indexer-lifecycle }
320
+ - { from: run-indexer-lifecycle, to: review-current-batch }
321
+ - { from: review-current-batch, to: close-approved-knowledge, kind: gatedBy }
322
+ - { from: close-approved-knowledge, to: choose-package-output }
796
323
  - { from: choose-package-output, to: configure-package-output, kind: gatedBy }
797
324
  - { from: configure-package-output, to: review-package-template }
798
- - { from: review-package-template, to: resolve-document-optimization-guidance, kind: gatedBy }
799
- - { from: resolve-document-optimization-guidance, to: optimize-documents, kind: gatedBy }
800
- - { from: optimize-documents, to: build-next }
325
+ - { from: review-package-template, to: build-next, kind: gatedBy }
801
326
  - { from: build-next, to: flush-logs-after-build }
802
327
  - { from: flush-logs-after-build, to: current-scope-complete }