@whyshu/argent-engine 0.0.0-stage → 0.6.0

package/engine/scripts/sync-scripts.sh

@@ -0,0 +1,445 @@
+#!/usr/bin/env bash
+# 把**投递面清单**里的每个面同步到安装克隆（~/.argent-dsh），并校验关键文件 sha 一致。
+# 面清单 = **唯一真源** `scripts/delivery-faces.txt`（2026-10-08 起；⛔ 本脚本不再自带面名单）：
+#   `scripts/`（引擎与工具）· `core/`（L1 内核）· `configs/`（配置目录：引擎级可配项声明，2026-10-09 加）
+#   · `skills/`（L0 技能资产，含归类判据 `skills/internal.json`）
+#   · `verticals/`（L0 业务线真源）· `deploy/`（部署/交付件：客户模板 + CI 模板 + MCP 部署件）。
+# 每个面都逐文件核对，缺一个面就不是"同步好了"。
+# 同一份清单也被 `scripts/deliver-customer.mjs` 读（第三件事：客户机/远端克隆）⇒ 加面只改那一个文件。
+#
+# 背景（2026-09-15 实测事故）：sync-plugins.sh **只同步 plugins**，克隆里的 scripts 会落后
+# ⇒ 角色按 SKILL 里的 ~/.argent-dsh/scripts/... 跑，用的是**旧脚本**（曾导致缺口检查静默失败、
+# 把缺字段的票误判为可派发）。
+#
+# ⚠️ 缺陷⑲（2026-09-23 夜，ml-fulfillment 发现并给出 md5/行数证据）：
+#   旧实现 `REPO="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"` —— **从脚本自身位置推仓库**。
+#   于是从**安装克隆**里跑这份脚本时 `REPO == CLONE` ⇒
+#     ① `rsync "$REPO/scripts/" "$CLONE/scripts/"` 变成**自我覆盖**（什么也没同步）；
+#     ② 随后的 sha 比对变成**自我比对** ⇒ 恒 ✅「已与仓库一致」——**假绿**；
+#     ③ `KEY` 清单里**没有 `orchestrator.py`**，而落后最多的正是编排器。
+#   最坏后果：**"修复没生效"被误判成"修复无效"**（当晚角色差点据此下错结论）。
+#
+# 现在的口径（宁可红，不要假绿）：
+#   1. `REPO` 只认 `ARGENT_DSH_REPO`（缺省 `~/Code/argent-dsh`），**不再**从 BASH_SOURCE 推；
+#   2. 若本脚本不在 `$REPO/scripts/` 里（即跑的是克隆/profile 副本）⇒ **转交**仓库那份执行
+#      （保持 SKILL/交接协议里既有调用方式可用，同时得到真实同步）；
+#   3. 仓库不存在 ⇒ 响亮失败（exit 2），绝不打印绿字；
+#   4. `KEY` 补上编排器与查询器：`orchestrator.py` / `query_runner.py` / `flow_policy.py` / `flow_retry.py`。
+#
+# ⚠️ 缺陷⑳（2026-10-02 确认）：本脚本只覆盖 `scripts/` 与 `verticals/`，**全文 0 处 `core/`**。
+#   而 `core/` 是 **L1 执行内核的运行时资产**，会被插件/CLI/MCP **从克隆里解析**：
+#     · 插件（argent-core/skin/ml/flow/gateway）运行时按 `../../../core/lib/argent-datadir.mjs`
+#       相对 import，候选路径里就有 `~/.argent-dsh`、`~/Code/argent-dsh`（见 plugins/argent-*/src/index.js）；
+#     · `core/lib/argent-datadir.mjs` 是数据目录的**唯一判据**（2026-10-02 新增）⇒ 克隆里缺它，
+#       插件就 `DATA_DIR=''`：只读退化、写入 fail-closed（core/lib/argent-datadir.mjs:156 的处置口径）；
+#     · `core/cli/argent.mjs`、`core/mcp/server.mjs`、`core/lib/license-file.mjs` 同理（CLI/MCP/许可）。
+#   本机克隆因**走过 git** 与仓库 0 差异 ⇒ 立刻复现不了；但"只走 sync 的机器"（不 git pull 的形态）
+#   拿不到这些文件 ⇒ 要么 fail-closed、要么直接崩。修法：两处 rsync 都补 `core/`，并**逐文件核对**。
+#
+# ⚠️ 缺陷㉑（2026-10-02 实测，写缺陷⑳ 的纯夹具测试时踩到）：`REPO` 是**字符串**而 `SELF_DIR`/`CLONE`
+#   走 `pwd -P`（物理路径）⇒ 路径里含软链（macOS `/tmp`→`/private/tmp`）时两边**永不相等**：
+#   ① `SELF_DIR != $REPO/scripts` 恒真 ⇒ **无限 exec 自我转交**（实测 6 秒 491 次、纯 CPU 空转）；
+#   ② 反向组合会让 `REPO == CLONE` 守卫被**绕过** ⇒ 缺陷⑲ 的自我覆盖式假绿复活。
+#   修法：REPO 归一成物理路径 + 转交加 `ARGENT_SYNC_SCRIPTS_TAKEOVER` 标记（转交过就不再转交，响亮失败）。
+#
+# ⚠️ 缺口㉓（2026-10-04）：本脚本此前只投递 `scripts/` + `verticals/` + `core/`，**没有 `skills/`**。
+#   而 `skills/` 是 **L0 业务资产**，其中两处是**运行期真源**：
+#     · `skills/internal.json` —— 升级器 `scripts/argent-upgrade.mjs` 用它做**归类判据**（内部角色技能不外发）；
+#     · `skills/<name>/SKILL.md`（+ 各技能的 `references/`、`scripts/`、模板）—— 角色按 SKILL 干活，
+#       缺一件就是"角色照着半份 SOP 干"（与缺 core/ 的形态同源：**看起来正常**）。
+#   只走 sync（git 拉不动）的机器：外发集仍能从 `verticals/` 正确推导（故不会误发内部技能），
+#   但**归类门禁退化**（读不到 internal.json ⇒ 内部/未归类判据失效）。故 `skills/` 与 `core/` 同待遇：
+#   两条 rsync 路径都投递 + 逐文件 sha 核对 + 结论必须一眼可见（数不到文件 ⇒ 红，绝不假绿）。
+#
+# ⚠️ 缺口㉔（2026-10-08，本批收口）：本脚本此前五个面里**独缺 `deploy/`** —— 于是 `deploy/ci/*`
+#   （CI 部署件模板）在只走 sync 的机器上**永远拿不到**，而 `deploy/` 下另有两类是**真被读**的资产：
+#     · `deploy/customer/roles.spec.json` —— **客户模板**，`scripts/check-role-mapping.mjs:66`（第 ⑥ 项
+#       技能声明面）与 `scripts/customer-config-migrate.mjs` 都按 `REPO/deploy/customer/roles.spec.json` 读；
+#       客户机上跑的是 `~/.argent-dsh/scripts/check-role-mapping.mjs` ⇒ `REPO` = **克隆** ⇒
+#       克隆里缺这份模板时，第 ⑥ 项**静默少查一个声明面**（模板错名会批量复制到每台客户机，正是它要拦的）。
+#     · `deploy/mcp/*`、`deploy/ci/*` —— MCP 部署件与自建 CI 的 plist/README（**模板/文档，默认不安装**）。
+#   实测形态（2026-10-08 对账）：`deploy/customer`、`deploy/mcp` 因历史原因**已在**克隆里，只有
+#   `deploy/ci/` 的 2 个文件缺 —— 这种"半在场"最难发现（对账要么全查、要么看不出来）。
+#   故 `deploy/` 与 `core/`、`skills/` **同待遇**：两条 rsync 路径都投递 + 点名核对 + 逐文件 sha 核对
+#   + 计数与结论一眼可见（仓库缺 `deploy/` 或数不到文件 ⇒ 红）。
+#   ⛔ 投递面不冲突（已核）：`deploy/` 只经**本脚本**进**安装克隆** `~/.argent-dsh`；
+#   `scripts/release-argent.sh` 投的是**下载服务器** `${SSH_HOST}:${DL_DIR}`，面 = `install-argent.mjs`
+#   /`install-dsh.sh`/`install.ps1`（`--full` 再带 `skills/`、`plugins/`）—— **全文 0 处 `deploy/`**，
+#   两者目标机与用途都不同 ⇒ 无需改 release-argent.sh（取最小方案）。
+#   `deploy/` 是**部署/交付资产**（模板与文档，非运行期代码）⇒ **不进 `CORE_KEY`、不进 `pack.engine`**
+#   （与 `skills/` 同理：那两个面是"引擎件"的面）。
+#
+# ⚠️ 缺口㉒（2026-10-03）：本脚本的 rsync **不带 `--delete`** ⇒ 仓库里**删掉**的文件会**永远留在克隆**里
+#   （实测：克隆 scripts/ 曾多出 9 个仓库已删的旧脚本；这类残留此前**无人可见**）。
+#   残留会让"克隆里有什么"与"仓库里有什么"对不上账。口径：**只报告，不清理** ——
+#   克隆里可能还有带外资产（本机专用、不该被同步覆盖），自动删是危险的；
+#   也**不能判红**（仓库删一个文件就红一次 ⇒ 恒红陷阱，清理动作不在本脚本职责内）。
+#   故收尾只打印「克隆多出 N 个非仓库文件 + 前若干条路径」，**exit 仍为 0**。
+#
+# 用法：bash scripts/sync-scripts.sh [--no-pull]
+#       ARGENT_DSH_REPO=/path/to/argent-dsh bash scripts/sync-scripts.sh
+set -euo pipefail
+
+SELF_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)"
+REPO="${ARGENT_DSH_REPO:-$HOME/Code/argent-dsh}"
+CLONE="${ARGENT_DISH_HOME:-$HOME/.argent-dsh}"
+# 物理路径归一（缺陷㉑，2026-10-02 实测）：`SELF_DIR` 与 `CLONE` 都用 `pwd -P`（**物理**路径），
+# 而 `REPO` 是字符串 ⇒ 只要 `ARGENT_DSH_REPO`/`$HOME` 里含**软链**（macOS `/tmp`→`/private/tmp`、
+# `/var`→`/private/var`，或仓库放在软链后面），两边就**永不相等**：
+#   ① `SELF_DIR != $REPO/scripts` 恒真 ⇒ 无限 `exec` 自我转交（实测 6 秒 491 次，纯 CPU 空转）；
+#   ② 反向的软链组合会让 `REPO == CLONE` 守卫**被绕过** ⇒ 又变回缺陷⑲ 的自我覆盖式假绿。
+# 故 REPO 先归一成物理路径；REPO 不存在时保持原样，让下面"仓库不存在"的分支响亮失败。
+REPO_P="$(cd "$REPO" 2>/dev/null && pwd -P || true)"
+[ -n "$REPO_P" ] && REPO="$REPO_P"
+KEY=(flow_case.py flow_source.py flow_triage.py flow_claim.py flow_config.py flow_failure.py
+     flow_ledger.py ml_schema_check.py flow-requirements.json flow-trigger.sh flow-trigger-wake.mjs
+     daily-report-inbox.py orchestrator.py query_runner.py flow_policy.py flow_retry.py
+     # 日报 OAuth 向导（2026-09-24 修了"管道输入静默失败" + 加非交互/防串店校验）：
+     # 客户机文档让跑 `node ~/.argent-dsh/scripts/ml-oauth-setup.mjs` ⇒ 修复必须同步到克隆，
+     # 否则客户机仍在用会静默烧授权码的旧版。
+     # 注：2026-09-27 起日报与 lip 表解耦 ⇒ 曾短暂加入的 sku-names.mjs 已删除、不再同步。
+     ml-oauth-setup.mjs
+     # ── P3 技能打包与归类门禁（2026-10-03）────────────────────────────────────
+     # 归类判据（G1–G8）与安装器都必须在克隆里**同时**存在：只同步安装器会让它 import 不到门禁
+     # （`import { classify } from './check-skill-classification.mjs'`）⇒ 装机时直接崩。
+     skill-install.mjs check-skill-classification.mjs
+     # ── 入口守卫的唯一实现（2026-10-04）────────────────────────────────────────
+     # `scripts/lib/is-direct-run.mjs` 被 10 个 CLI import（升级器/安装器/各 check-*/日报/回写/卡片）
+     # ⇒ 克隆里缺它 = 那 10 个脚本**当场 import 崩**（不是静默降级）。它同时进 `pack.engine`
+     # （能力包面）—— 两个投递面同批登记，漂移由 sync-scripts-core.test.mjs 的 KEY 段守住。
+     lib/is-direct-run.mjs
+     # ── 干净机器一条命令（D1，2026-10-05）──────────────────────────────────────
+     # `install-one-shot.mjs` = D1 的**编排入口**（precheck→install→skills→license→verify）；
+     # 它调 `install-license.mjs`（许可安装的唯一实现）与 `install-argent.mjs`（装配的唯一实现，
+     # 按 `--from-packs` 走离线面）。三者任一缺席 ⇒ 克隆/包装机上"一条命令"直接不可用
+     # （不是静默降级）。三个文件同时进 `pack.engine`（能力包面）。
+     install-one-shot.mjs install-license.mjs
+     # `migrate-providers.mjs` 由安装器第 6 步（provider 迁移）子进程调用 ⇒ 它是
+     # `install-argent.mjs` 的**运行期依赖**（install-argent.mjs 进包后由 check-pack-closure
+     # 按实际引用推导出来）。克隆里缺它 ⇒ 每次装配都打"provider 迁移脚本未跑成"的警告
+     # （静默半成品：装完 provider 没配好）。两处投递面同批登记。
+     # 2026-10-08（本批收口）：**投递工具自身**也进点名核对 —— `deliver-customer.mjs`（第三件事：
+     # 往客户机/远端克隆投递）与它的面清单唯一真源 `delivery-faces.txt`。理由：从**克隆**发起投递
+     # 是合法用法（角色按 SKILL 调 ~/.argent-dsh/scripts/...），克隆里缺/旧这两件 ⇒ 用**旧面清单**
+     # 投递（正是"加目录忘了进面"的形态），而且不会报错。它们既不进 `CORE_KEY` 也不进 `pack.engine`
+     # （不是内核运行期件，也不是能力包件：投递工具只在本机/运维侧跑）。
+     deliver-customer.mjs delivery-faces.txt)
+
+if [ "$SELF_DIR" != "$REPO/scripts" ]; then
+  # 跑的不是仓库那份（典型：角色按 SKILL 调 ~/.argent-dsh/scripts/sync-scripts.sh）
+  if [ "${ARGENT_SYNC_SCRIPTS_TAKEOVER:-}" = "1" ]; then
+    # 防无限 exec 循环（缺陷㉑ 的兜底）：转交过一次仍判定为"非仓库副本"⇒ 说明路径比对本身有问题，
+    # 此时再 exec 就是纯 CPU 空转 ⇒ 宁可响亮失败。
+    echo "  ✗ 转交后仍是非仓库副本（${SELF_DIR} ≠ $REPO/scripts）⇒ 拒绝再次转交（防无限 exec 循环）。" >&2
+    exit 2
+  fi
+  if [ -f "$REPO/scripts/sync-scripts.sh" ]; then
+    echo "  ▸ 检测到从非仓库副本调用（${SELF_DIR}）⇒ 转交仓库那份执行（避免自我覆盖式假绿，缺陷⑲）"
+    ARGENT_SYNC_SCRIPTS_TAKEOVER=1 exec bash "$REPO/scripts/sync-scripts.sh" "$@"
+  fi
+  echo "  ✗ 仓库不存在或缺 scripts/：$REPO" >&2
+  echo "    设定 ARGENT_DSH_REPO=<仓库路径> 后重试（缺省 ~/Code/argent-dsh）。" >&2
+  echo "    **不会**回退到「就地自我同步」——那正是缺陷⑲ 的假绿来源。" >&2
+  exit 2
+fi
+
+if [ ! -d "$CLONE" ]; then echo "  ✗ 安装克隆不存在: $CLONE"; exit 1; fi
+if [ "$(cd "$CLONE" && pwd -P)" = "$REPO" ]; then
+  echo "  ✗ REPO == CLONE（${REPO}）：同步源与目标是同一棵树 ⇒ 拒绝执行（缺陷⑲ 假绿）。" >&2
+  echo "    请把 ARGENT_DISH_HOME 指向真正的安装克隆，或从仓库目录运行。" >&2
+  exit 2
+fi
+
+# ── 投递面清单 = **唯一真源** `scripts/delivery-faces.txt`（2026-10-08 起）─────────────────
+# 为什么抽成文件：面清单此前**散在本脚本里**，加一个面要同时改两处 rsync +（可选）核对段 ⇒
+# "加目录忘了进面"踩了三次，且每次都表现为**脚本看起来正常、克隆拿不到**：
+#   缺口⑳ `core/`（2026-10-02，L1 内核资产 ⇒ 插件 DATA_DIR='' 只读退化）、
+#   缺口㉓ `skills/`（2026-10-04，L0 技能资产 ⇒ 归类判据 internal.json 拿不到）、
+#   缺口㉔ `deploy/`（2026-10-08，客户模板被 check-role-mapping 第 ⑥ 项真读）。
+# 现在**同一份清单**被两个投递口读：本脚本（第一件事：本机安装克隆）与
+# `scripts/deliver-customer.mjs`（第三件事：客户机/远端克隆）。⛔ 不许在本脚本里再抄一份面名单。
+# 读不到/读空 ⇒ **响亮失败**（"面为空也算同步成功"正是缺陷⑲ 那类假绿的形态）；
+# 清单里的每个面都必须被投递 ⇒ 用循环而不是手写 N 行（新增面自动进投递，不会漏）。
+FACES_FILE="$REPO/scripts/delivery-faces.txt"
+FACES=()
+read_faces() {
+  local line
+  [ -f "$FACES_FILE" ] || return 1
+  while IFS= read -r line || [ -n "$line" ]; do
+    line="${line%%#*}"                 # 行尾注释（清单文件里用来写"为什么这个面在面内"）
+    line="${line//[[:space:]]/}"       # 去空白/制表（含全角缩进误入的情况）
+    [ -n "$line" ] || continue
+    FACES+=("$line")
+  done < "$FACES_FILE"
+  [ "${#FACES[@]}" -gt 0 ]
+}
+# 逐面投递（顺序 = 清单顺序）。语义与手写 N 行完全一致：`rsync -a --quiet`，**无 `--delete`**（缺口㉒）。
+deliver_faces() {
+  local face
+  for face in "${FACES[@]}"; do
+    # 面清单声明了但仓库里没有 ⇒ **响亮失败**（此前直接 rsync 会以 23「partial transfer」退出，
+    # 报错信息与「面配错」毫无关系 —— 2026-10-10 加 agents/presets 面时测试就是这么红的）。
+    if [ ! -d "$REPO/$face" ]; then
+      echo "  ✗ 面不存在（清单声明了但仓库里没有）：$face" >&2
+      echo "    ⛔ 面清单是唯一真源（scripts/delivery-faces.txt）；面不存在 ⇒ 不投递、立即退出" >&2
+      exit 2
+    fi
+    rsync -a --quiet "$REPO/$face/" "$CLONE/$face/"
+  done
+}
+
+# ── 根文件（**面清单之外**，但运行时真读）──────────────────────────────────────
+# ⚠️ 缺口㉖（2026-10-10，**第五次同形态**）：A 批新增了仓库**根**资产 ——
+#   · `agents/`（智能体目录，安装器 `loadCatalog()` 真读）—— 已随面清单修复（进 `agents` 面）；
+#   · **根 `VERSION`**：`core/cli/argent.mjs` 用 `readFileSync(script('VERSION'))` 读它 ⇒ 克隆里
+#     停在旧值（实测 0.4.0 的仓库 vs 克隆仍 `0.3.0`），`argent version` 与"检查更新"据此判版本。
+#   面清单只支持**目录**（两处 rsync 都是 `"$REPO/$face/"` 目录语义）⇒ 根文件单独一段，
+#   与面**同待遇**：投递 + 双端 sha 核对（数不到文件即红，绝不假绿）。
+# ⚠️ `install-argent.mjs` 同族（2026-10-10 实测）：克隆里它是**旧版**（仓库 ff4069d6 vs 克隆
+#   618f4bbd）⇒ 克隆侧跑 `--agent hr` 报「未知参数: hr」（新 flag 根本不存在）。
+#   它此前只靠 `argent-upgrade.mjs` 自举更新（滞后窗口 = 客户机装到旧安装器的风险）⇒ 一并进根文件清单。
+ROOT_FILES=(VERSION install-argent.mjs)
+deliver_root_files() {
+  local f
+  for f in "${ROOT_FILES[@]}"; do
+    [ -f "$REPO/$f" ] || continue
+    rsync -a --quiet "$REPO/$f" "$CLONE/$f"
+  done
+}
+if ! read_faces; then
+  echo "  ✗ 投递面清单读不到或为空：$FACES_FILE" >&2
+  echo "    面清单是**唯一真源**（scripts/delivery-faces.txt，一行一个面）——缺它就无法知道该投哪几个面。" >&2
+  echo "    **不会**退化成本脚本里另抄一份面名单：那正是「加目录忘了进面」的复发路径。" >&2
+  exit 2
+fi
+
+if [ "${1:-}" != "--no-pull" ] && [ -d "$CLONE/.git" ]; then
+  echo "  ▸ git -C $CLONE pull --ff-only"
+  if ! git -C "$CLONE" pull --ff-only >/tmp/sync-scripts-pull.log 2>&1; then
+    echo "  ⚠️ pull 失败（可能有本地改动/未跟踪文件），改用 rsync 覆盖投递面"
+    tail -3 /tmp/sync-scripts-pull.log | sed 's/^/     /'
+    # 业务线真源也要同步（2026-09-29 实测事故）：只同步 scripts/ 会让克隆缺 verticals/，
+    # 于是任何"读仓库知识"的脚本（如 scripts/argent-catalog.mjs、host 的目录路由）在克隆里
+    # **少读一半数据却看起来正常**（业务线 0 条）。克隆是客户机形态的落地处 ⇒ 必须完整。
+    # ⚠️ 本分支此前**只投 5 个面里的 4 个**（漏 verticals/）；改用循环后两条 rsync 路径的面集**一致**。
+    deliver_faces
+    deliver_root_files
+  fi
+fi
+# 兜底：确保各面与仓库一致（pull 未覆盖到的情况）
+deliver_faces
+deliver_root_files
+
+fail=0
+for f in "${KEY[@]}"; do
+  a=$(shasum -a 256 "$REPO/scripts/$f" 2>/dev/null | cut -c1-12 || true)
+  b=$(shasum -a 256 "$CLONE/scripts/$f" 2>/dev/null | cut -c1-12 || true)
+  if [ -n "$a" ] && [ "$a" = "$b" ]; then printf "  ✅ %-24s %s\n" "$f" "$a"
+  else printf "  ✗ %-24s 仓库=%s 克隆=%s\n" "$f" "${a:-无}" "${b:-无}"; fail=1; fi
+done
+
+# ── core/ 一致性（缺陷⑳）：KEY 清单的语义是「`scripts/` 下的文件名」（循环里硬拼 `$REPO/scripts/`），
+# 所以**不硬塞** `core/…`；改为对 `core/` 单独做「存在 + 与仓库逐文件 sha 一致」核对，结论必须一眼可见。
+# P1 第三批（2026-10-03）：CLI 新增五个 verb 的实现模块全部落在 `core/lib/` ——
+#   `notify`（P2 通知端口）/`init`/`versions`/`audit`/`flow list` 的实现都在这里。
+# 2026-10-04（§8-③ 一次性激活码）：+`core/lib/license-activate.mjs`（CLI `license activate` 的实现；
+#   与 `scripts/flow-requirements.json#pack.engine` 的 core 段**逐项相同**，漂移由 sync-scripts-core.test.mjs 判红）。
+# 2026-10-04（O2 只读运营视图）：+`core/lib/license-ops.mjs`（CLI `license ops` 的实现：只读运营巡检，
+#   替代 `mongosh`；同样两处清单逐项一致）。
+# P4 批（2026-10-03）：清单扩到 **core 运行期全集**（CLI 入口 + MCP 面 + `core/lib/**` 运行期闭包
+#   + 运行期读的两个契约 JSON）—— 与 `scripts/flow-requirements.json#pack.engine` 的 core 段
+#   **逐项相同**（同一批运行期文件、两个投递面：能力包 / sync）；
+#   两处清单不许各写一份，漂移由 `scripts/tests/sync-scripts-core.test.mjs` 判红。
+#   它们由上面的 `rsync core/` 整体投递（并逐文件核对），本清单只是**点名核对**：
+#   少一个，克隆上的 `argent <verb>` 就是"未知 verb"/import 崩，或 MCP 面起不来（不是静默降级）。
+CORE_KEY=(core/cli/argent.mjs core/mcp/server.mjs core/mcp/http.mjs
+  core/contracts/argent.contracts.json core/contracts/verbs.schema.json
+  core/lib/argent-datadir.mjs core/lib/flow-registry.mjs core/lib/claim.mjs core/lib/ledger.mjs
+  core/lib/python.mjs core/lib/sop.mjs core/lib/audit.mjs core/lib/versions.mjs core/lib/flow-list.mjs
+  core/lib/init.mjs core/lib/doctor-customer.mjs core/lib/license.mjs core/lib/license-file.mjs core/lib/license-verdict.mjs
+  core/lib/license-device.mjs core/lib/license-guard.mjs core/lib/license-activate.mjs core/lib/license-ops.mjs
+  core/lib/notify/index.mjs core/lib/notify/verb.mjs core/lib/notify/dedup.mjs core/lib/notify/webhook.mjs
+  core/lib/notify/feishu.mjs core/lib/notify/wecom.mjs
+  core/lib/config-catalog.mjs)
+# 2026-10-09（配置地基）：+`core/lib/config-catalog.mjs`（配置面的**唯一**读取器；与
+#   `scripts/flow-requirements.json#pack.engine` 的 core 段**逐项相同**，漂移由 sync-scripts-core.test.mjs 判红）。
+#   ⚠️ 它读的 `configs/*.json` **不在 core 段**（不是 core/ 下的文件）⇒ 由下面的 `configs/` 段单独核对。
+for f in "${CORE_KEY[@]}"; do
+  a=$(shasum -a 256 "$REPO/$f" 2>/dev/null | cut -c1-12 || true)
+  b=$(shasum -a 256 "$CLONE/$f" 2>/dev/null | cut -c1-12 || true)
+  if [ -n "$a" ] && [ "$a" = "$b" ]; then printf "  ✅ %-34s %s\n" "$f" "$a"
+  else printf "  ✗ %-34s 仓库=%s 克隆=%s\n" "$f" "${a:-无}" "${b:-无}"; fail=1; fi
+done
+core_n=0; core_bad=0; core_list=""
+while IFS= read -r rel; do
+  [ -n "$rel" ] || continue
+  core_n=$((core_n + 1))
+  a=$(shasum -a 256 "$REPO/$rel" 2>/dev/null | cut -c1-12 || true)
+  b=$(shasum -a 256 "$CLONE/$rel" 2>/dev/null | cut -c1-12 || true)
+  if [ -n "$a" ] && [ "$a" = "$b" ]; then continue; fi
+  core_bad=$((core_bad + 1)); core_list="$core_list $rel"
+done < <(cd "$REPO" && find core -type f ! -name '.DS_Store' | LC_ALL=C sort)
+if [ ! -d "$REPO/core" ]; then
+  printf "  ✗ 仓库缺 core/：%s/core（内核资产缺失 ⇒ 克隆不可能正确）\n" "$REPO"; fail=1
+elif [ "$core_n" -eq 0 ]; then
+  # 防假绿：数不到文件时**绝不能**打印"一致"（0/0 也算通过是这类自检最常见的翻车方式）
+  printf "  ✗ 仓库 core/ 下数不到任何文件：%s/core\n" "$REPO"; fail=1
+elif [ "$core_bad" -eq 0 ]; then
+  printf "  ✅ core: %d 个文件与仓库一致（%s/core；源=%s）\n" "$core_n" "$CLONE" "$REPO"
+else
+  printf "  ✗ core: %d/%d 个文件与仓库不一致：%s\n" "$core_bad" "$core_n" "$core_list"
+  fail=1
+fi
+
+# ── skills/ 一致性（缺口㉓，2026-10-04）：与 core/ **同待遇** —— 点名核对 + 逐文件 sha + 结论一眼可见。
+#   点名清单（`SKILLS_KEY`）的语义：`skills/internal.json`（升级器的**归类判据**，运行期真源）
+#   + `skills/<name>/SKILL.md`（每个技能的入口文件；`fix-skill-frontmatter.py` 的硬约束都在它上面）。
+#   ⚠️ SKILL.md **由 `find` 动态枚举**，不手抄清单：① 手抄必然腐烂（新增技能要记得改脚本）；
+#      ② 技能名是**业务词**，写进 `scripts/` 会被 `scripts/vertical-lint.mjs` 的 engine-words 门禁判红
+#      （2026-10-04 实测踩到）——引擎文件不该出现业务线名字。
+#   整树（`references/`、`scripts/`、模板…）由下面的 `find skills` 逐文件核对覆盖 —— 本清单只是点名。
+#   ⚠️ 本清单**不进** `CORE_KEY`、也**不进** `pack.engine`：`skills/` 是 **L0 业务资产**，不是引擎件
+#   （`sync-scripts-core.test.mjs`【0】只比对两处清单的 `core/` 段，本清单由该测试的 skills 段守）。
+SKILLS_KEY=(skills/internal.json)
+while IFS= read -r rel; do
+  [ -n "$rel" ] || continue
+  SKILLS_KEY+=("$rel")
+done < <(cd "$REPO" && find skills -mindepth 2 -maxdepth 2 -name 'SKILL.md' | LC_ALL=C sort)
+for f in "${SKILLS_KEY[@]}"; do
+  a=$(shasum -a 256 "$REPO/$f" 2>/dev/null | cut -c1-12 || true)
+  b=$(shasum -a 256 "$CLONE/$f" 2>/dev/null | cut -c1-12 || true)
+  if [ -n "$a" ] && [ "$a" = "$b" ]; then printf "  ✅ %-42s %s\n" "$f" "$a"
+  else printf "  ✗ %-42s 仓库=%s 克隆=%s\n" "$f" "${a:-无}" "${b:-无}"; fail=1; fi
+done
+# 防假绿：连一个技能入口都没数到 ⇒ 点名核对等于没做（skills/ 只剩余件时**不能**算通过）
+if [ "${#SKILLS_KEY[@]}" -le 1 ]; then
+  printf "  ✗ 仓库 skills/ 下一个 skills/<name>/SKILL.md 都没数到：%s/skills（点名核对落空）\n" "$REPO"; fail=1
+fi
+skills_n=0; skills_bad=0; skills_list=""
+while IFS= read -r rel; do
+  [ -n "$rel" ] || continue
+  skills_n=$((skills_n + 1))
+  a=$(shasum -a 256 "$REPO/$rel" 2>/dev/null | cut -c1-12 || true)
+  b=$(shasum -a 256 "$CLONE/$rel" 2>/dev/null | cut -c1-12 || true)
+  if [ -n "$a" ] && [ "$a" = "$b" ]; then continue; fi
+  skills_bad=$((skills_bad + 1)); skills_list="$skills_list $rel"
+done < <(cd "$REPO" && find skills -type f ! -name '.DS_Store' | LC_ALL=C sort)
+if [ ! -d "$REPO/skills" ]; then
+  printf "  ✗ 仓库缺 skills/：%s/skills（L0 技能资产缺失 ⇒ 克隆不可能正确）\n" "$REPO"; fail=1
+elif [ "$skills_n" -eq 0 ]; then
+  # 防假绿：数不到文件时**绝不能**打印"一致"（0/0 也算通过是这类自检最常见的翻车方式）
+  printf "  ✗ 仓库 skills/ 下数不到任何文件：%s/skills\n" "$REPO"; fail=1
+elif [ "$skills_bad" -eq 0 ]; then
+  printf "  ✅ skills: %d 个文件与仓库一致（%s/skills；源=%s）\n" "$skills_n" "${CLONE}" "${REPO}"
+else
+  printf "  ✗ skills: %d/%d 个文件与仓库不一致：%s\n" "$skills_bad" "$skills_n" "$skills_list"
+  fail=1
+fi
+
+# ── deploy/ 一致性（缺口㉔，2026-10-08）：与 core/、skills/ **同待遇** —— 点名核对 + 逐文件 sha + 结论一眼可见。
+#   点名清单（`DEPLOY_KEY`）的语义：`deploy/` 下**会被运行期读**的那一件 ——
+#   `deploy/customer/roles.spec.json`（客户模板：`check-role-mapping.mjs` 第 ⑥ 项的声明面之一，
+#   也是 `customer-config-migrate.mjs` 的并入源）。其余（CI 模板 / MCP 部署件 / README）是**模板与文档，
+#   默认不安装**，由下面的 `find deploy` 逐文件核对覆盖 —— 本清单只是点名。
+#   ⚠️ 本清单**不进** `CORE_KEY`、也**不进** `pack.engine`：`deploy/` 是部署/交付资产，不是引擎件
+#   （`sync-scripts-core.test.mjs`【0】只比对两处清单的 `core/` 段，本清单由该测试的 deploy 段守）。
+DEPLOY_KEY=(deploy/customer/roles.spec.json)
+for f in "${DEPLOY_KEY[@]}"; do
+  a=$(shasum -a 256 "$REPO/$f" 2>/dev/null | cut -c1-12 || true)
+  b=$(shasum -a 256 "$CLONE/$f" 2>/dev/null | cut -c1-12 || true)
+  if [ -n "$a" ] && [ "$a" = "$b" ]; then printf "  ✅ %-42s %s\n" "$f" "$a"
+  else printf "  ✗ %-42s 仓库=%s 克隆=%s\n" "$f" "${a:-无}" "${b:-无}"; fail=1; fi
+done
+deploy_n=0; deploy_bad=0; deploy_list=""
+while IFS= read -r rel; do
+  [ -n "$rel" ] || continue
+  deploy_n=$((deploy_n + 1))
+  a=$(shasum -a 256 "$REPO/$rel" 2>/dev/null | cut -c1-12 || true)
+  b=$(shasum -a 256 "$CLONE/$rel" 2>/dev/null | cut -c1-12 || true)
+  if [ -n "$a" ] && [ "$a" = "$b" ]; then continue; fi
+  deploy_bad=$((deploy_bad + 1)); deploy_list="$deploy_list $rel"
+done < <(cd "$REPO" && find deploy -type f ! -name '.DS_Store' | LC_ALL=C sort)
+if [ ! -d "$REPO/deploy" ]; then
+  printf "  ✗ 仓库缺 deploy/：%s/deploy（部署/交付件缺失 ⇒ 克隆上的客户模板与 CI 模板不可能正确）\n" "$REPO"; fail=1
+elif [ "$deploy_n" -eq 0 ]; then
+  # 防假绿：数不到文件时**绝不能**打印"一致"（0/0 也算通过是这类自检最常见的翻车方式）
+  printf "  ✗ 仓库 deploy/ 下数不到任何文件：%s/deploy\n" "$REPO"; fail=1
+elif [ "$deploy_bad" -eq 0 ]; then
+  printf "  ✅ deploy: %d 个文件与仓库一致（%s/deploy；源=%s）\n" "$deploy_n" "${CLONE}" "${REPO}"
+else
+  printf "  ✗ deploy: %d/%d 个文件与仓库不一致：%s\n" "$deploy_bad" "$deploy_n" "$deploy_list"
+  fail=1
+fi
+
+# ── configs/ 一致性（缺口㉕，2026-10-09）：与 core/、skills/、deploy/ **同待遇** —— 逐文件 sha + 计数一眼可见。
+#   为什么加它：`configs/` 是**配置目录**（引擎级可配项声明），`core/lib/config-catalog.mjs` 从
+#   `<根>/configs/*.json` 读它；业务线级那份在 `verticals/<id>/config.json`（随 verticals/ 面走）。
+#   ⚠️ 点名清单**动态枚举**（`find configs -maxdepth 1 -name '*.json'`），⛔ 不手抄：
+#      ① 手抄必然腐烂（加一个域文件要记得改脚本）；② "加声明即生效"是这一层的**设计目标**
+#      （门禁 ④ 的机器判据）—— 手抄清单会把这个目标当场作废。
+#   语义：整个 `configs/` 由 `find configs -type f` 逐文件核对覆盖，点名只是"至少要数到文件"。
+#   ⚠️ 克隆里读不到 ⇒ **不是报错而是静默半残**（读取器把空目录当"没有可配项"）⇒ 这里必须响亮。
+CONFIGS_KEY=()
+while IFS= read -r rel; do
+  [ -n "$rel" ] || continue
+  CONFIGS_KEY+=("$rel")
+done < <(cd "$REPO" && find configs -maxdepth 1 -name '*.json' | LC_ALL=C sort)
+for f in ${CONFIGS_KEY[@]+"${CONFIGS_KEY[@]}"}; do
+  a=$(shasum -a 256 "$REPO/$f" 2>/dev/null | cut -c1-12 || true)
+  b=$(shasum -a 256 "$CLONE/$f" 2>/dev/null | cut -c1-12 || true)
+  if [ -n "$a" ] && [ "$a" = "$b" ]; then printf "  ✅ %-42s %s\n" "$f" "$a"
+  else printf "  ✗ %-42s 仓库=%s 克隆=%s\n" "$f" "${a:-无}" "${b:-无}"; fail=1; fi
+done
+configs_n=0; configs_bad=0; configs_list=""
+while IFS= read -r rel; do
+  [ -n "$rel" ] || continue
+  configs_n=$((configs_n + 1))
+  a=$(shasum -a 256 "$REPO/$rel" 2>/dev/null | cut -c1-12 || true)
+  b=$(shasum -a 256 "$CLONE/$rel" 2>/dev/null | cut -c1-12 || true)
+  if [ -n "$a" ] && [ "$a" = "$b" ]; then continue; fi
+  configs_bad=$((configs_bad + 1)); configs_list="$configs_list $rel"
+done < <(cd "$REPO" && find configs -type f ! -name '.DS_Store' | LC_ALL=C sort)
+if [ ! -d "$REPO/configs" ]; then
+  printf "  ✗ 仓库缺 configs/：%s/configs（配置目录缺失 ⇒ 克隆上可配项整体消失，且不报错）\n" "$REPO"; fail=1
+elif [ "$configs_n" -eq 0 ]; then
+  # 防假绿：数不到文件时**绝不能**打印"一致"（0/0 也算通过是这类自检最常见的翻车方式）
+  printf "  ✗ 仓库 configs/ 下数不到任何文件：%s/configs\n" "$REPO"; fail=1
+elif [ "${#CONFIGS_KEY[@]}" -eq 0 ]; then
+  printf "  ✗ configs/ 下一个 *.json 都没点名到（点名核对落空）\n"; fail=1
+elif [ "$configs_bad" -eq 0 ]; then
+  printf "  ✅ configs: %d 个文件与仓库一致（%s/configs；源=%s）\n" "$configs_n" "$CLONE" "$REPO"
+else
+  printf "  ✗ configs: %d/%d 个文件与仓库不一致：%s\n" "$configs_bad" "$configs_n" "$configs_list"
+  fail=1
+fi
+
+# ── 只读报告（缺口㉒）：克隆里**多出**的非仓库文件 —— 即"仓库里没有这个路径"的文件。
+# ⛔ 三条纪律：① 只报告不清理（克隆可能含带外资产）；② **绝不改 `fail`**（判红就成恒红陷阱）；
+#   ③ 只按**路径存在性**判定（`$REPO/<rel>` 在不在），不做内容比对 —— "内容不同"是上面 sha 核对的职责。
+EXTRA_SHOWN=5
+report_extra() {
+  local sub="$1" rel n=0 shown=0 list="" more=0
+  [ -d "$REPO/$sub" ] && [ -d "$CLONE/$sub" ] || return 0   # 仓库没这个目录 ⇒ 全是"多出"也没有基准，不报
+  while IFS= read -r rel; do
+    [ -n "$rel" ] || continue
+    if [ -e "$REPO/$rel" ]; then continue; fi
+    n=$((n + 1))
+    if [ "$shown" -lt "$EXTRA_SHOWN" ]; then list="$list $rel"; shown=$((shown + 1)); else more=$((more + 1)); fi
+  done < <(cd "$CLONE" && find "$sub" \( -type f -o -type l \) ! -name '.DS_Store' | LC_ALL=C sort)
+  if [ "$n" -gt 0 ]; then
+    printf "  ℹ️ 克隆多出 %d 个非仓库文件（%s/：仓库已删，仅提示，不自动清理）：%s\n" "$n" "$sub" "$list"
+    [ "$more" -gt 0 ] && printf "     └─ 另有 %d 条未列出（全量：find %s/%s \\( -type f -o -type l \\)）\n" "$more" "$CLONE" "$sub"
+  fi
+  return 0
+}
+report_extra core
+report_extra scripts
+report_extra verticals
+report_extra skills
+report_extra deploy
+report_extra configs
+# 注：收尾行的变量必须写成 `${CLONE}`（带花括号）—— 变量名紧跟全角标点时，C locale 下 bash 会把
+# 高位字节当作变量名的一部分 ⇒ `set -u` 直接报"未绑定的变量"并以 1 退出（本次实测踩到）。
+# 该形态由门禁 scripts/tests/shell-cjk-var.test.py 守着（纯行扫描，注释里的字面量同样会触发）。
+[ "$fail" -eq 0 ] && echo "  ✅ ${FACES[*]} 已与仓库一致（${CLONE}；源=${REPO}）"
+exit $fail