docs: SDD tasks + wiki 收尾（改寫全完成、推 public repo）
- tasks.md：R-EXT-4 改寫全 ✅、R-EXT-2 獨立 repo ✅、部署現況（待基本盤上線跑 install.sh） - wiki status：改寫完成快照 + 下次第一件事=實際部署 - wiki mistakes：記「讀違規現狀推翻鐵律」「embedding 非插件職責」兩條 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -13,8 +13,8 @@
|
||||
- [x] 1.4a 讀 arcrun 端真身對齊（2026-06-14）：**發現 arcrun/kbdb 還是 v2（entries，無 blocks/0005/0007/block-crud），且兩 repo 是不同 D1 庫**。v3 基本盤真身其實在本目錄。見 design.md「全局核對發現」
|
||||
- [x] 1.4b 前置議題**總管已答覆**（leo 2026-06-14）：→ `InkStoneCo/docs/3-specs/matrix-rearrange/DECISION-kbdb-v3-baseplane.md`。三問消解：基本盤已在 arcrun/kbdb 且設計正確、掛載走 API（非共用 D1）、插件零 migration。**阻擋解除。**
|
||||
- [x] 1.4c 不需移交/升級 arcrun——基本盤已正確。插件改寫成走 API 即可（見 R-EXT-4）
|
||||
- [ ] 1.5 裁剪 CLAUDE.md：移除基本盤規範，只留 graph 插件相關
|
||||
- [ ] 1.6 清掉殘留：`blocks.ts.bak`、誤入 repo 的 `ruvector.db`（根 + src/routes/ 各一份）、`finally.click` 空檔、`.swarm`
|
||||
- [x] 1.5 裁剪 CLAUDE.md：移除基本盤 v3 規範，只留 graph 插件 + 鐵律 + 安裝契約（2026-06-14）
|
||||
- [x] 1.6 清掉殘留：`blocks.ts.bak`、`ruvector.db`×2、`finally.click`、`.swarm`（2026-06-14）
|
||||
|
||||
## R-EXT-3 定義掛載介面（已定案 2026-06-14）
|
||||
|
||||
@@ -26,15 +26,27 @@
|
||||
|
||||
> 鐵律：插件零建表、零 migration、零 SQL，只用 API/CLI/MCP。
|
||||
|
||||
- [ ] 4.1 寫 `src/lib/kbdb-client.ts`：封裝基本盤 HTTP API（entries/templates/records），指向 `KBDB_BASE_URL` env var。零 `.prepare`
|
||||
- [ ] 4.2 wrangler.toml：移除 D1/Vectorize 綁定（插件不碰 DB），加 `KBDB_BASE_URL` var（先留空）
|
||||
- [ ] 4.3 改寫 `triplet-crud`（拆 < 100 行）：create/query/get/update/delete/stats → API
|
||||
- [ ] 4.4 改寫 `triplet-extract`/`triplet-entities`/`triplet-stats`/`triplet-update` → API
|
||||
- [ ] 4.5 改寫 `graph-{nodes,path,traverse}`：取 triplet records → 插件層組圖
|
||||
- [ ] 4.6 改寫 `entity-{crud,normalize,graph-embed}`：template='entity' + records API；無 vectorize 時降級 exact
|
||||
- [ ] 4.7 改寫 `search-query`/`search-*`：`GET /entries/search`（keyword）；語意搜尋標記待 embed 模組
|
||||
- [ ] 4.8 刪違規 migrations（0001/0002/0005/0007 等含 CREATE TABLE）+ 清基本盤 action/route（block-*/entry-crud/record-crud/tag/profile/admin/...）
|
||||
- [ ] 4.9 改測試走 mock client；標記 base 缺口（PUT/DELETE record、vectorize）為 `[→arcrun]`
|
||||
- [x] 4.1 `src/lib/kbdb-client.ts`：封裝基本盤 HTTP API，指向 `KBDB_BASE_URL`。零 `.prepare`（2026-06-14）
|
||||
- [x] 4.2 wrangler.toml：移除 D1/Vectorize/AI 綁定，加 `KBDB_BASE_URL` var（留空，安裝時 AI 填）
|
||||
- [x] 4.3 改寫 `triplet-crud`（拆 triplet-cluster）：create/query/get → API
|
||||
- [x] 4.4 改寫 `triplet-extract`/`triplet-entities`/`triplet-stats`/`triplet-update`/`triplet-embed` → API/薄殼
|
||||
- [x] 4.5 改寫 `graph-{nodes,path,traverse}`：取 triplet records → 插件層記憶體組圖
|
||||
- [x] 4.6 改寫 `entity-{crud,normalize,graph-embed}` + 拆 `entity-pending`：template='entity'，無 vectorize 降級 exact
|
||||
- [x] 4.7 改寫 `search-query`(→keywordSearch)/`search-suggest`/`search-embed`(stub)：keyword；語意標 `[→arcrun embed]`
|
||||
- [x] 4.8 刪所有 migrations + 清基本盤 action/route（block-*/entry-crud/record-crud/tag/profile/admin/partner/convert/tasks/personality）
|
||||
- [x] 4.9 測試改走 `tests/mock-client.ts`（10 passed）；base 缺口（PUT/DELETE record、vectorize）標 `[→arcrun]`
|
||||
|
||||
## R-EXT-2 獨立成 repo（2026-06-14 完成）
|
||||
|
||||
- [x] 2.2 `.gitignore`（排除 *.db/.env/.dev.vars/node_modules/.wrangler/.bak/.swarm）+ `git init`
|
||||
- [x] 2.3 首次 commit + 推 GitHub：**public repo `uncle6me-web/kbdb-graph-plugin`**（無 .github/workflows，符合不開 Actions）
|
||||
- [x] 2.4 部署機制：`scripts/install.sh`（安裝時 AI 查 subdomain 拼 base URL → `wrangler secret put` → `wrangler deploy`）。**實際部署待基本盤 arcrun-kbdb 上線後跑 install.sh**
|
||||
|
||||
## 部署現況（leo 2026-06-14 定）
|
||||
|
||||
- `KBDB_BASE_URL` 不寫死 toml、不叫人填 → 安裝時 AI 自動算（`https://arcrun-kbdb.<subdomain>.workers.dev`）。
|
||||
- 現在不空跑部署（避免上線一個打不到基本盤的殼）。基本盤就緒後跑 `scripts/install.sh` 一次到位。
|
||||
- build 已驗證（`wrangler deploy --dry-run` 通過，bundle 無 D1/AI/Vectorize 綁定）。
|
||||
|
||||
## R-EXT-2 獨立成 repo（最後做，依賴 1.4/1.5 完成）
|
||||
|
||||
|
||||
@@ -0,0 +1,25 @@
|
||||
# KBDB-graph 插件安裝 — Tasks
|
||||
|
||||
> 對應 design.md。動手前確認 design 已讀。
|
||||
|
||||
## Phase 1：安裝腳本
|
||||
|
||||
- [ ] 1.1 `scripts/install.sh`：git clone → wrangler whoami → 查 subdomain → 拼 BASE → secret put → deploy
|
||||
- [ ] 1.2 subdomain 查詢：CF API `GET /accounts/{id}/workers/subdomain`（可抽 arcrun cli/lib/cf-api.ts 既有實作）
|
||||
- [ ] 1.3 BASE 拼接 + 健康檢查：deploy 後 `GET {BASE}/health` 確認基本盤可達，不可達則明確報錯（不是默默裝壞）
|
||||
|
||||
## Phase 2：配置位置
|
||||
|
||||
- [ ] 2.1 wrangler.toml `KBDB_BASE_URL = ""` 保持空（占位，AI 安裝時填）
|
||||
- [ ] 2.2 `.dev.vars` 加入 `.gitignore`（本地測試值不進版控）
|
||||
- [ ] 2.3 部署值走 `wrangler secret put KBDB_BASE_URL`，不寫 toml/git
|
||||
|
||||
## Phase 3：測試
|
||||
|
||||
- [ ] 3.1 單元測試走 mock-client（已有），不依賴 KBDB_BASE_URL
|
||||
- [ ] 3.2 整合測試 doc：本地起 `arcrun/kbdb wrangler dev` + 插件 `.dev.vars` 指 localhost
|
||||
- [ ] 3.3 整合測試驗證：建 template='triplet' + 填 slot + 查圖，全走 API 無 SQL
|
||||
|
||||
## 不變條件（每步都守）
|
||||
- 零建表、零 migration、零直接 SQL（hook 會擋）。
|
||||
- 用戶零填寫——base URL 由 AI 查，不叫人填。
|
||||
Reference in New Issue
Block a user