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

23 Commits

Author SHA1 Message Date
uncle6me-web 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
uncle6me-web 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
uncle6me-web 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
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
Leo 1e85dfb49b bugfix（#24 #25）：PBKDF2 600k→100k（CF Workers runtime 上限，真雲 bootstrap 500）＋http_request 補 global_fetch_strictly_public（1042） (#56) 2026-07-14 13:23:58 +00:00
Leo 3577e9255c portal-auth P3（#24 #25）：Portal UI＋/portal/data/* server-side enforce（不 merge，待總管審） (#52) 2026-07-14 07:19:01 +00:00
Leo 1260d8cffb portal-auth P2（#24 #25）：portal_user 模型＋認證 API（不 merge，待總管審） (#51) 2026-07-14 04:19:54 +00:00
Leo e90688c608 feat(console): 分流台勾掉/還原（雙向銷案：console 勾掉＝終局 checked_via:console，萃取端絕不復活） 
leo 2026-07-08 拍板，PR#41 分流台的後續：

- lib/console-triage-model.ts：applyTriageCheck 純函式（check→status:done+
  checked_via:console+checked_at；restore→status:new+移除 checked_via/checked_at；
  content 非 JSON 殘資料包成 {"text":原文} 不丟字）。雙向銷案語意寫死在註解：
  console 勾掉＝終局，即使 Logseq 原文還是 TODO 萃取端也絕不復活；Logseq 改 DONE
  由萃取端 PATCH（checked_via:logseq）；console 只忠實顯示非 done 項。
- console-dashboard.ts：POST /console/triage-check（沿 triage-data 同款 session 驗證；
  瀏覽器沒 KBDB token 故 server 端做 PATCH——先 GET 原 entry 整串回寫防蓋掉別的欄位；
  守 owner_id=CONSOLE_TENANT 與 entry_type∈{todo,inbox} 兩道邊界）。
- console.ts：每筆待辦 44px 圓形勾掉鈕（手機好按）＋done 清單「還原」鈕（誤勾救濟）；
  後端回寫成功才改本地狀態移出三欄（done 預設隱藏既有機制），失敗誠實 toast 可重試。
- 測試：applyTriageCheck 7 例（先紅後綠）＋ route 層 8 例（fetchMock 假 host
  kbdb.test + disableNetConnect，絕不外連；驗 session 閘/整串回寫/邊界/restore）。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-08 23:30:13 +08:00
Leo 5cd790c94a feat(console): 收件夾改裝＝全部待辦分流台（Arcrun#9，kb-ingest SDD R7 消費端） 
console 頁 7 從 Telegram 訊息清單改裝成三欄分流台：
- 資料源二合一：entry_type=todo（Logseq 萃取，Arcrun#8 ingest 線）＋ entry_type=inbox
  （Telegram），/console/inbox-data → /console/triage-data（唯一消費者是本頁，一起改
  裝不留死端點；仍鎖 console session——待辦原文屬機敏）
- 三欄 80/15/5：ai＝AI 會幫我搞定／collab＝協作／leo＝非我不可；owner_tier 缺席或看
  不懂（triage engine 還沒判）→ 歸 collab 欄＋「未分流」徽章，不冒領 ai、不誤判 leo
- 各項顯示 text／project 徽章／source／marker；status:done 預設隱藏可切換
- per-project chips 過濾（全部／各 project／未分項），前端同包資料過濾零額外請求
- 手機直排沿 console 單檔薄殼；讀 KBDB 走既有 kbdbBase HTTP 慣例，不新增 binding

契約解析/分欄/計數＝純函式 lib/console-triage-model.ts（比照 console-dashboard-model
模式，route 只做 IO），tests/console-triage-model.test.ts 11 測全綠（紅→綠驗證：抽掉
實作模組同測試即紅）。全套 vitest 98 passed，唯一失敗為 pre-existing executor
「不存在的零件」訊息斷言（main 同紅，與本 PR 無關）。

