icydb-cli 0.296.6

//! Module: CLI diagnostic command arguments.
//! Responsibility: define diagnostic lookup and structured-error input arguments.
//! Does not own: diagnostic registry rendering or canister error transport.
//! Boundary: select one diagnostic input plus optional schema resolvers.

use std::path::{Path, PathBuf};

use clap::Args;

use crate::{
    cli::{DEFAULT_ENVIRONMENT, ICP_ENVIRONMENT_ENV},
    diagnostic::{RawDiagnosticFact, parse_error_code, parse_fact},
};

///
/// DiagnosticArgs
///
/// DiagnosticArgs selects a compact code or a complete public error payload.
/// Domain value parsers accept pasted codes and numeric facts before dispatch.
///

#[derive(Args, Debug)]
pub(crate) struct DiagnosticArgs {
    /// Compact IcyDB error code, for example E7, 7, E190, or 190.
    #[arg(
        value_name = "CODE",
        required_unless_present = "error_json",
        conflicts_with = "error_json",
        value_parser = parse_error_code
    )]
    code: Option<u16>,

    /// Read one public IcyDB Error JSON object from regular-file PATH, or - for stdin (64 KiB maximum).
    #[arg(long, value_name = "PATH", conflicts_with_all = ["code", "facts"])]
    error_json: Option<PathBuf>,

    /// Add one numeric diagnostic fact as TAG=VALUE or LABEL=VALUE.
    #[arg(long = "fact", value_name = "TAG=VALUE", value_parser = parse_fact)]
    facts: Vec<RawDiagnosticFact>,

    /// Resolve accepted schema identities from a bounded exported artifact.
    #[arg(long, value_name = "PATH")]
    artifact: Option<PathBuf>,

    /// Resolve accepted schema identities from exact fingerprint-bound source metadata.
    #[arg(long, value_name = "PATH")]
    source_metadata: Option<PathBuf>,

    /// Resolve accepted schema identities from this canister's explicit schema endpoint.
    #[arg(long, value_name = "CANISTER")]
    canister: Option<String>,

    /// Target icp-cli environment for live schema resolution.
    #[arg(
        short,
        long,
        env = ICP_ENVIRONMENT_ENV,
        default_value = DEFAULT_ENVIRONMENT,
        value_name = "ENV"
    )]
    environment: String,
}

impl DiagnosticArgs {
    pub(crate) const fn code(&self) -> Option<u16> {
        self.code
    }

    pub(crate) fn error_json(&self) -> Option<&Path> {
        self.error_json.as_deref()
    }

    pub(crate) const fn facts(&self) -> &[RawDiagnosticFact] {
        self.facts.as_slice()
    }

    pub(crate) fn artifact(&self) -> Option<&Path> {
        self.artifact.as_deref()
    }

    pub(crate) fn source_metadata(&self) -> Option<&Path> {
        self.source_metadata.as_deref()
    }

    pub(crate) fn canister_name(&self) -> Option<&str> {
        self.canister.as_deref()
    }

    pub(crate) const fn environment(&self) -> &str {
        self.environment.as_str()
    }
}