Enum GraphAcquisitionError 

pub enum GraphAcquisitionError {
    InvalidPath {
        path: PathBuf,
        reason: String,
    },
    NoGraph {
        workspace_root: PathBuf,
    },
    LoadFailed {
        source_root: PathBuf,
        reason: String,
    },
    IncompatibleGraph {
        source_root: PathBuf,
        status: PluginSelectionStatus,
    },
    NotReady {
        workspace_root: PathBuf,
        lifecycle: String,
    },
    Evicted {
        workspace_root: PathBuf,
        original_lifecycle: String,
        reload_failure: Option<String>,
    },
    StaleExpired {
        workspace_root: PathBuf,
        age_hours: Option<f64>,
    },
    BuildFailed {
        workspace_root: PathBuf,
        reason: String,
    },
    Internal {
        reason: String,
    },
}

Acquisition failure taxonomy.

Each variant maps to a distinct user-facing diagnostic class. Adapters must preserve the variant — collapsing into a generic internal error violates the contract.

Variants

InvalidPath

Path canonicalization failed, the path does not exist where required, it is not under an allowed source root, or it escaped through a symlink. Path validation runs before any graph load.

Fields

path: PathBuf

The path that failed validation.

reason: String

Why validation failed.

NoGraph

No graph artifact exists for this workspace and the policy disallows auto-build.

Fields

workspace_root: PathBuf

Workspace root that has no graph.

LoadFailed

Snapshot, manifest, or analysis load failed.

Fields

source_root: PathBuf

The source root the load was attempted for.

reason: String

Failure detail (I/O error, integrity check, format mismatch).

IncompatibleGraph

Snapshot or manifest cannot be used safely by this binary (unknown plugin ids, unsupported snapshot format).

Fields

source_root: PathBuf

Source root the snapshot was built for.

status: PluginSelectionStatus

Specific compatibility verdict.

NotReady

Daemon workspace is Unloaded or Loading and read-only reload is not applicable.

Fields

workspace_root: PathBuf

Workspace root.

lifecycle: String

Daemon lifecycle label.

Evicted

Daemon workspace was evicted and either reload was not allowed (e.g. MutatingRebuild) or the bounded one-shot reload itself failed.

Fields

workspace_root: PathBuf

Workspace root.

original_lifecycle: String

Daemon lifecycle label at the time of eviction.

reload_failure: Option<String>

Reason the bounded reload failed, when a reload was attempted. None means reload was not attempted (e.g. MutatingRebuild).

StaleExpired

Stale graph age exceeded the configured stale-serve window.

Fields

workspace_root: PathBuf

Workspace root.

age_hours: Option<f64>

Age of the stale graph in hours, when known.

BuildFailed

An approved load/build path failed mid-way (auto-build, daemon reload).

Fields

workspace_root: PathBuf

Workspace root.

reason: String

Build failure detail.

Internal

Invariant violation, join failure, or other condition that does not fit the typed taxonomy. Adapters must not collapse path/eviction/ stale/incompatible failures into this variant.

Fields

reason: String

Internal failure detail.

Trait Implementations

impl Debug for GraphAcquisitionError

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

Formats the value using the given formatter.

impl Display for GraphAcquisitionError

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

Formats the value using the given formatter.

impl Error for GraphAcquisitionError

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.