agentic-flow-kit 1.7.15 → 1.7.16

package/templates/_agents/commands/source-sync-check.md

@@ -1,103 +0,0 @@
----
-description: 装户面同步一致性检查（包源 templates/_agents/ vs 装副本 .agents/ 三类差异：缺失 / 孤儿 / 漂移）
-stage: helper（横向工具，不占 6 阶段）
-triggers:
-  - "改了包源同步了吗"
-  - "装了装副本同步了吗"
-  - "扫一下装户面漂移"
-  - "source-sync 跑一下"
-delegation:
-  - role: implementer
-    instructions: .agents/roles/implementer.md
-    when: 用户已确认同步范围（发现漂移后修包源或装副本时）
-    required: false
-    fallback: main
-approval_required: true
-next: .agents/commands/build.md（漂移属 build 改包源未同步导致的，修复后回 build）
----
-
-> **装户边界**：本文档中 `src/`、`bin/flow-kit.mjs`、`templates/_agents/`、`modules/hosts/` 为 kit 包源仓视角引用——装户仓（无 `templates/` 包源）对应命令不适用，本仓以 `.agents/` 装副本为准。
-
-# Source-Sync-Check · 装户面同步一致性
-
-> `templates/_agents/` 包源 vs `.agents/` 装副本——三类差异报告：缺失 / 孤儿 / 漂移。
-> managed 文件由 `flow-kit sync` 跟踪；owned 文件由 `flow-kit doctor` §6.6 校验——本工具补"两者都没扫"的真空地带（结构级差异）。
-
-## 1. 何时跑
-
-- 改 `templates/_agents/*` 包源后
-- 怀疑装副本未跟包源更新
-- 体检装副本完整性（清理前 / 发版前）
-- 不跑：仅改装副本 `.agents/*`（B-b 决策「只报告」+ 不反向同步）
-
-## 2. 怎么跑
-
-### 2.1 默认 `--diff`（仅报告）
-
-```
-node .agents/scripts/source-sync-check.mjs --diff
-node .agents/scripts/source-sync-check.mjs --json                       # 机器可读
-node .agents/scripts/source-sync-check.mjs --pkg-root <path> --target <path>   # 自定义路径
-```
-
-输出三类：
-- **缺失**（missing）——包源有 / 装副本无（如新增文件 init 未执行）
-- **孤儿**（orphan）——包源无 / 装副本有（如历史残留 / 用户本地添加）
-- **漂移**（drift）——两者都有但 sha 不一致（如包源改了装副本未跟）
-
-**排除**：
-- `templates/_agents/cache/`（运行时缓存，与 `flow-kit sync` 既有约定一致）
-- `.agents/kit.json` / `.agents/settings.json`（init 渲染产物，不属双源）
-
-### 2.2 输出示例
-
-```
-▶ flow-kit source-sync-check --diff
-  包源 (templates/_agents/) 49 份  |  装副本 (.agents/) 49 份
-  缺失（包源有 / 装副本 无）1：
-    - scripts/source-sync-check.mjs
-  孤儿（包源无 / 装副本 有）1：
-    - hooks/commit-check.config.json
-  漂移（包源装副本都有但 sha 不一致）3：
-    - commands/maintain.md  pkg=3782b695…  tgt=26203f7b…
-    - notes/runtime-env.md  pkg=aedde1ba…  tgt=ad08441e…
-    - scripts/ensure-board.mjs  pkg=e66653b0…  tgt=b6f3cc9b…
-```
-
-### 2.3 自验
-
-```
-node .agents/scripts/source-sync-check.test.mjs   # 11 场景全过
-npm test                                            # 含 source-sync-check 套件
-flow-kit doctor                                     # 10/0/0
-```
-
-## 3. 边界（不要做）
-
-- 不要自动化同步（B-b 决策「只报告不修复」——与 `gate-checklist` 同源）
-- 不改 managed 台账跟踪逻辑（`sync.mjs` 不动）
-- 不改 owned 漂移校验（`doctor.mjs` §6.6 不动）
-- 不反向同步——装副本独自有文件（如 hooks/commit-check.config.json）可能是装户配置，不应被删
-- 不检查注册表内宿主 `modules/hosts/` 薄适配漂移（那是 `flow-kit sync-hosts` 范围）
-
-## 4. 当前已识别的真实漂点（首次实测，2026-09-25）
-
-- **缺失**：本工具写完后未同步装副本（预期内——随本次 commit 解决）
-- **孤儿**：`.agents/hooks/commit-check.config.json`（装副本独有，疑似装户配置）
-- **漂移**：`commands/maintain.md` / `notes/runtime-env.md` / `scripts/ensure-board.mjs`
-
-修复留后续 incident / intent 跟踪（不在本次范围）。
-
-## 5. 与既有工具的关系
-
-| 工具 | 作用域 | 算法 |
-|---|---|---|
-| `flow-kit sync` | managed 文件（kit.json 台账跟踪）| 三态覆盖 + 加新 + 报错缺 |
-| `flow-kit doctor` §6.6 | owned 文件（kit.owned 哈希比对）| 盘面 sha vs 台账哈希 |
-| **`flow-kit source-sync-check`** | **所有文件结构（包源 ↔ 装副本全集）** | **sha 全量比对 + 缺失/孤儿分类** |
-
-三者互补，不重叠。
-
-## 6. 相关留痕
-
-- 立法出处：2026-09-25 source-sync-check（intent/plan；父事件 = 包源改了装副本未同步，本工具预防性体检）——留痕在包源仓 git 历史与 CHANGELOG，装户径不引实例路径

