Since the Git config of an agent workspace is reduced to an allowlist before each checkpoint, every checkpoint read `<workspace>/.git/config`. A merge candidate is a worktree of the integration cache, whose `.git` is a file, so the read failed with ENOTDIR: whenever the target branch moved while a run was working, its integration stopped on an infrastructure wait, and continuing failed the same way. No test merged onto a moved target without a conflict. A GitWorkspace now remembers the worktrees it added from a repository WishForge owns and leaves their config alone; no agent can reach it. A workspace whose `.git` someone else turned into a pointer file is still refused rather than followed. Tests merge onto a target that moved meanwhile, end to end and at the Git contract. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
WishForge
远程、意图驱动的软件交付平台:用一句话提出愿望(目标 + 验收标准),后端编码 Agent 在隔离环境中实现,独立验证器按受保护的命令判定,失败时把失败信息交还 Agent 自修复,通过后合入代码并按需构建、审批与部署。可以从 Web 工作台、WorkBuddy/Codex(MCP)或云 IDE 发起与跟进。
- 需求与范围:docs/requirements.md
- 架构设计:docs/architecture.md
- 本地开发:docs/development.md
- 生产运维:docs/operations.md
- 专题参考:docs/reference/
- 本机 Claude → Gitea POC:运行说明 · 真实交付验收
快速开始
需要 Node.js 22+、npm、Git 与 Docker Compose。
npm ci
npm run setup:local
docker compose -f infra/compose.yaml up -d
npm run db:migrate
npm run db:seed
npm run dev:all
打开 http://localhost:3000,创建项目、配置验证命令、连接 Codex 凭据后即可提交第一个愿望。完整步骤见 docs/development.md。
本地开发使用
host执行模式:Agent 生成的代码与项目测试直接在本机运行,没有隔离。只在可信的项目上使用。
仓库结构
| 目录 | 内容 |
|---|---|
apps/api |
控制面 API(REST /v1、内部接口 /internal、MCP /mcp、模型代理) |
apps/web |
Web 工作台(Next.js,含 OIDC BFF) |
apps/worker |
Temporal worker:coordinator / executor / verifier / deployer |
apps/provisioner |
执行环境与 IDE 工作区的创建(local 与 kubernetes 后端) |
apps/git-service |
平台 Git 服务 |
apps/runner |
目标环境侧的部署 Runner |
apps/ide |
Theia 云 IDE、IDE 网关与协作 |
packages/contracts |
领域类型、输入校验、规范化 JSON |
packages/agent |
Agent 配置与提示词组装 |
packages/runtime |
执行器适配、Git、验证、构建与部署适配 |
packages/github、packages/artifacts |
GitHub App 客户端、对象存储 |
connectors |
Codex 与 WorkBuddy 的 MCP 接入配置 |
infra |
本地 Compose、Keycloak、Kubernetes 基线与镜像构建 |
检查
npm run format:check
npm run typecheck
npm test
需要外部服务的集成测试默认跳过,开启方式见 docs/development.md。
Description
Languages
TypeScript
83.5%
JavaScript
13.5%
CSS
2.6%
Dockerfile
0.3%
PLpgSQL
0.1%