Struct HybridSearch 

pub struct HybridSearch { /* private fields */ }

A hybrid search over one model’s vectors and the concept-text index (§5.9).

Mirrors crate::graph::FilteredVectorSearch and TraversalBuilder, which is the crate’s shape for a read with options.

Implementations

impl HybridSearch

pub fn new( model: ModelName, query_text: impl Into<String>, query_vector: Vec<f32>, ) -> Self

query_text feeds the keyword arm, query_vector the vector arm. They are separate parameters because the crate does not embed text — that is the caller’s model, run in the caller’s process (Doctrine VII), and the two arms may legitimately be given different framings of one question.

pub fn top_k(self, k: usize) -> Self

pub fn depth(self, depth: usize) -> Self

How deep to read each arm before fusing. Defaults to max(5 × top_k, 50).

Fusing two top-k lists is not the same as the top k of the fusion: a document ranked 12th by both arms can outscore one ranked 1st by a single arm, and it is invisible if neither list was read past 10. Depth is what buys those, and it costs one larger LIMIT per arm rather than an extra round trip.

pub fn rrf_k(self, k: usize) -> Self

Override the RRF damping constant. See RRF_K.

pub fn raw_match(self, raw: bool) -> Self

Pass query_text to FTS5 verbatim instead of escaping it.

Opt-in, because it hands the caller’s string to a query language: a malformed expression becomes an engine error and NOT silently changes what was asked. Correct for a caller building the expression themselves; wrong for anything typed into a search box.

pub async fn execute(&self, conn: &Connection) -> Result<Vec<HybridHit>>

Run both arms and fuse them (§5.9).

Trait Implementations

impl Clone for HybridSearch

fn clone(&self) -> HybridSearch

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for HybridSearch

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.