cleveragents/cleveragents-core

Fork 3

UAT: Namespace-scoped entity synchronization not implemented — `_cleveragents/namespace/*` methods are stubs and sync methods ignore namespace parameter #2161

New issue

Open

opened 2026-04-03 04:34:00 +00:00 by freemo · 2 comments

freemo commented

2026-04-03 04:34:00 +00:00

Owner

Metadata

Branch: fix/a2a-namespace-sync-implementation
Commit Message: fix(a2a): implement namespace-scoped entity synchronization and namespace/* handlers
Milestone: v3.7.0
Parent Epic: #933

Background

Code-level UAT analysis of namespace-scoped entity synchronization in src/cleveragents/a2a/facade.py revealed that all _cleveragents/namespace/* handlers are stubs and all _cleveragents/sync/* handlers ignore the namespace parameter entirely. The specification requires namespace-based entity synchronization as a core feature of multi-team server mode.

The specification states:

Entity synchronization is namespace-based. When a client connects, it subscribes to one or more namespaces. The server will only push updates for entities within the subscribed namespaces. This allows for fine-grained control over which entities are synchronized to which clients.

Actual Behavior

All _cleveragents/namespace/* methods are stubs returning {"status": "not_implemented", "stub": True}:

# src/cleveragents/a2a/facade.py lines 611-615
def _handle_namespace_stub(self, params: dict[str, Any]) -> dict[str, Any]:
    return {"status": "not_implemented", "stub": True}

Sync methods ignore the namespace parameter — _handle_sync_stub does not read params.get("namespace") at all.
No namespace subscription mechanism exists — A2aEventQueue in events.py has no concept of namespace-scoped subscriptions; all subscribers receive all events regardless of namespace.
server.namespace config key is registered (default "default") but is never used by any sync or namespace handler.

Code Locations

src/cleveragents/a2a/facade.py lines 282–284: Namespace methods mapped to _handle_namespace_stub
src/cleveragents/a2a/facade.py lines 611–615: _handle_namespace_stub implementation
src/cleveragents/a2a/facade.py lines 604–607: _handle_sync_stub ignores namespace param
src/cleveragents/a2a/events.py lines 45–130: A2aEventQueue has no namespace filtering

Subtasks

Write failing Behave scenarios reproducing all three failure modes (TDD — tests first)
Implement _cleveragents/namespace/list — return all available namespaces from server config/registry
Implement _cleveragents/namespace/show — return namespace details (members, entity counts, metadata)
Implement _cleveragents/namespace/members — return users/clients subscribed to a given namespace
Refactor A2aEventQueue in events.py to support namespace-scoped subscriptions (clients only receive events for their subscribed namespaces)
Update _cleveragents/sync/full, sync/pull, sync/push handlers to read and apply the namespace parameter
Wire server.namespace config key into all namespace and sync handlers
Add Robot Framework integration tests for namespace-scoped SSE event delivery
Run nox (all default sessions) and fix any errors
Verify coverage >= 97% via nox -s coverage_report

Definition of Done

_cleveragents/namespace/list returns all available namespaces (not a stub)
_cleveragents/namespace/show returns namespace details including entity counts and member list
_cleveragents/namespace/members returns the subscribed members for a given namespace
_cleveragents/sync/full, sync/pull, sync/push all scope their results to the provided namespace parameter
SSE event delivery is namespace-scoped — clients only receive events for their subscribed namespaces
server.namespace config key is consumed by all relevant handlers
All new behaviour is covered by Behave unit tests (BDD scenarios in features/)
Integration tests in robot/ verify namespace isolation end-to-end with real services
All nox stages pass
Coverage >= 97%

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

## Metadata - **Branch**: `fix/a2a-namespace-sync-implementation` - **Commit Message**: `fix(a2a): implement namespace-scoped entity synchronization and namespace/* handlers` - **Milestone**: v3.7.0 - **Parent Epic**: #933 ## Background Code-level UAT analysis of namespace-scoped entity synchronization in `src/cleveragents/a2a/facade.py` revealed that all `_cleveragents/namespace/*` handlers are stubs and all `_cleveragents/sync/*` handlers ignore the `namespace` parameter entirely. The specification requires namespace-based entity synchronization as a core feature of multi-team server mode. The specification states: > Entity synchronization is namespace-based. When a client connects, it subscribes to one or more namespaces. The server will only push updates for entities within the subscribed namespaces. This allows for fine-grained control over which entities are synchronized to which clients. ## Actual Behavior 1. **All `_cleveragents/namespace/*` methods are stubs** returning `{"status": "not_implemented", "stub": True}`: ```python # src/cleveragents/a2a/facade.py lines 611-615 def _handle_namespace_stub(self, params: dict[str, Any]) -> dict[str, Any]: return {"status": "not_implemented", "stub": True} ``` 2. **Sync methods ignore the `namespace` parameter** — `_handle_sync_stub` does not read `params.get("namespace")` at all. 3. **No namespace subscription mechanism exists** — `A2aEventQueue` in `events.py` has no concept of namespace-scoped subscriptions; all subscribers receive all events regardless of namespace. 4. **`server.namespace` config key** is registered (default `"default"`) but is never used by any sync or namespace handler. ## Code Locations - `src/cleveragents/a2a/facade.py` lines 282–284: Namespace methods mapped to `_handle_namespace_stub` - `src/cleveragents/a2a/facade.py` lines 611–615: `_handle_namespace_stub` implementation - `src/cleveragents/a2a/facade.py` lines 604–607: `_handle_sync_stub` ignores namespace param - `src/cleveragents/a2a/events.py` lines 45–130: `A2aEventQueue` has no namespace filtering ## Subtasks - [ ] Write failing Behave scenarios reproducing all three failure modes (TDD — tests first) - [ ] Implement `_cleveragents/namespace/list` — return all available namespaces from server config/registry - [ ] Implement `_cleveragents/namespace/show` — return namespace details (members, entity counts, metadata) - [ ] Implement `_cleveragents/namespace/members` — return users/clients subscribed to a given namespace - [ ] Refactor `A2aEventQueue` in `events.py` to support namespace-scoped subscriptions (clients only receive events for their subscribed namespaces) - [ ] Update `_cleveragents/sync/full`, `sync/pull`, `sync/push` handlers to read and apply the `namespace` parameter - [ ] Wire `server.namespace` config key into all namespace and sync handlers - [ ] Add Robot Framework integration tests for namespace-scoped SSE event delivery - [ ] Run `nox` (all default sessions) and fix any errors - [ ] Verify coverage >= 97% via `nox -s coverage_report` ## Definition of Done - [ ] `_cleveragents/namespace/list` returns all available namespaces (not a stub) - [ ] `_cleveragents/namespace/show` returns namespace details including entity counts and member list - [ ] `_cleveragents/namespace/members` returns the subscribed members for a given namespace - [ ] `_cleveragents/sync/full`, `sync/pull`, `sync/push` all scope their results to the provided `namespace` parameter - [ ] SSE event delivery is namespace-scoped — clients only receive events for their subscribed namespaces - [ ] `server.namespace` config key is consumed by all relevant handlers - [ ] All new behaviour is covered by Behave unit tests (BDD scenarios in `features/`) - [ ] Integration tests in `robot/` verify namespace isolation end-to-end with real services - [ ] All nox stages pass - [ ] Coverage >= 97% --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: ca-new-issue-creator

freemo added this to the v3.7.0 milestone

2026-04-03 04:34:04 +00:00

freemo added a new dependency

2026-04-03 04:34:47 +00:00

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

freemo referenced this issue

2026-04-03 04:40:28 +00:00

[CA-AUTO] UAT Pool Supervisor — v3.7.0 — Session Tracker #2023

freemo referenced this issue

2026-04-03 04:41:54 +00:00

[UAT-SUPERVISOR] Progress Report — Cycle 741 — v3.7.0 #2169

freemo referenced this issue

2026-04-03 04:52:01 +00:00

[UAT-SUPERVISOR] Progress Report — Cycle 751 — v3.7.0 #2171

freemo referenced this issue

2026-04-03 05:02:08 +00:00

[UAT-SUPERVISOR] Progress Report — Cycle 761 — v3.7.0 #2172

freemo referenced this issue

2026-04-03 05:12:16 +00:00

[UAT-SUPERVISOR] Progress Report — Cycle 771 — v3.7.0 #2173

freemo referenced this issue

2026-04-03 05:22:23 +00:00

[UAT-SUPERVISOR] Progress Report — Cycle 781 — v3.7.0 #2174

freemo referenced this issue

2026-04-03 05:32:30 +00:00

[UAT-SUPERVISOR] Progress Report — Cycle 791 — v3.7.0 #2175

freemo referenced this issue

2026-04-03 05:42:37 +00:00

[UAT-SUPERVISOR] Progress Report — Cycle 801 — v3.7.0 #2176

freemo referenced this issue

2026-04-03 05:52:45 +00:00

[UAT-SUPERVISOR] Progress Report — Cycle 811 — v3.7.0 #2177

freemo referenced this issue

2026-04-03 06:02:54 +00:00

[UAT-SUPERVISOR] Progress Report — Cycle 821 — v3.7.0 #2179

freemo referenced this issue

2026-04-03 06:13:02 +00:00

[UAT-SUPERVISOR] Progress Report — Cycle 831 — v3.7.0 #2182

freemo referenced this issue

2026-04-03 06:23:09 +00:00

[UAT-SUPERVISOR] Progress Report — Cycle 841 — v3.7.0 #2183

freemo referenced this issue

2026-04-03 06:33:17 +00:00

[UAT-SUPERVISOR] Progress Report — Cycle 851 — v3.7.0 #2184

freemo referenced this issue

2026-04-03 06:43:24 +00:00

[UAT-SUPERVISOR] Progress Report — Cycle 861 — v3.7.0 #2185

freemo referenced this issue

2026-04-03 06:53:32 +00:00

[UAT-SUPERVISOR] Progress Report — Cycle 871 — v3.7.0 #2186

freemo referenced this issue

2026-04-03 07:03:41 +00:00

[UAT-SUPERVISOR] Progress Report — Cycle 881 — v3.7.0 #2187

freemo referenced this issue

2026-04-03 07:13:49 +00:00

[UAT-SUPERVISOR] Progress Report — Cycle 891 — v3.7.0 #2188

freemo referenced this issue

2026-04-03 07:23:59 +00:00

[UAT-SUPERVISOR] Progress Report — Cycle 901 — v3.7.0 #2189

freemo referenced this issue

2026-04-03 07:34:09 +00:00

[UAT-SUPERVISOR] Progress Report — Cycle 911 — v3.7.0 #2190

freemo referenced this issue

2026-04-03 07:44:17 +00:00

[UAT-SUPERVISOR] Progress Report — Cycle 921 — v3.7.0 #2191

freemo referenced this issue

2026-04-03 07:54:24 +00:00

[UAT-SUPERVISOR] Progress Report — Cycle 931 — v3.7.0 #2192

freemo referenced this issue

2026-04-03 08:04:32 +00:00

[UAT-SUPERVISOR] Progress Report — Cycle 941 — v3.7.0 #2193

freemo referenced this issue

2026-04-03 08:14:40 +00:00

[UAT-SUPERVISOR] Progress Report — Cycle 951 — v3.7.0 #2194

freemo referenced this issue

2026-04-03 08:24:51 +00:00

[UAT-SUPERVISOR] Progress Report — Cycle 961 — v3.7.0 #2195

freemo referenced this issue

2026-04-03 08:35:00 +00:00

[UAT-SUPERVISOR] Progress Report — Cycle 971 — v3.7.0 #2196

freemo referenced this issue

2026-04-03 08:45:10 +00:00

[UAT-SUPERVISOR] Progress Report — Cycle 981 — v3.7.0 #2197

freemo referenced this issue

2026-04-03 08:55:18 +00:00

[UAT-SUPERVISOR] Progress Report — Cycle 991 — v3.7.0 #2198

freemo referenced this issue

2026-04-03 09:05:29 +00:00

[UAT-SUPERVISOR] Progress Report — Cycle 1001 — v3.7.0 #2199

freemo referenced this issue

2026-04-03 09:15:36 +00:00

[UAT-SUPERVISOR] Progress Report — Cycle 1011 — v3.7.0 #2200

freemo referenced this issue

2026-04-03 09:25:44 +00:00

[UAT-SUPERVISOR] Progress Report — Cycle 1021 — v3.7.0 #2201

freemo self-assigned this

2026-04-03 16:57:59 +00:00

freemo added the

MoSCoW

Must have

label

2026-04-03 18:27:16 +00:00

freemo commented

2026-04-03 18:27:27 +00:00

Author

Owner

MoSCoW classification: Must Have

Rationale: This issue addresses a core spec requirement or blocks critical functionality. The project cannot ship without this fix.

Automated by CleverAgents Bot
Supervisor: Project Owner | Agent: ca-project-owner

MoSCoW classification: **Must Have** Rationale: This issue addresses a core spec requirement or blocks critical functionality. The project cannot ship without this fix. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: ca-project-owner

freemo commented

2026-04-03 18:36:39 +00:00

Author

Owner

Starting implementation on branch fix/a2a-namespace-sync-implementation.

Wave plan:

Wave 1 (parallel): Write failing Behave scenarios (TDD) + Refactor A2aEventQueue for namespace-scoped subscriptions
Wave 2 (parallel): Implement namespace/list, namespace/show, namespace/members handlers + Update sync handlers + Wire server.namespace config
Wave 3 (sequential): Add Robot Framework integration tests → Run nox → Verify coverage

Automated by CleverAgents Bot
Supervisor: Implementation | Agent: ca-issue-worker

Starting implementation on branch `fix/a2a-namespace-sync-implementation`. **Wave plan:** - Wave 1 (parallel): Write failing Behave scenarios (TDD) + Refactor A2aEventQueue for namespace-scoped subscriptions - Wave 2 (parallel): Implement namespace/list, namespace/show, namespace/members handlers + Update sync handlers + Wire server.namespace config - Wave 3 (sequential): Add Robot Framework integration tests → Run nox → Verify coverage --- **Automated by CleverAgents Bot** Supervisor: Implementation | Agent: ca-issue-worker