Struct DefaultMatrixHook 

pub struct DefaultMatrixHook<T: ConvergenceRecorder, R: RoutingResolver> { /* private fields */ }

Concrete implementation that bridges pe-matrix types into the hook trait.

Created by pe-runtime when wiring up the matrix layer. Uses Mutex for interior mutability since the BSP loop is sequential.

Thread safety assumption

This type assumes single-threaded sequential access within each BSP superstep. The Mutex satisfies the Sync bound but is never contended in practice. If a Mutex::lock() fails (poisoned), the hook silently returns defaults — this can only happen if the engine panics while holding the lock, which the BSP loop prevents.

Implementations

impl<T: ConvergenceRecorder, R: RoutingResolver> DefaultMatrixHook<T, R>

pub fn new(tracker: T, router: R) -> Self

Create a new hook from a tracker and router.

Trait Implementations

impl<T: ConvergenceRecorder, R: RoutingResolver> MatrixHook for DefaultMatrixHook<T, R>

fn on_converge( &self, _node_name: &str, actual_contribution: f64, surprise: f64, quality: f64, )

Called when a node returns NodeResult::Converge.

fn route(&self, from: &str, candidates: &[String]) -> Option<Vec<String>>

Resolve routing for a conditional edge using learned probabilities.

fn c_value(&self) -> f64

Current C value (aggregate confidence).

fn completion(&self) -> f64

Current completion estimate.

fn is_converged(&self) -> bool

Whether convergence threshold has been reached.

fn record_transition(&self, from: &str, to: &str, quality: f64)

Record that a transition occurred (for learning).