Struct MemoryPack 

pub struct MemoryPack { /* private fields */ }

Pack implementation providing memory.remember and memory.recall verbs.

Implementations

impl MemoryPack

pub fn new(runtime: KhiveRuntime) -> Self

Create a new MemoryPack backed by the given runtime.

Trait Implementations

impl Pack for MemoryPack

const SCHEMA_PLAN: Option<PackSchemaPlan>

memory_ann_epoch (#812 review REQUEST CHANGES MEDIUM — pack schema contract): declared here instead of created inline on the epoch bump/read path, matching every other pack-auxiliary table in this codebase (ADR-028). Applied at boot by server.rs/serve.rs.

const NAME: &'static str = "memory"

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 HANDLERS: &'static [HandlerDef]

Handlers this pack registers.

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

Other pack names whose vocabulary this pack references.

const EDGE_RULES: &'static [EdgeEndpointRule] = _

Additional edge endpoint rules this pack contributes.

const NOTE_KIND_SPECS: &'static [NoteKindSpec] = _

Lifecycle and schema specs for note kinds this pack owns.

const VALIDATION_RULES: &'static [&'static str] = _

Validation rule IDs contributed by this pack.

impl PackRuntime for MemoryPack

fn register_note_mutation_hook(&self, _runtime: &KhiveRuntime)

#750 fix-round 1: install a note-mutation hook on the runtime THIS pack owns (self.runtime, not the _runtime param — mirrors KgPack::register_entity_type_validator’s multi-backend rationale: in a multi-backend deployment each pack is constructed with its own per-pack runtime, and self.runtime is always that one).

KG’s update/delete verbs reach KhiveRuntime::update_note/ delete_note with no dependency on khive-pack-memory at all. When those touch a kind="memory" note (content update, soft delete, or hard delete), this hook bumps the affected models’ write-generation counter (#750) and fires the same background warm memory.remember fires on its own write path (#791) — so ann::is_current() correctly treats the stale-but-still-installed index as behind, search_loaded keeps serving it in the meantime, and the background warm eventually installs a fresh one. This hook no longer clears the cache or deletes the persisted snapshot (see remember.rs’s #791 rationale).

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 handlers(&self) -> &'static [HandlerDef]

Handlers this pack registers — must equal <Self as Pack>::HANDLERS.

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

Pack names whose vocabulary this pack references. Defaults to empty so existing packs compile without changes.

fn schema_plan(&self) -> SchemaPlan

Pack-auxiliary schema.

fn warm<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = ()> + Send + 'async_trait>>

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

Warm up any in-memory state from persisted snapshots (optional).

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

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: '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.

fn note_kind_specs(&self) -> &'static [NoteKindSpec]

NoteKindSpec declarations for note kinds this pack owns.

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

Optional per-kind hook for shared CRUD specialization.

fn validation_rules(&self) -> &'static [ValidationRule]

Domain-specific validation rules contributed by this pack.

fn register_embedders(&self, _runtime: &KhiveRuntime)

Register custom embedding providers with the runtime.

fn register_entity_type_validator(&self, _runtime: &KhiveRuntime)

Install a pack-owned entity-type validator on the runtime.

impl PackTunable for MemoryPack

MemoryPack implements PackTunable so that the brain can adjust the recall scoring pipeline based on observed usage patterns (Issue #159).

Parameter names (memory::relevance_weight, memory::salience_weight, memory::temporal_weight) correspond to the three Beta posteriors in BalancedRecallState. Posterior means flow directly into RecallConfig.

project_config reads posterior means → RecallConfig. apply_config validates and stores the new config; future recall calls pick it up via MemoryPack::active_config().

fn project_config(&self, state: &BalancedRecallState) -> Value

Project the current BalancedRecallState posteriors into a RecallConfig value.

Reads the three posterior means from the profile state. Falls back to the current active config if a parameter is absent (brain not yet warmed up).

fn apply_config(&self, config: Value) -> Result<(), RuntimeError>

Apply a projected config to the pack.

Deserializes the JSON value into a RecallConfig, validates it, and stores it as the active config. Future recall calls pick up the new weights via MemoryPack::active_config().

fn parameter_space(&self) -> ParameterSpace