agentic-flow-kit 0.9.0 → 0.9.4

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

@@ -19,11 +19,22 @@ description: 闭环总入口 · 路由判断（新需求 → wf-plan / 修复
 | **Maintain** | [.agents/commands/maintain.md](.agents/commands/maintain.md) | "线上出事了" / "记一笔 incident" | `implementer`(方案确认后) | 三件套要点确认 |
 | **Review**(横切,不占 6 阶段) | [.agents/commands/review.md](.agents/commands/review.md) | "评审一下" / "过 review 标准" | `independent-reviewer`(L2/L3 必须独立复核) | 问题定性与合入时机确认 |
 
+## 风险定级(第 0 步,先定级再路由)
+
+动工前先按下表定风险级 L0-L3(就高不就低;判据细则见下节「级别判断」),级别即风险级,决定走哪条泳道——确认放事前,还是审计补事后:
+
+| 泳道 | 级别 | 确认与审计口径 |
+|------|------|---------------|
+| **协作道**(敏捷优先,审计异步补) | L0 例行 / L1 实现级 | L0 直接 commit,豁免 intent;L1 快车道(intent 一句话确认 + 极简 plan)即动工。独立复核不设同步前置,check-loop 与事后 review 兜底;确认/代录可 `--batch` 批量(仅 L0/L1) |
+| **防御道**(严谨优先,确认同步拦) | L2 规则/契约 / L3 数据与运行时结构 | 同步确认门:spec 确认通过方可起草 plan,plan 确认后方可动手;L3 加新会话独立复核,未确认不放行 |
+
+> 定级结果落 intent frontmatter `risk_level`(=级别,`fill-intent.mjs` 自动写入,机器选道用);协作道勾触达红线会被 check-loop 判「红线判低」hard 拦(就高升级 L2/L3 并补同名 spec)。
+
 ## 路由判断
 
 - **新需求 / 功能**:从 `plan.md` 进,立 **intent**(`workflow/intents/`)
 - **修复类任务 / 事故**:从 `maintain.md` 进,立 **incident**(`workflow/incidents/`);incident 在 L1+ 即 **intent 等价物**(check-loop 认 incident≡intent),不必另立 intent。先检索同类历史(`node .agents/scripts/kb-search.mjs "<关键词>" --scope workflow --type incidents,plans`),有同类先读其历史三件套;再按级别走:
- - L0 → 直接修复;L1 → 立 incident 后进 `build.md` 起草并确认同名 plan → `test.md`
+  - L0 → 直接修复;L1 → 立 incident 后进 `build.md` 起草并确认同名 Quick-Plan → `test.md`
  - L2/L3 → 立 incident 后进 `design.md` 起草并确认同名 spec,再进 `build.md` 起草并确认同名 plan → `test.md`
  - 仅当根因属系统性 / 门禁缺位(maintain.md 三件套「是否需要新 intent」选"是")才另立 `workflow/intents/` 同名 intent
 - **改完代码要验证**:直接进 `test.md`（验证通过即关单；L1 到此结束）
@@ -35,7 +46,7 @@ description: 闭环总入口 · 路由判断（新需求 → wf-plan / 修复
 | 级别 | 改什么 | 流程 |
 |------|--------|------|
 | L0 | 文档/样式微调(无行为影响) | 直接 commit,豁免 intent |
-| L1 | **实现级改动**(未命中 L2/L3) | 轻量入口文档(intent / incident) + plan |
+| L1 | **实现级改动**(未命中 L2/L3) | 快车道:液态草稿(.zcode/drafts) $\rightarrow$ 实现 $\rightarrow$ 固化(`solidify-task.mjs`)——用户确认后带 `--delegated "<原话>"` 执行；无确认来源只迁移不落账 |
 | L2 | **规则 / 契约**(一处改、多处依赖) | 入口文档(intent / incident) + spec + plan 三件套 |
 | L3 | **数据与运行时结构**(schema / 迁移 SQL / DI 链 / 认证与中间件管线) | 同 L2 + spec 新会话独立复核 |
 

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

@@ -14,11 +14,11 @@ description: Plan 阶段 · 立 intent（AI 起草、用户确认；本阶段不
 1. 若 `workflow/intents/` 已有目标 intent 且状态为 approved → 按级别跳 next（L1 → `build.md`，L2/L3 → `design.md`）
 2. 否则起草新 intent:
    - **先检索同类**：`node .agents/scripts/kb-search.mjs "<关键词>" --scope workflow --type intents,specs`——命中同类先读其结论与验收，新 intent 引用（防重复立项 / 重复踩坑）
-   - **填空工具先跑**：`node .agents/scripts/fill-intent.mjs --module <模块> --level <L0|L1|L2|L3> --topic <主题> --output workflow/intents/<date>-<主题>.md --notes "<备注>"`——输出含 frontmatter 6 字段（含 risk_level）+ 7 节正文（背景与问题/目标/非目标/约束/影响面/触达红线/验收标准）的草稿；AI 据此填实，模板与节标题机器保证不出错
+   - **填空工具先跑**：`node .agents/scripts/fill-intent.mjs --module <模块> --level <L0|L1|L2|L3> --topic <主题> --output workflow/intents/<date>-<主题>.md --notes "<备注>"`——输出含 frontmatter 6 字段（含 risk_level）+ 9 节（背景与问题/历史教训防复发/目标/非目标/约束/影响面/触达红线/验收标准 8 节正文 + 确认与复核）的草稿；AI 据此填实，模板与节标题机器保证不出错
    - 复制 `workflow/intents/_TEMPLATE.md` → `workflow/intents/YYYY-MM-DD-<主题>.md`
    - frontmatter 填 `模块:`（词表见 `.agents/workflow-modules.txt`，新建文档必填，check-loop 会警告）
