Enum FusionStrategy 

pub enum FusionStrategy {
    Rrf {
        k: usize,
    },
    Weighted {
        weights: Vec<f64>,
    },
    WeightedRrf {
        k: usize,
        weights: Vec<f64>,
    },
    Union,
    VectorOnly,
    KeywordOnly,
    Custom {
        name: String,
        params: Value,
    },
}

Validated selection for combining ranked result lists.

See crates/khive-fusion/docs/api/strategy-validation.md.

Variants

Rrf

Reciprocal Rank Fusion (default, recommended). Rank-based, distribution-agnostic.

Fields

k: usize

Smoothing constant (>= 1). Default: 60.

Weighted

Weighted linear combination of scores. Weights normalized to 1.0; must be finite.

Fields

weights: Vec<f64>

Weights for each source (will be normalized). Must be finite.

WeightedRrf

Weighted Reciprocal Rank Fusion over ordered sources. Weights are not normalized.

Fields

k: usize

Smoothing constant (>= 1).

weights: Vec<f64>

One finite, strictly positive weight for each ordered source.

Union

Take union with max score per ID.

VectorOnly

Skip BM25 entirely – return only vector (HNSW) results.

KeywordOnly

Skip HNSW entirely – return only BM25 keyword results.

Custom

Pack-defined or user-defined custom strategy dispatched by name at runtime.

Fields

name: String

Strategy identifier registered with the fusion executor registry.

params: Value

Opaque parameters consumed by the executor.

Implementations

impl FusionStrategy

pub fn rrf() -> FusionStrategy

Create an RRF strategy with default k=60.

pub fn try_rrf(k: usize) -> Result<FusionStrategy, FusionStrategyError>

Create an RRF strategy, returning FusionStrategyError::RrfKZero for zero.

pub fn rrf_with_k(k: usize) -> FusionStrategy

Create an RRF strategy, clamping k to at least 1.

Prefer try_rrf at public API boundaries.

pub fn try_weighted( weights: Vec<f64>, ) -> Result<FusionStrategy, FusionStrategyError>

Create weighted fusion, returning an error for NaN or infinite weights.

pub fn weighted(weights: Vec<f64>) -> FusionStrategy

Create a weighted strategy. Panics on NaN/infinity.

Prefer try_weighted at public API boundaries.

pub fn try_weighted_rrf( k: usize, weights: Vec<f64>, ) -> Result<FusionStrategy, FusionStrategyError>

Create weighted reciprocal rank fusion, rejecting zero k and weights that are non-finite or not strictly positive. Source-count validation happens when the strategy is fused because a strategy does not carry its source lists.

pub fn weighted_rrf(k: usize, weights: Vec<f64>) -> FusionStrategy

Create weighted reciprocal rank fusion. Panics on zero k or invalid weights.

Prefer try_weighted_rrf at public API boundaries.

pub fn union() -> FusionStrategy

Create a union strategy.

pub fn try_custom( name: String, params: Value, ) -> Result<FusionStrategy, FusionStrategyError>

Create a runtime-dispatched custom strategy, rejecting an empty name.

Trait Implementations

impl Clone for FusionStrategy

fn clone(&self) -> FusionStrategy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FusionStrategy

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

Formats the value using the given formatter.

impl Default for FusionStrategy

fn default() -> FusionStrategy

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for FusionStrategy

fn deserialize<D>( deserializer: D, ) -> Result<FusionStrategy, <D as Deserializer<'de>>::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for FusionStrategy

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for FusionStrategy

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for FusionStrategy

impl TryFrom<RawFusionStrategy> for FusionStrategy

type Error = FusionStrategyError

The type returned in the event of a conversion error.

fn try_from( raw: RawFusionStrategy, ) -> Result<FusionStrategy, <FusionStrategy as TryFrom<RawFusionStrategy>>::Error>

Performs the conversion.