agentic-flow-kit 1.7.0 → 1.7.15

package/templates/_agents/scripts/draft-sediment.test.mjs

@@ -0,0 +1,272 @@
+#!/usr/bin/env node
+// draft-sediment.mjs 测试（B2，2026-10-10）——纯函数直测 + fixture 子进程跑真 CLI
+// 纯函数（extractSections/topicOf/renderDraft/setSedimentField）import 直测；CLI 场景
+// 以「换 cwd」方式在临时仓跑真脚本（脚本按相对路径 workflow/ + wiki/ 读写，无需注入口）。
+// 覆盖：抽节/主题取法/草稿渲染/沉淀字段回写的纯逻辑 + dry-run 不写盘 / 实跑落草稿并回写
+//   并重跑 gen-wiki-board / 状态守卫拦非 done|closed / 无高价值节拒抽 / 路径越界拒收
+// 用法：node .agents/scripts/draft-sediment.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';
+import { extractSections, topicOf, renderDraft, setSedimentField } from './draft-sediment.mjs';
+
+const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
+const SED = path.join(SCRIPT_DIR, 'draft-sediment.mjs');
+const TODAY = new Date().toISOString().slice(0, 10); // 与脚本内取法一致（草稿目录日期段）
+const USAGE = '用法：node .agents/scripts/draft-sediment.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}` : ''}`); }
+};
+
+// ---- 纯函数：extractSections ----
+{
+  const text = [
+    '# INTENT — 权限收敛',
+    '',
+    '## 影响面',
+    '',
+    '- 模块：pipeline',
+    '- 数据库：无',
+    '',
+    '## 触达红线与边界',
+    '',
+    '> 这是引用块，应被剔除',
+    '<!-- 注释也应剔除 -->',
+    '<占位单行也应剔除>',
+    '- [x] 规则变更（证据：abc123）',
+    '',
+    '## 目标（不在抽取词表内）',
+    '',
+    '- 不应被抽出来',
+    '',
+    '## 影响面（空节）',
+    '',
+    '<待补>',
+    '',
+  ].join('\n');
+  const got = extractSections(text, ['影响面', '触达红线']);
+  const titles = got.map((s) => s.title);
+  check('1a 抽取指定节（影响面）', titles.includes('影响面'), JSON.stringify(titles));
+  check('1b 节标题前缀匹配（「触达红线与边界」命中「触达红线」）', titles.includes('触达红线与边界'), JSON.stringify(titles));
+  check('1c 词表外节不抽（目标节缺席）', !titles.some((t) => t.startsWith('目标')), JSON.stringify(titles));
+  const yx = got.find((s) => s.title === '影响面');
+  check('1d 正文保留（模块行入库）', yx && yx.body.includes('- 模块：pipeline'), yx && yx.body);
+  const hx = got.find((s) => s.title === '触达红线与边界');
+  check('1e 占位行剔除（引用块/注释/单行尖括号均不进 body）',
+    hx && !hx.body.includes('引用块') && !hx.body.includes('注释也应') && !hx.body.includes('占位单行')
+    && hx.body.includes('规则变更（证据：abc123）'), hx && hx.body);
+  check('1f 仅占位的空节被丢弃（「影响面（空节）」不入结果）',
+    !titles.includes('影响面（空节）'), JSON.stringify(titles));
+}
+
+// ---- 纯函数：topicOf（标题行优先于文件名）----
+{
+  check('2a 标题行优先（# INTENT — 权限收敛 胜过文件名尾段 perm）',
+    topicOf('workflow/intents/2026-10-10-perm.md', '# INTENT — 权限收敛\n') === '权限收敛', '');
+  check('2b 无标题行退文件名尾段（去日期前缀）',
+    topicOf('workflow/intents/2026-10-10-perm.md', '# 无标题文档\n') === 'perm', '');
+  check('2c 无标题无日期退文件基名',
+    topicOf('wiki/随便/a.md', '# 无标题文档\n') === 'a', '');
+  check('2d INCIDENT 标题行同样识别',
+    topicOf('workflow/incidents/2026-09-12-x.md', '# INCIDENT — 越权写操作\n') === '越权写操作', '');
+}
+
+// ---- 纯函数：renderDraft ----
+{
+  const out = renderDraft({ topic: '权限收敛', date: '2026-10-10', source: 'workflow/intents/2026-10-10-perm.md',
+    sections: [{ title: '影响面', body: '- 模块：pipeline' }], kind: 'intent' });
+  check('3a frontmatter 含来源与草稿状态', out.startsWith('---\n') && out.includes('来源: workflow/intents/2026-10-10-perm.md')
+    && out.includes('状态: 草稿（待人工归类）'), out.split('\n').slice(0, 5).join('\n'));
+  check('3b intent 渲染为「需求沉淀草稿」', out.includes('# 权限收敛（需求沉淀草稿）'), out.split('\n')[4]);
+  check('3c incident 渲染为「事故复盘草稿」',
+    renderDraft({ topic: 't', date: '2026-10-10', source: 's', sections: [], kind: 'incident' })
+      .includes('# t（事故复盘草稿）'), '');
+  check('3d 抽取节原样落到正文 ## 节下', out.includes('## 影响面\n\n- 模块：pipeline'), out);
+  check('3e 草稿头含中间态提示（引导人工归类）', out.includes('中间态'), out);
+}
+
+// ---- 纯函数：setSedimentField ----
+{
+  const fm = (body) => `---\n${body}\n---\n# INTENT — t\n`;
+  const a = setSedimentField(fm('状态: done\n级别: L1'), 'wiki/drafts-archive/2026-10-10-t/t.md');
+  check('4a 无沉淀字段 → 追加且 changed=true',
+    a.changed && a.text.includes('沉淀: wiki/drafts-archive/2026-10-10-t/t.md')
+    && a.text.includes('# INTENT — t\n'), a.text);
+  const b = setSedimentField(fm('状态: done\n沉淀: 无'), 'wiki/drafts-archive/2026-10-10-t/t.md');
+  check('4b 「沉淀: 无」显式豁免位 → 覆盖（豁免是占位，可写）',
+    b.changed && b.text.includes('沉淀: wiki/drafts-archive/2026-10-10-t/t.md'), b.text);
+  const c = setSedimentField(fm('状态: done\n沉淀: wiki/规范/x.md'), 'wiki/drafts-archive/2026-10-10-t/t.md');
+  check('4c 已有人工登记 → 不覆盖 changed=false（防误抹）',
+    !c.changed && c.text.includes('沉淀: wiki/规范/x.md'), c.text);
+  const d = setSedimentField('# 无 frontmatter 的文档\n', 'wiki/drafts-archive/x.md');
+  check('4d 无 frontmatter → 不动 changed=false', !d.changed, d.text);
+  const e = setSedimentField(fm('状态: done\n沉淀:  '), 'wiki/drafts-archive/y.md');
+  check('4e 空值沉淀位 → 覆盖（空同未填）',
+    e.changed && e.text.includes('沉淀: wiki/drafts-archive/y.md'), e.text);
+}
+
+// ---- fixture：临时仓（wiki 根带 INDEX/看板锚点，供 gen-wiki-board 重跑；workflow 两目录）----
+const mkfx = () => {
+  const fx = fs.mkdtempSync(path.join(os.tmpdir(), 'draft-sed-test-'));
+  fs.mkdirSync(path.join(fx, 'wiki', '主题A'), { recursive: true });
+  fs.mkdirSync(path.join(fx, 'wiki', 'drafts-archive'), { recursive: true });
+  fs.writeFileSync(path.join(fx, 'wiki', '主题A', 'a.md'), '# a\n', 'utf8');
+  fs.writeFileSync(path.join(fx, 'wiki', 'INDEX.md'), [
+    '# wiki 索引（fixture）', '',
+    '| 主题 | 文件数 | 用途 |', '|---|---|---|',
+    '| 主题A | 1 | fixture 主题 |',
+    '| drafts-archive | — | 原文档备份（按 日期-主题 分目录）', '',
+    '合计：**1 份**知识文档，**1 个主题**', '',
+    '---', '', '## 文件 → 主题 → 归属目录 映射表', '',
+    '### 主题A（1）', '',
+    '| 文件名 | 主题 | 归属目录 |', '|---|---|---|',
+    '| a.md | 主题A | wiki/主题A/ |', '', '---', '',
+    '## 命名规则', '', '- fixture', '',
+  ].join('\n'), 'utf8');
+  fs.writeFileSync(path.join(fx, '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');
+  fs.mkdirSync(path.join(fx, 'workflow', 'intents'), { recursive: true });
+  fs.mkdirSync(path.join(fx, 'workflow', 'incidents'), { recursive: true });
+  return fx;
+};
+
+// 高价值正文（intent：影响面 + 触达红线均有实质内容）
+const INTENT_DONE = [
+  '---', '状态: done', '级别: L1', '日期: 2026-10-10', '模块: pipeline', '---',
+  '# INTENT — 权限收敛', '',
+  '## 影响面', '', '- 模块：pipeline', '- 数据库：无', '',
+  '## 触达红线', '', '- [x] 规则 / 契约变更（证据：abc123）', '',
+  '## 验收标准（可测试）', '', '- [x] 全绿（证据：npm test）', '',
+].join('\n');
+
+// 高价值正文（incident：复盘三件套齐全）
+const INC_CLOSED = [
+  '---', '状态: closed', '级别: L1', '日期: 2026-09-12', '---',
+  '# INCIDENT — 越权写操作', '',
+  '## 影响面', '', '- 只读接口被放行写操作。', '',
+  '## 根因', '', '- 鉴权中间件早于路由注册生效。', '',
+  '## 为什么之前没拦住', '', '- 测试只覆盖了 happy path。', '',
+  '## 复盘三件套', '', '- 修复：注册顺序对调（SHA abc123）。', '- 防复发：加契约测试。', '- 台账：已登记。', '',
+].join('\n');
+
+const runSed = (fx, targetArgs) => spawnSync(process.execPath, [SED, ...targetArgs], {
+  cwd: fx, encoding: 'utf8',
+});
+
+// ---- CLI 5：--dry-run 不写盘 ----
+{
+  const fx = mkfx();
+  fs.writeFileSync(path.join(fx, 'workflow', 'intents', '2026-10-10-perm.md'), INTENT_DONE, 'utf8');
+  const r = runSed(fx, ['workflow/intents/2026-10-10-perm.md', '--dry-run']);
+  const out = (r.stdout || '') + (r.stderr || '');
+  check('5a --dry-run exit 0 且明示未写盘', r.status === 0 && out.includes('未写盘'), `exit=${r.status}\n${out.slice(0, 400)}`);
+  check('5b 未落草稿（drafts-archive 仍空）',
+    fs.readdirSync(path.join(fx, 'wiki', 'drafts-archive')).length === 0, '');
+  check('5c 源文件未回写（无沉淀字段）',
+    !fs.readFileSync(path.join(fx, 'workflow', 'intents', '2026-10-10-perm.md'), 'utf8').includes('沉淀:'), '');
+  check('5d 预览含来源与抽取节标题', out.includes('来源: workflow/intents/2026-10-10-perm.md')
+    && out.includes('## 影响面') && out.includes('## 触达红线'), out);
+  check('5e 主题取标题行（权限收敛）而非文件名尾段（perm）',
+    out.includes('wiki/drafts-archive/' + TODAY + '-权限收敛'), out);
+  fs.rmSync(fx, { recursive: true, force: true });
+}
+
+// ---- CLI 6：实跑 intent —— 落草稿 + 回写沉淀 + 重跑 gen-wiki-board ----
+{
+  const fx = mkfx();
+  fs.writeFileSync(path.join(fx, 'workflow', 'intents', '2026-10-10-perm.md'), INTENT_DONE, 'utf8');
+  const r = runSed(fx, ['workflow/intents/2026-10-10-perm.md']);
+  const out = (r.stdout || '') + (r.stderr || '');
+  const draftP = path.join(fx, 'wiki', 'drafts-archive', `${TODAY}-权限收敛`, '权限收敛.md');
+  check('6a 实跑 exit 0', r.status === 0, `exit=${r.status}\n${out.slice(0, 500)}`);
+  check('6b 草稿落到 drafts-archive/<日期-主题>/<主题>.md',
+    fs.existsSync(draftP), `期望存在：${draftP}`);
+  const draft = fs.existsSync(draftP) ? fs.readFileSync(draftP, 'utf8') : '';
+  check('6c 草稿带来源 frontmatter 指回源文件',
+    draft.startsWith('---\n') && draft.includes('来源: workflow/intents/2026-10-10-perm.md')
+    && draft.includes('（需求沉淀草稿）'), draft.split('\n').slice(0, 6).join('\n'));
+  const src = fs.readFileSync(path.join(fx, 'workflow', 'intents', '2026-10-10-perm.md'), 'utf8');
+  check('6d 源文件回写沉淀字段（B1 闭环——断链 WARN 由此消除）',
+    src.includes(`沉淀: wiki/drafts-archive/${TODAY}-权限收敛/权限收敛.md`), src.split('\n').slice(0, 7).join('\n'));
+  const board = fs.readFileSync(path.join(fx, 'wiki', '知识沉淀总览.html'), 'utf8');
+  check('6e gen-wiki-board 已重跑（看板归档计数 0→1）',
+    /"archive": 1/.test(board) && out.includes('gen-wiki-board'), board.split('\n').slice(0, 6).join('\n'));
+  check('6f 沉淀回写幂等：再跑一次不覆盖已有登记（changed=false 分支）',
+    runSed(fx, ['workflow/intents/2026-10-10-perm.md']).status === 0
+    && src.includes(`沉淀: wiki/drafts-archive/${TODAY}-权限收敛/权限收敛.md`), '');
+  fs.rmSync(fx, { recursive: true, force: true });
+}
+
+// ---- CLI 7：实跑 incident —— 事故口径四节 ----
+{
+  const fx = mkfx();
+  fs.writeFileSync(path.join(fx, 'workflow', 'incidents', '2026-09-12-x.md'), INC_CLOSED, 'utf8');
+  const r = runSed(fx, ['workflow/incidents/2026-09-12-x.md']);
+  const draftP = path.join(fx, 'wiki', 'drafts-archive', `${TODAY}-越权写操作`, '越权写操作.md');
+  const draft = fs.existsSync(draftP) ? fs.readFileSync(draftP, 'utf8') : '';
+  check('7a incident 实跑 exit 0 且草稿落盘', r.status === 0 && fs.existsSync(draftP),
+    `exit=${r.status}\n${(r.stdout || '') + (r.stderr || '')}`.slice(0, 400));
+  check('7b 草稿为事故复盘口径（标题 + 四节齐备）',
+    draft.includes('（事故复盘草稿）') && ['影响面', '根因', '为什么之前没拦住', '复盘三件套']
+      .every((h) => draft.includes('## ' + h)), draft.slice(0, 300));
+  check('7c 源文件回写沉淀字段',
+    fs.readFileSync(path.join(fx, 'workflow', 'incidents', '2026-09-12-x.md'), 'utf8')
+      .includes(`沉淀: wiki/drafts-archive/${TODAY}-越权写操作/越权写操作.md`), '');
+  fs.rmSync(fx, { recursive: true, force: true });
+}
+
+// ---- CLI 8：守卫（状态 / 无高价值节 / 路径越界）----
+{
+  const fx = mkfx();
+  // 8a 非 done intent
+  fs.writeFileSync(path.join(fx, 'workflow', 'intents', 'a-draft.md'),
+    INTENT_DONE.replace('状态: done', '状态: draft'), 'utf8');
+  const r8a = runSed(fx, ['workflow/intents/a-draft.md']);
+  check('8a 非 done intent → exit 1 且明示状态要求',
+    r8a.status === 1 && (r8a.stderr || '').includes('须为 done'), `exit=${r8a.status}\n${r8a.stderr}`);
+  // 8b 非 closed incident
+  fs.writeFileSync(path.join(fx, 'workflow', 'incidents', 'b-open.md'),
+    INC_CLOSED.replace('状态: closed', '状态: open'), 'utf8');
+  const r8b = runSed(fx, ['workflow/incidents/b-open.md']);
+  check('8b 非 closed incident → exit 1 且明示状态要求',
+    r8b.status === 1 && (r8b.stderr || '').includes('须为 closed'), `exit=${r8b.status}\n${r8b.stderr}`);
+  // 8c 高价值节全为占位 → 拒抽
+  fs.writeFileSync(path.join(fx, 'workflow', 'intents', 'c-empty.md'), [
+    '---', '状态: done', '---', '# INTENT — 空单', '',
+    '## 影响面', '', '<待补>', '', '## 触达红线', '', '<待补>', '',
+  ].join('\n'), 'utf8');
+  const r8c = runSed(fx, ['workflow/intents/c-empty.md']);
+  check('8c 高价值节仅占位 → exit 1 且明示无沉淀价值',
+    r8c.status === 1 && (r8c.stderr || '').includes('未抽取到高价值节'), `exit=${r8c.status}\n${r8c.stderr}`);
+  check('8c 占位拒抽不落草稿', !fs.existsSync(path.join(fx, 'wiki', 'drafts-archive', `${TODAY}-空单`)), '');
+  // 8d 路径在 workflow/ 外
+  fs.writeFileSync(path.join(fx, 'outside.md'), INTENT_DONE, 'utf8');
+  const r8d = runSed(fx, ['outside.md']);
+  check('8d 源文件不在 workflow/intents|incidents 下 → exit 1',
+    r8d.status === 1 && (r8d.stderr || '').includes('workflow/intents'), `exit=${r8d.status}\n${r8d.stderr}`);
+  // 8e 不存在的文件
+  const r8e = runSed(fx, ['workflow/intents/不存在.md']);
+  check('8e 源文件不存在 → exit 1', r8e.status === 1, `exit=${r8e.status}\n${r8e.stderr}`);
+  // 8f 无参数
+  const r8f = runSed(fx, []);
+  check('8f 无源文件参数 → exit 1 且打印用法', r8f.status === 1, `exit=${r8f.status}`);
+  fs.rmSync(fx, { 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/gate-checklist.mjs

@@ -19,6 +19,7 @@
 // 测试：node templates/_agents/scripts/gate-checklist.test.mjs（fixture + 真实仓库 baseline）
 import fs from 'node:fs';
 import path from 'node:path';
+import { fileURLToPath } from 'node:url';
 
 function fail(msg) { console.error('❌ ' + msg); process.exit(1); }
 
@@ -175,10 +176,17 @@ if (isMain) {
   const pkgRoot = process.argv[2] && !process.argv[2].startsWith('--') ? process.argv[2] : null;
   const base = pkgRoot || process.cwd();
   const doctorPath = path.join(base, 'src', 'doctor.mjs');
+  // check-loop 解析序：装副本 .agents/（装户径）→ 包源脚本同级（纯包源径，装户端内容清理后形态）
+  const here = path.dirname(fileURLToPath(import.meta.url));
   const clPathMjs = path.join(base, '.agents', 'scripts', 'check-loop.mjs');
-  const clPath = fs.existsSync(clPathMjs) ? clPathMjs : path.join(base, '.agents', 'scripts', 'check-loop.sh');
+  const clCandidates = [
+    clPathMjs,
+    path.join(base, '.agents', 'scripts', 'check-loop.sh'),
+    path.join(here, 'check-loop.mjs'),
+  ];
+  const clPath = clCandidates.find((p) => fs.existsSync(p));
   if (!fs.existsSync(doctorPath)) fail('找不到 doctor.mjs：' + doctorPath);
-  if (!fs.existsSync(clPath)) fail('找不到 check-loop（.mjs / .sh 均无）：' + clPath);
+  if (!clPath) fail('找不到 check-loop（.mjs / .sh 均无）：' + clPathMjs);
   const doctorSrc = fs.readFileSync(doctorPath, 'utf8');
   const checkLoopSrc = fs.readFileSync(clPath, 'utf8');
   const result = gateChecklist({ doctorSrc, checkLoopSrc });

package/templates/_agents/scripts/gate-checklist.test.mjs

@@ -153,9 +153,15 @@ const y = 2;
 
 const realDoctor = () => fs.readFileSync(path.join(SRC_ROOT, 'src', 'doctor.mjs'), 'utf8');
 // check-loop 解析面与 CLI 同口径：.mjs 优先（2026-09-26 迁移后主位），fallback .sh（旧装户）
+// 装户端内容清理后（2026-10-09）：纯包源仓无 .agents/ 装副本——check-loop.mjs 在包源 scripts/ 下，
+// 即本测试同级；.agents/ 优先（装户径），包源径兜底（纯包源径），两者皆无 → hasReal 已经把守。
 const realCl = () => {
   const mjs = path.join(SRC_ROOT, '.agents', 'scripts', 'check-loop.mjs');
-  return fs.readFileSync(fs.existsSync(mjs) ? mjs : path.join(SRC_ROOT, '.agents', 'scripts', 'check-loop.sh'), 'utf8');
+  if (fs.existsSync(mjs)) return fs.readFileSync(mjs, 'utf8');
+  const sh = path.join(SRC_ROOT, '.agents', 'scripts', 'check-loop.sh');
+  if (fs.existsSync(sh)) return fs.readFileSync(sh, 'utf8');
+  const pkgMjs = path.join(SCRIPT_DIR, 'check-loop.mjs');
+  return fs.readFileSync(pkgMjs, 'utf8');
 };
 const hasReal = fs.existsSync(path.join(SRC_ROOT, 'src', 'doctor.mjs'));
 

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

@@ -1,7 +1,8 @@
 // wiki 索引生成器：磁盘 + INDEX 速览表「用途」列 → 自动重生成 INDEX 速览计数/映射表 + 看板 DATA
 // 2026-09-13 引入：消除三层手工双写（短板①）。人工只维护两样：磁盘文件本身 + 速览表用途列。
-// 用法：node .agents/scripts/gen-wiki-board.mjs [--dry-run] [--help]
+// 用法：node .agents/scripts/gen-wiki-board.mjs [--dry-run] [--check] [--help]
 //   （收录/删除/移动 wiki 文件后必跑，随后跑 verify-wiki-consistency.mjs）
+//   --check 不写盘；INDEX/看板与磁盘不一致时 exit 1 并打印差异（供 doctor 漂移告警）
 // 测试：node .agents/scripts/gen-wiki-board.test.mjs（fixture 回归，须全绿）
 // 生成范围（锚点内整段重写，锚点外字节原样保留）：
 //   INDEX.md 速览表数据行 / 「合计」行数字 / 「## 文件 → 主题 → 归属目录 映射表」到「## 命名规则」之间
@@ -11,7 +12,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { execSync } from 'node:child_process';
 
-const USAGE = `用法：node .agents/scripts/gen-wiki-board.mjs [--dry-run] [--help]
+const USAGE = `用法：node .agents/scripts/gen-wiki-board.mjs [--dry-run] [--check] [--help]
 
 事实源：磁盘 wiki/<主题>/ 一层文件 + INDEX.md 速览表「用途」列（人工列）。重生成：
   - wiki/INDEX.md：速览表数据行与文件计数、「合计」行数字、映射表节
@@ -21,6 +22,7 @@ const USAGE = `用法：node .agents/scripts/gen-wiki-board.mjs [--dry-run] [--h
 
 选项：
   --dry-run   只打印将生成内容的摘要与逐行差异，不写盘
+  --check     不写盘；INDEX/看板与磁盘不一致时 exit 1 并打印差异（供 doctor 漂移告警）
   --help      打印本说明`;
 
 const args = process.argv.slice(2);
@@ -28,12 +30,13 @@ if (args.includes('--help') || args.includes('-h')) {
   console.log(USAGE);
   process.exit(0);
 }
-const unknown = args.filter((a) => a !== '--dry-run');
+const unknown = args.filter((a) => a !== '--dry-run' && a !== '--check');
 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 WIKI = 'wiki';
 const INDEX_P = path.join(WIKI, 'INDEX.md');
@@ -87,6 +90,34 @@ for (const d of fs.readdirSync(WIKI)) {
   diskTopics.set(d, entries);
 }
 
+// ---- 草稿超龄提醒（P1-2）：drafts-archive/<YYYY-MM-DD-主题>/ 落盘超龄未归类 → stdout WARN ----
+// advisory 档：只提醒不阻断（与 B1 沉淀追踪同档），不改归档统计口径与任何生成物，exit code 不受影响。
+// 目录名不带日期前缀（人工建的目录）→ 静默跳过，不 WARN 也不报错。
+const DRAFT_AGE_DAYS = 14; // 超龄档位（天）：与 B1 沉淀追踪同档 advisory，只提醒不阻断
+const TODAY = (() => {
+  // FLOW_KIT_TODAY=YYYY-MM-DD 仅测试/演练用：覆盖「今天」便于构造超龄/未超龄用例；未设置或格式不合法时用系统当前日期
+  const env = process.env.FLOW_KIT_TODAY;
+  if (env && /^\d{4}-\d{2}-\d{2}$/.test(env)) return env;
+  const now = new Date();
+  const pad = (n) => String(n).padStart(2, '0');
+  return `${now.getFullYear()}-${pad(now.getMonth() + 1)}-${pad(now.getDate())}`;
+})();
+const utcMs = (s) => { // 'YYYY-MM-DD' → 当日 UTC 零点毫秒（与 TODAY 同构换算，天数差恒为精确整数）
+  const [y, m, d] = s.split('-').map(Number);
+  return Date.UTC(y, m - 1, d);
+};
+// rel：相对 drafts-archive 的 '/' 分隔路径（如 '2026-09-01-主题/主题.md'，与上方 walk 的 rel 拼法一致）
+const warnIfDraftAged = (rel) => {
+  if (!rel.includes('/')) return; // 直接躺在 drafts-archive 根（无日期目录包裹）→ 静默跳过
+  const dirName = rel.split('/')[0];
+  const m = dirName.match(/^(\d{4}-\d{2}-\d{2})/);
+  if (!m) return; // 目录名不带日期前缀（人工建的目录）→ 静默跳过
+  const days = (utcMs(TODAY) - utcMs(m[1])) / 86400000;
+  if (!(days > DRAFT_AGE_DAYS)) return; // 未超龄（恰 14 天不提醒，超过才提醒）；NaN 同样落此静默跳过
+  const topic = dirName.slice('YYYY-MM-DD-'.length) || dirName; // 目录名 = 日期-主题；无主题段则退回目录名
+  console.log(`[WARN 草稿超龄] drafts-archive/${rel} 落于 ${m[1]} 未归类——草稿是中间态，归类到 wiki/${topic}/ 后跑 gen-wiki-board + verify-wiki-consistency`);
+};
+
 const archiveCount = (() => {
   let n = 0;
   const walk = (dir, rel = '') => {
@@ -95,7 +126,10 @@ const archiveCount = (() => {
       // 集合键带 drafts-archive/ 前缀（扫描面扩全 wiki/ 后），walk rel 须拼前缀比对（复核 P2-b）
       const r = rel ? `drafts-archive/${rel}/${e}` : `drafts-archive/${e}`;
       if (fs.statSync(p).isDirectory()) walk(p, rel ? `${rel}/${e}` : e);
-      else if (!gitIgnoredArchive.has(r)) n++;
+      else if (!gitIgnoredArchive.has(r)) {
+        n++;
+        warnIfDraftAged(rel ? `${rel}/${e}` : e); // 超龄提醒挂在计数控分支：口径一致（ignored 件不提醒），不影响计数
+      }
     }
   };
   if (fs.existsSync(path.join(WIKI, 'drafts-archive'))) walk(path.join(WIKI, 'drafts-archive'));
@@ -185,7 +219,28 @@ if (boardOut === boardText && !/const DATA = \{[\s\S]*?\n\};/.test(boardText)) {
   process.exit(1);
 }
 
-// ---- 写盘（dry-run 只预览差异）----
+// ---- 写盘（dry-run 只预览差异；--check 只比对不写盘）----
+// 行尾归一比较（与 gen-workflow-index.mjs 同款：fresh clone 检出 CRLF、生成段恒 LF——
+// 直接字符串相等会在克隆环境假阳性「漂移」；仅内容差异才算漂移）
+const normEol = (s) => String(s).replace(/\r\n/g, '\n');
+const indexOk = normEol(out) === normEol(indexText);
+const boardOk = normEol(boardOut) === normEol(boardText);
+const summary = `文件 ${totalFiles} 份 / 主题 ${diskTopics.size} 个 / 归档 ${archiveCount} 份`;
+if (CHECK) {
+  if (indexOk && boardOk) {
+    console.log(`✅ wiki/INDEX.md 与看板均与磁盘一致（${summary}）`);
+    process.exit(0);
+  }
+  if (!indexOk) {
+    console.error(`❌ wiki/INDEX.md 与磁盘不一致（${summary}）——跑 node .agents/scripts/gen-wiki-board.mjs 重新生成`);
+    previewDiff('wiki/INDEX.md', indexText, out);
+  }
+  if (!boardOk) {
+    console.error(`❌ wiki/知识沉淀总览.html 与磁盘不一致（${summary}）——跑 node .agents/scripts/gen-wiki-board.mjs 重新生成`);
+    previewDiff('wiki/知识沉淀总览.html', boardText, boardOut);
+  }
+  process.exit(1);
+}
 if (DRY) {
   console.log('🔎 --dry-run：未写盘，差异预览如下');
   previewDiff('wiki/INDEX.md', indexText, out);
@@ -196,7 +251,7 @@ if (DRY) {
 }
 
 const tail = DRY ? '将重写' : '已重写';
-console.log(`${DRY ? '🔎 [dry-run] 将生成' : '✅ 已生成'}：文件 ${totalFiles} 份 / 主题 ${diskTopics.size} 个 / 归档 ${archiveCount} 份；速览表 ${overviewRows.length} 行、映射表 ${ordered.length} 节、看板 DATA ${tail}`);
+console.log(`${DRY ? '🔎 [dry-run] 将生成' : '✅ 已生成'}：${summary}；速览表 ${overviewRows.length} 行、映射表 ${ordered.length} 节、看板 DATA ${tail}`);
 console.log('   人工仅维护：磁盘文件 + 速览表「用途」列（新主题为 <待补> 的请补描述后重跑本脚本）');
 
 // dry-run 差异预览：首尾对齐后取中段变更块（逐行），各方向最多显示 10 行

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

@@ -85,7 +85,8 @@ const mkfix = (eol) => {
   return root;
 };
 
-const runGen = (root) => spawnSync(process.execPath, [GEN], { cwd: root, encoding: 'utf8' });
+// 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 ——「用途」列重生成后保持 + 行尾保持（缺陷回归）----
 {
@@ -168,6 +169,78 @@ const runGen = (root) => spawnSync(process.execPath, [GEN], { cwd: root, encodin
   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}`);

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

@@ -119,7 +119,7 @@ export function qualityRows(root) {
     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)} | ${verdict} |`);
+    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 };
 }
@@ -202,7 +202,7 @@ function main() {
     '',
     '## 质量 / 返工（月度，判据复用 agg-delegations）',
     '',
-    '| 月份 | 有效任务 | 一次通过率 | 设计返工 | 门禁噪声返工 | 平均返工 | 主兜底占比 | 扩容门判定 |',
+    '| 月份 | 有效任务 | 一次通过率 | 设计返工 | 门禁噪声返工 | 平均返工 | 主兜底占比 | 产出接受率 | 扩容门判定 |',
     '|------|----------|------------|---------|-------------|--------|------------|------------|',
     ...(q.rows.length ? q.rows : ['| — | — | — | — | — | — | — | 台账暂无数据 |']),
     '',

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

@@ -53,8 +53,11 @@ const DOC_TYPES = ['intents', 'specs', 'plans', 'incidents'];
 // 场景 1 即 exit 1（workflow-enums 单源文件不可读），而包源侧同字节跑出全绿。
 // 改为**逐级上溯探测**：找到含 `.agents/workflow-enums.txt` 的那一级即用，找不到则回退标准位置让
 // loadEnums fail-loud（保持「缺失即响亮」的既有纪律，不静默兜底）。
+// 包源仓布局补丁（装户端内容清理后）：纯包源仓无 `.agents/`，枚举单源在 `templates/_agents/` 下——
+// 上一级目录名是 `_agents` 而非 `.agents`。探测同步认这两种布局，回退仍走 fail-loud。
 const resolveEnumsPath = () => {
-  let dir = path.dirname(fileURLToPath(import.meta.url));
+  const scriptDir = path.dirname(fileURLToPath(import.meta.url));
+  let dir = scriptDir;
   for (let i = 0; i < 6; i++) {
     const cand = path.join(dir, '.agents', 'workflow-enums.txt');
     if (fs.existsSync(cand)) return cand;
@@ -62,7 +65,10 @@ const resolveEnumsPath = () => {
     if (parent === dir) break; // 到根
     dir = parent;
   }
-  return path.join(path.dirname(fileURLToPath(import.meta.url)), '..', '..', '.agents', 'workflow-enums.txt');
+  // 包源径：脚本在 templates/_agents/scripts/，枚举在 templates/_agents/workflow-enums.txt
+  const pkgSrc = path.join(scriptDir, '..', 'workflow-enums.txt');
+  if (fs.existsSync(pkgSrc)) return pkgSrc;
+  return path.join(scriptDir, '..', '..', '.agents', 'workflow-enums.txt');
 };
 const ENUMS = loadEnums(resolveEnumsPath());
 const ACTIVE_STATUS = [...ENUMS['doc.status.active'], ...ENUMS['incident.status.active']];
@@ -168,7 +174,7 @@ const idxText = fs.existsSync(path.join(WORKFLOW, 'INDEX.md')) ? fs.readFileSync
 const idxBytes = Buffer.byteLength(idxText, 'utf8');
 const idxActive = Number((idxText.match(/^## 活跃（(\d+)）/m) || [])[1] ?? NaN);
 
-// ---- 闭环漏斗（2026-10-02 ledger-funnel-metrics；口径定义式单源 = workflow/specs/2026-10-02-ledger-funnel-metrics.md）----
+// ---- 闭环漏斗（2026-10-02 ledger-funnel-metrics 立法）----
 // 只读台账一手字段（doc/stage/ts/source），坏行跳过（与检查 15/19 同容错）；观测面不挂门禁、不新增文档断言（检查 16 零接触）。
 const LEDGER_P = path.join('.agents', 'confirmations.jsonl');
 function readLedgerRows() {
@@ -249,9 +255,9 @@ const TABLE_HEAD = [
   '| 月份 | 文档（活跃/终态） | 文档字节 | 模块已填/总 | 常驻面字节（预算峰值） | INDEX（活跃行） |',
   '|---|---|---|---|---|---|',
 ];
-// 漏斗表头（第二表；口径定义式单源 = workflow/specs/2026-10-02-ledger-funnel-metrics.md）
+// 漏斗表头（第二表）
 const FUNNEL_HEAD = [
-  '## 闭环漏斗（机器口径，源：.agents/confirmations.jsonl——定义式见 specs/2026-10-02-ledger-funnel-metrics.md）',
+  '## 闭环漏斗（机器口径，源：.agents/confirmations.jsonl）',
   '',
   '| 月份 | 收口 | 完整链 | 协议前 | 一次通过 | 返工件 | 中位周期(天) | 台账行数 |',
   '|---|---|---|---|---|---|---|---|',