agentic-flow-kit 1.8.7 → 2.1.0

package/templates/_agents/scripts/judgment-ledger.test.mjs

@@ -1,129 +0,0 @@
-#!/usr/bin/env node
-// judgment-ledger.test.mjs — 判定流水落账套件（2026-10-11 judgment-ledger）
-// 纯函数 tallyJudgments 进程内断言 + recordRun 落账行为（临时根目录 + 环境守卫）。
-// 守卫口径：CHECK_LOOP_ROOT（fixture 模式）/ CHECK_LOOP_NO_LEDGER 任一在即不落账——
-// 进程内切换环境变量须保存/恢复，防污染同进程后续用例。
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { spawnSync } from 'node:child_process';
-import { fileURLToPath } from 'node:url';
-import { tallyJudgments, recordRun, LEDGER_REL } from './judgment-ledger.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 : ''}`); }
-};
-
-// ---- S1 tallyJudgments：标签解析 / 级别分流 / 计数 / 确定性排序 ----
-{
-  const out = tallyJudgments(
-    ['- [配对断裂] incident 缺 plan:x.md', '- [配对断裂] incident 缺 plan:y.md', '- [回路断档] 选「是」未指明 intent'],
-    ['- [WARN 三件套不全] x.md 缺之 2', '- [WARN 归因缺字段] x.md 缺「来源:」', '- [WARN 三件套不全] y.md 缺之 3', '无标签散行'],
-  );
-  check('S1 BLOCK/WARN 分流计数', out.some((r) => r.rule === '配对断裂' && r.level === 'BLOCK' && r.count === 2)
-    && out.some((r) => r.rule === '回路断档' && r.level === 'BLOCK' && r.count === 1)
-    && out.some((r) => r.rule === '三件套不全' && r.level === 'WARN' && r.count === 2)
-    && out.some((r) => r.rule === '归因缺字段' && r.level === 'WARN' && r.count === 1), JSON.stringify(out));
-  check('S1 无标签行归「未标注」WARN', out.some((r) => r.rule === '未标注' && r.level === 'WARN' && r.count === 1), JSON.stringify(out));
-  const keys = out.map((r) => r.level + r.rule);
-  // 与实现同款 localeCompare 排序比对——被测不变量是「确定性」而非特定 collation（中文 locale 与码位排序不同）
-  const sorted = [...keys].sort((a, b) => a.localeCompare(b));
-  check('S1 输出按 level+rule 排序（确定性）', JSON.stringify(keys) === JSON.stringify(sorted), JSON.stringify(keys));
-  check('S1 空入参 → 空数组', tallyJudgments([], []).length === 0);
-}
-
-// ---- S2 recordRun：真落账（临时根，rev 为 null 因非 git 目录）----
-{
-  const saved = { loopRoot: process.env.CHECK_LOOP_ROOT, noLedger: process.env.CHECK_LOOP_NO_LEDGER };
-  delete process.env.CHECK_LOOP_ROOT;
-  delete process.env.CHECK_LOOP_NO_LEDGER;
-  try {
-    const T = fs.mkdtempSync(path.join(os.tmpdir(), 'jledger-'));
-    const now = new Date('2026-10-11T01:02:03.000Z');
-    recordRun({ root: T, mode: 'hygiene', blockers: ['- [配对断裂] a'], warnings: ['- [WARN 归因缺字段] b'], now });
-    const p = path.join(T, LEDGER_REL);
-    const rows = fs.existsSync(p) ? fs.readFileSync(p, 'utf8').split(/\r?\n/).filter(Boolean).map((l) => JSON.parse(l)) : [];
-    check('S2 追加一行且字段齐（ts/mode/rev/计数/rules）',
-      rows.length === 1 && rows[0].ts === '2026-10-11T01:02:03.000Z' && rows[0].mode === 'hygiene'
-      && rows[0].blockers === 1 && rows[0].warnings === 1
-      && Array.isArray(rows[0].rules) && rows[0].rules.length === 2, JSON.stringify(rows));
-    recordRun({ root: T, mode: 'hard', blockers: [], warnings: [], now });
-    const lines = fs.readFileSync(p, 'utf8').split(/\r?\n/).filter(Boolean);
-    check('S2 二次调用追加不覆盖（append-only）', lines.length === 2, String(lines.length));
-  } finally {
-    if (saved.loopRoot !== undefined) process.env.CHECK_LOOP_ROOT = saved.loopRoot;
-    if (saved.noLedger !== undefined) process.env.CHECK_LOOP_NO_LEDGER = saved.noLedger;
-  }
-}
-
-// ---- S3 双守卫：CHECK_LOOP_ROOT / CHECK_LOOP_NO_LEDGER 任一在 → 不落账 ----
-{
-  const saved = { loopRoot: process.env.CHECK_LOOP_ROOT, noLedger: process.env.CHECK_LOOP_NO_LEDGER };
-  try {
-    for (const guard of ['CHECK_LOOP_ROOT', 'CHECK_LOOP_NO_LEDGER']) {
-      delete process.env.CHECK_LOOP_ROOT;
-      delete process.env.CHECK_LOOP_NO_LEDGER;
-      process.env[guard] = '1';
-      const T = fs.mkdtempSync(path.join(os.tmpdir(), 'jledger-guard-'));
-      recordRun({ root: T, mode: 'hard', blockers: [], warnings: [] });
-      check(`S3 ${guard} 在 → 不落账`, !fs.existsSync(path.join(T, LEDGER_REL)));
-    }
-  } finally {
-    if (saved.loopRoot !== undefined) process.env.CHECK_LOOP_ROOT = saved.loopRoot; else delete process.env.CHECK_LOOP_ROOT;
-    if (saved.noLedger !== undefined) process.env.CHECK_LOOP_NO_LEDGER = saved.noLedger; else delete process.env.CHECK_LOOP_NO_LEDGER;
-  }
-}
-
-// ---- S4 落账失败 fail-open（root 指向文件而非目录 → append 必败，只 stderr 不 throw）----
-{
-  const saved = { loopRoot: process.env.CHECK_LOOP_ROOT, noLedger: process.env.CHECK_LOOP_NO_LEDGER };
-  delete process.env.CHECK_LOOP_ROOT;
-  delete process.env.CHECK_LOOP_NO_LEDGER;
-  try {
-    const T = fs.mkdtempSync(path.join(os.tmpdir(), 'jledger-bad-'));
-    const filePath = path.join(T, '.agents'); // 占住 .agents 为普通文件 → mkdirSync 必败
-    fs.writeFileSync(filePath, 'not a dir');
-    let threw = false;
-    try {
-      recordRun({ root: T, mode: 'hard', blockers: [], warnings: [] });
-    } catch {
-      threw = true;
-    }
-    check('S4 落账失败不 throw（fail-open）', threw === false);
-  } finally {
-    if (saved.loopRoot !== undefined) process.env.CHECK_LOOP_ROOT = saved.loopRoot; else delete process.env.CHECK_LOOP_ROOT;
-    if (saved.noLedger !== undefined) process.env.CHECK_LOOP_NO_LEDGER = saved.noLedger; else delete process.env.CHECK_LOOP_NO_LEDGER;
-  }
-}
-
-// ---- S5 端到端：真实 check-loop.mjs fixture 运行不落账（CHECK_LOOP_ROOT 守卫在 spawn 态同样生效）----
-{
-  const T = fs.mkdtempSync(path.join(os.tmpdir(), 'jledger-e2e-'));
-  for (const s of ['intents', 'specs', 'plans', 'incidents']) fs.mkdirSync(path.join(T, 'workflow', s), { recursive: true });
-  fs.mkdirSync(path.join(T, '.agents'), { recursive: true });
-  // 枚举单源随夹具内联（kit 契约：.agents/workflow-enums.txt，缺文件 fail-loud）——键集沿 verify.test.mjs mkfix 同款
-  fs.writeFileSync(path.join(T, '.agents', 'workflow-enums.txt'), [
-    'doc.status.all=draft approved done superseded cancelled',
-    'doc.status.confirmed=approved done superseded cancelled',
-    'doc.status.active=draft approved',
-    'doc.status.terminal=done superseded cancelled',
-    'doc.status.abandoned=superseded cancelled',
-    'incident.status.all=open fixed closed',
-    'incident.status.active=open',
-    'level.all=L1 L2 L3',
-    '',
-  ].join('\n'), 'utf8');
-  const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
-  // 裸跑=默认硬门（2026-10-13 分道，kit 与源仓同构 hard/hygiene/all 三面）——落账守卫断言与运行面无关，裸跑即可
-  const r = spawnSync(process.execPath, [path.join(SCRIPT_DIR, 'check-loop.mjs')],
-    { env: { ...process.env, CHECK_LOOP_ROOT: T }, cwd: T, encoding: 'utf8' });
-  check('S5 fixture 态 spawn 运行不落账（守卫在子进程同样生效）',
-    !fs.existsSync(path.join(T, LEDGER_REL)), `exit=${r.status} ${r.stderr || ''}`);
-  fs.rmSync(T, { recursive: true, force: true });
-}
-
-console.log(`\n合计: PASS ${pass} / FAIL ${fail}`);
-process.exit(fail ? 1 : 0);

