agentic-flow-kit 0.8.0 → 0.9.1

package/templates/_agents/commands/source-sync-check.md

@@ -76,7 +76,7 @@ flow-kit doctor                                     # 10/0/0
 - 不改 managed 台账跟踪逻辑（`sync.mjs` 不动）
 - 不改 owned 漂移校验（`doctor.mjs` §6.6 不动）
 - 不反向同步——装副本独自有文件（如 hooks/commit-check.config.json）可能是装户配置，不应被删
-- 不检查 4 宿主 `modules/hosts/` 薄适配漂移（那是 `flow-kit sync-hosts` 范围）
+- 不检查注册表内宿主 `modules/hosts/` 薄适配漂移（那是 `flow-kit sync-hosts` 范围）
 
 ## 当前已识别的真实漂点（首次实测，2026-09-25）
 

package/templates/_agents/commands/test.md

@@ -74,10 +74,12 @@ 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
-**确认落态唯一入口**（2026-09-27 起）：用户在终端跑 `node .agents/scripts/confirm-doc.mjs <path>` 键入「可以」（draft→approved / approved→done；对话内明确确认后 AI 可 `--delegated "<原话>"` 代录，台账如实记 source/quote——**逐件调用 + 逐件原话**（一次一份，build.md「逐件确认」口径；多份并录被 confirm-doc 拒绝。--delegated 每次传当次实际放行的措辞，不复用同句——复用同句使台账 quote 失去分辨力，且相邻同 quote 连跑会触发并录告警））。check-loop 15 如实口径：缺记录/指纹不配对 → hard-block 拦截；伪造台账本地不可机器防，留痕供事后对质；done 内容绑定（2026-09-28 起）——**关单编辑（勾验/回填确认结果）先于 done 确认、confirm-doc 是最后一次写入**，此后修订走 superseded 或新 intent。
+  - 新需求：逐条勾验入口 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 内容绑定）
   - **同族收尾**：入口置终态时，同名 plan 一并置 `done`（spec 见上条），不留 `approved` 孤儿（口径同看板「入口已 done，本 plan 未终态」告警）
   - 主智能体自做的 L1+ 新需求在 `workflow/delegations.md`「自做任务结果表」记一行（修复类不重复记）
+  - **委派快照回写**：关单后若 `workflow/delegations.md` §月度聚合快照缺当月行或 doctor §6.5 报陈旧 → 跑 `node .agents/scripts/agg-delegations.cjs` 并回贴当月快照行
 - L1：本阶段结束，不进 deploy
 - L2/L3：仅当用户确认要上 prod 时进 `.agents/commands/deploy.md`

package/templates/_agents/hooks/commit-check.cjs

@@ -1,7 +1,7 @@
 // commit-check: git commit 前置验证（agentic-flow-kit 通用版）
 // 1) 敏感信息扫描（暂存区新增行含疑似密钥 -> BLOCK）
-// 2) 条件构建验证（按 .agents/hooks/commit-check.config.json 的 builds 配置；--full 全跑）
-// 3) 质量检测（config.checks：lint / 类型检查 / vet 等秒级确定性检查；--full 全跑）
+// 2) 条件构建验证（按 .agents/hooks/commit-check.config.json 的 builds 配置；--full 不做 ext/prefix 裁剪，仍尊重 when）
+// 3) 质量检测（config.checks：lint / 类型检查 / vet 等秒级确定性检查；--full 不做 ext/prefix 裁剪，仍尊重 when）
 // config 由 flow-kit init 按技术栈生成初值，项目可自行增改；缺失或无 builds/checks 时跳过对应段。
 // 配置示例（.agents/hooks/commit-check.config.json）：
 //   {
@@ -23,8 +23,11 @@
 //   - 只有 ext：按扩展名全局触发（跨目录，适合语言型触发——仓库里该扩展名基本只属于该构建）；
 //   - 只有 prefix：该前缀下任何文件触发（目录型触发——如 monorepo 子包，仓库其他位置的相同扩展名不触发）；
 //   - 两者同配为 OR 并集而非 AND 交集——要「前缀内的特定扩展名」请只配 prefix（目录内文档变更多跑一次构建，方向安全）。
