@devflow-tools/cli 0.18.8 → 0.18.9

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.
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "devflow",
3
3
  "description": "DevFlow — Developer Intelligence Platform: project context, code graph, knowledge base, memory engine, and workflow automation with 14 domain plugins",
4
- "version": "0.18.8",
4
+ "version": "0.18.9",
5
5
  "author": {
6
6
  "name": "DevFlow"
7
7
  },
@@ -19,7 +19,7 @@
19
19
  "WebFetch"
20
20
  ],
21
21
  "source": "core",
22
- "sourceVersion": "0.18.8",
22
+ "sourceVersion": "0.18.9",
23
23
  "requiresContext": true,
24
24
  "evidenceMode": "mixed",
25
25
  "skillPath": "skills/devflow:context/SKILL.md",
@@ -44,7 +44,7 @@
44
44
  "Explore"
45
45
  ],
46
46
  "source": "core",
47
- "sourceVersion": "0.18.8",
47
+ "sourceVersion": "0.18.9",
48
48
  "requiresContext": true,
49
49
  "evidenceMode": "mixed",
50
50
  "skillPath": "skills/devflow:graph/SKILL.md",
@@ -63,7 +63,7 @@
63
63
  "WebFetch"
64
64
  ],
65
65
  "source": "core",
66
- "sourceVersion": "0.18.8",
66
+ "sourceVersion": "0.18.9",
67
67
  "requiresContext": true,
68
68
  "evidenceMode": "mixed",
69
69
  "skillPath": "skills/devflow:knowledge/SKILL.md",
@@ -87,7 +87,7 @@
87
87
  "Explore"
88
88
  ],
89
89
  "source": "core",
90
- "sourceVersion": "0.18.8",
90
+ "sourceVersion": "0.18.9",
91
91
  "requiresContext": true,
92
92
  "evidenceMode": "mixed",
93
93
  "skillPath": "skills/devflow:memory/SKILL.md",
@@ -103,7 +103,7 @@
103
103
  ],
104
104
  "blockedNative": [],
105
105
  "source": "core",
106
- "sourceVersion": "0.18.8",
106
+ "sourceVersion": "0.18.9",
107
107
  "requiresContext": true,
108
108
  "evidenceMode": "mixed",
109
109
  "skillPath": "skills/devflow:workflow/SKILL.md",
@@ -113,6 +113,44 @@
113
113
  ]
114
114
  }
115
115
  },
