@hcmai/sdk 0.3.5 → 0.3.7

package/dist/index.js

@@ -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 path9 = 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(path9, { params: queryParams(input) });
     }
     if (method === "DELETE") {
-      return http.delete(path7, { params: queryParams(input) });
+      return http.delete(path9, { params: queryParams(input) });
     }
     if (method === "PUT") {
-      return http.put(path7, scope === "object" ? objectBody(input) : classBody(input));
+      return http.put(path9, scope === "object" ? objectBody(input) : classBody(input));
     }
-    return http.post(path7, scope === "object" ? objectBody(input) : classBody(input));
+    return http.post(path9, scope === "object" ? objectBody(input) : classBody(input));
   })();
   return resp.data;
 }
@@ -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, path9) {
+  const resp = await http.get("/api/tenant-meta/meta", { params: { path: path9 } });
   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, path9, content) {
+  const resp = await http.put("/api/tenant-meta/meta", { content }, { params: { path: path9 } });
   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, path9) {
+  const resp = await http.delete("/api/tenant-meta/meta", { params: { path: path9 } });
   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 path9 = [];
   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 = path9.indexOf(id);
+      const cycle = [...path9.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);
+    path9.push(id);
     for (const required of normalizeRequirements(skill.requires, skill.id)) {
       visit(required, skill.id);
     }
-    path7.pop();
+    path9.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 path9 = 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 = path9.lastIndexOf(".");
+  if (dot <= 0) throw new Error(`--set \u7684\u952E\u9700\u542B namespace\uFF0C\u5982 security.password.passwordPolicy=complex\uFF0C\u6536\u5230 "${path9}"`);
+  return { namespace: path9.slice(0, dot), settingKey: path9.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(path9, params) {
   const entries = Object.entries(params ?? {}).filter(([, v]) => v !== void 0 && v !== null);
-  if (entries.length === 0) return path7;
+  if (entries.length === 0) return path9;
   const qs = entries.map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`).join("&");
-  return `${path7}${path7.includes("?") ? "&" : "?"}${qs}`;
+  return `${path9}${path9.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(path9, params) {
       return once(
-        () => http.get(buildUrl(path7, params), { headers, validateStatus: () => true })
+        () => http.get(buildUrl(path9, params), { headers, validateStatus: () => true })
       );
     },
-    post(path7, body) {
+    post(path9, body) {
       return once(
-        () => http.post(path7, body, {
+        () => http.post(path9, body, {
           headers: { ...headers, "content-type": "application/json" },
           validateStatus: () => true
         })
@@ -5736,9 +5742,1815 @@ 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 [path9, key] of paths) {
+    const out = results[path9];
+    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 [path9, model] of paths) {
+    const out = results[path9];
+    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 [path9, key] of paths) {
+    const out = results[path9];
+    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 path9 = listPath(key);
+    const started = tick();
+    let requests = 0;
+    let truncatedBy = null;
+    const probeOut = await post.call(probe, path9, { 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, path9, { 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
+  };
+}
 export {
   AUTH_INFO_PATH,
   BLIND_SPOTS,
@@ -5751,6 +7563,9 @@ export {
   ExitCode,
   GATE_COMPONENTS,
   HcmClient,
+  KIT_CARRY_OVER_KEY,
+  KIT_CRAWLED_AT_FILE,
+  LEDGER_MISSING_WORD,
   LayoutContainmentError,
   MANIFEST_PATH,
   MAX_MANIFEST_PAGES,
@@ -5765,9 +7580,15 @@ export {
   MODELS_PATH,
   PASSWORD_CHANGE_REQUIRED,
   PROACTIVE_REFRESH_MARGIN_SECONDS,
+  PRODUCT_STATE_WORDS,
+  ROUND_EXIT_CODES,
+  ROUND_STAMPED_PRODUCTS,
+  ROUND_STATES,
+  ROUND_SUBCOMMAND,
   ReconLayout,
   RefStore,
   SDK_VERSION,
+  TargetModelNotFound,
   TokenStore,
   VERSION_PATH,
   WsClient,
@@ -5794,6 +7615,7 @@ export {
   clearModelCache,
   compareFingerprint,
   computeFingerprint,
+  computeReconSourceKey,
   conversationStateFile,
   create,
   createConversation,
@@ -5849,6 +7671,7 @@ export {
   inferEnvName,
   inferMiniWritableTemplateOptionsFromModel,
   initMiniAppProject,
+  inspectRound,
   isDelegationToolName,
   isServerSlidingSession,
   listEnvs,
@@ -5871,6 +7694,7 @@ export {
   modelEntries,
   modelKeys,
   needsRefresh,
+  newRoundId,
   normalizeReferences,
   oneShot,
   parseConfirmToolName,
@@ -5891,6 +7715,7 @@ export {
   readPullManifest,
   refreshToken,
   remove,
+  renderRound,
   replHistoryFile,
   resetSettingItem,
   resolveActiveEnv,
@@ -5900,9 +7725,11 @@ export {
   resolveChironBase,
   resolveRefs,
   resolveSkillInstallOrder,
+  roundAge,
   runDoctor,
   runImport,
   runMiniSmokeChecks,
+  runRecon,
   safeSegment,
   saveConversationState,
   saveEnv,