flow-comet 1.6.2 → 1.6.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/.flow-comet/skills/flow-comet/INSTALLED_VERSION +1 -1
- package/.flow-comet/skills/flow-comet/SKILL.md +64 -46
- package/.flow-comet/skills/flow-comet/reference/KNOWN-ISSUES-template.md +1 -1
- package/.flow-comet/skills/flow-comet/reference/commit-discipline.md +32 -0
- package/.flow-comet/skills/flow-comet/reference/dirty-worktree.md +1 -1
- package/.flow-comet/skills/flow-comet/{GUIDANCE.md → reference/entry-detail.md} +18 -28
- package/.flow-comet/skills/flow-comet/reference/fix-loop.md +57 -0
- package/.flow-comet/skills/flow-comet/reference/platform-facts.md +58 -0
- package/.flow-comet/skills/flow-comet/reference/replan.md +23 -0
- package/.flow-comet/skills/flow-comet/scripts/comet-check.mjs +5 -4
- package/.flow-comet/skills/flow-comet/scripts/comet-hook-guard.mjs +266 -25
- package/.flow-comet/skills/flow-comet/scripts/context-init.mjs +2 -2
- package/.flow-comet/skills/flow-comet/scripts/evolve.mjs +6 -6
- package/.flow-comet/skills/flow-comet/scripts/guard-self-test.mjs +67 -16325
- package/.flow-comet/skills/flow-comet/scripts/health.mjs +1 -1
- package/.flow-comet/skills/flow-comet/scripts/items/a.mjs +1030 -0
- package/.flow-comet/skills/flow-comet/scripts/items/b.mjs +830 -0
- package/.flow-comet/skills/flow-comet/scripts/items/c.mjs +781 -0
- package/.flow-comet/skills/flow-comet/scripts/items/d.mjs +99 -0
- package/.flow-comet/skills/flow-comet/scripts/items/e.mjs +185 -0
- package/.flow-comet/skills/flow-comet/scripts/items/f.mjs +90 -0
- package/.flow-comet/skills/flow-comet/scripts/items/g.mjs +59 -0
- package/.flow-comet/skills/flow-comet/scripts/items/h.mjs +815 -0
- package/.flow-comet/skills/flow-comet/scripts/items/i.mjs +77 -0
- package/.flow-comet/skills/flow-comet/scripts/items/j.mjs +75 -0
- package/.flow-comet/skills/flow-comet/scripts/items/k.mjs +1427 -0
- package/.flow-comet/skills/flow-comet/scripts/items/l.mjs +275 -0
- package/.flow-comet/skills/flow-comet/scripts/items/m.mjs +614 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/count-derivation.mjs +97 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/fix-loop-node.mjs +196 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-evidence-gates.mjs +553 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-gates.mjs +837 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-routing.mjs +404 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-state-io.mjs +404 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-template-fidelity.mjs +302 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-uidesign.mjs +133 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/reentry-node.mjs +237 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/replan-node.mjs +209 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-branch.mjs +49 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-bridgecheck.mjs +201 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-admin.mjs +141 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-flow.mjs +700 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-recovery.mjs +578 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-determine.mjs +52 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-evolve-hint.mjs +55 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-explain.mjs +106 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-intelscan.mjs +58 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-io.mjs +147 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-skillmarkers.mjs +189 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/system-fixtures.mjs +1441 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/task-graph.mjs +471 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/test-assertions.mjs +509 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/test-fixtures.mjs +1228 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/test-helpers.mjs +237 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/text-anchor-checks.mjs +2484 -0
- package/.flow-comet/skills/flow-comet/scripts/protocol-utils.mjs +2 -2
- package/.flow-comet/skills/flow-comet/scripts/route-node.mjs +73 -1077
- package/.flow-comet/skills/flow-comet/scripts/scenarios/a.mjs +966 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/b.mjs +1233 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/c.mjs +1382 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/d.mjs +483 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/e.mjs +1388 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/f.mjs +1466 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/g.mjs +1364 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/h.mjs +1287 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/i.mjs +1436 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/j.mjs +1384 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/k.mjs +1338 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/l.mjs +1484 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/m.mjs +971 -0
- package/.flow-comet/skills/flow-comet/scripts/state-schema.mjs +14 -1
- package/.flow-comet/skills/flow-comet/scripts/system-test.mjs +58 -6692
- package/.flow-comet/skills/flow-comet/scripts/time-utils.mjs +4 -4
- package/.flow-comet/skills/flow-comet/scripts/workflow-guard.mjs +151 -2428
- package/.flow-comet/skills/flow-comet/scripts/workflow-handoff.mjs +116 -9
- package/.flow-comet/skills/flow-comet/scripts/workflow-state.mjs +29 -2086
- package/.flow-comet/skills/flow-comet-archive/SKILL.md +10 -19
- package/.flow-comet/skills/flow-comet-change/SKILL.md +2 -3
- package/.flow-comet/skills/flow-comet-compose/SKILL.md +1 -1
- package/.flow-comet/skills/flow-comet-design/SKILL.md +6 -6
- package/.flow-comet/skills/flow-comet-execute/SKILL.md +58 -16
- package/.flow-comet/skills/flow-comet-integration/SKILL.md +8 -5
- package/.flow-comet/skills/flow-comet-open/SKILL.md +5 -1
- package/.flow-comet/skills/flow-comet-plan/GUIDANCE.md +1 -1
- package/.flow-comet/skills/flow-comet-plan/SKILL.md +8 -8
- package/.flow-comet/skills/flow-comet-review/SKILL.md +9 -12
- package/.flow-comet/skills/flow-comet-subagent-execute/SKILL.md +59 -16
- package/.flow-comet/skills/flow-comet-task/SKILL.md +3 -2
- package/.flow-comet/skills/flow-comet-ui-design/SKILL.md +3 -3
- package/.flow-comet/skills/flow-comet-verify/SKILL.md +8 -17
- package/README.md +53 -70
- package/package.json +3 -2
- package/scripts/dsh-bridge.mjs +59 -26
- package/scripts/lib/installer-cleanup.mjs +152 -0
- package/scripts/lib/installer-flowkit.mjs +119 -0
- package/scripts/lib/installer-hooks.mjs +363 -0
- package/scripts/lib/installer-loader.mjs +220 -0
- package/scripts/lib/installer-migrate.mjs +236 -0
- package/scripts/lib/installer-platforms.mjs +314 -0
- package/scripts/prepare-env.mjs +36 -1164
- package/.flow-comet/skills/flow-comet/reference/TEST-MATRIX.md +0 -116
- package/.flow-comet/skills/flow-comet/reference/composition-report.md +0 -65
- package/.flow-comet/skills/flow-comet/reference/dsh-platform.md +0 -184
- package/.flow-comet/skills/flow-comet/reference/resolved-skills.json +0 -661
- package/.flow-comet/skills/flow-comet/reference/skill-review.md +0 -13
- package/.flow-comet/skills/flow-comet/reference/subagents/script-author.md +0 -7
- package/.flow-comet/skills/flow-comet/reference/worktree-notes.md +0 -70
|
@@ -0,0 +1,966 @@
|
|
|
1
|
+
// 场景组 a — 节点门禁 · 分支模式 · 归档与上下文警告 · 自定义协议
|
|
2
|
+
// 元素形态:`{ name, run }`;计数由 `lib/count-derivation.mjs` 从本目录聚合,不手抄数字。
|
|
3
|
+
// 组界按场景名前缀与文件内既有分段划,与入口 `SCENARIOS` 的拼接顺序一致。
|
|
4
|
+
|
|
5
|
+
import fs from 'fs';
|
|
6
|
+
import path from 'path';
|
|
7
|
+
import { execFileSync } from 'child_process';
|
|
8
|
+
import {
|
|
9
|
+
assertExit,
|
|
10
|
+
assertNotOut,
|
|
11
|
+
assertOut,
|
|
12
|
+
baseState,
|
|
13
|
+
runGuard,
|
|
14
|
+
runHandoff,
|
|
15
|
+
runHook,
|
|
16
|
+
runState,
|
|
17
|
+
writeFile,
|
|
18
|
+
writeState,
|
|
19
|
+
} from '../lib/test-helpers.mjs';
|
|
20
|
+
import {
|
|
21
|
+
CHANGE_ID,
|
|
22
|
+
SCRIPTS_DIR,
|
|
23
|
+
TASK_DONE,
|
|
24
|
+
TASK_P1,
|
|
25
|
+
TASK_P2,
|
|
26
|
+
composeState,
|
|
27
|
+
engineScriptFiles,
|
|
28
|
+
handoffFor,
|
|
29
|
+
strictSummary,
|
|
30
|
+
summaryContent,
|
|
31
|
+
timeUtilsModule,
|
|
32
|
+
writeCustomProtocol,
|
|
33
|
+
} from '../lib/test-fixtures.mjs';
|
|
34
|
+
import {
|
|
35
|
+
assertStateBytesUnchanged,
|
|
36
|
+
readStateBytes,
|
|
37
|
+
} from '../lib/test-assertions.mjs';
|
|
38
|
+
|
|
39
|
+
export const ENTRIES = [
|
|
40
|
+
// 1: open exit 通过(模板段名 CHANGE "## Why(为什么做)" + REQUIREMENT "## 用户故事(User Story)" + 验收段)——带模板验证 C2 派生
|
|
41
|
+
{
|
|
42
|
+
name: '01 open exit 通过(模板段名)',
|
|
43
|
+
run: (dir) => {
|
|
44
|
+
writeFile(dir, 'flow-kit/templates/CHANGE.md', '# CHANGE 模板\n\n## Why(为什么做)\n## 范围(Scope)\n');
|
|
45
|
+
writeFile(dir, 'flow-kit/templates/REQUIREMENT.md', '# REQUIREMENT 模板\n\n## 用户故事(User Story)\n## 验收准则(AC)\n## 非目标(Non-Goals)\n');
|
|
46
|
+
const st = baseState('open');
|
|
47
|
+
st.evidence.open = { summary: 'intake complete' };
|
|
48
|
+
writeState(dir, st);
|
|
49
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/CHANGE.md', '# CHANGE\n\n## Why\n\n## 范围\n');
|
|
50
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/REQUIREMENT.md', '# REQUIREMENT\n\n## 用户故事\n\n## 验收准则(AC)\n');
|
|
51
|
+
const res = runGuard(['exit', 'open'], dir);
|
|
52
|
+
assertExit(res, 0);
|
|
53
|
+
assertOut(res, 'ALL CHECKS PASSED');
|
|
54
|
+
},
|
|
55
|
+
},
|
|
56
|
+
|
|
57
|
+
// 2: open exit BLOCKED——CHANGE.md 缺 Why 段
|
|
58
|
+
{
|
|
59
|
+
name: '02 open exit BLOCKED:CHANGE 缺 Why 段',
|
|
60
|
+
run: (dir) => {
|
|
61
|
+
const st = baseState('open');
|
|
62
|
+
st.evidence.open = { summary: 'intake complete' };
|
|
63
|
+
writeState(dir, st);
|
|
64
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/CHANGE.md', '# CHANGE\n\n## 变更目标\n\n## 方案\n');
|
|
65
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/REQUIREMENT.md', '# REQUIREMENT\n\n## 用户故事\n\n## 验收准则(AC)\n');
|
|
66
|
+
const res = runGuard(['exit', 'open'], dir);
|
|
67
|
+
assertExit(res, 1);
|
|
68
|
+
assertOut(res, 'BLOCKED');
|
|
69
|
+
assertOut(res, 'CHANGE.md 缺必填段');
|
|
70
|
+
},
|
|
71
|
+
},
|
|
72
|
+
|
|
73
|
+
// 3: open exit BLOCKED——REQUIREMENT.md 缺验收段(且无 Given 豁免)
|
|
74
|
+
{
|
|
75
|
+
name: '03 open exit BLOCKED:REQUIREMENT 缺验收段',
|
|
76
|
+
run: (dir) => {
|
|
77
|
+
const st = baseState('open');
|
|
78
|
+
st.evidence.open = { summary: 'intake complete' };
|
|
79
|
+
writeState(dir, st);
|
|
80
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/CHANGE.md', '# CHANGE\n\n## Why\n');
|
|
81
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/REQUIREMENT.md', '# REQUIREMENT\n\n## 用户故事\n\n## 需求分析\n');
|
|
82
|
+
const res = runGuard(['exit', 'open'], dir);
|
|
83
|
+
assertExit(res, 1);
|
|
84
|
+
assertOut(res, 'BLOCKED');
|
|
85
|
+
assertOut(res, '缺少验收标准');
|
|
86
|
+
},
|
|
87
|
+
},
|
|
88
|
+
|
|
89
|
+
// 4: design exit 通过(## 0. + ## 1. 决策清单)——带模板,段名 "## 1. 技术决策清单" 只有模板派生能匹配(fallback 不匹配)
|
|
90
|
+
{
|
|
91
|
+
name: '04 design exit 通过(模板派生 技术决策清单)',
|
|
92
|
+
run: (dir) => {
|
|
93
|
+
writeFile(dir, 'flow-kit/templates/DESIGN.md', '# DESIGN 模板\n\n## 0. 技术栈选型\n## 1. 技术决策清单\n## 2. 数据流\n');
|
|
94
|
+
const st = baseState('design');
|
|
95
|
+
st.evidence.design = { summary: 'design done' };
|
|
96
|
+
writeState(dir, st);
|
|
97
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/DESIGN.md', '# DESIGN\n\n## 0. 技术栈选型\n\n## 1. 技术决策清单\n');
|
|
98
|
+
const res = runGuard(['exit', 'design'], dir);
|
|
99
|
+
assertExit(res, 0);
|
|
100
|
+
assertOut(res, 'ALL CHECKS PASSED');
|
|
101
|
+
},
|
|
102
|
+
},
|
|
103
|
+
|
|
104
|
+
// 5: design exit BLOCKED——缺 ## 决策清单 段
|
|
105
|
+
{
|
|
106
|
+
name: '05 design exit BLOCKED:缺决策清单',
|
|
107
|
+
run: (dir) => {
|
|
108
|
+
const st = baseState('design');
|
|
109
|
+
st.evidence.design = { summary: 'design done' };
|
|
110
|
+
writeState(dir, st);
|
|
111
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/DESIGN.md', '# DESIGN\n\n## 0. 技术栈\n');
|
|
112
|
+
const res = runGuard(['exit', 'design'], dir);
|
|
113
|
+
assertExit(res, 1);
|
|
114
|
+
assertOut(res, '决策清单');
|
|
115
|
+
},
|
|
116
|
+
},
|
|
117
|
+
|
|
118
|
+
// 6: plan exit 通过(task 块 + verify 字段)
|
|
119
|
+
{
|
|
120
|
+
name: '06 plan exit 通过(task 块 + verify)',
|
|
121
|
+
run: (dir) => {
|
|
122
|
+
const st = baseState('plan');
|
|
123
|
+
st.evidence.plan = { summary: 'plan done' };
|
|
124
|
+
writeState(dir, st);
|
|
125
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/TASK.md', '# TASK\n\n' + TASK_DONE);
|
|
126
|
+
const res = runGuard(['exit', 'plan'], dir);
|
|
127
|
+
assertExit(res, 0);
|
|
128
|
+
assertOut(res, 'ALL CHECKS PASSED');
|
|
129
|
+
},
|
|
130
|
+
},
|
|
131
|
+
|
|
132
|
+
// 7: plan exit BLOCKED——无 <task> 块
|
|
133
|
+
{
|
|
134
|
+
name: '07 plan exit BLOCKED:无 task 块',
|
|
135
|
+
run: (dir) => {
|
|
136
|
+
const st = baseState('plan');
|
|
137
|
+
st.evidence.plan = { summary: 'plan done' };
|
|
138
|
+
writeState(dir, st);
|
|
139
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/TASK.md', '# TASK\n\n(无任务块)\n');
|
|
140
|
+
const res = runGuard(['exit', 'plan'], dir);
|
|
141
|
+
assertExit(res, 1);
|
|
142
|
+
assertOut(res, 'BLOCKED');
|
|
143
|
+
assertOut(res, '无 <task> 块');
|
|
144
|
+
},
|
|
145
|
+
},
|
|
146
|
+
|
|
147
|
+
// 8: execute exit 通过(enter 记录 taskHash + SUMMARY 六段 + 6 维实质 + 自检方法 + handoff 齐 + TASK 全 done)
|
|
148
|
+
{
|
|
149
|
+
name: '08 execute exit 通过(enter 后未改 TASK,签名匹配)',
|
|
150
|
+
run: (dir) => {
|
|
151
|
+
const st = baseState('execute');
|
|
152
|
+
st.evidence.execute = { summary: 'executed' };
|
|
153
|
+
writeState(dir, st);
|
|
154
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/TASK.md', '# TASK\n\n' + TASK_DONE);
|
|
155
|
+
// enter 时脚本自动记录 taskHash(写回 state)
|
|
156
|
+
assertExit(runGuard(['entry', 'execute'], dir), 0);
|
|
157
|
+
// exit 前补 SUMMARY + handoff(不碰 TASK.md)
|
|
158
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/T01-SUMMARY.md', summaryContent());
|
|
159
|
+
const st2 = JSON.parse(fs.readFileSync(path.join(dir, '.flow-comet', 'flow-comet-state.json'), 'utf8'));
|
|
160
|
+
st2.evidence['subagent-execute'] = { handoffResult: handoffFor(['T01']) };
|
|
161
|
+
writeState(dir, st2);
|
|
162
|
+
const res = runGuard(['exit', 'execute'], dir);
|
|
163
|
+
assertExit(res, 0);
|
|
164
|
+
assertOut(res, 'ALL CHECKS PASSED');
|
|
165
|
+
// 变体:自检方法段名带括号后缀(执行者按模板标题原样书写,如 "## 自检方法(声明 brooks-review 或 builtin-quickcheck)")
|
|
166
|
+
// → 段名识别放宽后通过,无"旧格式"兼容 WARN
|
|
167
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/T01-SUMMARY.md', summaryContent({
|
|
168
|
+
method: '## 自检方法(声明 brooks-review 或 builtin-quickcheck)\n\nbrooks-review',
|
|
169
|
+
}));
|
|
170
|
+
const resVariant = runGuard(['exit', 'execute'], dir);
|
|
171
|
+
assertExit(resVariant, 0);
|
|
172
|
+
assertOut(resVariant, 'ALL CHECKS PASSED');
|
|
173
|
+
assertNotOut(resVariant, 'BROOKS-LINT WARN');
|
|
174
|
+
// 变体负例:段名匹配(含括号后缀,但括号说明不含方法词)且段内无自检方法声明
|
|
175
|
+
// → 缺自检方法 BLOCKED(六维自查也须不含方法词——全文兼容检测会命中)
|
|
176
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/T01-SUMMARY.md', summaryContent({
|
|
177
|
+
method: '## 自检方法(声明自检方法)\n\n(未声明任何方法)',
|
|
178
|
+
sixDim: '## 6 维自查\n\n- 功能: 通过\n- 性能: 无影响\n- 安全: 无影响\n- 兼容: 通过\n- 可观测: 通过\n- 可维护: 通过',
|
|
179
|
+
}));
|
|
180
|
+
const resVariantNeg = runGuard(['exit', 'execute'], dir);
|
|
181
|
+
assertExit(resVariantNeg, 1);
|
|
182
|
+
assertOut(resVariantNeg, '自检方法');
|
|
183
|
+
},
|
|
184
|
+
},
|
|
185
|
+
|
|
186
|
+
// 9: execute exit BLOCKED——6 维自查仅 "### 🟢 R1" 标题无正文
|
|
187
|
+
{
|
|
188
|
+
name: '09 execute exit BLOCKED:6 维仅 🟢 标题无实质',
|
|
189
|
+
run: (dir) => {
|
|
190
|
+
const st = baseState('execute');
|
|
191
|
+
st.evidence.execute = { summary: 'executed' };
|
|
192
|
+
st.evidence['subagent-execute'] = { handoffResult: handoffFor(['T01']) };
|
|
193
|
+
writeState(dir, st);
|
|
194
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/TASK.md', '# TASK\n\n' + TASK_DONE);
|
|
195
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/T01-SUMMARY.md', summaryContent({
|
|
196
|
+
sixDim: '## 6 维自查\n\n### 🟢 R1\n### 🟢 R2',
|
|
197
|
+
}));
|
|
198
|
+
const res = runGuard(['exit', 'execute'], dir);
|
|
199
|
+
assertExit(res, 1);
|
|
200
|
+
assertOut(res, '无实质内容');
|
|
201
|
+
},
|
|
202
|
+
},
|
|
203
|
+
|
|
204
|
+
// 10: execute exit BLOCKED——缺 ## 自检方法 且全文无 brooks-review/builtin 声明
|
|
205
|
+
{
|
|
206
|
+
name: '10 execute exit BLOCKED:缺自检方法且全文无声明',
|
|
207
|
+
run: (dir) => {
|
|
208
|
+
const st = baseState('execute');
|
|
209
|
+
st.evidence.execute = { summary: 'executed' };
|
|
210
|
+
st.evidence['subagent-execute'] = { handoffResult: handoffFor(['T01']) };
|
|
211
|
+
writeState(dir, st);
|
|
212
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/TASK.md', '# TASK\n\n' + TASK_DONE);
|
|
213
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/T01-SUMMARY.md', summaryContent({
|
|
214
|
+
sixDim: '## 6 维自查\n\n- 功能: 通过\n- 性能: 无影响\n- 安全: 无影响\n- 兼容: 通过\n- 可观测: 通过\n- 可维护: 通过',
|
|
215
|
+
method: '',
|
|
216
|
+
}));
|
|
217
|
+
const res = runGuard(['exit', 'execute'], dir);
|
|
218
|
+
assertExit(res, 1);
|
|
219
|
+
assertOut(res, '自检方法');
|
|
220
|
+
},
|
|
221
|
+
},
|
|
222
|
+
|
|
223
|
+
// 11: execute exit 兼容——旧格式无 ## 自检方法 但 6 维含 brooks-review → WARN 不 BLOCK
|
|
224
|
+
{
|
|
225
|
+
name: '11 execute exit 兼容:旧格式含 brooks-review → WARN',
|
|
226
|
+
run: (dir) => {
|
|
227
|
+
const st = baseState('execute');
|
|
228
|
+
st.evidence.execute = { summary: 'executed' };
|
|
229
|
+
st.evidence['subagent-execute'] = { handoffResult: handoffFor(['T01']) };
|
|
230
|
+
writeState(dir, st);
|
|
231
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/TASK.md', '# TASK\n\n' + TASK_DONE);
|
|
232
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/T01-SUMMARY.md', summaryContent({ method: '' }));
|
|
233
|
+
const res = runGuard(['exit', 'execute'], dir);
|
|
234
|
+
assertExit(res, 0);
|
|
235
|
+
assertOut(res, 'BROOKS-LINT WARN');
|
|
236
|
+
},
|
|
237
|
+
},
|
|
238
|
+
|
|
239
|
+
// 12: execute exit BLOCKED——TASK 签名哈希不匹配(enter 后改 action)
|
|
240
|
+
{
|
|
241
|
+
name: '12 execute exit BLOCKED:TASK 签名不匹配(enter 后改 action)',
|
|
242
|
+
run: (dir) => {
|
|
243
|
+
const st = baseState('execute');
|
|
244
|
+
st.evidence.execute = { summary: 'executed' };
|
|
245
|
+
writeState(dir, st);
|
|
246
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/TASK.md', '# TASK\n\n' + TASK_DONE);
|
|
247
|
+
// enter 记录 taskHash
|
|
248
|
+
assertExit(runGuard(['entry', 'execute'], dir), 0);
|
|
249
|
+
// enter 后改 action → 任务集签名变化
|
|
250
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/TASK.md', '# TASK\n\n' + TASK_DONE.replace('实现 T01', '实现 T01(改)'));
|
|
251
|
+
const res = runGuard(['exit', 'execute'], dir);
|
|
252
|
+
assertExit(res, 1);
|
|
253
|
+
assertOut(res, '签名不匹配');
|
|
254
|
+
},
|
|
255
|
+
},
|
|
256
|
+
|
|
257
|
+
// 13: 越俎代庖——parallel done 无 handoffResult → BLOCKED
|
|
258
|
+
{
|
|
259
|
+
name: '13 execute exit BLOCKED:parallel done 无 handoffResult(越俎代庖)',
|
|
260
|
+
run: (dir) => {
|
|
261
|
+
const st = baseState('execute');
|
|
262
|
+
st.evidence.execute = { summary: 'executed' };
|
|
263
|
+
st.evidence['subagent-execute'] = { handoffResult: handoffFor(['T01']) }; // P02 无 handoff
|
|
264
|
+
writeState(dir, st);
|
|
265
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/TASK.md', '# TASK\n\n' + TASK_DONE + TASK_P2);
|
|
266
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/T01-SUMMARY.md', summaryContent());
|
|
267
|
+
const res = runGuard(['exit', 'execute'], dir);
|
|
268
|
+
assertExit(res, 1);
|
|
269
|
+
assertOut(res, '越俎代庖');
|
|
270
|
+
},
|
|
271
|
+
},
|
|
272
|
+
|
|
273
|
+
// 14: 串行 pending 未完成 → BLOCKED
|
|
274
|
+
{
|
|
275
|
+
name: '14 execute exit BLOCKED:串行 pending 未完成',
|
|
276
|
+
run: (dir) => {
|
|
277
|
+
const st = baseState('execute');
|
|
278
|
+
st.evidence.execute = { summary: 'executed' };
|
|
279
|
+
st.evidence['subagent-execute'] = { handoffResult: handoffFor(['P02']) };
|
|
280
|
+
writeState(dir, st);
|
|
281
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/TASK.md', '# TASK\n\n' +
|
|
282
|
+
'<task id="T01" parallel="false" status="pending"><action>实现 T01</action><write_files>src/t1.mjs</write_files><verify>node --check src/t1.mjs</verify></task>\n' + TASK_P2);
|
|
283
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/T01-SUMMARY.md', summaryContent());
|
|
284
|
+
const res = runGuard(['exit', 'execute'], dir);
|
|
285
|
+
assertExit(res, 1);
|
|
286
|
+
assertOut(res, '串行 pending');
|
|
287
|
+
},
|
|
288
|
+
},
|
|
289
|
+
|
|
290
|
+
// 15: subagent-execute exit 通过(parallel 全 done + handoff 齐 + Return Contract 完整)
|
|
291
|
+
// in-place 扩展(验证隔离三态 + 派遣留痕):① 全部收工 ⇒ 放行(原断言);② 有 request 无对应
|
|
292
|
+
// result(写者未收工的既有可判形态)⇒ 新 change BLOCKED + 恢复指引 / 旧 change 渐进 WARN;
|
|
293
|
+
// ③ 无该证据对象 ⇒ 零输出(不制造噪音);④ 派遣留痕落在既有嵌套字段(零新增 state 顶层字段)
|
|
294
|
+
// 的静态锚。反向构造:把出口校验的判据从「有 request 无 result」放宽成恒空 ⇒ ② 必红。
|
|
295
|
+
{
|
|
296
|
+
name: '15 subagent-execute exit 三态(在飞委托 BLOCK·全部收工放行·无证据零输出)+ 留痕嵌套锚',
|
|
297
|
+
run: (dir) => {
|
|
298
|
+
const st = baseState('subagent-execute');
|
|
299
|
+
st.evidence['subagent-execute'] = {
|
|
300
|
+
summary: 'delegated and collected',
|
|
301
|
+
handoffResult: handoffFor(['P01', 'P02']),
|
|
302
|
+
};
|
|
303
|
+
writeState(dir, st);
|
|
304
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/TASK.md', '# TASK\n\n' + TASK_P1 + TASK_P2);
|
|
305
|
+
const res = runGuard(['exit', 'subagent-execute'], dir);
|
|
306
|
+
assertExit(res, 0);
|
|
307
|
+
assertOut(res, 'ALL CHECKS PASSED');
|
|
308
|
+
assertNotOut(res, '在飞委托');
|
|
309
|
+
|
|
310
|
+
// ①b 并行 × 零提交通过出口(AC-9):parallel done 任务的留痕为「request 记 noCommit:true +
|
|
311
|
+
// result 回传无 commitHash 的零提交契约」⇒ 出口按该资格豁免缺 commitHash,不因并行维度
|
|
312
|
+
// 而拦。判别力内建对照:同一并行任务去掉 request 的 noCommit 资格 ⇒ 必按缺 commitHash
|
|
313
|
+
// 拦截——证明豁免由资格驱动,不是并行维度的恒真形态。
|
|
314
|
+
const zeroParallelTask = '<task id="P01" status="done" parallel="true"><action>并行零提交</action>'
|
|
315
|
+
+ '<write_files>.specs/' + CHANGE_ID + '/P01-SUMMARY.md</write_files><verify>echo ok</verify></task>\n';
|
|
316
|
+
const zeroParallelResult = (taskId) => ({
|
|
317
|
+
result: {
|
|
318
|
+
status: 'DONE', taskId, noCommit: true,
|
|
319
|
+
completedChecks: ['required-skill:subagent-execute.flow-comet-dev'],
|
|
320
|
+
redEvidence: { command: 'echo ok' },
|
|
321
|
+
greenEvidence: { command: 'echo ok', output: 'ok' },
|
|
322
|
+
},
|
|
323
|
+
});
|
|
324
|
+
const zeroParallel = { ...baseState('subagent-execute') };
|
|
325
|
+
zeroParallel.evidence['subagent-execute'] = {
|
|
326
|
+
summary: 'parallel zero-commit task collected',
|
|
327
|
+
handoffRequests: { P01: { writeFiles: ['.specs/' + CHANGE_ID + '/P01-SUMMARY.md'], noCommit: true } },
|
|
328
|
+
handoffResult: { P01: zeroParallelResult('P01') },
|
|
329
|
+
};
|
|
330
|
+
writeState(dir, zeroParallel);
|
|
331
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/TASK.md', '# TASK\n\n' + zeroParallelTask);
|
|
332
|
+
const zeroParallelExit = runGuard(['exit', 'subagent-execute'], dir);
|
|
333
|
+
assertExit(zeroParallelExit, 0);
|
|
334
|
+
assertNotOut(zeroParallelExit, '缺 commitHash');
|
|
335
|
+
const unqualifiedParallel = JSON.parse(JSON.stringify(zeroParallel));
|
|
336
|
+
delete unqualifiedParallel.evidence['subagent-execute'].handoffRequests.P01.noCommit;
|
|
337
|
+
writeState(dir, unqualifiedParallel);
|
|
338
|
+
const unqualifiedExit = runGuard(['exit', 'subagent-execute'], dir);
|
|
339
|
+
assertExit(unqualifiedExit, 1);
|
|
340
|
+
assertOut(unqualifiedExit, '缺 commitHash');
|
|
341
|
+
|
|
342
|
+
// ② 在飞委托(有 request 无对应 result)⇒ 新 change BLOCKED,报文点名未收工任务并给恢复指引
|
|
343
|
+
const inFlight = { ...baseState('subagent-execute'), newChange: true };
|
|
344
|
+
inFlight.enteredNodes = ['subagent-execute'];
|
|
345
|
+
inFlight.evidence['subagent-execute'] = {
|
|
346
|
+
summary: 'delegated, one writer still running',
|
|
347
|
+
handoffRequests: {
|
|
348
|
+
P01: { writeFiles: ['src/p1.mjs'] },
|
|
349
|
+
P03: { writeFiles: ['src/p3.mjs'] },
|
|
350
|
+
},
|
|
351
|
+
handoffResult: handoffFor(['P01']),
|
|
352
|
+
};
|
|
353
|
+
writeState(dir, inFlight);
|
|
354
|
+
const blocked = runGuard(['exit', 'subagent-execute'], dir);
|
|
355
|
+
assertExit(blocked, 1);
|
|
356
|
+
assertOut(blocked, '在飞委托');
|
|
357
|
+
assertOut(blocked, '待写入者收工后重跑');
|
|
358
|
+
assertOut(blocked, 'P03');
|
|
359
|
+
assertNotOut(blocked, 'P01(');
|
|
360
|
+
// ②b 旧 change 同形态 ⇒ 渐进 WARN 不阻断(向后兼容硬约束),指引仍在
|
|
361
|
+
const inFlightOld = { ...inFlight };
|
|
362
|
+
delete inFlightOld.newChange;
|
|
363
|
+
writeState(dir, inFlightOld);
|
|
364
|
+
const warned = runGuard(['exit', 'subagent-execute'], dir);
|
|
365
|
+
assertExit(warned, 0);
|
|
366
|
+
assertOut(warned, 'WARN');
|
|
367
|
+
assertOut(warned, '在飞委托');
|
|
368
|
+
assertOut(warned, '待写入者收工后重跑');
|
|
369
|
+
// ③ 无该证据对象(从未进入委托节点)⇒ 零输出:判据不得在无证据形态下制造噪音
|
|
370
|
+
const noEvidence = { ...baseState('subagent-execute') };
|
|
371
|
+
noEvidence.evidence = {};
|
|
372
|
+
writeState(dir, noEvidence);
|
|
373
|
+
const silent = runGuard(['exit', 'subagent-execute'], dir);
|
|
374
|
+
assertNotOut(silent, '在飞委托');
|
|
375
|
+
assertNotOut(silent, '待写入者收工后重跑');
|
|
376
|
+
|
|
377
|
+
// ②c 撤回通道(在飞委托族的 in-place 扩展):被遗弃的 request 可经受支持接口撤回——撤回在
|
|
378
|
+
// **原记录**上加法式落留痕(withdrawnAt 时间戳 + withdrawnBy 来源),守卫按同一判据把已撤回
|
|
379
|
+
// 的 request 移出在飞集合 ⇒ 出口放行;记录本身不删除(历史留痕),重新委托时撤回落痕转入
|
|
380
|
+
// previousWithdrawals 而非被静默丢弃。已撤回 = **终态**:重复撤回被拒、撤回后 result 被拒。
|
|
381
|
+
// 判据要求留痕**两字段齐备**才成立(只写时间戳的手改形态仍按在飞处理——fail-closed)。
|
|
382
|
+
// 反向构造:守卫不忽略已撤回的 request ⇒ ②c-3 必红;判据只看单一字段 ⇒ ②c-6 必红。
|
|
383
|
+
const withdrawRequests = () => ({
|
|
384
|
+
P01: { writeFiles: ['src/p1.mjs'] },
|
|
385
|
+
P02: { writeFiles: ['src/p2.mjs'], requestedAt: '2026-10-07T00:00:00.000Z' },
|
|
386
|
+
});
|
|
387
|
+
const withdrawCase = { ...baseState('subagent-execute'), newChange: true };
|
|
388
|
+
withdrawCase.enteredNodes = ['subagent-execute'];
|
|
389
|
+
withdrawCase.evidence['subagent-execute'] = {
|
|
390
|
+
summary: 'delegated, one request abandoned',
|
|
391
|
+
handoffRequests: withdrawRequests(),
|
|
392
|
+
handoffResult: handoffFor(['P01']),
|
|
393
|
+
};
|
|
394
|
+
writeState(dir, withdrawCase);
|
|
395
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/TASK.md', '# TASK\n\n' + TASK_P1 + TASK_P2);
|
|
396
|
+
// 严格形态(newChange:true)下 done 任务须有对应 SUMMARY——补两份,使「撤回 ⇒ 出口放行」
|
|
397
|
+
// 的断言落在**唯一**阻塞点(在飞委托)上,而不是被无关门禁干扰。
|
|
398
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/P01-SUMMARY.md', strictSummary('P01'));
|
|
399
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/P02-SUMMARY.md', strictSummary('P02'));
|
|
400
|
+
// ②c-0 撤回前:P02 在飞 ⇒ 出口拦(撤回通道的必要性前提 + 恢复指引点名该命令)
|
|
401
|
+
const beforeWithdraw = runGuard(['exit', 'subagent-execute'], dir);
|
|
402
|
+
assertExit(beforeWithdraw, 1);
|
|
403
|
+
assertOut(beforeWithdraw, 'P02');
|
|
404
|
+
assertOut(beforeWithdraw, 'workflow-handoff.mjs withdraw');
|
|
405
|
+
// ②c-0b 前置拒绝(适用面自洽):P01 已收工(handoffResult 在场)⇒ 撤回被拒(非零退出 + 报文
|
|
406
|
+
// 写清为何拒 + 恢复指引),且 state 字节零改写(不落留痕、不动既有 request / result——
|
|
407
|
+
// 撤回的适用面是「在飞且被遗弃的 request」,与动作自述一致)。
|
|
408
|
+
// 反向构造:把该前置拒绝去掉 ⇒「撤回已收工的委托」又变 exit 0,本格必红。
|
|
409
|
+
const bytesBeforeCompletedWithdraw = readStateBytes(dir);
|
|
410
|
+
const completedWithdraw = runHandoff(['withdraw', 'P01', '--by', 'user'], dir);
|
|
411
|
+
assertExit(completedWithdraw, 1);
|
|
412
|
+
assertOut(completedWithdraw, '已收工');
|
|
413
|
+
assertOut(completedWithdraw, 'handoffResult 在场');
|
|
414
|
+
assertOut(completedWithdraw, '撤回只适用于被遗弃的 request');
|
|
415
|
+
assertOut(completedWithdraw, '恢复:');
|
|
416
|
+
assertNotOut(completedWithdraw, 'HANDOFF WITHDRAW');
|
|
417
|
+
assertStateBytesUnchanged(dir, bytesBeforeCompletedWithdraw, '撤回已收工的委托被拒');
|
|
418
|
+
// ②c-1 真实 CLI 撤回:缺 --by 先被拒(留痕来源不可缺省)⇒ 补齐后撤回成功
|
|
419
|
+
const noBy = runHandoff(['withdraw', 'P02'], dir);
|
|
420
|
+
assertExit(noBy, 1);
|
|
421
|
+
assertOut(noBy, '--by');
|
|
422
|
+
const withdrawn = runHandoff(['withdraw', 'P02', '--by', 'coordinator', '--reason', '零提交复验失败后作废'], dir);
|
|
423
|
+
assertExit(withdrawn, 0);
|
|
424
|
+
assertOut(withdrawn, 'HANDOFF WITHDRAW: P02');
|
|
425
|
+
assertOut(withdrawn, 'withdrawnAt=');
|
|
426
|
+
// ②c-2 留痕在场且历史不删:撤回两字段齐备,原 request 字段(writeFiles / requestedAt)原样保留
|
|
427
|
+
const stWithdrawn = JSON.parse(readStateBytes(dir));
|
|
428
|
+
const p02Withdrawn = stWithdrawn.evidence['subagent-execute'].handoffRequests.P02;
|
|
429
|
+
if (typeof p02Withdrawn.withdrawnAt !== 'string' || p02Withdrawn.withdrawnAt.trim() === '') {
|
|
430
|
+
throw new Error('撤回应落 withdrawnAt 时间戳: ' + JSON.stringify(p02Withdrawn));
|
|
431
|
+
}
|
|
432
|
+
// 时间纪律:新写入路径走 time-utils 单一权威 ⇒ 标准形态为本地时间 + 显式偏移;裸 Z 形态
|
|
433
|
+
// (自行拼接的产物)在此必红,且 298 的白名单代数会同时漂移(两条判据互相印证)。
|
|
434
|
+
if (!/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}[+-]\d{2}:\d{2}$/.test(p02Withdrawn.withdrawnAt)) {
|
|
435
|
+
throw new Error('withdrawnAt 应为标准形态(本地时间 + 显式偏移,走 time-utils 的 nowTimestamp): '
|
|
436
|
+
+ JSON.stringify(p02Withdrawn.withdrawnAt));
|
|
437
|
+
}
|
|
438
|
+
if (Number.isNaN(timeUtilsModule.parseTimestamp(p02Withdrawn.withdrawnAt))) {
|
|
439
|
+
throw new Error('withdrawnAt 应可被时间单一权威解析: ' + JSON.stringify(p02Withdrawn.withdrawnAt));
|
|
440
|
+
}
|
|
441
|
+
if (p02Withdrawn.withdrawnBy !== 'coordinator') {
|
|
442
|
+
throw new Error('撤回应落 withdrawnBy 来源: ' + JSON.stringify(p02Withdrawn));
|
|
443
|
+
}
|
|
444
|
+
if (p02Withdrawn.withdrawReason !== '零提交复验失败后作废') {
|
|
445
|
+
throw new Error('撤回原因应留痕: ' + JSON.stringify(p02Withdrawn));
|
|
446
|
+
}
|
|
447
|
+
if (!Array.isArray(p02Withdrawn.writeFiles) || p02Withdrawn.writeFiles[0] !== 'src/p2.mjs'
|
|
448
|
+
|| p02Withdrawn.requestedAt !== '2026-10-07T00:00:00.000Z') {
|
|
449
|
+
throw new Error('撤回不得删除原 request 字段(writeFiles / requestedAt 应原样保留): ' + JSON.stringify(p02Withdrawn));
|
|
450
|
+
}
|
|
451
|
+
// ②c-3 撤回后 ⇒ 出口放行(守卫忽略已撤回的 request;同一出口、同一 state 其余字段不变)
|
|
452
|
+
const afterWithdraw = runGuard(['exit', 'subagent-execute'], dir);
|
|
453
|
+
assertExit(afterWithdraw, 0);
|
|
454
|
+
assertOut(afterWithdraw, 'ALL CHECKS PASSED');
|
|
455
|
+
assertNotOut(afterWithdraw, '在飞委托');
|
|
456
|
+
// ②c-4 终态之一:重复撤回被拒,且不改写既有留痕
|
|
457
|
+
const withdrawAgain = runHandoff(['withdraw', 'P02', '--by', 'coordinator'], dir);
|
|
458
|
+
assertExit(withdrawAgain, 1);
|
|
459
|
+
assertOut(withdrawAgain, '终态');
|
|
460
|
+
const stAfterAgain = JSON.parse(readStateBytes(dir));
|
|
461
|
+
if (stAfterAgain.evidence['subagent-execute'].handoffRequests.P02.withdrawnAt !== p02Withdrawn.withdrawnAt) {
|
|
462
|
+
throw new Error('重复撤回不得改写既有撤回留痕');
|
|
463
|
+
}
|
|
464
|
+
// ②c-5 终态之二:已撤回的 request 不再接受 result(撤回语义不被事后「复活」绕过)
|
|
465
|
+
const resultAfterWithdraw = runHandoff(['result', 'P02', '{"commitHash":"deadbee","completedChecks":[]}'], dir);
|
|
466
|
+
assertExit(resultAfterWithdraw, 1);
|
|
467
|
+
assertOut(resultAfterWithdraw, '已撤回(终态)');
|
|
468
|
+
// ②c-6 判据要求留痕两字段齐备:抽掉 withdrawnBy(手改形态)⇒ 重新计为在飞委托 ⇒ 出口回收
|
|
469
|
+
const strippedWithdraw = JSON.parse(readStateBytes(dir));
|
|
470
|
+
delete strippedWithdraw.evidence['subagent-execute'].handoffRequests.P02.withdrawnBy;
|
|
471
|
+
writeState(dir, strippedWithdraw);
|
|
472
|
+
const restripped = runGuard(['exit', 'subagent-execute'], dir);
|
|
473
|
+
assertExit(restripped, 1);
|
|
474
|
+
assertOut(restripped, '在飞委托');
|
|
475
|
+
// ②c-7 撤回 → 重新委托:撤回落痕转入 previousWithdrawals,不被静默丢弃
|
|
476
|
+
// (先补回 ②c-6 抽掉的来源字段——那一抽是为验证判据要求两字段齐备,不是状态终态)
|
|
477
|
+
strippedWithdraw.evidence['subagent-execute'].handoffRequests.P02.withdrawnBy = 'coordinator';
|
|
478
|
+
writeState(dir, strippedWithdraw);
|
|
479
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/.skill-loads/subagent-execute-flow-comet-dev.json',
|
|
480
|
+
JSON.stringify({ node: 'subagent-execute', skill: 'flow-comet-dev', at: '2026-10-07T00:00:00.000Z' }, null, 2) + '\n');
|
|
481
|
+
assertExit(runHandoff(['request', 'P02', '重新委托 P02', '--write-files', 'src/p2.mjs'], dir), 0);
|
|
482
|
+
const stReRequest = JSON.parse(readStateBytes(dir));
|
|
483
|
+
const p02ReRequested = stReRequest.evidence['subagent-execute'].handoffRequests.P02;
|
|
484
|
+
if (p02ReRequested.withdrawnAt !== undefined) {
|
|
485
|
+
throw new Error('重新委托应重置当前态(withdrawnAt 不得残留在当前字段): ' + JSON.stringify(p02ReRequested));
|
|
486
|
+
}
|
|
487
|
+
if (!Array.isArray(p02ReRequested.previousWithdrawals) || p02ReRequested.previousWithdrawals.length !== 1
|
|
488
|
+
|| p02ReRequested.previousWithdrawals[0].withdrawnBy !== 'coordinator') {
|
|
489
|
+
throw new Error('重新委托不得静默丢弃撤回落痕(应转入 previousWithdrawals): ' + JSON.stringify(p02ReRequested));
|
|
490
|
+
}
|
|
491
|
+
// ②c-8 撤回只作用于已记录的 request:未知任务被拒、不新建记录
|
|
492
|
+
const withdrawUnknown = runHandoff(['withdraw', 'P99', '--by', 'coordinator'], dir);
|
|
493
|
+
assertExit(withdrawUnknown, 1);
|
|
494
|
+
assertOut(withdrawUnknown, '无对应 request 记录');
|
|
495
|
+
// ②c-9 前置拒绝的边界(与守卫同一把尺子):handoffResult 的**显式 null 占位**读作未收工——
|
|
496
|
+
// 守卫的两处消费方(在飞判据按 undefined / null,越俎代庖检测按 falsy)都把它读作
|
|
497
|
+
// 「无结果」,故撤回仍可用,不给「出口拦 + 撤回拒」留下无出口的死角
|
|
498
|
+
// (真实链路:先 request,再落空占位,再撤回)。
|
|
499
|
+
assertExit(runHandoff(['request', 'P03', '遗弃的在飞委托', '--write-files', 'src/p3.mjs'], dir), 0);
|
|
500
|
+
const nullPlaceholderState = JSON.parse(readStateBytes(dir));
|
|
501
|
+
nullPlaceholderState.evidence['subagent-execute'].handoffResult.P03 = null;
|
|
502
|
+
writeState(dir, nullPlaceholderState);
|
|
503
|
+
const nullPlaceholderWithdraw = runHandoff(['withdraw', 'P03', '--by', 'coordinator'], dir);
|
|
504
|
+
assertExit(nullPlaceholderWithdraw, 0);
|
|
505
|
+
assertOut(nullPlaceholderWithdraw, 'HANDOFF WITHDRAW: P03');
|
|
506
|
+
|
|
507
|
+
// ④ 派遣留痕的静态锚(零新增 state 顶层字段):留痕只允许落在既有嵌套字段
|
|
508
|
+
// evidence['subagent-execute'] 下——引擎脚本不得出现顶层留痕键赋值;受检面 = **引擎实现面**
|
|
509
|
+
//(入口 ∪ `lib/**`,递归,由模块图派生——迁移到 `lib/` 的写盘路径不再掉出受检面);
|
|
510
|
+
// 顶层字段清单以状态字段校验器为单一来源(新增顶层字段必须先过校验器,否则本锚即红)。
|
|
511
|
+
const engineSources = Object.fromEntries(engineScriptFiles()
|
|
512
|
+
.map((script) => [script, fs.readFileSync(path.join(SCRIPTS_DIR, script), 'utf8')]));
|
|
513
|
+
const traceShapeProblems = ({ scripts, handoff, schema }) => {
|
|
514
|
+
const out = [];
|
|
515
|
+
const topLevelTraceWriteRe = /\bstate\.(handoffRequests|handoffResult|delegationTrace|dispatchTrace|delegations)\b/;
|
|
516
|
+
for (const [script, src] of Object.entries(scripts)) {
|
|
517
|
+
const hit = src.match(topLevelTraceWriteRe);
|
|
518
|
+
if (hit) {
|
|
519
|
+
out.push(script + ' 出现留痕键的顶层形态「' + hit[0] + '」——留痕必须落在 evidence 嵌套字段(零新增 state 顶层字段)');
|
|
520
|
+
}
|
|
521
|
+
}
|
|
522
|
+
if (!handoff.includes("state.evidence['subagent-execute'].handoffRequests")) {
|
|
523
|
+
out.push('留痕未落在嵌套证据字段(既有同族形态)——顶层字段禁令的正面锚缺失');
|
|
524
|
+
}
|
|
525
|
+
const declaredFields = [...schema.matchAll(/\{ field: '([A-Za-z_$][\w$]*)'/g)].map((m) => m[1]);
|
|
526
|
+
for (const traceKey of ['handoffRequests', 'handoffResult', 'delegationTrace', 'dispatchTrace']) {
|
|
527
|
+
if (declaredFields.includes(traceKey)) {
|
|
528
|
+
out.push('状态字段校验器声明了留痕顶层字段「' + traceKey + '」(应保持嵌套、零新增顶层字段)');
|
|
529
|
+
}
|
|
530
|
+
}
|
|
531
|
+
const writtenTopLevel = [...handoff.matchAll(/\bstate\.([A-Za-z_$][\w$]*)\s*=/g)].map((m) => m[1]);
|
|
532
|
+
const undeclared = [...new Set(writtenTopLevel)].filter((key) => !declaredFields.includes(key));
|
|
533
|
+
if (undeclared.length > 0) {
|
|
534
|
+
out.push('workflow-handoff.mjs 写入了未在状态字段校验器声明的顶层字段: ' + undeclared.join(', '));
|
|
535
|
+
}
|
|
536
|
+
return out;
|
|
537
|
+
};
|
|
538
|
+
const handoffSource = engineSources['workflow-handoff.mjs'];
|
|
539
|
+
const schemaSource = engineSources['state-schema.mjs'];
|
|
540
|
+
const traceSources = { scripts: engineSources, handoff: handoffSource, schema: schemaSource };
|
|
541
|
+
for (const problem of traceShapeProblems(traceSources)) throw new Error(problem);
|
|
542
|
+
// 反向构造(同一判据驱动):逐项注入退化形态 ⇒ 必报(判据不恒真空过)。
|
|
543
|
+
const traceProbes = [
|
|
544
|
+
['留痕键顶层赋值注入', {
|
|
545
|
+
scripts: { ...engineSources, 'workflow-handoff.mjs': handoffSource + '\nstate.delegationTrace = {};\n' },
|
|
546
|
+
handoff: handoffSource + '\nstate.delegationTrace = {};\n',
|
|
547
|
+
}, '顶层形态'],
|
|
548
|
+
['嵌套落点改顶层', { handoff: handoffSource.replaceAll("state.evidence['subagent-execute'].handoffRequests", 'state.handoffRequests') }, '留痕未落在嵌套证据字段'],
|
|
549
|
+
['校验器声明留痕顶层字段', { schema: schemaSource.replace('export const STATE_FIELD_VALIDATORS = [', "export const STATE_FIELD_VALIDATORS = [\n { field: 'delegationTrace', check: () => true },") }, '声明了留痕顶层字段'],
|
|
550
|
+
['未声明顶层字段写入', { handoff: handoffSource + '\nstate.undeclaredProbe = 1;\n' }, '未在状态字段校验器声明'],
|
|
551
|
+
];
|
|
552
|
+
for (const [probeLabel, override, expected] of traceProbes) {
|
|
553
|
+
const probed = { ...traceSources, ...override };
|
|
554
|
+
if (!traceShapeProblems(probed).some((p) => p.includes(expected))) {
|
|
555
|
+
throw new Error('反向构造判别力缺失(' + probeLabel + ' 未被判违规)');
|
|
556
|
+
}
|
|
557
|
+
}
|
|
558
|
+
},
|
|
559
|
+
},
|
|
560
|
+
|
|
561
|
+
// 16: entry execute——未 commit 工件存在(git 仓库)→ WORKTREE WARN 不 BLOCK
|
|
562
|
+
{
|
|
563
|
+
name: '16 entry execute:未 commit 工件 → WORKTREE WARN',
|
|
564
|
+
run: (dir) => {
|
|
565
|
+
execFileSync('git', ['init', '-q'], { cwd: dir, stdio: 'ignore' });
|
|
566
|
+
const st = baseState('execute');
|
|
567
|
+
writeState(dir, st);
|
|
568
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/CHANGE.md', '# CHANGE\n\n## Why\n');
|
|
569
|
+
const res = runGuard(['entry', 'execute'], dir);
|
|
570
|
+
assertExit(res, 0);
|
|
571
|
+
assertOut(res, 'WORKTREE WARN');
|
|
572
|
+
},
|
|
573
|
+
},
|
|
574
|
+
|
|
575
|
+
// 17: entry execute——PROGRESS.md 存在 → WARNING(清窗恢复产物)
|
|
576
|
+
{
|
|
577
|
+
name: '17 entry execute:PROGRESS.md 存在 → WARNING',
|
|
578
|
+
run: (dir) => {
|
|
579
|
+
const st = baseState('execute');
|
|
580
|
+
writeState(dir, st);
|
|
581
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/PROGRESS.md', '# PROGRESS\n\n已排除方案: 无\n');
|
|
582
|
+
const res = runGuard(['entry', 'execute'], dir);
|
|
583
|
+
assertExit(res, 0);
|
|
584
|
+
assertOut(res, 'PROGRESS.md 存在');
|
|
585
|
+
},
|
|
586
|
+
},
|
|
587
|
+
|
|
588
|
+
// ---------- 分组场景(分支校验 + 追加位置检测) ----------
|
|
589
|
+
|
|
590
|
+
// 18: entry archive 分支校验 BLOCKED(branchMode=true + activeChange + 当前分支非 change/<id>)
|
|
591
|
+
// 注意:需初始 commit——unborn HEAD 下 git rev-parse --abbrev-ref HEAD 失败(按规格"失败跳过"不触发校验)
|
|
592
|
+
{
|
|
593
|
+
name: '18 entry archive BLOCKED:分支不是 change/<id>(branchMode)',
|
|
594
|
+
run: (dir) => {
|
|
595
|
+
execFileSync('git', ['init', '-q'], { cwd: dir, stdio: 'ignore' });
|
|
596
|
+
execFileSync('git', ['-c', 'user.name=t', '-c', 'user.email=t@t', 'commit', '--allow-empty', '-m', 'init'], { cwd: dir, stdio: 'ignore' });
|
|
597
|
+
const st = baseState('archive');
|
|
598
|
+
st.branchMode = true;
|
|
599
|
+
writeState(dir, st);
|
|
600
|
+
const res = runGuard(['entry', 'archive'], dir);
|
|
601
|
+
assertExit(res, 1);
|
|
602
|
+
assertOut(res, 'BLOCKED');
|
|
603
|
+
assertOut(res, '归档必须在 change/' + CHANGE_ID + ' 分支上进行');
|
|
604
|
+
},
|
|
605
|
+
},
|
|
606
|
+
|
|
607
|
+
// 19: entry archive 通过(当前分支 change/<id>)
|
|
608
|
+
{
|
|
609
|
+
name: '19 entry archive 通过:当前分支 change/<id>',
|
|
610
|
+
run: (dir) => {
|
|
611
|
+
execFileSync('git', ['init', '-q'], { cwd: dir, stdio: 'ignore' });
|
|
612
|
+
execFileSync('git', ['-c', 'user.name=t', '-c', 'user.email=t@t', 'commit', '--allow-empty', '-m', 'init'], { cwd: dir, stdio: 'ignore' });
|
|
613
|
+
execFileSync('git', ['checkout', '-b', 'change/' + CHANGE_ID], { cwd: dir, stdio: 'ignore' });
|
|
614
|
+
const st = baseState('archive');
|
|
615
|
+
st.branchMode = true;
|
|
616
|
+
writeState(dir, st);
|
|
617
|
+
const res = runGuard(['entry', 'archive'], dir);
|
|
618
|
+
assertExit(res, 0);
|
|
619
|
+
assertOut(res, 'ENTRY OK: archive');
|
|
620
|
+
},
|
|
621
|
+
},
|
|
622
|
+
|
|
623
|
+
// 20: exit open——CONTEXT.md 孤立追加段 → WARN 不 BLOCK
|
|
624
|
+
{
|
|
625
|
+
name: '20 exit open WARN:CONTEXT.md 孤立追加段',
|
|
626
|
+
run: (dir) => {
|
|
627
|
+
const st = baseState('open');
|
|
628
|
+
st.evidence.open = { summary: 'intake complete' };
|
|
629
|
+
writeState(dir, st);
|
|
630
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/CHANGE.md', '# CHANGE\n\n## Why\n');
|
|
631
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/REQUIREMENT.md', '# REQUIREMENT\n\n## 用户故事\n\n## 验收准则(AC)\n');
|
|
632
|
+
writeFile(dir, '.specs/CONTEXT.md', '# CONTEXT\n\n## 术语(test-change 追加)\n\n某术语\n');
|
|
633
|
+
const res = runGuard(['exit', 'open'], dir);
|
|
634
|
+
assertExit(res, 0);
|
|
635
|
+
assertOut(res, 'WARN: CONTEXT.md 检测到孤立追加段');
|
|
636
|
+
},
|
|
637
|
+
},
|
|
638
|
+
|
|
639
|
+
// 21: exit verify——LESSONS.md 条目编号乱序 → WARN 不 BLOCK;verify 命令 timeout 可配置:
|
|
640
|
+
// ① 缺省 timeout(无 env)下耗时命令通过(缺省保持大值);② env
|
|
641
|
+
// FLOW_COMET_VERIFY_TIMEOUT_MS 覆盖生效——设小值后同耗时命令超时 BLOCK
|
|
642
|
+
{
|
|
643
|
+
name: '21 exit verify WARN:LESSONS.md 编号乱序 + verify timeout env 覆盖',
|
|
644
|
+
run: (dir) => {
|
|
645
|
+
const st = baseState('verify');
|
|
646
|
+
st.evidence.verify = { summary: 'verified' };
|
|
647
|
+
writeState(dir, st);
|
|
648
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/TEST.md', '# TEST\n\n## 验证命令\n\n```bash\nnode -e "1"\n```\n');
|
|
649
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/UAT.md', '# UAT\n\n通过\n');
|
|
650
|
+
writeFile(dir, '.specs/LESSONS.md', '# LESSONS\n\n## 条目区\n\n### L-002: b\n### L-001: a\n');
|
|
651
|
+
const res = runGuard(['exit', 'verify'], dir);
|
|
652
|
+
assertExit(res, 0);
|
|
653
|
+
assertOut(res, 'WARN: LESSONS.md 条目编号乱序');
|
|
654
|
+
// 子断言:无区外条目时不得打印"条目在条目区外"WARN(误报修复——修复前
|
|
655
|
+
// console.error 在 if(outside) 之外无条件执行,每次 exit 都刷一条空 WARN)
|
|
656
|
+
assertNotOut(res, '条目在条目区外');
|
|
657
|
+
// 子断言:## 验证命令 段标题带括号后缀(与 ## 自检方法 段括号后缀兼容风格一致)不误 BLOCK
|
|
658
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/TEST.md', '# TEST\n\n## 验证命令(必填 · exit verify 真实执行)\n\n```bash\nnode -e "1"\n```\n');
|
|
659
|
+
const resBracket = runGuard(['exit', 'verify'], dir);
|
|
660
|
+
assertExit(resBracket, 0);
|
|
661
|
+
assertOut(resBracket, 'ALL CHECKS PASSED');
|
|
662
|
+
// ① 缺省 timeout(未设 env)保持大值:1.5s 耗时命令通过(若缺省被误改小 → 超时 RED)
|
|
663
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/TEST.md', '# TEST\n\n## 验证命令\n\n```bash\nnode -e "setTimeout(()=>{}, 1500)"\n```\n');
|
|
664
|
+
const resDefault = runGuard(['exit', 'verify'], dir);
|
|
665
|
+
assertExit(resDefault, 0);
|
|
666
|
+
assertOut(resDefault, 'ALL CHECKS PASSED');
|
|
667
|
+
// ② env 覆盖生效:FLOW_COMET_VERIFY_TIMEOUT_MS=500 时 1.5s 命令超时 → BLOCKED
|
|
668
|
+
// (不设 env 时同命令走缺省 300s 会通过——env 覆盖被忽略即 RED)
|
|
669
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/TEST.md', '# TEST\n\n## 验证命令\n\n```bash\nnode -e "setTimeout(()=>{}, 1500)"\n```\n');
|
|
670
|
+
const resEnv = runGuard(['exit', 'verify'], dir, { FLOW_COMET_VERIFY_TIMEOUT_MS: '500' });
|
|
671
|
+
// 超时 kill 的 cmd 孙进程(node)孤儿化后短暂存活,其 cwd 锁定场景目录
|
|
672
|
+
// (Windows:父 cmd 被杀、孙进程继续跑完自身定时器)——在断言前同步等待其
|
|
673
|
+
// 自然退出,避免场景收尾 rmSync 因目录被占用而失败(EPERM/EBUSY)
|
|
674
|
+
execFileSync(process.execPath, ['-e', 'setTimeout(()=>{}, 2000)']);
|
|
675
|
+
assertExit(resEnv, 1);
|
|
676
|
+
assertOut(resEnv, 'BLOCKED: verify 命令失败');
|
|
677
|
+
assertOut(resEnv, 'timeout 500ms');
|
|
678
|
+
// 子断言:失败计数按 change 写入(guard 侧递增语义)
|
|
679
|
+
const stFail = JSON.parse(fs.readFileSync(path.join(dir, '.flow-comet', 'flow-comet-state.json'), 'utf8'));
|
|
680
|
+
if (!stFail.verifyFailuresByChange || stFail.verifyFailuresByChange[CHANGE_ID] !== 1) {
|
|
681
|
+
throw new Error('exit verify 失败计数未按 change 写入: ' + JSON.stringify(stFail.verifyFailuresByChange));
|
|
682
|
+
}
|
|
683
|
+
// 子断言:再次失败递增(2/3);恢复快速命令后 exit --apply 成功清零当前 change
|
|
684
|
+
const resEnv2 = runGuard(['exit', 'verify'], dir, { FLOW_COMET_VERIFY_TIMEOUT_MS: '500' });
|
|
685
|
+
execFileSync(process.execPath, ['-e', 'setTimeout(()=>{}, 2000)']);
|
|
686
|
+
assertExit(resEnv2, 1);
|
|
687
|
+
const stFail2 = JSON.parse(fs.readFileSync(path.join(dir, '.flow-comet', 'flow-comet-state.json'), 'utf8'));
|
|
688
|
+
if (!stFail2.verifyFailuresByChange || stFail2.verifyFailuresByChange[CHANGE_ID] !== 2) {
|
|
689
|
+
throw new Error('exit verify 失败计数未递增: ' + JSON.stringify(stFail2.verifyFailuresByChange));
|
|
690
|
+
}
|
|
691
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/TEST.md', '# TEST\n\n## 验证命令\n\n```bash\nnode -e "1"\n```\n');
|
|
692
|
+
// AC-5 隔离:verify 成功只清 verify 计数,不得清 Fix 归位轮次(预置计数,成功出口后核对)
|
|
693
|
+
const stBeforePass = JSON.parse(fs.readFileSync(path.join(dir, '.flow-comet', 'flow-comet-state.json'), 'utf8'));
|
|
694
|
+
stBeforePass.fixRoundsByChange = { ...(stBeforePass.fixRoundsByChange || {}), [CHANGE_ID]: 2 };
|
|
695
|
+
fs.writeFileSync(path.join(dir, '.flow-comet', 'flow-comet-state.json'), JSON.stringify(stBeforePass, null, 2) + '\n');
|
|
696
|
+
const resPass = runGuard(['exit', 'verify', '--apply'], dir);
|
|
697
|
+
assertExit(resPass, 0);
|
|
698
|
+
const stPass = JSON.parse(fs.readFileSync(path.join(dir, '.flow-comet', 'flow-comet-state.json'), 'utf8'));
|
|
699
|
+
if (!stPass.verifyFailuresByChange || stPass.verifyFailuresByChange[CHANGE_ID] !== 0) {
|
|
700
|
+
throw new Error('exit verify 成功未清零当前 change 计数: ' + JSON.stringify(stPass.verifyFailuresByChange));
|
|
701
|
+
}
|
|
702
|
+
if (stPass.fixRoundsByChange?.[CHANGE_ID] !== 2) {
|
|
703
|
+
throw new Error('exit verify 成功不得清 Fix 归位轮次(计数隔离): '
|
|
704
|
+
+ JSON.stringify(stPass.fixRoundsByChange));
|
|
705
|
+
}
|
|
706
|
+
},
|
|
707
|
+
},
|
|
708
|
+
|
|
709
|
+
// 22: exit archive——CHANGELOG.md 表格日期非倒序 → WARN 不 BLOCK;
|
|
710
|
+
// 子断言:归档缺 KNOWN-ISSUES.md(遗留清单,协议 required 产物)→ BLOCKED
|
|
711
|
+
{
|
|
712
|
+
name: '22 exit archive WARN:CHANGELOG.md 表格日期非倒序',
|
|
713
|
+
run: (dir) => {
|
|
714
|
+
const st = baseState('archive');
|
|
715
|
+
st.evidence.archive = { summary: 'archived' };
|
|
716
|
+
writeState(dir, st);
|
|
717
|
+
writeFile(dir, '.specs/archive/foo-' + CHANGE_ID + '/CHANGE.md', '# CHANGE\n\n## Why\n');
|
|
718
|
+
writeFile(dir, '.specs/archive/foo-' + CHANGE_ID + '/KNOWN-ISSUES.md', '# KNOWN-ISSUES\n\n无遗留问题\n');
|
|
719
|
+
writeFile(dir, '.specs/CHANGELOG.md', '# CHANGELOG\n\n| 日期 | 说明 |\n|------|------|\n| 2026-08-03 | a |\n| 2026-08-04 | b |\n');
|
|
720
|
+
const res = runGuard(['exit', 'archive'], dir);
|
|
721
|
+
assertExit(res, 0);
|
|
722
|
+
assertOut(res, 'WARN: CHANGELOG.md 表格日期非倒序');
|
|
723
|
+
// 子断言:CHANGELOG 未登记本 change → WARN 渐进(归档收尾登记兜底——
|
|
724
|
+
// 修复前无检测,执行者遗漏登记可静默进归档,此处应 RED)
|
|
725
|
+
assertOut(res, '未登记本 change');
|
|
726
|
+
// 子断言:登记后无未登记 WARN
|
|
727
|
+
writeFile(dir, '.specs/CHANGELOG.md', '# CHANGELOG\n\n| 日期 | 说明 |\n|------|------|\n| 2026-08-15 | ' + CHANGE_ID + ' | 归档登记 |\n');
|
|
728
|
+
const resRegistered = runGuard(['exit', 'archive'], dir);
|
|
729
|
+
assertExit(resRegistered, 0);
|
|
730
|
+
assertNotOut(resRegistered, '未登记本 change');
|
|
731
|
+
// 子断言:归档缺 KNOWN-ISSUES.md(遗留清单为强制产物)→ BLOCKED
|
|
732
|
+
fs.rmSync(path.join(dir, '.specs/archive/foo-' + CHANGE_ID, 'KNOWN-ISSUES.md'));
|
|
733
|
+
const resMissing = runGuard(['exit', 'archive'], dir);
|
|
734
|
+
assertExit(resMissing, 1);
|
|
735
|
+
assertOut(resMissing, 'missing Output Schema artifacts');
|
|
736
|
+
},
|
|
737
|
+
},
|
|
738
|
+
|
|
739
|
+
// 23: 旧 state 兼容(无 branchMode 字段 + 无分支)entry archive → exit 0(不触发分支校验)
|
|
740
|
+
{
|
|
741
|
+
name: '23 旧 state 兼容:无 branchMode 无分支 entry archive',
|
|
742
|
+
run: (dir) => {
|
|
743
|
+
const st = baseState('archive'); // 无 branchMode 字段(旧 state 形状)
|
|
744
|
+
writeState(dir, st);
|
|
745
|
+
const res = runGuard(['entry', 'archive'], dir);
|
|
746
|
+
assertExit(res, 0);
|
|
747
|
+
assertOut(res, 'ENTRY OK: archive');
|
|
748
|
+
},
|
|
749
|
+
},
|
|
750
|
+
|
|
751
|
+
// ---------- 分组场景(自定义协议加载路由 + 通用层防线 + 特化校验绑定 + hook 白名单缺省) ----------
|
|
752
|
+
|
|
753
|
+
// 24: 自定义协议加载路由(AC-2/3)——--protocol CLI 指向 <dir>/custom-protocol.json;
|
|
754
|
+
// workflow-state status 按协议 outputSchemas 推导 currentNode:全部产物缺失 → 第 1 节点
|
|
755
|
+
{
|
|
756
|
+
name: '24 自定义协议加载路由:无产物 → 第 1 节点(brainstorm)',
|
|
757
|
+
run: (dir) => {
|
|
758
|
+
const custom = writeCustomProtocol(dir);
|
|
759
|
+
writeState(dir, composeState());
|
|
760
|
+
fs.mkdirSync(path.join(dir, '.specs', 'compose-demo'), { recursive: true });
|
|
761
|
+
const res = runState(['status', '--protocol', custom], dir);
|
|
762
|
+
assertExit(res, 0);
|
|
763
|
+
assertOut(res, '"currentNode": "brainstorm"');
|
|
764
|
+
},
|
|
765
|
+
},
|
|
766
|
+
|
|
767
|
+
// 25: 自定义协议加载路由(AC-2/3)——仅第 1 节点产物 notes.md 存在 → 推第 2 节点
|
|
768
|
+
{
|
|
769
|
+
name: '25 自定义协议加载路由:仅 notes.md → 第 2 节点(tdd)',
|
|
770
|
+
run: (dir) => {
|
|
771
|
+
const custom = writeCustomProtocol(dir);
|
|
772
|
+
writeState(dir, composeState());
|
|
773
|
+
writeFile(dir, '.specs/compose-demo/notes.md', '# notes\n');
|
|
774
|
+
const res = runState(['status', '--protocol', custom], dir);
|
|
775
|
+
assertExit(res, 0);
|
|
776
|
+
assertOut(res, '"currentNode": "tdd"');
|
|
777
|
+
},
|
|
778
|
+
},
|
|
779
|
+
|
|
780
|
+
// 26: 自定义协议加载路由(AC-2/3)——全部产物存在 → 最后节点
|
|
781
|
+
{
|
|
782
|
+
name: '26 自定义协议加载路由:产物齐全 → 最后节点(codereview)',
|
|
783
|
+
run: (dir) => {
|
|
784
|
+
const custom = writeCustomProtocol(dir);
|
|
785
|
+
writeState(dir, composeState());
|
|
786
|
+
writeFile(dir, '.specs/compose-demo/notes.md', '# notes\n');
|
|
787
|
+
writeFile(dir, '.specs/compose-demo/T01-SUMMARY.md', '# T01-SUMMARY\n');
|
|
788
|
+
writeFile(dir, '.specs/compose-demo/verdict.md', '# verdict\n');
|
|
789
|
+
const res = runState(['status', '--protocol', custom], dir);
|
|
790
|
+
assertExit(res, 0);
|
|
791
|
+
assertOut(res, '"currentNode": "codereview"');
|
|
792
|
+
},
|
|
793
|
+
},
|
|
794
|
+
|
|
795
|
+
// 27: 通用层防线对自定义协议生效(AC-4)——自定义节点 exit 缺 evidence → BLOCKED(missing evidence)
|
|
796
|
+
{
|
|
797
|
+
name: '27 通用层防线(AC-4):exit brainstorm 无 evidence → BLOCKED',
|
|
798
|
+
run: (dir) => {
|
|
799
|
+
const custom = writeCustomProtocol(dir);
|
|
800
|
+
writeState(dir, composeState({ currentNode: 'brainstorm', evidence: {} }));
|
|
801
|
+
fs.mkdirSync(path.join(dir, '.specs', 'compose-demo'), { recursive: true });
|
|
802
|
+
const res = runGuard(['exit', 'brainstorm', '--protocol', custom], dir);
|
|
803
|
+
assertExit(res, 1);
|
|
804
|
+
assertOut(res, 'BLOCKED');
|
|
805
|
+
assertOut(res, 'missing evidence for Node brainstorm');
|
|
806
|
+
},
|
|
807
|
+
},
|
|
808
|
+
|
|
809
|
+
// 28: 特化校验绑定反例(AC-5)——自定义节点 id(brainstorm)exit 不误触发内置 open 特化校验:
|
|
810
|
+
// 场景内置 open 特化校验的诱饵(CHANGE.md 缺 Why + REQUIREMENT 缺验收段),若误触发必 BLOCKED
|
|
811
|
+
{
|
|
812
|
+
name: '28 特化校验绑定反例(AC-5b):brainstorm exit 不误触发内置特化校验',
|
|
813
|
+
run: (dir) => {
|
|
814
|
+
const custom = writeCustomProtocol(dir);
|
|
815
|
+
writeState(dir, composeState({
|
|
816
|
+
currentNode: 'brainstorm',
|
|
817
|
+
evidence: { brainstorm: { summary: 'brainstorm done' } },
|
|
818
|
+
}));
|
|
819
|
+
writeFile(dir, '.specs/compose-demo/notes.md', '# notes\n'); // brainstorm 产物(artifact 门控)
|
|
820
|
+
writeFile(dir, '.specs/compose-demo/CHANGE.md', '# CHANGE\n\n## 变更目标\n\n## 方案\n');
|
|
821
|
+
writeFile(dir, '.specs/compose-demo/REQUIREMENT.md', '# REQUIREMENT\n\n## 用户故事\n\n## 需求分析\n');
|
|
822
|
+
const res = runGuard(['exit', 'brainstorm', '--protocol', custom], dir);
|
|
823
|
+
assertExit(res, 0);
|
|
824
|
+
assertOut(res, 'ALL CHECKS PASSED');
|
|
825
|
+
assertNotOut(res, '缺必填段');
|
|
826
|
+
assertNotOut(res, '缺少验收标准');
|
|
827
|
+
},
|
|
828
|
+
},
|
|
829
|
+
|
|
830
|
+
// 29: 协议 env 加载(AC-2/3)——FLOW_COMET_PROTOCOL 指向场景内自定义协议(无 --protocol CLI)
|
|
831
|
+
// guard 从 env 加载自定义协议:若 env 被忽略(回退 packageRoot 内置 8 节点协议)→ Unknown Node 报错
|
|
832
|
+
{
|
|
833
|
+
name: '29 自定义协议 env 加载:FLOW_COMET_PROTOCOL 生效',
|
|
834
|
+
run: (dir) => {
|
|
835
|
+
const custom = writeCustomProtocol(dir);
|
|
836
|
+
writeState(dir, composeState({
|
|
837
|
+
currentNode: 'brainstorm',
|
|
838
|
+
evidence: { brainstorm: { summary: 'brainstorm done' } },
|
|
839
|
+
}));
|
|
840
|
+
writeFile(dir, '.specs/compose-demo/notes.md', '# notes\n');
|
|
841
|
+
const res = runGuard(['exit', 'brainstorm'], dir, { FLOW_COMET_PROTOCOL: custom });
|
|
842
|
+
assertExit(res, 0);
|
|
843
|
+
assertOut(res, 'ALL CHECKS PASSED');
|
|
844
|
+
assertNotOut(res, 'Unknown workflow Node');
|
|
845
|
+
// ③ state.protocolPath 持久化绑定优先于 FLOW_COMET_PROTOCOL env:env 指向内置协议
|
|
846
|
+
// (无 brainstorm 节点),state 绑定自定义协议 → 仍按自定义协议通过。修复前 guard 只看
|
|
847
|
+
// CLI/env → 走内置协议报 Unknown Node(RED)。
|
|
848
|
+
const bound = composeState({
|
|
849
|
+
currentNode: 'brainstorm',
|
|
850
|
+
evidence: { brainstorm: { summary: 'brainstorm done' } },
|
|
851
|
+
protocolPath: 'custom-protocol.json',
|
|
852
|
+
});
|
|
853
|
+
writeState(dir, bound);
|
|
854
|
+
const resBound = runGuard(['exit', 'brainstorm'], dir); // runGuard 默认 env=内置协议副本
|
|
855
|
+
assertExit(resBound, 0);
|
|
856
|
+
assertOut(resBound, 'ALL CHECKS PASSED');
|
|
857
|
+
assertNotOut(resBound, 'Unknown workflow Node');
|
|
858
|
+
// ④ state.protocolPath 绑定不可读 → fail-closed 不回退 env/默认协议,错误说明来源与
|
|
859
|
+
// 不回退语义(归属门禁可跳过校验,节点门禁没有等价降级路径)。
|
|
860
|
+
writeState(dir, composeState({ protocolPath: 'missing-protocol.json' }));
|
|
861
|
+
const resBoundMissing = runGuard(['exit', 'brainstorm'], dir);
|
|
862
|
+
assertExit(resBoundMissing, 1);
|
|
863
|
+
assertOut(resBoundMissing, 'state.protocolPath');
|
|
864
|
+
assertOut(resBoundMissing, '不回退');
|
|
865
|
+
assertNotOut(resBoundMissing, 'Unknown workflow Node');
|
|
866
|
+
},
|
|
867
|
+
},
|
|
868
|
+
|
|
869
|
+
// 30: hook 白名单缺省(AC-6)——自定义协议无 writeWhitelist → hook 回退内置缺省表。
|
|
870
|
+
// a) 无活跃 state → 放行(不阻断);b) 自定义节点 + 写 .specs/ → 放行;c) 内置 open + .specs/ → 放行;
|
|
871
|
+
// d) 内置 open + 写源码 → BLOCKED(缺省表 open 仅允许 .specs/)
|
|
872
|
+
{
|
|
873
|
+
name: '30 hook 白名单缺省(AC-6):协议无 writeWhitelist → 内置缺省表',
|
|
874
|
+
run: (dir) => {
|
|
875
|
+
const custom = writeCustomProtocol(dir);
|
|
876
|
+
// a) 无 state 文件 → 无活跃 workflow 放行
|
|
877
|
+
const resA = runHook(['before_tool'], dir,
|
|
878
|
+
{ tool_name: 'Write', tool_input: { file_path: path.join(dir, 'src', 'index.ts') } },
|
|
879
|
+
{ FLOW_COMET_PROTOCOL: custom });
|
|
880
|
+
assertExit(resA, 0);
|
|
881
|
+
assertOut(resA, 'no active workflow');
|
|
882
|
+
// b) 自定义协议 + 活跃 state(brainstorm)写 .specs/ 内文件 → 放行
|
|
883
|
+
writeState(dir, composeState({ status: 'running' }));
|
|
884
|
+
const resB = runHook(['before_tool'], dir,
|
|
885
|
+
{ tool_name: 'Write', tool_input: { file_path: path.join(dir, '.specs', 'compose-demo', 'notes.md') } },
|
|
886
|
+
{ FLOW_COMET_PROTOCOL: custom });
|
|
887
|
+
assertExit(resB, 0);
|
|
888
|
+
assertOut(resB, 'NODE: brainstorm');
|
|
889
|
+
// c) 内置协议副本(同样无 writeWhitelist)+ open 写 .specs/ 内文件 → 缺省表放行
|
|
890
|
+
const stC = baseState('open');
|
|
891
|
+
stC.status = 'running';
|
|
892
|
+
writeState(dir, stC);
|
|
893
|
+
const resC = runHook(['before_tool'], dir,
|
|
894
|
+
{ tool_name: 'Write', tool_input: { file_path: path.join(dir, '.specs', 'compose-demo', 'CHANGE.md') } });
|
|
895
|
+
assertExit(resC, 0);
|
|
896
|
+
assertOut(resC, 'NODE: open');
|
|
897
|
+
// d) 内置协议副本 + open 写源码 → 缺省表拦截(BLOCKED exit 2)
|
|
898
|
+
const resD = runHook(['before_tool'], dir,
|
|
899
|
+
{ tool_name: 'Write', tool_input: { file_path: path.join(dir, 'src', 'index.ts') } });
|
|
900
|
+
assertExit(resD, 2);
|
|
901
|
+
assertOut(resD, 'BLOCKED: phase "open" 不允许写入');
|
|
902
|
+
},
|
|
903
|
+
},
|
|
904
|
+
|
|
905
|
+
// 31: --protocol CLI 优先于 env(AC-2)——env 指向内置副本(若 CLI 被忽略 → 内置协议无
|
|
906
|
+
// brainstorm 节点 → Unknown Node 报错),CLI 指向自定义协议 → 走自定义协议通过
|
|
907
|
+
{
|
|
908
|
+
name: '31 --protocol CLI 优先于 FLOW_COMET_PROTOCOL env',
|
|
909
|
+
run: (dir) => {
|
|
910
|
+
const custom = writeCustomProtocol(dir);
|
|
911
|
+
writeState(dir, composeState({
|
|
912
|
+
currentNode: 'brainstorm',
|
|
913
|
+
evidence: { brainstorm: { summary: 'brainstorm done' } },
|
|
914
|
+
}));
|
|
915
|
+
writeFile(dir, '.specs/compose-demo/notes.md', '# notes\n');
|
|
916
|
+
const res = runGuard(['exit', 'brainstorm', '--protocol', custom], dir);
|
|
917
|
+
assertExit(res, 0);
|
|
918
|
+
assertOut(res, 'ALL CHECKS PASSED');
|
|
919
|
+
assertNotOut(res, 'Unknown workflow Node');
|
|
920
|
+
},
|
|
921
|
+
},
|
|
922
|
+
|
|
923
|
+
// ---------- 场景(自定义协议全部完成 → NEXT: done;部分完成仍走产物推导) ----------
|
|
924
|
+
|
|
925
|
+
// 32: 自定义协议无 archive 节点,3 节点全部 exit 完成(completedNodes 含 brainstorm/tdd/codereview)
|
|
926
|
+
// → next 输出 NEXT: done(修复前缺陷:determineNode 只按产物推导,全部完成仍输出 NODE: codereview)
|
|
927
|
+
{
|
|
928
|
+
name: '32 自定义协议全节点完成:next → NEXT: done',
|
|
929
|
+
run: (dir) => {
|
|
930
|
+
const custom = writeCustomProtocol(dir);
|
|
931
|
+
writeState(dir, composeState({
|
|
932
|
+
currentNode: 'codereview',
|
|
933
|
+
completedNodes: ['brainstorm', 'tdd', 'codereview'],
|
|
934
|
+
}));
|
|
935
|
+
writeFile(dir, '.specs/compose-demo/notes.md', '# notes\n');
|
|
936
|
+
writeFile(dir, '.specs/compose-demo/T01-SUMMARY.md', '# T01-SUMMARY\n');
|
|
937
|
+
writeFile(dir, '.specs/compose-demo/verdict.md', '# verdict\n');
|
|
938
|
+
const res = runState(['next', '--protocol', custom], dir);
|
|
939
|
+
assertExit(res, 0);
|
|
940
|
+
assertOut(res, 'NEXT: done');
|
|
941
|
+
assertNotOut(res, 'NODE: codereview');
|
|
942
|
+
},
|
|
943
|
+
},
|
|
944
|
+
|
|
945
|
+
// 33: 反例(防过度修复)——completedNodes 为空(部分完成)但产物全齐 → next 仍输出最后节点
|
|
946
|
+
// codereview:产物推导继续生效,不因"全部完成 → done"判定误伤最后节点路由
|
|
947
|
+
// 适配:currentNode=brainstorm 已记录 evidence(节点已工作)→ 不触发节点顺序 BLOCK;
|
|
948
|
+
// completedNodes 仍为空,"部分完成但产物全齐 → 仍 NODE: codereview"断言保持不变
|
|
949
|
+
{
|
|
950
|
+
name: '33 反例:completedNodes 空但产物全齐 → 仍 NODE: codereview',
|
|
951
|
+
run: (dir) => {
|
|
952
|
+
const custom = writeCustomProtocol(dir);
|
|
953
|
+
writeState(dir, composeState({
|
|
954
|
+
currentNode: 'brainstorm',
|
|
955
|
+
evidence: { brainstorm: { summary: 'brainstorm done' } },
|
|
956
|
+
}));
|
|
957
|
+
writeFile(dir, '.specs/compose-demo/notes.md', '# notes\n');
|
|
958
|
+
writeFile(dir, '.specs/compose-demo/T01-SUMMARY.md', '# T01-SUMMARY\n');
|
|
959
|
+
writeFile(dir, '.specs/compose-demo/verdict.md', '# verdict\n');
|
|
960
|
+
const res = runState(['next', '--protocol', custom], dir);
|
|
961
|
+
assertExit(res, 0);
|
|
962
|
+
assertOut(res, 'NODE: codereview');
|
|
963
|
+
assertNotOut(res, 'NEXT: done');
|
|
964
|
+
},
|
|
965
|
+
},
|
|
966
|
+
];
|