agentic-flow-kit 1.7.15 → 1.8.0

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

@@ -7,6 +7,8 @@
 //          L2/L3 时同名 spec）已确认；未过 → exit 2 + 未落盘未记账（S19-S22）
 //       ⑧ done 前置门（2026-09-30 confirm-gate-approved-history）：→done 须 git 历史已留 approved 态
 //          （先 done 后提交 / 两跳同批提交 → 拒绝）；非 git / legacy / 存量豁免声明 → 跳过（S25-S29）
+//       ⑨ 关单即归档（2026-10-13 archive-on-close，B9 自源仓回灌）：终态家族即时 git mv 进 archive、
+//          未涉及家族不越权清理、无归档约定不启用、CONFIRM_DOC_NO_ARCHIVE 逃生门（S43-S45）
 // 用法：node templates/_agents/scripts/confirm-doc.test.mjs（npm test 随跑）
 import fs from 'node:fs';
 import os from 'node:os';
@@ -615,17 +617,17 @@ const gitHead = (root) => {
   fs.rmSync(root, { recursive: true, force: true });
 }
 
-// ---- S30【协作道批量】--batch：delegated 多份 L0/L1 一次代录 → 全部落态 + 台账 brief:true（2026-09-30 hybrid-governance-risk-lanes）----
+// ---- S30【协作道批量】--batch：delegated 多份 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');
+  fs.writeFileSync(path.join(root, 'workflow', 'intents', '2026-09-30-bt2.md'), '---\n状态: draft\n级别: L1\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 递增',
+  check('S30 --batch：2 份 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
@@ -694,7 +696,7 @@ const gitHead = (root) => {
   fs.rmSync(root, { recursive: true, force: true });
 }
 
-// ---- S33 简洁审计：单份 delegated L0/L1（无 --batch）→ 台账 brief:true + 紧凑输出；L2 份不带 brief ----
+// ---- S33 简洁审计：单份 delegated 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 });
@@ -880,5 +882,179 @@ const writeTrust = (root, cfg) => {
   fs.rmSync(root, { recursive: true, force: true });
 }
 
+// ---- S42 分片默认写入口径（2026-10-13 ledger-shard-default）：CLI 默认写分片 / 两种回退 / 存量回退 / 显式拒 ----
+{
+  const mkFixture = (withV8) => {
+    const root = fs.mkdtempSync(path.join(os.tmpdir(), 'confirm-shard-'));
+    const docP = path.join(root, 'workflow', 'intents');
+    fs.mkdirSync(docP, { recursive: true });
+    fs.writeFileSync(path.join(docP, '2026-10-13-s.md'), '---\n状态: draft\n级别: L1\n---\n# I\n');
+    if (withV8) {
+      fs.mkdirSync(path.join(root, '.agents'), { recursive: true });
+      fs.writeFileSync(path.join(root, '.agents', 'kit.json'), JSON.stringify({ policyVersion: 8 }), 'utf8');
+    }
+    return root;
+  };
+  const shardPathOf = (root) => path.join(root, '.agents', 'confirmations.d', '2026-10-13-s.jsonl');
+  const mainPathOf = (root) => path.join(root, '.agents', 'confirmations.jsonl');
+  const readRows = (p) => (fs.existsSync(p) ? fs.readFileSync(p, 'utf8').split('\n').filter(Boolean).map((l) => JSON.parse(l)) : []);
+  const spawnConfirm = (root, args, env = {}) => spawnSync(process.execPath, [CLI, 'workflow/intents/2026-10-13-s.md', '--delegated', '可以', ...args], { cwd: root, encoding: 'utf8', env: { ...process.env, ...env } });
+
+  // S42① 默认（无旗标）+ doc 链已激活（policyVersion 8）→ 写分片，主台账零行
+  {
+    const root = mkFixture(true);
+    const r = spawnConfirm(root, []);
+    check('S42① 默认写分片：exit 0 + 行落 confirmations.d/<doc基名>.jsonl + 主台账零行',
+      r.status === 0 && readRows(shardPathOf(root)).length === 1
+        && readRows(shardPathOf(root))[0].source === 'chat-delegated'
+        && readRows(mainPathOf(root)).length === 0,
+      JSON.stringify({ status: r.status, stderr: r.stderr }));
+    fs.rmSync(root, { recursive: true, force: true });
+  }
+  // S42② --no-shard → 显式回退主台账
+  {
+    const root = mkFixture(true);
+    const r = spawnConfirm(root, ['--no-shard']);
+    check('S42② --no-shard 回退主台账：exit 0 + 行落 confirmations.jsonl + 分片不存在',
+      r.status === 0 && readRows(mainPathOf(root)).length === 1 && !fs.existsSync(shardPathOf(root)),
+      JSON.stringify({ status: r.status, stderr: r.stderr }));
+    fs.rmSync(root, { recursive: true, force: true });
+  }
+  // S42③ CONFIRM_SHARDED=0 → 环境变量回退主台账
+  {
+    const root = mkFixture(true);
+    const r = spawnConfirm(root, [], { CONFIRM_SHARDED: '0' });
+    check('S42③ CONFIRM_SHARDED=0 回退主台账：exit 0 + 行落 confirmations.jsonl + 分片不存在',
+      r.status === 0 && readRows(mainPathOf(root)).length === 1 && !fs.existsSync(shardPathOf(root)),
+      JSON.stringify({ status: r.status, stderr: r.stderr }));
+    fs.rmSync(root, { recursive: true, force: true });
+  }
+  // S42④ 存量装户（无 kit.json → policyVersion 1，doc 链未激活）默认 → 自动回退主台账 + ℹ️ 升级指引
+  {
+    const root = mkFixture(false);
+    const r = spawnConfirm(root, []);
+    check('S42④ 存量装户默认：自动回退主台账（exit 0 + 行落 confirmations.jsonl）+ stderr 带 policyVersion: 8 升级指引 + 分片不存在',
+      r.status === 0 && readRows(mainPathOf(root)).length === 1
+        && /policyVersion: 8/.test(r.stderr) && !fs.existsSync(shardPathOf(root)),
+      JSON.stringify({ status: r.status, stderr: r.stderr }));
+    fs.rmSync(root, { recursive: true, force: true });
+  }
+  // S42⑤ 存量装户显式 --shard → 参数期直接拒（原口径不变）
+  {
+    const root = mkFixture(false);
+    const r = spawnConfirm(root, ['--shard']);
+    check('S42⑤ 显式 --shard 缺 doc 链锚：exit 1 + 报错带修法 + 零落账（文档/台账均未动）',
+      r.status === 1 && /--shard 需要台账 doc 链口径/.test(r.stderr)
+        && !fs.existsSync(shardPathOf(root)) && !fs.existsSync(mainPathOf(root)),
+      JSON.stringify({ status: r.status, stderr: r.stderr }));
+    fs.rmSync(root, { recursive: true, force: true });
+  }
+  // S42⑥ --shard 与 --no-shard 互斥 → 用法错误
+  {
+    const root = mkFixture(true);
+    const r = spawnConfirm(root, ['--shard', '--no-shard']);
+    check('S42⑥ --shard 与 --no-shard 互斥：exit 1 + 用法提示 + 零落账',
+      r.status === 1 && /互斥/.test(r.stderr) && !fs.existsSync(shardPathOf(root)) && !fs.existsSync(mainPathOf(root)),
+      JSON.stringify({ status: r.status, stderr: r.stderr }));
+    fs.rmSync(root, { recursive: true, force: true });
+  }
+}
+
+// ---- S43 关单即归档（2026-10-13 archive-on-close；B9 自源仓回灌随件测试）：终态家族超窗 → git mv 进 archive ----
+// 需真实 git 仓库（归档走 git mv）；家族原子：intent+plan 同进同退。月份断言锚定「实时今月」——
+// 与源仓同口径（台账终态锚 = 实时 now，归档月 = 家族最晚终态月），跨月运行需随今月更新断言。
+{
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'confirm-arch-'));
+  const git = (...a) => spawnSync(process.platform === 'win32' ? 'git.exe' : 'git', a, { cwd: root, encoding: 'utf8' });
+  git('init', '-q');
+  git('config', 'user.email', 't@t');
+  git('config', 'user.name', 't');
+  const ip = path.join(root, 'workflow', 'intents');
+  const pp = path.join(root, 'workflow', 'plans');
+  fs.mkdirSync(ip, { recursive: true });
+  fs.mkdirSync(pp, { recursive: true });
+  fs.mkdirSync(path.join(root, 'workflow', 'archive'), { recursive: true }); // 归档约定在场（启用条件）
+  // 家族：intent（本次关单）+ plan（已 done 且正文变更在 30 天前 → 超窗）
+  fs.writeFileSync(path.join(ip, '2026-09-01-fam.md'), '---\n状态: approved\n级别: L1\n确认指纹: aaaa1111aaaa1111\n---\n# I\n\n## 验收标准（可测试）\n- [x] 通过（证据:测试全绿）\n', 'utf8');
+  fs.writeFileSync(path.join(pp, '2026-09-01-fam.md'), '---\n状态: done\n级别: L1\n---\n# P\n\n## 改动方案\n- 正文\n', 'utf8');
+  git('add', '-A');
+  spawnSync(process.platform === 'win32' ? 'git.exe' : 'git', ['commit', '-q', '-m', 'c1'], { cwd: root, env: { ...process.env, GIT_AUTHOR_DATE: '2026-09-01T10:00:00+08:00', GIT_COMMITTER_DATE: '2026-09-01T10:00:00+08:00' } });
+  const r = spawnSync(process.execPath, [CLI, 'workflow/intents/2026-09-01-fam.md', '--delegated', '可以'],
+    { cwd: root, encoding: 'utf8', env: { ...process.env, CONFIRM_DOC_TEST_NOW: '2026-10-13' } });
+  const intentArchived = fs.existsSync(path.join(root, 'workflow', 'archive', '2026-10', 'intents', '2026-09-01-fam.md'));
+  const planArchived = fs.existsSync(path.join(root, 'workflow', 'archive', '2026-10', 'plans', '2026-09-01-fam.md'));
+  check('S43 关单即归档：终态家族整族 git mv 进 archive（intent+plan 同批）',
+    r.status === 0 && intentArchived && planArchived && /📦 归档/.test(r.stdout),
+    JSON.stringify({ status: r.status, stdout: String(r.stdout).slice(-300), stderr: String(r.stderr).slice(-200), intentArchived, planArchived }));
+  check('S43b 归档后活跃目录不再留该家族', !fs.existsSync(path.join(ip, '2026-09-01-fam.md')) && !fs.existsSync(path.join(pp, '2026-09-01-fam.md')));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
+// ---- S44 归档边界：本次确认的家族即时归档（窗口对其冗余）；未涉及的家族不越权清理 ----
+{
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'confirm-arch2-'));
+  const git = (...a) => spawnSync(process.platform === 'win32' ? 'git.exe' : 'git', a, { cwd: root, encoding: 'utf8' });
+  git('init', '-q');
+  git('config', 'user.email', 't@t');
+  git('config', 'user.name', 't');
+  const ip = path.join(root, 'workflow', 'intents');
+  fs.mkdirSync(ip, { recursive: true });
+  fs.mkdirSync(path.join(root, 'workflow', 'archive'), { recursive: true }); // 归档约定在场（启用条件）
+  // 本次确认的家族（刚落终态 → 即时归档，窗口不适用）
+  fs.writeFileSync(path.join(ip, '2026-10-12-fresh.md'), '---\n状态: approved\n级别: L1\n确认指纹: bbbb2222bbbb2222\n---\n# I\n\n## 验收标准（可测试）\n- [x] 通过（证据:测试全绿）\n', 'utf8');
+  // 未涉及的家族（同为终态、超窗、零引用——但不在本次确认范围，须留守）
+  fs.writeFileSync(path.join(ip, '2026-09-01-other.md'), '---\n状态: done\n级别: L1\n---\n# I2\n\n## 验收标准（可测试）\n- [x] 通过（证据:测试全绿）\n', 'utf8');
+  git('add', '-A');
+  spawnSync(process.platform === 'win32' ? 'git.exe' : 'git', ['commit', '-q', '-m', 'c1'], { cwd: root, env: { ...process.env, GIT_AUTHOR_DATE: '2026-10-12T10:00:00+08:00', GIT_COMMITTER_DATE: '2026-10-12T10:00:00+08:00' } });
+  const r = spawnSync(process.execPath, [CLI, 'workflow/intents/2026-10-12-fresh.md', '--delegated', '可以'],
+    { cwd: root, encoding: 'utf8', env: { ...process.env, CONFIRM_DOC_TEST_NOW: '2026-10-13' } });
+  check('S44 本次确认家族即时归档（窗口对刚过确认门的终态件冗余）',
+    r.status === 0 && fs.existsSync(path.join(root, 'workflow', 'archive', '2026-10', 'intents', '2026-10-12-fresh.md')) && /📦 归档/.test(r.stdout),
+    JSON.stringify({ status: r.status, stdout: String(r.stdout).slice(-200), stderr: String(r.stderr).slice(-200) }));
+  check('S44b 未涉及的家族不越权清理（历史积压走 archive-sweep 手工批次）',
+    fs.existsSync(path.join(ip, '2026-09-01-other.md')),
+    JSON.stringify({ exists: fs.existsSync(path.join(ip, '2026-09-01-other.md')) }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
+// ---- S45 归档约定缺席 → 不启用（未采纳归档的仓库不凭空造目录）；env 逃生门 CONFIRM_DOC_NO_ARCHIVE ----
+{
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'confirm-arch3-'));
+  const git = (...a) => spawnSync(process.platform === 'win32' ? 'git.exe' : 'git', a, { cwd: root, encoding: 'utf8' });
+  git('init', '-q');
+  git('config', 'user.email', 't@t');
+  git('config', 'user.name', 't');
+  const ip = path.join(root, 'workflow', 'intents');
+  fs.mkdirSync(ip, { recursive: true });
+  fs.writeFileSync(path.join(ip, '2026-09-01-noconv.md'), '---\n状态: approved\n级别: L1\n确认指纹: cccc3333cccc3333\n---\n# I\n\n## 验收标准（可测试）\n- [x] 通过（证据:测试全绿）\n', 'utf8');
+  git('add', '-A');
+  spawnSync(process.platform === 'win32' ? 'git.exe' : 'git', ['commit', '-q', '-m', 'c1'], { cwd: root, env: { ...process.env, GIT_AUTHOR_DATE: '2026-09-01T10:00:00+08:00', GIT_COMMITTER_DATE: '2026-09-01T10:00:00+08:00' } });
+  const r = spawnSync(process.execPath, [CLI, 'workflow/intents/2026-09-01-noconv.md', '--delegated', '可以'],
+    { cwd: root, encoding: 'utf8', env: { ...process.env, CONFIRM_DOC_TEST_NOW: '2026-10-13' } });
+  check('S45 无 workflow/archive/ 约定 → 不归档、不造目录',
+    r.status === 0 && fs.existsSync(path.join(ip, '2026-09-01-noconv.md')) && !fs.existsSync(path.join(root, 'workflow', 'archive')) && !/📦 归档/.test(r.stdout),
+    JSON.stringify({ status: r.status, stdout: String(r.stdout).slice(-200) }));
+  // S45b 有归档约定 + CONFIRM_DOC_NO_ARCHIVE=1 → 逃生门生效（关单不归档）
+  const root2 = fs.mkdtempSync(path.join(os.tmpdir(), 'confirm-arch4-'));
+  const git2 = (...a) => spawnSync(process.platform === 'win32' ? 'git.exe' : 'git', a, { cwd: root2, encoding: 'utf8' });
+  git2('init', '-q');
+  git2('config', 'user.email', 't@t');
+  git2('config', 'user.name', 't');
+  const ip2 = path.join(root2, 'workflow', 'intents');
+  fs.mkdirSync(ip2, { recursive: true });
+  fs.mkdirSync(path.join(root2, 'workflow', 'archive'), { recursive: true });
+  fs.writeFileSync(path.join(ip2, '2026-09-01-optout.md'), '---\n状态: approved\n级别: L1\n确认指纹: dddd4444dddd4444\n---\n# I\n\n## 验收标准（可测试）\n- [x] 通过（证据:测试全绿）\n', 'utf8');
+  git2('add', '-A');
+  spawnSync(process.platform === 'win32' ? 'git.exe' : 'git', ['commit', '-q', '-m', 'c1'], { cwd: root2, env: { ...process.env, GIT_AUTHOR_DATE: '2026-09-01T10:00:00+08:00', GIT_COMMITTER_DATE: '2026-09-01T10:00:00+08:00' } });
+  const r2 = spawnSync(process.execPath, [CLI, 'workflow/intents/2026-09-01-optout.md', '--delegated', '可以'],
+    { cwd: root2, encoding: 'utf8', env: { ...process.env, CONFIRM_DOC_TEST_NOW: '2026-10-13', CONFIRM_DOC_NO_ARCHIVE: '1' } });
+  check('S45b CONFIRM_DOC_NO_ARCHIVE 逃生门：关单成功且不归档（状态已置 done）',
+    r2.status === 0 && /状态: done/.test(fs.readFileSync(path.join(ip2, '2026-09-01-optout.md'), 'utf8'))
+      && !fs.existsSync(path.join(root2, 'workflow', 'archive', 'intents')) && !/📦 归档/.test(r2.stdout),
+    JSON.stringify({ status: r2.status, stdout: String(r2.stdout).slice(-200) }));
+  fs.rmSync(root, { recursive: true, force: true });
+  fs.rmSync(root2, { recursive: true, force: true });
+}
+
 console.log(`\n合计: PASS ${pass} / FAIL ${fail}`);
 process.exit(fail ? 1 : 0);

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

@@ -32,7 +32,7 @@ if (!fs.existsSync(SRC)) {
   console.error(`doctor.test.mjs：SKIP——未找到 ${SRC}（装户环境无包源 src/；本套件仅在包源仓库/dogfooding 跑 npm test 时有意义）`);
   process.exit(0);
 }
-const { checkOwnedDrift, checkAdapterDrift, checkLedgerCoverage, checkDelegationSnapshotFreshness, checkGateAnchors, checkTemplateDrift, gateTrustOf, GATE_TRUST_LEVELS, GATE_TRUST_DEFAULT } = await import(pathToFileURL(SRC).href);
+const { checkOwnedDrift, checkAdapterDrift, checkLedgerCoverage, checkDelegationSnapshotFreshness, checkGateAnchors, checkTemplateDrift, checkLevelHints, gateTrustOf, GATE_TRUST_LEVELS, GATE_TRUST_DEFAULT } = await import(pathToFileURL(SRC).href);
 
 let pass = 0;
 let fail = 0;
@@ -723,5 +723,48 @@ const GATE_BODY = '// gate v1\n';
   }
 }
 
+// --- 场景 37-40：checkLevelHints（2026-10-13 hint-doctor）---
+// level-hints 配置此前**只**在 flow-kit route 时才校验，而 route 是可选调用 → 写错的清单能静默存活。
+// 本组直测三态：旧装户无判据单源 → skipped；配置合法（含默认空）→ ok；非法档位/ERE → ok=false。
+{
+  const mkHintsRoot = (hintsText) => {
+    const root = fs.mkdtempSync(path.join(os.tmpdir(), 'doctor-hints-'));
+    fs.mkdirSync(path.join(root, '.agents', 'scripts'), { recursive: true });
+    fs.copyFileSync(path.join(ROOT, 'templates/_agents/scripts/level-criteria.mjs'),
+      path.join(root, '.agents/scripts/level-criteria.mjs'));
+    if (hintsText !== null) fs.writeFileSync(path.join(root, '.agents/level-hints.txt'), hintsText);
+    return root;
+  };
+
+  {
+    const r = mkHintsRoot('L2 ^src/contracts/\nL3 ^src/db/migrations/.*\\.sql$\n');
+    const out = checkLevelHints(r);
+    check('场景 37：合法 hints → ok 且报条数与档位',
+      out.skipped === false && out.ok === true && /2 条有效/.test(out.note) && /L2/.test(out.note) && /L3/.test(out.note),
+      JSON.stringify(out));
+    fs.rmSync(r, { recursive: true, force: true });
+  }
+  {
+    const r = mkHintsRoot(null); // 缺文件＝默认空＝纯语义定级
+    const out = checkLevelHints(r);
+    check('场景 38：清单缺失（默认空）→ ok 且明示未配置', out.ok === true && out.skipped === false && out.note.length > 0, JSON.stringify(out));
+    fs.rmSync(r, { recursive: true, force: true });
+  }
+  {
+    const r = mkHintsRoot('L3 ^src/db/[bad(\n'); // 非法 ERE
+    const out = checkLevelHints(r);
+    check('场景 39：非法 ERE → ok=false 且带清单路径与行号',
+      out.ok === false && out.skipped === false && /level-hints/.test(out.detail) && /第 \d+ 行/.test(out.detail), JSON.stringify(out));
+    fs.rmSync(r, { recursive: true, force: true });
+  }
+  {
+    const r = fs.mkdtempSync(path.join(os.tmpdir(), 'doctor-hints-old-')); // 无判据单源＝旧装户
+    fs.mkdirSync(path.join(r, '.agents'), { recursive: true });
+    const out = checkLevelHints(r);
+    check('场景 40：无 level-criteria.mjs（1.7.15 前旧装户）→ skipped 不产出告警', out.skipped === true, JSON.stringify(out));
+    fs.rmSync(r, { recursive: true, force: true });
+  }
+}
+
 console.log(`\n合计: PASS ${pass} / FAIL ${fail}`);
 process.exit(fail ? 1 : 0);