-   - 按 6 节填写:背景与问题 / 目标(可验证) / 非目标 / 约束 / 影响面 / 触达红线（L1 微改动可省非目标/约束两节，不硬填）
-   - 红线勾选对照根 `AGENTS.md`「Working rules」+ 改动域目录级 `AGENTS.md`（如有）;**没触及就全不勾**,不要硬填
+   - 按 8 节填写:背景与问题 / 历史教训防复发 / 目标(可验证) / 非目标 / 约束 / 影响面 / 触达红线 / 验收标准（L1 微改动可省非目标/约束两节，不硬填）
+   - 红线勾选对照根 `AGENTS.md` 红线/约束相关节（如「项目适配区」「门禁与提交」）+ 改动域目录级 `AGENTS.md`（如有）;**没触及就全不勾**,不要硬填
 3. 写不出可测试判据 = 还没想清楚 → 反问澄清,不要硬填
 4. 起草后停下,输出草稿全文给用户过目,一句"可以"即确认
 

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

@@ -10,7 +10,7 @@ description: 跨宿主适配层同步（正文段 sha 比对 + 用户拍板 +
 
 ## 何时跑
 
-- 改 `templates/_agents/commands/*.md` 正文后（8 个 commands 文件）
+- 改 `templates/_agents/commands/*.md` 正文后（11 个 commands 文件）
 - 改 `templates/_agents/roles/*.md` 正文后（3 个 roles 文件）
 - 装户跑 `flow-kit doctor` 报"跨宿主薄适配正文漂移 N 对" WARN 时
 - 不跑：仅改 frontmatter；改 trae 钩子/规则；改包源其他文件

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

@@ -56,7 +56,7 @@ node bin/flow-kit.mjs doctor                       # §6.5 delegations + §6.6 o
 - 失败项已修复并复测通过
 - **关单**（日常闭环点，不依赖是否上 prod）:
   - 关单前一键过门：`node .agents/scripts/verify.mjs`（npm test + check-loop 固定编排，任一失败非零退出，非绿不关单）
-  - 新需求：逐条勾验入口 intent「验收标准」，每条补「证据：」，intent → done；同名 spec（若有）仍 approved → done
+  - 新需求：逐条勾验入口 intent「验收标准」，每条补「证据：」（例如：粘贴 CI 运行结果、UI 截图路径、或具体的 commit SHA），intent $\rightarrow$ done；同名 spec/Quick-Plan（若有）仍 approved $\rightarrow$ 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。
   - 修复：防复发验证已落地，incident → closed（经确认门 confirm-doc：open→fixed / fixed→closed 两跳、无单跳；2026-09-28 起 check-loop 15 对账——关单编辑先于 closed 确认，口径同 done 内容绑定）

package/modules/hosts/trae/rules/project-workflow.md

@@ -2,7 +2,7 @@
 alwaysApply: true
 ---
 
-本项目工作流唯一权威是根目录 `AGENTS.md`：开工前必须完整读取并严格遵循（任务流程 / 通用 Working rules / 目录级规则 / 运行时与验证标准），本规则只做入口指针，不复制内容。
+本项目工作流唯一权威是根目录 `AGENTS.md`：开工前必须完整读取并严格遵循（任务流程 / 通用约束与红线 / 目录级规则 / 运行时与验证标准），本规则只做入口指针，不复制内容。
 
 - 规则加载是惰性的：根 `AGENTS.md` 常驻；目录级 `AGENTS.md`（如有，如 `backend/AGENTS.md`、`frontend/AGENTS.md`）只在该目录文件被读取或被提及时才生效——动对应目录前先主动读，别凭记忆。
 - 终端环境差异（shell 可用性 / 退出码取法 /「命令不存在 ⇒ 假绿」）见 `.agents/notes/runtime-env.md` §1。

package/package.json

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

package/templates/_agents/commands/build.md

@@ -28,7 +28,7 @@ next: .agents/commands/test.md
 1. 确认同名入口文档（approved intent 或已确认的 incident）+ spec（若 L2/L3）均已确认；否则回上一阶段（fill/confirm 未过即拒）
 2. 起草 plan:
    - 复制 `workflow/plans/_TEMPLATE.md` → `workflow/plans/YYYY-MM-DD-<主题>.md`(与入口文档同名)
-   - L2/L3 按 4 节填写:任务拆解(每个任务有判据) / 风险评估 / 执行顺序 / 遗留项
+   - L2/L3 按 4 节填写:改动方案 / 任务拆解(每个任务有判据) / 执行顺序 / 验证计划（与 fill-plan.mjs 单源一致）
    - L1 使用 Quick-Plan 极简三节:改动方案 / 约束与风险(原 Spec 核心) / 验证计划；多文件多步骤时可补任务拆解/执行顺序
 3. 停下,输出 plan 草稿全文给用户过目,一句"可以"即确认。**逐件确认**:入口文档 / spec / plan 各自的确认点不得并作一次,plan 草稿须全文过目(不接受摘要代替)。**逐件配逐件原话**:`--delegated` 每次传当次实际放行的措辞,不复用同句——复用同句使台账 quote 失去分辨力(事后对质看不出放行的是哪一件);原因与根治见 workflow/papercuts.md 2026-09-28
 **确认落态唯一入口**（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。