[總管-subagent]

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-08 22:44:54 +08:00
Leo 88633b0da4 fix(console): 駕駛艙「今日完成」跨 UTC 日界修正——07b 板實態 3 個 parser 落差（0/10 假空） 
SDD：system-dev/docs/3-specs/arcrun/search-console/tasks.md task 5.6（本次新增，Phase 5 稽核輪延伸）

live bug（2026-07-08 21:40 台北實測）：sprint-2026-07b.md 台北今晨 05:50
（＝UTC 07-07 21:50，cloud-worker 跨 UTC 日界寫入）勾了 CP1/T7/T5-provider，
/console/dashboard-data 卻回 today_done:0/today_total:10、done_today_titles:[]。

根因＝任務板 parser 與 07b 實際維護慣例的三個落差（lib/console-dashboard-model.ts）：
1. COMPLETED_DAY 要求日期緊貼「完成（」——07b 起署名在日期前
   （「完成（[cloud-worker] 2026-07-07，…）」）→ T7 的完成日抓不到，
   [x] 無日期＝整項蒸發（不冒領原則誤傷）。
2. 完成標記寫在縮排子彈上（CP1/T5-provider 的任務行只有 [x]）→ 舊 parser
   只掃行首 checkbox 行 → 同樣蒸發。
3. cloud-worker sandbox 時鐘是 UTC、routine 排程台北清晨（06:30＝UTC 前一日
   22:30）——它戳的日期 D 其實是台北 D+1 凌晨的完成，todayKey 永遠對不上。

修法（全在純函式層，route 零改動）：
- DONE_STAMP 改抓「完成（…）」括號內容、日期允許前綴；縮排補充行的完成
  標記歸到所屬任務（子彈本身仍不是任務）。
- [cloud-worker] 署名戳 D 展開台北候選日 {D, D+1}；progress-guard 跑台北
  16:30（UTC 同日）不展開——展開只會多冒領；本機/總管台北戳照舊精確，
  「昨天完成的明天不冒領」不變。
- 狀態欄放寬：[🔄→只剩1042]（07b 實例）認 doing，任務不再蒸發、today_total
  不再少算；x 帶註記仍不冒領 done（寬鬆容錯原則不變）。

驗證：新增 5 案例（07b 逐字真實形態）修前紅（today_done:0、done_today_titles
[]＝live 症狀重現）修後綠；model 測試 27/27；全套 vitest 87/88（1 失敗＝
pre-existing executor「不存在的零件」，stash 於未改樹複驗同樣紅）；tsc 錯誤
行數與未改樹相同（12 行，全在 validate/webhooks-named，workers-types 環境
漂移，非本次引入）；另用 Gitea live 07a+07b 檔直灌新 parser：today_done:3、
done_today_titles=[T5-provider, CP1, T7]＝板上真相。不部署（留 task 5.5）。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-08 21:51:24 +08:00
cloud-worker 5690d61438 fix(console): 真實性稽核修正——時區統一台北、精耕層數字、今日完成接 sprint 任務板 
稽核輪（fix/console-truth-audit，總管派工＋leo 三裁決）：

B1 時區：console 全站日期/時間顯示統一 Asia/Taipei（新 lib/taipei-time.ts，
   server 判定與頁面 client JS 同一套、等價性單測互鎖）。原本用瀏覽器本地
   getter——換裝置就換日期；憑證頁改顯「日期＋時分（台北）」：raw 1783349834
   ＝台北 2026-07-06 22:57，7/6 顯示是真的，缺的是時分與固定時區。

B2 總庫數字（leo 裁：14-E 遺產 deprecated 不再顯示）：總庫搜尋/設定頁頭部
   統計改讀新 GET /console/kb-scale-data（精耕層 wiki 卡/三元組/已嵌入＋最近
   寫入，全 live、limit=1/stats 聚合不掃庫）；搜尋仍搜全庫、結果 wiki_card
   加「精耕」綠標；dashboard-data 的 entries 計數補 owner_id（原混租戶：
   459,137 vs leo 458,732）。

