agentic-flow-kit 1.7.15 → 1.7.16

package/templates/_agents/engine-lock.json

@@ -0,0 +1,246 @@
+{
+  "schema": 1,
+  "generatedAt": "2026-10-13T08:17:26.315Z",
+  "files": {
+    ".github/workflows/ci.yml": {
+      "sha256": "ae6b751a29ce08f28f8831fc9b64770acce4d42fc6a5bd60286eca67e8488bd9",
+      "hard": 3
+    },
+    ".github/workflows/release.yml": {
+      "sha256": "c8032a042da93974d7481b37a5a51eefa421b1eacc065424f35095ccd00b7c6b",
+      "hard": 0
+    },
+    "templates/AGENTS.md": {
+      "sha256": "013df60e0236f3bbd22ca9d8140cc922cdfd603a3efdf58b13a95a6e561d0017",
+      "hard": 27
+    },
+    "templates/_agents/control-surfaces.txt": {
+      "sha256": "ae6072b58fde4cf2ad65ce27d0216133dabbd189b0542a0dbf11bbd9e0608407",
+      "hard": 29
+    },
+    "templates/_agents/lane-surfaces.txt": {
+      "sha256": "e378c19f5a85bd9118a1e2e04fb18645482990e886df32ea97c4d65411d850e6",
+      "hard": 5
+    },
+    "templates/_agents/level-hints.txt": {
+      "sha256": "6cb3a2c9f2bdd9b0f859c3eb67c310e2dab12d8777a5bd82a31a8634890b0a43",
+      "hard": 0
+    },
+    "templates/_agents/metric-claims.txt": {
+      "sha256": "e668589d817d589b9f81ba73460c0bd024d6d34203c9f1fa36bb9019d5e8b3ce",
+      "hard": 8
+    },
+    "templates/_agents/rule-budgets.txt": {
+      "sha256": "cd5fee0ae3eebe0398f2b15d4c801bc7f30c4ec20d46508033eeebb4a417a960",
+      "hard": 3
+    },
+    "templates/_agents/scripts-test-exempt.txt": {
+      "sha256": "05a96ae19289deb074392ca4de212aa277dabf2ea8bc7be8bceb9f3c7a234fbd",
+      "hard": 5
+    },
+    "templates/_agents/scripts/agg-gate-stats.mjs": {
+      "sha256": "488517dfdc37b79b327e1f47603c94fc1fc236145d12df213e6ce2de60f11730",
+      "hard": 0
+    },
+    "templates/_agents/scripts/check-engine-integrity.mjs": {
+      "sha256": "e62a23c861d060ee74f15aae57410cfce8e644e29517ebc5b1c1c3d85e5935c1",
+      "hard": 2
+    },
+    "templates/_agents/scripts/check-hygiene.mjs": {
+      "sha256": "0fecd44c28f1b5759a4bb01f3c19213cace48a162e27802f2f1c1df67eec15ff",
+      "hard": 0
+    },
+    "templates/_agents/scripts/check-lane-surface.mjs": {
+      "sha256": "c22ad9ab80070051d2c9db344f407c70e9d9a2815dc0c73066f43bc16592bf98",
+      "hard": 2
+    },
+    "templates/_agents/scripts/check-ledger-invariant.mjs": {
+      "sha256": "2d187a82781a5e076985d91f1a4734b45cd507c1b87942064bad949bd0b3f806",
+      "hard": 2
+    },
+    "templates/_agents/scripts/check-loop.mjs": {
+      "sha256": "a7af1f7c065b20e81b137027d02762d1414ea2ead778e45b5f17dcb7c14017f4",
+      "hard": 32
+    },
+    "templates/_agents/scripts/check-metric-claims.mjs": {
+      "sha256": "2c2d8615e9418117d43202dc67cd4131e43fb6c095686363dfcd2fd2cb542f2a",
+      "hard": 0
+    },
+    "templates/_agents/scripts/check-stage-index.mjs": {
+      "sha256": "9118b8fe57b80b5d36a0db38ed141c08036629895c143a64f0c29e301b2218c8",
+      "hard": 0
+    },
+    "templates/_agents/scripts/compact-ledgers.mjs": {
+      "sha256": "b517a775bcbcaaca8b8e58ed85c611c9fc1a40f64b19ee0f40ea137b40a0042e",
+      "hard": 1
+    },
+    "templates/_agents/scripts/confirm-doc.mjs": {
+      "sha256": "8d9f8478fa80be447c8e372a94be4b991c02a9077c7bd087bbf8e77feb65834e",
+      "hard": 12
+    },
+    "templates/_agents/scripts/draft-sediment.mjs": {
+      "sha256": "a9c51e3fd139adf32755d882e0de53f208784be68a75c1881658c3886605c76d",
+      "hard": 1
+    },
+    "templates/_agents/scripts/edit-face-check.mjs": {
+      "sha256": "24faba555101f0aacd652e3728c99982f95461cd57de844f9483df6a6923d1fa",
+      "hard": 0
+    },
+    "templates/_agents/scripts/ensure-board.mjs": {
+      "sha256": "8d2211ddaa5f29e961d6ad435fa780baca45722dc79cdd9a01931f8688a5359c",
+      "hard": 0
+    },
+    "templates/_agents/scripts/fill-intent.mjs": {
+      "sha256": "b5e386e2a088c2cfbb9101379233295ce199d668866ddef596140fc76db6d766",
+      "hard": 1
+    },
+    "templates/_agents/scripts/fill-plan.mjs": {
+      "sha256": "ea60a3e478236e4fc3b25c84bb74217f3eb5130968d3165665e17ae7cc2329af",
+      "hard": 1
+    },
+    "templates/_agents/scripts/fill-spec.mjs": {
+      "sha256": "27aa4d55a9c17be40b8c3a89191b3336661340ca975cf04397dd62afe4ec2431",
+      "hard": 1
+    },
+    "templates/_agents/scripts/fixture-scripts.mjs": {
+      "sha256": "9f27ff097b8a4172de5f96aa23c1c625801bc5625e2434c332c30482b1761380",
+      "hard": 0
+    },
+    "templates/_agents/scripts/gate-checklist.mjs": {
+      "sha256": "99ec369fddee6867a2baeced610760e58a3f85506f95f8a4131bcc584a3a3109",
+      "hard": 1
+    },
+    "templates/_agents/scripts/gate-seg.mjs": {
+      "sha256": "b579593ff67e7876e4e1051f62c9a7451032fb2255a2efe5e437a6a2e2c1ce9f",
+      "hard": 0
+    },
+    "templates/_agents/scripts/gen-wiki-board.mjs": {
+      "sha256": "c0e86110c8b686b591080f836d7cde6dc4a933820541ceb35928ac249b5d0fb6",
+      "hard": 6
+    },
+    "templates/_agents/scripts/gen-workflow-dashboard.mjs": {
+      "sha256": "335485bf6979b43f642e613abae951b69ad4d6b6ed0b026dfdde7f14cd2aebdc",
+      "hard": 0
+    },
+    "templates/_agents/scripts/gen-workflow-index.mjs": {
+      "sha256": "5e8bcab656c056d2e07b3286b9869705bff3deebbc97a131f731c360236fe9dd",
+      "hard": 3
+    },
+    "templates/_agents/scripts/gen-workflow-metrics.mjs": {
+      "sha256": "c91b6ff9fd5e3b391c8c50af1d68f35058286ef432dddb325f284e0d60833d56",
+      "hard": 2
+    },
+    "templates/_agents/scripts/git-merge-jsonl.mjs": {
+      "sha256": "e8c037dcce1f9e52dd9d63ef812ce3ace03f1ecf3e55cb363e58bd8b50352655",
+      "hard": 2
+    },
+    "templates/_agents/scripts/kb-cache-evict.mjs": {
+      "sha256": "bd74ac72e611142e839df76e80e22d8e9c6b351dc498c7bb07e807d2e32e7fdb",
+      "hard": 0
+    },
+    "templates/_agents/scripts/kb-search.mjs": {
+      "sha256": "3439e59cdafc8a52549fc8cee3bab8eaec384e4761d3f87a7f18db0a8e289d0c",
+      "hard": 7
+    },
+    "templates/_agents/scripts/ledger-loader.mjs": {
+      "sha256": "855619ec778eae07540f71ebab0c2f30de0e6b97b522ad69e4d1757cc4202713",
+      "hard": 0
+    },
+    "templates/_agents/scripts/ledger-prune.mjs": {
+      "sha256": "82ca3086bf76087ece4436bf2c23a2e102c22dffd6c987c08096286c3d16a0b7",
+      "hard": 0
+    },
+    "templates/_agents/scripts/level-criteria.mjs": {
+      "sha256": "384fc339ba1d24815a1db226cb8be165b4c042b983bc7af6c6623114ddc35234",
+      "hard": 1
+    },
+    "templates/_agents/scripts/pipeline-run-docs.mjs": {
+      "sha256": "d54085b21d857f4db6df7d5fc7b6a65ffc2391c9e0f100754d1e76a844a318c1",
+      "hard": 0
+    },
+    "templates/_agents/scripts/pipeline-run-run.mjs": {
+      "sha256": "b5bda64bee55dcd1fc44170a5e3ab5a5c96c404529d19885fd5b2d6b9d5143bf",
+      "hard": 0
+    },
+    "templates/_agents/scripts/pipeline-run.mjs": {
+      "sha256": "6cdf2de3bcbf94d59ccf5e6c4015e89b6032c844c2cc540fdc4f9e02244faa9c",
+      "hard": 0
+    },
+    "templates/_agents/scripts/policy.mjs": {
+      "sha256": "eab1a54334d83b93f276593be4e10a17af7734a7c44f8c28a6383946f735613e",
+      "hard": 0
+    },
+    "templates/_agents/scripts/solidify-task.mjs": {
+      "sha256": "5e5983b9ab6ae4eaaeced150018592b2501c4d6885b4913d03c6f29138630825",
+      "hard": 3
+    },
+    "templates/_agents/scripts/stage-gates.mjs": {
+      "sha256": "6c70ff01f785d19dfa7206cc01c1608baa3249ba59f57190b19b64f318e34e72",
+      "hard": 0
+    },
+    "templates/_agents/scripts/trust-mode.mjs": {
+      "sha256": "5800b52af787d6b3fd9a8ea314b36466e19a3adc90f70e93c5054cd530c68bff",
+      "hard": 1
+    },
+    "templates/_agents/scripts/verify-wiki-consistency.mjs": {
+      "sha256": "1f58ace65b6bab02eba5df1c69f5b55528df5c098e6d06f8197594912d764c32",
+      "hard": 4
+    },
+    "templates/_agents/scripts/verify.mjs": {
+      "sha256": "a40a23193dae79e189c9c7b1f8b1c4c6e1865baa94052c85ed59802864aa46b9",
+      "hard": 3
+    },
+    "templates/_agents/scripts/wf-journal.mjs": {
+      "sha256": "b14620e5c9f9c930f4a916084543ce190a135216f11bc4150dcb246c8cdb0e83",
+      "hard": 1
+    },
+    "templates/_agents/scripts/wiki-search.mjs": {
+      "sha256": "a493c85924644613619b83334b6f8e4db40ebf0d398960738422116d3afd3015",
+      "hard": 0
+    },
+    "templates/_agents/scripts/workflow-board-server.mjs": {
+      "sha256": "1ef41d13f192f119cd7307dcf59710be9e185308333a60067d3e1ebfb149e9f4",
+      "hard": 1
+    },
+    "templates/_agents/scripts/workflow-enums.mjs": {
+      "sha256": "540ce00ec954f90a67d886dcf10f2ebb0661056187f563ba55ec34bf9c0afecd",
+      "hard": 0
+    },
+    "templates/_agents/scripts/workflows-check.mjs": {
+      "sha256": "d29f5df709bb3d95b227202bb44a9e056af33bbe4f3afb87eefb94d96a2205cc",
+      "hard": 1
+    },
+    "templates/_agents/workflow-enums.txt": {
+      "sha256": "b28a83418133e24f3e4daee7f454c4f31ac98a943a94aa33008a944ae751d25a",
+      "hard": 8
+    },
+    "templates/_agents/workflow-modules.txt": {
+      "sha256": "d03593598f6b0495ebc650019c474da0d6538da06c6f58ccc00bd5a9cdc760f1",
+      "hard": 7
+    },
+    "templates/_githooks/commit-msg": {
+      "sha256": "3e946cbf3f59a469ec977a036ff8bfc960be7febe36318a0fd112b7adaadfc75",
+      "hard": 1
+    },
+    "templates/_githooks/post-commit": {
+      "sha256": "cb97b622a957027e6cfc04c3b7220da476e64d4c3ec902ea00ee14e570c6f3f1",
+      "hard": 0
+    },
+    "templates/_githooks/pre-commit": {
+      "sha256": "d65b6bd9adc59582e5209c1ddbdfe11a231d1312362c8f594e2579e7d3700e86",
+      "hard": 4
+    },
+    "templates/_githooks/pre-merge-commit": {
+      "sha256": "ab6d11707e78ac19261bc7d667056f7721466456d443cabf85ad7ba24dc797ac",
+      "hard": 1
+    },
+    "templates/_githooks/pre-push": {
+      "sha256": "c28d0c19204f0202dd270bbdb8e9b5d0362e56d67e2fbfbff33267ec7f592c9f",
+      "hard": 2
+    },
+    "templates/_github/workflows/kit-ci.yml": {
+      "sha256": "08c6e09992df9c1c3805ded11f01d33cea49ee64c4c5950ba3de15a8227e6464",
+      "hard": 3
+    }
+  }
+}