package/templates/_agents/scripts/kb-cache-evict.mjs

@@ -1,50 +0,0 @@
-#!/usr/bin/env node
-// kb-search 结构缓存推送式失效（2026-09-23 intent kb-cache-post-commit-evict）
-// 用途：.githooks/post-commit 把 `git diff-tree --name-only HEAD` 的清单经 stdin 传入，
-//   摘除本次提交触及的 workflow/、wiki/ 文件在 .agents/cache/kb-index.json 中的全部命名空间条目，
-//   收敛 [mtimeMs,size] 两元组的「同刻同尺寸」失效盲区至提交时点。
-// 语义：非阻断维护——一切坏输入（缺缓存/坏 JSON/stdin 不可读）静默 exit 0；命中才回写且保留原 fp。
-// 测试：node .agents/scripts/kb-cache-evict.test.mjs（--cache 指向临时文件，不触真实缓存）
-// 用法：kb-cache-evict.mjs [--files-from <path>] [--cache <path>]；二者缺省时读 stdin 与默认缓存。
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
-const args = process.argv.slice(2);
-const opt = (name) => {
-  const i = args.indexOf(name);
-  return i > -1 ? args[i + 1] : '';
-};
-
-function readList() {
-  const from = opt('--files-from');
-  if (from) {
-    try { return fs.readFileSync(from, 'utf8'); } catch { return ''; }
-  }
-  if (process.stdin.isTTY) return '';
-  try { return fs.readFileSync(0, 'utf8'); } catch { return ''; }
-}
-
-const cacheFile = opt('--cache') || path.join(SCRIPT_DIR, '..', 'cache', 'kb-index.json');
-const files = [...new Set(
-  readList()
-    .split(/\r?\n/)
-    .map((s) => s.trim().replace(/\\/g, '/'))
-    .filter((s) => s.startsWith('workflow/') || s.startsWith('wiki/'))
-)];
-if (!files.length) process.exit(0);
-
-let j;
-try { j = JSON.parse(fs.readFileSync(cacheFile, 'utf8')); } catch { process.exit(0); }
-if (!j || !j.files || typeof j.files !== 'object') process.exit(0);
-
-let removed = 0;
-for (const k of Object.keys(j.files)) {
-  const i = k.lastIndexOf('::');
-  if (i > -1 && files.includes(k.slice(i + 2))) { delete j.files[k]; removed++; }
-}
-if (removed) {
-  try { fs.writeFileSync(cacheFile, JSON.stringify(j)); } catch { /* 只读等写失败：下次查询两元组兜底 */ }
-}
-process.exit(0);

