agentic-flow-kit 1.5.0 → 1.6.0

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

@@ -5,6 +5,8 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { ENUMS } from './workflow-enums.mjs';
+import { spawnSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
 
 const TODAY = new Date().toISOString().slice(0, 10);
 const LEVELS = ENUMS['level.all']; // 级别词表单源（.agents/workflow-enums.txt）
@@ -36,12 +38,24 @@ const SECTIONS = [
   { title: '验收标准（可测试）', hint: '- [ ] <逐条可测试；写不出可测试判据 = 还没想清楚>\n\n> **闭环对账**：关单在 test 阶段（不依赖 deploy）。intent 置 done 前逐条勾验，每条补证据——`- [x] <判据>（证据：<commit SHA / 测试用例名 / 冒烟脚本输出>）`。\n> done 状态仍有未勾项会被 check-loop 拦截（2026-09-12 起新建 intent 为 hard-block，存量 intent 仅 warning 提示）；勾选但缺「证据：」为 hard-block。' },
 ];
 
-export function renderIntent({ topic, module, level, notes, date = TODAY }) {
+// renderIntent：骨架渲染（纯函数）。kbHits（2026-10-09 engine-quality-round3 W2）：kb-search 命中行
+// 数组（📄 行原文）——非空时替换「历史教训/防复发」节的检索占位行为实际命中列表（历史坑强制注入，
+// 手动路由与 pipeline-run 工单同权）；空/缺省保留占位（fail-open 口径）。子进程调用在 main，本函数保持无 IO。
+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';
   for (const { title, hint } of SECTIONS) {
-    body += '## ' + title + '\n\n' + hint + '\n\n';
+    let section = hint;
+    if (title === '历史教训/防复发') {
+      const placeholder = '- 检索结果：`node .agents/scripts/kb-search.mjs "<关键词>" --type incidents` 命中结果';
+      if (kbHits.length) {
+      const injected = '- 检索结果（自动注入 ' + kbHits.length + ' 条，同域历史——起草前先读其根因与防复发）：\n' + kbHits.map((h) => '  - ' + h).join('\n');
+      if (section.includes(placeholder)) section = section.replace(placeholder, injected);
+      }
+      else if (kbFailNote) section = section.replace('- 检索结果：', '- 检索结果' + kbFailNote + '\n- 检索结果：'); // 复核 P2-2：不可用时留手工命令注释行
+    }
+    body += '## ' + title + '\n\n' + section + '\n\n';
   }
   body += '## 确认与复核\n\n- 确认日期：\n- 确认人：用户（对话内明确放行即确认）\n- 确认范围：\n- 复核：L1 不要求独立复核\n';
   return { frontmatter: fm, body: fm + body, sections: SECTIONS.map((s) => s.title) };
@@ -52,7 +66,22 @@ if (isMain) {
   const a = parseArgs(process.argv.slice(2));
   if (!a.topic || !a.module || !a.output) fail('必填：--topic / --module / --output；选填：--level（默认 L1）/ --notes');
   if (!LEVELS.includes(a.level)) fail('level 必须在 ' + LEVELS.join('|') + '：' + a.level);
-  const { body } = renderIntent(a);
+  // 历史坑强制注入（2026-10-09 engine-quality-round3 W2）：同目录 kb-search 子进程检索同域历史
+  // （关键词 = topic ascii 段 + 模块名；--type incidents,plans——修复先例与计划同查）。fail-open：
+  // 非零/零命中/3s 超时 → kbHits 空 → 保留占位（与手动路由「AI 自觉检索」不同，此处机器保证尝试）。
+  let kbFailNote = '';
+  let kbHits = [];
+  try {
+    const words = (String(a.topic).toLowerCase().match(/[a-z0-9]{2,}/g) || []).slice(0, 2);
+    const kw = [...new Set([...words, String(a.module || '')].filter(Boolean))]; // 复核 P1-1：模块名入关键词（spec S2 口径）
+    const r = spawnSync(process.execPath, [path.join(path.dirname(fileURLToPath(import.meta.url)), 'kb-search.mjs'),
+      ...kw, '--scope', 'workflow', '--type', 'incidents,plans', '-n', '4'], { encoding: 'utf8', timeout: 3000, windowsHide: true });
+    if (r.status === 0 && r.stdout) {
+      kbHits = r.stdout.split(/\r?\n/).filter((l) => l.startsWith('📄')).slice(0, 4);
+    if (!kbHits.length) kbFailNote = '（自动检索不可用或零命中，手工跑：node .agents/scripts/kb-search.mjs "<关键词>" --type incidents）';
+    }
+  } catch { /* fail-open：检索不可用保留占位 */ }
+  const { body } = renderIntent({ ...a, kbHits, kbFailNote });
   fs.mkdirSync(path.dirname(a.output), { recursive: true });
   fs.writeFileSync(a.output, body);
   console.log('✅ 已生成 intent 草稿：' + a.output + '（状态 draft / 级别 ' + a.level + ' / 模块 ' + a.module + '）');

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

@@ -78,5 +78,18 @@ function check(name, cond, detail = '') {
   }
 }
 
+
+// ---- 历史坑注入 kbHits（2026-10-09 engine-quality-round3 W2）----
+{
+  const hits = ["📄 workflow/incidents/2026-10-01-aaa.md — closed · L2 · pipeline · 3 处命中 / 1KB"];
+  const { body } = renderIntent({ topic: 't', module: 'pipeline', level: 'L2', kbHits: hits });
+  check('kb 注入：命中行替换占位（含自动注入计数与 📄 原文）',
+    body.includes('检索结果（自动注入 1 条') && body.includes("📄 workflow/incidents/2026-10-01-aaa.md — closed · L2 · pipeline · 3 处命中 / 1KB") && !body.includes("- 检索结果：`node .agents/scripts/kb-search.mjs \"<关键词>\" --type incidents` 命中结果"), body.slice(0, 200));
+}
+{
+  const { body } = renderIntent({ topic: 't', module: 'pipeline', level: 'L2', kbHits: [] });
+  check('kb 零命中：保留占位（fail-open 口径）', body.includes("- 检索结果：`node .agents/scripts/kb-search.mjs \"<关键词>\" --type incidents` 命中结果"), body.slice(0, 200));
+}
+
 console.log('\n合计: PASS ' + pass + ' / FAIL ' + failCount);
 process.exit(failCount ? 1 : 0);

package/templates/_agents/scripts/gen-workflow-metrics.mjs

@@ -280,5 +280,56 @@ if (existing.includes(BEGIN) && existing.includes(END)) {
 } else {
   out = (existing ? existing.replace(/\s*$/, '') + '\n\n' : HEADER) + inner + '\n';
 }
-fs.writeFileSync(METRICS_P, out, 'utf8');
+
+// ---- 趋势序列 + 确认负担（2026-10-09 engine-quality-round3 W4）----
+// ① 确认负担：本月 confirmations.jsonl 行数（stage=void 除外）与上月比（口径：每次 confirm-doc 调用
+//    落一行——「确认门调用次数」即确认负担的机器事实；void 为作废标记不计）。
+// ② 趋势序列：.agents/cache/metrics-history.jsonl 每日一行幂等（同日重跑覆盖）——metrics.md「趋势」
+//    行对比昨日 docsTotal/confirmCalls；history 损坏重建（fail-open）。
+const HISTORY_P = path.join('.agents', 'cache', 'metrics-history.jsonl');
+const voidExcluded = ledgerRows.filter((e) => e.stage !== 'void');
+const monthOf = (e) => (typeof e.ts === 'string' ? e.ts.slice(0, 7) : '');
+const thisMonth = month.slice(0, 7); // month 变量 = 生成锚月（YYYY-MM）
+const prevMonthDate = new Date(thisMonth + '-01T00:00:00Z');
+prevMonthDate.setUTCMonth(prevMonthDate.getUTCMonth() - 1);
+const prevMonth = prevMonthDate.toISOString().slice(0, 7);
+const confirmThis = voidExcluded.filter((e) => monthOf(e) === thisMonth).length;
+const confirmPrev = voidExcluded.filter((e) => monthOf(e) === prevMonth).length;
+const confirmDelta = confirmPrev > 0 ? Math.round(((confirmThis - confirmPrev) / confirmPrev) * 100) : null;
+
+// docsTotal：metrics 主表本月行的文档数列（第一数值列）——从 row 提取，避免重复统计逻辑
+const docsTotal = docs.files; // 直取作用域变量（正则提取曾因「287（活跃…）」复合列失配——round3 实测修正）
+
+// history 读写（fail-open：损坏重建）
+let history = [];
+try {
+  if (fs.existsSync(HISTORY_P)) {
+    history = fs.readFileSync(HISTORY_P, 'utf8').split(/\r?\n/).filter(Boolean)
+      .map((l) => { try { return JSON.parse(l); } catch { return null; } }).filter(Boolean);
+  }
+} catch { history = []; }
+const today = new Date().toISOString().slice(0, 10);
+history = history.filter((h) => h && h.date !== today); // 同日幂等：覆盖当日行
+history.push({ date: today, docsTotal, passRate: funnel.closed ? Math.round((funnel.once / funnel.closed) * 100) + '%' : '', confirmCalls: confirmThis, savedAt: new Date().toISOString() });
+try {
+  fs.mkdirSync(path.dirname(HISTORY_P), { recursive: true });
+  const tmpH = HISTORY_P + '.tmp';
+  fs.writeFileSync(tmpH, history.map((h) => JSON.stringify(h)).join('\n') + '\n');
+  fs.renameSync(tmpH, HISTORY_P);
+} catch { /* history 写失败不影响 metrics.md 主产物 */ }
+
+// 趋势行（对比昨日快照）
+const yesterday = history.filter((h) => h.date !== today).slice(-1)[0];
+const trendParts = [];
+if (yesterday) {
+  trendParts.push('docs ' + docsTotal + '（昨日 ' + (yesterday.docsTotal ?? '?') + '）');
+  trendParts.push('确认调用 ' + confirmThis + '（昨日 ' + (yesterday.confirmCalls ?? '?') + '）');
+} else {
+  trendParts.push('无前值（history 首日）');
+}
+const trendLine = '> 趋势（环比昨日）：' + trendParts.join('；') + '；确认调用本月 ' + confirmThis + ' 次（上月 ' + confirmPrev + ' 次' + (confirmDelta === null ? '' : '，' + (confirmDelta >= 0 ? '+' : '') + confirmDelta + '%') + '；void 不计）';
+
+// 注入「闭环漏斗」节尾（inner 的 FUNNEL 段之后、END 之前）
+
+fs.writeFileSync(METRICS_P, out.replace(END, trendLine + '\n\n' + END), 'utf8');
 console.log(`✅ 已更新 workflow/metrics.md（${month} 行；共 ${rows.length} 个月）`);

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 = {
@@ -142,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/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/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-test-exempt.txt

@@ -2,12 +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 { /* 回溯是辅助面，读不到不添乱 */ }
+          "