agentic-flow-kit 1.8.7 → 2.1.0

package/templates/_agents/scripts/check-metric-claims.mjs

@@ -1,277 +0,0 @@
-#!/usr/bin/env node
-// check-metric-claims — 检查 16「量化断言指标签名对账」实现（2026-09-28 claim-exceeds-fix 引入；
-// 2026-09-28 check16-inline-debt 自 check-loop.mjs 原内联块迁出为独立模块——检查 16 自带三层子结构
-// （登记表解析 / 装户取数器载入 / 签名扫描），内联时与检查 1-15 的主扫描流搅在同一文件；
-// 迁出后 check-loop 只留判据摘要 + ctx 组装 + 调用，判据语义 / 消息文案 / exit 语义零变化）。
-// 判据（与 check-loop.mjs 头部检查项清单 16 同源）：
-//   活跃态文档（draft/approved/open）中的 `{{指标名}}`（小写点分）签名须替换为实时值，留签名=未回填=warning；
-//   只查显式签名、不全文扫数字（历史叙述假阳性恒 0）；未登记签名 / 取数器缺失 → fail-loud 出账；
-//   登记表缺失 → 静默跳过（未启用该检查的装户零噪声）；装户自有指标走 .agents/metric-derivers.cjs（CJS 契约，内置优先）。
-// 契约：runCheck16(ctx) 由 check-loop.mjs 调用（调用位置在检查 15 之后——warnings 按插入序输出，
-//   位置变化会改变输出行序）；ctx 显式携带本检查引用的外层符号（以代码实际引用集为准）：
-//   ROOT / ENUMS / docFiles / fmGet / inSet / isTracked / linesOf / readdirOrNull / warnings。
-//   不隐式读 check-loop 闭包——迁出前后行为逐字节一致（check-loop 全量输出 diff 基线验证）。
-//   docFiles / isTracked 使扫描面与取数面和检查 1-15 同口径（tracked 过滤链单源定义于 check-loop.mjs docFiles）。
-// 本文件只 import node:* 内置模块（无同目录依赖；先例：check-loop.mjs import 同目录 workflow-enums.mjs）。
-// 测试：node templates/_agents/scripts/check-loop.test.mjs（黑盒跑整脚本，场景组「检查 16」）
-import fs from 'node:fs';
-import path from 'node:path';
-import { createRequire } from 'node:module';
-import { readLedgerLines } from './ledger-loader.mjs';
-
-export function runCheck16(ctx) {
-  const { ROOT, ENUMS, docFiles, fmGet, inSet, isTracked, linesOf, readdirOrNull, warnings } = ctx;
-  const mcFile = path.join(ROOT, '.agents', 'metric-claims.txt');
-  if (fs.existsSync(mcFile)) {
-    const ledgerLines = () => {
-      // 读法收敛 ledger-loader（2026-10-12 ledger-loader-p1）：本指标按**原始文本行**计数
-      // （total / 含 "batch" 字段的行数），故用 lines 视图而非 rows 视图。
-      const ls = readLedgerLines(ROOT);
-      return { total: ls.length, withBatch: ls.filter((l) => /"batch"/.test(l)).length };
-    };
-    // 内置取数器：全部本地确定性、零网络。**装户零配置即用**（不依赖任何装户文件）。
-    // **取数与扫描面同口径（复核 P2；2026-09-28 check16-inline-debt 起单源化）**：文档扫描与取数统计
-    //   统一走 ctx.docFiles()——过滤链（.md ∧ 数字前缀 ∧ tracked）全仓唯一定义于 check-loop.mjs 的
-    //   docFiles，本文件不再自持 countDocs 复刻。首版独立 readdir 数盘面曾把并行会话的**未跟踪**新档
-    //   算进取数（盘面 60 / HEAD 59），令「签名填对了」却是别的读者复现不出的数；单源后
-    //   「扫描看得到的文档集 == 取数统计的文档集」由构造保证，口径漂移在编译期即不可能。
-    const derivers = {
-      'ledger.lines': () => ledgerLines().total,
-      'ledger.linesWithBatch': () => ledgerLines().withBatch,
-      'ledger.linesWithoutBatch': () => ledgerLines().total - ledgerLines().withBatch,
-      'docs.count.intents': () => docFiles('intents').length,
-      'docs.count.specs': () => docFiles('specs').length,
-      'docs.count.plans': () => docFiles('plans').length,
-      'docs.count.incidents': () => docFiles('incidents').length,
-      'docs.count.all': () => docFiles('intents').length + docFiles('specs').length + docFiles('plans').length + docFiles('incidents').length,
-    };
-    // ---- 装户侧取数器（2026-09-28 adopter-derivers；修「owned 登记表配 managed 取数器」P1）----
-    // 背景：登记表是 owned（装户自增指标），取数器却曾硬编码在本文件（managed）——装户一新增指标
-    // 就报「无取数器」，唯一出路是改本文件，而那是 managed：sync 永久报「本地已改」+ doctor WARN
-    // + 本脚本因供应链防线**跳过执行**（门禁静默停摆）。故改为分层：
-    //   ① 内置优先（行为与今完全一致，装户零配置可用）；② 未命中则查装户模块 `.agents/metric-derivers.cjs`
-    // **必须是 CJS（`.cjs` + module.exports）**（2026-09-28 跨版本实测修正）：
-    //   首版约定 `.mjs` 并用 `createRequire` 载入，在 Node v24.12 上实测可用（**故本机没暴露问题**）；
-    //   但跨版本实测（真下 18.20.5 / 20.18.0 / 22.11.0 二进制跑）**三者全部 `ERR_REQUIRE_ESM`**——
-    //   `require(esm)` 只在 Node ≥20.19 / ≥22.12 默认可用，Node 18 从未支持。而本仓 engines 写
-    //   `>=18.0.0`、CI 矩阵跑 18/22 → **装户取数功能在 CI 目标版本上完全不可用**（fail-loud 正常、
-    //   不崩，但功能不工作）。故改用 CJS：`createRequire` 载入 `.cjs` 在 18/20/22/24 全线可用，
-    //   且**仍是同步**（无须把本脚本改成 async 主线）。契约要求同步函数也与本检查「零网络、
-    //   本地确定性」的前提一致（异步的唯一真实收益是网络/并发 IO，此处都不允许）。
-    // **失败一律响亮、绝不静默降级**（沿 claim-exceeds-fix「假绿比红危险」与本检查自身语法错教训）：
-    // 若载入失败就「只用内置指标」，装户会看到「引用了 my.metric → 未登记」，看起来像**自己忘了登记**，
-    // 而真因是模块坏了——他会去 registry 反复核对，问题永远查不到。故载入/调用失败均出明确 WARN。
-    const adopterModRel = '.agents/metric-derivers.cjs';
-    // 旧路径（首版 .mjs）：若存在则**明确提示已改用 .cjs**，避免装户对着「无取数器」查不出所以然
-    const adopterLegacyRel = '.agents/metric-derivers.mjs';
-    let adopterState = null; // { ok:true, derivers } | { ok:false, errors:[...] } —— 懒载入 + 单次运行内缓存
-    const loadAdopterDerivers = () => {
-      if (adopterState) return adopterState;
-      const abs = path.join(ROOT, adopterModRel);
-      if (!fs.existsSync(abs)) {
-        // 常见误写：仍用首版的 .mjs 路径 → 给出可操作的迁移指引（而非任其对着「无取数器」猜）
-        if (fs.existsSync(path.join(ROOT, adopterLegacyRel))) {
-          adopterState = {
-            ok: false,
-            errors: [`${adopterModRel} 不存在，但发现旧版路径 ${adopterLegacyRel}——该路径已于 2026-09-28 弃用（\`require(esm)\` 在 Node 18/22 不可用，实测 ERR_REQUIRE_ESM）。请改名为 ${adopterModRel} 并把写法改为 CommonJS：\`module.exports = { derivers: { ... } }\``],
-          };
-          return adopterState;
-        }
-        adopterState = { ok: true, derivers: {} }; // 缺失=正常态，零告警
-        return adopterState;
-      }
-      try {
-        const req = createRequire(import.meta.url);
-        const mod = req(abs);
-        // CJS / ESM 双兼容取导出：CJS 走 module.exports.derivers；若装户误用了 ESM 语法而环境恰好
-        // 支持（新 Node 的 require(esm)），default 里也可能挂 derivers——两处都认，避免假阴性。
-        const d = (mod && mod.derivers) || (mod && mod.default && mod.default.derivers);
-        if (!d || typeof d !== 'object' || Array.isArray(d)) {
-          adopterState = { ok: false, errors: [`${adopterModRel} 未导出 \`derivers\` 对象（实际导出形态：${d === undefined ? '无 derivers 键' : Array.isArray(d) ? 'array' : typeof d}）——载入失败不降级，请用 \`module.exports = { derivers: { ... } }\``] };
-          return adopterState;
-        }
-        adopterState = { ok: true, derivers: d };
-      } catch (e) {
-        const hint = /ERR_REQUIRE_ESM/.test(String(e && e.code)) ? `（该错误表示模块被当成了 ESM——本契约要求 CommonJS：文件后缀 .cjs 且用 \`module.exports = { derivers: {...} }\`）` : '';
-        adopterState = { ok: false, errors: [`${adopterModRel} 载入失败：${String(e && e.message ? e.message : e).split('\n')[0]}${hint}——载入失败不降级（静默降级会让你误以为「忘了登记」而非「模块坏了」）`] };
-      }
-      return adopterState;
-    };
-    // deriverCtx：注入给装户取数器的同步辅助（免其重复造轮子；2026-09-28 check16-inline-debt 迁出时
-    // 自 `ctx` 改名——runCheck16 的参数 ctx 已被外层符号注入契约占用，避免遮蔽混淆）
-    // **glob 逐字符转义**（自查修正）：首版用「先整体转义特殊字符、再 replace 星号」的写法，
-    // 实测 `src/**/*.ts` 匹配不到 `src/a/b/c.ts`、「**/*.md」匹配不到 `a/b/c.md`——因为 `**/`
-    // 在被替换前已被字符类转义破坏。改为逐字符状态机，语义明确：
-    //   `**/` → 任意层级（含零层）；`**` → 任意（可跨 /）；`*` → 段内任意（不跨 /）；`?` → 段内单字符
-    //   其余一律字面转义（故 `a.b.sql` 的点是字面点、`[`/`{` 也按字面处理——本 helper 不承诺
-    //   字符类 / 花括号展开，避免装户误以为支持完整 glob 语法；不支持即按字面匹配，行为可预测）
-    const globToRegExp = (p) => {
-      const s = String(p);
-      let re = '';
-      for (let i = 0; i < s.length; i++) {
-        const c = s[i];
-        if (c === '*' && s[i + 1] === '*') {
-          if (s[i + 2] === '/') { re += '(?:.*/)?'; i += 2; } // `**/` 含零层
-          else { re += '.*'; i += 1; }                        // `**` 跨段
-        } else if (c === '*') re += '[^/]*';
-        else if (c === '?') re += '[^/]';
-        else re += c.replace(/[.+^${}()|[\]\\]/, '\\$&');
-      }
-      return new RegExp('^' + re + '$');
-    };
-    // 遍历时**跳过重目录 + 防环**（自查 + 复核 P2 修正）：
-    // · 剪枝 node_modules / .git / cache——无剪枝时 `deriverCtx.glob('**/*')` 会走进依赖树，既慢又会把
-    //   依赖文件算进取数（对「我项目有多少个 X」是错的数）。
-    // · **visited 集合防环**：复核实测软链接/junction 成环时递归到 depth 128、同一文件重复 64 份
-    //   才被 statSync 的 ELOOP 拦下；POSIX 无 MAX_PATH 时该递归无界。故按**真实路径**去重。
-    const WALK_SKIP = new Set(['node_modules', '.git', 'cache']);
-    const walkFiles = (dir, out = [], rel = '', visited = new Set()) => {
-      let real = dir;
-      try { real = fs.realpathSync(dir); } catch { /* 不可解析则按原路径处理 */ }
-      if (visited.has(real)) return out; // 环 → 剪枝
-      visited.add(real);
-      for (const e of readdirOrNull(dir) || []) {
-        if (WALK_SKIP.has(e)) continue;
-        const abs = path.join(dir, e);
-        const r = rel ? `${rel}/${e}` : e;
-        let st = null;
-        try { st = fs.statSync(abs); } catch { continue; }
-        if (st.isDirectory()) walkFiles(abs, out, r, visited);
-        else out.push(r);
-      }
-      return out;
-    };
-    const deriverCtx = {
-      root: ROOT,
-      read: (rel) => { try { return fs.readFileSync(path.join(ROOT, rel), 'utf8').replace(/\r\n/g, '\n'); } catch { return ''; } },
-      glob: (pattern) => { const re = globToRegExp(pattern); return walkFiles(ROOT).filter((r) => re.test(r)); },
-      countFiles: (dir, pred) => walkFiles(path.join(ROOT, dir)).filter((r) => (typeof pred === 'function' ? pred(r) : true)).length,
-    };
-    // resolveDeriver(name) → { fn } | { error }（**绝不抛出**：引擎不因装户代码崩溃）
-    const resolveDeriver = (name) => {
-      if (derivers[name]) return { fn: derivers[name], builtin: true };
-      const st = loadAdopterDerivers();
-      if (!st.ok) return { error: st.errors.join('；') };
-      const fn = st.derivers[name];
-      if (typeof fn !== 'function') {
-        if (fn !== undefined) return { error: `${adopterModRel} 的「${name}」不是函数（实际类型：${typeof fn}）` };
-        return { error: `无对应取数器——内置 8 个指标均不含该名，${adopterModRel} 亦未定义（登记了却没实现＝其实没查）` };
-      }
-      return { fn, builtin: false };
-    };
-    // 装户模块载入失败：**独立成条**（2026-09-28 adopter-derivers）。
-    // 关键设计（真绿 vs 假绿的分界）：载入失败若只表现为「该指标无取数器」，装户会看到
-    // 「引用了 my.metric → 未登记」，看起来像**自己忘了登记**，而真因是模块坏了——他会去 registry
-    // 反复核对，永远查不到。故此处单独出一条，明示文件与错误，与「真的没登记」可区分。
-    //
-    // **仅在真的需要装户指标时才报**（复核 P2 更正）：首版在解析登记表前无条件出账——若登记表只有
-    // 内置指标、而装户留了个半成品模块（或模块坏掉但没人用），会平白多一条不可消除的 advisory。
-    // 沿本仓红线「无判定依据的行不产出噪声」：先看登记表是否真的有**非内置**指标，再决定报不报。
-    const mcLines = (linesOf(mcFile) || []).map((l) => l.trim()).filter((l) => l && !l.startsWith('#'));
-    const hasAdopterMetric = mcLines.some((l) => {
-      const mm = /^([A-Za-z][\w.]*)\s*=\s*([A-Za-z][\w.]*)$/.exec(l);
-      return mm && !derivers[mm[1]];
-    });
-    const adopterLoad = loadAdopterDerivers();
-    if (!adopterLoad.ok && hasAdopterMetric) {
-      for (const e of adopterLoad.errors) warnings.push(`- [WARN 装户取数器载入失败] ${e}`);
-    }
-    // 解析登记表：`<指标名> = <取数表达式>`（表达式须与指标名同形，二者不一致即登记笔误）
-    const declared = new Map();
-    const precedenceWarned = new Set(); // 同名 advisory 按指标去重（复核 P2 更正：首版按行重复出账）
-    for (const line of mcLines) {
-      const m = /^([A-Za-z][\w.]*)\s*=\s*([A-Za-z][\w.]*)$/.exec(line);
-      if (!m) { warnings.push(`- [WARN 指标登记] .agents/metric-claims.txt 行格式非法（应为 \`指标名 = 取数表达式\`）：${line}`); continue; }
-      if (m[1] !== m[2]) { warnings.push(`- [WARN 指标登记] 登记名与取数表达式不一致：${m[1]} ≠ ${m[2]}`); continue; }
-      const r = resolveDeriver(m[1]);
-      if (r.error) {
-        // 无取数器（内置无 + 装户模块无同名）或装户模块载入失败 → 明示可操作方向
-        const hint = adopterLoad.ok
-          ? `若为项目自有指标，请在 ${adopterModRel} 的 derivers 中实现（契约见 .agents/metric-claims.txt 头部）`
-          : `且 ${adopterModRel} 载入失败（见上方「装户取数器载入失败」条目——**这不是「忘了登记」**）`;
-        warnings.push(`- [WARN 指标登记] 指标「${m[1]}」无对应取数器（fail-loud：登记了却没实现＝其实没查）——内置 8 指标不含该名，${hint}`);
-        // **不 continue**：该指标在 registry 里确实登记过，故仍计入 declared——
-        // 否则引用它的文档会被误报为「未登记」（把「模块坏了」伪装成「忘了登记」，正是本单要防的假绿）。
-        // 取数失败在扫描阶段以「指标取数失败」单独出账，两条信息不互相掩盖。
-      } else if (r.builtin && adopterLoad.ok && typeof adopterLoad.derivers[m[1]] === 'function' && !precedenceWarned.has(m[1])) {
-        // 内置与装户同名：内置优先（保持本仓/存量行为稳定），并明示装户定义被忽略（**按指标去重**）
-        precedenceWarned.add(m[1]);
-        warnings.push(`- [WARN 指标登记] 指标「${m[1]}」由引擎内置提供，${adopterModRel} 中的同名定义**被忽略**（内置优先）——如需改用自有实现，请换一个指标名`);
-      }
-      declared.set(m[1], true);
-    }
-    // 扫活跃态文档（沿检查 4 现有尺度：终态件的历史数字是历史叙述，不扫）。
-    // tracked-only 口径（2026-09-28 check16-inline-debt T2，与检查 1-15 统一）：
-    //   子目录走 ctx.docFiles(sub)——过滤链（.md ∧ 数字前缀 ∧ tracked）全仓唯一处定义，首版独立
-    //   readdir 扫描不含 tracked 过滤，会把并行会话的**未跟踪**半成品也拖进对账面（别人的草稿不该
-    //   拦我的 push——沿仓库模式「只扫已提交(HEAD)内容」总口径）；
-    //   根级 workflow/*.md 滤 .md ∧ tracked（无数字前缀约束——README/INDEX/delegations 等本无前缀，
-    //   维持现状；根级本无 _TEMPLATE，无需显式排除）。
-    const activeSet16 = (sub) => (sub === 'incidents' ? ENUMS['incident.status.active'] : ENUMS['doc.status.active']);
-    const scanFiles16 = [];
-    for (const sub of ['intents', 'specs', 'plans', 'incidents']) {
-      for (const abs of docFiles(sub)) {
-        if (!inSet(fmGet(abs, '状态'), activeSet16(sub))) continue;
-        scanFiles16.push({ rel: path.relative(ROOT, abs).split(path.sep).join('/'), abs });
-      }
-    }
-    for (const f of readdirOrNull(path.join(ROOT, 'workflow')) || []) {
-      const abs = path.join(ROOT, 'workflow', f);
-      if (f.endsWith('.md') && isTracked(abs)) scanFiles16.push({ rel: `workflow/${f}`, abs });
-    }
-    for (const { rel, abs } of scanFiles16) {
-      const ls = linesOf(abs) || [];
-      ls.forEach((line, i) => {
-        // 签名形态收窄为**小写点分**（如 `{{ledger.lines}}`）：装户模板占位符是全大写 SCREAMING_CASE
-        // （构建命令 / 看板端口 / 项目名三类，由 init 渲染替换，非本检查对象）
-        // ——不收窄会对这些合法的模板占位符产生大量假阳性（实测：本仓 plans 内 11 处）。
-        // **转义（2026-09-28，本检查在自己的文档上抓到该需求）**：讲语法 / 举例 / 引用告警原文的
-        // 文档在签名前加反斜杠（`\{{ledger.lines}}`）表示「此处是示意、非断言」——否则本检查
-        // 会把「文档在教怎么用签名」误判为「作者忘了回填」。选显式转义而非「同句含『如/例』等标记词
-        // 即豁免」的启发式：后者会按措辞松紧漂移，且作者能无意中触发豁免而漏过真断言。
-        // **转义按「逐个出现」生效、不按整行**（复核自查 P1 更正）：首版实现是「行内出现任一 `\{{`
-        // 即整行跳过」，实测可被这样藏住真断言——`… \{{a.b}} 示意… {{ledger.lines}} 未回填` 整行静默
-        // 放过。故改为用带后顾的否匹配排除转义位，同行的真签名照常出账。
-        for (const m of line.matchAll(/(?<!\\)\{\{([a-z][a-z0-9]*(?:\.[a-z0-9]+)+)\}\}/g)) {
-          const name = m[1];
-          if (!declared.has(name)) {
-            warnings.push(`- [WARN 指标未登记] ${rel}:${i + 1} 引用 {{${name}}} 但 .agents/metric-claims.txt 未登记该指标（未登记＝无从对账）`);
-            continue;
-          }
-          const r = resolveDeriver(name);
-          if (r.error) {
-            // 取数器不可用（含装户模块载入失败 / 无该名 / 定义非法）——**响亮出账，绝不静默跳过**
-            warnings.push(`- [WARN 指标取数失败] ${rel}:${i + 1} {{${name}}} 无法取数：${r.error}`);
-            continue;
-          }
-          let real;
-          try {
-            real = r.fn(deriverCtx);
-          } catch (e) {
-            warnings.push(`- [WARN 指标取数失败] ${rel}:${i + 1} {{${name}}} 取数器抛异常：${String(e && e.message ? e.message : e).split('\n')[0]}`);
-            continue;
-          }
-          // 返回值必须是有限数字：Promise（误写 async）/ NaN / 字符串 / undefined 一律拦下并明示类型
-          if (typeof real !== 'number' || !Number.isFinite(real)) {
-            const kind = real && typeof real.then === 'function' ? 'Promise（本检查要求**同步**函数，请去掉 async/await）' : `${typeof real}${typeof real === 'number' ? `（${real}）` : ''}`;
-            warnings.push(`- [WARN 指标取数失败] ${rel}:${i + 1} {{${name}}} 取数器返回值不是有限数字：${kind}`);
-            continue;
-          }
-          // 判据：签名**必须**被替换为实时值——留有 `{{...}}` 即视为未回填（写作期占位，关单前须落实）
-          warnings.push(`- [WARN 指标待回填] ${rel}:${i + 1} {{${name}}} 实时值 = ${real}——请把签名替换为该数字（留签名＝未回填）`);
-        }
-        // **形态不符的签名也不静默放过（复核 P2 更正）**：首版只认严格小写点分形态，于是
-        // `{{Ledger.Lines}}` / `{{ ledger.lines }}`（含空格）这类**明显本意是签名**的写法
-        // 既不匹配、也不出账——静默漏过，且绕开了「未登记」的 fail-loud。此处补一道：
-        // 非转义的 `{{...}}` 中，凡**不是**严格形态、且**不是**装户模板占位符（全大写 SCREAMING_CASE）
-        // 的，一律提示形态不符（作者才能立刻发现笔误）。
-        for (const m of line.matchAll(/(?<!\\)\{\{([^{}]+)\}\}/g)) {
-          const raw = m[1];
-          if (/^[a-z][a-z0-9]*(?:\.[a-z0-9]+)+$/.test(raw)) continue; // 严格形态，上面已处理
-          if (/^[A-Z][A-Z0-9_]*$/.test(raw)) continue; // 装户模板占位符（init 渲染对象，非本检查面）
-          warnings.push(`- [WARN 指标形态] ${rel}:${i + 1} \`{{${raw}}}\` 不是合法签名形态（应为小写点分，如 {{ledger.lines}}）——若本意是量化断言，请改正形态；若只是举例，请加反斜杠转义`);
-        }
-      });
-    }
-  }
-}

