Files
Arcrun/system-dev/docs/3-specs
Leo 5cadc60e36 feat(workflow-discovery): /cypher/search 改為真查 registry——修「查詢回假信號」
📋 SDD:workflow-discovery(本 commit 同時執行 D35 交接:portal-auth 26/26 完成 → closed
   superseded_by workflow-discovery;workflow-discovery paused → active。單一活性已驗=1 份)
🎯 對應 task:3.x 搜尋端誠實化(CP2-B)

病灶(leo 2026-07-30 定性「腹語術」):
search-nodes.ts 無條件回 status:'found'、missingNodes 永遠 []——
型別宣告了 'missing' 但程式碼從不使用。實測「完全不存在的東西xyz」也回 found。
⇒ AI 拿到假信號 → 以為零件存在 → 部署才發現沒有 → 改寫 code
⇒ 正式 workflow 只用 2 個零件、8 個 code 節點含 if×61。

修法:
- 查 registry 判真實存在(走 HTTP,守 D28 禁新增 service binding;
  URL 用既有 wasmWorkerUrl() 慣例組,不自創)
- found 時附 input_schema/success_rate/stability
  ⇒ AI 才填得出 payload、才看得到「測過幾次」(leo:AI 只要填 payload)
- 查不通回 'unknown' 而非 'missing'——**誠實限制**:
  不能因查詢失敗就宣告零件不存在(那會讓 AI 誤判而重寫 code)
- missing 真的回傳出去(原本寫死 [])

⚠️ 實測發現 registry **沒有列表端點**(GET /components → 404,只有 /components/<id>)
⇒ 改為逐個查(節點數通常 <10、5s timeout)。補列表端點後可改抓一次=CP2-B 待辦。

驗:tsc 零錯誤;vitest 9 failed/179 passed=**與改動前 stash 對帳完全相同**(既有債非本次造成)。
 待部署到實例後跑 arcrun-usable/verify.sh 驗 01 那組轉綠。
2026-07-30 20:41:53 +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