Trait VectorBackend 

pub trait VectorBackend: Send + Sync {
    // Required methods
    fn insert(
        &mut self,
        id: &str,
        embedding: &[f32],
    ) -> Result<(), CodememError>;
    fn insert_batch(
        &mut self,
        items: &[(String, Vec<f32>)],
    ) -> Result<(), CodememError>;
    fn search(
        &self,
        query: &[f32],
        k: usize,
    ) -> Result<Vec<(String, f32)>, CodememError>;
    fn remove(&mut self, id: &str) -> Result<bool, CodememError>;
    fn save(&self, path: &Path) -> Result<(), CodememError>;
    fn load(&mut self, path: &Path) -> Result<(), CodememError>;
    fn stats(&self) -> VectorStats;

    // Provided methods
    fn needs_compaction(&self) -> bool { ... }
    fn ghost_count(&self) -> usize { ... }
    fn rebuild_from_entries(
        &mut self,
        _entries: &[(String, Vec<f32>)],
    ) -> Result<(), CodememError> { ... }
}

Vector backend trait for HNSW index operations.

Required Methods

fn insert(&mut self, id: &str, embedding: &[f32]) -> Result<(), CodememError>

Insert a vector with associated ID.

fn insert_batch( &mut self, items: &[(String, Vec<f32>)], ) -> Result<(), CodememError>

Batch insert vectors.

fn search( &self, query: &[f32], k: usize, ) -> Result<Vec<(String, f32)>, CodememError>

Search for k nearest neighbors. Returns (id, distance) pairs.

fn remove(&mut self, id: &str) -> Result<bool, CodememError>

Remove a vector by ID.

fn save(&self, path: &Path) -> Result<(), CodememError>

Save the index to disk.

fn load(&mut self, path: &Path) -> Result<(), CodememError>

Load the index from disk.

fn stats(&self) -> VectorStats

Get index statistics.

Provided Methods

fn needs_compaction(&self) -> bool

Whether the index has accumulated enough ghost entries to warrant compaction.

fn ghost_count(&self) -> usize

Number of ghost entries left by removals.

fn rebuild_from_entries( &mut self, _entries: &[(String, Vec<f32>)], ) -> Result<(), CodememError>

Rebuild the index from scratch given all current entries.

Implementors