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

191 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
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
uncle6me-web 646e689b65 confirm(CP2-F): 二～四刀拆分過裁（leo 授權技術裁決）；四題答定（手寫驗證/arcrun-api/排程於 A 線後） 2026-07-24 18:11:10 +08:00
uncle6me-web 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
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
uncle6me-web ca57fd6a1a chore(gc): GitHub 公開 mirror 管線(publish-github.sh+排除清單)——D22 模型落地:Gitea 私有真相源/GitHub 過濾樹乾淨歷史 2026-07-18 20:21:15 +08:00
uncle6me-web e1071edfe8 chore(gc): Mira 白名單 email 改 env 注入(publish 前 GC,leo 2026-07-18 放行)——公開 repo 不帶個人 email;本機 .env.local 已補 NEXT_PUBLIC_MIRA_ALLOWLIST 行為不變 2026-07-18 20:14:22 +08:00
Leo fa2ecf7226 Merge pull request 'portal: 搜尋濾內部型別雜項列＋總圖頁（Arcrun#39 藏書地圖 GUI 切片）' (#63) from feat/portal-library-overview into main 2026-07-18 10:18:18 +00:00
Claude (總管雲端) 50836a3ec8 README: 頂部加 Arcrun RAG 產品/demo 互連（封測漏斗：引擎↔應用雙向導流） 2026-07-18 08:56:14 +00:00
Claude (總管雲端) 0ca3af4d1a kbdb: searchByTemplate 修 N+1（100 筆 record 逐筆 getRecord ≈ 19 秒 → 批次 IN 查詢 1.3 秒） 
leo 客戶測試「圖譜/AI 查詢 20-30 秒」的病根：by-template 列表對每筆 record
各跑一次 getRecord（每筆一次 D1 往返）。改為 record id 以 90 一組（D1 綁定
參數上限 100）批次 IN 撈 slot 值，輸出排序與形狀不變。
實測 uncle6：/records/by-template/triplet 19s→1.3s、portal 圖譜 20s→3s、
總圖 1.8s。kbdb 測試 20/20 綠、tsc 0。
 2026-07-18 08:30:38 +00:00
Claude (總管雲端) a82c9bbb82 portal: 搜尋濾內部型別（value/workflow 雜項列）＋總圖頁（Arcrun#39 藏書地圖 GUI 切片） 
- filterDeprecatedEntries 加 INTERNAL_ENTRY_TYPES（value/workflow）：
  搜尋不再出現無標題雜項列與工作流定義（leo 客戶測試回饋）；
  #46 上游修好後隨治標段一併拔除。測試 49/49 綠。
- 新增 GET /portal/data/graph/overview：全租戶 active 三元組 →
  {nodes(degree), edges}，D-4 graph 粗閘、kbdbFetch 直讀、上限 500 誠實截斷。
- portal 新增「總圖」頁：nav 隨 graph_allowed 顯示；力導向佈局手刻
  （固定種子＝確定性、零外部套件）、紙感樣式（green 節點/amber hub）、
  邊 hover 顯示謂詞、點節點跳該實體圖譜搜尋；頁尾連 00-MAP.md
  （#39「人機共用同一份地圖」的 AI 注入文字版）。
- #39 本體（library_map Template/ingest 重算/MCP 注入）仍歸該 issue SDD。
 2026-07-18 08:17:22 +00:00
Leo 6e0df065fd Merge pull request 'portal: 來源回溯 gitea:// 顯示為可點超連結（PORTAL_SOURCE_WEB_BASE）' (#62) from feat/portal-source-link into main 
Reviewed-on: #62
 2026-07-18 07:28:01 +00:00
Claude (總管雲端) 6ff1355fe8 portal: 圖譜鄰居渲染修 [object Object]＋關聯列從 workflow neighbors 導出 
- workflow 版 graph_neighbors 的 neighbors 是 {node,predicate,from,depth} 物件，
  renderGraph 期望字串 → 節點 chips 全變 [object Object]；正規化成名字再渲染。
- workflow 版 edges 恆空 → 關聯永遠 0；neighbor 物件本身就是一條邊，導出成
  {subject,predicate,object} 餵關聯列（plugin 版行為不變）。
- 邊列 subject 比對改大小寫不敏感（graph 查詢端已正規化，搜 rag 命中節點 RAG）。
- 來源：leo RAG demo 客戶測試回饋問題 3（鄰居/關聯顯示有誤）。
 2026-07-18 06:13:45 +00:00
Claude (總管雲端) eaaf894b23 portal: 來源回溯 gitea:// 顯示為可點超連結（PORTAL_SOURCE_WEB_BASE 可選 var） 
- 新增可選 var PORTAL_SOURCE_WEB_BASE：設了之後 Portal 卡片詳頁「來源回溯」與
  AI 問答出處列把 gitea://<path>#n 渲染成 {base}/<path> 超連結（新分頁開啟）；
  未設時行為一字不變（Mira 零影響）。
- 安全：href 過 esc()、路徑逐段 encodeURIComponent、rel=noopener；
  只認 gitea:// 前綴，其他 scheme 一律純文字。
- 驗證：tsc 0 錯誤；portal-auth/portal-data 測試 48/48 綠；
  渲染後 client JS 語法檢查通過。
- 來源：leo RAG demo 客戶測試回饋（2026-07-18）「來源回溯沒辦法點擊」。
- 部署（leo 閘）：uncle6 重部 cypher 時帶
  --var PORTAL_SOURCE_WEB_BASE:"https://git.uncle6.me/Leo/arcrun-rag-demo-knowledge/src/branch/main"
 2026-07-18 06:01:26 +00:00
uncle6me-web 7bd7b4b26a SDD 生命週期鐵律遷移：單一活性制度上線（portal-auth=active，其餘 paused/draft） 
- 鋪檔（自 system-dev-template v1.15.0）：SDD-LIFECYCLE.md＋pending-changes.md
  ＋sdd-guard.sh（覆蓋舊版，加單一活性檢查）＋sdd-check.md＋sdd-active-check.sh
- settings.json PreToolUse（Write|Edit|MultiEdit）掛上 sdd-guard.sh
- 全部 SDD design.md 掛 frontmatter：portal-auth=active（現行 portal 線，
  #61 demo 四件套剛 merge）；artifact-sharing=draft（零任務動工）；
  其餘 16 份＝paused（皆有未完成任務，無明顯死件，不硬 close）
- CLAUDE.md 加「SDD 生命週期鐵律」段（指向 SDD-LIFECYCLE.md＋濃縮五條）
  ＋SDD 速查表改以 frontmatter status: active 為現行判準
- 驗證：sdd-active-check exit 0（恰 1 份 active）；guard pipe-test code 檔
  exit 0 帶現行 SDD 提示；反向測試（造 2 份 active）guard exit 2／check exit 1 全擋

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-17 17:03:16 +08:00
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