Module matrix_hook 

Matrix integration hook — trait for the optional matrix layer.

pe-graph defines MatrixHook as the extension point for convergence tracking and learned routing. pe-matrix provides the implementation; pe-runtime wires them together. pe-graph never depends on pe-matrix.

When no hook is provided, the Pregel engine handles NodeResult::Converge by applying the partial_update (degrading to Update) and uses the user’s conditional edge function for routing — unchanged from pre-matrix behavior.

Structs

DefaultMatrixHook

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

MatrixHookHandle

Wrapper around Arc<dyn MatrixHook> for ergonomic use in the engine.

Traits

ConvergenceRecorder

Trait for convergence tracking — implemented by pe-matrix ConvergenceTracker.

MatrixHook

Hook for the optional matrix layer.

RoutingResolver

Trait for routing resolution — implemented by pe-matrix MatrixRouter.