Struct NoteCandidate 

pub struct NoteCandidate {
    pub id: Uuid,
    pub rrf_score: Option<f64>,
    pub salience: f64,
    pub decay_factor: f64,
    pub age_days: f64,
    pub effective_salience: f64,
    pub rerank_scores: HashMap<String, f64>,
}

Pre-computed signals for a single memory note candidate.

Used by the recall pipeline’s ComposePipeline to score and rank candidates via DecayAwareSalienceObjective, TemporalRecencyObjective, and RerankerObjective without any IO. The runtime layer populates this struct from stored notes before handing the slice to the pipeline.

Fields

id: Uuid

Stable note UUID.

rrf_score: Option<f64>

Pre-fused RRF score from the retrieval stage (0.0–1.0).

salience: f64

Raw salience stored on the note (0.0–1.0).

decay_factor: f64

Per-note exponential decay rate (>= 0.0).

age_days: f64

Age of the note in days at query time.

effective_salience: f64

Salience after applying the configured DecayModel (pre-computed by the caller).

The caller must set this to DecayModel::apply(salience, age_days, decay_factor, half_life) so that objectives respect the configured decay model variant rather than always applying exponential decay. When not set, defaults to 0.0.

rerank_scores: HashMap<String, f64>

Per-reranker scores populated by the rerank stage. Keyed by reranker name (e.g. “cross_encoder”, “salience”, “graph_proximity”).

Trait Implementations

impl Clone for NoteCandidate

fn clone(&self) -> NoteCandidate

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NoteCandidate

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

Formats the value using the given formatter.

impl HasId for NoteCandidate

fn id(&self) -> Uuid

Returns the stable UUID identifier for this candidate.

impl Objective<NoteCandidate> for RrfFusionObjective

fn score(&self, candidate: &NoteCandidate, _context: &ObjectiveContext) -> f64

Evaluate a single candidate.

fn name(&self) -> &str

Get the name of this objective.

fn precision(&self, _candidate: &T, _context: &ObjectiveContext) -> f64

Precision (inverse variance) of the score estimate; default 1.0 (fully trusted).

fn passes_score(&self, score: f64, context: &ObjectiveContext) -> bool

Check if a score passes the threshold; non-finite scores never pass.

fn passes(&self, candidate: &T, context: &ObjectiveContext) -> bool

Check if a candidate passes the threshold.

fn batch_score( &self, candidates: &[T], context: &ObjectiveContext, ) -> Vec<(usize, f64)>

Score a batch of candidates and return passing (index, score) pairs.

fn select<'a>( &self, candidates: &'a [T], context: &ObjectiveContext, ) -> Vec<Selection<&'a T>>

Select all passing candidates in score-descending order.

fn select_top<'a>( &self, candidates: &'a [T], n: usize, context: &ObjectiveContext, ) -> Vec<Selection<&'a T>>

Select the top N candidates by precision-weighted score.

impl Objective<NoteCandidate> for DecayAwareSalienceObjective

fn score(&self, candidate: &NoteCandidate, _context: &ObjectiveContext) -> f64

Evaluate a single candidate.

fn name(&self) -> &str

Get the name of this objective.

fn precision(&self, _candidate: &T, _context: &ObjectiveContext) -> f64

Precision (inverse variance) of the score estimate; default 1.0 (fully trusted).

fn passes_score(&self, score: f64, context: &ObjectiveContext) -> bool

Check if a score passes the threshold; non-finite scores never pass.

fn passes(&self, candidate: &T, context: &ObjectiveContext) -> bool

Check if a candidate passes the threshold.

fn batch_score( &self, candidates: &[T], context: &ObjectiveContext, ) -> Vec<(usize, f64)>

Score a batch of candidates and return passing (index, score) pairs.

fn select<'a>( &self, candidates: &'a [T], context: &ObjectiveContext, ) -> Vec<Selection<&'a T>>

