Imports the previously untracked working tree as-is so that the review changes that follow (requirements -> design -> implementation) can be reviewed as diffs and reverted if needed. No content changes. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
WishForge
远程许愿 → 隔离 Agent 实现 → 独立验证 → 不可变产物 → 审批与自动部署。
TypeScript 单仓库,包含 Next.js 管理台、NestJS 控制面、PostgreSQL/RLS、Temporal 工作流、Theia 云 IDE、MCP 连接器、Codex/CodeBuddy 适配器、私有 Git/S3 检查点、签名 Runner 和受控 RSI 评估。
当前是可运行的开发版本。 本地控制面、持久化、IDE、Git、对象存储和发布适配器分别有验证证据;这不代表真实模型、客户 Kubernetes/Kata、生产密钥系统或商业 SLO 已通过验收。未配置的能力会返回明确的等待/未配置状态,不能以 Agent 文本宣布交付成功。
本次实现范围、实际测试与未完成条件见 实施与验收记录。
本地启动
需要 Node.js 22+、npm、Git 和 Docker Compose。Theia 独立安装与构建,避免主工作区安装时隐式下载完整 IDE。
npm ci --ignore-scripts
npm run setup:local
docker compose -f infra/compose.yaml up -d
npm run db:migrate
npm run db:seed
npm run dev:all
使用 Colima 时,为 Docker 命令增加 --context colima,不用改变全局 Docker context。
- 管理台:http://localhost:3000
- 控制 API:http://127.0.0.1:4000/health
- Temporal:http://127.0.0.1:8233
- 本地 Git:
127.0.0.1:4504,所有仓库请求需要短期仓库凭据。
setup:local 生成仅本地使用的随机凭据,文件权限为 0600,已有配置不被重置。管理台不获得数据库、验证器、部署器或签名私钥。开发模式无需把 Bearer Token 粘贴到浏览器;生产必须配置 OIDC,不能启用开发令牌。
管理台可以创建项目、连接租户自己的模型凭据、定义保护性验证命令和部署目标、提交/暂停/继续愿望、查看代码与证据、审批具体发布、登记 Runner、查询用量,以及提交内容寻址的 RSI 候选。新项目自动使用平台 Git 存储;已有 HTTPS 仓库可以导入(SSH/SCP 接入未启用)。外部私有仓库还需要其授权接入。
执行与部署
生产任务由显式配置的 Kubernetes/Kata provisioner 启动,每个 run 和 generation 使用独立执行器/验证器工作区和短期身份。验证器从内容校验过的 Git bundle 恢复,不能直接读取仍在运行的 Builder 工作目录。缺少沙箱配置时,任务等待 sandbox_provisioner,不会在控制 API 宿主机执行租户代码。
配置步骤与环境变量见 运行手册、worker、Runner/Kubernetes 和 私有产物存储。
- Codex 使用官方 SDK;生产通过模型凭据代理隔离长期 BYOK,短期令牌绑定任务、代次和租约。CodeBuddy 开发执行器独立配置,生产执行在其凭据隔离协议完成验证前关闭。
- WorkBuddy 与 Codex 的 MCP 入口见 connectors。WorkBuddy Cloud 的编码能力维持关闭,直到真实账号完成导出、取消和恢复契约验证。
- 生产独立验收配置由平台安装并固定脚本摘要,仓库测试只作补充;缺少配置时拒绝以仓库自身测试宣布验证通过。
- wishforge.yaml从精确 Git SHA 读取;测试只能追加,构建/健康配置须匹配控制面,资源请求不能扩大配额。
- Release 绑定需求版本、Git SHA、镜像 digest、架构、配置、密钥引用和证据。生产高风险审批只能由交互用户确认。
- Compose/Kubernetes 适配器进行候选验证与蓝绿切流;Runner 校验 Ed25519 签名、环境身份、过期和重放,未知结果先对账。
- 生产 S3 必须使用 HTTPS 与 SSE-KMS。部署密钥通过独立 Vault KV v2 broker 解析固定版本,绑定发布策略摘要;缺少配置时拒绝发布,不会忽略引用。
- GitHub App 适配器提供单仓库权限、PR 创建/对账、精确版本合并授权和最终 SHA 重新验证;使用运营侧明确的安装映射,不读取宿主
gh登录缓存。真实 GitHub 账户联调尚待完成。
云 IDE 与 RSI
完整 Theia 安装、鉴权网关及隔离协作说明见 IDE 和 协作。OCT 房间按 workspace 隔离、经网关检查项目权限;房间状态仍在内存中,重启后需重新创建/加入。保存文件与未确认编辑的恢复能力须按验收表分别核对。
RSI 评估器要求独立 benchmark、执行环境和 Ed25519 签名。候选只能在验证、影子和完整灰度窗口后影响新任务,旧任务继续使用固定 Bundle。客户数据默认不参与平台全局演进,平台代码与信任根升级保留独立发布通道。
元循环支持一次显式 tick:聚合平台自身失败、冻结来源和基线、使用平台专属预算生成候选,再由独立验证器提取。默认不安装定时任务、不运行模型;需要运营者配置系统租户、项目、执行环境和评估语料。
提示词与编排候选按固定 Bundle 评估;工具和平台代码生成绑定精确检查点的源代码提案。平台代码的灰度与回滚必须收到独立发布系统的签名回执,首版晋升仍需维护者确认。npm run rsi:rollout 提供显式晋升检查,配置缺失时不执行。
已实现工作区保存交接、租户 IDE 网关路由、工作区休眠与恢复,以及套餐、资源授权和账单导出。未接入的 CPU/存储时长计量显示为未知,人工结算记录不触发真实扣款。
检查与验收
npm run typecheck
npm test
npm run test:integration
npm run test:ide
npm run test:preview
npm run build
node scripts/smoke-control.mjs
网络/容器集成测试需要本机监听权限。Temporal、MinIO、真实 Compose 和浏览器验收有独立执行开关,见 需求与验收追踪;默认跳过这些测试不等于通过。