Compatibility

AlphaPreview ContractVerification Required

Concordia runtime boundary compatibility matrix.

Compatibility matrix for Concordia Cache, Gateway, Storage, TSDB, active compatibility, protocol fixtures, and Edge Workflows runtime boundaries.

Current availability

Private Beta. Public beta is scheduled for .

Matrix Snapshot

Matrix rows
15
Status values
6
Surface families
7

Audience

Use this matrix when deciding whether a Concordia Cache, Gateway, Storage, Time Series, active compatibility, protocol fixture, or Edge Workflows statement is current local alpha behavior, fixture or validation evidence, unsupported, future-facing, or still waiting on reviewer acceptance.

Maturity Status

Local Alpha Surfaces

Alpha

Cache, TSDB, Gateway, active compatibility, and active protocol rows preserve the local or in-memory limits attached to current runtime evidence.

Validation And Future Review

Verification Required

Identity, routing, Storage serving, Gateway commit semantics, future protocol frames, and Edge Workflows wording require reviewer acceptance before stronger public commitments.

Compatibility Scope

Local Product Binaries

Cache, TSDB, and Gateway rows name loopback HTTP behavior and fixed local bearer-token admission without expanding into distributed deployment claims.

Validation And Fixtures

Storage checks, local-alpha flags, Gateway placement metadata, and protocol frame evidence stay marked as validation or preview contract surfaces.

Future-Only Boundaries

Edge Workflows and future protocol frame IDs remain roadmap direction until runtime behavior and reviewer acceptance exist.

Status Legend

Supported

Implemented and validated for the exact documented scope.

Partial

Some behavior works, but documented gaps, limits, or exclusions apply.

Unsupported

Not implemented, intentionally unavailable, or rejected at runtime.

Preview

Contract, fixture, or bounded surface exists before complete customer-facing support.

Future

Roadmap direction only; no current runtime behavior should be expected.

Verification Required

Evidence or reviewer acceptance is missing for a support claim.

Runtime Boundary Matrix

Matrix owner: concordia-docs-owner. Required reviewers: concordia-product-sme, docs-qa-reviewer.

Review cadence
45 days
Warning window
14 days
Due soon rows
0
Stale rows
0
Concordia Cache, Gateway, Storage, TSDB, active compatibility, protocol, and workflow boundary rows
CapabilityStatusMaturityNotesEvidenceLast reviewed
Cache local binary startupSupportedAlphaconcordia-cache-bin starts a loopback HTTP service with --bind and optional --persistence-path; persistence is node-local and off unless configured.
  • CONC-EVID-002
  • CONC-EVID-006
  • DOCS-035
2026-08-16Due 2026-09-30Current
Cache local HTTP routesSupportedAlpha/health is open; protected put, get, count, and placement routes require Authorization: Bearer local-cache-token and stay local-alpha behavior.
  • CONC-EVID-003
  • CONC-EVID-004
  • CONC-EVID-005
2026-08-16Due 2026-09-30Current
Time Series local HTTP shellPartialAlphaconcordia-tsdb-bin exposes open health, protected sample append, protected recent query, newest-first reads, and process-local retention without durability or replication.
  • CONC-EVID-009
  • CONC-EVID-011
  • DOCS-026
2026-08-16Due 2026-09-30Current
Gateway readiness and placement diagnosticsPartialAlphaGateway health and placement diagnostics expose readiness, blockers, and cache placement inspection before writes are allowed.
  • CONC-EVID-010
  • CONC-EVID-011
  • DOCS-026
2026-08-16Due 2026-09-30Current
Fixture-backed Gateway placement metadataPreviewPreview ContractThe alpha Gateway tutorial uses fixtures/metadata/placement-alpha-v2.txt for bounded placement evidence; it does not prove external metadata watches.
  • CONC-EVID-010
  • placement-alpha-v2.txt
  • DOCS-026
2026-08-16Due 2026-09-30Current
Gateway alpha cache write routePartialAlphaPUT /v1/cache/{key} can return an accepted diagnostic response only after explicit local alpha write settings, owner transport, metadata fixture, retry budget, and tenant quota gates pass.
  • CONC-EVID-010
  • CONC-EVID-011
  • DOCS-035
2026-08-16Due 2026-09-30Current
Storage startup validationPreviewPreview Contractconcordia-storage-bin supports dry-run, require-ready, and validation-bound startup checks; normal dry-run opens no sockets.
  • CONC-EVID-011
  • bins/concordia-storage/src/startup.rs
  • DOCS-035
2026-08-16Due 2026-09-30Current
Storage local-alpha boundary flagsPreviewPreview ContractListener, frame, owner, follower, and quorum flags are narrow evidence modes, not general Storage serving or broad write-frame handling.
  • CONC-EVID-011
  • Service.Concordia README
  • DOCS-035
2026-08-16Due 2026-09-30Current
Active compatibility servicePartialAlphaThe concordia compatibility service exposes loopback HTTP and TCP ports for in-memory diagnostics, active AddReplicationGroupKV frames, and legacy gossip or heartbeat frames.
  • CONC-EVID-011
  • Concordia/src/main.rs
  • DOCS-035
2026-08-16Due 2026-09-30Current
Active binary protocol framesPartialAlphaLegacy gossip, legacy heartbeat, and active AddReplicationGroupKV frame families have parser and compatibility evidence; malformed frames remain rejected.
  • CONC-EVID-011
  • crates/concordia-protocol/src/registry.rs
  • DOCS-035
