Claude 65075b4615 feat(graph): 收斂 gloss-bridge + owner-threading 為單一可部署分支
合併 arcrun-7-gloss-bridge(A1 gloss 橋)與 owner-threading(owner_id 寫入鏈必經):
- node-persist / triplet-ingest 衝突解為「兩者都要」:persistNodes 既寫 entity
  record(帶真 owner)又 upsert gloss entry(帶真 owner、帶 source);ingestEnvelope
  既帶 source.uri 又 thread 必填 owner 到底。
- gloss 路徑補 owner 必填(配合 owner-mandatory D28):
  * upsertGlossEntry(..., owner_id: string) owner 改必填
  * backfillGlossEntries(client, owner_id: string) owner 改必填
  * POST /backfill-gloss-entries 缺 owner_id → 400(存量 record owner=None,
    owner 由 caller 明確指定,不從 record 帶)
- 合併兩支測試:gloss 測試補 owner 參數以配合 base owner-required mock。

tsc:除 index.ts:57 swaggerUI 既存 baseline 外 0 error。
vitest:34 passed(gloss 7 + owner/graph 27)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Ck8bjuBTLFkiFxqLGHMpqG
2026-07-05 11:20:47 +00:00

文件分類索引

CC 整理文件時的分類依據。找不到分類就問,不要猜。


分類規則

目錄 放什麼 判斷標準
1-vision/ 為什麼做這個 產品願景、北極星、設計哲學
2-architecture/ 系統怎麼設計的 架構圖、技術棧、元件關係
2-architecture/decisions/ 為什麼這樣設計 ADR,選A不選B的原因
3-specs/ 要做什麼 SDD,每個子系統一個目錄
4-guides/ 怎麼做 部署、開發流程、CLI 用法
5-records/ 發生過什麼 歷史記錄,不修改只增加
5-records/incidents/ 生產問題復盤 故障原因、時間線、改進方案
5-records/test-reports/ 測試結果 壓測報告、驗收記錄
6-user/ 給使用者看的 README、安裝教學、FAQ

CC 整理文件時的判斷流程

這個文件是...
├── 有明確子系統 + 設計內容? → docs/3-specs/[子系統]/
├── 解釋為什麼做某個決定?   → docs/2-architecture/decisions/
├── 說明怎麼操作?           → docs/4-guides/
├── 記錄發生過的事?         → docs/5-records/
├── 給外部使用者看的?       → docs/6-user/
└── 以上都不確定?          → 列為「待確認」,問負責人

SDD 結構(docs/3-specs/ 下每個子系統)

docs/3-specs/[子系統名]/
├── design.md    ← 設計文件(要做什麼、怎麼做、邊界在哪)
└── tasks.md     ← 任務清單([ ] 未開始 [🔄] 進行中 [x] 完成)

CC 動手前必須有這兩個檔案。找不到就停手。


.claude/wiki/ — CC 的記憶空間(CC 維護,人不手動編輯)

檔案 用途 更新時機
INDEX.md wiki 導引 新增 wiki 檔案時
mistakes.md CC 已知誤解 + 避坑 每次被糾正後
status.md 當前進度 + 下一步 每次 session 結束
decisions-summary.md 架構決策摘要 重大決策後
S
Description
No description provided
Readme 437 KiB
Languages
TypeScript 51.4%
Shell 48.6%