Skip to content

Commit c7e336d

Browse files
committed
docs: simplify ROADMAP.md into pre-v0.1.0, v0.1.0-v0.x, and v1.0.0 stages
1 parent c98fc2e commit c7e336d

1 file changed

Lines changed: 26 additions & 59 deletions

File tree

‎ROADMAP.md‎

Lines changed: 26 additions & 59 deletions
Original file line numberDiff line numberDiff line change
@@ -1,73 +1,40 @@
11
# Agent Mesh Roadmap
22

3-
## Phase 1: Alpha
3+
Agent Mesh is developed in three clear stages: validating the core architecture (`pre-v0.1.0`), expanding ecosystem integrations on a stable foundation (`v0.1.0` – `v0.x`), and locking in long-term backward compatibility (`v1.0.0`).
44

5-
**Versions:** `v0.1.0-alpha.x`
6-
**Status:** Under Construction / Ephemeral
5+
---
76

8-
The Alpha phase is focused on laying the foundational architecture, finalizing API contracts, and gathering community feedback. The network is functional but expects breaking changes as we iterate.
7+
## 1. Pre-`v0.1.0` — Exploratory and Core Foundation
98

10-
* **Core Objectives:**
9+
**Versions:** `v0.1.0-alpha.x`, `v0.1.0-rc.x`
10+
**Stability:** Exploratory — rapid iteration to validate the core protocol, security model, and developer experience.
1111

12-
* Establish P2P routing and base node lifecycle.
13-
* Deploy community developer testnets.
14-
* Draft the initial architecture documentation.
15-
* Integrate baseline network services: MCP, A2A, Inference.
12+
* **P2P Dataplane and Discovery:** Encrypted peer-to-peer connectivity (`libp2p` QUIC and TLS 1.3), Kademlia DHT service discovery, NAT hole-punching, and stateless `agentmesh-router` relays.
13+
* **Named Service Primitives:** Deny-by-default routing over four named schemes (`mcp://`, `a2a://`, `inference://`, `egress://`) instead of flat IP subnets.
14+
* **Identity and Task-Scoped Authorization:** Enrollment via OIDC, SPIFFE, and Kubernetes ServiceAccounts; channel-bound Biscuit credentials; compiled Datalog policy; and offline task attenuation (`tar_block`).
15+
* **Unified API and SDKs:** Single protobuf contract (`api/agentmesh.proto`), `agentmesh-node` daemon, standalone `agentmesh-one` binary, and native TypeScript (`sdk/js`) and Python (`sdk/python`) SDKs.
16+
* **Developer Testnets:** Public testnets and one-command onboarding (`agentmesh-node skill install`).
1617

17-
* **Exit Criteria:**
18+
---
1819

19-
* Core network primitives are stable.
20-
* Documentation accurately reflects the cryptographic boundaries and operational models.
20+
## 2. `v0.1.0` – `v0.x` — Stable Core, Integrations, and Ecosystem
2121

22-
## Phase 2: Beta (Feature Completion)
22+
**Versions:** `v0.1.0` through `v0.x.x`
23+
**Stability:** Stable for adoption — the core architecture and wire protocol are stable, with minor breaking changes possible between `0.x` minor releases as integrations mature.
2324

24-
**Versions:** `v0.1.0` through `v0.x.x`
25-
**Status:** Functional, but APIs may break
25+
* **Sandboxes and Kubernetes Interoperability:** Turnkey integration with Kubernetes and isolated agent sandboxes so existing workloads can connect and burst across platforms with zero credentials inside guest memory.
26+
* **Agent Gateways and Service Meshes:** Native interoperability with agent gateways and service meshes over standard HTTP and OAuth 2.0 Token Exchange (`RFC 8693`).
27+
* **Cloud Secret Managers and Identity Federation:** Integration with cloud secret managers, key management systems, certificate authorities, and outbound cloud token exchange services for customer-governed sovereign meshes.
28+
* **Visibility, Audit Logging, and Fleet Operations:** OpenTelemetry metrics, tamper-evident audit logs across multi-hop agent calls, cryptographic geo-fencing (`region` labels), and multi-mesh fleet management.
29+
* **Packaging and Ecosystem:** Production Helm charts, Kubernetes controllers, agent harness skills, and mobile and edge companion nodes.
2630

27-
The Beta phase iterates on functional completeness based on real-world deployments. Breaking changes are isolated to minor version bumps (`0.2.0`, `0.3.0`).
31+
---
2832

29-
* **Core Objectives:**
33+
## 3. `v1.0.0` and Beyond — Long-Term Production Stability
3034

31-
* Full implementation of local Datalog attenuation (the "Autonomous Local Veto").
32-
* Uncooperative sandbox confinement for agent execution (`network=none`).
33-
* Bring-Your-Own (BYO) OIDC Identity Provider federation (e.g., Keycloak, Dex).
34-
* Fail-closed jurisdictional label routing (e.g., `X-Mesh-Required-Labels: jurisdiction=eu`).
35+
**Versions:** `v1.0.0+`
36+
**Stability:** Super stable — strict SemVer backward compatibility and enterprise-grade reliability.
3537

36-
* **Exit Criteria:**
37-
38-
* All planned data-residency and control features are implemented and passing integration tests.
39-
* API and Datalog schemas are frozen.
40-
41-
## Phase 3: The Audit Freeze (Release Candidates)
42-
43-
**Versions:** `v1.0.0-rc.x`
44-
**Status:** Feature Frozen / Undergoing Audit
45-
46-
During this phase, **no new features are merged**.
47-
The codebase is strictly locked down to undergo rigorous external validation to ensure it meets our security and data-residency guarantees.
48-
49-
* **Core Objectives:**
50-
51-
* **Security Audit:** Comprehensive third-party penetration testing, code review, and cryptography validation (focusing on Biscuit tokens and Ed25519 key handling).
52-
* **Compliance Audit:** Validation against data-residency and traceability frameworks (e.g., GDPR data residency, EU AI Act traceability, CSF SEAL-3).
53-
54-
* **Exit Criteria:**
55-
56-
* All critical and high-severity security vulnerabilities are remediated.
57-
* External auditors officially sign off on the cryptographic and architectural claims.
58-
59-
## Phase 4: Production Stable
60-
61-
**Versions:** `v1.0.0` and beyond
62-
**Status:** Mission-Critical Ready
63-
64-
The framework is certified for enterprise, regulated, and cross-border deployments.
65-
66-
* **Core Objectives:**
67-
68-
* Strict enforcement of SemVer backward compatibility.
69-
70-
* **Exit Criteria:**
71-
72-
* Continuous automated compliance scanning integrated into CI/CD.
73-
* Established incident response and CVE publication lifecycle.
38+
* **Frozen Wire and Policy Contracts:** Guaranteed backward compatibility for `api/agentmesh.proto`, persisted node credentials (`MemberCredential`), and Datalog policy evaluation across `1.x` releases.
39+
* **Independent Security Audits:** Third-party cryptographic and penetration audits covering Biscuit token verification, PeerID channel binding, and key rotation.
40+
* **High Availability and Lifecycle Guarantees:** Multi-replica control plane high availability, zero-downtime upgrades, automated conformance testing, and a formal CVE disclosure and long-term support (LTS) policy.

0 commit comments

Comments
 (0)