Struct ActivationConfig 

pub struct ActivationConfig {
    pub decay_factor: f64,
    pub epsilon: f64,
    pub max_iterations: usize,
    pub max_depth: usize,
    pub inhibition_strength: f64,
    pub inhibition_threshold: f64,
    pub max_frontier_size: usize,
}

Activation configuration.

Fields

decay_factor: f64

Depth decay factor (default 0.7). Each layer multiplies activation by d.

epsilon: f64

Convergence threshold — nodes below this are excluded from results (default 0.01).

max_iterations: usize

Maximum propagation iterations (default 10). Acts as a secondary cap in addition to max_depth.

max_depth: usize

Maximum traversal depth from seed nodes (default 3).

inhibition_strength: f64

Lateral inhibition strength μ (default 0.1). Set to 0.0 to disable.

inhibition_threshold: f64

Cosine similarity threshold for lateral inhibition (default 0.7). Nodes with similarity above this to seeds but not graph-connected are suppressed.

max_frontier_size: usize

Hard safety cap on frontier size per depth level (default 10,000). When the frontier exceeds this limit, only the highest-scoring entries are kept. Prevents OOM/DoS from high-degree hub nodes (F-ENG-01).

Implementations

impl ActivationConfig

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

Validate graph activation bounds before execution.

pub const fn propagation_steps(&self) -> usize

pub fn tuned_for_graph( &self, node_count: usize, edge_count: usize, ) -> ActivationConfig

Return a copy of this config with max_frontier_size adaptively scaled to the observed graph density (F-103 fix).

The heuristic is:

• If the graph has no edges or no nodes, return self unchanged.
• Compute average out-degree = edge_count / node_count.
• effective = min(max_frontier_size, max(256, avg_degree * 100))

This caps the frontier relative to how dense the graph actually is, so a sparse graph doesn’t waste a 10 K buffer and a dense hub graph doesn’t build a 100 K BinaryHeap per depth step.

Trait Implementations

impl Clone for ActivationConfig

fn clone(&self) -> ActivationConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ActivationConfig

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

Formats the value using the given formatter.

impl Default for ActivationConfig

fn default() -> ActivationConfig

Returns the “default value” for a type.