Struct VectorStore 

pub struct VectorStore { /* private fields */ }

Main vector store

Implementations

impl VectorStore

pub fn new(provider: Arc<EmbeddingBackend>) -> Self

Create new vector store

pub fn with_storage(self, path: impl Into<PathBuf>) -> Self

Set storage path for persistence

pub fn with_chunker(self, chunker: CodeChunker) -> Self

Set chunker

pub fn collection( &mut self, name: &str, scope: CollectionScope, ) -> &mut VectorCollection

Create or get collection

pub fn get_collection(&self, name: &str) -> Option<&VectorCollection>

Get collection by name

pub fn list_collections(&self) -> Vec<&str>

List all collections

pub fn delete_collection(&mut self, name: &str) -> Option<VectorCollection>

Delete collection, including its on-disk files.

pub async fn index_file( &mut self, collection_name: &str, file_path: &Path, ) -> Result<usize>

Index a file into a collection

pub async fn rebuild_index(&mut self, collection_name: &str) -> Result<()>

Rebuild the index for a collection from its stored chunks.

This discards the current index and reconstructs it by re-embedding every chunk in the collection. Useful when check_health() reports IndexHealth::Corrupt.

pub async fn search( &self, collection_name: &str, query: &str, k: usize, filter: Option<&SearchFilter>, ) -> Result<Vec<SearchResult>>

Search across collection.

If all raw similarity scores are NaN a warning is logged. Callers that hold a mutable reference can use Self::search_or_rebuild instead to automatically rebuild the index and retry.

pub async fn search_or_rebuild( &mut self, collection_name: &str, query: &str, k: usize, filter: Option<&SearchFilter>, ) -> Result<Vec<SearchResult>>

Search with automatic index rebuild on corruption.

If the initial search produces only NaN scores the index is rebuilt from the source chunks and the search is retried once.

pub fn save(&self) -> Result<()>

Save store to disk.

Uses atomic writes (temp file + rename) for each file to prevent corruption if the process crashes mid-write. Both the .json and .idx files for a collection are written atomically.

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

Load store from disk

pub fn stats(&self) -> VectorStoreStats

Get store statistics