Struct RipvecIndex 

pub struct RipvecIndex { /* private fields */ }

Combined orchestrator for the ripvec retrieval pipeline.

Constructed via RipvecIndex::from_root which walks files, chunks them with ripvec’s chunker, embeds with the static encoder, and builds the BM25 index.

Implementations

impl RipvecIndex

pub fn from_root( root: &Path, encoder: StaticEncoder, cfg: &SearchConfig, profiler: &Profiler, pagerank_lookup: Option<HashMap<String, f32>>, pagerank_alpha: f32, ) -> Result<Self>

Build a RipvecIndex by walking root and indexing every supported file. Uses encoder.embed_root (ripvec’s chunker + model2vec encode) and builds a fresh BM25 index over the resulting chunks.

pagerank_lookup is the optional structural-prior map (file path → normalized PageRank) used by the final ranking layer; pass None to disable. pagerank_alpha is the corresponding boost strength.

Errors

Returns the underlying error if embed_root fails.

pub fn len(&self) -> usize

Number of indexed chunks.

pub fn is_empty(&self) -> bool

Whether the index has zero chunks.

pub fn chunks(&self) -> &[CodeChunk]

Indexed chunks (read-only access).

pub fn embeddings(&self) -> &[Vec<f32>]

Indexed embeddings (read-only access).

One row per chunk in the same order as chunks. Each row is L2-normalized, so cosine similarity reduces to a dot product. Used by callers that need to do their own similarity arithmetic outside the canonical hybrid search — find_similar (rank-by-source-embedding) and find_duplicates (all-pairs cosine).

pub fn search( &self, query: &str, top_k: usize, mode: SearchMode, alpha: Option<f32>, filter_languages: Option<&[String]>, filter_paths: Option<&[String]>, ) -> Vec<(usize, f32)>

Search the index and return ranked (chunk_index, score) pairs.

mode = SearchMode::Hybrid (default) fuses semantic + BM25 via RRF; Semantic and Keyword use one signal each.

filter_languages and filter_paths build a selector mask that restricts retrieval to chunks in the named files / languages.

Trait Implementations

impl SearchableIndex for RipvecIndex

fn search( &self, query_text: &str, top_k: usize, mode: SearchMode, ) -> Vec<(usize, f32)>

Trait-shape search: text-only, no engine-specific knobs.

The trait surface is the LSP-callers’ common ground. Filters (language, path) and the alpha auto-detect override are not surfaced through the trait because no LSP module uses them.

fn search_from_chunk( &self, chunk_idx: usize, query_text: &str, top_k: usize, mode: SearchMode, ) -> Vec<(usize, f32)>

Use chunk chunk_idx’s own embedding as the query vector and rank everything else by cosine similarity (semantic-only) or blend with BM25 (hybrid). Falls back to text-only keyword search when the chunk index is out of range.

Mirrors the [HybridIndex] equivalent so goto_definition and goto_implementation work identically across engines.

fn chunks(&self) -> &[CodeChunk]

Borrow the indexed chunks.