package/templates/_agents/lane-surfaces.txt

@@ -3,7 +3,7 @@
 #   # 注释与空行忽略；本文件缺失或清单为空 = 检查跳过（装户无感升级）。
 #   正则语法错误行 → 门禁 fail-closed 阻断（防静默空洞，修配置后重试）。
 # 语义：命中任一模式 = 本次改动触及「一处定义、多处消费」的契约 / 规则面（L2 触达面，
-#   判据见 .agents/commands/new-task.md §级别判断）。此时须有活跃（draft/approved / open/fixed）
+#   判据单源见 .agents/scripts/level-criteria.mjs 的 L2_SURFACES）。此时须有活跃（draft/approved / open/fixed）
 #   L2/L3 入口罩着；活跃入口全为 L0/L1 会被 pre-commit「触达面判低」拦截（三选修法见门禁消息）。
 #   无任何活跃入口时仅 advisory——docs / bootstrap 豁免类改动（new-task.md §intent 豁免）不受阻。
 # 本仓默认面（引擎 / 契约面，行为承载目录——commands/roles 纯提示文本属 docs 级不列入；按项目自行改）：

package/templates/_agents/level-hints.txt

@@ -0,0 +1,30 @@
+# 风险级别路径提示清单（单源消费方：templates/_agents/scripts/level-criteria.mjs）
+#
+# 用途：登记「哪些路径一碰就**至少**是 L2 / L3」。定级是**意图面**的语义判定（「一处定义、多处消费」），
+#       机器判不了语义；但「路径下限」可以登记，避免明显高风险的改动被拍脑袋判成 L1。
+#       与 lane-surfaces.txt 的分工：那是**提交面**的触达判据（改这些面须有活跃 L2/L3 入口），
+#       本文件是**意图面**的档位提示（改这些面就该按更高档走）。两者不同档，各司其职。
+#
+# 格式：每行一条 `<档位> <ERE>`，ERE 为 grep -E 兼容正则，匹配仓库相对路径（/ 分隔）。
+#   档位**只收 L2 / L3**：本清单登记的是「一碰就至少是中/高风险面」的下限。L0/L1 不构成门槛，
+#   登记了只会让提交面判低门（L2 触达面门）对无关改动出手——那正是要避免的噪声。
+#   **ERE 与注释必须分两行**：写 `L3 ^a\.sql$  # 迁移 SQL` 会把 `# 迁移 SQL` 编进正则，
+#   若含 $ 锚点该条就永不命中，且不报任何错（路径下限与提交面兜底同时静默失效）。
+#   确需匹配路径里的 # 时写 \#。非法档位 / 行内注释 / 正则语法错 → **fail-loud 抛错**
+#   （写错配置比没配置危险：没配置会提示补，写错会误判）。
+#   # 注释与空行忽略；本文件缺失或清单为空 = 纯语义定级（判据面全程静默，不阻断）。
+#
+# 默认留空（刻意）：本清单内容是**项目私有**的——按你自己的代码布局登记，照抄别人的清单等于没登记。
+# 建议起步：从「改什么几乎必然是 L2/L3」的高频面挑 3~5 条先登记，跑一段时间再补。
+#
+# ---- 示例（取消注释并按项目实际路径改写；本仓为 node 包源，下例仅示意形态）----
+# # 迁移 SQL（注释单独成行，不要接在 ERE 后面）
+# L3 ^src/db/migrations/.*\.sql$
+# # schema 定义
+# L3 ^src/db/schema/
+# # 认证与中间件管线 / DI 链
+# L3 ^(src/(auth|middleware)/|src/.*\.(auth|di)\.(ts|js)$)
+# # 共享契约（DTO / 接口签名）
+# L2 ^src/contracts/
+# # 编码权威（取号 / 命名规则生成器）
+# L2 ^src/coding/

