Leo/Arcrun
1
0
Fork 0
Code Issues 49 Pull Requests 5 Actions Packages Projects Releases Wiki Activity
410 Commits 27 Branches 0 Tags
main
Commit Graph

26 Commits

Author SHA1 Message Date
uncle6me-web 7dc3e615e9 merge: 內部 uninstaller 進 main（Arcrun#119/#120/#122） 
它已經在 youlin 上真的用過，卻只活在分支上——8/14 就因此被總管誤判成「不存在」。
留在分支＝下一次還會再消失一次。

內容：scripts/teardown-instance.mjs（535 行，唯一新增檔）
  · plan／apply --yes 兩段式
  · leo21c 在 deny-list
  · central KV 操作前機械核對 wrangler 身分（D88）

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-15 01:37:40 +08:00
uncle6me-web 45169ab25e feat(build): 一個實例會用到的每一顆 worker 都在 Arcrun 編（D91／Arcrun#125） 
官方編譯點從 5 顆擴到 23 顆，並把 portal 前端的產生器從 arcrun-rag 搬回來。

為什麼不是「順手多編幾顆」：
- 只編 5 顆 ⇒ 下游 bundle 裡就只有 5 顆 ⇒「零件用到才下載」沒有貨可以下載。
  而 auth_static_key 是每一支產品工作流解 {{credential.X}} 都會打的那一顆
  ⇒ 走網頁安裝器裝出來的實例，工作流一跑就 500（Arcrun#124 的 error code: 1042）。
- portal 前端（arcrun-rag-ui）當時仍由 arcrun-rag 自己拼裝原始碼
  ⇒ 使用者拿到的那顆 worker，沒有任何 Arcrun commit 說得出它的來源。
  leo：「今天開始出貨一律不准在 arcrun rag 或任何別的地方 build，這就是 arcrun 的專屬工作。」

做法：
- 零件 worker 改用**掃描** .component-builds/（不是手寫清單——手寫清單就是
  arcrun-rag#27／D48 那個病的形狀），worker 名一律讀該零件自己的 wrangler.toml。
- 可出貨的判準＝**部署位元組在版控裡**。.gitignore 明文排除的三顆
  （claude_api／km_writer／kbdb_upsert_block，DECISIONS §1「錯做成零件」）
  因此自動落在公庫外，而且是**寫進 manifest.excluded 的**，不是安靜跳過。
- 輸出目錄改成每次只留這一輪該有的，清掉舊成品（拔掉棘輪）。
- UI 產生器原樣搬過來，兩道閘（世代閘、前端 JS 語法閘）一起搬——
  它們驗的是本 repo 的 console-ui/public，本來就該長在來源這一側。

實測（本機 worktree，依 lockfile 重裝依賴後）：
- 23/23 編成功；四顆既有引擎成品**位元組完全重現** committed 值
  （cypher 8e6487478bc8／kbdb f15e16cca6ce／code 751634a3fc9a／mcp 9bc8dffb34d0／
   http-request cdd97364f277）⇒ 這次擴充沒有動到既有零件。
- arcrun-rag-ui 的產出與搬家前逐位元比對，**只差第一行註解**
  （那行必須改：它原本指向一支不再產生它的腳本）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-15 00:59:59 +08:00
uncle6me-web 5d441aa7d3 fix(teardown): 中心側補上帳號白名單——原本 central-* 碰得到 leo21c 
實測破口（2026-08-14，修補前）：
  central-plan --account-id 51a01bfa…(leo21c)
  → 一路暢通，列出 deployed:51a01bfa…:leo21c
  加 --yes 就會刪掉 leo 的安裝紀錄 ⇒ 他下次重裝撞 Arcrun#120 死結。

根因是兩個問題被當成同一個：
  ① 動的是「誰的」紀錄 → assertAccountAllowed（帳號側有，中心側沒有）
  ② 以「誰的身分」動手   → assertWranglerIsCentralAccount（D88 補的那道）
c543aba 的註解寫「這個不對稱現在補齊」，但只補了②。註解說補齊、程式補一半，
後來讀的人會相信註解——所以順手把那段註解改成實測講法。

