Skip to main content

Module cache

Module cache 

Source
Expand description

Scratch-clone cache for git.digest’s remote-URL mode (ADR-088 Amendment 1). Clones/fetches into ~/.khive/scratch/git-digest/<cache_key>/, keyed by canonical URL (crate::source::cache_key). An LRU cap (env-var configured: KHIVE_GIT_DIGEST_CACHE_MAX_REPOS, KHIVE_GIT_DIGEST_CACHE_MAX_BYTES, KHIVE_GIT_DIGEST_CLONE_MAX_BYTES, KHIVE_GIT_DIGEST_SCRATCH_ROOT) evicts least-recently-used clones once the cache exceeds its repo-count or total-byte limit; a per-clone size cap rejects an oversized clone/fetch before it enters the addressable cache slot. See crates/khive-pack-git/docs/api/cache.md for the full design rationale (ownership-proof eviction, staging-then-move installation, per-clone cap enforcement).

Enums§

CacheError

Constants§

DEFAULT_CLONE_MAX_BYTES
DEFAULT_MAX_REPOS
DEFAULT_MAX_TOTAL_BYTES

Functions§

ensure_clone
Ensure a local clone of canonical_url exists and is up to date; returns the repo’s local path.