made-core 0.1.5

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

//! [`DeliberationOutcome`] — the terminal result of a deliberation run.

/// The terminal result of a deliberation that ran to completion.
///
/// A deliberation that reaches its end lands in exactly one of these:
/// either a winning proposal was selected, or — under an output
/// contract — every proposal was generated but none satisfied it.
///
/// Adapter-shaped aborts (an agent or validator returning `Err`) are
/// deliberately **not** outcomes: they surface as [`DomainError`]s and as
/// dedicated error counters (the judge/provider `*_errors_total` families).
/// Keeping this enum to the two genuine end-states keeps the `outcome`
/// metric label low-cardinality and meaningful.
///
/// [`DomainError`]: crate::error::DomainError
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub enum DeliberationOutcome {
    /// A winning proposal was selected and returned to the caller.
    Success,
    /// An output contract was in force but no proposal satisfied it.
    NoValidProposal,
}

impl DeliberationOutcome {
    /// Stable, low-cardinality label value for metrics exposition.
    ///
    /// The strings are part of the metric contract; downstream
    /// dashboards and alerts match on them, so they must not change.
    #[must_use]
    pub const fn as_label(self) -> &'static str {
        match self {
            Self::Success => "success",
            Self::NoValidProposal => "no_valid_proposal",
        }
    }
}

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

    #[test]
    fn labels_are_stable_and_distinct() {
        assert_eq!(DeliberationOutcome::Success.as_label(), "success");
        assert_eq!(
            DeliberationOutcome::NoValidProposal.as_label(),
            "no_valid_proposal"
        );
        assert_ne!(
            DeliberationOutcome::Success.as_label(),
            DeliberationOutcome::NoValidProposal.as_label()
        );
    }
}