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

148 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
Leo db0a39fdbd Merge pull request 'portal demo 化四件套：圖譜 workflow 化（#57）＋AI 問答＋上傳頁＋搜尋濾殘影（#46 治標）' (#61) from portal-demo-suite into main 2026-07-17 06:48:04 +00:00
Claude 8accdacc3c portal 搜尋濾殘影（#46 治標）＋四件套單測 
/portal/data/search 拿到 KBDB 回應後 server-side 過濾 metadata_json.status=
'deprecated' 與 content 以「（舊管線產物」開頭的 entries（metadata parse 失敗
視為保留，不誤殺），count 重算。這是 Arcrun#46 上游修好前的 portal 端治標，
上游清完資料後整段（含 filterDeprecatedEntries）可拔。
單測：sanitizeUploadFilename（路徑穿越/副檔名/長度）、filterDeprecatedEntries
（濾殘影/壞 metadata 保留）、mapGraphWorkflowOutput（#57 輸出映射）；
/portal/session 補 upload_enabled=false 斷言。另修 portal-ui 一處註解字樣
（誤用產品名，撞零 Mira 斷言）。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BH7LdhuCdVUHfHXbM7N8r5
 2026-07-17 06:28:04 +00:00
Claude fde1827928 portal 上傳頁：POST /portal/data/upload（server-side 寫 Gitea）＋前端拖放上傳 
server：requirePortalUser 閘；filename 驗證（去路徑分隔、強制 .md、限 100 字）；
server-side POST Gitea contents API 到 PORTAL_UPLOAD_REPO 的 docs/{filename}
——token 只在 server，前端零 repo/token 字串。409/422 → 誠實「同名文件已存在」。
新增三個 Bindings：PORTAL_UPLOAD_REPO / PORTAL_UPLOAD_GITEA / PORTAL_UPLOAD_TOKEN
（secret），任一缺 → 404「未啟用上傳」＝Mira 零影響（功能不存在，現行為一字不變）。
/portal/session 補 upload_enabled 布林（server 判 bindings 齊全；顯示提示，真閘在路由層）。
前端：上傳 nav（sidenav＋tabbar，一般用戶可見、未啟用時隱藏）＋檔案選擇（.md/.txt
多選）＋拖放區；讀檔轉 b64 逐檔 POST、逐檔狀態列；成功顯示「已收件，約 1 分鐘後
可在搜尋頁找到；AI 整理後會以 wiki 卡形式出現」。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BH7LdhuCdVUHfHXbM7N8r5
 2026-07-17 06:24:14 +00:00
Claude c01c6c4d02 portal AI 問答：/portal/data/chat 端點＋搜尋頁問答面板 
端點：requirePortalUser 閘（同 search）；in-process 執行 tenant 的 rag_chat
workflow（與 graph_neighbors 同機制），input {question}，回 {answer, sources,
graph_facts}；workflow 不存在 → 誠實 404「此實例未安裝問答 workflow」。
前端：搜尋框下方問答列，loading→純文字 answer（pre-wrap 保留換行、esc 防
XSS）＋sources 列表（mode＋page，點 page 帶回搜尋框自行驗證）。設計哲學：
AI 檢索＝用戶手動搜尋同一套，AI 只代查再作答，不多開任何權限。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BH7LdhuCdVUHfHXbM7N8r5
 2026-07-17 06:20:27 +00:00
Claude 204cd5bff3 portal 圖譜模式修復（#57）：優先 in-process 執行 tenant graph_neighbors workflow 
RAG self-hosted 實例不部署 kbdb-graph-plugin，graphBase 直連必 1042。改為：
WEBHOOKS KV 有 {tenant}:wf:graph_neighbors 時直接 import executeWebhookGraph
（webhooks-named trigger/query 同一執行入口）在本進程執行——絕不 fetch 自己
hostname（self-loop）；輸出映射成與 plugin 相同形狀 {neighbors, edges, count}。
沒有該 workflow → fallback 原 graphBase 直連（Mira/leo21c 行為一字不變）。
input：node=path、depth=query（預設 2）、namespace/owner=tenant。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BH7LdhuCdVUHfHXbM7N8r5
 2026-07-17 06:19:03 +00: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 52dbd31dea portal-auth P4（#24 #25）：admin 帳號＋庫管理頁＋last-admin 鎖死保護（不 merge，待總管審） (#53) 2026-07-14 08:54:41 +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 7f409646e5 portal-auth P1（#24 #25）：KBDB library filter 地基（不 merge，待總管審） (#50) 2026-07-14 03:50:06 +00:00
Leo 18c0846af0 SDD: RAG Portal 多人授權（#24 #25）— 純設計文件，待審不 merge (#49) 2026-07-14 03:32:00 +00:00
Leo cbebb36c01 console 頁面 profile 裁剪：CONSOLE_PROFILE=rag 企業產品樣（搜尋落地），未設＝full mira 零影響 (#48) 2026-07-13 11:15:00 +00:00
Leo 2e1005ea67 console rebrand Mira→Arcrun + CONSOLE_BRAND 可覆蓋（#21） (#47) 2026-07-13 00:06:56 +00:00
Leo 1c4f79b623 Merge pull request 'feat(console): 分流台勾掉/還原——雙向銷案（console 勾掉＝終局，萃取端絕不復活）' (#42) from feat/console-triage-checkoff into main 2026-07-08 15:32:35 +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 1bc83c7124 Merge pull request 'feat(console): 收件夾改裝＝全部待辦分流台（三欄 80/15/5 + per-project 過濾）(#9)' (#41) from feat/console-triage-inbox into main 2026-07-08 15:13:58 +00: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 2fa0974e1c Merge pull request 'fix(console): 駕駛艙「今日完成」跨 UTC 日界修正——today_done 0/10 假空（07b 板實態 3 個 parser 落差）' (#40) from fix/console-today-write-dayline into main 2026-07-08 14:02:06 +00: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
uncle6me-web 85ffe2d16d chore(release): 1.3.14 npm 補發——對齊 main（exposure 閘已移除/creds 新行為），治 npm drift 兩次誤判根源 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-08 21:36:30 +08:00
Leo f9971c956a Merge pull request 'fix(console): 真實性稽核修正——時區統一台北、精耕層數字、今日完成接 sprint 任務板' (#37) from fix/console-truth-audit into main 2026-07-07 12:35:35 +00: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 ef779e3ef6 Merge pull request 'fix(console): 駕駛艙首頁改讀 live 一手資料，stale 殘骸誠實標示' (#36) from fix/console-dashboard-live-data into main 2026-07-07 11:25:27 +00:00
Leo e1822e8202 Merge branch 'main' into fix/console-dashboard-live-data 2026-07-07 11:25:23 +00:00
Leo 7bd6899c96 Merge pull request 'docs(spec): artifact-sharing 增量 — deps_summary + 作者信譽經濟 + 資料完整性原則' (#31) from spec/artifact-sharing into main 2026-07-07 11:25:22 +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 af926aaad8 docs(spec): tasks 明標榜單類＝物化候選第一位（跨作者榜不可 on-read 掃全庫，審查 #31） 
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015d5jDbuqT5Htwv3Q88XXKk
 2026-07-07 11:14:51 +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 df62933fa5 docs(spec): artifact-sharing leo 三補點 — deps_summary 搜尋層可見 + author 信譽經濟 + 資料完整性優先於界面 
leo review 方向確認後的三個補點（2026-07-07，總管轉達）：

1. deps_summary：搜尋結果每項就顯示配套需求（從 dependency_manifest 聚合的輕量摘要，
   submit 時算好存 metadata_json）。low-code 關鍵：判斷「裝不裝」的資訊要在搜尋層，
   不是 pull 之後才發現缺東西。design（R1 模型/端點/R5/驗收）、requirements（US-4/R3）、
   tasks（1.1/1.2/2.2）對應補。
2. author 信譽經濟（market 核心）：author= 過濾＋作者頁端點（找到 Leo 看到他全部 shares）；
   author_reputation＝從 per-uuid stat 聚合的衍生視圖、不另立真相源（第一階段查詢時算、
   量大再物化）；選版升級為單品＋作者信譽複合分（權重待拍板）；獎勵層 future 不實作
   （第一階段獎勵＝信譽本身；author 綁認證身份列 SaaS/多人市場前置）。design（作者信譽段/
   端點/待拍板 6-8）、requirements（US-9/R3）、tasks（1.3/1.6/5.4/5.5）。
3. 資料完整性優先於界面：新增設計原則段（UI 是未來的皮、record 完整性是現在的責任；
   事件型資料事後不可重建 → pull/submit 事件 day-one append）；record 欄位用「未來
   showcase 網站」反推補齊（created_at/updated_at/tags/compat/license，各標必填/自記/可選）；
   驗收加可測定義：不看 UI 僅用 record+事件就能重建市場首頁（作者榜/熱門榜/最新發布/配套需求）。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015d5jDbuqT5Htwv3Q88XXKk
 2026-07-07 10:15:52 +00:00
Leo 29ba85e848 Merge pull request 'docs(spec): artifact-sharing SDD — workflow/template 分享機制' (#27) from spec/artifact-sharing into main 2026-07-07 09:39:28 +00:00
Leo b4ecdfd918 Merge branch 'main' into spec/artifact-sharing 2026-07-07 09:39:25 +00:00
Leo d1a84bda91 Merge pull request 'feat(cli): code 零件接進 acr init/update 部署流程' (#29) from feat/deploy-code-component into main 2026-07-07 09:39:23 +00:00
Leo 66d2045f06 Merge branch 'main' into feat/deploy-code-component 2026-07-07 09:39:20 +00:00
Leo f7fe080169 Merge pull request 'feat(cypher-executor): 同步查詢 trigger + graph_neighbors 查詢面 workflow 示範' (#28) from feat/sync-query-trigger into main 2026-07-07 09:39:19 +00:00
Leo dbb956d072 Merge branch 'main' into feat/sync-query-trigger 2026-07-07 09:38:13 +00:00
Leo 1d7f69215a docs(spec): artifact-sharing 審查對齊 ×2 — K2 改 KBDB 唯一公庫後端（對齊 #16）+ 零件界線照 #23/D29 
審查意見兩處（總管 2026-07-07）：
1. K2 原「recipe 維持 KV 公庫、泛化端點 front 兩後端」與 #16（RECIPES KV→KBDB）衝突
   → 改為 KBDB 是唯一公庫後端；#16 落地前對 type=recipe 的 KV 轉接明定為過渡碼、
   #16 完成即拆（1.5/5.2 對應改）；KV 公庫不得寫成穩態。遷移本體＝#16 負責，不重工。
2. component 界線照 #23/D29 定案改：零件貢獻整層搬到獨立 repo Leo/arcrun-components
   （fork→PR→人審）；市場只偵測缺件→引導去該 repo 開 PR，永不傳輸/安裝零件程式；
   arcrun_publish_component 路徑廢除。design/requirements/tasks 凡提零件發布處照此改。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015d5jDbuqT5Htwv3Q88XXKk
 2026-07-07 09:09:37 +00:00
Leo 7777414b70 docs(spec): artifact-sharing SDD — 把 recipe app-store 分享模型擴展到 workflow/template 
規劃「資料庫就能完成的開發物」（recipe/workflow/template）的分享/發布/下載/導入/匯出。
泛化一套 /public-artifacts 讀端點 + 型別化 materialize adapter 寫；公庫存 KBDB；
依賴解析劃清界線（recipe/template co-pull、component 走 PR、credential 零傳輸）。
純文件，不改程式。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-07-07 09:04:55 +00:00
Leo 39d6fdfaff fix(examples): graph_neighbors 去寫死官方 KBDB URL（審查 🔴）＋敏感輸入註記 
審查發現：workflow.yaml 寫死 kbdb.finally.click ＝ KBDB_BASE_URL fallback 同家族坑
（self-hosted 用戶照抄示範，查詢與資料流向直接打進官方庫）。

改法：
- fetch_triplets base URL 參數化為 {{input.kbdb_base}}（每次呼叫帶），yaml 檔頂加醒目
  警示「先改成你自己的 KBDB URL」；grep 證兩檔零 finally.click 殘留。
- 1042 註解保留並補一句：self-hosted 有 global_fetch_strictly_public flag
  （credential-primitives-wasm Phase 7），開了 workers.dev URL 亦可帶。
- description.md 參數表加 kbdb_base（必填）＋觸發範例改自有域名佔位＋補
  「敏感輸入請用 POST /query（GET /q/ 的 query string 會進各層 log）」。

tsc 乾淨、全套 50 passed（1 失敗為 main 既有 executor.test.ts 斷言漂移，無關）。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015d5jDbuqT5Htwv3Q88XXKk
 2026-07-07 09:01:20 +00:00
Leo 621cb8d948 feat(cli): code 零件接進 acr init/update 部署流程（自足 Worker 進部署清單 + vendored wasm 進 repo） 
動機（Arcrun#4 後續，leo 批准）：code 零件只有原始碼（registry/components/code），
downloadAndDeploy 完全沒涵蓋它——tier1 只掃 .component-builds/*（TinyGo 家族，要求
component.wasm），tier2 寫死四個引擎。merge 後用戶跑 acr update 應真的裝上 code。

接法（實查後裁定）：
- code 是自足 Worker（quickjs-emscripten wasmfile variant，非 TinyGo；見其 index.ts 頭註），
  「缺 wasm」的真相是「這一類根本不在部署清單」+「vendored quickjs.wasm 是 gitignored
  build 產物、不進 archive」。
- deploy.ts 新增 SELF_CONTAINED_COMPONENT_WORKERS（目錄 + 必要產物 gate，比照 tier1
  component.wasm gate 的誠實跳過精神），discoverWorkerDirs 將其排進 tier1（零件先於引擎）。
- vendored quickjs.wasm（491KB）commit 進 repo：.gitignore 放行（完全比照
  !.component-builds/**/component.wasm 的「部署物 wasm 例外」先例）→ acr update 從
  Gitea archive 直接拿到，更新不需 npm build 工具鏈。
- 共享依賴抽成 SHARED_DEPLOY_DEPS 並補 quickjs-emscripten-core + wasmfile variant
  （版本對齊零件 package.json，測試看守 drift）→ root 裝一次、esbuild 往上 resolve。
- 注入零改動：既有 stripOfficialOnlyBindings 剝掉 code.arcrun.dev 官方 route、
  workers_dev=true 保留 → self-hosted 自動落 arcrun-code.<sub>.workers.dev。
- parts.ts BUILTIN_COMPONENTS 加 code 條目（issue #13 W3：零件=靜態清單）→ acr parts 可見。
  實查：init 本來就不對 registry 註冊任何零件（registry index 是官方 backfill 腳本的事），
  故「比照其他零件」＝進 BUILTIN_COMPONENTS 即對齊。

測試：cli/tests/deploy-code-component.test.ts 9 顆全綠（node --test，零新依賴）：
部署清單含 code / 缺產物誠實跳過 / wasm 已 git 追蹤（會進 archive）/ SHARED_DEPLOY_DEPS
涵蓋零件全部 runtime deps + 版本一致 / route 剝除與 [vars] 保留 / parts 清單含 code。
tsc --noEmit 綠；零件自身 12 顆 vitest 綠（沙箱行為未動）。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015d5jDbuqT5Htwv3Q88XXKk
 2026-07-07 09:01:11 +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
Leo 020ccdf085 Merge pull request 'fix(cli): acr update/deploy 下載源改指 Gitea archive（Arcrun#4）' (#26) from fix/acr-update-gitea-source into main 2026-07-07 08:40:02 +00:00
Leo 313aeb13bf feat(cypher-executor): 同步查詢 trigger + graph_neighbors 查詢面 workflow 示範 
Part 1（框架，cypher-executor webhooks-named.ts）：加同步查詢 trigger。
現有 named webhook /trigger 回 {success,data,trace,duration_ms} 信封、只有 POST；
查詢面（console/MCP 打 graph neighbors/traverse）要 GET + 直接拿最終節點輸出當 response。
新端點同步 await 執行 workflow graph → 回 result.data（最終節點輸出）本身當 body（非 202）：
  - GET  /q/:ns/:name                    （namespace 走 path，input 走 query string）
  - GET  /webhooks/named/:name/query     （X-Arcrun-API-Key header，input 走 query string）
  - POST /webhooks/named/:name/query     （header，input 走 body）
  - POST /webhooks/named/:ns/:name/query （namespace 走 path，input 走 body）
認證沿用 X-Arcrun-API-Key。誠實（mindset §7）：節點失敗回 error+trace（500，非假綠）；
paused 工作流無法同步回答 → 409 明講；輸出 5 MiB 硬上限（超過 413）；duration 走 header 不污染 body。

Part 2（A 類 workflow.yaml）：registry/examples/graph-neighbors/。
http_request 打 base custom domain kbdb.finally.click（避 CF 1042）撈 triplet records
→ code 零件記憶體 BFS（對照 kbdb-graph-plugin graph-traverse.ts）→ 同步回鄰居。
把 graph plugin 內建 GET /graph/neighbors 泛化成查詢面 workflow 的示範。

測試：cypher-executor/tests/query-trigger.test.ts（7 測，全綠）——同步回輸出（非 202）、
GET/POST × header/path 四端點、節點失敗回錯+trace、缺 key 401、不存在 404。
用內建 comp_uppercase（純記憶體）證明 Part 1 同步 trigger 機制本身可用。

待驗：graph_neighbors 需 code 零件部署 leo21c 後才能 live 端到端（另線處理）；
triplet template id 上線前對一次（workflow 已參數化未寫死）。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015d5jDbuqT5Htwv3Q88XXKk
 2026-07-07 08:16:17 +00:00
Leo 794e3eba3a fix(cli): acr update/deploy 下載源由 GitHub codeload 改指 Gitea archive（Arcrun#4） 
動機：D20 防 flag 鐵律下 self-hosted 用戶（如 Mira）不能碰 GitHub，
而「init 之後才新增的零件」（如 code 零件）唯一重裝管道 acr update 綁死
GitHub codeload → 沒有乾淨重裝路徑。

改動（只碰 CLI 下載邏輯，不動 README/cypher/mcp/tools）：
- deploy.ts：ARCRUN_REPO 預設 uncle6me-web/Arcrun → Leo/Arcrun；
  新增 ARCRUN_GITEA_BASE（預設 https://git.uncle6.me）與 giteaToken()
  （ARCRUN_GITEA_TOKEN > GITEA_TOKEN，不寫死）。
- 抽出純函式 buildArchiveUrl / buildDownloadHeaders 走 Gitea archive API
  GET {base}/api/v1/repos/{owner}/{repo}/archive/{ref}.tar.gz，保留 #13 P2
  cache-buster + no-cache 防 stale；private repo 帶 Authorization: token。
- downloadRepoTarball 改用上述；401/403 給「設 GITEA_TOKEN」提示。
- update.ts docstring 對齊（GitHub release → Gitea archive；標註 install≈update）。

install≈update：init 與 update 共用 downloadAndDeploy，其內容指紋 manifest
天然「新零件補、內容未變者略過」，故用戶跑 acr update 即補裝新零件。

測試：cli/tests/deploy-url.test.ts（Node 內建 test runner，零新依賴）8 顆全綠，
涵蓋 URL 組裝、repo/base 覆蓋、token→header、public 無 token、env 優先序。
真正打 Gitea 下載/部署是 leo 的閘，不在本 PR。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015d5jDbuqT5Htwv3Q88XXKk
 2026-07-07 08:13:05 +00:00
Leo b13b4dfe49 Merge pull request 'refactor(mcp): u6u_* tool rename → arcrun_* + 前綴收斂單一來源' (#20) from feat/mcp-tool-rename-arcrun into main 2026-07-07 06:02:10 +00:00
Leo 9a609c4a04 Merge branch 'main' into feat/mcp-tool-rename-arcrun 2026-07-07 06:02:07 +00:00
Leo a981dde1d3 Merge pull request 'feat(mcp): OAuth 2.1 server for claude.ai remote connector（修明碼-namespace bearer 漏洞）' (#15) from feat/mcp-oauth-server into main 2026-07-07 06:01:51 +00:00
Claude 5fa3b79a4c fix(mcp): validate/normalize RFC 8707 resource at issuance; store canonical aud 
leo review 最後一條：簽發端沒驗證/正規化 resource → 失敗劇本「OAuth 全程成功但每次打 /mcp 401 aud
mismatch」（尾斜線/canonical 變體，錯誤離根因最遠最難 debug）。改在簽發端 fail fast：

- metadata.ts 加 normalizeResource（scheme/host 小寫、去預設 port、path 去尾斜線，與 resourceUri
  canonical 一致）+ resourceMatches。
- /authorize（GET+POST）：帶 resource 且正規化後 != canonical → redirect 帶 error=invalid_target
  （redirect_uri 已驗過才 redirect）；一律把 canonical resource 存進 code（不存 client 原樣值）。
- /token：帶 resource 且正規化後 != canonical → 400 invalid_target；aud 一律存 canonical
  resourceUri(origin) → 與 partner-auth 嚴格比對 at.aud===resourceUri(origin) 恆一致。

裁決：尾斜線/大小寫等「正規化後等價」的 resource → 接受（存 canonical aud，/mcp 必過），非拒絕——
否則 claude.ai 真送變體會永久授權失敗連不上（把 401 問題換位重現）。只有正規化後真正不同的
resource（別 host/path）才 fail-fast 拒。詳見 OAUTH.md §2。

測試：normalizeResource/resourceMatches 單元 + 尾斜線變體→正常發碼且 aud canonical、別 host→
/authorize redirect invalid_target 不發碼、/token 別 host→400 invalid_target。
mcp vitest 52/52、tsc exit 0。

Refs #15

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015d5jDbuqT5Htwv3Q88XXKk
 2026-07-07 05:38:35 +00:00
Claude 53080ffa53 docs(mcp): GUIDE/README 全面改教 arcrun_*，清掉死 u6u_ 工具名 
死文件治理：GUIDE.md（25 處）與 README.md（21 處）仍在教 u6u_* 工具名，
含本 PR 已刪的 4 個 tool（deploy/execute/get/list_workflows），下個 CC 照著走會撞牆。

- 全部 u6u_* → 現役 arcrun_*（component/tag/gui 那批用新名）
- 已刪 tool 改指現役：execute→run、deploy→push、get/list_workflows→crud 版
- 修正因換工具而失真的流程與參數：沙盒測試段改為 arcrun_validate_yaml（部署前
  schema 驗證）→ arcrun_push_workflow（部署）→ arcrun_run_workflow（觸發，帶
  api_key/name/input）；get_workflow 參數 workflow_id→name
- 順帶把兩處品牌 prose "u6u" 改 "Arcrun"
- grep 確認兩檔零 u6u

brand.ts：釐清 ARCRUN_TOOL_PREFIX 覆蓋僅內部 rebrand 過渡 / 測試鉤子，
Workers runtime 無 process 全域基本不生效、勿當對外特性。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015d5jDbuqT5Htwv3Q88XXKk
 2026-07-07 05:37:54 +00:00
Claude 5fc7277c3c refactor(mcp): u6u_* tool 全面 rename 為 arcrun_* + 前綴收斂單一來源 
零 u6u 洩漏（leo 要求 1）：connector tool 清單只剩 arcrun_*，並移除壞掉/
重複的 u6u_ workflow tool（deploy/execute/get/list_workflows 由 arcrun_
push/run/get/list_workflows 取代）；MCP server name 也由 u6u-mcp-server
改 arcrun-mcp-server。

前綴單一真相源（leo 要求 2）：新增 mcp/src/brand.ts（TOOL_PREFIX + toolName()
helper），所有 server.tool() 註冊一律走 toolName("suffix")，前綴不再明碼散寫。
未來 rebrand 只改 brand.ts 一行。

- 12 個獨有能力 tool rename（component/tag/gui/search_workflows）
- 4 個重複/壞掉 tool 移除
- inter-tool hint、描述字串、註解內 u6u_ 名字全數更新
- tsc exit 0；vitest 19/19 綠

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015d5jDbuqT5Htwv3Q88XXKk
 2026-07-07 05:21:34 +00:00
Claude 92cfb9c59f fix(mcp): address PR #15 review — aud validation, OAUTH_KV auto-inject, TTL/​sunset docs, drift test 
leo review 5 條逐條處理：

1. RFC 8707 aud 驗證（真缺口）：partner-auth OAuth 路徑補「at.aud === resourceUri(originOf(url))」，
   不符回 401 invalid_token（防別的 arcrun-mcp 部署簽的 token passthrough）。加 aud 不符→401 測試。

2. deploy.ts injectWranglerConfig 涵蓋 OAUTH_KV（在 PR 內補）：OAUTH_KV 納入 REQUIRED_KV_NAMESPACES →
   acr init/update 自動建 namespace + 注入用戶帳號真 id（比照 SUBMISSIONS_KV 家族）。wrangler.toml 註解
   更新（CLI 路徑自動、手動直推才需手建）。注入 regex 已驗證命中。

3. MCP_TOKEN_TTL 預設維持 30 天（leo 拍板不改）：OAUTH.md 明寫為有意取捨（無 refresh token → 到期重走
   OAuth＝再輸 owner secret），MCP_TOKEN_TTL 可調、7 天為更保守選項。per-owner 可調另開 issue #19（非阻塞）。

4. ALLOW_PLAINTEXT_NAMESPACE 逃生門標 SUNSET（code + wrangler.toml + OAUTH.md），開 issue #18 追蹤
   「遷移完成後移除整段 code path + Env 欄位」。

5. 防 drift 測試：spy KV 攔所有 put，斷言對 OAUTH_KV 的每一次 put 都帶 expirationTtl>0（完整流程 +
   store 層兩道），防未來往這顆短效 KV 塞長效資料。

驗證：mcp tsc exit 0、vitest 45/45（+aud +drift×2）；cli tsc exit 0。

Refs #15 #18 #19

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015d5jDbuqT5Htwv3Q88XXKk
 2026-07-07 04:56:59 +00:00