agentic-flow-kit 1.8.7 → 2.0.0

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

@@ -1,84 +0,0 @@
-#!/usr/bin/env node
-// check-scripts-syntax.mjs — 引擎脚本语法自检（node --check 全量扫描）
-// 用途：守护者受守护——对 .agents/scripts 与 .agents/hooks 下全部 .mjs/.cjs 逐个 node --check，
-//       任何文件不可解析即判红（先例教训：verify.mjs:31 SyntaxError 带病进 CI，全链门静默失效）。
-// 语义与红线：只读裁决，不改任何状态；检查目录缺失或可检文件数为 0 一律判红（fail-closed，
-//       防「改名/删除脚本即去门」）；不 import 任何引擎件，零依赖可独立调度。
-// 性能（2026-10-16 自源仓 scripts-syntax-parallel 回灌）：node --check 无原地解析 ESM 的 API，
-//       只能逐文件起子进程（单次 ~70ms × 全量脚本）；改工作池并发（min(8, cpus-2)），判红集合不变。
-// 测试：node .agents/scripts/check-scripts-syntax.test.mjs
-// 用法：node .agents/scripts/check-scripts-syntax.mjs [目录...]（相对仓库根；缺省 .agents/scripts .agents/hooks；
-//       CHECK_LOOP_ROOT 可覆写仓库根，与 check-loop/verify 同口径）
-// 沿革：2026-10-09 guardian-selfcheck（审计 P0-1 立项，verify.mjs GATES 首门消费）。
-
-import fs from 'node:fs';
-import os from 'node:os';
-import { spawn } from 'node:child_process';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
-const ROOT = process.env.CHECK_LOOP_ROOT || path.resolve(SCRIPT_DIR, '..', '..');
-const DEFAULT_DIRS = ['.agents/scripts', '.agents/hooks'];
-
-const dirs = process.argv.slice(2);
-const targets = dirs.length ? dirs : DEFAULT_DIRS;
-
-// 守卫文件清单（目录缺失 fail-closed；可检文件数 0 fail-closed——防「改名/删除脚本即去门」）
-const files = [];
-const missing = [];
-for (const d of targets) {
-  const abs = path.resolve(ROOT, d);
-  let names;
-  try {
-    if (!fs.statSync(abs).isDirectory()) { missing.push(d); continue; }
-    names = fs.readdirSync(abs);
-  } catch {
-    missing.push(d);
-    continue;
-  }
-  for (const f of names.filter((n) => /\.(mjs|cjs)$/.test(n)).sort()) files.push({ rel: `${d}/${f}`, abs: path.join(abs, f) });
-}
-const total = files.length;
-
-// node --check 逐文件起子进程（无 API 可原地解析 ESM 而不执行），工作池并发后墙钟 ≈ 单次 spawn ×
-// ceil(文件数/并发)。裁决口径不变：任一文件不可解析即判红，判红文件按路径排序输出（并发下不回放乱序）。
-const reds = [];
-{
-  const conc = Math.max(2, Math.min(8, os.cpus().length - 2));
-  let cursor = 0;
-  const worker = async () => {
-    while (cursor < files.length) {
-      const t = files[cursor++];
-      const r = await new Promise((resolve) => {
-        const child = spawn(process.execPath, ['--check', t.abs]);
-        let err = '';
-        child.stderr.on('data', (d) => { err += d; });
-        child.on('error', (e) => resolve({ status: null, stderr: String(e.message) }));
-        child.on('close', (status) => resolve({ status, stderr: err }));
-      });
-      if (r.status !== 0) {
-        const first = (r.stderr || '').split(/\r?\n/).find((l) => l.trim()) || `exit ${r.status}`;
-        reds.push(`[syntax] ❌ ${t.rel}: ${first}`);
-      }
-    }
-  };
-  await Promise.all(Array.from({ length: Math.min(conc, files.length) }, worker));
-  reds.sort();
-}
-
-if (missing.length) {
-  console.error(`[syntax] ❌ 检查目标目录缺失：${missing.join('、')}（fail-closed——脚本被改名/删除即去门）`);
-  process.exit(1);
-}
-if (total === 0) {
-  console.error('[syntax] ❌ 可检文件数为 0（目录为空或参数指错，fail-closed）');
-  process.exit(1);
-}
-if (reds.length) {
-  for (const line of reds) console.error(line);
-  console.error(`[syntax] 共 ${total} 个引擎脚本，${reds.length} 个不可解析`);
-  process.exit(1);
-}
-console.log(`[syntax] ✅ ${total} 个引擎脚本全部可解析（node --check）`);
-process.exit(0);

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

