EPIC: Registry & Resource Discovery — Real Data from Server Registry (v3.8.0) #9498

Open
opened 2026-04-14 19:53:46 +00:00 by HAL9000 · 2 comments
Owner

Metadata

  • Commit message: feat(server): implement registry and resource discovery with real data
  • Branch name: feat/v3.8.0-registry-resource-discovery

Background and Context

As part of the v3.8.0 milestone (M9: Server Implementation) and Legendary #4947, this Epic delivers the server-side registry and resource discovery functionality. Currently, registry list operations for actors, skills, actions, and projects return stub data or raise NotImplementedError. This Epic replaces all stubs with real implementations backed by the PostgreSQL database.

Key ADRs: ADR-047 (A2A Standard Adoption), ADR-048 (Server Application Architecture).

This Epic blocks the parent Legendary #4947.

Expected Behavior

When this Epic is complete:

  • _cleveragents/actor/list returns real actor data from the server registry
  • _cleveragents/skill/list returns real skill data from the server registry
  • _cleveragents/action/list returns real action data from the server registry
  • _cleveragents/project/list returns real project data from the server registry
  • Agent Card endpoint (/.well-known/agent.json) serves correct registry metadata
  • Registry operations work across namespaces (local and shared)

Acceptance Criteria

  • _cleveragents/actor/list A2A handler returns real actor data (not stub)
  • _cleveragents/skill/list A2A handler returns real skill data (not stub)
  • _cleveragents/action/list A2A handler returns real action data (not stub)
  • _cleveragents/project/list A2A handler returns real project data (not stub)
  • Agent Card endpoint (/.well-known/agent.json) serves correct metadata
  • Registry operations work across local and shared namespaces
  • Integration tests verify all registry operations
  • nox passes with coverage >= 97%

Subtasks

  • Implement _cleveragents/actor/list A2A handler with real database queries
  • Implement _cleveragents/skill/list A2A handler with real database queries
  • Implement _cleveragents/action/list A2A handler with real database queries
  • Implement _cleveragents/project/list A2A handler with real database queries
  • Implement Agent Card endpoint with correct registry metadata
  • Add cross-namespace registry resolution
  • Write integration tests for all registry operations
  • Verify coverage >= 97%

Child Issues

Child implementation issues will be linked here as they are created.

  • Implement actor registry list handler — TBD
  • Implement skill registry list handler — TBD
  • Implement action registry list handler — TBD
  • Implement project registry list handler — TBD
  • Implement Agent Card endpoint — TBD

Definition of Done

This Epic should be closed when:

  1. All acceptance criteria above are verified and checked off
  2. All child implementation issues are closed
  3. Test coverage >= 97% is confirmed by CI
  4. Code has passed peer review and been merged to the main branch

Automated by CleverAgents Bot
Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor [AUTO-EPIC-1]

## Metadata - **Commit message**: `feat(server): implement registry and resource discovery with real data` - **Branch name**: `feat/v3.8.0-registry-resource-discovery` ## Background and Context As part of the v3.8.0 milestone (M9: Server Implementation) and Legendary #4947, this Epic delivers the server-side registry and resource discovery functionality. Currently, registry list operations for actors, skills, actions, and projects return stub data or raise `NotImplementedError`. This Epic replaces all stubs with real implementations backed by the PostgreSQL database. Key ADRs: ADR-047 (A2A Standard Adoption), ADR-048 (Server Application Architecture). This Epic blocks the parent Legendary #4947. ## Expected Behavior When this Epic is complete: - `_cleveragents/actor/list` returns real actor data from the server registry - `_cleveragents/skill/list` returns real skill data from the server registry - `_cleveragents/action/list` returns real action data from the server registry - `_cleveragents/project/list` returns real project data from the server registry - Agent Card endpoint (`/.well-known/agent.json`) serves correct registry metadata - Registry operations work across namespaces (local and shared) ## Acceptance Criteria - [ ] `_cleveragents/actor/list` A2A handler returns real actor data (not stub) - [ ] `_cleveragents/skill/list` A2A handler returns real skill data (not stub) - [ ] `_cleveragents/action/list` A2A handler returns real action data (not stub) - [ ] `_cleveragents/project/list` A2A handler returns real project data (not stub) - [ ] Agent Card endpoint (`/.well-known/agent.json`) serves correct metadata - [ ] Registry operations work across local and shared namespaces - [ ] Integration tests verify all registry operations - [ ] `nox` passes with coverage >= 97% ## Subtasks - [ ] Implement `_cleveragents/actor/list` A2A handler with real database queries - [ ] Implement `_cleveragents/skill/list` A2A handler with real database queries - [ ] Implement `_cleveragents/action/list` A2A handler with real database queries - [ ] Implement `_cleveragents/project/list` A2A handler with real database queries - [ ] Implement Agent Card endpoint with correct registry metadata - [ ] Add cross-namespace registry resolution - [ ] Write integration tests for all registry operations - [ ] Verify coverage >= 97% ## Child Issues > Child implementation issues will be linked here as they are created. - [ ] Implement actor registry list handler — _TBD_ - [ ] Implement skill registry list handler — _TBD_ - [ ] Implement action registry list handler — _TBD_ - [ ] Implement project registry list handler — _TBD_ - [ ] Implement Agent Card endpoint — _TBD_ ## Definition of Done This Epic should be closed when: 1. All acceptance criteria above are verified and checked off 2. All child implementation issues are closed 3. Test coverage >= 97% is confirmed by CI 4. Code has passed peer review and been merged to the main branch --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor [AUTO-EPIC-1]
Author
Owner

🏷️ Triage Decision — [AUTO-OWNR-1]

Status: Verified

Issue Type: Epic (v3.8.0)
MoSCoW: Should Have — Server registry is in v3.8.0 scope
Priority: Medium

Rationale: Registry & Resource Discovery with real server data is part of the v3.8.0 Server Implementation milestone. Should Have because it extends the server capabilities beyond the core A2A transport.

Labels to apply: State/Verified, MoSCoW/Should have, Priority/Medium, Type/Epic


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

## 🏷️ Triage Decision — [AUTO-OWNR-1] **Status:** ✅ Verified **Issue Type:** Epic (v3.8.0) **MoSCoW:** Should Have — Server registry is in v3.8.0 scope **Priority:** Medium **Rationale:** Registry & Resource Discovery with real server data is part of the v3.8.0 Server Implementation milestone. Should Have because it extends the server capabilities beyond the core A2A transport. **Labels to apply:** State/Verified, MoSCoW/Should have, Priority/Medium, Type/Epic --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner-pool-supervisor
Author
Owner

Triage Decision [AUTO-OWNR]

Status: Verified

Type: Feature
Priority: Medium
MoSCoW: Could Have
Milestone: v3.8.0

Rationale: Registry & Resource Discovery with real data from the server registry is a v3.8.0 future milestone feature. It is desirable for the full server experience but not required for the current target milestones (v3.4.0-v3.7.0). Could Have for v3.8.0.


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

## Triage Decision [AUTO-OWNR] **Status**: ✅ Verified **Type**: Feature **Priority**: Medium **MoSCoW**: Could Have **Milestone**: v3.8.0 **Rationale**: Registry & Resource Discovery with real data from the server registry is a v3.8.0 future milestone feature. It is desirable for the full server experience but not required for the current target milestones (v3.4.0-v3.7.0). Could Have for v3.8.0. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner-pool-supervisor
HAL9000 added this to the v3.8.0 milestone 2026-04-16 10:35:23 +00:00
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.

Dependencies

No dependencies set.

Reference
cleveragents/cleveragents-core#9498
No description provided.