docs(wiki): session 末更新 status + 補兩條 mistakes

- status.md:T0.5–T5 實作完成、PR #3/#4 拆分、issue #2 close、下次 merge 順序 + 部署待驗
- mistakes.md:① 功能 PR 別混 template 遷移(拆 PR)② 跨 repo 契約漂移先查總管裁定別自決

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-06-26 20:55:13 +08:00
parent 06e901f590
commit 5d762440b7
2 changed files with 24 additions and 12 deletions
+10 -7
View File
@@ -15,11 +15,14 @@
## 誤解記錄
(初始化時為空,隨專案進行 append
⚠️ MISTAKE: 功能 PR 混進 template 1.9.x 知識庫遷移(system-dev/ + .claude/
症狀: 開功能分支時順手把 wiki-init / template 遷移的 system-dev/、.claude/ 一起 commit 進同一筆,PR 同時含「功能改動」+「基建遷移」。
正確做法: 功能與基建分兩個 PR。功能 PR 只留 src/tests/contracts/config/SDD-taskstemplate 遷移(system-dev/ + .claude/ + SDD 位置搬移)獨立成筆、本 repo 自行 merge。從乾淨分支重建:reset 回 main → 只 stage 核心 → force-with-lease 蓋功能 PR;遷移另開分支。
原因: ① 淹沒真正改動、審查難 ② 多 repo 同跑 1.9.x 遷移會撞衝突(graph 撞過)③ 可能夾私稿。system-dev/ 該進 git,但走自己一筆、不混功能、別 gitignore 它。
日期: 2026-06-26
格式:
⚠️ MISTAKE: [錯誤描述,一句話]
症狀: [CC 通常怎麼表現這個錯]
正確做法: [應該怎麼做]
原因: [為什麼會錯]
日期: [YYYY-MM-DD]
⚠️ MISTAKE: 抓到跨 repo 契約漂移時自己拍板對齊方向
症狀: 發現 graph 部署端 .strict() Zod 比凍結 contract 窄(會 422 新欄位)→ 想直接決定 ingest 該送哪個版本。
正確做法: 契約是雙邊事 → 先查總管在相關 issue 的裁定(graph#1 已裁「contract 是 SSoT、實作追它、graph receiver 補對齊、ingest 不退」),照裁定做、別自決。跨 repo 修正要先問人。
原因: contract 是凍結單一真相源(三守則);單邊擅自退讓或改 contract 會破壞雙邊共識。見 [[envelope-契約]]。
日期: 2026-06-26
+14 -5
View File
@@ -7,17 +7,26 @@
## 正在做
repo 骨架階段(SDD tasks T0)。已有:CLAUDE.md(上游指針+鐵律)、README、`contracts/ingest-candidate.json`(凍結契約)、SDD 三件式骨架(`docs/3-specs/ingest-pipeline/`)、wiki 記憶系統(本輪 /wiki-init 完成)。`src/``tests/` 仍空。
T0.5T5 ingest 純餵食器管線**實作完成**issue #2,已 close)。程式碼在兩個待 merge 的 PR:
- **PR #3**(核心管線):`src/**`index/source-adapter/harvest/extract/graph-client/weave/pipeline/endpoint-check/envelope/types+ `tests/**`28 passed+ contract + CLI + config。mergeable/CLEAN,待總管 merge。
- **PR #4**template 1.9.x 遷移,本分支):`system-dev/**` + `.claude/**` + SDD 搬 `docs/3-specs/``system-dev/docs/3-specs/`。本 repo 自行 merge。
gate 全綠:vitest 28 / tsc clean / wrangler dry-run 只 env-var 綁定 / 零直連 base·SQL·migration。
## 下次 session 第一件事
接 SDD tasks T0.5:建 `package.json` / `tsconfig` / `wrangler.toml`(參考 kbdb-graph-plugin)。之後進 T1 SourceAdapterGitHub 拉 + content-hash
1. **merge 順序**:先請總管 merge PR #3(核心),再 rebase + merge PR #4(遷移)——#4 對 tasks.md 做位置搬移,#3 在原位更新它,先後 merge 免衝突
2. merge 後進**部署待驗**:部署 ingest Workerwrangler,繞 Actions+ 設 `GRAPH_BASE_URL` → 跑端到端 `GitHub→ingest→graph`(需 leo21c)。
## 待負責人確認
(無)
- PR #3 merge(總管)|PR #4 merge(本 repo / leo)。
## 已知問題
- ⏸ T5.1 POST envelope 依賴 graph `POST /triplets/ingest` 寫入端(InkStoneCo T3,待 graph repo 實作)。
- ⏸ embed 依賴 base vectorizeInkStoneCo T2.4)。第一版不 embed 可先動。
| 問題 | 優先級 | 狀態 |
|------|--------|------|
| 端到端 ingest→graph 未實證 | 🟡 | 待部署 + `GRAPH_BASE_URL`graph receiver 已補對齊 full contract |
| refresh 端 extractWorkers AI)未接 | ⚪ | 第一版只走採取(路徑 A);深萃留 CLI/CC |
| embed 實際 embedding | ⚪ | 只打標;等 base vectorizeArcrun #7 |
| T3.3 模型測試集(中文+暗示樣本) | ⚪ | deferred;護欄 + parse 已單元測試 |