83 lines
3.4 KiB
Markdown
83 lines
3.4 KiB
Markdown
---
|
|
id: pg-fix-dedupe-cleanup
|
|
name: Decode dedupe + small cleanups in queue/tx/notify (review 002 minor notes)
|
|
status: pending
|
|
depends_on: [pg-fix-tx-wake]
|
|
scope: narrow
|
|
risk: low
|
|
impact: component
|
|
level: implementation
|
|
tags: [wave-4-fixes, postgres-engine, cleanup]
|
|
---
|
|
|
|
## Description
|
|
|
|
Batch the wave-4 general review's minor notes that share files and are
|
|
too small for standalone tasks
|
|
(`docs/reviews/002-wave-4-general-review.md` §Minor notes + §Finding
|
|
6's queue bullet):
|
|
|
|
- **`job_from_row` is byte-for-byte duplicated** (`queue.rs:411` and
|
|
`tx.rs:626`; only `pub(crate)` differs), and `get_job_tx` inlines
|
|
the 18-column dead/live select column lists (`tx.rs:420-428,
|
|
438-442`) duplicating `queue.rs`'s `live_columns()`/`dead_columns()`.
|
|
Both files claim "one decode owner" in their doc comments; both are
|
|
wrong. The `Job` shape is contract-pinned, so two owners is exactly
|
|
where a shape edit goes wrong later. **Dedupe into one module** —
|
|
`queue.rs` is the natural home; `tx.rs` imports it (as `tx.rs`
|
|
already imports `stream_events_from_rows` from `stream.rs`). The
|
|
doc comments must again tell the truth (one decode owner).
|
|
- **`queue.rs:71` doc fix (Finding 6)**: `sweep_expired` "returns the
|
|
moved count" — it returns moved + retention-deleted (`queue.rs:720`).
|
|
The SQLite twin returns the same sum (substrate `queue_ops.rs:232-243`),
|
|
so the engines agree; only the doc is wrong. ("Single-statement
|
|
atomic" is also inaccurate — it's the `in_tx` multi-statement
|
|
frame.) Correct both claims.
|
|
- **`notify.rs:106-110`**: the closed-store error is built inline
|
|
(`Error::database(std::io::Error::other(...))`) instead of the
|
|
shared `database_error` helper — one duplicate of the one message.
|
|
Route it through the helper.
|
|
- **`bridge_capacity()`** (`notify.rs:137-139`) is a function
|
|
returning a constant — a `const` says it plainly. Convert (keep the
|
|
doc comment's rationale on the const).
|
|
|
|
No behavior changes anywhere in this task — it is dedupe + doc
|
|
truth-telling. All existing tests must pass unchanged; where a test
|
|
asserts on the moved-count semantics, it already pins the sum (the
|
|
doc was the only liar).
|
|
|
|
**Depends on `pg-fix-tx-wake`**: that task edits `tx.rs`'s
|
|
publish/enqueue paths; this task restructures `tx.rs`'s decode side —
|
|
landing after avoids touching the same file regions blind.
|
|
|
|
## Acceptance Criteria
|
|
|
|
- [ ] `job_from_row` has one owner (`queue.rs`); `tx.rs` imports it;
|
|
both files' "one decode owner" doc claims are true
|
|
- [ ] `get_job_tx`'s dead/live column lists reuse `queue.rs`'s
|
|
`live_columns()`/`dead_columns()` (no inlined duplicates)
|
|
- [ ] `sweep_expired`'s doc states the moved + retention-deleted sum
|
|
and the `in_tx` frame (matching the SQLite twin's semantics)
|
|
- [ ] `notify.rs`'s closed-store error routes through
|
|
`database_error`; `bridge_capacity` is a `const`
|
|
- [ ] Zero behavior change: the full pg lib suite green against the
|
|
harness server, unchanged assertions
|
|
- [ ] `cargo clippy --all-targets -- -D warnings`, fmt clean; gates
|
|
green server-less
|
|
|
|
## References
|
|
|
|
- docs/reviews/002-wave-4-general-review.md §Minor notes + §Finding 6
|
|
(the queue bullet)
|
|
- docs/architecture/core-contract.md (the pinned `Job` shape — why one
|
|
decode owner matters)
|
|
- tasks/pg-engine-queues.md, tasks/pg-engine-seam-tx.md (the tasks of
|
|
record for the touched files)
|
|
|
|
## Notes
|
|
|
|
> To be filled by implementation agent
|
|
|
|
## Summary
|
|
|
|
> To be filled on completion |