Struct NavigateSpec 

pub struct NavigateSpec { /* private fields */ }

Parameters for graph-expanded vector retrieval (ADD task ft-navigate-recall, contract v1). Maps to Moon’s FT.NAVIGATE ... HOPS <n> [HOP_PENALTY <p>] [DECAY <λ>].

Fields are PRIVATE — validity by construction. hops is bounded to 1..=5 (Moon’s MAX_EXPAND_DEPTH); hop_penalty must be finite ≥ 0.

Note: FT.NAVIGATE DECAY has no time-weight slot (the server fixes time_weight = 1.0); a GraphDecay carrying time_weight sends only its λ on the navigate wire — time_weight is a GRAPH.QUERY-only knob.

Implementations

impl NavigateSpec

pub const MAX_HOPS: u32 = 5

Maximum hop depth Moon’s graph expansion accepts (MAX_EXPAND_DEPTH).

pub fn new(hops: u32) -> Result<NavigateSpec, StorageError>

Construct with a hop depth. Accepts 1..=5 only — 0 hops is plain vector search (use vector_search), >5 is rejected by Moon anyway.

pub fn with_hop_penalty(self, p: f64) -> Result<NavigateSpec, StorageError>

Set the per-hop score penalty (server default 0.1 when unset). Accepts finite p ≥ 0 (0 ranks graph hits purely by decay/vec score).

pub fn with_decay(self, decay: GraphDecay) -> NavigateSpec

Apply recency decay to the discovery edge of each graph-expanded hit. Infallible — GraphDecay is already validated by construction.

pub fn hops(&self) -> u32

The hop depth (1..=5).

pub fn hop_penalty(&self) -> Option<f64>

The per-hop penalty, if set (finite, ≥ 0).

pub fn decay(&self) -> Option<GraphDecay>

The recency decay, if set.

Trait Implementations

impl Clone for NavigateSpec

fn clone(&self) -> NavigateSpec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for NavigateSpec

impl Debug for NavigateSpec

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

Formats the value using the given formatter.

impl PartialEq for NavigateSpec

fn eq(&self, other: &NavigateSpec) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for NavigateSpec