agentic-flow-kit 1.8.7 → 2.1.0

package/templates/_agents/scripts/verify-wiki-consistency.mjs

@@ -1,253 +0,0 @@
-// wiki 三方一致性验证：磁盘 ↔ INDEX.md ↔ 知识沉淀总览.html(DATA) ＋ 数据维护台账登记 ＋ 看板链接可达性
-// 用法: node .agents/scripts/verify-wiki-consistency.mjs   （不一致 exit 1）
-// 约定见 .agents/skills/wiki/SKILL.md；归档 drafts-archive 仅计数，不参与文件比对。
-// 口径（2026-09-17 起，与 gen-wiki-board.mjs 保持一致）：主题目录顶层全量文件登记 +
-//      直属子目录中的 md/html 知识文档（排除 *.visual-check.* 工具产物；数据维护主题例外——
-//      其子目录 schema变更/<批次>/ 等走 README 台账，不参与三方文件比对与 summary 统计）；
-//      递归扫描仅用于「断链守卫 + 数据维护批次台账登记」两项断言，避免改变既有统计口径误报。
-import fs from 'node:fs';
-import path from 'node:path';
-import { execSync } from 'node:child_process';
-
-const WIKI = 'wiki';
-const problems = [];
-const notes = [];
-
-// 递归列目录（相对 dir 的路径，仅正斜杠）；drafts-archive 由调用方排除
-const walkTree = (dir, rel = '') => {
-  const acc = { files: [], dirs: [] };
-  for (const e of fs.readdirSync(dir)) {
-    const p = path.join(dir, e);
-    const r = rel ? `${rel}/${e}` : e;
-    if (fs.statSync(p).isDirectory()) {
-      acc.dirs.push(r);
-      const sub = walkTree(p, r);
-      acc.files.push(...sub.files);
-      acc.dirs.push(...sub.dirs);
-    } else acc.files.push(r);
-  }
-  return acc;
-};
-
-// ---- 磁盘枚举（登记口径与 gen-wiki-board.mjs 一致）----
-const isKnowledgeDoc = (f) => /\.(md|html)$/i.test(f) && !/\.visual-check\./i.test(f);
-// gitignore 豁免（F4，incident 2026-09-23-code-review-f3-f4-closeout）：drafts-archive 含
-// .gitignore 忽略的本机文件（如 *.xlsx），计入会使生成物计数在 fresh clone 必然漂移；
-// 口径 = 排除忽略文件（git 不可用/非仓库时退化为全量计数，fixture 环境不受影响）
-const gitIgnoredArchive = (() => {
-  try {
-    const out = execSync('git -c core.quotepath=false status --ignored=matching --porcelain -uall -- wiki',
-      { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] });
-    const prefix = 'wiki/';
-    return new Set(out.split(/\r?\n/)
-      .filter((l) => l.startsWith('!! '))
-      .map((l) => l.slice(3).trim().replace(/\/$/, ''))
-      .filter((p) => p.startsWith(prefix))
-      .map((p) => p.slice(prefix.length)));
-  } catch {
-    return new Set();
-  }
-})();
-const diskFiles = new Set(); // "主题/文件名"（子目录文件名带 子目录/ 前缀）
-const diskTopics = new Set();
-const activeTree = { files: [], dirs: [] }; // 递归视图（断链守卫 / 台账登记断言用）
-for (const d of fs.readdirSync(WIKI)) {
-  const p = path.join(WIKI, d);
-  if (!fs.statSync(p).isDirectory()) continue;
-  if (d === 'drafts-archive') continue;
-  diskTopics.add(d);
-  // gitignore 豁免消费（p2-batch2 复核 P1-3）：gen 侧排除 ignored 本机件，verify 须同口径——
-  // 否则「gen 恒写 N、verify 恒数 N+1」门禁死锁且自愈指引（重跑 gen）无效
-  const isIgnored = (rel) => { const k = rel.replace(/\/$/, ''); return gitIgnoredArchive.has(`${d}/${k}`) || gitIgnoredArchive.has(`${d}/${k}/`); }; // 尾斜杠归一（复核 P2-a）
-  for (const f of fs.readdirSync(p)) {
-    if (fs.statSync(path.join(p, f)).isFile() && !isIgnored(f)) diskFiles.add(`${d}/${f}`);
-  }
-  if (d !== '数据维护') {
-    for (const sub of fs.readdirSync(p)) {
-      const sp = path.join(p, sub);
-      if (!fs.statSync(sp).isDirectory()) continue;
-      for (const f of fs.readdirSync(sp)) {
-        if (fs.statSync(path.join(sp, f)).isFile() && isKnowledgeDoc(f) && !isIgnored(`${sub}/${f}`)) diskFiles.add(`${d}/${sub}/${f}`);
-      }
-    }
-  }
-  const sub = walkTree(p, d);
-  activeTree.files.push(...sub.files);
-  activeTree.dirs.push(...sub.dirs);
-}
-
-
-// drafts-archive 缺失：ENOENT 崩栈改明示失败（本脚本是门禁，协议目录被删应 exit 1 而非崩栈，2026-09-24）
-const ARCHIVE_DIR = path.join(WIKI, 'drafts-archive');
-let archiveCount = 0;
-if (fs.existsSync(ARCHIVE_DIR)) archiveCount = walkTree(ARCHIVE_DIR).files.filter((r) => !gitIgnoredArchive.has(`drafts-archive/${r}`)).length; // 集合键带 drafts-archive/ 前缀（复核 P2-b）
-else problems.push('wiki/drafts-archive/ 目录缺失（wiki 协议结构，模板自带）——归档一致性无从校验');
-
-// ---- 看板 DATA 解析 ----
-const html = fs.readFileSync(path.join(WIKI, '知识沉淀总览.html'), 'utf8');
-const m = html.match(/const DATA = (\{[\s\S]*?\n\});/);
-if (!m) {
-  console.error('❌ 看板 DATA 解析失败：知识沉淀总览.html 中找不到 `const DATA = {...}`');
-  process.exit(1);
-}
-// JSON.parse（p2-batch2）：DATA 由 gen-wiki-board 经 JSON.stringify 生成、必为合法 JSON——
-// eval 换 JSON.parse 消除门禁脚本对 repo 内文件执行任意 JS 的面；解析失败即 fail-loud 门禁失败
-let DATA;
-try {
-  DATA = JSON.parse(m[1]);
-} catch (e) {
-  console.error(`❌ 看板 DATA 不是合法 JSON（应跑 gen-wiki-board.mjs 重生成）：${e.message}`);
-  process.exit(1);
-}
-// 合计行比对（p2-batch2）：合计行有生成（fail-loud 锚点）无验证——手改/陈旧此前不可见
-{
-  const totalM = fs.readFileSync(path.join(WIKI, 'INDEX.md'), 'utf8').match(/合计：\*\*(\d+) 份\*\*知识文档，\*\*(\d+) 个主题\*\*/);
-  if (totalM) {
-    if (Number(totalM[1]) !== diskFiles.size || Number(totalM[2]) !== diskTopics.size) {
-      console.error(`❌ INDEX 合计行与磁盘不一致：合计 ${totalM[1]} 份/${totalM[2]} 主题 vs 磁盘 ${diskFiles.size} 份/${diskTopics.size} 主题——跑 gen-wiki-board.mjs 重生成`);
-      process.exit(1);
-    }
-  }
-}
-const boardFiles = new Set();
-for (const t of DATA.topics) for (const f of t.files) boardFiles.add(`${t.name}/${f.file}`);
-const boardTopics = new Set(DATA.topics.map((t) => t.name));
-
-// ---- INDEX 映射表解析 ----
-const indexFiles = new Set();
-const indexTopicCounts = new Map(); // 速览表 topic → 文件数
-for (const line of fs.readFileSync(path.join(WIKI, 'INDEX.md'), 'utf8').split(/\r?\n/)) {
-  const mm = line.match(/^\| ([^|]+) \| ([^|]+) \| wiki\/([^/]+)\/[^|]*\|$/);
-  if (mm) indexFiles.add(`${mm[3].trim()}/${mm[1].trim()}`);
-  // 速览行用途列容忍转义管道（p2-batch2 复核 P2-4：gen 侧转义写入后本解析须同款，否则该主题计数核对静默跳过）
-  const ov = line.match(/^\| ([^|]+) \| (\d+) \|((?:\\.|[^|])*)\|$/);
-  if (ov && ov[1].trim() !== '主题') indexTopicCounts.set(ov[1].trim().replace(/\\\|/g, '|'), Number(ov[2]));
-}
-
-const diff = (a, b) => [...a].filter((x) => !b.has(x));
-
-// ---- 1. 文件级三方比对 ----
-for (const [label, extra] of [
-  ['看板→磁盘', diff(boardFiles, diskFiles)],
-  ['磁盘→看板', diff(diskFiles, boardFiles)],
-  ['INDEX→磁盘', diff(indexFiles, diskFiles)],
-  ['磁盘→INDEX', diff(diskFiles, indexFiles)],
-]) {
-  if (extra.length) problems.push(`文件集合不一致（${label}）: ${extra.join('；')}`);
-}
-if (problems.length === 0) notes.push(`文件级三方一致：${diskFiles.size} 份`);
-
-// ---- 2. 幽灵目录：磁盘有主题目录但看板没有 ----
-const ghosts = diff(diskTopics, boardTopics);
-if (ghosts.length) problems.push(`磁盘存在看板未登记的主题目录: ${ghosts.join('、')}`);
-
-// ---- 3. 占位主题（看板有、磁盘 0 文件）——允许，仅提示 ----
-for (const t of DATA.topics) {
-  if (t.files.length === 0 && fs.existsSync(path.join(WIKI, t.name))) {
-    const real = fs.readdirSync(path.join(WIKI, t.name)).filter((f) => fs.statSync(path.join(WIKI, t.name, f)).isFile()).length;
-    if (real > 0) problems.push(`看板主题「${t.name}」files 为空但磁盘有 ${real} 个文件`);
-    else notes.push(`占位主题「${t.name}」：0 文件（允许）`);
-  } else if (t.files.length === 0) {
-    problems.push(`看板主题「${t.name}」files 为空且磁盘无此目录`);
-  }
-}
-
-// ---- 4. INDEX 速览表文件数 vs 磁盘 ----
-for (const [topic, count] of indexTopicCounts) {
-  const actual = [...diskFiles].filter((f) => f.startsWith(topic + '/')).length;
-  if (!diskTopics.has(topic) && count > 0) problems.push(`INDEX 速览表主题「${topic}」(${count}) 磁盘无此目录`);
-  else if (actual !== count) problems.push(`INDEX 速览表「${topic}」标 ${count}，磁盘实际 ${actual}`);
-}
-
-// ---- 5. summary 统计字段 ----
-const s = DATA.summary;
-const sumChecks = [
-  ['summary.total', s.total, diskFiles.size],
-  ['summary.files', s.files, diskFiles.size],
-  ['summary.topics', s.topics, DATA.topics.length],
-  ['summary.archive', s.archive, archiveCount],
-];
-for (const [label, declared, actual] of sumChecks) {
-  if (declared !== actual) problems.push(`${label}=${declared}，实际 ${actual}`);
-}
-
-// ---- 6. 活跃文件禁 file:/// 绝对链（搬家断链防复发；递归覆盖子目录）----
-const badLinks = [];
-for (const f of activeTree.files) {
-  if (!/\.(md|html)$/i.test(f)) continue;
-  if (fs.readFileSync(path.join(WIKI, f), 'utf8').includes('file:///')) badLinks.push(f);
-}
-if (badLinks.length) problems.push(`以下活跃文件含 file:/// 绝对路径链接: ${badLinks.join('、')}`);
-
-// ---- 7. 数据维护台账登记：子目录（含批次目录）须在 wiki/数据维护/README.md 有登记行 ----
-// 「数据维护走 README 台账」是可选主题约定——目录不存在（新项目未建该主题）时整体跳过
-const maintLedger = path.join(WIKI, '数据维护', 'README.md');
-if (fs.existsSync(maintLedger)) {
-const maintReadme = fs.readFileSync(maintLedger, 'utf8');
-const maintReadmeFlat = maintReadme.replace(/\s+/g, ''); // README 标题写作「schema 变更」（带空格），故去空白再比对
-const maintDirs = activeTree.dirs.filter((d) => d.startsWith('数据维护/'));
-const unregistered = maintDirs
-  .map((d) => d.split('/').pop())
-  .filter((name) => !maintReadme.includes(name) && !maintReadmeFlat.includes(name.replace(/\s+/g, '')));
-if (unregistered.length) problems.push(`数据维护台账未登记（wiki/数据维护/README.md 无此行）：${unregistered.join('、')}`);
-else notes.push(`数据维护台账登记完整：${maintDirs.length} 个子目录（含批次目录）均有登记`);
-}
-
-// ---- 8. 看板链接可达性：DATA.dir（「打开目录」href）+ 静态相对 href 解析后须存在 ----
-const deadLinks = [];
-for (const t of DATA.topics) {
-  for (const f of t.files) {
-    const p = path.join(WIKI, f.dir); // 看板自身位于 wiki/，dir 为相对它解析
-    if (!fs.existsSync(p) || !fs.statSync(p).isDirectory()) deadLinks.push(`${t.name}/${f.file} → ${f.dir}`);
-  }
-}
-// 静态 href 扫描守的是「手工编辑看板」时加的链接（生成链接全在 JS 运行时拼，不落静态属性）——看板是 owned 内容，人为改动须可达
-for (const m2 of html.matchAll(/href="([^"]+)"/g)) {
-  const href = m2[1];
-  if (/^(https?:|mailto:|#)/i.test(href) || href.includes('${')) continue; // 外链 / 锚点 / 模板占位
-  if (!fs.existsSync(path.join(WIKI, href))) deadLinks.push(`静态 href → ${href}`);
-}
-if (deadLinks.length) problems.push(`看板链接指向不存在的路径（相对 wiki/ 解析）: ${deadLinks.join('；')}`);
-
-// ---- 9. 来源血缘（B3，2026-10-10）：wiki frontmatter「来源: workflow/<类型>/<文件>」指回 workflow 归档 ----
-// 与 intent/incident 的正向「沉淀:」字段对称闭环——双向链接任一端指向不存在的文件即断链。
-// 校验面：活跃层知识文档（.md/.html，含子目录递归）。无 frontmatter / 无来源键的老文件零影响。
-// drafts-archive 草稿的来源校验降级为提示（草稿是中间态，来源 intent 可能尚未在仓库——B2 落的草稿
-//   在 intent done 前生成，此时断链属预期），不进 problems。
-// 注意：activeTree 只含活跃主题目录（drafts-archive 在枚举处被排除），草稿须另行扫描归档树。
-const fmGet = (text, key) => {
-  const m = text.match(/^---\r?\n([\s\S]*?)\r?\n---/);
-  if (!m) return null;
-  const kv = m[1].split(/\r?\n/).map((l) => l.match(/^(\S+):\s*(.*)$/)).find((x) => x && x[1] === key);
-  return kv ? kv[2].trim() : null;
-};
-let brokenSources = 0;
-const checkSource = (f, isDraft) => {
-  let text;
-  try { text = fs.readFileSync(path.join(WIKI, f), 'utf8'); } catch { return; }
-  const src = fmGet(text, '来源');
-  if (!src) return;
-  if (fs.existsSync(src)) return;
-  if (isDraft) notes.push(`草稿 ${f} 来源未落地（草稿中间态，归类前允许）：${src}`);
-  else { problems.push(`来源断链：${f} frontmatter「来源: ${src}」指向的文件不存在`); brokenSources++; }
-};
-for (const f of activeTree.files) {
-  if (!/\.(md|html)$/i.test(f)) continue;
-  checkSource(f, false);
-}
-if (fs.existsSync(ARCHIVE_DIR)) {
-  for (const f of walkTree(ARCHIVE_DIR).files) {
-    if (!/\.(md|html)$/i.test(f)) continue;
-    checkSource(`drafts-archive/${f}`, true);
-  }
-}
-if (brokenSources === 0) notes.push('来源血缘有效：活跃层 wiki 文件的「来源」均指向存在的 workflow 归档');
-
-// ---- 输出 ----
-for (const n of notes) console.log('ℹ️  ' + n);
-if (problems.length) {
-  console.error('\n❌ wiki 一致性校验失败：');
-  for (const p of problems) console.error('  - ' + p);
-  process.exit(1);
-}
-console.log(`✅ wiki 三方一致：文件 ${diskFiles.size} 份 / 主题 ${DATA.topics.length} 个（含占位）/ 归档 ${archiveCount} 份`);

package/templates/_agents/scripts/verify-wiki-consistency.test.mjs

@@ -1,123 +0,0 @@
-// verify-wiki-consistency.test.mjs — wiki 三方一致性验证（2026-10-09 engine-quality-round2 A2 补测）
-// 此前 exempt 表登记「无覆盖」——本套件补齐后移出豁免。三场景：三方一致（绿）/ 磁盘多文件未登记（红）/
-// drafts-archive 协议目录缺失（红）。脚本自足（仅 node 标准库 + cwd 相对读 wiki/），fixture 子进程跑真脚本。
-import fs from 'node:fs';
-import path from 'node:path';
-import os from 'node:os';
-import { spawnSync } from 'node:child_process';
-import { fileURLToPath } from 'node:url';
-
-const SRC = path.dirname(fileURLToPath(import.meta.url));
-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}` : ''}`); }
-};
-
-function mkWiki({ extraDiskFile = false, noArchive = false, draftSource = null } = {}) {
-  const fx = fs.mkdtempSync(path.join(os.tmpdir(), 'vwc-'));
-  fs.mkdirSync(path.join(fx, 'wiki', '主题A'), { recursive: true });
-  fs.writeFileSync(path.join(fx, 'wiki', '主题A', '文档1.md'), '# 文档1\n\n无外链。\n');
-  if (extraDiskFile) fs.writeFileSync(path.join(fx, 'wiki', '主题A', '文档2.md'), '# 文档2\n');
-  let archiveCount = 0;
-  if (!noArchive) fs.mkdirSync(path.join(fx, 'wiki', 'drafts-archive'), { recursive: true });
-  if (draftSource) { // B2 落的草稿形态：drafts-archive/<日期-主题>/ 下带来源 frontmatter
-    fs.mkdirSync(path.join(fx, 'wiki', 'drafts-archive', '2026-09-12-主题'), { recursive: true });
-    fs.writeFileSync(path.join(fx, 'wiki', 'drafts-archive', '2026-09-12-主题', '草稿.md'),
-      `---\n来源: ${draftSource}\n---\n# 草稿\n`);
-    archiveCount = 1;
-  }
-  fs.writeFileSync(path.join(fx, 'wiki', 'INDEX.md'), [
-    '# Wiki 索引',
-    '',
-    '## 主题目录速览',
-    '',
-    '| 主题 | 文件数 | 用途 |',
-    '|---|---|---|',
-    '| 主题A | 1 | 测试主题 |',
-    '',
-    '## 映射表',
-    '',
-    '| 文件 | 用途 | 路径 |',
-    '|---|---|---|',
-    '| 文档1.md | 测试 | wiki/主题A/文档1.md |',
-    '',
-    `合计：**1 份**知识文档，**1 个主题**`,
-    '',
-  ].join('\n'));
-  const DATA = {
-    topics: [{ name: '主题A', files: [{ file: '文档1.md', dir: '主题A' }] }],
-    summary: { total: 1, files: 1, topics: 1, archive: archiveCount },
-  };
-  fs.writeFileSync(path.join(fx, 'wiki', '知识沉淀总览.html'),
-    '<!doctype html><script>\nconst DATA = ' + JSON.stringify(DATA, null, 2) + ';\n</script>\n');
-  return fx;
-}
-
-const run = (fx) => spawnSync(process.execPath, [path.join(SRC, 'verify-wiki-consistency.mjs')], {
-  cwd: fx, encoding: 'utf8',
-});
-
-{
-  // ① 三方一致 → exit 0
-  const fx = mkWiki();
-  const r = run(fx);
-  check('① 三方一致 → exit 0', r.status === 0, `status=${r.status}\n${(r.stdout || '') + (r.stderr || '')}`.slice(0, 500));
-  fs.rmSync(fx, { recursive: true, force: true });
-}
-{
-  // ② 磁盘多文件未登记 → exit 1（合计行 fail-loud 最先拦——INDEX 合计 1 份 vs 磁盘 2 份；
-  //   该检查在脚本内先于三方文件比对出账，是同问题的合法拦截路径）
-  const fx = mkWiki({ extraDiskFile: true });
-  const r = run(fx);
-  const out = (r.stdout || '') + (r.stderr || '');
-  check('② 磁盘多文件未登记 → exit 1 且合计行拦（INDEX 1 份 vs 磁盘 2 份）',
-    r.status === 1 && out.includes('INDEX 合计行与磁盘不一致'), `status=${r.status}\n${out.slice(0, 500)}`);
-  fs.rmSync(fx, { recursive: true, force: true });
-}
-{
-  // ③ drafts-archive 协议目录缺失 → exit 1（门禁明示失败而非崩栈，2026-09-24 口径）
-  const fx = mkWiki({ noArchive: true });
-  const r = run(fx);
-  const out = (r.stdout || '') + (r.stderr || '');
-  check('③ drafts-archive 缺失 → exit 1 且明示', r.status === 1 && out.includes('drafts-archive'), `status=${r.status}\n${out.slice(0, 400)}`);
-  fs.rmSync(fx, { recursive: true, force: true });
-}
-
-// ---- ④⑤⑥ 来源血缘校验（B3，2026-10-10，第 9 项）----
-{
-  // ④ 活跃层来源断链 → exit 1
-  const fx = mkWiki();
-  fs.writeFileSync(path.join(fx, 'wiki', '主题A', '文档1.md'),
-    '---\n来源: workflow/intents/2026-09-12-不存在.md\n---\n# 文档1\n\n无外链。\n');
-  const r = run(fx);
-  const out = (r.stdout || '') + (r.stderr || '');
-  check('④ 活跃层来源断链 → exit 1 且点名断链',
-    r.status === 1 && out.includes('来源断链') && out.includes('不存在.md'), `status=${r.status}\n${out.slice(0, 500)}`);
-  fs.rmSync(fx, { recursive: true, force: true });
-}
-{
-  // ⑤ 活跃层来源指向存在的文件 → exit 0 且血缘有效提示
-  const fx = mkWiki();
-  fs.writeFileSync(path.join(fx, 'wiki', '主题A', '文档1.md'),
-    '---\n来源: workflow/intents/2026-09-12-真单.md\n---\n# 文档1\n\n无外链。\n');
-  fs.mkdirSync(path.join(fx, 'workflow', 'intents'), { recursive: true });
-  fs.writeFileSync(path.join(fx, 'workflow', 'intents', '2026-09-12-真单.md'), '# INTENT\n');
-  const r = run(fx);
-  const out = (r.stdout || '') + (r.stderr || '');
-  check('⑤ 活跃层来源有效 → exit 0 且提示血缘有效',
-    r.status === 0 && out.includes('来源血缘有效'), `status=${r.status}\n${out.slice(0, 500)}`);
-  fs.rmSync(fx, { recursive: true, force: true });
-}
-{
-  // ⑥ 草稿来源未落地 → 仅提示不阻断（草稿中间态，归类前允许）
-  const fx = mkWiki({ draftSource: 'workflow/incidents/2026-09-12-未闭环.md' });
-  const r = run(fx);
-  const out = (r.stdout || '') + (r.stderr || '');
-  check('⑥ 草稿来源未落地 → exit 0 且降级提示（不阻断）',
-    r.status === 0 && out.includes('草稿中间态'), `status=${r.status}\n${out.slice(0, 500)}`);
-  fs.rmSync(fx, { recursive: true, force: true });
-}
-
-console.log(`\n合计: PASS ${pass} / FAIL ${fail}`);
-process.exit(fail ? 1 : 0);