@c4a/context-cli 0.6.19 → 0.7.1

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 (311) hide show
  1. package/README.md +67 -6
  2. package/README.zh-CN.md +42 -5
  3. package/cli.js +77935 -44879
  4. package/indexers/bundles/context-code-indexer/SKILL.md +20 -0
  5. package/indexers/bundles/context-code-indexer/context-indexer.yaml +230 -0
  6. package/indexers/bundles/context-code-indexer/references/composers/contracts-and-chains.md +23 -0
  7. package/indexers/bundles/context-code-indexer/references/composers/cross-module-chain.md +22 -0
  8. package/indexers/bundles/context-code-indexer/references/composers/development-and-delivery.md +22 -0
  9. package/indexers/bundles/context-code-indexer/references/composers/event-flow.md +21 -0
  10. package/indexers/bundles/context-code-indexer/references/composers/examples-and-documentation.md +22 -0
  11. package/indexers/bundles/context-code-indexer/references/composers/persistence-boundary.md +21 -0
  12. package/indexers/bundles/context-code-indexer/references/composers/protocol-boundary.md +22 -0
  13. package/indexers/bundles/context-code-indexer/references/composers/public-contract.md +23 -0
  14. package/indexers/bundles/context-code-indexer/references/indexer.md +49 -0
  15. package/indexers/bundles/context-code-indexer/references/metrics.md +201 -0
  16. package/{providers/context/resources/semantic/code-index/templates/adapter.md → indexers/bundles/context-code-indexer/templates/adapter-integration.md} +16 -6
  17. package/{providers/context/resources/semantic/code-index → indexers/bundles/context-code-indexer}/templates/api-service.md +9 -7
  18. package/{providers/context/resources/semantic/code-index → indexers/bundles/context-code-indexer}/templates/background-runtime.md +3 -3
  19. package/{providers/context/resources/semantic/code-index → indexers/bundles/context-code-indexer}/templates/cli-tool.md +6 -6
  20. package/indexers/bundles/context-code-indexer/templates/component-library.md +99 -0
  21. package/{providers/context/resources/semantic/code-index → indexers/bundles/context-code-indexer}/templates/contract-source.md +4 -4
  22. package/{providers/context/resources/semantic/code-index/templates/cross-module-chain.md → indexers/bundles/context-code-indexer/templates/data-sync-reconciliation.md} +11 -12
  23. package/{providers/context/resources/semantic/code-index/templates/derived-source.md → indexers/bundles/context-code-indexer/templates/derived-generated-source.md} +11 -10
  24. package/{providers/context/resources/semantic/code-index → indexers/bundles/context-code-indexer}/templates/domain-service.md +4 -4
  25. package/{providers/context/resources/semantic/code-index/templates/event-flow.md → indexers/bundles/context-code-indexer/templates/event-consumer.md} +5 -5
  26. package/{providers/context/resources/semantic/code-index/templates/protocol-boundary.md → indexers/bundles/context-code-indexer/templates/gateway-facade.md} +14 -13
  27. package/{providers/context/resources/semantic/code-index → indexers/bundles/context-code-indexer}/templates/monorepo-container.md +11 -11
  28. package/{providers/context/resources/semantic/code-index → indexers/bundles/context-code-indexer}/templates/plugin-extension.md +1 -1
  29. package/{providers/context/resources/semantic/code-index → indexers/bundles/context-code-indexer}/templates/sdk-library.md +9 -9
  30. package/{providers/context/resources/semantic/code-index/templates/persistence-boundary.md → indexers/bundles/context-code-indexer/templates/storage-repository.md} +3 -3
  31. package/{providers/context/resources/semantic/code-index → indexers/bundles/context-code-indexer}/templates/web-application.md +5 -4
  32. package/indexers/bundles/context-code-indexer/tests/fixtures/chapters.json +226 -0
  33. package/indexers/bundles/context-code-indexer/tests/fixtures/composers.json +82 -0
  34. package/indexers/bundles/context-code-indexer/tests/fixtures/profiles.json +210 -0
  35. package/indexers/bundles/context-code-indexer/tests/fixtures/scenarios.json +122 -0
  36. package/indexers/bundles/context-markdown-indexer/SKILL.md +20 -0
  37. package/indexers/bundles/context-markdown-indexer/context-indexer.yaml +147 -0
  38. package/indexers/bundles/context-markdown-indexer/references/classification.md +63 -0
  39. package/indexers/bundles/context-markdown-indexer/references/editorial-policy.md +106 -0
  40. package/indexers/bundles/context-markdown-indexer/references/indexer.md +23 -0
  41. package/indexers/bundles/context-markdown-indexer/references/semantic-planning.md +146 -0
  42. package/indexers/bundles/context-markdown-indexer/references/structure-and-artifacts.md +109 -0
  43. package/indexers/bundles/context-markdown-indexer/tests/fixtures/anonymous.json +31 -0
  44. package/indexers/bundles/context-markdown-indexer/tests/fixtures/editorial.json +309 -0
  45. package/indexers/bundles/context-markdown-indexer/tests/fixtures/migration-equivalence.json +186 -0
  46. package/indexers/bundles/context-markdown-indexer/tests/fixtures/profiles.json +171 -0
  47. package/indexers/bundles/context-markdown-indexer/tests/fixtures/routing.json +151 -0
  48. package/indexers/capability-manifest.json +35 -0
  49. package/indexers/contracts/hard-rule-conformance.json +2644 -0
  50. package/indexers/contracts/operator-contract.json +35 -0
  51. package/indexers/contracts/profile-contract.json +10162 -0
  52. package/indexers/release-manifest.json +208 -0
  53. package/package.json +5 -4
  54. package/plugins/README.md +17 -109
  55. package/plugins/README_CN.md +11 -89
  56. package/plugins/VERSION +1 -1
  57. package/plugins/claude/.claude-plugin/plugin.json +3 -11
  58. package/plugins/claude/CLAUDE.md +1 -1
  59. package/plugins/claude/README.md +1 -1
  60. package/plugins/claude/commands/context.md +76 -1
  61. package/plugins/codex/.codex-plugin/plugin.json +6 -17
  62. package/plugins/codex/AGENTS.md +1 -1
  63. package/plugins/codex/README.md +1 -1
  64. package/plugins/codex/skills/context/SKILL.md +77 -13
  65. package/plugins/cursor/.cursor-plugin/plugin.json +4 -17
  66. package/plugins/cursor/AGENTS.md +1 -1
  67. package/plugins/cursor/README.md +3 -2
  68. package/plugins/cursor/commands/c4a-context.md +76 -3
  69. package/plugins/skills/{c4a-context → context}/SKILL.md +78 -14
  70. package/plugins/skills/context-code-indexer/SKILL.md +20 -0
  71. package/plugins/skills/context-code-indexer/context-indexer.yaml +230 -0
  72. package/plugins/skills/context-code-indexer/references/composers/contracts-and-chains.md +23 -0
  73. package/plugins/skills/context-code-indexer/references/composers/cross-module-chain.md +22 -0
  74. package/plugins/skills/context-code-indexer/references/composers/development-and-delivery.md +22 -0
  75. package/plugins/skills/context-code-indexer/references/composers/event-flow.md +21 -0
  76. package/plugins/skills/context-code-indexer/references/composers/examples-and-documentation.md +22 -0
  77. package/plugins/skills/context-code-indexer/references/composers/persistence-boundary.md +21 -0
  78. package/plugins/skills/context-code-indexer/references/composers/protocol-boundary.md +22 -0
  79. package/plugins/skills/context-code-indexer/references/composers/public-contract.md +23 -0
  80. package/plugins/skills/context-code-indexer/references/indexer.md +49 -0
  81. package/plugins/skills/context-code-indexer/references/metrics.md +201 -0
  82. package/plugins/skills/context-code-indexer/templates/adapter-integration.md +119 -0
  83. package/plugins/skills/context-code-indexer/templates/api-service.md +118 -0
  84. package/plugins/skills/context-code-indexer/templates/background-runtime.md +109 -0
  85. package/plugins/skills/context-code-indexer/templates/cli-tool.md +129 -0
  86. package/plugins/skills/context-code-indexer/templates/component-library.md +99 -0
  87. package/plugins/skills/context-code-indexer/templates/contract-source.md +73 -0
  88. package/plugins/skills/context-code-indexer/templates/data-sync-reconciliation.md +77 -0
  89. package/plugins/skills/context-code-indexer/templates/derived-generated-source.md +117 -0
  90. package/plugins/skills/context-code-indexer/templates/domain-service.md +109 -0
  91. package/plugins/skills/context-code-indexer/templates/event-consumer.md +62 -0
  92. package/plugins/skills/context-code-indexer/templates/gateway-facade.md +89 -0
  93. package/plugins/skills/context-code-indexer/templates/monorepo-container.md +124 -0
  94. package/plugins/skills/context-code-indexer/templates/plugin-extension.md +52 -0
  95. package/plugins/skills/context-code-indexer/templates/sdk-library.md +132 -0
  96. package/plugins/skills/context-code-indexer/templates/storage-repository.md +56 -0
  97. package/plugins/skills/context-code-indexer/templates/web-application.md +146 -0
  98. package/plugins/skills/context-code-indexer/tests/fixtures/chapters.json +226 -0
  99. package/plugins/skills/context-code-indexer/tests/fixtures/composers.json +82 -0
  100. package/plugins/skills/context-code-indexer/tests/fixtures/profiles.json +210 -0
  101. package/plugins/skills/context-code-indexer/tests/fixtures/scenarios.json +122 -0
  102. package/plugins/skills/context-markdown-indexer/SKILL.md +20 -0
  103. package/plugins/skills/context-markdown-indexer/context-indexer.yaml +147 -0
  104. package/plugins/skills/context-markdown-indexer/references/classification.md +63 -0
  105. package/plugins/skills/context-markdown-indexer/references/editorial-policy.md +106 -0
  106. package/plugins/skills/context-markdown-indexer/references/indexer.md +23 -0
  107. package/plugins/skills/context-markdown-indexer/references/semantic-planning.md +146 -0
  108. package/plugins/skills/context-markdown-indexer/references/structure-and-artifacts.md +109 -0
  109. package/plugins/skills/context-markdown-indexer/tests/fixtures/anonymous.json +31 -0
  110. package/plugins/skills/context-markdown-indexer/tests/fixtures/editorial.json +309 -0
  111. package/plugins/skills/context-markdown-indexer/tests/fixtures/migration-equivalence.json +186 -0
  112. package/plugins/skills/context-markdown-indexer/tests/fixtures/profiles.json +171 -0
  113. package/plugins/skills/context-markdown-indexer/tests/fixtures/routing.json +151 -0
  114. package/providers/context/actions/accept-main-index-run.yaml +7 -0
  115. package/providers/context/actions/accept-material-answer-run.yaml +7 -0
  116. package/providers/context/actions/accept-post-author-composer-run.yaml +7 -0
  117. package/providers/context/actions/actualize-material-answer-bindings.yaml +8 -0
  118. package/providers/context/actions/apply-indexer-project.yaml +7 -0
  119. package/providers/context/actions/audit-material-gap-state.yaml +8 -0
  120. package/providers/context/actions/audit-projected-artifact-fan-out.yaml +8 -0
  121. package/providers/context/actions/authorize-indexer-dependencies.yaml +7 -0
  122. package/providers/context/actions/authorize-indexer-program-execution.yaml +7 -0
  123. package/providers/context/actions/build-main-index-author-worksets.yaml +7 -0
  124. package/providers/context/actions/build-main-index-catalog-fallback.yaml +7 -0
  125. package/providers/context/actions/build-main-index-partition-worksets.yaml +7 -0
  126. package/providers/context/actions/build-material-question-workset.yaml +7 -0
  127. package/providers/context/actions/build-post-author-composer-worksets.yaml +7 -0
  128. package/providers/context/actions/build-question-target-inventory.yaml +7 -0
  129. package/providers/context/actions/build-subject-catalog.yaml +7 -0
  130. package/providers/context/actions/build-target-resolution-views.yaml +7 -0
  131. package/providers/context/actions/checkpoint-material-answer-review.yaml +8 -0
  132. package/providers/context/actions/checkpoint-material-gaps.yaml +8 -0
  133. package/providers/context/actions/close-indexer-approved-knowledge.yaml +8 -0
  134. package/providers/context/actions/compile-indexer-candidates.yaml +8 -0
  135. package/providers/context/actions/compose-indexer-post-author-fragments.yaml +7 -0
  136. package/providers/context/actions/configure-community-indexer-fallback.yaml +6 -0
  137. package/providers/context/actions/configure-indexer-providers.yaml +6 -0
  138. package/providers/context/actions/confirm-index-requirement-workset.yaml +8 -0
  139. package/providers/context/actions/confirm-subject-reidentification.yaml +8 -0
  140. package/providers/context/actions/converge-main-index-partition-run.yaml +7 -0
  141. package/providers/context/actions/discover-markdown-indexer-providers.yaml +6 -0
  142. package/providers/context/actions/evaluate-material-gaps.yaml +8 -0
  143. package/providers/context/actions/fail-main-index-run.yaml +7 -0
  144. package/providers/context/actions/fail-material-answer-run.yaml +7 -0
  145. package/providers/context/actions/fail-post-author-composer-run.yaml +7 -0
  146. package/providers/context/actions/inspect-index-candidate-review-readiness.yaml +8 -0
  147. package/providers/context/actions/inspect-index-profile-failure.yaml +7 -0
  148. package/providers/context/actions/inspect-indexer-dependencies.yaml +7 -0
  149. package/providers/context/actions/inspect-indexer-program-execution.yaml +7 -0
  150. package/providers/context/actions/inspect-indexer-project-proposal.yaml +7 -0
  151. package/providers/context/actions/inspect-markdown-provider-capture.yaml +7 -0
  152. package/providers/context/actions/inspect-material-answer-review.yaml +8 -0
  153. package/providers/context/actions/materialize-indexer-instructions.yaml +7 -0
  154. package/providers/context/actions/observe-indexer-project.yaml +7 -0
  155. package/providers/context/actions/observe-main-index-run-ledger.yaml +7 -0
  156. package/providers/context/actions/observe-material-answer-runs.yaml +7 -0
  157. package/providers/context/actions/observe-post-author-composer-worksets.yaml +7 -0
  158. package/providers/context/actions/override-index-profile-audit.yaml +7 -0
  159. package/providers/context/actions/prepare-indexer-customization-project.yaml +7 -0
  160. package/providers/context/actions/prepare-main-index-run-ledger.yaml +7 -0
  161. package/providers/context/actions/prepare-material-answer-runs.yaml +7 -0
  162. package/providers/context/actions/propose-indexer-customization.yaml +7 -0
  163. package/providers/context/actions/propose-overlay-question-amendment.yaml +7 -0
  164. package/providers/context/actions/rebind-indexer-selection-to-requirement.yaml +7 -0
  165. package/providers/context/actions/reconcile-indexer-results.yaml +7 -0
  166. package/providers/context/actions/record-index-profile-revision.yaml +7 -0
  167. package/providers/context/actions/report-index-profile-failure.yaml +7 -0
  168. package/providers/context/actions/report-indexer-incremental-impact.yaml +8 -0
  169. package/providers/context/actions/resolve-effective-composers.yaml +7 -0
  170. package/providers/context/actions/review-material-answer-candidate.yaml +8 -0
  171. package/providers/context/actions/revise-index-output.yaml +7 -0
  172. package/providers/context/actions/route-index-requirement-confirmation.yaml +8 -0
  173. package/providers/context/actions/route-indexer-provider-selection.yaml +7 -0
  174. package/providers/context/actions/run-indexer-agent-step.yaml +7 -0
  175. package/providers/context/actions/run-indexer-lifecycle.yaml +7 -0
  176. package/providers/context/actions/run-indexer-post-author-composer.yaml +7 -0
  177. package/providers/context/actions/run-material-answer-indexers.yaml +7 -0
  178. package/providers/context/actions/start-main-index-run.yaml +7 -0
  179. package/providers/context/actions/start-material-answer-run.yaml +7 -0
  180. package/providers/context/actions/start-post-author-composer-run.yaml +7 -0
  181. package/providers/context/actions/validate-indexer-contract-overlays.yaml +7 -0
  182. package/providers/context/actions/validate-indexer-customization.yaml +7 -0
  183. package/providers/context/actions/validate-indexer-selection-proposal.yaml +7 -0
  184. package/providers/context/actions/validate-main-index-run.yaml +7 -0
  185. package/providers/context/actions/validate-markdown-provider-selection.yaml +7 -0
  186. package/providers/context/actions/validate-subject-key-schemas.yaml +8 -0
  187. package/providers/context/codes.yaml +69 -23
  188. package/providers/context/graphs/indexer.yaml +1042 -0
  189. package/providers/context/graphs/workspace.yaml +37 -454
  190. package/providers/context/manifest.json +1245 -433
  191. package/providers/context/provider.yaml +3 -2
  192. package/providers/context/resources/diagnostics/projection-stale.md +0 -1
  193. package/providers/context/resources/manuals/reference/project-api.md +41 -40
  194. package/providers/context/resources/views/document-optimization-current.yaml +1 -1
  195. package/providers/context/resources/views/package-current.yaml +1 -1
  196. package/providers/context/resources/views/resolved-indexer-instructions.yaml +23 -0
  197. package/providers/context/resources/views/review-current.yaml +1 -1
  198. package/providers/context/resources/views/source-boundary.yaml +1 -1
  199. package/providers/context/resources/views/source-current.yaml +1 -1
  200. package/providers/context/resources/views/verification-current.yaml +1 -1
  201. package/providers/context/resources/views/workspace-current.yaml +1 -1
  202. package/providers/context/schemas/indexer-agent-step-input.schema.json +30 -0
  203. package/providers/context/schemas/indexer-agent-step-result.schema.json +47 -0
  204. package/providers/context/schemas/indexer-candidate-compile-input.schema.json +57 -0
  205. package/providers/context/schemas/indexer-candidate-compile-output.schema.json +38 -0
  206. package/providers/context/schemas/indexer-candidate-review-readiness-input.schema.json +46 -0
  207. package/providers/context/schemas/indexer-candidate-review-readiness-output.schema.json +104 -0
  208. package/providers/context/schemas/indexer-contract-overlay-validation-input.schema.json +48 -0
  209. package/providers/context/schemas/indexer-contract-overlay-validation-result.schema.json +63 -0
  210. package/providers/context/schemas/indexer-customization-project-preparation-result.schema.json +44 -0
  211. package/providers/context/schemas/indexer-customization-proposal-draft.schema.json +83 -0
  212. package/providers/context/schemas/indexer-customization-validation-result.schema.json +36 -0
  213. package/providers/context/schemas/indexer-dependency-authorization-input.schema.json +71 -0
  214. package/providers/context/schemas/indexer-dependency-authorization-result.schema.json +138 -0
  215. package/providers/context/schemas/indexer-incremental-impact-input.schema.json +31 -0
  216. package/providers/context/schemas/indexer-incremental-impact-output.schema.json +52 -0
  217. package/providers/context/schemas/indexer-lifecycle-continuation.schema.json +15 -0
  218. package/providers/context/schemas/indexer-main-lifecycle-input.schema.json +187 -0
  219. package/providers/context/schemas/indexer-main-lifecycle-output.schema.json +180 -0
  220. package/providers/context/schemas/indexer-markdown-provider-capture-input.schema.json +17 -0
  221. package/providers/context/schemas/indexer-markdown-provider-capture-output.schema.json +54 -0
  222. package/providers/context/schemas/indexer-markdown-provider-validation-input.schema.json +34 -0
  223. package/providers/context/schemas/indexer-markdown-provider-validation-output.schema.json +75 -0
  224. package/providers/context/schemas/indexer-material-answer-lifecycle-input.schema.json +90 -0
  225. package/providers/context/schemas/indexer-material-answer-lifecycle-output.schema.json +80 -0
  226. package/providers/context/schemas/indexer-material-answer-review-inspection-input.schema.json +32 -0
  227. package/providers/context/schemas/indexer-material-answer-review-inspection-output.schema.json +32 -0
  228. package/providers/context/schemas/indexer-material-answer-review-resolution-input.schema.json +19 -0
  229. package/providers/context/schemas/indexer-material-answer-review-resolution-output.schema.json +87 -0
  230. package/providers/context/schemas/indexer-material-gap-lifecycle-input.schema.json +86 -0
  231. package/providers/context/schemas/indexer-material-gap-lifecycle-output.schema.json +19 -0
  232. package/providers/context/schemas/indexer-materialize-request.schema.json +53 -0
  233. package/providers/context/schemas/indexer-materialized-resource.schema.json +57 -0
  234. package/providers/context/schemas/indexer-overlay-question-amendment.schema.json +13 -0
  235. package/providers/context/schemas/indexer-overlay-question-proposal-input.schema.json +40 -0
  236. package/providers/context/schemas/indexer-overlay-question-rebind-input.schema.json +35 -0
  237. package/providers/context/schemas/indexer-overlay-question-rebind-result.schema.json +25 -0
  238. package/providers/context/schemas/indexer-post-author-fragment-request.schema.json +26 -0
  239. package/providers/context/schemas/indexer-post-author-fragment-result.schema.json +18 -0
  240. package/providers/context/schemas/indexer-post-author-lifecycle-input.schema.json +94 -0
  241. package/providers/context/schemas/indexer-post-author-lifecycle-output.schema.json +72 -0
  242. package/providers/context/schemas/indexer-profile-failure-inspection-input.schema.json +13 -0
  243. package/providers/context/schemas/indexer-profile-failure-inspection-result.schema.json +19 -0
  244. package/providers/context/schemas/indexer-profile-failure-report-input.schema.json +22 -0
  245. package/providers/context/schemas/indexer-profile-failure-report-result.schema.json +49 -0
  246. package/providers/context/schemas/indexer-profile-override-decision.schema.json +20 -0
  247. package/providers/context/schemas/indexer-profile-override-result.schema.json +49 -0
  248. package/providers/context/schemas/indexer-profile-revision-agent-input.schema.json +18 -0
  249. package/providers/context/schemas/indexer-profile-revision-record-input.schema.json +31 -0
  250. package/providers/context/schemas/indexer-profile-revision-record-result.schema.json +45 -0
  251. package/providers/context/schemas/indexer-program-execution-authorization-input.schema.json +145 -0
  252. package/providers/context/schemas/indexer-program-execution-authorization-result.schema.json +60 -0
  253. package/providers/context/schemas/indexer-project-action-result.schema.json +19 -0
  254. package/providers/context/schemas/indexer-project-gate-input.schema.json +100 -0
  255. package/providers/context/schemas/indexer-project-observation-input.schema.json +16 -0
  256. package/providers/context/schemas/indexer-project-observation-result.schema.json +42 -0
  257. package/providers/context/schemas/indexer-provider-route-input.schema.json +55 -0
  258. package/providers/context/schemas/indexer-provider-route-report.schema.json +188 -0
  259. package/providers/context/schemas/indexer-requirement-confirmation-input.schema.json +27 -0
  260. package/providers/context/schemas/indexer-requirement-confirmation-output.schema.json +24 -0
  261. package/providers/context/schemas/indexer-result-reconciliation-input.schema.json +59 -0
  262. package/providers/context/schemas/indexer-result-reconciliation-output.schema.json +43 -0
  263. package/providers/context/schemas/indexer-selection-proposal-input.schema.json +12 -0
  264. package/providers/context/schemas/indexer-selection-proposal-validation.schema.json +23 -0
  265. package/providers/context/schemas/indexer-subject-reidentification-input.schema.json +37 -0
  266. package/providers/context/schemas/indexer-subject-reidentification-output.schema.json +31 -0
  267. package/providers/context/skills/configure-indexer-providers/SKILL.md +58 -0
  268. package/providers/context/skills/prepare-indexer-customization-project/SKILL.md +31 -0
  269. package/providers/context/skills/propose-indexer-customization/SKILL.md +40 -0
  270. package/providers/context/skills/revise-index-output/SKILL.md +12 -0
  271. package/providers/context/skills/run-indexer-agent-step/SKILL.md +20 -0
  272. package/providers/context/skills/run-indexer-lifecycle/SKILL.md +36 -0
  273. package/providers/context/skills/run-indexer-post-author-composer/SKILL.md +21 -0
  274. package/providers/context/actions/align-next.yaml +0 -6
  275. package/providers/context/actions/apply-code-index-guidance.yaml +0 -5
  276. package/providers/context/actions/apply-structure-confirmation.yaml +0 -5
  277. package/providers/context/actions/compile-next.yaml +0 -5
  278. package/providers/context/actions/configure-code-extraction.yaml +0 -5
  279. package/providers/context/actions/configure-prose-lifecycle.yaml +0 -5
  280. package/providers/context/actions/extract-next.yaml +0 -5
  281. package/providers/context/actions/inspect-code-extraction.yaml +0 -5
  282. package/providers/context/actions/inspect-document-classification.yaml +0 -5
  283. package/providers/context/actions/inspect-structure.yaml +0 -5
  284. package/providers/context/actions/migrate-codeindex.yaml +0 -5
  285. package/providers/context/actions/optimize-documents.yaml +0 -6
  286. package/providers/context/actions/preview-extraction-batch.yaml +0 -5
  287. package/providers/context/actions/revise-code-index-audit.yaml +0 -5
  288. package/providers/context/actions/submit-code-index-audit.yaml +0 -6
  289. package/providers/context/resources/dialogue/code-extraction.md +0 -87
  290. package/providers/context/resources/dialogue/document-classification.md +0 -33
  291. package/providers/context/resources/dialogue/structure-confirmation.md +0 -44
  292. package/providers/context/resources/dialogue/workflow-mode-after-capture.md +0 -25
  293. package/providers/context/resources/manuals/reference/code-extractors.md +0 -152
  294. package/providers/context/resources/procedures/code-extraction.md +0 -184
  295. package/providers/context/resources/procedures/code-index-audit.md +0 -83
  296. package/providers/context/resources/procedures/document-classification.md +0 -22
  297. package/providers/context/resources/procedures/document-optimization.md +0 -91
  298. package/providers/context/resources/procedures/prose-align.md +0 -68
  299. package/providers/context/resources/procedures/prose-compile.md +0 -23
  300. package/providers/context/resources/semantic/align/candidate-resolution.md +0 -106
  301. package/providers/context/resources/semantic/align/density-profile.md +0 -41
  302. package/providers/context/resources/semantic/align/gates.md +0 -276
  303. package/providers/context/resources/semantic/align/structure-planning.md +0 -337
  304. package/providers/context/resources/semantic/code-index/classification.md +0 -270
  305. package/providers/context/resources/semantic/compile/index.md +0 -31
  306. package/providers/context/resources/views/code-index-audit.yaml +0 -6
  307. package/providers/context/resources/views/extraction-preview.yaml +0 -6
  308. package/providers/context/resources/views/structure-current.yaml +0 -6
  309. package/providers/context/schemas/code-index-audit-decision.schema.json +0 -94
  310. package/providers/context/schemas/document-optimization-decisions.schema.json +0 -57
  311. package/providers/context/schemas/prose-structure-batch.schema.json +0 -35
