Struct VectorIndexOptimizer 

pub struct VectorIndexOptimizer { /* private fields */ }

Production-quality vector index optimizer.

Observes a stream of query/insert events, builds a WorkloadProfile, and recommends the best IndexStructure given an OptimizationCriterion. It also monitors live IndexStats and emits MaintenanceActions when needed.

Implementations

impl VectorIndexOptimizer

pub fn new(config: OptimizerConfig) -> Self

Create a new optimizer with the provided configuration.

pub fn with_defaults() -> Self

Create a new optimizer with default configuration.

pub fn record_query( &mut self, k: usize, latency_us: u64, recall: f64, _current_ts: u64, )

Record a completed query.

• k: requested top-k
• latency_us: measured query latency in microseconds
• recall: observed recall@k (0–1)
• current_ts: current Unix timestamp in seconds (for time-series tracking)

pub fn record_insert(&mut self, _current_ts: u64)

Record an insert operation.

• current_ts: current Unix timestamp in seconds

pub fn record_delete(&mut self, _current_ts: u64)

Record a delete operation.

pub fn workload_profile( &self, dataset_size: usize, dim: usize, ) -> WorkloadProfile

Snapshot the current workload profile.

pub fn recommend( &mut self, dataset_size: usize, dim: usize, ) -> Result<IndexRecommendation, OptimizerError>

Recommend the best index structure for the given dataset and dimensionality.

Returns Err(OptimizerError::InsufficientData) until profile_window queries have been observed.

pub fn estimate_recall(structure: &IndexStructure, n: usize, k: usize) -> f64

Heuristic recall estimate for a structure at a given dataset size and k.

pub fn should_rebuild( &mut self, current_stats: &IndexStats, ) -> Option<MaintenanceAction>

Check whether a rebuild or other maintenance is required.

Returns Some(action) when a rebuild is recommended, None otherwise.

pub fn record_post_rebuild_recall(&mut self, new_recall: f64)

Observe a post-rebuild recall to update improvement tracking.

pub fn maintenance_actions( &mut self, stats: &IndexStats, dataset_size: usize, dim: usize, ) -> Vec<MaintenanceAction>

Comprehensive maintenance check — returns all applicable actions.

pub fn compare_structures( &self, a: &IndexStructure, b: &IndexStructure, profile: &WorkloadProfile, ) -> Ordering

Compare two index structures under the active criterion and profile.

Returns Ordering::Greater if a is preferred over b.

pub fn stats(&self) -> OptimizerStats

Return aggregate statistics for this optimizer instance.

pub fn profiling_progress(&self) -> (usize, usize)

Current profiling window fill level (0 to profile_window).

Returns (observed_queries, required_for_recommendation). Both the latency and recall windows must reach profile_window before recommend returns a valid result.