Module edge_cache 

Edge-cache eligibility registry.

Tracks which nodes have been registered as eligible for edge caching by the upstream control plane (the consuming cluster manager). Propagates the eligibility decision via the gossip-label mechanism in crate::gossip so peer nodes can route cache-bearing traffic to eligible nodes by inspecting their advertised gossip::PeerInfo::labels.

The actual cache fill / eviction / hit-counting logic is out of scope for this module — it lives in upstream feature work (Z3Fungi sidecar or a future overlay-native cache primitive). EdgeCacheRegistry::stats returns a (0, 0) placeholder intentionally; the API surface exists so upstream integration tests (e.g. Zatabase Wave 1.3.3.7) can build against it.

Structs

EdgeCacheNode

One entry in the registry — a node currently marked edge-cache-eligible.

EdgeCacheRegistry

Tracks which nodes are eligible for edge caching and propagates that state via gossip labels.

EdgeCacheStats

Per-node cache hit/miss counters.

NodeCapacity

Cache capacity advertised by a node when it becomes eligible.

Enums

EdgeCacheError

Errors returned by EdgeCacheRegistry.