Struct FtsStore 

pub struct FtsStore { /* private fields */ }

Full-text search store using Tantivy

Single connection type that supports both read and write operations. Writer is lazy-initialized on first write to avoid unnecessary locks.

Implementations

impl FtsStore

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

Create or open an FTS index at the given path.

Opens in a mode that supports both reading and writing. Writer is lazy-initialized on first write operation.

pub fn new_with_writer(db_path: &Path) -> Result<Self>

Create or open an FTS index with writer ready for indexing.

Use this when you know you’ll be writing immediately (e.g., during indexing). For search-only or mixed workloads, use new() instead.

pub fn add_chunk( &mut self, chunk_id: u32, content: &str, path: &str, signature: Option<&str>, kind: &str, ) -> Result<()>

Add a chunk to the FTS index

Includes writer recovery: if the writer was killed (e.g., by a background merge thread panic), it will be recreated and the operation retried once.

pub fn delete_chunk(&mut self, chunk_id: u32) -> Result<()>

Delete a chunk by ID

pub fn delete_by_path(&mut self, path: &str) -> Result<()>

Delete all chunks for a file path

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

Commit pending changes with retry logic for Windows file locking.

If the writer was killed (background merge panic), it is recreated. Data since the last successful commit will be lost in that case, but indexing can continue rather than aborting entirely.

pub fn search( &self, query: &str, limit: usize, target_kind: Option<ChunkKind>, ) -> Result<Vec<FtsResult>>

Search using BM25

If target_kind is provided, boosts results matching that ChunkKind (e.g., “class”, “function”).

pub fn search_exact( &self, identifier: &str, limit: usize, target_kind: Option<ChunkKind>, ) -> Result<Vec<FtsResult>>

Search for exact identifier matches (boosted)

Used for improving exact name matching (e.g., “BaseRestClient”, “UserService”).

If target_kind is provided, uses selective boosting:

• When both identifier AND kind are present, applies MUST constraint: items must match the identifier in the signature field AND the kind (prevents boosting ALL items of that kind)
• Otherwise, uses standard boost on the kind field

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

Get statistics about the index

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

Clear the entire index