Skip to content

Default index-leaf lookahead on; simplify docs#44

Merged
russellromney merged 1 commit into
mainfrom
readme-simplify-lookahead
Jun 15, 2026
Merged

Default index-leaf lookahead on; simplify docs#44
russellromney merged 1 commit into
mainfrom
readme-simplify-lookahead

Conversation

@russellromney

Copy link
Copy Markdown
Owner

The scope fix (#43) made lookahead byte-identical to off for scans, point-by-rowid reads, and warm queries — it only engages for indexed SEARCH into a table. With the harm gone and the wins measured, flip the default on.

  • config.rs: lookahead defaults to true.
  • README: shortened the design note; replaced the stale "default-off, can hurt scans" tuning text with an Index-leaf lookahead section (on by default; only the fully-warm CPU-bound case is a reason to disable).
  • CHANGELOG: Ranger entry.

Full lib suite (587) + config_set_per_handle (6) green with default-on.

🤖 Generated with Claude Code

The scope fix (PR #43) made lookahead byte-identical to off for scans,
point-by-rowid reads, and warm queries -- it only engages for indexed
SEARCH into a table. With the harm gone and the wins measured (index->
table joins ~20-32% faster cold, fan-out reads up to ~46% lower p90 and
~19% fewer bytes, scans unchanged), flip the default to on.

- config: lookahead defaults to true; doc comment updated.
- README design note: shortened.
- README tuning: replace the stale 'default-off, can hurt scans' guidance
  with an Index-leaf lookahead section -- on by default, only the
  fully-warm CPU-bound case is a reason to disable it.
- CHANGELOG: Ranger entry.

Full lib suite + config_set_per_handle green with default-on.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@russellromney russellromney merged commit 6af72cf into main Jun 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant