Skip to content

feat(redrive): DLQ redrive tooling — safe replay (ADR-0026)#3

Merged
muhammetsafak merged 1 commit into
mainfrom
feat/redrive
Jun 19, 2026
Merged

feat(redrive): DLQ redrive tooling — safe replay (ADR-0026)#3
muhammetsafak merged 1 commit into
mainfrom
feat/redrive

Conversation

@muhammetsafak

Copy link
Copy Markdown
Member

The Java mirror of babelqueue-go Redrive (ADR-0026) — the operator tool for replaying off the dead-letter queue.

What

Redrive.redrive(transport, dlq, opts) drains a DLQ and re-publishes each message to its dead_letter.original_queue (or opts.toQueue), reset for reprocessing: the dead_letter block stripped and attempts reset to 0, while job, trace_id, data and meta are preserved verbatim. Options via Redrive.Options.all().toQueue(..).max(..).dryRun(..).select(..).

The codec-only Java core has no transport, so redrive works over a minimal Redrive.Transport seam (pop/publish/ack) the caller implements over their broker — the same shape as the otel module's Sender. Drains-then-processes; acks a DLQ message only after a successful re-publish; restores undecodable bodies (a null-job envelope) and on publish failure. No new dependency; envelope frozen (GR-1).

Tests / gate

8 tests via an in-memory transport (to-source + reset/trace preserved, sandbox, dry-run, select, max, publish-failure-restores, undecodable restored, no-dead_letter fallback). mvn verify: 67 tests pass, JaCoCo ≥0.90 met, SpotBugs 0.

Follow-up

The Replay-Bypass guard (a bq-replay-bypass transport header surfaced to handlers so a replay can skip external side-effects) is a documented phase two.

🤖 Generated with Claude Code

Java mirror of babelqueue-go Redrive: Redrive.redrive(transport, dlq, opts) drains a DLQ and re-publishes each message (reset: strip dead_letter, attempts->0, preserve job/trace_id/data/meta) to its dead_letter.original_queue or opts.toQueue. Options all()/toQueue/max/dryRun/select. The codec-only core has no transport, so it works over a minimal Transport seam the caller implements (like the otel Sender). Drains-then-processes; acks only after a successful re-publish; restores undecodable bodies (a null-job envelope) and on publish failure. No new dependency; envelope frozen. Replay-Bypass header documented as phase two.
@muhammetsafak muhammetsafak merged commit a73865c into main Jun 19, 2026
7 checks passed
@muhammetsafak muhammetsafak deleted the feat/redrive branch June 19, 2026 05:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant