Struct VectorStore 

pub struct VectorStore { /* private fields */ }

Vector database using arroy + heed (LMDB)

Single-file database with:

• Vector search via arroy (ANN with random projections)
• Metadata storage via heed (LMDB)
• ACID transactions
• Memory-mapped for performance

Implementations

impl VectorStore

pub fn clear_stale_readers(&self) -> Result<usize>

Clear stale LMDB reader slots left by crashed processes.

LMDB has a fixed reader table (default 126 slots). Processes that crash without closing their read transactions leave stale entries. When the table fills up, new read transactions fail with MDB_READERS_FULL.

Call this on startup to reclaim slots from dead PIDs.

pub fn new(db_path: &Path, dimensions: usize) -> Result<Self>

Create or open a vector store

Arguments

• db_path - Path to the database directory (e.g., “.codesearch.db”)
• dimensions - Dimensionality of embeddings (e.g., 384, 768)

pub fn open_readonly(db_path: &Path, dimensions: usize) -> Result<Self>

Open a vector store in read-only mode (for searches while another process writes)

Arguments

• db_path - Path to the database directory (e.g., “.codesearch.db”)
• dimensions - Dimensionality of embeddings (e.g., 384, 768)

pub fn insert_chunks(&mut self, chunks: Vec<EmbeddedChunk>) -> Result<usize>

Insert embedded chunks into the database

Returns the number of chunks inserted

pub fn build_index(&mut self) -> Result<()>

Build the vector index

Must be called after inserting chunks and before searching

pub fn search( &self, query_embedding: &[f32], limit: usize, ) -> Result<Vec<SearchResult>>

Search for similar chunks

Arguments

• query_embedding - The query vector
• limit - Maximum number of results to return

Returns

Vector of search results with metadata and scores

pub fn stats(&self) -> Result<StoreStats>

Get statistics about the vector store

pub fn delete_chunks(&mut self, chunk_ids: &[u32]) -> Result<usize>

Delete chunks by their IDs

Returns the number of chunks deleted

pub fn insert_chunks_with_ids( &mut self, chunks: Vec<EmbeddedChunk>, ) -> Result<Vec<u32>>

Delete all chunks from a specific file

Returns the IDs of deleted chunks Insert chunks and return their assigned IDs

Useful for tracking which chunks belong to which file

pub fn clear(&mut self) -> Result<()>

Clear all data from the database

pub fn get_chunk(&self, id: u32) -> Result<Option<ChunkMetadata>>

Get a chunk by ID

pub fn get_chunk_as_result(&self, id: u32) -> Result<Option<SearchResult>>

Get a chunk as SearchResult (for hybrid search)

pub fn all_chunks(&self) -> Result<Vec<(u32, ChunkMetadata)>>

Iterate all chunks in the store via LMDB cursor. Returns (id, metadata) pairs for every chunk, regardless of ID gaps. This is the correct way to enumerate chunks after delete+insert cycles.

pub fn db_size(&self) -> Result<u64>

Get the database file size in bytes

pub fn is_indexed(&self) -> bool

Check if the index is built