State cost and risk knob units in campaign introspect and docs #265

Closed
opened 2026-07-13 18:06:14 +02:00 by claude · 0 comments
Collaborator

aura campaign introspect --unwired names the cost and risk slots without units or semantics. Two knobs are silently misreadable:

  • constant.cost_per_trade is a price-unit numerator charged as cost / |entry − stop| in R. This is currently stated only in aura run --help under the r-sma-only cost flags — a different verb than the one a campaign author uses. The natural misreading (a cost in R) is wrong by orders of magnitude and produces no error.
  • vol{length, k}: stop = k · Sqrt(EMA(Δ², length)) over m1 cycles — length smooths the estimator, k scales the distance. Stated nowhere outside crates/aura-std/src/stop_rule.rs; the natural misreading (length as the stop's timescale) changes an experiment's meaning without an error.

A one-line unit/semantics annotation per knob in the campaign introspect output, mirrored in the glossary cost-model and risk-regime entries, removes both.

`aura campaign introspect --unwired` names the `cost` and `risk` slots without units or semantics. Two knobs are silently misreadable: - `constant.cost_per_trade` is a price-unit numerator charged as `cost / |entry − stop|` in R. This is currently stated only in `aura run --help` under the r-sma-only cost flags — a different verb than the one a campaign author uses. The natural misreading (a cost in R) is wrong by orders of magnitude and produces no error. - `vol{length, k}`: `stop = k · Sqrt(EMA(Δ², length))` over m1 cycles — `length` smooths the estimator, `k` scales the distance. Stated nowhere outside `crates/aura-std/src/stop_rule.rs`; the natural misreading (`length` as the stop's timescale) changes an experiment's meaning without an error. A one-line unit/semantics annotation per knob in the `campaign introspect` output, mirrored in the glossary cost-model and risk-regime entries, removes both.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Brummel/Aura#265