Struct DestroyCommandHandler 

pub struct DestroyCommandHandler { /* private fields */ }

DestroyCommandHandler orchestrates the complete infrastructure destruction workflow

The DestroyCommandHandler orchestrates the complete infrastructure teardown workflow.

This command handler handles all steps required to destroy infrastructure:

1. Destroy infrastructure via OpenTofu
2. Clean up state files
3. Transition environment to Destroyed state

State Management

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

• Accepts Environment<S> (any state) as input via environment name lookup
• Transitions to Environment<Destroying> at start
• Returns Environment<Destroyed> on success
• Transitions to Environment<DestroyFailed> on error

State is persisted after each transition using the injected repository.

Idempotency

The destroy operation is idempotent. Running it multiple times on the same environment will:

• Succeed if the infrastructure is already destroyed
• Report appropriate status to the user
• Not fail due to missing resources

Implementations

impl DestroyCommandHandler

pub fn new( repository: Arc<dyn EnvironmentRepository>, clock: Arc<dyn Clock>, ) -> Self

Create a new DestroyCommandHandler

pub fn execute( &self, env_name: &EnvironmentName, ) -> Result<Environment<Destroyed>, DestroyCommandHandlerError>

Execute the complete destruction workflow

Arguments

• env_name - The name of the environment to destroy

Returns

Returns the destroyed environment

Errors

Returns an error if any step in the destruction workflow fails:

• Environment not found or cannot be loaded
• Environment is in an invalid state for destruction
• OpenTofu destroy fails
• Unable to persist the destroyed state

On error, the environment transitions to DestroyFailed state and is persisted.