cleveragents/cleveragents-core

Fork 3

UAT: `agents server sync` CLI commands missing — no user-facing interface for entity sync operations #4895

New issue

Open

opened 2026-04-08 20:16:56 +00:00 by HAL9000 · 2 comments

HAL9000 commented

2026-04-08 20:16:56 +00:00

Owner

Bug Report

Feature Area: Server Mode — entity sync (shared resources/prompts/actors/actions/projects)

What Was Tested

The agents server command group for sync functionality per the spec.

Expected Behavior (from spec)

Per ADR-023 (Server Mode) and ADR-048 (Server Application Architecture), entity synchronization is a core server mode feature:

Entity synchronization between client and server uses A2A extension methods:

_cleveragents/sync/pull — Download server namespace entities to local cache

_cleveragents/sync/push — Upload local entity definitions to a server namespace

_cleveragents/sync/status — Compare local and server entity versions

The spec also defines:

server.sync.auto (boolean, default true) — auto-sync on startup
server.sync.interval (integer, default 300) — background sync interval

The agents server command group should provide sync subcommands:

agents server sync pull [--namespace <NS>]
agents server sync push [--namespace <NS>]
agents server sync status [--namespace <NS>]

These are the user-facing commands for the team collaboration feature: sharing actors, actions, skills, and projects across devices.

Actual Behavior (from code)

File: src/cleveragents/cli/commands/server.py

The server command group has no sync subcommands. The agents server --help shows only:

connect
status
serve

The A2A facade (src/cleveragents/a2a/facade.py) has stub handlers for _cleveragents/sync/pull, _cleveragents/sync/push, and _cleveragents/sync/status, but they all return {"status": "not_implemented", "stub": True} and there is no CLI surface to invoke them.

Steps to Reproduce

$ agents server --help
# No sync subcommand
$ agents server sync pull
# Command not found

Code Location

src/cleveragents/cli/commands/server.py — missing sync subcommand group
src/cleveragents/a2a/facade.py — _handle_sync_stub() returns not_implemented

Impact

The team collaboration feature (sharing resources/prompts/actors/actions/projects across devices) is completely inaccessible. Users cannot sync entity definitions between their local machine and the server, which is the primary value proposition of server mode.

Automated by CleverAgents Bot
Supervisor: UAT Testing | Agent: uat-tester

## Bug Report **Feature Area:** Server Mode — entity sync (shared resources/prompts/actors/actions/projects) ### What Was Tested The `agents server` command group for sync functionality per the spec. ### Expected Behavior (from spec) Per ADR-023 (Server Mode) and ADR-048 (Server Application Architecture), entity synchronization is a core server mode feature: > Entity synchronization between client and server uses A2A extension methods: > - `_cleveragents/sync/pull` — Download server namespace entities to local cache > - `_cleveragents/sync/push` — Upload local entity definitions to a server namespace > - `_cleveragents/sync/status` — Compare local and server entity versions The spec also defines: - `server.sync.auto` (boolean, default `true`) — auto-sync on startup - `server.sync.interval` (integer, default `300`) — background sync interval The `agents server` command group should provide `sync` subcommands: ``` agents server sync pull [--namespace <NS>] agents server sync push [--namespace <NS>] agents server sync status [--namespace <NS>] ``` These are the user-facing commands for the team collaboration feature: sharing actors, actions, skills, and projects across devices. ### Actual Behavior (from code) **File:** `src/cleveragents/cli/commands/server.py` The `server` command group has no `sync` subcommands. The `agents server --help` shows only: - `connect` - `status` - `serve` The A2A facade (`src/cleveragents/a2a/facade.py`) has stub handlers for `_cleveragents/sync/pull`, `_cleveragents/sync/push`, and `_cleveragents/sync/status`, but they all return `{"status": "not_implemented", "stub": True}` and there is no CLI surface to invoke them. ### Steps to Reproduce ```bash $ agents server --help # No sync subcommand $ agents server sync pull # Command not found ``` ### Code Location - `src/cleveragents/cli/commands/server.py` — missing `sync` subcommand group - `src/cleveragents/a2a/facade.py` — `_handle_sync_stub()` returns `not_implemented` ### Impact The team collaboration feature (sharing resources/prompts/actors/actions/projects across devices) is completely inaccessible. Users cannot sync entity definitions between their local machine and the server, which is the primary value proposition of server mode. --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

HAL9000 referenced this issue

2026-04-08 20:18:58 +00:00

[Automated] CleverAgents Build Session - 2026-04-08 #4799

HAL9000 referenced this issue

2026-04-08 20:22:25 +00:00

[Automated] CleverAgents Build Session - 2026-04-08 #4799

HAL9000 added the

labels

2026-04-08 22:59:22 +00:00

freemo commented

2026-04-08 23:40:09 +00:00

Owner

Issue triaged by project owner:

State: Verified
Priority: Medium — Missing CLI commands for entity sync; blocks team resource sharing workflows
Milestone: v3.5.0 (Autonomy Hardening — server mode)
Story Points: 5 — L — Implementing sync CLI commands requires new command group and service integration
MoSCoW: Should Have — Entity sync is important for team collaboration but not blocking single-user operation
Parent Epic: #4947 (Server Implementation Legendary)

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

Issue triaged by project owner: - **State**: Verified - **Priority**: Medium — Missing CLI commands for entity sync; blocks team resource sharing workflows - **Milestone**: v3.5.0 (Autonomy Hardening — server mode) - **Story Points**: 5 — L — Implementing sync CLI commands requires new command group and service integration - **MoSCoW**: Should Have — Entity sync is important for team collaboration but not blocking single-user operation - **Parent Epic**: #4947 (Server Implementation Legendary) --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner

freemo added

and removed

labels

2026-04-08 23:40:33 +00:00

freemo added this to the v3.5.0 milestone

2026-04-08 23:40:48 +00:00

freemo added a new dependency

2026-04-08 23:41:03 +00:00

#4947 LEGENDARY: Server Implementation — A2A Protocol, Multi-User & Team Collaboration

freemo commented

2026-04-08 23:41:15 +00:00

Owner

Issue triaged by project owner:

State: Verified
Priority: Medium — agents server sync CLI commands missing — no user-facing interface for entity sync
Milestone: v3.5.0 — Server sync CLI is M6 scope
Story Points: 5 — L — Implementing server sync CLI commands
MoSCoW: Should Have — Server sync is important for team workflows but not blocking local usage
Parent Epic: #360 (Autonomy Hardening + Stubs M6)

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

Issue triaged by project owner: - **State**: Verified - **Priority**: Medium — `agents server sync` CLI commands missing — no user-facing interface for entity sync - **Milestone**: v3.5.0 — Server sync CLI is M6 scope - **Story Points**: 5 — L — Implementing server sync CLI commands - **MoSCoW**: Should Have — Server sync is important for team workflows but not blocking local usage - **Parent Epic**: #360 (Autonomy Hardening + Stubs M6) --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner