Claude
343572bf5d
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
1.5 KiB
1.5 KiB
library-map — Tasks
進度真相源。依 design §7 歸屬；動工前總管審本 SDD（#39 明令）。
| # | 任務 | 類 | 依賴 | 狀態 | 備註 |
|---|---|---|---|---|---|
| M1 | library_map Template＋slots 定義（含 triplet 按庫過濾現況核實；不足則 Triplet template 加 optional library slot） |
B | — | 🔨 PR 已開 | D6 零建表。核實：triplet 無 library slot → 已走預案（design §1 核實結果） |
| M2 | kbdb base POST /map/recompute?library=＋GET /map／GET /map/:library（聚合 SQL 住基本盤；交易式 supersede） |
B | M1 | 🔨 PR 已開 | PR＋測試（真 SQLite 驗聚合）；merge 後 gated 部署（leo 閘）＋逐庫 backfill recompute |
| M3 | ingest 尾端接鏈：diff 涉及庫 → 逐庫呼 recompute（rag-ingest-cards v2＋個人庫 ingest 同款改版） | A | M2 | ⬜ | workflow 改版走 bundle 分發 |
| M4 | MCP：instructions 注入全館地圖＋get_map 工具 |
B | M2 | 🔨 PR 已開 | 與 #68 同族薄殼；kbdb_get_map＋connect 時注入（isolate TTL 快取，失敗靜默略過不擋連線）；merge 後 gated redeploy arcrun-mcp（leo 閘） |
| M5 | GUI 首頁：全館地圖 render（console＋portal） | B | M2 | ⬜ | 取代空白搜尋框 |
| M6 | D30 連動：map 層 embed＋semantic 庫路由第一跳 | B | M2 | ⬜ | #58/#59/#60 家族的第一片治本 |
| M7 | dogfood：leo 庫（leo21c）首個實例 backfill＋驗收（requirements 驗收段全項） | A | M3-M5 | ⬜ | 過了才進 demo/客戶 |