Struct MigrationController 

pub struct MigrationController { /* private fields */ }

Manages the state machine for a single migration.

It owns lifecycle transitions, progress, skips, and diagnostics but not model routing. See docs/migration.md for its transition and accounting rules.

Implementations

impl MigrationController

pub fn new(plan: MigrationPlan) -> Self

Create a new migration controller from a plan.

pub fn start(&mut self) -> Result<(), MigrationError>

Start the migration (Planned -> InProgress).

pub fn record_progress( &mut self, newly_processed: usize, ) -> Result<(), MigrationError>

Record that newly_processed embeddings were completed.

pub fn record_error(&mut self)

Record a non-fatal error during processing.

pub fn record_skip(&mut self, reason: SkipReason) -> Result<(), MigrationError>

Record an item that will be permanently skipped.

Skips reduce the effective completion total but require a later progress call to transition to completed. See docs/migration.md.

pub fn skip_reasons(&self) -> &[SkipReason]

Returns the list of reasons why entries were skipped during migration.

pub fn effective_coverage(&self) -> f64

Returns processed-to-effective-total coverage; a zero effective total returns 1.0.

pub fn pause(&mut self, reason: impl Into<String>) -> Result<(), MigrationError>

Pause the migration (InProgress -> Paused).

pub fn resume(&mut self) -> Result<(), MigrationError>

Resume the migration (Paused/Failed -> InProgress).

pub fn fail(&mut self, error: impl Into<String>) -> Result<(), MigrationError>

Fail the migration (InProgress -> Failed).

pub fn cancel(&mut self) -> Result<(), MigrationError>

Cancel the migration (any non-terminal state -> Cancelled).

pub fn progress(&self) -> MigrationProgress

Get a snapshot of current progress.

pub fn state(&self) -> &MigrationState

Returns the current migration state.

pub fn plan(&self) -> &MigrationPlan

Returns the migration plan.

Trait Implementations

impl Debug for MigrationController

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.