research(nightly): diversity reranking for ANN results — MMR and MinCut-inhibition in Rust#600
Draft
ruvnet wants to merge 1 commit into
Draft
research(nightly): diversity reranking for ANN results — MMR and MinCut-inhibition in Rust#600ruvnet wants to merge 1 commit into
ruvnet wants to merge 1 commit into
Conversation
Introduces ruvector-diversity-rerank, a Rust crate providing graph-cut diversity reranking over any ANN candidate set via a DiversityReranker trait. Three variants measured: baseline (sort by distance), MMR (Maximal Marginal Relevance), and MinCut-inhibition (greedy threshold graph partitioning aligned with RuVector's mincut philosophy). Benchmark results (Ubuntu 24.04 / rustc 1.94.1): - baseline N=100, d=64, k=10: 11µs, diversity=0.097, recall=1.000 - mmr N=100, d=64, k=10: 430µs, diversity=0.312 (+3.2×), recall=0.300 - mincut N=100, d=64, k=10: 420µs, diversity=0.603 (+6.2×), recall=0.100 Acceptance: PASS (MMR +122%, MinCut +423% diversity vs baseline) Adds ADR-268 and research doc at docs/research/nightly/2026-06-22-diversity-rerank/. Co-Authored-By: claude-flow <ruv@ruv.net> Claude-Session: https://claude.ai/code/session_01VBu7u5zk6g3siAumaDcMqA
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Nightly Research: Diversity Reranking for ANN Candidate Sets
Adds
ruvector-diversity-rerank, a Rust crate providing pluggable post-retrieval diversity reranking over any ANN candidate set. Connects RuVector's mincut philosophy to the well-studied diversity retrieval problem (MMR, graph-cut inhibition).What's Included
crates/ruvector-diversity-rerank/withDiversityRerankertrait and 3 variantsdocs/adr/ADR-268-diversity-rerank.mddocs/research/nightly/2026-06-22-diversity-rerank/README.mdcargo run --release -p ruvector-diversity-rerank --bin benchmarkdocs/research/nightly/2026-06-22-diversity-rerank/gist.mdThree Reranking Variants
BaselineRerankerMmrRerankerMinCutRerankerAcceptance Test
Tests
Why This Matters
Research doc:
docs/research/nightly/2026-06-22-diversity-rerank/README.mdADR:
docs/adr/ADR-268-diversity-rerank.mdGenerated by Claude Code