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.
@@ -1,9 +1,8 @@
1
1
  # flow-comet Orchestration
2
2
 
3
- This Bundle is generated by flow-comet and uses a portable control plane.
3
+ This file is generated by flow-comet and lists the installed skill tree's entry points.
4
4
 
5
5
  - Entry Skill: `skills/flow-comet/SKILL.md`
6
- - Plan script: `skills/flow-comet/scripts/comet-plan.mjs`
7
6
  - Check script: `skills/flow-comet/scripts/comet-check.mjs`
8
7
  - Hook guard script: `skills/flow-comet/scripts/comet-hook-guard.mjs`
9
8
  - Workflow state script: `skills/flow-comet/scripts/workflow-state.mjs`
@@ -1 +1 @@
1
- 1.5.1
1
+ 1.6.0
@@ -151,6 +151,21 @@ node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load <node> <ski
151
151
  - If the guard fails, do not proceed past it — 先自动诊断并执行唯一安全修复(与 Decision Core 停止条件一致);存在多个会改变范围/风险的合法恢复动作时,展示 guard 输出并询问用户。
152
152
  - If the user wants to redo a completed Node, reset its completion state and re-enter rather than creating a parallel path.
153
153
 
154
+ ### 受控重入(archive 源)
155
+
156
+ 归档后发现缺陷、且归档移动尚未发生时,用受控重入把工作归属退回 `execute` / `subagent-execute` / `review` / `verify` 之一:
157
+
158
+ ```bash
159
+ node .claude/skills/flow-comet/scripts/workflow-state.mjs reenter <target> --authorized-by <source> --reason <text> [--continue-round <n>]
160
+ ```
161
+
162
+ - **何时用**:`currentNode` 停在 `archive`、`.specs/<change-id>/` 仍在原位(归档移动尚未发生)、`status !== 'completed'`,且存在必须回到既有生命周期才能完成的修复。
163
+ - **授权**:每次调用都需要用户显式授权——命令面 `--authorized-by` 记录授权来源、`--reason` 说明原因(原因随审计记录一并落盘);引擎把授权留痕写入目标节点的嵌套证据(`state.evidence.<target>.reentryAuthorization`),缺授权或形态不合法一律 BLOCKED 且 state 字节零改写,授权不可由执行者自决(授权是声明式信任边界:`state` 只走脚本通道留痕,hook 拦工具不拦脚本,引擎按声明处理)。
164
+ - **上限与显式续轮**:每 change 最多 3 轮;第 4 次 BLOCKED 并给出「继续 / 停止」人工裁决指引。人工裁决「继续」须追加 `--continue-round <n>`(正整数,且 n ≥ 已用轮次 + 1)作显式续轮授权:满足则放行并计入下一轮、审计行打印 `第 n 轮(显式授权续轮,上限 3)`;未到上限即传该参数、或轮次不足一律 BLOCKED 且零改写。轮次与审计事件记入 `state.history`(事件类型 `reentry-applied`,含 `reason`;续轮时附 `continuationAuthorized: true`),成功输出 `REENTRY: archive → <target>(授权源 <source>;第 n/3 轮;备份 <file>)` 与 `REASON: <text>` 两行。
165
+ - **备份**:转移前自动落 state 快照 `.specs/<change-id>/.reentry-backups/<UTC ISO>-pre-<target>.json`(时间戳中的 `:` 替换为 `-`),并记录 sha256 指纹,供审查核验与手工回滚。
166
+ - **顺序**:命令成功后再写修复内容——archive 阶段写入白名单只放行 `.specs/<change-id>/KNOWN-ISSUES.md` 等少数路径;重入后写入权限跟随目标节点,此时才追加 Fix 任务 / 修改工件。
167
+ - **边界**:归档移动已发生或 change 已 `completed` → BLOCKED,走人工处置或新 change / hotfix;重复调用同一目标 → 空操作(输出 `REENTRY: 空操作——…`,不备份、不计数、不改写 state),不会静默跳过。
168
+
154
169
  ### Evidence Recording
155
170
 
156
171
  After completing a Node:
