agentic-flow-kit 1.8.2 → 2.0.0

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

@@ -1,334 +0,0 @@
-#!/usr/bin/env node
-// workflow 规模与规则面月度快照（2026-09-21，intent 2026-09-21-workflow-metrics-snapshot）
-// 用法：node .agents/scripts/gen-workflow-metrics.mjs [--month YYYY-MM] [--dry-run] [--help]
-// 目的：把「语料膨胀 + 常驻面体积」变成可观测趋势——每月（或按需）跑一次，往 workflow/metrics.md 追加/更新一行。
-// 口径：文档 = 磁盘（对照 gen-workflow-index / 看板，排除 _TEMPLATE.md）；常驻面 = `.agents/rule-budgets.txt`
-//   各条实测（单源，含预算上限），括号内给「预算占用峰值项」。
-//   字节口径声明（p2-batch2）：本脚本用工作区 statSync 字节（CRLF 检出态会偏高），rule-budget.mjs 用
-//   索引 LF 归一字节——趋势观测可对比，但与门禁判定数值存在系统性差异，勿互相替用。
-// 不做 --check / 不挂门禁：快照是历史记录——任何文档改动都会让「当前值」漂移，拿它做漂移校验只会常红；
-//   规则面的机器约束由 pre-commit 的 rule-budget.mjs 负责，本脚本只负责「看见趋势」。
-// 测试：node .agents/scripts/gen-workflow-metrics.test.mjs（fixture 回归，须全绿）
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { loadEnums } from './workflow-enums.mjs';
-import { readLedgerRows as loadLedgerRows } from './ledger-loader.mjs';
-import { analyze, buildDocList, loadLastTouch, loadLedgerTs, parseStatus, ACTIVE } from './archive-sweep.mjs';
-
-const USAGE = `用法：node .agents/scripts/gen-workflow-metrics.mjs [--month YYYY-MM] [--dry-run] [--help]
-
-事实源：workflow/{intents,specs,plans,incidents}/*.md（排除 _TEMPLATE.md）+ workflow/INDEX.md + .agents/rule-budgets.txt
-产物：workflow/metrics.md —— 每月一行（同月重跑即更新该行，不重复追加）；明细打印在 stdout，不落表。
-选项：
-  --month YYYY-MM   指定月份键（默认取当前月；用于补记历史）
-  --dry-run         只打印将写入的行与明细，不写盘
-  --help            打印本说明`;
-
-const args = process.argv.slice(2);
-if (args.includes('--help') || args.includes('-h')) { console.log(USAGE); process.exit(0); }
-const DRY = args.includes('--dry-run');
-let month = '';
-for (let i = 0; i < args.length; i++) if (args[i] === '--month') month = args[++i] ?? '';
-const unknown = [];
-for (let i = 0; i < args.length; i++) {
-  const a = args[i];
-  if (a === '--dry-run' || a === '--help' || a === '-h') continue;
-  if (a === '--month') { i++; continue; }
-  unknown.push(a);
-}
-if (unknown.length) { console.error(`❌ 未知参数：${unknown.join(' ')}\n\n${USAGE}`); process.exit(1); }
-if (!month) month = new Date().toISOString().slice(0, 7);
-if (!/^\d{4}-\d{2}$/.test(month)) { console.error(`--month 须为 YYYY-MM（现 ${month || '空'}）\n\n${USAGE}`); process.exit(1); }
-
-const WORKFLOW = 'workflow';
-const METRICS_P = path.join(WORKFLOW, 'metrics.md');
-const BUDGETS = path.join('.agents', 'rule-budgets.txt');
-const DOC_TYPES = ['intents', 'specs', 'plans', 'incidents'];
-// 活跃口径单源（workflow-enums.txt）。与脚本同层的上一级：
-// 包源 templates/_agents/workflow-enums.txt，装户副本 .agents/workflow-enums.txt。
-// 拷贝后相对位置不变，不按仓库根猜测另一套目录。
-const ENUMS = loadEnums(path.join(path.dirname(fileURLToPath(import.meta.url)), '..', 'workflow-enums.txt'));
-const ACTIVE_STATUS = [...ENUMS['doc.status.active'], ...ENUMS['incident.status.active']];
-const BEGIN = '<!-- GENERATED:BEGIN — gen-workflow-metrics.mjs 整段重写，手工说明写在本行之前 -->';
-const END = '<!-- GENERATED:END -->';
-
-const kb = (b) => (b < 1024 * 1024 ? `${(b / 1024).toFixed(1)} KB` : `${(b / 1024 / 1024).toFixed(2)} MB`);
-
-// ---- 语料统计：按类型聚合文件数/字节 + 活跃终态 + 模块已填 ----
-function scanDocs() {
-  const perType = {};
-  let files = 0;
-  let bytes = 0;
-  let active = 0;
-  let invalid = 0;
-  let withModule = 0;
-  for (const type of DOC_TYPES) {
-    let n = 0;
-    let b = 0;
-    const dir = path.join(WORKFLOW, type);
-    for (const f of fs.readdirSync(dir)) {
-      if (!f.endsWith('.md') || f === '_TEMPLATE.md') continue;
-      const p = path.join(dir, f);
-      const text = fs.readFileSync(p, 'utf8');
-      const fm = text.match(/^---\r?\n([\s\S]*?)\r?\n---/);
-      let status = '';
-      let mod = '';
-      if (fm) {
-        for (const line of fm[1].split(/\r?\n/)) {
-          const kv = line.match(/^(\S+):\s*(.*)$/);
-          if (!kv) continue;
-          if (kv[1] === '状态') status = kv[2].trim();
-          if (kv[1] === '模块') mod = kv[2].trim();
-        }
-      }
-      if (ACTIVE_STATUS.includes(status)) active++;
-      else if (!status || ![...ENUMS['doc.status.all'], ...ENUMS['incident.status.all']].includes(status)) invalid++; // 状态缺失/非法单列（board-kb-p1：不再吞进终态桶）
-      if (mod) withModule++;
-      n++;
-      b += fs.statSync(p).size;
-    }
-    perType[type] = { n, b };
-    files += n;
-    bytes += b;
-  }
-  return { perType, files, bytes, active, terminal: files - active - invalid, invalid, withModule };
-}
-
-// ---- 常驻面：按预算表逐条实测（<glob|dir/> <上限>）----
-// 峰值口径：逐文件条取「该文件」，glob 条取「单篇最大」，目录条取「合计」——三者不混（曾把目录合计除以单篇上限得出 548%）
-function scanSurface() {
-  if (!fs.existsSync(BUDGETS)) return { entries: [], total: 0, peak: null };
-  const entries = [];
-  for (const raw of fs.readFileSync(BUDGETS, 'utf8').split(/\r?\n/)) {
-    const line = raw.trim();
-    if (!line || line.startsWith('#')) continue;
-    const [pat, limRaw] = line.split(/\s+/);
-    const lim = Number(limRaw);
-    if (!pat || !Number.isFinite(lim)) continue;
-    let sum = 0;
-    let max = 0;
-    let label = pat;
-    if (pat.endsWith('/')) {
-      const dir = pat.slice(0, -1);
-      if (!fs.existsSync(dir)) { console.error(`⚠️ 预算目录不存在，跳过该条：${pat}`); continue; }
-      for (const f of fs.readdirSync(dir)) sum += fs.statSync(path.join(dir, f)).size;
-      max = sum;
-      label = `${pat}（合计）`;
-    } else if (pat.includes('*')) {
-      // 词表约定 glob = 基名内单个 `*`（<前缀>*<后缀>），目录段不支持通配——与 rule-budget.mjs 的 glob 展开同口径。
-      // 多 `*` / 目录段含 `*` 出词表：警告跳过，不做「只按后缀 endsWith」的放宽式匹配（2026-09-24 收口：
-      // 曾按首个 * 取后缀，`pl*.md` 会误吃目录内全部 .md、`a*b` 会误吃一切 b 结尾文件）
-      const stars = pat.split('*').length - 1;
-      const starIdx = pat.indexOf('*');
-      const lastSlash = pat.lastIndexOf('/');
-      if (stars !== 1 || starIdx < lastSlash) {
-        console.error(`⚠️ 预算表 glob 仅支持基名内单个 *（<前缀>*<后缀>），跳过该条：${pat}`);
-        continue;
-      }
-      const dir = lastSlash >= 0 ? pat.slice(0, lastSlash + 1) : '.';
-      const basePrefix = pat.slice(lastSlash + 1, starIdx);
-      const baseSuffix = pat.slice(starIdx + 1);
-      if (!fs.existsSync(dir)) { console.error(`⚠️ 预算目录不存在，跳过该条：${pat}`); continue; }
-      for (const f of fs.readdirSync(dir)) {
-        if (!f.startsWith(basePrefix) || !f.endsWith(baseSuffix)) continue;
-        const s = fs.statSync(path.join(dir, f)).size;
-        sum += s;
-        if (s > max) max = s;
-      }
-      label = `${pat}（单篇最大）`;
-    } else {
-      if (!fs.existsSync(pat)) { console.error(`⚠️ 预算文件不存在，跳过该条：${pat}`); continue; }
-      sum = max = fs.statSync(pat).size;
-    }
-    entries.push({ pat, label, sum, max, lim, pct: (max / lim) * 100, isDir: pat.endsWith('/') });
-  }
-  const total = entries.filter((e) => !e.isDir).reduce((n, e) => n + e.sum, 0);
-  const peak = entries.slice().sort((a, b) => b.pct - a.pct)[0] || null;
-  return { entries, total, peak };
-}
-
-const idxText = fs.existsSync(path.join(WORKFLOW, 'INDEX.md')) ? fs.readFileSync(path.join(WORKFLOW, 'INDEX.md'), 'utf8') : '';
-const idxBytes = Buffer.byteLength(idxText, 'utf8');
-const idxActive = Number((idxText.match(/^## 活跃（(\d+)）/m) || [])[1] ?? NaN);
-
-// ---- 闭环漏斗（2026-10-02 ledger-funnel-metrics 立法）----
-// 只读台账一手字段（doc/stage/ts/source），坏行跳过（与检查 15/19 同容错）；观测面不挂门禁、不新增文档断言（检查 16 零接触）。
-// 台账读取收敛 ledger-loader 单源（2026-10-12 ledger-loader-p1）——口径不变（只读一手字段 doc/stage/ts/source、
-// 坏行跳过，与检查 15/19 同容错）。**本步刻意保留「全量行不去重」**：去重会改漏斗 ledgerRows 计数口径，
-// 属口径变更，须随分片功能同批生效，不得混入单源化本步。
-function readLedgerRows() {
-  return loadLedgerRows();
-}
-
-function funnelFromLedger(entries, month) {
-  const byDoc = new Map();
-  for (const e of entries) {
-    if (typeof e.doc !== 'string' || typeof e.ts !== 'string') continue;
-    if (!byDoc.has(e.doc)) byDoc.set(e.doc, []);
-    byDoc.get(e.doc).push(e);
-  }
-  const res = { closed: 0, full: 0, legacy: 0, once: 0, rework: 0, ledgerRows: 0, days: [], items: [] };
-  for (const e of entries) if (typeof e.ts === 'string' && e.ts.slice(0, 7) === month) res.ledgerRows++;
-  for (const [doc, rs] of byDoc) {
-    rs.sort((a, b) => String(a.ts).localeCompare(String(b.ts)));
-    const nonRevert = rs.filter((r) => !/^revert-/.test(String(r.stage || '')));
-    const terminals = nonRevert.filter((r) => r.stage === 'done' || r.stage === 'closed');
-    if (!terminals.length) continue; // 未收口件不进漏斗桶（仍计台账行数）
-    const lastTerm = terminals[terminals.length - 1];
-    if (String(lastTerm.ts).slice(0, 7) !== month) continue; // 月度归桶 = 终态行所在月
-    // 确认阶段按件型（复核 P2-3 收口）：docs=approved；incidents=fixed（两跳确认门 fixed→closed，
-    // 永无 approved 行——按 approved 判会把已走确认门的 incident 误归协议前）
-    const isInc = doc.includes('/incidents/');
-    const confirmStage = isInc ? 'fixed' : 'approved';
-    const confirms = nonRevert.filter((r) => r.stage === confirmStage);
-    const hasChain = confirms.length >= 1;
-    const hasRevert = rs.some((r) => /^revert-/.test(String(r.stage || '')));
-    const kind = !hasChain ? 'legacy' : (hasRevert || confirms.length >= 2 || terminals.length >= 2 ? 'rework' : 'once');
-    const firstTs = hasChain ? confirms[0].ts : rs[0].ts; // 协议前件首行起算
-    const days = (Date.parse(lastTerm.ts) - Date.parse(firstTs)) / 86400000;
-    res.closed++;
-    if (kind === 'legacy') res.legacy++;
-    else { res.full++; res[kind === 'once' ? 'once' : 'rework']++; }
-    if (Number.isFinite(days) && days >= 0) res.days.push(days);
-    res.items.push({ doc, kind, days: Number.isFinite(days) && days >= 0 ? days.toFixed(1) : '—' });
-  }
-  return res;
-}
-
-const ledgerRows = readLedgerRows();
-const funnel = funnelFromLedger(ledgerRows, month);
-const sortedDays = [...funnel.days].sort((a, b) => a - b);
-const medianDays = sortedDays.length
-  ? (sortedDays.length % 2 ? sortedDays[(sortedDays.length - 1) / 2] : (sortedDays[sortedDays.length / 2 - 1] + sortedDays[sortedDays.length / 2]) / 2)
-  : null;
-const funnelRow = `| ${month} | ${funnel.closed} | ${funnel.full} | ${funnel.legacy} | ${funnel.once} | ${funnel.rework} | ${medianDays === null ? '—' : medianDays.toFixed(1)} | ${funnel.ledgerRows} |`;
-
-const docs = scanDocs();
-const surf = scanSurface();
-const row = `| ${month} | ${docs.files}（活跃 ${docs.active} / 终态 ${docs.terminal}） | ${kb(docs.bytes)} | ${docs.withModule}/${docs.files} | ${kb(surf.total)}（峰值 ${surf.peak ? `${surf.peak.pct.toFixed(1)}% ${surf.peak.label}` : '—'}） | ${kb(idxBytes)}（${Number.isNaN(idxActive) ? '—' : idxActive} 行） |`;
-
-// ---- 明细（stdout，不落表）：类型分布 + 逐条预算占用 ----
-console.log(`📅 ${month} 快照`);
-console.log(`  文档：${docs.files} 篇 / ${kb(docs.bytes)}（活跃 ${docs.active} / 终态 ${docs.terminal}${docs.invalid ? ` / 状态缺失或非法 ${docs.invalid}` : ''}）；模块已填 ${docs.withModule}/${docs.files}`);
-for (const [t, v] of Object.entries(docs.perType)) console.log(`    ${t.padEnd(10)} ${String(v.n).padStart(3)} 篇 / ${kb(v.b)}`);
-console.log(`  索引：workflow/INDEX.md ${kb(idxBytes)}（活跃 ${Number.isNaN(idxActive) ? '—' : idxActive} 行）`);
-for (const e of surf.entries) console.log(`    ${e.label.padEnd(44)} ${String(e.max).padStart(6)} / ${String(e.lim).padStart(6)} B（${e.pct.toFixed(1)}%）`);
-console.log(`  常驻面合计：${kb(surf.total)}`);
-console.log(`  闭环漏斗：收口 ${funnel.closed}（完整链 ${funnel.full} = 一次通过 ${funnel.once} + 返工 ${funnel.rework}；协议前 ${funnel.legacy}）｜中位周期 ${medianDays === null ? '—' : `${medianDays.toFixed(1)} 天`}｜台账行 ${funnel.ledgerRows}`);
-for (const it of funnel.items) console.log(`    ${String(it.doc).padEnd(58)} ${it.kind.padEnd(7)} ${it.days} 天`);
-if (funnel.items.length) console.log('  ℹ️ 机器口径可与 workflow/delegations.md 自做表的人工自报交叉对照（差异即信号，不对账）');
-// 归档积压提醒（2026-10-15 减重手段⑥ 自源仓回灌，回路别等人喊）：滚动归档已随确认门自动跑
-// （confirm-doc archive-on-close），历史积压走 archive-sweep 手工批次——月度 stdout 报候选数使积压可见。
-// 判定单源 = archive-sweep.analyze（21 天窗，禁第二套口径）；analyze/loadLastTouch 抛错（如
-// 浅克隆无 git 历史）fail-open 静默——观测提醒不挡快照。
-try {
-  const allDocs = buildDocList(process.cwd());
-  const arch = analyze({
-    docs: allDocs,
-    ledgerTs: loadLedgerTs(process.cwd()),
-    lastTouch: loadLastTouch(process.cwd()),
-    activeTexts: allDocs.filter((d) => ACTIVE.has(parseStatus(d.text))).map((d) => d.text),
-    windowDays: 21,
-  });
-  const fams = new Set(arch.candidates.map((x) => x.file));
-  console.log(`  归档积压：候选 ${arch.candidates.length} 篇 / ${fams.size} 族（21 天窗）${arch.candidates.length ? '——node .agents/scripts/archive-sweep.mjs 查看，--execute 执行' : ''}`);
-} catch { /* fail-open */ }
-console.log(`  ${DRY ? '（--dry-run，未写盘）' : ''}`);
-
-if (DRY) { console.log(`\n将写入行：\n${row}\n${funnelRow}`); process.exit(0); }
-
-// ---- 组装：GENERATED 区内的月表按月份键 upsert（同月重跑覆盖，行序按月升序）----
-const HEADER = `# workflow 规模与规则面月度快照
-
-> 生成器 \`node .agents/scripts/gen-workflow-metrics.mjs\`（每月或有需要时跑；同月重跑即更新该行）。明细（类型分布 / 逐条预算占用）看脚本 stdout，不落表。
-> 口径：文档 = 磁盘（排除 \`_TEMPLATE.md\`）；常驻面 = \`.agents/rule-budgets.txt\` 逐条实测，括号内为「预算占用峰值项」。
-`;
-const TABLE_HEAD = [
-  '| 月份 | 文档（活跃/终态） | 文档字节 | 模块已填/总 | 常驻面字节（预算峰值） | INDEX（活跃行） |',
-  '|---|---|---|---|---|---|',
-];
-// 漏斗表头（第二表）
-const FUNNEL_HEAD = [
-  '## 闭环漏斗（机器口径，源：.agents/confirmations.jsonl）',
-  '',
-  '| 月份 | 收口 | 完整链 | 协议前 | 一次通过 | 返工件 | 中位周期(天) | 台账行数 |',
-  '|---|---|---|---|---|---|---|---|',
-];
-const existing = fs.existsSync(METRICS_P) ? fs.readFileSync(METRICS_P, 'utf8') : '';
-let rows = [];
-let funnelRows = [];
-if (existing.includes(BEGIN) && existing.includes(END)) {
-  const section = existing.slice(existing.indexOf(BEGIN), existing.indexOf(END));
-  const marker = FUNNEL_HEAD[0];
-  const bodyPart = section.includes(marker) ? section.slice(0, section.indexOf(marker)) : section;
-  const funnelPart = section.includes(marker) ? section.slice(section.indexOf(marker)) : '';
-  rows = bodyPart.split(/\r?\n/).filter((l) => /^\|\s*\d{4}-\d{2}\s*\|/.test(l));
-  funnelRows = funnelPart.split(/\r?\n/).filter((l) => /^\|\s*\d{4}-\d{2}\s*\|/.test(l));
-}
-rows = rows.filter((l) => !l.startsWith(`| ${month} `));
-rows.push(row);
-rows.sort((a, b) => a.slice(2, 9).localeCompare(b.slice(2, 9)));
-funnelRows = funnelRows.filter((l) => !l.startsWith(`| ${month} `));
-funnelRows.push(funnelRow);
-funnelRows.sort((a, b) => a.slice(2, 9).localeCompare(b.slice(2, 9)));
-const inner = `${BEGIN}\n\n${[...TABLE_HEAD, ...rows].join('\n')}\n\n${[...FUNNEL_HEAD, ...funnelRows].join('\n')}\n\n${END}`;
-let out;
-if (existing.includes(BEGIN) && existing.includes(END)) {
-  out = existing.slice(0, existing.indexOf(BEGIN)) + inner + existing.slice(existing.indexOf(END) + END.length);
-} else {
-  out = (existing ? existing.replace(/\s*$/, '') + '\n\n' : HEADER) + inner + '\n';
-}
-
-// ---- 趋势序列 + 确认负担（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/gen-workflow-metrics.test.mjs

@@ -1,224 +0,0 @@
-#!/usr/bin/env node
-// gen-workflow-metrics.mjs 的 fixture 驱动测试
-// 现场构造临时语料（换 cwd 运行被测脚本，脚本按相对路径读 workflow/ 与 .agents/rule-budgets.txt）。
-// 断言：①主路径——类型聚合/活跃终态/模块已填/常驻面峰值/INDEX 活跃行；②同月重跑 upsert 不重复、跨月按月升序；
-//       ③失败路径——非法 --month / 未知参数 exit 1。
-// 用法：node .agents/scripts/gen-workflow-metrics.test.mjs（在仓库任意目录执行均可）
-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';
-
-const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
-const GEN = path.join(SCRIPT_DIR, 'gen-workflow-metrics.mjs');
-const USAGE = '用法：node .agents/scripts/gen-workflow-metrics.test.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 doc = (fm, title) => `---\n${fm}\n---\n# ${title}\n`;
-
-const mkfix = () => {
-  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'gen-workflow-metrics-test-'));
-  for (const d of ['intents', 'specs', 'plans', 'incidents']) fs.mkdirSync(path.join(root, 'workflow', d), { recursive: true });
-  fs.mkdirSync(path.join(root, '.agents', 'commands'), { recursive: true });
-  const w = path.join(root, 'workflow');
-  fs.writeFileSync(path.join(w, 'intents', '2026-09-21-a.md'), doc('状态: approved\n级别: L1\n日期: 2026-09-21\n模块: pipeline', 'INTENT — 甲'), 'utf8');
-  fs.writeFileSync(path.join(w, 'plans', '2026-09-21-a.md'), doc('状态: approved\n级别: L1\n模块: pipeline', 'PLAN — 甲'), 'utf8');
-  fs.writeFileSync(path.join(w, 'plans', '2026-09-19-b.md'), doc('状态: done\n级别: L1\n模块: material', 'PLAN — 乙'), 'utf8');
-  fs.writeFileSync(path.join(w, 'incidents', '2026-09-18-c.md'), doc('状态: closed\n级别: L2\n发现: 2026-09-18', 'INCIDENT — 丙'), 'utf8');
-  fs.writeFileSync(path.join(w, 'intents', '_TEMPLATE.md'), doc('状态: draft\n级别: L1', 'INTENT — 模板'), 'utf8');
-  fs.writeFileSync(path.join(w, 'INDEX.md'), '# index fixture\n\n## 活跃（2）\n\n| 类型 |\n|---|\n', 'utf8');
-  // 预算表：AGENTS.md 120B / 上限 100 → 峰值 120%；commands 单篇与合计都远低于上限
-  fs.writeFileSync(path.join(root, '.agents', 'rule-budgets.txt'), [
-    '# fixture 预算表',
-    'AGENTS.md 100',
-    '.agents/commands/*.md 50',
-    '.agents/commands/ 100',
-    '',
-  ].join('\n'), 'utf8');
-  fs.writeFileSync(path.join(root, 'AGENTS.md'), 'x'.repeat(120), 'utf8');
-  fs.writeFileSync(path.join(root, '.agents', 'commands', 'plan.md'), 'y'.repeat(10), 'utf8');
-  return root;
-};
-
-const run = (root, args) => spawnSync(process.execPath, [GEN, ...args], { cwd: root, encoding: 'utf8' });
-const readMetrics = (root) => fs.readFileSync(path.join(root, 'workflow', 'metrics.md'), 'utf8');
-
-// ---- 场景 1：主路径——一行算对 ----
-{
-  const root = mkfix();
-  const r = run(root, ['--month', '2026-09']);
-  const md = fs.existsSync(path.join(root, 'workflow', 'metrics.md')) ? readMetrics(root) : '';
-  check('场景 1：生成 exit 0 且落盘 workflow/metrics.md', r.status === 0 && md.length > 0, `exit=${r.status}\n${r.stdout}${r.stderr}`);
-  check('场景 1：行含 4（活跃 2 / 终态 2）+ 模块 3/4', /\| 2026-09 \| 4（活跃 2 \/ 终态 2） \| .* \| 3\/4 \|/.test(md), md);
-  check('场景 1：常驻面峰值取最紧项（120.0% AGENTS.md）', /峰值 120\.0% AGENTS\.md/.test(md), md);
-  check('场景 1：常驻面合计 = AGENTS.md + commands 逐文件（130B → 0.1 KB）', /0\.1 KB（峰值/.test(md), md);
-  check('场景 1：INDEX 活跃行解析（2 行）', /（2 行） \|/.test(md), md);
-  check('场景 1：_TEMPLATE.md 不计入（4 篇而非 5 篇）', !/\| 5（/.test(md), md);
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- 场景 2：同月重跑 upsert 不重复；跨月按月升序 ----
-{
-  const root = mkfix();
-  run(root, ['--month', '2026-09']);
-  run(root, ['--month', '2026-09']);
-  let md = readMetrics(root);
-  const funnelMark = '## 闭环漏斗';
-  const bodyPart = md.slice(0, md.includes(funnelMark) ? md.indexOf(funnelMark) : undefined);
-  const n09 = (bodyPart.match(/^\| 2026-09 \|/gm) || []).length;
-  const n09f = ((md.includes(funnelMark) ? md.slice(md.indexOf(funnelMark)) : '').match(/^\| 2026-09 \|/gm) || []).length;
-  check('场景 2：同月重跑只保留一行（体量表分段计数）', n09 === 1, `${n09} 行\n${md}`);
-  check('场景 2：漏斗表同月 upsert 不重复', n09f === 1, `${n09f} 行\n${md}`);
-  run(root, ['--month', '2026-08']);
-  md = readMetrics(root);
-  const i08 = md.indexOf('| 2026-08 |');
-  const i09 = md.indexOf('| 2026-09 |');
-  check('场景 2：跨月两行且按月升序', i08 > -1 && i09 > -1 && i08 < i09, md);
-  check('场景 2：HEADER 手工说明保留（生成区外内容不丢）', md.includes('# workflow 规模与规则面月度快照'), md);
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- 场景 3：失败路径 + --dry-run 不写盘 ----
-{
-  const root = mkfix();
-  const bad = run(root, ['--month', '2026-9']);
-  check('场景 3：非法 --month exit 1', bad.status === 1 && /须为 YYYY-MM/.test(bad.stderr), `exit=${bad.status}\n${bad.stderr}`);
-  const unk = run(root, ['--bogus']);
-  check('场景 3：未知参数 exit 1', unk.status === 1 && /未知参数/.test(unk.stderr), `exit=${unk.status}\n${unk.stderr}`);
-  const dry = run(root, ['--dry-run']);
-  check('场景 3：--dry-run 不写盘且打印将写入行', dry.status === 0 && /将写入行/.test(dry.stdout) && !fs.existsSync(path.join(root, 'workflow', 'metrics.md')), dry.stdout);
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- 场景 4：预算表 glob 词表收口——单 * 前缀+后缀匹配；多 * / 目录段 * 警告跳过（2026-09-24）----
-{
-  const root = mkfix();
-  fs.writeFileSync(path.join(root, '.agents', 'commands', 'zeta.md'), 'z'.repeat(500), 'utf8'); // 非 pl 前缀：不得被 pl*.md 吃进
-  fs.writeFileSync(path.join(root, '.agents', 'rule-budgets.txt'), [
-    '# fixture 预算表（glob 词表收口）',
-    'AGENTS.md 100',
-    '.agents/commands/pl*.md 9999',
-    '.agents/commands/**.md 9999',
-    '.agents/*/cmd.md 9999',
-    '',
-  ].join('\n'), 'utf8');
-  const r = run(root, ['--month', '2026-09']);
-  const md = fs.existsSync(path.join(root, 'workflow', 'metrics.md')) ? readMetrics(root) : '';
-  check('场景 4：exit 0（词表外条目跳过不阻断）', r.status === 0, `exit=${r.status}\n${r.stdout}${r.stderr}`);
-  check('场景 4：单 * 按前缀+后缀匹配（pl*.md 只吃 plan.md 10B，zeta.md 500B 不计入）', /\.agents\/commands\/pl\*\.md（单篇最大）\s+10\s+\/\s+9999/.test(r.stdout), r.stdout);
-  check('场景 4：常驻面合计随之正确（120+10=130B → 0.1 KB）', /0\.1 KB（峰值/.test(md) && /常驻面合计：0\.1 KB/.test(r.stdout), `${md}\n${r.stdout}`);
-  check('场景 4：多 * 与目录段 * 各警告跳过', (r.stderr || '').includes('**.md') && (r.stderr || '').includes('.agents/*/cmd.md'), r.stderr);
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- 闭环漏斗（2026-10-02 ledger-funnel-metrics；口径定义式 = specs/2026-10-02-ledger-funnel-metrics.md）----
-const LROW = (o = {}) => JSON.stringify({
-  ts: '2026-10-02T00:00:00.000Z', doc: 'workflow/intents/demo.md', stage: 'approved',
-  fingerprint: 'b'.repeat(64), prev: 'draft', source: 'chat-delegated', quote: '确认', ...o,
-});
-// mkfixLedger：在 mkfix 基础上写台账（LROW 已是 JSON 字符串，直接 join——勿再 stringify 双重编码）
-const mkfixLedger = (lines) => {
-  const root = mkfix();
-  fs.writeFileSync(path.join(root, '.agents', 'confirmations.jsonl'), lines.join('\n') + '\n', 'utf8');
-  return root;
-};
-{
-  // L1：一次通过（approved→done 同月）→ 收口 1 / 完整链 1 / 一次通过 1 / 周期 1.0 天
-  const root = mkfixLedger([
-    LROW({ ts: '2026-10-01T00:00:00.000Z' }),
-    LROW({ ts: '2026-10-02T00:00:00.000Z', stage: 'done', prev: 'approved' }),
-  ]);
-  const r = run(root, ['--month', '2026-10']);
-  const md = readMetrics(root);
-  check('漏斗 L1 一次通过：| 2026-10 | 1 | 1 | 0 | 1 | 0 | 1.0 | 2 |',
-    r.status === 0 && /\| 2026-10 \| 1 \| 1 \| 0 \| 1 \| 0 \| 1\.0 \| 2 \|/.test(md), `${r.stdout}${md}`);
-  fs.rmSync(root, { recursive: true, force: true });
-}
-{
-  // L2：revert 行（回退后重走）→ 返工件
-  const root = mkfixLedger([
-    LROW({ ts: '2026-10-01T00:00:00.000Z', stage: 'revert-draft', fingerprint: 'n/a', prev: 'approved' }),
-    LROW({ ts: '2026-10-02T00:00:00.000Z' }),
-    LROW({ ts: '2026-10-03T00:00:00.000Z', stage: 'done', prev: 'approved' }),
-  ]);
-  const r = run(root, ['--month', '2026-10']);
-  const md = readMetrics(root);
-  check('漏斗 L2 revert 行 → 返工件 1（周期按首 approved 起算 1.0 天）',
-    r.status === 0 && /\| 2026-10 \| 1 \| 1 \| 0 \| 0 \| 1 \| 1\.0 \| 3 \|/.test(md), `${r.stdout}${md}`);
-  fs.rmSync(root, { recursive: true, force: true });
-}
-{
-  // L3：重确认（两次 approved）→ 返工件
-  const root = mkfixLedger([
-    LROW({ ts: '2026-10-01T00:00:00.000Z' }),
-    LROW({ ts: '2026-10-02T00:00:00.000Z', quote: '重确认' }),
-    LROW({ ts: '2026-10-03T00:00:00.000Z', stage: 'done', prev: 'approved' }),
-  ]);
-  const r = run(root, ['--month', '2026-10']);
-  const md = readMetrics(root);
-  check('漏斗 L3 两次 approved → 返工件 1',
-    r.status === 0 && /\| 2026-10 \| 1 \| 1 \| 0 \| 0 \| 1 \| 2\.0 \| 3 \|/.test(md), `${r.stdout}${md}`);
-  fs.rmSync(root, { recursive: true, force: true });
-}
-{
-  // L4：协议前（首行即终态，无 approved）→ 协议前 1（不计一次通过分母）
-  const root = mkfixLedger([
-    LROW({ ts: '2026-10-02T00:00:00.000Z', stage: 'done', prev: 'approved' }),
-  ]);
-  const r = run(root, ['--month', '2026-10']);
-  const md = readMetrics(root);
-  check('漏斗 L4 协议前 → | 1 | 0 | 1 | 0 | 0 |',
-    r.status === 0 && /\| 2026-10 \| 1 \| 0 \| 1 \| 0 \| 0 \| 0\.0 \| 1 \|/.test(md), `${r.stdout}${md}`);
-  fs.rmSync(root, { recursive: true, force: true });
-}
-{
-  // L5：incident 两跳（fixed→closed = incident 确认链，复核 P2-3 收口）→ 完整链一次通过
-  const root = mkfixLedger([
-    LROW({ ts: '2026-10-01T00:00:00.000Z', doc: 'workflow/incidents/inc.md', stage: 'fixed' }),
-    LROW({ ts: '2026-10-02T00:00:00.000Z', doc: 'workflow/incidents/inc.md', stage: 'closed', prev: 'fixed' }),
-  ]);
-  const r = run(root, ['--month', '2026-10']);
-  const md = readMetrics(root);
-  check('漏斗 L5 incident 两跳确认链 → 完整链 1 / 一次通过 1 / 周期 1.0',
-    r.status === 0 && /\| 2026-10 \| 1 \| 1 \| 0 \| 1 \| 0 \| 1\.0 \|/.test(md), `${r.stdout}${md}`);
-  fs.rmSync(root, { recursive: true, force: true });
-}
-{
-  // L7：incident 单行 closed（存量补关，无确认链）→ 协议前
-  const root = mkfixLedger([
-    LROW({ ts: '2026-10-02T00:00:00.000Z', doc: 'workflow/incidents/old.md', stage: 'closed', prev: 'fixed' }),
-  ]);
-  const r = run(root, ['--month', '2026-10']);
-  const md = readMetrics(root);
-  check('漏斗 L7 incident 单行 closed → 协议前 1',
-    r.status === 0 && /\| 2026-10 \| 1 \| 0 \| 1 \| 0 \| 0 \|/.test(md), `${r.stdout}${md}`);
-  fs.rmSync(root, { recursive: true, force: true });
-}
-{
-  // L6：跨月收口（9 月 approved、10 月 done）→ 归桶 10 月；9 月只计台账行
-  const root = mkfixLedger([
-    LROW({ ts: '2026-09-30T00:00:00.000Z' }),
-    LROW({ ts: '2026-10-02T00:00:00.000Z', stage: 'done', prev: 'approved' }),
-  ]);
-  const rSep = run(root, ['--month', '2026-09']);
-  const rOct = run(root, ['--month', '2026-10']);
-  const md = readMetrics(root);
-  check('漏斗 L6 跨月收口归桶 10 月（9 月零收口 + 台账行 1）',
-    rSep.status === 0 && rOct.status === 0 && /\| 2026-09 \| 0 \| 0 \| 0 \| 0 \| 0 \| — \| 1 \|/.test(md)
-    && /\| 2026-10 \| 1 \| 1 \| 0 \| 1 \| 0 \| 2\.0 \| 1 \|/.test(md), `${rSep.stdout}${rOct.stdout}${md}`);
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-console.log(`\n合计: PASS ${pass} / FAIL ${fail}`);
-if (fail) {
-  console.log(`\n${USAGE}`);
-  process.exit(1);
-}
-process.exit(0);

package/templates/_agents/scripts/git-merge-jsonl.mjs

@@ -1,63 +0,0 @@
-#!/usr/bin/env node
-// git-merge-jsonl.mjs — Git 自定义合并驱动：JSONL 追加式台账并集去重（2026-10-12 ledger-merge-driver）
-// 解决什么：确认台账 `.agents/confirmations.jsonl` 是「尾部追加 + 多人/多 worktree 并行」形态。
-//   两个分支各自追加行 → 同一文件末尾分叉 → git 默认三方合并把它当文本冲突，人工解且极易解错
-//   （常见错解：整取一侧，**静默丢掉另一侧的确认行**——门禁事后无从发现，人不可信面直接扩大）。
-//   本驱动把合并降级为确定性的**并集去重**：两侧行全保留，无冲突可解。
-//
-// 接线（两步，缺任一步则退化为文本冲突——不静默丢数据，但要人工解）：
-//   ① git config merge.jsonl-union.driver "node .agents/scripts/git-merge-jsonl.mjs %O %A %B"
-//   ② 目标仓 .gitattributes 含：.agents/*.jsonl merge=jsonl-union
-//   flow-kit init 会自动做 ①；②由 templates/.gitattributes 下发（**owned**——存量装户 sync 永不覆盖，
-//   需自行补一行，见 README 台账并发口径）。
-//
-// 调用协议（由 .gitattributes 关联 merge=jsonl-union 触发）：
-//   %O 祖先版本路径 ｜ %A 当前分支版本（合并结果必须覆写回此文件）｜ %B 对方分支版本
-//
-// **为什么 union 去重不会破坏台账哈希链**（ledgerChainHash 的前提，勿破坏）：
-//   去重按**整行文本**精确比对，不解析、不改写行内任何字段 → 合并后每行文本与合并前逐字相同
-//   → JSON.parse 保持键序 → ledgerChainHash(row) 重算结果不变。哈希链的**行内自洽**因此恒成立。
-//   （跨合并边界的**链首尾衔接**是另一回事，由链域改造承接，见 check-loop 检查 15。）
-import fs from 'node:fs';
-
-// mergeJsonlLines：并集去重。保持 current（%A）既有行的原始顺序，其余 other（%B）新行追加末尾。
-// 全部行按整行文本精确去重；CRLF 归一为 LF（台账判据与 check-ledger-invariant 的 blob 口径对齐）。
-export function mergeJsonlLines(currentContent, otherContent) {
-  const norm = (str) => (str || '').replace(/\r\n/g, '\n').split('\n').filter((l) => l.trim().length > 0);
-  const currentLines = norm(currentContent);
-  const otherLines = norm(otherContent);
-
-  const seen = new Set(currentLines);
-  const result = [...currentLines];
-  for (const line of otherLines) {
-    if (!seen.has(line)) { seen.add(line); result.push(line); }
-  }
-  return result.length > 0 ? result.join('\n') + '\n' : '';
-}
-
-// CLI 执行入口（isMain 守卫沿本仓惯例：被 import 时零副作用，供 compact-ledgers 复用本函数）
-const isMain = process.argv[1] && process.argv[1].replace(/\\/g, '/').endsWith('git-merge-jsonl.mjs');
-if (isMain) {
-  // %O（祖先版本）本驱动用不到——并集去重只需 %A ∪ %B；保留位置占位以对齐 git 的 %O %A %B 调用协议
-  const [, , _ancestorPath, currentPath, otherPath] = process.argv;
-
-  if (!currentPath || !otherPath) {
-    console.error('用法：node git-merge-jsonl.mjs %O %A %B（由 .gitattributes 的 merge=jsonl-union 触发，不供手工调用）');
-    process.exit(1);
-  }
-
-  // 原子覆写：直接 writeFileSync 会先截断原文件，进程中途崩溃将留下半写文件——git 合并中途失败
-  // 正是最需要「要么旧要么新」的场合。改为同目录临时文件 + rename。
-  const tmpPath = `${currentPath}.tmp`;
-  try {
-    const currentContent = fs.existsSync(currentPath) ? fs.readFileSync(currentPath, 'utf8') : '';
-    const otherContent = fs.existsSync(otherPath) ? fs.readFileSync(otherPath, 'utf8') : '';
-    fs.writeFileSync(tmpPath, mergeJsonlLines(currentContent, otherContent), 'utf8');
-    fs.renameSync(tmpPath, currentPath);
-    process.exit(0);
-  } catch (err) {
-    try { fs.unlinkSync(tmpPath); } catch { /* tmp 可能尚未创建 */ }
-    console.error(`[git-merge-jsonl] 合并失败: ${err.message}——已保留原文件，git 将报为冲突（人工解，勿整取一侧丢行）`);
-    process.exit(1);
-  }
-}