flow-comet 1.6.5 → 1.7.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 (61) hide show
  1. package/.flow-comet/skills/flow-comet/INSTALLED_VERSION +1 -1
  2. package/.flow-comet/skills/flow-comet/SKILL.md +17 -5
  3. package/.flow-comet/skills/flow-comet/reference/commit-discipline.md +1 -1
  4. package/.flow-comet/skills/flow-comet/reference/entry-detail.md +23 -4
  5. package/.flow-comet/skills/flow-comet/scripts/context-init.mjs +26 -23
  6. package/.flow-comet/skills/flow-comet/scripts/guard-self-test.mjs +14 -94
  7. package/.flow-comet/skills/flow-comet/scripts/items/a.mjs +97 -3
  8. package/.flow-comet/skills/flow-comet/scripts/items/b.mjs +38 -2
  9. package/.flow-comet/skills/flow-comet/scripts/items/e.mjs +52 -10
  10. package/.flow-comet/skills/flow-comet/scripts/items/h.mjs +16 -3
  11. package/.flow-comet/skills/flow-comet/scripts/items/l.mjs +2 -0
  12. package/.flow-comet/skills/flow-comet/scripts/items/m.mjs +4 -0
  13. package/.flow-comet/skills/flow-comet/scripts/items/n.mjs +20 -11
  14. package/.flow-comet/skills/flow-comet/scripts/lib/ac-coverage.mjs +317 -0
  15. package/.flow-comet/skills/flow-comet/scripts/lib/guard-artifact-skeleton.mjs +47 -5
  16. package/.flow-comet/skills/flow-comet/scripts/lib/guard-evidence-gates.mjs +297 -131
  17. package/.flow-comet/skills/flow-comet/scripts/lib/guard-gates.mjs +616 -151
  18. package/.flow-comet/skills/flow-comet/scripts/lib/guard-routing.mjs +96 -45
  19. package/.flow-comet/skills/flow-comet/scripts/lib/guard-state-io.mjs +8 -6
  20. package/.flow-comet/skills/flow-comet/scripts/lib/guard-template-fidelity.mjs +204 -51
  21. package/.flow-comet/skills/flow-comet/scripts/lib/guard-uidesign.mjs +7 -9
  22. package/.flow-comet/skills/flow-comet/scripts/lib/lessons-hits.mjs +160 -0
  23. package/.flow-comet/skills/flow-comet/scripts/lib/run-root.mjs +21 -0
  24. package/.flow-comet/skills/flow-comet/scripts/lib/section-body.mjs +92 -0
  25. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-admin.mjs +38 -20
  26. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-flow.mjs +439 -134
  27. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-recovery.mjs +66 -0
  28. package/.flow-comet/skills/flow-comet/scripts/lib/state-explain.mjs +92 -13
  29. package/.flow-comet/skills/flow-comet/scripts/lib/state-io.mjs +55 -2
  30. package/.flow-comet/skills/flow-comet/scripts/lib/state-skillmarkers.mjs +94 -39
  31. package/.flow-comet/skills/flow-comet/scripts/lib/system-fixtures.mjs +6 -0
  32. package/.flow-comet/skills/flow-comet/scripts/lib/task-graph.mjs +84 -31
  33. package/.flow-comet/skills/flow-comet/scripts/lib/test-fixtures.mjs +57 -7
  34. package/.flow-comet/skills/flow-comet/scripts/lib/test-helpers.mjs +60 -3
  35. package/.flow-comet/skills/flow-comet/scripts/lib/text-anchor-checks.mjs +158 -3
  36. package/.flow-comet/skills/flow-comet/scripts/lib/wave-projection.mjs +341 -0
  37. package/.flow-comet/skills/flow-comet/scripts/protocol-utils.mjs +92 -17
  38. package/.flow-comet/skills/flow-comet/scripts/scenarios/a.mjs +1439 -11
  39. package/.flow-comet/skills/flow-comet/scripts/scenarios/b.mjs +1202 -8
  40. package/.flow-comet/skills/flow-comet/scripts/scenarios/c.mjs +1204 -76
  41. package/.flow-comet/skills/flow-comet/scripts/scenarios/d.mjs +753 -5
  42. package/.flow-comet/skills/flow-comet/scripts/scenarios/e.mjs +32 -1
  43. package/.flow-comet/skills/flow-comet/scripts/scenarios/f.mjs +582 -3
  44. package/.flow-comet/skills/flow-comet/scripts/scenarios/g.mjs +5 -0
  45. package/.flow-comet/skills/flow-comet/scripts/scenarios/i.mjs +5 -0
  46. package/.flow-comet/skills/flow-comet/scripts/scenarios/j.mjs +16 -0
  47. package/.flow-comet/skills/flow-comet/scripts/scenarios/k.mjs +2 -0
  48. package/.flow-comet/skills/flow-comet/scripts/scenarios/l.mjs +5 -0
  49. package/.flow-comet/skills/flow-comet/scripts/scenarios/n.mjs +2041 -66
  50. package/.flow-comet/skills/flow-comet/scripts/state-schema.mjs +135 -0
  51. package/.flow-comet/skills/flow-comet/scripts/workflow-guard.mjs +143 -16
  52. package/.flow-comet/skills/flow-comet/scripts/workflow-handoff.mjs +312 -63
  53. package/.flow-comet/skills/flow-comet/scripts/workflow-state.mjs +5 -2
  54. package/.flow-comet/skills/flow-comet-execute/SKILL.md +30 -6
  55. package/.flow-comet/skills/flow-comet-plan/SKILL.md +10 -3
  56. package/.flow-comet/skills/flow-comet-review/SKILL.md +20 -11
  57. package/.flow-comet/skills/flow-comet-subagent-execute/SKILL.md +33 -8
  58. package/.flow-comet/skills/flow-comet-task/SKILL.md +2 -1
  59. package/README.md +1 -1
  60. package/package.json +1 -1
  61. package/scripts/dsh-bridge.mjs +2 -2
