canic-core 0.110.22

Canic — a canister orchestration and management toolkit for the Internet Computer
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

//! Module: workflow::state
//!
//! Responsibility: orchestrate Fleet-state mutations and downstream state cascades.
//! Does not own: endpoint authorization, stable state records, or DTO schemas.
//! Boundary: workflow layer between state API calls, storage ops, and cascade workflow.

pub mod query;

use crate::{
    InternalError,
    dto::state::{FleetCommand, FleetCommandExecutionResponse},
    ops::{
        cascade_report::StateCascadeReportOps, runtime::env::EnvOps,
        storage::state::fleet::FleetStateOps,
    },
    view::state_cascade::StateCascadeTarget,
    workflow::{
        cascade::{snapshot::StateSnapshotBuilder, state::StateCascadeWorkflow},
        runtime::cycles::CycleWorkflow,
    },
};

///
/// FleetStateWorkflow
/// Orchestrates Fleet-state mutations and downstream cascades
///

pub struct FleetStateWorkflow;

impl FleetStateWorkflow {
    /// Apply a Fleet-level command and cascade to an explicit root-owned inventory.
    ///
    /// Workflow-level orchestration for mutating Fleet state.
    /// This function:
    /// - enforces execution context (root-only)
    /// - applies the command via storage ops
    /// - rebuilds the relevant state snapshot
    /// - cascades state changes to dependent components
    ///
    /// Returns internal [`InternalError`]. Public error mapping is handled
    /// exclusively at the API boundary.
    pub async fn execute_command_to(
        cmd: FleetCommand,
        root_children: &[StateCascadeTarget],
        reconcile_funding: bool,
    ) -> Result<FleetCommandExecutionResponse, InternalError> {
        EnvOps::require_root()?;
        let builder = StateSnapshotBuilder::new()?;
        let response = FleetStateOps::apply_command(cmd);
        let reconciliation_error = if reconcile_funding {
            CycleWorkflow::start().err().map(Into::into)
        } else {
            None
        };
        let snapshot = builder.with_fleet_state().build();
        let propagation =
            StateCascadeWorkflow::root_cascade_state_to(&snapshot, root_children).await?;
        Ok(StateCascadeReportOps::command_response(
            response,
            propagation,
            reconciliation_error,
        ))
    }
}