Module run 

Run Command Module

This module implements the delivery-agnostic RunCommandHandler for orchestrating the execution of the deployed software stack.

Architecture

The RunCommandHandler implements the Command Pattern and uses Dependency Injection to interact with infrastructure services through interfaces:

• Repository Pattern: Persists environment state via EnvironmentRepository
• Clock Abstraction: Provides deterministic time for testing via Clock trait
• Domain-Driven Design: Uses domain objects from domain::environment

Design Principles

• Delivery-Agnostic: Works with CLI, REST API, or any delivery mechanism
• Synchronous: Follows existing patterns (no async/await)
• Explicit State Transitions: Type-safe state machine for environment lifecycle
• Explicit Errors: All errors implement .help() with actionable guidance

Run Workflow

The command handler orchestrates a multi-step workflow:

1. Load environment - Retrieve environment from repository
2. Validate state - Ensure environment is in a valid state for running
3. Start services - Start the deployed software stack on the target instance

State Management

The command handler integrates with the type-state pattern for environment lifecycle:

• Accepts environment in Released state
• Transitions to Environment<Running> at start
• Returns Environment<Running> on success
• Transitions to Environment<RunFailed> on error

State is persisted after each transition using the injected repository.

Re-exports

pub use errors::RunCommandHandlerError;

pub use handler::RunCommandHandler;

Modules

errors

Error types for the Run command handler

handler

Run command handler implementation