@c4a/context-cli 0.7.1 → 0.7.5

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 (161) hide show
  1. package/README.md +18 -39
  2. package/README.zh-CN.md +13 -27
  3. package/cli.js +64945 -81995
  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 +12 -2
  23. package/plugins/VERSION +1 -1
  24. package/plugins/claude/.claude-plugin/plugin.json +1 -1
  25. package/plugins/claude/commands/context.md +56 -107
  26. package/plugins/codex/.codex-plugin/plugin.json +2 -2
  27. package/plugins/codex/skills/context/SKILL.md +56 -107
  28. package/plugins/cursor/.cursor-plugin/plugin.json +1 -1
  29. package/plugins/cursor/commands/c4a-context.md +56 -107
  30. package/plugins/skills/context/SKILL.md +56 -107
  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/authorize-current-indexer-provider-program.yaml +6 -0
  48. package/providers/context/actions/configure-indexer-providers.yaml +1 -1
  49. package/providers/context/actions/finalize-current-indexer-provider-selection.yaml +5 -0
  50. package/providers/context/actions/materialize-indexer-workset-view.yaml +7 -0
  51. package/providers/context/actions/resolve-current-indexer-gate.yaml +6 -0
  52. package/providers/context/actions/resolve-current-indexer-provider.yaml +6 -0
  53. package/providers/context/actions/run-indexer-lifecycle.yaml +0 -1
  54. package/providers/context/actions/run-indexer-post-author-composer.yaml +2 -2
  55. package/providers/context/codes.yaml +8 -22
  56. package/providers/context/graphs/indexer.yaml +95 -564
  57. package/providers/context/graphs/workspace.yaml +5 -43
  58. package/providers/context/manifest.json +119 -678
  59. package/providers/context/provider.yaml +1 -1
  60. package/providers/context/resources/dialogue/human-gates.md +3 -3
  61. package/providers/context/resources/dialogue/knowledge-review.md +6 -3
  62. package/providers/context/resources/manuals/reference/package-templates.md +2 -3
  63. package/providers/context/resources/manuals/reference/project-api.md +52 -986
  64. package/providers/context/resources/procedures/close-and-build.md +8 -23
  65. package/providers/context/resources/procedures/knowledge-review.md +17 -5
  66. package/providers/context/resources/procedures/source-capture-detailed.md +6 -8
  67. package/providers/context/resources/views/authorized-indexer-workset-view.yaml +15 -0
  68. package/providers/context/resources/views/resolved-indexer-instructions.yaml +2 -4
  69. package/providers/context/schemas/indexer-agent-step-input.schema.json +71 -21
  70. package/providers/context/schemas/indexer-agent-step-result.schema.json +385 -32
  71. package/providers/context/schemas/indexer-authorized-workset-view.schema.json +65 -0
  72. package/providers/context/schemas/indexer-main-lifecycle-input.schema.json +13 -20
  73. package/providers/context/schemas/indexer-main-lifecycle-output.schema.json +17 -2
  74. package/providers/context/schemas/indexer-materialize-request.schema.json +4 -8
  75. package/providers/context/schemas/indexer-materialized-resource.schema.json +8 -1
  76. package/providers/context/schemas/indexer-overlay-question-proposal-input.schema.json +51 -2
  77. package/providers/context/schemas/indexer-workset-view-materialization-request.schema.json +35 -0
  78. package/providers/context/skills/authorize-current-indexer-provider-program/SKILL.md +20 -0
  79. package/providers/context/skills/configure-indexer-providers/SKILL.md +47 -33
  80. package/providers/context/skills/resolve-current-indexer-gate/SKILL.md +27 -0
  81. package/providers/context/skills/resolve-current-indexer-provider/SKILL.md +20 -0
  82. package/providers/context/skills/run-indexer-agent-step/SKILL.md +49 -10
  83. package/providers/context/skills/run-indexer-lifecycle/SKILL.md +19 -13
  84. package/providers/context/skills/run-indexer-post-author-composer/SKILL.md +52 -11
  85. package/docs/document-optimization.md +0 -82
  86. package/docs/document-optimization.zh-CN.md +0 -70
  87. package/indexers/capability-manifest.json +0 -35
  88. package/indexers/contracts/hard-rule-conformance.json +0 -2644
  89. package/providers/context/actions/accept-main-index-run.yaml +0 -7
  90. package/providers/context/actions/accept-material-answer-run.yaml +0 -7
  91. package/providers/context/actions/accept-post-author-composer-run.yaml +0 -7
  92. package/providers/context/actions/actualize-material-answer-bindings.yaml +0 -8
  93. package/providers/context/actions/audit-material-gap-state.yaml +0 -8
  94. package/providers/context/actions/audit-projected-artifact-fan-out.yaml +0 -8
  95. package/providers/context/actions/build-main-index-author-worksets.yaml +0 -7
  96. package/providers/context/actions/build-main-index-catalog-fallback.yaml +0 -7
  97. package/providers/context/actions/build-main-index-partition-worksets.yaml +0 -7
  98. package/providers/context/actions/build-material-question-workset.yaml +0 -7
  99. package/providers/context/actions/build-post-author-composer-worksets.yaml +0 -7
  100. package/providers/context/actions/build-question-target-inventory.yaml +0 -7
  101. package/providers/context/actions/build-subject-catalog.yaml +0 -7
  102. package/providers/context/actions/build-target-resolution-views.yaml +0 -7
  103. package/providers/context/actions/checkpoint-material-answer-review.yaml +0 -8
  104. package/providers/context/actions/checkpoint-material-gaps.yaml +0 -8
  105. package/providers/context/actions/close-indexer-approved-knowledge.yaml +0 -8
  106. package/providers/context/actions/compose-indexer-post-author-fragments.yaml +0 -7
  107. package/providers/context/actions/converge-main-index-partition-run.yaml +0 -7
  108. package/providers/context/actions/evaluate-material-gaps.yaml +0 -8
  109. package/providers/context/actions/fail-main-index-run.yaml +0 -7
  110. package/providers/context/actions/fail-material-answer-run.yaml +0 -7
  111. package/providers/context/actions/fail-post-author-composer-run.yaml +0 -7
  112. package/providers/context/actions/inspect-index-candidate-review-readiness.yaml +0 -8
  113. package/providers/context/actions/inspect-index-profile-failure.yaml +0 -7
  114. package/providers/context/actions/inspect-material-answer-review.yaml +0 -8
  115. package/providers/context/actions/observe-main-index-run-ledger.yaml +0 -7
  116. package/providers/context/actions/observe-material-answer-runs.yaml +0 -7
  117. package/providers/context/actions/observe-post-author-composer-worksets.yaml +0 -7
  118. package/providers/context/actions/override-index-profile-audit.yaml +0 -7
  119. package/providers/context/actions/prepare-main-index-run-ledger.yaml +0 -7
  120. package/providers/context/actions/prepare-material-answer-runs.yaml +0 -7
  121. package/providers/context/actions/reconcile-indexer-results.yaml +0 -7
  122. package/providers/context/actions/reconcile-review-identities.yaml +0 -5
  123. package/providers/context/actions/record-index-profile-revision.yaml +0 -7
  124. package/providers/context/actions/report-index-profile-failure.yaml +0 -7
  125. package/providers/context/actions/resolve-effective-composers.yaml +0 -7
  126. package/providers/context/actions/review-material-answer-candidate.yaml +0 -8
  127. package/providers/context/actions/revise-document.yaml +0 -5
  128. package/providers/context/actions/revise-index-output.yaml +0 -7
  129. package/providers/context/actions/run-material-answer-indexers.yaml +0 -7
  130. package/providers/context/actions/start-main-index-run.yaml +0 -7
  131. package/providers/context/actions/start-material-answer-run.yaml +0 -7
  132. package/providers/context/actions/start-post-author-composer-run.yaml +0 -7
  133. package/providers/context/resources/procedures/document-revision.md +0 -36
  134. package/providers/context/resources/views/document-optimization-current.yaml +0 -6
  135. package/providers/context/schemas/indexer-candidate-review-readiness-input.schema.json +0 -46
  136. package/providers/context/schemas/indexer-candidate-review-readiness-output.schema.json +0 -104
  137. package/providers/context/schemas/indexer-lifecycle-continuation.schema.json +0 -15
  138. package/providers/context/schemas/indexer-material-answer-lifecycle-input.schema.json +0 -90
  139. package/providers/context/schemas/indexer-material-answer-lifecycle-output.schema.json +0 -80
  140. package/providers/context/schemas/indexer-material-answer-review-inspection-input.schema.json +0 -32
  141. package/providers/context/schemas/indexer-material-answer-review-inspection-output.schema.json +0 -32
  142. package/providers/context/schemas/indexer-material-answer-review-resolution-input.schema.json +0 -19
  143. package/providers/context/schemas/indexer-material-answer-review-resolution-output.schema.json +0 -87
  144. package/providers/context/schemas/indexer-material-gap-lifecycle-input.schema.json +0 -86
  145. package/providers/context/schemas/indexer-material-gap-lifecycle-output.schema.json +0 -19
  146. package/providers/context/schemas/indexer-post-author-fragment-request.schema.json +0 -26
  147. package/providers/context/schemas/indexer-post-author-fragment-result.schema.json +0 -18
  148. package/providers/context/schemas/indexer-post-author-lifecycle-input.schema.json +0 -94
  149. package/providers/context/schemas/indexer-post-author-lifecycle-output.schema.json +0 -72
  150. package/providers/context/schemas/indexer-profile-failure-inspection-input.schema.json +0 -13
  151. package/providers/context/schemas/indexer-profile-failure-inspection-result.schema.json +0 -19
  152. package/providers/context/schemas/indexer-profile-failure-report-input.schema.json +0 -22
  153. package/providers/context/schemas/indexer-profile-failure-report-result.schema.json +0 -49
  154. package/providers/context/schemas/indexer-profile-override-decision.schema.json +0 -20
  155. package/providers/context/schemas/indexer-profile-override-result.schema.json +0 -49
  156. package/providers/context/schemas/indexer-profile-revision-agent-input.schema.json +0 -18
  157. package/providers/context/schemas/indexer-profile-revision-record-input.schema.json +0 -31
  158. package/providers/context/schemas/indexer-profile-revision-record-result.schema.json +0 -45
  159. package/providers/context/schemas/indexer-result-reconciliation-input.schema.json +0 -59
  160. package/providers/context/schemas/indexer-result-reconciliation-output.schema.json +0 -43
  161. package/providers/context/skills/revise-index-output/SKILL.md +0 -12
