agentic-flow-kit 1.8.2 → 2.0.0

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

@@ -1,201 +0,0 @@
-// gate-checklist.test.mjs — 显式配对登记表测试（2026-09-25 gate-checklist-registry）
-// 方法：fixture mini doctor.mjs / check-loop.sh 源码 + 注入 pairs，调 gateChecklist() 拿结构化结果；
-//       真实仓库两场景做 baseline；--json CLI spawn 冒烟回归原「字段丢失」bug。
-// 判据：① 两侧解析正确 ② 三种登记形态不误报 ③ 断档/未登记检测命中 ④ 真实仓库 0 断档 0 未登记
-// 用法：node templates/_agents/scripts/gate-checklist.test.mjs（npm test 随跑）
-import fs from 'node:fs';
-import path from 'node:path';
-import { spawnSync } from 'node:child_process';
-import { fileURLToPath } from 'node:url';
-import { gateChecklist } from './gate-checklist.mjs';
-
-let pass = 0;
-let failCount = 0;
-function check(name, cond, detail = '') {
-  if (cond) { pass++; console.log('PASS ' + name); }
-  else { failCount++; console.log('FAIL ' + name + (detail ? '——' + detail : '')); }
-}
-
-const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
-const SRC_ROOT = path.resolve(SCRIPT_DIR, '..', '..', '..');
-
-// fixture：5 节 doctor（1 / 5 / 6.5 / 7 / 9）+ 2 项 check-loop（#2 / #3）
-const FIXTURE_DOCTOR = `// doctor fixture
-function f() {
-  // 1. Node 版本（装户体检独有）
-  const a = 1;
-  // 5. 占位符残留（与 check-loop #2 直接配对）
-  const b = 2;
-  // 6.5 delegations 台账结构（小节号解析）
-  const c = 3;
-  // 7. check-loop（fixture 里也有 §7，供经 §7 覆盖登记）
-  const e = 5;
-  // 9. 未登记的新检查项（应报未登记）
-  const d = 4;
-  return [a, b, c, d, e];
-}
-`;
-const FIXTURE_CL = `#!/bin/sh
-# 2. 模板字段占位符残留 [warning]
-# 3. incidents 复盘三件套完整性
-# 7. 未登记的新检查项
-exit 0
-`;
-// fixture 登记表：5↔2 直接配对、1 声明独有、6.5 声明独有、7→#3 经 §7 覆盖；
-// §99 / #99 是登记了但两侧都不存在的 id（应报断档×2）
-const FIXTURE_PAIRS = [
-  { doctor: '5', cl: '2', note: '占位符' },
-  { doctor: '1', cl: null, note: '独有' },
-  { doctor: '6.5', cl: null, note: '独有' },
-  { doctor: '7', cl: '3', note: '经 §7' },
-  { doctor: '99', cl: null, note: '断档——doctor 侧不存在' },
-  { doctor: '1', cl: '99', note: '断档——check-loop 侧不存在' },
-];
-
-const run = (pairs = FIXTURE_PAIRS, doctorSrc = FIXTURE_DOCTOR, clSrc = FIXTURE_CL) =>
-  gateChecklist({ doctorSrc, checkLoopSrc: clSrc, pairs });
-
-// ---- S1 解析：doctor 5 节（含 6.5 小节号、§7 与未登记的 9）----
-{
-  const r = run();
-  check('S1 fixture doctor 解析 5 节且含 6.5 小节号',
-    r.doctorCount === 5 && r.doctor.some((d) => d.id === '6.5' && d.title.includes('delegations')),
-    JSON.stringify(r.doctor));
-}
-
-// ---- S2 解析：check-loop 3 项（#2 带 severity，#3 无）----
-{
-  const r = run();
-  const c2 = r.checkLoop.find((c) => c.id === '2');
-  const c3 = r.checkLoop.find((c) => c.id === '3');
-  check('S2 fixture check-loop 解析 3 项且 severity 提取正确',
-    r.checkLoopCount === 3 && c2.severity === 'warning' && c3.severity === null,
-    JSON.stringify(r.checkLoop));
-}
-
-// ---- S3 直接配对：5↔2 双侧存在 → matched 命中 ----
-{
-  const r = run();
-  check('S3 直接配对 §5↔#2 进入 matched',
-    r.matched.some((p) => p.doctor === '5' && p.cl === '2'),
-    JSON.stringify(r.matched.map((p) => [p.doctor, p.cl])));
-}
-
-// ---- S4 声明独有：§1 / §6.5 不产生任何 findings ----
-{
-  const r = run();
-  const hit = [...r.broken, ...r.unregistered].filter((f) => f.id === '1' || f.id === '6.5');
-  check('S4 声明独有（§1 / §6.5）不误报',
-    hit.length === 0,
-    JSON.stringify(hit));
-}
-
-// ---- S5 经 §7 覆盖：7→#3 不产生 findings 且进 matched ----
-{
-  const r = run();
-  check('S5 经 §7 覆盖登记不误报且进 matched',
-    r.matched.some((p) => p.doctor === '7' && p.cl === '3') && !r.unregistered.some((u) => u.id === '3'),
-    JSON.stringify(r.unregistered));
-}
-
-// ---- S6 断档：登记 §99 / #99 两侧不存在 → broken ×2 ----
-{
-  const r = run();
-  const bDoc = r.broken.find((b) => b.side === 'doctor' && b.id === '99');
-  const bCl = r.broken.find((b) => b.side === 'check-loop' && b.id === '99');
-  check('S6 登记断档两侧各报一条（doctor §99 / check-loop #99）',
-    r.broken.length === 2 && !!bDoc && !!bCl,
-    JSON.stringify(r.broken));
-}
-
-// ---- S7 未登记：doctor §9 与 check-loop #7 → unregistered ×2 ----
-{
-  const r = run();
-  const uDoc = r.unregistered.find((u) => u.side === 'doctor' && u.id === '9');
-  const uCl = r.unregistered.find((u) => u.side === 'check-loop' && u.id === '7');
-  check('S7 未登记两侧各报一条（doctor §9 / check-loop #7）',
-    r.unregistered.length === 2 && !!uDoc && !!uCl,
-    JSON.stringify(r.unregistered));
-}
-
-// ---- S8 空源码 + 空登记表不崩（0 findings）----
-{
-  const r = run([], '', '');
-  check('S8 空源码 + 空登记表不崩（0/0 且 0 findings）',
-    r.doctorCount === 0 && r.checkLoopCount === 0 && r.broken.length === 0 && r.unregistered.length === 0,
-    JSON.stringify(r));
-}
-
-// ---- S8b 整数无点注释不误判为节（doctor.mjs:257 // 4 宿主目录映射 形态）----
-{
-  const doctorSrc = `// 4. kit.json managed 台账（真节）
-const x = 1;
-  // 4 宿主目录映射（与 profiles 同源——正文注释，非节）
-const y = 2;
-`;
-  const r = gateChecklist({ doctorSrc, checkLoopSrc: '', pairs: [{ doctor: '4', cl: null, note: '独有' }] });
-  check('S8b 整数无点的正文注释不误判（仅解析 1 节 §4 且标题为真节）',
-    r.doctorCount === 1 && r.doctor[0].title.includes('kit.json') && r.broken.length === 0 && r.unregistered.length === 0,
-    JSON.stringify(r.doctor));
-}
-
-// ---- S9 重复 id 登记（同 cl 两个直接配对）不崩且均可命中 ----
-{
-  const pairs = [
-    { doctor: '5', cl: '2', note: 'a' },
-    { doctor: '1', cl: '2', note: 'b' },
-  ];
-  const r = run(pairs);
-  check('S9 多条目登记同一 cl 不崩（matched 2）',
-    r.matched.length === 2 && r.unregistered.some((u) => u.side === 'check-loop' && u.id === '3'),
-    JSON.stringify({ m: r.matched.length, u: r.unregistered }));
-}
-
-const realDoctor = () => fs.readFileSync(path.join(SRC_ROOT, 'src', 'doctor.mjs'), 'utf8');
-// check-loop 与 gate-checklist.mjs 同目录（包源 scripts/，拷进装户后是 .agents/scripts/）。
-const realCl = () => fs.readFileSync(path.join(SCRIPT_DIR, 'check-loop.mjs'), 'utf8');
-const hasReal = fs.existsSync(path.join(SRC_ROOT, 'src', 'doctor.mjs'));
-
-// ---- S10 真实仓库 baseline：PAIRS 全量登记 → 0 断档 / 0 未登记 ----
-if (hasReal) {
-  const r = gateChecklist({ doctorSrc: realDoctor(), checkLoopSrc: realCl() });
-  check('S10 真实仓库登记完整（0 断档 / 0 未登记）',
-    r.broken.length === 0 && r.unregistered.length === 0,
-    JSON.stringify({ broken: r.broken, unregistered: r.unregistered }));
-}
-
-// ---- S11 真实仓库计数：doctor ≥ 12 节 / check-loop ≥ 15 项 ----
-if (hasReal) {
-  const r = gateChecklist({ doctorSrc: realDoctor(), checkLoopSrc: realCl() });
-  check('S11 真实仓库 doctor ≥ 12 节且 check-loop ≥ 15 项（baseline）',
-    r.doctorCount >= 12 && r.checkLoopCount >= 15,
-    `doctor ${r.doctorCount} / check-loop ${r.checkLoopCount}`);
-}
-
-// ---- S12 --json CLI 冒烟：键齐无 undefined（回归原 .title 字段丢失 bug）----
-if (hasReal) {
-  const p = spawnSync(process.execPath, [path.join(SCRIPT_DIR, 'gate-checklist.mjs'), '--json'], { cwd: SRC_ROOT, encoding: 'utf8' });
-  let j = null;
-  try { j = JSON.parse(p.stdout); } catch { /* fail below */ }
-  const keysOk = j && ['doctorCount', 'checkLoopCount', 'matched', 'solo', 'broken', 'unregistered'].every((k) => k in j);
-  const noHoles = j && JSON.stringify(j).includes('undefined') === false
-    && j.matched.every((m) => typeof m.doctor === 'string' && typeof m.cl === 'string' && 'note' in m);
-  check('S12 --json 可解析、键齐、条目无 undefined 丢字段、exit 0',
-    p.status === 0 && !!keysOk && !!noHoles,
-    String(p.stdout).slice(0, 200));
-}
-
-// ---- S13 doctor 多行节注释：首行即标题（6.6 形态）解析不漏 ----
-{
-  const doctorSrc = `// 6.6 owned 漂移校验（kit.owned 列表盘面 sha 不一致；
-//     漂移信号靠本校验给装户可见性）
-const x = 1;
-`;
-  const r = gateChecklist({ doctorSrc, checkLoopSrc: '', pairs: [{ doctor: '6.6', cl: null, note: '独有' }] });
-  check('S13 多行节注释（§6.6 形态）首行命中且登记不报 findings',
-    r.doctorCount === 1 && r.doctor[0].title.includes('owned') && r.broken.length === 0 && r.unregistered.length === 0,
-    JSON.stringify(r.doctor));
-}
-
-console.log('\n合计: PASS ' + pass + ' / FAIL ' + failCount);
-process.exit(failCount ? 1 : 0);

