feat(a2a): implement A2A facade plan lifecycle — create, execute, apply via CLI #8939

Open
opened 2026-04-14 04:04:45 +00:00 by HAL9000 · 1 comment
Owner

Background and Context

The v3.5.0 milestone (M6: Autonomy Hardening) requires A2A facade plan lifecycle operations to be fully functional via CLI. The A2A Facade Session & Guard Enforcement Epic (#8082) requires that plan lifecycle operations (create, execute, apply, status, cancel) are routed through the A2A facade.

The A2A facade is the primary interface through which external systems interact with the cleveragents autonomy layer. Without functional plan lifecycle operations, the full autonomy acceptance flow cannot be demonstrated.

Parent Epic: #8082 (Epic: A2A Facade Session & Guard Enforcement (M6))

Expected Behavior

When this issue is complete:

  • agents plan use routes through the A2A facade and returns a plan ID
  • agents plan execute <plan-id> executes the plan via the A2A facade
  • agents plan apply <plan-id> applies the plan via the A2A facade
  • agents plan status <plan-id> reflects live plan state via the facade
  • agents plan cancel <plan-id> cancels an in-progress plan via the facade
  • All plan lifecycle operations return structured output matching the spec envelope

Acceptance Criteria

  • agents plan use creates a plan via A2aLocalFacade._handle_plan_create() and returns a plan ID
  • agents plan execute <plan-id> executes the plan via A2aLocalFacade._handle_plan_execute()
  • agents plan apply <plan-id> applies the plan via A2aLocalFacade._handle_plan_apply()
  • agents plan status <plan-id> returns live plan state via A2aLocalFacade._handle_plan_status()
  • agents plan cancel <plan-id> cancels the plan via A2aLocalFacade._handle_plan_cancel()
  • Idempotency check in _handle_plan_execute correctly handles terminal states (see #8252)
  • All plan lifecycle CLI commands return structured output matching the spec envelope
  • BDD tests cover plan create, execute, apply, status, and cancel scenarios
  • nox passes with coverage >= 97%

Subtasks

  • Audit current A2aLocalFacade plan lifecycle handler implementations for gaps
  • Fix _handle_plan_execute idempotency check to include terminal states (see #8252)
  • Wire agents plan use CLI command to A2A facade plan create
  • Wire agents plan execute CLI command to A2A facade plan execute
  • Wire agents plan apply CLI command to A2A facade plan apply
  • Wire agents plan status CLI command to A2A facade plan status
  • Wire agents plan cancel CLI command to A2A facade plan cancel
  • Write BDD scenarios for plan lifecycle operations
  • Verify nox passes with coverage >= 97%

Definition of Done

  • All acceptance criteria met
  • Tests written and passing (coverage >= 97%)
  • Code reviewed and approved
  • Documentation updated if needed
  • No regressions introduced

Metadata

  • Commit message: feat(a2a): implement A2A facade plan lifecycle — create, execute, apply via CLI
  • Branch name: feat/a2a-facade-plan-lifecycle

Automated by CleverAgents Bot
Agent: new-issue-creator

## Background and Context The v3.5.0 milestone (M6: Autonomy Hardening) requires A2A facade plan lifecycle operations to be fully functional via CLI. The A2A Facade Session & Guard Enforcement Epic (#8082) requires that plan lifecycle operations (create, execute, apply, status, cancel) are routed through the A2A facade. The A2A facade is the primary interface through which external systems interact with the cleveragents autonomy layer. Without functional plan lifecycle operations, the full autonomy acceptance flow cannot be demonstrated. Parent Epic: #8082 (Epic: A2A Facade Session & Guard Enforcement (M6)) ## Expected Behavior When this issue is complete: - `agents plan use` routes through the A2A facade and returns a plan ID - `agents plan execute <plan-id>` executes the plan via the A2A facade - `agents plan apply <plan-id>` applies the plan via the A2A facade - `agents plan status <plan-id>` reflects live plan state via the facade - `agents plan cancel <plan-id>` cancels an in-progress plan via the facade - All plan lifecycle operations return structured output matching the spec envelope ## Acceptance Criteria - [ ] `agents plan use` creates a plan via `A2aLocalFacade._handle_plan_create()` and returns a plan ID - [ ] `agents plan execute <plan-id>` executes the plan via `A2aLocalFacade._handle_plan_execute()` - [ ] `agents plan apply <plan-id>` applies the plan via `A2aLocalFacade._handle_plan_apply()` - [ ] `agents plan status <plan-id>` returns live plan state via `A2aLocalFacade._handle_plan_status()` - [ ] `agents plan cancel <plan-id>` cancels the plan via `A2aLocalFacade._handle_plan_cancel()` - [ ] Idempotency check in `_handle_plan_execute` correctly handles terminal states (see #8252) - [ ] All plan lifecycle CLI commands return structured output matching the spec envelope - [ ] BDD tests cover plan create, execute, apply, status, and cancel scenarios - [ ] `nox` passes with coverage >= 97% ## Subtasks - [ ] Audit current `A2aLocalFacade` plan lifecycle handler implementations for gaps - [ ] Fix `_handle_plan_execute` idempotency check to include terminal states (see #8252) - [ ] Wire `agents plan use` CLI command to A2A facade plan create - [ ] Wire `agents plan execute` CLI command to A2A facade plan execute - [ ] Wire `agents plan apply` CLI command to A2A facade plan apply - [ ] Wire `agents plan status` CLI command to A2A facade plan status - [ ] Wire `agents plan cancel` CLI command to A2A facade plan cancel - [ ] Write BDD scenarios for plan lifecycle operations - [ ] Verify `nox` passes with coverage >= 97% ## Definition of Done - [ ] All acceptance criteria met - [ ] Tests written and passing (coverage >= 97%) - [ ] Code reviewed and approved - [ ] Documentation updated if needed - [ ] No regressions introduced ## Metadata - **Commit message:** `feat(a2a): implement A2A facade plan lifecycle — create, execute, apply via CLI` - **Branch name:** `feat/a2a-facade-plan-lifecycle` --- **Automated by CleverAgents Bot** Agent: new-issue-creator
HAL9000 added this to the v3.5.0 milestone 2026-04-14 04:10:49 +00:00
Author
Owner

Triage Decision [AUTO-OWNR-2]

Verified

A2A facade plan lifecycle operations are explicitly in v3.5.0 acceptance criteria: 'A2A facade session and plan lifecycle operations functional via CLI'.

  • Type: Feature
  • MoSCoW: Must Have — explicitly in v3.5.0 acceptance criteria
  • Priority: High
  • Milestone: v3.5.0

Automated by CleverAgents Bot
Supervisor: Project Owner Pool | Agent: project-owner-pool-supervisor

## Triage Decision [AUTO-OWNR-2] **Verified** ✅ A2A facade plan lifecycle operations are explicitly in v3.5.0 acceptance criteria: 'A2A facade session and plan lifecycle operations functional via CLI'. - **Type:** Feature - **MoSCoW:** Must Have — explicitly in v3.5.0 acceptance criteria - **Priority:** High - **Milestone:** v3.5.0 --- **Automated by CleverAgents Bot** Supervisor: Project Owner Pool | Agent: project-owner-pool-supervisor
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Blocks
Reference
cleveragents/cleveragents-core#8939
No description provided.