Expand description
The CacheWriter handle: a writable, filesystem-bound view
onto the cache tree at <workspace-root>/.haz/cache per
crate::layout.
Pairs with crate::CacheReader. The writer holds a reader as
its inner state; lookup, schema introspection, and any other
read-only operation are reached via CacheWriter::reader
rather than being re-exposed here. The split keeps the read-only
contract of AUX-018 / AUX-020 enforceable at the type level:
a future commit attempting to publish a write through a
read-only path no longer compiles, because the CacheReader
it would have to flow through does not implement
haz_vfs::WritableFilesystem.
Write-side operations live in sibling modules:
crate::store for CacheWriter::store (CACHE-017),
crate::restore for CacheWriter::restore (CACHE-019),
crate::clean for CacheWriter::clear / CacheWriter::clean
(CACHE-021, CACHE-022, AUX-022..AUX-027).
Structsยง
- Cache
Writer - Writable handle to the cache tree rooted at
<workspace_root>/.haz/cache, parameterised over aWritableFilesystembackend.