How kartiksood10/acme-migration-worker works
ACME accepts a consumer repository and Source/Target OpenAPI contracts, then analyzes contract changes, plans endpoint-level migrations, edits the consumer in an isolated sandbox, validates and repairs changes, and submits pull requests for review. The graph preserves the documented three-graph workflow and contract ingestion, schema lookup, validation, and delivery capabilities. Some orchestration details are documented rather than shown in full source excerpts; those links use README evidence, and uncertain internal calls are omitted.
Main entry points: sandbox_manager.py Docker Sandbox · planning_graph.py Planning Graph · orchestrator_graph.py Orchestrator Graph · coder_graph.py Coder Graph
Components 20
Job API
- Migration API
api/main.py - Contract Inputs
pipeline/schemas.py
Contract Planning
- Planning Graph
pipeline/planning_graph.py - Contract Resolver
pipeline/contract_resolver.py - Breaking-Change Diff
pipeline/diff_engine.py - Migration Context
pipeline/context_builder.py - Plan Generator
pipeline/planner.py
Migration Execution
- Orchestrator Graph
agent/orchestrator_graph.py - Workflow State
agent/graph_state.py - Coder Graph
agent/coder_graph.py - Repository Tools
agent/tools.py
Sandbox Delivery
- Docker Sandbox
utils/sandbox_manager.py - Contract Validator
utils/validator.py
Other components
- Submitter
- Completion Webhook
- oasdiff CLI
- LLM Service
- Maven Build
- GitHub
- Contract URL
Connections 23
- Submitter → Migration API: submits job
README.md - Migration API → Contract Inputs: accepts contracts
api/main.py - Migration API → Planning Graph: starts planning
api/main.py - Planning Graph → Contract Resolver: resolves contracts
pipeline/planning_graph.py - Planning Graph → Breaking-Change Diff: computes diffs
pipeline/planning_graph.py - Breaking-Change Diff → oasdiff CLI: runs
pipeline/diff_engine.py - Planning Graph → Migration Context: builds context
pipeline/planning_graph.py - Planning Graph → Plan Generator: generates plan
pipeline/planning_graph.py - Contract Resolver → Contract Inputs: uses reference model
pipeline/contract_resolver.py - Contract Resolver → Contract URL: fetches URL
pipeline/contract_resolver.py - Migration API → Orchestrator Graph: runs migration
api/main.py - Orchestrator Graph → Coder Graph: dispatches work
README.md - Orchestrator Graph → Workflow State: uses state
agent/orchestrator_graph.py - Orchestrator Graph → Docker Sandbox: coordinates sandbox
agent/orchestrator_graph.py - Orchestrator Graph → Completion Webhook: posts results
- Coder Graph → Repository Tools: invokes tools
agent/coder_graph.py - Coder Graph → LLM Service: requests code reasoning
agent/coder_graph.py - Coder Graph → Docker Sandbox: runs Maven tests
agent/coder_graph.py - Coder Graph → Contract Validator: checks contract
agent/coder_graph.py - Repository Tools → Docker Sandbox: inspects and edits
agent/tools.py - Contract Validator → Docker Sandbox: checks source files
utils/validator.py - Docker Sandbox → Maven Build: executes tests
README.md - Docker Sandbox → GitHub: pushes and opens PR
utils/sandbox_manager.py