agentic-flow-kit 0.8.0 → 0.9.1

package/templates/_agents/scripts/confirm-doc.test.mjs

@@ -3,6 +3,10 @@
 // 判据：① 指纹算法（CRLF 归一 / 剔指纹行防自引用 / 内容敏感） ② 跳转唯一合法性 ③ 落态只动两行
 //       ④ 台账追加 schema ⑤ 核心——非 TTY spawn（模拟 AI 调用路径）无 --delegated 必须被拒
 //       ⑥ 委托代录（--delegated）：免 TTY 落态 + 台账如实记 source/quote；空原话拒跑
+//       ⑦ 逐阶段前置门（2026-09-30 stage-gate-machine）：specs/plans 的 draft→approved 须入口（plan 另须
+//          L2/L3 时同名 spec）已确认；未过 → exit 2 + 未落盘未记账（S19-S22）
+//       ⑧ done 前置门（2026-09-30 confirm-gate-approved-history）：→done 须 git 历史已留 approved 态
+//          （先 done 后提交 / 两跳同批提交 → 拒绝）；非 git / legacy / 存量豁免声明 → 跳过（S25-S29）
 // 用法：node templates/_agents/scripts/confirm-doc.test.mjs（npm test 随跑）
 import fs from 'node:fs';
 import os from 'node:os';
