Struct Phase 

pub struct Phase(/* private fields */);

Identifier for a scenario phase. Newtype over u16 carrying the same 1-indexed encoding documented on every other phase-touching site: Phase::BASELINE is the pre-first-Step settle window (u16 0); Phase::step(k) is scenario Step k at 1-indexed u16 k + 1. The newtype catches the bug class where a raw u16 flows between sites that disagree about 0-indexed vs 1-indexed Step encoding, and gives operators readable construction at consumer sites (Phase::BASELINE / Phase::step(2) instead of magic 0u16 / 3u16).

Wire-format identical to a u16 via #[serde(transparent)] — the on-disk sidecar shape is unchanged from the bare-u16 pipeline, and existing JSON / typeshare consumers see the same scalar field. .phase_raw() exposes the inner u16 for paths that hand the value to a serializer or formatter that does not understand the newtype.

Implementations

impl Phase

pub const BASELINE: Self

Pre-first-Step settle window. The framework writes Phase::BASELINE to Ctx::current_step at scenario start (before any Step’s current_step.store advance), so any capture taken before the first Step transition stamps with this value.

pub const fn step(zero_indexed: u16) -> Self

Construct a Phase for the zero_indexed-th scenario Step. The 1-indexed encoding (Step 0 → u16 1, Step 1 → u16 2, …) keeps BASELINE unambiguous at u16 0. Saturates at u16::MAX rather than overflowing — a scenario with > 65k Steps is pathological and the saturating value still distinguishes “well past any real Step” from BASELINE.

pub const fn is_baseline(&self) -> bool

True iff this is Phase::BASELINE (the pre-first-Step settle window).

pub const fn as_u16(self) -> u16

Inner u16. Use this when handing the value to a serializer / formatter / external consumer that does not understand the newtype. Production callers that build a Phase for downstream comparison should prefer Phase::BASELINE / Phase::step(k) over wrapping a raw u16 themselves.

Trait Implementations

impl Clone for Phase

fn clone(&self) -> Phase

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Phase

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

Formats the value using the given formatter.

impl Default for Phase

fn default() -> Phase

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Phase

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Phase

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

"BASELINE" for Phase::BASELINE, "Step[k]" for Phase::step (decoded back via the 1-indexed encoding). Matches the labels PhaseBucket embeds in label so operators see consistent phase identifiers across structured-sidecar reads and ad-hoc format! output.

impl From<Phase> for u16

fn from(value: Phase) -> Self

Converts to this type from the input type.

impl From<u16> for Phase

fn from(value: u16) -> Self

Wrap a raw 1-indexed encoded value as a Phase. Production paths that already have the encoded value (e.g. drained from the host-side mirror of current_step, or read out of a deserialized sidecar) construct the typed wrapper via this conversion without re-deriving the encoding.

impl Hash for Phase

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for Phase

fn cmp(&self, other: &Phase) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Phase

fn eq(&self, other: &Phase) -> 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 PartialOrd for Phase

fn partial_cmp(&self, other: &Phase) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for Phase

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for Phase

impl Eq for Phase

impl StructuralPartialEq for Phase