Struct SpreadingActivationConfig 

pub struct SpreadingActivationConfig {
    pub enabled: bool,
    pub decay_lambda: f32,
    pub max_hops: u32,
    pub activation_threshold: f32,
    pub inhibition_threshold: f32,
    pub max_activated_nodes: usize,
    pub seed_structural_weight: f32,
    pub seed_community_cap: usize,
    pub recall_timeout_ms: u64,
}

Configuration for SYNAPSE spreading activation retrieval over the entity graph.

When enabled = true, spreading activation replaces BFS-based graph recall. Seeds are initialized from fuzzy entity matches, then activation propagates hop-by-hop with exponential decay and lateral inhibition.

Validation

Constraints enforced at deserialization time:

• 0.0 < decay_lambda <= 1.0
• max_hops >= 1
• activation_threshold < inhibition_threshold
• recall_timeout_ms >= 1 (clamped to 100 with a warning if set to 0)

Fields

enabled: bool

Enable spreading activation (replaces BFS in graph recall when true). Default: false.

decay_lambda: f32

Per-hop activation decay factor. Range: (0.0, 1.0]. Default: 0.85.

max_hops: u32

Maximum propagation depth. Must be >= 1. Default: 3.

activation_threshold: f32

Minimum activation score to include a node in results. Default: 0.1.

inhibition_threshold: f32

Activation level at which a node stops receiving more activation. Default: 0.8.

max_activated_nodes: usize

Cap on total activated nodes per spread pass. Default: 50.

seed_structural_weight: f32

Weight of structural score in hybrid seed ranking. Range: [0.0, 1.0]. Default: 0.4.

seed_community_cap: usize

Maximum seeds per community. 0 = unlimited. Default: 3.

recall_timeout_ms: u64

Timeout in milliseconds for a single spreading activation recall call. Default: 1000. Values below 1 are clamped to 100ms at runtime. Benchmark data shows FTS5 + graph traversal completes within 200–400ms; 1000ms provides headroom for cold caches.

Implementations

impl SpreadingActivationConfig

pub fn validate(&self) -> Result<(), String>

Validate cross-field constraints that cannot be expressed in per-field validators.

Errors

Returns an error string if activation_threshold >= inhibition_threshold.

Trait Implementations

impl Clone for SpreadingActivationConfig

fn clone(&self) -> SpreadingActivationConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SpreadingActivationConfig

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

Formats the value using the given formatter.

impl Default for SpreadingActivationConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SpreadingActivationConfig

where SpreadingActivationConfig: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SpreadingActivationConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.