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.
- package/.flow-comet/skills/flow-comet/INSTALLED_VERSION +1 -1
- package/.flow-comet/skills/flow-comet/scripts/comet-hook-guard.mjs +11 -13
- 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 -18878
- 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 +72 -1123
- 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 +1 -1
- package/.flow-comet/skills/flow-comet/scripts/system-test.mjs +58 -7559
- package/.flow-comet/skills/flow-comet/scripts/time-utils.mjs +4 -4
- package/.flow-comet/skills/flow-comet/scripts/workflow-guard.mjs +151 -2476
- package/.flow-comet/skills/flow-comet/scripts/workflow-handoff.mjs +5 -5
- package/.flow-comet/skills/flow-comet/scripts/workflow-state.mjs +27 -2190
- package/.flow-comet/skills/flow-comet-plan/GUIDANCE.md +1 -1
- package/README.md +52 -69
- package/package.json +3 -2
- package/scripts/dsh-bridge.mjs +2 -2
- 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 +21 -1313
|
@@ -0,0 +1,201 @@
|
|
|
1
|
+
// bridge-check(单一归属):只读 dsh 桥接健康检查 · 六判定态。
|
|
2
|
+
// 严格只读零写入零网络;失配(FAIL)exit 非 0;无法识别形态 → 近似性声明告警(WARN)
|
|
3
|
+
// 不定论不误杀(行扫描对无法识别形态的手写极端 YAML 只告警不定论,不误判为失配;
|
|
4
|
+
// 仅明确失配才强制非零退出)。
|
|
5
|
+
import { promises as fs } from 'fs';
|
|
6
|
+
import os from 'os';
|
|
7
|
+
import path from 'path';
|
|
8
|
+
import { fileURLToPath } from 'url';
|
|
9
|
+
import { fileExists } from './state-io.mjs';
|
|
10
|
+
|
|
11
|
+
// 版本戳锚点正则:独立整行、行首无缩进、冒号后恰一个空格、行尾无其它字符。格式禁动
|
|
12
|
+
// (安装器读-合并-写幂等替换与 loader 侧同值)。
|
|
13
|
+
const BRIDGE_VERSION_RE = /^\/\/ BRIDGE_VERSION: ([0-9]+\.[0-9]+\.[0-9]+(?:-[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?)$/m;
|
|
14
|
+
|
|
15
|
+
// dev 态后缀归一(bridge-check 版本比较):git describe 开发态形态为
|
|
16
|
+
// `<发布版本>-<领先提交数>-g<hash>`(例:`1.5.1-11-g93d96c0`,hash 十六进制、大小写不敏感)。
|
|
17
|
+
// 两侧仅在比较前剥这一种后缀、按基础版本比较——开发态载体与同基础版本的发布 loader 判健康;
|
|
18
|
+
// 语义化预发布标识(如 `1.5.0-rc.3`)不是 dev 态后缀、不得剥离(否则会把预发布放行成基础版本)。
|
|
19
|
+
// 归一仅用于比较,不改变读取到的原始值(失配报告需同时打印原始值与归一值)。
|
|
20
|
+
const BRIDGE_DEV_SUFFIX_RE = /-\d+-g[0-9a-f]+$/i;
|
|
21
|
+
function normalizeBridgeBaseVersion(version) {
|
|
22
|
+
return String(version).replace(BRIDGE_DEV_SUFFIX_RE, '');
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
// $DSH_HOME 解析——与 prepare-env.mjs resolveDshHome 同语义(显式 DSH_HOME > ~/.dsh)。
|
|
26
|
+
// 安装器函数位于仓库根 scripts/,技能包脚本不能跨模块 import,语义复刻保持单点契约
|
|
27
|
+
// (套件断言保证双侧不漂移)。
|
|
28
|
+
function resolveDshHomeForBridgeCheck() {
|
|
29
|
+
if (process.env.DSH_HOME) return path.resolve(process.env.DSH_HOME);
|
|
30
|
+
return path.join(os.homedir(), '.dsh');
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
// cordis.patch.yml 托管块标记——与 prepare-env.mjs MANAGED_CORDIS_START/END 同值复刻
|
|
34
|
+
// (技能包自包含;标记为安装器读-合并-写幂等替换边界,格式禁动)。
|
|
35
|
+
const MANAGED_CORDIS_START = '# --- flow-comet managed ---';
|
|
36
|
+
const MANAGED_CORDIS_END = '# --- end flow-comet managed ---';
|
|
37
|
+
|
|
38
|
+
// 判定态:健康 / 不适用 / 文件缺失 / 未挂载 / 版本偏斜 / 重复注册。
|
|
39
|
+
// runRoot = 会话项目根(.dsh 副本与 .specs 的锚);packageRoot = 技能包根(INSTALLED_VERSION 的锚)。
|
|
40
|
+
export async function runBridgeCheck({ runRoot, packageRoot }) {
|
|
41
|
+
const report = { pass: [], warn: [], fail: [] };
|
|
42
|
+
// ⑥ 非 dsh 项目 →「不适用」exit 0:会话项目根无 .dsh/skills/flow-comet
|
|
43
|
+
// (未安装 dsh 平台副本)即不适用,其余检查全部跳过。
|
|
44
|
+
if (!(await fileExists(path.join(runRoot, '.dsh', 'skills', 'flow-comet')))) {
|
|
45
|
+
console.log('[NA] bridge-check: 不适用(本项目未安装 dsh 平台副本)——项目根无 .dsh/skills/flow-comet');
|
|
46
|
+
console.log('bridge-check: 不适用(exit 0)');
|
|
47
|
+
return;
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
const dshHome = resolveDshHomeForBridgeCheck();
|
|
51
|
+
const loaderPath = path.join(dshHome, 'plugins', 'dsh-flow-comet-bridge.mjs');
|
|
52
|
+
const patchPath = path.join(dshHome, 'cordis.patch.yml');
|
|
53
|
+
const installedVersionPath = path.join(packageRoot, 'INSTALLED_VERSION');
|
|
54
|
+
|
|
55
|
+
// ① loader 文件存在性($DSH_HOME/plugins/dsh-flow-comet-bridge.mjs)
|
|
56
|
+
const loaderExists = await fileExists(loaderPath);
|
|
57
|
+
if (loaderExists) {
|
|
58
|
+
report.pass.push('loader 文件存在: ' + loaderPath);
|
|
59
|
+
} else {
|
|
60
|
+
report.fail.push('loader 文件缺失: ' + loaderPath);
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
// ② cordis.patch.yml 托管块存在性与 insert 形态(含 - insert: 与 name: 'file://…';
|
|
64
|
+
// id-targeted patch 形态无 insert → 确认为错误形态失配)
|
|
65
|
+
// + ③ 块内 file:// 目标可达
|
|
66
|
+
let patchContent = null;
|
|
67
|
+
try {
|
|
68
|
+
patchContent = await fs.readFile(patchPath, 'utf8');
|
|
69
|
+
} catch {
|
|
70
|
+
patchContent = null;
|
|
71
|
+
}
|
|
72
|
+
if (patchContent === null) {
|
|
73
|
+
report.fail.push(
|
|
74
|
+
'未挂载: ' + patchPath + ' 不存在——' +
|
|
75
|
+
(loaderExists ? 'loader 存在但未挂载(不会监听任何项目)' : '托管块无从指向 loader')
|
|
76
|
+
);
|
|
77
|
+
} else {
|
|
78
|
+
const startIdx = patchContent.indexOf(MANAGED_CORDIS_START);
|
|
79
|
+
const endIdx = patchContent.indexOf(MANAGED_CORDIS_END);
|
|
80
|
+
if (startIdx === -1 || endIdx === -1 || endIdx < startIdx) {
|
|
81
|
+
report.fail.push(
|
|
82
|
+
'未挂载: ' + patchPath + ' 中不存在托管块(' + MANAGED_CORDIS_START + ' … ' + MANAGED_CORDIS_END +
|
|
83
|
+
')——' + (loaderExists ? 'loader 存在但未挂载(不会监听任何项目)' : '')
|
|
84
|
+
);
|
|
85
|
+
} else {
|
|
86
|
+
// 块内容 = 起始标记行尾之后、结束标记之前
|
|
87
|
+
let blockStart = patchContent.indexOf('\n', startIdx);
|
|
88
|
+
blockStart = blockStart === -1 ? endIdx : blockStart + 1;
|
|
89
|
+
const block = patchContent.slice(blockStart, endIdx);
|
|
90
|
+
const hasInsert = /^\s*- insert:\s*$/m.test(block);
|
|
91
|
+
const fileUrlMatch = /name:\s*'file:\/\/([^']+)'/.exec(block);
|
|
92
|
+
const hasIdLine = /^\s*- id:\s*dsh-flow-comet-bridge\s*$/m.test(block);
|
|
93
|
+
|
|
94
|
+
if (hasInsert && fileUrlMatch) {
|
|
95
|
+
report.pass.push('cordis.patch.yml 托管块: 存在且 insert 形态(含 - insert: 与 name: \'file://…\')');
|
|
96
|
+
// ③ file:// 目标可达性(捕获组含 file:// 后的整段——'file://' + 捕获即完整 URL;
|
|
97
|
+
// fileURLToPath 按平台归一 Windows 盘符与 POSIX 根路径)
|
|
98
|
+
let targetPath = null;
|
|
99
|
+
try {
|
|
100
|
+
targetPath = fileURLToPath('file://' + fileUrlMatch[1]);
|
|
101
|
+
} catch (error) {
|
|
102
|
+
targetPath = null;
|
|
103
|
+
}
|
|
104
|
+
if (targetPath === null) {
|
|
105
|
+
report.warn.push('近似性声明: 托管块 file:// 引用无法解析为本地路径(' + fileUrlMatch[0] + ')——无法核验目标可达性,不定论');
|
|
106
|
+
} else if (await fileExists(targetPath)) {
|
|
107
|
+
if (targetPath === loaderPath) {
|
|
108
|
+
report.pass.push('块内 file:// 目标可达且与期望 loader 路径一致: ' + targetPath);
|
|
109
|
+
} else {
|
|
110
|
+
report.fail.push('托管块 file:// 目标与期望 loader 路径不符: ' + targetPath + ' ≠ ' + loaderPath);
|
|
111
|
+
}
|
|
112
|
+
} else {
|
|
113
|
+
report.fail.push('托管块指向的 loader 文件缺失: ' + targetPath + '(file:// 目标不可达)');
|
|
114
|
+
}
|
|
115
|
+
} else if (hasInsert && !fileUrlMatch) {
|
|
116
|
+
// insert 形态在但无 name: 'file://…' 行——部分可识别、目标不可核验:
|
|
117
|
+
// 近似性声明告警,不定论不误杀(不 forced 非零)
|
|
118
|
+
report.warn.push('近似性声明: 托管块为 insert 形态但未识别到 name: \'file://…\' 行——无法核验 file:// 目标是否可达,不定论');
|
|
119
|
+
} else if (hasIdLine && !hasInsert) {
|
|
120
|
+
// id-targeted patch 形态(- id: ... 无 - insert:)——
|
|
121
|
+
// dsh applyEntryPatches 对不存在的 id 报 entry not found 并跳过,loader 不会加载
|
|
122
|
+
report.fail.push('托管块为 id-targeted patch 形态(含 - id: dsh-flow-comet-bridge 但无 - insert:)——确认为错误形态失配(dsh 不会加载该 loader)');
|
|
123
|
+
} else {
|
|
124
|
+
report.warn.push('近似性声明: 托管块内容无法识别为已知形态(未见 - insert: / - id: dsh-flow-comet-bridge / name: \'file://…\')——不判失配,不定论');
|
|
125
|
+
}
|
|
126
|
+
}
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
// ④ 托管块外同 id 重复注册(块内安装器写入的固有条目不计)
|
|
130
|
+
let outside = '';
|
|
131
|
+
if (patchContent !== null) {
|
|
132
|
+
if (patchContent.includes(MANAGED_CORDIS_START) && patchContent.includes(MANAGED_CORDIS_END)) {
|
|
133
|
+
const sIdx = patchContent.indexOf(MANAGED_CORDIS_START);
|
|
134
|
+
const eIdx = patchContent.indexOf(MANAGED_CORDIS_END);
|
|
135
|
+
outside = patchContent.slice(0, sIdx) + patchContent.slice(eIdx + MANAGED_CORDIS_END.length);
|
|
136
|
+
} else {
|
|
137
|
+
outside = patchContent; // 无托管块:全文件视为块外
|
|
138
|
+
}
|
|
139
|
+
}
|
|
140
|
+
const dupMatches = outside.match(/^\s*-\s+id:\s*['"]?dsh-flow-comet-bridge['"]?\s*$/gm) ?? [];
|
|
141
|
+
if (dupMatches.length > 0) {
|
|
142
|
+
report.fail.push('重复注册: cordis.patch.yml 托管块外另有 ' + dupMatches.length + ' 处同 id 注册行(dsh-flow-comet-bridge)——可能重复加载');
|
|
143
|
+
} else {
|
|
144
|
+
report.pass.push('重复注册检查: 托管块外无同 id(dsh-flow-comet-bridge)注册行');
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
// ⑤ loader BRIDGE_VERSION 戳 vs 项目 INSTALLED_VERSION 基础版本比较(两原始值都打印;
|
|
148
|
+
// 比较前剥离 dev 态后缀——见 normalizeBridgeBaseVersion)
|
|
149
|
+
let loaderStamp = null;
|
|
150
|
+
let installedVersion = null;
|
|
151
|
+
if (loaderExists) {
|
|
152
|
+
try {
|
|
153
|
+
const loaderText = await fs.readFile(loaderPath, 'utf8');
|
|
154
|
+
const stampMatch = BRIDGE_VERSION_RE.exec(loaderText);
|
|
155
|
+
if (stampMatch) {
|
|
156
|
+
loaderStamp = stampMatch[1];
|
|
157
|
+
} else {
|
|
158
|
+
report.warn.push('近似性声明: loader 未提取到 BRIDGE_VERSION 戳(锚点正则 /^\\/\\/ BRIDGE_VERSION: ([0-9]+\\.[0-9]+\\.[0-9]+(?:-[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?)$/m 无命中——非语义化版本标记或缺失)——无法比对版本,不定论');
|
|
159
|
+
}
|
|
160
|
+
} catch {
|
|
161
|
+
report.warn.push('近似性声明: loader 文件读取失败——无法比对版本,不定论');
|
|
162
|
+
}
|
|
163
|
+
}
|
|
164
|
+
try {
|
|
165
|
+
installedVersion = (await fs.readFile(installedVersionPath, 'utf8')).trim();
|
|
166
|
+
} catch {
|
|
167
|
+
report.warn.push('近似性声明: 无法读取项目 INSTALLED_VERSION(' + installedVersionPath + ')——无法比对版本,不定论');
|
|
168
|
+
}
|
|
169
|
+
if (loaderStamp !== null && installedVersion !== null) {
|
|
170
|
+
// 比较前两侧按基础版本归一(剥离 git describe dev 态后缀;预发布标识不剥)。
|
|
171
|
+
// 原始值逐字相同 → 既有发布态严格一致报告保持不变;
|
|
172
|
+
// 原始值不同但归一基础版本一致 → dev 态同基础,判健康(同时打印两原始值与基础版本);
|
|
173
|
+
// 归一后仍不同 → 版本偏斜:保留原「loader 原始戳 != 项目原始戳」配对(兼容既有报告读取),
|
|
174
|
+
// 再补打印两侧归一基础版本,便于操作者识别 dev 态后缀。
|
|
175
|
+
const loaderBase = normalizeBridgeBaseVersion(loaderStamp);
|
|
176
|
+
const installedBase = normalizeBridgeBaseVersion(installedVersion);
|
|
177
|
+
if (loaderBase === installedBase) {
|
|
178
|
+
if (loaderStamp === installedVersion) {
|
|
179
|
+
report.pass.push('版本一致性: loader BRIDGE_VERSION=' + loaderStamp + ' == 项目 INSTALLED_VERSION=' + installedVersion);
|
|
180
|
+
} else {
|
|
181
|
+
report.pass.push('版本一致性: loader BRIDGE_VERSION=' + loaderStamp + ' ~= 项目 INSTALLED_VERSION=' + installedVersion + '(dev 态后缀归一后基础版本 ' + loaderBase + ' 一致)');
|
|
182
|
+
}
|
|
183
|
+
} else {
|
|
184
|
+
report.fail.push('版本偏斜: loader BRIDGE_VERSION=' + loaderStamp + ' != 项目 INSTALLED_VERSION=' + installedVersion + '(归一基础版本: loader=' + loaderBase + ' / installed=' + installedBase + ')——两值如上');
|
|
185
|
+
}
|
|
186
|
+
}
|
|
187
|
+
|
|
188
|
+
// 逐项人读报告(全过 exit 0 / 任一失配 exit 非 0)
|
|
189
|
+
console.log('bridge-check: 只读检查(DSH_HOME=' + dshHome + ' · 项目根=' + runRoot + ')');
|
|
190
|
+
for (const line of report.pass) console.log('[OK] ' + line);
|
|
191
|
+
for (const line of report.warn) console.log('[WARN] ' + line);
|
|
192
|
+
for (const line of report.fail) console.log('[FAIL] ' + line);
|
|
193
|
+
if (report.fail.length > 0) {
|
|
194
|
+
console.log('bridge-check: 失配 ' + report.fail.length + ' 项——exit 1');
|
|
195
|
+
process.exitCode = 1;
|
|
196
|
+
} else if (report.warn.length > 0) {
|
|
197
|
+
console.log('bridge-check: 未发现明确失配,含 ' + report.warn.length + ' 项近似性声明告警(不定论,不误杀)——exit 0');
|
|
198
|
+
} else {
|
|
199
|
+
console.log('bridge-check: 健康(全部检查通过)——exit 0');
|
|
200
|
+
}
|
|
201
|
+
}
|
|
@@ -0,0 +1,141 @@
|
|
|
1
|
+
// state 命令族 · 管理面(单一归属):config / execution-mode / skill-load / verify-fail。
|
|
2
|
+
// argv = 进程参数原样(位置参数取值形态与入口分派前一致)。
|
|
3
|
+
import path from 'path';
|
|
4
|
+
import { isValidTimestamp } from '../time-utils.mjs';
|
|
5
|
+
import { verifyFailuresFor, setVerifyFailuresFor, writeJsonAtomic } from '../state-schema.mjs';
|
|
6
|
+
import { findActiveChange, readState, writeState, specsDir } from './state-io.mjs';
|
|
7
|
+
import { findPromptArg, protocolUnderFlowKitPrompts } from './state-skillmarkers.mjs';
|
|
8
|
+
|
|
9
|
+
// config set <key> <value>——branchMode 只读(init 自动判定),enablePrReview 手动
|
|
10
|
+
// 开关,last_evolve_at 为 evolve 元数据时刻(形态校验 fail-closed,写通道唯一)
|
|
11
|
+
export async function runConfig(argv) {
|
|
12
|
+
const sub = argv[3];
|
|
13
|
+
const key = argv[4];
|
|
14
|
+
const value = argv[5];
|
|
15
|
+
if (sub !== 'set') throw new Error('config 仅支持 set 子命令。用法: workflow-state.mjs config set <key> <value>');
|
|
16
|
+
if (!key || value === undefined) throw new Error('config set 需要 key 和 value。用法: workflow-state.mjs config set <key> <value>');
|
|
17
|
+
if (key === 'branchMode') {
|
|
18
|
+
console.error('BLOCKED: branchMode 由 init 自动判定,不可手动设置');
|
|
19
|
+
process.exit(1);
|
|
20
|
+
}
|
|
21
|
+
if (key === 'enablePrReview') {
|
|
22
|
+
if (value !== 'true' && value !== 'false') {
|
|
23
|
+
console.error('BLOCKED: config set 值非法(enablePrReview 必须为 true 或 false): ' + value);
|
|
24
|
+
process.exit(1);
|
|
25
|
+
}
|
|
26
|
+
const state = await readState();
|
|
27
|
+
state.enablePrReview = value === 'true';
|
|
28
|
+
await writeState(state);
|
|
29
|
+
console.log('CONFIG: enablePrReview = ' + state.enablePrReview);
|
|
30
|
+
return;
|
|
31
|
+
}
|
|
32
|
+
// evolve 元数据时间戳(脚本不直写 state,项目级字段一律经本通道)。形态非法 → BLOCK
|
|
33
|
+
// 且**零改写**(校验先于读 state 与写盘;writeState 侧的字段校验表是第二道闸,同一判据)。
|
|
34
|
+
if (key === 'last_evolve_at') {
|
|
35
|
+
if (!isValidTimestamp(value)) {
|
|
36
|
+
console.error('BLOCKED: config set 值非法(last_evolve_at 必须为本地时间 + 显式偏移形态 '
|
|
37
|
+
+ 'YYYY-MM-DDTHH:mm:ss±HH:mm,兼容历史 Z 形态): ' + value);
|
|
38
|
+
process.exit(1);
|
|
39
|
+
}
|
|
40
|
+
const state = await readState();
|
|
41
|
+
state.last_evolve_at = value;
|
|
42
|
+
await writeState(state);
|
|
43
|
+
console.log('CONFIG: last_evolve_at = ' + state.last_evolve_at);
|
|
44
|
+
return;
|
|
45
|
+
}
|
|
46
|
+
console.error('BLOCKED: 未知配置键: ' + key + '(支持: enablePrReview, last_evolve_at;branchMode 由 init 自动判定)');
|
|
47
|
+
process.exit(1);
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
// execution-mode <subagent|direct>——direct 是逃生口:必须用户显式调用并留授权痕迹
|
|
51
|
+
export async function runExecutionMode(argv) {
|
|
52
|
+
const mode = argv[3];
|
|
53
|
+
if (mode !== 'subagent' && mode !== 'direct') {
|
|
54
|
+
console.error('BLOCKED: execution-mode 参数必须为 subagent 或 direct,收到: ' + String(mode));
|
|
55
|
+
process.exit(1);
|
|
56
|
+
}
|
|
57
|
+
const state = await readState();
|
|
58
|
+
state.executionMode = mode;
|
|
59
|
+
// direct 是逃生口:必须用户显式调用,并记录 directOverride;切回 subagent 时清除
|
|
60
|
+
// (directOverride 恒等于"当前是否处于用户确认的 direct"——再次切 direct 必须重新确认,无历史歧义)
|
|
61
|
+
state.directOverride = mode === 'direct';
|
|
62
|
+
if (mode === 'direct') {
|
|
63
|
+
// 授权审计留痕:direct 是用户决策点不可自决——协调者显式调用本命令即授权事件,写入授权
|
|
64
|
+
// 审计字段(guard 出口校验须存在授权记录;执行者绕过脚本手改 state 字段无授权记录 → BLOCK)。
|
|
65
|
+
console.error('DIRECT-AUTH: direct=逃生口须用户显式授权——本命令即授权留痕(directOverrideAt 写入)');
|
|
66
|
+
state.directOverrideAt = new Date().toISOString();
|
|
67
|
+
state.directOverrideSource = 'execution-mode';
|
|
68
|
+
} else {
|
|
69
|
+
// 切回 subagent 清除授权留痕(directOverride 一并清除——既有语义保持)
|
|
70
|
+
delete state.directOverrideAt;
|
|
71
|
+
delete state.directOverrideSource;
|
|
72
|
+
}
|
|
73
|
+
await writeState(state);
|
|
74
|
+
console.log('EXECUTION-MODE: ' + state.executionMode + (state.directOverride ? ' (directOverride)' : ''));
|
|
75
|
+
return;
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
// skill-load <node> <skill> [--prompt <path>]——写声明标记
|
|
79
|
+
// .specs/<change-id>/.skill-loads/<node>-<skill>.json({ node, skill, protocol, at });
|
|
80
|
+
// record 校验 completedChecks 的 required-skill 条目以此为准。
|
|
81
|
+
// 诚实边界:标记是"声明"而非物理证明——运行时没有 Skill 调用观察点,脚本无法确认执行者
|
|
82
|
+
// 真实加载过该 skill;标记仅记录"执行者主动声明已加载",由流程纪律兜底。
|
|
83
|
+
export async function runSkillLoad(protocol, argv) {
|
|
84
|
+
const nodeId = argv[3];
|
|
85
|
+
const skillName = argv[4];
|
|
86
|
+
if (!nodeId || !skillName) {
|
|
87
|
+
throw new Error('skill-load requires <node> <skill>. 用法: workflow-state.mjs skill-load <node> <skill> [--prompt <path>]');
|
|
88
|
+
}
|
|
89
|
+
// 参数校验:node 为当前协议节点集合之一(动态读取协议 nodes[].id——内置 +
|
|
90
|
+
// 自定义,compose 自定义协议节点可声明);协议外节点名依然非法(fail-closed)。
|
|
91
|
+
const protocolNodeIds = (protocol.nodes ?? []).map((n) => n.id);
|
|
92
|
+
if (!protocolNodeIds.includes(nodeId)) {
|
|
93
|
+
throw new Error('skill-load node 非法: ' + nodeId + '(协议节点: ' + protocolNodeIds.join('/') + ')');
|
|
94
|
+
}
|
|
95
|
+
if (!/^[A-Za-z0-9-]+$/.test(skillName)) {
|
|
96
|
+
throw new Error('skill-load skill 名非法(仅允许字母数字连字符): ' + skillName);
|
|
97
|
+
}
|
|
98
|
+
// --prompt 归属校验:路径必须位于 flow-kit/prompts/ 下(相对或绝对,前缀校验;
|
|
99
|
+
// flow-kit 为 vendored 上游,协议提示只读引用)。协议加载本身由 resolveProtocol 全局
|
|
100
|
+
// 处理(含受保护读取)——--protocol 语义不变(工作流协议 JSON);此处仅校验用户显式传入的
|
|
101
|
+
// --prompt 原始值(skill-load 专属参数,不再与全局协议解析共用 --protocol)。
|
|
102
|
+
const promptArg = findPromptArg(argv.slice(3));
|
|
103
|
+
if (promptArg !== null && !protocolUnderFlowKitPrompts(promptArg)) {
|
|
104
|
+
throw new Error('skill-load --prompt 路径必须位于 flow-kit/prompts/ 下(flow-kit 为 vendored 上游,协议提示只读引用): ' + promptArg);
|
|
105
|
+
}
|
|
106
|
+
// 声明标记写入:.skill-loads/ 目录不存在时创建(writeJsonAtomic 自带 mkdir recursive);
|
|
107
|
+
// 同 node-skill 重复调用覆盖(记录最新声明)
|
|
108
|
+
const changeName = await findActiveChange();
|
|
109
|
+
if (!changeName) {
|
|
110
|
+
// 归档后场景:change 目录已移入 .specs/archive/(无活跃 change)——skill-load 不可用,
|
|
111
|
+
// 但 record 的声明自动化仍可写归档路径标记——消息如实引导
|
|
112
|
+
throw new Error('skill-load requires an active change(先运行 init <change-id>;若该 change 已归档,声明标记由 record 自动补写——M5 会写入归档路径的 .skill-loads/)');
|
|
113
|
+
}
|
|
114
|
+
// 标记 protocol 字段 = --prompt 参数的 basename(如 0-change.md)——与 guard exit
|
|
115
|
+
// 校验的节点协议映射表 basename 精确比对同值(真实链路 skill-load → exit 一致);未传 --prompt →
|
|
116
|
+
// null(无协议声明,exit 校验 fail-closed)。若写 resolveProtocol 解析后的完整绝对路径,与
|
|
117
|
+
// 节点协议映射表的 basename 比对必然失败(真实链路必 BLOCKED——机制实际不可用)。
|
|
118
|
+
const marker = { node: nodeId, skill: skillName, protocol: promptArg === null ? null : path.basename(promptArg), at: new Date().toISOString() };
|
|
119
|
+
// specsDir 已含 .specs/,相对路径为 <change-id>/.skill-loads/<node>-<skill>.json
|
|
120
|
+
const markerRel = path.posix.join(changeName, '.skill-loads', nodeId + '-' + skillName + '.json');
|
|
121
|
+
await writeJsonAtomic(path.join(specsDir(), markerRel), marker);
|
|
122
|
+
console.log('SKILL-LOAD: ' + nodeId + ' ' + skillName + ' → .skill-loads/' + nodeId + '-' + skillName + '.json');
|
|
123
|
+
return;
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
// verify-fail:连续失败计数(按 change 隔离),第 4 次 BLOCK 要求用户决策
|
|
127
|
+
export async function runVerifyFail() {
|
|
128
|
+
const state = await readState();
|
|
129
|
+
// 机器计数——连续 3 次失败后(第 4 次)BLOCKED,要求用户决策(继续修 / 停止)
|
|
130
|
+
// 计数按当前 change 存储(verifyFailuresByChange)——切换 change 后计数独立,互不串扰;
|
|
131
|
+
// 旧顶层字段首次读取时迁移并入当前 change(旧 state 兼容)
|
|
132
|
+
const count = verifyFailuresFor(state);
|
|
133
|
+
if (count >= 3) {
|
|
134
|
+
console.error('verify 失败超限,需用户决策(verifyFailures=' + count + ')。继续修 / 停止?');
|
|
135
|
+
process.exit(1);
|
|
136
|
+
}
|
|
137
|
+
setVerifyFailuresFor(state, count + 1);
|
|
138
|
+
await writeState(state);
|
|
139
|
+
console.log('VERIFY-FAIL: ' + (count + 1) + '/3');
|
|
140
|
+
return;
|
|
141
|
+
}
|