@@ -35,6 +35,7 @@ import {
35
35
  summaryContent,
36
36
  writeBridgeFixture,
37
37
  writeIntakeArtifacts,
38
+ writeNodeDeclarationMarkers,
38
39
  } from '../lib/test-fixtures.mjs';
39
40
  import {
40
41
  assertInstalledCopyBridgeVersionCase,
@@ -1002,6 +1003,7 @@ export const ENTRIES = [
1002
1003
  };
1003
1004
  st.newChange = true;
1004
1005
  writeState(dir, st);
1006
+ writeNodeDeclarationMarkers(dir, 'plan');
1005
1007
  // ① record 后未 exit 先 next:不把 currentNode 提前校正到 subagent-execute(路由后继)
1006
1008
  const r1 = runStateWithProtocol(dir, ['next']);
1007
1009
  assertExit(r1, 0);
@@ -1060,6 +1062,7 @@ export const ENTRIES = [
1060
1062
  };
1061
1063
  st.newChange = true;
1062
1064
  writeState(dir, st);
1065
+ writeNodeDeclarationMarkers(dir, 'execute');
1063
1066
  const res = runGuard(['exit', 'execute', '--apply'], dir);
1064
1067
  assertExit(res, 0);
1065
1068
  assertNotOut(res, 'BLOCKED: currentNode');
@@ -1165,6 +1168,7 @@ export const ENTRIES = [
1165
1168
  st.directOverrideSource = 'execution-mode';
1166
1169
  st.newChange = true;
1167
1170
  writeState(dir, st);
1171
+ writeNodeDeclarationMarkers(dir, 'execute');
1168
1172
  writeFile(dir, '.specs/' + CHANGE_ID + '/TASK.md', '# TASK\n\n' +
1169
1173
  '<task id="S01" status="done"><action>实现 S01</action><write_files>src/s1.mjs</write_files><verify>node --check src/s1.mjs</verify></task>\n');
1170
1174
  writeFile(dir, '.specs/' + CHANGE_ID + '/S01-SUMMARY.md', strictSummary('S01'));
@@ -1254,6 +1258,7 @@ export const ENTRIES = [
1254
1258
  st1.executionMode = 'direct';
1255
1259
  st1.directOverride = true;
1256
1260
  writeState(dir, st1);
1261
+ writeNodeDeclarationMarkers(dir, 'execute');
1257
1262
  writeTask();
1258
1263
  const rBlock = runGuard(['exit', 'execute', '--apply'], dir);
1259
1264
  assertExit(rBlock, 1);
@@ -22,6 +22,7 @@ import {
22
22
  scriptTreeFiles,
23
23
  strictSummary,
24
24
  writeIntakeArtifacts,
25
+ writeNodeDeclarationMarkers,
25
26
  } from '../lib/test-fixtures.mjs';
26
27
  import {
27
28
  FIX_RETURN_FAMILY_COMPLETED,
@@ -1281,6 +1282,8 @@ export const ENTRIES = [
1281
1282
  directOverride: false,
1282
1283
  newChange: true,
1283
1284
  });
1285
+ // 声明标记:真实流程里由协调者 / record 写;夹具直接写 state,须补同一份事实(否则先撞覆盖门)
1286
+ writeNodeDeclarationMarkers(dir, 'execute');
1284
1287
  const res = runGuard(['exit', 'execute', '--apply'], dir);
1285
1288
  assertExit(res, 0);
1286
1289
  assertOut(res, 'FIX-BATCH: 回源节点 review(execute 出口已完成)');
@@ -1343,6 +1346,8 @@ export const ENTRIES = [
1343
1346
  },
1344
1347
  ],
1345
1348
  }));
