Repository navigation
ForgeFlow v2.0.0
ForgeFlow v2.0.0
ForgeFlow v2 is a breaking rebuild of the project around one principle: ForgeFlow governs software-engineering quality; Open SWE owns autonomous execution.
Highlights
- Replaced the legacy Node/SQLite autonomous control plane with a small Python 3.14 policy graph running beside pinned Open SWE in LangGraph.
- Added evidence-owned completion: an agent run reporting
successcannot advance work without authoritative PR/head evidence. - Added exact-head CI and Official Open SWE Reviewer gates before
READY. - Added bounded P0/P1/P2 repair loops that reuse the implementation thread and require provenance on repair commits.
- Added a self-hosted Docker execution plane for Open SWE on GCP Dev with non-root execution, read-only rootfs, explicit
noexectmpfs mounts, AppArmor/seccomp/no-new-privileges, resource limits, private-network/metadata blocking, and provider-owned GC. - Added least-privilege GitHub App credentials: reviewer/dependency access is read-only; implementation write access is scoped to the primary repository.
- Added persistent sandbox workspace/cache/artifact support, Python 3.14 +
uvprovisioning, safe reconnect/replacement after GC, and workflow-push handling for non-default base branches. - Removed OpenHands/Antigravity/legacy TypeScript execution ownership from the current runtime. Remaining OpenHands references are migration history, purge guards, or regression tests only.
- Reworked README and
docs/to describe the implemented v2 architecture rather than the retired runtime or an aspirational design.
Acceptance evidence
The v2 policy path was exercised end-to-end on a real GitHub PR. A controlled regression removed the Docker read-only-rootfs boundary while deterministic CI still passed; the Official Reviewer raised a blocking high-severity finding, ForgeFlow entered REPAIRING, Luna xhigh repaired the issue on the same implementation thread, exact-head CI passed, the Official Reviewer resolved the finding on re-review, and the policy returned to READY with repair_round=1.
Additional real-project validation on Digital Biome exercised Open SWE implementation/reviewer sandboxes, private submodule hydration, exact-head CI, review findings, repair, and re-review.
Breaking changes
- The v1 autonomous runtime, SQLite workflow state, legacy API/client compatibility surface, OpenHands execution plane, and old systemd topology are not migrated.
- Git/GitHub/Open SWE/LangGraph are the source of truth for v2 work and durable execution state.
- Existing v1 runtime state should not be restored into v2.
Runtime
- Python 3.14
- Open SWE pinned to
0ff86e22a94cc84e32883fcb1beee568560d4140 - LangGraph deployment with
agent,reviewer,analyzer,chat,scheduler, andforgeflowgraphs - Self-hosted Docker sandbox provider on GCP Dev
See README.md and docs/README.md for the current architecture and operational documentation.