package/templates/_agents/scripts/check-ledger.mjs

@@ -1,109 +0,0 @@
-// check-ledger.mjs — managed 台账快检（2026-09-28 ledger-precommit-gate）：kit.json 台账 sha ↔ 盘面工作树
-// 补 pre-commit 盲区：双源门禁（source-sync-check）查 templates↔.agents 正文，两侧成对回退时静默；
-// doctor §4 查台账↔盘面但只在手动全量跑——「台账 sha 预 landing」（台账记了盘面尚不存在的内容 sha）
-// 随常规提交静默落 main，三次真实发生（0272a1c 预入 / ff3c721 还原窗口 / 537df18 闭合），本脚本在
-// 提交时刻补齐第三边。sha 口径：LF 归一 utf8（同 doctor §4 / render.mjs shaText / source-sync-check
-// 读取侧，跨 checkout 稳定；装户自包含约束决定独立实现，三处口径改动须同批）。
-// 入库态口径（2026-10-08 papercuts-cleanup-batch 修 5，独立复核 P1 修正取值链）：快检原比「工作树」，
-// 而分批提交时提交树（= HEAD + 暂存合成，删除同样被应用）里的 kit.json sha 可能指向「工作区已改、
-// 未提交」内容 → clone/CI 跑 doctor 必红（e8445c5 实证 6 项不符）。无参运行自适应：**暂存区非空即
-// 入库态**（不判「提交集含 kit.json」——diff --cached 只列与 HEAD 有差异的文件，kit.json 无变化暂存
-// 时不出现，但其合成提交树同样可能预 landing：只 add 件不 add 台账是姊妹漏洞）。入库态取值：
-// 台账清单 = 暂存版 kit.json（`git show :.agents/kit.json`）；暂存无而 HEAD 有 = 退出性提交（kit.json
-// 被暂存删除）放行；managed 内容 = `git show :rel` 暂存版，**暂存无即 gone**（提交树=index——
-// 未暂存改动的文件 index 仍在，`:rel` 必命中；`:rel` 缺失唯一可达路径是暂存删除，HEAD 兜底会把它
-// 误读为「未触碰」放行 = 提交门绕过，复核 P1 实证）。
-// 暂存区空（amend 等罕见态）→ 维持工作树口径零变化。
-// 边界：仅包源环境由 .githooks/pre-commit 触发（装户 managed 手改走 doctor §4 WARN 口径，不硬拦）；
-//       managed 删除即拦——sync 对 removed 只报不删，删件须手动同步装副本并重跑 sync 刷台账。
-// 用法：node .agents/scripts/check-ledger.mjs（cwd = 仓库根；非零出口即阻断提交；无参自适应两口径）
-//       单元测试：import { ledgerDrift } from './check-ledger.mjs'（{staged:true} 显式入库态）
-import fs from 'node:fs';
-import path from 'node:path';
-import { createHash } from 'node:crypto';
-import { spawnSync } from 'node:child_process';
-
-const gitText = (target, args) => {
-  const r = spawnSync('git', args, { cwd: target, encoding: 'utf8', maxBuffer: 16 * 1024 * 1024 });
-  return r.status === 0 ? r.stdout : null;
-};
-
-export function ledgerDrift(target = process.cwd(), { staged = false } = {}) {
-  const kitPath = path.join(target, '.agents', 'kit.json');
-  if (!fs.existsSync(kitPath)) return { skipped: true, note: '无 .agents/kit.json（非 flow-kit 安装）' };
-  // staged 模式：台账清单取暂存版 kit.json（提交树=index 合成语义）；暂存无而 HEAD 有 = 退出性提交
-  // （kit.json 被暂存删除）放行；两者皆无（新仓无 kit.json）同样放行
-  let kit = null;
-  if (staged) {
-    const stagedKit = gitText(target, ['show', ':.agents/kit.json']);
-    const headKit = stagedKit === null ? gitText(target, ['show', 'HEAD:.agents/kit.json']) : null;
-    if (stagedKit === null) {
-      return { skipped: true, note: headKit !== null ? '提交树无 .agents/kit.json（退出 flow-kit 的提交），跳过' : '提交树无 .agents/kit.json（新仓），跳过', mode: 'staged' };
-    }
-    try {
-      kit = JSON.parse(stagedKit);
-    } catch (e) {
-      return { skipped: false, fatal: `kit.json（暂存版）解析失败：${e.message}`, modified: [], gone: [], total: 0, version: '?', mode: 'staged' };
-    }
-  }
-  if (!kit) {
-    try {
-      kit = JSON.parse(fs.readFileSync(kitPath, 'utf8'));
-    } catch (e) {
-      return { skipped: false, fatal: `kit.json 解析失败：${e.message}`, modified: [], gone: [], total: 0, version: '?', mode: staged ? 'staged' : 'worktree' };
-    }
-  }
-  if (!Array.isArray(kit.managed)) {
-    // fail-loud（独立复核 P2-3，2026-09-28）：JSON 合法但 managed 缺失/非数组时静默「全对齐」= 假放，
-    // 同 doctor §4 的 Array.isArray 显式判口径，台账结构坏了必须响
-    return { skipped: false, fatal: 'kit.json managed 缺失或非数组', modified: [], gone: [], total: 0, version: kit.version, mode: staged ? 'staged' : 'worktree' };
-  }
-  const modified = [];
-  const gone = [];
-  const managed = kit.managed;
-  for (const f of managed) {
-    let content = null;
-    if (staged) {
-      // 入库态：提交树 = index（暂存版）；`:rel` 缺失唯一可达路径是暂存删除 → gone 拦（复核 P1：
-      // HEAD 兜底会把暂存删除误读为「未触碰」放行——提交树已无该件而台账仍跟踪，clone/CI 必红）
-      content = gitText(target, ['show', `:${f.rel}`]);
-      if (content === null) { gone.push(f.rel); continue; }
-    } else {
-      const p = path.join(target, f.rel);
-      if (!fs.existsSync(p)) { gone.push(f.rel); continue; }
-      content = fs.readFileSync(p, 'utf8');
-    }
-    const h = createHash('sha256').update(content.replace(/\r\n/g, '\n'), 'utf8').digest('hex'); // LF 归一，同 doctor §4
-    if (h !== f.sha256) modified.push(f.rel);
-  }
-  return { skipped: false, fatal: '', modified, gone, total: managed.length, version: kit.version, mode: staged ? 'staged' : 'worktree' };
-}
-
-const isMain = process.argv[1] && process.argv[1].endsWith('check-ledger.mjs');
-if (isMain) {
-  // 无参自适应：暂存区非空（有提交发生）→ 入库态口径；暂存区空（amend 等罕见态/非 git 仓）→ 工作树口径
-  const cached = gitText(process.cwd(), ['diff', '--cached', '--name-only']) || '';
-  const staged = cached.split(/\r?\n/).some((l) => l.trim() !== '');
-  const r = ledgerDrift(process.cwd(), { staged });
-  console.log('▶ flow-kit check-ledger');
-  if (r.skipped) {
-    console.log('  ' + r.note + '，跳过 ✅');
-    process.exit(0);
-  }
-  console.log('  kit.json v' + r.version + '：managed ' + r.total + ' 份，台账 ↔ ' + (r.mode === 'staged' ? '提交树入库态（暂存版=index，暂存删除即拦，LF 归一）' : '盘面（工作树，LF 归一）'));
-  if (r.fatal) console.error('❌ ' + r.fatal);
-  if (r.modified.length) {
-    console.error('  台账漂移（盘面 ≠ 台账 sha）' + r.modified.length + '：');
-    for (const rel of r.modified) console.error('    - ' + rel);
-  }
-  if (r.gone.length) {
-    console.error('  managed 缺失 ' + r.gone.length + '：');
-    for (const rel of r.gone) console.error('    - ' + rel);
-  }
-  if (r.fatal || r.modified.length || r.gone.length) {
-    console.error('  提交被拦：kit.json 与' + (r.mode === 'staged' ? '提交树（暂存面）' : '盘面') + '不一致（预 landing / 手改未随动）——跑 node bin/flow-kit.mjs sync 成对后原路重试');
-    process.exit(1);
-  }
-  console.log('  全对齐 ✅');
-  process.exit(0);
-}

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

