agentic-flow-kit 1.5.0 → 1.7.0

package/modules/hosts/claude/commands/wf-build.md

@@ -8,6 +8,12 @@ description: Build 阶段:起 plan + 实现代码 + 自验(确认后才动代码
 
 > AI 起草 plan,用户确认;进计划模式列改动,用户确认;最后才动代码。两道确认门。
 
+## 0. 三件套合并预览（L2/L3 起草期，2026-10-09 engine-quality-round2 C）
+
+起草 intent / spec / plan 任一件后，**在输出草稿全文前先给三件要点总览**（各一件：目标 / 关键取舍 /
+验收判据 diff，合计 ≤12 行）——用户一次看整体再逐件拍板，省三次盲确认的上下文切换。
+确认纪律不变：逐件过目全文 + 逐件 `confirm-doc` 代录（禁并录、禁复用同句）。本阶段总览侧重：plan 任务拆解与两道确认门位置。
+
 ## 1. 执行
 
 ### 1.1 起草 plan
@@ -53,6 +59,7 @@ description: Build 阶段:起 plan + 实现代码 + 自验(确认后才动代码
 ## 4. 改权威源后必跑（薄适配同步防漏）
 
 - 改 `templates/_agents/{commands,roles}/*.md` 正文后跑 `node bin/flow-kit.mjs sync-hosts --diff` → 拍板 → `--apply` 单向同步（只动正文段，frontmatter 不动）；口径与边界详见 `.agents/commands/sync-hosts.md`
+- 改根 `AGENTS.md`（owned 常驻面）后跑 `node .agents/scripts/edit-face-check.mjs`——工作树面快检（阶段索引/引用/预算 advisory），别等提交门才发觉砍坏（2026-10-09 B2）
 
 ## 5. 改 doctor / check-loop 后必跑（三处口径对账）
 

package/modules/hosts/claude/commands/wf-design.md

@@ -6,6 +6,12 @@ description: Design 阶段:起 spec(L2/L3 强制,L1 可省略)
 
 > L2/L3 强制;L1 走快车道(直接跳 `next: build.md` 起草 Quick-Plan)。
 
+## 0. 三件套合并预览（L2/L3 起草期，2026-10-09 engine-quality-round2 C）
+
+起草 intent / spec / plan 任一件后，**在输出草稿全文前先给三件要点总览**（各一件：目标 / 关键取舍 /
+验收判据 diff，合计 ≤12 行）——用户一次看整体再逐件拍板，省三次盲确认的上下文切换。
+确认纪律不变：逐件过目全文 + 逐件 `confirm-doc` 代录（禁并录、禁复用同句）。本阶段总览侧重：spec 方案取舍与 L3 复核安排。
+
 ## 1. 执行
 
 1. 确认同名入口文档已批准：新需求为 approved intent，修复为已确认的 incident 草稿；否则拒绝，分别回 `plan.md` / `maintain.md`（2026-09-30 起机器强制：fill-spec / confirm-doc 对前置未过直接拒绝 exit 2、不落盘不记账）。

package/modules/hosts/claude/commands/wf-new-task.md

@@ -27,6 +27,8 @@ description: AI-Native 闭环总入口:6 阶段指令索引(Plan→Design→Buil
 | **协作道**(敏捷优先,审计异步补) | L0 例行 / L1 实现级 | L0 直接 commit,豁免 intent;L1 快车道(intent 一句话确认 + 极简 plan)即动工。独立复核不设同步前置,check-loop 与事后 review 兜底;确认/代录可 `--batch` 批量(仅 L0/L1) |
 | **防御道**(严谨优先,确认同步拦) | L2 规则/契约 / L3 数据与运行时结构 | 同步确认门:spec 确认通过方可起草 plan,plan 确认后方可动手;L3 加新会话独立复核,未确认不放行 |
 
+> **L2/L3 起草期合并预览**：三件套起草按 [design.md §0](design.md) 一次呈现要点总览（逐件确认代录不变）。
+>
 > 定级结果落 intent frontmatter `risk_level`(=级别,`fill-intent.mjs` 自动写入,机器选道用);协作道勾触达红线会被 check-loop 判「红线判低」hard 拦(就高升级 L2/L3 并补同名 spec)。
 
 ## 3. 路由判断

package/modules/hosts/codex/commands/wf-build.md

@@ -8,6 +8,12 @@ description: Build 阶段:起 plan + 实现代码 + 自验(确认后才动代码
 
 > AI 起草 plan,用户确认;进计划模式列改动,用户确认;最后才动代码。两道确认门。
 
+## 0. 三件套合并预览（L2/L3 起草期，2026-10-09 engine-quality-round2 C）
+
+起草 intent / spec / plan 任一件后，**在输出草稿全文前先给三件要点总览**（各一件：目标 / 关键取舍 /
+验收判据 diff，合计 ≤12 行）——用户一次看整体再逐件拍板，省三次盲确认的上下文切换。
+确认纪律不变：逐件过目全文 + 逐件 `confirm-doc` 代录（禁并录、禁复用同句）。本阶段总览侧重：plan 任务拆解与两道确认门位置。
+
 ## 1. 执行
 
 ### 1.1 起草 plan
@@ -53,6 +59,7 @@ description: Build 阶段:起 plan + 实现代码 + 自验(确认后才动代码
 ## 4. 改权威源后必跑（薄适配同步防漏）
 
 - 改 `templates/_agents/{commands,roles}/*.md` 正文后跑 `node bin/flow-kit.mjs sync-hosts --diff` → 拍板 → `--apply` 单向同步（只动正文段，frontmatter 不动）；口径与边界详见 `.agents/commands/sync-hosts.md`
+- 改根 `AGENTS.md`（owned 常驻面）后跑 `node .agents/scripts/edit-face-check.mjs`——工作树面快检（阶段索引/引用/预算 advisory），别等提交门才发觉砍坏（2026-10-09 B2）
 
 ## 5. 改 doctor / check-loop 后必跑（三处口径对账）
 

package/modules/hosts/codex/commands/wf-design.md

@@ -6,6 +6,12 @@ description: Design 阶段:起 spec(L2/L3 强制,L1 可省略)
 
 > L2/L3 强制;L1 走快车道(直接跳 `next: build.md` 起草 Quick-Plan)。
 
+## 0. 三件套合并预览（L2/L3 起草期，2026-10-09 engine-quality-round2 C）
+
+起草 intent / spec / plan 任一件后，**在输出草稿全文前先给三件要点总览**（各一件：目标 / 关键取舍 /
+验收判据 diff，合计 ≤12 行）——用户一次看整体再逐件拍板，省三次盲确认的上下文切换。
+确认纪律不变：逐件过目全文 + 逐件 `confirm-doc` 代录（禁并录、禁复用同句）。本阶段总览侧重：spec 方案取舍与 L3 复核安排。
+
 ## 1. 执行
 
 1. 确认同名入口文档已批准：新需求为 approved intent，修复为已确认的 incident 草稿；否则拒绝，分别回 `plan.md` / `maintain.md`（2026-09-30 起机器强制：fill-spec / confirm-doc 对前置未过直接拒绝 exit 2、不落盘不记账）。

package/modules/hosts/codex/commands/wf-new-task.md

@@ -27,6 +27,8 @@ description: AI-Native 闭环总入口:6 阶段指令索引(Plan→Design→Buil
 | **协作道**(敏捷优先,审计异步补) | L0 例行 / L1 实现级 | L0 直接 commit,豁免 intent;L1 快车道(intent 一句话确认 + 极简 plan)即动工。独立复核不设同步前置,check-loop 与事后 review 兜底;确认/代录可 `--batch` 批量(仅 L0/L1) |
 | **防御道**(严谨优先,确认同步拦) | L2 规则/契约 / L3 数据与运行时结构 | 同步确认门:spec 确认通过方可起草 plan,plan 确认后方可动手;L3 加新会话独立复核,未确认不放行 |
 
+> **L2/L3 起草期合并预览**：三件套起草按 [design.md §0](design.md) 一次呈现要点总览（逐件确认代录不变）。
+>
 > 定级结果落 intent frontmatter `risk_level`(=级别,`fill-intent.mjs` 自动写入,机器选道用);协作道勾触达红线会被 check-loop 判「红线判低」hard 拦(就高升级 L2/L3 并补同名 spec)。
 
 ## 3. 路由判断

package/modules/hosts/cursor/commands/wf-build.md

@@ -8,6 +8,12 @@ description: Build 阶段:起 plan + 实现代码 + 自验(确认后才动代码
 
 > AI 起草 plan,用户确认;进计划模式列改动,用户确认;最后才动代码。两道确认门。
 
+## 0. 三件套合并预览（L2/L3 起草期，2026-10-09 engine-quality-round2 C）
+
+起草 intent / spec / plan 任一件后，**在输出草稿全文前先给三件要点总览**（各一件：目标 / 关键取舍 /
+验收判据 diff，合计 ≤12 行）——用户一次看整体再逐件拍板，省三次盲确认的上下文切换。
+确认纪律不变：逐件过目全文 + 逐件 `confirm-doc` 代录（禁并录、禁复用同句）。本阶段总览侧重：plan 任务拆解与两道确认门位置。
+
 ## 1. 执行
 
 ### 1.1 起草 plan
@@ -53,6 +59,7 @@ description: Build 阶段:起 plan + 实现代码 + 自验(确认后才动代码
 ## 4. 改权威源后必跑（薄适配同步防漏）
 
 - 改 `templates/_agents/{commands,roles}/*.md` 正文后跑 `node bin/flow-kit.mjs sync-hosts --diff` → 拍板 → `--apply` 单向同步（只动正文段，frontmatter 不动）；口径与边界详见 `.agents/commands/sync-hosts.md`
+- 改根 `AGENTS.md`（owned 常驻面）后跑 `node .agents/scripts/edit-face-check.mjs`——工作树面快检（阶段索引/引用/预算 advisory），别等提交门才发觉砍坏（2026-10-09 B2）
 
 ## 5. 改 doctor / check-loop 后必跑（三处口径对账）
 

package/modules/hosts/cursor/commands/wf-design.md

@@ -6,6 +6,12 @@ description: Design 阶段:起 spec(L2/L3 强制,L1 可省略)
 
 > L2/L3 强制;L1 走快车道(直接跳 `next: build.md` 起草 Quick-Plan)。
 
+## 0. 三件套合并预览（L2/L3 起草期，2026-10-09 engine-quality-round2 C）
+
+起草 intent / spec / plan 任一件后，**在输出草稿全文前先给三件要点总览**（各一件：目标 / 关键取舍 /
+验收判据 diff，合计 ≤12 行）——用户一次看整体再逐件拍板，省三次盲确认的上下文切换。
+确认纪律不变：逐件过目全文 + 逐件 `confirm-doc` 代录（禁并录、禁复用同句）。本阶段总览侧重：spec 方案取舍与 L3 复核安排。
+
 ## 1. 执行
 
 1. 确认同名入口文档已批准：新需求为 approved intent，修复为已确认的 incident 草稿；否则拒绝，分别回 `plan.md` / `maintain.md`（2026-09-30 起机器强制：fill-spec / confirm-doc 对前置未过直接拒绝 exit 2、不落盘不记账）。

package/modules/hosts/cursor/commands/wf-new-task.md

@@ -27,6 +27,8 @@ description: AI-Native 闭环总入口:6 阶段指令索引(Plan→Design→Buil
 | **协作道**(敏捷优先,审计异步补) | L0 例行 / L1 实现级 | L0 直接 commit,豁免 intent;L1 快车道(intent 一句话确认 + 极简 plan)即动工。独立复核不设同步前置,check-loop 与事后 review 兜底;确认/代录可 `--batch` 批量(仅 L0/L1) |
 | **防御道**(严谨优先,确认同步拦) | L2 规则/契约 / L3 数据与运行时结构 | 同步确认门:spec 确认通过方可起草 plan,plan 确认后方可动手;L3 加新会话独立复核,未确认不放行 |
 
+> **L2/L3 起草期合并预览**：三件套起草按 [design.md §0](design.md) 一次呈现要点总览（逐件确认代录不变）。
+>
 > 定级结果落 intent frontmatter `risk_level`(=级别,`fill-intent.mjs` 自动写入,机器选道用);协作道勾触达红线会被 check-loop 判「红线判低」hard 拦(就高升级 L2/L3 并补同名 spec)。
 
 ## 3. 路由判断

package/modules/hosts/opencode/commands/wf-build.md

@@ -8,6 +8,12 @@ description: Build 阶段 · 起 plan + 实现代码 + 自验（两道确认门
 
 > AI 起草 plan,用户确认;进计划模式列改动,用户确认;最后才动代码。两道确认门。
 
+## 0. 三件套合并预览（L2/L3 起草期，2026-10-09 engine-quality-round2 C）
+
+起草 intent / spec / plan 任一件后，**在输出草稿全文前先给三件要点总览**（各一件：目标 / 关键取舍 /
+验收判据 diff，合计 ≤12 行）——用户一次看整体再逐件拍板，省三次盲确认的上下文切换。
+确认纪律不变：逐件过目全文 + 逐件 `confirm-doc` 代录（禁并录、禁复用同句）。本阶段总览侧重：plan 任务拆解与两道确认门位置。
+
 ## 1. 执行
 
 ### 1.1 起草 plan
@@ -53,6 +59,7 @@ description: Build 阶段 · 起 plan + 实现代码 + 自验（两道确认门
 ## 4. 改权威源后必跑（薄适配同步防漏）
 
 - 改 `templates/_agents/{commands,roles}/*.md` 正文后跑 `node bin/flow-kit.mjs sync-hosts --diff` → 拍板 → `--apply` 单向同步（只动正文段，frontmatter 不动）；口径与边界详见 `.agents/commands/sync-hosts.md`
+- 改根 `AGENTS.md`（owned 常驻面）后跑 `node .agents/scripts/edit-face-check.mjs`——工作树面快检（阶段索引/引用/预算 advisory），别等提交门才发觉砍坏（2026-10-09 B2）
 
 ## 5. 改 doctor / check-loop 后必跑（三处口径对账）
 

package/modules/hosts/opencode/commands/wf-design.md

@@ -6,6 +6,12 @@ description: Design 阶段 · 起 spec（L2/L3 强制，L1 可省略直接进 bu
 
 > L2/L3 强制;L1 走快车道(直接跳 `next: build.md` 起草 Quick-Plan)。
 
+## 0. 三件套合并预览（L2/L3 起草期，2026-10-09 engine-quality-round2 C）
+
+起草 intent / spec / plan 任一件后，**在输出草稿全文前先给三件要点总览**（各一件：目标 / 关键取舍 /
+验收判据 diff，合计 ≤12 行）——用户一次看整体再逐件拍板，省三次盲确认的上下文切换。
+确认纪律不变：逐件过目全文 + 逐件 `confirm-doc` 代录（禁并录、禁复用同句）。本阶段总览侧重：spec 方案取舍与 L3 复核安排。
+
 ## 1. 执行
 
 1. 确认同名入口文档已批准：新需求为 approved intent，修复为已确认的 incident 草稿；否则拒绝，分别回 `plan.md` / `maintain.md`（2026-09-30 起机器强制：fill-spec / confirm-doc 对前置未过直接拒绝 exit 2、不落盘不记账）。

package/modules/hosts/opencode/commands/wf-new-task.md

@@ -27,6 +27,8 @@ description: AI-Native 闭环总入口 · 6 阶段路由（新需求 → plan /
 | **协作道**(敏捷优先,审计异步补) | L0 例行 / L1 实现级 | L0 直接 commit,豁免 intent;L1 快车道(intent 一句话确认 + 极简 plan)即动工。独立复核不设同步前置,check-loop 与事后 review 兜底;确认/代录可 `--batch` 批量(仅 L0/L1) |
 | **防御道**(严谨优先,确认同步拦) | L2 规则/契约 / L3 数据与运行时结构 | 同步确认门:spec 确认通过方可起草 plan,plan 确认后方可动手;L3 加新会话独立复核,未确认不放行 |
 
+> **L2/L3 起草期合并预览**：三件套起草按 [design.md §0](design.md) 一次呈现要点总览（逐件确认代录不变）。
+>
 > 定级结果落 intent frontmatter `risk_level`(=级别,`fill-intent.mjs` 自动写入,机器选道用);协作道勾触达红线会被 check-loop 判「红线判低」hard 拦(就高升级 L2/L3 并补同名 spec)。
 
 ## 3. 路由判断

package/modules/hosts/trae/commands/wf-build.md

@@ -9,6 +9,12 @@ description: Build 阶段 · 起 plan + 实现代码 + 自验（两道确认门
 
 > AI 起草 plan,用户确认;进计划模式列改动,用户确认;最后才动代码。两道确认门。
 
+## 0. 三件套合并预览（L2/L3 起草期，2026-10-09 engine-quality-round2 C）
+
+起草 intent / spec / plan 任一件后，**在输出草稿全文前先给三件要点总览**（各一件：目标 / 关键取舍 /
+验收判据 diff，合计 ≤12 行）——用户一次看整体再逐件拍板，省三次盲确认的上下文切换。
+确认纪律不变：逐件过目全文 + 逐件 `confirm-doc` 代录（禁并录、禁复用同句）。本阶段总览侧重：plan 任务拆解与两道确认门位置。
+
 ## 1. 执行
 
 ### 1.1 起草 plan
@@ -54,6 +60,7 @@ description: Build 阶段 · 起 plan + 实现代码 + 自验（两道确认门
 ## 4. 改权威源后必跑（薄适配同步防漏）
 
 - 改 `templates/_agents/{commands,roles}/*.md` 正文后跑 `node bin/flow-kit.mjs sync-hosts --diff` → 拍板 → `--apply` 单向同步（只动正文段，frontmatter 不动）；口径与边界详见 `.agents/commands/sync-hosts.md`
+- 改根 `AGENTS.md`（owned 常驻面）后跑 `node .agents/scripts/edit-face-check.mjs`——工作树面快检（阶段索引/引用/预算 advisory），别等提交门才发觉砍坏（2026-10-09 B2）
 
 ## 5. 改 doctor / check-loop 后必跑（三处口径对账）
 

package/modules/hosts/trae/commands/wf-design.md

@@ -7,6 +7,12 @@ description: Design 阶段 · 起 spec（L2/L3 强制，L1 可省略直接进 wf
 
 > L2/L3 强制;L1 走快车道(直接跳 `next: build.md` 起草 Quick-Plan)。
 
+## 0. 三件套合并预览（L2/L3 起草期，2026-10-09 engine-quality-round2 C）
+
+起草 intent / spec / plan 任一件后，**在输出草稿全文前先给三件要点总览**（各一件：目标 / 关键取舍 /
+验收判据 diff，合计 ≤12 行）——用户一次看整体再逐件拍板，省三次盲确认的上下文切换。
+确认纪律不变：逐件过目全文 + 逐件 `confirm-doc` 代录（禁并录、禁复用同句）。本阶段总览侧重：spec 方案取舍与 L3 复核安排。
+
 ## 1. 执行
 
 1. 确认同名入口文档已批准：新需求为 approved intent，修复为已确认的 incident 草稿；否则拒绝，分别回 `plan.md` / `maintain.md`（2026-09-30 起机器强制：fill-spec / confirm-doc 对前置未过直接拒绝 exit 2、不落盘不记账）。

package/modules/hosts/trae/commands/wf-new-task.md

@@ -28,6 +28,8 @@ description: 闭环总入口 · 路由判断（新需求 → wf-plan / 修复
 | **协作道**(敏捷优先,审计异步补) | L0 例行 / L1 实现级 | L0 直接 commit,豁免 intent;L1 快车道(intent 一句话确认 + 极简 plan)即动工。独立复核不设同步前置,check-loop 与事后 review 兜底;确认/代录可 `--batch` 批量(仅 L0/L1) |
 | **防御道**(严谨优先,确认同步拦) | L2 规则/契约 / L3 数据与运行时结构 | 同步确认门:spec 确认通过方可起草 plan,plan 确认后方可动手;L3 加新会话独立复核,未确认不放行 |
 
+> **L2/L3 起草期合并预览**：三件套起草按 [design.md §0](design.md) 一次呈现要点总览（逐件确认代录不变）。
+>
 > 定级结果落 intent frontmatter `risk_level`(=级别,`fill-intent.mjs` 自动写入,机器选道用);协作道勾触达红线会被 check-loop 判「红线判低」hard 拦(就高升级 L2/L3 并补同名 spec)。
 
 ## 3. 路由判断

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-flow-kit",
-  "version": "1.5.0",
+  "version": "1.7.0",
   "description": "AI-Native 闭环工作流 + wiki 知识层脚手架——flow-kit init 一条命令为新项目装好 .agents 工作流引擎（阶段命令/角色契约/门禁钩子/kb 检索/看板/规则面预算）+ workflow 文档闭环 + wiki 知识库，装完自包含、零运行时依赖",
   "type": "module",
   "scripts": {

package/src/run-tests.mjs

@@ -11,16 +11,17 @@ import { fileURLToPath } from 'node:url';
 
 const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
 
+// src/ 侧按盘面枚举，不硬编码清单（2026-10-09 审查 P0-1）——此前硬编码 8 项，`src/sync-hosts.test.mjs`
+// 漏挂：npm test 不跑它，CI 也盖不住（ci.yml shipped 步骤只 glob `.agents/scripts/*.test.mjs`），
+// 而 `templates/_agents/commands/sync-hosts.md:62`「npm test 含 sync-hosts.test.mjs 8 场景」随模板
+// 下发 5 个装户宿主。检查 20 只扫 `templates/_agents/scripts/` 面，结构上抓不到 src/ 漏挂。
+// 改 glob 后：新增 src 测试文件不可能再被静默漏跑（枚举漂移由盘面兜住，不靠人记得补）。
+// 含宿主门禁模块回归（2026-09-27 host-gates-p1：dotnet-ca BRE 豁免/fail-closed + trae 强推 token 化）。
 const nodeSuites = [
-  'src/sync.test.mjs',
-  'src/init.test.mjs',
-  'src/pack.test.mjs',
-  'src/gates.test.mjs',
-  'src/fresh-init.test.mjs',
-  'src/stack-profile.test.mjs',
-  // 宿主门禁模块回归（2026-09-27 host-gates-p1：dotnet-ca BRE 豁免/fail-closed + trae 强推 token 化）
-  'src/gate-dotnet-ca.test.mjs',
-  'src/trae-hooks.test.mjs',
+  ...fs.readdirSync(path.join(ROOT, 'src'))
+    .filter((f) => f.endsWith('.test.mjs'))
+    .sort()
+    .map((f) => `src/${f}`),
   ...fs.readdirSync(path.join(ROOT, 'templates/_agents/scripts'))
     .filter((f) => f.endsWith('.test.mjs'))
     .sort()
@@ -46,4 +47,10 @@ for (const rel of nodeSuites) {
 }
 
 console.log(`\n${failed ? `❌ ${failed} 个套件失败` : '✅ 全部套件通过'}`);
+// 机器可读汇总行（2026-10-09 审查 P0-2）：verify.mjs 的凭证计数**只认这一行**。
+// 此前它 pop 通配「合计: PASS n / FAIL n」，而 45+ 套件每个都打印自己那行同形文本——
+// 取到的是字母序最后一个套件的场景数（本仓实况：workflows-check.test.mjs 的 15），
+// 于是「一行机器事实」的 passed 字段落成了错的事实。独立前缀 + 套件口径，嵌套同形行不再被误取。
+// 口径：SUITES = 本编排器实际执行的套件数（lint 不计入；lint 红照样 exit 1，凭证不落）。
+console.log(`[run-tests] 合计: SUITES ${nodeSuites.length} / FAILED ${failed}`);
 process.exit(failed ? 1 : 0);

package/src/sync-hosts.mjs

@@ -47,93 +47,113 @@ function listMd(dir) {
 //   roles    权威源 → 全部宿主 agents 各一份
 // hostDirOf：宿主 → 适配目录名。包源布局 = 宿主键（modules/hosts/opencode/…）；装户布局 = HOSTS[h].dir
 // （项目根下 .opencode/…，带点）——2026-10-07 sync-hosts-target-fix 加装户支持时引入。
-function pairsFor(authRel, hostDirOf = (h) => h) {
+// hostFilter（2026-10-09 sync-hosts-root-coverage）：宿主级过滤（多根模式下「项目根宿主点」根只扫
+//   实际存在 dir 的宿主——不存在=没装该宿主点，不算缺失不算漂移）。
+function pairsFor(authRel, hostDirOf = (h) => h, hostFilter = null) {
   const out = [];
   const norm = authRel.split(path.sep).join('/');
+  // 条目带 h（宿主键）——faces 计数用「实际生成配对 > 0 的宿主数」（复核 P2-2：存在但空的宿主点
+  // 目录此前被计入「N 宿主」，对账面自描述轻微夸大）
   if (norm.startsWith('commands/') && norm.endsWith('.md')) {
     const name = norm.slice('commands/'.length, -'.md'.length);
     for (const [h, v] of Object.entries(HOSTS)) {
-      if (v.commandPrefix) out.push({ adapterRel: `${hostDirOf(h)}/commands/${v.commandPrefix}${name}.md` });
+      if (hostFilter && !hostFilter(h)) continue;
+      if (v.commandPrefix) out.push({ h, adapterRel: `${hostDirOf(h)}/commands/${v.commandPrefix}${name}.md` });
     }
   } else if (norm.startsWith('roles/') && norm.endsWith('.md')) {
     const name = norm.slice('roles/'.length, -'.md'.length);
-    for (const h of Object.keys(HOSTS)) out.push({ adapterRel: `${hostDirOf(h)}/agents/${name}.md` });
+    for (const h of Object.keys(HOSTS)) {
+      if (hostFilter && !hostFilter(h)) continue;
+      out.push({ h, adapterRel: `${hostDirOf(h)}/agents/${name}.md` });
+    }
   }
   return out;
 }
 
 // diffHosts：权威源正文段 vs 薄适配正文段的漂移分析（B-b 语义；pure function）。
 // authorityRoot：权威源根（含 commands/ + roles/）
-// adaptersRoot：薄适配根（含 <h>/{agents,commands}/）
+// 多根对账（2026-10-09 sync-hosts-root-coverage）：adapterRoots = [{root, hostDirOf, hostFilter?, label?}]——
+//   包源布局传两根（modules/hosts 宿主键形态 + 项目根 HOSTS.dir 形态宿主点）；装户布局单根。
+//   向后兼容：旧单根入参 adaptersRoot/hostDirOf 归一为单元素数组。
+//   根因教训（engine-quality-round2 B1）：包源布局此前只扫 modules/hosts，项目根宿主点（本仓 .zcode/）
+//   完全不在扫描面——bb69e19「81 对全对齐」声明漏掉 .zcode 三份（独立复核 P2-3 实证）。
 // hostDirOf：宿主 → 适配目录名（默认宿主键 = 包源布局；装户布局传 (h) => HOSTS[h].dir）
-// 返回：{ drift, inSync, authorityMissing, adapterOrphans, note }
-// drift = 正文段 sha 不一致（权威源改 / 薄适配手改 都计入；不区分方向）
-// inSync = 正文段 sha 对齐的文件对数
-// authorityMissing = 权威源声明但薄适配文件不存在（apply 不自动创建——薄适配须经 add-host 接管）
-// adapterOrphans = 薄适配存在但权威源无对应文件（apply 不删——可能是宿主特化或历史残留）
-export function diffHosts({ authorityRoot, adaptersRoot, hostDirOf = (h) => h }) {
-  if (!fs.existsSync(authorityRoot)) return { drift: [], inSync: 0, authorityMissing: [], adapterOrphans: [], note: `权威源根不存在：${authorityRoot}` };
+// 返回：{ drift, inSync, authorityMissing, adapterOrphans, faces }
+// drift 条目自带 root（applyForward 按它定位适配文件）；faces = 对账面自描述行（防不可解释的「N 对」）
+export function diffHosts(opts) {
+  const authorityRoot = opts.authorityRoot;
+  const roots = opts.adapterRoots || [{ root: opts.adaptersRoot, hostDirOf: opts.hostDirOf || ((h) => h), label: null }];
+  if (!fs.existsSync(authorityRoot)) return { drift: [], inSync: 0, authorityMissing: [], adapterOrphans: [], faces: [], note: `权威源根不存在：${authorityRoot}` };
 
   const drift = [];
+  const adapterOrphans = [];
   let inSync = 0;
   const adapterSeen = new Set();
   const authorityMissing = [];
+  const faces = [];
 
-  // 扫权威源 commands/ + roles/
-  for (const sub of ['commands', 'roles']) {
-    const subAbs = path.join(authorityRoot, sub);
-    for (const f of listMd(subAbs)) {
-      const authRel = `${sub}/${f}`;
-      const authAbs = path.join(authorityRoot, authRel);
-      const authSha = bodySha(authAbs);
-      const pairs = pairsFor(authRel, hostDirOf);
-      if (pairs.length === 0) continue;
-      for (const { adapterRel } of pairs) {
-        adapterSeen.add(adapterRel);
-        const adapterAbs = path.join(adaptersRoot, adapterRel);
-        const adapterSha = bodySha(adapterAbs);
-        if (adapterSha === null) {
-          // 未安装的宿主不算「缺失」——那是没装，不是漂移（2026-10-07：装户只装部分宿主时，
-          // 旧行为会把未装宿主的全部适配文件列成 authorityMissing，装户 --apply 恒 exit 1 且刷屏）
-          if (fs.existsSync(path.dirname(adapterAbs))) authorityMissing.push({ authRel, adapterRel });
-          continue;
+  for (const spec of roots) {
+    const { root, hostDirOf, hostFilter, label } = spec;
+    const rootHosts = new Set(); // 该根实际生成配对 > 0 的宿主（faces 计数口径，复核 P2-2）
+    // 扫权威源 commands/ + roles/
+    for (const sub of ['commands', 'roles']) {
+      const subAbs = path.join(authorityRoot, sub);
+      for (const f of listMd(subAbs)) {
+        const authRel = `${sub}/${f}`;
+        const authAbs = path.join(authorityRoot, authRel);
+        const authSha = bodySha(authAbs);
+        const pairs = pairsFor(authRel, hostDirOf, hostFilter);
+        if (pairs.length === 0) continue;
+        for (const { h, adapterRel } of pairs) {
+          rootHosts.add(h);
+          adapterSeen.add(adapterRel);
+          const adapterAbs = path.join(root, adapterRel);
+          const adapterSha = bodySha(adapterAbs);
+          if (adapterSha === null) {
+            // 未安装的宿主不算「缺失」——那是没装，不是漂移（2026-10-07：装户只装部分宿主时，
+            // 旧行为会把未装宿主的全部适配文件列成 authorityMissing，装户 --apply 恒 exit 1 且刷屏）
+            if (fs.existsSync(path.dirname(adapterAbs))) authorityMissing.push({ authRel, adapterRel });
+            continue;
+          }
+          if (authSha === adapterSha) { inSync++; continue; }
+          drift.push({ authRel, adapterRel, authSha, adapterSha, root });
         }
-        if (authSha === adapterSha) { inSync++; continue; }
-        drift.push({ authRel, adapterRel, authSha, adapterSha });
       }
     }
-  }
 
-  // 扫薄适配找孤儿（权威源无对应文件）
-  const adapterOrphans = [];
-  for (const h of Object.keys(HOSTS)) {
-    for (const sub of ['agents', 'commands']) {
-      const subAbs = path.join(adaptersRoot, hostDirOf(h), sub);
-      for (const f of listMd(subAbs)) {
-        const adapterRel = `${hostDirOf(h)}/${sub}/${f}`;
-        if (adapterSeen.has(adapterRel)) continue;
-        let authGuess;
-        const prefix = HOSTS[h] && HOSTS[h].commandPrefix;
-        if (sub === 'commands' && prefix && f.startsWith(prefix)) {
-          // 命令层薄适配带宿主 commandPrefix（2026-09-28：opencode 对齐 trae 后两宿主同口径）
-          authGuess = `commands/${f.slice(prefix.length)}`;
-        } else if (sub === 'agents') {
-          authGuess = `roles/${f}`;
-        } else {
-          authGuess = `commands/${f}`;
+    faces.push(label ? `${label}（${rootHosts.size} 宿主）` : `${root}（${rootHosts.size} 宿主）`);
+    // 扫薄适配找孤儿（权威源无对应文件）
+    for (const h of Object.keys(HOSTS)) {
+      if (hostFilter && !hostFilter(h)) continue;
+      for (const sub of ['agents', 'commands']) {
+        const subAbs = path.join(root, hostDirOf(h), sub);
+        for (const f of listMd(subAbs)) {
+          const adapterRel = `${hostDirOf(h)}/${sub}/${f}`;
+          if (adapterSeen.has(adapterRel)) continue;
+          let authGuess;
+          const prefix = HOSTS[h] && HOSTS[h].commandPrefix;
+          if (sub === 'commands' && prefix && f.startsWith(prefix)) {
+            // 命令层薄适配带宿主 commandPrefix（2026-09-28：opencode 对齐 trae 后两宿主同口径）
+            authGuess = `commands/${f.slice(prefix.length)}`;
+          } else if (sub === 'agents') {
+            authGuess = `roles/${f}`;
+          } else {
+            authGuess = `commands/${f}`;
+          }
+          adapterOrphans.push({ adapterRel, authGuess });
         }
-        adapterOrphans.push({ adapterRel, authGuess });
       }
     }
   }
 
-  return { drift, inSync, authorityMissing, adapterOrphans };
+  return { drift, inSync, authorityMissing, adapterOrphans, faces };
 }
 
 // printDiff：人类可读 diff 报告（B-b 语义：正文段比对 + frontmatter 双方不动）
 function printDiff(result) {
-  const { drift, inSync, authorityMissing, adapterOrphans, note } = result;
+  const { drift, inSync, authorityMissing, adapterOrphans, note, faces } = result;
   if (note) console.log(`ℹ️  ${note}\n`);
+  if (faces && faces.length) console.log(`  对账面：${faces.join(' + ')}`);
   console.log(`  正文对齐：${inSync} 对`);
   if (authorityMissing.length) {
     console.log(`  权威源声明但薄适配缺失（${authorityMissing.length}，apply 不自动创建——薄适配须经 add-host 接管）：`);
@@ -152,12 +172,13 @@ function printDiff(result) {
 }
 
 // applyForward：把权威源正文段同步到薄适配（保留薄适配原 frontmatter）
+// 漂移条目自带 root（多根对账，2026-10-09 sync-hosts-root-coverage）——按它定位适配文件。
 // 返回：{ synced: [{adapterRel}] }
-function applyForward({ authorityRoot, adaptersRoot }, drift) {
+function applyForward({ authorityRoot }, drift) {
   const synced = [];
-  for (const { authRel, adapterRel } of drift) {
+  for (const { authRel, adapterRel, root } of drift) {
     const authAbs = path.join(authorityRoot, authRel);
-    const adapterAbs = path.join(adaptersRoot, adapterRel);
+    const adapterAbs = path.join(root, adapterRel);
     const authText = fs.readFileSync(authAbs, 'utf8');
     const adapterText = fs.readFileSync(adapterAbs, 'utf8');
     const { body } = splitFm(authText);
@@ -189,26 +210,43 @@ export function syncHosts(args, pkgRoot) {
   // 解析为**包安装目录**，于是 doctor §7.x 报漂移、照提示跑 `--apply` 会去改包源仓（装户自己的适配层纹丝不动）。
   const target = path.resolve(dir || process.cwd() || pkgRoot);
   // 布局判定（与 doctor.checkAdapterDrift 同口径）：
-  //   包源（templates/_agents 与 modules/hosts 同时存在）→ 权威源 = <target>/templates/_agents，薄适配根 = <target>/modules/hosts
+  //   包源（templates/_agents 与 modules/hosts 同时存在）→ 权威源 = <target>/templates/_agents
+  //     薄适配根（2026-10-09 sync-hosts-root-coverage 多根）= ① modules/hosts（宿主键形态，全宿主）
+  //     + ② 项目根 HOSTS.dir 实际存在的宿主点（如本仓 .zcode/——此前不在扫描面，bb69e19「81 对全对齐」
+  //     漏掉其三份，独立复核 P2-3 实证）；不存在 = 没装该宿主点，不算缺失。
   //   装户（其余）→ 权威源 = <target>/.agents，薄适配根 = <target>（宿主目录 .opencode/.trae/… 直接位于项目根）
   const isSourceRepo = fs.existsSync(path.join(target, 'templates', '_agents'))
     && fs.existsSync(path.join(target, 'modules', 'hosts'));
   const authorityRoot = isSourceRepo ? path.join(target, 'templates', '_agents') : path.join(target, '.agents');
-  const adaptersRoot = isSourceRepo ? path.join(target, 'modules', 'hosts') : target;
+  const adapterRoots = isSourceRepo
+    ? [
+        { root: path.join(target, 'modules', 'hosts'), hostDirOf: (h) => h, label: 'modules/hosts' },
+        {
+          root: target,
+          hostDirOf: (h) => (HOSTS[h] && HOSTS[h].dir) || h,
+          hostFilter: (h) => HOSTS[h] && fs.existsSync(path.join(target, HOSTS[h].dir)),
+          label: '项目根宿主点',
+        },
+      ]
+    : [{
+        root: target,
+        hostDirOf: (h) => (HOSTS[h] && HOSTS[h].dir) || h,
+        hostFilter: (h) => HOSTS[h] && fs.existsSync(path.join(target, HOSTS[h].dir)),
+        label: '项目根宿主点',
+      }];
   if (!fs.existsSync(authorityRoot)) {
     fail(`未找到权威源目录：${authorityRoot}——目标根 ${target} 既非包源（无 templates/_agents）也非装户（无 .agents）；用 --dir <项目根> 指定`);
   }
   const layout = isSourceRepo ? '包源' : '装户';
-  // 适配目录名：包源 = 宿主键（modules/hosts/opencode/…）；装户 = HOSTS[h].dir（项目根下 .opencode/…）
-  const hostDirOf = isSourceRepo ? (h) => h : (h) => (HOSTS[h] && HOSTS[h].dir) || h;
-  const result = diffHosts({ authorityRoot, adaptersRoot, hostDirOf });
+  const result = diffHosts({ authorityRoot, adapterRoots });
 
   if (apply && result.drift.length > 0) {
-    const { synced } = applyForward({ authorityRoot, adaptersRoot }, result.drift);
+    const { synced } = applyForward({ authorityRoot }, result.drift);
     console.log(`▶ flow-kit sync-hosts --apply → ${target}（${layout}布局）`);
+    console.log(`  对账面：${result.faces.join(' + ')}`);
     console.log(`  按权威源正文覆盖薄适配正文段 ${synced.length} 份（薄适配 frontmatter 不动）：`);
     for (const rel of synced) console.log(`    - ${rel}`);
-    const after = diffHosts({ authorityRoot, adaptersRoot, hostDirOf });
+    const after = diffHosts({ authorityRoot, adapterRoots });
     console.log(`  同步后正文对齐：${after.inSync} 对；权威源缺失：${after.authorityMissing.length}；正文漂移：${after.drift.length}`);
     return after.drift.length === 0 && after.authorityMissing.length === 0 ? 0 : 1;
   }

package/src/sync-hosts.test.mjs

@@ -237,5 +237,44 @@ syncHosts(process.argv.slice(2), root);
   check('实仓薄适配无缺失无正文漂移', r.authorityMissing.length === 0 && r.drift.length === 0, `missing=${r.authorityMissing.length} drift=${r.drift.length} ${sample}`);
 }
 
+// ============ 场景 10-12：包源布局多根对账（2026-10-09 sync-hosts-root-coverage，B1）============
+// 根因教训（bb69e19「81 对全对齐」漏 .zcode 三份，独立复核 P2-3）：包源布局此前只扫 modules/hosts，
+// 项目根 HOSTS.dir 形态宿主点（本仓 .zcode/）不在扫描面。三场景钉住：漂移可检出 / apply 可修复且
+// frontmatter 保留 / 对账面自描述行在案。
+{
+  // S10：包源 fixture + 项目根 .zcode/agents 漂移（正文旧 + frontmatter zcode 风格）→ --diff 报漂移
+  const fx = mkFixture();
+  W(path.join(fx, '.zcode/agents/implementer.md'),
+    `---\nname: implementer\ndescription: zcode 本仓风格\n---\n\n# Implementer · v0\n\n旧版正文 implementer v0\n`);
+  const r = runSyncHosts(fx, ['--diff']);
+  const out = r.stdout + r.stderr;
+  check('S10 项目根宿主点漂移：--diff 报 .zcode/agents/implementer.md',
+    out.includes('.zcode/agents/implementer.md') && /正文段漂移/.test(out), out.slice(0, 600));
+  check('S10 对账面自描述：含「项目根宿主点（1 宿主）」', /对账面：.*项目根宿主点（1 宿主）/.test(out), out.split('\n').slice(0, 4).join('\n'));
+
+  // S11：--apply 修复项目根漂移——正文覆盖为权威源、frontmatter 保留、漂移归零
+  const r2 = runSyncHosts(fx, ['--apply']);
+  const out2 = r2.stdout + r2.stderr;
+  const synced = /- \.zcode\/agents\/implementer\.md/.test(out2);
+  const fixed = R(path.join(fx, '.zcode/agents/implementer.md'));
+  check('S11 --apply 同步清单含 .zcode 条目', synced, out2.slice(0, 500));
+  check('S11 --apply 正文覆盖 + frontmatter 保留',
+    fixed.includes('权威源正文 implementer v1') && fixed.includes('description: zcode 本仓风格'),
+    fixed.slice(0, 200));
+  check('S11 --apply 后漂移归零', /正文漂移：\s*0/.test(out2), out2.slice(-300));
+}
+
+{
+  // S12：装户布局 faces 自描述（回归钉住——装户单根 label=项目根宿主点，行为不变）
+  const fx = fs.mkdtempSync(path.join(os.tmpdir(), 'fk-synchosts-adopter-'));
+  W(path.join(fx, '.agents/roles/implementer.md'),
+    `---\ndescription: Implementer 角色契约\n---\n\n# Implementer · v1\n\n权威源正文 implementer v1\n`);
+  W(path.join(fx, '.zcode/agents/implementer.md'),
+    `---\nname: implementer\ndescription: zcode\n---\n\n# Implementer · v1\n\n权威源正文 implementer v1\n`);
+  const r = runSyncHostsByCwd(fx, ['--diff']);
+  const out = r.stdout + r.stderr;
+  check('S12 装户布局：faces 单根自描述 + 对齐 1 对', /对账面：项目根宿主点（1 宿主）/.test(out) && /正文对齐：\s*1\s*对/.test(out), out.slice(0, 400));
+}
+
 console.log(`\n合计: PASS ${pass} / FAIL ${failCount}`);
 process.exit(failCount ? 1 : 0);

package/templates/AGENTS.md

@@ -28,7 +28,8 @@
 - **`git commit` / `git merge` / `git push` 三处一律禁 `--no-verify`**——被拦说明产出不合规，按提示修完原路重试。
 - 项目专属门禁挂 `.agents/hooks/local-pre-commit`。装户五条硬规则（配对、验收、确认留痕、敏感信息、双源台账）与 `audit` 档见 `workflow/README.md`「硬规则」。
 - 提交遵循 Conventional Commits 中文（feat / fix / docs / style / refactor / perf）。L1+ 三段式闭环链：`docs(*)` approved 留痕 → 代码 → 关单 `docs(*)`，相邻提交即同一闭环（2026-10-04 修订）。
-- **确认门（2026-09-27 起）**：intent/spec/plan 的 approved/done 与 incident 的 fixed/closed（两跳、无单跳）唯一入口 = `node .agents/scripts/confirm-doc.mjs <path>`，放弃态走显式 `--to superseded|cancelled`（合法前态见脚本提示；四终态同样内容绑定），两形态：① 用户终端亲手运行键入「可以」（TTY，AI 会话内被拒）；② **对话委托代录**——用户在对话内明确确认后，AI 跑 `confirm-doc.mjs <path> --delegated "<用户原话>"` 逐件代录（默认一次一份，多份并录被拒），台账如实记 `source: chat-delegated` + 原话供对质，永不伪装 TTY 行（check-loop 15 指纹+台账对账拦截，与 source 无关）；L0/L1 协作道可 `--batch` 多份一次代录（台账 `brief:true`，15 并录告警豁免；L2/L3 仍逐份）。
+- **确认门（2026-09-27 起）**：intent/spec/plan 的 approved/done 与 incident 的 fixed/closed（两跳、无单跳）唯一入口 = `node .agents/scripts/confirm-doc.mjs <path>`，放弃态走显式 `--to superseded|cancelled`（合法前态见脚本提示；四终态同样内容绑定），两形态：① 用户终端亲手运行键入「可以」（TTY，AI 会话内被拒）；② **对话委托代录**——用户在对话内明确确认后，AI 跑 `confirm-doc.mjs <path> --delegated "<授权摘要>"` 逐件代录（默认一次一份，多份并录被拒），台账如实记 `source: chat-delegated`，永不伪装 TTY 行（check-loop 15 指纹+台账对账拦截，与 source 无关）；L0/L1 协作道可 `--batch` 多份一次代录（台账 `brief:true`，15 并录告警豁免；L2/L3 仍逐份）。
+- **改动面 scope = 授权的机器事实（2026-10-09 起）**：confirm-doc 落账自动记 `scope{files,sha256}`（被确认文档 + `git status` 实测未提交改动集，机器派生、**AI 无输入面**）。分辨力由 scope + 指纹承担，`--delegated` 的摘要降级为人类可读留痕——**「每次换一句原话」纪律退役**，复用同一句摘要不再削弱任何判据。check-loop 15 校验受管行带 scope 且摘要自洽（`policyVersion ≥ 7` 起，旧版本与存量行零新增告警）。
 
 ### 检索、看板与量化
 

package/templates/_agents/commands/build.md

@@ -23,6 +23,12 @@ next: .agents/commands/test.md
 
 > AI 起草 plan,用户确认;进计划模式列改动,用户确认;最后才动代码。两道确认门。
 
+## 0. 三件套合并预览（L2/L3 起草期，2026-10-09 engine-quality-round2 C）
+
+起草 intent / spec / plan 任一件后，**在输出草稿全文前先给三件要点总览**（各一件：目标 / 关键取舍 /
+验收判据 diff，合计 ≤12 行）——用户一次看整体再逐件拍板，省三次盲确认的上下文切换。
+确认纪律不变：逐件过目全文 + 逐件 `confirm-doc` 代录（禁并录、禁复用同句）。本阶段总览侧重：plan 任务拆解与两道确认门位置。
+
 ## 1. 执行
 
 ### 1.1 起草 plan
@@ -68,6 +74,7 @@ next: .agents/commands/test.md
 ## 4. 改权威源后必跑（薄适配同步防漏）
 
 - 改 `templates/_agents/{commands,roles}/*.md` 正文后跑 `node bin/flow-kit.mjs sync-hosts --diff` → 拍板 → `--apply` 单向同步（只动正文段，frontmatter 不动）；口径与边界详见 `.agents/commands/sync-hosts.md`
+- 改根 `AGENTS.md`（owned 常驻面）后跑 `node .agents/scripts/edit-face-check.mjs`——工作树面快检（阶段索引/引用/预算 advisory），别等提交门才发觉砍坏（2026-10-09 B2）
 
 ## 5. 改 doctor / check-loop 后必跑（三处口径对账）