flow-comet 1.6.3 → 1.6.4

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/scripts/comet-hook-guard.mjs +11 -13
  3. package/.flow-comet/skills/flow-comet/scripts/context-init.mjs +2 -2
  4. package/.flow-comet/skills/flow-comet/scripts/evolve.mjs +6 -6
  5. package/.flow-comet/skills/flow-comet/scripts/guard-self-test.mjs +67 -18878
  6. package/.flow-comet/skills/flow-comet/scripts/health.mjs +1 -1
  7. package/.flow-comet/skills/flow-comet/scripts/items/a.mjs +1030 -0
  8. package/.flow-comet/skills/flow-comet/scripts/items/b.mjs +830 -0
  9. package/.flow-comet/skills/flow-comet/scripts/items/c.mjs +781 -0
  10. package/.flow-comet/skills/flow-comet/scripts/items/d.mjs +99 -0
  11. package/.flow-comet/skills/flow-comet/scripts/items/e.mjs +185 -0
  12. package/.flow-comet/skills/flow-comet/scripts/items/f.mjs +90 -0
  13. package/.flow-comet/skills/flow-comet/scripts/items/g.mjs +59 -0
  14. package/.flow-comet/skills/flow-comet/scripts/items/h.mjs +815 -0
  15. package/.flow-comet/skills/flow-comet/scripts/items/i.mjs +77 -0
  16. package/.flow-comet/skills/flow-comet/scripts/items/j.mjs +75 -0
  17. package/.flow-comet/skills/flow-comet/scripts/items/k.mjs +1427 -0
  18. package/.flow-comet/skills/flow-comet/scripts/items/l.mjs +275 -0
  19. package/.flow-comet/skills/flow-comet/scripts/items/m.mjs +614 -0
  20. package/.flow-comet/skills/flow-comet/scripts/lib/count-derivation.mjs +97 -0
  21. package/.flow-comet/skills/flow-comet/scripts/lib/fix-loop-node.mjs +196 -0
  22. package/.flow-comet/skills/flow-comet/scripts/lib/guard-evidence-gates.mjs +553 -0
  23. package/.flow-comet/skills/flow-comet/scripts/lib/guard-gates.mjs +837 -0
  24. package/.flow-comet/skills/flow-comet/scripts/lib/guard-routing.mjs +404 -0
  25. package/.flow-comet/skills/flow-comet/scripts/lib/guard-state-io.mjs +404 -0
  26. package/.flow-comet/skills/flow-comet/scripts/lib/guard-template-fidelity.mjs +302 -0
  27. package/.flow-comet/skills/flow-comet/scripts/lib/guard-uidesign.mjs +133 -0
  28. package/.flow-comet/skills/flow-comet/scripts/lib/reentry-node.mjs +237 -0
  29. package/.flow-comet/skills/flow-comet/scripts/lib/replan-node.mjs +209 -0
  30. package/.flow-comet/skills/flow-comet/scripts/lib/state-branch.mjs +49 -0
  31. package/.flow-comet/skills/flow-comet/scripts/lib/state-bridgecheck.mjs +201 -0
  32. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-admin.mjs +141 -0
  33. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-flow.mjs +700 -0
  34. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-recovery.mjs +578 -0
  35. package/.flow-comet/skills/flow-comet/scripts/lib/state-determine.mjs +52 -0
  36. package/.flow-comet/skills/flow-comet/scripts/lib/state-evolve-hint.mjs +55 -0
  37. package/.flow-comet/skills/flow-comet/scripts/lib/state-explain.mjs +106 -0
  38. package/.flow-comet/skills/flow-comet/scripts/lib/state-intelscan.mjs +58 -0
  39. package/.flow-comet/skills/flow-comet/scripts/lib/state-io.mjs +147 -0
  40. package/.flow-comet/skills/flow-comet/scripts/lib/state-skillmarkers.mjs +189 -0
  41. package/.flow-comet/skills/flow-comet/scripts/lib/system-fixtures.mjs +1441 -0
  42. package/.flow-comet/skills/flow-comet/scripts/lib/task-graph.mjs +471 -0
  43. package/.flow-comet/skills/flow-comet/scripts/lib/test-assertions.mjs +509 -0
  44. package/.flow-comet/skills/flow-comet/scripts/lib/test-fixtures.mjs +1228 -0
  45. package/.flow-comet/skills/flow-comet/scripts/lib/test-helpers.mjs +237 -0
  46. package/.flow-comet/skills/flow-comet/scripts/lib/text-anchor-checks.mjs +2484 -0
  47. package/.flow-comet/skills/flow-comet/scripts/protocol-utils.mjs +2 -2
  48. package/.flow-comet/skills/flow-comet/scripts/route-node.mjs +72 -1123
  49. package/.flow-comet/skills/flow-comet/scripts/scenarios/a.mjs +966 -0
  50. package/.flow-comet/skills/flow-comet/scripts/scenarios/b.mjs +1233 -0
  51. package/.flow-comet/skills/flow-comet/scripts/scenarios/c.mjs +1382 -0
  52. package/.flow-comet/skills/flow-comet/scripts/scenarios/d.mjs +483 -0
  53. package/.flow-comet/skills/flow-comet/scripts/scenarios/e.mjs +1388 -0
  54. package/.flow-comet/skills/flow-comet/scripts/scenarios/f.mjs +1466 -0
  55. package/.flow-comet/skills/flow-comet/scripts/scenarios/g.mjs +1364 -0
  56. package/.flow-comet/skills/flow-comet/scripts/scenarios/h.mjs +1287 -0
  57. package/.flow-comet/skills/flow-comet/scripts/scenarios/i.mjs +1436 -0
  58. package/.flow-comet/skills/flow-comet/scripts/scenarios/j.mjs +1384 -0
  59. package/.flow-comet/skills/flow-comet/scripts/scenarios/k.mjs +1338 -0
  60. package/.flow-comet/skills/flow-comet/scripts/scenarios/l.mjs +1484 -0
  61. package/.flow-comet/skills/flow-comet/scripts/scenarios/m.mjs +971 -0
  62. package/.flow-comet/skills/flow-comet/scripts/state-schema.mjs +1 -1
  63. package/.flow-comet/skills/flow-comet/scripts/system-test.mjs +58 -7559
  64. package/.flow-comet/skills/flow-comet/scripts/time-utils.mjs +4 -4
  65. package/.flow-comet/skills/flow-comet/scripts/workflow-guard.mjs +151 -2476
  66. package/.flow-comet/skills/flow-comet/scripts/workflow-handoff.mjs +5 -5
  67. package/.flow-comet/skills/flow-comet/scripts/workflow-state.mjs +27 -2190
  68. package/.flow-comet/skills/flow-comet-plan/GUIDANCE.md +1 -1
  69. package/README.md +52 -69
  70. package/package.json +3 -2
  71. package/scripts/dsh-bridge.mjs +2 -2
  72. package/scripts/lib/installer-cleanup.mjs +152 -0
  73. package/scripts/lib/installer-flowkit.mjs +119 -0
  74. package/scripts/lib/installer-hooks.mjs +363 -0
  75. package/scripts/lib/installer-loader.mjs +220 -0
  76. package/scripts/lib/installer-migrate.mjs +236 -0
  77. package/scripts/lib/installer-platforms.mjs +314 -0
  78. package/scripts/prepare-env.mjs +21 -1313
