Expand description
Per-iteration JSONL trace emitter for the studio (issue #68).
Activated by --dump iterates:summary or --dump iterates:full
on the CLI (also accepts the legacy iterate: spelling); writes
one JSONL line per outer/restoration iteration to the persistent
iterates.jsonl stream at <dump_dir>/iterates.jsonl.
Schema is locked by the issue’s “Proposed flags” section:
{"iter":N,"alpha_pr":..,"alpha_du":..,"tag":"..",
"restoration":false,"active_mask":"<b64>",
"x_norm":..,"slack_norm_inf":..,"slack_norm_2":..}full adds "x":[..],"slack":[..]. Vectors are emitted in their
native solver coordinates: x is the primal vector and slack is
the per-constraint signed residual computed from curr_c / `curr_d
- s`.
Layered on top of DiagnosticsState::append_iterate_line, which
owns the buffered file handle.