@c4a/context-cli 0.6.1-beta.2 → 0.6.1-beta.3
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/cli.js +59015 -58198
- package/docs/quickstart.md +6 -0
- package/package.json +2 -2
- package/plugins/README.md +11 -0
- package/plugins/README_CN.md +9 -0
- package/plugins/VERSION +1 -1
- package/plugins/claude/.claude-plugin/plugin.json +1 -1
- package/plugins/claude/commands/continue.md +16 -1
- package/plugins/claude/commands/init.md +16 -15
- package/plugins/codex/.codex-plugin/plugin.json +2 -2
- package/plugins/codex/skills/continue/SKILL.md +16 -1
- package/plugins/codex/skills/init/SKILL.md +18 -17
- package/plugins/cursor/.cursor-plugin/plugin.json +1 -1
- package/plugins/cursor/commands/context-continue.md +16 -1
- package/plugins/cursor/commands/context-init.md +18 -17
- package/plugins/skills/context-continue/SKILL.md +16 -1
- package/plugins/skills/context-init/SKILL.md +18 -17
- package/providers/context/actions/align-next.yaml +0 -1
- package/providers/context/actions/apply-managed-review.yaml +0 -1
- package/providers/context/actions/apply-structure-confirmation.yaml +0 -1
- package/providers/context/actions/capture-next.yaml +0 -1
- package/providers/context/actions/compile-next.yaml +0 -1
- package/providers/context/actions/configure-code-extraction.yaml +0 -1
- package/providers/context/actions/configure-document-capture.yaml +0 -1
- package/providers/context/actions/configure-package-output.yaml +0 -1
- package/providers/context/actions/configure-prose-lifecycle.yaml +0 -1
- package/providers/context/actions/ensure-repository-sources.yaml +1 -1
- package/providers/context/actions/extract-next.yaml +0 -1
- package/providers/context/actions/repair-project-entry.yaml +0 -1
- package/providers/context/actions/repair-workspace-state.yaml +0 -1
- package/providers/context/manifest.json +45 -45
- package/providers/context/provider.yaml +1 -1
- package/providers/context/resources/manuals/reference/project-api.md +20 -0
- package/providers/context/resources/procedures/close-and-build.md +0 -1
- package/providers/context/resources/procedures/document-classification.md +0 -1
- package/providers/context/resources/procedures/evidence-maintenance.md +0 -1
- package/providers/context/resources/procedures/knowledge-review.md +0 -1
- package/providers/context/resources/procedures/project-configuration.md +0 -1
- package/providers/context/resources/procedures/verify-and-repair.md +0 -1
- package/providers/context/resources/semantic/align/structure-planning.md +20 -7
package/docs/quickstart.md
CHANGED
|
@@ -68,6 +68,12 @@ The CLI performs mechanical work such as source registration, capture,
|
|
|
68
68
|
validation, review application, verify, close, and build. The agent performs
|
|
69
69
|
semantic judgment only when the workflow asks for it.
|
|
70
70
|
|
|
71
|
+
When the user explicitly requests fully managed operation, the Agent may use
|
|
72
|
+
`context run --managed --until blocked-or-complete --format json` to collapse
|
|
73
|
+
consecutive deterministic routes. The CLI re-evaluates every revision and
|
|
74
|
+
stops before semantic reads, configuration, missing authority, diagnostics, or
|
|
75
|
+
multiple commands.
|
|
76
|
+
|
|
71
77
|
## 4. Manual Orientation
|
|
72
78
|
|
|
73
79
|
When operating without an agent plugin, start with:
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@c4a/context-cli",
|
|
3
|
-
"version": "0.6.1-beta.
|
|
3
|
+
"version": "0.6.1-beta.3",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"description": "Local CLI for capturing, compiling, and governing knowledge workspaces",
|
|
6
6
|
"license": "MIT",
|
|
@@ -21,7 +21,7 @@
|
|
|
21
21
|
},
|
|
22
22
|
"dependencies": {
|
|
23
23
|
"@c4a/agent-graph": "0.2.2",
|
|
24
|
-
"@c4a/context": "0.6.1-beta.
|
|
24
|
+
"@c4a/context": "0.6.1-beta.3",
|
|
25
25
|
"commander": "^11.0.0",
|
|
26
26
|
"handlebars": "^4.7.8",
|
|
27
27
|
"ink": "^5.0.0",
|
package/plugins/README.md
CHANGED
|
@@ -68,6 +68,17 @@ That session authority is not stored. It cannot choose source boundaries,
|
|
|
68
68
|
authorize unread external content, perform external repository operations, or
|
|
69
69
|
bypass validation and verification.
|
|
70
70
|
|
|
71
|
+
After the initial managed status, consecutive deterministic routes can be
|
|
72
|
+
collapsed with:
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
context run --managed --until blocked-or-complete --format json
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
The loop stops before any route that needs Agent interpretation, configuration,
|
|
79
|
+
additional authority, or diagnostic repair, and returns the current workflow
|
|
80
|
+
route for normal progressive loading.
|
|
81
|
+
|
|
71
82
|
## Workspace and SDK
|
|
72
83
|
|
|
73
84
|
Run the plugin from the initialized Context project root. Project declarations
|
package/plugins/README_CN.md
CHANGED
|
@@ -62,6 +62,15 @@ context status --managed --format json
|
|
|
62
62
|
该会话权限不会持久化,也不能选择来源边界、授权尚未允许读取的外部内容、执行
|
|
63
63
|
外部仓库操作,或绕过校验与验证。
|
|
64
64
|
|
|
65
|
+
首次读取托管状态后,可用下面的命令合并连续的确定性步骤:
|
|
66
|
+
|
|
67
|
+
```bash
|
|
68
|
+
context run --managed --until blocked-or-complete --format json
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
遇到需要 Agent 判断、配置修改、额外权限、诊断修复或多条命令的路线时,循环会
|
|
72
|
+
立即停止,并返回当前 `workflow.current` 供 Agent 按需加载上下文。
|
|
73
|
+
|
|
65
74
|
## 工作区与 SDK
|
|
66
75
|
|
|
67
76
|
Plugin 应在初始化后的 Context 项目根目录运行。`src/index.ts` 保存项目声明;
|
package/plugins/VERSION
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
0.6.1-beta.
|
|
1
|
+
0.6.1-beta.3
|
|
@@ -24,6 +24,20 @@ root, do not run `context status` first. Use the public Context init entry or
|
|
|
24
24
|
`context init` to create the workspace, complete the init setup command, then
|
|
25
25
|
return here from the initialized workspace.
|
|
26
26
|
|
|
27
|
+
For an explicitly managed conversation, the CLI can collapse consecutive
|
|
28
|
+
mechanical routes:
|
|
29
|
+
|
|
30
|
+
```bash
|
|
31
|
+
context run --managed --until blocked-or-complete --format json
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
Pass an additional `--authority` only when the user explicitly granted that
|
|
35
|
+
non-managed authority in this conversation. This loop executes only one
|
|
36
|
+
revision-bound command at a time and re-evaluates after every receipt. It stops
|
|
37
|
+
before read-only interpretation, project configuration, unresolved authority,
|
|
38
|
+
diagnostics, or a non-unique command plan. On stop, resume from the returned
|
|
39
|
+
`workflow.current`; do not derive a command from earlier steps.
|
|
40
|
+
|
|
27
41
|
Language policy: explain, ask, confirm, and summarize in the user's current
|
|
28
42
|
conversation language. Keep CLI commands, flags, paths, ids, status enum values,
|
|
29
43
|
JSONL payload keys, `source_ref` values, and copied CLI output tokens unchanged.
|
|
@@ -41,7 +55,8 @@ Treat `workflow.current` as the current-step authority:
|
|
|
41
55
|
wait for the current Gate decision.
|
|
42
56
|
4. If `configuration` is present, edit only the named project file using the
|
|
43
57
|
selected resources as its contract.
|
|
44
|
-
5. After every action or configuration change, run status again.
|
|
58
|
+
5. After every action or configuration change, run status again. The managed
|
|
59
|
+
`--until` loop performs this re-evaluation internally. A phase-local
|
|
45
60
|
`next_action` can continue that operation but never replaces the workspace
|
|
46
61
|
Route.
|
|
47
62
|
|
|
@@ -9,22 +9,23 @@ allowed-tools: Bash(context:*), Bash(bun:*), Bash(cd *)
|
|
|
9
9
|
Initialize a Context workspace with the global CLI, complete the returned setup
|
|
10
10
|
step, then hand control to the current workflow route.
|
|
11
11
|
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
enum values, payload keys, and copied CLI output tokens unchanged.
|
|
12
|
+
Use the user's language for conversation. Keep command and payload tokens
|
|
13
|
+
unchanged.
|
|
15
14
|
|
|
16
15
|
Run `context init [project-dir] [--name <name>]` with only the arguments the
|
|
17
|
-
user supplied.
|
|
18
|
-
|
|
19
|
-
explicitly asked to test a locally linked Context SDK.
|
|
16
|
+
user supplied. Never substitute `.` when `project-dir` was omitted; the default
|
|
17
|
+
is `context/`. Use `--dev` only for an explicitly requested local-link test.
|
|
20
18
|
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
status evaluation; never persist it into another conversation. Treat
|
|
25
|
-
`workflow.current` as the current-step authority: read every required resource,
|
|
26
|
-
execute only its exact commands, stop before any unresolved command marked
|
|
27
|
-
`after-human-confirmation`, and rerun status after each action.
|
|
19
|
+
If init reports `init-target-nonempty`, explain that existing files would share
|
|
20
|
+
the workspace root. Run the returned `--allow-nonempty` command only after
|
|
21
|
+
explicit confirmation.
|
|
28
22
|
|
|
29
|
-
|
|
30
|
-
|
|
23
|
+
Execute the returned setup command, enter the project root, and read its
|
|
24
|
+
generated `AGENTS.md`. Then run `context status --format json`, adding
|
|
25
|
+
`--managed` only for fully managed operation explicitly authorized in this
|
|
26
|
+
conversation. Treat `workflow.current` as authoritative: read its required
|
|
27
|
+
resources, execute only exact commands, honor unresolved human gates, and
|
|
28
|
+
reevaluate status after each action.
|
|
29
|
+
|
|
30
|
+
Do not add extra project-local agent setup or infer sources from the surrounding
|
|
31
|
+
monorepo.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "context",
|
|
3
|
-
"version": "0.6.1-beta.
|
|
3
|
+
"version": "0.6.1-beta.3",
|
|
4
4
|
"description": "Maintain a project-local knowledge workspace through init and next-step agent guidance.",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "c4a"
|
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
"skills": "./skills/",
|
|
19
19
|
"interface": {
|
|
20
20
|
"displayName": "C4A Context",
|
|
21
|
-
"shortDescription": "Initialize and advance a local, source-linked project knowledge workspace.\nv0.6.1-beta.
|
|
21
|
+
"shortDescription": "Initialize and advance a local, source-linked project knowledge workspace.\nv0.6.1-beta.3",
|
|
22
22
|
"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.",
|
|
23
23
|
"developerName": "c4a",
|
|
24
24
|
"category": "Productivity",
|
|
@@ -36,6 +36,20 @@ root, do not run `context status` first. Use the public Context init entry or
|
|
|
36
36
|
`context init` to create the workspace, complete the init setup command, then
|
|
37
37
|
return here from the initialized workspace.
|
|
38
38
|
|
|
39
|
+
For an explicitly managed conversation, the CLI can collapse consecutive
|
|
40
|
+
mechanical routes:
|
|
41
|
+
|
|
42
|
+
```bash
|
|
43
|
+
context run --managed --until blocked-or-complete --format json
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
Pass an additional `--authority` only when the user explicitly granted that
|
|
47
|
+
non-managed authority in this conversation. This loop executes only one
|
|
48
|
+
revision-bound command at a time and re-evaluates after every receipt. It stops
|
|
49
|
+
before read-only interpretation, project configuration, unresolved authority,
|
|
50
|
+
diagnostics, or a non-unique command plan. On stop, resume from the returned
|
|
51
|
+
`workflow.current`; do not derive a command from earlier steps.
|
|
52
|
+
|
|
39
53
|
Language policy: explain, ask, confirm, and summarize in the user's current
|
|
40
54
|
conversation language. Keep CLI commands, flags, paths, ids, status enum values,
|
|
41
55
|
JSONL payload keys, `source_ref` values, and copied CLI output tokens unchanged.
|
|
@@ -53,7 +67,8 @@ Treat `workflow.current` as the current-step authority:
|
|
|
53
67
|
wait for the current Gate decision.
|
|
54
68
|
4. If `configuration` is present, edit only the named project file using the
|
|
55
69
|
selected resources as its contract.
|
|
56
|
-
5. After every action or configuration change, run status again.
|
|
70
|
+
5. After every action or configuration change, run status again. The managed
|
|
71
|
+
`--until` loop performs this re-evaluation internally. A phase-local
|
|
57
72
|
`next_action` can continue that operation but never replaces the workspace
|
|
58
73
|
Route.
|
|
59
74
|
|
|
@@ -21,22 +21,23 @@ Public Context entry for agents that expose skills instead of slash commands.
|
|
|
21
21
|
Initialize a Context workspace with the global CLI, complete the returned setup
|
|
22
22
|
step, then hand control to the current workflow route.
|
|
23
23
|
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
enum values, payload keys, and copied CLI output tokens unchanged.
|
|
24
|
+
Use the user's language for conversation. Keep command and payload tokens
|
|
25
|
+
unchanged.
|
|
27
26
|
|
|
28
27
|
Run `context init [project-dir] [--name <name>]` with only the arguments the
|
|
29
|
-
user supplied.
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
`
|
|
38
|
-
|
|
39
|
-
`
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
28
|
+
user supplied. Never substitute `.` when `project-dir` was omitted; the default
|
|
29
|
+
is `context/`. Use `--dev` only for an explicitly requested local-link test.
|
|
30
|
+
|
|
31
|
+
If init reports `init-target-nonempty`, explain that existing files would share
|
|
32
|
+
the workspace root. Run the returned `--allow-nonempty` command only after
|
|
33
|
+
explicit confirmation.
|
|
34
|
+
|
|
35
|
+
Execute the returned setup command, enter the project root, and read its
|
|
36
|
+
generated `AGENTS.md`. Then run `context status --format json`, adding
|
|
37
|
+
`--managed` only for fully managed operation explicitly authorized in this
|
|
38
|
+
conversation. Treat `workflow.current` as authoritative: read its required
|
|
39
|
+
resources, execute only exact commands, honor unresolved human gates, and
|
|
40
|
+
reevaluate status after each action.
|
|
41
|
+
|
|
42
|
+
Do not add extra project-local agent setup or infer sources from the surrounding
|
|
43
|
+
monorepo.
|
|
@@ -28,6 +28,20 @@ root, do not run `context status` first. Use the public Context init entry or
|
|
|
28
28
|
`context init` to create the workspace, complete the init setup command, then
|
|
29
29
|
return here from the initialized workspace.
|
|
30
30
|
|
|
31
|
+
For an explicitly managed conversation, the CLI can collapse consecutive
|
|
32
|
+
mechanical routes:
|
|
33
|
+
|
|
34
|
+
```bash
|
|
35
|
+
context run --managed --until blocked-or-complete --format json
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
Pass an additional `--authority` only when the user explicitly granted that
|
|
39
|
+
non-managed authority in this conversation. This loop executes only one
|
|
40
|
+
revision-bound command at a time and re-evaluates after every receipt. It stops
|
|
41
|
+
before read-only interpretation, project configuration, unresolved authority,
|
|
42
|
+
diagnostics, or a non-unique command plan. On stop, resume from the returned
|
|
43
|
+
`workflow.current`; do not derive a command from earlier steps.
|
|
44
|
+
|
|
31
45
|
Language policy: explain, ask, confirm, and summarize in the user's current
|
|
32
46
|
conversation language. Keep CLI commands, flags, paths, ids, status enum values,
|
|
33
47
|
JSONL payload keys, `source_ref` values, and copied CLI output tokens unchanged.
|
|
@@ -45,7 +59,8 @@ Treat `workflow.current` as the current-step authority:
|
|
|
45
59
|
wait for the current Gate decision.
|
|
46
60
|
4. If `configuration` is present, edit only the named project file using the
|
|
47
61
|
selected resources as its contract.
|
|
48
|
-
5. After every action or configuration change, run status again.
|
|
62
|
+
5. After every action or configuration change, run status again. The managed
|
|
63
|
+
`--until` loop performs this re-evaluation internally. A phase-local
|
|
49
64
|
`next_action` can continue that operation but never replaces the workspace
|
|
50
65
|
Route.
|
|
51
66
|
|
|
@@ -13,22 +13,23 @@ Initialize a Context knowledge workspace.
|
|
|
13
13
|
Initialize a Context workspace with the global CLI, complete the returned setup
|
|
14
14
|
step, then hand control to the current workflow route.
|
|
15
15
|
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
enum values, payload keys, and copied CLI output tokens unchanged.
|
|
16
|
+
Use the user's language for conversation. Keep command and payload tokens
|
|
17
|
+
unchanged.
|
|
19
18
|
|
|
20
19
|
Run `context init [project-dir] [--name <name>]` with only the arguments the
|
|
21
|
-
user supplied.
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
`
|
|
30
|
-
|
|
31
|
-
`
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
20
|
+
user supplied. Never substitute `.` when `project-dir` was omitted; the default
|
|
21
|
+
is `context/`. Use `--dev` only for an explicitly requested local-link test.
|
|
22
|
+
|
|
23
|
+
If init reports `init-target-nonempty`, explain that existing files would share
|
|
24
|
+
the workspace root. Run the returned `--allow-nonempty` command only after
|
|
25
|
+
explicit confirmation.
|
|
26
|
+
|
|
27
|
+
Execute the returned setup command, enter the project root, and read its
|
|
28
|
+
generated `AGENTS.md`. Then run `context status --format json`, adding
|
|
29
|
+
`--managed` only for fully managed operation explicitly authorized in this
|
|
30
|
+
conversation. Treat `workflow.current` as authoritative: read its required
|
|
31
|
+
resources, execute only exact commands, honor unresolved human gates, and
|
|
32
|
+
reevaluate status after each action.
|
|
33
|
+
|
|
34
|
+
Do not add extra project-local agent setup or infer sources from the surrounding
|
|
35
|
+
monorepo.
|
|
@@ -36,6 +36,20 @@ root, do not run `context status` first. Use the public Context init entry or
|
|
|
36
36
|
`context init` to create the workspace, complete the init setup command, then
|
|
37
37
|
return here from the initialized workspace.
|
|
38
38
|
|
|
39
|
+
For an explicitly managed conversation, the CLI can collapse consecutive
|
|
40
|
+
mechanical routes:
|
|
41
|
+
|
|
42
|
+
```bash
|
|
43
|
+
context run --managed --until blocked-or-complete --format json
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
Pass an additional `--authority` only when the user explicitly granted that
|
|
47
|
+
non-managed authority in this conversation. This loop executes only one
|
|
48
|
+
revision-bound command at a time and re-evaluates after every receipt. It stops
|
|
49
|
+
before read-only interpretation, project configuration, unresolved authority,
|
|
50
|
+
diagnostics, or a non-unique command plan. On stop, resume from the returned
|
|
51
|
+
`workflow.current`; do not derive a command from earlier steps.
|
|
52
|
+
|
|
39
53
|
Language policy: explain, ask, confirm, and summarize in the user's current
|
|
40
54
|
conversation language. Keep CLI commands, flags, paths, ids, status enum values,
|
|
41
55
|
JSONL payload keys, `source_ref` values, and copied CLI output tokens unchanged.
|
|
@@ -53,7 +67,8 @@ Treat `workflow.current` as the current-step authority:
|
|
|
53
67
|
wait for the current Gate decision.
|
|
54
68
|
4. If `configuration` is present, edit only the named project file using the
|
|
55
69
|
selected resources as its contract.
|
|
56
|
-
5. After every action or configuration change, run status again.
|
|
70
|
+
5. After every action or configuration change, run status again. The managed
|
|
71
|
+
`--until` loop performs this re-evaluation internally. A phase-local
|
|
57
72
|
`next_action` can continue that operation but never replaces the workspace
|
|
58
73
|
Route.
|
|
59
74
|
|
|
@@ -21,22 +21,23 @@ Public Context entry for agents that expose skills instead of slash commands.
|
|
|
21
21
|
Initialize a Context workspace with the global CLI, complete the returned setup
|
|
22
22
|
step, then hand control to the current workflow route.
|
|
23
23
|
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
enum values, payload keys, and copied CLI output tokens unchanged.
|
|
24
|
+
Use the user's language for conversation. Keep command and payload tokens
|
|
25
|
+
unchanged.
|
|
27
26
|
|
|
28
27
|
Run `context init [project-dir] [--name <name>]` with only the arguments the
|
|
29
|
-
user supplied.
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
`
|
|
38
|
-
|
|
39
|
-
`
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
28
|
+
user supplied. Never substitute `.` when `project-dir` was omitted; the default
|
|
29
|
+
is `context/`. Use `--dev` only for an explicitly requested local-link test.
|
|
30
|
+
|
|
31
|
+
If init reports `init-target-nonempty`, explain that existing files would share
|
|
32
|
+
the workspace root. Run the returned `--allow-nonempty` command only after
|
|
33
|
+
explicit confirmation.
|
|
34
|
+
|
|
35
|
+
Execute the returned setup command, enter the project root, and read its
|
|
36
|
+
generated `AGENTS.md`. Then run `context status --format json`, adding
|
|
37
|
+
`--managed` only for fully managed operation explicitly authorized in this
|
|
38
|
+
conversation. Treat `workflow.current` as authoritative: read its required
|
|
39
|
+
resources, execute only exact commands, honor unresolved human gates, and
|
|
40
|
+
reevaluate status after each action.
|
|
41
|
+
|
|
42
|
+
Do not add extra project-local agent setup or infer sources from the surrounding
|
|
43
|
+
monorepo.
|