agentic-flow-kit 1.8.7 → 2.1.0

package/templates/_agents/scripts/run-tests.test.mjs

@@ -1,105 +0,0 @@
-#!/usr/bin/env node
-// run-tests.mjs 的夹具驱动测试（2026-10-08 agents-hygiene 批2）
-// 场景：①全绿目录 → exit 0 且聚合计数正确；②含红套件（FAIL>0 + exit 1）→ 记红且 exit 1；
-//       ③崩溃套件（throw，无合计行）→ 记红且 exit 1；④--only 过滤；⑤空目录 → exit 1。
-// 用法：node .agents/scripts/run-tests.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 MAIN = path.join(SCRIPT_DIR, 'run-tests.mjs');
-const USAGE = '用法：node .agents/scripts/run-tests.test.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 = (files) => {
-  const d = fs.mkdtempSync(path.join(os.tmpdir(), 'run-tests-fx-'));
-  for (const [name, body] of Object.entries(files)) fs.writeFileSync(path.join(d, name), body);
-  return d;
-};
-const run = (args) => spawnSync(process.execPath, [MAIN, ...args], { encoding: 'utf8' });
-
-// ---- 场景 1：全绿目录 → exit 0 且聚合计数（非 .test.mjs 文件不入围）----
-{
-  const d = mkfix({ 'a.test.mjs': 'console.log("合计: PASS 3 / FAIL 0");', 'b.test.mjs': 'console.log("合计: PASS 2 / FAIL 0");', 'readme.md': 'x' });
-  const r = run(['--dir', d]);
-  check('场景 1：全绿目录 → exit 0', r.status === 0, `exit=${r.status}\n${r.stdout}${r.stderr}`);
-  check('场景 1：聚合计数 PASS 5 / FAIL 0 且红 0', /断言合计 PASS 5 \/ FAIL 0/.test(r.stdout) && /红 0/.test(r.stdout), r.stdout);
-  fs.rmSync(d, { recursive: true, force: true });
-}
-
-// ---- 场景 2：红套件（计数 FAIL>0 且 exit 1）→ 记红且 exit 1 ----
-{
-  const d = mkfix({ 'a.test.mjs': 'console.log("合计: PASS 3 / FAIL 0");', 'bad.test.mjs': 'console.log("合计: PASS 1 / FAIL 2"); process.exit(1);' });
-  const r = run(['--dir', d]);
-  check('场景 2：含红套件 → exit 1', r.status === 1, `exit=${r.status}`);
-  check('场景 2：红套件被点名', /RED bad\.test\.mjs/.test(r.stdout) && /红 1/.test(r.stdout) && /FAIL 2/.test(r.stdout), r.stdout);
-  fs.rmSync(d, { recursive: true, force: true });
-}
-
-// ---- 场景 3：崩溃套件（无合计行）→ 记红且 exit 1 ----
-{
-  const d = mkfix({ 'boom.test.mjs': 'throw new Error("boom");' });
-  const r = run(['--dir', d]);
-  check('场景 3：崩溃套件 → exit 1 且标红', r.status === 1 && /RED boom\.test\.mjs（exit 1）/.test(r.stdout), r.stdout);
-  fs.rmSync(d, { recursive: true, force: true });
-}
-
-// ---- 场景 4：--only 过滤 ----
-{
-  const d = mkfix({ 'aa.test.mjs': 'console.log("合计: PASS 1 / FAIL 0");', 'bb.test.mjs': 'console.log("合计: PASS 2 / FAIL 0");' });
-  const r = run(['--dir', d, '--only', 'bb']);
-  check('场景 4：--only 只跑匹配套件', r.status === 0 && r.stdout.includes('bb.test.mjs') && !r.stdout.includes('aa.test.mjs') && /套件 1/.test(r.stdout), r.stdout);
-  fs.rmSync(d, { recursive: true, force: true });
-}
-
-// ---- 场景 5：空目录 → exit 1 报无套件 ----
-{
-  const d = mkfix({ 'readme.md': 'x' });
-  const r = run(['--dir', d]);
-  check('场景 5：空目录 → exit 1 报无套件', r.status === 1 && /无 \*\.test\.mjs/.test(r.stderr || ''), `${r.status}\n${r.stderr}`);
-  fs.rmSync(d, { recursive: true, force: true });
-}
-
-// ---- 场景 6：--concurrency 校验——非正整数 fail-loud ----
-{
-  const d = mkfix({ 'a.test.mjs': 'console.log("合计: PASS 1 / FAIL 0");' });
-  for (const bad of ['0', '-2', 'abc', '2.5']) {
-    const r = run(['--dir', d, '--concurrency', bad]);
-    check(`场景 6：--concurrency ${bad} → exit 1 fail-loud`, r.status === 1 && /正整数/.test(r.stderr), `exit=${r.status}\n${r.stderr}`);
-  }
-  const ok = run(['--dir', d, '--concurrency', '1']);
-  check('场景 6：--concurrency 1（串行兼容）→ exit 0 聚合正确', ok.status === 0 && /断言合计 PASS 1 \/ FAIL 0/.test(ok.stdout), `exit=${ok.status}\n${ok.stdout}`);
-  const okN = run(['--dir', d, '--concurrency', '8']);
-  check('场景 6：--concurrency 8（超套件数）→ exit 0', okN.status === 0 && /断言合计 PASS 1 \/ FAIL 0/.test(okN.stdout), `exit=${okN.status}\n${okN.stdout}`);
-  fs.rmSync(d, { recursive: true, force: true });
-}
-
-// ---- 场景 7：并行回放完整（每套件有 ▶ 分隔头且计数聚合不分串）----
-{
-  const d = mkfix({
-    'a.test.mjs': 'console.log("a-out 合计: PASS 1 / FAIL 0");',
-    'b.test.mjs': 'console.log("b-out 合计: PASS 2 / FAIL 0");',
-    'c.test.mjs': 'console.log("c-out 合计: PASS 3 / FAIL 0");',
-  });
-  const r = run(['--dir', d]);
-  check('场景 7：并行全绿 → 聚合 PASS 6 且三套件回放齐全',
-    r.status === 0 && /断言合计 PASS 6 \/ FAIL 0/.test(r.stdout) && /▶ a\.test\.mjs/.test(r.stdout) && /▶ b\.test\.mjs/.test(r.stdout) && /▶ c\.test\.mjs/.test(r.stdout), `exit=${r.status}\n${r.stdout}`);
-  check('场景 7：并行下套件输出不串（a-out 紧邻其回放块）', /▶ a\.test\.mjs\na-out/.test(r.stdout), r.stdout);
-  fs.rmSync(d, { recursive: true, force: true });
-}
-
-console.log(`\n合计: PASS ${pass} / FAIL ${fail}`);
-if (fail) {
-  console.log(`\n${USAGE}`);
-  process.exit(1);
-}
-process.exit(0);

