12 Releases 14 Tags

RSS Feed

• fed-v0.1.0-m1 54c422ab06

  Compare

  Federation v1 — Milestone 1 (federated tier infrastructure) Stable

  jason.woltje released this 2026-04-20 02:24:50 +00:00 | 0 commits to main since this release

  Federation v1 — Milestone 1

  Federated tier infrastructure. Mosaic Stack gateway can now boot with PostgreSQL 17 + pgvector + Valkey under the new federated storage tier. No federation logic yet — this milestone is the foundation only.

  What's in this release

  • New federated storage tier in mosaic.config.json (alongside existing local and standalone)
  • docker-compose.federated.yml overlay (PG on 5433, Valkey on 6380, profile-gated)
  • Postgres adapter with idempotent CREATE EXTENSION vector and enableVector flag
  • Gateway tier-detector with fail-fast probes (PG, pgvector, Valkey) and actionable error messages
  • mosaic storage migrate-tier CLI — one-way migration from local (PGlite) / standalone → federated, idempotent, dry-run UX, advisory-lock concurrency safety
  • mosaic gateway doctor — JSON output, per-service health, pgvector presence
  • 7 integration tests behind FEDERATED_INTEGRATION=1 env flag
  • Credential redaction at all driver-error surfaces (postgres / postgresql / redis / rediss schemes)

  Migration

  Operators on local or standalone can migrate to federated using:

  mosaic storage migrate-tier --dry-run    # preview
  mosaic storage migrate-tier              # execute
  mosaic gateway doctor --json             # verify
  

  See docs/federation/SETUP.md and docs/guides/migrate-tier.md for full instructions.

  Standalone & local tiers

  Existing standalone and local deployments are unaffected. M1 changes are non-disruptive — verified by full regression run on existing test suites (351 gateway tests + 85 storage unit tests + full pnpm test, all green).

  What's next

  Milestone 2 (Step-CA + grant schema + admin CLI) is the first milestone with actual federation logic — gateway-to-gateway trust setup. Tracked in issue #461.

  PRs

  12 PRs merged: #470 → #481

  Issue closed

  #460

  Downloads

  • Source Code (ZIP)
  • Source Code (TAR.GZ)