2026-08-16Due 2026-09-30Current
Future protocol registry allocationsFutureFutureCache mutation and replica append frame IDs are registry allocations for future use; allocation alone is not runtime support.
  • CONC-EVID-011
  • crates/concordia-protocol/src/registry.rs
  • PROJECT_MANAGEMENT.md
2026-08-16Due 2026-09-30Current
Edge Workflows runtimeFutureFutureEdge Workflows remain product direction until runtime behavior, workflow semantics, idempotency, side-effect boundaries, and reviewer acceptance exist.
  • CONC-EVID-001
  • CONC-EVID-007
  • PROJECT_MANAGEMENT.md
2026-08-16Due 2026-09-30Current
Production identity and JWT validationVerification RequiredVerification RequiredLocal bearer tokens are development admission only. JWT parsing, signature verification, key-source loading, and identity-provider integration need security acceptance.
  • CONC-EVID-003
  • CONC-EVID-011
  • CONC-EVID-012
2026-08-16Due 2026-09-30Current
Distributed routing, shared storage, quorum, and cross-node replicationUnsupportedVerification RequiredCurrent docs do not approve owner forwarding, external metadata watches, quorum commit, visible reads, shared storage, restart recovery, or cross-node replication claims.
  • CONC-EVID-006
  • CONC-EVID-010
  • CONC-EVID-011
2026-08-16Due 2026-09-30Current
Claim promotion to stronger readiness wordingVerification RequiredVerification RequiredSupport, security, operations, performance, scale, release, and customer-commitment wording needs separate accepted evidence before promotion.
  • CONC-EVID-007
  • CONC-EVID-011
  • CONC-EVID-012
2026-08-16Due 2026-09-30Current

Current Limits

Runtime bind, token, state, and protocol limits
LimitValueApplies to
Cache HTTP bind127.0.0.1:9101 by defaultLocal Cache binary
TSDB HTTP bind127.0.0.1:9201 by defaultLocal Time Series shell
Gateway HTTP bind127.0.0.1:9301 by defaultGateway diagnostics and alpha write route
Active compatibility portsHTTP 900{node_id}, TCP 800{node_id}Active compatibility service
Cache admission tokenlocal-cache-tokenCache protected routes
TSDB admission tokenlocal-tsdb-tokenTSDB sample append and recent query
Gateway admission tokenlocal-gateway-token by defaultGateway protected alpha write route
Time Series storageprocess-local memoryTSDB append, recent query, and retention checks
Active compatibility statein-memory onlyHTTP diagnostics and TCP frame handling
Future protocol frame supportregistry allocation onlyCache mutation and replica append frame IDs

Explicit Exclusions

Production identity, direct identity-provider integration, owner forwarding, external metadata watches, quorum commit, visible reads, shared storage, cross-node replication, broad Storage serving, support, availability, performance, scale, security, and customer commitments are outside the active local and validation surfaces described by this matrix.

Evidence

DOCS-041 evidence map
Matrix areaEvidenceStatusLast reviewed
Runtime reference mapCONC-EVID-011 and DOCS-035pending2026-08-16
Cache local workflowCONC-EVID-002 through CONC-EVID-008 and DOCS-025pending2026-08-16
TSDB and Gateway alpha workflowCONC-EVID-009, CONC-EVID-010, and DOCS-026pending2026-08-16
Storage and protocol boundariesCONC-EVID-011 and Service.Concordia startup/protocol sourcespending2026-08-16
Compatibility page artifactCONC-EVID-012 and docs/compatibility/DOCS-041-concordia-runtime-boundary-compatibility.mdpending2026-08-16

Internal review records track this Concordia compatibility matrix and the evidence required to change row status.

Limits

This matrix covers current Concordia local, alpha, validation, fixture, and future-facing documentation only. Local bearer tokens, diagnostic Gateway accepted writes, Storage local-alpha flags, active compatibility memory, and future protocol IDs stay scoped to the rows above.

See the runtime reference for command and route behavior, the Cache quickstart for the local Cache workflow, and the TSDB and Gateway tutorial for alpha route boundaries.

Safe Next Steps

  • Available: DOCS-035

    Read runtime surface reference

    Check source-backed command, route, auth, response, error, maturity, and evidence boundaries behind the matrix rows.

  • Available: DOCS-025

    Run the Cache quickstart

    Exercise local Cache startup, admission, key operations, placement diagnostics, and node-local persistence limits.

  • Available: DOCS-026

    Try TSDB and Gateway alpha tutorial

    Append local Time Series samples, inspect Gateway readiness, and keep alpha write behavior diagnostic.

  • Available: DOCS-061

    Use local curl examples

    Review bounded examples for matrix rows that are local, alpha, diagnostic, or active-compatibility only.

  • Available: DOCS-053

    Use validation runbooks

    Translate Cache, TSDB, Gateway, Storage, active service, and protocol validation output into bounded evidence.

  • Available

    Review Concordia evidence

    Check source records before expanding Cache, Gateway, Storage, TSDB, active compatibility, protocol, or workflow wording.

  • Available: DOCS-042

    Read known limits

    See local identity, Gateway diagnostic write, Storage validation, future frame, and Edge Workflows boundaries.

  • Available: DOCS-043

    Track matrix review workflow

    Use the workflow for stale-row checks, evidence refresh, owner review, and release-note updates.