agentic-flow-kit 0.6.0 → 0.8.0

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

@@ -240,5 +240,42 @@ if (!SRC_ROOT) {
   check('S14 内容差异（甲 vs 乙）→ 报漂移（归一只认 CRLF 不吞内容）', r.drift.length === 1 && r.drift[0].rel === 'commands/a.md', JSON.stringify(r.drift));
 }
 
+// ---- 场景 15-16：项目自持架子文件排除（2026-09-28 runtime-env 双源冲突）----
+{
+  // S15 notes/runtime-env.md **两侧都被排除**——包源只发骨架、装户填实况，两处本就该不同。
+  // 回归：首版只过滤装副本一侧 → 排除件变成「包源有/装副本无」的**缺失**，--gate 仍 exit 1
+  // （实测：漂移 1 → 缺失 1）。故断言 missing/drift 皆为空。
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'fk-ssc-owned-'));
+  const pkgRoot = path.join(root, 'pkg');
+  const target = path.join(root, 'target');
+  const pkgBase = path.join(pkgRoot, 'templates', '_agents', 'notes');
+  const tgtBase = path.join(target, '.agents', 'notes');
+  fs.mkdirSync(pkgBase, { recursive: true });
+  fs.mkdirSync(tgtBase, { recursive: true });
+  fs.writeFileSync(path.join(pkgBase, 'runtime-env.md'), '# 骨架\n> 项目按实际填写\n');
+  fs.writeFileSync(path.join(tgtBase, 'runtime-env.md'), '# 实况\n> 本机 sh 路径已接\n');
+  const r = sourceSyncCheck({ pkgRoot, target });
+  check('S15 项目自持 runtime-env.md 两侧内容不同 → 既不报缺失也不报漂移（双侧排除）',
+    r.missing.length === 0 && r.drift.length === 0,
+    JSON.stringify({ missing: r.missing, drift: r.drift }));
+}
+{
+  // S16 排除**只针对该文件**——同目录其他 .md 仍受双源门禁约束（防排除范围被误放大）
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'fk-ssc-owned2-'));
+  const pkgRoot = path.join(root, 'pkg');
+  const target = path.join(root, 'target');
+  const pkgBase = path.join(pkgRoot, 'templates', '_agents', 'notes');
+  const tgtBase = path.join(target, '.agents', 'notes');
+  fs.mkdirSync(pkgBase, { recursive: true });
+  fs.mkdirSync(tgtBase, { recursive: true });
+  fs.writeFileSync(path.join(pkgBase, 'runtime-env.md'), '# 骨架\n');
+  fs.writeFileSync(path.join(tgtBase, 'runtime-env.md'), '# 实况\n');
+  fs.writeFileSync(path.join(pkgBase, 'other.md'), '# v1\n');
+  fs.writeFileSync(path.join(tgtBase, 'other.md'), '# v2\n');
+  const r = sourceSyncCheck({ pkgRoot, target });
+  check('S16 排除不放大——同目录 other.md 内容不同仍报漂移',
+    r.drift.length === 1 && r.drift[0].rel === 'notes/other.md', JSON.stringify(r.drift));
+}
+
 console.log('\n合计: PASS ' + pass + ' / FAIL ' + failCount);
 process.exit(failCount ? 1 : 0);

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