另修 listAllScripts 沒翻頁（ops-facts 記過的同款坑）。在這支工具裡漏看一顆
worker 有兩層傷害：拆不乾淨，以及「共用資源保護」看不到那個 owner，
把還在用的資源判成沒人用而刪掉。

並補一條已知限制：資源清單是從 worker binding 反推、不掃帳號，
所以沒人綁的孤兒殘骸不會被列也不會被刪（這正是 drill-a/drill-b 不受影響的原因，
但代價是拆完重裝可能撞 Arcrun#123，要自己再列一次帳號）。

驗證（youlin，全唯讀，未執行 apply）：
- plan：6 顆 worker ＋ 10 個資源（8 顆 yuga3bse KV／yuga3bse-db／embed-m3），
  drill-a、drill-b 不在清單
- leo21c 帳號側、中心側 兩條路徑皆 exit 1 拒絕
- youlin 中心側仍正常：staging 通道有 deployed:1129efd7…:youlin-hsieh-dev 一筆

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-14 19:51:31 +08:00
uncle6me-web c543abaa8a fix(teardown): central KV 操作前機械核對 wrangler 身分（D88，leo 審核裁示①，必修項） 
leo 審核意見：「這條正好違反 D88——閘要長在機器上，不是長在誰的記性上。而且失敗模式
是最壞的那種：靜默打錯帳號的中心 KV，沒有任何東西會叫。帳號側有白名單擋、中心側完全
沒有——這個不對稱本身就是設計缺口。」

修法：assertWranglerIsCentralAccount() 在 planCentralCleanup()（central-plan／
central-apply 共用的入口）最前面跑 `wrangler whoami --json`，核對登入態的帳號清單裡
有 uncle6（58309bb90fd93ad6d0fe0aae99170e9d）才放行，沒有就丟錯拒絕整個操作。
已用模擬錯誤帳號 id 驗證比對邏輯正確拒絕；正常路徑（真的登入 uncle6）central-plan
照常運作，貼在同一次 commit 的測試輸出裡。

同時把 leo 裁示②（apply 的依賴序失敗不擋併、但要記實測輪數）補進「已知限制」段：
兩次實測收斂輪數分別是 2 輪（有外部依賴殘留時）與 3 輪（純內部 service binding 鏈時）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-14 14:29:03 +08:00
uncle6me-web 49248b18c5 docs(teardown): 記下兩層咬合的已知限制（跨 worker 依賴鏈，2026-08-14 實撞） 
今天實跑撞到、也解掉的真事：kbdb-graph-plugin（不屬於這台實例，正確被排除不動）
身上有 service binding 指著 arcrun-kbdb（要刪的）→ CF 拒絕刪除，本工具只回報那次
DELETE 失敗，不會主動點出「有外部依賴卡住」。若選擇半殘留（清資源留殼），下一步
acr init/update 的 resource-rule fail-closed 保護會正確拒絕重裝——這是它該有的行為，
但代表本工具留下的半殘留會讓下一步卡住，不是「拆一半也沒關係」。

本工具目前無法自動偵測跨 worker 依賴鏈，寫進「已知限制」而不是假裝判準完備。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-14 14:20:56 +08:00
uncle6me-web 05e879faa7 fix(teardown): 拿掉 wrangler kv key delete 的 --force（這版 wrangler 沒這個 flag） 
實跑撞到：這台裝的 wrangler 4.100.0 的 `kv key delete` 沒有 --force，帶了就直接
「Unknown argument: force」失敗。central-apply 兩個通道各撞一次才發現。

拿掉 --force 後在真實 youlin 帳號實測：central-apply 兩個通道（prod INSTALLER_KV
+ staging PEER_INSTALLER_KV）的 deployed:<accountId>: 紀錄都刪除成功，central-plan
複驗兩邊皆印「沒有殘留紀錄」。這是 Arcrun#120 死結修復鏈路的必要一步。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-14 14:13:39 +08:00
uncle6me-web 7498911856 WIP: 內部 uninstaller 工具（拆帳號側 + 中心 KV），尚未跑過 apply（Arcrun#119/#120/#122） 
leo 交辦：先做出「拆乾淨→重裝」的內部工具，在 youlin 帳號上自己能用即可，
不是產品（對外版另計）。D82 三步驗收（全新安裝→更新→解除安裝）需要拆的能力才測得到，
沒有它就永遠測不到 #119/#120 這類「只有全新用戶才撞得到」的坑。