package/templates/_agents/scripts/check-prejudgment.mjs

@@ -1,64 +0,0 @@
-// check-prejudgment.mjs — 检查 25：路由预判一致性 [warning]（2026-10-13 B6b-2 自 Shipyard.Material
-//   check-loop-sections/s25-prejudgment.mjs 回灌；段体判据逐字对齐，出处沿革留痕在包源仓 git 历史与
-//   CHANGELOG——装户径不引实例路径）
-// 背景（prejudgment-ledger）：类型误路由（修复被当新需求 → 跳过 incident 立项与 kb-search 历史检索）
-// 是路由自动识别的静默盲区；级别判低已有「红线判低」hard 与泳道门兜底，但「入口预判 vs 实际落位」的
-// 偏离本身不可见。本段只做 advisory 比对：frontmatter「预判: kind=<kind> level=<L1|L2|L3>」在场才检——
-// kind 与入口类型不符 / level 与「级别」字段不符 / 词表非法 → WARN，不阻断。
-// kind 语义源 = pipeline-run.mjs KINDS（require/fix/verify/review/deploy）；类型只对 intents(≡require)/
-// incidents(≡fix) 执法——plans/specs 是两道共用件不判类型、只比对级别。
-// 缺字段零告警（存量宽容不回填，不做强制前置）——灰度数据经 judgments.jsonl（WARN 预判* 计数）
-// 月度对账后再议升格，退役/升格阈值由 mechanism-registry §25 行承载。
-// kit 适配（源仓→kit 逐条）：无判据改动。kind 词表沿源仓 s25 等价落——pipeline-run.mjs 的 KINDS 为
-//   模块内常量、无导出（两侧同状），故本文件按源仓同款内联声明 + 注释互引（改任一侧须同步，见下）。
-import path from 'node:path';
-
-export function run(ctx) {
-  const { ROOT, WF, DOC_DIRS, ENUMS, inSet, fmGet, isTracked, readdirOrNull, warnings } = ctx;
-  // --- 25. 路由预判一致性 [warning] ---
-  // kind 词表单源 = pipeline-run.mjs KINDS（该处为模块内常量、未导出——源仓 s25 同款内联等价落）；
-  // 两侧各一份靠本注释互引，改词表须同步（pipeline-run 校验文案 `kind 须为 …` 同步）。
-  const KINDS = ['require', 'fix', 'verify', 'review', 'deploy'];
-  const rankOf = (lv) => Number(String(lv).replace(/^L/, '')) || 0;
-  for (const sub of DOC_DIRS) {
-    const dir = path.join(ROOT, WF, sub);
-    for (const f of readdirOrNull(dir) || []) {
-      if (!f.endsWith('.md') || f === '_TEMPLATE.md') continue;
-      const abs = path.join(dir, f);
-      if (!isTracked(abs)) continue;
-      const pj = fmGet(abs, '预判');
-      if (!pj) continue;
-      const rel = `${WF}/${sub}/${f}`;
-      // 终态文档（2026-10-15）：形态/词表类告警跳过——终态受检查 15 内容绑定不可修订，此类 WARN 永不可
-      // 消（「不可消除噪声」红线）；类型/级别比对保留——那是路由审计的本体信号，灰度对账照常采集。
-      // （终态并集 = doc 终态 done/superseded/cancelled + incident 终态 fixed/closed——两侧枚举无单一键
-      // 覆盖该并集，故与源仓 s25 同款内联声明。）
-      const terminalDoc = ['done', 'superseded', 'cancelled', 'fixed', 'closed'].includes(fmGet(abs, '状态'));
-      const kv = {};
-      for (const m of pj.matchAll(/(kind|level)=([^\s]+)/g)) kv[m[1]] = m[2];
-      if (!Object.keys(kv).length) {
-        if (!terminalDoc) warnings.push(`- [WARN 预判字段不可解析] 须形如「预判: kind=<kind> level=<L1|L2|L3>」:${rel}`);
-        continue;
-      }
-      if (kv.kind && !KINDS.includes(kv.kind) && !terminalDoc) {
-        warnings.push(`- [WARN 预判字段不可解析] kind=${kv.kind} 不在词表（${KINDS.join('/')}）:${rel}`);
-      }
-      if (kv.level && !inSet(kv.level, ENUMS['level.all']) && !terminalDoc) {
-        warnings.push(`- [WARN 预判字段不可解析] level=${kv.level} 不在枚举 level.all:${rel}`);
-      }
-      // 类型比对：intents ≡ require、incidents ≡ fix（plans/specs 两道共用，不判类型）
-      const actualKind = sub === 'incidents' ? 'fix' : sub === 'intents' ? 'require' : null;
-      if (kv.kind && actualKind && kv.kind !== actualKind) {
-        warnings.push(`- [WARN 预判类型不符] 预判 kind=${kv.kind} 但落位 ${sub}（实际 kind=${actualKind}）——类型误路由会跳过对应道的检索与立档，确认是否有意:${rel}`);
-      }
-      // 级别比对：与 frontmatter「级别」字段
-      if (kv.level) {
-        const lv = fmGet(abs, '级别');
-        if (lv && lv !== kv.level) {
-          const hint = rankOf(lv) < rankOf(kv.level) ? '（判低信号——落位低于预判，复核两问判据）' : '（判高——流程偏重，无害）';
-          warnings.push(`- [WARN 预判级别不符] 预判 ${kv.level} 落位 ${lv}${hint}:${rel}`);
-        }
-      }
-    }
-  }
-}

