pulse

A reliable, Postgres-backed distributed job queue in Go — gRPC server, typed SDK, operator CLI.

Start here

• Getting started — run the server, configure it, submit a first job.
• Using the SDK — handlers, retries and idempotency, priority, schedules, pause/resume.
• CLI — inspect jobs, control dispatch, manage credentials.

Understand it

• Architecture — the data model, request flows, and where each guarantee comes from.
• Design decisions (ADRs) — every non-trivial choice with its alternatives and consequences.
• Benchmarks — throughput, latency, and claim-contention numbers, with the methodology to reproduce them.
• Crash recovery — a captured kill -9 run: lease lapse, watchdog reap, re-dispatch, completion.

Contribute

• Contributing — dev setup, test conventions, module layout.