agentic-flow-kit 1.8.7 → 2.0.0

package/templates/_agents/scripts/gen-workflow-dashboard.test.mjs

@@ -1,188 +0,0 @@
-// gen-workflow-dashboard.test.mjs — workflow 仪表盘测试（2026-10-08 workflow-dashboard，L1）
-// 两层：①纯函数直测（closeDurations 四例 / pickPct / durationVerdict 三态 / qualityRows 复用 agg 同值对账）；
-//       ②端到端 spawn 一例（CHECK_LOOP_ROOT 注入 fixture，断言 DASHBOARD.md 红绿灯行与结构）。
-// fixture：临时 root（intents + confirmations.jsonl + delegations.md 两表）。
-// 用法：node templates/_agents/scripts/gen-workflow-dashboard.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, pathToFileURL } from 'node:url';
-
-const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
-const { closeDurations, pickPct, durationVerdict, qualityRows, DURATION_BAND, normalizeForCheck, gateRoiLines } =
-  await import(pathToFileURL(path.join(SCRIPT_DIR, 'gen-workflow-dashboard.mjs')).href);
-import { createRequire } from 'node:module';
-const require2 = createRequire(import.meta.url);
-const aggCjs = require2(path.join(SCRIPT_DIR, 'agg-delegations.cjs'));
-
-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 W = (root, rel, content) => { fs.mkdirSync(path.join(root, path.dirname(rel)), { recursive: true }); fs.writeFileSync(path.join(root, rel), content); };
-const INTENT = (fm) => `---\n${fm}\n---\n# INTENT — x\n`;
-
-// ---- ① closeDurations 四例 ----
-{
-  const intents = [
-    { rel: 'workflow/intents/2026-10-01-same.md', date: '2026-10-01' },   // 同日 → 0
-    { rel: 'workflow/intents/2026-09-20-cross.md', date: '2026-09-20' },  // 跨 7 天
-    { rel: 'workflow/intents/2026-09-01-multi.md', date: '2026-09-01' },  // 多次 done → 取最早（=14 天，非 3 天）
-    { rel: 'workflow/intents/2026-09-05-noledger.md', date: '2026-09-05' }, // 无台账行 → 跳过
-    { rel: 'workflow/intents/2026-09-10-baddate.md', date: 'not-a-date' },  // 坏日期 → 跳过
-  ];
-  const doneMap = new Map([
-    ['workflow/intents/2026-10-01-same.md', '2026-10-01T15:00:00.000Z'],
-    ['workflow/intents/2026-09-20-cross.md', '2026-09-27T12:00:00.000Z'],
-    ['workflow/intents/2026-09-01-multi.md', '2026-09-04T00:00:00.000Z'], // 后发生的 done 行
-  ]);
-  // 最早 done 行由 collectDoneMap 保证——此处直测取值；「取最早」在 ② 端到端断言
-  doneMap.set('workflow/intents/2026-09-01-multi.md', '2026-09-04T00:00:00.000Z');
-  const { days, skipped } = closeDurations(intents, doneMap);
-  const byRel = new Map(days.map((d) => [d.rel, d.days]));
-  check('时长：同日关单 = 0 天', byRel.get('workflow/intents/2026-10-01-same.md') === 0, JSON.stringify(days));
-  check('时长：跨 7 天 = 7', byRel.get('workflow/intents/2026-09-20-cross.md') === 7);
-  check('时长：doneMap 值即最早行 → 3 天（最早判定在 collectDoneMap，端到端覆盖）', byRel.get('workflow/intents/2026-09-01-multi.md') === 3);
-  check('时长：无台账行 + 坏日期 → skipped=2 不虚构', skipped === 2 && !byRel.has('workflow/intents/2026-09-05-noledger.md'), `skipped=${skipped}`);
-}
-
-// ---- ② pickPct / durationVerdict 三态 ----
-{
-  check('pickPct：43 样本 P50=0 / P90=7（真实分布回归基准）',
-    pickPct([...Array(26).fill(0), ...Array(9).fill(1), 7, 8, 8, 8, 8], 0.5) === 0
-    && pickPct([...Array(26).fill(0), ...Array(9).fill(1), 7, 8, 8, 8, 8], 0.9) === 8,
-    `p50=${pickPct([0, 0, 1], 0.5)}`);
-  check('pickPct：空 → null', pickPct([], 0.5) === null);
-  check('时长带：P50=0/P90=7 → 带内；P50=2 → 超带；null → 无样本',
-    durationVerdict(0, 7).ok === true && durationVerdict(2, 5).ok === false && durationVerdict(null, null).ok === null,
-    JSON.stringify([durationVerdict(0, 7), durationVerdict(2, 5), durationVerdict(null, null)]));
-  check('时长带常量：P50≤1 且 P90≤10（默认带声明）', DURATION_BAND.p50Max === 1 && DURATION_BAND.p90Max === 10);
-}
-
-// ---- ③ qualityRows 复用 agg 同值对账 + 端到端 spawn ----
-{
-  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'fk-dash-'));
-  // delegations.md：2026-09 二十单全「一次通过」（委派 ≥ 样本护栏 minSample=20）→ 口径项全过
-  const head = '## 委派结果\n\n| 日期 | 被委派方 | 任务一句话 | 结果 | 备注 |\n|------|----------|------------|------|------|\n';
-  const rows9 = [...Array(20)].map((_, i) => `| 2026-09-${String(i + 1).padStart(2, '0')} | x | y${i} | 一次通过 | 2026-09-a${i} |\n`).join('');
-  W(root, 'workflow/delegations.md', `${head}${rows9}`);
-  // intents + 台账：same=0 / multi 两行 done 取最早（09-01 → 09-03=2 天，第二行 09-10 不采纳）
-  W(root, 'workflow/intents/2026-09-01-multi.md', INTENT('状态: done\n级别: L1\n日期: 2026-09-01\n模块: pipeline'));
-  W(root, 'workflow/intents/2026-10-01-same.md', INTENT('状态: done\n级别: L1\n日期: 2026-10-01\n模块: pipeline'));
-  W(root, 'workflow/intents/2026-09-05-noledger.md', INTENT('状态: done\n级别: L1\n日期: 2026-09-05\n模块: pipeline'));
-  W(root, 'workflow/intents/2026-09-06-open.md', INTENT('状态: approved\n级别: L1\n日期: 2026-09-06\n模块: pipeline')); // 非 done 不计
-  W(root, '.agents/confirmations.jsonl', [
-    JSON.stringify({ ts: '2026-09-02T00:00:00.000Z', doc: 'workflow/intents/2026-09-01-multi.md', stage: 'done' }),
-    JSON.stringify({ ts: '2026-09-10T00:00:00.000Z', doc: 'workflow/intents/2026-09-01-multi.md', stage: 'done' }),
-    JSON.stringify({ ts: '2026-10-01T20:00:00.000Z', doc: 'workflow/intents/2026-10-01-same.md', stage: 'done' }),
-    JSON.stringify({ ts: '2026-09-02T00:00:00.000Z', doc: 'workflow/intents/2026-09-01-multi.md', stage: 'approved' }), // 非 done 行不混
-    'not-json-bad-line',
-  ].join('\n') + '\n');
-
-  // 纯函数层：qualityRows 与 agg 直算同值
-  const q = qualityRows(root);
-  check('qualityRows：月份行数与台账月份一致（2026-09 一行）', q.rows.length === 1 && q.rows[0].startsWith('| 2026-09 |'), JSON.stringify(q.rows));
-  const m = aggCjs.metrics(aggCjs.readLedger(root, { soft: true }));
-  check('qualityRows：复用 agg 同值（total=20）', m.total === 20, `total=${m.total}`);
-  check('qualityRows：单月门全过 → 判定「本月达标」（首月连续性 1/2 属 expansionVerdict 语义）',
-    q.verdictMap.get('2026-09').includes('达标'), q.verdictMap.get('2026-09'));
-
-  // 端到端：spawn 真脚本（CHECK_LOOP_ROOT 注入）→ DASHBOARD.md 结构断言
-  const r = spawnSync(process.execPath, [path.join(SCRIPT_DIR, 'gen-workflow-dashboard.mjs')], {
-    cwd: root, encoding: 'utf8',
-    env: { ...process.env, CHECK_LOOP_ROOT: root },
-  });
-  const dash = fs.readFileSync(path.join(root, 'workflow', 'DASHBOARD.md'), 'utf8');
-  check('端到端：exit 0 + 生成 DASHBOARD.md', r.status === 0 && fs.existsSync(path.join(root, 'workflow', 'DASHBOARD.md')), `status=${r.status} ${(r.stdout || '') + (r.stderr || '')}`);
-  check('端到端：红绿灯行质量门「达标」+ 时长带 ✅', /达标[^]*质量门/.test(dash) && /✅[^]*关单时长带/.test(dash), dash.slice(0, 500));
-  check('端到端：时长取最早 done 行且 floor 日历天（multi=1 天；第二行 9 天不采纳；同日 0 天）',
-    dash.includes('| P50 | 1 天 |') && dash.includes('| max | 1 天 |') && /最慢 3 单：2026-09-01-multi\.md=1天、2026-10-01-same\.md=0天/.test(dash), dash);
-  check('端到端：无台账行跳过计数（noledger=1）+ 生成于戳 + 勿手改头', dash.includes('无台账行跳过（存量单） | 1 |') && dash.includes('生成于') && dash.includes('勿手改'), dash);
-  check('端到端：非 done intent 不入时长样本（open 不出现）', !dash.includes('2026-09-06-open'), dash);
-  // 幂等：重跑字节不变
-  const before = fs.readFileSync(path.join(root, 'workflow', 'DASHBOARD.md'), 'utf8');
-  spawnSync(process.execPath, [path.join(SCRIPT_DIR, 'gen-workflow-dashboard.mjs')], { cwd: root, encoding: 'utf8', env: { ...process.env, CHECK_LOOP_ROOT: root } });
-  check('端到端：重跑幂等（生成于戳同 ms 内可能变——除戳行外字节一致）',
-    before.split('\n').filter((l) => !l.includes('生成于')).join('\n') === dash.split('\n').filter((l) => !l.includes('生成于')).join('\n'));
-
-  // 空台账装户：无 delegations.md / 无 confirmations.jsonl → 优雅降级不炸
-  const empty = fs.mkdtempSync(path.join(os.tmpdir(), 'fk-dash-empty-'));
-  W(empty, 'workflow/intents/2026-10-01-x.md', INTENT('状态: done\n级别: L1\n日期: 2026-10-01\n模块: pipeline'));
-  const r2 = spawnSync(process.execPath, [path.join(SCRIPT_DIR, 'gen-workflow-dashboard.mjs')], {
-    cwd: empty, encoding: 'utf8', env: { ...process.env, CHECK_LOOP_ROOT: empty },
-  });
-  const dash2 = fs.readFileSync(path.join(empty, 'workflow', 'DASHBOARD.md'), 'utf8');
-  check('端到端：空台账装户 → exit 0 + ⚪ 降级（质量门无数据 / 时长无样本 / 跳过 1）',
-    r2.status === 0 && dash2.includes('⚪') && dash2.includes('暂无关单样本') && dash2.includes('跳过（存量单） | 1 |'), `status=${r2.status} ${dash2.slice(0, 300)}`);
-  fs.rmSync(root, { recursive: true, force: true });
-  fs.rmSync(empty, { recursive: true, force: true });
-}
-
-// ---- ④ --check 漂移门（2026-10-08 selfmeasure-and-modularize）----
-// 归一（CRLF + 「生成于」戳）不过则门禁恒红 = 不可消退噪声（audit-gate-hardening P3），故纯函数层先钉死。
-{
-  const base = '# dash\n> 生成于 2026-10-07T13:56:00.376Z\n| P50 | 0 天 |\n';
-  check('--check 归一：仅「生成于」戳不同 → 归一后相等（否则门禁恒红）',
-    normalizeForCheck(base) === normalizeForCheck(base.replace('2026-10-07T13:56:00.376Z', '2026-10-08T00:00:00.000Z')));
-  check('--check 归一：CRLF 盘面 vs LF 生成段 → 相等（gen-workflow-index 2026-09-30 同坑先例）',
-    normalizeForCheck(base) === normalizeForCheck(base.replace(/\n/g, '\r\n')));
-  check('--check 归一：内容真漂移仍不等（归一不得吞真差异）',
-    normalizeForCheck(base) !== normalizeForCheck(base.replace('| P50 | 0 天 |', '| P50 | 7 天 |')));
-
-  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'fk-dash-check-'));
-  W(root, 'workflow/intents/2026-10-01-x.md', INTENT('状态: done\n级别: L1\n日期: 2026-10-01\n模块: pipeline'));
-  const gen = path.join(SCRIPT_DIR, 'gen-workflow-dashboard.mjs');
-  const runCheck = () => spawnSync(process.execPath, [gen, '--check'], {
-    cwd: root, encoding: 'utf8', env: { ...process.env, CHECK_LOOP_ROOT: root },
-  });
-  const rMiss = runCheck();
-  check('--check 端到端：盘面缺失 → exit 1 + 提示生成', rMiss.status === 1 && /不存在或不可读/.test(rMiss.stderr || ''), `status=${rMiss.status}`);
-  spawnSync(process.execPath, [gen], { cwd: root, env: { ...process.env, CHECK_LOOP_ROOT: root } });
-  const rOk = runCheck();
-  check('--check 端到端：刚生成 → exit 0', rOk.status === 0 && /一致/.test(rOk.stdout || ''), `status=${rOk.status} ${rOk.stdout || ''}${rOk.stderr || ''}`);
-  fs.appendFileSync(path.join(root, 'workflow', 'DASHBOARD.md'), '\n<!-- drift -->\n');
-  const rDrift = runCheck();
-  check('--check 端到端：内容漂移 → exit 1 + 差异行号 + 修复命令',
-    rDrift.status === 1 && /首个差异在第 \d+ 行/.test(rDrift.stderr || '') && /gen-workflow-dashboard\.mjs 重新生成/.test(rDrift.stderr || ''), `status=${rDrift.status} ${rDrift.stderr || ''}`);
-  const noWrite = fs.readFileSync(path.join(root, 'workflow', 'DASHBOARD.md'), 'utf8');
-  check('--check 端到端：不写盘（漂移态下盘面保持原样）', noWrite.includes('<!-- drift -->'));
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- ⑤ 门禁 ROI 节（2026-10-08 gate-roi-metrics）----
-// 本节存在的核心断言不是「有数值」，而是「**不因运行数据而漂移」**：DASHBOARD 被检查 11 --check 覆盖，
-// 采集数值每跑一次门禁就变一次——铺进去等于每次采集必报一条漂移 WARN（不可消除噪声）。
-{
-  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'fk-dash-roi-'));
-  W(root, 'workflow/intents/2026-10-01-x.md', INTENT('状态: done\n级别: L1\n日期: 2026-10-01\n模块: pipeline'));
-  const gen = path.join(SCRIPT_DIR, 'gen-workflow-dashboard.mjs');
-  const run = (...args) => spawnSync(process.execPath, [gen, ...args], { cwd: root, encoding: 'utf8', env: { ...process.env, CHECK_LOOP_ROOT: root } });
-  const dashOf = () => fs.readFileSync(path.join(root, 'workflow', 'DASHBOARD.md'), 'utf8');
-
-  // 无采集态（先于造 cache 生成）：节恒为静态文案，故与有无数据无关
-  const rl = gateRoiLines();
-  // 采集命令随 2026-10-13 分道带 --all（全段成本面；裸 --gate-stats 只记硬门段）
-  check('门禁ROI：节内容给出采集命令 + 看数值命令 + 无数据时 CLI 自带「未采集」提示（优雅降级不落空节）',
-    rl.join('\n').includes('check-loop.mjs --all --gate-stats') && rl.join('\n').includes('agg-gate-stats.mjs') && rl.join('\n').includes('未采集'), rl.join('\n'));
-  check('门禁ROI：节内容不含任何耗时/次数运行数值（防检查 11 每次采集报漂移的设计核心）',
-    !/\d+\s*(ms|s)\b/.test(rl.join('\n')) && !/运行\s*\d/.test(rl.join('\n')), rl.join('\n'));
-  run();
-  const dash0 = dashOf();
-  check('门禁ROI：生成物含该节 + 耗时口径显式声明「含子进程」防误读',
-    dash0.includes('## 门禁 ROI') && dash0.includes('含子进程时间'), dash0.slice(-800));
-
-  // 采集数据从无到有 → DASHBOARD 必须仍一致：这是本节设计的核心钉子
-  const cacheRel = path.join(root, '.agents', 'cache', 'gate-stats.jsonl');
-  fs.mkdirSync(path.dirname(cacheRel), { recursive: true });
-  fs.writeFileSync(cacheRel, JSON.stringify({ ts: '2026-10-08T00:00:00Z', segs: [{ id: '8', warns: 3, ms: 11809 }], totalMs: 11809 }) + '\n');
-  check('门禁ROI：采集数据「从无到有」后 --check 仍 exit 0', run('--check').status === 0, `status=${run('--check').status}`);
-  fs.appendFileSync(cacheRel, JSON.stringify({ ts: '2026-10-08T01:00:00Z', segs: [{ id: '8', warns: 9, ms: 99 }], totalMs: 99 }) + '\n');
-  check('门禁ROI：采集数据「再变一次」后 --check 仍 exit 0 且盘面字节恒等（零新增漂移源）',
-    run('--check').status === 0 && dashOf() === dash0, `status=${run('--check').status}`);
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-console.log(`\n合计: PASS ${pass} / FAIL ${fail}`);
-process.exit(fail ? 1 : 0);

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

