agentic-flow-kit 1.8.2 → 2.0.0

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

@@ -1,253 +0,0 @@
-// wiki 三方一致性验证：磁盘 ↔ INDEX.md ↔ 知识沉淀总览.html(DATA) ＋ 数据维护台账登记 ＋ 看板链接可达性
-// 用法: node .agents/scripts/verify-wiki-consistency.mjs   （不一致 exit 1）
-// 约定见 .agents/skills/wiki/SKILL.md；归档 drafts-archive 仅计数，不参与文件比对。
-// 口径（2026-09-17 起，与 gen-wiki-board.mjs 保持一致）：主题目录顶层全量文件登记 +
-//      直属子目录中的 md/html 知识文档（排除 *.visual-check.* 工具产物；数据维护主题例外——
-//      其子目录 schema变更/<批次>/ 等走 README 台账，不参与三方文件比对与 summary 统计）；
-//      递归扫描仅用于「断链守卫 + 数据维护批次台账登记」两项断言，避免改变既有统计口径误报。
-import fs from 'node:fs';
-import path from 'node:path';
-import { execSync } from 'node:child_process';
-
-const WIKI = 'wiki';
-const problems = [];
-const notes = [];
-
-// 递归列目录（相对 dir 的路径，仅正斜杠）；drafts-archive 由调用方排除
-const walkTree = (dir, rel = '') => {
-  const acc = { files: [], dirs: [] };
-  for (const e of fs.readdirSync(dir)) {
-    const p = path.join(dir, e);
-    const r = rel ? `${rel}/${e}` : e;
-    if (fs.statSync(p).isDirectory()) {
-      acc.dirs.push(r);
-      const sub = walkTree(p, r);
-      acc.files.push(...sub.files);
-      acc.dirs.push(...sub.dirs);
-    } else acc.files.push(r);
-  }
-  return acc;
-};
-
-// ---- 磁盘枚举（登记口径与 gen-wiki-board.mjs 一致）----
-const isKnowledgeDoc = (f) => /\.(md|html)$/i.test(f) && !/\.visual-check\./i.test(f);
-// gitignore 豁免（F4，incident 2026-09-23-code-review-f3-f4-closeout）：drafts-archive 含
-// .gitignore 忽略的本机文件（如 *.xlsx），计入会使生成物计数在 fresh clone 必然漂移；
-// 口径 = 排除忽略文件（git 不可用/非仓库时退化为全量计数，fixture 环境不受影响）
-const gitIgnoredArchive = (() => {
-  try {
-    const out = execSync('git -c core.quotepath=false status --ignored=matching --porcelain -uall -- wiki',
-      { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] });
-    const prefix = 'wiki/';
-    return new Set(out.split(/\r?\n/)
-      .filter((l) => l.startsWith('!! '))
-      .map((l) => l.slice(3).trim().replace(/\/$/, ''))
-      .filter((p) => p.startsWith(prefix))
-      .map((p) => p.slice(prefix.length)));
-  } catch {
-    return new Set();
-  }
-})();
-const diskFiles = new Set(); // "主题/文件名"（子目录文件名带 子目录/ 前缀）
-const diskTopics = new Set();
-const activeTree = { files: [], dirs: [] }; // 递归视图（断链守卫 / 台账登记断言用）
-for (const d of fs.readdirSync(WIKI)) {
-  const p = path.join(WIKI, d);
-  if (!fs.statSync(p).isDirectory()) continue;
-  if (d === 'drafts-archive') continue;
-  diskTopics.add(d);
-  // gitignore 豁免消费（p2-batch2 复核 P1-3）：gen 侧排除 ignored 本机件，verify 须同口径——
-  // 否则「gen 恒写 N、verify 恒数 N+1」门禁死锁且自愈指引（重跑 gen）无效
-  const isIgnored = (rel) => { const k = rel.replace(/\/$/, ''); return gitIgnoredArchive.has(`${d}/${k}`) || gitIgnoredArchive.has(`${d}/${k}/`); }; // 尾斜杠归一（复核 P2-a）
-  for (const f of fs.readdirSync(p)) {
-    if (fs.statSync(path.join(p, f)).isFile() && !isIgnored(f)) diskFiles.add(`${d}/${f}`);
-  }
-  if (d !== '数据维护') {
-    for (const sub of fs.readdirSync(p)) {
-      const sp = path.join(p, sub);
-      if (!fs.statSync(sp).isDirectory()) continue;
-      for (const f of fs.readdirSync(sp)) {
-        if (fs.statSync(path.join(sp, f)).isFile() && isKnowledgeDoc(f) && !isIgnored(`${sub}/${f}`)) diskFiles.add(`${d}/${sub}/${f}`);
-      }
-    }
-  }
-  const sub = walkTree(p, d);
-  activeTree.files.push(...sub.files);
-  activeTree.dirs.push(...sub.dirs);
-}
-
-
-// drafts-archive 缺失：ENOENT 崩栈改明示失败（本脚本是门禁，协议目录被删应 exit 1 而非崩栈，2026-09-24）
-const ARCHIVE_DIR = path.join(WIKI, 'drafts-archive');
-let archiveCount = 0;
-if (fs.existsSync(ARCHIVE_DIR)) archiveCount = walkTree(ARCHIVE_DIR).files.filter((r) => !gitIgnoredArchive.has(`drafts-archive/${r}`)).length; // 集合键带 drafts-archive/ 前缀（复核 P2-b）
-else problems.push('wiki/drafts-archive/ 目录缺失（wiki 协议结构，模板自带）——归档一致性无从校验');
-
-// ---- 看板 DATA 解析 ----
-const html = fs.readFileSync(path.join(WIKI, '知识沉淀总览.html'), 'utf8');
-const m = html.match(/const DATA = (\{[\s\S]*?\n\});/);
-if (!m) {
-  console.error('❌ 看板 DATA 解析失败：知识沉淀总览.html 中找不到 `const DATA = {...}`');
-  process.exit(1);
-}
-// JSON.parse（p2-batch2）：DATA 由 gen-wiki-board 经 JSON.stringify 生成、必为合法 JSON——
-// eval 换 JSON.parse 消除门禁脚本对 repo 内文件执行任意 JS 的面；解析失败即 fail-loud 门禁失败
-let DATA;
-try {
-  DATA = JSON.parse(m[1]);
-} catch (e) {
-  console.error(`❌ 看板 DATA 不是合法 JSON（应跑 gen-wiki-board.mjs 重生成）：${e.message}`);
-  process.exit(1);
-}
-// 合计行比对（p2-batch2）：合计行有生成（fail-loud 锚点）无验证——手改/陈旧此前不可见
-{
-  const totalM = fs.readFileSync(path.join(WIKI, 'INDEX.md'), 'utf8').match(/合计：\*\*(\d+) 份\*\*知识文档，\*\*(\d+) 个主题\*\*/);
-  if (totalM) {
-    if (Number(totalM[1]) !== diskFiles.size || Number(totalM[2]) !== diskTopics.size) {
-      console.error(`❌ INDEX 合计行与磁盘不一致：合计 ${totalM[1]} 份/${totalM[2]} 主题 vs 磁盘 ${diskFiles.size} 份/${diskTopics.size} 主题——跑 gen-wiki-board.mjs 重生成`);
-      process.exit(1);
-    }
-  }
-}
-const boardFiles = new Set();
-for (const t of DATA.topics) for (const f of t.files) boardFiles.add(`${t.name}/${f.file}`);
-const boardTopics = new Set(DATA.topics.map((t) => t.name));
-
-// ---- INDEX 映射表解析 ----
-const indexFiles = new Set();
-const indexTopicCounts = new Map(); // 速览表 topic → 文件数
-for (const line of fs.readFileSync(path.join(WIKI, 'INDEX.md'), 'utf8').split(/\r?\n/)) {
-  const mm = line.match(/^\| ([^|]+) \| ([^|]+) \| wiki\/([^/]+)\/[^|]*\|$/);
-  if (mm) indexFiles.add(`${mm[3].trim()}/${mm[1].trim()}`);
-  // 速览行用途列容忍转义管道（p2-batch2 复核 P2-4：gen 侧转义写入后本解析须同款，否则该主题计数核对静默跳过）
-  const ov = line.match(/^\| ([^|]+) \| (\d+) \|((?:\\.|[^|])*)\|$/);
-  if (ov && ov[1].trim() !== '主题') indexTopicCounts.set(ov[1].trim().replace(/\\\|/g, '|'), Number(ov[2]));
-}
-
-const diff = (a, b) => [...a].filter((x) => !b.has(x));
-
-// ---- 1. 文件级三方比对 ----
-for (const [label, extra] of [
-  ['看板→磁盘', diff(boardFiles, diskFiles)],
-  ['磁盘→看板', diff(diskFiles, boardFiles)],
-  ['INDEX→磁盘', diff(indexFiles, diskFiles)],
-  ['磁盘→INDEX', diff(diskFiles, indexFiles)],
-]) {
-  if (extra.length) problems.push(`文件集合不一致（${label}）: ${extra.join('；')}`);
-}
-if (problems.length === 0) notes.push(`文件级三方一致：${diskFiles.size} 份`);
-
-// ---- 2. 幽灵目录：磁盘有主题目录但看板没有 ----
-const ghosts = diff(diskTopics, boardTopics);
-if (ghosts.length) problems.push(`磁盘存在看板未登记的主题目录: ${ghosts.join('、')}`);
-
-// ---- 3. 占位主题（看板有、磁盘 0 文件）——允许，仅提示 ----
-for (const t of DATA.topics) {
-  if (t.files.length === 0 && fs.existsSync(path.join(WIKI, t.name))) {
-    const real = fs.readdirSync(path.join(WIKI, t.name)).filter((f) => fs.statSync(path.join(WIKI, t.name, f)).isFile()).length;
-    if (real > 0) problems.push(`看板主题「${t.name}」files 为空但磁盘有 ${real} 个文件`);
-    else notes.push(`占位主题「${t.name}」：0 文件（允许）`);
-  } else if (t.files.length === 0) {
-    problems.push(`看板主题「${t.name}」files 为空且磁盘无此目录`);
-  }
-}
-
-// ---- 4. INDEX 速览表文件数 vs 磁盘 ----
-for (const [topic, count] of indexTopicCounts) {
-  const actual = [...diskFiles].filter((f) => f.startsWith(topic + '/')).length;
-  if (!diskTopics.has(topic) && count > 0) problems.push(`INDEX 速览表主题「${topic}」(${count}) 磁盘无此目录`);
-  else if (actual !== count) problems.push(`INDEX 速览表「${topic}」标 ${count}，磁盘实际 ${actual}`);
-}
-
-// ---- 5. summary 统计字段 ----
-const s = DATA.summary;
-const sumChecks = [
-  ['summary.total', s.total, diskFiles.size],
-  ['summary.files', s.files, diskFiles.size],
-  ['summary.topics', s.topics, DATA.topics.length],
-  ['summary.archive', s.archive, archiveCount],
-];
-for (const [label, declared, actual] of sumChecks) {
-  if (declared !== actual) problems.push(`${label}=${declared}，实际 ${actual}`);
-}
-
-// ---- 6. 活跃文件禁 file:/// 绝对链（搬家断链防复发；递归覆盖子目录）----
-const badLinks = [];
-for (const f of activeTree.files) {
-  if (!/\.(md|html)$/i.test(f)) continue;
-  if (fs.readFileSync(path.join(WIKI, f), 'utf8').includes('file:///')) badLinks.push(f);
-}
-if (badLinks.length) problems.push(`以下活跃文件含 file:/// 绝对路径链接: ${badLinks.join('、')}`);
-
-// ---- 7. 数据维护台账登记：子目录（含批次目录）须在 wiki/数据维护/README.md 有登记行 ----
-// 「数据维护走 README 台账」是可选主题约定——目录不存在（新项目未建该主题）时整体跳过
-const maintLedger = path.join(WIKI, '数据维护', 'README.md');
-if (fs.existsSync(maintLedger)) {
-const maintReadme = fs.readFileSync(maintLedger, 'utf8');
-const maintReadmeFlat = maintReadme.replace(/\s+/g, ''); // README 标题写作「schema 变更」（带空格），故去空白再比对
-const maintDirs = activeTree.dirs.filter((d) => d.startsWith('数据维护/'));
-const unregistered = maintDirs
-  .map((d) => d.split('/').pop())
-  .filter((name) => !maintReadme.includes(name) && !maintReadmeFlat.includes(name.replace(/\s+/g, '')));
-if (unregistered.length) problems.push(`数据维护台账未登记（wiki/数据维护/README.md 无此行）：${unregistered.join('、')}`);
-else notes.push(`数据维护台账登记完整：${maintDirs.length} 个子目录（含批次目录）均有登记`);
-}
-
-// ---- 8. 看板链接可达性：DATA.dir（「打开目录」href）+ 静态相对 href 解析后须存在 ----
-const deadLinks = [];
-for (const t of DATA.topics) {
-  for (const f of t.files) {
-    const p = path.join(WIKI, f.dir); // 看板自身位于 wiki/，dir 为相对它解析
-    if (!fs.existsSync(p) || !fs.statSync(p).isDirectory()) deadLinks.push(`${t.name}/${f.file} → ${f.dir}`);
-  }
-}
-// 静态 href 扫描守的是「手工编辑看板」时加的链接（生成链接全在 JS 运行时拼，不落静态属性）——看板是 owned 内容，人为改动须可达
-for (const m2 of html.matchAll(/href="([^"]+)"/g)) {
-  const href = m2[1];
-  if (/^(https?:|mailto:|#)/i.test(href) || href.includes('${')) continue; // 外链 / 锚点 / 模板占位
-  if (!fs.existsSync(path.join(WIKI, href))) deadLinks.push(`静态 href → ${href}`);
-}
-if (deadLinks.length) problems.push(`看板链接指向不存在的路径（相对 wiki/ 解析）: ${deadLinks.join('；')}`);
-
-// ---- 9. 来源血缘（B3，2026-10-10）：wiki frontmatter「来源: workflow/<类型>/<文件>」指回 workflow 归档 ----
-// 与 intent/incident 的正向「沉淀:」字段对称闭环——双向链接任一端指向不存在的文件即断链。
-// 校验面：活跃层知识文档（.md/.html，含子目录递归）。无 frontmatter / 无来源键的老文件零影响。
-// drafts-archive 草稿的来源校验降级为提示（草稿是中间态，来源 intent 可能尚未在仓库——B2 落的草稿
-//   在 intent done 前生成，此时断链属预期），不进 problems。
-// 注意：activeTree 只含活跃主题目录（drafts-archive 在枚举处被排除），草稿须另行扫描归档树。
-const fmGet = (text, key) => {
-  const m = text.match(/^---\r?\n([\s\S]*?)\r?\n---/);
-  if (!m) return null;
-  const kv = m[1].split(/\r?\n/).map((l) => l.match(/^(\S+):\s*(.*)$/)).find((x) => x && x[1] === key);
-  return kv ? kv[2].trim() : null;
-};
-let brokenSources = 0;
-const checkSource = (f, isDraft) => {
-  let text;
-  try { text = fs.readFileSync(path.join(WIKI, f), 'utf8'); } catch { return; }
-  const src = fmGet(text, '来源');
-  if (!src) return;
-  if (fs.existsSync(src)) return;
-  if (isDraft) notes.push(`草稿 ${f} 来源未落地（草稿中间态，归类前允许）：${src}`);
-  else { problems.push(`来源断链：${f} frontmatter「来源: ${src}」指向的文件不存在`); brokenSources++; }
-};
-for (const f of activeTree.files) {
-  if (!/\.(md|html)$/i.test(f)) continue;
-  checkSource(f, false);
-}
-if (fs.existsSync(ARCHIVE_DIR)) {
-  for (const f of walkTree(ARCHIVE_DIR).files) {
-    if (!/\.(md|html)$/i.test(f)) continue;
-    checkSource(`drafts-archive/${f}`, true);
-  }
-}
-if (brokenSources === 0) notes.push('来源血缘有效：活跃层 wiki 文件的「来源」均指向存在的 workflow 归档');
-
-// ---- 输出 ----
-for (const n of notes) console.log('ℹ️  ' + n);
-if (problems.length) {
-  console.error('\n❌ wiki 一致性校验失败：');
-  for (const p of problems) console.error('  - ' + p);
-  process.exit(1);
-}
-console.log(`✅ wiki 三方一致：文件 ${diskFiles.size} 份 / 主题 ${DATA.topics.length} 个（含占位）/ 归档 ${archiveCount} 份`);

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

@@ -1,123 +0,0 @@
-// 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, draftSource = null } = {}) {
-  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');
-  let archiveCount = 0;
-  if (!noArchive) fs.mkdirSync(path.join(fx, 'wiki', 'drafts-archive'), { recursive: true });
-  if (draftSource) { // B2 落的草稿形态：drafts-archive/<日期-主题>/ 下带来源 frontmatter
-    fs.mkdirSync(path.join(fx, 'wiki', 'drafts-archive', '2026-09-12-主题'), { recursive: true });
-    fs.writeFileSync(path.join(fx, 'wiki', 'drafts-archive', '2026-09-12-主题', '草稿.md'),
-      `---\n来源: ${draftSource}\n---\n# 草稿\n`);
-    archiveCount = 1;
-  }
-  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: archiveCount },
-  };
-  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 });
-}
-
-// ---- ④⑤⑥ 来源血缘校验（B3，2026-10-10，第 9 项）----
-{
-  // ④ 活跃层来源断链 → exit 1
-  const fx = mkWiki();
-  fs.writeFileSync(path.join(fx, 'wiki', '主题A', '文档1.md'),
-    '---\n来源: workflow/intents/2026-09-12-不存在.md\n---\n# 文档1\n\n无外链。\n');
-  const r = run(fx);
-  const out = (r.stdout || '') + (r.stderr || '');
-  check('④ 活跃层来源断链 → exit 1 且点名断链',
-    r.status === 1 && out.includes('来源断链') && out.includes('不存在.md'), `status=${r.status}\n${out.slice(0, 500)}`);
-  fs.rmSync(fx, { recursive: true, force: true });
-}
-{
-  // ⑤ 活跃层来源指向存在的文件 → exit 0 且血缘有效提示
-  const fx = mkWiki();
-  fs.writeFileSync(path.join(fx, 'wiki', '主题A', '文档1.md'),
-    '---\n来源: workflow/intents/2026-09-12-真单.md\n---\n# 文档1\n\n无外链。\n');
-  fs.mkdirSync(path.join(fx, 'workflow', 'intents'), { recursive: true });
-  fs.writeFileSync(path.join(fx, 'workflow', 'intents', '2026-09-12-真单.md'), '# INTENT\n');
-  const r = run(fx);
-  const out = (r.stdout || '') + (r.stderr || '');
-  check('⑤ 活跃层来源有效 → exit 0 且提示血缘有效',
-    r.status === 0 && out.includes('来源血缘有效'), `status=${r.status}\n${out.slice(0, 500)}`);
-  fs.rmSync(fx, { recursive: true, force: true });
-}
-{
-  // ⑥ 草稿来源未落地 → 仅提示不阻断（草稿中间态，归类前允许）
-  const fx = mkWiki({ draftSource: 'workflow/incidents/2026-09-12-未闭环.md' });
-  const r = run(fx);
-  const out = (r.stdout || '') + (r.stderr || '');
-  check('⑥ 草稿来源未落地 → exit 0 且降级提示（不阻断）',
-    r.status === 0 && out.includes('草稿中间态'), `status=${r.status}\n${out.slice(0, 500)}`);
-  fs.rmSync(fx, { recursive: true, force: true });
-}
-
-console.log(`\n合计: PASS ${pass} / FAIL ${fail}`);
-process.exit(fail ? 1 : 0);

