Struct FilteredVectorSearch 

pub struct FilteredVectorSearch { /* private fields */ }

A vector search restricted to the nodes a traversal reaches (§5.3).

Mirrors TraversalBuilder, which is the crate’s established shape for a read with options. The strategy is chosen by the planner and not by the caller: D-007’s whole content is that the choice is arithmetic, and a parameter that lets a caller get it wrong would be a fidelity leak of the kind Doctrine VIII names. Self::strategy exists to force a strategy in tests — above all in the test that requires the two to agree.

Implementations

impl FilteredVectorSearch

pub fn new( model: ModelName, query: Vec<f32>, traversal: TraversalBuilder, ) -> Self

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

pub fn byte_budget(self, budget: usize) -> Self

pub fn probe_cap(self, cap: usize) -> Self

pub fn strategy(self, strategy: VectorFilterStrategy) -> Self

Force a strategy, bypassing the planner. For tests and diagnosis.

pub async fn execute_explained( &self, conn: &Connection, now_ts: &str, ) -> Result<(Vec<VectorSearchResult>, CostEstimate)>

Run the search, returning results and the plan that produced them.

The estimate comes back so a caller can log it against reality, which is D-007’s empirical-tuning requirement. execute is the same call with the plan dropped.

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

Run the search (§5.3).

Trait Implementations

impl Clone for FilteredVectorSearch

fn clone(&self) -> FilteredVectorSearch

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FilteredVectorSearch

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

Formats the value using the given formatter.