1349
+ // 声明标记(新 change 的出口覆盖门):夹具直接写 state,补上真实流程里协调者 / record 写的那份。
1350
+ writeNodeDeclarationMarkers(dir, 'execute');
1346
1351
  const resDivergentPlain = runGuard(['exit', 'execute', '--apply'], dir);
1347
1352
  assertExit(resDivergentPlain, 0);
1348
1353
  assertOut(resDivergentPlain, 'FIX-BATCH: 回源节点 review(execute 出口已完成)');
@@ -22,6 +22,7 @@ import {
22
22
  routeNodeModule,
23
23
  strictSummary,
24
24
  writeIntakeArtifacts,
25
+ writeNodeDeclarationMarkers,
25
26
  } from '../lib/test-fixtures.mjs';
26
27
  import {
27
28
  FIX_RETURN_FAMILY_COMPLETED,
@@ -87,6 +88,7 @@ export const ENTRIES = [
87
88
  at: '2026-09-23T00:00:00.000Z', taskSetSignature: normalSignature,
88
89
  }],
89
90
  }));
91
+ writeNodeDeclarationMarkers(dir, 'execute');
90
92
  const beforeNormal = readScenarioState(dir);
91
93
  const resNormal = runGuard(['exit', 'execute', '--apply'], dir);
92
94
  assertExit(resNormal, 0);
@@ -199,6 +201,7 @@ export const ENTRIES = [
199
201
  directOverride: false,
200
202
  newChange: true,
201
203
  });
204
+ writeNodeDeclarationMarkers(dir, 'execute');
202
205
  const res = runGuard(['exit', 'execute', '--apply'], dir);
203
206
  assertExit(res, 0);
204
207
  assertOut(res, 'FIX-BATCH: 回源节点 verify(execute 出口已完成)');