目前做到：
- scripts/teardown-instance.mjs：
  - plan/apply 兩階段（預設唯讀只印清單，真要刪要 apply --yes）
  - 帳號白名單（只認 youlin，明確擋 leo21c）
  - 歸屬判準：worker 名字要出現在本 repo wrangler*.toml 或官方 bundle manifest.core[]
    才算「已知」，不認得的一律列出不動（例如 kbdb-graph-plugin，不屬於這台實例）
  - 共用資源保護：同一顆 KV/D1/Vectorize 若也被「保留中的 worker」綁著，排除不刪
  - central-plan/central-apply：清中心 INSTALLER_KV／PEER_INSTALLER_KV 的
    deployed:<accountId>: 紀錄（#120 死結的另一半，帳號側清了但這裡沒清會卡死重裝）
  - 已用 `plan` 在 youlin 帳號實跑過（唯讀），清單看起來合理，貼在 issue/回報裡

還沒做：
- apply（真的刪）、central-apply、以及刪完後的重裝驗證，全部還沒跑
- 已知限制列在檔頭註解：判準是「repo 認不認得」不是「屬於哪一台實例」，
  同帳號多台同名慣例實例分不出來（今天 youlin 上短暫同時有正式實例與
  ship-stage-119 的 freshtest 測試實例，此時就是靠人工 --keep 排除）

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-14 13:25:39 +08:00
Leo 2fcae722e7 Merge PR #112: 藏書地圖看得到自己的知識——租戶字串改從寫入端來（Arcrun#108） 
總管複驗（不聽自述，自己重跑並與 base 逐條比對）：
  cypher  14 failed / 441 passed（base 14 / 400）⇒ 多 41 條新測試全過
          失敗清單 diff 無輸出＝逐字元相同、零回歸
  閘實測  照 #105/#108 的原句形狀種一個違規（env.CONSOLE_TENANT || leo）
          → 掃描器當場抓到並指名道姓；移除後恢復綠 ⇒ 不是假綠

這道閘的價值超過本票：它擋的是「身分來自環境變數」整族，
#105 那句話今天再寫一次也會被擋。符合 leo 08-12 立的
「做平台要減少 hotfix」——修掉 bug 不算完成，要留下下次再犯會被擋住的機制。

agent 誠實標的殘項（不擋併）：
  · kbdb_get_map 回 1851、Portal 總圖畫面、部分授權帳號實測——都要部署 leo21c，紅線沒碰
  · 想把閘也接進 .claude/hooks/pre-write-guard.sh（寫入前就擋），該檔受保護改不動；
    檢查器已備妥 --stdin 模式，總管代接
 2026-08-12 16:24:45 +00:00
uncle6me-web b223a69884 fix(portal): 藏書地圖看得到自己的知識——租戶字串改從「寫入端」來，不再拿環境變數預設值（Arcrun#108） 
leo 2026-08-12 實撞：藏書地圖回 0 個庫，同一分鐘 KBDB 裡有 1854 條三元組，
`arcrun_whoami` 顯示 admin／全部知識庫、`kbdb_search` 也查得到——只有地圖那格是空的。

病根（不是資料掉了，是讀寫兩端各拿一個來源）：
  寫入端 owner_id ＝ `~/.arcrun/config.yaml` 的 `api_key`（CLI push／小幫手上傳／MCP，
    leo ＝ `bfezv28v`）
  讀取端過濾 ＝ `portalTenant(env) = env.CONSOLE_TENANT || "leo"`
    ——repo toml 帶的**官方 prod 值**，而 `acr` 從來不注入 CONSOLE_TENANT
  ⇒ 那個 `"leo"` 不是理論邊角，是每台 self-hosted 實例的實際行為，1854 條全被濾掉。

