catalog / services

Job Queue

Enqueue background work and run it reliably: retries, scheduling, dead letters.

19 capabilities 2 sections reference specification

Build against it

# give your agent the catalog — no account, no install
claude mcp add provespec -- npx -y provespec-mcp

# then, from any agent session
spec_get(slug: "job-queue")                → the capability tree
spec_checklist(slug: "job-queue")          → the questions to answer
spec_grade(slug: "job-queue", grades: [...])  → parity % + the gap list

# or just fetch it
curl https://provespec.com/catalog/job-queue/spec.json

Grade every capability below as yes · partial · no · na, with a file reference as evidence. Whatever you leave ungraded counts as missing — the gap list is the work queue.

Or just paste this to your agent

Use the ProveSpec MCP server. Fetch the "job-queue" spec with
spec_get, then walk spec_checklist and grade this repository against it —
one verdict per capability, each with a file reference as the note.
Call spec_grade with the results and give me the gap list as the plan.

If the server is not registered, add it first:
  claude mcp add provespec -- npx -y provespec-mcp

The specification

AI 16

Enqueue
  • Submit a job with a payload returns a job id
  • Delayed and scheduled jobs run at / run in
  • Recurring jobs on a cron expression
  • Deduplicate by idempotency key same key, one job
  • Priority ordering
Execution
  • At-least-once delivery to a worker stated delivery guarantee
  • Visibility timeout with heartbeat extension a crashed worker releases its job
  • Concurrency limit per queue and per worker
  • Rate limiting per queue
Failure
  • Retry with exponential backoff and jitter bounded attempt count
  • Dead-letter queue after final failure with the error recorded
  • Manual retry from the dead-letter queue
Lifecycle
  • Cancel a queued job
  • Job states are observable queued/running/done/failed
  • Completed job retention window then pruned
Observability
  • Queue depth, throughput and age metrics

UI 3

Dashboard
  • Queues with depth and failure counts
  • Job inspector with payload, attempts and error
  • Retry, cancel and purge actions
Download spec.json All 53 specs