 雲端總管
|
b9b94d7852
|
docs(sdd): library-map tasks M1-M5+M3 銷帳（07-19 雙實例上線）、M7 半驗
|
2026-07-19 11:21:33 +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 |
|
|
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 |
|
|
雲端總管
|
1ee0dbd2fe
|
docs(sdd): library-map（藏書地圖）SDD 出稿 draft——#39 立案 11 天催辦補課；含 D6 歸屬裁定（SQL 住基本盤）＋D30 檢索治本連動
|
2026-07-19 07:54:23 +00:00 |
|