feat: guided setup: start

Author: kabudu

Cargo.lock

@@ -13,6 +13,7 @@ path = "src/main.rs"
 maabarium-core = { path = "../maabarium-core" }
 tokio = { workspace = true }
 tokio-util = { workspace = true }
+serde_json = { workspace = true }
 clap = { workspace = true }
 tracing = { workspace = true }
 tracing-subscriber = { workspace = true }

crates/maabarium-cli/Cargo.toml

@@ -4,6 +4,8 @@ use maabarium_core::{
     ExportFormat, GitDependencyEnsureOutcome, Persistence, PromotionOutcome, SecretStore,
     UpdaterConfiguration, check_for_cli_update, default_db_path, default_log_path,
     ensure_git_dependency, install_cli_update,
+    ReadinessLevel, ReadinessScanner,
+    analyze_workspace, apply_all_fixes, detect_recommended_profile,
 };
 use maabarium_core::error::UpdaterError;
 use secrecy::{ExposeSecret, SecretString};
@@ -49,6 +51,21 @@ enum Commands {
         #[command(subcommand)]
         action: KeysAction,
     },
+    /// Check and fix setup readiness
+    Setup {
+        /// Non-interactive readiness check (exit 0 = ready, 1 = needs attention)
+        #[arg(long)]
+        check: bool,
+        /// Output readiness report as JSON
+        #[arg(long)]
+        json: bool,
+        /// Workspace path to analyze
+        #[arg(long)]
+        workspace: Option<String>,
+        /// Runtime strategy hint: local, mixed, remote
+        #[arg(long)]
+        strategy: Option<String>,
+    },
     /// Inspect and update the CLI binary itself
     #[command(name = "self")]
     SelfManage {
@@ -182,6 +199,60 @@ async fn main() -> anyhow::Result<()> {
                 println!("{}", render_delete_key_message(&secret_store, &provider)?);
             }
         },
+        Commands::Setup {
+            check,
+            json,
+            workspace,
+            strategy,
+        } => {
+            let workspace_ref = workspace.as_deref();
+            let strategy_ref = strategy.as_deref();
+            let report = ReadinessScanner::scan(workspace_ref, strategy_ref);
+
+            if json {
+                println!("{}", serde_json::to_string_pretty(&report)?);
+            } else {
+                render_readiness_report(&report, workspace_ref);
+            }
+
+            if check {
+                if !report.is_ready() {
+                    std::process::exit(1);
+                }
+            } else {
+                // Interactive: attempt fixes for items needing attention
+                let needs_fix = report.needs_attention();
+                if needs_fix.is_empty() {
+                    println!("\nAll checks passed. Maabarium is ready to run.");
+                } else {
+                    println!("\nAttempting one-click fixes...");
+                    let outcomes = apply_all_fixes(workspace_ref);
+                    for outcome in &outcomes {
+                        let icon = if outcome.success { "[OK]" } else { "[!!]" };
+                        println!("  {icon} {}", outcome.message);
+                    }
+                    if outcomes.iter().any(|o| !o.success) {
+                        println!("\nSome fixes require manual intervention. See messages above.");
+                    } else {
+                        println!("\nAll automatic fixes applied successfully.");
+                    }
+                }
+
+                // Show workspace analysis if workspace provided
+                if let Some(ws) = workspace_ref {
+                    let analysis = analyze_workspace(ws);
+                    render_workspace_analysis(&analysis);
+                }
+
+                // Show recommended profile
+                let recommended = detect_recommended_profile();
+                println!(
+                    "\nRecommended environment profile: {} - {}",
+                    recommended.label(),
+                    recommended.description()
+                );
+            }
+        }
         Commands::SelfManage { action } => match action {
             SelfAction::Version => {
                 println!("maabarium {}", env!("CARGO_PKG_VERSION"));
@@ -435,6 +506,59 @@ fn render_delete_key_message(
     }
 }
 
+fn render_readiness_report(report: &maabarium_core::ReadinessReport, workspace: Option<&str>) {
+    println!("Maabarium Setup Readiness Report");
+    println!("===============================");
+    if let Some(ws) = workspace {
+        println!("Workspace: {ws}");
+    }
+    println!();
+
+    for item in &report.items {
+        let icon = match item.status {
+            ReadinessLevel::Ready => "[OK]",
+            ReadinessLevel::Optional => "[--]",
+            ReadinessLevel::NeedsAction => "[!!]",
+        };
+        println!("{} {}", icon, item.title);
+        println!("   {}", item.summary);
+        if let Some(fix) = &item.fix_label {
+            println!("   Action: {fix}");
+        }
+        if let Some(hint) = &item.fix_hint {
+            println!("   Hint: {hint}");
+        }
+        println!();
+    }
+
+    if report.is_ready() {
+        println!("Status: READY - All checks passed.");
+    } else {
+        let count = report.needs_attention().len();
+        println!("Status: NEEDS ATTENTION - {count} item(s) require fixes.");
+    }
+}
+
+fn render_workspace_analysis(analysis: &maabarium_core::WorkspaceAnalysis) {
+    println!("\nWorkspace Analysis: {}", analysis.path);
+    println!("  {}", analysis.project_summary);
+    if let Some(lang) = &analysis.language {
+        println!("  Language: {lang}");
+    }
+    if let Some(cmd) = &analysis.test_command {
+        println!("  Test command: {cmd}");
+    }
+    if !analysis.suggested_target_files.is_empty() {
+        println!(
+            "  Suggested targets: {}",
+            analysis.suggested_target_files.join(", ")
+        );
+    }
+    if analysis.has_ci_config {
+        println!("  CI configuration detected");
+    }
+}
+
 #[cfg(test)]
 mod tests {
     use super::*;

crates/maabarium-cli/src/main.rs

@@ -15,6 +15,7 @@ pub mod metrics;
 pub mod persistence;
 pub mod runtime_dependencies;
 pub mod secrets;
+pub mod setup_wizard;
 pub mod updater;
 
 pub use blueprint::{
@@ -40,6 +41,15 @@ pub use runtime_dependencies::{
     git_dependency_status,
 };
 pub use secrets::{ApiKeyStore, SecretStore};
+pub use setup_wizard::{
+    EnvironmentProfile, FixOutcome, FixTarget, OllamaStatus as SetupOllamaStatus,
+    ProfileConfig, ProviderValidationResult, ReadinessItem as SetupReadinessItem,
+    ReadinessLevel, ReadinessReport, ReadinessScanner, WorkspaceAnalysis,
+    analyze_workspace, apply_all_fixes, apply_git_fix, apply_profile,
+    detect_recommended_profile, ollama_status as setup_ollama_status,
+    start_ollama as setup_start_ollama, validate_ollama_connection,
+    validate_provider_connection,
+};
 pub use updater::{
     CliArtifactManifest, CliReleaseArtifact, ReleaseManifest, UpdaterConfiguration,
     check_for_cli_update, install_cli_update,