# 信任邊界

了解讓 KuraDB 對消費端保持唯讀、對內保持一致的不變條件。

## 信任邊界與不變條件

### 讀取面

- HTTP API 只註冊 GET route；不得以 mutation endpoint 繞過 ingestion。
- MCP 只暴露兩個唯讀 tool：`list_rag` 與 `search_rag`；沒有任何 tool 會寫入 SQLite 或快取。
- HTTP listener 綁定 `127.0.0.1`，且 `/mcp` 只在啟動時已啟用 `remote` 才掛載。
- API response 會暴露 source、chunk 與 content，但不暴露內部 ID、score、hit count 或 total。

### 寫入路徑

- 內容寫入必須經過 watcher → parser → `databaseHandler.Upsert` → SQLite；`internal/database` 以外的層不寫入 `file_data`。
- Daemon 是唯一寫入者。`kura mcp` 開啟相同資料庫，但不註冊 query cache 寫入 hook，也不啟動 watcher 或 embedder。
- 圖片及其他被略過的 binary format 不會進入文字 embedding pipeline。

### 資料不變條件

- Keyword 與 semantic read 必須排除 `dismiss = TRUE` 的 row。
- Embedding 必須符合 process-wide `openai.Dim()`（512 維）。預載 `global.db` 時會略過其他大小的 query cache row；chunk 向量在載入時不檢查長度，搜尋時會略過長度與 query 不同的向量。
- 新註冊的資料庫只能在重新啟動後使用。