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:
2026-06-14 21:22:23 +08:00
parent 3fa5cda796
commit c82d75f742
4 changed files with 83 additions and 30 deletions
+23 -11
View File
@@ -13,8 +13,8 @@
- [x] 1.4a 讀 arcrun 端真身對齊(2026-06-14):**發現 arcrun/kbdb 還是 v2entries,無 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 APIentries/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 刪違規 migrations0001/0002/0005/0007 等含 CREATE TABLE+ 清基本盤 action/routeblock-*/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/routeblock-*/entry-crud/record-crud/tag/profile/admin/partner/convert/tasks/personality
- [x] 4.9 測試`tests/mock-client.ts`10 passedbase 缺口(PUT/DELETE record、vectorize `[→arcrun]`
## R-EXT-2 獨立成 repo2026-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 完成)