Skip to content

Add a blind, noise-calibrated retrieval eval harness#548

Closed
tobocop2 wants to merge 1 commit into
mainfrom
feat/retrieval-eval-harness
Closed

Add a blind, noise-calibrated retrieval eval harness#548
tobocop2 wants to merge 1 commit into
mainfrom
feat/retrieval-eval-harness

Conversation

@tobocop2

Copy link
Copy Markdown
Owner

Problem

Retrieval quality changes have been graded by an ad-hoc kit living outside the repo, so every tuning decision starts from scratch and nothing gates regressions.

Solution

evals/retrieval (repo-level, never shipped in the wheel) generates a question battery from any indexed library: topical questions from reservoir-sampled passages, known-item questions from sampled documents, and count questions with exact streaming-scan oracles. It answers the battery against two lilbee servers over the same index with per-row checkpointing so killed pod runs resume, judges answers blind under opaque ids with one arm duplicated to measure the judge's noise floor, and scores mechanically: per-dimension means with the noise floor as the error bar plus exact pass/fail for counts and document lookups. Streaming scans keep memory flat on very large libraries. Lint and format gates now cover the directory.

Retrieval tuning has been graded by an ad-hoc kit living outside the repo;
every future change needs a versioned gate. evals/retrieval generates a
question battery from any indexed library (topical questions from sampled
passages, known-item questions from sampled documents, count questions
with exact streaming-scan oracles), answers it against two lilbee servers
over the same index with per-row checkpointing, judges answers blind under
opaque ids with one arm duplicated to measure the judge's noise floor, and
scores mechanically: per-dimension means with the noise floor as the error
bar plus exact pass/fail for counts and document lookups. Streaming scans
and reservoir sampling keep memory flat on very large libraries. Lives
outside src/ so it never ships in the package; lint and format gates cover
it.

bb-yjbr
@tobocop2

Copy link
Copy Markdown
Owner Author

Superseded by the consolidated retrieval PR #557 — review and merge there. Converted to draft to keep it off the review queue; the branch and history stay intact for reference.

@tobocop2

Copy link
Copy Markdown
Owner Author

Superseded by the consolidated retrieval PR #557, which contains this change. Closing; the branch stays intact for reference.

@tobocop2 tobocop2 closed this Jul 18, 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