feat(cli): autostart dev container if "run-locally = true" (#176)

crates/loam-cli/Cargo.toml

@@ -42,6 +42,7 @@ sha2 = { workspace = true }
 
 clap-cargo-extra = "0.3.0"
 
+reqwest = { version = "0.12.9", features = ["json"] }
 thiserror = "1.0.31"
 serde = "1.0.82"
 serde_derive = "1.0.82"

crates/loam-cli/src/commands/build/env_toml.rs

@@ -77,7 +77,7 @@ pub struct Network {
     pub rpc_url: Option<String>,
     pub network_passphrase: Option<String>,
     pub rpc_headers: Option<Vec<(String, String)>>,
-    // run_locally: Option<bool>,
+    pub run_locally: Option<bool>,
 }
 
 #[derive(Debug, Clone, serde::Serialize, serde::Deserialize)]

crates/loam-cli/src/commands/dev/docker.rs

@@ -0,0 +1,56 @@
+use soroban_cli::{commands as cli, CommandParser};
+use std::error::Error;
+
+pub async fn start_local_stellar() -> Result<(), Box<dyn Error>> {
+    let result = cli::container::StartCmd::parse_arg_vec(&["local"])?
+        .run(&soroban_cli::commands::global::Args::default())
+        .await;
+
+    match result {
+        Ok(()) => {
+            tokio::time::sleep(std::time::Duration::from_secs(10)).await;
+        }
+        Err(e) => {
+            if e.to_string().contains("already in use")
+                || e.to_string().contains("port is already allocated")
+            {
+                eprintln!("Container is already running, proceeding to health check...");
+            } else {
+                return Err(Box::new(e));
+            }
+        }
+    }
+
+    wait_for_stellar_health().await?;
+    Ok(())
+}
+async fn wait_for_stellar_health() -> Result<(), Box<dyn Error>> {
+    let client = reqwest::Client::new();
+    let start_time = std::time::Instant::now();
+    let timeout = std::time::Duration::from_secs(60);
+    loop {
+        let elapsed_time = start_time.elapsed();
+        if elapsed_time > timeout {
+            eprintln!("Timeout reached: stopping health checks.");
+            return Err("Health check timed out".into());
+        }
+        let res = client
+            .post("http://localhost:8000/rpc")
+            .header("Content-Type", "application/json")
+            .body(r#"{"jsonrpc": "2.0", "id": 1, "method": "getHealth"}"#)
+            .send()
+            .await?;
+        if res.status().is_success() {
+            let health_status: serde_json::Value = res.json().await?;
+            if health_status["result"]["status"] == "healthy" {
+                break;
+            }
+            eprintln!("Stellar status is not healthy: {health_status:?}");
+        } else {
+            eprintln!("Health check request failed with status: {}", res.status());
+        }
+        tokio::time::sleep(std::time::Duration::from_secs(5)).await;
+        eprintln!("Retrying health check.");
+    }
+    Ok(())
+}

crates/loam-cli/src/commands/dev/mod.rs

@@ -10,11 +10,13 @@ use tokio::sync::mpsc;
 use tokio::sync::Mutex;
 use tokio::time;
 
-use crate::commands::build;
+use crate::commands::build::{self, env_toml};
 
 use super::build::clients::LoamEnv;
 use super::build::env_toml::ENV_FILE;
 
+pub mod docker;
+
 pub enum Message {
     FileChanged,
 }
@@ -34,6 +36,10 @@ pub enum Error {
     Build(#[from] build::Error),
     #[error("IO error: {0}")]
     Io(#[from] std::io::Error),
+    #[error(transparent)]
+    Env(#[from] env_toml::Error),
+    #[error("Failed to start docker container")]
+    DockerStart,
 }
 
 fn canonicalize_path(path: &Path) -> PathBuf {
@@ -137,7 +143,19 @@ impl Cmd {
             .parent()
             .unwrap_or_else(|| Path::new("."));
         let env_toml_dir = workspace_root;
-
+        let Some(current_env) =
+            env_toml::Environment::get(workspace_root, &LoamEnv::Development.to_string())?
+        else {
+            return Ok(());
+        };
+        if current_env.network.run_locally.unwrap_or(false) {
+            eprintln!("Starting local Stellar Docker container...");
+            docker::start_local_stellar().await.map_err(|e| {
+                eprintln!("Failed to start Stellar Docker container: {e:?}");
+                Error::DockerStart
+            })?;
+            eprintln!("Local Stellar network is healthy and running.");
+        }
         let packages = self
             .build_cmd
             .list_packages()?