package/templates/_agents/scripts/agg-delegations.test.mjs

@@ -8,10 +8,12 @@ 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';
+import { fileURLToPath, pathToFileURL } from 'node:url';
 
 const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
-const SRC = path.join(SCRIPT_DIR, 'agg-delegations.cjs');
+// 夹具闭包（2026-10-12 fixture-closure-rootfix）：入口 agg-delegations.cjs 的传递依赖自动带入（当前无，
+// 但日后加 import 不必回来改这里——漏拷 = 假绿）。
+const { copyScriptClosure } = await import(pathToFileURL(path.join(SCRIPT_DIR, 'fixture-scripts.mjs')).href);
 const USAGE = '用法：node .agents/scripts/agg-delegations.test.mjs';
 
 let pass = 0;
@@ -26,7 +28,7 @@ const mkfix = (ledgerText) => {
   fs.mkdirSync(path.join(root, '.agents', 'scripts'), { recursive: true });
   fs.mkdirSync(path.join(root, 'workflow', 'incidents'), { recursive: true });
   fs.writeFileSync(path.join(root, 'workflow', 'delegations.md'), ledgerText, 'utf8');
-  fs.copyFileSync(SRC, path.join(root, '.agents', 'scripts', 'agg-delegations.cjs'));
+  copyScriptClosure(path.join(root, '.agents', 'scripts'), ['agg-delegations.cjs']);
   return root;
 };
 const runAgg = (root) => spawnSync(process.execPath, [path.join(root, '.agents', 'scripts', 'agg-delegations.cjs')], { cwd: root, encoding: 'utf8' });

