runx-runtime 0.6.19

Native Rust runtime for local runx execution, adapters, harness replay, receipts, and sandboxing.
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

use runx_contracts::{
    FanoutReceiptDecision, FanoutReceiptStrategy, FanoutReceiptSyncPoint, JsonObject,
};
use runx_core::state_machine::{FanoutSyncDecision, FanoutSyncOutcome, FanoutSyncStrategy};
use runx_parser::ExecutionGraph;

use super::StepRun;

pub(super) fn latest_fanout_receipt_ids(
    runs: &[StepRun],
    graph: &ExecutionGraph,
    group_id: &str,
) -> Vec<String> {
    graph
        .steps
        .iter()
        .filter(|step| step.fanout_group.as_deref() == Some(group_id))
        .filter_map(|step| {
            runs.iter()
                .rev()
                .find(|run| run.step_id == step.id)
                .map(|run| run.receipt.id.to_string())
        })
        .collect()
}

pub(super) fn fanout_sync_point(
    decision: &FanoutSyncDecision,
    branch_receipts: &[String],
) -> FanoutReceiptSyncPoint {
    FanoutReceiptSyncPoint {
        group_id: decision.group_id.clone().into(),
        strategy: receipt_strategy(&decision.strategy),
        decision: receipt_decision(&decision.decision),
        rule_fired: decision.rule_fired.clone().into(),
        reason: decision.reason.clone().into(),
        branch_count: decision.branch_count,
        success_count: decision.success_count,
        failure_count: decision.failure_count,
        required_successes: decision.required_successes,
        branch_receipts: branch_receipts.iter().cloned().map(Into::into).collect(),
        gate: decision_gate(&decision.gate),
    }
}

pub(super) fn receipt_strategy(strategy: &FanoutSyncStrategy) -> FanoutReceiptStrategy {
    match strategy {
        FanoutSyncStrategy::All => FanoutReceiptStrategy::All,
        FanoutSyncStrategy::Any => FanoutReceiptStrategy::Any,
        FanoutSyncStrategy::Quorum => FanoutReceiptStrategy::Quorum,
    }
}

pub(super) fn receipt_decision(decision: &FanoutSyncOutcome) -> FanoutReceiptDecision {
    match decision {
        FanoutSyncOutcome::Proceed => FanoutReceiptDecision::Proceed,
        FanoutSyncOutcome::Halt => FanoutReceiptDecision::Halt,
        FanoutSyncOutcome::Pause => FanoutReceiptDecision::Pause,
        FanoutSyncOutcome::Escalate => FanoutReceiptDecision::Escalate,
    }
}

pub(super) fn decision_gate(
    gate: &Option<runx_core::state_machine::FanoutGate>,
) -> Option<JsonObject> {
    let value = serde_json::to_value(gate.as_ref()?).ok()?;
    let runx_contracts::JsonValue::Object(object) = serde_json::from_value(value).ok()? else {
        return None;
    };
    Some(object)
}