@@ -0,0 +1,23 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "context.indexer.selection-proposal-validation/v1",
4
+ "type": "object",
5
+ "required": [
6
+ "protocol",
7
+ "proposal",
8
+ "static_report",
9
+ "outcome",
10
+ "next_provider_requests",
11
+ "resolution_requests",
12
+ "validation_digest"
13
+ ],
14
+ "properties": {
15
+ "protocol": { "const": "context.indexer.selection-proposal-validation/v1" },
16
+ "proposal": { "type": "object" },
17
+ "static_report": { "type": "object" },
18
+ "outcome": { "const": "provider-resolution-required" },
19
+ "next_provider_requests": { "type": "array", "items": { "type": "object" } },
20
+ "resolution_requests": { "type": "array", "items": { "type": "object" } },
21
+ "validation_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
22
+ }
23
+ }
@@ -0,0 +1,37 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "context.indexer.subject-reidentification-input/v1",
4
+ "oneOf": [
5
+ {
6
+ "type": "object",
7
+ "required": ["protocol", "project_ref", "old_schema", "new_schema", "approved_subjects", "proposed_mappings"],
8
+ "properties": {
9
+ "protocol": { "const": "context.indexer.subject-key-validation-input/v1" },
10
+ "project_ref": { "type": "string", "minLength": 1 },
11
+ "old_schema": { "type": "object" },
12
+ "new_schema": { "type": "object" },
13
+ "approved_subjects": { "type": "array", "items": { "type": "object" } },
14
+ "proposed_mappings": { "type": "array", "items": { "type": "object" } },
15
+ "report": { "type": "object" },
16
+ "authorization": { "type": "object" }
17
+ },
18
+ "additionalProperties": false
19
+ },
20
+ {
21
+ "type": "object",
22
+ "required": ["protocol", "project_ref", "old_schema", "new_schema", "approved_subjects", "proposed_mappings", "report", "authorized_by", "authorized_at"],
23
+ "properties": {
24
+ "protocol": { "const": "context.indexer.subject-reidentification-confirmation-input/v1" },
25
+ "project_ref": { "type": "string", "minLength": 1 },
26
+ "old_schema": { "type": "object" },
27
+ "new_schema": { "type": "object" },
28
+ "approved_subjects": { "type": "array", "items": { "type": "object" } },
29
+ "proposed_mappings": { "type": "array", "items": { "type": "object" } },
30
+ "report": { "type": "object" },
31
+ "authorized_by": { "type": "string", "minLength": 1 },
32
+ "authorized_at": { "type": "string", "format": "date-time" }
33
+ },
34
+ "additionalProperties": false
35
+ }
36
+ ]
37
+ }
@@ -0,0 +1,31 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "context.indexer.subject-reidentification-output/v1",
4
+ "type": "object",
5
+ "required": ["protocol", "report", "graph_outcome"],
6
+ "properties": {
7
+ "protocol": {
8
+ "enum": [
9
+ "context.indexer.subject-key-validation-result/v1",
10
+ "context.indexer.subject-reidentification-confirmation-result/v1"
11
+ ]
12
+ },
13
+ "report": { "type": "object" },
14
+ "authorization": { "type": "object" },
15
+ "authorization_digest": {
16
+ "oneOf": [
17
+ { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
18
+ { "type": "null" }
19
+ ]
20
+ },
21
+ "outcome": {
22
+ "enum": [
23
+ "subject-key-schema-current",
24
+ "index-subject-reidentification-required",
25
+ "index-subject-reidentification-invalid"
26
+ ]
27
+ },
28
+ "graph_outcome": { "enum": ["completed", "blocked", "failed"] }
29
+ },
30
+ "additionalProperties": false
31
+ }
@@ -0,0 +1,58 @@
1
+ ---
2
+ name: context-configure-indexer-providers
3
+ description: Build one path-free Context Indexer Provider selection from current requirements and visible Indexer Skills; use during the provider-selection Graph route, not for executing Providers or changing requirements.
4
+ metadata:
5
+ agent-graph: path:../../provider.yaml
6
+ agent-graph.graph: indexer
7
+ agent-graph.entry: provider-selection
8
+ ---
9
+
10
+ # Configure Indexer Providers
11
+
12
+ Read
13
+ `node_modules/@c4a/context/docs/guides/indexer-provider-and-customization.md`
14
+ for the registry-only default, Provider-layer rules, conflict handling and
15
+ completion conditions. This Action is the entry for
16
+ `indexer-provider-required`; when an exact distribution is unavailable, follow
17
+ the guide's `indexer-provider-unavailable` handling instead of substituting a
18
+ different version or cache.
19
+
20
+ Report the exact CLI-bundled catalog together with other Indexer entry Skills
21
+ already visible in this conversation. For an exact Skill root already exposed
22
+ by the Host, read only `SKILL.md` frontmatter and the sibling
23
+ `context-indexer.yaml`: the manifest version is authoritative and
24
+ `metadata.context-provider-version` must match it. Do not load Provider guidance
25
+ until selection. Group the same Skill name and exact version into one
26
+ conversation item with all observed source types; an installed copy of the
27
+ same CLI-bundled identity is not another Provider. Preserve distinct source
28
+ observations in `visible_skills`, keep different versions separate, and never
29
+ use source count or discovery order as precedence. Do not scan plugin caches or
30
+ persist this discovery list.
31
+
32
+ When the Graph enters through `markdown-provider`, first require the completed
33
+ capture report and report the visible `context-markdown-indexer*` Skills before
34
+ building the route input. Treat only the report's exact `source_inputs` as
35
+ current evidence. Do not infer semantic ownership from filenames, titles, or
36
+ headings, and do not persist the discovery list. Capture proves byte/currentness
37
+ only; the selected Markdown Provider remains responsible for semantic indexing.
38
+
39
+ Produce `context.indexer.provider-route-input/v1` for the current, unchanged
40
+ requirement set. Select portable distribution locators and exact versions and
41
+ integrities. Each required requirement/domain/source/module owner cell needs one
42
+ primary Indexer; overlapping read scope is allowed for enrichers. One Indexer
43
+ may combine a primary layer, supporting profiles, extension layers, and
44
+ composers, but Provider array order is not precedence.
45
+
46
+ On the first pass set `community_fallback_attempted: false`. If the CLI records
47
+ the route Action as `partial`, retry with the applicable CLI-bundled community
48
+ profile and set it to `true`. If the CLI reports conflicting primary owner cells,
49
+ do not choose one by name order: present the exact conflict and wait for a
50
+ decision. If fallback still leaves an unowned required cell, preserve the exact
51
+ CLI `capability_gap_proof` and record `blocked`; never invent a Provider or
52
+ weaken the requirement. Only the following `propose-indexer-customization`
53
+ Action may use that proof to draft a dependency-free minimal `extend`.
54
+
55
+ Record the CLI Route Action outcome exactly from `route.graph_outcome`. Only a
56
+ `completed` report may pass its `selection_proposal_input` to
57
+ `validate-indexer-selection-proposal`. Provider resolution and execution remain
58
+ separate Actions.
@@ -0,0 +1,31 @@
1
+ ---
2
+ name: prepare-indexer-customization-project
3
+ description: Resolve the exact validated customization selection and stage its CAS-bound project proposal.
4
+ ---
5
+
6
+ # Prepare Indexer customization project
7
+
8
+ Read
9
+ `node_modules/@c4a/context/docs/guides/indexer-provider-and-customization.md`
10
+ before staging a project proposal. If validation reports an invalid local
11
+ resource or upstream drift, preserve the exact
12
+ `indexer-customization-invalid`/`indexer-customization-upstream-changed`
13
+ diagnostic and return to reconciliation; do not silently drop or overwrite the
14
+ affected override.
15
+
16
+ Consume only the current `context.indexer.customization-validation-result/v1`.
17
+
18
+ 1. Pass `selection_proposal_input` to `context indexer validate-indexer-selection-proposal`.
19
+ 2. Resolve every emitted Provider request through `context indexer resolve-indexer-providers`; never scan a
20
+ plugin cache or substitute another version. Stage each resolved Bundle with
21
+ `context indexer stage-indexer-provider-bundle`.
22
+ 3. Build `context.indexer.customization-project-preparation-input/v1` with the exact validation digest,
23
+ static report, resolved/staged Bundle inputs, and current CLI operator/profile contracts. Run
24
+ `context indexer prepare-indexer-customization-project`.
25
+ 4. If the result is `program-authorization-required`, stop at the independent program-execution authority.
26
+ Do not invent the authority receipt and do not apply any source file.
27
+ 5. If the result is `project-confirmation-required`, preserve the returned proposal digest and staging
28
+ validation unchanged for the confirmation/apply route.
29
+
30
+ Never copy Provider files into the project, widen requirement scope, add dependency intents, or bypass the
31
+ content-addressed customization stage.
@@ -0,0 +1,40 @@
1
+ ---
2
+ name: context-propose-indexer-customization
3
+ description: Propose one minimal dependency-free extend customization only after the Context CLI has emitted a final capability-gap proof.
4
+ metadata:
5
+ agent-graph: path:../../provider.yaml
6
+ agent-graph.graph: indexer
7
+ agent-graph.entry: provider-selection
8
+ ---
9
+
10
+ # Propose Indexer Customization
11
+
12
+ Read
13
+ `node_modules/@c4a/context/docs/guides/indexer-provider-and-customization.md`
14
+ and follow its six-level ladder. This Action handles the
15
+ `indexer-customization-required` outcome only; it must not reinterpret
16
+ `indexer-customization-invalid` or
17
+ `indexer-customization-upstream-changed` as permission to replace upstream
18
+ resources.
19
+
20
+ Use this Action only when its exact input is a
21
+ `context.indexer.provider-route-report/v1` whose route outcome is
22
+ `indexer-customization-required` and whose `capability_gap_proof` is present. Copy the
23
+ exact route input and report into `capability_gap`, and copy the proof's
24
+ `gap_digest` into the draft. Close every smaller ladder step in order with its
25
+ CLI/provider evidence digest. Never infer a gap from prose, a Provider manifest,
26
+ or an earlier route attempt.
27
+
28
+ Propose the smallest `extend` change that can close only the reported owner
29
+ cells and affected scopes. First close Provider-only and config levels with the
30
+ route evidence; then prefer appended instructions, one exact template
31
+ override, and a fixed local program extension in that order. Include only files
32
+ under `src/indexer/<indexer-id>/` and preserve the required Provider origin
33
+ comment. Do not create a `replace` draft, widen source scope, weaken the
34
+ requirement, or add dependency intents.
35
+
36
+ The output is an untrusted draft for the next CLI validation Action. Do not
37
+ write project source, install dependencies, execute local code, or claim that
38
+ the customization is applied. If no dependency-free `extend` can close the
39
+ exact gap, report the limitation and stop for human/dependency/program
40
+ authorization instead of emitting a conforming-looking draft.
@@ -0,0 +1,12 @@
1
+ ---
2
+ name: revise-index-output
3
+ description: Revise one exact Indexer candidate set in response to a recorded runtime profile failure.
4
+ ---
5
+
6
+ # Revise Index Output
7
+
8
+ Read the current profile audit and its failed metric samples. Change only the bound candidate revision; do not change source scope, requirements, baseline checks, metric thresholds, or provider authority.
9
+
10
+ Return `context.indexer.profile-revision-record-input/v1` with the new result fingerprint, a concrete list of actions taken, unresolved reasons, and the current ledger digest. A semantically unchanged fingerprint is not a new attempt.
11
+
12
+ After the third failed attempt, stop revising. The CLI must produce the complete failure report before any override is requested.
@@ -0,0 +1,20 @@
1
+ ---
2
+ name: context-run-indexer-agent-step
3
+ description: Execute one Context-authorized Indexer workset using only the current Route input and resolved Provider instructions.
4
+ metadata:
5
+ agent-graph: path:../../provider.yaml
6
+ agent-graph.graph: indexer
7
+ agent-graph.entry: agent-step
8
+ ---
9
+
10
+ # Run one Indexer Agent step
11
+
12
+ Read the current Route action input and every required Resource marked `read-required`.
13
+ Use only the materialized `resolved-indexer-instructions` content, the supplied workset,
14
+ composition input, and Context-authorized evidence. Do not discover another Skill, read a
15
+ Provider path, widen source scope, run a program, or invent missing evidence.
16
+
17
+ Return exactly `context.indexer.agent-step-result/v1`. Preserve the supplied input and
18
+ execution request digests, bind the materialized instruction payload digest, and include
19
+ the current Host execution receipt. Context performs the final schema, evidence, owner,
20
+ scope, and workset validation; never report success merely because the prose looks valid.
@@ -0,0 +1,36 @@
1
+ ---
2
+ name: context-run-indexer-lifecycle
3
+ description: Continue the sole Context registry-and-Provider indexing route; use only when the workspace Graph selects route.indexer.lifecycle-required.
4
+ metadata:
5
+ agent-graph: path:../../provider.yaml
6
+ agent-graph.graph: workspace
7
+ agent-graph.entry: context
8
+ ---
9
+
10
+ # Run The Indexer Lifecycle
11
+
12
+ This Action replaces the retired extraction, document-classification, align,
13
+ structure-confirmation, and prose default-plan routes. Do not invoke those
14
+ paths and do not turn existing approved knowledge into an indexing fallback.
15
+
16
+ Read
17
+ `node_modules/@c4a/context/docs/guides/indexer-provider-and-customization.md`,
18
+ then follow the root `context` Skill's Indexer instructions and the exact
19
+ structured outcomes returned by `context indexer ...`. Start by forming and
20
+ confirming requirements when `src/indexers.yaml` is absent or stale; otherwise
21
+ continue the current registry selection, Provider resolution, execution,
22
+ reconciliation, layout, audit, and Candidate compile subroute. The Indexer
23
+ Graph is the authority for each substep. Never skip directly to compile and
24
+ never synthesize a Provider Result or a default plan.
25
+
26
+ Stop on the first Host permission, non-delegatable Gate, validation failure, or
27
+ human decision. Once current Candidates have been compiled, return control to
28
+ `context status --format json`; the workspace Graph will select Knowledge
29
+ Review. The Action output is only:
30
+
31
+ ```json
32
+ {
33
+ "protocol": "context.indexer.lifecycle-continuation/v1",
34
+ "outcome": "follow-indexer-route"
35
+ }
36
+ ```
@@ -0,0 +1,21 @@
1
+ ---
2
+ name: context-run-indexer-post-author-composer
3
+ description: Execute one CLI-authorized post-author composer request without changing primary facts, identity, scope, or composer selection.
4
+ metadata:
5
+ agent-graph: path:../../provider.yaml
6
+ agent-graph.graph: indexer
7
+ agent-graph.entry: post-author-composer-step
8
+ ---
9
+
10
+ # Run one post-author composer
11
+
12
+ Read the current Route input and the exact `context.indexer.layer-fragment-request/v1`.
13
+ Use only its bounded `primary_result_view`, selected `composer_ref`, allowed target refs,
14
+ and the resolved instructions supplied by Context. Do not discover another Skill or
15
+ composer, read project files outside the request, change a SubjectKey, create a complete
16
+ primary Result, or widen the target set.
17
+
18
+ Return exactly `context.indexer.layer-fragment-result/v1`. Preserve the request digest,
19
+ composer ref, and consumed PrimaryResultView digest. Return only zero or more
20
+ `derived-artifact-proposal` fragments for allowed targets. Context performs final schema,
21
+ identity, evidence, policy, layer, and receipt validation before accepting the Result.
@@ -1,6 +0,0 @@
1
- schema: agent-graph.action.v1
2
- id: align-next
3
- runner: host
4
- effect: write
5
- handler: context.align.next
6
- inputSchema: schemas/prose-structure-batch.schema.json
@@ -1,5 +0,0 @@
1
- schema: agent-graph.action.v1
2
- id: apply-code-index-guidance
3
- runner: host
4
- effect: write
5
- handler: context.project.apply-code-index-guidance
@@ -1,5 +0,0 @@
1
- schema: agent-graph.action.v1
2
- id: apply-structure-confirmation
3
- runner: host
4
- effect: write
5
- handler: context.structure.confirm
@@ -1,5 +0,0 @@
1
- schema: agent-graph.action.v1
2
- id: compile-next
3
- runner: host
4
- effect: write
5
- handler: context.compile.next
@@ -1,5 +0,0 @@
1
- schema: agent-graph.action.v1
2
- id: configure-code-extraction
3
- runner: host
4
- effect: write
5
- handler: context.project.configure-extraction
@@ -1,5 +0,0 @@
1
- schema: agent-graph.action.v1
2
- id: configure-prose-lifecycle
3
- runner: host
4
- effect: write
5
- handler: context.project.configure-prose
@@ -1,5 +0,0 @@
1
- schema: agent-graph.action.v1
2
- id: extract-next
3
- runner: host
4
- effect: write
5
- handler: context.extract.next
@@ -1,5 +0,0 @@
1
- schema: agent-graph.action.v1
2
- id: inspect-code-extraction
3
- runner: host
4
- effect: read
5
- handler: context.extract.inspect-capabilities
@@ -1,5 +0,0 @@
1
- schema: agent-graph.action.v1
2
- id: inspect-document-classification
3
- runner: host
4
- effect: read
5
- handler: context.document.inspect-classification
@@ -1,5 +0,0 @@
1
- schema: agent-graph.action.v1
2
- id: inspect-structure
3
- runner: host
4
- effect: read
5
- handler: context.structure.inspect
@@ -1,5 +0,0 @@
1
- schema: agent-graph.action.v1
2
- id: migrate-codeindex
3
- runner: host
4
- effect: write
5
- handler: context.code-index.migrate
@@ -1,6 +0,0 @@
1
- schema: agent-graph.action.v1
2
- id: optimize-documents
3
- runner: host
4
- effect: write
5
- handler: context.document-optimization.next
6
- inputSchema: schemas/document-optimization-decisions.schema.json
@@ -1,5 +0,0 @@
1
- schema: agent-graph.action.v1
2
- id: preview-extraction-batch
3
- runner: host
4
- effect: write
5
- handler: context.extract.preview-batch
@@ -1,5 +0,0 @@
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
@@ -1,6 +0,0 @@
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
@@ -1,87 +0,0 @@
1
- ---
2
- id: dialogue.code-extraction
3
- kind: procedure
4
- mediaType: text/markdown
5
- ---
6
-
7
- # Code-extraction dialogue
8
-
9
- Begin with the Route-selected batch inspection. Classify all modules from that
10
- evidence before opening any archetype template, inspect source files only for
11
- unresolved facts, then read every matching Route-recommended type or facet
12
- template. For all modules in the current batch, state:
13
-
14
- - the confirmed repository module;
15
- - the primary and additional module types, composable facets, evidence paths,
16
- stable responsibility, entries, external protocols and important dependencies;
17
- - the output owner/profile and planned page kinds;
18
- - which files or generated/derived areas are excluded;
19
- - whether extraction follows configured/public entries or scans all matched
20
- files;
21
- - whether internal symbols are included; and
22
- - that the first run or later deltas produce Review candidates rather than
23
- approved Markdown.
24
-
25
- Also state the inspected manifest signals and the chosen extractor in one
26
- sentence. Say whether the selected capability covers the module directly or
27
- whether a project-owned adapter supplies the missing mapping. Do not ask the
28
- user to choose between parser package names unless two genuinely incompatible
29
- technical choices remain.
30
-
31
- In fully managed mode, write the same fields into one batch report instead of
32
- asking or narrating them module by module. A typed `material-required` gap and
33
- the measured scale limit remain observable in both modes; advisory risks do not
34
- create another confirmation Gate.
35
-
36
- If a selected package lacks a standard entry, offer two Context-owned choices:
37
- configure source-relative API roots, or use scan mode for all declarations in
38
- the confirmed file scope. Do not ask the user to change source code or package
39
- metadata to satisfy Context.
40
-
41
- `extractTs()` creates one candidate page per selected symbol and assigns a
42
- source to one index unit. Use it only when that granular shape is the intended
43
- public reference. For an aggregate module map, registry, protocol index, or
44
- cross-module flow—or multiple units over one source—use `extractCustom()` and
45
- declare candidate ownership. If an optional structural extractor is available,
46
- use it for syntax facts and keep project-specific classification in the project
47
- callback; do not imply that installing it adds a new CLI phase.
48
-
49
- Do not predict page counts from the template examples. Run the route-selected
50
- batch preview once after the plan is configured. Report discovered, AST-analyzed,
51
- skipped, symbol, relation, and candidate counts separately, plus resolved
52
- entries, exported/internal counts, symbol-kind counts, output ownership and the
53
- proposed knowledge tree.
54
- Treat those fields as structural scope evidence, not a semantic ranking. Stop
55
- when the preview crosses the confirmed module boundary or the module
56
- identity/path shape is wrong.
57
-
58
- Also report the unit inventory: eligible/analyzed file and LOC counts,
59
- discovered/read Markdown, target/exported symbols, stable entry and boundary
60
- targets, exclusions and parser gaps. After extraction, read every independent
61
- audit dimension and the exact uncovered identities. Use the CLI-selected
62
- repair actions and matching templates; do not invent a total score.
63
-
64
- Apply the per-index-unit policy exactly: up to 100 pages proceeds; 101–300 pages
65
- warns and proceeds; more than 300 pages stops even in fully managed mode. Group
66
- all oversized or capability-gap units into one explanation and one plan-revision
67
- Gate instead of asking about modules one by one. If the revision changes a
68
- module's classification, read the newly selected template before editing the
69
- plan; otherwise reuse the current classification and avoid another
70
- classification dialogue.
71
-
72
- When blocked, propose only legal revisions: narrow `include`, exclude generated
73
- or mirrored areas, enable `exportedOnly`, change to an aggregate
74
- `extractCustom()` shape, or register real child sources. Do not split one
75
- `extractTs()` source into overlapping index units. Report a batch-total page
76
- advisory as a cost signal, not a new Gate.
77
-
78
- In fully managed mode, revise absolute failures automatically and aim for each
79
- recommended target. After three attempts with the same unit/problem fingerprint,
80
- stop at the single aggregated guidance Gate and report all failed modules,
81
- dimensions, attempted actions, and likely missing material together. Ordinary
82
- mode also makes one batch decision; it does not create one user Gate per module.
83
-
84
- For a multi-module round, finish every pending extraction target before opening
85
- one Review. For an unchanged repeat run, explain that no added, changed, or
86
- removed symbols need a decision. Mention `extractTs`, `include`, `entries`,
87
- `mode`, or `exportedOnly` only in technical configuration detail.
@@ -1,33 +0,0 @@
1
- ---
2
- id: dialogue.document-classification
3
- kind: procedure
4
- mediaType: text/markdown
5
- ---
6
-
7
- # Document-classification dialogue
8
-
9
- Do not recommend a collection before reading the collection-neutral evidence
10
- view and every required source-body resource. Summarize the observed document
11
- shape, explain one evidence-backed
12
- recommendation, and describe its package root:
13
-
14
- | Collection | Use when the evidence primarily represents | Package root |
15
- |---|---|---|
16
- | `business` | business domains, actors, objects, and non-technical domain knowledge | `wikis/` |
17
- | `product` | requirements, user behavior, user stories, and acceptance intent | `wikis/` |
18
- | `architecture` | system structure, module design, technical mechanisms, and platform/tooling design | `guides/` |
19
- | `sop` | procedures, runbooks, operations, maintenance, and troubleshooting steps | `guides/` |
20
- | `faq` | question-and-answer material intended for issue-oriented retrieval | `guides/` |
21
- | `standards` | normative rules, constraints, checklists, and quality/compliance requirements | `rules/` |
22
- | `decision` | explicit alternatives, selected choices, trade-offs, and decision records | `guides/` |
23
- | `incident` | incident timelines, impact, causes, response, and prevention | `guides/` |
24
- | `test` | test plans, validation scenarios, matrices, and acceptance cases | `rules/` |
25
-
26
- `codeindex` comes from code extraction and `feats` is not a document mainline
27
- collection. Filenames, URLs, titles, and example collection names are
28
- insufficient evidence.
29
-
30
- Ask the user to confirm exactly one mainline collection for the current source,
31
- unless session-managed authority resolves this gate. After confirmation,
32
- declare the complete align, compile, and Review lifecycle for the same source
33
- and collection, then re-evaluate because other captured targets may remain.
@@ -1,44 +0,0 @@
1
- ---
2
- id: dialogue.structure-confirmation
3
- kind: procedure
4
- mediaType: text/markdown
5
- ---
6
-
7
- # Structure-confirmation dialogue
8
-
9
- Present the staged structure as a proposal, not as approved knowledge. Explain
10
- that confirmation freezes the current round's:
11
-
12
- - knowledge pages and paths;
13
- - section ownership and source spans;
14
- - source-backed relationships; and
15
- - compile order.
16
-
17
- The final staged HTML report is the confirmation surface. Open it when the CLI
18
- returns it, report whether opening succeeded, and provide the file URL/path when
19
- it did not. Do not confirm from counts alone.
20
-
21
- Present these three outcomes in the user's language:
22
-
23
- - confirm the current staged structure digest;
24
- - revise the proposed structure and validate/stage it again; or
25
- - return to the source boundary when the current evidence scope is wrong.
26
-
27
- If staging changed the structure digest, any earlier confirmation no longer
28
- applies. When `workflow.current.gate.resolution` is `user`, explain the change
29
- and obtain a new confirmation. When it is `session-authority`, inspect the same
30
- report and continue without asking again. After resolution, execute only the
31
- revision-bound command returned by `workflow.current`; never construct or reuse
32
- a phase-local confirmation command.
33
-
34
- Deterministic boundary repairs are internal CLI maintenance and are not
35
- separate approval rounds. If `workflow.current.gate.resolution` is
36
- `session-authority`, inspect the final staged report and execute the returned
37
- resolution command without asking the user again. Otherwise ask for one final
38
- confirmation of the staged digest. Ask an earlier design question only when
39
- evidence supports multiple incompatible structures, and say clearly that it is
40
- not the final confirmation.
41
-
42
- One source document may map to one page, but that is still an ordinary
43
- structure proposal. A multi-source round confirms each source/collection slot;
44
- do not confuse one slot with completion of the entire document batch.
@@ -1,25 +0,0 @@
1
- ---
2
- id: dialogue.workflow-mode-after-capture
3
- kind: procedure
4
- mediaType: text/markdown
5
- ---
6
-
7
- # Workflow mode after source capture
8
-
9
- When source capture has completed, ask about execution mode only if the
10
- conversation still has no explicit choice and no earlier mode question was
11
- asked. If ordinary review or fully managed operation was already selected,
12
- continue without a reminder or another confirmation. When a choice is still
13
- needed, explain in the user's current conversation language that ordinary
14
- review pauses at review decisions and provides HTML reports for inspection.
15
- The current product estimate is that ordinary review makes the overall workflow
16
- about 40% slower, with the exact difference depending on scope and response
17
- time.
18
-
19
- Offer fully managed operation for the rest of the current conversation. Explain
20
- that it skips delegatable content-review surfaces and is faster, but reduces the
21
- user's ability to control or adjust intermediate content. It does not bypass
22
- source boundaries, external permissions, hard validation, evidence checks,
23
- verification failures, or other non-delegatable safety boundaries. Do not ask
24
- again after this one-time conversation choice, and never persist it in project
25
- files.