fix(kbdb): 三元組版標庫批次補存量＋對外通道（Arcrun#87 二次收尾） #114

2026-08-13T03:13:18Z

Leo commented

2026-08-13 03:13:18 +00:00

補 Arcrun#87 缺的批次能力：藏書地圖讀的是三元組 record 自己的 library slot，Arcrun#85 的 POST /entries/backfill-library 補的是 entries.metadata_json.library（不同存放處，補了地圖依然是 0）。既有通道只有單筆 PATCH /kbdb/records/:id，母體上千筆逐筆呼叫不現實。

新增 backfillTripletLibraryTags + POST /records/backfill-library + cypher proxy 對外通道，安全原則對齊既有 entries 版（呼叫端決定 library+source_prefix、冪等、共用 D69 每日額度、owner_id 必填、沿用既有 updateRecord 不手刻第二套 SQL）。

測試：kbdb 218/218 全綠（新增 5 案）；cypher-executor 新增 5 案全過；兩處既有失敗確認 pre-existing（stash 前後一致）。

紅線：未部署、未對 leo21c 執行任何實際 backfill——MCP 工具集沒有 update/patch record 能力，且不可對 leo21c 裸跑 CLI。批次執行留給總管/leo 決定執行方式與時機（POST /kbdb/records/backfill-library body 範例：{library:"arcrun", source_prefix:"gitea:Leo/Arcrun@"}，逐庫呼叫直到 GET .../status 回 pending:0）。

詳細調查與對照清單見 system-dev/wiki/ops-facts.md「雲端庫↔本機資料夾對照清單＋來源標籤設計」段。對應票：Leo/Arcrun#87。

補 Arcrun#87 缺的批次能力：藏書地圖讀的是三元組 record 自己的 library slot，Arcrun#85 的 POST /entries/backfill-library 補的是 entries.metadata_json.library（不同存放處，補了地圖依然是 0）。既有通道只有單筆 PATCH /kbdb/records/:id，母體上千筆逐筆呼叫不現實。新增 backfillTripletLibraryTags + POST /records/backfill-library + cypher proxy 對外通道，安全原則對齊既有 entries 版（呼叫端決定 library+source_prefix、冪等、共用 D69 每日額度、owner_id 必填、沿用既有 updateRecord 不手刻第二套 SQL）。測試：kbdb 218/218 全綠（新增 5 案）；cypher-executor 新增 5 案全過；兩處既有失敗確認 pre-existing（stash 前後一致）。紅線：**未部署、未對 leo21c 執行任何實際 backfill**——MCP 工具集沒有 update/patch record 能力，且不可對 leo21c 裸跑 CLI。批次執行留給總管/leo 決定執行方式與時機（`POST /kbdb/records/backfill-library` body 範例：`{library:"arcrun", source_prefix:"gitea:Leo/Arcrun@"}`，逐庫呼叫直到 GET .../status 回 pending:0）。詳細調查與對照清單見 `system-dev/wiki/ops-facts.md`「雲端庫↔本機資料夾對照清單＋來源標籤設計」段。對應票：Leo/Arcrun#87。

Leo added 1 commit 2026-08-13 03:13:18 +00:00

fix(kbdb): 三元組版標庫批次補存量＋對外通道（Arcrun#87 二次收尾） 179dd60571

藏書地圖（library-map.ts）讀的是三元組 record 自己的 'library' slot（entry_values），
不是 entries.metadata_json.library——Arcrun#85 建的 POST /entries/backfill-library
補的是後者，補了地圖依然是 0。既有能補三元組 library 值的通道只有單筆
PATCH /kbdb/records/:id（b6ef0f0，已在 main），母體上千筆時逐筆呼叫不現實，也沒有
節流/冪等保護。

新增：
- kbdb/src/actions/library-backfill.ts：backfillTripletLibraryTags +
  tripletLibraryBackfillStatus，安全原則與既有 entries 版逐條對齊——呼叫端決定
  library 值＋source_prefix 篩選（base 不猜語意）、冪等（NOT EXISTS 找缺 library 的
  那半）、與 entries 版/embed reconcile 共用同一顆 D69 每日 D1 寫入額度、owner_id 必填、
  寫入沿用既有 updateRecord（不手刻第二套 entry_values UPSERT SQL）。
- kbdb/src/routes/records.ts：POST /records/backfill-library + GET .../status。
- cypher-executor/src/routes/kbdb-proxy.ts：對外通道，owner_id 強制用租戶身份（同本檔
  既有 POST /kbdb/records 慣例，不信任 caller 自帶 owner_id）。

測試：kbdb 新增 5 案（含跨租戶隔離／冪等／D69 共用額度截斷／status 統計），全套
218/218 綠燈；cypher-executor 新增 5 案（租戶閘/參數驗證/轉發/owner_id 覆蓋），
兩份既有失敗（auth.test.ts ExecutionContext 型別缺陷、portal-data/portal-admin/
console-library-map-page/executor.test.ts 訊息措辭）複驗與本次改動無關（stash 前後
一致，pre-existing）。

紅線：未併 main、未部署、未對 leo21c 執行任何實際 backfill（缺安全的寫入通道——
MCP 工具集無 update/patch record 能力，CLI 全域設定指著 leo21c 不可裸跑）。
批次執行是下一步，需總管/leo 決定執行方式與時機。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Leo referenced this pull request

2026-08-13 04:23:14 +00:00

藏書地圖是空的——8 個庫有 7 個顯示 0 個關係、0 個代表主題 #87

Leo referenced this pull request

2026-08-13 04:27:43 +00:00

藏書地圖是空的——8 個庫有 7 個顯示 0 個關係、0 個代表主題 #87

This pull request can be merged automatically.

This branch is out-of-date with the base branch

You are not authorized to merge this pull request.

View command line instructions