flow-comet 1.6.1 → 1.6.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/skills/flow-comet/INSTALLED_VERSION +1 -1
- package/.flow-comet/skills/flow-comet/SKILL.md +94 -46
- package/.flow-comet/skills/flow-comet/reference/KNOWN-ISSUES-template.md +1 -1
- package/.flow-comet/skills/flow-comet/reference/commit-discipline.md +32 -0
- package/.flow-comet/skills/flow-comet/reference/dirty-worktree.md +1 -1
- package/.flow-comet/skills/flow-comet/{GUIDANCE.md → reference/entry-detail.md} +22 -30
- package/.flow-comet/skills/flow-comet/reference/fix-loop.md +57 -0
- package/.flow-comet/skills/flow-comet/reference/platform-facts.md +58 -0
- package/.flow-comet/skills/flow-comet/reference/replan.md +23 -0
- package/.flow-comet/skills/flow-comet/reference/workflow-protocol.json +1 -1
- package/.flow-comet/skills/flow-comet/scripts/comet-check.mjs +5 -4
- package/.flow-comet/skills/flow-comet/scripts/comet-hook-guard.mjs +260 -17
- package/.flow-comet/skills/flow-comet/scripts/context-init.mjs +129 -3
- package/.flow-comet/skills/flow-comet/scripts/context-scan.mjs +396 -0
- package/.flow-comet/skills/flow-comet/scripts/evolve.mjs +778 -0
- package/.flow-comet/skills/flow-comet/scripts/guard-self-test.mjs +5432 -194
- package/.flow-comet/skills/flow-comet/scripts/health.mjs +664 -0
- package/.flow-comet/skills/flow-comet/scripts/route-node.mjs +51 -4
- package/.flow-comet/skills/flow-comet/scripts/state-schema.mjs +68 -0
- package/.flow-comet/skills/flow-comet/scripts/system-test.mjs +1479 -11
- package/.flow-comet/skills/flow-comet/scripts/time-utils.mjs +133 -0
- package/.flow-comet/skills/flow-comet/scripts/workflow-guard.mjs +197 -5
- package/.flow-comet/skills/flow-comet/scripts/workflow-handoff.mjs +115 -6
- package/.flow-comet/skills/flow-comet/scripts/workflow-state.mjs +261 -29
- package/.flow-comet/skills/flow-comet-archive/SKILL.md +10 -19
- package/.flow-comet/skills/flow-comet-change/SKILL.md +10 -1
- package/.flow-comet/skills/flow-comet-compose/SKILL.md +1 -1
- package/.flow-comet/skills/flow-comet-design/SKILL.md +8 -6
- package/.flow-comet/skills/flow-comet-evolve/SKILL.md +46 -11
- package/.flow-comet/skills/flow-comet-execute/SKILL.md +58 -16
- package/.flow-comet/skills/flow-comet-health/SKILL.md +57 -16
- package/.flow-comet/skills/flow-comet-integration/SKILL.md +8 -5
- package/.flow-comet/skills/flow-comet-open/SKILL.md +5 -1
- package/.flow-comet/skills/flow-comet-plan/GUIDANCE.md +1 -1
- package/.flow-comet/skills/flow-comet-plan/SKILL.md +8 -8
- package/.flow-comet/skills/flow-comet-review/SKILL.md +9 -12
- package/.flow-comet/skills/flow-comet-subagent-execute/SKILL.md +59 -16
- package/.flow-comet/skills/flow-comet-task/SKILL.md +3 -2
- package/.flow-comet/skills/flow-comet-ui-design/SKILL.md +29 -4
- package/.flow-comet/skills/flow-comet-verify/SKILL.md +8 -17
- package/README.md +5 -5
- package/package.json +1 -1
- package/scripts/dsh-bridge.mjs +59 -26
- package/scripts/prepare-env.mjs +165 -1
- package/.flow-comet/skills/flow-comet/reference/TEST-MATRIX.md +0 -116
- package/.flow-comet/skills/flow-comet/reference/composition-report.md +0 -65
- package/.flow-comet/skills/flow-comet/reference/dsh-platform.md +0 -184
- package/.flow-comet/skills/flow-comet/reference/resolved-skills.json +0 -661
- package/.flow-comet/skills/flow-comet/reference/skill-review.md +0 -13
- package/.flow-comet/skills/flow-comet/reference/subagents/script-author.md +0 -7
- package/.flow-comet/skills/flow-comet/reference/worktree-notes.md +0 -70
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
# 平台事实(三平台通道 · 判级口径 · 实测与边界)
|
|
2
|
+
|
|
3
|
+
> **读者对象**:在任一节点上引用平台结论、构造委派 prompt、或要写「某平台支持 / 不支持」措辞的执行者与协调者。
|
|
4
|
+
> **何时读**:要判定平台能力(能否并行委派 / 谁建树 / 写通道是什么)或引用平台判级口径时读。
|
|
5
|
+
>
|
|
6
|
+
> 本文件内容**逐字搬运**自 `flow-comet-subagent-execute` 与 `flow-comet` 两册的原有段落(搬运,不重写);各节点册只留要点句与条件句。
|
|
7
|
+
|
|
8
|
+
## Codex 平台事实与当前支持面
|
|
9
|
+
|
|
10
|
+
> **Codex 平台事实与 flow-comet 当前支持面(2026-09-30 记录)**:**平台事实**——Codex 的常规用法是交互式 CLI(`codex` 无子命令)与会话内 agent,`codex exec` 只是 headless 子面;原生多代理 `multi_agent` 为 stable、默认启用(`codex features list` 可查),本机真实交互式会话日志中记录到 `spawn_agent` / `wait_agent` / `close_agent` 的实际调用——因此「Codex 不能委派 / 不使用并行委托」**不是平台事实**。**已关闭的机制缺口**——本节点此前记录「原生子代理形态未被守卫 / 白名单 / 隔离模型覆盖」的**机制缺口**,已由身份分派(载荷 `agent_id`)关闭:**三平台均可并行委派,差异只在谁建树**(Codex 无自动建树、默认共享工作区);headless 子面实测见下(仅 `codex exec`,不得外推)。
|
|
11
|
+
|
|
12
|
+
## 通道对照表(subagent-execute 侧:四属性 × 三平台)
|
|
13
|
+
|
|
14
|
+
> **三平台通道对照表(四属性 × 三平台;差异只在「谁建树」)**:
|
|
15
|
+
>
|
|
16
|
+
> | 平台 | ① 写权限通道 | 谁建树 | ②③④ |
|
|
17
|
+
> |------|--------------|--------|-------|
|
|
18
|
+
> | **Claude Code** | 身份分派(载荷含 `agent_id` / `agent_type`——**证实**:真机实测子代理载荷含二者、主会话载荷不含,与 Codex 同一判据);`.claude/worktrees/**` 路径前缀为**兼容通道**,不是唯一通道 | harness 可自动建树(`Agent` 工具的 `isolation: "worktree"`——①的一种实现,非强制) | 三平台同形 |
|
|
19
|
+
> | **Codex** | 身份分派(载荷含 `agent_id` / `agent_type`;真机实测:子代理载荷 12 键含 `agent_id`,主线程 10 键不含) | 无自动建树——默认**共享工作区** | 三平台同形 |
|
|
20
|
+
> | **dsh** | 身份分派(桥接以环境变量 `FLOW_COMET_AGENT_DEPTH` 透传正整数身份深度 **+ 通道标记 `FLOW_COMET_AGENT_DEPTH_SOURCE`**;0 / 缺失 / 无标记 = 协调者) | 平台**进程内子代理**,不建树 | 三平台同形 |
|
|
21
|
+
|
|
22
|
+
## 判级口径(三态)
|
|
23
|
+
|
|
24
|
+
> **判级口径(三态;未覆盖项显式标注、不得写成已支持)**:**证实**——Codex 交互式会话的原生子代理载荷含 `agent_id`(2026-10-04/05 真机会话实测)· CC 子代理载荷含 `agent_id` / `agent_type`(真机实测:子代理载荷含二者、主会话载荷不含,与 Codex 同一判据)· dsh 身份分派通道 · CC 的 `.claude/worktrees/**` 兼容通道(历史实证)。**推翻**——「Codex 载荷无身份字段」只对 `codex exec` headless 主线程成立,**不得外推**为平台结论。**未覆盖(显式标注,不得写成已支持)**——非 Windows 环境的 Codex 形态 · `agent_type` 取值域 · 嵌套委派载荷 · Codex hook 触发稳定性(实测 3/21;补 `--dangerously-bypass-approvals-and-sandbox` 后 5/5,**不得写成稳定保证**)· 非 `bypassPermissions` 权限模式下的载荷形态 · dsh 子代理能否带独立 cwd 的探针待补。
|
|
25
|
+
|
|
26
|
+
## 旧结论留档
|
|
27
|
+
|
|
28
|
+
> **旧结论(实测 2026-08-13;证据已不可复核,未纳入 2026-09-30 重测矩阵——不得作为现行结论)**:worktree 的 `.git` 是主仓共享——`workspace-write`/`git-write-access` 沙箱均被 Codex 硬拦截(index.lock / objects / COMMIT_EDITMSG Permission denied);子代理必须用 `sandbox_mode="danger-full-access"` 才能完成 git 提交(worktree 隔离已限定写范围,full-access 仅用于让 git 提交可行)。**信任边界**:`danger-full-access` 是宿主级信任边界(不隔离凭据/网络访问)——仅委托可信子代理,并移除委托环境中的不必要凭据。以上仅作历史留档;现行结论以探针结论与后续契约为准。
|
|
29
|
+
|
|
30
|
+
## headless 子面实测与 hook 会话 root 订正
|
|
31
|
+
|
|
32
|
+
> **headless 子面实测与 hook 会话 root 订正(依据 2026-09-30 真机重测;codex-cli 0.146.0 / Windows;仅 `codex exec --json --ephemeral` headless 子面;不得外推为平台结论)**:旧结论「手工 worktree 内的写入会被协调者白名单拦住、会话 root 仍是主仓库」被**推翻并收窄**——实测 hook 进程 cwd == 载荷 `cwd` == 会话工作根(cwd=项目 / `-C` / 手工 worktree 三形态);**Codex 原生子代理(`spawn_agent`)形态未覆盖,不得外推**。手工 worktree 形态下相对路径写入**不会**被拦:worktree 通常缺 gitignored 运行态 state → 守卫走「无活跃 workflow」放行;若 hook 命令仍指向主仓安装副本(runRoot 外),守卫因「workflow protocol file must stay inside the project root」报错退出,Codex 将 hook 失败降级为非阻塞 → 写入照常落地。**静态喂测(独立复现)**:守卫白名单只覆盖**解析后仍在 runRoot 内**的目标;`Write/Edit` 的 `file_path` 解析为 runRoot 外时跳过判定(**fail-open**,记录时点**未闭合**)——**该缺口现已被守卫关闭**:runRoot 外写入与 Bash 写命令分支**同判** `BLOCKED`(修复前的两分支不对称是历史形态),身份在场者由身份判据先行放行;记录时点的缺口表述作为边界留档保留,现行判据见守卫的 runRoot 外关断段。**`apply_patch`**:会触发 PreToolUse,但 `tool_name="Bash"`、补丁正文在 `tool_input.command`(heredoc)、**无 `file_path`**;记录时点守卫不解析补丁体 → 目标不被提取、放行(独立复验复现了载荷与守卫盲区)——**该缺口现已被守卫关闭**:补丁体按行语义解析出 `*** Update File:` / `*** Add File:` / `*** Delete File:` / `*** Move to:` 摘要行的目标后与其余写入形态**同流**(白名单与最小保护集共用同一判定入口),身份在场者仍受最小保护集拦截;「文件确实落盘」子项在复验环境因 apply_patch shim 失败未复现,首次真机重测环境曾落盘——按此差异如实理解。**hook 触发条件**:隔离 `CODEX_HOME` 无持久信任时默认 headless **不执行**项目 hook;`hooks` 特性默认 enabled、可被项目配置/开关覆盖;`codex_hooks` 是 deprecated 别名;per-invocation 信任是必要因素之一,但独立复验显示 trust-only 触发**不稳定**(3/21;补 `--dangerously-bypass-approvals-and-sandbox` 后 5/5)——**不得写成稳定/确定性保证**;持久信任与交互式 TUI 形态未覆盖。**CC 的判据不同**:CC 的守卫以**身份判据优先于路径判据**(载荷含 `agent_id` ⇒ 子代理语义);`.claude/worktrees/**` 路径前缀通道仍然在场,属**兼容通道**(写入落在该区内即放行,`file_path` 与 Bash 命令两条判定路径同语义),不再是唯一通道。
|
|
33
|
+
|
|
34
|
+
## 入口册侧:三平台通道表与实测口径(原文搬运)
|
|
35
|
+
|
|
36
|
+
**三平台通道(属性 × 平台)**——判级只取三态(**证实 / 推翻 / 未覆盖**);**未覆盖 ≠ 已验证**,不得写成已支持:
|
|
37
|
+
|
|
38
|
+
| 属性 | Claude Code | Codex | dsh |
|
|
39
|
+
|------|-------------|-------|-----|
|
|
40
|
+
| ① 写权限 | 载荷 `agent_id` / `agent_type`——**证实**(真机实测:子代理载荷含二者、主会话载荷不含;与 Codex 同一判据) | 载荷 `agent_id` + `agent_type`——**证实**(实测:子代理载荷 12 键含二者、主线程 10 键不含);守卫读 `agent_id`,与 CC 同一判据 | 桥接透传 `delegationDepth` **+ 通道标记**(`FLOW_COMET_AGENT_DEPTH_SOURCE`,守卫要求两者同时在场才接受 env 面身份——继承来的深度变量不作数)——**证实**(0.1.7-rc.2 全接缝重认证;本批收窄为「最小保护集除外」) |
|
|
41
|
+
| ② 提交隔离 | pathspec 纪律(多写者共享同一工作区形态) | 同左 | 同左 |
|
|
42
|
+
| ③ 验证隔离 | `subagent-execute` 出口锚:有 request 无 result(新 change BLOCKED / 旧 change WARN 渐进) | 同左 | 同左 |
|
|
43
|
+
| ④ 集成纪律 | `merge --no-ff` 优先;降级 cherry-pick 必记因 | 同左 | 同左 |
|
|
44
|
+
| **谁建树**(三平台唯一差异) | 可选:harness `isolation: "worktree"` 建独立树,或共享工作区直写 | 协调者**显式** `git worktree add` 并在委派 prompt 指定 `workdir`(原生子代理无自动建树;**证实**:子代理可被指向独立目录并落盘),或共享工作区直写;**建树选择的适用面**:协调者显式 `git worktree add <路径>`(手工建树)**是受支持的建树选择**——在委派 prompt 里指定 `workdir`,写入由身份通道放行(原生子代理无自动建树);**以建树绕过边界**不受支持——用独立树规避协调者禁令 / 最小保护集 / `write_files` 互斥与提交时点纪律 / handoff 与 Return Contract 证据,或把 worktree 当作四属性的替代品。 | **不建树**:进程内子代理、同一工作区运行——**无需隔离区 ≠ 无需边界**(`write_files` 互斥 + 提交时点 + 最小保护集仍构成边界) |
|
|
45
|
+
|
|
46
|
+
**交互式 Codex 实测口径(口径以下文陈述为准;该次取证为**一次性工件**、已按仓库纪律清理——**分发产物不得把结论挂靠一次性路径**)**:交互式 Codex 会话触发 `PreToolUse`(启动有 hook 信任提示)· 原生子代理工具调用触发 · `spawn_agent` / `wait_agent` / `close_agent` 类调用各自触发 · 子代理可被指向独立 worktree · 全局 `~/.codex/hooks.json` 与项目级 hook **并存生效**(合并规则未覆盖)。
|
|
47
|
+
|
|
48
|
+
**已知边界(不得写成机械保证)**:① Codex 载荷 `cwd` = 会话根,**与实际工作目录无关**(实测证实)⇒ 路径判定在 Codex 上必错,故判定序为**身份先于路径**;② 身份判据是**声明式信任边界**——守卫读到的 `agent_id` 来自宿主载荷,本机制**不声称能证明**其真实来源;③ 该次实测结论只覆盖「Windows + 交互式 Codex TUI + 该版本」形态;CC 侧身份判据的真机实测条件同样是**限定形态**——**Windows + CC v2.1.177 + `permission_mode = bypassPermissions` + 一次性仓库载体**。`agent_type` 取值域、嵌套委派载荷、非 Windows 环境、非 `bypassPermissions` 权限模式**均未覆盖**(未覆盖 ≠ 已验证,不得写成已支持)。
|
|
49
|
+
|
|
50
|
+
**三平台 `cwd` 语义对照(真机实测新增的精确事实 · 「身份先于路径」的精确理由)**——同为载荷 `cwd`,三平台语义各不相同;下表**三行各自独立**,缺一行即口径残缺:
|
|
51
|
+
|
|
52
|
+
| 平台 | 载荷 `cwd` 的实际语义 | 对路径判定的影响 |
|
|
53
|
+
|------|----------------------|------------------|
|
|
54
|
+
| **Claude Code** | **子代理的工作目录**(`…\.claude\worktrees\<agent-id>`) | **路径判定是正确的** |
|
|
55
|
+
| **Codex** | **恒等于会话根**(子代理在 worktree 写入而 `cwd` 仍是主工程) | **路径判定必错** |
|
|
56
|
+
| **dsh** | 载荷**无** `cwd`(桥接另读会话 header cwd) | 路径判定**不适用** |
|
|
57
|
+
|
|
58
|
+
> ⇒ **不是「路径判定普遍不可靠」,而是三平台 `cwd` 语义各不相同(正确 / 恒错 / 无)——只有身份判据是三平台同义的**。该对照只解释**为什么必须身份优先**,**不构成**「可以改走路径判定」的依据:契约仍走**身份判据**(三条通道同义)。
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
# 受控重校(`replan` · execute 源)
|
|
2
|
+
|
|
3
|
+
> **读者对象**:`execute` / `subagent-execute` 相位上发现计划有缺陷、需要重新校验并重签任务集的协调者与执行者。
|
|
4
|
+
> **何时读**:要判定该不该走 `replan` 重校任务集、或出口报「任务集签名不匹配」时读。
|
|
5
|
+
>
|
|
6
|
+
> 本文件内容**逐字搬运**自入口册 `flow-comet` 的「受控重校」段原文(搬运,不重写);入口册与 `flow-comet-execute` 册只留要点句与条件句。
|
|
7
|
+
|
|
8
|
+
## 规格全文(入口册原文搬运)
|
|
9
|
+
|
|
10
|
+
### 受控重校(`replan` · execute 源)
|
|
11
|
+
|
|
12
|
+
计划在执行中被证明有缺陷、任务集因此需要修订时,用受控重校重新校验并重签任务集——不跳节点、不重置任何完成态:
|
|
13
|
+
|
|
14
|
+
```bash
|
|
15
|
+
node .claude/skills/flow-comet/scripts/workflow-state.mjs replan "<reason>" --authorized-by <source> [--continue-round <n>]
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
- **何时用**:`currentNode` 停在 `execute` / `subagent-execute`,且任务集在进入该节点后被修订、出口因此报「签名不匹配」时;修订后的任务集必须自身合法。
|
|
19
|
+
- **授权**:每次调用都需要用户显式授权——`--authorized-by` 记录授权来源,位置参数记录原因;引擎把授权留痕写入当前节点的嵌套证据(`state.evidence.<node>.replanAuthorization`)。缺授权、值为空/纯空白或形态非法一律 BLOCKED,且 state 字节零改写。
|
|
20
|
+
- **上限与显式续轮**:每 change 最多 3 轮;第 4 次 BLOCKED 并给出「继续 / 停止」人工裁决指引。人工裁决「继续」须追加 `--continue-round <n>`(正整数,且 n ≥ 已用轮次 + 1)作显式续轮授权:满足则放行并计入下一轮,审计行打印续轮标记;未到上限即传该参数、或轮次不足一律 BLOCKED 且零改写。轮次与审计事件记入 `state.history`(事件类型 `replan-applied`),成功输出 `REPLAN: <node> 重新校验通过(授权源 <source>;第 n/3 轮;备份 <file>)` 与 `REASON: <text>` 两行。
|
|
21
|
+
- **备份**:改写前自动落 state 快照 `.specs/<change-id>/replan-backups/<UTC ISO>-pre-replan.json`(时间戳中的 `:` 替换为 `-`),并记录 sha256 指纹,供审查核验与手工回滚。
|
|
22
|
+
- **幂等与零改写**:目标形态已成立时的重复同形态调用 = 空操作(输出 `REPLAN: 空操作——…`,不备份、不计数、不写事件、不改写 state),不会静默跳过。
|
|
23
|
+
- **绝不豁免校验**:`replan` 只做「重新校验 + 重新签名」——判据与 plan 出口同源,处置按路径分列:**replan 重校**——任务块 / 每任务 `<verify>` / 任务图(依赖环 / 缺失依赖)任一不成立,或并行写冲突的写写(write∩write)成立,一律 BLOCKED(状态零改写);读写(read∩write)仅 WARN 不阻断;7 字段完整性只在「新模板形态(含 `<name>`)+ 新 change」缺字段时 BLOCKED,其余情形 WARN 渐进。**plan 出口**——任务块 / 每任务 `<verify>` 缺失一律 BLOCKED;任务图的依赖环 / 缺失依赖与并行写冲突的写写,对新 change BLOCKED、旧 change WARN 渐进;读写对新旧 change 均仅 WARN。它不是绕过签名门禁,而是把「签名不匹配」重新收敛为「匹配」。
|
|
@@ -16,14 +16,15 @@ const required = [
|
|
|
16
16
|
"../flow-comet-review/SKILL.md",
|
|
17
17
|
"../flow-comet-verify/SKILL.md",
|
|
18
18
|
"../flow-comet-archive/SKILL.md",
|
|
19
|
-
"reference/resolved-skills.json",
|
|
20
19
|
"reference/workflow-protocol.json",
|
|
21
20
|
"reference/decision-points.md",
|
|
22
21
|
"reference/recovery.md",
|
|
23
22
|
"reference/authoring-lanes.json",
|
|
24
|
-
"reference/
|
|
25
|
-
"reference/
|
|
26
|
-
"reference/
|
|
23
|
+
"reference/platform-facts.md",
|
|
24
|
+
"reference/fix-loop.md",
|
|
25
|
+
"reference/replan.md",
|
|
26
|
+
"reference/commit-discipline.md",
|
|
27
|
+
"reference/entry-detail.md",
|
|
27
28
|
"scripts/comet-plan.mjs",
|
|
28
29
|
"scripts/comet-check.mjs",
|
|
29
30
|
"scripts/comet-hook-guard.mjs",
|
|
@@ -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 同型,实测无可感知开销);
|
|
@@ -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
|
|
|
@@ -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 面的作用域收紧(2026-10-07):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
|
+
// 路径归一/相对化只此一份,本文件不新增第二份路径判据(L-067)。大小写敏感性与状态文件判据
|
|
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)——本文件不新增第二份文件身份判据(L-067)。
|
|
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
|
|
|
@@ -507,23 +670,72 @@ async function readHookInput() {
|
|
|
507
670
|
}
|
|
508
671
|
}
|
|
509
672
|
|
|
510
|
-
//
|
|
511
|
-
//
|
|
512
|
-
|
|
673
|
+
// 盘符根拼写归一(单一实现——只由下方写入目标解析消费,不得在别处再写一份同义归一,L-067)。
|
|
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
|
-
|
|
517
|
-
|
|
518
|
-
|
|
519
|
-
|
|
520
|
-
|
|
521
|
-
|
|
522
|
-
|
|
523
|
-
|
|
524
|
-
|
|
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
|
-
|
|
737
|
+
const filePath = toolFilePathFromHookInput(input);
|
|
738
|
+
return filePath === null ? [] : [filePath];
|
|
527
739
|
}
|
|
528
740
|
|
|
529
741
|
// 声明化写入白名单:协议 writeWhitelist(节点 id → 路径前缀数组)优先;
|
|
@@ -595,7 +807,27 @@ async function main() {
|
|
|
595
807
|
const { whitelist: PHASE_WRITE_WHITELIST, declared } = await resolvePhaseWriteWhitelist(executionMode);
|
|
596
808
|
|
|
597
809
|
const hookInput = await readHookInput();
|
|
598
|
-
|
|
810
|
+
|
|
811
|
+
// ── ①【ADR-014 决策 2·3】身份短路:身份判据**先于**路径判据求值 ──────────────────────
|
|
812
|
+
// 身份在场(载荷 agent_id / 桥接通道标记在场且 env FLOW_COMET_AGENT_DEPTH>0)⇒ 直接进入子代理
|
|
813
|
+
// 语义:**不再做路径审计**(不解析白名单、不判隔离区、不判 runRoot 内外),只判最小保护集——两个
|
|
814
|
+
// 机器面目标(状态文件 / 本次运行生效的协议文件)命中即 BLOCK,未命中即放行。
|
|
815
|
+
// env 面的短路**要求桥接通道标记同时在场**(见上方身份判据段):直接调用本文件的 CC / Codex hook
|
|
816
|
+
// 即使继承了深度变量也不进此分支——它们走协调者语义(白名单 / runRoot / worktree 检查照常执行)。
|
|
817
|
+
// 实现位置修订(规划期落定):dsh 侧的身份信号由桥接**透传**(环境变量),身份判定与保护集判定的
|
|
818
|
+
// 整条都归本文件独占——桥接不再持有任何判定,故不存在第二份实现与其分叉;决策表里「桥接侧加保护集
|
|
819
|
+
// 判定」的插入位置描述已被该修订取代,归因以本节与最小保护集段为准。
|
|
820
|
+
// 顺序锚(AC-4 ②):身份在场 + 目标在 runRoot 之外 ⇒ 放行;顺序若反转(先解析路径)必 BLOCK。
|
|
821
|
+
// 放行覆盖「手工 worktree / 独立工作区」形态:路径判定在平台载荷 cwd ≠ 实际工作目录时不可用
|
|
822
|
+
// (交互式真机探针实证),故身份通道不以路径为前置。
|
|
823
|
+
if (subagentIdentity(hookInput)) {
|
|
824
|
+
await enforceMinimalProtectionSet(hookInput);
|
|
825
|
+
hookOk('(subagent identity)');
|
|
826
|
+
return;
|
|
827
|
+
}
|
|
828
|
+
|
|
829
|
+
const fileTarget = fileWriteTargetFromHookInput(hookInput);
|
|
830
|
+
const target = fileTarget ? fileTarget.targetRel : null;
|
|
599
831
|
|
|
600
832
|
// R5: Bash 工具写路径适配(CC 与 Codex 通用)——Bash 工具的 command 字符串(无 file_path),
|
|
601
833
|
// 解析写入目标按当前节点白名单判定(与 file_path 判定同语义);未命中写入模式 = 无写入语义,放行。
|
|
@@ -608,9 +840,8 @@ async function main() {
|
|
|
608
840
|
// 声明模式未列出节点 → fail-closed(同 file_path 判定);缺省表无此节点 → 协调者默认 .specs/
|
|
609
841
|
const effectiveWhitelist = whitelist || (declared ? null : ['.specs/']);
|
|
610
842
|
for (const t of writeTargets) {
|
|
611
|
-
const
|
|
612
|
-
const
|
|
613
|
-
const targetRel = (path.isAbsolute(rel) || rel === '..' || rel.startsWith('..' + path.sep)) ? null : rel.replaceAll('\\', '/');
|
|
843
|
+
const resolvedTarget = resolveWriteTarget(t);
|
|
844
|
+
const targetRel = resolvedTarget ? resolvedTarget.targetRel : null;
|
|
614
845
|
if (targetRel !== null && blockedStateFileTarget(targetRel)) {
|
|
615
846
|
blockStateFileWrite(t);
|
|
616
847
|
}
|
|
@@ -650,6 +881,18 @@ async function main() {
|
|
|
650
881
|
return;
|
|
651
882
|
}
|
|
652
883
|
|
|
884
|
+
// ── ②【ADR-014 决策 6】runRoot 外写入的 fail-open 关断(两分支对称)──────────────────
|
|
885
|
+
// file_path 解析为项目根之外时,与上方 Bash 分支**同判**:该分支对 targetRel === null 的目标
|
|
886
|
+
// 同样落入 `allowed=false` → 拦截。修复前 file_path 分支在此静默落入后继流程(越界写无痕放过),
|
|
887
|
+
// Bash 分支却拦截 —— 同一目标因工具而异。判定条件与 Bash 分支逐条对齐(有写入语义 + currentNode
|
|
888
|
+
// 在场);身份在场者已由上方 ① 短路放行,故「手工 worktree 绝对路径写入」不受本关断影响。
|
|
889
|
+
if (fileTarget && !fileTarget.insideRunRoot && currentNode) {
|
|
890
|
+
hookBlock(
|
|
891
|
+
`BLOCKED: 写入 "${fileTarget.raw}" 不在当前节点 "${currentNode}" 允许范围(目标在项目根之外)`,
|
|
892
|
+
'恢复: 改用项目根内的路径;子代理经身份通道放行(载荷 agent_id / 桥接透传的环境变量 FLOW_COMET_AGENT_DEPTH,且桥接通道标记 FLOW_COMET_AGENT_DEPTH_SOURCE 在场)'
|
|
893
|
+
);
|
|
894
|
+
}
|
|
895
|
+
|
|
653
896
|
if (currentNode && target) {
|
|
654
897
|
if (blockedStateFileTarget(target)) {
|
|
655
898
|
blockStateFileWrite(target);
|