agentic-flow-kit 1.8.7 → 2.1.0

package/templates/_agents/scripts/wf-journal.test.mjs

@@ -1,216 +0,0 @@
-#!/usr/bin/env node
-// wf-journal.test.mjs — run journal 测试（2026-09-26 orchestration-journal-human）
-// 方法：纯函数（replayRun/planStages/latestRun）fixture 直测 + CLI add/status spawn 冒烟（临时 journal + 临时 workflows 目录）
-//       + 真实仓库 pipeline-closing 解析（human 形态行在位）。
-// 判据：① schema 各字段与 attempt/run 语义 ② 末次生效 ③ 就绪/待定/中止分层 ④ 坏行容忍 ⑤ 9 列/human 列两代表全解析
-// 用法：node templates/_agents/scripts/wf-journal.test.mjs（npm test 随跑）
-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 { replayRun, planStages, latestRun } from './wf-journal.mjs';
-import { parseStages } from './workflows-check.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 SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
-const JOURNAL_CLI = path.join(SCRIPT_DIR, 'wf-journal.mjs');
-
-const mkline = (over = {}) => JSON.stringify({ ts: '2026-09-26T10:00:00Z', run: 'w@20260926-1000', wf: 'w', stage: 'a', status: 'pass', attempt: 1, ...over });
-const STAGES = parseStages(`| id | after | role | step | task | files | accept | gate | human | retries |
-|----|-------|------|------|------|-------|--------|------|-------|---------|
-| a | — | implementer | — | 做 A | src/** | 过 | | | |
-| ask | a | — | — | 用户确认 | — | 一句可以 | | 用户确认 | |
-| b | ask | — | — | — | — | — | npm test | | |
-| c | b | — | — | — | — | — | npm run build | | |
-`) || [];
-
-// ---- S1 replayRun：字段进 state、total 计数 ----
-{
-  const r = replayRun([mkline(), mkline({ stage: 'ask', form: 'human', status: 'pass', note: '用户点头' })], 'w@20260926-1000');
-  check('S1 replayRun 记 2 条且 form/note 进 state',
-    r.total === 2 && r.state.a.status === 'pass' && r.state.ask.form === 'human' && r.state.ask.note === '用户点头',
-    JSON.stringify(r));
-}
-
-// ---- S2 末次生效 + attempt 取最大（fail→pass 重试）----
-{
-  const r = replayRun([
-    mkline({ stage: 'b', status: 'fail', attempt: 1 }),
-    mkline({ stage: 'b', status: 'fail', attempt: 2 }),
-    mkline({ stage: 'b', status: 'pass', attempt: 3 }),
-  ], 'w@20260926-1000');
-  check('S2 末次状态生效 pass 且 attempt=3',
-    r.state.b.status === 'pass' && r.state.b.attempt === 3,
-    JSON.stringify(r.state.b));
-}
-
-// ---- S3 其他 run / 坏行不混入 ----
-{
-  const r = replayRun([
-    mkline({ stage: 'a' }),
-    mkline({ stage: 'x', run: 'w@OTHER' }),
-    '{ broken json',
-    mkline({ stage: 'a', status: 'nope' }),
-  ], 'w@20260926-1000');
-  check('S3 异 run 过滤 + 坏 JSON/坏 status 计 bad 不进 state',
-    r.total === 1 && r.bad === 2 && !r.state.x,
-    JSON.stringify(r));
-}
-
-// ---- S4 latestRun：取该 wf 最后一条 run ----
-{
-  const run = latestRun([mkline({ run: 'w@A' }), mkline({ run: 'w@B', stage: 'a' })], 'w');
-  check('S4 latestRun 取末条 w@B', run === 'w@B', String(run));
-}
-
-// ---- S5 planStages：空状态 → 第 0 层就绪；pass 后下层就绪；fail 下层待定 ----
-{
-  const p0 = planStages(STAGES, {});
-  const p1 = planStages(STAGES, { a: { status: 'pass', attempt: 1 } });
-  const p2 = planStages(STAGES, { a: { status: 'pass', attempt: 1 }, ask: { status: 'fail', attempt: 1 } });
-  check('S5 分层：首层 a 就绪 → a 过后 ask 就绪 → ask fail 时 b/c 待定且 ask 重试就绪',
-    p0.ready.map((s) => s.id).join() === 'a'
-      && p1.ready.map((s) => s.id).join() === 'ask'
-      && p2.ready.some((s) => s.id === 'ask' && s.retry === 1)
-      && p2.pending.map((s) => s.id).join() === 'b,c',
-    JSON.stringify({ p0, p1, p2 }));
-}
-
-// ---- S6 planStages：blocked 标注中止 + 依赖中止提示 ----
-{
-  const p = planStages(STAGES, { a: { status: 'pass', attempt: 1 }, ask: { status: 'blocked', attempt: 1, note: '用户驳回' } });
-  check('S6 blocked 进中止列且下游标依赖中止',
-    p.blocked.length === 1 && p.blocked[0].id === 'ask' && p.blocked[0].note === '用户驳回'
-      && p.pending.some((s) => s.id === 'b' && s.depBlocked),
-    JSON.stringify(p));
-}
-
-// ---- S7 CLI add 冒烟：attempt 自动计次 + run 复用 ----
-{
-  const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'wfj-cli-'));
-  const j = path.join(tmp, 'j.jsonl');
-  const run = (args) => spawnSync(process.execPath, [JOURNAL_CLI, ...args], { encoding: 'utf8' });
-  const r1 = run(['add', '--wf', 'w', '--stage', 'a', '--status', 'pass', '--journal', j]);
-  const r2 = run(['add', '--wf', 'w', '--stage', 'a', '--status', 'fail', '--journal', j]);
-  const lines = fs.readFileSync(j, 'utf8').trim().split('\n').map((l) => JSON.parse(l));
-  check('S7 add×2 attempt 自动 1→2 且 run 复用同 id',
-    r1.status === 0 && r2.status === 0 && lines.length === 2
-      && lines[0].attempt === 1 && lines[1].attempt === 2 && lines[0].run === lines[1].run,
-    JSON.stringify({ r1: r1.stdout + r1.stderr, r2: r2.stdout + r2.stderr, lines }));
-  fs.rmSync(tmp, { recursive: true, force: true });
-}
-
-// ---- S8 CLI status 冒烟：临时 workflows 目录 + 坏行容忍 ----
-{
-  const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'wfj-st-'));
-  const wfRoot = path.join(tmp, 'workflows');
-  fs.mkdirSync(wfRoot, { recursive: true });
-  fs.writeFileSync(path.join(wfRoot, 'demo.md'),
-    '---\nname: demo\ndescription: d\n---\n\n' +
-    '| id | after | role | step | task | files | accept | gate | retries |\n' +
-    '|----|-------|------|------|------|-------|--------|------|---------|\n' +
-    '| a | — | — | — | — | — | — | npm test | |\n' +
-    '| b | a | — | — | — | — | — | npm run build | |\n');
-  const j = path.join(tmp, 'j.jsonl');
-  fs.writeFileSync(j, '{ broken\n' + mkline({ wf: 'demo', stage: 'a' }) + '\n');
-  const r = spawnSync(process.execPath, [JOURNAL_CLI, 'status', '--wf', 'demo', '--journal', j, '--wf-root', wfRoot], { encoding: 'utf8' });
-  check('S8 status：坏行告警不炸、a 已完成、b 就绪',
-    r.status === 0 && /坏行 1 条/.test(r.stderr) && /已完成（1）：a/.test(r.stdout) && /就绪（1）：b/.test(r.stdout),
-    JSON.stringify({ out: r.stdout, err: r.stderr }));
-  fs.rmSync(tmp, { recursive: true, force: true });
-}
-
-// ---- S9 真实仓库：pipeline-closing 解析含 human 形态 confirm 行；无 journal 时首层就绪 ----
-{
-  const ROOT = path.resolve(SCRIPT_DIR, '..', '..', '..');
-  const wfFile = path.join(ROOT, '.agents', 'workflows', 'pipeline-closing.md');
-  if (!fs.existsSync(wfFile)) {
-    console.log('SKIP  S9（非包源仓库，无 pipeline-closing）');
-  } else {
-    const stages = parseStages(fs.readFileSync(wfFile, 'utf8')) || [];
-    const confirm = stages.find((s) => s.id === 'confirm');
-    const j = path.join(os.tmpdir(), `wfj-real-${Date.now()}.jsonl`);
-    const r = spawnSync(process.execPath, [JOURNAL_CLI, 'status', '--wf', 'pipeline-closing', '--journal', j], { encoding: 'utf8', cwd: ROOT });
-    check('S9 真实 pipeline-closing：confirm 为 human 形态且无 journal 时 author 首层就绪',
-      !!confirm && confirm.human && !confirm.role && stages.length >= 9
-        && r.status === 0 && /就绪（第 0 层.*author/.test(r.stdout),
-      JSON.stringify({ confirm, out: r.stdout }));
-    fs.rmSync(j, { force: true });
-  }
-}
-
-// ---- 委派台账只读对账（status；不改 add 必填）----
-{
-  const missing = spawnSync(process.execPath, [JOURNAL_CLI, 'add', '--stage', 'a', '--status', 'pass'], { encoding: 'utf8' });
-  check('add 缺 --wf 仍失败', missing.status !== 0 && /必填/.test(missing.stderr || ''), missing.stderr || missing.stdout);
-
-  const wfOf = (id, role, files = '—') =>
-    '---\nname: demo\ndescription: d\n---\n\n'
-    + '| id | after | role | step | task | files | accept | gate | retries |\n'
-    + '|----|-------|------|------|------|-------|--------|------|---------|\n'
-    + `| ${id} | — | ${role} | — | — | ${files} | — | npm test | |\n`;
-  const row = (date, note) =>
-    `## 委派结果\n\n| 日期 | 被委派方 | 任务一句话 | 结果 | 备注 |\n|------|----------|------------|------|------|\n| ${date} | x | y | 一次通过 | ${note} |\n`;
-  const passLine = (stage, over = {}) => JSON.stringify({
-    ts: '2026-09-26T10:00:00Z', run: 'demo@1', wf: 'demo', stage, status: 'pass', attempt: 1, ...over,
-  }) + '\n';
-  const statusOf = ({ body, journal, delegations }) => {
-    const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'wfj-del-'));
-    const wfRoot = path.join(tmp, 'workflows');
-    fs.mkdirSync(wfRoot);
-    fs.writeFileSync(path.join(wfRoot, 'demo.md'), body);
-    const j = path.join(tmp, 'j.jsonl');
-    if (journal != null) fs.writeFileSync(j, journal);
-    const d = path.join(tmp, 'delegations.md');
-    const args = ['status', '--wf', 'demo', '--wf-root', wfRoot, '--journal', j, '--delegations', d];
-    if (delegations != null) fs.writeFileSync(d, delegations);
-    const r = spawnSync(process.execPath, [JOURNAL_CLI, ...args], { encoding: 'utf8' });
-    fs.rmSync(tmp, { recursive: true, force: true });
-    return r;
-  };
-  const listed = (r, id) => r.status === 0
-    && (r.stdout || '').split(/\r?\n/).some((line) => line.trim() === `委派台账未记录（1）：${id}`);
-
-  let r = statusOf({ body: wfOf('build', 'implementer'), journal: passLine('build'), delegations: null });
-  check('委派表为空且 role=implementer 的 pass：列出阶段 id', listed(r, 'build'), r.stdout);
-
-  r = statusOf({ body: wfOf('review', 'independent-reviewer'), journal: passLine('review'), delegations: '' });
-  check('role=independent-reviewer 的 pass：同样列出', listed(r, 'review'), r.stdout);
-
-  r = statusOf({ body: wfOf('ui', 'ui-verifier'), journal: passLine('ui'), delegations: '' });
-  check('role=ui-verifier：不打印委派台账未记录', r.status === 0 && !(r.stdout || '').includes('委派台账未记录'), r.stdout);
-
-  r = statusOf({ body: wfOf('build', 'implementer'), journal: passLine('build'), delegations: row('2026-09-26', 'build') });
-  check('同日行含阶段 id：该阶段不列出', r.status === 0 && !(r.stdout || '').includes('委派台账未记录'), r.stdout);
-
-  r = statusOf({
-    body: wfOf('impl', 'implementer', 'workflow/intents/2026-09-26-foo.md'),
-    journal: passLine('impl'),
-    delegations: row('2026-09-26', '2026-09-26-foo.md'),
-  });
-  check('同日行含 files 里的 .md 文件名：该阶段不列出', r.status === 0 && !(r.stdout || '').includes('委派台账未记录'), r.stdout);
-
-  r = statusOf({ body: wfOf('build', 'implementer'), journal: passLine('build'), delegations: row('2026-09-25', 'build') });
-  check('行日期与 pass 的 UTC 日不同：该阶段仍列出', listed(r, 'build'), r.stdout);
-
-  r = statusOf({ body: wfOf('build', 'implementer'), journal: passLine('build'), delegations: row('2026-09-26', 'rebuild') });
-  check('阶段 id 只是更长词的一段：仍列出', listed(r, 'build'), r.stdout);
-
-  const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'wfj-norun-'));
-  const wfRoot = path.join(tmp, 'workflows');
-  fs.mkdirSync(wfRoot);
-  fs.writeFileSync(path.join(wfRoot, 'demo.md'), wfOf('build', 'implementer'));
-  r = spawnSync(process.execPath, [JOURNAL_CLI, 'status', '--wf', 'demo', '--wf-root', wfRoot, '--journal', path.join(tmp, 'none.jsonl')], { encoding: 'utf8' });
-  check('无 journal run：不打印委派台账未记录', r.status === 0 && /就绪/.test(r.stdout || '') && !(r.stdout || '').includes('委派台账未记录'), r.stdout);
-  fs.rmSync(tmp, { recursive: true, force: true });
-}
-
-console.log(`\n合计: PASS ${pass} / FAIL ${fail}`);
-process.exit(fail ? 1 : 0);

