agentic-flow-kit 2.0.0 → 2.1.0

package/templates/engine/.agents/scripts/outcome-metrics.mjs

@@ -0,0 +1,195 @@
+#!/usr/bin/env node
+// outcome-metrics.mjs — 交付结果指标（而不是机制成本）
+//
+// 背景（Anthropic《The AI-native SDLC playbook》）：每个 play 都应回答
+// “是否真的变好”，指标分 leading / lagging。既有 mechanism-registry 记的是
+// 门禁触发量与退役阈值（成本面），本脚本补结果面：
+//
+//   - 首次过门率 / 验证通过率（verifications.jsonl）
+//   - 逃逸缺陷与复盘量（workflow/incidents）
+//   - 复核意见采纳率（workflow/reviews.d）——事件级近似
+//   - 行为评测通过率与陈旧面（.agents/evals/results.jsonl）
+//   - 返工提交占比（git log，可选）
+//
+// 输出：workflow/metrics/outcome.md；--json 输出机器可读。
+// 诚实边界：只聚合已有台账；缺源在报告末尾单列，不造数、不把 0 当“很好”。
+//
+// 用法：
+//   node .agents/scripts/outcome-metrics.mjs [--days 30] [--json] [--out <path>]
+import fs from 'node:fs';
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+
+function readText(file) {
+  try {
+    return fs.readFileSync(file, 'utf8');
+  } catch {
+    return '';
+  }
+}
+
+function readJsonl(file) {
+  const rows = [];
+  for (const line of readText(file).split(/\r?\n/)) {
+    if (!line.trim()) continue;
+    try {
+      rows.push(JSON.parse(line));
+    } catch {
+      /* ignore */
+    }
+  }
+  return rows;
+}
+
+function within(ts, since) {
+  const t = Date.parse(ts);
+  return Number.isFinite(t) && t >= since;
+}
+
+function pct(n, d) {
+  if (!d) return null;
+  return Math.round((n / d) * 1000) / 10;
+}
+
+function listFiles(dir, re) {
+  try {
+    return fs.readdirSync(dir).filter((n) => re.test(n)).sort();
+  } catch {
+    return [];
+  }
+}
+
+function frontmatterStatus(text) {
+  const m = String(text).match(/^---\r?\n([\s\S]*?)\r?\n---/);
+  if (!m) return '';
+  const s = m[1].match(/^\s*状态:\s*(\S+)/m);
+  return s ? s[1] : '';
+}
+
+export function collect(root, { days = 30, now = Date.now()} = {}) {
+  const since = now - days * 86400000;
+  const missing = [];
+  const out = { days, since: new Date(since).toISOString() };
+
+  // 1) 验证通过率
+  const verifications = readJsonl(path.join(root, '.agents', 'verifications.jsonl'));
+  if (!verifications.length) missing.push('.agents/verifications.jsonl');
+  const verRecent = verifications.filter((r) => within(r.ts, since));
+  out.verification = {
+    total: verifications.length,
+    recent: verRecent.length,
+    pass: verRecent.filter((r) => Number(r.exitCode) === 0).length,
+    passRate: pct(verRecent.filter((r) => Number(r.exitCode) === 0).length, verRecent.length),
+    gateAvg: (() => {
+      const gs = verRecent.filter((r) => Number.isFinite(Number(r.gates))).map((r) => Number(r.gates));
+      return gs.length ? Math.round((gs.reduce((a, b) => a + b, 0) / gs.length) * 10) / 10 : null;
+    })(),
+  };
+
+  // 2) 事故 / 逃逸缺陷
+  const incidentDir = path.join(root, 'workflow', 'incidents');
+  const incidents = listFiles(incidentDir, /\.md$/).map((n) => readText(path.join(incidentDir, n)));
+  if (!fs.existsSync(incidentDir)) missing.push('workflow/incidents/');
+  const open = incidents.filter((t) => !/closed|done|已关闭/i.test(frontmatterStatus(t))).length;
+  out.incidents = { total: incidents.length, open, closed: incidents.length - open };
+
+  // 3) 复核意见采纳率（事件级近似：数 reviews.d 表格里的采纳/拒绝/误报单元格）
+  const reviewDir = path.join(root, 'workflow', 'reviews.d');
+  let adopted = 0; let rejected = 0; let misreport = 0;
+  for (const name of listFiles(reviewDir, /\.md$/)) {
+    const text = readText(path.join(reviewDir, name));
+    for (const line of text.split(/\r?\n/)) {
+      if (!/^\|/.test(line)) continue;
+      if (/采纳/.test(line) && !/拒绝/.test(line)) adopted += 1;
+      if (/拒绝/.test(line)) rejected += 1;
+      if (/误报/.test(line)) misreport += 1;
+    }
+  }
+  if (!fs.existsSync(reviewDir)) missing.push('workflow/reviews.d/');
+  out.review = { adopted, rejected, misreport, adoptionRate: pct(adopted, adopted + rejected) };
+
+  // 4) 行为评测
+  const evalRows = readJsonl(path.join(root, '.agents', 'evals', 'results.jsonl'));
+  if (!evalRows.length) missing.push('.agents/evals/results.jsonl');
+  const bySig = new Map();
+  for (const r of evalRows) {
+    if (!r || !r.signature) continue;
+    const prev = bySig.get(r.signature);
+    if (!prev || Date.parse(r.ts) > Date.parse(prev.ts)) bySig.set(r.signature, r);
+  }
+  const latest = [...bySig.values()];
+  const fresh = latest.filter((r) => within(r.ts, since));
+  out.evals = {
+    signatures: latest.length,
+    fresh: fresh.length,
+    lastPassRate: latest.sort((a, b) => Date.parse(b.ts) - Date.parse(a.ts))[0]?.passRate ?? null,
+    stale: latest.length - fresh.length,
+  };
+
+  // 5) 返工提交占比（可选：无 git 时省略）
+  const git = spawnSync('git', ['log', `--since=${new Date(since).toISOString()}`, '--pretty=%s'], { encoding: 'utf8', cwd: root });
+  if (git.status === 0) {
+    const subjects = git.stdout.split(/\r?\n/).filter(Boolean);
+    const rework = subjects.filter((s) => /^(fix|revert)(\(|:|!)/i.test(s)).length;
+    out.rework = { commits: subjects.length, rework, rate: pct(rework, subjects.length) };
+  }
+
+  out.missing = missing;
+  return out;
+}
+
+export function renderMarkdown(m) {
+  const fmt = (v) => (v == null ? '—' : `${v}%`);
+  const lines = [
+    `# 交付结果指标（近 ${m.days} 天）`,
+    '',
+    `> 生成时间 ${new Date().toISOString()}；来源为本地台账，缺源单列，不把 0 当“很好”。`,
+    '',
+    '| 面 | Leading / Lagging | 值 |',
+    '|---|---|---|',
+    `| 验证通过率 | Leading | ${fmt(m.verification.passRate)}（${m.verification.pass}/${m.verification.recent} 次，均门数 ${m.verification.gateAvg ?? '—'}） |`,
+    `| 行为评测陈旧面 | Leading | ${m.evals.stale}/${m.evals.signatures} 个签名过期；最新通过率 ${fmt(m.evals.lastPassRate)} |`,
+    `| 复核采纳率 | Leading | ${fmt(m.review.adoptionRate)}（采纳 ${m.review.adopted} / 拒绝 ${m.review.rejected} / 误报 ${m.review.misreport}） |`,
+    `| 返工提交占比 | Lagging | ${m.rework ? `${fmt(m.rework.rate)}（${m.rework.rework}/${m.rework.commits}）` : '—（无 git）'} |`,
+    `| 未关闭事故 | Lagging | ${m.incidents.open}/${m.incidents.total} |`,
+    '',
+  ];
+  if (m.missing.length) {
+    lines.push('## 数据缺口', '');
+    for (const x of m.missing) lines.push(`- 缺 \`${x}\`：该行指标为空/近似，不据此下结论。`);
+    lines.push('');
+  }
+  return `${lines.join('\n')}\n`;
+}
+
+function argOf(argv, name, fallback = null) {
+  const i = argv.indexOf(`--${name}`);
+  if (i < 0) return fallback;
+  const v = argv[i + 1];
+  return v == null || v.startsWith('--') ? true : v;
+}
+
+function main() {
+  const argv = process.argv.slice(2);
+  const root = path.resolve(argOf(argv, 'root', process.cwd()));
+  const days = Number(argOf(argv, 'days', 30)) || 30;
+  const m = collect(root, { days });
+  if (argv.includes('--json')) {
+    console.log(JSON.stringify(m, null, 2));
+    return 0;
+  }
+  const md = renderMarkdown(m);
+  const outArg = argOf(argv, 'out');
+  if (outArg && outArg !== true) {
+    const file = path.resolve(root, outArg);
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, md, 'utf8');
+    console.log(file);
+  } else {
+    process.stdout.write(md);
+  }
+  return 0;
+}
+
+const isMain = process.argv[1] && process.argv[1].endsWith('outcome-metrics.mjs');
+if (isMain) process.exit(main());

