flow-comet 1.6.4 → 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.
- package/.flow-comet/skills/flow-comet/INSTALLED_VERSION +1 -1
- package/.flow-comet/skills/flow-comet/SKILL.md +36 -6
- package/.flow-comet/skills/flow-comet/reference/artifact-template-overlay.md +154 -0
- package/.flow-comet/skills/flow-comet/reference/artifact-templates.json +387 -0
- package/.flow-comet/skills/flow-comet/reference/commit-discipline.md +1 -1
- package/.flow-comet/skills/flow-comet/reference/entry-detail.md +29 -4
- package/.flow-comet/skills/flow-comet/reference/workflow-protocol.json +22 -0
- package/.flow-comet/skills/flow-comet/scripts/context-init.mjs +26 -23
- package/.flow-comet/skills/flow-comet/scripts/evolve.mjs +174 -0
- package/.flow-comet/skills/flow-comet/scripts/guard-self-test.mjs +17 -95
- package/.flow-comet/skills/flow-comet/scripts/health.mjs +28 -4
- package/.flow-comet/skills/flow-comet/scripts/items/a.mjs +136 -19
- package/.flow-comet/skills/flow-comet/scripts/items/b.mjs +54 -18
- package/.flow-comet/skills/flow-comet/scripts/items/c.mjs +6 -6
- package/.flow-comet/skills/flow-comet/scripts/items/e.mjs +52 -10
- package/.flow-comet/skills/flow-comet/scripts/items/h.mjs +25 -10
- package/.flow-comet/skills/flow-comet/scripts/items/l.mjs +4 -2
- package/.flow-comet/skills/flow-comet/scripts/items/m.mjs +21 -13
- package/.flow-comet/skills/flow-comet/scripts/items/n.mjs +163 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/ac-coverage.mjs +317 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-artifact-skeleton.mjs +448 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-evidence-gates.mjs +396 -27
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-gates.mjs +1035 -172
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-routing.mjs +129 -98
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-state-io.mjs +8 -6
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-template-fidelity.mjs +797 -232
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-uidesign.mjs +91 -22
- package/.flow-comet/skills/flow-comet/scripts/lib/lessons-hits.mjs +160 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/run-root.mjs +21 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/section-body.mjs +92 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-admin.mjs +69 -13
- package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-flow.mjs +454 -135
- package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-recovery.mjs +66 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-explain.mjs +109 -13
- package/.flow-comet/skills/flow-comet/scripts/lib/state-io.mjs +55 -2
- package/.flow-comet/skills/flow-comet/scripts/lib/state-skillmarkers.mjs +149 -34
- package/.flow-comet/skills/flow-comet/scripts/lib/system-fixtures.mjs +79 -9
- package/.flow-comet/skills/flow-comet/scripts/lib/task-graph.mjs +84 -31
- package/.flow-comet/skills/flow-comet/scripts/lib/test-fixtures.mjs +78 -8
- package/.flow-comet/skills/flow-comet/scripts/lib/test-helpers.mjs +60 -3
- package/.flow-comet/skills/flow-comet/scripts/lib/text-anchor-checks.mjs +167 -3
- package/.flow-comet/skills/flow-comet/scripts/lib/wave-projection.mjs +341 -0
- package/.flow-comet/skills/flow-comet/scripts/protocol-utils.mjs +287 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/a.mjs +1454 -16
- package/.flow-comet/skills/flow-comet/scripts/scenarios/b.mjs +1202 -8
- package/.flow-comet/skills/flow-comet/scripts/scenarios/c.mjs +1205 -77
- package/.flow-comet/skills/flow-comet/scripts/scenarios/d.mjs +753 -5
- package/.flow-comet/skills/flow-comet/scripts/scenarios/e.mjs +52 -11
- package/.flow-comet/skills/flow-comet/scripts/scenarios/f.mjs +582 -3
- package/.flow-comet/skills/flow-comet/scripts/scenarios/g.mjs +9 -1
- package/.flow-comet/skills/flow-comet/scripts/scenarios/i.mjs +5 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/j.mjs +22 -6
- package/.flow-comet/skills/flow-comet/scripts/scenarios/k.mjs +2 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/l.mjs +18 -5
- package/.flow-comet/skills/flow-comet/scripts/scenarios/n.mjs +4100 -0
- package/.flow-comet/skills/flow-comet/scripts/state-schema.mjs +135 -0
- package/.flow-comet/skills/flow-comet/scripts/system-test.mjs +6 -5
- package/.flow-comet/skills/flow-comet/scripts/workflow-guard.mjs +203 -4
- package/.flow-comet/skills/flow-comet/scripts/workflow-handoff.mjs +312 -63
- package/.flow-comet/skills/flow-comet/scripts/workflow-state.mjs +5 -2
- package/.flow-comet/skills/flow-comet-archive/SKILL.md +6 -2
- package/.flow-comet/skills/flow-comet-change/SKILL.md +6 -2
- package/.flow-comet/skills/flow-comet-design/GUIDANCE.md +13 -3
- package/.flow-comet/skills/flow-comet-design/SKILL.md +15 -8
- package/.flow-comet/skills/flow-comet-dev/SKILL.md +1 -1
- package/.flow-comet/skills/flow-comet-evolve/SKILL.md +1 -0
- package/.flow-comet/skills/flow-comet-execute/SKILL.md +42 -15
- package/.flow-comet/skills/flow-comet-health/SKILL.md +1 -1
- package/.flow-comet/skills/flow-comet-integration/SKILL.md +1 -1
- package/.flow-comet/skills/flow-comet-open/GUIDANCE.md +14 -4
- package/.flow-comet/skills/flow-comet-open/SKILL.md +11 -9
- package/.flow-comet/skills/flow-comet-plan/GUIDANCE.md +13 -3
- package/.flow-comet/skills/flow-comet-plan/SKILL.md +21 -10
- package/.flow-comet/skills/flow-comet-requirement/SKILL.md +1 -1
- package/.flow-comet/skills/flow-comet-review/SKILL.md +33 -18
- package/.flow-comet/skills/flow-comet-subagent-execute/GUIDANCE.md +13 -3
- package/.flow-comet/skills/flow-comet-subagent-execute/SKILL.md +44 -16
- package/.flow-comet/skills/flow-comet-task/SKILL.md +3 -2
- package/.flow-comet/skills/flow-comet-test/SKILL.md +6 -2
- package/.flow-comet/skills/flow-comet-ui-design/SKILL.md +2 -2
- package/.flow-comet/skills/flow-comet-verify/SKILL.md +12 -8
- package/README.md +3 -3
- package/package.json +1 -1
- package/scripts/dsh-bridge.mjs +2 -2
- package/scripts/lib/installer-flowkit.mjs +43 -3
|
@@ -376,8 +376,16 @@ export const ENTRIES = [
|
|
|
376
376
|
fs.rmSync(outsideDir, { recursive: true, force: true });
|
|
377
377
|
}
|
|
378
378
|
// ③ 请求无资格(glob)+ 契约声称 noCommit → 仍完整提交文件子集校验(越界新 change BLOCK)
|
|
379
|
+
// 夹具前提:result 必须有对应 request(缺 request 在写盘前就被拦,走不到子集校验)。② 段多次
|
|
380
|
+
// 重置 state(e.mjs 上方 ② 的 baseState 写入)后 T02 的 request 已丢失,这里补回 ②a 那条 T02
|
|
381
|
+
// request 的结论形态——write_files 非空(glob,无零提交资格)——本段要验证的仍是
|
|
382
|
+
// 「零提交声明不能绕过真实提交检查」,不是缺 request 的拦截。
|
|
379
383
|
const stIneligible = JSON.parse(fs.readFileSync(path.join(dir, '.flow-comet', 'flow-comet-state.json'), 'utf8'));
|
|
380
384
|
stIneligible.newChange = true;
|
|
385
|
+
stIneligible.evidence['subagent-execute'].handoffRequests = {
|
|
386
|
+
...stIneligible.evidence['subagent-execute'].handoffRequests,
|
|
387
|
+
T02: { description: 'glob boundary slice', writeFiles: ['src/gen/*.mjs'] },
|
|
388
|
+
};
|
|
381
389
|
writeState(dir, stIneligible);
|
|
382
390
|
writeFile(dir, 'src/deep/rogue.js', 'export const deepRogue = 1;\n');
|
|
383
391
|
g(['add', 'src/deep/rogue.js']);
|
|
@@ -419,7 +427,8 @@ export const ENTRIES = [
|
|
|
419
427
|
what: '## 做了什么\n\n实现 T01(TDD:先写失败场景再实现)。',
|
|
420
428
|
files: '## 改动文件\n\n| 文件 | 性质 | 说明 |\n|---|---|---|\n| src/t1.mjs | 修改 | 实现 T01 |',
|
|
421
429
|
verify: '## verify 输出\n\n```\nnode --check src/t1.mjs\n```',
|
|
422
|
-
sixDim: '## 6 维自查\n\n- 功能: 通过(brooks-review 已跑)\n- 性能: 无影响\n- 安全: 无影响\n- 兼容: 通过\n- 可观测: 通过\n- 可维护: 通过'
|
|
430
|
+
sixDim: '## 6 维自查\n\n- 功能: 通过(brooks-review 已跑)\n- 性能: 无影响\n- 安全: 无影响\n- 兼容: 通过\n- 可观测: 通过\n- 可维护: 通过'
|
|
431
|
+
+ '\n\n### 已知接受 + 理由\n\n- 无(夹具)。\n\n### 已知小问题\n\n- 无(夹具)。',
|
|
423
432
|
db: '## 数据库迁移\n\nN/A:本任务无 schema 变更。',
|
|
424
433
|
bounds: '## 越界检查\n\n仅修改 src/t1.mjs,无越界。',
|
|
425
434
|
breaking: '## 破坏性变更\n\nN/A:本任务不涉及破坏性变更。',
|
|
@@ -427,17 +436,26 @@ export const ENTRIES = [
|
|
|
427
436
|
newWork: '## 是否触发新工作\n\n无。',
|
|
428
437
|
done: '## 完成判定\n\n- TASK.md 中对应任务已勾选:是',
|
|
429
438
|
method: '## 自检方法\n\nbrooks-review',
|
|
439
|
+
// LESSONS 扫描 = 登记的增量段(位于自检方法之后或文末)——SUMMARY 出口的必填增量段,
|
|
440
|
+
// 夹具缺它会被增量段门禁拦下,掩盖本场景被测的标题/首部/段序判据。
|
|
441
|
+
lessons: '## LESSONS 扫描\n\n无 active 条目命中(夹具)。',
|
|
430
442
|
};
|
|
431
443
|
// 模板序 = flow-kit/templates/SUMMARY.md 全部 H2(含 5 个条件段);## 自检方法 不属骨架,
|
|
432
|
-
//
|
|
444
|
+
// 单独按位置校核(紧随 ## 越界检查、或位于骨架段全部之后两种合法位置;其后允许跟登记的
|
|
445
|
+
// 增量段 ## LESSONS 扫描)。
|
|
433
446
|
const skeletonOrder = [sectionText.what, sectionText.files, sectionText.verify, sectionText.sixDim,
|
|
434
447
|
sectionText.db, sectionText.bounds, sectionText.breaking, sectionText.deviation, sectionText.newWork, sectionText.done];
|
|
435
|
-
const fullSections = [...skeletonOrder, sectionText.method]; //
|
|
436
|
-
const afterBoundsSections = [
|
|
437
|
-
|
|
438
|
-
|
|
448
|
+
const fullSections = [...skeletonOrder, sectionText.method, sectionText.lessons]; // 自检方法在骨架段之后(合法位置一)
|
|
449
|
+
const afterBoundsSections = [
|
|
450
|
+
...skeletonOrder.slice(0, 6), sectionText.method, sectionText.lessons, ...skeletonOrder.slice(6),
|
|
451
|
+
]; // 紧随越界(合法位置二)
|
|
452
|
+
const illegalSelfSections = [
|
|
453
|
+
...skeletonOrder.slice(0, 4), sectionText.method, sectionText.lessons, ...skeletonOrder.slice(4),
|
|
454
|
+
]; // 自检方法夹在中间(非法)
|
|
455
|
+
const missingTailSections = [...skeletonOrder.slice(0, 9), sectionText.method, sectionText.lessons]; // 缺尾段 完成判定
|
|
439
456
|
const outOfOrderSections = [
|
|
440
|
-
...skeletonOrder.slice(0, 5), sectionText.bounds, sectionText.db, ...skeletonOrder.slice(6),
|
|
457
|
+
...skeletonOrder.slice(0, 5), sectionText.bounds, sectionText.db, ...skeletonOrder.slice(6),
|
|
458
|
+
sectionText.method, sectionText.lessons,
|
|
441
459
|
]; // 数据库迁移排到越界检查之后(段序偏离)
|
|
442
460
|
const compose = (title, order) =>
|
|
443
461
|
[title, '', header, '', '---', '', order.join('\n\n')].join('\n');
|
|
@@ -469,7 +487,7 @@ export const ENTRIES = [
|
|
|
469
487
|
assertOut(res2, 'BLOCKED');
|
|
470
488
|
// ③ 新 change:段序乱(自检方法提前、做了什么滞后)→ BLOCK
|
|
471
489
|
const scrambled = [
|
|
472
|
-
sectionText.verify, sectionText.bounds, sectionText.sixDim, sectionText.method,
|
|
490
|
+
sectionText.verify, sectionText.bounds, sectionText.sixDim, sectionText.method, sectionText.lessons,
|
|
473
491
|
sectionText.what, sectionText.files, sectionText.db, sectionText.breaking,
|
|
474
492
|
sectionText.deviation, sectionText.newWork, sectionText.done,
|
|
475
493
|
];
|
|
@@ -642,10 +660,14 @@ export const ENTRIES = [
|
|
|
642
660
|
{
|
|
643
661
|
name: '161 open/design 出口三文档模板保真:缺标题新 BLOCK / 旧 WARN',
|
|
644
662
|
run: (dir) => {
|
|
663
|
+
// open 该读两份协议、声明两个必需技能(flow-comet-change / flow-comet-requirement):出口覆盖
|
|
664
|
+
// 判据要求全部声明,两条标记都要写下——否则先被声明门拦下,测不到本场景的被测判据。
|
|
645
665
|
const addOpenMarker = () => {
|
|
646
666
|
fs.mkdirSync(path.join(dir, '.specs', CHANGE_ID, '.skill-loads'), { recursive: true });
|
|
647
667
|
writeFile(dir, '.specs/' + CHANGE_ID + '/.skill-loads/open-flow-comet-change.json',
|
|
648
668
|
JSON.stringify({ node: 'open', skill: 'flow-comet-change', protocol: '0-change.md', at: '2026-08-01T00:00:00.000Z' }, null, 2) + '\n');
|
|
669
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/.skill-loads/open-flow-comet-requirement.json',
|
|
670
|
+
JSON.stringify({ node: 'open', skill: 'flow-comet-requirement', protocol: '1-requirement.md', at: '2026-08-01T00:00:00.000Z' }, null, 2) + '\n');
|
|
649
671
|
};
|
|
650
672
|
const addDesignMarker = () => {
|
|
651
673
|
fs.mkdirSync(path.join(dir, '.specs', CHANGE_ID, '.skill-loads'), { recursive: true });
|
|
@@ -756,7 +778,11 @@ export const ENTRIES = [
|
|
|
756
778
|
const resSerial = runHandoff(['request', 'S01', 'serial slice'], dir, env);
|
|
757
779
|
assertExit(resSerial, 1);
|
|
758
780
|
assertOut(resSerial, 'BLOCKED: 任务 S01(串行 pending)应归属节点 execute');
|
|
759
|
-
|
|
781
|
+
// 断言恢复指引的顺序句本身——「先对当前节点 record + exit」在前,entry 只在 exit
|
|
782
|
+
// 之后才允许。裸 'entry execute' 子串会被禁止句(不要在未 exit 前 entry 目标节点)满足,
|
|
783
|
+
// 等于分不清「让你 entry」与「禁止现在 entry」。
|
|
784
|
+
assertOut(resSerial, '先对当前节点 subagent-execute record + exit');
|
|
785
|
+
assertOut(resSerial, '不要在未 exit 前 entry 目标节点');
|
|
760
786
|
if (fs.readFileSync(statePath, 'utf8') !== beforeSerial) {
|
|
761
787
|
throw new Error('串行错配 BLOCK 必须 state 字节零改写');
|
|
762
788
|
}
|
|
@@ -769,6 +795,17 @@ export const ENTRIES = [
|
|
|
769
795
|
assertExit(resNotEntered, 0);
|
|
770
796
|
assertOut(resNotEntered, 'WARN: 任务 S02 的归属节点 execute 与原始 currentNode 一致');
|
|
771
797
|
assertOut(resNotEntered, '尚未 entry');
|
|
798
|
+
// 报文须点明缺的是哪个节点的 entry(只说「尚未 entry」等于让人自己猜),并给出可照抄的恢复
|
|
799
|
+
// 动作:两条 entry 命令(状态命令族与门禁族)按节点名给全;且这是 WARN 不是 BLOCK——
|
|
800
|
+
// 请求照常落库(与⑤的 BLOCK 分支成对:同一门禁的两种判级各自的可观测结果都要在场)。
|
|
801
|
+
assertOut(resNotEntered, 'enteredNodes 缺 execute');
|
|
802
|
+
assertOut(resNotEntered, 'workflow-state entry execute');
|
|
803
|
+
assertOut(resNotEntered, 'workflow-guard entry execute');
|
|
804
|
+
assertNotOut(resNotEntered, 'BLOCKED');
|
|
805
|
+
const recNotEntered = readScenarioState(dir).evidence?.['subagent-execute']?.handoffRequests?.S02;
|
|
806
|
+
if (!recNotEntered) {
|
|
807
|
+
throw new Error('未 entry 的 WARN 不应阻断落库,实际 handoffRequests.S02: ' + JSON.stringify(recNotEntered));
|
|
808
|
+
}
|
|
772
809
|
assertOut(resNotEntered, 'HANDOFF REQUEST: S02');
|
|
773
810
|
// ⑦ done 任务补录(非 pending)→ 归属门禁跳过,不误伤
|
|
774
811
|
writeFile(dir, '.specs/' + CHANGE_ID + '/TASK.md', taskXml('D01', 'parallel="true" status="done"', 'src/d01.mjs'));
|
|
@@ -1342,15 +1379,19 @@ export const ENTRIES = [
|
|
|
1342
1379
|
},
|
|
1343
1380
|
|
|
1344
1381
|
// 171: 入口文档首部 Change ID 新 change 强制——标题/段序合规但缺 `- **Change ID**:`
|
|
1345
|
-
// 首部字段:新 change open 出口 BLOCKED
|
|
1382
|
+
// 首部字段:新 change open 出口 BLOCKED(模板保真门的文案「首部缺字段: Change ID」);旧 change WARN 渐进。
|
|
1346
1383
|
// (对齐 AC「标题·首部·段序」统一强制口径——此前仅 softWarning 与承诺不符。)
|
|
1347
1384
|
{
|
|
1348
1385
|
name: '171 入口首部 Change ID 新 BLOCK / 旧 WARN',
|
|
1349
1386
|
run: (dir) => {
|
|
1387
|
+
// open 该读两份协议、声明两个必需技能(flow-comet-change / flow-comet-requirement):出口覆盖
|
|
1388
|
+
// 判据要求全部声明,两条标记都要写下——否则先被声明门拦下,测不到本场景的被测判据。
|
|
1350
1389
|
const addOpenMarker = () => {
|
|
1351
1390
|
fs.mkdirSync(path.join(dir, '.specs', CHANGE_ID, '.skill-loads'), { recursive: true });
|
|
1352
1391
|
writeFile(dir, '.specs/' + CHANGE_ID + '/.skill-loads/open-flow-comet-change.json',
|
|
1353
1392
|
JSON.stringify({ node: 'open', skill: 'flow-comet-change', protocol: '0-change.md', at: '2026-08-01T00:00:00.000Z' }, null, 2) + '\n');
|
|
1393
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/.skill-loads/open-flow-comet-requirement.json',
|
|
1394
|
+
JSON.stringify({ node: 'open', skill: 'flow-comet-requirement', protocol: '1-requirement.md', at: '2026-08-01T00:00:00.000Z' }, null, 2) + '\n');
|
|
1354
1395
|
};
|
|
1355
1396
|
const writeChange = (withId) => {
|
|
1356
1397
|
const head = withId ? '- **Change ID**: ' + CHANGE_ID + '\n' : '';
|
|
@@ -1368,7 +1409,7 @@ export const ENTRIES = [
|
|
|
1368
1409
|
const resBad = runGuard(['exit', 'open'], dir);
|
|
1369
1410
|
assertExit(resBad, 1);
|
|
1370
1411
|
assertOut(resBad, 'BLOCKED');
|
|
1371
|
-
assertOut(resBad, '
|
|
1412
|
+
assertOut(resBad, '首部缺字段: Change ID');
|
|
1372
1413
|
// ② 新 change 含首部字段 → 通过
|
|
1373
1414
|
writeChange(true);
|
|
1374
1415
|
const resGood = runGuard(['exit', 'open'], dir);
|