package/templates/_agents/scripts/kb-cache-evict.test.mjs

@@ -1,104 +0,0 @@
-#!/usr/bin/env node
-// kb-cache-evict.mjs 的 fixture 测试（--cache 指临时文件，不触真实缓存）
-// 断言：①跨命名空间摘除命中 key、他 key 原样保留、fp 不变；②范围外清单不动缓存；
-//       ③坏输入（缺文件/坏 JSON/无 files 字段）静默 exit 0；④stdin 管道路径与 --files-from 等价。
-// 用法：node .agents/scripts/kb-cache-evict.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 EVICT = path.join(SCRIPT_DIR, 'kb-cache-evict.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 mkCache = () => {
-  const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'kb-evict-test-'));
-  const file = path.join(dir, 'kb-index.json');
-  const entry = (t) => ({ st: [111, 222], kind: 'wf', meta: { 状态: t }, title: 'T', lines: [[1, '(标题)', '# x']] });
-  fs.writeFileSync(file, JSON.stringify({
-    fp: 'FIXFP00000000000',
-    files: {
-      'CWD1::workflow/intents/a.md': entry('done'),
-      'CWD2::workflow/intents/a.md': entry('done'),
-      'CWD1::wiki/测试主题/b.md': entry('done'),
-      'CWD1::workflow/plans/keep.md': entry('approved'),
-      'CWD2::workflow/README.md': entry('draft'),
-    },
-  }), 'utf8');
-  return { dir, file };
-};
-
-const run = (argv, opts = {}) => spawnSync(process.execPath, [EVICT, ...argv], { encoding: 'utf8', ...opts });
-const load = (f) => JSON.parse(fs.readFileSync(f, 'utf8'));
-const LIST = 'workflow/intents/a.md\nwiki/测试主题/b.md\nbackend/Dtos/X.cs\n';
-
-// ---- 场景 1：跨命名空间摘除 + 他 key 与 fp 保留 ----
-{
-  const { dir, file } = mkCache();
-  const lf = path.join(dir, 'list.txt');
-  fs.writeFileSync(lf, LIST, 'utf8');
-  const r = run(['--files-from', lf, '--cache', file]);
-  const j = load(file);
-  check('场景 1：exit 0 且 stderr 空', r.status === 0 && !r.stderr, `exit=${r.status}\n${r.stderr}`);
-  check('场景 1：同 rel 跨两命名空间全摘（a.md×2 + b.md×1）',
-    !('CWD1::workflow/intents/a.md' in j.files) && !('CWD2::workflow/intents/a.md' in j.files) && !('CWD1::wiki/测试主题/b.md' in j.files), Object.keys(j.files).join('\n'));
-  check('场景 1：无关 key 原样保留（keep 与 README 完好，计数 2）',
-    Object.keys(j.files).length === 2 && j.files['CWD1::workflow/plans/keep.md']?.meta?.['状态'] === 'approved' && j.files['CWD2::workflow/README.md']?.meta?.['状态'] === 'draft', Object.keys(j.files).join('\n'));
-  check('场景 1：fp 保持不变', j.fp === 'FIXFP00000000000', j.fp);
-  fs.rmSync(dir, { recursive: true, force: true });
-}
-
-// ---- 场景 2：范围外清单 → 缓存文件逐字节不动 ----
-{
-  const { dir, file } = mkCache();
-  const before = fs.readFileSync(file);
-  const lf = path.join(dir, 'list.txt');
-  fs.writeFileSync(lf, 'backend/Dtos/X.cs\nwiki\n\n', 'utf8');
-  const r = run(['--files-from', lf, '--cache', file]);
-  check('场景 2：范围外清单 exit 0 且缓存字节不变', r.status === 0 && fs.readFileSync(file).equals(before), `exit=${r.status}`);
-  fs.rmSync(dir, { recursive: true, force: true });
-}
-
-// ---- 场景 3：坏输入三态静默 exit 0 ----
-{
-  const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'kb-evict-test-'));
-  const lf = path.join(dir, 'list.txt');
-  fs.writeFileSync(lf, 'workflow/intents/a.md\n', 'utf8');
-  const missing = path.join(dir, 'nope.json');
-  const garbage = path.join(dir, 'garbage.json');
-  fs.writeFileSync(garbage, 'not-json{{{', 'utf8');
-  const nofiles = path.join(dir, 'nofiles.json');
-  fs.writeFileSync(nofiles, JSON.stringify({ fp: 'x' }), 'utf8');
-  const a = run(['--files-from', lf, '--cache', missing]);
-  const b = run(['--files-from', lf, '--cache', garbage]);
-  const c = run(['--files-from', lf, '--cache', nofiles]);
-  check('场景 3：缺缓存/坏 JSON/无 files 字段均 exit 0 且无输出',
-    a.status === 0 && b.status === 0 && c.status === 0 && !a.stdout && !b.stdout && !c.stdout && !a.stderr && !b.stderr && !c.stderr,
-    `a=${a.status}/${a.stderr} b=${b.status}/${b.stderr} c=${c.status}/${c.stderr}`);
-  check('场景 3：清单文件缺失也静默 exit 0', run(['--files-from', path.join(dir, 'nope.txt'), '--cache', garbage]).status === 0);
-  fs.rmSync(dir, { recursive: true, force: true });
-}
-
-// ---- 场景 4：stdin 管道与 --files-from 等价（钩子实际走的路径） ----
-{
-  const { dir, file } = mkCache();
-  const r = run(['--cache', file], { input: LIST });
-  const j = load(file);
-  check('场景 4：stdin 路径摘除同果', r.status === 0 && Object.keys(j.files).length === 2 && !('CWD1::wiki/测试主题/b.md' in j.files), `exit=${r.status} keys=${Object.keys(j.files).join(',')}`);
-  fs.rmSync(dir, { recursive: true, force: true });
-}
-
-console.log(`\n合计: PASS ${pass} / FAIL ${fail}`);
-if (fail) {
-  console.log('\n用法：node .agents/scripts/kb-cache-evict.test.mjs');
-  process.exit(1);
-}
-process.exit(0);