package/templates/_agents/scripts/solidify-task.mjs

@@ -1,109 +0,0 @@
-#!/usr/bin/env node
-// solidify-task: 将 L1 液态草稿固化为正式 workflow 文档（迁移 + 可选确认 + 索引更新）
-// 用法：
-//   node .agents/scripts/solidify-task.mjs --topic <主题> [--root <仓库根>]
-//       # 只迁移 + 更新索引，绝不写确认台账；末尾打印确认指引
-//   node .agents/scripts/solidify-task.mjs --topic <主题> --delegated "<用户原话>"
-//       # 迁移后，以调用方显式传入的用户原话逐份 confirm-doc --delegated（quote 原样转发）
-//   node .agents/scripts/solidify-task.mjs --topic <主题> --auto
-//       # 迁移后，逐份 confirm-doc --auto（trust-mode=Trusted 才放行；Strict 下被拒并计数失败）
-// 确认门契约（2026-10-01 v09 复盘立法）：--delegated 的 quote 必须来自用户在对话内的
-//   明确原话，由调用方显式传入——本脚本永不编造用户话术。无确认来源时只迁移不落账，末尾打印指引。
-import fs from 'node:fs';
-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));
-
-function fail(msg) {
-  console.error(`❌ ${msg}`);
-  process.exit(1);
-}
-
-function parseArgs() {
-  const topicIdx = process.argv.indexOf('--topic');
-  const topic = topicIdx !== -1 ? process.argv[topicIdx + 1] : '';
-  if (!topic) fail('用法: node .agents/scripts/solidify-task.mjs --topic "主题" [--root <仓库根>] [--delegated "<用户原话>" | --auto]');
-  let root = process.cwd();
-  const rootIdx = process.argv.indexOf('--root');
-  if (rootIdx !== -1 && process.argv[rootIdx + 1]) root = process.argv[rootIdx + 1];
-  const delegatedIdx = process.argv.indexOf('--delegated');
-  const delegated = delegatedIdx !== -1 ? String(process.argv[delegatedIdx + 1] ?? '') : '';
-  const auto = process.argv.includes('--auto');
-  if (delegated && auto) fail('--delegated 与 --auto 互斥，只能选其一');
-  return { topic, root, delegated, auto };
-}
-
-const classify = (content) => {
-  if (content.includes('# INTENT')) return 'intents';
-  if (content.includes('# PLAN')) return 'plans';
-  if (content.includes('# SPEC')) return 'specs';
-  if (content.includes('# INCIDENT')) return 'incidents';
-  return null;
-};
-
-function run() {
-  const { topic, root, delegated, auto } = parseArgs();
-  // 草稿暂存区 = .zcode/workflow-drafts（宿主保存工作流草稿的实际目录；
-  // 2026-10-16 自源仓 8deb032b 回灌纠正：原 .zcode/drafts 自引入起从未存在，脚本一跑即 fail）
-  const draftsDir = path.join(root, '.zcode', 'workflow-drafts');
-  if (!fs.existsSync(draftsDir)) fail(`草稿目录 ${draftsDir} 不存在`);
-  const files = fs.readdirSync(draftsDir).filter((f) => f.includes(topic) && f.endsWith('.md'));
-  if (!files.length) fail(`在 ${draftsDir} 中未找到主题为 ${topic} 的草稿文件`);
-
-  const today = new Date().toISOString().slice(0, 10);
-  const solidified = [];
-  for (const file of files) {
-    const content = fs.readFileSync(path.join(draftsDir, file), 'utf8');
-    const targetDir = classify(content);
-    if (!targetDir) continue;
-    // 统一强制 YYYY-MM-DD- 前缀；已有前缀的文件名原样保留
-    const finalName = /^\d{4}-\d{2}-\d{2}-/.test(file) ? file : `${today}-${file}`;
-    const targetPath = path.join(root, 'workflow', targetDir, finalName);
-    fs.mkdirSync(path.dirname(targetPath), { recursive: true });
-    fs.copyFileSync(path.join(draftsDir, file), targetPath);
-    solidified.push({ rel: `workflow/${targetDir}/${finalName}`, abs: targetPath, type: targetDir });
-    console.log(` 📦 迁移: ${file} -> ${targetDir}/${finalName}`);
-  }
-  if (!solidified.length) fail(`草稿中未找到可识别的 INTENT/PLAN/SPEC/INCIDENT 文档（主题 ${topic}）`);
-
-  // 确认：仅当调用方显式提供确认来源时执行；否则只迁移，绝不落账。
-  let failed = 0;
-  if (delegated || auto) {
-    console.log('🛡️ 执行逐份确认...');
-    for (const item of solidified) {
-      const args = [path.join(SCRIPT_DIR, 'confirm-doc.mjs'), item.rel, '--root', root];
-      if (delegated) args.push('--delegated', delegated);
-      else args.push('--auto');
-      const res = spawnSync('node', args, { cwd: root, encoding: 'utf8' });
-      if (res.status !== 0) {
-        failed++;
-        console.error(` ❌ 确认失败 [${item.rel}]: ${(res.stderr || '').trim()}`);
-      } else {
-        console.log(` ✅ 已确认: ${item.rel}`);
-      }
-    }
-    console.log(`确认汇总：${solidified.length - failed}/${solidified.length} 成功${failed ? `，${failed} 失败` : ''}`);
-  } else {
-    console.log('⏭️ 未提供确认来源，仅迁移不落账。');
-    for (const item of solidified) {
-      console.log(`  → 确认指引: node .agents/scripts/confirm-doc.mjs ${item.rel}（TTY 键入「可以」）`);
-      console.log(`    或（用户对话内明确确认后）: node .agents/scripts/confirm-doc.mjs ${item.rel} --delegated "<用户原话>"`);
-    }
-  }
-
-  // 更新索引；失败同样传播退出码。
-  console.log('📖 更新工作流索引...');
-  const idx = spawnSync('node', [path.join(SCRIPT_DIR, 'gen-workflow-index.mjs')], { cwd: root, stdio: 'inherit' });
-  if (idx.status !== 0) {
-    console.error(' ❌ 索引更新失败');
-    process.exit(1);
-  }
-
-  if (failed) process.exit(1);
-  console.log(`\n✨ 任务 ${topic} 已成功固化！`);
-  console.log(`👉 建议执行: git add workflow/ .agents/confirmations.jsonl && git commit -m "docs(workflow): solidify L1 task ${topic}"`);
-}
-
-run();

