made-core 0.1.3

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

//! [`ExecutorPort`] — opaque execution of a winning proposal.
//!
//! After a deliberation produces a winner, the `Orchestrate` use case
//! optionally hands the proposal off to an executor (e.g. the Underpass
//! Runtime via gRPC, a local subprocess, a human-in-the-loop queue,
//! …). MADE does not know what execution means beyond
//! "adapter runs it and reports an outcome".

use async_trait::async_trait;
use serde::{Deserialize, Serialize};

use crate::entities::Proposal;
use crate::error::DomainError;
use crate::value_objects::{Attributes, DurationMs};

/// Result returned by an executor. Opaque `output` carried back for
/// the caller to surface.
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct ExecutionOutcome {
    pub execution_id: String,
    pub succeeded: bool,
    pub duration: DurationMs,
    pub output: Attributes,
}

#[async_trait]
pub trait ExecutorPort: Send + Sync {
    /// Execute the winning proposal. Adapters are free to block or
    /// stream, as long as the final outcome is returned.
    async fn execute(
        &self,
        winner: &Proposal,
        options: &Attributes,
    ) -> Result<ExecutionOutcome, DomainError>;
}