@@ -168,7 +183,8 @@ All artifacts in `.specs/<change-id>/`. Cross-change files in `.specs/` (CONTEXT
168
183
 
169
184
  | 脚本 | 用途 |
170
185
  |------|------|
171
- | `workflow-state.mjs` | 状态管理:init/status/next/select/record/advance/skill-load/execution-mode/config/verify-fail(verify 失败计数,第 4 次 BLOCKED) |
186
+ | `workflow-state.mjs` | 状态管理:init/status/next/select/record/advance/skill-load/execution-mode/config/verify-fail(verify 失败计数,第 4 次 BLOCKED)/reenter(archive 源受控重入) |
187
+ | `workflow-state.mjs reenter` | 归档后受控重入:`reenter <target> --authorized-by <source> --reason <text> [--continue-round <n>]` 把工作归属退回 execute / subagent-execute / review / verify 之一(仅 archive 源、归档移动前、每次显式用户授权、每 change 上限 3 轮,超限继续需显式续轮授权) |
172
188
  | `workflow-guard.mjs` | 节点门禁:entry/exit/verify 检查 |
173
189
  | `workflow-handoff.mjs` | 子代理交接:request/result/status |
174
190
  | `comet-plan.mjs` | 兼容别名入口(内容为 workflow-state 的别名壳) |
@@ -181,8 +197,8 @@ All artifacts in `.specs/<change-id>/`. Cross-change files in `.specs/` (CONTEXT
181
197
 
182
198
  | 字段 | 说明 | 管理者 |
183
199
  |------|------|--------|
184
- | `currentNode` | 当前活动节点 | workflow-state.mjs next/advance |
185
- | `completedNodes` | 已完成节点列表 | workflow-guard.mjs exit --apply |
200
+ | `currentNode` | 当前活动节点 | workflow-state.mjs next/advance/reenter |
201
+ | `completedNodes` | 已完成节点列表 | workflow-guard.mjs exit --apply / workflow-state.mjs reenter |
186
202
  | `evidence` | 节点证据记录 | workflow-state.mjs record |
187
203
  | `verifyFailures` | verify 失败计数 | workflow-guard.mjs (auto-increment) |
188
204
  | `verifyFailuresByChange` | 按 change 隔离的失败计数(keyed by change-id) | workflow-state.mjs / state-schema.mjs helper |
@@ -192,5 +208,7 @@ All artifacts in `.specs/<change-id>/`. Cross-change files in `.specs/` (CONTEXT
192
208
 
193
209
  手动修改这些字段可能导致 guard 校验不一致。若需修正状态,使用 `workflow-state.mjs advance` 或 `workflow-state.mjs select`。
194
210
 
211
+ `workflow-state.mjs reenter` 是 `currentNode` / `completedNodes` / `status` 的受控脚本写入点:它先落备份、写授权留痕与审计事件,再转移工作归属;除该命令与上述脚本外,不要用其他方式改这些字段。
212
+
195
213
  The route, Output Schemas, required Skill calls, and recovery state are defined by `reference/workflow-protocol.json`.
196
214
  - Resolved source Skill evidence and composition provenance: `reference/resolved-skills.json`.
@@ -7,6 +7,7 @@
7
7
 
8
8
  - **载体**:每个测试项 = 一个独立临时目录(`fs.mkdtemp`)+ 内置协议副本复制到 `<tmp>/reference/`(受保护路径要求协议文件位于 runRoot 内)+ **真实命令序列**(`init → record → guard entry/exit → handoff → hook` 的 `spawnSync` 调用)+ 断言退出码与输出关键词;测试项跑完 `rmSync` 清理。
9
9
  - **与引擎回归的关系**:`guard-self-test.mjs` 是引擎脚本的单元/场景级回归(fixture 构造为主,**场景数以套件自身输出为准**);本系统测试集是**系统级**(**A~L 共十二组,项数以套件自身输出为准**)——每个测试项走真实命令链路,验证机制在真实调用序列下生效(行为锚定归场景回归,集成正确性归系统测试)。
10
+ - **归档源受控重入的锚登记**:引擎回归按四类锚覆盖——正例(授权全链路:备份 + 转移 + 审计事件 + 授权留痕)、负例(未授权 / 授权形态非法 fail-closed)、越界(目标白名单 / 协议 enabled / 源非 archive / 归档移动已发生 / 轮次上限)、恢复(拒绝 → 补全授权放行 → 重复同目标空操作);系统测试集由 H5~H8 覆盖真实命令链路(见 H 组)。两层锚均走 `reenter <target> --authorized-by <source> --reason <text>` 真实命令通道,判定逻辑单一权威。
10
11
 
11
12
  > **本文件刻意不记录具体计数**:计数随场景/测试项增减而变化,而本文件不在计数一致性自检的覆盖范围内——写死数字会静默过期(本项目已因此复发多次)。以两套件的实际输出为准(`ALL n SCENARIOS PASSED` 与系统测试的汇总行)。
12
13
  - **运行环境**:仅 node 内置模块(child_process/fs/os/path),无网络、无第三方依赖。
@@ -22,9 +23,9 @@
22
23
 
23
24
  ### A. 状态机与路由
24
25
 
25
- 覆盖:init 全分支(状态写入/工件目录/同 id 重跑防护/分支模式)、status 节点推导与无活跃兜底、next 推进与状态漂移校正、next 未出口节点严格拦截、select 切换、advance 推进、record 基础证据、execution-mode 切换与记录、config 设置与非法值拒绝、多趟路由真实链路(并→串→交替与多波依赖)、plan 出口依赖环负例与恢复、多趟路由时序收敛、plan 出口文件依赖检出。
26
+ 覆盖:init 全分支(状态写入/工件目录/同 id 重跑防护/分支模式)、status 节点推导与无活跃兜底、next 推进与状态漂移校正、next 未出口节点严格拦截、select 切换、advance 推进、record 基础证据、execution-mode 切换与记录、config 设置与非法值拒绝、多趟路由真实链路(并→串→交替与多波依赖)、plan 出口依赖环负例与恢复、多趟路由时序收敛、plan 出口文件依赖检出、Fix 批次闭环(review/verify 源受控归位 execute → 四类出口 → 回源节点出口;回程审计行按证据分为真实修复锚、正常多趟中性回程、旧态证据不足未分类三态;越界拦截与旧 change 渐进)。
26
27
 
27
- 测试项(20):A1 init 状态写入与工件目录创建 / A2 init 分支模式与非法前缀拒绝 / A3 init 同 id 重跑防护 / A4 status 节点推导与无活跃兜底 / A5 next 推进与状态漂移校正(进行中节点保护由引擎回归覆盖)/ A6 next 未出口节点严格拦截 / A7 select 切换与缺失拒绝 / A8 advance 节点推进 / A9 record 基础证据记录 / A10 execution-mode 切换与记录 / A11 config 配置与非法值拒绝 / A12 验证失败计数按 change 隔离(切换 change 后计数独立)/ A13 多趟路由真实链路(并→串→交替与多波依赖,NODE 行多次交替直至全部 done)/ A14 plan 出口依赖环负例(BLOCK 含 depends_on 恢复指引,按指引调环后恢复通过)/ A15 多趟路由时序收敛(逐节点 exit 后 next NODE 与 guard 出口 NODE 一致)/ A16 plan 出口文件依赖检出(写写重叠 BLOCK 与恢复 + 读写弱判 WARN)/ A17 多趟平行转换后 next 可达(各转换点 next NODE 与 guard 出口 NODE 一致)/ A18 漂移容忍 exit(execute 欠账经容错路径补齐)/ A19 路由诊断静默扩展(P→S 收尾无噪音 / 畸形块仍报)/ A20 directOverride 授权约束(自切 direct 无授权 BLOCK / 协调者授权通过)。
28
+ 测试项(23):A1 init 状态写入与工件目录创建 / A2 init 分支模式与非法前缀拒绝 / A3 init 同 id 重跑防护 / A4 status 节点推导与无活跃兜底 / A5 next 推进与状态漂移校正(进行中节点保护由引擎回归覆盖)/ A6 next 未出口节点严格拦截 / A7 select 切换与缺失拒绝 / A8 advance 节点推进 / A9 record 基础证据记录 / A10 execution-mode 切换与记录 / A11 config 配置与非法值拒绝 / A12 验证失败计数按 change 隔离(切换 change 后计数独立)/ A13 多趟路由真实链路(并→串→交替与多波依赖,NODE 行多次交替直至全部 done;正常多趟收尾输出中性回程行且不出现修复回程锚)/ A14 plan 出口依赖环负例(BLOCK 含 depends_on 恢复指引,按指引调环后恢复通过)/ A15 多趟路由时序收敛(逐节点 exit 后 next NODE 与 guard 出口 NODE 一致)/ A16 plan 出口文件依赖检出(写写重叠 BLOCK 与恢复 + 读写弱判 WARN)/ A17 多趟平行转换后 next 可达(各转换点 next NODE 与 guard 出口 NODE 一致)/ A18 漂移容忍 exit(execute 欠账经容错路径补齐)/ A19 路由诊断静默扩展(P→S 收尾无噪音 / 畸形块仍报)/ A20 directOverride 授权约束(自切 direct 无授权 BLOCK / 协调者授权通过) / A21 review 源 Fix 闭环:next 归位 execute → 出口回源 review → 审查出口真实执行;真实修复保留可检索回程锚(真实命令) / A22 verify 源 Fix 回程:回 verify 而非跳过 archive + verify 出口真实执行(真实命令) / A23 Fix 越界拦截与旧 change 渐进:源节点直接 exit BLOCK(新)/WARN(旧)不卡死;多波次修复、源节点未进入、旧态证据不足输出中性未分类回程的归因子场景(真实命令)。
28
29
 
29
30
  ### B. 声明机制
30
31
 
@@ -34,9 +35,9 @@
34
35
 
35
36
  ### C. 委托链路
36
37
 
37
- 覆盖:handoff 请求/结果/状态全链路(含提交校验)、红绿证据时间序(先红后绿通过/补录拦截)、委托后 exit 证据键名契约与契约校验(通过/空交接拦截)。
38
+ 覆盖:handoff 请求/结果/状态全链路(含提交校验与零提交资格——输出为空或全部可证明被 gitignore 可合法闭环;glob / 越界 / 非 git / tracked 的零提交声明一律拒绝,不得绕过提交子集校验、拦截时 state 字节零改写)、红绿证据时间序(先红后绿通过/补录拦截)、委托后 exit 证据键名契约与契约校验(通过/空交接拦截)。
38
39
 
39
- 测试项(3):C1 handoff 全链路 / C2 红绿证据时间序 / C3 委托后 exit 契约校验。
40
+ 测试项(3):C1 handoff 全链路(含零提交资格正例与越权负例)/ C2 红绿证据时间序 / C3 委托后 exit 契约校验。
40
41
 
41
42
  ### D. hook 写白名单
42
43
 
@@ -64,9 +65,9 @@
64
65
 
65
66
  ### H. verify 与归档
66
67
 
67
- 覆盖:验证命令真实执行与超时配置、归档完整流程(遗留清单 + 目录移动 + 完成态)、归档路径声明标记查找(先移目录后 exit 顺序下标记只存归档路径)。
68
+ 覆盖:验证命令真实执行与超时配置、归档完整流程(遗留清单 + 目录移动 + 完成态)、归档路径声明标记查找(先移目录后 exit 顺序下标记只存归档路径)、归档源受控重入真实命令链路(未授权 / 授权形态非法 fail-closed 且状态字节零改写;完整授权转移 + 嵌套证据 + 审计事件 + 备份指纹;幂等重放零改写与按备份手工回滚;轮次上限后 BLOCK 与人工裁决指引)。
68
69
 
69
- 测试项(4):H1 验证命令真实执行与超时 / H2 归档完整流程 / H3 归档路径声明标记查找 / H4 归档后自动补声明标记写归档路径(不重建活动目录)。
70
+ 测试项(8):H1 验证命令真实执行与超时 / H2 归档完整流程 / H3 归档路径声明标记查找 / H4 归档后自动补声明标记写归档路径(不重建活动目录) / H5 受控重入:未授权调用 fail-closed 且状态字节零改写 / H6 受控重入:完整授权链路(转移 + 嵌套证据 + 审计事件 + 备份指纹 + 审计行) / H7 受控重入:幂等重放零改写与按备份手工回滚可执行 / H8 受控重入:轮次上限后 BLOCK 与人工裁决指引。
70
71
 
71
72
  ### I. 异常路径
72
73
 
@@ -82,9 +83,9 @@
82
83
 
83
84
  ### K. 安装器(版本标识 + 多平台)
84
85
 
85
- 覆盖:prepare-env 生成的版本标识(优先源仓库 git describe:发布版 = 精确 tag、开发态 = `<tag>-N-g<hash>`;无 git 时回退权威源随技能包分发的 INSTALLED_VERSION)精确反映源仓库状态;权威源文件与 CHANGELOG 首个版本段一致(CI release-consistency 同规则);多平台安装(平台描述符驱动:claude-code 默认零变化 / codex——技能落 `.agents/skills/`、SKILL 命令路径平台化替换、`.codex/hooks.json`(顶层 hooks 包裹层 + matcher `*`)注入、`config.toml [features] hooks` 启用、AGENTS.md 托管区、纯 codex 不生成 `.claude/`);hook 平台分支输出契约(codex = `{"decision":"block"}` deny 通道 + Bash 命令写入检测(PowerShell cmdlet / .NET File API / 重定向)、放行 `{}`;claude-code 文本输出不变);平台选择链(`--platform` 显式 / TTY 交互 / 无 TTY 探测 `.codex/`·`.claude/` / 默认 claude-code);purge 语义(缺 `--yes` 拒绝 / 重建 / 用户内容保留);平台描述符驱动防回归(main 统一调度——源码无平台分支标识,安装/清理逻辑全部封装在描述符条目;从源码提取平台逐一安装冒烟,未来新增平台自动纳入测试);dsh 平台面(三平台桥接——技能落 `.dsh/skills/`、路径替换/版本标识/AGENTS.md 托管区/purge 清理/桥接 loader 纯函数与流程态门/版本戳重装断言)。
86
+ 覆盖:prepare-env 生成的版本标识(优先源仓库 git describe:发布版 = 精确 tag、开发态 = `<tag>-N-g<hash>`;无 git 时回退权威源随技能包分发的 INSTALLED_VERSION)精确反映源仓库状态;权威源文件与 CHANGELOG 首个版本段一致(CI release-consistency 同规则);多平台安装(平台描述符驱动:claude-code 默认零变化 / codex——技能落 `.agents/skills/`、SKILL 命令路径平台化替换、`.codex/hooks.json`(顶层 hooks 包裹层 + matcher `*`)注入、`config.toml [features] hooks` 启用、AGENTS.md 托管区、纯 codex 不生成 `.claude/`);hook 平台分支输出契约(codex = `{"decision":"block"}` deny 通道 + Bash 命令写入检测(PowerShell cmdlet / .NET File API / 重定向)、放行 `{}`;claude-code 文本输出不变);平台选择链(`--platform` 显式 / TTY 交互 / 无 TTY 探测 `.codex/`·`.claude/` / 默认 claude-code);purge 语义(缺 `--yes` 拒绝 / 重建 / 用户内容保留);平台描述符驱动防回归(main 统一调度——源码无平台分支标识,安装/清理逻辑全部封装在描述符条目;从源码提取平台逐一安装冒烟,未来新增平台自动纳入测试);dsh 平台面(三平台桥接——技能落 `.dsh/skills/`、路径替换/版本标识/AGENTS.md 托管区/purge 清理/桥接 loader 纯函数与流程态门/版本戳重装断言;分发面环境判据:权威源形态真跑完整断言,安装副本形态显式「不适用」并按结果标记计通过,不静默跳过)。
86
87
 
87
- 测试项(16):K1 安装器版本标识 / K2 codex 平台安装冒烟(技能/路径替换/hooks.json/AGENTS 托管区 + 非法 hooks.json fail-safe)/ K3 hook 平台分支 JSON 契约 + CC 分支不变 / K4 平台选择链(显式/无 TTY 探测/默认/未知平台拒绝)/ K5 purge 语义(缺 --yes 拒绝/重建/用户内容保留)/ K6 平台描述符驱动(全平台安装冒烟 + main 统一调度断言)/ K7 dsh 平台安装(技能/pathReplacements/版本标识/树一致)/ K8 dsh AGENTS.md 托管区(用户内容保留 + 幂等重装)/ K9 桥接 loader 源文件/语法/复制与托管块注入(读-合并-写)/ K10 dsh purge 清理恢复(缺 --yes 拒绝/删除后重建/用户内容保留/空目录清理)/ K11 桥接 loader 纯函数与 apply 分派断言(映射/包含性/退出映射/身份分派)/ K12 桥接 loader 流程态门断言(无 state/无 activeChange/completed 放行 · 非法 JSON/未知 status deny)/ K13 hook 注入形态无关断言(basename+项目根引用)+ 旧条目幂等升级 / K14 桥接 loader 版本戳重装断言(升级/降级方向与覆盖后新戳)/ K15 桥接 loader 同源重装断言(首次安装后版本一致)/ K16 桥接 loader purge 后重建路径回归(loader 恢复与再装收敛)。
88
+ 测试项(18):K1 安装器版本标识 / K2 codex 平台安装冒烟(技能/路径替换/hooks.json/AGENTS 托管区 + 非法 hooks.json fail-safe)/ K3 hook 平台分支 JSON 契约 + CC 分支不变 / K4 平台选择链(显式/无 TTY 探测/默认/未知平台拒绝)/ K5 purge 语义(缺 --yes 拒绝/重建/用户内容保留)/ K6 平台描述符驱动(全平台安装冒烟 + main 统一调度断言)/ K7 dsh 平台安装(技能/pathReplacements/版本标识/树一致)/ K8 dsh AGENTS.md 托管区(用户内容保留 + 幂等重装)/ K9 桥接 loader 源文件/语法/复制与托管块注入(读-合并-写)/ K10 dsh purge 清理恢复(缺 --yes 拒绝/删除后重建/用户内容保留/空目录清理)/ K11 桥接 loader 纯函数与 apply 分派断言(映射/包含性/退出映射/身份分派)/ K12 桥接 loader 流程态门断言(无 state/无 activeChange/completed 放行 · 非法 JSON/未知 status deny)/ K13 hook 注入形态无关断言(basename+项目根引用)+ 旧条目幂等升级 / K14 桥接 loader 版本戳重装断言(升级/降级方向与覆盖后新戳)+ dev 态载体 bridge-check 基础版本比较(剥离开发态后缀后同基础健康 / 基础版本失配仍 FAIL);分发面环境判据:权威源形态真跑,安装副本形态显式「不适用」并按结果标记计通过(不静默跳过)/ K15 桥接 loader 同源重装断言(首次安装后版本一致)/ K16 桥接 loader purge 后重建路径回归(loader 恢复与再装收敛)/ K17 状态迁移(旧布局项目安装后状态可读且流程可继续)/ K18 分发面(环境判据与包体边界 + bin 双入口——权威源真跑/副本显式不适用 + init 词元红线)。
88
89
 
89
90
  ### L. 执行遗漏防护(真实链路)
90
91
 
@@ -16,6 +16,13 @@
16
16
 
17
17
  > 版本不匹配时拦截可能失效——必须文档警示 + 级 3 实测兜底(D9)。
18
18
 
19
+ **bridge-check 版本比较语义(基础版本比较)**:桥接健康检查比较 loader 的 `// BRIDGE_VERSION:` 发布戳与技能包 `INSTALLED_VERSION` 时,两侧先剥离 git-describe 开发态后缀 `-<领先提交数>-g<hash>`、再按基础版本比较:
20
+
21
+ - 开发态载体的 `INSTALLED_VERSION = <发布版本>-<N>-g<hash>` 是预期形态、不构成版本偏斜——与同基础版本的 loader 判健康(exit 0)。
22
+ - 语义化预发布标识(如 `1.5.0-rc.3`)不是开发态后缀、不剥离——预发布与基础版本不可互相放行。
23
+ - 归一后基础版本不同(含发布版对发布版)仍报「版本偏斜」并 exit 1;失配报告同时打印原始值与归一值,便于识别 dev 态后缀。
24
+ - loader 戳生成与发布同步纪律不变(发布戳仍取当前发布版本,随发布同步更新)。
25
+
19
26
  ## 2. tools/pre-execute 签名
20
27
 
21
28
  ```js
@@ -99,7 +106,7 @@ ctx.on('tools/pre-execute', async (exec, next) => {
99
106
  - 职责链:`tools/pre-execute` 监听 → 会话项目判定 → 参数映射 → 流程态门 → 包含性校验 → 子进程调项目本地 guard → 决策映射。
100
107
  1. **窄监听(硬性契约)**:工具名归一化(非 Write/Edit/Bash 直接 `next()`);会话 cwd(`exec.agent.session.header.cwd` 锚定,缺失回退)的最近 `.git` 项目根下**存在 `.dsh/skills/flow-comet` 才处理**,否则直接 `next()`——非 flow-comet 项目零拦截零开销(D6/R7)。
101
108
  2. **参数映射(fail-closed)**:dsh 工具名归一化到 guard CLI 契约名(Write/Edit/Bash;别名:write/writefile/file-write、edit/editfile/file-edit、bash/shell/powershell/pwsh/run_command/run-command);Write/Edit → `file_path`、Bash → `command`;形状不符/缺关键字段 → WARN + fail-closed deny(不静默放行)。
102
- 3. **流程态门(B 方案——包含性仅运行中生效)**:读项目根 `.flow-comet/flow-comet-state.json`(UTF-8 BOM 容错;判定规则锚定 guard `comet-hook-guard.mjs` L1882-1895):空闲(无 state / 无 `activeChange` / `status==='completed'`)→ 直接 `next()` 放行——跳过包含性校验与 guard 白名单(与 Claude Code / Codex 的 active-change 门语义对齐);解析失败 / 未知 status → WARN + fail-closed deny(不视为空闲放行);`activeChange` 存在且 `status==='running'` 或缺失(undefined)→ 继续下方包含性校验与 guard(现状不变)。
109
+ 3. **流程态门(B 方案——包含性仅运行中生效)**:读项目根 `.flow-comet/flow-comet-state.json`(UTF-8 BOM 容错;判定规则锚定 guard `comet-hook-guard.mjs` 的空闲态门——grep 锚点:`grep -n "if (!state.activeChange)"`):空闲(无 state / 无 `activeChange` / `status==='completed'`)→ 直接 `next()` 放行——跳过包含性校验与 guard 白名单(与 Claude Code / Codex 的 active-change 门语义对齐);解析失败 / 未知 status → WARN + fail-closed deny(不视为空闲放行);`activeChange` 存在且 `status==='running'` 或缺失(undefined)→ 继续下方包含性校验与 guard(现状不变)。
103
110
  - **空闲边界(refined)**:空闲 = 无 state / 无 activeChange / status==='completed' → 项目外写 next() 放行;解析失败 / 未知 status 保持 fail-closed deny(不视为空闲),与 Claude Code / Codex 的 guard 语义一致。
104
111
  4. **包含性校验**:Write/Edit 的 `file_path` 必须解析后位于项目根内——`realpathSync.native` 展开 Windows 8.3 短路径(词法 path.relative 会把项目内短路径误判为越界);**运行中**越界直接 deny(不进 guard——guard 侧 target=null 会跳过白名单判定 = fail-open);通过后传规范化长路径。
105
112
  5. **代理身份分派(B1——dsh 子代理=执行者)**:读 `exec.agent.session.header.delegationDepth`(`agentDepth(exec)` 纯函数)——**>0 = 子代理(执行者)→ 跳过 guard 白名单判定直接 `next()` 放行**(子代理写源码是执行者职责,对应 Claude Code worktree 子代理物理自由写;形状 fail-closed 与项目根包含性校验已在上方对子代理同样执行,不因身份放宽);**0/缺失 = 协调者 → 走 guard 白名单判定**(协调者禁令物理拦截保留)。dsh 子代理系统在 dsh-base 自带(`tool-subagent`/`subagent-spawn-in-process` 等,headless/web/tui 全 profile 激活),`childSessionMeta` 写入 delegationDepth=parentDepth+1(dsh-subagent 源码锚定 rc.6);不识别此字段会导致 subagent 执行模式下子代理写源码被 guard 白名单(execute → `.specs/`)误拦(B1,DOGFOOD-REPORT 实证)。级 3 实测(2026-08-18 UAT-7):真实模型调 subagent → 子代理(delegationDepth:1)写 `scripts/` 放行、协调者(delegationDepth:0)写同路径被 deny 保留。
@@ -150,7 +157,7 @@ ctx.on('tools/pre-execute', async (exec, next) => {
150
157
  ### rc.8 三态冒烟(2026-08-20)
151
158
 
152
159
  - 环境:dsh CLI 0.1.0-rc.8 / Harness 核心 rc.8 / dsh-tui 0.8.5
153
- - 结果:运行中协调者项目外 Write → deny;运行中子代理项目内 Write → next();空闲态(无 state)项目外 Write → next();解析失败/未知 status → fail-closed deny(system-test 61/61 ALL PASSED,K11/K12 断言覆盖)
160
+ - 结果:运行中协调者项目外 Write → deny;运行中子代理项目内 Write → next();空闲态(无 state)项目外 Write → next();解析失败/未知 status → fail-closed deny(当轮 system-test ALL PASSED,K11/K12 断言覆盖;当前基线 82/82)
154
161
  - 载体:prepare-env --platform dsh 经临时项目重推真实 ~/.dsh 桥接 loader,loader 与权威源 SHA-256 一致;真实交互式 TUI/Web 冒烟留待开放项
155
162
 
156
163
  ### 0.1.5-rc.1 全接缝认证(2026-09-10)