Expand description
Read-only cache introspection per AUX-017..AUX-021.
Cache::info walks the cache root and returns a
CacheInfoReport classifying every entry, summing the total
disk footprint, and breaking down well-formed entries by their
manifest’s (chapter_revision, hash_function) prefix. The walk
is strictly read-only: no file or directory under the cache
root is created, removed, renamed, or modified.
The walk shares its tree-shape recognition with
Cache::clean but with different intent:
cleanremoves objectively-stale entries and orphan.tmp-/.restore-directories (under--soft), and age- or size-bounded entries (under--max-age/--max-size).infoclassifies the same shapes into counts without touching anything.
Unparseable manifests and schema mismatches surface as the
corrupt_entries count rather than as errors; the only failure
mode is a filesystem read error during the walk.
Structs§
- Cache
Info Report - Outcome of
Cache::info: every categoryAUX-019demands.
Enums§
- Cache
Info Error - Failure modes for
Cache::info.
Type Aliases§
- Schema
Prefix - Schema-prefix key used by
CacheInfoReport::by_schema.