package/templates/_agents/scripts/gate-seg.mjs

@@ -1,54 +0,0 @@
-// gate-seg.mjs — 门禁 ROI 段插桩共用件（2026-10-08 gate-roi-metrics）
-// 为什么独立成件：check-loop.mjs 与 check-hygiene.mjs **互相不能反向 import**（前者已 import 后者，
-// 后者再 import 前者即循环依赖）——而两者都要插桩。判据单源必须只有一处，故抽本件。
-//
-// 机制：每次 gateSeg() 调用先**结算上一段**（段内 warnings/blockers 增量条数 + 耗时），再记本段起点。
-// 统计完全由数组长度差推出——**不改任何 warnings.push / blockers.push 调用点**，判定逻辑与文案零改动。
-// 默认路径（无 --gate-stats）下 segs 只在内存里攒、不打印不写盘 → 输出契约逐字节不变（硬约束：
-// pre-push / pre-commit 消费者 + doctor 的 WARN 行计数 + check-loop.test.mjs 223 断言全依赖它）。
-//
-// 耗时口径**刻意包含子进程时间**（检查 11 调两个生成器 --check、检查 13 调 rule-budget.mjs）——
-// 门禁真实成本本就要含子进程；不做剔除，但看板与 spec 均显式声明该口径防误读。
-export function gateSeg(collector, id, label) {
-  const now = Date.now();
-  const prev = collector.current;
-  if (prev) {
-    collector.segs.push({
-      id: prev.id,
-      label: prev.label,
-      warns: collector.warnings.length - prev.w,
-      blocks: collector.blockers.length - prev.b,
-      ms: now - prev.t,
-    });
-  }
-  collector.current = { id, label, w: collector.warnings.length, b: collector.blockers.length, t: now };
-}
-
-// finishSegs：结算末段（末段之后没有下一次 gateSeg 调用，须显式收口，否则最后一段不进账）
-export function finishSegs(collector) {
-  if (!collector.current) return collector.segs; // 已结算过（幂等——writeGateStats 与输出段各调一次不会重复入账）
-  gateSeg(collector, '__end__', '__end__'); // 本次调用结算上一段；记下的 current 置空防重复结算
-  collector.current = null;
-  return collector.segs;
-}
-
-// makeCollector：建收集器（引用同一对数组，不复制数据）
-export function makeCollector(warnings, blockers) {
-  return { warnings, blockers, segs: [], current: null };
-}
-
-// appendSegs：并入「在别处结算出的段」，供模块化门禁使用（2026-10-08 gate-roi-metrics 修复）。
-//   背景：check-hygiene.mjs 产出的是**局部** warnings 数组（由 check-loop 事后 spread 进全局），
-//   故它的增量在模块执行期间**不反映**到 check-loop 的数组上。若直接共用游标插桩，后果是确定的错账：
-//   本模块 5 段恒记 0 条命中，而它的全部增量会被误记到模块之后的第一个段（检查 3）头上——
-//   实测已抓到：某次 hygiene 产出 1 条警告被记成「检查 13 命中」。
-//   语义：先结算本收集器当前段（模块前的检查，如检查 1）→ 按序并入外来段 → 游标清空，
-//   下一个 gateSeg 从零起算，Δ 天然正确。
-//   空 segs 直接返回且**不结算**当前段：没有东西可并入时不该改变原有结算时序。
-export function appendSegs(collector, segs) {
-  if (!segs || !segs.length) return collector.segs;
-  finishSegs(collector);
-  collector.segs.push(...segs);
-  collector.current = null;
-  return collector.segs;
-}

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

