Struct RetrievalQuery 

pub struct RetrievalQuery {
    pub text: String,
    pub architecture: Option<ArchitectureFingerprint>,
    pub now: DateTime<Utc>,
    pub half_life_days: f64,
    pub embedding: Option<(String, Vec<f32>)>,
    pub limit: usize,
    pub research_line: Option<String>,
    pub tags: Vec<String>,
}

What to retrieve, and what to measure it against.

Fields

text: String

Free text. Empty is allowed: the other three terms still rank.

architecture: Option<ArchitectureFingerprint>

Architecture to compare against, when the caller has one.

now: DateTime<Utc>

Reference time for recency. A parameter, not Utc::now(), so ranking is reproducible.

half_life_days: f64

Recency half-life in days; DEFAULT_HALF_LIFE_DAYS unless set.

embedding: Option<(String, Vec<f32>)>

Query vector, from the same embedder that produced the records’. When present, it blends into the lexical term for records carrying a vector from the same model.

limit: usize

Maximum number of results returned.

research_line: Option<String>

Restrict to one research line.

tags: Vec<String>

Every listed tag must be present.

Implementations

impl RetrievalQuery

pub fn new(text: impl Into<String>, now: DateTime<Utc>) -> Self

A text query against now, with the default half-life.

pub fn with_architecture(self, architecture: ArchitectureFingerprint) -> Self

Compare candidates structurally against this fingerprint, activating the structural term.

pub fn with_limit(self, limit: usize) -> Self

Cap the number of results.

pub fn in_line(self, line: impl Into<String>) -> Self

Restrict candidates to one research line, before scoring.

pub fn with_tags(self, tags: Vec<String>) -> Self

Require every listed tag on a candidate, before scoring.

Trait Implementations

impl Clone for RetrievalQuery

fn clone(&self) -> RetrievalQuery

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RetrievalQuery

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

Formats the value using the given formatter.