Struct SegmentMetaInfo 

pub struct SegmentMetaInfo {
    pub deletions: Option<DeletionMeta>,
    pub num_docs: u32,
    pub ancestors: Vec<String>,
    pub generation: u32,
    pub reordered: bool,
    pub bp_converged: bool,
    pub bp_unconverged_passes: u32,
    pub seismic_pending_terms: u32,
    pub seismic_maintenance_passes: u32,
    pub seismic_no_progress_passes: u32,
    pub ann_fragmented: bool,
}

Per-segment metadata stored in index metadata This allows merge decisions without loading segment files

Fields

deletions: Option<DeletionMeta>

Exact immutable row visibility generation; absence means all rows live.

num_docs: u32

Number of documents in this segment

ancestors: Vec<String>

Parent segment IDs that were merged to produce this segment (empty for fresh segments)

generation: u32

Merge generation: 0 for fresh segments, max(parent generations) + 1 for merged segments

reordered: bool

Whether this segment has been reordered via Recursive Graph Bisection (BP). Fresh segments and block-copy merges are not reordered. Only segments that have been explicitly reordered (via background optimizer or reorder command) are marked true.

bp_converged: bool

Whether the last BP reorder pass ran to natural convergence. False when a wall-clock BP budget ended the pass early — the segment is ordered better than before, and a later warm-started pass can deepen it. Old metadata (field absent) deserializes as converged.

bp_unconverged_passes: u32

Number of consecutive budget-exhausted BP rewrites in this segment’s current reordered lineage. Carried across replacement IDs so the optimizer can impose a hard follow-up bound instead of rewriting forever.

seismic_pending_terms: u32

Terms whose copied Seismic nominations still span multiple runs.

seismic_maintenance_passes: u32

Published partial-maintenance passes in this replacement lineage. Used to distinguish initial work from cooldown-paced follow-ups, not as a cap.

seismic_no_progress_passes: u32

Consecutive published maintenance passes that did not reduce Seismic nomination debt. Progress resets this count; the optimizer bounds stalls.

ann_fragmented: bool

Binary ANN leaves with multiple copied runs require lossless coalescing.

Implementations

impl SegmentMetaInfo

pub fn num_deleted_docs(&self) -> u32

pub fn num_live_docs(&self) -> u32

pub fn deleted_ratio(&self) -> f64

Trait Implementations

impl Clone for SegmentMetaInfo

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SegmentMetaInfo

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SegmentMetaInfo

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SegmentMetaInfo

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.