@@ -244,6 +247,9 @@ export const ENTRIES = [
244
247
  // ① 新 change:review 源直接 exit review --apply → BLOCKED + 恢复指引(不得静默放行)
245
248
  writeFile(dir, taskPath, fixBatchTaskText('pending'));
246
249
  writeState(dir, reviewState);
250
+ // 本场景先后 exit review 与 execute 两个节点:两个节点的必需声明各写一份(真实流程同形)。
251
+ writeNodeDeclarationMarkers(dir, 'review');
252
+ writeNodeDeclarationMarkers(dir, 'execute');
247
253
  const resBlock = runGuard(['exit', 'review', '--apply'], dir);
248
254
  assertExit(resBlock, 1);
249
255
  assertOut(resBlock, 'BLOCKED: 存在未归位/未跑出口的 Fix 批次');
@@ -339,11 +345,16 @@ export const ENTRIES = [
339
345
  };
340
346
  writeState(dir, after);
341
347
  assertExit(runStateWithProtocol(dir, ['skill-load', 'execute', 'flow-comet-execute', '--prompt', 'flow-kit/prompts/4-dev.md', '--templates', 'SUMMARY.md']), 0);
348
+ // 协议 execute.requiredSkillCalls = flow-comet-dev(guarded):节点实现技能与必需技能是两个声明面,
349
+ // 出口的覆盖判据要求后者也有标记(只声明实现技能时覆盖缺口会被拦下)。
350
+ assertExit(runStateWithProtocol(dir, ['skill-load', 'execute', 'flow-comet-dev', '--prompt', 'flow-kit/prompts/4-dev.md', '--templates', 'SUMMARY.md']), 0);
342
351
  const recDoneExit = runGuard(['exit', 'execute', '--apply'], dir);
343
352
  assertExit(recDoneExit, 0);
344
353
  assertOut(recDoneExit, 'FIX-BATCH: 回源节点 review(execute 出口已完成)');
345
354
  assertOut(recDoneExit, 'NODE: review');
346
355
  assertExit(runStateWithProtocol(dir, ['skill-load', 'review', 'flow-comet-review', '--prompt', 'flow-kit/prompts/6-review.md', '--templates', 'REVIEW.md,TEST.md']), 0);
356
+ // review 该读两份协议、协议声明两个 guarded 技能(flow-comet-review / flow-comet-test)
357
+ assertExit(runStateWithProtocol(dir, ['skill-load', 'review', 'flow-comet-test', '--prompt', 'flow-kit/prompts/5-test.md', '--templates', 'REVIEW.md,TEST.md']), 0);
347
358
  assertExit(runGuard(['entry', 'review'], dir), 0);
348
359
  const recDoneReview = runGuard(['exit', 'review', '--apply'], dir);
349
360
  assertExit(recDoneReview, 0);
@@ -387,11 +398,14 @@ export const ENTRIES = [
387
398
  };
388
399
  writeState(dir, after);
389
400
  assertExit(runStateWithProtocol(dir, ['skill-load', 'execute', 'flow-comet-execute', '--prompt', 'flow-kit/prompts/4-dev.md', '--templates', 'SUMMARY.md']), 0);
401
+ assertExit(runStateWithProtocol(dir, ['skill-load', 'execute', 'flow-comet-dev', '--prompt', 'flow-kit/prompts/4-dev.md', '--templates', 'SUMMARY.md']), 0);
390
402
  const recDoneVerifyExit = runGuard(['exit', 'execute', '--apply'], dir);
391
403
  assertExit(recDoneVerifyExit, 0);
392
404
  assertOut(recDoneVerifyExit, 'FIX-BATCH: 回源节点 verify(execute 出口已完成)');
393
405
  assertOut(recDoneVerifyExit, 'NODE: verify');
394
406
  assertExit(runStateWithProtocol(dir, ['skill-load', 'verify', 'flow-comet-verify', '--prompt', 'flow-kit/prompts/7-integration.md']), 0);
407
+ // 协议 verify.requiredSkillCalls = flow-comet-integration(guarded):同一份协议文件、另一个技能面
408
+ assertExit(runStateWithProtocol(dir, ['skill-load', 'verify', 'flow-comet-integration', '--prompt', 'flow-kit/prompts/7-integration.md']), 0);
395
409
  assertExit(runGuard(['entry', 'verify'], dir), 0);
396
410
  const recDoneVerify = runGuard(['exit', 'verify', '--apply'], dir);
397
411
  assertExit(recDoneVerify, 0);
@@ -464,6 +478,8 @@ export const ENTRIES = [
464
478
  throw new Error('并行修复出口应记录本 change + taskSetSignature 的家族出口事件,实际 ' + JSON.stringify(parFamilyExit));
465
479
  }
466
480
  assertExit(runStateWithProtocol(dir, ['skill-load', 'review', 'flow-comet-review', '--prompt', 'flow-kit/prompts/6-review.md', '--templates', 'REVIEW.md,TEST.md']), 0);
481
+ // review 该读两份协议、协议声明两个 guarded 技能(flow-comet-review / flow-comet-test)
482
+ assertExit(runStateWithProtocol(dir, ['skill-load', 'review', 'flow-comet-test', '--prompt', 'flow-kit/prompts/5-test.md', '--templates', 'REVIEW.md,TEST.md']), 0);
467
483
  assertExit(runGuard(['entry', 'review'], dir), 0);
468
484
  const rParSource = runGuard(['exit', 'review', '--apply'], dir);
469
485
  assertExit(rParSource, 0);
@@ -42,6 +42,7 @@ import {
42
42
  runPlanExit,
43
43
  strictSummary,
44
44
  writeIntakeArtifacts,
45
+ writeNodeDeclarationMarkers,
45
46
  } from '../lib/test-fixtures.mjs';
46
47
  import {
47
48
  REENTRY_EXPECTED_INTERSECTION,
@@ -1126,6 +1127,7 @@ export const ENTRIES = [
1126
1127
  // 判据 / 计数。
1127
1128
  writeIntakeArtifacts(dir);
1128
1129
  writeState(dir, replanExecuteState());
1130
+ writeNodeDeclarationMarkers(dir, 'execute');
1129
1131
  assertExit(runGuard(['entry', 'execute'], dir), 0);
1130
1132
  // 任务集修订(#119 死锁现场):新增计划外的并行就绪任务
1131
1133
  writeFile(dir, '.specs/' + CHANGE_ID + '/TASK.md', REPLAN_TASK_REVISED);
@@ -41,6 +41,7 @@ import {
41
41
  timeSingleSourceConsumerProblems,
42
42
  timeUtilsModule,
43
43
  treeFingerprint,
44
+ writeNodeDeclarationMarkers,
44
45
  } from '../lib/test-fixtures.mjs';
45
46
  import {
46
47
  REPLAN_STALE_SIGNATURE,
@@ -678,6 +679,7 @@ export const ENTRIES = [
678
679
  {
679
680
  name: '285 ui-design 门四类:前端齐备放行 / 前端缺件 BLOCK / 非前端可见跳过 / 旧 change WARN',
680
681
  run: (dir) => {
682
+ writeNodeDeclarationMarkers(dir, 'design', { frontend: true });
681
683
  // 正例:前端(「视觉调性」段在场且未标注不适用)+ 工件齐备 + 真实声明
682
684
  writeDesignExitFixture(dir, {
683
685
  newChange: true, visualTone: VISUAL_TONE_APPLICABLE, uiDesign: true, declareUiDesign: true,
@@ -888,6 +890,7 @@ export const ENTRIES = [
888
890
  {
889
891
  name: '288 ui-design 门按协议绑定键控:删绑定门退场(可见行)/ 在场仍拦 / 其它绑定零改动 / 写回即恢复',
890
892
  run: (dir) => {
893
+ writeNodeDeclarationMarkers(dir, 'design', { frontend: true });
891
894
  // 负例:协议删掉该绑定 → 前端判据成立且缺件也不再拦(门随绑定退场)
892
895
  writeUiDesignBindingVariant(dir, 'absent');
893
896
  writeDesignExitFixture(dir, {
@@ -936,6 +939,7 @@ export const ENTRIES = [
936
939
  {
937
940
  name: '289 ui-design 门按协议等级键控:调回 advisory 不再拦且自动补写原语义 / 写回 guarded 即恢复',
938
941
  run: (dir) => {
942
+ writeNodeDeclarationMarkers(dir, 'design', { frontend: true });
939
943
  // 负例:等级调回 advisory → 缺工件 + 零真实声明也放行(自动补写保持原语义)
940
944
  writeUiDesignBindingVariant(dir, 'advisory');
941
945
  writeDesignExitFixture(dir, {
@@ -984,6 +988,7 @@ export const ENTRIES = [
984
988
  {
985
989
  name: '290 负向标记结构约束:独立行·行首·字段值位跳过并回显片段 / 自然句子·子维度字段·段外标记不关闸',
986
990
  run: (dir) => {
991
+ writeNodeDeclarationMarkers(dir, 'design', { frontend: true });
987
992
  // 负例:自然句子(标记词在行首且后接「于」,句内再出现一次)→ 判据仍是前端 ⇒ 缺件 BLOCKED
988
993
  writeDesignExitFixture(dir, {
989
994
  newChange: true, visualTone: VISUAL_TONE_NATURAL_SENTENCE, uiDesign: false, declareUiDesign: true,