@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.
- package/README.md +18 -39
- package/README.zh-CN.md +13 -27
- package/cli.js +64945 -81995
- package/indexers/bundles/context-code-indexer/SKILL.md +30 -3
- package/indexers/bundles/context-code-indexer/context-indexer.yaml +3 -8
- package/indexers/bundles/context-code-indexer/references/indexer.md +110 -7
- package/indexers/bundles/context-code-indexer/references/metrics.md +143 -37
- package/indexers/bundles/context-code-indexer/templates/adapter-integration.md +2 -2
- package/indexers/bundles/context-code-indexer/templates/component-library.md +8 -0
- package/indexers/bundles/context-code-indexer/templates/gateway-facade.md +16 -0
- package/indexers/bundles/context-markdown-indexer/SKILL.md +13 -3
- package/indexers/bundles/context-markdown-indexer/context-indexer.yaml +20 -7
- package/indexers/bundles/context-markdown-indexer/references/indexer.md +33 -4
- package/indexers/bundles/context-markdown-indexer/references/semantic-planning.md +30 -14
- package/indexers/bundles/context-markdown-indexer/references/structure-and-artifacts.md +6 -0
- package/indexers/bundles/context-markdown-indexer/tests/fixtures/anonymous.json +1 -1
- package/indexers/bundles/context-markdown-indexer/tests/fixtures/profiles.json +13 -13
- package/indexers/bundles/context-markdown-indexer/tests/fixtures/routing.json +122 -0
- package/indexers/contracts/operator-contract.json +2 -2
- package/indexers/contracts/profile-contract.json +3819 -454
- package/indexers/release-manifest.json +22 -22
- package/package.json +12 -2
- package/plugins/VERSION +1 -1
- package/plugins/claude/.claude-plugin/plugin.json +1 -1
- package/plugins/claude/commands/context.md +56 -107
- package/plugins/codex/.codex-plugin/plugin.json +2 -2
- package/plugins/codex/skills/context/SKILL.md +56 -107
- package/plugins/cursor/.cursor-plugin/plugin.json +1 -1
- package/plugins/cursor/commands/c4a-context.md +56 -107
- package/plugins/skills/context/SKILL.md +56 -107
- package/plugins/skills/context-code-indexer/SKILL.md +30 -3
- package/plugins/skills/context-code-indexer/context-indexer.yaml +3 -8
- package/plugins/skills/context-code-indexer/references/indexer.md +110 -7
- package/plugins/skills/context-code-indexer/references/metrics.md +143 -37
- package/plugins/skills/context-code-indexer/templates/adapter-integration.md +2 -2
- package/plugins/skills/context-code-indexer/templates/component-library.md +8 -0
- package/plugins/skills/context-code-indexer/templates/gateway-facade.md +16 -0
- package/plugins/skills/context-markdown-indexer/SKILL.md +13 -3
- package/plugins/skills/context-markdown-indexer/context-indexer.yaml +20 -7
- package/plugins/skills/context-markdown-indexer/references/indexer.md +33 -4
- package/plugins/skills/context-markdown-indexer/references/semantic-planning.md +30 -14
- package/plugins/skills/context-markdown-indexer/references/structure-and-artifacts.md +6 -0
- package/plugins/skills/context-markdown-indexer/tests/fixtures/anonymous.json +1 -1
- package/plugins/skills/context-markdown-indexer/tests/fixtures/profiles.json +13 -13
- package/plugins/skills/context-markdown-indexer/tests/fixtures/routing.json +122 -0
- package/providers/context/actions/advance-current-indexer-lifecycle.yaml +6 -0
- package/providers/context/actions/authorize-current-indexer-provider-program.yaml +6 -0
- package/providers/context/actions/configure-indexer-providers.yaml +1 -1
- package/providers/context/actions/finalize-current-indexer-provider-selection.yaml +5 -0
- package/providers/context/actions/materialize-indexer-workset-view.yaml +7 -0
- package/providers/context/actions/resolve-current-indexer-gate.yaml +6 -0
- package/providers/context/actions/resolve-current-indexer-provider.yaml +6 -0
- package/providers/context/actions/run-indexer-lifecycle.yaml +0 -1
- package/providers/context/actions/run-indexer-post-author-composer.yaml +2 -2
- package/providers/context/codes.yaml +8 -22
- package/providers/context/graphs/indexer.yaml +95 -564
- package/providers/context/graphs/workspace.yaml +5 -43
- package/providers/context/manifest.json +119 -678
- package/providers/context/provider.yaml +1 -1
- package/providers/context/resources/dialogue/human-gates.md +3 -3
- package/providers/context/resources/dialogue/knowledge-review.md +6 -3
- package/providers/context/resources/manuals/reference/package-templates.md +2 -3
- package/providers/context/resources/manuals/reference/project-api.md +52 -986
- package/providers/context/resources/procedures/close-and-build.md +8 -23
- package/providers/context/resources/procedures/knowledge-review.md +17 -5
- package/providers/context/resources/procedures/source-capture-detailed.md +6 -8
- package/providers/context/resources/views/authorized-indexer-workset-view.yaml +15 -0
- package/providers/context/resources/views/resolved-indexer-instructions.yaml +2 -4
- package/providers/context/schemas/indexer-agent-step-input.schema.json +71 -21
- package/providers/context/schemas/indexer-agent-step-result.schema.json +385 -32
- package/providers/context/schemas/indexer-authorized-workset-view.schema.json +65 -0
- package/providers/context/schemas/indexer-main-lifecycle-input.schema.json +13 -20
- package/providers/context/schemas/indexer-main-lifecycle-output.schema.json +17 -2
- package/providers/context/schemas/indexer-materialize-request.schema.json +4 -8
- package/providers/context/schemas/indexer-materialized-resource.schema.json +8 -1
- package/providers/context/schemas/indexer-overlay-question-proposal-input.schema.json +51 -2
- package/providers/context/schemas/indexer-workset-view-materialization-request.schema.json +35 -0
- package/providers/context/skills/authorize-current-indexer-provider-program/SKILL.md +20 -0
- package/providers/context/skills/configure-indexer-providers/SKILL.md +47 -33
- package/providers/context/skills/resolve-current-indexer-gate/SKILL.md +27 -0
- package/providers/context/skills/resolve-current-indexer-provider/SKILL.md +20 -0
- package/providers/context/skills/run-indexer-agent-step/SKILL.md +49 -10
- package/providers/context/skills/run-indexer-lifecycle/SKILL.md +19 -13
- package/providers/context/skills/run-indexer-post-author-composer/SKILL.md +52 -11
- package/docs/document-optimization.md +0 -82
- package/docs/document-optimization.zh-CN.md +0 -70
- package/indexers/capability-manifest.json +0 -35
- package/indexers/contracts/hard-rule-conformance.json +0 -2644
- package/providers/context/actions/accept-main-index-run.yaml +0 -7
- package/providers/context/actions/accept-material-answer-run.yaml +0 -7
- package/providers/context/actions/accept-post-author-composer-run.yaml +0 -7
- package/providers/context/actions/actualize-material-answer-bindings.yaml +0 -8
- package/providers/context/actions/audit-material-gap-state.yaml +0 -8
- package/providers/context/actions/audit-projected-artifact-fan-out.yaml +0 -8
- package/providers/context/actions/build-main-index-author-worksets.yaml +0 -7
- package/providers/context/actions/build-main-index-catalog-fallback.yaml +0 -7
- package/providers/context/actions/build-main-index-partition-worksets.yaml +0 -7
- package/providers/context/actions/build-material-question-workset.yaml +0 -7
- package/providers/context/actions/build-post-author-composer-worksets.yaml +0 -7
- package/providers/context/actions/build-question-target-inventory.yaml +0 -7
- package/providers/context/actions/build-subject-catalog.yaml +0 -7
- package/providers/context/actions/build-target-resolution-views.yaml +0 -7
- package/providers/context/actions/checkpoint-material-answer-review.yaml +0 -8
- package/providers/context/actions/checkpoint-material-gaps.yaml +0 -8
- package/providers/context/actions/close-indexer-approved-knowledge.yaml +0 -8
- package/providers/context/actions/compose-indexer-post-author-fragments.yaml +0 -7
- package/providers/context/actions/converge-main-index-partition-run.yaml +0 -7
- package/providers/context/actions/evaluate-material-gaps.yaml +0 -8
- package/providers/context/actions/fail-main-index-run.yaml +0 -7
- package/providers/context/actions/fail-material-answer-run.yaml +0 -7
- package/providers/context/actions/fail-post-author-composer-run.yaml +0 -7
- package/providers/context/actions/inspect-index-candidate-review-readiness.yaml +0 -8
- package/providers/context/actions/inspect-index-profile-failure.yaml +0 -7
- package/providers/context/actions/inspect-material-answer-review.yaml +0 -8
- package/providers/context/actions/observe-main-index-run-ledger.yaml +0 -7
- package/providers/context/actions/observe-material-answer-runs.yaml +0 -7
- package/providers/context/actions/observe-post-author-composer-worksets.yaml +0 -7
- package/providers/context/actions/override-index-profile-audit.yaml +0 -7
- package/providers/context/actions/prepare-main-index-run-ledger.yaml +0 -7
- package/providers/context/actions/prepare-material-answer-runs.yaml +0 -7
- package/providers/context/actions/reconcile-indexer-results.yaml +0 -7
- package/providers/context/actions/reconcile-review-identities.yaml +0 -5
- package/providers/context/actions/record-index-profile-revision.yaml +0 -7
- package/providers/context/actions/report-index-profile-failure.yaml +0 -7
- package/providers/context/actions/resolve-effective-composers.yaml +0 -7
- package/providers/context/actions/review-material-answer-candidate.yaml +0 -8
- package/providers/context/actions/revise-document.yaml +0 -5
- package/providers/context/actions/revise-index-output.yaml +0 -7
- package/providers/context/actions/run-material-answer-indexers.yaml +0 -7
- package/providers/context/actions/start-main-index-run.yaml +0 -7
- package/providers/context/actions/start-material-answer-run.yaml +0 -7
- package/providers/context/actions/start-post-author-composer-run.yaml +0 -7
- package/providers/context/resources/procedures/document-revision.md +0 -36
- package/providers/context/resources/views/document-optimization-current.yaml +0 -6
- package/providers/context/schemas/indexer-candidate-review-readiness-input.schema.json +0 -46
- package/providers/context/schemas/indexer-candidate-review-readiness-output.schema.json +0 -104
- package/providers/context/schemas/indexer-lifecycle-continuation.schema.json +0 -15
- package/providers/context/schemas/indexer-material-answer-lifecycle-input.schema.json +0 -90
- package/providers/context/schemas/indexer-material-answer-lifecycle-output.schema.json +0 -80
- package/providers/context/schemas/indexer-material-answer-review-inspection-input.schema.json +0 -32
- package/providers/context/schemas/indexer-material-answer-review-inspection-output.schema.json +0 -32
- package/providers/context/schemas/indexer-material-answer-review-resolution-input.schema.json +0 -19
- package/providers/context/schemas/indexer-material-answer-review-resolution-output.schema.json +0 -87
- package/providers/context/schemas/indexer-material-gap-lifecycle-input.schema.json +0 -86
- package/providers/context/schemas/indexer-material-gap-lifecycle-output.schema.json +0 -19
- package/providers/context/schemas/indexer-post-author-fragment-request.schema.json +0 -26
- package/providers/context/schemas/indexer-post-author-fragment-result.schema.json +0 -18
- package/providers/context/schemas/indexer-post-author-lifecycle-input.schema.json +0 -94
- package/providers/context/schemas/indexer-post-author-lifecycle-output.schema.json +0 -72
- package/providers/context/schemas/indexer-profile-failure-inspection-input.schema.json +0 -13
- package/providers/context/schemas/indexer-profile-failure-inspection-result.schema.json +0 -19
- package/providers/context/schemas/indexer-profile-failure-report-input.schema.json +0 -22
- package/providers/context/schemas/indexer-profile-failure-report-result.schema.json +0 -49
- package/providers/context/schemas/indexer-profile-override-decision.schema.json +0 -20
- package/providers/context/schemas/indexer-profile-override-result.schema.json +0 -49
- package/providers/context/schemas/indexer-profile-revision-agent-input.schema.json +0 -18
- package/providers/context/schemas/indexer-profile-revision-record-input.schema.json +0 -31
- package/providers/context/schemas/indexer-profile-revision-record-result.schema.json +0 -45
- package/providers/context/schemas/indexer-result-reconciliation-input.schema.json +0 -59
- package/providers/context/schemas/indexer-result-reconciliation-output.schema.json +0 -43
- 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.
|
|
4
|
+
"version": "0.7.5",
|
|
5
5
|
"issuer": "context4ai/context",
|
|
6
6
|
"bundles": [
|
|
7
7
|
{
|
|
8
8
|
"skill": "context-code-indexer",
|
|
9
|
-
"version": "1.
|
|
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:
|
|
15
|
-
"manifest_digest": "sha256:
|
|
14
|
+
"integrity": "sha256:1ed6831f383cee2399b3c49b01378010ed40c65dce554cf50fc0a5d8ecac6a04",
|
|
15
|
+
"manifest_digest": "sha256:17f70fd4018068892a8067a3008855d2914f16728a90134328b5da4754429c11",
|
|
16
16
|
"files": [
|
|
17
17
|
{
|
|
18
18
|
"path": "SKILL.md",
|
|
19
|
-
"digest": "sha256:
|
|
19
|
+
"digest": "sha256:d08738034dc6ed4fab857184ea92927a207a4c712be7626ae58ce3a0be1499fd"
|
|
20
20
|
},
|
|
21
21
|
{
|
|
22
22
|
"path": "context-indexer.yaml",
|
|
23
|
-
"digest": "sha256:
|
|
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:
|
|
59
|
+
"digest": "sha256:e5b13a60a58b49461ed49cf8abac0f24aa4d19a2df42181d7b045a9984d5aab0"
|
|
60
60
|
},
|
|
61
61
|
{
|
|
62
62
|
"path": "references/metrics.md",
|
|
63
|
-
"digest": "sha256:
|
|
63
|
+
"digest": "sha256:4f32874ad81695b412f830f76c4f8bc7663a37e4d0c652fe24efebcffe7698bb"
|
|
64
64
|
},
|
|
65
65
|
{
|
|
66
66
|
"path": "templates/adapter-integration.md",
|
|
67
|
-
"digest": "sha256:
|
|
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:
|
|
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:
|
|
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.
|
|
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:
|
|
155
|
-
"manifest_digest": "sha256:
|
|
154
|
+
"integrity": "sha256:082664b409f05861cf69c77f45de0cf9c3269522c949b1c1f5fb25d2e78d59b9",
|
|
155
|
+
"manifest_digest": "sha256:6ed1f921e340d1ba8876dec57da9a41308cb72bd12c7aacf24acd93c7dd59439",
|
|
156
156
|
"files": [
|
|
157
157
|
{
|
|
158
158
|
"path": "SKILL.md",
|
|
159
|
-
"digest": "sha256:
|
|
159
|
+
"digest": "sha256:ed1684c9b2659ec5f42a3785803f6bf3fec3061cc5bc6f4ea69cc3b0a5a42b6e"
|
|
160
160
|
},
|
|
161
161
|
{
|
|
162
162
|
"path": "context-indexer.yaml",
|
|
163
|
-
"digest": "sha256:
|
|
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:
|
|
175
|
+
"digest": "sha256:385700d8c016759527ef9b2a140b17c81fa136031e24f1ce56ff1f3c7fd73b5d"
|
|
176
176
|
},
|
|
177
177
|
{
|
|
178
178
|
"path": "references/semantic-planning.md",
|
|
179
|
-
"digest": "sha256:
|
|
179
|
+
"digest": "sha256:0789c470aeb59797714ecc1349092cfd8aaf818fcf72b72208318ab15f73eee2"
|
|
180
180
|
},
|
|
181
181
|
{
|
|
182
182
|
"path": "references/structure-and-artifacts.md",
|
|
183
|
-
"digest": "sha256:
|
|
183
|
+
"digest": "sha256:275078306c2dc03d2fafea2d61e1df9c7cb1107bdff9e7d223044fe4e551e72b"
|
|
184
184
|
},
|
|
185
185
|
{
|
|
186
186
|
"path": "tests/fixtures/anonymous.json",
|
|
187
|
-
"digest": "sha256:
|
|
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:
|
|
199
|
+
"digest": "sha256:55fe69e5518d158c4a36fcf344eb98de85304c0e1452c95049819addedc6429f"
|
|
200
200
|
},
|
|
201
201
|
{
|
|
202
202
|
"path": "tests/fixtures/routing.json",
|
|
203
|
-
"digest": "sha256:
|
|
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.
|
|
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.
|
|
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
|
+
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.
|
|
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.
|
|
45
|
-
|
|
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
|
|
78
|
-
|
|
79
|
-
|
|
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 "<
|
|
79
|
+
context revise "<candidate title, path, or id>" --instruction "<requested correction>" --format json
|
|
86
80
|
```
|
|
87
81
|
|
|
88
|
-
When the target is unique,
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
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.
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
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
|
-
###
|
|
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,
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
read only
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
`
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
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.
|
|
230
|
-
|
|
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.
|
|
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.
|
|
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.
|
|
46
|
-
|
|
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
|
|
79
|
-
|
|
80
|
-
|
|
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 "<
|
|
80
|
+
context revise "<candidate title, path, or id>" --instruction "<requested correction>" --format json
|
|
87
81
|
```
|
|
88
82
|
|
|
89
|
-
When the target is unique,
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
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.
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
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
|
-
###
|
|
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,
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
read only
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
`
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
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.
|
|
231
|
-
|
|
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
|