package/templates/_agents/scripts/verify.mjs

@@ -1,210 +0,0 @@
-#!/usr/bin/env node
-// verify.mjs — 关单/CI 统一静态门编排（GATES 表版；2026-10-13 自 Shipyard.Material 参考实现回灌，
-// 源仓沿革留痕在包源仓 git 历史与 CHANGELOG——装户径不引实例路径）
-// 用途：关单或 CI 前一键过门——engine cohort 七门按表执行、逐项输出 pass/fail，任一门红即 fail-fast exit 1。
-// 语义：单源口径。本地 verify 与装户远端门（kit-ci.yml 同一条命令）行为 100% 一致。
-// 凭证落账：全绿才落绿凭证；任一门红即落失败行（suite=门 id），供根因分析——消费方（confirm-doc 前置 /
-//   check-loop 检查 8）只认 exitCode===0 的行，失败行零污染凭证判定。
-// 七门照搬源仓 engine cohort（不搬 product cohort——frontend/backend 门是源仓项目私有；lane-surface-ci 门
-//   依赖 kit 侧 --ci 支持核实，留后续批次评估）。源仓 --engine 增量语义不移植：本表已全为引擎段，
-//   「部分绿 ≠ 全量凭证」的分野不存在。
-// kit 特有语义（沿现口径保留）：
-//   a) 装户仓判定——cwd 无 package.json → engine-tests 门显式跳过（跳过≠通过，不计入门数）且**不落
-//      测试绿凭证**（凭证语义 = 测试真跑绿，防假绿），提示 --test-cmd；
-//   b) 凭证行形状 = {ts, exitCode:0, suite:'npm test', gates, headShort?, passed?, failed?, doc?, runId?}
-//      （gates/headShort 自源仓回灌新增——非 git 环境解析失败则省略、不伪造；消费方只读 ts/exitCode/doc，
-//       增量字段零影响）；计数捕获只认编排器权威行 `[run-tests] 合计: SUITES n / FAILED m`
-//       （嵌套套件同形行不回退——宁缺勿错，exitCode 才是硬事实）；
-//   c) --doc 绑定语义保留（归一基准 = ROOT，与 confirm-doc / 检查 8 三处同源）；
-//   d) --test-cmd 为 fixture 测试注入缝：替换全部生产门为 [test, check-loop] 两门夹具（夹具根里没有
-//      脚本本体，check-loop 用绝对路径直调，root 归属仍由 CHECK_LOOP_ROOT 裁决）；夹具模式不触发生效规则
-//      视图门与摘要生成（假门凭证只进本地台账，不产 committed 摘要）。
-// 未执行门清单：fail-fast 后序门状态未知≠通过——验证系统输出须完备（「没跑」与「过了」可区分）。
-// 生效规则视图门（effective-policy --check）：policy 变更后必须重生成 workflow/effective-policy.md 随同
-//   提交——新装户由 init 生成器首跑种子该文件，缺文件对 --check 是漂移（红），不静默放行。
-// 绿凭证摘要（gen-verify-evidence.mjs）：全绿尾部自动重生成 workflow/verify-evidence.md——全绿事实与
-//   仓内摘要同刻生成，消除「本地台账已绿、committed 摘要滞后」的双真相分叉；生成失败响亮告警但不推翻绿裁决。
-// 用法：node .agents/scripts/verify.mjs [--list] [--test-cmd "<shell 命令>"] [--stub-gate "<命令>"] [--doc <本单 workflow 路径>]
-//   --list：按执行序打印门 id 后退出，不执行（与 --test-cmd / --stub-gate 互斥）。
-//   --test-cmd 用于测试注入，或在无根 package.json 的装户仓指定项目测试命令；
-//   --stub-gate <命令>（2026-10-16 自源仓回灌）：单门夹具但走**生产尾段**（落凭证 / 生成摘要）——
-//     与 --test-cmd 的差异是不打 testCmd 标记、尾段按生产路径执行；**必须配 CHECK_LOOP_ROOT**（夹具根），
-//     禁止在真实仓库写出可被当成关单凭证的绿行。
-//   --doc 把凭证绑到本单，如 --doc workflow/intents/<日期>-<主题>.md
-// 测试：node templates/_agents/scripts/verify.test.mjs（--test-cmd 注入假命令 + CHECK_LOOP_ROOT 注入夹具）
-import fs from 'node:fs';
-import { spawnSync } from 'node:child_process';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
-const ROOT = process.env.CHECK_LOOP_ROOT || path.resolve(SCRIPT_DIR, '..', '..');
-
-// --- 门禁定义（engine cohort 七门，序即执行序；遇红即停） ---
-const GATES = [
-  { id: 'scripts-syntax', name: '引擎脚本语法自检', cmd: 'node .agents/scripts/check-scripts-syntax.mjs', folder: '.', type: 'shell' },
-  { id: 'engine-tests', name: '测试门 (npm test)', cmd: 'npm test', folder: '.', type: 'shell' },
-  { id: 'workflows-check', name: '编排脚本检查', cmd: 'node .agents/scripts/workflows-check.mjs', folder: '.', type: 'shell' },
-  { id: 'rule-budget', name: '常驻面预算检查', cmd: 'node .agents/scripts/rule-budget.mjs --all', folder: '.', type: 'shell' },
-  { id: 'effective-policy', name: '生效规则视图漂移检查', cmd: 'node .agents/scripts/gen-effective-policy.mjs --check', folder: '.', type: 'shell' },
-  // 默认硬门。卫生段不进关单（2026-10-13 B6b-1 分道随源仓口径）：要看时另跑 check-loop.mjs --hygiene。
-  { id: 'check-loop', name: '闭环门禁校验', cmd: 'node .agents/scripts/check-loop.mjs', folder: '.', type: 'shell' },
-  { id: 'ledger-invariant', name: '确认台账不变量（历史全扫）', cmd: 'node .agents/scripts/check-ledger-invariant.mjs', folder: '.', type: 'shell' },
-];
-
-// fixture 夹具门（--test-cmd 注入时替换全部生产门，verify.test.mjs 断言依赖此口径）
-// check-loop 用绝对路径直调真实脚本——夹具根里没有脚本本体，root 归属仍由 CHECK_LOOP_ROOT 裁决。
-const fixtureGates = (cmd) => [
-  { id: 'test', name: '测试步（注入）', cmd, folder: '.', type: 'shell' },
-  { id: 'check-loop', name: '闭环门禁校验', cmd: `node "${path.join(SCRIPT_DIR, 'check-loop.mjs')}"`, folder: '.', type: 'shell' },
-];
-
-const args = process.argv.slice(2);
-const explicitTestCmd = args.includes('--test-cmd') ? args[args.indexOf('--test-cmd') + 1] : null;
-
-// --stub-gate（2026-10-16 自源仓 13f67ef7 回灌）：单门夹具但走**生产尾段**（落凭证 / 生成摘要）。
-// 与 --test-cmd 的关键差异：不打 testCmd 标记（fixture 模式绿行带 testCmd:true，生产凭证不与之混淆）。
-// **必须配 CHECK_LOOP_ROOT**——禁止在真实仓库写出可被当成关单凭证的绿行（信任边界：夹具单门不是关单凭证）。
-const stubIdx = args.indexOf('--stub-gate');
-const stubCmd = stubIdx >= 0 ? args[stubIdx + 1] : null;
-if (stubIdx >= 0 && !stubCmd) {
-  console.error('[verify] --stub-gate 需要一条命令');
-  process.exit(2);
-}
-if (stubCmd && explicitTestCmd) {
-  console.error('[verify] --stub-gate 与 --test-cmd 互斥');
-  process.exit(2);
-}
-if (stubCmd && !process.env.CHECK_LOOP_ROOT) {
-  console.error('[verify] --stub-gate 只允许配合 CHECK_LOOP_ROOT 夹具根（禁止在真实仓库落无关单凭证）');
-  process.exit(2);
-}
-
-// --doc 解析（沿 --test-cmd 同款取下一 argv 的写法；缺值报用法错误 exit 1 与 --test-cmd 对称）。
-// 归一基准 = **ROOT**（不是 cwd）——消费方两处都以仓库根为基准（check-loop 检查 8 用
-// path.relative(ROOT, intent)；confirm-doc 的 docRelOf 用 path.resolve(root, doc)）。若这里按 cwd
-// 解析而进程不在仓库根（CI / 钩子 / CHECK_LOOP_ROOT 注入夹具），落下的 doc 会是跨目录长路径，
-// 凭证永远匹配不上——**基准必须三处同源**。
-// 不校验目标文件是否存在：凭证记录的是「跑了什么」而非「被证明对象是否有效」，存在性校验属裁决，
-// 越界（沿本件「只编排不裁决」语义）。
-if (args.includes('--doc') && !args[args.indexOf('--doc') + 1]) {
-  console.error('verify: --doc 缺值——用法 node .agents/scripts/verify.mjs [--test-cmd "<shell 命令>"] [--doc <本单 workflow 路径>]');
-  process.exit(1);
-}
-const docArg = args.includes('--doc') ? args[args.indexOf('--doc') + 1] : null;
-const docRel = docArg
-  ? path.relative(ROOT, path.resolve(ROOT, docArg)).split(path.sep).join('/')
-  : null;
-
-// 装户仓判定：engine-tests 门只在**当前目录**有 package.json 时才跑（npm test 亦在该目录执行）。
-// 跳过时后续不落测试绿凭证（见全绿落账段）。显式 --test-cmd 不受此判定影响。
-const hasRootPackageJson = fs.existsSync(path.join(process.cwd(), 'package.json'));
-const skipTest = explicitTestCmd === null && stubCmd === null && !hasRootPackageJson;
-const gates = explicitTestCmd ? fixtureGates(explicitTestCmd)
-  : stubCmd ? [{ id: 'stub', name: '夹具单门', cmd: stubCmd, folder: '.', type: 'shell' }]
-  : GATES;
-
-if (args.includes('--list')) {
-  if (explicitTestCmd || stubCmd) {
-    console.error('[verify] --list 与 --test-cmd / --stub-gate 互斥');
-    process.exit(1);
-  }
-  for (const g of gates) console.log(g.id);
-  process.exit(0);
-}
-
-// 失败留痕：失败行 {ts, exitCode, suite:门 id, note}——append-only 事实记录，供根因分析；
-// 消费方只认 exitCode===0 的绿行，失败行零污染凭证判定。IO 失败出账不阻断。
-const recordFailure = (step, exitInfo, note) => {
-  try {
-    const entry = { ts: new Date().toISOString(), exitCode: typeof exitInfo === 'number' ? exitInfo : -1, suite: step, note };
-    if (process.env.PIPELINE_RUN_ID) entry.runId = process.env.PIPELINE_RUN_ID;
-    fs.mkdirSync(path.join(ROOT, '.agents'), { recursive: true });
-    fs.appendFileSync(path.join(ROOT, '.agents', 'verifications.jsonl'), `${JSON.stringify(entry)}\n`);
-    console.log(`[verify] 🧾 失败行已留痕 verifications.jsonl（suite=${step}）`);
-  } catch (e) {
-    console.error(`[verify] ⚠️ 失败行落账失败（${e.code || e.message}）`);
-  }
-};
-
-console.log(`[verify] 🚀 开始静态门验证 (共 ${gates.length} 项)${explicitTestCmd ? '【fixture 模式】' : ''}${stubCmd ? '【stub 尾段】' : ''}\n`);
-
-let passedCount = 0;
-const outputs = {};
-
-for (let i = 0; i < gates.length; i++) {
-  const gate = gates[i];
-  // 装户仓：engine-tests 门显式跳过——跳过≠通过，不计入 passedCount、不算绿（全绿落账段据此不落凭证）
-  if (skipTest && gate.id === 'engine-tests') {
-    console.log(`[verify] ⏭ ${i + 1}/${gates.length} 跳过 ${gate.cmd}：当前目录无 package.json（装户仓）——请按项目口径手工跑测试，或用 --test-cmd "<项目测试命令>" 指定后重跑`);
-    continue;
-  }
-  console.log(`[verify] ▶ ${i + 1}/${gates.length} ${gate.name}...`);
-
-  const result = spawnSync(gate.cmd, {
-    shell: true,
-    encoding: 'utf8',
-    cwd: path.join(ROOT, gate.folder),
-    maxBuffer: 32 * 1024 * 1024,
-  });
-
-  if (result.stdout) process.stdout.write(result.stdout);
-  if (result.stderr) process.stderr.write(result.stderr);
-
-  if (result.status !== 0) {
-    const note = `exit ${result.status ?? result.error?.code}`;
-    console.error(`[verify] ❌ ${i + 1}/${gates.length} ${gate.name} 未通过 (${note})`);
-    // 未执行门清单：fail-fast 后序门状态未知≠通过——「没跑」在台账里与「过了」不可区分即输出不完备
-    const remaining = gates.slice(i + 1).map((g) => g.id);
-    if (remaining.length) console.error(`[verify] ⏭️ 未执行门（fail-fast，状态未知）：${remaining.join('、')}`);
-    recordFailure(gate.id, result.status, note);
-    process.exit(1);
-  }
-  outputs[gate.id] = result.stdout || '';
-  console.log(`[verify] ✅ ${i + 1}/${gates.length} ${gate.name} 通过\n`);
-  passedCount++;
-}
-
-// 凭证落账：全部门绿才落（任一门红已在上面 fail-fast 退出）；**测试门被跳过同样不落**
-// （测试未跑即无「测试绿」事实，落账即假绿）；IO 失败出账不阻断
-try {
-  if (skipTest) {
-    console.log('[verify] ⚠️ 测试门已跳过——本次不落测试绿凭证（凭证语义 = 测试真跑绿）');
-  } else {
-    const entry = { ts: new Date().toISOString(), exitCode: 0, suite: 'npm test' };
-    // 门数：凭证明此记录「过全量门禁全绿」是几门（fixture 模式 = 2 门夹具，仍如实记）
-    entry.gates = passedCount;
-    // HEAD 短 SHA 钉进绿行本体（源仓回灌）：确定性证据此前只存在于测试夹具、绿行无 SHA 可锚定验证对象；
-    // 非 git 环境（fixture 根在 os.tmpdir）解析失败则省略该键，不伪造。
-    const rev = spawnSync('git', ['rev-parse', '--short', 'HEAD'], { encoding: 'utf8', cwd: ROOT });
-    if (rev.status === 0 && rev.stdout) entry.headShort = rev.stdout.trim();
-    // 计数行**只认编排器权威前缀**：嵌套套件同形行不回退——非本编排器口径的 --test-cmd
-    //（装户项目自有测试命令）抓不到即省略计数键，不回退到错的事实（宁缺勿错，exitCode 才是硬事实）。
-    const m = [...(outputs['engine-tests'] || outputs['test'] || '').matchAll(/\[run-tests\] 合计: SUITES (\d+) \/ FAILED (\d+)/g)].pop();
-    if (m) { entry.passed = Number(m[1]); entry.failed = Number(m[2]); }
-    if (process.env.PIPELINE_RUN_ID) entry.runId = process.env.PIPELINE_RUN_ID;
-    // doc 键：未传 --doc 时**不写该键**（不是写 null）——消费方按 doc 精确匹配，undefined 与 null 都恒不命中，
-    // 但缺键让「本行没有绑定对象」这件事在台账盘面上直接可读。
-    if (docRel) entry.doc = docRel;
-    fs.mkdirSync(path.join(ROOT, '.agents'), { recursive: true });
-    fs.appendFileSync(path.join(ROOT, '.agents', 'verifications.jsonl'), `${JSON.stringify(entry)}\n`);
-    console.log(`[verify] 🧾 测试绿凭证已落账 verifications.jsonl${entry.passed !== undefined ? `（套件 ${entry.passed} / FAIL ${entry.failed}）` : ''}${docRel ? ` 绑定本单 ${docRel}` : '（未带 --doc：不给任何单背书）'}`);
-  }
-} catch (e) {
-  console.error(`[verify] ⚠️ 凭证落账失败（${e.code || e.message}）——不阻断，关单门前置将按无凭证告警`);
-}
-
-// 摘要事件原子化：全绿事实与仓内摘要（workflow/verify-evidence.md）同刻生成，消除「本地台账已绿、
-// committed 摘要滞后」的双真相分叉。仅生产模式（fixture 假门凭证不产 committed 摘要；测试门跳过时
-// 本就无凭证）；stub 尾段按生产路径执行（摘要落在 CHECK_LOOP_ROOT 夹具根，不触真实仓）。
-// 生成失败响亮告警但不推翻绿裁决（同落账口径）。
-if (!explicitTestCmd && !skipTest) {
-  const gen = spawnSync(process.execPath, [path.join(SCRIPT_DIR, 'gen-verify-evidence.mjs'), '--root', ROOT], { encoding: 'utf8' });
-  if (gen.status === 0) {
-    if (gen.stdout) process.stdout.write(String(gen.stdout).trimEnd() + '\n');
-  } else {
-    console.error(`[verify] ⚠️ 绿凭证摘要生成失败（${String(gen.stderr || gen.stdout || '').trim().slice(0, 200)}）——绿裁决不变，手动补跑 node .agents/scripts/gen-verify-evidence.mjs`);
-  }
-}
-
-console.log(`\n[verify] 🎉 全绿——可以关单（共 ${passedCount} 项通过；逐条勾验验收标准补证据后 intent/plan → done）`);