8d8b01d240
leo 2026-07-21 明令封存:卷已完成,留主目錄會讓未來 session 誤以為進行中。
最後一項 T10(廢除自管加密金鑰)已於 20c7610 完成(移除約 2500 行)。
- git mv 整卷 → system-dev/docs/3-specs/archive/credential-primitives-wasm/
design.md status: closed;superseded_by 留空(據實:非被另一卷取代,是機制整個換掉)
- 卷首補「封存時仍未完成的項目」——逐條查 code 核實,不當作完成:
真缺口=auth_mtls 從未實作、7.6 self-hosted auth 鏈端到端從未驗;
另有勾選過期(auth_oauth2 其實已完成)與驗收條件已作廢(與現行 rule 07 牴觸)者
- 修好 14 處引用(原盤點 10 處,實際更多):session-start-load-sdd.sh 內容嚴重過期
(把已完成 Phase 寫成進行中)→ 改為以 frontmatter 為判準;四份 rules、CLAUDE.md、
BACKLOG、3-specs/README、deploy.ts、credentials.ts、wrangler.toml 逐一按性質處理
- 額外:system-dev/docs/2-architecture/ 有四個規則檔重複副本(06-08 遷移遺留)
→ 同步修好,否則留一份過期真相(今日第三次撞到「同一資訊兩份副本」的債)
- 02-forbidden.md §2.1 列的三個「待刪違規 TS」其實早已不存在
→ 改標刪除線+禁止重新引入(過期文件同時製造假待辦與假進行中)
驗證:sdd-active-check exit 0(active 仍恰一份=portal-auth);
session-start-load-sdd.sh exit 0;cypher-executor 與 cli typecheck 全綠;
測試 187/188(唯一 fail 為 pre-existing,stash 覆驗相同)。
未動:pre-write-guard.sh 的 KNOWN_SDDS 白名單不含 archive 路徑
(放寬 guardrail 需明確授權,留待決定)。
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2. Architecture — 系統設計 + 技術棧 + 決策
「是什麼」層:arcrun 的設計、技術棧、硬限制、關鍵決策。
快速導航
硬限制 & 規範
| 檔案 | 用途 |
|---|---|
| 01-tech-stack.md | 三層語言、資料儲存、加解密、網路部署(硬規範) |
| 02-forbidden.md | 禁止行為清單(hook 強制執行) |
| 03-component-architecture.md | 零件架構:R2/binding/URL 正確定義 |
| 00-sdd-protocol.md | SDD 讀取協議(流程強制) |
| 04-current-progress.md | 當前 Phase + SDD 索引 |
設計原理
| 檔案 | 用途 |
|---|---|
| 06-mindset.md | 設計哲學 7 條:為什麼做這些選擇 |
| 07-thin-shell.md | 薄殼原則鐵律(§1-6 原則 + hook 強制範圍) |
| 05-deploy-convention.md | 部署慣例(掃描式 workflow、lockfile、WASM 來源) |
決策記錄
| 檔案 | 用途 |
|---|---|
| decisions/ | 架構決策歷史(搬來中) |
常見查詢
- 「零件怎麼部署?」 → 03-component-architecture.md 部署步驟
- 「為什麼不用 service binding?」 → 03-component-architecture.md + 決策/same-zone-1042
- 「怎樣設計新功能?」 → 06-mindset.md §1 + 07-thin-shell.md
- 「禁止清單是什麼?」 → 02-forbidden.md
- 「技術棧限制有哪些?」 → 01-tech-stack.md
更新時間:2026-06-08