package/templates/_agents/scripts/edit-face-check.mjs

@@ -4,7 +4,7 @@
 //   工作树编辑期零反馈（实测：常驻面重构砍掉阶段索引，到提交才被检查 7 报警）。本脚本把判定左移到编辑时。
 // 判定零复刻铁律：闭环判定**单源**复用 check-loop——以 CHECK_LOOP_ROOT=<root>（全扫模式，扫工作树
 //   非 HEAD）子进程消费其裁决，本脚本不实现任何门判定；唯一自算是常驻面字节预算 advisory（工作树
-//   LF 字节 vs rule-budgets.txt 上限——提交门口径走 git index/HEAD（rule-budget.sh），两者判据不同面，
+//   LF 字节 vs rule-budgets.txt 上限——提交门口径走 git index/HEAD（rule-budget.mjs），两者判据不同面，
 //   此处为编辑时 advisory，冲突时以提交门为准）。
 // exit 语义：check-loop hard（exit≠0）→ 2；预算 advisory 超限 → 1；其余 → 0。
 //   WARN **不进 exit**（打印明细供 AI/人对照）——绝对 WARN 计数会让带存量 advisory 的仓库恒非零
@@ -53,9 +53,11 @@ export function budgetAdvisory(files, budgetsText) {
 }
 
 // runCheck：工作树面 check-loop（CHECK_LOOP_ROOT 全扫）。返回 { code, output, ms }。
