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
|
@@ -1 +1 @@
|
|
|
1
|
-
1.6.
|
|
1
|
+
1.6.4
|
|
@@ -53,7 +53,7 @@ function hookOk(extra) {
|
|
|
53
53
|
}
|
|
54
54
|
|
|
55
55
|
// 拦截输出:Codex 分支输出 {"decision":"block",reason} + exit 0(实测确认的 Codex deny 通道——
|
|
56
|
-
//
|
|
56
|
+
// exit 2 / permissionDecision:"deny" 均不被 enforce,decision:"block"+exit 0 生效);
|
|
57
57
|
// Claude Code 分支既有文本 + exit 2。
|
|
58
58
|
function hookBlock(mainLine, detailLine) {
|
|
59
59
|
if (isCodex) {
|
|
@@ -378,9 +378,9 @@ async function agentWorktreeWriteStaysIsolated(targetRel) {
|
|
|
378
378
|
// (fail-closed)。hook 拦工具不拦脚本——脚本通道天然不触发 PreToolUse,不受影响。
|
|
379
379
|
// 与 M1 归档白名单收窄同型:保护机器文件不被越权手改(含 direct 模式下白名单 [''] 曾
|
|
380
380
|
// 放行 state 写入的 fail-open 缺口——执行者自切 direct 越权写的物理入口)。
|
|
381
|
-
//
|
|
381
|
+
// 大小写变体闭合:win32/darwin 文件系统大小写不敏感,`.Flow-Comet/Flow-Comet-
|
|
382
382
|
// State.json` 与机器状态文件指向同一实体——目标路径先 toLowerCase() 再与机器状态相对路径
|
|
383
|
-
// 比较,变体同等 BLOCK
|
|
383
|
+
// 比较,变体同等 BLOCK(精确等值比较会被变体绕过 → fail-open)。其他平台
|
|
384
384
|
// (大小写敏感文件系统)变体是不同文件,保持精确等值比较(不误拦合法路径)。
|
|
385
385
|
// 取值唯一来源 = state-schema.mjs 的 RUNTIME_STATE_PATH(项目根相对的 POSIX 路径)。
|
|
386
386
|
// 本文件不再硬编码该路径——命名空间/文件名变更只改 state-schema.mjs 一处。
|
|
@@ -405,7 +405,7 @@ function blockStateFileWrite(target) {
|
|
|
405
405
|
// (消费方只问「是不是子代理」),不得下沉为 `if (platform === ...)` 之类的平台分支。
|
|
406
406
|
// dsh 面按**实现位置修订**(规划期落定):桥接只把委派深度透传进环境变量,身份判定与保护集判定的
|
|
407
407
|
// 整条都归本文件独占——桥接不再持有任何一份判定,两侧没有分叉的余地(归因以本节为准)。
|
|
408
|
-
// env
|
|
408
|
+
// env 面的作用域收紧:CC / Codex 生成的 hook **直接**调用本文件、并不自证是 dsh——
|
|
409
409
|
// 只看深度变量时,该变量一旦被继承进这些 hook 的进程环境(父进程导出 / 包装脚本转发),守卫就会在
|
|
410
410
|
// phase / worktree / runRoot 检查**之前**走子代理路径返回,只剩最小保护集兜底。故桥接在注入深度的
|
|
411
411
|
// 同时注入**通道标记** FLOW_COMET_AGENT_DEPTH_SOURCE=dsh-bridge;env 面身份**要求两者同时在场**
|
|
@@ -487,7 +487,7 @@ const protocolPath = resolveProtocol(packageRoot, runRoot, []);
|
|
|
487
487
|
// RUNTIME_STATE_PATH);② 本次运行**实际生效**的协议文件(取值来源 = 上方 protocol-utils
|
|
488
488
|
// resolveProtocol 的解析结果——本文件不另造第二份协议路径口径)。
|
|
489
489
|
// 同一性判定复用 protocol-utils 既有受保护路径判据 workflowPathInside(互含 ⇒ 同一路径):
|
|
490
|
-
//
|
|
490
|
+
// 路径归一/相对化只此一份,本文件不新增第二份路径判据。大小写敏感性与状态文件判据
|
|
491
491
|
// 同口径(共用 CASE_INSENSITIVE_FS 策略常量;win32 的 path.relative 本身已按小写比较)。
|
|
492
492
|
function isSameWorkflowPath(left, right) {
|
|
493
493
|
const fold = (value) => (CASE_INSENSITIVE_FS ? value.toLowerCase() : value);
|
|
@@ -503,7 +503,7 @@ function blockedProtocolFileTarget(absoluteTarget) {
|
|
|
503
503
|
// 保护集的**物理**同一性判定(词法判定的别名闭合):8.3 短路径 / 符号链接 / junction / 硬链接
|
|
504
504
|
// 是同一文件实体的不同拼写,词法比较看不见它们(身份放行下保护集是唯一防线,故须闭合)。
|
|
505
505
|
// 判据复用 protocol-utils.mjs 导出的文件身份比较判据(workflowFileObjectIdentity +
|
|
506
|
-
// workflowSameFileObject
|
|
506
|
+
// workflowSameFileObject)——本文件不新增第二份文件身份判据。
|
|
507
507
|
// 目标不存在(新建文件是常态)或 stat 失败 ⇒ 无法证明同一 ⇒ 返回 false(退回词法判定);
|
|
508
508
|
// 诚实边界:物理判定只证明「此刻存在且同一」,不证明「将来仍同一」(与 TOCTOU 同族的既有限制)。
|
|
509
509
|
async function isSameProtectedFileObject(targetAbsolute, protectedAbsolute) {
|
|
@@ -565,8 +565,8 @@ const WORKFLOW_PROJECT_FILE_MAX_BYTES = 2 * 1024 * 1024;
|
|
|
565
565
|
|
|
566
566
|
// 受保护路径三判据(workflowPathInside / inspectWorkflowProtectedPath /
|
|
567
567
|
// readWorkflowProtectedFile)与私有身份比较函数是 protocol-utils.mjs 的**单一来源**——
|
|
568
|
-
//
|
|
569
|
-
// (见文件头 import
|
|
568
|
+
// 本文件不另持副本(两份逐字节相同的副本必然分叉,互指「同源」的注释不是同步机制),
|
|
569
|
+
// 一律 import(见文件头 import 列表)——改判据只需改 protocol-utils.mjs 一处。
|
|
570
570
|
|
|
571
571
|
function workflowRelativeSegments(value, label, allowWildcards = false) {
|
|
572
572
|
if (typeof value !== 'string') throw new Error(label + ' must be a string');
|
|
@@ -670,7 +670,7 @@ async function readHookInput() {
|
|
|
670
670
|
}
|
|
671
671
|
}
|
|
672
672
|
|
|
673
|
-
//
|
|
673
|
+
// 盘符根拼写归一(单一实现——只由下方写入目标解析消费,不得在别处再写一份同义归一)。
|
|
674
674
|
// Windows 上 Git-Bash 类 shell 把 `D:\<剩余>` 写作 `/d/<剩余>`(盘符小写 + 正斜杠)。win32 的
|
|
675
675
|
// 目标解析把该拼写读成「**当前盘根**下的 \d\<剩余>」而非 `D:\<剩余>`:同一文件于是被判成根外,
|
|
676
676
|
// 词法相对化与物理同一性两道保护集判据同时失守(身份放行下保护集是唯一防线 ⇒ 静默放行)。
|
|
@@ -773,8 +773,6 @@ async function resolvePhaseWriteWhitelist(executionMode) {
|
|
|
773
773
|
// archive 白名单:归档阶段仅遗留清单(KNOWN-ISSUES.md)可写入 change 目录(先写后移),
|
|
774
774
|
// 其余 change 工件不可改(收窄为精确文件——放宽到整个目录会让归档阶段可改任意
|
|
775
775
|
// 工件且无校验,防线变宽);<change-id> 占位符由 targetAllowed 替换为当前 change;
|
|
776
|
-
// 目录移动由 .specs/archive/ 覆盖(2026-08-15 修复:此前仅 .specs/archive/ 导致按文档
|
|
777
|
-
// 流程被 BLOCK;2026-08-16 收窄为精确文件)
|
|
778
776
|
'archive': ['.specs/archive/', '.specs/<change-id>/KNOWN-ISSUES.md', '.specs/CHANGELOG.md', '.specs/LESSONS.md', 'STATE.md'],
|
|
779
777
|
},
|
|
780
778
|
declared: false,
|
|
@@ -883,7 +881,7 @@ async function main() {
|
|
|
883
881
|
|
|
884
882
|
// ── ②【ADR-014 决策 6】runRoot 外写入的 fail-open 关断(两分支对称)──────────────────
|
|
885
883
|
// file_path 解析为项目根之外时,与上方 Bash 分支**同判**:该分支对 targetRel === null 的目标
|
|
886
|
-
// 同样落入 `allowed=false` →
|
|
884
|
+
// 同样落入 `allowed=false` → 拦截。否则 file_path 分支会静默落入后继流程(越界写无痕放过),
|
|
887
885
|
// Bash 分支却拦截 —— 同一目标因工具而异。判定条件与 Bash 分支逐条对齐(有写入语义 + currentNode
|
|
888
886
|
// 在场);身份在场者已由上方 ① 短路放行,故「手工 worktree 绝对路径写入」不受本关断影响。
|
|
889
887
|
if (fileTarget && !fileTarget.insideRunRoot && currentNode) {
|
|
@@ -904,7 +902,7 @@ async function main() {
|
|
|
904
902
|
hookBlock(`BLOCKED: phase "${currentNode}" 不允许写入 "${target}"`, `允许范围: ${whitelist.join(', ')}`);
|
|
905
903
|
}
|
|
906
904
|
} else if (declared) {
|
|
907
|
-
//
|
|
905
|
+
// 协议声明了 writeWhitelist 但未列出当前节点 → fail-closed 拒绝
|
|
908
906
|
// (漏声明节点不放行——防协议作者漏列导致防线出洞)
|
|
909
907
|
hookBlock(`BLOCKED: phase "${currentNode}" 未在协议 writeWhitelist 中声明,默认拒绝写入 "${target}"`, `请在协议 writeWhitelist 中为节点 "${currentNode}" 声明允许的路径前缀`);
|
|
910
908
|
} else {
|
|
@@ -106,7 +106,7 @@ export function classify(probe, state) {
|
|
|
106
106
|
}
|
|
107
107
|
|
|
108
108
|
// 输出提示(公开描述性文案;INIT-NEEDED 含预算说明与参数指引)
|
|
109
|
-
//
|
|
109
|
+
// CONTEXT 已满足模板但无扫描记录(agent 生成后未重跑)→
|
|
110
110
|
// 提示精准动作(记录扫描时间)而非误导性的"刷新"文案。
|
|
111
111
|
export async function printDetection(runRoot, probe, verdict, out = console) {
|
|
112
112
|
if (verdict === 'skip') return;
|
|
@@ -133,7 +133,7 @@ export async function printDetection(runRoot, probe, verdict, out = console) {
|
|
|
133
133
|
}
|
|
134
134
|
|
|
135
135
|
// CONTEXT 模板 7 段标题(校验基准——agent 生成后脚本校验结构完整性)
|
|
136
|
-
//
|
|
136
|
+
// 段清单从 flow-kit/templates/CONTEXT.md 解析派生(括号前前缀),
|
|
137
137
|
// 模板缺失/解析不到时 fallback 内置(对齐 C2 段名校验模板派生模式,消灭手抄漂移)。
|
|
138
138
|
const CONTEXT_SECTIONS_FALLBACK = [
|
|
139
139
|
'## 项目概要',
|
|
@@ -7,7 +7,7 @@
|
|
|
7
7
|
// node evolve.mjs apply <候选 id> [<候选 id> ...] [--root <项目根>] [--scanner <执行工具>] [--stdout]
|
|
8
8
|
// node evolve.mjs --help | -h
|
|
9
9
|
//
|
|
10
|
-
//
|
|
10
|
+
// 单一权威:「沉淀段在场」判定(hasSection9)与归档窗口判定(isArchivedAfterTimestamp)
|
|
11
11
|
// 一律 import time-utils.mjs;时间形态 / 解析 / 天差走 nowTimestamp / formatLocalDate /
|
|
12
12
|
// parseTimestamp / daysSince——本模块不内联第二份时间正则,也不自行拼接时间字符串。
|
|
13
13
|
// 「改写前备份」的命名族与失败处置走 state-schema.mjs 的 backupBeforeWrite(单一来源)——
|
|
@@ -114,15 +114,15 @@ function usage() {
|
|
|
114
114
|
|
|
115
115
|
// ---------- 侧命令 CLI 契约(单一来源) ----------
|
|
116
116
|
// 根相对 POSIX 路径标签:三条横向命令的 CLI 摘要行与工件段落都要把绝对路径显示成项目根相对形态
|
|
117
|
-
//
|
|
118
|
-
//
|
|
117
|
+
// (跨机器可读、可直接粘回命令行)。同一显示决定不得有第二份表达(两份必然分叉)——由本模块
|
|
118
|
+
// (侧命令共享助手的既有落点)唯一导出,三条命令同源消费。
|
|
119
119
|
export function relativeLabel(root, file) {
|
|
120
120
|
return path.relative(root, file).split(path.sep).join('/');
|
|
121
121
|
}
|
|
122
122
|
|
|
123
123
|
// 三条横向命令(evolve / health / context-scan)共用本解析器:`--root <目录>` 与 `--root=<目录>`
|
|
124
|
-
// 两种形态、`--stdout`、`--help`/`-h
|
|
125
|
-
// (一条不支持等号形、`--help`
|
|
124
|
+
// 两种形态、`--stdout`、`--help`/`-h`、未知参数**各只在此处表达一次**——多份自写脚手架必然分叉
|
|
125
|
+
// (一条不支持等号形、`--help` 只有一条有、错误构造各写一遍)。位置参数语义(evolve 的
|
|
126
126
|
// scan|apply 子命令与候选 id)与命令自有取值开关由调用方声明,本解析器不认识任何业务词元。
|
|
127
127
|
// 契约要点:用法错误一律 throw(各命令顶层错误处理决定前缀,退出码统一 1);`--help` 在位置参数
|
|
128
128
|
// 之前短路(子命令之后写 `--help` 也只看用法);取值开关悬空与未知参数一律可见报错,不静默忽略。
|
|
@@ -498,7 +498,7 @@ function fieldLine(key, value) {
|
|
|
498
498
|
|
|
499
499
|
// 文件末尾追加「块」:`split('\n')` 对**以换行收尾**的文档留有一个零长度哨兵元素——它不是文档里的
|
|
500
500
|
// 一行,而是「最后一行终结符」的占位。直接在哨兵之后 push 会拼出一条**裸 LF 空行**:CRLF 文档里
|
|
501
|
-
//
|
|
501
|
+
// 同一文件出现两种行尾(实测 `-->\r\n\n\r\n---`),且末行终结符退化成一个孤立的 `\r`。
|
|
502
502
|
// 追加前摘下哨兵、追加后放回 —— 整篇行尾一致,末尾换行约定不变(LF 文档同样收敛为**单空行**)。
|
|
503
503
|
function appendBlock(lines, eol, blockLines) {
|
|
504
504
|
const sentinel = lines.length > 0 && lines[lines.length - 1] === '' ? lines.pop() : null;
|