Module history 

2026-09-26: Run history: RunRecords written by save and read by load, load_all and find, under the artifact store’s runs/<benchmark> directory. A record built by RunRecord::new carries every parameter, the target, the source and the engine version beside the terminal frame. The headless driver and the TUI both save through save.

Owner: bench. Invariants:

• save never overwrites another run: it claims a fresh run-<nanos>.json with create_new, and the finished record replaces only its own claim, by rename.
• The readers skip files they cannot read or parse.

Structs

RunRecord

2026-09-26: One finished run, as stored. Only benchmark_id, recorded_at and frame are required and every other field defaults, so a bare BenchmarkResult (no frame key) never parses as a record.

Enums

RunSource

2026-09-26: Where a run was started from.

Constants

SCHEMA

2026-09-26: Current record schema. 0 marks a bare-frame file read through from_legacy, or a record with no schema field.

Functions

find

2026-09-26: One run by its run_id, across every registered benchmark.

load

2026-09-26: Every run for one benchmark, newest first. A file that cannot be read or parsed is skipped; a directory that cannot be created or read gives an empty list.

load_all

2026-09-26: Every run for every registered benchmark, newest first across all of them.

save

2026-09-26: Write record, setting its run_id to the file stem chosen, and return the path.