package/templates/_agents/scripts/check-engine-integrity.mjs

@@ -7,39 +7,44 @@
 //   ② CI 的机器门跑的是**被测分支自己的** `.agents/scripts/check-loop.mjs`（ci.yml:42）——被改坏的
 //      裁判验证自己的篡改，无外部参照，CI 全绿。
 //
-// 本门的做法：把「门禁本体当前的硬拦面」**冻结进一个入库基线** `.agents/engine-lock.json`，
-//   判定 = HEAD 盘面向量 ↔ 基线逐项比对（哈希 + 硬拦单位数）。它不是签名、也不宣称不可伪造——
-//   它把「静默改弱」变成「必须显式声明的改弱」：
+// 本门的做法：把「门禁本体当前的硬拦面」**冻结进一个入库基线** `templates/_agents/engine-lock.json`，
+//   判定 = 包源盘面向量 ↔ 基线逐项比对（哈希 + 硬拦单位数）。它不是签名、也不宣称不可伪造——
+//   它把「静默改弱」变成「必须显式 --update 的改弱」：
 //     · 硬拦单位数**下降**（删 blocker / 删 exit 1 / 从面清单删行 / 从 CI 删一次门调用）→ 无条件 BLOCK；
-//     · 内容变了但硬拦面没缩 → 须有一份**活跃 L2/L3 入口文档正文点名该文件**，否则 BLOCK；
-//     · 基线本身在受检面内（engine-lock.json 已入 control-surfaces，装户径与包源径两面），
-//       改基线同样要过入口门。
-//   于是绕过路径从「编辑一个文件」抬到「编辑两个文件 + 立一份 L2 文档 + 落一条确认台账 + 提交」——
-//   每一环都在 git 历史与台账里留痕，可事后对质。诚实边界：`--no-verify` / 不挂 hooksPath /
-//   删掉本脚本仍可绕过本地门，兜底 = CI 复跑（本脚本被 ci.yml 调用）+ 分支保护；本地信任边界内
+//     · 内容变了但硬拦面没缩 → 同样 BLOCK，直到跑 --update 把新盘面显式入账；
+//     · 基线本身在受检面内（control-surfaces 列了 templates/_agents/engine-lock.json），
+//       改基线同样要过本门（对基线的改动 = 受检面内容变更 → 未入新基线即拦）。
+//   诚实边界：`--no-verify` / 不挂 hooksPath / 删掉本脚本仍可绕过本地门，兜底 = CI 复跑
+//   （本脚本被 .github/workflows 的 engine-integrity job 调用）+ 分支保护；本地信任边界内
 //   不可机器防这一点不掩盖（沿 policy.mjs#ledgerChainHash 与 README 确认门口径）。
 //
