Skip to main content

Crate zhold_store

Crate zhold_store 

Source
Expand description

Owned build arenas and safe filesystem lifecycle for zhold.

The crate exposes capabilities through a flat facade. Internal paths, lock files, manifests, and mutation ordering are not public compatibility boundaries.

Structs§

ArenaLease
Exclusive live-build lease for one managed arena and shared worktree gate.
BuildContext
Resolved compatibility and lifecycle identity for one managed Cargo build.
BuildFinalization
Nonfatal history results produced while finalizing one managed build.
BuildReceipt
Privacy-bounded completed-build evidence.
CargoInvocation
One Cargo command to run from a working directory.
CollectionReceipt
Confirmed collection evidence without raw paths or commands.
CollectionReport
Result of one deterministic collection attempt.
CollectionSkip
Candidate skipped because state changed or validation failed after planning.
ContextResolver
Resolves Cargo, Git, worktree, workspace, and toolchain identity.
DoctorReport
Read-only store health summary.
FinalizationWarning
Failure of non-authoritative work after a lifecycle commit.
ForeignTarget
Read-only Cargo target directory not owned by zhold.
HistoryFinding
Untrusted history entry excluded from query and retention.
HistoryPolicyDocument
Persisted receipt-retention policy envelope.
HistoryPruneReport
Result of deterministic validated receipt pruning.
HistoryPruneRequest
Deterministic manual receipt-pruning constraints.
HistoryQuery
Newest-first receipt filters.
HistoryReceipt
Immutable versioned evidence for one committed operation outcome.
HistoryReport
Complete filtered persistent-history query result.
HistorySummary
Compact persistent-history health for status and doctor.
HistoryWarning
Nonfatal receipt subsystem warning.
HistoryWrite
Result of attempting one non-authoritative receipt publication.
HookMetadata
Optional bounded metadata supplied by a worktree manager.
HookReceipt
Worktree-manager lifecycle evidence.
HookReport
Result of one manager lifecycle operation.
Inventory
Snapshot of all valid managed arenas in one store.
InventoryEntry
One valid managed arena with policy and presentation metadata.
InventoryFinding
An untrusted or unreadable entry excluded from mutation planning.
QuotaAction
One read-only administrator action proposed by quota plan.
QuotaAdoption
Result of adopting or unadopting an expectation.
QuotaExpectation
Persisted expectation for one externally provisioned exact-scope hard quota.
QuotaObservation
Fresh provider observation for the canonical store root.
QuotaPlan
Read-only provider plan for a requested hard ceiling.
QuotaReceipt
Quota expectation evidence without raw provider output.
QuotaStatus
Complete current adoption and provider health.
RecoveryReceipt
Auditable operator decision that made an unleased unfinished arena collectible.
Retirement
One arena retired from the active index.
ScanReport
Combined managed and read-only foreign storage scan.
Store
Opened marked zhold store.
StoreConfig
Durable defaults for governed Cargo builds in one marked store.
StoreInfo
Stable metadata for an opened store.
TrashEntry
One owned-trash deletion attempt.
TrashReport
Result of retrying deletion beneath the owned retirement directory.
WorktreeContext
Validated Git identity for one existing worktree.
WorktreeFinding
Untrusted integration entry excluded from coordination joins.
WorktreeIntegration
Validated persisted registration for one worktree.
WorktreeSummary
Compact worktree-integration health summary.

Enums§

CollectionReceiptSource
Source of one committed collection receipt.
FinalizationWarningEvent
Nonfatal auxiliary finalization warning category.
HistoryPayload
Typed committed operation summary.
HistoryWarningEvent
Nonfatal receipt subsystem warning category.
InventoryDepth
Cost and freshness class used to produce an inventory.
QuotaReceiptAction
Quota expectation transition recorded in history.
RecoveryReason
Stable reason for an authoritative recovery transition.
RetirementDisposition
Final state of a retired arena.
StoreError
Failure at the zhold filesystem or process boundary.
TrashOutcome
Outcome of one owned-trash entry.