icydb-cli 0.219.0

Developer CLI tools for IcyDB
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

//! Module: CLI schema command arguments.
//! Responsibility: define live schema observability clap surfaces.
//! Does not own: schema endpoint execution, endpoint publication, or report rendering.
//! Boundary: exposes parsed schema command values to the observability owner.

use clap::{Args, Subcommand};

use crate::cli::CanisterTarget;

///
/// SchemaCommand
///
/// SchemaCommand owns accepted live-schema observability.
///

#[derive(Debug, Subcommand)]
pub(crate) enum SchemaCommand {
    /// Read accepted schema metadata from an IcyDB canister.
    Show(CanisterTarget),

    /// Inspect or operate an explicit deployed source migration.
    #[command(subcommand)]
    Migration(SchemaMigrationCommand),
}

/// Deployed-only source migration operations.
#[derive(Debug, Subcommand)]
pub(crate) enum SchemaMigrationCommand {
    /// Read one bounded migration status page.
    Status(CanisterTarget),
    /// Advance one bounded migration step.
    Advance(CanisterTarget),
    /// Repeatedly advance while deployed identity and plan remain exact.
    Run(CanisterTarget),
    /// Abort a migration before irreversible rewriting begins.
    Abort(ConfirmedMigrationTarget),
    /// Adopt an exact existing version-1 generated schema.
    Adopt(ConfirmedMigrationTarget),
}

/// Destructive migration target requiring explicit confirmation.
#[derive(Args, Debug)]
pub(crate) struct ConfirmedMigrationTarget {
    #[command(flatten)]
    target: CanisterTarget,

    /// Confirm the controller operation explicitly.
    #[arg(long)]
    yes: bool,
}

impl ConfirmedMigrationTarget {
    pub(crate) const fn target(&self) -> &CanisterTarget {
        &self.target
    }

    pub(crate) const fn confirmed(&self) -> bool {
        self.yes
    }
}