flow-comet 1.6.4 → 1.6.5

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 (64) hide show
  1. package/.flow-comet/skills/flow-comet/INSTALLED_VERSION +1 -1
  2. package/.flow-comet/skills/flow-comet/SKILL.md +21 -3
  3. package/.flow-comet/skills/flow-comet/reference/artifact-template-overlay.md +154 -0
  4. package/.flow-comet/skills/flow-comet/reference/artifact-templates.json +387 -0
  5. package/.flow-comet/skills/flow-comet/reference/entry-detail.md +8 -2
  6. package/.flow-comet/skills/flow-comet/reference/workflow-protocol.json +22 -0
  7. package/.flow-comet/skills/flow-comet/scripts/evolve.mjs +174 -0
  8. package/.flow-comet/skills/flow-comet/scripts/guard-self-test.mjs +3 -1
  9. package/.flow-comet/skills/flow-comet/scripts/health.mjs +28 -4
  10. package/.flow-comet/skills/flow-comet/scripts/items/a.mjs +41 -18
  11. package/.flow-comet/skills/flow-comet/scripts/items/b.mjs +16 -16
  12. package/.flow-comet/skills/flow-comet/scripts/items/c.mjs +6 -6
  13. package/.flow-comet/skills/flow-comet/scripts/items/h.mjs +9 -7
  14. package/.flow-comet/skills/flow-comet/scripts/items/l.mjs +2 -2
  15. package/.flow-comet/skills/flow-comet/scripts/items/m.mjs +17 -13
  16. package/.flow-comet/skills/flow-comet/scripts/items/n.mjs +154 -0
  17. package/.flow-comet/skills/flow-comet/scripts/lib/guard-artifact-skeleton.mjs +406 -0
  18. package/.flow-comet/skills/flow-comet/scripts/lib/guard-evidence-gates.mjs +206 -3
  19. package/.flow-comet/skills/flow-comet/scripts/lib/guard-gates.mjs +458 -60
  20. package/.flow-comet/skills/flow-comet/scripts/lib/guard-routing.mjs +38 -58
  21. package/.flow-comet/skills/flow-comet/scripts/lib/guard-template-fidelity.mjs +642 -230
  22. package/.flow-comet/skills/flow-comet/scripts/lib/guard-uidesign.mjs +85 -14
  23. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-admin.mjs +43 -5
  24. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-flow.mjs +15 -1
  25. package/.flow-comet/skills/flow-comet/scripts/lib/state-explain.mjs +18 -1
  26. package/.flow-comet/skills/flow-comet/scripts/lib/state-skillmarkers.mjs +60 -0
  27. package/.flow-comet/skills/flow-comet/scripts/lib/system-fixtures.mjs +73 -9
  28. package/.flow-comet/skills/flow-comet/scripts/lib/test-fixtures.mjs +21 -1
  29. package/.flow-comet/skills/flow-comet/scripts/lib/text-anchor-checks.mjs +9 -0
  30. package/.flow-comet/skills/flow-comet/scripts/protocol-utils.mjs +212 -0
  31. package/.flow-comet/skills/flow-comet/scripts/scenarios/a.mjs +15 -5
  32. package/.flow-comet/skills/flow-comet/scripts/scenarios/c.mjs +4 -4
  33. package/.flow-comet/skills/flow-comet/scripts/scenarios/e.mjs +20 -10
  34. package/.flow-comet/skills/flow-comet/scripts/scenarios/g.mjs +4 -1
  35. package/.flow-comet/skills/flow-comet/scripts/scenarios/j.mjs +6 -6
  36. package/.flow-comet/skills/flow-comet/scripts/scenarios/l.mjs +13 -5
  37. package/.flow-comet/skills/flow-comet/scripts/scenarios/n.mjs +2125 -0
  38. package/.flow-comet/skills/flow-comet/scripts/system-test.mjs +6 -5
  39. package/.flow-comet/skills/flow-comet/scripts/workflow-guard.mjs +74 -2
  40. package/.flow-comet/skills/flow-comet-archive/SKILL.md +6 -2
  41. package/.flow-comet/skills/flow-comet-change/SKILL.md +6 -2
  42. package/.flow-comet/skills/flow-comet-design/GUIDANCE.md +13 -3
  43. package/.flow-comet/skills/flow-comet-design/SKILL.md +15 -8
  44. package/.flow-comet/skills/flow-comet-dev/SKILL.md +1 -1
  45. package/.flow-comet/skills/flow-comet-evolve/SKILL.md +1 -0
  46. package/.flow-comet/skills/flow-comet-execute/SKILL.md +13 -10
  47. package/.flow-comet/skills/flow-comet-health/SKILL.md +1 -1
  48. package/.flow-comet/skills/flow-comet-integration/SKILL.md +1 -1
  49. package/.flow-comet/skills/flow-comet-open/GUIDANCE.md +14 -4
  50. package/.flow-comet/skills/flow-comet-open/SKILL.md +11 -9
  51. package/.flow-comet/skills/flow-comet-plan/GUIDANCE.md +13 -3
  52. package/.flow-comet/skills/flow-comet-plan/SKILL.md +11 -7
  53. package/.flow-comet/skills/flow-comet-requirement/SKILL.md +1 -1
  54. package/.flow-comet/skills/flow-comet-review/SKILL.md +15 -9
  55. package/.flow-comet/skills/flow-comet-subagent-execute/GUIDANCE.md +13 -3
  56. package/.flow-comet/skills/flow-comet-subagent-execute/SKILL.md +11 -8
  57. package/.flow-comet/skills/flow-comet-task/SKILL.md +1 -1
  58. package/.flow-comet/skills/flow-comet-test/SKILL.md +6 -2
  59. package/.flow-comet/skills/flow-comet-ui-design/SKILL.md +2 -2
  60. package/.flow-comet/skills/flow-comet-verify/SKILL.md +12 -8
  61. package/README.md +3 -3
  62. package/package.json +1 -1
  63. package/scripts/dsh-bridge.mjs +2 -2
  64. package/scripts/lib/installer-flowkit.mjs +43 -3
