drft-cli 0.7.0

A structural integrity checker for linked file systems
Documentation
use clap::{Parser, Subcommand, ValueEnum};
use std::path::PathBuf;

#[derive(Parser)]
#[command(
    name = "drft",
    version,
    about = "Structural integrity checker for linked file systems"
)]
pub struct Cli {
    #[command(subcommand)]
    pub command: Commands,

    /// Run as if started in <path>
    #[arg(short = 'C', global = true)]
    pub directory: Option<PathBuf>,

    /// Output format
    #[arg(long, global = true, default_value = "text")]
    pub format: OutputFormat,

    /// Colorize output
    #[arg(long, global = true, default_value = "auto")]
    pub color: ColorChoice,
}

#[derive(Subcommand)]
pub enum Commands {
    /// Create a drft.toml config file
    Init,

    /// Snapshot the current state to drft.lock
    Lock {
        /// Verify lockfile is up to date without writing
        #[arg(long)]
        check: bool,
    },

    /// Show raw parser output (edges and metadata)
    Parse {
        /// Run only a specific parser
        #[arg(long)]
        parser: Option<String>,
    },

    /// Export the dependency graph
    Graph {
        /// Output as GraphViz DOT
        #[arg(long)]
        dot: bool,

        /// Only include edges from this parser
        #[arg(long)]
        parser: Option<String>,
    },

    /// Show what depends on the given files (transitively)
    Impact {
        /// Files to analyze (relative paths)
        #[arg(required = true)]
        files: Vec<String>,

        /// Only include edges from this parser
        #[arg(long)]
        parser: Option<String>,
    },

    /// [unstable] Run graph analyses and health metrics
    Report {
        /// Analyses or metrics to include (defaults to all)
        names: Vec<String>,
    },

    /// Show resolved configuration
    Config {
        #[command(subcommand)]
        action: ConfigAction,
    },

    /// Check structure for rule violations
    Check {
        /// Run only specific rules (can be repeated)
        #[arg(long = "rule")]
        rules: Vec<String>,

        /// Watch for changes and re-check
        #[arg(long, short = 'w')]
        watch: bool,
    },
}

#[derive(Subcommand)]
pub enum ConfigAction {
    /// Print the resolved configuration (defaults filled in)
    Show,
}

#[derive(Clone, Copy, ValueEnum)]
pub enum OutputFormat {
    Text,
    Json,
}

#[derive(Clone, Copy, ValueEnum)]
pub enum ColorChoice {
    Auto,
    Always,
    Never,
}