Skip to main content

qualia_core_db/tensor/
manifold.rs

1//! Manifold bifurcation (w) for multi-head attention
2
3use serde::{Deserialize, Serialize};
4
5/// Manifold domain variants (ยง2.1)
6#[repr(C)]
7#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
8pub enum ManifoldDomain {
9    /// Biological/Medical
10    Medical = 0,
11    /// Legal/Jurisdictional
12    Legal = 1,
13    /// Personal/Agency
14    Personal = 2,
15    /// Environmental/Sensor
16    Environmental = 3,
17    /// Socioeconomic/Wellbeing
18    Socioeconomic = 4,
19    /// Mechanical/Structural Engineering
20    MechanicalStructural = 5,
21    /// Electromagnetic/Optical Physics
22    ElectromagneticOptical = 6,
23    /// Acoustic/Wavefield Dynamics
24    AcousticWavefield = 7,
25    /// Chemical/Molecular Chemistry
26    ChemicalMolecular = 8,
27    /// Astrophysical/Cosmological Space
28    AstrophysicalCosmological = 9,
29    /// Quantum/Subatomic Scale
30    QuantumSubatomic = 10,
31    /// Botanical/Ecological Systems
32    BotanicalEcological = 11,
33    /// Zoological/Ethological Animal Behavior
34    ZoologicalEthological = 12,
35}
36
37impl Default for ManifoldDomain {
38    fn default() -> Self {
39        ManifoldDomain::Medical
40    }
41}
42
43impl ManifoldDomain {
44    /// Builds `ManifoldDomain` from `index`.
45    pub fn from_index(index: f32) -> Self {
46        match index.round() as u32 {
47            0 => ManifoldDomain::Medical,
48            1 => ManifoldDomain::Legal,
49            2 => ManifoldDomain::Personal,
50            3 => ManifoldDomain::Environmental,
51            4 => ManifoldDomain::Socioeconomic,
52            5 => ManifoldDomain::MechanicalStructural,
53            6 => ManifoldDomain::ElectromagneticOptical,
54            7 => ManifoldDomain::AcousticWavefield,
55            8 => ManifoldDomain::ChemicalMolecular,
56            9 => ManifoldDomain::AstrophysicalCosmological,
57            10 => ManifoldDomain::QuantumSubatomic,
58            11 => ManifoldDomain::BotanicalEcological,
59            12 => ManifoldDomain::ZoologicalEthological,
60            _ => ManifoldDomain::Medical, // Default fallback
61        }
62    }
63
64    /// Converts to `index`.
65    pub fn to_index(&self) -> f32 {
66        *self as u32 as f32
67    }
68
69    /// Semantic domain string label.
70    pub fn domain_label(&self) -> &'static str {
71        match self {
72            ManifoldDomain::Medical => "Medical",
73            ManifoldDomain::Legal => "Legal",
74            ManifoldDomain::Personal => "Personal",
75            ManifoldDomain::Environmental => "Environmental",
76            ManifoldDomain::Socioeconomic => "Socioeconomic",
77            ManifoldDomain::MechanicalStructural => "MechanicalStructural",
78            ManifoldDomain::ElectromagneticOptical => "ElectromagneticOptical",
79            ManifoldDomain::AcousticWavefield => "AcousticWavefield",
80            ManifoldDomain::ChemicalMolecular => "ChemicalMolecular",
81            ManifoldDomain::AstrophysicalCosmological => "AstrophysicalCosmological",
82            ManifoldDomain::QuantumSubatomic => "QuantumSubatomic",
83            ManifoldDomain::BotanicalEcological => "BotanicalEcological",
84            ManifoldDomain::ZoologicalEthological => "ZoologicalEthological",
85        }
86    }
87}
88
89#[cfg(test)]
90mod tests {
91    use super::*;
92
93    #[test]
94    fn test_all_thirteen_domains_round_trip() {
95        let expected_domains = [
96            (0, ManifoldDomain::Medical, "Medical"),
97            (1, ManifoldDomain::Legal, "Legal"),
98            (2, ManifoldDomain::Personal, "Personal"),
99            (3, ManifoldDomain::Environmental, "Environmental"),
100            (4, ManifoldDomain::Socioeconomic, "Socioeconomic"),
101            (5, ManifoldDomain::MechanicalStructural, "MechanicalStructural"),
102            (6, ManifoldDomain::ElectromagneticOptical, "ElectromagneticOptical"),
103            (7, ManifoldDomain::AcousticWavefield, "AcousticWavefield"),
104            (8, ManifoldDomain::ChemicalMolecular, "ChemicalMolecular"),
105            (9, ManifoldDomain::AstrophysicalCosmological, "AstrophysicalCosmological"),
106            (10, ManifoldDomain::QuantumSubatomic, "QuantumSubatomic"),
107            (11, ManifoldDomain::BotanicalEcological, "BotanicalEcological"),
108            (12, ManifoldDomain::ZoologicalEthological, "ZoologicalEthological"),
109        ];
110
111        for (idx, domain, label) in expected_domains {
112            assert_eq!(domain as u32, idx as u32);
113            assert_eq!(domain.to_index(), idx as f32);
114            assert_eq!(ManifoldDomain::from_index(idx as f32), domain);
115            assert_eq!(domain.domain_label(), label);
116        }
117
118        // Test fallback
119        assert_eq!(ManifoldDomain::from_index(99.0), ManifoldDomain::Medical);
120    }
121}