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

6 Commits

Author SHA1 Message Date
uncle6me-web 36cdc8fba6 #10 補測試守衛＋console 兩頁同族 fallback 一併拔 
① tests/portal-admin-ai.test.ts（6 項綠）＝**route 消失就會紅**的迴歸防線。
   這條 route 以前不存在、前端卻一直在打它 ⇒ key 從來沒存進去（藍字＝假綠），
   所以最該守的就是「它還在不在」。覆蓋：未登入 401（**不是 404**＝route 真的在）／
   非 admin 403／GET 回 has_key 布林且回應不含任何金鑰欄位（D36）／
   空 body 400 不假裝成功／只改偏好不誤報 has_key／同測試內寫→讀一致。
   註：vitest-pool-workers 預設 isolatedStorage=true ⇒ 跨 it 的 KV 會還原，
   驗來回一致必須在同一個 it 內完成（我第一版寫成跨 it，測試如實抓出來了）。

② console/index.html 與 console/dashboard/index.html 也有同一個寫死
   `|| "https://cypher.arcrun.dev"` fallback（與 portal 同族）⇒ 一併拔掉。
   靜態 config.js 保留無妨：build-ui-bundle.mjs 的 SKIP 會跳過它、改由 worker 動態產生。

驗證：cypher tsc 綠、全套 248 passed（9 既有失敗未變）；
UI 產物 grep 寫死 fallback 歸 0；stage verify.sh 仍 11/3（無迴歸）。
 2026-07-31 20:57:05 +08:00
uncle6me-web 0d49989c19 修 arcrun-rag#10：補 /portal/admin/ai（key 從來沒存進去的真因）＋UI 已輸入態 
真因（不是重裝洗掉，是從來沒存進去）：前端唯一寫入路徑 POST /portal/admin/ai
**後端從來沒有這條 route** ⇒ 用戶填 key → 404 → 什麼都沒存，畫面卻像成功了（藍字＝假綠）。
產物層鐵證：bundle tier2/ui grep 'portal/admin/ai'=1、tier2/cypher=0；兩實例實打皆 404。
反證（別改不壞的東西）：走正確端點寫入 → 完整重裝 24/24 → credential 仍在、
rag_chat verdict failed→success ⇒ **重裝不洗 credential，資料層本來就是保留式的**。

① cypher 補 GET|POST /portal/admin/ai（routes/portal.ts）
   - POST 內部轉呼 credentials.ts 既有 storeCredential()＝**唯一寫入路徑**，不另造第二套
   - GET 只回 has_key 布林，**永不回傳 key 本身**（D36）
   - credential 的 api_key 欄＝租戶 slug（portalTenant），與安裝器 seedCredential 寫
     kbdb_internal_token 用的 ns 同值 ⇒ 同租戶分區，彼此查得到
   - use_claude_for_extract 存 KV（單一布林偏好，不為它開 KBDB template）
   - claude_available 目前無訊號來源（該由小幫手回報）⇒ **誠實回 false 不假綠**
   - 寫入失敗回 502 帶原因——本 bug 的教訓就是「不能讓前端以為存好了」
   - 兩者皆未提供 → 400，避免「看起來成功但什麼都沒做」

② 前端（console-ui/public/portal/index.html）
   - 拔掉寫死 `|| "https://cypher.arcrun.dev"` fallback ⇒ 缺 config.js 就顯示紅色橫幅明顯報錯。
     **寧可明顯失敗，不要靜默把用戶金鑰送去中央實例。**
     ⚠️ 更正我先前的錯誤診斷：config.js **有**正確注入（實查 leo 實例指向自己的 cypher），
     跨租戶錯置未發生；這條是未爆彈不是現行災情。
   - leo 規格：已存 → 唯讀「已輸入」＋「修改」鈕（不顯示 key）；按修改才變回輸入框；
     未存 → 一般輸入框。舊版只改 placeholder＝讀起來像臨時提示，是它像 UI bug 的原因。
   - 只有真的送了新 key 才切回「已輸入」（單純改 Claude 勾選不誤報）