package/templates/_agents/scripts/check-registry.mjs

@@ -1,45 +0,0 @@
-// check-registry.mjs — 检查 22：机制使用量台账 [warning]（2026-10-13 B6b-2 自 Shipyard.Material
-//   check-loop-sections/s22-registry.mjs 回灌；段体判据逐字对齐，出处沿革留痕在包源仓 git 历史与
-//   CHANGELOG——装户径不引实例路径）
-// 背景：门禁只增不减（每道门都有事故背书，但无退役机制）——本检查给「低频机制退役」装强制处置环。
-// .agents/mechanism-registry.md 在场才启用（历史 clone / 装户缺文件 = 跳过，沿 lane-surfaces.txt
-// 「缺失即跳过」惯例，不制造一次性噪声）。表格式 markdown 管道表，列序固定：
-//   | 机制 | 门禁位置 | 触发统计口径 | 退役阈值 | 最近触发 | 状态 | 处置期限 |
-// 判据：状态 ∈ {现役,待退役,已退役}；「待退役」必须填处置期限（日期或批次号）——台账的目的不是记录
-// 而是强制处置：没有时间表的退役意向等于永不变退役。触发计数本身半自动（口径列写明统计方法），
-// 不进机器门——先有账，再谈自动化。纯 WARN advisory，永不 hard（机制未登记/只有示例行都只出账不拦）。
-// kit 适配（源仓→kit 逐条）：台账路径平铺 .agents/config/ → .agents/（kit 装户布局无 config/ 层）。
-import fs from 'node:fs';
-import path from 'node:path';
-
-export function run(ctx) {
-  const { ROOT, linesOf, warnings } = ctx;
-  // --- 22. 机制使用量台账（mechanism-registry；复杂度棘轮的出口）---
-  {
-    const regPath = path.join(ROOT, '.agents', 'mechanism-registry.md');
-    if (fs.existsSync(regPath)) {
-      const dataRows = (linesOf(regPath) || [])
-        .filter((l) => /^\|/.test(l))
-        .filter((l) => !/^\|[\s:|-]+\|?\s*$/.test(l))          // 分隔行
-        .filter((l) => (l.split('|')[1] || '').trim() !== '机制'); // 表头行
-      if (!dataRows.length) {
-        warnings.push('- [WARN 机制台账] 无数据行——表格式：| 机制 | 门禁位置 | 触发统计口径 | 退役阈值 | 最近触发 | 状态 | 处置期限 |');
-      }
-      for (const l of dataRows) {
-        const cells = l.split('|').slice(1, -1).map((c) => c.trim());
-        if (cells.length !== 7) {
-          warnings.push(`- [WARN 机制台账] 行列数 ${cells.length} ≠ 7（机制|门禁位置|触发统计口径|退役阈值|最近触发|状态|处置期限）:${cells[0] || l.slice(0, 30)}`);
-          continue;
-        }
-        const [name, , , , , status, deadline] = cells;
-        if (!['现役', '待退役', '已退役'].includes(status)) {
-          warnings.push(`- [WARN 机制台账] 「${name}」状态非法（须 现役/待退役/已退役）:${status}`);
-          continue;
-        }
-        if (status === '待退役' && !deadline) {
-          warnings.push(`- [WARN 机制台账] 「${name}」待退役但缺处置期限——补时间表，或改回现役并在阈值列写保留理由`);
-        }
-      }
-    }
-  }
-}