@@ -1,112 +0,0 @@
-// gate-seg.test.mjs — 门禁 ROI 段插桩共用件测试（2026-10-08 gate-roi-metrics）
-// 被测：gateSeg 结算语义 / finishSegs 幂等 / makeCollector 引用同一对数组。
-// 判据单源所在：check-loop.mjs 与 check-hygiene.mjs 都靠本件插桩，故它的正确性是全部门禁成本度量的地基——
-// 段归属算错则整张 ROI 表失真而无人察觉。端到端回归网仍是 check-loop.test.mjs（223 断言）。
-// 用法：node templates/_agents/scripts/gate-seg.test.mjs
-import { pathToFileURL, fileURLToPath } from 'node:url';
-import path from 'node:path';
-
-const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
-const { gateSeg, finishSegs, makeCollector, appendSegs } =
-  await import(pathToFileURL(path.join(SCRIPT_DIR, 'gate-seg.mjs')).href);
-
-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}` : ''}`); }
-};
-
-// ---- makeCollector：引用同一对数组（不复制）----
-{
-  const w = [], b = [];
-  const c = makeCollector(w, b);
-  check('makeCollector：引用同一对数组（push 即被看见，无复制）', c.warnings === w && c.blockers === b);
-  check('makeCollector：初始 segs 为空、current 为空', Array.isArray(c.segs) && c.segs.length === 0 && c.current === null);
-}
-
-// ---- gateSeg：每次调用结算上一段，首调不结算 ----
-{
-  const w = [], b = [];
-  const c = makeCollector(w, b);
-  gateSeg(c, '1', '检查一');
-  check('gateSeg：首次调用只记起点不结算（segs 仍空）', c.segs.length === 0 && c.current.id === '1');
-  w.push('a'); b.push('b'); b.push('c');          // 段一产出 1 warn + 2 blocks
-  gateSeg(c, '2', '检查二');
-  check('gateSeg：第二次调用结算上一段（warns=1 blocks=2，id/label 对）',
-    c.segs.length === 1 && c.segs[0].id === '1' && c.segs[0].label === '检查一'
-    && c.segs[0].warns === 1 && c.segs[0].blocks === 2, JSON.stringify(c.segs));
-  check('gateSeg：结算后 current 切到新段', c.current.id === '2');
-  // 零命中段也要入账（死检查识别依赖「声明了但从未命中」——漏记即误判为未声明）
-  gateSeg(c, '3', '检查三');
-  check('gateSeg：零命中段照样入账（warns=0 blocks=0）',
-    c.segs.length === 2 && c.segs[1].id === '2' && c.segs[1].warns === 0 && c.segs[1].blocks === 0, JSON.stringify(c.segs));
-}
-
-// ---- finishSegs：结算末段 + 幂等（writeGateStats 与输出段各调一次不得重复入账）----
-{
-  const w = [], b = [];
-  const c = makeCollector(w, b);
-  gateSeg(c, '1', '检查一');
-  w.push('x');
-  const segs1 = finishSegs(c);
-  check('finishSegs：结算末段（末段后无下次调用否则该段丢失）',
-    segs1.length === 1 && segs1[0].id === '1' && segs1[0].warns === 1, JSON.stringify(segs1));
-  const segs2 = finishSegs(c);
-  check('finishSegs：幂等——二次调用不重复入账（防 __end__ 伪段污染表）',
-    segs2.length === 1 && !segs2.some((s) => s.id === '__end__'), JSON.stringify(segs2));
-  check('finishSegs：结算后 current 置空', c.current === null);
-}
-
-// ---- ms 单调不减（耗时度量地基）----
-{
-  const c = makeCollector([], []);
-  gateSeg(c, '1', 'a');
-  const t = Date.now(); while (Date.now() - t < 5) { /* 占位：保证有可测间隔 */ }
-  gateSeg(c, '2', 'b');
-  check('耗时字段：ms 为非负整数且单调（门禁成本度量的地基）',
-    Number.isInteger(c.segs[0].ms) && c.segs[0].ms >= 0, JSON.stringify(c.segs[0]));
-}
-
-// ---- appendSegs：模块化门禁的段归属（本次实抓到错账的根因，钉死）----
-// 症状：check-hygiene.mjs 的增量不反映到 check-loop 的数组上，直接共用游标会让 hygiene 各段恒记 0，
-//       而它的全部增量被误记到模块之后的第一段（检查 3）。下面是该场景的最小复现与修复后行为。
-{
-  const globalW = [], globalB = [];
-  const g = makeCollector(globalW, globalB);
-  gateSeg(g, '1', '检查1');            // 模块前的一段
-  globalW.push('w-check1');            // 检查 1 产出 1 条
-
-  // 模块（局部数组）：检查 2 → 检查 11 各产出 1 条
-  const localW = [];
-  const l = makeCollector(localW, []);
-  gateSeg(l, '2', '检查2');
-  localW.push('w-check2');
-  gateSeg(l, '11', '检查11');
-  localW.push('w-check11');
-
-  appendSegs(g, finishSegs(l));
-  const order = g.segs.map((s) => s.id);
-  const byId = new Map(g.segs.map((s) => [s.id, s.warns]));
-  check('appendSegs：模块后的一段先结算（检查 1 不被外来段吞掉）',
-    order[0] === '1' && byId.get('1') === 1, JSON.stringify(g.segs));
-  check('appendSegs：外来段按序并入且各自归属正确（2 → 1 条、11 → 1 条，**不都记到后一段**）',
-    order.slice(1).join(',') === '2,11' && byId.get('2') === 1 && byId.get('11') === 1, JSON.stringify(g.segs));
-  check('appendSegs：并入后游标清空，下一段从零起算（不把外来增量算进模块之后的段）',
-    g.current === null, JSON.stringify(g.current));
-  gateSeg(g, '3', '检查3');
-  globalW.push(...['w-check3a', 'w-check3b']);
-  gateSeg(g, '4', '检查4');
-  check('appendSegs：模块之后的第一段只记自己的增量（检查 3 = 2 条，不含 hygiene 的 2 条）',
-    g.segs.find((s) => s.id === '3').warns === 2, JSON.stringify(g.segs));
-
-  // 空外来段：既不并入也不提前结算（不改变原有结算时序）
-  const w2 = [], b2 = [];
-  const g2 = makeCollector(w2, b2);
-  gateSeg(g2, '1', 'a');
-  appendSegs(g2, []);
-  check('appendSegs：空外来段 → 收集器原样不动（不结算、不并入，结算时序不变）',
-    g2.segs.length === 0 && g2.current !== null, JSON.stringify(g2));
-}
-
-console.log(`\n合计: PASS ${pass} / FAIL ${fail}`);
-process.exit(fail ? 1 : 0);