@@ -86,7 +86,7 @@ export const ENTRIES = [
86
86
  assertNodeLine(a21PostNext, 'review');
87
87
 
88
88
  // ⑤ 回源 review 出口门禁真实执行:缺处置标记 → BLOCKED;补齐后同出口通过并推进 verify
89
- assertExit(runState(['skill-load', 'review', 'flow-comet-review', '--prompt', 'flow-kit/prompts/6-review.md'], dir, env), 0);
89
+ assertExit(runState(['skill-load', 'review', 'flow-comet-review', '--prompt', 'flow-kit/prompts/6-review.md', '--templates', 'REVIEW.md,TEST.md'], dir, env), 0);
90
90
  assertExit(runGuard(['entry', 'review'], dir, env), 0);
91
91
  writeFile(dir, '.specs/' + CHANGE_ID + '/REVIEW.md', fixBatchReviewDoc(false));
92
92
  const gate = runGuard(['exit', 'review', '--apply'], dir, env);
@@ -247,7 +247,7 @@ export const ENTRIES = [
247
247
  assertOut(rClosedExit, 'FIX-BATCH: 回源节点 review(execute 出口已完成)');
248
248
  assertNotOut(rClosedExit, 'RETURN: 回源节点');
249
249
  assertNodeLine(rClosedExit, 'review');
250
- assertExit(runState(['skill-load', 'review', 'flow-comet-review', '--prompt', 'flow-kit/prompts/6-review.md'], dir, env), 0);
250
+ assertExit(runState(['skill-load', 'review', 'flow-comet-review', '--prompt', 'flow-kit/prompts/6-review.md', '--templates', 'REVIEW.md,TEST.md'], dir, env), 0);
251
251
  assertExit(runGuard(['entry', 'review'], dir, env), 0);
252
252
  const rReviewPass = runGuard(['exit', 'review', '--apply'], dir, env);
253
253
  assertExit(rReviewPass, 0);
@@ -280,7 +280,7 @@ export const ENTRIES = [
280
280
  writeFile(dir, '.specs/' + CHANGE_ID + '/TASK.md', fixBatchParallelTaskText('done'));
281
281
  writeFile(dir, '.specs/' + CHANGE_ID + '/P-FIX-01-SUMMARY.md', execSummaryFixture('P-FIX-01'));
282
282
  // 委托前先加载节点技能声明(新 change 两层加载模型:request 命令要求标记在位)。
283
- assertExit(runState(['skill-load', 'subagent-execute', 'flow-comet-dev', '--prompt', 'flow-kit/prompts/4-dev.md'], dir, env), 0);
283
+ assertExit(runState(['skill-load', 'subagent-execute', 'flow-comet-dev', '--prompt', 'flow-kit/prompts/4-dev.md', '--templates', 'SUMMARY.md'], dir, env), 0);
284
284
  for (const taskId of ['T01', 'P-FIX-01']) {
285
285
  assertExit(runHandoff(['request', taskId, taskId + ' 委托', '--write-files', 'src/' + taskId.toLowerCase() + '.mjs'], dir), 0);
286
286
  assertExit(runHandoff(['result', taskId, fullContract('abcd1234abcd1234abcd1234abcd1234abcd1234', taskId)], dir), 0);
@@ -296,7 +296,7 @@ export const ENTRIES = [
296
296
  if (pSt.currentNode !== 'review') {
297
297
  throw new Error('并行修复第二趟出口应回源 review,实际 ' + JSON.stringify(pSt.currentNode));
298
298
  }
299
- assertExit(runState(['skill-load', 'review', 'flow-comet-review', '--prompt', 'flow-kit/prompts/6-review.md'], dir, env), 0);
299
+ assertExit(runState(['skill-load', 'review', 'flow-comet-review', '--prompt', 'flow-kit/prompts/6-review.md', '--templates', 'REVIEW.md,TEST.md'], dir, env), 0);
300
300
  assertExit(runGuard(['entry', 'review'], dir, env), 0);
301
301
  const pReviewPass = runGuard(['exit', 'review', '--apply'], dir, env);
302
302
  assertExit(pReviewPass, 0);
@@ -407,7 +407,7 @@ export const ENTRIES = [
407
407
  writeFile(dir, '.specs/' + CHANGE_ID + '/TASK.md', fixBatchTwoFixTaskText('done', 'done'));
408
408
  writeFile(dir, '.specs/' + CHANGE_ID + '/T-FIX-01-SUMMARY.md', execSummaryFixture('T-FIX-01'));
409
409
  writeFile(dir, '.specs/' + CHANGE_ID + '/T-FIX-02-SUMMARY.md', execSummaryFixture('T-FIX-02'));
410
- assertExit(runState(['skill-load', 'execute', 'flow-comet-execute', '--prompt', 'flow-kit/prompts/4-dev.md'], dir, env), 0);
410
+ assertExit(runState(['skill-load', 'execute', 'flow-comet-execute', '--prompt', 'flow-kit/prompts/4-dev.md', '--templates', 'SUMMARY.md'], dir, env), 0);
411
411
  assertExit(runState(['record', 'execute', '{"summary":"fix wave two executed","parallelTakeoverApproved":true}'], dir, env), 0);
412
412
  const wave2 = runGuard(['exit', 'execute', '--apply'], dir, env);
413
413
  assertExit(wave2, 0);
@@ -466,7 +466,7 @@ export const ENTRIES = [
466
466
  executionMode: 'subagent',
467
467
  directOverride: false,
468
468
  });
469
- assertExit(runState(['skill-load', 'execute', 'flow-comet-execute', '--prompt', 'flow-kit/prompts/4-dev.md'], dir, env), 0);
469
+ assertExit(runState(['skill-load', 'execute', 'flow-comet-execute', '--prompt', 'flow-kit/prompts/4-dev.md', '--templates', 'SUMMARY.md'], dir, env), 0);
470
470
  assertExit(runState(['record', 'execute', '{"summary":"legacy state closure","parallelTakeoverApproved":true}'], dir, env), 0);
471
471
  const legacyExit = runGuard(['exit', 'execute', '--apply'], dir, env);
472
472
  assertExit(legacyExit, 0);
@@ -500,7 +500,7 @@ export const ENTRIES = [
500
500
  for (let i = 1; i <= n; i++) {
501
501
  writeFile(dir, '.specs/' + CHANGE_ID + '/T-FIX-0' + i + '-SUMMARY.md', execSummaryFixture('T-FIX-0' + i));
502
502
  }
503
- assertExit(runState(['skill-load', 'execute', 'flow-comet-execute', '--prompt', 'flow-kit/prompts/4-dev.md'], dir, env), 0);
503
+ assertExit(runState(['skill-load', 'execute', 'flow-comet-execute', '--prompt', 'flow-kit/prompts/4-dev.md', '--templates', 'SUMMARY.md'], dir, env), 0);
504
504
  // entry 记录 taskHash:签名值必须带算法版本前缀(新链路 vN 前缀形态)
505
505
  assertExit(runGuard(['entry', 'execute'], dir, env), 0);
506
506
  const stHash = readStateFile(dir);
@@ -628,7 +628,7 @@ export const ENTRIES = [
628
628
  // 清掉本项先前 verify 子场景遗留的 TEST/UAT,使回程路由确定为 verify(夹具前提)
629
629
  fs.rmSync(path.join(dir, '.specs', CHANGE_ID, 'TEST.md'), { force: true });
630
630
  fs.rmSync(path.join(dir, '.specs', CHANGE_ID, 'UAT.md'), { force: true });
631
- assertExit(runState(['skill-load', 'review', 'flow-comet-review', '--prompt', 'flow-kit/prompts/6-review.md'], dir, env), 0);
631
+ assertExit(runState(['skill-load', 'review', 'flow-comet-review', '--prompt', 'flow-kit/prompts/6-review.md', '--templates', 'REVIEW.md,TEST.md'], dir, env), 0);
632
632
  assertExit(runGuard(['entry', 'review'], dir, env), 0);
633
633
  const skewExit = runGuard(['exit', 'review', '--apply'], dir, env);
634
634
  assertExit(skewExit, 0);
@@ -646,7 +646,7 @@ export const ENTRIES = [
646
646
  run: (dir) => {
647
647
  assertExit(runState(['init', CHANGE_ID], dir), 0);
648
648
  writeFile(dir, 'flow-kit/prompts/0-change.md', '# 阶段 0 · CHANGE\n\n## 角色\n\n你是 Changeer。\n');
649
- const res = runState(['skill-load', 'open', 'flow-comet-change', '--prompt', 'flow-kit/prompts/0-change.md'], dir);
649
+ const res = runState(['skill-load', 'open', 'flow-comet-change', '--prompt', 'flow-kit/prompts/0-change.md', '--templates', 'CHANGE.md,REQUIREMENT.md'], dir);
650
650
  assertExit(res, 0);
651
651
  assertOut(res, 'SKILL-LOAD: open flow-comet-change');
652
652
  const markerPath = path.join(dir, '.specs', CHANGE_ID, '.skill-loads', 'open-flow-comet-change.json');
@@ -708,7 +708,7 @@ export const ENTRIES = [
708
708
  name: 'B4 record:声明后记录通过',
709
709
  run: (dir) => {
710
710
  assertExit(runState(['init', CHANGE_ID], dir), 0);
711
- assertExit(runState(['skill-load', 'open', 'flow-comet-change'], dir), 0);
711
+ assertExit(runState(['skill-load', 'open', 'flow-comet-change', '--templates', 'CHANGE.md,REQUIREMENT.md'], dir), 0);
712
712
  const res = runState(['record', 'open', JSON.stringify({ summary: 'done', completedChecks: ['required-skill:open.flow-comet-change'] })], dir);
713
713
  assertExit(res, 0);
714
714
  assertOut(res, 'EVIDENCE: open');
@@ -749,7 +749,7 @@ export const ENTRIES = [
749
749
  name: 'B7 record:委托范围条目豁免(有委托通过 / 无委托拦截)',
750
750
  run: (dir) => {
751
751
  assertExit(runState(['init', CHANGE_ID], dir), 0);
752
- assertExit(runState(['skill-load', 'subagent-execute', 'flow-comet-dev'], dir), 0);
752
+ assertExit(runState(['skill-load', 'subagent-execute', 'flow-comet-dev', '--templates', 'SUMMARY.md'], dir), 0);
753
753
  const payload = JSON.stringify({ summary: 'delegated', completedChecks: ['required-skill:subagent-execute.flow-comet-dev'] });
754
754
  // 无委托记录 → 拦截(handoff scope 条目以共用证据库的委托记录为证据)
755
755
  const blocked = runState(['record', 'subagent-execute', payload], dir);
@@ -774,7 +774,7 @@ export const ENTRIES = [
774
774
  name: 'B8 exit:协议声明标记校验(record 自动补通过 / 手动声明 / 空协议·损坏拦截)',
775
775
  run: (dir) => {
776
776
  assertExit(runState(['init', CHANGE_ID], dir), 0);
777
- assertExit(runState(['skill-load', 'open', 'flow-comet-change', '--prompt', 'flow-kit/prompts/0-change.md'], dir), 0);
777
+ assertExit(runState(['skill-load', 'open', 'flow-comet-change', '--prompt', 'flow-kit/prompts/0-change.md', '--templates', 'CHANGE.md,REQUIREMENT.md'], dir), 0);
778
778
  writeIntakeArtifacts(dir);
779
779
  writeFile(dir, 'flow-kit/prompts/0-change.md', '# 阶段 0 · CHANGE\n\n## 角色\n\n你是 Changeer。\n');
780
780
  // ① M5: record 自动补声明标记 → 出口通过(无需手动 skill-load)
@@ -787,14 +787,14 @@ export const ENTRIES = [
787
787
  assertOut(rAuto, 'ALL CHECKS PASSED');
788
788
  assertNotOut(rAuto, 'BLOCKED');
789
789
  // ② 手动 skill-load --prompt(protocol = basename)覆盖自动标记 → 出口通过
790
- assertExit(runState(['skill-load', 'open', 'flow-comet-change', '--prompt', 'flow-kit/prompts/0-change.md'], dir), 0);
790
+ assertExit(runState(['skill-load', 'open', 'flow-comet-change', '--prompt', 'flow-kit/prompts/0-change.md', '--templates', 'CHANGE.md,REQUIREMENT.md'], dir), 0);
791
791
  const rPass = runGuard(['exit', 'open'], dir);
792
792
  assertExit(rPass, 0);
793
793
  assertOut(rPass, 'ALL CHECKS PASSED');
794
794
  assertNotOut(rPass, 'BLOCKED');
795
795
  // ③ 未传 --prompt → 标记 protocol = null → 拦截(fail-closed;open 两个 requiredSkillCalls 均覆盖为 null)
796
- assertExit(runState(['skill-load', 'open', 'flow-comet-change'], dir), 0);
797
- assertExit(runState(['skill-load', 'open', 'flow-comet-requirement'], dir), 0);
796
+ assertExit(runState(['skill-load', 'open', 'flow-comet-change', '--templates', 'CHANGE.md,REQUIREMENT.md'], dir), 0);
797
+ assertExit(runState(['skill-load', 'open', 'flow-comet-requirement', '--templates', 'CHANGE.md,REQUIREMENT.md'], dir), 0);
798
798
  const rNull = runGuard(['exit', 'open'], dir);
799
799
  assertExit(rNull, 1);
800
800
  assertOut(rNull, 'exit 缺协议声明标记');
@@ -811,7 +811,7 @@ export const ENTRIES = [
811
811
  name: 'B9 旧项目兼容:record 自动补声明后照常通过',
812
812
  run: (dir) => {
813
813
  assertExit(runState(['init', CHANGE_ID], dir), 0);
814
- assertExit(runState(['skill-load', 'open', 'flow-comet-change', '--prompt', 'flow-kit/prompts/0-change.md'], dir), 0);
814
+ assertExit(runState(['skill-load', 'open', 'flow-comet-change', '--prompt', 'flow-kit/prompts/0-change.md', '--templates', 'CHANGE.md,REQUIREMENT.md'], dir), 0);
815
815
  // 旧格式记录:completedChecks 无 required-skill 条目 → 不校验标记,通过
816
816
  const rA = runState(['record', 'open', JSON.stringify({ summary: 'legacy', completedChecks: ['unit-tests'] })], dir);
817
817
  assertExit(rA, 0);
@@ -21,7 +21,7 @@ export const ENTRIES = [
21
21
  writeState(dir, baseState('execute'));
22
22
  writeFile(dir, '.specs/' + CHANGE_ID + '/TASK.md',
23
23
  '# TASK\n\n<task id="T01" status="done" parallel="true">\n <action>实现 T01</action>\n <write_files>src/t1.mjs</write_files>\n <verify>node --check src/t1.mjs</verify>\n</task>\n');
24
- assertExit(runState(['skill-load', 'execute', 'flow-comet-dev', '--prompt', 'flow-kit/prompts/4-dev.md'], dir), 0);
24
+ assertExit(runState(['skill-load', 'execute', 'flow-comet-dev', '--prompt', 'flow-kit/prompts/4-dev.md', '--templates', 'SUMMARY.md'], dir), 0);
25
25
  writeFile(dir, 'src/t1.mjs', 'export const x = 1;\n');
26
26
  execFileSync('git', ['add', 'src/t1.mjs'], { cwd: dir });
27
27
  execFileSync('git', ['-c', 'user.name=t', '-c', 'user.email=t@t', 'commit', '-qm', 'feat: t1'], { cwd: dir });
@@ -255,7 +255,7 @@ export const ENTRIES = [
255
255
  if (!fs.readFileSync(parallelTaskPath, 'utf8').includes('<task id="P16" parallel="true" status="pending">')) {
256
256
  throw new Error('并行 × 零提交锚的前提失效:TASK.md 未标 parallel="true"');
257
257
  }
258
- assertExit(runState(['skill-load', 'subagent-execute', 'flow-comet-dev', '--prompt', 'flow-kit/prompts/4-dev.md'], dir), 0);
258
+ assertExit(runState(['skill-load', 'subagent-execute', 'flow-comet-dev', '--prompt', 'flow-kit/prompts/4-dev.md', '--templates', 'SUMMARY.md'], dir), 0);
259
259
  const stParallel = readStateFile(dir);
260
260
  stParallel.currentNode = 'subagent-execute';
261
261
  stParallel.enteredNodes = ['open', 'design', 'plan', 'execute', 'subagent-execute'];
@@ -359,7 +359,7 @@ export const ENTRIES = [
359
359
  execFileSync('git', ['add', 'src/p02.mjs'], { cwd: dir });
360
360
  execFileSync('git', ['-c', 'user.name=t', '-c', 'user.email=t@t', 'commit', '-qm', 'feat: p02'], { cwd: dir });
361
361
  const p02Hash = execFileSync('git', ['rev-parse', 'HEAD'], { cwd: dir, encoding: 'utf8' }).trim();
362
- assertExit(runState(['skill-load', 'execute', 'flow-comet-dev', '--prompt', 'flow-kit/prompts/4-dev.md'], dir), 0);
362
+ assertExit(runState(['skill-load', 'execute', 'flow-comet-dev', '--prompt', 'flow-kit/prompts/4-dev.md', '--templates', 'SUMMARY.md'], dir), 0);
363
363
  const ownershipStatePath = path.join(dir, '.flow-comet', 'flow-comet-state.json');
364
364
  const ownershipBytes = fs.readFileSync(ownershipStatePath, 'utf8');
365
365
  const wrongNode = runHandoff(['request', 'P02', 'P02 委托', '--write-files', 'src/p02.mjs'], dir, ownershipEnv);
@@ -382,7 +382,7 @@ export const ENTRIES = [
382
382
  if (readStateFile(dir).currentNode !== 'subagent-execute') {
383
383
  throw new Error('next 未按路由校正 state.currentNode: ' + JSON.stringify(readStateFile(dir).currentNode));
384
384
  }
385
- assertExit(runState(['skill-load', 'subagent-execute', 'flow-comet-dev', '--prompt', 'flow-kit/prompts/4-dev.md'], dir), 0);
385
+ assertExit(runState(['skill-load', 'subagent-execute', 'flow-comet-dev', '--prompt', 'flow-kit/prompts/4-dev.md', '--templates', 'SUMMARY.md'], dir), 0);
386
386
  assertExit(runGuard(['entry', 'subagent-execute'], dir), 0);
387
387
  const correctedRequest = runHandoff(['request', 'P02', 'P02 委托', '--write-files', 'src/p02.mjs'], dir, ownershipEnv);
388
388
  assertExit(correctedRequest, 0);
@@ -648,7 +648,7 @@ export const ENTRIES = [
648
648
  const hash = execFileSync('git', ['rev-parse', 'HEAD'], { cwd: dir, encoding: 'utf8' }).trim();
649
649
  // ① 空交接拦截:record 仅写空 handoffResult → 出口缺证据(无委托不可 exit)
650
650
  assertExit(runState(['init', CHANGE_ID], dir), 0);
651
- assertExit(runState(['skill-load', 'subagent-execute', 'flow-comet-dev', '--prompt', 'flow-kit/prompts/4-dev.md'], dir), 0);
651
+ assertExit(runState(['skill-load', 'subagent-execute', 'flow-comet-dev', '--prompt', 'flow-kit/prompts/4-dev.md', '--templates', 'SUMMARY.md'], dir), 0);
652
652
  assertExit(runState(['record', 'subagent-execute', '{"handoffResult":{}}'], dir), 0);
653
653
  const stEmpty = readStateFile(dir);
654
654
  stEmpty.currentNode = 'subagent-execute';
@@ -703,7 +703,7 @@ export const ENTRIES = [
703
703
  const rDeclBlock = runGuard(['exit', 'subagent-execute'], dir);
704
704
  assertExit(rDeclBlock, 1);
705
705
  assertOut(rDeclBlock, 'exit 缺协议声明标记');
706
- assertExit(runState(['skill-load', 'subagent-execute', 'flow-comet-dev', '--prompt', 'flow-kit/prompts/4-dev.md'], dir), 0);
706
+ assertExit(runState(['skill-load', 'subagent-execute', 'flow-comet-dev', '--prompt', 'flow-kit/prompts/4-dev.md', '--templates', 'SUMMARY.md'], dir), 0);
707
707
  const rDeclPass = runGuard(['exit', 'subagent-execute'], dir);
708
708
  assertExit(rDeclPass, 0);
709
709
  assertOut(rDeclPass, 'ALL CHECKS PASSED');
@@ -8,7 +8,7 @@ import path from 'path';
8
8
  import { execFileSync, spawnSync } from 'child_process';
9
9
  import { createHash } from 'crypto';
10
10
  import { assertExit, assertNotOut, assertOut, runGuard, runHandoff, runState, writeFile, writeState } from '../lib/test-helpers.mjs';
11
- import { CHANGE_ID, assertNodeLine, assertNotNodeLine, completeFixTaskAndRecord, driveThroughDesign, execSummaryFixture, fixBatchReviewDoc, fixBatchTaskText, fullContract, parseStatusOutput, readStateBytes, readStateFile, writeIntakeArtifacts } from '../lib/system-fixtures.mjs';
11
+ import { archiveRecordJson, CHANGE_ID, assertNodeLine, assertNotNodeLine, completeFixTaskAndRecord, driveThroughDesign, execSummaryFixture, fixBatchReviewDoc, fixBatchTaskText, fullContract, parseStatusOutput, readStateBytes, readStateFile, writeIntakeArtifacts } from '../lib/system-fixtures.mjs';
12
12
 
13
13
  // 同夹具的「段内大写 Z 早于方法名」变体(真实机检标记形态):6 维自查段体首行是含大写 Z 的机检
14
14
  // 标记说明,方法声明行在其后。段尾判定若把大写 Z 当串尾(惰性段体在段内首个 Z 处提前收尾),
@@ -107,13 +107,13 @@ function replanTaskText(options = {}) {
107
107
  function seedExecuteEntryState(dir, taskText) {
108
108
  driveThroughDesign(dir);
109
109
  writeFile(dir, '.specs/' + CHANGE_ID + '/TASK.md', taskText);
110
- assertExit(runState(['skill-load', 'plan', 'flow-comet-plan', '--prompt', 'flow-kit/prompts/3-task.md'], dir), 0);
110
+ assertExit(runState(['skill-load', 'plan', 'flow-comet-plan', '--prompt', 'flow-kit/prompts/3-task.md', '--templates', 'TASK.md'], dir), 0);
111
111
  assertExit(runState(['record', 'plan', '{"summary":"plan done"}'], dir), 0);
112
112
  assertExit(runGuard(['entry', 'plan'], dir), 0);
113
113
  const planExit = runGuard(['exit', 'plan', '--apply'], dir);
114
114
  assertExit(planExit, 0);
115
115
  assertNodeLine(planExit, 'execute');
116
- assertExit(runState(['skill-load', 'execute', 'flow-comet-dev', '--prompt', 'flow-kit/prompts/4-dev.md'], dir), 0);
116
+ assertExit(runState(['skill-load', 'execute', 'flow-comet-dev', '--prompt', 'flow-kit/prompts/4-dev.md', '--templates', 'SUMMARY.md'], dir), 0);
117
117
  assertExit(runState(['record', 'execute', '{"summary":"implementation recorded"}'], dir), 0);
118
118
  assertExit(runGuard(['entry', 'execute'], dir), 0);
119
119
  }
@@ -191,7 +191,8 @@ export const ENTRIES = [
191
191
  const st0 = readStateFile(dir);
192
192
  st0.currentNode = 'archive';
193
193
  writeState(dir, st0);
194
- assertExit(runState(['record', 'archive', '{"summary":"archived"}'], dir), 0);
194
+ // 归档提名随证据落盘(该 change 无任务 SUMMARY → 扫描 0 份,理由写明无候选入库)
195
+ assertExit(runState(['record', 'archive', archiveRecordJson('archived')], dir), 0);
195
196
  // ① 未移动(无归档目录)→ 出口拦截(缺归档产物)
196
197
  assertExit(runGuard(['entry', 'archive'], dir), 0);
197
198
  const blocked = runGuard(['exit', 'archive'], dir);
@@ -229,13 +230,14 @@ export const ENTRIES = [
229
230
  // 遗留清单(协议 required 产物——随目录移动进归档)
230
231
  writeFile(dir, '.specs/arch-mk/KNOWN-ISSUES.md', '# KNOWN-ISSUES\n\n无遗留问题\n');
231
232
  // 归档前声明标记(open + archive 节点)
232
- assertExit(runState(['skill-load', 'open', 'flow-comet-change', '--prompt', 'flow-kit/prompts/0-change.md'], dir), 0);
233
+ assertExit(runState(['skill-load', 'open', 'flow-comet-change', '--prompt', 'flow-kit/prompts/0-change.md', '--templates', 'CHANGE.md,REQUIREMENT.md'], dir), 0);
233
234
  assertExit(runState(['skill-load', 'archive', 'flow-comet-integration', '--prompt', 'flow-kit/prompts/7-integration.md'], dir), 0);
234
235
  // 节点推进到归档(模拟前序节点出口已完成的状态)
235
236
  const st0 = readStateFile(dir);
236
237
  st0.currentNode = 'archive';
237
238
  writeState(dir, st0);
238
- assertExit(runState(['record', 'archive', '{"summary":"archived"}'], dir), 0);
239
+ // 归档提名随证据落盘(该 change 无任务 SUMMARY → 扫描 0 份,理由写明无候选入库)
240
+ assertExit(runState(['record', 'archive', archiveRecordJson('archived')], dir), 0);
239
241
  // 移动(标记随目录进入归档路径)
240
242
  fs.mkdirSync(path.join(dir, '.specs', 'archive'), { recursive: true });
241
243
  fs.renameSync(path.join(dir, '.specs', 'arch-mk'), path.join(dir, '.specs', 'archive', '2026-08-11-arch-mk'));
@@ -260,7 +262,7 @@ export const ENTRIES = [
260
262
  writeFile(dir, 'flow-kit/prompts/0-change.md', '# 阶段 0 · CHANGE\n\n## 角色\n\n你是 Changeer。\n');
261
263
  writeFile(dir, 'flow-kit/prompts/7-integration.md', '# 阶段 7 · INTEGRATION\n\n## 角色\n\n你是 Integrationer。\n');
262
264
  // 手动 skill-load(活动路径标记,随目录移动进归档)
263
- assertExit(runState(['skill-load', 'open', 'flow-comet-change', '--prompt', 'flow-kit/prompts/0-change.md'], dir), 0);
265
+ assertExit(runState(['skill-load', 'open', 'flow-comet-change', '--prompt', 'flow-kit/prompts/0-change.md', '--templates', 'CHANGE.md,REQUIREMENT.md'], dir), 0);
264
266
  assertExit(runState(['skill-load', 'archive', 'flow-comet-integration', '--prompt', 'flow-kit/prompts/7-integration.md'], dir), 0);
265
267
  // 推进到 archive
266
268
  const st0 = readStateFile(dir);
@@ -209,8 +209,8 @@ const RAW_ENTRIES = [
209
209
  run: (dir) => {
210
210
  gitInit(dir);
211
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);
212
+ assertExit(runState(['skill-load', 'open', 'flow-comet-change', '--prompt', 'flow-kit/prompts/0-change.md', '--templates', 'CHANGE.md,REQUIREMENT.md'], dir), 0);
213
+ assertExit(runState(['skill-load', 'design', 'flow-comet-design', '--prompt', 'flow-kit/prompts/2-design.md', '--templates', 'DESIGN.md'], dir), 0);
214
214
  writeIntakeArtifacts(dir);
215
215
  // ① entry open 记录进入标记
216
216
  assertExit(runGuard(['entry', 'open'], dir), 0);
@@ -354,15 +354,20 @@ export const ENTRIES = [
354
354
  name: 'M4 ui-design 门真实链路:entry design → 缺件 BLOCK → 补件·声明 → exit --apply 放行',
355
355
  run: (dir) => {
356
356
  assertExit(runState(['init', CHANGE_ID], dir), 0);
357
- assertExit(runState(['skill-load', 'open', 'flow-comet-change', '--prompt', 'flow-kit/prompts/0-change.md'], dir), 0);
358
- writeIntakeArtifacts(dir);
359
- fs.appendFileSync(path.join(dir, '.specs', CHANGE_ID, 'CHANGE.md'),
360
- '\n## 视觉调性(Visual Tone)\n\n现代、克制的工具型界面。\n');
357
+ // 夹具根的模板:适用性判据的「视觉调性」段名从 CHANGE 模板派生——模板缺席时门按 C9 显式
358
+ // 「未校验(模板缺失)」跳过(降级路径由 TA-21 覆盖),本项要测的是门本身,故模板必须在场。
359
+ // 段形只登记本项工件实际写出的段:模板是段形权威,多写一段就会让出口先被结构门拦下,
360
+ // 测不到 ui-design 门(CHANGE 见 writeIntakeArtifacts,DESIGN 见下方夹具)。
361
+ writeFile(dir, 'flow-kit/templates/CHANGE.md', '# CHANGE 模板(夹具)\n\n## Why(为什么做)\n\n## 视觉调性(前端项目必填)\n');
362
+ writeFile(dir, 'flow-kit/templates/DESIGN.md', '# DESIGN 模板(夹具)\n\n## 0. 技术栈选定\n\n## 1. 决策清单\n');
363
+ assertExit(runState(['skill-load', 'open', 'flow-comet-change', '--prompt', 'flow-kit/prompts/0-change.md', '--templates', 'CHANGE.md,REQUIREMENT.md'], dir), 0);
364
+ // 前端判据要的是「视觉调性段在场且未标不适用」:intake 夹具直接写实质调性(不追加同名段)。
365
+ writeIntakeArtifacts(dir, CHANGE_ID, { visualTone: '现代、克制的工具型界面。' });
361
366
  assertExit(runState(['record', 'open', '{"summary":"intake complete"}'], dir), 0);
362
367
  assertExit(runGuard(['entry', 'open'], dir), 0);
363
368
  assertExit(runGuard(['exit', 'open', '--apply'], dir), 0);
364
369
 
365
- assertExit(runState(['skill-load', 'design', 'flow-comet-design', '--prompt', 'flow-kit/prompts/2-design.md'], dir), 0);
370
+ assertExit(runState(['skill-load', 'design', 'flow-comet-design', '--prompt', 'flow-kit/prompts/2-design.md', '--templates', 'DESIGN.md'], dir), 0);
366
371
  writeFile(dir, '.specs/' + CHANGE_ID + '/DESIGN.md',
367
372
  '# DESIGN\n\n- **Change ID**: ' + CHANGE_ID + '\n\n## 0. 技术栈选定\n\nNode.js(ESM)\n\n## 决策清单\n\n- [ ] 循环路由\n');
368
373
  assertExit(runState(['record', 'design', '{"summary":"design done"}'], dir), 0);
@@ -375,13 +380,14 @@ export const ENTRIES = [
375
380
  assertOut(blocked, '恢复: 补 .specs/' + CHANGE_ID + '/UI-DESIGN.md');
376
381
 
377
382
  // 恢复:补工件 + 真实 skill-load 声明(出口不再自动补写该绑定)→ 出口放行并落状态
383
+ // 工件形态按模板:标题 = `# UI Design: <项目名>`(登记表 titleForm),不是「# UI-DESIGN」。
378
384
  writeFile(dir, '.specs/' + CHANGE_ID + '/UI-DESIGN.md',
379
- '# UI-DESIGN\n\n## 1. 设计 token\n\n- 主色 `oklch(0.6 0.1 250)`\n');
385
+ '# UI Design: 夹具项目\n\n## 1. 设计 token\n\n- 主色 `oklch(0.6 0.1 250)`\n');
380
386
  const undeclared = runGuard(['exit', 'design'], dir);
381
387
  assertExit(undeclared, 1);
382
388
  assertOut(undeclared, 'required-skill:design.flow-comet-ui-design');
383
389
  assertOut(undeclared, '不再由出口自动补写');
384
- assertExit(runState(['skill-load', 'design', 'flow-comet-ui-design', '--prompt', 'flow-kit/prompts/2a-ui-design.md'], dir), 0);
390
+ assertExit(runState(['skill-load', 'design', 'flow-comet-ui-design', '--prompt', 'flow-kit/prompts/2a-ui-design.md', '--templates', 'DESIGN.md'], dir), 0);
385
391
  assertExit(runState(['record', 'design',
386
392
  '{"summary":"design done with ui-design","completedChecks":["required-skill:design.flow-comet-design","required-skill:design.flow-comet-ui-design"]}'], dir), 0);
387
393
  const passed = runGuard(['exit', 'design', '--apply'], dir);
@@ -393,16 +399,14 @@ export const ENTRIES = [
393
399
  // ① fail-open 反向控制:段内自然句子「不适用于暗色主题…」不是结构形态 → 仍判前端、缺件 BLOCKED;
394
400
  // ② 结构形态(`适用性` 标签的字段值位)→ 可见跳过 + 命中片段回显,且不要求工件与该声明。
395
401
  const nfChange = CHANGE_ID + '-nf';
396
- const nfChangeFile = path.join(dir, '.specs', nfChange, 'CHANGE.md');
397
402
  assertExit(runState(['init', nfChange, '--init-skip'], dir), 0);
398
- assertExit(runState(['skill-load', 'open', 'flow-comet-change', '--prompt', 'flow-kit/prompts/0-change.md'], dir), 0);
399
- writeIntakeArtifacts(dir, nfChange);
400
- fs.appendFileSync(nfChangeFile,
401
- '\n## 视觉调性(Visual Tone)\n\n不适用于暗色主题,本 change 仅覆盖浅色分支。\n');
403
+ assertExit(runState(['skill-load', 'open', 'flow-comet-change', '--prompt', 'flow-kit/prompts/0-change.md', '--templates', 'CHANGE.md,REQUIREMENT.md'], dir), 0);
404
+ // 段内自然句子(非结构形态)→ 前端判据不认,仍判前端;写在同一段里,不追加同名段。
405
+ writeIntakeArtifacts(dir, nfChange, { visualTone: '不适用于暗色主题,本 change 仅覆盖浅色分支。' });
402
406
  assertExit(runState(['record', 'open', '{"summary":"intake complete"}'], dir), 0);
403
407
  assertExit(runGuard(['entry', 'open'], dir), 0);
404
408
  assertExit(runGuard(['exit', 'open', '--apply'], dir), 0);
405
- assertExit(runState(['skill-load', 'design', 'flow-comet-design', '--prompt', 'flow-kit/prompts/2-design.md'], dir), 0);
409
+ assertExit(runState(['skill-load', 'design', 'flow-comet-design', '--prompt', 'flow-kit/prompts/2-design.md', '--templates', 'DESIGN.md'], dir), 0);
406
410
  writeFile(dir, '.specs/' + nfChange + '/DESIGN.md',
407
411
  '# DESIGN\n\n- **Change ID**: ' + nfChange + '\n\n## 0. 技术栈选定\n\nNode.js(ESM)\n\n## 决策清单\n\n- [ ] 循环路由\n');
408
412
  assertExit(runState(['record', 'design', '{"summary":"design done"}'], dir), 0);
@@ -0,0 +1,154 @@
1
+ // items/n.mjs — 条目分区:N 组条目(加载链声明集合比对 / 安装器降级口径的 L2 真实命令)
2
+ //
3
+ // 数据层约定:同 items/a.mjs 头注(只承载 ENTRIES;夹具从 lib/system-fixtures.mjs 取;组文件之间零 import)。
4
+ //
5
+ // 组界:本组承接「模板权威」批次的加载链与降级面——它们此前只有 L1 场景或只有获取点断言:
6
+ // · 加载链的**声明集合比对**(多写 / 漏写 / 错名 / 允许集内的可选项)走真实 skill-load / record 命令;
7
+ // · 安装器在「同名目录已存在 / 上游克隆已就位」两种真实目录形态下的**降级结论**(含不出现通知的反向)。
8
+
9
+ import fs from 'fs';
10
+ import path from 'path';
11
+ import { spawnSync } from 'child_process';
12
+ import { assertExit, assertNotOut, assertOut, assertTrue, runState, writeState } from '../lib/test-helpers.mjs';
13
+ import { CHANGE_ID, SCRIPTS_DIR, applyDistributionSurface, readStateFile } from '../lib/system-fixtures.mjs';
14
+
15
+ const DESIGN_SKILL_ARGS = ['skill-load', 'design', 'flow-comet-design', '--prompt', 'flow-kit/prompts/2-design.md'];
16
+
17
+ const RAW_ENTRIES = [
18
+ // ---------- N. 加载链:模板声明集合比对 ----------
19
+
20
+ // 声明集合判据 = required ⊆ declared ⊆ required ∪ optional(design 的 required=DESIGN、optional=UI-DESIGN)。
21
+ // 四个负例分别打「多写(允许集外)」「漏写(空清单)」「错名(拼错)」「缺声明(整项没写)」,
22
+ // 旧 change 同形只 WARN——新 change 的 fail-closed 与旧 change 的渐进放行必须在同一条命令上分开。
23
+ {
24
+ name: 'N1 加载链声明集合:多写/漏写/错名/缺声明对 BLOCKED,允许集内可选项放行,旧 change 同形 WARN',
25
+ run: (dir) => {
26
+ assertExit(runState(['init', CHANGE_ID, '--init-skip'], dir), 0);
27
+
28
+ // ① 允许集内正例:DESIGN(required)+ UI-DESIGN(optional)→ 通过并落标记
29
+ const optionalDeclared = runState([...DESIGN_SKILL_ARGS, '--templates', 'DESIGN.md,UI-DESIGN.md'], dir);
30
+ assertExit(optionalDeclared, 0);
31
+ assertOut(optionalDeclared, 'SKILL-LOAD: design flow-comet-design');
32
+ const markerPath = path.join(dir, '.specs', CHANGE_ID, '.skill-loads', 'design-flow-comet-design.json');
33
+ const marker = JSON.parse(fs.readFileSync(markerPath, 'utf8'));
34
+ if (!Array.isArray(marker.templates) || marker.templates.join(',') !== 'DESIGN,UI-DESIGN') {
35
+ throw new Error('声明标记应如实记录声明的模板清单(去掉 .md 后缀),实际: ' + JSON.stringify(marker.templates));
36
+ }
37
+
38
+ // ② 多写:允许集外的模板(TASK)→ BLOCKED,并回显「怎么重新声明」的可执行命令(模板与提示词
39
+ // 同一次声明:命令必须带 --prompt,否则照抄重跑会把同一标记的 protocol 覆写成 null)
40
+ const extra = runState([...DESIGN_SKILL_ARGS, '--templates', 'DESIGN.md,TASK.md'], dir);
41
+ assertExit(extra, 1);
42
+ assertOut(extra, 'BLOCKED');
43
+ assertOut(extra, '多写/错名: TASK');
44
+ assertOut(extra, '映射要求: DESIGN');
45
+ assertOut(extra, 'workflow-state.mjs skill-load design flow-comet-design --templates DESIGN.md --prompt flow-kit/prompts/2-design.md');
46
+ assertNotOut(extra, '--prompt <');
47
+ const declareLine = extra.output.split(/\r?\n/).find((line) => line.includes('workflow-state.mjs skill-load design')) ?? '';
48
+ assertTrue(declareLine !== '', 'BLOCKED 报文应给出可照抄的重新声明命令');
49
+ // 照抄报文里的命令重跑(只取命令词元:报文尾部是中文说明,不是参数)——标记的 protocol 必须
50
+ // 仍在,否则下一次 exit 会被「缺协议声明标记」拦下(恢复步骤自己弄坏协议声明)。
51
+ const printedArgs = declareLine.slice(declareLine.indexOf('workflow-state.mjs')).split(/\s+/u)
52
+ .filter((token) => token !== '' && !/[\u4e00-\u9fff]/u.test(token))
53
+ .slice(1);
54
+ const redeclared = runState(printedArgs, dir);
55
+ assertExit(redeclared, 0);
56
+ const redeclaredMarker = JSON.parse(fs.readFileSync(markerPath, 'utf8'));
57
+ assertTrue(redeclaredMarker.protocol === '2-design.md',
58
+ '照抄重新声明命令后 protocol 不应变成 null,实际: ' + JSON.stringify(redeclaredMarker.protocol));
59
+
60
+ // ③ 漏写:显式空清单(--templates=)→ BLOCKED 且点名漏掉的必填项
61
+ const missing = runState([...DESIGN_SKILL_ARGS, '--templates='], dir);
62
+ assertExit(missing, 1);
63
+ assertOut(missing, 'BLOCKED');
64
+ assertOut(missing, '漏写: DESIGN');
65
+
66
+ // ④ 错名:拼错(DESIGNS)→ 同时报漏写与错名(错名不是「多写」的另一种说法,两条都要出声)
67
+ const typo = runState([...DESIGN_SKILL_ARGS, '--templates', 'DESIGNS.md'], dir);
68
+ assertExit(typo, 1);
69
+ assertOut(typo, '漏写: DESIGN');
70
+ assertOut(typo, '多写/错名: DESIGNS');
71
+
72
+ // ⑤ 缺声明:整项不写 --templates → 新 change 同样 BLOCKED(「没写」不等于「零模板」)
73
+ const undeclared = runState(DESIGN_SKILL_ARGS, dir);
74
+ assertExit(undeclared, 1);
75
+ assertOut(undeclared, '模板声明缺失');
76
+
77
+ // ⑥ 旧 change 同形:同一条「多写」声明只 WARN 且照常落标记(渐进兼容——旧项目不可能一夜补齐)
78
+ const legacyState = readStateFile(dir);
79
+ delete legacyState.newChange;
80
+ writeState(dir, legacyState);
81
+ const legacy = runState([...DESIGN_SKILL_ARGS, '--templates', 'DESIGN.md,TASK.md'], dir);
82
+ assertExit(legacy, 0);
83
+ assertOut(legacy, 'WARN');
84
+ assertNotOut(legacy, 'BLOCKED');
85
+ const legacyMarker = JSON.parse(fs.readFileSync(markerPath, 'utf8'));
86
+ if (legacyMarker.at === undefined || legacyMarker.templates.join(',') !== 'DESIGN,TASK') {
87
+ throw new Error('旧 change 的 WARN 路径应照常写标记(记录真实声明),实际: ' + JSON.stringify(legacyMarker));
88
+ }
89
+ },
90
+ },
91
+
92
+ // ---------- N. 安装器:flow-kit 降级结论 ----------
93
+
94
+ // 降级口径 = 「未校验(模板缺失)」:获取点给命令、进程结尾给结论(影响 / 原因 / 修复)。
95
+ // 两条真实目录形态都必须跑:同名非克隆目录(跳过,不改动)与上游克隆已就位(不挂通知)——
96
+ // 只断言前者会让「无条件打印通知」的实现照样通过。
97
+ {
98
+ name: 'N2 安装器降级口径:同名目录在已跳过时结尾给影响/原因/修复,上游克隆就位时不出现通知',
99
+ surface: '安装器源码(scripts/prepare-env.mjs)与 flow-kit 获取链路仅权威源侧在场',
100
+ run: (dir) => {
101
+ const repoRoot = path.resolve(SCRIPTS_DIR, '..', '..', '..', '..');
102
+ const installer = path.join(repoRoot, 'scripts', 'prepare-env.mjs');
103
+ if (!fs.existsSync(installer)) throw new Error('缺少 prepare-env.mjs');
104
+ const runInstall = (target) => {
105
+ const res = spawnSync(process.execPath, [installer, '--target', target, '--platform', 'claude-code'], {
106
+ cwd: repoRoot, encoding: 'utf8', timeout: 180000,
107
+ });
108
+ return { status: res.status, output: String(res.stdout ?? '') + String(res.stderr ?? '') };
109
+ };
110
+
111
+ // ① 降级态:目标目录预置同名 flow-kit 目录(非上游克隆)→ 跳过 + 手动指引 + 结尾三行结论
112
+ const degradedTarget = path.join(dir, 'n2-degraded');
113
+ fs.mkdirSync(path.join(degradedTarget, 'flow-kit'), { recursive: true });
114
+ const degraded = runInstall(degradedTarget);
115
+ assertExit(degraded, 0); // 降级不改变退出码:安装器其余职责照常完成
116
+ assertOut(degraded, '目录存在但非上游克隆,已跳过');
117
+ assertOut(degraded, '未校验(模板缺失)');
118
+ assertOut(degraded, '影响: 各节点出口输出');
119
+ assertOut(degraded, '原因: flow-kit/templates 未就位');
120
+ // 修复行不许把「重跑」当成对已存在目录的修复——目录在但归属无法确认时,重跑会落回同一条
121
+ // 跳过分支;须先移走/处理该目录或按手动步骤补齐,再重跑。
122
+ assertOut(degraded, '修复: 先移走或处理现有 flow-kit/ 目录');
123
+ assertOut(degraded, '按上方手动获取指引补齐,再重跑本安装器');
124
+ assertNotOut(degraded, '修复: 网络可用时重跑本安装器');
125
+ assertOut(degraded, '手动获取指引: git clone');
126
+ // 非破坏:预置目录原样保留(安装器绝不改动已有目录)
127
+ if (!fs.existsSync(path.join(degradedTarget, 'flow-kit'))) {
128
+ throw new Error('安装器不应删除已存在的 flow-kit 目录');
129
+ }
130
+
131
+ // ② 反向:上游克隆就位(origin 指向上游)→ 走「只读比对」分支,不挂降级通知
132
+ const upstreamTarget = path.join(dir, 'n2-upstream');
133
+ const cloneDir = path.join(upstreamTarget, 'flow-kit');
134
+ fs.mkdirSync(cloneDir, { recursive: true });
135
+ const git = (args) => spawnSync('git', ['-C', cloneDir, ...args], { encoding: 'utf8', timeout: 60000 });
136
+ if (spawnSync('git', ['init', '-q', cloneDir], { encoding: 'utf8' }).status !== 0) {
137
+ throw new Error('夹具构造失败:git init 未成功');
138
+ }
139
+ if (git(['remote', 'add', 'origin', 'https://github.com/rihebty/flow-kit.git']).status !== 0) {
140
+ throw new Error('夹具构造失败:git remote add 未成功');
141
+ }
142
+ if (git(['-c', 'user.name=t', '-c', 'user.email=t@t', 'commit', '-q', '--allow-empty', '-m', 'snapshot']).status !== 0) {
143
+ throw new Error('夹具构造失败:git commit 未成功');
144
+ }
145
+ const clean = runInstall(upstreamTarget);
146
+ assertExit(clean, 0);
147
+ assertOut(clean, '已有 flow-kit(HEAD=');
148
+ assertNotOut(clean, '未校验(模板缺失)');
149
+ assertNotOut(clean, '非上游克隆');
150
+ },
151
+ },
152
+ ];
153
+
154
+ export const ENTRIES = RAW_ENTRIES.map(applyDistributionSurface);