agentic-flow-kit 1.8.7 → 2.0.0

package/src/render.mjs

@@ -1,132 +0,0 @@
-// 模板树渲染：目录名前缀 _ 映射为点目录（_agents→.agents）；文本文件做 {{KEY}} 占位符替换
-// 返回写入清单（rel + sha256），供 kit.json managed 台账与 doctor 校验
-import fs from 'node:fs';
-import path from 'node:path';
-import crypto from 'node:crypto';
-
-const PH_RE = /\{\{([A-Z][A-Z0-9_]*)\}\}/g;
-
-function sha256(buf) {
-  return crypto.createHash('sha256').update(buf).digest('hex');
-}
-
-// relOf：模板内相对路径 → 目标相对路径（仅顶层 _ 前缀目录转点目录）
-function relOf(absFile, srcRoot) {
-  const parts = path.relative(srcRoot, absFile).split(path.sep);
-  if (parts.length > 1 && parts[0].startsWith('_')) parts[0] = '.' + parts[0].slice(1);
-  return parts.join('/');
-}
-
-// renderContent：单文件文本渲染（{{KEY}} 替换，未知占位符原样保留）——renderTree 与 init 的 AGENTS.md 追加补齐共用
-export function renderContent(text, vars) {
-  return String(text || '').replace(PH_RE, (m, key) => (Object.prototype.hasOwnProperty.call(vars, key) ? vars[key] : m));
-}
-
-// renderTree：模板树渲染。opts.protectOwned=true 时（init --force 路径，2026-09-27 p2-batch1），
-// rel 命中 protectSet 且目标已存在 → 跳过覆盖并计入 protected 清单（owned「永不触碰」两态模型
-// 在 --force 路径的对齐；此前 force 覆盖一切同名文件曾实测静默丢用户自定义内容）
-export function renderTree(srcRoot, targetRoot, vars, { force = false, protectSet = null } = {}) {
-  const written = [];   // { rel, sha256 }
-  const skipped = [];   // rel（已存在，保守跳过）
-  const protectedSkipped = []; // rel（--force 下 owned 保护跳过）
-  const warnings = [];  // 未知占位符等
-  const dirs = [];
-
-  (function walk(dir) {
-    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
-      const abs = path.join(dir, entry.name);
-      if (entry.isDirectory()) {
-        // 运行时缓存不是模板（包源跑测试会在 templates/_agents/cache/ 落盘残留）——init/sync 一律跳过
-        if (relOf(abs, srcRoot) === '.agents/cache') continue;
-        dirs.push(relOf(abs, srcRoot));
-        walk(abs);
-        continue;
-      }
-      const rel = relOf(abs, srcRoot);
-      // 引擎基线不是模板：键在 templates/_agents/…，下发成 .agents/engine-lock.json 会让装户
-      // 拿包源路径对账。排除该落点，包源基线留在模板目录。
-      if (rel === '.agents/engine-lock.json') continue;
-      const target = path.join(targetRoot, rel);
-      fs.mkdirSync(path.dirname(target), { recursive: true });
-      if (fs.existsSync(target) && !force) {
-        skipped.push(rel);
-        continue;
-      }
-      if (protectSet && protectSet.has(rel) && fs.existsSync(target)) {
-        protectedSkipped.push(rel);
-        continue;
-      }
-      const raw = fs.readFileSync(abs);
-      let out = raw;
-      if (raw.length < 512 * 1024 && !raw.includes(0)) {
-        // 文本面 LF 归一（2026-09-27 closing-coverage）：模板盘面 CRLF（autocrlf 检出 / 编辑器写入）与
-        // LF 克隆渲染出同一字节、同一 sha——fresh sha、装户落盘、kit.json 台账三方跨环境稳定；
-        // sync/doctor 的读取侧归一（shaText）与本处写盘归一同口径闭合
-        const replaced = renderContent(raw.toString('utf8').replace(/\r\n/g, '\n'), vars);
-        if (replaced.includes('{{')) {
-          for (const m of replaced.matchAll(/\{\{([A-Z][A-Z0-9_]*)\}\}/g)) {
-            if (!Object.prototype.hasOwnProperty.call(vars, m[1])) warnings.push(`${rel}: 未知占位符 {{${m[1]}}}（原样保留）`);
-          }
-        }
-        out = Buffer.from(replaced, 'utf8');
-      }
-      fs.writeFileSync(target, out, { mode: rel.startsWith('.githooks/') ? 0o755 : 0o644 }); // 钩子带执行位（init-p1-batch P1-1：POSIX 装户 git 对不可执行钩子静默跳过）
-      written.push({ rel: rel.split(path.sep).join('/'), sha256: sha256(out) });
-    }
-  })(srcRoot);
-
-  return { written, skipped, protectedSkipped, warnings, dirs };
-}
-
-// renderPkgText：目标侧脚本执行防线的比对基准（2026-09-27 init-p1-batch P1-3）——读包源模板
-// （templates/_agents/<rel 去掉 .agents/ 前缀>）→ LF 归一 → {{VAR}} 渲染（脚本面无占位符时即原文）。
-// 返回 null = 包源无该模板或非文本面（无从校验，调用方按不可信处理）。
-export function renderPkgText(pkgRoot, rel, vars) {
-  if (!rel.startsWith('.agents/')) return null;
-  const tmpl = path.join(pkgRoot, 'templates', '_agents', rel.slice('.agents/'.length));
-  try {
-    const raw = fs.readFileSync(tmpl);
-    if (raw.length >= 512 * 1024 || raw.includes(0)) return null;
-    return renderContent(raw.toString('utf8').replace(/\r\n/g, '\n'), vars);
-  } catch {
-    return null;
-  }
-}
-
-// scriptTrusted：目标侧脚本是否与包源渲染值一致（LF 归一双侧 sha 比对，与 closing-coverage 六处口径同族）。
-// 返回 {ok, note}——ok=false 时 note 给出原因（预置/被改动/包源无模板/不可读），调用方跳过执行并显式提示。
-export function scriptTrusted({ pkgRoot, target, rel, vars }) {
-  const expected = renderPkgText(pkgRoot, rel, vars);
-  if (expected === null) return { ok: false, note: `包源无 ${rel} 模板，无法校验` };
-  const expSha = sha256(Buffer.from(expected, 'utf8'));
-  let actual;
-  try {
-    actual = fs.readFileSync(path.join(target, rel), 'utf8').replace(/\r\n/g, '\n');
-  } catch {
-    return { ok: false, note: `${rel} 不可读` };
-  }
-  if (sha256(Buffer.from(actual, 'utf8')) === expSha) return { ok: true, note: '' };
-  return { ok: false, note: `目标侧 ${rel} 与包源渲染值不符（预置或被改动）` };
-}
-
-// listTree(srcRoot)：只枚举模板树的目标相对路径（rel），不落盘、不算 sha——供 doctor 台账覆盖率检查复用。
-// 与 renderTree 完全同一套 relOf 映射（顶层 _ 前缀目录转点目录）与 .agents/cache 排除，避免两处映射漂移。
-export function listTree(srcRoot) {
-  const out = [];
-  (function walk(dir) {
-    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
-      const abs = path.join(dir, entry.name);
-      if (entry.isDirectory()) {
-        if (relOf(abs, srcRoot) === '.agents/cache') continue;
-        walk(abs);
-        continue;
-      }
-      // 引擎基线不下发（命名空间错配会致装户全员误报——同 renderTree 排除，见 check-engine-integrity.mjs）
-      if (relOf(abs, srcRoot) === '.agents/engine-lock.json') continue;
-      out.push(relOf(abs, srcRoot).split(path.sep).join('/'));
-    }
-  })(srcRoot);
-  return out;
-}
-
-export { sha256 };

package/src/rule-budget.test.mjs

@@ -1,103 +0,0 @@
-// rule-budget.test.mjs — 纯包源预算自检门（2026-10-11 budget-self-check）——关闭「纯包源仓不跑装户预算门」盲区。
-// 背景：常驻面预算单源 templates/_agents/rule-budgets.txt（装户命名空间），此前只在装户侧强制
-// （pre-commit --staged 硬拦 / check-loop 13 --all warning）；v1.7.1 起本仓纯包源（5ca9e8c 删装副本）、
-// 两处都不跑——bb69e19/418960a 重构净增 78B 把 .agents/commands/ 推到 65581B > 65536B，包源侧零暴露，
-// 装户首提被硬拦才发现（2026-10-11 S1 冒烟）。本套件把同一张预算表映射到包源路径核对，npm test / CI
-// 直接拦超限——模板增长不再静默入包。run-tests 盘面 glob 自动挂载本套件。
-// 口径（对照 templates/_agents/scripts/rule-budget.mjs 单源，勿两处漂移）：
-//   字节 = LF 归一（工作树读入去 \r\n——等价 fsize 的 git cat-file 口径，core.autocrlf 检出形态无关）；
-//   目录合计 = 扁平 glob（直接子文件，不入子目录）；pat=首空格前 / lim=末空格后；lim 非纯数字行跳过；
-//   # 注释与空行跳过。
-// 与装户门的口径差异（诚实声明）：
-//   - AGENTS.md 是渲染模板：装户拿到的是占位符展开后的文件，渲染形态权威仍在装户门；本套件按全部
-//     STACKS 渲染取 max（BOARD_PORT 按最坏 5 位端口）做包源侧近似——单源复用 profiles/render，不复制命令表。
-//   - fail-loud 项（装户侧是 skip，包源侧是打包回归——表不随包或常驻面失踪 = 装户门整体变暗）：
-//     预算表缺失 / 解析 0 行 / 映射目标不存在 / 文件 glob 零命中。装户侧专属面（无包源对应）SKIP 并注记。
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { renderContent } from './render.mjs';
-import { STACKS, pickStackVars } from './profiles.mjs';
-
-const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
-const BUDGETS = path.join(ROOT, 'templates', '_agents', 'rule-budgets.txt');
-
-let pass = 0, fail = 0;
-function check(name, cond, detail = '') {
-  if (cond) { pass++; console.log(`PASS ${name}`); }
-  else { fail++; console.log(`FAIL ${name}${detail ? `——${detail}` : ''}`); }
-}
-const lfBytes = (abs) => Buffer.byteLength(fs.readFileSync(abs, 'utf8').replace(/\r\n/g, '\n'), 'utf8');
-
-// ---- 预算表（缺失即 fail-loud：装户门会整体变暗）----
-if (!fs.existsSync(BUDGETS)) {
-  console.log('FAIL R0 预算表缺失 templates/_agents/rule-budgets.txt——装户侧 pre-commit/检查13 将整体 skip');
-  process.exit(1);
-}
-const rows = [];
-for (const line of fs.readFileSync(BUDGETS, 'utf8').split('\n')) {
-  const t = line.replace(/\r/g, '');   // 表文件检出即 CRLF——显式去 \r（rule-budget.mjs 读取同款容 \r）
-  if (!t || t.startsWith('#')) continue;
-  const i = t.indexOf(' ');
-  if (i < 0) continue;
-  const pat = t.slice(0, i);
-  const lim = t.slice(t.lastIndexOf(' ') + 1);
-  if (!/^\d+$/.test(lim)) continue;    // 非纯数字 lim 跳过（sh case 同款）
-  rows.push({ pat, lim: Number(lim) });
-}
-check('R1 预算表解析非空', rows.length > 0, `仅 ${rows.length} 行——表被清空即盲区复活`);
-
-// ---- 映射：装户命名空间 → 包源路径（新预算行若只属装户侧，在此登记映射或留 SKIP）----
-function mapToPkg(pat) {
-  if (pat === 'AGENTS.md') return 'templates/AGENTS.md';
-  if (pat.startsWith('.agents/')) return 'templates/_agents/' + pat.slice('.agents/'.length);
-  return null;
-}
-
-const REMEDY = '处置沿先例：压缩版本括号/措辞（71e0b0e、v1.7.10 三处），或在 rule-budgets.txt 注明理由调预算（512B 步进）';
-
-for (const { pat, lim } of rows) {
-  const rel = mapToPkg(pat);
-  if (!rel) { console.log(`SKIP ${pat}——装户侧专属面，无包源对应`); continue; }
-  const abs = path.join(ROOT, rel);
-  if (pat.endsWith('/')) {
-    // 目录合计：扁平直接子文件，不入子目录（sh `for f in "$pat"*` + [ -f ] 同款）
-    if (!fs.existsSync(abs)) { check(`R-dir ${pat} 目标存在`, false, `${rel} 缺失`); continue; }
-    const files = fs.readdirSync(abs, { withFileTypes: true }).filter((e) => e.isFile()).map((e) => e.name);
-    const total = files.reduce((s, n) => s + lfBytes(path.join(abs, n)), 0);
-    check(`R-dir ${rel} 合计 ${total}B ≤ ${lim}B（${files.length} 文件）`, total <= lim, `超 ${total - lim}B。${REMEDY}`);
-  } else if (pat.includes('*')) {
-    // 文件 glob：仅支持 dir 内后缀形（*.md）——与 sh glob 展开同效
-    const dir = path.dirname(abs);
-    const base = path.basename(pat);
-    const suffix = base.slice(base.indexOf('*') + 1);
-    const files = fs.existsSync(dir) ? fs.readdirSync(dir).filter((n) => n.endsWith(suffix)) : [];
-    if (files.length === 0) { check(`R-glob ${pat} 有命中`, false, `${dir} 下无 *${suffix}——常驻面失踪或映射失效`); continue; }
-    const sizes = files.map((n) => ({ n, b: lfBytes(path.join(dir, n)) }));
-    const over = sizes.filter((s) => s.b > lim);
-    const maxS = sizes.slice().sort((a, b) => b.b - a.b)[0];
-    check(`R-glob ${path.dirname(rel)}/${base} ${sizes.length} 份，最大 ${maxS.n} ${maxS.b}B ≤ ${lim}B`, over.length === 0,
-      `${over.map((s) => `${s.n}=${s.b}B 超 ${s.b - lim}B`).join('；')}。${REMEDY}`);
-  } else {
-    if (!fs.existsSync(abs)) { check(`R-file ${pat} 目标存在`, false, `${rel} 缺失`); continue; }
-    const b = lfBytes(abs);
-    check(`R-file ${rel} = ${b}B ≤ ${lim}B`, b <= lim, `超 ${b - lim}B。${REMEDY}`);
-  }
-}
-
-// ---- AGENTS.md 渲染近似（装户渲染形态 = 占位符展开；包源侧按全部栈取 max）----
-const agentsRow = rows.find((r) => r.pat === 'AGENTS.md');
-if (agentsRow) {
-  const tpl = fs.readFileSync(path.join(ROOT, 'templates', 'AGENTS.md'), 'utf8');
-  let worst = { stack: '-', b: 0 };
-  for (const stack of Object.keys(STACKS)) {
-    const text = renderContent(tpl, { BOARD_PORT: '99999', ...pickStackVars(stack) });
-    const b = Buffer.byteLength(text.replace(/\r\n/g, '\n'), 'utf8');
-    if (b > worst.b) worst = { stack, b };
-  }
-  check(`R-render templates/AGENTS.md 渲染 max(${worst.stack}) ${worst.b}B ≤ ${agentsRow.lim}B`, worst.b <= agentsRow.lim,
-    `超 ${worst.b - agentsRow.lim}B——渲染形态超限装户门同样会拦，先压模板正文。${REMEDY}`);
-}
-
-console.log(`\n合计: PASS ${pass} / FAIL ${fail}`);
-process.exit(fail ? 1 : 0);

