UAT: A2A `_cleveragents/sync/` and `_cleveragents/namespace/` extension methods are unimplemented stubs — spec requires entity sync and namespace management for server mode #4082

New issue

Open

opened 2026-04-06 10:09:40 +00:00 by freemo · 0 comments

freemo commented

2026-04-06 10:09:40 +00:00

Owner

Metadata

Branch: feat/a2a-sync-namespace-services
Commit Message: feat(a2a): implement SyncService and NamespaceService for _cleveragents/sync/* and _cleveragents/namespace/* extension methods
Milestone: Backlog
Parent Epic: #933 (Epic: A2A Protocol Compliance — JSON-RPC 2.0 Framing, Standard Operations, and Extension Methods)

Bug Report

What was tested: A2A sync and namespace extension method implementations against the specification

Expected behavior (from spec, section "Server and Client Architecture"):

The spec describes _cleveragents/-prefixed extension methods for platform operations including:

"plan lifecycle, registry CRUD, entity sync, namespace management, and diagnostics"

The server presentation layer routes extension methods to Application-layer services:

"Extension methods (_cleveragents/*): Routed to Application-layer services (PlanService, RegistryServices, SyncService, NamespaceService, etc.)"

_cleveragents/sync/* methods enable entity synchronization between local and server modes:

_cleveragents/sync/pull — pull entities from server to local
_cleveragents/sync/push — push local entities to server
_cleveragents/sync/status — check sync status

_cleveragents/namespace/* methods enable namespace management:

_cleveragents/namespace/list — list available namespaces
_cleveragents/namespace/show — show namespace details
_cleveragents/namespace/members — list namespace members

Actual behavior (from code analysis):

In src/cleveragents/a2a/facade.py, all six methods are registered but return stub responses:

def _handle_sync_stub(self, params: dict[str, Any]) -> dict[str, Any]:
    return {"status": "not_implemented", "stub": True}

def _handle_namespace_stub(self, params: dict[str, Any]) -> dict[str, Any]:
    return {"status": "not_implemented", "stub": True}

There is no SyncService class anywhere in the codebase. There is no NamespaceService class anywhere in the codebase. These are completely unimplemented — the stubs return {"status": "not_implemented", "stub": True} for all calls.

Code location:

src/cleveragents/a2a/facade.py — lines 604-615 (_handle_sync_stub and _handle_namespace_stub)
No SyncService or NamespaceService exists in src/cleveragents/application/services/

Steps to reproduce:

Configure server mode
Call _cleveragents/sync/pull via A2A
Observe: response is {"status": "not_implemented", "stub": True}
Call _cleveragents/namespace/list via A2A
Observe: response is {"status": "not_implemented", "stub": True}

Severity: Medium — entity sync and namespace management are required for server mode to function correctly. Without sync, local and server registries cannot be kept in sync. Without namespace management, multi-user server deployments cannot manage namespaces.

Subtasks

Implement SyncService application service with pull/push/status operations
Implement NamespaceService application service with list/show/members operations
Wire SyncService to _handle_sync_pull, _handle_sync_push, _handle_sync_status handlers
Wire NamespaceService to _handle_namespace_list, _handle_namespace_show, _handle_namespace_members handlers
Define sync protocol (what entities are synced: tools, skills, actors, actions, projects)
Define namespace model (namespace creation, membership, access control)
Add unit tests (Behave scenarios) for sync and namespace operations
Add integration tests (Robot Framework) for sync workflows

Definition of Done

_cleveragents/sync/pull returns actual sync results (not stub)
_cleveragents/sync/push pushes local entities to server (not stub)
_cleveragents/sync/status returns actual sync status (not stub)
_cleveragents/namespace/list returns actual namespace list (not stub)
_cleveragents/namespace/show returns actual namespace details (not stub)
_cleveragents/namespace/members returns actual namespace members (not stub)
All existing A2A tests continue to pass
New Behave scenarios cover sync and namespace operations
Pyright type checking passes with no suppressions
All nox stages pass
Coverage >= 97%

Backlog note: This issue was discovered during autonomous operation
on milestone v3.7.0. It does not block milestone completion and has been
placed in the backlog for human review and future milestone assignment.

Automated by CleverAgents Bot
Supervisor: UAT Testing | Agent: ca-new-issue-creator

## Metadata - **Branch**: `feat/a2a-sync-namespace-services` - **Commit Message**: `feat(a2a): implement SyncService and NamespaceService for _cleveragents/sync/* and _cleveragents/namespace/* extension methods` - **Milestone**: Backlog - **Parent Epic**: #933 (Epic: A2A Protocol Compliance — JSON-RPC 2.0 Framing, Standard Operations, and Extension Methods) ## Bug Report **What was tested:** A2A sync and namespace extension method implementations against the specification **Expected behavior (from spec, section "Server and Client Architecture"):** The spec describes `_cleveragents/`-prefixed extension methods for platform operations including: > "plan lifecycle, registry CRUD, entity sync, namespace management, and diagnostics" The server presentation layer routes extension methods to Application-layer services: > "Extension methods (`_cleveragents/*`): Routed to Application-layer services (PlanService, RegistryServices, **SyncService**, **NamespaceService**, etc.)" **`_cleveragents/sync/*`** methods enable entity synchronization between local and server modes: - `_cleveragents/sync/pull` — pull entities from server to local - `_cleveragents/sync/push` — push local entities to server - `_cleveragents/sync/status` — check sync status **`_cleveragents/namespace/*`** methods enable namespace management: - `_cleveragents/namespace/list` — list available namespaces - `_cleveragents/namespace/show` — show namespace details - `_cleveragents/namespace/members` — list namespace members **Actual behavior (from code analysis):** In `src/cleveragents/a2a/facade.py`, all six methods are registered but return stub responses: ```python def _handle_sync_stub(self, params: dict[str, Any]) -> dict[str, Any]: return {"status": "not_implemented", "stub": True} def _handle_namespace_stub(self, params: dict[str, Any]) -> dict[str, Any]: return {"status": "not_implemented", "stub": True} ``` There is no `SyncService` class anywhere in the codebase. There is no `NamespaceService` class anywhere in the codebase. These are completely unimplemented — the stubs return `{"status": "not_implemented", "stub": True}` for all calls. **Code location:** - `src/cleveragents/a2a/facade.py` — lines 604-615 (`_handle_sync_stub` and `_handle_namespace_stub`) - No `SyncService` or `NamespaceService` exists in `src/cleveragents/application/services/` **Steps to reproduce:** 1. Configure server mode 2. Call `_cleveragents/sync/pull` via A2A 3. Observe: response is `{"status": "not_implemented", "stub": True}` 4. Call `_cleveragents/namespace/list` via A2A 5. Observe: response is `{"status": "not_implemented", "stub": True}` **Severity:** Medium — entity sync and namespace management are required for server mode to function correctly. Without sync, local and server registries cannot be kept in sync. Without namespace management, multi-user server deployments cannot manage namespaces. ## Subtasks - [ ] Implement `SyncService` application service with pull/push/status operations - [ ] Implement `NamespaceService` application service with list/show/members operations - [ ] Wire `SyncService` to `_handle_sync_pull`, `_handle_sync_push`, `_handle_sync_status` handlers - [ ] Wire `NamespaceService` to `_handle_namespace_list`, `_handle_namespace_show`, `_handle_namespace_members` handlers - [ ] Define sync protocol (what entities are synced: tools, skills, actors, actions, projects) - [ ] Define namespace model (namespace creation, membership, access control) - [ ] Add unit tests (Behave scenarios) for sync and namespace operations - [ ] Add integration tests (Robot Framework) for sync workflows ## Definition of Done - [ ] `_cleveragents/sync/pull` returns actual sync results (not stub) - [ ] `_cleveragents/sync/push` pushes local entities to server (not stub) - [ ] `_cleveragents/sync/status` returns actual sync status (not stub) - [ ] `_cleveragents/namespace/list` returns actual namespace list (not stub) - [ ] `_cleveragents/namespace/show` returns actual namespace details (not stub) - [ ] `_cleveragents/namespace/members` returns actual namespace members (not stub) - [ ] All existing A2A tests continue to pass - [ ] New Behave scenarios cover sync and namespace operations - [ ] Pyright type checking passes with no suppressions - [ ] All nox stages pass - [ ] Coverage >= 97% > **Backlog note:** This issue was discovered during autonomous operation > on milestone v3.7.0. It does not block milestone completion and has been > placed in the backlog for human review and future milestone assignment. --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: ca-new-issue-creator

freemo added a new dependency

2026-04-06 10:09:48 +00:00

#933 Epic: A2A Protocol Compliance — JSON-RPC 2.0 Framing, Standard Operations, and Extension Methods

freemo added the

Points

label

2026-04-06 10:10:08 +00:00

freemo referenced this issue

2026-04-06 10:10:44 +00:00

[Automated] CleverAgents Build Session - 2026-04-06 #3775

freemo referenced this issue

2026-04-06 10:15:25 +00:00