@@ -1,72 +0,0 @@
-#!/usr/bin/env node
-// check-scripts-syntax.mjs 的夹具测试（CHECK_LOOP_ROOT 注入临时根 + 显式目录参数，不触真实 .agents）
-// 断言：①全绿目录 exit 0 且报数；②混入语法坏件 exit 1 且点名坏文件；③目录缺失 exit 1（fail-closed）；
-//       ④空目录（可检数 0）exit 1（防「清空目录即去门」）；⑤非 .mjs/.cjs 扩展名不入扫描。
-// 用法：node .agents/scripts/check-scripts-syntax.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';
-
-const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
-const CHECKER = path.join(SCRIPT_DIR, 'check-scripts-syntax.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 mkroot = () => fs.mkdtempSync(path.join(os.tmpdir(), 'syn-fix-'));
-const run = (root, argv) => spawnSync(process.execPath, [CHECKER, ...argv], {
-  encoding: 'utf8',
-  env: { ...process.env, CHECK_LOOP_ROOT: root },
-});
-
-// ---- 场景 1：全绿目录 → exit 0 且报数 2（txt 不入扫描） ----
-{
-  const root = mkroot();
-  fs.mkdirSync(path.join(root, 'sd'), { recursive: true });
-  fs.writeFileSync(path.join(root, 'sd', 'good.mjs'), 'const a = 1;\n', 'utf8');
-  fs.writeFileSync(path.join(root, 'sd', 'good.cjs'), 'module.exports = 1;\n', 'utf8');
-  fs.writeFileSync(path.join(root, 'sd', 'note.txt'), 'not scanned\n', 'utf8');
-  const r = run(root, ['sd']);
-  check('场景 1：全绿 → exit 0', r.status === 0, `exit=${r.status}\n${r.stdout}\n${r.stderr}`);
-  check('场景 1：报数 2 且 txt 被排除', r.stdout.includes('✅ 2 个引擎脚本'), r.stdout);
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- 场景 2：语法坏件 → exit 1 且点名 ----
-{
-  const root = mkroot();
-  fs.mkdirSync(path.join(root, 'sd'), { recursive: true });
-  fs.writeFileSync(path.join(root, 'sd', 'good.mjs'), 'const a = 1;\n', 'utf8');
-  fs.writeFileSync(path.join(root, 'sd', 'broken.mjs'), 'if (true) entry.x process.env.Y;\n', 'utf8');
-  const r = run(root, ['sd']);
-  check('场景 2：混入坏件 → exit 1', r.status === 1, `exit=${r.status}`);
-  check('场景 2：stderr 点名坏文件', r.stderr.includes('sd/broken.mjs') && r.stderr.includes('1 个不可解析'), r.stderr);
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- 场景 3：目录缺失 → exit 1（fail-closed） ----
-{
-  const root = mkroot();
-  const r = run(root, ['no-such-dir']);
-  check('场景 3：目录缺失 → exit 1 且提示 fail-closed', r.status === 1 && r.stderr.includes('检查目标目录缺失'), `exit=${r.status}\n${r.stderr}`);
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- 场景 4：空目录 → exit 1（可检数 0 拒放行） ----
-{
-  const root = mkroot();
-  fs.mkdirSync(path.join(root, 'sd'), { recursive: true });
-  const r = run(root, ['sd']);
-  check('场景 4：空目录 → exit 1 且提示数为 0', r.status === 1 && r.stderr.includes('可检文件数为 0'), `exit=${r.status}\n${r.stderr}`);
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-console.log(`\n合计: PASS ${pass} / FAIL ${fail}`);
-if (fail) process.exit(1);
-process.exit(0);

package/templates/_agents/scripts/check-spec-verif.mjs

@@ -1,47 +0,0 @@
-// check-spec-verif.mjs — 检查 21：spec 验证落地核查 [warning]（2026-10-13 B6b-2 自 Shipyard.Material
-//   check-loop-sections/s21-spec-verif.mjs 回灌；段体判据逐字对齐，出处沿革留痕在包源仓 git 历史与
-//   CHANGELOG——装户径不引实例路径）
-// review P1「spec 承诺落地：spec §测试用例须真落到测试」的机器面：L2/L3 done spec 且建档日 ≥ 锚
-// （policy v9 specVerifSince；v1–v8 缺键 → 本段整体跳过），其「测试用例 / 验证计划 / 验证方式」节
-// 无测试文件或验证命令引用 → WARN（advisory——spec 可能以 UI 实测等人工可复跑方式验证，不做 hard）。
-// 缺键（v1–v8）→ 整体跳过；存量（< 锚）豁免。
-// 模块形态（kit check-hygiene / check-stage-index 先例的 run(ctx)）：判定语义单源在本文件，ctx 只传
-// check-loop.mjs 既有共享面（helper 单源在那边，复刻即造口径分叉）；warn 直接进 ctx.warnings，
-// 输出序 = check-loop 调用序（稳定输出契约）。
-// kit 适配（源仓→kit 逐条）：证据正则剔除源仓实例路径面（backend/…Tests.cs、frontend/__tests__、
-//   verify-ui）——kit 口径保留通用形态（.test.mjs / 回归清单 / 测试与门命令），见 VERIF_EVIDENCE_RE 注。
-import path from 'node:path';
-
-export function run(ctx) {
-  const { docFiles, fmGet, linesOf, addedDateOf, kitPolicy, warnings } = ctx;
-  // --- 21. spec 验证落地核查 [warning]（锚 specVerifSince）---
-  {
-    const anchor = kitPolicy.specVerifSince;
-    if (anchor) {
-      const VERIF_SEC_RE = /^##\s+.*(测试用例|验证计划|验证方式|测试与验证)/;
-      // 证据引用形态（宽匹配——门的是「验证节里有可复跑资产的身影」，不猜具体测试名）：
-      //   引擎 .test.mjs / 回归清单（kit 模板 workflow/regression-checklist.md）/ 冒烟与测试命令
-      //   （npm test、dotnet test、run-tests、check-scope、verify.mjs）。源仓实例路径面
-      //   （backend/…、\w+Tests.cs、frontend/…、verify-ui）按 instance-ref 门修法剔除，判据方向不变。
-      const VERIF_EVIDENCE_RE = /\.test\.mjs|workflow\/regression-checklist\.md|regression-smoke|npm\s+test|dotnet\s+test|run-tests|check-scope|verify\.mjs/;
-      for (const spec of docFiles('specs')) {
-        const st = fmGet(spec, '状态');
-        const lvl = fmGet(spec, '级别');
-        if (st !== 'done' || !['L2', 'L3'].includes(lvl)) continue;
-        const add = addedDateOf(spec);
-        if (!add || add < anchor) continue;
-        const lines = linesOf(spec) || [];
-        const secLines = [];
-        let inSec = false;
-        for (const l of lines) {
-          if (VERIF_SEC_RE.test(l)) { inSec = true; continue; }
-          if (inSec && /^##\s+/.test(l)) { inSec = false; continue; }
-          if (inSec) secLines.push(l);
-        }
-        if (secLines.length && !secLines.some((l) => VERIF_EVIDENCE_RE.test(l))) {
-          warnings.push(`- [WARN spec 验证落地] ${path.basename(spec)} 验证节无测试文件/验证命令引用——review P1「spec 承诺落地」要求落到可复跑验证资产`);
-        }
-      }
-    }
-  }
-}

package/templates/_agents/scripts/check-stage-index.mjs

@@ -1,40 +0,0 @@
-// check-stage-index.mjs — check-loop 检查 7 模块（阶段索引同步，2026-10-09 engine-quality-round2 A1）
-// 拆分先例 = check-hygiene.mjs（检查 2/9/11/12/13）/ check-metric-claims.mjs（检查 16）：
-//   ctx 传入既有 helper（linesOf——读异常响亮出账 + 按空文档降级的语义承载者，零复刻），
-//   模块只返回 warnings 数组，不打印、不 exit、不改 ctx。
-// 输出顺序契约：调用点位置即 warnings 插入序（check-loop 原位调用，段 id 沿 sh 版 '6'——清单编号 7
-//   不动，gate-checklist 按 id 消费面不受影响）。
-// 判据（沿 sh 版逐条）：AGENTS.md 与 .agents/commands/new-task.md 须各含全部阶段指令路径串
-//   `.agents/commands/<cmd>.md`（双向索引）；缺任一 = WARN。两文件可合法缺失（text 判空预期缺失态）。
-// 测试：node templates/_agents/scripts/check-stage-index.test.mjs
-import fs from 'node:fs';
-import path from 'node:path';
-import { gateSeg, finishSegs, makeCollector, appendSegs } from './gate-seg.mjs';
-
-const STAGE_CMDS = ['plan', 'design', 'build', 'test', 'deploy', 'maintain', 'review'];
-const FACE_DOCS = ['AGENTS.md', '.agents/commands/new-task.md'];
-
-export function runCheckStageIndex(ctx) {
-  const { root: ROOT, linesOf } = ctx;
-  const warnings = [];
-  // 插桩（selfmeasure 先例）：局部收集器 + appendSegs 并入全局——模块产出局部数组，直接共用全局
-  // 游标会错账（check-hygiene.mjs:36-39 实测教训）
-  const localStats = makeCollector(warnings, []);
-  const markGate = (id, label) => { if (ctx.gateStats) gateSeg(localStats, id, label); };
-
-  markGate('6', '阶段索引同步');
-  for (const cmd of STAGE_CMDS) {
-    for (const doc of FACE_DOCS) {
-      // existsSync 守卫（2026-10-06-check19-entry-enoent 同类）：两文件可合法缺失（下方 text 判空本就
-      // 预期缺失态），fail-loud fs 读下按空跳过、不再响亮出账
-      const docPath = path.join(ROOT, doc);
-      const text = fs.existsSync(docPath) ? linesOf(docPath) : null;
-      if (text && !text.some((l) => l.includes(`.agents/commands/${cmd}.md`))) {
-        warnings.push(`- [WARN 阶段索引漂移] ${doc} 缺 ${cmd} 指令索引(两处阶段表须同步维护)`);
-      }
-    }
-  }
-
-  if (ctx.gateStats) appendSegs(ctx.gateStats, finishSegs(localStats));
-  return warnings;
-}

package/templates/_agents/scripts/check-stage-index.test.mjs

@@ -1,77 +0,0 @@
-// check-stage-index.test.mjs — 检查 7 模块直测（2026-10-09 engine-quality-round2 A1）
-// 四面：全绿 / AGENTS 侧缺索引 / new-task 文件缺失合法 / gate-seg 段归属（局部收集器并入）
-import fs from 'node:fs';
-import path from 'node:path';
-import os from 'node:os';
-import { runCheckStageIndex } from './check-stage-index.mjs';
-import { makeCollector, finishSegs } from './gate-seg.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}` : ''}`); }
-};
-
-// ctx 构造：linesOf 提供读异常→null 语义（与 check-loop 内部实现同语义；「判定零复刻」指模块不重写
-// 判据，测试 fixture 提供测试版 helper 是 check-hygiene.test 先例）
-function makeCtx(root, overrides = {}) {
-  const fileLinesCache = new Map();
-  const linesOf = (file) => {
-    if (!fileLinesCache.has(file)) {
-      let lines = null;
-      try { lines = fs.readFileSync(file, 'utf8').split(/\r?\n/); } catch { lines = null; }
-      fileLinesCache.set(file, lines);
-    }
-    return fileLinesCache.get(file);
-  };
-  return { root, linesOf, ...overrides };
-}
-const ROUTES = '.agents/commands/plan.md → .agents/commands/design.md → .agents/commands/build.md → .agents/commands/test.md → .agents/commands/deploy.md → .agents/commands/maintain.md';
-const mkRoot = (agentsBody, newTaskBody, { noAgents, noNewTask } = {}) => {
-  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'csi-'));
-  fs.mkdirSync(path.join(root, '.agents', 'commands'), { recursive: true });
-  if (!noAgents) fs.writeFileSync(path.join(root, 'AGENTS.md'), agentsBody);
-  if (!noNewTask) fs.writeFileSync(path.join(root, '.agents', 'commands', 'new-task.md'), newTaskBody);
-  return root;
-};
-const FULL = `# AGENTS\n\n${ROUTES}\n\n**横切**：.agents/commands/review.md\n`;
-const FULL_NT = `# new-task\n\n| Plan | ${ROUTES} | Review(.agents/commands/review.md) |\n`;
-
-{
-  // ① 双面全索引 → 零告警
-  const root = mkRoot(FULL, FULL_NT);
-  const r = runCheckStageIndex(makeCtx(root));
-  check('① 双面全索引 → 零告警', r.length === 0, JSON.stringify(r));
-  fs.rmSync(root, { recursive: true, force: true });
-}
-{
-  // ② AGENTS 侧缺 plan → 仅 AGENTS.md 侧告警（new-task 索引齐全不误报）
-  const root = mkRoot(FULL.replace('.agents/commands/plan.md → ', ''), FULL_NT);
-  const r = runCheckStageIndex(makeCtx(root));
-  check('② AGENTS 侧缺 plan → WARN 点名 AGENTS.md',
-    r.some((w) => w.includes('AGENTS.md 缺 plan 指令索引')), JSON.stringify(r));
-  check('② new-task 侧不告警（其索引齐全）', !r.some((w) => w.includes('new-task.md 缺')), JSON.stringify(r));
-  fs.rmSync(root, { recursive: true, force: true });
-}
-{
-  // ③ new-task 文件不存在 = 合法缺失态（existsSync 守卫）→ 零告警
-  const root = mkRoot(FULL, FULL_NT, { noNewTask: true });
-  const r = runCheckStageIndex(makeCtx(root));
-  check('③ new-task 文件缺失 → 合法缺失零告警', r.length === 0, JSON.stringify(r));
-  fs.rmSync(root, { recursive: true, force: true });
-}
-{
-  // ④ gate-seg 段归属：ctx.gateStats 在场时段 '6' 入账、warns 与实际 WARN 数一致（selfmeasure 接线
-  //   教训：模块须用局部收集器 + appendSegs，直接共用全局游标会错账）
-  const root = mkRoot(FULL.replace('.agents/commands/plan.md → ', ''), FULL_NT);
-  const stats = makeCollector([], []);
-  const r = runCheckStageIndex(makeCtx(root, { gateStats: stats }));
-  const seg6 = finishSegs(stats).filter((s) => s.id === '6');
-  check('④ gate-seg：段 6 入账一次且 warns 与实际 WARN 数一致',
-    seg6.length === 1 && seg6[0].warns === r.length && r.length === 1,
-    JSON.stringify({ seg6, ret: r }));
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-console.log(`\n合计: PASS ${pass} / FAIL ${fail}`);
-process.exit(fail ? 1 : 0);

package/templates/_agents/scripts/closeout-l1.mjs

@@ -1,217 +0,0 @@
-#!/usr/bin/env node
-// closeout-l1 — L1 关单一把编排（2026-10-15 减重手段④ 自源仓回灌：记录性动作一把生成，判断留给人）
-// 把 test.md §6 的 L1 关单链（预检 → confirm-doc 代录 → INDEX 重生成 → 提交清单）收进一条命令。
-// 用法：node .agents/scripts/closeout-l1.mjs <workflow/plans/xxx.md>              # 预检模式：只查差距，不落任何状态
-//       node .agents/scripts/closeout-l1.mjs <plan> --delegated "<用户对话原话>"   # 执行模式：预检过 → confirm-doc 代录 → 重生成 INDEX
-//       （可加 --root <仓库根>；缺省 git toplevel，无 git 用 cwd）
-// 边界（判据单源，本工具不复制强判断）：
-//   - 证据格式 / approved 历史 / 测试绿硬门 = confirm-doc（stage-gates/policy 单源），本工具预检只是
-//     提前暴露差距的 advisory 快筛；执行模式原样转发 confirm-doc，其拒绝即本命令拒绝。
-//   - --delegated 调用纪律：AI 须先取得用户对话内明确放行（AGENTS.md 确认门条款），原话入账供对质。
-//   - L2/L3 不受理（spec 收敛对账 + 独立复核是防御道本体，不做捷径）；incidents 不受理（两跳制）。
-// kit 适配（源仓→kit 逐条）：① 源仓引用 test.md §5/§5.5，kit 关单链在 test.md §6；② verify 预检
-//   镜像 kit done 前置口径（policy v6+ 按 verifyDocSince 绑定本单绿行，不带 --doc 的绿行不给背书）；
-//   ③ 分片路径修复：源仓 main() 拼 `<基名.md>.jsonl`，而 confirm-doc/ledger-loader 写入口径是
-//   `<基名>.jsonl`（basename 去 .md）——源仓提交清单会把分片误报成主台账（其测试只盖纯函数未暴露），
-//   kit 抽 shardOf 纯函数修正并补断言。
-// 测试：node .agents/scripts/closeout-l1.test.mjs（parseArgs / fmOf / acceptanceOf / preflight / shardOf 纯函数进程内断言）
-import fs from 'node:fs';
-import path from 'node:path';
-import { spawnSync } from 'node:child_process';
-import { fileURLToPath } from 'node:url';
-import { hasFreshVerifyLine, loadKitPolicy } from './policy.mjs';
-
-const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
-
-// parseArgs(argv)：{ plan, delegated, root } | { error }
-export function parseArgs(argv = []) {
-  const out = { plan: null, delegated: null, root: null, error: null };
-  for (let i = 0; i < argv.length; i++) {
-    const a = argv[i];
-    if (a === '--delegated') {
-      out.delegated = argv[++i];
-      if (!out.delegated) out.error = '--delegated 须带「<用户对话原话>」参数';
-    } else if (a.startsWith('--delegated=')) {
-      out.delegated = a.slice('--delegated='.length);
-    } else if (a === '--root') {
-      out.root = argv[++i];
-      if (!out.root) out.error = '--root 须带仓库根路径';
-    } else if (!a.startsWith('--')) {
-      if (out.plan) out.error = `只受理一份 plan（现已有 ${out.plan}）`;
-      else out.plan = a;
-    } else {
-      out.error = `未知参数 ${a}`;
-    }
-  }
-  if (!out.error && !out.plan) out.error = '用法：node .agents/scripts/closeout-l1.mjs <workflow/plans/xxx.md> [--delegated "<用户对话原话>"] [--root <仓库根>]';
-  return out;
-}
-
-// frontmatter 平铺解析（key: value；本工具只消费 状态/级别 两个键）
-export function fmOf(text) {
-  const lines = String(text).replace(/\r\n/g, '\n').split('\n');
-  if (!/^---\s*$/.test(lines[0] || '')) return {};
-  const fm = {};
-  for (let i = 1; i < lines.length; i++) {
-    if (/^---\s*$/.test(lines[i])) break;
-    const m = /^([^\s:]+):\s*(.*)$/.exec(lines[i]);
-    if (m) fm[m[1]] = m[2].trim();
-  }
-  return fm;
-}
-
-// acceptanceOf(text)：定位「## …验收标准…」节，统计勾选框条目。
-// 返回 { found, total, unchecked: [条目文本] }；节内无任何勾选框条目 → found=true, total=0（判为异常）。
-export function acceptanceOf(text) {
-  const lines = String(text).replace(/\r\n/g, '\n').split('\n');
-  let start = -1;
-  for (let i = 0; i < lines.length; i++) {
-    if (/^##\s/.test(lines[i]) && lines[i].includes('验收标准')) { start = i; break; }
-    if (i > 0 && /^##\s/.test(lines[i]) && start >= 0) break; // 上一节结束仍无（不可达，防御）
-  }
-  if (start < 0) return { found: false, total: 0, unchecked: [] };
-  const unchecked = [];
-  let total = 0;
-  for (let i = start + 1; i < lines.length; i++) {
-    if (/^##\s/.test(lines[i])) break; // 节结束
-    const m = /^\s*-\s*\[([ xX])\]\s*(.*)$/.exec(lines[i]);
-    if (!m) continue;
-    total++;
-    if (m[1] === ' ') unchecked.push(m[2].trim());
-  }
-  return { found: true, total, unchecked };
-}
-
-// preflight({ rel, text, freshVerify })：L1 关单前置快筛（advisory；强门在 confirm-doc）。
-// 返回 { ok, problems: [], level, status, total, checked }。
-export function preflight({ rel, text, freshVerify }) {
-  const problems = [];
-  if (!/^workflow\/plans\/[^/]+\.md$/.test(rel) || rel.includes('_TEMPLATE')) {
-    problems.push(`路径须为 workflow/plans/ 直下文档（现「${rel}」）——L2/L3 intent/spec 与 incidents 不在本工具受理面`);
-  }
-  const fm = fmOf(text);
-  const level = fm['级别'] || '';
-  const status = fm['状态'] || '';
-  if (level !== 'L1') {
-    problems.push(`级别「${level || '缺失'}」≠ L1——L2/L3 关单走 .agents/commands/test.md 全流程（验收判据对账 + 独立复核），本工具只服务协作道 L1`);
-  }
-  if (status === 'done' || status === 'superseded' || status === 'cancelled') {
-    problems.push(`状态已为终态「${status}」——本 plan 已收口，无需重复关单`);
-  } else if (status !== 'approved') {
-    problems.push(`状态「${status || '缺失'}」≠ approved——draft 须先过起草确认（confirm-doc approved），关单只受理 approved → done`);
-  }
-  const acc = acceptanceOf(text);
-  if (!acc.found) {
-    problems.push('未找到「## 验收标准」节——L1 plan 须有可勾验的验收标准（模板口径）');
-  } else if (acc.total === 0) {
-    problems.push('「验收标准」节内无勾选框条目（- [ ] / - [x]）——验收标准须逐条可勾验');
-  } else if (acc.unchecked.length) {
-    problems.push(`验收标准 ${acc.unchecked.length}/${acc.total} 条未勾验（勾验与补证据是判断动作，留在关单前完成）：`);
-    for (const u of acc.unchecked) problems.push(`    - [ ] ${u}`);
-  }
-  if (!freshVerify) {
-    problems.push('24h 内无本单绑定的 verify 绿行（.agents/verifications.jsonl）——先跑 node .agents/scripts/verify.mjs --doc <本单路径>（全绿自动落绿凭证与 verify-evidence 摘要；v6+ 只认带本单 --doc 的绿行）');
-  }
-  return { ok: problems.length === 0, problems, level, status, total: acc.total, checked: acc.total - acc.unchecked.length };
-}
-
-// shardOf(rel)：该 plan 的确认台账分片路径（posix，仓库根相对）。写入口径单源 = ledger-loader
-// writeConfirmation（basename 去 .md）——源仓首版此处拼了 `<基名.md>.jsonl`，提交清单会漏列分片。
-export function shardOf(rel) {
-  return path.join('.agents', 'confirmations.d', `${path.basename(rel, '.md')}.jsonl`);
-}
-
-function gitRoot() {
-  const r = spawnSync('git', ['rev-parse', '--show-toplevel'], { encoding: 'utf8' });
-  return r.status === 0 && r.stdout.trim() ? r.stdout.trim() : process.cwd();
-}
-
-// freshVerifyOf(root, rel)：镜像 kit confirm-doc done 前置的绿行口径（判定单源 policy.hasFreshVerifyLine）：
-// policy v5+（verifySince）才有 24h 绿行门；v6+（verifyDocSince）按本 doc 精确绑定。预检与强门同口径，
-// 差距快筛才不失真。只读，台账缺失/不可读一律 false（advisory 层 fail-open，同 confirm-doc）。
-function freshVerifyOf(root, rel) {
-  try {
-    const p = path.join(root, '.agents', 'verifications.jsonl');
-    if (!fs.existsSync(p)) return false;
-    const pol = loadKitPolicy(root);
-    if (typeof pol.verifySince !== 'string') return true; // v1-v4 无绿行门 → 预检不产差距
-    const bound = typeof pol.verifyDocSince === 'string' ? rel : null;
-    return hasFreshVerifyLine(fs.readFileSync(p, 'utf8').split(/\r?\n/), Date.now(), bound);
-  } catch {
-    return false;
-  }
-}
-
-function findArchived(root, rel) {
-  const base = path.basename(rel);
-  for (const monthDir of fs.existsSync(path.join(root, 'workflow', 'archive'))
-    ? fs.readdirSync(path.join(root, 'workflow', 'archive')) : []) {
-    const cand = path.join('workflow', 'archive', monthDir, 'plans', base);
-    if (fs.existsSync(path.join(root, cand))) return cand;
-  }
-  return null;
-}
-
-function main() {
-  const args = parseArgs(process.argv.slice(2));
-  if (args.error) {
-    console.error(`closeout-l1: ${args.error}`);
-    process.exit(2);
-  }
-  const root = path.resolve(args.root || gitRoot());
-  const rel = path.relative(root, path.resolve(args.plan)).replace(/\\/g, '/');
-  const abs = path.join(root, rel);
-  if (!fs.existsSync(abs)) {
-    console.error(`closeout-l1: 文件不存在 ${rel}（相对仓库根 ${root}）`);
-    process.exit(2);
-  }
-  const text = fs.readFileSync(abs, 'utf8');
-  const pf = preflight({ rel, text, freshVerify: freshVerifyOf(root, rel) });
-
-  console.log(`L1 关单预检｜${rel}`);
-  console.log(`  级别 ${pf.level || '—'}｜状态 ${pf.status || '—'}｜验收 ${pf.checked}/${pf.total || 0} 勾验｜verify 绿行 ${pf.problems.some((p) => p.includes('verify')) ? '✗' : '✓(24h)'}`);
-  if (!pf.ok) {
-    console.error(`\n预检未过（${pf.problems.length} 项差距，逐条处理后再来）：`);
-    for (const p of pf.problems) console.error(`  ✗ ${p}`);
-    process.exit(2);
-  }
-  console.log('  预检通过。');
-
-  if (!args.delegated) {
-    console.log('\n下一步（执行关单，须先取得用户对话内明确放行）：');
-    console.log(`  node .agents/scripts/closeout-l1.mjs ${rel} --delegated "<用户确认原话>"`);
-    return;
-  }
-
-  // 执行模式：confirm-doc 原样转发（全部强门在彼处），随后重生成 INDEX。
-  const cd = spawnSync(process.execPath, [
-    path.join(SCRIPT_DIR, 'confirm-doc.mjs'), rel, '--delegated', args.delegated, '--root', root,
-  ], { stdio: 'inherit' });
-  if (cd.status !== 0) {
-    console.error(`closeout-l1: confirm-doc 拒绝（exit ${cd.status}）——按上方提示修复后重试；本命令不做任何绕过。`);
-    process.exit(cd.status === null ? 2 : cd.status);
-  }
-  const gi = spawnSync(process.execPath, [path.join(SCRIPT_DIR, 'gen-workflow-index.mjs')], { cwd: root, encoding: 'utf8' });
-  if (gi.status !== 0) {
-    console.error('closeout-l1: ⚠️ INDEX 重生成失败（确认已落账不可回滚；提交前须手动跑 node .agents/scripts/gen-workflow-index.mjs 修齐，否则索引漂移门会拦提交）');
-  }
-
-  // 汇总：关单后的落盘面与提交清单（归档 mv 时给出新路径）。
-  const base = path.basename(rel);
-  const archivedTo = fs.existsSync(abs) ? null : findArchived(root, rel);
-  const shard = shardOf(rel);
-  const adds = [
-    archivedTo || rel,
-    fs.existsSync(path.join(root, shard)) ? shard : '.agents/confirmations.jsonl',
-    'workflow/INDEX.md',
-  ];
-  console.log(`\n关单完成：approved → done（台账已记 chat-delegated，原话入账供对质）`);
-  if (archivedTo) console.log(`📦 已随确认滚动归档：${rel} → ${archivedTo}（家族原子，git mv 已暂存）`);
-  console.log(`提交清单（git add）：
-  ${adds.join('\n  ')}`);
-  console.log(`建议提交说明：docs(workflow): 关单 ${base.replace(/\.md$/, '')}（L1 done）——用户对话内确认代录${archivedTo ? `，归档至 ${path.dirname(archivedTo)}/` : ''}`);
-  console.log('提醒：本会话自做任务另记 workflow/delegations.md 并跑 agg-delegations.mjs（test.md §6）；verify-evidence.md 有改动时随同提交。');
-}
-
-const isMain = process.argv[1] && process.argv[1].endsWith('closeout-l1.mjs');
-if (isMain) main();

package/templates/_agents/scripts/closeout-l1.test.mjs

@@ -1,105 +0,0 @@
-#!/usr/bin/env node
-// closeout-l1.test.mjs — L1 关单编排纯函数套件（2026-10-15 减重手段④ 自源仓回灌随附）
-// parseArgs / fmOf / acceptanceOf / preflight / shardOf 进程内断言：快筛差距逐项暴露、
-// L2/L3 与终态件不受理、勾验缺一即拦、verify 凭证缺失即拦、分片路径与写入口径同形。
-// 运行：node templates/_agents/scripts/closeout-l1.test.mjs
-import { parseArgs, fmOf, acceptanceOf, preflight, shardOf } from './closeout-l1.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 PLAN_OK = `---
-状态: approved
-级别: L1
-模块: purchase
----
-# PLAN — demo
-
-## 改动方案
-
-- 改 A
-
-## 验收标准（可测试）
-
-- [x] 判据一（证据：UI 实测 A1 PASS）
-- [x] 判据二（证据：UT 用例名 demo_case）
-`;
-
-// ---- A1 parseArgs ----
-{
-  const a = parseArgs(['workflow/plans/x.md', '--delegated', '可以关单', '--root', 'E:/r']);
-  check('A1 三参齐解析', a.plan === 'workflow/plans/x.md' && a.delegated === '可以关单' && a.root === 'E:/r' && !a.error, JSON.stringify(a));
-  check('A1 缺 plan → error', !!parseArgs(['--delegated', 'q']).error);
-  check('A1 --delegated 缺值 → error', !!parseArgs(['workflow/plans/x.md', '--delegated']).error);
-  check('A1 未知参数 → error', !!parseArgs(['workflow/plans/x.md', '--wow']).error);
-  check('A1 两份 plan → error', !!parseArgs(['a.md', 'b.md']).error);
-  check('A1 --delegated= 等号形态', parseArgs(['x.md', '--delegated=原话']).delegated === '原话');
-}
-
-// ---- A2 fmOf / acceptanceOf ----
-{
-  const fm = fmOf(PLAN_OK);
-  check('A2 frontmatter 状态/级别', fm['状态'] === 'approved' && fm['级别'] === 'L1' && fm['模块'] === 'purchase', JSON.stringify(fm));
-  const acc = acceptanceOf(PLAN_OK);
-  check('A2 验收节 2 条全勾', acc.found === true && acc.total === 2 && acc.unchecked.length === 0, JSON.stringify(acc));
-  check('A2 无验收节 → found=false', acceptanceOf('# 无节文档\n\n- [ ] 孤儿勾选不算').found === false);
-  const mixed = acceptanceOf('## 验收标准\n\n- [x] 甲\n- [ ] 乙待办\n- [X] 丙大写勾\n\n## 下一节\n\n- [ ] 节外不算\n');
-  check('A2 未勾只数节内（乙），大写 X 认勾、节外不计', mixed.total === 3 && mixed.unchecked.length === 1 && mixed.unchecked[0] === '乙待办', JSON.stringify(mixed));
-  check('A2 节在无勾选框条目 → total=0', acceptanceOf('## 验收标准\n\n纯文字段\n').total === 0);
-}
-
-// ---- A3 preflight 快乐路径 ----
-{
-  const pf = preflight({ rel: 'workflow/plans/2026-10-15-demo.md', text: PLAN_OK, freshVerify: true });
-  check('A3 L1+approved+全勾+有凭证 → ok', pf.ok === true && pf.problems.length === 0 && pf.checked === 2, JSON.stringify(pf));
-}
-
-// ---- A4 级别/状态不受理 ----
-{
-  const l2 = preflight({ rel: 'workflow/plans/x.md', text: PLAN_OK.replace('级别: L1', '级别: L2'), freshVerify: true });
-  check('A4 L2 → 拒并指回 test.md', !l2.ok && l2.problems.some((p) => p.includes('L2/L3') && p.includes('test.md')), JSON.stringify(l2.problems));
-  const draft = preflight({ rel: 'workflow/plans/x.md', text: PLAN_OK.replace('状态: approved', '状态: draft'), freshVerify: true });
-  check('A4 draft → 拒（须先过起草确认）', !draft.ok && draft.problems.some((p) => p.includes('draft')), JSON.stringify(draft.problems));
-  const done = preflight({ rel: 'workflow/plans/x.md', text: PLAN_OK.replace('状态: approved', '状态: done'), freshVerify: true });
-  check('A4 done → 拒（已收口）', !done.ok && done.problems.some((p) => p.includes('终态')), JSON.stringify(done.problems));
-  check('A4 级别缺失也拒（fail-closed）', !preflight({ rel: 'workflow/plans/x.md', text: PLAN_OK.replace('级别: L1\n', ''), freshVerify: true }).ok);
-}
-
-// ---- A5 路径受理面 ----
-{
-  check('A5 intents 路径不受理', !preflight({ rel: 'workflow/intents/x.md', text: PLAN_OK, freshVerify: true }).ok);
-  check('A5 incidents 路径不受理', !preflight({ rel: 'workflow/incidents/x.md', text: PLAN_OK, freshVerify: true }).ok);
-  check('A5 模板不受理', !preflight({ rel: 'workflow/plans/_TEMPLATE.md', text: PLAN_OK, freshVerify: true }).ok);
-  check('A5 子目录路径不受理', !preflight({ rel: 'workflow/plans/sub/x.md', text: PLAN_OK, freshVerify: true }).ok);
-}
-
-// ---- A6 勾验与凭证差距 ----
-{
-  const unchecked = preflight({
-    rel: 'workflow/plans/x.md',
-    text: PLAN_OK.replace('- [x] 判据二（证据：UT 用例名 demo_case）', '- [ ] 判据二'),
-    freshVerify: true,
-  });
-  check('A6 未勾验逐条列出（计数行 + 条目行分项）', !unchecked.ok
-    && unchecked.problems.some((p) => p.includes('1/2 条未勾验'))
-    && unchecked.problems.some((p) => p.includes('判据二')), JSON.stringify(unchecked.problems));
-  const noVerify = preflight({ rel: 'workflow/plans/x.md', text: PLAN_OK, freshVerify: false });
-  check('A6 verify 凭证缺失 → 拦并指 verify.mjs --doc', !noVerify.ok && noVerify.problems.some((p) => p.includes('verify.mjs') && p.includes('--doc')), JSON.stringify(noVerify.problems));
-  const noAcc = preflight({ rel: 'workflow/plans/x.md', text: PLAN_OK.split('## 验收标准')[0], freshVerify: true });
-  check('A6 无验收节 → 拦', !noAcc.ok && noAcc.problems.some((p) => p.includes('验收标准')));
-}
-
-// ---- A7 shardOf：与 ledger-loader writeConfirmation 写入口径同形（<基名去.md>.jsonl）----
-// 源仓首版 main() 拼 `<基名.md>.jsonl` 与写入口径错位——提交清单会把分片误报成主台账。本断言钉死修正。
-{
-  const s = shardOf('workflow/plans/2026-10-15-demo.md');
-  check('A7 分片路径 = confirmations.d/<基名>.jsonl（去 .md）', s.replace(/\\/g, '/') === '.agents/confirmations.d/2026-10-15-demo.jsonl', s);
-  check('A7 分片路径不含 .md.jsonl 双后缀', !s.replace(/\\/g, '/').includes('.md.jsonl'), s);
-}
-
-console.log(`\n合计: PASS ${pass} / FAIL ${fail}`);
-process.exit(fail ? 1 : 0);