feat(v2): implement Canonical Model and Provider SPI (Sub-Project 1)

[adityak74]

Description

This PR implements Sub-Project 1: Canonical Model & Provider SPI as part of the Open Context 2.0 architecture rewrite. It establishes the strict, deterministic data plane and the unified storage backend contracts while ensuring 100% backward compatibility for all existing 1.x MCP operations.

Key Highlights

• Monorepo Scaffolding: Configured npm workspaces and introduced @opencontext/core and @opencontext/provider-sdk packages.
• Canonical Model & Identity: Implemented the CanonicalContext specification with 80-bit randomized, strictly monotonic ULIDs and deterministic SHA-256 object hashing.
• Provider SPI Contracts: Established the unified ContextStore capability contract with built-in multitenancy isolation and robust, type-safe error structures.
• Dual-Layer Backward Compatibility: Shipped the ContextStoreV1Shim which acts as a virtual translation layer, allowing all 11 legacy MCP tools to seamlessly run against the new v2 engines with zero regressions.
• First-Party Storage Engines:
  • MemoryContextStore: Thread-safe, highly concurrent in-memory store.
  • JsonContextStore: Atomic, file-backed JSON serialization store.
  • SqlContextStore: Multi-dialect SQL mapping with implemented SqliteDialect (using zero-dependency node:sqlite) and PostgresDialect.
• Universal DSN Loader: Re-wired the StoreManager to dynamically load engines via DSN (memory://, json://tmp/ctx.json, sqlite://:memory:).
• Concurrency Safety: Full support for revision-based Optimistic Concurrency Control (OCC) across all engines.

Testing & Validation

• Added an exhaustive cross-provider integration suite (tests/integration/providers-consistency.test.ts) that mutates, queries, and filters the exact same context datasets across the Memory, JSON, and SQLite providers to verify bit-for-bit structural consistency.
• 480/480 tests passing. Output is pristine.

Notes for Reviewers

While this PR introduces the new native v2 MCP tools (save_canonical_context, query_canonical_context), legacy 1.x tools remain the default until the ecosystem fully migrates.

[cloudflare-workers-and-pages]

Deploying open-context with    Cloudflare Pages

Latest commit:	6316acd
Status:	✅  Deploy successful!
Preview URL:	https://5bfe3f7b.open-context.pages.dev
Branch Preview URL:	https://canonical-model-provider-spi.open-context.pages.dev

View logs