Enum StalenessReason 

pub enum StalenessReason {
    MissingDependency {
        name: String,
        resource_type: ResourceType,
    },
    VersionChanged {
        name: String,
        resource_type: ResourceType,
        old_version: String,
        new_version: String,
    },
    PathChanged {
        name: String,
        resource_type: ResourceType,
        old_path: String,
        new_path: String,
    },
    SourceUrlChanged {
        name: String,
        old_url: String,
        new_url: String,
    },
    DuplicateEntries {
        name: String,
        resource_type: ResourceType,
        count: usize,
    },
    ToolChanged {
        name: String,
        resource_type: ResourceType,
        old_tool: String,
        new_tool: String,
    },
}

Reasons why a lockfile might be considered stale.

This enum describes various conditions that indicate a lockfile is out-of-sync with the manifest and needs to be regenerated to prevent installation errors or inconsistencies.

Display Format

Each variant implements Display to provide user-friendly error messages that explain the problem and suggest solutions.

Examples

use agpm_cli::lockfile::StalenessReason;
use agpm_cli::core::ResourceType;

let reason = StalenessReason::MissingDependency {
    name: "my-agent".to_string(),
    resource_type: ResourceType::Agent,
};

println!("{}", reason);
// Output: "Dependency 'my-agent' (agent) is in manifest but missing from lockfile"

Variants

MissingDependency

A dependency is in the manifest but not in the lockfile. This indicates the lockfile is incomplete and needs regeneration.

Fields

name: String

Name of the missing dependency

resource_type: ResourceType

Type of resource (agent, snippet, etc.)

VersionChanged

A dependency’s version constraint has changed in the manifest.

Fields

name: String

Name of the dependency

resource_type: ResourceType

Type of resource (agent, snippet, etc.)

old_version: String

Previous version from lockfile

new_version: String

New version from manifest

PathChanged

A dependency’s path has changed in the manifest.

Fields

name: String

Name of the dependency

resource_type: ResourceType

Type of resource (agent, snippet, etc.)

old_path: String

Previous path from lockfile

new_path: String

New path from manifest

SourceUrlChanged

A source repository has a different URL in the manifest. This is a security concern as it could point to a different repository.

Fields

name: String

Name of the source repository

old_url: String

Previous URL from lockfile

new_url: String

New URL from manifest

DuplicateEntries

Multiple entries exist for the same dependency (lockfile corruption).

Fields

name: String

Name of the duplicated dependency

resource_type: ResourceType

Type of resource (agent, snippet, etc.)

count: usize

Number of duplicate entries found

ToolChanged

A dependency’s tool field has changed in the manifest.

Fields

name: String

Name of the dependency

resource_type: ResourceType

Type of resource (agent, snippet, etc.)

old_tool: String

Previous tool from lockfile

new_tool: String

New tool from manifest (with defaults applied)

Trait Implementations

impl Clone for StalenessReason

fn clone(&self) -> StalenessReason

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StalenessReason

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

Formats the value using the given formatter.

impl Display for StalenessReason

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

Formats the value using the given formatter.

impl Error for StalenessReason

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl PartialEq for StalenessReason

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

impl StructuralPartialEq for StalenessReason