flow-comet 1.7.0 → 1.8.0

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/SKILL.md +16 -14
  3. package/.flow-comet/skills/flow-comet/reference/commit-discipline.md +1 -1
  4. package/.flow-comet/skills/flow-comet/reference/decision-points.md +5 -5
  5. package/.flow-comet/skills/flow-comet/reference/dirty-worktree.md +1 -1
  6. package/.flow-comet/skills/flow-comet/reference/entry-detail.md +9 -9
  7. package/.flow-comet/skills/flow-comet/reference/fix-loop.md +4 -4
  8. package/.flow-comet/skills/flow-comet/reference/init-detection.md +1 -1
  9. package/.flow-comet/skills/flow-comet/reference/platform-facts.md +2 -2
  10. package/.flow-comet/skills/flow-comet/reference/post-archive-handoff.md +264 -0
  11. package/.flow-comet/skills/flow-comet/reference/recovery.md +1 -1
  12. package/.flow-comet/skills/flow-comet/reference/replan.md +1 -1
  13. package/.flow-comet/skills/flow-comet/scripts/comet-check.mjs +1 -0
  14. package/.flow-comet/skills/flow-comet/scripts/comet-hook-guard.mjs +270 -30
  15. package/.flow-comet/skills/flow-comet/scripts/items/a.mjs +25 -8
  16. package/.flow-comet/skills/flow-comet/scripts/items/b.mjs +41 -38
  17. package/.flow-comet/skills/flow-comet/scripts/items/c.mjs +11 -9
  18. package/.flow-comet/skills/flow-comet/scripts/items/e.mjs +2 -2
  19. package/.flow-comet/skills/flow-comet/scripts/items/f.mjs +1 -1
  20. package/.flow-comet/skills/flow-comet/scripts/items/h.mjs +112 -53
  21. package/.flow-comet/skills/flow-comet/scripts/items/k.mjs +357 -3
  22. package/.flow-comet/skills/flow-comet/scripts/items/l.mjs +24 -1
  23. package/.flow-comet/skills/flow-comet/scripts/items/m.mjs +2 -2
  24. package/.flow-comet/skills/flow-comet/scripts/items/n.mjs +9 -10
  25. package/.flow-comet/skills/flow-comet/scripts/lib/ac-coverage.mjs +8 -8
  26. package/.flow-comet/skills/flow-comet/scripts/lib/fix-loop-node.mjs +4 -15
  27. package/.flow-comet/skills/flow-comet/scripts/lib/guard-evidence-gates.mjs +79 -107
  28. package/.flow-comet/skills/flow-comet/scripts/lib/guard-gates.mjs +183 -232
  29. package/.flow-comet/skills/flow-comet/scripts/lib/guard-routing.mjs +91 -14
  30. package/.flow-comet/skills/flow-comet/scripts/lib/guard-template-fidelity.mjs +20 -32
  31. package/.flow-comet/skills/flow-comet/scripts/lib/guard-uidesign.mjs +10 -19
  32. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-admin.mjs +27 -17
  33. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-flow.mjs +240 -87
  34. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-recovery.mjs +15 -22
  35. package/.flow-comet/skills/flow-comet/scripts/lib/state-determine.mjs +11 -4
  36. package/.flow-comet/skills/flow-comet/scripts/lib/state-io.mjs +192 -24
  37. package/.flow-comet/skills/flow-comet/scripts/lib/state-skillmarkers.mjs +55 -44
  38. package/.flow-comet/skills/flow-comet/scripts/lib/system-fixtures.mjs +2 -4
  39. package/.flow-comet/skills/flow-comet/scripts/lib/test-assertions.mjs +0 -3
  40. package/.flow-comet/skills/flow-comet/scripts/lib/test-fixtures.mjs +191 -17
  41. package/.flow-comet/skills/flow-comet/scripts/lib/test-helpers.mjs +3 -0
  42. package/.flow-comet/skills/flow-comet/scripts/lib/text-anchor-checks.mjs +23 -5
  43. package/.flow-comet/skills/flow-comet/scripts/lib/wave-projection.mjs +10 -11
  44. package/.flow-comet/skills/flow-comet/scripts/protocol-utils.mjs +40 -3
  45. package/.flow-comet/skills/flow-comet/scripts/route-node.mjs +12 -5
  46. package/.flow-comet/skills/flow-comet/scripts/scenarios/a.mjs +193 -111
  47. package/.flow-comet/skills/flow-comet/scripts/scenarios/b.mjs +314 -57
  48. package/.flow-comet/skills/flow-comet/scripts/scenarios/c.mjs +311 -216
  49. package/.flow-comet/skills/flow-comet/scripts/scenarios/d.mjs +33 -62
  50. package/.flow-comet/skills/flow-comet/scripts/scenarios/e.mjs +188 -91
  51. package/.flow-comet/skills/flow-comet/scripts/scenarios/f.mjs +94 -37
  52. package/.flow-comet/skills/flow-comet/scripts/scenarios/g.mjs +36 -27
  53. package/.flow-comet/skills/flow-comet/scripts/scenarios/h.mjs +285 -9
  54. package/.flow-comet/skills/flow-comet/scripts/scenarios/i.mjs +2 -6
  55. package/.flow-comet/skills/flow-comet/scripts/scenarios/j.mjs +5 -15
  56. package/.flow-comet/skills/flow-comet/scripts/scenarios/k.mjs +6 -5
  57. package/.flow-comet/skills/flow-comet/scripts/scenarios/l.mjs +40 -36
  58. package/.flow-comet/skills/flow-comet/scripts/scenarios/m.mjs +2 -2
  59. package/.flow-comet/skills/flow-comet/scripts/scenarios/n.mjs +346 -25
  60. package/.flow-comet/skills/flow-comet/scripts/state-schema.mjs +0 -2
  61. package/.flow-comet/skills/flow-comet/scripts/workflow-handoff.mjs +41 -54
  62. package/.flow-comet/skills/flow-comet-archive/SKILL.md +33 -11
  63. package/.flow-comet/skills/flow-comet-change/SKILL.md +1 -1
  64. package/.flow-comet/skills/flow-comet-design/SKILL.md +5 -3
  65. package/.flow-comet/skills/flow-comet-dev/SKILL.md +2 -2
  66. package/.flow-comet/skills/flow-comet-execute/SKILL.md +11 -11
  67. package/.flow-comet/skills/flow-comet-integration/SKILL.md +10 -4
  68. package/.flow-comet/skills/flow-comet-plan/GUIDANCE.md +1 -1
  69. package/.flow-comet/skills/flow-comet-plan/SKILL.md +8 -8
  70. package/.flow-comet/skills/flow-comet-review/SKILL.md +8 -8
  71. package/.flow-comet/skills/flow-comet-subagent-execute/GUIDANCE.md +1 -1
  72. package/.flow-comet/skills/flow-comet-subagent-execute/SKILL.md +14 -14
  73. package/.flow-comet/skills/flow-comet-task/SKILL.md +3 -2
  74. package/.flow-comet/skills/flow-comet-ui-design/SKILL.md +2 -2
  75. package/.flow-comet/skills/flow-comet-verify/SKILL.md +1 -1
  76. package/README.md +2 -2
  77. package/package.json +1 -1
  78. package/scripts/dsh-bridge.mjs +238 -21
