Commit a0eff6e
perf: revert the tuning experiment and record the negative result
The D-047 amortization change is reverted: it is measurably correct and
does what it was designed to do, but it does not earn its place.
Component microbenchmarks (5 repetitions, medians) showed the predicted
mechanism clearly: FastBook add at an existing level 42.37 to 27.03 ns,
add creating a level 50.84 to 43.09 ns, delete 18.07 to 14.57 ns.
Paired alternating full-file replays told a different story at scale:
about 4.5 percent faster at 50 million frames, but medians within about
1 percent with overlapping distributions at 100 million frames, the
scope closest to the real working set. Peak anonymous footprint rose
about 14 percent, from 243 to 276 MiB over the same scope, exactly the
regression the hypothesis predicted. Sparser tables span more cache
lines, so the locality cost appears to cancel the rehash saving while
the memory cost stays.
The acceptance rule written before the experiment required improvement
beyond run-to-run noise with no memory regression, and neither holds, so
the change is reverted and D-048 records the full evidence. Correctness
was green throughout, including the 100-million-message dual-engine
validation. The tuned full-protocol run is preserved as
bench/results/2026-07-26-tuned-experiment.json; it cannot decide the
question because its own controls (the book-free framing scan and the
unchanged MapBook) moved more than the effect under test.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>1 parent dfa1ed2 commit a0eff6e
7 files changed
Lines changed: 1707 additions & 55 deletions
File tree
- bench/results
- docs
- include/nanobook
- tests
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
| 21 | + | |
| 22 | + | |
| 23 | + | |
| 24 | + | |
| 25 | + | |
| 26 | + | |
| 27 | + | |
| 28 | + | |
| 29 | + | |
| 30 | + | |
| 31 | + | |
| 32 | + | |
| 33 | + | |
| 34 | + | |
| 35 | + | |
| 36 | + | |
| 37 | + | |
| 38 | + | |
| 39 | + | |
| 40 | + | |
| 41 | + | |
| 42 | + | |
| 43 | + | |
| 44 | + | |
| 45 | + | |
| 46 | + | |
| 47 | + | |
| 48 | + | |
| 49 | + | |
| 50 | + | |
| 51 | + | |
| 52 | + | |
0 commit comments