Expand description
Deterministic storage-governance vocabulary for zhold.
The crate is deliberately free of filesystem and process I/O. Callers provide observed arena records and receive deterministic retention decisions.
Structs§
- ArenaId
- Stable identity for one managed build arena.
- Arena
Record - Complete policy input for one managed arena.
- Byte
Size - A non-negative count of bytes.
- Collection
Plan - Deterministic collection plan before filesystem mutation.
- Collection
Policy - Collection policy for a bounded managed store.
- Command
Descriptor - Non-secret description of one managed Cargo invocation.
- Eviction
- One planned whole-arena eviction.
- History
Policy - Persisted receipt-retention policy.
- Parse
History Kind Error - Error returned for an unknown history category.
- Parse
Quota Provider Error - Error returned for an unknown quota provider.
- Repository
Id - Stable identity for one local Git common directory.
- Toolchain
Id - Stable identity for a complete Rust toolchain description.
- Workspace
Id - Stable identity for one canonical Cargo workspace root.
- Worktree
Id - Stable identity for one canonical Git worktree root.
- Worktree
Key - Stable coordination identity for one repository worktree.
Enums§
- Arena
Liveness - Proven liveness of the most recent managed command.
- Arena
State - Current retention state observed for an arena.
- Build
Outcome - Result of the most recent managed command.
- Cargo
Command Class - Bounded classification of a managed Cargo command.
- Eviction
Reason - Explainable reason an arena was selected for eviction.
- History
Kind - Durable operation category stored in history.
- Hook
Event - Worktree-manager lifecycle operation.
- Hook
Result - Stable result category for a lifecycle operation.
- Parse
Byte Size Error - Failure to parse a human-readable byte size.
- Parse
Identity Error - Failure to parse a stable zhold identity.
- Policy
Error - Invalid collection policy.
- Quota
Health - Verified health of an optional quota capability.
- Quota
Provider - Store-scoped filesystem quota provider.
- Size
Quality - Confidence in the byte count attached to an arena observation.
- Worktree
Integration State - Durable lifecycle state for one registered worktree.
Functions§
- plan_
collection - Produces an explainable whole-arena collection plan.
- plan_
collection_ with_ reservation - Plans collection while preserving capacity reserved by live builds.