canic-cli 0.110.29

Operator CLI for Canic fleet setup, builds, evidence, catalog, backup, and restore workflows
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

//! Module: fleet::progress
//!
//! Responsibility: bound repeated informational wait output with a periodic heartbeat.
//! Does not own: polling, reconciliation, effects, errors or review decisions.
//! Boundary: only unchanged waiting events are suppressed; elapsed time is not progress.

#[cfg(test)]
mod tests;

use canic_host::fleet_ensure::dto::{FleetEnsureProgress, FleetEnsureProgressState};
use std::time::{Duration, Instant};

const HEARTBEAT: Duration = Duration::from_secs(30);

/// Invocation-local last emitted state and monotonic heartbeat deadline.
#[derive(Default)]
pub(super) struct ProgressOutput {
    last_wait: Option<(FleetEnsureProgress, Instant)>,
}

impl ProgressOutput {
    /// Emit changes immediately; retain the latest elapsed detail for each heartbeat.
    pub(super) fn should_emit(&mut self, progress: &FleetEnsureProgress, now: Instant) -> bool {
        let FleetEnsureProgressState::AwaitingProgress { .. } = progress.state else {
            self.last_wait = None;
            return true;
        };
        let mut identity = progress.clone();
        if let FleetEnsureProgressState::AwaitingProgress {
            elapsed_seconds, ..
        } = &mut identity.state
        {
            *elapsed_seconds = 0;
        }
        if self.last_wait.as_ref().is_some_and(|(previous, emitted)| {
            previous == &identity && now.saturating_duration_since(*emitted) < HEARTBEAT
        }) {
            return false;
        }
        self.last_wait = Some((identity, now));
        true
    }
}