Struct HnswIndex 

pub struct HnswIndex { /* private fields */ }

HNSW vector index backed by usearch.

Implementations

impl HnswIndex

pub fn new(config: VectorConfig) -> Result<Self, CodememError>

Create a new HNSW index with the given configuration.

pub fn with_defaults() -> Result<Self, CodememError>

Create a new index with default configuration (768-dim, cosine).

pub fn len(&self) -> usize

Get the number of vectors in the index.

pub fn is_empty(&self) -> bool

Check if the index is empty.

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

Rebuild the index from scratch using the provided entries.

This eliminates ghost entries left behind by remove() (usearch marks removed keys but does not free their memory). The caller should collect all live (id, embedding) pairs — typically from SQLite — and pass them here.

pub fn needs_compaction(&self) -> bool

Returns true if ghost entries exceed 20% of live entries, suggesting a rebuild.

pub fn ghost_count(&self) -> usize

Returns the number of ghost entries in the index.

Trait Implementations

impl VectorBackend for HnswIndex

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.