@@ -41,7 +41,7 @@ next: .agents/commands/test.md
    - 列改动文件清单(读后改 vs 新建)
    - 列步骤(改 X 文件做 Y → 改 Z 文件做 W)
    - **owned 文件同步**：kit.owned 列表文件（AGENTS.md / workflow 模板等）sync 不动，须列「手动同步装副本」步骤（见 incidents/2026-09-25-wf-runtime 复盘）
-   - 标注触达红线(对照根 `AGENTS.md`「Working rules」+ 改动域目录级 `AGENTS.md`（如有）)
+   - 标注触达红线(对照根 `AGENTS.md` 红线/约束相关节（如「项目适配区」「门禁与提交」）+ 改动域目录级 `AGENTS.md`（如有）)
 6. 停下,等用户确认改动清单
 
 ### 实现

package/templates/_agents/commands/design.md

@@ -31,7 +31,7 @@ next: .agents/commands/build.md
    - **填空工具先跑**：`node .agents/scripts/fill-spec.mjs --level <L1|L2|L3> --topic <主题> --output workflow/specs/<date>-<主题>.md`——输出含 frontmatter 5 字段 + 5 节正文（功能行为/数据流/系统改动/约束遵守映射/风险评估）的草稿；AI 据此填实
    - 复制 `workflow/specs/_TEMPLATE.md` → `workflow/specs/YYYY-MM-DD-<主题>.md`(与入口文档同名)
    - 按 5 节填写:功能行为 / 数据流 / 系统改动 / 约束遵守映射 / 风险评估
-   - 约束映射必须对照根 `AGENTS.md`「Working rules」与改动域目录级 `AGENTS.md`（如有）逐条说明如何满足
+   - 约束映射必须对照根 `AGENTS.md` 红线/约束相关节（如「项目适配区」「门禁与提交」）与改动域目录级 `AGENTS.md`（如有）逐条说明如何满足
    - 存在多个可行方案时,在 spec 中列出各方案取舍与 AI 建议项,由用户选定后方可确认
    - **页面/交互入口形态必须用户确认**:spec 须写明入口是「表单（字段清单）」还是「选择器/弹窗」，禁止自行推定交互形态
 4. 起草后停下,输出草稿全文给用户过目

package/templates/_agents/commands/new-task.md

@@ -53,7 +53,7 @@ next: 按阶段路由
 | 级别 | 改什么 | 流程 |
 |------|--------|------|
 | L0 | 文档/样式微调(无行为影响) | 直接 commit,豁免 intent |
-| L1 | **实现级改动**(未命中 L2/L3) | 快车道:液态草稿(.zcode/drafts) $\rightarrow$ 实现 $\rightarrow$ 一键固化(`solidify-task.mjs`) |
+| L1 | **实现级改动**(未命中 L2/L3) | 快车道:液态草稿(.zcode/drafts) $\rightarrow$ 实现 $\rightarrow$ 固化(`solidify-task.mjs`)——用户确认后带 `--delegated "<原话>"` 执行；无确认来源只迁移不落账 |
 | L2 | **规则 / 契约**(一处改、多处依赖) | 入口文档(intent / incident) + spec + plan 三件套 |
 | L3 | **数据与运行时结构**(schema / 迁移 SQL / DI 链 / 认证与中间件管线) | 同 L2 + spec 新会话独立复核 |
 

package/templates/_agents/commands/plan.md

@@ -21,11 +21,11 @@ next: L1 → .agents/commands/build.md (起草 Quick-Plan) ；L2/L3 → .agents/
 1. 若 `workflow/intents/` 已有目标 intent 且状态为 approved → 按级别跳 next（L1 → `build.md`，L2/L3 → `design.md`）
 2. 否则起草新 intent:
    - **先检索同类**：`node .agents/scripts/kb-search.mjs "<关键词>" --scope workflow --type intents,specs`——命中同类先读其结论与验收，新 intent 引用（防重复立项 / 重复踩坑）
-   - **填空工具先跑**：`node .agents/scripts/fill-intent.mjs --module <模块> --level <L0|L1|L2|L3> --topic <主题> --output workflow/intents/<date>-<主题>.md --notes "<备注>"`——输出含 frontmatter 6 字段（含 risk_level）+ 7 节正文（背景与问题/目标/非目标/约束/影响面/触达红线/验收标准）的草稿；AI 据此填实，模板与节标题机器保证不出错
+   - **填空工具先跑**：`node .agents/scripts/fill-intent.mjs --module <模块> --level <L0|L1|L2|L3> --topic <主题> --output workflow/intents/<date>-<主题>.md --notes "<备注>"`——输出含 frontmatter 6 字段（含 risk_level）+ 9 节（背景与问题/历史教训防复发/目标/非目标/约束/影响面/触达红线/验收标准 8 节正文 + 确认与复核）的草稿；AI 据此填实，模板与节标题机器保证不出错
    - 复制 `workflow/intents/_TEMPLATE.md` → `workflow/intents/YYYY-MM-DD-<主题>.md`
    - frontmatter 填 `模块:`（词表见 `.agents/workflow-modules.txt`，新建文档必填，check-loop 会警告）
