Enum SagaTerminal 

pub enum SagaTerminal<'a> {
    Completed,
    Compensated {
        reason: &'a str,
    },
    Failed {
        reason: &'a str,
    },
}

Outcome a saga’s inner future hands back to emit_terminal.

(codex P1 PR #631) The original PR 1 implementation mapped every Err to SagaOutcome::Compensated, which is wrong for timeout/ abort paths: run_saga wraps the inner future in tokio::time::timeout, and a timeout cancels the future before it can run its compensation block. Recording “compensated” when nothing was compensated would hide partially-applied state from PR 2’s compensate_unresolved resume scan — exactly the failure mode this log exists to catch.

Compensated should only be recorded when compensation actually completed; everything else (timeout, panic-converted-to-error, pre-compensation early-return) records Failed, which leaves the saga visible to PR 2’s resume scan.

Variants

Completed

All steps applied successfully.

Compensated

Compensation block ran to completion. Caller asserts this only after every compensating dispatch returned without error.

Fields

reason: &'a str

Failed

Saga aborted before/during compensation: timeout, panic, pre-compensation early-return, or any other path where compensation can’t be assumed to have run. Default for the “I don’t know if compensation completed” case.

Fields

reason: &'a str

Trait Implementations

impl<'a> Debug for SagaTerminal<'a>

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

Formats the value using the given formatter.