bhava 2.0.0

Emotion and personality engine — trait spectrums, mood vectors, archetypes, behavioral mapping
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
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86

use serde::{Deserialize, Serialize};

use super::types::MoodVector;

// --- Plutchik Compound Emotions ---

/// Named compound emotion from Plutchik's wheel.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
#[non_exhaustive]
pub enum CompoundEmotion {
    Love,           // Joy + Trust
    Optimism,       // Joy + Anticipation (mapped via Interest)
    Submission,     // Trust + Fear (mapped via low Dominance)
    Awe,            // Fear + Surprise (mapped via Arousal)
    Remorse,        // Sadness + Disgust (mapped via negative Joy + Frustration)
    Contempt,       // Anger + Disgust (mapped via Frustration)
    Aggressiveness, // Anger + Anticipation (mapped via Frustration + Interest)
}

impl std::fmt::Display for CompoundEmotion {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        let s = match self {
            Self::Love => "love",
            Self::Optimism => "optimism",
            Self::Submission => "submission",
            Self::Awe => "awe",
            Self::Remorse => "remorse",
            Self::Contempt => "contempt",
            Self::Aggressiveness => "aggressiveness",
        };
        f.write_str(s)
    }
}

/// Detect compound emotions present in a mood vector.
///
/// Returns all compound emotions whose constituent dimensions exceed the threshold.
#[cfg_attr(feature = "tracing", tracing::instrument(skip_all))]
#[must_use]
pub fn detect_compound_emotions(mood: &MoodVector, threshold: f32) -> Vec<(CompoundEmotion, f32)> {
    let t = threshold;
    let mut results = Vec::new();

    // Love: Joy + Trust
    if mood.joy > t && mood.trust > t {
        results.push((CompoundEmotion::Love, (mood.joy + mood.trust) / 2.0));
    }
    // Optimism: Joy + Interest (anticipation proxy)
    if mood.joy > t && mood.interest > t {
        results.push((CompoundEmotion::Optimism, (mood.joy + mood.interest) / 2.0));
    }
    // Submission: Trust + low Dominance (fear proxy)
    if mood.trust > t && mood.dominance < -t {
        results.push((
            CompoundEmotion::Submission,
            (mood.trust - mood.dominance) / 2.0,
        ));
    }
    // Awe: low Dominance + high Arousal (fear + surprise)
    if mood.dominance < -t && mood.arousal > t {
        results.push((CompoundEmotion::Awe, (-mood.dominance + mood.arousal) / 2.0));
    }
    // Remorse: negative Joy + Frustration
    if mood.joy < -t && mood.frustration > t {
        results.push((
            CompoundEmotion::Remorse,
            (-mood.joy + mood.frustration) / 2.0,
        ));
    }
    // Contempt: Frustration + negative Trust
    if mood.frustration > t && mood.trust < -t {
        results.push((
            CompoundEmotion::Contempt,
            (mood.frustration - mood.trust) / 2.0,
        ));
    }
    // Aggressiveness: Frustration + Interest (anger + anticipation)
    if mood.frustration > t && mood.interest > t {
        results.push((
            CompoundEmotion::Aggressiveness,
            (mood.frustration + mood.interest) / 2.0,
        ));
    }

    results
}