Enum InstallStatus 

#[non_exhaustive]
pub enum InstallStatus {
    Absent,
    InstalledOwned {
        owner: String,
    },
    InstalledOtherOwner {
        owner: String,
    },
    PresentUnowned,
    LedgerOnly {
        owner: String,
    },
    Drifted {
        issues: Vec<DriftIssue>,
    },
    Unknown,
}

High-level installation state.

Each variant maps to a single concrete combination of (harness-config presence, agent-config ledger ownership). Callers can match on this directly to choose between install, repair, or skip.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Absent

Not present in either the harness config or the ownership ledger.

InstalledOwned

Recorded under the caller’s owner tag and present in the harness config.

Fields

owner: String

Owner tag recorded in the ledger. Equals the caller’s expected owner.

InstalledOtherOwner

Recorded under a different owner. The caller cannot uninstall this without forcing a steal; new installs must use a different name.

Fields

owner: String

Owner tag recorded in the ledger.

PresentUnowned

Present in the harness config but no ledger entry claims it. Likely hand-installed by the user or installed by a tool that does not participate in the agent-config ownership protocol.

LedgerOnly

Recorded in the ledger but missing from the harness config. The most common cause is that the user (or another tool) deleted the entry directly without going through uninstall.

Fields

owner: String

Owner tag recorded in the ledger.

Drifted

On-disk state is structurally inconsistent in a way that does not fit the other variants — duplicate entries, an unparseable config, an incomplete skill directory, etc. Callers should typically treat this as “needs manual repair before install”.

Fields

issues: Vec<DriftIssue>

One or more concrete drift reasons.

Unknown

State could not be determined (e.g., a probe encountered a soft I/O failure). Reserved for non-fatal cases. Hard errors propagate as AgentConfigError instead.

Trait Implementations

impl Clone for InstallStatus

fn clone(&self) -> InstallStatus

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for InstallStatus

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

Formats the value using the given formatter.

impl PartialEq for InstallStatus

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

impl StructuralPartialEq for InstallStatus