B3 設定頁：vectorize 文案改具體事實（config kbdb_embed＋acr update，#32
   教訓）＋live 狀態；新增 MCP token TTL 誠實佔位（GET /console/settings-data，
   可調功能＝Arcrun#19，不假裝能遠端改）。

C 今日完成/今日路線接 sprint 任務板（leo 拍板）：比照 #36 等leo清單模式，
   同一輪 Gitea fetch（90s CF cache 共用）解析「## 任務板」checkbox；「今日
   完成」只認「完成（今天台北日）」標記，[x] 無日期不冒領；快取存原始
   completed_days，跨台北午夜不誤算；板檔今天沒 commit → 頁面誠實標「今日
   任務板未更新」；dash_task 降 fallback、燈號判定不變。parser 以 live
   07a/07b 檔實測（標題抽取棄「首個粗體」——實讀發現會抽到完成註記）。

驗證：tsc exit 0；vitest 82/83（1 失敗＝pre-existing executor「不存在的
零件」，stash 於 main 複驗同樣紅）；新增 taipei-time 10 案例（含跨日/跨年/
client-server 等價/leo 實測 epoch）＋任務板 parser 7 案例；兩頁 inline JS
渲染後抽 <script> node --check 全過（mistakes #24 手法）。
 2026-07-07 12:25:31 +00:00
Leo 0d9a6e8eed perf(console): Gitea 等leo清單讀取加 CF Cache 層（TTL 90s，#36 審查①） 
- cachedGiteaWaiting：caches.default + Cache-Control max-age=90；前端 60s
  刷新下 Gitea 從每分鐘 3-4 call 降到 ≤1 輪/90s
- hit 回放用 reviveWaitingAges 隨牆鐘補算「維護於 N 分鐘前」（不停走）
- 失敗不快取（不把網路抖動放大成 90 秒盲區）；cache.put 走 waitUntil 不阻塞
- waiting_meta.cache 吐 hit/miss，部署後 curl 兩次即得快取生效證據
- 測試：tests/console-dashboard-cache.test.ts 4 案例（真 workerd Cache API，
  注入 fetcher 計數證明 hit 不再打 Gitea）；全套 69/70（1 fail=main 既有）

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015d5jDbuqT5Htwv3Q88XXKk
 2026-07-07 11:19:19 +00:00
Leo 99da35a885 fix(console): 駕駛艙首頁改讀 live 一手資料，stale 殘骸誠實標示 
leo 抱怨「等你的事」錯了好幾天、首頁總覽對不上實際進度。診斷結論：
- dash_wait 沒有活的維護管線（最後寫入 07-04；等leo清單#11 已於 07-05
  銷案＝誤判，dashboard 卻繼續掛著）——真相源其實是 InkStoneCo sprint 檔
  「## 等 leo 清單」（progress-guard 每日核實維護）
- dash_task 的 scope:today 沒有日期，07-04 的路線到 07-07 還被當今天的
- 燈號吃到 stale 任務；系統狀況/總覽無 live 信號

修法：
- 等你的事：首選 Gitea sprint 等leo清單（合併最新兩檔——07b 開了、🔴 仍
  掛 07a；需 GITEA_TOKEN secret）；讀不到 fallback dash_wait 必標 age+stale
- 今日路線：台北日曆日判 is_today，非今日寫入降級「最後路線（N 天前）」
- 燈號只吃今日寫入任務＋心跳＋KBDB /health，附 light_reason
- 新增系統狀況（KBDB /health、embed enabled:false 誠實顯示、graph
  /triplets/stats、workflow 數）與總庫規模（entries/wiki_card/triplets）全 live
- 聚合判定抽純函式 lib/console-dashboard-model.ts，vitest 15 案例
  （含真實 sprint 檔形態：劃掉列/✅ 急迫欄/R1 字母編號/🔴 排序）

驗證：tsc --noEmit 0；vitest 65/66（1 失敗為 main 既有 executor.test.ts，
stash 復原後同樣失敗，非本次引入）；parser 對 live sprint-2026-07a/07b
dry-run 撈出 🔴#13 等 9 項 open、清單維護於 31 分鐘前。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015d5jDbuqT5Htwv3Q88XXKk
 2026-07-07 11:02:22 +00:00
