freemo
9c6d69153e
CI / benchmark-publish (pull_request) Has been skipped
CI / build (pull_request) Successful in 18s
CI / lint (pull_request) Failing after 18s
CI / helm (pull_request) Successful in 23s
CI / security (pull_request) Failing after 52s
CI / typecheck (pull_request) Failing after 54s
CI / coverage (pull_request) Has been skipped
CI / benchmark-regression (pull_request) Has been skipped
CI / unit_tests (pull_request) Failing after 1m47s
CI / docker (pull_request) Has been skipped
CI / quality (pull_request) Successful in 3m42s
CI / e2e_tests (pull_request) Failing after 14m21s
CI / integration_tests (pull_request) Failing after 20m58s
CI / status-check (pull_request) Failing after 1s
Rewrites the A2aRequest and A2aResponse Pydantic models to use the field names mandated by the JSON-RPC 2.0 specification, fixing a fundamental protocol compliance issue that prevented external A2A-compliant clients from communicating with the server. Changes: - A2aRequest: a2a_version→jsonrpc (fixed '2.0'), request_id→id, operation→method; auth field removed (not in JSON-RPC 2.0) - A2aResponse: a2a_version→jsonrpc, request_id→id, status+data→result (success path), timing_ms removed; added _result_xor_error validator enforcing mutual exclusion of result and error fields - A2aLocalFacade.dispatch(): updated to use request.method, request.id, result=data, error=A2aErrorDetail(...) - A2aHttpTransport.send(): updated to use request.method - CLI call sites (session.py, plan.py): updated A2aRequest(method=...) and response.result / response.error field access - All existing A2A Behave step files updated to new field names - New 35-scenario Behave feature (a2a_jsonrpc_wire_format.feature) covering serialisation, deserialisation, validation, and facade dispatch - New 7-test Robot Framework suite (a2a_jsonrpc_wire_format.robot) for end-to-end wire format verification ISSUES CLOSED: #1501
368 lines
20 KiB
Gherkin
368 lines
20 KiB
Gherkin
Feature: A2A local facade coverage — uncovered handler and edge-case paths
|
|
As a developer maintaining the A2A local facade
|
|
I want all handler branches and error paths exercised
|
|
So that coverage gaps are closed and regressions are caught
|
|
|
|
# -------------------------------------------------------------------
|
|
# Session close — devcontainer cleanup exception path (lines 359-363)
|
|
# -------------------------------------------------------------------
|
|
|
|
Scenario: Session close catches devcontainer cleanup failure gracefully
|
|
Given a facade-cov facade with a mock SessionService
|
|
When I dispatch facade-cov operation "session.close" with params {"session_id": "sess-cleanup-fail"}
|
|
Then the facade-cov response status should be "ok"
|
|
And the facade-cov response data key "status" should equal "closed"
|
|
|
|
Scenario: Session close without session service still runs cleanup
|
|
Given a facade-cov facade with no services
|
|
When I dispatch facade-cov operation "session.close" with params {"session_id": "orphan-sess"}
|
|
Then the facade-cov response status should be "ok"
|
|
And the facade-cov response data key "status" should equal "closed"
|
|
|
|
Scenario: Session close with empty session_id and no service
|
|
Given a facade-cov facade with no services
|
|
When I dispatch facade-cov operation "session.close" with params {"session_id": ""}
|
|
Then the facade-cov response status should be "ok"
|
|
And the facade-cov response data key "status" should equal "closed"
|
|
|
|
# -------------------------------------------------------------------
|
|
# Plan cancel — with service wired (lines 501-502)
|
|
# -------------------------------------------------------------------
|
|
|
|
Scenario: Plan cancel with wired service calls cancel_plan
|
|
Given a facade-cov facade with a full mock PlanLifecycleService
|
|
When I dispatch facade-cov operation "_cleveragents/plan/cancel" with params {"plan_id": "PLAN-CANCEL-001"}
|
|
Then the facade-cov response status should be "ok"
|
|
And the facade-cov response data key "status" should equal "cancelled"
|
|
And the facade-cov response data should not contain key "stub"
|
|
|
|
Scenario: Plan cancel with empty plan_id returns stub
|
|
Given a facade-cov facade with a full mock PlanLifecycleService
|
|
When I dispatch facade-cov operation "_cleveragents/plan/cancel" with params {"plan_id": ""}
|
|
Then the facade-cov response status should be "ok"
|
|
And the facade-cov response data key "stub" should be true
|
|
|
|
# -------------------------------------------------------------------
|
|
# Plan tree — full method (lines 504-514)
|
|
# -------------------------------------------------------------------
|
|
|
|
Scenario: Plan tree with wired service returns plan info
|
|
Given a facade-cov facade with a full mock PlanLifecycleService
|
|
When I dispatch facade-cov operation "_cleveragents/plan/tree" with params {"plan_id": "PLAN-TREE-001"}
|
|
Then the facade-cov response status should be "ok"
|
|
And the facade-cov response data key "plan_id" should equal "PLAN-TREE-001"
|
|
And the facade-cov response data should contain key "decision_root_id"
|
|
|
|
Scenario: Plan tree with empty plan_id returns stub
|
|
Given a facade-cov facade with a full mock PlanLifecycleService
|
|
When I dispatch facade-cov operation "_cleveragents/plan/tree" with params {"plan_id": ""}
|
|
Then the facade-cov response status should be "ok"
|
|
And the facade-cov response data key "stub" should be true
|
|
|
|
Scenario: Plan tree with no service returns stub
|
|
Given a facade-cov facade with no services
|
|
When I dispatch facade-cov operation "_cleveragents/plan/tree" with params {"plan_id": "PLAN-TREE-002"}
|
|
Then the facade-cov response status should be "ok"
|
|
And the facade-cov response data key "stub" should be true
|
|
|
|
# -------------------------------------------------------------------
|
|
# Plan explain (lines 516-524)
|
|
# -------------------------------------------------------------------
|
|
|
|
Scenario: Plan explain returns stub with plan_id and decision_id
|
|
Given a facade-cov facade with no services
|
|
When I dispatch facade-cov operation "_cleveragents/plan/explain" with params {"plan_id": "PLAN-EXP-001", "decision_id": "DEC-001"}
|
|
Then the facade-cov response status should be "ok"
|
|
And the facade-cov response data key "plan_id" should equal "PLAN-EXP-001"
|
|
And the facade-cov response data key "decision_id" should equal "DEC-001"
|
|
And the facade-cov response data key "stub" should be true
|
|
|
|
# -------------------------------------------------------------------
|
|
# Plan correct (lines 526-528)
|
|
# -------------------------------------------------------------------
|
|
|
|
Scenario: Plan correct returns stub response
|
|
Given a facade-cov facade with no services
|
|
When I dispatch facade-cov operation "_cleveragents/plan/correct" with params {"plan_id": "PLAN-COR-001"}
|
|
Then the facade-cov response status should be "ok"
|
|
And the facade-cov response data key "status" should equal "corrected"
|
|
And the facade-cov response data key "stub" should be true
|
|
|
|
# -------------------------------------------------------------------
|
|
# Plan artifacts — both paths (lines 530-540)
|
|
# -------------------------------------------------------------------
|
|
|
|
Scenario: Plan artifacts with wired service returns changeset info
|
|
Given a facade-cov facade with a full mock PlanLifecycleService
|
|
When I dispatch facade-cov operation "_cleveragents/plan/artifacts" with params {"plan_id": "PLAN-ART-001"}
|
|
Then the facade-cov response status should be "ok"
|
|
And the facade-cov response data key "plan_id" should equal "PLAN-ART-001"
|
|
And the facade-cov response data should contain key "changeset_id"
|
|
And the facade-cov response data should contain key "sandbox_refs"
|
|
|
|
Scenario: Plan artifacts with no service returns stub
|
|
Given a facade-cov facade with no services
|
|
When I dispatch facade-cov operation "_cleveragents/plan/artifacts" with params {"plan_id": "PLAN-ART-002"}
|
|
Then the facade-cov response status should be "ok"
|
|
And the facade-cov response data key "stub" should be true
|
|
|
|
Scenario: Plan artifacts with empty plan_id returns stub
|
|
Given a facade-cov facade with a full mock PlanLifecycleService
|
|
When I dispatch facade-cov operation "_cleveragents/plan/artifacts" with params {"plan_id": ""}
|
|
Then the facade-cov response status should be "ok"
|
|
And the facade-cov response data key "stub" should be true
|
|
|
|
# -------------------------------------------------------------------
|
|
# Plan prompt (lines 542-544)
|
|
# -------------------------------------------------------------------
|
|
|
|
Scenario: Plan prompt returns stub response
|
|
Given a facade-cov facade with no services
|
|
When I dispatch facade-cov operation "_cleveragents/plan/prompt" with params {"plan_id": "PLAN-PRM-001"}
|
|
Then the facade-cov response status should be "ok"
|
|
And the facade-cov response data key "status" should equal "guidance_injected"
|
|
And the facade-cov response data key "stub" should be true
|
|
|
|
# -------------------------------------------------------------------
|
|
# Plan rollback (lines 546-548)
|
|
# -------------------------------------------------------------------
|
|
|
|
Scenario: Plan rollback returns stub response
|
|
Given a facade-cov facade with no services
|
|
When I dispatch facade-cov operation "_cleveragents/plan/rollback" with params {"plan_id": "PLAN-RB-001"}
|
|
Then the facade-cov response status should be "ok"
|
|
And the facade-cov response data key "status" should equal "rolled_back"
|
|
And the facade-cov response data key "stub" should be true
|
|
|
|
# -------------------------------------------------------------------
|
|
# Plan list — with service wired (lines 550-560)
|
|
# -------------------------------------------------------------------
|
|
|
|
Scenario: Plan list with wired service returns plan summaries
|
|
Given a facade-cov facade with a full mock PlanLifecycleService
|
|
When I dispatch facade-cov operation "_cleveragents/plan/list" with params {}
|
|
Then the facade-cov response status should be "ok"
|
|
And the facade-cov response data should contain key "plans"
|
|
And the facade-cov response data should contain key "total"
|
|
And the facade-cov response data should not contain key "stub"
|
|
|
|
Scenario: Plan list with no service returns stub
|
|
Given a facade-cov facade with no services
|
|
When I dispatch facade-cov operation "_cleveragents/plan/list" with params {}
|
|
Then the facade-cov response status should be "ok"
|
|
And the facade-cov response data key "stub" should be true
|
|
|
|
# -------------------------------------------------------------------
|
|
# Registry list stubs (lines 566-567)
|
|
# -------------------------------------------------------------------
|
|
|
|
Scenario: Registry actor list returns stub
|
|
Given a facade-cov facade with no services
|
|
When I dispatch facade-cov operation "_cleveragents/registry/actor/list" with params {}
|
|
Then the facade-cov response status should be "ok"
|
|
And the facade-cov response data key "stub" should be true
|
|
And the facade-cov response data should contain key "items"
|
|
|
|
Scenario: Registry skill list returns stub
|
|
Given a facade-cov facade with no services
|
|
When I dispatch facade-cov operation "_cleveragents/registry/skill/list" with params {}
|
|
Then the facade-cov response status should be "ok"
|
|
And the facade-cov response data key "stub" should be true
|
|
|
|
Scenario: Registry action list returns stub
|
|
Given a facade-cov facade with no services
|
|
When I dispatch facade-cov operation "_cleveragents/registry/action/list" with params {}
|
|
Then the facade-cov response status should be "ok"
|
|
And the facade-cov response data key "stub" should be true
|
|
|
|
Scenario: Registry project list returns stub
|
|
Given a facade-cov facade with no services
|
|
When I dispatch facade-cov operation "_cleveragents/registry/project/list" with params {}
|
|
Then the facade-cov response status should be "ok"
|
|
And the facade-cov response data key "stub" should be true
|
|
|
|
# -------------------------------------------------------------------
|
|
# Context stubs (lines 573-574)
|
|
# -------------------------------------------------------------------
|
|
|
|
Scenario: Context inspect returns stub
|
|
Given a facade-cov facade with no services
|
|
When I dispatch facade-cov operation "_cleveragents/context/inspect" with params {}
|
|
Then the facade-cov response status should be "ok"
|
|
And the facade-cov response data key "stub" should be true
|
|
|
|
Scenario: Context simulate returns stub
|
|
Given a facade-cov facade with no services
|
|
When I dispatch facade-cov operation "_cleveragents/context/simulate" with params {}
|
|
Then the facade-cov response status should be "ok"
|
|
And the facade-cov response data key "stub" should be true
|
|
|
|
Scenario: Context set returns stub
|
|
Given a facade-cov facade with no services
|
|
When I dispatch facade-cov operation "_cleveragents/context/set" with params {}
|
|
Then the facade-cov response status should be "ok"
|
|
And the facade-cov response data key "stub" should be true
|
|
|
|
# -------------------------------------------------------------------
|
|
# Health and diagnostics (lines 580-584)
|
|
# -------------------------------------------------------------------
|
|
|
|
Scenario: Diagnostics run returns stub
|
|
Given a facade-cov facade with no services
|
|
When I dispatch facade-cov operation "_cleveragents/diagnostics/run" with params {}
|
|
Then the facade-cov response status should be "ok"
|
|
And the facade-cov response data key "stub" should be true
|
|
And the facade-cov response data key "status" should equal "ok"
|
|
|
|
# -------------------------------------------------------------------
|
|
# Sync stubs (lines 590-591)
|
|
# -------------------------------------------------------------------
|
|
|
|
Scenario: Sync push returns not_implemented stub
|
|
Given a facade-cov facade with no services
|
|
When I dispatch facade-cov operation "_cleveragents/sync/push" with params {}
|
|
Then the facade-cov response status should be "ok"
|
|
And the facade-cov response data key "stub" should be true
|
|
And the facade-cov response data key "status" should equal "not_implemented"
|
|
|
|
Scenario: Sync status returns not_implemented stub
|
|
Given a facade-cov facade with no services
|
|
When I dispatch facade-cov operation "_cleveragents/sync/status" with params {}
|
|
Then the facade-cov response status should be "ok"
|
|
And the facade-cov response data key "stub" should be true
|
|
|
|
# -------------------------------------------------------------------
|
|
# Namespace stubs (lines 597-598)
|
|
# -------------------------------------------------------------------
|
|
|
|
Scenario: Namespace show returns stub
|
|
Given a facade-cov facade with no services
|
|
When I dispatch facade-cov operation "_cleveragents/namespace/show" with params {}
|
|
Then the facade-cov response status should be "ok"
|
|
And the facade-cov response data key "stub" should be true
|
|
|
|
Scenario: Namespace members returns stub
|
|
Given a facade-cov facade with no services
|
|
When I dispatch facade-cov operation "_cleveragents/namespace/members" with params {}
|
|
Then the facade-cov response status should be "ok"
|
|
And the facade-cov response data key "stub" should be true
|
|
|
|
# -------------------------------------------------------------------
|
|
# Dispatch error path — domain exception mapped to A2A error
|
|
# -------------------------------------------------------------------
|
|
|
|
Scenario: Dispatch maps domain exception to error response
|
|
Given a facade-cov facade with a raising PlanLifecycleService
|
|
When I dispatch facade-cov operation "plan.execute" with params {"plan_id": "PLAN-FAIL"}
|
|
Then the facade-cov response status should be "error"
|
|
And the facade-cov response error should not be None
|
|
|
|
# -------------------------------------------------------------------
|
|
# Dispatch TypeError — non-request argument
|
|
# -------------------------------------------------------------------
|
|
|
|
Scenario: Dispatch with non-A2aRequest argument raises TypeError
|
|
Given a facade-cov facade with no services
|
|
When I try to dispatch a non-A2aRequest object via the facade-cov facade
|
|
Then a facade-cov TypeError should be raised with message "request must be an A2aRequest instance"
|
|
|
|
# -------------------------------------------------------------------
|
|
# Register service and handler map invalidation
|
|
# -------------------------------------------------------------------
|
|
|
|
Scenario: Registering a service invalidates the handler cache
|
|
Given a facade-cov facade with no services
|
|
When I dispatch facade-cov operation "session.create" with params {}
|
|
And I register a facade-cov service "session_service" with a mock
|
|
And I dispatch facade-cov operation "session.create" with params {"actor_name": "test-actor"}
|
|
Then the second facade-cov session create should use the new service
|
|
|
|
Scenario: Register service with empty name raises ValueError
|
|
Given a facade-cov facade with no services
|
|
When I try to register a facade-cov service with empty name
|
|
Then a facade-cov ValueError should be raised
|
|
|
|
# -------------------------------------------------------------------
|
|
# Session create with wired service (lines 315-317)
|
|
# -------------------------------------------------------------------
|
|
|
|
Scenario: Session create with wired service delegates to service
|
|
Given a facade-cov facade with a mock SessionService
|
|
When I dispatch facade-cov operation "session.create" with params {"actor_name": "my-actor"}
|
|
Then the facade-cov response status should be "ok"
|
|
And the facade-cov response data key "status" should equal "created"
|
|
And the facade-cov response data key "session_id" should equal "MOCK-SESSION-001"
|
|
|
|
# -------------------------------------------------------------------
|
|
# Session close with wired service and valid session_id (lines 329-335)
|
|
# -------------------------------------------------------------------
|
|
|
|
Scenario: Session close with wired service and empty session_id raises error
|
|
Given a facade-cov facade with a mock SessionService
|
|
When I dispatch facade-cov operation "session.close" with params {"session_id": ""}
|
|
Then the facade-cov response status should be "error"
|
|
|
|
Scenario: Session close with wired service and valid session_id
|
|
Given a facade-cov facade with a mock SessionService
|
|
When I dispatch facade-cov operation "session.close" with params {"session_id": "SESS-001"}
|
|
Then the facade-cov response status should be "ok"
|
|
And the facade-cov response data key "status" should equal "closed"
|
|
|
|
# -------------------------------------------------------------------
|
|
# Event subscribe with wired queue (lines 486-490)
|
|
# -------------------------------------------------------------------
|
|
|
|
Scenario: Event subscribe with wired queue calls subscribe_local
|
|
Given a facade-cov facade with a mock EventQueue
|
|
When I dispatch facade-cov operation "event.subscribe" with params {}
|
|
Then the facade-cov response status should be "ok"
|
|
And the facade-cov response data key "status" should equal "subscribed"
|
|
And the facade-cov response data should contain key "subscription_id"
|
|
|
|
# -------------------------------------------------------------------
|
|
# Registry list tools with wired service (lines 441-445)
|
|
# -------------------------------------------------------------------
|
|
|
|
Scenario: Registry list tools with wired service returns tool specs
|
|
Given a facade-cov facade with a mock ToolRegistry
|
|
When I dispatch facade-cov operation "registry.list_tools" with params {"namespace": "local"}
|
|
Then the facade-cov response status should be "ok"
|
|
And the facade-cov response data should contain key "tools"
|
|
And the facade-cov response tools list should have 2 items
|
|
|
|
# -------------------------------------------------------------------
|
|
# Registry list resources with wired service (lines 451-462)
|
|
# -------------------------------------------------------------------
|
|
|
|
Scenario: Registry list resources with wired service returns resources
|
|
Given a facade-cov facade with a mock ResourceRegistryService
|
|
When I dispatch facade-cov operation "registry.list_resources" with params {"type_name": "git-checkout"}
|
|
Then the facade-cov response status should be "ok"
|
|
And the facade-cov response data should contain key "resources"
|
|
And the facade-cov response resources list should have 1 items
|
|
|
|
# -------------------------------------------------------------------
|
|
# Plan create with wired service — validation (lines 374-382)
|
|
# -------------------------------------------------------------------
|
|
|
|
Scenario: Plan create with wired service and missing action_name errors
|
|
Given a facade-cov facade with a full mock PlanLifecycleService
|
|
When I dispatch facade-cov operation "plan.create" with params {"action_name": ""}
|
|
Then the facade-cov response status should be "error"
|
|
|
|
Scenario: Plan create with wired service and valid action_name succeeds
|
|
Given a facade-cov facade with a full mock PlanLifecycleService
|
|
When I dispatch facade-cov operation "plan.create" with params {"action_name": "build", "arguments": {"target": "all"}, "created_by": "test-user"}
|
|
Then the facade-cov response status should be "ok"
|
|
And the facade-cov response data key "plan_id" should equal "MOCK-PLAN-001"
|
|
|
|
# -------------------------------------------------------------------
|
|
# Cleanup devcontainers — exception path exercised via mock
|
|
# -------------------------------------------------------------------
|
|
|
|
Scenario: Devcontainer cleanup exception is caught and logged
|
|
Given a facade-cov facade with no services and a failing cleanup service
|
|
When I dispatch facade-cov operation "session.close" with params {"session_id": "sess-with-failing-cleanup"}
|
|
Then the facade-cov response status should be "ok"
|
|
And the facade-cov response data key "status" should equal "closed"
|