Reword or retire the net_r_equity skip notice on a bare sweep (points at a campaign document the user never wrote) #240

Closed
opened 2026-07-11 14:21:58 +02:00 by Brummel · 1 comment
Owner

Milestone fieldtest finding (2026-07-11, friction; consumer POV at d3ad9f4): a bare aura sweep … --trace (no cost model anywhere in play) prints

aura: tap "net_r_equity" needs a cost model; add a cost block to the campaign document; skipped

The user invoked sweep; that verb has no cost surface, so the suggested remedy ("add a cost block to the campaign document") is unreachable from where they stand — the diagnostic leaks the internal sweep→campaign desugaring. Harmless (the sweep succeeds and the other taps persist), but the remedy misdirects.

Directions: drop net_r_equity from the sweep-desugared default tap set, or reword the notice per invoked verb (naming a remedy reachable from sweep, or stating plainly that net taps are campaign-only).

Milestone fieldtest finding (2026-07-11, friction; consumer POV at d3ad9f4): a bare `aura sweep … --trace` (no cost model anywhere in play) prints ``` aura: tap "net_r_equity" needs a cost model; add a cost block to the campaign document; skipped ``` The user invoked `sweep`; that verb has no cost surface, so the suggested remedy ("add a cost block to the campaign document") is unreachable from where they stand — the diagnostic leaks the internal sweep→campaign desugaring. Harmless (the sweep succeeds and the other taps persist), but the remedy misdirects. Directions: drop `net_r_equity` from the sweep-desugared default tap set, or reword the notice per invoked verb (naming a remedy reachable from `sweep`, or stating plainly that net taps are campaign-only).
Author
Owner

Decision (2026-07-11, autonomous run): fixed at the generation layer, not by rewording the executor notice.

The root: the dissolved-verb translators (sweep/walkforward --trace, verb_sugar.rs::persist_taps_from) request the full closed tap vocabulary while every generated campaign carries an empty cost section by construction — the generator knowingly orders a tap (net_r_equity) that its own document cannot produce, and the executor then apologizes with a remedy ("add a cost block to the campaign document") unreachable from the verb the user invoked.

Chosen: the generated campaign requests only the taps producible under its own configuration — net-channel taps are excluded because the generated cost section is always empty. The bare-sweep notice disappears entirely; the sweep still persists every producible tap.

Rejected: rewording the notice per invoking verb — it would thread presentation context through the executor to apologize for a request the generator knew was unproducible.

Unchanged: the authored-campaign path keeps the notice and its remedy verbatim (there the user wrote the campaign document, so the remedy is reachable; pinned by the existing cost e2e tests in crates/aura-cli/tests/research_docs.rs). Net taps remain campaign-document-only; the authoring guide already documents the cost block (§3).

Decision (2026-07-11, autonomous run): fixed at the generation layer, not by rewording the executor notice. The root: the dissolved-verb translators (sweep/walkforward `--trace`, `verb_sugar.rs::persist_taps_from`) request the full closed tap vocabulary while every generated campaign carries an empty `cost` section by construction — the generator knowingly orders a tap (`net_r_equity`) that its own document cannot produce, and the executor then apologizes with a remedy ("add a cost block to the campaign document") unreachable from the verb the user invoked. Chosen: the generated campaign requests only the taps producible under its own configuration — net-channel taps are excluded because the generated cost section is always empty. The bare-sweep notice disappears entirely; the sweep still persists every producible tap. Rejected: rewording the notice per invoking verb — it would thread presentation context through the executor to apologize for a request the generator knew was unproducible. Unchanged: the authored-campaign path keeps the notice and its remedy verbatim (there the user wrote the campaign document, so the remedy is reachable; pinned by the existing cost e2e tests in `crates/aura-cli/tests/research_docs.rs`). Net taps remain campaign-document-only; the authoring guide already documents the cost block (§3).
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Brummel/Aura#240