flow-comet 1.5.0-rc.3
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 +13 -0
- package/.flow-comet/skills/flow-comet/GUIDANCE.md +196 -0
- package/.flow-comet/skills/flow-comet/INSTALLED_VERSION +1 -0
- package/.flow-comet/skills/flow-comet/SKILL.md +196 -0
- package/.flow-comet/skills/flow-comet/reference/KNOWN-ISSUES-template.md +19 -0
- package/.flow-comet/skills/flow-comet/reference/TEST-MATRIX.md +115 -0
- package/.flow-comet/skills/flow-comet/reference/authoring-lanes.json +33 -0
- package/.flow-comet/skills/flow-comet/reference/composition-report.md +65 -0
- package/.flow-comet/skills/flow-comet/reference/decision-points.md +64 -0
- package/.flow-comet/skills/flow-comet/reference/dirty-worktree.md +30 -0
- package/.flow-comet/skills/flow-comet/reference/dsh-platform.md +169 -0
- package/.flow-comet/skills/flow-comet/reference/init-detection.md +58 -0
- package/.flow-comet/skills/flow-comet/reference/recovery.md +20 -0
- package/.flow-comet/skills/flow-comet/reference/resolved-skills.json +661 -0
- package/.flow-comet/skills/flow-comet/reference/skill-review.md +13 -0
- package/.flow-comet/skills/flow-comet/reference/subagents/script-author.md +7 -0
- package/.flow-comet/skills/flow-comet/reference/workflow-protocol.json +681 -0
- package/.flow-comet/skills/flow-comet/reference/worktree-notes.md +52 -0
- package/.flow-comet/skills/flow-comet/scripts/comet-check.mjs +61 -0
- package/.flow-comet/skills/flow-comet/scripts/comet-hook-guard.mjs +909 -0
- package/.flow-comet/skills/flow-comet/scripts/comet-plan.mjs +2 -0
- package/.flow-comet/skills/flow-comet/scripts/context-init.mjs +312 -0
- package/.flow-comet/skills/flow-comet/scripts/contract-check.mjs +136 -0
- package/.flow-comet/skills/flow-comet/scripts/guard-self-test.mjs +7331 -0
- package/.flow-comet/skills/flow-comet/scripts/protocol-utils.mjs +376 -0
- package/.flow-comet/skills/flow-comet/scripts/route-node.mjs +230 -0
- package/.flow-comet/skills/flow-comet/scripts/state-schema.mjs +99 -0
- package/.flow-comet/skills/flow-comet/scripts/system-test.mjs +4017 -0
- package/.flow-comet/skills/flow-comet/scripts/task-parsing.mjs +28 -0
- package/.flow-comet/skills/flow-comet/scripts/workflow-guard.mjs +2396 -0
- package/.flow-comet/skills/flow-comet/scripts/workflow-handoff.mjs +378 -0
- package/.flow-comet/skills/flow-comet/scripts/workflow-state.mjs +1263 -0
- package/.flow-comet/skills/flow-comet-archive/SKILL.md +195 -0
- package/.flow-comet/skills/flow-comet-change/SKILL.md +29 -0
- package/.flow-comet/skills/flow-comet-compose/SKILL.md +249 -0
- package/.flow-comet/skills/flow-comet-design/GUIDANCE.md +23 -0
- package/.flow-comet/skills/flow-comet-design/SKILL.md +161 -0
- package/.flow-comet/skills/flow-comet-dev/SKILL.md +51 -0
- package/.flow-comet/skills/flow-comet-evolve/SKILL.md +26 -0
- package/.flow-comet/skills/flow-comet-execute/SKILL.md +182 -0
- package/.flow-comet/skills/flow-comet-health/SKILL.md +31 -0
- package/.flow-comet/skills/flow-comet-integration/SKILL.md +45 -0
- package/.flow-comet/skills/flow-comet-open/GUIDANCE.md +36 -0
- package/.flow-comet/skills/flow-comet-open/SKILL.md +161 -0
- package/.flow-comet/skills/flow-comet-plan/GUIDANCE.md +33 -0
- package/.flow-comet/skills/flow-comet-plan/SKILL.md +169 -0
- package/.flow-comet/skills/flow-comet-requirement/SKILL.md +27 -0
- package/.flow-comet/skills/flow-comet-review/SKILL.md +204 -0
- package/.flow-comet/skills/flow-comet-subagent-execute/GUIDANCE.md +29 -0
- package/.flow-comet/skills/flow-comet-subagent-execute/SKILL.md +214 -0
- package/.flow-comet/skills/flow-comet-task/SKILL.md +33 -0
- package/.flow-comet/skills/flow-comet-test/SKILL.md +41 -0
- package/.flow-comet/skills/flow-comet-ui-design/SKILL.md +26 -0
- package/.flow-comet/skills/flow-comet-verify/SKILL.md +164 -0
- package/LICENSE +21 -0
- package/README.md +255 -0
- package/package.json +27 -0
- package/scripts/dsh-bridge.mjs +461 -0
- package/scripts/prepare-env.mjs +1526 -0
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
// state-schema.mjs: state 字段类型校验表(唯一来源)
|
|
2
|
+
// 批次 D 内置节点常量:自 workflow-state.mjs C6 内联表原样迁移,供 workflow-state / workflow-guard / workflow-handoff 三脚本共用。
|
|
3
|
+
// 语义(与批次 C C6 完全一致):存在字段逐一校验;未知字段放行(前向兼容);缺字段放行(readState 默认补);
|
|
4
|
+
// 只校验存在字段的类型。调用方负责 BLOCKED / exit(1) 处理。
|
|
5
|
+
|
|
6
|
+
// ---------- 运行时路径常量(单一来源)----------
|
|
7
|
+
// 「状态文件在哪」曾是一个被独立表达在 6 处的决策(协议 state.statePath、workflow-state 默认值、
|
|
8
|
+
// workflow-handoff 默认值、comet-hook-guard 的 STATE_FILE_REL / 回退值 / runRoot 锚点 / 相位读取、
|
|
9
|
+
// workflow-guard 的跨命名空间探测常量、安装器迁移白名单)——改一处不会让另一处报警,主仓安装副本
|
|
10
|
+
// 滞后一轮即导致写入拦截全程静默失效且外观正常。此处收敛为唯一来源,各脚本 import 之,不再各自硬编码。
|
|
11
|
+
// 取值一律为「项目根相对路径、POSIX 分隔符」(与 workflowRelativeSegments /
|
|
12
|
+
// resolveWorkflowRelativePath 的归一化语义一致);比较前调用方自行归一化。
|
|
13
|
+
export const RUNTIME_DIR = '.flow-comet';
|
|
14
|
+
export const RUNTIME_STATE_FILE_NAME = 'flow-comet-state.json';
|
|
15
|
+
export const RUNTIME_STATE_PATH = RUNTIME_DIR + '/' + RUNTIME_STATE_FILE_NAME;
|
|
16
|
+
// 旧命名空间(三方共占目录)。仅用于诊断探测与安装器迁移,绝不作为运行时回退路径(fail-closed 语义不变)。
|
|
17
|
+
// 只导出完整相对路径——消费方(guard 的跨命名空间探测)按整文件路径使用,导出裸目录名属于无消费方的
|
|
18
|
+
// 死 API 面(且会诱使调用方自行拼路径,重新引入第二处决策)。
|
|
19
|
+
export const LEGACY_RUNTIME_STATE_PATH = '.comet/' + RUNTIME_STATE_FILE_NAME;
|
|
20
|
+
|
|
21
|
+
// 疑似对象字面量判定(单一来源——设计语义 / AC-1:workflow-state record 与
|
|
22
|
+
// workflow-handoff result 共用,两脚本不再各自定义):trim 后以 {/[ 开头 → 视作
|
|
23
|
+
// "形似对象字面量"(常见于 Windows 传参剥离内嵌引号后的损坏 JSON 形态)。
|
|
24
|
+
// 收窄(bot 审查):仅保留「{/[ 开头」一条——移除 :/; 包含判定,避免拒绝普通纯文本 payload。
|
|
25
|
+
// 行为契约(逐字等价):raw 为 null/undefined 时按空串处理(String(raw ?? ''))。调用方负责 fail-closed。
|
|
26
|
+
export function looksLikeObjectLiteral(raw) {
|
|
27
|
+
const text = String(raw ?? '').trim();
|
|
28
|
+
return text.startsWith('{') || text.startsWith('[');
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
export const STATE_FIELD_VALIDATORS = [
|
|
32
|
+
{ field: 'activeChange', check: (v) => typeof v === 'string' || v === null },
|
|
33
|
+
{ field: 'currentNode', check: (v) => typeof v === 'string' || v === null },
|
|
34
|
+
{ field: 'completedNodes', check: (v) => Array.isArray(v) && v.every((x) => typeof x === 'string') },
|
|
35
|
+
{ field: 'evidence', check: (v) => typeof v === 'object' && v !== null && !Array.isArray(v) },
|
|
36
|
+
{ field: 'verifyFailures', check: (v) => typeof v === 'number' && Number.isFinite(v) && v >= 0 },
|
|
37
|
+
// verifyFailures 按 change 存储:change-id → 非负整数计数(旧顶层字段为迁移通道,新 state 用本字段)
|
|
38
|
+
{ 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 },
|
|
39
|
+
{ field: 'executionMode', check: (v) => v === 'subagent' || v === 'direct' },
|
|
40
|
+
{ field: 'directOverride', check: (v) => typeof v === 'boolean' },
|
|
41
|
+
{ field: 'taskHash', check: (v) => typeof v === 'string' || v === undefined },
|
|
42
|
+
// M1: 节点进入标记(entry 写入,exit 检测未 entry;旧 state 缺失放行)
|
|
43
|
+
{ field: 'enteredNodes', check: (v) => (Array.isArray(v) && v.every((x) => typeof x === 'string')) || v === undefined || v === null },
|
|
44
|
+
// R6: 新 change 标记(init 写入 true——新旧判定的确定性依据,不依赖 entry;旧 state 缺失 = 旧 change 渐进兼容)
|
|
45
|
+
{ field: 'newChange', check: (v) => v === true || v === undefined || v === null },
|
|
46
|
+
// E5: 批次 E 新增字段(readState 默认补后类型校验;旧 state 缺失字段放行)
|
|
47
|
+
{ field: 'branchMode', check: (v) => typeof v === 'boolean' },
|
|
48
|
+
{ field: 'enablePrReview', check: (v) => typeof v === 'boolean' },
|
|
49
|
+
// 机制说明-14: 分支前缀(init --branch-prefix 可配置,适配仓库自身分支规范;缺省 'change/')
|
|
50
|
+
{ field: 'branchPrefix', check: (v) => typeof v === 'string' },
|
|
51
|
+
// auto-init-detection: 项目上下文字段('none' = 用户拒绝初始化;路径 = 用户指定文档)
|
|
52
|
+
{ field: 'ai_context_doc', check: (v) => typeof v === 'string' || v === null },
|
|
53
|
+
// auto-init-detection: 上次全量初始化扫描时间(ISO 日期字符串或 null)
|
|
54
|
+
{ field: 'last_intel_scan', check: (v) => typeof v === 'string' || v === null },
|
|
55
|
+
];
|
|
56
|
+
|
|
57
|
+
// 返回非法字段名数组(空 = 合法)。仅校验存在字段;unknown / 缺失字段一律放行。
|
|
58
|
+
export function validateStateFields(state) {
|
|
59
|
+
const bad = [];
|
|
60
|
+
if (state && typeof state === 'object') {
|
|
61
|
+
for (const { field, check } of STATE_FIELD_VALIDATORS) {
|
|
62
|
+
if (Object.prototype.hasOwnProperty.call(state, field) && !check(state[field])) {
|
|
63
|
+
bad.push(field);
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
return bad;
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
// ---------- verifyFailures 按 change 读写(单一来源——workflow-state verify-fail 与
|
|
71
|
+
// workflow-guard exit verify 共用) ----------
|
|
72
|
+
|
|
73
|
+
// 读取当前 change 的 verifyFailures 计数;旧顶层字段(verifyFailures,迁移通道)首次读取时
|
|
74
|
+
// 并入当前 change 的计数并清除(旧 state 兼容,不丢历史失败次数)。无 activeChange 时
|
|
75
|
+
// 保持旧语义(顶层字段)——verify-fail 只在运行中 workflow 使用,该分支为兼容兜底。
|
|
76
|
+
export function verifyFailuresFor(state) {
|
|
77
|
+
if (!state.activeChange) return state.verifyFailures ?? 0;
|
|
78
|
+
if (state.verifyFailuresByChange === undefined || state.verifyFailuresByChange === null) {
|
|
79
|
+
state.verifyFailuresByChange = {};
|
|
80
|
+
}
|
|
81
|
+
if (typeof state.verifyFailures === 'number' && state.verifyFailures > 0) {
|
|
82
|
+
state.verifyFailuresByChange[state.activeChange] = (state.verifyFailuresByChange[state.activeChange] ?? 0) + state.verifyFailures;
|
|
83
|
+
}
|
|
84
|
+
delete state.verifyFailures;
|
|
85
|
+
return state.verifyFailuresByChange[state.activeChange] ?? 0;
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
// 写入当前 change 的 verifyFailures 计数(迁移完成后旧顶层字段不再出现)
|
|
89
|
+
export function setVerifyFailuresFor(state, value) {
|
|
90
|
+
if (!state.activeChange) {
|
|
91
|
+
state.verifyFailures = value;
|
|
92
|
+
return;
|
|
93
|
+
}
|
|
94
|
+
if (state.verifyFailuresByChange === undefined || state.verifyFailuresByChange === null) {
|
|
95
|
+
state.verifyFailuresByChange = {};
|
|
96
|
+
}
|
|
97
|
+
state.verifyFailuresByChange[state.activeChange] = value;
|
|
98
|
+
delete state.verifyFailures;
|
|
99
|
+
}
|