Enum GuardRootState 

pub enum GuardRootState {
    Indexing,
    Current,
    Dirty,
    Blocked,
    Degraded,
    StalePolicy,
    Stopped,
}

The explicit state of one registered guard root.

Adding a variant here MUST be accompanied by:

1. A transition decision in GuardRootState::transition.
2. An exit-code mapping in the CLI exit module.
3. A status/documentation table entry.

The state-matrix test fails until all three are recorded.

Variants

Indexing

Initial reconciliation or requested full repair is running.

Current

Baseline completed, all accepted events through the receipt sequence were processed, policy identity matches, and no unresolved finding exists. Background state alone is still insufficient to authorize a commit; an exact staged transaction is required.

Dirty

Accepted filesystem events are queued or scanning.

Blocked

At least one current file or staged blob produced an unsuppressed finding.

Degraded

Event loss, source gap, unreadable input, queue overflow, root replacement, mount discontinuity, or persistence failure prevents complete coverage.

StalePolicy

Binary, detector, suppression, preprocessing, schema, or resolved configuration identity differs from persisted attestations.

Stopped

Root is registered but not actively watched.

Implementations

impl GuardRootState

pub fn may_authorize_commit(self) -> bool

Whether this state permits a commit authorization.

This is always false for background states. The exact staged transaction is the only local commit authorization input.

pub fn needs_repair(self) -> bool

Whether this state indicates the root needs explicit repair action.

pub fn all() -> &'static [GuardRootState]

All variants in declaration order, for exhaustive test derivation.

pub fn label(self) -> &'static str

Stable string label for status output and documentation.

impl GuardRootState

pub fn transition( self, event: &GuardTransition, ) -> Result<GuardRootState, TransitionError>

Apply one transition event, returning the new state or an error.

This is the SINGLE owner of the transition function. Every legal transition is enumerated here; anything not listed is rejected. Adding a state or event without updating this function and its tests is a compile-time or test-time failure.

Trait Implementations

impl Clone for GuardRootState

fn clone(&self) -> GuardRootState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for GuardRootState

impl Debug for GuardRootState

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for GuardRootState

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for GuardRootState

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

Formats the value using the given formatter.

impl Eq for GuardRootState

impl Hash for GuardRootState

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 PartialEq for GuardRootState

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for GuardRootState

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for GuardRootState