Leo 06ff0e21ce fix(cypher-executor): component-loader 白名單補 code 零件（#29 發現） 
WASM_HTTP_RUNNER_IDS 漏 'code'，導致 workflow 寫 `component: code` 在解析鏈
step 1-6 全不命中後落到 step 8 直接「找不到零件」——本 PR 的 graph_neighbors
範例正用 code 節點，故歸此分支。

URL 推導：走既有 wasmWorkerUrl 通用推導 arcrun-code.{WORKER_SUBDOMAIN}.workers.dev
（WORKER_SUBDOMAIN 來自 wrangler.toml [vars]，self-hosted 由 deploy 注入自己的
subdomain）——無寫死官方 code.arcrun.dev，self-hosted 天然成立。

測試：tests/component-loader-code.test.ts（2 測）——`code` 解析成 runner 不 throw、
stub fetch 證 runner 打 arcrun-code.{sub}.workers.dev；wasmWorkerUrl 對任意 subdomain
推導正確。tsc 乾淨、全套 50 passed（1 失敗為 main 既有、無關）。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015d5jDbuqT5Htwv3Q88XXKk
 2026-07-07 08:42:51 +00:00
Claude c24edbbdb6 feat(credential-store-migration): T5 寫入路徑改走 Workers Secrets + D1 ref 
POST/PUT /credentials 改寫：密文值 PUT 進 CF Workers per-script Secrets
（唯寫，D19 不持有內容物），D1 credentials 表只存目錄（不含密文）。
secret_ref = CRED_<NAME>_<sha256(api_key)[:8]>，避免跨租戶撞名。
DELETE/GET /credentials 本次不動（仍走舊 KV，T9 範圍），已誠實標注。

新增 CREDENTIALS_DB D1 binding（與 KBDB base 共用同一顆 arcrun-kbdb，
沿用既有 database_id 注入機制）+ CF_SECRETS_API_TOKEN/CF_ACCOUNT_ID
env vars（CF_ACCOUNT_ID 由 deploy.ts 自動注入，同 WORKER_SUBDOMAIN 模式）。

§2.4 選項甲落地：client 不再加密，明文值經 TLS 傳輸，cypher 短暫經手
明文不落地不持金鑰——與舊版 01-tech-stack.md 傳輸格式不同，是本 SDD
對舊格式的刻意取代（§6 Q-b 仍需 leo 明確接受）。

驗證：tsc --noEmit exit 0；vitest 26/27（1 pre-existing 無關失敗）。
端到端：真實部署 leo21c arcrun-cypher-executor，POST/PUT /credentials
成功寫入 Workers Secrets + D1 row（CF API + D1 query 雙重確認），
清理測試資料後 restore wrangler.toml（無帳號專屬 id 殘留 git）。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018D6QoC5waFkcjc2N7csJBB
 2026-07-03 23:04:59 +00:00
Claude c3c0a8b17d feat(credential-store-migration): T4 wasi-shim secret_get host function 
新增 secret_get(ref) host function：讀 CF Workers per-script Secrets 的值，
host 端實作 = env[ref] 動態字串索引（T1.5 spike ② 已證可行，零網路呼叫）。

- ArcrunHostEnv 加 index signature 支援任意 secret_ref 動態取值
- WasiHostFunctions 加 secret_get，u6u WASI imports 比照 kv_get 同款
  pointer/memory-write 機制 wiring
- 安全邊界：只允許 CRED_ 前綴（拒絕讀 ENCRYPTION_KEY/CF_SECRETS_API_TOKEN
  等非 credential 機密），比照既有 routedKvGet 前綴檢查精神

驗證：tsc --noEmit exit 0；vitest 18/18 通過（新增 5 案例）。
撞牆記錄：JSPI Suspending 物件不可在單元測試直接呼叫（既有架構環境限制，
kv_get 同樣受影響），已移除不可行的 2 個測試並記錄於測試檔註解。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018D6QoC5waFkcjc2N7csJBB
 2026-07-03 22:56:42 +00:00
