Mammoth Documentation

Gem Version CI Ruby Version License: MIT

🦣 Mammoth is a self-hosted PostgreSQL Change Data Capture relay focused on reliable delivery of database change events to webhooks.

PostgreSQL
    ↓
pgoutput-client
    ↓
pgoutput-source-adapter
    ↓
CDC::Core::ChangeEvent
    ↓
Mammoth
    ↓
Webhook

Mammoth is intentionally boring infrastructure. It uses YAML configuration, JSON Schema validation, SQLite-backed operational memory, retries, checkpoints, and dead letters so operators can inspect and recover delivery state.

Start here

Current release scope

Mammoth 0.1.x focuses on:

  • PostgreSQL logical replication ingestion
  • normalized CDC event delivery to webhooks
  • retry handling
  • SQLite checkpoint storage
  • SQLite dead-letter storage
  • Docker image distribution
  • Helm-based Kubernetes deployment

Non-goals for 0.1.x

Mammoth 0.1.x does not yet provide:

  • a web dashboard
  • health or metrics HTTP endpoints
  • dead-letter replay commands
  • multi-destination routing
  • multiple active consumers for the same PostgreSQL replication slot

Those are future operational layers.