package/src/run-tests.mjs

@@ -1,56 +0,0 @@
-// run-tests.mjs — 全套测试入口（npm test）：lint 首步 + CLI 单测（sync/add-host/add-gate）+ 引擎 *.test.mjs 套件。
-// 顺序执行、任一非零整体失败（exit 1）。check-loop 套件自 2026-09-26 check-loop-node 起为 node 实现
-// （check-loop.test.mjs 由下方 glob 自动发现——旧 bash 特判与「无 sh 跳过」提示随迁移退役）。
-// lint 首步（2026-10-08 engine-quality-batch）：eslint 仅 devDependency（包源仓）——检测到未安装时
-// 显式打印 skip 后继续（裸 checkout 未 npm install 场景的可诊断性；装户仓无本编排器不涉及），
-// 已安装但报错则 fail-closed 计入失败。
-import { spawnSync } from 'node:child_process';
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
-
-// src/ 侧按盘面枚举，不硬编码清单（2026-10-09 审查 P0-1）——此前硬编码 8 项，`src/sync-hosts.test.mjs`
-// 漏挂：npm test 不跑它，CI 也盖不住（ci.yml shipped 步骤只 glob `.agents/scripts/*.test.mjs`），
-// 而 `templates/_agents/commands/sync-hosts.md:62`「npm test 含 sync-hosts.test.mjs 8 场景」随模板
-// 下发 5 个装户宿主。检查 20 只扫 `templates/_agents/scripts/` 面，结构上抓不到 src/ 漏挂。
-// 改 glob 后：新增 src 测试文件不可能再被静默漏跑（枚举漂移由盘面兜住，不靠人记得补）。
-// 含宿主门禁模块回归（2026-09-27 host-gates-p1：dotnet-ca BRE 豁免/fail-closed + trae 强推 token 化）。
-const nodeSuites = [
-  ...fs.readdirSync(path.join(ROOT, 'src'))
-    .filter((f) => f.endsWith('.test.mjs'))
-    .sort()
-    .map((f) => `src/${f}`),
-  ...fs.readdirSync(path.join(ROOT, 'templates/_agents/scripts'))
-    .filter((f) => f.endsWith('.test.mjs'))
-    .sort()
-    .map((f) => `templates/_agents/scripts/${f}`),
-];
-
-let failed = 0;
-
-// lint 首步：eslint 可用性探测 = require.resolve 于包源仓 node_modules（裸 checkout 解析失败 → 显式跳过）
-console.log('\n===== lint（eslint .）=====');
-const eslintEntry = spawnSync(process.execPath, ['-e', "require.resolve('eslint')"], { cwd: ROOT, encoding: 'utf8' });
-if (eslintEntry.status !== 0) {
-  console.log('[lint] skipped: eslint not installed（npm install 后启用；仅包源仓场景）');
-} else {
-  const r = spawnSync(process.execPath, [path.join(ROOT, 'node_modules/eslint/bin/eslint.js'), '.'], { cwd: ROOT, stdio: 'inherit' });
-  if (r.status !== 0) failed++;
-}
-
-for (const rel of nodeSuites) {
-  console.log(`\n===== ${rel} =====`);
-  const r = spawnSync(process.execPath, [path.join(ROOT, rel)], { cwd: ROOT, stdio: 'inherit' });
-  if (r.status !== 0) failed++;
-}
-
-console.log(`\n${failed ? `❌ ${failed} 个套件失败` : '✅ 全部套件通过'}`);
-// 机器可读汇总行（2026-10-09 审查 P0-2）：verify.mjs 的凭证计数**只认这一行**。
-// 此前它 pop 通配「合计: PASS n / FAIL n」，而 45+ 套件每个都打印自己那行同形文本——
-// 取到的是字母序最后一个套件的场景数（本仓实况：workflows-check.test.mjs 的 15），
-// 于是「一行机器事实」的 passed 字段落成了错的事实。独立前缀 + 套件口径，嵌套同形行不再被误取。
-// 口径：SUITES = 本编排器实际执行的套件数（lint 不计入；lint 红照样 exit 1，凭证不落）。
-console.log(`[run-tests] 合计: SUITES ${nodeSuites.length} / FAILED ${failed}`);
-process.exit(failed ? 1 : 0);

