Enum RecordRunTurnsOutcome 

pub enum RecordRunTurnsOutcome {
    Appended {
        new_total: usize,
    },
    RefusedCeiling,
    UnknownOrTerminal,
    PersistenceFailed(String),
}

Outcome of ServerState::record_run_turns — distinguishes the three reasons a batch can fail to land so the caller maps each to the right runs.record_turns drop reason (ADV-1). Before this enum the function returned a bare usize (the new total, or 0 for “nothing appended”), which collapsed an under-lock CEILING refusal and an unknown/terminal run into the same 0 — the handler then mislabeled a ceiling refusal as run_terminal.

Variants

Appended

The batch was appended; the run’s new total turn count.

Fields

new_total: usize

RefusedCeiling

The batch was refused WHOLE because it would take the run past RECORD_TURNS_RUN_CEILING (a runaway backstop). Maps to dropped: "run_turn_limit".

UnknownOrTerminal

The run id is unknown to this process OR already terminal — nothing was appended. Maps to dropped: "run_terminal" (the benign TOCTOU: the run went terminal between the handler’s pre-check and the append), matching the prior silent-zero semantics.

PersistenceFailed(String)

The batch cannot advance canonical memory/subscribers. Ordinary I/O failures mean the durable append boundary was not acknowledged and an exact retry is safe. A run trace corruption: error instead means the bytes exposed committed middle corruption; the run is quarantined and must not be retried or completed.

Trait Implementations

impl Clone for RecordRunTurnsOutcome

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RecordRunTurnsOutcome

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

Formats the value using the given formatter.

impl Eq for RecordRunTurnsOutcome

impl PartialEq for RecordRunTurnsOutcome

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for RecordRunTurnsOutcome