agentic-flow-kit 1.4.0 → 1.6.0

package/templates/_agents/commands/sync-hosts.md

@@ -25,16 +25,16 @@ next: .agents/commands/build.md（漂移属 build 改权威源未同步导致的
 > 比 `templates/_agents` ↔ `modules/hosts/<宿主键>/`；含 `.agents` → 装户：比 `.agents` ↔ 项目根下 `<宿主点目录>/`），
 > 目标根取 `--dir <目录>` > 当前目录。
 
-## 何时跑
+## 1. 何时跑
 
 - 改 `templates/_agents/commands/*.md` 正文后（11 个 commands 文件）
 - 改 `templates/_agents/roles/*.md` 正文后（3 个 roles 文件）
 - 装户跑 `flow-kit doctor` 报"跨宿主薄适配正文漂移 N 对" WARN 时
 - 不跑：仅改 frontmatter；改 trae 钩子/规则；改包源其他文件
 
-## 怎么跑
+## 2. 怎么跑
 
-### 默认 `--diff`（仅报告）
+### 2.1 默认 `--diff`（仅报告）
 
 ```
 node bin/flow-kit.mjs sync-hosts --diff      # 包源仓（在包源根跑）
@@ -48,7 +48,7 @@ flow-kit sync-hosts --diff                   # 装户仓（在装户根跑；或
 - **⚠️ 权威源声明但薄适配缺失** — `add-host <h>` 接管后跑 `--apply` 才会装（apply 不自动创建）
 - **⚠️ 孤儿薄适配（权威源无对应文件）** — 历史残留或宿主特化，apply 不删
 
-### `--apply` 单向同步
+### 2.2 `--apply` 单向同步
 
 ```
 node bin/flow-kit.mjs sync-hosts --apply
@@ -56,7 +56,7 @@ node bin/flow-kit.mjs sync-hosts --apply
 
 按权威源正文覆盖薄适配正文段；薄适配原 frontmatter 保留（trae name: wf-X、opencode 描述、zcode/omp 中文风格各自不动）。apply 不反向同步——薄适配手改了正文也会被覆盖（这是设计选择，避免漂移方向歧义）。
 
-### 自验
+### 2.3 自验
 
 ```
 npm test                                       # 含 sync-hosts.test.mjs 8 场景
@@ -64,7 +64,7 @@ node bin/flow-kit.mjs doctor                   # 装户跑 §7.x PASS；包源
 sh .agents/scripts/check-loop.sh                # Windows 无 sh 时 doctor 已探测分流
 ```
 
-## 边界（不要做）
+## 3. 边界（不要做）
 
 - 不要 `--apply` 反向同步（写权威源）：权威源是真相，薄适配手改会被覆盖——这是设计，apply 前先看 `--diff`
 - 不要删除孤儿薄适配：可能是宿主特化或历史残留，apply 不动
@@ -72,14 +72,14 @@ sh .agents/scripts/check-loop.sh                # Windows 无 sh 时 doctor 已
 - 不要把「避免与权威版本漂移」明文加回去——这是旧契约的指针风格，已被 B-b 正文副本取代
 - 装了新宿主后跑 `--apply`：新宿主目录空白，apply 不会自动创建薄适配（薄适配须经 `add-host <h>` 接管）
 