package/templates/_agents/scripts/check-scope.mjs

@@ -1,96 +0,0 @@
-#!/usr/bin/env node
-// check-scope.mjs — plan 改动面 ↔ git 变更双向对账（advisory 工具；2026-10-13 自 Shipyard.Material
-//   参考实现回灌，源仓沿革留痕在包源仓 git 历史与 CHANGELOG——装户径不引实例路径）
-// 用途：解析 plan「改动面 / 任务拆解 / 改动方案」节声明的文件清单，与 git 变更集对账——
-//   越界件（改了未声明）= 范围蔓延信号；未落件（声明未改）= plan 滞后或改名信号。check-loop 检查 8
-//   的证据对账只做单向交集（提交须触及至少一个声明文件），夹带 plan 外文件不报——本件补越界方向。
-// 语义与红线：只读裁决（判红绿，不改任何状态——命名规约 check- 前缀）；默认 advisory（exit 0 出报告），
-//   --strict 时越界件非空 exit 1（供门禁化调用方使用）；plan 不可读 exit 2（fail-loud，不静默放行）。
-//   文件匹配沿 check-loop 检查 8 宽松规则（f===df / 后缀 / 双向 includes）——声明粒度粗（写目录或部分路径）
-//   不误报越界；白名单豁免：workflow/ 台账（intents/specs/plans/incidents/INDEX）、.agents/confirmations.jsonl、
-//   .agents/confirmations.d/ 分片、package-lock.json——闭环随行件不算越界。
-// 测试：node .agents/scripts/check-scope.test.mjs（tmp git 仓 fixture：越界 / 未落 / 白名单 / strict / 无 plan）
-// 用法：node .agents/scripts/check-scope.mjs workflow/plans/<name>.md [--base <sha>|--staged] [--strict] [--root <dir>]
-//   默认比对工作区（含未跟踪，git status --porcelain 口径）；--base <sha> 比对 sha..HEAD 已提交变更；
-//   --staged 仅比对暂存区。
-import fs from 'node:fs';
-import path from 'node:path';
-import { spawnSync } from 'node:child_process';
-
-const args = process.argv.slice(2);
-let planRel = '', base = '', staged = false, strict = false, rootArg = '';
-for (let i = 0; i < args.length; i++) {
-  const a = args[i];
-  if (a === '--base') base = args[++i] || '';
-  else if (a === '--staged') staged = true;
-  else if (a === '--strict') strict = true;
-  else if (a === '--root') rootArg = args[++i] || '';
-  else if (!planRel && !a.startsWith('--')) planRel = a;
-}
-const ROOT = path.resolve(rootArg || process.cwd());
-if (!planRel) { console.error('用法: node .agents/scripts/check-scope.mjs workflow/plans/<name>.md [--base <sha>|--staged] [--strict] [--root <dir>]'); process.exit(2); }
-const planAbs = path.isAbsolute(planRel) ? planRel : path.join(ROOT, planRel);
-if (!fs.existsSync(planAbs)) { console.error(`plan 不可读: ${planRel}`); process.exit(2); }
-
-// 声明文件提取——与 check-loop 检查 8 同节同正则（改动面|任务拆解|改动方案），另加扩展名白名单
-// （过滤 v1.2.2 之类版本号伪 token：无目录且扩展名不在清单内则弃）
-const KNOWN_EXT = new Set(['.md', '.mjs', '.js', '.ts', '.json', '.txt', '.cs', '.csproj', '.sln', '.vue', '.ps1', '.sh', '.yml', '.yaml', '.sql', '.cjs']);
-const declared = [];
-{
-  const lines = fs.readFileSync(planAbs, 'utf8').split(/\r?\n/);
-  let inSec = false;
-  for (const line of lines) {
-    if (/^##\s+(改动面|任务拆解|改动方案)/.test(line)) { inSec = true; continue; }
-    if (inSec && /^##\s+/.test(line)) { inSec = false; continue; }
-    if (!inSec) continue;
-    const m = line.match(/([a-zA-Z0-9._/-]+\.[a-zA-Z0-9]+)/);
-    if (!m) continue;
-    const tok = m[1].replace(/\\/g, '/');
-    const ext = tok.slice(tok.lastIndexOf('.'));
-    if (tok.includes('/') || KNOWN_EXT.has(ext.toLowerCase())) declared.push(tok);
-  }
-}
-
-const git = (gitArgs, opts = {}) => spawnSync('git', gitArgs, { cwd: ROOT, encoding: 'utf8', maxBuffer: 16 * 1024 * 1024, ...opts });
-let changed = [];
-if (base) {
-  const r = git(['diff', '--name-only', `${base}..HEAD`]);
-  if (r.status !== 0) { console.error(`git diff 失败: ${r.stderr}`); process.exit(2); }
-  changed = r.stdout.split(/\r?\n/).filter(Boolean);
-} else if (staged) {
-  const r = git(['diff', '--name-only', '--cached']);
-  if (r.status !== 0) { console.error(`git diff 失败: ${r.stderr}`); process.exit(2); }
-  changed = r.stdout.split(/\r?\n/).filter(Boolean);
-} else {
-  // 工作区口径：status --porcelain -uall（含未跟踪且逐文件展开——默认折叠成 `?? dir/` 会把整个新目录误判越界）
-  const r = git(['status', '--porcelain', '-uall']);
-  if (r.status !== 0) { console.error(`git status 失败: ${r.stderr}`); process.exit(2); }
-  changed = r.stdout.split(/\r?\n/).filter(Boolean).map((l) => {
-    const body = l.slice(3);
-    const ren = body.match(/.* -> (.*)$/); // 重命名取新路径
-    return (ren ? ren[1] : body).trim().replace(/^"(.*)"$/, '$1');
-  });
-}
-
-const WHITELIST_RE = /^(?:workflow\/(?:intents|specs|plans|incidents)\/|workflow\/INDEX\.md$|\.agents\/confirmations\.jsonl$|\.agents\/confirmations\.d\/|package-lock\.json$)/;
-const norm = (p) => p.replace(/\\/g, '/');
-const matches = (f, df) => f === df || f.endsWith(`/${df}`) || f.includes(df) || df.includes(f);
-
-const outOfScope = changed.filter((f) => !WHITELIST_RE.test(norm(f)) && !declared.some((df) => matches(norm(f), df)));
-const notLanded = declared.filter((df) => !changed.some((f) => matches(norm(f), df)));
-
-console.log(`▶ check-scope（plan 改动面 ↔ git 变更对账）: ${planRel}`);
-console.log(`  声明 ${declared.length} ｜ 变更 ${changed.length}${base ? `（${base}..HEAD）` : staged ? '（staged）' : '（工作区）'}`);
-if (outOfScope.length) {
-  console.log('  越界件（改了未声明）:');
-  outOfScope.forEach((f) => console.log(`    - ${f}`));
-}
-if (notLanded.length) {
-  console.log('  未落件（声明未变更）:');
-  notLanded.forEach((f) => console.log(`    - ${f}`));
-}
-if (!outOfScope.length && !notLanded.length) console.log('  双向对齐 ✅');
-else if (!strict) console.log('  （advisory 报告——--strict 时越界件即 fail）');
-
-if (strict && outOfScope.length) process.exit(1);
-process.exit(0);

package/templates/_agents/scripts/check-scope.test.mjs

@@ -1,99 +0,0 @@
-// check-scope.test.mjs — tmp git 仓 fixture（2026-10-13 自 Shipyard.Material 参考实现回灌）
-// 覆盖：越界检出 / 未落检出 / 白名单豁免 / --strict 退出码 / 无 plan exit 2 / 版本号 token 过滤
-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';
-
-// fileURLToPath 而非手搓 pathname 解码（源仓 fdded128）：URL pathname 对非 ASCII 路径百分号编码，
-// Windows 中文 worktree 路径下子进程「Cannot find module」静默红。
-const CLI = path.join(path.dirname(fileURLToPath(import.meta.url)), 'check-scope.mjs');
-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 mkRepo() {
-  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'check-scope-'));
-  const g = (...a) => spawnSync('git', a, { cwd: root, encoding: 'utf8' });
-  g('init', '-q');
-  g('config', 'user.email', 't@t');
-  g('config', 'user.name', 't');
-  fs.writeFileSync(path.join(root, 'src-a.md'), '# A\n');
-  g('add', '.');
-  g('commit', '-qm', 'init');
-  return { root, g };
-}
-
-const run = (root, planArgs = []) => spawnSync(process.execPath, [CLI, ...planArgs, '--root', root], { cwd: root, encoding: 'utf8' });
-
-// S1 越界检出（工作区默认口径，含未跟踪）
-{
-  const { root } = mkRepo();
-  fs.mkdirSync(path.join(root, 'workflow', 'plans'), { recursive: true });
-  fs.writeFileSync(path.join(root, 'workflow', 'plans', 'p1.md'), '## 改动面\n- src-a.md：改\n- src-new.md：新建\n');
-  fs.writeFileSync(path.join(root, 'src-b.md'), '# B 越界\n'); // 未跟踪新文件，未声明
-  const r = run(root, ['workflow/plans/p1.md']);
-  check('S1 越界件检出（未跟踪 src-b.md）', r.status === 0 && /越界件/.test(r.stdout) && /src-b\.md/.test(r.stdout), JSON.stringify({ status: r.status, out: r.stdout.slice(0, 300) }));
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// S2 未落检出（声明未变更）
-{
-  const { root } = mkRepo();
-  fs.mkdirSync(path.join(root, 'workflow', 'plans'), { recursive: true });
-  fs.writeFileSync(path.join(root, 'workflow', 'plans', 'p2.md'), '## 改动面\n- src-ghost.md：计划改但没改\n');
-  const r = run(root, ['workflow/plans/p2.md']);
-  check('S2 未落件检出（src-ghost.md）', r.status === 0 && /未落件/.test(r.stdout) && /src-ghost\.md/.test(r.stdout), JSON.stringify({ status: r.status, out: r.stdout.slice(0, 300) }));
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// S3 白名单豁免（workflow 台账随行件不算越界）
-{
-  const { root } = mkRepo();
-  fs.mkdirSync(path.join(root, 'workflow', 'intents'), { recursive: true });
-  fs.mkdirSync(path.join(root, 'workflow', 'plans'), { recursive: true });
-  fs.writeFileSync(path.join(root, 'workflow', 'plans', 'p3.md'), '## 改动面\n- src-a.md：改\n');
-  fs.writeFileSync(path.join(root, 'src-a.md'), '# A2\n');
-  fs.writeFileSync(path.join(root, 'workflow', 'intents', '2026-10-09-x.md'), '---\n状态: draft\n---\n');
-  const r = run(root, ['workflow/plans/p3.md']);
-  check('S3 台账随行件豁免（workflow/intents 不算越界）', r.status === 0 && !/workflow[\\/]intents/.test(r.stdout.split('未落件')[0]), JSON.stringify({ status: r.status, out: r.stdout.slice(0, 300) }));
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// S4 --strict 越界 exit 1；无越界 exit 0
-{
-  const { root } = mkRepo();
-  fs.mkdirSync(path.join(root, 'workflow', 'plans'), { recursive: true });
-  fs.writeFileSync(path.join(root, 'workflow', 'plans', 'p4.md'), '## 改动面\n- src-a.md：改\n');
-  fs.writeFileSync(path.join(root, 'src-a.md'), '# A2\n');
-  check('S4a 无越界 --strict exit 0', run(root, ['workflow/plans/p4.md', '--strict']).status === 0);
-  fs.writeFileSync(path.join(root, 'src-rogue.md'), '# rogue\n');
-  check('S4b 越界 --strict exit 1', run(root, ['workflow/plans/p4.md', '--strict']).status === 1);
-  check('S4c 越界无 --strict exit 0（advisory）', run(root, ['workflow/plans/p4.md']).status === 0);
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// S5 无 plan exit 2（fail-loud）
-{
-  const { root } = mkRepo();
-  const r = run(root, ['workflow/plans/nope.md']);
-  check('S5 plan 不存在 exit 2', r.status === 2, JSON.stringify({ status: r.status }));
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// S6 版本号伪 token 过滤（v1.2.2 不入声明清单）
-{
-  const { root } = mkRepo();
-  fs.mkdirSync(path.join(root, 'workflow', 'plans'), { recursive: true });
-  fs.writeFileSync(path.join(root, 'workflow', 'plans', 'p6.md'), '## 改动面\n- src-a.md：升级到 v1.2.2\n');
-  fs.writeFileSync(path.join(root, 'src-a.md'), '# A2\n');
-  const r = run(root, ['workflow/plans/p6.md']);
-  check('S6 版本号 token 不产生未落噪声', r.status === 0 && !/1\.2\.2/.test(r.stdout), JSON.stringify({ out: r.stdout.slice(0, 300) }));
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-console.log(`\n合计: PASS ${pass} / FAIL ${fail}`);
-process.exit(fail ? 1 : 0);