-// checks.when：路径数组，任一存在才启用（元素支持尾部 * 一层通配，如 "*.sln"）——
-//   没有对应配置的项目自动跳过并提示，不 fail-closed 误拦；无 when 字段 = 无条件启用。
+// when（builds 与 checks 共用）：数组任一满足才启用，无 when 字段 = 无条件启用。
+//   - 路径或尾部 * 一层通配（如 "*.sln"）：相对仓库根做存在性判断；
+//   - pkg:<点分路径>（如 pkg:scripts.build）：读该项 cwd（缺省仓库根）的 package.json，
+//     沿路径取值，非空字符串才算满足。
+//   没有对应配置的项目自动跳过并提示，不 fail-closed 误拦。--full 同样尊重 when。
 const { execSync } = require('child_process');
 const path = require('path');
 const fs = require('fs');
@@ -78,17 +81,50 @@ if (hits.length) {
 
 // --- 2) 条件构建验证 ---
 // --full：合并提交（pre-merge-commit / 冲突解决后手动 commit）使用——合并结果是没人验证过的新状态，
-// 按 ext/prefix 裁剪可能漏掉需要重跑的一侧，故不做条件选择、全部 builds 都跑。
+// 按 ext/prefix 裁剪可能漏掉需要重跑的一侧，故不做路径裁剪。when 仍生效：没有对应能力就不跑。
 // 引擎自身文件（.agents/、.githooks/）不参与构建匹配——工作流引擎不是项目构建产物。
 const FULL = process.argv.includes('--full');
 const stagedForBuild = staged.filter(f => !f.startsWith('.agents/') && !f.startsWith('.githooks/'));
-let ranAny = false;
+
+// whenSatisfied：任一谓词满足即启用。pkg: 读 cwd 下的 package.json；其余谓词相对仓库根。
+function whenItem(w, cwd) {
+  if (typeof w === 'string' && w.startsWith('pkg:')) {
+    const keys = w.slice(4).split('.').filter(Boolean);
+    if (!keys.length) return false;
+    const pkgPath = path.join(cwd || '.', 'package.json');
+    let pkg;
+    try { pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8')); } catch (e) { return false; }
+    let cur = pkg;
+    for (const k of keys) {
+      if (cur == null || typeof cur !== 'object' || !Object.prototype.hasOwnProperty.call(cur, k)) return false;
+      cur = cur[k];
+    }
+    return typeof cur === 'string' && cur.trim() !== '';
+  }
+  const star = String(w).indexOf('*');
+  if (star < 0) return fs.existsSync(w);
+  const suffix = w.slice(star + 1);
+  const dir = path.dirname(w.slice(0, star)) || '.';
+  try { return fs.readdirSync(dir).some((f) => f.endsWith(suffix)); } catch (e) { return false; }
+}
+function whenSatisfied(when, cwd) {
+  if (!when) return true;
+  const list = Array.isArray(when) ? when : [when];
+  return list.some((w) => whenItem(w, cwd));
+}
+function skipWhen(kind, item) {
+  const shown = Array.isArray(item.when) ? item.when.join(' / ') : item.when;
+  console.log(`SKIP: ${item.name}（未找到 ${shown}，跳过${kind}——配置好后自动启用）`);
+}
+
+let consideredBuild = false;
 for (const b of (config.builds || [])) {
   if (!b || !b.command) continue;
   const exts = Array.isArray(b.ext) ? b.ext : [];
   const match = FULL || stagedForBuild.some(f => exts.some(e => f.endsWith(e)) || (b.prefix ? f.startsWith(b.prefix) : false));
   if (!match) continue;
-  ranAny = true;
+  consideredBuild = true;
+  if (!whenSatisfied(b.when, b.cwd)) { skipWhen('构建', b); continue; }
   const r = sh(b.command, b.cwd);
   if (!r.ok) {
     if (b.lockPattern && new RegExp(b.lockPattern).test(r.out)) {
@@ -101,25 +137,13 @@ for (const b of (config.builds || [])) {
   }
   console.log(`OK: ${b.name} 构建通过（${b.command}）`);
 }
-if (!ranAny) {
+if (!consideredBuild) {
   console.log(config.builds && config.builds.length
     ? 'SKIP: 无匹配的源码变更，跳过构建验证'
     : 'SKIP: 未配置 builds（.agents/hooks/commit-check.config.json），跳过构建验证');
 }
 
 // --- 3) 质量检测（checks：lint / 类型检查 / vet 等秒级确定性检查；测试不放这里——关单在 test.md 阶段门） ---
-// whenSatisfied：任一路径存在即启用；元素支持尾部 * 一层通配（如 *.sln = 仓库根存在 .sln 结尾文件）
-function whenSatisfied(when) {
-  if (!when) return true;
-  const list = Array.isArray(when) ? when : [when];
-  return list.some((w) => {
-    const star = w.indexOf('*');
-    if (star < 0) return fs.existsSync(w);
-    const suffix = w.slice(star + 1);
-    const dir = path.dirname(w.slice(0, star)) || '.';
-    try { return fs.readdirSync(dir).some((f) => f.endsWith(suffix)); } catch (e) { return false; }
-  });
-}
 let ranCheck = false;
 for (const c of (config.checks || [])) {
   if (!c || !c.command) continue;
@@ -127,10 +151,7 @@ for (const c of (config.checks || [])) {
   const match = FULL || stagedForBuild.some(f => exts.some(e => f.endsWith(e)) || (c.prefix ? f.startsWith(c.prefix) : false));
   if (!match) continue;
   ranCheck = true;
-  if (!whenSatisfied(c.when)) {
-    console.log(`SKIP: ${c.name}（未找到 ${Array.isArray(c.when) ? c.when.join(' / ') : c.when}，跳过质量检查——配置好后自动启用）`);
-    continue;
-  }
+  if (!whenSatisfied(c.when, c.cwd)) { skipWhen('质量检查', c); continue; }
   const r = sh(c.command, c.cwd);
   if (!r.ok) {
     console.log(`BLOCK: ${c.name} 质量检查未通过（${c.command}）\n` + r.out.slice(0, 1200));

package/templates/_agents/lane-surfaces.txt

@@ -0,0 +1,14 @@
+# L2 触达面清单（单源：本文件——check-lane-surface.mjs 检查 A 共读，pre-commit「泳道完整性」门禁）
+# 格式：每行一条 ERE（grep -E 兼容），匹配暂存文件的仓库相对路径（/ 分隔）。
+#   # 注释与空行忽略；本文件缺失或清单为空 = 检查跳过（装户无感升级）。
+#   正则语法错误行 → 门禁 fail-closed 阻断（防静默空洞，修配置后重试）。
+# 语义：命中任一模式 = 本次改动触及「一处定义、多处消费」的契约 / 规则面（L2 触达面，
+#   判据见 .agents/commands/new-task.md §级别判断）。此时须有活跃（draft/approved / open/fixed）
+#   L2/L3 入口罩着；活跃入口全为 L0/L1 会被 pre-commit「触达面判低」拦截（三选修法见门禁消息）。
+#   无任何活跃入口时仅 advisory——docs / bootstrap 豁免类改动（new-task.md §intent 豁免）不受阻。
+# 本仓默认面（引擎 / 契约面，行为承载目录——commands/roles 纯提示文本属 docs 级不列入；按项目自行改）：
+^templates/
+^\.agents/(scripts|hooks)/
+^\.githooks/
+^bin/
+^modules/

package/templates/_agents/roles/implementer.md

@@ -1,6 +1,6 @@
 # Implementer
 
-> 公共角色契约（本文件）：`.agents/roles/implementer.md`。宿主薄适配（`.opencode/` / `.trae/` / `.zcode/` 下 `agents/implementer.md`）正文段同源本文件，frontmatter 各自保留宿主特化字段（check-loop 检查项 6 按本引用校验适配层不断线）。
+> 公共角色契约（本文件）：`.agents/roles/implementer.md`。宿主薄适配（各宿主目录下 `agents/implementer.md`）正文段同源本文件，frontmatter 各自保留宿主特化字段（check-loop 检查项 6 按本引用校验适配层不断线）。
 
 ## 职责
 

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

@@ -1,6 +1,6 @@
 # Independent Reviewer
 
-> 公共角色契约（本文件）：`.agents/roles/independent-reviewer.md`。宿主薄适配（`.opencode/` / `.trae/` / `.zcode/` 下 `agents/independent-reviewer.md`）正文段同源本文件，frontmatter 各自保留宿主特化字段（check-loop 检查项 6 按本引用校验适配层不断线）。
+> 公共角色契约（本文件）：`.agents/roles/independent-reviewer.md`。宿主薄适配（各宿主目录下 `agents/independent-reviewer.md`）正文段同源本文件，frontmatter 各自保留宿主特化字段（check-loop 检查项 6 按本引用校验适配层不断线）。
 
 ## 职责
 

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

@@ -1,6 +1,6 @@
 # UI Verifier
 
-> 公共角色契约（本文件）：`.agents/roles/ui-verifier.md`。宿主薄适配（`.opencode/` / `.trae/` / `.zcode/` 下 `agents/ui-verifier.md`）正文段同源本文件，frontmatter 各自保留宿主特化字段（check-loop 检查项 6 按本引用校验适配层不断线）。
+> 公共角色契约（本文件）：`.agents/roles/ui-verifier.md`。宿主薄适配（各宿主目录下 `agents/ui-verifier.md`）正文段同源本文件，frontmatter 各自保留宿主特化字段（check-loop 检查项 6 按本引用校验适配层不断线）。
 
 ## 职责
 

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

@@ -0,0 +1,164 @@
+#!/usr/bin/env node
+// check-lane-surface.mjs — 泳道完整性门禁（pre-commit 增量；2026-10-01 drift-hardening）
+// 检查 A「触达面判低」：暂存 diff 命中项目 L2 触达面（.agents/lane-surfaces.txt，ERE 逐行；
+//   # 注释与空行忽略；文件缺失或清单为空 = 检查跳过，装户无感）时——
+//   存在活跃 L2/L3 入口 → 放行（归因歧义为已知边界：机器不猜「哪个入口在干这批改动」）；
+//   活跃入口全为 L0/L1（含级别缺失）→ hard 拦，点名最新 L0/L1 入口 + 三选修法；
+//   无任何活跃入口 → 仅 advisory（docs / bootstrap 豁免类改动的合法形态）。
+//   活跃 = intents draft/approved + incidents open/fixed（incident≡intent 等价口径）。
+//   experiment/* 分支降级 advisory（泳道哲学：PoC 免闭环纪律，转正由 pre-push 加固门兜底）。
+// 检查 B「探索标记缺失」：experiment/* 分支暂存的 workflow/intents/*.md（排除 _TEMPLATE）
+//   frontmatter 无「阶段: exploring」且无「状态: exploring」（口径同 check-loop 加固门）→ hard 拦。
+//   标记是加固门覆盖率的前提且补写零成本——advisory 免的是纪律负担，不免标记本身。
+// 判据原则（incidents/2026-09-28-batch-ledger-audit 教训）：只用一手事实——暂存文件清单、
+//   当前分支名、工作区 frontmatter 字段；不用时间戳 / 字符串相等反推过程事实。
+// 边界：git 调用一律 -c core.quotepath=off（非 ASCII 路径教训，同 check-pairing-incremental.sh）；
+//   frontmatter 读取容忍 CRLF（显式按 \r?\n 切分）；detached HEAD 分支不可判 → A 按 strict、
+//   B 跳过（沿 pairing 门先例）；配置行正则语法错误 → fail-closed（防静默空洞）。
+// 已知边界：commit-time 门禁，CI / pre-push 复跑面无对应全量检查（push 时刻无暂存 diff 一手事实，
+//   树级反推违背判据原则）——沿增量门禁 pre-commit-only 先例，声明于 spec 风险评估 R2。
+// 用法：node check-lane-surface.mjs [--root <dir>] [--branch <名>] [--staged-file <清单文件>]
+//   （--root/--branch/--staged-file 为测试注入位；缺省自 git 发现。staged-file 每行一个仓库相对路径）
+// 退出码：0 放行（含 advisory）；1 阻断（stderr 出 [标签] 消息与修法）
+import fs from 'node:fs';
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+
+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 gitOut = (cwd, gitArgs) => {
+  const r = spawnSync('git', ['-c', 'core.quotepath=off', ...gitArgs], { cwd, encoding: 'utf8' });
+  return r.status === 0 ? String(r.stdout || '') : '';
+};
+
+const ROOT = argOf('--root') || gitOut(process.cwd(), ['rev-parse', '--show-toplevel']).trim() || process.cwd();
+// detached HEAD 时 abbrev-ref 返回 'HEAD' → 不匹配 experiment/* → A strict / B 跳过
+const BRANCH = argOf('--branch') || gitOut(ROOT, ['rev-parse', '--abbrev-ref', 'HEAD']).trim();
+const stagedArg = argOf('--staged-file');
+const STAGED = stagedArg
+  ? fs.readFileSync(stagedArg, 'utf8').split(/\r?\n/).filter(Boolean)
+  : gitOut(ROOT, ['diff', '--cached', '--name-only', '--diff-filter=ACMR']).split(/\r?\n/).filter(Boolean);
+
+const isExperiment = /^experiment\//.test(BRANCH);
+
+// frontmatter 读取（CRLF 容忍；口径同 check-loop fmGet：--- 包夹、键行前缀匹配）
+const fmOf = (file) => {
+  const fm = {};
+  let lines;
+  try {
+    lines = fs.readFileSync(file, 'utf8').split(/\r?\n/);
+  } catch {
+    return fm;
+  }
+  if (!/^---\s*$/.test(lines[0] || '')) return fm;
+  for (let i = 1; i < lines.length; i++) {
+    if (/^---\s*$/.test(lines[i])) break;
+    const m = lines[i].match(/^([^:]+):\s*(.*)$/);
+    if (m) fm[m[1].trim()] = m[2].trim();
+  }
+  return fm;
+};
+
+// 触达面配置：缺失/空 → []（检查 A 跳过）；语法错误 → fail-closed
+const loadPatterns = () => {
+  const file = path.join(ROOT, '.agents', 'lane-surfaces.txt');
+  if (!fs.existsSync(file)) return [];
+  const bad = [];
+  const pats = fs.readFileSync(file, 'utf8')
+    .split(/\r?\n/)
+    .map((l) => l.trim())
+    .filter((l) => l && !l.startsWith('#'))
+    .map((l) => {
+      try {
+        return new RegExp(l);
+      } catch {
+        bad.push(l);
+        return null;
+      }
+    })
+    .filter(Boolean);
+  if (bad.length) {
+    console.error(`泳道完整性（增量）— BLOCK:\n  [面清单语法错误] .agents/lane-surfaces.txt 存在非法 ERE 行：${bad.join(' | ')}\n  修法：修正或删除该行后重试（fail-closed，防静默空洞）`);
+    process.exit(1);
+  }
+  return pats;
+};
+
+// 活跃入口收集（incident≡intent 等价；日期键 intent=日期 / incident=发现）
+const ACTIVE = {
+  intent: new Set(['draft', 'approved']),
+  incident: new Set(['open', 'fixed']),
+};
+const collectActive = () => {
+  const out = [];
+  for (const [dir, kind, dateKey] of [['intents', 'intent', '日期'], ['incidents', 'incident', '发现']]) {
+    const dirPath = path.join(ROOT, 'workflow', dir);
+    if (!fs.existsSync(dirPath)) continue;
+    for (const f of fs.readdirSync(dirPath).sort()) {
+      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 });
+    }
+  }
+  return out;
+};
+
+const blocks = [];
+const advisories = [];
+
+// --- 检查 A：触达面判低 ---
+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');
+  if (!hasHigh) {
+    const low = active.filter((e) => e.level !== 'L2' && e.level !== 'L3');
+    if (low.length) {
+      const newest = [...low].sort((a, b) => (b.date || '').localeCompare(a.date || '') || b.rel.localeCompare(a.rel))[0];
+      const text = [
+        `[触达面判低] 暂存命中 L2 触达面，但活跃入口全为 L0/L1（含级别缺失）：`,
+        `  命中: ${hits.join(' ')}`,
+        `  关联入口: ${newest.rel}（${newest.level || '级别缺失'}${newest.date ? `，${newest.date}` : ''}；活跃 L0/L1 共 ${low.length} 件）`,
+        `  修法（三选一）: ① 升级该入口「级别/risk_level」至 L2/L3 并补同名 spec（.agents/commands/design.md）`,
+        `    ② 该入口已完成则关单（done）或显式放弃（superseded/cancelled）——不留活跃残留`,
+        `    ③ 面清单误配则修 .agents/lane-surfaces.txt`,
+      ].join('\n');
+      if (isExperiment) advisories.push(`（advisory·experiment 泳道，不阻断；转正由 pre-push 加固门兜底）\n${text}`);
+      else blocks.push(text);
+    } else {
+      advisories.push(`[触达面判低]（advisory）暂存命中 L2 触达面（${hits.length} 个文件），但当前无任何活跃入口——若非 docs / bootstrap 豁免类改动（.agents/commands/new-task.md §intent 豁免），请先立入口文档`);
+    }
+  }
+}
+
+// --- 检查 B：探索标记缺失（仅 experiment/* 分支）---
+if (isExperiment) {
+  const missing = STAGED
+    .filter((p) => /^workflow\/intents\/[^/]+\.md$/.test(p) && path.basename(p) !== '_TEMPLATE.md')
+    .filter((p) => {
+      const fm = fmOf(path.join(ROOT, p));
+      return fm['阶段'] !== 'exploring' && fm['状态'] !== 'exploring';
+    });
+  if (missing.length) {
+    blocks.push([
+      `[探索标记缺失] experiment/* 分支暂存的 intent 缺「阶段: exploring」标记：`,
+      ...missing.map((p) => `  ${p}`),
+      `  修法（二选一）: ① frontmatter 补一行「阶段: exploring」（advisory 免纪律不免标记——标记是 pre-push 加固门覆盖率的前提）`,
+      `    ② 该件不属探索——换正式分支走标准泳道`,
+    ].join('\n'));
+  }
+}
+
+for (const a of advisories) console.error(`泳道完整性（增量）— advisory:\n${a}\n`);
+if (blocks.length) {
+  for (const b of blocks) console.error(`泳道完整性（增量）— BLOCK:\n${b}\n`);
+  console.error('pre-commit: 泳道完整性未通过，提交已阻止（spec: workflow/specs/2026-10-01-drift-hardening.md）');
+  process.exit(1);
+}
+process.exit(0);

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

@@ -0,0 +1,200 @@
+#!/usr/bin/env node
+// check-lane-surface.test.mjs — 泳道完整性门禁 fixture 套件（2026-10-01 drift-hardening）
+// 方法：现场构造临时根（workflow/{intents,incidents} + .agents/lane-surfaces.txt），经
+//       --root/--branch/--staged-file 三注入位 spawn 脚本，断言 exit code 与输出关键词。
+//       场景集对齐同名 spec「功能行为」表 S1-S6 + 平台边界（CRLF / 非 ASCII / detached /
+//       配置语法 / 状态活性 / incident 等价），另含 1 个 git 真仓端到端（quotepath=off 实路径）。
+// 用法：node templates/_agents/scripts/check-lane-surface.test.mjs（npm test 随跑）
+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-lane-surface.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 mkfix = () => {
+  const d = fs.mkdtempSync(path.join(os.tmpdir(), 'lane-surface-test-'));
+  for (const s of ['intents', 'incidents']) fs.mkdirSync(path.join(d, 'workflow', s), { recursive: true });
+  fs.mkdirSync(path.join(d, '.agents'), { recursive: true });
+  return d;
+};
+const w = (root, rel, content) => fs.writeFileSync(path.join(root, rel), content);
+// eol='\r\n' 时整文件按 CRLF 写（平台边界：frontmatter 读取容忍性）
+const intent = (name, fm, eol = '\n') => `---${eol}${fm}${eol}---${eol}# INTENT — ${name}${eol}`;
+const incident = (fm) => `---\n${fm}\n---\n# INCIDENT\n`;
+const run = (root, { branch = 'main', staged = [] } = {}) => {
+  const listFile = path.join(root, 'staged.txt');
+  fs.writeFileSync(listFile, staged.join('\n') + '\n');
+  const r = spawnSync(process.execPath, [SCRIPT, '--root', root, '--branch', branch, '--staged-file', listFile], { encoding: 'utf8' });
+  return { code: r.status, out: `${r.stdout || ''}${r.stderr || ''}` };
+};
+
+// 通用 fixture：面清单 + 一个活跃 L1 intent（2026-09-28）+ 可选第二个入口
+const base = (root, { level = 'L1', status = 'approved', extra = null } = {}) => {
+  w(root, '.agents/lane-surfaces.txt', '^templates/\n^\\.agents/(scripts|hooks)/\n');
+  w(root, 'workflow/intents/2026-09-28-old-l1.md', intent('x', `状态: ${status}\n级别: ${level}\n日期: 2026-09-28\n模块: pipeline`));
+  if (extra) w(root, extra[0], intent('y', extra[1]));
+};
+const FM_L0_NEW = '状态: draft\n级别: L0\n日期: 2026-10-01\n模块: ui';
+
+// --- S1：命中 + 活跃 L2 存在 → 豁免放行 ---
+{
+  const d = mkfix();
+  base(d, { level: 'L2' });
+  const r = run(d, { staged: ['templates/_agents/scripts/x.mjs'] });
+  check('S1 命中面+活跃 L2 入口 → 放行且无触达面判低输出', r.code === 0 && !r.out.includes('触达面判低'), r.out);
+}
+// --- S2：命中 + 活跃全为 L0/L1 → 阻断 ---
+{
+  const d = mkfix();
+  base(d);
+  const r = run(d, { staged: ['templates/_agents/scripts/x.mjs', 'docs/readme.md'] });
+  check('S2 命中面+仅活跃 L1 → 阻断且消息含标签/命中文件/入口名/修法',
+    r.code === 1 && r.out.includes('[触达面判低]') && r.out.includes('templates/_agents/scripts/x.mjs')
+      && r.out.includes('workflow/intents/2026-09-28-old-l1.md') && r.out.includes('修法'),
+    r.out);
+}
+// --- S2b：多个 L0/L1 活跃 → 点名最新（日期排序）---
+{
+  const d = mkfix();
+  base(d, { extra: ['workflow/intents/2026-10-01-new-l0.md', FM_L0_NEW] });
+  const r = run(d, { staged: ['templates/t.md'] });
+  check('S2b 多活跃 L0/L1 → 关联入口取最新日期件', r.code === 1 && r.out.includes('2026-10-01-new-l0') && r.out.includes('共 2 件'), r.out);
+}
+// --- S2c：experiment 分支 → 检查 A 降级 advisory ---
+{
+  const d = mkfix();
+  base(d);
+  const r = run(d, { branch: 'experiment/poc', staged: ['templates/t.md'] });
+  check('S2c experiment 分支检查 A → advisory 放行', r.code === 0 && r.out.includes('advisory·experiment'), r.out);
+}
+// --- S3：命中 + 无活跃入口 → advisory 放行（done 不算活跃）---
+{
+  const d = mkfix();
+  w(d, '.agents/lane-surfaces.txt', '^templates/\n');
+  w(d, 'workflow/intents/2026-09-01-closed.md', intent('c', '状态: done\n级别: L1\n日期: 2026-09-01\n模块: ui'));
+  const r = run(d, { staged: ['templates/t.md'] });
+  check('S3 命中+无活跃（done 不算活跃）→ advisory 放行', r.code === 0 && r.out.includes('无任何活跃入口'), r.out);
+}
+// --- S4b：experiment 分支 intent 缺标记 → 阻断；补标记放行 ---
+{
+  const d = mkfix();
+  w(d, 'workflow/intents/2026-10-01-poc.md', intent('p', '状态: draft\n级别: L1\n日期: 2026-10-01\n模块: ui'));
+  const r1 = run(d, { branch: 'experiment/poc', staged: ['workflow/intents/2026-10-01-poc.md'] });
+  check('S4b-1 experiment 分支无标记 intent → 阻断且含修法',
+    r1.code === 1 && r1.out.includes('[探索标记缺失]') && r1.out.includes('阶段: exploring'), r1.out);
+  w(d, 'workflow/intents/2026-10-01-poc.md', intent('p', '状态: draft\n级别: L1\n日期: 2026-10-01\n模块: ui\n阶段: exploring'));
+  const r2 = run(d, { branch: 'experiment/poc', staged: ['workflow/intents/2026-10-01-poc.md'] });
+  check('S4b-2 补「阶段: exploring」后放行', r2.code === 0, r2.out);
+}
+// --- S4b-c：口径同加固门——「状态: exploring」亦认 ---
+{
+  const d = mkfix();
+  w(d, 'workflow/intents/2026-10-01-poc.md', intent('p', '状态: exploring\n级别: L1\n日期: 2026-10-01\n模块: ui'));
+  const r = run(d, { branch: 'experiment/poc', staged: ['workflow/intents/2026-10-01-poc.md'] });
+  check('S4b-c 「状态: exploring」亦认（口径同加固门）', r.code === 0, r.out);
+}
+// --- S6：非 experiment 分支 → 检查 B 不触发 ---
+{
+  const d = mkfix();
+  w(d, 'workflow/intents/2026-10-01-poc.md', intent('p', '状态: draft\n级别: L1\n日期: 2026-10-01\n模块: ui'));
+  const r = run(d, { branch: 'main', staged: ['workflow/intents/2026-10-01-poc.md'] });
+  check('S6 非 experiment 分支无标记 intent → 放行（B 不触发）', r.code === 0 && !r.out.includes('探索标记缺失'), r.out);
+}
+// --- S5：配置缺失 → 检查 A 整体静默跳过（装户无感）---
+{
+  const d = mkfix();
+  w(d, 'workflow/intents/2026-09-28-l1.md', intent('x', '状态: approved\n级别: L1\n日期: 2026-09-28\n模块: ui'));
+  const r = run(d, { staged: ['templates/t.md'] });
+  check('S5 无 lane-surfaces.txt → 静默跳过', r.code === 0 && r.out.trim() === '', JSON.stringify(r.out));
+}
+// --- incident 等价：open incident L2 豁免；fixed L1 算活跃低级 ---
+{
+  const d = mkfix();
+  w(d, '.agents/lane-surfaces.txt', '^src/\n');
+  w(d, 'workflow/incidents/2026-09-30-inc.md', incident('状态: open\n级别: L2\n发现: 2026-09-30\n模块: backend'));
+  const r = run(d, { staged: ['src/a.ts'] });
+  check('incident 等价：活跃 open incident L2 → 豁免放行', r.code === 0, r.out);
+}
+{
+  const d = mkfix();
+  w(d, '.agents/lane-surfaces.txt', '^src/\n');
+  w(d, 'workflow/incidents/2026-09-30-inc.md', incident('状态: fixed\n级别: L1\n发现: 2026-09-30\n模块: backend'));
+  const r = run(d, { staged: ['src/a.ts'] });
+  check('incident 等价：fixed L1 算活跃低级入口 → 阻断',
+    r.code === 1 && r.out.includes('[触达面判低]') && r.out.includes('incidents/2026-09-30-inc.md'), r.out);
+}
+// --- 级别缺失：按低级计（不能自证 L2+ 即拦）---
+{
+  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);
+}
+// --- 平台边界：CRLF frontmatter ---
+{
+  const d = mkfix();
+  w(d, '.agents/lane-surfaces.txt', '^templates/\n');
+  w(d, 'workflow/intents/2026-09-28-crlf.md', intent('x', '状态: approved\r\n级别: L1\r\n日期: 2026-09-28\r\n模块: ui', '\r\n'));
+  const r = run(d, { staged: ['templates/t.md'] });
+  check('CRLF frontmatter 正常解析（仍阻断）', r.code === 1 && r.out.includes('2026-09-28-crlf'), r.out);
+}
+// --- 平台边界：非 ASCII 路径透传（quotepath 教训的对账面）---
+{
+  const d = mkfix();
+  w(d, '.agents/lane-surfaces.txt', '^模块/\n');
+  w(d, 'workflow/intents/2026-09-28-l1.md', intent('x', '状态: approved\n级别: L1\n日期: 2026-09-28\n模块: ui'));
+  const r = run(d, { staged: ['模块/接口契约.ts'] });
+  check('非 ASCII 暂存路径命中模式且消息原样透传', r.code === 1 && r.out.includes('模块/接口契约.ts'), r.out);
+}
+// --- 平台边界：detached HEAD（branch=HEAD）→ A strict、B 跳过 ---
+{
+  const d = mkfix();
+  base(d);
+  w(d, 'workflow/intents/2026-10-01-poc.md', intent('p', '状态: draft\n级别: L1\n日期: 2026-10-01\n模块: ui'));
+  const r = run(d, { branch: 'HEAD', staged: ['templates/t.md', 'workflow/intents/2026-10-01-poc.md'] });
+  check('detached HEAD：A 按 strict 阻断、B 不触发', r.code === 1 && r.out.includes('[触达面判低]') && !r.out.includes('探索标记缺失'), r.out);
+}
+// --- 边界：_TEMPLATE.md 排除（不算活跃入口、不触发 B）---
+{
+  const d = mkfix();
+  w(d, 'workflow/intents/_TEMPLATE.md', intent('t', '状态: draft\n级别: L1'));
+  const r = run(d, { branch: 'experiment/poc', staged: ['workflow/intents/_TEMPLATE.md'] });
+  check('_TEMPLATE.md 不触发检查 B，也不算活跃入口', r.code === 0, r.out);
+}
+// --- 配置边界：非法 ERE 行 → fail-closed ---
+{
+  const d = mkfix();
+  w(d, '.agents/lane-surfaces.txt', '^ok/\n[invalid(\n');
+  const r = run(d, { staged: ['ok/a.ts'] });
+  check('配置含非法 ERE → fail-closed 阻断并指出坏行', r.code === 1 && r.out.includes('[面清单语法错误]') && r.out.includes('[invalid('), r.out);
+}
+// --- git 真仓端到端：走生产发现路径（quotepath=off + diff --cached）---
+{
+  const d = mkfix();
+  const g = (a) => spawnSync('git', ['-c', 'core.quotepath=off', ...a], { cwd: d, encoding: 'utf8' });
+  g(['init', '-q']);
+  g(['config', 'user.email', 't@t']);
+  g(['config', 'user.name', 't']);
+  w(d, '.agents/lane-surfaces.txt', '^模块/\n');
+  w(d, 'workflow/intents/2026-09-28-l1.md', intent('x', '状态: approved\n级别: L1\n日期: 2026-09-28\n模块: ui'));
+  fs.mkdirSync(path.join(d, '模块'), { recursive: true });
+  w(d, '模块/接口契约.ts', 'export {};\n');
+  g(['add', '模块/接口契约.ts']);
+  const r = spawnSync(process.execPath, [SCRIPT, '--root', d], { cwd: d, encoding: 'utf8' });
+  check('git 端到端：真实暂存非 ASCII 路径 → 阻断且路径不转义',
+    r.status === 1 && `${r.stdout || ''}${r.stderr || ''}`.includes('模块/接口契约.ts'),
+    `${r.stdout || ''}${r.stderr || ''}`);
+}
+
+console.log(`\n${fail ? `❌ ${fail} failed` : '✅ all passed'}（${pass} passed）`);
+process.exit(fail ? 1 : 0);