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.
Files changed (107) hide show
  1. package/.flow-comet/skills/flow-comet/INSTALLED_VERSION +1 -1
  2. package/.flow-comet/skills/flow-comet/SKILL.md +64 -46
  3. package/.flow-comet/skills/flow-comet/reference/KNOWN-ISSUES-template.md +1 -1
  4. package/.flow-comet/skills/flow-comet/reference/commit-discipline.md +32 -0
  5. package/.flow-comet/skills/flow-comet/reference/dirty-worktree.md +1 -1
  6. package/.flow-comet/skills/flow-comet/{GUIDANCE.md → reference/entry-detail.md} +18 -28
  7. package/.flow-comet/skills/flow-comet/reference/fix-loop.md +57 -0
  8. package/.flow-comet/skills/flow-comet/reference/platform-facts.md +58 -0
  9. package/.flow-comet/skills/flow-comet/reference/replan.md +23 -0
  10. package/.flow-comet/skills/flow-comet/scripts/comet-check.mjs +5 -4
  11. package/.flow-comet/skills/flow-comet/scripts/comet-hook-guard.mjs +266 -25
  12. package/.flow-comet/skills/flow-comet/scripts/context-init.mjs +2 -2
  13. package/.flow-comet/skills/flow-comet/scripts/evolve.mjs +6 -6
  14. package/.flow-comet/skills/flow-comet/scripts/guard-self-test.mjs +67 -16325
  15. package/.flow-comet/skills/flow-comet/scripts/health.mjs +1 -1
  16. package/.flow-comet/skills/flow-comet/scripts/items/a.mjs +1030 -0
  17. package/.flow-comet/skills/flow-comet/scripts/items/b.mjs +830 -0
  18. package/.flow-comet/skills/flow-comet/scripts/items/c.mjs +781 -0
  19. package/.flow-comet/skills/flow-comet/scripts/items/d.mjs +99 -0
  20. package/.flow-comet/skills/flow-comet/scripts/items/e.mjs +185 -0
  21. package/.flow-comet/skills/flow-comet/scripts/items/f.mjs +90 -0
  22. package/.flow-comet/skills/flow-comet/scripts/items/g.mjs +59 -0
  23. package/.flow-comet/skills/flow-comet/scripts/items/h.mjs +815 -0
  24. package/.flow-comet/skills/flow-comet/scripts/items/i.mjs +77 -0
  25. package/.flow-comet/skills/flow-comet/scripts/items/j.mjs +75 -0
  26. package/.flow-comet/skills/flow-comet/scripts/items/k.mjs +1427 -0
  27. package/.flow-comet/skills/flow-comet/scripts/items/l.mjs +275 -0
  28. package/.flow-comet/skills/flow-comet/scripts/items/m.mjs +614 -0
  29. package/.flow-comet/skills/flow-comet/scripts/lib/count-derivation.mjs +97 -0
  30. package/.flow-comet/skills/flow-comet/scripts/lib/fix-loop-node.mjs +196 -0
  31. package/.flow-comet/skills/flow-comet/scripts/lib/guard-evidence-gates.mjs +553 -0
  32. package/.flow-comet/skills/flow-comet/scripts/lib/guard-gates.mjs +837 -0
  33. package/.flow-comet/skills/flow-comet/scripts/lib/guard-routing.mjs +404 -0
  34. package/.flow-comet/skills/flow-comet/scripts/lib/guard-state-io.mjs +404 -0
  35. package/.flow-comet/skills/flow-comet/scripts/lib/guard-template-fidelity.mjs +302 -0
  36. package/.flow-comet/skills/flow-comet/scripts/lib/guard-uidesign.mjs +133 -0
  37. package/.flow-comet/skills/flow-comet/scripts/lib/reentry-node.mjs +237 -0
  38. package/.flow-comet/skills/flow-comet/scripts/lib/replan-node.mjs +209 -0
  39. package/.flow-comet/skills/flow-comet/scripts/lib/state-branch.mjs +49 -0
  40. package/.flow-comet/skills/flow-comet/scripts/lib/state-bridgecheck.mjs +201 -0
  41. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-admin.mjs +141 -0
  42. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-flow.mjs +700 -0
  43. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-recovery.mjs +578 -0
  44. package/.flow-comet/skills/flow-comet/scripts/lib/state-determine.mjs +52 -0
  45. package/.flow-comet/skills/flow-comet/scripts/lib/state-evolve-hint.mjs +55 -0
  46. package/.flow-comet/skills/flow-comet/scripts/lib/state-explain.mjs +106 -0
  47. package/.flow-comet/skills/flow-comet/scripts/lib/state-intelscan.mjs +58 -0
  48. package/.flow-comet/skills/flow-comet/scripts/lib/state-io.mjs +147 -0
  49. package/.flow-comet/skills/flow-comet/scripts/lib/state-skillmarkers.mjs +189 -0
  50. package/.flow-comet/skills/flow-comet/scripts/lib/system-fixtures.mjs +1441 -0
  51. package/.flow-comet/skills/flow-comet/scripts/lib/task-graph.mjs +471 -0
  52. package/.flow-comet/skills/flow-comet/scripts/lib/test-assertions.mjs +509 -0
  53. package/.flow-comet/skills/flow-comet/scripts/lib/test-fixtures.mjs +1228 -0
  54. package/.flow-comet/skills/flow-comet/scripts/lib/test-helpers.mjs +237 -0
  55. package/.flow-comet/skills/flow-comet/scripts/lib/text-anchor-checks.mjs +2484 -0
  56. package/.flow-comet/skills/flow-comet/scripts/protocol-utils.mjs +2 -2
  57. package/.flow-comet/skills/flow-comet/scripts/route-node.mjs +73 -1077
  58. package/.flow-comet/skills/flow-comet/scripts/scenarios/a.mjs +966 -0
  59. package/.flow-comet/skills/flow-comet/scripts/scenarios/b.mjs +1233 -0
  60. package/.flow-comet/skills/flow-comet/scripts/scenarios/c.mjs +1382 -0
  61. package/.flow-comet/skills/flow-comet/scripts/scenarios/d.mjs +483 -0
  62. package/.flow-comet/skills/flow-comet/scripts/scenarios/e.mjs +1388 -0
  63. package/.flow-comet/skills/flow-comet/scripts/scenarios/f.mjs +1466 -0
  64. package/.flow-comet/skills/flow-comet/scripts/scenarios/g.mjs +1364 -0
  65. package/.flow-comet/skills/flow-comet/scripts/scenarios/h.mjs +1287 -0
  66. package/.flow-comet/skills/flow-comet/scripts/scenarios/i.mjs +1436 -0
  67. package/.flow-comet/skills/flow-comet/scripts/scenarios/j.mjs +1384 -0
  68. package/.flow-comet/skills/flow-comet/scripts/scenarios/k.mjs +1338 -0
  69. package/.flow-comet/skills/flow-comet/scripts/scenarios/l.mjs +1484 -0
  70. package/.flow-comet/skills/flow-comet/scripts/scenarios/m.mjs +971 -0
  71. package/.flow-comet/skills/flow-comet/scripts/state-schema.mjs +14 -1
  72. package/.flow-comet/skills/flow-comet/scripts/system-test.mjs +58 -6692
  73. package/.flow-comet/skills/flow-comet/scripts/time-utils.mjs +4 -4
  74. package/.flow-comet/skills/flow-comet/scripts/workflow-guard.mjs +151 -2428
  75. package/.flow-comet/skills/flow-comet/scripts/workflow-handoff.mjs +116 -9
  76. package/.flow-comet/skills/flow-comet/scripts/workflow-state.mjs +29 -2086
  77. package/.flow-comet/skills/flow-comet-archive/SKILL.md +10 -19
  78. package/.flow-comet/skills/flow-comet-change/SKILL.md +2 -3
  79. package/.flow-comet/skills/flow-comet-compose/SKILL.md +1 -1
  80. package/.flow-comet/skills/flow-comet-design/SKILL.md +6 -6
  81. package/.flow-comet/skills/flow-comet-execute/SKILL.md +58 -16
  82. package/.flow-comet/skills/flow-comet-integration/SKILL.md +8 -5
  83. package/.flow-comet/skills/flow-comet-open/SKILL.md +5 -1
  84. package/.flow-comet/skills/flow-comet-plan/GUIDANCE.md +1 -1
  85. package/.flow-comet/skills/flow-comet-plan/SKILL.md +8 -8
  86. package/.flow-comet/skills/flow-comet-review/SKILL.md +9 -12
  87. package/.flow-comet/skills/flow-comet-subagent-execute/SKILL.md +59 -16
  88. package/.flow-comet/skills/flow-comet-task/SKILL.md +3 -2
  89. package/.flow-comet/skills/flow-comet-ui-design/SKILL.md +3 -3
  90. package/.flow-comet/skills/flow-comet-verify/SKILL.md +8 -17
  91. package/README.md +53 -70
  92. package/package.json +3 -2
  93. package/scripts/dsh-bridge.mjs +59 -26
  94. package/scripts/lib/installer-cleanup.mjs +152 -0
  95. package/scripts/lib/installer-flowkit.mjs +119 -0
  96. package/scripts/lib/installer-hooks.mjs +363 -0
  97. package/scripts/lib/installer-loader.mjs +220 -0
  98. package/scripts/lib/installer-migrate.mjs +236 -0
  99. package/scripts/lib/installer-platforms.mjs +314 -0
  100. package/scripts/prepare-env.mjs +36 -1164
  101. package/.flow-comet/skills/flow-comet/reference/TEST-MATRIX.md +0 -116
  102. package/.flow-comet/skills/flow-comet/reference/composition-report.md +0 -65
  103. package/.flow-comet/skills/flow-comet/reference/dsh-platform.md +0 -184
  104. package/.flow-comet/skills/flow-comet/reference/resolved-skills.json +0 -661
  105. package/.flow-comet/skills/flow-comet/reference/skill-review.md +0 -13
  106. package/.flow-comet/skills/flow-comet/reference/subagents/script-author.md +0 -7
  107. package/.flow-comet/skills/flow-comet/reference/worktree-notes.md +0 -70
