Leo/Arcrun

Files

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

3.7 KiB

Raw Blame History

當前進度（SessionStart 會注入此檔重點）

更新時間：2026-07-21 權威來源＝design.md frontmatter status: active（機器可查），不是本檔。查法：bash system-dev/scripts/sdd-active-check.sh 本檔只是索引，任何與 frontmatter 衝突之處以 frontmatter 為準。

現行 active SDD

RAG Portal 多人授權 — system-dev/docs/3-specs/portal-auth/

依 SDD 生命週期鐵律（D35，全文 system-dev/docs/3-specs/SDD-LIFECYCLE.md）：任何時刻整個 repo 只允許一份 status: active。所有開發任務必須對應它的 tasks，找不到對應 → 停下來問，不准直接做。

session 開場請回報三個數字：現行規格名稱＋未完成任務數＋ pending-changes.md 待裁決 proposal 數。

已封存（closed，勿當進行中）

Credential Primitives TS → WASM

system-dev/docs/3-specs/archive/credential-primitives-wasm/（2026-07-21 封存）

主線已達成：cypher-executor TS 不再實作任何 credential / auth 業務邏輯。 credential-injector.ts、jwt-signer.ts、BUILTIN_API_RECIPES / BUILTIN_CREDENTIALS_MAP 全數移除（最後一項 T10 於 2026-07-20 commit 20c7610 完成）。

credential 現行做法（非被另一卷 supersede，是機制整個換掉）：

密文 → CF Workers per-script Secrets（CRED_{NAME}_{hash}），arcrun 讀不回明文
目錄 → D1 credentials 表（name / service / secret_ref，不含值）
arcrun 不自管任何加密金鑰；crypto_decrypt host function 已成永遠回失敗的 stub
完整規範：.claude/rules/01-tech-stack.md「Credential 儲存規範」

⚠️ 封存 ≠ 全部做完。真實殘留缺口（要做需另立新 SDD，不得掛回已封存的卷）：

auth_mtls 從未實作（registry/components/auth_mtls/ 不存在，mTLS 認證不支援）
7.6 self-hosted auth 鏈端到端未驗（global_fetch_strictly_public flag 是否真解 same-zone 1042，在自架帳號上從未實測）
數項端到端測試（1.7/1.8/2.6/3.5/3.6/5.1）無驗證記錄

逐條核實見該卷 tasks.md 的「封存時仍未完成的項目」段。

SDD 索引

「進行中」與否一律以 frontmatter 為準，下表僅路徑速查。

子系統	SDD
現行 active RAG Portal 多人授權	`system-dev/docs/3-specs/portal-auth/`
~~Credential Primitives WASM~~（closed）	`system-dev/docs/3-specs/archive/credential-primitives-wasm/`
LLM Interface（AI 操盤手使用體驗）	`system-dev/docs/3-specs/llm-interface/`
arcrun 總進度	`system-dev/docs/3-specs/arcrun/arcrun.md`
Auth Recipe 系統（schema、預建服務）	`system-dev/docs/3-specs/arcrun/auth-recipe.md`
SDK + Website	`system-dev/docs/3-specs/arcrun/sdk-and-website/`
arcrun MVP 整體	`system-dev/docs/3-specs/arcrun-core-mvp/`
Platform Evolution	`system-dev/docs/3-specs/arcrun-platform-evolution/`
Tech Stack 詳細	`system-dev/docs/3-specs/tech.md`
生命週期鐵律	`system-dev/docs/3-specs/SDD-LIFECYCLE.md`
待裁決 proposal	`system-dev/docs/3-specs/pending-changes.md`

技術備註（CC 常搞錯的點）

每個 WASM 零件 = 獨立 Worker = 獨立 URL。不是從 R2 動態讀。
Cypher binding = YAML 裡寫 URL 清單。不是 Cloudflare service binding。
cypher-executor 只做 routing + host functions。業務邏輯全在 WASM 零件。
TinyGo 有限制：crypto/rsa 支援不全 → 用 host function crypto_sign_rs256 讓 Worker 代簽。
credential 不自管金鑰：走 secret_get(ref) 讀 CF Workers Secrets，crypto_decrypt 是 stub。
詳見 .claude/rules/03-component-architecture.md 與 01-tech-stack.md。

3.7 KiB Raw Blame History Unescape Escape