@@ -226,12 +226,23 @@ const fm = (extra = '') => `---\nname: t\ndescription: t\n${extra}---\n\n# w\n\n
 
 // ---- S14 真实仓库自扫 baseline：0 error（_TEMPLATE 排除后三份可执行件全过）----
 {
+  // **本场景是包源仓库的 baseline 断言，装户环境应 SKIP**（2026-09-28 修正）：
+  // 它上溯三级定位「真实仓库」，从 `templates/_agents/scripts/` 出发正确落在包源根；
+  // 但从装户的 `.agents/scripts/` 出发会落到 `<install>/..`，扫不到可执行编排件 →
+  // `files.length >= 3` 必假。首版没区分这两种上下文，导致**装户径下该套件恒红**——
+  // 实测：CI 新增「shipped 套件」步骤后，`.agents/scripts/workflows-check.test.mjs`
+  // 报 `FAIL S14（扫描面：）`（空扫描面），而包源侧同字节跑出 15/0。
+  // 判据：扫不到任何可执行件 = 本环境不适用 → SKIP（沿 doctor.test.mjs 同口径）。
   const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..', '..');
   const r = lintWorkflows({ root: ROOT });
   const names = r.files.map((f) => f.file).join('、');
-  check('S14 真实仓库 .agents/workflows/ 自扫 0 error（扫描面：' + names + '）',
-    r.errorCount === 0 && r.files.length >= 3,
-    JSON.stringify(r.files.filter((f) => f.errors.length).map((f) => ({ f: f.file, e: f.errors }))));
+  if (r.files.length === 0) {
+    check('S14 真实仓库自扫 SKIP（本环境无 .agents/workflows/ 可执行件——装户径，沿 doctor.test 同口径）', true);
+  } else {
+    check('S14 真实仓库 .agents/workflows/ 自扫 0 error（扫描面：' + names + '）',
+      r.errorCount === 0 && r.files.length >= 3,
+      JSON.stringify(r.files.filter((f) => f.errors.length).map((f) => ({ f: f.file, e: f.errors }))));
+  }
 }
 
 // ---- S14 human 确认门（第四形态）：单形态全绿 / 双填 E9 / ×retries W4 / 缺列兼容 ----

package/templates/_githooks/pre-commit

@@ -1,6 +1,6 @@
 #!/bin/sh
 # Git 原生 pre-commit hook（经 core.hooksPath 挂载，git 执行、不依赖 agent 客户端）— agentic-flow-kit 通用编排
-# 通用门禁序：闭环配对(增量) → wiki 台账(增量) → 常驻面体积预算(增量) → 双源一致性(增量) → 项目门禁(local-pre-commit) → 敏感信息扫描+条件构建(commit-check.cjs)
+# 通用门禁序：闭环配对(增量) → wiki 台账(增量) → 常驻面体积预算(增量) → 双源一致性(增量) → managed 台账快检(包源恒跑) → 项目门禁(local-pre-commit) → 敏感信息扫描+条件构建(commit-check.cjs)
 # 项目专属门禁（架构红线/业务守卫等）放 .agents/hooks/local-pre-commit——存在即在本钩子内执行，返回非零即阻断提交
 # 合并提交场景由 .githooks/pre-merge-commit 原样转发到本脚本（合并时 git 调的是 pre-merge-commit，
 # 不是 pre-commit）——门禁清单只此一份，避免两处分叉
@@ -46,6 +46,22 @@ if [ -d templates/_agents ] && [ -f .agents/scripts/source-sync-check.mjs ] \
   fi
 fi
 
+# managed 台账快检（包源环境恒跑，2026-09-28 ledger-precommit-gate；同日独立复核 P2-2 采纳）：
+# kit.json 台账 sha ↔ 盘面工作树（LF 归一，同 doctor §4 口径）——拦「台账 sha 预 landing」：台账记了
+# 盘面尚不存在的内容 sha。双源门禁对此静默（templates↔.agents 成对回退时两侧一致），doctor §4 只在
+# 手动全量跑——该故障模式三次真实发生（0272a1c 预入 / ff3c721 还原窗口 / 537df18 闭合），本块补齐
+# 提交时刻的第三边。恒跑不作暂存触发：预 landing 是仓态而非暂存态，暂存 grep 有前缀缝（如 .githooks/*
+# managed 件单边漂移不命中），毫秒级 80 份 hash 不构成开销理由。比较工作树而非暂存区（沿双源门禁
+# 口径）。装户环境（无 templates/_agents/ 包源）自然跳过——装户 managed 手改走 doctor §4 WARN 口径，
+# 不硬拦。已知边界：managed 删除即拦（sync 对 removed 只报不删，删件须手动同步装副本并重跑 sync 刷
+# 台账）。
+if [ -d templates/_agents ] && [ -f .agents/scripts/check-ledger.mjs ]; then
+  if ! node .agents/scripts/check-ledger.mjs; then
+    echo "pre-commit: managed 台账快检未通过，提交已阻止——kit.json 与盘面不一致，跑 node bin/flow-kit.mjs sync 成对后原路重试" >&2
+    exit 1
+  fi
+fi
+
 # 项目门禁挂载点：.agents/hooks/local-pre-commit（项目自建门禁/门禁模块接线处，存在即执行）
 if [ -f .agents/hooks/local-pre-commit ]; then
   run_gate "项目门禁（local-pre-commit）" .agents/hooks/local-pre-commit