@@ -1,201 +0,0 @@
-#!/usr/bin/env node
-// workflow 活跃层索引生成器（2026-09-21，intent 2026-09-21-workflow-doc-retrieval）
-// 用法：node .agents/scripts/gen-workflow-index.mjs [--dry-run] [--check] [--help]
-//   --dry-run  只打印差异预览，不写盘
-//   --check    不写盘；与磁盘不一致时 exit 1 并打印差异（供 check-loop 漂移告警）
-// 测试：node .agents/scripts/gen-workflow-index.test.mjs（fixture 回归，须全绿）
-// 口径：扫磁盘（对照 gen-wiki-board.mjs 与看板）；排除 _TEMPLATE.md。活跃 = draft / approved / open
-//   逐行列出（在跑的工作）；其余状态折叠进「档案计数」——fixed 未 closed 的 incident 与 approved
-//   孤儿 plan 属「待收口」，看板会告警；查档案用 kb-search（默认含全部状态）。
-// 生成区：INDEX.md 的 GENERATED:BEGIN/END 锚点注释之间整段重写，锚点外内容原样保留。
-import fs from 'node:fs';
-import path from 'node:path';
-import { ENUMS } from './workflow-enums.mjs';
-
-const USAGE = `用法：node .agents/scripts/gen-workflow-index.mjs [--dry-run] [--check] [--help]
-
-事实源：workflow/{intents,specs,plans,incidents}/*.md 的 frontmatter（状态/级别/日期/发现/模块）
-        + H1 标题 + 「## 验收标准」勾验统计；排除 _TEMPLATE.md。
-生成物：workflow/INDEX.md —— 活跃层逐行（类型|级别|状态|日期|模块|标题|验收）+ 档案计数（类型×模块）。
-选项：
-  --dry-run   只打印将生成内容的摘要与差异，不写盘
-  --check     不写盘；INDEX 与磁盘不一致时 exit 1（供 check-loop 漂移告警）
-  --help      打印本说明`;
-
-const args = process.argv.slice(2);
-if (args.includes('--help') || args.includes('-h')) { console.log(USAGE); process.exit(0); }
-const unknown = args.filter((a) => !['--dry-run', '--check'].includes(a));
-if (unknown.length) { console.error(`❌ 未知参数：${unknown.join(' ')}\n\n${USAGE}`); process.exit(1); }
-const DRY = args.includes('--dry-run');
-const CHECK = args.includes('--check');
-
-const WORKFLOW = 'workflow';
-const INDEX_P = path.join(WORKFLOW, 'INDEX.md');
-const DOC_TYPES = ['intents', 'specs', 'plans', 'incidents'];
-const TYPE_LABEL = { intents: 'INTENT', specs: 'SPEC', plans: 'PLAN', incidents: 'INCIDENT' };
-// 活跃口径 = 单源 doc.status.active ∪ incident.status.active；其余状态折叠进档案计数
-const ACTIVE_STATUS = [...ENUMS['doc.status.active'], ...ENUMS['incident.status.active']];
-
-const BEGIN = '<!-- GENERATED:BEGIN — gen-workflow-index.mjs 整段重写，手工说明写在本行之前 -->';
-const END = '<!-- GENERATED:END -->';
-const HEADER = `# workflow 索引 — 活跃层与档案（生成物，勿手改）
-
-> 生成器 \`node .agents/scripts/gen-workflow-index.mjs\`（状态变更 / 新建文档后重跑；\`--check\` 校验漂移，check-loop 会告警）。
-> 活跃 = ${ACTIVE_STATUS.join(' / ')}（在跑）；其余状态折叠进档案计数，检索用 \`node .agents/scripts/kb-search.mjs "<词>"\`（默认含全部状态、活跃优先排序）。
-> 模块词表见 \`.agents/workflow-modules.txt\`。
-`;
-
-// ---- frontmatter（受限子集：每行 `键: 值`）+ H1 标题（去「INTENT — 」前缀），对照 workflow/README.md 文档协议 ----
-function parseDoc(text) {
-  const meta = {};
-  const m = text.match(/^---\r?\n([\s\S]*?)\r?\n---/);
-  if (m) {
-    for (const line of m[1].split(/\r?\n/)) {
-      const kv = line.match(/^(\S+):\s*(.*)$/);
-      if (kv) meta[kv[1].trim()] = kv[2].trim();
-    }
-  }
-  const h1 = text.match(/^# (.+)$/m);
-  let title = h1 ? h1[1] : '';
-  // 前缀分隔只认 em/en dash（任意间距）或带空格的 ASCII 连字符——裸连字符是 kebab-case 的一部分，不截断（2026-09-24）
-  const dash = title.match(/\S+\s*(?:[—–]+|\s-\s)\s*(.+)$/);
-  if (dash) title = dash[1];
-  return { meta, title };
-}
-
-// ---- 验收勾验统计：仅「## 验收标准」节内（至下一个 ## 标题），无该节返回 null（对照看板口径）----
-function parseAcceptance(text) {
-  const h = text.match(/^## 验收标准.*$/m);
-  if (!h) return null;
-  const rest = text.slice(h.index + h[0].length);
-  const next = rest.match(/^## /m);
-  const section = next ? rest.slice(0, next.index) : rest;
-  const total = (section.match(/^\s*[-*] \[[ xX]\]/gm) || []).length;
-  if (!total) return null;
-  const done = (section.match(/^\s*[-*] \[[xX]\]/gm) || []).length;
-  return { done, total };
-}
-
-const esc = (s) => String(s).replace(/\|/g, '\\|'); // 表格单元格内管道转义
-
-function scan() {
-  const docs = [];
-  for (const type of DOC_TYPES) {
-    const dir = path.join(WORKFLOW, type);
-    for (const f of fs.readdirSync(dir)) {
-      if (!f.endsWith('.md') || f === '_TEMPLATE.md') continue;
-      const name = f.slice(0, -3);
-      const text = fs.readFileSync(path.join(dir, f), 'utf8');
-      const { meta, title } = parseDoc(text);
-      docs.push({
-        type,
-        file: `${type}/${f}`,
-        status: meta['状态'] || '（未填）',
-        level: meta['级别'] || '—',
-        date: meta['日期'] || meta['发现'] || name.slice(0, 10),
-        module: meta['模块'] || '—',
-        title: title || name,
-        accept: parseAcceptance(text),
-      });
-    }
-  }
-  return docs;
-}
-
-function render(docs) {
-  const active = docs.filter((d) => ACTIVE_STATUS.includes(d.status));
-  active.sort((a, b) => b.date.localeCompare(a.date) || a.type.localeCompare(b.type) || a.file.localeCompare(b.file));
-  const arch = docs.filter((d) => !ACTIVE_STATUS.includes(d.status));
-
-  const rows = active.map((d) =>
-    `| ${TYPE_LABEL[d.type]} | ${esc(d.level)} | ${esc(d.status)} | ${esc(d.date)} | ${esc(d.module)} | ${esc(d.title)} | ${d.accept ? `☑${d.accept.done}/${d.accept.total}` : '—'} |`);
-
-  const counts = new Map(); // `${type}|${module}` → 数量
-  for (const d of arch) {
-    const k = `${d.type}|${d.module}`;
-    counts.set(k, (counts.get(k) || 0) + 1);
-  }
-  const archRows = [...counts.entries()].sort((a, b) => a[0].localeCompare(b[0])).map(([k, n]) => {
-    const [type, module] = k.split('|');
-    return `| ${TYPE_LABEL[type]} | ${esc(module)} | ${n} |`;
-  });
-  const byStatus = new Map();
-  for (const d of arch) byStatus.set(d.status, (byStatus.get(d.status) || 0) + 1);
-  const statusLine = [...byStatus.entries()].sort((a, b) => b[1] - a[1]).map(([s, n]) => `${s} ${n}`).join(' · ');
-
-  return [
-    `## 活跃（${active.length}）`,
-    '',
-    '| 类型 | 级别 | 状态 | 日期 | 模块 | 标题 | 验收 |',
-    '|---|---|---|---|---|---|---|',
-    ...rows,
-    '',
-    `## 档案计数（${arch.length}，不进表）`,
-    '',
-    '| 类型 | 模块 | 数量 |',
-    '|---|---|---|',
-    ...archRows,
-    '',
-    `终态构成：${statusLine}；查档案用 \`node .agents/scripts/kb-search.mjs "<词>" --status all\`。`,
-  ].join('\n');
-}
-
-// ---- 组装：锚点内整段重写，锚点外（含首次创建时的 HEADER）原样保留 ----
-const docs = scan();
-const existing = fs.existsSync(INDEX_P) ? fs.readFileSync(INDEX_P, 'utf8') : '';
-const inner = `${BEGIN}\n\n${render(docs)}\n\n${END}`;
-let out;
-if (existing.includes(BEGIN) && existing.includes(END) && existing.indexOf(BEGIN) < existing.indexOf(END)) {
-  out = existing.slice(0, existing.indexOf(BEGIN)) + inner + existing.slice(existing.indexOf(END) + END.length);
-} else if (existing.includes(BEGIN) || existing.includes(END)) {
-  // 锚点残缺（END 被手工截断 / 顺序颠倒）：fail-loud 不写盘——曾走 append 分支产生双 GENERATED 区，旧区永不清理（2026-09-24）
-  console.error('❌ workflow/INDEX.md 生成锚点不完整（GENERATED:BEGIN/END 须成对且 BEGIN 在前）——手工修复锚点后重跑，未写盘');
-  process.exit(1);
-} else {
-  out = (existing ? existing.replace(/\s*$/, '') + '\n\n' : HEADER) + inner + '\n';
-}
-
-const nActive = docs.filter((d) => ACTIVE_STATUS.includes(d.status)).length;
-const nArch = docs.length - nActive;
-const summary = `活跃 ${nActive} 行 / 档案 ${nArch} 篇 / ${Buffer.byteLength(out, 'utf8')} B`;
-
-// 差异预览：首尾对齐后取中段变更块（逐行），各方向最多 10 行
-function previewDiff(before, after) {
-  if (before === after) return;
-  const b = before.split(/\r?\n/);
-  const a = after.split(/\r?\n/);
-  let head = 0;
-  while (head < b.length && head < a.length && b[head] === a[head]) head++;
-  let tailN = 0;
-  while (tailN < b.length - head && tailN < a.length - head && b[b.length - 1 - tailN] === a[a.length - 1 - tailN]) tailN++;
-  const removed = b.slice(head, b.length - tailN);
-  const added = a.slice(head, a.length - tailN);
-  console.log(`  第 ${head + 1} 行起变更：删 ${removed.length} 行 / 增 ${added.length} 行`);
-  for (const l of removed.slice(0, 10)) console.log(`    - ${l.slice(0, 140)}`);
-  if (removed.length > 10) console.log(`    - …（其余 ${removed.length - 10} 行略）`);
-  for (const l of added.slice(0, 10)) console.log(`    + ${l.slice(0, 140)}`);
-  if (added.length > 10) console.log(`    + …（其余 ${added.length - 10} 行略）`);
-}
-
-// 行尾归一比较（2026-09-30：fresh clone 检出 CRLF、生成段恒 LF——直接字符串相等会在克隆环境假阳性
-// 「漂移」（doctor §6 与 check-loop 检查 11 均经 --check 判定）；仅内容差异才算漂移）
-const normEol = (s) => String(s).replace(/\r\n/g, '\n');
-
-if (CHECK) {
-  if (normEol(out) === normEol(existing)) {
-    console.log(`✅ workflow/INDEX.md 与磁盘一致（${summary}）`);
-    process.exit(0);
-  }
-  console.error(`❌ workflow/INDEX.md 与磁盘不一致（${summary}）——跑 node .agents/scripts/gen-workflow-index.mjs 重新生成`);
-  previewDiff(existing, out);
-  process.exit(1);
-}
-
-if (DRY) {
-  console.log(`🔎 --dry-run：未写盘（${summary}）`);
-  if (normEol(out) === normEol(existing)) console.log('• workflow/INDEX.md：无变化');
-  else previewDiff(existing, out);
-} else {
-  fs.writeFileSync(INDEX_P, out, 'utf8');
-  console.log(`✅ 已生成 workflow/INDEX.md：${summary}`);
-}

package/templates/_agents/scripts/gen-workflow-index.test.mjs

@@ -1,152 +0,0 @@
-#!/usr/bin/env node
-// gen-workflow-index.mjs 的 fixture 驱动测试
-// 现场构造临时 workflow 根，以「换 cwd」方式运行被测脚本（脚本按相对路径 'workflow/' 读盘）。
-// 断言：①活跃（draft/approved/open）逐行出表、终态折叠进档案计数（含 fixed incident）、验收勾验统计；
-//       ②--check 一致 exit 0 / 漂移 exit 1（失败路径）；③缺 `模块:` 容忍显示 —。
-// 用法：node .agents/scripts/gen-workflow-index.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-index.mjs');
-const USAGE = '用法：node .agents/scripts/gen-workflow-index.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, body = '') => `---\n${fm}\n---\n# ${title}\n\n${body}\n`;
-
-// mkfix：建临时 workflow 根（4 个子目录齐备——生成器按目录枚举，缺目录会 throw）
-const mkfix = () => {
-  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'gen-workflow-index-test-'));
-  for (const d of ['intents', 'specs', 'plans', 'incidents']) fs.mkdirSync(path.join(root, 'workflow', d), { recursive: true });
-  const w = path.join(root, 'workflow');
-  fs.writeFileSync(path.join(w, 'intents', '2026-09-21-alpha.md'), doc(
-    '状态: approved\n级别: L1\n日期: 2026-09-21\n模块: pipeline',
-    'INTENT — 在跑的需求甲',
-    '## 验收标准（可测试）\n- [x] 已验项（证据：实跑）\n- [ ] 未验项\n',
-  ), 'utf8');
-  fs.writeFileSync(path.join(w, 'plans', '2026-09-21-alpha.md'), doc(
-    '状态: approved\n级别: L1\n模块: pipeline',
-    'PLAN — 在跑的需求甲',
-  ), 'utf8');
-  fs.writeFileSync(path.join(w, 'plans', '2026-09-19-beta.md'), doc(
-    '状态: done\n级别: L1\n模块: material',
-    'PLAN — 已完结的需求乙',
-  ), 'utf8');
-  fs.writeFileSync(path.join(w, 'incidents', '2026-09-18-gamma.md'), doc(
-    '状态: fixed\n级别: L2\n发现: 2026-09-18\n模块: material',
-    'INCIDENT — 已修复未收口的事故丙',
-  ), 'utf8');
-  fs.writeFileSync(path.join(w, 'intents', '_TEMPLATE.md'), doc('状态: draft\n级别: L1', 'INTENT — 模板不该进表'), 'utf8');
-  return root;
-};
-
-const run = (root, args = []) => spawnSync(process.execPath, [GEN, ...args], { cwd: root, encoding: 'utf8' });
-
-// ---- 场景 1：主路径——活跃逐行 + 终态折叠 + 验收统计 ----
-{
-  const root = mkfix();
-  const r = run(root);
-  const idx = fs.readFileSync(path.join(root, 'workflow', 'INDEX.md'), 'utf8');
-  check('场景 1：生成器 exit 0', r.status === 0, `exit=${r.status}\n${r.stdout}${r.stderr}`);
-  check('场景 1：活跃 2 行（approved intent + approved plan）', idx.includes('## 活跃（2）'), idx.split('\n').slice(0, 14).join('\n'));
-  check('场景 1：活跃行含 7 字段（类型/级别/状态/日期/模块/标题/验收）',
-    /\| INTENT \| L1 \| approved \| 2026-09-21 \| pipeline \| 在跑的需求甲 \| ☑1\/2 \|/.test(idx),
-    idx.split('\n').filter((l) => l.startsWith('| INTENT')).join('\n'));
-  check('场景 1：终态折叠为档案 2 篇（done plan + fixed incident）', idx.includes('## 档案计数（2，不进表）'), '');
-  check('场景 1：档案按类型×模块计数', idx.includes('| PLAN | material | 1 |') && idx.includes('| INCIDENT | material | 1 |'), '');
-  check('场景 1：终态构成行含 done 1 · fixed 1', /终态构成：.*done 1.*fixed 1/.test(idx), idx.split('\n').slice(-2).join('\n'));
-  check('场景 1：_TEMPLATE.md 不进表', !idx.includes('模板不该进表'), '');
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- 场景 2：--check 一致 exit 0 / 漂移 exit 1 / 重生成后复原（失败路径）----
-{
-  const root = mkfix();
-  run(root);
-  const ok = run(root, ['--check']);
-  check('场景 2：生成后 --check exit 0', ok.status === 0, `exit=${ok.status}\n${ok.stdout}${ok.stderr}`);
-  const p = path.join(root, 'workflow', 'intents', '2026-09-21-alpha.md');
-  fs.writeFileSync(p, fs.readFileSync(p, 'utf8').replace('状态: approved', '状态: done'), 'utf8');
-  const drift = run(root, ['--check']);
-  check('场景 2：文档状态变更后 --check exit 1（漂移）', drift.status === 1, `exit=${drift.status}\n${drift.stdout}${drift.stderr}`);
-  check('场景 2：漂移提示含重生成命令', /gen-workflow-index\.mjs 重新生成/.test(drift.stderr), drift.stderr);
-  run(root);
-  const ok2 = run(root, ['--check']);
-  check('场景 2：重生成后 --check 复原 exit 0', ok2.status === 0, `exit=${ok2.status}\n${ok2.stdout}${ok2.stderr}`);
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- 场景 2b：CRLF 检出形态（fresh clone）--check 不误报（2026-09-30 行尾归一）----
-{
-  const root = mkfix();
-  run(root);
-  const ip = path.join(root, 'workflow', 'INDEX.md');
-  fs.writeFileSync(ip, fs.readFileSync(ip, 'utf8').replace(/\r\n/g, '\n').replace(/\n/g, '\r\n'), 'utf8');
-  const crlf = run(root, ['--check']);
-  check('场景 2b：INDEX 为 CRLF 检出形态 → --check exit 0（行尾归一，不假阳性）',
-    crlf.status === 0, `exit=${crlf.status}\n${crlf.stdout}${crlf.stderr}`);
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- 场景 3：缺 `模块:` 容忍显示 —（不报错、不阻断）----
-{
-  const root = mkfix();
-  const p = path.join(root, 'workflow', 'plans', '2026-09-21-alpha.md');
-  fs.writeFileSync(p, fs.readFileSync(p, 'utf8').replace('模块: pipeline\n', ''), 'utf8');
-  const r = run(root);
-  const idx = fs.readFileSync(path.join(root, 'workflow', 'INDEX.md'), 'utf8');
-  check('场景 3：缺模块字段仍 exit 0', r.status === 0, `exit=${r.status}\n${r.stdout}${r.stderr}`);
-  check('场景 3：模块列显示 —', /^\| PLAN \| L1 \| approved \| .* \| — \|/m.test(idx), idx.split('\n').filter((l) => l.startsWith('| PLAN | approved')).join('\n'));
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- 场景 4：非法参数 exit 1 ----
-{
-  const root = mkfix();
-  const r = run(root, ['--nope']);
-  check('场景 4：未知参数 exit 1', r.status === 1 && /未知参数/.test(r.stderr), `exit=${r.status}\n${r.stderr}`);
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- 场景 5：kebab-case H1 不被连字符截断（2026-09-24 前缀正则收窄回归）----
-{
-  const root = mkfix();
-  fs.writeFileSync(path.join(root, 'workflow', 'intents', '2026-09-22-kebab.md'), doc(
-    '状态: draft\n级别: L1\n日期: 2026-09-22\n模块: pipeline',
-    'workflow-doc-retrieval',
-  ), 'utf8');
-  run(root);
-  const idx = fs.readFileSync(path.join(root, 'workflow', 'INDEX.md'), 'utf8');
-  check('场景 5：kebab-case H1 完整保留（未被截成末段）', idx.includes('| workflow-doc-retrieval |') && !idx.includes('| retrieval |'), idx.split('\n').filter((l) => l.includes('retrieval')).join('\n'));
-  check('场景 5：em-dash 前缀仍正常剥离', idx.includes('| 在跑的需求甲 |'), '');
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- 场景 6：END 锚点被截断 → fail-loud 不写盘（2026-09-24：原 append 分支产生双生成区）----
-{
-  const root = mkfix();
-  run(root);
-  const p = path.join(root, 'workflow', 'INDEX.md');
-  fs.writeFileSync(p, fs.readFileSync(p, 'utf8').replace('<!-- GENERATED:END -->', ''), 'utf8');
-  const r = run(root);
-  check('场景 6：END 锚点缺失 → exit 1', r.status === 1, `exit=${r.status}\n${r.stdout}${r.stderr}`);
-  check('场景 6：报错点名锚点不完整', (r.stderr || '').includes('锚点不完整'), r.stderr);
-  check('场景 6：未写盘（无双重生成区）', (fs.readFileSync(p, 'utf8').match(/GENERATED:BEGIN/g) || []).length === 1, '');
-  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);