Leo
e28e19069f
t142: 雲端子庫顯示同步幾張卡＋幾個三元組（政府專案驗收需求）
...
leo 07-29：「要在雲端子庫顯示同步了幾個 wiki，既然這樣也同步顯示有幾個三元組，
這是為了政府專案驗收。」
kbdb 兩支統計端點：
- entries.ts: COUNT(DISTINCT page_name) AS card_count
⚠️ 必須 distinct——算 block 數會膨脹 3-5 倍，政府驗收看到假數字比沒數字更糟
- records.ts: COUNT(*) AS triplet_count（三元組本來就算全部）
portal.ts 聚合兩者掛進庫目錄；前端 index.html 顯示。
驗：卡數確為 COUNT(DISTINCT page_name)／前端內嵌 JS node --check 全通過
（07-29 白畫面事故教訓）／portal-admin 測試 34 passed（改動前 31 passed，
唯一的 1 failed 是既有債：GET /portal 回 404，改動前後相同，非本次造成）。
註：此為子 CC 完成後未 commit 的懸置工作，總管收工檢查時發現並補收。
2026-07-29 19:55:03 +08:00
Leo
cdca296044
D36：修正四個零件契約的假資訊敘述（現行沒有發 API key 的機制）
...
leo 07-29 指正：「現在沒有 partner key，改用 namespace，現在沒有發 API key 的機制」。
這些契約寫著 'KBDB partner key（ak_xxx）'／'租戶識別（ak_ 前綴）'＝假資訊源——
總管就是被它騙的（先把範例改成不存在的 {{credential.kbdb_partner_key}}），
不修的話下一個 AI 會再挖同一個坑。
改：kbdb_upsert_block／auth_oauth2／auth_service_account／auth_static_key 的
api_key description，改述為「租戶識別＝Arcrun namespace」＋註明 examples 裡的
ak_test/ak_nonexistent 是測試假值不代表真實格式。
只動 description，不動 schema／欄位名／gherkin_tests
（api_key 欄位名保留——改名會破壞現有 workflow）。
驗：四檔 YAML 可解析、required 不變、欄位清單不變、gherkin_tests 全保留、
ak_test 等測試值原封不動。
人閘：leo 07-29 跑 scripts/component-arm.sh 解保險授權。
2026-07-29 19:38:14 +08:00
Leo
e8bd518efa
D36 第0步：範例 workflow 金鑰統一走 credential（止血——範例是用戶照抄的樣板）
...
改前四種寫法並存、沒一個是 credential，而執行端只認 {{credential.X}}
（graph-executor.ts:247→resolveCredentialRefs）⇒ 用戶照抄必踩坑：
{{api_key}} 13／{{gitea_token}} 2／{{secret.GITHUB_BOT_TOKEN}} 2／{{kbdb_api_key}} 1
改後（19 處統一）：
{{credential.arcrun_namespace}} 15／{{credential.gitea_token}} 2／{{credential.github_bot_token}} 2
⚠️ 中途修正一次錯誤命名：我先改成 kbdb_partner_key（照零件契約舊敘述 ak_xxx），
leo 當場指正「現在沒有 partner key，改用 namespace，沒有發 API key 的機制」——
實際機制確為 X-Arcrun-API-Key: <namespace>（實例上活的 workflow 為證）。
不動：{{secret.LEO_TELEGRAM_CHAT_ID}} 3 處——chat_id 是聊天室 ID 不是金鑰，
無腦套規則會引進「找不到 credential」的錯誤。
驗：違規寫法歸零／12 個範例 YAML 全可解析。
殘：kbdb_upsert_block 契約仍寫『KBDB partner key（ak_xxx）』＝假資訊源（我就是被它騙的），
修它被 component-guard 擋（正確），需 leo 跑 scripts/component-arm.sh。
2026-07-29 19:33:46 +08:00
159f0b07dc
🔴 🔴 fix: portal 白畫面——t131 誤刪上一個 IIFE 的收尾 })();
...
leo：「問題是 portal 是白的」。真因：t131 合併 AI 設定時刪掉舊的 chat-key/extractor 兩區，
**連同上一個 IIFE 的收尾 })(); 一起刪掉** ⇒ 整段 JS 語法錯（Unexpected end of file）
⇒ 瀏覽器整支 script 不執行＝白畫面。
**總管失職**：t131 驗收只跑了 vitest（測後端）＋grep 字串，**從未驗過前端 JS 語法**——
portal/index.html 是純前端檔，vitest 根本測不到它。
修：補回 })();；node --check 通過；os-split/safejson 測試綠。
2026-07-29 17:45:30 +08:00
9d38d580f2
feat(t131): AI 設定合併成一把金鑰——聊天與萃取共用，Claude 為選填加強
...
leo：「拿到一把就很難了，還要拿兩把。一律規定先輸入 gemini api key，
如果想要強化本地萃取，可以選擇 claude……前面那個，聊天和萃都一次設好，後面那把，不填就是 gemini」
＋「重點是更好的模型萃取知識更能抓重點，不然他也不知道加強什麼」（文案講感覺得到的差別）
＋「本地如果有裝 claude，掃到，只要一個 checkbox 就好」（daemon 偵測回報，沒偵測到就停用選項）。
- POST/GET /portal/admin/ai（一次寫 chat-key 與 extractor）＋/portal/daemon/report-capabilities
- 舊 chat-key/extractor 端點保留相容；UI 兩區合併成「AI 設定」
t131 新測 7 條全綠（總體 229 passed／9 紅皆 pre-existing：HTML shell 搬遷×2、library-map 未實作×6、
executor 零件×1）。（實作＝子 CC；驗證+commit＝總管）
2026-07-29 15:28:10 +08:00
0860e84d22
feat(t135): 庫目錄可自主移除＋標示還在不在同步
...
leo：「需要加移除按鈕。因為別人裝錯我沒辦法幫他弄，需要可以自主」
＋「你應該要顯示這個庫沒有本地對應的 folder，那就不容易刪錯」
（兩態非三態——leo 二修：「分兩種沒意義」，那是內部狀態不是用戶分類）。
- DELETE /portal/admin/libraries/:id（登記簿）與 by-name/:name（auto 庫需輸入庫名確認）
- kbdb 加 deprecate-by-library（auto 庫移除＝標 deprecated，資料保留可還原）
- daemon/libraries 存 active 清單 → 卡片標 🟢 同步中／灰目前沒有在同步
- 不自動刪（daemon 可能沒開機）；daemon 從未回報時整列不標
vitest 24 passed（1 紅＝console HTML 搬遷陳舊測試，非本案）。
（實作＝子 CC；驗證+commit＝總管。含 t116/t117 先前未 commit 的 graph-executor/wasi-shim 修正）
2026-07-29 14:45:44 +08:00
6d4980d3d7
fix(t130 🔴 🔴 ): PORTAL_TEMPLATE_SEEDS 補 triplet——新實例總圖不再永遠空
...
真兇（總管探針定罪）：seeds 只有 portal_user/portal_library，寫三元組回 400
'template not found: triplet' ⇒ 每個新用戶（含封測者）總圖必空。
geek6688 有是舊實例早期流程建過＝拿它驗會假綠（已記 mistakes）。
呼叫路徑已驗：daemon/libraries、admin/libraries、init/seed 皆會 ensurePortalTemplates（冪等）。
vitest 24/24 綠（總管親跑）。（實作＝子 CC；驗證+commit＝總管）
2026-07-29 14:35:36 +08:00
ccb86481ae
fix(t128+t129): 圖搜尋補 template:triplet＋AI 問答出處按頁去重
...
t128 真因（總管實測定罪）：t116 只補 kbdb_base，同一行 URL 還吃 {{input.template}}
⇒ /records/by-template/?owner_id=... 查不到；手動補 template 即 count=1
（企業版功能解鎖→控制→授權系統）。**同種病三犯，已記 mistakes。**
t129：一卡切 3-5 block 每段都算一筆命中 ⇒ dedupeSourcesByPage 後端去重＋hit_count。
vitest 52 passed（1 紅＝console HTML 搬遷陳舊測試，非本案）。
（實作＝子 CC；驗證+commit＝總管）
2026-07-29 14:11:52 +08:00
eb9f2db513
feat(t122 🔴 🔴 ): 萃取引擎雲端設定＋隨連線下發——封測者終於萃得出東西
...
真兇（總管查證）：daemon/config 寫死 extractor='claude' 且不下發金鑰 ⇒ 封測者 100% 萃取失敗
（leo：「地端沒有 AI 根本不能萃，那它就不能玩」）。
- POST/GET /portal/admin/extractor（admin 閘；GET 只回 has_key 不回明文）
- daemon/config 改讀設定：未設定→gemma 無金鑰；設定後→含 gemini_api_key
- portal 設定頁加「萃取引擎」區（Gemini 推薦＋aistudio 連結，存後提示「小幫手點連上知識庫重連即可」）
測試 3 條新綠（vitest 17 passed；1 紅＝console HTML 搬遷陳舊測試，非本案）。
（實作＝子 CC；驗證+commit＝總管）
2026-07-29 13:21:26 +08:00
429b2d965f
fix(t97+t114): 庫目錄只顯示用戶同步進來的庫、拿掉兩段式登記
...
leo 07-28 原話：「用戶沒加上的庫，不要自作主張給它加上」／「掃進來的就是要進目錄…
加入目錄這件小事還要分兩段做？…這是在攻打用戶嗎？根本是 attack」。
- portal.ts:859 auto 段濾掉 general（系統未標庫桶，非用戶的庫）
- index.html：bootstrap 不再預埋 kb 庫；移除「登記到目錄」按鈕與 auto/registered 視覺分岔
驗證（總管 grep 真相源）：登記到目錄=0、kb 種子=0、general 濾在；
os-split 10/10＋safejson 8/8 綠；portal-admin 1 紅＝console HTML 搬遷陳舊測試
（stash 基線同紅，與本案無關）。（實作＝子 CC；驗證+commit＝總管）
2026-07-28 23:54:57 +08:00
f6728974ea
fix(t115 🔴 🔴 🔴 三修): kbdb 認證完全 fail-closed——沒金鑰一律 401（含讀取）
...
leo 實證的洞＝「知道網址即可讀走全部知識」；一修 fail-open（沒設 secret 就不擋）、
二修仍放行讀取＝洞沒補。三修（總管手改）：無 token→全部 401（health 豁免），
老實例升級路徑＝重跑安裝器（同時注入金鑰與新 workflow），不以繼續外洩換相容。
＋結構閘測試：斷言 src/index.ts 的無 token 分支不得有 return next()——
擋「測試複本與真實作漂移」那類假綠（本輪正是它抓到二修的複本沒同步）。
kbdb vitest 60/60 全綠（總管親跑）。
2026-07-28 23:52:43 +08:00
2ff36962be
feat(t103): /health 回 bundle_version（讀 ARCRUN_BUNDLE_VERSION，無 var 回空=老實例）
...
daemon 比對用（leo：daemon 和雲端是連動的）。vitest 2/2 綠（總管親跑）。
（實作＝子 CC；驗證+commit＝總管）
2026-07-28 16:06:10 +08:00
e36cd2d990
fix(t95+t96): 查詢 CJK 邊界自動補空白＋圖譜節點模糊命中
...
leo 07-28 實測：「AI協作」（無空白）搜不到；圖譜搜「AI 協作」0 鄰居但總圖有
「AI 協作規範書」節點（「這個搜尋詞來自 Graph View 的一部分，居然搜不到？」）。
- normalizeCjkQuery：CJK↔ASCII 邊界插空白，search q 與 graph 節點名都過
- fuzzyFindNode：精確 0 鄰居時 fallback contains 比對（取最短命中）重查
測試 +18 全綠（vitest 197 passed；9 個既有紅=console HTML 搬遷陳舊測試，與本案無關，
stash 基線對照確認）。B5 分支衝突面已查：僅 line 274 一行。
（實作＝子 CC；驗證+commit＝總管）
2026-07-28 15:06:07 +08:00
ba92d10a3f
fix(t88): 拿掉庫管理頁「圖譜來源」概念——任何庫都能進總圖
...
leo 裁定（2026-07-28）：「任何的庫都要進到圖譜模式」「給他選擇就是客服問題」
「不要給他選，掃到就能進總圖，也不用停用按鈕」。
移除：標為/取消圖譜來源鈕、庫停用/啟用鈕與 dialog、graph_source tag 與過濾、
說明文字「標了圖譜來源的庫決定誰能用圖譜模式」；後端 API 不動；
用戶管理的「停用」（set-status）未動。diff +6/-33。
按鈕來歷（leo 問）：5a16484 第一刀拆分引入（當時 B5 不存在，粗閘是唯一保護）；
t52(139d4c5
2026-07-28 12:41:00 +08:00
a909072dc1
feat(t87): portal 兩處顯示「去後綴的乾淨網址」＋一鍵複製——連線不再要人抄網址列
...
leo 07-28 拍板：「一律用網址，把後綴拉掉，以免他貼了說我的網址錯了」。
設定頁「同步小幫手」卡＋管理頁「庫目錄管理」各一行：location.origin（無 /portal/#/ 後綴）
＋複製鈕（成功短暫顯示「已複製」，失敗 fallback 提示手動選取）。共用同一 helper。
os-split 10/10、safejson 8/8 仍綠（總管親跑）。（實作＝子 CC；審查+commit＝總管）
2026-07-28 12:04:04 +08:00
11e772496f
fix(t75 ①): portal 不再把 JSON 解析錯誤噴給使用者＋404 說人話
...
leo 同事實測：存 Gemini 金鑰時畫面出現
「Unexpected non-whitespace character after JSON at position 4」。
根因兩層：
① 前端 15 處無條件 r.json()，但伺服器不一定回 JSON——404 頁/CF 錯誤頁都是 HTML。
JSON.parse 一爆，錯誤沿 .catch 走到 friendlyErr，而 friendlyErr 最後一行是
＝把任何例外訊息原樣顯示 ⇒ 技術英文直接噴到畫面。
② 真正的原因是 /portal/admin/chat-key 回 404（實例的 cypher 是舊版沒這端點），
但使用者完全看不出來，只看到一句看不懂的英文。
修：
- 新增 safeJson(r)：用 r.text() 再 try/catch parse，解析不了回 {} 不拋錯；15 處改用它
- friendlyErr 收斂：JSON 類錯誤→「伺服器回應異常，請稍後再試」；
純英文技術訊息→「操作失敗」；我們自己寫的中文訊息才原樣顯示
- 兩處金鑰儲存加 404 專屬提示：「你的知識庫版本還沒有這個功能，請先更新知識庫」
——講清楚為什麼與怎麼辦，否則他只看到「儲存失敗」會反覆重試同一件事
- 順手：安裝卡片那處原本 x.d.error 在 x.d 為 undefined 時會再爆一次，補 x.d && 防護
測試 safejson.test.mjs 8/8：404 HTML 不拋錯／空回應／正常 JSON 仍解析得出／
JSON 錯誤不外洩原文且說人話／網路錯誤訊息保留／中文訊息原樣／英文技術訊息收斂。
⚠️ 這只解「不噴技術訊息」；金鑰要真的存得進去仍需實例更新 cypher（②層待辦）。
2026-07-28 01:02:12 +08:00
53c6334fd9
fix(portal/t72): 下載頁 OS 分流——Windows 客戶不再拿到 Mac 的 .app
...
leo 07-27：「客戶是用 windows 的」。此前四處寫死「下載 Mac 版」，
Windows 用戶按下去拿到 .app＝按了連到錯的東西（leo 判準：那不算友善）。
改法（施工圖 rag-wave1/windows-build-and-os-split.md §3）：
- daemonPick() 依 UA 判 OS，四處共用；判不出來＝兩個都給，不替用戶猜
- 判對了也附「不是這個系統？」另一版連結（UA 會判錯，用戶要有路走）
- 擋關話術跟著 OS 走：Mac=右鍵打開／Windows=更多資訊→仍要執行
- daemonBase 新 key，保留 daemonDownload 舊 key 相容（由檔名推目錄）
- 一律走 raw：Mac zip 21MB > jsDelivr 20MB 上限（實測回 File size exceeded）
測試 os-split.test.mjs 10/10：
⚠️ 測試抓到真 bug——iPhone 的 UA 含 'Mac OS X' 會被判成 Mac，
讓手機用戶下載裝不起來的桌面 app。已加 isMobile 排除，手機落到「兩個都給」。
未驗：真 Windows 機器的實際下載與安裝行為（需真機）。
2026-07-27 19:28:43 +08:00
Leo
d7fab7c6aa
fix(portal): 拿掉登記新庫／設定頁補常駐入口（下載小幫手＋AI 金鑰）
...
leo 07-27 走完安裝後三點回饋：
1) 「登記新庫」是設計錯誤 —— leo：「應該是同步小幫手抓到的庫就顯示在上面，
沒有人工登記的選項。」人工登記只會製造對不上的空庫。
移除表單＋對應 JS；說明改為「裝好同步小幫手並選好資料夾後，每個資料夾會自動
成為一個庫出現在下面，不需要人工新增。下面還是空的，代表小幫手還沒裝好或還沒選資料夾。」
2) AI 金鑰與下載連結只存在一次性的「還差 N 步」卡片，按了「稍後再說」或裝完就
再也找不到 —— 換金鑰／換電腦重新下載都沒入口。
設定頁新增兩個常駐面板：「同步小幫手」（下載）與「AI 問答金鑰」（可隨時更換），
共用既有 API POST /portal/admin/chat-key。
3) 修 window.ARCRUN_CFG → ARCRUN_CONFIG（與 721 行既有用法一致，原為筆誤）
驗證：ad-nl-create 殘留 0 ／ st-daemon-dl 2 ／ st-key-save 2 ／ ARCRUN_CFG 0
抽出頁面 3 個 script 區塊 node --check 語法通過
2026-07-27 16:26:52 +08:00
139d4c5ed1
feat(t52): 資料夾＝庫端到端——kbdb 加 /entries/libraries（資料面 distinct 庫）；portal 庫目錄合併「登記簿＋蓋章自動出現」(auto)；auto 庫改安全渲染（無 record_id 不放死按鈕，改給『登記到目錄』）＋daemon/libraries 自動登記端點。leo 07-26：地端 2 個資料夾雲端就要 2 個庫
2026-07-26 01:49:43 +08:00
e7fe83a872
feat(t54): 小幫手憑帳密自取設定——新端點 POST /portal/daemon/config（帳密驗證同 login，回連線設定不含知識內容）；portal 清單移除 config.json 下載（3 步→2 步）。leo 07-25：「最好的就是把它的帳密直接輸入」
2026-07-26 00:16:21 +08:00
8d19d0b2d7
fix(portal/t53): daemon 下載連結補實——zip 上鏡像（raw 路徑；jsDelivr 20MB 上限擋 21MB 檔）＋無下載點時誠實降級不放死連結（交付警察抓到 404 死連結）
2026-07-25 23:44:44 +08:00
a8d246ebe9
feat(portal/t53): 進站完成安裝清單（leo 07-25：金鑰與 daemon 要在站內做，不然安裝沒完成）——常駐三項清單（下載小幫手/下載 config.json 站內生成/貼 Gemini 金鑰即時啟用）＋新端點 POST /portal/admin/chat-key（改寫 tenant rag_chat 的 x-goog-api-key，admin 閘、金鑰不落 log）＋session 回 email 供 config 生成
2026-07-25 23:26:44 +08:00
11ffd42899
fix(portal/t49): 首登頁補逃生口——『已經有帳號？改用登入』＋setup 409 自動切登入帶提示（leo 實撞死路）
2026-07-25 21:12:31 +08:00
24f989d818
merge t49: portal 首登建帳＋歡迎引導（leo 07-25 令當晚交付；已先行部署 leo 實例驗證）
2026-07-25 20:35:33 +08:00
9bbd25fdfc
feat(portal/t49): 首登建帳一顆按鈕——auth-status 偵測未初始化→v-firstsetup（console/setup→portal/admin/bootstrap→自動登記預設庫 kb→portal/login 四發連鎖）＋進站一次性歡迎卡（下載小幫手/金鑰 → installer /setup）。leo 07-25：『加入的體驗要搞定』——用戶打開專屬網址第一眼就是建帳號，不再回安裝頁等
2026-07-25 20:35:33 +08:00
76b89be6d7
merge t36: console 語意搜尋改狀態列（假開關＋CLI 指示移除，click handler 一併拆——leo 07-25 口頭核准 merge）
2026-07-25 20:29:40 +08:00
beb0653e15
fix(console/t36): 語意搜尋改狀態列——移除按不動的假開關與 CLI 指示
...
leo 2026-07-25 定案：語意搜尋預設開啟、不做開關（費用實算後屬雜訊——1 萬張卡規模
下 Vectorize 約 $0.18/月，佔 CF 帳單 3~4%；關掉省幾毛錢卻換來很爛的搜尋體驗）。
設定頁那顆「語意搜尋（vectorize）」開關其實不能按（title 自承「不能遠端改，只如實
顯示狀態」），旁邊還教用戶去部署端改 config.yaml 跑 acr update——對一鍵安裝進來的
用戶那是天書（與 t35 同一種白癡化違規），而且安裝器現在裝機時就把語意索引開好了，
那段指示本身已不成立。
改成單純狀態列：啟用時只說「已啟用，搜尋頁切語意就能用」不給任何操作指示；未啟用
才給一句人話與下一步（重跑安裝流程會補上，已建資料不重來）。
⚠️ 連帶必修：一併移除綁在該開關上的 click handler——留著會讓 $('st-vec-switch')
回 null、addEventListener 當場拋錯，把後面所有綁定（含登出）一起打斷。
驗：三個 script 區塊語法檢查通過、全檔已無 st-vec-switch/st-vec-state 殘留參照。
2026-07-25 08:51:54 +00:00
ab8e07201f
proposal(CP2-F): cypher 二～四刀拆分提案——bundle 528KB 實測解剖＋引擎留原地方案（待 leo confirm）
...
偵察實測（wrangler dry-run＋sourcemap byte 歸因，非推測）：
- 現碼 11,050 行／bundle 528.1KB——頂層 CP2-F 記載（15,446 行/748KB）是第一刀前舊數，提案 §0 更正
- zod 佔 130.6KB（24.7%），只服務兩條入口驗證鏈＝最大單一減重點
- 引擎真身僅 ~180KB，其餘 ~350KB 是管理/前端 API 面
方案：引擎留 cypher-executor 原地（webhook 觸發 URL 外部焊死、零改動），
新開 arcrun-api 收管理面；三刀漸進、每刀獨立回退；13 顆 SVC binding 不動。
依 D35 只寫 proposal 停下，不動 code、不部署。
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com >
2026-07-24 15:37:51 +08:00
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
Leo
1b687fedb0
fix(mcp): 解掉三個把人推去寫零件的誤導入口（leo 2026-07-21 拍板）
...
leo：「刪掉，技術者才會寫 component，在 Arcrun repo 寫一條如何 contribute
指向另一個 repo 就好。」
實測病灶：總管想寫「定期打 API 然後通知」的 workflow（Python 約 10 行），
問 foreach_control 怎麼用 → MCP 回傳 TinyGo 寫 WASM 零件教學（白名單/syscall/
contract schema）＝完全另一件事，40 分鐘未完成。
三處修正：
1. search_components 搜不到時的話術——原本建議 publish_component（把「我找不到」
翻譯成「你去造一個」，方向完全相反）。改為導向正確順序：語意搜尋知識庫→
auth-recipe list/scaffold→acr parts（http_request 能打任意 API）→acr list，
並明說 registry 可能是空的（已知問題），搜不到≠沒有這能力。
2. registry.ts 停用 publish_component / get_component_guide 兩個註冊
（檔案保留，只是不對 AI 暴露）。
3. 新增 CONTRIBUTING-components.md：三層責任分工（平台通用能力／熱門預鋪 recipe／
冷門誰用到誰開發）、什麼時候才真需要新零件、真要貢獻走 PR 的流程。
typecheck 通過。
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com >
2026-07-21 16:42:51 +08:00
Leo
98d87d5d3f
principles: 前端人類友善／Arcrun AI 友善，都從終點看（leo 2026-07-21）
...
判準＝AI 覺得 Arcrun 比 Python 簡單，沒有寫 Python 的慾望，絕不可迷路。
使用方式應意圖驅動：不用想有哪些零件，描述目的→機器給建議→用 >> 黏起來。
實證：總管做「定期打 API 然後通知」（Python 10 行）Arcrun 40 分鐘未完成，
全程被 component guide／publish_component 建議推向鑄零件。
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com >
2026-07-21 13:00:15 +08:00
Leo
5edb97c49d
docs: CLAUDE.md 加「第一鐵律：wiki 是判準，不准跳過」
...
leo 2026-07-21：「其他 repos 各自都要警覺不能跳過 wiki」。
hook 只是提醒，鐵律要寫在本 repo AI 開工必讀的地方。
含 grep 查法、三條硬規則、動外部系統前先找現成腳本（別自創方法）。
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com >
2026-07-21 10:55:40 +08:00
Leo
efc29b78c2
chore: template 1.16.1——wiki-first-search 補 Bash 破口
...
1.16.0 只掛 Grep|Glob|Read，但「用 curl/wrangler 亂試方法」走 Bash → hook 不觸發，
上線隔天即被繞過（leo 2026-07-21 實證：wiki 早記著寄信已驗證可用，我沒查又自創）。
matcher 補 Bash，只認高風險指令（wrangler|curl|npx|acr|gh|deploy|push）。
本 repo 亦需警覺：動外部系統前先看 hook 推的 wiki 命中，別自創方法。
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com >
2026-07-21 10:54:15 +08:00
Leo
8d8b01d240
docs(sdd): credential-primitives-wasm 封存進 archive（T10 完成，卷已結案）
...
leo 2026-07-21 明令封存：卷已完成，留主目錄會讓未來 session 誤以為進行中。
最後一項 T10（廢除自管加密金鑰）已於 20c7610noreply@anthropic.com >
2026-07-21 01:57:34 +08:00
Leo
df1b953d1f
chore: template 1.16.0——wiki 讀取兩支 hook（查詢即搜尋 wiki＋subagent 自動注入）
...
leo 2026-07-20：「花很多力氣去產生 wiki，最重要的就是要可以查詢，
結果要查的時候就跳過，那就白寫了」
- wiki-first-search.sh（Grep|Glob|Read）：查 code 的當下用同組關鍵字 grep wiki，只推命中行
- subagent-wiki-guard.sh（Task）：查證類任務自動注入「先查 wiki」給 subagent
- update.sh/install.sh 來源改指 Gitea（原指 GitHub uncle6me-web 已 suspend＝自動更新早就死了）
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com >
2026-07-21 01:40:55 +08:00
Leo
20c7610371
refactor: 移除已廢棄的自管加密金鑰機制（credential 全面託管 CF Workers Secrets）
...
leo 2026-07-20 明令：「已經改用 cf 自己的 secrets，不要再說它了」
「我希望以後再也看不到這個詞再出現」
背景：credential 早已遷移至 CF Workers per-script Secrets + D1 目錄，
舊的自管金鑰（client 端 AES-GCM + KV 密文 + crypto_decrypt）是遷移期遺留。
本次連根移除，含一併作廢的死 SaaS 碼。
移除：
- 舊 KV 密文解密路徑（credential-injector.ts 整檔、dual-read fallback）
前置驗證：leo21c / youlin 兩帳號 CREDENTIALS_KV 實測 *:cred:* 皆 0 筆
- migrate-to-workers-secrets 搬家端點（回填已完成，無可回填）
- /register 路由與 generateApiKey（HMAC 產 ak_ key 是 SaaS 遺物；
self-hosted 走 namespace 明碼 D21，已無人使用）
- platform_crypto component（三帳號實測 404 已退役，無 workflow 引用）
保留（附理由）：
- crypto_decrypt 保留為永遠回失敗的 stub——現役三個 auth .wasm 仍宣告該
import，缺項會讓 WASM instantiate 直接失敗。待零件重編後可真正刪除。
順帶修復（原不在範圍，但會實際壞事）：
- /auth/callback 有 `if (!key) redirect(server_error)` 閘，未設該 secret 的
實例會登入直接失敗 → 已移除
- OAuth 兩處把 provider token 寫進舊加密 KV（租戶鍵與實際 api_key 在 rotate
後必然分歧，已失效）→ 改導向 Workers Secrets，包 try/catch 不影響登入
- acr init Standard 模式呼叫已刪除的 /register → 改引導 OAuth 取 key
- .claude/rules 與 system-dev/docs 是同一規範的兩份鏡像，先前只改 rules
導致鏡像仍在教舊做法 → 已同步（此類雙檔同步應納入檢查）
新用戶安裝從此零 secret 前置。
測試 187/188（唯一 fail 為 pre-existing，stash 驗證與本次無關）；
cypher-executor 與 cli typecheck 全綠。
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com >
2026-07-21 01:32:48 +08:00
b9b94d7852
docs(sdd): library-map tasks M1-M5+M3 銷帳（07-19 雙實例上線）、M7 半驗
2026-07-19 11:21:33 +00:00
Leo
762d2f5141
Merge pull request 'feat(console): library-map M5 — 總庫搜尋頁藏書地圖首頁區塊（R4）' ( #74 ) from feat/console-library-map-home into main
2026-07-19 09:36:04 +00:00
10dda9e6f5
feat(console): library-map M5 — 總庫搜尋頁藏書地圖首頁區塊（R4）
...
library-map SDD M5（Arcrun#39）：console 首頁從空白搜尋框變全館地圖。
落點裁定：console 是 hash-routing 單頁殼，home 隨 profile（full=駕駛艙、
rag=總庫搜尋）——地圖放總庫搜尋頁搜尋框上方：rag profile 該頁即首頁；
full profile 它是全館入口，「點庫卡片→進該庫搜尋」動線同頁最短，一份實作
兩 profile 全吃。
- console.ts：藏書地圖區塊（lm-section）——每庫一張卡（庫名＋narrative＋
top entities 前 5 帶 degree＋triplet_count＋commit_hash/updated 更新時間感）、
跨庫 bridges 有資料才列一小區；兩段式渲染（全館列表先出卡，逐庫詳圖補
degree/bridges，詳圖失敗維持名字版不擋）；點庫卡片＝設 library filter
（/kbdb/search 既有 library 參數，不新造）進庫搜尋，附清除鈕搜回全館；
/map 空陣列或錯誤＝誠實空狀態（指引 POST /map/recompute backfill），
不擋搜尋等其他功能。品牌沿 CONSOLE_BRAND 變數（#21），零外部庫。
- kbdb-proxy.ts：GET /kbdb/map＋/kbdb/map/:library 純轉發（rule 07，聚合真身
在 kbdb base M2）。owner_id 不強制注入只選擇性透傳（同 M4 MCP kbdb_get_map
語意；現行 backfill map block owner=NULL，強制注入租戶＝首頁永遠假空狀態）；
仍要求 X-Arcrun-API-Key 同閘；KBDB 不可達誠實 502。
- 測試：kbdb-map-proxy.test.ts 9 測（租戶閘/轉發/owner 透傳/空陣列/404/502）＋
console-library-map-page.test.ts 6 測（route 200/區塊在搜尋框上方/資料源接線/
library 參數/誠實空狀態文案/品牌變數）——15/15 過。
- 誠實回報：tsc 16 行 ExecutionContext.tracing 錯誤與 executor.test 1 失敗＝
main 基線既有（git stash 對照實證），非本分支引入。
merge 後需 gated redeploy cypher-executor（leo 閘）。關聯 #39。
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com >
Claude-Session: https://claude.ai/code/session_01JUmjwkHLVBHM3ydhT1WSW3
2026-07-19 09:34:36 +00:00
Leo
289cd495b4
Merge pull request 'feat(mcp): library-map M4 — kbdb_get_map 工具＋instructions 注入全館地圖' ( #73 ) from feat/mcp-library-map-inject into main
2026-07-19 09:13:46 +00:00
343572bf5d
feat(mcp): library-map M4 — kbdb_get_map tool + instructions 注入全館地圖
...
library-map SDD M4（design §4，源頭 #39）。兩件：
1. kbdb_get_map（tools/kbdb_map.ts，與 #68 kbdb_graph_neighbors 同族薄殼）：
- 無參數＝全館地圖（每庫一行：library＋narrative＋top 3 entities＋triplet_count）
- 帶 library＝該庫詳圖；top_entities/relation_profile/bridges 若為 JSON 字串形
容錯 parse 成物件（parse 失敗當空陣列，不 crash）
- 404/空庫誠實回報＋POST /map/recompute backfill 指引
- 走既有 KBDB service binding（kbdbFetch），不碰 D1、不新增 binding
2. instructions 注入（lib/library-map.ts＋mcp-handler.ts）：
- 連線時拉 GET /map，渲染成緊湊文字（{library}：{narrative}｜核心：{top3}｜{n} triplets）
嵌 server instructions（design §6：session 啟動 push 零查詢）
- 快取選型：isolate 內 TTL 快取（成功 5min／失敗 1min）——stateless StreamableHTTP
每個 HTTP request 重建 McpServer，「每次現拉」實際是每個 tool call 都多打一次 /map
- timeout 1.5s；任何失敗（超時/HTTP錯/空庫/壞JSON）回 null 靜默略過，絕不擋 MCP 連線（鐵律）
測試：假 KBDB binding（比照 kbdb-graph.test.ts）17 新測，pnpm vitest run 76/76 過、tsc --noEmit 乾淨。
merge 後需 gated redeploy arcrun-mcp（leo 閘）。
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com >
Claude-Session: https://claude.ai/code/session_01JUmjwkHLVBHM3ydhT1WSW3
2026-07-19 09:11:46 +00:00
Leo
bdfc2e3e0b
Merge pull request 'feat(kbdb): 藏書地圖 M1+M2 — library_map template＋/map 三端點（聚合 SQL 住基本盤）' ( #72 ) from feat/library-map-base into main
2026-07-19 08:42:42 +00:00
15fe012006
feat(kbdb): 藏書地圖 M1+M2 — library_map template＋/map 端點（聚合 SQL 住基本盤）( #39 )
...
M1：library_map template（migration 0003 seed＋runtime ensure，D6 零建表零 ALTER）；
核實 triplet 按庫定位＝不足（prod triplet template 無 library slot、entries
metadata.library 未標記）→ 走 SDD 預案：recompute 冪等補 optional library slot
（改 template 不動表），slot 值由 ingest 端（M3）補寫，核實結果記入 design §1。
M2：kbdb base 三端點（design §2 歸屬裁定：聚合 SQL 只准住基本盤）：
- POST /map/recompute?library=X：degree top-N／predicate 分布／跨庫 bridges／
triplet_count 一段 SQL 聚合；narrative 本輪收 body 傳入（wiki 抽取屬 M3）；
寫入順序安全（先建新 active map block 再標舊 superseded，讀端取最新 active 自癒）；
過渡 source_prefix fallback 讓無 library 值的舊 triplet 靠 source_uri 前綴歸庫。
- GET /map：全館地圖每庫一行（library＋narrative＋top 3 entities＋triplet_count），
MCP instructions／GUI 共用（數百 token 內）。
- GET /map/:library：該庫詳圖（完整 slots＋可嵌人話 content，design §5 M6 直用）。
測試：node:sqlite（零新依賴）當真 SQLite 實跑 migrations＋聚合 SQL，
Hono route 行為同款覆蓋；45/45 過、tsc --noEmit 乾淨。
關聯 #39
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com >
Claude-Session: https://claude.ai/code/session_01JUmjwkHLVBHM3ydhT1WSW3
2026-07-19 08:40:22 +00:00
bad68ef149
docs(sdd): library-map design 標 leo confirmed 可動工
2026-07-19 08:27:53 +00:00
0ba685af9f
Merge remote-tracking branch 'origin/feat/mcp-graph-neighbors-tool'
...
# Conflicts:
# system-dev/wiki/status.md
2026-07-19 08:05:22 +00:00
7eeab9f26f
feat(mcp): kbdb_graph_neighbors — graph 鄰居查詢薄殼（#68）
...
MCP 面補齊 D17 KBDB RAG 套餐第三模式（關鍵字/語義/圖）：
- 新 tool kbdb_graph_neighbors：subject（必填）/depth（預設 1）/kbdb_base/
template（預設 graph_triplet）/directed，形狀對齊
registry/examples/graph-neighbors/workflow.yaml 的 input
- 薄殼調 GET /q/{orgNamespace}/graph_neighbors 同步查詢端點（#28 地基），
走既有 CYPHER_EXECUTOR service binding，不新增 binding、不碰 D1、
不動 workflow 引擎本體
- workflow 未部署 → 404 誠實回 workflow_not_installed ＋安裝指引，不 crash；
HTTP 200 但 workflow 層 success:false 也不假綠
- graph_traverse 不加：repo 內無該 workflow 定義可對齊 input 形狀，不猜
- 測試：tests/unit/tools/kbdb-graph.test.ts（7 測，全綠）；tsc --noEmit 乾淨；
mcp 全套 vitest 59/59 綠
merge 後需 gated redeploy arcrun-mcp（leo 閘）。
關聯 #68
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com >
Claude-Session: https://claude.ai/code/session_01JUmjwkHLVBHM3ydhT1WSW3
2026-07-19 07:55:16 +00:00
1ee0dbd2fe
docs(sdd): library-map（藏書地圖）SDD 出稿 draft——#39 立案 11 天催辦補課；含 D6 歸屬裁定（SQL 住基本盤）＋D30 檢索治本連動
2026-07-19 07:54:23 +00:00
65d85eb08f
fix(kbdb): search keyword 補 source filter（#66）＋semantic 曝 top_k/min_score 帶 score（#67）
...
#66：/entries/search keyword 路徑 source 解析後丟棄（#5.1 只接了 listEntries 那半）——
searchEntries 尾端加 source?（既有 positional caller 全不用改），conds 補與 listEntries
同款 json_extract(metadata_json,'$.source') 謂詞；route keyword 分支與 semantic 降級
分支兩處傳入。
#67：semantic 固定 topK=20、零分數閾值、低分尾硬湊數——route 曝 top_k（預設 20、封頂
100）與 min_score（預設 0＝不過濾）query 參數；semanticSearch 依 min_score 截低分尾；
semantic 回應 entry 附 score 欄（加欄不改形）。壞值（非數字/非正）視同沒帶，不 400。
向後相容：不帶新參數時輸出與現況一致（semantic 僅多 score 資訊）；不動表（D6）、
不動 D1 結構（API-as-Wall）。測試：新增 search-source-and-score.test.ts 13 條
（source 謂詞形狀/route 下傳/降級不洩 filter/min_score 截斷/topK 透傳封頂/壞值防呆/
不帶參數行為不變），kbdb vitest 33/33 綠、tsc 0。
關聯 #66 #67。merge 後需 gated redeploy kbdb worker（leo 閘）。
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com >
Claude-Session: https://claude.ai/code/session_01JUmjwkHLVBHM3ydhT1WSW3
2026-07-19 07:53:46 +00:00
2324537165
docs(sdd): 1.5-3 補機制邊界（分享≠同步、與 acr update 兩軌）＋changelog/版本 diff 規格（leo 修正）
2026-07-19 07:00:42 +00:00
Leo
uncle6me-web