agentic-flow-kit 1.4.0 → 1.6.0

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

@@ -0,0 +1,76 @@
+// pipeline-run-docs.mjs — 文档纯函数层（2026-10-08 engine-quality-batch，L2 自 pipeline-run.mjs 拆出）
+// fmGet / placeholdersIn / sectionBody / validateDraftContent / closeoutComplete / summarizeDoc——
+// 零 IO、零 process 依赖、单向被 pipeline-run.mjs（CLI 编排层）消费；判据注释随函数原样迁入。
+// export 面 = 原主文件具名导出（placeholdersIn/validateDraftContent/closeoutComplete）+ 层内消费三函数；
+// 主文件经 re-export 保持对外导出面不变（workflow-board-server 等消费方零改动）。
+export function fmGet(text, key) {
+  const m = text.split(/\r?\n/).find((l) => l.startsWith(`${key}:`));
+  return m ? m.slice(key.length + 1).trim() : null;
+}
+
+// 占位符判定（复核 P1-3 收窄，2026-10-02）：先剔除 code span（`…`）与引号串（"…"）——
+// 正文合法的命令语法占位（如 `next --delegated "<原话>"`）几乎总在 code span 内，
+// 模板实占位符（如 <为什么做；写明需求来源…>）从不包 code span；再匹配剩余裸尖括号。
+export function placeholdersIn(text) {
+  const stripped = String(text)
+    .replace(/^```[\s\S]*?^```$/gm, '') // 复核 P2-B：跨行 code fence 整块剔除（围栏内命令示例占位不属模板占位符）
+    .replace(/`[^`\n]*`/g, '')
+    .replace(/"[^"\n]*"/g, '');
+  const hits = [];
+  for (const re of [/<[^>\n]{1,60}>/g, /YYYY-MM-DD 用户/g]) {
+    let m; while ((m = re.exec(stripped))) hits.push(m[0]);
+  }
+  return [...new Set(hits)].slice(0, 5);
+}
+
+export function sectionBody(text, title) {
+  const lines = text.split(/\r?\n/);
+  const i = lines.findIndex((l) => l.trim() === `## ${title}` || l.trim() === `## ${title}（L1 微改动无实质内容可删本节，不硬填）` || l.trim().startsWith(`## ${title}`));
+  if (i < 0) return null;
+  const body = [];
+  for (let j = i + 1; j < lines.length; j++) {
+    if (/^##\s/.test(lines[j])) break;
+    body.push(lines[j]);
+  }
+  return body.join('\n').trim();
+}
+
+export function validateDraftContent(text, kind, level) {
+  const problems = [];
+  if (!text) return ['文件不存在或为空'];
+  const state = fmGet(text, '状态');
+  if (!state) problems.push('frontmatter 缺「状态:」行');
+  if (kind !== 'incident' && !fmGet(text, '级别')) problems.push('frontmatter 缺「级别:」行');
+  const ph = placeholdersIn(text);
+  if (ph.length) problems.push(`模板占位符残留：${ph.join('、')}`);
+  const required = {
+    intent: level === 'L1' ? ['背景与问题', '目标', '验收标准'] : ['背景与问题', '历史教训/防复发', '目标', '非目标', '约束', '验收标准'],
+    spec: ['功能行为', '数据流', '系统改动', '约束遵守映射'],
+    plan: level === 'L1' ? ['改动方案', '约束与风险', '验证计划'] : ['改动方案', '任务拆解', '执行顺序', '验证计划'],
+    incident: ['时间线', '根因', '复盘三件套'],
+  }[kind] || [];
+  for (const sec of required) {
+    const b = sectionBody(text, sec);
+    if (b === null) { if (!(level === 'L1' && ['非目标', '约束', '任务拆解', '执行顺序'].includes(sec))) problems.push(`缺节：## ${sec}`); }
+    else if (!b) problems.push(`节为空：## ${sec}`);
+  }
+  return problems;
+}
+
+export function closeoutComplete(text) {
+  const body = sectionBody(text, '验收标准');
+  if (body === null) return { ok: false, problems: ['缺「## 验收标准」节'] };
+  const lines = body.split(/\r?\n/);
+  const open = lines.filter((l) => /^\s*-\s\[\s\]\s/.test(l));
+  // 复核 P2-6：证据冒号后须直接跟内容（非空白、非收括号）——「（证据：）」空值不算过
+  const checkedNoEv = lines.filter((l) => /^\s*-\s\[x\]\s/.test(l) && !/证据[:：][^）\s]/.test(l));
+  const problems = [];
+  if (open.length) problems.push(`未勾验收 ${open.length} 条`);
+  if (checkedNoEv.length) problems.push(`已勾缺证据 ${checkedNoEv.length} 条`);
+  return { ok: problems.length === 0, problems };
+}
+
+export function summarizeDoc(text) {
+  const body = text.split(/\r?\n/).filter((l) => l.trim() && !l.startsWith('---') && !/^状态:|^级别:|^日期:|^模块:|^备注:|^risk_level:/.test(l));
+  return body.slice(0, 3).join(' / ').slice(0, 200);
+}

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

@@ -0,0 +1,63 @@
+// pipeline-run-run.mjs — run 存储层（2026-10-08 engine-quality-batch，L2 自 pipeline-run.mjs 拆出）
+// ctxEnv / moduleList / runFileOf / loadRun / saveRun / emit / latestRunId / newRunId + 时间工具（nowIso/today/pad）——
+// run 文件（.agents/cache/pipeline-runs/<id>.json）原子读写与事件流；run schema 零变化。
+// 测试注入契约原样：PIPELINE_RUN_ROOT / PIPELINE_RUN_BIN / PIPELINE_RUN_GIT_BIN（ctxEnv）与
+// PIPELINE_RUN_TODAY（today——时钟依赖消除锚，spec §测试注入契约）。
+import fs from 'node:fs';
+import path from 'node:path';
+
+export const nowIso = () => new Date().toISOString();
+export const today = () => process.env.PIPELINE_RUN_TODAY || nowIso().slice(0, 10);
+export const pad = (n) => String(n).padStart(2, '0');
+
+// ── 环境解析（测试注入点） ─────────────────────────────────────────────
+export function ctxEnv(overrideRoot) {
+  const root = path.resolve(overrideRoot || process.env.PIPELINE_RUN_ROOT || process.cwd());
+  const bin = path.resolve(process.env.PIPELINE_RUN_BIN || path.join(root, '.agents', 'scripts'));
+  const gitPrefix = (process.env.PIPELINE_RUN_GIT_BIN || 'git').split(/\s+/).filter(Boolean);
+  return { root, bin, gitPrefix, runsDir: path.join(root, '.agents', 'cache', 'pipeline-runs') };
+}
+
+export function moduleList(ctx) {
+  try {
+    return fs.readFileSync(path.join(ctx.root, '.agents', 'workflow-modules.txt'), 'utf8')
+      .split(/\r?\n/).map((l) => l.trim()).filter((l) => l && !l.startsWith('#'));
+  } catch { return ['backend', 'frontend', 'ui', 'infra', 'integration', 'pipeline', 'wiki']; } // 夹具缺表时的回退默认（warning 由调用方打）
+}
+
+// ── run 文件（原子写；事件 append-only） ──────────────────────────────
+export function runFileOf(ctx, runId) { return path.join(ctx.runsDir, `${runId}.json`); }
+
+export function loadRun(ctx, runId) {
+  const f = runFileOf(ctx, runId);
+  if (!fs.existsSync(f)) return null;
+  try { return JSON.parse(fs.readFileSync(f, 'utf8')); } catch { return null; }
+}
+
+export function saveRun(ctx, run) {
+  fs.mkdirSync(ctx.runsDir, { recursive: true });
+  run.updatedAt = nowIso();
+  const f = runFileOf(ctx, run.runId);
+  const tmp = f + '.tmp';
+  fs.writeFileSync(tmp, JSON.stringify(run, null, 2) + '\n');
+  fs.renameSync(tmp, f);
+}
+
+export function emit(run, ev) { run.events.push({ t: nowIso(), ...ev }); }
+
+export function latestRunId(ctx) {
+  if (!fs.existsSync(ctx.runsDir)) return null;
+  const ids = fs.readdirSync(ctx.runsDir).filter((f) => f.endsWith('.json')).map((f) => f.slice(0, -5)).sort();
+  for (let i = ids.length - 1; i >= 0; i--) {
+    const r = loadRun(ctx, ids[i]);
+    if (r && !['done', 'aborted'].includes(r.stopType)) return ids[i];
+  }
+  return ids[ids.length - 1] || null;
+}
+
+export function newRunId(requirement) {
+  const d = new Date();
+  const ascii = (requirement.toLowerCase().match(/[a-z0-9]{2,}/g) || []).slice(0, 3).join('-') || 'task';
+  const rand = Math.random().toString(36).slice(2, 6);
+  return `${d.getFullYear()}${pad(d.getMonth() + 1)}${pad(d.getDate())}-${pad(d.getHours())}${pad(d.getMinutes())}-${ascii}-${rand}`;
+}

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

@@ -19,9 +19,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { spawnSync } from 'node:child_process';
-import { fileURLToPath } from 'node:url';
 
-const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
 const KINDS = ['require', 'fix', 'verify', 'review', 'deploy'];
 const LEVELS = ['L0', 'L1', 'L2', 'L3'];
 const TERMINAL = ['done', 'superseded', 'cancelled', 'closed'];
@@ -29,61 +27,13 @@ const FIX_CAP = 3;
 const GIT_NEVER_FLAGS = ['--no-verify', '-n']; // 不变量：任何 git 调用不得携带（防御性断言，正常路径不会拼出）
 
 function fail(msg, code = 1) { console.error('❌ ' + msg); process.exit(code); }
-const nowIso = () => new Date().toISOString();
-const today = () => process.env.PIPELINE_RUN_TODAY || nowIso().slice(0, 10);
-const pad = (n) => String(n).padStart(2, '0');
-
-// ── 环境解析（测试注入点） ─────────────────────────────────────────────
-function ctxEnv(overrideRoot) {
-  const root = path.resolve(overrideRoot || process.env.PIPELINE_RUN_ROOT || process.cwd());
-  const bin = path.resolve(process.env.PIPELINE_RUN_BIN || path.join(root, '.agents', 'scripts'));
-  const gitPrefix = (process.env.PIPELINE_RUN_GIT_BIN || 'git').split(/\s+/).filter(Boolean);
-  return { root, bin, gitPrefix, runsDir: path.join(root, '.agents', 'cache', 'pipeline-runs') };
-}
-
-function moduleList(ctx) {
-  try {
-    return fs.readFileSync(path.join(ctx.root, '.agents', 'workflow-modules.txt'), 'utf8')
-      .split(/\r?\n/).map((l) => l.trim()).filter((l) => l && !l.startsWith('#'));
-  } catch { return ['backend', 'frontend', 'ui', 'infra', 'integration', 'pipeline', 'wiki']; } // 夹具缺表时的回退默认（warning 由调用方打）
-}
 
-// ── run 文件（原子写；事件 append-only） ──────────────────────────────
-function runFileOf(ctx, runId) { return path.join(ctx.runsDir, `${runId}.json`); }
-
-function loadRun(ctx, runId) {
-  const f = runFileOf(ctx, runId);
-  if (!fs.existsSync(f)) return null;
-  try { return JSON.parse(fs.readFileSync(f, 'utf8')); } catch { return null; }
-}
-
-function saveRun(ctx, run) {
-  fs.mkdirSync(ctx.runsDir, { recursive: true });
-  run.updatedAt = nowIso();
-  const f = runFileOf(ctx, run.runId);
-  const tmp = f + '.tmp';
-  fs.writeFileSync(tmp, JSON.stringify(run, null, 2) + '\n');
-  fs.renameSync(tmp, f);
-}
 
-function emit(run, ev) { run.events.push({ t: nowIso(), ...ev }); }
-
-function latestRunId(ctx) {
-  if (!fs.existsSync(ctx.runsDir)) return null;
-  const ids = fs.readdirSync(ctx.runsDir).filter((f) => f.endsWith('.json')).map((f) => f.slice(0, -5)).sort();
-  for (let i = ids.length - 1; i >= 0; i--) {
-    const r = loadRun(ctx, ids[i]);
-    if (r && !['done', 'aborted'].includes(r.stopType)) return ids[i];
-  }
-  return ids[ids.length - 1] || null;
-}
-
-function newRunId(requirement) {
-  const d = new Date();
-  const ascii = (requirement.toLowerCase().match(/[a-z0-9]{2,}/g) || []).slice(0, 3).join('-') || 'task';
-  const rand = Math.random().toString(36).slice(2, 6);
-  return `${d.getFullYear()}${pad(d.getMonth() + 1)}${pad(d.getDate())}-${pad(d.getHours())}${pad(d.getMinutes())}-${ascii}-${rand}`;
-}
+import { nowIso, today, ctxEnv, moduleList, loadRun, saveRun, emit, latestRunId, newRunId } from './pipeline-run-run.mjs';
+import { fmGet, placeholdersIn, sectionBody, validateDraftContent, closeoutComplete, summarizeDoc } from './pipeline-run-docs.mjs';
+// 拆分（2026-10-08 engine-quality-batch）：文档纯函数层 / run 存储层迁出本文件（判据注释随函数迁走，
+// 对外导出面经下行 re-export 保持不变——stageBar/parseKV 仍在本文件）；本文件 = CLI 编排层 + 状态机。
+export { placeholdersIn, validateDraftContent, closeoutComplete } from './pipeline-run-docs.mjs';
 
 // ── 门执行（唯一子进程出口；记录真实退出码） ──────────────────────────
 function runNode(ctx, run, script, args) {
@@ -114,78 +64,8 @@ function runGit(ctx, run, args) {
 function readDoc(ctx, rel) {
   try { return fs.readFileSync(path.join(ctx.root, rel), 'utf8'); } catch { return null; }
 }
-function fmGet(text, key) {
-  const m = text.split(/\r?\n/).find((l) => l.startsWith(`${key}:`));
-  return m ? m.slice(key.length + 1).trim() : null;
-}
 function docState(ctx, rel) { const t = readDoc(ctx, rel); return t ? fmGet(t, '状态') : null; }
 
-// 占位符判定（复核 P1-3 收窄，2026-10-02）：先剔除 code span（`…`）与引号串（"…"）——
-// 正文合法的命令语法占位（如 `next --delegated "<原话>"`）几乎总在 code span 内，
-// 模板实占位符（如 <为什么做；写明需求来源…>）从不包 code span；再匹配剩余裸尖括号。
-export function placeholdersIn(text) {
-  const stripped = String(text)
-    .replace(/^```[\s\S]*?^```$/gm, '') // 复核 P2-B：跨行 code fence 整块剔除（围栏内命令示例占位不属模板占位符）
-    .replace(/`[^`\n]*`/g, '')
-    .replace(/"[^"\n]*"/g, '');
-  const hits = [];
-  for (const re of [/<[^>\n]{1,60}>/g, /YYYY-MM-DD 用户/g]) {
-    let m; while ((m = re.exec(stripped))) hits.push(m[0]);
-  }
-  return [...new Set(hits)].slice(0, 5);
-}
-
-function sectionBody(text, title) {
-  const lines = text.split(/\r?\n/);
-  const i = lines.findIndex((l) => l.trim() === `## ${title}` || l.trim() === `## ${title}（L1 微改动无实质内容可删本节，不硬填）` || l.trim().startsWith(`## ${title}`));
-  if (i < 0) return null;
-  const body = [];
-  for (let j = i + 1; j < lines.length; j++) {
-    if (/^##\s/.test(lines[j])) break;
-    body.push(lines[j]);
-  }
-  return body.join('\n').trim();
-}
-
-export function validateDraftContent(text, kind, level) {
-  const problems = [];
-  if (!text) return ['文件不存在或为空'];
-  const state = fmGet(text, '状态');
-  if (!state) problems.push('frontmatter 缺「状态:」行');
-  if (kind !== 'incident' && !fmGet(text, '级别')) problems.push('frontmatter 缺「级别:」行');
-  const ph = placeholdersIn(text);
-  if (ph.length) problems.push(`模板占位符残留：${ph.join('、')}`);
-  const required = {
-    intent: level === 'L1' ? ['背景与问题', '目标', '验收标准'] : ['背景与问题', '历史教训/防复发', '目标', '非目标', '约束', '验收标准'],
-    spec: ['功能行为', '数据流', '系统改动', '约束遵守映射'],
-    plan: level === 'L1' ? ['改动方案', '约束与风险', '验证计划'] : ['改动方案', '任务拆解', '执行顺序', '验证计划'],
-    incident: ['时间线', '根因', '复盘三件套'],
-  }[kind] || [];
-  for (const sec of required) {
-    const b = sectionBody(text, sec);
-    if (b === null) { if (!(level === 'L1' && ['非目标', '约束', '任务拆解', '执行顺序'].includes(sec))) problems.push(`缺节：## ${sec}`); }
-    else if (!b) problems.push(`节为空：## ${sec}`);
-  }
-  return problems;
-}
-
-export function closeoutComplete(text) {
-  const body = sectionBody(text, '验收标准');
-  if (body === null) return { ok: false, problems: ['缺「## 验收标准」节'] };
-  const lines = body.split(/\r?\n/);
-  const open = lines.filter((l) => /^\s*-\s\[\s\]\s/.test(l));
-  // 复核 P2-6：证据冒号后须直接跟内容（非空白、非收括号）——「（证据：）」空值不算过
-  const checkedNoEv = lines.filter((l) => /^\s*-\s\[x\]\s/.test(l) && !/证据[:：][^）\s]/.test(l));
-  const problems = [];
-  if (open.length) problems.push(`未勾验收 ${open.length} 条`);
-  if (checkedNoEv.length) problems.push(`已勾缺证据 ${checkedNoEv.length} 条`);
-  return { ok: problems.length === 0, problems };
-}
-
-function summarizeDoc(text) {
-  const body = text.split(/\r?\n/).filter((l) => l.trim() && !l.startsWith('---') && !/^状态:|^级别:|^日期:|^模块:|^备注:|^risk_level:/.test(l));
-  return body.slice(0, 3).join(' / ').slice(0, 200);
-}
 
 // ── 工单构建 ───────────────────────────────────────────────────────────
 function wo(run, o) {
@@ -211,7 +91,7 @@ function stopConfirm(ctx, run, docRel, points, ledger) {
   printRun(ctx, run);
   process.exit(0);
 }
-function stopGateFail(ctx, run, stage, problems, exitHint) {
+function stopGateFail(ctx, run, stage, problems) {
   run.workOrder = null;
   run.stopType = 'gate-fail';
   run.stage = stage;
@@ -318,11 +198,11 @@ function confirmGate(ctx, run, docRel, quote, to) {
     const tail = (r.stderr || r.stdout).split(/\r?\n/).filter(Boolean).slice(-6).join(' | ');
     return { ok: false, msg: `confirm-doc exit ${r.exit}：${tail}` };
   }
-  emit(run, { type: 'confirm', doc: docRel, to: to || nextConfirmTarget(docState(ctx, docRel), docRel), source: quote ? 'chat-delegated' : 'tty', ...(quote ? { quote } : {}) });
+  emit(run, { type: 'confirm', doc: docRel, to: to || nextConfirmTarget(docState(ctx, docRel)), source: quote ? 'chat-delegated' : 'tty', ...(quote ? { quote } : {}) });
   return { ok: true };
 }
 // 语义上 confirm-doc 自行决定目标态（approved/done/fixed/closed）；事件里记录结果态
-function nextConfirmTarget(curState, docRel) { return curState || 'approved'; }
+function nextConfirmTarget(curState) { return curState || 'approved'; }
 
 // managedFaceCheck（复核 P2-4 修复 A′，2026-10-02 用户拍板）：提交集命中 kit.json 台账面或包源
 // templates/_agents/ 时——包源环境（bin/flow-kit.mjs 可达）自动跑 sync 刷台账并把 kit.json 与 sync

package/templates/_agents/scripts/policy.mjs

@@ -3,6 +3,7 @@
 // kit.json 缺 policyVersion、或版本不在表内：回退版本 1（不启用版本 2 的 approved 锚）。
 // audit 不在本表：缺省视为全量检查（已装仓库与无 kit 的测试夹具）；init 新装显式写 false。
 import fs from 'node:fs';
+import { createHash } from 'node:crypto';
 import path from 'node:path';
 
 export const POLICIES = {
@@ -86,7 +87,13 @@ export const POLICIES = {
     stageGateSince: '2026-09-29',
     riskLevelSince: '2026-10-01',
     verifySince: '2026-10-07',
-    verifyDocSince: '2026-10-08', // 凭证按 doc 绑定生效日；v1-v5 无此键 → 两个消费方维持 v5 全局行为
+    // 凭证按 doc 绑定的生效**时刻**（ISO 8601，含 T/Z）；v1-v5 无此键 → 两个消费方维持 v5 全局行为。
+    // 2026-10-09 verifydoc-anchor：值从日期 '2026-10-08' 升级为时刻——本仓 v6 上线当日（本地 17:37 =
+    // 09:37Z）之前 done 的单（selfmeasure 00:22Z / gate-roi-metrics 03:25Z）在日期粒度下被误纳入精确匹配、
+    // 产 3 条不可消退 advisory（它们关单时 --doc 机制尚不存在，无从补证）；升级为时刻后按 done ts 精确比较，
+    // 机制上线前的存量单退回 v5 全局布尔（不误报、不伪造），与检查 15/18 的生效日锚同构。
+    // 消费方：检查 8 的 verifyDocInWindow（done ts ≥ 本值才启用精确匹配）。
+    verifyDocSince: '2026-10-08T09:37:35Z',
   },
 };
 
@@ -136,3 +143,15 @@ export function hasFreshVerifyLine(lines, now = Date.now(), doc = null) {
   }
   return false;
 }
+
+// ---- 台账哈希链（2026-10-09 engine-quality-round2 D）----
+// 单源（confirm-doc appendLedger 写入与 check-loop 检查 15 验链共用——判定零复刻）：
+// ledgerChainHash(row, prevHash) = sha256(prevHash + JSON.stringify(row))。
+//   row = 台账行**去掉 prevHash/hash 两字段**后的对象（键序 = 写入序，JSON.parse 保序 → 重算一致）；
+//   prevHash = 上一行的 hash（上一行无 hash/文件首行 → ''——历史行零回填，链从首个带 hash 行起算）。
+// 边界（诚实声明）：整文件重写可重建完整链，不可机器防——兜底 = 台账文件自身的 git 历史
+//   （check-ledger-invariant 已扫 append-only 历史）；本链堵的是「就地改/删中间行」这一高频伪造面，
+//   把主动伪造从静默可行抬到必留断链痕迹。
+export function ledgerChainHash(row, prevHash) {
+  return createHash('sha256').update((prevHash || '') + JSON.stringify(row)).digest('hex');
+}

package/templates/_agents/scripts/source-sync-check.mjs

@@ -112,12 +112,12 @@ function printDiff(result) {
 
 const isMain = process.argv[1] && process.argv[1].endsWith('source-sync-check.mjs');
 if (isMain) {
-  let jsonMode = false, diffMode = false, gateMode = false;
+  let jsonMode = false, gateMode = false;
   let pkgRoot = null, target = null;
   for (let i = 0; i < process.argv.length - 2; i++) {
     const a = process.argv[2 + i];
     if (a === '--json') jsonMode = true;
-    else if (a === '--diff') diffMode = true;
+    else if (a === '--diff') { /* diff 为默认输出模式，无需置位 */ }
     else if (a === '--gate') gateMode = true;
     else if (a === '--pkg-root') pkgRoot = process.argv[2 + i + 1];
     else if (a === '--target') target = process.argv[2 + i + 1];

package/templates/_agents/scripts/source-sync-check.test.mjs

@@ -125,7 +125,7 @@ if (!SRC_ROOT) {
     drift: r.drift.map((d) => ({ rel: d.rel, pkgSha: d.pkgSha.slice(0, 8), tgtSha: d.tgtSha.slice(0, 8) })),
   }, null, 2);
   let parsed = null;
-  try { parsed = JSON.parse(jsonOut); } catch {}
+  try { parsed = JSON.parse(jsonOut); } catch { /* 非 JSON 输出时 parsed 保持 null，S6 判失败路径 */ }
   check('S6 --json 输出可解析', parsed && typeof parsed === 'object' && Array.isArray(parsed.missing));
 }
 

package/templates/_agents/scripts/verify-wiki-consistency.mjs

@@ -125,7 +125,6 @@ for (const line of fs.readFileSync(path.join(WIKI, 'INDEX.md'), 'utf8').split(/\
 }
 
 const diff = (a, b) => [...a].filter((x) => !b.has(x));
-const eq = (a, b) => a.size === b.size && diff(a, b).length === 0;
 
 // ---- 1. 文件级三方比对 ----
 for (const [label, extra] of [

package/templates/_agents/scripts/verify-wiki-consistency.test.mjs

@@ -0,0 +1,81 @@
+// verify-wiki-consistency.test.mjs — wiki 三方一致性验证（2026-10-09 engine-quality-round2 A2 补测）
+// 此前 exempt 表登记「无覆盖」——本套件补齐后移出豁免。三场景：三方一致（绿）/ 磁盘多文件未登记（红）/
+// drafts-archive 协议目录缺失（红）。脚本自足（仅 node 标准库 + cwd 相对读 wiki/），fixture 子进程跑真脚本。
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { spawnSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+
+const SRC = path.dirname(fileURLToPath(import.meta.url));
+let pass = 0, fail = 0;
+const check = (name, cond, detail = '') => {
+  if (cond) { pass++; console.log(`PASS ${name}`); }
+  else { fail++; console.log(`FAIL ${name}${detail ? `——${detail}` : ''}`); }
+};
+
+function mkWiki({ extraDiskFile = false, noArchive = false } = {}) {
+  const fx = fs.mkdtempSync(path.join(os.tmpdir(), 'vwc-'));
+  fs.mkdirSync(path.join(fx, 'wiki', '主题A'), { recursive: true });
+  fs.writeFileSync(path.join(fx, 'wiki', '主题A', '文档1.md'), '# 文档1\n\n无外链。\n');
+  if (extraDiskFile) fs.writeFileSync(path.join(fx, 'wiki', '主题A', '文档2.md'), '# 文档2\n');
+  if (!noArchive) fs.mkdirSync(path.join(fx, 'wiki', 'drafts-archive'), { recursive: true });
+  fs.writeFileSync(path.join(fx, 'wiki', 'INDEX.md'), [
+    '# Wiki 索引',
+    '',
+    '## 主题目录速览',
+    '',
+    '| 主题 | 文件数 | 用途 |',
+    '|---|---|---|',
+    '| 主题A | 1 | 测试主题 |',
+    '',
+    '## 映射表',
+    '',
+    '| 文件 | 用途 | 路径 |',
+    '|---|---|---|',
+    '| 文档1.md | 测试 | wiki/主题A/文档1.md |',
+    '',
+    `合计：**1 份**知识文档，**1 个主题**`,
+    '',
+  ].join('\n'));
+  const DATA = {
+    topics: [{ name: '主题A', files: [{ file: '文档1.md', dir: '主题A' }] }],
+    summary: { total: 1, files: 1, topics: 1, archive: 0 },
+  };
+  fs.writeFileSync(path.join(fx, 'wiki', '知识沉淀总览.html'),
+    '<!doctype html><script>\nconst DATA = ' + JSON.stringify(DATA, null, 2) + ';\n</script>\n');
+  return fx;
+}
+
+const run = (fx) => spawnSync(process.execPath, [path.join(SRC, 'verify-wiki-consistency.mjs')], {
+  cwd: fx, encoding: 'utf8',
+});
+
+{
+  // ① 三方一致 → exit 0
+  const fx = mkWiki();
+  const r = run(fx);
+  check('① 三方一致 → exit 0', r.status === 0, `status=${r.status}\n${(r.stdout || '') + (r.stderr || '')}`.slice(0, 500));
+  fs.rmSync(fx, { recursive: true, force: true });
+}
+{
+  // ② 磁盘多文件未登记 → exit 1（合计行 fail-loud 最先拦——INDEX 合计 1 份 vs 磁盘 2 份；
+  //   该检查在脚本内先于三方文件比对出账，是同问题的合法拦截路径）
+  const fx = mkWiki({ extraDiskFile: true });
+  const r = run(fx);
+  const out = (r.stdout || '') + (r.stderr || '');
+  check('② 磁盘多文件未登记 → exit 1 且合计行拦（INDEX 1 份 vs 磁盘 2 份）',
+    r.status === 1 && out.includes('INDEX 合计行与磁盘不一致'), `status=${r.status}\n${out.slice(0, 500)}`);
+  fs.rmSync(fx, { recursive: true, force: true });
+}
+{
+  // ③ drafts-archive 协议目录缺失 → exit 1（门禁明示失败而非崩栈，2026-09-24 口径）
+  const fx = mkWiki({ noArchive: true });
+  const r = run(fx);
+  const out = (r.stdout || '') + (r.stderr || '');
+  check('③ drafts-archive 缺失 → exit 1 且明示', r.status === 1 && out.includes('drafts-archive'), `status=${r.status}\n${out.slice(0, 400)}`);
+  fs.rmSync(fx, { recursive: true, force: true });
+}
+
+console.log(`\n合计: PASS ${pass} / FAIL ${fail}`);
+process.exit(fail ? 1 : 0);

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

@@ -162,9 +162,9 @@ const run = (argv, opts = {}) => spawnSync(process.execPath, [VERIFY, ...argv],
   const rootC = mkfix();
   const abs = path.join(rootC, rel);
   const winStyle = rel.split('/').join(path.sep);
-  const rC1 = run(['--test-cmd', `node ${mkCmd(0)}`, '--doc', winStyle], { cwd: rootC, env: { ...process.env, CHECK_LOOP_ROOT: rootC } });
+  run(['--test-cmd', `node ${mkCmd(0)}`, '--doc', winStyle], { cwd: rootC, env: { ...process.env, CHECK_LOOP_ROOT: rootC } });
   const eC1 = readLast(rootC);
-  const rC2 = run(['--test-cmd', `node ${mkCmd(0)}`, '--doc', abs], { cwd: rootC, env: { ...process.env, CHECK_LOOP_ROOT: rootC } });
+  run(['--test-cmd', `node ${mkCmd(0)}`, '--doc', abs], { cwd: rootC, env: { ...process.env, CHECK_LOOP_ROOT: rootC } });
   const eC2 = readLast(rootC);
   check('场景 8③：反斜杠 / posix / 绝对路径三种写法落同一 doc 值（归一是地基）',
     eC1 && eC1.doc === rel && eC2 && eC2.doc === rel, `win=${JSON.stringify(eC1 && eC1.doc)} abs=${JSON.stringify(eC2 && eC2.doc)}`);

package/templates/_agents/scripts/wiki-search.test.mjs

@@ -0,0 +1,58 @@
+// wiki-search.test.mjs — wiki 检索转发壳（2026-10-09 engine-quality-round2 A2 补测）
+// 壳语义三断言：①默认 -n 20 + --scope wiki 追加（固定语料=wiki 活跃层）；②用户显式 -n 不被覆盖；
+// ③exit 码透传（kb-search 非零 → 壳非零）。fixture 复制壳 + kb-search 及其依赖（workflow-enums/
+// 配置文件），wiki 语料一文件命中（kb-search.test 场景 1 已覆盖 kb-search 本体判定，此处只测壳）。
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { spawnSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+
+const SRC = path.dirname(fileURLToPath(import.meta.url));
+let pass = 0, fail = 0;
+const check = (name, cond, detail = '') => {
+  if (cond) { pass++; console.log(`PASS ${name}`); }
+  else { fail++; console.log(`FAIL ${name}${detail ? `——${detail}` : ''}`); }
+};
+
+const COPIED = ['wiki-search.mjs', 'kb-search.mjs', 'workflow-enums.mjs'];
+function mkFixture() {
+  const fx = fs.mkdtempSync(path.join(os.tmpdir(), 'ws-'));
+  fs.mkdirSync(path.join(fx, '.agents', 'scripts'), { recursive: true });
+  for (const f of COPIED) fs.copyFileSync(path.join(SRC, f), path.join(fx, '.agents', 'scripts', f));
+  for (const f of ['workflow-enums.txt', 'workflow-modules.txt'])
+    fs.copyFileSync(path.join(SRC, '..', f), path.join(fx, '.agents', f));
+  fs.mkdirSync(path.join(fx, 'wiki', '测试主题'), { recursive: true });
+  fs.writeFileSync(path.join(fx, 'wiki', '测试主题', '说明.md'), '# 说明\n\n编码模板的领域知识条目。\n');
+  fs.mkdirSync(path.join(fx, 'workflow', 'intents'), { recursive: true });
+  fs.writeFileSync(path.join(fx, 'workflow', 'intents', '2026-10-09-a.md'),
+    '---\n状态: approved\n级别: L1\n日期: 2026-10-09\n模块: pipeline\n---\n# INTENT\n\n编码模板的 workflow 侧条目。\n');
+  return fx;
+}
+const run = (fx, args) => spawnSync(process.execPath, [path.join(fx, '.agents', 'scripts', 'wiki-search.mjs'), ...args], {
+  cwd: fx, encoding: 'utf8',
+});
+
+{
+  const fx = mkFixture();
+  const r = run(fx, ['编码模板']);
+  const out = (r.stdout || '') + (r.stderr || '');
+  check('① 默认形态命中 wiki 语料且不含 workflow 语料（--scope wiki 固定）',
+    r.status === 0 && out.includes('wiki/测试主题/说明.md') && !out.includes('workflow/intents'), out.slice(0, 400));
+  fs.rmSync(fx, { recursive: true, force: true });
+}
+{
+  const fx = mkFixture();
+  const r = run(fx, ['-n', '0', '编码模板']);
+  check('② 显式 -n 透传（0=不限，不因壳默认覆盖报错）且命中', r.status === 0 && (r.stdout || '').includes('说明.md'), (r.stdout || '').slice(0, 300));
+  fs.rmSync(fx, { recursive: true, force: true });
+}
+{
+  const fx = mkFixture();
+  const r = run(fx, []); // 无词 → kb-search 用法错误 exit 1
+  check('③ exit 码透传（无词 → 壳非零）', (r.status ?? 1) !== 0, `status=${r.status}`);
+  fs.rmSync(fx, { recursive: true, force: true });
+}
+
+console.log(`\n合计: PASS ${pass} / FAIL ${fail}`);
+process.exit(fail ? 1 : 0);

package/templates/_agents/scripts/workflow-board-server.test.mjs

@@ -14,7 +14,6 @@ import { spawnSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
 import { parseLoopHardBlocks, parseAcceptance, detectAlerts, parseRunFile, runCard, safeRunPath } from './workflow-board-server.mjs';
 import { computeFingerprint } from './confirm-doc.mjs';
-import { stageBar } from './pipeline-run.mjs';
 
 let pass = 0;
 let fail = 0;

package/templates/_agents/scripts/workflow-enums.test.mjs

@@ -2,7 +2,6 @@
 // 判据：① 真实单源文件解析 + 不变量通过 ② 坏数据（坏行/重复键/重复值/缺键/子集破/重叠）fail-loud
 //       ③ 缺文件 fail-loud ④ sh 消费方同口径（sed 可取到全部 8 键）
 // 用法：node templates/_agents/scripts/workflow-enums.test.mjs（npm test 随跑）
-import fs from 'node:fs';
 import path from 'node:path';
 import { execSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';

package/templates/_agents/scripts-test-exempt.txt

@@ -2,9 +2,11 @@
 # 格式：<脚本名> | <豁免理由> | <覆盖证据（套件名；无自动化覆盖如实写「无」）>
 # 语义：登记 ≠ 免责——须写明理由与覆盖证据；无覆盖的登记是「工具/启动器豁免」，后续批次评估补测。
 # 新增引擎脚本默认必须带同名 .test.mjs（README 规范条目）；确属库件/工具才登记本文件。
+# 2026-10-09 A2 评估：verify-wiki-consistency 已移出（补测 3 场景）；wiki-search 已移出（转发壳，判定单源 kb-search.test 覆盖）。
 check-metric-claims.mjs | 经 check-loop.mjs 消费 | 由 check-loop.test.mjs 间接覆盖其调用路径
-ensure-board.mjs | 看板启动器（需真实端口/进程环境） | 无（工具豁免，后续批次评估补测）
+ensure-board.mjs | 看板启动器 | 永久工具豁免（需真实端口/进程环境，自动化覆盖无性价比——2026-10-09 engine-quality-round2 A2 评估定性）
 policy.mjs | 库件 | 被 check-loop.test.mjs 直接 import 覆盖
 stage-gates.mjs | 库件 | 被 check-loop.test.mjs 直接 import 覆盖（fill-*/confirm-doc.test 消费其行为）
-verify-wiki-consistency.mjs | wiki 一致性校验工具 | 无（工具豁免，后续批次评估补测）
-wiki-search.mjs | 检索库件 | 无（工具豁免，后续批次评估补测）
+# 2026-10-08 engine-quality-batch：pipeline-run 三层拆分的库件层——纯函数/存储层由 pipeline-run.test.mjs 全量覆盖（断言零改动全过），单建同名测试属形式主义（plan 偏离留痕 ①）
+pipeline-run-docs.mjs | 库件（文档纯函数层，2026-10-08 engine-quality-batch 拆分） | 由 pipeline-run.test.mjs 全量覆盖（断言零改动 29 组全过）
+pipeline-run-run.mjs | 库件（run 存储层，同上拆分） | 由 pipeline-run.test.mjs 全量覆盖（含 PIPELINE_RUN_* 注入契约场景）

package/templates/_github/workflows/kit-ci.yml

@@ -23,6 +23,26 @@ jobs:
           node-version: 22   # 按项目 engines 调整（kit 引擎要求 >=18）
       - name: 安装依赖（有根 package.json 才跑；私有源在此加 registry 配置）
         if: hashFiles('package.json') != ''
-        run: npm ci || npm install
+        run: npm ci || npm install || npm install --registry=https://registry.npmjs.org # 末级官方源兜底（2026-10-09 engine-quality-round3 W3：镜像故障不阻塞 CI）
       - name: 远端门（测试 + 闭环校验）
         run: node .agents/scripts/verify.mjs
+      - name: CI 红回溯点名（2026-10-09 engine-quality-round2 B3：红时列出最近关单，复核优先）
+        if: failure()
+        run: |
+          node -e "
+            try {
+              const fs = require('fs');
+              const p = '.agents/confirmations.jsonl';
+              if (!fs.existsSync(p)) process.exit(0);
+              const cut = Date.now() - 7 * 864e5;
+              const rows = fs.readFileSync(p, 'utf8').split(/\r?\n/).filter(Boolean)
+                .map((l) => { try { return JSON.parse(l); } catch { return null; } })
+                .filter((e) => e && e.ts && ['done', 'closed'].includes(e.stage) && Date.parse(e.ts) >= cut)
+                .map((e) => e.doc);
+              const uniq = [...new Set(rows)];
+              if (uniq.length) {
+                console.log('⚠️ CI 红——最近 7 天关单文档（优先复核是否本批引入）：');
+                for (const d of uniq) console.log('  - ' + d);
+              } else console.log('最近 7 天无关单记录');
+            } catch { /* 回溯是辅助面，读不到不添乱 */ }
+          "