uncle6me-web
922a57fe34
Self-hosted 開源：WASM 零件 + recipe + cypher-executor，跑在你自己的 Cloudflare。 此為重建的乾淨歷史起點（移除曾誤 commit 的 GCP SA 金鑰，舊歷史保留在 richblack/arcrun 與本地 backup 分支）。含： - acr init --self-hosted installer（建 KV/R2 + codeload 拉預編譯 wasm + wrangler deploy + seed recipe） - recipe push 把關（資料外流提醒 + 打通檢查） - 19 個正當零件預編譯 wasm（claude_api/km_writer/kbdb_upsert_block 排除：違反 DECISIONS §1） - CLI / cypher-executor / registry / 完整 SDD Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2.8 KiB
2.8 KiB
CLAUDE.md — arcrun
本檔是索引 + 最高原則，詳細規範拆到
.claude/rules/。 Hook 強制機制在.claude/hooks/，違反會直接 block（exit 2）。
絕對鐵律（違反 = 停手）
- 任何 code 變動前必須先讀對應 SDD，在回覆開頭宣告已讀清單與對應 task 編號（格式見
.claude/rules/00-sdd-protocol.md） - 零件只能用 TinyGo 或 AssemblyScript 編譯成 WASM；
registry/components/下禁止 TypeScript - cypher-executor TS 禁止實作 credential / auth / JWT / template 展開業務邏輯；這些全在 WASM 零件
- Cypher binding = YAML 裡的 URL 清單，不是 Cloudflare service binding；零件串接走 HTTP URL
- 每個 WASM 零件 = 獨立 Worker = 公開 URL；不從 R2 動態讀（R2 只 Phase 5 啟用）
- 修改現有程式碼，不是新建資料夾重做
- 每完成一個 task 立刻更新 tasks.md 的
[x]，不批次
工作流程（強制）
開始任一任務，按順序：
- 讀
.agents/specs/arcrun/arcrun.md（總進度） - 讀對應的 SDD
design.md+tasks.md - 在回覆開頭貼出：
📋 已讀 SDD：<清單> 🎯 本次對應 task：<編號> 📐 本次 task 的 SDD 規範摘要：<重點> 🚧 執行範圍：修改/建立/刪除 <檔案> - 動手前把 tasks.md 對應 task 標為
[🔄]，完成後標[x] - 完成後確認：是否需要同步更新 design.md？
找不到對應 SDD → 停手問 richblack，不要自行建立。
詳細規範索引
| 檔案 | 內容 |
|---|---|
.claude/rules/00-sdd-protocol.md |
SDD 讀取協議（強制流程） |
.claude/rules/01-tech-stack.md |
技術棧硬限制（語言/儲存/加解密） |
.claude/rules/02-forbidden.md |
禁止清單（hook 強制執行） |
.claude/rules/03-component-architecture.md |
零件架構（R2 用途 / cypher binding / service binding 邊界） |
.claude/rules/04-current-progress.md |
當前進度 + SDD 索引 |
SDD 位置速查
| 子系統 | 路徑 |
|---|---|
| 進行中 Credential Primitives WASM | .agents/specs/arcrun/credential-primitives-wasm/ |
| arcrun 總進度 | .agents/specs/arcrun/arcrun.md |
| Auth Recipe 系統 | .agents/specs/arcrun/auth-recipe.md |
| Landing Page | .agents/specs/arcrun/landing-page.md |
| SDK + Website | .agents/specs/arcrun/sdk-and-website/ |
| arcrun MVP 整體 | .agents/specs/arcrun-core-mvp/ |
| Platform Evolution | .agents/specs/arcrun-platform-evolution/ |
| Credential 長期規格（需求源） | docs/user_requirements/credential_parts.md |
| Tech Stack 詳細 | .agents/steerings/tech.md |
封測狀態
推遲（richblack 2026-04-19 決定）。先完成 Phase 1-3 清除違規 TS，再啟動封測。