Struct ReflectHooks 

pub struct ReflectHooks<'a> {
    pub pre_reflect: Option<Box<dyn Fn(&ReflectInput) -> ReflectHookDecision + Send + Sync + 'a>>,
    pub post_reflect: Option<Box<dyn Fn(&ReflectOutcome) + Send + Sync + 'a>>,
    pub active_keypair: Option<&'a AgentKeypair>,
}

v0.7.0 recursive-learning Task 6/8 — optional in-substrate hook callbacks fired by reflect_with_hooks. Bundled into a single struct so the substrate signature stays compact and so future callbacks (e.g. on-rollback) can land without churning every call site.

Both callbacks are Option<...>; when None, the substrate behaves identically to the unhooked reflect entry-point. The callback type is Box<dyn Fn(...)> so the substrate stays allocator-friendly (one allocation per reflect call) and so test code can pass simple closures that capture observation state.

Fields

pre_reflect: Option<Box<dyn Fn(&ReflectInput) -> ReflectHookDecision + Send + Sync + 'a>>

Fired BEFORE the cap check (step 4 of reflect). Receives a read-only view of the in-flight ReflectInput (the substrate-side equivalent of crate::hooks::events::ReflectDelta — the in-process callback gets the typed input directly, while the cross-process wire path serialises a ReflectDelta). Returns ReflectHookDecision::Deny to veto.

post_reflect: Option<Box<dyn Fn(&ReflectOutcome) + Send + Sync + 'a>>

Fired AFTER the transaction commits (step 7 of reflect). Receives a read-only snapshot of the post-commit outcome (mirrors crate::hooks::events::ReflectResult). Notify-class — return value is ignored; the reflect already landed.

active_keypair: Option<&'a AgentKeypair>

Issue #815 — signing keypair for the reflects_on edges written inside the reflect transaction. When Some, each edge is persisted via create_link_signed with this keypair, producing attest_level='self_signed' rows with a 64-byte Ed25519 signature. When None, edges land as attest_level='unsigned' — the v0.6.x behaviour and the state of the world before #815 fixed the storage::reflect gap that #814 left behind.

Implementations

impl<'a> ReflectHooks<'a>

pub fn empty() -> Self

Empty bundle — both callbacks None, no signing keypair. The default used by callers that don’t want to register hooks AND don’t have a keypair to sign with (test harnesses, the thin reflect shim that preserves pre-#815 behaviour).

Trait Implementations

impl<'a> Debug for ReflectHooks<'a>

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

Formats the value using the given formatter.

impl<'a> Default for ReflectHooks<'a>

fn default() -> Self

Returns the “default value” for a type.