canic-host 0.111.0

Host-side App build and desired-state Fleet reconciliation library for Canic workspaces
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

//! Module: component_operation
//!
//! Responsibility: review and reconcile one operator-requested Component.
//! Boundary: Root owns provisioning; the host retains exact submission authority.

pub mod model;
pub mod ops;
pub mod policy;
#[cfg(test)]
mod tests;
pub mod view;
pub mod workflow;

use std::io;
use thiserror::Error;

/// Typed host failure; remote protocol errors retain their originating diagnostic.
#[derive(Debug, Error)]
pub enum ComponentOperationError {
    #[error("Component operation authority changed: {field}; preserve the existing operation")]
    Authority { field: &'static str },

    #[error("Component operation has no Ready pool asset; review Root capacity before applying")]
    Capacity,

    #[error(transparent)]
    Inventory(#[from] crate::fleet_ensure::CurrentFleetInventoryError),

    #[error(transparent)]
    Icp(#[from] crate::icp::IcpCommandError),

    #[error("invalid Component operation label: {0}")]
    InvalidLabel(String),

    #[error("Component operation record failed integrity validation")]
    Integrity,

    #[error(transparent)]
    Io(#[from] io::Error),

    #[error(transparent)]
    Json(#[from] serde_json::Error),

    #[error("Component operation has no retained review")]
    Missing,

    #[error(transparent)]
    Network(#[from] crate::network::NetworkIdentityError),

    #[error("Component operation progress conflicts with its reviewed authority")]
    Progress,

    #[error(transparent)]
    Protocol(#[from] crate::CanisterProtocolError),

    #[error(transparent)]
    ProtocolBinding(#[from] crate::protocol_binding::ProtocolBindingError),

    #[error("Component operation review digest differs from --review")]
    Review,

    #[error("Component Spec is not admitted on the selected Root")]
    Spec,

    #[error(transparent)]
    State(#[from] crate::fleet_ensure::ops::EnsureStateError),
}