diff --git a/docs/specification.md b/docs/specification.md index f0803345d..516984f3c 100644 --- a/docs/specification.md +++ b/docs/specification.md @@ -46797,7 +46797,7 @@ The following table shows which Protocol each pipeline slot implements and what ## Milestone Plan -This section defines the ordered milestone plan for CleverAgents v3.x, mapping architectural features to verifiable deliverables. Each milestone builds on the previous and is independently testable. Milestones v3.0.0 and v3.1.0 are **complete**. This plan covers v3.2.0 through v3.7.0 — the production-ready target. +This section defines the ordered milestone plan for CleverAgents v3.x, mapping architectural features to verifiable deliverables. Each milestone builds on the previous and is independently testable. Milestones v3.0.0 and v3.1.0 are **complete**. This plan covers v3.2.0 through v3.9.0 — including v3.8.0 (Server Implementation) and v3.9.0 — the production-ready target. !!! note "Milestone Status (as of 2026-04-08)" - **v3.0.0** ✅ CLOSED — Minimal Local Source-Code Workflow @@ -47064,6 +47064,26 @@ This section defines the ordered milestone plan for CleverAgents v3.x, mapping a - No open P0/P1 bugs in v3.7.0 milestone - Full TUI functional end-to-end: launch, persona, reference/command input, multi-session, settings, session management +### v3.8.0 — Server Implementation + +**Goal**: Implement the CleverAgents server and all server-dependent capabilities using the A2A (Agent-to-Agent) protocol standard. + +**Key ADRs**: ADR-047 (A2A Standard Adoption), ADR-048 (Server Application Architecture) + +**Deliverables**: + +- A2A JSON-RPC 2.0 wire format and `_cleveragents/` extension method routing (see [A2A Protocol](#agent-to-agent-protocol-a2a)) +- A2A stdio transport (local mode — agent as subprocess) +- A2A HTTP transport (server mode — single JSON-RPC endpoint) +- LangGraph Platform RemoteGraph integration for server-side actor execution +- Server application structure (FastAPI + A2A SDK) (see [Server and Client Architecture](#server-and-client-architecture)) +- Authentication and authorization (API tokens, team RBAC) +- Entity sync via `_cleveragents/sync/*` extension methods +- Multi-device experience, shared namespaces, PostgreSQL backend +- Server deployment (Docker + Kubernetes + Helm) + +**Status**: Active development. No deadline assigned. Development effort should focus on M1–M6 milestones first. + --- ### Cross-Milestone Quality Gates