-   - 按 6 节填写:背景与问题 / 目标(可验证) / 非目标 / 约束 / 影响面 / 触达红线（L1 微改动可省非目标/约束两节，不硬填）
-   - 红线勾选对照根 `AGENTS.md`「Working rules」+ 改动域目录级 `AGENTS.md`（如有）;**没触及就全不勾**,不要硬填
+   - 按 8 节填写:背景与问题 / 历史教训防复发 / 目标(可验证) / 非目标 / 约束 / 影响面 / 触达红线 / 验收标准（L1 微改动可省非目标/约束两节，不硬填）
+   - 红线勾选对照根 `AGENTS.md` 红线/约束相关节（如「项目适配区」「门禁与提交」）+ 改动域目录级 `AGENTS.md`（如有）;**没触及就全不勾**,不要硬填
 3. 写不出可测试判据 = 还没想清楚 → 反问澄清,不要硬填
 4. 起草后停下,输出草稿全文给用户过目,一句"可以"即确认
 

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

@@ -22,7 +22,7 @@ next: .agents/commands/build.md（漂移属 build 改权威源未同步导致的
 
 ## 何时跑
 
-- 改 `templates/_agents/commands/*.md` 正文后（8 个 commands 文件）
+- 改 `templates/_agents/commands/*.md` 正文后（11 个 commands 文件）
 - 改 `templates/_agents/roles/*.md` 正文后（3 个 roles 文件）
 - 装户跑 `flow-kit doctor` 报"跨宿主薄适配正文漂移 N 对" WARN 时
 - 不跑：仅改 frontmatter；改 trae 钩子/规则；改包源其他文件

package/templates/_agents/scripts/check-lane-surface.mjs

