syncable_cli/
cli.rs

1use clap::{Parser, Subcommand, ValueEnum};
2use std::path::PathBuf;
3
4#[derive(Parser)]
5#[command(name = "sync-ctl")]
6#[command(version = env!("CARGO_PKG_VERSION"))]
7#[command(about = "Generate Infrastructure as Code from your codebase")]
8#[command(
9    long_about = "A powerful CLI tool that analyzes your codebase and automatically generates optimized Infrastructure as Code configurations including Dockerfiles, Docker Compose files, and Terraform configurations"
10)]
11pub struct Cli {
12    #[command(subcommand)]
13    pub command: Commands,
14
15    /// Path to configuration file
16    #[arg(short, long, global = true, value_name = "FILE")]
17    pub config: Option<PathBuf>,
18
19    /// Enable verbose logging (-v for info, -vv for debug, -vvv for trace)
20    #[arg(short, long, global = true, action = clap::ArgAction::Count)]
21    pub verbose: u8,
22
23    /// Suppress all output except errors
24    #[arg(short, long, global = true)]
25    pub quiet: bool,
26
27    /// Output in JSON format where applicable
28    #[arg(long, global = true)]
29    pub json: bool,
30
31    /// Clear the update check cache and force a new check
32    #[arg(long, global = true)]
33    pub clear_update_cache: bool,
34
35    /// Disable telemetry data collection
36    #[arg(long, global = true)]
37    pub disable_telemetry: bool,
38}
39
40#[derive(Subcommand)]
41pub enum Commands {
42    /// Analyze a project and display detected components
43    Analyze {
44        /// Path to the project directory to analyze
45        #[arg(value_name = "PROJECT_PATH")]
46        path: PathBuf,
47
48        /// Output analysis results in JSON format
49        #[arg(short, long)]
50        json: bool,
51
52        /// Show detailed analysis information (legacy format)
53        #[arg(short, long, conflicts_with = "display")]
54        detailed: bool,
55
56        /// Display format for analysis results
57        #[arg(long, value_enum, default_value = "matrix")]
58        display: Option<DisplayFormat>,
59
60        /// Only analyze specific aspects (languages, frameworks, dependencies)
61        #[arg(long, value_delimiter = ',')]
62        only: Option<Vec<String>>,
63
64        /// Color scheme for terminal output (auto-detect, dark, light)
65        #[arg(long, value_enum, default_value = "auto")]
66        color_scheme: Option<ColorScheme>,
67    },
68
69    /// Generate IaC files for a project
70    Generate {
71        /// Path to the project directory to analyze
72        #[arg(value_name = "PROJECT_PATH")]
73        path: PathBuf,
74
75        /// Output directory for generated files
76        #[arg(short, long, value_name = "OUTPUT_DIR")]
77        output: Option<PathBuf>,
78
79        /// Generate Dockerfile
80        #[arg(long)]
81        dockerfile: bool,
82
83        /// Generate Docker Compose file
84        #[arg(long)]
85        compose: bool,
86
87        /// Generate Terraform configuration
88        #[arg(long)]
89        terraform: bool,
90
91        /// Generate all supported IaC files
92        #[arg(long, conflicts_with_all = ["dockerfile", "compose", "terraform"])]
93        all: bool,
94
95        /// Perform a dry run without creating files
96        #[arg(long)]
97        dry_run: bool,
98
99        /// Overwrite existing files
100        #[arg(long)]
101        force: bool,
102    },
103
104    /// Validate existing IaC files against best practices
105    Validate {
106        /// Path to the directory containing IaC files
107        #[arg(value_name = "PATH")]
108        path: PathBuf,
109
110        /// Types of files to validate
111        #[arg(long, value_delimiter = ',')]
112        types: Option<Vec<String>>,
113
114        /// Fix issues automatically where possible
115        #[arg(long)]
116        fix: bool,
117    },
118
119    /// Show supported languages and frameworks
120    Support {
121        /// Show only languages
122        #[arg(long)]
123        languages: bool,
124
125        /// Show only frameworks
126        #[arg(long)]
127        frameworks: bool,
128
129        /// Show detailed information
130        #[arg(short, long)]
131        detailed: bool,
132    },
133
134    /// Analyze project dependencies in detail
135    Dependencies {
136        /// Path to the project directory to analyze
137        #[arg(value_name = "PROJECT_PATH")]
138        path: PathBuf,
139
140        /// Show license information for dependencies
141        #[arg(long)]
142        licenses: bool,
143
144        /// Check for known vulnerabilities
145        #[arg(long)]
146        vulnerabilities: bool,
147
148        /// Show only production dependencies
149        #[arg(long, conflicts_with = "dev_only")]
150        prod_only: bool,
151
152        /// Show only development dependencies
153        #[arg(long, conflicts_with = "prod_only")]
154        dev_only: bool,
155
156        /// Output format
157        #[arg(long, value_enum, default_value = "table")]
158        format: OutputFormat,
159    },
160
161    /// Check dependencies for known vulnerabilities
162    Vulnerabilities {
163        /// Check vulnerabilities in a specific path
164        #[arg(default_value = ".")]
165        path: PathBuf,
166
167        /// Show only vulnerabilities with severity >= threshold
168        #[arg(long, value_enum)]
169        severity: Option<SeverityThreshold>,
170
171        /// Output format
172        #[arg(long, value_enum, default_value = "table")]
173        format: OutputFormat,
174
175        /// Export report to file
176        #[arg(long)]
177        output: Option<PathBuf>,
178    },
179
180    /// Perform comprehensive security analysis
181    Security {
182        /// Path to the project directory to analyze
183        #[arg(value_name = "PROJECT_PATH", default_value = ".")]
184        path: PathBuf,
185
186        /// Security scan mode (lightning, fast, balanced, thorough, paranoid)
187        #[arg(long, value_enum, default_value = "thorough")]
188        mode: SecurityScanMode,
189
190        /// Include low severity findings
191        #[arg(long)]
192        include_low: bool,
193
194        /// Skip secrets detection
195        #[arg(long)]
196        no_secrets: bool,
197
198        /// Skip code pattern analysis
199        #[arg(long)]
200        no_code_patterns: bool,
201
202        /// Skip infrastructure analysis (not implemented yet)
203        #[arg(long, hide = true)]
204        no_infrastructure: bool,
205
206        /// Skip compliance checks (not implemented yet)
207        #[arg(long, hide = true)]
208        no_compliance: bool,
209
210        /// Compliance frameworks to check (not implemented yet)
211        #[arg(long, value_delimiter = ',', hide = true)]
212        frameworks: Vec<String>,
213
214        /// Output format
215        #[arg(long, value_enum, default_value = "table")]
216        format: OutputFormat,
217
218        /// Export report to file
219        #[arg(long)]
220        output: Option<PathBuf>,
221
222        /// Exit with error code on security findings
223        #[arg(long)]
224        fail_on_findings: bool,
225    },
226
227    /// Manage vulnerability scanning tools
228    Tools {
229        #[command(subcommand)]
230        command: ToolsCommand,
231    },
232}
233
234#[derive(Subcommand)]
235pub enum ToolsCommand {
236    /// Check which vulnerability scanning tools are installed
237    Status {
238        /// Output format
239        #[arg(long, value_enum, default_value = "table")]
240        format: OutputFormat,
241
242        /// Check tools for specific languages only
243        #[arg(long, value_delimiter = ',')]
244        languages: Option<Vec<String>>,
245    },
246
247    /// Install missing vulnerability scanning tools
248    Install {
249        /// Install tools for specific languages only
250        #[arg(long, value_delimiter = ',')]
251        languages: Option<Vec<String>>,
252
253        /// Also install OWASP Dependency Check (large download)
254        #[arg(long)]
255        include_owasp: bool,
256
257        /// Perform a dry run to show what would be installed
258        #[arg(long)]
259        dry_run: bool,
260
261        /// Skip confirmation prompts
262        #[arg(short, long)]
263        yes: bool,
264    },
265
266    /// Verify that installed tools are working correctly
267    Verify {
268        /// Test tools for specific languages only
269        #[arg(long, value_delimiter = ',')]
270        languages: Option<Vec<String>>,
271
272        /// Show detailed verification output
273        #[arg(short, long)]
274        detailed: bool,
275    },
276
277    /// Show tool installation guides for manual setup
278    Guide {
279        /// Show guide for specific languages only
280        #[arg(long, value_delimiter = ',')]
281        languages: Option<Vec<String>>,
282
283        /// Show platform-specific instructions
284        #[arg(long)]
285        platform: Option<String>,
286    },
287}
288
289#[derive(Debug, Clone, Copy, PartialEq, Eq, ValueEnum)]
290pub enum OutputFormat {
291    Table,
292    Json,
293}
294
295#[derive(Debug, Clone, Copy, PartialEq, Eq, ValueEnum)]
296pub enum DisplayFormat {
297    /// Compact matrix/dashboard view (modern, easy to scan)
298    Matrix,
299    /// Detailed vertical view (legacy format with all details)
300    Detailed,
301    /// Brief summary only
302    Summary,
303}
304
305#[derive(Clone, Copy, Debug, ValueEnum)]
306pub enum ColorScheme {
307    /// Auto-detect terminal background (default)
308    Auto,
309    /// Dark background terminal colors
310    Dark,
311    /// Light background terminal colors
312    Light,
313}
314
315#[derive(Debug, Clone, Copy, PartialEq, Eq, ValueEnum)]
316pub enum SeverityThreshold {
317    Low,
318    Medium,
319    High,
320    Critical,
321}
322
323#[derive(Debug, Clone, Copy, PartialEq, Eq, ValueEnum)]
324pub enum SecurityScanMode {
325    /// Lightning fast scan - critical files only (.env, configs)
326    Lightning,
327    /// Fast scan - smart sampling with priority patterns
328    Fast,
329    /// Balanced scan - good coverage with performance optimizations (recommended)
330    Balanced,
331    /// Thorough scan - comprehensive analysis of all files
332    Thorough,
333    /// Paranoid scan - most comprehensive including low-severity findings
334    Paranoid,
335}
336
337impl Cli {
338    /// Initialize logging based on verbosity level
339    pub fn init_logging(&self) {
340        if self.quiet {
341            return;
342        }
343
344        let level = match self.verbose {
345            0 => log::LevelFilter::Warn,
346            1 => log::LevelFilter::Info,
347            2 => log::LevelFilter::Debug,
348            _ => log::LevelFilter::Trace,
349        };
350
351        env_logger::Builder::from_default_env()
352            .filter_level(level)
353            .init();
354    }
355}
syncable_cli/cli.rs

syncable_cli/
cli.rs
