Files
Arcrun/system-dev/docs
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
..

Arcrun 文件分類索引

LLM Wiki 結構:長期記憶系統,防止決策遺忘和重複錯誤。 參考:Andrej Karpathy — A Closer Look at How LLMs Remember


分類規則

目錄 用途 例子
1-vision/ 「為什麼」:設計哲學、核心價值、前瞻方向 arcrun 優勢、Haiku 就能搞定、薄殼原則
2-architecture/ 「是什麼」:系統設計、技術棧、組件關係 MVP 架構、零件模型、KV 存儲方案
2-architecture/decisions/ 架構關鍵決策和 trade-off Service binding 為什麼廢、R2 只用 Phase 5、同 zone 1042 解法
3-specs/ 需求和 SDD:設計文件、任務清單 (從 .agents/specs/ 搬來)
4-guides/ 操作手冊:如何做、工作流程 部署流程、CLI 用法、壓測方法
5-records/ 日誌和證據:事件、測試、決策履歷 Incident、壓測報告、問題追蹤
5-records/incidents/ 生產問題復盤:故障原因、改進方案 2026-05-13 同 zone 1042、2026-06-06 MCP route bug
5-records/test-reports/ 壓測結果、驗收報告 2026-06-07 公庫上線測試、2026-06-08 Haiku 乾淨重測
6-user/ 對外文件:README、教程、FAQ self-hosted 安裝、開發者指南

.claude/wiki/ — LLM 本機記憶

檔案 用途 更新頻率
INDEX.md wiki 目錄和導引 每次新增
mistakes.md CC(我)常犯的錯 + 避坑方法 每次踩坑後
status.md 當前進度、已知問題、下一步 每次 session 結束
decisions-summary.md 架構決策快速參考(不是全文,是摘要 + 連結) 每次大決策後
modules/[name].md 關鍵模組說明:職責、入口、常見誤解 不定期補充

檔案遷移計畫

當前位置 新位置 優先級
根目錄 .md(除 README/CLAUDE → docs/ 分類
.agents/specs/ → docs/3-specs/
.claude/rules/ → docs/2-architecture/ + wiki
docs/incidents/ → docs/5-records/incidents/
壓測報告 → docs/5-records/test-reports/

下一步

所有檔案整理進此結構後,wiki 將作為 CC 和任何 LLM 的長期記憶入口。