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.
Files changed (107) hide show
  1. package/.flow-comet/skills/flow-comet/INSTALLED_VERSION +1 -1
  2. package/.flow-comet/skills/flow-comet/SKILL.md +64 -46
  3. package/.flow-comet/skills/flow-comet/reference/KNOWN-ISSUES-template.md +1 -1
  4. package/.flow-comet/skills/flow-comet/reference/commit-discipline.md +32 -0
  5. package/.flow-comet/skills/flow-comet/reference/dirty-worktree.md +1 -1
  6. package/.flow-comet/skills/flow-comet/{GUIDANCE.md → reference/entry-detail.md} +18 -28
  7. package/.flow-comet/skills/flow-comet/reference/fix-loop.md +57 -0
  8. package/.flow-comet/skills/flow-comet/reference/platform-facts.md +58 -0
  9. package/.flow-comet/skills/flow-comet/reference/replan.md +23 -0
  10. package/.flow-comet/skills/flow-comet/scripts/comet-check.mjs +5 -4
  11. package/.flow-comet/skills/flow-comet/scripts/comet-hook-guard.mjs +266 -25
  12. package/.flow-comet/skills/flow-comet/scripts/context-init.mjs +2 -2
  13. package/.flow-comet/skills/flow-comet/scripts/evolve.mjs +6 -6
  14. package/.flow-comet/skills/flow-comet/scripts/guard-self-test.mjs +67 -16325
  15. package/.flow-comet/skills/flow-comet/scripts/health.mjs +1 -1
  16. package/.flow-comet/skills/flow-comet/scripts/items/a.mjs +1030 -0
  17. package/.flow-comet/skills/flow-comet/scripts/items/b.mjs +830 -0
  18. package/.flow-comet/skills/flow-comet/scripts/items/c.mjs +781 -0
  19. package/.flow-comet/skills/flow-comet/scripts/items/d.mjs +99 -0
  20. package/.flow-comet/skills/flow-comet/scripts/items/e.mjs +185 -0
  21. package/.flow-comet/skills/flow-comet/scripts/items/f.mjs +90 -0
  22. package/.flow-comet/skills/flow-comet/scripts/items/g.mjs +59 -0
  23. package/.flow-comet/skills/flow-comet/scripts/items/h.mjs +815 -0
  24. package/.flow-comet/skills/flow-comet/scripts/items/i.mjs +77 -0
  25. package/.flow-comet/skills/flow-comet/scripts/items/j.mjs +75 -0
  26. package/.flow-comet/skills/flow-comet/scripts/items/k.mjs +1427 -0
  27. package/.flow-comet/skills/flow-comet/scripts/items/l.mjs +275 -0
  28. package/.flow-comet/skills/flow-comet/scripts/items/m.mjs +614 -0
  29. package/.flow-comet/skills/flow-comet/scripts/lib/count-derivation.mjs +97 -0
  30. package/.flow-comet/skills/flow-comet/scripts/lib/fix-loop-node.mjs +196 -0
  31. package/.flow-comet/skills/flow-comet/scripts/lib/guard-evidence-gates.mjs +553 -0
  32. package/.flow-comet/skills/flow-comet/scripts/lib/guard-gates.mjs +837 -0
  33. package/.flow-comet/skills/flow-comet/scripts/lib/guard-routing.mjs +404 -0
  34. package/.flow-comet/skills/flow-comet/scripts/lib/guard-state-io.mjs +404 -0
  35. package/.flow-comet/skills/flow-comet/scripts/lib/guard-template-fidelity.mjs +302 -0
  36. package/.flow-comet/skills/flow-comet/scripts/lib/guard-uidesign.mjs +133 -0
  37. package/.flow-comet/skills/flow-comet/scripts/lib/reentry-node.mjs +237 -0
  38. package/.flow-comet/skills/flow-comet/scripts/lib/replan-node.mjs +209 -0
  39. package/.flow-comet/skills/flow-comet/scripts/lib/state-branch.mjs +49 -0
  40. package/.flow-comet/skills/flow-comet/scripts/lib/state-bridgecheck.mjs +201 -0
  41. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-admin.mjs +141 -0
  42. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-flow.mjs +700 -0
  43. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-recovery.mjs +578 -0
  44. package/.flow-comet/skills/flow-comet/scripts/lib/state-determine.mjs +52 -0
  45. package/.flow-comet/skills/flow-comet/scripts/lib/state-evolve-hint.mjs +55 -0
  46. package/.flow-comet/skills/flow-comet/scripts/lib/state-explain.mjs +106 -0
  47. package/.flow-comet/skills/flow-comet/scripts/lib/state-intelscan.mjs +58 -0
  48. package/.flow-comet/skills/flow-comet/scripts/lib/state-io.mjs +147 -0
  49. package/.flow-comet/skills/flow-comet/scripts/lib/state-skillmarkers.mjs +189 -0
  50. package/.flow-comet/skills/flow-comet/scripts/lib/system-fixtures.mjs +1441 -0
  51. package/.flow-comet/skills/flow-comet/scripts/lib/task-graph.mjs +471 -0
  52. package/.flow-comet/skills/flow-comet/scripts/lib/test-assertions.mjs +509 -0
  53. package/.flow-comet/skills/flow-comet/scripts/lib/test-fixtures.mjs +1228 -0
  54. package/.flow-comet/skills/flow-comet/scripts/lib/test-helpers.mjs +237 -0
  55. package/.flow-comet/skills/flow-comet/scripts/lib/text-anchor-checks.mjs +2484 -0
  56. package/.flow-comet/skills/flow-comet/scripts/protocol-utils.mjs +2 -2
  57. package/.flow-comet/skills/flow-comet/scripts/route-node.mjs +73 -1077
  58. package/.flow-comet/skills/flow-comet/scripts/scenarios/a.mjs +966 -0
  59. package/.flow-comet/skills/flow-comet/scripts/scenarios/b.mjs +1233 -0
  60. package/.flow-comet/skills/flow-comet/scripts/scenarios/c.mjs +1382 -0
  61. package/.flow-comet/skills/flow-comet/scripts/scenarios/d.mjs +483 -0
  62. package/.flow-comet/skills/flow-comet/scripts/scenarios/e.mjs +1388 -0
  63. package/.flow-comet/skills/flow-comet/scripts/scenarios/f.mjs +1466 -0
  64. package/.flow-comet/skills/flow-comet/scripts/scenarios/g.mjs +1364 -0
  65. package/.flow-comet/skills/flow-comet/scripts/scenarios/h.mjs +1287 -0
  66. package/.flow-comet/skills/flow-comet/scripts/scenarios/i.mjs +1436 -0
  67. package/.flow-comet/skills/flow-comet/scripts/scenarios/j.mjs +1384 -0
  68. package/.flow-comet/skills/flow-comet/scripts/scenarios/k.mjs +1338 -0
  69. package/.flow-comet/skills/flow-comet/scripts/scenarios/l.mjs +1484 -0
  70. package/.flow-comet/skills/flow-comet/scripts/scenarios/m.mjs +971 -0
  71. package/.flow-comet/skills/flow-comet/scripts/state-schema.mjs +14 -1
  72. package/.flow-comet/skills/flow-comet/scripts/system-test.mjs +58 -6692
  73. package/.flow-comet/skills/flow-comet/scripts/time-utils.mjs +4 -4
  74. package/.flow-comet/skills/flow-comet/scripts/workflow-guard.mjs +151 -2428
  75. package/.flow-comet/skills/flow-comet/scripts/workflow-handoff.mjs +116 -9
  76. package/.flow-comet/skills/flow-comet/scripts/workflow-state.mjs +29 -2086
  77. package/.flow-comet/skills/flow-comet-archive/SKILL.md +10 -19
  78. package/.flow-comet/skills/flow-comet-change/SKILL.md +2 -3
  79. package/.flow-comet/skills/flow-comet-compose/SKILL.md +1 -1
  80. package/.flow-comet/skills/flow-comet-design/SKILL.md +6 -6
  81. package/.flow-comet/skills/flow-comet-execute/SKILL.md +58 -16
  82. package/.flow-comet/skills/flow-comet-integration/SKILL.md +8 -5
  83. package/.flow-comet/skills/flow-comet-open/SKILL.md +5 -1
  84. package/.flow-comet/skills/flow-comet-plan/GUIDANCE.md +1 -1
  85. package/.flow-comet/skills/flow-comet-plan/SKILL.md +8 -8
  86. package/.flow-comet/skills/flow-comet-review/SKILL.md +9 -12
  87. package/.flow-comet/skills/flow-comet-subagent-execute/SKILL.md +59 -16
  88. package/.flow-comet/skills/flow-comet-task/SKILL.md +3 -2
  89. package/.flow-comet/skills/flow-comet-ui-design/SKILL.md +3 -3
  90. package/.flow-comet/skills/flow-comet-verify/SKILL.md +8 -17
  91. package/README.md +53 -70
  92. package/package.json +3 -2
  93. package/scripts/dsh-bridge.mjs +59 -26
  94. package/scripts/lib/installer-cleanup.mjs +152 -0
  95. package/scripts/lib/installer-flowkit.mjs +119 -0
  96. package/scripts/lib/installer-hooks.mjs +363 -0
  97. package/scripts/lib/installer-loader.mjs +220 -0
  98. package/scripts/lib/installer-migrate.mjs +236 -0
  99. package/scripts/lib/installer-platforms.mjs +314 -0
  100. package/scripts/prepare-env.mjs +36 -1164
  101. package/.flow-comet/skills/flow-comet/reference/TEST-MATRIX.md +0 -116
  102. package/.flow-comet/skills/flow-comet/reference/composition-report.md +0 -65
  103. package/.flow-comet/skills/flow-comet/reference/dsh-platform.md +0 -184
  104. package/.flow-comet/skills/flow-comet/reference/resolved-skills.json +0 -661
  105. package/.flow-comet/skills/flow-comet/reference/skill-review.md +0 -13
  106. package/.flow-comet/skills/flow-comet/reference/subagents/script-author.md +0 -7
  107. package/.flow-comet/skills/flow-comet/reference/worktree-notes.md +0 -70