+// --all 显式全量（2026-10-13 分道后裸跑=默认硬门）：本工具的动机就是编辑期暴露卫生面 WARN
+// （如阶段索引漂移——头部动机段），硬门子集满足不了，须显式声明全量。
 function runCheck(root, scriptDir) {
   const t0 = Date.now();
-  const r = spawnSync(process.execPath, [path.join(scriptDir, 'check-loop.mjs')], {
+  const r = spawnSync(process.execPath, [path.join(scriptDir, 'check-loop.mjs'), '--all'], {
     cwd: root, encoding: 'utf8', windowsHide: true,
     env: { ...process.env, CHECK_LOOP_ROOT: root },
   });
@@ -84,7 +86,7 @@ export function main(root = process.cwd(), scriptDir = path.dirname(fileURLToPat
     if (/\[WARN /.test(line)) console.log('  ' + line.trim().slice(0, 200));
   }
   for (const { rel, limit, actual } of over) {
-    console.log(`  ⚠️ 预算 advisory：${rel} 工作树 ${actual}B > 上限 ${limit}B（编辑时口径；提交门以 rule-budget.sh 为准）`);
+    console.log(`  ⚠️ 预算 advisory：${rel} 工作树 ${actual}B > 上限 ${limit}B（编辑时口径；提交门以 rule-budget.mjs 为准）`);
   }
   if (ck.code !== 0) {
     console.error('❌ 闭环判定 hard 未过——先修复再提交（判定单源 check-loop，详见上方输出）');

package/templates/_agents/scripts/edit-face-check.test.mjs

@@ -36,16 +36,17 @@ check('globToRe：目录前缀', globToRe('.agents/cache/').test('.agents/cache/
 }
 
 // ---- ② 端到端 fixture ----
-const SCRIPTS = ['check-loop.mjs', 'policy.mjs', 'stage-gates.mjs', 'check-metric-claims.mjs', 'check-hygiene.mjs', 'check-stage-index.mjs', 'gate-seg.mjs', 'workflow-enums.mjs', 'edit-face-check.mjs'];
+// 夹具闭包（2026-10-12 fixture-closure-rootfix）：此前手写 SCRIPTS 枚举，漏拷 ledger-loader / ledger-prune
+// 就让 check-loop import 失败 → 门禁静默不跑 → **假绿**。改为按入口自动求传递闭包，新增依赖自动跟随。
+const { copyScriptClosure, copyAgentsFiles } = await import('./fixture-scripts.mjs');
 // 引用完整性哑文件（检查 4/6/7 的存在性判据——避免 fixture 结构性 WARN 淹没断言面）
 const REF_COMMANDS = ['new-task', 'plan', 'design', 'build', 'test', 'deploy', 'maintain', 'review'];
 const REF_ROLES = ['implementer', 'independent-reviewer', 'ui-verifier'];
 function mkFixture({ breakStageIndex, overBudget }) {
   const fx = fs.mkdtempSync(path.join(os.tmpdir(), 'efc-'));
   fs.mkdirSync(path.join(fx, '.agents', 'scripts'), { recursive: true });
-  for (const f of SCRIPTS) fs.copyFileSync(path.join(SRC, f), path.join(fx, '.agents', 'scripts', f));
-  for (const f of ['kit.json', 'workflow-modules.txt', 'workflow-enums.txt'])
-    if (fs.existsSync(path.join(SRC, '..', f))) fs.copyFileSync(path.join(SRC, '..', f), path.join(fx, '.agents', f));
+  copyScriptClosure(path.join(fx, '.agents', 'scripts'), ['edit-face-check.mjs', 'check-loop.mjs']);
+  copyAgentsFiles(path.join(fx, '.agents'), ['kit.json', 'workflow-modules.txt', 'workflow-enums.txt']);
   fs.mkdirSync(path.join(fx, 'workflow', 'intents'), { recursive: true });
   for (const d of ['specs', 'plans', 'incidents']) fs.mkdirSync(path.join(fx, 'workflow', d), { recursive: true });
   for (const c of REF_COMMANDS) { fs.mkdirSync(path.join(fx, '.agents', 'commands'), { recursive: true }); fs.writeFileSync(path.join(fx, '.agents', 'commands', `${c}.md`), `# ${c}\n`); }

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

@@ -1,5 +1,5 @@
 // flow-kit fill-intent：起草 intent 草稿（背景与问题/历史教训防复发/目标/非目标/约束/影响面/触达红线/验收标准 8 节正文 + 确认与复核 共 9 节）
-// 读 workflow/intents/_TEMPLATE.md 的节标题 → 输出符合 frontmatter 受限子集（6 字段，含 risk_level 风险泳道）的草稿到指定文件
+// 读 workflow/intents/_TEMPLATE.md 的节标题 → 输出符合 frontmatter 受限子集（7 字段，含 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';
@@ -33,18 +33,20 @@ const SECTIONS = [
   { 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 或 Quick-Plan 中说明）', hint: '- [ ] <按本项目 AGENTS.md 红线逐行补；无则删本行>\n- [ ] 规则 / 契约变更（编码权威 / 共享契约 / 接口签名 / 既有参数语义 / 全局口径）→ 级别至少 L2\n- [ ] schema / 迁移 SQL / DI 链 / 认证与中间件管线 → 级别 L3\n\n> 触及任一红线即为 L2 / L3，必须立 ../specs/YYYY-MM-DD-<主题>.md 写明如何满足，方可起草 plan。' },
+  { title: '影响面', hint: '- 模块：<词表之一，见 .agents/workflow-modules.txt>\n- 数据库：无 / <表名>（涉及 schema 变更 → L3；无 schema 的运行时 / 管线结构面亦为 L3，判据单源见 .agents/scripts/level-criteria.mjs 的 L3_SURFACES）\n- 前端页面：<路由或组件，无则删本行>' },
+  { title: '触达红线（对照 AGENTS.md，勾选仅标记触及范围；具体如何满足在同名 spec 或 Quick-Plan 中说明）', hint: '- [ ] <按本项目 AGENTS.md 红线逐行补；无则删本行>\n- [ ] 触及判据单源 `.agents/scripts/level-criteria.mjs` 的 `L2_SURFACES` 触达面闭集 → 级别至少 L2\n- [ ] 触及同源的 `L3_SURFACES` 结构面闭集 → 级别 L3\n\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。' },
 ];
 
 // renderIntent：骨架渲染（纯函数）。kbHits（2026-10-09 engine-quality-round3 W2）：kb-search 命中行
 // 数组（📄 行原文）——非空时替换「历史教训/防复发」节的检索占位行为实际命中列表（历史坑强制注入，
 // 手动路由与 pipeline-run 工单同权）；空/缺省保留占位（fail-open 口径）。子进程调用在 main，本函数保持无 IO。
+// 预判（2026-10-13 自 Shipyard §25 prejudgment-ledger 回灌）：intents≡require 恒真、level 与「级别」双写
+// 同值——机器可推导字段直出（与 B6b 路由预判一致性检查对账零 WARN）；advisory 灰度，缺字段零告警。
 export function renderIntent({ topic, module, level, notes, date = TODAY, kbHits = [], kbFailNote = '' }) {
   if (!LEVELS.includes(level)) throw new Error('level 不在枚举 ' + LEVELS.join('|') + '：' + level);
-  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';
+  const fm = '---\n状态: draft\n级别: ' + level + '\n预判: kind=require level=' + 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（严格枚举，附注写备注键）；级别∈L1/L2/L3（2026-10-13 L0 退役）；risk_level=级别（混合治理风险泳道选道：L1 协作道异步审计 / L2/L3 防御道同步确认）；check-loop 只扫 frontmatter 取机器字段，正文不再写状态/级别行 -->\n\n';
   for (const { title, hint } of SECTIONS) {
     let section = hint;
     if (title === '历史教训/防复发') {

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

@@ -71,13 +71,31 @@ function check(name, cond, detail = '') {
 
 // ---- 场景 8：risk_level 风险泳道字段（混合治理，= 级别，全枚举落 frontmatter）----
 {
-  for (const level of ['L0', 'L1', 'L2', 'L3']) {
+  for (const level of ['L1', 'L2', 'L3']) { // L0 已退役——L0 现走 renderIntent 抛「level 不在枚举」（S8b）
     const { body } = renderIntent({ topic: 't', module: 'pipeline', level });
     const fm = body.match(/^---([\s\S]*?)---/)[1];
     check('S8 risk_level=' + level + ' 写入 frontmatter', new RegExp('^risk_level:\\s*' + level + '$', 'm').test(fm));
   }
 }
 
+// ---- 场景 8b：L0 已退役（2026-10-13 自源仓收敛系列 1 回灌）→ renderIntent fail-loud ----
+{
+  let threw = '';
+  try { renderIntent({ topic: 't', module: 'pipeline', level: 'L0' }); } catch (e) { threw = e.message; }
+  check('S8b level=L0 → 抛 level 不在枚举 L1|L2|L3', threw.includes('level 不在枚举 L1|L2|L3'), threw);
+}
+
+// ---- 场景 9：预判键 scaffold（2026-10-13 自 Shipyard §25 prejudgment-ledger 回灌）----
+// intents≡require 恒真；level 与「级别」双写同值——与路由预判一致性检查对账零 WARN（advisory 灰度）
+{
+  for (const level of ['L1', 'L2', 'L3']) { // L0 已退役——L0 现走 renderIntent 抛「level 不在枚举」（S8b）
+    const { body } = renderIntent({ topic: 't', module: 'pipeline', level });
+    const fm = body.match(/^---([\s\S]*?)---/)[1];
+    check('S9 预判=' + level + ' scaffold（kind=require level=级别）',
+      new RegExp('^预判:\\s*kind=require level=' + level + '$', 'm').test(fm));
+  }
+}
+
 
 // ---- 历史坑注入 kbHits（2026-10-09 engine-quality-round3 W2）----
 {

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

@@ -1,7 +1,8 @@
 // flow-kit fill-plan：起草 plan 草稿（L1 Quick-Plan 三节 / L2-L3 完整 4 节）
 // 用法：node .agents/scripts/fill-plan.mjs --level L1 --topic "test" --output /tmp/x.md [--root <仓库根>]
 // L1：改动方案 + 约束与风险 + 验证计划（Quick-Plan 必填三节）
-// L2/L3：改动方案 + 任务拆解 + 执行顺序 + 验证计划
+// L1 直达（2026-10-13 自 Shipyard 回灌）：本 plan 即入口、不另立 intent；无同名 intent/incident 时起草门
+// 放行（--level L1）。修复类仍可另立 incident。L2/L3：改动方案 + 任务拆解 + 执行顺序 + 验证计划
 // 起草门（2026-09-30 stage-gate-machine）：output 落于工作区（路径含 workflow 段）时，须同主题入口已确认，
 // 且入口级别（取入口 frontmatter，非 --level）为 L2/L3 时同名 spec 已确认；未过 → 拒绝生成（exit 2）。
 import fs from 'node:fs';
@@ -27,14 +28,14 @@ function parseArgs(argv) {
 function fail(msg) { console.error('❌ ' + msg); process.exit(1); }
 
 const L1_SECTIONS = [
-  { title: '改动方案', hint: '- <文件/组件>：<做什么；判据细节直接写进条目，如「L771 message.success 改『更新成功』」>' },
+  { title: '改动方案', hint: '- <文件/组件>：<做什么；判据细节直接写进条目，如「L771 message.success 改『更新成功』」>\n\n> build.md 确认的改动清单确认后回填本节落盘（对话留痕仅供当次）——改动面 + 任务勾选态 + git status = 会话重入三锚（2026-10-11 session-context）。' },
   { title: '约束与风险', hint: '- 约束：<对照 AGENTS.md 红线，说明如何满足；不许动什么>\n- 风险：<潜在影响 / 破坏性风险>' },
   { title: '验证计划', hint: '- 静态门：项目构建命令（+ 项目测试命令，测试项目就绪后）\n- 前端：cd frontend && npm run build（vue-tsc）\n- UI：.agents/commands/test.md（涉及页面改动必走，headless Chrome 实测）\n- L2 追加：<契约 / 规则面比对：编码结果抽样 / 接口契约断言 / 口径对账>\n- L3 追加：<含 schema 变更：备份 + 回滚 SQL 就绪后执行；仅运行时 / 管线：回退上一 release tag + 配置开关预案>' },
 ];
 
 const FULL_SECTIONS = [
   L1_SECTIONS[0],
-  { title: '任务拆解（L2/L3 必填；L1 仅多文件多步骤时用，单任务微改动删本节）', hint: '1. <任务>\n   - 判据：<怎样算完成；尽量对应一个测试或可复现操作>\n   - 风险：低 / 中 / 高（<原因>）\n2. <任务>\n   - 判据：…\n   - 风险：…' },
+  { title: '任务拆解（L2/L3 必填；L1 仅多文件多步骤时用，单任务微改动删本节）', hint: '- [ ] 1. <任务>\n   - 判据：<怎样算完成；尽量对应一个测试或可复现操作>\n   - 风险：低 / 中 / 高（<原因>）\n   - 留痕：（勾选时回填 commit SHA / 测试名 / 实测输出）\n- [ ] 2. <任务>\n   - 判据：…\n   - 风险：…\n   - 留痕：…\n\n> 任务即勾选态（2026-10-11 session-context）：完成一项立刻勾选并回填留痕；压缩 / 新会话续作先读本表勾选态 + git status 重建进度，禁凭记忆补勾。' },
   { title: '执行顺序（L2/L3 必填；L1 单文件微改动删本节）', hint: '<1 → 2 → 3；标注依赖关系>' },
   L1_SECTIONS[2],
 ];
@@ -43,7 +44,10 @@ export function renderPlan({ topic, level = 'L1' }) {
   if (!LEVELS.includes(level)) throw new Error('level 不在枚举 ' + LEVELS.join('|') + '：' + level);
   const sections = level === 'L1' ? L1_SECTIONS : FULL_SECTIONS;
   const fm = '---\n状态: draft\n级别: ' + level + '\n模块: pipeline\n---\n';
-  let body = '# PLAN — ' + topic + '\n\n<!-- 与 intents/ 或 incidents/ 下同名入口文档配对；L2/L3 必须先有 ../specs/ 同名 spec 确认通过；AI 起草、用户对话内确认后开工 -->\n<!-- frontmatter 受限子集（2026-09-13）：状态∈draft/approved/done/superseded/cancelled；级别∈L0/L1/L2/L3；正文不再写状态/级别行 -->\n<!-- L1 快车道 (Quick-Plan)（2026-09-30 更新）：合并 Spec 与 Plan 核心。必填三节：[改动方案, 约束与风险, 验证计划]。仅多文件多步骤时保留任务拆解/执行顺序 -->\n\n对应入口：../intents/YYYY-MM-DD-<主题>.md 或 ../incidents/YYYY-MM-DD-<主题>.md（保留实际一项）\n对应 spec：../specs/YYYY-MM-DD-<主题>.md（L1 走快车道则省略）\n\n';
+  const entryLine = level === 'L1'
+    ? '对应入口：本 plan（L1 不再另立 intent）。修复类另保留 ../incidents/YYYY-MM-DD-<主题>.md\n对应 spec：省略（仅 L2/L3）\n\n'
+    : '对应入口：../intents/YYYY-MM-DD-<主题>.md 或 ../incidents/YYYY-MM-DD-<主题>.md（保留实际一项）\n对应 spec：../specs/YYYY-MM-DD-<主题>.md\n\n';
+  let body = '# PLAN — ' + topic + '\n\n<!-- 与 intents/ 或 incidents/ 下同名入口文档配对；L2/L3 必须先有 ../specs/ 同名 spec 确认通过；AI 起草、用户对话内确认后开工 -->\n<!-- frontmatter 受限子集（2026-09-13）：状态∈draft/approved/done/superseded/cancelled；级别∈L1/L2/L3（2026-10-13 L0 退役）；正文不再写状态/级别行 -->\n<!-- L1 快车道 (Quick-Plan)（2026-09-30 更新）：合并 Spec 与 Plan 核心。必填三节：[改动方案, 约束与风险, 验证计划]。仅多文件多步骤时保留任务拆解/执行顺序。L1 直达（2026-10-13 自 Shipyard 回灌）：本文件即入口，不另立 intent -->\n\n' + entryLine;
   for (const { title, hint } of sections) {
     body += '## ' + title + '\n\n' + hint + '\n\n';
   }
@@ -58,7 +62,7 @@ if (isMain) {
   if (!LEVELS.includes(a.level)) fail('level 必须在 ' + LEVELS.join('|') + '：' + a.level);
   const ws = resolveWorkspace(a.output, a.root);
   if (ws) {
-    const gate = draftGateFor('plan', ws.root, ws.base);
+    const gate = draftGateFor('plan', ws.root, ws.base, { level: a.level });
     if (!gate.ok) {
       console.error('❌ 起草门未过（stage-gates）：' + gate.reason);
       console.error('   ' + gate.hint + '——本份未生成（确认前置后重跑本命令）');
@@ -70,6 +74,6 @@ if (isMain) {
   const { body } = renderPlan(a);
   fs.mkdirSync(path.dirname(a.output), { recursive: true });
   fs.writeFileSync(a.output, body);
-  console.log('✅ 已生成 plan 草稿：' + a.output + '（状态 draft / 级别 ' + a.level + ' / ' + (a.level === 'L1' ? 'Quick-Plan 三节' : '完整 4 节') + '）');
+  console.log('✅ 已生成 plan 草稿：' + a.output + '（状态 draft / 级别 ' + a.level + ' / ' + (a.level === 'L1' ? 'Quick-Plan 三节（plan 即入口）' : '完整 4 节') + '）');
 }
 export default renderPlan;

package/templates/_agents/scripts/fill-plan.test.mjs

@@ -31,6 +31,10 @@ function check(name, cond, detail = '') {
   check('S2 L2 含节 ## 执行顺序', body.includes('## 执行顺序'));
   check('S2 L2 含节 ## 验证计划', body.includes('## 验证计划'));
   check('S2 L2 共 5 节（4 节 + 确认与复核）', sections.length === 5, '实际 ' + sections.length + ' 节');
+  // 任务即勾选态（2026-10-13 自 Shipyard 回灌 session-context）
+  check('S2 任务即勾选态：复选框编号形态', /- \[ \] 1\. <任务>/.test(body));
+  check('S2 任务即勾选态：留痕行', body.includes('留痕：（勾选时回填 commit SHA / 测试名 / 实测输出）'));
+  check('S2 任务即勾选态：三锚注释', body.includes('会话重入三锚'));
 }
 
 // ---- 场景 3：L3 与 L2 同结构 ----
@@ -86,10 +90,22 @@ const runTool = (root, base, level) => spawnSync(process.execPath,
   [CLI, '--topic', base, '--level', level, '--output', path.join(root, 'workflow', 'plans', `${base}.md`)],
   { cwd: root, encoding: 'utf8' });
 {
+  // S8（2026-10-13 自 Shipyard 回灌 L1 即入口）：无同名入口 + --level L1 → plan 自己就是入口，放行生成；
+  // 对照 S8b：L2 无同名入口仍拒（直达语义只对 L1 开）。
   const root = mkws();
   const r = runTool(root, '2026-09-30-none', 'L1');
-  check('S8 起草门：无同名入口 → exit 2 且零文件产出',
-    r.status === 2 && /起草门未过/.test(r.stderr) && !fs.existsSync(path.join(root, 'workflow', 'plans', '2026-09-30-none.md')),
+  const f = path.join(root, 'workflow', 'plans', '2026-09-30-none.md');
+  check('S8 L1 即入口：无同名入口 + --level L1 → 放行生成（plan 即入口）',
+    r.status === 0 && fs.existsSync(f)
+    && fs.readFileSync(f, 'utf8').includes('对应入口：本 plan（L1 不再另立 intent）'),
+    JSON.stringify({ status: r.status, stderr: r.stderr }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+{
+  const root = mkws();
+  const r = runTool(root, '2026-09-30-none2', 'L2');
+  check('S8b 起草门：无同名入口 + --level L2 → exit 2 且零文件产出（直达仅限 L1）',
+    r.status === 2 && /起草门未过/.test(r.stderr) && !fs.existsSync(path.join(root, 'workflow', 'plans', '2026-09-30-none2.md')),
     JSON.stringify({ status: r.status, stderr: r.stderr }));
   fs.rmSync(root, { recursive: true, force: true });
 }
@@ -113,7 +129,7 @@ const runTool = (root, base, level) => spawnSync(process.execPath,
   fs.rmSync(root, { recursive: true, force: true });
 }
 {
-  // S10b 探索泳道（2026-09-30 hybrid-governance-explore-hardening）：L0/L1 draft intent → 放行 plan 起草
+  // S10b 探索泳道（2026-09-30 hybrid-governance-explore-hardening）：L1 draft intent → 放行 plan 起草
   // （「先起草后确认」；收口由 check-loop --hardening 加固门兜底）
   const root = mkws({ 'workflow/intents/2026-09-30-exp.md': '---\n状态: draft\n级别: L1\nrisk_level: L1\n日期: 2026-09-30\n---\n# I\n' });
   const r = runTool(root, '2026-09-30-exp', 'L1');

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

@@ -1,4 +1,4 @@
-// flow-kit fill-spec：起草 spec 草稿（功能行为 / 数据流 / 系统改动 / 约束遵守映射 / 风险评估 共 5 节）
+// flow-kit fill-spec：起草 spec 草稿（功能行为 / 数据流 / 系统改动 / 约束遵守映射 / 验收判据 / 风险评估 共 6 节）
 // 用法：node .agents/scripts/fill-spec.mjs --topic "test" --output /tmp/x.md [--root <仓库根>]
 // 起草门（2026-09-30 stage-gate-machine）：output 落于工作区（路径含 workflow 段）时，须同主题入口已确认
 // （判定口径见 stage-gates.mjs）；未过 → 拒绝生成（exit 2）；仓外草稿（无 workflow 段）不校验。
@@ -30,15 +30,18 @@ const SECTIONS = [
   { title: '数据流', hint: '<请求→处理→持久化→回应的端到端路径；标出各环节涉及的服务 / 表 / 缓存 / 第三方调用>' },
   { title: '系统改动', hint: '<分模块列出本 spec 引入的所有改动；含新增 / 修改 / 删除；与 plan §改动面 一一对应>' },
   { title: '约束遵守映射', hint: '<逐条对照根 AGENTS.md 与目录级 AGENTS.md（如有）的红线 / 约束，说明本 spec 如何满足；逐条回应而非简单列举>' },
+  { title: '验收判据', hint: '<逐条登记可观察行为 × 证据（存在的文件路径，或全量门命令且 workflow/verify-evidence.md 有不早于本 spec 日期的全绿行）。人工走查状态写「人工」、证据留空（截图等图片路径不认；需留痕改存 .md 报告后引路径）。对账段不核对正文相关性>', table: true },
   { title: '风险评估', hint: '<列出本 spec 引入的风险点：数据 / 接口 / 性能 / 安全 / 回滚难度 / 用户影响；评估每个的等级与缓解措施>' },
 ];
 
 export function renderSpec({ topic, level = 'L2', date = TODAY }) {
   if (!LEVELS.includes(level)) throw new Error(`level 不在枚举 ${LEVELS.join('|')}：${level}`);
   const fm = `---\n状态: draft\n级别: ${level}\n日期: ${date}\n模块: pipeline\n备注: <spec 关联 intent / plan 的同名主题>\n---\n`;
-  let body = `# SPEC — ${topic}\n\n<!-- 与 intents/ 下同名入口文档配对；L2/L3 必须先有 ../intents/YYYY-MM-DD-<主题>.md approved -->\n<!-- frontmatter 受限子集（2026-09-13）：状态∈draft/approved/done/superseded/cancelled；级别∈L0/L1/L2/L3；正文不再写状态/级别行 -->\n\n`;
-  for (const { title, hint } of SECTIONS) {
+  let body = `# SPEC — ${topic}\n\n<!-- 与 intents/ 下同名入口文档配对；L2/L3 必须先有 ../intents/YYYY-MM-DD-<主题>.md approved -->\n<!-- frontmatter 受限子集（2026-09-13）：状态∈draft/approved/done/superseded/cancelled；级别∈L1/L2/L3（2026-10-13 L0 退役）；正文不再写状态/级别行 -->\n\n`;
+  for (const { title, hint, table } of SECTIONS) {
     body += `## ${title}\n\n${hint}\n\n`;
+    // 验收判据是对账段（B6b 落地后编号以 check-loop.mjs 头部清单为准）的机器输入：直出表骨架（表头签名固定，作者只填行——占位行被检查豁免）
+    if (table) body += `| 判据（可观察行为） | 证据（测试文件 / 命令 / 证据文件） | 状态 |\n|---|---|---|\n| <行为 1> | <路径或命令> | <覆盖 / 未覆盖 / 人工> |\n\n`;
   }
   body += `## 确认与复核\n\n- 确认日期：\n- 复核：L3 必须独立复核（independent-reviewer，新会话）；L2 推荐独立复核；L1 可省\n`;
   return { frontmatter: fm, body: fm + body, sections: SECTIONS.map((s) => s.title) };

package/templates/_agents/scripts/fill-spec.test.mjs

@@ -12,12 +12,20 @@ function check(name, cond, detail = '') {
   else { failCount++; console.log('FAIL ' + name + (detail ? '——' + detail : '')); }
 }
 
-// ---- 场景 1：5 节正文齐 ----
+// ---- 场景 1：6 节正文齐 ----
 {
   const { body } = renderSpec({ topic: 'test', level: 'L2' });
-  const expectedSections = ['功能行为', '数据流', '系统改动', '约束遵守映射', '风险评估', '确认与复核'];
+  const expectedSections = ['功能行为', '数据流', '系统改动', '约束遵守映射', '验收判据', '风险评估', '确认与复核'];
   for (const s of expectedSections) check('S1 含节 ## ' + s, body.includes('## ' + s));
-  check('S1 共 6 节标题', (body.match(/^##\s/gm) || []).length === 6);
+  check('S1 共 7 节标题', (body.match(/^##\s/gm) || []).length === 7);
+}
+
+// ---- 场景 1b：验收判据表骨架（2026-10-13 自 Shipyard 回灌——对账段机器输入，表头签名固定）----
+{
+  const { body } = renderSpec({ topic: 't', level: 'L2' });
+  check('S1b 验收判据表头三列签名', body.includes('| 判据（可观察行为） | 证据（测试文件 / 命令 / 证据文件） | 状态 |'));
+  check('S1b 验收判据表分隔行', body.includes('|---|---|---|'));
+  check('S1b 验收判据占位行', body.includes('| <行为 1> | <路径或命令> | <覆盖 / 未覆盖 / 人工> |'));
 }
 
 // ---- 场景 2：frontmatter 含 5 字段 ----
@@ -94,7 +102,7 @@ const runTool = (root, base) => spawnSync(process.execPath,
   fs.rmSync(root, { recursive: true, force: true });
 }
 {
-  // S9b 探索泳道（2026-09-30 hybrid-governance-explore-hardening）：L0/L1 draft intent → 放行 spec 起草
+  // S9b 探索泳道（2026-09-30 hybrid-governance-explore-hardening）：L1 draft intent → 放行 spec 起草
   // （「先起草后确认」；L2/L3 防御道维持入口确认前置——S9 照旧）
   const root = mkws({ entryFile: 'intents/2026-09-30-exp.md', entryBody: '---\n状态: draft\n级别: L1\nrisk_level: L1\n日期: 2026-09-30\n---\n# I\n' });
   const r = runTool(root, '2026-09-30-exp');