package/templates/_agents/scripts/wiki-search.mjs

@@ -1,19 +0,0 @@
-#!/usr/bin/env node
-// wiki 活跃层全文检索（2026-09-13 引入；2026-09-21 起降为 kb-search.mjs 的 wiki 域转发壳）
-// —— 检索实现与降噪口径单一维护在 .agents/scripts/kb-search.mjs，本脚本保留以兼容既有文档 / SKILL §8 的命令。
-// 用法：node .agents/scripts/wiki-search.mjs <词1> [词2 ...]     多词 AND（全部命中才算）
-//       node .agents/scripts/wiki-search.mjs -t 数据维护 <词>    限定主题
-//       node .agents/scripts/wiki-search.mjs -n 0 <词>          输出上限（本脚本默认 20，0=不限）
-// 语料固定为 wiki 活跃层（含数据维护子目录；排除 drafts-archive、INDEX.md、知识沉淀总览.html）；
-// 默认跳过 .json/.csv、*.visual-check.* 与 >180KB bulk（--include-generated 纳入）。
-// 跨语料（workflow + wiki）请直接用：node .agents/scripts/kb-search.mjs "<词>"
-import { spawnSync } from 'node:child_process';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const here = path.dirname(fileURLToPath(import.meta.url));
-const args = process.argv.slice(2);
-// 兼容保留 P0 版默认输出上限 20；用户显式传 -n 时不覆盖；--scope wiki 追加在末尾以固定语料（后出现者生效）
-const pass = [...args, ...(args.includes('-n') ? [] : ['-n', '20']), '--scope', 'wiki'];
-const r = spawnSync(process.execPath, [path.join(here, 'kb-search.mjs'), ...pass], { stdio: 'inherit' });
-process.exit(r.status ?? 1);

