# Experimental Support Matrix Experimental code is library code in `dev.caskeleton.adapter.outbound.persistence.experimental`. Nothing composes it and no setting turns it on: a deployment that wants one of these creates the entry point in its own adapter code, and that call is the opt-in. None of it is part of the Stable composition, and `JpaModuleBoundaryTest` keeps Stable packages from depending on it. | Feature | Entry point | Evidence (PostgreSQL lane unless noted) | State | |---|---|---|---| | Shared-schema multi-tenancy (column) | `tenant.TenantContext`, `tenant.TenantAwareRepositoryGuard` | `TenantColumnIsolationTest` | Experimental | | PostgreSQL RLS multi-tenancy | `rls.RlsTenantSessionBinder`, `rls.RlsPolicyVerifier` | `RlsIsolationFailureTest` | Experimental | | Schema-per-tenant | `schema.SchemaMultiTenantConnectionProvider`, `schema.SchemaTenantMigrationOrchestrator` | `SchemaTenantMigrationContractTest` | Experimental | | Database-per-tenant pool budget | `database.TenantDataSourceRegistry`, `database.TenantPoolBudget` | `TenantPoolCapacityContractTest` | Experimental | | Consistency-aware read replica | `replica.ConsistencyAwareDataSourceRouter` (you implement `ReplicaLagMonitor`) | `ReadAfterWriteRoutingContractTest` | Experimental | | Jakarta Persistence 4.0, Hibernate ORM 8, PostgreSQL 19 | none — probes in `.github/workflows/jpa-next.yml` record `NOT_EXECUTABLE` | `Jpa4CompatibilityTest`, `Hibernate8CompatibilityTest`, `PostgreSql19CompatibilityTest` (unit-lane version canaries) | Not executable | The `backend.jpa.experimental.*` flags and `ExperimentalFeatureGate` that used to front these were removed on 2026-09-25: no code read the flags from configuration, so setting one did nothing, and the gate only checked a map the caller built itself. ## Known constraints - Tenant context is fail-closed. An unbound tenant in a shared-schema deployment means a query with no tenant predicate, which returns every tenant's rows. - A Hibernate filter is not the security boundary. It does not apply to native SQL, bulk DML, `getReference`, or the second-level cache. - RLS requires all three of: `ENABLE ROW LEVEL SECURITY`, `FORCE ROW LEVEL SECURITY` (the owner is otherwise exempt from its own policies), and a runtime role without `BYPASSRLS`. - Tenant bindings are transaction-local. A session-local setting survives the connection's return to the pool. - `readOnly=true` never routes to a replica on its own. Read-after-write uses a consistency token or the primary. - Unavailable replica lag evidence means the primary. Absence of evidence is not evidence of freshness. - Per-tenant pools are bounded globally. Fifty tenants with a modest pool each is five hundred connections against a server that permits a hundred. - Tenant ids never become metric tags. Tenant cardinality is unbounded by definition. ## Lanes never change Stable A compatibility lane publishes nothing and changes no Stable contract. If Hibernate 8 generates different SQL for the fetch-pagination gate, that is a finding about Hibernate 8 — the 7.x gate keeps asserting what 7.x must do, because that is what deployments run.