Enum GraphFreshness 

pub enum GraphFreshness {
    Fresh {
        lifecycle_label: Option<&'static str>,
    },
    Stale {
        last_good_at: Option<String>,
        last_error: Option<String>,
        age_hours: Option<f64>,
    },
    Reloaded {
        original_lifecycle: ReloadOrigin,
        final_lifecycle_label: &'static str,
        reload_attempts: NonZeroU8,
    },
}

Lifecycle state of the graph that was returned.

Adapters render this into transport-specific freshness signals (ResponseMeta::stale_from, _stale_warning, LSP diagnostics).

Variants

Fresh

Graph is current relative to its source. Optional lifecycle_label carries the daemon-side lifecycle name for diagnostics.

Fields

lifecycle_label: Option<&'static str>

Daemon lifecycle label ("Loaded", "Rebuilding", etc.). None for filesystem providers that have no lifecycle concept.

Stale

Graph is older than its source but is being served per stale policy.

Fields

last_good_at: Option<String>

ISO-8601 timestamp of the last successful build, when available.

last_error: Option<String>

Diagnostic for the failure that caused staleness.

age_hours: Option<f64>

Age of the served graph, in hours.

Reloaded

Graph was reloaded after an Unloaded or Evicted lifecycle. This is the bounded one-shot reload path described in the design.

Fields

original_lifecycle: ReloadOrigin

Why the original lifecycle entered an unloaded/evicted state.

final_lifecycle_label: &'static str

Daemon lifecycle label after the successful reload.

reload_attempts: NonZeroU8

Number of reload attempts. The bounded contract caps this at one, so NonZeroU8::new(1) is the only legal value today; the type reserves headroom for future bounded retries while making zero unrepresentable.

Trait Implementations

impl Clone for GraphFreshness

fn clone(&self) -> GraphFreshness

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GraphFreshness

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

Formats the value using the given formatter.

impl PartialEq for GraphFreshness

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