Struct InitService 

pub struct InitService;

Service for initializing new Mecha10 projects

Examples

use mecha10_cli::services::InitService;

let service = InitService::new();

// Create project structure
service.create_project_directories(&project_path).await?;

// Add example nodes
service.add_example_node(&project_path, "speaker").await?;

Implementations

impl InitService

pub fn new() -> Self

Create a new InitService

pub async fn create_project_directories(&self, path: &Path) -> Result<()>

Create project directory structure

Creates all the necessary directories for a new Mecha10 project:

• nodes/ - Custom node implementations
• drivers/ - Hardware driver implementations
• types/ - Shared type definitions
• behaviors/ - Behavior tree definitions
• config/ - Configuration files
• logs/ - Runtime logs
• simulation/ - Simulation environments
• simulation/models/ - Robot physical models (for Godot)
• assets/ - Static assets for simulation and visualization
• assets/images/ - Image assets for simulation textures, UI, etc.

pub async fn add_example_node( &self, project_root: &Path, component_name: &str, ) -> Result<()>

Add an example node from the catalog to the project

This method:

1. Searches the component catalog for the component
2. Generates component files from templates (if any)
3. Updates Cargo.toml (workspace members or dependencies)
4. Updates mecha10.json configuration

Arguments

• project_root - Root path of the project
• component_name - Name of the component to add (e.g., “speaker”, “listener”)

pub async fn copy_behavior_templates(&self, project_root: &Path) -> Result<()>

Copy behavior tree templates from framework to project

Copies seed templates from packages/behavior-runtime/seeds/ to {project}/behaviors/ for use with the behavior tree system.

Arguments

• project_root - Root path of the project

pub async fn copy_simulation_configs(&self, project_root: &Path) -> Result<()>

Copy simulation configuration files from framework to project

Copies config from packages/simulation/configs/config.json to {project}/configs/dev/simulation/config.json. Simulation is dev-only, so no production config is needed.

Arguments

• project_root - Root path of the project

pub async fn copy_simulation_assets(&self, project_root: &Path) -> Result<()>

Copy simulation asset files from framework to project

Copies image assets from packages/simulation/environments/basic_arena/assets/images/ to {project}/assets/images/

This includes cat images (aiko.jpg, phoebe.jpg) used in the basic arena environment

Arguments

• project_root - Root path of the project

pub async fn copy_all_node_configs(&self, project_root: &Path) -> Result<()>

Copy all default node configuration files from framework to project

Copies configs for all default nodes from packages/nodes/{node}/configs/ to {project}/configs/nodes/@mecha10/{node}/config.json

This is called during mecha10 init to set up node configs. Skips silently if framework path is not available (standalone CLI mode).

Arguments

• project_root - Root path of the project

pub fn detect_framework_path(&self) -> Result<String>

Detect the framework path for development mode

Searches for the mecha10-monorepo in the following order:

1. MECHA10_FRAMEWORK_PATH environment variable
2. Walking up the directory tree from current directory

This is used when creating projects in development mode to link to the local framework instead of published crates.

Returns

The absolute path to the framework root, or an error if not found.

Trait Implementations

impl Default for InitService

fn default() -> Self

Returns the “default value” for a type.