@@ -23,6 +23,8 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { spawnSync } from 'node:child_process';
+import { laneOfEntry, laneOfDoc } from './stage-gates.mjs';
+import { loadKitPolicy } from './policy.mjs';
 
 const argv = process.argv.slice(2);
 const argOf = (k) => {
@@ -44,6 +46,8 @@ const STAGED = stagedArg
   : gitOut(ROOT, ['diff', '--cached', '--name-only', '--diff-filter=ACMR']).split(/\r?\n/).filter(Boolean);
 
 const isExperiment = /^experiment\//.test(BRANCH);
+// 泳道协议锚（单源 policy.mjs）：无 kit.json 的测试夹具回落 v1（无键=双字段协议从未生效，单字段判）
+const RISK_LEVEL_SINCE = loadKitPolicy(ROOT).riskLevelSince;
 
 // frontmatter 读取（CRLF 容忍；口径同 check-loop fmGet：--- 包夹、键行前缀匹配）
 const fmOf = (file) => {
@@ -88,7 +92,10 @@ const loadPatterns = () => {
   return pats;
 };
 
-// 活跃入口收集（incident≡intent 等价；日期键 intent=日期 / incident=发现）
+// 活跃入口收集（incident≡intent 等价；日期键 intent=日期 / incident=发现）。
+// 泳道单源（2026-10-02 caliber-convergence 方案 C 分歧双严）：intent 走 laneOfEntry（双字段三态，
+// 协议锚 policy.riskLevelSince），其余走 laneOfDoc（级别单字段）——suspect（缺失/非法/分歧）不计
+// high（不作豁免依据）、计入拦截集（消息按 suspect 给「两字段对齐」指引）。
 const ACTIVE = {
   intent: new Set(['draft', 'approved']),
   incident: new Set(['open', 'fixed']),
@@ -102,7 +109,10 @@ const collectActive = () => {
       if (!f.endsWith('.md') || f === '_TEMPLATE.md') continue;
       const fm = fmOf(path.join(dirPath, f));
       if (!ACTIVE[kind].has(fm['状态'] || '')) continue;
-      out.push({ rel: `workflow/${dir}/${f}`, base: f.replace(/\.md$/, ''), level: fm['级别'] || '', date: fm[dateKey] || '', kind });
+      const lane = kind === 'intent'
+        ? laneOfEntry(fm['级别'] || '', fm['risk_level'] || '', RISK_LEVEL_SINCE, fm['日期'] || '')
+        : laneOfDoc(fm['级别'] || '');
+      out.push({ rel: `workflow/${dir}/${f}`, base: f.replace(/\.md$/, ''), level: fm['级别'] || '', risk: fm['risk_level'] || '', lane, date: fm[dateKey] || '', kind });
     }
   }
   return out;
@@ -116,16 +126,19 @@ const patterns = loadPatterns();
 const hits = patterns.length ? STAGED.filter((p) => patterns.some((re) => re.test(p))) : [];
 if (hits.length) {
   const active = collectActive();
-  const hasHigh = active.some((e) => e.level === 'L2' || e.level === 'L3');
+  const hasHigh = active.some((e) => e.lane === 'high');
   if (!hasHigh) {
-    const low = active.filter((e) => e.level !== 'L2' && e.level !== 'L3');
+    const low = active.filter((e) => e.lane !== 'high'); // low + suspect 均拦（suspect 不作豁免依据）
     if (low.length) {
       const newest = [...low].sort((a, b) => (b.date || '').localeCompare(a.date || '') || b.rel.localeCompare(a.rel))[0];
+      const fixVerb = newest.lane === 'suspect'
+        ? '① 对齐该入口「级别」与「risk_level」两字段至一致的 L2/L3（fill-intent 双写口径；现两值缺失/非法/分歧）并补同名 spec（.agents/commands/design.md）'
+        : '① 升级该入口「级别」与「risk_level」两字段至 L2/L3 并补同名 spec（.agents/commands/design.md）';
       const text = [
-        `[触达面判低] 暂存命中 L2 触达面，但活跃入口全为 L0/L1（含级别缺失）：`,
+        `[触达面判低] 暂存命中 L2 触达面，但活跃入口无泳道 high（存在 low/suspect）：`,
         `  命中: ${hits.join(' ')}`,
-        `  关联入口: ${newest.rel}（${newest.level || '级别缺失'}${newest.date ? `，${newest.date}` : ''}；活跃 L0/L1 共 ${low.length} 件）`,
-        `  修法（三选一）: ① 升级该入口「级别/risk_level」至 L2/L3 并补同名 spec（.agents/commands/design.md）`,
+        `  关联入口: ${newest.rel}（级别 ${newest.level || '缺失'}/risk_level ${newest.risk || '缺失'}→ 泳道 ${newest.lane}${newest.date ? `，${newest.date}` : ''}；活跃非 high 共 ${low.length} 件）`,
+        `  修法（三选一）: ${fixVerb}`,
         `    ② 该入口已完成则关单（done）或显式放弃（superseded/cancelled）——不留活跃残留`,
         `    ③ 面清单误配则修 .agents/lane-surfaces.txt`,
       ].join('\n');

package/templates/_agents/scripts/check-lane-surface.test.mjs

@@ -133,12 +133,34 @@ const FM_L0_NEW = '状态: draft\n级别: L0\n日期: 2026-10-01\n模块: ui';
   check('incident 等价：fixed L1 算活跃低级入口 → 阻断',
     r.code === 1 && r.out.includes('[触达面判低]') && r.out.includes('incidents/2026-09-30-inc.md'), r.out);
 }
-// --- 级别缺失：按低级计（不能自证 L2+ 即拦）---
+// --- 级别缺失：suspect 拦截（方案 C：不能自证 high 即拦，消息给两字段对齐指引）---
 {
   const d = mkfix();
   base(d, { level: '', status: 'draft' });
   const r = run(d, { staged: ['templates/t.md'] });
-  check('级别缺失的活跃入口按低级计 → 阻断且消息含「级别缺失」', r.code === 1 && r.out.includes('级别缺失'), r.out);
+  check('级别缺失 → 泳道 suspect 拦断且消息含两字段对齐指引',
+    r.code === 1 && r.out.includes('suspect') && r.out.includes('对齐'), r.out);
+}
+// --- 方案 C：级别与 risk_level 分歧 → suspect 拦截（两字段协议期）---
+{
+  const d = mkfix();
+  w(d, '.agents/lane-surfaces.txt', '^templates/\n');
+  w(d, '.agents/kit.json', JSON.stringify({ policyVersion: 2 }));
+  w(d, 'workflow/intents/2026-10-02-divergent.md',
+    intent('x', '状态: approved\n级别: L2\nrisk_level: L1\n日期: 2026-10-02\n模块: pipeline'));
+  const r = run(d, { staged: ['templates/t.md'] });
+  check('分歧（L2/L1）→ suspect 拦断（不作豁免依据）',
+    r.code === 1 && r.out.includes('suspect') && r.out.includes('2026-10-02-divergent'), r.out);
+}
+// --- 方案 C：两字段一致 high → 豁免（对照）---
+{
+  const d = mkfix();
+  w(d, '.agents/lane-surfaces.txt', '^templates/\n');
+  w(d, '.agents/kit.json', JSON.stringify({ policyVersion: 2 }));
+  w(d, 'workflow/intents/2026-10-02-aligned.md',
+    intent('x', '状态: approved\n级别: L2\nrisk_level: L2\n日期: 2026-10-02\n模块: pipeline'));
+  const r = run(d, { staged: ['templates/t.md'] });
+  check('两字段一致 L2 → 豁免放行', r.code === 0 && !r.out.includes('触达面判低'), r.out);
 }
 // --- 平台边界：CRLF frontmatter ---
 {

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

@@ -0,0 +1,135 @@
+#!/usr/bin/env node
+// check-ledger-invariant — confirmations.jsonl 提交不变量（2026-10-02 ledger-ci-invariant）
+// 目的：把「台账本地可写」的伪造面从事后对质级升为机器可检出级（能力评审审计维度扣分项）。
+// 台账不可变原则：confirmations.jsonl 历史行禁删改——修正只能走追加补偿行（README 硬规则 6）。
+//
+// 模式：
+//   历史全扫（缺省，CI 机器门）：遍历台账全部提交历史（时间正序），每次变更必须以旧 blob 为
+//     **逐字节前缀**（允许纯追加；禁止删行/改行/重排）；再对最终树做行级校验（五项，见下）。
+//     blob 读取走 git 对象库（入库 LF 归一口径），不受工作树 autocrlf 影响。
+//   --staged（pre-commit 前置）：暂存 blob 必须以 HEAD blob 为逐字节前缀——提交时刻即拦重写。
+//
+// 行级校验（终树，五项）：
+//   ① ts 为 ISO 字符串且全表非降序（追加时序单调）
+//   ② fingerprint 为 64 位 hex
+//   ③ source=chat-delegated 行必有非空 quote（原话对质面）
+//   ④ doc 匹配 workflow/(intents|specs|plans|incidents)/[^/]+.md 且当前树存在
+//   ⑤ stage ∈ 合法跳转终态集（approved/done/fixed/closed/superseded/cancelled）
+//
+// 静默条件：台账不存在 / 零提交历史（装户、新仓）/ --staged 且暂存未触台账或无 HEAD 版本。
+// 已知边界：git log --follow 未用——台账自创建无重命名（单一路径取史）；克隆深度不足时仅扫可得
+//   历史（CI 侧 fetch-depth:0 兜全史，深度不足会告警声明边界，fail-open 于深度、fail-closed 于内容）。
+// 用法：node check-ledger-invariant.mjs [--root <仓库根>] [--staged]
+import { execFileSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+
+const argv = process.argv.slice(2);
+const argOf = (k) => {
+  const i = argv.indexOf(k);
+  return i >= 0 && i + 1 < argv.length ? argv[i + 1] : '';
+};
+const staged = argv.includes('--staged');
+const ROOT = argOf('--root') || (staged ? process.cwd() : execFileSync('git', ['rev-parse', '--show-toplevel'], { encoding: 'utf8' }).trim());
+const REL = '.agents/confirmations.jsonl';
+const FILE = path.join(ROOT, REL);
+const VALID_STAGES = new Set(['approved', 'done', 'fixed', 'closed', 'superseded', 'cancelled',
+  'revert-draft', 'revert-open']); // 回退注记行（check-loop :822 认可；fingerprint 恒 n/a）
+
+const git = (args, opts = {}) => execFileSync('git', args, { cwd: ROOT, encoding: 'buffer', maxBuffer: 64 * 1024 * 1024, ...opts });
+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) {
+  const stagedHit = gitText(['-c', 'core.quotepath=off', 'diff', '--cached', '--name-only']).split(/\r?\n/).includes(REL);
+  if (!stagedHit) process.exit(0);
+  const headExists = (() => { try { gitText(['rev-parse', '--verify', '--quiet', `HEAD:${REL}`]); return true; } catch { return false; } })();
+  if (!headExists) process.exit(0); // 首次入库：无 HEAD 基线，历史全扫后续覆盖
+  let head, cur;
+  try {
+    head = blobOf(`HEAD:${REL}`);
+    cur = blobOf(`:${REL}`); // 暂存区
+  } catch {
+    process.exit(0); // 对象读取异常（如极端并发）交由 CI 全扫兜底
+  }
+  if (!cur.subarray(0, head.length).equals(head)) {
+    let off = 0;
+    while (off < Math.min(head.length, cur.length) && head[off] === cur[off]) off++;
+    problems.push(`- [台账重写] 暂存内容不是 HEAD 的前缀扩展（首异偏移 ${off}，HEAD ${head.length}B → 暂存 ${cur.length}B）`);
+    console.error('台账不可变（--staged）— BLOCK:\n' + problems.join('\n'));
+    console.error('  修法：台账历史行禁删改——误写走追加补偿行（node .agents/scripts/confirm-doc.mjs ...）；确需撤销历史提交请 git revert 后重新追加');
+    process.exit(1);
+  }
+  process.exit(0);
+}
+
+// ---- 历史全扫（缺省）----
+if (!fs.existsSync(FILE)) process.exit(0); // 装户/新仓无台账面
+let shas;
+try {
+  shas = gitText(['log', '--format=%H', '--reverse', '--', REL]).split(/\s+/).filter(Boolean);
+} catch {
+  process.exit(0); // 非仓库或文件未入库（测试夹具）
+}
+if (!shas.length) process.exit(0);
+
+let prev = null;
+let prevSha = null;
+for (const sha of shas) {
+  let cur;
+  // 删除提交不是静默边界（复核 P2 收口）：台账在 append-only 世界里永不应删除——任一历史提交删除
+  // 台账即 hard fail（否则「删除→次提交重加」会把重加 blob 当新基线绕过前缀判据）。
+  try { cur = blobOf(`${sha}:${REL}`); } catch {
+    problems.push(`- [台账删除] ${sha.slice(0, 10)}：该提交删除了 confirmations.jsonl（append-only 世界禁删文件）`);
+    prev = null; // 后续重加无基线可比，仅受行级校验约束
+    continue;
+  }
+  if (prev !== null && !cur.subarray(0, prev.length).equals(prev)) {
+    let off = 0;
+    while (off < Math.min(prev.length, cur.length) && prev[off] === cur[off]) off++;
+    const removed = prev.length > cur.length;
+    problems.push(`- [前缀破坏] ${sha.slice(0, 10)}（前承 ${prevSha.slice(0, 10)}）：历史内容被${removed ? `删减 ${prev.length - cur.length}B` : `改写（首异偏移 ${off}，旧 ${prev.length}B → 新 ${cur.length}B）`}`);
+  }
+  prev = cur;
+  prevSha = sha;
+}
+
+// ---- 行级校验（终树）----
+let rows = [];
+try {
+  rows = fs.readFileSync(FILE, 'utf8').split(/\r?\n/).filter((l) => l.trim()).map((l) => { try { return JSON.parse(l); } catch { return null; } });
+} catch { /* 上面 existsSync 已兜 */ }
+let prevTs = '';
+rows.forEach((e, idx) => {
+  const at = `第 ${idx + 1} 行`;
+  if (!e || typeof e !== 'object') { problems.push(`- [行级] ${at}：非 JSON 对象行`); return; }
+  if (typeof e.ts !== 'string' || Number.isNaN(Date.parse(e.ts))) problems.push(`- [行级] ${at}：ts 非 ISO 字符串`);
+  else {
+    if (prevTs && e.ts < prevTs) problems.push(`- [行级] ${at}：ts ${e.ts} 早于前行 ${prevTs}（追加时序非单调）`);
+    prevTs = e.ts;
+  }
+  const isRevertNote = typeof e.stage === 'string' && e.stage.startsWith('revert-');
+  if (isRevertNote) {
+    if (e.fingerprint !== 'n/a') problems.push(`- [行级] ${at}：回退注记行 fingerprint 恒为「n/a」`);
+  } else if (typeof e.fingerprint !== 'string' || !/^[0-9a-f]{64}$/.test(e.fingerprint)) {
+    problems.push(`- [行级] ${at}：fingerprint 非 64 位 hex`);
+  }
+  if (e.source === 'chat-delegated' && !(typeof e.quote === 'string' && e.quote.trim())) problems.push(`- [行级] ${at}：chat-delegated 行缺非空 quote（原话对质面）`);
+  if (typeof e.doc !== 'string' || !/^workflow\/(intents|specs|plans|incidents)\/[^/]+\.md$/.test(e.doc)) {
+    problems.push(`- [行级] ${at}：doc 路径不在 workflow 四目录协议内`);
+  } else if (!fs.existsSync(path.join(ROOT, e.doc))) {
+    problems.push(`- [行级] ${at}：doc ${e.doc} 在当前树不存在`);
+  }
+  if (!VALID_STAGES.has(e.stage)) problems.push(`- [行级] ${at}：stage「${e.stage || '缺失'}」不在合法跳转终态集`);
+});
+
+if (problems.length) {
+  console.error(`台账不可变（历史全扫）— HARD-BLOCK:\n\n${problems.join('\n')}\n`);
+  console.error('  修法：台账历史行禁删改（append-only 前缀不变量）——误写只能追加补偿行；确需撤销历史提交请 git revert 后重新追加。篡改属审计事件，保留现场联系仓库所有者。');
+  process.exit(1);
+}
+process.exit(0);

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

@@ -0,0 +1,161 @@
+#!/usr/bin/env node
+// check-ledger-invariant.test.mjs — 台账提交不变量 fixture 套件（2026-10-02 ledger-ci-invariant）
+// 真 git 仓注入：合法追加放行 / 六类篡改与行级违例检出 / --staged 双态 / 首次入库与空台账静默。
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+
+const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
+const SCRIPT = path.join(SCRIPT_DIR, 'check-ledger-invariant.mjs');
+
+let pass = 0;
+let fail = 0;
+const check = (desc, cond, detail = '') => {
+  if (cond) { pass++; console.log(`PASS  ${desc}`); }
+  else { fail++; console.log(`FAIL  ${desc}${detail ? '\n      ' + detail : ''}`); }
+};
+
+const HEX = 'a'.repeat(64);
+const row = (o = {}) => JSON.stringify({
+  ts: '2026-10-02T00:00:00.000Z', doc: 'workflow/intents/demo.md', stage: 'approved',
+  fingerprint: HEX, prev: 'draft', source: 'chat-delegated', quote: '确认', ...o,
+});
+
+const G = (root, args) => spawnSync('git', args, { cwd: root, encoding: 'utf8' });
+const commitAll = (root, msg) => { G(root, ['add', '-A']); G(root, ['-c', 'user.email=t@t', '-c', 'user.name=t', 'commit', '-qm', msg]); };
+const run = (root, args = []) => {
+  const r = spawnSync(process.execPath, [SCRIPT, '--root', root, ...args], { encoding: 'utf8' });
+  return { code: r.status, out: `${r.stdout || ''}${r.stderr || ''}` };
+};
+
+// mkrepo：临时真仓（workflow/intents/demo.md 在树 + 台账首行已提交）
+const mkrepo = (firstRow = row()) => {
+  const d = fs.mkdtempSync(path.join(os.tmpdir(), 'ledger-inv-test-'));
+  fs.mkdirSync(path.join(d, 'workflow', 'intents'), { recursive: true });
+  fs.mkdirSync(path.join(d, '.agents'), { recursive: true });
+  fs.writeFileSync(path.join(d, 'workflow', 'intents', 'demo.md'), '---\n状态: approved\n级别: L1\n日期: 2026-10-02\n模块: pipeline\n---\n# I\n');
+  fs.writeFileSync(path.join(d, '.agents', 'confirmations.jsonl'), firstRow + '\n');
+  G(d, ['init', '-q']);
+  G(d, ['config', 'user.email', 't@t']);
+  G(d, ['config', 'user.name', 't']);
+  commitAll(d, 'base ledger');
+  return d;
+};
+const ledPath = (d) => path.join(d, '.agents', 'confirmations.jsonl');
+const append = (d, line) => fs.appendFileSync(ledPath(d), line + '\n');
+
+// S1：合法追加 ×2 → 历史全扫过
+{
+  const d = mkrepo();
+  append(d, row({ ts: '2026-10-02T01:00:00.000Z', stage: 'done' }));
+  commitAll(d, 'append 2nd');
+  const r = run(d);
+  check('S1 合法追加两次 → 历史全扫 exit 0', r.code === 0, r.out);
+}
+// S2：删历史行 → 前缀破坏拦
+{
+  const d = mkrepo();
+  append(d, row({ ts: '2026-10-02T01:00:00.000Z', stage: 'done' }));
+  commitAll(d, 'append');
+  fs.writeFileSync(ledPath(d), row({ ts: '2026-10-02T01:00:00.000Z', stage: 'done' }) + '\n'); // 删首行
+  commitAll(d, 'drop first row');
+  const r = run(d);
+  check('S2 删历史行 → 前缀破坏 exit 1', r.code === 1 && r.out.includes('前缀破坏') && r.out.includes('删减'), r.out);
+}
+// S3：改历史行内容 → 拦
+{
+  const d = mkrepo();
+  append(d, row({ ts: '2026-10-02T01:00:00.000Z', stage: 'done' }));
+  commitAll(d, 'append');
+  const lines = fs.readFileSync(ledPath(d), 'utf8').split('\n').filter(Boolean);
+  lines[0] = lines[0].replace('确认', '改成别的'); // 改首行 quote
+  fs.writeFileSync(ledPath(d), lines.join('\n') + '\n');
+  commitAll(d, 'rewrite first line');
+  const r = run(d);
+  check('S3 改历史行 → 前缀破坏 exit 1（首异偏移）', r.code === 1 && r.out.includes('改写') && r.out.includes('首异偏移'), r.out);
+}
+// S4：非前缀改写（截断+异内容）→ 拦
+{
+  const d = mkrepo();
+  append(d, row({ ts: '2026-10-02T01:00:00.000Z', stage: 'done' }));
+  commitAll(d, 'append');
+  fs.writeFileSync(ledPath(d), row({ ts: '2027-01-01T00:00:00.000Z', quote: '另起炉灶' }) + '\n');
+  commitAll(d, 'replace all');
+  const r = run(d);
+  check('S4 非前缀整体改写 → exit 1', r.code === 1 && r.out.includes('前缀破坏'), r.out);
+}
+// S5：ts 乱序追加 → 行级拦
+{
+  const d = mkrepo();
+  append(d, row({ ts: '2026-10-01T00:00:00.000Z', stage: 'done' })); // 早于首行
+  commitAll(d, 'append out-of-order');
+  const r = run(d);
+  check('S5 ts 非单调 → 行级 exit 1', r.code === 1 && r.out.includes('非单调'), r.out);
+}
+// S6：伪指纹（非 64-hex）→ 行级拦
+{
+  const d = mkrepo();
+  append(d, row({ ts: '2026-10-02T01:00:00.000Z', stage: 'done', fingerprint: 'zzz' }));
+  commitAll(d, 'append bad fp');
+  const r = run(d);
+  check('S6 fingerprint 非 64-hex → 行级 exit 1', r.code === 1 && r.out.includes('64 位 hex'), r.out);
+}
+// S7：chat-delegated 空 quote → 行级拦
+{
+  const d = mkrepo();
+  append(d, row({ ts: '2026-10-02T01:00:00.000Z', stage: 'done', quote: '' }));
+  commitAll(d, 'append empty quote');
+  const r = run(d);
+  check('S7 chat-delegated 空 quote → 行级 exit 1', r.code === 1 && r.out.includes('quote'), r.out);
+}
+// S8：doc 路径在树中不存在 → 行级拦
+{
+  const d = mkrepo();
+  append(d, row({ ts: '2026-10-02T01:00:00.000Z', stage: 'done', doc: 'workflow/intents/ghost.md' }));
+  commitAll(d, 'append ghost doc');
+  const r = run(d);
+  check('S8 doc 当前树不存在 → 行级 exit 1', r.code === 1 && r.out.includes('不存在'), r.out);
+}
+// S9：--staged 合法追加 → 过
+{
+  const d = mkrepo();
+  append(d, row({ ts: '2026-10-02T01:00:00.000Z', stage: 'done' }));
+  G(d, ['add', '-A']);
+  const r = run(d, ['--staged']);
+  check('S9 --staged 合法追加 → exit 0', r.code === 0, r.out);
+}
+// S10：--staged 删历史行 → 拦
+{
+  const d = mkrepo();
+  append(d, row({ ts: '2026-10-02T01:00:00.000Z', stage: 'done' }));
+  commitAll(d, 'append');
+  fs.writeFileSync(ledPath(d), row({ ts: '2026-10-02T01:00:00.000Z', stage: 'done' }) + '\n');
+  G(d, ['add', '-A']);
+  const r = run(d, ['--staged']);
+  check('S10 --staged 删历史行 → exit 1', r.code === 1 && r.out.includes('台账重写'), r.out);
+}
+// S11：首次入库（无 HEAD 基线）与空台账 → 静默过
+{
+  const d = fs.mkdtempSync(path.join(os.tmpdir(), 'ledger-inv-fresh-'));
+  fs.mkdirSync(path.join(d, '.agents'), { recursive: true });
+  G(d, ['init', '-q']);
+  G(d, ['config', 'user.email', 't@t']);
+  G(d, ['config', 'user.name', 't']);
+  fs.writeFileSync(ledPath(d), row() + '\n');
+  G(d, ['add', '-A']);
+  const rs = run(d, ['--staged']);
+  const rh = run(d);
+  check('S11 首次入库（staged 无 HEAD 基线 / 历史零提交）均静默过', rs.code === 0 && rh.code === 0, `staged=${rs.out} hist=${rh.out}`);
+  fs.rmSync(d, { recursive: true, force: true });
+}
+// S12：回退注记行（revert-draft / fingerprint n/a）合法放行
+{
+  const d = mkrepo(row({ ts: '2026-10-02T00:00:00.000Z', stage: 'revert-draft', fingerprint: 'n/a', prev: 'approved' }));
+  const r = run(d);
+  check('S12 回退注记行（n/a 指纹）→ 历史全扫过', r.code === 0, r.out);
+}
+
+console.log(`\n${fail ? `❌ ${fail} failed` : '✅ all passed'}（${pass} passed）`);
+process.exit(fail ? 1 : 0);