@@ -0,0 +1,237 @@
1
+ // test-helpers.mjs — 两个测试套件共享的工具与夹具(单一来源)
2
+ //
3
+ // 定位:guard-self-test.mjs(引擎场景回归)与 system-test.mjs(系统级命令序列)此前各自
4
+ // 内置了同名同责的一批工具。同一能力两份实现必然分叉——注释互指「同源」不是同步机制,
5
+ // 故收敛为本模块,两个套件 import 之、本地副本删除。
6
+ // 本模块只放纯工具与夹具,**不含判据**:什么算通过 / 什么算残留,留在各套件自己的判据模块里。
7
+ //
8
+ // 分叉处的合并口径(两套件实现不同时取行为并集):
9
+ // · assertOut / assertNotOut:先经 outputText 归一,兼容原始 spawn 结果的数组形态
10
+ // (`res.output` 恒为 `[null, stdout, stderr]`,逐元素比较永不中关键字)与 run* 助手
11
+ // 产出的字符串形态;
12
+ // · runState:默认注入协议副本环境变量,且 envOverrides 最后展开——调用方传
13
+ // `{ FLOW_COMET_PROTOCOL: '' }` 即可回到「无环境变量」形态;
14
+ // · makeTmp:目录前缀、协议副本预置、创建登记三处参数化(见该函数注释)。
15
+ //
16
+ // 路径推导:本模块自身位于 `<技能包>/scripts/lib/`,兄弟脚本与内置协议副本一律以
17
+ // import.meta.url 为基准相对推导——主仓与各安装副本(.claude / .agents / .dsh)的相对结构
18
+ // 一致,故既不依赖调用方 cwd,也不需要每个调用面各自拼一遍路径(那会成为第二份推导)。
19
+
20
+ import { spawnSync } from 'child_process';
21
+ import fs from 'fs';
22
+ import os from 'os';
23
+ import path from 'path';
24
+ import { fileURLToPath } from 'url';
25
+
26
+ const __dirname = path.dirname(fileURLToPath(import.meta.url));
27
+ const SCRIPTS_DIR = path.join(__dirname, '..');
28
+ const GUARD = path.join(SCRIPTS_DIR, 'workflow-guard.mjs');
29
+ const STATE = path.join(SCRIPTS_DIR, 'workflow-state.mjs');
30
+ const HOOK = path.join(SCRIPTS_DIR, 'comet-hook-guard.mjs');
31
+ const HANDOFF = path.join(SCRIPTS_DIR, 'workflow-handoff.mjs');
32
+ // 内置协议源文件(技能包 reference/):协议读取走受保护路径,要求协议文件位于 runRoot 内,
33
+ // 故夹具根需要一份场景内副本(run* 助手默认指向它)。
34
+ const BUILTIN_PROTOCOL_SOURCE = path.join(SCRIPTS_DIR, '..', 'reference', 'workflow-protocol.json');
35
+ // 夹具 change id(baseState 的 activeChange;两套件的夹具约定同值)
36
+ const CHANGE_ID = 'ch';
37
+
38
+ // 夹具根内的协议副本路径——本模块内的**唯一表达式**,makeTmp 预置与 run* 注入共用,
39
+ // 避免同一相对路径在模块内出现第二处写法。
40
+ function scenarioProtocolPath(dir) {
41
+ return path.join(dir, 'reference', 'workflow-protocol.json');
42
+ }
43
+
44
+ // ---------- 临时目录夹具 ----------
45
+
46
+ // 独立临时目录(夹具根)。选项:
47
+ // · prefix:目录名前缀。两套件各传自己的前缀,残留目录便于辨认来源。
48
+ // · protocol:true 时把内置协议副本预置到 <dir>/reference/。系统级套件的每个夹具根都要
49
+ // 能当项目根用(run* 默认指向该副本),引擎场景套件只在场景根预置,故默认不预置。
50
+ // · register:调用方的登记数组——创建出的目录 push 进去,供套件收尾的「临时目录残留」
51
+ // 判据统一报告(该判据在套件侧;本函数不返回清理状态,也不据它分支)。
52
+ export function makeTmp(options = {}) {
53
+ const { prefix = 'flow-comet-test-', protocol = false, register } = options;
54
+ // 登记契约 fail-closed:传了非数组会静默漏登记,套件收尾的「临时目录残留」判据随之空转
55
+ // (目录照漏、读数仍绿)——这种失败必须当场可见,不能留到事后比对目录。
56
+ if (register !== undefined && !Array.isArray(register)) {
57
+ throw new TypeError('makeTmp 的 register 选项须为登记数组,实际为 ' + typeof register);
58
+ }
59
+ const dir = fs.mkdtempSync(path.join(os.tmpdir(), prefix));
60
+ if (register !== undefined) register.push(dir);
61
+ if (protocol) {
62
+ const builtinCopy = scenarioProtocolPath(dir);
63
+ fs.mkdirSync(path.dirname(builtinCopy), { recursive: true });
64
+ fs.copyFileSync(BUILTIN_PROTOCOL_SOURCE, builtinCopy);
65
+ }
66
+ return dir;
67
+ }
68
+
69
+ // 夹具清理(Windows 韧性):子进程退出后其 cwd / 文件句柄可能仍被短暂占用,`rmSync` 会抛
70
+ // EPERM/EBUSY;`maxRetries`/`retryDelay` 正是为该窗口设计(对 EBUSY / EMFILE / ENFILE /
71
+ // ENOTEMPTY / EPERM 线性退避重试)。**清不掉不得让整轮崩溃**——裸放在 finally 里会让后续
72
+ // 用例与收尾判据全都不执行;故此处容忍失败,残留交由套件收尾判据可见报告(不静默、也不自杀)。
73
+ const CLEANUP_RETRIES = 10;
74
+ const CLEANUP_RETRY_DELAY_MS = 150;
75
+ export function cleanupTmpDir(dir) {
76
+ try {
77
+ fs.rmSync(dir, { recursive: true, force: true, maxRetries: CLEANUP_RETRIES, retryDelay: CLEANUP_RETRY_DELAY_MS });
78
+ } catch {
79
+ // 交由套件收尾的「临时目录清理」判据报告
80
+ }
81
+ }
82
+
83
+ // ---------- 工件写入 ----------
84
+
85
+ export function writeFile(root, rel, content) {
86
+ const p = path.join(root, rel);
87
+ fs.mkdirSync(path.dirname(p), { recursive: true });
88
+ fs.writeFileSync(p, content, 'utf8');
89
+ }
90
+
91
+ export function writeState(root, state) {
92
+ writeFile(root, path.posix.join('.flow-comet', 'flow-comet-state.json'), JSON.stringify(state, null, 2) + '\n');
93
+ }
94
+
95
+ // ---------- 受控命令(runRoot = 夹具根) ----------
96
+ // 约定:spawn 时 cwd = 夹具根(workflow-state / workflow-handoff 的 runRoot 取进程 cwd),
97
+ // 并注入 FLOW_COMET_RUN_ROOT 环境变量;同时捕获 stdout + stderr(WARN/BLOCKED 走 stderr,
98
+ // 成功退出时只取 stdout 会让 WARN 断言误报)与 exit code,统一返回
99
+ // `{ status, output }`(output 为 stdout+stderr 拼接的字符串)。
100
+ // 统一超时(毫秒):真实命令在冷启动 / 慢文件系统上耗时波动,60s 是两套件既有取值。
101
+ const COMMAND_TIMEOUT_MS = 60000;
102
+
103
+ // 跑 workflow-guard.mjs。envOverrides 可覆盖 FLOW_COMET_PROTOCOL(自定义协议场景;
104
+ // --protocol CLI 优先级高于 env)。
105
+ export function runGuard(args, root, envOverrides = {}) {
106
+ const res = spawnSync(process.execPath, [GUARD, ...args], {
107
+ cwd: root,
108
+ env: {
109
+ ...process.env,
110
+ FLOW_COMET_RUN_ROOT: root,
111
+ FLOW_COMET_PROTOCOL: scenarioProtocolPath(root),
112
+ ...envOverrides,
113
+ },
114
+ encoding: 'utf8',
115
+ timeout: COMMAND_TIMEOUT_MS,
116
+ });
117
+ return { status: res.status ?? 1, output: String(res.stdout || '') + String(res.stderr || '') };
118
+ }
119
+
120
+ // 跑 workflow-state.mjs。协议副本是默认注入面(依赖协议解析的门禁不得静默跳过);
121
+ // envOverrides 最后展开,故可覆盖回无环境变量的形态。
122
+ export function runState(args, root, envOverrides = {}) {
123
+ const res = spawnSync(process.execPath, [STATE, ...args], {
124
+ cwd: root,
125
+ env: {
126
+ ...process.env,
127
+ FLOW_COMET_RUN_ROOT: root,
128
+ FLOW_COMET_PROTOCOL: scenarioProtocolPath(root),
129
+ ...envOverrides,
130
+ },
131
+ encoding: 'utf8',
132
+ timeout: COMMAND_TIMEOUT_MS,
133
+ });
134
+ return { status: res.status ?? 1, output: String(res.stdout || '') + String(res.stderr || '') };
135
+ }
136
+
137
+ // 跑 workflow-handoff.mjs:夹具用 cwd=夹具根 + 伪造 state 直接驱动命令,不经 guard exit。
138
+ export function runHandoff(args, root, envOverrides = {}) {
139
+ const res = spawnSync(process.execPath, [HANDOFF, ...args], {
140
+ cwd: root,
141
+ env: { ...process.env, FLOW_COMET_RUN_ROOT: root, ...envOverrides },
142
+ encoding: 'utf8',
143
+ timeout: COMMAND_TIMEOUT_MS,
144
+ });
145
+ return { status: res.status ?? 1, output: String(res.stdout || '') + String(res.stderr || '') };
146
+ }
147
+
148
+ // 跑 comet-hook-guard.mjs:PreToolUse 事件从 stdin 传 JSON({ tool_name, tool_input: { file_path } });
149
+ // hook 不支持 --protocol CLI,协议路径只能走 FLOW_COMET_PROTOCOL env。
150
+ export function runHook(args, root, input, envOverrides = {}) {
151
+ const res = spawnSync(process.execPath, [HOOK, ...args], {
152
+ cwd: root,
153
+ input: input === undefined ? '' : JSON.stringify(input),
154
+ env: {
155
+ ...process.env,
156
+ FLOW_COMET_RUN_ROOT: root,
157
+ FLOW_COMET_PROTOCOL: scenarioProtocolPath(root),
158
+ ...envOverrides,
159
+ },
160
+ encoding: 'utf8',
161
+ timeout: COMMAND_TIMEOUT_MS,
162
+ });
163
+ return { status: res.status ?? 1, output: String(res.stdout || '') + String(res.stderr || '') };
164
+ }
165
+
166
+ // ---------- 断言助手 ----------
167
+
168
+ export function assertExit(res, expected) {
169
+ if (res.status !== expected) {
170
+ throw new Error('期望 exit ' + expected + ',实际 exit ' + res.status + '\n实际输出:\n' + res.output);
171
+ }
172
+ }
173
+
174
+ // 输出字符串归一化:spawnSync 原始结果的 .output 恒为数组 [null, stdout, stderr]
175
+ // (.includes 逐元素比较永不中关键字);run* 助手已归一化为字符串。两种形态都归一后再
176
+ // 断言,保证本模块的断言对「数组(stdout+stderr 拼接)」与「字符串」两种形态都成立。
177
+ function outputText(res) {
178
+ return Array.isArray(res?.output)
179
+ ? String(res.stdout || '') + String(res.stderr || '')
180
+ : String(res?.output || '');
181
+ }
182
+
183
+ export function assertOut(res, keyword) {
184
+ const text = outputText(res);
185
+ if (!text.includes(keyword)) {
186
+ throw new Error('输出缺少关键词 ' + JSON.stringify(keyword) + '(exit ' + res.status + ')\n实际输出:\n' + text);
187
+ }
188
+ }
189
+
190
+ export function assertNotOut(res, keyword) {
191
+ const text = outputText(res);
192
+ if (text.includes(keyword)) {
193
+ throw new Error('输出不应包含关键词 ' + JSON.stringify(keyword) + '(exit ' + res.status + ')\n实际输出:\n' + text);
194
+ }
195
+ }
196
+
197
+ export function assertTrue(condition, message) {
198
+ if (!condition) throw new Error(message);
199
+ }
200
+
201
+ export function assertEqual(actual, expected, label) {
202
+ if (actual !== expected) {
203
+ throw new Error(label + ':期望 ' + JSON.stringify(expected) + ',实际 ' + JSON.stringify(actual));
204
+ }
205
+ }
206
+
207
+ // ---------- 伪造材料 ----------
208
+
209
+ // 便携递归复制:**复制目录一律走这里**(两个套件的夹具、条目与场景共同使用)。不使用
210
+ // fs.cpSync——实测在 Windows 且**源路径含非 ASCII 字符**时 cpSync 会让进程静默崩溃(同一进程内
211
+ // ASCII 源正常、中文源直接退出,逐目录逐文件复制两种源都正常),使套件在路径含中文的项目内
212
+ // 无声中断:没有失败报告、没有总结行,最容易被误读成通过。逐目录逐文件复制无此问题,且复制
213
+ // 完整性与内容可断言。落点选共享层而非任一夹具模块:两个夹具模块互不 import,各自复制一份
214
+ // 必然分叉。
215
+ export function copyTreePortable(src, dst) {
216
+ fs.mkdirSync(dst, { recursive: true });
217
+ for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
218
+ const from = path.join(src, entry.name);
219
+ const to = path.join(dst, entry.name);
220
+ if (entry.isDirectory()) copyTreePortable(from, to);
221
+ else if (entry.isFile()) fs.copyFileSync(from, to);
222
+ else if (entry.isSymbolicLink()) fs.symlinkSync(fs.readlinkSync(from), to);
223
+ }
224
+ }
225
+
226
+ // 最小合法 state(夹具起点):字段与状态校验器的类型要求同形;node 为当前节点。
227
+ export function baseState(node) {
228
+ return {
229
+ activeChange: CHANGE_ID,
230
+ currentNode: node,
231
+ completedNodes: [],
232
+ evidence: {},
233
+ verifyFailures: 0,
234
+ executionMode: 'subagent',
235
+ directOverride: false,
236
+ };
237
+ }