package/src/stack-profile.test.mjs

@@ -1,95 +0,0 @@
-#!/usr/bin/env node
-// 栈提交门契约：node 的构建只在 package.json scripts.build 为非空字符串时跑；
-// python 的提交门不再带 pytest；flow-kit --help 的门禁列表等于 modules/gates 目录。
-// 集成段用临时 git 仓跑真实 init，再对装出的 commit-check.cjs 暂存一个源文件。
-import { spawnSync } from 'node:child_process';
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { HELP } from './cli.mjs';
-import { routeKindList } from './executor.mjs';
-import { commitCheckConfig, settingsJson } from './profiles.mjs';
-
-const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
-const git = process.platform === 'win32' ? 'git.exe' : 'git';
-let pass = 0;
-let fail = 0;
-const check = (name, cond, detail = '') => {
-  if (cond) { pass++; console.log(`PASS  ${name}`); }
-  else { fail++; console.log(`FAIL  ${name}${detail ? `\n      ${detail}` : ''}`); }
-};
-
-const gates = fs.readdirSync(path.join(ROOT, 'modules', 'gates'), { withFileTypes: true })
-  .filter((d) => d.isDirectory())
-  .map((d) => d.name)
-  .sort();
-const gateList = gates.join(' | ');
-check('help 当前列表等于 modules/gates 目录', HELP.includes(`当前：${gateList}`), gateList);
-check('help 含四套已发布门禁',
-  ['dotnet-ca', 'generated-readonly', 'node-layer', 'py-import'].every((n) => HELP.includes(n)));
-check('help 不再把当前门禁写成只有 dotnet-ca',
-  !HELP.includes('当前：dotnet-ca；') && !HELP.includes('当前：dotnet-ca）'));
-
-// route 的 kind 值域与 GATE_LIST 同纪律：从权威面（new-task.md 的 route-kinds 机器单源）派生，
-//   不手写第二份——否则装户改 kind 时 help 与 route 判定面双源漂移。
-const kindList = routeKindList(ROOT).join('|');
-check('help route kind 列表等于 new-task.md route-kinds 单源', HELP.includes(`--kind ${kindList}`), kindList);
-
-const nodeCfg = JSON.parse(commitCheckConfig('node'));
-check('node 构建命令带 pkg:scripts.build',
-  nodeCfg.builds.some((b) => b.command === 'npm run build' && Array.isArray(b.when) && b.when.includes('pkg:scripts.build')));
-const pyText = commitCheckConfig('python');
-const pyCfg = JSON.parse(pyText);
-check('python builds 为空', Array.isArray(pyCfg.builds) && pyCfg.builds.length === 0, pyText);
-check('python 提交门配置不含 pytest', !pyText.includes('pytest'), pyText);
-check('python 质量检查仍是 ruff',
-  pyCfg.checks.some((c) => String(c.command).includes('ruff') && (c.when || []).includes('ruff.toml')));
-check('python 的 test 阶段权限仍允许 pytest', settingsJson('python').includes('pytest'));
-
-const dirs = [];
-function initStack(stack, port) {
-  const dir = fs.mkdtempSync(path.join(os.tmpdir(), `fk-stack-${stack}-`));
-  dirs.push(dir);
-  spawnSync(git, ['init', '-q'], { cwd: dir });
-  const r = spawnSync(process.execPath, [
-    path.join(ROOT, 'bin', 'flow-kit.mjs'), 'init',
-    '--stack', stack, '--hosts', 'claude', '--board-port', String(port), '--dir', dir,
-  ], { encoding: 'utf8', timeout: 180000 });
-  return { dir, status: r.status, out: `${r.stdout || ''}${r.stderr || ''}` };
-}
-
-function runCommitCheck(dir, rel, content) {
-  fs.writeFileSync(path.join(dir, rel), content);
-  spawnSync(git, ['add', '--', rel], { cwd: dir });
-  const r = spawnSync(process.execPath, [path.join(dir, '.agents', 'hooks', 'commit-check.cjs')], {
-    cwd: dir, encoding: 'utf8', timeout: 60000,
-  });
-  return { status: r.status, out: `${r.stdout || ''}${r.stderr || ''}` };
-}
-
-const nodeInit = initStack('node', 8942);
-check('init --stack node 退出 0', nodeInit.status === 0, `exit=${nodeInit.status}\n${nodeInit.out.split('\n').slice(-25).join('\n')}`);
-if (nodeInit.status === 0) {
-  const installed = fs.readFileSync(path.join(nodeInit.dir, '.agents', 'hooks', 'commit-check.config.json'), 'utf8');
-  check('装出的 node 配置含 pkg:scripts.build', installed.includes('pkg:scripts.build'), installed);
-  const hook = runCommitCheck(nodeInit.dir, 'a.js', 'console.log(1)\n');
-  check('无 scripts.build 时暂存 js：SKIP 且退出 0',
-    hook.status === 0 && hook.out.includes('SKIP') && hook.out.includes('pkg:scripts.build') && !hook.out.includes('BLOCK:'),
-    hook.out);
-}
-
-const pyInit = initStack('python', 8943);
-check('init --stack python 退出 0', pyInit.status === 0, `exit=${pyInit.status}\n${pyInit.out.split('\n').slice(-25).join('\n')}`);
-if (pyInit.status === 0) {
-  const installed = fs.readFileSync(path.join(pyInit.dir, '.agents', 'hooks', 'commit-check.config.json'), 'utf8');
-  check('装出的 python 配置不含 pytest', !installed.includes('pytest'), installed);
-  const hook = runCommitCheck(pyInit.dir, 'a.py', 'x = 1\n');
-  check('暂存 py：不跑 pytest 且退出 0',
-    hook.status === 0 && !hook.out.includes('pytest') && hook.out.includes('COMMIT_CHECK_OK'),
-    hook.out);
-}
-
-for (const dir of dirs) fs.rmSync(dir, { recursive: true, force: true });
-console.log(`\n合计: PASS ${pass} / FAIL ${fail}`);
-process.exit(fail ? 1 : 0);

