Module pipeline_cache 

Content-addressed authenticated artifact cache. Content-addressed neutral-artifact cache.

PipelineFingerprint derives directly from the authenticated neutral vyre_megakernel::Artifact identity. Dispatch inputs, target payloads, device generations, and runtime policy do not enter this layer’s key. Persisted blobs use a versioned, digest-bound frame and stale versions miss rather than being served.

Hot paths use InMemoryPipelineCache, process-restart reuse uses DiskCache, and callers compose them through LayeredPipelineCache.

Structs

DiskCache

Disk-backed pipeline cache. Writes one file per fingerprint under <root>/<hex>.bin. Reads are stateless; writes are write + rename for atomicity. No eviction policy today (user decides) - the footprint is bounded by sum(artifact_size × unique_canonical_programs).

DiskCacheDurabilityReport

Crash-durability evidence for disk cache artifacts.

InMemoryEvictionReport

Structured eviction report for one in-memory cache shard.

InMemoryPipelineCache

In-memory pipeline cache - zero-persistence, zero-network, sharded FxHashMaps behind mutexes so concurrent get/put on different fingerprints rarely contend (VYRE_RUNTIME / PERF hot-cache audit).

LayeredPipelineCache

Composite store that reads from every backend and writes to the first. Lets callers compose [RamStore, DiskStore, RemoteStore] so a miss at the fast layer falls through to slower layers.

LayeredPromotionReport

Layered-cache promotion evidence.

PipelineCacheMetricError

Pipeline-cache metric arithmetic failure.

PipelineCacheMetrics

Pipeline-cache instrumentation counters.

PipelineFingerprint

The exact canonical artifact digest used as a pipeline-cache key.

RemoteCache

HTTPS-backed cache that reads pre-compiled artifacts from a base URL. Feature-gated on remote-cache so library users who only want disk caching don’t pull in ureq.

Enums

DiskCacheError

Errors from disk-backed pipeline cache construction / use.

InMemoryEvictionReason

Reason the in-memory pipeline cache evicted retained artifacts.

Traits

PipelineCacheStore

Trait for persistent pipeline-cache backends. super::DiskCache and super::RemoteCache (when the remote-cache feature is enabled) ship disk- and network-backed implementations; tests here use the in-memory super::InMemoryPipelineCache.