Struct RetrievalOptions 

pub struct RetrievalOptions<'a> {
    pub top_k: Option<usize>,
    pub confidence_map: Option<&'a HashMap<String, f64>>,
    pub eligible_skill_ids: Option<&'a HashSet<String>>,
    pub age_days_map: Option<&'a HashMap<String, f32>>,
    pub target_file: Option<&'a str>,
    pub filter: Option<&'a QueryFilter>,
    pub ann_enabled: bool,
    pub embedding_timeout: Option<Duration>,
    pub cold_start_retry: bool,
    pub adaptive_prune: bool,
    pub trajectory: Option<&'a mut TrajectoryBuilder>,
}

Retrieve rules with confidence weighting plus hybrid FTS / embedding retrieval.

Retrieval options for confidence weighting, scoping, ANN usage, and trajectory telemetry. The default path matches plain retrieval: default top-k, no confidence map, no target-file cascade, no SQL metadata filter, ANN enabled, and no trajectory capture.

Fields

top_k: Option<usize>

confidence_map: Option<&'a HashMap<String, f64>>

eligible_skill_ids: Option<&'a HashSet<String>>

Optional allow-list applied before RRF fusion. Callers that already know the engine-eligible rule set can pass it here so disabled rules do not consume top-k score budget.

age_days_map: Option<&'a HashMap<String, f32>>

Iter-13 (2026-05-02). Per-skill age in days, used by the category-keyed half-life decay in effective_confidence. When None (or a chunk’s skill_id is absent from the map) the scoring site uses age_days = 0.0 — identical to the pre-plumbing behaviour, so no caller breaks if it doesn’t pass a map.

target_file: Option<&'a str>

filter: Option<&'a QueryFilter>

ann_enabled: bool

embedding_timeout: Option<Duration>

Optional provider-call budget for embedding the query. Latency- sensitive hook paths set this so a slow cloud embedder degrades to lexical retrieval instead of timing out the host agent’s hook.

cold_start_retry: bool

When true, a query embed that falls back to lexical because the base budget timed out on a healthy cloud lane is retried once with a longer cold-absorbing budget (see [COLD_RETRY_EMBEDDING_TIMEOUT]). Only the human-waiting CLI recall/search path sets this; the latency-critical hook/MCP paths leave it false so a cold provider never blocks the agent.

adaptive_prune: bool

When true, suppresses broad weak matches entirely. This is useful for unsolicited hook injection where “no extra context” is often better than five noisy rules. Explicit user/tool queries should leave this false so a search never looks broken just because the best match is weak.

trajectory: Option<&'a mut TrajectoryBuilder>

Trait Implementations

impl Default for RetrievalOptions<'_>

fn default() -> Self

Returns the “default value” for a type.