@@ -21,6 +25,14 @@ const check = (desc, cond, detail = '') => {
 const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
 const CLI = path.join(SCRIPT_DIR, 'confirm-doc.mjs');
 
+// 台账读取 helper（2026-09-30 复核 P2-1）：缺失/空行 → 安全返回（[]）——防「门拒路径下台账未生成」时
+// 未捕获 ENOENT 截断后续用例（注入验证实证：原裸读在门失效时崩溃、无「合计」行）
+const readLedgerOf = (root) => {
+  const p = path.join(root, '.agents', 'confirmations.jsonl');
+  if (!fs.existsSync(p)) return [];
+  return fs.readFileSync(p, 'utf8').split('\n').filter(Boolean).map((l) => JSON.parse(l));
+};
+
 // ---- S1 指纹：CRLF 归一（同内容不同行尾同指纹）----
 {
   const lf = '---\n状态: draft\n---\n正文';
@@ -119,12 +131,16 @@ const CLI = path.join(SCRIPT_DIR, 'confirm-doc.mjs');
   const docP = path.join(root, 'workflow', 'plans');
   fs.mkdirSync(docP, { recursive: true });
   fs.writeFileSync(path.join(docP, '2026-09-27-d.md'), '---\n状态: draft\n级别: L2\n---\n# P\n');
+  // 逐阶段门夹具（2026-09-30 stage-gate-machine）：plan 批准须先有已确认入口——
+  // 入口用存量口径（日期早于 confirmDocsEffective）免台账；级别 L1 免 spec 档
+  fs.mkdirSync(path.join(root, 'workflow', 'intents'), { recursive: true });
+  fs.writeFileSync(path.join(root, 'workflow', 'intents', '2026-09-27-d.md'), '---\n状态: approved\n级别: L1\n日期: 2026-01-01\n---\n# I（S11 入口夹具）\n');
   const before = fs.readFileSync(path.join(docP, '2026-09-27-d.md'), 'utf8');
   const fpExpect = computeFingerprint(before);
   // spawnSync 无 TTY（管道 stdin）——模拟 AI 会话内委托代录调用
   const r = spawnSync(process.execPath, [CLI, 'workflow/plans/2026-09-27-d.md', '--delegated', '2选2'], { cwd: root, encoding: 'utf8' });
   const after = fs.readFileSync(path.join(docP, '2026-09-27-d.md'), 'utf8');
-  const led = fs.readFileSync(path.join(root, '.agents', 'confirmations.jsonl'), 'utf8').trim().split('\n').map((l) => JSON.parse(l));
+  const led = readLedgerOf(root);
   const j = led[led.length - 1];
   check('S11 委托代录：exit 0 + draft→approved + 指纹行 + 台账 source=chat-delegated / quote=原话 / 指纹全量与 frontmatter 前 16 位配对',
     r.status === 0 && after.includes('状态: approved') && after.includes(`确认指纹: ${fpExpect.slice(0, 16)}`)
@@ -145,7 +161,7 @@ const CLI = path.join(SCRIPT_DIR, 'confirm-doc.mjs');
   const fp2 = computeFingerprint(before);
   const r = spawnSync(process.execPath, [CLI, 'workflow/intents/2026-09-27-e.md', '--delegated', '可以'], { cwd: root, encoding: 'utf8' });
   const after = fs.readFileSync(path.join(docP, '2026-09-27-e.md'), 'utf8');
-  const led = fs.readFileSync(path.join(root, '.agents', 'confirmations.jsonl'), 'utf8').trim().split('\n').map((l) => JSON.parse(l));
+  const led = readLedgerOf(root);
   check('S12 委托第二跳：approved→done + 指纹行换新值 + 台账 stage=done / source 如实',
     r.status === 0 && after.includes('状态: done') && after.includes(`确认指纹: ${fp2.slice(0, 16)}`) && !after.includes(fp1.slice(0, 16))
       && led[led.length - 1].stage === 'done' && led[led.length - 1].source === 'chat-delegated',
@@ -178,7 +194,7 @@ const CLI = path.join(SCRIPT_DIR, 'confirm-doc.mjs');
   const fpExpect = computeFingerprint(before);
   const r = spawnSync(process.execPath, [CLI, 'workflow/incidents/2026-09-28-i.md', '--delegated', '修好了'], { cwd: root, encoding: 'utf8' });
   const after = fs.readFileSync(path.join(docP, '2026-09-28-i.md'), 'utf8');
-  const led = fs.readFileSync(path.join(root, '.agents', 'confirmations.jsonl'), 'utf8').trim().split('\n').map((l) => JSON.parse(l));
+  const led = readLedgerOf(root);
   const j = led[led.length - 1];
   check('S15 incidents 委托代录：exit 0 + open→fixed + 指纹行 + 台账 stage=fixed / prev=open',
     r.status === 0 && after.includes('状态: fixed') && after.includes(`确认指纹: ${fpExpect.slice(0, 16)}`)
@@ -198,7 +214,7 @@ const CLI = path.join(SCRIPT_DIR, 'confirm-doc.mjs');
   const fpExpect = computeFingerprint(before);
   const r = spawnSync(process.execPath, [CLI, 'workflow/intents/2026-09-28-c.md', '--to', 'cancelled', '--delegated', '不做了'], { cwd: root, encoding: 'utf8' });
   const after = fs.readFileSync(path.join(docP, '2026-09-28-c.md'), 'utf8');
-  const led = fs.readFileSync(path.join(root, '.agents', 'confirmations.jsonl'), 'utf8').trim().split('\n').map((l) => JSON.parse(l));
+  const led = readLedgerOf(root);
   const j = led[led.length - 1];
   check('S16 --to cancelled 委托代录：exit 0 + draft→cancelled + 台账 stage=cancelled / prev=draft',
     r.status === 0 && after.includes('状态: cancelled') && after.includes(`确认指纹: ${fpExpect.slice(0, 16)}`)
@@ -263,7 +279,7 @@ const CLI = path.join(SCRIPT_DIR, 'confirm-doc.mjs');
       JSON.stringify({ r1: r1.status, r2: r2.status, stderr: r2.stderr }));
     // 调用事实（2026-09-28 batch-ledger-audit）：每次进程调用 **一个** batch；两次独立调用 batch **不同**，
     // 各自 seq=1 / of=1——这是并录审计「逐件 vs 并录」的判别基础（复核 P2-2：plan 要求覆盖此面）
-    const led2 = fs.readFileSync(path.join(root, '.agents', 'confirmations.jsonl'), 'utf8').trim().split('\n').map((l) => JSON.parse(l));
+    const led2 = readLedgerOf(root);
     const [e1, e2] = led2.slice(-2);
     check('S18b 两次独立调用各生成独立 batch（不同批、各自 seq=1/of=1）',
       e1.batch !== e2.batch && e1.seq === 1 && e2.seq === 1 && e1.of === 1 && e2.of === 1,
@@ -275,7 +291,9 @@ const CLI = path.join(SCRIPT_DIR, 'confirm-doc.mjs');
     // 该路径仅 TTY 可达（delegated 已被入口限为 1 份），故注入两个**仅测试用**逃生门：
     //   CONFIRM_DOC_TEST_TTY=1      —— 放行 isTTY 判定（本环境无 TTY）
     //   CONFIRM_DOC_TEST_ANSWERS    —— 按序注入问答应答（见下「为什么不能用管道 stdin」）
-    // 两者均不改动任何落态/记账语义。
+    //   NODE_ENV=test               —— TTY 逃生门双条件的第二键（2026-09-28 check16-inline-debt：
+    //                                 单变量可被生产会话顺手设置绕过 TTY 门，收紧为双条件）
+    // 三者均不改动任何落态/记账语义。
     //
     // **为什么不能用 spawnSync 的 input 管道（2026-09-28 更正）**：此前本用例用 `input:'可以\n可以\n'`
     // 并断言「首份」了事，注释把根因误记为「readline 对第二份提问会 unsettled / 管道输入不被逐次消费」。
@@ -285,9 +303,9 @@ const CLI = path.join(SCRIPT_DIR, 'confirm-doc.mjs');
     const root = mk2docs();
     const r = spawnSync(process.execPath, [CLI, 'workflow/intents/2026-09-27-s.md', 'workflow/plans/2026-09-27-s.md'], {
       cwd: root, encoding: 'utf8',
-      env: { ...process.env, CONFIRM_DOC_TEST_TTY: '1', CONFIRM_DOC_TEST_ANSWERS: '可以,可以' },
+      env: { ...process.env, CONFIRM_DOC_TEST_TTY: '1', CONFIRM_DOC_TEST_ANSWERS: '可以,可以', NODE_ENV: 'test' },
     });
-    const ledN = fs.readFileSync(path.join(root, '.agents', 'confirmations.jsonl'), 'utf8').trim().split('\n').map((l) => JSON.parse(l));
+    const ledN = readLedgerOf(root);
     const stI = fs.readFileSync(path.join(root, 'workflow', 'intents', '2026-09-27-s.md'), 'utf8');
     const stP = fs.readFileSync(path.join(root, 'workflow', 'plans', '2026-09-27-s.md'), 'utf8');
     check('S18c 单次调用落 2 份（TTY 多文档）端到端 → batch 相同 / seq 1,2 / of 均=2 / 两份都落态',
@@ -306,15 +324,349 @@ const CLI = path.join(SCRIPT_DIR, 'confirm-doc.mjs');
     const root = mk2docs();
     const r = spawnSync(process.execPath, [CLI, 'workflow/intents/2026-09-27-s.md', 'workflow/plans/2026-09-27-s.md'], {
       cwd: root, encoding: 'utf8',
-      env: { ...process.env, CONFIRM_DOC_TEST_TTY: '1', CONFIRM_DOC_TEST_ANSWERS: '可以' }, // 只给一份应答
+      env: { ...process.env, CONFIRM_DOC_TEST_TTY: '1', CONFIRM_DOC_TEST_ANSWERS: '可以', NODE_ENV: 'test' }, // 只给一份应答
     });
-    const led1 = fs.readFileSync(path.join(root, '.agents', 'confirmations.jsonl'), 'utf8').trim().split('\n').map((l) => JSON.parse(l));
+    const led1 = readLedgerOf(root);
     const stP1 = fs.readFileSync(path.join(root, 'workflow', 'plans', '2026-09-27-s.md'), 'utf8');
     check('S18d 注入应答不足 → 仅首份落态，次份按跳过处理（不落态不记账）',
       led1.length === 1 && led1[0].seq === 1 && led1[0].of === 2 && stP1.includes('状态: draft'),
       JSON.stringify({ status: r.status, ledger: led1 }));
     fs.rmSync(root, { recursive: true, force: true });
   }
+  {
+    // 【T3 双条件】仅设 CONFIRM_DOC_TEST_TTY=1 而未设 NODE_ENV=test → 逃生门不生效，仍按非 TTY 拒绝
+    // （2026-09-28 check16-inline-debt：单变量可被生产会话顺手设置绕过 TTY 门，收紧为双条件——
+    //   本用例钉住「缺第二键即不放行」，与 S18c/S18d 的「双键齐 → 放行」构成双向覆盖）
+    const root = mk2docs();
+    const env1 = { ...process.env, CONFIRM_DOC_TEST_TTY: '1', CONFIRM_DOC_TEST_ANSWERS: '可以' };
+    delete env1.NODE_ENV; // 显式剔除——防宿主环境恰好携带 NODE_ENV 时用例失真
+    const r = spawnSync(process.execPath, [CLI, 'workflow/intents/2026-09-27-s.md'], {
+      cwd: root, encoding: 'utf8', env: env1,
+    });
+    const noLedger = !fs.existsSync(path.join(root, '.agents', 'confirmations.jsonl'));
+    const afterI = fs.readFileSync(path.join(root, 'workflow', 'intents', '2026-09-27-s.md'), 'utf8');
+    check('S18e 仅 CONFIRM_DOC_TEST_TTY=1 无 NODE_ENV=test → 仍非 TTY 拒绝（exit 1 + 零台账 + 文档未动）',
+      r.status === 1 && /不可代确认/.test(r.stderr) && noLedger && afterI.includes('状态: draft'),
+      JSON.stringify({ status: r.status, stderr: String(r.stderr).slice(0, 200) }));
+    fs.rmSync(root, { recursive: true, force: true });
+  }
+}
+
+// ---- S19【逐阶段门】spec 无同名入口 → 拒绝落账（2026-09-30 stage-gate-machine）----
+{
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'confirm-sg1-'));
+  const docP = path.join(root, 'workflow', 'specs');
+  fs.mkdirSync(docP, { recursive: true });
+  fs.writeFileSync(path.join(docP, '2026-09-30-g.md'), '---\n状态: draft\n级别: L2\n---\n# S\n');
+  const before = fs.readFileSync(path.join(docP, '2026-09-30-g.md'), 'utf8');
+  const r = spawnSync(process.execPath, [CLI, 'workflow/specs/2026-09-30-g.md', '--delegated', '可以'], { cwd: root, encoding: 'utf8' });
+  const after = fs.readFileSync(path.join(docP, '2026-09-30-g.md'), 'utf8');
+  const noLedger = !fs.existsSync(path.join(root, '.agents', 'confirmations.jsonl'));
+  check('S19 逐阶段门：spec 无同名入口 → exit 2 + 未落盘未记账 + 回退提示',
+    r.status === 2 && /逐阶段前置门/.test(r.stderr) && /未找到同名入口/.test(r.stderr) && after === before && noLedger,
+    JSON.stringify({ status: r.status, stderr: r.stderr }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
+// ---- S20【逐阶段门】入口存在但未确认（draft）→ 拒绝 ----
+{
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'confirm-sg2-'));
+  fs.mkdirSync(path.join(root, 'workflow', 'intents'), { recursive: true });
+  fs.mkdirSync(path.join(root, 'workflow', 'specs'), { recursive: true });
+  fs.writeFileSync(path.join(root, 'workflow', 'intents', '2026-09-30-h.md'), '---\n状态: draft\n级别: L2\n日期: 2026-09-30\n---\n# I\n');
+  fs.writeFileSync(path.join(root, 'workflow', 'specs', '2026-09-30-h.md'), '---\n状态: draft\n级别: L2\n---\n# S\n');
+  const r = spawnSync(process.execPath, [CLI, 'workflow/specs/2026-09-30-h.md', '--delegated', '可以'], { cwd: root, encoding: 'utf8' });
+  const noLedger = !fs.existsSync(path.join(root, '.agents', 'confirmations.jsonl'));
+  check('S20 逐阶段门：入口未确认（draft）→ exit 2 + 提示状态、零落账',
+    r.status === 2 && /状态「draft」/.test(r.stderr) && noLedger,
+    JSON.stringify({ status: r.status, stderr: r.stderr }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
+// ---- S21【逐阶段门】L1 入口已确认 → plan 放行（存量口径免台账；级别 L1 免 spec 档）----
+{
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'confirm-sg3-'));
+  fs.mkdirSync(path.join(root, 'workflow', 'intents'), { recursive: true });
+  fs.mkdirSync(path.join(root, 'workflow', 'plans'), { recursive: true });
+  fs.writeFileSync(path.join(root, 'workflow', 'intents', '2026-09-30-j.md'), '---\n状态: approved\n级别: L1\n日期: 2026-01-01\n---\n# I\n');
+  fs.writeFileSync(path.join(root, 'workflow', 'plans', '2026-09-30-j.md'), '---\n状态: draft\n级别: L1\n---\n# P\n');
+  const r = spawnSync(process.execPath, [CLI, 'workflow/plans/2026-09-30-j.md', '--delegated', '继续'], { cwd: root, encoding: 'utf8' });
+  const after = fs.readFileSync(path.join(root, 'workflow', 'plans', '2026-09-30-j.md'), 'utf8');
+  check('S21 逐阶段门：L1 入口 approved（存量口径）→ plan 放行落态',
+    r.status === 0 && after.includes('状态: approved'),
+    JSON.stringify({ status: r.status, stderr: r.stderr }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
+// ---- S22【逐阶段门】L2 入口已确认但缺 spec → plan 拒绝 ----
+{
+  // 入口须有**台账行**（不复用存量日期短路路径）——夹具写 confirmed 行使前置成立，仅缺 spec
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'confirm-sg4-'));
+  fs.mkdirSync(path.join(root, 'workflow', 'intents'), { recursive: true });
+  fs.mkdirSync(path.join(root, 'workflow', 'plans'), { recursive: true });
+  fs.mkdirSync(path.join(root, '.agents'), { recursive: true });
+  const fp4 = '4'.repeat(64);
+  fs.writeFileSync(path.join(root, 'workflow', 'intents', '2026-09-30-k.md'), `---\n状态: approved\n级别: L2\n日期: 2026-09-30\n确认指纹: ${fp4.slice(0, 16)}\n---\n# I\n`);
+  fs.writeFileSync(path.join(root, '.agents', 'confirmations.jsonl'), JSON.stringify({ ts: '2026-09-30T04:00:00.000Z', doc: 'workflow/intents/2026-09-30-k.md', stage: 'approved', fingerprint: fp4, prev: 'draft', source: 'chat-delegated', batch: 'k4', seq: 1, of: 1 }) + '\n');
+  fs.writeFileSync(path.join(root, 'workflow', 'plans', '2026-09-30-k.md'), '---\n状态: draft\n级别: L2\n---\n# P\n');
+  const r = spawnSync(process.execPath, [CLI, 'workflow/plans/2026-09-30-k.md', '--delegated', '可以'], { cwd: root, encoding: 'utf8' });
+  const after = fs.readFileSync(path.join(root, 'workflow', 'plans', '2026-09-30-k.md'), 'utf8');
+  check('S22 逐阶段门：L2 入口（台账行）缺同名 spec → plan 拒绝（exit 2 + 未落态）',
+    r.status === 2 && /缺同名 spec/.test(r.stderr) && after.includes('状态: draft'),
+    JSON.stringify({ status: r.status, stderr: r.stderr }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
+// ---- S23【逐阶段门】入口「台账行」正路放行（非存量口径；复核 P2-4④）----
+{
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'confirm-sg5-'));
+  fs.mkdirSync(path.join(root, 'workflow', 'intents'), { recursive: true });
+  fs.mkdirSync(path.join(root, 'workflow', 'specs'), { recursive: true });
+  fs.mkdirSync(path.join(root, '.agents'), { recursive: true });
+  const fp = 'b'.repeat(64);
+  fs.writeFileSync(path.join(root, 'workflow', 'intents', '2026-09-30-m.md'), `---\n状态: approved\n级别: L2\n日期: 2026-09-30\n确认指纹: ${fp.slice(0, 16)}\n---\n# I\n`);
+  fs.writeFileSync(path.join(root, '.agents', 'confirmations.jsonl'), JSON.stringify({ ts: '2026-09-30T02:00:00.000Z', doc: 'workflow/intents/2026-09-30-m.md', stage: 'approved', fingerprint: fp, prev: 'draft', source: 'chat-delegated', batch: 't9', seq: 1, of: 1 }) + '\n');
+  fs.writeFileSync(path.join(root, 'workflow', 'specs', '2026-09-30-m.md'), '---\n状态: draft\n级别: L2\n---\n# S\n');
+  const r = spawnSync(process.execPath, [CLI, 'workflow/specs/2026-09-30-m.md', '--delegated', '继续'], { cwd: root, encoding: 'utf8' });
+  const after = fs.readFileSync(path.join(root, 'workflow', 'specs', '2026-09-30-m.md'), 'utf8');
+  check('S23 逐阶段门：入口状态 approved + 台账行（正路）→ spec 放行',
+    r.status === 0 && after.includes('状态: approved'),
+    JSON.stringify({ status: r.status, stderr: r.stderr }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
+{
+  // N1：存量短路（confirm-doc 侧）——legacy 入口无级别 → spec 放行
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'confirm-n1-'));
+  fs.mkdirSync(path.join(root, 'workflow', 'intents'), { recursive: true });
+  fs.mkdirSync(path.join(root, 'workflow', 'specs'), { recursive: true });
+  fs.writeFileSync(path.join(root, 'workflow', 'intents', '2026-09-30-n1.md'), '---\n状态: approved\n日期: 2026-01-01\n流程: legacy\n---\n# I（存量、无级别）\n');
+  fs.writeFileSync(path.join(root, 'workflow', 'specs', '2026-09-30-n1.md'), '---\n状态: draft\n级别: L2\n---\n# S\n');
+  const r = spawnSync(process.execPath, [CLI, 'workflow/specs/2026-09-30-n1.md', '--delegated', 'n1 回归'], { cwd: root, encoding: 'utf8' });
+  const after = fs.readFileSync(path.join(root, 'workflow', 'specs', '2026-09-30-n1.md'), 'utf8');
+  check('S24 N1 存量短路：legacy 入口无级别 → confirm-doc 放行（不锁死确认）',
+    r.status === 0 && after.includes('状态: approved'),
+    JSON.stringify({ status: r.status, stderr: r.stderr }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
+// ---- S25–S29【done 前置门】approved 历史留痕（2026-09-30 confirm-gate-approved-history）----
+// git helper：与 check-loop.test 同口径（win32 → git.exe；-c 注入 user 免全局 config 依赖）
+const GITBIN = process.platform === 'win32' ? 'git.exe' : 'git';
+const gitAt = (root, ...args) => spawnSync(GITBIN, args, { cwd: root, encoding: 'utf8' });
+const gitHead = (root) => {
+  gitAt(root, 'init', '-q');
+  gitAt(root, '-c', 'user.email=t@t', '-c', 'user.name=t', 'commit', '-q', '--allow-empty', '-m', 'init');
+};
+
+// S25：有 HEAD 但文档从未提交（先 done 后提交形态）→ done 拒绝
+{
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'confirm-dh1-'));
+  fs.mkdirSync(path.join(root, 'workflow', 'plans'), { recursive: true });
+  const p = path.join(root, 'workflow', 'plans', '2026-09-30-d1.md');
+  fs.writeFileSync(p, '---\n状态: approved\n级别: L2\n日期: 2026-09-30\n---\n# P\n');
+  const before = fs.readFileSync(p, 'utf8');
+  gitHead(root);
+  const r = spawnSync(process.execPath, [CLI, 'workflow/plans/2026-09-30-d1.md', '--delegated', '关单'], { cwd: root, encoding: 'utf8' });
+  const after = fs.readFileSync(p, 'utf8');
+  const noLedger = !fs.existsSync(path.join(root, '.agents', 'confirmations.jsonl'));
+  check('S25 done 门：历史无 approved（先 done 后提交形态）→ exit 2 + 零落账 + 零写盘',
+    r.status === 2 && /done 前置门/.test(r.stderr) && /从未出现/.test(r.stderr) && after === before && noLedger,
+    JSON.stringify({ status: r.status, stderr: String(r.stderr).slice(0, 260) }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
+// S26：approved 态已提交（留痕）→ done 放行落账
+{
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'confirm-dh2-'));
+  fs.mkdirSync(path.join(root, 'workflow', 'plans'), { recursive: true });
+  const p = path.join(root, 'workflow', 'plans', '2026-09-30-d2.md');
+  fs.writeFileSync(p, '---\n状态: approved\n级别: L2\n日期: 2026-09-30\n---\n# P\n');
+  gitHead(root);
+  gitAt(root, 'add', '-A');
+  gitAt(root, '-c', 'user.email=t@t', '-c', 'user.name=t', 'commit', '-q', '-m', 'approved');
+  const r = spawnSync(process.execPath, [CLI, 'workflow/plans/2026-09-30-d2.md', '--delegated', '关单'], { cwd: root, encoding: 'utf8' });
+  const after = fs.readFileSync(p, 'utf8');
+  const ledger = readLedgerOf(root); // 复核 P2-1：统一 helper（缺失 → []，不崩溃）
+  check('S26 done 门：approved 态已提交（留痕）→ 放行落态 + 台账 stage=done',
+    r.status === 0 && after.includes('状态: done') && ledger.some((e) => e.stage === 'done' && e.prev === 'approved'),
+    JSON.stringify({ status: r.status, stderr: String(r.stderr).slice(0, 200) }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
+// S27：非 git 环境 → 跳过（不误拦；沿检查 14 口径）
+{
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'confirm-dh3-'));
+  fs.mkdirSync(path.join(root, 'workflow', 'plans'), { recursive: true });
+  const p = path.join(root, 'workflow', 'plans', '2026-09-30-d3.md');
+  fs.writeFileSync(p, '---\n状态: approved\n级别: L2\n---\n# P\n');
+  const r = spawnSync(process.execPath, [CLI, 'workflow/plans/2026-09-30-d3.md', '--delegated', '关单'], { cwd: root, encoding: 'utf8' });
+  const after = fs.readFileSync(p, 'utf8');
+  check('S27 done 门：非 git 环境 → 跳过放行',
+    r.status === 0 && after.includes('状态: done'),
+    JSON.stringify({ status: r.status, stderr: String(r.stderr).slice(0, 200) }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
+// S28：legacy 标记 → 跳过（存量口径；intent 文档承载——spec/plan 不产生 legacy 标记）
+{
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'confirm-dh4-'));
+  fs.mkdirSync(path.join(root, 'workflow', 'intents'), { recursive: true });
+  const p = path.join(root, 'workflow', 'intents', '2026-09-30-d4.md');
+  fs.writeFileSync(p, '---\n状态: approved\n级别: L1\n日期: 2026-01-01\n流程: legacy\n---\n# I\n');
+  gitHead(root);
+  const r = spawnSync(process.execPath, [CLI, 'workflow/intents/2026-09-30-d4.md', '--delegated', '关单'], { cwd: root, encoding: 'utf8' });
+  const after = fs.readFileSync(p, 'utf8');
+  check('S28 done 门：legacy 标记 → 跳过放行',
+    r.status === 0 && after.includes('状态: done'),
+    JSON.stringify({ status: r.status, stderr: String(r.stderr).slice(0, 200) }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
+// S29：正文「存量确认态豁免（」声明 → 跳过（显式逃生口；与检查 14 同标记）
+{
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'confirm-dh5-'));
+  fs.mkdirSync(path.join(root, 'workflow', 'specs'), { recursive: true });
+  const p = path.join(root, 'workflow', 'specs', '2026-09-30-d5.md');
+  fs.writeFileSync(p, '---\n状态: approved\n级别: L2\n---\n# S\n\n存量确认态豁免（S29 构造：声明式逃生口覆盖）\n');
+  gitHead(root);
+  const r = spawnSync(process.execPath, [CLI, 'workflow/specs/2026-09-30-d5.md', '--delegated', '关单'], { cwd: root, encoding: 'utf8' });
+  const after = fs.readFileSync(p, 'utf8');
+  check('S29 done 门：存量豁免声明 → 跳过放行',
+    r.status === 0 && after.includes('状态: done'),
+    JSON.stringify({ status: r.status, stderr: String(r.stderr).slice(0, 200) }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
+// ---- S30【协作道批量】--batch：delegated 多份 L0/L1 一次代录 → 全部落态 + 台账 brief:true（2026-09-30 hybrid-governance-risk-lanes）----
+{
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'confirm-bt1-'));
+  fs.mkdirSync(path.join(root, 'workflow', 'intents'), { recursive: true });
+  fs.writeFileSync(path.join(root, 'workflow', 'intents', '2026-09-30-bt1.md'), '---\n状态: draft\n级别: L1\n日期: 2026-09-30\n---\n# I1\n');
+  fs.writeFileSync(path.join(root, 'workflow', 'intents', '2026-09-30-bt2.md'), '---\n状态: draft\n级别: L0\n日期: 2026-09-30\n---\n# I2\n');
+  const r = spawnSync(process.execPath, [CLI, 'workflow/intents/2026-09-30-bt1.md', 'workflow/intents/2026-09-30-bt2.md', '--delegated', '批量放行', '--batch'], { cwd: root, encoding: 'utf8' });
+  const led = readLedgerOf(root);
+  const st1 = fs.readFileSync(path.join(root, 'workflow', 'intents', '2026-09-30-bt1.md'), 'utf8');
+  const st2 = fs.readFileSync(path.join(root, 'workflow', 'intents', '2026-09-30-bt2.md'), 'utf8');
+  check('S30 --batch：2 份 L0/L1 一次代录 → 全部 approved + 台账 brief:true / of=2 / seq 递增',
+    r.status === 0 && led.length === 2
+      && led.every((e) => e.brief === true && e.source === 'chat-delegated' && e.of === 2 && e.stage === 'approved')
+      && led[0].seq === 1 && led[1].seq === 2
+      && st1.includes('状态: approved') && st2.includes('状态: approved'),
+    JSON.stringify({ status: r.status, stderr: String(r.stderr).slice(0, 300), led }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
+// ---- S31【协作道批量】--batch 混入 L2 → 该份逐份拒绝（exit 2 + 未落盘未记账），L1 份照常落态 ----
+{
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'confirm-bt2-'));
+  fs.mkdirSync(path.join(root, 'workflow', 'intents'), { recursive: true });
+  fs.writeFileSync(path.join(root, 'workflow', 'intents', '2026-09-30-bt3.md'), '---\n状态: draft\n级别: L1\n日期: 2026-09-30\n---\n# I3\n');
+  fs.writeFileSync(path.join(root, 'workflow', 'intents', '2026-09-30-bt4.md'), '---\n状态: draft\n级别: L2\n日期: 2026-09-30\n---\n# I4\n');
+  const r = spawnSync(process.execPath, [CLI, 'workflow/intents/2026-09-30-bt3.md', 'workflow/intents/2026-09-30-bt4.md', '--delegated', '批量放行', '--batch'], { cwd: root, encoding: 'utf8' });
+  const led = readLedgerOf(root);
+  const st4 = fs.readFileSync(path.join(root, 'workflow', 'intents', '2026-09-30-bt4.md'), 'utf8');
+  check('S31 --batch 混入 L2 → L2 拒绝（exit 2 + 未落盘未记账）+ L1 落态',
+    r.status === 2 && /不在协作道/.test(r.stderr) && led.length === 1 && led[0].doc.endsWith('bt3.md') && st4.includes('状态: draft'),
+    JSON.stringify({ status: r.status, stderr: String(r.stderr).slice(0, 300), led }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
+// ---- S32 --batch 组合约束：与 --auto / --to 互斥（exit 1，零落账）----
+{
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'confirm-bt3-'));
+  fs.mkdirSync(path.join(root, 'workflow', 'intents'), { recursive: true });
+  fs.writeFileSync(path.join(root, 'workflow', 'intents', '2026-09-30-bt5.md'), '---\n状态: draft\n级别: L1\n日期: 2026-09-30\n---\n# I5\n');
+  const r1 = spawnSync(process.execPath, [CLI, 'workflow/intents/2026-09-30-bt5.md', '--delegated', 'x', '--batch', '--auto'], { cwd: root, encoding: 'utf8' });
+  const r2 = spawnSync(process.execPath, [CLI, 'workflow/intents/2026-09-30-bt5.md', '--delegated', 'x', '--batch', '--to', 'cancelled'], { cwd: root, encoding: 'utf8' });
+  const noLedger = !fs.existsSync(path.join(root, '.agents', 'confirmations.jsonl'));
+  check('S32 --batch 与 --auto / --to 互斥 → 均 exit 1 + 零台账',
+    r1.status === 1 && r2.status === 1 && noLedger,
+    JSON.stringify({ r1: r1.status, r2: r2.status }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
+// ---- S33 简洁审计：单份 delegated L0/L1（无 --batch）→ 台账 brief:true + 紧凑输出；L2 份不带 brief ----
+{
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'confirm-bt4-'));
+  fs.mkdirSync(path.join(root, 'workflow', 'intents'), { recursive: true });
+  fs.writeFileSync(path.join(root, 'workflow', 'intents', '2026-09-30-bt6.md'), '---\n状态: draft\n级别: L1\n日期: 2026-09-30\n---\n# I6\n');
+  const r = spawnSync(process.execPath, [CLI, 'workflow/intents/2026-09-30-bt6.md', '--delegated', '单份放行'], { cwd: root, encoding: 'utf8' });
+  const led = readLedgerOf(root);
+  check('S33 单份 L1 代录 → brief:true + 紧凑输出（协作道/异步审计标记）',
+    r.status === 0 && led.length === 1 && led[0].brief === true && /协作道\/异步审计/.test(r.stdout),
+    JSON.stringify({ status: r.status, stdout: String(r.stdout).slice(0, 200), led }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
+// ---- S34–S37【Trusted 自动泳道】trust-mode.json = Trusted（level 2）→ 非 TTY 免旗标隐式自治（2026-09-30 hybrid-governance-explore-hardening）----
+const writeTrust = (root, cfg) => {
+  fs.mkdirSync(path.join(root, '.agents'), { recursive: true });
+  fs.writeFileSync(path.join(root, '.agents', 'trust-mode.json'), JSON.stringify(cfg));
+};
+// S34：Trusted + L1 intent 免旗标 → draft→approved 落态 + 台账 source=ai-auto-trust-L2；第二跳 → done（全闭环）
+{
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'confirm-tr1-'));
+  fs.mkdirSync(path.join(root, 'workflow', 'intents'), { recursive: true });
+  writeTrust(root, { enabled: true, level: 2, name: 'Trusted', enabledAt: '2026-09-30T00:00:00.000Z' });
+  const p = path.join(root, 'workflow', 'intents', '2026-09-30-tr1.md');
+  fs.writeFileSync(p, '---\n状态: draft\n级别: L1\n日期: 2026-09-30\n---\n# I\n');
+  const r1 = spawnSync(process.execPath, [CLI, 'workflow/intents/2026-09-30-tr1.md'], { cwd: root, encoding: 'utf8' });
+  const led1 = readLedgerOf(root);
+  check('S34 Trusted 隐式：非 TTY 无旗标 L1 draft→approved + 台账 source=ai-auto-trust-L2',
+    r1.status === 0 && fs.readFileSync(p, 'utf8').includes('状态: approved')
+      && led1.length === 1 && led1[0].source === 'ai-auto-trust-L2' && led1[0].stage === 'approved' && led1[0].prev === 'draft',
+    JSON.stringify({ status: r1.status, stderr: String(r1.stderr).slice(0, 300), led: led1 }));
+  // 第二跳：非 git 环境 done 门跳过（S27 同口径）→ Level 2 全闭环直达 done
+  const r2 = spawnSync(process.execPath, [CLI, 'workflow/intents/2026-09-30-tr1.md'], { cwd: root, encoding: 'utf8' });
+  const led2 = readLedgerOf(root);
+  check('S34b Trusted 隐式第二跳：approved→done（Level 2 全闭环）',
+    r2.status === 0 && fs.readFileSync(p, 'utf8').includes('状态: done')
+      && led2.length === 2 && led2[1].stage === 'done' && led2[1].prev === 'approved',
+    JSON.stringify({ status: r2.status, stderr: String(r2.stderr).slice(0, 300), led: led2 }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+// S35：Trusted 隐式边界——L2 文档与 incidents 均不过自治门（exit 2 未落账）
+{
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'confirm-tr2-'));
+  fs.mkdirSync(path.join(root, 'workflow', 'intents'), { recursive: true });
+  fs.mkdirSync(path.join(root, 'workflow', 'incidents'), { recursive: true });
+  writeTrust(root, { enabled: true, level: 2, name: 'Trusted' });
+  fs.writeFileSync(path.join(root, 'workflow', 'intents', '2026-09-30-tr2.md'), '---\n状态: draft\n级别: L2\n日期: 2026-09-30\n---\n# I\n');
+  fs.writeFileSync(path.join(root, 'workflow', 'incidents', '2026-09-30-tr3.md'), '---\n状态: open\n级别: L1\n---\n# I\n');
+  const r1 = spawnSync(process.execPath, [CLI, 'workflow/intents/2026-09-30-tr2.md'], { cwd: root, encoding: 'utf8' });
+  const r2 = spawnSync(process.execPath, [CLI, 'workflow/incidents/2026-09-30-tr3.md'], { cwd: root, encoding: 'utf8' });
+  check('S35 Trusted 隐式边界：L2 文档与 incidents 均拒绝（exit 2 未过自治门）+ 零台账',
+    r1.status === 2 && r2.status === 2 && readLedgerOf(root).length === 0,
+    JSON.stringify({ r1: r1.status, r2: r2.status, stderr1: String(r1.stderr).slice(0, 200) }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+// S36：Standard（level 1）不隐式——非 TTY 无旗标仍拒（隐式泳道仅 Trusted；fail-closed）
+{
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'confirm-tr3-'));
+  fs.mkdirSync(path.join(root, 'workflow', 'intents'), { recursive: true });
+  writeTrust(root, { enabled: true, level: 1, name: 'Standard' });
+  const p = path.join(root, 'workflow', 'intents', '2026-09-30-tr4.md');
+  fs.writeFileSync(p, '---\n状态: draft\n级别: L1\n日期: 2026-09-30\n---\n# I\n');
+  const r = spawnSync(process.execPath, [CLI, 'workflow/intents/2026-09-30-tr4.md'], { cwd: root, encoding: 'utf8' });
+  check('S36 Standard 不隐式：非 TTY 无旗标 → 仍 exit 1 拒绝 + 零写盘',
+    r.status === 1 && /不可代确认/.test(r.stderr) && fs.readFileSync(p, 'utf8').includes('状态: draft'),
+    JSON.stringify({ status: r.status, stderr: String(r.stderr).slice(0, 200) }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+// S37：Trusted 隐式边界——多份 / --to 放弃态 → 不隐式，仍拒（exit 1）
+{
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'confirm-tr4-'));
+  fs.mkdirSync(path.join(root, 'workflow', 'intents'), { recursive: true });
+  writeTrust(root, { enabled: true, level: 2, name: 'Trusted' });
+  fs.writeFileSync(path.join(root, 'workflow', 'intents', '2026-09-30-tr5.md'), '---\n状态: draft\n级别: L1\n日期: 2026-09-30\n---\n# I\n');
+  fs.writeFileSync(path.join(root, 'workflow', 'intents', '2026-09-30-tr6.md'), '---\n状态: draft\n级别: L1\n日期: 2026-09-30\n---\n# I\n');
+  const r1 = spawnSync(process.execPath, [CLI, 'workflow/intents/2026-09-30-tr5.md', 'workflow/intents/2026-09-30-tr6.md'], { cwd: root, encoding: 'utf8' });
+  const r2 = spawnSync(process.execPath, [CLI, 'workflow/intents/2026-09-30-tr5.md', '--to', 'cancelled'], { cwd: root, encoding: 'utf8' });
+  check('S37 Trusted 隐式边界：多份 / --to 放弃态 → 不隐式仍拒（exit 1 + 零台账）',
+    r1.status === 1 && r2.status === 1 && /不可代确认/.test(r1.stderr) && readLedgerOf(root).length === 0,
+    JSON.stringify({ r1: r1.status, r2: r2.status, stderr1: String(r1.stderr).slice(0, 160), stderr2: String(r2.stderr).slice(0, 160) }));
+  fs.rmSync(root, { recursive: true, force: true });
 }
 
 console.log(`\n合计: PASS ${pass} / FAIL ${fail}`);

package/templates/_agents/scripts/doctor.test.mjs

@@ -27,7 +27,7 @@ if (!fs.existsSync(SRC)) {
   console.error(`doctor.test.mjs：SKIP——未找到 ${SRC}（装户环境无包源 src/；本套件仅在包源仓库/dogfooding 跑 npm test 时有意义）`);
   process.exit(0);
 }
-const { checkOwnedDrift, checkAdapterDrift, checkLedgerCoverage } = await import(pathToFileURL(SRC).href);
+const { checkOwnedDrift, checkAdapterDrift, checkLedgerCoverage, checkDelegationSnapshotFreshness } = await import(pathToFileURL(SRC).href);
 
 let pass = 0;
 let fail = 0;
@@ -372,5 +372,106 @@ const CMD_BODY = '# Build\n\n正文 build v1\n';
   fs.rmSync(pkg, { recursive: true, force: true });
 }
 
+// ---- 场景 19：快照最新（snapshotMonth >= ledgerMonth）→ stale=false ----
+{
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'doctor-snap-'));
+  fs.mkdirSync(path.join(root, 'workflow'), { recursive: true });
+  fs.writeFileSync(path.join(root, 'workflow', 'delegations.md'), [
+    '## 委派结果',
+    '',
+    '| 日期 | 被委派方 | 任务一句话 | 结果 | 备注 |',
+    '|------|----------|------------|------|------|',
+    '| 2026-09-20 | x | y | 一次通过 | z |',
+    '| 2026-09-26 | x | y | 一次通过 | z |',
+    '',
+    '## 月度聚合快照',
+    '',
+    '| 月份 | 有效任务 | 一次通过率 | 返工次数 |',
+    '|------|----------|------------|----------|',
+    '| 2026-09 | 2 | 100% | 0 |',
+    '',
+  ].join('\n'));
+  const r = checkDelegationSnapshotFreshness(root);
+  check('场景 19：快照最新 → stale=false skipped=false',
+    r.stale === false && r.skipped === false && r.ledgerMonth === '2026-09' && r.snapshotMonth === '2026-09',
+    JSON.stringify(r));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
+// ---- 场景 20：快照陈旧（snapshotMonth < ledgerMonth）→ stale=true ----
+{
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'doctor-snap-'));
+  fs.mkdirSync(path.join(root, 'workflow'), { recursive: true });
+  fs.writeFileSync(path.join(root, 'workflow', 'delegations.md'), [
+    '## 委派结果',
+    '',
+    '| 日期 | 被委派方 | 任务一句话 | 结果 | 备注 |',
+    '|------|----------|------------|------|------|',
+    '| 2026-09-10 | x | y | 一次通过 | z |',
+    '',
+    '## 月度聚合快照',
+    '',
+    '| 月份 | 有效任务 | 一次通过率 | 返工次数 |',
+    '|------|----------|------------|----------|',
+    '| 2026-08 | 1 | 100% | 0 |',
+    '',
+  ].join('\n'));
+  const r = checkDelegationSnapshotFreshness(root);
+  check('场景 20：快照陈旧（08 < 09）→ stale=true',
+    r.stale === true && r.skipped === false && r.ledgerMonth === '2026-09' && r.snapshotMonth === '2026-08',
+    JSON.stringify(r));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
+// ---- 场景 21：有数据行但无快照行 → stale=true snapshotMonth=null ----
+{
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'doctor-snap-'));
+  fs.mkdirSync(path.join(root, 'workflow'), { recursive: true });
+  fs.writeFileSync(path.join(root, 'workflow', 'delegations.md'), [
+    '## 委派结果',
+    '',
+    '| 日期 | 被委派方 | 任务一句话 | 结果 | 备注 |',
+    '|------|----------|------------|------|------|',
+    '| 2026-09-25 | x | y | 一次通过 | z |',
+    '',
+  ].join('\n'));
+  const r = checkDelegationSnapshotFreshness(root);
+  check('场景 21：无快照行 → stale=true snapshotMonth=null',
+    r.stale === true && r.skipped === false && r.snapshotMonth === null,
+    JSON.stringify(r));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
+// ---- 场景 22：无台账数据行 → skipped=true ----
+{
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'doctor-snap-'));
+  fs.mkdirSync(path.join(root, 'workflow'), { recursive: true });
+  fs.writeFileSync(path.join(root, 'workflow', 'delegations.md'), [
+    '# delegations',
+    '',
+    '## 月度聚合快照',
+    '',
+    '| 月份 | 有效任务 |',
+    '|------|----------|',
+    '| 2026-09 | 0 |',
+    '',
+  ].join('\n'));
+  const r = checkDelegationSnapshotFreshness(root);
+  check('场景 22：无数据行 → skipped=true',
+    r.skipped === true && r.stale === false,
+    JSON.stringify(r));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
+// ---- 场景 23：delegations.md 不存在 → skipped=true ----
+{
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'doctor-snap-'));
+  const r = checkDelegationSnapshotFreshness(root);
+  check('场景 23：文件不存在 → skipped=true',
+    r.skipped === true && r.stale === false,
+    JSON.stringify(r));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
 console.log(`\n合计: PASS ${pass} / FAIL ${fail}`);
 process.exit(fail ? 1 : 0);

package/templates/_agents/scripts/fill-intent.mjs

@@ -1,5 +1,5 @@
 // flow-kit fill-intent：起草 intent 草稿（背景与问题/目标/非目标/约束/影响面/触达红线/验收标准 共 7 节）
-// 读 workflow/intents/_TEMPLATE.md 的节标题 → 输出符合 frontmatter 受限子集（5 字段）的草稿到指定文件
+// 读 workflow/intents/_TEMPLATE.md 的节标题 → 输出符合 frontmatter 受限子集（6 字段，含 risk_level 风险泳道）的草稿到指定文件
 // 用法：node .agents/scripts/fill-intent.mjs --module pipeline --level L1 --topic "test" --output /tmp/x.md
 // 零依赖；CLI 解析用最简字符串匹配；不替代 AI 起草——本工具只输出模板与提示句
 import fs from 'node:fs';
@@ -27,22 +27,23 @@ function fail(msg) { console.error('❌ ' + msg); process.exit(1); }
 
 const SECTIONS = [
   { title: '背景与问题', hint: '<为什么做；写明需求来源（工单 / 沟通记录 / 待办事项）>' },
+  { title: '历史教训/防复发', hint: '- 检索结果：`node .agents/scripts/kb-search.mjs "<关键词>" --type incidents` 命中结果\n- 避坑指南：<针对历史根因，本次如何预防/规避>' },
   { title: '目标', hint: '- <可验证的目标>' },
   { title: '非目标（L1 微改动无实质内容可删本节，不硬填）', hint: '- <明确不做的，防止范围蔓延>' },
   { title: '约束（L1 微改动无实质内容可删本节，不硬填）', hint: '- <复用什么、不许动什么>' },
-  { title: '影响面', hint: '- 模块：<词表之一，见 .agents/workflow-modules.txt>\n- 数据库：无 / <表名>（涉及 schema 变更 → L3；无 schema 的运行时 / 管线结构面亦为 L3，判据见 .agents/commands/new-task.md §级别判断）\n- 前端页面：<路由或组件，无则删本行>' },
-  { title: '触达红线（对照 AGENTS.md，勾选仅标记触及范围；具体如何满足在同名 spec 中说明）', hint: '- [ ] <按本项目 AGENTS.md 红线逐行补；无则删本行>\n- [ ] 规则 / 契约变更（编码权威 / 共享契约 / 接口签名 / 既有参数语义 / 全局口径）→ 级别至少 L2\n- [ ] schema / 迁移 SQL / DI 链 / 认证与中间件管线 → 级别 L3\n\n> 触及任一红线即为 L2 / L3，必须立 ../specs/YYYY-MM-DD-<主题>.md 写明如何满足，方可起草 plan。' },
-  { title: '验收标准（可测试）', hint: '- [ ] <逐条可测试；写不出可测试判据 = 还没想清楚>\n\n> **闭环对账**：关单在 test 阶段（不依赖 deploy）。intent 置 done 前逐条勾验，每条勾选项后补证据——`- [x] <判据>（证据：<commit SHA / 测试用例名 / 冒烟脚本输出>）`。\n> done 状态仍有未勾项会被 check-loop 拦截（2026-09-12 起新建 intent 为 hard-block，存量 intent 仅 warning 提示）；勾选但缺「证据：」为 warning。' },
+  { title: '影响面', hint: '- 模块：<词表之一，见 .agents/workflow-modules.txt>\n- 数据库：无 / <表名>（涉及 schema 变更 $\rightarrow$ L3；无 schema 的运行时 / 管线结构面亦为 L3，判据见 .agents/commands/new-task.md §级别判断）\n- 前端页面：<路由或组件，无则删本行>' },
+  { title: '触达红线（对照 AGENTS.md，勾选仅标记触及范围；具体如何满足在同名 spec 或 Quick-Plan 中说明）', hint: '- [ ] <按本项目 AGENTS.md 红线逐行补；无则删本行>\n- [ ] 规则 / 契约变更（编码权威 / 共享契约 / 接口签名 / 既有参数语义 / 全局口径）$\rightarrow$ 级别至少 L2\n- [ ] schema / 迁移 SQL / DI 链 / 认证与中间件管线 $\rightarrow$ 级别 L3\n\n> 触及任一红线即为 L2 / L3，必须立 ../specs/YYYY-MM-DD-<主题>.md 写明如何满足，方可起草 plan。' },
+  { title: '验收标准（可测试）', hint: '- [ ] <逐条可测试；写不出可测试判据 = 还没想清楚>\n\n> **闭环对账**：关单在 test 阶段（不依赖 deploy）。intent 置 done 前逐条勾验，每条补证据——`- [x] <判据>（证据：<commit SHA / 测试用例名 / 冒烟脚本输出>）`。\n> done 状态仍有未勾项会被 check-loop 拦截（2026-09-12 起新建 intent 为 hard-block，存量 intent 仅 warning 提示）；勾选但缺「证据：」为 hard-block。' },
 ];
 
 export function renderIntent({ topic, module, level, notes, date = TODAY }) {
   if (!LEVELS.includes(level)) throw new Error('level 不在枚举 ' + LEVELS.join('|') + '：' + level);
-  const fm = '---\n状态: draft\n级别: ' + level + '\n日期: ' + date + '\n模块: ' + module + '\n备注: ' + (notes || '<可选：附注自由文本，check-loop 不解析>') + '\n---\n';
-  let body = '# INTENT — ' + topic + '\n\n<!-- 复制本模板为 YYYY-MM-DD-<主题>.md 后填写；plans/ 下同名文件与本文件配对 -->\n<!-- frontmatter 受限子集（2026-09-13）：每行 键: 值；状态∈draft/approved/done/superseded/cancelled（严格枚举，附注写备注键）；级别∈L0/L1/L2/L3；check-loop 只扫 frontmatter 取机器字段，正文不再写状态/级别行 -->\n\n';
+  const fm = '---\n状态: draft\n级别: ' + level + '\nrisk_level: ' + level + '\n日期: ' + date + '\n模块: ' + module + '\n备注: ' + (notes || '<可选：附注自由文本，check-loop 不解析>') + '\n---\n';
+  let body = '# INTENT — ' + topic + '\n\n<!-- 复制本模板为 YYYY-MM-DD-<主题>.md 后填写；plans/ 下同名文件与本文件配对 -->\n<!-- frontmatter 受限子集（2026-09-13）：每行 键: 值；状态∈draft/approved/done/superseded/cancelled（严格枚举，附注写备注键）；级别∈L0/L1/L2/L3；risk_level=级别（混合治理风险泳道选道：L0/L1 协作道异步审计 / L2/L3 防御道同步确认）；check-loop 只扫 frontmatter 取机器字段，正文不再写状态/级别行 -->\n\n';
   for (const { title, hint } of SECTIONS) {
     body += '## ' + title + '\n\n' + hint + '\n\n';
   }
-  body += '## 确认与复核\n\n- 确认日期：\n- 确认人：用户（对话内一句"可以"即确认）\n- 确认范围：\n- 复核：L1 不要求独立复核\n';
+  body += '## 确认与复核\n\n- 确认日期：\n- 确认人：用户（对话内明确放行即确认）\n- 确认范围：\n- 复核：L1 不要求独立复核\n';
   return { frontmatter: fm, body: fm + body, sections: SECTIONS.map((s) => s.title) };
 }