@@ -1,199 +0,0 @@
-// check-ledger.test.mjs — managed 台账快检测试（2026-09-28 ledger-precommit-gate）
-// 方法：fixture 临时目录 .agents/kit.json + managed 件，调 ledgerDrift() + spawnSync CLI 出口码；
-//       真实仓库 baseline（包源环境全对齐；装户环境 SKIP 不计失败，沿 source-sync-check 先例）
-// 判据：S1 全对齐  S2 内容漂移逐份列出  S3 缺失  S4 CRLF×LF 归一不误报  S5 无 kit.json skip
-//       S6 kit.json 解析失败 fatal  S7/S8 CLI 出口码 0/1  S9 真实仓 baseline
-// 用法：node templates/_agents/scripts/check-ledger.test.mjs（装副本直跑亦然）
-import fs from 'node:fs';
-import path from 'node:path';
-import os from 'node:os';
-import { spawnSync } from 'node:child_process';
-import { fileURLToPath } from 'node:url';
-import { createHash } from 'node:crypto';
-import { ledgerDrift } from './check-ledger.mjs';
-
-let pass = 0, failCount = 0;
-function check(name, cond, detail = '') {
-  if (cond) { pass++; console.log('PASS ' + name); }
-  else { failCount++; console.log('FAIL ' + name + (detail ? '——' + detail : '')); }
-}
-
-// LF 归一 sha（同 check-ledger.mjs / doctor §4 口径）
-const lfSha = (s) => createHash('sha256').update(s.replace(/\r\n/g, '\n'), 'utf8').digest('hex');
-
-function mkFixture(managed, entries, kitRaw) {
-  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'fk-cl-'));
-  for (const [rel, content] of Object.entries(managed)) {
-    fs.mkdirSync(path.join(root, path.dirname(rel)), { recursive: true });
-    fs.writeFileSync(path.join(root, rel), content);
-  }
-  fs.mkdirSync(path.join(root, '.agents'), { recursive: true });
-  fs.writeFileSync(path.join(root, '.agents', 'kit.json'),
-    kitRaw !== undefined ? kitRaw : JSON.stringify({ kit: 't', version: '0.0.0-test', managed: entries }));
-  return root;
-}
-
-const SCRIPT = path.join(path.dirname(fileURLToPath(import.meta.url)), 'check-ledger.mjs');
-const runCli = (cwd) => spawnSync(process.execPath, [SCRIPT], { encoding: 'utf8', cwd });
-
-// ---- S1 全对齐 → 无漂移无缺失 ----
-{
-  const root = mkFixture({ '.agents/scripts/a.mjs': 'A v1\n' }, [{ rel: '.agents/scripts/a.mjs', sha256: lfSha('A v1\n') }]);
-  const r = ledgerDrift(root);
-  check('S1 全对齐 → modified=0 gone=0 total=1', !r.skipped && r.modified.length === 0 && r.gone.length === 0 && r.total === 1, JSON.stringify(r));
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- S2 内容漂移 → 逐份列出 rel ----
-{
-  const root = mkFixture({ '.agents/scripts/a.mjs': 'A 改了\n' }, [{ rel: '.agents/scripts/a.mjs', sha256: lfSha('A v1\n') }]);
-  const r = ledgerDrift(root);
-  check('S2 内容漂移 → modified=[a.mjs]', !r.skipped && r.modified.length === 1 && r.modified[0] === '.agents/scripts/a.mjs' && r.gone.length === 0, JSON.stringify(r));
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- S3 managed 缺失 → gone ----
-{
-  const root = mkFixture({}, [{ rel: '.agents/scripts/gone.mjs', sha256: lfSha('x') }]);
-  const r = ledgerDrift(root);
-  check('S3 缺失 → gone=[gone.mjs]', !r.skipped && r.gone.length === 1 && r.gone[0] === '.agents/scripts/gone.mjs' && r.modified.length === 0, JSON.stringify(r));
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- S4 CRLF 盘面 × LF 台账 → 归一不误报 ----
-{
-  const root = mkFixture({ '.agents/scripts/crlf.mjs': 'B v1\r\nline2\r\n' }, [{ rel: '.agents/scripts/crlf.mjs', sha256: lfSha('B v1\nline2\n') }]);
-  const r = ledgerDrift(root);
-  check('S4 CRLF 盘面 × LF 台账 → modified=0（归一口径）', !r.skipped && r.modified.length === 0 && r.gone.length === 0, JSON.stringify(r));
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- S5 无 kit.json → skipped（非 flow-kit 安装兼容） ----
-{
-  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'fk-cl-'));
-  const r = ledgerDrift(root);
-  check('S5 无 kit.json → skipped=true', r.skipped === true && typeof r.note === 'string', JSON.stringify(r));
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- S6 kit.json 解析失败 → fatal ----
-{
-  const root = mkFixture({}, [], '{ kit: 坏 json');
-  const r = ledgerDrift(root);
-  check('S6 解析失败 → fatal 非空', !r.skipped && typeof r.fatal === 'string' && r.fatal.includes('解析失败'), JSON.stringify(r));
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- S6b JSON 合法但 managed 缺失/非数组 → fatal（不静默全对齐；独立复核 P2-3） ----
-{
-  const root = mkFixture({}, [], JSON.stringify({ kit: 't', version: '0.0.0-test' }));
-  const r = ledgerDrift(root);
-  check('S6b managed 非数组 → fatal 非空（fail-loud）', !r.skipped && typeof r.fatal === 'string' && r.fatal.includes('managed'), JSON.stringify(r));
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- S7 CLI 干净 fixture → exit 0 + 全对齐 ----
-{
-  const root = mkFixture({ '.agents/scripts/a.mjs': 'A v1\n' }, [{ rel: '.agents/scripts/a.mjs', sha256: lfSha('A v1\n') }]);
-  const p = runCli(root);
-  check('S7 CLI 全对齐 → exit 0 + 「全对齐」', p.status === 0 && p.stdout.includes('全对齐'), `status=${p.status} out=${p.stdout}`);
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- S8 CLI 漂移 fixture → exit 1 + 列出 rel + sync 提示 ----
-{
-  const root = mkFixture({ '.agents/scripts/a.mjs': 'A 改了\n' }, [{ rel: '.agents/scripts/a.mjs', sha256: lfSha('A v1\n') }]);
-  const p = runCli(root);
-  check('S8 CLI 漂移 → exit 1 + rel + sync 提示', p.status === 1 && p.stderr.includes('.agents/scripts/a.mjs') && p.stderr.includes('sync'), `status=${p.status} err=${p.stderr}`);
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- S9 真实仓 baseline：包源环境台账↔盘面全对齐；装户环境 SKIP 不计失败 ----
-{
-  let srcRoot = path.dirname(fileURLToPath(import.meta.url));
-  for (let i = 0; i < 5 && srcRoot; i++) {
-    if (fs.existsSync(path.join(srcRoot, 'templates', '_agents'))) break;
-    srcRoot = path.dirname(srcRoot);
-  }
-  if (!srcRoot || !fs.existsSync(path.join(srcRoot, 'templates', '_agents'))) {
-    console.log('SKIP S9（装户环境无包源，不计失败）');
-  } else if (!fs.existsSync(path.join(srcRoot, '.agents', 'kit.json'))) {
-    console.log('SKIP S9（纯包源仓无 .agents/ 装副本——装户端内容清理后形态，不计失败）');
-  } else {
-    const r = ledgerDrift(srcRoot);
-    check('S9 真实仓 baseline → 台账↔盘面全对齐', !r.skipped && r.modified.length === 0 && r.gone.length === 0, JSON.stringify({ modified: r.modified, gone: r.gone }));
-  }
-}
-
-// ---- S10 入库态口径（2026-10-08 papercuts-cleanup-batch 修 5）：git 仓 fixture，分批提交场景 ----
-// 核心场景（papercuts 2026-09-30 行）：sync 刷新 kit.json 后只 add 台账不 add 件 → 提交树内 kit.json
-// 预 landing → 修前工作树口径「全对齐」放行（假绿），clone/CI doctor 必红；修后入库态模式拦。
-{
-  const GIT = process.platform === 'win32' ? 'git.exe' : 'git';
-  const g = (cwd, ...args) => spawnSync(GIT, args, { cwd, encoding: 'utf8' });
-  const W2 = (root, rel, content) => {
-    fs.mkdirSync(path.join(root, path.dirname(rel)), { recursive: true });
-    fs.writeFileSync(path.join(root, rel), content);
-  };
-  const repo = fs.mkdtempSync(path.join(os.tmpdir(), 'fk-cl-git-'));
-  g(repo, 'init', '-q');
-  g(repo, 'config', 'user.email', 't@t');
-  g(repo, 'config', 'user.name', 't');
-  g(repo, 'config', 'core.autocrlf', 'false');
-  const kitOf = (aSha) => JSON.stringify({
-    kit: 't', version: '0.0.0-test',
-    managed: [{ rel: '.agents/scripts/a.mjs', sha256: aSha }],
-  }) + '\n';
-  W2(repo, '.agents/scripts/a.mjs', 'A v1\n');
-  W2(repo, '.agents/kit.json', kitOf(lfSha('A v1\n')));
-  g(repo, 'add', '-A');
-  g(repo, 'commit', '-q', '-m', 'v1');
-  // sync 模拟：件与台账同刷 v2（工作区自洽，均未提交）
-  W2(repo, '.agents/scripts/a.mjs', 'A v2\n');
-  W2(repo, '.agents/kit.json', kitOf(lfSha('A v2\n')));
-
-  // S10① 只 add kit.json（分批提交）→ 暂存台账(v2) vs 入库件(HEAD v1) → 拦
-  g(repo, 'add', '.agents/kit.json');
-  const r1 = ledgerDrift(repo, { staged: true });
-  check('S10① 入库态：台账(v2 暂存) vs 件(HEAD v1) → 拦（修前工作树口径假绿放行）',
-    r1.mode === 'staged' && r1.modified.includes('.agents/scripts/a.mjs'), JSON.stringify(r1));
-  // S10② 件与台账同 add → 入库态一致 → 过
-  g(repo, 'add', '.agents/scripts/a.mjs');
-  const r2 = ledgerDrift(repo, { staged: true });
-  check('S10② 入库态：件与台账同 add → 一致过', r2.mode === 'staged' && !r2.modified.length && !r2.gone.length, JSON.stringify(r2));
-  g(repo, 'commit', '-q', '-m', 'v2 both');
-  // S10③ 工作树删件未暂存 → index 仍有该件（`:rel` 命中 HEAD 内容）→ 不误报 gone（复核 P1 修后语义：
-  // HEAD 兜底已移除，判定路径 = `:rel` 命中而非兜底）
-  fs.rmSync(path.join(repo, '.agents/scripts/a.mjs'));
-  const r3 = ledgerDrift(repo, { staged: true });
-  check('S10③ 入库态：工作树删件未暂存 → index 仍在，不误报', !r3.gone.length && !r3.modified.length, JSON.stringify(r3));
-  // S10④ 暂存删除（git rm）→ 提交树已无该件而台账仍跟踪 → gone 拦（复核 P1：HEAD 兜底曾把它误读
-  // 为「未触碰」放行 = 提交门绕过；修后与模块头「managed 删除即拦」政策一致）
-  g(repo, 'rm', '-q', '--cached', '.agents/scripts/a.mjs');
-  const r4 = ledgerDrift(repo, { staged: true });
-  check('S10④ 入库态：暂存删除 → gone 拦（提交树=index，删除被应用）', r4.gone.includes('.agents/scripts/a.mjs'), JSON.stringify(r4));
-  // S10④b 退出性提交：kit.json 被暂存删除 → 放行（skip，语义与 managed 删除拦截区分）
-  g(repo, 'rm', '-q', '--cached', '.agents/kit.json');
-  const r4b = ledgerDrift(repo, { staged: true });
-  check('S10④b 入库态：kit.json 暂存删除（退出性提交）→ skip 放行', r4b.skipped === true, JSON.stringify(r4b));
-  g(repo, 'reset', '-q', '--hard', 'HEAD'); // 复原（防脏）
-
-  // S10⑤ isMain 无参自适应（子进程）：暂存区空 → 「工作树」；暂存区非空 → 自动「入库态」
-  g(repo, 'reset', '-q', '--hard', 'HEAD'); // 清掉 ④ 的暂存删除，回到干净 v2 both
-  const s1 = runCli(repo); // 暂存区空 → 工作树口径
-  check('S10⑤ 暂存区空 → 工作树口径', s1.status === 0 && (s1.stdout || '').includes('工作树'), `out=${s1.stdout}`);
-  W2(repo, 'unrelated.txt', 'x\n');
-  g(repo, 'add', 'unrelated.txt'); // 暂存非空（无关文件即可）→ 自动入库态；kit.json 未暂存走 HEAD 兜底
-  const s2 = runCli(repo);
-  check('S10⑤ 暂存区非空 → 自动切入库态且一致 exit 0',
-    s2.status === 0 && (s2.stdout || '').includes('入库态'), `status=${s2.status} out=${s2.stdout}`);
-  // S10⑥ 姊妹漏洞（完备口径价值场景）：只 add 件不 add 台账 → 提交树 = HEAD 台账(v1? v2) + 暂存件 → 错位拦
-  W2(repo, '.agents/scripts/a.mjs', 'A v3\n');
-  g(repo, 'add', '.agents/scripts/a.mjs');
-  const s3 = runCli(repo);
-  check('S10⑥ 只 add 件不 add 台账 → 入库态错位拦 exit 1', s3.status === 1 && (s3.stderr || '').includes('.agents/scripts/a.mjs'), `status=${s3.status} err=${s3.stderr}`);
-  fs.rmSync(repo, { recursive: true, force: true });
-}
-
-console.log(`\n合计: PASS ${pass} / FAIL ${failCount}`);
-process.exit(failCount ? 1 : 0);

package/templates/_agents/scripts/source-sync-check.mjs

@@ -1,156 +0,0 @@
-// flow-kit source-sync-check：装户面同步一致性检查（包源 templates/_agents/ vs 装副本 .agents/）
-// 目的：包源改了 templates/_agents/ 但 .agents/ 装副本没刷新——这种"真空地带"sync.mjs 不扫、doctor.mjs §6.6 不扫
-//       本工具扫 templates/_agents/ 下所有 .md / .mjs / .json / .txt（排除 cache/）vs .agents/ 对应路径
-//       输出三类差异：缺失（包源有装副本无）/ 孤儿（包源无装副本有）/ 漂移（两者都有 sha 不一致）
-//       排除装副本独有文件：kit.json / settings.json / hooks/commit-check.config.json（init 渲染产物，不属双源）
-// 用法：node .agents/scripts/source-sync-check.mjs --diff
-//       node .agents/scripts/source-sync-check.mjs --json
-//       node .agents/scripts/source-sync-check.mjs --gate（门禁模式：缺失/漂移 exit 1，孤儿只报告不计失败
-//             ——pre-commit 双源一致性门禁用，2026-09-27 audit-gate-hardening；--diff/--json 仍恒 exit 0）
-//       node .agents/scripts/source-sync-check.mjs --pkg-root <path> --target <path>
-// 零依赖；B-b 决策「只报告不修复」（--gate 只加 exit 码裁决，不改默认行为）
-import fs from 'node:fs';
-import path from 'node:path';
-import { createHash } from 'node:crypto';
-
-function fail(msg) { console.error('❌ ' + msg); process.exit(1); }
-
-const VALID_EXTS = new Set(['.md', '.mjs', '.json', '.txt']);
-// 装副本独有文件（init 渲染产物，不属双源结构）
-const RENDER_OUTPUT_FILES = new Set(['kit.json', 'settings.json', 'hooks/commit-check.config.json']);
-// **项目自持、按设计就该与包源骨架不同**的架子文件（2026-09-28 追加）：
-// `notes/runtime-env.md` 自述「记录本机/本项目的运行时差异……**本文件是骨架：项目按实际填写，
-// 不随 flow-kit 升级覆盖**」——即包源只发骨架、装户填实况，**两处本就应当不同**。
-// 但本工具此前按 `.md` 全量比对，导致装户一旦按文件自述填写，`--gate` 即 exit 1（CI 红）：
-// 实测（本仓自装）填写后 --gate 报 `漂移 1: notes/runtime-env.md`，回滚即恢复 0。
-// 这属「门禁范围与文件自述冲突」，非真漂移——故按渲染产物同类处理（排除）。
-// 判据：该文件是**项目内容**而非**引擎件**；引擎件（.mjs 脚本等）不在排除内，仍受双源门禁约束。
-const PROJECT_OWNED_FILES = new Set(['notes/runtime-env.md']);
-const TARGET_EXCLUDE = new Set([...RENDER_OUTPUT_FILES, ...PROJECT_OWNED_FILES]);  // 向后兼容别名（原为 RENDER_OUTPUT_FILES）
-
-function sha256(p) {
-  try {
-    // LF 归一（2026-09-27 closing-coverage）：CRLF 盘面与 LF 克隆同值，行尾不一致不误报缺失/漂移/孤儿外差异
-    return createHash('sha256').update(fs.readFileSync(p, 'utf8').replace(/\r\n/g, '\n'), 'utf8').digest('hex');
-  } catch {
-    return null;
-  }
-}
-
-// walkMd：递归扫目录，列出所有 validExt 文件（排除 cache/）
-function walkMd(root) {
-  const out = [];
-  function walk(dir, relBase) {
-    if (!fs.existsSync(dir)) return;
-    for (const e of fs.readdirSync(dir, { withFileTypes: true })) {
-      const rel = relBase ? relBase + '/' + e.name : e.name;
-      const abs = path.join(dir, e.name);
-      // 排除 cache/ 目录（与 sync.mjs 既有约定一致）
-      if (rel === 'cache' || rel.startsWith('cache/')) continue;
-      if (e.isDirectory()) walk(abs, rel);
-      else if (VALID_EXTS.has(path.extname(e.name))) out.push(rel);
-    }
-  }
-  walk(root, '');
-  return out;
-}
-
-export function sourceSyncCheck({ pkgRoot, target }) {
-  const authorityRoot = path.join(pkgRoot, 'templates', '_agents');
-  const adapterRoot = path.join(target, '.agents');
-  // **两侧都要按 TARGET_EXCLUDE 过滤**（2026-09-28 修正）：只过滤装副本一侧会把排除件
-  // 变成「包源有 / 装副本无」的**缺失**（实测：加排除后 --gate 从「漂移 1」变成「缺失 1」，
-  // 仍 exit 1）。排除的语义是「不参与双源比对」，故包源侧同样滤掉。
-  const pkgFiles = walkMd(authorityRoot).filter((f) => !TARGET_EXCLUDE.has(f));
-  const tgtFiles = walkMd(adapterRoot).filter((f) => !TARGET_EXCLUDE.has(f));
-  const pkgSet = new Set(pkgFiles);
-  const tgtSet = new Set(tgtFiles);
-  const missing = []; // 包源有 / 装副本无
-  const orphan = [];  // 包源无 / 装副本有
-  const drift = [];   // 两者都有但 sha 不一致
-  for (const f of pkgFiles) {
-    if (!tgtSet.has(f)) { missing.push({ rel: f }); continue; }
-    const pkgSha = sha256(path.join(authorityRoot, f));
-    const tgtSha = sha256(path.join(adapterRoot, f));
-    if (pkgSha !== null && tgtSha !== null && pkgSha !== tgtSha) {
-      drift.push({ rel: f, pkgSha, tgtSha });
-    }
-  }
-  for (const f of tgtFiles) {
-    if (!pkgSet.has(f)) orphan.push({ rel: f });
-  }
-  return {
-    pkgRoot, target,
-    pkgCount: pkgFiles.length,
-    tgtCount: tgtFiles.length,
-    missing: missing.sort((a, b) => a.rel.localeCompare(b.rel)),
-    orphan: orphan.sort((a, b) => a.rel.localeCompare(b.rel)),
-    drift: drift.sort((a, b) => a.rel.localeCompare(b.rel)),
-  };
-}
-
-function printDiff(result) {
-  console.log('▶ flow-kit source-sync-check --diff');
-  console.log('  包源 (templates/_agents/) ' + result.pkgCount + ' 份  |  装副本 (.agents/) ' + result.tgtCount + ' 份');
-  if (!result.missing.length && !result.orphan.length && !result.drift.length) {
-    console.log('  无差异 ✅');
-    return;
-  }
-  if (result.missing.length) {
-    console.log('  缺失（包源有 / 装副本无）' + result.missing.length + '：');
-    for (const m of result.missing) console.log('    - ' + m.rel);
-  }
-  if (result.orphan.length) {
-    console.log('  孤儿（包源无 / 装副本有）' + result.orphan.length + '：');
-    for (const o of result.orphan) console.log('    - ' + o.rel);
-  }
-  if (result.drift.length) {
-    console.log('  漂移（包源装副本都有但 sha 不一致）' + result.drift.length + '：');
-    for (const d of result.drift) console.log('    - ' + d.rel + '  pkg=' + d.pkgSha.slice(0, 8) + '…  tgt=' + d.tgtSha.slice(0, 8) + '…');
-  }
-}
-
-const isMain = process.argv[1] && process.argv[1].endsWith('source-sync-check.mjs');
-if (isMain) {
-  let jsonMode = false, gateMode = false;
-  let pkgRoot = null, target = null;
-  for (let i = 0; i < process.argv.length - 2; i++) {
-    const a = process.argv[2 + i];
-    if (a === '--json') jsonMode = true;
-    else if (a === '--diff') { /* diff 为默认输出模式，无需置位 */ }
-    else if (a === '--gate') gateMode = true;
-    else if (a === '--pkg-root') pkgRoot = process.argv[2 + i + 1];
-    else if (a === '--target') target = process.argv[2 + i + 1];
-  }
-  if (!pkgRoot) pkgRoot = process.cwd();
-  if (!target) target = process.cwd();
-  const authorityRoot = path.join(pkgRoot, 'templates', '_agents');
-  const adapterRoot = path.join(target, '.agents');
-  if (!fs.existsSync(authorityRoot)) fail('找不到包源：' + authorityRoot);
-  if (!fs.existsSync(adapterRoot)) fail('找不到装副本：' + adapterRoot);
-  const result = sourceSyncCheck({ pkgRoot, target });
-  if (jsonMode) {
-    process.stdout.write(JSON.stringify({
-      pkgCount: result.pkgCount,
-      tgtCount: result.tgtCount,
-      missing: result.missing.map((m) => m.rel),
-      orphan: result.orphan.map((o) => o.rel),
-      drift: result.drift.map((d) => ({ rel: d.rel, pkgSha: d.pkgSha.slice(0, 8), tgtSha: d.tgtSha.slice(0, 8) })),
-    }, null, 2) + '\n');
-  } else {
-    printDiff(result);
-  }
-  if (gateMode) {
-    // 门禁模式（pre-commit 双源一致性用）：缺失/漂移非零阻断——正是「包源改了装副本没跟」的故障模式
-    // （doctor §4 台账 sha 对此静默：盘面=台账即 PASS；§4.5 只抓未登记）。孤儿只报告不计失败：
-    // 孤儿 = 装副本独有（装户自持内容如本地 skills），删留由人拍板，不入机器门。
-    if (result.missing.length || result.drift.length) {
-      console.error('❌ 双源不一致（缺失 ' + result.missing.length + ' / 漂移 ' + result.drift.length + '）——包源与装副本须同提交成对（双源纪律）；跑 node bin/flow-kit.mjs sync 后原路重试（孤儿只报告不计失败）');
-      process.exit(1);
-    }
-    process.exit(0);
-  }
-  // diff/json 模式总 exit 0；差异存在不视作错误（人类阅读用；B-b 决策「只报告不修复」）
-  process.exit(0);
-}
-export default sourceSyncCheck;