flow-comet 1.6.2 → 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.
- package/.flow-comet/skills/flow-comet/INSTALLED_VERSION +1 -1
- package/.flow-comet/skills/flow-comet/SKILL.md +64 -46
- package/.flow-comet/skills/flow-comet/reference/KNOWN-ISSUES-template.md +1 -1
- package/.flow-comet/skills/flow-comet/reference/commit-discipline.md +32 -0
- package/.flow-comet/skills/flow-comet/reference/dirty-worktree.md +1 -1
- package/.flow-comet/skills/flow-comet/{GUIDANCE.md → reference/entry-detail.md} +18 -28
- package/.flow-comet/skills/flow-comet/reference/fix-loop.md +57 -0
- package/.flow-comet/skills/flow-comet/reference/platform-facts.md +58 -0
- package/.flow-comet/skills/flow-comet/reference/replan.md +23 -0
- package/.flow-comet/skills/flow-comet/scripts/comet-check.mjs +5 -4
- package/.flow-comet/skills/flow-comet/scripts/comet-hook-guard.mjs +266 -25
- package/.flow-comet/skills/flow-comet/scripts/context-init.mjs +2 -2
- package/.flow-comet/skills/flow-comet/scripts/evolve.mjs +6 -6
- package/.flow-comet/skills/flow-comet/scripts/guard-self-test.mjs +67 -16325
- package/.flow-comet/skills/flow-comet/scripts/health.mjs +1 -1
- package/.flow-comet/skills/flow-comet/scripts/items/a.mjs +1030 -0
- package/.flow-comet/skills/flow-comet/scripts/items/b.mjs +830 -0
- package/.flow-comet/skills/flow-comet/scripts/items/c.mjs +781 -0
- package/.flow-comet/skills/flow-comet/scripts/items/d.mjs +99 -0
- package/.flow-comet/skills/flow-comet/scripts/items/e.mjs +185 -0
- package/.flow-comet/skills/flow-comet/scripts/items/f.mjs +90 -0
- package/.flow-comet/skills/flow-comet/scripts/items/g.mjs +59 -0
- package/.flow-comet/skills/flow-comet/scripts/items/h.mjs +815 -0
- package/.flow-comet/skills/flow-comet/scripts/items/i.mjs +77 -0
- package/.flow-comet/skills/flow-comet/scripts/items/j.mjs +75 -0
- package/.flow-comet/skills/flow-comet/scripts/items/k.mjs +1427 -0
- package/.flow-comet/skills/flow-comet/scripts/items/l.mjs +275 -0
- package/.flow-comet/skills/flow-comet/scripts/items/m.mjs +614 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/count-derivation.mjs +97 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/fix-loop-node.mjs +196 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-evidence-gates.mjs +553 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-gates.mjs +837 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-routing.mjs +404 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-state-io.mjs +404 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-template-fidelity.mjs +302 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-uidesign.mjs +133 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/reentry-node.mjs +237 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/replan-node.mjs +209 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-branch.mjs +49 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-bridgecheck.mjs +201 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-admin.mjs +141 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-flow.mjs +700 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-recovery.mjs +578 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-determine.mjs +52 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-evolve-hint.mjs +55 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-explain.mjs +106 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-intelscan.mjs +58 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-io.mjs +147 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-skillmarkers.mjs +189 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/system-fixtures.mjs +1441 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/task-graph.mjs +471 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/test-assertions.mjs +509 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/test-fixtures.mjs +1228 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/test-helpers.mjs +237 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/text-anchor-checks.mjs +2484 -0
- package/.flow-comet/skills/flow-comet/scripts/protocol-utils.mjs +2 -2
- package/.flow-comet/skills/flow-comet/scripts/route-node.mjs +73 -1077
- package/.flow-comet/skills/flow-comet/scripts/scenarios/a.mjs +966 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/b.mjs +1233 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/c.mjs +1382 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/d.mjs +483 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/e.mjs +1388 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/f.mjs +1466 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/g.mjs +1364 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/h.mjs +1287 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/i.mjs +1436 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/j.mjs +1384 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/k.mjs +1338 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/l.mjs +1484 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/m.mjs +971 -0
- package/.flow-comet/skills/flow-comet/scripts/state-schema.mjs +14 -1
- package/.flow-comet/skills/flow-comet/scripts/system-test.mjs +58 -6692
- package/.flow-comet/skills/flow-comet/scripts/time-utils.mjs +4 -4
- package/.flow-comet/skills/flow-comet/scripts/workflow-guard.mjs +151 -2428
- package/.flow-comet/skills/flow-comet/scripts/workflow-handoff.mjs +116 -9
- package/.flow-comet/skills/flow-comet/scripts/workflow-state.mjs +29 -2086
- package/.flow-comet/skills/flow-comet-archive/SKILL.md +10 -19
- package/.flow-comet/skills/flow-comet-change/SKILL.md +2 -3
- package/.flow-comet/skills/flow-comet-compose/SKILL.md +1 -1
- package/.flow-comet/skills/flow-comet-design/SKILL.md +6 -6
- package/.flow-comet/skills/flow-comet-execute/SKILL.md +58 -16
- package/.flow-comet/skills/flow-comet-integration/SKILL.md +8 -5
- package/.flow-comet/skills/flow-comet-open/SKILL.md +5 -1
- package/.flow-comet/skills/flow-comet-plan/GUIDANCE.md +1 -1
- package/.flow-comet/skills/flow-comet-plan/SKILL.md +8 -8
- package/.flow-comet/skills/flow-comet-review/SKILL.md +9 -12
- package/.flow-comet/skills/flow-comet-subagent-execute/SKILL.md +59 -16
- package/.flow-comet/skills/flow-comet-task/SKILL.md +3 -2
- package/.flow-comet/skills/flow-comet-ui-design/SKILL.md +3 -3
- package/.flow-comet/skills/flow-comet-verify/SKILL.md +8 -17
- package/README.md +53 -70
- package/package.json +3 -2
- package/scripts/dsh-bridge.mjs +59 -26
- package/scripts/lib/installer-cleanup.mjs +152 -0
- package/scripts/lib/installer-flowkit.mjs +119 -0
- package/scripts/lib/installer-hooks.mjs +363 -0
- package/scripts/lib/installer-loader.mjs +220 -0
- package/scripts/lib/installer-migrate.mjs +236 -0
- package/scripts/lib/installer-platforms.mjs +314 -0
- package/scripts/prepare-env.mjs +36 -1164
- package/.flow-comet/skills/flow-comet/reference/TEST-MATRIX.md +0 -116
- package/.flow-comet/skills/flow-comet/reference/composition-report.md +0 -65
- package/.flow-comet/skills/flow-comet/reference/dsh-platform.md +0 -184
- package/.flow-comet/skills/flow-comet/reference/resolved-skills.json +0 -661
- package/.flow-comet/skills/flow-comet/reference/skill-review.md +0 -13
- package/.flow-comet/skills/flow-comet/reference/subagents/script-author.md +0 -7
- package/.flow-comet/skills/flow-comet/reference/worktree-notes.md +0 -70
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
// items/i.mjs — I 组条目(异常路径)
|
|
2
|
+
//
|
|
3
|
+
// 组文件约定:`export const ENTRIES = [...]`(元素含 name 与 run;计数派生按此聚合,见 lib/count-derivation.mjs)。
|
|
4
|
+
// 跨组共用夹具在 lib/system-fixtures.mjs(组文件只承载 ENTRIES 数据与组内私有夹具,组文件之间零 import)。
|
|
5
|
+
|
|
6
|
+
import fs from 'fs';
|
|
7
|
+
import path from 'path';
|
|
8
|
+
import { assertExit, assertOut, baseState, runGuard, runHandoff, runState, writeFile, writeState } from '../lib/test-helpers.mjs';
|
|
9
|
+
import { CHANGE_ID } from '../lib/system-fixtures.mjs';
|
|
10
|
+
|
|
11
|
+
export const ENTRIES = [
|
|
12
|
+
// ---------- I. 异常路径 ----------
|
|
13
|
+
|
|
14
|
+
{
|
|
15
|
+
name: 'I1 异常路径:损坏状态文件 fail-closed',
|
|
16
|
+
run: (dir) => {
|
|
17
|
+
writeFile(dir, '.flow-comet/flow-comet-state.json', '{broken json');
|
|
18
|
+
const res = runState(['status'], dir);
|
|
19
|
+
assertExit(res, 1);
|
|
20
|
+
},
|
|
21
|
+
},
|
|
22
|
+
|
|
23
|
+
{
|
|
24
|
+
name: 'I2 异常路径:缺工件出口拦截',
|
|
25
|
+
run: (dir) => {
|
|
26
|
+
const st = baseState('open');
|
|
27
|
+
st.evidence.open = { summary: 'intake complete' };
|
|
28
|
+
writeState(dir, st);
|
|
29
|
+
// 工件根目录存在但工件缺失 → 缺产物拦截(工件根缺失走更前置的路径基座报错)
|
|
30
|
+
fs.mkdirSync(path.join(dir, '.specs', CHANGE_ID), { recursive: true });
|
|
31
|
+
const res = runGuard(['exit', 'open'], dir);
|
|
32
|
+
assertExit(res, 1);
|
|
33
|
+
assertOut(res, 'BLOCKED');
|
|
34
|
+
assertOut(res, 'missing Output Schema artifacts');
|
|
35
|
+
},
|
|
36
|
+
},
|
|
37
|
+
|
|
38
|
+
{
|
|
39
|
+
name: 'I3 异常路径:非法参数拒绝',
|
|
40
|
+
run: (dir) => {
|
|
41
|
+
// guard 缺节点 / 未知节点
|
|
42
|
+
const noNode = runGuard(['exit'], dir);
|
|
43
|
+
assertExit(noNode, 1);
|
|
44
|
+
assertOut(noNode, 'exit requires a Node id.');
|
|
45
|
+
const unknownNode = runGuard(['exit', 'bogus'], dir);
|
|
46
|
+
assertExit(unknownNode, 1);
|
|
47
|
+
assertOut(unknownNode, 'Unknown workflow Node: bogus');
|
|
48
|
+
// state 未知命令
|
|
49
|
+
const unknownCmd = runState(['bogus-cmd'], dir);
|
|
50
|
+
assertExit(unknownCmd, 1);
|
|
51
|
+
assertOut(unknownCmd, 'Unknown command');
|
|
52
|
+
// state 无活跃项目
|
|
53
|
+
const noActive = runState(['next'], dir);
|
|
54
|
+
assertExit(noActive, 0);
|
|
55
|
+
assertOut(noActive, 'No active change');
|
|
56
|
+
// handoff 未知动作
|
|
57
|
+
const badAction = runHandoff(['bogus'], dir);
|
|
58
|
+
assertExit(badAction, 1);
|
|
59
|
+
assertOut(badAction, 'Unknown action');
|
|
60
|
+
},
|
|
61
|
+
},
|
|
62
|
+
|
|
63
|
+
{
|
|
64
|
+
name: 'I4 异常路径:状态字段类型非法拦截',
|
|
65
|
+
run: (dir) => {
|
|
66
|
+
const st = baseState('open');
|
|
67
|
+
st.currentNode = 123; // 类型非法(number)
|
|
68
|
+
writeState(dir, st);
|
|
69
|
+
// advance 先按文件推导重写 currentNode(漂移校正),写入时校验非法字段(completedNodes
|
|
70
|
+
// 残留了数值条目)→ fail-closed 拦截——非法字段名随路径而异,断言通用消息
|
|
71
|
+
const res = runState(['advance'], dir);
|
|
72
|
+
assertExit(res, 1);
|
|
73
|
+
assertOut(res, 'BLOCKED: state 字段类型非法');
|
|
74
|
+
},
|
|
75
|
+
},
|
|
76
|
+
|
|
77
|
+
];
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
// items/j.mjs — J 组条目(文档一致性)
|
|
2
|
+
//
|
|
3
|
+
// 组文件约定:`export const ENTRIES = [...]`(元素含 name 与 run;计数派生按此聚合,见 lib/count-derivation.mjs)。
|
|
4
|
+
// 跨组共用夹具在 lib/system-fixtures.mjs(组文件只承载 ENTRIES 数据与组内私有夹具,组文件之间零 import)。
|
|
5
|
+
|
|
6
|
+
import fs from 'fs';
|
|
7
|
+
import path from 'path';
|
|
8
|
+
import { execFileSync, spawnSync } from 'child_process';
|
|
9
|
+
import { fileURLToPath } from 'url';
|
|
10
|
+
import { assertExit, assertOut } from '../lib/test-helpers.mjs';
|
|
11
|
+
import { DISTRIBUTION_MARKERS, applyDistributionSurface } from '../lib/system-fixtures.mjs';
|
|
12
|
+
|
|
13
|
+
// 路径推导基准:技能包 scripts/ 目录(与套件入口同基准)
|
|
14
|
+
const SCRIPTS_DIR = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
|
|
15
|
+
|
|
16
|
+
// 仓库本地验证工具执行(仅主仓存在、不随克隆分发;副本上文件缺失时回传显式「未执行」态):
|
|
17
|
+
// 返回 { status, output }(spawnSync 原始结果 output 是数组,统一拼接成字符串供断言)
|
|
18
|
+
function runLocalTool(checker, repoRoot) {
|
|
19
|
+
const res = spawnSync(process.execPath, [checker], { cwd: repoRoot, encoding: 'utf8', timeout: 120000 });
|
|
20
|
+
return { status: res.status ?? 1, output: String(res.stdout || '') + String(res.stderr || '') };
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
// 本地工具缺失的回传(「未执行」态,独立于条目级的「不适用」):整项无从执行时不得回 undefined
|
|
24
|
+
// ——运行器把缺标记判失败,而显式「未执行」是可读的三态之一(未验证 ≠ 通过,也不等于不适用)。
|
|
25
|
+
function localToolMissing(checkerRel) {
|
|
26
|
+
console.log(' 未执行(本地工具缺失:' + checkerRel + ' 是仓库本地检查器,gitignore 不随克隆分发)'
|
|
27
|
+
+ '——本项不计通过(未验证 ≠ 通过)');
|
|
28
|
+
return DISTRIBUTION_MARKERS.toolMissing;
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
const RAW_ENTRIES = [
|
|
32
|
+
// ---------- J. 文档一致性 ----------
|
|
33
|
+
|
|
34
|
+
{
|
|
35
|
+
name: 'J1 文档一致性:双语健康检查(本地工具)',
|
|
36
|
+
surface: '仓库文档健康检查(本地工具,不随克隆分发)仅权威源侧可判',
|
|
37
|
+
run: (dir) => {
|
|
38
|
+
const repoRoot = path.resolve(SCRIPTS_DIR, '..', '..', '..', '..');
|
|
39
|
+
const checker = path.join(repoRoot, 'scripts', 'check-docs-local.mjs');
|
|
40
|
+
if (!fs.existsSync(checker)) return localToolMissing('scripts/check-docs-local.mjs');
|
|
41
|
+
const res = runLocalTool(checker, repoRoot);
|
|
42
|
+
if (res.status === 0) {
|
|
43
|
+
assertOut(res, '文档健康检查通过');
|
|
44
|
+
return;
|
|
45
|
+
}
|
|
46
|
+
// 已知本地工具快照局限:其「场景数与版本一致性」子检查用发布时快照(1.3.0 → 97),
|
|
47
|
+
// 开发窗口期(版本未发布、场景数已增)会误报——结构检查(双语/对称)全部通过即放行;
|
|
48
|
+
// 场景数一致性的权威判定在引擎自测(guard-self-test 场景数自检按实时场景数核对)。
|
|
49
|
+
const structuralOk = res.output.includes('PASS: 英文文档无中文')
|
|
50
|
+
&& res.output.includes('PASS: 中文文档无英文长句')
|
|
51
|
+
&& res.output.includes('PASS: 双语镜像对称');
|
|
52
|
+
if (!structuralOk || !res.output.includes('场景数与版本一致性')) {
|
|
53
|
+
throw new Error('期望 exit 0,实际 exit ' + res.status + '\n实际输出:\n' + res.output);
|
|
54
|
+
}
|
|
55
|
+
console.log(' (场景数一致性子检查按发布快照——当前开发窗口由引擎自测的实时自检覆盖,放行)');
|
|
56
|
+
},
|
|
57
|
+
},
|
|
58
|
+
|
|
59
|
+
{
|
|
60
|
+
name: 'J2 文档一致性:公开产物零代号检查(本地工具)',
|
|
61
|
+
surface: '公开产物零代号扫描(本地工具,不随克隆分发)仅权威源侧可判',
|
|
62
|
+
run: (dir) => {
|
|
63
|
+
const repoRoot = path.resolve(SCRIPTS_DIR, '..', '..', '..', '..');
|
|
64
|
+
const checker = path.join(repoRoot, 'scripts', 'check-codes-local.mjs');
|
|
65
|
+
if (!fs.existsSync(checker)) return localToolMissing('scripts/check-codes-local.mjs');
|
|
66
|
+
const res = runLocalTool(checker, repoRoot);
|
|
67
|
+
assertExit(res, 0);
|
|
68
|
+
assertOut(res, '过程代号检查通过');
|
|
69
|
+
},
|
|
70
|
+
},
|
|
71
|
+
|
|
72
|
+
];
|
|
73
|
+
|
|
74
|
+
// 带 `surface` 声明的条目接入分发面契约(copy 分支与「已执行」回传单源——见 applyDistributionSurface)。
|
|
75
|
+
export const ENTRIES = RAW_ENTRIES.map(applyDistributionSurface);
|