package/templates/_agents/scripts/gen-effective-policy.mjs

@@ -1,107 +0,0 @@
-#!/usr/bin/env node
-// gen-effective-policy.mjs — 当前生效规则视图生成器（2026-10-13 自 Shipyard.Material 参考实现回灌，
-//   源仓沿革留痕在包源仓 git 历史与 CHANGELOG——装户径不引实例路径）
-// 背景：豁免锚经 policy v1→v8 演进后，「存量豁免 vs 受管」的合成语义只活在 check-loop.mjs 源码里，
-//   规则空间永久二分且不可读——本脚本把 policy.mjs 单源渲染为人可读的 workflow/effective-policy.md，
-//   与 INDEX.md 同款「生成物 + --check 防漂移」纪律；verify.mjs 挂 --check 门（CI 强制随 policy 变更重生成）。
-// 渲染内容：当前生效 policyVersion（单源 policy.mjs#loadKitPolicy 读 .agents/kit.json，缺省回落 v1）、
-//   逐锚键的生效日 / 消费检查项 / 分级现状（hard·已生效 / advisory·已生效 / 未到期——锚日 > 今日的
-//   升级锚标注「待升级」）。
-// 判定单源：锚定义与版本回落 = policy.mjs POLICIES / loadKitPolicy（本脚本不写日期、不读第二份配置，
-//   只读只渲染）；键→检查项映射取自 check-loop.mjs 头部检查清单（kit 现役 1-20 项，编号是文档引用锚）。
-// 用法：node .agents/scripts/gen-effective-policy.mjs [--root <dir>] [--check]
-//   --check：与磁盘 workflow/effective-policy.md 比对，漂移 exit 1（CI/verify 用）。
-//   比对前双侧行尾归一（CRLF→LF）。生成器仍只写 LF，--check 不改文件。
-//   干净的 autocrlf 检出是 CRLF，字节相等会假红，且重生成只留下不可提交的行尾差。
-// 测试：node .agents/scripts/gen-effective-policy.test.mjs（fixture 注入 --root）
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { POLICIES, loadKitPolicy } from './policy.mjs';
-
-const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
-const argv = process.argv.slice(2);
-const argOf = (k) => {
-  const i = argv.indexOf(k);
-  return i >= 0 && i + 1 < argv.length ? argv[i + 1] : '';
-};
-const ROOT = argOf('--root') || path.resolve(SCRIPT_DIR, '..', '..');
-const OUT = path.join(ROOT, 'workflow', 'effective-policy.md');
-
-// 键 → 消费检查项与分级说明（单源 check-loop.mjs 头部检查清单编号；说明文本与本脚本共同演进）
-const CONSUMERS = {
-  moduleSince: ['检查 12', 'frontmatter「模块:」枚举合法性（词表单源 .agents/workflow-modules.txt）', 'advisory'],
-  check14Since: ['检查 14', '新 done 的 spec/plan 须有 approved git 历史（kit 口径恒 advisory 永不升级 hard）', 'advisory'],
-  confirmDocsEffective: ['检查 15', 'docs 确认台账两条件准入（台账行 ∪ 自报日期≥锚）', 'hard'],
-  confirmIncidentsEffective: ['检查 15', 'incidents 档确认阈值（fixed/closed 配对）', 'hard'],
-  bindingTs: ['检查 15', '四终态内容绑定（台账行 ts≥锚 才比对 sha256）', 'hard'],
-  check17UnclosedAfter: ['检查 17', '发版提交树未收口三件套——版本 tag 锚（非日期）', 'hard'],
-  stageGateSince: ['检查 19', '逐阶段审计（起草先于入口确认 / 台账顺序）', 'advisory'],
-  riskLevelSince: ['检查 1', 'intent risk_level 双字段协议（laneOfEntry 判道的生效锚——锚前建档单字段口径不判高）', 'hard'],
-  delegationSince: ['检查 18', '委派台账对账——锚前存量豁免', 'advisory'],
-  verifySince: ['检查 8', '测试绿声明对账（无 SHA 声明「测试绿」须 24h 内凭证）+ confirm-doc →done 前置', 'advisory'],
-  verifyDocSince: ['检查 8', '凭证按 doc 精确绑定的生效时刻（→done 前置与对账按 doc 匹配，不带 --doc 的行不给任何单背书）', 'advisory'],
-  scopeSince: ['检查 15', 'scope 子项（机器派生改动面 scope{files,sha256}——缺 scope 灰度 warning、摘要不符 hard）', 'hard'],
-  ledgerDocChainSince: ['检查 15', '台账哈希链域从物理序改为按 doc 逻辑序（写入侧 confirm-doc 同批生效）', 'hard'],
-  // B6b-2 六段 + §3x + 复核上下文（2026-10-13 自源仓回灌，消费面自本批起在场）
-  incidentRegrSince: ['检查 3x', 'incident 防复发验证证据门（fixed/closed 须落自动化用例/回归清单引用）', 'hard'],
-  specVerifSince: ['检查 21', 'spec 验证落地核查（验证节无测试文件/命令引用——advisory）', 'advisory'],
-  attributionSince: ['检查 24', 'incident 归因字段（来源/影响环境必填且在枚举——advisory）', 'advisory'],
-  convergenceSince: ['检查 23', '判据级收敛对账 advisory 档（证据无效 WARN）', 'advisory'],
-  convergenceHardSince: ['检查 23', '判据级收敛对账 hard 档（证据无效 HARD-BLOCK）', 'hard'],
-  reviewerSince: ['检查 1', '独立复核上下文标识（复核行缺「复核上下文：」——advisory）', 'advisory'],
-};
-
-// today：视图基准日。EFFECTIVE_POLICY_TODAY 为测试注入缝（跨锚日稳定性用；生产不设）。
-const today = () => process.env.EFFECTIVE_POLICY_TODAY || new Date().toISOString().slice(0, 10);
-
-function render(viewDateStr) {
-  const policy = loadKitPolicy(ROOT);
-  const v = POLICIES[policy.policyVersion] || {};
-  const todayStr = viewDateStr || today();
-  const lines = [];
-  lines.push('# 当前生效规则视图（生成物，勿手改）');
-  lines.push('');
-  lines.push('> 生成器 `node .agents/scripts/gen-effective-policy.mjs`（policy.mjs 单源渲染；漂移由 verify.mjs `effective-policy` 门 --check 把关——改 policy 后须重生成并随同提交）。');
-  lines.push(`> 当前生效：**policyVersion ${policy.policyVersion}**（kit.json 声明 ${policy.requestedVersion}${policy.requestedVersion === policy.policyVersion ? '' : '，不在 POLICIES 表内已回落 v1'}）；视图日期 ${todayStr}。`);
-  lines.push('');
-  lines.push('| 锚键 | 生效日/锚 | 消费检查项 | 语义 | 分级 | 现状 |');
-  lines.push('|---|---|---|---|---|---|');
-  for (const key of Object.keys(v)) {
-    const raw = v[key];
-    const c = CONSUMERS[key] || ['—', '（未登记消费方——policy 加新键时同步登 CONSUMERS）', '—'];
-    const isDate = /^\d{4}-\d{2}-\d{2}$/.test(String(raw));
-    // 升级锚语义：日期 > 今日 = 未到期（维持低档）；其余 = 已生效
-    const status = !isDate ? '生效（版本锚）' : (String(raw) <= todayStr ? '已生效' : `待升级（${raw} 起）`);
-    lines.push(`| \`${key}\` | ${raw} | ${c[0]} | ${c[1]} | ${c[2]} | ${status} |`);
-  }
-  lines.push('');
-  lines.push('<!-- GENERATED:BEGIN — gen-effective-policy.mjs 整段重写，手工说明写在本行之前 -->');
-  return lines.join('\n') + '\n';
-}
-
-const text = render();
-// 行尾归一（与 gen-workflow-index.mjs normEol 同句）：只影响 --check 判定，写盘仍是 LF。
-const normEol = (s) => String(s).replace(/\r\n/g, '\n');
-if (argv.includes('--check')) {
-  let disk = '';
-  try {
-    disk = fs.readFileSync(OUT, 'utf8');
-  } catch { /* 缺文件视作空——走漂移分支（新装户由 init 生成器首跑种子本文件） */ }
-  // 锚日时间炸弹拆除（源仓 2026-10-12 CI 实证：锚日当天重渲染按当日判「已生效」→ 与仓内视图必差
-  // → --check 必红——任何未来日期锚都会在锚日引爆）。修法：--check 对**磁盘文件自带的视图日期**重渲染
-  // （生成物与自身生成日自洽，跨锚日字节稳定）；显式重生成（默认模式）才前进视图日期并翻转状态列。
-  // 视图日期行缺失的存量件回落当日口径。
-  const mDate = disk.match(/视图日期 (\d{4}-\d{2}-\d{2})/);
-  const checkText = mDate ? render(mDate[1]) : text;
-  if (normEol(disk) === normEol(checkText)) {
-    console.log('[effective-policy] ✅ 与磁盘一致（无漂移；按磁盘视图日期重渲染比对）');
-    process.exit(0);
-  }
-  console.error('[effective-policy] ❌ 漂移：policy 变更后未重生成 workflow/effective-policy.md');
-  console.error('  修法：node .agents/scripts/gen-effective-policy.mjs && git add workflow/effective-policy.md（随 policy 变更同笔提交）');
-  process.exit(1);
-}
-fs.mkdirSync(path.dirname(OUT), { recursive: true });
-fs.writeFileSync(OUT, text);
-console.log(`✅ 已生成 ${path.relative(process.cwd(), OUT)}`);

