Struct SearchFilter 

pub struct SearchFilter {
    pub languages: Option<Vec<Language>>,
    pub chunk_types: Option<Vec<ChunkType>>,
    pub path_pattern: Option<String>,
    pub name_boost: f32,
    pub query_text: String,
    pub enable_rrf: bool,
    pub note_weight: f32,
    pub note_only: bool,
}

Filter and scoring options for search. Filter and scoring options for search.

Fields are public for direct construction via struct literals. Builder methods (SearchFilter::new(), SearchFilter::with_query()) are provided as convenience helpers for common patterns — both styles are supported and equivalent.

All fields are optional. Unset filters match all chunks. Use SearchFilter::validate() to check constraints before searching.

Fields

languages: Option<Vec<Language>>

Filter by programming language(s)

chunk_types: Option<Vec<ChunkType>>

Filter by chunk type(s) (function, method, class, struct, enum, trait, interface, constant)

path_pattern: Option<String>

Filter by file path glob pattern (e.g., src/**/*.rs)

name_boost: f32

Weight for name matching in hybrid search (0.0-1.0)

0.0 = pure embedding similarity (default) 1.0 = pure name matching 0.2 = recommended for balanced results

query_text: String

Query text for name matching (required if name_boost > 0 or enable_rrf)

enable_rrf: bool

Enable RRF (Reciprocal Rank Fusion) hybrid search

When enabled, combines semantic search results with FTS5 keyword search using the formula: score = Σ 1/(k + rank), where k=60. This typically improves recall for identifier-heavy queries.

note_weight: f32

Weight multiplier for note scores in unified search (0.0-1.0)

1.0 = notes scored equally with code (default) 0.5 = notes scored at half weight 0.0 = notes excluded from results

note_only: bool

When true, return only notes (skip code search entirely)

Implementations

impl SearchFilter

pub fn new() -> Self

Create a new SearchFilter with default values.

Use struct literal syntax to customize:

let filter = SearchFilter {
    languages: Some(vec![Language::Rust]),
    path_pattern: Some("src/**/*.rs".to_string()),
    query_text: "retry logic".to_string(),
    ..SearchFilter::new()
};

pub fn with_query(self, query: impl Into<String>) -> Self

Set the query text (required for name_boost > 0 or enable_rrf).

pub fn validate(&self) -> Result<(), &'static str>

Validate filter constraints

Returns Ok(()) if valid, or Err with description of what’s wrong.

Trait Implementations

impl Default for SearchFilter

fn default() -> Self

Returns the “default value” for a type.