Task: Use the engine's idempotency check in the reporting handlers
Table of Contents
This page documents a task in the Implement the full report pipeline story. It captures the goal, current status, acceptance, and any notes or results.
1. Goal
Every reporting step converges when the engine re-dispatches it, so a run that a restart recovered does the work of each phase once.
2. Status
| Field | Value |
|---|---|
| State | BACKLOG |
| Parent story | Implement the full report pipeline |
| Now | Not yet started. |
| Waiting on | Nothing. |
| Next | Begin implementation. |
| Last touched | 2026-09-28 |
3. Acceptance
- A re-dispatched assemble_bundle does not write a second bundle row.
- A re-dispatched gather_trades, gather_market_data or prepare_ore_package does not re-export or re-upload what it produced before.
- A test re-dispatches a completed step and asserts that the phase's effect happened once.
4. Plan
(Implementation strategy. Written when work starts; key decisions
are distilled into the parent story's * Decisions at close, but the
plan itself stays — it is the historical record of what we did.)
5. Measurements
Every number this task claims about a tree, with the command that produced it
and the commit it was measured at. A number without both is not a measurement,
because a clean-up record describes a tree and trunk moves under a branch: a
consumer count, a gate's component count and a suite's size all change with no
code changing, and the reader of a bare number cannot tell which tree it came
from. Where the raw output matters, put it in an evidence/ file beside the
task and name that file in the Command column.
| What | Value | Command | Commit |
|---|---|---|---|
6. Notes
7. Test Scenarios
Manual QA scenarios (scaffolded via compass add test_scenario)
that verify this task. Link
new ones here as they're created; the scenario doc itself links back
via its "Verifies task" field.
| Scenario | State | Notes |
|---|---|---|
8. PRs
| PR | Title |
|---|---|
9. Review
| Comment summary | File | Decision | Notes |
|---|---|---|---|