tsc 綠；三個 script 區塊 node --check 全過。
卷：system-dev/docs/3-specs/journeys/gemini-key-lost-on-reinstall.md
 2026-07-31 19:56:47 +08:00
uncle6me-web 9f777ff43e t161+t162 修 leo prod 實撞兩病：庫清單靜默空白／「需要更新」假警報迴圈 
t162（假警報，實錘）：daemon cloudVersionStale() 讀 cypher /health 的 bundle_version
比對 minCloudBuilt(2026-07-28)，但 **/health 從來只回 {ok:true}、沒有這個欄位**
⇒ 恆讀到空字串 ⇒ 恆判 stale ⇒ 「知識庫需要更新」永遠不消失，重裝也沒用
（leo：「按下就跳到 install，但重新更新後並不會消失，這個訊息是幹嘛的？」）。
安裝器其實一直有注入 ARCRUN_BUNDLE_VERSION（worker.js:819），只是沒人吐出來。
修：/health 讀該 var 誠實回報（未注入則省略欄位＝老實例，daemon 判 stale 是對的）。
新 bundle 注入值 2026-07-31+<commit7> ≥ 2026-07-28 ⇒ 重裝後警報自然消失。

t161（庫清單空白）：portal 前端 guard401 → dropSession() **靜默**清 token 跳登入頁，
畫面不說任何原因 ⇒ 用戶看到的是「庫不見了」而非「請重新登入」（leo：「實際上根本
沒連上任何庫，清單空白」）。修：dropSession 帶原因寫進 #login-status——
「你的登入已過期，請重新登入（你的資料都還在，不會遺失）。」
資料側無恙（portal_library records=2 已驗），純讀側 session 過期＋靜默 UX 缺陷。

驗：cypher tsc 全綠；vitest 9 failed/187 passed＝基線不變。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-31 15:34:27 +08:00
uncle6me-web e744ad1f96 t160 世代債清除（leo：「如果你會搞不清楚，就把錯的東西刪掉」）——repo 只留一個 UI 世代 
事故鏈（07-31 深夜，leo 刷新撞到）：t159 重打包 staging bundle 時，build-ui-bundle
吃了 feat/step3 分支的 console-ui/public/——該分支基底早於 main d7fab7c
「拿掉登記新庫」，public 停在舊世代 ⇒ youlin 實例 UI 被打回被淘汰的
「登記新庫」人工表單典範（07-27 mistakes 已記帳的 src/public 雙世代債，
這次由「分支副本停舊代」路徑引爆——債沒還，任何一個部署路徑都會引爆它）。

刪掉的（舊世代，git rm 實體刪除）：
- console-ui/src/（console.ts/console-dashboard.ts/portal-ui.ts）＝07-22 從
  cypher-executor 搬出的 renderer 快照，自 07-27 起與 public/ 真身脫鉤、只會
  重產舊 UI
- console-ui/scripts/build.mjs＝從上述舊 renderer 重產 public 的 build 步驟
  （deploy.mjs 原自動跑它＝引爆器本體）
- cypher POST /portal/admin/libraries（人工建庫端點）＝死端點（e28e190 起 UI
  零呼叫；leo 規格「要直通 daemon，同步，沒有登記這回事」）。GET 列表／PATCH
  管理／t159 daemon 自動登記照舊

新唯一源：console-ui/public/＝手改演進的真身（本 commit 同步到 main e28e190
世代＋註解字樣改寫達成「登記新庫」全檔 0 命中）；deploy.mjs 改為直接託管
public（無 build 步）＋世代閘（缺「不需要人工新增」或含「登記新庫」拒部署）。

驗：tsc 全綠；deploy.mjs node --check 過；重打 ui bundle 242KB 過世代閘，
指紋「登記新庫」=0／「不需要人工新增」=1。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-31 14:36:48 +08:00
uncle6me-web ad367e450d console-ui: 修好壞了一個月的 build + 具名部署目標（個人版/企業版） 
🔴 根因：5a16484 把 UI 搬 CF Pages 時「移出 → console-ui/」實際上只搬了
build 產物（HTML），三支 renderer 原始檔被刪且沒搬 →
`npm run build` 從那天起 ENOENT 死掉，線上 HTML 是刪檔前烤好的，
一個月來無法重建（CONSOLE_PROFILE 改了也不會生效，因為 build 跑不起來）。

