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
c735b911a0
🔴 修教材反向教壞：skill §7 自打臉＋補「分支怎麼算成功」＋刪 publish 死代碼
...
端到端 haiku 考 0/3、1/3，**斷點在教材不在引擎**（另一 agent 取證，別重查）：
探針零 code 實測 n=10→TRUE、n=1→FALSE 兩次 success；**考生的作品其實會動**
（amount=5000→true、amount=100→false 條件求值全對），但它以為跑不通而放棄改寫 code；
考生第二次自己指認「MCP 說明聲稱不支援 ON_TRUE/ON_FALSE，與實際系統行為不符」。
① skill `write_intent_workflow` **同一份前後打架**（我 08-01 只改了 §2 沒掃全篇）：
§2.1 教用 ON_TRUE，§7 第 1 條卻把 ON_TRUE 列為「不存在的邊」⇒ 教材自我否定。
改：§7 只留 ON_FAILURE（真的沒有），並明寫「ON_TRUE/ON_FALSE/ON_BRANCH 是存在的，
見 §2.1，本行舊世代已更正」。全篇 grep 過確認無其他矛盾。
② **補 §2.2「怎麼確認分支真的走對」**——這是「看到對的結果卻以為失敗」的直接解：
看 verdict，且**走 true 路時 false 路節點不出現＝正確行為不是失敗**；
附 08-01 實撞案例，明講「只有一條路有輸出」不該判定壞掉。
MCP instructions 同步加這段（比 skill 更前置，AI 一連上就讀到）。
③ #23 殘留清除（leo 08-01：「已經沒有 publish 了，零件等級一律走 PR，這條路封了」）：
`git rm mcp/src/tools/arcrun_publish_component.ts`＋拔掉 registry.ts 的 import
（註冊呼叫本來就已註解掉＝純死代碼配活 import）。刪前 grep 全 repo 呼叫方：
除本檔與 registry.ts 外，其餘命中全是 md/SDD 的歷史記載（不需動）。tsc 綠。
替代路徑＝`Leo/arcrun-components` fork→PR→人審，已寫進 registry.ts 註解。
SDD: workflow-discovery 3.11｜CP: arcrun-usable 步驟 5
2026-07-31 18:37:48 +08:00
eefbed98b6
合流 batch：步驟 3/4/5/6 併成一版出貨（同一顆 cypher worker，bundle 是 worker 粒度）
...
鐵律（08-01 血淚）：CP 可分步驗收，但 bundle 是 worker 粒度——凡改同一顆 worker 的多步，
出貨前必先合流成一版再重生 bundle，否則 stage 只拿到一步（三條分支各自建 bundle 的坑）。
base=feat/step3-missing-guidance（最前緣，已含 step4+step6＋t158-t162 prod 修）
merge=feat/step5-conditional-edges（引擎條件邊＋recipe 三層＋教材世代修）
2026-07-31 16:56:09 +08:00
a9a47b7c37
🔴 步驟5 補斷點：教材說「引擎不支援條件分支」＋意圖語法收不到分支標籤
...
備考 haiku 真考時自查發現的兩個斷點——**若不補，考試必掛，且掛的是我自己的教材**。
形狀＝步驟1 那個「世代脫節」的翻版：能力做好了，但教 AI 的地方還停在舊世代。
斷點①：三處教材主動說「沒有條件分支」，還教了正好造成腹語術的替代法
- mcp/src/mcp-handler.ts:44「**沒有** ON_TRUE／ON_FALSE——引擎目前不支援條件分支」
- registry/skills/write_intent_workflow.md:39「不要寫 ON_TRUE／ON_FALSE…
需要判斷時**寫成一個獨立節點**再接 ON_SUCCESS」← 這正是「判斷退回 code」的入口
- registry/skills/INDEX.md:44「已知的坑：引擎沒有條件分支」
⇒ 三處全部更新成現況（三顆零件都輸出 data.branch、引擎依標籤選路、
查零件回應附 branch_hint 照著接即可），並保留「不要寫 ON_FAILURE」（那個真的沒有）。
斷點②（更隱蔽，靜默失效）：`graph-builder` 只認得 `對每個 X` 的參數化 label，
`ON_BRANCH(branch_active)` 帶括號會落到 toEdgeType 預設值 **PIPE**
⇒ 我在 skill 教的寫法，編圖收不到，而且**不報錯**——AI 以為分支了、實際全走同一條。
「教了語法但引擎不收」比沒做更糟，故與文件同批補上：比照 FOREACH 抽 iterator 的作法
抽 branch 標籤（半形/全形括號都收），寫進 edge.branch。
新增 tests/intent-branch-syntax.test.ts（7 項綠）：守「文件教的寫法，編圖真的收得到」
——ON_TRUE/ON_FALSE 不退化成 PIPE、中文「成立時/否則」、ON_BRANCH(標籤) 抽得出 branch、
全形括號、try/catch 標籤；零變化：ON_SUCCESS 仍是 ON_SUCCESS、對每個 X 的 iterator 不受干擾。
全套 234 passed（前 227 +7），失敗數維持既有 9 筆；tsc 綠。
SDD: workflow-discovery 3.11｜CP: arcrun-usable 步驟 5
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com >
2026-07-31 16:51:19 +08:00
e688d805ea
步驟5 抽驗補證：三型分支用「真零件實跑輸出」端到端驗過（不再是推論）
...
總管 08-01 抽驗要求（正確）：ON_CASE/ON_CATCH grep=0，我用 ON_BRANCH 通用承接，
但既有測試是用 Input 節點**手餵分支形狀**——那只證明「引擎依標籤選邊」，
**沒證明「真零件吐的標籤對得上」**。leo 特別點名 switch／try_catch，故補實測。
真零件實跑（wasmtime 跑 .component-builds/*.wasm，原文抄進測試當 given）：
if_control active → {"data":{"branch":"true","result":true},"success":true}
if_control inactive → {"data":{"branch":"false","result":false},"success":true}
switch case1 → {"data":{"branch":"branch_active"},"success":true}
switch case3 → {"data":{"branch":"branch_pending"},"success":true}
switch 無匹配 → {"data":{"branch":"branch_default"},"success":true}
try_catch 成功 → {"data":{"branch":"try","result":{"value":42}},"success":true}
try_catch 失敗 → {"data":{"branch":"catch","error":"boom"},"success":true}
⇒ 三顆的標籤與 readBranch 讀的 data.branch **完全對得上**，非「理論上支援」。
新增 tests/branch-real-components.test.ts（8 項綠）：把上列真輸出送進引擎，
驗 if 兩路／switch 多路（含**第 3 條 case** 證明第 N 路走對）＋default／
try_catch ok 與 catch 兩路，每項都驗「該走的走、不該走的沒走」。
新增 tests/branch-hint-response.test.ts（7 項綠）：驗逐顆查三顆的回應
自帶 branch_field/branches/edge_types/usage/example，並把 AI 實際看到的內容印出來
（總管要求「貼回應」）。另驗不分岔零件（http_request/code）無此欄＝不加噪音。
全套 227 passed（前 212 +15），失敗數維持既有 9 筆未變；tsc --noEmit 綠。
SDD: workflow-discovery 3.11｜CP: arcrun-usable 步驟 5
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com >
2026-07-31 16:43:25 +08:00
c9feb15a37
步驟5 驗收與 SDD 落帳：判斷骨架重寫實測 1201→350 字元、if×8→0（降 71%）
...
tests/step5-acceptance.test.ts（3 項綠）：
- 多路分流＋失敗路三條各自到位、全程零 code 節點、success=true
- 布林兩路（if_control）同樣零 code
- 字元數對照：舊寫法（判斷全塞進一個 code 節點的 JS）1201 字元 if×8
→ 新寫法（分支邊＋recipe response_map 宣告）350 字元 if×0
誠實標記（寫進測試檔頭與 tasks，不讓後人誤讀）：線上那顆 assemble（5509 字元 if×23）
住在 arcrun-rag 實例、本 repo 無其定義 ⇒ 本次是把它的**判斷骨架**以新能力重建成等價
工作流，證明判斷不必寫在 JS 裡，**不是**直接改寫線上節點。真正改寫與 haiku 逐顆查場景
＝stage 端到端（features/09）才算數，故 3.13 標 ◐ 不標 ✅ 。
tasks.md：3.11／3.12 標 [x] 附證據，3.13 標 [◐] 附待辦界線。
全套 212 passed（基線 179 +33 新），失敗數維持既有 9 筆未變；tsc --noEmit 綠。
SDD: workflow-discovery 3.11/3.12/3.13｜CP: arcrun-usable 步驟 5
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com >
2026-07-31 16:34:20 +08:00
5f5c0a89e2
步驟5 缺口②：recipe 補 payload／回應正規化／binding 三層（leo 三層模型的第③層）
...
問題：舊 recipe schema 只有 {canonical_id, endpoint, method, auth_service}（body 有但淺）
⇒ ①帶 body 的 API 只能繞過 recipe 把整包寫進 workflow code
②回應解析綁死單一供應商（rag_chat 的 finalize 2786 字元全在對付 Gemini 形狀）
③Cloudflare binding（env.AI/VECTORIZE/BROWSER/QUEUE）整類被「只認 HTTP+金鑰」的抽象排除
⇒ 換 LLM 供應商＝改 workflow，而非換 recipe，違背「外部 API 只有一條一致的路」。
新增 lib/recipe-payload.ts（純函式，好測）：
- renderBodyTemplate：遞迴插值，單一 {{x}} 保留原型別、混合文字拼字串、
支援 dot path、取不到保留原樣（不靜默吞掉，看得見才好 debug）。
語義刻意與 graph-executor 的 interpolateData 一致，不新造第二種插值行為。
- applyResponseMap：text_path 取值／thinking_model 剔除 thought=true 取最後一個非 thought／
answer_marker 用 lastIndexOf（自檢清單內文也會提到標記）／strip_prefixes 循環剝殼
（實撞三型「Draft: 【答】」「* 【答】」「Answer: * 【答】」，單趟剝不乾淨）。
RecipeDefinition 加四個**全選填**欄位：body_template／response_map／auth／binding_name。
- component-loader：body_template 優先於 body，兩者皆無才沿用 ctx 當 body（既有行為）
- response_map 有設才附 text 欄，未設原樣回傳 ⇒ 既有 recipe 行為完全不變
- 新增 makeBindingRecipeRunner＋pickRecipeRunner：auth='binding' 走平台 binding（免金鑰、
開機即可用），其餘一律走既有 HTTP 路徑。binding 缺綁定/無 run() 時回可操作錯誤，不假綠。
這型不是為 Workers AI 開特例——一次打開 env.AI/VECTORIZE/BROWSER/QUEUE 整排。
payload 用法要「查得到」（同 branch_hint 動機，leo 08-01 的 n8n 式逐顆查）：
buildPayloadHint() 讓 recipe 的查詢回應說得出「payload 怎麼填、回應怎麼取值、
認證誰負責」，wire 進 discover 混搜／legacy 逐顆／target=recipe 三條路徑。
金鑰鐵律 D36：hint 只說「走 auth recipe X，金鑰由系統注入、你不必也不該填」，不吐值。
測試：tests/recipe-payload-response.test.ts 14 項全綠（含三家形狀 Gemini/Claude/Workers AI
用不同 path 都取得出文字＝換源＝換 recipe 的實證；未設 response_map 原樣回傳的相容性）。
全套 209 passed（前 179 +30 新），失敗數維持既有 9 筆未變；tsc --noEmit 綠。
SDD: workflow-discovery task 3.12｜CP: arcrun-usable 步驟 5
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com >
2026-07-31 16:31:58 +08:00
323ccc8475
步驟5 缺口①：引擎通用具名分支邊（ON_TRUE/ON_FALSE/ON_BRANCH）＝Arcrun#5 根治
...
問題（「全變成 code」的根）：if_control 回 {result, branch} 卻沒有邊讀得懂它，
圖的邊只有 ON_SUCCESS/IF/FOREACH ⇒ 就算照規矩用零件，仍得寫 code 判斷走哪條。
leo 08-01 追問「你改了 if，有改 switch 嗎？switch 更嚴重」——確認 switch(N 路)
與 try_catch(try/catch) 同病，故一次做成通用機制，不留「為 switch 再改一次」的債。
設計：三顆流程控制零件的 output_schema 本來就都收斂到同一形狀 data.branch: string
（if_control→true/false；switch→case 名或 default_branch；try_catch→try/catch）
⇒ 引擎只需「依標籤選邊」一個機制 ON_BRANCH；ON_TRUE/ON_FALSE 是布林路的語法糖，
底層同一條路（測試已證等價）。讀不出分支＝不走（誠實，不亂挑一條）。
- types/schemas/constants：新增三邊型（純新增，既有列舉不動）＋ GraphEdge.branch
- graph-executor：readBranch() 依 data.branch → branch → data.result → result 四層相容
- 中文語意詞：成立時/為真時=ON_TRUE，不成立時/為假時/否則=ON_FALSE，BRANCH=ON_BRANCH
分支用法要「查得到」（leo 08-01：AI 可能像 n8n 那樣逐顆查、自己組圖）：
新增 lib/branch-hints.ts，讓 if_control/switch/try_catch 的查詢回應自帶 branch_hint
（branch_field/branches/edge_types/usage/example）——只看這一顆的回應就知道怎麼接下一步，
不必回頭讀 skill。四條回應路徑全wire：catalog found／legacy 逐顆／步驟4 substitution／
target=component 名字搜尋（＝n8n 式那條）。不分岔的零件不加此欄，避免噪音。
測試（先寫測試再改引擎，紅線要求）：tests/conditional-edges.test.ts 16 項全綠
——if 兩路／switch 多路＋default／try_catch 成功與失敗路／語法糖等價／
context 傳遞／同分支 fan-out／無匹配不走／混合邊時 PIPE 不受影響／schema 放行。
零變化保證：195 passed（前 179 +16 新），失敗數維持既有 9 筆未變（console/portal
HTML 資產未建置＋executor 斷言字串漂移，皆與本次無關）；tsc --noEmit 綠。
現存 workflow/example 用到新邊型＝0 筆（grep 實查）⇒ 既有行為不可能被改動。
SDD: workflow-discovery task 3.11｜CP: arcrun-usable 步驟 5
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com >
2026-07-31 16:26:26 +08:00
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
341bcb13c8
t160 測試跟上規格：人工建庫 POST → 404（庫只從 daemon 同步來）
...
舊測試驗「POST 建庫 200＋重複 409」＝已刪端點的規格；vitest 回基線 9 failed/187 passed。
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com >
2026-07-31 14:57:22 +08:00
832f270f52
Merge branch 'feat/step6-success-rate' into feat/step3-missing-guidance
2026-07-31 14:54:25 +08:00
5c5109cd45
Merge branch 'feat/step4-node-substitution' into feat/step3-missing-guidance
...
# Conflicts:
# system-dev/docs/3-specs/workflow-discovery/tasks.md
2026-07-31 14:54:25 +08:00
e744ad1f96
t160 世代債清除（leo：「如果你會搞不清楚，就把錯的東西刪掉」）——repo 只留一個 UI 世代
...
事故鏈（07-31 深夜，leo 刷新撞到）：t159 重打包 staging bundle 時，build-ui-bundle
吃了 feat/step3 分支的 console-ui/public/——該分支基底早於 main d7fab7ce28e190noreply@anthropic.com >
2026-07-31 14:36:48 +08:00
cae0d7be3b
3.9 落帳＋pending-changes 提案：workflow export/import 一等公民化（D35 ③，接線待 confirm）
...
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com >
2026-07-31 14:15:33 +08:00
062757f1b1
t159 修 portal 庫目錄空：補上 daemon 一直在打、但從未存在的登記端點
...
診斷更正（重要）：kbdb 裡 50+ 筆 entry_type=value（content=資料夾名）**不是孤兒**——
那是 91 筆 triplet records 的 library slot 正常構造（records 全部組裝完整，資料同步
一切正常，無失敗無重試）。真病灶＝**POST /portal/daemon/libraries 這個 route
從來不存在**：daemon registerLibraries（arcrun-tray main.go:505，t52「用戶可以看到
我有 2 個庫」）連線精靈時打它 → 404 → 被 daemon「失敗不擋連線」設計靜默吞掉
→ portal_library 登記簿永遠 0 筆 → portal「庫目錄管理」空。
- 新 route 契約照 daemon 既有呼叫：{email, password, libraries:[{name, display_name}]}
- 帳密驗證沿用 /portal/session 同一套（isLocked/findUserRecordId/verifyPassword/
recordLoginFail；daemon 只在精靈那刻拿帳密不存）
- 冪等：listRecordsByTemplate 比 name，已登記跳過（重跑精靈不堆重複）
- 庫名走 isValidLibraryName 同閘（拒 "*" 與非法字元）
驗：tsc 全綠；youlin 實例資料層已手動補登記（探針 record PATCH 成
youlinhsieh-test1＋新建 test2，portal_library count=2）；route 部署驗證
隨下批 staging bundle（假帳密應回 401 而非 404）。
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com >
2026-07-31 14:07:05 +08:00
9c9aff0046
t158 P1 素材：workflow export/import 原語（definition 端點＋CLI 命令，未接線）
...
leo 07-31：「你要做的就是一個叫 export，另一個是 import……現在如果我要把我做的
工作流分享給同事，我要怎麼 export？他要如何 import？是缺了功能用 search 來湊嗎？」
- cypher GET /webhooks/named/:name/definition：吐可攜定義（graph＋config＋description
＝record 原樣）——export 的引擎端；import 端直接 POST /webhooks/named 即送進任何實例
- cli/commands/workflow.ts：acr workflow export <name>（definition→.workflow.yaml，
flow 從 graph.edges 反推供人讀）／import <file>（graph 直 POST，零編圖零 search
零存在性驗證＝V2 純複製；手寫 yaml 無 graph → 指去 acr push）
- ⚠️ 未接線：index.ts 尚未掛 workflow 命令組（P1 收尾：接線＋分享場景 A export→
B import 驗收＋parser 共用模組化）
安裝器側 P0（rag-installer 5a6539d）已用同形狀（打包期預編 graph＋純上傳）上 prod。
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com >
2026-07-31 13:49:23 +08:00
d48f83ae6f
t159 步驟4 意圖節點→真實零件/recipe 替換＋/cypher/search 加 target 指定搜尋對象
...
CP arcrun-usable 步驟 4（目的：AI 只要填 payload——系統把「傳到 telegram」
翻成 http_request＋recipe telegram_send）＋leo 07-31 追加：
「難道我不能指定要搜尋工作流或節點或 recipe 嗎？」
替換（只動 discover，t158「部署≠發現」邊界不碰）：
- 兩庫 exact 落空後，在 t158 一次抓好的清單記憶體內媒合，零新增 round-trip
- 規則 A 服務詞→recipe：名字全部服務詞命中同一 recipe 且唯一才換
（google_slides_create 不被 google_sheets 誤吃）
- 規則 B 強欄位斷詞→零件：canonical/display/aliases 強命中×10＋弱命中，
需至少一強命中且分數唯一最高（aes_encrypt 無強命中不換）
- 換到＝status resolved＋substitution{from,componentId,recipe,reason}，
cypher 圖節點直接帶真實 componentId；換不到照舊 not_found＋3.7 指路
target 參數（各走既有機制，不新造第二套搜尋）：
- triplets＋target=component|recipe＝只查該庫
- query＋target＝名字搜尋：component→registry /components/search（＝MCP
arcrun_search_components 同路）；recipe→私庫 RECIPES KV（回應註明公庫走
arcrun_recipe_search）；workflow→新抽 lib/workflow-search.ts，
GET /workflows/search 與 target=workflow 共用（＝arcrun_search_workflows 同路）
- 防呆：compile＋target 400／target=workflow 吃 query 不吃 triplets／非法 target 400
驗（本地 wrangler dev，registry 種 20 合約＋init/seed 10 recipe）：
- 「判斷有沒有新資料 >> ON_SUCCESS >> 傳到 telegram」→ if_control（resolved）
＋telegram_send（substitution.componentId=http_request）＝feature 06 驗法過
- 機械考 27/27 全綠（01 組×5＋03 組×4 迴歸＋06 組×8＋target×8＋compile 迴歸×2）
- 冷啟第一發 94ms、熱 8–13ms（t158 病史對照：舊 25.7s）；compile 39ms unchecked 照舊
- tsc 全綠；vitest 9 failed/179 passed＝t158 基線完全相同
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com >
2026-07-31 13:49:09 +08:00
ea1c0571c1
步驟6 執行統計回寫：每顆零件跑完回寫 success_rate（task 29，design.md「執行統計設計」）
...
- registry 新增 POST /analytics/record：ANALYTICS_KV 計數器（stats:{hash_id}:{version}）
為唯一真相源，衍生值（success_rate/avg_duration_ms/call_count）回填 comp: 記錄
——查詢讀取端讀哪就寫哪，不開第二真相源。KV 無 CAS，誠實標註非原子。
- cypher-executor execution-evaluator 從 stub 改真實作：執行收尾（/cypher/execute
成功與 ExecutionError 路徑＋webhook 路徑）對 trace 裡每顆 Component 節點
fire-and-forget 回寫，waitUntil 包、不增加執行同步延遲（仿 recordRecipeStats 慣例）。
成敗判定＝trace error 或 output.success===false（makeHttpRunner 非 2xx 不 throw）。
- registry 位置沿 search-nodes 慣例：REGISTRY_BASE_URL 覆蓋，未設走 wasmWorkerUrl。
- 新增單測 13 個全綠；本地雙 wrangler dev 端到端實測：http_request 跑 5 次
（3 成功＋2 失敗）→ success_rate 1→0.6、call_count 0→5，/cypher/search 同步可見。
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com >
2026-07-31 13:45:05 +08:00
7e631a890a
t158 迴歸修復「部署≠發現」：複製路徑回毫秒級純編圖，誠實化只留在 discover
...
leo 07-31 定調：「這裡只是複製一些工作流的 data 過去，沒有要在這裡驗證，難怪這麼慢。
就算是我自己寫了錯的工作流，也可以跑跑看，如果錯誤就修改，
沒有說有錯誤還要一個個驗證這回事。」
定性＝迴歸非新設計：部署路徑純複製是既有設計（arcrun-rag installer/src/index.js:13
「workflows.json 是既有 workflows/*.local.yaml 的搬運（打包期抽 flow/config）」＋
arcrun-rag wiki「workflow 打包期預編成 workflows.json（worker 免帶 parser）」）。
5cadc60noreply@anthropic.com >
2026-07-31 13:31:33 +08:00
7e87a3336b
3.8 新增 write_recipe skill——recipe 指路終於有目的地
...
📋 SDD：workflow-discovery task 3.8（3.7 的 suggestion 指 skill write_recipe，
之前是空地——指路會指到不存在的 skill）。
- registry/skills/write_recipe.md：從真 code 反推，不是憑空教學——
schema＝routes/recipes.ts RecipeDefinition（canonical_id/endpoint/method/auth_service…）；
真範例＝api-recipe-seeds.ts 的 telegram_send（URL path 注入）＋gmail_send（service account）；
auth recipe 必填欄位（required_secrets 的 help_url 必填）照 POST /auth-recipes 驗證邏輯；
常犯錯收錄實錄（sheets append PUT→POST、telegram auth recipe 漏種、金鑰只准名字 D36）
- INDEX.md 補 write_recipe 入口；「/cypher/search 假 found」坑改標已修（2026-07-31）
- write_intent_workflow.md §6 status 表改 not_found 契約＋suggestion/similar_* 欄說明
安裝器 seed：registry/skills/*.md 由 sync-registry-to-kbdb.py 自動收，新檔即納入。
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com >
2026-07-31 11:56:30 +08:00
1794072179
3.6/3.7 查詢誠實化：兩庫都查、缺件回 not_found＋分型指路 suggestion
...
📋 SDD：workflow-discovery task 3.6/3.7（leo 07-31 步驟 3 考題）
契約以頂層 arcrun-usable/verify.sh 01＋03 組為準。
- 3.6 recipe 納入 /cypher/search：零件 registry 落空後查 RECIPES KV
（resolveRecipe，執行鏈同一套解析）；recipe found 附 source/description/endpoint
- 3.7 缺件分型指路：status 契約定 not_found（verify grep），suggestion 欄——
名字含服務詞（google/telegram/…）＝外部 API 樣貌 → 指 skill write_recipe；
含計算詞（encrypt/hash/…）＝計算原語樣貌 → 指 skill add_new_wasm_component 投稿 PR；
判不出型誠實說判不出、兩條路都給。規則簡單可解釋（不接 LLM），判準在 code 註解
- 相近候選：not_found 附 similar_components/similar_recipes——全名搜不中就斷詞
（ASCII 詞＋中日韓 2-gram）打 registry /components/search，
「判斷有沒有新資料」媒合到 if_control（leo：AI 不用知道零件存在）
- 修頭節點假 found：resolveNodeRole 把無入邊頭節點判 Input，searchNodes 對 Input
無條件 found ⇒ 「aes_encrypt >> … >> code」的頭被掩蓋。改為只有字面
input/trigger/…/output 名才短路（isVirtualIoName），真名字照查兩庫
- registry 查詢層補 input_schema/output_schema 透傳：KV 一直有存
（indexOnlyComponent），toComponentRecord 丟掉 ⇒ /cypher/search 給不出
「怎麼填 payload」。順手補 REGISTRY_BASE_URL 可選覆蓋（比照 KBDB_GRAPH_URL 慣例，
本地 dev／self-hosted registry 掛別處時用）
驗：cypher-executor＋registry tsc 全綠；vitest 9 failed/179 passed＝與 5cadc60noreply@anthropic.com >
2026-07-31 11:56:15 +08:00
747dc3f843
3.7 補指引目的地＋3.8 write_recipe skill（recipe 指路現為空地）
2026-07-31 11:38:26 +08:00
c56863a7e0
3.6/3.7 補設計基調：回覆重點=缺哪些；兩庫都搜；驗收=機械綠→haiku 真考
2026-07-31 11:36:01 +08:00
fc6c98cd58
workflow-discovery 補 3.6/3.7（頂層交棒）：recipe 入查詢＋缺件分型指路——leo 07-31 定義步驟 3 考題
2026-07-31 11:26:20 +08:00
0a426c4e16
fix(cypher): CORS origin 空值放行——CLI/curl/MCP 無 Origin 標頭時不再 500
2026-07-31 10:50:57 +08:00
Leo
b8ca98cb49
MCP 認證改用 Portal 帳密，廢掉 MCP_OWNER_SECRET（leo 指定做法）
...
leo：「claude 裡有一個直接輸入帳密連線的，為什麼不用那個？跟他輸入 portal 的帳密一樣不就好了？」
為什麼換（三個封測撞出來的實際問題）：
① 沒人給得了封測者——安裝器產生後從不顯示（完成頁 grep「Owner 祕密」=0），
CF secret 又唯寫讀不回 ⇒ 用戶卡在同意頁，只能找 leo 手動 wrangler 覆寫
② 多一把要記的金鑰——違反「拿一把金鑰就很難了」
③ 全實例共用一把，無法分辨誰連上來（企業多人版必要）
風險評估（leo 判斷，總管原本誇大成「繞過帳密的旁路」已認錯）：
secret 要貼進 claude.ai（本身有帳密保護）⇒ 洩漏 secret 與洩漏 portal 帳密風險相同。
改動：
- consent.ts：一個「Owner 祕密」欄位 → email ＋ password 兩欄
- routes.ts POST /authorize：constantTimeEqual(MCP_OWNER_SECRET)
→ 走 CYPHER_EXECUTOR binding 打 /portal/login（認證下沉到唯一真相源，
同樣吃它的節流與停用檢查）
- routes.ts GET /authorize：移除「未設 MCP_OWNER_SECRET → 503」
（那是「每個封測者都死在這頁」的直接原因）
驗：tsc 零錯誤；已部署 youlin。
2026-07-31 00:44:15 +08:00
Leo
cda1c7b261
instructions 補「你配備了 Arcrun、別上網搜」＋新增 skills/INDEX（LLM wiki 式導航）
...
leo 兩個洞察：
① 「整個 arcrun instruction 很像 LLM wiki…它會拿到一個 index 把所有文件說明都塞給它，
它不會就可以查，範本全部寫在裡面」
⇒ 對照 wiki 的 push/pull 分法：我原本只做了 push（instructions 開場），
漏了 pull（INDEX 導航）。補 registry/skills/INDEX.md：
什麼症狀查哪支 skill／查現成零件recipe workflow 的九支工具／四個已知的坑／腹語術紅線
② 「它不去查就不知道…如果它去上網搜因為它不知道自己有配備呢？」
⇒ 實測確認 instructions 是 **push**（本 session system prompt 內就有藏書地圖那段）
⇒ AI 不會去上網搜，但原本的 instructions 沒說「你配備了什麼」
⇒ 開場補：Arcrun 是什麼／你現在就有完整能力／不要上網搜（網路上沒有）
驗：tsc 零錯誤。⚠️ 未部署——實測總管 token 只有 account(read)，無法部署任何 CF worker。
2026-07-30 22:38:37 +08:00
Leo
fac7d6c9bb
AI 一連上 MCP 就知道從哪開始（leo 追問揪出的最後一哩）
...
leo：「arcrun_get_skill 放在 MCP 裡，現在人類說『幫我用 arcrun 寫 xxx』，
Haiku 會說『arcrun 是什麼？我看看』然後發現有個 arcrun mcp 就去執行？
如果不會，要寫什麼在外面讓它一聽到就知道要用這些資源？」
實測答案：**不會**。
① 總管寫的指引沒有任何入口指向它（真實 AI 找不到）
② MCP 五個 skill 沒有「怎麼寫意圖工作流」這支
③ AI 只看到 41 個工具名 → 自己猜 → 很可能直接 push_workflow 瞎編，
或去讀 registry/examples 那 8/13 引用不存在零件的壞範例
兩件修法：
1. registry/skills/write_intent_workflow.md — 把指引變成 AI 拿得到的 skill
（範本全取自實跑 verdict=success 的四支 workflow；含「查詢現在回假 found」的已知限制警告）
2. mcp-handler.ts instructions 開場指路 — instructions 是唯一「AI 一連上就必看」的欄位
⇒ 開場就寫明五步順序（先讀 write_intent_workflow → whoami → 查零件 → list_skills → 缺件怎麼補）
＋邊只有兩種、第一個節點是 input、不要因查不到就改寫 code
⚠️ 靜態常數：KBDB 掛了也必出現（守「不擋連線」鐵律）
驗：tsc 零錯誤。⏳ 待部署後由 leo 真的問 haiku「幫我用 arcrun 做 X」驗證它會不會自己讀 skill。
2026-07-30 22:29:28 +08:00
Leo
0686d39fa1
pending-changes：兩個真缺口提案（引擎條件邊／recipe payload+response+binding）
...
來源＝頂層 CP arcrun-usable 逐步查證。依 leo「照 SDD 做事、照 CP 排順序」，
CP 不得自帶任務 ⇒ 這兩件必須進 SDD 才能做，先走 pending-changes 等 confirm（D35）。
缺口①引擎條件邊：if_control 回 {result,branch} 但 cypher-executor grep ON_TRUE|ON_FALSE=0
⇒ 用了零件仍得寫 code 判斷＝「全變成 code」的根。Arcrun#5 於 07-04 發現至今未修。
SDD 查證：7 個字面命中全是「部署分支」等別義，條件邊本身完全沒設計過。
缺口②recipe 缺 payload/response 層：schema 只有 {canonical_id,endpoint,method,auth_service}
⇒ telegram_send 自述「body 帶 chat_id+text」但存不住 body ⇒ 只能繞過 recipe 寫進 workflow。
要補 body_template／response_map／auth:binding 三層。SDD 查證 17 命中全是別的 payload。
2026-07-30 22:06:48 +08:00
Leo
156cdcbe7b
chore: 刪掉兩個死零件與其壞範例（leo：這裏的每個不要的零件還存在啊）
...
📋 SDD：workflow-discovery（active）／對應 CP arcrun-usable 步驟 5「死代碼清除」
刪除（git rm 保留歷史）：
- registry/components/km_writer + .component-builds/km_writer
- registry/components/kbdb_upsert_block + .component-builds/kbdb_upsert_block
- registry/examples/km-wiki-ingest（唯一引用 kbdb_upsert_block 的範例，Mira 時代同源產物）
為什麼刪（Arcrun 自己的 06-mindset.md §1 早已載明）：
「mira 的 claude_api / km_writer 就是這樣被錯做成零件的（其實是自用服務膠水）」
＋ kbdb_upsert_block 是「一個 CRUD 操作一個零件」（leo：總不能每個都建一個零件）
＋ 兩者綁的 Mira 已於 2026-06-29 蒸發＝死零件。
刪前實測引用數：workflows.json 0／cypher src 0／examples 僅 km-wiki-ingest。
零件數 22 → 20。
✅ 投影模型驗證成功：build-bundles.mjs 掃 .component-builds/ 目錄（readdirSync），
重跑後 manifest 自動 25 顆 → 23 顆，兩顆消失，**不需手動改 manifest**。
⇒ 證明 manifest 這層本來就是投影（leo 的設計），只有 registry KV 那層是獨立登記簿（待改）。
驗：vitest 9 failed/179 passed＝與刪除前相同（既有債）。
2026-07-30 21:30:26 +08:00
Leo
5cadc60e36
feat(workflow-discovery): /cypher/search 改為真查 registry——修「查詢回假信號」
...
📋 SDD：workflow-discovery（本 commit 同時執行 D35 交接：portal-auth 26/26 完成 → closed
superseded_by workflow-discovery；workflow-discovery paused → active。單一活性已驗＝1 份）
🎯 對應 task：3.x 搜尋端誠實化（CP2-B）
病灶（leo 2026-07-30 定性「腹語術」）：
search-nodes.ts 無條件回 status:'found'、missingNodes 永遠 []——
型別宣告了 'missing' 但程式碼從不使用。實測「完全不存在的東西xyz」也回 found。
⇒ AI 拿到假信號 → 以為零件存在 → 部署才發現沒有 → 改寫 code
⇒ 正式 workflow 只用 2 個零件、8 個 code 節點含 if×61。
修法：
- 查 registry 判真實存在（走 HTTP，守 D28 禁新增 service binding；
URL 用既有 wasmWorkerUrl() 慣例組，不自創）
- found 時附 input_schema／success_rate／stability
⇒ AI 才填得出 payload、才看得到「測過幾次」（leo：AI 只要填 payload）
- 查不通回 'unknown' 而非 'missing'——**誠實限制**：
不能因查詢失敗就宣告零件不存在（那會讓 AI 誤判而重寫 code）
- missing 真的回傳出去（原本寫死 []）
⚠️ 實測發現 registry **沒有列表端點**（GET /components → 404，只有 /components/<id>）
⇒ 改為逐個查（節點數通常 <10、5s timeout）。補列表端點後可改抓一次＝CP2-B 待辦。
驗：tsc 零錯誤；vitest 9 failed/179 passed＝**與改動前 stash 對帳完全相同**（既有債非本次造成）。
⏳ 待部署到實例後跑 arcrun-usable/verify.sh 驗 01 那組轉綠。
2026-07-30 20:41:53 +08:00
646e689b65
confirm(CP2-F): 二～四刀拆分過裁（leo 授權技術裁決）；四題答定（手寫驗證/arcrun-api/排程於 A 線後）
2026-07-24 18:11:10 +08:00
dd78b770a9
fix(kbdb): /entries/search 服務端濾 deprecated（keyword+semantic），修下架不生效
...
daemon-beta t24（t11 斷點①②，總管 0.971 親復現）：rag_takedown_direct 下架只把
metadata_json.status 標 deprecated（軟刪，append-only），但 /entries/search 兩 mode
都不濾，已下架內容照樣回傳——semantic 甚至最高分照吐。過去唯一的濾層只在
cypher-executor/portal-data.ts 客端（Arcrun#46），沒部署 rag_chat 的實例等於完全沒濾。
- entry-crud.ts：新增 json_extract($.status) NOT_DEPRECATED_PREDICATE（同 source/library
既有 json_extract 模式，issue #5.1/#18；不用 LIKE 避免 JSON 序列化格式誤判）；
searchEntries 新增 includeDeprecated 參數（尾端新增，向後相容）。
新增 isDeprecatedEntry：semantic 路徑用（Vectorize metadata 沒存 status，只能 hydrate
回完整 entry 後 JS 側判斷）。
- entries.ts：/entries/search 新增 include_deprecated 開關（預設 false，濾掉；true 給
管理面查殘留）。semantic 分支補位——過濾生效時先以 topK×3（封頂 100）向 Vectorize
多撈，hydrate+濾完再截斷回 caller 要求的量，避免命中大半下架時整頁被吃光
（t11 ZZ-T10 實測案例）。
- Vectorize 向量殘留本 PR 不動（只做查詢時過濾，not 同步刪向量）——取捨見 PR 描述。
測試：新增 search-deprecated-filter.test.ts 15 案（keyword 濾/include_deprecated 開關/
semantic 濾+補位+封頂+截斷/isDeprecatedEntry 單元）；同步更新 search-source-and-score.test.ts
3 案的 topK 期望值（route 補位改變送進 Vectorize 的實際 topK，回應對外契約不變）。
kbdb 全套 60/60 綠、tsc --noEmit 乾淨。
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com >
2026-07-24 16:35:17 +08: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
uncle6me-web
Leo