Leo
d2618758e2
- 位置統一：舊 docs/3-specs/ 五份 SDD git mv 到 system-dev/docs/3-specs/，舊位置留 README 指針 - 狀態判定：0 份 active（無現行開發，合法）；paused×3（ingest-contract/kbdb-graph-extraction/plugin-install，等跨 repo 接通）；closed×2 入 archive/（arcrun-key-auth/blocks-edit-api 死件，附封存原因） - 鋪檔（自 system-dev-template v1.15.0）：SDD-LIFECYCLE.md、pending-changes.md、sdd-guard.sh 新版、sdd-check.md、sdd-active-check.sh - hook 掛載：settings.json PreToolUse Write|Edit 加 sdd-guard.sh - CLAUDE.md：SDD 鐵律段（濃縮五條＋0-active 註明重啟先升 active）＋修正遷移後舊路徑 - 驗證：sdd-active-check exit 0；guard pipe-test 0-active 擋 code 寫入(exit 2)/md 放行(exit 0) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
26 lines
1.2 KiB
Markdown
26 lines
1.2 KiB
Markdown
# 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 查，不叫人填。
|