flow-comet 1.6.3 → 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 (78) hide show
  1. package/.flow-comet/skills/flow-comet/INSTALLED_VERSION +1 -1
  2. package/.flow-comet/skills/flow-comet/scripts/comet-hook-guard.mjs +11 -13
  3. package/.flow-comet/skills/flow-comet/scripts/context-init.mjs +2 -2
  4. package/.flow-comet/skills/flow-comet/scripts/evolve.mjs +6 -6
  5. package/.flow-comet/skills/flow-comet/scripts/guard-self-test.mjs +67 -18878
  6. package/.flow-comet/skills/flow-comet/scripts/health.mjs +1 -1
  7. package/.flow-comet/skills/flow-comet/scripts/items/a.mjs +1030 -0
  8. package/.flow-comet/skills/flow-comet/scripts/items/b.mjs +830 -0
  9. package/.flow-comet/skills/flow-comet/scripts/items/c.mjs +781 -0
  10. package/.flow-comet/skills/flow-comet/scripts/items/d.mjs +99 -0
  11. package/.flow-comet/skills/flow-comet/scripts/items/e.mjs +185 -0
  12. package/.flow-comet/skills/flow-comet/scripts/items/f.mjs +90 -0
  13. package/.flow-comet/skills/flow-comet/scripts/items/g.mjs +59 -0
  14. package/.flow-comet/skills/flow-comet/scripts/items/h.mjs +815 -0
  15. package/.flow-comet/skills/flow-comet/scripts/items/i.mjs +77 -0
  16. package/.flow-comet/skills/flow-comet/scripts/items/j.mjs +75 -0
  17. package/.flow-comet/skills/flow-comet/scripts/items/k.mjs +1427 -0
  18. package/.flow-comet/skills/flow-comet/scripts/items/l.mjs +275 -0
  19. package/.flow-comet/skills/flow-comet/scripts/items/m.mjs +614 -0
  20. package/.flow-comet/skills/flow-comet/scripts/lib/count-derivation.mjs +97 -0
  21. package/.flow-comet/skills/flow-comet/scripts/lib/fix-loop-node.mjs +196 -0
  22. package/.flow-comet/skills/flow-comet/scripts/lib/guard-evidence-gates.mjs +553 -0
  23. package/.flow-comet/skills/flow-comet/scripts/lib/guard-gates.mjs +837 -0
  24. package/.flow-comet/skills/flow-comet/scripts/lib/guard-routing.mjs +404 -0
  25. package/.flow-comet/skills/flow-comet/scripts/lib/guard-state-io.mjs +404 -0
  26. package/.flow-comet/skills/flow-comet/scripts/lib/guard-template-fidelity.mjs +302 -0
  27. package/.flow-comet/skills/flow-comet/scripts/lib/guard-uidesign.mjs +133 -0
  28. package/.flow-comet/skills/flow-comet/scripts/lib/reentry-node.mjs +237 -0
  29. package/.flow-comet/skills/flow-comet/scripts/lib/replan-node.mjs +209 -0
  30. package/.flow-comet/skills/flow-comet/scripts/lib/state-branch.mjs +49 -0
  31. package/.flow-comet/skills/flow-comet/scripts/lib/state-bridgecheck.mjs +201 -0
  32. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-admin.mjs +141 -0
  33. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-flow.mjs +700 -0
  34. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-recovery.mjs +578 -0
  35. package/.flow-comet/skills/flow-comet/scripts/lib/state-determine.mjs +52 -0
  36. package/.flow-comet/skills/flow-comet/scripts/lib/state-evolve-hint.mjs +55 -0
  37. package/.flow-comet/skills/flow-comet/scripts/lib/state-explain.mjs +106 -0
  38. package/.flow-comet/skills/flow-comet/scripts/lib/state-intelscan.mjs +58 -0
  39. package/.flow-comet/skills/flow-comet/scripts/lib/state-io.mjs +147 -0
  40. package/.flow-comet/skills/flow-comet/scripts/lib/state-skillmarkers.mjs +189 -0
  41. package/.flow-comet/skills/flow-comet/scripts/lib/system-fixtures.mjs +1441 -0
  42. package/.flow-comet/skills/flow-comet/scripts/lib/task-graph.mjs +471 -0
  43. package/.flow-comet/skills/flow-comet/scripts/lib/test-assertions.mjs +509 -0
  44. package/.flow-comet/skills/flow-comet/scripts/lib/test-fixtures.mjs +1228 -0
  45. package/.flow-comet/skills/flow-comet/scripts/lib/test-helpers.mjs +237 -0
  46. package/.flow-comet/skills/flow-comet/scripts/lib/text-anchor-checks.mjs +2484 -0
  47. package/.flow-comet/skills/flow-comet/scripts/protocol-utils.mjs +2 -2
  48. package/.flow-comet/skills/flow-comet/scripts/route-node.mjs +72 -1123
  49. package/.flow-comet/skills/flow-comet/scripts/scenarios/a.mjs +966 -0
  50. package/.flow-comet/skills/flow-comet/scripts/scenarios/b.mjs +1233 -0
  51. package/.flow-comet/skills/flow-comet/scripts/scenarios/c.mjs +1382 -0
  52. package/.flow-comet/skills/flow-comet/scripts/scenarios/d.mjs +483 -0
  53. package/.flow-comet/skills/flow-comet/scripts/scenarios/e.mjs +1388 -0
  54. package/.flow-comet/skills/flow-comet/scripts/scenarios/f.mjs +1466 -0
  55. package/.flow-comet/skills/flow-comet/scripts/scenarios/g.mjs +1364 -0
  56. package/.flow-comet/skills/flow-comet/scripts/scenarios/h.mjs +1287 -0
  57. package/.flow-comet/skills/flow-comet/scripts/scenarios/i.mjs +1436 -0
  58. package/.flow-comet/skills/flow-comet/scripts/scenarios/j.mjs +1384 -0
  59. package/.flow-comet/skills/flow-comet/scripts/scenarios/k.mjs +1338 -0
  60. package/.flow-comet/skills/flow-comet/scripts/scenarios/l.mjs +1484 -0
  61. package/.flow-comet/skills/flow-comet/scripts/scenarios/m.mjs +971 -0
  62. package/.flow-comet/skills/flow-comet/scripts/state-schema.mjs +1 -1
  63. package/.flow-comet/skills/flow-comet/scripts/system-test.mjs +58 -7559
  64. package/.flow-comet/skills/flow-comet/scripts/time-utils.mjs +4 -4
  65. package/.flow-comet/skills/flow-comet/scripts/workflow-guard.mjs +151 -2476
  66. package/.flow-comet/skills/flow-comet/scripts/workflow-handoff.mjs +5 -5
  67. package/.flow-comet/skills/flow-comet/scripts/workflow-state.mjs +27 -2190
  68. package/.flow-comet/skills/flow-comet-plan/GUIDANCE.md +1 -1
  69. package/README.md +52 -69
  70. package/package.json +3 -2
  71. package/scripts/dsh-bridge.mjs +2 -2
  72. package/scripts/lib/installer-cleanup.mjs +152 -0
  73. package/scripts/lib/installer-flowkit.mjs +119 -0
  74. package/scripts/lib/installer-hooks.mjs +363 -0
  75. package/scripts/lib/installer-loader.mjs +220 -0
  76. package/scripts/lib/installer-migrate.mjs +236 -0
  77. package/scripts/lib/installer-platforms.mjs +314 -0
  78. package/scripts/prepare-env.mjs +21 -1313
