Struct IndexCompactor 

pub struct IndexCompactor {
    pub policy: CompactionPolicy,
    pub stats: CompactorStats,
}

Analyses HNSW index fragmentation and recommends compaction plans.

IndexCompactor is the central entry point for compaction decisions. Given an IndexFragmentStats it applies the configured CompactionPolicy and returns an Option<CompactionPlan>: Some when compaction is warranted, None when the index is healthy enough to leave alone.

All activity is recorded in CompactorStats so operators can observe how frequently indexes require maintenance.

Fields

policy: CompactionPolicy

Configurable thresholds that drive compaction decisions.

stats: CompactorStats

Atomic activity counters.

Implementations

impl IndexCompactor

pub fn new(policy: CompactionPolicy) -> Self

Creates a new IndexCompactor with the supplied policy.

pub fn analyze( &self, fragment_stats: &IndexFragmentStats, ) -> Option<CompactionPlan>

Analyses fragment_stats and returns a CompactionPlan when compaction is needed.

Returns None when the index is below all policy thresholds.

pub fn estimate_priority( &self, stats: &IndexFragmentStats, ) -> CompactionPriority

Estimates the urgency of the required compaction.

Condition	Priority
deleted_ratio > 0.5 or index_bytes > 2 × limit	Critical
deleted_ratio > 0.25	High
compaction needed	Normal
compaction not needed	Low

pub fn estimate_bytes_saved(&self, stats: &IndexFragmentStats) -> u64

Estimates how many bytes will be reclaimed by a compaction.

Uses the approximation deleted_ratio × index_bytes.

Trait Implementations

impl Clone for IndexCompactor

fn clone(&self) -> IndexCompactor

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IndexCompactor

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

Formats the value using the given formatter.