@@ -9,7 +9,9 @@ import {
9
9
  readWorkflowProtectedFile,
10
10
  resolveProtocol,
11
11
  validateProtocolSchema,
12
+ workflowFileObjectIdentity,
12
13
  workflowPathInside,
14
+ workflowSameFileObject,
13
15
  } from './protocol-utils.mjs';
14
16
  // 运行时路径常量(单一来源:state-schema.mjs)——本脚本每次工具调用都会执行,故此处只 import
15
17
  // 同包内的本地 ESM 模块(与已存在的 protocol-utils.mjs import 同型,实测无可感知开销);
@@ -51,7 +53,7 @@ function hookOk(extra) {
51
53
  }
52
54
 
53
55
  // 拦截输出:Codex 分支输出 {"decision":"block",reason} + exit 0(实测确认的 Codex deny 通道——
54
- // 2026-08-13 Codex 0.146:exit 2 / permissionDecision:"deny" 均不被 enforce,decision:"block"+exit 0 生效);
56
+ // exit 2 / permissionDecision:"deny" 均不被 enforce,decision:"block"+exit 0 生效);
55
57
  // Claude Code 分支既有文本 + exit 2。
56
58
  function hookBlock(mainLine, detailLine) {
57
59
  if (isCodex) {
@@ -141,6 +143,39 @@ function unquotedSegmentEnd(command, masked, from) {
141
143
  return command.length;
142
144
  }
143
145
 
146
+ // apply_patch heredoc 正文定位(Codex 承载补丁的真实调用形态:tool_name="Bash"、补丁正文写在 command
147
+ // 文本里、载荷没有 file_path)。识别按**行语义**而非 token 形状:命令名必须是 apply_patch,其前只允许
148
+ // 空白或「同段前置命令 + 分隔符」(`cd x && apply_patch …` 可认,引号内的同名文本因不满足前缀形态不认),
149
+ // 命令名与重定向之间不得出现分隔符或别的重定向(`[^;&|<>]*` 收口)。命令名不受引号掩码影响——真实
150
+ // 载荷里有把该命令包在宿主 here-string 里传入的形态,按行文本识别才能覆盖。
151
+ // 正文止于与定界串等值的整行(`<<-` 形态允许行首制表符),**不越过定界行**——否则后续命令行会被吞进
152
+ // 正文,下游命令的参数会被读成写入目标而误拦。
153
+ // 未闭合形态按「正文到命令末尾」处理:产出与否取决于正文里是否真有补丁摘要行,最坏是多产出一个目标
154
+ // (偏拦截方向),不会漏掉补丁真正要写的文件。
155
+ function applyPatchHeredocs(command) {
156
+ const bodies = [];
157
+ const startRe = /^(?:[^;&|<>]*[;&|]+[ \t]*)?[ \t]*apply_patch\b[^;&|<>]*<<(-?)[ \t]*("[^"]*"|'[^']*'|[^\s;&|<>]+)/i;
158
+ const lines = command.split('\n');
159
+ for (let index = 0; index < lines.length; index++) {
160
+ const start = startRe.exec(lines[index].replace(/\r$/, ''));
161
+ if (!start) continue;
162
+ const delimiter = start[2].replace(/^["']|["']$/g, '');
163
+ if (delimiter === '') continue;
164
+ const stripLeadingTabs = start[1] === '-';
165
+ let bodyEnd = lines.length;
166
+ for (let cursor = index + 1; cursor < lines.length; cursor++) {
167
+ const line = lines[cursor].replace(/\r$/, '');
168
+ if ((stripLeadingTabs ? line.replace(/^\t+/, '') : line) === delimiter) {
169
+ bodyEnd = cursor;
170
+ break;
171
+ }
172
+ }
173
+ bodies.push(lines.slice(index + 1, bodyEnd).join('\n'));
174
+ index = bodyEnd; // 正文不再参与起始扫描(同一段正文不会被解析两次)
175
+ }
176
+ return bodies;
177
+ }
178
+
144
179
  function codexWriteTargetsFromCommand(command) {
145
180
  if (typeof command !== 'string' || command.trim() === '') return [];
146
181
  const targets = [];
@@ -226,6 +261,18 @@ function codexWriteTargetsFromCommand(command) {
226
261
  t = t.trim().replace(/^["']|["']$/g, '');
227
262
  if (t && t !== 'NUL' && t !== '/dev/null' && !targets.includes(t)) targets.push(t);
228
263
  }
264
+ // apply_patch heredoc 的补丁摘要行(见上方 applyPatchHeredocs):`*** Update File: <p>` /
265
+ // `*** Add File: <p>` / `*** Delete File: <p>` / `*** Move to: <p>` 各带一个写入目标,
266
+ // 抽取后与其余形态**同流**——本函数的返回值既是白名单判定的输入,也是最小保护集判定的输入
267
+ // (调用方共用),故此处不新增第二份判定;路径归一与同一性比较沿用既有 resolveWriteTarget 与
268
+ // protocol-utils 的包含性判据。值经既有 addTarget 归一(剥引号 / 过滤空设备 / 去重)。
269
+ const patchHeaderRe = /^\*\*\*\s+(?:Update File|Add File|Delete File|Move to):\s*(.+?)\s*$/;
270
+ for (const body of applyPatchHeredocs(command)) {
271
+ for (const rawLine of body.split('\n')) {
272
+ const header = patchHeaderRe.exec(rawLine.replace(/\r$/, ''));
273
+ if (header) addTarget(header[1]);
274
+ }
275
+ }
229
276
  return targets;
230
277
  }
231
278
 
@@ -331,9 +378,9 @@ async function agentWorktreeWriteStaysIsolated(targetRel) {
331
378
  // (fail-closed)。hook 拦工具不拦脚本——脚本通道天然不触发 PreToolUse,不受影响。
332
379
  // 与 M1 归档白名单收窄同型:保护机器文件不被越权手改(含 direct 模式下白名单 [''] 曾
333
380
  // 放行 state 写入的 fail-open 缺口——执行者自切 direct 越权写的物理入口)。
334
- // 大小写变体闭合(CodeRabbit 采纳):win32/darwin 文件系统大小写不敏感,`.Flow-Comet/Flow-Comet-
381
+ // 大小写变体闭合:win32/darwin 文件系统大小写不敏感,`.Flow-Comet/Flow-Comet-
335
382
  // State.json` 与机器状态文件指向同一实体——目标路径先 toLowerCase() 再与机器状态相对路径
336
- // 比较,变体同等 BLOCK(修复前精确等值比较被变体绕过 → fail-open)。其他平台
383
+ // 比较,变体同等 BLOCK(精确等值比较会被变体绕过 → fail-open)。其他平台
337
384
  // (大小写敏感文件系统)变体是不同文件,保持精确等值比较(不误拦合法路径)。
338
385
  // 取值唯一来源 = state-schema.mjs 的 RUNTIME_STATE_PATH(项目根相对的 POSIX 路径)。
339
386
  // 本文件不再硬编码该路径——命名空间/文件名变更只改 state-schema.mjs 一处。
@@ -352,6 +399,49 @@ function blockStateFileWrite(target) {
352
399
  );
353
400
  }
354
401
 
402
+ // ── 身份判据(ADR-014 决策 2:三平台同一、无平台分支)────────────────────────────
403
+ // 载荷 `agent_id` 在场(CC / Codex 原生子代理,真机载荷实测形态)或**桥接通道自证在场**且环境变量
404
+ // FLOW_COMET_AGENT_DEPTH 为正整数(dsh 桥接透传)⇒ 子代理语义。两输入面归并为**一个**判据
405
+ // (消费方只问「是不是子代理」),不得下沉为 `if (platform === ...)` 之类的平台分支。
406
+ // dsh 面按**实现位置修订**(规划期落定):桥接只把委派深度透传进环境变量,身份判定与保护集判定的
407
+ // 整条都归本文件独占——桥接不再持有任何一份判定,两侧没有分叉的余地(归因以本节为准)。
408
+ // env 面的作用域收紧:CC / Codex 生成的 hook **直接**调用本文件、并不自证是 dsh——
409
+ // 只看深度变量时,该变量一旦被继承进这些 hook 的进程环境(父进程导出 / 包装脚本转发),守卫就会在
410
+ // phase / worktree / runRoot 检查**之前**走子代理路径返回,只剩最小保护集兜底。故桥接在注入深度的
411
+ // 同时注入**通道标记** FLOW_COMET_AGENT_DEPTH_SOURCE=dsh-bridge;env 面身份**要求两者同时在场**
412
+ // (标记缺失或值不符 ⇒ 恒按协调者语义,即便深度为正整数)——判据只读环境变量,**不从载荷形状
413
+ // 推断桥接**(载荷形状是宿主合同,不是通道证据)。
414
+ // 取值形态按实证收窄:载荷面只认**非空字符串**(空串 / 缺失 / 非字符串一律非身份);env 面只认
415
+ // **纯十进制正整数字符串**("0" = 协调者 ⇒ 非身份;空串 / 负数 / 小数 / 带杂质一律非身份);
416
+ // 通道标记只认**精确等值**(大小写 / 空白变体一律不认)。
417
+ // 收窄方向是 fail-closed:不命中的形态退回既有路径判定——该回退态即 AC-2 (b) 写死的「维持现状」,
418
+ // 不得读成新判据的放宽。
419
+ function payloadAgentIdentity(input) {
420
+ if (!input || typeof input !== 'object') return '';
421
+ const raw = input.agent_id;
422
+ return typeof raw === 'string' && raw.trim() !== '' ? raw.trim() : '';
423
+ }
424
+
425
+ function agentDepthIdentity(value) {
426
+ if (typeof value !== 'string') return 0;
427
+ const trimmed = value.trim();
428
+ if (!/^\d+$/.test(trimmed)) return 0;
429
+ const depth = Number.parseInt(trimmed, 10);
430
+ return Number.isSafeInteger(depth) && depth > 0 ? depth : 0;
431
+ }
432
+
433
+ // 桥接通道自证(取值与守卫侧判据同源的常量放在本文件——单一实现,桥接只按同一字面注入):
434
+ // 标记在场才说明这次调用来自 dsh 桥接;标记不在场 ⇒ env 面身份恒为 0(继承来的深度变量不作数)。
435
+ const BRIDGE_DEPTH_CHANNEL_MARKER = 'dsh-bridge';
436
+ function bridgedAgentDepthIdentity() {
437
+ if (process.env.FLOW_COMET_AGENT_DEPTH_SOURCE !== BRIDGE_DEPTH_CHANNEL_MARKER) return 0;
438
+ return agentDepthIdentity(process.env.FLOW_COMET_AGENT_DEPTH);
439
+ }
440
+
441
+ function subagentIdentity(input) {
442
+ return payloadAgentIdentity(input) !== '' || bridgedAgentDepthIdentity() > 0;
443
+ }
444
+
355
445
  const __dirname = path.dirname(fileURLToPath(import.meta.url));
356
446
  const packageRoot = path.resolve(__dirname, '..');
357
447
  // 项目根判定兜底链(级3 cwd 漂移实测暴露的 H5 残留缺口收口):
@@ -390,6 +480,79 @@ const runRoot = (() => {
390
480
  // 协议路径取 env FLOW_COMET_PROTOCOL 或默认 <packageRoot>/reference/workflow-protocol.json
391
481
  const protocolPath = resolveProtocol(packageRoot, runRoot, []);
392
482
 
483
+ // ── 最小保护集(ADR-014 决策 4):身份在场时仍受拦的两个目标 ─────────────────────
484
+ // 判定的整条实现只在本文件(dsh 桥接按**实现位置修订**只透传身份信号、不另存一份保护集判定),
485
+ // 故「桥接侧加保护集判定」的旧插入位置描述已被该修订取代——归因以本节为准。
486
+ // ① 机器状态文件(判据 = 上方 blockedStateFileTarget,取值来源 state-schema.mjs 的
487
+ // RUNTIME_STATE_PATH);② 本次运行**实际生效**的协议文件(取值来源 = 上方 protocol-utils
488
+ // resolveProtocol 的解析结果——本文件不另造第二份协议路径口径)。
489
+ // 同一性判定复用 protocol-utils 既有受保护路径判据 workflowPathInside(互含 ⇒ 同一路径):
490
+ // 路径归一/相对化只此一份,本文件不新增第二份路径判据。大小写敏感性与状态文件判据
491
+ // 同口径(共用 CASE_INSENSITIVE_FS 策略常量;win32 的 path.relative 本身已按小写比较)。
492
+ function isSameWorkflowPath(left, right) {
493
+ const fold = (value) => (CASE_INSENSITIVE_FS ? value.toLowerCase() : value);
494
+ const a = fold(path.resolve(left));
495
+ const b = fold(path.resolve(right));
496
+ return workflowPathInside(a, b) && workflowPathInside(b, a);
497
+ }
498
+
499
+ function blockedProtocolFileTarget(absoluteTarget) {
500
+ return isSameWorkflowPath(protocolPath, absoluteTarget);
501
+ }
502
+
503
+ // 保护集的**物理**同一性判定(词法判定的别名闭合):8.3 短路径 / 符号链接 / junction / 硬链接
504
+ // 是同一文件实体的不同拼写,词法比较看不见它们(身份放行下保护集是唯一防线,故须闭合)。
505
+ // 判据复用 protocol-utils.mjs 导出的文件身份比较判据(workflowFileObjectIdentity +
506
+ // workflowSameFileObject)——本文件不新增第二份文件身份判据。
507
+ // 目标不存在(新建文件是常态)或 stat 失败 ⇒ 无法证明同一 ⇒ 返回 false(退回词法判定);
508
+ // 诚实边界:物理判定只证明「此刻存在且同一」,不证明「将来仍同一」(与 TOCTOU 同族的既有限制)。
509
+ async function isSameProtectedFileObject(targetAbsolute, protectedAbsolute) {
510
+ try {
511
+ const [targetStat, protectedStat] = await Promise.all([
512
+ fs.stat(targetAbsolute, { bigint: true }),
513
+ fs.stat(protectedAbsolute, { bigint: true }),
514
+ ]);
515
+ return workflowSameFileObject(
516
+ workflowFileObjectIdentity(targetStat),
517
+ workflowFileObjectIdentity(protectedStat),
518
+ );
519
+ } catch {
520
+ return false;
521
+ }
522
+ }
523
+
524
+ // 拦截报文沿用既有 hookBlock 风格(主行 BLOCKED + 详情行恢复指引)——新增判定不引入新输出形态。
525
+ function blockProtocolFileWrite(target) {
526
+ hookBlock(
527
+ `BLOCKED: 协议文件 "${target}" 禁工具写(身份放行不放行协议保护路径——协议变更走协议文件通道)`,
528
+ '恢复: 协议文件由人工/安装器通道维护;不得由工具写覆盖运行中协议'
529
+ );
530
+ }
531
+
532
+ // 身份在场时的最小保护集执行:候选写入目标逐个判定,命中即以既有报文风格拦截(hookBlock
533
+ // 不返回);未命中 ⇒ 返回(调用方按子代理语义放行)。判定入口唯一——身份短路与保护集判定都在此收口。
534
+ // 两个目标各双判据:词法同一性(规范拼写)+ 物理同一性(别名形态)。
535
+ async function enforceMinimalProtectionSet(hookInput) {
536
+ const stateFileAbsolute = path.join(runRoot, ...STATE_FILE_REL.split('/'));
537
+ for (const candidate of protectedCandidateTargets(hookInput)) {
538
+ const resolvedTarget = resolveWriteTarget(candidate);
539
+ if (resolvedTarget === null) continue;
540
+ if (
541
+ blockedProtocolFileTarget(resolvedTarget.absolute) ||
542
+ (await isSameProtectedFileObject(resolvedTarget.absolute, protocolPath))
543
+ ) {
544
+ blockProtocolFileWrite(resolvedTarget.raw);
545
+ }
546
+ if (resolvedTarget.targetRel !== null) {
547
+ if (
548
+ blockedStateFileTarget(resolvedTarget.targetRel) ||
549
+ (await isSameProtectedFileObject(resolvedTarget.absolute, stateFileAbsolute))
550
+ ) {
551
+ blockStateFileWrite(resolvedTarget.raw);
552
+ }
553
+ }
554
+ }
555
+ }
393
556
 
394
557
  const WORKFLOW_PROJECT_FILE_MAX_BYTES = 2 * 1024 * 1024;
395
558
 
@@ -402,8 +565,8 @@ const WORKFLOW_PROJECT_FILE_MAX_BYTES = 2 * 1024 * 1024;
402
565
 
403
566
  // 受保护路径三判据(workflowPathInside / inspectWorkflowProtectedPath /
404
567
  // readWorkflowProtectedFile)与私有身份比较函数是 protocol-utils.mjs 的**单一来源**——
405
- // 本文件此前各持一份逐字节相同的副本,两侧注释互指「同源」;副本已删除,改为 import
406
- // (见文件头 import 列表)。改判据只需改 protocol-utils.mjs 一处。
568
+ // 本文件不另持副本(两份逐字节相同的副本必然分叉,互指「同源」的注释不是同步机制),
569
+ // 一律 import(见文件头 import 列表)——改判据只需改 protocol-utils.mjs 一处。
407
570
 
408
571
  function workflowRelativeSegments(value, label, allowWildcards = false) {
409
572
  if (typeof value !== 'string') throw new Error(label + ' must be a string');
@@ -507,23 +670,72 @@ async function readHookInput() {
507
670
  }
508
671
  }
509
672
 
510
- // 计算写入目标相对 runRoot 的路径(正斜杠分隔,供 PHASE_WRITE_WHITELIST 前缀匹配)。
511
- // 无法解析或目标在项目根之外时返回 null。
512
- function writeTargetFromHookInput(input) {
673
+ // 盘符根拼写归一(单一实现——只由下方写入目标解析消费,不得在别处再写一份同义归一)。
674
+ // Windows 上 Git-Bash 类 shell 把 `D:\<剩余>` 写作 `/d/<剩余>`(盘符小写 + 正斜杠)。win32 的
675
+ // 目标解析把该拼写读成「**当前盘根**下的 \d\<剩余>」而非 `D:\<剩余>`:同一文件于是被判成根外,
676
+ // 词法相对化与物理同一性两道保护集判据同时失守(身份放行下保护集是唯一防线 ⇒ 静默放行)。
677
+ // 故必须在**解析之前**归一到盘符拼写——归一落在此处,全部消费方(白名单 / 保护集 / 根外关断)
678
+ // 自动同判,且同一文件的各等价拼写(大小写、正反斜杠)收敛到同一结果。
679
+ // 形态严格限定为**单字母盘符根**:盘符字母之后必须是路径分隔符或字符串结束。放宽这一条会把
680
+ // `/dev/<…>`、`/etc/<…>`、`/tmp/<…>` 一类普通 POSIX 绝对路径误读成 `<盘符>:\ev\<…>`。
681
+ // 非 win32 平台该拼写是货真价实的 POSIX 绝对路径,语义不同——不归一(保持既有判定)。
682
+ const DRIVE_ROOT_SPELLING_RE = /^\/([A-Za-z])(?=\/|$)/;
683
+ function normalizeDriveRootSpelling(rawTarget) {
684
+ if (process.platform !== 'win32') return rawTarget;
685
+ const match = DRIVE_ROOT_SPELLING_RE.exec(rawTarget);
686
+ if (match === null) return rawTarget;
687
+ const drive = match[1].toUpperCase() + ':';
688
+ const rest = rawTarget.slice(2);
689
+ return rest === '' ? drive + '/' : drive + rest;
690
+ }
691
+
692
+ // 写入目标解析(单一实现——白名单判定 / 保护集判定 / runRoot 外关断三条判定共用,禁止各处
693
+ // 再写一份相对化口径)。`rawTarget` 为 file_path 或命令级写入 token:绝对路径原样、相对路径
694
+ // 按 runRoot 解析;Windows 的盘符根拼写先经上方同义归一(否则同一文件的不同拼写会异判)。
695
+ // 返回结构:
696
+ // insideRunRoot=true → targetRel = 相对 runRoot 的 POSIX 路径(白名单前缀匹配 / 状态文件比较)
697
+ // insideRunRoot=false → targetRel = null(项目根之外;由「runRoot 外写入关断」与 Bash 分支同判)
698
+ // 无写入语义(非字符串 / 空串)→ null(该目标不参与任何判定)。
699
+ function resolveWriteTarget(rawTarget) {
700
+ if (typeof rawTarget !== 'string') return null;
701
+ const trimmed = rawTarget.trim();
702
+ if (trimmed === '') return null;
703
+ const absolute = path.resolve(runRoot, normalizeDriveRootSpelling(trimmed));
704
+ const relative = path.relative(runRoot, absolute);
705
+ const outside =
706
+ path.isAbsolute(relative) || relative === '..' || relative.startsWith('..' + path.sep);
707
+ return {
708
+ raw: trimmed,
709
+ absolute,
710
+ insideRunRoot: !outside,
711
+ targetRel: outside ? null : relative === '' ? '.' : relative.replaceAll('\\', '/'),
712
+ };
713
+ }
714
+
715
+ // file_path 载荷面提取(单一实现:file_path 形态判定与保护集候选共用同一提取口径)。
716
+ function toolFilePathFromHookInput(input) {
513
717
  if (!input || typeof input !== 'object') return null;
514
718
  const toolInput =
515
719
  input.tool_input && typeof input.tool_input === 'object' ? input.tool_input : null;
516
- const filePath =
517
- toolInput && typeof toolInput.file_path === 'string' ? toolInput.file_path : null;
518
- if (!filePath) return null;
519
- const absolute = path.isAbsolute(filePath)
520
- ? path.resolve(filePath)
521
- : path.resolve(runRoot, filePath);
522
- const relative = path.relative(runRoot, absolute);
523
- if (path.isAbsolute(relative) || relative === '..' || relative.startsWith('..' + path.sep)) {
524
- return null;
720
+ return toolInput && typeof toolInput.file_path === 'string' ? toolInput.file_path : null;
721
+ }
722
+
723
+ // file_path 形态(Write / Edit / …):载荷无 file_path ⇒ null(无写入语义,不判定)。
724
+ // 与命令级 token 共用 resolveWriteTarget——同一路径不因所选工具而异。
725
+ function fileWriteTargetFromHookInput(input) {
726
+ return resolveWriteTarget(toolFilePathFromHookInput(input));
727
+ }
728
+
729
+ // 保护集判定的候选目标(工具形态适配,单一实现):Bash 取命令级写入 token(与下方 Bash 分支
730
+ // 同一提取器);其余工具取 file_path。无写入语义 ⇒ 空数组(身份放行不对无写入语义的调用做判定)。
731
+ function protectedCandidateTargets(input) {
732
+ if (input && typeof input === 'object' && input.tool_name === 'Bash') {
733
+ const toolInput =
734
+ input.tool_input && typeof input.tool_input === 'object' ? input.tool_input : null;
735
+ return codexWriteTargetsFromCommand(toolInput ? toolInput.command : null);
525
736
  }
526
- return relative === '' ? '.' : relative.replaceAll('\\', '/');
737
+ const filePath = toolFilePathFromHookInput(input);
738
+ return filePath === null ? [] : [filePath];
527
739
  }
528
740
 
529
741
  // 声明化写入白名单:协议 writeWhitelist(节点 id → 路径前缀数组)优先;
@@ -561,8 +773,6 @@ async function resolvePhaseWriteWhitelist(executionMode) {
561
773
  // archive 白名单:归档阶段仅遗留清单(KNOWN-ISSUES.md)可写入 change 目录(先写后移),
562
774
  // 其余 change 工件不可改(收窄为精确文件——放宽到整个目录会让归档阶段可改任意
563
775
  // 工件且无校验,防线变宽);<change-id> 占位符由 targetAllowed 替换为当前 change;
564
- // 目录移动由 .specs/archive/ 覆盖(2026-08-15 修复:此前仅 .specs/archive/ 导致按文档
565
- // 流程被 BLOCK;2026-08-16 收窄为精确文件)
566
776
  'archive': ['.specs/archive/', '.specs/<change-id>/KNOWN-ISSUES.md', '.specs/CHANGELOG.md', '.specs/LESSONS.md', 'STATE.md'],
567
777
  },
568
778
  declared: false,
@@ -595,7 +805,27 @@ async function main() {
595
805
  const { whitelist: PHASE_WRITE_WHITELIST, declared } = await resolvePhaseWriteWhitelist(executionMode);
596
806
 
597
807
  const hookInput = await readHookInput();
598
- const target = writeTargetFromHookInput(hookInput);
808
+
809
+ // ── ①【ADR-014 决策 2·3】身份短路:身份判据**先于**路径判据求值 ──────────────────────
810
+ // 身份在场(载荷 agent_id / 桥接通道标记在场且 env FLOW_COMET_AGENT_DEPTH>0)⇒ 直接进入子代理
811
+ // 语义:**不再做路径审计**(不解析白名单、不判隔离区、不判 runRoot 内外),只判最小保护集——两个
812
+ // 机器面目标(状态文件 / 本次运行生效的协议文件)命中即 BLOCK,未命中即放行。
813
+ // env 面的短路**要求桥接通道标记同时在场**(见上方身份判据段):直接调用本文件的 CC / Codex hook
814
+ // 即使继承了深度变量也不进此分支——它们走协调者语义(白名单 / runRoot / worktree 检查照常执行)。
815
+ // 实现位置修订(规划期落定):dsh 侧的身份信号由桥接**透传**(环境变量),身份判定与保护集判定的
816
+ // 整条都归本文件独占——桥接不再持有任何判定,故不存在第二份实现与其分叉;决策表里「桥接侧加保护集
817
+ // 判定」的插入位置描述已被该修订取代,归因以本节与最小保护集段为准。
818
+ // 顺序锚(AC-4 ②):身份在场 + 目标在 runRoot 之外 ⇒ 放行;顺序若反转(先解析路径)必 BLOCK。
819
+ // 放行覆盖「手工 worktree / 独立工作区」形态:路径判定在平台载荷 cwd ≠ 实际工作目录时不可用
820
+ // (交互式真机探针实证),故身份通道不以路径为前置。
821
+ if (subagentIdentity(hookInput)) {
822
+ await enforceMinimalProtectionSet(hookInput);
823
+ hookOk('(subagent identity)');
824
+ return;
825
+ }
826
+
827
+ const fileTarget = fileWriteTargetFromHookInput(hookInput);
828
+ const target = fileTarget ? fileTarget.targetRel : null;
599
829
 
600
830
  // R5: Bash 工具写路径适配(CC 与 Codex 通用)——Bash 工具的 command 字符串(无 file_path),
601
831
  // 解析写入目标按当前节点白名单判定(与 file_path 判定同语义);未命中写入模式 = 无写入语义,放行。
@@ -608,9 +838,8 @@ async function main() {
608
838
  // 声明模式未列出节点 → fail-closed(同 file_path 判定);缺省表无此节点 → 协调者默认 .specs/
609
839
  const effectiveWhitelist = whitelist || (declared ? null : ['.specs/']);
610
840
  for (const t of writeTargets) {
611
- const absolute = path.resolve(runRoot, t);
612
- const rel = path.relative(runRoot, absolute);
613
- const targetRel = (path.isAbsolute(rel) || rel === '..' || rel.startsWith('..' + path.sep)) ? null : rel.replaceAll('\\', '/');
841
+ const resolvedTarget = resolveWriteTarget(t);
842
+ const targetRel = resolvedTarget ? resolvedTarget.targetRel : null;
614
843
  if (targetRel !== null && blockedStateFileTarget(targetRel)) {
615
844
  blockStateFileWrite(t);
616
845
  }
@@ -650,6 +879,18 @@ async function main() {
650
879
  return;
651
880
  }
652
881
 
882
+ // ── ②【ADR-014 决策 6】runRoot 外写入的 fail-open 关断(两分支对称)──────────────────
883
+ // file_path 解析为项目根之外时,与上方 Bash 分支**同判**:该分支对 targetRel === null 的目标
884
+ // 同样落入 `allowed=false` → 拦截。否则 file_path 分支会静默落入后继流程(越界写无痕放过),
885
+ // Bash 分支却拦截 —— 同一目标因工具而异。判定条件与 Bash 分支逐条对齐(有写入语义 + currentNode
886
+ // 在场);身份在场者已由上方 ① 短路放行,故「手工 worktree 绝对路径写入」不受本关断影响。
887
+ if (fileTarget && !fileTarget.insideRunRoot && currentNode) {
888
+ hookBlock(
889
+ `BLOCKED: 写入 "${fileTarget.raw}" 不在当前节点 "${currentNode}" 允许范围(目标在项目根之外)`,
890
+ '恢复: 改用项目根内的路径;子代理经身份通道放行(载荷 agent_id / 桥接透传的环境变量 FLOW_COMET_AGENT_DEPTH,且桥接通道标记 FLOW_COMET_AGENT_DEPTH_SOURCE 在场)'
891
+ );
892
+ }
893
+
653
894
  if (currentNode && target) {
654
895
  if (blockedStateFileTarget(target)) {
655
896
  blockStateFileWrite(target);
@@ -661,7 +902,7 @@ async function main() {
661
902
  hookBlock(`BLOCKED: phase "${currentNode}" 不允许写入 "${target}"`, `允许范围: ${whitelist.join(', ')}`);
662
903
  }
663
904
  } else if (declared) {
664
- // 审查补充(2026-08-08):协议声明了 writeWhitelist 但未列出当前节点 → fail-closed 拒绝
905
+ // 协议声明了 writeWhitelist 但未列出当前节点 → fail-closed 拒绝
665
906
  // (漏声明节点不放行——防协议作者漏列导致防线出洞)
666
907
  hookBlock(`BLOCKED: phase "${currentNode}" 未在协议 writeWhitelist 中声明,默认拒绝写入 "${target}"`, `请在协议 writeWhitelist 中为节点 "${currentNode}" 声明允许的路径前缀`);
667
908
  } else {
@@ -106,7 +106,7 @@ export function classify(probe, state) {
106
106
  }
107
107
 
108
108
  // 输出提示(公开描述性文案;INIT-NEEDED 含预算说明与参数指引)
109
- // C 优化(2026-08-10):CONTEXT 已满足模板但无扫描记录(agent 生成后未重跑)→
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
- // 2026-08-10 改进:段清单从 flow-kit/templates/CONTEXT.md 解析派生(括号前前缀),
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
- // 单一权威(L-067):「沉淀段在场」判定(hasSection9)与归档窗口判定(isArchivedAfterTimestamp)
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
- // (跨机器可读、可直接粘回命令行)。此前 evolve 内联、context-scan 自持一份同名助手——同一显示
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` 只有一条有、错误构造三份各写一遍)。位置参数语义(evolve 的
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
- // 同一文件出现两种行尾(评审实测 `-->\r\n\n\r\n---`),且末行终结符退化成一个孤立的 `\r`。
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;