Struct Observed 

pub struct Observed {

    pub target: Utf8PathBuf,
    pub flake: Presence,
    pub lock: Presence,
    pub scan: Scan,
    pub flake_text: Option<String>,
    pub locked_rev: Option<String>,
    pub locked_ref: Option<String>,
    pub managers: Vec<Entry>,
    pub wired: Option<Manager>,
    pub envrc: Presence,
    pub envrc_sync: bool,
    pub pending: bool,
    pub stamp: Option<String>,
    pub leftovers: Vec<Leftover>,
}

Everything the offline pass reads from a target and this host’s state root. It spawns nothing and fetches nothing.

Fields

target: Utf8PathBuf

The target, canonical.

flake: Presence

Whether flake.nix exists.

lock: Presence

Whether flake.lock exists.

scan: Scan

What the pin matcher found in flake.nix.

flake_text: Option<String>

The flake.nix text, where the file read.

locked_rev: Option<String>

The locked commit of the release-kit node, where the lock names one.

locked_ref: Option<String>

The locked ref of the release-kit node, where the lock names one.

managers: Vec<Entry>

One entry per manager, in the closed order, absent ones included.

wired: Option<Manager>

The one manager whose file names release-kit, where exactly one does.

envrc: Presence

Whether .envrc exists. Direnv is not a manager: it loads a shell and pins nothing, so the file is reported outside the list.

envrc_sync: bool

Whether .envrc carries the sync line.

pending: bool

Whether a transaction marker for this checkout survives.

stamp: Option<String>

The day of the last sync attempt for this checkout, where stamped.

leftovers: Vec<Leftover>

What a predecessor bump mechanism left in the target.

Implementations

impl Observed

pub fn key(&self) -> String

The per-checkout state key.

pub const fn pin_tag(&self) -> Option<&str>

The pinned tag, where the scan found exactly one pin.

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

The rollup state, first match wins. It describes and never judges: every state exits 0, and the verbs that act read the entries rather than this word.

pub fn flake_entry(&self) -> Option<&Entry>

The flake manager’s entry: always present in the list.

pub fn entry(&self, manager: Manager) -> Option<&Entry>

One manager’s entry: every manager in the enum has one.

Trait Implementations

impl Clone for Observed

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 Observed

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

Formats the value using the given formatter.