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

208 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
uncle6me-web 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
uncle6me-web 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
uncle6me-web 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
uncle6me-web 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
uncle6me-web 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
uncle6me-web 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
uncle6me-web 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
uncle6me-web ba92d10a3f fix(t88): 拿掉庫管理頁「圖譜來源」概念——任何庫都能進總圖 
leo 裁定（2026-07-28）：「任何的庫都要進到圖譜模式」「給他選擇就是客服問題」
「不要給他選，掃到就能進總圖，也不用停用按鈕」。
移除：標為/取消圖譜來源鈕、庫停用/啟用鈕與 dialog、graph_source tag 與過濾、
說明文字「標了圖譜來源的庫決定誰能用圖譜模式」；後端 API 不動；
用戶管理的「停用」（set-status）未動。diff +6/-33。
按鈕來歷（leo 問）：5a16484 第一刀拆分引入（當時 B5 不存在，粗閘是唯一保護）；
t52(139d4c5) 補 auto 庫說明。拆的是過期鷹架非錯誤設計。
（實作＝子 CC；驗證+commit＝總管）
 2026-07-28 12:41:00 +08:00
uncle6me-web 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
uncle6me-web 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
uncle6me-web 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
uncle6me-web 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
uncle6me-web e7fe83a872 feat(t54): 小幫手憑帳密自取設定——新端點 POST /portal/daemon/config（帳密驗證同 login，回連線設定不含知識內容）；portal 清單移除 config.json 下載（3 步→2 步）。leo 07-25：「最好的就是把它的帳密直接輸入」 2026-07-26 00:16:21 +08:00
uncle6me-web 8d19d0b2d7 fix(portal/t53): daemon 下載連結補實——zip 上鏡像（raw 路徑；jsDelivr 20MB 上限擋 21MB 檔）＋無下載點時誠實降級不放死連結（交付警察抓到 404 死連結） 2026-07-25 23:44:44 +08:00
uncle6me-web 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
uncle6me-web 11ffd42899 fix(portal/t49): 首登頁補逃生口——『已經有帳號？改用登入』＋setup 409 自動切登入帶提示（leo 實撞死路） 2026-07-25 21:12:31 +08:00
uncle6me-web 24f989d818 merge t49: portal 首登建帳＋歡迎引導（leo 07-25 令當晚交付；已先行部署 leo 實例驗證） 2026-07-25 20:35:33 +08:00
uncle6me-web 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
uncle6me-web 76b89be6d7 merge t36: console 語意搜尋改狀態列（假開關＋CLI 指示移除，click handler 一併拆——leo 07-25 口頭核准 merge） 2026-07-25 20:29:40 +08:00
Claude 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
uncle6me-web 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
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
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（廢除自管加密金鑰）已於 20c7610 完成（移除約 2500 行）。

- git mv 整卷 → system-dev/docs/3-specs/archive/credential-primitives-wasm/
  design.md status: closed；superseded_by 留空（據實：非被另一卷取代，是機制整個換掉）
- 卷首補「封存時仍未完成的項目」——逐條查 code 核實，不當作完成：
  真缺口＝auth_mtls 從未實作、7.6 self-hosted auth 鏈端到端從未驗；
  另有勾選過期（auth_oauth2 其實已完成）與驗收條件已作廢（與現行 rule 07 牴觸）者
- 修好 14 處引用（原盤點 10 處，實際更多）：session-start-load-sdd.sh 內容嚴重過期
  （把已完成 Phase 寫成進行中）→ 改為以 frontmatter 為判準；四份 rules、CLAUDE.md、
  BACKLOG、3-specs/README、deploy.ts、credentials.ts、wrangler.toml 逐一按性質處理
- 額外：system-dev/docs/2-architecture/ 有四個規則檔重複副本（06-08 遷移遺留）
  → 同步修好，否則留一份過期真相（今日第三次撞到「同一資訊兩份副本」的債）
- 02-forbidden.md §2.1 列的三個「待刪違規 TS」其實早已不存在
  → 改標刪除線＋禁止重新引入（過期文件同時製造假待辦與假進行中）

驗證：sdd-active-check exit 0（active 仍恰一份＝portal-auth）；
session-start-load-sdd.sh exit 0；cypher-executor 與 cli typecheck 全綠；
測試 187/188（唯一 fail 為 pre-existing，stash 覆驗相同）。

未動：pre-write-guard.sh 的 KNOWN_SDDS 白名單不含 archive 路徑
（放寬 guardrail 需明確授權，留待決定）。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@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
Claude 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
Claude 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
Claude 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
Claude 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
Claude 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
雲端總管 b29de1b216 docs(sdd): 1.5-4 補「public 匿名可讀」規格＋官方部署目標帳號（youlin.hsieh.dev） 2026-07-19 06:50:31 +00:00
雲端總管 a73de77a7f docs(sdd): P-2026-07-19 confirmed——pending-changes 移入已裁決、artifact-sharing tasks 增補 Phase 1.5（bundle/譜系/訂閱/多源/self-check） 2026-07-19 06:43:38 +00:00
雲端總管 ffd50e7510 docs(sdd): pending-changes 收 P-2026-07-19 proposal——artifact-sharing 增補 bundle/譜系/訂閱/多源（leo 對話定調，正式 confirm 待明示） 2026-07-19 06:28:28 +00: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