Files
Arcrun/system-dev/docs/3-specs
uncle6me-web 5919c6b90f fix(kbdb): 藏書地圖讀端每次都觸發重算寫 D1(Arcrun#87 止血)
liveTripletCountsByLibrary 沒有過濾 status,recomputeLibraryMap 只算
COALESCE(status,'active')='active'——兩邊判準不一致,只要庫裡有一筆
superseded triplet 就永遠判定 stale,導致每次讀地圖(GET /map、GET /map/:library、
kbdb_get_map MCP 工具)都觸發重算並新建一筆 library_map record,無止盡寫 D1,
且加劇既有的非原子 supersede 競態(kb 44 筆全 superseded、notes 兩筆同時 active
即 arcrun-rag#50 的共同根因之一)。

修法:liveTripletCountsByLibrary 的 SQL 改成 pivot 出 status 再套用與
recomputeLibraryMap 逐字一致的過濾,兩邊判準對齊。

新增迴歸測試釘住此 bug(反向驗證:跑在修前的 SQL 上會失敗,非空氣測試);
獨立用 leo21c MCP 連線連讀兩次 kbdb_get_map() 重現修前症狀
(general 庫 updated_at 從 1786457080 前進到 1786457114,中間無寫入)。

kbdb/tests/library-map.test.ts 19/19 全綠。既有殘骸(100 筆 library_map record)
未清——目前沒有可用的 DELETE 通道,待部署後另行處理。

kbdb-sql-ok:liveTripletCountsByLibrary 的 .prepare 呼叫是牆內本體
(kbdb/src/actions/),本次 checkout 開在巢狀 worktree
matrix/arcrun/.worktree-fix-87/(避免打斷另一 session 佔用中的
matrix/arcrun 主 checkout),kbdb-api-wall-guard.sh 的字面路徑比對
*matrix/arcrun/kbdb/src/* 吃不到中間多出的 worktree 目錄層,非真的繞牆。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-11 22:16:30 +08:00
..

3. Specs — 需求 + SDD + 進度

各子系統的設計文檔 + 任務清單。

進行中(必讀)

目錄 Phase 狀態
portal-auth/ 現行 active(唯一,D35 單一活性)
arcrun/kbdb-base/ Phase 7 上線完成 + 待處理(§8

「進行中」以各 design.md frontmatter status: active 為唯一判準:bash system-dev/scripts/sdd-active-check.sh

已封存(archive/closed

目錄 封存日 備註
archive/credential-primitives-wasm/ 2026-07-21 主線達成(cypher-executor TS 無 credential/auth 邏輯)。現行做法=CF Workers Secrets + D1 目錄。殘留缺口 auth_mtls 未實作、7.6 端到端未驗 → 要做需另立新 SDD

主線

目錄 內容 狀態
arcrun-core-mvp/ MVP 整體架構 基礎完成
arcrun/auth-recipe.md Auth recipe 系統 穩定
arcrun/landing-page.md Landing page 設計中
arcrun/sdk-and-website/ SDK + MCP + 文檔 進行中
arcrun-platform-evolution/ 長期演化規劃 路線圖

安全 & 基礎設施

目錄 用途
component-gatekeeping/ 零件投稿 gatekeepingPR + CI
component-registry-canon/ registry 規範化(dead storage cleanup
data-exfil-warning/ 資料外流警示 API 層實作

未來

目錄 用途
llm-interface/ AI 操盤手體驗改進(mira dogfood 痛點)
recipe-system/ recipe 長期規範(§5 onwards
resumable-workflow/ workflow 暫停恢復(Phase 6
user-cc-harness/ CC harness 安裝 + 配置(Phase 7

讀 SDD 的順序

新任務開始:

  1. docs/3-specs/arcrun/arcrun.md(全景進度)
  2. 對應子系統的 design.md(設計背景)
  3. 同目錄的 tasks.md(細節任務 + 依賴)

更新時間:2026-06-08