+// **无声明式豁免（2026-10-13 移除入口退路）**：此前本门有两档豁免——本地层「正文提及即认」、
+//   锚层「活跃 L2/L3 入口在 §改动面 点名」，参照物是 `<root>/workflow/{intents,incidents}`。
+//   但 1.7.15「卸掉同仓双身份」后**包源仓已无该目录**（装户端内容清理），退路在本仓结构性不可达：
+//   门消息让包源维护者去「立 L2 入口」，而立不了——不可达的能力等于误导。故整体移除（连带
+//   T4b/T4c/T4d 与锚层严格档测试）：本仓只认 --update 这一条显式演进路径，语义更少、更可核对。
+//   **代价（诚实记录）**：跨提交锚只比对**硬拦单位数**、不比 sha，故「改写某检查的语义但保住
+//   exit 1 计数 + --update」这一形态两层都绿。补法是让锚层也比对 sha，代价是每次合法演进都需一份
+//   显式凭据（改判据面，未决）。
+//
 // 可选外部锚两条（都是「不受被测对象控制的参照物」，缺省不启用=无外部副本/无历史时不误报）：
 //   --against <目录>      逐字比对包源件与外部副本（装户/发布仓：node_modules/agentic-flow-kit）
 //   --against-ref <ref>   跨提交锚（破 CI 自指的关键一环）：从**历史 ref** 读基线（git show <ref>:<lock>），
 //     与盘面硬拦单位数做单调比较。本地门只比「盘面 ↔ 同分支基线」——恶意分支可同时改弱门禁并 --update
 //     重写基线，两者自洽、CI 全绿（「裁判给自己判无罪」的第二形态）。跨提交锚的参照物在**祖先提交**里，
 //     改它要 rewrite history + 强推（分支保护拦住），CI 由此获得一个不受被测分支控制的参照。
-//     合法收缩（退役一道门）不是一步死路：本地层宽松档（正文提及即认），锚层**严格档**——须活跃
-//     L2/L3 入口在 §改动面 段落点名该文件（正文顺手提及不豁免；否则存量无关 L2 文档可替任意改弱背书）。
+//     硬拦面收缩在本层**无豁免出口**：锚的参照物分支改不动，只能改判据基线并走评审。
 //     ref 不可解析 / 该 ref 无基线（首个入账提交）→ 跳过并报 ℹ️（锚缺失不误报）。
 //
-// 判据原则（沿 check-lane-surface）：只用一手事实——盘面字节哈希、可数单位、文档正文点名；
-//   不从时间戳反推过程。
+// 判据原则（沿 check-lane-surface）：只用一手事实——盘面字节哈希与可数单位；
+//   不从时间戳反推过程、不靠文档正文为改动背书。
 // 用法：node check-engine-integrity.mjs [--root <dir>] [--update] [--against <dir>] [--against-ref <ref>] [--quiet]
-//   --update  按当前盘面重生成基线（合法演进的最后一步；本身是控制面改动，须与入口文档同批提交）
-// 退出码：0 通过（含基线缺失=未启用）；1 阻断（stderr 出 [标签] 与修法）；2 用法错误（如 --against 目录不存在）
+//   --update  按当前盘面重生成基线（合法演进的唯一路径：演进=显式改基线，不存在自动放行）
+// 退出码：0 通过（含基线缺失=未启用）；1 阻断（stderr 出 [标签] 与修法，或目标根不是包源仓）；2 用法错误（如 --against 目录不存在）
 import fs from 'node:fs';
 import path from 'node:path';
 import { createHash } from 'node:crypto';
 import { spawnSync } from 'node:child_process';
