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
parent df1b953d1f
commit 8d8b01d240
21 changed files with 241 additions and 161 deletions
@@ -14,9 +14,7 @@

 | 任務類型 | 對應 SDD |
 |---------|---------|
-| Auth primitive WASM 零件（static_key/oauth2/service_account/mtls） | `docs/3-specs/arcrun/credential-primitives-wasm/` |
-| 清除 cypher-executor 裡的 TS 業務邏輯 | `docs/3-specs/arcrun/credential-primitives-wasm/` |
-| WASI shim host functions（kv_get / crypto_decrypt / crypto_sign_rs256） | `docs/3-specs/arcrun/credential-primitives-wasm/` |
+| Auth primitive WASM 零件 / credential 儲存 / WASI shim host functions | **已封存**（`system-dev/docs/3-specs/archive/credential-primitives-wasm/`，`status: closed`）。現行規範見 `.claude/rules/01-tech-stack.md`「Credential 儲存規範」；**新工作需另立 SDD**（含未實作的 `auth_mtls`），不得掛在已封存的卷上 |
 | Auth Recipe 系統（recipe schema、KV 格式） | `docs/3-specs/arcrun/auth-recipe.md` |
 | Landing Page | `docs/3-specs/arcrun/landing-page.md` |
 | CLI / SDK（Python/JS） | `docs/3-specs/arcrun/sdk-and-website/` |
@@ -83,7 +83,7 @@ Auth primitive 必須透過 `component-worker-template/` 搭配 WASM binary 部

 13 個現有的 `SVC_*` 綁定（`cypher-executor/wrangler.toml`，邏輯零件）是歷史遺產（效能優化），**保留但不新增**。

-> **2026-06-06 註（credential-primitives-wasm Phase 7）**：self-hosted 的 cypher 與 auth worker 同在 `{sub}.workers.dev` zone，cypher `fetch()` 打 auth 觸發 CF **same-zone 1042**（壓測階段 11）。**未用 service binding 解**（評估後廢：service binding 靜態、加/改要重 deploy cypher）。改用 **`global_fetch_strictly_public` compatibility flag**（cypher wrangler.toml）讓 same-zone fetch 走公網前門 → 同 zone 也通，**auth 維持 HTTP fetch、不加 binding**。故本禁令不變。
+> **2026-06-06 註**（來源：credential-primitives-wasm Phase 7，該卷已封存於 `system-dev/docs/3-specs/archive/`；**本註記述的規則仍現行有效**）：self-hosted 的 cypher 與 auth worker 同在 `{sub}.workers.dev` zone，cypher `fetch()` 打 auth 觸發 CF **same-zone 1042**（壓測階段 11）。**未用 service binding 解**（評估後廢：service binding 靜態、加/改要重 deploy cypher）。改用 **`global_fetch_strictly_public` compatibility flag**（cypher wrangler.toml）讓 same-zone fetch 走公網前門 → 同 zone 也通，**auth 維持 HTTP fetch、不加 binding**。故本禁令不變。

 **Hook 會擋**：bash 指令含 `wrangler tail` 以外、涉及 `[[services]]` 新增的 pattern；Edit wrangler.toml 新增 `[[services]]` 區塊時警告確認。

@@ -79,7 +79,7 @@ Service binding 需要 `wrangler.toml` 裡寫死 `[[services]]`，且要 redeplo

 **禁止新增任何 Service Binding**。所有新零件（含 auth primitive）都走 HTTP URL 路徑。

-**same-zone 1042 的解（credential-primitives-wasm Phase 7，2026-06-06）**：self-hosted 的 cypher 與 auth worker 同在 `{sub}.workers.dev` zone，cypher `fetch()` 打 auth 觸發 CF **1042**（官方 docs：「fetch from another Worker on the **same zone**」；官方 cypher 在 `cypher.arcrun.dev`、打 `*.workers.dev` 屬跨 zone 故不踩——非官方有 flag）。**解法不是 service binding**（評估後廢：靜態、加/改要重 deploy），而是 cypher wrangler.toml 加 **`global_fetch_strictly_public` flag**——讓 same-zone fetch 走公網前門 → 同 zone 也通。auth 維持 HTTP fetch、不加 binding。官方加此 flag 行為不變（本就跨 zone），self-host 被修好 → **官方與 self-host 共用同一份 toml**。
+**same-zone 1042 的解**（來源：credential-primitives-wasm Phase 7，2026-06-06；該卷已封存於 `system-dev/docs/3-specs/archive/`，**但本段規則仍現行有效**）：self-hosted 的 cypher 與 auth worker 同在 `{sub}.workers.dev` zone，cypher `fetch()` 打 auth 觸發 CF **1042**（官方 docs：「fetch from another Worker on the **same zone**」；官方 cypher 在 `cypher.arcrun.dev`、打 `*.workers.dev` 屬跨 zone 故不踩——非官方有 flag）。**解法不是 service binding**（評估後廢：靜態、加/改要重 deploy），而是 cypher wrangler.toml 加 **`global_fetch_strictly_public` flag**——讓 same-zone fetch 走公網前門 → 同 zone 也通。auth 維持 HTTP fetch、不加 binding。官方加此 flag 行為不變（本就跨 zone），self-host 被修好 → **官方與 self-host 共用同一份 toml**。

 **仍禁止**：為**用戶自製 / 服務專屬零件**（`gmail-worker`、`notion-worker` 之類）新增 binding——那些是 recipe 的事，不該有 binding。**workflow 層（用戶串零件）一律 HTTP URL 不變。**