package/templates/_agents/scripts/wiki-search.test.mjs

@@ -1,57 +0,0 @@
-// wiki-search.test.mjs — wiki 检索转发壳（2026-10-09 engine-quality-round2 A2 补测）
-// 壳语义三断言：①默认 -n 20 + --scope wiki 追加（固定语料=wiki 活跃层）；②用户显式 -n 不被覆盖；
-// ③exit 码透传（kb-search 非零 → 壳非零）。fixture 复制壳 + kb-search 及其依赖（workflow-enums/
-// 配置文件），wiki 语料一文件命中（kb-search.test 场景 1 已覆盖 kb-search 本体判定，此处只测壳）。
-import fs from 'node:fs';
-import path from 'node:path';
-import os from 'node:os';
-import { spawnSync } from 'node:child_process';
-
-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}` : ''}`); }
-};
-
-// 夹具闭包（2026-10-12 fixture-closure-rootfix）：入口只写 wiki-search.mjs，kb-search 及其传递依赖
-// （workflow-enums.mjs 等）由闭包自动带入——此前手写枚举，漏拷即 import 失败 → 假绿。
-const { copyScriptClosure, copyAgentsFiles } = await import('./fixture-scripts.mjs');
-function mkFixture() {
-  const fx = fs.mkdtempSync(path.join(os.tmpdir(), 'ws-'));
-  fs.mkdirSync(path.join(fx, '.agents', 'scripts'), { recursive: true });
-  copyScriptClosure(path.join(fx, '.agents', 'scripts'), ['wiki-search.mjs']);
-  copyAgentsFiles(path.join(fx, '.agents'), ['workflow-enums.txt', 'workflow-modules.txt']);
-  fs.mkdirSync(path.join(fx, 'wiki', '测试主题'), { recursive: true });
-  fs.writeFileSync(path.join(fx, 'wiki', '测试主题', '说明.md'), '# 说明\n\n编码模板的领域知识条目。\n');
-  fs.mkdirSync(path.join(fx, 'workflow', 'intents'), { recursive: true });
-  fs.writeFileSync(path.join(fx, 'workflow', 'intents', '2026-10-09-a.md'),
-    '---\n状态: approved\n级别: L1\n日期: 2026-10-09\n模块: pipeline\n---\n# INTENT\n\n编码模板的 workflow 侧条目。\n');
-  return fx;
-}
-const run = (fx, args) => spawnSync(process.execPath, [path.join(fx, '.agents', 'scripts', 'wiki-search.mjs'), ...args], {
-  cwd: fx, encoding: 'utf8',
-});
-
-{
-  const fx = mkFixture();
-  const r = run(fx, ['编码模板']);
-  const out = (r.stdout || '') + (r.stderr || '');
-  check('① 默认形态命中 wiki 语料且不含 workflow 语料（--scope wiki 固定）',
-    r.status === 0 && out.includes('wiki/测试主题/说明.md') && !out.includes('workflow/intents'), out.slice(0, 400));
-  fs.rmSync(fx, { recursive: true, force: true });
-}
-{
-  const fx = mkFixture();
-  const r = run(fx, ['-n', '0', '编码模板']);
-  check('② 显式 -n 透传（0=不限，不因壳默认覆盖报错）且命中', r.status === 0 && (r.stdout || '').includes('说明.md'), (r.stdout || '').slice(0, 300));
-  fs.rmSync(fx, { recursive: true, force: true });
-}
-{
-  const fx = mkFixture();
-  const r = run(fx, []); // 无词 → kb-search 用法错误 exit 1
-  check('③ exit 码透传（无词 → 壳非零）', (r.status ?? 1) !== 0, `status=${r.status}`);
-  fs.rmSync(fx, { recursive: true, force: true });
-}
-
-console.log(`\n合计: PASS ${pass} / FAIL ${fail}`);
-process.exit(fail ? 1 : 0);