package/templates/_agents/scripts/gen-effective-policy.test.mjs

@@ -1,100 +0,0 @@
-#!/usr/bin/env node
-// gen-effective-policy.test.mjs — 生效规则视图生成器 fixture 套件（2026-10-13 自 Shipyard.Material
-//   参考实现回灌时随件移植；夹具口径改 kit：注入 .agents/kit.json 的 policyVersion 取值 / 缺失 / 非法三态）
-// 方法：临时根注入 kit.json，断言生成内容与 --check 语义。
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { spawnSync } from 'node:child_process';
-import { fileURLToPath } from 'node:url';
-
-const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
-const SCRIPT = path.join(SCRIPT_DIR, 'gen-effective-policy.mjs');
-
-let pass = 0;
-let fail = 0;
-const check = (desc, cond, detail = '') => {
-  if (cond) { pass++; console.log(`PASS  ${desc}`); }
-  else { fail++; console.log(`FAIL  ${desc}${detail ? '\n      ' + detail : ''}`); }
-};
-const mkfix = (policyVersion) => {
-  const d = fs.mkdtempSync(path.join(os.tmpdir(), 'eff-policy-test-'));
-  fs.mkdirSync(path.join(d, '.agents'), { recursive: true });
-  if (policyVersion !== undefined) fs.writeFileSync(path.join(d, '.agents', 'kit.json'), JSON.stringify({ kit: 'agentic-flow-kit', policyVersion }));
-  return d;
-};
-const run = (root, ...args) => {
-  const r = spawnSync(process.execPath, [SCRIPT, '--root', root, ...args], { encoding: 'utf8' });
-  return { code: r.status, out: `${r.stdout || ''}${r.stderr || ''}` };
-};
-
-// 场景 1：v8 生成——当前版本行 + 全锚键行 + 表结构（真实 v8 锚均为历史日期，待升级分支由场景 4 注入钉住）
-{
-  const d = mkfix(8);
-  const r = run(d);
-  const doc = fs.readFileSync(path.join(d, 'workflow', 'effective-policy.md'), 'utf8');
-  check('场景 1：v8 生成成功且含版本声明与锚键行',
-    r.code === 0 && doc.includes('**policyVersion 8**') && doc.includes('`ledgerDocChainSince`') && doc.includes('`bindingTs`') && doc.includes('kit.json 声明 8'), r.out + doc);
-}
-// 场景 2：--check 一致 → 0；篡改磁盘 → 1；再生成 → 恢复 0
-{
-  const d = mkfix(8);
-  run(d);
-  check('场景 2a：生成后 --check 一致', run(d, '--check').code === 0);
-  fs.appendFileSync(path.join(d, 'workflow', 'effective-policy.md'), 'drift\n');
-  const r2 = run(d, '--check');
-  check('场景 2b：磁盘漂移 → --check exit 1 且含修法', r2.code === 1 && r2.out.includes('重生成'), r2.out);
-  run(d);
-  check('场景 2c：重生成后 --check 恢复 0', run(d, '--check').code === 0);
-}
-// 场景 2d/2e：行尾不算漂移，内容差仍算（autocrlf 假红）
-{
-  const d = mkfix(8);
-  run(d);
-  const p = path.join(d, 'workflow', 'effective-policy.md');
-  const lf = fs.readFileSync(p, 'utf8');
-  fs.writeFileSync(p, lf.replace(/\n/g, '\r\n'));
-  check('场景 2d：CRLF 检出、内容相同 → --check 0', run(d, '--check').code === 0);
-  fs.writeFileSync(p, lf.replace(/\n/g, '\r\n').replace('policyVersion', 'policyVerslon'));
-  const r = run(d, '--check');
-  check('场景 2e：CRLF 且内容漂移 → --check exit 1', r.code === 1 && r.out.includes('重生成'), r.out);
-}
-// 场景 2f：锚日翻转稳定性（源仓 2026-10-12 CI 生产事故钉：视图生成于 D1，次日系统当日 --check
-//   按当日重渲染判「已生效」→ 与仓内「待升级」必差 → 每个未来日期锚都在锚日引爆）。
-//   修法语义：--check 对磁盘自带「视图日期」重渲染——不依赖未来锚存在，视图日期行本身在旧实现下就会漂移。
-{
-  const d = mkfix(8);
-  const d1 = new Date(Date.now() - 24 * 3600 * 1000).toISOString().slice(0, 10);
-  const gen = spawnSync(process.execPath, [SCRIPT, '--root', d], { encoding: 'utf8', env: { ...process.env, EFFECTIVE_POLICY_TODAY: d1 } });
-  const doc = fs.readFileSync(path.join(d, 'workflow', 'effective-policy.md'), 'utf8');
-  const chk = run(d, '--check'); // 不带 env——按系统当日跑，模拟「次日对账」
-  check('场景 2f：视图日期 D1 生成的视图，次日 --check 仍一致（按磁盘视图日期重渲染，锚日不引爆）',
-    gen.status === 0 && doc.includes(`视图日期 ${d1}`) && chk.code === 0,
-    `gen=${gen.status} docViewDate=${(doc.match(/视图日期 (\S+)/) || [])[1]} check=${chk.code}\n${chk.out}`);
-}
-
-// 场景 3：非法版本号 → 回落 v1（渲染回落声明）；缺 kit.json → 同 v1
-{
-  const d = mkfix(99);
-  const r = run(d);
-  const doc = fs.readFileSync(path.join(d, 'workflow', 'effective-policy.md'), 'utf8');
-  check('场景 3a：非法 policyVersion=99 → 回落 v1 且声明回落',
-    r.code === 0 && doc.includes('**policyVersion 1**') && doc.includes('kit.json 声明 99') && doc.includes('已回落'), doc);
-  const d2 = mkfix(undefined);
-  const r2 = run(d2);
-  const doc2 = fs.readFileSync(path.join(d2, 'workflow', 'effective-policy.md'), 'utf8');
-  check('场景 3b：缺 kit.json → v1 基线', r2.code === 0 && doc2.includes('**policyVersion 1**'), doc2);
-}
-// 场景 4：待升级判定——不依赖墙钟：EFFECTIVE_POLICY_TODAY 注入 2026-09-24，
-//   v8 的 check14Since=2026-09-26 > 视图基准日 → 「待升级」；moduleSince=2026-09-22 ≤ → 「已生效」
-{
-  const d = mkfix(8);
-  const r = spawnSync(process.execPath, [SCRIPT, '--root', d], { encoding: 'utf8', env: { ...process.env, EFFECTIVE_POLICY_TODAY: '2026-09-24' } });
-  const doc = fs.readFileSync(path.join(d, 'workflow', 'effective-policy.md'), 'utf8');
-  check('场景 4：升级锚按视图基准日判定（moduleSince 已生效 / check14Since 待升级）',
-    r.status === 0 && doc.includes('`check14Since` | 2026-09-26 | 检查 14 | 新 done 的 spec/plan 须有 approved git 历史（kit 口径恒 advisory 永不升级 hard） | advisory | 待升级（2026-09-26 起）')
-      && doc.includes('`moduleSince` | 2026-09-22 | 检查 12'), doc);
-}
-
-console.log(`\n合计: PASS ${pass} / FAIL ${fail}`);
-process.exit(fail ? 1 : 0);