Struct PackPlan 

pub struct PackPlan {
    pub raw: Vec<Hash>,
    pub deltas: Vec<PlannedDelta>,
    pub self_contained: bool,
}

A deterministic plan for the pack(s) a push uploads for one ref — serialised into a single pack when it fits under the payload cap, or split across several when it doesn’t (issue #831).

Entries are pre-ordered for crate::pack::PackWriter: all raw objects first (non-blobs before blobs, each group in BLAKE3 order), then deltas. Delta bases are external — they live in old_tip’s closure, which the remote already holds and earlier packs already delivered, NEVER in an entry introduced earlier in this same plan — so no in-pack base ordering is required (SPEC-PACKFILE §4), and a left-to-right split of this sequence across multiple packs is always safe.

Fields

raw: Vec<Hash>

Objects to send verbatim, already ordered non-blobs-then-blobs.

deltas: Vec<PlannedDelta>

Objects to send as a delta against an already-present base.

self_contained: bool

true when the pack needs no externally-resolved base — i.e. this is a full-closure push (no usable old_tip), so the pack reconstructs the ref’s whole closure on its own. The push path normally appends this pack to the branch’s packlist chain; it uses self_contained to decide whether a push may reset to a fresh chain, in two cases:

• Reactively, when the prior chain is unreadable — a self-contained pack is the one kind that can safely escape a broken chain.
• Proactively (#406): when a healthy chain has simply grown past the re-baseline depth threshold, the push side calls plan_pack with old_tip: None specifically to force self_contained: true, then resets the chain to bound its depth. This reuses the atomic head+packmap advance (#408) the reactive reset already depends on — no separate mechanism was needed once that landed.

Implementations

impl PackPlan

pub fn object_count(&self) -> usize

Total objects the plan transfers (raw + delta).

pub fn is_empty(&self) -> bool

true when the plan carries nothing — the remote already holds the ref’s whole closure.

Trait Implementations

impl Clone for PackPlan

fn clone(&self) -> PackPlan

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PackPlan

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for PackPlan

fn default() -> PackPlan

Returns the “default value” for a type.