Select all passing candidates in score-descending order.

fn select_top<'a>( &self, candidates: &'a [T], n: usize, context: &ObjectiveContext, ) -> Vec<Selection<&'a T>>

Select the top N candidates by precision-weighted score.

impl Objective<NoteCandidate> for AmplifiedDecayAwareSalienceObjective

fn score(&self, candidate: &NoteCandidate, _context: &ObjectiveContext) -> f64

Evaluate a single candidate.

fn name(&self) -> &str

Get the name of this objective.

fn precision(&self, _candidate: &T, _context: &ObjectiveContext) -> f64

Precision (inverse variance) of the score estimate; default 1.0 (fully trusted).

fn passes_score(&self, score: f64, context: &ObjectiveContext) -> bool

Check if a score passes the threshold; non-finite scores never pass.

fn passes(&self, candidate: &T, context: &ObjectiveContext) -> bool

Check if a candidate passes the threshold.

fn batch_score( &self, candidates: &[T], context: &ObjectiveContext, ) -> Vec<(usize, f64)>

Score a batch of candidates and return passing (index, score) pairs.

fn select<'a>( &self, candidates: &'a [T], context: &ObjectiveContext, ) -> Vec<Selection<&'a T>>

Select all passing candidates in score-descending order.

fn select_top<'a>( &self, candidates: &'a [T], n: usize, context: &ObjectiveContext, ) -> Vec<Selection<&'a T>>

Select the top N candidates by precision-weighted score.

impl Objective<NoteCandidate> for TemporalRecencyObjective

fn score(&self, candidate: &NoteCandidate, _context: &ObjectiveContext) -> f64

Evaluate a single candidate.

fn name(&self) -> &str

Get the name of this objective.

fn precision(&self, _candidate: &T, _context: &ObjectiveContext) -> f64

Precision (inverse variance) of the score estimate; default 1.0 (fully trusted).

fn passes_score(&self, score: f64, context: &ObjectiveContext) -> bool

Check if a score passes the threshold; non-finite scores never pass.

fn passes(&self, candidate: &T, context: &ObjectiveContext) -> bool

Check if a candidate passes the threshold.

fn batch_score( &self, candidates: &[T], context: &ObjectiveContext, ) -> Vec<(usize, f64)>

Score a batch of candidates and return passing (index, score) pairs.

fn select<'a>( &self, candidates: &'a [T], context: &ObjectiveContext, ) -> Vec<Selection<&'a T>>

Select all passing candidates in score-descending order.

fn select_top<'a>( &self, candidates: &'a [T], n: usize, context: &ObjectiveContext, ) -> Vec<Selection<&'a T>>

Select the top N candidates by precision-weighted score.

impl Objective<NoteCandidate> for RerankerObjective

fn score(&self, candidate: &NoteCandidate, _context: &ObjectiveContext) -> f64

Evaluate a single candidate.

fn name(&self) -> &str

Get the name of this objective.

fn precision(&self, _candidate: &T, _context: &ObjectiveContext) -> f64

Precision (inverse variance) of the score estimate; default 1.0 (fully trusted).

fn passes_score(&self, score: f64, context: &ObjectiveContext) -> bool

Check if a score passes the threshold; non-finite scores never pass.

fn passes(&self, candidate: &T, context: &ObjectiveContext) -> bool

Check if a candidate passes the threshold.

fn batch_score( &self, candidates: &[T], context: &ObjectiveContext, ) -> Vec<(usize, f64)>

Score a batch of candidates and return passing (index, score) pairs.

fn select<'a>( &self, candidates: &'a [T], context: &ObjectiveContext, ) -> Vec<Selection<&'a T>>

Select all passing candidates in score-descending order.

fn select_top<'a>( &self, candidates: &'a [T], n: usize, context: &ObjectiveContext, ) -> Vec<Selection<&'a T>>

Select the top N candidates by precision-weighted score.