Files
Arcrun/system-dev/docs/3-specs/README.md
T
Leo 8d8b01d240 docs(sdd): credential-primitives-wasm 封存進 archive(T10 完成,卷已結案)
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>
2026-07-21 01:57:34 +08:00

59 lines
2.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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