@hcmai/sdk 0.3.7 → 0.3.9

package/dist/index.js

@@ -177,25 +177,25 @@ var TokenStore = class _TokenStore {
       throw e;
     }
   }
-  async setAccessToken(token) {
+  async setAccessToken(token2) {
     if (await this.canUseKeychain()) {
       const keytar = await loadKeytar();
-      if (!keytar) return this.writeTokenFile("access", token);
+      if (!keytar) return this.writeTokenFile("access", token2);
       const account = `${this.keychainAccountPrefix()}/access`;
-      await keytar.setPassword(SERVICE_PREFIX, account, token);
+      await keytar.setPassword(SERVICE_PREFIX, account, token2);
       return `keychain:${SERVICE_PREFIX}/${account}`;
     }
-    return this.writeTokenFile("access", token);
+    return this.writeTokenFile("access", token2);
   }
-  async setRefreshToken(token) {
+  async setRefreshToken(token2) {
     if (await this.canUseKeychain()) {
       const keytar = await loadKeytar();
-      if (!keytar) return this.writeTokenFile("refresh", token);
+      if (!keytar) return this.writeTokenFile("refresh", token2);
       const account = `${this.keychainAccountPrefix()}/refresh`;
-      await keytar.setPassword(SERVICE_PREFIX, account, token);
+      await keytar.setPassword(SERVICE_PREFIX, account, token2);
       return `keychain:${SERVICE_PREFIX}/${account}`;
     }
-    return this.writeTokenFile("refresh", token);
+    return this.writeTokenFile("refresh", token2);
   }
   async getAccessToken() {
     if (process.env.HCM_PAT) return process.env.HCM_PAT;
@@ -258,10 +258,10 @@ var TokenStore = class _TokenStore {
       return false;
     }
   }
-  async writeTokenFile(kind, token) {
+  async writeTokenFile(kind, token2) {
     const file = `${this.metaFile()}.${kind}`;
     await fs.mkdir(this.dataDir(), { recursive: true });
-    await fs.writeFile(file, token, { mode: 384 });
+    await fs.writeFile(file, token2, { mode: 384 });
     if (kind === "access") {
       console.warn(`[hcm] WARNING: OS keychain unavailable. Token saved to ${file} (0600).`);
     }
@@ -308,14 +308,14 @@ async function loginPassword(input) {
     },
     { headers: { "Content-Type": "application/json" } }
   );
-  const { token, expiresIn, user } = resp.data;
-  if (!token) {
+  const { token: token2, expiresIn, user } = resp.data;
+  if (!token2) {
     throw new Error("Login response missing token");
   }
   const ttlSeconds = expiresIn ?? DEFAULT_SESSION_TTL_SECONDS;
   const expiresAt = new Date(Date.now() + ttlSeconds * 1e3).toISOString();
   const store = new TokenStore(input.profile);
-  const accessTokenRef = await store.setAccessToken(token);
+  const accessTokenRef = await store.setAccessToken(token2);
   const record = {
     scheme: "password",
     accessTokenRef,
@@ -1068,18 +1068,18 @@ async function action(http, model, actionName, input) {
   if (scope === "object" && !input.id) {
     throw new Error(`object action ${model}.${actionName} requires id`);
   }
-  const path9 = scope === "object" ? `/api/models/${model}/${input.id}/action/${actionName}` : `/api/models/${model}/action/${actionName}`;
+  const path12 = scope === "object" ? `/api/models/${model}/${input.id}/action/${actionName}` : `/api/models/${model}/action/${actionName}`;
   const resp = await (async () => {
     if (method === "GET") {
-      return http.get(path9, { params: queryParams(input) });
+      return http.get(path12, { params: queryParams(input) });
     }
     if (method === "DELETE") {
-      return http.delete(path9, { params: queryParams(input) });
+      return http.delete(path12, { params: queryParams(input) });
     }
     if (method === "PUT") {
-      return http.put(path9, scope === "object" ? objectBody(input) : classBody(input));
+      return http.put(path12, scope === "object" ? objectBody(input) : classBody(input));
     }
-    return http.post(path9, scope === "object" ? objectBody(input) : classBody(input));
+    return http.post(path12, scope === "object" ? objectBody(input) : classBody(input));
   })();
   return resp.data;
 }
@@ -1690,14 +1690,14 @@ async function loginPairing(input) {
     { code: input.code },
     { headers: { "Content-Type": "application/json" } }
   );
-  const { token, expiresIn, user } = resp.data;
-  if (!token) {
+  const { token: token2, expiresIn, user } = resp.data;
+  if (!token2) {
     throw new Error("Pairing exchange response missing token");
   }
   const ttlSeconds = expiresIn ?? DEFAULT_SESSION_TTL_SECONDS;
   const expiresAt = new Date(Date.now() + ttlSeconds * 1e3).toISOString();
   const store = new TokenStore(input.profile);
-  const accessTokenRef = await store.setAccessToken(token);
+  const accessTokenRef = await store.setAccessToken(token2);
   const record = {
     scheme: "pairing",
     accessTokenRef,
@@ -1730,10 +1730,10 @@ function detectPasswordChangeChallenge(err) {
   const body = err?.response?.data;
   const error = body?.error ?? body;
   if (error?.code !== PASSWORD_CHANGE_REQUIRED) return null;
-  const token = error?.details?.changePasswordToken;
-  if (!token) return null;
+  const token2 = error?.details?.changePasswordToken;
+  if (!token2) return null;
   return {
-    changePasswordToken: String(token),
+    changePasswordToken: String(token2),
     expiresInSeconds: Number(error?.details?.expiresInSeconds) || void 0
   };
 }
@@ -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, path9) {
-  const resp = await http.get("/api/tenant-meta/meta", { params: { path: path9 } });
+async function getTenantMeta(http, path12) {
+  const resp = await http.get("/api/tenant-meta/meta", { params: { path: path12 } });
   const payload = resp.data?.data ?? resp.data;
   if (typeof payload === "string") return payload;
   return String(payload?.content ?? "");
 }
-async function saveTenantMeta(http, path9, content) {
-  const resp = await http.put("/api/tenant-meta/meta", { content }, { params: { path: path9 } });
+async function saveTenantMeta(http, path12, content) {
+  const resp = await http.put("/api/tenant-meta/meta", { content }, { params: { path: path12 } });
   return resp.data?.data ?? resp.data;
 }
-async function deleteTenantMeta(http, path9) {
-  const resp = await http.delete("/api/tenant-meta/meta", { params: { path: path9 } });
+async function deleteTenantMeta(http, path12) {
+  const resp = await http.delete("/api/tenant-meta/meta", { params: { path: path12 } });
   return resp.data?.data ?? resp.data;
 }
 
@@ -5148,14 +5148,14 @@ function resolveSkillInstallOrder(manifest2, targetId) {
     throw invalid(`\u6280\u80FD\u76EE\u5F55\u4E2D\u4E0D\u5B58\u5728 ${targetId}`);
   }
   const state = /* @__PURE__ */ new Map();
-  const path9 = [];
+  const path12 = [];
   const order = [];
   const visit = (id, requiredBy) => {
     const current = state.get(id);
     if (current === "done") return;
     if (current === "visiting") {
-      const cycleStart = path9.indexOf(id);
-      const cycle = [...path9.slice(Math.max(0, cycleStart)), id];
+      const cycleStart = path12.indexOf(id);
+      const cycle = [...path12.slice(Math.max(0, cycleStart)), id];
       throw invalid(`\u6280\u80FD\u4F9D\u8D56\u5B58\u5728\u73AF: ${cycle.join(" -> ")}`);
     }
     const skill = byId.get(id);
@@ -5164,11 +5164,11 @@ function resolveSkillInstallOrder(manifest2, targetId) {
     }
     assertSafeSkillId(skill.id);
     state.set(id, "visiting");
-    path9.push(id);
+    path12.push(id);
     for (const required of normalizeRequirements(skill.requires, skill.id)) {
       visit(required, skill.id);
     }
-    path9.pop();
+    path12.pop();
     state.set(id, "done");
     order.push(skill);
   };
@@ -5259,11 +5259,11 @@ async function resetSettingItem(http, domain, namespace, settingKey, revision) {
 function parseSettingAssignment(raw) {
   const eq = raw.indexOf("=");
   if (eq <= 0) throw new Error(`--set \u9700\u8981 namespace.key=value \u5F62\u6001\uFF0C\u6536\u5230 "${raw}"`);
-  const path9 = raw.slice(0, eq).trim();
+  const path12 = raw.slice(0, eq).trim();
   const value = raw.slice(eq + 1);
-  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 };
+  const dot = path12.lastIndexOf(".");
+  if (dot <= 0) throw new Error(`--set \u7684\u952E\u9700\u542B namespace\uFF0C\u5982 security.password.passwordPolicy=complex\uFF0C\u6536\u5230 "${path12}"`);
+  return { namespace: path12.slice(0, dot), settingKey: path12.slice(dot + 1), value };
 }
 
 // src/fde/layout.ts
@@ -5657,11 +5657,11 @@ function classifyStatus(status) {
   return "bad-response";
 }
 var CAPABILITIES_HEADER = "x-hcm-capabilities";
-function buildUrl(path9, params) {
+function buildUrl(path12, params) {
   const entries = Object.entries(params ?? {}).filter(([, v]) => v !== void 0 && v !== null);
-  if (entries.length === 0) return path9;
+  if (entries.length === 0) return path12;
   const qs = entries.map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`).join("&");
-  return `${path9}${path9.includes("?") ? "&" : "?"}${qs}`;
+  return `${path12}${path12.includes("?") ? "&" : "?"}${qs}`;
 }
 function lowerHeaders(raw) {
   const out = {};
@@ -5703,14 +5703,14 @@ function httpProbe(http, capabilities) {
   const headers = { [CAPABILITIES_HEADER]: capabilities };
   const probe = {
     capabilities,
-    get(path9, params) {
+    get(path12, params) {
       return once(
-        () => http.get(buildUrl(path9, params), { headers, validateStatus: () => true })
+        () => http.get(buildUrl(path12, params), { headers, validateStatus: () => true })
       );
     },
-    post(path9, body) {
+    post(path12, body) {
       return once(
-        () => http.post(path9, body, {
+        () => http.post(path12, body, {
           headers: { ...headers, "content-type": "application/json" },
           validateStatus: () => true
         })
@@ -5822,8 +5822,8 @@ async function crawlMeta(probe, modelKeys2, metaType = DEFAULT_META_TYPE) {
   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];
+  for (const [path12, key] of paths) {
+    const out = results[path12];
     if (out === void 0) {
       unavailable.push({
         modelKey: key,
@@ -6039,8 +6039,8 @@ async function collectActionGates(probe, modelKeys2, state = "") {
   const statesEchoed = /* @__PURE__ */ new Set();
   let noStateEcho = 0;
   let answered = 0;
-  for (const [path9, model] of paths) {
-    const out = results[path9];
+  for (const [path12, model] of paths) {
+    const out = results[path12];
     if (out === void 0) {
       unavailable.push({
         modelKey: model,
@@ -6419,8 +6419,8 @@ async function collectMutation(probe, modelKeys2) {
   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];
+  for (const [path12, key] of paths) {
+    const out = results[path12];
     if (out === void 0) {
       problems.push(`${key}: mutation-capability ${BATCH_LOST}`);
       mutation[key] = Object.fromEntries(
@@ -6865,11 +6865,11 @@ async function collectCodeTables(probe, modelEntries2, opts = {}) {
     keys.push(key);
   }
   for (const key of [...new Set(keys)].sort()) {
-    const path9 = listPath(key);
+    const path12 = listPath(key);
     const started = tick();
     let requests = 0;
     let truncatedBy = null;
-    const probeOut = await post.call(probe, path9, { page: 0, size: 0 });
+    const probeOut = await post.call(probe, path12, { page: 0, size: 0 });
     requests += 1;
     let total = null;
     let reason = null;
@@ -6918,7 +6918,7 @@ async function collectCodeTables(probe, modelEntries2, opts = {}) {
         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 });
+      const out = await post.call(probe, path12, { page, size: PAGE_SIZE });
       requests += 1;
       if (out.error !== "ok") {
         failed = `\u7B2C ${page} \u9875\u5931\u8D25\uFF08HTTP ${out.status} / ${out.error}\uFF09`;
@@ -7551,16 +7551,1153 @@ async function runRecon(probe, layout, opts = {}) {
     dir: layout.dir
   };
 }
+
+// src/fde/gate0/aclass.ts
+import { existsSync as existsSync4, readFileSync as readFileSync5, readdirSync as readdirSync2, statSync as statSync2 } from "fs";
+import * as path9 from "path";
+
+// src/fde/gate0/mapping-artifact.ts
+import { readFileSync as readFileSync4 } from "fs";
+var MAPPING_ARTIFACT_VERSION = 1;
+var MappingArtifactError = class extends Error {
+  constructor(reason, message) {
+    super(`[${reason}] ${message}`);
+    this.reason = reason;
+    this.message = message;
+    this.name = "MappingArtifactError";
+  }
+  reason;
+  message;
+};
+function isRecord6(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function readBusinessKeyFields(file) {
+  let text;
+  try {
+    text = readFileSync4(file, "utf8");
+  } catch (e) {
+    const code = e?.code;
+    if (code === "ENOENT") throw new MappingArtifactError("not-found", `\u627E\u4E0D\u5230\u6620\u5C04\u5DE5\u4EF6 ${file}`);
+    throw new MappingArtifactError("unreadable", `${file} \u8BFB\u4E0D\u52A8\uFF08${String(e)}\uFF09`);
+  }
+  if (text.charCodeAt(0) === 65279) text = text.slice(1);
+  let body;
+  try {
+    body = JSON.parse(text);
+  } catch (e) {
+    throw new MappingArtifactError("not-json", `${file} \u4E0D\u662F\u5408\u6CD5 JSON\uFF1A${String(e)}`);
+  }
+  if (!isRecord6(body)) {
+    throw new MappingArtifactError("bad-shape", `${file} \u7684\u6839\u4E0D\u662F\u5BF9\u8C61`);
+  }
+  if (!("version" in body)) {
+    throw new MappingArtifactError("version-missing", `${file} \u6CA1\u6709 version \u5B57\u6BB5`);
+  }
+  if (body.version !== MAPPING_ARTIFACT_VERSION) {
+    throw new MappingArtifactError(
+      "unsupported-version",
+      `${file} \u7684 version \u662F ${JSON.stringify(body.version)}\uFF0C\u672C\u5DE5\u5177\u53EA\u8BA4 ${MAPPING_ARTIFACT_VERSION} \u2014\u2014\u300C\u5C3D\u91CF\u6309\u8001\u7248\u672C\u8BFB\u300D\u4F1A\u628A\u65B0\u8BED\u4E49\u9759\u9ED8\u4E22\u6389`
+    );
+  }
+  const models = body.models;
+  if (!Array.isArray(models)) {
+    throw new MappingArtifactError(
+      "bad-shape",
+      `${file} \u7684 models \u5E94\u5F53\u662F\u4E00\u4E2A\u6570\u7EC4\uFF0C\u5B9E\u9645\u662F ${models === null ? "null" : typeof models}`
+    );
+  }
+  if (models.length === 0) {
+    throw new MappingArtifactError(
+      "empty",
+      `${file} \u7684 models \u662F\u7A7A\u7684 \u2014\u2014 \u7A7A\u5DE5\u4EF6\u8DD1\u5B8C\u4EC0\u4E48\u4E5F\u4E0D\u4F1A\u53D1\u751F\uFF0C\u800C\u987E\u95EE\u4F1A\u4EE5\u4E3A\u300C\u5BFC\u8FC7\u4E86\u300D`
+    );
+  }
+  return models.map((raw, i) => {
+    if (!isRecord6(raw)) {
+      throw new MappingArtifactError("bad-shape", `${file} \u7684 models[${i}] \u4E0D\u662F\u5BF9\u8C61`);
+    }
+    const businessKey = raw.businessKey;
+    if (businessKey === void 0 || businessKey === null) return [];
+    if (!isRecord6(businessKey)) {
+      throw new MappingArtifactError("bad-shape", `${file} \u7684 models[${i}].businessKey \u4E0D\u662F\u5BF9\u8C61`);
+    }
+    const fields = businessKey.fields;
+    if (fields === void 0 || fields === null) return [];
+    if (!Array.isArray(fields)) {
+      throw new MappingArtifactError(
+        "bad-shape",
+        `${file} \u7684 models[${i}].businessKey.fields \u4E0D\u662F\u6570\u7EC4`
+      );
+    }
+    return fields.filter((f) => typeof f === "string" && f !== "");
+  });
+}
+
+// src/fde/gate0/aclass.ts
+var ACLASS_KINDS = [
+  "fieldKey",
+  "fieldLabel",
+  "enumValue",
+  "modelName",
+  "codeValue",
+  "naturalKey",
+  "caliber"
+];
+var FIELDS_INDEX = ["index", "fields.jsonl"];
+var ENUM_MIRROR = ["valuedomain", "_enums.jsonl"];
+var MODEL_ROSTER = ["models.json"];
+var VALUE_DOMAIN_DIR = "valuedomain";
+var ENUM_ELEMENT_KEYS = ["value", "label", "key"];
+var MAPPING_ARTIFACT_HINT = "work/mapping.json";
+var CLASS_SCOPE = "class";
+var ENTRY_SCOPE = "entry";
+var SCOPES = [CLASS_SCOPE, ENTRY_SCOPE];
+var REASON_UNREAD = "unread";
+var REASON_EMPTY = "empty";
+var CLASS_REASONS = [REASON_UNREAD, REASON_EMPTY];
+function unguardedKinds(problems) {
+  const out = /* @__PURE__ */ new Set();
+  for (const problem of problems) {
+    if (!SCOPES.includes(problem.scope)) {
+      throw new Error(
+        `\u53F0\u8D26\u7684 scope \u53EA\u6709 ${SCOPES.join("/")} \u4E24\u4E2A\u53D6\u503C\uFF0C\u62FF\u5230\u7684\u662F ${JSON.stringify(problem.scope)}\uFF08${problem.message}\uFF09`
+      );
+    }
+    if (problem.scope === CLASS_SCOPE) for (const kind of problem.kinds) out.add(kind);
+  }
+  return out;
+}
+function unguardedWord(kinds) {
+  return kinds.join("/");
+}
+function token(value) {
+  if (typeof value === "string") return value === "" ? null : value;
+  if (typeof value === "number" && Number.isFinite(value)) return String(value);
+  return null;
+}
+function scalarsWithin(value) {
+  if (Array.isArray(value)) return value.flatMap(scalarsWithin);
+  if (typeof value === "object" && value !== null) {
+    return Object.values(value).flatMap(scalarsWithin);
+  }
+  const one = token(value);
+  return one === null ? [] : [one];
+}
+function readText(file, kinds, scope, problems) {
+  try {
+    return readFileSync5(file, "utf8");
+  } catch (e) {
+    const code = e?.code;
+    const name = path9.basename(file);
+    problems.push({
+      scope,
+      reason: REASON_UNREAD,
+      kinds,
+      message: code === "ENOENT" ? `\u7F3A\u4EA7\u7269 ${name} \u21D2 ${unguardedWord(kinds)} \u8FD9\u51E0\u7C7B\u6B64\u523B\u65E0\u4EBA\u5B88` : `\u4EA7\u7269 ${name} \u8BFB\u4E0D\u52A8\uFF08${String(e)}\uFF09\u21D2 ${unguardedWord(kinds)} \u8FD9\u51E0\u7C7B\u6B64\u523B\u65E0\u4EBA\u5B88`
+    });
+    return null;
+  }
+}
+function readJsonl(file, kinds, scope, problems) {
+  const text = readText(file, kinds, scope, problems);
+  if (text === null) return [];
+  const name = path9.basename(file);
+  const rows = [];
+  text.split("\n").forEach((raw, i) => {
+    const line = raw.trim();
+    if (line === "") return;
+    let row;
+    try {
+      row = JSON.parse(line);
+    } catch (e) {
+      problems.push({
+        scope: ENTRY_SCOPE,
+        reason: "bad-line",
+        kinds,
+        message: `${name}:${i + 1} \u4E0D\u662F\u5408\u6CD5 JSON\uFF08${String(e)}\uFF09\u21D2 \u8FD9\u4E00\u884C\u7684\u53D6\u503C\u6CA1\u6709\u8FDB ${unguardedWord(kinds)}`
+      });
+      return;
+    }
+    if (typeof row !== "object" || row === null || Array.isArray(row)) {
+      problems.push({
+        scope: ENTRY_SCOPE,
+        reason: "bad-line",
+        kinds,
+        message: `${name}:${i + 1} \u4E0D\u662F\u5BF9\u8C61\uFF08${row === null ? "null" : typeof row}\uFF09\u21D2 \u8FD9\u4E00\u884C\u7684\u53D6\u503C\u6CA1\u6709\u8FDB ${unguardedWord(kinds)}`
+      });
+      return;
+    }
+    rows.push(row);
+  });
+  return rows;
+}
+var UNREADABLE = /* @__PURE__ */ Symbol("unreadable");
+function readJson(file, kinds, scope, problems) {
+  const text = readText(file, kinds, scope, problems);
+  if (text === null) return UNREADABLE;
+  try {
+    return JSON.parse(text);
+  } catch (e) {
+    problems.push({
+      scope,
+      reason: REASON_UNREAD,
+      kinds,
+      message: `\u4EA7\u7269 ${path9.basename(file)} \u4E0D\u662F\u5408\u6CD5 JSON\uFF08${String(e)}\uFF09\u21D2 ${unguardedWord(kinds)} \u8FD9\u51E0\u7C7B\u6B64\u523B\u65E0\u4EBA\u5B88`
+    });
+    return UNREADABLE;
+  }
+}
+function listUnder(payload, key, file, kinds, scope, problems) {
+  const name = path9.basename(file);
+  if (typeof payload !== "object" || payload === null || Array.isArray(payload)) {
+    problems.push({
+      scope,
+      reason: REASON_UNREAD,
+      kinds,
+      message: `\u4EA7\u7269 ${name} \u4E0D\u662F\u5BF9\u8C61\uFF08${payload === null ? "null" : Array.isArray(payload) ? "array" : typeof payload}\uFF09\u21D2 ${unguardedWord(kinds)} \u8FD9\u51E0\u7C7B\u6B64\u523B\u65E0\u4EBA\u5B88`
+    });
+    return [];
+  }
+  const body = payload;
+  if (!(key in body)) {
+    problems.push({
+      scope,
+      reason: REASON_UNREAD,
+      kinds,
+      message: `\u4EA7\u7269 ${name} \u91CC\u6CA1\u6709 ${key} \u8FD9\u4E2A\u952E\uFF08\u9876\u5C42\u952E\u662F ${JSON.stringify(Object.keys(body).sort())}\uFF09\u21D2 ${unguardedWord(kinds)} \u8FD9\u51E0\u7C7B\u6B64\u523B\u65E0\u4EBA\u5B88`
+    });
+    return [];
+  }
+  const value = body[key];
+  if (!Array.isArray(value)) {
+    problems.push({
+      scope,
+      reason: REASON_UNREAD,
+      kinds,
+      message: `\u4EA7\u7269 ${name} \u7684 ${key} \u4E0D\u662F\u6570\u7EC4\uFF08${value === null ? "null" : typeof value}\uFF09\u21D2 ${unguardedWord(kinds)} \u8FD9\u51E0\u7C7B\u6B64\u523B\u65E0\u4EBA\u5B88`
+    });
+    return [];
+  }
+  return value;
+}
+function deriveAclass(root, mappingArtifact = null) {
+  const problems = [];
+  const out = Object.fromEntries(ACLASS_KINDS.map((k) => [k, /* @__PURE__ */ new Set()]));
+  for (const row of readJsonl(
+    path9.join(root, ...FIELDS_INDEX),
+    ["fieldKey", "fieldLabel", "caliber"],
+    CLASS_SCOPE,
+    problems
+  )) {
+    const key = token(row.key);
+    if (key !== null) out.fieldKey.add(key);
+    const name = token(row.name);
+    if (name !== null) out.fieldLabel.add(name);
+    const synonyms = row.synonyms;
+    for (const syn of Array.isArray(synonyms) ? synonyms : []) {
+      const one = token(syn);
+      if (one !== null) out.caliber.add(one);
+    }
+  }
+  for (const row of readJsonl(
+    path9.join(root, ...ENUM_MIRROR),
+    ["enumValue"],
+    CLASS_SCOPE,
+    problems
+  )) {
+    const enums = row.enums;
+    for (const element of Array.isArray(enums) ? enums : []) {
+      if (typeof element !== "object" || element === null || Array.isArray(element)) continue;
+      for (const field of ENUM_ELEMENT_KEYS) {
+        const one = token(element[field]);
+        if (one !== null) out.enumValue.add(one);
+      }
+    }
+  }
+  const rosterPath = path9.join(root, ...MODEL_ROSTER);
+  const roster = readJson(rosterPath, ["modelName"], CLASS_SCOPE, problems);
+  if (roster !== UNREADABLE) {
+    const rows = listUnder(roster, "models", rosterPath, ["modelName"], CLASS_SCOPE, problems);
+    const entries = modelEntries(roster);
+    const keys = modelKeys(roster);
+    for (const key of keys) out.modelName.add(key);
+    for (const entry of entries) {
+      const name = token(entry.name);
+      if (name !== null) out.modelName.add(name);
+    }
+    if (rows.length !== entries.length) {
+      problems.push({
+        scope: ENTRY_SCOPE,
+        reason: "dropped-entries",
+        kinds: ["modelName"],
+        message: `models.json \u91CC ${rows.length} \u6761\u6A21\u578B\u6761\u76EE\u6709 ${rows.length - entries.length} \u6761\u4E0D\u662F\u5BF9\u8C61 \u21D2 \u5B83\u4EEC\u7684\u6A21\u578B\u540D\u6CA1\u6709\u8FDB modelName`
+      });
+    }
+    if (entries.length !== keys.length) {
+      problems.push({
+        scope: ENTRY_SCOPE,
+        reason: "dropped-keys",
+        kinds: ["modelName"],
+        message: `models.json \u91CC ${entries.length} \u6761\u6A21\u578B\u6761\u76EE\u6709 ${entries.length - keys.length} \u6761\u6CA1\u6709 modelKey \u21D2 \u5B83\u4EEC\u7684\u82F1\u6587\u6A21\u578B\u540D\u6CA1\u6709\u8FDB modelName`
+      });
+    }
+  }
+  const valueDomain = path9.join(root, VALUE_DOMAIN_DIR);
+  if (existsSync4(valueDomain) && statSync2(valueDomain).isDirectory()) {
+    const tables = readdirSync2(valueDomain).filter((f) => f.endsWith(".json") && !RESERVED_FILENAMES.includes(f)).sort();
+    for (const name of tables) {
+      const file = path9.join(valueDomain, name);
+      const payload = readJson(file, ["codeValue"], ENTRY_SCOPE, problems);
+      if (payload === UNREADABLE) continue;
+      for (const row of listUnder(payload, "rows", file, ["codeValue"], ENTRY_SCOPE, problems)) {
+        if (typeof row !== "object" || row === null || Array.isArray(row)) {
+          problems.push({
+            scope: ENTRY_SCOPE,
+            reason: "bad-row",
+            kinds: ["codeValue"],
+            message: `${name} \u7684 rows \u91CC\u6709\u4E00\u4E2A\u5143\u7D20\u4E0D\u662F\u5BF9\u8C61\uFF08${row === null ? "null" : typeof row}\uFF09\u21D2 \u5B83\u7684\u53D6\u503C\u6CA1\u6709\u8FDB codeValue`
+          });
+          continue;
+        }
+        for (const value of scalarsWithin(row)) out.codeValue.add(value);
+      }
+    }
+  } else {
+    problems.push({
+      scope: CLASS_SCOPE,
+      reason: REASON_UNREAD,
+      kinds: ["codeValue"],
+      message: `\u7F3A\u4EA7\u7269\u76EE\u5F55 ${VALUE_DOMAIN_DIR}/ \u21D2 codeValue \u8FD9\u4E00\u7C7B\u6B64\u523B\u65E0\u4EBA\u5B88`
+    });
+  }
+  let businessKeys = null;
+  if (mappingArtifact === null) {
+    problems.push({
+      scope: CLASS_SCOPE,
+      reason: REASON_UNREAD,
+      kinds: ["naturalKey"],
+      message: `\u6CA1\u6709\u6307\u5B9A\u6620\u5C04\u5DE5\u4EF6 \u21D2 naturalKey \u8FD9\u4E00\u7C7B\u6B64\u523B\u65E0\u4EBA\u5B88\uFF08\u628A ${MAPPING_ARTIFACT_HINT} \u7684\u8DEF\u5F84\u4F20\u8FDB\u6765\uFF09`
+    });
+  } else {
+    try {
+      businessKeys = readBusinessKeyFields(mappingArtifact);
+    } catch (e) {
+      const err = e;
+      problems.push({
+        scope: CLASS_SCOPE,
+        reason: REASON_UNREAD,
+        kinds: ["naturalKey"],
+        message: `\u6620\u5C04\u5DE5\u4EF6\u8BFB\u4E0D\u52A8\uFF08[${err.reason ?? "unknown"}] ${err.message}\uFF09\u21D2 naturalKey \u8FD9\u4E00\u7C7B\u6B64\u523B\u65E0\u4EBA\u5B88`
+      });
+    }
+  }
+  for (const fields of businessKeys ?? []) {
+    for (const field of fields) out.naturalKey.add(field);
+    if (fields.length > 1) {
+      out.naturalKey.add(fields.join("+"));
+    }
+  }
+  const named = unguardedKinds(problems);
+  for (const kind of ACLASS_KINDS) {
+    if (out[kind].size === 0 && !named.has(kind)) {
+      problems.push({
+        scope: CLASS_SCOPE,
+        reason: REASON_EMPTY,
+        kinds: [kind],
+        message: `${kind}\uFF1A\u4EA7\u7269\u8BFB\u5230\u4E86\uFF0C\u4F46\u4E00\u6761\u53D6\u503C\u90FD\u6CA1\u6D3E\u751F\u51FA\u6765 \u21D2 \u95E8 0 \u5BF9\u8FD9\u4E00\u7C7B\u6052\u7EFF\uFF08\u540C\u6279\u53F0\u8D26\u91CC\u82E5\u6709\u6761\u76EE\u7EA7\u95EE\u9898\uFF0C\u771F\u56E0\u5728\u90A3\u91CC\uFF09`
+      });
+    }
+  }
+  return { aclass: out, problems };
+}
+
+// src/fde/gate0/facts.ts
+import { existsSync as existsSync5, readFileSync as readFileSync6 } from "fs";
+import * as path10 from "path";
+var REGISTRY_SCOPE = "registry";
+var ENTRY_SCOPE2 = "entry";
+var REASON_NO_ENTRIES = "no-entries";
+var REASON_PROBE_UNVERIFIED = "probe-unverified";
+var REGISTRY_REASONS = [REASON_NO_ENTRIES, REASON_PROBE_UNVERIFIED];
+var REASON_PROBE_SHAPE = "probe-shape";
+var REASON_PROBE_ABSENT = "probe-absent";
+var REASON_DUPLICATE_TOKEN = "duplicate-token";
+var ENTRY_REASONS = [
+  REASON_PROBE_SHAPE,
+  REASON_PROBE_ABSENT,
+  REASON_DUPLICATE_TOKEN
+];
+var FACTS_REASONS = [...REGISTRY_REASONS, ...ENTRY_REASONS];
+var PROBE_SHAPE = /^(?<file>[A-Za-z0-9_./-]+\.test\.ts)::(?<mark>[A-Za-z0-9_-]+)$/;
+var PROBE_MARK_PREFIX = "// P:";
+var PROTOCOL_FACTS = [
+  {
+    token: "/api/models/{model}/meta",
+    probe: "packages/core/tests/fde-recon-crawl.test.ts::meta-path-wire-shape",
+    note: "\u5B57\u6BB5\u5143\u6570\u636E\u8D70\u88F8\u8DEF\u5F84 GET\uFF0C\u9ED8\u8BA4\u4E0D\u7F00 ?type=\u3002\u63A2\u9488\u65AD\u7684\u662F**\u5B9E\u9645\u53D1\u51FA\u53BB\u7684 URL**\uFF0C\u4E0D\u662F\u62FC\u4E32\u51FD\u6570\u7684\u8FD4\u56DE\u503C\u3002"
+  },
+  {
+    token: "/api/models/{model}/list/dsl",
+    probe: "packages/core/tests/fde-recon-valuedomain.test.ts::list-dsl-count-probe",
+    note: "\u5217\u8868\u67E5\u8BE2\u8D70 POST DSL\u3002\u63A2\u9488\u65AD\u7684\u662F\u884C\u4E3A\uFF1Asize=0 \u7684\u90A3\u4E00\u53D1\u5148\u51FA\u4E14\u8FD4\u56DE totalElements\uFF0C\u53D6\u9875\u5224\u636E\u4EE5\u6B64\u4E3A\u524D\u63D0\u3002"
+  },
+  {
+    token: "/api/auth/login",
+    probe: "packages/core/tests/fde-gate0-facts.test.ts::login-body-carries-tenant",
+    note: "\u767B\u5F55\u7684 tenantId \u5728**\u8BF7\u6C42\u4F53**\u91CC\uFF0C\u4E0D\u5728 header\u3002\u63A2\u9488\u65AD\u7684\u662F\u5B9E\u9645\u53D1\u51FA\u53BB\u7684\u8BF7\u6C42\u4F53\u4E0E\u8BF7\u6C42\u5934\uFF0C\u5220\u6389 tenantId \u6216\u632A\u8FDB header \u90FD\u4F1A\u7EA2\u3002"
+  }
+];
+function loadProtocolFacts(entries = PROTOCOL_FACTS, options = {}) {
+  const problems = [];
+  const probeRoot = options.probeRoot;
+  if (probeRoot === void 0 && entries !== PROTOCOL_FACTS) {
+    problems.push({
+      scope: REGISTRY_SCOPE,
+      reason: REASON_PROBE_UNVERIFIED,
+      index: 0,
+      token: null,
+      message: "\u8FD9\u4EFD\u767B\u8BB0\u518C\u4E0D\u662F\u968F\u5305\u90A3\u4E00\u4EFD\uFF0C\u53C8\u6CA1\u6709\u7ED9\u63A2\u9488\u6839\u76EE\u5F55 \u21D2 \u4E00\u6761\u63A2\u9488\u90FD\u6CA1\u9A8C\u8FC7 \u2014\u2014\u300C\u63A2\u9488\u90FD\u5728\u300D\u4E0E\u300C\u6CA1\u67E5\u63A2\u9488\u300D\u5728\u8FD4\u56DE\u503C\u4E0A\u540C\u5F62\uFF0C\u6240\u4EE5\u8FD9\u91CC\u8BB0\u4E00\u7B14\uFF0C\u4E0D\u88C5\u4F5C\u9A8C\u8FC7"
+    });
+  }
+  if (entries.length === 0) {
+    problems.push({
+      scope: REGISTRY_SCOPE,
+      reason: REASON_NO_ENTRIES,
+      index: 0,
+      token: null,
+      message: "\u767B\u8BB0\u518C\u4E00\u6761\u90FD\u6CA1\u6709 \u2014\u2014 **\u67E5\u8FC7\u4E14\u4E3A\u7A7A**\uFF0C\u4E0D\u662F\u300C\u6CA1\u67E5\u300D"
+    });
+  }
+  const times = /* @__PURE__ */ new Map();
+  for (const entry of entries) times.set(entry.token, (times.get(entry.token) ?? 0) + 1);
+  const facts = [];
+  entries.forEach((entry, position) => {
+    const index = position + 1;
+    if ((times.get(entry.token) ?? 0) > 1) {
+      problems.push({
+        scope: ENTRY_SCOPE2,
+        reason: REASON_DUPLICATE_TOKEN,
+        index,
+        token: entry.token,
+        message: `${entry.token} \u767B\u8BB0\u4E86\u4E0D\u6B62\u4E00\u6B21 \u21D2 \u4E24\u6761\u90FD\u4E0D\u8FDB P\uFF08\u7559\u4E0B\u4EFB\u4F55\u4E00\u8FB9\u90FD\u8981\u56DE\u7B54\u300C\u4EE5\u54EA\u4EFD\u4E3A\u51C6\u300D\uFF09`
+      });
+      return;
+    }
+    const shape = PROBE_SHAPE.exec(entry.probe);
+    if (!shape?.groups) {
+      problems.push({
+        scope: ENTRY_SCOPE2,
+        reason: REASON_PROBE_SHAPE,
+        index,
+        token: entry.token,
+        message: `${entry.token} \u7684\u63A2\u9488 ${JSON.stringify(entry.probe)} \u4E0D\u662F \`<\u6D4B\u8BD5\u6587\u4EF6>.test.ts::<\u6807\u8BB0>\` \u5F62\u6001 \u2014\u2014 \u53EA\u7ED9\u6587\u4EF6\u8DEF\u5F84\u662F\u540C\u4E49\u53CD\u590D\uFF08\u300C\u90A3\u4E2A\u6587\u4EF6\u5B58\u5728\u300D\u4E0D\u7B97\u80CC\u4E66\uFF09`
+      });
+      return;
+    }
+    if (probeRoot !== void 0) {
+      const file = path10.join(probeRoot, shape.groups.file);
+      const mark = `${PROBE_MARK_PREFIX} ${shape.groups.mark}`;
+      const found = existsSync5(file) && readFileSync6(file, "utf8").includes(mark);
+      if (!found) {
+        problems.push({
+          scope: ENTRY_SCOPE2,
+          reason: REASON_PROBE_ABSENT,
+          index,
+          token: entry.token,
+          message: `${entry.token} \u7684\u63A2\u9488\u6307\u5411 ${entry.probe}\uFF0C\u4F46\u90A3\u91CC\u627E\u4E0D\u5230 \`${mark}\` \u8FD9\u6761\u6807\u8BB0 \u21D2 \u8FD9\u6761\u767B\u8BB0\u6CA1\u6709\u80CC\u4E66\uFF0C\u4E0D\u8FDB P`
+        });
+        return;
+      }
+    }
+    facts.push(entry.token);
+  });
+  return { facts, problems };
+}
+
+// src/fde/gate0/scan.ts
+import { readFileSync as readFileSync7, readdirSync as readdirSync3, readlinkSync, statSync as statSync3 } from "fs";
+import * as path11 from "path";
+var CHANNEL_ACLASS = "aclass";
+var CHANNEL_ARTIFACT = "artifact-path";
+var CHANNEL_UNREGISTERED = "protocol-unregistered";
+var CHANNEL_REGISTERED_IS_ACLASS = "registered-but-is-aclass";
+var CHANNEL_NO_PROBE = "no-probe";
+var CHANNELS = [
+  CHANNEL_ACLASS,
+  CHANNEL_ARTIFACT,
+  CHANNEL_UNREGISTERED,
+  CHANNEL_REGISTERED_IS_ACLASS,
+  CHANNEL_NO_PROBE
+];
+var REASON_NO_SKILL_ROOT = "no-skill-root";
+var REASON_NOTHING_SCANNED = "nothing-scanned";
+var REASON_FILE_UNREADABLE = "file-unreadable";
+var REASON_ACLASS_EMPTY = "aclass-empty";
+var REASON_ACLASS_PARTIALLY_UNREAD = "aclass-partially-unread";
+var REASON_REGISTRY = "registry-not-established";
+var REASON_CHANNEL_FOUR_UNCHECKED = "channel-four-unchecked";
+var REASON_BASELINE_ROUND_NOT_COMPLETE = "baseline-round-not-complete";
+var REASON_SYMLINK_NOT_SCANNED = "symlink-not-scanned";
+var PREMISE_REASONS = [
+  REASON_NO_SKILL_ROOT,
+  REASON_NOTHING_SCANNED,
+  REASON_FILE_UNREADABLE,
+  REASON_ACLASS_EMPTY,
+  REASON_ACLASS_PARTIALLY_UNREAD,
+  REASON_REGISTRY,
+  REASON_CHANNEL_FOUR_UNCHECKED,
+  REASON_BASELINE_ROUND_NOT_COMPLETE,
+  REASON_SYMLINK_NOT_SCANNED
+];
+var PREMISE_REGISTRY_REASONS = REGISTRY_REASONS.filter(
+  (r) => r !== REASON_NO_ENTRIES
+);
+var WORD_RE = /[A-Za-z0-9_]+/g;
+var SIMPLE_TOKEN = /^[A-Za-z0-9_]+$/;
+var WORD_CHARS = new Set("abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789_");
+function isWordChar(char) {
+  return char !== void 0 && WORD_CHARS.has(char);
+}
+var ENDPOINT_PREFIXES = ["api", "ws"];
+var ENDPOINT_PATH = `/(?:${ENDPOINT_PREFIXES.join("|")})(?:/(?:\\{[A-Za-z0-9_]+\\}|[A-Za-z0-9_.\\-]+))+`;
+var BARE_ENDPOINT_RE = new RegExp(`(?<![A-Za-z0-9_.\\-/])${ENDPOINT_PATH}`, "g");
+var URL_ENDPOINT_RE = new RegExp(
+  `[A-Za-z][A-Za-z0-9+.\\-]*://[^\\s"'\`<>]*?(${ENDPOINT_PATH})`,
+  "g"
+);
+var HOSTLESS_HOST = `(?:(?:[A-Za-z0-9_\\-]+\\.)+[A-Za-z]{2,}(?::[0-9]+)?|[A-Za-z0-9_\\-]+:[0-9]+)`;
+var HOSTLESS_ENDPOINT_RE = new RegExp(
+  `(?<![A-Za-z0-9_.\\-/:@])${HOSTLESS_HOST}(${ENDPOINT_PATH})`,
+  "g"
+);
+var ERROR_CODE_RE = /(?<![A-Za-z0-9_])[A-Z][A-Z0-9]*(?:_[A-Z0-9]+)+(?![A-Za-z0-9_])/g;
+var PATHISH_RE = /(?<![A-Za-z0-9_./-])\.?[A-Za-z0-9_.-]+(?:\/[A-Za-z0-9_.-]+)+/g;
+var ARTIFACT_SUFFIXES = [".json", ".jsonl"];
+var PRODUCT_FILE_RE = new RegExp(
+  `(?<![A-Za-z0-9_./\\-])[A-Za-z0-9_.\\-]+(?:${ARTIFACT_SUFFIXES.map((s) => s.replace(".", "\\.")).join("|")})(?![A-Za-z0-9_])`,
+  "g"
+);
+var PLACEHOLDER_RE2 = /\{[A-Za-z0-9_]*\}/g;
+var ARTIFACT_ROOT = ".hcmnx";
+var RECON_DIRNAME = "recon";
+var RECON_SEGMENTS_BELOW_ROOT = 2;
+var PRODUCT_RELATIVE_SHAPES = [
+  ["index", ".md"],
+  ["index", ".jsonl"],
+  ["mapping", ".json"],
+  ["meta", ".json"],
+  ["valuedomain", ".json"],
+  ["valuedomain", ".jsonl"]
+];
+var REASON_ENVIRONMENT_FACT = "environment-fact";
+var REASON_PRODUCT_TREE_PATH = "product-tree-path";
+var REASON_PRODUCT_RELATIVE_PATH = "product-relative-path";
+var REASON_PRODUCT_FILE_NAME = "product-file-name";
+var REASON_ENDPOINT = "endpoint";
+var REASON_ERROR_CODE = "error-code";
+var REASON_REGISTERED_IS_ACLASS = "registered-is-aclass";
+var REASON_REJECTED_REGISTRATION = "rejected-registration";
+var RED_REASONS = {
+  [CHANNEL_ACLASS]: [REASON_ENVIRONMENT_FACT],
+  [CHANNEL_ARTIFACT]: [
+    REASON_PRODUCT_TREE_PATH,
+    REASON_PRODUCT_RELATIVE_PATH,
+    REASON_PRODUCT_FILE_NAME
+  ],
+  [CHANNEL_UNREGISTERED]: [REASON_ENDPOINT, REASON_ERROR_CODE],
+  [CHANNEL_REGISTERED_IS_ACLASS]: [REASON_REGISTERED_IS_ACLASS],
+  [CHANNEL_NO_PROBE]: [REASON_REJECTED_REGISTRATION]
+};
+var ARTIFACT_WORDING = {
+  [REASON_PRODUCT_TREE_PATH]: (t) => `\u51FA\u73B0**\u4EA7\u7269\u6811\u91CC\u7684**\u8DEF\u5F84 ${JSON.stringify(t)}`,
+  [REASON_PRODUCT_RELATIVE_PATH]: (t) => `\u51FA\u73B0**\u4EA7\u7269\u6839\u76F8\u5BF9\u8DEF\u5F84** ${JSON.stringify(t)}\uFF08\u4EA7\u7269\u5B50\u76EE\u5F55\u4E0B\u7684\u90A3\u4E00\u4EFD\uFF09`,
+  [REASON_PRODUCT_FILE_NAME]: (t) => `\u51FA\u73B0\u4EA7\u7269\u6587\u4EF6\u540D\u5F62\u6001 ${JSON.stringify(t)}\uFF08\u4EE5 .json/.jsonl \u6536\u5C3E\uFF1B**\u8FD9\u4E00\u6863\u4F1A\u8FC7\u5224**\uFF0C\u5B83\u4E0E\u4EA7\u7269\u65E0\u5173\u65F6\u8BF7\u7167\u76F4\u8BF4\u660E\uFF09`
+};
+function artifactWordingFor(reason) {
+  const wording = ARTIFACT_WORDING[reason];
+  if (wording === void 0) {
+    throw new Error(
+      `\u4EA7\u7269\u8DEF\u5F84\u6210\u56E0 ${JSON.stringify(reason)} \u6CA1\u6709\u5BF9\u5E94\u7684\u63AA\u8F9E\uFF08\u8BA4\u5F97\u7684\u662F ${Object.keys(ARTIFACT_WORDING).join("/")}\uFF09`
+    );
+  }
+  return wording;
+}
+var ACLASS_EMPTY_WHY = {
+  [REASON_UNREAD]: "\uFF08\u4EA7\u7269/\u5DE5\u4EF6\u90A3\u4E00\u5934\u6839\u672C\u6CA1\u8BFB\u5230\uFF09",
+  [REASON_EMPTY]: "\uFF08\u4EA7\u7269\u8BFB\u5230\u4E86\uFF0C\u4E00\u6761\u53D6\u503C\u90FD\u6CA1\u6D3E\u751F\u51FA\u6765\uFF09"
+};
+var GAP_NOISE_TOKEN = "pure-digit-or-single-char";
+var GAP_CJK_INSIDE_LONGER_RUN = "cjk-inside-longer-run";
+var GAP_REASONS = [GAP_NOISE_TOKEN, GAP_CJK_INSIDE_LONGER_RUN];
+function checkReds(reds) {
+  for (const red of reds) {
+    if (!CHANNELS.includes(red.channel)) {
+      throw new Error(
+        `\u5224\u7EA2\u7684 channel \u53EA\u6709 ${CHANNELS.join("/")} \u8FD9\u51E0\u4E2A\u53D6\u503C\uFF0C\u62FF\u5230\u7684\u662F ${JSON.stringify(red.channel)}\uFF08${red.message}\uFF09`
+      );
+    }
+    if (!RED_REASONS[red.channel].includes(red.reason)) {
+      throw new Error(
+        `${JSON.stringify(red.reason)} \u8FD9\u4E2A reason \u4E0D\u5C5E\u4E8E ${red.channel} \u8FD9\u6761\u901A\u9053\uFF08\u8BA4\u5F97\u7684\u662F ${RED_REASONS[red.channel].join("/")}\uFF1B${red.message}\uFF09`
+      );
+    }
+  }
+  return [...reds];
+}
+function checkGaps(gaps) {
+  for (const gap of gaps) {
+    if (!GAP_REASONS.includes(gap.reason)) {
+      throw new Error(
+        `\u7F3A\u53E3\u53F0\u8D26\u7684 reason \u53EA\u6709 ${GAP_REASONS.join("/")} \u4E24\u4E2A\u53D6\u503C\uFF0C\u62FF\u5230\u7684\u662F ${JSON.stringify(gap.reason)}\uFF08${gap.why}\uFF09`
+      );
+    }
+  }
+  return [...gaps];
+}
+function checkPremise(problems) {
+  for (const problem of problems) {
+    if (!PREMISE_REASONS.includes(problem.reason)) {
+      throw new Error(
+        `\u524D\u63D0\u7EA7\u53F0\u8D26\u7684 reason \u4E0D\u5728\u53D6\u503C\u57DF\u91CC\uFF1A${JSON.stringify(problem.reason)}\uFF08${problem.message}\uFF09`
+      );
+    }
+  }
+  return [...problems];
+}
+function baselineRoundPremise(round) {
+  const state = round && typeof round === "object" ? round.state : void 0;
+  if (state === "complete") return [];
+  return [
+    {
+      reason: REASON_BASELINE_ROUND_NOT_COMPLETE,
+      message: `\u8FD9\u4EFD\u57FA\u7EBF\u7684\u8F6E\u6B21\u72B6\u6001\u662F ${JSON.stringify(state)}\uFF08\u4E0D\u662F complete\uFF09\u21D2 A \u7C7B\u4E8B\u5B9E\u662F\u4ECE**\u6DF7\u7740\u4E0D\u540C\u8F6E\u6B21 / \u5224\u4E0D\u4E86\u8F6E\u6B21**\u7684\u4EA7\u7269\u91CC\u73B0\u7B97\u7684\uFF0C\u300C\u5224\u7EA2 0 \u6761\u300D\u5BF9\u54EA\u4E00\u8F6E\u90FD\u4E0D\u7B97\u6570\u3002\u5148\u8DD1 \`hcm delivery recon round\` \u770B\u662F\u54EA\u51E0\u4EFD\uFF0C\u6216\u91CD\u8DD1\u4E00\u6B21 \`hcm delivery recon\`\u3002\u26A0\uFE0F **\`hcm delivery recon\` \u8981\u8FDE\u5BA2\u6237\u5185\u7F51\u7684 HCM** \u2014\u2014 \u62FF\u4E0D\u5230\u7F51\u7684\u673A\u5668\u4E0A\u8FD9\u6761\u51FA\u8DEF\u8D70\u4E0D\u901A\uFF0C\u6B64\u65F6**\u522B\u628A\u8FD9\u4EFD\u57FA\u7EBF\u5F53 complete \u7528**\uFF0C\u628A\u5B83\u5E26\u56DE\u8FDE\u5F97\u4E0A\u7684\u5730\u65B9\u91CD\u722C`
+    }
+  ];
+}
+function inGap(token2) {
+  return [...token2].length <= 1 || /^\p{Nd}+$/u.test(token2);
+}
+function allMatches(regex, line) {
+  const out = [];
+  const re = new RegExp(regex.source, regex.flags.includes("g") ? regex.flags : `${regex.flags}g`);
+  let m;
+  while ((m = re.exec(line)) !== null) {
+    if (m[0] === "") {
+      re.lastIndex += 1;
+      continue;
+    }
+    out.push(m);
+  }
+  return out;
+}
+function overlaps(span, spans) {
+  return spans.some(([s, e]) => span[0] < e && s < span[1]);
+}
+function endpointsIn(line) {
+  const out = [];
+  for (const regex of [URL_ENDPOINT_RE, HOSTLESS_ENDPOINT_RE]) {
+    for (const m of allMatches(regex, line)) {
+      const span = [m.index, m.index + m[0].length];
+      if (!overlaps(
+        span,
+        out.map(([, s]) => s)
+      )) {
+        out.push([m[1], span]);
+      }
+    }
+  }
+  for (const m of allMatches(BARE_ENDPOINT_RE, line)) {
+    const span = [m.index, m.index + m[0].length];
+    if (!overlaps(
+      span,
+      out.map(([, s]) => s)
+    )) {
+      out.push([m[0], span]);
+    }
+  }
+  return out;
+}
+function normalize(token2) {
+  return token2.replace(PLACEHOLDER_RE2, "{}");
+}
+function factsIndex(facts) {
+  return facts.map((token2) => segmentsOf(normalize(token2)));
+}
+function covered(token2, index) {
+  const segments = segmentsOf(normalize(token2));
+  return index.some(
+    (template) => template.length === segments.length && template.every((t, i) => t === "{}" || t === segments[i])
+  );
+}
+var SEGMENT_SEPARATOR = "/";
+function segmentsOf(token2) {
+  return token2.split(SEGMENT_SEPARATOR);
+}
+function artifactReason(token2) {
+  const segments = segmentsOf(token2);
+  const head = segments.slice(0, -1);
+  const last = segments[segments.length - 1] ?? "";
+  if (head.includes(ARTIFACT_ROOT)) return REASON_PRODUCT_TREE_PATH;
+  for (let i = 0; i < head.length; i += 1) {
+    if (head[i] === RECON_DIRNAME && segments.length - i - 1 > RECON_SEGMENTS_BELOW_ROOT) {
+      return REASON_PRODUCT_TREE_PATH;
+    }
+  }
+  if (segments.length === 2 && PRODUCT_RELATIVE_SHAPES.some(
+    ([subdir, suffix]) => segments[0] === subdir && last.endsWith(suffix)
+  )) {
+    return REASON_PRODUCT_RELATIVE_PATH;
+  }
+  if (ARTIFACT_SUFFIXES.some((suffix) => last.endsWith(suffix))) return REASON_PRODUCT_FILE_NAME;
+  return null;
+}
+var CJK_RANGES = [
+  [13312, 19903],
+  [19968, 40959],
+  [63744, 64255]
+];
+function isCjk(char) {
+  const code = char?.codePointAt(0);
+  return code !== void 0 && CJK_RANGES.some(([low, high]) => code >= low && code <= high);
+}
+function boundedFind(line, token2) {
+  let start = line.indexOf(token2);
+  while (start >= 0) {
+    const end = start + token2.length;
+    const leftOk = start === 0 || !(isWordChar(token2[0]) && isWordChar(line[start - 1]));
+    const rightOk = end >= line.length || !(isWordChar(token2[token2.length - 1]) && isWordChar(line[end]));
+    if (leftOk && rightOk) return start;
+    start = line.indexOf(token2, start + 1);
+  }
+  return -1;
+}
+function cjkRunAt(line, start, token2) {
+  const end = start + token2.length;
+  if (isCjk(token2[0]) && start > 0 && isCjk(line[start - 1])) return true;
+  return isCjk(token2[token2.length - 1]) && end < line.length && isCjk(line[end]);
+}
+var Matcher = class {
+  owners;
+  simple;
+  byFirst;
+  constructor(aclass) {
+    this.owners = /* @__PURE__ */ new Map();
+    for (const kind of ACLASS_KINDS) {
+      for (const token2 of [...aclass[kind] ?? []].sort()) {
+        const owned = this.owners.get(token2);
+        if (owned) owned.push(kind);
+        else this.owners.set(token2, [kind]);
+      }
+    }
+    this.simple = new Set([...this.owners.keys()].filter((t) => SIMPLE_TOKEN.test(t)));
+    this.byFirst = /* @__PURE__ */ new Map();
+    for (const token2 of this.owners.keys()) {
+      if (this.simple.has(token2)) continue;
+      const first = token2[0];
+      if (first === void 0) continue;
+      const bucket = this.byFirst.get(first);
+      if (bucket) bucket.push(token2);
+      else this.byFirst.set(first, [token2]);
+    }
+  }
+  /**
+   * → 这一行命中的 `[(token, **有边界的**那一处的位置)]`，同一 token 一行只报一次。
+   *
+   * 🔴 **位置必须来自 `boundedFind`，不许再算一遍 `indexOf`**。起手那版用 `boundedFind`
+   * 确认「这一行**存在**一处合法边界命中」，返回的却是第一处裸子串 —— 可能根本不是那一处。
+   * 下游把这个位置交给 `cjkRunAt` 做分桶，于是**在同一行前面加一处诱饵写法就能把一条
+   * 真红压掉**。辖区 = 首/末字符为 CJK、另一端为词字符的**混合形态** token；纯 ASCII 与
+   * 纯 CJK 两个位置必然相等，所以此前每一项变异都照不到它。
+   * 「存在一处合法命中」是「这一处合法」的**必要条件**，不是充分条件。
+   *
+   * 🔴 **`sort` 不是洁癖，它是这份输出的确定性本身**：按插入序遍历会让非纯词形 token 的
+   * 先后随输入变化，集合、rc、判词全都一样，只有顺序变 —— 那正是「静默」的定义，
+   * 而它坏的是**验证仪器**：任何「前后两版输出逐字相等」的复核都会假红。
+   */
+  hits(line) {
+    const seen = /* @__PURE__ */ new Set();
+    const result = [];
+    for (const m of allMatches(WORD_RE, line)) {
+      const token2 = m[0];
+      if (token2 !== void 0 && this.simple.has(token2) && !seen.has(token2)) {
+        seen.add(token2);
+        result.push([token2, boundedFind(line, token2)]);
+      }
+    }
+    for (const char of [.../* @__PURE__ */ new Set([...line])].sort()) {
+      for (const token2 of this.byFirst.get(char) ?? []) {
+        if (seen.has(token2)) continue;
+        const start = boundedFind(line, token2);
+        if (start >= 0) {
+          seen.add(token2);
+          result.push([token2, start]);
+        }
+      }
+    }
+    return result;
+  }
+};
+function classReasons(problems) {
+  const out = /* @__PURE__ */ new Map();
+  for (const problem of problems ?? []) {
+    if (problem.scope === CLASS_SCOPE) {
+      for (const kind of problem.kinds) out.set(kind, problem.reason);
+    }
+  }
+  return out;
+}
+var INVISIBLE_RE = /\p{Cf}/u;
+var FULLWIDTH_ALNUM_RANGES = [
+  [65296, 65305, 65296 - 48],
+  [65313, 65338, 65313 - 65],
+  [65345, 65370, 65345 - 97]
+];
+var FOLDED_NOTE = "\uFF1B\u26A0\uFE0F \u8FD9\u4E00\u5904\u662F**\u5F52\u4E00\u4E4B\u540E**\u624D\u8BA4\u51FA\u6765\u7684\uFF1A\u539F\u6587\u91CC\u5939\u4E86\u4E0D\u53EF\u89C1\u5B57\u7B26\u6216\u5168\u89D2\u5B57\u7B26\uFF0C\u76F4\u63A5\u6309\u4E0A\u9762\u8FD9\u4E2A\u8BCD\u53BB grep \u4F1A\u641C\u4E0D\u5230";
+var foldedOriginal = (literal) => `\uFF0C\u539F\u6587\u91CC\u90A3\u4E00\u6BB5\u662F ${JSON.stringify(literal)}`;
+function foldWithMap(line) {
+  const out = [];
+  const origin = [];
+  for (let i = 0; i < line.length; i += 1) {
+    const char = line[i];
+    if (INVISIBLE_RE.test(char)) continue;
+    const code = char.charCodeAt(0);
+    let folded = char;
+    for (const [low, high, offset] of FULLWIDTH_ALNUM_RANGES) {
+      if (code >= low && code <= high) {
+        folded = String.fromCharCode(code - offset);
+        break;
+      }
+    }
+    out.push(folded);
+    origin.push(i);
+  }
+  return [out.join(""), origin];
+}
+function foldConfusables(line) {
+  return foldWithMap(line)[0];
+}
+function foldedNoteFor(original, folded, token2) {
+  if (original.includes(token2)) return "";
+  let start = boundedFind(folded, token2);
+  if (start < 0) start = folded.indexOf(token2);
+  if (start < 0) {
+    return FOLDED_NOTE;
+  }
+  const [, origin] = foldWithMap(original);
+  const from = origin[start];
+  const to = origin[start + token2.length - 1];
+  if (from === void 0 || to === void 0) return FOLDED_NOTE;
+  return FOLDED_NOTE + foldedOriginal(original.slice(from, to + 1));
+}
+function judgeLine(line, lineno, rel, matcher, index, reds, gaps) {
+  const folded = foldConfusables(line);
+  const lineReds = [];
+  const lineGaps = [];
+  judgePass(line, lineno, rel, matcher, index, lineReds, lineGaps);
+  if (folded !== line) judgePass(folded, lineno, rel, matcher, index, lineReds, lineGaps);
+  const seen = /* @__PURE__ */ new Set();
+  const unique2 = [];
+  for (const red of lineReds) {
+    const key = `${red.channel} ${red.token}`;
+    if (seen.has(key)) continue;
+    seen.add(key);
+    unique2.push({ ...red, message: red.message + foldedNoteFor(line, folded, red.token) });
+  }
+  reds.push(...unique2);
+  const redTokens = new Set(unique2.filter((r) => r.channel === CHANNEL_ACLASS).map((r) => r.token));
+  const seenGaps = /* @__PURE__ */ new Set();
+  for (const gap of lineGaps) {
+    const key = `${gap.reason} ${gap.token}`;
+    if (seenGaps.has(key) || folded !== line && redTokens.has(gap.token)) continue;
+    seenGaps.add(key);
+    gaps.push({ ...gap, why: gap.why + foldedNoteFor(line, folded, gap.token) });
+  }
+}
+function judgePass(line, lineno, rel, matcher, index, reds, gaps) {
+  for (const [token2, start] of matcher.hits(line)) {
+    const kinds = matcher.owners.get(token2) ?? [];
+    if (inGap(token2)) {
+      gaps.push({
+        reason: GAP_NOISE_TOKEN,
+        token: token2,
+        kinds,
+        path: rel,
+        line: lineno,
+        why: `${rel}:${lineno} \u7EAF\u6570\u5B57 / \u5355\u5B57\u7B26 ${JSON.stringify(token2)} \u2014\u2014 \u5224\u7EA2\u8FD9\u4E00\u5C42**\u58F0\u660E\u7684\u7F3A\u53E3**\uFF0C\u67E5\u8FC7\u3001\u6309\u7F3A\u53E3\u653E\u884C`
+      });
+      continue;
+    }
+    if (cjkRunAt(line, start, token2)) {
+      gaps.push({
+        reason: GAP_CJK_INSIDE_LONGER_RUN,
+        token: token2,
+        kinds,
+        path: rel,
+        line: lineno,
+        why: `${rel}:${lineno} ${JSON.stringify(token2)}\uFF08A \u7C7B ${kinds.join("/")}\uFF09\u843D\u5728\u4E00\u4E32\u66F4\u957F\u7684\u4E2D\u6587\u91CC \u2014\u2014 \u4E2D\u6587\u6CA1\u6709\u5206\u8BCD\u8FB9\u754C\uFF0C**\u8BF4\u4E0D\u51C6**\u5B83\u662F\u4E0D\u662F\u90A3\u4E2A\u53D6\u503C\uFF1B\u4E0D\u9876 rc\uFF0C\u8BF7\u81EA\u5DF1\u770B\u4E00\u773C`
+      });
+      continue;
+    }
+    reds.push({
+      channel: CHANNEL_ACLASS,
+      reason: REASON_ENVIRONMENT_FACT,
+      token: token2,
+      path: rel,
+      line: lineno,
+      kinds,
+      message: `${rel}:${lineno} \u51FA\u73B0\u73AF\u5883\u4E8B\u5B9E ${JSON.stringify(token2)}\uFF08A \u7C7B ${kinds.join("/")}\uFF09\u2014\u2014 \u6362\u4E2A\u5BA2\u6237\u5C31\u5168\u9519\uFF0C**\u65E0\u8C41\u514D**`
+    });
+  }
+  const spans = [];
+  for (const [token2, span] of endpointsIn(line)) {
+    spans.push(span);
+    judgeProtocol(token2, REASON_ENDPOINT, "\u7AEF\u70B9", lineno, rel, matcher, index, reds);
+  }
+  for (const regex of [PATHISH_RE, PRODUCT_FILE_RE]) {
+    for (const m of allMatches(regex, line)) {
+      const span = [m.index, m.index + m[0].length];
+      if (overlaps(span, spans)) continue;
+      const token2 = m[0];
+      const reason = artifactReason(token2);
+      if (reason === null) continue;
+      spans.push(span);
+      reds.push({
+        channel: CHANNEL_ARTIFACT,
+        reason,
+        token: token2,
+        path: rel,
+        line: lineno,
+        kinds: [],
+        message: `${rel}:${lineno} ${artifactWordingFor(reason)(token2)} \u2014\u2014 \u4EA7\u7269\u8DEF\u5F84**\u65E0\u8C41\u514D**\uFF0C\u767B\u8BB0\u518C\u4E0D\u53D7\u7406\u5B83\uFF1Bskill \u6B63\u6587\u8BE5\u8BF4\u7684\u662F\u8DD1\u54EA\u6761\u547D\u4EE4\uFF0C\u4E0D\u662F\u53BB\u8BFB\u54EA\u4E2A\u6587\u4EF6`
+      });
+    }
+  }
+  for (const m of allMatches(ERROR_CODE_RE, line)) {
+    const span = [m.index, m.index + m[0].length];
+    if (overlaps(span, spans)) continue;
+    spans.push(span);
+    judgeProtocol(m[0], REASON_ERROR_CODE, "\u9519\u8BEF\u7801", lineno, rel, matcher, index, reds);
+  }
+}
+function judgeProtocol(token2, reason, shape, lineno, rel, matcher, index, reds) {
+  if (matcher.owners.has(token2)) return;
+  if (covered(token2, index)) return;
+  reds.push({
+    channel: CHANNEL_UNREGISTERED,
+    reason,
+    token: token2,
+    path: rel,
+    line: lineno,
+    kinds: [],
+    message: `${rel}:${lineno} \u51FA\u73B0${shape} ${JSON.stringify(token2)}\uFF0C\u800C\u5B83**\u6CA1\u6709\u767B\u8BB0**\u5728\u968F\u5305\u7684\u534F\u8BAE\u4E8B\u5B9E\u767B\u8BB0\u518C\u91CC \u21D2 \u8981\u4E48\u6539\u5199\u6210\u4E0D\u4F9D\u8D56\u5B83\u7684\u8BF4\u6CD5\uFF0C\u8981\u4E48\u7ED9 CLI \u63D0\u4E00\u6761\u767B\u8BB0\uFF08\u767B\u8BB0\u5FC5\u987B\u9644\u4E00\u4E2A\u65AD\u884C\u4E3A\u7684\u63A2\u9488\uFF09`
+  });
+}
+function scan(skillRoot, aclass, facts, options = {}) {
+  const reds = [];
+  const premise = [];
+  const gaps = [];
+  const scanned = [];
+  const matcher = new Matcher(aclass);
+  const index = factsIndex(facts);
+  const reasons = classReasons(options.aclassProblems);
+  for (const kind of ACLASS_KINDS) {
+    if ((aclass[kind]?.size ?? 0) > 0) continue;
+    const reason = reasons.get(kind);
+    let why = "";
+    if (reason !== void 0) {
+      if (!(reason in ACLASS_EMPTY_WHY)) {
+        throw new Error(
+          `\u7C7B\u7EA7\u6210\u56E0 ${JSON.stringify(reason)} \u6CA1\u6709\u5BF9\u5E94\u7684\u63AA\u8F9E\uFF08\u8BA4\u5F97\u7684\u662F ${CLASS_REASONS.join("/")}\uFF09`
+        );
+      }
+      why = ACLASS_EMPTY_WHY[reason];
+    }
+    premise.push({
+      reason: REASON_ACLASS_EMPTY,
+      message: `A \u7C7B\u5B50\u96C6 ${kind} \u662F\u7A7A\u7684${why} \u21D2 \u95E8 0 \u5BF9\u8FD9\u4E00\u7C7B**\u6052\u7EFF**\uFF0C\u8FD9\u4E00\u8F6E\u7684\u7EFF\u4E0D\u7B97\u6570`
+    });
+  }
+  for (const problem of options.aclassProblems ?? []) {
+    if (problem.scope !== ENTRY_SCOPE) continue;
+    premise.push({
+      reason: REASON_ACLASS_PARTIALLY_UNREAD,
+      message: `A \u7C7B\u5B50\u96C6 ${problem.kinds.join("/")} \u5C11\u4E86\u4E00\u90E8\u5206\uFF08${problem.reason}\uFF09\uFF1A${problem.message} \u21D2 \u5C11\u6389\u7684\u90A3\u90E8\u5206\u95E8 0 \u5224\u4E0D\u51FA\u6765\uFF0C\u8FD9\u4E00\u8F6E\u7684\u7EFF\u4E0D\u7B97\u6570`
+    });
+  }
+  let factsProblems = options.factsProblems;
+  if (factsProblems === void 0) {
+    premise.push({
+      reason: REASON_CHANNEL_FOUR_UNCHECKED,
+      message: "\u6CA1\u6709\u628A loadProtocolFacts \u7684\u53F0\u8D26\u4F20\u8FDB\u6765 \u21D2 \u901A\u9053\u56DB\uFF08\u767B\u8BB0\u9879\u88AB\u62D2\uFF09\u4E00\u6761\u90FD\u6CA1\u67E5\u8FC7\u2014\u2014\u300C\u767B\u8BB0\u518C\u5E72\u51C0\u300D\u4E0E\u300C\u6CA1\u67E5\u767B\u8BB0\u518C\u300D\u5728\u8FD4\u56DE\u503C\u4E0A\u540C\u5F62"
+    });
+    factsProblems = [];
+  }
+  for (const problem of factsProblems) {
+    if (problem.scope === REGISTRY_SCOPE && PREMISE_REGISTRY_REASONS.includes(problem.reason)) {
+      premise.push({
+        reason: REASON_REGISTRY,
+        message: `\u767B\u8BB0\u518C\u8FD9\u4E00\u5C42\u6CA1\u7ACB\u4F4F\uFF08${problem.reason}\uFF09\uFF1A${problem.message} \u21D2 \u8C41\u514D\u901A\u9053 P \u4E0D\u53EF\u4FE1`
+      });
+    }
+  }
+  for (const problem of factsProblems) {
+    if (problem.scope === REGISTRY_SCOPE) continue;
+    reds.push({
+      channel: CHANNEL_NO_PROBE,
+      reason: REASON_REJECTED_REGISTRATION,
+      token: problem.token ?? `(\u7B2C${problem.index}\u6761)`,
+      path: null,
+      line: 0,
+      kinds: [],
+      message: `\u767B\u8BB0\u518C\u7B2C ${problem.index} \u6761\u88AB\u62D2\uFF08${problem.reason}\uFF09\uFF1A${problem.message}`
+    });
+  }
+  for (const token2 of [...facts].sort()) {
+    const kinds = matcher.owners.get(token2);
+    if (!kinds) continue;
+    reds.push({
+      channel: CHANNEL_REGISTERED_IS_ACLASS,
+      reason: REASON_REGISTERED_IS_ACLASS,
+      token: token2,
+      path: null,
+      line: 0,
+      kinds,
+      message: `\u767B\u8BB0\u518C\u767B\u8BB0\u4E86 ${JSON.stringify(token2)}\uFF0C\u800C\u5B83\u662F A \u7C7B\u73AF\u5883\u4E8B\u5B9E\uFF08${kinds.join("/")}\uFF09\u2014\u2014 recon \u67E5\u5F97\u5230\u7684\u4E1C\u897F\u4E0D\u662F\u7248\u672C\u7EA7\u534F\u8BAE\uFF0C\u767B\u8BB0\u5B83\u4E70\u4E0D\u5230\u4EFB\u4F55\u8C41\u514D`
+    });
+  }
+  let files = [];
+  if (!isDirectory(skillRoot)) {
+    premise.push({
+      reason: REASON_NO_SKILL_ROOT,
+      message: `\u626B\u63CF\u9762 ${skillRoot} \u4E0D\u662F\u4E00\u4E2A\u76EE\u5F55 \u21D2 \u4E00\u4E2A\u5B57\u90FD\u6CA1\u626B\u8FC7\uFF08\u8FD9\u4E0D\u662F\u300C\u626B\u8FC7\u3001\u5E72\u51C0\u300D\uFF09`
+    });
+  } else {
+    const walked = walk2(skillRoot);
+    files = walked.files;
+    for (const link of walked.unscannedLinks) {
+      let target;
+      try {
+        target = readlinkSync(link);
+      } catch {
+        target = "(\u8BFB\u4E0D\u51FA\u94FE\u63A5\u76EE\u6807)";
+      }
+      premise.push({
+        reason: REASON_SYMLINK_NOT_SCANNED,
+        message: `${path11.relative(skillRoot, link)} \u662F\u4E00\u4E2A\u7B26\u53F7\u94FE\u63A5\uFF08\u6307\u5411 ${JSON.stringify(target)}\uFF09\u21D2 \u95E8 0 **\u6CA1\u6709\u987A\u7740\u5B83\u626B\u8FC7\u4E00\u4E2A\u5B57**\uFF0C\u8FD9\u4E00\u8F6E\u7684\u7EFF\u4E0D\u7B97\u6570\u3002\u51FA\u8DEF\uFF1A\u628A\u8FD9\u6761\u94FE\u4ECE skill \u91CC\u53BB\u6389 \u2014\u2014 \u94FE\u540E\u9762\u90A3\u4EFD\u5185\u5BB9\u672C\u8BE5\u88AB\u5224\u5C31 \`cp -RL\` \u62F7\u6210\u771F\u5185\u5BB9\uFF08\u26A0\uFE0F \u73AF\u8DEF\u4E0E\u65AD\u94FE\u4E0A\u5B83\u4F1A\u5F53\u573A\u62A5\u9519\uFF0C\u90A3\u4E24\u79CD\u76F4\u63A5\u5220\uFF09\uFF1B\u5185\u5BB9\u5DF2\u7ECF\u5728 skill \u91CC\uFF08\u6307\u5411\u540C\u6811\u7684\u522B\u540D\uFF09\u4E5F\u76F4\u63A5\u5220\u3002**\u4E0D\u8DDF\u968F**\u662F\u523B\u610F\u7684 \u2014\u2014 \u8DDF\u8FC7\u53BB\u4F1A\u8FDE\u4E0A\u73AF\u8DEF\u3001\u6216\u8D8A\u51FA skill \u76EE\u5F55\u626B\u5230\u65E0\u5173\u6587\u4EF6`
+      });
+    }
+    if (files.length === 0) {
+      premise.push({
+        reason: REASON_NOTHING_SCANNED,
+        message: `\u626B\u63CF\u9762 ${skillRoot} \u5728\u76D8\u4E0A\uFF0C\u4F46\u91CC\u9762\u4E00\u4E2A\u6587\u4EF6\u90FD\u6CA1\u6709 \u2014\u2014 \u67E5\u8FC7\u4E14\u4E3A\u7A7A`
+      });
+    }
+  }
+  for (const file of files) {
+    let text;
+    try {
+      text = readFileSync7(file, "utf8");
+    } catch (e) {
+      premise.push({
+        reason: REASON_FILE_UNREADABLE,
+        message: `${file} \u8BFB\u4E0D\u52A8\uFF08${String(e)}\uFF09\u21D2 \u5224\u4E0D\u4E86\u5B83\u5E72\u4E0D\u5E72\u51C0\uFF0C\u95E8 0 \u4E0D\u80FD\u5BF9\u7740\u5B83\u8BF4\u7EFF`
+      });
+      continue;
+    }
+    const rel = path11.relative(skillRoot, file);
+    scanned.push(rel);
+    text.split("\n").forEach((line, i) => {
+      judgeLine(line, i + 1, rel, matcher, index, reds, gaps);
+    });
+  }
+  const seen = /* @__PURE__ */ new Set();
+  const unique2 = [];
+  for (const red of checkReds(reds)) {
+    const key = `${red.channel} ${red.token} ${red.path} ${red.line}`;
+    if (seen.has(key)) continue;
+    seen.add(key);
+    unique2.push(red);
+  }
+  const channels = Object.fromEntries(
+    CHANNELS.map((name) => [name, unique2.filter((r) => r.channel === name)])
+  );
+  return {
+    red: unique2,
+    channels,
+    scanned,
+    gaps: checkGaps(gaps),
+    premise: checkPremise(premise)
+  };
+}
+function isDirectory(target) {
+  try {
+    return statSync3(target).isDirectory();
+  } catch {
+    return false;
+  }
+}
+function walk2(root) {
+  const files = [];
+  const unscannedLinks = [];
+  const visit = (dir) => {
+    for (const entry of readdirSync3(dir, { withFileTypes: true })) {
+      const full = path11.join(dir, entry.name);
+      let followed = null;
+      try {
+        followed = statSync3(full);
+      } catch {
+        followed = null;
+      }
+      if (followed?.isFile()) {
+        files.push(full);
+      } else if (entry.isSymbolicLink()) {
+        unscannedLinks.push(full);
+      } else if (followed?.isDirectory()) {
+        visit(full);
+      }
+    }
+  };
+  visit(root);
+  return { files: files.sort(), unscannedLinks: unscannedLinks.sort() };
+}
+function exitCode(result) {
+  if (result.premise.length > 0) return 2;
+  if (result.red.length > 0) return 1;
+  return 0;
+}
 export {
+  ACLASS_EMPTY_WHY,
+  ACLASS_KINDS,
+  ARTIFACT_ROOT,
+  ARTIFACT_SUFFIXES,
+  ARTIFACT_WORDING,
   AUTH_INFO_PATH,
   BLIND_SPOTS,
+  CHANNELS,
+  CHANNEL_ACLASS,
+  CHANNEL_ARTIFACT,
+  CHANNEL_NO_PROBE,
+  CHANNEL_REGISTERED_IS_ACLASS,
+  CHANNEL_UNREGISTERED,
+  CLASS_REASONS,
+  CLASS_SCOPE,
   CliError,
   CliErrorCode,
   DEFAULT_AGENT_ID,
   DEFAULT_SESSION_TTL_SECONDS,
   DOCTOR_ANCHORS,
+  ENDPOINT_PREFIXES,
+  ENTRY_SCOPE,
+  ENUM_ELEMENT_KEYS,
   EXTENSION_SOURCE_HEADER,
   ExitCode,
+  FACTS_REASONS,
+  FOLDED_NOTE,
+  FULLWIDTH_ALNUM_RANGES,
+  GAP_CJK_INSIDE_LONGER_RUN,
+  GAP_NOISE_TOKEN,
+  GAP_REASONS,
   GATE_COMPONENTS,
   HcmClient,
   KIT_CARRY_OVER_KEY,
@@ -7568,6 +8705,7 @@ export {
   LEDGER_MISSING_WORD,
   LayoutContainmentError,
   MANIFEST_PATH,
+  MAPPING_ARTIFACT_VERSION,
   MAX_MANIFEST_PAGES,
   MAX_SOURCE_PROBES,
   META_PATH,
@@ -7578,16 +8716,37 @@ export {
   MINI_REMOTE_ROOT,
   MINI_STATE_DIR,
   MODELS_PATH,
+  MappingArtifactError,
+  Matcher,
   PASSWORD_CHANGE_REQUIRED,
+  PREMISE_REASONS,
+  PREMISE_REGISTRY_REASONS,
   PROACTIVE_REFRESH_MARGIN_SECONDS,
+  PROBE_MARK_PREFIX,
+  PRODUCT_RELATIVE_SHAPES,
   PRODUCT_STATE_WORDS,
+  PROTOCOL_FACTS,
+  REASON_DUPLICATE_TOKEN,
+  REASON_EMPTY,
+  REASON_NO_ENTRIES,
+  REASON_PROBE_ABSENT,
+  REASON_PROBE_SHAPE,
+  REASON_PROBE_UNVERIFIED,
+  REASON_UNREAD,
+  RECON_DIRNAME,
+  RECON_SEGMENTS_BELOW_ROOT,
+  RED_REASONS,
+  REGISTRY_REASONS,
+  REGISTRY_SCOPE,
   ROUND_EXIT_CODES,
   ROUND_STAMPED_PRODUCTS,
   ROUND_STATES,
   ROUND_SUBCOMMAND,
   ReconLayout,
   RefStore,
+  SCOPES,
   SDK_VERSION,
+  SEGMENT_SEPARATOR,
   TargetModelNotFound,
   TokenStore,
   VERSION_PATH,
@@ -7595,10 +8754,13 @@ export {
   absoluteDownloadUrl,
   adminResetPassword,
   archiveDir,
+  artifactReason,
   assertSafeReferencePath,
   assertSafeSkillFilePath,
   assertSafeSkillId,
+  baselineRoundPremise,
   bootstrapTenant,
+  boundedFind,
   buildAnswer,
   buildConfirm,
   buildInterrupt,
@@ -7610,6 +8772,10 @@ export {
   buildSteer,
   camelizeKeys,
   changePassword,
+  checkGaps,
+  checkPremise,
+  checkReds,
+  cjkRunAt,
   classifyMessage,
   clearMetaCache,
   clearModelCache,
@@ -7617,6 +8783,7 @@ export {
   computeFingerprint,
   computeReconSourceKey,
   conversationStateFile,
+  covered,
   create,
   createConversation,
   createHttpClient,
@@ -7629,6 +8796,7 @@ export {
   deleteIdentity,
   deleteTenantMeta,
   deleteWorkspaceFile,
+  deriveAclass,
   deriveNamelessToolLabel,
   describePrincipal,
   detectDelegationPause,
@@ -7636,12 +8804,15 @@ export {
   detectPasswordChangeChallenge,
   displayWidth,
   downloadDocument,
+  endpointsIn,
   ensureSessionFresh,
   envDir,
   envFile,
   envsDir,
+  exitCode,
   exitCodeFor,
   extractNextSteps,
+  factsIndex,
   fetchConversationTimeline,
   fetchConversationTimelineStrict,
   fetchRecentConversations,
@@ -7653,6 +8824,8 @@ export {
   filterByStage,
   findLastAssistantSeq,
   flattenSkills,
+  foldConfusables,
+  foldedNoteFor,
   formatMiniVerifyReport,
   formatObject,
   formatRows,
@@ -7668,10 +8841,12 @@ export {
   identitiesDir,
   identityDir,
   identityMetaFile,
+  inGap,
   inferEnvName,
   inferMiniWritableTemplateOptionsFromModel,
   initMiniAppProject,
   inspectRound,
+  isCjk,
   isDelegationToolName,
   isServerSlidingSession,
   listEnvs,
@@ -7684,6 +8859,7 @@ export {
   loadGlobalConfig,
   loadIdentity,
   loadProfile,
+  loadProtocolFacts,
   loadWorkspaceFileContent,
   loginClientCredentials,
   loginPairing,
@@ -7695,6 +8871,7 @@ export {
   modelKeys,
   needsRefresh,
   newRoundId,
+  normalize,
   normalizeReferences,
   oneShot,
   parseConfirmToolName,
@@ -7711,6 +8888,7 @@ export {
   profileFile,
   pullMiniAppProject,
   pushMiniAppProject,
+  readBusinessKeyFields,
   readMiniContext,
   readPullManifest,
   refreshToken,
@@ -7738,6 +8916,8 @@ export {
   saveProfile,
   saveTenantMeta,
   saveWorkspaceFileContent,
+  scan,
+  segmentsOf,
   sendMessageAndStream,
   snakeToCamel,
   tenantSegment,
@@ -7747,6 +8927,7 @@ export {
   toTable,
   toYaml,
   truncateDisplay,
+  unguardedKinds,
   update,
   uploadDocument,
   validateMiniProject