Leo
c2a2f82ade
設計動機：3 天 mira dogfood 累積 14 個痛點，7 個純粹是 LI 缺失。
arcrun 過去設計集中在「人」（u6u-gui / docs），AI 對 arcrun 的可用性
沒被當第一公民。
SDD 三件套（matrix/arcrun/.agents/specs/llm-interface/）：
requirements.md
- personas（Claude Code 主力 / 用戶私人 agent / SDK 使用者）
- 範圍涵蓋 5 系統（cypher-executor / registry / u6u-mcp / u6u-gui / kbdb）
- 10 個 FR：onboarding / CRUD 對等 / dry-run / 結構化 trace /
可程式化 error / feedback tool / implicit telemetry /
skill blocks / examples / weekly closed loop
- 5 個 NFR：相容 / 多 transport / error contract 穩定 /
feedback exportable / coverage 量化
design.md
- 5 層 LI 模型：AGENTS.md / arcrun-mcp / Skills / Examples / Telemetry
- 25 個 MCP tool 完整清單分 5 類
- error_code enum v1
- coverage matrix（GUI 動作 vs MCP / 31 cypher-executor 路由 vs LI）
- 完整 AGENTS.md 模板
- u6u-mcp → arcrun-mcp migration plan（90 天 deprecation）
- weekly_review workflow YAML 範本
tasks.md
- 5 個 milestone（M1 收 data / M2 gap-fill / M3 skill+examples /
M4 closed loop / M5 rename）
- 估算 23 個工作日 (~5 週)
- M1 是硬前置（不收 data 改了也不知道對沒）
Audit 基準（用 4 個並行 Explore agent 整理）：
- cypher-executor: 31 HTTP 路由，9 個 AI-essential
- u6u-mcp: 15 tool，缺 update/delete/history/validate/feedback
- u6u-gui: 8 個人類動作可對等 LI / 3 個視覺類不需
- kbdb: 50 路由 13 group，LI 走 abstracted tool 不直接 expose
同步更新 .claude/rules/04-current-progress.md SDD 索引。
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
78 lines
3.9 KiB
Markdown
78 lines
3.9 KiB
Markdown
# 當前進度（SessionStart 會注入此檔重點）
|
||
|
||
> 更新時間：2026-04-19
|
||
> 權威來源：`.agents/specs/arcrun/credential-primitives-wasm/tasks.md`
|
||
> 此檔僅摘要，詳細狀態以 tasks.md 為準。
|
||
|
||
---
|
||
|
||
## 封測狀態
|
||
|
||
**原定明天封測，richblack 決定推遲**，原因：cypher-executor 有三套 TS 業務邏輯違反「零件一律 WASM」架構原則（Phase 1-3 要清除的程式碼），在清除前不封測。
|
||
|
||
---
|
||
|
||
## 目前 Phase：Credential Primitives TS → WASM
|
||
|
||
**SDD 位置**：`.agents/specs/arcrun/credential-primitives-wasm/design.md` + `tasks.md`
|
||
|
||
### 已完成
|
||
|
||
- **Phase 0.1–0.5**：核心合併（u6u-core 併入 arcrun、21 個零件 contract 完整、刪除重複 `credentials/` 目錄、CREDENTIALS_KV binding 確認、刪除 `matrix/u6u-core/`）
|
||
- `registry/components/` 下 21 個零件（邏輯 + API）都有 `main.go` + `.wasm`
|
||
|
||
### 進行中 / 未完成
|
||
|
||
| 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） | ⬜ 未開始 | 封測啟動門檻 |
|
||
|
||
### 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 第一件要做的事
|
||
|
||
**讀 `.agents/specs/arcrun/credential-primitives-wasm/tasks.md`**，然後決定從 Phase 0.6 還是 0.7 開始。
|
||
|
||
0.6（host functions）和 0.7（WASM runner）是並列的前置工作，哪個先都可以，但都要在 Phase 1 開始之前完成。
|
||
|
||
---
|
||
|
||
## SDD 索引
|
||
|
||
| 子系統 | SDD |
|
||
|--------|-----|
|
||
| **主要（正在動）** Credential Primitives WASM 改寫 | `.agents/specs/arcrun/credential-primitives-wasm/` |
|
||
| **LI (LLM Interface)** — AI 操盤手使用體驗（2026-05-16 新建，mira dogfood 痛點轉化） | `.agents/specs/llm-interface/` |
|
||
| arcrun 總進度 | `.agents/specs/arcrun/arcrun.md` |
|
||
| Auth Recipe 系統（schema、預建 20 個服務） | `.agents/specs/arcrun/auth-recipe.md` |
|
||
| Landing Page | `.agents/specs/arcrun/landing-page.md` |
|
||
| SDK + Website | `.agents/specs/arcrun/sdk-and-website/design.md` |
|
||
| arcrun MVP 整體 | `.agents/specs/u6u-core-mvp/design.md` |
|
||
| Credential 長期規格（需求源） | `docs/user_requirements/credential_parts.md` |
|
||
| u6u Platform Evolution | `.agents/specs/u6u-platform-evolution/design.md` |
|
||
| Tech Stack 詳細 | `.agents/steerings/tech.md` |
|
||
|
||
---
|
||
|
||
## 技術備註（CC 常搞錯的點）
|
||
|
||
1. **每個 WASM 零件 = 獨立 Worker = 公開 URL**（例：`gmail.arcrun.dev`）。不是從 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`。
|