Arcrun

Leo/Arcrun

Fork 0

Commit Graph

Author	SHA1	Message	Date
richblack	68f042cfd0	fix(resource-rule): 帳號上資源超過一頁時，規則看到的必須是全部（Arcrun#123 續集）三支清單方法只打 `?per_page=100`，也就是只看第一頁。這個洞在 #123 的修法前後嚴重度不同，這才是它必須跟那張票一起修的理由： · 修法前：被截掉的是「worker 綁著的那顆」→ 2b 判「綁著的資源不見了」 → blocker → 停手。誣告使用者，但安全。 · 修法後：被截掉的是「同名殘骸」→ 2c 判「這個名字沒被佔走」 → 去建 → CF 回 title already exists → #123 的死路原樣回來。 ⇒ 修法把它從「叫得太大聲」變成「安靜地復發」。分開出貨等於把 #123 的災情延後到「資源比較多的帳號」再爆。做法：`cfListAll()` 翻到底；翻不完、或數量對不上 CF 回報的 `total_count`，一律 throw ⇒ 變 blocker ⇒ 整趟停手（README 規則第 3 條）。「我不知道」不准被當成「它沒有」。三支端點的分頁行為不一樣（2026-08-14 在 geek6688 帳號實測，唯讀）： /storage/kv/namespaces result_info 有 total_pages /d1/database result_info 沒有 total_pages ⇒ 不能拿它當終止條件 /vectorize/v2/indexes result_info 是 null，不分頁（分頁參數被忽略）所以終止條件只用「三支都有或都沒有」的兩件事：result_info 在不在、total_count 對不對得上。 fixture 的清單端點同步照真 CF 的形狀分頁（三支各自不同）——假資料失真就會養出「拿 total_pages 當終止條件」這種在 D1 上必壞的實作，而測試全綠。新增 tests/list-pagination.mjs（在舊碼上實測會紅，且第 ③ 段直接重現「無 blocker → 排 10 顆新建 → CF 回 title already exists」的 #123 死路）。 cli 73 項全綠、demo 與 half-finished-install 全綠。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-08-14 19:52:24 +08:00
uncle6me-web	bb548b6fdf	refactor(shared): 「該用哪些資源」搬出 CLI——一份實作，acr 與安裝器吃同一條規則 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 乾淨。	2026-08-12 23:37:01 +08:00

Author

SHA1

Message

Date

richblack

68f042cfd0

fix(resource-rule): 帳號上資源超過一頁時，規則看到的必須是全部（Arcrun#123 續集）

三支清單方法只打 `?per_page=100`，也就是**只看第一頁**。這個洞在 #123 的修法
前後嚴重度不同，這才是它必須跟那張票一起修的理由：

  · 修法前：被截掉的是「worker 綁著的那顆」→ 2b 判「綁著的資源不見了」
            → blocker → 停手。誣告使用者，但安全。
  · 修法後：被截掉的是「同名殘骸」→ 2c 判「這個名字沒被佔走」
            → 去建 → CF 回 title already exists → #123 的死路原樣回來。

⇒ 修法把它從「叫得太大聲」變成「安靜地復發」。分開出貨等於把 #123 的災情
  延後到「資源比較多的帳號」再爆。

做法：`cfListAll()` 翻到底；翻不完、或數量對不上 CF 回報的 `total_count`，
一律 throw ⇒ 變 blocker ⇒ 整趟停手（README 規則第 3 條）。
「我不知道」不准被當成「它沒有」。

三支端點的分頁行為不一樣（2026-08-14 在 geek6688 帳號實測，唯讀）：
  /storage/kv/namespaces  result_info 有 total_pages
  /d1/database            result_info **沒有** total_pages ⇒ 不能拿它當終止條件
  /vectorize/v2/indexes   result_info 是 null，不分頁（分頁參數被忽略）
所以終止條件只用「三支都有或都沒有」的兩件事：result_info 在不在、total_count 對不對得上。

fixture 的清單端點同步照真 CF 的形狀分頁（三支各自不同）——假資料失真就會養出
「拿 total_pages 當終止條件」這種在 D1 上必壞的實作，而測試全綠。

新增 tests/list-pagination.mjs（在舊碼上實測會紅，且第 ③ 段直接重現
「無 blocker → 排 10 顆新建 → CF 回 title already exists」的 #123 死路）。
cli 73 項全綠、demo 與 half-finished-install 全綠。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

2026-08-14 19:52:24 +08:00

uncle6me-web

bb548b6fdf

refactor(shared): 「該用哪些資源」搬出 CLI——一份實作，acr 與安裝器吃同一條規則

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 乾淨。

2026-08-12 23:37:01 +08:00

2 Commits