-## 不在本次同步范围
+## 4. 不在本次同步范围
 
 - trae 钩子（`modules/hosts/trae/hooks/*.cjs`）— 独立演进的工程件
 - trae 规则（`modules/hosts/trae/rules/*.md`）— 同上
 - 包源 .agents/scripts/*.cjs（pre-commit 等钩子）— 同步由 `flow-kit sync` 走 managed 台账负责
 
-## 相关留痕
+## 5. 相关留痕
 
 - intent：`workflow/intents/2026-09-25-cross-host-sync.md`
 - plan：`workflow/plans/2026-09-25-cross-host-sync.md`（含 B-b 方案拍板）
-- incident：`workflow/incidents/2026-09-25-wf-runtime.md`（双源纪律教训，规范 §7.x 包源环境跳过）
+- incident：`workflow/incidents/2026-09-25-wf-runtime.md`（双源纪律教训，规范 §7.x 包源环境跳过）

package/templates/_agents/commands/test.md

@@ -65,20 +65,19 @@ node bin/flow-kit.mjs doctor                       # §6.5 delegations + §6.6 o
 - 复核者读入口文档(intent / incident) + spec + plan + diff,判断变更意图与风险
 - 复核意见交用户定性(采纳 / 驳回);采纳项回 `build.md` 修改
 
-## 子代理调用约定
+## 5. 子代理调用约定
 
 - 静态门不委派;UI 实测委派 `ui-verifier`(静态门通过后)、独立复核委派 `independent-reviewer`,均要求读取对应 `.agents/roles/*.md`;宿主不支持时按 frontmatter `fallback`(reviewer 必须另开新会话,不得主智能体自查冒充)。
 - 子智能体只返回证据与结论——失败项修复仍回 `build.md`,不得在 Test 阶段顺手改代码;修复后重跑本阶段,全过后用户确认再关单。
 
-## 确认后
+## 6. 确认后（关单）
 
-- 输出测试报告(通过项 / 失败项)
-- 失败项已修复并复测通过
+- 输出测试报告(通过项 / 失败项);失败项已修复并复测通过。
 - **关单**（日常闭环点，不依赖是否上 prod）:
   - 关单前一键过门：`node .agents/scripts/verify.mjs --doc workflow/intents/<本单>.md`（npm test + check-loop 固定编排，任一失败非零退出，非绿不关单）；**`--doc` 把测试绿凭证绑到本单**——不带它落下的绿行不给任何单背书，confirm-doc 前置与检查 8 对账只认带本单 `--doc` 的绿行（仅 v6+ 生效）；**装户仓**（根目录无 `package.json`，工程在子目录）默认 `npm test` 不可跑 → 脚本**显式跳过步骤 1 且不落测试绿凭证**（防假绿）并提示；此时按项目口径手工跑测试，或带 `--test-cmd "<项目测试命令>"` 指定（2026-10-07 papercut）
-  - 新需求：逐条勾验入口 intent「验收标准」，每条补「证据：」（例如：粘贴 CI 运行结果、UI 截图路径、或具体的 commit SHA），intent $\rightarrow$ done；同名 spec/Quick-Plan（若有）仍 approved $\rightarrow$ done。**注意：勾选但缺证据会被 check-loop 拦截（hard-block）**
+  - 新需求：逐条勾验入口 intent「验收标准」，每条补「证据：」（例如：粘贴 CI 运行结果、UI 截图路径、或具体的 commit SHA），intent → done；同名 spec/Quick-Plan（若有）仍 approved → done。**注意：勾选但缺证据会被 check-loop 拦截（hard-block）**
   - **approved 留痕提交**（2026-09-30 起）：done 确认前确认**本次关单文档**的 approved 态已进 git 历史（越早越好——approved 后即应提交；若尚未，先补提交再 done；门为逐份校验，三件套均关单时逐份各自满足）——confirm-doc 的 done 前置门硬校验（历史未出现「状态: approved」→ 拒绝落账）；done 后再提交 done 态与其余改动
-**确认落态唯一入口**（2026-09-27 起）：用户在终端跑 `node .agents/scripts/confirm-doc.mjs <path>` 键入「可以」（draft→approved / approved→done；对话内明确确认后 AI 可 `--delegated "<原话>"` 代录，台账如实记 source/quote——**逐件调用 + 逐件原话**（一次一份，build.md「逐件确认」口径；多份并录被 confirm-doc 拒绝。--delegated 每次传当次实际放行的措辞，不复用同句——复用同句使台账 quote 失去分辨力））。check-loop 15 如实口径：缺记录/指纹不配对 → hard-block 拦截；伪造台账本地不可机器防，留痕供事后对质；done 内容绑定（2026-09-28 起）——**关单编辑（勾验/回填确认结果）先于 done 确认、confirm-doc 是最后一次写入**，此后修订走 superseded 或新 intent。
+  - **确认落态**：唯一入口 `node .agents/scripts/confirm-doc.mjs <path>`（两形态 / 逐件+逐件原话 / done 内容绑定（关单编辑先于 done 确认、confirm-doc 是最后一次写入）/ 台账对质全口径见根 `AGENTS.md` §1.3 确认门）。
   - 修复：防复发验证已落地，incident → closed（经确认门 confirm-doc：open→fixed / fixed→closed 两跳、无单跳；2026-09-28 起 check-loop 15 对账——关单编辑先于 closed 确认，口径同 done 内容绑定）
   - **同族收尾**：入口置终态时，同名 plan 一并置 `done`（spec 见上条），不留 `approved` 孤儿（口径同看板「入口已 done，本 plan 未终态」告警）
   - 主智能体自做的 L1+ 新需求在 `workflow/delegations.md`「自做任务结果表」记一行（修复类不重复记）

package/templates/_agents/roles/implementer.md

@@ -2,7 +2,7 @@
 
 > 公共角色契约（本文件）：`.agents/roles/implementer.md`。宿主薄适配（各宿主目录下 `agents/implementer.md`）正文段同源本文件，frontmatter 各自保留宿主特化字段（check-loop 检查项 6 按本引用校验适配层不断线）。
 
-## 职责
+## 1. 职责
 
 执行已经由主智能体和用户确认、范围明确的实现任务。适用范围仅限：
 
@@ -11,7 +11,7 @@
 - 编写或调整任务直接要求的测试
 - 修复与任务直接相关的编译错误
 
-## 必需输入
+## 2. 必需输入
 
 开始前必须获得：
 
@@ -22,7 +22,7 @@
 
 任一输入缺失或相互冲突时，停止并向主智能体报告，不自行扩大范围。
 
-## 行为边界
+## 3. 行为边界
 
 - 只修改明确授权的文件；若必须触及其他文件，先停止并说明原因。
 - 仓库可能有其他智能体或用户同时工作；保留现有改动，不回退、不覆盖无关修改。
@@ -31,13 +31,13 @@
 - 不执行提交、推送、发布、数据迁移或破坏性操作。
 - 不顺手重构、格式化或清理与任务无关的代码。
 
-## 验证
+## 4. 验证
 
 - 运行任务指定的最小相关检查。
 - 检查失败时只修复由本次改动引起且仍在授权范围内的问题。
 - 同一验证连续失败三次，或继续需要猜测需求时，停止并报告阻塞。
 
-## 输出
+## 5. 输出
 
 返回给主智能体：
 
@@ -45,4 +45,3 @@
 2. 每个文件的改动摘要
 3. 已运行的验证及结果
 4. 未解决的阻塞或剩余风险
-

package/templates/_agents/roles/independent-reviewer.md

@@ -2,11 +2,11 @@
 
 > 公共角色契约（本文件）：`.agents/roles/independent-reviewer.md`。宿主薄适配（各宿主目录下 `agents/independent-reviewer.md`）正文段同源本文件，frontmatter 各自保留宿主特化字段（check-loop 检查项 6 按本引用校验适配层不断线）。
 
-## 职责
+## 1. 职责
 
 在独立上下文中对 spec、plan 或代码 diff 做只读复核，发现原作者可能遗漏的正确性、契约、架构、数据安全和回归风险。
 
-## 必需输入
+## 2. 必需输入
 
 开始前必须获得：
 
@@ -17,7 +17,7 @@
 
 输入不足以确定范围时，停止并向主智能体报告。
 
-## 行为边界
+## 3. 行为边界
 
 - 只读，不修改任何仓库文件。
 - 不替用户决定问题定性、方案取舍、合入或上线。
@@ -26,7 +26,7 @@
 - 不把样式偏好、假设性风险或既有无关问题包装成缺陷。
 - 无法验证的事项明确标为未验证，不声称已经通过。
 
-## 复核重点
+## 4. 复核重点
 
 1. 实现是否满足入口文档和验收标准
 2. 是否违反根 `AGENTS.md` 与改动域目录级 `AGENTS.md` 的架构、数据和所在域红线
@@ -34,7 +34,7 @@
 4. 是否缺少能防止回归的验证
 5. 是否存在数据丢失、安全、权限或发布风险
 
-## 输出
+## 5. 输出
 
 按严重度输出问题清单：
 
@@ -42,4 +42,4 @@
 - `P1`：功能错误、明确回归或违反项目硬约束
 - `P2`：非阻断但有证据的维护性问题
 
-每项必须包含：位置、问题、证据、建议。没有发现时明确输出“未发现阻断问题”，并列出未验证范围。
+每项必须包含：位置、问题、证据、建议。没有发现时明确输出"未发现阻断问题"，并列出未验证范围。

package/templates/_agents/roles/ui-verifier.md

@@ -2,11 +2,11 @@
 
 > 公共角色契约（本文件）：`.agents/roles/ui-verifier.md`。宿主薄适配（各宿主目录下 `agents/ui-verifier.md`）正文段同源本文件，frontmatter 各自保留宿主特化字段（check-loop 检查项 6 按本引用校验适配层不断线）。
 
-## 职责
+## 1. 职责
 
 对已经实现的 UI 改动执行浏览器实测并收集可复核证据。只验证，不修复。
 
-## 必需输入
+## 2. 必需输入
 
 开始前必须获得：
 
@@ -17,7 +17,7 @@
 
 缺少可观察的预期结果时，停止并向主智能体报告。
 
-## 执行
+## 3. 执行
 
 1. 读取项目根目录 `AGENTS.md`，以及改动域目录级 `AGENTS.md`（如有，前端改动域）。
 2. 读取并遵循项目 UI 实测技能 `.agents/skills/verify-ui/SKILL.md`（如有）。
@@ -26,14 +26,14 @@
 5. 收集控制台、网络请求、DOM 数据或截图等证据。
 6. 结束时关闭本次启动的后台进程。
 
-## 行为边界
+## 4. 行为边界
 
 - 不修改代码、配置、测试数据或工作流文档。
 - 不自行修复发现的问题；将失败证据交还主智能体。
 - 不使用生产环境或真实业务数据。
 - 无法启动环境或完成关键路径时，报告阻塞，不把部分验证标记为通过。
 
-## 输出
+## 5. 输出
 
 返回：
 

package/templates/_agents/scripts/agg-delegations.cjs

@@ -14,7 +14,6 @@ const fs = require('fs');
 const path = require('path');
 
 const ROOT = path.resolve(__dirname, '..', '..');
-const LEDGER = path.join(ROOT, 'workflow', 'delegations.md');
 const INCIDENTS = path.join(ROOT, 'workflow', 'incidents');
 
 const argMonth = (process.argv.find((a) => a.startsWith('--month=')) || '').split('=')[1] || null;

package/templates/_agents/scripts/agg-delegations.test.mjs

@@ -96,8 +96,8 @@ const { metrics, gateMonth, expansionVerdict, parseResult } = requireCjs(path.jo
 // 场景 4：审查反例——30 任务、2 主兜底、平均返工 0.25（旧口径四门全过，声明口径下必须 ❌）
 {
   const rows = [
-    ...Array.from({ length: 22 }, (_, i) => ({ scope: '委派', result: '一次通过' })),
-    ...Array.from({ length: 6 }, (_, i) => ({ scope: '委派', result: '返工×1' })),
+    ...Array.from({ length: 22 }, () => ({ scope: '委派', result: '一次通过' })),
+    ...Array.from({ length: 6 }, () => ({ scope: '委派', result: '返工×1' })),
     { scope: '委派', result: '主兜底' }, { scope: '委派', result: '主兜底' },
   ];
   const m = metrics(rows);

package/templates/_agents/scripts/check-hygiene.mjs

@@ -85,7 +85,7 @@ export function runCheckHygiene(ctx) {
     }
   }
 
-  // --- 9. 文件名英文 kebab-case [warning] ---
+  // --- 9. 文件名英文 kebab-case [warning]（2026-09-11 规则）---
   markGate('9', '文件名 kebab-case');
   for (const sub of DOC_DIRS) {
     const dir = path.join(ROOT, WF, sub);
@@ -99,7 +99,7 @@ export function runCheckHygiene(ctx) {
     }
   }
 
-  // --- 11. 生成物漂移 [warning]（调生成器 --check，口径单一不复刻渲染）---
+  // --- 11. 生成物漂移 [warning]（调生成器 --check，口径单一不复刻渲染；INDEX 2026-09-21 检索层 / DASHBOARD 2026-10-08 扩覆盖面）---
   markGate('11', '生成物漂移（INDEX+DASHBOARD）');
   // ⚠️ 位置：本段须排在 12/13 之前——check-loop 输出按 warnings 插入序，行序是稳定输出契约
   // （pre-push / pre-commit 消费者 + doctor 按 WARN 行计数）；原序为 2 → 9 → 11 → 12 → 13，勿调换。

package/templates/_agents/scripts/check-ledger-invariant.mjs

@@ -41,7 +41,6 @@ const gitText = (args) => execFileSync('git', args, { cwd: ROOT, encoding: 'utf8
 const blobOf = (ref) => git(['show', ref]); // ref 必须为完整对象引用（<sha>:<path> / HEAD:<path> / :<path>）
 
 const problems = [];
-const fail = (msg) => { console.error(msg); process.exit(1); };
 
 // ---- --staged：暂存 blob ⊇ HEAD blob ----
 if (staged) {

package/templates/_agents/scripts/check-loop.mjs

@@ -17,7 +17,6 @@
 //      L0/L1 勾触达红线 → 「红线判低」hard——协作道不受理 STOP 级改动,就高不就低,
 //      2026-09-30 hybrid-governance-risk-lanes)                                        [hard-block]
 //   2. 模板字段占位符残留(YYYY-MM-DD / <主题> 等未替换;<主题> 与 .md 同行 = 命名约定描述,豁免)  [warning]
-//      （2026-10-08 selfmeasure-and-modularize：实现已迁 check-hygiene.mjs，判据与文案未变）
 //   3. incidents 复盘三件套完整性 + 状态严格枚举 + 新 intent 回路(回路断档=hard,其他=warning)
 //   4. 引用有效性(文档/指令中引用的 .agents/ 路径必须存在;支持 fill-{a,b,c}.mjs 花括号展开与 fill-*.mjs 通配;
 //      workflow 文档仅扫活跃态——终态件的引用是历史叙述,不扫,2026-09-27 audit-gate-hardening)  [warning]
@@ -30,15 +29,11 @@
 //      非 git / 查不到加入记录 → 不可判定 → 走存量口径(不误报 hard)
 //      证据可写在 [x] 行的续行（仓库通写法「（证据：…）」另起一行；全/半角冒号皆认）
 //   9. 文件名英文 kebab-case(非 ASCII 文件名=warning,2026-09-11 规则)
-//      （2026-10-08 selfmeasure-and-modularize：实现已迁 check-hygiene.mjs，判据与文案未变）
 //  10. 级别 vs 迁移文件一致性(L1/L2 入口文档加入提交触及迁移 SQL/Migrations=疑似判低,warning)
 //  11. 生成物漂移：workflow/INDEX.md(2026-09-21 检索层) + workflow/DASHBOARD.md(2026-10-08 扩覆盖面)=warning;
-//      各自调对应生成器 --check,口径单一不复刻渲染;实现已迁 check-hygiene.mjs
 //  12. frontmatter「模块:」合法性(枚举非法 / 2026-09-22 起新建缺字段=warning;词表单源 .agents/workflow-modules.txt)
-//      （2026-10-08 selfmeasure-and-modularize：实现已迁 check-hygiene.mjs，判据与文案未变）
 //  13. 常驻面体积预算(超限=warning;判定单源 rule-budget.sh——经 sh 调用,
 //      无 sh 环境静默跳过:advisory 级且 pre-commit 侧在 git 钩子 sh 环境照常硬拦)
-//      （2026-10-08 selfmeasure-and-modularize：实现已迁 check-hygiene.mjs，判据与文案未变）
 //  14. 新 done 的 spec/plan 须在 git 历史里出现过 `状态: approved`(确认环节留痕,2026-09-22;恒 advisory 永不升级 hard)
 //  15. 确认指纹对账(2026-09-27 起:approved/done 须 confirm-doc.mjs 确认指纹+台账配对,缺=hard-block;
 //      两形态——TTY 亲手 / --delegated 对话委托代录,台账 source 如实区分,配对判据与 source 无关)
@@ -114,11 +109,9 @@ import os from 'node:os';
 import path from 'node:path';
 import { spawnSync } from 'node:child_process';
 import { createHash } from 'node:crypto';
-import { createRequire } from 'node:module';
-import { fileURLToPath } from 'node:url';
 import { loadEnums } from './workflow-enums.mjs';
 import { runCheck16 } from './check-metric-claims.mjs';
-import { auditEnabled, loadKitPolicy, hasFreshVerifyLine } from './policy.mjs';
+import { auditEnabled, loadKitPolicy, hasFreshVerifyLine, ledgerChainHash } from './policy.mjs';
 import { laneOfEntry } from './stage-gates.mjs';
 // MARK_RE：incident 留痕形态的单源（第七轮复核 N3——此前 check-loop 内联复制一份同口径字面量，
 // 两处靠注释与人工同步；改为复用 stage-gates.mjs 的导出，从结构上消除漂移可能）
@@ -127,9 +120,10 @@ import { MARK_RE, approvedTraceHit } from './stage-gates.mjs';
 // 本文件只组装 ctx 并消费返回的文案数组（先例 = check-metric-claims.mjs 承载检查 16）。
 // 调用点位置即输出顺序位：须留在检查 10 与 12 之间以保持 warnings 行序（稳定输出契约），见该模块内注释。
 import { runCheckHygiene } from './check-hygiene.mjs';
+// 检查 7 拆模块（2026-10-09 engine-quality-round2 A1）：阶段索引同步迁 check-stage-index.mjs
+import { runCheckStageIndex } from './check-stage-index.mjs';
 import { gateSeg, finishSegs, makeCollector } from './gate-seg.mjs';
 
-const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
 // CHECK_LOOP_GIT：测试注入钩子（指向不存在/不可执行路径可稳定触发 spawn 异常）；未设置时与原行为逐字节一致（2026-10-05-gitout-fail-open）
 const GIT = process.env.CHECK_LOOP_GIT || (process.platform === 'win32' ? 'git.exe' : 'git');
 
@@ -600,19 +594,10 @@ export function runCheckLoop(opts = {}) {
     if (modelHits.length) warnings.push(`- [WARN 宿主耦合] 薄 Adapter 不应固定模型:\n${modelHits.join('\n')}`);
   }
 
-  // --- 6. 阶段索引同步 [warning] ---
-  markGate('6', '阶段索引同步');
-  for (const cmd of ['plan', 'design', 'build', 'test', 'deploy', 'maintain', 'review']) {
-    for (const doc of ['AGENTS.md', '.agents/commands/new-task.md']) {
-      // existsSync 守卫（2026-10-06-check19-entry-enoent 同类）：两文件可合法缺失（下方 text 判空本就
-      // 预期缺失态），fail-loud fs 读下按空跳过、不再响亮出账
-      const docPath = path.join(ROOT, doc);
-      const text = fs.existsSync(docPath) ? linesOf(docPath) : null;
-      if (text && !text.some((l) => l.includes(`.agents/commands/${cmd}.md`))) {
-        warnings.push(`- [WARN 阶段索引漂移] ${doc} 缺 ${cmd} 指令索引(两处阶段表须同步维护)`);
-      }
-    }
-  }
+  // --- 6. 阶段索引同步 [warning]（2026-10-09 engine-quality-round2 A1：实现迁 check-stage-index.mjs——
+  //     先例 check-hygiene / check-metric-claims；段 id 沿 sh 版 '6'，清单编号 7 与文案逐字不动；
+  //     调用点位置即输出顺序契约）---
+  warnings.push(...runCheckStageIndex({ root: ROOT, linesOf, gateStats }));
 
   // --- 共享：文件「首次加入 git」的日期索引（2026-09-28 check8-git-anchor）---
   // 用途：检查 8 的生效日锚从**可手填的文件名前缀**（项目命名规范本身即 `YYYY-MM-DD-<主题>`，作者
@@ -626,18 +611,13 @@ export function runCheckLoop(opts = {}) {
   // 非 git / 命令失败 → null，调用方按既有「非 git 跳过」语义退化（不 fail-loud）。
   // 注：检查 10 需要的是「文件→加入 commit」+「commit→文件清单」两份映射（判断同提交是否触及迁移 SQL），
   // 与本索引「文件→日期」不同构，故**不合并**——避免把两处判据耦死。
-  const addedDates = (() => {
-    if (gitOut(['rev-parse', '--git-dir']) === null) return null;
-    const log = gitOut(['log', '--diff-filter=A', '--format=@%aI', '--name-only']);
-    if (log === null) return null;
-    const m = new Map();
-    let cur = null;
-    for (const line of log.split('\n')) {
-      if (line.startsWith('@')) { cur = line.slice(1); continue; }
-      if (line.trim() && cur && !m.has(line.trim())) m.set(line.trim(), cur); // 新→旧序首遇 = 最早
-    }
-    return m;
-  })();
+  // addedDates（2026-10-09 engine-quality-round3 W1）：全史解析走持久缓存（HEAD 键）——
+  // 同 HEAD 多入口复跑（verify/edit-face-check/pre-commit/CI）不再重复全算；git-dir 探测保留在前。
+  const addedDates = gitOut(['rev-parse', '--git-dir']) === null ? null : addedDatesWithCache({
+    head: gitOut(['rev-parse', 'HEAD']),
+    gitLog: () => gitOut(['log', '--diff-filter=A', '--format=@%aI', '--name-only']),
+    cachePath: path.join(ROOT, '.agents', 'cache', 'added-dates.json'),
+  });
   // 某文档「首次加入日期」（YYYY-MM-DD）；不可判定（非 git / 查不到）返回 ''
   const addedDateOf = (absDoc) => {
     if (!addedDates) return '';
@@ -723,7 +703,7 @@ export function runCheckLoop(opts = {}) {
       if (/^##\s+(改动面|任务拆解|改动方案)/.test(line)) { inDeclaredSec = true; continue; }
       if (inDeclaredSec && /^##\s+/.test(line)) { inDeclaredSec = false; continue; }
       if (inDeclaredSec) {
-        const fileMatch = line.match(/([a-zA-Z0-9._\/-]+\.[a-zA-Z0-9]+)/);
+        const fileMatch = line.match(/([a-zA-Z0-9._/-]+\.[a-zA-Z0-9]+)/);
         if (fileMatch) declaredFiles.push(fileMatch[1]);
       }
     }
@@ -773,8 +753,39 @@ export function runCheckLoop(opts = {}) {
     const verifyFreshGlobal = verifyLines ? hasFreshVerifyLine(verifyLines) : false;
     // 2026-10-08 verify-doc-binding：v6+（verifyDocSince）按本 doc 精确匹配；缺键维持全局布尔。
     const verifyDocBound = typeof kitPolicy.verifyDocSince === 'string';
+    // 2026-10-09 verifydoc-anchor：v6 精确匹配的**追溯边界**——只对「确认门 done ts ≥ verifyDocSince」的单生效。
+    // 背景（用户 2026-10-09 拍板 D）：4 单（verify-evidence / workflow-dashboard / selfmeasure / gate-roi-metrics）
+    // 的 done ts 均 < v6 上线日（2026-10-08 17:37），它们关单时既无 --doc 机制、也无从补证——被精确匹配追责
+    // 会产 9 条不可消退 advisory（补跑=自证，回溯不了关单当时全绿，与门禁本意相悖）。退回全局布尔 = v5 语义
+    // （不误报、不伪造），与检查 15/18 生效日锚同构。done ts 台账读一次循环外缓存，零新增子进程。
+    const verifyDocSinceTs = verifyDocBound ? kitPolicy.verifyDocSince : null;
+    const doneTsOf = (() => {
+      const map = new Map();
+      try {
+        const lp = path.join(ROOT, '.agents', 'confirmations.jsonl');
+        if (fs.existsSync(lp)) {
+          for (const line of fs.readFileSync(lp, 'utf8').split(/\r?\n/)) {
+            if (!line.trim()) continue;
+            try {
+              const e = JSON.parse(line);
+              // append-only 取末次 done 跳转（同一 doc 多次 done 取最后一条 ts）
+              if (e && e.doc && ['done', 'closed'].includes(e.stage)) map.set(e.doc, e.ts || '');
+            } catch { /* 坏行跳过（同检查 15 口径） */ }
+          }
+        }
+      } catch { /* 台账不可读 → 无锚 → 全走全局布尔（fail-open，不误报 hard） */ }
+      return map;
+    })();
+    // 该 doc 的确认门 done 是否落在 v6 追溯窗口内；无台账行 / 台账不可读 → false（存量豁免，退回全局布尔）
+    // 2026-10-09 verifydoc-anchor：按 ISO 时刻比较（不再是日期粒度）——机制上线当日的更早时刻 done 的单
+    // 仍在窗口外（日期粒度会把同日的早时刻误纳入，见 policy.mjs verifyDocSince 注释）。
+    const verifyDocInWindow = (rel) => {
+      if (!verifyDocSinceTs) return false;
+      const ts = doneTsOf.get(rel);
+      return !!ts && ts >= verifyDocSinceTs;
+    };
     const verifyFreshFor = (rel) => (verifyLines
-      ? hasFreshVerifyLine(verifyLines, Date.now(), verifyDocBound ? rel : null)
+      ? hasFreshVerifyLine(verifyLines, Date.now(), verifyDocInWindow(rel) ? rel : null)
       : false);
     for (const intent of docFiles('intents')) {
       if (fmGet(intent, '状态') !== 'done') continue;
@@ -960,10 +971,39 @@ export function runCheckLoop(opts = {}) {
     const EFFECTIVE = kitPolicy.confirmDocsEffective;
     const ledgerPath = path.join(ROOT, '.agents', 'confirmations.jsonl');
     const ledger = [];
+    const ledgerBadLines = []; // 坏行（JSON.parse 失败）的物理行号（复核 P2-1：报文行号须对齐物理行）
     if (fs.existsSync(ledgerPath)) {
-      for (const line of linesOf(ledgerPath) || []) {
+      for (const [lineNo, line] of (linesOf(ledgerPath) || []).entries()) {
         if (!line.trim()) continue;
-        try { ledger.push(JSON.parse(line)); } catch { /* 坏行跳过 */ }
+        try { ledger.push(JSON.parse(line)); } catch { ledgerBadLines.push(lineNo + 1); }
+      }
+    }
+    // 台账哈希链校验（2026-10-09 engine-quality-round2 D；写入侧=confirm-doc appendLedger，哈希单源
+    // policy.ledgerChainHash——判定零复刻）。判据：连续带 hash 行段内，① prevHash 须等于前一带 hash
+    // 行的 hash（无 hash 行后链段重启 ''，与写入侧读末行口径一致）；② hash 须可重算一致。
+    // **坏行口径（复核 P2-1 勘误，此前注释误称「与写入侧一致」）**：坏行被本解析整体剔除、不重置游标
+    // ——坏行后写入的链行（写入侧读末行遇坏行 prevHash=''）验链必失配出账。这是**预期 fail-loud**
+    // （坏行本身即台账完整性事故，应人工查验），非口径一致场景。
+    // 断裂 = hard「台账链断裂」（只报首断**物理行号** + 影响行计数，不做逐行刷屏）——就地改/删中间行
+    // 必留痕迹；边界：整文件重写可重建链，不可机器防，兜底 = 台账自身 git 历史（check-ledger-invariant）。
+    // 历史行（v1.5.0 前，无 hash 字段）零回填零告警——向后兼容。
+    {
+      let prevHash = '';
+      let brokenAt = 0;
+      let brokenCount = 0;
+      ledger.forEach((row, idx) => {
+        if (!row || typeof row.hash !== 'string') { prevHash = ''; return; } // 存量行/无链字段 → 链段重启
+        const { hash, prevHash: p, ...rest } = row;
+        const ok = (p ?? '') === prevHash && ledgerChainHash(rest, p ?? '') === hash;
+        if (!ok) {
+          if (!brokenAt) brokenAt = idx + 1;
+          brokenCount++;
+        }
+        prevHash = hash;
+      });
+      if (brokenAt) {
+        const physical = brokenAt + ledgerBadLines.filter((n) => n <= brokenAt).length; // 物理行号（复核 P2-1：剔除坏行会令数组下标漂移）
+        blockers.push(`- [台账链断裂] confirmations.jsonl 自第 ${physical} 行（物理）起哈希链校验失败（共 ${brokenCount} 行不一致——append-only 台账出现就地改/删痕迹；prevHash 接续或内容重算不符。整文件重写不可机器防，对质走台账自身 git 历史）`);
       }
     }
     // incidents 侧覆盖（2026-09-27 gate-coverage）：fixed/closed 为已确认态（open = 起草态不加门——
@@ -1414,6 +1454,43 @@ export function fmStatus(text) {
 // lines 已 CRLF 归一（split(/\r?\n/)），frontmatter 区内首个「状态:」行保分隔符换值为 prev（`状态:  done`
 // 双空格 → `状态:  approved`——与前向按原行字面计算对称，非规范分隔符不误伤；行尾空白等更奇异格式仍会
 // 失配，触发前提本身已违反「确认落态唯一入口」约定，接受），全文剔「确认指纹:」行后 join('\n') 再 sha256。
+// parseAddedDatesLog：git log（--diff-filter=A --format=@%aI --name-only）文本 → Map(rel → 加入 ISO 时间)。
+// 新→旧序首遇 = 最新一次加入（复核 P2-1 勘误：旧注释「最早」系误述——行为原样零复刻，检查 8 isNew 取最新加入日期更保守）。
+export function parseAddedDatesLog(logText) {
+  const m = new Map();
+  let cur = null;
+  for (const line of logText.split('\n')) {
+    if (line.startsWith('@')) { cur = line.slice(1); continue; }
+    if (line.trim() && cur && !m.has(line.trim())) m.set(line.trim(), cur);
+  }
+  return m;
+}
+
+// addedDatesWithCache：addedDates 的持久缓存层（2026-10-09 engine-quality-round3 W1）。
+// 键 = HEAD sha（同 commit 祖先不可变 → log 幂等；rebase 必改 HEAD 必重算；复核 P2-4：shallow→unshallow 同 HEAD 可见性增长有陈旧窗口——后果退化为旧行为 addedDateOf 返回 ""，HEAD 变化自愈）；
+// 缓存位于 .agents/cache/（gitignored 运行态）；读/写任一失败 fail-open 回退全算（门禁不失效）；
+// head 缺省（detached --rev worktree 等场景）→ 不读写缓存直接全算（语义不变）。
+export function addedDatesWithCache({ head, gitLog, cachePath }) {
+  if (head) {
+    try {
+      const c = JSON.parse(fs.readFileSync(cachePath, 'utf8'));
+      if (c && c.head === head && c.map && Object.keys(c.map).length) return new Map(Object.entries(c.map));
+    } catch { /* 缓存缺失/损坏 → 全算 */ }
+  }
+  const log = gitLog();
+  if (log === null) return null;
+  const m = parseAddedDatesLog(log);
+  if (head) {
+    try {
+      fs.mkdirSync(path.dirname(cachePath), { recursive: true });
+      const tmp = cachePath + '.tmp';
+      fs.writeFileSync(tmp, JSON.stringify({ head, map: Object.fromEntries(m), savedAt: new Date().toISOString() }) + '\n');
+      fs.renameSync(tmp, cachePath);
+    } catch { /* 写失败 fail-open：本轮已用全算结果，缓存留待下次 */ }
+  }
+  return m;
+}
+
 export function bindingSha256(lines, prevStatus) {
   const isDelim = (l) => /^---\s*$/.test(l);
   const out = [];

package/templates/_agents/scripts/check-loop.test.mjs

@@ -12,7 +12,8 @@ import { spawnSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
 import { computeFingerprint } from './confirm-doc.mjs';
 import { POLICIES, loadKitPolicy } from './policy.mjs';
-import { entryConfirmed, MARK_RE, laneOfEntry, laneOfDoc } from './stage-gates.mjs';
+import { entryConfirmed, laneOfEntry, laneOfDoc } from './stage-gates.mjs';
+import { parseAddedDatesLog, addedDatesWithCache } from './check-loop.mjs';
 
 const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
 const CHECK_LOOP = path.join(SCRIPT_DIR, 'check-loop.mjs');
@@ -2902,5 +2903,70 @@ w(T, 'workflow/intents/2026-09-12-deep.md', INTENT('deep', '状态: draft\n级
   rmfix(T);
 }
 
+// ---- 场景 21:台账哈希链（2026-10-09 engine-quality-round2 D）——篡改必抓 / 存量零告警 ----
+{
+  // 21a：连续带 hash 行中间被篡改（改 quote 不动链字段）→ hard「台账链断裂」
+  const T = mkfix();
+  const { ledgerChainHash } = await import('./policy.mjs');
+  const chainRow = (prevHash, fields) => {
+    const row = { ...fields, prevHash };
+    return { ...row, hash: ledgerChainHash(fields, prevHash) };
+  };
+  const row1 = chainRow('', { ts: '2026-10-09T01:00:00Z', doc: 'workflow/intents/2026-10-09-a.md', stage: 'approved', fingerprint: 'a'.repeat(64), prev: 'draft', source: 'chat-delegated', quote: '真原话一' });
+  const row2 = chainRow(row1.hash, { ts: '2026-10-09T02:00:00Z', doc: 'workflow/intents/2026-10-09-a.md', stage: 'done', fingerprint: 'b'.repeat(64), prev: 'approved', source: 'chat-delegated', quote: '真原话二' });
+  // 篡改第一行 quote（链字段不动 → hash 失配）
+  const tampered = { ...row1, quote: '篡改后的假原话' };
+  writeLedger(T, [tampered, row2]);
+  let r = run(T);
+  let out = outOf(r);
+  check('场景 21a 链断裂：中间行篡改 → hard 台账链断裂（指首断行号）',
+    r.status !== 0 && out.includes('台账链断裂') && /第 1 行/.test(out), `exit=${r.status}\n${out.slice(-400)}`);
+  // 反证还原：篡改行恢复原 quote → 链复通（断言非恒绿）
+  writeLedger(T, [row1, row2]);
+  r = run(T);
+  check('场景 21b 反证还原：篡改修复 → 链校验通过', !outOf(r).includes('台账链断裂'), outOf(r).slice(-300));
+  rmfix(T);
+}
+{
+  // 21c：全无 hash 的存量台账（v1.5.0 前形态）→ 零链告警（向后兼容）
+  const T = mkfix();
+  writeLedger(T, [
+    { ts: '2026-09-20T01:00:00Z', doc: 'workflow/intents/2026-09-20-legacy.md', stage: 'approved', fingerprint: 'c'.repeat(64), prev: 'draft' },
+    { ts: '2026-09-20T02:00:00Z', doc: 'workflow/intents/2026-09-20-legacy.md', stage: 'done', fingerprint: 'd'.repeat(64), prev: 'approved' },
+  ]);
+  const r = run(T);
+  check('场景 21c 存量无 hash 行：零链告警（不追溯）', !outOf(r).includes('台账链断裂'), outOf(r).slice(-300));
+  rmfix(T);
+}
+
+
+// ---- 场景 22:addedDates 持久缓存（2026-10-09 engine-quality-round3 W1）----
+{
+  const log = '@2026-10-02T10:00:00+08:00\nworkflow/intents/a.md\nworkflow/plans/a.md\n@2026-10-01T09:00:00+08:00\nworkflow/intents/a.md\n';
+  const m = parseAddedDatesLog(log);
+  check('场景 22a 提取：新→旧序首遇 = 最新一次加入（原 IIFE 语义零复刻；注释「最早」为历史误述）', m.get('workflow/intents/a.md') === '2026-10-02T10:00:00+08:00' && m.get('workflow/plans/a.md') === '2026-10-02T10:00:00+08:00', JSON.stringify([...m]));
+}
+{
+  const cacheP = path.join(os.tmpdir(), 'adc-' + Date.now() + '.json');
+  let gitLogCalls = 0;
+  const gitLog = () => { gitLogCalls++; return '@2026-10-01T09:00:00+08:00\nworkflow/intents/a.md\n'; };
+  const head = 'head-sha-1';
+  const m1 = addedDatesWithCache({ head, gitLog, cachePath: cacheP });
+  const m2 = addedDatesWithCache({ head, gitLog, cachePath: cacheP });
+  check('场景 22b 缓存命中：同 HEAD 二次调用 gitLog 仅 1 次且结果一致',
+    gitLogCalls === 1 && m1.get('workflow/intents/a.md') === m2.get('workflow/intents/a.md'), 'calls=' + gitLogCalls);
+  const m3 = addedDatesWithCache({ head: 'head-sha-2', gitLog, cachePath: cacheP });
+  check('场景 22c HEAD 变更：重算（gitLog 计 2 次）', gitLogCalls === 2 && m3.get('workflow/intents/a.md') === '2026-10-01T09:00:00+08:00', 'calls=' + gitLogCalls);
+  fs.writeFileSync(cacheP, '{broken json');
+  const before = gitLogCalls;
+  const m4 = addedDatesWithCache({ head: 'head-sha-2', gitLog, cachePath: cacheP });
+  check('场景 22d 缓存损坏：fail-open 全算（gitLog 再调 1 次）且结果正确',
+    gitLogCalls === before + 1 && m4.get('workflow/intents/a.md') === '2026-10-01T09:00:00+08:00', 'calls=' + gitLogCalls);
+  const before2 = gitLogCalls;
+  addedDatesWithCache({ head: null, gitLog, cachePath: cacheP });
+  check('场景 22e 无 head：不读缓存直接全算（gitLog 再调 1 次）', gitLogCalls === before2 + 1, 'calls=' + gitLogCalls);
+  fs.rmSync(cacheP, { force: true });
+}
+
 console.log(`\n合计: PASS ${pass} / FAIL ${fail}`);
 process.exit(fail ? 1 : 0);

package/templates/_agents/scripts/check-stage-index.mjs

@@ -0,0 +1,40 @@
+// check-stage-index.mjs — check-loop 检查 7 模块（阶段索引同步，2026-10-09 engine-quality-round2 A1）
+// 拆分先例 = check-hygiene.mjs（检查 2/9/11/12/13）/ check-metric-claims.mjs（检查 16）：
+//   ctx 传入既有 helper（linesOf——读异常响亮出账 + 按空文档降级的语义承载者，零复刻），
+//   模块只返回 warnings 数组，不打印、不 exit、不改 ctx。
+// 输出顺序契约：调用点位置即 warnings 插入序（check-loop 原位调用，段 id 沿 sh 版 '6'——清单编号 7
+//   不动，gate-checklist 按 id 消费面不受影响）。
+// 判据（沿 sh 版逐条）：AGENTS.md 与 .agents/commands/new-task.md 须各含全部阶段指令路径串
+//   `.agents/commands/<cmd>.md`（双向索引）；缺任一 = WARN。两文件可合法缺失（text 判空预期缺失态）。
+// 测试：node templates/_agents/scripts/check-stage-index.test.mjs
+import fs from 'node:fs';
+import path from 'node:path';
+import { gateSeg, finishSegs, makeCollector, appendSegs } from './gate-seg.mjs';
+
+const STAGE_CMDS = ['plan', 'design', 'build', 'test', 'deploy', 'maintain', 'review'];
+const FACE_DOCS = ['AGENTS.md', '.agents/commands/new-task.md'];
+
+export function runCheckStageIndex(ctx) {
+  const { root: ROOT, linesOf } = ctx;
+  const warnings = [];
+  // 插桩（selfmeasure 先例）：局部收集器 + appendSegs 并入全局——模块产出局部数组，直接共用全局
+  // 游标会错账（check-hygiene.mjs:36-39 实测教训）
+  const localStats = makeCollector(warnings, []);
+  const markGate = (id, label) => { if (ctx.gateStats) gateSeg(localStats, id, label); };
+
+  markGate('6', '阶段索引同步');
+  for (const cmd of STAGE_CMDS) {
+    for (const doc of FACE_DOCS) {
+      // existsSync 守卫（2026-10-06-check19-entry-enoent 同类）：两文件可合法缺失（下方 text 判空本就
+      // 预期缺失态），fail-loud fs 读下按空跳过、不再响亮出账
+      const docPath = path.join(ROOT, doc);
+      const text = fs.existsSync(docPath) ? linesOf(docPath) : null;
+      if (text && !text.some((l) => l.includes(`.agents/commands/${cmd}.md`))) {
+        warnings.push(`- [WARN 阶段索引漂移] ${doc} 缺 ${cmd} 指令索引(两处阶段表须同步维护)`);
+      }
+    }
+  }
+
+  if (ctx.gateStats) appendSegs(ctx.gateStats, finishSegs(localStats));
+  return warnings;
+}