Project Status

What each project status means and what triggers transitions.

Project Status

A project's status reflects its current activity. The dashboard shows it as a badge on the project card and in the detail view.

Statuses

StatusMeaning
PendingJust created. Needs source folders, destination, and a scan before migrating.
ScanningA scan is running on the agent.
RunningA migration is running on the agent.
CompletedLast migration finished successfully (may include per-file errors).
FailedLast migration failed before completing. See error details.
CancelledLast scan or migration was cancelled by the user.

Transitions

Status is derived from the most recent scan or migration. Starting a new scan moves the project to Scanning; starting a new migration moves it to Running.

Completing a migration sets the project to Completed even if some individual files failed. The file-level errors are surfaced in the migration view, but they don't block the project from being considered "done."

Multiple runs

You can run multiple migrations on the same project — for example, after fixing errors or after adding new source files. Each run gets its own record and errors; older runs stay accessible.

The project status always reflects the latest run.

Cancelling

Hitting Cancel on a running scan or migration sets the project to Cancelled once the agent acknowledges the stop. Cancellation is graceful — in-flight uploads finish, no new ones start.