agentic-flow-kit 1.8.7 → 2.1.0

package/templates/_agents/scripts/gen-wiki-board.test.mjs

@@ -1,249 +0,0 @@
-#!/usr/bin/env node
-// gen-wiki-board.mjs 的 fixture 驱动测试（2026-09-21 随 CRLF 解析缺陷修复引入）
-// 现场构造临时 wiki 根，以「换 cwd」方式运行被测脚本（脚本按相对路径 'wiki/' 读盘，无需注入口）。
-// 断言：①CRLF 下速览表「用途」列（唯一人工维护位）重生成后保持——papercut 2026-09-17 缺陷回归；
-//       ②行尾保持（CRLF 不被改写成 LF）；③新增 wiki 文件后速览计数 / 合计行 / 看板 DATA 同步。
-// 用法：node .agents/scripts/gen-wiki-board.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-wiki-board.mjs');
-const USAGE = '用法：node .agents/scripts/gen-wiki-board.test.mjs';
-
-const USAGE_COL = '主题A 用途说明（人工列）';
-
-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}` : ''}`); }
-};
-
-// 行尾统计：验证 CRLF fixture 不被改写成 LF
-const eolStats = (p) => {
-  const b = fs.readFileSync(p);
-  let crlf = 0;
-  let lf = 0;
-  for (let i = 0; i < b.length; i++) {
-    if (b[i] === 10) { if (i > 0 && b[i - 1] === 13) crlf++; else lf++; }
-  }
-  return { crlf, lf };
-};
-
-// mkfix：建临时 wiki 根（INDEX 按 eol 拼装；看板 DATA 块固定 LF——与仓库现状一致）
-const mkfix = (eol) => {
-  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'gen-wiki-board-test-'));
-  fs.mkdirSync(path.join(root, 'wiki', '主题A'), { recursive: true });
-  fs.mkdirSync(path.join(root, 'wiki', 'drafts-archive'), { recursive: true });
-  fs.writeFileSync(path.join(root, 'wiki', '主题A', 'a.md'), '# a\n', 'utf8');
-  fs.writeFileSync(path.join(root, 'wiki', 'INDEX.md'), [
-    '# wiki 索引（fixture）',
-    '',
-    '| 主题 | 文件数 | 用途 |',
-    '|---|---|---|',
-    `| 主题A | 1 | ${USAGE_COL} |`,
-    '| drafts-archive | — | 原文档备份（按 日期-主题 分目录） |',
-    '',
-    '合计：**1 份**知识文档，**1 个主题**',
-    '',
-    '---',
-    '',
-    '## 文件 → 主题 → 归属目录 映射表',
-    '',
-    '### 主题A（1）',
-    '',
-    '| 文件名 | 主题 | 归属目录 |',
-    '|---|---|---|',
-    '| a.md | 主题A | wiki/主题A/ |',
-    '',
-    '---',
-    '',
-    '## 命名规则',
-    '',
-    '- fixture',
-    '',
-  ].join(eol), 'utf8');
-  fs.writeFileSync(path.join(root, 'wiki', '知识沉淀总览.html'), [
-    '<!doctype html><html><body>',
-    '<script>',
-    'const DATA = {',
-    '  "summary": { "total": 1, "topics": 1, "files": 1, "archive": 0 },',
-    '  "topics": [',
-    '    { "name": "主题A", "files": [',
-    '      { "file": "a.md", "topic": "主题A", "dir": "./主题A/" }',
-    '    ]}',
-    '  ]',
-    '};',
-    '</script>',
-    '</body></html>',
-    '',
-  ].join('\n'), 'utf8');
-  return root;
-};
-
-// extraEnv：注入被测脚本环境变量（场景 8/9 用 FLOW_KIT_TODAY 固定「今天」，默认继承父进程环境不变）
-const runGen = (root, extraArgs = [], extraEnv = {}) => spawnSync(process.execPath, [GEN, ...extraArgs], { cwd: root, encoding: 'utf8', env: { ...process.env, ...extraEnv } });
-
-// ---- 场景 1：CRLF INDEX ——「用途」列重生成后保持 + 行尾保持（缺陷回归）----
-{
-  const root = mkfix('\r\n');
-  const r = runGen(root);
-  const out = fs.readFileSync(path.join(root, 'wiki', 'INDEX.md'), 'utf8');
-  const { crlf, lf } = eolStats(path.join(root, 'wiki', 'INDEX.md'));
-  check('场景 1：CRLF INDEX 生成器 exit 0', r.status === 0, `exit=${r.status}\n${r.stdout}${r.stderr}`);
-  check(`场景 1：「用途」列保持（CRLF 致整表解析为空即丢——papercut 2026-09-17）`, out.includes(USAGE_COL), out.split('\n').slice(0, 10).join('\n'));
-  check('场景 1：未退化为 <待补>', !out.includes('<待补'), out.split('\n').slice(0, 10).join('\n'));
-  check('场景 1：行尾保持 CRLF（未被改写为 LF）', crlf > 0 && lf === 0, `crlf=${crlf} bareLF=${lf}`);
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- 场景 2：LF INDEX 对照 —— 用途保持（证明解析不依赖行尾）----
-{
-  const root = mkfix('\n');
-  const r = runGen(root);
-  const out = fs.readFileSync(path.join(root, 'wiki', 'INDEX.md'), 'utf8');
-  const { crlf, lf } = eolStats(path.join(root, 'wiki', 'INDEX.md'));
-  check('场景 2：LF INDEX 生成器 exit 0', r.status === 0, `exit=${r.status}\n${r.stdout}${r.stderr}`);
-  check('场景 2：「用途」列保持', out.includes(USAGE_COL), out.split('\n').slice(0, 10).join('\n'));
-  check('场景 2：行尾保持 LF', lf > 0 && crlf === 0, `crlf=${crlf} bareLF=${lf}`);
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- 场景 3：新增 wiki 文件 —— 速览计数 / 合计行 / 看板 DATA 同步 ----
-{
-  const root = mkfix('\r\n');
-  fs.writeFileSync(path.join(root, 'wiki', '主题A', 'b.md'), '# b\n', 'utf8');
-  const r = runGen(root);
-  const index = fs.readFileSync(path.join(root, 'wiki', 'INDEX.md'), 'utf8');
-  const board = fs.readFileSync(path.join(root, 'wiki', '知识沉淀总览.html'), 'utf8');
-  check('场景 3：新增文件后生成器 exit 0', r.status === 0, `exit=${r.status}\n${r.stdout}${r.stderr}`);
-  check('场景 3：速览表计数同步为 2', /\| 主题A \| 2 \|/.test(index), index.split('\n').slice(0, 8).join('\n'));
-  check('场景 3：合计行同步为 2 份', index.includes('合计：**2 份**知识文档，**1 个主题**'), index.split('\n').slice(0, 12).join('\n'));
-  check('场景 3：看板 DATA 同步 total=2', /"summary": \{ "total": 2/.test(board), '');
-  check('场景 3：「用途」列保持', index.includes(USAGE_COL), '');
-  check('场景 3：映射表节收录新文件', index.includes('| b.md | 主题A | wiki/主题A/ |'), '');
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- 场景 4：映射表锚点缺失 → fail-loud（2026-09-24 审查修复：原静默跳过致映射表悄悄陈旧仍报成功）----
-{
-  const root = mkfix('\n');
-  const idx = path.join(root, 'wiki', 'INDEX.md');
-  fs.writeFileSync(idx, fs.readFileSync(idx, 'utf8').replace(/^## 文件 → 主题 → 归属目录 映射表$/m, '## 映射（锚点被改）'), 'utf8');
-  const r = runGen(root);
-  check('场景 4：映射表锚点缺失 → exit 1', r.status === 1, `exit=${r.status}\n${r.stdout}${r.stderr}`);
-  check('场景 4：报错点名映射表锚点', (r.stderr || '').includes('映射表锚点'), r.stderr);
-  check('场景 4：未写盘（INDEX 原样保留）', fs.readFileSync(idx, 'utf8').includes('## 映射（锚点被改）'), '');
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- 场景 5：drafts-archive 缺失 → 不崩栈，警告 + 归档按 0（2026-09-24 审查修复）----
-{
-  const root = mkfix('\n');
-  fs.rmSync(path.join(root, 'wiki', 'drafts-archive'), { recursive: true });
-  const r = runGen(root);
-  check('场景 5：drafts-archive 缺失 → exit 0（不崩栈）', r.status === 0, `exit=${r.status}\n${r.stdout}${r.stderr}`);
-  check('场景 5：stderr 有缺失警告', (r.stderr || '').includes('drafts-archive'), r.stderr);
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- 场景 6：用途列含管道符 → 转义保 round-trip（p2-batch2：含管道的用途描述曾切坏表格行、
-//      下次生成把人工文本静默重置为 <待补>）----
-{
-  const root = mkfix('\n');
-  const BS = String.fromCharCode(92); // 反斜杠字符（JS 字符串 '\|' 中 \| 就是裸管道无转义语义——须显式拼）
-  const USAGE_WITH_PIPE = '用于 A' + BS + '|B 两类（含竖线）'; // 转义形态输入（反斜杠+管道）
-  const idx = path.join(root, 'wiki', 'INDEX.md');
-  fs.writeFileSync(idx, fs.readFileSync(idx, 'utf8').replace(USAGE_COL, USAGE_WITH_PIPE), 'utf8');
-  const r1 = runGen(root);
-  const out1 = fs.readFileSync(idx, 'utf8');
-  check('场景 6：含转义管道用途生成 exit 0 且原样保留', r1.status === 0 && out1.includes(USAGE_WITH_PIPE), `exit=${r1.status}\n${out1.split('\n').slice(0, 8).join('\n')}`);
-  const r2 = runGen(root);
-  const out2 = fs.readFileSync(idx, 'utf8');
-  check('场景 6：二次生成用途文本保持（round-trip 不重置为 <待补>）',
-    r2.status === 0 && out2.includes(USAGE_WITH_PIPE) && !out2.includes('<待补'), out2.split('\n').slice(0, 8).join('\n'));
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- 场景 7：--check 漂移判定（2026-10-10 wiki-index-drift：供 doctor §6 镜像 workflow INDEX 检查）----
-//      不写盘；一致 exit 0，任一生成区漂移 exit 1 + 差异预览。行尾归一（CRLF clone 不假阳性）
-{
-  const root = mkfix('\r\n');
-  // 先跑一次正规生成，把 INDEX/看板对齐到磁盘事实
-  const r0 = runGen(root);
-  check('场景 7：前置生成 exit 0', r0.status === 0, `exit=${r0.status}\n${r0.stdout}${r0.stderr}`);
-  // 对齐后 --check 须一致（CRLF INDEX 尤其不能因行尾假阳性）
-  const r1 = runGen(root, ['--check']);
-  check('场景 7a --check 对齐态 → exit 0 且提示一致',
-    r1.status === 0 && (r1.stdout || '').includes('一致'), `exit=${r1.status}\n${r1.stdout}${r1.stderr}`);
-  check('场景 7a --check 不写盘（INDEX 内容字节不变）',
-    fs.readFileSync(path.join(root, 'wiki', 'INDEX.md'), 'utf8').includes(USAGE_COL), '');
-  // 磁盘新增文件 → 生成区与磁盘不一致 → exit 1
-  fs.writeFileSync(path.join(root, 'wiki', '主题A', 'b.md'), '# b\n', 'utf8');
-  const r2 = runGen(root, ['--check']);
-  check('场景 7b --check 漂移（磁盘新增文件未重生成）→ exit 1',
-    r2.status === 1 && (r2.stderr || '').includes('不一致'), `exit=${r2.status}\n${r2.stdout}${r2.stderr}`);
-  check('场景 7b --check 不写盘（漂移时仍不覆盖磁盘文件）',
-    !fs.readFileSync(path.join(root, 'wiki', 'INDEX.md'), 'utf8').includes('| b.md | 主题A |'), '');
-  // 修复后 --check 恢复 exit 0
-  const r3 = runGen(root);
-  const r4 = runGen(root, ['--check']);
-  check('场景 7c 重生成后 --check 恢复 exit 0', r3.status === 0 && r4.status === 0, `exit3=${r3.status} exit4=${r4.status}\n${r4.stdout}${r4.stderr}`);
-  // 看板 DATA 被手改 → exit 1（与 INDEX 漂移同档）
-  const board = path.join(root, 'wiki', '知识沉淀总览.html');
-  fs.writeFileSync(board, fs.readFileSync(board, 'utf8').replace('"total": 2', '"total": 99'), 'utf8');
-  const r5 = runGen(root, ['--check']);
-  check('场景 7d --check 看板 DATA 漂移 → exit 1',
-    r5.status === 1 && (r5.stderr || '').includes('知识沉淀总览.html'), `exit=${r5.status}\n${r5.stdout}${r5.stderr}`);
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- 场景 8：草稿超龄 WARN（P1-2：drafts-archive/<YYYY-MM-DD-主题>/ 落盘超 14 天未归类 → stdout 提醒）----
-//      advisory 档只提醒不阻断：exit 0、INDEX/看板 DATA 不因 WARN 有任何变化；FLOW_KIT_TODAY 固定「今天」保证时间可控
-{
-  const root = mkfix('\n');
-  const DRAFT_DIR = '2026-09-01-登录优化';
-  const DRAFT_DATE = '2026-09-01';
-  fs.mkdirSync(path.join(root, 'wiki', 'drafts-archive', DRAFT_DIR));
-  fs.writeFileSync(path.join(root, 'wiki', 'drafts-archive', DRAFT_DIR, '登录优化.md'), '# 登录优化草稿\n', 'utf8');
-  const board = path.join(root, 'wiki', '知识沉淀总览.html');
-  const warnLine = `[WARN 草稿超龄] drafts-archive/${DRAFT_DIR}/登录优化.md 落于 ${DRAFT_DATE} 未归类——草稿是中间态，归类到 wiki/登录优化/ 后跑 gen-wiki-board + verify-wiki-consistency`;
-
-  // a) 「今天」= 草稿日期 + 15 天（> 14 天档）→ WARN 整行点名该草稿
-  const ra = runGen(root, [], { FLOW_KIT_TODAY: '2026-09-16' });
-  check('场景 8a：超龄 15 天 → exit 0（advisory 不阻断）', ra.status === 0, `exit=${ra.status}\n${ra.stdout}${ra.stderr}`);
-  check('场景 8a：stdout 含超龄 WARN 且整行点名草稿', (ra.stdout || '').includes(warnLine), ra.stdout);
-  check('场景 8a：生成物不受影响（看板归档计数仍为文件数 1）', /"archive": 1/.test(fs.readFileSync(board, 'utf8')), '');
-
-  // b) 「今天」= 同日 / 恰 14 天 → 未超龄，无 WARN（超过才提醒）
-  const rb = runGen(root, [], { FLOW_KIT_TODAY: DRAFT_DATE });
-  check('场景 8b：同日 → 无超龄 WARN', rb.status === 0 && !(rb.stdout || '').includes('[WARN 草稿超龄]'), rb.stdout);
-  const rb14 = runGen(root, [], { FLOW_KIT_TODAY: '2026-09-15' });
-  check('场景 8b：恰 14 天 → 无超龄 WARN（边界）', rb14.status === 0 && !(rb14.stdout || '').includes('[WARN 草稿超龄]'), rb14.stdout);
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- 场景 9：目录名无日期前缀（人工建的目录）→ 静默跳过：不 WARN、不报错、生成物不受影响（P1-2）----
-{
-  const root = mkfix('\n');
-  fs.mkdirSync(path.join(root, 'wiki', 'drafts-archive', '临时素材'));
-  fs.writeFileSync(path.join(root, 'wiki', 'drafts-archive', '临时素材', 'x.md'), '# x\n', 'utf8');
-  // 「今天」取远期（2027-01-01）：若误把无日期目录判成超龄必触发 WARN，可当场暴露缺陷
-  const r = runGen(root, [], { FLOW_KIT_TODAY: '2027-01-01' });
-  const board = fs.readFileSync(path.join(root, 'wiki', '知识沉淀总览.html'), 'utf8');
-  check('场景 9：无日期前缀目录 → exit 0（不报错）', r.status === 0, `exit=${r.status}\n${r.stdout}${r.stderr}`);
-  check('场景 9：无超龄 WARN（静默跳过）', !(r.stdout || '').includes('[WARN 草稿超龄]'), r.stdout);
-  check('场景 9：看板输出不受影响（归档计数仍为文件数 1）', /"archive": 1/.test(board), '');
-  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/gen-workflow-dashboard.mjs

@@ -1,251 +0,0 @@
-#!/usr/bin/env node
-// gen-workflow-dashboard.mjs — workflow 仪表盘（2026-10-08，intent workflow-dashboard，L1）
-// 一键生成 workflow/DASHBOARD.md：头部红绿灯（质量门 + 关单时长带）+ 时长分布 + 质量月度行。
-// 观测面非门禁：红灯是「看」的不是「拦」的（gen-workflow-metrics 同教训——快照拿去做漂移校验只会常红）；
-// 想看就跑一行命令，与 INDEX.md「状态变更后重跑」同模式，不挂钩子（post-commit 自动重生成有脏工作区问题）。
-// 时长口径：done 态 intents 的立项日（frontmatter 日期）→ confirmations.jsonl 该 doc **最早** done 行 ts
-// （多次 done 取首关；无台账行的存量单诚实跳过不虚构）。真实分布基准（2026-10-08 本仓 43 单）：P50=0 / P90=7 / max=8。
-// 复用：require('./agg-delegations.cjs') 纯函数（readLedger / metrics / gateMonth / expansionVerdict）——
-//   质量判据零重复（N3 教训）；readLedger 的 root 显式参数 + soft 模式为本批使能导出（原签名行为不变）。
-// isMain 守卫 + 纯函数导出（board-kb-p1 先例）：closeDurations / pickPct / durationVerdict / normalizeForCheck 供测试 import 直测。
-// 用法：node .agents/scripts/gen-workflow-dashboard.mjs [--dry-run | --check]
-//   --check  不写盘；与磁盘不一致时 exit 1 并打印差异（供 check-loop 检查 11 漂移告警，2026-10-08 selfmeasure-and-modularize）
-//     两道归一缺一不可（均照 gen-workflow-index.mjs 先例）：
-//     ① 行尾：fresh clone 检出 CRLF、生成段恒 LF——直接字符串相等会在克隆环境假阳性「漂移」（2026-09-30 该坑已在
-//        gen-workflow-index 踩过，本件照抄 normEol）；
-//     ② 「生成于 <ISO>」行：每次运行必变，不归一则门禁恒红（不可消退噪声，违反 audit-gate-hardening P3 教训）。
-// 测试：node templates/_agents/scripts/gen-workflow-dashboard.test.mjs
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { createRequire } from 'node:module';
-import { readLedgerRows } from './ledger-loader.mjs';
-// 委派台账分片感知读（2026-10-13 ledger-shard-ledgers 回灌）：合并文本（主台账 ∪ delegations.d/*.md）
-// 由本件经 readLedgerText 取（读侧单源），经 opts.text 注入 agg.readLedger——.cjs 库模式无法自装载 .mjs。
-import { readLedgerText } from './ledger-shards.mjs';
-
-const require = createRequire(import.meta.url);
-const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
-const ROOT = process.env.CHECK_LOOP_ROOT || path.resolve(SCRIPT_DIR, '..', '..');
-const agg = require('./agg-delegations.cjs');
-
-// 关单时长控制带（默认带，数据说话后调）：P50 ≤ 1 天 且 P90 ≤ 10 天为绿——本仓实测 P50=0/P90=7 在带内，
-// 留 7 天 P90 余量覆盖跨周单；不带配置文件（YAGNI，真需要项目级调带时再外置）。
-export const DURATION_BAND = { p50Max: 1, p90Max: 10 };
-
-// closeDurations：done intents 关单天数（纯函数供测试）——doneMap: Map<rel, 最早 done 行 ISO ts>
-export function closeDurations(intents, doneMap) {
-  const days = [];
-  let skipped = 0;
-  for (const it of intents) {
-    const ts = doneMap.get(it.rel);
-    const t = ts === undefined ? NaN : Date.parse(ts);
-    const d0 = Date.parse(`${it.date}T00:00:00Z`);
-    if (!Number.isFinite(t) || !Number.isFinite(d0)) { skipped++; continue; }
-    days.push({ rel: it.rel, days: Math.max(0, Math.floor((t - d0) / 86400000)) }); // floor=日历天差：同日关门 0.625 天仍记 0（round 会记 1）
-  }
-  days.sort((a, b) => a.days - b.days || a.rel.localeCompare(b.rel));
-  return { days, skipped };
-}
-
-// pickPct：百分位（升序数组；与 repo 内实测探针同口径 floor(len*p) 截断）
-export function pickPct(sortedNums, p) {
-  if (!sortedNums.length) return null;
-  return sortedNums[Math.min(sortedNums.length - 1, Math.floor(sortedNums.length * p))];
-}
-
-// durationVerdict：时长带判定（三态：无样本 null / 带内 / 超带）
-export function durationVerdict(p50, p90) {
-  if (p50 === null) return { ok: null, text: '⚪ 暂无关单样本（无带台账 done 行的 done intent）' };
-  const ok = p50 <= DURATION_BAND.p50Max && p90 <= DURATION_BAND.p90Max;
-  return { ok, text: ok ? '✅ 带内' : '❌ 超带' };
-}
-
-// fmField：frontmatter 单行「键: 值」最小提取（check-loop fmGet 无 isMain 守卫不可 import——本件够用）
-function fmField(text, key) {
-  const m = String(text).match(new RegExp(`^${key}: (.*)$`, 'm'));
-  return m ? m[1].trim() : '';
-}
-
-// collectDoneIntents：done 态 intents（排除 _TEMPLATE）→ [{rel, date}]
-function collectDoneIntents(root) {
-  const dir = path.join(root, 'workflow', 'intents');
-  const out = [];
-  if (!fs.existsSync(dir)) return out;
-  for (const f of fs.readdirSync(dir)) {
-    if (!f.endsWith('.md') || f.startsWith('_TEMPLATE')) continue;
-    const text = fs.readFileSync(path.join(dir, f), 'utf8');
-    if (fmField(text, '状态') !== 'done') continue;
-    const date = fmField(text, '日期');
-    if (!/^\d{4}-\d{2}-\d{2}$/.test(date)) continue;
-    out.push({ rel: `workflow/intents/${f}`, date });
-  }
-  return out;
-}
-
-// collectDoneMap：台账 earliest done 行（坏行容忍，doc 正斜杠根相对——沿检查 14/15 口径）
-function collectDoneMap(root) {
-  const doneMap = new Map();
-  // 读法收敛 ledger-loader（2026-10-12 ledger-loader-p1）：earliest done 行取自时间戳比较，
-  // 与行序无关，故并入台账视图不改变本函数语义（分片行同样参与「最早」判定）
-  for (const e of readLedgerRows(root)) {
-    if (e && e.stage === 'done' && typeof e.doc === 'string' && e.doc.startsWith('workflow/intents/')) {
-      const prev = doneMap.get(e.doc);
-      if (prev === undefined || e.ts < prev) doneMap.set(e.doc, e.ts);
-    }
-  }
-  return doneMap;
-}
-
-// qualityRows：月度质量行（判据全部复用 agg——本函数只做分组与格式化）
-export function qualityRows(root) {
-  // 分片感知（2026-10-13 ledger-shard-ledgers）：text = 主台账 ∪ delegations.d/*.md；空文本（无台账
-  // 装户）→ rows []，soft 优雅降级语义不变。
-  const rows = agg.readLedger(root, { soft: true, text: readLedgerText(root, 'delegations') });
-  const byMonth = {};
-  for (const r of rows) (byMonth[r.date.slice(0, 7)] ||= []).push(r);
-  const months = Object.keys(byMonth).sort();
-  const verdictMap = new Map();
-  const monthOkMap = new Map();
-  const out = [];
-  for (const ym of months) {
-    const m = agg.metrics(byMonth[ym]);
-    const { items, monthOk } = agg.gateMonth(m);
-    monthOkMap.set(ym, monthOk);
-    const [y, mo] = ym.split('-').map(Number);
-    const pd = new Date(Date.UTC(y, mo - 2, 1));
-    const prev = `${pd.getUTCFullYear()}-${String(pd.getUTCMonth() + 1).padStart(2, '0')}`;
-    const verdict = agg.expansionVerdict(monthOk, monthOkMap.get(prev), !months.includes(prev), items);
-    verdictMap.set(ym, verdict);
-    const pct = (x) => (Number.isFinite(x) ? `${Math.round(x * 100)}%` : '—');
-    const avg = Number.isFinite(m.avgRework) ? m.avgRework.toFixed(2) : '—';
-    // 门禁噪声返工单列（2026-10-08 selfmeasure-and-modularize）：设计返工与噪声返工分列可诊断——
-    // 「平均返工」把两者平均在一起时看不出该改门禁还是改设计。
-    out.push(`| ${ym} | ${m.total} | ${pct(m.passRate)} | ${m.reworkSum} | ${m.reworkNoiseSum} | ${avg} | ${pct(m.fallbackRate)} | ${agg.fmtAccept(m)} | ${verdict} |`);
-  }
-  return { rows: out, verdictMap, months };
-}
-
-// gateRoiLines：门禁 ROI 节的行（2026-10-08 gate-roi-metrics）
-//   口径声明 + 采集/查看入口。**刻意不把运行数据（次数 / 耗时 / 噪声率）铺进 DASHBOARD**——
-//   本文件被检查 11（--check）覆盖，而采集数据每跑一次门禁就变一次：铺进去等于
-//   「每次采集必产一条漂移 WARN」＝不可消除噪声（audit-gate-hardening P3 的反面教材）。
-//   连「有无数据」也不做分支（cache 已 gitignore → 新克隆必然无 cache，一采集文案就翻转 = 又一次漂移）：
-//   降级语义交由 CLI 承担——agg-gate-stats.mjs 空数据时自己打印「未采集——跑 check-loop --gate-stats」。
-//   故本节恒为静态文案：**任何时候生成本文件，字节恒等**（测试 ⑤ 的两条 --check exit 0 钉的就是这条）。
-export function gateRoiLines() {
-  return [
-    '- 采集：`node .agents/scripts/check-loop.mjs --all --gate-stats`（--all 全段成本面——2026-10-13 分道后裸跑只记硬门段；数据落 `.agents/cache/gate-stats.jsonl`，该目录已 gitignore；不带 flag 时零写入、输出逐字节不变）',
-    '- 看数值：`node .agents/scripts/agg-gate-stats.mjs [--days 30]`——输出成本排序 + 两类决策依据：噪声率 top（该收窄或该修）、死检查（该拆或该降级）；无采集数据时该命令自己提示「未采集」并给出采集命令',
-    '- 口径：耗时**含子进程时间**（检查 11 调两个生成器 `--check`、检查 13 调 `rule-budget.mjs`）——门禁真实成本，不做剔除；样本 <5 次时只作线索，不作决策依据',
-    '- 本节为何不铺数值：本文件被检查 11 漂移门覆盖，运行数据每跑一次门禁即变一次，铺进来会让每次采集都产一条漂移 WARN（不可消除噪声）',
-  ];
-}
-
-const USAGE = '用法：node .agents/scripts/gen-workflow-dashboard.mjs [--dry-run | --check]';
-
-// normalizeForCheck：--check 比对前的双归一（纯函数供测试直测）——行尾 CRLF→LF + 「生成于 <ISO>」行抹平。
-//   导出是为了让测试不必 spawn 子进程即可断言「仅时间戳不同 → 归一后相等」（门禁恒红的直接防线）。
-export function normalizeForCheck(s) {
-  return String(s)
-    .replace(/\r\n/g, '\n')
-    .replace(/生成于 \d{4}-\d{2}-\d{2}T[\d:.]+Z/g, '生成于 <TS>');
-}
-
-function firstDiffLine(a, b) {
-  const la = a.split('\n');
-  const lb = b.split('\n');
-  for (let i = 0; i < Math.max(la.length, lb.length); i++) {
-    if (la[i] !== lb[i]) return i + 1;
-  }
-  return -1;
-}
-
-function main() {
-  const args = process.argv.slice(2);
-  const dry = args.includes('--dry-run');
-  const check = args.includes('--check');
-  const intents = collectDoneIntents(ROOT);
-  const doneMap = collectDoneMap(ROOT);
-  const { days, skipped } = closeDurations(intents, doneMap);
-  const nums = days.map((d) => d.days);
-  const p50 = pickPct(nums, 0.5);
-  const p90 = pickPct(nums, 0.9);
-  const mx = nums.length ? nums[nums.length - 1] : null;
-  const dv = durationVerdict(p50, p90);
-  const q = qualityRows(ROOT);
-  const curYm = q.months[q.months.length - 1];
-  const qVerdict = curYm ? q.verdictMap.get(curYm) : '⚪ 台账暂无数据（delegations.md 无结果表行）';
-
-  const slowest = days.slice(-3).reverse().map((d) => `${d.rel.split('/').pop()}=${d.days}天`).join('、') || '—';
-  const stat = (x) => (x === null ? '—' : `${x} 天`);
-  const lines = [
-    '# workflow 仪表盘（生成物，勿手改）',
-    '',
-    `> 生成器 \`node .agents/scripts/gen-workflow-dashboard.mjs\`；生成于 ${new Date().toISOString()}`,
-    '> 观测面非门禁：红灯提示看，不拦提交；想看就跑一行命令（与 INDEX.md「状态变更后重跑」同模式）。',
-    '',
-    '## 红绿灯',
-    '',
-    `- ${qVerdict}｜质量门（门槛权威 = workflow/delegations.md §并发扩容门槛：一次通过率 ≥90%、月度返工 0、无主兜底、样本 ≥5）${curYm ? `——当月 ${curYm}` : ''}`,
-    `- ${dv.text}｜关单时长带（P50 ≤ ${DURATION_BAND.p50Max} 天 且 P90 ≤ ${DURATION_BAND.p90Max} 天）：P50=${stat(p50)} / P90=${stat(p90)} / max=${stat(mx)}（样本 ${nums.length}，无台账行跳过 ${skipped}）`,
-    '',
-    '## 关单时长（done intents：立项日 → 台账最早 done 行）',
-    '',
-    '| 指标 | 值 |',
-    '|------|----|',
-    `| P50 | ${stat(p50)} |`,
-    `| P90 | ${stat(p90)} |`,
-    `| max | ${stat(mx)} |`,
-    `| 样本数 | ${nums.length} |`,
-    `| 无台账行跳过（存量单） | ${skipped} |`,
-    '',
-    `最慢 3 单：${slowest}`,
-    '',
-    '## 质量 / 返工（月度，判据复用 agg-delegations）',
-    '',
-    '| 月份 | 有效任务 | 一次通过率 | 设计返工 | 门禁噪声返工 | 平均返工 | 主兜底占比 | 产出接受率 | 扩容门判定 |',
-    '|------|----------|------------|---------|-------------|--------|------------|------------|',
-    ...(q.rows.length ? q.rows : ['| — | — | — | — | — | — | — | 台账暂无数据 |']),
-    '',
-    '## 门禁 ROI（门禁自身的度量）',
-    '',
-    ...gateRoiLines(),
-    '',
-  ];
-  const out = lines.join('\n');
-  const target = path.join(ROOT, 'workflow', 'DASHBOARD.md');
-  // --check 优先于写盘、--dry-run 优先于 --check（显式不写盘意图最高）：比对模式不改任何盘面。
-  if (check) {
-    let disk;
-    try {
-      disk = fs.readFileSync(target, 'utf8');
-    } catch {
-      console.error(`[check] ❌ ${path.relative(ROOT, target) || 'workflow/DASHBOARD.md'} 不存在或不可读——跑 node .agents/scripts/gen-workflow-dashboard.mjs 生成`);
-      process.exitCode = 1;
-      return;
-    }
-    const a = normalizeForCheck(out);
-    const b = normalizeForCheck(disk);
-    if (a === b) {
-      console.log(`[check] ✅ ${path.relative(ROOT, target) || 'workflow/DASHBOARD.md'} 与盘面一致（行尾与「生成于」时间戳已归一）`);
-      return;
-    }
-    const ln = firstDiffLine(a, b);
-    console.error(`[check] ❌ ${path.relative(ROOT, target) || 'workflow/DASHBOARD.md'} 与当前事实不一致（首个差异在第 ${ln} 行）——跑 node .agents/scripts/gen-workflow-dashboard.mjs 重新生成`);
-    process.exitCode = 1;
-    return;
-  }
-  if (dry) {
-    console.log(out);
-    console.log(`（--dry-run：未写盘。${USAGE}）`);
-    return;
-  }
-  fs.mkdirSync(path.dirname(target), { recursive: true });
-  fs.writeFileSync(target, out, 'utf8');
-  console.log(`✅ 已生成 ${path.relative(ROOT, target) || 'workflow/DASHBOARD.md'}`);
-  console.log(`   红绿灯：${qVerdict.split('｜')[0].trim()} 质量门 ｜ ${dv.text} 关单时长带（P50=${stat(p50)} / P90=${stat(p90)}，样本 ${nums.length}）`);
-}
-
-const isMain = process.argv[1] && process.argv[1].replace(/\\/g, '/').endsWith('gen-workflow-dashboard.mjs');
-if (isMain) main();