與 #105（`env.MCP_OWNER_NAMESPACE || "leo"`）同一句話，換一個檔案。

租戶字串該從哪裡來（本票的核心判斷）：
  **從「寫入這批知識的那一方」來，不是從一份手抄的環境變數預設值來。**
  不是「掛到每個帳號上」——portal 帳號共用同一台實例的知識庫（design D-2），
  帳號之間的差別是 libraries 權限不是 owner_id；複製一份到帳號上只是多一個會過期的副本。
  #105 真正的教訓是：過濾用的租戶字串要有單一權威來源、解析不到要誠實失敗、且要能機械驗證。

修法：
1. 唯一產地 `cypher-executor/src/lib/tenant.ts`
   - `knowledgeOwner(env)` → branded `TenantId`：`ARCRUN_NAMESPACE` → `CONSOLE_TENANT` →
     丟 `TenantUnresolvedError`。**沒有字面預設值**——`|| 'leo'` 正是把「這台機器沒設定」
     偽裝成「你沒有資料」的元凶。
   - `accountTenant(env)` → 普通 `string`（帳號子 namespace `{tenant}::portal` 與 cypher
     自己寫的設定用它）。**回 string 是刻意的**：型別上就不可能流進知識資料面。
   - 資料面過濾一律經 `ownerQuery()` / `ownerField()`，只吃 `TenantId`。
2. 值的正解由 CLI 從真相源導出：`acr update` 把 config 的 `api_key` 注入成 `ARCRUN_NAMESPACE`，
   但**先驗再寫**（`GET /kbdb/map?owner_id=<api_key>` 查得到庫才寫；查不到／問不到就一個字
   都不動）。無條件覆蓋會把「知識本來就在 CONSOLE_TENANT 底下」的一鍵安裝實例指向空的那一格
   ——那是 #97/#106 那類「更新一次把人家的東西弄不見」，比原本的 bug 更糟。
   未注入時回退 CONSOLE_TENANT ⇒ 對官方 prod 與未更新的實例，這次改動是惰性的。
3. 空地圖分四態（沿 #100「讀不到就說讀不到」）：no_library_grant／filtered_out／
   scope_mismatch／confirmed_empty。scope_mismatch 以前不存在，所以設定錯誤被畫成
   「你沒有資料」。回應仍不含租戶字串（design §3.3 紅線）。
4. 同族一起修（同一道閘一次抓到）：console-dashboard 4 處、console-auth 1 處
   ——console 首頁的規模數字與藏書地圖對 leo 也一直是空的。

留下的閘（規則存在但沒機制驗證＝會再犯第三次）：
  · 型別閘：TenantId 只能由 tenant.ts 產出 → 拿隨手一個 string 去過濾，tsc 當場不給過。
  · 出貨閘：scripts/build-worker-artifacts.mjs 編 tier2 成品前先掃，違規 → 編不出成品。
  · 閘自己可測：規則是純函式（tenant-source-rules.mjs），tests/tenant-gate.test.ts
    逐條驗「5 種壞例子會擋」＋「11 種合法寫法零誤攔」；掃描範圍只有 src/，擋不到自己。
  規範寫入 .claude/rules/02-forbidden.md 第六類、system-dev/wiki/mistakes.md #26。

沒動：庫權限過濾（一字未改，回歸測試釘住）、帳號資料落點、任何金鑰、租戶字串仍不下發前端。

