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:
@@ -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-tasks;template 遷移(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
|
||||
|
||||
@@ -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.5–T5 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 SourceAdapter(GitHub 拉 + content-hash)。
|
||||
1. **merge 順序**:先請總管 merge PR #3(核心),再 rebase + merge PR #4(遷移)——#4 對 tasks.md 做位置搬移,#3 在原位更新它,先後 merge 免衝突。
|
||||
2. merge 後進**部署待驗**:部署 ingest Worker(wrangler,繞 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 vectorize(InkStoneCo T2.4)。第一版不 embed 可先動。
|
||||
| 問題 | 優先級 | 狀態 |
|
||||
|------|--------|------|
|
||||
| 端到端 ingest→graph 未實證 | 🟡 | 待部署 + `GRAPH_BASE_URL`(graph receiver 已補對齊 full contract) |
|
||||
| refresh 端 extract(Workers AI)未接 | ⚪ | 第一版只走採取(路徑 A);深萃留 CLI/CC |
|
||||
| embed 實際 embedding | ⚪ | 只打標;等 base vectorize(Arcrun #7) |
|
||||
| T3.3 模型測試集(中文+暗示樣本) | ⚪ | deferred;護欄 + parse 已單元測試 |
|
||||
|
||||
Reference in New Issue
Block a user