Catalyst Runtime Architecture

Catalyst Runtime Architecture An architecture diagram generated by Archify. Operator Browser · Dashboard session · Untrusted network · untrusted Operator Browser Dashboard session untrusted Vercel Edge · Static SPA + /docs · Untrusted network · rewrite only Vercel Edge Static SPA + /docs rewrite only Customer Server · sdk-catalyst 0.2 · Untrusted network · reads, then decides Customer Server sdk-catalyst 0.2 reads, then decides SDK Disk Cache · ~/.cache/catalyst · Untrusted network SDK Disk Cache ~/.cache/catalyst Auth Dependency · get_current_sdk_key_or_user · Catalyst control plane · Render catalyst-api · key checked first Auth Dependency get_current_sdk_key_or_user key checked first Catalyst API · FastAPI · /api/v1 · Catalyst control plane · Render catalyst-api · Render · oregon Catalyst API FastAPI · /api/v1 Render · oregon Snapshot Service · load_env_snapshot · Catalyst control plane · Render catalyst-api · version-matched Snapshot Service load_env_snapshot version-matched Evaluator · precedence order · Catalyst control plane · Render catalyst-api · murmur3 Evaluator precedence order murmur3 Neon PostgreSQL 16 · 9 tables · asyncpg · Managed data stores · strip sslmode Neon PostgreSQL 16 9 tables · asyncpg strip sslmode Render Key Value · RESP :6379 · 25 MB · Render private network · no password · no password Render Key Value RESP :6379 · 25 MB no password static Bearer JWT X-SDK-Key User or ApiKey load snapshot evaluate_flag version-matched GET SQL · auth, writes, audit disk write Untrusted network Catalyst control plane · Render catalyst-api Managed data stores Render private network · no password

Serve path

  • • A dashboard toggle shows on the next check: the client reads conditionally, then decides locally.
  • • Warm read = one indexed Environment row + one Redis GET. No flag, state, or rule query at all.
  • • Precedence: kill switch → rules by ascending priority → percentage rollout → default, sorted inside the evaluator.

Two trust levels, one dependency

  • • X-SDK-Key is checked first, so a request carrying both headers authenticates as the key, not the user.
  • • Bearer JWT: 15 min access, 7 day refresh, no revocation, every owned project, all mutations.
  • • SDK key: no expiry until revoked, hard 403 on project mismatch, read-only, /bootstrap and /evaluate only.

Coherence and failure

  • • Environment.version is both the cache token and the weak ETag; a stale entry is a miss, never a stale read.
  • • A matching If-None-Match returns 304 before the body loads. X-Catalyst-Cache names the answering layer.
  • • Every Redis helper swallows errors and reports a miss: a cache outage is a slowdown, never a 500.