116
+ "devflow:delivery": {
117
+ "mcpTools": [
118
+ "delivery_status",
119
+ "delivery_create_case",
120
+ "delivery_answer",
121
+ "delivery_revise",
122
+ "delivery_compare_options",
123
+ "delivery_approve",
124
+ "delivery_reject",
125
+ "delivery_resume",
126
+ "delivery_advance",
127
+ "delivery_retry_task",
128
+ "delivery_export",
129
+ "delivery_cancel"
130
+ ],
131
+ "blockedNative": [],
132
+ "source": "core",
133
+ "sourceVersion": "0.18.9",
134
+ "requiresContext": true,
135
+ "evidenceMode": "mixed",
136
+ "skillPath": "skills/devflow:delivery/SKILL.md",
137
+ "hostTools": {
138
+ "claude-code": [
139
+ "mcp__devflow__delivery_status",
140
+ "mcp__devflow__delivery_create_case",
141
+ "mcp__devflow__delivery_answer",
142
+ "mcp__devflow__delivery_revise",
143
+ "mcp__devflow__delivery_compare_options",
144
+ "mcp__devflow__delivery_approve",
145
+ "mcp__devflow__delivery_reject",
146
+ "mcp__devflow__delivery_resume",
147
+ "mcp__devflow__delivery_advance",
148
+ "mcp__devflow__delivery_retry_task",
149
+ "mcp__devflow__delivery_export",
150
+ "mcp__devflow__delivery_cancel"
151
+ ]
152
+ }
153
+ },
116
154
  "devflow:animation": {
117
155
  "mcpTools": [
118
156
  "animation_suggest"
@@ -0,0 +1,89 @@
1
+ ---
2
+ name: devflow:delivery
3
+ description: 通过可审计 Delivery Line 将需求推进到验证完成的 integrationRef 和交付包
4
+ required_mcp_tools:
5
+ - delivery_status
6
+ - delivery_create_case
7
+ - delivery_answer
8
+ - delivery_revise
9
+ - delivery_compare_options
10
+ - delivery_approve
11
+ - delivery_reject
12
+ - delivery_resume
13
+ - delivery_advance
14
+ - delivery_retry_task
15
+ - delivery_export
16
+ - delivery_cancel
17
+ ---
18
+
19
+ <HARD-GATE>
20
+ 收到 devflow:delivery 时,必须先调用以下 MCP 工具之一:
21
+ delivery_status / delivery_create_case / delivery_answer / delivery_revise / delivery_compare_options / delivery_approve / delivery_reject / delivery_resume / delivery_advance / delivery_retry_task / delivery_export / delivery_cancel
22
+ </HARD-GATE>
23
+
24
+ ## MANDATORY FIRST STEP - Skill Registration
25
+
26
+ > **IMPORTANT: Before ANY other action, execute the registration command below. This is NON-NEGOTIABLE.**
27
+
28
+ ```bash
29
+ mkdir -p ~/.devflow && echo '{"name":"devflow:delivery","required_mcp_tools":["delivery_status","delivery_create_case","delivery_answer","delivery_revise","delivery_compare_options","delivery_approve","delivery_reject","delivery_resume","delivery_advance","delivery_retry_task","delivery_export","delivery_cancel"],"description":"devflow:delivery skill","registeredAt":'"$(date +%s)000"'}' > ~/.devflow/current-skill.json
30
+ ```
31
+
32
+ After registration, you **MUST** use ONLY these MCP tools for all work in this skill:
33
+ - `mcp__devflow__delivery_status`
34
+ - `mcp__devflow__delivery_create_case`
35
+ - `mcp__devflow__delivery_answer`
36
+ - `mcp__devflow__delivery_revise`
37
+ - `mcp__devflow__delivery_compare_options`
38
+ - `mcp__devflow__delivery_approve`
39
+ - `mcp__devflow__delivery_reject`
40
+ - `mcp__devflow__delivery_resume`
41
+ - `mcp__devflow__delivery_advance`
42
+ - `mcp__devflow__delivery_retry_task`
43
+ - `mcp__devflow__delivery_export`
44
+ - `mcp__devflow__delivery_cancel`
45
+
46
+ **Never use direct tools** (Read, Write, Edit, Bash, Grep, etc.) for tasks that can be handled by the MCP tools above.
47
+
48
+ When the skill execution is complete, clean up:
49
+ ```bash
50
+ rm -f ~/.devflow/current-skill.json ~/.devflow/current-execution-id
51
+ ```
52
+
53
+ # Delivery Line
54
+
55
+ 使用 `mcp__devflow__delivery_*` 工具推进一个持久化交付案件。案件状态和 `nextActions` 是唯一的流程事实来源。
56
+
57
+ ## 开始案件
58
+
59
+ 收到新的交付需求时,调用 `mcp__devflow__delivery_create_case`。使用当前项目绝对路径;默认 `baseRef=HEAD`、`targetRef=main`,除非用户明确指定其他值。为 actor、session、execution 和每次写操作生成稳定且可追踪的标识与幂等键。
60
+
61
+ ## 推进规则
62
+
63
+ - 每次写操作后读取返回状态;状态不明确或发生 stale turn 时调用 `mcp__devflow__delivery_status`。
64
+ - 只执行当前 `nextActions` 允许的操作。
65
+ - 澄清与设计交互使用当前 turn;后续写操作携带案件当前 context receipt。
66
+ - 只有用户明确同意时才能调用 `mcp__devflow__delivery_approve`;不得代替用户批准。
67
+ - `mcp__devflow__delivery_advance` 用于推进已满足的状态,`mcp__devflow__delivery_resume` 只恢复已经具备运行条件的 gate 或 task。
68
+ - 失败任务只通过 `mcp__devflow__delivery_retry_task` 重试;取消和导出分别使用 `mcp__devflow__delivery_cancel` 与 `mcp__devflow__delivery_export`。
69
+
70
+ ## 可用操作
71
+
72
+ - 澄清和设计:`delivery_answer`、`delivery_revise`、`delivery_compare_options`
73
+ - Gate 决策:`delivery_approve`、`delivery_reject`
74
+ - 状态和执行:`delivery_status`、`delivery_advance`、`delivery_resume`、`delivery_retry_task`
75
+ - 交付收尾:`delivery_export`、`delivery_cancel`
76
+
77
+ ## 错误处理
78
+
79
+ - MCP 返回 `ok: false` 时,该操作已经失败。向用户呈现 `error.code` 和 `error.message`,不得把 transport 成功误报为交付成功。
80
+ - 遇到 `STALE_INTERACTION_TURN`、`MISSING_PREREQUISITE` 或 `INVALID_TRANSITION` 时,先调用 `mcp__devflow__delivery_status` 刷新案件状态;只有新的 `nextActions` 明确允许时才继续。
81
+ - 用户拒绝审批,或遇到 `UNAUTHORIZED_ROLE`、权限失败、`PROJECT_ROOT_MISMATCH` 时不得自动重试;保留案件当前状态并请求用户处理。
82
+ - 不通过更换 actor、project root、turn、context receipt 或幂等键来规避失败。
83
+
84
+ ## 禁止
85
+
86
+ - 不直接修改 Delivery Line 数据库或状态文件。
87
+ - 不绕过 Facade 写入受保护的 target ref。
88
+ - 不把 `/devflow:workflow` 当作 Delivery Line 的替代路径。
89
+ - 不伪造 context receipt、interaction turn、审批或成功结果。
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@devflow-tools/claude-code-plugin",
3
- "version": "0.18.8",
3
+ "version": "0.18.9",
4
4
  "description": "Claude Code hooks and skills for the DevFlow development intelligence runtime.",
5
5
  "type": "module",
6
6
  "scripts": {
@@ -12,20 +12,20 @@
12
12
  "verify:runtime-dependencies": "node --import tsx scripts/verify-runtime-dependencies.ts"
13
13
  },
14
14
  "dependencies": {
15
- "@devflow-tools/benchmark": "0.18.8",
16
- "@devflow-tools/context-engine": "0.18.8",
17
- "@devflow-tools/database": "0.18.8",
18
- "@devflow-tools/mcp-server": "0.18.8",
19
- "@devflow-tools/memory-engine": "0.18.8",
20
- "@devflow-tools/sdk": "0.18.8",
21
- "@devflow-tools/semantic-engine": "0.18.8",
22
- "@devflow-tools/server": "0.18.8",
23
- "@devflow-tools/task-runtime": "0.18.8",
24
- "@devflow-tools/telemetry": "0.18.8",
25
- "@devflow-tools/workflow-engine": "0.18.8"
15
+ "@devflow-tools/benchmark": "0.18.9",
16
+ "@devflow-tools/context-engine": "0.18.9",
17
+ "@devflow-tools/database": "0.18.9",
18
+ "@devflow-tools/mcp-server": "0.18.9",
19
+ "@devflow-tools/memory-engine": "0.18.9",
20
+ "@devflow-tools/sdk": "0.18.9",
21
+ "@devflow-tools/semantic-engine": "0.18.9",
22
+ "@devflow-tools/server": "0.18.9",
23
+ "@devflow-tools/task-runtime": "0.18.9",
24
+ "@devflow-tools/telemetry": "0.18.9",
25
+ "@devflow-tools/workflow-engine": "0.18.9"
26
26
  },
27
27
  "devDependencies": {
28
- "@devflow-tools/devflow": "0.18.8"
28
+ "@devflow-tools/devflow": "0.18.9"
29
29
  },
30
30
  "allowScripts": {
31
31
  "better-sqlite3@12.11.1": true,
@@ -0,0 +1,42 @@
1
+ ---
2
+ name: devflow:delivery
3
+ description: 通过可审计 Delivery Line 将需求推进到验证完成的 integrationRef 和交付包
4
+ ---
5
+
6
+ # Delivery Line
7
+
8
+ 使用 `mcp__devflow__delivery_*` 工具推进一个持久化交付案件。案件状态和 `nextActions` 是唯一的流程事实来源。
9
+
10
+ ## 开始案件
11
+
12
+ 收到新的交付需求时,调用 `mcp__devflow__delivery_create_case`。使用当前项目绝对路径;默认 `baseRef=HEAD`、`targetRef=main`,除非用户明确指定其他值。为 actor、session、execution 和每次写操作生成稳定且可追踪的标识与幂等键。
13
+
14
+ ## 推进规则
15
+
16
+ - 每次写操作后读取返回状态;状态不明确或发生 stale turn 时调用 `mcp__devflow__delivery_status`。
17
+ - 只执行当前 `nextActions` 允许的操作。
18
+ - 澄清与设计交互使用当前 turn;后续写操作携带案件当前 context receipt。
19
+ - 只有用户明确同意时才能调用 `mcp__devflow__delivery_approve`;不得代替用户批准。
20
+ - `mcp__devflow__delivery_advance` 用于推进已满足的状态,`mcp__devflow__delivery_resume` 只恢复已经具备运行条件的 gate 或 task。
21
+ - 失败任务只通过 `mcp__devflow__delivery_retry_task` 重试;取消和导出分别使用 `mcp__devflow__delivery_cancel` 与 `mcp__devflow__delivery_export`。
22
+
23
+ ## 可用操作
24
+
25
+ - 澄清和设计:`delivery_answer`、`delivery_revise`、`delivery_compare_options`
26
+ - Gate 决策:`delivery_approve`、`delivery_reject`
27
+ - 状态和执行:`delivery_status`、`delivery_advance`、`delivery_resume`、`delivery_retry_task`
28
+ - 交付收尾:`delivery_export`、`delivery_cancel`
29
+
30
+ ## 错误处理
31
+
32
+ - MCP 返回 `ok: false` 时,该操作已经失败。向用户呈现 `error.code` 和 `error.message`,不得把 transport 成功误报为交付成功。
33
+ - 遇到 `STALE_INTERACTION_TURN`、`MISSING_PREREQUISITE` 或 `INVALID_TRANSITION` 时,先调用 `mcp__devflow__delivery_status` 刷新案件状态;只有新的 `nextActions` 明确允许时才继续。
34
+ - 用户拒绝审批,或遇到 `UNAUTHORIZED_ROLE`、权限失败、`PROJECT_ROOT_MISMATCH` 时不得自动重试;保留案件当前状态并请求用户处理。
35
+ - 不通过更换 actor、project root、turn、context receipt 或幂等键来规避失败。
36
+
37
+ ## 禁止
38
+
39
+ - 不直接修改 Delivery Line 数据库或状态文件。
40
+ - 不绕过 Facade 写入受保护的 target ref。
41
+ - 不把 `/devflow:workflow` 当作 Delivery Line 的替代路径。
42
+ - 不伪造 context receipt、interaction turn、审批或成功结果。
@@ -15,6 +15,7 @@ required_mcp_tools: []
15
15
  | /devflow:memory | get_memory |
16
16
  | /devflow:knowledge | get_knowledge |
17
17
  | /devflow:workflow | run_workflow |
18
+ | /devflow:delivery | delivery_create_case / delivery_status / delivery_* |
18
19
  | /devflow:doctor | get_project_context |
19
20
 
20
21
  领域插件(/devflow:react, /devflow:vue, /devflow:nextjs, /devflow:nest, /devflow:tailwind, /devflow:docker, /devflow:electron, /devflow:graphql, /devflow:git, /devflow:performance, /devflow:animation, /devflow:css, /devflow:taro, /devflow:ui-layout)— 每个都有对应的 MCP 工具。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@devflow-tools/cli",
3
- "version": "0.18.8",
3
+ "version": "0.18.9",
4
4
  "type": "module",
5
5
  "bin": {
6
6
  "devflow": "./bin/devflow.cjs"
@@ -14,38 +14,38 @@
14
14
  },
15
15
  "dependencies": {
16
16
  "@colbymchenry/codegraph": "^1.1.1",
17
- "@devflow-tools/adapters": "0.18.8",
18
- "@devflow-tools/benchmark": "0.18.8",
19
- "@devflow-tools/context-engine": "0.18.8",
20
- "@devflow-tools/database": "0.18.8",
21
- "@devflow-tools/delivery-line": "0.18.8",
22
- "@devflow-tools/knowledge-engine": "0.18.8",
23
- "@devflow-tools/mcp-server": "0.18.8",
24
- "@devflow-tools/memory-engine": "0.18.8",
25
- "@devflow-tools/plugin-animation": "0.18.8",
26
- "@devflow-tools/plugin-css": "0.18.8",
27
- "@devflow-tools/plugin-docker": "0.18.8",
28
- "@devflow-tools/plugin-electron": "0.18.8",
29
- "@devflow-tools/plugin-git": "0.18.8",
30
- "@devflow-tools/plugin-graphql": "0.18.8",
31
- "@devflow-tools/plugin-nest": "0.18.8",
32
- "@devflow-tools/plugin-nextjs": "0.18.8",
33
- "@devflow-tools/plugin-performance": "0.18.8",
34
- "@devflow-tools/plugin-react": "0.18.8",
35
- "@devflow-tools/plugin-tailwind": "0.18.8",
36
- "@devflow-tools/plugin-taro": "0.18.8",
37
- "@devflow-tools/plugin-ui-layout": "0.18.8",
38
- "@devflow-tools/plugin-vue": "0.18.8",
39
- "@devflow-tools/sdk": "0.18.8",
40
- "@devflow-tools/server": "0.18.8",
41
- "@devflow-tools/telemetry": "0.18.8",
42
- "@devflow-tools/workflow-engine": "0.18.8",
17
+ "@devflow-tools/adapters": "0.18.9",
18
+ "@devflow-tools/benchmark": "0.18.9",
19
+ "@devflow-tools/context-engine": "0.18.9",
20
+ "@devflow-tools/database": "0.18.9",
21
+ "@devflow-tools/delivery-line": "0.18.9",
22
+ "@devflow-tools/knowledge-engine": "0.18.9",
23
+ "@devflow-tools/mcp-server": "0.18.9",
24
+ "@devflow-tools/memory-engine": "0.18.9",
25
+ "@devflow-tools/plugin-animation": "0.18.9",
26
+ "@devflow-tools/plugin-css": "0.18.9",
27
+ "@devflow-tools/plugin-docker": "0.18.9",
28
+ "@devflow-tools/plugin-electron": "0.18.9",
29
+ "@devflow-tools/plugin-git": "0.18.9",
30
+ "@devflow-tools/plugin-graphql": "0.18.9",
31
+ "@devflow-tools/plugin-nest": "0.18.9",
32
+ "@devflow-tools/plugin-nextjs": "0.18.9",
33
+ "@devflow-tools/plugin-performance": "0.18.9",
34
+ "@devflow-tools/plugin-react": "0.18.9",
35
+ "@devflow-tools/plugin-tailwind": "0.18.9",
36
+ "@devflow-tools/plugin-taro": "0.18.9",
37
+ "@devflow-tools/plugin-ui-layout": "0.18.9",
38
+ "@devflow-tools/plugin-vue": "0.18.9",
39
+ "@devflow-tools/sdk": "0.18.9",
40
+ "@devflow-tools/server": "0.18.9",
41
+ "@devflow-tools/telemetry": "0.18.9",
42
+ "@devflow-tools/workflow-engine": "0.18.9",
43
43
  "@inquirer/prompts": "^7.10.1",
44
44
  "chalk": "^5.3.0",
45
45
  "commander": "^12.0.0"
46
46
  },
47
47
  "devDependencies": {
48
- "@devflow-tools/devflow": "0.18.8",
48
+ "@devflow-tools/devflow": "0.18.9",
49
49
  "typescript": "^5.5.0",
50
50
  "vitest": "^2.0.0"
51
51
  },
@@ -53,7 +53,7 @@
53
53
  "dist",
54
54
  "bin"
55
55
  ],
56
- "gitHead": "f0e905a514dd601c9cdcd759e23e568df3e21fef",
56
+ "gitHead": "940c6c004c0ebb59abad3da9bc67137fa2d2a666",
57
57
  "description": "Command-line interface for DevFlow development intelligence and diagnostics.",
58
58
  "license": "MIT",
59
59
  "repository": {