@@ -1,77 +1,75 @@
 # 當前進度（SessionStart 會注入此檔重點）

-> 更新時間：2026-04-19
-> 權威來源：`docs/3-specs/arcrun/credential-primitives-wasm/tasks.md`
-> 此檔僅摘要，詳細狀態以 tasks.md 為準。
+> 更新時間：2026-07-21
+> **權威來源＝design.md frontmatter `status: active`**（機器可查），不是本檔。
+> 查法：`bash system-dev/scripts/sdd-active-check.sh`
+> 本檔只是索引，任何與 frontmatter 衝突之處以 frontmatter 為準。

 ---

-## 封測狀態
+## 現行 active SDD

-**原定明天封測，richblack 決定推遲**，原因：cypher-executor 有三套 TS 業務邏輯違反「零件一律 WASM」架構原則（Phase 1-3 要清除的程式碼），在清除前不封測。
+**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 數。

 ---

-## 目前 Phase：Credential Primitives TS → WASM
+## 已封存（closed，勿當進行中）

-**SDD 位置**：`docs/3-specs/arcrun/credential-primitives-wasm/design.md` + `tasks.md`
+### Credential Primitives TS → WASM

-### 已完成
+`system-dev/docs/3-specs/archive/credential-primitives-wasm/`（2026-07-21 封存）

- **Phase 0.1–0.5**：核心合併（u6u-core 併入 arcrun、21 個零件 contract 完整、刪除重複 `credentials/` 目錄、CREDENTIALS_KV binding 確認、刪除 `matrix/u6u-core/`）
- `registry/components/` 下 21 個零件（邏輯 + API）都有 `main.go` + `.wasm`
+**主線已達成**：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 儲存規範」

-| Task | 狀態 | 阻擋關係 |
-|-----|------|---------|
-| 0.6 wasi-shim 新增 `kv_get` / `crypto_decrypt` / `crypto_sign_rs256` host functions | ⬜ 未開始 | **Phase 1-3 的硬前置** |
-| 0.7 component-loader 新增 WASM runner 路徑 | ⬜ 未開始 | **Phase 1-3 的硬前置** |
-| 1.1-1.8 `auth_static_key` WASM 零件（TinyGo） | ⬜ 未開始 | 涵蓋 80% 服務 |
-| 2.1-2.6 `auth_service_account` WASM 零件（JWT signing） | ⬜ 未開始 | Google Service Account 等 |
-| 3.1-3.5 清除 `component-loader.ts` 的 `BUILTIN_API_RECIPES` | ⬜ 未開始 | 要先有 Phase 1-2 的 WASM 零件 |
-| 4.1-4.4 `auth_oauth2` + `auth_mtls`（封測後） | ⬜ 未開始 | 非阻擋項 |
-| 5.1-5.7 核心穩定驗證（全域搜尋確認無殘餘 TS） | ⬜ 未開始 | 封測啟動門檻 |
+⚠️ **封存 ≠ 全部做完**。真實殘留缺口（要做需另立新 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）無驗證記錄

-### Phase 1-3 要**徹底刪除**的 TS 檔案（不是搬、不是改，是刪）
-
-| 檔案 | 違反什麼 |
-|-----|---------|
-| `cypher-executor/src/actions/credential-injector.ts` | AES 解密、template 展開、JWT 邏輯 —— 應在 WASM |
-| `cypher-executor/src/lib/jwt-signer.ts` | RS256 JWT 簽章邏輯 —— 應在 `auth_service_account.wasm` |
-| `cypher-executor/src/lib/component-loader.ts` 的 `BUILTIN_API_RECIPES`（~100 行） | gmail/telegram/line/gsheets/http_request/cron 的 TS 實作 —— 應全部走對應 WASM 零件 |
-
---
-
-## 下一個 session 第一件要做的事
-
-**讀 `docs/3-specs/arcrun/credential-primitives-wasm/tasks.md`**，然後決定從 Phase 0.6 還是 0.7 開始。
-
-0.6（host functions）和 0.7（WASM runner）是並列的前置工作，哪個先都可以，但都要在 Phase 1 開始之前完成。
+逐條核實見該卷 `tasks.md` 的「封存時仍未完成的項目」段。

 ---

 ## SDD 索引

+> 「進行中」與否一律以 frontmatter 為準，下表僅路徑速查。
+
 | 子系統 | SDD |
 |--------|-----|
-| **主要（正在動）** Credential Primitives WASM 改寫 | `docs/3-specs/arcrun/credential-primitives-wasm/` |
-| **LI (LLM Interface)** — AI 操盤手使用體驗（2026-05-16 新建，mira dogfood 痛點轉化） | `docs/3-specs/llm-interface/` |
-| arcrun 總進度 | `docs/3-specs/arcrun/arcrun.md` |
-| Auth Recipe 系統（schema、預建 20 個服務） | `docs/3-specs/arcrun/auth-recipe.md` |
-| Landing Page | `docs/3-specs/arcrun/landing-page.md` |
-| SDK + Website | `docs/3-specs/arcrun/sdk-and-website/design.md` |
-| arcrun MVP 整體 | `docs/3-specs/arcrun-core-mvp/design.md` |
-| Credential 長期規格（需求源） | `docs/user_requirements/credential_parts.md` |
-| Platform Evolution | `docs/3-specs/arcrun-platform-evolution/design.md` |
-| Tech Stack 詳細 | `docs/3-specs/tech.md` |
+| **現行 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 常搞錯的點）

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