Enum MigrationFailureReason 

pub enum MigrationFailureReason {
    NotReady,
    FactoryNotFound,
    ComputeNotSupported,
    StateFailed(String),
    AlreadyMigrating,
    IdentityTransportFailed(String),
    NotReadyTimeout {
        attempts: u8,
    },
}

Structured reason the migration target rejected (or the orchestrator aborted) a migration. Replaces the free-form reason: String on MigrationMessage::MigrationFailed so the source can dispatch programmatically on the cause — specifically, distinguish “retry this, the target is still booting” (NotReady) from “give up, the target doesn’t know this daemon kind” (FactoryNotFound).

See DAEMON_RUNTIME_READINESS_PLAN.md for the retry-classification table.

Variants

NotReady

Target runtime exists but hasn’t called start() yet — the dispatcher received the migration before the runtime was ready to accept one. Retriable: source should back off

• resend.

FactoryNotFound

Target has no factory registered for the daemon’s origin_hash (supplied in the outer MigrationFailed envelope). Terminal — retrying won’t help; the target is mis-configured (wrong node), the kind is wrong, or the daemon never registered.

ComputeNotSupported

Target doesn’t run a compute runtime at all (a bare Mesh with no DaemonRuntime attached). Terminal — source should pick a different target.

StateFailed(String)

Generic snapshot / restore / state-machine failure. Carries a human-readable detail. Terminal.

AlreadyMigrating

A migration is already in flight for the same origin. Terminal on the duplicate attempt — caller should not retry, and the currently-active migration should be allowed to run to completion.

IdentityTransportFailed(String)

Identity envelope failure: signature didn’t verify, seal open failed, etc. Terminal — tampering or misconfigured target X25519 key; retry won’t fix it.

NotReadyTimeout

Source gave up after exhausting its NotReady retry budget. Terminal on both sides; carries the retry attempt count for operator diagnosis.

Fields

attempts: u8

Number of NotReady retries the source attempted before giving up. ≥ 1 because the first attempt always counts.

Implementations

impl MigrationFailureReason

pub fn is_retriable(&self) -> bool

true iff the source should retry after a short backoff when it sees this reason. Today only NotReady qualifies — the others are terminal.

pub fn code(&self) -> u16

16-bit wire code. Separating the code from the payload lets the dispatcher’s decoder match on the tag cheaply and the payload length on-line with the variant.

Trait Implementations

impl Clone for MigrationFailureReason

fn clone(&self) -> MigrationFailureReason

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MigrationFailureReason

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

Formats the value using the given formatter.

impl Display for MigrationFailureReason

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

Formats the value using the given formatter.

impl Eq for MigrationFailureReason

impl PartialEq for MigrationFailureReason

fn eq(&self, other: &MigrationFailureReason) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for MigrationFailureReason