agentic-flow-kit 1.7.15 → 1.8.0

package/templates/_agents/scripts/papercut-debt-sensor.mjs

@@ -0,0 +1,170 @@
+#!/usr/bin/env node
+// papercut-debt-sensor.mjs — papercut 存量债传感器（2026-10-07 papercut-debt 回路 Phase D；B10a 自
+//   Shipyard.Material 回灌——判定面逐字对齐，出处沿革留痕在包源仓 git 历史与 CHANGELOG）
+// 用途：测量设定点误差——workflow/papercuts.md 中未升级条目数（debt）。只读、零子进程、可重复。
+// 口径单源：.agents/loop/papercut-debt/DESIGN.md §1/§2（改口径先改设计文件，本脚本只实现）。
+//   未升级 = 台账数据行不含 ✅ 字面量。⏸ 暂缓 视为**未升级**（暂缓须带理由，无理由照算债）。
+// 零子进程理由（实测留痕在包源仓 git 历史与 CHANGELOG）：曾有托管 Node 环境 spawnSync 对任意 exe
+//   返回 EBUSY，依赖 git 历史的传感器在该环境不可用（check-loop.mjs 即因此崩过）。故本脚本只读
+//   文件系统——传感器不依赖子进程比依赖更稳，且免受环境回退影响。
+// CRLF：台账检出为 CRLF（全局 core.autocrlf=true），按 split(/\r?\n/) 切行，不依赖行尾格式。
+// 分片感知（B8 已落 ledger-shards）：读侧走 readLedgerText(root,'papercuts')——主台账 ∪
+//   papercuts.d/*.md 自动合并，无分片时等价原读法，传感器零额外逻辑。
+// 用法：node .agents/scripts/papercut-debt-sensor.mjs [--json] [--root <仓库根>]
+// 退出码恒 0——测量失败不该阻断回路；失败时 stderr 出 [ERROR] 行且 debt 记为 null。
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { readLedgerText } from './ledger-shards.mjs';
+
+const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
+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 asJson = argv.includes('--json');
+const ROOT = path.resolve(argOf('--root') || path.join(SCRIPT_DIR, '..', '..'));
+const LEDGER = path.join(ROOT, 'workflow', 'papercuts.md');
+
+// 表格列：| 日期 | 位置 | 症状 | 拟修 |  → 切分后 6 段（首尾空串）
+const COLS = 4;
+// 判定口径（单源，本文件）：台账表格行中含 `✅` 者计为**已消债**（真修完）。
+//   `⏸ 暂缓（日期）：理由` 者计为**已定性**——债已被人读过并判失效，不再驱动回路，
+//   但与 ✅ 分开计数，避免"暂缓"冒充"修完"。`⏸ 暂缓` 无理由者仍计债（迫使人真读一遍）。
+const DONE = '✅';
+const DEFER = '⏸';
+export const DEFER_REASONED_RE = /⏸\s*暂缓（[^）]*）\s*：\s*\S/;
+const DEFER_REASONED = DEFER_REASONED_RE;
+// 「位置」列里抽仓库相对路径做存在性检查；只标 stale 不排除（台账记历史事实，路径改名/删除是常态）
+const PATH_RE = /(?:^|[\s(（`])([.a-zA-Z0-9_][\w./-]*\/[\w./-]+)(?=[\s)）`:：,，]|$)/g;
+
+function parseRow(line) {
+  const parts = line.split('|');
+  // 单元格内可能含 | （代码片段）——多于 COLS+2 段时把中间段并回症状列
+  let cells;
+  if (parts.length > COLS + 2) {
+    const head = parts.slice(1, 3);
+    const tail = parts.slice(-(COLS - 2));
+    cells = [...head, parts.slice(3, parts.length - (COLS - 2)).join('|').trim(), ...tail];
+  } else {
+    cells = parts.slice(1, 1 + COLS).map((s) => s.trim());
+  }
+  while (cells.length < COLS) cells.push('');
+  return { date: cells[0], location: cells[1], symptom: cells[2], proposedFix: cells[3] };
+}
+
+function detectHitCount(text) {
+  // 台账约定：复发时在文本里写「第 2 次命中」「第 3 次命中」——控制器的主排序键
+  let max = 1;
+  for (const m of String(text).matchAll(/第\s*(\d+)\s*次命中/g)) {
+    const n = Number(m[1]);
+    if (Number.isFinite(n) && n > max) max = n;
+  }
+  return max;
+}
+
+function extractPaths(location) {
+  const out = new Set();
+  for (const m of String(location).matchAll(PATH_RE)) {
+    const p = m[1].replace(/[.,;:]+$/, '');
+    if (p.startsWith('.') || p.startsWith('wiki/') || p.startsWith('tmp/')) out.add(p);
+  }
+  return [...out];
+}
+
+// scan(root) 是控制器 import 的解析面——判定口径单源在此，控制器不复制任何判定正则。
+// 「位置」列 [env] 前缀 = 环境约束类（DESIGN §1）：不进债池（scan 不返回），单列 envPending。
+export function scan(root = ROOT) {
+  return parseLedger(root).rows;
+}
+
+// 环境约束挂起（[env] 前缀行）：仅列未 settled 的——写 ⏸ 前提消失 / ✅ 的 env 行已清，不占任何池。
+export function envPending(root = ROOT) {
+  return parseLedger(root).envRows.filter((r) => !r.settled);
+}
+
+function parseLedger(root) {
+ const ledger = path.join(root, 'workflow', 'papercuts.md');
+ if (!fs.existsSync(ledger)) throw new Error(`台账不存在: ${ledger}`);
+ // 分片感知读（B8 ledger-shards）：主台账 ∪ papercuts.d/*.md；无分片时等价原读法
+ const raw = readLedgerText(root, 'papercuts');
+ const lines = raw.split(/\r?\n/);
+  const rows = [];
+  const envRows = [];
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    if (!/^\|\s*20\d\d-\d\d-\d\d/.test(line)) continue; // 只取数据行（表头/分隔行/说明行自然排除）
+    const c = parseRow(line);
+    const resolved = line.includes(DONE);
+    const deferred = line.includes(DEFER);
+    const deferredReasoned = DEFER_REASONED.test(line);
+    const paths = extractPaths(c.location);
+    const item = {
+      line: i + 1,
+      date: c.date,
+      location: c.location,
+      symptom: c.symptom,
+      proposedFix: c.proposedFix,
+      hits: detectHitCount(`${c.symptom} ${c.proposedFix}`),
+      resolved,
+      deferred,
+      deferredReasoned,
+      // 「已消债」= 真修完，或已带理由判失效。驱动回路的是这个口径，不是 resolved。
+      settled: resolved || deferredReasoned,
+      stale: paths.length > 0 && paths.every((p) => !fs.existsSync(path.join(root, p))),
+      paths,
+    };
+    (/^\s*`?\[env\]/.test(c.location) ? envRows : rows).push(item);
+  }
+  return { rows, envRows };
+}
+
+function main() {
+  let rows;
+  try {
+    rows = scan();
+  } catch (e) {
+    console.error(`[ERROR] papercut-debt-sensor: ${e.message}`);
+    if (asJson) console.log(JSON.stringify({ error: e.message, debt: null, total: null }, null, 2));
+    return;
+  }
+  const resolved = rows.filter((r) => r.resolved);
+  const settled = rows.filter((r) => r.settled);
+  const unresolved = rows.filter((r) => !r.settled);
+  const stale = unresolved.filter((r) => r.stale);
+  const env = envPending();
+
+  if (asJson) {
+    console.log(JSON.stringify({
+      ledger: path.relative(ROOT, LEDGER).split(path.sep).join('/'),
+      total: rows.length + env.length,
+      resolved: resolved.length,
+      deferredReasoned: settled.filter((r) => r.deferredReasoned).length,
+      settled: settled.length,
+      debt: unresolved.length,
+      envPending: env.map(({ line, date, location, symptom }) => ({ line, date, location, symptom })),
+      stalePaths: stale.length,
+      unresolved: unresolved.map(({ resolved: _r, settled: _s, ...rest }) => rest),
+    }, null, 2));
+    return;
+  }
+
+  console.log(`papercut 存量债 —— ${path.relative(ROOT, LEDGER).split(path.sep).join('/')}`);
+  console.log(`条目 ${rows.length + env.length} · 已消债 ${settled.length}（✅ ${resolved.length} / ⏸带理由 ${settled.filter((r) => r.deferredReasoned).length}） · 未消债 ${unresolved.length}（设定点误差 = debt）`);
+  if (env.length) console.log(`环境约束挂起 ${env.length} 条（[env] 前缀，不计 debt——环境变化后复测前提：消失则 ⏸，实为代码缺陷则去前缀转正）`);
+  if (unresolved.length === 0) {
+    console.log('✅ debt = 0，设定点已达成——无需再跑回路。');
+    return;
+  }
+  const noReason = unresolved.filter((r) => r.deferred && !r.deferredReasoned);
+  if (noReason.length) console.log(`其中 ⏸ 暂缓但无理由 ${noReason.length} 条（不算消债）`);
+  if (stale.length) console.log(`其中位置列路径已不存在 ${stale.length} 条（stale——台账记历史事实，不自动排除）`);
+  console.log('');
+  for (const r of unresolved) {
+    const flags = [r.hits > 1 ? `第${r.hits}次命中` : '', r.deferred ? '暂缓无理由' : '', r.stale ? 'stale' : ''].filter(Boolean).join(' · ');
+    console.log(`  L${r.line} [${r.date}] ${r.location}${flags ? `  (${flags})` : ''}`);
+  }
+  console.log('');
+  console.log('下一步：node .agents/scripts/papercut-debt-controller.mjs   # 选本轮目标（--dry-run 只看不改）');
+}
+
+// 仅直接执行时跑（被控制器 / 测试 import 时不自跑、不打印——控制器只取 scan()）
+if (process.argv[1] && process.argv[1].replace(/\\/g, '/').endsWith('papercut-debt-sensor.mjs')) main();

package/templates/_agents/scripts/papercut-debt-sensor.test.mjs

@@ -0,0 +1,146 @@
+#!/usr/bin/env node
+// papercut-debt-sensor.test.mjs — 存量债传感器 fixture（B10a 自源仓回灌随件测试；源仓无直测，
+//   kit 侧按「新增引擎脚本默认必须带同名 .test.mjs」立——判定面与传感器单源，防再同步漂移）
+// 覆盖：三态计数（未升级 / ✅ 已消债 / ⏸ 暂缓无理由仍计债）/ ⏸带理由消债 / [env] 前缀单列 envPending
+//   不入债池 / 命中次数抽取 / stale 只标不排 / 分片合并读（主台账 ∪ papercuts.d）/ CRLF 容忍 /
+//   管道符并回症状列 / CLI 退出码恒 0（含台账缺失）与 --json 形状
+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';
+import { scan, envPending, DEFER_REASONED_RE } from './papercut-debt-sensor.mjs';
+
+const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
+const CLI = path.join(SCRIPT_DIR, 'papercut-debt-sensor.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 mkroot = () => {
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'papercut-sensor-'));
+  fs.mkdirSync(path.join(root, 'workflow'), { recursive: true });
+  return root;
+};
+const HEADER = '| 日期 | 位置 | 症状 | 拟修 |\n|------|------|------|------|\n';
+const writeLedger = (root, text) => fs.writeFileSync(path.join(root, 'workflow', 'papercuts.md'), text, 'utf8');
+
+// ---- S1 三态计数：未升级 / ✅ 已消债 / ⏸ 暂缓无理由仍计债；⏸带理由消债 ----
+{
+  const root = mkroot();
+  writeLedger(root, HEADER
+    + '| 2026-10-01 | `.agents/commands/build.md` | 症状甲 | 拟修甲 |\n'
+    + '| 2026-10-02 | `.agents/commands/test.md` | 症状乙 | 拟修乙 ✅ 已升级修复(2026-10-03): 已改 |\n'
+    + '| 2026-10-03 | `.agents/scripts/x.mjs` | 症状丙 | 拟修丙 ⏸ 暂缓无理由 |\n'
+    + '| 2026-10-04 | `.agents/scripts/y.mjs` | 症状丁 | 拟修丁 ⏸ 暂缓（2026-10-05）：前提已消失，判失效 |\n');
+  const rows = scan(root);
+  check('S1a 数据行 4 条全入池（env 无）', rows.length === 4, `len=${rows.length}`);
+  check('S1b 未升级计债', rows.filter((r) => !r.settled).length === 2, JSON.stringify(rows.map((r) => r.settled)));
+  check('S1c ✅ 判已消债', rows[1].resolved === true && rows[1].settled === true);
+  check('S1d ⏸ 无理由仍计债（deferred 但不 settled）', rows[2].deferred === true && rows[2].deferredReasoned === false && rows[2].settled === false);
+  check('S1e ⏸带理由判消债', rows[3].deferredReasoned === true && rows[3].settled === true);
+  check('S1f DEFER_REASONED_RE 形态：全角括号+全角冒号+非空理由', DEFER_REASONED_RE.test('⏸ 暂缓（2026-10-05）：理由 X') && !DEFER_REASONED_RE.test('⏸ 暂缓无理由'));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
+// ---- S2 [env] 前缀：不进债池、单列 envPending（仅未 settled）----
+{
+  const root = mkroot();
+  writeLedger(root, HEADER
+    + '| 2026-10-01 | `[env] 无外网装不上依赖` | 症状戊 | 拟修戊 |\n'
+    + '| 2026-10-02 | `[env] 本机时区漂移` | 症状己 | 拟修己 ⏸ 暂缓（2026-10-03）：前提已消失 |\n'
+    + '| 2026-10-03 | `.agents/scripts/z.mjs` | 症状庚 | 拟修庚 |\n');
+  const rows = scan(root);
+  const env = envPending(root);
+  check('S2a [env] 行不进债池', rows.length === 1 && rows[0].symptom === '症状庚', JSON.stringify(rows.map((r) => r.symptom)));
+  check('S2b envPending 只列未 settled 的 env 行', env.length === 1 && env[0].symptom === '症状戊', JSON.stringify(env.map((r) => r.symptom)));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
+// ---- S3 命中次数抽取（症状/拟修文本「第 N 次命中」，取最大）----
+{
+  const root = mkroot();
+  writeLedger(root, HEADER
+    + '| 2026-10-01 | `.agents/commands/build.md` | 第 2 次命中：症状辛 | 拟修辛 |\n'
+    + '| 2026-10-02 | `.agents/commands/build.md` | 症状壬 | 拟修壬（第 3 次命中） |\n');
+  const rows = scan(root);
+  check('S3a 第 2 次命中抽出', rows[0].hits === 2, `hits=${rows[0].hits}`);
+  check('S3b 多处命中取最大且默认 1', rows[1].hits === 3, `hits=${rows[1].hits}`);
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
+// ---- S4 stale 只标不排：位置列路径不存在 → stale true；存在 → false ----
+{
+  const root = mkroot();
+  fs.mkdirSync(path.join(root, '.agents', 'scripts'), { recursive: true });
+  fs.writeFileSync(path.join(root, '.agents', 'scripts', 'real.mjs'), '// x\n', 'utf8');
+  writeLedger(root, HEADER
+    + '| 2026-10-01 | `.agents/scripts/real.mjs` | 症状子 | 拟修子 |\n'
+    + '| 2026-10-02 | `.agents/scripts/gone.mjs` | 症状丑 | 拟修丑 |\n');
+  const rows = scan(root);
+  check('S4a 路径存在 → stale false', rows[0].stale === false);
+  check('S4b 路径不存在 → stale true（仍留在 unresolved）', rows[1].stale === true && rows.length === 2);
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
+// ---- S5 分片合并读：主台账 ∪ papercuts.d/*.md（B8 ledger-shards 读侧单源）----
+{
+  const root = mkroot();
+  fs.mkdirSync(path.join(root, 'workflow', 'papercuts.d'), { recursive: true });
+  writeLedger(root, '# 命令/技能 Papercut 留痕\n\n' + HEADER
+    + '| 2026-10-01 | `.agents/commands/build.md` | 主表症状 | 主表拟修 |\n');
+  fs.writeFileSync(path.join(root, 'workflow', 'papercuts.d', '2026-09.md'),
+    HEADER + '| 2026-09-01 | `.agents/commands/test.md` | 分片症状 | 分片拟修 |\n', 'utf8');
+  const rows = scan(root);
+  check('S5a 分片行并入扫描面', rows.length === 2, JSON.stringify(rows.map((r) => r.symptom)));
+  check('S5b 分片行判定照常（未升级计债）', rows.filter((r) => !r.settled).length === 2);
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
+// ---- S6 CRLF 容忍 + 管道符并回症状列 ----
+{
+  const root = mkroot();
+  writeLedger(root, HEADER.replace(/\n/g, '\r\n')
+    + '| 2026-10-01 | `.agents/scripts/w.mjs` | 症状含管道 `a|b` 续 | 拟修寅 |\r\n');
+  const rows = scan(root);
+  check('S6a CRLF 台账照常解析', rows.length === 1, JSON.stringify(rows));
+  // 源仓口径钉死：并回分支只 trim 症状列（中间段），拟修列（尾部段）不 trim——逐字保留
+  check('S6b 单元格内管道符并回症状列（拟修列含原文即可）', rows[0].symptom.includes('a|b') && rows[0].proposedFix.includes('拟修寅'),
+    JSON.stringify({ symptom: rows[0].symptom, proposedFix: rows[0].proposedFix }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
+// ---- S7 CLI：退出码恒 0（正常 / 台账缺失），--json 形状 ----
+{
+  const root = mkroot();
+  writeLedger(root, HEADER + '| 2026-10-01 | `.agents/commands/build.md` | 症状卯 | 拟修卯 |\n');
+  const r1 = spawnSync(process.execPath, [CLI, '--json', '--root', root], { encoding: 'utf8' });
+  const j1 = JSON.parse(r1.stdout || '{}');
+  check('S7a 正常：exit 0 + debt 计数', r1.status === 0 && j1.debt === 1 && j1.total === 1 && j1.resolved === 0,
+    JSON.stringify({ status: r1.status, debt: j1.debt }));
+  check('S7b --json unresolved 带行号与命中数', j1.unresolved?.[0]?.line >= 1 && j1.unresolved?.[0]?.hits === 1, JSON.stringify(j1.unresolved));
+  const r2 = spawnSync(process.execPath, [CLI, '--root', root], { encoding: 'utf8' });
+  check('S7c 人读摘要 exit 0 且含 debt 行', r2.status === 0 && /未消债 1/.test(r2.stdout), String(r2.stdout).slice(0, 200));
+
+  const empty = mkroot();
+  const r3 = spawnSync(process.execPath, [CLI, '--json', '--root', empty], { encoding: 'utf8' });
+  const j3 = JSON.parse(r3.stdout || '{}');
+  check('S7d 台账缺失：exit 恒 0 + [ERROR] + debt null（测量失败不阻断回路）',
+    r3.status === 0 && j3.debt === null && /\[ERROR\] papercut-debt-sensor/.test(r3.stderr),
+    JSON.stringify({ status: r3.status, stderr: String(r3.stderr).slice(0, 120) }));
+  fs.rmSync(root, { recursive: true, force: true });
+  fs.rmSync(empty, { recursive: true, force: true });
+}
+
+// ---- S8 kit 适配钉子：读侧必须走 ledger-shards（分片消费）——防再同步回退成裸读主台账 ----
+{
+  const src = fs.readFileSync(CLI, 'utf8');
+  check('S8a 传感器经 readLedgerText 读台账（分片感知）', /readLedgerText\(root,\s*'papercuts'\)/.test(src));
+  check('S8b 零子进程约束：不 import child_process', !/child_process/.test(src));
+}
+
+console.log(`\n合计: PASS ${pass} / FAIL ${fail}`);
+process.exit(fail ? 1 : 0);

package/templates/_agents/scripts/pipeline-run.mjs

@@ -21,7 +21,7 @@ import path from 'node:path';
 import { spawnSync } from 'node:child_process';
 
 const KINDS = ['require', 'fix', 'verify', 'review', 'deploy'];
-const LEVELS = ['L0', 'L1', 'L2', 'L3'];
+const LEVELS = ['L1', 'L2', 'L3']; // L0 已退役（2026-10-13 自源仓收敛系列 1 回灌）——级别三档，L1 = 一份 plan 即入口
 const TERMINAL = ['done', 'superseded', 'cancelled', 'closed'];
 const FIX_CAP = 3;
 const GIT_NEVER_FLAGS = ['--no-verify', '-n']; // 不变量：任何 git 调用不得携带（防御性断言，正常路径不会拼出）
@@ -122,7 +122,7 @@ export function stageBar(run) {
         : [['Plan', ['intent-fill', 'intent-draft', 'intent-confirm', 'incident-fill', 'incident-draft', 'incident-confirm', 'triage'].includes(s)],
           ['Design', ['spec-fill', 'spec-draft', 'spec-review', 'spec-confirm'].includes(s)],
           ['Build', ['plan-fill', 'plan-draft', 'plan-confirm', 'changes-confirm', 'implement', 'fix', 'changes-verify'].includes(s)],
-          ['Test', ['verify', 'review', 'closeout', 'done-confirm', 'incident-fixed-confirm', 'incident-closed-confirm', 'direct-commit', 'direct-edit'].includes(s) || s === 'done']];
+          ['Test', ['verify', 'review', 'closeout', 'done-confirm', 'incident-fixed-confirm', 'incident-closed-confirm', 'direct-commit'].includes(s) || s === 'done']];
   const curIdx = seq.findIndex(([, cur]) => cur);
   return seq.map(([name], i) => mk(name, i < curIdx ? 'past' : i === curIdx ? 'cur' : 'future')).join(' ');
 }
@@ -271,7 +271,9 @@ function changedFiles(ctx, run) {
 }
 
 // 脚本自身管理的运行态路径——confirm/gate/gen-index 副产物，不属宿主越权面（沙箱演练实证，2026-10-02）
-const RUNTIME_OWNED = ['.agents/cache/', '.agents/confirmations.jsonl', 'workflow/INDEX.md'];
+// confirmations.d/ 亦为运行态副产物（2026-10-12 ledger-shard-write 的 `--shard` 写入面）——
+// 不加会让 --shard 的确认行被沙箱越权检查误判为「宿主改了台账」。
+const RUNTIME_OWNED = ['.agents/cache/', '.agents/confirmations.jsonl', '.agents/confirmations.d/', 'workflow/INDEX.md'];
 
 function checkAuthorized(ctx, run, filesCsv) {
   const listed = String(filesCsv || '').split(/[,，]/).map((s) => s.trim().replace(/\\/g, '/')).filter(Boolean);
@@ -338,9 +340,9 @@ function advance(ctx, run, opt) {
           issueWO(ctx, run, wo(run, {
             kind: 'triage', title: '判级与分类', goal: '读需求与 new-task.md 判级闭集，输出 kind/level/module/topic',
             instructions: [
-              '1. 读 .agents/commands/new-task.md §级别判断（L2 触达面闭集 / L1 默认档 / L3 结构面）',
+              '1. 读 .agents/scripts/level-criteria.mjs 判据单源（L2_SURFACES 触达面闭集 / L1 默认档 / L3_SURFACES 结构面；new-task.md 只承载流程表，判据一律看单源；机器面可先跑 `flow-kit route --kind require` 取路径下限提示）',
               `2. 对需求定级：「${run.requirement}」${run.hint ? `（预判参考：${run.hint}）` : ''}`,
-              '3. 回填：next --triage "kind=require|fix|verify|review|deploy level=L0-L3 module=<词表> topic=<英文kebab>"',
+              '3. 回填：next --triage "kind=require|fix|verify|review|deploy level=L1-L3 module=<词表> topic=<英文kebab>"',
             ],
             context: { docPath: '.agents/commands/new-task.md', kbHits: [], stderrTail: '', relatedDocs: ['workflow/INDEX.md'] },
             constraints: ['判级就高不就低；勾红线必 L2+；module 取 .agents/workflow-modules.txt 词表'],
@@ -358,8 +360,7 @@ function advance(ctx, run, opt) {
         run.docs = run.docs || { entry: null, spec: null, plan: null };
         // 路由
         run.stage = K() === 'verify' ? 'verify' : K() === 'review' ? 'review-only' : K() === 'deploy' ? 'deploy-check'
-          : K() === 'require' && L() === 'L0' ? 'direct-edit'
-            : K() === 'fix' ? 'incident-fill' : 'intent-fill';
+          : K() === 'fix' ? 'incident-fill' : 'intent-fill';
         continue;
       }
       run.stage = 'intent-fill'; continue;
@@ -487,7 +488,7 @@ function advance(ctx, run, opt) {
       const rel = `workflow/plans/${today()}-${topic()}.md`;
       run.docs.plan = rel;
       if (!docState(ctx, rel)) {
-        const r = runNode(ctx, run, 'fill-plan.mjs', ['--level', L() === 'L0' ? 'L1' : L(), '--topic', topic(), '--output', rel]);
+        const r = runNode(ctx, run, 'fill-plan.mjs', ['--level', L(), '--topic', topic(), '--output', rel]);
         if (r.exit !== 0) stopGateFail(ctx, run, s, [`fill-plan exit ${r.exit}（G1 前置门或参数）：${(r.stderr || r.stdout).split(/\r?\n/).slice(-3).join(' | ')}`]);
       }
       run.stage = 'plan-draft';
@@ -665,22 +666,7 @@ function advance(ctx, run, opt) {
       stopConfirm(ctx, run, rest[0], `${label}——逐份原话，一次一份（余 ${rest.length} 份）`, true);
     }
 
-    if (s === 'direct-edit') {
-      if (!opt.files) {
-        issueWO(ctx, run, wo(run, {
-          kind: 'implement', title: `L0 直改：${briefReq(run)}`, goal: 'docs/样式微调，无行为影响——直接改后提交',
-          instructions: ['1. 按需求直接修改目标文件', '2. 完成后回填：next --files "…"（脚本核对改动面并走 pre-commit 提交）'],
-          context: { docPath: '', kbHits: run.lastKbHits || [], stderrTail: '', relatedDocs: [] },
-          constraints: ['L0 语义：无行为影响；越此范围=判级错误，停机上报改判'],
-          acceptance: ['git 改动 ⊆ 回填清单', 'pre-commit 门通过'],
-        }), 'direct-edit');
-      }
-      const a = checkAuthorized(ctx, run, opt.files);
-      if (!a.ok) stopGateFail(ctx, run, s, a.problems);
-      const c = docsCommit(ctx, run, run.lastFiles, `docs(${run.triage.module}): ${briefReq(run)}（L0，pipeline-run ${run.runId}）`);
-      if (!c.ok) stopGateFail(ctx, run, s, [c.msg]);
-      stopDone(ctx, run);
-    }
+    // direct-edit 分支随 L0 退役删除（2026-10-13 自源仓收敛系列 1 回灌）——最低档 L1 走 intent+plan 闭环。
 
     if (s === 'verify-only') { run.stage = 'verify'; continue; }
     if (s === 'review-only') {

package/templates/_agents/scripts/pipeline-run.test.mjs

@@ -47,7 +47,7 @@ console.log('✅ intent 草稿：' + out);
 fs.writeFileSync(out, body);
 console.log('✅ spec 草稿：' + out);
 `);
-  fake('fill-plan.mjs', FILL_HEAD + `const body = '---\\n状态: draft\\n级别: ' + (lv === 'L0' ? 'L1' : lv) + '\\n模块: pipeline\\n---\\n# PLAN — ' + t + '\\n\\n## 改动方案\\n\\n- src/app.mjs：实现功能\\n\\n## 约束与风险\\n\\n- 风险低\\n\\n## 任务拆解\\n\\n1. 实现\\n\\n## 执行顺序\\n\\n1\\n\\n## 验证计划\\n\\n- 静态门：npm test\\n\\n## 确认与复核\\n- 待\\n';
+  fake('fill-plan.mjs', FILL_HEAD + `const body = '---\\n状态: draft\\n级别: ' + lv + '\\n模块: pipeline\\n---\\n# PLAN — ' + t + '\\n\\n## 改动方案\\n\\n- src/app.mjs：实现功能\\n\\n## 约束与风险\\n\\n- 风险低\\n\\n## 任务拆解\\n\\n1. 实现\\n\\n## 执行顺序\\n\\n1\\n\\n## 验证计划\\n\\n- 静态门：npm test\\n\\n## 确认与复核\\n- 待\\n';
 fs.writeFileSync(out, body);
 console.log('✅ plan 草稿：' + out);
 `);
@@ -289,22 +289,13 @@ test('修复环 cap 3 → 超限 gate-fail exit 2', () => {
   assert.match(out(p), /修复环超限/);
 });
 
-test('L0 路径：直改 → 提交 → done', () => {
-  const f = buildFixture();
-  prun(f, ['start', '改一处文案']);
-  prun(f, ['next', '--triage', 'kind=require level=L0 module=wiki topic=copy1']);
-  const pw = prun(f, ['next']); // 无 --files：重发工单
-  assert.match(out(pw), /PIPELINE-STOP work-order/);
-  const p = prun(f, ['next', '--files', 'README.md'], { FIXTURE_GIT_STATUS: ' M README.md' });
-  assert.equal(p.status, 0, out(p));
-  assert.match(out(p), /PIPELINE-STOP done/);
-  assert.match(fs.readFileSync(f.gitLog, 'utf8'), /commit -m docs\(wiki\): 改一处文案/);
-});
+// （2026-10-13 L0 退役，自源仓收敛系列 1 回灌：原「L0 路径：直改 → 提交 → done」场景随 direct-edit
+// 分支删除——最低档 L1 走 intent+plan 闭环，无直改通道。）
 
 test('verify-only 短路径直达 done', () => {
   const f = buildFixture();
   prun(f, ['start', '跑下 verify']);
-  const p = prun(f, ['next', '--triage', 'kind=verify level=L0 module=pipeline topic=v1']);
+  const p = prun(f, ['next', '--triage', 'kind=verify level=L1 module=pipeline topic=v1']);
   assert.equal(p.status, 0, out(p));
   assert.match(out(p), /PIPELINE-STOP done/);
   assert.ok(runFile(f, latestId(f)).events.some((e) => e.type === 'gate' && e.cmd.includes('verify.mjs') && e.exit === 0));
@@ -313,7 +304,7 @@ test('verify-only 短路径直达 done', () => {
 test('review-only：工单 → --done 收尾可达（复核 P1-1 回归）', () => {
   const f = buildFixture();
   prun(f, ['start', '评审一下']);
-  const pw = prun(f, ['next', '--triage', 'kind=review level=L0 module=pipeline topic=rv1']);
+  const pw = prun(f, ['next', '--triage', 'kind=review level=L1 module=pipeline topic=rv1']);
   assert.match(out(pw), /PIPELINE-STOP work-order/);
   const pd = prun(f, ['next', '--done']);
   assert.equal(pd.status, 0, out(pd));
@@ -332,7 +323,7 @@ test('deploy 路径：三件 done → prep 工单 → 机器校验 → 授权
   const f = buildFixture();
   seedDeployDocs(f, { intentState: 'done', planState: 'done' });
   prun(f, ['start', '可以上了']);
-  const pw = prun(f, ['next', '--triage', 'kind=deploy level=L0 module=pipeline topic=dep1']);
+  const pw = prun(f, ['next', '--triage', 'kind=deploy level=L1 module=pipeline topic=dep1']);
   assert.equal(pw.status, 0, out(pw));
   assert.match(out(pw), /deploy-prep/);
   assert.match(out(pw), /PIPELINE-STOP work-order/);
@@ -350,7 +341,7 @@ test('deploy 三件缺口 → gate-fail 列缺口 exit 2（P1-2）', () => {
   const f = buildFixture();
   seedDeployDocs(f, { intentState: 'done', planState: 'approved' }); // plan 未关单
   prun(f, ['start', '可以上了']);
-  prun(f, ['next', '--triage', 'kind=deploy level=L0 module=pipeline topic=dep1']);
+  prun(f, ['next', '--triage', 'kind=deploy level=L1 module=pipeline topic=dep1']);
   const p = prun(f, ['next']);
   assert.equal(p.status, 2);
   assert.match(out(p), /须 done/);
@@ -362,7 +353,7 @@ test('deploy 边界：incident closed 但 plan 缺失 → gate-fail（复核 P2-
   fs.writeFileSync(path.join(f.root, 'workflow', 'incidents', '2026-10-02-incd.md'),
     '---\n状态: closed\n发现: 2026-10-02\n模块: pipeline\n---\n# INCIDENT — incd\n\n## 时间线\n\n- x\n\n## 根因\n\nx\n\n## 复盘三件套\n\nx\n');
   prun(f, ['start', '可以上了']);
-  prun(f, ['next', '--triage', 'kind=deploy level=L0 module=pipeline topic=incd']);
+  prun(f, ['next', '--triage', 'kind=deploy level=L1 module=pipeline topic=incd']);
   const p = prun(f, ['next']);
   assert.equal(p.status, 2);
   assert.match(out(p), /plans\/2026-10-02-incd\.md（缺失——须 done）/);
@@ -372,32 +363,26 @@ test('deploy 边界：topic 子串不再误匹配（复核 P2-C 收紧回归）'
   const f = buildFixture();
   seedDeployDocs(f, { intentState: 'done', planState: 'done', topic: 'dep1' });
   prun(f, ['start', '可以上了']);
-  const p = prun(f, ['next', '--triage', 'kind=deploy level=L0 module=pipeline topic=dep']); // 旧版 includes 会误命中 dep1
+  const p = prun(f, ['next', '--triage', 'kind=deploy level=L1 module=pipeline topic=dep']); // 旧版 includes 会误命中 dep1
   assert.equal(p.status, 2);
   assert.match(out(p), /找不到可上线的对象/);
 });
 
 // P2-4 A′：提交命中 managed 面的处理（装户降级 WARN / 包源自愈 sync）
+// （2026-10-13 L0 退役：原用例经 direct-edit 直改通道驱动；该通道随级别退役删除，改由 L1 闭环的
+//   workflow 文档提交（plan-confirm 批次一 docsCommit）驱动同一 managedFaceCheck 判定面。）
 test('P2-4 A′：命中台账件且无 flow-kit → 装户降级 WARN + 台账随提交（复核回归）', () => {
   const f = buildFixture();
-  fs.mkdirSync(path.join(f.root, '.agents', 'notes'), { recursive: true });
-  fs.writeFileSync(path.join(f.root, '.agents', 'notes', 'runtime-env.md'), 'notes\n');
-  fs.writeFileSync(path.join(f.root, '.agents', 'kit.json'), JSON.stringify({ managed: [{ rel: '.agents/notes/runtime-env.md', sha256: 'x' }] }));
-  prun(f, ['start', '改一处文案']);
-  prun(f, ['next', '--triage', 'kind=require level=L0 module=wiki topic=mng1']);
-  editDoc(f, '.agents/notes/runtime-env.md', (t) => t + '\n- 演练追加一行\n');
-  const p = prun(f, ['next', '--files', '.agents/notes/runtime-env.md'], { FIXTURE_GIT_STATUS: ' M .agents/notes/runtime-env.md' });
-  assert.equal(p.status, 0, out(p));
-  assert.match(out(p), /⚠️ 触及 managed 面/);
-  const addLine = fs.readFileSync(f.gitLog, 'utf8').split('\n').find((l) => l.startsWith('add '));
-  assert.equal(addLine, 'add .agents/notes/runtime-env.md', '装户降级只 WARN：add 面不含 kit.json（复核 P2-D 断言改实）');
+  fs.writeFileSync(path.join(f.root, '.agents', 'kit.json'), JSON.stringify({ managed: [{ rel: 'workflow/intents/2026-10-02-mng1.md', sha256: 'x' }] }));
+  driveToImplement(f, 'L1', 'mng1');
+  const run = runFile(f, latestId(f));
+  assert.ok(run.events.some((e) => e.type === 'warn' && /触及 managed 面/.test(e.note)), '装户环境降级 WARN 出账');
+  assert.doesNotMatch(fs.readFileSync(f.gitLog, 'utf8'), /add .*\.agents\/kit\.json/, '装户降级只 WARN：add 面不含 kit.json（复核 P2-D 断言改实）');
 });
 
 test('P2-4 A′：包源环境自动 sync——flow-kit 假件被调 + 产物入提交（复核回归）', () => {
   const f = buildFixture();
-  fs.mkdirSync(path.join(f.root, '.agents', 'notes'), { recursive: true });
-  fs.writeFileSync(path.join(f.root, '.agents', 'notes', 'runtime-env.md'), 'notes\n');
-  fs.writeFileSync(path.join(f.root, '.agents', 'kit.json'), JSON.stringify({ managed: [{ rel: '.agents/notes/runtime-env.md', sha256: 'x' }] }));
+  fs.writeFileSync(path.join(f.root, '.agents', 'kit.json'), JSON.stringify({ managed: [{ rel: 'workflow/intents/2026-10-02-mng2.md', sha256: 'x' }] }));
   fs.mkdirSync(path.join(f.root, 'bin'), { recursive: true });
   const syncLog = path.join(f.root, 'flowkit-sync.log');
   fs.writeFileSync(path.join(f.root, 'bin', 'flow-kit.mjs'), `#!/usr/bin/env node
@@ -408,11 +393,7 @@ const kit = JSON.parse(fs.readFileSync(kp, 'utf8'));
 kit.managed[0].sha256 = 'refreshed';
 fs.writeFileSync(kp, JSON.stringify(kit));
 `);
-  prun(f, ['start', '改一处文案']);
-  prun(f, ['next', '--triage', 'kind=require level=L0 module=wiki topic=mng2']);
-  editDoc(f, '.agents/notes/runtime-env.md', (t) => t + '\n- 演练追加一行\n');
-  const p = prun(f, ['next', '--files', '.agents/notes/runtime-env.md'], { FIXTURE_GIT_STATUS: ' M .agents/notes/runtime-env.md' });
-  assert.equal(p.status, 0, out(p));
+  driveToImplement(f, 'L1', 'mng2');
   assert.match(fs.readFileSync(syncLog, 'utf8'), /sync-called/);
   const run = runFile(f, latestId(f));
   assert.ok(run.events.some((e) => e.type === 'gate' && e.cmd.includes('flow-kit.mjs sync') && e.exit === 0));
@@ -423,11 +404,10 @@ fs.writeFileSync(kp, JSON.stringify(kit));
 test('P2-4 A′：未命中台账面 → 不触发 sync/告警', () => {
   const f = buildFixture();
   fs.writeFileSync(path.join(f.root, '.agents', 'kit.json'), JSON.stringify({ managed: [{ rel: '.agents/notes/runtime-env.md', sha256: 'x' }] }));
-  prun(f, ['start', '改一处文案']);
-  prun(f, ['next', '--triage', 'kind=require level=L0 module=wiki topic=mng3']);
-  const p = prun(f, ['next', '--files', 'README.md'], { FIXTURE_GIT_STATUS: ' M README.md' });
-  assert.equal(p.status, 0, out(p));
-  assert.doesNotMatch(out(p), /managed 面/);
+  driveToImplement(f, 'L1', 'mng3');
+  const run = runFile(f, latestId(f));
+  assert.ok(!run.events.some((e) => e.type === 'warn' && /managed 面/.test(e.note)), '未命中台账面不出告警');
+  assert.ok(!run.events.some((e) => e.type === 'gate' && String(e.cmd).includes('flow-kit.mjs sync')), '未命中台账面不触发 sync');
 });
 
 test('rename 行 old+new 双收录防逃逸（复核 P2-2 回归）', () => {

package/templates/_agents/scripts/policy.mjs

@@ -119,8 +119,64 @@ export const POLICIES = {
     // 消费方：check-loop 检查 15 的 scope 子项（台账行 ts ≥ 本值才判）。
     scopeSince: '2026-10-09T11:24:43Z',
   },
+  // 版本 8 = 版本 7 的全部键 + ledgerDocChainSince（台账哈希链的**链域**从「文件物理序」改为
+  // 「按 doc 的逻辑序」，2026-10-12 ledger-doc-chain）。
+  // 为什么改：原链 prevHash = 物理上一行的 hash，隐含「台账是单写者顺序追加」的前提。三种并发形态
+  //   全部破坏它——① 两进程并发 append 读到同一末行 → 同 prevHash 分叉；② git merge 并集（见
+  //   git-merge-jsonl.mjs）后 B 侧行被追加到 A 尾部之后 → A 侧链被劈开；③ 分片归并 compact 把分片行
+  //   插进主台账中部 → 断链。且这三者都是**正常协作**,不是篡改——让正常协作长期撞 hard 门,门禁就会被
+  //   绕过（--no-verify），治理失效。
+  // 为什么按 doc 分域：台账行的天然主键是 doc（每行 = 某份文档的一次确认）。**同一 doc 内的先后有语义，
+  //   doc 之间的先后没有语义**。把链的域对齐语义域是对既有判据的修正，不是削弱——就地改行、删行、
+  //   插行三类篡改在 doc 链下一律仍被抓住（见 check-loop 检查 15）。
+  // 本版本只加一个开关键：**缺键（v1-v7）时写入侧与校验侧都走旧物理链口径**，存量台账零变化、零新增告警。
+  // 粒度取「时刻」而非日期（同 scopeSince / verifyDocSince 的教训）：本日已有一批旧口径行写入，
+  //   日期粒度会把它们纳入新受审范围、产出不可消退告警。
+  // 消费方：confirm-doc appendLedger（写入侧取前驱）+ check-loop 检查 15（校验侧按行分域）。
+  8: {
+    moduleSince: '2026-09-22',
+    check14Since: '2026-09-26',
+    confirmDocsEffective: '2026-09-27',
+    confirmIncidentsEffective: '2026-09-28',
+    bindingTs: '2026-09-28',
+    check17UnclosedAfter: '0.8.0',
+    stageGateSince: '2026-09-29',
+    riskLevelSince: '2026-10-01',
+    verifySince: '2026-10-07',
+    verifyDocSince: '2026-10-08T09:37:35Z',
+    scopeSince: '2026-10-09T11:24:43Z',
+    ledgerDocChainSince: '2026-10-12T07:20:00Z',
+  },
 };
 
+// ---- 版本 9–12（2026-10-13 B6b-1，自源仓 policy v9–v12 对齐回灌）----
+// 构造式沿源仓 2026-10-10 收敛系列 6 的 merge 链（基线 + 显式差异）：kit v1–v8 键史原样保留不动，
+// 新版本在 kit v8 之上做超集追加，消除「全量手抄日期键、漏抄即静默改语义」的脆弱点（v2 注释自警同源）。
+// 键名与源仓逐字一致；kit 无源仓 v6–v8 的 check14HardSince / verifyHardSince——那两个键的消费段
+// （检查 14 hard 档 / 凭证 hard 档）kit 仍为恒 advisory 面，未落地不引入。incidentRegrSince 随 B6b-2
+//（§21–26 同批）落地并激活其消费段 §3x 防复发证据门。各锚日期 = kit 落地日口径：
+//   发布当日（2026-10-13）= specVerifSince / attributionSince / convergenceSince（advisory 档沿源仓
+//     convergenceSince「发布当日」先例——当日起、存量不追溯）；
+//   发布次日（2026-10-14）= convergenceHardSince / reviewerSince / incidentRegrSince（沿源仓
+//     check14HardSince「发布次日」先例——当日在途件不追溯、维持 advisory 留痕，锚起新违例才升格）。
+// 缺键（v1–v8）→ 对应消费段整体跳过（存量零噪声）。抄全键仍是铁律。
+const merge = (base, over) => ({ ...base, ...over });
+const V9 = merge(POLICIES[8], {
+  incidentRegrSince: '2026-10-14', // 检查 3x incident 防复发验证证据门生效锚（B6b-2 §3x 消费，hard 档「发布次日」口径——在途 fixed 件不追溯）；v1–v8 无此键 → 该段整体跳过
+  specVerifSince: '2026-10-13',   // 检查 21 spec 验证落地核查生效锚（B6b-2 §21 消费；kit 落地 2026-10-13）；v1–v8 无此键 → 该检查整体跳过
+  attributionSince: '2026-10-13', // 检查 24 incident 归因字段生效锚（B6b-2 §24 消费；kit 落地 2026-10-13）；v1–v8 无此键 → 该检查整体跳过
+});
+const V10 = merge(V9, {
+  convergenceSince: '2026-10-13', // 检查 23 判据级收敛对账生效锚（B6b-2 §23 advisory 档消费；kit 落地 2026-10-13）；v1–v9 无此键 → 该检查整体跳过
+});
+const V11 = merge(V10, {
+  convergenceHardSince: '2026-10-14', // 检查 23 证据无效 hard 锚（B6b-2 §23 hard 档消费；kit 落地 2026-10-14）；v1–v10 无此键 → 维持 warning
+});
+const V12 = merge(V11, {
+  reviewerSince: '2026-10-14',    // 检查 1 独立复核上下文标识生效锚（B6b-2 检查 1 扩展消费；kit 落地 2026-10-14）；v1–v11 无此键 → 该子检查整体跳过
+});
+Object.assign(POLICIES, { 9: V9, 10: V10, 11: V11, 12: V12 });
+
 export function loadKitPolicy(root) {
   let raw = null;
   try {
@@ -180,6 +236,25 @@ export function ledgerChainHash(row, prevHash) {
   return createHash('sha256').update((prevHash || '') + JSON.stringify(row)).digest('hex');
 }
 
+// ---- 台账 doc 链前驱（2026-10-12 ledger-doc-chain）----
+// 单源：confirm-doc appendLedger（写入侧取前驱）与 check-loop 检查 15（校验侧判接续）共用同一语义。
+//   ledgerDocChainActive(policy)：锚存在且为合法 ISO 时刻 → 新口径生效；缺键（v1-v7）→ 旧物理链。
+//   ledgerDocChainPrev(rows, doc)：rows 为物理序的已解析台账行，返回该 doc **最后一个带 hash 行**的
+//   hash，无则 ''（链段重启）。取不到带 hash 的行时返回 ''，与旧口径「末行无 hash → ''」同向。
+// 为什么不做去重/合并：去重是**口径变更**（会改漏斗计数），属分片功能同批生效，不在本步。
+export function ledgerDocChainActive(policy) {
+  const s = policy && policy.ledgerDocChainSince;
+  return typeof s === 'string' && /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?Z$/.test(s);
+}
+
+export function ledgerDocChainPrev(rows, doc) {
+  for (let i = (rows && rows.length ? rows.length : 0) - 1; i >= 0; i--) {
+    const r = rows[i];
+    if (r && r.doc === doc && typeof r.hash === 'string') return r.hash;
+  }
+  return '';
+}
+
 // ---- 台账 scope（机器派生改动面，2026-10-09 审查 A1 干净版）----
 // scopeDigest(files) = {files, sha256}：files 归一（反斜杠→posix）、去重、排序；sha256 = files.join('\n') 的摘要。
 // **单源**（confirm-doc 落账侧构造与 check-loop 检查 15 校验侧重算共用——防两处归一/排序口径漂移，