Struct SemanticSearchAdapter 

pub struct SemanticSearchAdapter { /* private fields */ }

Adapter for sparc-style semantic file search.

sparc needs to locate relevant source files given a natural-language query string. This adapter stores one embedding per file (derived externally, e.g. from an ONNX all-MiniLM model) and retrieves the closest matches using HNSW approximate nearest-neighbour search.

Example

use ruvector_core::integration::SemanticSearchAdapter;

let mut adapter = SemanticSearchAdapter::new(384, "./sparc_index.db").unwrap();

// Index source files (embeddings produced by your embedding pipeline)
adapter.index_file("src/auth/service.rs", "authentication service", &[0.0f32; 384]).unwrap();
adapter.index_file("src/user/model.rs", "user data model", &[0.1f32; 384]).unwrap();

// Query with a natural-language description
let results = adapter.search("jwt token validation", &[0.05f32; 384], 5).unwrap();
for r in results {
    println!("  {} (score={:.4})", r.id, r.score);
}

Implementations

impl SemanticSearchAdapter

pub fn new(dimensions: usize, storage_path: impl Into<String>) -> Result<Self>

Create a new adapter.

dimensions is the embedding dimension of your model (e.g. 384 for all-MiniLM-L6-v2, 768 for BERT-base).

pub fn index_file( &self, path: impl Into<String>, description: impl Into<String>, embedding: &[f32], ) -> Result<String>

Index a source file.

The file path is used as the vector ID so look-ups are O(1). description is stored in metadata for debugging / display. embedding must have the same length as the adapter’s dimensions.

pub fn remove_file(&self, path: &str) -> Result<bool>

Remove a previously indexed file.

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

Search for source files semantically related to query_embedding.

Returns up to k results sorted by ascending cosine distance (most relevant first). Each SearchResult has .id set to the file path and .metadata containing the description.

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

Total number of indexed files.

pub fn is_empty(&self) -> Result<bool>

Returns true if no files have been indexed yet.

pub fn list_files(&self) -> Result<Vec<String>>

List all indexed file paths.