Files
ely-eye/bench/reports/TERMS.md
T
ZacharyZhang-NY c4a8c36416 Put the scale evidence in the repo and say plainly what still misses
Every number in CHECKLIST p2-1 and p0-3.7 came out of a scratch script: the
kind of artifact a reader cannot re-run, and the kind that quietly drifts
away from the code it describes. These reports are generated by committed
harnesses and each one stamps the commit that carries the code it measures.

DENSE.md  165,973 atoms / 153,857 vectors: build 1421.0s, search p50 75.6ms
          p95 93.0ms, 0.998 agreement with a brute-force scan, one write into
          a full index p50 518ms, 1,729 bytes per stored vector.
QUANT.md  twelve encodings measured on the same vectors: int8 keeps 0.977 of
          the ranking for a quarter of the bytes and no speed, bit is 14x
          faster and keeps 0.728, so bit is a coarse filter and nothing more.
TERMS.md  the stop-word bound swept, not guessed: 0.05 is the measured peak
          (recall@10 0.803 at p50 69.5ms) and also the fastest of the rows
          that keep recall.
SCALE.md  the product's own search at 165,973 atoms: p50 71.7ms against the
          frozen baseline's 20.16s.
LEGS.md   what each retrieval leg is worth, per modality, with the page size
          the product actually asks for in the table.

The acceptance bar the operator set is recall@10 >= 0.90 at n>=300. It is
not met. The best measured row is 0.858 (dense leg on, page widened to 30,
p50 414ms); the shipped configuration gives 0.848 at p50 72.5ms; the
in-repo counterpart at holder scope gives 0.866. The shortfall is
concentrated in picture golds (video 0.583-0.708, ui_screenshot 0.500-0.583,
image 0.750) while the word-shaped ones already pass (code 0.953, pdf 0.919).
Latency passes by three hundred fold; recall does not, and the gap is four
points of cross-modal retrieval, not index scale.
2026-10-08 17:01:20 -04:00

21 lines
1.4 KiB
Markdown

# TERMS: which query words are worth paying for
- commit: `dff5977ab638896cc8685c78ee41e5195fc0fbf2`
- store: bench/runs/term_sweep/data/ely_eye.sqlite (copied from the frozen baseline in 5.1s)
- 173 answerable probes, each asked as the holder the frozen set assigns it, ranked by the unmodified `RetrievalService`
- the bound the product ships is 0.05; the measured recall peak sits at 0.05
- machine: Linux 6.18.40.1-microsoft-standard-WSL2, 32 cores, 4 threads per query, load [2.32, 3.87, 8.09]
| bound | recall@10 | MRR | hit@10 | p50 ms | p95 ms | median distinct sources |
| --- | --- | --- | --- | --- | --- | --- |
| 0.200 | 0.792 | 0.629 | 0.792 | 420.3 | 1704.1 | 6 |
| 0.100 | 0.792 | 0.632 | 0.792 | 467.5 | 1747.5 | 6 |
| 0.050 **(shipped)** | 0.803 | 0.652 | 0.803 | 69.5 | 131.5 | 5 |
| 0.020 | 0.792 | 0.631 | 0.792 | 33.4 | 88.4 | 4 |
| 0.010 | 0.775 | 0.617 | 0.775 | 19.2 | 63.0 | 4 |
| 0.005 | 0.740 | 0.563 | 0.740 | 10.8 | 69.9 | 3 |
The bound is a share of the library: a word carried by more atoms than that is dropped from the OR query, because bm25 scores every row the query touches. It is relative to the corpus on purpose — a corpus of PDFs and a corpus of shell history disagree about which of their own words are noise.
_Latency is wall time per search on the machine named above with the thread budget the benchmark pins; a run on a loaded machine is not comparable._