@@ -17,24 +17,26 @@ import {
17
17
  } from '../lib/test-helpers.mjs';
18
18
  import {
19
19
  CHANGE_ID,
20
+ engineDefinitionHits,
21
+ engineDefinitionModule,
22
+ engineScriptTexts,
23
+ handoffFor,
20
24
  HOOK,
25
+ renderMultiWaveTasks,
21
26
  REPO_ROOT,
27
+ runPlanExit,
22
28
  SCRIPTS_DIR,
29
+ skillTreeDocFiles,
30
+ strictSummary,
31
+ summaryContent,
23
32
  TASK_P1,
24
33
  TASK_P2,
25
34
  TASK_P2_PENDING,
26
35
  TASK_VALID_ALL_SERIAL,
27
36
  TASK_VALID_PS,
28
37
  TASK_VALID_SP,
29
- engineDefinitionHits,
30
- engineDefinitionModule,
31
- engineScriptTexts,
32
- handoffFor,
33
- renderMultiWaveTasks,
34
- runPlanExit,
35
- skillTreeDocFiles,
36
- summaryContent,
37
38
  writeIntakeArtifacts,
39
+ writeNodeDeclarationMarkers,
38
40
  } from '../lib/test-fixtures.mjs';
39
41
  import {
40
42
  runStateWithProtocol,
@@ -175,7 +177,7 @@ export const ENTRIES = [
175
177
  // 清空:全部 done + SUMMARY 在场 → 委托与串行均无残留 → review(产物门控照旧)。
176
178
  // 状态取真实链路形态:completedNodes 按路由序排列(末元素 = subagent-execute,
177
179
  // 其 exit --apply 已把 currentNode 推到 review——正常推进豁免放行 next)
178
- writeFile(dir, '.specs/' + CHANGE_ID + '/T01-SUMMARY.md', summaryContent());
180
+ writeFile(dir, '.specs/' + CHANGE_ID + '/T01-SUMMARY.md', strictSummary('T01'));
179
181
  res = goNext('review', ['T01', 'P01', 'P02', 'T02', 'P03', 'P04'], ['execute', 'subagent-execute']);
180
182
  assertExit(res, 0);
181
183
  assertOut(res, 'NODE: review');
@@ -246,8 +248,8 @@ export const ENTRIES = [
246
248
  assertOut(res, 'NODE: execute');
247
249
  // ③ 全部 done + SUMMARY 在场 → 合取完成(无 eligible ∧ 无 serial pending)→ review
248
250
  writeFile(dir, '.specs/' + CHANGE_ID + '/TASK.md', '# TASK\n\n' + TASK_P1 + pDone('P02', 'P01') + t03('done'));
249
- writeFile(dir, '.specs/' + CHANGE_ID + '/P01-SUMMARY.md', summaryContent());
250
- writeFile(dir, '.specs/' + CHANGE_ID + '/T03-SUMMARY.md', summaryContent());
251
+ writeFile(dir, '.specs/' + CHANGE_ID + '/P01-SUMMARY.md', strictSummary('T01'));
252
+ writeFile(dir, '.specs/' + CHANGE_ID + '/T03-SUMMARY.md', strictSummary('T01'));
251
253
  res = runStateWithProtocol(dir, ['next']);
252
254
  assertExit(res, 0);
253
255
  assertOut(res, 'NODE: review');
@@ -377,12 +379,12 @@ export const ENTRIES = [
377
379
  evidence: {}, verifyFailures: 0, executionMode: 'subagent', directOverride: false,
378
380
  });
379
381
  fs.mkdirSync(path.join(dir, 'deep'), { recursive: true });
380
- const spawnDrift = (input, extraEnv) => {
382
+ const spawnDrift = (input, extraEnv, hookArgs = ['before_tool']) => {
381
383
  // 封闭性:剥离宿主可能注入的锚定变量,确保用例只测显式给定的锚定形态
382
384
  const inherited = { ...process.env };
383
385
  delete inherited.FLOW_COMET_RUN_ROOT;
384
386
  delete inherited.CLAUDE_PROJECT_DIR;
385
- const res = spawnSync(process.execPath, [HOOK, 'before_tool'], {
387
+ const res = spawnSync(process.execPath, [HOOK, ...hookArgs], {
386
388
  cwd: path.join(dir, 'deep'),
387
389
  input: JSON.stringify(input),
388
390
  env: {
@@ -425,6 +427,26 @@ export const ENTRIES = [
425
427
  r = spawnDrift({ tool_name: 'Write', tool_input: { file_path: inspec } }, { CLAUDE_PROJECT_DIR: path.join(dir, 'gone') });
426
428
  assertExit(r, 0);
427
429
  assertOut(r, 'workflow-hook-guard-ok');
430
+ // ⑥ 协议不可读(缺失 / 损坏)→ 明确阻塞,不再 exit 1 静默放行。
431
+ // 实测:删除协议文件后每次调用 exit 1,宿主把它降级为非阻断错误 ⇒ 整条写入防线关闭;
432
+ // 拒绝通道按平台收口(CC = exit 2 + 恢复指引 / Codex = decision:"block" + exit 0),
433
+ // 否则 Codex 上同一故障仍是 fail-open。反向构造:把兜底退回 exit 1 ⇒ ⑥a/⑥b 必红。
434
+ const missingProtocol = path.join(dir, 'reference', 'missing-protocol.json');
435
+ const protocolProbe = { tool_name: 'Write', tool_input: { file_path: path.join(dir, 'src', 'x.ts') } };
436
+ let r6 = spawnDrift(protocolProbe, { FLOW_COMET_PROTOCOL: missingProtocol });
437
+ assertExit(r6, 2);
438
+ assertOut(r6, 'BLOCKED');
439
+ assertOut(r6, '无法完成判定');
440
+ assertOut(r6, '恢复:');
441
+ const corruptProtocol = path.join(dir, 'reference', 'corrupt-protocol.json');
442
+ fs.writeFileSync(corruptProtocol, '{ not-json ', 'utf8');
443
+ r6 = spawnDrift(protocolProbe, { FLOW_COMET_PROTOCOL: corruptProtocol });
444
+ assertExit(r6, 2);
445
+ assertOut(r6, 'BLOCKED');
446
+ const codexMissing = spawnDrift(protocolProbe, { FLOW_COMET_PROTOCOL: missingProtocol }, ['before_tool', '--platform', 'codex']);
447
+ assertExit(codexMissing, 0);
448
+ assertOut(codexMissing, '"decision":"block"');
449
+ assertOut(codexMissing, '无法完成判定');
428
450
  },
429
451
  },
430
452
 
@@ -448,8 +470,9 @@ export const ENTRIES = [
448
470
  '<task id="T03" parallel="true" status="pending"><action>实现 T03</action><write_files>src/t3.mjs</write_files><verify>node --check src/t3.mjs</verify><depends_on>T01</depends_on></task>\n' +
449
471
  '<task id="T04" parallel="false" status="pending"><action>实现 T04</action><write_files>src/t4.mjs</write_files><verify>node --check src/t4.mjs</verify><depends_on>T02,T03</depends_on></task>\n' +
450
472
  '<task id="T05" parallel="false"><action>遗留无状态串行</action><write_files>src/t5.mjs</write_files><verify>node --check src/t5.mjs</verify></task>\n');
473
+ writeNodeDeclarationMarkers(dir, 'execute');
451
474
  assertExit(runGuard(['entry', 'execute'], dir), 0);
452
- writeFile(dir, '.specs/' + CHANGE_ID + '/T01-SUMMARY.md', summaryContent());
475
+ writeFile(dir, '.specs/' + CHANGE_ID + '/T01-SUMMARY.md', strictSummary('T01'));
453
476
  const st2 = JSON.parse(fs.readFileSync(path.join(dir, '.flow-comet', 'flow-comet-state.json'), 'utf8'));
454
477
  st2.evidence['subagent-execute'] = { handoffResult: handoffFor(['T01']) };
455
478
  writeState(dir, st2);
@@ -475,7 +498,7 @@ export const ENTRIES = [
475
498
  '<task id="T03" parallel="true" status="pending"><action>实现 T03</action><write_files>src/t3.mjs</write_files><verify>node --check src/t3.mjs</verify><depends_on>T01</depends_on></task>\n' +
476
499
  '<task id="T04" parallel="false" status="pending"><action>实现 T04</action><write_files>src/t4.mjs</write_files><verify>node --check src/t4.mjs</verify></task>\n');
477
500
  assertExit(runGuard(['entry', 'execute'], dir), 0);
478
- writeFile(dir, '.specs/' + CHANGE_ID + '/T01-SUMMARY.md', summaryContent());
501
+ writeFile(dir, '.specs/' + CHANGE_ID + '/T01-SUMMARY.md', strictSummary('T01'));
479
502
  const st2 = JSON.parse(fs.readFileSync(path.join(dir, '.flow-comet', 'flow-comet-state.json'), 'utf8'));
480
503
  st2.evidence['subagent-execute'] = { handoffResult: handoffFor(['T01']) };
481
504
  writeState(dir, st2);
@@ -505,7 +528,6 @@ export const ENTRIES = [
505
528
  writeFile(dir, '.specs/' + CHANGE_ID + '/TASK.md', '# TASK\n\n' +
506
529
  '<task id="T01"><action>实现 T01</action><write_files>src/todo_x.py; tests/test_todo_x.py</write_files><verify>node --check src/todo_x.py</verify></task>\n');
507
530
  const st = baseState('subagent-execute');
508
- st.newChange = true;
509
531
  writeState(dir, st);
510
532
  // 技能加载前置门材料:新 change 下 request 须有本节点声明标记
511
533
  fs.mkdirSync(path.join(dir, '.specs', CHANGE_ID, '.skill-loads'), { recursive: true });
@@ -567,8 +589,10 @@ export const ENTRIES = [
567
589
  {
568
590
  name: '182 execute 出口静默:全部任务 done 后无 ROUTE WARN',
569
591
  run: (dir) => {
592
+ writeNodeDeclarationMarkers(dir, 'execute');
570
593
  const st = baseState('execute');
571
594
  st.evidence.execute = { summary: 'executed' };
595
+ st.completedNodes = ['open', 'design', 'plan', 'execute', 'subagent-execute'];
572
596
  writeState(dir, st);
573
597
  // 未分类并行任务(缺 status)自初始 TASK 在场——全部可解析任务 done 后,
574
598
  // 该任务按「缺 status 不视为 pending」文档语义保持静默(与既有「无可解析 pending 静默」
@@ -576,8 +600,8 @@ export const ENTRIES = [
576
600
  writeFile(dir, '.specs/' + CHANGE_ID + '/TASK.md', '# TASK\n\n' + TASK_P1 + TASK_P2 +
577
601
  '<task id="P03" parallel="true"><action>实现 P03</action><write_files>src/p3.mjs</write_files><verify>node --check src/p3.mjs</verify></task>\n');
578
602
  assertExit(runGuard(['entry', 'execute'], dir), 0);
579
- writeFile(dir, '.specs/' + CHANGE_ID + '/P01-SUMMARY.md', summaryContent());
580
- writeFile(dir, '.specs/' + CHANGE_ID + '/P02-SUMMARY.md', summaryContent());
603
+ writeFile(dir, '.specs/' + CHANGE_ID + '/P01-SUMMARY.md', strictSummary('T01'));
604
+ writeFile(dir, '.specs/' + CHANGE_ID + '/P02-SUMMARY.md', strictSummary('T01'));
581
605
  const st2 = JSON.parse(fs.readFileSync(path.join(dir, '.flow-comet', 'flow-comet-state.json'), 'utf8'));
582
606
  st2.evidence['subagent-execute'] = { handoffResult: handoffFor(['P01', 'P02']) };
583
607
  writeState(dir, st2);
@@ -600,7 +624,7 @@ export const ENTRIES = [
600
624
  writeFile(dir, '.specs/' + CHANGE_ID + '/TASK.md', '# TASK\n\n' + TASK_P1 +
601
625
  '<task id="T02" parallel="false" status="pending"><action>实现 T02</action><write_files>src/t2.mjs</write_files><verify>node --check src/t2.mjs</verify><depends_on>P01</depends_on></task>\n');
602
626
  assertExit(runGuard(['entry', 'execute'], dir), 0);
603
- writeFile(dir, '.specs/' + CHANGE_ID + '/P01-SUMMARY.md', summaryContent());
627
+ writeFile(dir, '.specs/' + CHANGE_ID + '/P01-SUMMARY.md', strictSummary('T01'));
604
628
  const st2 = JSON.parse(fs.readFileSync(path.join(dir, '.flow-comet', 'flow-comet-state.json'), 'utf8'));
605
629
  st2.evidence['subagent-execute'] = { handoffResult: handoffFor(['P01']) };
606
630
  writeState(dir, st2);
@@ -885,6 +909,19 @@ export const ENTRIES = [
885
909
  if (!guidance.includes('仍必须由 subagent-execute 委托消化')) {
886
910
  problems.push(guidanceRel + ' 缺「仍必须由 subagent-execute 委托消化」(direct 委托消化判别句)');
887
911
  }
912
+ // —— 任务书「action 与 verify 同源」自检规则锚(规则本体是 7 字段段的子条目,既有锚句不动)——
913
+ // 判据 = 标签与操作条款都在场;反向构造用同一谓词:全量 split/join 抽掉后必须判缺——抽掉仍判
914
+ // 在场即锚失效(只锚标题会漏掉「义务句被删、标题保留」的退化)。
915
+ const actionVerifyAnchors = ['action 与 verify 同源', '必须包含同任务 `<verify>` 断言的字面串'];
916
+ for (const actionVerifyAnchor of actionVerifyAnchors) {
917
+ const actionVerifyMissing = (text) => (text.includes(actionVerifyAnchor)
918
+ ? []
919
+ : ['flow-comet-task/SKILL.md 缺「' + actionVerifyAnchor + '」(action/verify 同源规则)']);
920
+ problems.push(...actionVerifyMissing(taskText));
921
+ if (actionVerifyMissing(taskText.split(actionVerifyAnchor).join('(反向构造:抽掉)')).length === 0) {
922
+ problems.push('反向构造判别力缺失(flow-comet-task/SKILL.md 抽掉「' + actionVerifyAnchor + '」未被判缺)');
923
+ }
924
+ }
888
925
  }
889
926
  // —— 波次投影与 AC 覆盖判据句(本批新增判据的文本锁)——
890
927
  // 判据 = 关键句在**该在场的册**里逐条在案:plan / task 两册锁「波次 = 依赖层级的投影」的规则
@@ -926,7 +963,7 @@ export const ENTRIES = [
926
963
  ['AC 覆盖 · 判不了即未校验(中文)', '未校验(<原因>)'],
927
964
  ['AC 覆盖 · 不改退出码(中文)', '不改变退出码'],
928
965
  ['AC 覆盖 · 内容不可判按分级(中文)', 'AC 覆盖判据无法执行'],
929
- ['AC 覆盖 · 内容不可判进 WARN 计数(中文)', '该行进入 WARN 计数'],
966
+ ['AC 覆盖 · 内容不可判同判 BLOCKED(中文)', '一律 BLOCKED(同一形态一个判级)'],
930
967
  ];
931
968
  const acAnchorsEn = [
932
969
  ['AC 覆盖 · 判不了即未校验(英文)', 'not checked (<reason>)'],
@@ -1045,8 +1082,8 @@ export const ENTRIES = [
1045
1082
  '报文按**协议派生**给出该节点**每个** `guarded` 必需技能各一条命令'],
1046
1083
  ['展开册 · 恢复命令一次给全、照抄即通', 'flow-comet/reference/entry-detail.md',
1047
1084
  '三个面一次给全,照抄即通'],
1048
- ['展开册 · 分级(新 BLOCKED / 旧 WARN)', 'flow-comet/reference/entry-detail.md',
1049
- '新 change BLOCKED(强制全部覆盖)、旧 change 只 WARN'],
1085
+ ['展开册 · 单轨判级(同一形态一律 BLOCKED)', 'flow-comet/reference/entry-detail.md',
1086
+ '同一形态一律 BLOCKED(强制全部覆盖'],
1050
1087
  ['展开册 · 旧单值标记按 basename 计入覆盖', 'flow-comet/reference/entry-detail.md',
1051
1088
  '照样按 basename 计入覆盖'],
1052
1089
  ];
@@ -1126,16 +1163,18 @@ export const ENTRIES = [
1126
1163
  }
1127
1164
  }
1128
1165
  }
1129
- // —— ⑦ 文档口径与实现一致:入口只拦错路径 / 旧 change 按 `newChange` 标记分级 ——
1166
+ // —— ⑦ 文档口径与实现一致:入口只拦错路径 / 排障册的分级句按初始化标记表述 ——
1130
1167
  // 与实现逐条对账(不在断言里写第二份判据):
1131
1168
  // ① 入口侧的声明核对只判「已写下的每条声明是否落在节点协议面内」——缺失不在入口判;
1132
1169
  // 「该读的每份是否都声明过」只在出口判。两册必须这样写——旧口径「错路径与少声明都由入口拦」
1133
1170
  // 把出口的判据说成了入口的,读者会以为少声明也能在入口被挡下。
1134
- // ② 旧 change 的分级判据是 `state.newChange === true`(`isNewChange`)——排障册不得再写成
1135
- // 「本规则之前创建的 change」:那是拿时间猜判据,而判据只有一个输入(初始化标记在不在)。
1136
- // 公开面不直写机器状态字段名(键名黑名单在场景 105),故文档侧一律写行为描述。
1137
- // 判据 = 锚句逐条在其所属册在场 + 旧句零残留 + 排障册每处旧 change 分级句都按标记表述;
1138
- // 反向构造:抽掉任一锚 ⇒ 必报缺该锚;还原旧句 / 摘掉某行的标记 ⇒ 必报残留或该行违规。
1171
+ // ② 双向分级已退役(单轨:同一形态一个判级),排障册里经裁决已删净「旧 change 只告警」句。
1172
+ // 本段因此保留两件**回流防护**:按时间猜判据的旧句零残留;若谁再把分级句写回排障册,
1173
+ // 必须按「初始化标记」表述而不是按时间(公开面不直写机器状态字段名——键名黑名单在场景
1174
+ // 105,故文档侧一律写行为描述)。
1175
+ // 判据 = 锚句逐条在其所属册在场 + 旧句零残留 + 排障册每处分级句都按标记表述;
1176
+ // 反向构造:抽掉任一锚 ⇒ 必报缺该锚;还原旧句 ⇒ 必报残留;注入一条缺标记的分级行 ⇒ 必报
1177
+ // 该行违规(分级行已被删净后,判别力由这条合成前提承担,不再依赖真实文档里是否还剩该句)。
1139
1178
  {
1140
1179
  const skillRoot = path.join(SCRIPTS_DIR, '..');
1141
1180
  const wordingDocs = {
@@ -1168,12 +1207,16 @@ export const ENTRIES = [
1168
1207
  'docs/MECHANISM-zh.md': ['规则生效之前创建', '在本规则之前创建'],
1169
1208
  },
1170
1209
  };
1171
- // 排障册里每一处「旧 change 只告警」都别写成按时间判——判据只有「标记在不在」这一个输入。
1172
- // 判别句不是键名而是**行为描述**:公开面不直写机器状态字段名(场景 105 的黑名单),
1173
- // 所以文档只能写「初始化标记」这类说法——判据锚它,锚键名会与那条纪律直接打架。
1210
+ // 排障册里若还出现「旧 change 只告警」一类的分级行,别把它写成按时间判——判据只有「标记在
1211
+ // 不在」这一个输入。判别句不是键名而是**行为描述**:公开面不直写机器状态字段名(场景 105 的
1212
+ // 黑名单),所以文档只能写「初始化标记」这类说法——判据锚它,锚键名会与那条纪律直接打架。
1213
+ // 单轨退役后这类分级行已按裁决删净;本规则保留为回流防护,probe 是它反向构造用的**合成
1214
+ // 前提**(命中「分级行」形态、不带标记)——不依赖真实文档里是否还剩该句。
1174
1215
  const markerWordingRules = {
1175
- 'docs/TROUBLESHOOTING.md': { line: /\bchange\b[^.]*\bwarn/i, marker: 'initialization marker' },
1176
- 'docs/TROUBLESHOOTING-zh.md': { line: /change[^。]*只告警/, marker: '初始化标记' },
1216
+ 'docs/TROUBLESHOOTING.md': { line: /\bchange\b[^.]*\bwarn/i, marker: 'initialization marker',
1217
+ probe: 'an old change only warns (synthetic probe line)' },
1218
+ 'docs/TROUBLESHOOTING-zh.md': { line: /change[^。]*只告警/, marker: '初始化标记',
1219
+ probe: '旧 change 只告警(合成探针行)' },
1177
1220
  };
1178
1221
  // 单一判据实现:真实核对与反向构造探针共用(两份实现必然分叉)。
1179
1222
  const wordingProblems = ({ entry, troubleshooting }) => {
@@ -1244,11 +1287,25 @@ export const ENTRIES = [
1244
1287
  const rule = markerWordingRules[rel];
1245
1288
  if (!rule) continue; // 只做旧句零残留的册(机制册)不走逐行探针
1246
1289
  const lines = text.split(String.fromCharCode(10));
1247
- const hitIndex = lines.findIndex((line) => rule.line.test(line) && line.includes(rule.marker));
1248
- if (hitIndex < 0) {
1249
- problems.push('反向构造的前提不成立(' + rel + ': 找不到按标记表述旧 change 分级的行)');
1290
+ // 合成前提:命中「分级行」规则但**不带标记**的行注入同一判据后必须被判违规。单轨退役后
1291
+ // 排障册已按裁决删净那类句子(方向正确),继续拿真实句当探针前提会让判别力探针随文档一起
1292
+ // 消失——判定规则一旦被中和(不再逐行核对标记),这条注入就没人报 ⇒ 探针必红。注入的是
1293
+ // 文本数据,不改真实文件;前提形态(命中规则 ∧ 缺标记)先自检,改规则/改标记词都会当场红。
1294
+ if (!rule.line.test(rule.probe) || rule.probe.includes(rule.marker)) {
1295
+ problems.push('反向构造的前提不成立(' + rel + ': 合成探针行不满足「命中分级行且缺标记」形态)');
1250
1296
  continue;
1251
1297
  }
1298
+ const injectedLines = lines.concat([rule.probe]);
1299
+ const injected = { entry: wordingDocs.entry,
1300
+ troubleshooting: new Map(wordingDocs.troubleshooting)
1301
+ .set(rel, injectedLines.join(String.fromCharCode(10))) };
1302
+ if (!wordingProblems(injected).some((p) => p.includes('第 ' + injectedLines.length + ' 行'))) {
1303
+ problems.push('反向构造判别力缺失(' + rel + ': 注入缺标记的 old change 分级行未被判违规)');
1304
+ }
1305
+ // 真实文档里若仍有按标记表述的分级行,照旧做「摘掉标记 ⇒ 必报该行」的探针(判别力加倍);
1306
+ // 单轨退役后该句不存在,此处只跳过这一半、不判红——文档该不该有它由真实判据的第一半判。
1307
+ const hitIndex = lines.findIndex((line) => rule.line.test(line) && line.includes(rule.marker));
1308
+ if (hitIndex < 0) continue;
1252
1309
  const mutated = lines.slice();
1253
1310
  mutated[hitIndex] = mutated[hitIndex].split(rule.marker).join('(标记)');
1254
1311
  const stripped = { entry: wordingDocs.entry,
@@ -1741,7 +1798,7 @@ export const ENTRIES = [
1741
1798
  ['委托记账 · 判定先于零提交与子集校验(中文)', '该校验先于零提交语义与提交子集校验'],
1742
1799
  ['委托顺序 · 两件事别混(中文)', '本条管的是「request 与子代理启动的先后」'],
1743
1800
  ['result 需 request · 机制保证(英文)', 'is a mechanism guarantee'],
1744
- ['委托记账 · 写盘前拒绝(英文)', 'refused before anything is written (a new change blocks'],
1801
+ ['委托记账 · 写盘前拒绝(英文)', 'refused before anything is written (it blocks'],
1745
1802
  ['委托顺序 · 两件事别混(英文)', 'this rule is about the order of the request and the subagent launch'],
1746
1803
  ];
1747
1804
  const bookAnchorProblems = (books, anchors) => {
@@ -19,20 +19,21 @@ import {
19
19
  writeState,
20
20
  } from '../lib/test-helpers.mjs';
21
21
  import {
22
- CHANGE_ID,
23
- PREPARE_ENV,
24
- REPO_ROOT,
25
- SCRIPTS_DIR,
26
22
  bridgeStampSyncProblems,
27
23
  bridgeStampSyncSubAnchorCases,
24
+ CHANGE_ID,
28
25
  fixtureBridgeBaseVersion,
29
26
  fixtureIsBridgeDevVersion,
30
27
  handoffFor,
28
+ PREPARE_ENV,
29
+ REPO_ROOT,
31
30
  runBridgeCheck,
32
31
  runPlanExit,
33
32
  runPrepareEnv,
33
+ SCRIPTS_DIR,
34
34
  strictSummary,
35
35
  summaryContent,
36
+ writeAllNodeDeclarationMarkers,
36
37
  writeBridgeFixture,
37
38
  writeIntakeArtifacts,
38
39
  writeNodeDeclarationMarkers,
@@ -458,6 +459,10 @@ export const ENTRIES = [
458
459
  {
459
460
  name: '198 多趟出口路由时序收敛:逐节点 exit --apply 后 next 输出 NODE 与 guard 出口 NODE 一致',
460
461
  run: (dir) => {
462
+ writeNodeDeclarationMarkers(dir, 'execute');
463
+ writeNodeDeclarationMarkers(dir, 'subagent-execute');
464
+ writeNodeDeclarationMarkers(dir, 'review');
465
+ writeAllNodeDeclarationMarkers(dir);
461
466
  const writeTask = (statusMap) => {
462
467
  const blk = (id, parallel, deps) =>
463
468
  '<task id="' + id + '"' + (parallel ? ' parallel="true"' : '') +
@@ -486,7 +491,7 @@ export const ENTRIES = [
486
491
  o.evidence[node] = merged;
487
492
  writeState(dir, o);
488
493
  };
489
- const writeSummary = (ids) => { for (const id of ids) writeFile(dir, '.specs/' + CHANGE_ID + '/' + id + '-SUMMARY.md', summaryContent()); };
494
+ const writeSummary = (ids) => { for (const id of ids) writeFile(dir, '.specs/' + CHANGE_ID + '/' + id + '-SUMMARY.md', strictSummary('T01')); };
490
495
  const nodeOf = (out) => (out.match(/^NODE: ([a-z-]+)$/m) || [])[1] ?? null;
491
496
  const assertConverge = (guardRes) => {
492
497
  assertExit(guardRes, 0);
@@ -571,7 +576,7 @@ export const ENTRIES = [
571
576
  // ⑩ archive 出口 → 全部完成(两侧均 NEXT: done)
572
577
  assertExit(runGuard(['entry', 'archive'], dir), 0);
573
578
  writeFile(dir, '.specs/archive/2026-08-28-' + CHANGE_ID + '/KNOWN-ISSUES.md', '# 遗留问题\n\n无。\n');
574
- appendEvidence('archive', { summary: 'archive complete' });
579
+ appendEvidence('archive', { summary: 'archive complete', lessonsNomination: { scanned: 6, nominated: [], reasonIfNone: '夹具无候选条目' } });
575
580
  const res = runGuard(['exit', 'archive', '--apply'], dir);
576
581
  assertExit(res, 0);
577
582
  assertOut(res, 'NEXT: done');
@@ -695,7 +700,6 @@ export const ENTRIES = [
695
700
  run: (dir) => {
696
701
  const st = baseState('plan');
697
702
  st.evidence.plan = { summary: 'plan done' };
698
- st.newChange = true;
699
703
  writeState(dir, st);
700
704
  const tasks =
701
705
  '<task id="P01" parallel="true" status="pending"><action>实现 P01</action><write_files>bak_a.txt</write_files><verify>node --check bak_a.txt</verify></task>\n' +
@@ -755,10 +759,9 @@ export const ENTRIES = [
755
759
  },
756
760
  },
757
761
 
758
- // 203: 写写强判分级(渐进)——同拓扑旧 change(无 newChange 标记):plan 出口应 WARN 渐进
759
- // 不 BLOCK(与依赖环分级同先例)。修复前 plan 出口无检测 = 预期 RED(无 WARN 亦无 BLOCK)。
762
+ // 203: 写写强判——同拓扑(无任何新旧标记字段):plan 出口一律 BLOCKED(单轨,无渐进侧)
760
763
  {
761
- name: '203 plan exit 兼容:旧 change 写写重叠不 BLOCK(渐进 WARN)',
764
+ name: '203 plan exit:写写重叠一律 BLOCKED',
762
765
  run: (dir) => {
763
766
  const st = baseState('plan');
764
767
  st.evidence.plan = { summary: 'plan done' };
@@ -767,9 +770,8 @@ export const ENTRIES = [
767
770
  '<task id="P01" parallel="true" status="pending"><action>实现 P01</action><write_files>bak_a.txt</write_files><verify>node --check bak_a.txt</verify></task>\n' +
768
771
  '<task id="P02" parallel="true" status="pending"><action>实现 P02</action><write_files>bak_a.txt</write_files><verify>node --check bak_a.txt</verify></task>\n';
769
772
  const res = runPlanExit(dir, tasks);
770
- assertExit(res, 0);
771
- assertNotOut(res, 'BLOCKED');
772
- assertOut(res, 'WARN');
773
+ assertExit(res, 1);
774
+ assertOut(res, 'BLOCKED');
773
775
  assertOut(res, 'P01×P02');
774
776
  assertOut(res, 'bak_a.txt');
775
777
  },
@@ -782,7 +784,6 @@ export const ENTRIES = [
782
784
  run: (dir) => {
783
785
  const st = baseState('plan');
784
786
  st.evidence.plan = { summary: 'plan done' };
785
- st.newChange = true;
786
787
  writeState(dir, st);
787
788
  const tasks =
788
789
  '<task id="P01" parallel="true" status="pending"><action>实现 P01</action><write_files>notes.txt</write_files><verify>node --check notes.txt</verify></task>\n' +
@@ -806,7 +807,6 @@ export const ENTRIES = [
806
807
  run: (dir) => {
807
808
  const st = baseState('plan');
808
809
  st.evidence.plan = { summary: 'plan done' };
809
- st.newChange = true;
810
810
  writeState(dir, st);
811
811
  // ① 无显式关联对:P01 读 shared-context.md,P02 写同路径 → WARN 提示级(不 BLOCK)
812
812
  const weak =
@@ -837,7 +837,6 @@ export const ENTRIES = [
837
837
  run: (dir) => {
838
838
  // ① 委托前锚:同波次并行 pending 写写重叠 → entry subagent-execute 仍 BLOCKED
839
839
  const st = baseState('subagent-execute');
840
- st.newChange = true;
841
840
  writeState(dir, st);
842
841
  const conflictTasksForDelegation =
843
842
  '<task id="P01" parallel="true" status="pending"><action>实现 P01</action><write_files>bak_a.txt</write_files><verify>node --check bak_a.txt</verify></task>\n' +
@@ -851,7 +850,6 @@ export const ENTRIES = [
851
850
  // 仍触发伪并行 WARN——新检测与既有检测并存不干扰
852
851
  const st2 = baseState('plan');
853
852
  st2.evidence.plan = { summary: 'plan done' };
854
- st2.newChange = true;
855
853
  writeState(dir, st2);
856
854
  const coexisting =
857
855
  '<task id="P01" parallel="true" status="pending"><action>实现 P01</action><write_files>src/p1.mjs</write_files><verify>node --check src/p1.mjs</verify></task>\n' +
@@ -871,6 +869,8 @@ export const ENTRIES = [
871
869
  {
872
870
  name: '207 多趟平行转换 next 可达且与 guard NEXT 一致(完整时序锚)',
873
871
  run: (dir) => {
872
+ writeAllNodeDeclarationMarkers(dir);
873
+ writeNodeDeclarationMarkers(dir, 'plan');
874
874
  const writeTask = (statusMap) => {
875
875
  const blk = (id, parallel, deps) =>
876
876
  '<task id="' + id + '"' + (parallel ? ' parallel="true"' : '') +
@@ -895,7 +895,7 @@ export const ENTRIES = [
895
895
  o.evidence[node] = merged;
896
896
  writeState(dir, o);
897
897
  };
898
- const writeSummary = (ids) => { for (const id of ids) writeFile(dir, '.specs/' + CHANGE_ID + '/' + id + '-SUMMARY.md', summaryContent()); };
898
+ const writeSummary = (ids) => { for (const id of ids) writeFile(dir, '.specs/' + CHANGE_ID + '/' + id + '-SUMMARY.md', strictSummary('T01')); };
899
899
  const nodeOf = (out) => (out.match(/^NODE: ([a-z-]+)$/m) || [])[1] ?? null;
900
900
  const assertConverge = (guardRes) => {
901
901
  assertExit(guardRes, 0);
@@ -967,7 +967,7 @@ export const ENTRIES = [
967
967
  assertConverge(runGuard(['exit', 'verify', '--apply'], dir));
968
968
  // ⑩ archive 出口 → 完成(两侧均 NEXT: done)
969
969
  writeFile(dir, '.specs/archive/2026-08-28-' + CHANGE_ID + '/KNOWN-ISSUES.md', '# 遗留问题\n\n无。\n');
970
- appendEvidence('archive', { summary: 'archive complete' });
970
+ appendEvidence('archive', { summary: 'archive complete', lessonsNomination: { scanned: 6, nominated: [], reasonIfNone: '夹具无候选条目' } });
971
971
  assertExit(runGuard(['entry', 'archive'], dir), 0);
972
972
  const resArch = runGuard(['exit', 'archive', '--apply'], dir);
973
973
  assertExit(resArch, 0);
@@ -1001,7 +1001,6 @@ export const ENTRIES = [
1001
1001
  design: { summary: 'design complete' },
1002
1002
  plan: { summary: 'plan complete' },
1003
1003
  };
1004
- st.newChange = true;
1005
1004
  writeState(dir, st);
1006
1005
  writeNodeDeclarationMarkers(dir, 'plan');
1007
1006
  // ① record 后未 exit 先 next:不把 currentNode 提前校正到 subagent-execute(路由后继)
@@ -1060,7 +1059,6 @@ export const ENTRIES = [
1060
1059
  plan: { summary: 'plan done' },
1061
1060
  execute: { summary: 'executed', parallelTakeoverApproved: true },
1062
1061
  };
1063
- st.newChange = true;
1064
1062
  writeState(dir, st);
1065
1063
  writeNodeDeclarationMarkers(dir, 'execute');
1066
1064
  const res = runGuard(['exit', 'execute', '--apply'], dir);
@@ -1094,12 +1092,25 @@ export const ENTRIES = [
1094
1092
  plan: { summary: 'plan done' },
1095
1093
  execute: { summary: 'executed' },
1096
1094
  };
1097
- st.newChange = true;
1098
1095
  writeState(dir, st);
1099
1096
  const res = runGuard(['exit', 'execute', '--apply'], dir);
1100
1097
  assertExit(res, 1);
1101
1098
  assertOut(res, 'BLOCKED: currentNode is review');
1102
1099
  assertNotOut(res, 'ALL CHECKS PASSED');
1100
+ // 恢复指引按目录在哪分两种说法(in-place 扩展):活动态给 advance / select;目录已搬进归档时
1101
+ // 这两步都走不通(select 要求活动目录在场,advance 的产物推导读的也是活动路径),只给可执行
1102
+ // 的那一步——把目录移回活动位置。断言用「不出现」的负向形态钉住这个分叉。
1103
+ assertOut(res, '用 workflow-state.mjs advance');
1104
+ fs.mkdirSync(path.join(dir, '.specs', 'archive'), { recursive: true });
1105
+ fs.renameSync(path.join(dir, '.specs', CHANGE_ID),
1106
+ path.join(dir, '.specs', 'archive', '2026-11-05-' + CHANGE_ID));
1107
+ const resMoved = runGuard(['exit', 'execute', '--apply'], dir);
1108
+ assertExit(resMoved, 1);
1109
+ assertOut(resMoved, 'BLOCKED: currentNode is review');
1110
+ assertOut(resMoved, '已移到归档位置(.specs/archive/2026-11-05-' + CHANGE_ID + ')');
1111
+ assertOut(resMoved, '移回活动位置 .specs/' + CHANGE_ID + '/');
1112
+ assertNotOut(resMoved, 'advance');
1113
+ assertNotOut(resMoved, 'select');
1103
1114
  },
1104
1115
  },
1105
1116
 
@@ -1109,6 +1120,7 @@ export const ENTRIES = [
1109
1120
  {
1110
1121
  name: '211 路由诊断静默:剩余 pending 全串行(P→S 收尾转换)无 ROUTE WARN',
1111
1122
  run: (dir) => {
1123
+ writeNodeDeclarationMarkers(dir, 'plan');
1112
1124
  writeIntakeArtifacts(dir);
1113
1125
  const st = baseState('plan');
1114
1126
  st.completedNodes = ['open', 'design'];
@@ -1131,6 +1143,7 @@ export const ENTRIES = [
1131
1143
  {
1132
1144
  name: '212 路由诊断保持:parallel 缺 status(畸形块)仍报 ROUTE WARN',
1133
1145
  run: (dir) => {
1146
+ writeNodeDeclarationMarkers(dir, 'plan');
1134
1147
  writeIntakeArtifacts(dir);
1135
1148
  const st = baseState('plan');
1136
1149
  st.completedNodes = ['open', 'design'];
@@ -1166,7 +1179,6 @@ export const ENTRIES = [
1166
1179
  st.directOverride = true;
1167
1180
  st.directOverrideAt = '2026-08-29T10:00:00.000Z';
1168
1181
  st.directOverrideSource = 'execution-mode';
1169
- st.newChange = true;
1170
1182
  writeState(dir, st);
1171
1183
  writeNodeDeclarationMarkers(dir, 'execute');
1172
1184
  writeFile(dir, '.specs/' + CHANGE_ID + '/TASK.md', '# TASK\n\n' +
@@ -1197,7 +1209,6 @@ export const ENTRIES = [
1197
1209
  st.executionMode = 'direct';
1198
1210
  st.directOverride = true;
1199
1211
  // 无 directOverrideAt 授权审计记录(执行者自切/修复前遗留形态)
1200
- st.newChange = true;
1201
1212
  writeState(dir, st);
1202
1213
  writeFile(dir, '.specs/' + CHANGE_ID + '/TASK.md', '# TASK\n\n' +
1203
1214
  '<task id="S01" status="done"><action>实现 S01</action><write_files>src/s1.mjs</write_files><verify>node --check src/s1.mjs</verify></task>\n');
@@ -1247,7 +1258,6 @@ export const ENTRIES = [
1247
1258
  execute: { summary: 'executed' },
1248
1259
  'subagent-execute': { summary: 'delegated', handoffResult: handoffFor(['S01']) },
1249
1260
  };
1250
- st.newChange = true;
1251
1261
  return st;
1252
1262
  };
1253
1263
  const writeTask = () => writeFile(dir, '.specs/' + CHANGE_ID + '/TASK.md', '# TASK\n\n' +
@@ -1329,7 +1339,7 @@ export const ENTRIES = [
1329
1339
  writeFile(dir, '.specs/' + CHANGE_ID + '/TASK.md', '# TASK\n\n' +
1330
1340
  '<task id="T01" status="done"><action>实现 T01</action><write_files>src/t1.mjs</write_files><verify>node --check src/t1.mjs</verify></task>\n' +
1331
1341
  '<task id="T02" parallel="true"><action>实现 T02</action><write_files>src/t2.mjs</write_files><verify>node --check src/t2.mjs</verify></task>\n');
1332
- writeFile(dir, '.specs/' + CHANGE_ID + '/T01-SUMMARY.md', summaryContent());
1342
+ writeFile(dir, '.specs/' + CHANGE_ID + '/T01-SUMMARY.md', strictSummary('T01'));
1333
1343
  writeState(dir, {
1334
1344
  activeChange: CHANGE_ID,
1335
1345
  currentNode: 'execute',
@@ -1356,7 +1366,6 @@ export const ENTRIES = [
1356
1366
  run: (dir) => {
1357
1367
  const st = baseState('plan');
1358
1368
  st.evidence.plan = { summary: 'plan done' };
1359
- st.newChange = true;
1360
1369
  writeState(dir, st);
1361
1370
  const tasks =
1362
1371
  '<task id="P01" parallel="true" status="pending"><action>实现 P01</action><write_files>src/a.mjs</write_files><verify>node --check src/a.mjs</verify></task>\n' +