@hcmai/sdk 0.3.6 → 0.3.8

package/dist/index.js

@@ -177,25 +177,25 @@ var TokenStore = class _TokenStore {
       throw e;
     }
   }
-  async setAccessToken(token) {
+  async setAccessToken(token2) {
     if (await this.canUseKeychain()) {
       const keytar = await loadKeytar();
-      if (!keytar) return this.writeTokenFile("access", token);
+      if (!keytar) return this.writeTokenFile("access", token2);
       const account = `${this.keychainAccountPrefix()}/access`;
-      await keytar.setPassword(SERVICE_PREFIX, account, token);
+      await keytar.setPassword(SERVICE_PREFIX, account, token2);
       return `keychain:${SERVICE_PREFIX}/${account}`;
     }
-    return this.writeTokenFile("access", token);
+    return this.writeTokenFile("access", token2);
   }
-  async setRefreshToken(token) {
+  async setRefreshToken(token2) {
     if (await this.canUseKeychain()) {
       const keytar = await loadKeytar();
-      if (!keytar) return this.writeTokenFile("refresh", token);
+      if (!keytar) return this.writeTokenFile("refresh", token2);
       const account = `${this.keychainAccountPrefix()}/refresh`;
-      await keytar.setPassword(SERVICE_PREFIX, account, token);
+      await keytar.setPassword(SERVICE_PREFIX, account, token2);
       return `keychain:${SERVICE_PREFIX}/${account}`;
     }
-    return this.writeTokenFile("refresh", token);
+    return this.writeTokenFile("refresh", token2);
   }
   async getAccessToken() {
     if (process.env.HCM_PAT) return process.env.HCM_PAT;
@@ -258,10 +258,10 @@ var TokenStore = class _TokenStore {
       return false;
     }
   }
-  async writeTokenFile(kind, token) {
+  async writeTokenFile(kind, token2) {
     const file = `${this.metaFile()}.${kind}`;
     await fs.mkdir(this.dataDir(), { recursive: true });
-    await fs.writeFile(file, token, { mode: 384 });
+    await fs.writeFile(file, token2, { mode: 384 });
     if (kind === "access") {
       console.warn(`[hcm] WARNING: OS keychain unavailable. Token saved to ${file} (0600).`);
     }
@@ -308,14 +308,14 @@ async function loginPassword(input) {
     },
     { headers: { "Content-Type": "application/json" } }
   );
-  const { token, expiresIn, user } = resp.data;
-  if (!token) {
+  const { token: token2, expiresIn, user } = resp.data;
+  if (!token2) {
     throw new Error("Login response missing token");
   }
   const ttlSeconds = expiresIn ?? DEFAULT_SESSION_TTL_SECONDS;
   const expiresAt = new Date(Date.now() + ttlSeconds * 1e3).toISOString();
   const store = new TokenStore(input.profile);
-  const accessTokenRef = await store.setAccessToken(token);
+  const accessTokenRef = await store.setAccessToken(token2);
   const record = {
     scheme: "password",
     accessTokenRef,
@@ -1068,18 +1068,18 @@ async function action(http, model, actionName, input) {
   if (scope === "object" && !input.id) {
     throw new Error(`object action ${model}.${actionName} requires id`);
   }
-  const path7 = scope === "object" ? `/api/models/${model}/${input.id}/action/${actionName}` : `/api/models/${model}/action/${actionName}`;
+  const path12 = scope === "object" ? `/api/models/${model}/${input.id}/action/${actionName}` : `/api/models/${model}/action/${actionName}`;
   const resp = await (async () => {
     if (method === "GET") {
-      return http.get(path7, { params: queryParams(input) });
+      return http.get(path12, { params: queryParams(input) });
     }
     if (method === "DELETE") {
-      return http.delete(path7, { params: queryParams(input) });
+      return http.delete(path12, { params: queryParams(input) });
     }
     if (method === "PUT") {
-      return http.put(path7, scope === "object" ? objectBody(input) : classBody(input));
+      return http.put(path12, scope === "object" ? objectBody(input) : classBody(input));
     }
-    return http.post(path7, scope === "object" ? objectBody(input) : classBody(input));
+    return http.post(path12, scope === "object" ? objectBody(input) : classBody(input));
   })();
   return resp.data;
 }
@@ -1690,14 +1690,14 @@ async function loginPairing(input) {
     { code: input.code },
     { headers: { "Content-Type": "application/json" } }
   );
-  const { token, expiresIn, user } = resp.data;
-  if (!token) {
+  const { token: token2, expiresIn, user } = resp.data;
+  if (!token2) {
     throw new Error("Pairing exchange response missing token");
   }
   const ttlSeconds = expiresIn ?? DEFAULT_SESSION_TTL_SECONDS;
   const expiresAt = new Date(Date.now() + ttlSeconds * 1e3).toISOString();
   const store = new TokenStore(input.profile);
-  const accessTokenRef = await store.setAccessToken(token);
+  const accessTokenRef = await store.setAccessToken(token2);
   const record = {
     scheme: "pairing",
     accessTokenRef,
@@ -1730,10 +1730,10 @@ function detectPasswordChangeChallenge(err) {
   const body = err?.response?.data;
   const error = body?.error ?? body;
   if (error?.code !== PASSWORD_CHANGE_REQUIRED) return null;
-  const token = error?.details?.changePasswordToken;
-  if (!token) return null;
+  const token2 = error?.details?.changePasswordToken;
+  if (!token2) return null;
   return {
-    changePasswordToken: String(token),
+    changePasswordToken: String(token2),
     expiresInSeconds: Number(error?.details?.expiresInSeconds) || void 0
   };
 }
@@ -1812,7 +1812,7 @@ var WsClient = class {
       });
     }
     this.ws = new WebSocket(this.opts.endpoint);
-    return new Promise((resolve4, reject) => {
+    return new Promise((resolve4, reject2) => {
       const settle = (fn) => {
         off();
         fn();
@@ -1857,7 +1857,7 @@ var WsClient = class {
           this.ws.on("error", this.persistentOnClose);
         } else if (msg.type === "auth_error") {
           settle(
-            () => reject(
+            () => reject2(
               new CliError({
                 code: "WS_AUTH_ERROR" /* WS_AUTH_ERROR */,
                 // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -1870,10 +1870,10 @@ var WsClient = class {
         }
       };
       const onError = (err) => settle(
-        () => reject(new CliError({ code: "NETWORK_ERROR" /* NETWORK_ERROR */, message: err.message }))
+        () => reject2(new CliError({ code: "NETWORK_ERROR" /* NETWORK_ERROR */, message: err.message }))
       );
       const onClose = () => settle(
-        () => reject(
+        () => reject2(
           new CliError({ code: "NETWORK_ERROR" /* NETWORK_ERROR */, message: "WS closed before auth" })
         )
       );
@@ -5035,18 +5035,18 @@ async function listTenantMeta(http, opts = {}) {
   const items = payload?.items ?? payload?.list ?? payload?.records ?? [];
   return { items, total: payload?.total, raw: payload };
 }
-async function getTenantMeta(http, path7) {
-  const resp = await http.get("/api/tenant-meta/meta", { params: { path: path7 } });
+async function getTenantMeta(http, path12) {
+  const resp = await http.get("/api/tenant-meta/meta", { params: { path: path12 } });
   const payload = resp.data?.data ?? resp.data;
   if (typeof payload === "string") return payload;
   return String(payload?.content ?? "");
 }
-async function saveTenantMeta(http, path7, content) {
-  const resp = await http.put("/api/tenant-meta/meta", { content }, { params: { path: path7 } });
+async function saveTenantMeta(http, path12, content) {
+  const resp = await http.put("/api/tenant-meta/meta", { content }, { params: { path: path12 } });
   return resp.data?.data ?? resp.data;
 }
-async function deleteTenantMeta(http, path7) {
-  const resp = await http.delete("/api/tenant-meta/meta", { params: { path: path7 } });
+async function deleteTenantMeta(http, path12) {
+  const resp = await http.delete("/api/tenant-meta/meta", { params: { path: path12 } });
   return resp.data?.data ?? resp.data;
 }
 
@@ -5148,14 +5148,14 @@ function resolveSkillInstallOrder(manifest2, targetId) {
     throw invalid(`\u6280\u80FD\u76EE\u5F55\u4E2D\u4E0D\u5B58\u5728 ${targetId}`);
   }
   const state = /* @__PURE__ */ new Map();
-  const path7 = [];
+  const path12 = [];
   const order = [];
   const visit = (id, requiredBy) => {
     const current = state.get(id);
     if (current === "done") return;
     if (current === "visiting") {
-      const cycleStart = path7.indexOf(id);
-      const cycle = [...path7.slice(Math.max(0, cycleStart)), id];
+      const cycleStart = path12.indexOf(id);
+      const cycle = [...path12.slice(Math.max(0, cycleStart)), id];
       throw invalid(`\u6280\u80FD\u4F9D\u8D56\u5B58\u5728\u73AF: ${cycle.join(" -> ")}`);
     }
     const skill = byId.get(id);
@@ -5164,11 +5164,11 @@ function resolveSkillInstallOrder(manifest2, targetId) {
     }
     assertSafeSkillId(skill.id);
     state.set(id, "visiting");
-    path7.push(id);
+    path12.push(id);
     for (const required of normalizeRequirements(skill.requires, skill.id)) {
       visit(required, skill.id);
     }
-    path7.pop();
+    path12.pop();
     state.set(id, "done");
     order.push(skill);
   };
@@ -5259,11 +5259,11 @@ async function resetSettingItem(http, domain, namespace, settingKey, revision) {
 function parseSettingAssignment(raw) {
   const eq = raw.indexOf("=");
   if (eq <= 0) throw new Error(`--set \u9700\u8981 namespace.key=value \u5F62\u6001\uFF0C\u6536\u5230 "${raw}"`);
-  const path7 = raw.slice(0, eq).trim();
+  const path12 = raw.slice(0, eq).trim();
   const value = raw.slice(eq + 1);
-  const dot = path7.lastIndexOf(".");
-  if (dot <= 0) throw new Error(`--set \u7684\u952E\u9700\u542B namespace\uFF0C\u5982 security.password.passwordPolicy=complex\uFF0C\u6536\u5230 "${path7}"`);
-  return { namespace: path7.slice(0, dot), settingKey: path7.slice(dot + 1), value };
+  const dot = path12.lastIndexOf(".");
+  if (dot <= 0) throw new Error(`--set \u7684\u952E\u9700\u542B namespace\uFF0C\u5982 security.password.passwordPolicy=complex\uFF0C\u6536\u5230 "${path12}"`);
+  return { namespace: path12.slice(0, dot), settingKey: path12.slice(dot + 1), value };
 }
 
 // src/fde/layout.ts
@@ -5460,6 +5460,11 @@ function manifestDigest(rows) {
   const lines = rows.map((r) => `${r.name}|${r.size}|${r.lastModified}`).sort();
   return sha2562(lines.join("\n"));
 }
+async function computeReconSourceKey(probe) {
+  const out = await probe.get(MODELS_PATH);
+  const p = await probeExtensionSource(probe, modelKeys(out.body));
+  return p.sourceKey || "unknown";
+}
 async function computeFingerprint(probe, opts = {}) {
   const ttlDays = opts.ttlDays ?? 30;
   const now = opts.now ?? (() => /* @__PURE__ */ new Date());
@@ -5652,11 +5657,11 @@ function classifyStatus(status) {
   return "bad-response";
 }
 var CAPABILITIES_HEADER = "x-hcm-capabilities";
-function buildUrl(path7, params) {
+function buildUrl(path12, params) {
   const entries = Object.entries(params ?? {}).filter(([, v]) => v !== void 0 && v !== null);
-  if (entries.length === 0) return path7;
+  if (entries.length === 0) return path12;
   const qs = entries.map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`).join("&");
-  return `${path7}${path7.includes("?") ? "&" : "?"}${qs}`;
+  return `${path12}${path12.includes("?") ? "&" : "?"}${qs}`;
 }
 function lowerHeaders(raw) {
   const out = {};
@@ -5691,20 +5696,21 @@ function httpProbe(http, capabilities) {
     } catch (e) {
       const msg = e instanceof Error ? e.message : String(e);
       const local = /Invalid URL|ERR_INVALID_URL|ERR_UNESCAPED_CHARACTERS/i.test(msg);
+      if (!local && isProgrammingError(e)) throw e;
       return { status: -1, body: null, error: local ? "bad-response" : "network", headers: {} };
     }
   }
   const headers = { [CAPABILITIES_HEADER]: capabilities };
   const probe = {
     capabilities,
-    get(path7, params) {
+    get(path12, params) {
       return once(
-        () => http.get(buildUrl(path7, params), { headers, validateStatus: () => true })
+        () => http.get(buildUrl(path12, params), { headers, validateStatus: () => true })
       );
     },
-    post(path7, body) {
+    post(path12, body) {
       return once(
-        () => http.post(path7, body, {
+        () => http.post(path12, body, {
           headers: { ...headers, "content-type": "application/json" },
           validateStatus: () => true
         })
@@ -5736,23 +5742,2970 @@ function httpProbe(http, capabilities) {
   };
   return probe;
 }
+function isProgrammingError(e) {
+  if (!(e instanceof Error)) return false;
+  if (e.isAxiosError) return false;
+  return e instanceof TypeError || e instanceof ReferenceError || e instanceof SyntaxError;
+}
 function networkOutcome() {
   return { status: -1, body: null, error: "network", headers: {} };
 }
+
+// src/fde/recon/runner.ts
+import { randomBytes as randomBytes2 } from "crypto";
+import { existsSync as existsSync3, readFileSync as readFileSync3, readdirSync } from "fs";
+import * as path8 from "path";
+
+// src/fde/recon/carry-over.ts
+var KIT_CARRY_OVER_KEY = "_kitCarryOver";
+
+// src/fde/recon/notes.ts
+var NOTE_404 = "HTTP 404\uFF1A\u591A\u4E3A @HiddenFromRegistry \u578B\u6A21\u578B\uFF08\u5982\u5404\u79CD *Index\uFF09\uFF0C\u4EA7\u54C1\u5BF9\u5176\u6052\u8FD4 DATA_NOT_FOUND\u3002\u5C5E\u6B63\u5E38\u5206\u7C7B\u7ED3\u679C\uFF0C\u975E\u6545\u969C";
+var NOTE_NETWORK = "\u672A\u6536\u5230 HTTP \u54CD\u5E94\uFF08\u6052 status=-1\uFF09\u3002\u{1F534} \u672C\u6876**\u4E0D\u53EA\u88C5\u7F51\u7EDC\u6545\u969C**\uFF1B\u4E0B\u9762\u662F**\u5DF2\u5B9E\u6D4B**\u56DB\u7C7B\uFF0C**\u4E0D\u4FDD\u8BC1\u5217\u5168**\uFF08\u6279\u91CF\u8DEF\u5F84\u515C\u5E95\u63A5\u4F4F\u4E00\u5207\u5F02\u5E38\uFF0C\u672C\u5C42\u4EFB\u4F55\u65B0\u5F02\u5E38\u90FD\u4F1A\u843D\u8FD9\u91CC\uFF09\uFF1A\u2460 modelKey \u542B\u7A7A\u683C/\u63A7\u5236\u5B57\u7B26 \u2192 URL \u7578\u5F62\uFF0C\u5DE5\u5177\u4FA7\u95EE\u9898\uFF1B\u2461 \u7AEF\u70B9\u6F0F\u5199 http:// \u4E14\u5E26\u7AEF\u53E3\uFF08\u5982 localhost:8087\uFF09\u2192\u300Cunknown url type\u300D\uFF0C\u914D\u7F6E\u95EE\u9898\uFF1B\u2462 https + \u81EA\u7B7E/\u5185\u7F51 CA \u2192 TLS \u8BC1\u4E66\u95EE\u9898\uFF0C\u914D CA \u6216\u6539 http\uFF0C\u67E5\u94FE\u8DEF\u662F\u767D\u67E5\uFF1B\u2463 \u5DE5\u5177\u81EA\u8EAB\u5F02\u5E38 \u2192 \u6279\u91CF\u8DEF\u5F84\u515C\u6210\u672C\u6876\uFF0C**\u53BB\u770B stderr \u91CC\u7684\u5806\u6808**\u3002\u90FD\u4E0D\u50CF\u624D\u8F6E\u5230\u67E5 VPN / DNS / \u94FE\u8DEF\u3002\u5360\u6BD4\u4E5F\u662F\u5224\u636E\uFF1A\u6574\u6279\u5168\u843D\u672C\u6876 \u2192 \u7AEF\u70B9/\u8BC1\u4E66/\u7F51\u7EDC\uFF1B\u53EA\u4E2A\u522B\u51E0\u6761 \u2192 \u90A3\u4E2A modelKey \u6216\u5DE5\u5177 bug";
+var NOTE_BAD_RESPONSE = '\u5206\u7C7B\u6309 status \u8D70\uFF0C**\u4E0D\u4EE3\u8868\u6B63\u6587\u4E00\u5B9A\u4E0D\u662F JSON**\u3002\u6309 status \u5206\u6D41\uFF1Astatus=-1 \u2192 \u8BF7\u6C42**\u6839\u672C\u6CA1\u53D1\u51FA\u53BB**\uFF08\u540C\u6837**\u4E0D\u4FDD\u8BC1\u5217\u5168**\uFF09\uFF1AmodelKey \u542B**\u975E ASCII**\uFF08\u5982\u4E2D\u6587\uFF09\u2192 \u53D1\u9001\u9636\u6BB5\u7F16\u7801\u5931\u8D25\uFF1B\u6216\u7AEF\u70B9\u6F0F\u5199 http:// \u4E14**\u4E0D\u5E26\u7AEF\u53E3**\uFF08\u5982 myserver\uFF09\u2192\u300Cunknown url type\u300D\u3002\u26A0\uFE0F \u542B**\u7A7A\u683C**\u7684 modelKey\u3001\u4EE5\u53CA\u6F0F scheme \u4F46**\u5E26\u7AEF\u53E3**\u7684\u7AEF\u70B9\uFF0C\u843D\u7684\u662F network \u6876\u4E0D\u5728\u8FD9\u91CC\uFF1Bstatus=2xx \u2192 \u670D\u52A1\u7AEF\u8FD4\u56DE\u4E86\u7A7A\u4F53\u3001\u975E JSON \u6B63\u6587\u6216 JSON null\uFF08\u300C\u6CA1\u7ED9\u5230\u6570\u636E\u300D\uFF0C\u975E\u300C\u7A7A\u96C6\u5408\u300D\uFF09\u2014\u2014 \u53EA\u6709\u8FD9\u4E00\u6863\u7684**\u5206\u7C7B\u539F\u56E0**\u662F\u89E3\u6790\u5931\u8D25\uFF1B\u5176\u4F59 status\uFF08400/409/422 \u7B49\u672A\u88AB\u5355\u72EC\u5206\u6863\u7684\u975E 2xx\uFF09\u2192 \u8BCA\u65AD\u5728**\u72B6\u6001\u7801**\u91CC\uFF0C\u6B63\u6587\u5F88\u53EF\u80FD\u662F\u4E00\u4EFD**\u5B8C\u597D**\u7684\u4E1A\u52A1\u9519\u8BEF\u4FE1\u5C01\uFF08{"error":{"code","message","details"},"success":false}\uFF0C\u4EBA\u8BDD\u5728 details \u91CC\uFF1Berror \u8FD8\u53EF\u80FD\u5E26 field\uFF0C\u8BE5\u952E\u56DE\u6E90\u81EA Java DTO\u30012026-08-16 \u5B9E\u6D4B\u4E09\u7AEF\u70B9\u5747\u672A\u51FA\u73B0\uFF09\uFF0C\u503C\u5F97\u770B\u4E00\u773C\uFF1B\u4F46\u672C\u5DE5\u5177\u7684 GET \u8DEF\u5F84\u4E0D\u4FDD\u7559\u975E 2xx \u7684\u6B63\u6587\uFF08\u4EA7\u7269\u91CC\u6CA1\u6709\u5B83\uFF09\uFF0C\u8981\u770B\u8FD9\u6BB5\u4EBA\u8BDD\u5F97\u7167\u539F\u6837\u91CD\u6253\u4E00\u6B21\u8BE5\u8BF7\u6C42\uFF08curl \u5373\u53EF\uFF09\u3002\u4E5F\u53EF\u80FD\u662F\u7F51\u5173/\u53CD\u4EE3\u5410\u7684 HTML \u515C\u5E95\u9875';
+var UNAVAILABLE_NOTES = {
+  "not-found": NOTE_404,
+  forbidden: "HTTP 403\uFF1A\u5F53\u524D\u8D26\u53F7\u5BF9\u8BE5\u6A21\u578B\u65E0\u6743\u9650\u3002\u4EA7\u7269\u8986\u76D6\u9762\u56E0\u6B64\u53D7\u9650\uFF0C\u987B\u8BB0\u8FDB\u6743\u9650\u753B\u50CF",
+  unauthorized: "HTTP 401\uFF1Atoken \u5931\u6548\u6216\u672A\u8BA4\u8BC1",
+  network: NOTE_NETWORK,
+  "bad-response": NOTE_BAD_RESPONSE,
+  "server-error": "\u670D\u52A1\u7AEF 5xx"
+};
+function unclassifiedNote(error) {
+  return `\u672A\u5206\u7C7B\u5931\u8D25\uFF1A\u5206\u7C7B\u4E32 ${JSON.stringify(error)} \u4E0D\u5728\u5DE5\u5177\u7684 note \u8868\u91CC\u3002\u672C\u5C42\u91CC\u7ED9\u8FD9\u4E2A\u53C2\u6570\u5582\u503C\u7684\u662F \`crawlMeta\` \u4E0E \`collectActionGates\` \u4E24\u5904\uFF0C\u4E24\u5904\u4F20\u7684\u90FD\u662F\u540C\u4E00\u8FDB\u7A0B\u91CC\u63A2\u9488\u7ED9\u7684\u5206\u7C7B\u4E32\uFF08\u540C\u4E00\u4EFD\u5B89\u88C5\uFF09\u2014\u2014\u5728\u8FD9\u6761\u94FE\u8DEF\u4E0A\u5B83\u4E0E note \u8868\u672C\u8BE5\u9010\u4E00\u5BF9\u4E0A\u3002\u522B\u7684\u6765\u6E90\u672C\u6A21\u5757**\u6CA1\u6709\u67E5\u8FC7**\uFF1B\u628A\u4E0A\u9762\u8FD9\u4E2A\u5206\u7C7B\u4E32\u539F\u6837\u62A5\u56DE\u6765`;
+}
+function noteFor(error) {
+  return UNAVAILABLE_NOTES[error] ?? unclassifiedNote(error);
+}
+
+// src/fde/recon/crawl.ts
+var KIT_PREMISE_KEY = "_kitPremiseCheck";
+var DEFAULT_META_TYPE = "model";
+function metaPath(modelKey, metaType = DEFAULT_META_TYPE) {
+  const base = `/api/models/${modelKey}/meta`;
+  return metaType === DEFAULT_META_TYPE ? base : `${base}?type=${metaType}`;
+}
+function modelRows(body) {
+  if (!body || typeof body !== "object" || Array.isArray(body)) return [];
+  const rows = body.models;
+  if (!Array.isArray(rows)) return [];
+  return rows.filter((m) => Boolean(m) && typeof m === "object" && !Array.isArray(m));
+}
+function shapeOf(value) {
+  if (value === null) return "null";
+  if (Array.isArray(value)) return "list";
+  return typeof value === "object" ? "dict" : typeof value;
+}
+async function crawlModels(probe) {
+  const out = await probe.get(MODELS_PATH);
+  const healthy = Boolean(out.body) && typeof out.body === "object" && !Array.isArray(out.body);
+  const body = healthy ? { ...out.body } : { totalCount: 0, typeCounts: {}, models: [] };
+  const rows = Array.isArray(body.models) ? body.models : void 0;
+  const premise = {
+    // 前提显式断言：totalCount 与 models 长度不符时，后续任何「共 N 个模型」都不成立。
+    totalCountMatchesListLength: Boolean(healthy && rows !== void 0 && body.totalCount === rows.length),
+    responseShape: shapeOf(out.body),
+    status: out.status,
+    error: out.error,
+    // 撞键与否**恒有值**：没有这个键时「没撞」与「没检查过」在产物里同形。
+    collidedWithServerKey: Object.prototype.hasOwnProperty.call(body, KIT_PREMISE_KEY)
+  };
+  if (premise.collidedWithServerKey) {
+    premise.serverValue = body[KIT_PREMISE_KEY];
+  }
+  body[KIT_PREMISE_KEY] = premise;
+  return body;
+}
+async function crawlMeta(probe, modelKeys2, metaType = DEFAULT_META_TYPE) {
+  const paths = /* @__PURE__ */ new Map();
+  for (const key of modelKeys2) paths.set(metaPath(key, metaType), key);
+  const results = probe.getMany ? await probe.getMany([...paths.keys()]) : await sequentialGet(probe, [...paths.keys()]);
+  const metas = {};
+  const unavailable = [];
+  for (const [path12, key] of paths) {
+    const out = results[path12];
+    if (out === void 0) {
+      unavailable.push({
+        modelKey: key,
+        metaType,
+        status: -1,
+        error: "not-crawled",
+        note: "\u5E76\u53D1\u6279\u6B21\u91CC\u6CA1\u6709\u8FD4\u56DE\u8BE5 path"
+      });
+      continue;
+    }
+    const isObject = Boolean(out.body) && typeof out.body === "object" && !Array.isArray(out.body);
+    if (out.error === "ok" && isObject) {
+      metas[key] = out.body;
+      continue;
+    }
+    if (out.error === "ok") {
+      unavailable.push({
+        modelKey: key,
+        metaType,
+        status: out.status,
+        error: "unexpected-shape",
+        note: `HTTP ${out.status} \u6210\u529F\u4F46\u8F7D\u8377\u662F ${shapeOf(out.body)}\uFF0C\u4E0D\u662F meta \u5BF9\u8C61\uFF08\u8F7D\u8377\u5F62\u72B6\u95EE\u9898\uFF0C\u4E0D\u662F\u53D6\u6570\u5931\u8D25\uFF09`,
+        bodyPreview: JSON.stringify(out.body).slice(0, 200)
+      });
+      continue;
+    }
+    unavailable.push({ modelKey: key, metaType, status: out.status, error: out.error, note: noteFor(out.error) });
+  }
+  return { metas, unavailable };
+}
+async function sequentialGet(probe, paths) {
+  const out = {};
+  for (const p of paths) out[p] = await probe.get(p);
+  return out;
+}
+function reconcileUnavailable(modelsBody, unavailable) {
+  const declared = [
+    ...new Set(modelRows(modelsBody).filter((m) => m.error).map((m) => String(m.modelKey)))
+  ].sort();
+  const observed = [...new Set(unavailable.map((e) => e.modelKey).filter(Boolean))].sort();
+  const dset = new Set(declared);
+  const oset = new Set(observed);
+  return {
+    declaredUnavailable: declared,
+    observedUnavailable: observed,
+    declaredNotObserved: declared.filter((k) => !oset.has(k)),
+    observedNotDeclared: observed.filter((k) => !dset.has(k)),
+    agrees: declared.length === observed.length && declared.every((k) => oset.has(k)),
+    note: "declaredNotObserved = \u6A21\u578B\u6E05\u5355\u58F0\u660E\u4E0D\u53EF\u7528\u3001\u4F46\u672C\u8F6E\u6CA1\u6709\u5BF9\u5E94\u5931\u8D25\u8BB0\u5F55 \u21D2 \u6F0F\u722C\uFF1BobservedNotDeclared = \u6A21\u578B\u6E05\u5355\u8BF4\u53EF\u7528\u3001\u672C\u8F6E\u5374\u5931\u8D25 \u21D2 \u67E5\u6743\u9650/\u8D85\u65F6/\u7F51\u5173\uFF0C\u4E0D\u662F\u300C\u53D1\u73B0\u4E86\u9690\u85CF\u6A21\u578B\u300D"
+  };
+}
+function writeCrawlProducts(layout, modelsBody, metas, unavailable, metaType = DEFAULT_META_TYPE) {
+  const written = {};
+  layout.writeJson("models.json", modelsBody);
+  written.models = "models.json";
+  for (const [key, body] of Object.entries(metas)) {
+    try {
+      layout.writeJson(`meta/${key}.${metaType}.json`, body);
+    } catch (e) {
+      if (!(e instanceof LayoutContainmentError)) throw e;
+      unavailable.push({
+        modelKey: key,
+        metaType,
+        status: 200,
+        error: "unsafe-model-key",
+        note: e.message
+      });
+    }
+  }
+  written.meta = "meta/";
+  layout.writeJson("unavailable.json", {
+    crawled: true,
+    count: unavailable.length,
+    entries: unavailable,
+    reconciliation: reconcileUnavailable(modelsBody, unavailable)
+  });
+  written.unavailable = "unavailable.json";
+  return written;
+}
+
+// src/fde/recon/fields.ts
+var KIT_VALUE_SOURCE = "_kitValueSource";
+function typeName(v) {
+  if (v === null) return "null";
+  if (Array.isArray(v)) return "list";
+  return typeof v === "object" ? "dict" : typeof v;
+}
+function metaFields(body) {
+  if (!body || typeof body !== "object" || Array.isArray(body)) {
+    return { fields: [], problem: `meta \u8F7D\u8377\u4E0D\u662F\u5BF9\u8C61\uFF08${typeName(body)}\uFF09` };
+  }
+  const obj = body;
+  if (!Object.prototype.hasOwnProperty.call(obj, "fields")) return { fields: [] };
+  const fields = obj.fields;
+  if (fields === null) {
+    return { fields: [], problem: "fields \u662F null\uFF08\u670D\u52A1\u7AEF\u663E\u5F0F\u53D1\u4E86 null\uFF0C\u4E0E\u300C\u6CA1\u6709 fields \u952E\u300D\u4E0D\u662F\u4E00\u56DE\u4E8B\uFF09" };
+  }
+  if (!Array.isArray(fields)) return { fields: [], problem: `fields \u4E0D\u662F\u6570\u7EC4\uFF08${typeName(fields)}\uFF09` };
+  return { fields };
+}
+function enumRows(field) {
+  const items = field.enums;
+  if (!Array.isArray(items)) return [];
+  const out = [];
+  for (const o of items) {
+    if (o && typeof o === "object" && !Array.isArray(o)) {
+      const rec = o;
+      const value = rec.value;
+      const label = rec.label;
+      if (value !== void 0 && value !== null) {
+        out.push({ value: String(value), label: String(label ?? "") });
+      } else if (label !== void 0 && label !== null) {
+        out.push({ value: String(label), label: String(label), [KIT_VALUE_SOURCE]: "label" });
+      } else {
+        out.push({ value: JSON.stringify(o), label: "", [KIT_VALUE_SOURCE]: "repr:dict" });
+      }
+      continue;
+    }
+    out.push({ value: String(o), label: "", [KIT_VALUE_SOURCE]: `element:${typeName(o)}` });
+  }
+  return out;
+}
+function extractFieldRows(metas) {
+  const rows = [];
+  const dropped = [];
+  for (const [model, body] of Object.entries(metas)) {
+    const { fields, problem } = metaFields(body);
+    if (problem) {
+      dropped.push(`${model}: ${problem}\uFF0C\u6574\u4E2A\u6A21\u578B\u6CA1\u6709\u5B57\u6BB5\u8FDB\u7D22\u5F15`);
+      continue;
+    }
+    fields.forEach((f, index) => {
+      const i = index + 1;
+      if (!f || typeof f !== "object" || Array.isArray(f)) {
+        dropped.push(`${model}: \u7B2C ${i} \u4E2A\u5B57\u6BB5\u4E0D\u662F\u5BF9\u8C61\uFF08${typeName(f)}\uFF09`);
+        return;
+      }
+      const rec = f;
+      const key = rec.key;
+      if (typeof key !== "string" || !key) {
+        dropped.push(`${model}: \u7B2C ${i} \u4E2A\u5B57\u6BB5\u6CA1\u6709\u53EF\u7528\u7684 key\uFF08${JSON.stringify(key) ?? String(key)}\uFF09`);
+        return;
+      }
+      rows.push({
+        model,
+        key,
+        // 🔴 中文名的键是 `name`，**不是 `label`**（实测 2676/2676 个字段没有一个带 label）。
+        // 本仓字段命名规范也是「名称字段统一用 name，禁止 label」。
+        name: str(rec.name),
+        type: str(rec.type),
+        // 🔴 必填的键是 `isRequired`，**不是 `required`**（实测 required 出现 0 次）。
+        // 缺省一律显式 false，不用 null——null 会把「没这属性」和「值是假」混成一件事。
+        isRequired: Boolean(rec.isRequired ?? false),
+        isFlex: Boolean(rec.isFlex ?? false),
+        // `columnDefinition` 是实测存在的存储侧信息（14% 的字段有）；原计划的 `storage` 键**不存在**。
+        columnDefinition: str(rec.columnDefinition),
+        // 🔴 顾问真正会 grep 的是业务话术：字段级 synonyms 与 description。
+        // 它们稀疏但**恒发**（空就是 [] / ""）——「有这一列且为空」与「没这一列」是两个值。
+        synonyms: Array.isArray(rec.synonyms) ? rec.synonyms.filter(Boolean).map(String) : [],
+        description: str(rec.description),
+        enums: enumRows(rec)
+      });
+    });
+  }
+  return { rows, dropped };
+}
+function str(v) {
+  return v === void 0 || v === null || v === false ? "" : String(v);
+}
+function writeFieldsIndex(layout, rows) {
+  return layout.writeJsonl("index/fields.jsonl", rows);
+}
+
+// src/fde/recon/gates.ts
+var WORDING = "\u672C\u6587\u4EF6\u767B\u8BB0\u7684\u662F**\u663E\u5F0F\u58F0\u660E**\u4E3A\u53EA\u8BFB\u7684\u52A8\u4F5C\u3002kit \u53EA\u80FD\u8D70 RBAC \u88C1\u526A\u540E\u7684 REST\u3001\u89C2\u6D4B\u7A97\u53E3\u6709\u9650\uFF0C\u56E0\u6B64\u4EFB\u4F55\u7ED3\u8BBA\u7684\u53E3\u5F84\u90FD\u662F\u300C\u5728\u58F0\u660E\u5F71\u54CD\u9762\u5185\u672A\u89C2\u6D4B\u5230\u53D8\u5316\u300D\uFF0C\u800C**\u4E0D\u662F**\u300C\u65E0\u526F\u4F5C\u7528\u300D\u3002guard=declared-only \u7684\u6761\u76EE\u8FDE\u670D\u52A1\u7AEF\u9759\u6001\u5B88\u536B\u90FD\u6CA1\u6709\uFF0C\u53EA\u6709\u4E00\u53E5\u58F0\u660E\u3002";
+var GUARD_ARCH = "declared+arch-guard";
+var GUARD_DECLARED_ONLY = "declared-only";
+var ARCH_GUARDED_SOURCE = "java";
+var REJECT_NOTES = {
+  conflict: "\u7AEF\u70B9\u6807\u4E86 conflict=true\uFF1A\u540C key \u7684\u5019\u9009\u5F7C\u6B64\u4E0D\u4E00\u81F4\u3002\u4E0D\u4E00\u81F4\u5C31\u4E0D\u80FD\u514D\u786E\u8BA4\u6267\u884C \u2014\u2014 \u8FD9\u6B63\u662F\u300C\u4E3A A \u653E\u884C\u3001\u6267\u884C B\u300D\u90A3\u6761\u6D1E",
+  "conflict-undeclared": "\u7AEF\u70B9\u6CA1\u6709\u660E\u786E\u8BF4 conflict=false\uFF08\u952E\u7F3A\u5931\u6216\u4E0D\u662F\u5E03\u5C14\uFF09\u3002fail-closed \u4E0D\u731C\uFF1A\u7F3A\u58F0\u660E\u6309\u6709\u5206\u6B67\u5904\u7406\u3002\u4E0E readOnly \u540C\u4E00\u6761\u7EAA\u5F8B \u2014\u2014 \u7F3A\u952E\u4E0D\u7B49\u4E8E\u300C\u6CA1\u95EE\u9898\u300D",
+  "candidate-not-read-only": "\u805A\u5408\u8BF4\u53EA\u8BFB\uFF0C\u4F46\u81F3\u5C11\u4E00\u4E2A\u5019\u9009\u6CA1\u6709\u663E\u5F0F readOnly=true\u3002\u591A\u5019\u9009\u805A\u5408\u662F all \u4E0D\u662F any\uFF1A\u4E00\u4E2A\u53EA\u8BFB\u5019\u9009\u4E0D\u80FD\u628A\u4F1A\u5199\u5E93\u7684\u52A8\u4F5C\u62AC\u6210\u95F8",
+  "no-candidates": "\u58F0\u660E\u4E86 readOnly=true \u5374\u6CA1\u6709\u4EFB\u4F55\u5019\u9009\u80CC\u4E66\u3002\u6CA1\u6709\u5019\u9009 = \u6CA1\u6709\u4EFB\u4F55\u4E1C\u897F\u53EF\u6838",
+  "malformed-candidate": "\u5019\u9009\u4E0D\u662F\u5BF9\u8C61\uFF08\u7F51\u5173\u6539\u5199 / \u7248\u672C\u6F02\u79FB\uFF1F\uFF09\uFF0C\u65E0\u6CD5\u6838\u5BF9\u5B83\u7684 source \u4E0E readOnly",
+  "malformed-key": "\u52A8\u4F5C\u6CA1\u6709\u53EF\u7528\u7684 key \u2014\u2014 \u6CA1\u6709 key \u5C31\u65E0\u6CD5\u8C03\u7528\uFF0C\u4E5F\u65E0\u6CD5\u4E0E\u4EA7\u54C1\u4FA7\u5BF9\u8D26",
+  "malformed-action": "\u52A8\u4F5C\u6761\u76EE\u4E0D\u662F\u5BF9\u8C61\uFF0C\u65E0\u6CD5\u5224\u8BFB\u5B83\u662F\u4E0D\u662F\u53EA\u8BFB\u95F8"
+};
+function actionsPath(modelKey, state = "") {
+  const base = `/api/models/${modelKey}/actions`;
+  if (!state) return base;
+  return `${base}?${new URLSearchParams({ state }).toString()}`;
+}
+function isRecord(v) {
+  return Boolean(v) && typeof v === "object" && !Array.isArray(v);
+}
+function reject(out, model, key, reason) {
+  out.push({
+    model,
+    key: typeof key === "string" && key ? key : null,
+    reason,
+    note: REJECT_NOTES[reason]
+  });
+}
+async function collectActionGates(probe, modelKeys2, state = "") {
+  const keys = [...new Set(modelKeys2)];
+  const paths = /* @__PURE__ */ new Map();
+  for (const k of keys) paths.set(actionsPath(k, state), k);
+  const results = probe.getMany ? await probe.getMany([...paths.keys()]) : await sequentialGet(probe, [...paths.keys()]);
+  const gates = [];
+  const rejected = [];
+  const unavailable = [];
+  const sources = /* @__PURE__ */ new Set();
+  const statesEchoed = /* @__PURE__ */ new Set();
+  let noStateEcho = 0;
+  let answered = 0;
+  for (const [path12, model] of paths) {
+    const out = results[path12];
+    if (out === void 0) {
+      unavailable.push({
+        modelKey: model,
+        status: -1,
+        error: "not-crawled",
+        note: "\u5E76\u53D1\u6279\u6B21\u91CC\u6CA1\u6709\u8FD4\u56DE\u8BE5 path"
+      });
+      continue;
+    }
+    if (out.error !== "ok") {
+      unavailable.push({ modelKey: model, status: out.status, error: out.error, note: noteFor(out.error) });
+      continue;
+    }
+    const body = out.body;
+    if (!isRecord(body) || !Array.isArray(body.actions)) {
+      unavailable.push({
+        modelKey: model,
+        status: out.status,
+        error: "unexpected-shape",
+        note: `HTTP ${out.status} \u6210\u529F\u4F46\u8F7D\u8377\u662F ${body === null ? "null" : Array.isArray(body) ? "list" : typeof body}\u3001\u6216\u5176\u4E2D\u6CA1\u6709 actions \u6570\u7EC4\uFF0C\u65E0\u6CD5\u5224\u8BFB\u8BE5\u6A21\u578B\u7684\u53EA\u8BFB\u95F8\uFF08\u8F7D\u8377\u5F62\u72B6\u95EE\u9898\uFF0C\u4E0D\u662F\u53D6\u6570\u5931\u8D25\uFF09`,
+        bodyPreview: JSON.stringify(body).slice(0, 200)
+      });
+      continue;
+    }
+    answered += 1;
+    const echoed = typeof body.state === "string" ? body.state : null;
+    if (echoed === null) noStateEcho += 1;
+    else statesEchoed.add(echoed);
+    for (const action2 of body.actions) {
+      if (!isRecord(action2)) {
+        reject(rejected, model, null, "malformed-action");
+        continue;
+      }
+      const cands = Array.isArray(action2.candidates) ? action2.candidates : [];
+      for (const c of cands) {
+        if (isRecord(c) && typeof c.source === "string" && c.source) sources.add(c.source);
+      }
+      if (action2.readOnly !== true) continue;
+      const key = action2.key;
+      if (typeof key !== "string" || !key) {
+        reject(rejected, model, key, "malformed-key");
+        continue;
+      }
+      if (action2.conflict !== false) {
+        reject(rejected, model, key, action2.conflict === true ? "conflict" : "conflict-undeclared");
+        continue;
+      }
+      if (cands.length === 0) {
+        reject(rejected, model, key, "no-candidates");
+        continue;
+      }
+      if (!cands.every((c) => isRecord(c))) {
+        reject(rejected, model, key, "malformed-candidate");
+        continue;
+      }
+      if (!cands.every((c) => c.readOnly === true)) {
+        reject(rejected, model, key, "candidate-not-read-only");
+        continue;
+      }
+      const allJava = cands.every((c) => c.source === ARCH_GUARDED_SOURCE);
+      gates.push({
+        model,
+        key,
+        // 缺 label 兜成 null，见 `Gate.label` 上那条注释（undefined 会让键整个消失）。
+        label: typeof action2.label === "string" ? action2.label : null,
+        source: [
+          ...new Set(
+            cands.map((c) => c.source).filter((s) => typeof s === "string" && Boolean(s))
+          )
+        ].sort(),
+        state: echoed,
+        readOnly: true,
+        conflict: false,
+        candidates: cands,
+        guard: allJava ? GUARD_ARCH : GUARD_DECLARED_ONLY
+      });
+    }
+  }
+  const echoedList = [...statesEchoed].sort();
+  const coverage = {
+    // 🔴 永远是 state-scoped：产品没有「列出可用 state」的端点（实测约 200 个取值），
+    // 「全集」不是一个可兑现的词，所以本产物只覆盖本次请求的那一个 state。
+    scope: "state-scoped",
+    // 端点回显的 state。恰好一个取值时记那个值；多个模型回显不一致时记 null 并把
+    // 全部取值摊在 statesEchoed 里 —— 取最后一个赢家会让产物声称一个并不成立的覆盖面。
+    state: echoedList.length === 1 ? echoedList[0] : null,
+    statesEchoed: echoedList,
+    // 🔴 「回显了空 state」(state="") 与「一个模型都没答上来」是两回事，
+    // 不许靠 null 一个值兼职两种含义。
+    stateObserved: statesEchoed.size > 0,
+    stateEchoAgrees: statesEchoed.size <= 1,
+    stateRequested: state,
+    modelsWithoutStateEcho: noStateEcho,
+    sources: [...sources].sort(),
+    modelsQueried: keys.length,
+    duplicateModelKeys: modelKeys2.length - keys.length,
+    modelsAnswered: answered,
+    modelsUnavailable: unavailable.length,
+    // 前提显式断言：不平就说明有模型既没记成答上来、也没记成失败 —— 「扫了 N 个模型」不成立。
+    accountingBalanced: keys.length === answered + unavailable.length,
+    unavailable,
+    rejected,
+    endpointGates: false,
+    // 普通 Controller 端点闸不在本产物内
+    note: "scope \u6052\u4E3A state-scoped\uFF1Astate \u4E0D\u53EF\u679A\u4E3E\uFF0C\u672C\u4EA7\u7269\u53EA\u8986\u76D6 stateRequested \u8BF7\u6C42\u5230\u7684\u90A3\u4E00\u4E2A\uFF1Bunavailable = \u6CA1\u626B\u6210\u7684\u6A21\u578B\uFF08\u4E0E\u300C\u8FD9\u4E2A\u6A21\u578B\u6CA1\u6709\u53EA\u8BFB\u95F8\u300D\u662F\u4E24\u56DE\u4E8B\uFF09\uFF1Brejected = \u58F0\u660E\u4E86\u53EA\u8BFB\u5374\u88AB fail-closed \u89C4\u5219\u62D2\u6389\u7684\u52A8\u4F5C\uFF0C\u5B83\u4EEC\u4E0D\u662F\u95F8\uFF1Bsources = \u672C\u8F6E\u89C1\u5230\u7684**\u5168\u90E8** action\uFF08\u542B\u5199\u52A8\u4F5C\u3001\u542B\u88AB rejected \u7684\u6761\u76EE\uFF09\u7684\u5019\u9009 source \u53BB\u91CD\uFF0C**\u4E0D\u662F**\u95F8\u7684\u6765\u6E90\uFF1B\u95F8\u81EA\u5DF1\u7684\u6765\u6E90\u770B\u6BCF\u6761 gate \u7684 source \u5B57\u6BB5"
+  };
+  return { gates, coverage };
+}
+function writeGates(layout, gates, coverage) {
+  return layout.writeJson("gates.json", {
+    wording: WORDING,
+    coverage,
+    crawled: true,
+    count: gates.length,
+    gates
+  });
+}
+
+// src/fde/recon/scc.ts
+function compareStringArrays(a, b) {
+  for (let i = 0; i < Math.min(a.length, b.length); i += 1) {
+    if (a[i] < b[i]) return -1;
+    if (a[i] > b[i]) return 1;
+  }
+  return a.length - b.length;
+}
+function tarjan(nodes, adj) {
+  const index = /* @__PURE__ */ new Map();
+  const low = /* @__PURE__ */ new Map();
+  const onStack = /* @__PURE__ */ new Set();
+  const stack = [];
+  const result = [];
+  let counter = 0;
+  const neighbours = (n) => [...adj.get(n) ?? []].sort();
+  for (const root of nodes) {
+    if (index.has(root)) continue;
+    index.set(root, counter);
+    low.set(root, counter);
+    counter += 1;
+    stack.push(root);
+    onStack.add(root);
+    const work = [
+      { node: root, it: neighbours(root), pos: 0 }
+    ];
+    while (work.length > 0) {
+      const frame = work[work.length - 1];
+      let advanced = false;
+      while (frame.pos < frame.it.length) {
+        const nxt = frame.it[frame.pos];
+        frame.pos += 1;
+        if (!index.has(nxt)) {
+          index.set(nxt, counter);
+          low.set(nxt, counter);
+          counter += 1;
+          stack.push(nxt);
+          onStack.add(nxt);
+          work.push({ node: nxt, it: neighbours(nxt), pos: 0 });
+          advanced = true;
+          break;
+        }
+        if (onStack.has(nxt)) {
+          low.set(frame.node, Math.min(low.get(frame.node), index.get(nxt)));
+        }
+      }
+      if (advanced) continue;
+      work.pop();
+      if (work.length > 0) {
+        const parent = work[work.length - 1].node;
+        low.set(parent, Math.min(low.get(parent), low.get(frame.node)));
+      }
+      if (low.get(frame.node) === index.get(frame.node)) {
+        const comp = [];
+        for (; ; ) {
+          const w = stack.pop();
+          onStack.delete(w);
+          comp.push(w);
+          if (w === frame.node) break;
+        }
+        result.push(comp.sort());
+      }
+    }
+  }
+  return result;
+}
+
+// src/fde/recon/topology.ts
+var AUDIT_FIELD_KEYS = ["createById", "updateById"];
+var AUDIT_SET = new Set(AUDIT_FIELD_KEYS);
+var WORDING2 = (
+  // 🔴 这一句必须在最前面：下面每个键都是**在这张裁剪过的图上**算出来的。
+  // 少了它，顾问拿 cycles=[] 会读成「产品里没有互相引用」，而实际是「排掉审计边之后没有」。
+  '\u{1F534} \u5168\u90E8\u7ED3\u8BBA\u90FD\u7B97\u5728**\u6392\u9664 excludedEdges\uFF08\u5BA1\u8BA1\u8FB9\uFF09\u4E4B\u540E**\u7684\u8FB9\u96C6\u4E0A \u2014\u2014 cycles / selfLoops / waves / blockedByCycles \u65E0\u4E00\u4F8B\u5916\uFF1Bwaves = \u6A21\u578B\u7EA7\u62D3\u6251\u5206\u6CE2\uFF0C\u8DD1\u5728\u7F29\u70B9\u56FE\u4E0A\uFF0C\u540C\u4E00\u6CE2\u5185\u90E8\u53EF\u5E76\u884C\uFF0C\u8986\u76D6\u300C\u5168\u90E8\u6A21\u578B \u2212 unordered\u300D\u4E0D\u91CD\u4E0D\u6F0F\uFF1Bwaves[0] \u4E0D\u4F9D\u8D56\u4EFB\u4F55**\u53EF\u5B9A\u5E8F**\u6A21\u578B\uFF1B\u{1F534} \u4F46 waves \u91CC\u6709\u4F4D\u7F6E**\u4E0D\u7B49\u4E8E\u300C\u53EF\u4EE5\u76F4\u63A5\u5BFC\u300D**\uFF1A\u51E1\u662F\u540C\u65F6\u51FA\u73B0\u5728 blockedByCycles \u91CC\u7684\u6A21\u578B\uFF0C\u90FD\u8FD8\u4F9D\u8D56\u7740\u73AF\u6210\u5458\uFF0C**\u5FC5\u987B\u5148\u628A cycles \u6309\u4E24\u6BB5\u5F0F\u89E3\u5F00**\u624D\u80FD\u5BFC \u2014\u2014 \u8BFB waves \u5FC5\u987B\u8FDE blockedByCycles \u4E00\u8D77\u8BFB\uFF1Bcycles = \u5F3A\u8FDE\u901A\u5206\u91CF\uFF08\u22652 \u4E2A\u6A21\u578B\u4E92\u76F8\u4F9D\u8D56\uFF09\uFF0C[] \u8868\u793A**\u7B97\u8FC7\u4E14\u6CA1\u6709**\uFF0C\u4E0D\u662F\u6CA1\u7B97\uFF1BselfLoops = \u81EA\u73AF\u6A21\u578B\uFF08\u5982\u7EC4\u7EC7\u7684 parentId\uFF09\uFF0C\u81EA\u73AF\u4E0D\u8FDB cycles \u2014\u2014 \u5B83\u8BF4\u660E**\u884C\u7EA7**\u6709\u7236\u5B50\u5E8F\uFF0C\u6A21\u578B\u7EA7\u5E76\u4E0D\u963B\u585E\uFF0C\u7167\u6837\u8FDB waves\uFF1Bunordered = \u5377\u8FDB cycles \u56E0\u800C\u5B9A\u4E0D\u51FA\u987A\u5E8F\u7684\u6A21\u578B\uFF0C\u5B83\u4EEC**\u4E0D\u5728** waves \u91CC\uFF0C\u628A\u5B83\u4EEC\u585E\u8FDB waves \u7B49\u4E8E\u5047\u88C5\u5B9A\u5F97\u51FA\u987A\u5E8F\uFF1BblockedByCycles = \u81EA\u5DF1\u4E0D\u5728\u73AF\u91CC\u3001\u4F46\uFF08\u4F20\u9012\u5730\uFF09\u4F9D\u8D56\u67D0\u4E2A\u73AF\u6210\u5458\u7684\u6A21\u578B\uFF1BexcludedEdges = \u6309\u5B57\u6BB5\u540D\u7EA6\u5B9A\uFF08createById / updateById\uFF09\u6392\u9664\u51FA\u4F9D\u8D56\u56FE\u7684\u5BA1\u8BA1\u8FB9\uFF0C\u539F\u6837\u7559\u7740\u53EF\u653E\u56DE\uFF0C\u{1F534} \u8FD9\u6761\u53E3\u5F84\u5728**\u672C\u6B21\u6570\u636E\u4E0A**\u503C\u591A\u5C11\uFF0C\u770B excludedEdges.impact\uFF08\u542B/\u4E0D\u542B\u5BA1\u8BA1\u8FB9\u5404\u73B0\u7B97\u4E00\u904D\uFF0C\u4E0D\u662F\u4EFB\u4F55\u4E00\u4E2A\u79DF\u6237\u7684\u5386\u53F2\u6570\u5B57\uFF09\uFF1BedgesOutsideNodes = \u4E24\u7AEF\u6709\u4E00\u5934\u4E0D\u5728\u672C\u6B21\u6A21\u578B\u540D\u518C\u91CC\u7684\u8FB9\uFF0C\u4E0D\u8FDB\u56FE\u4F46\u4E5F\u4E0D\u9759\u9ED8\u4E22\uFF0C\u540C\u6837\u539F\u6837\u7559\u7740\uFF1Bdangling = \u4EA7\u54C1\u58F0\u660E\u4E86\u5F15\u7528\u3001\u4F46\u8FD9\u4E2A\u5F15\u7528\u7528\u4E0D\u4E86\u7684\u5B57\u6BB5\uFF0C**\u4E24\u6863\uFF0C\u{1F534} \u6743\u5A01\u5224\u636E\u662F reason \u4E0D\u662F toModel**\uFF1Areason=not-in-registry \u65F6 toModel \u662F**\u771F\u7684\u6A21\u578B\u540D**\u3001\u53EA\u662F\u4E0D\u5728 /api/system/models \u540D\u518C\u91CC\uFF08\u5B9E\u6D4B 4 \u4E2A\uFF1AImpactRecord / JobFamily / PerfAssessDimensionInstance / UserModel\uFF09\uFF0C\u7167\u7740\u586B\u4F1A\u62FF\u5230 400\uFF1Breason=malformed-target \u65F6\u4EA7\u54C1\u7ED9\u7684\u76EE\u6807\u5F62\u6001\u5C31\u662F\u574F\u7684\uFF08object={"a":1} / 5 / ["T"] \u4E4B\u7C7B\uFF09\uFF0C\u6B64\u65F6 toModel \u5B58\u7684\u662F **repr(\u539F\u503C)**\u3001\u662F kit \u5408\u6210\u7684\u5B57\u7B26\u4E32\uFF0C**\u4E0D\u662F\u6A21\u578B\u540D** \u2014\u2014 \u62FF\u5B83\u53BB\u67E5\u6A21\u578B\u53EA\u4F1A\u67E5\u5230\u4E00\u4E2A\u4E0D\u5B58\u5728\u7684\u540D\u5B57\uFF0C\u8BE5\u5B57\u6BB5\u6839\u672C\u6CA1\u6709\u53EF\u7528\u7684\u5F15\u7528\u76EE\u6807'
+);
+var NOTE = "\u6A21\u578B\u7EA7\u987A\u5E8F \u2260 \u884C\u7EA7\u987A\u5E8F\u3002\u6811\u5F62\u6570\u636E\uFF08\u7EC4\u7EC7\u3001\u5C97\u4F4D\u5E8F\u5217\uFF09\u7684\u884C\u5E8F\u8981\u770B\u540E\u7EED\u7684 work/import-plan.json\uFF1B\u672C\u6587\u4EF6\u53EA\u4FDD\u8BC1\u300C\u6A21\u578B A \u7684\u7B2C\u4E00\u884C\u5199\u4E4B\u524D\uFF0C\u6A21\u578B B \u5DF2\u7ECF\u5199\u5B8C\u300D\u3002waves \u91CC\u6CA1\u6709 cycles/unordered \u7684\u6210\u5458\uFF0C\u6CE2\u6B21\u7F16\u53F7\u4E5F**\u4E0D\u7ED9\u5B83\u4EEC\u7559\u7A7A\u6863** \u2014\u2014 \u6574\u5C42\u90FD\u662F\u73AF\u6210\u5458\u7684\u90A3\u4E00\u5C42\u4E0D\u4F1A\u51FA\u73B0\u5728 waves \u91CC\uFF0C\u6240\u4EE5 waves[0] \u672A\u5FC5\u662F\u300C\u53EF\u4EE5\u7B2C\u4E00\u4E2A\u5BFC\u300D\u7684\u90A3\u4E00\u6279\uFF1A\u5148\u770B\u5B83\u4E0E blockedByCycles \u6709\u6CA1\u6709\u4EA4\u96C6\u3002\u7167 waves \u987A\u5E8F\u6267\u884C\u524D\uFF0C\u5FC5\u987B\u5148\u6309\u4E24\u6BB5\u5F0F\uFF08\u5148\u63D2\u5165\u3001\u5F15\u7528\u5217\u7559\u7A7A\uFF0C\u518D\u56DE\u586B\uFF09\u628A cycles \u5904\u7406\u6389\u3002";
+var EXCLUDED_NOTE = "\u8FD9\u4E9B\u8FB9\u6309**\u5B57\u6BB5\u540D\u7EA6\u5B9A**\uFF08createById / updateById\uFF09\u6392\u9664\u51FA\u4F9D\u8D56\u56FE\u3002\u{1F534} \u4F9D\u636E\u53EA\u6709\u547D\u540D\u7EA6\u5B9A\uFF0C**\u4E0D\u662F\u4EA7\u54C1\u58F0\u660E**\uFF1A\u5B9E\u6D4B\u5168\u5E93 1476 \u4E2A\u8FD9\u6837\u7684\u5B57\u6BB5\uFF0CisReadonly / autoGenerate / isList / isInfo \u56DB\u4E2A\u6807\u5FD7\u5168\u90E8\u4E3A false\uFF0C\u5143\u6570\u636E\u91CC\u6CA1\u6709\u4EFB\u4F55\u53EF\u7F16\u7A0B\u5224\u636E\u80FD\u8BA4\u51FA\u300C\u8FD9\u662F\u670D\u52A1\u7AEF\u586B\u7684\u5BA1\u8BA1\u5B57\u6BB5\u300D\u3002\uFF08\u65C1\u8BC1\uFF1A\u6709\u4EBA\u5728\u73B0\u7F51 CO_0001 \u7684\u884C\u4E0A\u89C2\u5BDF\u5230 createById \u5168\u662F\u7CFB\u7EDF\u54E8\u5175 UUID 000\u2026001\uFF0C\u5F3A\u70C8\u63D0\u793A\u670D\u52A1\u7AEF\u586B\u5145 \u2014\u2014 \u4F46\u90A3\u662F**\u4ED6\u4EBA\u89C2\u5BDF\u3001\u672C\u5DE5\u5177\u672A\u590D\u6838**\uFF0C\u4E14 **recon \u8FD9\u6761\u8DEF**\u53EA\u8BFB\u4E0D\u5199\uFF0C**\u8BC1\u4E0D\u4E86**\uFF0C\u6240\u4EE5\u8FD9\u91CC\u4E0D\u628A\u5B83\u5F53\u7406\u7531\u3002\uFF09\u6392\u9664\u7684**\u6548\u679C**\u662F\u91CF\u5F97\u5230\u7684\uFF0C\u4E14**\u6BCF\u6B21\u8FD0\u884C\u73B0\u7B97**\uFF1A\u89C1\u540C\u7EA7\u7684 impact\u3002\u{1F534} \u5224\u5B9A\u987A\u5E8F\uFF1A\u5BA1\u8BA1\u5B57\u6BB5**\u5148\u5224**\uFF0C\u65E9\u4E8E\u81EA\u73AF\u5224\u5B9A\u4E0E\u540D\u518C\u5224\u5B9A \u2014\u2014 \u6240\u4EE5\u2460 `User.createById \u2192 User` \u8BB0\u5728\u8FD9\u91CC\u800C\u4E0D\u662F selfLoops\uFF08\u5426\u5219\u7B49\u4E8E\u51ED\u7A7A\u65AD\u8A00\u300CUser \u6709\u884C\u7EA7\u7236\u5B50\u5E8F\u300D\uFF09\uFF1B\u2461 \u4E00\u6761 createById \u6307\u5411\u540D\u518C\u5916\u76EE\u6807\u7684\u8FB9\u4E5F\u8BB0\u5728\u8FD9\u91CC\uFF0C**\u4E0D\u4F1A**\u51FA\u73B0\u5728 edgesOutsideNodes \u91CC\u3002\u{1F534} \u5982\u679C\u67D0\u4E2A\u5BA2\u6237\u73AF\u5883\u771F\u7684\u9700\u8981\u987E\u95EE\u81EA\u5DF1\u586B createById / updateById\uFF0C\u8FD9\u6279\u8FB9\u5C31\u5728\u540C\u7EA7\u7684 edges \u6570\u7EC4\u91CC\uFF0C\u952E\u4E0E refs \u4EA7\u51FA\u7684\u5F15\u7528\u8FB9\u9010\u5B57\u76F8\u540C\uFF08\u4E03\u952E\uFF1AfromModel / fromField / fieldName / toModel / carrier / labelField / labelFieldSource\uFF09\uFF0C\u653E\u56DE\u4F9D\u8D56\u56FE\u5373\u53EF \u2014\u2014 \u6392\u9664\u4E0D\u7B49\u4E8E\u4E22\u5F03\u3002";
+var OUTSIDE_NOTE = "\u8FB9\u7684\u4E00\u7AEF\u4E0D\u5728\u672C\u6B21\u6A21\u578B\u540D\u518C\u91CC\uFF1A\u4E0D\u8FDB\u4F9D\u8D56\u56FE\uFF08\u8FDB\u4E86\u4F1A\u51ED\u7A7A\u591A\u51FA\u4E00\u4E2A\u4E0D\u5B58\u5728\u7684\u8282\u70B9\uFF09\uFF0C\u4F46\u4E5F\u4E0D\u9759\u9ED8\u4E22 \u2014\u2014 \u9759\u9ED8\u4E22\u7684\u5F62\u6001\u662F edgeCount \u4E0E\u56FE\u91CC\u7528\u5230\u7684\u8FB9\u6570\u5BF9\u4E0D\u4E0A\uFF0C\u800C\u8FD9\u4E2A\u5DEE\u989D\u6CA1\u6709\u4EFB\u4F55\u4EBA\u770B\u5F97\u51FA\u6765\u3002\u540C\u7EA7\u7684 edges \u662F**\u539F\u6837**\u7684\u5F15\u7528\u8FB9\uFF08\u952E\u4E0E refs \u4EA7\u51FA\u7684\u5F15\u7528\u8FB9\u9010\u5B57\u76F8\u540C\uFF0C\u4E03\u952E\uFF09\uFF0C\u54EA\u4E00\u7AEF\u51FA\u754C\uFF0C\u62FF\u5B83\u7684 fromModel / toModel \u4E0E\u6A21\u578B\u540D\u518C\u6BD4\u4E00\u4E0B\u5373\u77E5\u3002\u6309\u7F16\u6392\uFF08modelKeys \u2287 metas \u7684\u952E\uFF0C\u4E14 refEdges \u5DF2\u628A\u300C\u76EE\u6807\u4E0D\u5728\u540D\u518C\u300D\u5206\u6D41\u8FDB dangling\uFF09\u8FD9\u91CC\u6052\u4E3A\u7A7A\uFF0C\u5B9E\u6D4B 0 \u6761\u3002";
+var REFERENCE_IMPACT = {
+  source: "\u79DF\u6237 13 / 742 \u4E2A\u6A21\u578B / 2923 \u6761\u8FB9\uFF0C2026-08-16 \u5B9E\u6D4B",
+  withAudit: { cycles: 4, cycleMembers: 22, selfLoops: 22, blockedByCycles: 717 },
+  withoutAudit: { cycles: 3, cycleMembers: 7, selfLoops: 21, blockedByCycles: 23 },
+  note: "\u{1F534} \u8FD9\u662F**\u53C2\u8003\u503C\uFF0C\u4E0D\u662F\u672C\u6B21\u7ED3\u679C** \u2014\u2014 \u672C\u6B21\u7684\u4E24\u7EC4\u6570\u5728\u540C\u7EA7\u7684 withAudit / withoutAudit \u91CC\u3002\u5728\u90A3\u4E2A\u79DF\u6237\u4E0A\uFF0C\u542B\u5BA1\u8BA1\u8FB9\u65F6 742 \u4E2A\u6A21\u578B\u6709 717 \u4E2A\uFF0896%\uFF09\u88AB\u73AF\u6321\u4F4F\u3001\u4EA7\u7269\u7B49\u4E8E\u6CA1\u7528\uFF1B\u6392\u9664\u540E\u53EA\u5269 23 \u4E2A\u3002\u522B\u62FF\u8FD9\u7EC4\u6570\u53BB\u89E3\u91CA\u4F60\u624B\u4E0A\u8FD9\u4EFD\u4EA7\u7269\u3002"
+};
+function analyze(edges, nodes, nodeSet, excludeAudit) {
+  const deps = new Map(nodes.map((n) => [n, /* @__PURE__ */ new Set()]));
+  const selfLoops = /* @__PURE__ */ new Set();
+  const outside = [];
+  const excluded = [];
+  for (const e of edges) {
+    const a = e.fromModel;
+    const b = e.toModel;
+    if (excludeAudit && AUDIT_SET.has(e.fromField)) {
+      excluded.push(e);
+      continue;
+    }
+    if (!nodeSet.has(a) || !nodeSet.has(b)) {
+      outside.push(e);
+      continue;
+    }
+    if (a === b) {
+      selfLoops.add(a);
+      continue;
+    }
+    deps.get(a).add(b);
+  }
+  const comps = tarjan(nodes, deps);
+  const compOf = /* @__PURE__ */ new Map();
+  comps.forEach((comp, i) => comp.forEach((m) => compOf.set(m, i)));
+  const cyclicComps = new Set(comps.map((c, i) => c.length > 1 ? i : -1).filter((i) => i >= 0));
+  const cycles = [...cyclicComps].map((i) => comps[i]).sort(compareStringArrays);
+  const unordered = [...cyclicComps].flatMap((i) => comps[i]).sort();
+  const cyclic = new Set(unordered);
+  const compDeps = new Map(comps.map((_, i) => [i, /* @__PURE__ */ new Set()]));
+  for (const n of nodes) {
+    const ci = compOf.get(n);
+    for (const d of deps.get(n)) {
+      const cj = compOf.get(d);
+      if (cj !== ci) compDeps.get(ci).add(cj);
+    }
+  }
+  const remaining = new Map([...compDeps].map(([i, v]) => [i, new Set(v)]));
+  const levelOf = /* @__PURE__ */ new Map();
+  let level = 0;
+  for (let round = 0; round <= comps.length; round += 1) {
+    if (remaining.size === 0) break;
+    const ready = [...remaining].filter(([, d]) => d.size === 0).map(([i]) => i);
+    if (ready.length === 0) {
+      const stuck = [...remaining.keys()].map((i) => comps[i]).sort(compareStringArrays);
+      throw new Error(
+        `\u62D3\u6251\u5206\u6CE2\u5361\u4F4F\uFF1A\u7F29\u70B9\u56FE\u91CC\u4ECD\u7136\u5B58\u5728\u73AF\uFF0C\u8BF4\u660E tarjan \u7ED9\u51FA\u7684\u5206\u91CF\u4E0D\u662F\u5F3A\u8FDE\u901A\u5206\u91CF\uFF08\u4E92\u76F8\u4F9D\u8D56\u7684\u6A21\u578B\u6CA1\u88AB\u6536\u8FDB\u540C\u4E00\u4E2A\u5206\u91CF\uFF09\u3002\u5269\u4F59\u5206\u91CF\uFF1A${JSON.stringify(stuck)}\u3002\u4EA7\u7269\u4E0D\u53EF\u4FE1`
+      );
+    }
+    for (const i of ready) {
+      levelOf.set(i, level);
+      remaining.delete(i);
+    }
+    const readySet = new Set(ready);
+    for (const d of remaining.values()) for (const r of readySet) d.delete(r);
+    level += 1;
+  }
+  if (remaining.size > 0) {
+    throw new Error(
+      `\u62D3\u6251\u5206\u6CE2\u5728 ${comps.length + 1} \u8F6E\u5185\u6CA1\u6709\u51FA\u6E05\uFF0C\u5269\u4F59\u5206\u91CF ${JSON.stringify([...remaining.keys()].map((i) => comps[i]).sort(compareStringArrays))}\uFF1B\u5206\u6CE2\u4E0E SCC \u8BA1\u7B97\u4E0D\u4E00\u81F4\uFF0C\u4EA7\u7269\u4E0D\u53EF\u4FE1`
+    );
+  }
+  const blockedComps = /* @__PURE__ */ new Set();
+  for (const i of [...comps.keys()].sort((x, y) => levelOf.get(x) - levelOf.get(y))) {
+    if ([...compDeps.get(i)].some((j) => cyclicComps.has(j) || blockedComps.has(j))) blockedComps.add(i);
+  }
+  const buckets = /* @__PURE__ */ new Map();
+  for (const n of nodes) {
+    if (cyclic.has(n)) continue;
+    const lv = levelOf.get(compOf.get(n));
+    if (!buckets.has(lv)) buckets.set(lv, []);
+    buckets.get(lv).push(n);
+  }
+  const waves = [...buckets.keys()].sort((a, b) => a - b).map((lv) => buckets.get(lv).sort());
+  return {
+    selfLoops: [...selfLoops].sort(),
+    cycles,
+    unordered,
+    waves,
+    blockedByCycles: nodes.filter((m) => !cyclic.has(m) && blockedComps.has(compOf.get(m))).sort(),
+    excluded,
+    outside
+  };
+}
+function impactOf(r) {
+  return {
+    cycles: r.cycles.length,
+    cycleMembers: r.unordered.length,
+    selfLoops: r.selfLoops.length,
+    blockedByCycles: r.blockedByCycles.length
+  };
+}
+var NO_META_NOTE = "\u8FD9\u4E9B\u6A21\u578B\u5728\u540D\u518C\u91CC\u3001\u4F46**\u672C\u8F6E\u6CA1\u62FF\u5230 meta**\uFF08\u591A\u4E3A HTTP 404 \u7684 `*Index` \u578B\u9690\u85CF\u6A21\u578B\uFF0C\u8BE6\u89C1 unavailable.json\uFF09\u3002\u21D2 \u5B83\u4EEC\u7684**\u51FA\u8FB9\u4E0D\u53EF\u77E5**\uFF1A\u56FE\u91CC\u770B\u7740\u6CA1\u6709\u4F9D\u8D56\uFF0C\u53EA\u662F\u56E0\u4E3A\u6211\u4EEC\u6CA1\u8BFB\u5230\u5B83\u4EEC\u7684\u5B57\u6BB5\u3002\u{1F534} \u5B83\u4EEC\u7167\u6837\u5728 waves \u91CC\uFF08\u5220\u6389\u7B49\u4E8E\u5047\u88C5\u540D\u518C\u91CC\u6CA1\u8FD9\u4E2A\u6A21\u578B\uFF09\uFF0C\u800C waves \u91CC\u300C\u771F\u7684\u65E0\u4F9D\u8D56\u300D\u4E0E\u300C\u51FA\u8FB9\u4E0D\u53EF\u77E5\u300D**\u540C\u5F62** \u2014\u2014 \u7167 waves[0] \u5148\u5BFC\u5B83\u4EEC\uFF0C\u53EF\u80FD\u5BFC\u5230\u4E00\u534A\u624D\u53D1\u73B0\u6709\u4F9D\u8D56\u3002\u8981\u5224\u65AD\u67D0\u4E2A wave \u6210\u5458\u53EF\u4E0D\u53EF\u4FE1\uFF0C**\u5148\u548C\u8FD9\u4EFD\u540D\u5355\u53D6\u4EA4\u96C6**\u3002";
+var NO_META_UNKNOWN_NOTE = "\u8C03\u7528\u65B9**\u6CA1\u544A\u8BC9**\u672C\u6A21\u5757\u54EA\u4E9B\u6A21\u578B\u62FF\u5230\u4E86 meta\uFF08`modelsWithMeta` \u672A\u63D0\u4F9B\uFF09\u21D2 \u672C\u8F6E\u65E0\u4ECE\u5224\u65AD\u6709\u6CA1\u6709\u300C\u51FA\u8FB9\u4E0D\u53EF\u77E5\u300D\u7684\u8282\u70B9\u3002`null` \u662F\u300C\u4E0D\u77E5\u9053\u300D\uFF0C**\u4E0D\u662F**\u300C\u4E00\u4E2A\u90FD\u6CA1\u6709\u300D\u2014\u2014 \u540E\u8005\u662F `count: 0` + \u7A7A\u5217\u8868\u3002";
+function buildTopology(edges, dangling, modelKeys2, modelsWithMeta) {
+  const nodes = [...new Set(modelKeys2)].sort();
+  const nodeSet = new Set(nodes);
+  const kept = analyze(edges, nodes, nodeSet, true);
+  const withAudit = analyze(edges, nodes, nodeSet, false);
+  let noMeta;
+  if (modelsWithMeta === void 0 || modelsWithMeta === null) {
+    noMeta = { count: null, models: null, note: NO_META_UNKNOWN_NOTE };
+  } else {
+    const seen = new Set(modelsWithMeta);
+    const missing = nodes.filter((n) => !seen.has(n));
+    noMeta = { count: missing.length, models: missing, note: NO_META_NOTE };
+  }
+  return {
+    crawled: true,
+    wording: WORDING2,
+    nodeCount: nodes.length,
+    // 🔴 「出边不可知」的节点。恒发键：缺席会被读成「这个工具还不懂这一档」，
+    // 而 `null` 与 `[]` 又是两个不同的事实（见上方两条 note）。
+    nodesWithoutMeta: noMeta,
+    // 🔴 边总数按**传入的边**记，不按图里用掉的边记：两者的差额是
+    // excludedEdges + edgesOutsideNodes + 自环，全部摆在同一份产物里才对得上账。
+    edgeCount: edges.length,
+    selfLoops: kept.selfLoops,
+    cycles: kept.cycles,
+    waves: kept.waves,
+    unordered: kept.unordered,
+    blockedByCycles: kept.blockedByCycles,
+    excludedEdges: {
+      count: kept.excluded.length,
+      // 依据写成机器可读的一档，下游要放回去时不必去解析中文。
+      basis: "field-name-convention",
+      fieldKeys: [...AUDIT_FIELD_KEYS],
+      note: EXCLUDED_NOTE,
+      impact: {
+        withAudit: impactOf(withAudit),
+        withoutAudit: impactOf(kept),
+        note: "\u4E24\u7EC4\u6570\u90FD\u662F**\u672C\u6B21\u73B0\u7B97**\u7684\uFF1A\u540C\u4E00\u4EFD\u8FB9\u96C6\u3001\u540C\u4E00\u6BB5\u4EE3\u7801\uFF0C\u4E00\u6B21\u542B\u5BA1\u8BA1\u8FB9\u3001\u4E00\u6B21\u6392\u9664\uFF0C\u5DEE\u989D\u5C31\u662F\u8FD9\u6761\u53E3\u5F84\u5728**\u4F60\u624B\u4E0A\u8FD9\u4EFD\u6570\u636E**\u4E0A\u7684\u4EE3\u4EF7\u3002reference \u662F\u53E6\u4E00\u4E2A\u79DF\u6237\u7684\u53C2\u8003\u503C\uFF0C\u4E0D\u662F\u672C\u6B21\u7ED3\u679C\u3002",
+        reference: REFERENCE_IMPACT
+      },
+      // 原样，键与 refEdges 产出的引用边逐字相同（七键）—— 放得回去
+      edges: kept.excluded
+    },
+    edgesOutsideNodes: {
+      count: kept.outside.length,
+      note: OUTSIDE_NOTE,
+      edges: kept.outside
+      // 原样，同 excludedEdges 一个形状
+    },
+    dangling: [...dangling],
+    note: NOTE
+  };
+}
+function writeTopology(layout, topo) {
+  return layout.writeJson("topology.json", topo);
+}
+
+// src/fde/recon/mapping.ts
+var AUDIT_SET2 = new Set(AUDIT_FIELD_KEYS);
+var MUTATION_PATH = (model) => `/api/models/${model}/mutation-capability`;
+var MUTATION_OPS = ["create", "update", "delete", "batch_delete"];
+var NOT_QUERIED = "\u672C\u8F6E\u6CA1\u6709\u67E5\u8BE2\u8BE5\u6A21\u578B\u7684 mutation-capability";
+var BATCH_LOST = "\u5DF2\u968F\u5E76\u53D1\u6279\u6B21\u53D1\u51FA\uFF0C\u4F46\u6279\u6B21\u7ED3\u679C\u91CC\u6CA1\u6709\u8FD9\u4E2A\u6A21\u578B \u2014\u2014 \u7ED3\u679C\u4E22\u4E86\uFF0C\u65E2\u4E0D\u662F\u670D\u52A1\u7AEF\u62D2\u7B54\u3001\u4E5F\u4E0D\u662F\u672C\u8F6E\u6CA1\u67E5\uFF0C\u91CD\u8DD1\u4E00\u8F6E\u5373\u53EF";
+var badSection = (t) => `\u4F20\u5165\u7684 mutation \u6BB5\u4E0D\u662F\u5BF9\u8C61\uFF08${t}\uFF09\uFF0C\u65E0\u6CD5\u5224\u8BFB`;
+var badCell = (op, t) => `\u4F20\u5165\u7684 mutation \u91CC ${op} \u8FD9\u4E00\u9879\u4E0D\u662F\u5BF9\u8C61\uFF08${t}\uFF09\uFF0C\u65E0\u6CD5\u5224\u8BFB`;
+var missingCell = (op) => `\u4F20\u5165\u7684 mutation \u91CC\u6CA1\u6709 ${op} \u8FD9\u4E00\u9879`;
+var WORDING3 = 'writable=false \u7684\u4E24\u79CD\u539F\u56E0\uFF1Aderived:<kind>\uFF08\u6D3E\u751F\u5B57\u6BB5\uFF0C\u670D\u52A1\u7AEF\u7B97\u51FA\u6765\u7684\uFF09\u3001readonly\uFF08\u5143\u6570\u636E\u58F0\u660E\u53EA\u8BFB\uFF09\u3002autoGenerate=true \u7684\u5B57\u6BB5\uFF08\u5DE5\u53F7 / \u7EC4\u7EC7 / \u5C97\u4F4D / \u6CD5\u4EBA\u7F16\u7801\u7B49\uFF09**\u4E0D\u662F**\u4E0D\u53EF\u5199\uFF1A\u670D\u52A1\u7AEF\u53EA\u5728\u5B57\u6BB5\u4E3A\u7A7A\u65F6\u751F\u6210\uFF0C\u8C03\u7528\u65B9\u624B\u5DE5\u6307\u5B9A\u7684\u503C\u4F18\u5148 \u2014\u2014 \u7531\u72EC\u7ACB\u6807\u8BB0 `autoGeneratedIfAbsent` \u70B9\u540D\uFF08\u4E0D\u9001\u5219\u751F\u6210\u3001\u9001\u5219\u91C7\u7EB3\uFF09\uFF0C\u4E0D\u518D\u8FDB notWritableReason\u3002\u{1F534} writable=true **\u53EA\u8868\u793A\u5143\u6570\u636E\u6CA1\u58F0\u660E\u8FD9\u4E24\u79CD\u4E0D\u53EF\u5199**\uFF0C\u4E0D\u8868\u793A\u8FD9\u4E2A\u5B57\u6BB5\u8BE5\u7531\u987E\u95EE\u586B \u2014\u2014 \u5B9E\u6D4B createById / updateById \u8FD9 1476 \u4E2A\u5BA1\u8BA1\u5B57\u6BB5\u56DB\u4E2A\u6807\u5FD7\u5168\u662F false\uFF0C\u7167\u6837\u662F writable=true\uFF0C\u5B83\u4EEC\u7531 ref.auditBackref=true \u70B9\u540D\uFF08topology \u628A\u540C\u4E00\u6279\u8FB9\u6392\u9664\u51FA\u4F9D\u8D56\u56FE\uFF0C\u8FD9\u91CC\u4E0D\u6392\u9664\uFF1Amapping \u662F\u5B57\u6BB5\u6E05\u5355\uFF0C\u4E0D\u662F\u4F9D\u8D56\u56FE\uFF09\u3002ref.valueDomain \u53EA\u5728\u76EE\u6807\u662F\u7801\u8868\uFF08DYNAMIC / CO_*\uFF09\u65F6\u7ED9\u51FA\uFF1B\u6307\u5411\u4E1A\u52A1\u6A21\u578B\u65F6\u4E3A null \u2014\u2014 \u5B9E\u6D4B 234 \u4E2A\u58F0\u660E\u51FA\u6765\u7684\u5F15\u7528\u76EE\u6807\u91CC\uFF0C230 \u4E2A\u5728\u540D\u518C\u4E2D\uFF1A\u5176\u4E2D 32 \u4E2A\u662F\u7801\u8868\u3001198 \u4E2A\u662F\u4E1A\u52A1\u6A21\u578B\uFF08User 1564 / OrgUnit 292 / Employee 199 \u2026\uFF09\u8981\u6309\u4E1A\u52A1\u952E\u73B0\u67E5\uFF1B\u53E6\u6709 4 \u4E2A\u60AC\u7A7A\u76EE\u6807\uFF08\u58F0\u660E\u4E86\u5F15\u7528\u4F46\u4E0D\u5728 /api/system/models \u540D\u518C\u91CC\uFF0C\u89C1 topology.json \u7684 dangling\uFF09\u3002valuedomain \u91CC\u6CA1\u6709\u4E1A\u52A1\u6A21\u578B\u7684\u5BF9\u7167\u8868\uFF0C\u6307\u4E00\u4E2A\u4E0D\u5B58\u5728\u7684\u6587\u4EF6\u6BD4\u4E0D\u6307\u66F4\u7CDF\uFF1A\u987E\u95EE\u4F1A\u4EE5\u4E3A\u90A3\u4EFD\u5BF9\u7167\u8868\u53EA\u662F\u8FD8\u6CA1\u751F\u6210\u3002ref.labelFieldSource=unknown \u8868\u793A\u4EA7\u54C1\u6CA1\u58F0\u660E\u663E\u793A\u5B57\u6BB5\u540D\uFF08\u5B9E\u6D4B\u8FDB\u56FE\u7684 2923 \u6761\u8FB9\u91CC 1366 \u6761\u6CA1\u58F0\u660E\uFF09\uFF0C**\u4E0D\u662F**\u300C\u9ED8\u8BA4\u7528 name\u300D\u2014\u2014 \u90A3 1366 \u6761\u6307\u5411 224 \u4E2A\u5728\u518C\u76EE\u6807\uFF0C\u5176\u4E2D 60 \u4E2A\uFF0827%\uFF0C\u76EE\u6807\u6A21\u578B\u53E3\u5F84\uFF09\u8FDE name \u5B57\u6BB5\u90FD\u6CA1\u6709\uFF0C\u6309\u8FB9\u7B97 152 \u6761\uFF0811%\uFF0C\u5B57\u6BB5\u53E3\u5F84\uFF09\u843D\u5728\u5B83\u4EEC\u8EAB\u4E0A\u3002mutation.allowed \u6052\u4E3A\u4E09\u4E2A\u503C\u4E4B\u4E00\uFF1Atrue / false / "unknown"\u3002"unknown" \u8868\u793A\u8BE5\u6A21\u578B\u8FD9\u4E00\u9879\u6CA1\u67E5\u5230\uFF0C**\u4E0D\u662F**\u300C\u5141\u8BB8\u300D\uFF1B\u5177\u4F53\u662F\u54EA\u4E00\u79CD\u6CA1\u67E5\u5230\u770B reason\uFF08\u670D\u52A1\u7AEF\u4FA7\uFF1A\u6CA1\u5E94\u7B54 / \u54CD\u5E94\u7F3A\u8FD9\u4E00\u9879 / allowed \u4E0D\u662F\u5E03\u5C14\uFF1B\u5DE5\u5177\u4FA7\uFF1A\u5E76\u53D1\u6279\u6B21\u91CC\u6CA1\u62FF\u5230\u8FD9\u4E2A\u6A21\u578B\u7684\u7ED3\u679C\uFF1B\u8C03\u7528\u65B9\u4FA7\uFF1A\u672C\u8F6E\u6CA1\u67E5 / \u4F20\u5165\u7684 mutation \u6BB5\u4E0D\u662F\u5BF9\u8C61 / \u4F20\u5165\u7684\u8FD9\u4E00\u9879\u4E0D\u662F\u5BF9\u8C61 / \u4F20\u5165\u7684\u91CC\u6CA1\u6709\u8FD9\u4E00\u9879 \u2014\u2014 \u516B\u79CD\u6210\u56E0\u63AA\u8F9E\u5404\u4E0D\u76F8\u540C\uFF0C\u300C\u4F20\u5165\u7684\u300D\u5F00\u5934\u7684\u662F\u62FC\u8FD9\u4EFD\u57FA\u7EBF\u7684\u4EBA\u641E\u9519\u4E86\uFF0C\u4E0D\u662F\u670D\u52A1\u7AEF\uFF09\u3002enumCount \u6570\u7684\u662F\u8BE5\u5B57\u6BB5\u5019\u9009\u503C\u7684**\u5143\u7D20\u4E2A\u6570**\uFF0C\u4E0E index/fields.jsonl \u91CC\u8BE5\u5B57\u6BB5\u7684 enums \u884C\u6570\u76F8\u7B49\u3002';
+function isRecord2(v) {
+  return Boolean(v) && typeof v === "object" && !Array.isArray(v);
+}
+function typeName2(v) {
+  if (v === null) return "null";
+  if (Array.isArray(v)) return "list";
+  return typeof v;
+}
+async function collectMutation(probe, modelKeys2) {
+  const keys = [...new Set(modelKeys2)].sort();
+  const paths = /* @__PURE__ */ new Map();
+  for (const k of keys) paths.set(MUTATION_PATH(k), k);
+  const results = probe.getMany ? await probe.getMany([...paths.keys()]) : await sequentialGet(probe, [...paths.keys()]);
+  const mutation = {};
+  const problems = [];
+  for (const [path12, key] of paths) {
+    const out = results[path12];
+    if (out === void 0) {
+      problems.push(`${key}: mutation-capability ${BATCH_LOST}`);
+      mutation[key] = Object.fromEntries(
+        MUTATION_OPS.map((op) => [op, { allowed: "unknown", reason: BATCH_LOST }])
+      );
+      continue;
+    }
+    const body = out.error === "ok" ? out.body : null;
+    if (!isRecord2(body)) {
+      const reason = `\u672A\u5E94\u7B54\uFF08HTTP ${out.status} / ${out.error}\uFF09`;
+      problems.push(`${key}: mutation-capability ${reason}`);
+      mutation[key] = Object.fromEntries(MUTATION_OPS.map((op) => [op, { allowed: "unknown", reason }]));
+      continue;
+    }
+    const entry = {};
+    for (const op of MUTATION_OPS) {
+      const cell = body[op];
+      if (!isRecord2(cell) || !("allowed" in cell)) {
+        entry[op] = { allowed: "unknown", reason: `\u54CD\u5E94\u91CC\u6CA1\u6709 ${op} \u8FD9\u4E00\u9879` };
+        problems.push(`${key}: mutation-capability \u54CD\u5E94\u7F3A ${op}`);
+        continue;
+      }
+      const allowed = cell.allowed;
+      if (typeof allowed !== "boolean") {
+        entry[op] = { allowed: "unknown", reason: `allowed \u4E0D\u662F\u5E03\u5C14\uFF08${JSON.stringify(allowed)}\uFF09\uFF0C\u65E0\u6CD5\u5224\u8BFB` };
+        problems.push(`${key}: mutation-capability \u7684 ${op} \u9879 allowed \u4E0D\u662F\u5E03\u5C14\uFF08${JSON.stringify(allowed)}\uFF09`);
+        continue;
+      }
+      entry[op] = { allowed, reason: cell.reason ?? null };
+    }
+    mutation[key] = entry;
+  }
+  return { mutation, problems };
+}
+function mutationSection(entry) {
+  if (entry === void 0 || entry === null) {
+    return Object.fromEntries(MUTATION_OPS.map((op) => [op, { allowed: "unknown", reason: NOT_QUERIED }]));
+  }
+  if (!isRecord2(entry)) {
+    const reason = badSection(typeName2(entry));
+    return Object.fromEntries(MUTATION_OPS.map((op) => [op, { allowed: "unknown", reason }]));
+  }
+  const section = {};
+  for (const op of MUTATION_OPS) {
+    const cell = entry[op];
+    if (isRecord2(cell)) {
+      section[op] = cell;
+    } else if (op in entry) {
+      section[op] = { allowed: "unknown", reason: badCell(op, typeName2(cell)) };
+    } else {
+      section[op] = { allowed: "unknown", reason: missingCell(op) };
+    }
+  }
+  return section;
+}
+function writability(field) {
+  const derived = field.derived;
+  if (derived) {
+    const kind = isRecord2(derived) ? derived.kind : null;
+    return { writable: false, reason: `derived:${typeof kind === "string" && kind ? kind : "unknown"}` };
+  }
+  if (field.isReadonly) return { writable: false, reason: "readonly" };
+  return { writable: true, reason: null };
+}
+function buildMapping(metas, edges, mutation, codeTables = []) {
+  const codeSet = new Set(codeTables);
+  const byField = /* @__PURE__ */ new Map();
+  for (const e of edges) byField.set(`${e.fromModel} ${e.fromField}`, e);
+  const sheets = [];
+  for (const modelKey of Object.keys(metas).sort()) {
+    const { fields, problem } = metaFields(metas[modelKey]);
+    const rows = [];
+    for (const f of fields) {
+      if (!isRecord2(f)) continue;
+      const key = f.key;
+      if (typeof key !== "string" || !key) continue;
+      const { writable, reason } = writability(f);
+      const edge = byField.get(`${modelKey} ${key}`);
+      const ref = edge ? {
+        toModel: edge.toModel,
+        carrier: edge.carrier,
+        // labelField / labelFieldSource 原样透传：没声明就是 null + "unknown"，
+        // 不许在这里兜底成 "name"（实测 60 个目标模型连 name 字段都没有）。
+        labelField: edge.labelField,
+        labelFieldSource: edge.labelFieldSource,
+        valueDomain: codeSet.has(edge.toModel) ? `valuedomain/${edge.toModel}.json` : null,
+        // 依据只有**字段名约定**，与 topology 同源、口径也同 —— 不是产品声明：
+        // 实测这 1476 个字段的 isReadonly/autoGenerate/isList/isInfo 全为 false。
+        auditBackref: AUDIT_SET2.has(key)
+      } : null;
+      const enums = f.enums;
+      rows.push({
+        key,
+        // 🔴 中文名的键是 `name`，**不是 `label`**；必填的键是 `isRequired`，**不是 `required`**。
+        // 接错不报错也不崩，产物里只是「全是英文键名」或「一个字段都不必填」。
+        name: f.name ?? "",
+        type: f.type ?? "",
+        required: Boolean(f.isRequired),
+        writable,
+        notWritableReason: reason,
+        // 🔴 autoGenerate=true 的字段**可以**由调用方指定 —— 服务端只在字段为空时才生成。
+        // 这是 writable=true 之外的一道**独立标记**，避免把编码当成只读而漏发、导致业务键漂移。
+        autoGeneratedIfAbsent: Boolean(f.autoGenerate),
+        ref,
+        // 🔴 数**全部元素**，不是「形状认得出的那些」。`fields` 侧对非对象元素也逐个产出一行
+        // （带 `_kitValueSource` 认领），这里若只数对象，一个 `enums: ["A","B"]` 的字段
+        // 在 mapping 里就是 enumCount=0 —— 与「这个字段没有候选值」同形，
+        // 而 index/fields.jsonl 里明明有两行。
+        enumCount: Array.isArray(enums) ? enums.length : 0
+      });
+    }
+    sheets.push({
+      model: modelKey,
+      // 「爬过且这个模型确实没有字段」必须与「没爬过」（文件不存在）区分开。
+      crawled: true,
+      wording: WORDING3,
+      mutation: mutationSection(isRecord2(mutation) ? mutation[modelKey] : mutation),
+      fieldCount: rows.length,
+      // 🔴 `null` = 载荷判读正常（fieldCount=0 就是「这个模型确实没字段」）；
+      // 非 null = **爬过、但判不出字段**，此时 fieldCount=0 不代表「没字段」。
+      fieldsProblem: problem ?? null,
+      fields: rows
+    });
+  }
+  return sheets;
+}
+function allowedIn(sheet, op) {
+  const section = sheet.mutation;
+  const cell = isRecord2(section) ? section[op] : void 0;
+  return isRecord2(cell) ? cell.allowed : "unknown";
+}
+var PATH_SEPARATORS = ["/", String.fromCharCode(92)];
+function unsafeKeyReason(modelKey) {
+  if (typeof modelKey !== "string" || !modelKey) return `modelKey \u4E0D\u662F\u975E\u7A7A\u5B57\u7B26\u4E32\uFF08${JSON.stringify(modelKey)}\uFF09`;
+  if (PATH_SEPARATORS.some((s) => modelKey.includes(s))) {
+    return `modelKey \u542B\u8DEF\u5F84\u5206\u9694\u7B26\uFF0C\u4E0D\u80FD\u5F53\u6587\u4EF6\u540D\uFF1A${JSON.stringify(modelKey)}`;
+  }
+  if (modelKey === "." || modelKey === "..") return `modelKey \u6307\u5411\u76EE\u5F55\u672C\u8EAB\u6216\u4E0A\u7EA7\uFF1A${JSON.stringify(modelKey)}`;
+  if (modelKey.startsWith(".") || modelKey.startsWith("_")) {
+    return `modelKey \u4EE5 . \u6216 _ \u5F00\u5934\uFF0C\u4E0D\u80FD\u5F53\u6587\u4EF6\u540D\uFF1A${JSON.stringify(modelKey)} \u2014\u2014 \u524D\u8005\u4EA7\u51FA ls \u770B\u4E0D\u89C1\u7684\u9690\u85CF\u6587\u4EF6\u3001\u540E\u8005\u4F1A\u9876\u6389\u5DE5\u5177\u81EA\u5DF1\u7684 _index.json`;
+  }
+  return null;
+}
+function reasonTally(sheets) {
+  const tally = /* @__PURE__ */ new Map();
+  for (const sheet of sheets) {
+    for (const f of sheet.fields) {
+      const r = f.notWritableReason;
+      if (typeof r === "string" && r) tally.set(r, (tally.get(r) ?? 0) + 1);
+    }
+  }
+  return Object.fromEntries([...tally.entries()].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0));
+}
+function writeMapping(layout, sheets, opts = {}) {
+  const written = [];
+  const unsafe = [];
+  for (const sheet of sheets) {
+    const modelKey = sheet.model;
+    let reason = unsafeKeyReason(modelKey);
+    if (reason === null) {
+      try {
+        written.push(layout.writeJson(`mapping/${modelKey}.json`, sheet));
+        continue;
+      } catch (err) {
+        if (!(err instanceof LayoutContainmentError)) throw err;
+        reason = err.message;
+      }
+    }
+    unsafe.push({
+      model: typeof modelKey === "string" ? modelKey : JSON.stringify(modelKey),
+      reason,
+      fieldCount: sheet.fieldCount
+    });
+  }
+  written.push(
+    layout.writeJson("mapping/_index.json", {
+      crawled: true,
+      wording: WORDING3,
+      // 🔴 轮次身份。一轮 recon 被打断时，**这一份最容易留在上一轮**（它是编排里最后写的
+      // 几份之一）—— 而那时 `mapping/` 里缺某个模型，与「那个模型的 modelKey 不安全、
+      // 被拒写」同形。`null` = 调用方没告诉我，恒发键。
+      roundId: opts.roundId ?? null,
+      // 🔴 三份台账**恒发键**（null = 调用方没告诉我，[] = 对过账且一条都没有）。
+      // 明细与摘要两处都要有：只进摘要 ⇒ 产物被单独拷走后就没了；只进产物 ⇒
+      // 跑完那一刻看不见。少任何一处都等于没记。
+      problems: opts.problems ?? null,
+      danglingValueDomainPointers: opts.danglingValueDomain ?? null,
+      [KIT_CARRY_OVER_KEY]: opts.carryOver ?? null,
+      modelCount: sheets.length,
+      // 🔴 「有几个模型」与「有几份 sheet 文件」不是同一个数，差额就是下面这一档 ——
+      // 不点名的话，`ls mapping/ | wc -l` 与 modelCount 对不上而没人说得清为什么。
+      sheetsWritten: written.length,
+      unsafeModelKeys: unsafe,
+      notWritableByReason: reasonTally(sheets),
+      // 🔴 判据是 `=== false`，与下面 `mutationUnknown` 的补集判据**配成一个划分**。
+      // 它的牙来自那条**没经过归一的裸 null** 夹具：`!allowed` 对 null 为真，
+      // 于是同一个模型会同时落进 denied 和 unknown，划分不变量当场把它逮住。
+      mutationDenied: Object.fromEntries(
+        MUTATION_OPS.map((op) => [
+          op,
+          sheets.filter((s) => allowedIn(s, op) === false).map((s) => s.model).sort()
+        ])
+      ),
+      // 与 mutationDenied 同一批数据的另一面：没查到的那些必须也点名，
+      // 否则「不在 denied 里」会被读成「允许」。
+      //
+      // 🔴 判据是**补集**（既不是 true 也不是 false），不是 `=== 'unknown'`。
+      // 差别只在一种输入上，而那种输入是真实可达的：`collectMutation` 归一过的 mutation 里
+      // 只有三值，两种写法等价；但 `writeMapping` **不检查这个前提**，而喂给它的 mutation
+      // 完全可能没经过归一 —— 手拼、断点续跑从磁盘读回、定向重爬合并两轮结果，都是这条路。
+      // 那时一个 `{allowed: null}` 在 `=== 'unknown'` 的写法下两个清单都不进，**在索引里隐身**。
+      // 写成补集，划分在**取值域**上对任何调用方都自证。
+      // 🔴 措辞收窄过一次：补集只管**取值**，管不了 **cell 的形状** —— 未归一的调用方喂
+      // `{create: "yes"}`（cell 不是对象）时原先直接抛。形状那一半由 `mutationSection`
+      // （build 侧）与 `allowedIn`（本函数侧）两道闸补上，两半齐了「对任何调用方都自证」才是句实话。
+      mutationUnknown: Object.fromEntries(
+        MUTATION_OPS.map((op) => [
+          op,
+          sheets.filter((s) => {
+            const a = allowedIn(s, op);
+            return a !== true && a !== false;
+          }).map((s) => s.model).sort()
+        ])
+      )
+    })
+  );
+  return written;
+}
+
+// src/fde/recon/modelsmd.ts
+var SCOPE_NOTE = "\u95F8\u7684\u8986\u76D6\u9762\u662F **state-scoped**\uFF1A\u4EA7\u54C1\u91CC state \u4E0D\u53EF\u679A\u4E3E\uFF0C\u672C\u6587\u4EF6\u53EA\u53CD\u6620\u672C\u6B21\u722C\u53D6\u6240\u7528\u7684\u90A3\u4E00\u4E2A state\u3002\u9875\u7B7E\u7C7B\u95EE\u9898\u5FC5\u5148\u95EE state\uFF0C\u4E0D\u8981\u4FE1 base meta\u3002";
+var NO_GATE = "- \u58F0\u660E\u53EA\u8BFB\u7684\u52A8\u4F5C\uFF1A**\u672A\u53D1\u73B0\u58F0\u660E\u53EA\u8BFB\u7684\u52A8\u4F5C**\uFF08\u672A\u58F0\u660E = \u6309\u5199\u52A8\u4F5C\u5BF9\u5F85\uFF0C\u65E0\u8BBA\u5B83\u53EB preview \u8FD8\u662F check\uFF09";
+var FIELDS_NOT_CRAWLED = "- \u5B57\u6BB5\u6570\uFF1A\u672A\u722C\u53D6\uFF08\u8BE5\u6A21\u578B meta \u4E0D\u53EF\u7528\uFF0C\u8BE6\u89C1 unavailable.json\uFF09";
+var UNDECLARED = "\uFF08\u672A\u58F0\u660E\uFF09";
+var ORPHAN_TITLE = "## \u672A\u5F52\u5C5E\u7684\u53EA\u8BFB\u95F8";
+function gateDesc(gate) {
+  const label = gate.label || "";
+  const named = `\`${gate.key}\`` + (label ? ` \xB7 ${label}` : "");
+  const source = (gate.source ?? []).join("+") || UNDECLARED;
+  const guard = gate.guard || UNDECLARED;
+  return `${named}\uFF08source=${source}\uFF0Cguard=${guard}\uFF09`;
+}
+function renderModelsMd(modelsBody, metas, gates, dropped = []) {
+  const byModel = /* @__PURE__ */ new Map();
+  for (const g of gates) {
+    const list = byModel.get(g.model) ?? [];
+    list.push(g);
+    byModel.set(g.model, list);
+  }
+  const parts = [
+    "# \u6A21\u578B\u7D22\u5F15",
+    "",
+    `\u5171 ${modelsBody.totalCount ?? 0} \u4E2A\u6A21\u578B\uFF1B\u7C7B\u578B\u5206\u5E03 ${JSON.stringify(modelsBody.typeCounts ?? {})}\u3002`,
+    "",
+    SCOPE_NOTE,
+    "",
+    "\u5B57\u6BB5\u4E00\u884C\u4E00\u6761\u5728 `index/fields.jsonl`\uFF08\u6309\u4E2D\u6587\u540D / \u540C\u4E49\u8BCD grep \u5373\u53EF\u53CD\u67E5 model + key\uFF09\u3002",
+    ""
+  ];
+  if (dropped.length > 0) {
+    parts.push(
+      `> \u26A0\uFE0F \u6709 **${dropped.length}** \u4E2A\u5B57\u6BB5\u6CA1\u80FD\u8FDB \`index/fields.jsonl\`\uFF0C\u9010\u6761\u5982\u4E0B\uFF08\u5B83\u4EEC\u5728\u7D22\u5F15\u91CC\u4E0E\u300C\u4EA7\u54C1\u6CA1\u6709\u8FD9\u4E9B\u5B57\u6BB5\u300D\u540C\u5F62\uFF0C\u6240\u4EE5\u5FC5\u987B\u5728\u8FD9\u91CC\u70B9\u540D\uFF09\uFF1A`
+    );
+    for (const d of dropped) parts.push(`>   - ${d}`);
+    parts.push("");
+  }
+  const listed = /* @__PURE__ */ new Set();
+  for (const m of modelEntries(modelsBody)) {
+    const key = String(m.modelKey ?? "");
+    listed.add(key);
+    const name = m.name || "";
+    parts.push(name ? `## ${key} \xB7 ${name}` : `## ${key}`);
+    parts.push("");
+    parts.push(`- \u7C7B\u578B\uFF1A${m.type || UNDECLARED}`);
+    if (!Object.prototype.hasOwnProperty.call(metas, key)) {
+      parts.push(FIELDS_NOT_CRAWLED);
+    } else {
+      const { fields, problem } = metaFields(metas[key]);
+      parts.push(
+        problem === void 0 ? `- \u5B57\u6BB5\u6570\uFF1A${fields.length}` : `- \u5B57\u6BB5\u6570\uFF1A\u65E0\u6CD5\u5224\u8BFB\uFF08${problem}\uFF09\uFF0C\u8BE5\u6A21\u578B\u6CA1\u6709\u5B57\u6BB5\u8FDB\u7D22\u5F15`
+      );
+    }
+    const gs = byModel.get(key) ?? [];
+    if (gs.length > 0) {
+      parts.push("- \u58F0\u660E\u53EA\u8BFB\u7684\u52A8\u4F5C\uFF1A");
+      for (const g of gs) parts.push(`  - ${gateDesc(g)}`);
+    } else {
+      parts.push(NO_GATE);
+    }
+    parts.push("");
+  }
+  const orphans = gates.filter((g) => !listed.has(String(g.model ?? "")));
+  if (orphans.length > 0) {
+    parts.push(ORPHAN_TITLE);
+    parts.push("");
+    parts.push(
+      `\u4EE5\u4E0B **${orphans.length}** \u6761\u95F8\u7684\u6A21\u578B\u4E0D\u5728\u672C\u8F6E\u7684\u6A21\u578B\u6E05\u5355\u5185 \u2014\u2014 **\u4E3A\u4EC0\u4E48\u4E0D\u5728\uFF0C\u672C\u6A21\u5757\u6CA1\u6709\u67E5\u8FC7**\u3002\u{1F534} **\u522B\u8BFB\u6210\u300C\u53D1\u73B0\u4E86\u9690\u85CF\u6A21\u578B\u300D**\u3002\u5DF2\u77E5**\u81F3\u5C11**\u4E24\u6761\u8DEF\u957F\u6210\u8FD9\u6837\uFF08\u4E0D\u662F\u5168\u96C6\uFF09\uFF1A\u2460 \u6A21\u578B\u6E05\u5355\u672C\u8EAB\u6CA1\u53D6\u5168\uFF08\u6E05\u5355\u54CD\u5E94\u5F62\u72B6\u5F02\u5E38\u65F6\u4F1A\u56DE\u843D\u6210\u7A7A\u6E05\u5355\uFF09\uFF1B\u2461 \u8FD9\u51E0\u6761\u95F8\u662F**\u6CBF\u7528\u4E0A\u4E00\u8F6E\u4EA7\u7269**\u7684\uFF0C\u800C\u90A3\u4E00\u8F6E\u7684\u540D\u518C\u4E0E\u672C\u8F6E\u4E0D\u540C\uFF08\u89C1 \`gates.json\` \u7684 \`coverage._kitCarryOver\`\uFF09\u3002\u5148\u770B \`models.json\` \u7684 \`_kitPremiseCheck\`\u3002`
+    );
+    parts.push("");
+    for (const g of orphans) parts.push(`- \`${g.model || UNDECLARED}\` \xB7 ${gateDesc(g)}`);
+    parts.push("");
+  }
+  return parts.join("\n");
+}
+function writeModelsMd(layout, text) {
+  return layout.writeText("index/models.md", text);
+}
+
+// src/fde/recon/pointer-audit.ts
+import { existsSync as existsSync2 } from "fs";
+import * as path7 from "path";
+function isRecord3(v) {
+  return Boolean(v) && typeof v === "object" && !Array.isArray(v);
+}
+function auditValueDomainPointers(layout, sheets) {
+  const problems = [];
+  const seen = /* @__PURE__ */ new Map();
+  for (const sheet of sheets) {
+    for (const field of sheet.fields) {
+      const ref = field.ref;
+      const pointer = isRecord3(ref) ? ref.valueDomain : null;
+      if (typeof pointer !== "string" || pointer === "") continue;
+      if (!seen.has(pointer)) {
+        seen.set(pointer, existsSync2(path7.join(layout.dir, pointer)));
+      }
+      if (!seen.get(pointer)) {
+        problems.push(
+          `${sheet.model}.${String(field.key)}: ref.valueDomain \u6307\u5411 ${pointer}\uFF0C\u4F46\u8FD9\u4EFD\u5BF9\u7167\u8868\u6CA1\u6709\u843D\u76D8\uFF08\u60AC\u7A7A\u6307\u9488\uFF1A\u987E\u95EE\u4F1A\u4EE5\u4E3A\u5B83\u53EA\u662F\u8FD8\u6CA1\u751F\u6210\uFF09`
+        );
+      }
+    }
+  }
+  return problems;
+}
+
+// src/fde/recon/refs.ts
+var REF_CARRIERS = ["object", "refer"];
+function refEdges(metas, knownModels) {
+  const known = new Set(knownModels);
+  const edges = [];
+  const dangling = [];
+  for (const modelKey of Object.keys(metas).sort()) {
+    const { fields } = metaFields(metas[modelKey]);
+    for (const field of fields) {
+      if (!field || typeof field !== "object" || Array.isArray(field)) continue;
+      const rec = field;
+      const fieldKey = rec.key;
+      if (typeof fieldKey !== "string" || !fieldKey) continue;
+      const carrier = REF_CARRIERS.find((c) => rec[c]);
+      if (carrier === void 0) continue;
+      const target = rec[carrier];
+      if (typeof target !== "string") {
+        dangling.push({
+          fromModel: modelKey,
+          fromField: fieldKey,
+          toModel: reprOf(target),
+          carrier,
+          reason: "malformed-target"
+        });
+        continue;
+      }
+      if (!known.has(target)) {
+        dangling.push({ fromModel: modelKey, fromField: fieldKey, toModel: target, carrier, reason: "not-in-registry" });
+        continue;
+      }
+      const label = rec.objectLabel;
+      const declared = typeof label === "string" && label.length > 0;
+      edges.push({
+        fromModel: modelKey,
+        fromField: fieldKey,
+        // 🔴 字段中文名，是「grep 部门 → 落到 {model, key}」这条链上唯一的人话。
+        // 接错成 key 会让产物里全是英文键名——语法完好、不报错，
+        // 所以键集与取值都由「边的键集逐键钉死」那条用例守着。
+        fieldName: typeof rec.name === "string" ? rec.name : "",
+        toModel: target,
+        carrier,
+        // 🔴 没声明就是 null + "unknown"，**不许兜底成 "name"**：
+        // 「不知道」必须与「猜出来的名字」可分。
+        // 实测：2926 个 object 字段里只有 1557 个带 objectLabel；
+        // 剩下的指向的目标里 60 个 meta 拿得到但**没有 name 字段**。
+        // 落空时**不报错**——产物里会是一个语法完好、指向不存在列的显示字段名。
+        labelField: declared ? label : null,
+        labelFieldSource: declared ? "declared" : "unknown"
+      });
+    }
+  }
+  const byFrom = (a, b) => a.fromModel.localeCompare(b.fromModel) || a.fromField.localeCompare(b.fromField);
+  edges.sort(byFrom);
+  dangling.sort(byFrom);
+  return { edges, dangling };
+}
+function reprOf(v) {
+  if (typeof v === "string") return JSON.stringify(v);
+  if (v === void 0) return "undefined";
+  try {
+    return JSON.stringify(v) ?? String(v);
+  } catch {
+    return String(v);
+  }
+}
+
+// src/fde/recon/valuedomain.ts
+var COMPLETENESS = ["authoritative-complete", "visible-complete", "partial", "unavailable"];
+var PAGE_SIZE = 500;
+var DYNAMIC_TYPE = "DYNAMIC";
+var MAX_REQUESTS_PER_TABLE = 40;
+var MAX_SECONDS_PER_TABLE = 30;
+var WORDING4 = "rows = \u672C\u8F6E\u4EE5\u5F53\u524D\u767B\u5F55\u8EAB\u4EFD\u8BFB\u5230\u7684\u7801\u8868\u884C\uFF1B\u6BCF\u884C\u539F\u6837\u4FDD\u7559\u670D\u52A1\u7AEF\u8FD4\u56DE\u7684\u5168\u90E8\u952E\u3002\u5F15\u7528\u5B57\u6BB5\u5B58\u7684\u662F\u8FD9\u91CC\u7684 `id`\uFF0C\u4E0D\u662F `code`\u3002completeness: visible-complete = **\u5F53\u524D\u89D2\u8272\u53EF\u89C1\u8303\u56F4\u5185**\u53D6\u6EE1\uFF08\u4E0D\u662F\u5168\u96C6\uFF0CRBAC \u88C1\u526A\u5148\u4E8E count\uFF09\uFF1Bpartial = \u6CA1\u53D6\u6EE1\u6216\u6709\u9875\u5931\u8D25**\u6216\u89E6\u53D1\u4E86\u5DE5\u5177\u7684\u6BCF\u8868\u4E0A\u9650**\uFF08\u540E\u8005\u770B\u8FD9\u5F20\u8868\u7684 `truncatedBy`\uFF1Anull = \u6CA1\u89E6\u53D1\uFF0C\u5BF9\u8C61 = \u505C\u5728\u7B2C\u51E0\u9875 / \u5DF2\u6536\u591A\u5C11\u884C / \u89E6\u53D1\u7684\u662F\u54EA\u4E2A\u4E0A\u9650 \u2014\u2014 \u90A3\u662F**\u5DE5\u5177**\u7684\u622A\u65AD\uFF0C\u4E0D\u662F\u670D\u52A1\u7AEF\u7684\u6BDB\u75C5\uFF0C\u6539\u4E0A\u9650\u91CD\u8DD1\u5C31\u80FD\u53D6\u5168\uFF09\uFF1Bunavailable = \u8FDE\u8BA1\u6570\u90FD\u6CA1\u8BFB\u5230\uFF08crawled=false\uFF0C\u4E0E\u300C\u8FD9\u5F20\u7801\u8868\u662F\u7A7A\u7684\u300D\u662F\u4E24\u56DE\u4E8B\uFF09\uFF1Bauthoritative-complete = \u9700\u8981\u4EA7\u54C1\u4FA7\u6743\u5A01\u503C\u57DF\u51FA\u53E3\uFF0C**\u672C\u7248\u672C\u6C38\u8FDC\u4E0D\u4F1A\u4EA7\u51FA**\u3002partial / unavailable \u65F6\u7981\u6B62\u636E\u6B64\u751F\u6210\u5199\u811A\u672C\u3002";
+function listPath(modelKey) {
+  return `/api/models/${modelKey}/list/dsl`;
+}
+function isRecord4(v) {
+  return Boolean(v) && typeof v === "object" && !Array.isArray(v);
+}
+function readContent(body) {
+  if (!isRecord4(body)) return { rows: null, total: null, nonDict: 0 };
+  const rows = body.content;
+  const total = body.totalElements;
+  if (!Array.isArray(rows)) return { rows: null, total: null, nonDict: 0 };
+  if (typeof total !== "number" || !Number.isInteger(total) || total < 0) {
+    return { rows: null, total: null, nonDict: 0 };
+  }
+  const kept = rows.filter((r) => isRecord4(r));
+  return { rows: kept, total, nonDict: rows.length - kept.length };
+}
+async function collectCodeTables(probe, modelEntries2, opts = {}) {
+  const maxRequests = opts.maxRequests ?? MAX_REQUESTS_PER_TABLE;
+  const maxSeconds = opts.maxSeconds ?? MAX_SECONDS_PER_TABLE;
+  const tick = opts.clock ?? (() => performance.now() / 1e3);
+  const post = probe.post;
+  if (!post) throw new Error("\u63A2\u9488\u6CA1\u6709 post \u80FD\u529B\uFF0C\u53D6\u4E0D\u4E86 list/dsl \u2014\u2014 \u8FD9\u662F\u7F16\u6392\u7684\u914D\u7F6E\u9519\uFF0C\u4E0D\u662F\u6570\u636E\u95EE\u9898");
+  const tables = {};
+  const problems = [];
+  const keys = [];
+  for (const entry of modelEntries2) {
+    if (!isRecord4(entry) || entry.type !== DYNAMIC_TYPE) continue;
+    const key = entry.modelKey;
+    if (typeof key !== "string" || !key) {
+      problems.push(`\u540D\u518C\u91CC\u6709\u4E00\u6761 type=DYNAMIC \u7684\u6761\u76EE\u4F46 modelKey \u4E0D\u53EF\u7528\uFF08${JSON.stringify(key)}\uFF09\uFF0C\u5DF2\u8DF3\u8FC7`);
+      continue;
+    }
+    keys.push(key);
+  }
+  for (const key of [...new Set(keys)].sort()) {
+    const path12 = listPath(key);
+    const started = tick();
+    let requests = 0;
+    let truncatedBy = null;
+    const probeOut = await post.call(probe, path12, { page: 0, size: 0 });
+    requests += 1;
+    let total = null;
+    let reason = null;
+    if (probeOut.error !== "ok") {
+      reason = `\u8BA1\u6570\u63A2\u9488\u5931\u8D25\uFF08HTTP ${probeOut.status} / ${probeOut.error}\uFF09`;
+    } else {
+      total = readContent(probeOut.body).total;
+      reason = total !== null ? null : `\u8BA1\u6570\u63A2\u9488\u7B54\u4E86 HTTP ${probeOut.status} \u4F46\u54CD\u5E94\u5F62\u72B6\u4E0D\u5BF9\uFF08content \u4E0D\u662F\u6570\u7EC4 / totalElements \u4E0D\u662F\u975E\u8D1F\u6574\u6570\uFF09`;
+    }
+    if (total === null) {
+      problems.push(`${key}: ${reason}\uFF0C\u672C\u7801\u8868\u6807 unavailable`);
+      tables[key] = {
+        model: key,
+        crawled: false,
+        completeness: "unavailable",
+        totalElements: null,
+        rowsRetrieved: 0,
+        rows: [],
+        probeStatus: probeOut.status,
+        probeError: probeOut.error,
+        // 🔴 恒发键：这一档是「连计数都没读到」，与「取数时撞了上限」是两回事，
+        // 缺键会被读成「这个工具还不懂上限」。
+        truncatedBy: null,
+        wording: WORDING4
+      };
+      continue;
+    }
+    const rows = [];
+    let page = 0;
+    let failed = null;
+    const seenIds = /* @__PURE__ */ new Set();
+    let prevPage = null;
+    while (rows.length < total) {
+      const elapsed = tick() - started;
+      if (requests >= maxRequests || elapsed >= maxSeconds) {
+        const which = requests >= maxRequests ? "requests" : "wallclock";
+        truncatedBy = {
+          limit: which,
+          limitValue: which === "requests" ? maxRequests : maxSeconds,
+          requestsSent: requests,
+          elapsedSeconds: Math.round(elapsed * 1e3) / 1e3,
+          stoppedAtPage: page,
+          rowsRetrieved: rows.length,
+          totalElements: total
+        };
+        failed = `\u89E6\u53D1\u5DE5\u5177\u7684\u6BCF\u8868${which === "requests" ? "\u8BF7\u6C42" : "\u5899\u949F"}\u4E0A\u9650\uFF08${which === "requests" ? `\u5DF2\u53D1 ${requests} \u6B21\u8BF7\u6C42` : `\u5DF2\u82B1 ${elapsed.toFixed(3)}s`}\uFF09\uFF0C\u505C\u5728\u7B2C ${page} \u9875\uFF0C\u5DF2\u6536 ${rows.length} \u884C / \u8BA1\u6570 ${total} \u884C\uFF0C\u672C\u8868\u6807 partial\u3002**\u8FD9\u662F\u5DE5\u5177\u7684\u622A\u65AD\uFF0C\u4E0D\u662F\u670D\u52A1\u7AEF\u7684\u6BDB\u75C5** \u2014\u2014 \u8C03\u5927 valuedomain.${which === "requests" ? "MAX_REQUESTS_PER_TABLE" : "MAX_SECONDS_PER_TABLE"} \u6216\u7ED9 collectCodeTables \u4F20 ${which === "requests" ? "maxRequests" : "maxSeconds"} \u540E\u91CD\u8DD1\u5C31\u80FD\u53D6\u5168`;
+        break;
+      }
+      const out = await post.call(probe, path12, { page, size: PAGE_SIZE });
+      requests += 1;
+      if (out.error !== "ok") {
+        failed = `\u7B2C ${page} \u9875\u5931\u8D25\uFF08HTTP ${out.status} / ${out.error}\uFF09`;
+        break;
+      }
+      const { rows: got, total: pageTotal, nonDict } = readContent(out.body);
+      if (got === null) {
+        failed = `\u7B2C ${page} \u9875\u54CD\u5E94\u5F62\u72B6\u4E0D\u5BF9`;
+        break;
+      }
+      const pageIds = new Set(got.filter((r) => typeof r.id === "string").map((r) => r.id));
+      const serialized = JSON.stringify(got);
+      const allIdentifiable = pageIds.size > 0 && pageIds.size === got.length;
+      const noProgress = got.length > 0 && (allIdentifiable && [...pageIds].every((i) => seenIds.has(i)) || pageIds.size === 0 && prevPage !== null && serialized === prevPage);
+      if (pageTotal !== total) {
+        failed = `\u53D6\u6570\u671F\u95F4\u8BA1\u6570\u4ECE ${total} \u53D8\u6210 ${pageTotal}\uFF08\u6709\u4EBA\u5728\u5199\u8FD9\u5F20\u7801\u8868\uFF1F\u672C\u8F6E\u5FEB\u7167\u4E0D\u5B8C\u6574\uFF09`;
+        if (noProgress) failed += "\uFF1B\u540C\u4E00\u9875\u8FD8\u89C2\u5BDF\u5230\u5206\u9875\u6CA1\u6709\u63A8\u8FDB\uFF08\u670D\u52A1\u7AEF\u53EF\u80FD\u4E5F\u5FFD\u7565\u4E86 page \u53C2\u6570\uFF09";
+        break;
+      }
+      if (nonDict) {
+        problems.push(`${key}: \u7B2C ${page} \u9875\u6709 ${nonDict} \u4E2A\u975E\u5BF9\u8C61\u5143\u7D20\uFF0C\u672A\u8BA1\u5165 rows`);
+      }
+      if (got.length === 0) {
+        failed = `\u7B2C ${page} \u9875\u8FD4\u7A7A\u4F46\u8FD8\u5DEE ${total - rows.length} \u884C`;
+        break;
+      }
+      if (noProgress) {
+        failed = `\u7B2C ${page} \u9875\u6CA1\u6709\u5E26\u6765\u4EFB\u4F55\u65B0\u884C\uFF08\u670D\u52A1\u7AEF\u53EF\u80FD\u5FFD\u7565\u4E86 page \u53C2\u6570\uFF09\uFF0C\u5DF2\u7194\u65AD\uFF0C\u6B62\u6B65 ${rows.length} \u884C / \u8BA1\u6570 ${total} \u884C`;
+        break;
+      }
+      for (const i of pageIds) seenIds.add(i);
+      prevPage = serialized;
+      rows.push(...got);
+      page += 1;
+    }
+    const collectedIds = rows.filter((r) => typeof r.id === "string").map((r) => r.id);
+    const duplicated = collectedIds.length - new Set(collectedIds).size;
+    const complete = failed === null && rows.length === total && !duplicated ? "visible-complete" : "partial";
+    if (duplicated) {
+      problems.push(
+        `${key}: \u53D6\u56DE\u7684 ${rows.length} \u884C\u91CC\u6709 ${duplicated} \u884C id \u91CD\u590D\uFF0C\u5206\u9875\u5F88\u53EF\u80FD\u6CA1\u751F\u6548\uFF08\u670D\u52A1\u7AEF\u5FFD\u7565\u4E86 page\uFF1F\uFF09\uFF0C\u884C\u6570\u51D1\u591F totalElements \u4E5F\u4E0D\u7B97\u53D6\u6EE1`
+      );
+    }
+    if (failed) {
+      problems.push(`${key}: ${failed}`);
+    } else if (rows.length !== total) {
+      problems.push(`${key}: \u53D6\u56DE ${rows.length} \u884C\u4F46\u8BA1\u6570\u662F ${total} \u884C`);
+    }
+    tables[key] = {
+      model: key,
+      crawled: true,
+      completeness: complete,
+      totalElements: total,
+      rowsRetrieved: rows.length,
+      rows,
+      probeStatus: probeOut.status,
+      probeError: probeOut.error,
+      // 🔴 两处落点之一（另一处是上面的 `problems`）：**产物是被单独拷走的那一半**，
+      // 只进 problems 的话，顾问 `cat valuedomain/CO_X.json` 看到 partial 却查不出是被谁截的。
+      // `null` = 查过了没触发，对象 = 触发了（恒发键）。
+      truncatedBy,
+      wording: WORDING4
+    };
+  }
+  return { tables, problems };
+}
+function collectEnumDomains(metas) {
+  const rows = [];
+  for (const modelKey of Object.keys(metas).sort()) {
+    const { fields } = metaFields(metas[modelKey]);
+    for (const field of fields) {
+      if (!isRecord4(field)) continue;
+      const fieldKey = field.key;
+      if (typeof fieldKey !== "string" || !fieldKey) continue;
+      const enums = field.enums;
+      if (!Array.isArray(enums) || enums.length === 0) continue;
+      const kept = enums.filter(isRecord4).map((e) => ({ ...e }));
+      rows.push({
+        model: modelKey,
+        field: fieldKey,
+        fieldName: typeof field.name === "string" && field.name || "",
+        count: kept.length,
+        enums: kept,
+        // 🔴 非对象元素进不了 `enums`（那一列的契约是「每项都是对象」），但也不许无痕消失
+        // —— 否则「这个字段的枚举少了一项」这件事没有任何出处。
+        // 实测 3179 条全是对象，这一档从未观测到；**恒发空列表**而不是条件出键：
+        // 「有这一列且为空」与「没这一列」是两个值，后者读起来像「没检查过」。
+        nonDictElements: enums.filter((e) => !isRecord4(e)).map((e) => JSON.stringify(e) ?? String(e))
+      });
+    }
+  }
+  return rows;
+}
+var RESERVED_FILENAMES = ["_index.json", "_enums.jsonl"];
+var PATH_SEPARATORS2 = ["/", String.fromCharCode(92)];
+function unsafeTableKeyReason(key) {
+  if (PATH_SEPARATORS2.some((s) => key.includes(s))) {
+    return `modelKey \u542B\u8DEF\u5F84\u5206\u9694\u7B26\uFF0C\u843D\u76D8\u4F1A\u5199\u51FA valuedomain/ \u5B50\u76EE\u5F55\uFF1A${JSON.stringify(key)}`;
+  }
+  if (key.startsWith(".")) return `modelKey \u4EE5 . \u5F00\u5934\uFF0C\u4F1A\u4EA7\u51FA ls \u770B\u4E0D\u89C1\u7684\u9690\u85CF\u6587\u4EF6\uFF1A${JSON.stringify(key)}`;
+  if (key.startsWith("_")) {
+    return `modelKey \u4EE5 _ \u5F00\u5934\uFF0C\u4E0E\u672C\u76EE\u5F55\u5DE5\u5177\u81EA\u5DF1\u7684\u4FDD\u7559\u6587\u4EF6\u540D\uFF08${RESERVED_FILENAMES.join("\u3001")}\uFF09\u540C\u4E00\u547D\u540D\u7A7A\u95F4\uFF0C\u4F1A\u9876\u6389\u5B83\u4EEC\uFF1A${JSON.stringify(key)}`;
+  }
+  return null;
+}
+function writeValuedomain(layout, codeTables, enums, opts = {}) {
+  const written = [];
+  const writeProblems = [];
+  for (const key of Object.keys(codeTables).sort()) {
+    const reason = unsafeTableKeyReason(key);
+    if (reason !== null) {
+      writeProblems.push(`${key}: ${reason}\uFF0C\u5DF2\u62D2\u7EDD`);
+      continue;
+    }
+    try {
+      written.push(layout.writeJson(`valuedomain/${key}.json`, codeTables[key]));
+    } catch (err) {
+      if (!(err instanceof LayoutContainmentError)) throw err;
+      writeProblems.push(`${key}: \u843D\u76D8\u88AB\u62D2\uFF0C\u672C\u7801\u8868\u6CA1\u6709\u4EA7\u7269\u6587\u4EF6\uFF08${err.message}\uFF09`);
+    }
+  }
+  written.push(layout.writeJsonl("valuedomain/_enums.jsonl", enums));
+  written.push(
+    layout.writeJson("valuedomain/_index.json", {
+      crawled: true,
+      wording: WORDING4,
+      // 🔴 轮次身份。这份索引会被**单独拷走**，而一次中断会让它留在上一轮 ——
+      // 那时 `valuedomain/` 里缺某张码表与「那张表真的没有」同形。
+      // `null` = 调用方没告诉我（与 identity / modelEntriesSeen 同口径），恒发键。
+      roundId: opts.roundId ?? null,
+      // 🔴 `identity || {}` 会把「调用方没传身份」和「身份是空的」压成同一个值，
+      // 而它们的下一步不同（前者去补工具的登录，后者去问服务端为什么不给 user）。
+      identity: isRecord4(opts.identity) ? opts.identity : null,
+      codeTableCount: Object.keys(codeTables).length,
+      enumFieldCount: enums.length,
+      // 🔴 名册里一共看到几条。上游名册加载失败给出空数组时，产物会与
+      // 「名册 742 条里一条 DYNAMIC 都没有」**逐字节同形**。
+      // `null` = 调用方没告诉我（与 identity 同口径），`0` = 名册确实是空的。
+      modelEntriesSeen: opts.modelEntriesSeen ?? null,
+      // 🔴 定向重爬披露。这份产物**会被单独拷走**，而 `_enums.jsonl` 里非重爬模型的枚举
+      // 来自**沿用的 meta** —— 不在这份索引里说一声，拿走 `valuedomain/` 的人就会把整册
+      // 都当成本轮观测到的。**恒发键**：缺席不许兼职「本轮是全量」。
+      [KIT_CARRY_OVER_KEY]: opts.carryOver ?? null,
+      // 🔴 四档全列，产不出来的那一档给空数组而不是缺键：下游据这份索引决定放不放行写入，
+      // 缺键会被读成「这个工具还不懂这一档」，空数组才是「懂，且本轮一个都没有」。
+      byCompleteness: Object.fromEntries(
+        COMPLETENESS.map((c) => [
+          c,
+          Object.entries(codeTables).filter(([, v]) => v.completeness === c).map(([k]) => k).sort()
+        ])
+      ),
+      // 🔴 `byCompleteness` 里有名字、这里却列着的表 = 爬到了但没落盘。
+      // 两者一起看才知道「找不到某张码表的文件」是哪一种原因。
+      writeProblems,
+      // 🔴 **取数期**的台账，与上面那份**落盘期**的不是一回事，合并会把「有这张表但内容残」
+      // 和「压根没有这份文件」压成一句话。明细与摘要两处都要有，缺一份都等于没记。
+      // `null` = 调用方没告诉我，`[]` = 对过账且一条都没有。
+      problems: opts.problems ?? null
+    })
+  );
+  return { written, writeProblems };
+}
+
+// src/fde/recon/runner.ts
+var TargetModelNotFound = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "TargetModelNotFound";
+  }
+};
+var CARRY_NOTE = "mode=targeted \u65F6\u672C\u8F6E\u53EA\u91CD\u722C\u4E86 modelsRecrawled \u91CC\u7684\u6A21\u578B\uFF1BmodelsCarriedOver \u7684\u5B57\u6BB5\u4E0E\u53EA\u8BFB\u95F8\u662F\u4ECE\u4E0A\u4E00\u8F6E\u843D\u76D8\u7684\u4EA7\u7269\u91CC**\u8BFB\u56DE\u6765\u6CBF\u7528**\u7684\uFF0C\u4E0D\u662F\u8FD9\u4E00\u8F6E\u89C2\u6D4B\u5230\u7684\u3002coverage \u7684\u5176\u4F59\u7EDF\u8BA1\u91CF\uFF08modelsQueried / modelsAnswered / unavailable / rejected \u2026\uFF09\u53EA\u63CF\u8FF0**\u672C\u8F6E**\uFF0C\u4E0D\u542B\u6CBF\u7528\u90E8\u5206 \u2014\u2014 \u522B\u62FF\u5B83\u4EEC\u53BB\u89E3\u91CA gates \u7684\u603B\u6761\u6570\u3002mode=full \u65F6\u4E24\u4E2A\u5217\u8868\u90FD\u4E3A\u7A7A\uFF0C\u8FD9\u662F\u300C\u5168\u91CF\u722C\u8FC7\u300D\u800C\u4E0D\u662F\u300C\u6CA1\u722C\u300D\u3002 | topology / valuedomain / mapping \u4E09\u4EFD\u4EA7\u7269\u5728 mode=targeted \u65F6**\u7167\u65E7\u6574\u4F53\u91CD\u7B97**\uFF0C\u4F46\u91CD\u7B97\u7528\u7684\u8F93\u5165\u5206\u4E24\u534A\uFF0C\u522B\u6DF7\u7740\u8BFB\uFF1A\u2460 **\u73B0\u6253\u670D\u52A1\u7AEF**\u7684\u90A3\u534A\uFF08\u7801\u8868 rows\u3001mutation-capability\uFF09\u8986\u76D6\u5168\u90E8\u6A21\u578B\uFF0C**\u5168\u90E8\u662F\u672C\u8F6E\u89C2\u6D4B**\uFF1B\u2461 **\u5403 meta** \u7684\u90A3\u534A\uFF08topology \u7684\u8FB9\u96C6\u3001mapping \u7684\u5B57\u6BB5\u6E05\u5355\u3001valuedomain/_enums.jsonl\uFF09\u5BF9 modelsCarriedOver \u91CC\u7684\u6A21\u578B\u7528\u7684\u662F**\u6CBF\u7528\u7684 meta**\u3002topologyRecomputed=false \u8BF4\u7684\u6B63\u662F \u2461\uFF1A\u8FD9\u5F20\u56FE\u8FD9\u4E00\u8F6E**\u7B97\u8FC7**\uFF0C\u53EA\u662F\u5B83\u7684\u8FB9\u6709\u4E00\u90E8\u5206\u6765\u81EA\u4E0A\u4E00\u8F6E\u89C2\u6D4B\u7684 meta \u2014\u2014 **\u4E0D\u662F**\u300C\u6CA1\u7B97\u300D\u3002mode=full \u65F6\u5B83\u4E3A true\u3002";
+var KIT_CRAWLED_AT_FILE = "_kitCrawledAt.json";
+var CRAWLED_AT_NOTE = "models[<\u6A21\u578B>] = \u8BE5\u6A21\u578B\u7684 meta **\u6700\u540E\u4E00\u6B21\u771F\u6B63\u88AB\u722C\u4E0B\u6765**\u7684\u65F6\u523B\uFF08UTC\uFF09\u3002\u5B9A\u5411\u91CD\u722C\u53EA\u66F4\u65B0\u672C\u8F6E\u91CD\u722C\u7684\u90A3\u4E9B\uFF0C\u6CBF\u7528\u7684\u4FDD\u6301\u539F\u503C\u4E0D\u52A8 \u2014\u2014 \u8FD9\u4EFD\u6587\u4EF6\u6B63\u662F\u300C\u8FD9\u4EFD\u57FA\u7EBF\u6709\u591A\u8001\u300D\u7684\u552F\u4E00\u53EF\u9760\u4F9D\u636E\uFF1A\u6587\u4EF6 mtime \u4F1A\u88AB cp/\u6253\u5305/rsync \u6539\u5199\uFF0C\u5B83\u4E0D\u4F1A\u3002\u503C\u4E3A null = \u8FD9\u4E2A\u6A21\u578B\u662F\u6CBF\u7528\u6765\u7684\u3001\u800C\u4EA7\u51FA\u5B83\u7684\u90A3\u4E00\u8F6E**\u6CA1\u6709\u8BB0\u5F55\u65F6\u95F4\u6233**\uFF08\u57FA\u7EBF\u7531\u66F4\u65E9\u7248\u672C\u7684 kit \u4EA7\u51FA\uFF09\u2014\u2014 \u4E0E\u300C\u521A\u722C\u7684\u300D\u662F\u4E24\u4EF6\u4E8B\uFF0C\u4E0D\u8BB8\u5408\u5E76\u3002";
+var ROUND_STAMPED_PRODUCTS = [
+  "topology.json",
+  "valuedomain/_index.json",
+  "mapping/_index.json"
+];
+var ROUND_STATES = ["complete", "mixed", "unknown"];
+var ROUND_EXIT_CODES = { complete: 0, mixed: 1, unknown: 2 };
+var GREP_RECIPE_HEAD = `grep -H -e '"roundId"' -e '"productsWrittenThisRound"'`;
+var ROUND_SUBCOMMAND = "hcm delivery recon round";
+var ROUND_NOTE = `roundId = \u8FD9\u4E00\u8F6E recon \u7684\u8EAB\u4EFD\uFF08\u8D77\u8DD1\u65F6\u523B + \u968F\u673A\u540E\u7F00\uFF0C\u53EF\u6392\u5E8F\u3001\u540C\u79D2\u4E24\u8F6E\u4E5F\u4E0D\u4F1A\u649E\uFF09\u3002productsWrittenThisRound = \u672C\u8F6E**\u771F\u6B63\u843D\u76D8**\u7684\u4EA7\u7269\u76F8\u5BF9\u8DEF\u5F84 \u2014\u2014 \u5224\u636E\u662F\u6587\u4EF6\u771F\u7684\u5199\u51FA\u6765\u4E86\uFF0C\u4E0D\u662F\u300C\u672C\u8F6E\u6253\u7B97\u5199\u300D\uFF1B\`null\` \u8868\u793A\u8FD9\u4E00\u8F6E\u6CA1\u8DD1\u5230\u5199\u8FD9\u4EFD\u53F0\u8D26\u90A3\u4E00\u6B65\uFF08\u4E2D\u65AD / \u65AD\u7F51 / \u8FDB\u7A0B\u88AB\u6740\uFF09\uFF0C\u4E0E \`[]\`\uFF08\u8DD1\u5230\u4E86\u3001\u4E00\u4EFD\u90FD\u6CA1\u5199\uFF09\u662F\u4E24\u4EF6\u4E8B\u3002topology.json / valuedomain/_index.json / mapping/_index.json \u5404\u81EA\u5E26\u4E00\u4EFD\u540C\u540D\u7684 roundId\uFF1A\u5B83\u4EEC\u4E0E\u8FD9\u91CC\u5BF9\u4E0D\u4E0A\uFF0C\u5C31\u8BF4\u660E\u90A3\u51E0\u4EFD\u4EA7\u7269\u662F**\u522B\u7684\u8F6E\u6B21**\u7559\u4E0B\u7684 \u2014\u2014 \u6B64\u65F6 \`mapping/\` \u91CC\u300C\u6CA1\u6709\u67D0\u4E2A\u6A21\u578B\u300D\u53EF\u80FD\u53EA\u662F\u672C\u8F6E\u6CA1\u5199\u5230\u90A3\u91CC\uFF0C\u4E0D\u662F\u4EA7\u54C1\u7684\u7ED3\u8BBA\u3002 | \u600E\u4E48\u5F53\u573A\u5224\uFF08\u96F6\u7F51\u7EDC\uFF09\uFF1A\u2460 \u8089\u773C\u5BF9\u8D26\uFF0C**\u5728\u4EA7\u7269\u76EE\u5F55\u91CC**\u6267\u884C \`${GREP_RECIPE_HEAD} ${KIT_CRAWLED_AT_FILE} ${ROUND_STAMPED_PRODUCTS.join(" ")}\`\u3002\u8BFB\u6CD5\u6709\u4E09\u79CD\uFF1A**\u56DB\u4E2A roundId \u5BF9\u4E0D\u9F50** = \u6DF7\u88C5\uFF08\u90A3\u51E0\u4EFD\u4EA7\u7269\u662F\u522B\u7684\u8F6E\u6B21\u7559\u4E0B\u7684\uFF09\uFF1B**\u56DB\u4E2A\u90FD\u5BF9\u9F50\u3001\u4F46 productsWrittenThisRound \u662F \`null\`** = \u8FD9\u4E00\u8F6E**\u6CA1\u8DD1\u5B8C**\uFF08\u5199\u5B8C\u6700\u540E\u4E00\u4EFD\u4EA7\u7269\u4E4B\u524D\u5C31\u65AD\u4E86\uFF0C\u771F\u673A\u5B9E\u6D4B\u5B58\u5728\u8FD9\u4E00\u6863\uFF0C\u522B\u628A\u300C\u5BF9\u9F50\u300D\u8BFB\u6210\u300C\u6CA1\u95EE\u9898\u300D\uFF09\uFF1B**\u4E00\u884C\u90FD grep \u4E0D\u5230** = \u8FD9\u4EFD\u57FA\u7EBF\u662F\u66F4\u65E9\u7248\u672C\u7684 kit \u722C\u7684\uFF0C\u5224\u4E0D\u4E86\u3002\u2461 \u8BA9\u5DE5\u5177\u8BF4\u4EBA\u8BDD\uFF08complete / mixed / unknown \u4E09\u6863 + \u6307\u540D\u9053\u59D3\u8BF4\u51FA\u54EA\u4EFD\u4EA7\u7269\u65E7\u5230\u54EA\u4E00\u8F6E\uFF09\uFF1A\u5728\u4EA7\u7269\u76EE\u5F55\u91CC\u6267\u884C \`${ROUND_SUBCOMMAND} --dir . --output table\`\uFF1B\u9000\u51FA\u7801 0=complete / 1=mixed / 2=unknown\uFF0C\u5199\u8FDB\u811A\u672C\u5F53\u524D\u7F6E\u95F8\u4E5F\u53EF\u4EE5\u3002\u26A0\uFE0F \u5B83\u8981 \`@hcmai/cli\` \u88C5\u8FC7\uFF08\`npx @hcmai/cli\` \u4EA6\u53EF\uFF09\uFF1B\u88C5\u4E0D\u4E86\u5C31\u8D70 \u2460\uFF0Cgrep \u662F\u4EFB\u4F55\u673A\u5668\u4E0A\u90FD\u6709\u7684\u90A3\u6761\u8DEF\u3002\u5224\u636E\u672C\u4F53\u662F \`@hcmai/sdk\` \u7684 \`inspectRound()\` / \`renderRound()\`\uFF0C\u53EA\u8BFB\u6587\u4EF6\u3001\u96F6\u7F51\u7EDC\uFF0C\u4EA7\u7269\u88AB\u5355\u72EC\u62F7\u8D70\u540E\u7167\u6837\u76F4\u63A5\u8C03\u5F97\u52A8\u3002`;
+var TOPOLOGY_RECOMPUTE_NOTE = `recomputedThisRound=true\uFF1A\u672C\u8F6E\u662F\u5168\u91CF\u722C\u53D6\uFF0C\u56FE\u91CC\u6BCF\u4E00\u6761\u8FB9\u90FD\u7B97\u81EA**\u8FD9\u4E00\u8F6E**\u53D6\u56DE\u7684 meta\u3002recomputedThisRound=false\uFF1A\u672C\u8F6E\u662F\u5B9A\u5411\u91CD\u722C\uFF08--model\uFF09\uFF0C\u8FD9\u5F20\u56FE**\u7167\u6837\u6574\u4F53\u91CD\u7B97\u4E86** \u2014\u2014 \u8282\u70B9\u53D6\u81EA\u672C\u8F6E\u7684\u6A21\u578B\u540D\u518C\uFF0C\u8FB9\u96C6\u4E5F\u6574\u4F53\u91CD\u7B97 \u2014\u2014 \u4F46 modelsRecrawledThisRound \u4E4B\u5916\u7684\u6A21\u578B\uFF0C\u5B83\u4EEC\u7684\u8FB9\u6765\u81EA**\u4E0A\u4E00\u8F6E\u843D\u76D8\u7684 meta**\u3002\u6240\u4EE5 false \u7684\u610F\u601D\u662F\u300C\u7B97\u8FC7\uFF0C\u90E8\u5206\u8F93\u5165\u662F\u65E7\u7684\u300D\uFF0C**\u4E0D\u662F**\u300C\u8FD9\u4E00\u8F6E\u6CA1\u7B97\u300D\u3002\u6CBF\u7528\u4E86\u54EA\u4E9B\u6A21\u578B\u3001\u4E0A\u4E00\u8F6E\u662F\u4EC0\u4E48\u65F6\u5019\u722C\u7684\uFF1A\u89C1 gates.json \u7684 coverage.${KIT_CARRY_OVER_KEY} \u4E0E\u4EA7\u7269\u6839\u7684 ${KIT_CRAWLED_AT_FILE}\uFF1Bmapping/_index.json \u4E0E valuedomain/_index.json \u4E5F\u5404\u5E26\u4E00\u4EFD\u540C\u540D\u7684 ${KIT_CARRY_OVER_KEY}\uFF08\u9876\u5C42\uFF09\u3002`;
+function two(n) {
+  return String(n).padStart(2, "0");
+}
+function roundStamp(d) {
+  return `${d.getUTCFullYear()}${two(d.getUTCMonth() + 1)}${two(d.getUTCDate())}T${two(d.getUTCHours())}${two(d.getUTCMinutes())}${two(d.getUTCSeconds())}Z`;
+}
+function isoStamp(d) {
+  return d.toISOString().replace(/\.\d{3}Z$/, "Z");
+}
+function parseRoundStamp(stamp) {
+  const m = /^(\d{4})(\d{2})(\d{2})T(\d{2})(\d{2})(\d{2})Z$/.exec(stamp);
+  if (!m) return null;
+  const [, y, mo, d, h, mi, s] = m;
+  return new Date(Date.UTC(+y, +mo - 1, +d, +h, +mi, +s));
+}
+function newRoundId(started) {
+  return `${roundStamp(started)}-${randomBytes2(4).toString("hex")}`;
+}
+function isRecord5(v) {
+  return Boolean(v) && typeof v === "object" && !Array.isArray(v);
+}
+function readJsonSoft(file) {
+  let text;
+  try {
+    text = readFileSync3(file, "utf8");
+  } catch (err) {
+    if (err?.code === "ENOENT") return void 0;
+    throw err;
+  }
+  try {
+    return JSON.parse(text);
+  } catch {
+    return void 0;
+  }
+}
+function readCrawledAt(layout) {
+  const body = readJsonSoft(path8.join(layout.dir, KIT_CRAWLED_AT_FILE));
+  const models = isRecord5(body) ? body.models : null;
+  return isRecord5(models) ? models : {};
+}
+function writeCrawledAt(layout, freshKeys, carriedKeys, roundId, started) {
+  const previous = readCrawledAt(layout);
+  const now = isoStamp(started);
+  const models = {};
+  for (const key of carriedKeys) {
+    const prev = previous[key];
+    models[key] = typeof prev === "string" ? prev : null;
+  }
+  for (const key of freshKeys) models[key] = now;
+  const sorted = {};
+  for (const key of Object.keys(models).sort()) sorted[key] = models[key] ?? null;
+  layout.writeJson(KIT_CRAWLED_AT_FILE, {
+    note: CRAWLED_AT_NOTE,
+    roundNote: ROUND_NOTE,
+    roundId,
+    roundStartedAt: now,
+    // 🔴 这一刻**必然**是 null：本轮还没写完，台账要等到最后一份产物落盘才知道。
+    // 恒发键（GC3）：`null` = 没跑到那一步，`[]`/清单 = 跑到了。
+    // ⚠️ 正因为每一轮起手都会把它重置成 null，它才能当「这一轮跑完了没有」的见证 ——
+    // 上一轮留下的清单不会冒充本轮的。
+    productsWrittenThisRound: null,
+    models: sorted
+  });
+  return sorted;
+}
+function finishRound(layout, models, roundId, started, products) {
+  const written = [...new Set(products.filter((rel) => rel && existsSync3(path8.join(layout.dir, rel))))].sort();
+  layout.writeJson(KIT_CRAWLED_AT_FILE, {
+    note: CRAWLED_AT_NOTE,
+    roundNote: ROUND_NOTE,
+    roundId,
+    roundStartedAt: isoStamp(started),
+    productsWrittenThisRound: written,
+    models
+  });
+  return written;
+}
+function relOf(layout, p) {
+  const rel = path8.relative(layout.dir, p);
+  if (!rel || rel.startsWith("..")) return p;
+  return rel.split(path8.sep).join("/");
+}
+function productRoundId(root, rel) {
+  const p = path8.join(root, rel);
+  if (!existsSync3(p)) return ["missing", null];
+  const body = readJsonSoft(p);
+  if (body === void 0 || !isRecord5(body)) return ["unreadable", null];
+  const rid = body.roundId;
+  if (typeof rid !== "string" || !rid) return ["unstamped", null];
+  return ["stamped", rid];
+}
+function inspectRound(root) {
+  const raw = readJsonSoft(path8.join(root, KIT_CRAWLED_AT_FILE));
+  const ledger = isRecord5(raw) ? raw : {};
+  const rid = ledger.roundId;
+  const roundId = typeof rid === "string" && rid ? rid : null;
+  const rawWritten = ledger.productsWrittenThisRound;
+  const written = Array.isArray(rawWritten) ? rawWritten : null;
+  let ledgerMissing = null;
+  if (written !== null) {
+    const gone = written.filter((rel) => typeof rel === "string" && !existsSync3(path8.join(root, rel))).sort();
+    ledgerMissing = { checked: written.length, count: gone.length, files: gone };
+  }
+  const products = [];
+  for (const rel of ROUND_STAMPED_PRODUCTS) {
+    const [readState, pid] = productRoundId(root, rel);
+    const state2 = readState === "stamped" ? roundId && pid === roundId ? "this-round" : "older-round" : readState;
+    products.push({ path: rel, state: state2, roundId: pid });
+  }
+  let state;
+  let finished;
+  if (roundId === null && products.every((p) => p.roundId === null)) {
+    state = "unknown";
+    finished = null;
+  } else {
+    finished = written !== null;
+    state = roundId && finished && !ledgerMissing?.count && products.every((p) => p.state === "this-round") ? "complete" : "mixed";
+  }
+  return {
+    state,
+    roundId,
+    roundStartedAt: ledger.roundStartedAt ?? null,
+    finished,
+    productsWrittenThisRound: written !== null ? written.length : null,
+    ledgerFilesMissing: ledgerMissing,
+    products,
+    dir: root,
+    note: ROUND_NOTE
+  };
+}
+var LEDGER_MISSING_WORD = "\u672C\u8F6E\u5199\u8FC7\u3001\u73B0\u5728\u5374**\u627E\u4E0D\u5230\u4E86**\uFF08\u62F7\u8D1D / \u88C1\u526A\u65F6\u6F0F\u5E26\uFF0C\u6216\u4E8B\u540E\u88AB\u5220\uFF09";
+var PRODUCT_STATE_WORDS = {
+  "older-round": "\u662F**\u522B\u7684\u8F6E\u6B21**\u7559\u4E0B\u7684",
+  unstamped: "\u5728\u76D8\u4E0A\uFF0C\u4F46**\u6CA1\u6709\u8F6E\u6B21\u6233**\uFF08\u66F4\u65E9\u7248\u672C\u7684 kit \u5199\u7684\uFF09",
+  missing: "**\u4E0D\u5728\u76D8\u4E0A**",
+  unreadable: "\u5728\u76D8\u4E0A\u4F46**\u8BFB\u4E0D\u51FA JSON**"
+};
+function roundAge(roundId, other) {
+  if (typeof roundId !== "string" || typeof other !== "string") return "";
+  const a = parseRoundStamp(roundId.split("-")[0] ?? "");
+  const b = parseRoundStamp(other.split("-")[0] ?? "");
+  if (!a || !b) return "";
+  const seconds = Math.trunc((a.getTime() - b.getTime()) / 1e3);
+  if (seconds <= 0) return "";
+  if (seconds < 60) return `\uFF0C\u6BD4\u672C\u8F6E\u65E9 ${seconds}s`;
+  return `\uFF0C\u6BD4\u672C\u8F6E\u65E9 ${Math.floor(seconds / 3600)}h${two(Math.floor(seconds % 3600 / 60))}m`;
+}
+function renderRound(result) {
+  const lines = [`\u57FA\u7EBF\uFF1A${result.dir}`];
+  if (result.state === "unknown") {
+    lines.push(
+      "\u72B6\u6001\uFF1Aunknown \u2014\u2014 \u8FD9\u4EFD\u57FA\u7EBF\u91CC**\u4E00\u4E2A roundId \u90FD\u6CA1\u6709**\uFF08\u66F4\u65E9\u7248\u672C\u7684 kit \u722C\u7684\uFF09\u3002",
+      "\u21D2 \u5224\u4E0D\u4E86\u5B83\u662F\u4E0D\u662F\u4E00\u8F6E\u5B8C\u6574\u4EA7\u7269\u3002**\u522B\u628A\u5B83\u5F53 complete\uFF0C\u4E5F\u522B\u5F53 mixed** \u2014\u2014\u91CD\u8DD1\u4E00\u6B21 recon \u624D\u4F1A\u5E26\u4E0A\u8F6E\u6B21\u8EAB\u4EFD\u3002"
+    );
+    return `${lines.join("\n")}
+`;
+  }
+  lines.push(
+    `\u672C\u8F6E roundId\uFF1A${result.roundId ?? "\uFF08\u65E0\uFF09"}\uFF08\u8D77\u8DD1 ${result.roundStartedAt ?? "\u672A\u77E5"}\uFF09`
+  );
+  if (result.state === "complete") {
+    lines.push(
+      `\u72B6\u6001\uFF1Acomplete \u2014\u2014 ${result.products.length} \u4EFD\u5E26\u6233\u7684\u4EA7\u7269\u540C\u5C5E\u8FD9\u4E00\u8F6E\uFF0C\u672C\u8F6E\u5171\u843D\u76D8 ${result.productsWrittenThisRound} \u4E2A\u6587\u4EF6\u3002`,
+      `\u26A0\uFE0F complete \u8BF4\u7684\u662F\u300C**\u540C\u4E00\u8F6E**\u300D\uFF0C\u4E0D\u662F\u300C\u5168\u91CF\u722C\u8FC7\u300D\uFF1A\u5B9A\u5411\u91CD\u722C\uFF08\`--model X\`\uFF09\u540C\u6837\u4F1A\u628A\u4E09\u4EFD\u4EA7\u7269\u6574\u4F53\u91CD\u5199\uFF0C\u7167\u6837\u662F complete\u3002\u5168\u91CF\u4E0E\u5426\u770B gates.json \u7684 \`coverage.${KIT_CARRY_OVER_KEY}\`\u3002`
+    );
+    return `${lines.join("\n")}
+`;
+  }
+  lines.push("\u72B6\u6001\uFF1Amixed \u2014\u2014 \u8FD9\u4EFD\u57FA\u7EBF**\u4E0D\u662F\u4E00\u8F6E\u5B8C\u6574\u8DD1\u51FA\u6765\u7684**\uFF1A");
+  for (const p of result.products) {
+    if (p.state === "this-round") continue;
+    let detail = PRODUCT_STATE_WORDS[p.state];
+    if (p.state === "older-round") {
+      detail += `\uFF08roundId ${p.roundId}${roundAge(result.roundId, p.roundId)}\uFF09`;
+    }
+    lines.push(`  \xB7 ${p.path} ${detail}`);
+  }
+  if (result.finished === false) {
+    lines.push(
+      "  \xB7 \u672C\u8F6E\u7684 productsWrittenThisRound \u6CA1\u6709\u843D\u76D8 \u21D2 \u8FD9\u4E00\u8F6E**\u6CA1\u8DD1\u5B8C**\uFF08Ctrl-C / \u65AD\u7F51 / \u8FDB\u7A0B\u88AB\u6740\u90FD\u4F1A\u8FD9\u6837\uFF09"
+    );
+  }
+  const gone = result.ledgerFilesMissing;
+  if (gone?.count) {
+    const shown = gone.files.slice(0, 5).join("\u3001");
+    const more = gone.count > 5 ? "\uFF08\u4EC5\u5217\u524D 5 \u4E2A\uFF0C\u5B8C\u6574\u540D\u5355\u89C1 ledgerFilesMissing.files\uFF09" : "";
+    lines.push(
+      `  \xB7 \u53F0\u8D26\u70B9\u540D\u7684 ${gone.checked} \u4EFD\u4EA7\u7269\u91CC\uFF0C\u6709 **${gone.count}** \u4EFD${LEDGER_MISSING_WORD}\uFF1A${shown}${more}`
+    );
+  }
+  lines.push(
+    "\u21D2 \u{1F534} \u522B\u62FF\u8FD9\u4E9B\u4EA7\u7269\u91CC\u300C\u6CA1\u6709\u67D0\u4E2A\u6A21\u578B\u300D\u5F53\u7ED3\u8BBA \u2014\u2014 \u90A3\u53EF\u80FD\u53EA\u662F**\u672C\u8F6E\u6CA1\u5199\u5230\u90A3\u91CC**\uFF0C\u4E0E\u300C\u4EA7\u54C1\u91CC\u771F\u7684\u6CA1\u6709\u300D\u540C\u5F62\u3002\u91CD\u8DD1\u4E00\u6B21\u5B8C\u6574 recon\u3002"
+  );
+  return `${lines.join("\n")}
+`;
+}
+function collectCarryOver(layout, freshMetas) {
+  const problems = [];
+  const carriedMetas = {};
+  const metaDir = path8.join(layout.dir, "meta");
+  const suffix = `.${DEFAULT_META_TYPE}.json`;
+  let names = [];
+  try {
+    names = readdirSync(metaDir).filter((n) => n.endsWith(suffix)).sort();
+  } catch (err) {
+    if (err?.code !== "ENOENT") throw err;
+  }
+  for (const name of names) {
+    const key = name.slice(0, -suffix.length);
+    if (key in freshMetas) continue;
+    const file = path8.join(metaDir, name);
+    let body;
+    try {
+      body = JSON.parse(readFileSync3(file, "utf8"));
+    } catch (e) {
+      problems.push(`${name}: \u8BFB\u4E0D\u56DE\u4E0A\u4E00\u8F6E\u7684 meta\uFF08${e.message}\uFF09\uFF0C\u8BE5\u6A21\u578B\u8FD9\u6B21\u4E0D\u8FDB\u7D22\u5F15`);
+      continue;
+    }
+    if (isRecord5(body)) carriedMetas[key] = body;
+    else {
+      problems.push(
+        `${name}: \u4E0A\u4E00\u8F6E\u7684 meta \u8F7D\u8377\u662F ${Array.isArray(body) ? "list" : body === null ? "null" : typeof body} \u4E0D\u662F\u5BF9\u8C61\uFF0C\u8BE5\u6A21\u578B\u8FD9\u6B21\u4E0D\u8FDB\u7D22\u5F15`
+      );
+    }
+  }
+  const carriedGates = [];
+  const oldGates = readJsonSoft(path8.join(layout.dir, "gates.json"));
+  if (oldGates === void 0) {
+    problems.push("gates.json: \u6CA1\u6709\u53EF\u6CBF\u7528\u7684\u4E0A\u4E00\u8F6E\u95F8\u8868\uFF08\u4E0D\u5B58\u5728\u6216\u8BFB\u4E0D\u51FA JSON\uFF09");
+  }
+  const oldList = isRecord5(oldGates) && Array.isArray(oldGates.gates) ? oldGates.gates : [];
+  for (const g of oldList) {
+    if (isRecord5(g) && !(String(g.model) in freshMetas)) carriedGates.push(g);
+  }
+  return { carriedMetas, carriedGates, problems };
+}
+function carryOverBanner(carryOver) {
+  if (carryOver.mode !== "targeted") return "";
+  return `> \u26A0\uFE0F **\u672C\u8F6E\u662F\u5B9A\u5411\u91CD\u722C\uFF08\`--model ${carryOver.onlyModel}\`\uFF09\uFF0C\u4E0D\u662F\u5168\u91CF\u3002**
+> \u8FD9\u4E00\u8F6E\u771F\u6B63\u722C\u7684\u53EA\u6709\uFF1A${carryOver.modelsRecrawled.join(", ") || "\uFF08\u65E0\uFF09"}\uFF1B
+> \u53E6\u6709 **${carryOver.modelsCarriedOver.length}** \u4E2A\u6A21\u578B\u7684\u5B57\u6BB5\u4E0E **${carryOver.gatesCarriedOver}** \u6761\u53EA\u8BFB\u95F8\u662F**\u6CBF\u7528\u4E0A\u4E00\u8F6E\u4EA7\u7269**\uFF0C\u4E0D\u662F\u8FD9\u4E00\u8F6E\u89C2\u6D4B\u5230\u7684\u3002
+` + carryOver.problems.map((p) => `> - \u26A0\uFE0F ${p}
+`).join("") + "\n";
+}
+async function runRecon(probe, layout, opts = {}) {
+  const state = opts.state ?? "";
+  const onlyModel = opts.onlyModel ?? null;
+  const started = /* @__PURE__ */ new Date();
+  const roundId = newRoundId(started);
+  const modelsBody = await crawlModels(probe);
+  let keys = modelKeys(modelsBody);
+  if (onlyModel) {
+    keys = keys.filter((k) => k === onlyModel);
+    if (keys.length === 0) {
+      const total = Array.isArray(modelsBody.models) ? modelsBody.models.length : 0;
+      throw new TargetModelNotFound(
+        `--model '${onlyModel}' \u5728\u6A21\u578B\u6E05\u5355\u91CC\u4E00\u4E2A\u90FD\u6CA1\u5339\u914D\u4E0A\uFF08\u6E05\u5355\u5171 ${total} \u4E2A\u6A21\u578B\uFF09\u3002\u5DF2\u62D2\u7EDD\u5199\u76D8\uFF0C\u73B0\u6709\u57FA\u7EBF\u539F\u6837\u4FDD\u7559\u3002\u8BF7\u6838\u5BF9\u6A21\u578B\u540D\u5927\u5C0F\u5199\u4E0E\u62FC\u5199\uFF0C\u6216\u5148\u8DD1\u4E00\u6B21\u4E0D\u5E26 --model \u7684\u5168\u91CF recon\u3002`
+      );
+    }
+  }
+  const { metas: freshMetas, unavailable } = await crawlMeta(probe, keys);
+  const gateResult = await collectActionGates(probe, keys, state);
+  const carried = onlyModel ? collectCarryOver(layout, freshMetas) : { carriedMetas: {}, carriedGates: [], problems: [] };
+  const metas = { ...carried.carriedMetas, ...freshMetas };
+  const gates = [...carried.carriedGates, ...gateResult.gates];
+  const { rows, dropped } = extractFieldRows(metas);
+  const carryOver = {
+    mode: onlyModel ? "targeted" : "full",
+    onlyModel,
+    modelsRecrawled: Object.keys(freshMetas).sort(),
+    modelsCarriedOver: Object.keys(carried.carriedMetas).sort(),
+    gatesCarriedOver: carried.carriedGates.length,
+    problems: carried.problems,
+    // 🔴 整图产物的诚实标注。语义见 CARRY_NOTE 与 topology.json 的 recomputedNote：
+    // false ≠「没算」，而是「算过、边集里有一部分输入是沿用的 meta」。
+    topologyRecomputed: !onlyModel,
+    note: CARRY_NOTE
+  };
+  const coverage = {
+    ...gateResult.coverage,
+    [KIT_CARRY_OVER_KEY]: carryOver
+  };
+  const crawledAt = writeCrawledAt(
+    layout,
+    Object.keys(freshMetas).sort(),
+    Object.keys(carried.carriedMetas).sort(),
+    roundId,
+    started
+  );
+  const crawlWritten = writeCrawlProducts(layout, modelsBody, freshMetas, unavailable);
+  const gatesPath = writeGates(layout, gates, coverage);
+  const fieldsPath = writeFieldsIndex(layout, rows);
+  const mdPath = writeModelsMd(
+    layout,
+    carryOverBanner(carryOver) + renderModelsMd(modelsBody, metas, gates, dropped)
+  );
+  const rejectedMetas = new Set(
+    unavailable.filter((e) => e?.error === "unsafe-model-key").map((e) => e.modelKey)
+  );
+  const products = [
+    crawlWritten.models,
+    crawlWritten.unavailable,
+    KIT_CRAWLED_AT_FILE,
+    relOf(layout, gatesPath),
+    relOf(layout, fieldsPath),
+    relOf(layout, mdPath)
+  ];
+  for (const k of Object.keys(freshMetas).sort()) {
+    if (!rejectedMetas.has(k)) products.push(`meta/${k}.${DEFAULT_META_TYPE}.json`);
+  }
+  const known = /* @__PURE__ */ new Set([...Object.keys(metas), ...modelKeys(modelsBody)]);
+  const { edges, dangling } = refEdges(metas, known);
+  const topo = buildTopology(edges, dangling, [...known].sort(), Object.keys(metas).sort());
+  topo.recomputedThisRound = !onlyModel;
+  topo.modelsRecrawledThisRound = Object.keys(freshMetas).sort();
+  topo.recomputedNote = TOPOLOGY_RECOMPUTE_NOTE;
+  topo.roundId = roundId;
+  products.push(relOf(layout, writeTopology(layout, topo)));
+  const entries = modelEntries(modelsBody);
+  const { tables: codeTables, problems: vdProblems } = await collectCodeTables(probe, entries);
+  const enumRows2 = collectEnumDomains(metas);
+  const { written: vdWritten, writeProblems: vdWriteProblems } = writeValuedomain(
+    layout,
+    codeTables,
+    enumRows2,
+    {
+      identity: opts.identity,
+      // `modelEntriesSeen` 不许省：名册加载失败给出空 list 时，产物会与「名册里一条
+      // DYNAMIC 都没有」逐字节同形（GC3）。null 是「调用方没告诉我」，这里我们知道。
+      modelEntriesSeen: entries.length,
+      carryOver,
+      roundId,
+      // 取数期台账也要进产物：与落盘期的 writeProblems 分两个键，
+      // 两侧现在都是「摘要给条数 + 产物给明细」。
+      problems: vdProblems
+    }
+  );
+  const writtenPaths = new Set(vdWritten);
+  const codeTableFiles = new Set(
+    Object.keys(codeTables).filter(
+      (k) => unsafeTableKeyReason(k) === null && writtenPaths.has(path8.join(layout.dir, "valuedomain", `${k}.json`))
+    )
+  );
+  const { mutation, problems: mutProblems } = await collectMutation(probe, Object.keys(metas).sort());
+  const sheets = buildMapping(metas, edges, mutation, codeTableFiles);
+  const danglingPointers = auditValueDomainPointers(layout, sheets);
+  products.push(...vdWritten.map((p) => relOf(layout, p)));
+  const mappingPaths = writeMapping(layout, sheets, {
+    problems: mutProblems,
+    danglingValueDomain: danglingPointers,
+    carryOver,
+    roundId
+  });
+  products.push(...mappingPaths.map((p) => relOf(layout, p)));
+  const sheetsWritten = Math.max(mappingPaths.length - 1, 0);
+  let previous = readJsonSoft(path8.join(layout.dir, "fingerprint.json"));
+  if (!isRecord5(previous)) previous = null;
+  const current = await computeFingerprint(probe);
+  products.push(relOf(layout, layout.writeJson("fingerprint.json", current)));
+  const drift = previous === null ? null : compareFingerprint(previous, current);
+  const productsWritten = finishRound(layout, crawledAt, roundId, started, products);
+  const roundResult = inspectRound(layout.dir);
+  const byCompleteness = {};
+  for (const c of COMPLETENESS) {
+    byCompleteness[c] = Object.values(codeTables).filter((v) => v.completeness === c).length;
+  }
+  return {
+    driftSinceLastRecon: drift,
+    modelsQueried: keys.length,
+    metasCrawled: Object.keys(freshMetas).length,
+    unavailable: unavailable.length,
+    gates: gates.length,
+    fieldRows: rows.length,
+    // 🔴 被丢掉的字段必须有落点。摘要给条数，models.md 给明细 ——
+    // 「记下来了但没人看得见」等于没记。
+    fieldsDropped: dropped.length,
+    // 🔴 索引里有多少行不是这一轮爬的，必须能一眼看出来 —— 否则定向重爬产出的
+    // 基线与全量基线在摘要里同形。
+    carryOver,
+    // 🔴 时间戳未知的模型数必须能一眼看到：它是「沿用了但不知道多老」的落点，
+    // 与「刚爬的」不许合并（GC3）。
+    crawledAtUnknown: Object.values(crawledAt).filter((v) => v === null).length,
+    // 🔴 三段统计一律**带上自己的 problems / 差额**，不许只报好数字（no silent caps）：
+    // 明细在各自的产物文件里，摘要给条数 + 指向文件，两处缺一份都等于没记
+    // （只进摘要 ⇒ 产物被单独拷走后就没了；只进产物 ⇒ 跑完那一刻看不见）。
+    topology: {
+      nodes: topo.nodeCount,
+      edges: topo.edgeCount,
+      cycles: topo.cycles.length,
+      selfLoops: topo.selfLoops.length,
+      unordered: topo.unordered.length,
+      blockedByCycles: topo.blockedByCycles.length,
+      // 三个「没进依赖图」的口子都要报数：edgeCount 与图里用掉的边数的差额
+      // 就是它们仨，不报的话没人说得清差在哪。
+      dangling: topo.dangling.length,
+      // 🔴 「出边不可知」的节点数（接线后恒是数字，不再是 null）。明细在 topology.json
+      // 的 nodesWithoutMeta.models 里，摘要给条数 —— 两处缺一份都等于没记。
+      nodesWithoutMeta: topo.nodesWithoutMeta.count,
+      excludedEdges: topo.excludedEdges.count,
+      edgesOutsideNodes: topo.edgesOutsideNodes.count,
+      recomputedThisRound: topo.recomputedThisRound,
+      file: "topology.json"
+    },
+    valuedomain: {
+      codeTableCount: Object.keys(codeTables).length,
+      enumFieldCount: enumRows2.length,
+      // 四档全列（含产不出来的那一档），缺键会被读成「这个 kit 还不懂这一档」。
+      byCompleteness,
+      // 🔴 两份台账**不许合并**：problems 是取数时的（爬不到 / 没取满 / 分页可疑），
+      // writeProblems 是落盘时的（modelKey 当不了文件名）。前者「有这张表但内容残」，
+      // 后者「压根没有这份文件」—— 下一步动作完全不同。
+      problems: vdProblems,
+      writeProblems: vdWriteProblems,
+      file: "valuedomain/_index.json"
+    },
+    mapping: {
+      modelCount: sheets.length,
+      sheetsWritten,
+      // 差额恒有值：`ls mapping/ | wc -l` 与 modelCount 对不上时，这里先给出数，
+      // 名字在 mapping/_index.json 的 unsafeModelKeys 里。
+      sheetsNotWritten: sheets.length - sheetsWritten,
+      problems: mutProblems,
+      // 🔴 悬空的 valueDomain 指针。空列表 = **对过账且一条都没有**，
+      // 不是「没对过」（GC3）—— 这份对账是 codeTableFiles 那条推导的独立复核。
+      danglingValueDomainPointers: danglingPointers,
+      file: "mapping/_index.json"
+    },
+    // 🔴 轮次身份 + 本轮台账的条数。产物与摘要两处落点：明细在 `_kitCrawledAt.json` 里，
+    // 摘要给结论与条数。
+    round: {
+      roundId,
+      state: roundResult.state,
+      productsWritten: productsWritten.length,
+      file: KIT_CRAWLED_AT_FILE,
+      // 中断过的基线不会走到这里，所以必须告诉顾问**事后**怎么问同一个问题。
+      // ⚠️ 这里写的是**今天真能敲**的那条，且**两个模式都要 grep**：只看 roundId
+      // 会把「四行对齐」读成「没问题」，而真机实测存在「对齐但没跑完」那一档。
+      // 🔴 命令头与 roundNote 同源（`GREP_RECIPE_HEAD`），不抄第二份。
+      recheckWith: `cd ${layout.dir} && ${GREP_RECIPE_HEAD} ${KIT_CRAWLED_AT_FILE} ${ROUND_STAMPED_PRODUCTS.join(" ")}`,
+      // 子命令形态（零网络）—— 它给的是 complete/mixed/unknown 三档人话 + 退出码，
+      // 比 grep 多一层判读。🔴 命令名与 roundNote 的 ② 同源（`ROUND_SUBCOMMAND`），
+      // 不抄第二份：抄两份的表现是「产物教的命令与摘要教的不一样」。
+      recheckCommand: `${ROUND_SUBCOMMAND} --dir ${layout.dir} --output table`
+    },
+    coverage,
+    dir: layout.dir
+  };
+}
+
+// src/fde/gate0/aclass.ts
+import { existsSync as existsSync4, readFileSync as readFileSync5, readdirSync as readdirSync2, statSync as statSync2 } from "fs";
+import * as path9 from "path";
+
+// src/fde/gate0/mapping-artifact.ts
+import { readFileSync as readFileSync4 } from "fs";
+var MAPPING_ARTIFACT_VERSION = 1;
+var MappingArtifactError = class extends Error {
+  constructor(reason, message) {
+    super(`[${reason}] ${message}`);
+    this.reason = reason;
+    this.message = message;
+    this.name = "MappingArtifactError";
+  }
+  reason;
+  message;
+};
+function isRecord6(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function readBusinessKeyFields(file) {
+  let text;
+  try {
+    text = readFileSync4(file, "utf8");
+  } catch (e) {
+    const code = e?.code;
+    if (code === "ENOENT") throw new MappingArtifactError("not-found", `\u627E\u4E0D\u5230\u6620\u5C04\u5DE5\u4EF6 ${file}`);
+    throw new MappingArtifactError("unreadable", `${file} \u8BFB\u4E0D\u52A8\uFF08${String(e)}\uFF09`);
+  }
+  if (text.charCodeAt(0) === 65279) text = text.slice(1);
+  let body;
+  try {
+    body = JSON.parse(text);
+  } catch (e) {
+    throw new MappingArtifactError("not-json", `${file} \u4E0D\u662F\u5408\u6CD5 JSON\uFF1A${String(e)}`);
+  }
+  if (!isRecord6(body)) {
+    throw new MappingArtifactError("bad-shape", `${file} \u7684\u6839\u4E0D\u662F\u5BF9\u8C61`);
+  }
+  if (!("version" in body)) {
+    throw new MappingArtifactError("version-missing", `${file} \u6CA1\u6709 version \u5B57\u6BB5`);
+  }
+  if (body.version !== MAPPING_ARTIFACT_VERSION) {
+    throw new MappingArtifactError(
+      "unsupported-version",
+      `${file} \u7684 version \u662F ${JSON.stringify(body.version)}\uFF0C\u672C\u5DE5\u5177\u53EA\u8BA4 ${MAPPING_ARTIFACT_VERSION} \u2014\u2014\u300C\u5C3D\u91CF\u6309\u8001\u7248\u672C\u8BFB\u300D\u4F1A\u628A\u65B0\u8BED\u4E49\u9759\u9ED8\u4E22\u6389`
+    );
+  }
+  const models = body.models;
+  if (!Array.isArray(models)) {
+    throw new MappingArtifactError(
+      "bad-shape",
+      `${file} \u7684 models \u5E94\u5F53\u662F\u4E00\u4E2A\u6570\u7EC4\uFF0C\u5B9E\u9645\u662F ${models === null ? "null" : typeof models}`
+    );
+  }
+  if (models.length === 0) {
+    throw new MappingArtifactError(
+      "empty",
+      `${file} \u7684 models \u662F\u7A7A\u7684 \u2014\u2014 \u7A7A\u5DE5\u4EF6\u8DD1\u5B8C\u4EC0\u4E48\u4E5F\u4E0D\u4F1A\u53D1\u751F\uFF0C\u800C\u987E\u95EE\u4F1A\u4EE5\u4E3A\u300C\u5BFC\u8FC7\u4E86\u300D`
+    );
+  }
+  return models.map((raw, i) => {
+    if (!isRecord6(raw)) {
+      throw new MappingArtifactError("bad-shape", `${file} \u7684 models[${i}] \u4E0D\u662F\u5BF9\u8C61`);
+    }
+    const businessKey = raw.businessKey;
+    if (businessKey === void 0 || businessKey === null) return [];
+    if (!isRecord6(businessKey)) {
+      throw new MappingArtifactError("bad-shape", `${file} \u7684 models[${i}].businessKey \u4E0D\u662F\u5BF9\u8C61`);
+    }
+    const fields = businessKey.fields;
+    if (fields === void 0 || fields === null) return [];
+    if (!Array.isArray(fields)) {
+      throw new MappingArtifactError(
+        "bad-shape",
+        `${file} \u7684 models[${i}].businessKey.fields \u4E0D\u662F\u6570\u7EC4`
+      );
+    }
+    return fields.filter((f) => typeof f === "string" && f !== "");
+  });
+}
+
+// src/fde/gate0/aclass.ts
+var ACLASS_KINDS = [
+  "fieldKey",
+  "fieldLabel",
+  "enumValue",
+  "modelName",
+  "codeValue",
+  "naturalKey",
+  "caliber"
+];
+var FIELDS_INDEX = ["index", "fields.jsonl"];
+var ENUM_MIRROR = ["valuedomain", "_enums.jsonl"];
+var MODEL_ROSTER = ["models.json"];
+var VALUE_DOMAIN_DIR = "valuedomain";
+var ENUM_ELEMENT_KEYS = ["value", "label", "key"];
+var MAPPING_ARTIFACT_HINT = "work/mapping.json";
+var CLASS_SCOPE = "class";
+var ENTRY_SCOPE = "entry";
+var SCOPES = [CLASS_SCOPE, ENTRY_SCOPE];
+var REASON_UNREAD = "unread";
+var REASON_EMPTY = "empty";
+var CLASS_REASONS = [REASON_UNREAD, REASON_EMPTY];
+function unguardedKinds(problems) {
+  const out = /* @__PURE__ */ new Set();
+  for (const problem of problems) {
+    if (!SCOPES.includes(problem.scope)) {
+      throw new Error(
+        `\u53F0\u8D26\u7684 scope \u53EA\u6709 ${SCOPES.join("/")} \u4E24\u4E2A\u53D6\u503C\uFF0C\u62FF\u5230\u7684\u662F ${JSON.stringify(problem.scope)}\uFF08${problem.message}\uFF09`
+      );
+    }
+    if (problem.scope === CLASS_SCOPE) for (const kind of problem.kinds) out.add(kind);
+  }
+  return out;
+}
+function unguardedWord(kinds) {
+  return kinds.join("/");
+}
+function token(value) {
+  if (typeof value === "string") return value === "" ? null : value;
+  if (typeof value === "number" && Number.isFinite(value)) return String(value);
+  return null;
+}
+function scalarsWithin(value) {
+  if (Array.isArray(value)) return value.flatMap(scalarsWithin);
+  if (typeof value === "object" && value !== null) {
+    return Object.values(value).flatMap(scalarsWithin);
+  }
+  const one = token(value);
+  return one === null ? [] : [one];
+}
+function readText(file, kinds, scope, problems) {
+  try {
+    return readFileSync5(file, "utf8");
+  } catch (e) {
+    const code = e?.code;
+    const name = path9.basename(file);
+    problems.push({
+      scope,
+      reason: REASON_UNREAD,
+      kinds,
+      message: code === "ENOENT" ? `\u7F3A\u4EA7\u7269 ${name} \u21D2 ${unguardedWord(kinds)} \u8FD9\u51E0\u7C7B\u6B64\u523B\u65E0\u4EBA\u5B88` : `\u4EA7\u7269 ${name} \u8BFB\u4E0D\u52A8\uFF08${String(e)}\uFF09\u21D2 ${unguardedWord(kinds)} \u8FD9\u51E0\u7C7B\u6B64\u523B\u65E0\u4EBA\u5B88`
+    });
+    return null;
+  }
+}
+function readJsonl(file, kinds, scope, problems) {
+  const text = readText(file, kinds, scope, problems);
+  if (text === null) return [];
+  const name = path9.basename(file);
+  const rows = [];
+  text.split("\n").forEach((raw, i) => {
+    const line = raw.trim();
+    if (line === "") return;
+    let row;
+    try {
+      row = JSON.parse(line);
+    } catch (e) {
+      problems.push({
+        scope: ENTRY_SCOPE,
+        reason: "bad-line",
+        kinds,
+        message: `${name}:${i + 1} \u4E0D\u662F\u5408\u6CD5 JSON\uFF08${String(e)}\uFF09\u21D2 \u8FD9\u4E00\u884C\u7684\u53D6\u503C\u6CA1\u6709\u8FDB ${unguardedWord(kinds)}`
+      });
+      return;
+    }
+    if (typeof row !== "object" || row === null || Array.isArray(row)) {
+      problems.push({
+        scope: ENTRY_SCOPE,
+        reason: "bad-line",
+        kinds,
+        message: `${name}:${i + 1} \u4E0D\u662F\u5BF9\u8C61\uFF08${row === null ? "null" : typeof row}\uFF09\u21D2 \u8FD9\u4E00\u884C\u7684\u53D6\u503C\u6CA1\u6709\u8FDB ${unguardedWord(kinds)}`
+      });
+      return;
+    }
+    rows.push(row);
+  });
+  return rows;
+}
+var UNREADABLE = /* @__PURE__ */ Symbol("unreadable");
+function readJson(file, kinds, scope, problems) {
+  const text = readText(file, kinds, scope, problems);
+  if (text === null) return UNREADABLE;
+  try {
+    return JSON.parse(text);
+  } catch (e) {
+    problems.push({
+      scope,
+      reason: REASON_UNREAD,
+      kinds,
+      message: `\u4EA7\u7269 ${path9.basename(file)} \u4E0D\u662F\u5408\u6CD5 JSON\uFF08${String(e)}\uFF09\u21D2 ${unguardedWord(kinds)} \u8FD9\u51E0\u7C7B\u6B64\u523B\u65E0\u4EBA\u5B88`
+    });
+    return UNREADABLE;
+  }
+}
+function listUnder(payload, key, file, kinds, scope, problems) {
+  const name = path9.basename(file);
+  if (typeof payload !== "object" || payload === null || Array.isArray(payload)) {
+    problems.push({
+      scope,
+      reason: REASON_UNREAD,
+      kinds,
+      message: `\u4EA7\u7269 ${name} \u4E0D\u662F\u5BF9\u8C61\uFF08${payload === null ? "null" : Array.isArray(payload) ? "array" : typeof payload}\uFF09\u21D2 ${unguardedWord(kinds)} \u8FD9\u51E0\u7C7B\u6B64\u523B\u65E0\u4EBA\u5B88`
+    });
+    return [];
+  }
+  const body = payload;
+  if (!(key in body)) {
+    problems.push({
+      scope,
+      reason: REASON_UNREAD,
+      kinds,
+      message: `\u4EA7\u7269 ${name} \u91CC\u6CA1\u6709 ${key} \u8FD9\u4E2A\u952E\uFF08\u9876\u5C42\u952E\u662F ${JSON.stringify(Object.keys(body).sort())}\uFF09\u21D2 ${unguardedWord(kinds)} \u8FD9\u51E0\u7C7B\u6B64\u523B\u65E0\u4EBA\u5B88`
+    });
+    return [];
+  }
+  const value = body[key];
+  if (!Array.isArray(value)) {
+    problems.push({
+      scope,
+      reason: REASON_UNREAD,
+      kinds,
+      message: `\u4EA7\u7269 ${name} \u7684 ${key} \u4E0D\u662F\u6570\u7EC4\uFF08${value === null ? "null" : typeof value}\uFF09\u21D2 ${unguardedWord(kinds)} \u8FD9\u51E0\u7C7B\u6B64\u523B\u65E0\u4EBA\u5B88`
+    });
+    return [];
+  }
+  return value;
+}
+function deriveAclass(root, mappingArtifact = null) {
+  const problems = [];
+  const out = Object.fromEntries(ACLASS_KINDS.map((k) => [k, /* @__PURE__ */ new Set()]));
+  for (const row of readJsonl(
+    path9.join(root, ...FIELDS_INDEX),
+    ["fieldKey", "fieldLabel", "caliber"],
+    CLASS_SCOPE,
+    problems
+  )) {
+    const key = token(row.key);
+    if (key !== null) out.fieldKey.add(key);
+    const name = token(row.name);
+    if (name !== null) out.fieldLabel.add(name);
+    const synonyms = row.synonyms;
+    for (const syn of Array.isArray(synonyms) ? synonyms : []) {
+      const one = token(syn);
+      if (one !== null) out.caliber.add(one);
+    }
+  }
+  for (const row of readJsonl(
+    path9.join(root, ...ENUM_MIRROR),
+    ["enumValue"],
+    CLASS_SCOPE,
+    problems
+  )) {
+    const enums = row.enums;
+    for (const element of Array.isArray(enums) ? enums : []) {
+      if (typeof element !== "object" || element === null || Array.isArray(element)) continue;
+      for (const field of ENUM_ELEMENT_KEYS) {
+        const one = token(element[field]);
+        if (one !== null) out.enumValue.add(one);
+      }
+    }
+  }
+  const rosterPath = path9.join(root, ...MODEL_ROSTER);
+  const roster = readJson(rosterPath, ["modelName"], CLASS_SCOPE, problems);
+  if (roster !== UNREADABLE) {
+    const rows = listUnder(roster, "models", rosterPath, ["modelName"], CLASS_SCOPE, problems);
+    const entries = modelEntries(roster);
+    const keys = modelKeys(roster);
+    for (const key of keys) out.modelName.add(key);
+    for (const entry of entries) {
+      const name = token(entry.name);
+      if (name !== null) out.modelName.add(name);
+    }
+    if (rows.length !== entries.length) {
+      problems.push({
+        scope: ENTRY_SCOPE,
+        reason: "dropped-entries",
+        kinds: ["modelName"],
+        message: `models.json \u91CC ${rows.length} \u6761\u6A21\u578B\u6761\u76EE\u6709 ${rows.length - entries.length} \u6761\u4E0D\u662F\u5BF9\u8C61 \u21D2 \u5B83\u4EEC\u7684\u6A21\u578B\u540D\u6CA1\u6709\u8FDB modelName`
+      });
+    }
+    if (entries.length !== keys.length) {
+      problems.push({
+        scope: ENTRY_SCOPE,
+        reason: "dropped-keys",
+        kinds: ["modelName"],
+        message: `models.json \u91CC ${entries.length} \u6761\u6A21\u578B\u6761\u76EE\u6709 ${entries.length - keys.length} \u6761\u6CA1\u6709 modelKey \u21D2 \u5B83\u4EEC\u7684\u82F1\u6587\u6A21\u578B\u540D\u6CA1\u6709\u8FDB modelName`
+      });
+    }
+  }
+  const valueDomain = path9.join(root, VALUE_DOMAIN_DIR);
+  if (existsSync4(valueDomain) && statSync2(valueDomain).isDirectory()) {
+    const tables = readdirSync2(valueDomain).filter((f) => f.endsWith(".json") && !RESERVED_FILENAMES.includes(f)).sort();
+    for (const name of tables) {
+      const file = path9.join(valueDomain, name);
+      const payload = readJson(file, ["codeValue"], ENTRY_SCOPE, problems);
+      if (payload === UNREADABLE) continue;
+      for (const row of listUnder(payload, "rows", file, ["codeValue"], ENTRY_SCOPE, problems)) {
+        if (typeof row !== "object" || row === null || Array.isArray(row)) {
+          problems.push({
+            scope: ENTRY_SCOPE,
+            reason: "bad-row",
+            kinds: ["codeValue"],
+            message: `${name} \u7684 rows \u91CC\u6709\u4E00\u4E2A\u5143\u7D20\u4E0D\u662F\u5BF9\u8C61\uFF08${row === null ? "null" : typeof row}\uFF09\u21D2 \u5B83\u7684\u53D6\u503C\u6CA1\u6709\u8FDB codeValue`
+          });
+          continue;
+        }
+        for (const value of scalarsWithin(row)) out.codeValue.add(value);
+      }
+    }
+  } else {
+    problems.push({
+      scope: CLASS_SCOPE,
+      reason: REASON_UNREAD,
+      kinds: ["codeValue"],
+      message: `\u7F3A\u4EA7\u7269\u76EE\u5F55 ${VALUE_DOMAIN_DIR}/ \u21D2 codeValue \u8FD9\u4E00\u7C7B\u6B64\u523B\u65E0\u4EBA\u5B88`
+    });
+  }
+  let businessKeys = null;
+  if (mappingArtifact === null) {
+    problems.push({
+      scope: CLASS_SCOPE,
+      reason: REASON_UNREAD,
+      kinds: ["naturalKey"],
+      message: `\u6CA1\u6709\u6307\u5B9A\u6620\u5C04\u5DE5\u4EF6 \u21D2 naturalKey \u8FD9\u4E00\u7C7B\u6B64\u523B\u65E0\u4EBA\u5B88\uFF08\u628A ${MAPPING_ARTIFACT_HINT} \u7684\u8DEF\u5F84\u4F20\u8FDB\u6765\uFF09`
+    });
+  } else {
+    try {
+      businessKeys = readBusinessKeyFields(mappingArtifact);
+    } catch (e) {
+      const err = e;
+      problems.push({
+        scope: CLASS_SCOPE,
+        reason: REASON_UNREAD,
+        kinds: ["naturalKey"],
+        message: `\u6620\u5C04\u5DE5\u4EF6\u8BFB\u4E0D\u52A8\uFF08[${err.reason ?? "unknown"}] ${err.message}\uFF09\u21D2 naturalKey \u8FD9\u4E00\u7C7B\u6B64\u523B\u65E0\u4EBA\u5B88`
+      });
+    }
+  }
+  for (const fields of businessKeys ?? []) {
+    for (const field of fields) out.naturalKey.add(field);
+    if (fields.length > 1) {
+      out.naturalKey.add(fields.join("+"));
+    }
+  }
+  const named = unguardedKinds(problems);
+  for (const kind of ACLASS_KINDS) {
+    if (out[kind].size === 0 && !named.has(kind)) {
+      problems.push({
+        scope: CLASS_SCOPE,
+        reason: REASON_EMPTY,
+        kinds: [kind],
+        message: `${kind}\uFF1A\u4EA7\u7269\u8BFB\u5230\u4E86\uFF0C\u4F46\u4E00\u6761\u53D6\u503C\u90FD\u6CA1\u6D3E\u751F\u51FA\u6765 \u21D2 \u95E8 0 \u5BF9\u8FD9\u4E00\u7C7B\u6052\u7EFF\uFF08\u540C\u6279\u53F0\u8D26\u91CC\u82E5\u6709\u6761\u76EE\u7EA7\u95EE\u9898\uFF0C\u771F\u56E0\u5728\u90A3\u91CC\uFF09`
+      });
+    }
+  }
+  return { aclass: out, problems };
+}
+
+// src/fde/gate0/facts.ts
+import { existsSync as existsSync5, readFileSync as readFileSync6 } from "fs";
+import * as path10 from "path";
+var REGISTRY_SCOPE = "registry";
+var ENTRY_SCOPE2 = "entry";
+var REASON_NO_ENTRIES = "no-entries";
+var REASON_PROBE_UNVERIFIED = "probe-unverified";
+var REGISTRY_REASONS = [REASON_NO_ENTRIES, REASON_PROBE_UNVERIFIED];
+var REASON_PROBE_SHAPE = "probe-shape";
+var REASON_PROBE_ABSENT = "probe-absent";
+var REASON_DUPLICATE_TOKEN = "duplicate-token";
+var ENTRY_REASONS = [
+  REASON_PROBE_SHAPE,
+  REASON_PROBE_ABSENT,
+  REASON_DUPLICATE_TOKEN
+];
+var FACTS_REASONS = [...REGISTRY_REASONS, ...ENTRY_REASONS];
+var PROBE_SHAPE = /^(?<file>[A-Za-z0-9_./-]+\.test\.ts)::(?<mark>[A-Za-z0-9_-]+)$/;
+var PROBE_MARK_PREFIX = "// P:";
+var PROTOCOL_FACTS = [
+  {
+    token: "/api/models/{model}/meta",
+    probe: "packages/core/tests/fde-recon-crawl.test.ts::meta-path-wire-shape",
+    note: "\u5B57\u6BB5\u5143\u6570\u636E\u8D70\u88F8\u8DEF\u5F84 GET\uFF0C\u9ED8\u8BA4\u4E0D\u7F00 ?type=\u3002\u63A2\u9488\u65AD\u7684\u662F**\u5B9E\u9645\u53D1\u51FA\u53BB\u7684 URL**\uFF0C\u4E0D\u662F\u62FC\u4E32\u51FD\u6570\u7684\u8FD4\u56DE\u503C\u3002"
+  },
+  {
+    token: "/api/models/{model}/list/dsl",
+    probe: "packages/core/tests/fde-recon-valuedomain.test.ts::list-dsl-count-probe",
+    note: "\u5217\u8868\u67E5\u8BE2\u8D70 POST DSL\u3002\u63A2\u9488\u65AD\u7684\u662F\u884C\u4E3A\uFF1Asize=0 \u7684\u90A3\u4E00\u53D1\u5148\u51FA\u4E14\u8FD4\u56DE totalElements\uFF0C\u53D6\u9875\u5224\u636E\u4EE5\u6B64\u4E3A\u524D\u63D0\u3002"
+  },
+  {
+    token: "/api/auth/login",
+    probe: "packages/core/tests/fde-gate0-facts.test.ts::login-body-carries-tenant",
+    note: "\u767B\u5F55\u7684 tenantId \u5728**\u8BF7\u6C42\u4F53**\u91CC\uFF0C\u4E0D\u5728 header\u3002\u63A2\u9488\u65AD\u7684\u662F\u5B9E\u9645\u53D1\u51FA\u53BB\u7684\u8BF7\u6C42\u4F53\u4E0E\u8BF7\u6C42\u5934\uFF0C\u5220\u6389 tenantId \u6216\u632A\u8FDB header \u90FD\u4F1A\u7EA2\u3002"
+  }
+];
+function loadProtocolFacts(entries = PROTOCOL_FACTS, options = {}) {
+  const problems = [];
+  const probeRoot = options.probeRoot;
+  if (probeRoot === void 0 && entries !== PROTOCOL_FACTS) {
+    problems.push({
+      scope: REGISTRY_SCOPE,
+      reason: REASON_PROBE_UNVERIFIED,
+      index: 0,
+      token: null,
+      message: "\u8FD9\u4EFD\u767B\u8BB0\u518C\u4E0D\u662F\u968F\u5305\u90A3\u4E00\u4EFD\uFF0C\u53C8\u6CA1\u6709\u7ED9\u63A2\u9488\u6839\u76EE\u5F55 \u21D2 \u4E00\u6761\u63A2\u9488\u90FD\u6CA1\u9A8C\u8FC7 \u2014\u2014\u300C\u63A2\u9488\u90FD\u5728\u300D\u4E0E\u300C\u6CA1\u67E5\u63A2\u9488\u300D\u5728\u8FD4\u56DE\u503C\u4E0A\u540C\u5F62\uFF0C\u6240\u4EE5\u8FD9\u91CC\u8BB0\u4E00\u7B14\uFF0C\u4E0D\u88C5\u4F5C\u9A8C\u8FC7"
+    });
+  }
+  if (entries.length === 0) {
+    problems.push({
+      scope: REGISTRY_SCOPE,
+      reason: REASON_NO_ENTRIES,
+      index: 0,
+      token: null,
+      message: "\u767B\u8BB0\u518C\u4E00\u6761\u90FD\u6CA1\u6709 \u2014\u2014 **\u67E5\u8FC7\u4E14\u4E3A\u7A7A**\uFF0C\u4E0D\u662F\u300C\u6CA1\u67E5\u300D"
+    });
+  }
+  const times = /* @__PURE__ */ new Map();
+  for (const entry of entries) times.set(entry.token, (times.get(entry.token) ?? 0) + 1);
+  const facts = [];
+  entries.forEach((entry, position) => {
+    const index = position + 1;
+    if ((times.get(entry.token) ?? 0) > 1) {
+      problems.push({
+        scope: ENTRY_SCOPE2,
+        reason: REASON_DUPLICATE_TOKEN,
+        index,
+        token: entry.token,
+        message: `${entry.token} \u767B\u8BB0\u4E86\u4E0D\u6B62\u4E00\u6B21 \u21D2 \u4E24\u6761\u90FD\u4E0D\u8FDB P\uFF08\u7559\u4E0B\u4EFB\u4F55\u4E00\u8FB9\u90FD\u8981\u56DE\u7B54\u300C\u4EE5\u54EA\u4EFD\u4E3A\u51C6\u300D\uFF09`
+      });
+      return;
+    }
+    const shape = PROBE_SHAPE.exec(entry.probe);
+    if (!shape?.groups) {
+      problems.push({
+        scope: ENTRY_SCOPE2,
+        reason: REASON_PROBE_SHAPE,
+        index,
+        token: entry.token,
+        message: `${entry.token} \u7684\u63A2\u9488 ${JSON.stringify(entry.probe)} \u4E0D\u662F \`<\u6D4B\u8BD5\u6587\u4EF6>.test.ts::<\u6807\u8BB0>\` \u5F62\u6001 \u2014\u2014 \u53EA\u7ED9\u6587\u4EF6\u8DEF\u5F84\u662F\u540C\u4E49\u53CD\u590D\uFF08\u300C\u90A3\u4E2A\u6587\u4EF6\u5B58\u5728\u300D\u4E0D\u7B97\u80CC\u4E66\uFF09`
+      });
+      return;
+    }
+    if (probeRoot !== void 0) {
+      const file = path10.join(probeRoot, shape.groups.file);
+      const mark = `${PROBE_MARK_PREFIX} ${shape.groups.mark}`;
+      const found = existsSync5(file) && readFileSync6(file, "utf8").includes(mark);
+      if (!found) {
+        problems.push({
+          scope: ENTRY_SCOPE2,
+          reason: REASON_PROBE_ABSENT,
+          index,
+          token: entry.token,
+          message: `${entry.token} \u7684\u63A2\u9488\u6307\u5411 ${entry.probe}\uFF0C\u4F46\u90A3\u91CC\u627E\u4E0D\u5230 \`${mark}\` \u8FD9\u6761\u6807\u8BB0 \u21D2 \u8FD9\u6761\u767B\u8BB0\u6CA1\u6709\u80CC\u4E66\uFF0C\u4E0D\u8FDB P`
+        });
+        return;
+      }
+    }
+    facts.push(entry.token);
+  });
+  return { facts, problems };
+}
+
+// src/fde/gate0/scan.ts
+import { readFileSync as readFileSync7, readdirSync as readdirSync3, readlinkSync, statSync as statSync3 } from "fs";
+import * as path11 from "path";
+var CHANNEL_ACLASS = "aclass";
+var CHANNEL_ARTIFACT = "artifact-path";
+var CHANNEL_UNREGISTERED = "protocol-unregistered";
+var CHANNEL_REGISTERED_IS_ACLASS = "registered-but-is-aclass";
+var CHANNEL_NO_PROBE = "no-probe";
+var CHANNELS = [
+  CHANNEL_ACLASS,
+  CHANNEL_ARTIFACT,
+  CHANNEL_UNREGISTERED,
+  CHANNEL_REGISTERED_IS_ACLASS,
+  CHANNEL_NO_PROBE
+];
+var REASON_NO_SKILL_ROOT = "no-skill-root";
+var REASON_NOTHING_SCANNED = "nothing-scanned";
+var REASON_FILE_UNREADABLE = "file-unreadable";
+var REASON_ACLASS_EMPTY = "aclass-empty";
+var REASON_ACLASS_PARTIALLY_UNREAD = "aclass-partially-unread";
+var REASON_REGISTRY = "registry-not-established";
+var REASON_CHANNEL_FOUR_UNCHECKED = "channel-four-unchecked";
+var REASON_BASELINE_ROUND_NOT_COMPLETE = "baseline-round-not-complete";
+var REASON_SYMLINK_NOT_SCANNED = "symlink-not-scanned";
+var PREMISE_REASONS = [
+  REASON_NO_SKILL_ROOT,
+  REASON_NOTHING_SCANNED,
+  REASON_FILE_UNREADABLE,
+  REASON_ACLASS_EMPTY,
+  REASON_ACLASS_PARTIALLY_UNREAD,
+  REASON_REGISTRY,
+  REASON_CHANNEL_FOUR_UNCHECKED,
+  REASON_BASELINE_ROUND_NOT_COMPLETE,
+  REASON_SYMLINK_NOT_SCANNED
+];
+var PREMISE_REGISTRY_REASONS = REGISTRY_REASONS.filter(
+  (r) => r !== REASON_NO_ENTRIES
+);
+var WORD_RE = /[A-Za-z0-9_]+/g;
+var SIMPLE_TOKEN = /^[A-Za-z0-9_]+$/;
+var WORD_CHARS = new Set("abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789_");
+function isWordChar(char) {
+  return char !== void 0 && WORD_CHARS.has(char);
+}
+var ENDPOINT_PREFIXES = ["api", "ws"];
+var ENDPOINT_PATH = `/(?:${ENDPOINT_PREFIXES.join("|")})(?:/(?:\\{[A-Za-z0-9_]+\\}|[A-Za-z0-9_.\\-]+))+`;
+var BARE_ENDPOINT_RE = new RegExp(`(?<![A-Za-z0-9_.\\-/])${ENDPOINT_PATH}`, "g");
+var URL_ENDPOINT_RE = new RegExp(
+  `[A-Za-z][A-Za-z0-9+.\\-]*://[^\\s"'\`<>]*?(${ENDPOINT_PATH})`,
+  "g"
+);
+var HOSTLESS_HOST = `(?:(?:[A-Za-z0-9_\\-]+\\.)+[A-Za-z]{2,}(?::[0-9]+)?|[A-Za-z0-9_\\-]+:[0-9]+)`;
+var HOSTLESS_ENDPOINT_RE = new RegExp(
+  `(?<![A-Za-z0-9_.\\-/:@])${HOSTLESS_HOST}(${ENDPOINT_PATH})`,
+  "g"
+);
+var ERROR_CODE_RE = /(?<![A-Za-z0-9_])[A-Z][A-Z0-9]*(?:_[A-Z0-9]+)+(?![A-Za-z0-9_])/g;
+var PATHISH_RE = /(?<![A-Za-z0-9_./-])\.?[A-Za-z0-9_.-]+(?:\/[A-Za-z0-9_.-]+)+/g;
+var ARTIFACT_SUFFIXES = [".json", ".jsonl"];
+var PRODUCT_FILE_RE = new RegExp(
+  `(?<![A-Za-z0-9_./\\-])[A-Za-z0-9_.\\-]+(?:${ARTIFACT_SUFFIXES.map((s) => s.replace(".", "\\.")).join("|")})(?![A-Za-z0-9_])`,
+  "g"
+);
+var PLACEHOLDER_RE2 = /\{[A-Za-z0-9_]*\}/g;
+var ARTIFACT_ROOT = ".hcmnx";
+var RECON_DIRNAME = "recon";
+var RECON_SEGMENTS_BELOW_ROOT = 2;
+var PRODUCT_RELATIVE_SHAPES = [
+  ["index", ".md"],
+  ["index", ".jsonl"],
+  ["mapping", ".json"],
+  ["meta", ".json"],
+  ["valuedomain", ".json"],
+  ["valuedomain", ".jsonl"]
+];
+var REASON_ENVIRONMENT_FACT = "environment-fact";
+var REASON_PRODUCT_TREE_PATH = "product-tree-path";
+var REASON_PRODUCT_RELATIVE_PATH = "product-relative-path";
+var REASON_PRODUCT_FILE_NAME = "product-file-name";
+var REASON_ENDPOINT = "endpoint";
+var REASON_ERROR_CODE = "error-code";
+var REASON_REGISTERED_IS_ACLASS = "registered-is-aclass";
+var REASON_REJECTED_REGISTRATION = "rejected-registration";
+var RED_REASONS = {
+  [CHANNEL_ACLASS]: [REASON_ENVIRONMENT_FACT],
+  [CHANNEL_ARTIFACT]: [
+    REASON_PRODUCT_TREE_PATH,
+    REASON_PRODUCT_RELATIVE_PATH,
+    REASON_PRODUCT_FILE_NAME
+  ],
+  [CHANNEL_UNREGISTERED]: [REASON_ENDPOINT, REASON_ERROR_CODE],
+  [CHANNEL_REGISTERED_IS_ACLASS]: [REASON_REGISTERED_IS_ACLASS],
+  [CHANNEL_NO_PROBE]: [REASON_REJECTED_REGISTRATION]
+};
+var ARTIFACT_WORDING = {
+  [REASON_PRODUCT_TREE_PATH]: (t) => `\u51FA\u73B0**\u4EA7\u7269\u6811\u91CC\u7684**\u8DEF\u5F84 ${JSON.stringify(t)}`,
+  [REASON_PRODUCT_RELATIVE_PATH]: (t) => `\u51FA\u73B0**\u4EA7\u7269\u6839\u76F8\u5BF9\u8DEF\u5F84** ${JSON.stringify(t)}\uFF08\u4EA7\u7269\u5B50\u76EE\u5F55\u4E0B\u7684\u90A3\u4E00\u4EFD\uFF09`,
+  [REASON_PRODUCT_FILE_NAME]: (t) => `\u51FA\u73B0\u4EA7\u7269\u6587\u4EF6\u540D\u5F62\u6001 ${JSON.stringify(t)}\uFF08\u4EE5 .json/.jsonl \u6536\u5C3E\uFF1B**\u8FD9\u4E00\u6863\u4F1A\u8FC7\u5224**\uFF0C\u5B83\u4E0E\u4EA7\u7269\u65E0\u5173\u65F6\u8BF7\u7167\u76F4\u8BF4\u660E\uFF09`
+};
+function artifactWordingFor(reason) {
+  const wording = ARTIFACT_WORDING[reason];
+  if (wording === void 0) {
+    throw new Error(
+      `\u4EA7\u7269\u8DEF\u5F84\u6210\u56E0 ${JSON.stringify(reason)} \u6CA1\u6709\u5BF9\u5E94\u7684\u63AA\u8F9E\uFF08\u8BA4\u5F97\u7684\u662F ${Object.keys(ARTIFACT_WORDING).join("/")}\uFF09`
+    );
+  }
+  return wording;
+}
+var ACLASS_EMPTY_WHY = {
+  [REASON_UNREAD]: "\uFF08\u4EA7\u7269/\u5DE5\u4EF6\u90A3\u4E00\u5934\u6839\u672C\u6CA1\u8BFB\u5230\uFF09",
+  [REASON_EMPTY]: "\uFF08\u4EA7\u7269\u8BFB\u5230\u4E86\uFF0C\u4E00\u6761\u53D6\u503C\u90FD\u6CA1\u6D3E\u751F\u51FA\u6765\uFF09"
+};
+var GAP_NOISE_TOKEN = "pure-digit-or-single-char";
+var GAP_CJK_INSIDE_LONGER_RUN = "cjk-inside-longer-run";
+var GAP_REASONS = [GAP_NOISE_TOKEN, GAP_CJK_INSIDE_LONGER_RUN];
+function checkReds(reds) {
+  for (const red of reds) {
+    if (!CHANNELS.includes(red.channel)) {
+      throw new Error(
+        `\u5224\u7EA2\u7684 channel \u53EA\u6709 ${CHANNELS.join("/")} \u8FD9\u51E0\u4E2A\u53D6\u503C\uFF0C\u62FF\u5230\u7684\u662F ${JSON.stringify(red.channel)}\uFF08${red.message}\uFF09`
+      );
+    }
+    if (!RED_REASONS[red.channel].includes(red.reason)) {
+      throw new Error(
+        `${JSON.stringify(red.reason)} \u8FD9\u4E2A reason \u4E0D\u5C5E\u4E8E ${red.channel} \u8FD9\u6761\u901A\u9053\uFF08\u8BA4\u5F97\u7684\u662F ${RED_REASONS[red.channel].join("/")}\uFF1B${red.message}\uFF09`
+      );
+    }
+  }
+  return [...reds];
+}
+function checkGaps(gaps) {
+  for (const gap of gaps) {
+    if (!GAP_REASONS.includes(gap.reason)) {
+      throw new Error(
+        `\u7F3A\u53E3\u53F0\u8D26\u7684 reason \u53EA\u6709 ${GAP_REASONS.join("/")} \u4E24\u4E2A\u53D6\u503C\uFF0C\u62FF\u5230\u7684\u662F ${JSON.stringify(gap.reason)}\uFF08${gap.why}\uFF09`
+      );
+    }
+  }
+  return [...gaps];
+}
+function checkPremise(problems) {
+  for (const problem of problems) {
+    if (!PREMISE_REASONS.includes(problem.reason)) {
+      throw new Error(
+        `\u524D\u63D0\u7EA7\u53F0\u8D26\u7684 reason \u4E0D\u5728\u53D6\u503C\u57DF\u91CC\uFF1A${JSON.stringify(problem.reason)}\uFF08${problem.message}\uFF09`
+      );
+    }
+  }
+  return [...problems];
+}
+function baselineRoundPremise(round) {
+  const state = round && typeof round === "object" ? round.state : void 0;
+  if (state === "complete") return [];
+  return [
+    {
+      reason: REASON_BASELINE_ROUND_NOT_COMPLETE,
+      message: `\u8FD9\u4EFD\u57FA\u7EBF\u7684\u8F6E\u6B21\u72B6\u6001\u662F ${JSON.stringify(state)}\uFF08\u4E0D\u662F complete\uFF09\u21D2 A \u7C7B\u4E8B\u5B9E\u662F\u4ECE**\u6DF7\u7740\u4E0D\u540C\u8F6E\u6B21 / \u5224\u4E0D\u4E86\u8F6E\u6B21**\u7684\u4EA7\u7269\u91CC\u73B0\u7B97\u7684\uFF0C\u300C\u5224\u7EA2 0 \u6761\u300D\u5BF9\u54EA\u4E00\u8F6E\u90FD\u4E0D\u7B97\u6570\u3002\u5148\u8DD1 \`hcm delivery recon round\` \u770B\u662F\u54EA\u51E0\u4EFD\uFF0C\u6216\u91CD\u8DD1\u4E00\u6B21 \`hcm delivery recon\`\u3002\u26A0\uFE0F **\`hcm delivery recon\` \u8981\u8FDE\u5BA2\u6237\u5185\u7F51\u7684 HCM** \u2014\u2014 \u62FF\u4E0D\u5230\u7F51\u7684\u673A\u5668\u4E0A\u8FD9\u6761\u51FA\u8DEF\u8D70\u4E0D\u901A\uFF0C\u6B64\u65F6**\u522B\u628A\u8FD9\u4EFD\u57FA\u7EBF\u5F53 complete \u7528**\uFF0C\u628A\u5B83\u5E26\u56DE\u8FDE\u5F97\u4E0A\u7684\u5730\u65B9\u91CD\u722C`
+    }
+  ];
+}
+function inGap(token2) {
+  return [...token2].length <= 1 || /^\p{Nd}+$/u.test(token2);
+}
+function allMatches(regex, line) {
+  const out = [];
+  const re = new RegExp(regex.source, regex.flags.includes("g") ? regex.flags : `${regex.flags}g`);
+  let m;
+  while ((m = re.exec(line)) !== null) {
+    if (m[0] === "") {
+      re.lastIndex += 1;
+      continue;
+    }
+    out.push(m);
+  }
+  return out;
+}
+function overlaps(span, spans) {
+  return spans.some(([s, e]) => span[0] < e && s < span[1]);
+}
+function endpointsIn(line) {
+  const out = [];
+  for (const regex of [URL_ENDPOINT_RE, HOSTLESS_ENDPOINT_RE]) {
+    for (const m of allMatches(regex, line)) {
+      const span = [m.index, m.index + m[0].length];
+      if (!overlaps(
+        span,
+        out.map(([, s]) => s)
+      )) {
+        out.push([m[1], span]);
+      }
+    }
+  }
+  for (const m of allMatches(BARE_ENDPOINT_RE, line)) {
+    const span = [m.index, m.index + m[0].length];
+    if (!overlaps(
+      span,
+      out.map(([, s]) => s)
+    )) {
+      out.push([m[0], span]);
+    }
+  }
+  return out;
+}
+function normalize(token2) {
+  return token2.replace(PLACEHOLDER_RE2, "{}");
+}
+function factsIndex(facts) {
+  return facts.map((token2) => segmentsOf(normalize(token2)));
+}
+function covered(token2, index) {
+  const segments = segmentsOf(normalize(token2));
+  return index.some(
+    (template) => template.length === segments.length && template.every((t, i) => t === "{}" || t === segments[i])
+  );
+}
+var SEGMENT_SEPARATOR = "/";
+function segmentsOf(token2) {
+  return token2.split(SEGMENT_SEPARATOR);
+}
+function artifactReason(token2) {
+  const segments = segmentsOf(token2);
+  const head = segments.slice(0, -1);
+  const last = segments[segments.length - 1] ?? "";
+  if (head.includes(ARTIFACT_ROOT)) return REASON_PRODUCT_TREE_PATH;
+  for (let i = 0; i < head.length; i += 1) {
+    if (head[i] === RECON_DIRNAME && segments.length - i - 1 > RECON_SEGMENTS_BELOW_ROOT) {
+      return REASON_PRODUCT_TREE_PATH;
+    }
+  }
+  if (segments.length === 2 && PRODUCT_RELATIVE_SHAPES.some(
+    ([subdir, suffix]) => segments[0] === subdir && last.endsWith(suffix)
+  )) {
+    return REASON_PRODUCT_RELATIVE_PATH;
+  }
+  if (ARTIFACT_SUFFIXES.some((suffix) => last.endsWith(suffix))) return REASON_PRODUCT_FILE_NAME;
+  return null;
+}
+var CJK_RANGES = [
+  [13312, 19903],
+  [19968, 40959],
+  [63744, 64255]
+];
+function isCjk(char) {
+  const code = char?.codePointAt(0);
+  return code !== void 0 && CJK_RANGES.some(([low, high]) => code >= low && code <= high);
+}
+function boundedFind(line, token2) {
+  let start = line.indexOf(token2);
+  while (start >= 0) {
+    const end = start + token2.length;
+    const leftOk = start === 0 || !(isWordChar(token2[0]) && isWordChar(line[start - 1]));
+    const rightOk = end >= line.length || !(isWordChar(token2[token2.length - 1]) && isWordChar(line[end]));
+    if (leftOk && rightOk) return start;
+    start = line.indexOf(token2, start + 1);
+  }
+  return -1;
+}
+function cjkRunAt(line, start, token2) {
+  const end = start + token2.length;
+  if (isCjk(token2[0]) && start > 0 && isCjk(line[start - 1])) return true;
+  return isCjk(token2[token2.length - 1]) && end < line.length && isCjk(line[end]);
+}
+var Matcher = class {
+  owners;
+  simple;
+  byFirst;
+  constructor(aclass) {
+    this.owners = /* @__PURE__ */ new Map();
+    for (const kind of ACLASS_KINDS) {
+      for (const token2 of [...aclass[kind] ?? []].sort()) {
+        const owned = this.owners.get(token2);
+        if (owned) owned.push(kind);
+        else this.owners.set(token2, [kind]);
+      }
+    }
+    this.simple = new Set([...this.owners.keys()].filter((t) => SIMPLE_TOKEN.test(t)));
+    this.byFirst = /* @__PURE__ */ new Map();
+    for (const token2 of this.owners.keys()) {
+      if (this.simple.has(token2)) continue;
+      const first = token2[0];
+      if (first === void 0) continue;
+      const bucket = this.byFirst.get(first);
+      if (bucket) bucket.push(token2);
+      else this.byFirst.set(first, [token2]);
+    }
+  }
+  /**
+   * → 这一行命中的 `[(token, **有边界的**那一处的位置)]`，同一 token 一行只报一次。
+   *
+   * 🔴 **位置必须来自 `boundedFind`，不许再算一遍 `indexOf`**。起手那版用 `boundedFind`
+   * 确认「这一行**存在**一处合法边界命中」，返回的却是第一处裸子串 —— 可能根本不是那一处。
+   * 下游把这个位置交给 `cjkRunAt` 做分桶，于是**在同一行前面加一处诱饵写法就能把一条
+   * 真红压掉**。辖区 = 首/末字符为 CJK、另一端为词字符的**混合形态** token；纯 ASCII 与
+   * 纯 CJK 两个位置必然相等，所以此前每一项变异都照不到它。
+   * 「存在一处合法命中」是「这一处合法」的**必要条件**，不是充分条件。
+   *
+   * 🔴 **`sort` 不是洁癖，它是这份输出的确定性本身**：按插入序遍历会让非纯词形 token 的
+   * 先后随输入变化，集合、rc、判词全都一样，只有顺序变 —— 那正是「静默」的定义，
+   * 而它坏的是**验证仪器**：任何「前后两版输出逐字相等」的复核都会假红。
+   */
+  hits(line) {
+    const seen = /* @__PURE__ */ new Set();
+    const result = [];
+    for (const m of allMatches(WORD_RE, line)) {
+      const token2 = m[0];
+      if (token2 !== void 0 && this.simple.has(token2) && !seen.has(token2)) {
+        seen.add(token2);
+        result.push([token2, boundedFind(line, token2)]);
+      }
+    }
+    for (const char of [.../* @__PURE__ */ new Set([...line])].sort()) {
+      for (const token2 of this.byFirst.get(char) ?? []) {
+        if (seen.has(token2)) continue;
+        const start = boundedFind(line, token2);
+        if (start >= 0) {
+          seen.add(token2);
+          result.push([token2, start]);
+        }
+      }
+    }
+    return result;
+  }
+};
+function classReasons(problems) {
+  const out = /* @__PURE__ */ new Map();
+  for (const problem of problems ?? []) {
+    if (problem.scope === CLASS_SCOPE) {
+      for (const kind of problem.kinds) out.set(kind, problem.reason);
+    }
+  }
+  return out;
+}
+var INVISIBLE_RE = /\p{Cf}/u;
+var FULLWIDTH_ALNUM_RANGES = [
+  [65296, 65305, 65296 - 48],
+  [65313, 65338, 65313 - 65],
+  [65345, 65370, 65345 - 97]
+];
+var FOLDED_NOTE = "\uFF1B\u26A0\uFE0F \u8FD9\u4E00\u5904\u662F**\u5F52\u4E00\u4E4B\u540E**\u624D\u8BA4\u51FA\u6765\u7684\uFF1A\u539F\u6587\u91CC\u5939\u4E86\u4E0D\u53EF\u89C1\u5B57\u7B26\u6216\u5168\u89D2\u5B57\u7B26\uFF0C\u76F4\u63A5\u6309\u4E0A\u9762\u8FD9\u4E2A\u8BCD\u53BB grep \u4F1A\u641C\u4E0D\u5230";
+var foldedOriginal = (literal) => `\uFF0C\u539F\u6587\u91CC\u90A3\u4E00\u6BB5\u662F ${JSON.stringify(literal)}`;
+function foldWithMap(line) {
+  const out = [];
+  const origin = [];
+  for (let i = 0; i < line.length; i += 1) {
+    const char = line[i];
+    if (INVISIBLE_RE.test(char)) continue;
+    const code = char.charCodeAt(0);
+    let folded = char;
+    for (const [low, high, offset] of FULLWIDTH_ALNUM_RANGES) {
+      if (code >= low && code <= high) {
+        folded = String.fromCharCode(code - offset);
+        break;
+      }
+    }
+    out.push(folded);
+    origin.push(i);
+  }
+  return [out.join(""), origin];
+}
+function foldConfusables(line) {
+  return foldWithMap(line)[0];
+}
+function foldedNoteFor(original, folded, token2) {
+  if (original.includes(token2)) return "";
+  let start = boundedFind(folded, token2);
+  if (start < 0) start = folded.indexOf(token2);
+  if (start < 0) {
+    return FOLDED_NOTE;
+  }
+  const [, origin] = foldWithMap(original);
+  const from = origin[start];
+  const to = origin[start + token2.length - 1];
+  if (from === void 0 || to === void 0) return FOLDED_NOTE;
+  return FOLDED_NOTE + foldedOriginal(original.slice(from, to + 1));
+}
+function judgeLine(line, lineno, rel, matcher, index, reds, gaps) {
+  const folded = foldConfusables(line);
+  const lineReds = [];
+  const lineGaps = [];
+  judgePass(line, lineno, rel, matcher, index, lineReds, lineGaps);
+  if (folded !== line) judgePass(folded, lineno, rel, matcher, index, lineReds, lineGaps);
+  const seen = /* @__PURE__ */ new Set();
+  const unique2 = [];
+  for (const red of lineReds) {
+    const key = `${red.channel} ${red.token}`;
+    if (seen.has(key)) continue;
+    seen.add(key);
+    unique2.push({ ...red, message: red.message + foldedNoteFor(line, folded, red.token) });
+  }
+  reds.push(...unique2);
+  const redTokens = new Set(unique2.filter((r) => r.channel === CHANNEL_ACLASS).map((r) => r.token));
+  const seenGaps = /* @__PURE__ */ new Set();
+  for (const gap of lineGaps) {
+    const key = `${gap.reason} ${gap.token}`;
+    if (seenGaps.has(key) || folded !== line && redTokens.has(gap.token)) continue;
+    seenGaps.add(key);
+    gaps.push({ ...gap, why: gap.why + foldedNoteFor(line, folded, gap.token) });
+  }
+}
+function judgePass(line, lineno, rel, matcher, index, reds, gaps) {
+  for (const [token2, start] of matcher.hits(line)) {
+    const kinds = matcher.owners.get(token2) ?? [];
+    if (inGap(token2)) {
+      gaps.push({
+        reason: GAP_NOISE_TOKEN,
+        token: token2,
+        kinds,
+        path: rel,
+        line: lineno,
+        why: `${rel}:${lineno} \u7EAF\u6570\u5B57 / \u5355\u5B57\u7B26 ${JSON.stringify(token2)} \u2014\u2014 \u5224\u7EA2\u8FD9\u4E00\u5C42**\u58F0\u660E\u7684\u7F3A\u53E3**\uFF0C\u67E5\u8FC7\u3001\u6309\u7F3A\u53E3\u653E\u884C`
+      });
+      continue;
+    }
+    if (cjkRunAt(line, start, token2)) {
+      gaps.push({
+        reason: GAP_CJK_INSIDE_LONGER_RUN,
+        token: token2,
+        kinds,
+        path: rel,
+        line: lineno,
+        why: `${rel}:${lineno} ${JSON.stringify(token2)}\uFF08A \u7C7B ${kinds.join("/")}\uFF09\u843D\u5728\u4E00\u4E32\u66F4\u957F\u7684\u4E2D\u6587\u91CC \u2014\u2014 \u4E2D\u6587\u6CA1\u6709\u5206\u8BCD\u8FB9\u754C\uFF0C**\u8BF4\u4E0D\u51C6**\u5B83\u662F\u4E0D\u662F\u90A3\u4E2A\u53D6\u503C\uFF1B\u4E0D\u9876 rc\uFF0C\u8BF7\u81EA\u5DF1\u770B\u4E00\u773C`
+      });
+      continue;
+    }
+    reds.push({
+      channel: CHANNEL_ACLASS,
+      reason: REASON_ENVIRONMENT_FACT,
+      token: token2,
+      path: rel,
+      line: lineno,
+      kinds,
+      message: `${rel}:${lineno} \u51FA\u73B0\u73AF\u5883\u4E8B\u5B9E ${JSON.stringify(token2)}\uFF08A \u7C7B ${kinds.join("/")}\uFF09\u2014\u2014 \u6362\u4E2A\u5BA2\u6237\u5C31\u5168\u9519\uFF0C**\u65E0\u8C41\u514D**`
+    });
+  }
+  const spans = [];
+  for (const [token2, span] of endpointsIn(line)) {
+    spans.push(span);
+    judgeProtocol(token2, REASON_ENDPOINT, "\u7AEF\u70B9", lineno, rel, matcher, index, reds);
+  }
+  for (const regex of [PATHISH_RE, PRODUCT_FILE_RE]) {
+    for (const m of allMatches(regex, line)) {
+      const span = [m.index, m.index + m[0].length];
+      if (overlaps(span, spans)) continue;
+      const token2 = m[0];
+      const reason = artifactReason(token2);
+      if (reason === null) continue;
+      spans.push(span);
+      reds.push({
+        channel: CHANNEL_ARTIFACT,
+        reason,
+        token: token2,
+        path: rel,
+        line: lineno,
+        kinds: [],
+        message: `${rel}:${lineno} ${artifactWordingFor(reason)(token2)} \u2014\u2014 \u4EA7\u7269\u8DEF\u5F84**\u65E0\u8C41\u514D**\uFF0C\u767B\u8BB0\u518C\u4E0D\u53D7\u7406\u5B83\uFF1Bskill \u6B63\u6587\u8BE5\u8BF4\u7684\u662F\u8DD1\u54EA\u6761\u547D\u4EE4\uFF0C\u4E0D\u662F\u53BB\u8BFB\u54EA\u4E2A\u6587\u4EF6`
+      });
+    }
+  }
+  for (const m of allMatches(ERROR_CODE_RE, line)) {
+    const span = [m.index, m.index + m[0].length];
+    if (overlaps(span, spans)) continue;
+    spans.push(span);
+    judgeProtocol(m[0], REASON_ERROR_CODE, "\u9519\u8BEF\u7801", lineno, rel, matcher, index, reds);
+  }
+}
+function judgeProtocol(token2, reason, shape, lineno, rel, matcher, index, reds) {
+  if (matcher.owners.has(token2)) return;
+  if (covered(token2, index)) return;
+  reds.push({
+    channel: CHANNEL_UNREGISTERED,
+    reason,
+    token: token2,
+    path: rel,
+    line: lineno,
+    kinds: [],
+    message: `${rel}:${lineno} \u51FA\u73B0${shape} ${JSON.stringify(token2)}\uFF0C\u800C\u5B83**\u6CA1\u6709\u767B\u8BB0**\u5728\u968F\u5305\u7684\u534F\u8BAE\u4E8B\u5B9E\u767B\u8BB0\u518C\u91CC \u21D2 \u8981\u4E48\u6539\u5199\u6210\u4E0D\u4F9D\u8D56\u5B83\u7684\u8BF4\u6CD5\uFF0C\u8981\u4E48\u7ED9 CLI \u63D0\u4E00\u6761\u767B\u8BB0\uFF08\u767B\u8BB0\u5FC5\u987B\u9644\u4E00\u4E2A\u65AD\u884C\u4E3A\u7684\u63A2\u9488\uFF09`
+  });
+}
+function scan(skillRoot, aclass, facts, options = {}) {
+  const reds = [];
+  const premise = [];
+  const gaps = [];
+  const scanned = [];
+  const matcher = new Matcher(aclass);
+  const index = factsIndex(facts);
+  const reasons = classReasons(options.aclassProblems);
+  for (const kind of ACLASS_KINDS) {
+    if ((aclass[kind]?.size ?? 0) > 0) continue;
+    const reason = reasons.get(kind);
+    let why = "";
+    if (reason !== void 0) {
+      if (!(reason in ACLASS_EMPTY_WHY)) {
+        throw new Error(
+          `\u7C7B\u7EA7\u6210\u56E0 ${JSON.stringify(reason)} \u6CA1\u6709\u5BF9\u5E94\u7684\u63AA\u8F9E\uFF08\u8BA4\u5F97\u7684\u662F ${CLASS_REASONS.join("/")}\uFF09`
+        );
+      }
+      why = ACLASS_EMPTY_WHY[reason];
+    }
+    premise.push({
+      reason: REASON_ACLASS_EMPTY,
+      message: `A \u7C7B\u5B50\u96C6 ${kind} \u662F\u7A7A\u7684${why} \u21D2 \u95E8 0 \u5BF9\u8FD9\u4E00\u7C7B**\u6052\u7EFF**\uFF0C\u8FD9\u4E00\u8F6E\u7684\u7EFF\u4E0D\u7B97\u6570`
+    });
+  }
+  for (const problem of options.aclassProblems ?? []) {
+    if (problem.scope !== ENTRY_SCOPE) continue;
+    premise.push({
+      reason: REASON_ACLASS_PARTIALLY_UNREAD,
+      message: `A \u7C7B\u5B50\u96C6 ${problem.kinds.join("/")} \u5C11\u4E86\u4E00\u90E8\u5206\uFF08${problem.reason}\uFF09\uFF1A${problem.message} \u21D2 \u5C11\u6389\u7684\u90A3\u90E8\u5206\u95E8 0 \u5224\u4E0D\u51FA\u6765\uFF0C\u8FD9\u4E00\u8F6E\u7684\u7EFF\u4E0D\u7B97\u6570`
+    });
+  }
+  let factsProblems = options.factsProblems;
+  if (factsProblems === void 0) {
+    premise.push({
+      reason: REASON_CHANNEL_FOUR_UNCHECKED,
+      message: "\u6CA1\u6709\u628A loadProtocolFacts \u7684\u53F0\u8D26\u4F20\u8FDB\u6765 \u21D2 \u901A\u9053\u56DB\uFF08\u767B\u8BB0\u9879\u88AB\u62D2\uFF09\u4E00\u6761\u90FD\u6CA1\u67E5\u8FC7\u2014\u2014\u300C\u767B\u8BB0\u518C\u5E72\u51C0\u300D\u4E0E\u300C\u6CA1\u67E5\u767B\u8BB0\u518C\u300D\u5728\u8FD4\u56DE\u503C\u4E0A\u540C\u5F62"
+    });
+    factsProblems = [];
+  }
+  for (const problem of factsProblems) {
+    if (problem.scope === REGISTRY_SCOPE && PREMISE_REGISTRY_REASONS.includes(problem.reason)) {
+      premise.push({
+        reason: REASON_REGISTRY,
+        message: `\u767B\u8BB0\u518C\u8FD9\u4E00\u5C42\u6CA1\u7ACB\u4F4F\uFF08${problem.reason}\uFF09\uFF1A${problem.message} \u21D2 \u8C41\u514D\u901A\u9053 P \u4E0D\u53EF\u4FE1`
+      });
+    }
+  }
+  for (const problem of factsProblems) {
+    if (problem.scope === REGISTRY_SCOPE) continue;
+    reds.push({
+      channel: CHANNEL_NO_PROBE,
+      reason: REASON_REJECTED_REGISTRATION,
+      token: problem.token ?? `(\u7B2C${problem.index}\u6761)`,
+      path: null,
+      line: 0,
+      kinds: [],
+      message: `\u767B\u8BB0\u518C\u7B2C ${problem.index} \u6761\u88AB\u62D2\uFF08${problem.reason}\uFF09\uFF1A${problem.message}`
+    });
+  }
+  for (const token2 of [...facts].sort()) {
+    const kinds = matcher.owners.get(token2);
+    if (!kinds) continue;
+    reds.push({
+      channel: CHANNEL_REGISTERED_IS_ACLASS,
+      reason: REASON_REGISTERED_IS_ACLASS,
+      token: token2,
+      path: null,
+      line: 0,
+      kinds,
+      message: `\u767B\u8BB0\u518C\u767B\u8BB0\u4E86 ${JSON.stringify(token2)}\uFF0C\u800C\u5B83\u662F A \u7C7B\u73AF\u5883\u4E8B\u5B9E\uFF08${kinds.join("/")}\uFF09\u2014\u2014 recon \u67E5\u5F97\u5230\u7684\u4E1C\u897F\u4E0D\u662F\u7248\u672C\u7EA7\u534F\u8BAE\uFF0C\u767B\u8BB0\u5B83\u4E70\u4E0D\u5230\u4EFB\u4F55\u8C41\u514D`
+    });
+  }
+  let files = [];
+  if (!isDirectory(skillRoot)) {
+    premise.push({
+      reason: REASON_NO_SKILL_ROOT,
+      message: `\u626B\u63CF\u9762 ${skillRoot} \u4E0D\u662F\u4E00\u4E2A\u76EE\u5F55 \u21D2 \u4E00\u4E2A\u5B57\u90FD\u6CA1\u626B\u8FC7\uFF08\u8FD9\u4E0D\u662F\u300C\u626B\u8FC7\u3001\u5E72\u51C0\u300D\uFF09`
+    });
+  } else {
+    const walked = walk2(skillRoot);
+    files = walked.files;
+    for (const link of walked.unscannedLinks) {
+      let target;
+      try {
+        target = readlinkSync(link);
+      } catch {
+        target = "(\u8BFB\u4E0D\u51FA\u94FE\u63A5\u76EE\u6807)";
+      }
+      premise.push({
+        reason: REASON_SYMLINK_NOT_SCANNED,
+        message: `${path11.relative(skillRoot, link)} \u662F\u4E00\u4E2A\u7B26\u53F7\u94FE\u63A5\uFF08\u6307\u5411 ${JSON.stringify(target)}\uFF09\u21D2 \u95E8 0 **\u6CA1\u6709\u987A\u7740\u5B83\u626B\u8FC7\u4E00\u4E2A\u5B57**\uFF0C\u8FD9\u4E00\u8F6E\u7684\u7EFF\u4E0D\u7B97\u6570\u3002\u51FA\u8DEF\uFF1A\u628A\u8FD9\u6761\u94FE\u4ECE skill \u91CC\u53BB\u6389 \u2014\u2014 \u94FE\u540E\u9762\u90A3\u4EFD\u5185\u5BB9\u672C\u8BE5\u88AB\u5224\u5C31 \`cp -RL\` \u62F7\u6210\u771F\u5185\u5BB9\uFF08\u26A0\uFE0F \u73AF\u8DEF\u4E0E\u65AD\u94FE\u4E0A\u5B83\u4F1A\u5F53\u573A\u62A5\u9519\uFF0C\u90A3\u4E24\u79CD\u76F4\u63A5\u5220\uFF09\uFF1B\u5185\u5BB9\u5DF2\u7ECF\u5728 skill \u91CC\uFF08\u6307\u5411\u540C\u6811\u7684\u522B\u540D\uFF09\u4E5F\u76F4\u63A5\u5220\u3002**\u4E0D\u8DDF\u968F**\u662F\u523B\u610F\u7684 \u2014\u2014 \u8DDF\u8FC7\u53BB\u4F1A\u8FDE\u4E0A\u73AF\u8DEF\u3001\u6216\u8D8A\u51FA skill \u76EE\u5F55\u626B\u5230\u65E0\u5173\u6587\u4EF6`
+      });
+    }
+    if (files.length === 0) {
+      premise.push({
+        reason: REASON_NOTHING_SCANNED,
+        message: `\u626B\u63CF\u9762 ${skillRoot} \u5728\u76D8\u4E0A\uFF0C\u4F46\u91CC\u9762\u4E00\u4E2A\u6587\u4EF6\u90FD\u6CA1\u6709 \u2014\u2014 \u67E5\u8FC7\u4E14\u4E3A\u7A7A`
+      });
+    }
+  }
+  for (const file of files) {
+    let text;
+    try {
+      text = readFileSync7(file, "utf8");
+    } catch (e) {
+      premise.push({
+        reason: REASON_FILE_UNREADABLE,
+        message: `${file} \u8BFB\u4E0D\u52A8\uFF08${String(e)}\uFF09\u21D2 \u5224\u4E0D\u4E86\u5B83\u5E72\u4E0D\u5E72\u51C0\uFF0C\u95E8 0 \u4E0D\u80FD\u5BF9\u7740\u5B83\u8BF4\u7EFF`
+      });
+      continue;
+    }
+    const rel = path11.relative(skillRoot, file);
+    scanned.push(rel);
+    text.split("\n").forEach((line, i) => {
+      judgeLine(line, i + 1, rel, matcher, index, reds, gaps);
+    });
+  }
+  const seen = /* @__PURE__ */ new Set();
+  const unique2 = [];
+  for (const red of checkReds(reds)) {
+    const key = `${red.channel} ${red.token} ${red.path} ${red.line}`;
+    if (seen.has(key)) continue;
+    seen.add(key);
+    unique2.push(red);
+  }
+  const channels = Object.fromEntries(
+    CHANNELS.map((name) => [name, unique2.filter((r) => r.channel === name)])
+  );
+  return {
+    red: unique2,
+    channels,
+    scanned,
+    gaps: checkGaps(gaps),
+    premise: checkPremise(premise)
+  };
+}
+function isDirectory(target) {
+  try {
+    return statSync3(target).isDirectory();
+  } catch {
+    return false;
+  }
+}
+function walk2(root) {
+  const files = [];
+  const unscannedLinks = [];
+  const visit = (dir) => {
+    for (const entry of readdirSync3(dir, { withFileTypes: true })) {
+      const full = path11.join(dir, entry.name);
+      let followed = null;
+      try {
+        followed = statSync3(full);
+      } catch {
+        followed = null;
+      }
+      if (followed?.isFile()) {
+        files.push(full);
+      } else if (entry.isSymbolicLink()) {
+        unscannedLinks.push(full);
+      } else if (followed?.isDirectory()) {
+        visit(full);
+      }
+    }
+  };
+  visit(root);
+  return { files: files.sort(), unscannedLinks: unscannedLinks.sort() };
+}
+function exitCode(result) {
+  if (result.premise.length > 0) return 2;
+  if (result.red.length > 0) return 1;
+  return 0;
+}
 export {
+  ACLASS_EMPTY_WHY,
+  ACLASS_KINDS,
+  ARTIFACT_ROOT,
+  ARTIFACT_SUFFIXES,
+  ARTIFACT_WORDING,
   AUTH_INFO_PATH,
   BLIND_SPOTS,
+  CHANNELS,
+  CHANNEL_ACLASS,
+  CHANNEL_ARTIFACT,
+  CHANNEL_NO_PROBE,
+  CHANNEL_REGISTERED_IS_ACLASS,
+  CHANNEL_UNREGISTERED,
+  CLASS_REASONS,
+  CLASS_SCOPE,
   CliError,
   CliErrorCode,
   DEFAULT_AGENT_ID,
   DEFAULT_SESSION_TTL_SECONDS,
   DOCTOR_ANCHORS,
+  ENDPOINT_PREFIXES,
+  ENTRY_SCOPE,
+  ENUM_ELEMENT_KEYS,
   EXTENSION_SOURCE_HEADER,
   ExitCode,
+  FACTS_REASONS,
+  FOLDED_NOTE,
+  FULLWIDTH_ALNUM_RANGES,
+  GAP_CJK_INSIDE_LONGER_RUN,
+  GAP_NOISE_TOKEN,
+  GAP_REASONS,
   GATE_COMPONENTS,
   HcmClient,
+  KIT_CARRY_OVER_KEY,
+  KIT_CRAWLED_AT_FILE,
+  LEDGER_MISSING_WORD,
   LayoutContainmentError,
   MANIFEST_PATH,
+  MAPPING_ARTIFACT_VERSION,
   MAX_MANIFEST_PAGES,
   MAX_SOURCE_PROBES,
   META_PATH,
@@ -5763,21 +8716,51 @@ export {
   MINI_REMOTE_ROOT,
   MINI_STATE_DIR,
   MODELS_PATH,
+  MappingArtifactError,
+  Matcher,
   PASSWORD_CHANGE_REQUIRED,
+  PREMISE_REASONS,
+  PREMISE_REGISTRY_REASONS,
   PROACTIVE_REFRESH_MARGIN_SECONDS,
+  PROBE_MARK_PREFIX,
+  PRODUCT_RELATIVE_SHAPES,
+  PRODUCT_STATE_WORDS,
+  PROTOCOL_FACTS,
+  REASON_DUPLICATE_TOKEN,
+  REASON_EMPTY,
+  REASON_NO_ENTRIES,
+  REASON_PROBE_ABSENT,
+  REASON_PROBE_SHAPE,
+  REASON_PROBE_UNVERIFIED,
+  REASON_UNREAD,
+  RECON_DIRNAME,
+  RECON_SEGMENTS_BELOW_ROOT,
+  RED_REASONS,
+  REGISTRY_REASONS,
+  REGISTRY_SCOPE,
+  ROUND_EXIT_CODES,
+  ROUND_STAMPED_PRODUCTS,
+  ROUND_STATES,
+  ROUND_SUBCOMMAND,
   ReconLayout,
   RefStore,
+  SCOPES,
   SDK_VERSION,
+  SEGMENT_SEPARATOR,
+  TargetModelNotFound,
   TokenStore,
   VERSION_PATH,
   WsClient,
   absoluteDownloadUrl,
   adminResetPassword,
   archiveDir,
+  artifactReason,
   assertSafeReferencePath,
   assertSafeSkillFilePath,
   assertSafeSkillId,
+  baselineRoundPremise,
   bootstrapTenant,
+  boundedFind,
   buildAnswer,
   buildConfirm,
   buildInterrupt,
@@ -5789,12 +8772,18 @@ export {
   buildSteer,
   camelizeKeys,
   changePassword,
+  checkGaps,
+  checkPremise,
+  checkReds,
+  cjkRunAt,
   classifyMessage,
   clearMetaCache,
   clearModelCache,
   compareFingerprint,
   computeFingerprint,
+  computeReconSourceKey,
   conversationStateFile,
+  covered,
   create,
   createConversation,
   createHttpClient,
@@ -5807,6 +8796,7 @@ export {
   deleteIdentity,
   deleteTenantMeta,
   deleteWorkspaceFile,
+  deriveAclass,
   deriveNamelessToolLabel,
   describePrincipal,
   detectDelegationPause,
@@ -5814,12 +8804,15 @@ export {
   detectPasswordChangeChallenge,
   displayWidth,
   downloadDocument,
+  endpointsIn,
   ensureSessionFresh,
   envDir,
   envFile,
   envsDir,
+  exitCode,
   exitCodeFor,
   extractNextSteps,
+  factsIndex,
   fetchConversationTimeline,
   fetchConversationTimelineStrict,
   fetchRecentConversations,
@@ -5831,6 +8824,8 @@ export {
   filterByStage,
   findLastAssistantSeq,
   flattenSkills,
+  foldConfusables,
+  foldedNoteFor,
   formatMiniVerifyReport,
   formatObject,
   formatRows,
@@ -5846,9 +8841,12 @@ export {
   identitiesDir,
   identityDir,
   identityMetaFile,
+  inGap,
   inferEnvName,
   inferMiniWritableTemplateOptionsFromModel,
   initMiniAppProject,
+  inspectRound,
+  isCjk,
   isDelegationToolName,
   isServerSlidingSession,
   listEnvs,
@@ -5861,6 +8859,7 @@ export {
   loadGlobalConfig,
   loadIdentity,
   loadProfile,
+  loadProtocolFacts,
   loadWorkspaceFileContent,
   loginClientCredentials,
   loginPairing,
@@ -5871,6 +8870,8 @@ export {
   modelEntries,
   modelKeys,
   needsRefresh,
+  newRoundId,
+  normalize,
   normalizeReferences,
   oneShot,
   parseConfirmToolName,
@@ -5887,10 +8888,12 @@ export {
   profileFile,
   pullMiniAppProject,
   pushMiniAppProject,
+  readBusinessKeyFields,
   readMiniContext,
   readPullManifest,
   refreshToken,
   remove,
+  renderRound,
   replHistoryFile,
   resetSettingItem,
   resolveActiveEnv,
@@ -5900,9 +8903,11 @@ export {
   resolveChironBase,
   resolveRefs,
   resolveSkillInstallOrder,
+  roundAge,
   runDoctor,
   runImport,
   runMiniSmokeChecks,
+  runRecon,
   safeSegment,
   saveConversationState,
   saveEnv,
@@ -5911,6 +8916,8 @@ export {
   saveProfile,
   saveTenantMeta,
   saveWorkspaceFileContent,
+  scan,
+  segmentsOf,
   sendMessageAndStream,
   snakeToCamel,
   tenantSegment,
@@ -5920,6 +8927,7 @@ export {
   toTable,
   toYaml,
   truncateDisplay,
+  unguardedKinds,
   update,
   uploadDocument,
   validateMiniProject