驗證：
  cypher   vitest 441 綠 / 14 紅，14 紅與 base commit e05518a 逐字相同（既有）
           tsc 5 個既有錯誤，零新增
  cli      node:test 60/60 綠（含本次新增 12 條）；tsc 零錯誤
  閘       壞例子實跑 exit 1；build 實跑「建置中止」；乾淨時實跑通過
  端到端   ◐ 未驗：需部署到 leo21c，那道閘要 leo 親手解（見 PR ③）

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-13 00:15:58 +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
Leo dcb6ad693b fix(build-worker-artifacts): dirty 判斷排除自己的輸出目錄 
.worker-builds/ 是本腳本的輸出，在成品寫出、commit 之前永遠是 untracked——
拿它判斷「原始碼乾不乾淨」是自己把自己判成髒的假陽性。git status pathspec
排除 .worker-builds 後才是「原始碼有沒有未 commit 變更」的真實訊號。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-11 13:45:33 +08:00
Leo 3b0238bb28 Arcrun#80: 新增 tier2 worker 官方編譯腳本（成品固定位置的地基） 
背景：安裝器（arcrun-rag）過去自己對 Arcrun 原始碼跑 esbuild，導致同一份原始碼在
不同機器編出不同位元組（見 arcrun-rag changelog 1.4.33 段、arcrun-rag#72）：
① esbuild 把入口路徑寫進產物內部註解，該路徑預設相依於執行時 cwd
② 各 worker 目錄用不同套件管理器裝 node_modules，夾帶不同版本間接依賴

本腳本解法：
- absWorkingDir 固定為「本腳本自己算出的 repo 根目錄」，entry 一律用相對路徑餵給
  esbuild——不管 clone 放在磁碟哪個絕對路徑，esbuild 內部產生的相對路徑字串相同
- 不自己跑 install，強制要求呼叫者先用該目錄既有 lockfile 裝好依賴（pnpm frozen /
  npm ci），避免「install 方式不同 → 依賴版本不同 → 位元組不同」
- 每顆 worker 的 manifest entry 自帶 source_commit（該目錄最後改動的 commit），
  答到單顆層級，不是整包一個 source 欄位

涵蓋 5 顆 tier2 worker（與 arcrun-rag bundle-components.mjs CORE_COMPONENTS 對齊）：
cypher-executor / kbdb / http_request / code / mcp。

scripts/ 自帶 package.json + pnpm-lock.yaml 鎖 esbuild 版本（0.24.0）——
工具版本本身也是重現性的輸入之一。

驗證：本地跑通 5/5 build；byte-identical 重現性驗證見後續 commit（兩個獨立 clone
比對 sha256）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-11 13:45:33 +08:00
uncle6me-web 453dec60b1 fix(scripts): template 來源改指活帳號，404 不再靜默寫入垃圾內容 
scripts/install.sh 與 scripts/update.sh 的更新來源指向已被 GitHub suspend 的
uncle6me-web 帳號，實測全部 404 ⇒ 自動更新靜默失效。改成與 system-dev-template
本體、以及本 repo 現行世代 system-dev/scripts/ 一致的正解：預設公開 GitHub
youlinhsieh/system-dev-template，可用 TEMPLATE_SOURCE 環境變數覆寫，不改檔。

同時補上 looks_like_error_page 判斷（沿用 template repo 已修好的寫法）：curl
對 404 常回傳非空的錯誤頁內容，只判斷「非空」會把它當成正常檔案寫入且不報錯。
現在錯誤頁會被偵測、檔案不寫入、FAILED 清單於結尾列出、腳本以非零狀態碼結束。

實測：
- 修正後來源多個路徑回真實 HTTP 200（CLAUDE.md／VERSION／self-update 兩支腳本）。
- 刻意把 TEMPLATE_SOURCE 指回死帳號重跑兩支腳本：全部項目進 FAILED 清單、
  無任何檔案被錯誤頁污染、exit code 1。
- 兩支腳本 bash -n 語法檢查通過。

已知缺口（不在本次範圍，留待另決）：template repo 內部檔案佈局已從
.claude/wiki/、docs/ 搬到 system-dev/ 前綴，這兩支舊世代腳本仍用舊路徑，
其中一部分檔案（wiki 範本、docs/README、SDD 範本等）在新帳號上仍 404——
現在會清楚回報失敗而不是靜默吞掉，但尚未逐一改點新路徑。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
 2026-08-09 20:54:01 +08:00
