chore(builds): 重編 tier2 成品——把 #108 放進執行檔（出貨路徑 A 的第 0 步）

原始碼修好不等於使用者拿得到：`.worker-builds/` 是安裝器與 `acr update`
實際部署的那份執行檔。本次一併重編，repo_dirty=false、repo_head=b223a698。

  arcrun-cypher-executor  sha256=e0026a23792f  source=b223a698 ← #108
  arcrun-kbdb             sha256=9c6d41895d78  source=f87d0e92（未變）
  arcrun-http-request     sha256=9a9dcb71879a  source=1e85dfb4（未變）
  arcrun-code             sha256=285a7406ec69  source=621cb8d9（未變）
  arcrun-mcp              sha256=3ebc0d441bc0  source=10d150ac（未變）

其餘四顆的 js 位元組有變是 esbuild 版本/相依重裝造成的重編，source commit 未動。
本次起這條路徑多一道閘：編成品前先跑租戶來源檢查，違規直接「建置中止」
（見同 PR 的 scripts/build-worker-artifacts.mjs）——實跑輸出貼在 PR。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

.claude/rules/02-forbidden.md

@@ -142,6 +142,37 @@ SDD 屬於架構決策，必須人確認。CC 不可以自行在 `docs/3-specs/`
 
 ---
 
+---
+
+## 第六類：租戶字串來源（Arcrun#108／#105 同族）
+
+### 6.1 靜態租戶字串不得用於資料面過濾
+**知識資料面的 `owner_id`（三元組／entries／records／藏書地圖／工作流 KV）必須與寫入端同源。**
+寫入端只有一個真相源＝使用者 `~/.arcrun/config.yaml` 的 `api_key`（＝實例 namespace，
+CLI push／小幫手上傳／MCP 都用它）。讀取端拿另一份手抄的環境變數預設值 → 全被過濾掉。
+
+實害：`portalTenant(env) = env.CONSOLE_TENANT || "leo"` 讓 leo 的 **1854 條三元組被過濾成 0 個庫**
+（#108）；前一天 `ownerNamespace(env) = env.MCP_OWNER_NAMESPACE || "leo"` 是同一句話（#105）。
+
+**規則**：
+1. `cypher-executor/src/lib/tenant.ts` 是租戶字串的**唯一產地**。
+   `CONSOLE_TENANT` / `ARCRUN_NAMESPACE` 只能在該檔被讀取。
+2. 知識資料面用 `knowledgeOwner(env)`（回 `TenantId`），過濾一律經
+   `ownerQuery()` / `ownerField()`——它們只吃 `TenantId`，`tsc` 就擋掉「隨手一個 string」。
+3. 帳號層用 `accountTenant(env)`（回 `string`，**刻意不是 TenantId**）：帳號子 namespace
+   `{tenant}::portal` 與 cypher 自己寫的設定用它，型別上不可能流進知識資料面。
+4. 身分解析路徑上**不准有字面預設值**。解析不到 → 丟 `TenantUnresolvedError`，
+   誠實回「讀不到」（不是「你沒有」，#100 同一條）。
+
+**機械強制**（規則存在但沒機制驗證＝它會再犯第三次）：
+- 出貨閘：`scripts/build-worker-artifacts.mjs` 編 tier2 成品前先掃，違規 → **編不出成品**。
+- 本機自查：`cd cypher-executor && npm run check:tenant`（`npm test` 也會先跑它）。
+- 規則本體：`cypher-executor/scripts/tenant-source-rules.mjs`（純函式）；
+  閘自己的測試：`cypher-executor/tests/tenant-gate.test.ts`（壞例子會擋＋合法寫法零誤攔）。
+
+> 尚未接上 PreToolUse hook（`.claude/hooks/` 為受保護檔案，需人類加入）。
+> 要加的話：檢查器已備妥 `--stdin <相對路徑>` 模式，可在寫入前擋。
+
 ## Hook Block 訊息格式
 
 當 hook 擋住一個操作時，訊息格式統一為：

.worker-builds/arcrun-code/worker.mjs

@@ -1,12 +1,7 @@
 var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
-var __esm = (fn, res, err2) => function __init() {
+var __esm = (fn, res) => function __init() {
-  if (err2) throw err2[0];
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
-  try {
-    return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
-  } catch (e) {
-    throw err2 = [e], e;
-  }
 };
 var __export = (target, all) => {
   for (var name in all)
@@ -107,7 +102,7 @@ function applyBaseRuntimeOptions(runtime, options) {
 function applyModuleEvalRuntimeOptions(runtime, options) {
   options.moduleLoader && runtime.setModuleLoader(options.moduleLoader), options.shouldInterrupt && runtime.setInterruptHandler(options.shouldInterrupt), options.memoryLimitBytes !== void 0 && runtime.setMemoryLimit(options.memoryLimitBytes), options.maxStackSizeBytes !== void 0 && runtime.setMaxStackSize(options.maxStackSizeBytes);
 }
-var __defProp2, __export2, QTS_DEBUG, errors_exports, QuickJSUnwrapError, QuickJSWrongOwner, QuickJSUseAfterFree, QuickJSNotImplemented, QuickJSAsyncifyError, QuickJSAsyncifySuspended, QuickJSMemoryLeakDetected, QuickJSEmscriptenModuleError, QuickJSUnknownIntrinsic, QuickJSPromisePending, QuickJSEmptyGetOwnPropertyNames, AwaitYield, UsingDisposable, SymbolDispose, prototypeAsAny, Lifetime, StaticLifetime, WeakLifetime, Scope, AbstractDisposableResult, DisposableSuccess, DisposableFail, DisposableResult, QuickJSDeferredPromise, ModuleMemory, DefaultIntrinsics, QuickJSIterator, ContextMemory, QuickJSContext, QuickJSRuntime, QuickJSEmscriptenModuleCallbacks, QuickJSModuleCallbacks, QuickJSWASMModule;
+var __defProp2, __export2, QTS_DEBUG, errors_exports, QuickJSUnwrapError, QuickJSWrongOwner, QuickJSUseAfterFree, QuickJSNotImplemented, QuickJSAsyncifyError, QuickJSAsyncifySuspended, QuickJSMemoryLeakDetected, QuickJSEmscriptenModuleError, QuickJSUnknownIntrinsic, QuickJSPromisePending, QuickJSEmptyGetOwnPropertyNames, AwaitYield, UsingDisposable, SymbolDispose, prototypeAsAny, Lifetime, StaticLifetime, WeakLifetime, Scope, AbstractDisposableResult, DisposableSuccess, DisposableFail, DisposableResult, QuickJSDeferredPromise, ModuleMemory, UnstableSymbol, DefaultIntrinsics, QuickJSIterator, ContextMemory, QuickJSContext, QuickJSRuntime, QuickJSEmscriptenModuleCallbacks, QuickJSModuleCallbacks, QuickJSWASMModule;
 var init_chunk_JTKJZQYV = __esm({
   "registry/components/code/node_modules/quickjs-emscripten-core/dist/chunk-JTKJZQYV.mjs"() {
     init_dist();
@@ -195,7 +190,7 @@ var init_chunk_JTKJZQYV = __esm({
         return this.dispose();
       }
     };
-    SymbolDispose = Symbol.dispose ?? /* @__PURE__ */ Symbol.for("Symbol.dispose");
+    SymbolDispose = Symbol.dispose ?? Symbol.for("Symbol.dispose");
     prototypeAsAny = UsingDisposable.prototype;
     prototypeAsAny[SymbolDispose] || (prototypeAsAny[SymbolDispose] = function() {
       return this.dispose();
@@ -414,6 +409,7 @@ Lifetime used`) : new QuickJSUseAfterFree("Lifetime not alive");
         return this.module._free(ptr), str;
       }
     };
+    UnstableSymbol = Symbol("Unstable");
     DefaultIntrinsics = Object.freeze({ BaseObjects: true, Date: true, Eval: true, StringNormalize: true, RegExp: true, JSON: true, Proxy: true, MapSet: true, TypedArrays: true, Promise: true });
     QuickJSIterator = class extends UsingDisposable {
       constructor(handle, context) {
@@ -777,7 +773,7 @@ ${cause.stack}Host: ${hostStack}`), Object.assign(exception, rest), exception;
         }
         return result.value;
       }
-      [/* @__PURE__ */ Symbol.for("nodejs.util.inspect.custom")]() {
+      [Symbol.for("nodejs.util.inspect.custom")]() {
         return this.alive ? `${this.constructor.name} { ctx: ${this.ctx.value} rt: ${this.rt.value} }` : `${this.constructor.name} { disposed }`;
       }
       getFunction(fn_id) {
@@ -913,7 +909,7 @@ ${cause.stack}Host: ${hostStack}`), Object.assign(exception, rest), exception;
       debugLog(...msg) {
         this._debugMode && console.log("quickjs-emscripten:", ...msg);
       }
-      [/* @__PURE__ */ Symbol.for("nodejs.util.inspect.custom")]() {
+      [Symbol.for("nodejs.util.inspect.custom")]() {
         return this.alive ? `${this.constructor.name} { rt: ${this.rt.value} }` : `${this.constructor.name} { disposed }`;
       }
       getSystemContext() {
@@ -1343,10 +1339,10 @@ async function QuickJSRaw(moduleArg = {}) {
       x ? (0 === h && (h = ra()), g[m] = x(e[m])) : g[m] = e[m];
     }
     b = a(...g);
-    return b = (function(k) {
+    return b = function(k) {
       0 !== h && sa(h);
       return "string" === d ? R(k) : "boolean" === d ? !!k : k;
-    })(b);
+    }(b);
   };
   c.wasmMemory ? r = c.wasmMemory : r = new WebAssembly.Memory({ initial: (c.INITIAL_MEMORY || 16777216) / 65536, maximum: 32768 });
   K();
@@ -1468,7 +1464,7 @@ async function QuickJSRaw(moduleArg = {}) {
   }, t: function(a, d) {
     c.callbacks.freeHostRef(void 0, a, d);
   } }, Z;
-  Z = await (async function() {
+  Z = await async function() {
     function a(b) {
       b = Z = b.exports;
       c._malloc = b.v;
@@ -1555,7 +1551,7 @@ async function QuickJSRaw(moduleArg = {}) {
     });
     M ??= c.locateFile ? c.locateFile ? c.locateFile("emscripten-module.wasm", u) : u + "emscripten-module.wasm" : new URL("emscripten-module.wasm", import.meta.url).href;
     return a((await ea(d)).instance);
-  })();
+  }();
   (function() {
     function a() {
       c.calledRun = true;
@@ -3038,7 +3034,7 @@ var Hono = class _Hono {
 var emptyParam = [];
 function match(method, path) {
   const matchers = this.buildAllMatchers();
-  const match2 = ((method2, path2) => {
+  const match2 = (method2, path2) => {
     const matcher = matchers[method2] || matchers[METHOD_NAME_ALL];
     const staticMatch = matcher[2][path2];
     if (staticMatch) {
@@ -3050,7 +3046,7 @@ function match(method, path) {
     }
     const index = match3.indexOf("", 1);
     return [matcher[1][index], match3];
-  });
+  };
   this.match = match2;
   return match2(method, path);
 }
@@ -4012,7 +4008,7 @@ app.post("/", async (c) => {
     );
   }
 });
-var index_default = app;
+var code_default = app;
 export {
-  index_default as default
+  code_default as default
 };

.worker-builds/arcrun-cypher-executor/worker.mjs

@@ -1,12 +1,7 @@
 var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
-var __esm = (fn, res, err) => function __init() {
+var __esm = (fn, res) => function __init() {
-  if (err) throw err[0];
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
-  try {
-    return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
-  } catch (e) {
-    throw err = [e], e;
-  }
 };
 var __export = (target, all) => {
   for (var name in all)
@@ -1506,7 +1501,7 @@ var init_hono_base = __esm({
 // cypher-executor/node_modules/.pnpm/hono@4.12.10/node_modules/hono/dist/router/reg-exp-router/matcher.js
 function match(method, path) {
   const matchers = this.buildAllMatchers();
-  const match2 = ((method2, path2) => {
+  const match2 = (method2, path2) => {
     const matcher = matchers[method2] || matchers[METHOD_NAME_ALL];
     const staticMatch = matcher[2][path2];
     if (staticMatch) {
@@ -1518,7 +1513,7 @@ function match(method, path) {
     }
     const index = match3.indexOf("", 1);
     return [matcher[1][index], match3];
-  });
+  };
   this.match = match2;
   return match2(method, path);
 }
@@ -7438,7 +7433,7 @@ var init_lib = __esm({
         ...processCreateParams(params)
       });
     };
-    BRAND = /* @__PURE__ */ Symbol("zod_brand");
+    BRAND = Symbol("zod_brand");
     ZodBranded = class extends ZodType {
       _parse(input) {
         const { ctx } = this._processInputParams(input);
@@ -7612,14 +7607,14 @@ var init_lib = __esm({
     onumber = () => numberType().optional();
     oboolean = () => booleanType().optional();
     coerce = {
-      string: ((arg) => ZodString.create({ ...arg, coerce: true })),
+      string: (arg) => ZodString.create({ ...arg, coerce: true }),
-      number: ((arg) => ZodNumber.create({ ...arg, coerce: true })),
+      number: (arg) => ZodNumber.create({ ...arg, coerce: true }),
-      boolean: ((arg) => ZodBoolean.create({
+      boolean: (arg) => ZodBoolean.create({
         ...arg,
         coerce: true
-      })),
+      }),
-      bigint: ((arg) => ZodBigInt.create({ ...arg, coerce: true })),
+      bigint: (arg) => ZodBigInt.create({ ...arg, coerce: true }),
-      date: ((arg) => ZodDate.create({ ...arg, coerce: true }))
+      date: (arg) => ZodDate.create({ ...arg, coerce: true })
     };
     NEVER = INVALID;
     z = /* @__PURE__ */ Object.freeze({
@@ -7840,7 +7835,6 @@ var init_recipe_loader = __esm({
         super(message);
         this.recipe = recipe;
       }
-      recipe;
     };
   }
 });
@@ -8847,7 +8841,7 @@ function recordRecipeStats(env, recipeKeys, ok, at, ctx) {
     )
   ).then(() => void 0);
   if (ctx?.waitUntil) ctx.waitUntil(promise);
-  else void promise;
+  else ;
 }
 function generateToken() {
   const tokenBytes = crypto.getRandomValues(new Uint8Array(16));
@@ -8889,7 +8883,7 @@ async function executeWebhookGraph(env, graph, triggerContext, token, apiKey, ct
         result.trace
       );
       if (ctx?.waitUntil) ctx.waitUntil(statsPromise);
-      else void statsPromise;
+      else ;
     }
     return { success: true, data: result.data, duration_ms };
   } catch (err) {
@@ -8913,7 +8907,7 @@ async function executeWebhookGraph(env, graph, triggerContext, token, apiKey, ct
         err.trace
       );
       if (ctx?.waitUntil) ctx.waitUntil(statsPromise);
-      else void statsPromise;
+      else ;
     }
     if (err instanceof ExecutionError) {
       const traceFormatted = err.trace.map((s) => ({
@@ -9380,7 +9374,6 @@ function extractTarget(input) {
   return typeof raw2 === "string" ? raw2 : JSON.stringify(raw2);
 }
 async function writeExecutionVerdict(env, workflowId, nodes, verdict, durationMs, message, input, apiKey) {
-  void nodes;
   try {
     const { base, headers } = kbdbBase(env);
     await fetch(`${base}/execution-log/record`, {
@@ -12557,6 +12550,45 @@ init_kbdb_proxy();
 
 // cypher-executor/src/routes/console-auth.ts
 init_dist();
+
+// cypher-executor/src/lib/tenant.ts
+var TenantUnresolvedError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "TenantUnresolvedError";
+  }
+};
+function knowledgeOwner(env) {
+  const injected = (env.ARCRUN_NAMESPACE ?? "").trim();
+  if (injected) return injected;
+  const legacy = (env.CONSOLE_TENANT ?? "").trim();
+  if (legacy) return legacy;
+  throw new TenantUnresolvedError(
+    "\u9019\u500B\u90E8\u7F72\u6C92\u6709\u77E5\u8B58\u547D\u540D\u7A7A\u9593\uFF08ARCRUN_NAMESPACE / CONSOLE_TENANT \u90FD\u6C92\u8A2D\uFF09\u2014\u2014\u4E0D\u77E5\u9053\u8981\u53BB\u54EA\u4E00\u683C\u627E\u8CC7\u6599\u3002\u8ACB\u8DD1 `acr update` \u8B93\u5B83\u5F9E\u4F60\u7684 ~/.arcrun/config.yaml \u6CE8\u5165\u3002"
+  );
+}
+function tenantFromApiKey(apiKey) {
+  const key = (apiKey ?? "").trim();
+  if (!key) throw new TenantUnresolvedError("\u7F3A\u5C11 X-Arcrun-API-Key\uFF0C\u7121\u6CD5\u6C7A\u5B9A\u67E5\u8A62\u7BC4\u570D");
+  return key;
+}
+function accountTenant(env) {
+  return env.CONSOLE_TENANT || "leo";
+}
+function ownerQuery(tenant2) {
+  return `owner_id=${encodeURIComponent(tenant2)}`;
+}
+function ownerField(tenant2) {
+  return tenant2;
+}
+function censusQueryAllTenants() {
+  return "owner_id=";
+}
+function isOwnedBy(value, tenant2) {
+  return typeof value === "string" && value === tenant2;
+}
+
+// cypher-executor/src/routes/console-auth.ts
 var consoleAuthRouter = new Hono2();
 var CREDS_KEY = "console:credentials";
 var SESSION_PREFIX = "console_sess:";
@@ -12583,7 +12615,7 @@ async function hashPassword(password, salt) {
   return h;
 }
 function tenantOf(c) {
-  return c.env.CONSOLE_TENANT || "leo";
+  return knowledgeOwner(c.env);
 }
 async function loadCredentials(env) {
   let fromStore = readAuthStore(env).console;
@@ -12854,10 +12886,10 @@ var DEFAULT_SESSION_TTL = 604800;
 var USER_TEMPLATE = "portal_user";
 var LIBRARY_TEMPLATE = "portal_library";
 function portalTenant(env) {
-  return env.CONSOLE_TENANT || "leo";
+  return accountTenant(env);
 }
 function portalNamespace(env) {
-  return `${portalTenant(env)}::portal`;
+  return `${accountTenant(env)}::portal`;
 }
 function sessionTtl(env) {
   const n = Number.parseInt(env.PORTAL_SESSION_TTL ?? "", 10);
@@ -12886,6 +12918,9 @@ async function run(c, fn) {
     if (e instanceof AuthStoreWriteError) {
       return c.json({ error: `\u8A8D\u8B49\u5132\u5B58\u5BEB\u5165\u5931\u6557\uFF1A${e.message}`, code: "auth_store_not_writable" }, 502);
     }
+    if (e instanceof TenantUnresolvedError) {
+      return c.json({ error: e.message, code: "tenant_unresolved" }, 500);
+    }
     if (e instanceof KbdbError) return c.json({ error: `KBDB \u4E0D\u53EF\u9054\u6216\u56DE\u932F\uFF1A${e.message}` }, 502);
     throw e;
   }
@@ -13768,10 +13803,9 @@ portalRouter.post(
       return c.json({ error: "email \u6216\u5BC6\u78BC\u932F\u8AA4" }, 401);
     }
     await clearLoginFail(c.env, email);
-    const tenant2 = portalTenant(c.env);
     const daemonCfg = {
       cypher_url: new URL(c.req.url).origin,
-      namespace: tenant2,
+      namespace: knowledgeOwner(c.env),
       library: "kb",
       email,
       instance_name: String(rec.values.display_name ?? "")
@@ -13787,7 +13821,7 @@ portalRouter.post(
     const body = await c.req.json().catch(() => null);
     const key = String(body?.key ?? "").trim();
     if (!key) return c.json({ error: "\u8ACB\u8CBC\u4E0A\u4F60\u7684 Google AI \u91D1\u9470" }, 400);
-    const tenant2 = portalTenant(c.env);
+    const tenant2 = knowledgeOwner(c.env);
     const kvKey2 = `${tenant2}:wf:rag_chat`;
     const raw2 = await c.env.WEBHOOKS.get(kvKey2, "text");
     if (!raw2) return c.json({ error: "\u9019\u500B\u5BE6\u4F8B\u6C92\u6709\u5B89\u88DD AI \u554F\u7B54\u5DE5\u4F5C\u6D41" }, 404);
@@ -13839,8 +13873,8 @@ portalRouter.get(
     });
     const known = new Set(out.map((l) => l.name));
     try {
-      const tenant2 = portalTenant(c.env);
+      const tenant2 = knowledgeOwner(c.env);
-      const ownerParam = `owner_id=${encodeURIComponent(tenant2)}`;
+      const ownerParam = ownerQuery(tenant2);
       const [autoRes, cardRes, tripletRes] = await Promise.all([
         kbdbFetch(c.env, `/entries/libraries?${ownerParam}`).catch(() => null),
         kbdbFetch(c.env, `/entries/library-stats?${ownerParam}`).catch(() => null),
@@ -13989,8 +14023,8 @@ portalRouter.get(
   (c) => run(c, async () => {
     const auth = await requirePortalAdmin(c);
     if (!auth.ok) return auth.res;
-    const ownerId = portalTenant(c.env);
+    const ownerId = knowledgeOwner(c.env);
-    const res = await kbdbFetch(c.env, `/execution-log/retention?owner_id=${encodeURIComponent(ownerId)}`);
+    const res = await kbdbFetch(c.env, `/execution-log/retention?${ownerQuery(ownerId)}`);
     if (!res.ok) throw new KbdbError(`GET /execution-log/retention \u2192 ${res.status}`);
     const data = await res.json();
     return c.json({ success: true, retention_days: data.retention_days ?? null, default_days: data.default_days ?? 90 });
@@ -14006,10 +14040,10 @@ portalRouter.put(
     if (days !== null && days !== void 0 && (typeof days !== "number" || !Number.isFinite(days) || days <= 0)) {
       return c.json({ error: "retention_days \u5FC5\u9808\u662F\u6B63\u6574\u6578\uFF0C\u6216 null\uFF08\u4EE3\u8868\u4E0D\u522A\u9664\uFF09" }, 400);
     }
-    const ownerId = portalTenant(c.env);
+    const ownerId = knowledgeOwner(c.env);
     const res = await kbdbFetch(c.env, "/execution-log/retention", {
       method: "PUT",
-      body: JSON.stringify({ owner_id: ownerId, retention_days: days === void 0 ? null : days })
+      body: JSON.stringify({ owner_id: ownerField(ownerId), retention_days: days === void 0 ? null : days })
     });
     if (!res.ok) throw new KbdbError(`PUT /execution-log/retention \u2192 ${res.status}`);
     const data = await res.json();
@@ -14026,10 +14060,10 @@ portalRouter.delete(
     const confirm = String(body?.confirm ?? "").trim();
     if (!confirm) return c.json({ error: 'body \u9808\u5E36 { confirm: "<\u5EAB\u540D>" } \u624D\u57F7\u884C\uFF08\u79FB\u9664\u6703\u5F71\u97FF\u8CC7\u6599\u53EF\u641C\u6027\uFF09' }, 400);
     if (confirm !== name) return c.json({ error: `confirm \u503C\u300C${confirm}\u300D\u8207\u5EAB\u540D\u300C${name}\u300D\u4E0D\u7B26` }, 400);
-    const ownerId = portalTenant(c.env);
+    const ownerId = knowledgeOwner(c.env);
     const res = await kbdbFetch(c.env, "/entries/deprecate-by-library", {
       method: "PATCH",
-      body: JSON.stringify({ owner_id: ownerId, library: name })
+      body: JSON.stringify({ owner_id: ownerField(ownerId), library: name })
     });
     if (!res.ok) throw new KbdbError(`PATCH /entries/deprecate-by-library \u2192 ${res.status}`);
     const data = await res.json();
@@ -14085,8 +14119,8 @@ async function buildDiagnostics(env, tenant2) {
   let embedding = { checked: false };
   try {
     const [statusRes, selftestRes] = await Promise.all([
-      kbdbFetch(env, `/embed/backfill/status?${new URLSearchParams({ owner_id: tenant2 }).toString()}`),
+      kbdbFetch(env, `/embed/backfill/status?${ownerQuery(tenant2)}`),
-      kbdbFetch(env, `/embed/selftest?${new URLSearchParams({ owner_id: tenant2 }).toString()}`)
+      kbdbFetch(env, `/embed/selftest?${ownerQuery(tenant2)}`)
     ]);
     const statusBody = await statusRes.json().catch(() => null);
     const selftestBody = await selftestRes.json().catch(() => null);
@@ -14108,7 +14142,7 @@ async function buildDiagnostics(env, tenant2) {
   }
   let library_count = 0;
   let triplet_count = 0;
-  const ownerParam = new URLSearchParams({ owner_id: tenant2 }).toString();
+  const ownerParam = ownerQuery(tenant2);
   try {
     const [registeredLibs, autoRes, tripletRes] = await Promise.all([
       listRecordsByTemplate(env, LIBRARY_TEMPLATE).catch(() => []),
@@ -14132,7 +14166,7 @@ async function buildDiagnostics(env, tenant2) {
   let library_scope_check = { ran: false };
   if (library_count === 0 && triplet_count === 0) {
     try {
-      const probeRes = await kbdbFetch(env, `/entries?${new URLSearchParams({ owner_id: tenant2, limit: "1" }).toString()}`);
+      const probeRes = await kbdbFetch(env, `/entries?${new URLSearchParams({ owner_id: ownerField(tenant2), limit: "1" }).toString()}`);
       const probeBody = await probeRes.json().catch(() => null);
       const total = probeBody?.total ?? 0;
       library_scope_check = {
@@ -14155,7 +14189,7 @@ portalRouter.get(
   (c) => run(c, async () => {
     const apiKey = (c.req.header("X-Arcrun-API-Key") ?? "").trim();
     if (!apiKey) return c.json({ error: "\u7F3A\u5C11 X-Arcrun-API-Key header" }, 401);
-    const core = await buildDiagnostics(c.env, apiKey);
+    const core = await buildDiagnostics(c.env, tenantFromApiKey(apiKey));
     return c.json({
       generated_at: (/* @__PURE__ */ new Date()).toISOString(),
       instance_url: new URL(c.req.url).origin,
@@ -14710,7 +14744,7 @@ async function cachedGiteaSprint(env, nowMs, waitUntil, fetcher = fetchGiteaSpri
   return { ...fresh, cache: "miss" };
 }
 consoleDashboardRouter.get("/console/dashboard-data", async (c) => {
-  const tenant2 = c.env.CONSOLE_TENANT || "leo";
+  const tenant2 = knowledgeOwner(c.env);
   const now2 = Date.now();
   const { base: kbdbUrl, headers: kbdbHeaders } = kbdbBase(c.env);
   const graphUrl = graphBase(c.env);
@@ -14862,7 +14896,7 @@ consoleDashboardRouter.get("/console/dashboard-data", async (c) => {
   });
 });
 consoleDashboardRouter.get("/console/kb-scale-data", async (c) => {
-  const tenant2 = c.env.CONSOLE_TENANT || "leo";
+  const tenant2 = knowledgeOwner(c.env);
   const { base, headers } = kbdbBase(c.env);
   const now2 = Date.now();
   const [wikiCards, tripletTotal, embedStatus] = await Promise.all([
@@ -14897,7 +14931,7 @@ consoleDashboardRouter.get("/console/settings-data", (c) => {
 consoleDashboardRouter.get("/console/triage-data", async (c) => {
   const ok = await validateConsoleSession(c.env, c.req.header("authorization"));
   if (!ok) return c.json({ error: "\u9700\u8981\u767B\u5165\uFF08console session\uFF09" }, 401);
-  const tenant2 = c.env.CONSOLE_TENANT || "leo";
+  const tenant2 = knowledgeOwner(c.env);
   const [todoEntries, inboxEntries] = await Promise.all([
     fetchEntries(c.env, tenant2, "todo", 500),
     fetchEntries(c.env, tenant2, "inbox", 200)
@@ -14912,7 +14946,7 @@ consoleDashboardRouter.post("/console/triage-check", async (c) => {
   const entryId = typeof body?.entry_id === "string" ? body.entry_id.trim() : "";
   if (!entryId) return c.json({ error: "entry_id \u5FC5\u586B" }, 400);
   const action = body?.action === "restore" ? "restore" : "check";
-  const tenant2 = c.env.CONSOLE_TENANT || "leo";
+  const tenant2 = knowledgeOwner(c.env);
   const { base, headers } = kbdbBase(c.env);
   const got = await fetchJson(
     `${base}/entries/${encodeURIComponent(entryId)}`,
@@ -14940,7 +14974,7 @@ init_kbdb_proxy();
 init_webhook_handlers();
 var portalDataRouter = new Hono2();
 async function getTenantWorkflowGraph(env, name) {
-  const raw2 = await env.WEBHOOKS.get(`${portalTenant(env)}:wf:${name}`, "text");
+  const raw2 = await env.WEBHOOKS.get(`${knowledgeOwner(env)}:wf:${name}`, "text");
   if (!raw2) return null;
   try {
     const rec = JSON.parse(raw2);
@@ -15033,7 +15067,7 @@ function findBestNodeMatch(searchTerm, nodeNames) {
 }
 async function tripletCount(env, owner) {
   try {
-    const res = await kbdbFetch(env, `/records/triplet-stats?owner_id=${encodeURIComponent(owner)}`);
+    const res = await kbdbFetch(env, `/records/triplet-stats?${owner === null ? censusQueryAllTenants() : ownerQuery(owner)}`);
     if (!res.ok) return null;
     const body = await res.json().catch(() => null);
     if (!body || !Array.isArray(body.stats)) return null;
@@ -15050,11 +15084,11 @@ async function tripletCount(env, owner) {
 async function tripletCensus(env, tenant2) {
   const owned = await tripletCount(env, tenant2);
   if (owned !== 0) return { owned, any: null };
-  return { owned, any: await tripletCount(env, "") };
+  return { owned, any: await tripletCount(env, null) };
 }
 async function fuzzyFindNode(env, tenant2, searchTerm) {
   try {
-    const res = await kbdbFetch(env, `/records/by-template/triplet?owner_id=${encodeURIComponent(tenant2)}`);
+    const res = await kbdbFetch(env, `/records/by-template/triplet?${ownerQuery(tenant2)}`);
     if (!res.ok) return null;
     const body = await res.json().catch(() => null);
     if (!body || !Array.isArray(body.records)) return null;
@@ -15082,7 +15116,7 @@ portalDataRouter.get(
     if (libraries.length === 0) {
       return c.json({ success: true, entries: [], count: 0, mode: "keyword", note: "\u6B64\u5E33\u865F\u5C1A\u672A\u88AB\u6388\u6B0A\u4EFB\u4F55\u77E5\u8B58\u5EAB\uFF0C\u8ACB\u806F\u7D61\u7BA1\u7406\u54E1\u3002" });
     }
-    const params = new URLSearchParams({ q, owner_id: portalTenant(c.env) });
+    const params = new URLSearchParams({ q, owner_id: ownerField(knowledgeOwner(c.env)) });
     if (!libraries.includes("*")) params.set("library", libraries.join(","));
     if (c.req.query("mode") === "semantic") {
       params.set("mode", "semantic");
@@ -15118,7 +15152,7 @@ portalDataRouter.get(
     const body = await res.json();
     const entry = body.entry;
     if (!entry) return notFound(c);
-    if ((entry.owner_id ?? "") !== portalTenant(c.env)) return notFound(c);
+    if (!isOwnedBy(entry.owner_id, knowledgeOwner(c.env))) return notFound(c);
     if (!canReadLibrary(libraries, entryLibrary(entry))) return notFound(c);
     return c.json({ success: true, entry });
   })
@@ -15133,7 +15167,7 @@ portalDataRouter.get(
       return c.json({ error: "\u7121\u77E5\u8B58\u5716\u8B5C\u6AA2\u8996\u6B0A\u9650" }, 403);
     }
     const nodeName = normalizeCjkQuery(c.req.param("name"));
-    const tenant2 = portalTenant(c.env);
+    const tenant2 = knowledgeOwner(c.env);
     const wfGraph = await getTenantWorkflowGraph(c.env, "graph_neighbors");
     if (wfGraph) {
       const depthRaw = c.req.query("depth") ?? "";
@@ -15187,9 +15221,9 @@ portalDataRouter.get(
     if (!await hasGraphAccess(c.env, libraries)) {
       return c.json({ error: "\u7121\u77E5\u8B58\u5716\u8B5C\u6AA2\u8996\u6B0A\u9650" }, 403);
     }
-    const tenant2 = portalTenant(c.env);
+    const tenant2 = knowledgeOwner(c.env);
     const [res, census] = await Promise.all([
-      kbdbFetch(c.env, `/records/by-template/triplet?owner_id=${encodeURIComponent(tenant2)}&limit=500`),
+      kbdbFetch(c.env, `/records/by-template/triplet?${ownerQuery(tenant2)}&limit=500`),
       tripletCensus(c.env, tenant2)
     ]);
     const tripletsTotal = census.owned;
@@ -15260,7 +15294,7 @@ portalDataRouter.get(
       wfGraph,
       { question },
       "rag_chat",
-      portalTenant(c.env),
+      knowledgeOwner(c.env),
       c.executionCtx
     );
     if (!result.success) {
@@ -15336,7 +15370,7 @@ portalDataRouter.get(
     if (!workflowsVisible(c.env, auth.user.values.role ?? "user")) {
       return c.json({ error: "\u9700\u8981 admin \u6B0A\u9650" }, 403);
     }
-    const tenant2 = portalTenant(c.env);
+    const tenant2 = knowledgeOwner(c.env);
     const prefix = `${tenant2}:wf:`;
     const list = await c.env.WEBHOOKS.list({ prefix });
     const workflows = await Promise.all(
@@ -15358,7 +15392,7 @@ portalDataRouter.get(
         let last_execution = null;
         const execRes = await kbdbFetch(
           c.env,
-          `/execution-log/latest?${new URLSearchParams({ workflow_id: name, owner_id: tenant2 }).toString()}`
+          `/execution-log/latest?${new URLSearchParams({ workflow_id: name, owner_id: ownerField(tenant2) }).toString()}`
         );
         const execBody = await execRes.json().catch(() => null);
         if (execRes.ok && execBody?.success && execBody.execution) {
@@ -15375,7 +15409,7 @@ function recordLibrary(values) {
   return typeof lib === "string" && lib.trim() ? lib.trim() : null;
 }
 function canReadRecord(rec, tenant2, libraries) {
-  if ((rec.owner_id ?? "") !== tenant2) return false;
+  if (!isOwnedBy(rec.owner_id, tenant2)) return false;
   const lib = recordLibrary(rec.values);
   return lib === null || canReadLibrary(libraries, lib);
 }
@@ -15386,9 +15420,17 @@ portalDataRouter.get(
     if (!auth.ok) return auth.res;
     const libraries = parseLibraries(auth.user.values.libraries);
     if (libraries.length === 0) {
-      return c.json({ success: true, libraries: [], count: 0, note: "\u6B64\u5E33\u865F\u5C1A\u672A\u88AB\u6388\u6B0A\u4EFB\u4F55\u77E5\u8B58\u5EAB\uFF0C\u8ACB\u806F\u7D61\u7BA1\u7406\u54E1\u3002" });
+      return c.json({
+        success: true,
+        libraries: [],
+        count: 0,
+        empty_confirmed: true,
+        empty_reason: "no_library_grant",
+        note: "\u6B64\u5E33\u865F\u5C1A\u672A\u88AB\u6388\u6B0A\u4EFB\u4F55\u77E5\u8B58\u5EAB\uFF0C\u8ACB\u806F\u7D61\u7BA1\u7406\u54E1\u3002"
+      });
     }
-    const res = await kbdbFetch(c.env, `/map?owner_id=${encodeURIComponent(portalTenant(c.env))}`);
+    const tenant2 = knowledgeOwner(c.env);
+    const res = await kbdbFetch(c.env, `/map?${ownerQuery(tenant2)}`);
     if (!res.ok) {
       return new Response(res.body, { status: res.status, headers: { "Content-Type": "application/json" } });
     }
@@ -15399,7 +15441,49 @@ portalDataRouter.get(
     const allowed = body.libraries.filter(
       (l) => typeof l?.library === "string" && canReadLibrary(libraries, l.library)
     );
-    return c.json({ success: true, libraries: allowed, count: allowed.length });
+    if (allowed.length > 0) {
+      return c.json({ success: true, libraries: allowed, count: allowed.length, empty_confirmed: false, empty_reason: null });
+    }
+    if (body.libraries.length > 0) {
+      return c.json({
+        success: true,
+        libraries: [],
+        count: 0,
+        empty_confirmed: true,
+        empty_reason: "filtered_out",
+        note: "\u9019\u500B\u5E33\u865F\u76EE\u524D\u6C92\u6709\u4EFB\u4F55\u77E5\u8B58\u5EAB\u7684\u6AA2\u8996\u6B0A\u9650\uFF0C\u8ACB\u806F\u7D61\u7BA1\u7406\u54E1\u958B\u901A\u3002"
+      });
+    }
+    const census = await tripletCensus(c.env, tenant2);
+    if (census.owned === null || census.owned === 0 && census.any === null) {
+      return c.json({
+        success: true,
+        libraries: [],
+        count: 0,
+        empty_confirmed: false,
+        empty_reason: "unreadable",
+        note: "\u8B80\u4E0D\u5230\u77E5\u8B58\u5EAB\u7684\u7D71\u8A08\uFF0C\u7121\u6CD5\u78BA\u8A8D\u5EAB\u88E1\u6709\u6C92\u6709\u6771\u897F\u2014\u2014\u9019\u4E0D\u662F\u300C\u9084\u6C92\u6709\u77E5\u8B58\u300D\uFF0C\u662F\u9019\u6B21\u8B80\u53D6\u5931\u6557\u3002\u8ACB\u7A0D\u5F8C\u91CD\u6574\u6216\u901A\u77E5\u7BA1\u7406\u54E1\u3002"
+      });
+    }
+    if (census.owned === 0 && (census.any ?? 0) > 0) {
+      return c.json({
+        success: true,
+        libraries: [],
+        count: 0,
+        empty_confirmed: false,
+        empty_reason: "scope_mismatch",
+        instance_triplet_count: census.any,
+        note: `\u8B80\u4E0D\u5230\u4F60\u9019\u500B\u5E33\u865F\u7BC4\u570D\u5167\u7684\u85CF\u66F8\u2014\u2014\u4F46\u9019\u53F0\u5BE6\u4F8B\u88E1\u6709 ${census.any} \u689D\u77E5\u8B58\u95DC\u806F\u3002\u9019\u4E0D\u662F\u300C\u9084\u6C92\u6709\u77E5\u8B58\u300D\uFF0C\u4E0D\u7528\u53BB\u91CD\u65B0\u4E0A\u50B3\uFF1B\u6BD4\u8F03\u50CF\u77E5\u8B58\u7684\u6B78\u5C6C\u547D\u540D\u7A7A\u9593\u5C0D\u4E0D\u4E0A\u3002\u8ACB\u901A\u77E5\u7BA1\u7406\u54E1\u8DD1\u4E00\u6B21 \`acr update\`\uFF08\u6703\u628A\u4F60\u5B89\u88DD\u6642\u7684\u547D\u540D\u7A7A\u9593\u540C\u6B65\u7D66\u96F2\u7AEF\uFF09\uFF0C\u6216\u6AA2\u67E5 ARCRUN_NAMESPACE \u8A2D\u5B9A\u3002`
+      });
+    }
+    return c.json({
+      success: true,
+      libraries: [],
+      count: 0,
+      empty_confirmed: true,
+      empty_reason: "confirmed_empty",
+      note: "\u77E5\u8B58\u5EAB\u9084\u6C92\u6709\u4EFB\u4F55\u5167\u5BB9\u2014\u2014\u4E0A\u50B3\u6587\u4EF6\u5F8C\u5C31\u6703\u51FA\u73FE\u5728\u9019\u88E1\u3002"
+    });
   })
 );
 portalDataRouter.get(
@@ -15412,7 +15496,7 @@ portalDataRouter.get(
     if (!canReadLibrary(libraries, library)) return notFound(c);
     const res = await kbdbFetch(
       c.env,
-      `/map/${encodeURIComponent(library)}?owner_id=${encodeURIComponent(portalTenant(c.env))}`
+      `/map/${encodeURIComponent(library)}?${ownerQuery(knowledgeOwner(c.env))}`
     );
     if (res.status === 404) return notFound(c);
     if (!res.ok) return c.json({ error: `KBDB \u56DE\u932F\uFF08HTTP ${res.status}\uFF09` }, 502);
@@ -15445,7 +15529,7 @@ portalDataRouter.post(
         name: body.name,
         slots: body.slots,
         description: typeof body.description === "string" ? body.description : void 0,
-        created_by: portalTenant(c.env)
+        created_by: knowledgeOwner(c.env)
       })
     });
     return new Response(res.body, { status: res.status, headers: { "Content-Type": "application/json" } });
@@ -15458,10 +15542,10 @@ portalDataRouter.get(
     if (!auth.ok) return auth.res;
     const libraries = parseLibraries(auth.user.values.libraries);
     if (libraries.length === 0) return c.json({ success: true, records: [], count: 0 });
-    const tenant2 = portalTenant(c.env);
+    const tenant2 = knowledgeOwner(c.env);
     const res = await kbdbFetch(
       c.env,
-      `/records/by-template/${encodeURIComponent(c.req.param("template"))}?owner_id=${encodeURIComponent(tenant2)}`
+      `/records/by-template/${encodeURIComponent(c.req.param("template"))}?${ownerQuery(tenant2)}`
     );
     if (!res.ok) return c.json({ error: `KBDB \u56DE\u932F\uFF08HTTP ${res.status}\uFF09` }, 502);
     const body = await res.json().catch(() => null);
@@ -15485,7 +15569,7 @@ portalDataRouter.get(
     const body = await res.json().catch(() => null);
     const record = body?.record;
     if (!record) return notFound(c);
-    if (!canReadRecord(record, portalTenant(c.env), libraries)) return notFound(c);
+    if (!canReadRecord(record, knowledgeOwner(c.env), libraries)) return notFound(c);
     return c.json({ success: true, record });
   })
 );
@@ -15510,7 +15594,7 @@ portalDataRouter.post(
     const res = await kbdbFetch(c.env, "/records", {
       method: "POST",
       headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ template: body.template, values, owner_id: portalTenant(c.env) })
+      body: JSON.stringify({ template: body.template, values, owner_id: ownerField(knowledgeOwner(c.env)) })
     });
     return new Response(res.body, { status: res.status, headers: { "Content-Type": "application/json" } });
   })
@@ -15520,7 +15604,7 @@ portalDataRouter.get(
   (c) => run(c, async () => {
     const auth = await requirePortalUser(c);
     if (!auth.ok) return auth.res;
-    const tenant2 = portalTenant(c.env);
+    const tenant2 = knowledgeOwner(c.env);
     const core = await buildDiagnostics(c.env, tenant2);
     return c.json({
       generated_at: (/* @__PURE__ */ new Date()).toISOString(),
@@ -15570,10 +15654,10 @@ app.route("/", consoleAuthRouter);
 app.route("/", consoleDashboardRouter);
 app.route("/", portalRouter);
 app.route("/", portalDataRouter);
-var index_default = {
+var src_default = {
   fetch: app.fetch,
   scheduled: handleScheduled
 };
 export {
-  index_default as default
+  src_default as default
 };

.worker-builds/arcrun-http-request/worker.mjs

@@ -1427,7 +1427,7 @@ var Hono = class _Hono {
 var emptyParam = [];
 function match(method, path) {
   const matchers = this.buildAllMatchers();
-  const match2 = ((method2, path2) => {
+  const match2 = (method2, path2) => {
     const matcher = matchers[method2] || matchers[METHOD_NAME_ALL];
     const staticMatch = matcher[2][path2];
     if (staticMatch) {
@@ -1439,7 +1439,7 @@ function match(method, path) {
     }
     const index = match3.indexOf("", 1);
     return [matcher[1][index], match3];
-  });
+  };
   this.match = match2;
   return match2(method, path);
 }
@@ -2522,7 +2522,7 @@ app.post("/", async (c) => {
     );
   }
 });
-var index_default = app;
+var src_default = app;
 async function runWasm(input) {
   const hostFunctions = {
     http_request: async (url, method, headersJson, body) => {
@@ -2568,5 +2568,5 @@ async function runWasm(input) {
   return JSON.parse(stdout);
 }
 export {
-  index_default as default
+  src_default as default
 };

.worker-builds/arcrun-kbdb/worker.mjs

@@ -1444,7 +1444,7 @@ var Hono = class _Hono {
 var emptyParam = [];
 function match(method, path) {
   const matchers = this.buildAllMatchers();
-  const match2 = ((method2, path2) => {
+  const match2 = (method2, path2) => {
     const matcher = matchers[method2] || matchers[METHOD_NAME_ALL];
     const staticMatch = matcher[2][path2];
     if (staticMatch) {
@@ -1456,7 +1456,7 @@ function match(method, path) {
     }
     const index = match3.indexOf("", 1);
     return [matcher[1][index], match3];
-  });
+  };
   this.match = match2;
   return match2(method, path);
 }
@@ -4157,7 +4157,7 @@ app.route("/recipe-stats", recipeStatRoutes);
 app.route("/execution-log", executionLogRoutes);
 app.route("/embed", embedRoutes);
 app.route("/map", mapRoutes);
-var index_default = app;
+var src_default = app;
 export {
-  index_default as default
+  src_default as default
 };

.worker-builds/arcrun-mcp/worker.mjs

@@ -5,11 +5,7 @@ var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __commonJS = (cb, mod) => function __require() {
-  try {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
-    return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
-  } catch (e) {
-    throw mod = 0, e;
-  }
 };
 var __export = (target, all) => {
   for (var name in all)
@@ -8227,7 +8223,7 @@ var Hono = class _Hono {
 var emptyParam = [];
 function match(method, path) {
   const matchers = this.buildAllMatchers();
-  const match2 = ((method2, path2) => {
+  const match2 = (method2, path2) => {
     const matcher = matchers[method2] || matchers[METHOD_NAME_ALL];
     const staticMatch = matcher[2][path2];
     if (staticMatch) {
@@ -8239,7 +8235,7 @@ function match(method, path) {
     }
     const index = match3.indexOf("", 1);
     return [matcher[1][index], match3];
-  });
+  };
   this.match = match2;
   return match2(method, path);
 }
@@ -12963,7 +12959,7 @@ ZodNaN.create = (params) => {
     ...processCreateParams(params)
   });
 };
-var BRAND = /* @__PURE__ */ Symbol("zod_brand");
+var BRAND = Symbol("zod_brand");
 var ZodBranded = class extends ZodType {
   _parse(input) {
     const { ctx } = this._processInputParams(input);
@@ -13165,14 +13161,14 @@ var ostring = () => stringType().optional();
 var onumber = () => numberType().optional();
 var oboolean = () => booleanType().optional();
 var coerce = {
-  string: ((arg) => ZodString.create({ ...arg, coerce: true })),
+  string: (arg) => ZodString.create({ ...arg, coerce: true }),
-  number: ((arg) => ZodNumber.create({ ...arg, coerce: true })),
+  number: (arg) => ZodNumber.create({ ...arg, coerce: true }),
-  boolean: ((arg) => ZodBoolean.create({
+  boolean: (arg) => ZodBoolean.create({
     ...arg,
     coerce: true
-  })),
+  }),
-  bigint: ((arg) => ZodBigInt.create({ ...arg, coerce: true })),
+  bigint: (arg) => ZodBigInt.create({ ...arg, coerce: true }),
-  date: ((arg) => ZodDate.create({ ...arg, coerce: true }))
+  date: (arg) => ZodDate.create({ ...arg, coerce: true })
 };
 var NEVER = INVALID;
 
@@ -13223,6 +13219,7 @@ function $constructor(name, initializer3, params) {
   Object.defineProperty(_, "name", { value: name });
   return _;
 }
+var $brand = Symbol("zod_brand");
 var $ZodAsyncError = class extends Error {
   constructor() {
     super(`Encountered Promise during synchronous parse. Use .parseAsync() instead.`);
@@ -15726,6 +15723,8 @@ function en_default2() {
 }
 
 // mcp/node_modules/.pnpm/zod@3.25.76/node_modules/zod/v4/core/registries.js
+var $output = Symbol("ZodOutput");
+var $input = Symbol("ZodInput");
 var $ZodRegistry = class {
   constructor() {
     this._map = /* @__PURE__ */ new Map();
@@ -17003,10 +17002,10 @@ var ZodMiniType = /* @__PURE__ */ $constructor("ZodMiniType", (inst, def) => {
   };
   inst.clone = (_def, params) => clone(inst, _def, params);
   inst.brand = () => inst;
-  inst.register = ((reg, meta) => {
+  inst.register = (reg, meta) => {
     reg.add(inst, meta);
     return inst;
-  });
+  };
 });
 var ZodMiniObject = /* @__PURE__ */ $constructor("ZodMiniObject", (inst, def) => {
   $ZodObject.init(inst, def);
@@ -17269,10 +17268,10 @@ var ZodType2 = /* @__PURE__ */ $constructor("ZodType", (inst, def) => {
   };
   inst.clone = (def2, params) => clone(inst, def2, params);
   inst.brand = () => inst;
-  inst.register = ((reg, meta) => {
+  inst.register = (reg, meta) => {
     reg.add(inst, meta);
     return inst;
-  });
+  };
   inst.parse = (data, params) => parse2(inst, data, params, { callee: inst.parse });
   inst.safeParse = (data, params) => safeParse3(inst, data, params);
   inst.parseAsync = async (data, params) => parseAsync2(inst, data, params, { callee: inst.parseAsync });
@@ -19244,13 +19243,11 @@ function assertCompleteRequestPrompt(request) {
   if (request.params.ref.type !== "ref/prompt") {
     throw new TypeError(`Expected CompleteRequestPrompt, but got ${request.params.ref.type}`);
   }
-  void request;
 }
 function assertCompleteRequestResourceTemplate(request) {
   if (request.params.ref.type !== "ref/resource") {
     throw new TypeError(`Expected CompleteRequestResourceTemplate, but got ${request.params.ref.type}`);
   }
-  void request;
 }
 var CompleteResultSchema = ResultSchema.extend({
   completion: looseObject({
@@ -19403,7 +19400,7 @@ function isTerminal(status) {
 }
 
 // mcp/node_modules/.pnpm/zod-to-json-schema@3.25.2_zod@3.25.76/node_modules/zod-to-json-schema/dist/esm/Options.js
-var ignoreOverride = /* @__PURE__ */ Symbol("Let zodToJsonSchema decide on which parser to use");
+var ignoreOverride = Symbol("Let zodToJsonSchema decide on which parser to use");
 var defaultOptions = {
   name: void 0,
   $refStrategy: "root",
@@ -22379,7 +22376,7 @@ var Server = class extends Protocol {
 };
 
 // mcp/node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@3.25.76/node_modules/@modelcontextprotocol/sdk/dist/esm/server/completable.js
-var COMPLETABLE_SYMBOL = /* @__PURE__ */ Symbol.for("mcp.completable");
+var COMPLETABLE_SYMBOL = Symbol.for("mcp.completable");
 function isCompletable(schema4) {
   return !!schema4 && typeof schema4 === "object" && COMPLETABLE_SYMBOL in schema4;
 }
@@ -24694,13 +24691,13 @@ function registerAllIntrospectionTools(server, env) {
 }
 
 // mcp/node_modules/.pnpm/yaml@2.9.0/node_modules/yaml/browser/dist/nodes/identity.js
-var ALIAS = /* @__PURE__ */ Symbol.for("yaml.alias");
+var ALIAS = Symbol.for("yaml.alias");
-var DOC = /* @__PURE__ */ Symbol.for("yaml.document");
+var DOC = Symbol.for("yaml.document");
-var MAP = /* @__PURE__ */ Symbol.for("yaml.map");
+var MAP = Symbol.for("yaml.map");
-var PAIR = /* @__PURE__ */ Symbol.for("yaml.pair");
+var PAIR = Symbol.for("yaml.pair");
-var SCALAR = /* @__PURE__ */ Symbol.for("yaml.scalar");
+var SCALAR = Symbol.for("yaml.scalar");
-var SEQ = /* @__PURE__ */ Symbol.for("yaml.seq");
+var SEQ = Symbol.for("yaml.seq");
-var NODE_TYPE = /* @__PURE__ */ Symbol.for("yaml.node.type");
+var NODE_TYPE = Symbol.for("yaml.node.type");
 var isAlias = (node) => !!node && typeof node === "object" && node[NODE_TYPE] === ALIAS;
 var isDocument = (node) => !!node && typeof node === "object" && node[NODE_TYPE] === DOC;
 var isMap = (node) => !!node && typeof node === "object" && node[NODE_TYPE] === MAP;
@@ -24730,9 +24727,9 @@ function isNode(node) {
 var hasAnchor = (node) => (isScalar(node) || isCollection(node)) && !!node.anchor;
 
 // mcp/node_modules/.pnpm/yaml@2.9.0/node_modules/yaml/browser/dist/visit.js
-var BREAK = /* @__PURE__ */ Symbol("break visit");
+var BREAK = Symbol("break visit");
-var SKIP = /* @__PURE__ */ Symbol("skip children");
+var SKIP = Symbol("skip children");
-var REMOVE = /* @__PURE__ */ Symbol("remove node");
+var REMOVE = Symbol("remove node");
 function visit(node, visitor) {
   const visitor_ = initVisitor(visitor);
   if (isDocument(node)) {
@@ -29325,9 +29322,9 @@ ${end.comment}` : end.comment;
 };
 
 // mcp/node_modules/.pnpm/yaml@2.9.0/node_modules/yaml/browser/dist/parse/cst-visit.js
-var BREAK2 = /* @__PURE__ */ Symbol("break visit");
+var BREAK2 = Symbol("break visit");
-var SKIP2 = /* @__PURE__ */ Symbol("skip children");
+var SKIP2 = Symbol("skip children");
-var REMOVE2 = /* @__PURE__ */ Symbol("remove item");
+var REMOVE2 = Symbol("remove item");
 function visit2(cst, visitor) {
   if ("type" in cst && cst.type === "document")
     cst = { start: cst.start, value: cst.value };
@@ -33599,7 +33596,7 @@ app.post("/", partnerAuthMiddleware, async (c) => {
   const identity = resolveKnowledgeIdentity(c.get("auth_path"), c.get("portal"));
   return handleMcpRequest(c.req.raw, c.env, orgNamespace, partnerToken, identity);
 });
-var index_default = _app;
+var src_default = _app;
 export {
-  index_default as default
+  src_default as default
 };

.worker-builds/manifest.json

@@ -1,18 +1,18 @@
 {
   "schema": 1,
   "built_for": "arcrun-tier2-worker-artifacts",
-  "generated_at": "2026-08-12T14:22:56.880Z",
+  "generated_at": "2026-08-12T16:16:33.433Z",
-  "repo_head": "21293568d550ab7ef50cec2020165d8bf4376104",
+  "repo_head": "b223a698844be289c1b01f99eb34a8e2ac85bb74",
   "repo_dirty": false,
   "workers": [
     {
       "name": "arcrun-cypher-executor",
       "source_dir": "cypher-executor",
-      "source_commit": "53b05c6d3d4a5a02661880dd5565fa9feb743bb6",
+      "source_commit": "b223a698844be289c1b01f99eb34a8e2ac85bb74",
       "main_module": "worker.mjs",
       "main_file": "arcrun-cypher-executor/worker.mjs",
-      "js_bytes": 584721,
+      "js_bytes": 588397,
-      "content_sha256": "b7c810d7654c05d197abe9a37acce2ed5f77e1af09595d5b4316b69166edf11a",
+      "content_sha256": "e0026a23792f8b6b02e35c91081604b9a761c608a2cae0e6ee8ab0f34a484501",
       "modules": [],
       "compat_date": "2025-02-19",
       "compat_flags": [
@@ -61,8 +61,8 @@
       "source_commit": "f87d0e92f49690253e7c89c5badc82a08eb5d21b",
       "main_module": "worker.mjs",
       "main_file": "arcrun-kbdb/worker.mjs",
-      "js_bytes": 149797,
+      "js_bytes": 149791,
-      "content_sha256": "8b23853cbc88aee0ca15ef20ca46e92bd8e75064cd311af2847f4d51811960b1",
+      "content_sha256": "9c6d41895d78cbf3048fb539690591c86071b7d6ebf7fb0b8b51607c6b1f8ee9",
       "modules": [],
       "compat_date": "2025-02-19",
       "compat_flags": [
@@ -90,8 +90,8 @@
       "source_commit": "1e85dfb49b0e8d81c0854781d93ee4e6a300c7b3",
       "main_module": "worker.mjs",
       "main_file": "arcrun-http-request/worker.mjs",
-      "js_bytes": 80079,
+      "js_bytes": 80073,
-      "content_sha256": "cdd97364f277587cbade69e09bb40812c68f26a1e8bc9aa632c65b1b962b0b85",
+      "content_sha256": "9a9dcb71879a7bdfd9fec1bd94eb9742e12cb63733d822ce63eeb1be30008d15",
       "modules": [
         {
           "name": "component.wasm",
@@ -122,8 +122,8 @@
       "source_commit": "621cb8d948d61be6202063fd02effb3f538437fe",
       "main_module": "worker.mjs",
       "main_file": "arcrun-code/worker.mjs",
-      "js_bytes": 153758,
+      "js_bytes": 153671,
-      "content_sha256": "751634a3fc9a99cc2da662026818d754c48f031d10bff3b3be2d3a8ee2311bd6",
+      "content_sha256": "285a7406ec694ae47dccfaf48517f712c74d207a1689dffa15c39f1555b45be5",
       "modules": [
         {
           "name": "quickjs.wasm",
@@ -151,8 +151,8 @@
       "source_commit": "10d150ac2b4385af95a457f3c411430c4a146cf9",
       "main_module": "worker.mjs",
       "main_file": "arcrun-mcp/worker.mjs",
-      "js_bytes": 1179487,
+      "js_bytes": 1179229,
-      "content_sha256": "1cd4c4d079d72bf7cba7c490ba6a88476f70b3ea51af7e5c93f9a184ae3c0ce6",
+      "content_sha256": "3ebc0d441bc04ae56a1205507da701f93bed9efa9b1e53c1777c04cbef5bdb67",
       "modules": [],
       "compat_date": "2024-11-27",
       "compat_flags": [

cli/package.json

@@ -8,12 +8,11 @@
   "main": "./dist/index.js",
   "type": "module",
   "scripts": {
-    "build": "npm run build:harness && npm run check:harness && npm run check:rule && tsc",
+    "build": "npm run build:harness && npm run check:harness && tsc",
     "build:harness": "node scripts/build-harness-skill.mjs",
     "check:harness": "node scripts/check-harness-generation.mjs",
-    "check:rule": "node ../scripts/sync-resource-rule.mjs --check",
     "dev": "tsc --watch",
-    "test": "npm run check:rule && node --experimental-transform-types --import ./tests/register-ts-hooks.mjs --test \"tests/**/*.test.ts\"",
+    "test": "node --experimental-transform-types --import ./tests/register-ts-hooks.mjs --test \"tests/**/*.test.ts\"",
     "prepublishOnly": "npm run build && chmod +x dist/index.js"
   },
   "dependencies": {

cli/src/commands/update.ts

@@ -17,6 +17,7 @@ import { loadConfig } from '../lib/config.js';
 import {
   wranglerAvailable,
   downloadAndDeploy,
+  namespaceHasKnowledge,
   type DeployContext,
 } from '../lib/deploy.js';
 
@@ -63,6 +64,32 @@ export async function cmdUpdate(opts: { force?: boolean } = {}): Promise<void> {
     kbdbEmbed: config.kbdb_embed !== false,
   };
 
+  // Arcrun#108：把「你的知識住在哪個命名空間」同步給雲端——但**先驗再寫**。
+  //
+  // 病灶：你 push 工作流、小幫手上傳知識、MCP 查詢，用的都是 config 的 `api_key`；
+  // 而 cypher 讀藏書地圖/搜尋/工作流時，過濾用的 owner_id 來自 worker 的環境變數
+  // （repo toml 帶的官方預設 `CONSOLE_TENANT = "leo"`）。兩個來源對不上 ⇒ 你的東西全被濾掉。
+  //
+  // 為什麼不無條件寫：一鍵安裝的實例，知識可能本來就寫在 `CONSOLE_TENANT` 底下。
+  // 無條件蓋成本機 api_key，會把一台**原本正常**的實例指向空的那一格
+  // ——那就是 #97/#106 那類「更新一次把人家的東西弄不見」。所以查得到才寫，查不到就不碰。
+  if (config.api_key && config.cypher_executor_url) {
+    process.stdout.write(chalk.gray('  → 核對雲端要用哪個知識命名空間...'));
+    const hasKnowledge = await namespaceHasKnowledge(config.cypher_executor_url, config.api_key);
+    if (hasKnowledge === true) {
+      ctx.knowledgeNamespace = config.api_key;
+      console.log(chalk.green(' ✓'));
+      console.log(chalk.gray(`    ARCRUN_NAMESPACE = ${config.api_key}（這個命名空間底下查得到你的知識庫）`));
+    } else if (hasKnowledge === false) {
+      console.log(chalk.yellow(' ⚠'));
+      console.log(chalk.gray(`    ${config.api_key} 底下目前查不到任何知識庫 → 這趟不動雲端的命名空間設定`));
+      console.log(chalk.gray('    （若藏書地圖是空的，請把這行連同 acr update 的輸出一起回報）'));
+    } else {
+      console.log(chalk.yellow(' ⚠'));
+      console.log(chalk.gray('    問不到實例（可能正在啟動或版本較舊）→ 這趟不動雲端的命名空間設定'));
+    }
+  }
+
   // mode:'update' → 資源解析在「一顆該更新的 worker 都找不到」時會停手而不是重建一整套
   //（Arcrun#97 的另一道門：名字對不上時別假裝這是全新安裝）。
   const result = await downloadAndDeploy(ctx, 'main', { force: opts.force, mode: 'update' });

cli/src/lib/cf-api.ts

@@ -3,8 +3,7 @@
  * 使用 CF REST API 直接存取用戶的 KV namespace，不依賴 Wrangler CLI
  */
 
-import { createCloudflareResourceApi } from './resource-rule/cf-resource-api.mjs';
+import type { LiveBinding, ResourceApi, ScriptBindings } from './resource-resolver.js';
-import type { ResourceApi, ScriptBindings } from './resource-resolver.js';
 
 const CF_API_BASE = 'https://api.cloudflare.com/client/v4';
 
@@ -87,81 +86,189 @@ export class CfKvClient {
  * 對應 SDD：.agents/specs/arcrun/sdk-and-website/self-hosted-init.md §3 step 1-2
  */
 export class CfAccountClient implements ResourceApi {
-  /**
+  private accountBase: string;
-   * `ResourceApi` 的七個方法**全部委派**給共用規則附的那支 client
+  private headers: Record<string, string>;
-   * （`shared/resource-rule/cf-resource-api.mjs`）。
-   *
-   * 🔴 為什麼不是在這裡自己實作一份：判斷一致還不夠，**看到的東西**也要一致。
-   *   兩條路各自寫一份 CF client，只要有一邊把 404 當錯誤、漏了 per_page、少認一種
-   *   欄位名，那一邊就會「看不到既有綁定」——而看不到既有綁定的下一步，依規則就是新建。
-   *   Arcrun#97 不需要規則寫錯，眼睛不一樣就足以重演。
-   */
-  private readonly rule: ReturnType<typeof createCloudflareResourceApi>;
 
   constructor(accountId: string, apiToken: string) {
-    this.rule = createCloudflareResourceApi({ accountId, apiToken });
+    this.accountBase = `${CF_API_BASE}/accounts/${accountId}`;
+    this.headers = {
+      'Authorization': `Bearer ${apiToken}`,
+      'Content-Type': 'application/json',
+    };
   }
 
   private async cf<T>(path: string, init?: RequestInit): Promise<T> {
-    const { ok, status, result, error } = await this.rule.cfRaw(path, init);
+    const { ok, status, result, error } = await this.cfRaw<T>(path, init);
     if (!ok) throw new Error(`CF API ${path} 失敗：${error ?? `HTTP ${status}`}`);
     return result as T;
   }
 
+  /** 同 cf()，但把 HTTP status 交回呼叫端自己判斷（要區分「404 不存在」和「其他錯誤」時用）。 */
+  private async cfRaw<T>(
+    path: string,
+    init?: RequestInit,
+  ): Promise<{ ok: boolean; status: number; result?: T; error?: string }> {
+    const res = await fetch(`${this.accountBase}${path}`, {
+      ...init,
+      headers: { ...this.headers, ...(init?.headers ?? {}) },
+    });
+    const data = await res.json().catch(() => null) as
+      | { success: boolean; result: T; errors?: Array<{ message: string }> }
+      | null;
+    if (!res.ok || !data?.success) {
+      return {
+        ok: false,
+        status: res.status,
+        error: data?.errors?.map(e => e.message).filter(Boolean).join('; ') || `HTTP ${res.status}`,
+      };
+    }
+    return { ok: true, status: res.status, result: data.result };
+  }
+
   /** 驗證 token 能存取此 account（權限不足會在後續建立操作報錯，這裡先確認 account 可達）。*/
   async verifyAccess(): Promise<void> {
     // GET /accounts/{id} 能通 = token 有此 account 的基本讀權限
     await this.cf<{ id: string; name: string }>('');
   }
 
+  /** 列出現有 KV namespace（冪等用：已存在就重用，不重建）。回傳 title → id 對照。*/
+  async listKvNamespaces(): Promise<Map<string, string>> {
+    const result = await this.cf<Array<{ id: string; title: string }>>(
+      '/storage/kv/namespaces?per_page=100',
+    );
+    const map = new Map<string, string>();
+    for (const ns of result) map.set(ns.title, ns.id);
+    return map;
+  }
+
+  /**
+   * 無條件新建一顆 KV namespace。
+   *
+   * 🔴 Arcrun#97：這裡**故意沒有**「找不到同名就順手建一顆」的 ensure 版本。
+   * 「照名字找 → 找不到 → 新建 → 綁上去」正是把使用者實例洗成空的那條路
+   * （安裝器取的名字跟我們的 binding 名不一樣，永遠對不上 ⇒ 每次更新都新建）。
+   * 要不要建，一律先經過 resource-resolver 的 planResources 判斷；那裡只有在
+   * 「確定沒有任何已部署的 worker 綁過這個 binding」時才會排進 create。
+   */
+  async createKvNamespace(title: string): Promise<string> {
+    const result = await this.cf<{ id: string; title: string }>(
+      '/storage/kv/namespaces',
+      { method: 'POST', body: JSON.stringify({ title }) },
+    );
+    return result.id;
+  }
+
+  /**
+   * 讀一顆已部署 worker 現在綁著哪些資源——**使用者那側的事實**（Arcrun#97 的唯一真相源）。
+   * CF：`GET /accounts/{id}/workers/scripts/{script}/settings` → `result.bindings[]`。
+   *
+   * - script 不存在（404）→ `{ deployed: false }`，這是「還沒部署」，不是錯誤。
+   * - 其他任何失敗 → throw。呼叫端必須把它當「我不知道」而**不是**「它沒有」——
+   *   把查不到當成不存在，就是 #97 的根因。
+   */
+  async getScriptBindings(script: string): Promise<ScriptBindings> {
+    const path = `/workers/scripts/${encodeURIComponent(script)}/settings`;
+    const res = await this.cfRaw<{ bindings?: RawWorkerBinding[] }>(path);
+    if (!res.ok) {
+      if (res.status === 404) return { deployed: false, bindings: [], vars: {} };
+      throw new Error(`讀 ${script} 綁定失敗：${res.error}`);
+    }
+    const raw = res.result?.bindings ?? [];
+    // #106：同一份回應裡也帶著 plain_text var（實測 CF `/settings` 會回 `text` 值）。
+    // 舊版只挑資源類、把 var 整批丟掉 → 重部署等於把它們洗掉。
+    return { deployed: true, bindings: normalizeBindings(raw), vars: normalizeVars(raw) };
+  }
+
   /** 查 workers.dev subdomain（cypher-executor WORKER_SUBDOMAIN 用，組對內 component URL）。*/
   async getWorkersSubdomain(): Promise<string> {
     const result = await this.cf<{ subdomain: string }>('/workers/subdomain');
     return result.subdomain;
   }
 
-  // ── 以下七支＝`ResourceApi`，一律委派共用規則，**這個檔案不得自己實作** ────────────
+  // D1 (KBDB Base). Free on Workers Free plan, no credit card (kbdb-base Q4 verified).
-  //    （`shared/resource-rule/cf-resource-api.mjs`；委派而非複製的理由見本 class 開頭）
+  async listD1Databases(): Promise<Map<string, string>> {
-
+    const result = await this.cf<Array<{ uuid: string; name: string }>>('/d1/database?per_page=100');
-  /** 讀一顆已部署 worker 現在綁著哪些資源——使用者那側的事實（Arcrun#97 的唯一真相源）。 */
+    const map = new Map<string, string>();
-  getScriptBindings(script: string): Promise<ScriptBindings> {
+    for (const db of result) map.set(db.name, db.uuid);
-    return this.rule.getScriptBindings(script);
+    return map;
-  }
-
-  /** 帳號上現有的 KV namespace（title → id）。判斷「綁著的那顆還在不在」用。 */
-  listKvNamespaces(): Promise<Map<string, string>> {
-    return this.rule.listKvNamespaces();
-  }
-
-  /** 帳號上現有的 D1（name → uuid）。 */
-  listD1Databases(): Promise<Map<string, string>> {
-    return this.rule.listD1Databases();
-  }
-
-  /** 帳號上現有的 Vectorize index 名單。 */
-  listVectorizeIndexes(): Promise<string[]> {
-    return this.rule.listVectorizeIndexes();
-  }
-
-  /**
-   * 無條件新建一顆 KV namespace。
-   *
-   * 🔴 Arcrun#97：**故意沒有**「找不到同名就順手建一顆」的 ensure 版本。
-   * 「照名字找 → 找不到 → 新建 → 綁上去」正是把使用者實例洗成空的那條路。
-   * 要不要建，一律先經過 planResources；那裡只有在「確定沒有任何已部署的 worker
-   * 綁過這個 binding」時才會排進 create。
-   */
-  createKvNamespace(title: string): Promise<string> {
-    return this.rule.createKvNamespace(title);
   }
 
   /** 無條件新建 D1。沒有 ensure 版本，理由同 createKvNamespace（Arcrun#97）。 */
-  createD1Database(name: string): Promise<string> {
+  async createD1Database(name: string): Promise<string> {
-    return this.rule.createD1Database(name);
+    const result = await this.cf<{ uuid: string; name: string }>(
+      '/d1/database',
+      { method: 'POST', body: JSON.stringify({ name }) },
+    );
+    return result.uuid;
   }
 
-  /** 新建 KBDB embed 用的 Vectorize index。沒有 ensure 版本，理由同上（Arcrun#97）。 */
+  /** 帳號上現有的 Vectorize index 名單（判斷「綁著的那顆還在不在」用）。 */
-  createVectorizeIndex(name: string): Promise<string> {
+  async listVectorizeIndexes(): Promise<string[]> {
-    return this.rule.createVectorizeIndex(name);
+    const result = await this.cf<Array<{ name: string }>>('/vectorize/v2/indexes');
+    return (result ?? []).map(i => i.name);
+  }
+
+  /**
+   * 新建 KBDB embed 用的 Vectorize index（**bge-m3 = 1024 維 / cosine**，見 deploy.ts 常數說明）。
+   * 已存在（409 / already exists）視為成功——並行或重跑不該炸。沒有 ensure 版本：
+   * 「要不要建」由 planResources 判斷，這裡只負責建（Arcrun#97）。
+   */
+  async createVectorizeIndex(name: string): Promise<string> {
+    const res = await this.cfRaw<{ name: string }>('/vectorize/v2/indexes', {
+      method: 'POST',
+      body: JSON.stringify({
+        name,
+        config: { dimensions: 1024, metric: 'cosine' },
+        description: 'arcrun KBDB embed module — bge-m3 1024d (issue #7 / #59)',
+      }),
+    });
+    if (res.ok) return name;
+    const detail = (res.error ?? '').toLowerCase();
+    if (res.status === 409 || /already exists|duplicate|conflict/.test(detail)) return name;
+    throw new Error(`建 Vectorize index ${name} 失敗：${res.error}`);
   }
 }
+
+/** CF `/settings` 回的 binding 原始形狀（同一種資源在不同 API 版本欄位名不一，故全都收）。 */
+interface RawWorkerBinding {
+  type?: string;
+  name?: string;
+  namespace_id?: string;
+  id?: string;
+  database_id?: string;
+  index_name?: string;
+  /** `plain_text` 綁定的值（#106；secret_text 不會回值，本來就讀不到，也不該讀）。 */
+  text?: string;
+}
+
+/**
+ * 抽出已部署 worker 上的 `plain_text` var（#106）。
+ *
+ * 只收 `plain_text`——**`secret_text` 一律不碰**（CF 本來就不回值，也不該被 CLI 搬來搬去；
+ * wrangler deploy 不會動 secret，它們自己會留著）。
+ */
+function normalizeVars(raw: RawWorkerBinding[]): Record<string, string> {
+  const out: Record<string, string> = {};
+  for (const b of raw) {
+    if (b?.type === 'plain_text' && b.name && typeof b.text === 'string') out[b.name] = b.text;
+  }
+  return out;
+}
+
+/** 把 CF 的 binding 陣列收斂成 resolver 認得的三種資源。不認得的型別直接略過。 */
+function normalizeBindings(raw: RawWorkerBinding[]): LiveBinding[] {
+  const out: LiveBinding[] = [];
+  for (const b of raw) {
+    if (!b?.name) continue;
+    if (b.type === 'kv_namespace') {
+      const value = b.namespace_id ?? b.id;
+      if (value) out.push({ kind: 'kv_namespace', binding: b.name, value });
+    } else if (b.type === 'd1' || b.type === 'd1_database') {
+      const value = b.id ?? b.database_id;
+      if (value) out.push({ kind: 'd1', binding: b.name, value });
+    } else if (b.type === 'vectorize') {
+      if (b.index_name) out.push({ kind: 'vectorize', binding: b.name, value: b.index_name });
+    }
+  }
+  return out;
+}

cli/src/lib/deploy.ts

@@ -298,6 +298,44 @@ export interface DeployContext {
   // [[vectorize]]+[ai] binding（取消 wrangler.toml 註解段）→ embed 模組啟用。未設/false → 不建、不注入，
   // base 維持 LIKE keyword（free-tier 友善）。
   kbdbEmbed?: boolean;
+  /**
+   * Arcrun#108：這台實例的知識命名空間（＝`~/.arcrun/config.yaml` 的 `api_key`），
+   * 會寫進 cypher worker 的 `ARCRUN_NAMESPACE` var，讓「讀」用的 owner_id 與「寫」的一致。
+   *
+   * **只在驗證過該 namespace 底下真的有知識時才給值**（見 `resolveKnowledgeNamespace`）——
+   * 給了就會覆蓋 worker 上的既有值，沒給則原封保留（preservedVars）。
+   */
+  knowledgeNamespace?: string;
+}
+
+/**
+ * 這把 namespace 底下到底有沒有知識？（Arcrun#108 的「先驗再寫」）
+ *
+ * 打的是實例自己的 `GET /kbdb/map?owner_id=<ns>`（cypher 既有的純轉發端點，CLI 平常就在用
+ * 這條路 + `X-Arcrun-API-Key`）。回傳：
+ *   true  ＝ 這個 namespace 底下查得到庫 → 寫 ARCRUN_NAMESPACE 是安全的
+ *   false ＝ 查得到但是空的 → 不寫（可能知識其實在別的命名空間，蓋下去會把畫面弄空）
+ *   null  ＝ 問不到（實例還沒起來 / 舊版沒這條路 / 網路斷）→ 不寫，也不宣稱任何事
+ *
+ * 誠實邊界：這支只回答「有沒有」，不猜「應該是哪一個」。猜錯的代價是把人家的資料藏起來。
+ */
+export async function namespaceHasKnowledge(
+  cypherUrl: string,
+  namespace: string,
+): Promise<boolean | null> {
+  if (!cypherUrl || !namespace) return null;
+  try {
+    const res = await fetch(
+      `${cypherUrl.replace(/\/+$/, '')}/kbdb/map?owner_id=${encodeURIComponent(namespace)}`,
+      { headers: { 'X-Arcrun-API-Key': namespace } },
+    );
+    if (!res.ok) return null;
+    const body = (await res.json().catch(() => null)) as { libraries?: unknown } | null;
+    if (!body || !Array.isArray(body.libraries)) return null;
+    return body.libraries.length > 0;
+  } catch {
+    return null;
+  }
 }
 
 /**
@@ -561,6 +599,21 @@ export async function downloadAndDeploy(
         vars.ARCRUN_BUNDLE_VERSION = stamp.version;
         if (stamp.commit) vars.ARCRUN_BUNDLE_COMMIT = stamp.commit;
       }
+      // Arcrun#108：把「你的知識實際住在哪個命名空間」告訴雲端。
+      //
+      // 為什麼需要：cypher 讀藏書地圖/搜尋/工作流時要用一個 owner_id 去過濾，而它以前拿的是
+      // repo toml 帶的官方預設值（`CONSOLE_TENANT = "leo"`）。寫入端（CLI push、小幫手上傳、
+      // MCP）用的卻是你 `~/.arcrun/config.yaml` 的 `api_key` ⇒ 兩邊對不上就整個空掉
+      //（leo 實撞：1854 條三元組被過濾成 0 個庫）。
+      //
+      // 🔴 **只在「這個 namespace 底下真的查得到知識」時才寫**（呼叫端已先驗過，見
+      //    resolveKnowledgeNamespace）。理由是反過來的那個災難：一鍵安裝的實例，知識可能
+      //    本來就寫在 CONSOLE_TENANT 底下；若這裡無條件蓋成本機 api_key，會把一台**原本正常**
+      //    的實例改成指向空的那一格——跟 #97/#106 同一類「更新一次把人家的東西弄不見」。
+      //    驗不過就不寫；既有值由 preservedVars 原封保留，等於這趟什麼都沒改。
+      if (ctx.knowledgeNamespace && script === VERSION_STAMP_WORKER) {
+        vars.ARCRUN_NAMESPACE = ctx.knowledgeNamespace;
+      }
       if (Object.keys(vars).length > 0) extraVarsByDir.set(dir, vars);
     }
     if (preservedTotal.length > 0) {

cli/src/lib/resource-resolver.ts

@@ -1,42 +1,431 @@
 /**
- * resource-resolver.ts — **這裡沒有邏輯**，只是把共用規則接到 CLI 的既有 import 路徑上。
+ * resource-resolver.ts — 資源解析：「已部署的 worker 現在綁著什麼，那就是事實」
  *
- * 「這個實例該用哪些資源」的規則住在 `shared/resource-rule/`（repo 根目錄），
+ * 🔴 Arcrun#97（2026-08-12 實害，leo 的實例中了）：
- * 那是**唯一一份人手維護的實作**；`./resource-rule/` 是該目錄的逐位元組鏡射
+ *   舊做法叫「照名字 ensure」——`acr update` 拿 **binding 名**（`WEBHOOKS`）當成 Cloudflare 上的
- * （`scripts/sync-resource-rule.mjs` 產生，`npm run build` / `npm test` 會跑 `--check` 擋漂移）。
+ *   **資源標題**去找，找不到就**新建一顆空的、然後綁到 worker 上**。
- * 之所以要有這份鏡射：`arcrun` 是獨立 npm 套件，`npm pack` 打不進套件目錄外的檔案。
+ *   安裝器建的資源不叫那個名字（它叫 `arcrun-rag-<instance>-kv-webhooks`）⇒ 一次例行更新
+ *   新建了 9 顆 KV、1 顆 D1，使用者的工作流／登入狀態／子庫**在畫面上全部消失**。
+ *   資料沒有被刪，但 worker 被綁去空的那幾顆——從使用者的角度，他的東西就是不見了。
  *
- * 為什麼規則不在 CLI（leo 2026-08-12）：
+ *   根因不是「KV 那段寫錯」，是**「用名字猜使用者的資源」這個做法本身**：
- *   「根本就不應該在 CLI，我要的是一個大家都可以用到的規則。」
+ *   名字是**使用者那側的事實**（安裝器要怎麼取名由它決定，而且它有權改），
- *   ——`acr` 有這條規則、安裝器沒有，結果就是 Arcrun#97：
+ *   我們不能拿自己的命名慣例去對號入座，更不能在對不上的時候自作主張生一顆新的。
- *   安裝器照名字找、找不到就建一顆空的綁上去，使用者的工作流與登入狀態整片消失。
+ *   ——所以修法不是「多比對幾種名字」，是**不再用名字當識別**。
- *   規則搬到共用層之後，安裝器直接 import 同一份原稿，**不再有第二種答案**。
  *
- * 🔴 不要把任何判斷寫回這個檔案。要改規則 → 改 `shared/resource-rule/rule.mjs`。
+ * ── 新規則（三句話）────────────────────────────────────────────────
+ *   1. **已部署的 worker 上綁著什麼，那就是事實** → 原封不動沿用，不管那顆資源叫什麼名字。
+ *   2. **只有「確定沒有任何人綁過它」才准新建**（新版本新增的 binding、或真的全新帳號）。
+ *   3. **只要有一點說不準就整趟停手**（讀不到綁定／綁著的資源不見了／同一個 binding 指向兩顆／
+ *      該更新的 worker 一顆都不在），**什麼都不建、什麼都不部署**，把話說清楚讓人來判斷。
+ *
+ * ── 為什麼拆成 plan / apply 兩段 ─────────────────────────────────────
+ *   `planResources()` **完全不寫入**，只回一份「要沿用什麼、要新建什麼、有什麼不敢動的」。
+ *   `applyResourcePlan()` 看到有任何 blocker 就直接拒絕執行。
+ *   ⇒「被擋下的時候一顆資源都不會被建出來」是**結構上的保證**，
+ *     不是靠某個人記得在對的地方寫 early return。#97 正是死在「先動手、後判斷」。
  */
 
-export {
+/** 這支負責的資源種類。要加新種類（R2/Queue/Hyperdrive…）就加在這裡，
-  planResources,
+ *  一律走同一道門——不准任何呼叫端自己「照名字 ensure」繞過去。 */
-  applyResourcePlan,
+export type ResourceKind = 'kv_namespace' | 'd1' | 'vectorize';
-  parseWranglerRequirements,
-  normalizeLiveBindings,
-  normalizeLiveVars,
-  bindingKey,
-  ResourcePlanBlocked,
-  KIND_LABEL,
-  TABLE_KIND,
-} from './resource-rule/rule.mjs';
 
-export type {
+/** 從已部署 worker 上讀回來的一條綁定。`value`：KV/D1 是資源 id，Vectorize 是 index 名。 */
-  ResourceKind,
+export interface LiveBinding {
-  LiveBinding,
+  kind: ResourceKind;
-  ScriptBindings,
+  binding: string;
-  ResourceApi,
+  value: string;
-  BindingRequirement,
+}
-  PlannedAdopt,
+
-  PlannedCreate,
+export interface ScriptBindings {
-  ResourcePlan,
+  /** false = 這顆 worker 在帳號上還不存在（全新部署），不是「讀取失敗」。讀取失敗要 throw。 */
-  ResolvedResource,
+  deployed: boolean;
-  WranglerRequirements,
+  bindings: LiveBinding[];
-  RawWorkerBinding,
+  /**
-} from './resource-rule/rule.mjs';
+   * 這顆 worker 現在掛著的 `plain_text` var（名 → 值）。
+   *
+   * 🔴 Arcrun#106：#97 只把「資源類」綁定當成事實沿用（KV/D1/Vectorize），
+   *   plain_text var 整批沒人管 ⇒ 重部署把它們洗成 repo toml 的預設值。
+   *   最痛的一個是 `ARCRUN_BUNDLE_VERSION`（安裝器注入的版本標籤）——
+   *   更新完就消失，Portal 設定頁變成「無法讀取目前版本」。
+   *   **保留了櫃子，沒保留櫃子上的標籤**。這個欄位就是那些標籤。
+   */
+  vars?: Record<string, string>;
+}
+
+/** resolver 需要的 CF 能力（收窄成介面，方便離線測試餵假帳號）。 */
+export interface ResourceApi {
+  getScriptBindings(script: string): Promise<ScriptBindings>;
+  /** title → id */
+  listKvNamespaces(): Promise<Map<string, string>>;
+  /** name → uuid */
+  listD1Databases(): Promise<Map<string, string>>;
+  listVectorizeIndexes(): Promise<string[]>;
+  createKvNamespace(title: string): Promise<string>;
+  createD1Database(name: string): Promise<string>;
+  createVectorizeIndex(name: string): Promise<string>;
+}
+
+/** 「這顆 worker 需要這個 binding」。createName 只在**真的要新建**時才會被拿來當名字用。 */
+export interface BindingRequirement {
+  kind: ResourceKind;
+  binding: string;
+  /** 需要它的 worker script 名（= wrangler.toml 的 `name`）。 */
+  worker: string;
+  createName: string;
+}
+
+export interface PlannedAdopt {
+  kind: ResourceKind;
+  binding: string;
+  value: string;
+  /** 從哪顆已部署的 worker 上讀到的 */
+  from: string;
+}
+
+export interface PlannedCreate {
+  kind: ResourceKind;
+  binding: string;
+  createName: string;
+  wantedBy: string[];
+  /** 其他也指向同一顆資源的 binding（見 shareSameResource）。建一顆，大家共用。 */
+  alsoBind: string[];
+}
+
+export interface ResourcePlan {
+  adopt: PlannedAdopt[];
+  create: PlannedCreate[];
+  /** 非空 = 整趟停手。applyResourcePlan 會拒絕執行。 */
+  blockers: string[];
+  /**
+   * 每顆**已部署** worker 現在掛著的 plain_text var（script → 名/值）。未部署的不在裡面。
+   *
+   * Arcrun#106：讀綁定的時候本來就把整份 `bindings[]` 拿回來了，var 就在同一份回應裡——
+   * 順手帶出來，**不另外打一次 API**，也不新增一種「查不到」的失敗模式
+   * （讀不到綁定這件事已經在上面 blockers 那一關擋掉了）。
+   */
+  liveVars: Map<string, Record<string, string>>;
+}
+
+export interface ResolvedResource {
+  kind: ResourceKind;
+  binding: string;
+  value: string;
+  origin: 'adopted' | 'created';
+  from?: string;
+}
+
+/** plan 被擋下時丟這個，讓呼叫端能把每一條原因原文轉給使用者。 */
+export class ResourcePlanBlocked extends Error {
+  constructor(readonly blockers: string[]) {
+    super(`資源解析被擋下（${blockers.length} 項）`);
+    this.name = 'ResourcePlanBlocked';
+  }
+}
+
+export function bindingKey(kind: ResourceKind, binding: string): string {
+  return `${kind}:${binding}`;
+}
+
+const KIND_LABEL: Record<ResourceKind, string> = {
+  kv_namespace: 'KV namespace',
+  d1: 'D1 資料庫',
+  vectorize: 'Vectorize index',
+};
+
+function msg(e: unknown): string {
+  return e instanceof Error ? e.message : String(e);
+}
+
+/**
+ * 決定每個 binding 要沿用哪顆資源／要不要新建，**不寫入任何東西**。
+ *
+ * @param mode 'update' = 這台照定義已經裝過了（見下方「一顆都不在」規則）；'init' = 全新安裝，允許從零建。
+ */
+export async function planResources(
+  api: ResourceApi,
+  requirements: readonly BindingRequirement[],
+  mode: 'update' | 'init',
+): Promise<ResourcePlan> {
+  const blockers: string[] = [];
+  const adopt: PlannedAdopt[] = [];
+  const create: PlannedCreate[] = [];
+
+  // ── 1. 先讀「即將被覆蓋的每一顆 worker」現在綁著什麼 ──────────────────
+  // 讀取失敗 ≠ 沒有綁。#97 的災情就是把「我查不到」當成「它不存在」。
+  const scripts = [...new Set(requirements.map((r) => r.worker))].sort();
+  const live = new Map<string, LiveBinding[]>();
+  const liveVars = new Map<string, Record<string, string>>();
+  let readFailed = false;
+  for (const script of scripts) {
+    try {
+      const res = await api.getScriptBindings(script);
+      if (res.deployed) {
+        live.set(script, res.bindings);
+        // #106：同一份回應裡的 plain_text var 一起收下（呼叫端要拿它決定哪些 var 該沿用）。
+        liveVars.set(script, res.vars ?? {});
+      }
+    } catch (e) {
+      readFailed = true;
+      blockers.push(
+        `讀不到已部署的 worker「${script}」目前綁著哪些資源（${msg(e)}）。` +
+          `不確定它現在用的是哪一顆，就不能重新綁——整趟更新停手，沒有動任何東西。`,
+      );
+    }
+  }
+
+  // 「這台照定義已經裝過了，卻一顆 worker 都找不到」= 我對不上它的實例（名字不同／token 看不到）。
+  // 這種時候繼續走下去，等於把一整套資源重新生一遍再綁上去——正是 #97 的形狀，只是換一道門進來。
+  if (mode === 'update' && !readFailed && live.size === 0 && scripts.length > 0) {
+    blockers.push(
+      `在這個 Cloudflare 帳號上找不到任何一顆要更新的 worker（找過：${scripts.join('、')}）。` +
+        `acr update 的前提是「這台已經裝好了」——對不上就不猜：` +
+        `可能是 API token 看得到的帳號不對，或這台實例的 worker 用了別的名字。` +
+        `已停手，沒有新建任何資源。`,
+    );
+  }
+
+  // ── 2. 逐個 binding 決定：沿用 / 新建 / 停手 ─────────────────────────
+  const byKey = new Map<string, BindingRequirement[]>();
+  for (const req of requirements) {
+    const key = bindingKey(req.kind, req.binding);
+    const list = byKey.get(key);
+    if (list) list.push(req);
+    else byKey.set(key, [req]);
+  }
+
+  const existingCache = new Map<ResourceKind, Set<string>>();
+  const listExisting = async (kind: ResourceKind): Promise<Set<string>> => {
+    const hit = existingCache.get(kind);
+    if (hit) return hit;
+    let set: Set<string>;
+    if (kind === 'kv_namespace') set = new Set((await api.listKvNamespaces()).values());
+    else if (kind === 'd1') set = new Set((await api.listD1Databases()).values());
+    else set = new Set(await api.listVectorizeIndexes());
+    existingCache.set(kind, set);
+    return set;
+  };
+
+  for (const [, reqs] of byKey) {
+    const { kind, binding } = reqs[0];
+
+    const found: Array<{ value: string; script: string }> = [];
+    for (const [script, bindings] of live) {
+      const hit = bindings.find((b) => b.kind === kind && b.binding === binding);
+      if (hit) found.push({ value: hit.value, script });
+    }
+    const distinct = [...new Set(found.map((f) => f.value))];
+
+    // 2a. 同一個 binding 名在不同 worker 上指向不同資源 → 分不出哪個才是使用者要的。
+    //     自己挑一個 = 有一半機率把另外那半的資料從畫面上抹掉。不猜。
+    if (distinct.length > 1) {
+      blockers.push(
+        `綁定「${binding}」在不同 worker 上指向不同的 ${KIND_LABEL[kind]}` +
+          `（${found.map((f) => `${f.script} → ${f.value}`).join('、')}）。` +
+          `分不出哪一顆才是你在用的，不猜——停手。`,
+      );
+      continue;
+    }
+
+    // 2b. 有人綁著它 → 這就是事實，沿用。名字長什麼樣完全不看。
+    if (distinct.length === 1) {
+      const value = distinct[0];
+      let existing: Set<string>;
+      try {
+        existing = await listExisting(kind);
+      } catch (e) {
+        blockers.push(
+          `查不到帳號上的 ${KIND_LABEL[kind]} 清單，無法確認「${binding}」綁著的 ${value} 還在不在` +
+            `（${msg(e)}）。不確定就不動——停手。`,
+        );
+        continue;
+      }
+      if (!existing.has(value)) {
+        // 這正是 #97 的入口：舊版在這裡會安靜地新建一顆空的頂上去。
+        blockers.push(
+          `worker「${found[0].script}」的「${binding}」綁著 ${KIND_LABEL[kind]} ${value}，` +
+            `但這顆在你的 Cloudflare 帳號上找不到了。` +
+            `這裡**不會**幫你新建一顆空的頂上去（Arcrun#97 的災情就是那樣來的）——` +
+            `請先確認那顆資源是被刪掉了，還是這把 API token 看不到它。`,
+        );
+        continue;
+      }
+      adopt.push({ kind, binding, value, from: found[0].script });
+      continue;
+    }
+
+    // 2c. 沒有任何已部署的 worker 綁過它 → 新版本新增的 binding，或全新帳號。
+    //     這種情況下新建不會弄丟任何東西（本來就沒有東西可丟）。
+    create.push({
+      kind,
+      binding,
+      createName: reqs[0].createName,
+      wantedBy: [...new Set(reqs.map((r) => r.worker))],
+      alsoBind: [],
+    });
+  }
+
+  return { adopt, create: shareSameResource(adopt, create, byKey), blockers, liveVars };
+}
+
+/**
+ * 收斂「不同 binding 其實是同一顆資源」的情況。
+ *
+ * 判準是 **toml 自己宣告的名字**（`database_name` / `index_name`），不是使用者那側的資源名——
+ * cypher 的 `CREDENTIALS_DB` 與 kbdb 的 `DB` 都寫 `database_name = "arcrun-kbdb"`，
+ * 那是**我們**在宣告「這兩個綁定指向同一顆庫」，跟 #97 那種「拿名字去猜使用者的資源」是兩回事。
+ *
+ * 沒有這一步會出兩種錯：
+ *   ① 全新安裝時建出兩顆同名 D1，KBDB 的資料與 credential 目錄從此分家。
+ *   ② 一邊已部署（沿用既有）、另一邊沒有（新建一顆空的）→ 半套資料，比全壞更難查。
+ */
+function shareSameResource(
+  adopt: PlannedAdopt[],
+  create: PlannedCreate[],
+  byKey: Map<string, BindingRequirement[]>,
+): PlannedCreate[] {
+  const declaredName = (kind: ResourceKind, binding: string): string | undefined =>
+    byKey.get(bindingKey(kind, binding))?.[0]?.createName;
+
+  const out: PlannedCreate[] = [];
+  const groups = new Map<string, PlannedCreate>();
+
+  for (const c of create) {
+    const groupKey = `${c.kind}${c.createName}`;
+
+    // ① 已經有 binding 沿用到同一顆（依 toml 宣告）→ 跟著沿用，不要另外建一顆。
+    const twin = adopt.find(
+      (a) => a.kind === c.kind && declaredName(a.kind, a.binding) === c.createName,
+    );
+    if (twin) {
+      adopt.push({ kind: c.kind, binding: c.binding, value: twin.value, from: twin.from });
+      continue;
+    }
+
+    // ② 同一趟裡有多個 binding 要建同一顆 → 建一次，其他人共用。
+    const head = groups.get(groupKey);
+    if (head) {
+      head.alsoBind.push(c.binding);
+      head.wantedBy = [...new Set([...head.wantedBy, ...c.wantedBy])];
+      continue;
+    }
+    groups.set(groupKey, c);
+    out.push(c);
+  }
+  return out;
+}
+
+/**
+ * 照 plan 動手：沿用的原樣帶出來，該建的才建。
+ * 有任何 blocker 直接丟 ResourcePlanBlocked，**一顆都不建**。
+ */
+export async function applyResourcePlan(
+  api: ResourceApi,
+  plan: ResourcePlan,
+): Promise<Map<string, ResolvedResource>> {
+  if (plan.blockers.length > 0) throw new ResourcePlanBlocked(plan.blockers);
+
+  const out = new Map<string, ResolvedResource>();
+  for (const a of plan.adopt) {
+    out.set(bindingKey(a.kind, a.binding), {
+      kind: a.kind,
+      binding: a.binding,
+      value: a.value,
+      origin: 'adopted',
+      from: a.from,
+    });
+  }
+  const madeSoFar: string[] = [];
+  for (const c of plan.create) {
+    let value: string;
+    try {
+      if (c.kind === 'kv_namespace') value = await api.createKvNamespace(c.createName);
+      else if (c.kind === 'd1') value = await api.createD1Database(c.createName);
+      else value = await api.createVectorizeIndex(c.createName);
+    } catch (e) {
+      // 半途失敗：已經建出來的那幾顆還沒被綁到任何 worker 上。**要講出來**——
+      // 不講的話它們就是帳號上一批沒人認得的孤兒，而且下次重跑會再建一批。
+      const orphans = madeSoFar.length > 0
+        ? `\n  已經建好但還沒綁上任何 worker 的：${madeSoFar.join('、')}（重跑前可先刪掉，或留著讓下次沿用）`
+        : '';
+      throw new Error(`建 ${KIND_LABEL[c.kind]}「${c.createName}」失敗：${msg(e)}${orphans}`);
+    }
+    madeSoFar.push(`${KIND_LABEL[c.kind]} ${c.createName}`);
+    for (const binding of [c.binding, ...c.alsoBind]) {
+      out.set(bindingKey(c.kind, binding), { kind: c.kind, binding, value, origin: 'created' });
+    }
+  }
+  return out;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// wrangler.toml → 需求清單
+// ─────────────────────────────────────────────────────────────────────────────
+
+export interface WranglerRequirements {
+  /** worker script 名（toml 頂層 `name`）。空字串 = 這份 toml 沒宣告 name（不該發生）。 */
+  script: string;
+  bindings: Array<{ kind: ResourceKind; binding: string; createName: string }>;
+}
+
+/** wrangler.toml 的 table 名 → 資源種類。需求解析與注入共用同一張表，兩邊才不會對不上。 */
+export const TABLE_KIND: Record<string, ResourceKind> = {
+  kv_namespaces: 'kv_namespace',
+  d1_databases: 'd1',
+  vectorize: 'vectorize',
+};
+
+/**
+ * 從 wrangler.toml 抽出「這顆 worker 需要哪些資源綁定」。
+ *
+ * 刻意寫成行掃描而不引 TOML parser：注入端（injectWranglerConfig）本來就是純文字操作，
+ * 兩邊用同一種視角看這份檔案才不會對不上。註解掉的區塊**不算需求**
+ * （kbdb 的 `[[vectorize]]` 預設是註解狀態，要開語義查詢時才會被取消註解 → 那時才成為需求）。
+ */
+export function parseWranglerRequirements(toml: string): WranglerRequirements {
+  let script = '';
+  let seenTable = false;
+  const bindings: WranglerRequirements['bindings'] = [];
+
+  let kind: ResourceKind | null = null;
+  let binding = '';
+  let createName = '';
+
+  const flush = (): void => {
+    if (kind && binding) {
+      bindings.push({ kind, binding, createName: createName || binding });
+    }
+    kind = null;
+    binding = '';
+    createName = '';
+  };
+
+  for (const raw of toml.split('\n')) {
+    const line = raw.trim();
+    if (line === '' || line.startsWith('#')) continue;
+
+    const table = line.match(/^\[\[?([A-Za-z0-9_]+)\]?\]$/);
+    if (table) {
+      flush();
+      seenTable = true;
+      kind = TABLE_KIND[table[1]] ?? null;
+      continue;
+    }
+
+    const kv = line.match(/^([A-Za-z0-9_]+)\s*=\s*"([^"]*)"/);
+    if (!kv) continue;
+    const [, key, value] = kv;
+
+    if (!seenTable && key === 'name') {
+      script = value;
+      continue;
+    }
+    if (!kind) continue;
+    if (key === 'binding') binding = value;
+    // 只有 D1／Vectorize 在 toml 裡帶得出「名字」；KV 沒有，退回用 binding 名（見 flush）。
+    else if (key === 'database_name' || key === 'index_name') createName = value;
+  }
+  flush();
+
+  return { script, bindings };
+}

cli/src/lib/resource-rule/cf-resource-api.mjs

@@ -1,202 +0,0 @@
-// @ts-check
-/**
- * cf-resource-api.mjs — 規則的**眼睛與手**：對 Cloudflare 帳號的那七個動作，也只有一份。
- *
- * `rule.mjs` 是純判斷，IO 由呼叫端注入（`ResourceApi`）。本檔就是那個注入物的正貨：
- * 用 CF REST API 實作 `ResourceApi`，零依賴、只用 global `fetch`
- * ⇒ Node 18+ 與 Cloudflare Workers runtime 都能直接跑。
- *
- * 【為什麼連這層也要共用】
- * 判斷一致還不夠——**看到的東西**也要一致。
- * 「已部署的 worker 綁著什麼」是從 `GET /workers/scripts/{script}/settings` 讀來的；
- * 如果兩條路各自寫一份 client，隨便一個差異（打錯端點、把 404 當錯誤、漏了 per_page、
- * 少認一種欄位名）都會讓其中一條路「看不到既有綁定」——而看不到既有綁定的下一步，
- * 依規則就是**新建**。Arcrun#97 的災情不需要規則寫錯，只要眼睛不一樣就會重演。
- *
- * 這裡**故意只有 `ResourceApi` 那七個方法**。verifyAccess / 查 subdomain / KV 讀寫
- * 這些跟「該用哪些資源」無關的帳號操作留在各自的呼叫端，不往共用層堆。
- *
- * 🔴 除了同目錄的 `./rule.mjs`，這支不准 import 任何東西——共用層的價值在於
- *    「整個目錄複製到哪個 runtime 都能直接跑」，多一個外部依賴就少一條路吃得到。
- */
-
-import { normalizeLiveBindings, normalizeLiveVars } from './rule.mjs';
-
-const CF_API_BASE = 'https://api.cloudflare.com/client/v4';
-
-/**
- * @typedef {import('./rule.mjs').ResourceApi} ResourceApi
- * @typedef {import('./rule.mjs').ScriptBindings} ScriptBindings
- * @typedef {import('./rule.mjs').RawWorkerBinding} RawWorkerBinding
- */
-
-/**
- * @typedef {object} CfResourceApiOptions
- * @property {string} accountId
- * @property {string} apiToken
- * @property {typeof globalThis.fetch} [fetch]
- *   注入用（離線測試餵假帳號、或宿主要用自己的 fetch）。預設 global fetch。
- */
-
-/**
- * 建一個打真實 Cloudflare 的 `ResourceApi`。
- *
- * @param {CfResourceApiOptions} options
- * @returns {ResourceApi & { cfRaw: (path: string, init?: RequestInit) => Promise<{ok: boolean, status: number, result?: any, error?: string}> }}
- */
-export function createCloudflareResourceApi({ accountId, apiToken, fetch: fetchImpl }) {
-  const doFetch = fetchImpl ?? globalThis.fetch;
-  if (typeof doFetch !== 'function') {
-    throw new Error('createCloudflareResourceApi：這個執行環境沒有 fetch，請用 options.fetch 注入。');
-  }
-  const accountBase = `${CF_API_BASE}/accounts/${accountId}`;
-  const headers = {
-    Authorization: `Bearer ${apiToken}`,
-    'Content-Type': 'application/json',
-  };
-
-  /**
-   * 把 HTTP status 交回呼叫端自己判斷（要區分「404 不存在」和「其他錯誤」時用）。
-   * @param {string} path
-   * @param {RequestInit} [init]
-   * @returns {Promise<{ok: boolean, status: number, result?: any, error?: string}>}
-   */
-  async function cfRaw(path, init) {
-    const res = await doFetch(`${accountBase}${path}`, {
-      ...init,
-      headers: { ...headers, ...(init?.headers ?? {}) },
-    });
-    const data = await res.json().catch(() => null);
-    if (!res.ok || !data?.success) {
-      return {
-        ok: false,
-        status: res.status,
-        error:
-          (data?.errors ?? []).map((/** @type {{message?: string}} */ e) => e.message).filter(Boolean).join('; ') ||
-          `HTTP ${res.status}`,
-      };
-    }
-    return { ok: true, status: res.status, result: data.result };
-  }
-
-  /**
-   * @param {string} path
-   * @param {RequestInit} [init]
-   * @returns {Promise<any>}
-   */
-  async function cf(path, init) {
-    const { ok, status, result, error } = await cfRaw(path, init);
-    if (!ok) throw new Error(`CF API ${path} 失敗：${error ?? `HTTP ${status}`}`);
-    return result;
-  }
-
-  return {
-    cfRaw,
-
-    /**
-     * 讀一顆已部署 worker 現在綁著哪些資源——**使用者那側的事實**（Arcrun#97 的唯一真相源）。
-     *
-     * - script 不存在（404）→ `{ deployed: false }`，這是「還沒部署」，不是錯誤。
-     * - 其他任何失敗 → throw。呼叫端必須把它當「我不知道」而**不是**「它沒有」——
-     *   把查不到當成不存在，就是 #97 的根因。
-     *
-     * @param {string} script
-     * @returns {Promise<ScriptBindings>}
-     */
-    async getScriptBindings(script) {
-      const path = `/workers/scripts/${encodeURIComponent(script)}/settings`;
-      const res = await cfRaw(path);
-      if (!res.ok) {
-        if (res.status === 404) return { deployed: false, bindings: [], vars: {} };
-        throw new Error(`讀 ${script} 綁定失敗：${res.error}`);
-      }
-      /** @type {RawWorkerBinding[]} */
-      const raw = res.result?.bindings ?? [];
-      return {
-        deployed: true,
-        bindings: normalizeLiveBindings(raw),
-        vars: normalizeLiveVars(raw),
-      };
-    },
-
-    /** @returns {Promise<Map<string, string>>} title → id */
-    async listKvNamespaces() {
-      /** @type {Array<{id: string, title: string}>} */
-      const result = await cf('/storage/kv/namespaces?per_page=100');
-      const map = new Map();
-      for (const ns of result) map.set(ns.title, ns.id);
-      return map;
-    },
-
-    /** @returns {Promise<Map<string, string>>} name → uuid */
-    async listD1Databases() {
-      /** @type {Array<{uuid: string, name: string}>} */
-      const result = await cf('/d1/database?per_page=100');
-      const map = new Map();
-      for (const db of result) map.set(db.name, db.uuid);
-      return map;
-    },
-
-    /** @returns {Promise<string[]>} */
-    async listVectorizeIndexes() {
-      /** @type {Array<{name: string}>} */
-      const result = await cf('/vectorize/v2/indexes');
-      return (result ?? []).map((i) => i.name);
-    },
-
-    /**
-     * 無條件新建一顆 KV namespace。
-     *
-     * 🔴 Arcrun#97：這裡**故意沒有**「找不到同名就順手建一顆」的 ensure 版本。
-     * 「照名字找 → 找不到 → 新建 → 綁上去」正是把使用者實例洗成空的那條路
-     * （安裝器取的名字跟 binding 名不一樣，永遠對不上 ⇒ 每次更新都新建）。
-     * 要不要建一律先過 `planResources`。
-     *
-     * @param {string} title
-     * @returns {Promise<string>}
-     */
-    async createKvNamespace(title) {
-      const result = await cf('/storage/kv/namespaces', {
-        method: 'POST',
-        body: JSON.stringify({ title }),
-      });
-      return result.id;
-    },
-
-    /**
-     * 無條件新建 D1。沒有 ensure 版本，理由同 createKvNamespace（Arcrun#97）。
-     * @param {string} name
-     * @returns {Promise<string>}
-     */
-    async createD1Database(name) {
-      const result = await cf('/d1/database', {
-        method: 'POST',
-        body: JSON.stringify({ name }),
-      });
-      return result.uuid;
-    },
-
-    /**
-     * 新建 KBDB embed 用的 Vectorize index（**bge-m3 = 1024 維 / cosine**）。
-     * 已存在（409 / already exists）視為成功——並行或重跑不該炸。
-     * 沒有 ensure 版本：「要不要建」由 planResources 判斷，這裡只負責建（Arcrun#97）。
-     *
-     * @param {string} name
-     * @returns {Promise<string>}
-     */
-    async createVectorizeIndex(name) {
-      const res = await cfRaw('/vectorize/v2/indexes', {
-        method: 'POST',
-        body: JSON.stringify({
-          name,
-          config: { dimensions: 1024, metric: 'cosine' },
-          description: 'arcrun KBDB embed module — bge-m3 1024d (issue #7 / #59)',
-        }),
-      });
-      if (res.ok) return name;
-      const detail = (res.error ?? '').toLowerCase();
-      if (res.status === 409 || /already exists|duplicate|conflict/.test(detail)) return name;
-      throw new Error(`建 Vectorize index ${name} 失敗：${res.error}`);
-    },
-  };
-}

cli/src/lib/resource-rule/installer-entry.mjs

@@ -1,100 +0,0 @@
-// @ts-check
-/**
- * installer-entry.mjs — 安裝器那條路的**唯一入口**。
- *
- * 安裝器（arcrun-rag `installer/oauth-prototype/worker.js`）不必、也不准自己判斷
- * 「該建哪些資源」——它只要呼叫這一支，拿回「每個 binding 該用哪顆資源」。
- *
- * ```js
- * import { resolveInstanceResources } from './shared/resource-rule/installer-entry.mjs';
- *
- * const r = await resolveInstanceResources({
- *   accountId, apiToken,
- *   wranglerTomls: [cypherToml, registryToml, mcpToml, kbdbToml],  // 字串陣列
- *   mode: isUpdate ? 'update' : 'init',
- * });
- * if (r.blocked) {
- *   // 🔴 一顆資源都沒被建。把 r.blockers 原文顯示給使用者，**不要自己「試著繼續」**。
- *   return showAndStop(r.blockers);
- * }
- * // r.bindings: { 'kv_namespace:WEBHOOKS': 'kvid-…', 'd1:DB': 'uuid-…', … }
- * // r.liveVars: { 'arcrun-cypher-executor': { ARCRUN_BUNDLE_VERSION: '1.4.33', … } }
- * ```
- *
- * 為什麼安裝器不需要副本：安裝器本來就會下載本 repo 的 archive 當部署來源
- * （見 `.claude/rules/05-deploy-convention.md`「WASM 來源」），
- * `shared/resource-rule/` 就在那份 archive 裡，直接 import 即可——
- * **不必再編一次、不必貼一份、也就不會有第二種答案。**
- */
-
-import { planResources, applyResourcePlan, parseWranglerRequirements, ResourcePlanBlocked } from './rule.mjs';
-import { createCloudflareResourceApi } from './cf-resource-api.mjs';
-
-/**
- * @typedef {object} ResolveOptions
- * @property {string} accountId
- * @property {string} apiToken
- * @property {string[]} wranglerTomls  各 worker 的 wrangler.toml **內容**（不是路徑）。
- * @property {'update' | 'init'} mode  這台照定義裝過了沒。
- * @property {typeof globalThis.fetch} [fetch]  注入用（測試／宿主自帶 fetch）。
- */
-
-/**
- * @typedef {object} ResolveResult
- * @property {boolean} blocked            true = 什麼都沒建、什麼都不該部署。
- * @property {string[]} blockers          blocked 時的原因原文（要原樣轉給使用者）。
- * @property {Record<string, string>} bindings   `${kind}:${binding}` → 資源 id／index 名。
- * @property {Record<string, 'adopted'|'created'>} origin  同上 key → 這顆是沿用還是新建。
- * @property {Record<string, Record<string, string>>} liveVars  script → 現有 plain_text var（#106）。
- */
-
-/**
- * 決定這台實例每個 binding 該用哪顆資源；照規則沿用既有、只在確定沒人綁過時才新建。
- *
- * @param {ResolveOptions} options
- * @returns {Promise<ResolveResult>}
- */
-export async function resolveInstanceResources({ accountId, apiToken, wranglerTomls, mode, fetch }) {
-  const api = createCloudflareResourceApi({ accountId, apiToken, fetch });
-
-  /** @type {import('./rule.mjs').BindingRequirement[]} */
-  const requirements = [];
-  for (const toml of wranglerTomls) {
-    const parsed = parseWranglerRequirements(toml);
-    if (!parsed.script) continue;  // 沒宣告 name 的 toml 不該存在；跳過而非亂猜
-    for (const b of parsed.bindings) requirements.push({ ...b, worker: parsed.script });
-  }
-
-  /** @param {string[]} blockers @returns {ResolveResult} */
-  const stop = (blockers) => ({ blocked: true, blockers, bindings: {}, origin: {}, liveVars: {} });
-
-  if (requirements.length === 0) {
-    return stop(['這批 wrangler.toml 裡讀不到任何資源綁定需求——不確定要裝什麼，停手。']);
-  }
-
-  let plan;
-  try {
-    plan = await planResources(api, requirements, mode);
-  } catch (e) {
-    return stop([`資源解析失敗（${e instanceof Error ? e.message : String(e)}）。沒有建立任何資源。`]);
-  }
-  if (plan.blockers.length > 0) return stop(plan.blockers);
-
-  /** @type {Map<string, import('./rule.mjs').ResolvedResource>} */
-  let resolved;
-  try {
-    resolved = await applyResourcePlan(api, plan);
-  } catch (e) {
-    return stop(e instanceof ResourcePlanBlocked ? e.blockers : [e instanceof Error ? e.message : String(e)]);
-  }
-
-  /** @type {Record<string, string>} */
-  const bindings = {};
-  /** @type {Record<string, 'adopted'|'created'>} */
-  const origin = {};
-  for (const [key, r] of resolved) {
-    bindings[key] = r.value;
-    origin[key] = r.origin;
-  }
-  return { blocked: false, blockers: [], bindings, origin, liveVars: Object.fromEntries(plan.liveVars) };
-}

cli/src/lib/resource-rule/rule.mjs

@@ -1,570 +0,0 @@
-// @ts-check
-/**
- * rule.mjs — 「這個實例該用哪些資源」的**唯一一份**規則。
- *
- * ─────────────────────────────────────────────────────────────────────────────
- * 這份檔案為什麼在這裡（`shared/`），不在 `cli/`
- * ─────────────────────────────────────────────────────────────────────────────
- * leo 2026-08-12：「根本就不應該在 CLI，我要的是一個大家都可以用到的規則。」
- *
- * `.claude/rules/07-thin-shell.md` 的判準口訣：
- *   「這段邏輯換一個介面要不要重寫？」要重寫 → 它是能力，該在共用層。
- *
- * 「該沿用哪幾顆資源」換到安裝器就得重寫一次 ⇒ 它是**能力**，不是薄殼的事。
- * 而它原本住在 `cli/src/lib/resource-resolver.ts` ⇒ 那本身就是違規，
- * 後果也真的發生了：`acr` 那條有這條規則、安裝器那條沒有，於是安裝器照名字找、
- * 找不到就建新的空的 ⇒ Arcrun#97「我按了更新，工作流和登入全不見了」。
- *
- * ── 為什麼不是 cypher-executor 的 API 端點（薄殼原則的標準答案）────────────
- * **自舉**：這條規則要在「決定怎麼裝／怎麼更新」的當下就用得到，而那個當下
- * cypher 可能還不存在（安裝器的工作正是把它生出來），或正要被覆蓋。
- * 而且判斷的輸入是**使用者自己 Cloudflare 帳號上的綁定狀態**——
- * 把它送去一顆平台託管的 worker 換一個答案，等於①讓「能不能安裝」綁在平台是否活著，
- * ②把使用者的帳號拓撲交給第三方。兩件都不該為了形式上的漂亮而做。
- *
- * 薄殼原則要求的是「能力只實作一次」，不是「能力一定要是 HTTP」。
- * 這條規則是**純函式**（唯一的 IO 由呼叫端注入 `ResourceApi`），
- * 所以它用不著變成服務——一份零依賴的 ESM 就能讓每條路吃到同一份判斷。
- *
- * ── 怎麼讓兩條路吃到「同一份」而不是各留一份 ───────────────────────────────
- * 本檔是**唯一被人手維護的實作**，零依賴、不吃任何 node 內建、Workers runtime 可直接跑。
- *   · `acr`：`cli/src/lib/resource-rule.mjs` 是本檔的**逐位元組副本**，
- *     由 `scripts/sync-resource-rule.mjs` 產生（CLI 要能單獨 npm publish，
- *     套件目錄外的檔案打不進 tarball，故必須有這一份）。
- *     `npm run build` / `npm test` 都會跑 `--check`，內容一漂就紅。
- *     ——同 `cli/harness/`（產生物＋世代閘）的既有慣例。
- *   · 安裝器 / 任何 Worker：安裝器本來就會下載本 repo 的 archive（部署來源，
- *     見 `.claude/rules/05-deploy-convention.md`「WASM 來源」），
- *     直接 import 這一份 `shared/resource-rule/rule.mjs` 即可，**不需要再編一次、也不留副本**。
- *     用法見同目錄 README.md。
- *
- * ─────────────────────────────────────────────────────────────────────────────
- * 規則本身（leo 的兩句話）
- * ─────────────────────────────────────────────────────────────────────────────
- * 「如果你沒有裝，就是新的；如果你已經有，原來叫什麼名字就繼續用下去。」
- *
- * 判準是「**這顆 worker 現在綁著誰**」，不是「有沒有叫這個名字的資源」：
- *   1. **已部署的 worker 上綁著什麼，那就是事實** → 原封不動沿用，不管那顆資源叫什麼名字。
- *   2. **只有「確定沒有任何人綁過它」才准新建**（新版本新增的 binding、或真的全新帳號）。
- *   3. **只要有一點說不準就整趟停手**（讀不到綁定／綁著的資源不見了／同一個 binding 指向兩顆／
- *      該更新的 worker 一顆都不在），**什麼都不建、什麼都不部署**，把話說清楚讓人來判斷。
- *
- * ── 為什麼拆成 plan / apply 兩段 ─────────────────────────────────────
- *   `planResources()` **完全不寫入**，只回一份「要沿用什麼、要新建什麼、有什麼不敢動的」。
- *   `applyResourcePlan()` 看到有任何 blocker 就直接拒絕執行。
- *   ⇒「被擋下的時候一顆資源都不會被建出來」是**結構上的保證**，
- *     不是靠某個人記得在對的地方寫 early return。#97 正是死在「先動手、後判斷」。
- *
- * 🔴 這份檔案沒有 import、也不准有。任何依賴都會讓某一條路吃不到它。
- */
-
-/**
- * 這支負責的資源種類。要加新種類（R2/Queue/Hyperdrive…）就加在這裡，
- * 一律走同一道門——不准任何呼叫端自己「照名字 ensure」繞過去。
- * @typedef {'kv_namespace' | 'd1' | 'vectorize'} ResourceKind
- */
-
-/**
- * 從已部署 worker 上讀回來的一條綁定。`value`：KV/D1 是資源 id，Vectorize 是 index 名。
- * @typedef {object} LiveBinding
- * @property {ResourceKind} kind
- * @property {string} binding
- * @property {string} value
- */
-
-/**
- * @typedef {object} ScriptBindings
- * @property {boolean} deployed
- *   false = 這顆 worker 在帳號上還不存在（全新部署），不是「讀取失敗」。讀取失敗要 throw。
- * @property {LiveBinding[]} bindings
- * @property {Record<string, string>} [vars]
- *   這顆 worker 現在掛著的 `plain_text` var（名 → 值）。
- *
- *   🔴 Arcrun#106：#97 只把「資源類」綁定當成事實沿用（KV/D1/Vectorize），
- *     plain_text var 整批沒人管 ⇒ 重部署把它們洗成 repo toml 的預設值。
- *     最痛的一個是 `ARCRUN_BUNDLE_VERSION`（安裝器注入的版本標籤）——
- *     更新完就消失，Portal 設定頁變成「無法讀取目前版本」。
- *     **保留了櫃子，沒保留櫃子上的標籤**。這個欄位就是那些標籤。
- */
-
-/**
- * 規則需要的 CF 能力（收窄成介面，方便離線測試餵假帳號，也讓安裝器用自己的 fetch 實作）。
- * @typedef {object} ResourceApi
- * @property {(script: string) => Promise<ScriptBindings>} getScriptBindings
- * @property {() => Promise<Map<string, string>>} listKvNamespaces  title → id
- * @property {() => Promise<Map<string, string>>} listD1Databases   name → uuid
- * @property {() => Promise<string[]>} listVectorizeIndexes
- * @property {(title: string) => Promise<string>} createKvNamespace
- * @property {(name: string) => Promise<string>} createD1Database
- * @property {(name: string) => Promise<string>} createVectorizeIndex
- */
-
-/**
- * 「這顆 worker 需要這個 binding」。createName 只在**真的要新建**時才會被拿來當名字用。
- * @typedef {object} BindingRequirement
- * @property {ResourceKind} kind
- * @property {string} binding
- * @property {string} worker  需要它的 worker script 名（= wrangler.toml 的 `name`）。
- * @property {string} createName
- */
-
-/**
- * @typedef {object} PlannedAdopt
- * @property {ResourceKind} kind
- * @property {string} binding
- * @property {string} value
- * @property {string} from  從哪顆已部署的 worker 上讀到的
- */
-
-/**
- * @typedef {object} PlannedCreate
- * @property {ResourceKind} kind
- * @property {string} binding
- * @property {string} createName
- * @property {string[]} wantedBy
- * @property {string[]} alsoBind  其他也指向同一顆資源的 binding（見 shareSameResource）。建一顆，大家共用。
- */
-
-/**
- * @typedef {object} ResourcePlan
- * @property {PlannedAdopt[]} adopt
- * @property {PlannedCreate[]} create
- * @property {string[]} blockers  非空 = 整趟停手。applyResourcePlan 會拒絕執行。
- * @property {Map<string, Record<string, string>>} liveVars
- *   每顆**已部署** worker 現在掛著的 plain_text var（script → 名/值）。未部署的不在裡面。
- *
- *   Arcrun#106：讀綁定的時候本來就把整份 `bindings[]` 拿回來了，var 就在同一份回應裡——
- *   順手帶出來，**不另外打一次 API**，也不新增一種「查不到」的失敗模式
- *   （讀不到綁定這件事已經在上面 blockers 那一關擋掉了）。
- */
-
-/**
- * @typedef {object} ResolvedResource
- * @property {ResourceKind} kind
- * @property {string} binding
- * @property {string} value
- * @property {'adopted' | 'created'} origin
- * @property {string} [from]
- */
-
-/**
- * @typedef {object} WranglerRequirements
- * @property {string} script  worker script 名（toml 頂層 `name`）。空字串 = 這份 toml 沒宣告 name（不該發生）。
- * @property {Array<{kind: ResourceKind, binding: string, createName: string}>} bindings
- */
-
-/** plan 被擋下時丟這個，讓呼叫端能把每一條原因原文轉給使用者。 */
-export class ResourcePlanBlocked extends Error {
-  /** @param {string[]} blockers */
-  constructor(blockers) {
-    super(`資源解析被擋下（${blockers.length} 項）`);
-    this.name = 'ResourcePlanBlocked';
-    /** @type {string[]} */
-    this.blockers = blockers;
-  }
-}
-
-/**
- * @param {ResourceKind} kind
- * @param {string} binding
- * @returns {string}
- */
-export function bindingKey(kind, binding) {
-  return `${kind}:${binding}`;
-}
-
-/** @type {Record<ResourceKind, string>} */
-export const KIND_LABEL = {
-  kv_namespace: 'KV namespace',
-  d1: 'D1 資料庫',
-  vectorize: 'Vectorize index',
-};
-
-/**
- * @param {unknown} e
- * @returns {string}
- */
-function msg(e) {
-  return e instanceof Error ? e.message : String(e);
-}
-
-/**
- * 決定每個 binding 要沿用哪顆資源／要不要新建，**不寫入任何東西**。
- *
- * @param {ResourceApi} api
- * @param {readonly BindingRequirement[]} requirements
- * @param {'update' | 'init'} mode
- *   'update' = 這台照定義已經裝過了（見下方「一顆都不在」規則）；'init' = 全新安裝，允許從零建。
- * @returns {Promise<ResourcePlan>}
- */
-export async function planResources(api, requirements, mode) {
-  /** @type {string[]} */
-  const blockers = [];
-  /** @type {PlannedAdopt[]} */
-  const adopt = [];
-  /** @type {PlannedCreate[]} */
-  const create = [];
-
-  // ── 1. 先讀「即將被覆蓋的每一顆 worker」現在綁著什麼 ──────────────────
-  // 讀取失敗 ≠ 沒有綁。#97 的災情就是把「我查不到」當成「它不存在」。
-  const scripts = [...new Set(requirements.map((r) => r.worker))].sort();
-  /** @type {Map<string, LiveBinding[]>} */
-  const live = new Map();
-  /** @type {Map<string, Record<string, string>>} */
-  const liveVars = new Map();
-  let readFailed = false;
-  for (const script of scripts) {
-    try {
-      const res = await api.getScriptBindings(script);
-      if (res.deployed) {
-        live.set(script, res.bindings);
-        // #106：同一份回應裡的 plain_text var 一起收下（呼叫端要拿它決定哪些 var 該沿用）。
-        liveVars.set(script, res.vars ?? {});
-      }
-    } catch (e) {
-      readFailed = true;
-      blockers.push(
-        `讀不到已部署的 worker「${script}」目前綁著哪些資源（${msg(e)}）。` +
-          `不確定它現在用的是哪一顆，就不能重新綁——整趟更新停手，沒有動任何東西。`,
-      );
-    }
-  }
-
-  // 「這台照定義已經裝過了，卻一顆 worker 都找不到」= 我對不上它的實例（名字不同／token 看不到）。
-  // 這種時候繼續走下去，等於把一整套資源重新生一遍再綁上去——正是 #97 的形狀，只是換一道門進來。
-  if (mode === 'update' && !readFailed && live.size === 0 && scripts.length > 0) {
-    blockers.push(
-      `在這個 Cloudflare 帳號上找不到任何一顆要更新的 worker（找過：${scripts.join('、')}）。` +
-        `acr update 的前提是「這台已經裝好了」——對不上就不猜：` +
-        `可能是 API token 看得到的帳號不對，或這台實例的 worker 用了別的名字。` +
-        `已停手，沒有新建任何資源。`,
-    );
-  }
-
-  // ── 2. 逐個 binding 決定：沿用 / 新建 / 停手 ─────────────────────────
-  /** @type {Map<string, BindingRequirement[]>} */
-  const byKey = new Map();
-  for (const req of requirements) {
-    const key = bindingKey(req.kind, req.binding);
-    const list = byKey.get(key);
-    if (list) list.push(req);
-    else byKey.set(key, [req]);
-  }
-
-  /** @type {Map<ResourceKind, Set<string>>} */
-  const existingCache = new Map();
-  /** @param {ResourceKind} kind @returns {Promise<Set<string>>} */
-  const listExisting = async (kind) => {
-    const hit = existingCache.get(kind);
-    if (hit) return hit;
-    /** @type {Set<string>} */
-    let set;
-    if (kind === 'kv_namespace') set = new Set((await api.listKvNamespaces()).values());
-    else if (kind === 'd1') set = new Set((await api.listD1Databases()).values());
-    else set = new Set(await api.listVectorizeIndexes());
-    existingCache.set(kind, set);
-    return set;
-  };
-
-  for (const [, reqs] of byKey) {
-    const { kind, binding } = reqs[0];
-
-    /** @type {Array<{value: string, script: string}>} */
-    const found = [];
-    for (const [script, bindings] of live) {
-      const hit = bindings.find((b) => b.kind === kind && b.binding === binding);
-      if (hit) found.push({ value: hit.value, script });
-    }
-    const distinct = [...new Set(found.map((f) => f.value))];
-
-    // 2a. 同一個 binding 名在不同 worker 上指向不同資源 → 分不出哪個才是使用者要的。
-    //     自己挑一個 = 有一半機率把另外那半的資料從畫面上抹掉。不猜。
-    if (distinct.length > 1) {
-      blockers.push(
-        `綁定「${binding}」在不同 worker 上指向不同的 ${KIND_LABEL[kind]}` +
-          `（${found.map((f) => `${f.script} → ${f.value}`).join('、')}）。` +
-          `分不出哪一顆才是你在用的，不猜——停手。`,
-      );
-      continue;
-    }
-
-    // 2b. 有人綁著它 → 這就是事實，沿用。名字長什麼樣完全不看。
-    if (distinct.length === 1) {
-      const value = distinct[0];
-      /** @type {Set<string>} */
-      let existing;
-      try {
-        existing = await listExisting(kind);
-      } catch (e) {
-        blockers.push(
-          `查不到帳號上的 ${KIND_LABEL[kind]} 清單，無法確認「${binding}」綁著的 ${value} 還在不在` +
-            `（${msg(e)}）。不確定就不動——停手。`,
-        );
-        continue;
-      }
-      if (!existing.has(value)) {
-        // 這正是 #97 的入口：舊版在這裡會安靜地新建一顆空的頂上去。
-        blockers.push(
-          `worker「${found[0].script}」的「${binding}」綁著 ${KIND_LABEL[kind]} ${value}，` +
-            `但這顆在你的 Cloudflare 帳號上找不到了。` +
-            `這裡**不會**幫你新建一顆空的頂上去（Arcrun#97 的災情就是那樣來的）——` +
-            `請先確認那顆資源是被刪掉了，還是這把 API token 看不到它。`,
-        );
-        continue;
-      }
-      adopt.push({ kind, binding, value, from: found[0].script });
-      continue;
-    }
-
-    // 2c. 沒有任何已部署的 worker 綁過它 → 新版本新增的 binding，或全新帳號。
-    //     這種情況下新建不會弄丟任何東西（本來就沒有東西可丟）。
-    create.push({
-      kind,
-      binding,
-      createName: reqs[0].createName,
-      wantedBy: [...new Set(reqs.map((r) => r.worker))],
-      alsoBind: [],
-    });
-  }
-
-  return { adopt, create: shareSameResource(adopt, create, byKey), blockers, liveVars };
-}
-
-/**
- * 收斂「不同 binding 其實是同一顆資源」的情況。
- *
- * 判準是 **toml 自己宣告的名字**（`database_name` / `index_name`），不是使用者那側的資源名——
- * cypher 的 `CREDENTIALS_DB` 與 kbdb 的 `DB` 都寫 `database_name = "arcrun-kbdb"`，
- * 那是**我們**在宣告「這兩個綁定指向同一顆庫」，跟 #97 那種「拿名字去猜使用者的資源」是兩回事。
- *
- * 沒有這一步會出兩種錯：
- *   ① 全新安裝時建出兩顆同名 D1，KBDB 的資料與 credential 目錄從此分家。
- *   ② 一邊已部署（沿用既有）、另一邊沒有（新建一顆空的）→ 半套資料，比全壞更難查。
- *
- * @param {PlannedAdopt[]} adopt
- * @param {PlannedCreate[]} create
- * @param {Map<string, BindingRequirement[]>} byKey
- * @returns {PlannedCreate[]}
- */
-function shareSameResource(adopt, create, byKey) {
-  /** @param {ResourceKind} kind @param {string} binding @returns {string | undefined} */
-  const declaredName = (kind, binding) =>
-    byKey.get(bindingKey(kind, binding))?.[0]?.createName;
-
-  /** @type {PlannedCreate[]} */
-  const out = [];
-  /** @type {Map<string, PlannedCreate>} */
-  const groups = new Map();
-
-  for (const c of create) {
-    const groupKey = `${c.kind} ${c.createName}`;
-
-    // ① 已經有 binding 沿用到同一顆（依 toml 宣告）→ 跟著沿用，不要另外建一顆。
-    const twin = adopt.find(
-      (a) => a.kind === c.kind && declaredName(a.kind, a.binding) === c.createName,
-    );
-    if (twin) {
-      adopt.push({ kind: c.kind, binding: c.binding, value: twin.value, from: twin.from });
-      continue;
-    }
-
-    // ② 同一趟裡有多個 binding 要建同一顆 → 建一次，其他人共用。
-    const head = groups.get(groupKey);
-    if (head) {
-      head.alsoBind.push(c.binding);
-      head.wantedBy = [...new Set([...head.wantedBy, ...c.wantedBy])];
-      continue;
-    }
-    groups.set(groupKey, c);
-    out.push(c);
-  }
-  return out;
-}
-
-/**
- * 照 plan 動手：沿用的原樣帶出來，該建的才建。
- * 有任何 blocker 直接丟 ResourcePlanBlocked，**一顆都不建**。
- *
- * @param {ResourceApi} api
- * @param {ResourcePlan} plan
- * @returns {Promise<Map<string, ResolvedResource>>}
- */
-export async function applyResourcePlan(api, plan) {
-  if (plan.blockers.length > 0) throw new ResourcePlanBlocked(plan.blockers);
-
-  /** @type {Map<string, ResolvedResource>} */
-  const out = new Map();
-  for (const a of plan.adopt) {
-    out.set(bindingKey(a.kind, a.binding), {
-      kind: a.kind,
-      binding: a.binding,
-      value: a.value,
-      origin: 'adopted',
-      from: a.from,
-    });
-  }
-  /** @type {string[]} */
-  const madeSoFar = [];
-  for (const c of plan.create) {
-    /** @type {string} */
-    let value;
-    try {
-      if (c.kind === 'kv_namespace') value = await api.createKvNamespace(c.createName);
-      else if (c.kind === 'd1') value = await api.createD1Database(c.createName);
-      else value = await api.createVectorizeIndex(c.createName);
-    } catch (e) {
-      // 半途失敗：已經建出來的那幾顆還沒被綁到任何 worker 上。**要講出來**——
-      // 不講的話它們就是帳號上一批沒人認得的孤兒，而且下次重跑會再建一批。
-      const orphans = madeSoFar.length > 0
-        ? `\n  已經建好但還沒綁上任何 worker 的：${madeSoFar.join('、')}（重跑前可先刪掉，或留著讓下次沿用）`
-        : '';
-      throw new Error(`建 ${KIND_LABEL[c.kind]}「${c.createName}」失敗：${msg(e)}${orphans}`);
-    }
-    madeSoFar.push(`${KIND_LABEL[c.kind]} ${c.createName}`);
-    for (const binding of [c.binding, ...c.alsoBind]) {
-      out.set(bindingKey(c.kind, binding), { kind: c.kind, binding, value, origin: 'created' });
-    }
-  }
-  return out;
-}
-
-// ─────────────────────────────────────────────────────────────────────────────
-// wrangler.toml → 需求清單
-// ─────────────────────────────────────────────────────────────────────────────
-
-/**
- * wrangler.toml 的 table 名 → 資源種類。需求解析與注入共用同一張表，兩邊才不會對不上。
- * @type {Record<string, ResourceKind>}
- */
-export const TABLE_KIND = {
-  kv_namespaces: 'kv_namespace',
-  d1_databases: 'd1',
-  vectorize: 'vectorize',
-};
-
-/**
- * 從 wrangler.toml 抽出「這顆 worker 需要哪些資源綁定」。
- *
- * 刻意寫成行掃描而不引 TOML parser：注入端（injectWranglerConfig）本來就是純文字操作，
- * 兩邊用同一種視角看這份檔案才不會對不上。註解掉的區塊**不算需求**
- * （kbdb 的 `[[vectorize]]` 預設是註解狀態，要開語義查詢時才會被取消註解 → 那時才成為需求）。
- *
- * 也是「零依賴」的一部分：不引 TOML parser ⇒ 安裝器 import 這支不必多裝任何東西。
- *
- * @param {string} toml
- * @returns {WranglerRequirements}
- */
-export function parseWranglerRequirements(toml) {
-  let script = '';
-  let seenTable = false;
-  /** @type {WranglerRequirements['bindings']} */
-  const bindings = [];
-
-  /** @type {ResourceKind | null} */
-  let kind = null;
-  let binding = '';
-  let createName = '';
-
-  const flush = () => {
-    if (kind && binding) {
-      bindings.push({ kind, binding, createName: createName || binding });
-    }
-    kind = null;
-    binding = '';
-    createName = '';
-  };
-
-  for (const raw of toml.split('\n')) {
-    const line = raw.trim();
-    if (line === '' || line.startsWith('#')) continue;
-
-    const table = line.match(/^\[\[?([A-Za-z0-9_]+)\]?\]$/);
-    if (table) {
-      flush();
-      seenTable = true;
-      kind = TABLE_KIND[table[1]] ?? null;
-      continue;
-    }
-
-    const kv = line.match(/^([A-Za-z0-9_]+)\s*=\s*"([^"]*)"/);
-    if (!kv) continue;
-    const [, key, value] = kv;
-
-    if (!seenTable && key === 'name') {
-      script = value;
-      continue;
-    }
-    if (!kind) continue;
-    if (key === 'binding') binding = value;
-    // 只有 D1／Vectorize 在 toml 裡帶得出「名字」；KV 沒有，退回用 binding 名（見 flush）。
-    else if (key === 'database_name' || key === 'index_name') createName = value;
-  }
-  flush();
-
-  return { script, bindings };
-}
-
-// ─────────────────────────────────────────────────────────────────────────────
-// Cloudflare `/settings` 回應 → 事實（兩條路都要用同一種眼睛看）
-// ─────────────────────────────────────────────────────────────────────────────
-
-/**
- * CF `GET /accounts/{id}/workers/scripts/{script}/settings` 回的 binding 原始形狀
- * （同一種資源在不同 API 版本欄位名不一，故全都收）。
- *
- * @typedef {object} RawWorkerBinding
- * @property {string} [type]
- * @property {string} [name]
- * @property {string} [namespace_id]
- * @property {string} [id]
- * @property {string} [database_id]
- * @property {string} [index_name]
- * @property {string} [text]  `plain_text` 綁定的值（#106；secret_text 不會回值，本來就讀不到，也不該讀）。
- */
-
-/**
- * 把 CF 的 binding 陣列收斂成規則認得的三種資源。不認得的型別直接略過。
- *
- * 🔴 這支**刻意放在規則裡**，不留在各自的 CF client：
- *   「什麼才算『這顆 worker 綁著某顆資源』」是規則的一部分。
- *   兩條路各自解讀 CF 回應 = 漂移會從這裡長回來（例如一邊認 `namespace_id`、
- *   另一邊只認 `id`，於是一邊看得到綁定、另一邊看不到 → 後者又去新建了）。
- *
- * @param {RawWorkerBinding[]} raw
- * @returns {LiveBinding[]}
- */
-export function normalizeLiveBindings(raw) {
-  /** @type {LiveBinding[]} */
-  const out = [];
-  for (const b of raw) {
-    if (!b?.name) continue;
-    if (b.type === 'kv_namespace') {
-      const value = b.namespace_id ?? b.id;
-      if (value) out.push({ kind: 'kv_namespace', binding: b.name, value });
-    } else if (b.type === 'd1' || b.type === 'd1_database') {
-      const value = b.id ?? b.database_id;
-      if (value) out.push({ kind: 'd1', binding: b.name, value });
-    } else if (b.type === 'vectorize') {
-      if (b.index_name) out.push({ kind: 'vectorize', binding: b.name, value: b.index_name });
-    }
-  }
-  return out;
-}
-
-/**
- * 抽出已部署 worker 上的 `plain_text` var（#106）。
- *
- * 只收 `plain_text`——**`secret_text` 一律不碰**（CF 本來就不回值，也不該被搬來搬去；
- * wrangler deploy 不會動 secret，它們自己會留著）。
- *
- * @param {RawWorkerBinding[]} raw
- * @returns {Record<string, string>}
- */
-export function normalizeLiveVars(raw) {
-  /** @type {Record<string, string>} */
-  const out = {};
-  for (const b of raw) {
-    if (b?.type === 'plain_text' && b.name && typeof b.text === 'string') out[b.name] = b.text;
-  }
-  return out;
-}

cli/tests/knowledge-namespace.test.ts

@@ -0,0 +1,170 @@
+/**
+ * Arcrun#108 迴歸守衛 —— 「雲端讀資料用的命名空間，要跟你寫資料用的那個一致」
+ *
+ * 2026-08-12 實害：leo 的藏書地圖回 0 個庫，實際有 1854 條三元組。
+ * 根因：你 push 工作流、小幫手上傳知識、MCP 查詢都用 `~/.arcrun/config.yaml` 的 `api_key`
+ * （leo ＝ `bfezv28v`），但 cypher 讀取時的 owner_id 來自 worker 環境變數
+ * ——而那個變數是 repo toml 帶的**官方 prod 值** `CONSOLE_TENANT = "leo"`。
+ * 寫在 A、讀在 B，全被過濾掉。
+ *
+ * 這份測試守兩件相反的事（本次的核心判斷）：
+ *   · 驗得到知識 → **寫** `ARCRUN_NAMESPACE`，讓讀寫兩端對齊
+ *   · 驗不到 / 問不到 → **一個字都不動**，既有值原封保留
+ *     （無條件覆蓋會把一台「知識本來就寫在 CONSOLE_TENANT 底下」的一鍵安裝實例指向空的那一格
+ *      ——那就是 #97/#106 那類「更新一次把人家的東西弄不見」，比原本的 bug 更糟）
+ *
+ * 全部離線跑：真的 wrangler.toml + 真的 render 程式碼，fetch 用假的，不碰任何實例。
+ */
+
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import {
+  renderWranglerToml,
+  preservedVars,
+  namespaceHasKnowledge,
+  VERSION_STAMP_WORKER,
+  type DeployContext,
+} from '../src/lib/deploy.ts';
+
+const REPO = join(fileURLToPath(new URL('.', import.meta.url)), '..', '..');
+const CYPHER_TOML = readFileSync(join(REPO, 'cypher-executor', 'wrangler.toml'), 'utf8');
+
+/** leo 的真實命名空間（2026-08-11 回灌時定名，見 Leo/mira#8）。 */
+const LEO_NS = 'bfezv28v';
+
+const CTX: DeployContext = {
+  accountId: 'acc-user-123',
+  apiToken: 'token',
+  workerSubdomain: 'user-sub',
+  selfHosted: true,
+  kbdbEmbed: true,
+};
+
+function readVars(toml: string): Record<string, string> {
+  const out: Record<string, string> = {};
+  let inVars = false;
+  for (const line of toml.split('\n')) {
+    if (/^\s*\[vars\]/.test(line)) { inVars = true; continue; }
+    if (/^\s*\[/.test(line)) { inVars = false; continue; }
+    if (!inVars) continue;
+    const m = line.match(/^\s*([A-Za-z0-9_]+)\s*=\s*"([^"]*)"/);
+    if (m) out[m[1]] = m[2];
+  }
+  return out;
+}
+
+/** 模擬 downloadAndDeploy 那段：沿用既有 var，再疊上這趟 CLI 算出來的值。 */
+function deployedVars(ctx: DeployContext, live: Record<string, string>): Record<string, string> {
+  const keep = preservedVars(live, CYPHER_TOML);
+  const extra: Record<string, string> = { ...keep };
+  if (ctx.knowledgeNamespace) extra.ARCRUN_NAMESPACE = ctx.knowledgeNamespace;
+  return readVars(renderWranglerToml(CYPHER_TOML, ctx, new Map(), extra));
+}
+
+// ── ① 驗得到知識 → 寫進去 ────────────────────────────────────────────────────
+
+test('#108 給了 knowledgeNamespace → cypher [vars] 出現 ARCRUN_NAMESPACE（讀寫兩端終於同一個值）', () => {
+  const vars = deployedVars({ ...CTX, knowledgeNamespace: LEO_NS }, {});
+  assert.equal(vars.ARCRUN_NAMESPACE, LEO_NS);
+  // CONSOLE_TENANT 一個字都不能動——它同時是帳號子 namespace 的組成，改了舊實例登不進去
+  assert.equal(vars.CONSOLE_TENANT, 'leo');
+});
+
+test('#108 蓋得過 worker 上的舊值（改名／搬遷後 acr update 要能修正，不是永遠沿用第一次那個）', () => {
+  const vars = deployedVars({ ...CTX, knowledgeNamespace: LEO_NS }, { ARCRUN_NAMESPACE: 'stale-ns' });
+  assert.equal(vars.ARCRUN_NAMESPACE, LEO_NS);
+});
+
+// ── ② 驗不到 → 什麼都不動（比 bug 更糟的是把人家原本正常的實例弄空）──────────────
+
+test('#108 沒給 knowledgeNamespace → 既有的 ARCRUN_NAMESPACE 原封保留（不因為這趟驗不到就洗掉）', () => {
+  const vars = deployedVars(CTX, { ARCRUN_NAMESPACE: 'user-existing-ns' });
+  assert.equal(vars.ARCRUN_NAMESPACE, 'user-existing-ns');
+});
+
+test('#108 沒給、worker 上也沒有 → 不注入（回退 CONSOLE_TENANT，舊實例行為一字不變）', () => {
+  const vars = deployedVars(CTX, {});
+  assert.equal(vars.ARCRUN_NAMESPACE, undefined);
+  assert.equal(vars.CONSOLE_TENANT, 'leo');
+});
+
+test('#108 ARCRUN_NAMESPACE 不在 CLI_MANAGED_VARS：它「不是每趟重算」而是「驗到才寫」，' +
+  '列進去會讓驗不到的那趟把既有值一起洗掉', async () => {
+  const { CLI_MANAGED_VARS } = await import('../src/lib/deploy.ts');
+  assert.equal((CLI_MANAGED_VARS as readonly string[]).includes('ARCRUN_NAMESPACE'), false);
+});
+
+test('#108 只烙在 cypher 這顆 worker（其他 worker 不需要知識命名空間）', () => {
+  assert.equal(VERSION_STAMP_WORKER, 'arcrun-cypher-executor');
+});
+
+// ── ③ 「先驗再寫」那支探針的三態 ───────────────────────────────────────────────
+
+test('namespaceHasKnowledge：這個命名空間底下查得到庫 → true（可以安全寫進去）', async () => {
+  const calls: string[] = [];
+  const orig = globalThis.fetch;
+  globalThis.fetch = (async (url: string | URL, init?: RequestInit) => {
+    calls.push(String(url));
+    assert.equal((init?.headers as Record<string, string>)['X-Arcrun-API-Key'], LEO_NS);
+    return new Response(JSON.stringify({ success: true, libraries: [{ library: 'kb' }], count: 1 }), { status: 200 });
+  }) as typeof fetch;
+  try {
+    assert.equal(await namespaceHasKnowledge('https://cypher.example.dev', LEO_NS), true);
+    assert.equal(calls[0], `https://cypher.example.dev/kbdb/map?owner_id=${LEO_NS}`);
+  } finally {
+    globalThis.fetch = orig;
+  }
+});
+
+test('namespaceHasKnowledge：查得到但是空的 → false（知識可能在別的命名空間，不准蓋）', async () => {
+  const orig = globalThis.fetch;
+  globalThis.fetch = (async () =>
+    new Response(JSON.stringify({ success: true, libraries: [], count: 0 }), { status: 200 })) as typeof fetch;
+  try {
+    assert.equal(await namespaceHasKnowledge('https://cypher.example.dev', LEO_NS), false);
+  } finally {
+    globalThis.fetch = orig;
+  }
+});
+
+test('namespaceHasKnowledge：問不到（實例沒起來／舊版沒這條路／網路斷）→ null，不宣稱任何事', async () => {
+  const orig = globalThis.fetch;
+  globalThis.fetch = (async () => { throw new Error('ECONNREFUSED'); }) as typeof fetch;
+  try {
+    assert.equal(await namespaceHasKnowledge('https://cypher.example.dev', LEO_NS), null);
+  } finally {
+    globalThis.fetch = orig;
+  }
+  globalThis.fetch = (async () => new Response('nope', { status: 500 })) as typeof fetch;
+  try {
+    assert.equal(await namespaceHasKnowledge('https://cypher.example.dev', LEO_NS), null);
+  } finally {
+    globalThis.fetch = orig;
+  }
+});
+
+test('namespaceHasKnowledge：回應形狀不對 → null（讀不出來 ≠ 沒有資料，禁假綠）', async () => {
+  const orig = globalThis.fetch;
+  globalThis.fetch = (async () =>
+    new Response(JSON.stringify({ success: true }), { status: 200 })) as typeof fetch;
+  try {
+    assert.equal(await namespaceHasKnowledge('https://cypher.example.dev', LEO_NS), null);
+  } finally {
+    globalThis.fetch = orig;
+  }
+});
+
+test('namespaceHasKnowledge：缺 url 或缺 namespace → null（不打任何請求）', async () => {
+  const orig = globalThis.fetch;
+  globalThis.fetch = (async () => { throw new Error('不該被呼叫'); }) as typeof fetch;
+  try {
+    assert.equal(await namespaceHasKnowledge('', LEO_NS), null);
+    assert.equal(await namespaceHasKnowledge('https://cypher.example.dev', ''), null);
+  } finally {
+    globalThis.fetch = orig;
+  }
+});

cli/tests/single-implementation.test.ts

@@ -1,111 +0,0 @@
-/**
- * 「只有一份」的機械證明。
- *
- * leo 的驗收條件：「改完之後，`grep` 得出『決定用哪些資源』的邏輯**只有一個地方**。
- * 兩個以上呼叫端各自有一份 ⇒ 不算完成。」
- *
- * 這份測試就是把那個 grep 寫成會紅的東西：
- *   ① 規則的每一支函式，全 repo 只有 `shared/resource-rule/` 有實作
- *      （`cli/src/lib/resource-rule/` 是它的逐位元組鏡射，由 sync 腳本產生並看守，不算第二份）
- *   ② 鏡射與原稿逐位元組相同（sync --check 的同一道閘，這裡再測一次讓 `npm test` 也擋得住）
- *   ③ 共用層不准長出依賴——有依賴就會有某條路吃不到它
- */
-
-import { test } from 'node:test';
-import assert from 'node:assert/strict';
-import { readFileSync, readdirSync, statSync } from 'node:fs';
-import { join, relative } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { createHash } from 'node:crypto';
-
-const REPO = join(fileURLToPath(new URL('.', import.meta.url)), '..', '..');
-const SOURCE_DIR = join(REPO, 'shared/resource-rule');
-const MIRROR_DIR = join(REPO, 'cli/src/lib/resource-rule');
-
-/** 規則的實作特徵：這些**宣告**只准出現在原稿目錄（與它的鏡射）裡。 */
-const RULE_DECLARATIONS = [
-  'function planResources',
-  'function applyResourcePlan',
-  'function shareSameResource',
-  'function parseWranglerRequirements',
-  'function normalizeLiveBindings',
-  'function normalizeLiveVars',
-  'function createCloudflareResourceApi',
-];
-
-const SKIP_DIRS = new Set([
-  'node_modules', '.git', 'dist', '.wrangler', '.worker-builds', '.component-builds',
-  '.github-public', 'coverage',
-]);
-
-/** 只掃「人會寫程式的地方」；產生物與二進位不掃。 */
-function walk(dir: string, out: string[] = []): string[] {
-  for (const name of readdirSync(dir)) {
-    if (SKIP_DIRS.has(name)) continue;
-    const abs = join(dir, name);
-    const st = statSync(abs);
-    if (st.isDirectory()) walk(abs, out);
-    else if (/\.(ts|tsx|js|mjs|cjs)$/.test(name)) out.push(abs);
-  }
-  return out;
-}
-
-const sha256 = (b: Buffer): string => createHash('sha256').update(b).digest('hex');
-
-test('① 規則的實作全 repo 只有一份（原稿目錄 + 它的鏡射，沒有第三處）', () => {
-  const files = walk(REPO);
-  const offenders: string[] = [];
-
-  for (const abs of files) {
-    const rel = relative(REPO, abs);
-    // 原稿與鏡射本來就該有；測試檔在講規則、不是實作規則
-    if (rel.startsWith('shared/resource-rule/')) continue;
-    if (rel.startsWith('cli/src/lib/resource-rule/')) continue;
-    if (rel.startsWith('cli/tests/')) continue;
-    if (rel === 'scripts/sync-resource-rule.mjs') continue;
-
-    const src = readFileSync(abs, 'utf8');
-    for (const decl of RULE_DECLARATIONS) {
-      if (src.includes(decl)) offenders.push(`${rel} → ${decl}`);
-    }
-  }
-
-  assert.deepEqual(offenders, [],
-    '「決定用哪些資源」的實作出現在共用層之外——這正是本票要消滅的東西：\n' +
-    offenders.map((o) => `  • ${o}`).join('\n') +
-    '\n要改規則就改 shared/resource-rule/，呼叫端只准 import。');
-
-  console.log(`\n  ① 掃過 ${files.length} 個原始碼檔，${RULE_DECLARATIONS.length} 支規則函式的實作` +
-    ' 全部只出現在 shared/resource-rule/（＋機械鏡射）');
-});
-
-test('② CLI 帶的那份與原稿逐位元組相同（漂移＝第二份實作偷偷長出來）', () => {
-  const files = readdirSync(SOURCE_DIR).filter((f) => f.endsWith('.mjs')).sort();
-  assert.ok(files.length > 0, 'shared/resource-rule/ 裡沒有任何 .mjs 原稿');
-
-  const mirrored = readdirSync(MIRROR_DIR).filter((f) => f.endsWith('.mjs')).sort();
-  assert.deepEqual(mirrored, files, '鏡射目錄的檔案清單與原稿不一致');
-
-  for (const f of files) {
-    const a = sha256(readFileSync(join(SOURCE_DIR, f)));
-    const b = sha256(readFileSync(join(MIRROR_DIR, f)));
-    assert.equal(b, a, `cli/src/lib/resource-rule/${f} 與原稿不一致——不要手改產生物，` +
-      '改 shared/resource-rule/ 後跑 node scripts/sync-resource-rule.mjs');
-    console.log(`  ② ${f.padEnd(24)} sha256 ${a.slice(0, 16)}  原稿 = 鏡射`);
-  }
-});
-
-test('③ 共用層零外部依賴（只准 import 同目錄的兄弟檔）', () => {
-  for (const f of readdirSync(SOURCE_DIR).filter((x) => x.endsWith('.mjs'))) {
-    const src = readFileSync(join(SOURCE_DIR, f), 'utf8');
-    const imports = [...src.matchAll(/^\s*import\s[^'"]*['"]([^'"]+)['"]/gm)].map((m) => m[1]);
-    for (const spec of imports) {
-      assert.ok(spec.startsWith('./'),
-        `shared/resource-rule/${f} import 了 "${spec}"——共用層一旦有外部依賴，` +
-        '就會有某條路（Workers runtime／安裝器）吃不到它。');
-    }
-    assert.doesNotMatch(src, /require\(|from\s+['"]node:/,
-      `shared/resource-rule/${f} 用到 node 專屬 API——Cloudflare Workers 上跑不起來。`);
-    console.log(`  ③ ${f.padEnd(24)} import: ${imports.length ? imports.join(', ') : '（無）'}`);
-  }
-});

cli/tests/two-paths-agree.test.ts

@@ -1,159 +0,0 @@
-/**
- * 兩條路必須得出同一個答案 —— 本票的核心驗收。
- *
- * leo 2026-08-12：「根本就不應該在 CLI，我要的是一個大家都可以用到的規則。」
- *
- * 後果已經真的發生過：`acr` 那條有 Arcrun#97 的修法、安裝器那條沒有，
- * 於是安裝器照名字找、找不到就建一顆空的綁上去 ⇒ 使用者的工作流與登入狀態整片消失。
- *
- * 這份測試把**同一個帳號狀態**餵給兩條路：
- *   A. `acr` 那條：`CfAccountClient` + `resource-resolver`（CLI 真正跑的 import 鏈）
- *   B. 安裝器那條：只 import `shared/resource-rule/`（安裝器唯一該碰的入口）
- * 然後比對它們選出的 **resource id 必須相同**。
- *
- * 假的是 `fetch`，不是 `ResourceApi`——所以兩條路都真的走完 HTTP → 解析 → 判斷整條鏈。
- * 只測判斷會漏掉「怎麼把 CF 回應讀成事實」，而 #97 的重演只要眼睛不一樣就夠了。
- */
-
-import { test } from 'node:test';
-import assert from 'node:assert/strict';
-
-// ── A：acr 那條（CLI 真正用的東西）
-import { CfAccountClient } from '../src/lib/cf-api.ts';
-import { planResources, applyResourcePlan, bindingKey } from '../src/lib/resource-resolver.ts';
-import type { BindingRequirement } from '../src/lib/resource-resolver.ts';
-
-// ── B：安裝器那條（只碰 shared/）
-import { resolveInstanceResources } from '../../shared/resource-rule/installer-entry.mjs';
-
-// ── 共用 fixture
-import {
-  makeAccount,
-  requirements,
-  SCENARIOS,
-  WORKER_NEEDS,
-  type Scenario,
-} from '../../shared/resource-rule/tests/fixture-account.mjs';
-
-const ACCOUNT = 'acct-fixture';
-const TOKEN = 'tok-fixture';
-
-/** 把 fixture 的需求組成安裝器吃的 wrangler.toml 文字（它的入口是從 toml 讀需求的）。 */
-function tomlsFor(): string[] {
-  return Object.entries(WORKER_NEEDS).map(([script, need]) => {
-    let t = `name = "${script}"\ncompatibility_date = "2025-02-19"\n`;
-    for (const b of need.kv) t += `\n[[kv_namespaces]]\nbinding = "${b}"\nid = "PLACEHOLDER"\n`;
-    for (const d of need.d1) {
-      t += `\n[[d1_databases]]\nbinding = "${d.binding}"\ndatabase_name = "${d.database_name}"\ndatabase_id = "PLACEHOLDER"\n`;
-    }
-    return t;
-  });
-}
-
-/** A：跑 acr 那條。CfAccountClient 走 global fetch，所以這裡把它換成 fixture。 */
-async function runAcrPath(scenario: Scenario, mode: 'update' | 'init') {
-  const account = makeAccount(scenario);
-  const realFetch = globalThis.fetch;
-  globalThis.fetch = account.fetch;
-  try {
-    const api = new CfAccountClient(ACCOUNT, TOKEN);
-    const plan = await planResources(api, requirements() as BindingRequirement[], mode);
-    if (plan.blockers.length > 0) {
-      return { blocked: true, blockers: plan.blockers, bindings: {} as Record<string, string>, account };
-    }
-    const resolved = await applyResourcePlan(api, plan);
-    const bindings: Record<string, string> = {};
-    for (const [k, r] of resolved) bindings[k] = r.value;
-    return { blocked: false, blockers: [] as string[], bindings, account };
-  } finally {
-    globalThis.fetch = realFetch;
-  }
-}
-
-/** B：跑安裝器那條。只用 shared/ 的入口，fetch 直接注入。 */
-async function runInstallerPath(scenario: Scenario, mode: 'update' | 'init') {
-  const account = makeAccount(scenario);
-  const r = await resolveInstanceResources({
-    accountId: ACCOUNT,
-    apiToken: TOKEN,
-    wranglerTomls: tomlsFor(),
-    mode,
-    fetch: account.fetch,
-  });
-  return { blocked: r.blocked, blockers: r.blockers, bindings: r.bindings, account };
-}
-
-/** 把兩邊的決定印出來——PR 要貼的就是這張對照表。 */
-function report(scenario: Scenario, a: Record<string, string>, b: Record<string, string>): void {
-  const keys = [...new Set([...Object.keys(a), ...Object.keys(b)])].sort();
-  console.log(`\n  ── ${scenario}：${SCENARIOS[scenario].label}`);
-  console.log(`     ${'binding'.padEnd(34)} ${'acr 選的'.padEnd(24)} 安裝器選的        一致?`);
-  for (const k of keys) {
-    const same = a[k] === b[k] ? '✓' : '✗';
-    console.log(`     ${k.padEnd(34)} ${(a[k] ?? '—').padEnd(24)} ${(b[k] ?? '—').padEnd(18)} ${same}`);
-  }
-}
-
-// ─────────────────────────────────────────────────────────────────────────────
-
-for (const scenario of ['fresh', 'installed', 'renamed'] as const) {
-  const mode = scenario === 'fresh' ? 'init' : 'update';
-
-  test(`兩條路一致 — ${scenario}：${SCENARIOS[scenario].label}`, async () => {
-    const a = await runAcrPath(scenario, mode);
-    const b = await runInstallerPath(scenario, mode);
-
-    assert.equal(a.blocked, b.blocked, '一邊停手、一邊照做 = 最危險的分歧');
-    assert.deepEqual(a.blockers, b.blockers, '停手的理由也要一樣');
-    report(scenario, a.bindings, b.bindings);
-    assert.deepEqual(
-      a.bindings,
-      b.bindings,
-      `${scenario}：兩條路選出的 resource id 不同——這就是 Arcrun#97 的形狀`,
-    );
-
-    // 建立行為也要一致（一邊沿用、一邊新建 = 使用者的東西在其中一條路上會消失）
-    assert.deepEqual(a.account.created, b.account.created, '兩條路「建了什麼」必須一樣');
-  });
-}
-
-// ── 三種情境各自該有的行為（不只是「兩邊一樣」，還要「一樣地對」）─────────────
-
-test('情境① 沒裝過 → 正常建新的（不能為了沿用而變成永遠不建）', async () => {
-  const { blocked, bindings, account } = await runInstallerPath('fresh', 'init');
-  assert.equal(blocked, false, '全新帳號要裝得起來');
-  assert.equal(account.created.kv.length, 9, `應新建 9 顆 KV，實際 ${account.created.kv.length}`);
-  assert.equal(account.created.d1.length, 1, `應新建 1 顆 D1，實際 ${account.created.d1.length}`);
-  // cypher 的 CREDENTIALS_DB 與 kbdb 的 DB 宣告同一個 database_name → 只該建一顆，兩邊共用
-  assert.equal(bindings['d1:CREDENTIALS_DB'], bindings['d1:DB'], '同一顆 D1 不該被建成兩顆');
-  console.log(`\n  ① 新建：KV ${account.created.kv.length} 顆、D1 ${account.created.d1.length} 顆` +
-    `（D1 共用：CREDENTIALS_DB = DB = ${bindings['d1:DB']}）`);
-});
-
-test('情境② 裝過了 → 沿用原本那幾顆，工作流與登入 session 都還在', async () => {
-  const { blocked, bindings, account } = await runInstallerPath('installed', 'update');
-  assert.equal(blocked, false);
-  assert.deepEqual(account.created, { kv: [], d1: [], vectorize: [] }, '更新不該建出任何新資源');
-
-  // 使用者的東西掛在資源 id 上：綁定還指向原本那顆 = 東西還在
-  assert.equal(bindings['kv_namespace:WEBHOOKS'], account.kvIdFor('WEBHOOKS'));
-  assert.equal(bindings['kv_namespace:SESSIONS_KV'], account.kvIdFor('SESSIONS_KV'));
-  assert.equal(bindings['d1:DB'], account.d1Id);
-  console.log(`\n  ② 沿用：WEBHOOKS → ${bindings['kv_namespace:WEBHOOKS']}` +
-    `（工作流 ${account.userData.workflows.length} 支還在）｜` +
-    `SESSIONS_KV → ${bindings['kv_namespace:SESSIONS_KV']}（登入 session 還在）｜` +
-    `DB → ${bindings['d1:DB']}（子庫 ${account.userData.libraries.length} 個還在）｜新建 0 顆`);
-});
-
-test('情境③ 資源在但名字與預期完全不同 → 仍然沿用（#97 的病根，專門驗）', async () => {
-  const { blocked, bindings, account } = await runInstallerPath('renamed', 'update');
-  assert.equal(blocked, false);
-  assert.deepEqual(account.created, { kv: [], d1: [], vectorize: [] },
-    '名字對不上就新建 = 正是 #97：一次更新生出 9 顆空 KV，使用者的東西從畫面上消失');
-  for (const b of ['WEBHOOKS', 'SESSIONS_KV', 'RECIPES', 'USERS_KV']) {
-    assert.equal(bindings[bindingKey('kv_namespace', b)], account.kvIdFor(b),
-      `${b} 沒有沿用到原本那顆`);
-  }
-  console.log(`\n  ③ 名字全不同（例：WEBHOOKS 那顆實際叫 "${SCENARIOS.renamed.titleFor('WEBHOOKS')}"）` +
-    ` → 仍沿用 ${bindings['kv_namespace:WEBHOOKS']}，新建 0 顆`);
-});

cli/tsconfig.json

@@ -6,11 +6,6 @@
     "outDir": "./dist",
     "rootDir": "./src",
     "strict": true,
-    // resource-rule.mjs 是共用規則的副本（純 JS + JSDoc，零依賴，見該檔開頭）。
-    // allowJs 讓 tsc 把它一起編進 dist（否則 npm 套件裡會缺這支 → 執行期 MODULE_NOT_FOUND）；
-    // checkJs 讓它的 JSDoc 型別真的被檢查，而不是靜靜地當 any。
-    "allowJs": true,
-    "checkJs": true,
     "esModuleInterop": true,
     "skipLibCheck": true,
     "declaration": true,

cypher-executor/package.json

@@ -5,7 +5,8 @@
   "scripts": {
     "dev": "wrangler dev",
     "deploy": "wrangler deploy",
-    "test": "vitest run"
+    "check:tenant": "node scripts/check-tenant-source.mjs",
+    "test": "node scripts/check-tenant-source.mjs && vitest run"
   },
   "dependencies": {
     "@hono/zod-openapi": "^1.2.4",

cypher-executor/scripts/check-tenant-source.mjs

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+/**
+ * 「靜態租戶字串不得用於資料面過濾」機械閘的**執行殼**（Arcrun#108）。
+ *
+ * 規則本體（純函式、零 node 相依）在 `tenant-source-rules.mjs`——拆開的理由是
+ * **這道閘自己要能被測試**：Workers runtime 的 vitest 沒有 node:fs，規則若和走檔案系統的
+ * 程式碼綁在一起就 import 不動，測試也就寫不出來（當晚有一道閘連讀自己的原始碼都擋，
+ * 結果沒人驗得了它會不會誤攔）。現在 tests/tenant-gate.test.ts 直接餵字串驗規則。
+ *
+ * 用法：
+ *   node scripts/check-tenant-source.mjs [projectRoot]   # 掃 src/，有違規 → exit 1
+ *   node scripts/check-tenant-source.mjs --stdin <相對路徑>  # 從 stdin 讀「即將寫入的內容」
+ *   npm run check:tenant
+ *
+ * `--stdin` 是給 `.claude/hooks/pre-write-guard.sh`（規則 8.1）用的：在檔案**還沒寫下去之前**
+ * 就擋，這樣違規根本進不了工作區。Edit 只給片段也沒關係——規則是逐行的，正好只看新寫的那幾行。
+ */
+import { readFileSync, readdirSync, statSync } from 'node:fs';
+import { join, relative, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { scanSource } from './tenant-source-rules.mjs';
+
+/** 遞迴列出目錄下的 .ts 檔（相對 root 的路徑）。 */
+function listTsFiles(root, dir = root, out = []) {
+  for (const name of readdirSync(dir)) {
+    const full = join(dir, name);
+    if (statSync(full).isDirectory()) listTsFiles(root, full, out);
+    else if (name.endsWith('.ts')) out.push(relative(root, full));
+  }
+  return out;
+}
+
+/** 掃整個 cypher-executor/src。回傳違規清單。 */
+export function scanProject(projectRoot) {
+  const srcRoot = join(projectRoot, 'src');
+  const all = [];
+  for (const rel of listTsFiles(projectRoot, srcRoot)) {
+    const relPosix = rel.split(sep).join('/');
+    all.push(
+      ...scanSource(relPosix, readFileSync(join(projectRoot, rel), 'utf8')).map((v) => ({
+        ...v,
+        file: relPosix,
+      })),
+    );
+  }
+  return all;
+}
+
+/** stdin 模式：讀「即將寫入的內容」，印違規、有違規 → exit 1。 */
+async function runStdin(relPath) {
+  const chunks = [];
+  for await (const chunk of process.stdin) chunks.push(chunk);
+  const violations = scanSource(relPath, Buffer.concat(chunks).toString('utf8'));
+  if (violations.length === 0) return 0;
+  for (const v of violations) {
+    console.error(`[${v.rule}] ${relPath}（新寫入的第 ${v.line} 行）：${v.text}`);
+    console.error(`  → ${v.message}`);
+  }
+  return 1;
+}
+
+if (process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1]) {
+  if (process.argv[2] === '--stdin') {
+    process.exit(await runStdin(process.argv[3] ?? 'src/unknown.ts'));
+  }
+  const projectRoot = process.argv[2] ?? process.cwd();
+  const violations = scanProject(projectRoot);
+  if (violations.length === 0) {
+    console.log('✓ 租戶來源檢查通過：資料面 owner_id 全部來自 src/lib/tenant.ts');
+    process.exit(0);
+  }
+  console.error('❌ 租戶來源檢查失敗（Arcrun#108 的閘）\n');
+  for (const v of violations) {
+    console.error(`  [${v.rule}] ${v.file}:${v.line}`);
+    console.error(`        ${v.text}`);
+    console.error(`        → ${v.message}\n`);
+  }
+  process.exit(1);
+}

cypher-executor/scripts/tenant-source-rules.mjs

@@ -0,0 +1,142 @@
+/**
+ * 「靜態租戶字串不得用於資料面過濾」— 機械閘（Arcrun#108）。
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * 為什麼要有這道閘
+ * ─────────────────────────────────────────────────────────────────────────────
+ * 同一句話已經寫錯兩次：
+ *   #105  `ownerNamespace(env) = env.MCP_OWNER_NAMESPACE || "leo"`
+ *   #108  `portalTenant(env)   = env.CONSOLE_TENANT      || "leo"`
+ * 兩次都是「拿一個部署環境變數的字面預設值，當成使用者資料的歸屬」。規則早就在（rule 07
+ * 薄殼、design §3.3 租戶不下發），但**沒有任何機制會擋**，所以它每隔幾週就長回來一次。
+ * leo 2026-08-12：「做一個平台要減少 hotfix。」⇒ 修掉 bug 不算完成，要留下會擋的東西。
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * 判準：看「有沒有在做那件事」，不是看「有沒有出現那個詞」
+ * ─────────────────────────────────────────────────────────────────────────────
+ * 誤攔比漏攔更容易殺死一道閘（被擋煩了就有人把它關掉），所以三條規則全部盯**行為**：
+ *
+ *   T1 租戶環境變數只有一個產地
+ *      `env.CONSOLE_TENANT` / `env.ARCRUN_NAMESPACE` 只能在 src/lib/tenant.ts 被讀取。
+ *      盯的是「你在把部署設定讀成身分」這個動作本身。註解裡寫這兩個字不算（只看 `env.X` 取值）。
+ *
+ *   T2 資料面租戶識別不得憑空捏造
+ *      `as TenantId` 只能出現在 src/lib/tenant.ts，且不得套在字面字串上。
+ *      盯的是「繞過唯一產地自己造一個租戶」。
+ *
+ *   T3 帳號層字串不得流進知識資料面
+ *      同一行同時「在組 owner_id」且「值來自 portalTenant()/accountTenant()」→ 擋。
+ *      這正是 #108 那一行的形狀：`owner_id=${encodeURIComponent(portalTenant(c.env))}`。
+ *      `owner_id: ns`（帳號子 namespace，合法）不命中；`x.owner_id` 這種讀取也不命中。
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * 這道閘自己要能被測試
+ * ─────────────────────────────────────────────────────────────────────────────
+ * 核心是純函式 `scanSource(relPath, text)`（不碰檔案系統），測試餵好例子/壞例子驗它會不會叫
+ * （tests/tenant-gate.test.ts）——當晚有一道閘連讀自己的原始碼都擋，導致沒人驗得了它。
+ * 本檔只掃 `src/`，測試與 fixture 都不在掃描範圍內，所以**不會擋到自己**。
+ *
+ * 本檔是**純規則**（零 node 相依），所以 Workers runtime 的 vitest 也 import 得動；
+ * 走檔案系統的那半在 check-tenant-source.mjs。
+ */
+
+/** 唯一允許產出租戶識別的檔案（相對 cypher-executor/）。 */
+export const TENANT_SOURCE_FILE = 'src/lib/tenant.ts';
+/** 只宣告型別、不取值的檔案（`CONSOLE_TENANT?: string` 這種）。 */
+const TYPE_DECL_FILES = new Set(['src/types.ts']);
+
+/** 被視為「租戶來源」的環境變數——讀它們＝在決定使用者資料的歸屬。 */
+const TENANT_ENV_VARS = ['CONSOLE_TENANT', 'ARCRUN_NAMESPACE'];
+
+/** 帳號層租戶字串的取得方式（回的是 string 不是 TenantId，不得用於知識資料面）。 */
+const ACCOUNT_TENANT_CALLS = ['portalTenant(', 'accountTenant('];
+
+const ENV_READ = new RegExp(String.raw`\benv\s*\.\s*(${TENANT_ENV_VARS.join('|')})\b`);
+const AS_TENANT_ID = /\bas\s+TenantId\b/;
+const LITERAL_AS_TENANT_ID = /(['"`][^'"`]*['"`])\s*as\s+TenantId\b/;
+
+/**
+ * 「這一行在組 owner_id 嗎？」——**構造**才算，**讀取**不算。
+ *   算：`owner_id=` 出現在字串/樣板裡、`owner_id:` 當成物件屬性在賦值
+ *   不算：`x.owner_id`（讀）、`owner_id?:`（型別宣告）、`owner_id` 單獨出現在註解句子裡
+ */
+function buildsOwnerFilter(line) {
+  const code = stripComment(line);
+  if (!code.includes('owner_id')) return false;
+  if (/owner_id\s*=/.test(code) && !/[.\w]owner_id\s*=/.test(code)) return true; // `?owner_id=` / `owner_id=${...}`
+  if (/(^|[^.\w])owner_id\s*:/.test(code) && !/owner_id\s*\?\s*:/.test(code)) return true; // `owner_id: X`
+  return false;
+}
+
+/** 去掉行末 `//` 註解（不處理跨行 /* *\/——那種行本來就不含可執行的取值）。 */
+function stripComment(line) {
+  const i = line.indexOf('//');
+  return i === -1 ? line : line.slice(0, i);
+}
+
+/** 整行是註解？（`//` 開頭或位於 JSDoc 區塊的 ` *` 行） */
+function isCommentLine(line) {
+  const t = line.trim();
+  return t.startsWith('//') || t.startsWith('*') || t.startsWith('/*');
+}
+
+/**
+ * 掃一份原始碼，回傳違規清單（純函式，測試直接餵字串）。
+ * @param {string} relPath 相對 cypher-executor/ 的路徑，例如 'src/routes/portal-data.ts'
+ * @param {string} text 檔案內容
+ * @returns {{rule: string, line: number, text: string, message: string}[]}
+ */
+export function scanSource(relPath, text) {
+  const rel = relPath.split('\\').join('/');
+  const violations = [];
+  const lines = text.split('\n');
+
+  lines.forEach((line, idx) => {
+    const n = idx + 1;
+    const push = (rule, message) =>
+      violations.push({ rule, line: n, text: line.trim(), message });
+
+    if (isCommentLine(line)) return;
+    const code = stripComment(line);
+
+    // T1：租戶環境變數只有一個產地
+    if (rel !== TENANT_SOURCE_FILE && !TYPE_DECL_FILES.has(rel) && ENV_READ.test(code)) {
+      push(
+        'T1',
+        `租戶環境變數只能在 ${TENANT_SOURCE_FILE} 讀取。` +
+          '在別處讀它＝又一次「身分來自環境變數」（#105/#108 同形），' +
+          '請改呼叫 knowledgeOwner(env)（知識資料面）或 accountTenant(env)（帳號層）。',
+      );
+    }
+
+    // T2：資料面租戶識別不得憑空捏造
+    if (AS_TENANT_ID.test(code)) {
+      if (rel !== TENANT_SOURCE_FILE) {
+        push(
+          'T2',
+          `TenantId 只能由 ${TENANT_SOURCE_FILE} 產生。自己 cast 一個等於繞過唯一產地——` +
+            '請用 knowledgeOwner(env) 或 tenantFromApiKey(header)。',
+        );
+      } else if (LITERAL_AS_TENANT_ID.test(code)) {
+        push(
+          'T2',
+          '不得把**字面字串**當成租戶識別（那就是 `|| "leo"` 那個預設值的原形）。' +
+            '解析不到請丟 TenantUnresolvedError，誠實說讀不到。',
+        );
+      }
+    }
+
+    // T3：帳號層字串不得流進知識資料面
+    if (buildsOwnerFilter(line) && ACCOUNT_TENANT_CALLS.some((fn) => code.includes(fn))) {
+      push(
+        'T3',
+        '這一行拿**帳號層**租戶字串去組知識資料面的 owner_id 過濾——' +
+          '正是 #108 那一行（1854 條三元組被過濾成 0）。' +
+          '知識資料面請用 knowledgeOwner(env) + ownerQuery()/ownerField()。',
+      );
+    }
+  });
+
+  return violations;
+}
+

cypher-executor/src/lib/tenant.ts

@@ -0,0 +1,144 @@
+/**
+ * 租戶字串的**唯一產地**（Arcrun#108）。
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * 這個檔案存在的理由（不是為了整潔，是為了不再犯同一個錯）
+ * ─────────────────────────────────────────────────────────────────────────────
+ * #105：`ownerNamespace(env) = env.MCP_OWNER_NAMESPACE || "leo"` ——身分來自環境變數。
+ * #108：`portalTenant(env)  = env.CONSOLE_TENANT      || "leo"` ——同一句話換一個檔案。
+ *
+ * 兩次的形狀一模一樣：**「這筆資料是誰的」與「這個請求是誰」來自兩個可以各自漂移的地方**。
+ * leo 的知識在 `owner_id=bfezv28v`（08-11 回灌時定的名，也就是他 `~/.arcrun/config.yaml`
+ * 的 `api_key`、小幫手上傳時帶的 `X-Arcrun-API-Key`），而 cypher 拿 repo 預設值 `"leo"`
+ * 去過濾 ⇒ 1854 條三元組被過濾成 0，畫面卻只寫「沒有庫」。
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * 定案：租戶字串從哪裡來
+ * ─────────────────────────────────────────────────────────────────────────────
+ * **從「寫入這批知識的那一方」來，而不是從一份手抄的環境變數預設值來。**
+ *
+ * 寫入端只有一個真相源：使用者 `~/.arcrun/config.yaml` 的 `api_key`（＝實例 namespace）。
+ * CLI 用它 push workflow（`{ns}:wf:*`）、小幫手用它上傳知識（`owner_id=ns`）、
+ * MCP 用它當 Bearer。**讀取端必須用同一個值**，否則讀寫兩端各說各話。
+ * 所以 `acr init/update` 把它注入成 `ARCRUN_NAMESPACE`（cli/src/lib/deploy.ts，
+ * 與 CF_ACCOUNT_ID / WORKER_SUBDOMAIN / MULTI_TENANT 同一批 CLI 管理值）——
+ * 它不是「使用者要自己維護的設定」，是**從既有真相源導出的值**，因此不會漂。
+ *
+ * 那為什麼不像 #105 一樣「掛在登入者身上」？因為在這個架構裡租戶**不是**每人一個：
+ * portal 帳號共用同一台實例的知識庫（design D-2，帳號自己住 `{tenant}::portal` 子
+ * namespace），帳號之間的差別是 `libraries` 權限，不是 owner_id。把 owner_id 複製一份
+ * 到每個帳號上，只會多一個可以各自過期的副本——那正是本票的病，不是解藥。
+ * #105 真正的教訓不是「一律搬到帳號上」，而是：
+ *   **過濾用的租戶字串要有單一權威來源、解析不到要誠實失敗、而且要能被機械驗證。**
+ * 這三件事就是本檔在做的事。
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * 型別即閘（`TenantId`）
+ * ─────────────────────────────────────────────────────────────────────────────
+ * `TenantId` 是 branded string，**只能**由本檔產生（`knowledgeOwner` / `tenantFromApiKey`）。
+ * 所有資料面 owner_id 過濾一律經 `ownerQuery()` / `ownerField()`，而那兩支只吃 `TenantId`
+ * ⇒ 想把「隨手一個 env 字串」拿去過濾，`tsc` 當場就不給過。
+ *
+ * 配套的機械檢查在 `scripts/check-tenant-source.mjs`（測試 `tests/tenant-gate.test.ts`
+ * 會同時驗「repo 現況乾淨」與「這道閘真的擋得住壞例子」）。
+ */
+import type { Bindings } from '../types';
+
+/**
+ * 可以拿去做資料面過濾的租戶識別。
+ *
+ * branded type：外面拿不到建構子，只能從本檔的兩支 minter 取得——
+ * 一支從實例 namespace 來（`knowledgeOwner`），一支從請求本身來（`tenantFromApiKey`）。
+ * 兩支都不含字面預設值。
+ */
+export type TenantId = string & { readonly __tenantId: unique symbol };
+
+/** 實例 namespace 解析不出來 → 誠實炸掉，不拿預設值當答案（#100「讀不到就說讀不到」同源）。 */
+export class TenantUnresolvedError extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = 'TenantUnresolvedError';
+  }
+}
+
+/**
+ * 這台實例的**知識 owner_id**——三元組 / entries / records / 藏書地圖 / 工作流 KV
+ * 全部掛在這個字串底下，由 CLI、小幫手、MCP 寫入時決定。
+ *
+ * 解析順序（**沒有字面預設值**）：
+ *   1. `ARCRUN_NAMESPACE`——`acr init/update` 從 `~/.arcrun/config.yaml` 的 `api_key` 注入。
+ *      這是寫入端用的那個值本身，因此永遠對得上。
+ *   2. `CONSOLE_TENANT`——官方 prod（`cypher.arcrun.dev`）與 #108 之前部署的實例走這條。
+ *      官方 prod 的知識確實寫在 `leo` 底下，所以對它而言這是正解；對跑過 `acr update`
+ *      的 self-hosted 實例，第 1 條會先命中。
+ *   3. 兩個都沒有 → **丟 TenantUnresolvedError**。不回 `"leo"`：那個預設值正是把
+ *      「這台機器沒設定」偽裝成「你沒有資料」的元凶。
+ */
+export function knowledgeOwner(env: Bindings): TenantId {
+  const injected = (env.ARCRUN_NAMESPACE ?? '').trim();
+  if (injected) return injected as TenantId;
+  const legacy = (env.CONSOLE_TENANT ?? '').trim();
+  if (legacy) return legacy as TenantId;
+  throw new TenantUnresolvedError(
+    '這個部署沒有知識命名空間（ARCRUN_NAMESPACE / CONSOLE_TENANT 都沒設）——' +
+      '不知道要去哪一格找資料。請跑 `acr update` 讓它從你的 ~/.arcrun/config.yaml 注入。',
+  );
+}
+
+/**
+ * 請求自帶的租戶（`X-Arcrun-API-Key`＝namespace 明碼，self-hosted 身分模型）。
+ *
+ * 這條路的租戶來自**請求本身**而不是環境變數，本來就沒有 #105/#108 的漂移問題；
+ * 收進本檔只是為了讓「所有 owner_id 過濾值都是 TenantId」這條型別閘沒有破口。
+ * 空字串不給過——沒有身分就不該有查詢範圍。
+ */
+export function tenantFromApiKey(apiKey: string): TenantId {
+  const key = (apiKey ?? '').trim();
+  if (!key) throw new TenantUnresolvedError('缺少 X-Arcrun-API-Key，無法決定查詢範圍');
+  return key as TenantId;
+}
+
+/**
+ * 帳號子 namespace 用的租戶字串（design D-2：帳號資料住 `{tenant}::portal`）。
+ *
+ * 🔴 **回傳的是 `string`，不是 `TenantId`——這是刻意的**：帳號那批資料是 cypher 自己
+ * 寫進去的（用的就是這個值），所以它自洽；但它**不可以**拿去過濾知識資料面，
+ * 否則就是把 #108 再犯一次。型別上不給過，不必靠人記得。
+ *
+ * 保留 `'leo'` 預設值是為了不動既有帳號的落點（改了會讓舊實例登不進去）。
+ */
+export function accountTenant(env: Bindings): string {
+  return env.CONSOLE_TENANT || 'leo';
+}
+
+/**
+ * KBDB query string 的 owner_id 過濾片段——**資料面過濾的唯一入口之一**。
+ * 用法：`kbdbFetch(env, `/map?${ownerQuery(tenant)}`)`
+ */
+export function ownerQuery(tenant: TenantId): string {
+  return `owner_id=${encodeURIComponent(tenant)}`;
+}
+
+/**
+ * 要放進 JSON body / URLSearchParams 的 owner_id 值——**資料面過濾的唯一入口之一**。
+ * 用法：`JSON.stringify({ owner_id: ownerField(tenant) })`
+ */
+export function ownerField(tenant: TenantId): string {
+  return tenant;
+}
+
+/**
+ * 🔴 **刻意不帶租戶範圍**的查詢片段（KBDB 慣例：`owner_id` 空值＝不過濾）。
+ *
+ * 唯一合法用途：#100 的普查——「本租戶查到 0 筆」時再問一次「整台實例到底有沒有」，
+ * 用來分辨「查不到」與「沒有」。**回傳的是統計數字，不是任何人的內容**；
+ * 拿它去撈實際資料就是跨租戶外洩。名字取得這麼長就是要讓 review 一眼看見。
+ */
+export function censusQueryAllTenants(): string {
+  return 'owner_id=';
+}
+
+/** 逐筆核對歸屬（讀回來的 record/entry 是不是這個租戶的）。缺欄位一律視為不是。 */
+export function isOwnedBy(value: unknown, tenant: TenantId): boolean {
+  return typeof value === 'string' && value === (tenant as string);
+}

cypher-executor/src/routes/console-auth.ts

@@ -35,6 +35,8 @@ import {
   readAuthStore,
   type AuthConsoleRecord,
 } from '../lib/portal-auth-store';
+// Arcrun#108：租戶字串唯一產地。
+import { knowledgeOwner } from '../lib/tenant';
 
 export const consoleAuthRouter = new Hono<{ Bindings: Bindings }>();
 
@@ -79,8 +81,17 @@ async function hashPassword(password: string, salt: string): Promise<string> {
   return h;
 }
 
+/**
+ * console 登入後下發給前端當 api_key 用的租戶字串（舊 console 的設計，與 portal 不同：
+ * portal 絕不下發，console 會）。
+ *
+ * Arcrun#108：這是**知識資料面**的 owner_id（前端拿它直打 `/kbdb/*`），所以必須與寫入端
+ * （CLI／小幫手／MCP 用的實例 namespace）同源。以前直接讀 `env.CONSOLE_TENANT || 'leo'`
+ * ⇒ 與 portal 同一個病：資料在 `bfezv28v`、過濾拿 `leo`，console 首頁的藏書地圖同樣是空的。
+ * 現在走唯一產地 `lib/tenant.ts`。
+ */
 function tenantOf(c: { env: Bindings }): string {
-  return c.env.CONSOLE_TENANT || 'leo';
+  return knowledgeOwner(c.env);
 }
 
 // ── D61：帳密的家 ─────────────────────────────────────────────────────────────

cypher-executor/src/routes/console-dashboard.ts

@@ -72,6 +72,9 @@ import {
   taipeiDayKey,
 } from '../lib/console-dashboard-model';
 import { applyTriageCheck, buildTriageModel, type TriageCheckAction } from '../lib/console-triage-model';
+// Arcrun#108：租戶字串唯一產地。console 首頁的規模數字/藏書地圖也曾因為拿 CONSOLE_TENANT
+// 過濾而看不到自己的資料——與 portal 同一個病，同一個修法。
+import { knowledgeOwner } from '../lib/tenant';
 
 export const consoleDashboardRouter = new Hono<{ Bindings: Bindings }>();
 
@@ -265,7 +268,7 @@ export async function cachedGiteaSprint(
 
 // GET /console/dashboard-data — 聚合 JSON（無需登入；唯讀、不含機敏值）
 consoleDashboardRouter.get('/console/dashboard-data', async (c) => {
-  const tenant = c.env.CONSOLE_TENANT || 'leo';
+  const tenant = knowledgeOwner(c.env); // #108：知識資料面的 owner_id 只有一個產地（lib/tenant.ts）
   const now = Date.now();
   const { base: kbdbUrl, headers: kbdbHeaders } = kbdbBase(c.env);
   const graphUrl = graphBase(c.env);
@@ -451,7 +454,7 @@ consoleDashboardRouter.get('/console/dashboard-data', async (c) => {
 // limit=1（只拿 total 欄）或現成 stats 聚合端點——不逐筆掃庫，不撞子請求上限。
 // 搜尋功能本身仍可搜全庫（資料不藏），只是規模感不再引用遺產總數。
 consoleDashboardRouter.get('/console/kb-scale-data', async (c) => {
-  const tenant = c.env.CONSOLE_TENANT || 'leo';
+  const tenant = knowledgeOwner(c.env); // #108：知識資料面的 owner_id 只有一個產地（lib/tenant.ts）
   const { base, headers } = kbdbBase(c.env);
   const now = Date.now();
   const [wikiCards, tripletTotal, embedStatus] = await Promise.all([
@@ -499,7 +502,7 @@ consoleDashboardRouter.get('/console/triage-data', async (c) => {
   const ok = await validateConsoleSession(c.env, c.req.header('authorization'));
   if (!ok) return c.json({ error: '需要登入（console session）' }, 401);
 
-  const tenant = c.env.CONSOLE_TENANT || 'leo';
+  const tenant = knowledgeOwner(c.env); // #108：知識資料面的 owner_id 只有一個產地（lib/tenant.ts）
   const [todoEntries, inboxEntries] = await Promise.all([
     fetchEntries(c.env, tenant, 'todo', 500),
     fetchEntries(c.env, tenant, 'inbox', 200),
@@ -530,7 +533,7 @@ consoleDashboardRouter.post('/console/triage-check', async (c) => {
   if (!entryId) return c.json({ error: 'entry_id 必填' }, 400);
   const action: TriageCheckAction = body?.action === 'restore' ? 'restore' : 'check';
 
-  const tenant = c.env.CONSOLE_TENANT || 'leo';
+  const tenant = knowledgeOwner(c.env); // #108：知識資料面的 owner_id 只有一個產地（lib/tenant.ts）
   const { base, headers } = kbdbBase(c.env);
 
   // 先 GET 原 entry（整串回寫的前提），順便守兩道邊界：

cypher-executor/src/routes/portal-data.ts

@@ -23,7 +23,10 @@
 import { Hono } from 'hono';
 import type { Context } from 'hono';
 import type { Bindings } from '../types';
-import { kbdbFetch, run, requirePortalUser, parseLibraries, portalTenant, hasGraphAccess, workflowsVisible, uploadEnabled, buildDiagnostics } from './portal';
+import { kbdbFetch, run, requirePortalUser, parseLibraries, hasGraphAccess, workflowsVisible, uploadEnabled, buildDiagnostics } from './portal';
+// Arcrun#108：知識資料面的租戶字串只有一個產地（lib/tenant.ts）。這裡刻意**不再** import
+// portalTenant——它是帳號層的值（回 string 不是 TenantId），拿來過濾知識就是本票的病。
+import { knowledgeOwner, ownerField, ownerQuery, isOwnedBy, censusQueryAllTenants, type TenantId } from '../lib/tenant';
 import { graphBase, graphHeaders } from './kbdb-proxy';
 import { executeWebhookGraph } from '../actions/webhook-handlers';
 
@@ -40,7 +43,9 @@ export const portalDataRouter = new Hono<{ Bindings: Bindings }>();
 
 /** 讀 tenant 的 named workflow graph（`{tenant}:wf:{name}`）。不存在/壞 record → null。 */
 async function getTenantWorkflowGraph(env: Bindings, name: string): Promise<Record<string, unknown> | null> {
-  const raw = await env.WEBHOOKS.get(`${portalTenant(env)}:wf:${name}`, 'text');
+  // #108：workflow 是 CLI `acr push` 用實例 namespace 寫進來的（`{ns}:wf:*`），
+  // 所以讀的時候也要用同一個 namespace，不是帳號層那個字串。
+  const raw = await env.WEBHOOKS.get(`${knowledgeOwner(env)}:wf:${name}`, 'text');
   if (!raw) return null;
   try {
     const rec = JSON.parse(raw) as { graph?: Record<string, unknown> };
@@ -190,9 +195,11 @@ export function findBestNodeMatch(searchTerm: string, nodeNames: string[]): stri
  * 三元組條數（KBDB `/records/triplet-stats` 真 SQL COUNT）。owner 傳 '' ＝不限租戶（KBDB 端
  * `?1 = '' OR e.owner_id = ?1`）。null＝讀不到——caller 據此不敢宣稱 0。
  */
-async function tripletCount(env: Bindings, owner: string): Promise<number | null> {
+async function tripletCount(env: Bindings, owner: TenantId | null): Promise<number | null> {
   try {
-    const res = await kbdbFetch(env, `/records/triplet-stats?owner_id=${encodeURIComponent(owner)}`);
+    // owner=null ＝ 普查全庫（#100 用來分辨「查不到」與「沒有」）。這是唯一一個
+    // 刻意不帶租戶範圍的查詢，因此走一支名字就在喊「我沒有租戶範圍」的專用 helper。
+    const res = await kbdbFetch(env, `/records/triplet-stats?${owner === null ? censusQueryAllTenants() : ownerQuery(owner)}`);
     if (!res.ok) return null;
     const body = (await res.json().catch(() => null)) as { stats?: { triplet_count?: unknown }[] } | null;
     if (!body || !Array.isArray(body.stats)) return null;
@@ -219,16 +226,16 @@ async function tripletCount(env: Bindings, owner: string): Promise<number | null
  *   owned=0 但 any>0       → owner_id / 範圍對不上，不是空庫 → 畫面說讀不到
  *   owned=null             → 讀不到 → 畫面說讀不到
  */
-async function tripletCensus(env: Bindings, tenant: string): Promise<{ owned: number | null; any: number | null }> {
+async function tripletCensus(env: Bindings, tenant: TenantId): Promise<{ owned: number | null; any: number | null }> {
   const owned = await tripletCount(env, tenant);
   if (owned !== 0) return { owned, any: null }; // 非 0（含 null）不必多問一次
-  return { owned, any: await tripletCount(env, '') };
+  return { owned, any: await tripletCount(env, null) };
 }
 
 /** 從 KBDB triplet records 找最佳比對節點名（t96 plugin fuzzy fallback 用）。 */
-async function fuzzyFindNode(env: Bindings, tenant: string, searchTerm: string): Promise<string | null> {
+async function fuzzyFindNode(env: Bindings, tenant: TenantId, searchTerm: string): Promise<string | null> {
   try {
-    const res = await kbdbFetch(env, `/records/by-template/triplet?owner_id=${encodeURIComponent(tenant)}`);
+    const res = await kbdbFetch(env, `/records/by-template/triplet?${ownerQuery(tenant)}`);
     if (!res.ok) return null;
     const body = (await res.json().catch(() => null)) as { records?: { values?: Record<string, unknown> }[] } | null;
     if (!body || !Array.isArray(body.records)) return null;
@@ -263,7 +270,7 @@ portalDataRouter.get('/portal/data/search', (c) =>
       return c.json({ success: true, entries: [], count: 0, mode: 'keyword', note: '此帳號尚未被授權任何知識庫，請聯絡管理員。' });
     }
 
-    const params = new URLSearchParams({ q, owner_id: portalTenant(c.env) });
+    const params = new URLSearchParams({ q, owner_id: ownerField(knowledgeOwner(c.env)) });
     if (!libraries.includes('*')) params.set('library', libraries.join(','));
     // 透傳的只有「在權限範圍內再收窄」的 filter；owner_id/library 上面已由 server 定死，
     // caller 傳什麼都不看（URLSearchParams 是新建的，蓋不掉）。
@@ -334,7 +341,7 @@ portalDataRouter.get('/portal/data/entries/:id', (c) =>
     const body = (await res.json()) as { entry?: { owner_id?: string | null; metadata_json?: string | null } };
     const entry = body.entry;
     if (!entry) return notFound(c);
-    if ((entry.owner_id ?? '') !== portalTenant(c.env)) return notFound(c);
+    if (!isOwnedBy(entry.owner_id, knowledgeOwner(c.env))) return notFound(c);
     if (!canReadLibrary(libraries, entryLibrary(entry))) return notFound(c);
     return c.json({ success: true, entry });
   }),
@@ -359,7 +366,7 @@ portalDataRouter.get('/portal/data/graph/neighbors/:name', (c) =>
     const nodeName = normalizeCjkQuery(c.req.param('name'));
 
     // ① tenant workflow 路徑（存在才走；input：node=path、depth=query 預設 2、namespace/owner=tenant）
-    const tenant = portalTenant(c.env);
+    const tenant = knowledgeOwner(c.env);
     const wfGraph = await getTenantWorkflowGraph(c.env, 'graph_neighbors');
     if (wfGraph) {
       const depthRaw = c.req.query('depth') ?? '';
@@ -420,9 +427,9 @@ portalDataRouter.get('/portal/data/graph/overview', (c) =>
     if (!(await hasGraphAccess(c.env, libraries))) {
       return c.json({ error: '無知識圖譜檢視權限' }, 403);
     }
-    const tenant = portalTenant(c.env);
+    const tenant = knowledgeOwner(c.env);
     const [res, census] = await Promise.all([
-      kbdbFetch(c.env, `/records/by-template/triplet?owner_id=${encodeURIComponent(tenant)}&limit=500`),
+      kbdbFetch(c.env, `/records/by-template/triplet?${ownerQuery(tenant)}&limit=500`),
       tripletCensus(c.env, tenant),
     ]);
     const tripletsTotal = census.owned;
@@ -505,7 +512,7 @@ portalDataRouter.get('/portal/data/chat', (c) =>
       wfGraph,
       { question },
       'rag_chat',
-      portalTenant(c.env),
+      knowledgeOwner(c.env),
       c.executionCtx,
     );
     if (!result.success) {
@@ -611,7 +618,7 @@ portalDataRouter.get('/portal/data/workflows', (c) =>
     // 資料源與 /webhooks/named ＋ /workflows/:name/executions 同一份（WEBHOOKS/ANALYTICS KV）。
     // 不經 HTTP 打自己（global_fetch_strictly_public 下 fetch 自己 hostname 會 self-loop），
     // 直讀同 worker 的 KV binding；欄位收斂成唯讀展示需要的最小集合。
-    const tenant = portalTenant(c.env);
+    const tenant = knowledgeOwner(c.env);
     const prefix = `${tenant}:wf:`;
     const list = await c.env.WEBHOOKS.list({ prefix });
     const workflows = await Promise.all(
@@ -637,7 +644,7 @@ portalDataRouter.get('/portal/data/workflows', (c) =>
         let last_execution: { timestamp: string; verdict?: string } | null = null;
         const execRes = await kbdbFetch(
           c.env,
-          `/execution-log/latest?${new URLSearchParams({ workflow_id: name, owner_id: tenant }).toString()}`,
+          `/execution-log/latest?${new URLSearchParams({ workflow_id: name, owner_id: ownerField(tenant) }).toString()}`,
         );
         const execBody = await execRes.json().catch(() => null) as {
           success?: boolean;
@@ -691,25 +698,42 @@ function recordLibrary(values: Record<string, unknown> | undefined): string | nu
 /** record 可讀？租戶要對；有標 library 的還要在用戶庫集合內。 */
 function canReadRecord(
   rec: { values?: Record<string, unknown>; owner_id?: string | null },
-  tenant: string,
+  tenant: TenantId,
   libraries: string[],
 ): boolean {
-  if ((rec.owner_id ?? '') !== tenant) return false;
+  if (!isOwnedBy(rec.owner_id, tenant)) return false;
   const lib = recordLibrary(rec.values);
   return lib === null || canReadLibrary(libraries, lib);
 }
 
 // GET /portal/data/map — 藏書地圖全館視圖，**只回這個帳號有權限的庫**。
 // KBDB 的 /map 對權限無知（它回全館），過濾在這裡做——MCP 不得比 portal 同一個帳號看得更多。
+//
+// 🔴 Arcrun#108：一張空地圖有四種成因，**判準留在 server，不留給前端猜**
+//    （沿 #100 總圖那條「讀不到就說讀不到」，同一套 census 機制）：
+//      no_library_grant ：這個帳號一個庫都沒被授權 → 是權限問題，不是資料問題
+//      filtered_out     ：實例有庫，但都不在這個帳號的權限內 → 正常且正確的隔離
+//      confirmed_empty  ：實例真的一條三元組都沒有 → **只有此時**才准說「還沒有知識」
+//      scope_mismatch   ：實例有三元組，但本命名空間一條都撈不到 → **命名空間對不上**
+//                        （就是本票：1854 條在 bfezv28v，卻拿 "leo" 去過濾）
+//    scope_mismatch 這一格以前不存在，所以設定錯誤被畫成「你沒有資料」——leo 看到的空地圖。
+//
+// ⚠️ 回應**絕不含租戶字串**（design §3.3 紅線：前端拿到租戶字串就能繞過庫過濾直打 /kbdb/*）。
+//    只回代碼與數字，文字說明講「請通知管理員」，命名空間本身不下發。
 portalDataRouter.get('/portal/data/map', (c) =>
   run(c, async () => {
     const auth = await requirePortalUser(c);
     if (!auth.ok) return auth.res;
     const libraries = parseLibraries(auth.user.values.libraries);
     if (libraries.length === 0) {
-      return c.json({ success: true, libraries: [], count: 0, note: '此帳號尚未被授權任何知識庫，請聯絡管理員。' });
+      return c.json({
+        success: true, libraries: [], count: 0,
+        empty_confirmed: true, empty_reason: 'no_library_grant',
+        note: '此帳號尚未被授權任何知識庫，請聯絡管理員。',
+      });
     }
-    const res = await kbdbFetch(c.env, `/map?owner_id=${encodeURIComponent(portalTenant(c.env))}`);
+    const tenant = knowledgeOwner(c.env);
+    const res = await kbdbFetch(c.env, `/map?${ownerQuery(tenant)}`);
     if (!res.ok) {
       return new Response(res.body, { status: res.status, headers: { 'Content-Type': 'application/json' } });
     }
@@ -720,7 +744,42 @@ portalDataRouter.get('/portal/data/map', (c) =>
     const allowed = body.libraries.filter(
       (l) => typeof l?.library === 'string' && canReadLibrary(libraries, l.library),
     );
-    return c.json({ success: true, libraries: allowed, count: allowed.length });
+    if (allowed.length > 0) {
+      return c.json({ success: true, libraries: allowed, count: allowed.length, empty_confirmed: false, empty_reason: null });
+    }
+    // 以下都是「回空」的路徑——多花一次查詢換一個**有根據**的理由，不猜。
+    if (body.libraries.length > 0) {
+      // 命名空間對得上（撈得到庫），只是這個帳號沒有那些庫的權限＝隔離正常運作。
+      return c.json({
+        success: true, libraries: [], count: 0,
+        empty_confirmed: true, empty_reason: 'filtered_out',
+        note: '這個帳號目前沒有任何知識庫的檢視權限，請聯絡管理員開通。',
+      });
+    }
+    const census = await tripletCensus(c.env, tenant);
+    if (census.owned === null || (census.owned === 0 && census.any === null)) {
+      return c.json({
+        success: true, libraries: [], count: 0,
+        empty_confirmed: false, empty_reason: 'unreadable',
+        note: '讀不到知識庫的統計，無法確認庫裡有沒有東西——這不是「還沒有知識」，是這次讀取失敗。請稍後重整或通知管理員。',
+      });
+    }
+    if (census.owned === 0 && (census.any ?? 0) > 0) {
+      return c.json({
+        success: true, libraries: [], count: 0,
+        empty_confirmed: false, empty_reason: 'scope_mismatch',
+        instance_triplet_count: census.any,
+        note:
+          `讀不到你這個帳號範圍內的藏書——但這台實例裡有 ${census.any} 條知識關聯。` +
+          '這不是「還沒有知識」，不用去重新上傳；比較像知識的歸屬命名空間對不上。' +
+          '請通知管理員跑一次 `acr update`（會把你安裝時的命名空間同步給雲端），或檢查 ARCRUN_NAMESPACE 設定。',
+      });
+    }
+    return c.json({
+      success: true, libraries: [], count: 0,
+      empty_confirmed: true, empty_reason: 'confirmed_empty',
+      note: '知識庫還沒有任何內容——上傳文件後就會出現在這裡。',
+    });
   }),
 );
 
@@ -734,7 +793,7 @@ portalDataRouter.get('/portal/data/map/:library', (c) =>
     if (!canReadLibrary(libraries, library)) return notFound(c);
     const res = await kbdbFetch(
       c.env,
-      `/map/${encodeURIComponent(library)}?owner_id=${encodeURIComponent(portalTenant(c.env))}`,
+      `/map/${encodeURIComponent(library)}?${ownerQuery(knowledgeOwner(c.env))}`,
     );
     if (res.status === 404) return notFound(c);
     if (!res.ok) return c.json({ error: `KBDB 回錯（HTTP ${res.status}）` }, 502);
@@ -775,7 +834,7 @@ portalDataRouter.post('/portal/data/templates', (c) =>
         name: body.name,
         slots: body.slots,
         description: typeof body.description === 'string' ? body.description : undefined,
-        created_by: portalTenant(c.env),
+        created_by: knowledgeOwner(c.env),
       }),
     });
     return new Response(res.body, { status: res.status, headers: { 'Content-Type': 'application/json' } });
@@ -790,10 +849,10 @@ portalDataRouter.get('/portal/data/records/by-template/:template', (c) =>
     if (!auth.ok) return auth.res;
     const libraries = parseLibraries(auth.user.values.libraries);
     if (libraries.length === 0) return c.json({ success: true, records: [], count: 0 });
-    const tenant = portalTenant(c.env);
+    const tenant = knowledgeOwner(c.env);
     const res = await kbdbFetch(
       c.env,
-      `/records/by-template/${encodeURIComponent(c.req.param('template'))}?owner_id=${encodeURIComponent(tenant)}`,
+      `/records/by-template/${encodeURIComponent(c.req.param('template'))}?${ownerQuery(tenant)}`,
     );
     if (!res.ok) return c.json({ error: `KBDB 回錯（HTTP ${res.status}）` }, 502);
     const body = (await res.json().catch(() => null)) as
@@ -824,7 +883,7 @@ portalDataRouter.get('/portal/data/records/:recordId', (c) =>
       | null;
     const record = body?.record;
     if (!record) return notFound(c);
-    if (!canReadRecord(record, portalTenant(c.env), libraries)) return notFound(c);
+    if (!canReadRecord(record, knowledgeOwner(c.env), libraries)) return notFound(c);
     return c.json({ success: true, record });
   }),
 );
@@ -856,7 +915,7 @@ portalDataRouter.post('/portal/data/records', (c) =>
     const res = await kbdbFetch(c.env, '/records', {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({ template: body.template, values, owner_id: portalTenant(c.env) }),
+      body: JSON.stringify({ template: body.template, values, owner_id: ownerField(knowledgeOwner(c.env)) }),
     });
     return new Response(res.body, { status: res.status, headers: { 'Content-Type': 'application/json' } });
   }),
@@ -884,7 +943,7 @@ portalDataRouter.get('/portal/data/diagnostics', (c) =>
   run(c, async () => {
     const auth = await requirePortalUser(c);
     if (!auth.ok) return auth.res;
-    const tenant = portalTenant(c.env);
+    const tenant = knowledgeOwner(c.env);
     const core = await buildDiagnostics(c.env, tenant);
     return c.json({
       generated_at: new Date().toISOString(),

cypher-executor/src/routes/portal.ts

@@ -25,6 +25,9 @@ import { kbdbBase } from './kbdb-proxy';
 import { validateConsoleSession } from './console-auth';
 import { hashPassword, verifyPassword, randomHex, generatePassword, sha256Hex } from '../lib/portal-auth';
 import { PORTAL_TEMPLATE_SEEDS } from '../lib/portal-seeds';
+// Arcrun#108：租戶字串只有一個產地（lib/tenant.ts）。帳號面用 accountTenant（普通 string），
+// 知識資料面用 knowledgeOwner（TenantId）——型別分家，拿錯編不過。
+import { accountTenant, knowledgeOwner, ownerField, ownerQuery, tenantFromApiKey, TenantUnresolvedError, type TenantId } from '../lib/tenant';
 // arcrun-rag#10：/portal/admin/ai 存 Gemini key 走 credentials.ts 的**唯一**寫入路徑，
 // 不在 portal 這層另造第二套儲存（D36：值進 Workers Secret，D1 只留 ref）。
 import { storeCredential, hasCredential } from './credentials';
@@ -58,14 +61,27 @@ export const LIBRARY_TEMPLATE = 'portal_library';
 
 // ── 基礎 helpers ────────────────────────────────────────────────────────────
 
-/** 租戶字串（＝知識資料的 owner_id）。預設沿 console-auth 同款 'leo'。**只在 server 側使用，永不下發前端**。 */
+/**
+ * 帳號層的租戶字串（**不是**知識資料的 owner_id，Arcrun#108 拆開）。
+ *
+ * 只用來組帳號子 namespace（`{tenant}::portal`，design D-2）與 cypher 自己寫的設定
+ * （extractor_config / credentials 目錄）——那些都是 cypher 用同一個值寫進去的，所以自洽。
+ *
+ * 🔴 **不可以拿它過濾知識資料面**（三元組 / entries / records / 藏書地圖 / 工作流）：
+ * 那批是 CLI／小幫手用實例 namespace 寫的，兩者對不上就是 #108
+ * （leo 的 1854 條被 `CONSOLE_TENANT="leo"` 過濾成 0）。資料面請用
+ * `lib/tenant.ts` 的 `knowledgeOwner(env)`——它回 `TenantId`，本函式回 `string`，
+ * 型別上就分得開，不必靠人記得。
+ *
+ * **只在 server 側使用，永不下發前端**。
+ */
 export function portalTenant(env: Bindings): string {
-  return env.CONSOLE_TENANT || 'leo';
+  return accountTenant(env);
 }
 
 /** 帳號子 namespace（design D-2）。 */
 function portalNamespace(env: Bindings): string {
-  return `${portalTenant(env)}::portal`;
+  return `${accountTenant(env)}::portal`;
 }
 
 function sessionTtl(env: Bindings): number {
@@ -102,6 +118,11 @@ export async function run(c: Context<{ Bindings: Bindings }>, fn: () => Promise<
     if (e instanceof AuthStoreWriteError) {
       return c.json({ error: `認證儲存寫入失敗：${e.message}`, code: 'auth_store_not_writable' }, 502);
     }
+    // Arcrun#108：連「這台實例的知識放在哪一格」都解析不出來 → 誠實講「讀不到」，
+    // 不拿 repo 預設值當答案然後回一頁空的（那正是本票的病：設定缺失被畫成「你沒有資料」）。
+    if (e instanceof TenantUnresolvedError) {
+      return c.json({ error: e.message, code: 'tenant_unresolved' }, 500);
+    }
     if (e instanceof KbdbError) return c.json({ error: `KBDB 不可達或回錯：${e.message}` }, 502);
     throw e;
   }
@@ -1409,7 +1430,6 @@ portalRouter.post('/portal/daemon/config', (c) =>
       return c.json({ error: 'email 或密碼錯誤' }, 401);
     }
     await clearLoginFail(c.env, email);
-    const tenant = portalTenant(c.env);
     // t176（leo 08-03 架構翻案）：**不再下發任何 LLM 設定**（extractor／金鑰／模型）。
     // 地端用哪個模型、哪把金鑰，由使用者在同步小幫手的托盤「AI 設定…」自己設。
     //
@@ -1422,9 +1442,12 @@ portalRouter.post('/portal/daemon/config', (c) =>
     //
     // ⚠️ 只拔 LLM 欄位——連線欄位（cypher_url／namespace／library）與本 route 本身照舊，
     // daemon 靠它上線；資料夾/庫管理（daemon/libraries）也完全不動（leo 明確劃界）。
+    // #108：這裡下發給小幫手的 namespace 決定了它把知識**寫**到哪一格。
+    // 以前給的是帳號層字串（CONSOLE_TENANT），與 CLI／MCP 用的實例 namespace 是兩個來源
+    // ⇒ 寫進去的地方和讀出來的地方可以各自漂。改成同一個 knowledgeOwner，一台實例一個值。
     const daemonCfg: Record<string, string> = {
       cypher_url: new URL(c.req.url).origin,
-      namespace: tenant,
+      namespace: knowledgeOwner(c.env),
       library: 'kb',
       email,
       instance_name: String(rec.values.display_name ?? ''),
@@ -1456,7 +1479,7 @@ portalRouter.post('/portal/admin/chat-key', (c) =>
     const body = (await c.req.json().catch(() => null)) as { key?: string } | null;
     const key = String(body?.key ?? '').trim();
     if (!key) return c.json({ error: '請貼上你的 Google AI 金鑰' }, 400);
-    const tenant = portalTenant(c.env);
+    const tenant = knowledgeOwner(c.env);
     const kvKey = `${tenant}:wf:rag_chat`;
     const raw = await c.env.WEBHOOKS.get(kvKey, 'text');
     if (!raw) return c.json({ error: '這個實例沒有安裝 AI 問答工作流' }, 404);
@@ -1518,8 +1541,8 @@ portalRouter.get('/portal/admin/libraries', (c) =>
     // t142：資料面實際出現的庫＋統計數字（卡數、三元組數）並行撈取，避免 N+1。
     // 任一端點失敗不擋登記簿列表（誠實降級：stats 保持 0，不炸主流程）。
     try {
-      const tenant = portalTenant(c.env);
+      const tenant = knowledgeOwner(c.env);
-      const ownerParam = `owner_id=${encodeURIComponent(tenant)}`;
+      const ownerParam = ownerQuery(tenant);
       const [autoRes, cardRes, tripletRes] = await Promise.all([
         kbdbFetch(c.env, `/entries/libraries?${ownerParam}`).catch(() => null),
         kbdbFetch(c.env, `/entries/library-stats?${ownerParam}`).catch(() => null),
@@ -1712,8 +1735,8 @@ portalRouter.get('/portal/admin/execution-log-retention', (c) =>
   run(c, async () => {
     const auth = await requirePortalAdmin(c);
     if (!auth.ok) return auth.res;
-    const ownerId = portalTenant(c.env);
+    const ownerId = knowledgeOwner(c.env);
-    const res = await kbdbFetch(c.env, `/execution-log/retention?owner_id=${encodeURIComponent(ownerId)}`);
+    const res = await kbdbFetch(c.env, `/execution-log/retention?${ownerQuery(ownerId)}`);
     if (!res.ok) throw new KbdbError(`GET /execution-log/retention → ${res.status}`);
     const data = (await res.json()) as { retention_days?: number | null; default_days?: number };
     return c.json({ success: true, retention_days: data.retention_days ?? null, default_days: data.default_days ?? 90 });
@@ -1732,10 +1755,10 @@ portalRouter.put('/portal/admin/execution-log-retention', (c) =>
     if (days !== null && days !== undefined && (typeof days !== 'number' || !Number.isFinite(days) || days <= 0)) {
       return c.json({ error: 'retention_days 必須是正整數，或 null（代表不刪除）' }, 400);
     }
-    const ownerId = portalTenant(c.env);
+    const ownerId = knowledgeOwner(c.env);
     const res = await kbdbFetch(c.env, '/execution-log/retention', {
       method: 'PUT',
-      body: JSON.stringify({ owner_id: ownerId, retention_days: days === undefined ? null : days }),
+      body: JSON.stringify({ owner_id: ownerField(ownerId), retention_days: days === undefined ? null : days }),
     });
     if (!res.ok) throw new KbdbError(`PUT /execution-log/retention → ${res.status}`);
     const data = (await res.json()) as { retention_days?: number | null };
@@ -1756,10 +1779,10 @@ portalRouter.delete('/portal/admin/libraries/by-name/:name', (c) =>
     const confirm = String(body?.confirm ?? '').trim();
     if (!confirm) return c.json({ error: 'body 須帶 { confirm: "<庫名>" } 才執行（移除會影響資料可搜性）' }, 400);
     if (confirm !== name) return c.json({ error: `confirm 值「${confirm}」與庫名「${name}」不符` }, 400);
-    const ownerId = portalTenant(c.env);
+    const ownerId = knowledgeOwner(c.env);
     const res = await kbdbFetch(c.env, '/entries/deprecate-by-library', {
       method: 'PATCH',
-      body: JSON.stringify({ owner_id: ownerId, library: name }),
+      body: JSON.stringify({ owner_id: ownerField(ownerId), library: name }),
     });
     if (!res.ok) throw new KbdbError(`PATCH /entries/deprecate-by-library → ${res.status}`);
     const data = (await res.json()) as { deprecated_count?: number };
@@ -1850,16 +1873,19 @@ export interface DiagnosticsCore {
   notes: string[];
 }
 
-/** tenant＝owner_id（session 版傳 portalTenant(env)；daemon 版傳 X-Arcrun-API-Key 原值，見下方呼叫端）。 */
+/**
-export async function buildDiagnostics(env: Bindings, tenant: string): Promise<DiagnosticsCore> {
+ * tenant＝owner_id（session 版傳 `knowledgeOwner(env)`；daemon 版傳 `tenantFromApiKey(header)`）。
+ * #108：型別收成 `TenantId`——診斷檔要是報了另一個命名空間的統計，等於用假數字排查真問題。
+ */
+export async function buildDiagnostics(env: Bindings, tenant: TenantId): Promise<DiagnosticsCore> {
   const notes: string[] = [];
 
   // ① embed 模組健康狀態（backfillStatus + selfTest，兩支都活在 KBDB 那面牆內）。
   let embedding: Record<string, unknown> = { checked: false };
   try {
     const [statusRes, selftestRes] = await Promise.all([
-      kbdbFetch(env, `/embed/backfill/status?${new URLSearchParams({ owner_id: tenant }).toString()}`),
+      kbdbFetch(env, `/embed/backfill/status?${ownerQuery(tenant)}`),
-      kbdbFetch(env, `/embed/selftest?${new URLSearchParams({ owner_id: tenant }).toString()}`),
+      kbdbFetch(env, `/embed/selftest?${ownerQuery(tenant)}`),
     ]);
     const statusBody = (await statusRes.json().catch(() => null)) as
       | { success?: boolean; enabled?: boolean; pending?: number; embedded?: number }
@@ -1895,7 +1921,7 @@ export async function buildDiagnostics(env: Bindings, tenant: string): Promise<D
   //   - GET /records/triplet-stats：per-library 即時聚合 SQL（t142，COUNT，非快取）。
   let library_count = 0;
   let triplet_count = 0;
-  const ownerParam = new URLSearchParams({ owner_id: tenant }).toString();
+  const ownerParam = ownerQuery(tenant);
   try {
     const [registeredLibs, autoRes, tripletRes] = await Promise.all([
       listRecordsByTemplate(env, LIBRARY_TEMPLATE).catch(() => []),
@@ -1929,7 +1955,7 @@ export async function buildDiagnostics(env: Bindings, tenant: string): Promise<D
   let library_scope_check: Record<string, unknown> = { ran: false };
   if (library_count === 0 && triplet_count === 0) {
     try {
-      const probeRes = await kbdbFetch(env, `/entries?${new URLSearchParams({ owner_id: tenant, limit: '1' }).toString()}`);
+      const probeRes = await kbdbFetch(env, `/entries?${new URLSearchParams({ owner_id: ownerField(tenant), limit: '1' }).toString()}`);
       const probeBody = (await probeRes.json().catch(() => null)) as { total?: number } | null;
       const total = probeBody?.total ?? 0;
       library_scope_check = {
@@ -1976,7 +2002,8 @@ portalRouter.get('/portal/daemon/diagnostics', (c) =>
   run(c, async () => {
     const apiKey = (c.req.header('X-Arcrun-API-Key') ?? '').trim();
     if (!apiKey) return c.json({ error: '缺少 X-Arcrun-API-Key header' }, 401);
-    const core = await buildDiagnostics(c.env, apiKey);
+    // 這條路的租戶來自**請求本身**（小幫手帶的 namespace），不是環境變數 → 沒有 #108 的漂移問題。
+    const core = await buildDiagnostics(c.env, tenantFromApiKey(apiKey));
     return c.json({
       generated_at: new Date().toISOString(),
       instance_url: new URL(c.req.url).origin,

cypher-executor/src/types.ts

@@ -91,6 +91,20 @@ export type Bindings = {
   // console 登入後端一律用這個字串打 /kbdb/*、/workflows/search（不做多租戶，登入系統只擋外人看頁面）。
   // 未設 → routes/console-auth.ts 預設 "leo"（發現①已核實：D1 458,357 筆資料實際使用的租戶字串）。
   CONSOLE_TENANT?: string;
+  /**
+   * 這台實例的**知識命名空間**（Arcrun#108）＝使用者 `~/.arcrun/config.yaml` 的 `api_key`。
+   *
+   * 由 `acr init/update`（cli/src/lib/deploy.ts CLI_MANAGED_VARS）自動注入，**使用者不必手動維護**：
+   * 它就是 CLI push workflow（`{ns}:wf:*`）、小幫手上傳知識（`owner_id=ns`）、MCP Bearer
+   * 用的同一個值 ⇒ 讀取端用它過濾，永遠對得上寫入端。
+   *
+   * 為什麼不沿用 `CONSOLE_TENANT`：那是 repo toml 帶的**官方 prod 值**（`leo`），
+   * self-hosted 實例的資料根本不在它底下（#108 實撞：1854 條被過濾成 0），
+   * 而且 `CONSOLE_TENANT` 同時還是帳號子 namespace（`{tenant}::portal`）的組成，
+   * 改它會讓舊實例登不進去。兩件事拆成兩個 var，各自對應各自的真相源。
+   * 解析邏輯只在 `src/lib/tenant.ts`（唯一產地，機械閘看守）。
+   */
+  ARCRUN_NAMESPACE?: string;
   // Console 顯示品牌／實例名（Arcrun#21 rebrand，非機密）。只影響 UI 字樣（title/header/logo），
   // 不影響任何行為。未設 → "Arcrun"（console 是引擎共用件，不寫死產品名）。
   // 實例可覆蓋，例：arcrun-rag demo 可設 --var CONSOLE_BRAND:"Arcrun RAG"。

cypher-executor/tests/library-map-scope-108.test.ts

@@ -0,0 +1,261 @@
+/**
+ * Arcrun#108 — 藏書地圖看得到自己的知識（租戶字串來源收斂）。
+ *
+ * 釘住的事實：
+ *   1. 資料面 owner_id 來自 `knowledgeOwner(env)`：`ARCRUN_NAMESPACE` 優先、`CONSOLE_TENANT` 回退、
+ *      兩者皆無 → 丟 TenantUnresolvedError（**沒有 `|| 'leo'` 這種靜默預設值**）。
+ *   2. `/portal/data/map` 真的拿那個值去打 KBDB（leo 的情境：ARCRUN_NAMESPACE=bfezv28v
+ *      → 打 `owner_id=bfezv28v` 拿回 9 個庫，而不是打 `owner_id=leo` 拿回 0 個）。
+ *   3. **權限沒有被拿掉**：同一份 KBDB 回應，庫權限 ["kb"] 的帳號只看得到 kb。
+ *   4. 空地圖分得出四種成因（#100 那條「讀不到就說讀不到」延伸到藏書地圖）：
+ *      no_library_grant / filtered_out / scope_mismatch / confirmed_empty。
+ *   5. 回應**不含租戶字串**（design §3.3 紅線：前端拿到就能繞過庫過濾直打 /kbdb/*）。
+ */
+import { env, fetchMock } from 'cloudflare:test';
+import { beforeAll, afterEach, describe, it, expect } from 'vitest';
+import { knowledgeOwner, accountTenant, TenantUnresolvedError, ownerQuery, censusQueryAllTenants } from '../src/lib/tenant';
+import { portalDataRouter } from '../src/routes/portal-data';
+import type { Bindings } from '../src/types';
+
+const KBDB = 'https://kbdb.test';
+/** leo 的真實命名空間（2026-08-11 回灌時定名，見 Leo/mira#8）。 */
+const LEO_NS = 'bfezv28v';
+
+beforeAll(() => {
+  fetchMock.activate();
+  fetchMock.disableNetConnect();
+});
+afterEach(() => fetchMock.assertNoPendingInterceptors());
+
+/**
+ * 直接餵 router 一份 env（不是 SELF.fetch）——`cloudflare:test` 的 `env` 物件改了不會傳進
+ * SELF 那個 worker（實測：改 ARCRUN_BUNDLE_VERSION 後 /health 仍回舊值），
+ * 而本票要驗的正是「換一個命名空間，查詢就跟著換」。Hono router 吃 env 參數，
+ * 走的是同一支 handler、同一條 KBDB fetch，只有 env 這一項是測試給的。
+ */
+const ctx = { waitUntil: () => {}, passThroughOnException: () => {} } as unknown as ExecutionContext;
+
+async function seedSession(token: string, recordId: string) {
+  await env.SESSIONS_KV.put(`portal_sess:${token}`, JSON.stringify({ record_id: recordId }));
+}
+
+function mockGetRecord(recordId: string, libraries: string) {
+  fetchMock
+    .get(KBDB)
+    .intercept({ path: `/records/${recordId}`, method: 'GET' })
+    .reply(200, {
+      success: true,
+      record: {
+        record_id: recordId,
+        template_id: 'tpl_pu',
+        values: {
+          email: 'leo@example.com',
+          display_name: 'leo',
+          status: 'active',
+          role: 'admin',
+          password_hash: 'pbkdf2-sha256$600000$AA$BB',
+          libraries,
+          created_at: '2026-08-12T00:00:00.000Z',
+          updated_at: '2026-08-12T00:00:00.000Z',
+        },
+      },
+    });
+}
+
+/** 攔 `/map`，同時把「實際被查詢的 owner_id」記下來給斷言用。 */
+function mockMap(libraries: { library: string; triplet_count: number }[], seen: string[]) {
+  fetchMock
+    .get(KBDB)
+    .intercept({
+      path: (p: string) => {
+        if (!p.startsWith('/map')) return false;
+        seen.push(new URL(p, KBDB).searchParams.get('owner_id') ?? '');
+        return true;
+      },
+      method: 'GET',
+    })
+    .reply(200, { success: true, libraries, count: libraries.length });
+}
+
+function mockTripletStats(match: (ownerId: string) => boolean, tripletCount: number) {
+  fetchMock
+    .get(KBDB)
+    .intercept({
+      path: (p: string) =>
+        p.startsWith('/records/triplet-stats') && match(new URL(p, KBDB).searchParams.get('owner_id') ?? ''),
+      method: 'GET',
+    })
+    .reply(200, { success: true, stats: [{ library: 'kb', triplet_count: tripletCount }] });
+}
+
+async function getMap(token: string, overrides: Partial<Bindings> = {}) {
+  const res = await portalDataRouter.fetch(
+    new Request('http://localhost/portal/data/map', { headers: { authorization: `Bearer ${token}` } }),
+    { ...env, ...overrides } as Bindings,
+    ctx,
+  );
+  return { status: res.status, body: (await res.json()) as Record<string, unknown> };
+}
+
+/** undici 的 path matcher 可能被呼叫多次 → 比對前先去重（我們在意的是「查了哪些 owner_id」）。 */
+const distinct = (xs: string[]): string[] => [...new Set(xs)];
+
+// ── ① 唯一產地的解析順序 ───────────────────────────────────────────────────────
+
+describe('knowledgeOwner：租戶字串只有一個產地，且沒有靜默預設值', () => {
+  it('ARCRUN_NAMESPACE 優先（＝acr update 從 ~/.arcrun/config.yaml 的 api_key 注入的那個值）', () => {
+    expect(knowledgeOwner({ ARCRUN_NAMESPACE: LEO_NS, CONSOLE_TENANT: 'leo' } as Bindings)).toBe(LEO_NS);
+  });
+
+  it('沒注入 → 回退 CONSOLE_TENANT（官方 prod 與尚未 acr update 的實例，行為一字不變）', () => {
+    expect(knowledgeOwner({ CONSOLE_TENANT: 'leo' } as Bindings)).toBe('leo');
+  });
+
+  it('空字串不算數（部署把 var 設成空字串 ≠ 有設定）', () => {
+    expect(knowledgeOwner({ ARCRUN_NAMESPACE: '   ', CONSOLE_TENANT: 'leo' } as Bindings)).toBe('leo');
+  });
+
+  it('兩個都沒有 → 丟 TenantUnresolvedError，**不回 "leo"**（靜默預設值正是本票的病）', () => {
+    expect(() => knowledgeOwner({} as Bindings)).toThrow(TenantUnresolvedError);
+  });
+
+  it('帳號層 accountTenant 不受影響（改它會讓舊實例登不進去，所以刻意不動）', () => {
+    expect(accountTenant({ ARCRUN_NAMESPACE: LEO_NS, CONSOLE_TENANT: 'leo' } as Bindings)).toBe('leo');
+    expect(accountTenant({} as Bindings)).toBe('leo');
+  });
+
+  it('過濾片段只有兩種形狀：帶租戶的 ownerQuery，與明著喊全庫的普查', () => {
+    expect(ownerQuery(knowledgeOwner({ ARCRUN_NAMESPACE: 'a b' } as Bindings))).toBe('owner_id=a%20b');
+    expect(censusQueryAllTenants()).toBe('owner_id=');
+  });
+});
+
+// ── ② 地圖真的用那個 owner_id 去查 ─────────────────────────────────────────────
+
+describe('GET /portal/data/map — leo 的情境（1854 條 → 看得到，不是 0 個庫）', () => {
+  it('注入 ARCRUN_NAMESPACE 後，KBDB 收到的 owner_id 是它，而且庫都回得來', async () => {
+    await seedSession('t-map-1', 'rec_leo');
+    mockGetRecord('rec_leo', '["*"]');
+    const seen: string[] = [];
+    mockMap(
+      [
+        { library: 'kb', triplet_count: 1851 },
+        { library: 'general', triplet_count: 3 },
+      ],
+      seen,
+    );
+
+    const { status, body } = await getMap('t-map-1', { ARCRUN_NAMESPACE: LEO_NS });
+    expect(status).toBe(200);
+    expect(distinct(seen)).toEqual([LEO_NS]); // ← 這一行就是本票：以前送出去的是 'leo'
+    expect(body.count).toBe(2);
+    expect((body.libraries as { library: string; triplet_count: number }[]).map((l) => l.triplet_count))
+      .toEqual([1851, 3]);
+    expect(body.empty_reason).toBeNull();
+  });
+
+  it('回應不含租戶字串（前端拿到就能繞過庫過濾直打 /kbdb/*——design §3.3 紅線）', async () => {
+    await seedSession('t-map-2', 'rec_leo2');
+    mockGetRecord('rec_leo2', '["*"]');
+    mockMap([{ library: 'kb', triplet_count: 1851 }], []);
+
+    const { body } = await getMap('t-map-2', { ARCRUN_NAMESPACE: LEO_NS });
+    expect(JSON.stringify(body)).not.toContain(LEO_NS);
+    expect(JSON.stringify(body)).not.toContain('ARCRUN_NAMESPACE');
+  });
+
+  it('沒注入時沿用 CONSOLE_TENANT（未跑 acr update 的實例行為不變，這次改動對它是惰性的）', async () => {
+    await seedSession('t-map-3', 'rec_leo3');
+    mockGetRecord('rec_leo3', '["*"]');
+    const seen: string[] = [];
+    mockMap([{ library: 'kb', triplet_count: 1 }], seen);
+
+    await getMap('t-map-3');
+    expect(distinct(seen)).toEqual(['leo']); // wrangler.test.toml CONSOLE_TENANT
+  });
+});
+
+// ── ③ 權限沒有被拿掉（紅線：修這題不准把 owner_id 過濾或庫過濾拆掉）──────────────
+
+describe('權限：只被授權部分庫的帳號，只看得到那幾個庫', () => {
+  it('libraries=["kb"] → 同一份 KBDB 回應裡只剩 kb', async () => {
+    await seedSession('t-perm-1', 'rec_partial');
+    mockGetRecord('rec_partial', '["kb"]');
+    mockMap(
+      [
+        { library: 'kb', triplet_count: 1851 },
+        { library: 'finance', triplet_count: 42 },
+        { library: 'general', triplet_count: 3 },
+      ],
+      [],
+    );
+
+    const { body } = await getMap('t-perm-1', { ARCRUN_NAMESPACE: LEO_NS });
+    expect((body.libraries as { library: string }[]).map((l) => l.library)).toEqual(['kb']);
+    expect(body.count).toBe(1);
+  });
+
+  it('一個庫都沒被授權 → 不打 KBDB，誠實說是權限問題', async () => {
+    await seedSession('t-perm-2', 'rec_nolib');
+    mockGetRecord('rec_nolib', '[]');
+    const { body } = await getMap('t-perm-2'); // 沒有 mockMap：打了就會 assertNoPendingInterceptors 失敗
+    expect(body.count).toBe(0);
+    expect(body.empty_reason).toBe('no_library_grant');
+    expect(body.empty_confirmed).toBe(true);
+  });
+
+  it('實例有庫但都不在權限內 → filtered_out（是隔離正常，不是資料不見）', async () => {
+    await seedSession('t-perm-3', 'rec_other');
+    mockGetRecord('rec_other', '["finance"]');
+    mockMap([{ library: 'kb', triplet_count: 1851 }], []);
+
+    const { body } = await getMap('t-perm-3', { ARCRUN_NAMESPACE: LEO_NS });
+    expect(body.empty_reason).toBe('filtered_out');
+    expect(body.empty_confirmed).toBe(true);
+  });
+});
+
+// ── ④ 空地圖的四種成因分得出來（不再把設定錯誤畫成「你沒有資料」）────────────────
+
+describe('空地圖：分得出「讀不到」與「沒有」', () => {
+  it('命名空間對不上（本租戶 0、整台實例有）→ scope_mismatch，並指出該跑 acr update', async () => {
+    await seedSession('t-empty-1', 'rec_e1');
+    mockGetRecord('rec_e1', '["*"]');
+    mockMap([], []);
+    mockTripletStats((o) => o === 'wrong-ns', 0); // 本租戶 0
+    mockTripletStats((o) => o === '', 1854); // 全庫普查：有 1854 條
+
+    const { body } = await getMap('t-empty-1', { ARCRUN_NAMESPACE: 'wrong-ns' });
+    expect(body.empty_reason).toBe('scope_mismatch');
+    expect(body.empty_confirmed).toBe(false); // 🔴 絕不宣稱「你沒有資料」
+    expect(body.instance_triplet_count).toBe(1854);
+    expect(String(body.note)).toContain('acr update');
+    expect(JSON.stringify(body)).not.toContain('wrong-ns'); // 仍不下發租戶字串
+  });
+
+  it('整台實例真的空 → confirmed_empty（此時、也只有此時，才准說「還沒有內容」）', async () => {
+    await seedSession('t-empty-2', 'rec_e2');
+    mockGetRecord('rec_e2', '["*"]');
+    mockMap([], []);
+    mockTripletStats((o) => o === 'leo', 0);
+    mockTripletStats((o) => o === '', 0);
+
+    const { body } = await getMap('t-empty-2');
+    expect(body.empty_reason).toBe('confirmed_empty');
+    expect(body.empty_confirmed).toBe(true);
+  });
+
+  it('連統計都讀不到 → unreadable（不假裝是空庫）', async () => {
+    await seedSession('t-empty-3', 'rec_e3');
+    mockGetRecord('rec_e3', '["*"]');
+    mockMap([], []);
+    fetchMock
+      .get(KBDB)
+      .intercept({ path: (p: string) => p.startsWith('/records/triplet-stats'), method: 'GET' })
+      .reply(500, { error: 'boom' });
+
+    const { body } = await getMap('t-empty-3');
+    expect(body.empty_reason).toBe('unreadable');
+    expect(body.empty_confirmed).toBe(false);
+  });
+});

cypher-executor/tests/tenant-gate.test.ts

@@ -0,0 +1,118 @@
+/**
+ * 「靜態租戶字串不得用於資料面過濾」這道閘**自己**的測試（Arcrun#108）。
+ *
+ * 收工標準明列三條，這裡逐條釘：
+ *   ① 會擋，不是只提醒 → 壞例子必須產出違規（CLI 端據此 exit 1、hook 據此 exit 2）
+ *   ② 判準看「有沒有在做那件事」 → 一整組「長得像但沒在做」的合法寫法必須零誤攔
+ *   ③ 閘自己要能被測試 → 規則是純函式，這裡直接餵字串；不需要跑檔案系統、也擋不到自己
+ *
+ * 外加一條回歸：現行 src/ 必須是乾淨的（`?raw` 讀真原始碼，不是讀我編的假字串）。
+ */
+import { describe, it, expect } from 'vitest';
+// @ts-expect-error -- 純規則模組（.mjs，零 node 相依），型別非本檔關注重點
+import { scanSource, TENANT_SOURCE_FILE } from '../scripts/tenant-source-rules.mjs';
+// @ts-expect-error -- vite ?raw：build-time 讀檔，runtime 是純字串（Workers 沒有 node:fs）
+import tenantLibSource from '../src/lib/tenant.ts?raw';
+// @ts-expect-error -- 同上
+import portalDataSource from '../src/routes/portal-data.ts?raw';
+// @ts-expect-error -- 同上
+import portalSource from '../src/routes/portal.ts?raw';
+// @ts-expect-error -- 同上
+import consoleAuthSource from '../src/routes/console-auth.ts?raw';
+// @ts-expect-error -- 同上
+import consoleDashboardSource from '../src/routes/console-dashboard.ts?raw';
+
+type Violation = { rule: string; line: number; text: string; message: string };
+const scan = (path: string, text: string): Violation[] => scanSource(path, text) as Violation[];
+const rulesOf = (v: Violation[]): string[] => [...new Set(v.map((x) => x.rule))].sort();
+
+const FILE = 'src/routes/portal-data.ts';
+
+describe('閘會擋：三種「靜態租戶字串進資料面」的真實形狀', () => {
+  it('T1 — 在 tenant.ts 以外讀租戶環境變數（#105/#108 的原句）', () => {
+    const bad = `export function portalTenant(env: Bindings): string {\n  return env.CONSOLE_TENANT || 'leo';\n}`;
+    const v = scan('src/routes/portal.ts', bad);
+    expect(rulesOf(v)).toContain('T1');
+    expect(v[0].message).toContain('knowledgeOwner');
+  });
+
+  it('T1 — `c.env.ARCRUN_NAMESPACE` 也一樣（換一個變數名不是換一個做法）', () => {
+    const v = scan('src/routes/console-dashboard.ts', `const t = c.env.ARCRUN_NAMESPACE || 'leo';`);
+    expect(rulesOf(v)).toEqual(['T1']);
+  });
+
+  it('T2 — 繞過唯一產地自己 cast 一個 TenantId', () => {
+    const v = scan(FILE, `const tenant = (c.env.SOMETHING ?? '') as TenantId;`);
+    expect(rulesOf(v)).toContain('T2');
+  });
+
+  it('T2 — 連在 tenant.ts 裡都不准把「字面字串」當成租戶識別（那就是 `|| "leo"` 的原形）', () => {
+    const v = scan(TENANT_SOURCE_FILE, `  return 'leo' as TenantId;`);
+    expect(rulesOf(v)).toEqual(['T2']);
+    expect(v[0].message).toContain('TenantUnresolvedError');
+  });
+
+  it('T3 — 拿帳號層字串去組知識資料面的 owner_id（#108 那一行，逐字）', () => {
+    const bad = "    const res = await kbdbFetch(c.env, `/map?owner_id=${encodeURIComponent(portalTenant(c.env))}`);";
+    const v = scan(FILE, bad);
+    expect(rulesOf(v)).toContain('T3');
+    expect(v[0].message).toContain('1854');
+  });
+
+  it('T3 — 換成物件屬性寫法一樣擋（`owner_id: portalTenant(c.env)`）', () => {
+    const v = scan(FILE, `      body: JSON.stringify({ values, owner_id: portalTenant(c.env) }),`);
+    expect(rulesOf(v)).toContain('T3');
+  });
+
+  it('T3 — accountTenant() 這個新名字也擋（規則盯的是「這是帳號層的值」，不是某個函式名字的拼法）', () => {
+    const v = scan(FILE, "  kbdbFetch(env, `/entries?owner_id=${accountTenant(env)}`);");
+    expect(rulesOf(v)).toContain('T3');
+  });
+});
+
+describe('閘不誤攔：長得像、但沒有在做那件事的合法寫法', () => {
+  const legit: [string, string, string][] = [
+    ['讀取別人回傳的 owner_id（不是在組過濾）', FILE, `    if (!isOwnedBy(entry.owner_id, knowledgeOwner(c.env))) return notFound(c);`],
+    ['型別宣告裡的 owner_id 欄位', FILE, `      | { record?: { values?: Record<string, unknown>; owner_id?: string | null } }`],
+    ['走唯一入口組過濾', FILE, "    const res = await kbdbFetch(c.env, `/map?${ownerQuery(tenant)}`);"],
+    ['走唯一入口填 body', FILE, `      body: JSON.stringify({ template, values, owner_id: ownerField(tenant) }),`],
+    ['帳號子 namespace 的過濾（`{tenant}::portal`，那是 cypher 自己寫的資料）', 'src/routes/portal.ts', `  const res = await kbdbFetch(env, \`/records/by-template/x?owner_id=\${encodeURIComponent(ns)}\`);`],
+    ['請求自帶的租戶（webhooks-named 慣例：呼叫端就是租戶）', 'src/routes/webhooks-named.ts', `      owner_id: apiKey,`],
+    ['註解裡整句在講 CONSOLE_TENANT 與 owner_id（文件不是行為）', FILE, `// 之前的病：owner_id 拿 env.CONSOLE_TENANT，portalTenant(c.env) 那條路整個空掉`],
+    ['JSDoc 區塊裡出現同樣的字', FILE, ` * 舊寫法 owner_id=\${portalTenant(env)} 已廢除，改走 knowledgeOwner。`],
+    ['行末註解裡出現（程式碼本身乾淨）', FILE, `    const tenant = knowledgeOwner(c.env); // 不是 portalTenant(c.env)，也不是 owner_id=leo`],
+    ['tenant.ts 自己讀環境變數（它就是唯一產地）', TENANT_SOURCE_FILE, `  const injected = (env.ARCRUN_NAMESPACE ?? '').trim();`],
+    ['types.ts 只宣告型別不取值', 'src/types.ts', `  CONSOLE_TENANT?: string;`],
+  ];
+
+  for (const [name, path, line] of legit) {
+    it(`零誤攔：${name}`, () => {
+      expect(scan(path, line)).toEqual([]);
+    });
+  }
+});
+
+describe('回歸：現行原始碼是乾淨的（讀真檔，不是讀我編的字串）', () => {
+  const files: [string, string][] = [
+    [TENANT_SOURCE_FILE, tenantLibSource as string],
+    ['src/routes/portal-data.ts', portalDataSource as string],
+    ['src/routes/portal.ts', portalSource as string],
+    ['src/routes/console-auth.ts', consoleAuthSource as string],
+    ['src/routes/console-dashboard.ts', consoleDashboardSource as string],
+  ];
+  for (const [path, text] of files) {
+    it(`${path} 零違規`, () => {
+      expect(scan(path, text)).toEqual([]);
+    });
+  }
+
+  it('唯一產地本身沒有字面預設值（knowledgeOwner 解析不到要用丟的，不是回 "leo"）', () => {
+    const body = (tenantLibSource as string).slice(
+      (tenantLibSource as string).indexOf('export function knowledgeOwner'),
+      (tenantLibSource as string).indexOf('export function tenantFromApiKey'),
+    );
+    expect(body).toContain('TenantUnresolvedError');
+    // 解析路徑只准回 env 讀到的值；任何 `|| '...'` / `?? '...'` 形式的字面 fallback 都是本票的病本身
+    expect(body).not.toMatch(/(\|\||\?\?)\s*['"][^'"]+['"]/);
+  });
+});

cypher-executor/wrangler.toml

@@ -138,6 +138,19 @@ KBDB_BASE_URL = "https://arcrun-kbdb.uncle6-me.workers.dev"
 # （登入系統只擋外人看頁面，不做多租戶）。Self-hosted fork：改成你自己資料實際所在的租戶字串。
 CONSOLE_TENANT = "leo"
 
+# 這台實例的**知識命名空間**（Arcrun#108）＝知識資料（三元組／卡片／藏書地圖／工作流 KV）
+# 實際掛在哪個 owner_id 底下。**這裡刻意不寫死**：官方 prod 的知識確實在 `CONSOLE_TENANT`
+# （leo）底下，未設就沿用它，行為一字不變。
+#
+# self-hosted 實例由 `acr update` 自動注入（值＝你 `~/.arcrun/config.yaml` 的 `api_key`，
+# 也就是 CLI push 工作流、小幫手上傳知識、MCP 查詢用的同一個 namespace），
+# 而且**只在確認那個 namespace 底下真的查得到知識時才寫**（見 cli/src/lib/deploy.ts
+# namespaceHasKnowledge）——避免把一台原本正常的實例指向空的那一格。
+#
+# 為什麼要跟 CONSOLE_TENANT 分開：CONSOLE_TENANT 同時是帳號子 namespace（`{tenant}::portal`）
+# 的組成，改它會讓舊實例登不進去。兩個不同的事實，兩個 var。
+# ARCRUN_NAMESPACE = "your-namespace"
+
 # Portal session TTL 秒數（portal-auth P2，#24/#25，routes/portal.ts）。預設 7 天（604800）——
 # issue 要求比 console 30 天短效。停用帳號的即時性不靠這個 TTL（每請求回讀 user record）。
 PORTAL_SESSION_TTL = "604800"

scripts/build-worker-artifacts.mjs

@@ -42,6 +42,8 @@ import { join, resolve, basename, relative } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { execSync } from 'node:child_process';
 import { createHash } from 'node:crypto';
+// Arcrun#108 出貨閘（見 main() 內註解）。規則本體與掃描器住在 cypher-executor/scripts/。
+import { scanProject as scanTenantSources } from '../cypher-executor/scripts/check-tenant-source.mjs';
 
 // REPO 一律用「本檔自己的位置」推導，不吃 cwd／env——這是踩坑①解法的地基：
 // 不管這個 clone 被放在磁碟哪個絕對路徑，REPO 永遠是「這個 repo 的根目錄」，
@@ -214,6 +216,29 @@ async function main() {
   console.log('✔ node_modules 檢查通過：');
   for (const p of precheck) console.log(`   ${p.w.dir}  (${p.chk.via})`);
 
+  // ── 出貨閘：靜態租戶字串不得用於資料面過濾（Arcrun#108，#105 同族）─────────────
+  //
+  // 為什麼擋在**這裡**：這條路徑是成品的產地（.worker-builds/ → 使用者的機器）。
+  // 擋在這裡＝違規的碼**編不出成品、出不了貨**，而不是「有人記得跑檢查才會發現」。
+  // leo 2026-08-12：「做一個平台要減少 hotfix。」規則存在但沒機制驗證，就是會再犯第三次。
+  //
+  // 規則本體是純函式（cypher-executor/scripts/tenant-source-rules.mjs），
+  // 由 cypher-executor/tests/tenant-gate.test.ts 逐條驗「壞例子會擋、合法寫法零誤攔」
+  // ——這道閘自己可測，也擋不到自己（掃描範圍只有 cypher-executor/src/）。
+  const tenantViolations = scanTenantSources(join(REPO, 'cypher-executor'));
+  if (tenantViolations.length) {
+    console.error('\n❌ 建置中止：cypher-executor 有「靜態租戶字串用於資料面過濾」的寫法（Arcrun#108 的閘）：\n');
+    for (const v of tenantViolations) {
+      console.error(`   [${v.rule}] ${v.file}:${v.line}  ${v.text}`);
+      console.error(`         → ${v.message}`);
+    }
+    console.error('\n知識資料面請用 knowledgeOwner(env) ＋ ownerQuery()/ownerField()');
+    console.error('（cypher-executor/src/lib/tenant.ts 是租戶字串的唯一產地）。');
+    console.error('本機自查：cd cypher-executor && npm run check:tenant\n');
+    process.exit(1);
+  }
+  console.log('✔ 租戶來源檢查通過：cypher-executor 資料面 owner_id 全部來自 src/lib/tenant.ts');
+
   if (CHECK_ONLY) {
     console.log('\n--check-only：只驗證依賴就緒，不編譯。');
     return;

scripts/sync-resource-rule.mjs

@@ -1,108 +0,0 @@
-#!/usr/bin/env node
-/**
- * sync-resource-rule.mjs — 把「該用哪些資源」這條規則的**唯一原稿**同步給需要打包的呼叫端。
- *
- * 【為什麼需要這支】
- * 規則的原稿在 `shared/resource-rule/rule.mjs`（理由見該檔開頭）。
- * 兩條路取用它的方式不同：
- *
- *   · **安裝器 / 任何 Worker**：本來就會下載這個 repo 的 archive 當部署來源，
- *     直接 import `shared/resource-rule/rule.mjs`。**不需要副本，本支不管它。**
- *
- *   · **`acr` CLI**：`arcrun` 是獨立 npm 套件，`npm pack` 打不進套件目錄外的檔案
- *     ⇒ 套件裡必須有一份。這支就是產生那一份的地方。
- *
- * 【這算不算「第二份實作」】
- * 不算，而且是機械保證的：產生物是**逐位元組副本**，`--check` 一有差就 exit 1，
- * 而 `npm run build` 與 `npm test` 都會先跑 `--check`。
- * 也就是說「有人手改了 CLI 那一份」= build 紅、publish 擋下。
- * ——同 `cli/harness/`（產生物進 repo ＋ `check:harness` 世代閘）的既有慣例，
- *   不是為本票新發明的做法。
- *
- * 用法：
- *   node scripts/sync-resource-rule.mjs           產生／更新副本
- *   node scripts/sync-resource-rule.mjs --check    只檢查，有漂移就 exit 1（不寫檔）
- */
-import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync } from 'node:fs';
-import { join, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { createHash } from 'node:crypto';
-
-// REPO 一律由本檔位置推導，不吃 cwd（比照 scripts/build-worker-artifacts.mjs）。
-const REPO = resolve(fileURLToPath(new URL('.', import.meta.url)), '..');
-const SOURCE_DIR = join(REPO, 'shared/resource-rule');
-
-/**
- * 需要「套件內自帶一份」的呼叫端。**整個目錄原樣鏡射**（不是挑檔案）——
- * 檔名與相對位置保持一致，`cf-resource-api.mjs` 裡的 `./rule.mjs` 才不用改寫。
- * 安裝器不在此列：它直接讀 repo archive 裡的原稿，連副本都不需要。
- */
-const MIRRORS = ['cli/src/lib/resource-rule'];
-
-const CHECK_ONLY = process.argv.includes('--check');
-
-/** @param {string|Buffer} b */
-const sha256 = (b) => createHash('sha256').update(b).digest('hex');
-
-if (!existsSync(SOURCE_DIR)) {
-  console.error(`❌ 找不到規則原稿目錄：${SOURCE_DIR}`);
-  process.exit(1);
-}
-
-/** 原稿目錄裡所有 .mjs（README / 測試不進副本）。 */
-const FILES = readdirSync(SOURCE_DIR).filter((f) => f.endsWith('.mjs')).sort();
-if (FILES.length === 0) {
-  console.error(`❌ ${SOURCE_DIR} 裡沒有任何 .mjs 原稿`);
-  process.exit(1);
-}
-
-let drifted = 0;
-for (const mirror of MIRRORS) {
-  for (const file of FILES) {
-    const src = readFileSync(join(SOURCE_DIR, file));
-    const srcHash = sha256(src);
-    const rel = `${mirror}/${file}`;
-    const abs = join(REPO, mirror, file);
-    const had = existsSync(abs) ? readFileSync(abs) : null;
-
-    if (had !== null && sha256(had) === srcHash) {
-      console.log(`✔ ${rel}  = 原稿（sha256 ${srcHash.slice(0, 12)}）`);
-      continue;
-    }
-
-    if (CHECK_ONLY) {
-      drifted++;
-      console.error(
-        had === null
-          ? `✗ ${rel} 不存在——跑 \`node scripts/sync-resource-rule.mjs\` 產生。`
-          : `✗ ${rel} 與原稿不一致（副本 ${sha256(had).slice(0, 12)} ≠ 原稿 ${srcHash.slice(0, 12)}）。\n` +
-            `  這一份是**產生物**，不要手改：規則要改就改 shared/resource-rule/${file}，` +
-            `然後跑 \`node scripts/sync-resource-rule.mjs\`。`,
-      );
-      continue;
-    }
-
-    mkdirSync(join(REPO, mirror), { recursive: true });
-    writeFileSync(abs, src);
-    console.log(`↻ ${rel}  ← shared/resource-rule/${file}（sha256 ${srcHash.slice(0, 12)}）`);
-  }
-
-  // 副本目錄裡多出來的 .mjs = 有人在產生物旁邊自己加了一支（第二份實作的常見長法）。
-  const mirrorAbs = join(REPO, mirror);
-  const extra = existsSync(mirrorAbs)
-    ? readdirSync(mirrorAbs).filter((f) => f.endsWith('.mjs') && !FILES.includes(f))
-    : [];
-  for (const f of extra) {
-    drifted++;
-    console.error(`✗ ${mirror}/${f} 在原稿目錄裡不存在——副本目錄不是放自己東西的地方。`);
-  }
-}
-
-if (drifted > 0) {
-  console.error(
-    `\n❌ ${drifted} 項與規則原稿脫節。` +
-      `\n「該用哪些資源」只能有一份實作（.claude/rules/07-thin-shell.md）——` +
-      `副本漂移就是第二份實作偷偷長出來的樣子。`,
-  );
-  process.exit(1);
-}

shared/resource-rule/README.md

@@ -1,138 +0,0 @@
-# `shared/resource-rule` — 「這個實例該用哪些資源」的唯一一份規則
-
-> leo 2026-08-12：
-> ①「如果你沒有裝，就是新的；**如果你已經有，原來叫什麼名字就繼續用下去**。」
-> ②「**根本就不應該在 CLI，我要的是一個大家都可以用到的規則。**」
-
-① 是規則本身，② 是它該住哪裡。這個目錄就是 ②。
-
----
-
-## 1. 規則（三句話）
-
-判準是「**這顆 worker 現在綁著誰**」，**不是**「有沒有叫這個名字的資源」。
-
-1. **已部署的 worker 上綁著什麼，那就是事實** → 原封不動沿用，不管那顆資源叫什麼名字。
-2. **只有「確定沒有任何人綁過它」才准新建**（新版本新增的 binding、或真的全新帳號）。
-3. **只要有一點說不準就整趟停手**——讀不到綁定／綁著的資源不見了／同一個 binding 指向兩顆／
-   該更新的 worker 一顆都不在 ⇒ **什麼都不建、什麼都不部署**，把話說清楚讓人來判斷。
-
-`planResources()`（不寫入，只出計畫）與 `applyResourcePlan()`（有 blocker 就拒絕執行）分兩段，
-所以「被擋下的時候一顆資源都不會被建出來」是**結構上的保證**，不是靠誰記得寫 early return。
-
----
-
-## 2. 為什麼在這裡，不在 cypher-executor 的 API
-
-`.claude/rules/07-thin-shell.md` 的標準答案是「能力放 API」。這一條**不走那條路**，理由是自舉：
-
-| 問題 | 說明 |
-|---|---|
-| **cypher 可能還不存在** | 這條規則要在「決定怎麼裝」的當下就用得到，而安裝器的工作正是把 cypher 生出來。把規則放進 cypher = 要先有雞才能有蛋。 |
-| **輸入是使用者自己的帳號狀態** | 判斷的依據是使用者 Cloudflare 帳號上的綁定。送去平台託管的 worker 換一個答案 ⇒ ①「能不能安裝」綁在平台是否活著，②使用者的帳號拓撲交給第三方。 |
-| **它根本不需要是服務** | 這是**純函式**：唯一的 IO 由呼叫端注入（`ResourceApi`）。薄殼原則要求「能力只實作一次」，不是「能力一定要是 HTTP」。 |
-
-所以形態是**一份零依賴的 ESM**——Node 18+ 與 Cloudflare Workers runtime 都能直接 import，
-不必編譯、不必連網、不必先有任何 arcrun 元件活著。
-
-其他評估過的形態：**共用 npm 套件** → 要多發一個 package + token，且安裝器得先 `npm i` 才能判斷，
-自舉問題只是換個位置；**做成一顆零件** → 得用 TinyGo/AssemblyScript 重寫一次，那正是「第二份實作」。
-
----
-
-## 3. 檔案
-
-| 檔案 | 內容 |
-|---|---|
-| `rule.mjs` | 規則本體：`planResources` / `applyResourcePlan` / `parseWranglerRequirements` ＋ 把 CF 回應讀成事實的 `normalizeLiveBindings` / `normalizeLiveVars` |
-| `cf-resource-api.mjs` | `ResourceApi` 的 CF REST 實作（只用 global `fetch`）。**眼睛也要共用**——見下 §5 |
-| `installer-entry.mjs` | 安裝器唯一該碰的入口：`resolveInstanceResources()` |
-| `tests/fixture-account.mjs` | 假 Cloudflare 帳號（`fetch` 替身）＋三種情境 |
-| `tests/demo.mjs` | `node shared/resource-rule/tests/demo.mjs`——零依賴、零建置就能跑的示範 |
-
-🔴 **零依賴是硬規則**：只准 import 同目錄的兄弟檔，不准碰 `node:*`。
-有外部依賴就會有某條路吃不到它。`cli/tests/single-implementation.test.ts` ③ 會擋。
-
----
-
-## 4. 兩條路怎麼取用
-
-### 安裝器 / 任何 Worker（不需要副本）
-
-安裝器本來就會下載本 repo 的 archive 當部署來源（`.claude/rules/05-deploy-convention.md`
-「WASM 來源」），`shared/resource-rule/` 就在那份 archive 裡：
-
-```js
-import { resolveInstanceResources } from './shared/resource-rule/installer-entry.mjs';
-
-const r = await resolveInstanceResources({
-  accountId, apiToken,
-  wranglerTomls: [cypherToml, registryToml, mcpToml, kbdbToml],  // toml 的「內容」，不是路徑
-  mode: isUpdate ? 'update' : 'init',
-});
-
-if (r.blocked) {
-  // 🔴 一顆資源都沒被建。把 r.blockers 原文顯示給使用者，**不要自己「試著繼續」**。
-  return showAndStop(r.blockers);
-}
-// r.bindings  : { 'kv_namespace:WEBHOOKS': 'kvid-…', 'd1:DB': 'uuid-…', … }
-// r.origin    : { 'kv_namespace:WEBHOOKS': 'adopted' | 'created', … }
-// r.liveVars  : { 'arcrun-cypher-executor': { ARCRUN_BUNDLE_VERSION: '1.4.33', … } }  ← #106
-```
-
-**安裝器不准自己判斷要不要建資源**，也不准自己解讀 CF 的 binding 回應。只呼叫這一支。
-
-### `acr` CLI（需要一份鏡射）
-
-`arcrun` 是獨立 npm 套件，`npm pack` 打不進套件目錄外的檔案 ⇒ 套件裡必須自帶一份。
-`cli/src/lib/resource-rule/` 就是本目錄的**逐位元組鏡射**，由
-`node scripts/sync-resource-rule.mjs` 產生。
-
-**要改規則就改這個目錄，然後重跑 sync。** 手改鏡射會被擋下：
-`npm run build` 與 `npm test` 都先跑 `sync-resource-rule.mjs --check`，
-差一個位元組就 exit 1（同 `cli/harness/` 的產生物＋世代閘慣例）。
-
----
-
-## 5. 為什麼連 CF client 也共用
-
-判斷一致還不夠，**看到的東西**也要一致。
-
-「已部署的 worker 綁著什麼」是從 `GET /workers/scripts/{script}/settings` 讀來的。
-兩條路各自寫一份 client，只要有一邊把 404 當錯誤、漏了 `per_page`、少認一種欄位名
-（`namespace_id` vs `id`），那一邊就會「看不到既有綁定」——
-而看不到既有綁定的下一步，依規則就是**新建**。
-
-**Arcrun#97 不需要規則寫錯，眼睛不一樣就足以重演。**
-所以 `cli/src/lib/cf-api.ts` 的 `CfAccountClient` 把 `ResourceApi` 那七個方法**全部委派**
-給 `cf-resource-api.mjs`，自己不留實作。
-
----
-
-## 6. 驗收
-
-```bash
-cd cli && npm test          # 58 項，含下列三組
-node shared/resource-rule/tests/demo.mjs   # 安裝器那條路，零依賴獨立跑
-```
-
-| 測試 | 證的事 |
-|---|---|
-| `cli/tests/two-paths-agree.test.ts` | 同一個帳號狀態餵給 `acr` 那條與安裝器那條，**選出的 resource id 相同**、建的東西相同、停手的理由相同 |
-| `cli/tests/single-implementation.test.ts` | ①規則的 7 支函式全 repo 只有這裡有實作 ②鏡射逐位元組相同 ③共用層零依賴 |
-| `cli/tests/resource-adoption.test.ts` | #97 本身的迴歸（沿用／不多建／四種停手情境），改共用層後照樣全過 |
-
-三種情境（`tests/fixture-account.mjs` 的 `SCENARIOS`）：
-
-- `fresh` — 沒裝過 → **正常建新的**（不能為了沿用而變成永遠不建）
-- `installed` — 裝過了 → 沿用原本那幾顆，工作流與登入 session 都還在
-- `renamed` — **資源在但名字與預期完全不同** → 仍然沿用（#97 的病根，專門驗）
-
----
-
-## 7. 相關
-
-- `Arcrun#97` — 「我按了更新，工作流和登入全不見了」：CLI 那條已修，本目錄是把同一條規則交給所有路徑
-- `Arcrun#106` — 重部署把 `plain_text` var（含版本標籤）洗掉：`liveVars` 就是那些標籤
-- `Arcrun#80` / `arcrun-rag#39` — 同一個「重複做 Arcrun 的工作」家族；Arcrun 是唯一編譯點的既有慣例
-- `.claude/rules/07-thin-shell.md` — 本目錄存在的依據

shared/resource-rule/cf-resource-api.mjs

@@ -1,202 +0,0 @@
-// @ts-check
-/**
- * cf-resource-api.mjs — 規則的**眼睛與手**：對 Cloudflare 帳號的那七個動作，也只有一份。
- *
- * `rule.mjs` 是純判斷，IO 由呼叫端注入（`ResourceApi`）。本檔就是那個注入物的正貨：
- * 用 CF REST API 實作 `ResourceApi`，零依賴、只用 global `fetch`
- * ⇒ Node 18+ 與 Cloudflare Workers runtime 都能直接跑。
- *
- * 【為什麼連這層也要共用】
- * 判斷一致還不夠——**看到的東西**也要一致。
- * 「已部署的 worker 綁著什麼」是從 `GET /workers/scripts/{script}/settings` 讀來的；
- * 如果兩條路各自寫一份 client，隨便一個差異（打錯端點、把 404 當錯誤、漏了 per_page、
- * 少認一種欄位名）都會讓其中一條路「看不到既有綁定」——而看不到既有綁定的下一步，
- * 依規則就是**新建**。Arcrun#97 的災情不需要規則寫錯，只要眼睛不一樣就會重演。
- *
- * 這裡**故意只有 `ResourceApi` 那七個方法**。verifyAccess / 查 subdomain / KV 讀寫
- * 這些跟「該用哪些資源」無關的帳號操作留在各自的呼叫端，不往共用層堆。
- *
- * 🔴 除了同目錄的 `./rule.mjs`，這支不准 import 任何東西——共用層的價值在於
- *    「整個目錄複製到哪個 runtime 都能直接跑」，多一個外部依賴就少一條路吃得到。
- */
-
-import { normalizeLiveBindings, normalizeLiveVars } from './rule.mjs';
-
-const CF_API_BASE = 'https://api.cloudflare.com/client/v4';
-
-/**
- * @typedef {import('./rule.mjs').ResourceApi} ResourceApi
- * @typedef {import('./rule.mjs').ScriptBindings} ScriptBindings
- * @typedef {import('./rule.mjs').RawWorkerBinding} RawWorkerBinding
- */
-
-/**
- * @typedef {object} CfResourceApiOptions
- * @property {string} accountId
- * @property {string} apiToken
- * @property {typeof globalThis.fetch} [fetch]
- *   注入用（離線測試餵假帳號、或宿主要用自己的 fetch）。預設 global fetch。
- */
-
-/**
- * 建一個打真實 Cloudflare 的 `ResourceApi`。
- *
- * @param {CfResourceApiOptions} options
- * @returns {ResourceApi & { cfRaw: (path: string, init?: RequestInit) => Promise<{ok: boolean, status: number, result?: any, error?: string}> }}
- */
-export function createCloudflareResourceApi({ accountId, apiToken, fetch: fetchImpl }) {
-  const doFetch = fetchImpl ?? globalThis.fetch;
-  if (typeof doFetch !== 'function') {
-    throw new Error('createCloudflareResourceApi：這個執行環境沒有 fetch，請用 options.fetch 注入。');
-  }
-  const accountBase = `${CF_API_BASE}/accounts/${accountId}`;
-  const headers = {
-    Authorization: `Bearer ${apiToken}`,
-    'Content-Type': 'application/json',
-  };
-
-  /**
-   * 把 HTTP status 交回呼叫端自己判斷（要區分「404 不存在」和「其他錯誤」時用）。
-   * @param {string} path
-   * @param {RequestInit} [init]
-   * @returns {Promise<{ok: boolean, status: number, result?: any, error?: string}>}
-   */
-  async function cfRaw(path, init) {
-    const res = await doFetch(`${accountBase}${path}`, {
-      ...init,
-      headers: { ...headers, ...(init?.headers ?? {}) },
-    });
-    const data = await res.json().catch(() => null);
-    if (!res.ok || !data?.success) {
-      return {
-        ok: false,
-        status: res.status,
-        error:
-          (data?.errors ?? []).map((/** @type {{message?: string}} */ e) => e.message).filter(Boolean).join('; ') ||
-          `HTTP ${res.status}`,
-      };
-    }
-    return { ok: true, status: res.status, result: data.result };
-  }
-
-  /**
-   * @param {string} path
-   * @param {RequestInit} [init]
-   * @returns {Promise<any>}
-   */
-  async function cf(path, init) {
-    const { ok, status, result, error } = await cfRaw(path, init);
-    if (!ok) throw new Error(`CF API ${path} 失敗：${error ?? `HTTP ${status}`}`);
-    return result;
-  }
-
-  return {
-    cfRaw,
-
-    /**
-     * 讀一顆已部署 worker 現在綁著哪些資源——**使用者那側的事實**（Arcrun#97 的唯一真相源）。
-     *
-     * - script 不存在（404）→ `{ deployed: false }`，這是「還沒部署」，不是錯誤。
-     * - 其他任何失敗 → throw。呼叫端必須把它當「我不知道」而**不是**「它沒有」——
-     *   把查不到當成不存在，就是 #97 的根因。
-     *
-     * @param {string} script
-     * @returns {Promise<ScriptBindings>}
-     */
-    async getScriptBindings(script) {
-      const path = `/workers/scripts/${encodeURIComponent(script)}/settings`;
-      const res = await cfRaw(path);
-      if (!res.ok) {
-        if (res.status === 404) return { deployed: false, bindings: [], vars: {} };
-        throw new Error(`讀 ${script} 綁定失敗：${res.error}`);
-      }
-      /** @type {RawWorkerBinding[]} */
-      const raw = res.result?.bindings ?? [];
-      return {
-        deployed: true,
-        bindings: normalizeLiveBindings(raw),
-        vars: normalizeLiveVars(raw),
-      };
-    },
-
-    /** @returns {Promise<Map<string, string>>} title → id */
-    async listKvNamespaces() {
-      /** @type {Array<{id: string, title: string}>} */
-      const result = await cf('/storage/kv/namespaces?per_page=100');
-      const map = new Map();
-      for (const ns of result) map.set(ns.title, ns.id);
-      return map;
-    },
-
-    /** @returns {Promise<Map<string, string>>} name → uuid */
-    async listD1Databases() {
-      /** @type {Array<{uuid: string, name: string}>} */
-      const result = await cf('/d1/database?per_page=100');
-      const map = new Map();
-      for (const db of result) map.set(db.name, db.uuid);
-      return map;
-    },
-
-    /** @returns {Promise<string[]>} */
-    async listVectorizeIndexes() {
-      /** @type {Array<{name: string}>} */
-      const result = await cf('/vectorize/v2/indexes');
-      return (result ?? []).map((i) => i.name);
-    },
-
-    /**
-     * 無條件新建一顆 KV namespace。
-     *
-     * 🔴 Arcrun#97：這裡**故意沒有**「找不到同名就順手建一顆」的 ensure 版本。
-     * 「照名字找 → 找不到 → 新建 → 綁上去」正是把使用者實例洗成空的那條路
-     * （安裝器取的名字跟 binding 名不一樣，永遠對不上 ⇒ 每次更新都新建）。
-     * 要不要建一律先過 `planResources`。
-     *
-     * @param {string} title
-     * @returns {Promise<string>}
-     */
-    async createKvNamespace(title) {
-      const result = await cf('/storage/kv/namespaces', {
-        method: 'POST',
-        body: JSON.stringify({ title }),
-      });
-      return result.id;
-    },
-
-    /**
-     * 無條件新建 D1。沒有 ensure 版本，理由同 createKvNamespace（Arcrun#97）。
-     * @param {string} name
-     * @returns {Promise<string>}
-     */
-    async createD1Database(name) {
-      const result = await cf('/d1/database', {
-        method: 'POST',
-        body: JSON.stringify({ name }),
-      });
-      return result.uuid;
-    },
-
-    /**
-     * 新建 KBDB embed 用的 Vectorize index（**bge-m3 = 1024 維 / cosine**）。
-     * 已存在（409 / already exists）視為成功——並行或重跑不該炸。
-     * 沒有 ensure 版本：「要不要建」由 planResources 判斷，這裡只負責建（Arcrun#97）。
-     *
-     * @param {string} name
-     * @returns {Promise<string>}
-     */
-    async createVectorizeIndex(name) {
-      const res = await cfRaw('/vectorize/v2/indexes', {
-        method: 'POST',
-        body: JSON.stringify({
-          name,
-          config: { dimensions: 1024, metric: 'cosine' },
-          description: 'arcrun KBDB embed module — bge-m3 1024d (issue #7 / #59)',
-        }),
-      });
-      if (res.ok) return name;
-      const detail = (res.error ?? '').toLowerCase();
-      if (res.status === 409 || /already exists|duplicate|conflict/.test(detail)) return name;
-      throw new Error(`建 Vectorize index ${name} 失敗：${res.error}`);
-    },
-  };
-}

shared/resource-rule/installer-entry.mjs

@@ -1,100 +0,0 @@
-// @ts-check
-/**
- * installer-entry.mjs — 安裝器那條路的**唯一入口**。
- *
- * 安裝器（arcrun-rag `installer/oauth-prototype/worker.js`）不必、也不准自己判斷
- * 「該建哪些資源」——它只要呼叫這一支，拿回「每個 binding 該用哪顆資源」。
- *
- * ```js
- * import { resolveInstanceResources } from './shared/resource-rule/installer-entry.mjs';
- *
- * const r = await resolveInstanceResources({
- *   accountId, apiToken,
- *   wranglerTomls: [cypherToml, registryToml, mcpToml, kbdbToml],  // 字串陣列
- *   mode: isUpdate ? 'update' : 'init',
- * });
- * if (r.blocked) {
- *   // 🔴 一顆資源都沒被建。把 r.blockers 原文顯示給使用者，**不要自己「試著繼續」**。
- *   return showAndStop(r.blockers);
- * }
- * // r.bindings: { 'kv_namespace:WEBHOOKS': 'kvid-…', 'd1:DB': 'uuid-…', … }
- * // r.liveVars: { 'arcrun-cypher-executor': { ARCRUN_BUNDLE_VERSION: '1.4.33', … } }
- * ```
- *
- * 為什麼安裝器不需要副本：安裝器本來就會下載本 repo 的 archive 當部署來源
- * （見 `.claude/rules/05-deploy-convention.md`「WASM 來源」），
- * `shared/resource-rule/` 就在那份 archive 裡，直接 import 即可——
- * **不必再編一次、不必貼一份、也就不會有第二種答案。**
- */
-
-import { planResources, applyResourcePlan, parseWranglerRequirements, ResourcePlanBlocked } from './rule.mjs';
-import { createCloudflareResourceApi } from './cf-resource-api.mjs';
-
-/**
- * @typedef {object} ResolveOptions
- * @property {string} accountId
- * @property {string} apiToken
- * @property {string[]} wranglerTomls  各 worker 的 wrangler.toml **內容**（不是路徑）。
- * @property {'update' | 'init'} mode  這台照定義裝過了沒。
- * @property {typeof globalThis.fetch} [fetch]  注入用（測試／宿主自帶 fetch）。
- */
-
-/**
- * @typedef {object} ResolveResult
- * @property {boolean} blocked            true = 什麼都沒建、什麼都不該部署。
- * @property {string[]} blockers          blocked 時的原因原文（要原樣轉給使用者）。
- * @property {Record<string, string>} bindings   `${kind}:${binding}` → 資源 id／index 名。
- * @property {Record<string, 'adopted'|'created'>} origin  同上 key → 這顆是沿用還是新建。
- * @property {Record<string, Record<string, string>>} liveVars  script → 現有 plain_text var（#106）。
- */
-
-/**
- * 決定這台實例每個 binding 該用哪顆資源；照規則沿用既有、只在確定沒人綁過時才新建。
- *
- * @param {ResolveOptions} options
- * @returns {Promise<ResolveResult>}
- */
-export async function resolveInstanceResources({ accountId, apiToken, wranglerTomls, mode, fetch }) {
-  const api = createCloudflareResourceApi({ accountId, apiToken, fetch });
-
-  /** @type {import('./rule.mjs').BindingRequirement[]} */
-  const requirements = [];
-  for (const toml of wranglerTomls) {
-    const parsed = parseWranglerRequirements(toml);
-    if (!parsed.script) continue;  // 沒宣告 name 的 toml 不該存在；跳過而非亂猜
-    for (const b of parsed.bindings) requirements.push({ ...b, worker: parsed.script });
-  }
-
-  /** @param {string[]} blockers @returns {ResolveResult} */
-  const stop = (blockers) => ({ blocked: true, blockers, bindings: {}, origin: {}, liveVars: {} });
-
-  if (requirements.length === 0) {
-    return stop(['這批 wrangler.toml 裡讀不到任何資源綁定需求——不確定要裝什麼，停手。']);
-  }
-
-  let plan;
-  try {
-    plan = await planResources(api, requirements, mode);
-  } catch (e) {
-    return stop([`資源解析失敗（${e instanceof Error ? e.message : String(e)}）。沒有建立任何資源。`]);
-  }
-  if (plan.blockers.length > 0) return stop(plan.blockers);
-
-  /** @type {Map<string, import('./rule.mjs').ResolvedResource>} */
-  let resolved;
-  try {
-    resolved = await applyResourcePlan(api, plan);
-  } catch (e) {
-    return stop(e instanceof ResourcePlanBlocked ? e.blockers : [e instanceof Error ? e.message : String(e)]);
-  }
-
-  /** @type {Record<string, string>} */
-  const bindings = {};
-  /** @type {Record<string, 'adopted'|'created'>} */
-  const origin = {};
-  for (const [key, r] of resolved) {
-    bindings[key] = r.value;
-    origin[key] = r.origin;
-  }
-  return { blocked: false, blockers: [], bindings, origin, liveVars: Object.fromEntries(plan.liveVars) };
-}

shared/resource-rule/rule.mjs

@@ -1,570 +0,0 @@
-// @ts-check
-/**
- * rule.mjs — 「這個實例該用哪些資源」的**唯一一份**規則。
- *
- * ─────────────────────────────────────────────────────────────────────────────
- * 這份檔案為什麼在這裡（`shared/`），不在 `cli/`
- * ─────────────────────────────────────────────────────────────────────────────
- * leo 2026-08-12：「根本就不應該在 CLI，我要的是一個大家都可以用到的規則。」
- *
- * `.claude/rules/07-thin-shell.md` 的判準口訣：
- *   「這段邏輯換一個介面要不要重寫？」要重寫 → 它是能力，該在共用層。
- *
- * 「該沿用哪幾顆資源」換到安裝器就得重寫一次 ⇒ 它是**能力**，不是薄殼的事。
- * 而它原本住在 `cli/src/lib/resource-resolver.ts` ⇒ 那本身就是違規，
- * 後果也真的發生了：`acr` 那條有這條規則、安裝器那條沒有，於是安裝器照名字找、
- * 找不到就建新的空的 ⇒ Arcrun#97「我按了更新，工作流和登入全不見了」。
- *
- * ── 為什麼不是 cypher-executor 的 API 端點（薄殼原則的標準答案）────────────
- * **自舉**：這條規則要在「決定怎麼裝／怎麼更新」的當下就用得到，而那個當下
- * cypher 可能還不存在（安裝器的工作正是把它生出來），或正要被覆蓋。
- * 而且判斷的輸入是**使用者自己 Cloudflare 帳號上的綁定狀態**——
- * 把它送去一顆平台託管的 worker 換一個答案，等於①讓「能不能安裝」綁在平台是否活著，
- * ②把使用者的帳號拓撲交給第三方。兩件都不該為了形式上的漂亮而做。
- *
- * 薄殼原則要求的是「能力只實作一次」，不是「能力一定要是 HTTP」。
- * 這條規則是**純函式**（唯一的 IO 由呼叫端注入 `ResourceApi`），
- * 所以它用不著變成服務——一份零依賴的 ESM 就能讓每條路吃到同一份判斷。
- *
- * ── 怎麼讓兩條路吃到「同一份」而不是各留一份 ───────────────────────────────
- * 本檔是**唯一被人手維護的實作**，零依賴、不吃任何 node 內建、Workers runtime 可直接跑。
- *   · `acr`：`cli/src/lib/resource-rule.mjs` 是本檔的**逐位元組副本**，
- *     由 `scripts/sync-resource-rule.mjs` 產生（CLI 要能單獨 npm publish，
- *     套件目錄外的檔案打不進 tarball，故必須有這一份）。
- *     `npm run build` / `npm test` 都會跑 `--check`，內容一漂就紅。
- *     ——同 `cli/harness/`（產生物＋世代閘）的既有慣例。
- *   · 安裝器 / 任何 Worker：安裝器本來就會下載本 repo 的 archive（部署來源，
- *     見 `.claude/rules/05-deploy-convention.md`「WASM 來源」），
- *     直接 import 這一份 `shared/resource-rule/rule.mjs` 即可，**不需要再編一次、也不留副本**。
- *     用法見同目錄 README.md。
- *
- * ─────────────────────────────────────────────────────────────────────────────
- * 規則本身（leo 的兩句話）
- * ─────────────────────────────────────────────────────────────────────────────
- * 「如果你沒有裝，就是新的；如果你已經有，原來叫什麼名字就繼續用下去。」
- *
- * 判準是「**這顆 worker 現在綁著誰**」，不是「有沒有叫這個名字的資源」：
- *   1. **已部署的 worker 上綁著什麼，那就是事實** → 原封不動沿用，不管那顆資源叫什麼名字。
- *   2. **只有「確定沒有任何人綁過它」才准新建**（新版本新增的 binding、或真的全新帳號）。
- *   3. **只要有一點說不準就整趟停手**（讀不到綁定／綁著的資源不見了／同一個 binding 指向兩顆／
- *      該更新的 worker 一顆都不在），**什麼都不建、什麼都不部署**，把話說清楚讓人來判斷。
- *
- * ── 為什麼拆成 plan / apply 兩段 ─────────────────────────────────────
- *   `planResources()` **完全不寫入**，只回一份「要沿用什麼、要新建什麼、有什麼不敢動的」。
- *   `applyResourcePlan()` 看到有任何 blocker 就直接拒絕執行。
- *   ⇒「被擋下的時候一顆資源都不會被建出來」是**結構上的保證**，
- *     不是靠某個人記得在對的地方寫 early return。#97 正是死在「先動手、後判斷」。
- *
- * 🔴 這份檔案沒有 import、也不准有。任何依賴都會讓某一條路吃不到它。
- */
-
-/**
- * 這支負責的資源種類。要加新種類（R2/Queue/Hyperdrive…）就加在這裡，
- * 一律走同一道門——不准任何呼叫端自己「照名字 ensure」繞過去。
- * @typedef {'kv_namespace' | 'd1' | 'vectorize'} ResourceKind
- */
-
-/**
- * 從已部署 worker 上讀回來的一條綁定。`value`：KV/D1 是資源 id，Vectorize 是 index 名。
- * @typedef {object} LiveBinding
- * @property {ResourceKind} kind
- * @property {string} binding
- * @property {string} value
- */
-
-/**
- * @typedef {object} ScriptBindings
- * @property {boolean} deployed
- *   false = 這顆 worker 在帳號上還不存在（全新部署），不是「讀取失敗」。讀取失敗要 throw。
- * @property {LiveBinding[]} bindings
- * @property {Record<string, string>} [vars]
- *   這顆 worker 現在掛著的 `plain_text` var（名 → 值）。
- *
- *   🔴 Arcrun#106：#97 只把「資源類」綁定當成事實沿用（KV/D1/Vectorize），
- *     plain_text var 整批沒人管 ⇒ 重部署把它們洗成 repo toml 的預設值。
- *     最痛的一個是 `ARCRUN_BUNDLE_VERSION`（安裝器注入的版本標籤）——
- *     更新完就消失，Portal 設定頁變成「無法讀取目前版本」。
- *     **保留了櫃子，沒保留櫃子上的標籤**。這個欄位就是那些標籤。
- */
-
-/**
- * 規則需要的 CF 能力（收窄成介面，方便離線測試餵假帳號，也讓安裝器用自己的 fetch 實作）。
- * @typedef {object} ResourceApi
- * @property {(script: string) => Promise<ScriptBindings>} getScriptBindings
- * @property {() => Promise<Map<string, string>>} listKvNamespaces  title → id
- * @property {() => Promise<Map<string, string>>} listD1Databases   name → uuid
- * @property {() => Promise<string[]>} listVectorizeIndexes
- * @property {(title: string) => Promise<string>} createKvNamespace
- * @property {(name: string) => Promise<string>} createD1Database
- * @property {(name: string) => Promise<string>} createVectorizeIndex
- */
-
-/**
- * 「這顆 worker 需要這個 binding」。createName 只在**真的要新建**時才會被拿來當名字用。
- * @typedef {object} BindingRequirement
- * @property {ResourceKind} kind
- * @property {string} binding
- * @property {string} worker  需要它的 worker script 名（= wrangler.toml 的 `name`）。
- * @property {string} createName
- */
-
-/**
- * @typedef {object} PlannedAdopt
- * @property {ResourceKind} kind
- * @property {string} binding
- * @property {string} value
- * @property {string} from  從哪顆已部署的 worker 上讀到的
- */
-
-/**
- * @typedef {object} PlannedCreate
- * @property {ResourceKind} kind
- * @property {string} binding
- * @property {string} createName
- * @property {string[]} wantedBy
- * @property {string[]} alsoBind  其他也指向同一顆資源的 binding（見 shareSameResource）。建一顆，大家共用。
- */
-
-/**
- * @typedef {object} ResourcePlan
- * @property {PlannedAdopt[]} adopt
- * @property {PlannedCreate[]} create
- * @property {string[]} blockers  非空 = 整趟停手。applyResourcePlan 會拒絕執行。
- * @property {Map<string, Record<string, string>>} liveVars
- *   每顆**已部署** worker 現在掛著的 plain_text var（script → 名/值）。未部署的不在裡面。
- *
- *   Arcrun#106：讀綁定的時候本來就把整份 `bindings[]` 拿回來了，var 就在同一份回應裡——
- *   順手帶出來，**不另外打一次 API**，也不新增一種「查不到」的失敗模式
- *   （讀不到綁定這件事已經在上面 blockers 那一關擋掉了）。
- */
-
-/**
- * @typedef {object} ResolvedResource
- * @property {ResourceKind} kind
- * @property {string} binding
- * @property {string} value
- * @property {'adopted' | 'created'} origin
- * @property {string} [from]
- */
-
-/**
- * @typedef {object} WranglerRequirements
- * @property {string} script  worker script 名（toml 頂層 `name`）。空字串 = 這份 toml 沒宣告 name（不該發生）。
- * @property {Array<{kind: ResourceKind, binding: string, createName: string}>} bindings
- */
-
-/** plan 被擋下時丟這個，讓呼叫端能把每一條原因原文轉給使用者。 */
-export class ResourcePlanBlocked extends Error {
-  /** @param {string[]} blockers */
-  constructor(blockers) {
-    super(`資源解析被擋下（${blockers.length} 項）`);
-    this.name = 'ResourcePlanBlocked';
-    /** @type {string[]} */
-    this.blockers = blockers;
-  }
-}
-
-/**
- * @param {ResourceKind} kind
- * @param {string} binding
- * @returns {string}
- */
-export function bindingKey(kind, binding) {
-  return `${kind}:${binding}`;
-}
-
-/** @type {Record<ResourceKind, string>} */
-export const KIND_LABEL = {
-  kv_namespace: 'KV namespace',
-  d1: 'D1 資料庫',
-  vectorize: 'Vectorize index',
-};
-
-/**
- * @param {unknown} e
- * @returns {string}
- */
-function msg(e) {
-  return e instanceof Error ? e.message : String(e);
-}
-
-/**
- * 決定每個 binding 要沿用哪顆資源／要不要新建，**不寫入任何東西**。
- *
- * @param {ResourceApi} api
- * @param {readonly BindingRequirement[]} requirements
- * @param {'update' | 'init'} mode
- *   'update' = 這台照定義已經裝過了（見下方「一顆都不在」規則）；'init' = 全新安裝，允許從零建。
- * @returns {Promise<ResourcePlan>}
- */
-export async function planResources(api, requirements, mode) {
-  /** @type {string[]} */
-  const blockers = [];
-  /** @type {PlannedAdopt[]} */
-  const adopt = [];
-  /** @type {PlannedCreate[]} */
-  const create = [];
-
-  // ── 1. 先讀「即將被覆蓋的每一顆 worker」現在綁著什麼 ──────────────────
-  // 讀取失敗 ≠ 沒有綁。#97 的災情就是把「我查不到」當成「它不存在」。
-  const scripts = [...new Set(requirements.map((r) => r.worker))].sort();
-  /** @type {Map<string, LiveBinding[]>} */
-  const live = new Map();
-  /** @type {Map<string, Record<string, string>>} */
-  const liveVars = new Map();
-  let readFailed = false;
-  for (const script of scripts) {
-    try {
-      const res = await api.getScriptBindings(script);
-      if (res.deployed) {
-        live.set(script, res.bindings);
-        // #106：同一份回應裡的 plain_text var 一起收下（呼叫端要拿它決定哪些 var 該沿用）。
-        liveVars.set(script, res.vars ?? {});
-      }
-    } catch (e) {
-      readFailed = true;
-      blockers.push(
-        `讀不到已部署的 worker「${script}」目前綁著哪些資源（${msg(e)}）。` +
-          `不確定它現在用的是哪一顆，就不能重新綁——整趟更新停手，沒有動任何東西。`,
-      );
-    }
-  }
-
-  // 「這台照定義已經裝過了，卻一顆 worker 都找不到」= 我對不上它的實例（名字不同／token 看不到）。
-  // 這種時候繼續走下去，等於把一整套資源重新生一遍再綁上去——正是 #97 的形狀，只是換一道門進來。
-  if (mode === 'update' && !readFailed && live.size === 0 && scripts.length > 0) {
-    blockers.push(
-      `在這個 Cloudflare 帳號上找不到任何一顆要更新的 worker（找過：${scripts.join('、')}）。` +
-        `acr update 的前提是「這台已經裝好了」——對不上就不猜：` +
-        `可能是 API token 看得到的帳號不對，或這台實例的 worker 用了別的名字。` +
-        `已停手，沒有新建任何資源。`,
-    );
-  }
-
-  // ── 2. 逐個 binding 決定：沿用 / 新建 / 停手 ─────────────────────────
-  /** @type {Map<string, BindingRequirement[]>} */
-  const byKey = new Map();
-  for (const req of requirements) {
-    const key = bindingKey(req.kind, req.binding);
-    const list = byKey.get(key);
-    if (list) list.push(req);
-    else byKey.set(key, [req]);
-  }
-
-  /** @type {Map<ResourceKind, Set<string>>} */
-  const existingCache = new Map();
-  /** @param {ResourceKind} kind @returns {Promise<Set<string>>} */
-  const listExisting = async (kind) => {
-    const hit = existingCache.get(kind);
-    if (hit) return hit;
-    /** @type {Set<string>} */
-    let set;
-    if (kind === 'kv_namespace') set = new Set((await api.listKvNamespaces()).values());
-    else if (kind === 'd1') set = new Set((await api.listD1Databases()).values());
-    else set = new Set(await api.listVectorizeIndexes());
-    existingCache.set(kind, set);
-    return set;
-  };
-
-  for (const [, reqs] of byKey) {
-    const { kind, binding } = reqs[0];
-
-    /** @type {Array<{value: string, script: string}>} */
-    const found = [];
-    for (const [script, bindings] of live) {
-      const hit = bindings.find((b) => b.kind === kind && b.binding === binding);
-      if (hit) found.push({ value: hit.value, script });
-    }
-    const distinct = [...new Set(found.map((f) => f.value))];
-
-    // 2a. 同一個 binding 名在不同 worker 上指向不同資源 → 分不出哪個才是使用者要的。
-    //     自己挑一個 = 有一半機率把另外那半的資料從畫面上抹掉。不猜。
-    if (distinct.length > 1) {
-      blockers.push(
-        `綁定「${binding}」在不同 worker 上指向不同的 ${KIND_LABEL[kind]}` +
-          `（${found.map((f) => `${f.script} → ${f.value}`).join('、')}）。` +
-          `分不出哪一顆才是你在用的，不猜——停手。`,
-      );
-      continue;
-    }
-
-    // 2b. 有人綁著它 → 這就是事實，沿用。名字長什麼樣完全不看。
-    if (distinct.length === 1) {
-      const value = distinct[0];
-      /** @type {Set<string>} */
-      let existing;
-      try {
-        existing = await listExisting(kind);
-      } catch (e) {
-        blockers.push(
-          `查不到帳號上的 ${KIND_LABEL[kind]} 清單，無法確認「${binding}」綁著的 ${value} 還在不在` +
-            `（${msg(e)}）。不確定就不動——停手。`,
-        );
-        continue;
-      }
-      if (!existing.has(value)) {
-        // 這正是 #97 的入口：舊版在這裡會安靜地新建一顆空的頂上去。
-        blockers.push(
-          `worker「${found[0].script}」的「${binding}」綁著 ${KIND_LABEL[kind]} ${value}，` +
-            `但這顆在你的 Cloudflare 帳號上找不到了。` +
-            `這裡**不會**幫你新建一顆空的頂上去（Arcrun#97 的災情就是那樣來的）——` +
-            `請先確認那顆資源是被刪掉了，還是這把 API token 看不到它。`,
-        );
-        continue;
-      }
-      adopt.push({ kind, binding, value, from: found[0].script });
-      continue;
-    }
-
-    // 2c. 沒有任何已部署的 worker 綁過它 → 新版本新增的 binding，或全新帳號。
-    //     這種情況下新建不會弄丟任何東西（本來就沒有東西可丟）。
-    create.push({
-      kind,
-      binding,
-      createName: reqs[0].createName,
-      wantedBy: [...new Set(reqs.map((r) => r.worker))],
-      alsoBind: [],
-    });
-  }
-
-  return { adopt, create: shareSameResource(adopt, create, byKey), blockers, liveVars };
-}
-
-/**
- * 收斂「不同 binding 其實是同一顆資源」的情況。
- *
- * 判準是 **toml 自己宣告的名字**（`database_name` / `index_name`），不是使用者那側的資源名——
- * cypher 的 `CREDENTIALS_DB` 與 kbdb 的 `DB` 都寫 `database_name = "arcrun-kbdb"`，
- * 那是**我們**在宣告「這兩個綁定指向同一顆庫」，跟 #97 那種「拿名字去猜使用者的資源」是兩回事。
- *
- * 沒有這一步會出兩種錯：
- *   ① 全新安裝時建出兩顆同名 D1，KBDB 的資料與 credential 目錄從此分家。
- *   ② 一邊已部署（沿用既有）、另一邊沒有（新建一顆空的）→ 半套資料，比全壞更難查。
- *
- * @param {PlannedAdopt[]} adopt
- * @param {PlannedCreate[]} create
- * @param {Map<string, BindingRequirement[]>} byKey
- * @returns {PlannedCreate[]}
- */
-function shareSameResource(adopt, create, byKey) {
-  /** @param {ResourceKind} kind @param {string} binding @returns {string | undefined} */
-  const declaredName = (kind, binding) =>
-    byKey.get(bindingKey(kind, binding))?.[0]?.createName;
-
-  /** @type {PlannedCreate[]} */
-  const out = [];
-  /** @type {Map<string, PlannedCreate>} */
-  const groups = new Map();
-
-  for (const c of create) {
-    const groupKey = `${c.kind} ${c.createName}`;
-
-    // ① 已經有 binding 沿用到同一顆（依 toml 宣告）→ 跟著沿用，不要另外建一顆。
-    const twin = adopt.find(
-      (a) => a.kind === c.kind && declaredName(a.kind, a.binding) === c.createName,
-    );
-    if (twin) {
-      adopt.push({ kind: c.kind, binding: c.binding, value: twin.value, from: twin.from });
-      continue;
-    }
-
-    // ② 同一趟裡有多個 binding 要建同一顆 → 建一次，其他人共用。
-    const head = groups.get(groupKey);
-    if (head) {
-      head.alsoBind.push(c.binding);
-      head.wantedBy = [...new Set([...head.wantedBy, ...c.wantedBy])];
-      continue;
-    }
-    groups.set(groupKey, c);
-    out.push(c);
-  }
-  return out;
-}
-
-/**
- * 照 plan 動手：沿用的原樣帶出來，該建的才建。
- * 有任何 blocker 直接丟 ResourcePlanBlocked，**一顆都不建**。
- *
- * @param {ResourceApi} api
- * @param {ResourcePlan} plan
- * @returns {Promise<Map<string, ResolvedResource>>}
- */
-export async function applyResourcePlan(api, plan) {
-  if (plan.blockers.length > 0) throw new ResourcePlanBlocked(plan.blockers);
-
-  /** @type {Map<string, ResolvedResource>} */
-  const out = new Map();
-  for (const a of plan.adopt) {
-    out.set(bindingKey(a.kind, a.binding), {
-      kind: a.kind,
-      binding: a.binding,
-      value: a.value,
-      origin: 'adopted',
-      from: a.from,
-    });
-  }
-  /** @type {string[]} */
-  const madeSoFar = [];
-  for (const c of plan.create) {
-    /** @type {string} */
-    let value;
-    try {
-      if (c.kind === 'kv_namespace') value = await api.createKvNamespace(c.createName);
-      else if (c.kind === 'd1') value = await api.createD1Database(c.createName);
-      else value = await api.createVectorizeIndex(c.createName);
-    } catch (e) {
-      // 半途失敗：已經建出來的那幾顆還沒被綁到任何 worker 上。**要講出來**——
-      // 不講的話它們就是帳號上一批沒人認得的孤兒，而且下次重跑會再建一批。
-      const orphans = madeSoFar.length > 0
-        ? `\n  已經建好但還沒綁上任何 worker 的：${madeSoFar.join('、')}（重跑前可先刪掉，或留著讓下次沿用）`
-        : '';
-      throw new Error(`建 ${KIND_LABEL[c.kind]}「${c.createName}」失敗：${msg(e)}${orphans}`);
-    }
-    madeSoFar.push(`${KIND_LABEL[c.kind]} ${c.createName}`);
-    for (const binding of [c.binding, ...c.alsoBind]) {
-      out.set(bindingKey(c.kind, binding), { kind: c.kind, binding, value, origin: 'created' });
-    }
-  }
-  return out;
-}
-
-// ─────────────────────────────────────────────────────────────────────────────
-// wrangler.toml → 需求清單
-// ─────────────────────────────────────────────────────────────────────────────
-
-/**
- * wrangler.toml 的 table 名 → 資源種類。需求解析與注入共用同一張表，兩邊才不會對不上。
- * @type {Record<string, ResourceKind>}
- */
-export const TABLE_KIND = {
-  kv_namespaces: 'kv_namespace',
-  d1_databases: 'd1',
-  vectorize: 'vectorize',
-};
-
-/**
- * 從 wrangler.toml 抽出「這顆 worker 需要哪些資源綁定」。
- *
- * 刻意寫成行掃描而不引 TOML parser：注入端（injectWranglerConfig）本來就是純文字操作，
- * 兩邊用同一種視角看這份檔案才不會對不上。註解掉的區塊**不算需求**
- * （kbdb 的 `[[vectorize]]` 預設是註解狀態，要開語義查詢時才會被取消註解 → 那時才成為需求）。
- *
- * 也是「零依賴」的一部分：不引 TOML parser ⇒ 安裝器 import 這支不必多裝任何東西。
- *
- * @param {string} toml
- * @returns {WranglerRequirements}
- */
-export function parseWranglerRequirements(toml) {
-  let script = '';
-  let seenTable = false;
-  /** @type {WranglerRequirements['bindings']} */
-  const bindings = [];
-
-  /** @type {ResourceKind | null} */
-  let kind = null;
-  let binding = '';
-  let createName = '';
-
-  const flush = () => {
-    if (kind && binding) {
-      bindings.push({ kind, binding, createName: createName || binding });
-    }
-    kind = null;
-    binding = '';
-    createName = '';
-  };
-
-  for (const raw of toml.split('\n')) {
-    const line = raw.trim();
-    if (line === '' || line.startsWith('#')) continue;
-
-    const table = line.match(/^\[\[?([A-Za-z0-9_]+)\]?\]$/);
-    if (table) {
-      flush();
-      seenTable = true;
-      kind = TABLE_KIND[table[1]] ?? null;
-      continue;
-    }
-
-    const kv = line.match(/^([A-Za-z0-9_]+)\s*=\s*"([^"]*)"/);
-    if (!kv) continue;
-    const [, key, value] = kv;
-
-    if (!seenTable && key === 'name') {
-      script = value;
-      continue;
-    }
-    if (!kind) continue;
-    if (key === 'binding') binding = value;
-    // 只有 D1／Vectorize 在 toml 裡帶得出「名字」；KV 沒有，退回用 binding 名（見 flush）。
-    else if (key === 'database_name' || key === 'index_name') createName = value;
-  }
-  flush();
-
-  return { script, bindings };
-}
-
-// ─────────────────────────────────────────────────────────────────────────────
-// Cloudflare `/settings` 回應 → 事實（兩條路都要用同一種眼睛看）
-// ─────────────────────────────────────────────────────────────────────────────
-
-/**
- * CF `GET /accounts/{id}/workers/scripts/{script}/settings` 回的 binding 原始形狀
- * （同一種資源在不同 API 版本欄位名不一，故全都收）。
- *
- * @typedef {object} RawWorkerBinding
- * @property {string} [type]
- * @property {string} [name]
- * @property {string} [namespace_id]
- * @property {string} [id]
- * @property {string} [database_id]
- * @property {string} [index_name]
- * @property {string} [text]  `plain_text` 綁定的值（#106；secret_text 不會回值，本來就讀不到，也不該讀）。
- */
-
-/**
- * 把 CF 的 binding 陣列收斂成規則認得的三種資源。不認得的型別直接略過。
- *
- * 🔴 這支**刻意放在規則裡**，不留在各自的 CF client：
- *   「什麼才算『這顆 worker 綁著某顆資源』」是規則的一部分。
- *   兩條路各自解讀 CF 回應 = 漂移會從這裡長回來（例如一邊認 `namespace_id`、
- *   另一邊只認 `id`，於是一邊看得到綁定、另一邊看不到 → 後者又去新建了）。
- *
- * @param {RawWorkerBinding[]} raw
- * @returns {LiveBinding[]}
- */
-export function normalizeLiveBindings(raw) {
-  /** @type {LiveBinding[]} */
-  const out = [];
-  for (const b of raw) {
-    if (!b?.name) continue;
-    if (b.type === 'kv_namespace') {
-      const value = b.namespace_id ?? b.id;
-      if (value) out.push({ kind: 'kv_namespace', binding: b.name, value });
-    } else if (b.type === 'd1' || b.type === 'd1_database') {
-      const value = b.id ?? b.database_id;
-      if (value) out.push({ kind: 'd1', binding: b.name, value });
-    } else if (b.type === 'vectorize') {
-      if (b.index_name) out.push({ kind: 'vectorize', binding: b.name, value: b.index_name });
-    }
-  }
-  return out;
-}
-
-/**
- * 抽出已部署 worker 上的 `plain_text` var（#106）。
- *
- * 只收 `plain_text`——**`secret_text` 一律不碰**（CF 本來就不回值，也不該被搬來搬去；
- * wrangler deploy 不會動 secret，它們自己會留著）。
- *
- * @param {RawWorkerBinding[]} raw
- * @returns {Record<string, string>}
- */
-export function normalizeLiveVars(raw) {
-  /** @type {Record<string, string>} */
-  const out = {};
-  for (const b of raw) {
-    if (b?.type === 'plain_text' && b.name && typeof b.text === 'string') out[b.name] = b.text;
-  }
-  return out;
-}

shared/resource-rule/tests/demo.mjs

@@ -1,60 +0,0 @@
-// @ts-check
-/**
- * demo.mjs — 安裝器那條路的**可獨立執行**證明。
- *
- *   node shared/resource-rule/tests/demo.mjs
- *
- * 這支只 import `shared/resource-rule/`，**沒有 node_modules、沒有建置步驟**——
- * 跑得起來本身就是「安裝器把 repo archive 拉下來就能直接用」這句話的證據。
- * （對照組：`acr` 那條要先 npm ci + TS 轉譯才跑得動。兩條路差在外殼，判斷是同一份。）
- *
- * 三種情境各跑一次，印出每個 binding 選到哪顆資源、以及這一趟建了幾顆。
- */
-
-import { resolveInstanceResources } from '../installer-entry.mjs';
-import { makeAccount, SCENARIOS, WORKER_NEEDS } from './fixture-account.mjs';
-
-/** 用 fixture 的需求組出各 worker 的 wrangler.toml 內容。 */
-function tomls() {
-  return Object.entries(WORKER_NEEDS).map(([script, need]) => {
-    let t = `name = "${script}"\ncompatibility_date = "2025-02-19"\n`;
-    for (const b of need.kv) t += `\n[[kv_namespaces]]\nbinding = "${b}"\nid = "PLACEHOLDER"\n`;
-    for (const d of need.d1) {
-      t += `\n[[d1_databases]]\nbinding = "${d.binding}"\ndatabase_name = "${d.database_name}"\ndatabase_id = "PLACEHOLDER"\n`;
-    }
-    return t;
-  });
-}
-
-const order = /** @type {const} */ (['fresh', 'installed', 'renamed']);
-
-console.log('安裝器那條路（只 import shared/resource-rule/，零依賴、零建置）\n');
-
-for (const scenario of order) {
-  const mode = scenario === 'fresh' ? 'init' : 'update';
-  const account = makeAccount(scenario);
-  const r = await resolveInstanceResources({
-    accountId: 'acct-demo',
-    apiToken: 'tok-demo',
-    wranglerTomls: tomls(),
-    mode,
-    fetch: account.fetch,
-  });
-
-  console.log(`── ${scenario}（mode=${mode}）：${SCENARIOS[scenario].label}`);
-  if (r.blocked) {
-    console.log('   ⛔ 停手，一顆資源都沒建：');
-    for (const b of r.blockers) console.log(`      • ${b}`);
-    console.log('');
-    continue;
-  }
-  for (const key of Object.keys(r.bindings).sort()) {
-    console.log(`   ${key.padEnd(30)} → ${r.bindings[key].padEnd(26)} ${r.origin[key]}`);
-  }
-  console.log(
-    `   本趟新建：KV ${account.created.kv.length} 顆、D1 ${account.created.d1.length} 顆、` +
-      `Vectorize ${account.created.vectorize.length} 顆` +
-      `｜沿用既有版本標籤 ARCRUN_BUNDLE_VERSION=` +
-      `${r.liveVars['arcrun-cypher-executor']?.ARCRUN_BUNDLE_VERSION ?? '（無，全新安裝）'}\n`,
-  );
-}

shared/resource-rule/tests/fixture-account.mjs

@@ -1,202 +0,0 @@
-// @ts-check
-/**
- * fixture-account.mjs — 一個假的 Cloudflare 帳號，做成 **`fetch` 替身**。
- *
- * 【為什麼是 fetch 替身，不是假的 ResourceApi 物件】
- * 本票要證的是「`acr` 那條與安裝器那條，跑出來的決定必須一致」。
- * 如果兩條路各自餵一個假的 `ResourceApi`，那就只測到了 `rule.mjs` 的判斷，
- * **完全跳過了「怎麼把 CF 回應讀成事實」**——而 Arcrun#97 的重演只需要眼睛不一樣就夠了
- * （一邊把 404 當錯誤、一邊漏認 `namespace_id`…）。
- * 從 `fetch` 這一層假起，兩條路就是真的走完整條鏈：HTTP → 解析 → 判斷。
- *
- * 零依賴、純 ESM，Node 與 Workers 都能跑。
- */
-
-/** arcrun 各 worker 在 wrangler.toml 裡宣告的 KV binding 名（= 需求，不是資源名）。 */
-export const KV_BINDINGS = [
-  'WEBHOOKS', 'CREDENTIALS_KV', 'RECIPES', 'USERS_KV', 'SESSIONS_KV',
-  'ANALYTICS_KV', 'EXEC_CONTEXT', 'SUBMISSIONS_KV', 'OAUTH_KV',
-];
-
-/** 這台實例上有資源綁定的四顆 worker，以及各自需要的綁定。 */
-export const WORKER_NEEDS = {
-  'arcrun-cypher-executor': {
-    kv: ['EXEC_CONTEXT', 'WEBHOOKS', 'CREDENTIALS_KV', 'ANALYTICS_KV', 'RECIPES', 'USERS_KV', 'SESSIONS_KV'],
-    d1: [{ binding: 'CREDENTIALS_DB', database_name: 'arcrun-kbdb' }],
-  },
-  'arcrun-registry': { kv: ['SUBMISSIONS_KV', 'ANALYTICS_KV'], d1: [] },
-  'arcrun-mcp': { kv: ['OAUTH_KV'], d1: [] },
-  'arcrun-kbdb': { kv: [], d1: [{ binding: 'DB', database_name: 'arcrun-kbdb' }] },
-};
-
-/**
- * 把 WORKER_NEEDS 攤成 `BindingRequirement[]`——兩條路都用**同一份需求**進去，
- * 才能證明差異（如果有）來自實作而不是輸入。
- * @returns {Array<{kind: 'kv_namespace'|'d1', binding: string, worker: string, createName: string}>}
- */
-export function requirements() {
-  const out = [];
-  for (const [worker, need] of Object.entries(WORKER_NEEDS)) {
-    for (const b of need.kv) out.push({ kind: 'kv_namespace', binding: b, worker, createName: b });
-    for (const d of need.d1) {
-      out.push({ kind: 'd1', binding: d.binding, worker, createName: d.database_name });
-    }
-  }
-  return out;
-}
-
-/**
- * 三種情境。`titleFor` 決定「使用者帳號上那顆資源實際叫什麼名字」——
- * 這正是 #97 的病根所在：規則**不准**拿名字當識別。
- *
- * @typedef {'fresh' | 'installed' | 'renamed'} Scenario
- */
-
-/** @type {Record<Scenario, {label: string, deployed: boolean, titleFor: (binding: string) => string}>} */
-export const SCENARIOS = {
-  fresh: {
-    label: '沒裝過（全新帳號，一顆 worker 都沒有）',
-    deployed: false,
-    titleFor: (b) => b,
-  },
-  installed: {
-    label: '裝過了（安裝器命名慣例 arcrun-rag-<instance>-kv-<binding>）',
-    deployed: true,
-    titleFor: (b) => `arcrun-rag-yuga3bse-kv-${b.toLowerCase()}`,
-  },
-  renamed: {
-    label: '資源在，但名字與預期完全不同（使用者自己改過／別的安裝器版本取的名）',
-    deployed: true,
-    // 刻意取成跟 binding 名毫無關聯的字串：只要規則有一絲「照名字對號」就會在這裡露餡。
-    titleFor: (b) => `kv-${[...b].reduce((h, c) => (h * 31 + c.charCodeAt(0)) >>> 0, 7).toString(36)}`,
-  },
-};
-
-/**
- * 建一個假帳號 + 對應的 `fetch` 替身。
- *
- * @param {Scenario} scenario
- * @returns {{
- *   fetch: typeof globalThis.fetch,
- *   created: {kv: string[], d1: string[], vectorize: string[]},
- *   userData: {workflows: string[], sessions: string[], libraries: string[]},
- *   kvIdFor: (binding: string) => string | undefined,
- *   d1Id: string,
- *   requestLog: string[],
- * }}
- */
-export function makeAccount(scenario) {
-  const spec = SCENARIOS[scenario];
-  /** title → id */
-  const kv = new Map();
-  /** name → uuid */
-  const d1 = new Map();
-  /** @type {string[]} */
-  const vectorize = [];
-  /** script → CF `/settings` 回應裡的 bindings[] 原始形狀 */
-  const scripts = new Map();
-
-  const created = { kv: [], d1: [], vectorize: [] };
-  const requestLog = [];
-
-  // 使用者的東西——驗「更新完還在不在」用。掛在資源 id 上，不是掛在名字上。
-  const userData = {
-    workflows: ['webhook:leo:daily-digest', 'webhook:leo:inbox-sync', 'webhook:leo:rag-ingest'],
-    sessions: ['session:leo-abc123'],
-    libraries: ['general', '課程', '客戶', '研究'],
-  };
-
-  const kvIdByBinding = new Map();
-  const D1_ID = 'd1id-kbdb-REAL';
-
-  if (spec.deployed) {
-    // 帳號上已經有的資源（名字照該情境的慣例取，id 才是身分）
-    for (const b of KV_BINDINGS) {
-      const id = `kvid-${b.toLowerCase()}-REAL`;
-      kv.set(spec.titleFor(b), id);
-      kvIdByBinding.set(b, id);
-    }
-    d1.set('arcrun-rag-yuga3bse-kbdb', D1_ID);
-
-    // 已部署的 worker 上綁著它們——**這才是規則要看的事實**
-    for (const [script, need] of Object.entries(WORKER_NEEDS)) {
-      const bindings = [];
-      for (const b of need.kv) {
-        bindings.push({ type: 'kv_namespace', name: b, namespace_id: kvIdByBinding.get(b) });
-      }
-      for (const d of need.d1) bindings.push({ type: 'd1', name: d.binding, id: D1_ID });
-      // #106：plain_text var 也在同一份回應裡
-      bindings.push({ type: 'plain_text', name: 'ARCRUN_BUNDLE_VERSION', text: '1.4.33' });
-      scripts.set(script, bindings);
-    }
-  }
-
-  /** @param {unknown} result @param {number} [status] */
-  const ok = (result, status = 200) =>
-    new Response(JSON.stringify({ success: true, result, errors: [] }), {
-      status,
-      headers: { 'Content-Type': 'application/json' },
-    });
-  /** @param {string} message @param {number} status */
-  const fail = (message, status) =>
-    new Response(JSON.stringify({ success: false, result: null, errors: [{ message }] }), {
-      status,
-      headers: { 'Content-Type': 'application/json' },
-    });
-
-  /** @type {typeof globalThis.fetch} */
-  // @ts-expect-error — 測試替身只實作用得到的那幾條路徑
-  const fakeFetch = async (input, init) => {
-    const url = new URL(typeof input === 'string' ? input : String(input));
-    const path = url.pathname.replace(/^\/client\/v4\/accounts\/[^/]+/, '');
-    const method = (init?.method ?? 'GET').toUpperCase();
-    requestLog.push(`${method} ${path}${url.search}`);
-    const body = init?.body ? JSON.parse(String(init.body)) : null;
-
-    // 已部署 worker 的綁定
-    const m = path.match(/^\/workers\/scripts\/([^/]+)\/settings$/);
-    if (m && method === 'GET') {
-      const script = decodeURIComponent(m[1]);
-      if (!scripts.has(script)) return fail('workers.api.error.script_not_found', 404);
-      return ok({ bindings: scripts.get(script) });
-    }
-
-    if (path === '/storage/kv/namespaces' && method === 'GET') {
-      return ok([...kv].map(([title, id]) => ({ id, title })));
-    }
-    if (path === '/storage/kv/namespaces' && method === 'POST') {
-      const id = `kvid-NEW-${created.kv.length + 1}`;
-      kv.set(body.title, id);
-      created.kv.push(body.title);
-      return ok({ id, title: body.title });
-    }
-    if (path === '/d1/database' && method === 'GET') {
-      return ok([...d1].map(([name, uuid]) => ({ uuid, name })));
-    }
-    if (path === '/d1/database' && method === 'POST') {
-      const uuid = `d1id-NEW-${created.d1.length + 1}`;
-      d1.set(body.name, uuid);
-      created.d1.push(body.name);
-      return ok({ uuid, name: body.name });
-    }
-    if (path === '/vectorize/v2/indexes' && method === 'GET') {
-      return ok(vectorize.map((name) => ({ name })));
-    }
-    if (path === '/vectorize/v2/indexes' && method === 'POST') {
-      vectorize.push(body.name);
-      created.vectorize.push(body.name);
-      return ok({ name: body.name });
-    }
-
-    return fail(`fixture 沒有實作這條路徑：${method} ${path}`, 501);
-  };
-
-  return {
-    fetch: fakeFetch,
-    created,
-    userData,
-    kvIdFor: (binding) => kvIdByBinding.get(binding),
-    d1Id: D1_ID,
-    requestLog,
-  };
-}

system-dev/docs/3-specs/portal-auth/tasks.md

@@ -376,6 +376,23 @@
   真人用滑鼠點擊複製鈕（受限於自動化環境，上述已用既有鈕做過同構對照）。
   執行範圍：`console-ui/public/portal/index.html`（新增面板 + JS）。未動後端、未部署。
 
+- [x] **Arcrun#108（任務層修正，2026-08-13）：資料面租戶字串收斂到唯一產地**
+  P3 的 `/portal/data/*` 一律用 `portalTenant(env) = env.CONSOLE_TENANT || 'leo'` 注 `owner_id`。
+  那個字串是**部署環境變數**，而知識是 CLI／同步小幫手／MCP 用**實例 namespace**
+  （`~/.arcrun/config.yaml` 的 `api_key`）寫進去的——兩個來源會漂。leo 實撞：
+  藏書地圖回 0 個庫，同一分鐘 KBDB 裡有 1854 條三元組（他的在 `owner_id=bfezv28v`）。
+  與 `Arcrun#105`（`env.MCP_OWNER_NAMESPACE || "leo"`）同形，低一層。
+  **修法**：新增 `cypher-executor/src/lib/tenant.ts` 當唯一產地——
+  `knowledgeOwner(env)` 回 branded `TenantId`（`ARCRUN_NAMESPACE` → `CONSOLE_TENANT` →
+  誠實丟錯，**無字面預設值**），資料面過濾一律經 `ownerQuery()/ownerField()`；
+  帳號子 namespace（design D-2 的 `{tenant}::portal`）改用 `accountTenant(env)`（回 `string`，
+  型別上不可能流進資料面），**帳號落點一字不動**（動了舊實例登不進去）。
+  `acr update` 先驗（`GET /kbdb/map?owner_id=<api_key>` 查得到庫）才注入 `ARCRUN_NAMESPACE`。
+  空地圖改回四態（`no_library_grant`／`filtered_out`／`scope_mismatch`／`confirmed_empty`），
+  沿 Arcrun#100「讀不到就說讀不到」。庫權限過濾一字未動（回歸測試釘住）。
+  防複發：`scripts/build-worker-artifacts.mjs` 出貨前掃描，違規編不出成品。
+  規範寫入 `.claude/rules/02-forbidden.md` 第六類、`system-dev/wiki/mistakes.md` #26。
+
 ## 第二波（不在本 SDD 動工範圍，掛號）
 
 - MCP token 綁庫集合（design §9；PR#15 擴充，只動 `mcp/`）

system-dev/wiki/mistakes.md

@@ -547,6 +547,43 @@ repo 早已是 343,969 bytes 的新品牌世代，`Songti` 一處不剩。
 
 ---
 
+## 26. 「身分來自環境變數」——同一句話寫錯兩次，因為規則有、機制沒有（2026-08-12，Arcrun#105／#108）
+
+**症狀**：leo 打開藏書地圖回 **0 個庫**，同一分鐘 KBDB 裡有 **1854 條三元組**；
+`arcrun_whoami` 顯示 admin／全部知識庫，`kbdb_search` 也查得到東西——**只有地圖那格是空的**。
+
+**根因**（不是資料掉了，是讀寫兩端各拿一個來源）：
+
+| | 寫入端用什麼當 owner_id | 讀取端用什麼過濾 |
+|---|---|---|
+| 之前 | `~/.arcrun/config.yaml` 的 `api_key`（CLI push／小幫手上傳／MCP，leo ＝ `bfezv28v`） | `env.CONSOLE_TENANT \|\| "leo"`（repo toml 帶的**官方 prod 值**） |
+
+`acr` 從來不注入 `CONSOLE_TENANT`，所以那個 `"leo"` 不是理論邊角，**是每台 self-hosted 實例的實際行為**。
+
+**這是第二次**。`#105` 前一天才修掉 `env.MCP_OWNER_NAMESPACE || "leo"`——同一句話，換一個檔案。
+
+**判準（下次照用）**：
+1. **「這個字串是用來決定誰的資料嗎？」** 是 → 它是身分，不是部署設定。
+   身分要嘛來自請求（登入 session／`X-Arcrun-API-Key`），要嘛來自「寫入端用的那個值」，
+   **不可以是一個各自抄一份的環境變數預設值**。
+2. **`|| '預設值'` 出現在身分解析路徑上＝把「這台機器沒設定」偽裝成「你沒有資料」**。
+   解析不到就誠實丟錯（#100 同一條：讀不到就說讀不到）。
+3. **「規則存在但沒有機制驗證」＝它會再犯**。所以本次除了修 bug，還留下三道會擋的：
+   - 型別閘：`TenantId` 只能由 `cypher-executor/src/lib/tenant.ts` 產出，
+     資料面過濾只吃 `ownerQuery()/ownerField()` → 拿隨手一個 string 去過濾，`tsc` 當場不給過。
+   - 出貨閘：`scripts/build-worker-artifacts.mjs` 編成品前先跑租戶來源檢查
+     → **違規的碼編不出成品、出不了貨**（不是「有人記得跑才會發現」）。
+   - 這道閘自己可測：規則是純函式（`cypher-executor/scripts/tenant-source-rules.mjs`），
+     `tests/tenant-gate.test.ts` 逐條驗「壞例子會擋、11 種合法寫法零誤攔」。
+     **誤攔比漏攔更容易殺死一道閘**——被擋煩了就有人把它關掉。
+4. **修法不能比 bug 更危險**：`acr update` 注入 `ARCRUN_NAMESPACE` 前**先驗**
+   （`GET /kbdb/map?owner_id=<api_key>` 查得到庫才寫）。無條件覆蓋會把「知識本來就在
+   `CONSOLE_TENANT` 底下」的一鍵安裝實例指向空的那一格——那是 #97/#106 那類
+   「更新一次把人家的東西弄不見」。
+
+**順手挖出的同族**（同一道閘一次抓到）：`console-dashboard.ts` 有 **4 處**、
+`console-auth.ts` 有 1 處相同寫法——console 首頁的規模數字與藏書地圖對 leo 也一直是空的。
+
 ## 快速檢查清單（做新功能前）
 
 - [ ] 這是工作流還是零件？問「有必要嗎？」
@@ -568,3 +605,6 @@ repo 早已是 343,969 bytes 的新品牌世代，`Songti` 一處不剩。
 - [ ] 本地/Gitea 改完 code 想 `acr update` 部署？先確認：它抓的是 GitHub codeload tarball，不是你剛改的目錄（#23）
 - [ ] 改完前端說「做完了」？先問**線上跑的是不是這一份**（`cd console-ui && npm run verify`）——組態綠不代表世代對（#25）
 - [ ] 要寫「含某關鍵字就擋」的閘？先想「有人寫一則說明它已被移除的註解時會怎樣」——關鍵字閘會腐爛，優先用指紋（#25）
+- [ ] 寫下 `env.X || '預設值'`？先問「這個字串是用來決定誰的資料嗎？」是 → 它是身分不是設定，不准有字面預設值（#26）
+- [ ] 要用某個字串過濾 owner_id？確認它與**寫入端**用的是同一個來源，不是另一份手抄的環境變數（#26）
+- [ ] 留了一道新的閘？它自己有測試嗎、誤攔案例驗過嗎、擋不擋得到自己？（#26）