uncle6me-web
bb548b6fdf
leo 2026-08-12：「根本就不應該在 CLI，我要的是一個大家都可以用到的規則。」
「這個實例該用哪些資源」換到安裝器就要重寫一次 ⇒ 依 rules/07-thin-shell.md 的判準
它是**能力**，而它原本住在 cli/src/lib/resource-resolver.ts ⇒ 那本身就是違規。
後果已經真的發生：acr 那條有 Arcrun#97 的修法、安裝器那條沒有，於是安裝器照名字
找、找不到就建一顆空的綁上去 ⇒「我按了更新，工作流和登入全不見了」。
規則搬到 shared/resource-rule/（零依賴 ESM，Node 與 Workers runtime 都直接跑）：
· rule.mjs 規則本體＋把 CF 回應讀成事實的 normalizeLive*
· cf-resource-api.mjs ResourceApi 的 CF REST 實作——**眼睛也共用**：
兩條路各自解讀 CF 回應，只要一邊看不到既有綁定就會去新建，
#97 不需要規則寫錯就能重演
· installer-entry.mjs 安裝器唯一該碰的入口 resolveInstanceResources()
不是做成 cypher 端點的理由（自舉）：這條規則要在「決定怎麼裝」的當下就用得到，
而那時 cypher 可能還不存在（安裝器的工作正是把它生出來）；且輸入是使用者自己帳號的
綁定狀態，不該送去平台換答案。它是純函式，用不著變成服務。
只有一份，機械看守：
· 安裝器直接 import repo archive 裡的原稿，**不需要副本**
· acr 因為 npm pack 打不進套件目錄外的檔案，帶一份逐位元組鏡射
（scripts/sync-resource-rule.mjs 產生；build/test 先跑 --check，差一位元組就紅）
——同 cli/harness/ 產生物＋世代閘的既有慣例
· cli/tests/single-implementation.test.ts 掃全 repo：7 支規則函式的實作只有一處
CLI 淨 -496 行（邏輯是搬走，不是複製）。cf-api.ts 的 CfAccountClient 保留公開介面，
ResourceApi 那七個方法全部委派共用 client。
驗證：cli 58/58 綠（含新增的兩條路一致性 fixture ＋ 三種情境），tsc --noEmit 乾淨。
43 lines
1.5 KiB
TypeScript
43 lines
1.5 KiB
TypeScript
/**
|
||
* resource-resolver.ts — **這裡沒有邏輯**，只是把共用規則接到 CLI 的既有 import 路徑上。
|
||
*
|
||
* 「這個實例該用哪些資源」的規則住在 `shared/resource-rule/`（repo 根目錄），
|
||
* 那是**唯一一份人手維護的實作**；`./resource-rule/` 是該目錄的逐位元組鏡射
|
||
* （`scripts/sync-resource-rule.mjs` 產生，`npm run build` / `npm test` 會跑 `--check` 擋漂移）。
|
||
* 之所以要有這份鏡射：`arcrun` 是獨立 npm 套件，`npm pack` 打不進套件目錄外的檔案。
|
||
*
|
||
* 為什麼規則不在 CLI（leo 2026-08-12）：
|
||
* 「根本就不應該在 CLI，我要的是一個大家都可以用到的規則。」
|
||
* ——`acr` 有這條規則、安裝器沒有，結果就是 Arcrun#97：
|
||
* 安裝器照名字找、找不到就建一顆空的綁上去，使用者的工作流與登入狀態整片消失。
|
||
* 規則搬到共用層之後，安裝器直接 import 同一份原稿，**不再有第二種答案**。
|
||
*
|
||
* 🔴 不要把任何判斷寫回這個檔案。要改規則 → 改 `shared/resource-rule/rule.mjs`。
|
||
*/
|
||
|
||
export {
|
||
planResources,
|
||
applyResourcePlan,
|
||
parseWranglerRequirements,
|
||
normalizeLiveBindings,
|
||
normalizeLiveVars,
|
||
bindingKey,
|
||
ResourcePlanBlocked,
|
||
KIND_LABEL,
|
||
TABLE_KIND,
|
||
} from './resource-rule/rule.mjs';
|
||
|
||
export type {
|
||
ResourceKind,
|
||
LiveBinding,
|
||
ScriptBindings,
|
||
ResourceApi,
|
||
BindingRequirement,
|
||
PlannedAdopt,
|
||
PlannedCreate,
|
||
ResourcePlan,
|
||
ResolvedResource,
|
||
WranglerRequirements,
|
||
RawWorkerBinding,
|
||
} from './resource-rule/rule.mjs';
|