flow-comet 1.6.5 → 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.
- package/.flow-comet/skills/flow-comet/INSTALLED_VERSION +1 -1
- package/.flow-comet/skills/flow-comet/SKILL.md +32 -18
- package/.flow-comet/skills/flow-comet/reference/commit-discipline.md +2 -2
- package/.flow-comet/skills/flow-comet/reference/decision-points.md +5 -5
- package/.flow-comet/skills/flow-comet/reference/dirty-worktree.md +1 -1
- package/.flow-comet/skills/flow-comet/reference/entry-detail.md +30 -11
- package/.flow-comet/skills/flow-comet/reference/fix-loop.md +4 -4
- package/.flow-comet/skills/flow-comet/reference/init-detection.md +1 -1
- package/.flow-comet/skills/flow-comet/reference/platform-facts.md +2 -2
- package/.flow-comet/skills/flow-comet/reference/post-archive-handoff.md +264 -0
- package/.flow-comet/skills/flow-comet/reference/recovery.md +1 -1
- package/.flow-comet/skills/flow-comet/reference/replan.md +1 -1
- package/.flow-comet/skills/flow-comet/scripts/comet-check.mjs +1 -0
- package/.flow-comet/skills/flow-comet/scripts/comet-hook-guard.mjs +270 -30
- package/.flow-comet/skills/flow-comet/scripts/context-init.mjs +26 -23
- package/.flow-comet/skills/flow-comet/scripts/guard-self-test.mjs +14 -94
- package/.flow-comet/skills/flow-comet/scripts/items/a.mjs +122 -11
- package/.flow-comet/skills/flow-comet/scripts/items/b.mjs +79 -40
- package/.flow-comet/skills/flow-comet/scripts/items/c.mjs +11 -9
- package/.flow-comet/skills/flow-comet/scripts/items/e.mjs +52 -10
- package/.flow-comet/skills/flow-comet/scripts/items/f.mjs +1 -1
- package/.flow-comet/skills/flow-comet/scripts/items/h.mjs +128 -56
- package/.flow-comet/skills/flow-comet/scripts/items/k.mjs +357 -3
- package/.flow-comet/skills/flow-comet/scripts/items/l.mjs +26 -1
- package/.flow-comet/skills/flow-comet/scripts/items/m.mjs +6 -2
- package/.flow-comet/skills/flow-comet/scripts/items/n.mjs +29 -21
- package/.flow-comet/skills/flow-comet/scripts/lib/ac-coverage.mjs +317 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/fix-loop-node.mjs +4 -15
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-artifact-skeleton.mjs +47 -5
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-evidence-gates.mjs +357 -219
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-gates.mjs +725 -309
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-routing.mjs +182 -54
- 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 +224 -83
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-uidesign.mjs +17 -28
- 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 +61 -33
- package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-flow.mjs +663 -205
- package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-recovery.mjs +68 -9
- package/.flow-comet/skills/flow-comet/scripts/lib/state-determine.mjs +11 -4
- package/.flow-comet/skills/flow-comet/scripts/lib/state-explain.mjs +92 -13
- package/.flow-comet/skills/flow-comet/scripts/lib/state-io.mjs +232 -11
- package/.flow-comet/skills/flow-comet/scripts/lib/state-skillmarkers.mjs +140 -74
- package/.flow-comet/skills/flow-comet/scripts/lib/system-fixtures.mjs +8 -4
- package/.flow-comet/skills/flow-comet/scripts/lib/task-graph.mjs +84 -31
- package/.flow-comet/skills/flow-comet/scripts/lib/test-assertions.mjs +0 -3
- package/.flow-comet/skills/flow-comet/scripts/lib/test-fixtures.mjs +248 -24
- package/.flow-comet/skills/flow-comet/scripts/lib/test-helpers.mjs +63 -3
- package/.flow-comet/skills/flow-comet/scripts/lib/text-anchor-checks.mjs +181 -8
- package/.flow-comet/skills/flow-comet/scripts/lib/wave-projection.mjs +340 -0
- package/.flow-comet/skills/flow-comet/scripts/protocol-utils.mjs +132 -20
- package/.flow-comet/skills/flow-comet/scripts/route-node.mjs +12 -5
- package/.flow-comet/skills/flow-comet/scripts/scenarios/a.mjs +1564 -54
- package/.flow-comet/skills/flow-comet/scripts/scenarios/b.mjs +1489 -38
- package/.flow-comet/skills/flow-comet/scripts/scenarios/c.mjs +1466 -243
- package/.flow-comet/skills/flow-comet/scripts/scenarios/d.mjs +743 -24
- package/.flow-comet/skills/flow-comet/scripts/scenarios/e.mjs +220 -92
- package/.flow-comet/skills/flow-comet/scripts/scenarios/f.mjs +657 -21
- package/.flow-comet/skills/flow-comet/scripts/scenarios/g.mjs +41 -27
- package/.flow-comet/skills/flow-comet/scripts/scenarios/h.mjs +285 -9
- package/.flow-comet/skills/flow-comet/scripts/scenarios/i.mjs +7 -6
- package/.flow-comet/skills/flow-comet/scripts/scenarios/j.mjs +21 -15
- package/.flow-comet/skills/flow-comet/scripts/scenarios/k.mjs +8 -5
- package/.flow-comet/skills/flow-comet/scripts/scenarios/l.mjs +45 -36
- package/.flow-comet/skills/flow-comet/scripts/scenarios/m.mjs +2 -2
- package/.flow-comet/skills/flow-comet/scripts/scenarios/n.mjs +2381 -85
- package/.flow-comet/skills/flow-comet/scripts/state-schema.mjs +135 -2
- package/.flow-comet/skills/flow-comet/scripts/workflow-guard.mjs +143 -16
- package/.flow-comet/skills/flow-comet/scripts/workflow-handoff.mjs +339 -103
- package/.flow-comet/skills/flow-comet/scripts/workflow-state.mjs +5 -2
- package/.flow-comet/skills/flow-comet-archive/SKILL.md +33 -11
- package/.flow-comet/skills/flow-comet-change/SKILL.md +1 -1
- package/.flow-comet/skills/flow-comet-design/SKILL.md +5 -3
- package/.flow-comet/skills/flow-comet-dev/SKILL.md +2 -2
- package/.flow-comet/skills/flow-comet-execute/SKILL.md +37 -13
- package/.flow-comet/skills/flow-comet-integration/SKILL.md +10 -4
- package/.flow-comet/skills/flow-comet-plan/GUIDANCE.md +1 -1
- package/.flow-comet/skills/flow-comet-plan/SKILL.md +13 -6
- package/.flow-comet/skills/flow-comet-review/SKILL.md +21 -12
- package/.flow-comet/skills/flow-comet-subagent-execute/GUIDANCE.md +1 -1
- package/.flow-comet/skills/flow-comet-subagent-execute/SKILL.md +43 -18
- package/.flow-comet/skills/flow-comet-task/SKILL.md +4 -2
- package/.flow-comet/skills/flow-comet-ui-design/SKILL.md +2 -2
- package/.flow-comet/skills/flow-comet-verify/SKILL.md +1 -1
- package/README.md +2 -2
- package/package.json +1 -1
- package/scripts/dsh-bridge.mjs +238 -21
|
@@ -12,18 +12,24 @@
|
|
|
12
12
|
|
|
13
13
|
import fs from 'fs';
|
|
14
14
|
import path from 'path';
|
|
15
|
-
import { spawnSync } from 'child_process';
|
|
16
15
|
import { createHash } from 'crypto';
|
|
16
|
+
import { spawnSync } from 'child_process';
|
|
17
17
|
import { fileURLToPath, pathToFileURL } from 'url';
|
|
18
18
|
import {
|
|
19
19
|
assertExit,
|
|
20
20
|
assertOut,
|
|
21
21
|
copyTreePortable,
|
|
22
|
+
makeTmp as sharedMakeTmp,
|
|
22
23
|
runGuard,
|
|
23
24
|
runState,
|
|
24
25
|
writeFile,
|
|
25
|
-
makeTmp as sharedMakeTmp,
|
|
26
26
|
} from './test-helpers.mjs';
|
|
27
|
+
import {
|
|
28
|
+
declarationSkillTargets,
|
|
29
|
+
guardedDeclarationSkills,
|
|
30
|
+
nodePromptFiles,
|
|
31
|
+
nodeTemplateDeclaration,
|
|
32
|
+
} from '../protocol-utils.mjs';
|
|
27
33
|
|
|
28
34
|
// 本模块位于 `<技能包>/scripts/lib/` ⇒ 脚本目录是它的上一级;技能树内所有兄弟脚本路径
|
|
29
35
|
// (GUARD / STATE / HOOK / HANDOFF / 侧命令 / 内置协议副本)一律由它拼接,调用面不再各拼一遍。
|
|
@@ -45,15 +51,65 @@ export const REPO_ROOT = path.resolve(SCRIPTS_DIR, '..', '..', '..', '..');
|
|
|
45
51
|
// 其 .flow-comet/ 只是运行时目录,无 skills/flow-comet/SKILL.md)——与安装器自身判定同判据
|
|
46
52
|
// (prepare-env.mjs 的 gitignore 纳管跳过分支)。
|
|
47
53
|
export const AUTHORITATIVE_SOURCE_ANCHOR = path.join(REPO_ROOT, '.flow-comet', 'skills', 'flow-comet', 'SKILL.md');
|
|
48
|
-
export function isAuthoritativeSourceRepo() {
|
|
49
|
-
return fs.existsSync(AUTHORITATIVE_SOURCE_ANCHOR);
|
|
50
|
-
}
|
|
51
54
|
// 权威源仓库脚本位于仓库根 scripts/prepare-env.mjs;安装副本无此脚本,场景跳过
|
|
52
55
|
export const PREPARE_ENV = path.join(REPO_ROOT, 'scripts', 'prepare-env.mjs');
|
|
53
56
|
// 内置协议源文件(packageRoot/reference/):场景复制到 <tmpdir>/reference/ 内(protected-path 要求 runRoot 内)
|
|
54
57
|
export const BUILTIN_PROTOCOL_SOURCE = path.join(SCRIPTS_DIR, '..', 'reference', 'workflow-protocol.json');
|
|
55
58
|
export const CHANGE_ID = 'ch';
|
|
56
59
|
|
|
60
|
+
// 节点声明标记夹具(唯一构造处):按协议派生「该节点该声明哪些技能」「该节点该读哪些协议文件」,
|
|
61
|
+
// 为每个必需技能写一条 `<node>-<skill>.json` 标记——每条的 protocols 都覆盖该节点**全部**协议文件,
|
|
62
|
+
// 等价于一次带多个 `--prompt` 的真实 skill-load(真实流程里协调者声明、record 自动补写,夹具直接
|
|
63
|
+
// 写 state 时这两步都不发生,必须由夹具补上同一份事实)。
|
|
64
|
+
//
|
|
65
|
+
// 与被测判据同源(protocol-utils 的 declarationSkillTargets / guardedDeclarationSkills / nodePromptFiles),
|
|
66
|
+
// 不手抄清单:协议面演进时夹具跟着变,不会退化成「夹具写死一份旧清单」。
|
|
67
|
+
//
|
|
68
|
+
// 适用边界(契约,负例不得走这里):
|
|
69
|
+
// · 只写**本节点**的必需标记:其它节点的标记不写——「跨节点标记不算数」仍由显式负例判;
|
|
70
|
+
// · 条件绑定的技能(design 的 flow-comet-ui-design)默认不写(非前端 change 本就不要求声明它);
|
|
71
|
+
// 前端夹具传 `frontend: true`,与其它 guarded 技能同权;
|
|
72
|
+
// · 不写多余标记:不进额外技能、不写额外协议文件清单——「多声明也不顶替缺项」仍由显式负例判;
|
|
73
|
+
// · 声明门自身的负例(目录整体缺席 / 缺某个技能 / 旧单值标记)一律显式删目录或显式写标记,
|
|
74
|
+
// 不走本 helper——否则负例被 helper 补齐后就测不到那道门了。
|
|
75
|
+
export function writeNodeDeclarationMarkers(dir, nodeId, { changeId = CHANGE_ID, frontend = false, skills = null } = {}) {
|
|
76
|
+
const protocol = JSON.parse(fs.readFileSync(SKILL_PROTOCOL_FILE, 'utf8'));
|
|
77
|
+
const node = (protocol.nodes ?? []).find((item) => item && item.id === nodeId);
|
|
78
|
+
if (node === undefined) throw new Error('夹具构造失败:协议里没有节点 ' + nodeId);
|
|
79
|
+
// 目标集与出口覆盖门的取用面同源:`declarationSkillTargets` = guarded 必需技能(条件绑定不在
|
|
80
|
+
// 同步面展开),一个都不剩时退到该节点的实现技能——subagent-execute 这类「技能全划给子代理」
|
|
81
|
+
// 的节点,出口仍要求声明 4-dev.md,声明就挂在实现技能名下(与恢复段打印的命令同一个技能名)。
|
|
82
|
+
// 前端夹具(design 的 ui-design 判据成立)把条件绑定的技能一并声明。
|
|
83
|
+
const targets = skills ?? (frontend
|
|
84
|
+
? guardedDeclarationSkills(node)
|
|
85
|
+
: declarationSkillTargets(node));
|
|
86
|
+
const files = nodePromptFiles(node);
|
|
87
|
+
for (const skill of targets) {
|
|
88
|
+
writeFile(dir, '.specs/' + changeId + '/.skill-loads/' + nodeId + '-' + skill + '.json',
|
|
89
|
+
JSON.stringify({
|
|
90
|
+
node: nodeId,
|
|
91
|
+
skill,
|
|
92
|
+
protocol: files[0] ?? null,
|
|
93
|
+
protocols: files,
|
|
94
|
+
// 模板声明清单(与节点映射一致):单轨下 record/exit 的模板声明门对一切 change 生效,
|
|
95
|
+
// 夹具若只写 node/skill 会被判「模板声明缺失」——标记必须与真实 skill-load 同形。
|
|
96
|
+
templates: nodeTemplateDeclaration(node).required,
|
|
97
|
+
at: '2026-08-01T00:00:00.000Z',
|
|
98
|
+
}, null, 2) + '\n');
|
|
99
|
+
}
|
|
100
|
+
return targets;
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
// 全部节点的声明标记(多节点路由场景的前置):单轨下每个节点的出口都要求本节点声明,
|
|
104
|
+
// 多趟场景会逐节点 exit —— 一次性把协议里每个节点的必需标记写齐,避免夹具逐节点补漏。
|
|
105
|
+
export function writeAllNodeDeclarationMarkers(dir, { changeId = CHANGE_ID } = {}) {
|
|
106
|
+
const protocol = JSON.parse(fs.readFileSync(SKILL_PROTOCOL_FILE, 'utf8'));
|
|
107
|
+
for (const node of protocol.nodes ?? []) {
|
|
108
|
+
if (!node || typeof node.id !== 'string') continue;
|
|
109
|
+
writeNodeDeclarationMarkers(dir, node.id, { changeId });
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
|
|
57
113
|
// 组件技能树布局感知(单一来源):本 suite 恒位于 <skillsRoot>/flow-comet/scripts/,
|
|
58
114
|
// 组件技能(flow-comet-execute / flow-comet-review / flow-comet-verify 等)是 <skillsRoot>
|
|
59
115
|
// 下的同级目录。权威源 checkout → <root>/.flow-comet/skills/;安装副本 → <目标>/.claude|
|
|
@@ -129,7 +185,8 @@ export function runPrepareEnv(args, root, envOverrides = {}) {
|
|
|
129
185
|
}
|
|
130
186
|
|
|
131
187
|
// 跑 workflow-state.mjs 的 bridge-check 只读子命令(T05 实现——六判定态健康/文件缺失/
|
|
132
|
-
//
|
|
188
|
+
// 未挂载/版本偏斜/重复注册/不适用)。运行根由唯一解析模块(run-root.mjs)给定:
|
|
189
|
+
// FLOW_COMET_RUN_ROOT 优先(夹具把该变量与 cwd 一并设为 root);协议副本须在 runRoot 内
|
|
133
190
|
// (protected-path)——指向运行器已复制到 <root>/reference/ 的内置协议副本
|
|
134
191
|
// (FLOW_COMET_PROTOCOL env 优先级高于默认,见 protocol-utils resolveProtocol)。
|
|
135
192
|
export function runBridgeCheck(root, dshHome) {
|
|
@@ -403,19 +460,36 @@ export function composeState(overrides = {}) {
|
|
|
403
460
|
};
|
|
404
461
|
}
|
|
405
462
|
|
|
406
|
-
// 完整 SUMMARY
|
|
407
|
-
//
|
|
408
|
-
//
|
|
409
|
-
//
|
|
463
|
+
// 完整 SUMMARY(**模板合规形态**:标题 + 首部 4 字段 + 模板段序 + 条件段标题在场)。
|
|
464
|
+
// 单轨下模板保真对一切 change 生效,夹具必须是合规形态——否则被测门禁还没轮到,工件先被结构门
|
|
465
|
+
// 拦下(夹具自身缺陷)。options.sixDim / options.method 可替换对应段体;method='' 表示去掉
|
|
466
|
+
// ## 自检方法 段(旧格式场景,用于测「段标题必须在场」这一判据本身)。
|
|
410
467
|
export function summaryContent(options = {}) {
|
|
411
468
|
const sixDim = options.sixDim !== undefined
|
|
412
469
|
? options.sixDim
|
|
413
|
-
: '## 6
|
|
470
|
+
: '## 6 维自查(生产代码改动必填 · 来自 4-dev 步骤 4)\n\n- 功能: 通过(brooks-review 已跑)\n- 性能: 无影响\n- 安全: 无影响\n- 兼容: 通过\n- 可观测: 通过\n- 可维护: 通过\n\n### 已知接受 + 理由(🟡 Major 项不修的)\n\n- 无(夹具)。\n\n### 已知小问题(🟢 Minor 项可省的)\n\n- 无(夹具)。';
|
|
414
471
|
const method = options.method !== undefined ? options.method : '## 自检方法\n\nbrooks-review';
|
|
415
472
|
return [
|
|
416
|
-
'# T01-
|
|
473
|
+
'# SUMMARY: T01 - 实现 T01',
|
|
417
474
|
'',
|
|
418
|
-
'
|
|
475
|
+
'- **Change ID**: ' + CHANGE_ID,
|
|
476
|
+
'- **Task ID**: T01',
|
|
477
|
+
'- **完成时间**: 2026-08-01 10:00',
|
|
478
|
+
'- **AI 角色**: Dev',
|
|
479
|
+
'',
|
|
480
|
+
'---',
|
|
481
|
+
'',
|
|
482
|
+
'## 做了什么(一段话)',
|
|
483
|
+
'',
|
|
484
|
+
'实现 T01。',
|
|
485
|
+
'',
|
|
486
|
+
'## 改动文件',
|
|
487
|
+
'',
|
|
488
|
+
'| 文件 | 性质 | 说明 |',
|
|
489
|
+
'|---|---|---|',
|
|
490
|
+
'| src/t1.mjs | 修改 | 实现 T01 |',
|
|
491
|
+
'',
|
|
492
|
+
'## verify 输出(必填)',
|
|
419
493
|
'',
|
|
420
494
|
'```',
|
|
421
495
|
'node --check src/t1.mjs',
|
|
@@ -423,17 +497,29 @@ export function summaryContent(options = {}) {
|
|
|
423
497
|
'',
|
|
424
498
|
sixDim,
|
|
425
499
|
'',
|
|
426
|
-
'##
|
|
500
|
+
'## 数据库迁移(涉及 schema 变更必填 · 来自 4-dev 步骤 1.7 / R4.5)',
|
|
501
|
+
'',
|
|
502
|
+
'N/A:本任务无 schema 变更。',
|
|
503
|
+
'',
|
|
504
|
+
'## 越界检查(必填 · 来自 4-dev 步骤 5 / R6.5 / B3 老项目护栏)',
|
|
427
505
|
'',
|
|
428
506
|
'仅修改 src/t1.mjs,无越界。',
|
|
429
507
|
'',
|
|
430
|
-
'##
|
|
508
|
+
'## 破坏性变更(涉及破坏性改动必填 · 来自 4-dev 步骤 1.8 / R4.6 / B4 老项目护栏)',
|
|
431
509
|
'',
|
|
432
|
-
'
|
|
510
|
+
'N/A:本任务不涉及破坏性变更。',
|
|
433
511
|
'',
|
|
434
|
-
'##
|
|
512
|
+
'## 决策与偏离(如有)',
|
|
513
|
+
'',
|
|
514
|
+
'无。',
|
|
515
|
+
'',
|
|
516
|
+
'## 是否触发新工作',
|
|
517
|
+
'',
|
|
518
|
+
'无。',
|
|
519
|
+
'',
|
|
520
|
+
'## 完成判定',
|
|
435
521
|
'',
|
|
436
|
-
'-
|
|
522
|
+
'- TASK.md 中对应任务已勾选:是',
|
|
437
523
|
'',
|
|
438
524
|
method,
|
|
439
525
|
'',
|
|
@@ -615,6 +701,7 @@ export const TASK_VALID_ALL_PARALLEL =
|
|
|
615
701
|
// ---------- 多趟路由场景任务集(多趟语义批次:依赖环拦截与缺失依赖拦截场景原位重写 + 尾部新增场景族) ----------
|
|
616
702
|
// 依赖环:P01↔P02 互为 depends_on(依赖图有环 → plan 出口 BLOCKED 含「依赖环」+ depends_on 恢复指引)
|
|
617
703
|
export const TASK_DEP_CYCLE =
|
|
704
|
+
'## 波次划分\n\nWave 1: P01, P02\n\n## 任务清单\n\n' +
|
|
618
705
|
'<task id="P01" parallel="true" status="pending"><action>实现 P01</action><write_files>src/p1.mjs</write_files><verify>node --check src/p1.mjs</verify><depends_on>P02</depends_on></task>\n' +
|
|
619
706
|
'<task id="P02" parallel="true" status="pending"><action>实现 P02</action><write_files>src/p2.mjs</write_files><verify>node --check src/p2.mjs</verify><depends_on>P01</depends_on></task>\n';
|
|
620
707
|
// 依赖缺失:P01 依赖不存在的 T99(依赖链不可满足 → plan 出口 BLOCKED 含恢复指引)
|
|
@@ -668,9 +755,13 @@ export const CROSS_TASK_FIX_SECTION_PAIR =
|
|
|
668
755
|
|
|
669
756
|
// 波次分组场景公共路径:注入 TASK.md → entry plan(记录 enteredNodes,新 change 强制先 entry;
|
|
670
757
|
// 旧 change 亦先 entry 避免 ENTER WARN 干扰断言)→ exit plan。返回 exit plan 结果。
|
|
758
|
+
// 新 change 的声明标记在这里补齐:真实流程里协调者 entry 时会 skill-load、record 会补写标记,
|
|
759
|
+
// 夹具直接写 state 时这两步都不发生——不补就会被「缺协议声明标记」先拦下,被测的波次判据根本
|
|
760
|
+
// 轮不到说话。声明门自身的负例不走本入口(它们直接 runGuard,且显式删目录/缺标记)。
|
|
671
761
|
export function runPlanExit(dir, taskContent) {
|
|
672
762
|
writeFile(dir, '.specs/' + CHANGE_ID + '/TASK.md', '# TASK\n\n## 任务清单\n\n' + taskContent);
|
|
673
763
|
assertExit(runGuard(['entry', 'plan'], dir), 0);
|
|
764
|
+
writeNodeDeclarationMarkers(dir, 'plan');
|
|
674
765
|
return runGuard(['exit', 'plan'], dir);
|
|
675
766
|
}
|
|
676
767
|
|
|
@@ -697,11 +788,141 @@ export function renderMultiWaveTasks(doneIds = []) {
|
|
|
697
788
|
'</task>\n').join('');
|
|
698
789
|
}
|
|
699
790
|
|
|
791
|
+
// 前序产物的**模板合规**文本(单一构造点):标题形态 + 首部字段 + 各段非空正文。
|
|
792
|
+
// 单轨下模板保真对一切 change 生效(段标题必须在场、正文不得为空),夹具必须给出合规形态——
|
|
793
|
+
// 否则被测门禁还没轮到,工件先被结构门拦下(夹具自身缺陷)。
|
|
794
|
+
export function intakeChangeText() {
|
|
795
|
+
return [
|
|
796
|
+
'# CHANGE: 夹具 change',
|
|
797
|
+
'',
|
|
798
|
+
'- **Change ID**: ' + CHANGE_ID,
|
|
799
|
+
'- **创建日期**: 2026-08-01',
|
|
800
|
+
'- **路径建议**: 中等',
|
|
801
|
+
'- **状态**: active',
|
|
802
|
+
'',
|
|
803
|
+
'---',
|
|
804
|
+
'',
|
|
805
|
+
'## Why(为什么做)',
|
|
806
|
+
'',
|
|
807
|
+
'夹具:说明为什么做。',
|
|
808
|
+
'',
|
|
809
|
+
'## What(做什么)',
|
|
810
|
+
'',
|
|
811
|
+
'夹具:说明做什么。',
|
|
812
|
+
'',
|
|
813
|
+
'## 影响面',
|
|
814
|
+
'',
|
|
815
|
+
'- [x] 仅修复 bug,无范围变化',
|
|
816
|
+
'',
|
|
817
|
+
'## 范围排除(这次不做)',
|
|
818
|
+
'',
|
|
819
|
+
'- 夹具不做的项。',
|
|
820
|
+
'',
|
|
821
|
+
'## 验收线(粗粒度,不是 AC)',
|
|
822
|
+
'',
|
|
823
|
+
'- 夹具验收线。',
|
|
824
|
+
'',
|
|
825
|
+
'## 风险与未知',
|
|
826
|
+
'',
|
|
827
|
+
'- 无',
|
|
828
|
+
'',
|
|
829
|
+
].join('\n');
|
|
830
|
+
}
|
|
831
|
+
|
|
832
|
+
export function intakeRequirementText() {
|
|
833
|
+
return [
|
|
834
|
+
'# REQUIREMENT: 夹具 change',
|
|
835
|
+
'',
|
|
836
|
+
'- **Change ID**: ' + CHANGE_ID,
|
|
837
|
+
'- **关联**: `@.specs/' + CHANGE_ID + '/CHANGE.md`',
|
|
838
|
+
'',
|
|
839
|
+
'---',
|
|
840
|
+
'',
|
|
841
|
+
'## 用户故事',
|
|
842
|
+
'',
|
|
843
|
+
'- **US-1**:作为执行者,我想让夹具成立,以便门禁可判。',
|
|
844
|
+
'',
|
|
845
|
+
'## 验收准则(AC)',
|
|
846
|
+
'',
|
|
847
|
+
'### AC-1 · 夹具准则',
|
|
848
|
+
'',
|
|
849
|
+
'- **Given** 前置',
|
|
850
|
+
'- **When** 动作',
|
|
851
|
+
'- **Then** 结果',
|
|
852
|
+
'- **验证方式**: 夹具',
|
|
853
|
+
'',
|
|
854
|
+
'---',
|
|
855
|
+
'',
|
|
856
|
+
'## 范围切分',
|
|
857
|
+
'',
|
|
858
|
+
'### v1(本次必做)',
|
|
859
|
+
'',
|
|
860
|
+
'- 夹具。',
|
|
861
|
+
'',
|
|
862
|
+
'### v2(下一轮考虑,不本次)',
|
|
863
|
+
'',
|
|
864
|
+
'- 无',
|
|
865
|
+
'',
|
|
866
|
+
'### out(永远不做)',
|
|
867
|
+
'',
|
|
868
|
+
'- 无',
|
|
869
|
+
'',
|
|
870
|
+
'---',
|
|
871
|
+
'',
|
|
872
|
+
'## 非功能性需求',
|
|
873
|
+
'',
|
|
874
|
+
'- **性能**: 无',
|
|
875
|
+
'- **安全**: 无',
|
|
876
|
+
'- **兼容性**: 无',
|
|
877
|
+
'- **可观测性**: 无',
|
|
878
|
+
'',
|
|
879
|
+
'## 依赖与假设',
|
|
880
|
+
'',
|
|
881
|
+
'- 无',
|
|
882
|
+
'',
|
|
883
|
+
].join('\n');
|
|
884
|
+
}
|
|
885
|
+
|
|
886
|
+
export function intakeDesignText() {
|
|
887
|
+
return [
|
|
888
|
+
'# DESIGN: 夹具 change',
|
|
889
|
+
'',
|
|
890
|
+
'- **Change ID**: ' + CHANGE_ID,
|
|
891
|
+
'- **关联**: `@.specs/' + CHANGE_ID + '/REQUIREMENT.md`',
|
|
892
|
+
'- **作者**: 夹具',
|
|
893
|
+
'',
|
|
894
|
+
'---',
|
|
895
|
+
'',
|
|
896
|
+
'## 0. 技术栈选定',
|
|
897
|
+
'',
|
|
898
|
+
'- **选定**:Node.js(ESM)',
|
|
899
|
+
'',
|
|
900
|
+
'## 1. 决策清单',
|
|
901
|
+
'',
|
|
902
|
+
'| # | 决策 | 备选 | 理由 | 代价 |',
|
|
903
|
+
'|---|---|---|---|---|',
|
|
904
|
+
'| D1 | 夹具决策 | 无 | 夹具 | 无 |',
|
|
905
|
+
'',
|
|
906
|
+
'## 2. 数据流 / 架构图',
|
|
907
|
+
'',
|
|
908
|
+
'夹具:无数据流。',
|
|
909
|
+
'',
|
|
910
|
+
'## 5. 风险',
|
|
911
|
+
'',
|
|
912
|
+
'- 无',
|
|
913
|
+
'',
|
|
914
|
+
'## 6. 不在范围',
|
|
915
|
+
'',
|
|
916
|
+
'- 无',
|
|
917
|
+
'',
|
|
918
|
+
].join('\n');
|
|
919
|
+
}
|
|
920
|
+
|
|
700
921
|
// 多波 next 断言公共材料:前序产物文件(open/design/plan 的产物门控按文件推导)
|
|
701
922
|
export function writeIntakeArtifacts(dir) {
|
|
702
|
-
writeFile(dir, '.specs/' + CHANGE_ID + '/CHANGE.md',
|
|
703
|
-
writeFile(dir, '.specs/' + CHANGE_ID + '/REQUIREMENT.md',
|
|
704
|
-
writeFile(dir, '.specs/' + CHANGE_ID + '/DESIGN.md',
|
|
923
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/CHANGE.md', intakeChangeText());
|
|
924
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/REQUIREMENT.md', intakeRequirementText());
|
|
925
|
+
writeFile(dir, '.specs/' + CHANGE_ID + '/DESIGN.md', intakeDesignText());
|
|
705
926
|
}
|
|
706
927
|
|
|
707
928
|
// ---------- 位置迁移 / 备份 / 感知层剥离场景材料 ----------
|
|
@@ -753,8 +974,8 @@ export function writeMigratedProjectArtifacts(proj, changeId = MIGRATION_CHANGE)
|
|
|
753
974
|
writeFile(proj, '.specs/' + changeId + '/REQUIREMENT.md', '# REQUIREMENT\n\n- **Change ID**: ' + changeId + '\n\n## 用户故事(User Story)\n\nx\n\n## 验收准则(AC)\n\n- y\n');
|
|
754
975
|
}
|
|
755
976
|
|
|
756
|
-
// 跑安装副本内的脚本(cwd =
|
|
757
|
-
//
|
|
977
|
+
// 跑安装副本内的脚本(cwd = 目标项目根,FLOW_COMET_RUN_ROOT 设为同一个根):运行根由唯一
|
|
978
|
+
// 解析模块(run-root.mjs)给定(变量优先)——迁移后链路在真实安装形态(而非权威源脚本)上验证
|
|
758
979
|
export function runInstalled(proj, platformRoot, scriptName, args) {
|
|
759
980
|
const script = path.join(proj, platformRoot, 'skills', 'flow-comet', 'scripts', scriptName);
|
|
760
981
|
const res = spawnSync(process.execPath, [script, ...args], {
|
|
@@ -938,9 +1159,12 @@ export function engineConsumersOf(name, scriptsDir = SCRIPTS_DIR) {
|
|
|
938
1159
|
|
|
939
1160
|
// 从具名 import 列表里摘掉一个名字(反向构造用;名前 / 名后 / 唯一项三种位置都覆盖):
|
|
940
1161
|
// 摘掉后消费方仍引用该符号 ⇒ 「未从单源取用」必报。位置感知是必须的——只处理「名字后带逗号」
|
|
941
|
-
//
|
|
1162
|
+
// 的写法在名字位于列表末位时会静默不改;只剩一个名字的列表(`import { NAME } from …`)更没有逗号可
|
|
1163
|
+
// 依,整句不动。两种形态下探针都退化为恒绿 / 报「前提失效」,锁的判别力无从证明(L-151)。
|
|
942
1164
|
export function dropNamedImport(text, name) {
|
|
943
1165
|
return String(text)
|
|
1166
|
+
// 唯一项:列表里只有这一个名字(单行 / 多行同形;摘完保留 `import {}` 这层语句结构,变异只动名字)。
|
|
1167
|
+
.replace(new RegExp('(import\\s*\\{)\\s*\\b' + name + '\\b\\s*(\\})'), '$1$2')
|
|
944
1168
|
.replace(new RegExp('(import\\s*\\{[^}]*?)\\b' + name + '\\b\\s*,\\s*'), '$1')
|
|
945
1169
|
.replace(new RegExp('(import\\s*\\{[^}]*?)\\s*,\\s*\\b' + name + '\\b'), '$1');
|
|
946
1170
|
}
|
|
@@ -93,9 +93,9 @@ export function writeState(root, state) {
|
|
|
93
93
|
}
|
|
94
94
|
|
|
95
95
|
// ---------- 受控命令(runRoot = 夹具根) ----------
|
|
96
|
-
// 约定:spawn 时 cwd =
|
|
97
|
-
//
|
|
98
|
-
//
|
|
96
|
+
// 约定:spawn 时 cwd = 夹具根,并注入 FLOW_COMET_RUN_ROOT 环境变量——状态命令的运行根由唯一
|
|
97
|
+
// 解析模块取该变量优先、否则进程 cwd,故运行根 = 夹具根;同时捕获 stdout + stderr(WARN/BLOCKED
|
|
98
|
+
// 走 stderr,成功退出时只取 stdout 会让 WARN 断言误报)与 exit code,统一返回
|
|
99
99
|
// `{ status, output }`(output 为 stdout+stderr 拼接的字符串)。
|
|
100
100
|
// 统一超时(毫秒):真实命令在冷启动 / 慢文件系统上耗时波动,60s 是两套件既有取值。
|
|
101
101
|
const COMMAND_TIMEOUT_MS = 60000;
|
|
@@ -223,7 +223,66 @@ export function copyTreePortable(src, dst) {
|
|
|
223
223
|
}
|
|
224
224
|
}
|
|
225
225
|
|
|
226
|
+
// ---------- 打印出来的命令:解析 → argv → 真实执行 ----------
|
|
227
|
+
//
|
|
228
|
+
// 运行期消息打印的命令是**给执行者照抄的文本**,判据就得真的照着它跑:只断言字面串、再用 harness
|
|
229
|
+
// 的绝对脚本路径去执行,等于从未执行过打印出来的那条文本(形似全绿)。这一组是那条链路的单一
|
|
230
|
+
// 来源:按安装布局复制技能树 → 把打印命令按 shell 语义切成 argv → 真实执行打印文本。两组场景
|
|
231
|
+
//(委托链路 / 声明恢复)都从这里取用——各存一份时,同一条命令会在两组的判据里各自演化,而任一侧
|
|
232
|
+
// 漂移都不会让另一侧变红。
|
|
233
|
+
|
|
234
|
+
// 把套件自身技能树按安装布局复制进夹具(与安装器装出的副本同构):副本自身运行时推导出的是
|
|
235
|
+
// **运行根相对**的脚本目录,打印的命令因此可在夹具内解析——执行的是打印文本,不是 harness 的
|
|
236
|
+
// 绝对脚本路径。installDirRel 是该布局在运行根下的相对目录(夹具构造,不是断言对象)。
|
|
237
|
+
export function installSkillTreeCopy(root, installDirRel) {
|
|
238
|
+
const skillCopy = path.join(root, installDirRel, 'flow-comet');
|
|
239
|
+
copyTreePortable(path.join(SCRIPTS_DIR, '..'), skillCopy);
|
|
240
|
+
return skillCopy;
|
|
241
|
+
}
|
|
242
|
+
|
|
243
|
+
// 打印命令 → argv:按 shell 分词语义处理双引号与单引号(引号内空白不切分,引号本身不进入参数)。
|
|
244
|
+
// 该解析器对「整条路径未加引号」有判别力——缺引号时含空格的路径会被切成多个参数。
|
|
245
|
+
export function splitPrintedCommand(command) {
|
|
246
|
+
const argv = [];
|
|
247
|
+
let current = '';
|
|
248
|
+
let quote = null;
|
|
249
|
+
let started = false;
|
|
250
|
+
for (const ch of command) {
|
|
251
|
+
if (quote) {
|
|
252
|
+
if (ch === quote) { quote = null; continue; }
|
|
253
|
+
current += ch;
|
|
254
|
+
continue;
|
|
255
|
+
}
|
|
256
|
+
if (ch === '"' || ch === "'") { quote = ch; started = true; continue; }
|
|
257
|
+
if (/\s/.test(ch)) {
|
|
258
|
+
if (started) { argv.push(current); current = ''; started = false; }
|
|
259
|
+
continue;
|
|
260
|
+
}
|
|
261
|
+
current += ch;
|
|
262
|
+
started = true;
|
|
263
|
+
}
|
|
264
|
+
if (quote) throw new Error('打印命令的引号未闭合: ' + command);
|
|
265
|
+
if (started) argv.push(current);
|
|
266
|
+
return argv;
|
|
267
|
+
}
|
|
268
|
+
|
|
269
|
+
// 真实执行打印出来的那条命令:解释器名 `node` 换成本进程的 node 可执行文件(PATH 解析不是本锚点
|
|
270
|
+
// 的断言对象,脚本路径与参数才是),其余一律照打印文本解析。
|
|
271
|
+
export function runPrintedCommand(command, root, envOverrides = {}) {
|
|
272
|
+
const argv = splitPrintedCommand(command);
|
|
273
|
+
const interpreter = /^node(\.exe)?$/i.test(argv[0]) ? process.execPath : argv[0];
|
|
274
|
+
const res = spawnSync(interpreter, argv.slice(1), {
|
|
275
|
+
cwd: root,
|
|
276
|
+
env: { ...process.env, ...envOverrides },
|
|
277
|
+
encoding: 'utf8',
|
|
278
|
+
timeout: 60000,
|
|
279
|
+
});
|
|
280
|
+
return { status: res.status ?? 1, output: String(res.stdout || '') + String(res.stderr || '') };
|
|
281
|
+
}
|
|
282
|
+
|
|
226
283
|
// 最小合法 state(夹具起点):字段与状态校验器的类型要求同形;node 为当前节点。
|
|
284
|
+
// enteredNodes 默认含当前节点:这是「已 entry」的正常在途形态(未 entry 即 exit 一律 BLOCKED)。
|
|
285
|
+
// 专门测 entry 门的场景自行构造不含该节点的 state(显式覆盖或 delete)。
|
|
227
286
|
export function baseState(node) {
|
|
228
287
|
return {
|
|
229
288
|
activeChange: CHANGE_ID,
|
|
@@ -233,5 +292,6 @@ export function baseState(node) {
|
|
|
233
292
|
verifyFailures: 0,
|
|
234
293
|
executionMode: 'subagent',
|
|
235
294
|
directOverride: false,
|
|
295
|
+
enteredNodes: [node],
|
|
236
296
|
};
|
|
237
297
|
}
|