pub struct Report {
pub schema: String,
pub kernel: String,
pub gate_cc: String,
pub measurement_kind: String,
pub convergence_gate: String,
pub device: Option<DeviceInfo>,
pub allow_unsafe_reason: Option<String>,
pub chosen: Option<ChosenInfo>,
pub indistinguishable_from_chosen: Vec<String>,
pub rejected_faster: Vec<RejectedFaster>,
pub candidates: Vec<CandidateReport>,
pub totals: Totals,
}Expand description
A report.v1 document: the whole run, as a reader should see it.
This is the surface every other consumer reads — the TUI, the text
renderer, and anyone parsing the JSON. Its schema is validated against
schemas/report.v1.json in CI.
Fields§
§schema: StringSchema tag; always report.v1.
kernel: StringThe kernel this run tuned.
gate_cc: StringThe compute capability the gate ran at. A verdict does not transfer
to another one (docs/LIMITATIONS.md).
measurement_kind: Stringmeasured or estimated — stamped on the report and every number
in it. Reporting an estimate as a measurement is release-blocking
(docs/LIMITATIONS.md).
convergence_gate: Stringfull when every candidate passed through the reconverge gate;
none on the Metal path (there is no MSL analyzer — §3.4). The
renderer prints the no-gate notice unconditionally when this is
none; a test asserts it cannot be omitted.
device: Option<DeviceInfo>The part measured on. Absent when nothing was measured.
allow_unsafe_reason: Option<String>The operator’s written reason for measuring refused candidates.
Present exactly when --allow-unsafe was used, so a report
containing refused timings always says why they were taken.
chosen: Option<ChosenInfo>The recommended configuration. Absent when nothing was both admitted and measured — a gate-only run, or one whose whole admitted set failed to measure.
indistinguishable_from_chosen: Vec<String>IDs whose intervals overlap the chosen one: reported as indistinguishable, never ranked (docs/BENCHMARKING.md).
rejected_faster: Vec<RejectedFaster>THE section: refused configurations that measurably beat the chosen one (their CI is entirely below the chosen CI).
candidates: Vec<CandidateReport>Every candidate, admitted or not, measured or not.
totals: TotalsRun-level tallies.