-import { laneOfEntry, laneOfDoc } from './stage-gates.mjs';
-import { loadKitPolicy } from './policy.mjs';
 
 const argv = process.argv.slice(2);
 const argOf = (k) => {
@@ -53,24 +58,19 @@ const ROOT = argOf('--root') || (() => {
   const r = spawnSync('git', ['-C', process.cwd(), 'rev-parse', '--show-toplevel'], { encoding: 'utf8' });
   return r.status === 0 ? String(r.stdout || '').trim() : process.cwd();
 })();
-// 引擎基线路径双布局（装户端内容清理后）：盘面已有基线按其径读；两处皆无时按**仓库布局**定
-// 落点——.agents/ 在 = 装户径；否则 templates/_agents/ 在 = 包源径（--update 才不会重建已清理的装户目录）。
-// ⚠️ 包源径在 sync 下发面内（render.mjs 只排除 .agents/cache）：包源基线的键是 templates/_agents/scripts/…
-// 路径，装户盘面是 .agents/scripts/…——一旦把包源基线入库，sync 会把它下发进每个装户的 .agents/，
-// 命名空间错配 → 全员误报「门禁件消失 / 未入基线」。纯包源仓**不得入库包源基线**；要引擎仓自证
-// 完整性，须把基线放到 sync 扫描面之外（如仓库根）再接线 CI，且其豁免出口（L2 入口）在纯包源仓
-// 无 workflow/ 的情况下无处可立——这是设计约束，不是待修缺陷。
-const LOCK_CANDIDATES = ['.agents/engine-lock.json', 'templates/_agents/engine-lock.json'];
-const resolveLock = () => {
-  for (const rel of LOCK_CANDIDATES) {
-    if (fs.existsSync(path.join(ROOT, rel))) return { rel, abs: path.join(ROOT, rel) };
-  }
-  const fallback = fs.existsSync(path.join(ROOT, '.agents'))
-    ? LOCK_CANDIDATES[0]
-    : LOCK_CANDIDATES[1];
-  return { rel: fallback, abs: path.join(ROOT, fallback) };
-};
-const { rel: LOCK_REL, abs: LOCK_ABS } = resolveLock();
+// 只认包源。基线固定 templates/_agents/engine-lock.json。受检面只扫包源模板
+// （scripts / _githooks / templates/_github / .github/workflows / templates/AGENTS.md / templates/_agents/*.txt）。
+// `.github/workflows/*.yml` 是包源自身的 CI 编排——本门的调用点在那儿，不纳入就等于门可被无声关闭。
+// 不扫 .agents、不扫项目根 .githooks、不按「有没有 .agents」猜布局。
+// 无 templates/_agents 时所有模式都拒绝：静默扫到 0 个文件会看起来像通过。
+// render.mjs 排除 .agents/engine-lock.json，避免把包源基线下发进装户。
+const pkgAgents = path.join(ROOT, 'templates', '_agents');
+if (!fs.existsSync(pkgAgents)) {
+  console.error(`check-engine-integrity 只在包源仓运行（需要 templates/_agents）。目标根 ${ROOT} 不是包源仓。`);
+  process.exit(1);
+}
+const LOCK_REL = 'templates/_agents/engine-lock.json';
+const LOCK_ABS = path.join(ROOT, LOCK_REL);
 
 // ---- 受检面（单源：本函数；基线与比对同一份清单，防「基线少记一项」的静默空洞）----
 const gateFiles = () => {
@@ -86,18 +86,20 @@ const gateFiles = () => {
     }
   };
   addDir('templates/_agents/scripts', (r) => /\.mjs$/.test(r) && !r.endsWith('.test.mjs'));
-  addDir('.agents/scripts', (r) => /\.mjs$/.test(r) && !r.endsWith('.test.mjs'));
   addDir('templates/_githooks');
-  addDir('.githooks');
-  addDir('.agents/hooks');
-  addDir('.github/workflows', (r) => r.endsWith('.yml'));
   addDir('templates/_github/workflows', (r) => r.endsWith('.yml'));
+  // 包源自身的机器门编排（.github/workflows/*.yml）。**刻意纳入**：本门是「唯一能防改弱门禁本体」的检查，
+  //   而门要成为门就得有人调用它——调用点只存在于 CI 编排里。不纳入的话，删掉编排里的本门调用
+  //   （或整个 job）没有任何检查会发现：被保护面之外的空白，正是它自身失效的那条路径。
+  addDir('.github/workflows', (r) => r.endsWith('.yml'));
   for (const f of ['lane-surfaces.txt', 'control-surfaces.txt', 'workflow-enums.txt', 'workflow-modules.txt',
-    'scripts-test-exempt.txt', 'rule-budgets.txt', 'metric-claims.txt']) {
-    add(`.agents/${f}`);
+    'scripts-test-exempt.txt', 'rule-budgets.txt', 'metric-claims.txt',
+    // level-hints.txt（2026-10-13 flow-kit-route 补录）：风险级别的**路径下限**清单，直接驱动
+    //   flow-kit route 定级结果，且语法错会 fail-loud 抛 LEVEL_HINTS_INVALID 改判级结论。
+    //   与 lane-surfaces.txt / workflow-modules.txt 同属「喂判据的输入面」，此前漏在受检面外。
+    'level-hints.txt']) {
     add(`templates/_agents/${f}`);
   }
-  add('AGENTS.md');
   add('templates/AGENTS.md');
   return [...out].sort();
 };
@@ -135,71 +137,6 @@ const readJson = (p) => {
   try { return JSON.parse(fs.readFileSync(p, 'utf8')); } catch { return null; }
 };
 
