Struct BrainPack 

pub struct BrainPack { /* private fields */ }

Implementations

impl BrainPack

pub fn new(runtime: KhiveRuntime) -> Self

pub fn snapshot(&self) -> BrainStateSnapshot

Public snapshot of the current BrainState.

Equivalent to dispatching the brain.state verb but callable directly when you hold an Arc<BrainPack> (e.g. a test that registered the pack as a DispatchHook and wants to verify posteriors updated).

Trait Implementations

impl DispatchHook for BrainPack

BrainPack as a post-dispatch hook (Issue #158).

When registered via VerbRegistryBuilder::with_dispatch_hook, every successful verb dispatch calls on_dispatch with a synthesized Event. The event is fed into EventFold::step, updating the brain’s posteriors in real time — no polling required.

This is opt-in: the hook must be explicitly registered. Registries that do not load the brain pack are unaffected.

fn on_dispatch<'life0, 'life1, 'async_trait>( &'life0 self, event: &'life1 Event, ) -> Pin<Box<dyn Future<Output = ()> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Called with the dispatch-outcome event after a successful pack dispatch.

impl Pack for BrainPack

const NAME: &'static str = "brain"

Short identifier for this pack (e.g. “kg”, “tasks”).

const NOTE_KINDS: &'static [&'static str]

Note kinds this pack contributes to the runtime vocabulary.

const ENTITY_KINDS: &'static [&'static str]

Entity kinds this pack contributes to the runtime vocabulary.

const VERBS: &'static [VerbDef]

Verbs this pack handles. The runtime routes verb calls to the pack that declares them.

const REQUIRES: &'static [&'static str]

Other pack names whose vocabulary this pack references (ADR-037).

const EDGE_RULES: &'static [EdgeEndpointRule] = _

Additional edge endpoint rules this pack contributes (ADR-031).

impl PackRuntime for BrainPack

fn name(&self) -> &str

Pack name — must equal <Self as Pack>::NAME.

fn note_kinds(&self) -> &'static [&'static str]

Note kinds this pack owns — must equal <Self as Pack>::NOTE_KINDS.

fn entity_kinds(&self) -> &'static [&'static str]

Entity kinds this pack owns — must equal <Self as Pack>::ENTITY_KINDS.

fn verbs(&self) -> &'static [VerbDef]

Verbs this pack handles — must equal <Self as Pack>::VERBS.

fn requires(&self) -> &'static [&'static str]

Pack names whose vocabulary this pack references (ADR-037). Defaults to empty so existing packs compile without changes.

fn dispatch<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, verb: &'life1 str, params: Value, _registry: &'life2 VerbRegistry, ) -> Pin<Box<dyn Future<Output = Result<Value, RuntimeError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Dispatch a verb call. Returns serialized JSON response.

fn edge_rules(&self) -> &'static [EdgeEndpointRule]

Pack-extensible edge endpoint rules — must equal <Self as Pack>::EDGE_RULES. Defaults to empty so existing packs that don’t extend the edge contract can ignore it (ADR-031).

fn kind_hook(&self, _kind: &str) -> Option<Arc<dyn KindHook>>

Optional per-kind hook for shared CRUD specialization (ADR-030).