Enum CacheRejection 

pub enum CacheRejection {
    Absent,
    Unreadable,
    Oversize {
        size_bytes: u64,
        ceiling_bytes: u64,
    },
    Undecodable,
    VersionMismatch,
    ConfigHashMismatch,
    RootMismatch,
    ModeMismatch,
    FileSetChanged,
    FingerprintChanged,
}

Why a cache load or a cache comparison refused to reuse persisted work.

Variants

Absent

No cache file exists yet. The only variant that is not a refusal of existing work: a first run on a project reports this.

Unreadable

The cache path exists or could not be inspected, but reading it failed.

Oversize

The cache file is larger than the safety ceiling, so it was never decoded. Reported with both figures so the operator can raise the configured ceiling or delete the blob.

Fields

size_bytes: u64

On-disk size of the refused cache file in bytes.

ceiling_bytes: u64

Ceiling the file exceeded, in bytes.

Undecodable

The cache could not be decoded: an older unframed format, foreign data, or a damaged payload. This does not establish corruption.

VersionMismatch

The decoded cache declares a different format version, so its entries cannot be read into the current shape.

ConfigHashMismatch

The cache was built under a different extraction-affecting config, so its entries describe a different analysis.

RootMismatch

The graph cache was built for a different project root. Its retained absolute paths cannot be reused in the relocated checkout. Extraction entries remain independently reusable through their root-relative keys.

ModeMismatch

The graph cache decoded, but it was built with different resolver options, entry points, or plugin configuration.

FileSetChanged

The graph cache decoded, but the set of analysed files changed.

FingerprintChanged

The graph cache decoded and covers the same files, but at least one file’s content changed.

Implementations

impl CacheRejection

pub const fn id(&self) -> &'static str

Stable kebab-case identifier for logs, doctor output, and tests.

pub fn describe(&self) -> String

Short human sentence fragment, suitable inside a perf row or a doctor message. Never contains a host path.

pub const fn discarded_existing_work(&self) -> bool

Whether the refusal is worth putting on stderr.

True when the cache was refused for a reason the user can act on: a stale format, a config or root drift, a blob that would not decode. The user paid for the blob and got nothing back, and something on disk or in the config has to change before the next run does better.

False for Absent and for the two content-drift variants. Editing a file and re-running is the ordinary way to use fallow, so FileSetChanged and FingerprintChanged describe a cache doing exactly what it should: every edit-then-run cycle hit them, fallow watch hit them once per save, and --quiet did not suppress the warning. Both reasons stay on the doctor check and the performance table, where a reader went looking for them.

Trait Implementations

impl Clone for CacheRejection

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for CacheRejection

impl Debug for CacheRejection

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

Formats the value using the given formatter.

impl Eq for CacheRejection

impl PartialEq for CacheRejection

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for CacheRejection

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 CacheRejection