修法：
- 從 git 撈回 console.ts(1623)/portal-ui.ts(1390)/console-dashboard.ts(822)
  放進 console-ui/src/——UI 原始碼跟著 UI 專案走，才是那一刀的原意
- build.mjs 加 resolveSource()：本地 src/ 優先，找不到才回退 cypher-executor

新增具名部署目標（deploy.targets.json + scripts/deploy.mjs）：
一個目標＝帳號＋profile＋apiBase 綁在一起，解決三次帶漏參數：
- demo 站漏 CONSOLE_PROFILE=rag → 顯示個人版 7 頁駕駛艙（leo「進去是 Mira 介面」的真因）
- 兩站漏 ARCRUN_API_BASE → apiBase 空 → 前端打自己 405 → 登不進去
- 兩帳號都有同名 arcrun-console-ui 專案且 wrangler OAuth 登入在 uncle6
  → 不指定帳號 deploy 會部到 demo 站（差點蓋掉，改用 API token 鎖帳號）

  npm run deploy:personal    → leo21c, profile=full(7頁), apiBase 指 leo21c worker
  npm run deploy:enterprise  → uncle6, profile=rag(4頁落地搜尋), apiBase 指 cypher.arcrun.dev

實測（用戶真的會走的路）：
- mira.uncle6.me/console/ 200，VIEWS 7 頁，apiBase 對，CORS ACAO 通
- rag-demo.arcrun.dev 4 頁落地搜尋；登入 OK、搜「藍鯨導航儀」5 筆（未受部署影響）

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-22 19:09:29 +08:00
Leo 5a164843ef refactor(cypher): 第一刀拆分——UI 搬 CF Pages，ingest 從必爆變穩定 
根因（leo 2026-07-21 三個判斷全被數字證實）：
- 「cypher 展開上萬行，當時我就懷疑這樣跑得動嗎」→ 15,446 行、bundle 748KB
- 「不相信 CF 連讀文字檔都會撞牆」→ 不是 CF 的問題，是 cypher 太肥
- 「它違反了樂高化的原則」→ 零件 4KB，調度它們的 cypher 是巨石

定位錯誤（比效能更根本）：console.ts:1 自陳「Mira Console」，而 wiki 明載
「Mira 是 Arcrun 的使用者，不是開發者」→ 使用者的前端寫進了框架的執行引擎。
CLI/MCP 都已拆成獨立薄殼，唯獨 UI 沒有。責任誠實記：console.ts 標
「2026-07-04 總管派工」，是總管當初選了「就近寫在 cypher」的方便路。

本刀：
- console.ts(1623行) + portal-ui.ts(1390行) 移出 → console-ui/ CF Pages 專案
  （單檔 HTML + 原生 JS，零 build step，保持原特性）
- index.ts 移除兩個路由掛載、修 implicit any
- console-dashboard.ts 只留 API（UI 部分移出）

實測驗收（leo 指定判準：不看 /health，看真實任務）：
| 測試 | 拆分前 | 拆分後 |
|---|---|---|
| 連灌 10 張新卡（無間隔） | 從未成功 | 10 張全 create、73 條三元組 |
| 同卡連跑 6 次 | 前 2 過、後 4 全 1102 | 6 次全過 |
| Bundle | 747.9 KB | 528.0 KB（-29%） |

Pages 已上線：arcrun-console-ui.pages.dev（console/portal 皆 200）
cypher API 正常：/health、/console/dashboard-data 皆 200

未做（第二刀）：console-dashboard/portal/portal-data 尚未拆，cypher 仍 528KB。
但 ingest 已穩定，急迫性下降。

註：部署撞到三個既有 self-hosted 陷阱（KV/D1 id 是官方帳號的、arcrun.dev route
leo21c 無該 zone），用 wrangler.leo21c.toml 繞過，未改原始設定檔。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-21 18:55:31 +08:00