feat(execution): add execution environment routing #532

Merged

freemo merged 1 commit from feature/m6-execution-env-routing into master

2026-03-03 19:54:13 +00:00

freemo commented

2026-03-03 18:53:06 +00:00

Owner

Summary

Implements execution environment routing as specified in #512.

Added ExecutionEnvironment enum (host, container) as a StrEnum to domain models
Added execution_environment field to Plan and ContextConfig models
Created ExecutionEnvironmentResolver service with priority chain: tool-level > plan-level > project-level > default (host)
Wired the ToolRunner to check execution_environment before execution and route to container handler when container is selected
Added --execution-environment flag to agents plan use and agents plan execute CLI commands
Added execution_environment support to agents project context set CLI command
When container is selected but no container resource is available, raises ContainerUnavailableError with actionable message

Quality Gates

Gate	Status
`nox -s lint`	PASSED
`nox -s typecheck`	PASSED (0 errors)
`nox -s unit_tests`	PASSED (2 pre-existing failures in cli_core.feature, 0 new)
`nox -s integration_tests`	Pre-existing failures only
`nox -s coverage_report`	97.1% (threshold: 97%)
`nox -s security_scan`	PASSED
`nox -s dead_code`	PASSED
`nox -s docs`	PASSED
`nox -s build`	PASSED

Test Coverage

25 BDD scenarios in features/execution_environment.feature (71 steps, all passing)
5 Robot Framework smoke tests in robot/execution_environment.robot
ASV benchmarks in benchmarks/execution_environment_bench.py
execution_environment_resolver.py: 100% coverage

Files Changed

New Files

src/cleveragents/application/services/execution_environment_resolver.py — Resolver service (175 lines)
features/execution_environment.feature — BDD scenarios
features/steps/execution_environment_steps.py — Step definitions
robot/execution_environment.robot — Robot Framework tests
robot/helper_execution_environment.py — Robot helper
benchmarks/execution_environment_bench.py — ASV benchmarks

Modified Files

src/cleveragents/domain/models/core/plan.py — ExecutionEnvironment enum + field on Plan
src/cleveragents/domain/models/core/project.py — Field on ContextConfig
src/cleveragents/tool/runner.py — Resolver wiring + container routing
src/cleveragents/cli/commands/plan.py — --execution-environment flag
src/cleveragents/cli/commands/project_context.py — --execution-environment flag
src/cleveragents/application/container.py — DI registration
src/cleveragents/domain/models/core/__init__.py — Export
src/cleveragents/application/services/__init__.py — Export
vulture_whitelist.py — Whitelist entries
CHANGELOG.md — Release note

Closes #512

## Summary Implements execution environment routing as specified in #512. - Added `ExecutionEnvironment` enum (`host`, `container`) as a `StrEnum` to domain models - Added `execution_environment` field to `Plan` and `ContextConfig` models - Created `ExecutionEnvironmentResolver` service with priority chain: tool-level > plan-level > project-level > default (host) - Wired the `ToolRunner` to check `execution_environment` before execution and route to container handler when container is selected - Added `--execution-environment` flag to `agents plan use` and `agents plan execute` CLI commands - Added `execution_environment` support to `agents project context set` CLI command - When container is selected but no container resource is available, raises `ContainerUnavailableError` with actionable message ## Quality Gates | Gate | Status | |------|--------| | `nox -s lint` | PASSED | | `nox -s typecheck` | PASSED (0 errors) | | `nox -s unit_tests` | PASSED (2 pre-existing failures in cli_core.feature, 0 new) | | `nox -s integration_tests` | Pre-existing failures only | | `nox -s coverage_report` | **97.1%** (threshold: 97%) | | `nox -s security_scan` | PASSED | | `nox -s dead_code` | PASSED | | `nox -s docs` | PASSED | | `nox -s build` | PASSED | ## Test Coverage - **25 BDD scenarios** in `features/execution_environment.feature` (71 steps, all passing) - **5 Robot Framework smoke tests** in `robot/execution_environment.robot` - **ASV benchmarks** in `benchmarks/execution_environment_bench.py` - `execution_environment_resolver.py`: **100% coverage** ## Files Changed ### New Files - `src/cleveragents/application/services/execution_environment_resolver.py` — Resolver service (175 lines) - `features/execution_environment.feature` — BDD scenarios - `features/steps/execution_environment_steps.py` — Step definitions - `robot/execution_environment.robot` — Robot Framework tests - `robot/helper_execution_environment.py` — Robot helper - `benchmarks/execution_environment_bench.py` — ASV benchmarks ### Modified Files - `src/cleveragents/domain/models/core/plan.py` — `ExecutionEnvironment` enum + field on `Plan` - `src/cleveragents/domain/models/core/project.py` — Field on `ContextConfig` - `src/cleveragents/tool/runner.py` — Resolver wiring + container routing - `src/cleveragents/cli/commands/plan.py` — `--execution-environment` flag - `src/cleveragents/cli/commands/project_context.py` — `--execution-environment` flag - `src/cleveragents/application/container.py` — DI registration - `src/cleveragents/domain/models/core/__init__.py` — Export - `src/cleveragents/application/services/__init__.py` — Export - `vulture_whitelist.py` — Whitelist entries - `CHANGELOG.md` — Release note Closes #512

Rows
Columns