joaoh82 / rust_sqlite / 25285618732
69%

DEFAULT BRANCH: main
Ran
Jobs 1
Files 45
Run time 1min
Badge
Embed ▾
README BADGES
x

If you need to use a raster PNG badge, change the '.svg' to '.png' in the link

Markdown

Textile

RDoc

HTML

Rst
coverage: 59.771%. Remained the same
25285618732

push

github

web-flow 
feat(fts): 8d — hybrid retrieval worked example (BM25 + vector) (#81)

Phase 8 sub-phase 8d per docs/phase-8-plan.md. Ships a self-contained
example showing how to compose Phase 8b's bm25_score with Phase 7d's
vec_distance_cosine via raw arithmetic (Q8) for hybrid lexical +
semantic retrieval. No new engine code — the SQL works out of the
box once 8b lands.

New:

- examples/hybrid-retrieval/hybrid_retrieval.rs — 6-doc tech-blurb
  corpus with hand-baked 4-dim embeddings (no embedding-model
  dependency), runs three rankings on the same query: pure BM25,
  pure vector cosine, and 50/50 hybrid via
  `0.5 * bm25_score + 0.5 * (1.0 - vec_distance_cosine)`. Picks the
  expected docs by inspection so the example stays reproducible
  forever (no flaky neural-net results).
- examples/hybrid-retrieval/README.md — narrative explaining when
  each ranking shape wins, the cosine-distance-vs-similarity gotcha,
  the WHERE-fts_match-pre-filter caveat, weight-tuning sketches, and
  a production checklist (BM25 normalization, real embeddings,
  cross-encoder re-rank).
- Cargo.toml — registers the example; runs via
  `cargo run --example hybrid-retrieval`.
- examples/README.md — top-level table picks up the new sample.

Out of scope (later sub-phases):
- MCP bm25_search tool                    → 8e
- Docs sweep (fts.md, file-format.md, …)  → 8f

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

6380 of 10674 relevant lines covered (59.77%)

1.17 hits per line

Jobs
ID Job ID Ran Files Coverage
1 25285618732.1 45
59.77
 GitHub Action Run
Source Files on build 25285618732