@c4a/context-cli 0.7.1 → 0.7.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +18 -39
- package/README.zh-CN.md +13 -27
- package/cli.js +59797 -81281
- 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 +44 -85
- package/plugins/codex/.codex-plugin/plugin.json +2 -2
- package/plugins/codex/skills/context/SKILL.md +44 -85
- package/plugins/cursor/.cursor-plugin/plugin.json +1 -1
- package/plugins/cursor/commands/c4a-context.md +44 -85
- package/plugins/skills/context/SKILL.md +44 -85
- 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/configure-indexer-providers.yaml +1 -1
- package/providers/context/actions/materialize-indexer-workset-view.yaml +7 -0
- package/providers/context/actions/run-indexer-post-author-composer.yaml +1 -1
- package/providers/context/codes.yaml +6 -22
- package/providers/context/graphs/indexer.yaml +73 -564
- package/providers/context/graphs/workspace.yaml +5 -44
- package/providers/context/manifest.json +77 -666
- package/providers/context/provider.yaml +1 -1
- package/providers/context/resources/dialogue/human-gates.md +3 -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 +13 -4
- 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/schemas/indexer-agent-step-input.schema.json +2 -2
- package/providers/context/schemas/indexer-agent-step-result.schema.json +298 -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-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 +32 -0
- package/providers/context/skills/configure-indexer-providers/SKILL.md +40 -27
- package/providers/context/skills/run-indexer-agent-step/SKILL.md +34 -8
- package/providers/context/skills/run-indexer-lifecycle/SKILL.md +5 -4
- package/providers/context/skills/run-indexer-post-author-composer/SKILL.md +38 -9
- 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-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-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.4",
|
|
5
5
|
"issuer": "context4ai/context",
|
|
6
6
|
"bundles": [
|
|
7
7
|
{
|
|
8
8
|
"skill": "context-code-indexer",
|
|
9
|
-
"version": "1.
|
|
9
|
+
"version": "1.1.1",
|
|
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:80c85d8cb10af8e65a85cc22d6102ccafe1fe661696c856ffafd4ee0c42aa6d1",
|
|
15
|
+
"manifest_digest": "sha256:69cc16d6e680b840879bb20570e56e64b38a5d83755a5f7996a718c03a62ef66",
|
|
16
16
|
"files": [
|
|
17
17
|
{
|
|
18
18
|
"path": "SKILL.md",
|
|
19
|
-
"digest": "sha256:
|
|
19
|
+
"digest": "sha256:9f844460d49494bcb708162ddd983b36908305836c7015d46803e6bfedd6e70f"
|
|
20
20
|
},
|
|
21
21
|
{
|
|
22
22
|
"path": "context-indexer.yaml",
|
|
23
|
-
"digest": "sha256:
|
|
23
|
+
"digest": "sha256:69cc16d6e680b840879bb20570e56e64b38a5d83755a5f7996a718c03a62ef66"
|
|
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.0",
|
|
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:58104934dad8aaa934c45bac646dfd1e8ec952eb00aadb44fcf84af1d620638f",
|
|
155
|
+
"manifest_digest": "sha256:7e2b153d37fa3c4b7c916b3efff95b0fd1c489a50ba1ffab7c80bf43fb4e43f5",
|
|
156
156
|
"files": [
|
|
157
157
|
{
|
|
158
158
|
"path": "SKILL.md",
|
|
159
|
-
"digest": "sha256:
|
|
159
|
+
"digest": "sha256:e4959961af57d30d8b4468e997a5d64eb3fb98e4c7be8884a217b65df24709e8"
|
|
160
160
|
},
|
|
161
161
|
{
|
|
162
162
|
"path": "context-indexer.yaml",
|
|
163
|
-
"digest": "sha256:
|
|
163
|
+
"digest": "sha256:7e2b153d37fa3c4b7c916b3efff95b0fd1c489a50ba1ffab7c80bf43fb4e43f5"
|
|
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.4",
|
|
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.4",
|
|
28
|
+
"@c4a/extract": "0.7.4",
|
|
29
|
+
"@c4a/extract-contract": "0.7.4",
|
|
30
|
+
"@c4a/extract-go": "0.7.4",
|
|
31
|
+
"@c4a/extract-mdx": "0.7.4",
|
|
32
|
+
"@c4a/extract-proto": "0.7.4",
|
|
33
|
+
"@c4a/extract-rush": "0.7.4",
|
|
34
|
+
"@c4a/extract-sql": "0.7.4",
|
|
35
|
+
"@c4a/extract-style": "0.7.4",
|
|
36
|
+
"@c4a/extract-thrift": "0.7.4",
|
|
37
|
+
"@c4a/extract-ts": "0.7.4",
|
|
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.4
|
|
@@ -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.4",
|
|
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,11 +113,11 @@ 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
|
### Discover Indexer Providers before selection
|
|
149
123
|
|
|
@@ -156,15 +130,11 @@ 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
|
-
Report the returned CLI-bundled entry Skills together with every other Indexer
|
|
167
|
-
Skill already visible through the current host. The conversational report must
|
|
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. Report those bundled entries
|
|
136
|
+
together with every other Indexer Skill already visible through the current
|
|
137
|
+
host. The conversational report must
|
|
168
138
|
include each Skill name, readable exact version when available, and source type
|
|
169
139
|
(CLI-bundled community, workspace, installed plugin, or authorized marketplace
|
|
170
140
|
result). When the host already exposes an exact Skill root or `SKILL.md` path,
|
|
@@ -178,9 +148,7 @@ unavailable rather than guessing it.
|
|
|
178
148
|
Group observations with the same Skill name and exact version into one
|
|
179
149
|
conversational item and list all observed source types on that item. An
|
|
180
150
|
installed projection of an identical CLI-bundled identity is not a second
|
|
181
|
-
Provider. Keep different versions separate
|
|
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
|
|
151
|
+
Provider. Keep different versions separate; never use source count or discovery order as
|
|
184
152
|
selection precedence. Do not search arbitrary directories, infer host cache
|
|
185
153
|
paths, install a plugin, or query a marketplace unless the user separately
|
|
186
154
|
authorizes it. Keep this discovery report only in the conversation: do not
|
|
@@ -189,36 +157,23 @@ write it to `src/`, `package.json`, lifecycle state, receipts, audit output, or
|
|
|
189
157
|
new indexing task, a changed host-visible Skill set, or an explicit diagnostic
|
|
190
158
|
request.
|
|
191
159
|
|
|
192
|
-
|
|
193
|
-
`
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
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.
|
|
160
|
+
Return only `stage: provider-selection`, the non-CLI
|
|
161
|
+
`host_visible_skills`, and the selected semantic `indexers` through the exact
|
|
162
|
+
`context action complete-current` command returned by the Route. The CLI owns
|
|
163
|
+
construction of the full registry payload, fallback/conflict checks, static
|
|
164
|
+
validation, Provider resolution and staging, final validation, and atomic
|
|
165
|
+
application of `src/indexers.yaml`. Do not call their low-level commands as a
|
|
166
|
+
second production workflow.
|
|
167
|
+
|
|
168
|
+
If a selected external Provider needs Host resolution, the next current Route
|
|
169
|
+
contains one `context.resolve-indexer-provider/v1` Host Action and its exact
|
|
170
|
+
request. Invoke that Host Action once, then submit
|
|
171
|
+
`stage: provider-resolution` with the returned Host result through the Route's
|
|
172
|
+
`complete-current` command. If the Bundle carries a non-allowlisted program,
|
|
173
|
+
the following current Route presents the existing program-execution Gate; wait
|
|
174
|
+
for its user/session-authority decision and submit that decision through
|
|
175
|
+
`complete-current`. A recovered `provider-finalization` Route consumes
|
|
176
|
+
only its fixed Action input; it must not resolve or install the Provider again.
|
|
222
177
|
|
|
223
178
|
### Follow the current Route
|
|
224
179
|
|
|
@@ -226,8 +181,12 @@ Treat `workflow.current` as the current-step authority:
|
|
|
226
181
|
|
|
227
182
|
1. Read every `resources.required` item whose `read_state` is `read-required`.
|
|
228
183
|
Read a returned `path` completely, or execute a returned resource `command`
|
|
229
|
-
and read its complete output file.
|
|
230
|
-
|
|
184
|
+
and read its complete output file. For a current Indexer Partition, Author,
|
|
185
|
+
Composer or structure-review Route, read the materialized files and then use
|
|
186
|
+
the Route's immediate completion command; do not create or submit a read
|
|
187
|
+
receipt. Other workflow resources may still require the returned receipt
|
|
188
|
+
command. Materializing a resource is not reading it. Keep those receipts only
|
|
189
|
+
in this conversation and submit them with
|
|
231
190
|
the exact returned `context status --resource-receipts @<file>` command. Use
|
|
232
191
|
`after_read_receipts` only after the full resource has been read. The exact
|
|
233
192
|
`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.4",
|
|
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.4",
|
|
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,11 +114,11 @@ 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
|
### Discover Indexer Providers before selection
|
|
150
124
|
|
|
@@ -157,15 +131,11 @@ 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
|
-
Report the returned CLI-bundled entry Skills together with every other Indexer
|
|
168
|
-
Skill already visible through the current host. The conversational report must
|
|
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. Report those bundled entries
|
|
137
|
+
together with every other Indexer Skill already visible through the current
|
|
138
|
+
host. The conversational report must
|
|
169
139
|
include each Skill name, readable exact version when available, and source type
|
|
170
140
|
(CLI-bundled community, workspace, installed plugin, or authorized marketplace
|
|
171
141
|
result). When the host already exposes an exact Skill root or `SKILL.md` path,
|
|
@@ -179,9 +149,7 @@ unavailable rather than guessing it.
|
|
|
179
149
|
Group observations with the same Skill name and exact version into one
|
|
180
150
|
conversational item and list all observed source types on that item. An
|
|
181
151
|
installed projection of an identical CLI-bundled identity is not a second
|
|
182
|
-
Provider. Keep different versions separate
|
|
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
|
|
152
|
+
Provider. Keep different versions separate; never use source count or discovery order as
|
|
185
153
|
selection precedence. Do not search arbitrary directories, infer host cache
|
|
186
154
|
paths, install a plugin, or query a marketplace unless the user separately
|
|
187
155
|
authorizes it. Keep this discovery report only in the conversation: do not
|
|
@@ -190,36 +158,23 @@ write it to `src/`, `package.json`, lifecycle state, receipts, audit output, or
|
|
|
190
158
|
new indexing task, a changed host-visible Skill set, or an explicit diagnostic
|
|
191
159
|
request.
|
|
192
160
|
|
|
193
|
-
|
|
194
|
-
`
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
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.
|
|
161
|
+
Return only `stage: provider-selection`, the non-CLI
|
|
162
|
+
`host_visible_skills`, and the selected semantic `indexers` through the exact
|
|
163
|
+
`context action complete-current` command returned by the Route. The CLI owns
|
|
164
|
+
construction of the full registry payload, fallback/conflict checks, static
|
|
165
|
+
validation, Provider resolution and staging, final validation, and atomic
|
|
166
|
+
application of `src/indexers.yaml`. Do not call their low-level commands as a
|
|
167
|
+
second production workflow.
|
|
168
|
+
|
|
169
|
+
If a selected external Provider needs Host resolution, the next current Route
|
|
170
|
+
contains one `context.resolve-indexer-provider/v1` Host Action and its exact
|
|
171
|
+
request. Invoke that Host Action once, then submit
|
|
172
|
+
`stage: provider-resolution` with the returned Host result through the Route's
|
|
173
|
+
`complete-current` command. If the Bundle carries a non-allowlisted program,
|
|
174
|
+
the following current Route presents the existing program-execution Gate; wait
|
|
175
|
+
for its user/session-authority decision and submit that decision through
|
|
176
|
+
`complete-current`. A recovered `provider-finalization` Route consumes
|
|
177
|
+
only its fixed Action input; it must not resolve or install the Provider again.
|
|
223
178
|
|
|
224
179
|
### Follow the current Route
|
|
225
180
|
|
|
@@ -227,8 +182,12 @@ Treat `workflow.current` as the current-step authority:
|
|
|
227
182
|
|
|
228
183
|
1. Read every `resources.required` item whose `read_state` is `read-required`.
|
|
229
184
|
Read a returned `path` completely, or execute a returned resource `command`
|
|
230
|
-
and read its complete output file.
|
|
231
|
-
|
|
185
|
+
and read its complete output file. For a current Indexer Partition, Author,
|
|
186
|
+
Composer or structure-review Route, read the materialized files and then use
|
|
187
|
+
the Route's immediate completion command; do not create or submit a read
|
|
188
|
+
receipt. Other workflow resources may still require the returned receipt
|
|
189
|
+
command. Materializing a resource is not reading it. Keep those receipts only
|
|
190
|
+
in this conversation and submit them with
|
|
232
191
|
the exact returned `context status --resource-receipts @<file>` command. Use
|
|
233
192
|
`after_read_receipts` only after the full resource has been read. The exact
|
|
234
193
|
`resources.after_read.command` already returns the re-evaluated
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "c4a",
|
|
3
3
|
"displayName": "C4A Context",
|
|
4
|
-
"version": "0.7.
|
|
4
|
+
"version": "0.7.4",
|
|
5
5
|
"description": "Start or continue a project-local knowledge workspace through one graph-routed entry.",
|
|
6
6
|
"author": { "name": "Context4AI", "email": "support@context4ai.dev" },
|
|
7
7
|
"homepage": "https://github.com/context4ai/c4a",
|