agentic-flow-kit 1.8.7 → 2.0.0

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

@@ -1,178 +0,0 @@
-// flow-kit draft-sediment：关单时把高价值内容自动抽成 wiki 草稿（B2，2026-10-10）
-// 输入：一个 done intent 或 closed incident 文件 → 抽取高价值节（影响面/触达红线 或 复盘三件套）
-//   → 渲染成带「来源」frontmatter 的 wiki 草稿 → 落 wiki/drafts-archive/<日期-主题>/<主题>.md
-//   → 回写源文件 frontmatter「沉淀:」字段（与 B1 沉淀追踪闭环）→ 重跑 gen-wiki-board（归档计数随动，
-//     否则 verify-wiki-consistency 的 summary.archive 比对会拦提交）
-// 草稿是中间态：drafts-archive 只读不增量、不参与文件级登记（仅计总数），归类到活跃主题目录由人工完成
-// （人工移动后跑 gen-wiki-board + verify-wiki-consistency，并在目标文件保留/改写「来源」字段）
-// 用法：node .agents/scripts/draft-sediment.mjs workflow/intents/<日期>-<主题>.md [--dry-run] [--help]
-//   （intent 须 done；incident 须 closed 且复盘三件套齐全——与 check-loop 沉淀追踪子判据同口径）
-// 零依赖；抽节为纯函数（export 供测试）；CLI 解析最简字符串匹配
-import fs from 'node:fs';
-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 USAGE = `用法：node .agents/scripts/draft-sediment.mjs <workflow/intents|incidents/文件.md> [--dry-run] [--help]
-
-关单时把高价值内容抽成 wiki 草稿（B2 沉淀自动化）：
-  - intent（须 done）：抽「影响面」「触达红线」节
-  - incident（须 closed 且复盘三件套齐全）：抽「影响面」「根因」「为什么之前没拦住」「复盘三件套」节
-落 wiki/drafts-archive/<日期-主题>/<主题>.md，带「来源」frontmatter 指回源文件（B3 双向链接），
-并回写源文件 frontmatter「沉淀:」字段（B1 闭环），随后重跑 gen-wiki-board.mjs 更新归档计数。
-
-选项：
-  --dry-run   只打印将生成的草稿与回写动作，不写盘
-  --help      打印本说明
-
-草稿是中间态：drafts-archive 只读不增量。人工归类到 wiki/<主题>/ 后跑
-  node .agents/scripts/gen-wiki-board.mjs && node .agents/scripts/verify-wiki-consistency.mjs`;
-
-// extractSections：从 markdown 抽指定节（## 标题到下一 ## 之间的非空正文）。纯函数，无 IO。
-//   节标题前缀匹配（兼容「## 影响面与边界」）。占位行（<…> 单行包揽 / HTML 注释 / 引用块）剔除——
-//   与 check-loop sectionHasBody 同口径：模板未填段抽出的是占位，没有沉淀价值。
-//   返回 [{ title, body }]，body 为去占位后的非空行拼接（保留原行内容与缩进）。
-export function extractSections(text, headings) {
-  const lines = String(text).split(/\r?\n/);
-  const out = [];
-  let cur = null;
-  let buf = [];
-  const flush = () => {
-    if (cur) {
-      const body = buf.filter((l) => {
-        const s = l.trim();
-        return s && !/^<.*>$/.test(s) && !s.startsWith('<!--') && !s.startsWith('>');
-      });
-      if (body.length) out.push({ title: cur, body: body.join('\n') });
-    }
-    buf = [];
-  };
-  for (const line of lines) {
-    const h = line.match(/^\s*##\s+(.+?)\s*$/);
-    if (h) {
-      flush();
-      cur = headings.find((x) => h[1].startsWith(x)) ? h[1] : null;
-      continue;
-    }
-    if (cur) buf.push(line);
-  }
-  flush();
-  return out;
-}
-
-// topicOf：主题取法——标题行（# INTENT — <主题>）优先（文件名主题常是英文短代称，
-//   标题才是可读中文名）；无标题行再退文件名尾段（YYYY-MM-DD-<主题>）；都无取文件基名。
-export function topicOf(filePath, text) {
-  const t = String(text).match(/^#\s+(?:INTENT|INCIDENT|PLAN|SPEC)\s*—\s*(.+?)\s*$/m);
-  if (t) return t[1];
-  const base = path.basename(filePath, '.md');
-  const m = base.match(/^\d{4}-\d{2}-\d{2}-(.+)$/);
-  return m ? m[1] : base;
-}
-
-// renderDraft：草稿渲染（纯函数）。date = 落盘日期（YYYY-MM-DD），source = 来源相对仓根路径。
-export function renderDraft({ topic, date, source, sections, kind }) {
-  const fm = `---\n来源: ${source}\n状态: 草稿（待人工归类）\n---\n`;
-  const kindLabel = kind === 'incident' ? '事故复盘' : '需求沉淀';
-  let body = `# ${topic}（${kindLabel}草稿）\n`;
-  body += `> 自动抽取于 ${date}，源自 \`${source}\`（关单沉淀，B2）。`;
-  body += `本文件是**中间态**——归类到 wiki/<主题>/ 后补主题、用途，并保留「来源」字段。\n\n`;
-  for (const s of sections) {
-    body += `## ${s.title}\n\n${s.body}\n\n`;
-  }
-  return fm + body;
-}
-
-// setSedimentField：回写源文件 frontmatter「沉淀:」字段。已有值（非空、非「无」）不覆盖（防误抹人工登记）。
-export function setSedimentField(text, value) {
-  const m = String(text).match(/^(---\r?\n)([\s\S]*?)(\r?\n---)/);
-  if (!m) return { text, changed: false };
-  const fmBody = m[2];
-  const lines = fmBody.split(/\r?\n/);
-  const idx = lines.findIndex((l) => /^沉淀:\s*/.test(l));
-  if (idx >= 0) {
-    const cur = lines[idx].replace(/^沉淀:\s*/, '').trim();
-    if (cur && cur !== '无') return { text, changed: false }; // 已有人工登记，不覆盖
-    lines[idx] = `沉淀: ${value}`;
-  } else {
-    lines.push(`沉淀: ${value}`);
-  }
-  return { text: m[1] + lines.join('\n') + m[3] + String(text).slice(m[0].length), changed: true };
-}
-
-function fail(msg) { console.error('❌ ' + msg); process.exit(1); }
-
-const isMain = process.argv[1] && process.argv[1].endsWith('draft-sediment.mjs');
-if (isMain) {
-  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');
-  const target = args.find((a) => !a.startsWith('-'));
-  if (!target) fail('必填：源文件路径（workflow/intents/… 或 workflow/incidents/…）' + '\n\n' + USAGE);
-  if (!fs.existsSync(target)) fail('源文件不存在：' + target);
-
-  const text = fs.readFileSync(target, 'utf8');
-  const rel = path.relative(process.cwd(), target).split(path.sep).join('/');
-  const kind = rel.startsWith('workflow/incidents/') ? 'incident' : rel.startsWith('workflow/intents/') ? 'intent' : null;
-  if (!kind) fail('源文件须在 workflow/intents/ 或 workflow/incidents/ 下：' + rel);
-
-  // 状态校验（与 check-loop 沉淀追踪子判据同口径）
-  const fmStatus = (() => {
-    const m = text.match(/^---\r?\n[\s\S]*?^状态:\s*(.+?)\s*$/m);
-    return m ? m[1].trim() : null;
-  })();
-  if (kind === 'intent' && fmStatus !== 'done') fail('intent 须为 done 才沉淀（当前：' + (fmStatus || '缺失') + '）');
-  if (kind === 'incident' && fmStatus !== 'closed') fail('incident 须为 closed 才沉淀（当前：' + (fmStatus || '缺失') + '）');
-
-  // 抽节：intent 影响面/触达红线；incident 影响面/根因/为什么之前没拦住/复盘三件套
-  const HEADINGS = kind === 'incident'
-    ? ['影响面', '根因', '为什么之前没拦住', '复盘三件套']
-    : ['影响面', '触达红线'];
-  const sections = extractSections(text, HEADINGS);
-  if (!sections.length) fail('未抽取到高价值节（' + HEADINGS.join('/') + ' 均为空或仅占位）——内容无沉淀价值，停止');
-
-  const topic = topicOf(target, text);
-  const date = new Date().toISOString().slice(0, 10);
-  const draftDir = path.join('wiki', 'drafts-archive', `${date}-${topic}`);
-  const draftPath = path.join(draftDir, `${topic}.md`);
-  const draft = renderDraft({ topic, date, source: rel, sections, kind });
-
-  // 回写源文件沉淀字段（草稿路径相对仓根）
-  const { text: newText, changed } = setSedimentField(text, draftPath.split(path.sep).join('/'));
-
-  if (DRY) {
-    console.log('🔎 --dry-run：未写盘');
-    console.log(`• 将生成草稿：${draftPath}（${sections.length} 节 / ${draft.length} 字节）`);
-    console.log(`• 将回写 ${rel} frontmatter「沉淀: ${draftPath.split(path.sep).join('/')}」${changed ? '' : '（已有登记，不覆盖）'}`);
-    console.log('• 将重跑 gen-wiki-board.mjs（归档计数 +1）');
-    console.log('\n--- 草稿预览（前 30 行）---');
-    console.log(draft.split(/\r?\n/).slice(0, 30).join('\n'));
-    process.exit(0);
-  }
-
-  // 写草稿
-  fs.mkdirSync(draftDir, { recursive: true });
-  fs.writeFileSync(draftPath, draft);
-  console.log(`✅ 已生成 wiki 草稿：${draftPath}（${sections.length} 节：${sections.map((s) => s.title).join('、')}）`);
-
-  // 回写源文件
-  if (changed) {
-    fs.writeFileSync(target, newText);
-    console.log(`✅ 已回写源文件沉淀字段：${rel} → 沉淀: ${draftPath.split(path.sep).join('/')}`);
-  } else {
-    console.log(`ℹ️ 源文件已有沉淀登记，未覆盖：${rel}`);
-  }
-
-  // 重跑 gen-wiki-board（归档计数随动——不跑则 verify-wiki-consistency 的 summary.archive 比对拦提交）
-  const gen = path.join(SCRIPT_DIR, 'gen-wiki-board.mjs');
-  if (fs.existsSync(gen)) {
-    const r = spawnSync(process.execPath, [gen], { encoding: 'utf8', windowsHide: true });
-    if (r.status === 0) console.log('✅ 已重跑 gen-wiki-board.mjs（归档计数随动）');
-    else console.error('⚠️ gen-wiki-board.mjs 重跑失败（exit ' + r.status + '）——手工跑：node .agents/scripts/gen-wiki-board.mjs');
-  } else {
-    console.log('ℹ️ gen-wiki-board.mjs 不存在（旧装户），跳过归档计数随动');
-  }
-  console.log('\n下一步（人工）：读草稿 → 归类到 wiki/<主题>/ → 补主题与用途 → 跑 gen-wiki-board + verify-wiki-consistency');
-}

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

@@ -1,272 +0,0 @@
-#!/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/edit-face-check.mjs

@@ -1,109 +0,0 @@
-#!/usr/bin/env node
-// edit-face-check — 常驻面编辑时快检（2026-10-09 engine-quality-round2 B2）
-// 动机：常驻面（AGENTS.md 等）的机器约束此前只在 git 钩子层生效——check-loop 仓库模式只扫 HEAD，
-//   工作树编辑期零反馈（实测：常驻面重构砍掉阶段索引，到提交才被检查 7 报警）。本脚本把判定左移到编辑时。
-// 判定零复刻铁律：闭环判定**单源**复用 check-loop——以 CHECK_LOOP_ROOT=<root>（全扫模式，扫工作树
-//   非 HEAD）子进程消费其裁决，本脚本不实现任何门判定；唯一自算是常驻面字节预算 advisory（工作树
-//   LF 字节 vs rule-budgets.txt 上限——提交门口径走 git index/HEAD（rule-budget.mjs），两者判据不同面，
-//   此处为编辑时 advisory，冲突时以提交门为准）。
-// exit 语义：check-loop hard（exit≠0）→ 2；预算 advisory 超限 → 1；其余 → 0。
-//   WARN **不进 exit**（打印明细供 AI/人对照）——绝对 WARN 计数会让带存量 advisory 的仓库恒非零
-//   （本仓即有用户拍板保留的存量 WARN），工具就不可用了；编辑破坏的表现（如阶段索引漂移 WARN）
-//   在输出里一眼可见，由编辑者处置。
-// 用法：node .agents/scripts/edit-face-check.mjs [--root <仓库根>]（缺省 cwd；测试注入 EDIT_FACE_CHECK_SPAWN）
-// 测试：node templates/_agents/scripts/edit-face-check.test.mjs
-import fs from 'node:fs';
-import path from 'node:path';
-import { spawnSync } from 'node:child_process';
-import { fileURLToPath } from 'node:url';
-
-// LF 归一字节数（编辑时口径——工作区文件可能 CRLF，预算表口径注释声明「比较用 LF 归一」）
-export function lfBytes(text) {
-  return Buffer.byteLength(String(text).replace(/\r\n/g, '\n'), 'utf8');
-}
-
-// globToRe：rule-budgets.txt 行首路径 → 正则（支持 `*` 段内通配与结尾 `/` 目录前缀；其余字面）
-export function globToRe(pattern) {
-  const dir = pattern.endsWith('/');
-  let src = pattern.replace(/[.+^${}()|[\]\\]/g, '\\$&').replace(/\*/g, '[^/]*');
-  if (dir) src += '.*';
-  return new RegExp(`^${src}${dir ? '' : '$'}`);
-}
-
-// budgetAdvisory：常驻面预算 advisory（编辑时口径）。files: Map<rel, 工作树文本>；budgetsText: 表原文。
-// 返回超限行 [{ rel, limit, actual }]；表缺失/行非法 → 空数组（advisory 层 fail-open）。
-export function budgetAdvisory(files, budgetsText) {
-  const out = [];
-  if (!budgetsText) return out;
-  for (const line of budgetsText.split(/\r?\n/)) {
-    const t = line.replace(/\r$/, '').trim();
-    if (!t || t.startsWith('#')) continue;
-    const m = t.match(/^(\S+)\s+(\d+)$/);
-    if (!m) continue;
-    const [, pattern, limitStr] = m;
-    const limit = Number(limitStr);
-    const re = globToRe(pattern);
-    for (const [rel, text] of files) {
-      if (!re.test(rel)) continue;
-      const actual = lfBytes(text);
-      if (actual > limit) out.push({ rel, limit, actual });
-    }
-  }
-  return out;
-}
-
-// runCheck：工作树面 check-loop（CHECK_LOOP_ROOT 全扫）。返回 { code, output, ms }。
-// --all 显式全量（2026-10-13 分道后裸跑=默认硬门）：本工具的动机就是编辑期暴露卫生面 WARN
-// （如阶段索引漂移——头部动机段），硬门子集满足不了，须显式声明全量。
-function runCheck(root, scriptDir) {
-  const t0 = Date.now();
-  const r = spawnSync(process.execPath, [path.join(scriptDir, 'check-loop.mjs'), '--all'], {
-    cwd: root, encoding: 'utf8', windowsHide: true,
-    env: { ...process.env, CHECK_LOOP_ROOT: root },
-  });
-  return { code: r.status ?? 1, output: `${r.stdout || ''}${r.stderr || ''}`, ms: Date.now() - t0 };
-}
-
-export function main(root = process.cwd(), scriptDir = path.dirname(fileURLToPath(import.meta.url))) {
-  // ① 闭环判定（单源 check-loop，工作树全扫）
-  const ck = runCheck(root, scriptDir);
-  const warnCount = (ck.output.match(/\[WARN /g) || []).length;
-  // ② 常驻面预算 advisory（AGENTS.md + 预算表内文件的工作树字节）
-  let over = [];
-  try {
-    const budgetsPath = path.join(root, '.agents', 'rule-budgets.txt');
-    const budgetsText = fs.existsSync(budgetsPath) ? fs.readFileSync(budgetsPath, 'utf8') : null;
-    const files = new Map();
-    const agentsPath = path.join(root, 'AGENTS.md');
-    if (fs.existsSync(agentsPath)) files.set('AGENTS.md', fs.readFileSync(agentsPath, 'utf8'));
-    over = budgetAdvisory(files, budgetsText);
-  } catch { /* advisory 层 fail-open：预算读不到不阻断编辑时反馈 */ }
-
-  console.log(`▶ edit-face-check → ${root}（工作树面）`);
-  console.log(`  check-loop：${ck.code === 0 ? '通过' : `exit ${ck.code}`}，WARN ${warnCount} 条（${ck.ms}ms）——与本仓存量 advisory 对照看新增`);
-  // WARN 明细透传（编辑破坏的判读面——如删阶段索引会在此点名「阶段索引漂移」）
-  for (const line of ck.output.split(/\r?\n/)) {
-    if (/\[WARN /.test(line)) console.log('  ' + line.trim().slice(0, 200));
-  }
-  for (const { rel, limit, actual } of over) {
-    console.log(`  ⚠️ 预算 advisory：${rel} 工作树 ${actual}B > 上限 ${limit}B（编辑时口径；提交门以 rule-budget.mjs 为准）`);
-  }
-  if (ck.code !== 0) {
-    console.error('❌ 闭环判定 hard 未过——先修复再提交（判定单源 check-loop，详见上方输出）');
-    return 2;
-  }
-  if (over.length > 0) {
-    console.error('⚠️ 常驻面预算 advisory 超限——建议编辑期就瘦，别留到提交门');
-    return 1;
-  }
-  console.log('✅ 编辑时快检完成（hard/预算两道均过；WARN 明细请对照处置）');
-  return 0;
-}
-
-const isMain = process.argv[1] && process.argv[1].endsWith('edit-face-check.mjs');
-if (isMain) {
-  let root = process.cwd();
-  const i = process.argv.indexOf('--root');
-  if (i > 0 && process.argv[i + 1]) root = path.resolve(process.argv[i + 1]);
-  process.exit(main(root));
-}