uncle6me-web c1a06df68f feat(exposure): 完全移除 acr push 暴露 consent 閘 (Arcrun#13 P1) 
leo 2026-06-29 拍板：arcrun 是給 AI 用的系統，push/暴露不再需要人類確認。
- 刪 cypher-executor/src/lib/exposure-consent.ts（server 閘，MCP push 的真正擋點）
- 刪 cli/src/lib/exposure-warning.ts（CLI 互動 + 非 TTY 拒絕）
- recipes.ts / webhooks-named.ts：移除 checkExposureConsent 403 閘，直接放行
- recipe.ts / push.ts：移除 obtainExposureConsent 呼叫，不再 prompt/拒絕
- init-seed / seed-api-recipes：移除種子層級 consent
- exposure_consent 欄位降為向後相容（讀舊 record 不報錯，不再寫入/檢查）
不補審計線索、不做替代防護（leo：先拿掉，出問題再設置）。
tsc 全綠（cypher-executor + cli）。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-29 20:58:32 +08:00
uncle6me-web 90777e3877 fix(auth-recipe): 回灌 telegram/line_notify/kbdb 種子，補 AuthInjectSpec.path（修 source/live 漂移） 
issue #13 升級：根因不只 acr parts 殘留，是 auth-recipe-seeds.ts source 漏了 3 個 static_key
auth recipe（telegram/line_notify/kbdb），但 prod KV 手動 seed 過 → 任何全新 self-hosted
`POST /init/seed` 只 seed 23 個、漏 telegram → self-host（leo21c/mira）telegram_send 的
auth_service:'telegram' resolve 不到 → {{auth.bot_token}} 注入空 → telegram 發訊壞掉。

實測 smoking gun（2026-06-29）：
- prod cypher.arcrun.dev/auth-recipes = 27 個（含 telegram）
- self-host arcrun-cypher-executor.leo21c.workers.dev = 23 個（無 telegram/line_notify/kbdb）

修法（資料/型別，非業務邏輯，守 mindset §1 不建 component）：
- auth-recipe-seeds.ts 補 telegram（inject.path bot_token）/line_notify（header Bearer）/kbdb（header Bearer）
- recipes.ts AuthInjectSpec 補 path?（WASM auth_static_key + SDD §六早有此欄、source 介面漏 → tsc 擋）
- google_user（oauth2）暫不回灌：內嵌 client_secret 不可進 git + 介面無 oauth2 欄 → 留 Phase D

形態取自 prod GET /auth-recipes/{service}；設計權威 auth-recipe.md §六(telegram path)/§七(kbdb 共用)。
telegram 自此與 notion(header)/gsheets(service_account) 同一條 recipe+auth-recipe 鏈，一致。
tsc 全綠；local 模擬 token-in-path 注入 PASS。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-29 12:37:19 +08:00
uncle6me-web c152f5fc1d feat(onboarding+kbdb): 8.P0 cron 止血 + §7.8 onboarding + .env.example 範本 
kbdb-base 8.P0：scheduled.ts cron 每分鐘 KV list → 單一 key get（lib/cron-index.ts）；
  webhooks-named 維護單 key + 一次性 migrate-cron-index；acr update 自動遷移。1440 list/日 → 0。

self-hosted-init §7.8 onboarding：
  P0 init 偵測+裝完驗收（lib/preflight.ts，pip 式，冪等）
  P1 acr whoami（+--json）+ MCP arcrun_whoami（AI 不繞 CLI 猜帳號）
  P2 mcp-setup 寫完印「請重啟 client」
  P3（部分）repo .env.example 範本（每格白話說明、值留空）+ llms.txt 教 AI 幫用戶 cp 建 .env

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-09 19:15:51 +08:00
uncle6me-web 6a75117ba3 feat(kbdb): recipe 公庫/私庫雙向機制 + UUID 身份 + KBDB Base + 市場數據 
kbdb-base SDD §7.5（公庫/私庫雙向機制，richblack 2026-06-07 拍板）。

## KBDB Base worker（新）
- kbdb/：D1-only 核心三表（entries/templates/entry_values）+ CRUD + LIKE search
  + recipe-stats 端點（市場數據）+ 0001_base.sql migration（含 recipe_stat seed）

## Phase 2.3：init 建 D1 + 套 migration
- cli cf-api.ts 加 listD1Databases/ensureD1Database；init 建 arcrun-kbdb D1
- deploy.ts 部署後對 D1 套 0001_base.sql（CF /d1/query API，idempotent）+ 注入 database_id

## Phase 5.1：recipe 成功記錄（市場數據來源）
- GraphExecutor 收集本次用到的 recipe uuid（usedRecipeKeys）
- executeWebhookGraph 執行結束一次性記 per-uuid 成功/失敗到 KBDB（fire-and-forget）

## Phase 7.5：recipe UUID 身份 + app-store 模型
- recipe 領 uuid=唯一身份；canonical_id/author/公私=屬性（§7.5.5）
- recipe:{uuid} + idx:canonical/installed/hash；resolveRecipe 向後相容不破執行鏈
- POST /recipes/submit=領新 uuid 新增作者版本（非覆蓋，app-store）
- GET /public-recipes 搜尋（多作者+per-uuid 市場星數）/ :id pull（選市場最佳）
- 落空→found:false 創作引導（§7.5.6 閉環）
- POST /recipes/migrate-uuid 一次性轉舊 key（增量寫不刪舊、冪等）
- init-seed 用 UUID（author=system）

## 薄殼（rule 07 §5：CLI + MCP 覆蓋同組能力）
- CLI: acr recipe search/pull/submit-p（config 加 DEFAULT_PUBLIC_LIBRARY_URL）
- MCP: arcrun_recipe_search/pull/submit_p/push/list/delete（補齊漂移）

## 壓測修正
- api-recipe-seeds: google_sheets_append PUT→POST（:append 正確動詞，階段12）

四 worker tsc 全綠（cypher/cli/kbdb/mcp）。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-07 16:18:10 +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 5f381a44a6 fix(self-hosted): 修壓測四阻斷項 + 設定分層 + init 非互動 
壓測（docs/壓測報告.md）發現 acr init --self-hosted 對任何非官方 CF
帳號都裝不起來，且設定寫死全域單檔 + 強制 TTY。本次一併修：

R2 dead storage 全清（#3#4，registry-canon Phase 1.5 補完）：
- cypher-executor wrangler.toml/test.toml/types.ts 移除 WASM_BUCKET binding
- CLI deploy.ts/init.ts/cf-api.ts/config.ts 移除 R2 建立邏輯與 wasm_bucket
- R2 綁信用卡違背「開源免費自架」核心；bucket 名 WASM_BUCKET 本就非法
  → self-hosted 改為只需 Workers + KV（皆免費額度、不綁卡）

fork 帳號部署阻斷（#1#2）：
- deploy.ts 新增 stripOfficialOnlyBindings()，注入暫存副本時移除
  [[routes]]/zone_name/[[r2_buckets]]/[ai]（fork 沒有 arcrun.dev zone）
- 不刪 repo 內 toml（官方 prod CI 部署仍需 routes），只在 CLI self-hosted 路徑 strip

設定分層 + 非互動（#7#8）：
- config.ts loadConfig 改三層：env > 專案層 .arcrun.yaml（就近往上找）> 全域
- init 支援 --account-id/--api-token flag + CLOUDFLARE_* env，缺才互動
- 新增 acr config --where 顯示每個值的來源層（token 自動遮罩）
- gitignore 一併排除 .arcrun.yaml

驗收：tsc 全綠；三層 merge 端對端測試 8/8；strip 對真實 toml 驗證
routes/R2/AI 移除而 name/workers_dev/KV 保留。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-05 07:22:37 +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