-// 活跃 L2/L3（泳道 high）入口集合：一次扫描，宽松/严格两档判据共用同一份盘面事实
-const HIGH_ENTRIES = (() => {
-  const ACTIVE = { intent: new Set(['draft', 'approved']), incident: new Set(['open', 'fixed']) };
-  const fmGet = (lines, key) => {
-    for (let i = 1; i < lines.length; i++) {
-      if (/^---\s*$/.test(lines[i])) break;
-      const m = lines[i].match(new RegExp(`^${key}:\\s*(.*)$`));
-      if (m) return m[1].trim();
-    }
-    return '';
-  };
-  const pol = loadKitPolicy(ROOT);
-  const cache = [];
-  for (const [dir, kind] of [['intents', 'intent'], ['incidents', 'incident']]) {
-    const dp = path.join(ROOT, 'workflow', dir);
-    if (!fs.existsSync(dp)) continue;
-    for (const f of fs.readdirSync(dp)) {
-      if (!f.endsWith('.md') || f === '_TEMPLATE.md') continue;
-      const abs = path.join(dp, f);
-      let lines;
-      try { lines = fs.readFileSync(abs, 'utf8').replace(/\r\n/g, '\n').split('\n'); } catch { continue; }
-      if (!/^---\s*$/.test(lines[0] || '')) continue;
-      const st = fmGet(lines, '状态');
-      if (!ACTIVE[kind].has(st)) continue;
-      const level = fmGet(lines, '级别');
-      const lane = kind === 'intent'
-        ? laneOfEntry(level, fmGet(lines, 'risk_level'), pol.riskLevelSince, fmGet(lines, '日期'))
-        : laneOfDoc(level);
-      if (lane !== 'high') continue;
-      cache.push({ rel: `workflow/${dir}/${f}`, text: lines.join('\n') });
-    }
-  }
-  return cache;
-})();
-
-// 宽松档（本地层）：整条 rel 或 basename 出现在正文即认——口径同检查 8 的「声明改动面 ↔ 提交文件」
-//   模糊匹配，宁松不假阳性；精确性由 confirm-doc 指纹与台账承担。
-const entryNamesFile = (fileRel) => {
-  const base = path.basename(fileRel);
-  return HIGH_ENTRIES.find((e) => e.text.includes(fileRel) || e.text.includes(base)) || null;
-};
-
-// 严格档（仅跨提交锚用）：入口须在**声明改动面**段落点名该文件，而非正文任意一处提及。
-//   为什么分层：本地层的模糊放行代价低（内容漂移本就允许「声明过的演进」）；锚层拦的是
-//   「硬拦单位数下降」——若一句顺手提及就能豁免，本仓实测三份**与本批无关的存量 L2 incident**
-//   （2026-09-28-metric-claim-gate / 2026-10-03-plan-confirm-boiler 正文含 check-loop.mjs，
-//   2026-09-26-managed-ledger-adopt 含 pre-commit）即可替任意改弱行为背书，锚等于没有。
-//   严格档的误拦修法就是协议本意：把该文件写进入口的 §改动面。
-const entryDeclaresFile = (() => {
-  const SECTION = /^[^\n]{0,40}改动面/;
-  const declared = (text) => {
-    const lines = text.split('\n');
-    const out = [];
-    for (let i = 0; i < lines.length; i++) {
-      if (/^---\s*$/.test(lines[i]) || !SECTION.test(lines[i])) continue;
-      // 含标题行本身（「§改动面 点名 x.mjs」是常见的一行式声明）与标题后到下一个 heading 前的全部正文
-      for (let j = i; j < lines.length && (j === i || !/^\s*#{1,6}\s/.test(lines[j])); j++) out.push(lines[j]);
-    }
-    return out.join('\n');
-  };
-  return (fileRel) => {
-    const base = path.basename(fileRel);
-    return HIGH_ENTRIES.find((e) => { const s = declared(e.text); return s.includes(fileRel) || s.includes(base); }) || null;
-  };
-})();
 
 if (UPDATE) {
   fs.mkdirSync(path.dirname(LOCK_ABS), { recursive: true });
@@ -211,7 +148,7 @@ if (UPDATE) {
   console.log(`引擎基线已更新：${LOCK_REL}（受检面 ${Object.keys(lock.files).length} 个文件）`);
   if (changed.length) console.log(`  本次入账为改动件：${changed.length} 个`);
   if (removed.length) console.log(`  本次移除（文件已不在盘）：${removed.join(' ')}`);
-  console.log('  ⚠️ 基线更新本身是控制面改动：须与点名这些文件的 L2 入口文档同批提交（否则检查 C / 本门默认模式会拦）');
+  console.log('  ⚠️ 基线更新本身是控制面改动：须与该次演进的 CHANGELOG 记录同批提交（改基线 = 受检面内容变更，不入新基线即被本门拦）');
   process.exit(0);
 }
 
@@ -223,14 +160,10 @@ for (const rel of gateFiles()) current[rel] = { sha256: shaOf(path.join(ROOT, re
 // ---- 跨提交锚（先于本地基线判定：恶意分支把盘面 engine-lock.json 删掉也逃不掉这一层——参照物读自 git 对象库）----
 if (argOf('--against-ref')) {
   const ref = argOf('--against-ref');
-  // 两候选径都试（装户径 / 包源径）——纯包源仓的基线在 templates/_agents/ 下，锚须读得到
   let anchor = null;
-  for (const rel of LOCK_CANDIDATES) {
-    const r = spawnSync('git', ['-C', ROOT, 'show', `${ref}:${rel}`], { encoding: 'utf8', maxBuffer: 64 * 1024 * 1024 });
-    try { anchor = JSON.parse(String(r.stdout || '')); } catch { /* 该候选径在此 ref 无基线 → 试下一个 */ }
-    if (anchor && anchor.files) break;
-    anchor = null;
-  }
+  const r = spawnSync('git', ['-C', ROOT, 'show', `${ref}:${LOCK_REL}`], { encoding: 'utf8', maxBuffer: 64 * 1024 * 1024 });
+  try { anchor = JSON.parse(String(r.stdout || '')); } catch { /* 该 ref 无基线 */ }
+  if (!anchor || !anchor.files) anchor = null;
   if (!anchor) {
     if (!QUIET) console.log(`ℹ️  跨提交锚缺失（${ref} 无 ${LOCK_REL}）——该层跳过（首个入账提交/浅克隆）`);
   } else {
@@ -238,16 +171,13 @@ if (argOf('--against-ref')) {
       const got = current[rel];
       if (!got) { problems.push(`[门禁件消失（跨提交锚）] ${rel} 在 ${ref} 的基线内但盘面不存在——删除一道门等于禁用该检查`); continue; }
       if (typeof was.hard !== 'number' || got.hard >= was.hard) continue;
-      const e = entryDeclaresFile(rel);
-      if (!e) {
-        problems.push(`[硬拦面收缩（跨提交锚）] ${rel} 硬拦单位数 ${was.hard}（见 ${ref}）→ 盘面 ${got.hard}，减少 ${was.hard - got.hard}——祖先提交是参照物，本分支改不动它；确需退役该判据须有活跃 L2/L3 入口在**声明改动面**段落点名该文件（正文顺手提及不算——存量无关文档会替任意改弱行为背书）`);
-      }
+      problems.push(`[硬拦面收缩（跨提交锚）] ${rel} 硬拦单位数 ${was.hard}（见 ${ref}）→ 盘面 ${got.hard}，减少 ${was.hard - got.hard}——祖先提交是参照物，本分支改不动它。本门无声明式豁免出口（2026-10-13 移除：入口退路在本仓结构性不可达，详见文件头），收缩一律拦`);
     }
   }
 }
 
 if (!lock || !lock.files) {
-  if (!QUIET) console.log(`ℹ️ 引擎基线未启用（无 ${LOCK_REL}）——跑 node .agents/scripts/check-engine-integrity.mjs --update 生成（跨提交锚与外部副本锚照常执行）`);
+  if (!QUIET) console.log(`ℹ️ 引擎基线未启用（无 ${LOCK_REL}）——跑 node templates/_agents/scripts/check-engine-integrity.mjs --update 生成（跨提交锚与外部副本锚照常执行）`);
 } else {
   for (const [rel, want] of Object.entries(lock.files)) {
     const got = current[rel];
@@ -255,14 +185,13 @@ if (!lock || !lock.files) {
     if (!got) { problems.push(`[门禁件消失] ${rel} 在基线内但盘面不存在——删除一道门等于禁用该检查`); continue; }
     if (got.sha256 === want.sha256) continue;
     if (typeof want.hard === 'number' && got.hard < want.hard) {
-      problems.push(`[硬拦面收缩] ${rel} 硬拦单位数 ${want.hard} → ${got.hard}（减少 ${want.hard - got.hard}）——删 blocker/exit/判据行的结构性形态，无论是否声明均拦`);
+      problems.push(`[硬拦面收缩] ${rel} 硬拦单位数 ${want.hard} → ${got.hard}（减少 ${want.hard - got.hard}）——删 blocker/exit/判据行的结构性形态，一律拦`);
     } else {
-      const e = entryNamesFile(rel);
-      if (!e) problems.push(`[控制面改动无入口] ${rel} 内容与基线不符（${name} 硬拦单位数 ${want.hard} → ${got.hard}）——无活跃 L2/L3 入口正文点名该文件`);
+      problems.push(`[控制面改动未入基线] ${rel} 内容与基线不符（${name} 硬拦单位数 ${want.hard} → ${got.hard}）——门禁本体的每次演进都要显式更新基线，不存在「声明过的改动」自动放行`);
     }
   }
   for (const rel of Object.keys(current)) {
-    if (!lock.files[rel]) problems.push(`[门禁件未入基线] ${rel} 是新出现的受检文件——合法新增判据须跑 --update 并把基线更新与入口文档同批提交`);
+    if (!lock.files[rel]) problems.push(`[门禁件未入基线] ${rel} 是新出现的受检文件——合法新增判据须跑 --update 入账`);
   }
 }
 
@@ -280,8 +209,8 @@ if (argOf('--against')) {
 
 if (problems.length) {
   console.error(`引擎完整性 — HARD-BLOCK:\n\n${problems.map((p) => `- ${p}`).join('\n')}\n`);
-  console.error(`  修法：确属门禁演进 → 立 L2 入口（正文 §改动面 点名上述文件）+ 判据更新后跑 node .agents/scripts/check-engine-integrity.mjs --update，三者同批提交`);
-  console.error('  修法：非演进（误改/被他人改动）→ git diff 核对并回退，勿改基线绕过（基线本身在控制面清单内）');
+  console.error(`  修法：确属门禁演进 → 跑 node templates/_agents/scripts/check-engine-integrity.mjs --update 入账，并与 CHANGELOG 记录同批提交（提交评审即对质场；本门无声明式豁免出口，见文件头）`);
+  console.error('  修法：非演进（误改/被他人改动）→ git diff 核对并回退，勿改基线绕过（基线本身在控制面清单内，改它同样是受检面变更）');
   process.exit(1);
 }
 if (!QUIET) console.log(`✅ 引擎完整性：受检面 ${Object.keys(current).length} 个文件（硬拦面无收缩${lock && lock.files ? '、盘面与基线一致' : '、本地基线未启用'}）`);