package/src/sync-hosts.mjs

@@ -1,257 +0,0 @@
-// flow-kit sync-hosts：跨宿主适配层正文段漂移检查 + 单向同步（B-b 方案，2026-09-25）
-// 目的：改权威源（templates/_agents/{commands,roles}/*.md）正文要同步到 N 份薄适配
-// （modules/hosts/<h>/{agents,commands}/*.md）的对应正文段；薄适配 frontmatter 保留宿主特化字段
-// （commands 层 trae 侧另有 name: wf-X，opencode/zcode/omp 各自原描述），不在同步范围。
-// B-b 语义：sha 比对与 apply 只动正文段，frontmatter 双方各自维护。
-// 映射单源在 profiles.mjs#HOSTS.commandPrefix（命令层薄适配文件名前缀；2026-09-28 opencode 对齐 trae 的 wf- 前缀）。
-// 算法：diffHosts 抽为 pure function（authorityRoot + adaptersRoot 两个根）；
-//       sync-hosts CLI 在 pkgRoot 跑（包源视角）；doctor §7.x 在 target 跑（装户视角）——同源逻辑。
-import fs from 'node:fs';
-import path from 'node:path';
-import { HOSTS } from './profiles.mjs';
-import { sha256 } from './render.mjs';
-
-function fail(msg) {
-  console.error(`❌ ${msg}`);
-  process.exit(1);
-}
-
-// 剥离 frontmatter 返回 { fm, body }；无 frontmatter 时 fm = ''，body = 整文件
-// frontmatter 形如 "---\n...\n---\n"，位于文件首；其后（含分隔空行）为正文段。
-function splitFm(text) {
-  const m = String(text || '').match(/^---\r?\n([\s\S]*?\r?\n)---\r?\n?([\s\S]*)$/);
-  if (!m) return { fm: '', body: String(text || '') };
-  // fm 还原为带分隔横线的形式；body 保留首部空行
-  return { fm: `---\n${m[1]}---\n`, body: m[2] };
-}
-
-// bodySha：剥离 frontmatter 后的正文段 sha256（缺失返 null）；正文 LF 归一（2026-09-27 closing-coverage：
-// CRLF/LF 盘面同值——权威源与薄适配行尾不一致不再误报漂移）。
-// 单源 export（2026-10-11 bodysha-single-source）：doctor §6.7 checkAdapterDrift 复用——此前 doctor
-// 内联第二份实现靠注释约束同口径，收敛为单源 import 消灭漂移面。
-export function bodySha(p) {
-  try {
-    const { body } = splitFm(fs.readFileSync(p, 'utf8'));
-    return sha256(Buffer.from(body.replace(/\r\n/g, '\n'), 'utf8'));
-  } catch {
-    return null;
-  }
-}
-
-// listMd：列目录下 .md 文件（同步当前层；不递归）
-function listMd(dir) {
-  if (!fs.existsSync(dir) || !fs.statSync(dir).isDirectory()) return [];
-  return fs.readdirSync(dir).filter((f) => f.endsWith('.md'));
-}
-
-// pairsFor：权威源文件 → 薄适配 rel 列表（映射单源见 profiles.mjs#HOSTS.commandPrefix）
-//   commands 权威源 → 带 commandPrefix 的宿主各一份（<dir>/commands/<prefix><name>.md）
-//   roles    权威源 → 全部宿主 agents 各一份
-// hostDirOf：宿主 → 适配目录名。包源调用传入 (h) => h，配对落在 modules/hosts/<宿主键>/。
-// hostFilter：宿主级过滤。调用方只扫实际存在的宿主目录时传入。
-function pairsFor(authRel, hostDirOf = (h) => h, hostFilter = null) {
-  const out = [];
-  const norm = authRel.split(path.sep).join('/');
-  // 条目带 h（宿主键）——faces 计数用「实际生成配对 > 0 的宿主数」（复核 P2-2：存在但空的宿主点
-  // 目录此前被计入「N 宿主」，对账面自描述轻微夸大）
-  if (norm.startsWith('commands/') && norm.endsWith('.md')) {
-    const name = norm.slice('commands/'.length, -'.md'.length);
-    for (const [h, v] of Object.entries(HOSTS)) {
-      if (hostFilter && !hostFilter(h)) continue;
-      if (v.commandPrefix) out.push({ h, adapterRel: `${hostDirOf(h)}/commands/${v.commandPrefix}${name}.md` });
-    }
-  } else if (norm.startsWith('roles/') && norm.endsWith('.md')) {
-    const name = norm.slice('roles/'.length, -'.md'.length);
-    for (const h of Object.keys(HOSTS)) {
-      if (hostFilter && !hostFilter(h)) continue;
-      out.push({ h, adapterRel: `${hostDirOf(h)}/agents/${name}.md` });
-    }
-  }
-  return out;
-}
-
-// diffHosts：权威源正文段 vs 薄适配正文段的漂移分析（B-b 语义；pure function）。
-// authorityRoot：权威源根（含 commands/ + roles/）
-// adapterRoots = [{root, hostDirOf, hostFilter?, label?}]。只扫 modules/hosts。
-// 向后兼容：旧单根入参 adaptersRoot/hostDirOf 归一为单元素数组。
-// hostDirOf：宿主 → 适配目录名（默认宿主键）
-// 返回：{ drift, inSync, authorityMissing, adapterOrphans, faces }
-// drift 条目自带 root（applyForward 按它定位适配文件）；faces = 对账面自描述行（防不可解释的「N 对」）
-export function diffHosts(opts) {
-  const authorityRoot = opts.authorityRoot;
-  const roots = opts.adapterRoots || [{ root: opts.adaptersRoot, hostDirOf: opts.hostDirOf || ((h) => h), label: null }];
-  if (!fs.existsSync(authorityRoot)) return { drift: [], inSync: 0, authorityMissing: [], adapterOrphans: [], faces: [], note: `权威源根不存在：${authorityRoot}` };
-
-  const drift = [];
-  const adapterOrphans = [];
-  let inSync = 0;
-  const adapterSeen = new Set();
-  const authorityMissing = [];
-  const faces = [];
-
-  for (const spec of roots) {
-    const { root, hostDirOf, hostFilter, label } = spec;
-    const rootHosts = new Set(); // 该根实际生成配对 > 0 的宿主（faces 计数口径，复核 P2-2）
-    // 扫权威源 commands/ + roles/
-    for (const sub of ['commands', 'roles']) {
-      const subAbs = path.join(authorityRoot, sub);
-      for (const f of listMd(subAbs)) {
-        const authRel = `${sub}/${f}`;
-        const authAbs = path.join(authorityRoot, authRel);
-        const authSha = bodySha(authAbs);
-        const pairs = pairsFor(authRel, hostDirOf, hostFilter);
-        if (pairs.length === 0) continue;
-        for (const { h, adapterRel } of pairs) {
-          rootHosts.add(h);
-          adapterSeen.add(adapterRel);
-          const adapterAbs = path.join(root, adapterRel);
-          const adapterSha = bodySha(adapterAbs);
-          if (adapterSha === null) {
-            // 未安装的宿主不算「缺失」——那是没装，不是漂移（2026-10-07：装户只装部分宿主时，
-            // 旧行为会把未装宿主的全部适配文件列成 authorityMissing，装户 --apply 恒 exit 1 且刷屏）
-            if (fs.existsSync(path.dirname(adapterAbs))) authorityMissing.push({ authRel, adapterRel });
-            continue;
-          }
-          if (authSha === adapterSha) { inSync++; continue; }
-          drift.push({ authRel, adapterRel, authSha, adapterSha, root });
-        }
-      }
-    }
-
-    faces.push(label ? `${label}（${rootHosts.size} 宿主）` : `${root}（${rootHosts.size} 宿主）`);
-    // 扫薄适配找孤儿（权威源无对应文件）
-    for (const h of Object.keys(HOSTS)) {
-      if (hostFilter && !hostFilter(h)) continue;
-      for (const sub of ['agents', 'commands']) {
-        const subAbs = path.join(root, hostDirOf(h), sub);
-        for (const f of listMd(subAbs)) {
-          const adapterRel = `${hostDirOf(h)}/${sub}/${f}`;
-          if (adapterSeen.has(adapterRel)) continue;
-          let authGuess;
-          const prefix = HOSTS[h] && HOSTS[h].commandPrefix;
-          if (sub === 'commands' && prefix && f.startsWith(prefix)) {
-            // 命令层薄适配带宿主 commandPrefix（2026-09-28：opencode 对齐 trae 后两宿主同口径）
-            authGuess = `commands/${f.slice(prefix.length)}`;
-          } else if (sub === 'agents') {
-            authGuess = `roles/${f}`;
-          } else {
-            authGuess = `commands/${f}`;
-          }
-          adapterOrphans.push({ adapterRel, authGuess });
-        }
-      }
-    }
-  }
-
-  return { drift, inSync, authorityMissing, adapterOrphans, faces };
-}
-
-// printDiff：人类可读 diff 报告（B-b 语义：正文段比对 + frontmatter 双方不动）
-function printDiff(result) {
-  const { drift, inSync, authorityMissing, adapterOrphans, note, faces } = result;
-  if (note) console.log(`ℹ️  ${note}\n`);
-  if (faces && faces.length) console.log(`  对账面：${faces.join(' + ')}`);
-  console.log(`  正文对齐：${inSync} 对`);
-  if (authorityMissing.length) {
-    console.log(`  权威源声明但薄适配缺失（${authorityMissing.length}，apply 不自动创建——薄适配须经 add-host 接管）：`);
-    for (const { authRel, adapterRel } of authorityMissing) console.log(`    - ${authRel} → ${adapterRel}`);
-  }
-  if (drift.length) {
-    console.log(`  正文段漂移（${drift.length}，权威源与薄适配正文 sha 不一致——可能是权威源改了或薄适配正文手改了；run with --apply to sync 正文段，frontmatter 不动）：`);
-    for (const { authRel, adapterRel } of drift) console.log(`    - ${authRel} → ${adapterRel}`);
-  } else if (!authorityMissing.length) {
-    console.log('  无漂移 ✅');
-  }
-  if (adapterOrphans.length) {
-    console.log(`  ⚠️  孤儿薄适配（${adapterOrphans.length}，权威源无对应文件，可能是历史残留或宿主特化；apply 不删）：`);
-    for (const { adapterRel, authGuess } of adapterOrphans) console.log(`    - ${adapterRel}（推测权威源：${authGuess}）`);
-  }
-}
-
-// applyForward：把权威源正文段同步到薄适配（保留薄适配原 frontmatter）
-// 漂移条目自带 root（多根对账，2026-10-09 sync-hosts-root-coverage）——按它定位适配文件。
-// 返回：{ synced: [{adapterRel}] }
-function applyForward({ authorityRoot }, drift) {
-  const synced = [];
-  for (const { authRel, adapterRel, root } of drift) {
-    const authAbs = path.join(authorityRoot, authRel);
-    const adapterAbs = path.join(root, adapterRel);
-    const authText = fs.readFileSync(authAbs, 'utf8');
-    const adapterText = fs.readFileSync(adapterAbs, 'utf8');
-    const { body } = splitFm(authText);
-    const { fm } = splitFm(adapterText);
-    // 拼接：薄适配 frontmatter + 权威源正文段
-    fs.mkdirSync(path.dirname(adapterAbs), { recursive: true });
-    fs.writeFileSync(adapterAbs, `${fm}${body}`);
-    synced.push(adapterRel);
-  }
-  return { synced };
-}
-
-export function syncHosts(args, pkgRoot) {
-  let apply = false;
-  let json = false;
-  let strict = false;
-  let dir = null;
-  for (let i = 0; i < args.length; i++) {
-    const a = args[i];
-    if (a === '--diff') apply = false;
-    else if (a === '--apply') apply = true;
-    else if (a === '--json') json = true;
-    else if (a === '--strict') strict = true;
-    else if (a === '--dir') { dir = args[++i]; if (!dir) fail('--dir 缺少参数（目标项目根）'); }
-    else fail(`未知选项：${a}（flow-kit sync-hosts --help）`);
-  }
-  if (!pkgRoot) fail('sync-hosts 缺少 pkgRoot（开发模式入口）');
-
-  // 目标根：--dir > cwd > pkgRoot。只认包源仓（templates/_agents + modules/hosts）。
-  // 装户仓的宿主文件由 init / add-host 写入，不在这里把 .agents 再当成第二份权威源。
-  const target = path.resolve(dir || process.cwd() || pkgRoot);
-  const authorityRoot = path.join(target, 'templates', '_agents');
-  const hostsRoot = path.join(target, 'modules', 'hosts');
-  if (!fs.existsSync(authorityRoot) || !fs.existsSync(hostsRoot)) {
-    fail(`sync-hosts 只在包源仓运行（需要 templates/_agents 与 modules/hosts）。目标根 ${target} 不是包源仓。装户的宿主文件由 init / add-host 写入。`);
-  }
-  const adapterRoots = [
-    { root: hostsRoot, hostDirOf: (h) => h, label: 'modules/hosts' },
-  ];
-  const result = diffHosts({ authorityRoot, adapterRoots });
-
-  if (apply && result.drift.length > 0) {
-    const { synced } = applyForward({ authorityRoot }, result.drift);
-    console.log(`▶ flow-kit sync-hosts --apply → ${target}（包源）`);
-    console.log(`  对账面：${result.faces.join(' + ')}`);
-    console.log(`  按权威源正文覆盖薄适配正文段 ${synced.length} 份（薄适配 frontmatter 不动）：`);
-    for (const rel of synced) console.log(`    - ${rel}`);
-    const after = diffHosts({ authorityRoot, adapterRoots });
-    console.log(`  同步后正文对齐：${after.inSync} 对；权威源缺失：${after.authorityMissing.length}；正文漂移：${after.drift.length}`);
-    return after.drift.length === 0 && after.authorityMissing.length === 0 ? 0 : 1;
-  }
-
-  if (json) {
-    process.stdout.write(JSON.stringify(result, null, 2) + '\n');
-  } else {
-    console.log(`▶ flow-kit sync-hosts --diff → ${target}（包源）`);
-    printDiff(result);
-  }
-  // --strict（B4，2026-10-13）：漂移**报告器**变机器门。
-  // 背景：source-sync-check 删除后，跨宿主正文漂移只剩人工跑一次 --diff，CI 里无任何调用点——
-  //   而改权威源要同步 N 份薄适配，人工 grep 易漏（本次评审前 10 份薄适配就带着漂移）。
-  //   默认仍返回 0（保持「报告器」语义，人工跑不因漂移而失败）；CI 用 --strict 把漂移变成红。
-  // 口径：**只判「跑一次 --apply 就能归零」的两项**（正文漂移 + 权威源缺失）。
-  //   孤儿薄适配不判红——--apply 按设计不删它（可能是宿主特化/历史残留），
-  //   把它算红就是一条机器无法自愈的假红，按本仓「假阳性即噪声」纪律不能设成门（仍照常报告）。
-  if (strict) {
-    const fixable = result.drift.length + result.authorityMissing.length;
-    if (fixable > 0) {
-      console.error(`[跨宿主漂移 strict] 正文漂移 ${result.drift.length} · 权威源缺失 ${result.authorityMissing.length}`
-        + `${result.adapterOrphans.length ? `（另有孤儿薄适配 ${result.adapterOrphans.length} 份，按设计不判红）` : ''}`
-        + '——须先 flow-kit sync-hosts --apply 再提交');
-      return 1;
-    }
-    if (result.adapterOrphans.length) {
-      console.log(`  ℹ️ 孤儿薄适配 ${result.adapterOrphans.length} 份（--apply 按设计不删，故 strict 不判红；确为残留请手工删）`);
-    }
-  }
-  return 0;
-}