feat(graph): get_source + refresh 端點 + keyword 收斂 (T3.6-3.7)
對應 issue #1 T3 C 段(圖工具 HTTP API 備好,MCP 註冊薄殼待 arcrun)。 - get_source (3.7): graph-source.ts + GET /graph/source/:name — 回節點的 active triplet 來源指標(uri/anchor/block_id/content_hash),去重。 連帶加 source_anchor slot,ingest 從 source.anchor 帶入 - refresh (3.6/3.6b): graph-refresh.ts + POST /graph/refresh — 純被動代轉 ingest(KBDB_INGEST_URL),只人發起、無排程/webhook(fan-out 紅線)。 未設 URL → 誠實 forwarded:false,不假綠 - 3.6d: POST /search 移除公開 keyword 模式(重複 KBDB MCP),收斂 suggest-only; keywordSearch helper 留作 suggest 內部建構塊 - 3 新測試(get_source uri+anchor / active-only / refresh 未就緒誠實回報) gates: vitest 19 passed / zero SQL / 無新綁定 / dry-run bundle 乾淨 待接:MCP 註冊薄殼併 arcrun u6u-mcp-server;refresh 端到端待 ingest(T4) 部署 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -67,6 +67,14 @@ traverse / search / neighbors 從 records 組鄰接表前,先 `filter(status =
|
||||
- **`refresh` 紅線**(T3.6b):只能人發起的 MCP 調用觸發,**禁掛排程/webhook 自動 refresh**(否則變回 fan-out,踩 flag 紅線)。
|
||||
- **T3.6d**:整合時移除 `search-query.ts` 代理 base 關鍵字那條(重複,關鍵字歸 KBDB MCP)。
|
||||
|
||||
## 7.5 get_source / refresh 落地(C 段,已實作)
|
||||
|
||||
- **get_source**(`graph-source.ts` + `GET /graph/source/:name`):給節點名 → 回觸及它的 active triplet 的來源指標(`uri` / `anchor` / `block_id` / `content_hash`),按 uri+anchor 去重。為此 triplet template 增 `source_anchor` slot(ingest 從 `source.anchor` 帶入)。
|
||||
- **refresh**(`graph-refresh.ts` + `POST /graph/refresh`):純被動代轉 ingest 重抓+萃。graph 自己不抓不萃(ingest 純餵食器職責)。
|
||||
- 🚫 紅線:只人發起 MCP 調用觸發,無排程/webhook。
|
||||
- ingest 對象 = `KBDB_INGEST_URL`(env,T4 就緒前留空)。未設 → 誠實回 `{forwarded:false}`,不假綠。
|
||||
- **search keyword 收斂**(T3.6d):`POST /search` 移除公開 keyword 模式(重複 KBDB MCP `kbdb_search`),收斂為 suggest-only。`keywordSearch` helper 保留為 suggest 內部建構塊。
|
||||
|
||||
## 8. 不做 / 延後
|
||||
|
||||
- **graph CLI**(T3.7b):延後。人少在命令行 traverse、AI 用不到 → 不做(非省工,是不誤導 AI 以為有這條路)。
|
||||
|
||||
@@ -20,11 +20,14 @@
|
||||
|
||||
## C. MCP(⚠️ 跨 repo,需 arcrun 配合 → issue 標清)
|
||||
|
||||
- [ ] **3.6** 圖查詢 + `refresh` HTTP API/邏輯備好(graph 端);MCP 註冊薄殼併入 arcrun KBDB MCP(協調後接,**不另起 graph MCP**)
|
||||
- [ ] **3.6b** `refresh` 紅線:只人發起 MCP 觸發,禁排程/webhook 自動
|
||||
- [ ] **3.6d** 移除 `search-query.ts` 代理 base 關鍵字那條(重複,歸 KBDB MCP)
|
||||
- [ ] **3.7** `get_source` 端點(指回 source.uri + anchor)
|
||||
- [ ] **3.7b** ~~graph CLI~~ 延後不做(人少用、AI 用不到 → 不誤導)
|
||||
- [x] **3.6** 圖查詢 + `refresh` **HTTP API/邏輯備好(graph 端)**:`GET /graph/source/:name`、`POST /graph/refresh`、既有 traverse/neighbors/path/relation。**MCP 註冊薄殼仍待 arcrun 配合**(不另起 graph MCP)(2026-06-26)
|
||||
- [x] **3.6b** `refresh` 紅線:`graph-refresh.ts` 純被動代轉,只人發起調用觸發;無排程/webhook(2026-06-26)
|
||||
- [x] **3.6d** 移除 graph **公開** keyword 端點(`POST /search` 收斂為 suggest-only;keywordSearch helper 留作 suggest 內部建構塊)(2026-06-26)
|
||||
- [x] **3.7** `get_source`:`graph-source.ts` + `GET /graph/source/:name`(回 uri+anchor+block_id+content_hash,active-only,去重)。連帶加 `source_anchor` slot(2026-06-26)
|
||||
- [x] **3.7b** ~~graph CLI~~ 延後不做(人少用、AI 用不到 → 不誤導)
|
||||
|
||||
> **跨 repo 待接(總管協調)**:圖工具(traverse/neighbors/source)+ refresh 的 **MCP 註冊薄殼**併入 arcrun `u6u-mcp-server`(KBDB MCP),待 arcrun #7 落地後兩邊接。graph 端 HTTP API 已就緒。
|
||||
> **refresh 待部署**:`KBDB_INGEST_URL` 未設時 `refresh` 誠實回 `forwarded:false`(ingest repo T4 未就緒)。端到端待 ingest 部署驗。
|
||||
|
||||
## 完成準則
|
||||
|
||||
|
||||
Reference in New Issue
Block a user