package/templates/_agents/scripts/solidify-task.test.mjs

@@ -1,129 +0,0 @@
-#!/usr/bin/env node
-// solidify-task.test.mjs — 快车道固化脚本 fixture 套件（2026-10-01 v09-review-defects）
-// 验证确认门契约：无确认来源只迁移不落账；--delegated quote 原样转发；--auto Strict 下拒绝且失败退出；
-// 互斥/缺草稿/非文档等边界。gen-workflow-index 无 --root 参数，spawn 时以 fixture 根为 cwd。
-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, 'solidify-task.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 ENUMS_FIXTURE = [
-  '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') + '\n';
-
-const mkfix = () => {
-  const d = fs.mkdtempSync(path.join(os.tmpdir(), 'solidify-test-'));
-  for (const s of ['intents', 'plans', 'specs', 'incidents']) {
-    fs.mkdirSync(path.join(d, 'workflow', s), { recursive: true });
-  }
-  fs.mkdirSync(path.join(d, '.agents'), { recursive: true });
-  fs.mkdirSync(path.join(d, '.zcode', 'workflow-drafts'), { recursive: true });
-  fs.writeFileSync(path.join(d, '.agents', 'workflow-enums.txt'), ENUMS_FIXTURE);
-  fs.writeFileSync(path.join(d, '.agents', 'workflow-modules.txt'), '# modules\npipeline\nui\n');
-  return d;
-};
-const DRAFT = (name, eol = '\n') =>
-  `---${eol}状态: draft${eol}级别: L1${eol}日期: 2026-10-01${eol}模块: pipeline${eol}---${eol}# INTENT — ${name}${eol}`;
-const run = (root, args) => {
-  const r = spawnSync(process.execPath, [SCRIPT, ...args], { cwd: root, encoding: 'utf8' });
-  return { code: r.status, out: `${r.stdout || ''}${r.stderr || ''}` };
-};
-const ledgerLines = (root) => {
-  const p = path.join(root, '.agents', 'confirmations.jsonl');
-  return fs.existsSync(p) ? fs.readFileSync(p, 'utf8').split(/\n/).filter(Boolean) : [];
-};
-// 迁移目标名含当天日期前缀（solidify 以 toISOString 生成）——动态取值防跨天脆断
-const TODAY = new Date().toISOString().slice(0, 10);
-const migratedPath = (root) => path.join(root, 'workflow', 'intents', `${TODAY}-demo-task.md`);
-
-// T1：默认只迁移不落账
-{
-  const d = mkfix();
-  fs.writeFileSync(path.join(d, '.zcode', 'workflow-drafts', 'demo-task.md'), DRAFT('demo'));
-  const r = run(d, ['--topic', 'demo', '--root', d]);
-  check('T1 默认迁移成功 exit 0', r.code === 0, r.out);
-  check('T1 草稿已迁移到 intents 且日期前缀正确',
-    fs.existsSync(migratedPath(d)), '');
-  check('T1 零台账新增（无确认来源绝不落账）', ledgerLines(d).length === 0, JSON.stringify(ledgerLines(d)));
-  check('T1 输出含确认指引', r.out.includes('确认指引') && r.out.includes('--delegated'), r.out);
-}
-// T2：--delegated 原话原样转发
-{
-  const d = mkfix();
-  fs.writeFileSync(path.join(d, '.zcode', 'workflow-drafts', 'demo-task.md'), DRAFT('demo'));
-  const r = run(d, ['--topic', 'demo', '--root', d, '--delegated', '固化了可以']);
-  check('T2 --delegated 流程 exit 0', r.code === 0, r.out);
-  const lines = ledgerLines(d);
-  check('T2 台账落 1 行', lines.length === 1, JSON.stringify(lines));
-  check('T2 quote 原样（脚本不编造话术）',
-    lines[0].includes('"quote":"固化了可以"') && lines[0].includes('chat-delegated'), lines[0]);
-  check('T2 目标文档状态已 approved',
-    fs.readFileSync(migratedPath(d), 'utf8').includes('状态: approved'), '');
-}
-// T3：--auto 在 Strict（缺 trust-mode.json）下被拒 → 失败计数并 exit 1
-{
-  const d = mkfix();
-  fs.writeFileSync(path.join(d, '.zcode', 'workflow-drafts', 'demo-task.md'), DRAFT('demo'));
-  const r = run(d, ['--topic', 'demo', '--root', d, '--auto']);
-  check('T3 --auto 在缺省 Strict 下 exit 1（不吞失败）', r.code === 1, r.out);
-  check('T3 输出含失败汇总', r.out.includes('确认汇总') && r.out.includes('失败'), r.out);
-  check('T3 台账零行（拒绝不落账）', ledgerLines(d).length === 0, JSON.stringify(ledgerLines(d)));
-}
-// T4：缺草稿 → exit 1
-{
-  const d = mkfix();
-  fs.writeFileSync(path.join(d, '.zcode', 'workflow-drafts', 'other.md'), DRAFT('other'));
-  const r = run(d, ['--topic', 'nope', '--root', d]);
-  check('T4 缺主题草稿 exit 1 且带指引', r.code === 1 && r.out.includes('未找到主题'), r.out);
-}
-// T5：草稿非可识别文档 → exit 1
-{
-  const d = mkfix();
-  fs.writeFileSync(path.join(d, '.zcode', 'workflow-drafts', 'demo-note.md'), '# 随手笔记\nnot a workflow doc\n');
-  const r = run(d, ['--topic', 'demo', '--root', d]);
-  check('T5 无可识别文档 exit 1', r.code === 1 && r.out.includes('未找到可识别'), r.out);
-}
-// T6：--delegated 与 --auto 互斥 → exit 1
-{
-  const d = mkfix();
-  fs.writeFileSync(path.join(d, '.zcode', 'workflow-drafts', 'demo-task.md'), DRAFT('demo'));
-  const r = run(d, ['--topic', 'demo', '--root', d, '--delegated', 'x', '--auto']);
-  check('T6 互斥 exit 1', r.code === 1 && r.out.includes('互斥'), r.out);
-}
-// T7：失败路径退出码传播（确认失败后 exit 1，不吞）
-{
-  const d = mkfix();
-  fs.writeFileSync(path.join(d, '.zcode', 'workflow-drafts', 'demo-task.md'), DRAFT('demo'));
-  // 让确认失败：用 --auto 触发 Strict 拒绝（缺 trust-mode.json 即 Strict）。
-  const r = run(d, ['--topic', 'demo', '--root', d, '--auto']);
-  check('T7 失败后 exit 1 且索引仍生成', r.code === 1 && fs.existsSync(path.join(d, 'workflow', 'INDEX.md')), r.out);
-}
-// T8：索引更新失败传播退出码（独立于确认失败路径——删除 workflow/plans 目录使 gen-workflow-index 失败）
-{
-  const d = mkfix();
-  fs.writeFileSync(path.join(d, '.zcode', 'workflow-drafts', 'demo-task.md'), DRAFT('demo'));
-  fs.rmSync(path.join(d, 'workflow', 'plans'), { recursive: true });
-  const r = run(d, ['--topic', 'demo', '--root', d]);
-  check('T8 索引更新失败 exit 1 且输出指明', r.code === 1 && r.out.includes('索引更新失败'), r.out);
-}
-
-console.log(`\n合计: PASS ${pass} / FAIL ${fail}`);
-process.exit(fail ? 1 : 0);