Skip to main content

Crate zhold_core

Crate zhold_core 

Source
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.
ArenaRecord
Complete policy input for one managed arena.
ByteSize
A non-negative count of bytes.
CollectionPlan
Deterministic collection plan before filesystem mutation.
CollectionPolicy
Collection policy for a bounded managed store.
CommandDescriptor
Non-secret description of one managed Cargo invocation.
Eviction
One planned whole-arena eviction.
HistoryPolicy
Persisted receipt-retention policy.
ParseHistoryKindError
Error returned for an unknown history category.
ParseQuotaProviderError
Error returned for an unknown quota provider.
RepositoryId
Stable identity for one local Git common directory.
ToolchainId
Stable identity for a complete Rust toolchain description.
WorkspaceId
Stable identity for one canonical Cargo workspace root.
WorktreeId
Stable identity for one canonical Git worktree root.
WorktreeKey
Stable coordination identity for one repository worktree.

Enums§

ArenaLiveness
Proven liveness of the most recent managed command.
ArenaState
Current retention state observed for an arena.
BuildOutcome
Result of the most recent managed command.
CargoCommandClass
Bounded classification of a managed Cargo command.
EvictionReason
Explainable reason an arena was selected for eviction.
HistoryKind
Durable operation category stored in history.
HookEvent
Worktree-manager lifecycle operation.
HookResult
Stable result category for a lifecycle operation.
ParseByteSizeError
Failure to parse a human-readable byte size.
ParseIdentityError
Failure to parse a stable zhold identity.
PolicyError
Invalid collection policy.
QuotaHealth
Verified health of an optional quota capability.
QuotaProvider
Store-scoped filesystem quota provider.
SizeQuality
Confidence in the byte count attached to an arena observation.
WorktreeIntegrationState
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.