uncle6me-web 98869c5abc fix(publish): 匯出樹刪 .gitattributes(同步) 2026-07-18 23:45:44 +08:00
uncle6me-web d6a051dbfc feat(publish): sanitize 鉤子(同步 arcrun-rag 版) 2026-07-18 23:29:32 +08:00
uncle6me-web 14d4d65848 fix(publish): push 憑證改 header 注入(GITHUB_MIRROR_TOKEN env),token 不進 URL/指令行 2026-07-18 22:41:06 +08:00
uncle6me-web ca57fd6a1a chore(gc): GitHub 公開 mirror 管線(publish-github.sh+排除清單)——D22 模型落地:Gitea 私有真相源/GitHub 過濾樹乾淨歷史 2026-07-18 20:21:15 +08:00
uncle6me-web 5d38b599fd feat(#11): CLI/MCP 薄殼對齊 — P0 run 死端點修 + P1 list 同源 + R4 防複發機制 
P0 CLI run 改打 /webhooks/named/:name/trigger 真端點（原打 /webhooks/<name> 死端點 404）。
P1 CLI/MCP list 收斂到 GET /webhooks/named（KV 同源）：
   - CLI list 停 CfKvClient 直連 KV，順手修 key 前綴 bug（原讀 workflow: 對不上部署的 {apiKey}:wf:）
     + self-hosted 不再需 CF API token。
   - MCP u6u_list_workflows 從讀 KBDB record 改讀 GET /webhooks/named（registry 簽名加 partnerToken）。
R4 防複發機制：
   - cli-mcp-capability-matrix.md（13 能力對照，docs/ gitignored 不進此 commit，僅本機）
   - thin-shell-smoke.sh（對真端點斷言非 404，本機手動跑非 CI/cron）
   - 機制自驗：注入故意死端點當場攔下、exit 1。

依賴關係：本批依賴 #8（webhooks-named GET 補 description/created_at 欄位、search/backfill 端點），
故疊在 feat/issue-8 branch 上、作獨立 commit。

⚠️ tsc 綠 = code done 非完成。端到端待 leo21c（CLI/MCP 真打通 200 非 404、smoke 對已部署 prod
全綠——目前 smoke 揭 #8 search/backfill 在 prod 仍 404=未部署）。P2 validate 收斂待 #10、
tag resource_id 語意債待方向①。#11 留 open。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-27 19:36:58 +08:00
uncle6me-web 558e80b4da chore(wiki): wiki-init 補骨架 + system-dev-template 安裝/更新腳本 
wiki 已初始化過（push 檔活躍維護），本次補從沒建的 pull 層 + arcrun 化範本：
- cards/decisions/ 14 張決策原子卡（含 gloss/實體/typed-edge 三元組）：
  從 decisions-summary 全量改寫 13 + 新增「薄殼規則晚於實作-MCP漂移是歷史債」1
- TAXONOMY 從 PKM 範本換成 arcrun 軸（子系統 零件架構/cypher/credential/recipe/kbdb/
  薄殼/部署/平台原則 + 形態 架構決策/踩坑/機制說明/禁令/案例經驗）
- principles 填 13 條跨全局原則（從 rules/ + mindset 蒸餾）
- INDEX 真實視圖（子系統角度 + 決策角度，指向 cards）
- system-dev/scripts/ + scripts/ install/update 安裝腳本（template 接入）

純基建/文檔，無業務 code（功能 code 見前一 commit）。
raw source（docs/）0 異動、wiki 卡際連結無斷鏈。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-27 17:53:37 +08:00
uncle6me-web b9bf3ec3d5 fix(mcp,kbdb): LI M3 skills/examples 改打基本盤 /entries（修死 route 假綠） 
skills/examples 整條從舊 v3 /blocks /search 改打 KBDB 基本盤 /entries
（entry_type 對應）。5 個已上線 MCP 工具原本對死 route 回 404（假綠），
現修正；sync-registry-to-kbdb.py 改打 /entries idempotent upsert。
誠實降級：基本盤無語義 search → LIKE 關鍵字（embed 模組上線再換回語義）。
順手 gitignore scripts/__pycache__/。

對應 kbdb-base tasks 9.4 / llm-interface M3.2/M3.4。mcp + kbdb tsc exit 0。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-14 22:12:11 +08:00
uncle6me-web b17d0080ee chore(release): cli 1.3.5 + local-deploy.sh 全形字緊鄰 $VAR 的 set -u crash 修復（同 8346596 根因） 
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-12 20:19:52 +08:00
uncle6me-web 8346596ceb fix(release-check): brace-delimit $VAR before full-width parens (set -u unbound var crash) 
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-10 17:31:28 +08:00
uncle6me-web 0620fb5601 chore(release): local-deploy.sh CLI publish 優先用 .env NPM_API_TOKEN 
互動 npm login 常因 publish 安全政策 403；改優先讀 .env 的 NPM_API_TOKEN
（authToken 方式）publish，無 token 才退回 npm whoami。token 不入 log。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-06 17:33:14 +08:00
uncle6me-web 3d3de8b917 chore(release): deploy-from-committed 防呆流程（git 閘 + 清單） 
壓測階段 6 抓到漂移新形態：cypher 改了但沒推 main → acr init 從 origin/main
codeload 抓到舊 worker → 薄殼打不存在的 /init/seed → 404。根因是「deploy 前沒先 push」。

防呆（沒 GH Actions，deploy 分開推，靠清單+閘不漏）：
- scripts/check-release.sh 加「0. Git 同步」段：工作目錄髒 / 領先 origin/main 未 push → exit 1
- scripts/local-deploy.sh 實際 deploy 前強制跑 git 閘（未過拒絕 deploy；SKIP_GIT_CHECK=true 可強推）
- RELEASE-CHECKLIST.md：正確順序（先 commit+push main → 再 deploy → 線上打新端點驗證）

核心鐵則：self-hosted acr init 從 origin/main 抓 worker 源，故 git push 必須在 deploy 之前。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-06 15:51:51 +08:00
uncle6me-web 3e65e22775 feat: 薄殼原則落地 + seed 下沉 API + MCP 進主庫 + 部署一致性 
壓測四橫向問題修正（docs 壓測報告）：

① 薄殼原則成鐵律：能力長在 API，CLI/MCP/lib 只暴露
   - seed 下沉成 API 行為：cypher-executor POST /init/seed（一次灌 API+auth recipe），
     種子資料移到 server src/lib/api-recipe-seeds.ts，CLI 改薄殼一次呼叫
   - 解除 deployFullyOk 連坐 + init 補 seed auth recipe + update 補 seed/全 KV
   - registry SUBMISSIONS_KV 補進 REQUIRED_KV_NAMESPACES（修 20/21）

② MCP 統一帳號來源（單一 remote MCP + .env 切 MCP URL）
   - MCP 從 sibling repo 搬進 arcrun/mcp/（remote Worker，route 改 mcp.arcrun.dev）
   - config 加 mcp_url 三層解析 + getMcpUrl + DEFAULT_MCP_URL
   - 新增 acr mcp-setup：依 config 寫專案 .mcp.json（接案切資料夾自動切 MCP）
   - acr --version 改動態讀 package.json（根治漂移）

③ Deploy 一致性
   - tests/release.feature + scripts/check-release.sh
   - local-deploy.sh：CLI npm publish + auto patch bump + CHANGELOG
   - local-deploy.sh bash 3.2 相容修正（mapfile / 空陣列 set -u）
   - builtins/pnpm-lock.yaml

④ README self-hosted 同步現況（移除 R2 殘留、加 flag/env、多帳號）

CLI bump → 1.3.0

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-06 15:45:35 +08:00
uncle6me-web 922a57fe34 arcrun — AI workflow execution engine (clean history) 
Self-hosted 開源：WASM 零件 + recipe + cypher-executor，跑在你自己的 Cloudflare。

此為重建的乾淨歷史起點（移除曾誤 commit 的 GCP SA 金鑰，舊歷史保留在
richblack/arcrun 與本地 backup 分支）。含：
- acr init --self-hosted installer（建 KV/R2 + codeload 拉預編譯 wasm + wrangler deploy + seed recipe）
- recipe push 把關（資料外流提醒 + 打通檢查）
- 19 個正當零件預編譯 wasm（claude_api/km_writer/kbdb_upsert_block 排除：違反 DECISIONS §1）
- CLI / cypher-executor / registry / 完整 SDD

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-03 15:52:38 +08:00