# 當前狀態

> 更新時間：2026-06-26
> 每次 session 結束必須更新此檔（用 /wiki-update）。

---

## 最新（2026-06-26：issue #1 T3 — ingest 寫入端 + graph 端 API）

開 PR [#2](https://github.com/uncle6me-web/kbdb-graph-plugin/pull/2)（分支 `feat/ingest-contract-sdd`，4 commits，未 merge）。對應 [issue #1](https://github.com/uncle6me-web/kbdb-graph-plugin/issues/1)（頂層 mira-dissolve T3）。

完成：
1. ✅ **wiki 合併**：舊 `.claude/wiki/` → `system-dev/wiki/`（導入 system-dev-template）。
2. ✅ **ingest-contract SDD**（`docs/3-specs/ingest-contract/`）+ 搬入 `contracts/ingest-candidate.json`（T3.1/3.8）。
3. ✅ **寫入端 + 取代**（T3.2–3.5）：`POST /triplets/ingest`、ensureTemplate slot-diff 補丁、`updateRecord`、idempotency、**先 append 後 deprecate**、active-only 查詢。
4. ✅ **get_source + refresh**（T3.6/3.7）：`GET /graph/source/:name`、`POST /graph/refresh`（純被動代轉）、keyword 收斂（3.6d）。

驗證：`vitest run` **19 passed**（mock）；zero SQL / 無 D1·Vectorize·AI；`wrangler deploy --dry-run` bundle 乾淨；所有 action ≤100 行。

## 正在做 / 阻擋

- [🔄] **PR #2 待 review/merge** — 阻擋點：等 leo/總管。graph repo 端 T3 實作面已收斂，剩跨 repo 接通。

## 下次 session 第一件事

**確認 PR #2 狀態**：若已 merge → 切回 `main` 拉新狀態；若有 review 意見 → 在 `feat/ingest-contract-sdd` 上改。
本 repo 端 T3 無剩餘可單獨做的 task（其餘待跨 repo / 部署，見下）。

## 待負責人確認

- **PR #2 merge** — 等：leo/總管 review。
- **MCP 註冊薄殼**（圖工具 traverse/neighbors/source/refresh 併入 arcrun `u6u-mcp-server`）— 等：總管協調 arcrun，**不另起 graph MCP**。graph 端 HTTP API 已備好。

## 已知問題 / 缺口

| 問題 | 優先級 | 狀態 |
|------|--------|------|
| refresh 端到端走通 | 🟡 | 待 ingest repo（T4）部署 + `KBDB_INGEST_URL` 設定；未設時誠實回 `forwarded:false` |
| semantic normalize | 🟡 | 仍 exact-only，留接口；待 base embed（Arcrun #7，code done 待部署） |
| MCP 工具實際可用 | 🟡 | graph 端 API 備好，待 arcrun 註冊薄殼 |
| base `DELETE /records/:id` | ⚪ | 仍無 → triplet/entity delete 為 soft（不硬刪）；死資料清除原則見頂層 T8 |

> 註：base `PATCH /records/:id` **已就緒**（Arcrun #6 closed，本 session ingest deprecate 即用此）。舊 status 列的「base 無 PUT /records/:id」缺口已部分解除。