@@ -1,26 +1,26 @@
1
1
  {
2
2
  "protocol": "context.indexer.cli-release-manifest/v1",
3
3
  "package": "@c4a/context-cli",
4
- "version": "0.7.1",
4
+ "version": "0.7.5",
5
5
  "issuer": "context4ai/context",
6
6
  "bundles": [
7
7
  {
8
8
  "skill": "context-code-indexer",
9
- "version": "1.0.0",
9
+ "version": "1.1.2",
10
10
  "distribution": {
11
11
  "kind": "cli-bundled",
12
12
  "locator": "cli-bundled://context/context-code-indexer"
13
13
  },
14
- "integrity": "sha256:3719500f30c5920037dc2421b1ade80befdcfba0ea0eb0e38cccf13ed1ad04b5",
15
- "manifest_digest": "sha256:eee1260214de0cca784c9984158a69c1d687ba6912edff006b896a1aa536e2d4",
14
+ "integrity": "sha256:1ed6831f383cee2399b3c49b01378010ed40c65dce554cf50fc0a5d8ecac6a04",
15
+ "manifest_digest": "sha256:17f70fd4018068892a8067a3008855d2914f16728a90134328b5da4754429c11",
16
16
  "files": [
17
17
  {
18
18
  "path": "SKILL.md",
19
- "digest": "sha256:b0404c969051ad490e4ccfa49b44d99780bf4d052a5a31b2b252ec0463d49b78"
19
+ "digest": "sha256:d08738034dc6ed4fab857184ea92927a207a4c712be7626ae58ce3a0be1499fd"
20
20
  },
21
21
  {
22
22
  "path": "context-indexer.yaml",
23
- "digest": "sha256:eee1260214de0cca784c9984158a69c1d687ba6912edff006b896a1aa536e2d4"
23
+ "digest": "sha256:17f70fd4018068892a8067a3008855d2914f16728a90134328b5da4754429c11"
24
24
  },
25
25
  {
26
26
  "path": "references/composers/contracts-and-chains.md",
@@ -56,15 +56,15 @@
56
56
  },
57
57
  {
58
58
  "path": "references/indexer.md",
59
- "digest": "sha256:583997d7cc096ebccc3981f733608ccb553a3c6964747f95fd4d356ff08d758b"
59
+ "digest": "sha256:e5b13a60a58b49461ed49cf8abac0f24aa4d19a2df42181d7b045a9984d5aab0"
60
60
  },
61
61
  {
62
62
  "path": "references/metrics.md",
63
- "digest": "sha256:38de0a9ef59b70e252d446b55c87796a360047571ac725baed1a7afa2379cd07"
63
+ "digest": "sha256:4f32874ad81695b412f830f76c4f8bc7663a37e4d0c652fe24efebcffe7698bb"
64
64
  },
65
65
  {
66
66
  "path": "templates/adapter-integration.md",
67
- "digest": "sha256:f6eb18e62cea2edaf08d5babf10dd9c8c4cbbcde9d5002ad35b89a4a24b2fc93"
67
+ "digest": "sha256:be6aa650aad7f70f4bf924c64f4bc73fa28314d512245d61d159ffde6c29a91d"
68
68
  },
69
69
  {
70
70
  "path": "templates/api-service.md",
@@ -80,7 +80,7 @@
80
80
  },
81
81
  {
82
82
  "path": "templates/component-library.md",
83
- "digest": "sha256:aa21a8a0395c95e402ff58ae036c64a1cc9e6d223b676cfde50ac0556a4fb2de"
83
+ "digest": "sha256:53d53824b22c339ee2405d66fb406ed908930f5ced095e6bad69c97650a3afd5"
84
84
  },
85
85
  {
86
86
  "path": "templates/contract-source.md",
@@ -104,7 +104,7 @@
104
104
  },
105
105
  {
106
106
  "path": "templates/gateway-facade.md",
107
- "digest": "sha256:0fbfb5195dbb84f1833aee21947c0605a0a8d85b93d2fcde577dbf85cb5b92b1"
107
+ "digest": "sha256:6b5e7ea03ff3acf4d88879f835ff7c2c470fe6a0f2cb3641d46406b5fb4da544"
108
108
  },
109
109
  {
110
110
  "path": "templates/monorepo-container.md",
@@ -146,21 +146,21 @@
146
146
  },
147
147
  {
148
148
  "skill": "context-markdown-indexer",
149
- "version": "1.0.0",
149
+ "version": "1.1.1",
150
150
  "distribution": {
151
151
  "kind": "cli-bundled",
152
152
  "locator": "cli-bundled://context/context-markdown-indexer"
153
153
  },
154
- "integrity": "sha256:308c84e7ca62c87614eb8318939f7fee8ccd859907d63effd10b33247708bb48",
155
- "manifest_digest": "sha256:ef7b4649f39d1ac8d38413770012c73c9a54d63d120c9d2a5bbf7c68ff8c01bc",
154
+ "integrity": "sha256:082664b409f05861cf69c77f45de0cf9c3269522c949b1c1f5fb25d2e78d59b9",
155
+ "manifest_digest": "sha256:6ed1f921e340d1ba8876dec57da9a41308cb72bd12c7aacf24acd93c7dd59439",
156
156
  "files": [
157
157
  {
158
158
  "path": "SKILL.md",
159
- "digest": "sha256:1c6c261541fed808ff791b48324cb490f58dd1234deb09c7a43661564d6045b3"
159
+ "digest": "sha256:ed1684c9b2659ec5f42a3785803f6bf3fec3061cc5bc6f4ea69cc3b0a5a42b6e"
160
160
  },
161
161
  {
162
162
  "path": "context-indexer.yaml",
163
- "digest": "sha256:ef7b4649f39d1ac8d38413770012c73c9a54d63d120c9d2a5bbf7c68ff8c01bc"
163
+ "digest": "sha256:6ed1f921e340d1ba8876dec57da9a41308cb72bd12c7aacf24acd93c7dd59439"
164
164
  },
165
165
  {
166
166
  "path": "references/classification.md",
@@ -172,19 +172,19 @@
172
172
  },
173
173
  {
174
174
  "path": "references/indexer.md",
175
- "digest": "sha256:ed506c14b13a2855c47a7503df78dd5a9abbd55d3663584369b85f4cbba14c95"
175
+ "digest": "sha256:385700d8c016759527ef9b2a140b17c81fa136031e24f1ce56ff1f3c7fd73b5d"
176
176
  },
177
177
  {
178
178
  "path": "references/semantic-planning.md",
179
- "digest": "sha256:fd0b7cfe28c44a7cc2bfcf4fe575c8df595a9931fae06ece1d3a48f21c9ea2b2"
179
+ "digest": "sha256:0789c470aeb59797714ecc1349092cfd8aaf818fcf72b72208318ab15f73eee2"
180
180
  },
181
181
  {
182
182
  "path": "references/structure-and-artifacts.md",
183
- "digest": "sha256:c8a31e5ed4cad1369f3647e4eff796509db5a3609183ad7d63c215f0da9ab4c6"
183
+ "digest": "sha256:275078306c2dc03d2fafea2d61e1df9c7cb1107bdff9e7d223044fe4e551e72b"
184
184
  },
185
185
  {
186
186
  "path": "tests/fixtures/anonymous.json",
187
- "digest": "sha256:38c4cfe7c39f3d5358b265b39b2799219019ef1c94cc9961ef6a7b09250cbebe"
187
+ "digest": "sha256:4c1c43e41c9e24178ced63fede6fa5d0b04897e24cfc7cb7b54aaa314762bb3d"
188
188
  },
189
189
  {
190
190
  "path": "tests/fixtures/editorial.json",
@@ -196,11 +196,11 @@
196
196
  },
197
197
  {
198
198
  "path": "tests/fixtures/profiles.json",
199
- "digest": "sha256:c43fc25f7f00a662a1fd144623041be16a149778eb88064b497aef1690f33850"
199
+ "digest": "sha256:55fe69e5518d158c4a36fcf344eb98de85304c0e1452c95049819addedc6429f"
200
200
  },
201
201
  {
202
202
  "path": "tests/fixtures/routing.json",
203
- "digest": "sha256:85675d965ac67289672145e80f6cb54922eeddb5cc4b6d80b9e5ce0e5dcd8947"
203
+ "digest": "sha256:c879d226a2f20f8e68c83fe60fa81cb3ff88465b6c666b02bd835b68280981a0"
204
204
  }
205
205
  ]
206
206
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@c4a/context-cli",
3
- "version": "0.7.1",
3
+ "version": "0.7.5",
4
4
  "type": "module",
5
5
  "description": "Local runtime and Agent integration for traceable knowledge production",
6
6
  "license": "MIT",
@@ -24,7 +24,17 @@
24
24
  },
25
25
  "dependencies": {
26
26
  "@c4a/agent-graph": "0.3.0",
27
- "@c4a/context": "0.7.1",
27
+ "@c4a/context": "0.7.5",
28
+ "@c4a/extract": "0.7.5",
29
+ "@c4a/extract-contract": "0.7.5",
30
+ "@c4a/extract-go": "0.7.5",
31
+ "@c4a/extract-mdx": "0.7.5",
32
+ "@c4a/extract-proto": "0.7.5",
33
+ "@c4a/extract-rush": "0.7.5",
34
+ "@c4a/extract-sql": "0.7.5",
35
+ "@c4a/extract-style": "0.7.5",
36
+ "@c4a/extract-thrift": "0.7.5",
37
+ "@c4a/extract-ts": "0.7.5",
28
38
  "commander": "^11.0.0",
29
39
  "fast-xml-parser": "^5.10.1",
30
40
  "handlebars": "^4.7.8",
package/plugins/VERSION CHANGED
@@ -1 +1 @@
1
- 0.7.1
1
+ 0.7.5
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "c4a",
3
3
  "description": "Start or continue a project-local knowledge workspace through one graph-routed entry.",
4
- "version": "0.7.1",
4
+ "version": "0.7.5",
5
5
  "author": { "name": "c4a" },
6
6
  "license": "MIT",
7
7
  "keywords": ["context", "knowledge-base", "wiki", "claude-plugin", "c4a"]
@@ -41,11 +41,8 @@ managed work, or no further review already resolves this choice.
41
41
  Use the user's explicit language choice when present; otherwise pass `zh-CN`
42
42
  for a Chinese conversation and `en` for an English conversation. Pass
43
43
  `project-dir`, `--name`, `--dev`, or `--debug` only when the user explicitly
44
- requested that initialization choice. New workspaces enable conservative
45
- document compilation optimization by default. Pass `--no-optimize-docs` only
46
- when the user explicitly asks to disable it during initialization. Pass
47
- `--managed` only after the user explicitly authorizes fully managed operation
48
- in this conversation.
44
+ requested that initialization choice. Pass `--managed` only after the user
45
+ explicitly authorizes fully managed operation in this conversation.
49
46
 
50
47
  If the `context` process itself cannot start because the command is missing
51
48
  (`ENOENT`, or shell exit 127 explicitly identifying `context` as the missing
@@ -74,23 +71,18 @@ Execute only `next_action.command` returned by `context entry`:
74
71
  init`, enter the project root, read the generated `AGENTS.md`, and run this
75
72
  entry again.
76
73
 
77
- If the user explicitly asks to correct or revise an existing approved or built
78
- knowledge page, first let `context entry` relocate into the existing workspace
79
- and evaluate its current Route once. Resolve a blocking workspace diagnostic,
80
- evidence-maintenance action, or already-pending Review batch first; these may
81
- change the approved baseline. Before continuing unrelated capture, extraction,
82
- package configuration, or build work, start the correction with:
74
+ If the user asks to correct a current Candidate before approval, first let
75
+ `context entry` relocate into the workspace and evaluate its current Route.
76
+ Start the correction with:
83
77
 
84
78
  ```bash
85
- context revise "<the user's page title, approved path, ViewRef, or wording>" --format json
79
+ context revise "<candidate title, path, or id>" --instruction "<requested correction>" --format json
86
80
  ```
87
81
 
88
- When the target is unique, run the returned status command and follow
89
- `route.document-revision.requested`. When candidates are returned, select one
90
- only if the conversation identifies it uniquely; otherwise ask which page the
91
- user means. Never edit the approved base page or `dist/` for this operation.
92
- After the Route validates the revision, continue normally: Context will offer
93
- the package build when the correction makes its output stale.
82
+ When the target is unique, Context invalidates only its derived outputs and
83
+ reopens the owning Author workset. Run the returned status command and follow
84
+ the current Route. If the target is ambiguous, ask which Candidate the user
85
+ means. Never edit `knowledge/`, `dist/`, or create a side-channel revision page.
94
86
 
95
87
  ### Conversation modes
96
88
 
@@ -102,24 +94,6 @@ before workflow evaluation. Debugging records traces below
102
94
  `.tmp/context-runtime/debug/` but does not grant workflow authority or provide
103
95
  source evidence.
104
96
 
105
- Document optimization is enabled by default for newly initialized workspaces.
106
- It performs source-constrained editorial revision: the CLI identifies
107
- readability and knowledge-value signals, and the Agent may keep, repair,
108
- reshape, or safely omit content only inside its existing source Section. It
109
- must preserve facts, link targets, images, code, numbers, identifiers, and
110
- source evidence. Approved pages remain source-faithful; only changed full-page
111
- revisions are stored beside them as `knowledge/**/*__revision.md`. Default
112
- knowledge discovery excludes those reserved sidecars, and internal editorial
113
- audit state is not included in package output.
114
-
115
- For an existing workspace, respect its current `package.json` setting. Run
116
- `context optimize-docs enable` or `context optimize-docs disable` only when the
117
- user explicitly changes that preference. If initialization is required and the
118
- user opts out, pass `--no-optimize-docs` through `context entry`; otherwise let
119
- the default initialization command enable it.
120
- Follow the resulting Route instead of editing approved knowledge or package
121
- output by hand.
122
-
123
97
  For explicitly authorized fully managed operation, use:
124
98
 
125
99
  ```bash
@@ -139,13 +113,13 @@ that returned Route; never reconstruct a command from an earlier step.
139
113
 
140
114
  Code knowledge is published under `codeindex`. Context mechanically audits each
141
115
  module's input analysis, stable boundaries, facts, explanation, evidence scope,
142
- and page shape without producing a total score. In fully managed operation,
143
- follow returned repair actions automatically; after three failed revisions of
144
- the same module problem, stop at the one aggregated human-guidance Gate. If a
145
- legacy workspace returns `route.extract.codeindex-migration-required`, execute
146
- only its migration command; do not rename `codegraph` paths manually.
116
+ and page shape without producing a total score. Blocking mechanical failures
117
+ reopen the owning Author or Composer workset; advisory metrics remain warnings
118
+ and do not create a retry ledger or override Gate. If a legacy workspace returns
119
+ `route.extract.codeindex-migration-required`, execute only its migration
120
+ command; do not rename `codegraph` paths manually.
147
121
 
148
- ### Discover Indexer Providers before selection
122
+ ### Select Indexer Providers
149
123
 
150
124
  For `indexer-provider-required`, `indexer-provider-unavailable`,
151
125
  `indexer-customization-required`, `indexer-customization-invalid`, or
@@ -156,69 +130,40 @@ default, six-level customization ladder, upgrade conflict handling, debugging
156
130
  commands, and the exit condition for each level. Do not replace it with a
157
131
  remembered or host-specific workflow.
158
132
 
159
- When the current Route starts a new Code or Markdown indexing task, run this
160
- read-only command once before creating or changing any Provider registry entry:
161
-
162
- ```bash
163
- context indexer catalog --format json
164
- ```
165
-
166
- Report the returned CLI-bundled entry Skills together with every other Indexer
167
- Skill already visible through the current host. The conversational report must
168
- include each Skill name, readable exact version when available, and source type
169
- (CLI-bundled community, workspace, installed plugin, or authorized marketplace
170
- result). When the host already exposes an exact Skill root or `SKILL.md` path,
171
- read only its YAML frontmatter and sibling `context-indexer.yaml` during
172
- discovery. The manifest version is authoritative;
173
- `metadata.context-provider-version` is a readable copy that must match it. Do
174
- not load the Provider body or other guidance until the Route selects it. If the
175
- host exposes no readable root or exact version, report the version as
176
- unavailable rather than guessing it.
177
-
178
- Group observations with the same Skill name and exact version into one
179
- conversational item and list all observed source types on that item. An
180
- installed projection of an identical CLI-bundled identity is not a second
181
- Provider. Keep different versions separate. The route input still preserves
182
- each distinct source observation as its own `visible_skills` entry because
183
- `source_type` is singular; never use source count or discovery order as
184
- selection precedence. Do not search arbitrary directories, infer host cache
185
- paths, install a plugin, or query a marketplace unless the user separately
186
- authorizes it. Keep this discovery report only in the conversation: do not
187
- write it to `src/`, `package.json`, lifecycle state, receipts, audit output, or
188
- `dist/`. Do not repeat it during an unchanged task resume; repeat it only for a
189
- new indexing task, a changed host-visible Skill set, or an explicit diagnostic
190
- request.
191
-
192
- After the requirements are applied, author one
193
- `context.indexer.provider-route-input/v1` payload whose `registry` preserves
194
- the applied `requirements` block exactly and whose `visible_skills` contains
195
- only the just-reported path-free identities. Route it before any Host resolves
196
- or reads an external Provider:
197
-
198
- ```bash
199
- context indexer route-indexer-provider-selection --input <payload.yaml-or-json> --format json
200
- ```
201
-
202
- On `community-fallback-required`, retry with the applicable CLI-bundled profile
203
- and set `community_fallback_attempted: true`. Read-scope overlap is allowed, but
204
- an exact primary owner-cell conflict must be resolved explicitly; do not use
205
- array or discovery order as precedence. If fallback leaves a required owner
206
- cell uncovered, preserve the returned `capability_gap_proof`. Only the Route's
207
- following `propose-indexer-customization` Agent Action may turn that exact proof
208
- into a dependency-free minimal `extend` draft; do not weaken the requirement,
209
- write source, add dependencies, or claim the draft is applied.
210
-
211
- Only `selection-validation-required` returns a
212
- `selection_proposal_input`. Pass that exact object to:
213
-
214
- ```bash
215
- context indexer validate-indexer-selection-proposal --input <payload.yaml-or-json> --format json
216
- ```
217
-
218
- Use only the returned `next_provider_requests` for resolution. A successful
219
- static report does not authorize materialization, installation, execution, or
220
- writing the proposal into `src/indexers.yaml`; continue through the Route's
221
- resolver, staging, final validation, confirmation, and apply Actions.
133
+ When the current Route starts a new Code or Markdown indexing task, its
134
+ `configure-indexer-providers` Action input already contains the exact applied
135
+ requirements and CLI-bundled Provider catalog. Select applicable Providers from
136
+ the Skills already visible to the Host and that supplied catalog. Do not add a
137
+ catalog command, installation preflight, discovery report, or discovery-only
138
+ confirmation to the normal workflow. The main entry being visible is not proof
139
+ that every Provider is available; the CLI checks the selected distribution
140
+ when it is used and returns any missing/version-conflict recovery.
141
+
142
+ Use the supplied CLI-bundled identity for a selected shipped Provider, including
143
+ when the same Skill/version is also visible as an installed projection. Do not
144
+ resolve that copy through the Host or re-read its installed metadata. For a
145
+ relevant external Skill, read only the exact Host-exposed frontmatter and
146
+ sibling `context-indexer.yaml` needed for selection; do not guess a version or
147
+ scan caches. Different versions remain distinct. Read Provider guidance only
148
+ when selected. Discovery is not a durable workspace artifact.
149
+
150
+ Return only `stage: provider-selection`, the non-CLI
151
+ `host_visible_skills`, and the selected semantic `indexers` through the exact
152
+ `context action complete-current` command returned by the Route. The CLI owns
153
+ construction of the full registry payload, fallback/conflict checks, static
154
+ validation, Provider resolution and staging, final validation, and atomic
155
+ application of `src/indexers.yaml`. Do not call their low-level commands as a
156
+ second production workflow.
157
+
158
+ If a selected external Provider needs Host resolution, the next current Route
159
+ contains one `context.resolve-indexer-provider/v1` Host Action and its exact
160
+ request. Invoke that Host Action once, then submit
161
+ `stage: provider-resolution` with the returned Host result through the Route's
162
+ `complete-current` command. If the Bundle carries a non-allowlisted program,
163
+ the following current Route presents the existing program-execution Gate; wait
164
+ for its user/session-authority decision and submit that decision through
165
+ `complete-current`. A recovered `provider-finalization` Route consumes
166
+ only its fixed Action input; it must not resolve or install the Provider again.
222
167
 
223
168
  ### Follow the current Route
224
169
 
@@ -226,8 +171,12 @@ Treat `workflow.current` as the current-step authority:
226
171
 
227
172
  1. Read every `resources.required` item whose `read_state` is `read-required`.
228
173
  Read a returned `path` completely, or execute a returned resource `command`
229
- and read its complete output file. Materializing a resource is not reading
230
- it. Keep the merged receipts only in this conversation and submit them with
174
+ and read its complete output file. For a current Indexer Partition, Author,
175
+ Composer or structure-review Route, read the materialized files and then use
176
+ the Route's immediate completion command; do not create or submit a read
177
+ receipt. Other workflow resources may still require the returned receipt
178
+ command. Materializing a resource is not reading it. Keep those receipts only
179
+ in this conversation and submit them with
231
180
  the exact returned `context status --resource-receipts @<file>` command. Use
232
181
  `after_read_receipts` only after the full resource has been read. The exact
233
182
  `resources.after_read.command` already returns the re-evaluated
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "c4a",
3
- "version": "0.7.1",
3
+ "version": "0.7.5",
4
4
  "description": "Start or continue a project-local knowledge workspace through one graph-routed entry.",
5
5
  "author": { "name": "c4a" },
6
6
  "homepage": "https://github.com/context4ai/c4a",
@@ -10,7 +10,7 @@
10
10
  "skills": "./skills/",
11
11
  "interface": {
12
12
  "displayName": "C4A Context",
13
- "shortDescription": "Initialize and advance a local, source-linked project knowledge workspace.\nv0.7.1",
13
+ "shortDescription": "Initialize and advance a local, source-linked project knowledge workspace.\nv0.7.5",
14
14
  "longDescription": "Create a Context workspace and use agent-guided next steps to register sources, run extraction, review candidates, build package outputs, and verify health without silently mutating source repositories.",
15
15
  "developerName": "c4a",
16
16
  "category": "Productivity",
@@ -42,11 +42,8 @@ managed work, or no further review already resolves this choice.
42
42
  Use the user's explicit language choice when present; otherwise pass `zh-CN`
43
43
  for a Chinese conversation and `en` for an English conversation. Pass
44
44
  `project-dir`, `--name`, `--dev`, or `--debug` only when the user explicitly
45
- requested that initialization choice. New workspaces enable conservative
46
- document compilation optimization by default. Pass `--no-optimize-docs` only
47
- when the user explicitly asks to disable it during initialization. Pass
48
- `--managed` only after the user explicitly authorizes fully managed operation
49
- in this conversation.
45
+ requested that initialization choice. Pass `--managed` only after the user
46
+ explicitly authorizes fully managed operation in this conversation.
50
47
 
51
48
  If the `context` process itself cannot start because the command is missing
52
49
  (`ENOENT`, or shell exit 127 explicitly identifying `context` as the missing
@@ -75,23 +72,18 @@ Execute only `next_action.command` returned by `context entry`:
75
72
  init`, enter the project root, read the generated `AGENTS.md`, and run this
76
73
  entry again.
77
74
 
78
- If the user explicitly asks to correct or revise an existing approved or built
79
- knowledge page, first let `context entry` relocate into the existing workspace
80
- and evaluate its current Route once. Resolve a blocking workspace diagnostic,
81
- evidence-maintenance action, or already-pending Review batch first; these may
82
- change the approved baseline. Before continuing unrelated capture, extraction,
83
- package configuration, or build work, start the correction with:
75
+ If the user asks to correct a current Candidate before approval, first let
76
+ `context entry` relocate into the workspace and evaluate its current Route.
77
+ Start the correction with:
84
78
 
85
79
  ```bash
86
- context revise "<the user's page title, approved path, ViewRef, or wording>" --format json
80
+ context revise "<candidate title, path, or id>" --instruction "<requested correction>" --format json
87
81
  ```
88
82
 
89
- When the target is unique, run the returned status command and follow
90
- `route.document-revision.requested`. When candidates are returned, select one
91
- only if the conversation identifies it uniquely; otherwise ask which page the
92
- user means. Never edit the approved base page or `dist/` for this operation.
93
- After the Route validates the revision, continue normally: Context will offer
94
- the package build when the correction makes its output stale.
83
+ When the target is unique, Context invalidates only its derived outputs and
84
+ reopens the owning Author workset. Run the returned status command and follow
85
+ the current Route. If the target is ambiguous, ask which Candidate the user
86
+ means. Never edit `knowledge/`, `dist/`, or create a side-channel revision page.
95
87
 
96
88
  ### Conversation modes
97
89
 
@@ -103,24 +95,6 @@ before workflow evaluation. Debugging records traces below
103
95
  `.tmp/context-runtime/debug/` but does not grant workflow authority or provide
104
96
  source evidence.
105
97
 
106
- Document optimization is enabled by default for newly initialized workspaces.
107
- It performs source-constrained editorial revision: the CLI identifies
108
- readability and knowledge-value signals, and the Agent may keep, repair,
109
- reshape, or safely omit content only inside its existing source Section. It
110
- must preserve facts, link targets, images, code, numbers, identifiers, and
111
- source evidence. Approved pages remain source-faithful; only changed full-page
112
- revisions are stored beside them as `knowledge/**/*__revision.md`. Default
113
- knowledge discovery excludes those reserved sidecars, and internal editorial
114
- audit state is not included in package output.
115
-
116
- For an existing workspace, respect its current `package.json` setting. Run
117
- `context optimize-docs enable` or `context optimize-docs disable` only when the
118
- user explicitly changes that preference. If initialization is required and the
119
- user opts out, pass `--no-optimize-docs` through `context entry`; otherwise let
120
- the default initialization command enable it.
121
- Follow the resulting Route instead of editing approved knowledge or package
122
- output by hand.
123
-
124
98
  For explicitly authorized fully managed operation, use:
125
99
 
126
100
  ```bash
@@ -140,13 +114,13 @@ that returned Route; never reconstruct a command from an earlier step.
140
114
 
141
115
  Code knowledge is published under `codeindex`. Context mechanically audits each
142
116
  module's input analysis, stable boundaries, facts, explanation, evidence scope,
143
- and page shape without producing a total score. In fully managed operation,
144
- follow returned repair actions automatically; after three failed revisions of
145
- the same module problem, stop at the one aggregated human-guidance Gate. If a
146
- legacy workspace returns `route.extract.codeindex-migration-required`, execute
147
- only its migration command; do not rename `codegraph` paths manually.
117
+ and page shape without producing a total score. Blocking mechanical failures
118
+ reopen the owning Author or Composer workset; advisory metrics remain warnings
119
+ and do not create a retry ledger or override Gate. If a legacy workspace returns
120
+ `route.extract.codeindex-migration-required`, execute only its migration
121
+ command; do not rename `codegraph` paths manually.
148
122
 
149
- ### Discover Indexer Providers before selection
123
+ ### Select Indexer Providers
150
124
 
151
125
  For `indexer-provider-required`, `indexer-provider-unavailable`,
152
126
  `indexer-customization-required`, `indexer-customization-invalid`, or
@@ -157,69 +131,40 @@ default, six-level customization ladder, upgrade conflict handling, debugging
157
131
  commands, and the exit condition for each level. Do not replace it with a
158
132
  remembered or host-specific workflow.
159
133
 
160
- When the current Route starts a new Code or Markdown indexing task, run this
161
- read-only command once before creating or changing any Provider registry entry:
162
-
163
- ```bash
164
- context indexer catalog --format json
165
- ```
166
-
167
- Report the returned CLI-bundled entry Skills together with every other Indexer
168
- Skill already visible through the current host. The conversational report must
169
- include each Skill name, readable exact version when available, and source type
170
- (CLI-bundled community, workspace, installed plugin, or authorized marketplace
171
- result). When the host already exposes an exact Skill root or `SKILL.md` path,
172
- read only its YAML frontmatter and sibling `context-indexer.yaml` during
173
- discovery. The manifest version is authoritative;
174
- `metadata.context-provider-version` is a readable copy that must match it. Do
175
- not load the Provider body or other guidance until the Route selects it. If the
176
- host exposes no readable root or exact version, report the version as
177
- unavailable rather than guessing it.
178
-
179
- Group observations with the same Skill name and exact version into one
180
- conversational item and list all observed source types on that item. An
181
- installed projection of an identical CLI-bundled identity is not a second
182
- Provider. Keep different versions separate. The route input still preserves
183
- each distinct source observation as its own `visible_skills` entry because
184
- `source_type` is singular; never use source count or discovery order as
185
- selection precedence. Do not search arbitrary directories, infer host cache
186
- paths, install a plugin, or query a marketplace unless the user separately
187
- authorizes it. Keep this discovery report only in the conversation: do not
188
- write it to `src/`, `package.json`, lifecycle state, receipts, audit output, or
189
- `dist/`. Do not repeat it during an unchanged task resume; repeat it only for a
190
- new indexing task, a changed host-visible Skill set, or an explicit diagnostic
191
- request.
192
-
193
- After the requirements are applied, author one
194
- `context.indexer.provider-route-input/v1` payload whose `registry` preserves
195
- the applied `requirements` block exactly and whose `visible_skills` contains
196
- only the just-reported path-free identities. Route it before any Host resolves
197
- or reads an external Provider:
198
-
199
- ```bash
200
- context indexer route-indexer-provider-selection --input <payload.yaml-or-json> --format json
201
- ```
202
-
203
- On `community-fallback-required`, retry with the applicable CLI-bundled profile
204
- and set `community_fallback_attempted: true`. Read-scope overlap is allowed, but
205
- an exact primary owner-cell conflict must be resolved explicitly; do not use
206
- array or discovery order as precedence. If fallback leaves a required owner
207
- cell uncovered, preserve the returned `capability_gap_proof`. Only the Route's
208
- following `propose-indexer-customization` Agent Action may turn that exact proof
209
- into a dependency-free minimal `extend` draft; do not weaken the requirement,
210
- write source, add dependencies, or claim the draft is applied.
211
-
212
- Only `selection-validation-required` returns a
213
- `selection_proposal_input`. Pass that exact object to:
214
-
215
- ```bash
216
- context indexer validate-indexer-selection-proposal --input <payload.yaml-or-json> --format json
217
- ```
218
-
219
- Use only the returned `next_provider_requests` for resolution. A successful
220
- static report does not authorize materialization, installation, execution, or
221
- writing the proposal into `src/indexers.yaml`; continue through the Route's
222
- resolver, staging, final validation, confirmation, and apply Actions.
134
+ When the current Route starts a new Code or Markdown indexing task, its
135
+ `configure-indexer-providers` Action input already contains the exact applied
136
+ requirements and CLI-bundled Provider catalog. Select applicable Providers from
137
+ the Skills already visible to the Host and that supplied catalog. Do not add a
138
+ catalog command, installation preflight, discovery report, or discovery-only
139
+ confirmation to the normal workflow. The main entry being visible is not proof
140
+ that every Provider is available; the CLI checks the selected distribution
141
+ when it is used and returns any missing/version-conflict recovery.
142
+
143
+ Use the supplied CLI-bundled identity for a selected shipped Provider, including
144
+ when the same Skill/version is also visible as an installed projection. Do not
145
+ resolve that copy through the Host or re-read its installed metadata. For a
146
+ relevant external Skill, read only the exact Host-exposed frontmatter and
147
+ sibling `context-indexer.yaml` needed for selection; do not guess a version or
148
+ scan caches. Different versions remain distinct. Read Provider guidance only
149
+ when selected. Discovery is not a durable workspace artifact.
150
+
151
+ Return only `stage: provider-selection`, the non-CLI
152
+ `host_visible_skills`, and the selected semantic `indexers` through the exact
153
+ `context action complete-current` command returned by the Route. The CLI owns
154
+ construction of the full registry payload, fallback/conflict checks, static
155
+ validation, Provider resolution and staging, final validation, and atomic
156
+ application of `src/indexers.yaml`. Do not call their low-level commands as a
157
+ second production workflow.
158
+
159
+ If a selected external Provider needs Host resolution, the next current Route
160
+ contains one `context.resolve-indexer-provider/v1` Host Action and its exact
161
+ request. Invoke that Host Action once, then submit
162
+ `stage: provider-resolution` with the returned Host result through the Route's
163
+ `complete-current` command. If the Bundle carries a non-allowlisted program,
164
+ the following current Route presents the existing program-execution Gate; wait
165
+ for its user/session-authority decision and submit that decision through
166
+ `complete-current`. A recovered `provider-finalization` Route consumes
167
+ only its fixed Action input; it must not resolve or install the Provider again.
223
168
 
224
169
  ### Follow the current Route
225
170
 
@@ -227,8 +172,12 @@ Treat `workflow.current` as the current-step authority:
227
172
 
228
173
  1. Read every `resources.required` item whose `read_state` is `read-required`.
229
174
  Read a returned `path` completely, or execute a returned resource `command`
230
- and read its complete output file. Materializing a resource is not reading
231
- it. Keep the merged receipts only in this conversation and submit them with
175
+ and read its complete output file. For a current Indexer Partition, Author,
176
+ Composer or structure-review Route, read the materialized files and then use
177
+ the Route's immediate completion command; do not create or submit a read
178
+ receipt. Other workflow resources may still require the returned receipt
179
+ command. Materializing a resource is not reading it. Keep those receipts only
180
+ in this conversation and submit them with
232
181
  the exact returned `context status --resource-receipts @<file>` command. Use
233
182
  `after_read_receipts` only after the full resource has been read. The exact
234
183
  `resources.after_read.command` already returns the re-evaluated