feat: Open Context 2.0 Architectural Specifications & Implementation Plans

[adityak74]

Summary

This PR establishes the core architectural specifications, distributed scalability design, release roadmap, and detailed task-by-task implementation plans for Open Context 2.0: The Open, Storage-Agnostic Context Data Plane for AI Agents.

Documents Included

1. Strategic Roadmap: ROADMAP.md

   • 6-Phase release plan from v2.0-alpha through v2.2+
   • Three-Plane architecture overview (Control, Data, Event)
   • Protocol boundaries (MCP vs A2A vs Open Context / CSTP)

2. Master Specification: docs/spec-open-context-2.0.md

   • Core positioning: Bring your model. Bring your agent. Bring your database. Keep your context.
   • Canonical Open Context Model (OCM 2.0) with multi-tenancy, scopes, provenance, relationships, and vector clocks.
   • Provider SPI (ContextStore) & Provider SDK (@opencontext/provider-sdk).

3. Distributed Data Plane & Scalability Architecture: docs/spec-distributed-context-data-plane.md

   • Three-Plane Architecture (Control Plane, Data Plane, Event Plane).
   • Open Context Node runtime co-located with target databases (zero central ingestion bottleneck).
   • Namespace-based sharding and causal ordering invariants.
   • Normalized ContextEvent model & pluggable EventBackend SPI (InMemory, SQLite, NATS JetStream).
   • Stateless subscription matcher fleet, durable cursors, and zero-loss crash recovery.
   • Federation Directory and capability-aware query planning.
   • Direct node-to-node CSTP transfer with credit-based flow control.

4. Sub-Project 1 Design & Plan (Canonical Model & Provider SPI):

   • Design: docs/superpowers/specs/2026-08-25-canonical-model-provider-spi-design.md
   • Plan: docs/superpowers/plans/2026-08-25-canonical-model-provider-spi.md
   • Features: CanonicalContext, ContextStoreV1Shim for 100% backward compatibility with 1.x MCP tools, SqlContextStore, DocumentContextStore, JsonContextStore, and universal DSN loader.

5. Sub-Project 2 Design & Plan (Distributed Data Plane & Reactive Events):

   • Design: docs/superpowers/specs/2026-08-25-distributed-context-data-plane-design.md
   • Plan: docs/superpowers/plans/2026-08-25-distributed-context-data-plane.md
   • Features: ContextEvent factory, SqliteEventLog, InMemoryEventBackend, durable SubscriptionManager, ReactiveContextStore outbox interceptor, and reactive MCP/SSE endpoints.

[cloudflare-workers-and-pages]

Deploying open-context with    Cloudflare Pages

Latest commit:	4effdfd
Status:	✅  Deploy successful!
Preview URL:	https://c613bfd8.open-context.pages.dev
Branch Preview URL:	https://feat-opencontext-2-0.open-context.pages.dev

View logs