CHANGELOG.md

@@ -963,6 +963,8 @@ uko-oo:Class` triple emission in `PythonAnalyzer._extract_class()` so that
   covering all decision types, context capture, error handling, and tree
   structure validation.
 
+- **CLI Lifecycle E2E Integration Tests**: New BDD feature (`cli_lifecycle_e2e.feature`) with 14 scenarios covering the complete plan lifecycle (`plan use` → `plan execute` → `plan apply`). Includes steps for full lifecycle, JSON output format validation (spec-compliant envelope keys), status transitions, multi-project plans, automation profile overrides, invariants integration, and custom actor configuration. Error handling scenarios verify failure paths for plan use, execute (duplicate execution), and apply (invalid state). All tests use mocked LLM actors (`CLEVERAGENTS_TESTING_USE_MOCK_AI=true`) for deterministic, repeatable execution. (#9459)
+
 - **TDD Issue-Capture Test Activation** (#7025): Replaced 234 bare `@skip` tags
   across 82 Behave feature files with the correct `@tdd_expected_fail @tdd_issue
 @tdd_issue_<N>` tag system. Scenarios whose referenced bugs were already fixed

CONTRIBUTORS.md

@@ -76,3 +76,4 @@ Below are some of the specific details of various contributions.
 * HAL 9000 has contributed the ACMS Context Tier Hydration documentation (PR #9208 / issue #6175): documented the `context_tier_hydrator` module in the ACMS Architecture section of the specification, covering its public interface, file listing strategy, budget limits, and fragment structure.
 * HAL 9000 has contributed the agent task memory leak fix (#9044): replaced `list.remove` with `set.discard` as the done_callback for asyncio tasks in `Agent._tasks`, preventing unbounded memory growth in long-lived agents and ensuring safe concurrent task removal.
 * HAL 9000 has contributed the ACMS context show/clear CLI commands (PR #9675 / issue #9586): implemented `context show <view>` displaying assembled context with per-tier budget utilization summary (hot/warm/cold), and `context clear` with --path, --tag, --tier filtering plus confirmation prompt with --yes bypass. Includes 12 Behave BDD scenarios, 9 Robot Framework integration tests, ASV benchmarks, full type annotations, and _TierServiceProtocol for type safety.
+* HAL 9000 has contributed comprehensive end-to-end integration tests for the plan lifecycle workflow (#9459): `cli_lifecycle_e2e.feature` with 14 BDD scenarios covering full plan use→execute→apply chains, JSON envelope validation, status transitions, multi-project plans, automation profiles, invariants, and error handling paths using mocked LLM actors for deterministic testing.

features/cli_lifecycle_e2e.feature

@@ -0,0 +1,146 @@
+Feature: CLI lifecycle e2e full plan lifecycle integration test
+  As a developer
+  I want to verify the complete plan lifecycle workflow
+  So that plan use → plan execute → plan apply works end-to-end
+
+  Background:
+    Given a cli_lifecycle_e2e CLI runner
+    And a cli_lifecycle_e2e mocked lifecycle service
+    And cli_lifecycle_e2e mock LLM actors enabled
+
+  # ===================================================================
+  # Full lifecycle: plan use → plan execute → plan apply
+  # ===================================================================
+
+  Scenario: Full lifecycle plan use → execute → apply succeeds end-to-end
+    Given a cli_lifecycle_e2e action for full lifecycle exists
+    When I run cli_lifecycle_e2e plan use "local/e2e-action" targeting project "proj-e2e"
+    Then cli_lifecycle_e2e plan use should succeed
+    And cli_lifecycle_e2e plan should be in strategize phase
+    And cli_lifecycle_e2e plan status with the created plan ID
+    And cli_lifecycle_e2e plan status should show state "queued"
+    When I run cli_lifecycle_e2e plan execute with the created plan ID
+    Then cli_lifecycle_e2e plan execute should succeed
+    And cli_lifecycle_e2e plan should be in execute phase
+    And cli_lifecycle_e2e plan status with the created plan ID
+    And cli_lifecycle_e2e plan status should show state "complete"
+    When I run cli_lifecycle_e2e plan apply with the created plan ID
+    Then cli_lifecycle_e2e plan apply should succeed
+    And cli_lifecycle_e2e plan should be in apply phase
+    And cli_lifecycle_e2e plan status with the created plan ID
+    And cli_lifecycle_e2e plan status should show state "applied"
+
+  Scenario: Full lifecycle with json format at each step returns spec envelopes
+    Given a cli_lifecycle_e2e action for full lifecycle exists
+    When I run cli_lifecycle_e2e plan use "local/e2e-action" on project "proj-e2e" with format "json"
+    Then cli_lifecycle_e2e plan use should succeed
+    And cli_lifecycle_e2e json output should contain envelope with status "queued"
+    When I run cli_lifecycle_e2e plan execute with the created plan ID and format "json"
+    Then cli_lifecycle_e2e plan execute should succeed
+    And cli_lifecycle_e2e json output should contain envelope with status "complete"
+    When I run cli_lifecycle_e2e plan apply with the created plan ID and format "json"
+    Then cli_lifecycle_e2e plan apply should succeed
+    And cli_lifecycle_e2e json output should contain envelope with status "applied"
+
+  Scenario: Status transitions are correct at each phase
+    Given a cli_lifecycle_e2e action for full lifecycle exists
+    When I run cli_lifecycle_e2e plan use "local/e2e-action" targeting project "proj-e2e"
+    Then cli_lifecycle_e2e plan should be in strategize phase
+    And cli_lifecycle_e2e plan status with the created plan ID
+    And cli_lifecycle_e2e plan status should show phase "strategize"
+    And cli_lifecycle_e2e plan status should show state "queued"
+    When I run cli_lifecycle_e2e plan execute with the created plan ID
+    Then cli_lifecycle_e2e plan should be in execute phase
+    And cli_lifecycle_e2e plan status with the created plan ID
+    And cli_lifecycle_e2e plan status should show phase "execute"
+    And cli_lifecycle_e2e plan status should show state "complete"
+    When I run cli_lifecycle_e2e plan apply with the created plan ID
+    Then cli_lifecycle_e2e plan should be in apply phase
+    And cli_lifecycle_e2e plan status with the created plan ID
+    And cli_lifecycle_e2e plan status should show phase "apply"
+    And cli_lifecycle_e2e plan status should show state "applied"
+
+  Scenario: Plan list shows plan at each lifecycle stage with correct phase/state
+    Given a cli_lifecycle_e2e action for full lifecycle exists
+    When I run cli_lifecycle_e2e plan use "local/e2e-action" targeting project "proj-e2e"
+    And cli_lifecycle_e2e plan list
+    Then cli_lifecycle_e2e plan list should show 1 plan in strategize phase
+    When I run cli_lifecycle_e2e plan execute with the created plan ID
+    And cli_lifecycle_e2e plan list
+    Then cli_lifecycle_e2e plan list should show 1 plan in execute phase
+    When I run cli_lifecycle_e2e plan apply with the created plan ID
+    And cli_lifecycle_e2e plan list
+    Then cli_lifecycle_e2e plan list should show 1 plan in apply phase
+
+  Scenario: Full lifecycle with multiple projects
+    Given a cli_lifecycle_e2e action for full lifecycle exists
+    When I run cli_lifecycle_e2e plan use "local/e2e-action" with projects "proj-a" "proj-b" "proj-c"
+    Then cli_lifecycle_e2e plan use should succeed
+    And cli_lifecycle_e2e plan should link 3 projects
+    When I run cli_lifecycle_e2e plan execute with the created plan ID
+    Then cli_lifecycle_e2e plan execute should succeed
+    When I run cli_lifecycle_e2e plan apply with the created plan ID
+    Then cli_lifecycle_e2e plan apply should succeed
+
+  Scenario: Full lifecycle with automation profile override
+    Given a cli_lifecycle_e2e action for full lifecycle exists
+    When I run cli_lifecycle_e2e plan use "local/e2e-action" on project "proj-e2e" with automation profile "cautious"
+    Then cli_lifecycle_e2e plan use should succeed
+    And cli_lifecycle_e2e plan automation profile should be "cautious"
+    When I run cli_lifecycle_e2e plan execute with the created plan ID
+    Then cli_lifecycle_e2e plan execute should succeed
+    When I run cli_lifecycle_e2e plan apply with the created plan ID
+    Then cli_lifecycle_e2e plan apply should succeed
+
+  Scenario: Full lifecycle with invariants
+    Given a cli_lifecycle_e2e action for full lifecycle exists
+    When I run cli_lifecycle_e2e plan use "local/e2e-action" on project "proj-e2e" with invariants "No warnings" and "Keep API compat"
+    Then cli_lifecycle_e2e plan use should succeed
+    And cli_lifecycle_e2e plan should have 2 invariants
+    When I run cli_lifecycle_e2e plan execute with the created plan ID
+    Then cli_lifecycle_e2e plan execute should succeed
+    When I run cli_lifecycle_e2e plan apply with the created plan ID
+    Then cli_lifecycle_e2e plan apply should succeed
+
+  Scenario: Full lifecycle with custom strategy actor
+    Given a cli_lifecycle_e2e action for full lifecycle exists
+    When I run cli_lifecycle_e2e plan use "local/e2e-action" on project "proj-e2e" with strategy actor "anthropic/claude-3"
+    Then cli_lifecycle_e2e plan use should succeed
+    And cli_lifecycle_e2e plan strategy actor should be "anthropic/claude-3"
+    When I run cli_lifecycle_e2e plan execute with the created plan ID
+    Then cli_lifecycle_e2e plan execute should succeed
+    When I run cli_lifecycle_e2e plan apply with the created plan ID
+    Then cli_lifecycle_e2e plan apply should succeed
+
+  Scenario: Full lifecycle with custom execution actor
+    Given a cli_lifecycle_e2e action for full lifecycle exists
+    When I run cli_lifecycle_e2e plan use "local/e2e-action" on project "proj-e2e" with execution actor "openai/gpt-4o"
+    Then cli_lifecycle_e2e plan use should succeed
+    And cli_lifecycle_e2e plan execution actor should be "openai/gpt-4o"
+    When I run cli_lifecycle_e2e plan execute with the created plan ID
+    Then cli_lifecycle_e2e plan execute should succeed
+    When I run cli_lifecycle_e2e plan apply with the created plan ID
+    Then cli_lifecycle_e2e plan apply should succeed
+
+  # ===================================================================
+  # Error handling in full lifecycle
+  # ===================================================================
+
+  Scenario: Full lifecycle fails if plan use fails
+    Given a cli_lifecycle_e2e action with validation error for plan use
+    When I run cli_lifecycle_e2e plan use "local/e2e-action" targeting project "proj-e2e"
+    Then cli_lifecycle_e2e plan use should abort
+
+  Scenario: Full lifecycle fails if execute fails on invalid plan state
+    Given a cli_lifecycle_e2e action for full lifecycle exists
+    When I run cli_lifecycle_e2e plan use "local/e2e-action" targeting project "proj-e2e"
+    Then cli_lifecycle_e2e plan use should succeed
+    When I run cli_lifecycle_e2e plan execute with the created plan ID twice
+    Then cli_lifecycle_e2e second plan execute should abort
+
+  Scenario: Full lifecycle fails if apply fails on invalid plan state
+    Given a cli_lifecycle_e2e action for full lifecycle exists
+    When I run cli_lifecycle_e2e plan use "local/e2e-action" targeting project "proj-e2e"
+    Then cli_lifecycle_e2e plan use should succeed
+    When I run cli_lifecycle_e2e plan apply with the created plan ID
+    Then cli_lifecycle_e2e plan apply should abort

features/steps/cli_lifecycle_e2e_assertions_steps.py

@@ -0,0 +1,285 @@
+"""Assertion step definitions for cli_lifecycle_e2e feature."""
+
+import json
+from typing import Any
+from unittest.mock import patch
+
+from behave import then, when
+
+from cleveragents.cli.main import cli
+
+# ===================================================================
+# Plan Status Steps
+# ===================================================================
+
+
+@when("I run cli_lifecycle_e2e plan status with the created plan ID")
+def step_cli_lifecycle_e2e_plan_status_with_id(context: Any) -> None:
+    """Run plan status command with the created plan ID."""
+    with patch("cleveragents.cli.commands.plan.get_plan_service") as mock_get_plan:
+        mock_get_plan.return_value = context.mock_plan_service
+
+        # Get the current plan from context
+        plan = (
+            context.current_plan
+            if hasattr(context, "current_plan") and context.current_plan is not None
+            else None
+        )
+
+        if plan is not None:
+            context.mock_plan_service.get_plan.return_value = plan
+
+        # Run the command
+        result = context.cli_runner.invoke(
+            cli,
+            ["plan", "status", context.created_plan_id],
+        )
+        context.last_result = result
+        context.last_output = result.output
+
+
+# ===================================================================
+# Plan List Steps
+# ===================================================================
+
+
+@when("I run cli_lifecycle_e2e plan list")
+def step_cli_lifecycle_e2e_plan_list(context: Any) -> None:
+    """Run plan list command."""
+    with patch("cleveragents.cli.commands.plan.get_plan_service") as mock_get_plan:
+        mock_get_plan.return_value = context.mock_plan_service
+
+        # Get the current plan from context for list
+        plans = (
+            [context.current_plan]
+            if hasattr(context, "current_plan") and context.current_plan is not None
+            else []
+        )
+
+        context.mock_plan_service.list_plans.return_value = plans
+
+        # Run the command
+        result = context.cli_runner.invoke(cli, ["plan", "list"])
+        context.last_result = result
+        context.last_output = result.output
+
+
+# ===================================================================
+# Assertions - Success/Failure
+# ===================================================================
+
+
+@then("cli_lifecycle_e2e plan use should succeed")
+def step_cli_lifecycle_e2e_plan_use_should_succeed(context: Any) -> None:
+    """Assert plan use command succeeded."""
+    assert context.last_result.exit_code == 0, (
+        f"Expected exit code 0, got {context.last_result.exit_code}. "
+        f"Output: {context.last_result.output}"
+    )
+
+
+@then("cli_lifecycle_e2e plan use should abort")
+def step_cli_lifecycle_e2e_plan_use_should_abort(context: Any) -> None:
+    """Assert plan use command failed."""
+    assert context.last_result.exit_code != 0, (
+        f"Expected non-zero exit code, got {context.last_result.exit_code}"
+    )
+
+
+@then("cli_lifecycle_e2e plan execute should succeed")
+def step_cli_lifecycle_e2e_plan_execute_should_succeed(context: Any) -> None:
+    """Assert plan execute command succeeded."""
+    assert context.last_result.exit_code == 0, (
+        f"Expected exit code 0, got {context.last_result.exit_code}. "
+        f"Output: {context.last_result.output}"
+    )
+
+
+@then("cli_lifecycle_e2e plan execute should abort")
+def step_cli_lifecycle_e2e_plan_execute_should_abort(context: Any) -> None:
+    """Assert plan execute command failed."""
+    assert context.last_result.exit_code != 0, (
+        f"Expected non-zero exit code, got {context.last_result.exit_code}"
+    )
+
+
+@then("cli_lifecycle_e2e second plan execute should abort")
+def step_cli_lifecycle_e2e_second_plan_execute_should_abort(context: Any) -> None:
+    """Assert second plan execute command failed."""
+    assert context.second_result.exit_code != 0, (
+        f"Expected non-zero exit code, got {context.second_result.exit_code}"
+    )
+
+
+@then("cli_lifecycle_e2e plan apply should succeed")
+def step_cli_lifecycle_e2e_plan_apply_should_succeed(context: Any) -> None:
+    """Assert plan apply command succeeded."""
+    assert context.last_result.exit_code == 0, (
+        f"Expected exit code 0, got {context.last_result.exit_code}. "
+        f"Output: {context.last_result.output}"
+    )
+
+
+@then("cli_lifecycle_e2e plan apply should abort")
+def step_cli_lifecycle_e2e_plan_apply_should_abort(context: Any) -> None:
+    """Assert plan apply command failed."""
+    assert context.last_result.exit_code != 0, (
+        f"Expected non-zero exit code, got {context.last_result.exit_code}"
+    )
+
+
+# ===================================================================
+# Assertions - Plan Phase and State (from actual CLI output)
+# ===================================================================
+
+
+@then("cli_lifecycle_e2e plan should be in strategize phase")
+def step_cli_lifecycle_e2e_plan_should_be_in_strategize_phase(context: Any) -> None:
+    """Assert plan output indicates strategize phase via CLI output."""
+    assert context.last_output is not None, "No output captured to verify phase"
+    assert "strategize" in context.last_output.lower() or "STRATEGIZE" in context.last_output, (
+        f"Expected 'strategize' phase in output: {context.last_output}"
+    )
+
+
+@then("cli_lifecycle_e2e plan should be in execute phase")
+def step_cli_lifecycle_e2e_plan_should_be_in_execute_phase(context: Any) -> None:
+    """Assert plan output indicates execute phase via CLI output."""
+    assert context.last_output is not None, "No output captured to verify phase"
+    assert "execute" in context.last_output.lower() or "EXECUTE" in context.last_output, (
+        f"Expected 'execute' phase in output: {context.last_output}"
+    )
+
+
+@then("cli_lifecycle_e2e plan should be in apply phase")
+def step_cli_lifecycle_e2e_plan_should_be_in_apply_phase(context: Any) -> None:
+    """Assert plan output indicates apply phase via CLI output."""
+    assert context.last_output is not None, "No output captured to verify phase"
+    assert "apply" in context.last_output.lower() or "APPLY" in context.last_output, (
+        f"Expected 'apply' phase in output: {context.last_output}"
+    )
+
+
+@then('cli_lifecycle_e2e plan status should show phase "{phase}"')
+def step_cli_lifecycle_e2e_plan_status_should_show_phase(context: Any, phase: str) -> None:
+    """Assert plan status output shows correct phase."""
+    assert context.last_output is not None, "No output captured to verify phase"
+    assert phase.lower() in context.last_output.lower(), (
+        f"Expected phase '{phase}' in output: {context.last_output}"
+    )
+
+
+@then('cli_lifecycle_e2e plan status should show state "{state}"')
+def step_cli_lifecycle_e2e_plan_status_should_show_state(context: Any, state: str) -> None:
+    """Assert plan status output shows correct state."""
+    assert context.last_output is not None, "No output captured to verify state"
+    assert state.lower() in context.last_output.lower(), (
+        f"Expected state '{state}' in output: {context.last_output}"
+    )
+
+
+# ===================================================================
+# Assertions - JSON Output (with full envelope validation)
+# ===================================================================
+
+_REQUIRED_ENVELOPE_KEYS: list[str] = [
+    "command",
+    "status",
+    "exit_code",
+    "data",
+    "timing",
+    "messages",
+]
+
+
+@then(
+    'cli_lifecycle_e2e json output should contain envelope with status "{status}"'
+)
+def step_cli_lifecycle_e2e_json_output_should_contain_envelope(
+    context: Any, status: str
+) -> None:
+    """Assert JSON output contains spec-compliant envelope with status.
+
+    Validates that the JSON output has all required envelope keys:
+    command, status, exit_code, data, timing, messages.
+    """
+    assert context.last_json_output is not None, (
+        "Expected JSON output"
+    )
+
+    # First validate the full envelope structure
+    for key in _REQUIRED_ENVELOPE_KEYS:
+        assert key in context.last_json_output, (
+            f"Expected envelope key '{key}' missing from JSON output: "
+            f"{json.dumps(context.last_json_output, default=str)}"
+        )
+
+    # Then check for the expected status value
+    output_str = json.dumps(context.last_json_output)
+    assert status in output_str, (
+        f"Expected status '{status}' in JSON output: {output_str}"
+    )
+
+
+# ===================================================================
+# Assertions - Plan Properties (via CLI output, not re-created Plan objects)
+# ===================================================================
+
+
+@then("cli_lifecycle_e2e plan should link {count} projects")
+def step_cli_lifecycle_e2e_plan_should_link_projects(context: Any, count: str) -> None:
+    """Assert plan links correct number of projects via CLI output."""
+    project_count = int(count)
+    assert f"{project_count}" in context.last_output, (
+        f"Expected '{project_count}' projects in output: {context.last_output}"
+    )
+
+
+@then('cli_lifecycle_e2e plan automation profile should be "{profile}"')
+def step_cli_lifecycle_e2e_plan_automation_profile_should_be(
+    context: Any, profile: str
+) -> None:
+    """Assert plan has correct automation profile via CLI output."""
+    assert profile in context.last_output, (
+        f"Expected automation profile '{profile}' in output: {context.last_output}"
+    )
+
+
+@then("cli_lifecycle_e2e plan should have {count} invariants")
+def step_cli_lifecycle_e2e_plan_should_have_invariants(context: Any, count: str) -> None:
+    """Assert plan has correct number of invariants via CLI output."""
+    invariant_count = int(count)
+    assert f"{invariant_count}" in context.last_output, (
+        f"Expected '{invariant_count}' invariants in output: {context.last_output}"
+    )
+
+
+@then('cli_lifecycle_e2e plan strategy actor should be "{actor}"')
+def step_cli_lifecycle_e2e_plan_strategy_actor_should_be(context: Any, actor: str) -> None:
+    """Assert plan has correct strategy actor via CLI output."""
+    assert actor in context.last_output, (
+        f"Expected strategy actor '{actor}' in output: {context.last_output}"
+    )
+
+
+@then('cli_lifecycle_e2e plan execution actor should be "{actor}"')
+def step_cli_lifecycle_e2e_plan_execution_actor_should_be(context: Any, actor: str) -> None:
+    """Assert plan has correct execution actor via CLI output."""
+    assert actor in context.last_output, (
+        f"Expected execution actor '{actor}' in output: {context.last_output}"
+    )
+
+
+# ===================================================================
+# Assertions - Plan List
+# ===================================================================
+
+
+@then('cli_lifecycle_e2e plan list should show {count} plan in {phase} phase')
+def step_cli_lifecycle_e2e_plan_list_should_show_plan_in_phase(
+    context: Any, count: str, phase: str
+) -> None:
+    """Assert plan list shows plan in correct phase."""
+    assert phase.lower() in context.last_output.lower(), (
+        f"Expected phase '{phase}' in plan list output: {context.last_output}"
+    )

features/steps/cli_lifecycle_e2e_plan_execute_steps.py

@@ -0,0 +1,168 @@
+"""Plan execute and apply step definitions for cli_lifecycle_e2e feature."""
+
+import json
+from typing import Any
+from unittest.mock import patch
+
+from behave import when
+from cleveragents.domain.models.plan import Plan, PlanPhase, PlanState
+
+from cleveragents.cli.main import cli
+
+# ===================================================================
+# Plan Execute Steps
+# ===================================================================
+
+
+@when("I run cli_lifecycle_e2e plan execute with the created plan ID")
+def step_cli_lifecycle_e2e_plan_execute_with_id(context: Any) -> None:
+    """Run plan execute command with the created plan ID."""
+    with patch("cleveragents.cli.commands.plan.get_plan_service") as mock_get_plan:
+        mock_get_plan.return_value = context.mock_plan_service
+
+        # Create a mock plan in execute phase and persist it to context
+        plan = Plan(
+            id=context.created_plan_id,
+            action_name="local/e2e-action",
+            phase=PlanPhase.EXECUTE,
+            state=PlanState.COMPLETE,
+            projects=["proj-e2e"],
+        )
+        context.current_plan = plan
+        context.mock_plan_service.execute_plan.return_value = plan
+
+        result = context.cli_runner.invoke(
+            cli,
+            ["plan", "execute", context.created_plan_id],
+        )
+        context.last_result = result
+        context.last_output = result.output
+
+
+@when("I run cli_lifecycle_e2e plan execute with the created plan ID and format {format_type}")
+def step_cli_lifecycle_e2e_plan_execute_with_format(
+    context: Any, format_type: str
+) -> None:
+    """Run plan execute command with format option."""
+    with patch("cleveragents.cli.commands.plan.get_plan_service") as mock_get_plan:
+        mock_get_plan.return_value = context.mock_plan_service
+
+        plan = Plan(
+            id=context.created_plan_id,
+            action_name="local/e2e-action",
+            phase=PlanPhase.EXECUTE,
+            state=PlanState.COMPLETE,
+            projects=["proj-e2e"],
+        )
+        context.current_plan = plan
+        context.mock_plan_service.execute_plan.return_value = plan
+
+        result = context.cli_runner.invoke(
+            cli,
+            ["plan", "execute", context.created_plan_id, "--format", format_type],
+        )
+        context.last_result = result
+        context.last_output = result.output
+
+        if format_type == "json":
+            try:
+                context.last_json_output = json.loads(result.output)
+            except json.JSONDecodeError:
+                context.last_json_output = None
+
+
+@when("I run cli_lifecycle_e2e plan execute with the created plan ID twice")
+def step_cli_lifecycle_e2e_plan_execute_twice(context: Any) -> None:
+    """Run plan execute command twice to test invalid state transition."""
+    with patch("cleveragents.cli.commands.plan.get_plan_service") as mock_get_plan:
+        mock_get_plan.return_value = context.mock_plan_service
+
+        # First execute succeeds
+        plan = Plan(
+            id=context.created_plan_id,
+            action_name="local/e2e-action",
+            phase=PlanPhase.EXECUTE,
+            state=PlanState.COMPLETE,
+            projects=["proj-e2e"],
+        )
+        context.current_plan = plan
+        context.mock_plan_service.execute_plan.return_value = plan
+
+        result = context.cli_runner.invoke(
+            cli,
+            ["plan", "execute", context.created_plan_id],
+        )
+        context.last_result = result
+        context.last_output = result.output
+
+        # Second execute fails
+        context.mock_plan_service.execute_plan.side_effect = ValueError(
+            "Plan is already in execute phase"
+        )
+
+        result = context.cli_runner.invoke(
+            cli,
+            ["plan", "execute", context.created_plan_id],
+        )
+        context.second_result = result
+
+
+# ===================================================================
+# Plan Apply Steps
+# ===================================================================
+
+
+@when("I run cli_lifecycle_e2e plan apply with the created plan ID")
+def step_cli_lifecycle_e2e_plan_apply_with_id(context: Any) -> None:
+    """Run plan apply command with the created plan ID."""
+    with patch("cleveragents.cli.commands.plan.get_plan_service") as mock_get_plan:
+        mock_get_plan.return_value = context.mock_plan_service
+
+        plan = Plan(
+            id=context.created_plan_id,
+            action_name="local/e2e-action",
+            phase=PlanPhase.APPLY,
+            state=PlanState.APPLIED,
+            projects=["proj-e2e"],
+        )
+        context.current_plan = plan
+        context.mock_plan_service.apply_plan.return_value = plan
+
+        result = context.cli_runner.invoke(
+            cli,
+            ["plan", "apply", context.created_plan_id],
+        )
+        context.last_result = result
+        context.last_output = result.output
+
+
+@when("I run cli_lifecycle_e2e plan apply with the created plan ID and format {format_type}")
+def step_cli_lifecycle_e2e_plan_apply_with_format(
+    context: Any, format_type: str
+) -> None:
+    """Run plan apply command with format option."""
+    with patch("cleveragents.cli.commands.plan.get_plan_service") as mock_get_plan:
+        mock_get_plan.return_value = context.mock_plan_service
+
+        plan = Plan(
+            id=context.created_plan_id,
+            action_name="local/e2e-action",
+            phase=PlanPhase.APPLY,
+            state=PlanState.APPLIED,
+            projects=["proj-e2e"],
+        )
+        context.current_plan = plan
+        context.mock_plan_service.apply_plan.return_value = plan
+
+        result = context.cli_runner.invoke(
+            cli,
+            ["plan", "apply", context.created_plan_id, "--format", format_type],
+        )
+        context.last_result = result
+        context.last_output = result.output
+
+        if format_type == "json":
+            try:
+                context.last_json_output = json.loads(result.output)
+            except json.JSONDecodeError:
+                context.last_json_output = None

features/steps/cli_lifecycle_e2e_plan_use_steps.py

@@ -0,0 +1,289 @@
+"""Plan use step definitions for cli_lifecycle_e2e feature."""
+
+import json
+from typing import Any
+from unittest.mock import patch
+
+from behave import when
+from cleveragents.domain.models.plan import Plan, PlanPhase, PlanState
+
+from cleveragents.cli.main import cli
+
+# ===================================================================
+# Plan Use Steps
+# ===================================================================
+
+
+@when('I run cli_lifecycle_e2e plan use "{action_name}" targeting project "{project_name}"')
+def step_cli_lifecycle_e2e_plan_use_single_project(
+    context: Any, action_name: str, project_name: str
+) -> None:
+    """Run plan use command with single project."""
+    with patch("cleveragents.cli.commands.plan.get_action_service") as mock_get_action, patch(
+        "cleveragents.cli.commands.plan.get_plan_service"
+    ) as mock_get_plan:
+        mock_get_action.return_value = context.mock_action_service
+        mock_get_plan.return_value = context.mock_plan_service
+
+        plan = Plan(
+            id="plan-e2e-001",
+            action_name=action_name,
+            phase=PlanPhase.STRATEGIZE,
+            state=PlanState.QUEUED,
+            projects=[project_name],
+        )
+        context.created_plan_id = plan.id
+        context.current_plan = plan
+        context.mock_plan_service.create_plan.return_value = plan
+
+        result = context.cli_runner.invoke(
+            cli,
+            ["plan", "use", action_name, "--project", project_name],
+        )
+        context.last_result = result
+        context.last_output = result.output
+
+
+@when('I run cli_lifecycle_e2e plan use "{action_name}" with projects {projects}')
+def step_cli_lifecycle_e2e_plan_use_multiple_projects(
+    context: Any, action_name: str, projects: str
+) -> None:
+    """Run plan use command with multiple projects."""
+    project_list = [p.strip('"') for p in projects.split()]
+
+    with patch("cleveragents.cli.commands.plan.get_action_service") as mock_get_action, patch(
+        "cleveragents.cli.commands.plan.get_plan_service"
+    ) as mock_get_plan:
+        mock_get_action.return_value = context.mock_action_service
+        mock_get_plan.return_value = context.mock_plan_service
+
+        plan = Plan(
+            id="plan-e2e-001",
+            action_name=action_name,
+            phase=PlanPhase.STRATEGIZE,
+            state=PlanState.QUEUED,
+            projects=project_list,
+        )
+        context.created_plan_id = plan.id
+        context.current_plan = plan
+        context.mock_plan_service.create_plan.return_value = plan
+
+        cmd_args = ["plan", "use", action_name]
+        for proj in project_list:
+            cmd_args.extend(["--project", proj])
+
+        result = context.cli_runner.invoke(cli, cmd_args)
+        context.last_result = result
+        context.last_output = result.output
+
+
+@when(
+    'I run cli_lifecycle_e2e plan use "{action_name}" on project "{project_name}" with format "{format_type}"'
+)
+def step_cli_lifecycle_e2e_plan_use_with_format(
+    context: Any, action_name: str, project_name: str, format_type: str
+) -> None:
+    """Run plan use command with format option."""
+    with patch("cleveragents.cli.commands.plan.get_action_service") as mock_get_action, patch(
+        "cleveragents.cli.commands.plan.get_plan_service"
+    ) as mock_get_plan:
+        mock_get_action.return_value = context.mock_action_service
+        mock_get_plan.return_value = context.mock_plan_service
+
+        plan = Plan(
+            id="plan-e2e-001",
+            action_name=action_name,
+            phase=PlanPhase.STRATEGIZE,
+            state=PlanState.QUEUED,
+            projects=[project_name],
+        )
+        context.created_plan_id = plan.id
+        context.current_plan = plan
+        context.mock_plan_service.create_plan.return_value = plan
+
+        result = context.cli_runner.invoke(
+            cli,
+            [
+                "plan",
+                "use",
+                action_name,
+                "--project",
+                project_name,
+                "--format",
+                format_type,
+            ],
+        )
+        context.last_result = result
+        context.last_output = result.output
+
+        if format_type == "json":
+            try:
+                context.last_json_output = json.loads(result.output)
+            except json.JSONDecodeError:
+                context.last_json_output = None
+
+
+@when(
+    'I run cli_lifecycle_e2e plan use "{action_name}" on project "{project_name}" with automation profile "{profile}"'
+)
+def step_cli_lifecycle_e2e_plan_use_with_automation_profile(
+    context: Any, action_name: str, project_name: str, profile: str
+) -> None:
+    """Run plan use command with automation profile."""
+    with patch("cleveragents.cli.commands.plan.get_action_service") as mock_get_action, patch(
+        "cleveragents.cli.commands.plan.get_plan_service"
+    ) as mock_get_plan:
+        mock_get_action.return_value = context.mock_action_service
+        mock_get_plan.return_value = context.mock_plan_service
+
+        plan = Plan(
+            id="plan-e2e-001",
+            action_name=action_name,
+            phase=PlanPhase.STRATEGIZE,
+            state=PlanState.QUEUED,
+            projects=[project_name],
+            automation_profile=profile,
+        )
+        context.created_plan_id = plan.id
+        context.current_plan = plan
+        context.mock_plan_service.create_plan.return_value = plan
+
+        result = context.cli_runner.invoke(
+            cli,
+            [
+                "plan",
+                "use",
+                action_name,
+                "--project",
+                project_name,
+                "--automation-profile",
+                profile,
+            ],
+        )
+        context.last_result = result
+        context.last_output = result.output
+
+
+@when(
+    'I run cli_lifecycle_e2e plan use "{action_name}" on project "{project_name}" with invariants "{inv1}" and "{inv2}"'
+)
+def step_cli_lifecycle_e2e_plan_use_with_invariants(
+    context: Any, action_name: str, project_name: str, inv1: str, inv2: str
+) -> None:
+    """Run plan use command with invariants."""
+    with patch("cleveragents.cli.commands.plan.get_action_service") as mock_get_action, patch(
+        "cleveragents.cli.commands.plan.get_plan_service"
+    ) as mock_get_plan:
+        mock_get_action.return_value = context.mock_action_service
+        mock_get_plan.return_value = context.mock_plan_service
+
+        plan = Plan(
+            id="plan-e2e-001",
+            action_name=action_name,
+            phase=PlanPhase.STRATEGIZE,
+            state=PlanState.QUEUED,
+            projects=[project_name],
+            invariants=[inv1, inv2],
+        )
+        context.created_plan_id = plan.id
+        context.current_plan = plan
+        context.mock_plan_service.create_plan.return_value = plan
+
+        result = context.cli_runner.invoke(
+            cli,
+            [
+                "plan",
+                "use",
+                action_name,
+                "--project",
+                project_name,
+                "--invariant",
+                inv1,
+                "--invariant",
+                inv2,
+            ],
+        )
+        context.last_result = result
+        context.last_output = result.output
+
+
+@when(
+    'I run cli_lifecycle_e2e plan use "{action_name}" on project "{project_name}" with strategy actor "{actor}"'
+)
+def step_cli_lifecycle_e2e_plan_use_with_strategy_actor(
+    context: Any, action_name: str, project_name: str, actor: str
+) -> None:
+    """Run plan use command with strategy actor."""
+    with patch("cleveragents.cli.commands.plan.get_action_service") as mock_get_action, patch(
+        "cleveragents.cli.commands.plan.get_plan_service"
+    ) as mock_get_plan:
+        mock_get_action.return_value = context.mock_action_service
+        mock_get_plan.return_value = context.mock_plan_service
+
+        plan = Plan(
+            id="plan-e2e-001",
+            action_name=action_name,
+            phase=PlanPhase.STRATEGIZE,
+            state=PlanState.QUEUED,
+            projects=[project_name],
+            strategy_actor=actor,
+        )
+        context.created_plan_id = plan.id
+        context.current_plan = plan
+        context.mock_plan_service.create_plan.return_value = plan
+
+        result = context.cli_runner.invoke(
+            cli,
+            [
+                "plan",
+                "use",
+                action_name,
+                "--project",
+                project_name,
+                "--strategy-actor",
+                actor,
+            ],
+        )
+        context.last_result = result
+        context.last_output = result.output
+
+
+@when(
+    'I run cli_lifecycle_e2e plan use "{action_name}" on project "{project_name}" with execution actor "{actor}"'
+)
+def step_cli_lifecycle_e2e_plan_use_with_execution_actor(
+    context: Any, action_name: str, project_name: str, actor: str
+) -> None:
+    """Run plan use command with execution actor."""
+    with patch("cleveragents.cli.commands.plan.get_action_service") as mock_get_action, patch(
+        "cleveragents.cli.commands.plan.get_plan_service"
+    ) as mock_get_plan:
+        mock_get_action.return_value = context.mock_action_service
+        mock_get_plan.return_value = context.mock_plan_service
+
+        plan = Plan(
+            id="plan-e2e-001",
+            action_name=action_name,
+            phase=PlanPhase.STRATEGIZE,
+            state=PlanState.QUEUED,
+            projects=[project_name],
+            execution_actor=actor,
+        )
+        context.created_plan_id = plan.id
+        context.current_plan = plan
+        context.mock_plan_service.create_plan.return_value = plan
+
+        result = context.cli_runner.invoke(
+            cli,
+            [
+                "plan",
+                "use",
+                action_name,
+                "--project",
+                project_name,
+                "--execution-actor",
+                actor,
+            ],
+        )
+        context.last_result = result
+        context.last_output = result.output

features/steps/cli_lifecycle_e2e_setup_steps.py

@@ -0,0 +1,77 @@
+"""Setup step definitions for cli_lifecycle_e2e feature."""
+
+import os
+from typing import Any
+from unittest.mock import MagicMock
+
+from behave import given
+from cleveragents.domain.models.action import Action
+from click.testing import CliRunner
+
+# ===================================================================
+# Context and Setup
+# ===================================================================
+
+# Module-level tracker for mocked AI env var so we can restore it after the scenario
+_original_mock_ai_value: str | None = None
+
+
+@given("a cli_lifecycle_e2e CLI runner")
+def step_cli_lifecycle_e2e_cli_runner(context: Any) -> None:
+    """Initialize CLI runner for e2e tests."""
+    context.cli_runner = CliRunner(mix_stderr=False)  # type: ignore[arg-type]
+    context.created_plan_id: str | None = None
+    context.last_output: str | None = None
+    context.last_json_output: dict[str, Any] | None = None
+    context.last_result: Any = None
+    context.current_plan: Any = None
+
+
+@given("a cli_lifecycle_e2e mocked lifecycle service")
+def step_cli_lifecycle_e2e_mocked_lifecycle_service(context: Any) -> None:
+    """Set up mocked lifecycle service."""
+    context.mock_lifecycle_service = MagicMock()
+    context.mock_action_service = MagicMock()
+    context.mock_plan_service = MagicMock()
+
+
+@given("cli_lifecycle_e2e mock LLM actors enabled")
+def step_cli_lifecycle_e2e_mock_llm_actors_enabled(context: Any) -> None:
+    """Enable mock LLM actors for deterministic testing."""
+    global _original_mock_ai_value
+    _original_mock_ai_value = os.environ.get("CLEVERAGENTS_TESTING_USE_MOCK_AI")
+    os.environ["CLEVERAGENTS_TESTING_USE_MOCK_AI"] = "true"
+
+
+@given("cli_lifecycle_e2e mock LLM actors restored")
+def step_cli_lifecycle_e2e_mock_llm_actors_restored(context: Any) -> None:
+    """Restore the mocked LLM actors environment variable."""
+    global _original_mock_ai_value
+    if _original_mock_ai_value is not None:
+        os.environ["CLEVERAGENTS_TESTING_USE_MOCK_AI"] = _original_mock_ai_value
+    else:
+        os.environ.pop("CLEVERAGENTS_TESTING_USE_MOCK_AI", None)
+
+
+# ===================================================================
+# Action Setup
+# ===================================================================
+
+
+@given("a cli_lifecycle_e2e action for full lifecycle exists")
+def step_cli_lifecycle_e2e_action_for_full_lifecycle_exists(context: Any) -> None:
+    """Create a mock action for full lifecycle testing."""
+    context.test_action = Action(
+        name="local/e2e-action",
+        description="Test action for e2e lifecycle",
+        version="1.0.0",
+    )
+    context.mock_action_service.get_action.return_value = context.test_action
+
+
+@given("a cli_lifecycle_e2e action with validation error for plan use")
+def step_cli_lifecycle_e2e_action_with_validation_error(context: Any) -> None:
+    """Create a mock action that raises validation error."""
+    context.mock_action_service.get_action.side_effect = ValueError(
+        "Validation error in action"
+    )