What problem does it solve?
It coordinates a complete, risk-controlled migration and consolidation of a Node.js monorepo into a unified Turborepo/Bun-ready structure, executing each phase in order while validating outcomes and automatically rolling back on failure.
Core Features & Use Cases
- End-to-end migration runner (A→Z): Executes the full sequence of migration phases (0→8) with post-phase verification and phase-by-phase rollback.
- Safety and state management: Uses a migration state file, lock file to prevent concurrent runs, and an append-only journal to track actions and enable resuming.
- Targeted delegation to specialized sub-agents: Delegates Node→Bun audits and post-phase review, and hands off the live cutover to a deployment-focused agent.
Use case: Migrating a live codebase spread across multiple repositories into a single Turborepo under Bun while ensuring build artifacts exist before downtime and validating HTTP endpoints during the live switch.
Quick Start
Run the migration by starting the bootstrap step, then chain all phases automatically by executing the single all mode command in the vps directory.