Module pack 

Packfile management for efficient storage.

Packfiles bundle multiple objects together with delta compression, achieving 50-70% space savings for repositories with many similar objects.

Structs

CancellationToken

Cooperative cancellation shared by a caller and a repack operation.

EncodedPackSubset

PackBuilder

Pack builder for creating packfiles.

PackContainerSpec

PackEntryHeader

PackIndex

Pack index for fast object lookup.

PackLogicalId

Root-spool-scoped identity of the logical objects in a pack.

PackManager

Format-only coordinator for loaded pack and index files.

PackObjectRecord

PackReader

PackRepresentationHash

Hash of one finalized physical pack representation.

PackStats

Pack statistics.

RepackContext

Cooperative controls supplied to a storage-specific operation.

RepackHandle

Handle for cancellation and result collection.

RepackInventory

Cheap storage facts used to decide whether a repack is worthwhile.

RepackOutcome

Storage-produced measurements, excluding scheduler-owned duration/reason.

RepackPolicy

Configurable automatic repack thresholds.

RepackReport

Completed operation measurements.

RepackResourceLimits

Scheduler-wide resource limits.

RepackScheduler

Bounded background scheduler shared by native and hosted repack payloads.

StreamingPackBuilder

Streaming pack builder. Held generic over the pack writer (File in production, Cursor<Vec<u8>> in tests).

Enums

ObjectType

Object type for pack entries.

PackObjectId

PackReadTier

Physical read tier for an indexed pack object.

RepackError

Error returned by scheduling or executing a repack.

RepackReason

The policy signal that caused a background repack.

RepackSchedule

Result of asking the scheduler to start work.

Constants

PACK_CHECKSUM_LEN

PACK_LOGICAL_ID_CONTEXT

BLAKE3 derive-key context for the canonical logical pack inventory.

Traits

LoadMonitor

Host-load signal consulted at cooperative checkpoints.

RepackOperation

Storage-specific repack payload driven by the scheduler.

SyncData

Fsync staged pack bytes after finalize flush (Wave 5 L7).

Functions

append_container_checksum

compress_compact_frame

Compress one compact metadata frame with the measured lineage-solid policy.

compress_pack_payload

decode_tagged_entry_header

decompress_pack_payload

encode_tagged_entry

encode_tagged_entry_parts

has_zstd_magic

try_decode_tagged_entry_header

verify_container

verify_container_layout

write_container_header