- engine (
src/engine.ts): project and branch lifecycle, from provision through clone (pg_dump→ restore,rclone sync, app redeploys) to teardown with compensation on failure. - govern (
src/govern.ts): the policy engine — 12 gated actions, allow/deny/approve per project, one-shot grants, HTTP 202 approval flow. - adapters (
src/adapters/):LocalPostgres(a container per branch),LocalGarage(one shared S3 server; a bucket + bucket-scoped key per branch),DockerCompute(your image per compute group),LocalManagedDb(private Redis/MySQL/MongoDB per branch).RailwayCompute(INSTA_OSS_COMPUTE=railway) runs compute on Railway instead. - state (
src/state.ts): a single JSON file,~/.insta-oss/state.json.
Reference
Architecture
CLI/MCP/dashboard → HTTP server → engine → adapter → Docker.