@@ -0,0 +1,275 @@
1
+ // items/l.mjs — 条目分区:K 组尾部(状态迁移 / 分发面 / 契约核对三项)+ L 组条目(执行遗漏防护)
2
+ //
3
+ // 数据层约定:同 items/a.mjs 头注(只承载 ENTRIES;夹具从 lib/system-fixtures.mjs 取;组文件之间零 import)。
4
+ // 组界:本文件先承载 K 组尾部三项、再承载 L 组条目——见 items/k.mjs 头注。
5
+ // 带 `surface` 声明的条目在导出前统一接入分发面契约(见 applyDistributionSurface)。
6
+
7
+ import fs from 'fs';
8
+ import path from 'path';
9
+ import { execFileSync, spawnSync } from 'child_process';
10
+ import { assertExit, assertNotOut, assertOut, baseState, runGuard, runState, writeFile, writeState } from '../lib/test-helpers.mjs';
11
+ import { SCRIPTS_DIR, CONTRACT, resolvePackageContext, assertPackageContextJudgment, seedForeignFlowKit, assertPublishableManifest, assertPackageBoundary, assertWorkflowContractCheck, assertBinContract, assertInitTokenContract, assertInstallerUpgradePathCleanup, assertMirrorRootLinkFailClosed, CHANGE_ID, readStateFile, gitInit, writeIntakeArtifacts, DISTRIBUTION_MARKERS, applyDistributionSurface } from '../lib/system-fixtures.mjs';
12
+
13
+ const RAW_ENTRIES = [
14
+
15
+ // K17: 旧布局项目(状态文件在旧命名空间 + 同目录 Comet 资产/用户文件)经安装器自动迁移后,
16
+ // 真实安装副本上的流程可继续——状态逐字节搬移且可读、合规节点链路 entry → record → exit
17
+ // 正常推进、Comet 资产与用户文件原位未动。端到端执行断言(真实命令序列,非形态断言)。
18
+ {
19
+ name: 'K17 状态迁移:旧布局项目安装后状态可读且流程可继续',
20
+ surface: '旧布局状态迁移与节点推进断言仅权威源侧可判',
21
+ run: (dir) => {
22
+ const repoRoot = path.resolve(SCRIPTS_DIR, '..', '..', '..', '..');
23
+ const installer = path.join(repoRoot, 'scripts', 'prepare-env.mjs');
24
+ const target = path.join(dir, 'k17-target');
25
+ const legacyDir = path.join(target, '.comet');
26
+ fs.mkdirSync(legacyDir, { recursive: true });
27
+ // 迁移前状态(进行中的 change:design 节点待完成)
28
+ const stateBytes = Buffer.from(JSON.stringify({
29
+ activeChange: 'mig-ch',
30
+ currentNode: 'design',
31
+ completedNodes: ['open'],
32
+ evidence: { open: { summary: 'intake complete' } },
33
+ verifyFailures: 0,
34
+ executionMode: 'subagent',
35
+ directOverride: false,
36
+ }, null, 2) + '\n', 'utf8');
37
+ fs.writeFileSync(path.join(legacyDir, 'flow-comet-state.json'), stateBytes);
38
+ // 同目录的非 flow-comet 内容(旧目录三方共占实测形态):迁移不得处置它们
39
+ fs.writeFileSync(path.join(legacyDir, 'config.yaml'), 'workflow:\n projectPath: docs/openspec\n');
40
+ const userBytes = Buffer.from('user backup\n', 'utf8');
41
+ fs.writeFileSync(path.join(legacyDir, 'flow-comet-state.json.bak-20260901-user'), userBytes);
42
+ // 活动 change 工件(迁移后流程可继续的前提)
43
+ writeFile(target, '.specs/mig-ch/CHANGE.md', '# CHANGE\n\n- **Change ID**: mig-ch\n\n## Why(为什么做)\n\nx\n');
44
+ writeFile(target, '.specs/mig-ch/REQUIREMENT.md', '# REQUIREMENT\n\n- **Change ID**: mig-ch\n\n## 用户故事(User Story)\n\nx\n\n## 验收准则(AC)\n\n- y\n');
45
+ writeFile(target, '.specs/mig-ch/DESIGN.md', '# DESIGN\n\n- **Change ID**: mig-ch\n\n## 0. 技术栈\n\nNode\n\n## 决策清单\n\n| # | D | R |\n|---|---|---|\n| D1 | x | y |\n');
46
+ seedForeignFlowKit(target); // 安装器不再走网络克隆(与 K14~K16 同手法)
47
+ const install = spawnSync(process.execPath, [installer, '--target', target, '--platform', 'claude-code'], {
48
+ cwd: repoRoot, encoding: 'utf8', timeout: 120000,
49
+ });
50
+ const installRes = { status: install.status ?? 1, output: String(install.stdout || '') + String(install.stderr || '') };
51
+ assertExit(installRes, 0);
52
+ assertOut(installRes, '已迁移');
53
+ // ① 状态逐字节搬到新命名空间;旧位置移除;迁移前备份在场且逐字节一致
54
+ const migrated = path.join(target, '.flow-comet', 'flow-comet-state.json');
55
+ if (!fs.existsSync(migrated)) throw new Error('迁移后新位置状态文件缺失: ' + migrated);
56
+ if (!fs.readFileSync(migrated).equals(stateBytes)) throw new Error('迁移后状态与迁移前不逐字节一致');
57
+ if (fs.existsSync(path.join(legacyDir, 'flow-comet-state.json'))) throw new Error('迁移后旧位置状态文件应已移除');
58
+ const backups = fs.readdirSync(path.join(target, '.flow-comet')).filter((n) => /^flow-comet-state\.json\.bak-/.test(n));
59
+ if (backups.length !== 1) throw new Error('迁移前备份应恰一份: ' + JSON.stringify(backups));
60
+ if (!fs.readFileSync(path.join(target, '.flow-comet', backups[0])).equals(stateBytes)) {
61
+ throw new Error('迁移前备份与迁移前状态不逐字节一致');
62
+ }
63
+ // ② 非 flow-comet 内容原位未动
64
+ if (!fs.readFileSync(path.join(legacyDir, 'config.yaml')).equals(Buffer.from('workflow:\n projectPath: docs/openspec\n', 'utf8'))) {
65
+ throw new Error('同目录 Comet 资产被改写');
66
+ }
67
+ if (!fs.readFileSync(path.join(legacyDir, 'flow-comet-state.json.bak-20260901-user')).equals(userBytes)) {
68
+ throw new Error('同目录用户文件被改写');
69
+ }
70
+ // ③ 迁移后状态可读(真实安装副本,cwd = 项目根)
71
+ const installed = (script, args) => {
72
+ const res = spawnSync(process.execPath, [path.join(target, '.claude', 'skills', 'flow-comet', 'scripts', script), ...args], {
73
+ cwd: target, encoding: 'utf8', timeout: 60000, env: { ...process.env, FLOW_COMET_RUN_ROOT: target },
74
+ });
75
+ return { status: res.status ?? 1, output: String(res.stdout || '') + String(res.stderr || '') };
76
+ };
77
+ const before = installed('workflow-state.mjs', ['status']);
78
+ assertExit(before, 0);
79
+ assertOut(before, '"change": "mig-ch"');
80
+ assertOut(before, '"stateCurrentNode": "design"'); // 迁移搬移的状态字段原值可读
81
+ // ④ 流程可继续:entry → record → exit 推进到下一节点
82
+ assertExit(installed('workflow-guard.mjs', ['entry', 'design']), 0);
83
+ assertExit(installed('workflow-state.mjs', ['record', 'design', '{"summary":"design done"}']), 0);
84
+ const exitDesign = installed('workflow-guard.mjs', ['exit', 'design', '--apply']);
85
+ assertExit(exitDesign, 0);
86
+ assertOut(exitDesign, 'ALL CHECKS PASSED');
87
+ const after = installed('workflow-state.mjs', ['status']);
88
+ assertExit(after, 0);
89
+ assertOut(after, '"currentNode": "plan"');
90
+ const finalState = JSON.parse(fs.readFileSync(migrated, 'utf8'));
91
+ if (!Array.isArray(finalState.completedNodes) || !finalState.completedNodes.includes('design')) {
92
+ throw new Error('exit design 后 completedNodes 应含 design: ' + JSON.stringify(finalState.completedNodes));
93
+ }
94
+ console.log(' 迁移后链路:状态逐字节搬移 + 备份在场 + status 可读 + 节点推进 design → plan ✓');
95
+ },
96
+ },
97
+
98
+ // K18: 分发面(npm 包形态)——可发布性清单 + 包体边界 + bin 双入口 + init 词元形态与红线
99
+ // + 安装器升级路径清理(镜像目录内「权威源已不存在」的条目在重装后必须消失:含反向探针
100
+ // 与幂等断言;`.claude/rules` 一类无命名空间的生成面 fail-closed 不纳入删除面)
101
+ // + 安装器镜像清理的**根级** fail-closed(镜像根自身为链接 / 真实路径越出项目根两变体:
102
+ // 项目外文件必不消失 + 保留原因可见 + 幂等 + 反向构造证明判别力)。
103
+ // 权威源侧真跑断言(npm pack --dry-run 的真实产物清单在场才算通过);安装副本侧输出显式
104
+ // 「不适用」行并回传同语义的结果标记计通过(禁止静默跳过——「未验证 ≠ 通过」)。
105
+ // 各断言见上方同名助手;结果标记由运行器按环境判据断言(distributionSurface 契约)。
106
+ {
107
+ name: 'K18 分发面:环境判据与包体边界·bin 双入口(权威源真跑/副本显式不适用)与 init 词元红线',
108
+ distributionSurface: true,
109
+ run: (dir) => {
110
+ // 环境判据的判别力锚先跑(与所在环境无关的夹具驱动):判据判错会让下面整段走错分支——
111
+ // 副本侧假红,或权威源侧静默漏检,故判据本身必须先被证明有条判别力。
112
+ assertPackageContextJudgment(dir);
113
+ const pkgCtx = resolvePackageContext();
114
+ const marker = DISTRIBUTION_MARKERS[pkgCtx.kind];
115
+ // 安装器分发面断言(升级路径清理):权威源侧真跑真实命令序列,安装副本侧输出显式
116
+ // 「不适用」行(两侧都出声——副本侧不是静默跳过);故置于环境分支之前调用。
117
+ assertInstallerUpgradePathCleanup(dir);
118
+ // 安装器分发面断言(镜像清理的根级 fail-closed):同一注入点的第二组判据——根自身为链接 /
119
+ // 真实路径越界两变体 + 反向构造;副本侧同样输出显式「不适用」行。
120
+ assertMirrorRootLinkFailClosed(dir, pkgCtx);
121
+ if (pkgCtx.kind === 'copy') {
122
+ console.log(' 不适用(安装副本侧:' + pkgCtx.reason + ')——包体边界/bin 断言仅权威源侧可判,本项计通过');
123
+ return marker;
124
+ }
125
+ assertPublishableManifest(pkgCtx.pkg);
126
+ assertPackageBoundary(pkgCtx.root);
127
+ assertWorkflowContractCheck(dir);
128
+ assertInitTokenContract(assertBinContract(pkgCtx.pkg, pkgCtx.root), dir);
129
+ return marker;
130
+ },
131
+ },
132
+
133
+ // K19: 契约核对脚本 CLI 契约——五组真实命令断言(临时夹具 app/x.py 含 status 赋值、src/y.ts 含 status 比较):
134
+ // ① 显式 --backend/--frontend → exit 0 且输出含两个实际解析路径与两侧真实命中;
135
+ // ② 缺省回退(cwd=夹具、无目录参数)→ exit 0 且两侧命中;
136
+ // ③ 悬空 --backend(缺值)→ exit 1 + 用法错误;
137
+ // ④ --project <夹具>(从夹具外运行)→ exit 0 且两侧命中(证明显式根优先于 cwd);
138
+ // ⑤ 单横线操作数(--backend -bad-dir / --project -x / --frontend -y)→ exit 1 + 用法与非法操作数提示
139
+ // (此前被当作目录接受、零命中仍 exit 0——fail-closed 缺口回归锚)。
140
+ // 夹具随所在项临时目录由运行器统一清理,不留残留。
141
+ {
142
+ name: 'K19 契约核对:显式目录解析与缺省回退·悬空参数用法错误·单横线操作数拒绝·--project 形态(真实命令序列)',
143
+ run: (dir) => {
144
+ if (!fs.existsSync(CONTRACT)) throw new Error('缺少 contract-check.mjs: ' + CONTRACT);
145
+ writeFile(dir, 'app/x.py', 'status = 3\n');
146
+ writeFile(dir, 'src/y.ts', 'status === 3\n');
147
+ const runContract = (args, cwd = dir) => {
148
+ const res = spawnSync(process.execPath, [CONTRACT, ...args], { cwd, encoding: 'utf8', timeout: 60000 });
149
+ return { status: res.status ?? 1, output: String(res.stdout || '') + String(res.stderr || '') };
150
+ };
151
+ // 输出头 `# <label>: <路径>` 取实际解析路径(断言脚本打印的是真实落点,而非回显参数)
152
+ const resolvedPath = (res, label) => {
153
+ const line = res.output.split(/\r?\n/).find((l) => l.startsWith('# ' + label + ': '));
154
+ if (!line) throw new Error('输出缺少 ' + label + ' 解析路径头:\n' + res.output);
155
+ return line.slice(('# ' + label + ': ').length).trim();
156
+ };
157
+ // ① 显式目录参数:exit 0 + 两个实际解析路径 + 两侧真实命中
158
+ const explicit = runContract(['status', '--backend', 'app', '--frontend', 'src']);
159
+ assertExit(explicit, 0);
160
+ assertOut(explicit, 'status = 3');
161
+ assertOut(explicit, 'status === 3');
162
+ const backendPath = resolvedPath(explicit, 'backend');
163
+ const frontendPath = resolvedPath(explicit, 'frontend');
164
+ if (path.basename(backendPath) !== 'app' || path.basename(frontendPath) !== 'src') {
165
+ throw new Error('解析路径落点错误: backend=' + backendPath + ' / frontend=' + frontendPath);
166
+ }
167
+ if (!fs.readFileSync(path.join(backendPath, 'x.py'), 'utf8').includes('status = 3')) {
168
+ throw new Error('backend 实际解析路径未指向夹具: ' + backendPath);
169
+ }
170
+ if (!fs.readFileSync(path.join(frontendPath, 'y.ts'), 'utf8').includes('status === 3')) {
171
+ throw new Error('frontend 实际解析路径未指向夹具: ' + frontendPath);
172
+ }
173
+ // ② 缺省回退:无目录参数时默认 <root>/app 与 <root>/src(root = cwd)
174
+ const fallback = runContract(['status']);
175
+ assertExit(fallback, 0);
176
+ assertOut(fallback, 'status = 3');
177
+ assertOut(fallback, 'status === 3');
178
+ // ③ 悬空 --backend:缺值即用法错误 + 非零退出
179
+ const dangling = runContract(['status', '--backend']);
180
+ assertExit(dangling, 1);
181
+ assertOut(dangling, '用法: node contract-check.mjs');
182
+ assertOut(dangling, '--backend 后缺少后端目录值');
183
+ // ④ --project 形态:从夹具外运行,显式项目根优先于 cwd(若被忽略则两侧都不命中)
184
+ const elsewhere = path.join(dir, 'elsewhere');
185
+ fs.mkdirSync(elsewhere, { recursive: true });
186
+ const viaProject = runContract(['status', '--project', dir], elsewhere);
187
+ assertExit(viaProject, 0);
188
+ assertOut(viaProject, 'status = 3');
189
+ assertOut(viaProject, 'status === 3');
190
+ // ⑤ 单横线操作数:取值以 '-' 开头(含单横线形态)→ 用法错误 + 非零退出,不被当作目录
191
+ // (判据含选项名与非法操作数提示——只查 exit 1 无判别力,须证明拒绝理由在场)
192
+ const assertDashOperandRejected = (opt, bad) => {
193
+ const r = runContract(['status', opt, bad]);
194
+ assertExit(r, 1);
195
+ assertOut(r, '用法: node contract-check.mjs');
196
+ assertOut(r, opt + ' 的目录操作数不得以 - 开头');
197
+ };
198
+ assertDashOperandRejected('--backend', '-bad-dir');
199
+ assertDashOperandRejected('--project', '-x');
200
+ assertDashOperandRejected('--frontend', '-y');
201
+ console.log(' 契约核对 CLI: 显式解析 + 缺省回退 + 悬空参数用法错误 + 单横线操作数拒绝 + --project 优先于 cwd ✓');
202
+ },
203
+ },
204
+
205
+ // ---------- L. 执行遗漏防护(真实链路) ----------
206
+
207
+ {
208
+ name: 'L1 进入证据:entry 记录 enteredNodes,正常流程 exit 无误报',
209
+ run: (dir) => {
210
+ gitInit(dir);
211
+ assertExit(runState(['init', CHANGE_ID, '--init-skip'], dir), 0);
212
+ assertExit(runState(['skill-load', 'open', 'flow-comet-change', '--prompt', 'flow-kit/prompts/0-change.md'], dir), 0);
213
+ assertExit(runState(['skill-load', 'design', 'flow-comet-design', '--prompt', 'flow-kit/prompts/2-design.md'], dir), 0);
214
+ writeIntakeArtifacts(dir);
215
+ // ① entry open 记录进入标记
216
+ assertExit(runGuard(['entry', 'open'], dir), 0);
217
+ const st = readStateFile(dir);
218
+ if (!Array.isArray(st.enteredNodes) || !st.enteredNodes.includes('open')) {
219
+ throw new Error('entry 未记录 enteredNodes: ' + JSON.stringify(st.enteredNodes));
220
+ }
221
+ // ② 未 entry 直接 exit(构造:跳过 design 的 entry,state 已激活)→ ENTER WARN 渐进
222
+ assertExit(runState(['record', 'open', '{"summary":"intake complete"}'], dir), 0);
223
+ assertExit(runGuard(['exit', 'open', '--apply'], dir), 0);
224
+ // 推进到 design 后不 entry 直接 exit?→ currentNode 检查会拦;验证 enter 证据在真实链路不误报
225
+ assertExit(runGuard(['entry', 'design'], dir), 0);
226
+ writeFile(dir, '.specs/' + CHANGE_ID + '/DESIGN.md', '# DESIGN\n\n- **Change ID**: ' + CHANGE_ID + '\n\n## 0. 技术栈\n\npython\n\n## 决策清单\n\n- [ ] D1\n');
227
+ assertExit(runState(['record', 'design', '{"summary":"design done"}'], dir), 0);
228
+ const rDesign = runGuard(['exit', 'design', '--apply'], dir);
229
+ assertExit(rDesign, 0);
230
+ assertNotOut(rDesign, 'ENTER WARN');
231
+ },
232
+ },
233
+
234
+ {
235
+ name: 'L2 空退出豁免:显式 emptyExitApproved 后全 parallel execute 通过',
236
+ run: (dir) => {
237
+ gitInit(dir);
238
+ // fixture state(currentNode=execute + enter 机制激活)+ 真实命令序列:
239
+ // 全 parallel 任务在 plan exit 后正常路由 subagent-execute(M6 豁免用于已进入 execute 且无串行可做的场景)
240
+ const taskAllParallel = '# TASK\n\n<task id="P01" parallel="true" status="pending"><action>p</action><write_files>a</write_files><verify>t</verify><done>d</done></task>\n';
241
+ // ① 显式豁免 → 空退出通过
242
+ const st = baseState('execute');
243
+ st.enteredNodes = ['open', 'design', 'plan'];
244
+ writeState(dir, st);
245
+ writeFile(dir, '.specs/' + CHANGE_ID + '/TASK.md', taskAllParallel);
246
+ assertExit(runGuard(['entry', 'execute'], dir), 0);
247
+ assertExit(runState(['record', 'execute', '{"summary":"no serial tasks","emptyExitApproved":true}'], dir), 0);
248
+ const r = runGuard(['exit', 'execute', '--apply'], dir);
249
+ assertExit(r, 0);
250
+ assertOut(r, 'ALL CHECKS PASSED');
251
+ // ② 无豁免 → 仍 BLOCKED(默认防规划错误)
252
+ const st2 = baseState('execute');
253
+ st2.enteredNodes = ['open', 'design', 'plan'];
254
+ writeState(dir, st2);
255
+ writeFile(dir, '.specs/' + CHANGE_ID + '/TASK.md', taskAllParallel);
256
+ assertExit(runGuard(['entry', 'execute'], dir), 0);
257
+ assertExit(runState(['record', 'execute', '{"summary":"no serial tasks"}'], dir), 0);
258
+ const r2 = runGuard(['exit', 'execute', '--apply'], dir);
259
+ assertExit(r2, 1);
260
+ assertOut(r2, 'BLOCKED');
261
+ },
262
+ },
263
+
264
+ {
265
+ name: 'L3 空仓库:init 在无提交仓库输出 EMPTY-REPO 提示',
266
+ run: (dir) => {
267
+ execFileSync('git', ['init', '-q'], { cwd: dir, stdio: 'ignore' }); // 无提交
268
+ const r = runState(['init', CHANGE_ID, '--init-skip'], dir);
269
+ assertExit(r, 0);
270
+ assertOut(r, 'EMPTY-REPO');
271
+ },
272
+ },
273
+ ];
274
+
275
+ export const ENTRIES = RAW_ENTRIES.map(applyDistributionSurface);