Struct CliContext 

pub struct CliContext {
    pub config_path: PathBuf,
    pub log_level: Level,
    pub working_dir: PathBuf,
    /* private fields */
}

CLI execution context

This provides normalized runtime configuration for the CLI, combining:

• CLI flags
• Environment variables
• Config file settings
• Computed defaults

Use CliContextBuilder to construct with proper precedence handling.

Example

use mecha10_cli::{CliContext, CliContextBuilder};

let ctx = CliContextBuilder::new()
    .verbose(true)
    .build()?;

assert!(ctx.is_verbose());

Fields

config_path: PathBuf

Path to the project config file (mecha10.json)

log_level: Level

Logging level

working_dir: PathBuf

Project working directory

Implementations

impl CliContext

pub async fn load_project_config(&self) -> Result<ProjectConfig>

Load the project configuration

This loads the configuration from disk each time it’s called. For better performance in commands that access config multiple times, call this once and store the result.

pub fn is_project_initialized(&self) -> bool

Check if a project is initialized (mecha10.json exists)

pub fn project_path(&self, path: &str) -> PathBuf

Get a path relative to the project root

pub fn is_verbose(&self) -> bool

Check if verbose mode is enabled

pub fn is_dev_mode(&self) -> bool

Check if development mode is enabled

pub fn redis_url(&self) -> &str

Get the Redis connection URL

pub fn postgres_url(&self) -> Option<&str>

Get the PostgreSQL connection URL if configured

pub fn redis(&mut self) -> Result<&RedisService>

Get Redis service (creates on first access)

pub fn project(&mut self) -> Result<&ProjectService>

Get Project service (creates on first access)

pub fn template(&mut self) -> &TemplateService

Get Template service (creates on first access)

pub fn simulation(&mut self) -> &SimulationService

Get Simulation service (creates on first access)

pub fn process(&mut self) -> &mut ProcessService

Get Process service (creates on first access)

pub fn docker(&mut self) -> &DockerService

Get Docker service (creates on first access)

pub fn package(&mut self) -> Result<&PackageService>

Get Package service (creates on first access)

Note: This requires a valid project to be detected with name and version.

pub fn deployment(&mut self) -> &DeploymentService

Get Deployment service (creates on first access)

pub fn component_catalog(&mut self) -> &ComponentCatalogService

Get Component Catalog service (creates on first access)

pub fn discovery(&mut self) -> &mut DiscoveryService

Get Discovery service (creates on first access)

pub fn init_service(&mut self) -> &InitService

Get Init service (creates on first access)

pub fn project_template_service(&mut self) -> &ProjectTemplateService

Get Project Template service (creates on first access)

pub fn dev(&mut self) -> &DevService

Get Dev service (creates on first access)

pub fn topology(&mut self) -> &TopologyService

Get Topology service (creates on first access)

The topology service performs static analysis of project structure, extracting node definitions and pub/sub topic relationships from source code.

pub fn template_download(&mut self) -> &TemplateDownloadService

Get Template Download service (creates on first access)

Downloads project templates from GitHub releases on-demand. Templates are versioned and cached locally for offline use.

pub fn validate_docker(&mut self) -> Result<()>

Validate that Docker is installed and running

pub async fn validate_redis(&mut self) -> Result<()>

Validate that Redis is accessible

pub fn validate_project_structure(&self) -> Result<()>

Validate project structure

Checks that the project has the expected directory structure and required files.

pub fn validate_godot(&mut self) -> Result<()>

Validate that Godot is installed (for simulation)

pub fn is_ci(&self) -> bool

Check if running in CI environment

pub fn is_interactive(&self) -> bool

Check if running in interactive terminal

pub fn logs_dir(&self) -> PathBuf

Get logs directory path

pub fn data_dir(&self) -> PathBuf

Get data directory path

pub fn recordings_dir(&self) -> PathBuf

Get recordings directory path

pub fn maps_dir(&self) -> PathBuf

Get maps directory path

pub fn telemetry_dir(&self) -> PathBuf

Get telemetry directory path

pub fn simulation_dir(&self) -> PathBuf

Get simulation directory path

pub fn target_debug_dir(&self) -> PathBuf

Get target/debug directory path

pub fn target_release_dir(&self) -> PathBuf

Get target/release directory path

pub fn packages_dir(&self) -> PathBuf

Get packages output directory path

pub fn ensure_dir(&self, path: &PathBuf) -> Result<()>

Ensure a directory exists, creating it if necessary

Trait Implementations

impl Default for CliContext

fn default() -> Self

Returns the “default value” for a type.