behaviorsim-rs 0.7.0

Domain-agnostic specification for modeling individual psychology and social dynamics
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

//! Memory subsystem for behavioral pathways.
//!
//! This module provides memory storage, retrieval, and management for entities.
//! Memories are organized into four layers with different capacities and time
//! horizons:
//!
//! - **Immediate**: 10 entries, minutes-hours horizon
//! - **Short-term**: 20 entries, days-weeks horizon
//! - **Long-term**: 50 entries, months-years horizon
//! - **Legacy**: Unlimited, milestone-triggered
//!
//! # Key Types
//!
//! - [`MemoryEntry`] - A single memory with emotional context and metadata
//! - [`MemoryLayers`] - Container organizing memories by temporal layer
//! - [`MemoryLayer`] - Enum specifying which layer to operate on
//! - [`EmotionalSnapshot`] - Frozen PAD values at memory formation
//! - [`MemorySource`] - How the entity learned about an event
//! - [`MemoryTag`] - Categorization tags for retrieval
//!
//! # Retrieval Methods
//!
//! MemoryLayers provides several retrieval methods:
//!
//! - `retrieve_by_salience(threshold)` - Memories above salience threshold
//! - `retrieve_mood_congruent(mood, min_congruence)` - Mood-matching memories
//! - `retrieve_by_tag(tag)` - Memories with specific tag
//! - `retrieve_by_participant(entity_id)` - Memories involving entity
//! - `retrieve_by_context(microsystem_id)` - Memories from context
//!

mod consolidation;
mod emotional_snapshot;
mod event_tags;
mod from_event;
mod layers;
mod memory_entry;
mod retrieval;
mod source;
mod tags;

pub use consolidation::{apply_memory_consolidation, compute_priming_deltas, PrimingDeltas};
pub use event_tags::derive_tags_from_impacts;
pub use from_event::create_memory_from_event;
pub use emotional_snapshot::EmotionalSnapshot;
pub use layers::{
    MemoryLayer, MemoryLayers, IMMEDIATE_CAPACITY, LONG_TERM_CAPACITY, SHORT_TERM_CAPACITY,
};
pub use memory_entry::MemoryEntry;
pub use retrieval::{
    compute_retrieval_score, RetrievalQuery, DEFAULT_SALIENCE_HALF_LIFE_DAYS, WEIGHT_BASE_SCORE,
    WEIGHT_CONTEXT_CONGRUENCE, WEIGHT_MOOD_CONGRUENCE, WEIGHT_PARTICIPANT_MATCH, WEIGHT_RECENCY,
    WEIGHT_SALIENCE, WEIGHT_SOURCE_CONFIDENCE, WEIGHT_TAG_RELEVANCE,
};
pub use source::MemorySource;
pub use tags::MemoryTag;