Enum StageOutcome 

pub enum StageOutcome {
    Continue,
    Complete,
    NeedMoreData {
        additional_beam: usize,
        go_deeper: bool,
    },
    Backtrack {
        target_stage: String,
        reason: String,
    },
    Skip {
        reason: String,
    },
}

Result of a stage execution, controlling pipeline flow.

Variants

Continue

Stage completed successfully, continue to next stage.

Complete

Entire retrieval is complete, return results.

NeedMoreData

Need more data, go back to Search stage for another iteration.

This enables incremental retrieval where the Evaluate stage can request additional search rounds if current results are insufficient.

Fields

additional_beam: usize

Additional beam width to add for next search iteration.

go_deeper: bool

Whether to search deeper in the tree.

Backtrack

Backtrack to a specific stage for re-planning.

Used when current strategy isn’t working and a different approach is needed.

Fields

target_stage: String

Target stage name to backtrack to.

reason: String

Reason for backtracking.

Skip

Skip remaining stages and return current results.

Used when results are “good enough” or when further processing wouldn’t improve the outcome.

Fields

reason: String

Reason for skipping.

Implementations

impl StageOutcome

pub fn cont() -> Self

Create a Continue outcome.

pub fn complete() -> Self

Create a Complete outcome.

pub fn need_more(additional_beam: usize, go_deeper: bool) -> Self

Create a NeedMoreData outcome.

pub fn backtrack(target: impl Into<String>, reason: impl Into<String>) -> Self

Create a Backtrack outcome.

pub fn skip(reason: impl Into<String>) -> Self

Create a Skip outcome.

pub fn is_complete(&self) -> bool

Check if this outcome indicates pipeline completion.

pub fn needs_backtrack(&self) -> bool

Check if this outcome requires backtracking.

pub fn backtrack_target(&self) -> Option<&str>

Get the target stage for backtracking, if any.

Trait Implementations

impl Clone for StageOutcome

fn clone(&self) -> StageOutcome

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StageOutcome

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

Formats the value using the given formatter.

impl Default for StageOutcome

fn default() -> Self

Returns the “default value” for a type.