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§
- Arena
Lease - Exclusive live-build lease for one managed arena and shared worktree gate.
- Build
Context - Resolved compatibility and lifecycle identity for one managed Cargo build.
- Build
Finalization - Nonfatal history results produced while finalizing one managed build.
- Build
Receipt - Privacy-bounded completed-build evidence.
- Cargo
Invocation - One Cargo command to run from a working directory.
- Collection
Receipt - Confirmed collection evidence without raw paths or commands.
- Collection
Report - Result of one deterministic collection attempt.
- Collection
Skip - Candidate skipped because state changed or validation failed after planning.
- Context
Resolver - Resolves Cargo, Git, worktree, workspace, and toolchain identity.
- Doctor
Report - Read-only store health summary.
- Finalization
Warning - Failure of non-authoritative work after a lifecycle commit.
- Foreign
Target - Read-only Cargo target directory not owned by zhold.
- History
Finding - Untrusted history entry excluded from query and retention.
- History
Policy Document - Persisted receipt-retention policy envelope.
- History
Prune Report - Result of deterministic validated receipt pruning.
- History
Prune Request - Deterministic manual receipt-pruning constraints.
- History
Query - Newest-first receipt filters.
- History
Receipt - Immutable versioned evidence for one committed operation outcome.
- History
Report - Complete filtered persistent-history query result.
- History
Summary - Compact persistent-history health for status and doctor.
- History
Warning - Nonfatal receipt subsystem warning.
- History
Write - Result of attempting one non-authoritative receipt publication.
- Hook
Metadata - Optional bounded metadata supplied by a worktree manager.
- Hook
Receipt - Worktree-manager lifecycle evidence.
- Hook
Report - Result of one manager lifecycle operation.
- Inventory
- Snapshot of all valid managed arenas in one store.
- Inventory
Entry - One valid managed arena with policy and presentation metadata.
- Inventory
Finding - An untrusted or unreadable entry excluded from mutation planning.
- Quota
Action - One read-only administrator action proposed by
quota plan. - Quota
Adoption - Result of adopting or unadopting an expectation.
- Quota
Expectation - Persisted expectation for one externally provisioned exact-scope hard quota.
- Quota
Observation - Fresh provider observation for the canonical store root.
- Quota
Plan - Read-only provider plan for a requested hard ceiling.
- Quota
Receipt - Quota expectation evidence without raw provider output.
- Quota
Status - Complete current adoption and provider health.
- Recovery
Receipt - Auditable operator decision that made an unleased unfinished arena collectible.
- Retirement
- One arena retired from the active index.
- Scan
Report - Combined managed and read-only foreign storage scan.
- Store
- Opened marked zhold store.
- Store
Config - Durable defaults for governed Cargo builds in one marked store.
- Store
Info - Stable metadata for an opened store.
- Trash
Entry - One owned-trash deletion attempt.
- Trash
Report - Result of retrying deletion beneath the owned retirement directory.
- Worktree
Context - Validated Git identity for one existing worktree.
- Worktree
Finding - Untrusted integration entry excluded from coordination joins.
- Worktree
Integration - Validated persisted registration for one worktree.
- Worktree
Summary - Compact worktree-integration health summary.
Enums§
- Collection
Receipt Source - Source of one committed collection receipt.
- Finalization
Warning Event - Nonfatal auxiliary finalization warning category.
- History
Payload - Typed committed operation summary.
- History
Warning Event - Nonfatal receipt subsystem warning category.
- Inventory
Depth - Cost and freshness class used to produce an inventory.
- Quota
Receipt Action - Quota expectation transition recorded in history.
- Recovery
Reason - Stable reason for an authoritative recovery transition.
- Retirement
Disposition - Final state of a retired arena.
- Store
Error - Failure at the zhold filesystem or process boundary.
- Trash
Outcome - Outcome of one owned-trash entry.