Log in

Commit c44c9111

c44c91118a6c

Merged on mrmrs-d5ae98
mrmrs · 1 month ago · 1 file ~1 modified
M suites/scale/README.md
@@ -76,6 +76,13 @@
7676 switch.back, branch.create, branch.list, gc, review.branch_diff, file.show.
7777 Each op cites the git t/perf script names it corresponds to (names only).
7878
79+Committed-state oracles never trust the subject: git's are read with the
80+oracle's own `git cat-file`; Oak's with the independent stdlib reader
81+(`scripts/oakbench/oak_sqlite_reader.py`, `committed_payloads`). When the
82+reader cannot decode a store (its size bound, or the storage format written by
83+`oak maintenance compact`, which the reader does not support yet) the oracle is
84+recorded as unmeasured (`oracle_ok: null`, `reader_unavailable`), never passed.
85+
7986 Only `ctx.timed(...)` calls are measured. Setup (dirty shapes, sync-client
8087 commits, branch switches for Oak's merge preview) and every oracle run
8188 outside the timed path. Oracles compare against facts read from the fixture