get_migration_status
Job progress tracking with pipeline state and comparison queue status
Overview
Check how your cloning project is progressing. Returns the full pipeline step state (queued, running, completed, stale, error, interrupted, never_run) with dependency graph, comparison queue progress, recent run history, dependency warnings, and per-step actionable guidance. Use this to track background processing from start to finish and understand what the worker is doing.
How It Works
- Retrieves the cloning job by ID.
- Aggregates page-by-page comparison queue progress (pending, comparing, compared, error counts).
- Returns each pipeline step's status, dependency graph, run number, duration, error category, and actionable guidance.
- Includes recent pipeline run history and any dependency or queue warnings.
Input Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
job_id |
string |
required | Cloning job ID from discover_all_pages |
What You Get Back
- Job status and comparison queue progress (pending, comparing, compared, error counts)
- Pipeline step statuses: queued, running, completed, stale, error, interrupted, never_run
- Dependency graph per step (depends_on)
- Per-step actionable guidance based on error category
- Recent pipeline run history (last 10 runs)
- Dependency warnings — steps queued before their prerequisites complete
- Queue warnings — stuck pages or other anomalies
Example Use Case
After run_full_comparison returns, call get_migration_status periodically to track when the background worker finishes processing pages and all pipeline steps (shared elements, nav, design systems, media extraction) complete.
Tips
Use the job_id returned by discover_all_pages.
Poll this tool during run_full_comparison to monitor background progress.
Steps with error_category: 'transient' or 'process_restart' auto-retry — no action needed.
Steps with error_category: 'permanent' need manual intervention — check actionable_guidance for details.