flow-comet 1.5.1 → 1.6.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/rules/flow-comet-orchestration.md +1 -2
- package/.flow-comet/skills/flow-comet/INSTALLED_VERSION +1 -1
- package/.flow-comet/skills/flow-comet/SKILL.md +21 -3
- package/.flow-comet/skills/flow-comet/reference/TEST-MATRIX.md +9 -8
- package/.flow-comet/skills/flow-comet/reference/dsh-platform.md +9 -2
- package/.flow-comet/skills/flow-comet/scripts/guard-self-test.mjs +4233 -94
- package/.flow-comet/skills/flow-comet/scripts/protocol-utils.mjs +24 -4
- package/.flow-comet/skills/flow-comet/scripts/route-node.mjs +697 -15
- package/.flow-comet/skills/flow-comet/scripts/state-schema.mjs +69 -0
- package/.flow-comet/skills/flow-comet/scripts/system-test.mjs +1656 -5
- package/.flow-comet/skills/flow-comet/scripts/task-parsing.mjs +13 -0
- package/.flow-comet/skills/flow-comet/scripts/workflow-guard.mjs +429 -276
- package/.flow-comet/skills/flow-comet/scripts/workflow-handoff.mjs +330 -13
- package/.flow-comet/skills/flow-comet/scripts/workflow-state.mjs +423 -38
- package/.flow-comet/skills/flow-comet-archive/SKILL.md +15 -0
- package/.flow-comet/skills/flow-comet-execute/SKILL.md +19 -1
- package/.flow-comet/skills/flow-comet-review/SKILL.md +21 -3
- package/.flow-comet/skills/flow-comet-subagent-execute/SKILL.md +12 -3
- package/.flow-comet/skills/flow-comet-verify/SKILL.md +19 -4
- package/README.md +6 -2
- package/package.json +1 -1
- package/scripts/dsh-bridge.mjs +2 -2
- package/scripts/prepare-env.mjs +77 -46
|
@@ -2,6 +2,8 @@
|
|
|
2
2
|
// 批次 D 内置节点常量:自 workflow-state.mjs C6 内联表原样迁移,供 workflow-state / workflow-guard / workflow-handoff 三脚本共用。
|
|
3
3
|
// 语义(与批次 C C6 完全一致):存在字段逐一校验;未知字段放行(前向兼容);缺字段放行(readState 默认补);
|
|
4
4
|
// 只校验存在字段的类型。调用方负责 BLOCKED / exit(1) 处理。
|
|
5
|
+
import path from 'path';
|
|
6
|
+
import { resolveProtocol } from './protocol-utils.mjs';
|
|
5
7
|
|
|
6
8
|
// ---------- 运行时路径常量(单一来源)----------
|
|
7
9
|
// 「状态文件在哪」曾是一个被独立表达在 6 处的决策(协议 state.statePath、workflow-state 默认值、
|
|
@@ -18,6 +20,44 @@ export const RUNTIME_STATE_PATH = RUNTIME_DIR + '/' + RUNTIME_STATE_FILE_NAME;
|
|
|
18
20
|
// 死 API 面(且会诱使调用方自行拼路径,重新引入第二处决策)。
|
|
19
21
|
export const LEGACY_RUNTIME_STATE_PATH = '.comet/' + RUNTIME_STATE_FILE_NAME;
|
|
20
22
|
|
|
23
|
+
// ---------- 协议来源解析(state 持久化绑定 · 单一权威) ----------
|
|
24
|
+
// init 解析出的协议路径持久化在 state.protocolPath:项目根内 → 根相对 POSIX 形态(随项目迁移),
|
|
25
|
+
// 项目根外 → 绝对路径原样保留。消费方按统一优先级选择协议路径:
|
|
26
|
+
// 显式 --protocol CLI 参数(仅消费自身 CLI 的入口传入)> state.protocolPath >
|
|
27
|
+
// FLOW_COMET_PROTOCOL 环境变量 > 内置默认协议。
|
|
28
|
+
// state.protocolPath 一旦存在即独占:读取/解析失败由调用方按可见告警处理,不回退环境变量或默认——
|
|
29
|
+
// 回退会在自定义协议缺节点时按默认协议误判归属。旧 state 缺字段 = 未绑定(渐进兼容,走既有解析)。
|
|
30
|
+
export function hasProtocolCliArg(cliArgs = []) {
|
|
31
|
+
return (Array.isArray(cliArgs) ? cliArgs : []).some(
|
|
32
|
+
(arg) => arg === '--protocol' || (typeof arg === 'string' && arg.startsWith('--protocol=')),
|
|
33
|
+
);
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
// init 持久化形态归一:项目根内路径 → 根相对 POSIX;根外/退化形态 → 绝对路径原样。
|
|
37
|
+
export function toPersistedProtocolPath(runRoot, protocolPath) {
|
|
38
|
+
const absolute = path.resolve(protocolPath);
|
|
39
|
+
const relative = path.relative(path.resolve(runRoot), absolute);
|
|
40
|
+
if (relative === '' || path.isAbsolute(relative) || relative === '..' || relative.startsWith('..' + path.sep)) {
|
|
41
|
+
return absolute;
|
|
42
|
+
}
|
|
43
|
+
return relative.split(path.sep).join('/');
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
// 统一协议路径选择。返回 { protocolPath, source },source ∈ 'cli' | 'state' | 'env-or-default'。
|
|
47
|
+
// 只做路径选择,不读文件;调用方负责读取失败时的可见告警与放行/失败语义。
|
|
48
|
+
export function resolveProtocolPathWithState({ packageRoot, runRoot, state = null, cliArgs = [] } = {}) {
|
|
49
|
+
if (hasProtocolCliArg(cliArgs)) {
|
|
50
|
+
return { protocolPath: resolveProtocol(packageRoot, runRoot, cliArgs), source: 'cli' };
|
|
51
|
+
}
|
|
52
|
+
const persisted = state && typeof state === 'object' && typeof state.protocolPath === 'string'
|
|
53
|
+
? state.protocolPath.trim()
|
|
54
|
+
: '';
|
|
55
|
+
if (persisted !== '') {
|
|
56
|
+
return { protocolPath: path.resolve(runRoot, persisted), source: 'state' };
|
|
57
|
+
}
|
|
58
|
+
return { protocolPath: resolveProtocol(packageRoot, runRoot, []), source: 'env-or-default' };
|
|
59
|
+
}
|
|
60
|
+
|
|
21
61
|
// 疑似对象字面量判定(单一来源——设计语义 / AC-1:workflow-state record 与
|
|
22
62
|
// workflow-handoff result 共用,两脚本不再各自定义):trim 后以 {/[ 开头 → 视作
|
|
23
63
|
// "形似对象字面量"(常见于 Windows 传参剥离内嵌引号后的损坏 JSON 形态)。
|
|
@@ -36,6 +76,9 @@ export const STATE_FIELD_VALIDATORS = [
|
|
|
36
76
|
{ field: 'verifyFailures', check: (v) => typeof v === 'number' && Number.isFinite(v) && v >= 0 },
|
|
37
77
|
// verifyFailures 按 change 存储:change-id → 非负整数计数(旧顶层字段为迁移通道,新 state 用本字段)
|
|
38
78
|
{ field: 'verifyFailuresByChange', check: (v) => (typeof v === 'object' && v !== null && !Array.isArray(v) && Object.values(v).every((x) => typeof x === 'number' && Number.isFinite(x) && x >= 0)) || v === undefined || v === null },
|
|
79
|
+
// Fix 受控归位轮次按 change 存储:change-id → 非负整数计数(与 verifyFailuresByChange 同型;
|
|
80
|
+
// 旧 state 缺字段默认 0,旧 change 不因计数卡死)
|
|
81
|
+
{ field: 'fixRoundsByChange', check: (v) => (typeof v === 'object' && v !== null && !Array.isArray(v) && Object.values(v).every((x) => typeof x === 'number' && Number.isFinite(x) && x >= 0)) || v === undefined || v === null },
|
|
39
82
|
{ field: 'executionMode', check: (v) => v === 'subagent' || v === 'direct' },
|
|
40
83
|
{ field: 'directOverride', check: (v) => typeof v === 'boolean' },
|
|
41
84
|
{ field: 'taskHash', check: (v) => typeof v === 'string' || v === undefined },
|
|
@@ -52,6 +95,11 @@ export const STATE_FIELD_VALIDATORS = [
|
|
|
52
95
|
{ field: 'ai_context_doc', check: (v) => typeof v === 'string' || v === null },
|
|
53
96
|
// auto-init-detection: 上次全量初始化扫描时间(ISO 日期字符串或 null)
|
|
54
97
|
{ field: 'last_intel_scan', check: (v) => typeof v === 'string' || v === null },
|
|
98
|
+
// 协议来源绑定(init 持久化解析后的协议路径;旧 state 缺字段 = 未绑定,归属门禁渐进回退环境变量/默认)
|
|
99
|
+
{ field: 'protocolPath', check: (v) => typeof v === 'string' || v === null || v === undefined },
|
|
100
|
+
// 审计历史(事件追加数组):存在即必须是数组——非数组是审计历史损坏,一律 fail-closed 拒绝写入,
|
|
101
|
+
// 不得由任何写点静默清空覆盖(否则既有事件与轮次派生同时丢失)。旧 state 缺字段 = 空历史(放行)。
|
|
102
|
+
{ field: 'history', check: (v) => Array.isArray(v) },
|
|
55
103
|
];
|
|
56
104
|
|
|
57
105
|
// 返回非法字段名数组(空 = 合法)。仅校验存在字段;unknown / 缺失字段一律放行。
|
|
@@ -97,3 +145,24 @@ export function setVerifyFailuresFor(state, value) {
|
|
|
97
145
|
state.verifyFailuresByChange[state.activeChange] = value;
|
|
98
146
|
delete state.verifyFailures;
|
|
99
147
|
}
|
|
148
|
+
|
|
149
|
+
// ---------- fixRounds 按 change 读写(单一来源——受控归位计数 helper 与两个归位入口共用) ----------
|
|
150
|
+
|
|
151
|
+
// 读取当前 change 的 Fix 受控归位轮次;旧 state 缺字段 / 缺当前 change 条目 → 0(不因计数卡死)。
|
|
152
|
+
// 该计数与 verifyFailuresByChange 各自独立:verify 成功只清 verify 失败计数,不清归位轮次。
|
|
153
|
+
export function fixRoundsFor(state) {
|
|
154
|
+
if (!state || !state.activeChange) return 0;
|
|
155
|
+
const rounds = state.fixRoundsByChange;
|
|
156
|
+
if (!rounds || typeof rounds !== 'object' || Array.isArray(rounds)) return 0;
|
|
157
|
+
const value = rounds[state.activeChange];
|
|
158
|
+
return typeof value === 'number' && Number.isFinite(value) && value >= 0 ? value : 0;
|
|
159
|
+
}
|
|
160
|
+
|
|
161
|
+
// 写入当前 change 的 Fix 受控归位轮次(容器缺失时按需创建;无 activeChange 时为无操作)
|
|
162
|
+
export function setFixRoundsFor(state, value) {
|
|
163
|
+
if (!state || !state.activeChange) return;
|
|
164
|
+
if (!state.fixRoundsByChange || typeof state.fixRoundsByChange !== 'object' || Array.isArray(state.fixRoundsByChange)) {
|
|
165
|
+
state.fixRoundsByChange = {};
|
|
166
|
+
}
|
|
167
|
+
state.fixRoundsByChange[state.activeChange] = value;
|
|
168
|
+
}
|