Leo
613071f41d
對應 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>
3.3 KiB
3.3 KiB
ingest-contract — tasks
唯一進度來源，不靠對話記憶。對應 issue #1（頂層 mira-dissolve T3）。 完成一項即時打勾 + 註記證據。端到端需 leo21c 部署的，標「待部署驗」，不假綠。
A. 契約 + template slot
- 3.1 搬
contracts/ingest-candidate.json進本 repo +contracts/README.md標明候選≠已存（2026-06-26） - 3.2
ensureTemplate改 slot-diff 補丁（命中既有 → basePATCH /templates/:id補缺 slot，不再 early-return）；TRIPLET_SLOTS加status+superseded_by+source_uri+content_hash（2026-06-26，kbdb-client.ts+templates.ts） - 3.2b
ENTITY_SLOTS加gloss（已核實現無）（2026-06-26） - 3.2c normalize 分層 fallback 接口：exact-only 先做；semantic 留接口（待 base embed，Arcrun #7）
B. 寫入端 + 取代（核心）
- 3.3a
KbdbClient.updateRecord(id, values)→ basePATCH /records/:id（2026-06-26，mock 同步） - 3.3b
src/actions/triplet-ingest.ts：Zod strict 驗證 → idempotency（uri+hash）→ 先 append 後 deprecate。88 行純函式（2026-06-26） - 3.3c
POST /triplets/ingestroute（驗證失敗 → 422 hook，只驗證+呼叫 action）（2026-06-26） - 3.4 測試 6 案全綠：正常 / 同 hash no-op / 新 hash deprecate / 污染(bridge_score+頂層 id) 422 / rollback（
vitest run16 passed）（2026-06-26） - 3.5 查詢 active-only：
queryTriplets缺省 filterstatus==='active'（traverse/search/neighbors 皆經此；includeDeprecatedopt-out 供 rollback/考古）（2026-06-26）
C. MCP（⚠️ 跨 repo，需 arcrun 配合 → issue 標清）
- 3.6 圖查詢 +
refreshHTTP API/邏輯備好（graph 端）：GET /graph/source/:name、POST /graph/refresh、既有 traverse/neighbors/path/relation。MCP 註冊薄殼仍待 arcrun 配合（不另起 graph MCP）（2026-06-26） - 3.6b
refresh紅線：graph-refresh.ts純被動代轉，只人發起調用觸發；無排程/webhook（2026-06-26） - 3.6d 移除 graph 公開 keyword 端點（
POST /search收斂為 suggest-only；keywordSearch helper 留作 suggest 內部建構塊）（2026-06-26） - 3.7
get_source：graph-source.ts+GET /graph/source/:name（回 uri+anchor+block_id+content_hash，active-only，去重）。連帶加source_anchorslot（2026-06-26） - 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 部署驗。
完成準則
- 全程 zero SQL / zero migration / 無 D1·Vectorize·AI 綁定（
wrangler deploy --dry-runbundle 乾淨） - 所有 action ≤100 行；
vitest run全綠（mock client） - 端到端 ingest→graph 走通需 base 上線 + ingest repo（T4）就緒 → 標「待部署驗」
- issue #1 留 open，待實證綠燈才結案