made-core 0.8.0

Domain core of MADE: entities, value objects, events, ports. No IO.
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

use serde::{Deserialize, Serialize};

use crate::value_objects::{AgenticSystemExecutionId, CeremonyId};

use super::IntegratorScopeKey;

/// What an integrator is bound to.
///
/// One ceremony, or one execution of a composed system that owns
/// several. The second exists so an integrator driving a system is
/// woken once for the whole of it instead of once per ceremony.
#[derive(Debug, Clone, PartialEq, Eq, PartialOrd, Ord, Hash, Serialize, Deserialize)]
#[serde(tag = "kind", rename_all = "snake_case")]
pub enum IntegratorScope {
    Ceremony {
        ceremony_id: CeremonyId,
    },
    SystemExecution {
        system_execution_id: AgenticSystemExecutionId,
    },
}

impl IntegratorScope {
    #[must_use]
    pub const fn ceremony(ceremony_id: CeremonyId) -> Self {
        Self::Ceremony { ceremony_id }
    }

    #[must_use]
    pub const fn system_execution(system_execution_id: AgenticSystemExecutionId) -> Self {
        Self::SystemExecution {
            system_execution_id,
        }
    }

    /// The stable spelling this scope is stored under.
    #[must_use]
    pub fn scope_key(&self) -> IntegratorScopeKey {
        IntegratorScopeKey::new(match self {
            Self::Ceremony { ceremony_id } => format!("ceremony:{ceremony_id}"),
            Self::SystemExecution {
                system_execution_id,
            } => format!("system_execution:{system_execution_id}"),
        })
    }

    /// The ceremony this scope names, when it names one.
    #[must_use]
    pub const fn ceremony_id(&self) -> Option<&CeremonyId> {
        match self {
            Self::Ceremony { ceremony_id } => Some(ceremony_id),
            Self::SystemExecution { .. } => None,
        }
    }

    /// The system execution this scope names, when it names one.
    #[must_use]
    pub const fn system_execution_id(&self) -> Option<&AgenticSystemExecutionId> {
        match self {
            Self::SystemExecution {
                system_execution_id,
            } => Some(system_execution_id),
            Self::Ceremony { .. } => None,
        }
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn the_two_scopes_never_share_a_key() {
        let ceremony = IntegratorScope::ceremony(CeremonyId::new("c-1").unwrap());
        let execution =
            IntegratorScope::system_execution(AgenticSystemExecutionId::new("c-1").unwrap());
        assert_ne!(ceremony.scope_key(), execution.scope_key());
        assert_eq!(ceremony.scope_key().as_str(), "ceremony:c-1");
    }
}