@@ -0,0 +1,1384 @@
1
+ // 场景组 j — Fix 回程(多趟收尾与签名元数据 / 回程豁免 / 越界拦截)· 受控归位 · 技能树文本锁
2
+ // 元素形态:`{ name, run }`;计数由 `lib/count-derivation.mjs` 从本目录聚合,不手抄数字。
3
+ // 组界:场景序列按组文件规模上限连续分区——本文件先承载 J 组场景、后承载 K 组头部两项(259 · 260);
4
+ // 分区只搬文件,场景名/内容与其在入口 `SCENARIOS` 里的拼接顺序均不变。
5
+
6
+ import fs from 'fs';
7
+ import path from 'path';
8
+ import {
9
+ assertExit,
10
+ assertNotOut,
11
+ assertOut,
12
+ runGuard,
13
+ writeFile,
14
+ writeState,
15
+ } from '../lib/test-helpers.mjs';
16
+ import {
17
+ CHANGE_ID,
18
+ SCRIPTS_DIR,
19
+ handoffFor,
20
+ renderMultiWaveTasks,
21
+ resolveComponentSkillFile,
22
+ routeNodeModule,
23
+ strictSummary,
24
+ writeIntakeArtifacts,
25
+ } from '../lib/test-fixtures.mjs';
26
+ import {
27
+ FIX_RETURN_FAMILY_COMPLETED,
28
+ FIX_RETURN_REVIEW_TEXT,
29
+ REENTRY_EXPECTED_INTERSECTION,
30
+ REENTRY_FULL_COMPLETED,
31
+ STALE_FIX_BATCH_SIGNATURE,
32
+ assertReentryAuthorizationShape,
33
+ assertStateBytesUnchanged,
34
+ assertStateOnlyChanged,
35
+ fixBatchHistoryWithStaleExecuteExit,
36
+ fixBatchHistoryWithStaleFamilyExit,
37
+ fixBatchParallelTaskText,
38
+ fixBatchTaskText,
39
+ fixReturnBaseState,
40
+ fixReturnFamilyEvidence,
41
+ fixTaskBlock,
42
+ readScenarioProtocol,
43
+ readScenarioState,
44
+ readStateBytes,
45
+ reentryArchiveState,
46
+ reentryBackupFiles,
47
+ requireRouteNodeExport,
48
+ runReenter,
49
+ runStateWithProtocol,
50
+ writeFixReturnSummaries,
51
+ writeReentryChangeDir,
52
+ } from '../lib/test-assertions.mjs';
53
+ import {
54
+ FIX_LOOP_AUTHORITY_KEYWORDS,
55
+ FIX_LOOP_AUTHORITY_REL,
56
+ FIX_LOOP_BOOK_ELEMENT_GROUPS,
57
+ fixLoopStateMachineProblems,
58
+ fixLoopStateMachineSectionOf,
59
+ } from '../lib/text-anchor-checks.mjs';
60
+ import { createHash } from 'crypto';
61
+ import { isDeepStrictEqual } from 'util';
62
+
63
+ export const ENTRIES = [
64
+
65
+ // 250c: 多趟收尾与签名元数据——中性回程 / 多波次真实修复 / 任务集签名同版本三态。
66
+ // 本场景族拆自原 250 单场景,断言与失败信息保持不变。
67
+ {
68
+ name: '250c 多趟收尾与签名元数据:中性回程、多波次修复、任务集签名三态',
69
+ run: (dir) => {
70
+ writeIntakeArtifacts(dir);
71
+ const taskPath = '.specs/' + CHANGE_ID + '/TASK.md';
72
+ writeFixReturnSummaries(dir, ['T01', 'T-FIX-01']);
73
+ writeFile(dir, '.specs/' + CHANGE_ID + '/REVIEW.md', FIX_RETURN_REVIEW_TEXT);
74
+ // state 不变量统一走 assertStateOnlyChanged(白名单外深比 + history 旧前缀稳定 + 恰新增
75
+ // 一条 exit-applied)——白名单仅 currentNode(既有路由覆盖 next)、status(既有 apply 写
76
+ // running/completed)、history(既有出口事件追加);execute 证据的 completedChecks 已预置,
77
+ // 不在白名单内假豁免。
78
+
79
+ // 250b 正常多趟最终 exit:无 Fix 任务、历史家族出口签名 == 当前 TASK 签名 → 中性
80
+ // RETURN(正常多趟收尾,非 Fix 回修);不得出现 FIX-BATCH;NODE/state 与收口前一致。
81
+ const normalTaskText = '# TASK\n\n' + fixTaskBlock('T01', 'done') + '\n';
82
+ const normalSignature = routeNodeModule.taskSetSignature(normalTaskText);
83
+ writeFile(dir, taskPath, normalTaskText);
84
+ writeState(dir, fixReturnBaseState({
85
+ history: [{
86
+ event: 'exit-applied', node: 'subagent-execute', change: CHANGE_ID,
87
+ at: '2026-09-23T00:00:00.000Z', taskSetSignature: normalSignature,
88
+ }],
89
+ }));
90
+ const beforeNormal = readScenarioState(dir);
91
+ const resNormal = runGuard(['exit', 'execute', '--apply'], dir);
92
+ assertExit(resNormal, 0);
93
+ assertOut(resNormal, 'RETURN: 回源节点 review(execute 出口已完成;正常多趟收尾,非 Fix 回修)');
94
+ assertOut(resNormal, 'NODE: review');
95
+ assertNotOut(resNormal, 'FIX-BATCH');
96
+ assertNotOut(resNormal, 'NODE: verify');
97
+ const afterNormal = readScenarioState(dir);
98
+ if (afterNormal.currentNode !== 'review' || afterNormal.completedNodes.join(',') !== FIX_RETURN_FAMILY_COMPLETED) {
99
+ throw new Error('正常多趟回程应只覆盖路由到 review 且 completedNodes 不变,实际 '
100
+ + JSON.stringify({ currentNode: afterNormal.currentNode, completedNodes: afterNormal.completedNodes }));
101
+ }
102
+ const [normalAppended] = assertStateOnlyChanged(beforeNormal, afterNormal, {
103
+ label: '250b 正常多趟回程',
104
+ allowed: ['currentNode', 'status', 'history'],
105
+ });
106
+ // m-14 新版本元数据锚:exit-applied 事件带 signatureAlgo 且签名值为 vN:<digest> 形态
107
+ if (!normalAppended || normalAppended.node !== 'execute' || normalAppended.change !== CHANGE_ID
108
+ || normalAppended.taskSetSignature !== normalSignature
109
+ || !/^v\d+:[0-9a-f]{64}$/.test(String(normalAppended.taskSetSignature))
110
+ || normalAppended.signatureAlgo !== routeNodeModule.TASK_SET_SIGNATURE_ALGO) {
111
+ throw new Error('正常多趟出口事件应记录本 change + vN:<digest> 签名 + signatureAlgo 元数据,实际 '
112
+ + JSON.stringify(normalAppended));
113
+ }
114
+ const normalExit = (afterNormal.history || []).pop();
115
+ if (!normalExit || normalExit.node !== 'execute' || normalExit.change !== CHANGE_ID
116
+ || normalExit.taskSetSignature !== normalSignature) {
117
+ throw new Error('正常多趟出口事件形状应与既有一致(node/change/taskSetSignature),实际 '
118
+ + JSON.stringify(normalExit));
119
+ }
120
+
121
+ // 250c 多波次真实 Fix:历史旧签名 ≠ 当前、最新签名 == 当前(只看最新会漏判)→ 保留
122
+ // FIX-BATCH(全量扫描);TASK 含修复任务与结构标记。
123
+ const multiWaveTaskText = fixBatchTaskText('done');
124
+ const multiWaveSignature = routeNodeModule.taskSetSignature(multiWaveTaskText);
125
+ writeFile(dir, taskPath, multiWaveTaskText);
126
+ writeState(dir, fixReturnBaseState({
127
+ evidence: fixReturnFamilyEvidence(['T01', 'T-FIX-01']),
128
+ history: [
129
+ {
130
+ event: 'exit-applied', node: 'execute', change: CHANGE_ID,
131
+ at: '2026-09-20T00:00:00.000Z', taskSetSignature: STALE_FIX_BATCH_SIGNATURE,
132
+ },
133
+ {
134
+ event: 'exit-applied', node: 'subagent-execute', change: CHANGE_ID,
135
+ at: '2026-09-24T00:00:00.000Z', taskSetSignature: multiWaveSignature,
136
+ },
137
+ ],
138
+ }));
139
+ const resMultiWave = runGuard(['exit', 'execute', '--apply'], dir);
140
+ assertExit(resMultiWave, 0);
141
+ assertOut(resMultiWave, 'FIX-BATCH: 回源节点 review(execute 出口已完成)');
142
+ assertOut(resMultiWave, 'NODE: review');
143
+ assertNotOut(resMultiWave, 'RETURN: 回源节点');
144
+
145
+ writeFile(dir, '.specs/' + CHANGE_ID + '/T02-SUMMARY.md', strictSummary('T02'));
146
+ // 250j~l m-14 C3 三态(guard exit 入口签名比对消费点):同版本一致 → 放行;
147
+ // 同版本不一致 → BLOCK;跨算法版本 → SIGNATURE-ALGO WARN 跳过比对不阻断。
148
+ writeFile(dir, 'flow-kit/templates/TASK.md',
149
+ '# TASK 模板\n\n## Fix Tasks(来自 REVIEW / INTEGRATION)\n');
150
+ const renamedTplTaskText = '# TASK\n\n' + fixTaskBlock('T01', 'done') + '\n'
151
+ + '## Fix Tasks ##\n\n' + fixTaskBlock('T02', 'done') + '\n';
152
+ writeFile(dir, taskPath, renamedTplTaskText);
153
+ const c3Evidence = fixReturnFamilyEvidence(['T01', 'T02']);
154
+ const c3Digest = routeNodeModule.parseTaskSetSignature(
155
+ routeNodeModule.taskSetSignature(renamedTplTaskText))?.digest;
156
+ writeState(dir, fixReturnBaseState({ evidence: c3Evidence, history: [], taskHash: routeNodeModule.taskSetSignature(renamedTplTaskText) }));
157
+ const resC3Same = runGuard(['exit', 'execute', '--apply'], dir);
158
+ assertExit(resC3Same, 0);
159
+ assertNotOut(resC3Same, 'BLOCKED');
160
+ // 同版本不一致(占位 digest)→ 新 change BLOCK 任务集被修改
161
+ writeState(dir, fixReturnBaseState({ evidence: c3Evidence, history: [], taskHash: 'v1:' + '0'.repeat(64) }));
162
+ const resC3Diff = runGuard(['exit', 'execute', '--apply'], dir);
163
+ assertExit(resC3Diff, 1);
164
+ assertOut(resC3Diff, 'BLOCKED: TASK.md 任务集被修改');
165
+ // 跨算法版本(v2 值 + v2 声明)→ 不可比,WARN 跳过比对,不误拦任务集
166
+ writeState(dir, fixReturnBaseState({ evidence: c3Evidence, history: [], taskHash: 'v2:' + c3Digest }));
167
+ const resC3Skew = runGuard(['exit', 'execute', '--apply'], dir);
168
+ assertExit(resC3Skew, 0);
169
+ assertOut(resC3Skew, 'SIGNATURE-ALGO WARN');
170
+ assertNotOut(resC3Skew, 'BLOCKED: TASK.md 任务集被修改');
171
+ },
172
+ },
173
+ // 251: exit execute --apply Fix 二次完成回源(verify 源)——TEST.md/UAT.md 已在场
174
+ // (resolveNextNode 会按产物跳过 verify 去 archive)但 verify 未完成 → 受控回程 verify。
175
+ {
176
+ name: '251 exit execute --apply Fix 二次完成:回源 verify(TEST/UAT 在场但不按产物跳过)',
177
+ run: (dir) => {
178
+ writeIntakeArtifacts(dir);
179
+ writeFile(dir, '.specs/' + CHANGE_ID + '/TASK.md', fixBatchTaskText('done'));
180
+ writeFile(dir, '.specs/' + CHANGE_ID + '/T01-SUMMARY.md', strictSummary('T01'));
181
+ writeFile(dir, '.specs/' + CHANGE_ID + '/T-FIX-01-SUMMARY.md', strictSummary('T-FIX-01'));
182
+ writeFile(dir, '.specs/' + CHANGE_ID + '/REVIEW.md',
183
+ '# REVIEW\n\n## 发现\n\n### Critical\n\n- 无\n\n### Major\n\n- 无\n\n### Minor\n\n- 无\n\n## 结论\n\n审查结论已记录;待回源 verify 重新出口。\n');
184
+ writeFile(dir, '.specs/' + CHANGE_ID + '/TEST.md', '# TEST\n\n## 验证命令\n\n```bash\nnode -e "1"\n```\n');
185
+ writeFile(dir, '.specs/' + CHANGE_ID + '/UAT.md', '# UAT\n\n## 验收\n\n- 通过\n');
186
+ writeState(dir, {
187
+ activeChange: CHANGE_ID,
188
+ currentNode: 'execute',
189
+ completedNodes: ['open', 'design', 'plan', 'execute', 'subagent-execute', 'review'],
190
+ enteredNodes: ['open', 'design', 'plan', 'execute', 'subagent-execute', 'review', 'verify'],
191
+ evidence: {
192
+ execute: { summary: 'fix batch executed' },
193
+ 'subagent-execute': { summary: 'delegated', handoffResult: handoffFor(['T01', 'T-FIX-01']) },
194
+ review: { summary: 'review complete' },
195
+ verify: { summary: 'verify in progress' },
196
+ },
197
+ verifyFailures: 0,
198
+ executionMode: 'subagent',
199
+ directOverride: false,
200
+ newChange: true,
201
+ });
202
+ const res = runGuard(['exit', 'execute', '--apply'], dir);
203
+ assertExit(res, 0);
204
+ assertOut(res, 'FIX-BATCH: 回源节点 verify(execute 出口已完成)');
205
+ assertOut(res, 'NODE: verify');
206
+ assertNotOut(res, 'NODE: archive');
207
+ const after = readScenarioState(dir);
208
+ if (after.currentNode !== 'verify') {
209
+ throw new Error('Fix 回程后 currentNode 应为 verify,实际 ' + JSON.stringify(after.currentNode));
210
+ }
211
+ },
212
+ },
213
+
214
+ // 252: 越界拦截 + 恢复 + 旧 change 渐进——源节点(review/verify)驻留且 TASK 有 pending Fix
215
+ // 任务时直接 exit 源节点收场:新 change BLOCKED 且含恢复指引(不许静默跳过 execute 出口门禁);
216
+ // 按指引 entry execute 归位 → 完成修复 → exit execute 回源节点可恢复;
217
+ // done-but-unclosed 变体(全任务 done 但本批 execute 出口未重跑:history 最新 exit execute
218
+ // 签名与当前任务集不等)同样 BLOCKED 且 state 零改写,闭合后源节点出口恢复通过;
219
+ // 旧 change(无 newChange 标记)保持渐进 WARN 不阻断(向后兼容)。
220
+ {
221
+ name: '252 越界:源节点 + pending/done-but-unclosed Fix 直接 exit 源节点 BLOCK(新)/WARN(旧)+ 恢复闭环',
222
+ run: (dir) => {
223
+ writeIntakeArtifacts(dir);
224
+ const taskPath = '.specs/' + CHANGE_ID + '/TASK.md';
225
+ const statePath = path.join(dir, '.flow-comet', 'flow-comet-state.json');
226
+ writeFile(dir, '.specs/' + CHANGE_ID + '/REVIEW.md',
227
+ '# REVIEW\n\n## 发现\n\n### Critical\n\n- 无\n\n### Major\n\n- 无\n\n### Minor\n\n- 无\n\n## 结论\n\n审查发现需修复项,Fix 任务已追加;待 execute 出口完成后重新出口。\n');
228
+ writeFile(dir, '.specs/' + CHANGE_ID + '/T01-SUMMARY.md', strictSummary('T01'));
229
+ const reviewState = {
230
+ activeChange: CHANGE_ID,
231
+ currentNode: 'review',
232
+ completedNodes: ['open', 'design', 'plan', 'execute', 'subagent-execute'],
233
+ enteredNodes: ['open', 'design', 'plan', 'execute', 'subagent-execute', 'review'],
234
+ evidence: {
235
+ execute: { summary: 'first pass executed' },
236
+ 'subagent-execute': { summary: 'delegated', handoffResult: handoffFor(['T01']) },
237
+ review: { summary: 'review in progress' },
238
+ },
239
+ verifyFailures: 0,
240
+ executionMode: 'subagent',
241
+ directOverride: false,
242
+ newChange: true,
243
+ };
244
+ // ① 新 change:review 源直接 exit review --apply → BLOCKED + 恢复指引(不得静默放行)
245
+ writeFile(dir, taskPath, fixBatchTaskText('pending'));
246
+ writeState(dir, reviewState);
247
+ const resBlock = runGuard(['exit', 'review', '--apply'], dir);
248
+ assertExit(resBlock, 1);
249
+ assertOut(resBlock, 'BLOCKED: 存在未归位/未跑出口的 Fix 批次');
250
+ assertOut(resBlock, 'entry execute');
251
+ assertNotOut(resBlock, 'ALL CHECKS PASSED');
252
+ let after = readScenarioState(dir);
253
+ if (after.currentNode !== 'review' || after.completedNodes.includes('review')) {
254
+ throw new Error('BLOCK 不得改写 state(review 未完成/未推进),实际 '
255
+ + JSON.stringify({ currentNode: after.currentNode, completedNodes: after.completedNodes }));
256
+ }
257
+ // ② 恢复:entry execute 受控归位 → 完成 Fix 任务并补 SUMMARY/handoff → exit execute 回源 review
258
+ const recEntry = runGuard(['entry', 'execute'], dir);
259
+ assertExit(recEntry, 0);
260
+ assertOut(recEntry, 'FIX-BATCH: 受控归位 execute(源节点 review)');
261
+ after = readScenarioState(dir);
262
+ if (after.currentNode !== 'execute') {
263
+ throw new Error('恢复步 entry execute 应归位 execute,实际 ' + JSON.stringify(after.currentNode));
264
+ }
265
+ writeFile(dir, taskPath, fixBatchTaskText('done'));
266
+ writeFile(dir, '.specs/' + CHANGE_ID + '/T-FIX-01-SUMMARY.md', strictSummary('T-FIX-01'));
267
+ after = readScenarioState(dir);
268
+ after.evidence['subagent-execute'] = after.evidence['subagent-execute'] || {};
269
+ after.evidence['subagent-execute'].handoffResult = {
270
+ ...(after.evidence['subagent-execute'].handoffResult || {}),
271
+ ...handoffFor(['T-FIX-01']),
272
+ };
273
+ writeState(dir, after);
274
+ const recExit = runGuard(['exit', 'execute', '--apply'], dir);
275
+ assertExit(recExit, 0);
276
+ assertOut(recExit, 'FIX-BATCH: 回源节点 review(execute 出口已完成)');
277
+ if (readScenarioState(dir).currentNode !== 'review') {
278
+ throw new Error('恢复闭环 exit execute 后应回源 review,实际 ' + JSON.stringify(readScenarioState(dir).currentNode));
279
+ }
280
+ // ③ 新 change:verify 源 + TEST/UAT 产物在场(原路径会跳过 verify 去 archive)→ 同样 BLOCKED
281
+ writeFile(dir, '.specs/' + CHANGE_ID + '/TEST.md', '# TEST\n\n## 验证命令\n\n```bash\nnode -e "1"\n```\n');
282
+ writeFile(dir, '.specs/' + CHANGE_ID + '/UAT.md', '# UAT\n\n## 验收\n\n- 通过\n');
283
+ writeFile(dir, taskPath, fixBatchTaskText('pending'));
284
+ writeState(dir, {
285
+ ...reviewState,
286
+ currentNode: 'verify',
287
+ completedNodes: ['open', 'design', 'plan', 'execute', 'subagent-execute', 'review'],
288
+ enteredNodes: ['open', 'design', 'plan', 'execute', 'subagent-execute', 'review', 'verify'],
289
+ evidence: { ...reviewState.evidence, verify: { summary: 'verify in progress' } },
290
+ });
291
+ const resVerifyBlock = runGuard(['exit', 'verify', '--apply'], dir);
292
+ assertExit(resVerifyBlock, 1);
293
+ assertOut(resVerifyBlock, 'BLOCKED: 存在未归位/未跑出口的 Fix 批次');
294
+ assertOut(resVerifyBlock, 'entry execute');
295
+ assertNotOut(resVerifyBlock, 'ALL CHECKS PASSED');
296
+ after = readScenarioState(dir);
297
+ if (after.currentNode !== 'verify' || after.completedNodes.includes('verify')) {
298
+ throw new Error('verify 源 BLOCK 不得改写 state,实际 '
299
+ + JSON.stringify({ currentNode: after.currentNode, completedNodes: after.completedNodes }));
300
+ }
301
+ // ③b 越界恢复指引优先于通用 entry 提示:同路径但无 enter 痕迹(enteredNodes 缺失)
302
+ // 仍须给 Fix 恢复指引(不得被「未执行 entry 直接 exit」通用提示覆盖)。
303
+ writeFile(dir, taskPath, fixBatchTaskText('pending'));
304
+ writeState(dir, { ...reviewState, enteredNodes: [] });
305
+ const resNoEntryBlock = runGuard(['exit', 'review', '--apply'], dir);
306
+ assertExit(resNoEntryBlock, 1);
307
+ assertOut(resNoEntryBlock, 'BLOCKED: 存在未归位/未跑出口的 Fix 批次');
308
+ assertNotOut(resNoEntryBlock, '未执行 entry 直接 exit');
309
+ // ③c 新 change done-but-unclosed(review 源):Fix 任务已 done,但 history 最新 exit
310
+ // execute 签名仍是追加前值(本批 execute 出口从未重跑)→ 必须 BLOCKED 且 state 字节零
311
+ // 改写(修复前此路径静默放行为 NODE: verify / archive)。
312
+ writeFile(dir, taskPath, fixBatchTaskText('done'));
313
+ writeFile(dir, '.specs/' + CHANGE_ID + '/T-FIX-01-SUMMARY.md', strictSummary('T-FIX-01'));
314
+ writeState(dir, { ...reviewState, history: fixBatchHistoryWithStaleExecuteExit() });
315
+ const staleReviewBytes = fs.readFileSync(statePath, 'utf8');
316
+ const resDoneBlock = runGuard(['exit', 'review', '--apply'], dir);
317
+ assertExit(resDoneBlock, 1);
318
+ assertOut(resDoneBlock, 'BLOCKED: 存在未归位/未跑出口的 Fix 批次');
319
+ assertOut(resDoneBlock, 'entry execute');
320
+ assertOut(resDoneBlock, 'workflow-state.mjs next');
321
+ assertOut(resDoneBlock, '恢复');
322
+ assertNotOut(resDoneBlock, 'ALL CHECKS PASSED');
323
+ if (fs.readFileSync(statePath, 'utf8') !== staleReviewBytes) {
324
+ throw new Error('done-but-unclosed BLOCK 不得改写 state 字节');
325
+ }
326
+ // ③c-2 恢复闭环:entry execute 归位 → 补 handoff → exit execute --apply 写当前签名 →
327
+ // 回源 review → exit review 通过(闭合后 done 变体不再拦截)。
328
+ const recDoneEntry = runGuard(['entry', 'execute'], dir);
329
+ assertExit(recDoneEntry, 0);
330
+ assertOut(recDoneEntry, 'FIX-BATCH: 受控归位 execute(源节点 review)');
331
+ after = readScenarioState(dir);
332
+ if (after.currentNode !== 'execute') {
333
+ throw new Error('done-but-unclosed 恢复步 entry execute 应归位 execute,实际 ' + JSON.stringify(after.currentNode));
334
+ }
335
+ after.evidence['subagent-execute'] = after.evidence['subagent-execute'] || {};
336
+ after.evidence['subagent-execute'].handoffResult = {
337
+ ...(after.evidence['subagent-execute'].handoffResult || {}),
338
+ ...handoffFor(['T-FIX-01']),
339
+ };
340
+ writeState(dir, after);
341
+ assertExit(runStateWithProtocol(dir, ['skill-load', 'execute', 'flow-comet-execute', '--prompt', 'flow-kit/prompts/4-dev.md']), 0);
342
+ const recDoneExit = runGuard(['exit', 'execute', '--apply'], dir);
343
+ assertExit(recDoneExit, 0);
344
+ assertOut(recDoneExit, 'FIX-BATCH: 回源节点 review(execute 出口已完成)');
345
+ assertOut(recDoneExit, 'NODE: review');
346
+ assertExit(runStateWithProtocol(dir, ['skill-load', 'review', 'flow-comet-review', '--prompt', 'flow-kit/prompts/6-review.md']), 0);
347
+ assertExit(runGuard(['entry', 'review'], dir), 0);
348
+ const recDoneReview = runGuard(['exit', 'review', '--apply'], dir);
349
+ assertExit(recDoneReview, 0);
350
+ assertOut(recDoneReview, 'ALL CHECKS PASSED');
351
+ assertNotOut(recDoneReview, 'BLOCKED');
352
+ // ③d 新 change done-but-unclosed(verify 源):TEST/UAT 在场(原路径会跳过 verify 去
353
+ // archive)+ 全 Fix 任务 done + 最新 exit execute 签名过时 → BLOCKED,验证命令未执行,
354
+ // state 字节零改写;闭合后 exit verify 真实执行验证命令并推进 archive。
355
+ writeFile(dir, '.specs/' + CHANGE_ID + '/TEST.md',
356
+ '# TEST\n\n## 验证命令\n\n```\nnode -e "require(\'fs\').writeFileSync(\'verify-gate-ran.txt\', \'GATE-RAN\')"\n```\n');
357
+ writeFile(dir, '.specs/' + CHANGE_ID + '/UAT.md', '# UAT\n\n## 验收\n\n- 通过\n');
358
+ const gateMarker = path.join(dir, 'verify-gate-ran.txt');
359
+ fs.rmSync(gateMarker, { force: true });
360
+ writeFile(dir, taskPath, fixBatchTaskText('done'));
361
+ writeState(dir, {
362
+ ...reviewState,
363
+ currentNode: 'verify',
364
+ completedNodes: ['open', 'design', 'plan', 'execute', 'subagent-execute', 'review'],
365
+ enteredNodes: ['open', 'design', 'plan', 'execute', 'subagent-execute', 'review', 'verify'],
366
+ evidence: { ...reviewState.evidence, review: { summary: 'review complete' }, verify: { summary: 'verify in progress' } },
367
+ history: fixBatchHistoryWithStaleExecuteExit(),
368
+ });
369
+ const staleVerifyBytes = fs.readFileSync(statePath, 'utf8');
370
+ const resDoneVerifyBlock = runGuard(['exit', 'verify', '--apply'], dir);
371
+ assertExit(resDoneVerifyBlock, 1);
372
+ assertOut(resDoneVerifyBlock, 'BLOCKED: 存在未归位/未跑出口的 Fix 批次');
373
+ assertOut(resDoneVerifyBlock, 'entry execute');
374
+ assertNotOut(resDoneVerifyBlock, 'ALL CHECKS PASSED');
375
+ if (fs.existsSync(gateMarker)) throw new Error('done-but-unclosed verify BLOCK 不得执行验证命令');
376
+ if (fs.readFileSync(statePath, 'utf8') !== staleVerifyBytes) {
377
+ throw new Error('done-but-unclosed verify BLOCK 不得改写 state 字节');
378
+ }
379
+ const recDoneVerifyEntry = runGuard(['entry', 'execute'], dir);
380
+ assertExit(recDoneVerifyEntry, 0);
381
+ assertOut(recDoneVerifyEntry, 'FIX-BATCH: 受控归位 execute(源节点 verify)');
382
+ after = readScenarioState(dir);
383
+ after.evidence['subagent-execute'] = after.evidence['subagent-execute'] || {};
384
+ after.evidence['subagent-execute'].handoffResult = {
385
+ ...(after.evidence['subagent-execute'].handoffResult || {}),
386
+ ...handoffFor(['T-FIX-01']),
387
+ };
388
+ writeState(dir, after);
389
+ assertExit(runStateWithProtocol(dir, ['skill-load', 'execute', 'flow-comet-execute', '--prompt', 'flow-kit/prompts/4-dev.md']), 0);
390
+ const recDoneVerifyExit = runGuard(['exit', 'execute', '--apply'], dir);
391
+ assertExit(recDoneVerifyExit, 0);
392
+ assertOut(recDoneVerifyExit, 'FIX-BATCH: 回源节点 verify(execute 出口已完成)');
393
+ assertOut(recDoneVerifyExit, 'NODE: verify');
394
+ assertExit(runStateWithProtocol(dir, ['skill-load', 'verify', 'flow-comet-verify', '--prompt', 'flow-kit/prompts/7-integration.md']), 0);
395
+ assertExit(runGuard(['entry', 'verify'], dir), 0);
396
+ const recDoneVerify = runGuard(['exit', 'verify', '--apply'], dir);
397
+ assertExit(recDoneVerify, 0);
398
+ assertOut(recDoneVerify, 'ALL CHECKS PASSED');
399
+ assertOut(recDoneVerify, 'NODE: archive');
400
+ if (!fs.existsSync(gateMarker) || fs.readFileSync(gateMarker, 'utf8') !== 'GATE-RAN') {
401
+ throw new Error('闭合后 verify 出口未真实执行 TEST.md 验证命令(副作用文件缺失/内容不符)');
402
+ }
403
+ // ④ 旧 change(无 newChange 标记)pending 同路径:渐进 WARN 不阻断(向后兼容)
404
+ writeFile(dir, taskPath, fixBatchTaskText('pending'));
405
+ writeState(dir, { ...reviewState, newChange: false });
406
+ const resOld = runGuard(['exit', 'review'], dir);
407
+ assertExit(resOld, 0);
408
+ assertOut(resOld, 'FIX-BATCH WARN');
409
+ assertOut(resOld, 'ALL CHECKS PASSED');
410
+ // ④b 过渡态渐进(feature 之前创建的 state 无 exit execute 签名字段):全 done 也不得
411
+ // 仅凭「签名缺席」误判未闭合——无签名记录 → done 变体不成立,源节点出口保持可走
412
+ writeFile(dir, taskPath, fixBatchTaskText('done'));
413
+ writeFile(dir, '.specs/' + CHANGE_ID + '/T-FIX-01-SUMMARY.md', strictSummary('T-FIX-01'));
414
+ writeState(dir, { ...reviewState, history: [{ event: 'exit-applied', node: 'execute', at: '2026-09-19T00:00:00.000Z' }] });
415
+ const resLegacyState = runGuard(['exit', 'review', '--apply'], dir);
416
+ assertExit(resLegacyState, 0);
417
+ assertNotOut(resLegacyState, 'BLOCKED');
418
+ assertOut(resLegacyState, 'ALL CHECKS PASSED');
419
+ // ⑤ 并行 Fix 任务(pending)+ review 源:直接 exit review 仍 BLOCKED;next/entry 归位
420
+ // subagent-execute;修复后 exit subagent-execute --apply 为第二趟完成 → 回源 review,
421
+ // 源节点出口随后真实执行(闭合后不得再拦)。
422
+ writeFile(dir, taskPath, fixBatchParallelTaskText('pending'));
423
+ writeState(dir, reviewState);
424
+ const rParBlock = runGuard(['exit', 'review', '--apply'], dir);
425
+ assertExit(rParBlock, 1);
426
+ assertOut(rParBlock, 'BLOCKED: 存在未归位/未跑出口的 Fix 批次');
427
+ assertNotOut(rParBlock, 'ALL CHECKS PASSED');
428
+ writeState(dir, reviewState);
429
+ const rParNext = runStateWithProtocol(dir, ['next']);
430
+ assertExit(rParNext, 0);
431
+ assertOut(rParNext, 'FIX-BATCH: 归位 subagent-execute(源节点 review)');
432
+ assertOut(rParNext, 'NODE: subagent-execute');
433
+ assertNotOut(rParNext, 'NODE: execute');
434
+ writeState(dir, reviewState);
435
+ const rParEntry = runGuard(['entry', 'subagent-execute'], dir);
436
+ assertExit(rParEntry, 0);
437
+ assertOut(rParEntry, 'FIX-BATCH: 受控归位 subagent-execute(源节点 review)');
438
+ after = readScenarioState(dir);
439
+ if (after.currentNode !== 'subagent-execute') {
440
+ throw new Error('并行回退态 entry subagent-execute 后 currentNode 应为 subagent-execute,实际 ' + JSON.stringify(after.currentNode));
441
+ }
442
+ writeFile(dir, taskPath, fixBatchParallelTaskText('done'));
443
+ writeFile(dir, '.specs/' + CHANGE_ID + '/P-FIX-01-SUMMARY.md', strictSummary('P-FIX-01'));
444
+ after.evidence['subagent-execute'] = after.evidence['subagent-execute'] || {};
445
+ after.evidence['subagent-execute'].summary = 'parallel fix delegated and collected';
446
+ after.evidence['subagent-execute'].handoffResult = {
447
+ ...(after.evidence['subagent-execute'].handoffResult || {}),
448
+ ...handoffFor(['P-FIX-01']),
449
+ };
450
+ writeState(dir, after);
451
+ assertExit(runStateWithProtocol(dir, ['skill-load', 'subagent-execute', 'flow-comet-dev', '--prompt', 'flow-kit/prompts/4-dev.md']), 0);
452
+ const rParExit = runGuard(['exit', 'subagent-execute', '--apply'], dir);
453
+ assertExit(rParExit, 0);
454
+ assertOut(rParExit, 'FIX-BATCH: 回源节点 review(subagent-execute 出口已完成)');
455
+ assertOut(rParExit, 'NODE: review');
456
+ after = readScenarioState(dir);
457
+ if (after.currentNode !== 'review') {
458
+ throw new Error('并行修复第二趟出口后应回源 review,实际 ' + JSON.stringify(after.currentNode));
459
+ }
460
+ const parFamilyExit = (after.history || [])
461
+ .filter((e) => e && e.event === 'exit-applied' && e.node === 'subagent-execute').pop();
462
+ if (!parFamilyExit || parFamilyExit.change !== CHANGE_ID
463
+ || typeof parFamilyExit.taskSetSignature !== 'string' || parFamilyExit.taskSetSignature === '') {
464
+ throw new Error('并行修复出口应记录本 change + taskSetSignature 的家族出口事件,实际 ' + JSON.stringify(parFamilyExit));
465
+ }
466
+ assertExit(runStateWithProtocol(dir, ['skill-load', 'review', 'flow-comet-review', '--prompt', 'flow-kit/prompts/6-review.md']), 0);
467
+ assertExit(runGuard(['entry', 'review'], dir), 0);
468
+ const rParSource = runGuard(['exit', 'review', '--apply'], dir);
469
+ assertExit(rParSource, 0);
470
+ assertOut(rParSource, 'ALL CHECKS PASSED');
471
+ assertNotOut(rParSource, 'BLOCKED');
472
+ // ⑥ verify 源 + 并行 pending:直接 exit verify 同样 BLOCKED(不得绕过家族生命周期)。
473
+ writeFile(dir, taskPath, fixBatchParallelTaskText('pending'));
474
+ writeState(dir, {
475
+ ...reviewState,
476
+ currentNode: 'verify',
477
+ completedNodes: [...reviewState.completedNodes, 'review'],
478
+ enteredNodes: [...reviewState.enteredNodes, 'verify'],
479
+ evidence: { ...reviewState.evidence, review: { summary: 'review complete' }, verify: { summary: 'verify in progress' } },
480
+ });
481
+ const rParVerifyBlock = runGuard(['exit', 'verify', '--apply'], dir);
482
+ assertExit(rParVerifyBlock, 1);
483
+ assertOut(rParVerifyBlock, 'BLOCKED: 存在未归位/未跑出口的 Fix 批次');
484
+ assertNotOut(rParVerifyBlock, 'ALL CHECKS PASSED');
485
+ // ⑦ done-but-unclosed 并行变体:全 done + 最新家族出口事件(subagent-execute)签名过时
486
+ // → 直接 exit review BLOCKED;entry 归位 subagent-execute;第二趟出口写当前签名并回源。
487
+ writeFile(dir, taskPath, fixBatchParallelTaskText('done'));
488
+ writeFile(dir, '.specs/' + CHANGE_ID + '/P-FIX-01-SUMMARY.md', strictSummary('P-FIX-01'));
489
+ writeState(dir, { ...reviewState, history: fixBatchHistoryWithStaleFamilyExit('subagent-execute') });
490
+ const rDoneParBlock = runGuard(['exit', 'review', '--apply'], dir);
491
+ assertExit(rDoneParBlock, 1);
492
+ assertOut(rDoneParBlock, 'BLOCKED: 存在未归位/未跑出口的 Fix 批次');
493
+ assertNotOut(rDoneParBlock, 'ALL CHECKS PASSED');
494
+ const rDoneParEntry = runGuard(['entry', 'subagent-execute'], dir);
495
+ assertExit(rDoneParEntry, 0);
496
+ assertOut(rDoneParEntry, 'FIX-BATCH: 受控归位 subagent-execute(源节点 review)');
497
+ after = readScenarioState(dir);
498
+ after.evidence['subagent-execute'] = after.evidence['subagent-execute'] || {};
499
+ after.evidence['subagent-execute'].handoffResult = {
500
+ ...(after.evidence['subagent-execute'].handoffResult || {}),
501
+ ...handoffFor(['P-FIX-01']),
502
+ };
503
+ writeState(dir, after);
504
+ assertExit(runStateWithProtocol(dir, ['skill-load', 'subagent-execute', 'flow-comet-dev', '--prompt', 'flow-kit/prompts/4-dev.md']), 0);
505
+ const rDoneParExit = runGuard(['exit', 'subagent-execute', '--apply'], dir);
506
+ assertExit(rDoneParExit, 0);
507
+ assertOut(rDoneParExit, 'FIX-BATCH: 回源节点 review(subagent-execute 出口已完成)');
508
+ if (readScenarioState(dir).currentNode !== 'review') {
509
+ throw new Error('done-but-unclosed 并行变体闭合后应回源 review,实际 ' + JSON.stringify(readScenarioState(dir).currentNode));
510
+ }
511
+ // ④c change 隔离:history 最新 exit 事件属于另一个 change(state.history 跨 change 保留)
512
+ // → 不得拿它当本 change 的闭合签名;本 change 无该字段的出口事件,done 变体不成立。
513
+ writeFile(dir, taskPath, fixBatchTaskText('done'));
514
+ writeFile(dir, '.specs/' + CHANGE_ID + '/T-FIX-01-SUMMARY.md', strictSummary('T-FIX-01'));
515
+ writeState(dir, {
516
+ ...reviewState,
517
+ history: [{
518
+ event: 'exit-applied', node: 'execute', change: 'other-change',
519
+ at: '2026-09-20T00:00:00.000Z', taskSetSignature: STALE_FIX_BATCH_SIGNATURE,
520
+ }],
521
+ });
522
+ const resOtherChange = runGuard(['exit', 'review', '--apply'], dir);
523
+ assertExit(resOtherChange, 0);
524
+ assertNotOut(resOtherChange, 'BLOCKED');
525
+ assertOut(resOtherChange, 'ALL CHECKS PASSED');
526
+ },
527
+ },
528
+
529
+ // 253a: next Fix 回退态显式归位——源节点(review / verify)驻留 + TASK 有 pending Fix 任务时,
530
+ // next 必须显式归位 execute、写盘并输出审计行,不再依赖 inProgress 保护的副作用
531
+ // (修复前 next 仍输出源节点)。串行族:review 源、verify 源各一段。
532
+ {
533
+ name: '253a next Fix 回退态显式归位:review/verify 源串行 pending',
534
+ run: (dir) => {
535
+ writeIntakeArtifacts(dir);
536
+ const taskPath = '.specs/' + CHANGE_ID + '/TASK.md';
537
+ const base = {
538
+ activeChange: CHANGE_ID,
539
+ currentNode: 'review',
540
+ completedNodes: ['open', 'design', 'plan', 'execute', 'subagent-execute'],
541
+ enteredNodes: ['open', 'design', 'plan', 'execute', 'subagent-execute', 'review'],
542
+ evidence: {
543
+ execute: { summary: 'first pass executed' },
544
+ review: { summary: 'review in progress' },
545
+ },
546
+ verifyFailures: 0,
547
+ executionMode: 'subagent',
548
+ directOverride: false,
549
+ newChange: true,
550
+ };
551
+ // ① review 源:pending Fix 任务在场 → NODE: execute + 审计行 + 机器字段归位写盘
552
+ writeFile(dir, taskPath, fixBatchTaskText('pending'));
553
+ writeState(dir, base);
554
+ const resReview = runStateWithProtocol(dir, ['next']);
555
+ assertExit(resReview, 0);
556
+ assertOut(resReview, 'FIX-BATCH: 归位 execute(源节点 review)');
557
+ assertOut(resReview, 'NODE: execute');
558
+ assertNotOut(resReview, 'NODE: review');
559
+ assertNotOut(resReview, 'NODE: verify');
560
+ assertNotOut(resReview, 'BLOCKED');
561
+ let after = readScenarioState(dir);
562
+ if (after.currentNode !== 'execute') {
563
+ throw new Error('review 源回退态 next 后 currentNode 应为 execute,实际 ' + JSON.stringify(after.currentNode));
564
+ }
565
+ // ② verify 源(review 已完成)→ 同样显式归位 + 审计行 + 写盘
566
+ writeFile(dir, taskPath, fixBatchTaskText('pending'));
567
+ writeState(dir, {
568
+ ...base,
569
+ currentNode: 'verify',
570
+ completedNodes: [...base.completedNodes, 'review'],
571
+ enteredNodes: [...base.enteredNodes, 'verify'],
572
+ evidence: { ...base.evidence, review: { summary: 'review complete' }, verify: { summary: 'verify in progress' } },
573
+ });
574
+ const resVerify = runStateWithProtocol(dir, ['next']);
575
+ assertExit(resVerify, 0);
576
+ assertOut(resVerify, 'FIX-BATCH: 归位 execute(源节点 verify)');
577
+ assertOut(resVerify, 'NODE: execute');
578
+ assertNotOut(resVerify, 'NODE: verify');
579
+ assertNotOut(resVerify, 'BLOCKED');
580
+ after = readScenarioState(dir);
581
+ if (after.currentNode !== 'execute') {
582
+ throw new Error('verify 源回退态 next 后 currentNode 应为 execute,实际 ' + JSON.stringify(after.currentNode));
583
+ }
584
+ },
585
+ },
586
+
587
+ // 253b: 非回退态不得归位——全 done(无 pending Fix 任务)与「无 pending 的回程态」两段:
588
+ // state 侧无 Fix 因果时不得出现任何 FIX-BATCH 行,也不得把 currentNode 改到 execute。
589
+ {
590
+ name: '253b next Fix 回退态反例:无 pending 不归位 execute',
591
+ run: (dir) => {
592
+ writeIntakeArtifacts(dir);
593
+ const taskPath = '.specs/' + CHANGE_ID + '/TASK.md';
594
+ const base = {
595
+ activeChange: CHANGE_ID,
596
+ currentNode: 'review',
597
+ completedNodes: ['open', 'design', 'plan', 'execute', 'subagent-execute'],
598
+ enteredNodes: ['open', 'design', 'plan', 'execute', 'subagent-execute', 'review'],
599
+ evidence: {
600
+ execute: { summary: 'first pass executed' },
601
+ review: { summary: 'review in progress' },
602
+ },
603
+ verifyFailures: 0,
604
+ executionMode: 'subagent',
605
+ directOverride: false,
606
+ newChange: true,
607
+ };
608
+ // ③ 反例:全 done(无 pending Fix 任务)→ 非回退态,不得归位 execute(回程逻辑另行覆盖)
609
+ let after;
610
+ writeFile(dir, taskPath, fixBatchTaskText('done'));
611
+ writeFile(dir, '.specs/' + CHANGE_ID + '/T01-SUMMARY.md', strictSummary('T01'));
612
+ writeFile(dir, '.specs/' + CHANGE_ID + '/T-FIX-01-SUMMARY.md', strictSummary('T-FIX-01'));
613
+ writeFile(dir, '.specs/' + CHANGE_ID + '/REVIEW.md',
614
+ '# REVIEW\n\n## 发现\n\n### Critical\n\n- 无\n\n### Major\n\n- 无\n\n### Minor\n\n- 无\n\n## 结论\n\nFix 批次由 execute 完成,待回源重新出口。\n');
615
+ writeState(dir, base);
616
+ const resNoFix = runStateWithProtocol(dir, ['next']);
617
+ assertExit(resNoFix, 0);
618
+ assertNotOut(resNoFix, 'FIX-BATCH: 归位 execute');
619
+ // ③ 全局缺席:无 pending Fix 任务的回程态,state 侧无 Fix 因果——不得出现任何 FIX-BATCH
620
+ // (含旧「回程源节点」误标形态;回程中性行由 RETURN 覆盖)
621
+ assertNotOut(resNoFix, 'FIX-BATCH');
622
+ assertNotOut(resNoFix, 'NODE: execute');
623
+ assertOut(resNoFix, 'NODE: review');
624
+ after = readScenarioState(dir);
625
+ if (after.currentNode !== 'review') {
626
+ throw new Error('无 pending 时不应归位 execute,实际 ' + JSON.stringify(after.currentNode));
627
+ }
628
+ },
629
+ },
630
+
631
+ // 253c: done-but-unclosed 串行回退态——全 done 但 history 最新 exit execute 的签名仍是追加前的
632
+ // 旧值:next 同样必须显式归位 execute(修复前 done 变体无恢复通道,next 停在源节点)。
633
+ {
634
+ name: '253c next Fix 回退态:done-but-unclosed(签名过时)仍归位',
635
+ run: (dir) => {
636
+ writeIntakeArtifacts(dir);
637
+ const taskPath = '.specs/' + CHANGE_ID + '/TASK.md';
638
+ const base = {
639
+ activeChange: CHANGE_ID,
640
+ currentNode: 'review',
641
+ completedNodes: ['open', 'design', 'plan', 'execute', 'subagent-execute'],
642
+ enteredNodes: ['open', 'design', 'plan', 'execute', 'subagent-execute', 'review'],
643
+ evidence: {
644
+ execute: { summary: 'first pass executed' },
645
+ review: { summary: 'review in progress' },
646
+ },
647
+ verifyFailures: 0,
648
+ executionMode: 'subagent',
649
+ directOverride: false,
650
+ newChange: true,
651
+ };
652
+ // ④ done-but-unclosed 回退态(全 done + history 最新 exit execute 签名仍是追加前值):
653
+ // next 同样显式归位 execute(修复前 done 变体无恢复通道,next 停在源节点)。
654
+ // 前置沿用该族的「全 done」夹具形态:TASK 全 done + 两个 done 任务的 SUMMARY + REVIEW.md。
655
+ writeFile(dir, taskPath, fixBatchTaskText('done'));
656
+ writeFile(dir, '.specs/' + CHANGE_ID + '/T01-SUMMARY.md', strictSummary('T01'));
657
+ writeFile(dir, '.specs/' + CHANGE_ID + '/T-FIX-01-SUMMARY.md', strictSummary('T-FIX-01'));
658
+ writeFile(dir, '.specs/' + CHANGE_ID + '/REVIEW.md',
659
+ '# REVIEW\n\n## 发现\n\n### Critical\n\n- 无\n\n### Major\n\n- 无\n\n### Minor\n\n- 无\n\n## 结论\n\nFix 批次由 execute 完成,待回源重新出口。\n');
660
+ let after;
661
+ writeState(dir, { ...base, history: fixBatchHistoryWithStaleExecuteExit() });
662
+ const resDoneRollback = runStateWithProtocol(dir, ['next']);
663
+ assertExit(resDoneRollback, 0);
664
+ assertOut(resDoneRollback, 'FIX-BATCH: 归位 execute(源节点 review)');
665
+ assertOut(resDoneRollback, 'NODE: execute');
666
+ assertNotOut(resDoneRollback, 'NODE: review');
667
+ assertNotOut(resDoneRollback, 'BLOCKED');
668
+ after = readScenarioState(dir);
669
+ if (after.currentNode !== 'execute') {
670
+ throw new Error('done-but-unclosed 回退态 next 后 currentNode 应为 execute,实际 ' + JSON.stringify(after.currentNode));
671
+ }
672
+ },
673
+ },
674
+
675
+ // 253d: 并行 pending Fix 任务的归位目标——review 源 / verify 源 / done-but-unclosed 并行变体:
676
+ // 归位目标是事件记录的家族节点(subagent-execute),不得停在源节点、也不得错配回 execute。
677
+ {
678
+ name: '253d next Fix 回退态归位:并行 pending → subagent-execute(含 done-but-unclosed 变体)',
679
+ run: (dir) => {
680
+ writeIntakeArtifacts(dir);
681
+ const taskPath = '.specs/' + CHANGE_ID + '/TASK.md';
682
+ const base = {
683
+ activeChange: CHANGE_ID,
684
+ currentNode: 'review',
685
+ completedNodes: ['open', 'design', 'plan', 'execute', 'subagent-execute'],
686
+ enteredNodes: ['open', 'design', 'plan', 'execute', 'subagent-execute', 'review'],
687
+ evidence: {
688
+ execute: { summary: 'first pass executed' },
689
+ review: { summary: 'review in progress' },
690
+ },
691
+ verifyFailures: 0,
692
+ executionMode: 'subagent',
693
+ directOverride: false,
694
+ newChange: true,
695
+ };
696
+ // ⑤ review 源 + 并行 pending Fix 任务:next 必须归位 subagent-execute(并行路由目标),
697
+ // 不得停在源节点,也不得错配回 execute。
698
+ let after;
699
+ writeFile(dir, taskPath, fixBatchParallelTaskText('pending'));
700
+ writeState(dir, base);
701
+ const resParallelReview = runStateWithProtocol(dir, ['next']);
702
+ assertExit(resParallelReview, 0);
703
+ assertOut(resParallelReview, 'FIX-BATCH: 归位 subagent-execute(源节点 review)');
704
+ assertOut(resParallelReview, 'NODE: subagent-execute');
705
+ assertNotOut(resParallelReview, 'NODE: review');
706
+ assertNotOut(resParallelReview, 'NODE: execute');
707
+ assertNotOut(resParallelReview, 'BLOCKED');
708
+ after = readScenarioState(dir);
709
+ if (after.currentNode !== 'subagent-execute') {
710
+ throw new Error('review 源并行回退态 next 后 currentNode 应为 subagent-execute,实际 ' + JSON.stringify(after.currentNode));
711
+ }
712
+ // ⑥ verify 源 + 并行 pending Fix 任务:同样归位 subagent-execute。
713
+ writeFile(dir, taskPath, fixBatchParallelTaskText('pending'));
714
+ writeState(dir, {
715
+ ...base,
716
+ currentNode: 'verify',
717
+ completedNodes: [...base.completedNodes, 'review'],
718
+ enteredNodes: [...base.enteredNodes, 'verify'],
719
+ evidence: { ...base.evidence, review: { summary: 'review complete' }, verify: { summary: 'verify in progress' } },
720
+ });
721
+ const resParallelVerify = runStateWithProtocol(dir, ['next']);
722
+ assertExit(resParallelVerify, 0);
723
+ assertOut(resParallelVerify, 'FIX-BATCH: 归位 subagent-execute(源节点 verify)');
724
+ assertOut(resParallelVerify, 'NODE: subagent-execute');
725
+ assertNotOut(resParallelVerify, 'NODE: verify');
726
+ assertNotOut(resParallelVerify, 'BLOCKED');
727
+ after = readScenarioState(dir);
728
+ if (after.currentNode !== 'subagent-execute') {
729
+ throw new Error('verify 源并行回退态 next 后 currentNode 应为 subagent-execute,实际 ' + JSON.stringify(after.currentNode));
730
+ }
731
+ // ⑦ done-but-unclosed 并行变体(全 done + 最新 exit subagent-execute 签名过时):
732
+ // next 必须按事件记录的家族节点归位 subagent-execute。
733
+ writeFile(dir, taskPath, fixBatchParallelTaskText('done'));
734
+ writeFile(dir, '.specs/' + CHANGE_ID + '/P-FIX-01-SUMMARY.md', strictSummary('P-FIX-01'));
735
+ writeState(dir, { ...base, history: fixBatchHistoryWithStaleFamilyExit('subagent-execute') });
736
+ const resDoneParallel = runStateWithProtocol(dir, ['next']);
737
+ assertExit(resDoneParallel, 0);
738
+ assertOut(resDoneParallel, 'FIX-BATCH: 归位 subagent-execute(源节点 review)');
739
+ assertOut(resDoneParallel, 'NODE: subagent-execute');
740
+ assertNotOut(resDoneParallel, 'NODE: execute');
741
+ assertNotOut(resDoneParallel, 'BLOCKED');
742
+ after = readScenarioState(dir);
743
+ if (after.currentNode !== 'subagent-execute') {
744
+ throw new Error('done-but-unclosed 并行变体 next 后 currentNode 应为 subagent-execute,实际 ' + JSON.stringify(after.currentNode));
745
+ }
746
+ },
747
+ },
748
+
749
+ // 253e: next 入口的受控归位轮次纪律——第 1~3 轮逐轮放行并同步计数器;第 4 轮新 change BLOCK
750
+ // 且 state 字节零改写;非法授权形态(缺 at/source)仍按未授权 fail-closed;完整三元组授权放行。
751
+ {
752
+ name: '253e next 受控归位轮次:1~3 轮递增 / 第 4 轮 BLOCK / 授权形态 fail-closed 与放行',
753
+ run: (dir) => {
754
+ writeIntakeArtifacts(dir);
755
+ const taskPath = '.specs/' + CHANGE_ID + '/TASK.md';
756
+ const base = {
757
+ activeChange: CHANGE_ID,
758
+ currentNode: 'review',
759
+ completedNodes: ['open', 'design', 'plan', 'execute', 'subagent-execute'],
760
+ enteredNodes: ['open', 'design', 'plan', 'execute', 'subagent-execute', 'review'],
761
+ evidence: {
762
+ execute: { summary: 'first pass executed' },
763
+ review: { summary: 'review in progress' },
764
+ },
765
+ verifyFailures: 0,
766
+ executionMode: 'subagent',
767
+ directOverride: false,
768
+ newChange: true,
769
+ };
770
+ // ⑧ m-12 next 入口第 1~3 轮递增:逐轮重置驻留 review,审计后缀第 n/3 轮且计数器同步 +1
771
+ writeFile(dir, taskPath, fixBatchTaskText('pending'));
772
+ for (let round = 1; round <= 3; round += 1) {
773
+ writeState(dir, base);
774
+ const stRound = readScenarioState(dir);
775
+ stRound.fixRoundsByChange = { [CHANGE_ID]: round - 1 };
776
+ writeState(dir, stRound);
777
+ const resRound = runStateWithProtocol(dir, ['next']);
778
+ assertExit(resRound, 0);
779
+ assertOut(resRound, 'FIX-BATCH: 归位 execute(源节点 review)(第 ' + round + '/3 轮)');
780
+ const stAfterRound = readScenarioState(dir);
781
+ if (stAfterRound.fixRoundsByChange?.[CHANGE_ID] !== round) {
782
+ throw new Error('next 第 ' + round + ' 轮归位后计数器应为 ' + round + ',实际 '
783
+ + JSON.stringify(stAfterRound.fixRoundsByChange));
784
+ }
785
+ }
786
+ // ⑨ 第 4 轮新 change BLOCK:state 字节零改写(不写 currentNode、不写计数器)
787
+ writeState(dir, { ...base, fixRoundsByChange: { [CHANGE_ID]: 3 } });
788
+ const statePath = path.join(dir, '.flow-comet', 'flow-comet-state.json');
789
+ const beforeRound4 = fs.readFileSync(statePath, 'utf8');
790
+ const resRound4 = runStateWithProtocol(dir, ['next']);
791
+ assertExit(resRound4, 1);
792
+ assertOut(resRound4, 'BLOCKED: Fix 批次受控归位已达 3 轮上限');
793
+ assertOut(resRound4, '继续修');
794
+ assertOut(resRound4, '停止');
795
+ if (fs.readFileSync(statePath, 'utf8') !== beforeRound4) {
796
+ throw new Error('next 第 4 轮 BLOCK 必须 state 字节零改写');
797
+ }
798
+ const stBlocked = readScenarioState(dir);
799
+ if (stBlocked.currentNode !== 'review' || stBlocked.fixRoundsByChange?.[CHANGE_ID] !== 3) {
800
+ throw new Error('next 第 4 轮 BLOCK 后 currentNode/计数器不得改写,实际 '
801
+ + JSON.stringify({ currentNode: stBlocked.currentNode, rounds: stBlocked.fixRoundsByChange }));
802
+ }
803
+ // ⑨b F5:非法授权形态(仅 round,缺 at/source)在 next 链路上仍按未授权 fail-closed——
804
+ // 继续 BLOCK、state 字节零改写、currentNode 保持 review、计数器保持 3。
805
+ const stBadOverride = JSON.parse(fs.readFileSync(statePath, 'utf8'));
806
+ stBadOverride.evidence.review.fixRoundOverride = { round: 4 };
807
+ writeState(dir, stBadOverride);
808
+ const badOverrideBytes = fs.readFileSync(statePath, 'utf8');
809
+ const resBadOverride = runStateWithProtocol(dir, ['next']);
810
+ assertExit(resBadOverride, 1);
811
+ assertOut(resBadOverride, 'BLOCKED: Fix 批次受控归位已达 3 轮上限');
812
+ assertNotOut(resBadOverride, '(第 4/3 轮)');
813
+ if (fs.readFileSync(statePath, 'utf8') !== badOverrideBytes) {
814
+ throw new Error('F5 缺 at/source 的授权形态必须在 next 链路上 state 字节零改写');
815
+ }
816
+ const stBadAfter = readScenarioState(dir);
817
+ if (stBadAfter.currentNode !== 'review' || stBadAfter.fixRoundsByChange?.[CHANGE_ID] !== 3) {
818
+ throw new Error('F5 缺 at/source 不得放行第 4 轮(currentNode 保持 review、计数保持 3),实际 '
819
+ + JSON.stringify({ currentNode: stBadAfter.currentNode, rounds: stBadAfter.fixRoundsByChange }));
820
+ }
821
+ // ⑩ 用户显式授权(嵌套 evidence,完整三元组)→ next 第 4 轮放行并写盘
822
+ const stOverride = JSON.parse(fs.readFileSync(statePath, 'utf8'));
823
+ stOverride.evidence.review.fixRoundOverride = { round: 4, at: '2026-09-25T00:00:00.000Z', source: 'fixture-user' };
824
+ writeState(dir, stOverride);
825
+ const resOverride = runStateWithProtocol(dir, ['next']);
826
+ assertExit(resOverride, 0);
827
+ assertOut(resOverride, '(第 4/3 轮)');
828
+ const stAuthorized = readScenarioState(dir);
829
+ if (stAuthorized.currentNode !== 'execute' || stAuthorized.fixRoundsByChange?.[CHANGE_ID] !== 4) {
830
+ throw new Error('next 授权后第 4 轮应放行归位(currentNode=execute、计数器=4),实际 '
831
+ + JSON.stringify({ currentNode: stAuthorized.currentNode, rounds: stAuthorized.fixRoundsByChange }));
832
+ }
833
+ },
834
+ },
835
+
836
+ // 254: next Fix 回程豁免(review 源)——exit execute --apply 把 currentNode 推回 review 后,
837
+ // REVIEW.md 已在场会让 resolveNextNode 按产物跳过未出口的 review;next 必须在源节点未完成时
838
+ // 显式放行 review(审计行 + 只读不改写 state),不依赖 inProgress 保护副作用;无 review 证据的
839
+ // 引擎回程态同样放行(修复前缺审计行 / 漂移 verify / 无证据时 BLOCK)。
840
+ {
841
+ name: '254 next Fix 回程豁免:review 源(REVIEW.md 在场不跳过;无 inProgress 证据也不 BLOCK)',
842
+ run: (dir) => {
843
+ writeIntakeArtifacts(dir);
844
+ writeFile(dir, '.specs/' + CHANGE_ID + '/TASK.md', fixBatchTaskText('done'));
845
+ writeFile(dir, '.specs/' + CHANGE_ID + '/T01-SUMMARY.md', strictSummary('T01'));
846
+ writeFile(dir, '.specs/' + CHANGE_ID + '/T-FIX-01-SUMMARY.md', strictSummary('T-FIX-01'));
847
+ writeFile(dir, '.specs/' + CHANGE_ID + '/REVIEW.md',
848
+ '# REVIEW\n\n## 发现\n\n### Critical\n\n- 无\n\n### Major\n\n- 无\n\n### Minor\n\n- 无\n\n## 结论\n\nFix 批次由 execute 完成,待回源重新出口。\n');
849
+ const completedNodes = ['open', 'design', 'plan', 'execute', 'subagent-execute'];
850
+ const base = {
851
+ activeChange: CHANGE_ID,
852
+ currentNode: 'review',
853
+ completedNodes,
854
+ enteredNodes: [...completedNodes, 'review'],
855
+ evidence: { execute: { summary: 'fix batch executed' }, review: { summary: 'review in progress' } },
856
+ verifyFailures: 0,
857
+ executionMode: 'subagent',
858
+ directOverride: false,
859
+ newChange: true,
860
+ };
861
+ // ① 真实回程态(review 已 entry)→ 审计行 + NODE: review + state 只读不改写
862
+ writeState(dir, base);
863
+ const res = runStateWithProtocol(dir, ['next']);
864
+ assertExit(res, 0);
865
+ assertOut(res, 'RETURN: 回程源节点 review');
866
+ assertOut(res, 'NODE: review');
867
+ assertNotOut(res, 'NODE: verify');
868
+ assertNotOut(res, 'BLOCKED');
869
+ let after = readScenarioState(dir);
870
+ if (after.currentNode !== 'review' || after.completedNodes.join(',') !== completedNodes.join(',')) {
871
+ throw new Error('回程豁免不得改写 state,实际 '
872
+ + JSON.stringify({ currentNode: after.currentNode, completedNodes: after.completedNodes }));
873
+ }
874
+ // ② 引擎回程态(review 无 evidence/entered;末位已完成节点证据在场)→ 仍放行 review,不漂移 verify
875
+ writeState(dir, {
876
+ ...base,
877
+ enteredNodes: completedNodes.slice(),
878
+ evidence: { execute: { summary: 'fix batch executed' }, 'subagent-execute': { summary: 'delegated' } },
879
+ });
880
+ const resNoEvidence = runStateWithProtocol(dir, ['next']);
881
+ assertExit(resNoEvidence, 0);
882
+ assertOut(resNoEvidence, 'RETURN: 回程源节点 review');
883
+ assertOut(resNoEvidence, 'NODE: review');
884
+ assertNotOut(resNoEvidence, 'NODE: verify');
885
+ assertNotOut(resNoEvidence, 'BLOCKED');
886
+ after = readScenarioState(dir);
887
+ if (after.currentNode !== 'review') {
888
+ throw new Error('无 inProgress 证据的回程态 next 后 currentNode 应保持 review,实际 ' + JSON.stringify(after.currentNode));
889
+ }
890
+ // ③ 无任何 evidence 的引擎回程态 → 回程豁免先于「疑似未 exit」门禁,不 BLOCK
891
+ writeState(dir, { ...base, enteredNodes: [], evidence: {} });
892
+ const resNoAnyEvidence = runStateWithProtocol(dir, ['next']);
893
+ assertExit(resNoAnyEvidence, 0);
894
+ assertOut(resNoAnyEvidence, 'RETURN: 回程源节点 review');
895
+ assertOut(resNoAnyEvidence, 'NODE: review');
896
+ assertNotOut(resNoAnyEvidence, 'BLOCKED');
897
+ after = readScenarioState(dir);
898
+ if (after.currentNode !== 'review') {
899
+ throw new Error('回程豁免不得因证据缺失被门禁改写 currentNode,实际 ' + JSON.stringify(after.currentNode));
900
+ }
901
+ },
902
+ },
903
+
904
+ // 255: next Fix 回程豁免(verify 源)——TEST.md + UAT.md 已在场会让 resolveNextNode 按
905
+ // 产物跳过未出口的 verify 去 archive;next 必须显式放行 verify(审计行 + 只读不改写 state);
906
+ // 无 verify 证据时不得漂移 archive;完全无证据时不得被「疑似未 exit」门禁 BLOCK。
907
+ {
908
+ name: '255 next Fix 回程豁免:verify 源(TEST/UAT 在场不跳过;不漂移 archive/不 BLOCK)',
909
+ run: (dir) => {
910
+ writeIntakeArtifacts(dir);
911
+ writeFile(dir, '.specs/' + CHANGE_ID + '/TASK.md', fixBatchTaskText('done'));
912
+ writeFile(dir, '.specs/' + CHANGE_ID + '/T01-SUMMARY.md', strictSummary('T01'));
913
+ writeFile(dir, '.specs/' + CHANGE_ID + '/T-FIX-01-SUMMARY.md', strictSummary('T-FIX-01'));
914
+ writeFile(dir, '.specs/' + CHANGE_ID + '/REVIEW.md',
915
+ '# REVIEW\n\n## 发现\n\n### Critical\n\n- 无\n\n### Major\n\n- 无\n\n### Minor\n\n- 无\n\n## 结论\n\nreview passed,待回源 verify 重新出口。\n');
916
+ writeFile(dir, '.specs/' + CHANGE_ID + '/TEST.md', '# TEST\n\n## 验证命令\n\n```\necho ok\n```\n');
917
+ writeFile(dir, '.specs/' + CHANGE_ID + '/UAT.md', '# UAT\n\n## 验收\n\n- 通过\n');
918
+ const completedNodes = ['open', 'design', 'plan', 'execute', 'subagent-execute', 'review'];
919
+ const base = {
920
+ activeChange: CHANGE_ID,
921
+ currentNode: 'verify',
922
+ completedNodes,
923
+ enteredNodes: [...completedNodes, 'verify'],
924
+ evidence: {
925
+ execute: { summary: 'fix batch executed' },
926
+ review: { summary: 'review complete' },
927
+ verify: { summary: 'verify in progress' },
928
+ },
929
+ verifyFailures: 0,
930
+ executionMode: 'subagent',
931
+ directOverride: false,
932
+ newChange: true,
933
+ };
934
+ // ① 真实回程态(verify 已 entry)→ 审计行 + NODE: verify + state 只读不改写
935
+ writeState(dir, base);
936
+ const res = runStateWithProtocol(dir, ['next']);
937
+ assertExit(res, 0);
938
+ assertOut(res, 'RETURN: 回程源节点 verify');
939
+ assertOut(res, 'NODE: verify');
940
+ assertNotOut(res, 'NODE: archive');
941
+ assertNotOut(res, 'BLOCKED');
942
+ let after = readScenarioState(dir);
943
+ if (after.currentNode !== 'verify' || after.completedNodes.join(',') !== completedNodes.join(',')) {
944
+ throw new Error('回程豁免不得改写 state,实际 '
945
+ + JSON.stringify({ currentNode: after.currentNode, completedNodes: after.completedNodes }));
946
+ }
947
+ // ② 引擎回程态(verify 无 evidence/entered;末位已完成节点证据在场)→ 不漂移 archive
948
+ writeState(dir, {
949
+ ...base,
950
+ enteredNodes: completedNodes.slice(),
951
+ evidence: { execute: { summary: 'fix batch executed' }, review: { summary: 'review complete' } },
952
+ });
953
+ const resNoEvidence = runStateWithProtocol(dir, ['next']);
954
+ assertExit(resNoEvidence, 0);
955
+ assertOut(resNoEvidence, 'RETURN: 回程源节点 verify');
956
+ assertOut(resNoEvidence, 'NODE: verify');
957
+ assertNotOut(resNoEvidence, 'NODE: archive');
958
+ assertNotOut(resNoEvidence, 'BLOCKED');
959
+ after = readScenarioState(dir);
960
+ if (after.currentNode !== 'verify') {
961
+ throw new Error('无 inProgress 证据的回程态 next 后 currentNode 应保持 verify,实际 ' + JSON.stringify(after.currentNode));
962
+ }
963
+ // ③ 无任何 evidence → 回程豁免先于「疑似未 exit」门禁,不 BLOCK
964
+ writeState(dir, { ...base, enteredNodes: [], evidence: {} });
965
+ const resNoAnyEvidence = runStateWithProtocol(dir, ['next']);
966
+ assertExit(resNoAnyEvidence, 0);
967
+ assertOut(resNoAnyEvidence, 'RETURN: 回程源节点 verify');
968
+ assertOut(resNoAnyEvidence, 'NODE: verify');
969
+ assertNotOut(resNoAnyEvidence, 'BLOCKED');
970
+ },
971
+ },
972
+
973
+ // 256: 负例回归——正常多趟中间态(execute 已完成 + 依赖已满足的 parallel pending 任务)
974
+ // 必须照常路由 subagent-execute:回退谓词(源节点限制)与回程谓词(任务全 done 限制)都不成立,
975
+ // 不得被 Fix 两态分支误分流到 review/verify,也不得输出 FIX-BATCH 审计行。
976
+ {
977
+ name: '256 负例:正常多趟中间态(execute 已完成 + 可委托 parallel pending)不误分流',
978
+ run: (dir) => {
979
+ writeIntakeArtifacts(dir);
980
+ writeFile(dir, '.specs/' + CHANGE_ID + '/TASK.md', renderMultiWaveTasks(['T01', 'P01', 'P02', 'T02']));
981
+ for (const id of ['T01', 'P01', 'P02', 'T02']) {
982
+ writeFile(dir, '.specs/' + CHANGE_ID + '/' + id + '-SUMMARY.md', strictSummary(id));
983
+ }
984
+ const completedNodes = ['open', 'design', 'plan', 'execute', 'subagent-execute'];
985
+ writeState(dir, {
986
+ activeChange: CHANGE_ID,
987
+ currentNode: 'execute',
988
+ completedNodes,
989
+ enteredNodes: completedNodes.slice(),
990
+ evidence: {
991
+ execute: { summary: 'serial wave complete' },
992
+ 'subagent-execute': { summary: 'wave 1 delegated and collected' },
993
+ },
994
+ verifyFailures: 0,
995
+ executionMode: 'subagent',
996
+ directOverride: false,
997
+ newChange: true,
998
+ });
999
+ const res = runStateWithProtocol(dir, ['next']);
1000
+ assertExit(res, 0);
1001
+ assertOut(res, 'NODE: subagent-execute');
1002
+ assertNotOut(res, 'NODE: review');
1003
+ assertNotOut(res, 'NODE: verify');
1004
+ assertNotOut(res, 'FIX-BATCH');
1005
+ assertNotOut(res, 'BLOCKED');
1006
+ const after = readScenarioState(dir);
1007
+ if (after.currentNode !== 'subagent-execute') {
1008
+ throw new Error('正常多趟中间态应路由 subagent-execute,实际 currentNode=' + JSON.stringify(after.currentNode));
1009
+ }
1010
+ },
1011
+ },
1012
+
1013
+ // 257: 旧 change 兼容——无 newChange: true 的回退态与回程态都不新增 BLOCK,
1014
+ // 且 NODE 输出与判定正确(回退 → execute;回程 → 源节点)。
1015
+ {
1016
+ name: '257 旧 change 兼容:无 newChange 的回退/回程态不新增 BLOCK 且 NODE 正确',
1017
+ run: (dir) => {
1018
+ writeIntakeArtifacts(dir);
1019
+ const taskPath = '.specs/' + CHANGE_ID + '/TASK.md';
1020
+ const completedNodes = ['open', 'design', 'plan', 'execute', 'subagent-execute'];
1021
+ const oldState = {
1022
+ activeChange: CHANGE_ID,
1023
+ currentNode: 'review',
1024
+ completedNodes,
1025
+ enteredNodes: [...completedNodes, 'review'],
1026
+ evidence: { execute: { summary: 'first pass executed' }, review: { summary: 'review in progress' } },
1027
+ verifyFailures: 0,
1028
+ executionMode: 'subagent',
1029
+ directOverride: false,
1030
+ // newChange 缺省/null = 旧 change 渐进形态(newChange 校验只接受 true/缺失/null)
1031
+ };
1032
+ // ① 旧 change 回退态(pending Fix 任务)→ NODE: execute + 审计行,不得 BLOCK
1033
+ writeFile(dir, taskPath, fixBatchTaskText('pending'));
1034
+ writeState(dir, oldState);
1035
+ const resRollback = runStateWithProtocol(dir, ['next']);
1036
+ assertExit(resRollback, 0);
1037
+ assertNotOut(resRollback, 'BLOCKED');
1038
+ assertOut(resRollback, 'FIX-BATCH: 归位 execute(源节点 review)');
1039
+ assertOut(resRollback, 'NODE: execute');
1040
+ // 旧 change 缺 fixRoundsByChange 字段 → 缺省 0,从第 1 轮计数且不 BLOCK(AC-5 旧兼容)
1041
+ assertOut(resRollback, '(第 1/3 轮)');
1042
+ const stLegacyRollback = readScenarioState(dir);
1043
+ if (stLegacyRollback.currentNode !== 'execute' || stLegacyRollback.fixRoundsByChange?.[CHANGE_ID] !== 1) {
1044
+ throw new Error('旧 change 回退态 next 后应归位 execute 且计数器缺省 0→1,实际 '
1045
+ + JSON.stringify({ currentNode: stLegacyRollback.currentNode, rounds: stLegacyRollback.fixRoundsByChange }));
1046
+ }
1047
+ // ② 旧 change 回程态(无 newChange 字段:全 done + REVIEW.md + 源节点未完成)→ NODE: review,不得 BLOCK
1048
+ writeFile(dir, taskPath, fixBatchTaskText('done'));
1049
+ writeFile(dir, '.specs/' + CHANGE_ID + '/T01-SUMMARY.md', strictSummary('T01'));
1050
+ writeFile(dir, '.specs/' + CHANGE_ID + '/T-FIX-01-SUMMARY.md', strictSummary('T-FIX-01'));
1051
+ writeFile(dir, '.specs/' + CHANGE_ID + '/REVIEW.md',
1052
+ '# REVIEW\n\n## 发现\n\n### Critical\n\n- 无\n\n### Major\n\n- 无\n\n### Minor\n\n- 无\n\n## 结论\n\n待回源出口。\n');
1053
+ writeState(dir, oldState);
1054
+ const resReturn = runStateWithProtocol(dir, ['next']);
1055
+ assertExit(resReturn, 0);
1056
+ assertNotOut(resReturn, 'BLOCKED');
1057
+ assertOut(resReturn, 'RETURN: 回程源节点 review');
1058
+ assertOut(resReturn, 'NODE: review');
1059
+ assertNotOut(resReturn, 'NODE: verify');
1060
+ if (readScenarioState(dir).currentNode !== 'review') {
1061
+ throw new Error('旧 change 回程态 next 后 currentNode 应保持 review,实际 ' + JSON.stringify(readScenarioState(dir).currentNode));
1062
+ }
1063
+ // ③ 旧 change 无签名、无 Fix 标记的回程态(决策 2/3 旧态边界):state 侧同样只输出中性
1064
+ // RETURN 回程行——缺 taskSetSignature、TASK 无 Fix 段/编号 → 不得冒充 FIX-BATCH。
1065
+ writeFile(dir, taskPath, '# TASK\n\n' + fixTaskBlock('T01', 'done') + '\n');
1066
+ writeState(dir, oldState);
1067
+ const resReturnNoMarker = runStateWithProtocol(dir, ['next']);
1068
+ assertExit(resReturnNoMarker, 0);
1069
+ assertNotOut(resReturnNoMarker, 'BLOCKED');
1070
+ assertNotOut(resReturnNoMarker, 'FIX-BATCH');
1071
+ assertOut(resReturnNoMarker, 'RETURN: 回程源节点 review(源节点产物在场且未出口;保留源节点跑出口)');
1072
+ assertOut(resReturnNoMarker, 'NODE: review');
1073
+ if (readScenarioState(dir).currentNode !== 'review') {
1074
+ throw new Error('旧 change 无标记回程态 next 后 currentNode 应保持 review,实际 ' + JSON.stringify(readScenarioState(dir).currentNode));
1075
+ }
1076
+ },
1077
+ },
1078
+
1079
+ // 258: 三节点 SKILL 文本锁(AC-9 / T05 已落地)——execute/review/verify 均含
1080
+ // 「## 修复回路状态机路径」段,段内含受控归位 + 回源节点跑出口 + 禁止绕过;不得把
1081
+ // 直接 exit 源节点收场或 advance 当正常路径(反捷径文本锚)。
1082
+ // 布局感知(端到端冒烟副本缺陷):技能树从 suite 脚本自身位置推导
1083
+ // (<skillsRoot>/flow-comet/scripts/ → 组件技能为 <skillsRoot> 下同级目录),权威源
1084
+ // .flow-comet/skills/ 与安装副本 .claude|.agents|.dsh/skills/ 同一相对布局通吃。
1085
+ {
1086
+ name: '258 技能文本锁:三节点 SKILL 含修复回路状态机路径(禁止直接 exit/advance 为正常路径)',
1087
+ run: (dir) => {
1088
+ const componentSkills = ['flow-comet-execute', 'flow-comet-review', 'flow-comet-verify'];
1089
+ // 布局感知回归锚(合成安装副本):suite 位于 <skillsRoot>/flow-comet/scripts/ 时组件技能
1090
+ // 必须解析到同级 <skillsRoot>/<skill>/SKILL.md——与权威源 .flow-comet 布局无关
1091
+ //(旧实现硬编码 REPO_ROOT/.flow-comet/skills → 此锚变红)。
1092
+ const syntheticSkillsRoot = path.join(dir, 'synthetic-carrier', '.claude', 'skills');
1093
+ const syntheticScriptsDir = path.join(syntheticSkillsRoot, 'flow-comet', 'scripts');
1094
+ for (const nodeSkill of componentSkills) {
1095
+ writeFile(dir, path.join('synthetic-carrier', '.claude', 'skills', nodeSkill, 'SKILL.md'),
1096
+ '## 修复回路状态机路径\n\n受控归位(合成布局锚)\n');
1097
+ const expected = path.join(syntheticSkillsRoot, nodeSkill, 'SKILL.md');
1098
+ const resolved = resolveComponentSkillFile(nodeSkill, syntheticScriptsDir);
1099
+ if (resolved !== expected) {
1100
+ throw new Error('技能树布局感知解析错误:期望 ' + expected + ',实际 ' + resolved);
1101
+ }
1102
+ }
1103
+ // 显式失败锚(MECHANISM 三·6):组件技能缺失时必须报错并给指引,不得静默跳过/空过。
1104
+ const emptyScriptsDir = path.join(dir, 'empty-carrier', '.dsh', 'skills', 'flow-comet', 'scripts');
1105
+ let missingError = null;
1106
+ try {
1107
+ resolveComponentSkillFile('flow-comet-execute', emptyScriptsDir);
1108
+ } catch (e) {
1109
+ missingError = e.message;
1110
+ }
1111
+ if (!missingError
1112
+ || !missingError.includes('技能树布局定位失败')
1113
+ || !missingError.includes(path.join('flow-comet-execute', 'SKILL.md'))) {
1114
+ throw new Error('组件技能缺失时未显式失败并给指引: ' + JSON.stringify(missingError));
1115
+ }
1116
+ // 真实三节点文本锁(ADR-016 重定向):原「三册段正文 sha256 完全一致」的逐字锁**作废**,
1117
+ // 改为「三册各含要点句与条件句 + 该段正文**仅一处**(权威 = `reference/fix-loop.md`)+
1118
+ // 原 6 关键词与「禁 `advance` 作正常路径」断言**迁到权威处**」。判据抽成纯函数(单一实现:
1119
+ // 真实判据与反向构造探针共用),逐条自带反向构造。
1120
+ const componentTexts = new Map();
1121
+ for (const nodeSkill of componentSkills) {
1122
+ componentTexts.set(nodeSkill, fs.readFileSync(resolveComponentSkillFile(nodeSkill), 'utf8'));
1123
+ }
1124
+ const fixLoopAuthorityPath = path.join(SCRIPTS_DIR, '..', 'reference', 'fix-loop.md');
1125
+ if (!fs.existsSync(fixLoopAuthorityPath)) {
1126
+ throw new Error(FIX_LOOP_AUTHORITY_REL + ' 不在场(修复回路段的唯一权威处缺失)');
1127
+ }
1128
+ const fixLoopAuthorityText = fs.readFileSync(fixLoopAuthorityPath, 'utf8');
1129
+ const fixLoopSources = { books: componentTexts, authority: fixLoopAuthorityText };
1130
+ const fixLoopProblems = fixLoopStateMachineProblems(fixLoopSources);
1131
+ if (fixLoopProblems.length > 0) {
1132
+ throw new Error('修复回路状态机路径文本锁不符(重定向后判据): ' + fixLoopProblems.join('; '));
1133
+ }
1134
+ // 反向构造(同一判据驱动,逐条对应重定向后的两侧):
1135
+ // ① 逐册抽掉任一要点 token ⇒ 必报(三册各自的要点句在场);
1136
+ // ② 权威处逐条抽掉关键词 ⇒ 必报(原 6 关键词已迁到权威处);
1137
+ // ③ 把权威段落复制进任一册 ⇒ 必报「第二份正文」(正文唯一——原 sha256 锁**要求**三份一致,
1138
+ // 恰恰抓不到这一侧);④ 册内还原 `advance` 捷径 / 直接 exit 收场 ⇒ 必报。
1139
+ const stripFixLoopToken = (text, token) => text.split(token).join('(反向构造:抽掉)');
1140
+ for (const [nodeSkill, text] of componentTexts) {
1141
+ for (const [label, tokens] of FIX_LOOP_BOOK_ELEMENT_GROUPS) {
1142
+ const probed = new Map(componentTexts).set(nodeSkill, stripFixLoopToken(text, tokens[0]));
1143
+ if (probed.get(nodeSkill) === text) continue;
1144
+ if (!fixLoopStateMachineProblems({ ...fixLoopSources, books: probed }).some((p) => p.includes(label))) {
1145
+ throw new Error('反向构造判别力缺失(' + nodeSkill + ' 抽掉「' + label + '」要点 token 未被判违规)');
1146
+ }
1147
+ }
1148
+ }
1149
+ for (const keyword of FIX_LOOP_AUTHORITY_KEYWORDS) {
1150
+ if (!fixLoopAuthorityText.includes(keyword)) continue; // 缺失已由真实判据报告
1151
+ if (!fixLoopStateMachineProblems({
1152
+ ...fixLoopSources, authority: stripFixLoopToken(fixLoopAuthorityText, keyword),
1153
+ }).some((p) => p.includes(keyword))) {
1154
+ throw new Error('反向构造判别力缺失(权威处抽掉关键词 «' + keyword + '» 未被判违规)');
1155
+ }
1156
+ }
1157
+ const fixLoopAuthoritySection = fixLoopStateMachineSectionOf(fixLoopAuthorityText);
1158
+ const copyInto = 'flow-comet-review';
1159
+ const reviewText = componentTexts.get(copyInto).replace(/\r\n/g, '\n');
1160
+ const reviewSection = fixLoopStateMachineSectionOf(reviewText);
1161
+ const duplicated = fixLoopStateMachineProblems({
1162
+ ...fixLoopSources,
1163
+ books: new Map(componentTexts).set(copyInto, reviewText.split(reviewSection).join(fixLoopAuthoritySection)),
1164
+ });
1165
+ if (!duplicated.some((p) => p.includes('第二份正文'))) {
1166
+ throw new Error('反向构造判别力缺失(权威段落整段回流册子未被判「第二份正文」)');
1167
+ }
1168
+ const advanceRel = 'flow-comet-verify';
1169
+ const advanceText = componentTexts.get(advanceRel).replace(/\r\n/g, '\n');
1170
+ const advanceSection = fixLoopStateMachineSectionOf(advanceText);
1171
+ const advanceProbe = new Map(componentTexts).set(advanceRel,
1172
+ advanceText.split(advanceSection).join(advanceSection + '\n用 advance 直接推进即可。\n'));
1173
+ if (!fixLoopStateMachineProblems({ ...fixLoopSources, books: advanceProbe })
1174
+ .some((p) => p.includes('advance'))) {
1175
+ throw new Error('反向构造判别力缺失(册内还原 advance 捷径未被判违规)');
1176
+ }
1177
+ const exitRel = 'flow-comet-review';
1178
+ const exitText = componentTexts.get(exitRel).replace(/\r\n/g, '\n');
1179
+ const exitSection = fixLoopStateMachineSectionOf(exitText);
1180
+ const directExitProbe = new Map(componentTexts).set(exitRel,
1181
+ exitText.split(exitSection).join(exitSection + '\n直接跑 exit review 收场即可。\n'));
1182
+ if (!fixLoopStateMachineProblems({ ...fixLoopSources, books: directExitProbe })
1183
+ .some((p) => p.includes('直接 exit'))) {
1184
+ throw new Error('反向构造判别力缺失(册内还原「直接 exit 收场」未被判违规)');
1185
+ }
1186
+ },
1187
+ },
1188
+ // 259: 受控重入正例(AC-1 / AC-10)——archive 已 entry + 归档目录仍在原位 + 完整授权
1189
+ // 三元组 → 一次调用完成:备份落盘(全量快照 + 可核验 sha256 指纹)→ 转移落地
1190
+ // (currentNode=target / completedNodes=前驱交集 / status=running)→ 审计事件(含 change
1191
+ // 归属与授权留痕)→ 可审计的 REENTRY 行。
1192
+ {
1193
+ name: '259 受控重入正例:archive → verify 备份·转移·审计事件·授权留痕全链路',
1194
+ run: (dir) => {
1195
+ writeReentryChangeDir(dir);
1196
+ writeState(dir, reentryArchiveState());
1197
+ const beforeState = readScenarioState(dir);
1198
+ const res = runReenter(dir, 'verify', { source: 'user-approval', reason: '归档后发现缺陷,需回到验证节点' });
1199
+ assertExit(res, 0);
1200
+ assertOut(res, 'REENTRY');
1201
+ assertOut(res, 'archive');
1202
+ assertOut(res, 'verify');
1203
+ assertOut(res, '1/3');
1204
+ assertOut(res, 'user-approval');
1205
+ assertOut(res, 'REASON: 归档后发现缺陷,需回到验证节点');
1206
+ const st = readScenarioState(dir);
1207
+ if (st.currentNode !== 'verify') {
1208
+ throw new Error('转移应把 currentNode 置为 target(verify),实际 ' + JSON.stringify(st.currentNode));
1209
+ }
1210
+ if (!isDeepStrictEqual(st.completedNodes, REENTRY_EXPECTED_INTERSECTION.verify)) {
1211
+ throw new Error('completedNodes 应为前驱交集 ' + JSON.stringify(REENTRY_EXPECTED_INTERSECTION.verify)
1212
+ + ',实际 ' + JSON.stringify(st.completedNodes));
1213
+ }
1214
+ if (st.status !== 'running') {
1215
+ throw new Error('重入应把 status 置为 running,实际 ' + JSON.stringify(st.status));
1216
+ }
1217
+ // 除四类机器字段与 evidence(授权留痕)外,state 其余字段逐项不变、不得新增/删除
1218
+ const mutable = new Set(['currentNode', 'completedNodes', 'status', 'history', 'evidence']);
1219
+ for (const key of Object.keys(st)) {
1220
+ if (mutable.has(key)) continue;
1221
+ if (!isDeepStrictEqual(beforeState[key], st[key])) {
1222
+ throw new Error('受控重入不得改写 ' + key + ':before=' + JSON.stringify(beforeState[key])
1223
+ + ' after=' + JSON.stringify(st[key]));
1224
+ }
1225
+ }
1226
+ for (const key of Object.keys(beforeState)) {
1227
+ if (!(key in st)) throw new Error('受控重入不得删除 state 字段: ' + key);
1228
+ }
1229
+ // history:旧前缀逐字稳定 + 恰新增一条 reentry-applied
1230
+ const history = Array.isArray(st.history) ? st.history : [];
1231
+ if (history.length !== beforeState.history.length + 1) {
1232
+ throw new Error('history 应恰新增 1 条,实际新增 ' + (history.length - beforeState.history.length)
1233
+ + ':' + JSON.stringify(history.slice(beforeState.history.length)));
1234
+ }
1235
+ if (!isDeepStrictEqual(history.slice(0, beforeState.history.length), beforeState.history)) {
1236
+ throw new Error('history 旧前缀被改写(既有事件必须逐字稳定)');
1237
+ }
1238
+ const event = history[history.length - 1];
1239
+ if (!event || event.event !== 'reentry-applied') {
1240
+ throw new Error('新增 history 事件应为 reentry-applied:' + JSON.stringify(event));
1241
+ }
1242
+ if (event.from !== 'archive' || event.to !== 'verify') {
1243
+ throw new Error('审计事件应记录 from=archive / to=verify,实际 '
1244
+ + JSON.stringify({ from: event.from, to: event.to }));
1245
+ }
1246
+ if (event.round !== 1) {
1247
+ throw new Error('首次重入轮次应为 1,实际 ' + JSON.stringify(event.round));
1248
+ }
1249
+ if (event.change !== CHANGE_ID) {
1250
+ throw new Error('reentry-applied 事件必须带 change 字段(跨 change 轮次隔离的唯一依据),实际 '
1251
+ + JSON.stringify(event.change));
1252
+ }
1253
+ if (typeof event.at !== 'string' || Number.isNaN(Date.parse(event.at))) {
1254
+ throw new Error('审计事件应带可解析的 at 时间戳,实际 ' + JSON.stringify(event.at));
1255
+ }
1256
+ const authorization = event.authorization;
1257
+ if (!authorization || authorization.round !== 1 || authorization.source !== 'user-approval'
1258
+ || authorization.target !== 'verify'
1259
+ || typeof authorization.at !== 'string' || authorization.at.trim() === '') {
1260
+ throw new Error('审计事件 authorization 记录不完整(round / at / source / target 与本次调用绑定):'
1261
+ + JSON.stringify(authorization));
1262
+ }
1263
+ if (typeof event.backup !== 'string' || event.backup.trim() === '') {
1264
+ throw new Error('审计事件应记录备份路径,实际 ' + JSON.stringify(event.backup));
1265
+ }
1266
+ if (typeof event.fingerprint !== 'string' || !/^[0-9a-f]{64}$/.test(event.fingerprint)) {
1267
+ throw new Error('审计事件应记录 sha256 指纹(64 位小写十六进制),实际 ' + JSON.stringify(event.fingerprint));
1268
+ }
1269
+ // 授权嵌套留痕(evidence.<target>.reentryAuthorization)
1270
+ const record = st.evidence?.verify?.reentryAuthorization;
1271
+ if (!record) {
1272
+ throw new Error('evidence.verify.reentryAuthorization 授权留痕缺失:' + JSON.stringify(st.evidence));
1273
+ }
1274
+ if (record.round !== 1 || record.source !== 'user-approval' || record.target !== 'verify'
1275
+ || typeof record.at !== 'string' || record.at.trim() === '') {
1276
+ throw new Error('授权留痕字段不完整:' + JSON.stringify(record));
1277
+ }
1278
+ if (record.backup !== event.backup || record.fingerprint !== event.fingerprint) {
1279
+ throw new Error('授权留痕的 backup / fingerprint 应与审计事件一致:' + JSON.stringify({ record, event }));
1280
+ }
1281
+ // --reason 必须落盘(事件 + 嵌套授权记录):只打印不落盘的必填参数无法支撑事后审计追溯
1282
+ if (event.reason !== '归档后发现缺陷,需回到验证节点') {
1283
+ throw new Error('审计事件应记录本次 --reason(可追溯),实际 ' + JSON.stringify(event.reason));
1284
+ }
1285
+ if (record.reason !== event.reason) {
1286
+ throw new Error('授权留痕的 reason 应与审计事件逐字一致:' + JSON.stringify({ record: record.reason, event: event.reason }));
1287
+ }
1288
+ // 备份:路径形态 + 全量快照语义 + 指纹可核验
1289
+ const backupPath = path.isAbsolute(event.backup) ? event.backup : path.join(dir, event.backup);
1290
+ if (!fs.existsSync(backupPath)) {
1291
+ throw new Error('备份文件不在场:' + backupPath);
1292
+ }
1293
+ const backupRel = path.relative(dir, backupPath).split(path.sep).join('/');
1294
+ if (!backupRel.startsWith('.specs/' + CHANGE_ID + '/.reentry-backups/')
1295
+ || !/-pre-verify\.json$/.test(path.basename(backupPath))) {
1296
+ throw new Error('备份路径应符合 .specs/<id>/.reentry-backups/<ISO>-pre-<target>.json,实际 ' + backupRel);
1297
+ }
1298
+ const backupBytes = fs.readFileSync(backupPath);
1299
+ const fingerprint = createHash('sha256').update(backupBytes).digest('hex');
1300
+ if (fingerprint !== event.fingerprint) {
1301
+ throw new Error('备份指纹与文件内容不一致(AC-9 可核验):事件=' + event.fingerprint + ' 实算=' + fingerprint);
1302
+ }
1303
+ if (!isDeepStrictEqual(JSON.parse(backupBytes.toString('utf8')), beforeState)) {
1304
+ throw new Error('备份应为重入前 state 的全量快照');
1305
+ }
1306
+ },
1307
+ },
1308
+
1309
+ // 260: 授权门禁 fail-closed(AC-2)——缺授权 / source 空串 / source 纯空白 → BLOCK、
1310
+ // state 字节零改写、零备份、零事件;授权形态(round 正整数、at / source 非空字符串、
1311
+ // target 与授权一致)由 route-node 纯函数单一权威判定(形态锚 + 合法形态放行对照)。
1312
+ {
1313
+ name: '260 授权 fail-closed:缺授权·空/纯空白 source BLOCK 零改写 + 形态纯函数锚',
1314
+ run: (dir) => {
1315
+ writeReentryChangeDir(dir);
1316
+ writeState(dir, reentryArchiveState());
1317
+ const bytes = readStateBytes(dir);
1318
+ const blockedCases = [
1319
+ ['缺授权(无 --authorized-by / --reason)', () => runReenter(dir, 'verify')],
1320
+ ['source 空串', () => runReenter(dir, 'verify', { source: '', reason: 'x' })],
1321
+ ['source 纯空白', () => runReenter(dir, 'verify', { source: ' ', reason: 'x' })],
1322
+ ];
1323
+ for (const [label, call] of blockedCases) {
1324
+ const res = call();
1325
+ assertExit(res, 1);
1326
+ assertOut(res, 'BLOCKED');
1327
+ assertStateBytesUnchanged(dir, bytes, label);
1328
+ }
1329
+ if (reentryBackupFiles(dir).length !== 0) {
1330
+ throw new Error('授权非法路径不得产生备份:' + JSON.stringify(reentryBackupFiles(dir)));
1331
+ }
1332
+ const st = readScenarioState(dir);
1333
+ const reentryEvents = (st.history || []).filter((e) => e.event === 'reentry-applied');
1334
+ if (reentryEvents.length !== 0) {
1335
+ throw new Error('授权非法路径不得写审计事件:' + JSON.stringify(reentryEvents));
1336
+ }
1337
+ // 授权形态纯函数锚:malformed 一律 ok:false,合法 ok:true(放行侧对照)
1338
+ const valid = { round: 1, at: '2026-09-20T00:00:00.000Z', source: 'user-approval', target: 'verify' };
1339
+ assertReentryAuthorizationShape(valid, 'verify', true, '合法三元组');
1340
+ const malformed = [
1341
+ ['缺 authorization', undefined],
1342
+ ['round=0', { ...valid, round: 0 }],
1343
+ ['round=-1', { ...valid, round: -1 }],
1344
+ ['round=1.5 非整数', { ...valid, round: 1.5 }],
1345
+ ['round="1" 类型错误', { ...valid, round: '1' }],
1346
+ ['round 缺失', { ...valid, round: undefined }],
1347
+ ['at=42 类型错误', { ...valid, at: 42 }],
1348
+ ['at 空串', { ...valid, at: '' }],
1349
+ ['at 纯空白', { ...valid, at: ' ' }],
1350
+ ['at 缺失', { ...valid, at: undefined }],
1351
+ ['source=[] 类型错误', { ...valid, source: [] }],
1352
+ ['source 空串', { ...valid, source: '' }],
1353
+ ['source 纯空白', { ...valid, source: ' ' }],
1354
+ ['source 缺失', { ...valid, source: undefined }],
1355
+ ['target 与授权不一致', { ...valid, target: 'execute' }],
1356
+ ];
1357
+ for (const [label, authorization] of malformed) {
1358
+ assertReentryAuthorizationShape(authorization, 'verify', false, label);
1359
+ }
1360
+ // 综合判定:archive 源 + 合法 target + 形态非法授权 → block(不抛异常),合法 → apply
1361
+ const decide = requireRouteNodeExport('resolveReentryDecision');
1362
+ const protocol = readScenarioProtocol(dir);
1363
+ const decideState = {
1364
+ activeChange: CHANGE_ID,
1365
+ currentNode: 'archive',
1366
+ completedNodes: [...REENTRY_FULL_COMPLETED],
1367
+ history: [],
1368
+ };
1369
+ for (const [label, authorization] of malformed) {
1370
+ const decision = decide({ protocol, state: decideState, target: 'verify', authorization });
1371
+ if (!decision || decision.ok !== false || decision.action !== 'block') {
1372
+ throw new Error('[' + label + '] resolveReentryDecision 应返回 block,实际 ' + JSON.stringify(decision));
1373
+ }
1374
+ }
1375
+ const applied = decide({ protocol, state: decideState, target: 'verify', authorization: valid });
1376
+ if (!applied || applied.ok !== true || applied.action !== 'apply' || applied.round !== 1) {
1377
+ throw new Error('合法授权 + archive 源应返回 apply / 第 1 轮,实际 ' + JSON.stringify(applied));
1378
+ }
1379
+ },
1380
+ },
1381
+
1382
+ // 261a: 越界拦截(AC-5 / AC-6 / AC-7)——目标不在白名单 / 协议 disabled 节点 / 源不是 archive /
1383
+
1384
+ ];