package/templates/engine/.agents/scripts/path-lease.mjs

@@ -0,0 +1,177 @@
+#!/usr/bin/env node
+// path-lease.mjs — 共享工件的单写者租约
+//
+// 背景（Anthropic《The components of agent memory》的并发实证）：
+//   多个 agent 同时写一张共享表，57 条合同事实只剩 41 条；一页一 agent、逐字引用则 57/57。
+//
+// 本脚本提供最小的本地租约：同一路径同一时间只允许一个 owner 写。
+// 租约是 advisory（协作纪律），不是安全边界；文件放 `.agents/cache/leases/`（gitignore）。
+//
+// 用法：
+//   node .agents/scripts/path-lease.mjs acquire --path wiki/foo.md [--owner <id>] [--ttl 30]
+//   node .agents/scripts/path-lease.mjs release --path wiki/foo.md [--owner <id>] [--force]
+//   node .agents/scripts/path-lease.mjs check   --path wiki/foo.md [--owner <id>]
+//   node .agents/scripts/path-lease.mjs list [--json]
+//   node .agents/scripts/path-lease.mjs sweep
+//
+// 退出码：acquire/check 成功 0；被他人持有 1；参数错误 2。
+import fs from 'node:fs';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import os from 'node:os';
+
+export function leaseDir(root) {
+  return path.join(root, '.agents', 'cache', 'leases');
+}
+
+export function normalizeRel(rel) {
+  return String(rel).replace(/\\/g, '/').replace(/^\.?\//, '').trim();
+}
+
+function leaseFile(root, rel) {
+  const key = crypto.createHash('sha1').update(normalizeRel(rel)).digest('hex');
+  return path.join(leaseDir(root), `${key}.json`);
+}
+
+function defaultOwner() {
+  return `${os.hostname()}/${process.pid}`;
+}
+
+function readLease(file) {
+  try {
+    return JSON.parse(fs.readFileSync(file, 'utf8'));
+  } catch {
+    return null;
+  }
+}
+
+function expired(lease, now = Date.now()) {
+  return !lease || !Number.isFinite(Date.parse(lease.expiresAt)) || Date.parse(lease.expiresAt) <= now;
+}
+
+export function acquire(root, { rel, owner = defaultOwner(), ttlMinutes = 30, now = new Date() } = {}) {
+  const target = normalizeRel(rel);
+  if (!target) throw new Error('--path 必填');
+  const ttl = Math.max(1, Number(ttlMinutes) || 30);
+  const file = leaseFile(root, target);
+  const row = {
+    path: target,
+    owner: String(owner),
+    acquiredAt: now.toISOString(),
+    expiresAt: new Date(now.getTime() + ttl * 60000).toISOString(),
+    ttlMinutes: ttl,
+  };
+  fs.mkdirSync(path.dirname(file), { recursive: true });
+  try {
+    fs.writeFileSync(file, JSON.stringify(row, null, 2), { flag: 'wx' });
+    return { ok: true, lease: row };
+  } catch (err) {
+    if (err.code !== 'EEXIST') throw err;
+  }
+  const held = readLease(file);
+  if (expired(held, now.getTime())) {
+    fs.writeFileSync(file, JSON.stringify(row, null, 2));
+    return { ok: true, lease: row, takeover: held };
+  }
+  if (held && held.owner === String(owner)) return { ok: true, lease: held, renewed: false };
+  return { ok: false, holder: held, lease: row };
+}
+
+export function release(root, { rel, owner = defaultOwner(), force = false } = {}) {
+  const target = normalizeRel(rel);
+  const file = leaseFile(root, target);
+  const held = readLease(file);
+  if (!held) return { ok: true, missing: true };
+  if (!force && held.owner !== String(owner)) return { ok: false, holder: held };
+  fs.rmSync(file, { force: true });
+  return { ok: true, released: held };
+}
+
+export function check(root, { rel, owner = defaultOwner(), now = Date.now() } = {}) {
+  const target = normalizeRel(rel);
+  const held = readLease(leaseFile(root, target));
+  if (!held || expired(held, now)) return { ok: true, free: true, holder: held || null };
+  if (held.owner === String(owner)) return { ok: true, owned: true, holder: held };
+  return { ok: false, holder: held };
+}
+
+export function listLeases(root) {
+  const dir = leaseDir(root);
+  let names = [];
+  try {
+    names = fs.readdirSync(dir).filter((n) => n.endsWith('.json')).sort();
+  } catch {
+    return [];
+  }
+  return names.map((n) => readLease(path.join(dir, n))).filter(Boolean);
+}
+
+export function sweep(root, { now = Date.now() } = {}) {
+  const removed = [];
+  for (const lease of listLeases(root)) {
+    if (expired(lease, now)) {
+      fs.rmSync(leaseFile(root, lease.path), { force: true });
+      removed.push(lease.path);
+    }
+  }
+  return removed;
+}
+
+function argOf(argv, name, fallback = null) {
+  const i = argv.indexOf(`--${name}`);
+  if (i < 0) return fallback;
+  const v = argv[i + 1];
+  return v == null || v.startsWith('--') ? true : v;
+}
+
+function main() {
+  const argv = process.argv.slice(2);
+  const cmd = argv[0] || 'list';
+  const root = path.resolve(argOf(argv, 'root', process.cwd()));
+  const rel = argOf(argv, 'path');
+  const owner = argOf(argv, 'owner', defaultOwner());
+
+  if (cmd === 'acquire') {
+    const res = acquire(root, { rel, owner, ttlMinutes: argOf(argv, 'ttl', 30) });
+    if (!res.ok) {
+      console.error(`✗ ${rel} 被 ${res.holder?.owner || '?'} 持有至 ${res.holder?.expiresAt || '?'}`);
+      return 1;
+    }
+    console.log(`✓ lease ${rel} owner=${res.lease.owner} until=${res.lease.expiresAt}${res.takeover ? ' (takeover)' : ''}`);
+    return 0;
+  }
+
+  if (cmd === 'release') {
+    const res = release(root, { rel, owner, force: argv.includes('--force') });
+    if (!res.ok) {
+      console.error(`✗ ${rel} 由 ${res.holder?.owner || '?'} 持有；--force 可强拆`);
+      return 1;
+    }
+    console.log(res.missing ? `- ${rel} 无租约` : `✓ released ${rel}`);
+    return 0;
+  }
+
+  if (cmd === 'check') {
+    const res = check(root, { rel, owner });
+    if (!res.ok) {
+      console.error(`✗ ${rel} 被 ${res.holder?.owner || '?'} 持有至 ${res.holder?.expiresAt || '?'}`);
+      return 1;
+    }
+    console.log(res.free ? `✓ ${rel} 空闲` : `✓ ${rel} 由本 owner 持有`);
+    return 0;
+  }
+
+  if (cmd === 'sweep') {
+    const removed = sweep(root);
+    console.log(`swept ${removed.length}${removed.length ? `: ${removed.join(', ')}` : ''}`);
+    return 0;
+  }
+
+  const leases = listLeases(root);
+  if (argv.includes('--json')) console.log(JSON.stringify(leases, null, 2));
+  else for (const l of leases) console.log(`${l.path}\t${l.owner}\t${l.expiresAt}`);
+  return 0;
+}
+
+const isMain = process.argv[1] && process.argv[1].endsWith('path-lease.mjs');
+if (isMain) process.exit(main());

package/templates/engine/.agents/scripts/session-log.mjs

@@ -0,0 +1,157 @@
+#!/usr/bin/env node
+// session-log.mjs — 会话经验日志（给 dreaming 的输入）
+//
+// 背景（Anthropic《The components of agent memory》）：dreaming 之所以能纠错，
+// 是因为它能把记忆笔记与**原始会话记录**对照。git 历史只是工件历史，不是经验。
+//
+// 本脚本只做最小、可丢弃、可重建的事：
+//   - append：把显著事件（决策 / 失败 / 纠正 / 拒绝 / 备注）追加到
+//     `.agents/cache/session-logs/<YYYY-MM-DD>.jsonl`（gitignore，运行态）；
+//   - digest：按天聚合成一份紧凑摘要，交给 dream-run 的“经验回放”阶段；
+//   - 不自动 commit / push，不读宿主私有 transcript。
+//
+// 用法：
+//   node .agents/scripts/session-log.mjs append --type failure --text "..." [--ref path] [--tag x]
+//   node .agents/scripts/session-log.mjs digest [--days 7] [--out tmp/session-digest-<date>.md]
+//   node .agents/scripts/session-log.mjs list [--days 7] [--json]
+//
+// 事件类型闭集：decision / failure / correction / refusal / note
+import fs from 'node:fs';
+import path from 'node:path';
+
+export const TYPES = ['decision', 'failure', 'correction', 'refusal', 'note'];
+
+export function logsDir(root) {
+  return path.join(root, '.agents', 'cache', 'session-logs');
+}
+
+function dayOf(iso) {
+  return String(iso).slice(0, 10);
+}
+
+export function appendEvent(root, { type, text, ref = '', tag = '', now = new Date() } = {}) {
+  const kind = String(type || '').trim();
+  if (!TYPES.includes(kind)) throw new Error(`未知事件类型：${kind}（允许 ${TYPES.join('/')}）`);
+  const body = String(text || '').trim();
+  if (!body) throw new Error('--text 不能为空');
+  const row = {
+    ts: now.toISOString(),
+    type: kind,
+    text: body,
+    ref: String(ref || ''),
+    tag: String(tag || ''),
+  };
+  const dir = logsDir(root);
+  fs.mkdirSync(dir, { recursive: true });
+  fs.appendFileSync(path.join(dir, `${dayOf(row.ts)}.jsonl`), `${JSON.stringify(row)}\n`);
+  return row;
+}
+
+export function readEvents(root, { days = 7, now = new Date() } = {}) {
+  const dir = logsDir(root);
+  let names = [];
+  try {
+    names = fs.readdirSync(dir).filter((n) => /^\d{4}-\d{2}-\d{2}\.jsonl$/.test(n)).sort();
+  } catch {
+    return [];
+  }
+  const cutoff = now.getTime() - days * 86400000;
+  const out = [];
+  for (const name of names) {
+    let raw;
+    try {
+      raw = fs.readFileSync(path.join(dir, name), 'utf8');
+    } catch {
+      continue;
+    }
+    for (const line of raw.split(/\r?\n/)) {
+      if (!line.trim()) continue;
+      let row;
+      try {
+        row = JSON.parse(line);
+      } catch {
+        continue;
+      }
+      const t = Date.parse(row.ts);
+      if (Number.isFinite(t) && t >= cutoff) out.push(row);
+    }
+  }
+  return out.sort((a, b) => Date.parse(a.ts) - Date.parse(b.ts));
+}
+
+export function digestEvents(events, { days = 7, maxPerType = 8 } = {}) {
+  const lines = [];
+  lines.push(`# 会话经验摘要（近 ${days} 天）`);
+  lines.push('');
+  if (!events.length) {
+    lines.push('_无会话日志输入。dreaming 只能审计工件，无法用经验纠错。_');
+    lines.push('');
+    lines.push('在关键节点执行：`node .agents/scripts/session-log.mjs append --type failure --text "…"`');
+    return `${lines.join('\n')}\n`;
+  }
+  const counts = {};
+  for (const e of events) counts[e.type] = (counts[e.type] || 0) + 1;
+  lines.push(`共 ${events.length} 条：${TYPES.map((t) => `${t}=${counts[t] || 0}`).join(' / ')}`);
+  lines.push('');
+  for (const type of TYPES) {
+    const rows = events.filter((e) => e.type === type);
+    if (!rows.length) continue;
+    lines.push(`## ${type}`);
+    for (const e of rows.slice(-maxPerType)) {
+      const ref = e.ref ? ` · \`${e.ref}\`` : '';
+      const tag = e.tag ? ` · [${e.tag}]` : '';
+      lines.push(`- ${dayOf(e.ts)} ${e.text}${ref}${tag}`);
+    }
+    if (rows.length > maxPerType) lines.push(`- …另有 ${rows.length - maxPerType} 条（见原始日志）`);
+    lines.push('');
+  }
+  return `${lines.join('\n')}\n`;
+}
+
+// ---- CLI ----
+function argOf(argv, name, fallback = null) {
+  const i = argv.indexOf(`--${name}`);
+  if (i < 0) return fallback;
+  const v = argv[i + 1];
+  return v == null || v.startsWith('--') ? true : v;
+}
+
+function main() {
+  const argv = process.argv.slice(2);
+  const cmd = argv[0] || 'digest';
+  const root = path.resolve(argOf(argv, 'root', process.cwd()));
+
+  if (cmd === 'append') {
+    const row = appendEvent(root, {
+      type: argOf(argv, 'type', 'note'),
+      text: argOf(argv, 'text', ''),
+      ref: argOf(argv, 'ref', ''),
+      tag: argOf(argv, 'tag', ''),
+    });
+    console.log(`logged ${row.type} @ ${row.ts}`);
+    return 0;
+  }
+
+  const days = Number(argOf(argv, 'days', 7)) || 7;
+  const events = readEvents(root, { days });
+  if (cmd === 'list') {
+    if (argv.includes('--json')) console.log(JSON.stringify(events, null, 2));
+    else for (const e of events) console.log(`${e.ts}\t${e.type}\t${e.text}${e.ref ? `\t${e.ref}` : ''}`);
+    return 0;
+  }
+
+  const md = digestEvents(events, { days });
+  const outArg = argOf(argv, 'out');
+  if (outArg && outArg !== true) {
+    const out = path.resolve(root, outArg);
+    fs.mkdirSync(path.dirname(out), { recursive: true });
+    fs.writeFileSync(out, md, 'utf8');
+    console.log(out);
+  } else {
+    process.stdout.write(md);
+  }
+  return 0;
+}
+
+const isMain = process.argv[1] && process.argv[1].endsWith('session-log.mjs');
+if (isMain) process.exit(main());

package/templates/engine/.agents/scripts/steering.mjs

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+// steering.mjs — 按模型档解析“严格度”（不变量不变，只调表达方式）
+//
+// 用法：
+//   node .agents/scripts/steering.mjs resolve --model opus [--json]
+//   node .agents/scripts/steering.mjs show
+import fs from 'node:fs';
+import path from 'node:path';
+
+export const DEFAULT = {
+  version: 1,
+  defaultTier: 'standard',
+  tiers: {
+    frontier: { scaffolding: 'goal', judgmentLatitude: 'high', guidance: '' },
+    standard: { scaffolding: 'mixed', judgmentLatitude: 'medium', guidance: '' },
+    lean: { scaffolding: 'step', judgmentLatitude: 'low', guidance: '' },
+  },
+  invariants: [],
+};
+
+// 只做“已知别名 → 档位”的保守映射；未知模型落到 default，不猜能力。
+const FRONTIER = /(^|[-/])(opus|fable|o3|o4|deepseek-r|deepseek-v4)([-/.]|$)/i;
+const LEAN = /(^|[-/])(haiku|mini|flash|small|nano)([-/.]|$)/i;
+
+export function loadConfig(root) {
+  try {
+    return { ...DEFAULT, ...JSON.parse(fs.readFileSync(path.join(root, '.agents', 'config', 'steering.json'), 'utf8')) };
+  } catch {
+    return DEFAULT;
+  }
+}
+
+export function tierFor(model, cfg = DEFAULT) {
+  const id = String(model || '').toLowerCase();
+  if (!id) return cfg.defaultTier;
+  if (FRONTIER.test(id)) return 'frontier';
+  if (LEAN.test(id)) return 'lean';
+  return cfg.defaultTier;
+}
+
+export function resolveSteering(root, model) {
+  const cfg = loadConfig(root);
+  const tier = tierFor(model, cfg);
+  return { model: String(model || ''), tier, ...(cfg.tiers[tier] || {}), invariants: cfg.invariants || [] };
+}
+
+function argOf(argv, name, fallback = null) {
+  const i = argv.indexOf(`--${name}`);
+  if (i < 0) return fallback;
+  const v = argv[i + 1];
+  return v == null || v.startsWith('--') ? true : v;
+}
+
+function main() {
+  const argv = process.argv.slice(2);
+  const root = path.resolve(argOf(argv, 'root', process.cwd()));
+  const cmd = argv[0] || 'show';
+  if (cmd === 'resolve') {
+    const res = resolveSteering(root, argOf(argv, 'model', ''));
+    if (argv.includes('--json')) console.log(JSON.stringify(res, null, 2));
+    else console.log(`${res.model || '(default)'} -> ${res.tier} · scaffolding=${res.scaffolding} · judgment=${res.judgmentLatitude}\n${res.guidance}`);
+    return 0;
+  }
+  const cfg = loadConfig(root);
+  if (argv.includes('--json')) console.log(JSON.stringify(cfg, null, 2));
+  else {
+    console.log(`defaultTier=${cfg.defaultTier}`);
+    for (const [name, t] of Object.entries(cfg.tiers)) console.log(`- ${name}: scaffolding=${t.scaffolding} judgment=${t.judgmentLatitude}`);
+    console.log(`invariants: ${(cfg.invariants || []).join(' / ') || '—'}`);
+  }
+  return 0;
+}
+
+const isMain = process.argv[1] && process.argv[1].endsWith('steering.mjs');
+if (isMain) process.exit(main());

package/templates/engine/.agents/scripts/verify.mjs

@@ -171,7 +171,7 @@ if (process.env.RUN_E2E === '1') {
 }
 
 // Stack profile（agentic-flow-kit 通用化）：基础门表里的 product 门是 dotnet/Vue 专用。
-// node/empty 装户只保留 engine + security + wiki 门；node 栈在 package.json 有 test 脚本时追加 npm test。
+// 其余栈只保留 engine + security + wiki 门，再按栈追加一条产品测试门。
 const STACK = (() => {
   try { return JSON.parse(fs.readFileSync('.agents/config/engine.json', 'utf8')).options?.stack || 'dotnet'; }
   catch { return 'dotnet'; }
@@ -181,14 +181,25 @@ if (STACK !== 'dotnet') {
     if (/^(backend-|frontend-|code-)/.test(GATES[i].id)) GATES.splice(i, 1);
   }
 }
-if (STACK === 'node') {
+const pushProduct = (id, name, cmd) => {
+  GATES.push({ id, cohort: 'product', name, cmd, folder: '.', type: 'shell' });
+};
+if (STACK === 'node' || STACK === 'typescript') {
   try {
     const pkg = JSON.parse(fs.readFileSync('package.json', 'utf8'));
-    if (pkg.scripts && pkg.scripts.test) {
-      GATES.push({ id: 'node-test', cohort: 'product', name: 'Node tests', cmd: 'npm test', folder: '.', type: 'shell' });
-    }
+    if (pkg.scripts && pkg.scripts.test) pushProduct('node-test', 'Node tests', 'npm test');
   } catch { /* not a node project root */ }
 }
+if (STACK === 'rust' && fs.existsSync('Cargo.toml')) pushProduct('cargo-test', 'Cargo tests', 'cargo test');
+if (STACK === 'go' && fs.existsSync('go.mod')) pushProduct('go-test', 'Go tests', 'go test ./...');
+if (STACK === 'java') {
+  if (fs.existsSync('pom.xml')) pushProduct('maven-test', 'Maven tests', 'mvn -q test');
+  else if (fs.existsSync('gradlew') || fs.existsSync('gradlew.bat')) {
+    pushProduct('gradle-test', 'Gradle tests', process.platform === 'win32' ? 'gradlew.bat test' : './gradlew test');
+  } else if (fs.existsSync('build.gradle') || fs.existsSync('build.gradle.kts')) {
+    pushProduct('gradle-test', 'Gradle tests', 'gradle test');
+  }
+}
 
 // 计数捕获：优先 run-tests 的「断言合计」汇总行，退路取末条「合计: PASS x / FAIL y」
 //（夹具假命令与单套件输出皆走退路；无匹配则省略计数键，exitCode 才是硬事实）。

package/templates/engine/.agents/skills/arena/SKILL.md

@@ -15,6 +15,10 @@ description: 设计选型 bakeoff——同一 brief 给 N 个独立臂（不同
 
 **同一 brief，独立臂，裁判选底座 + 嫁接。** 不是并行实现同一个文件；是并行**提案**，再选一个底座。臂之间不共享上下文（防锚定）。
 
+**单写者**：每个臂只写自己的提案文件/目录；需要写共享页面前先
+`node .agents/scripts/path-lease.mjs acquire --path <page> --owner <arm>`，写完释放。
+并发写同一页会丢事实（Anthropic 实证：共享表 57 条只剩 41 条）。
+
 ## 步骤
 
 1. **固定 brief**：目标、约束、验收判据、非目标、证据要求。每个臂拿到**逐字相同**的 brief。