ruvnet / ruvnet/RuVector

Verify + land #542 PQ/IVFADC within-list pruning (BET5, ADR-206) — scale-gated WIN finding

Open
#586 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Rust
Stars
4.5k
Forks
603
Avg merge
23h 32m
Merged PRs (30d)
59

Description

Verify #542 — PQ/IVFADC within-list pruning (BET5, scale-gated WIN, ADR-206)

Assessment: like #537, #542 arrived as a complete, pre-registered research artifact — not a nightly PoC needing a 6-step build-out.

  • Implement — self-contained benchmark crate ruvector-bet4-ivf-bench (data/kernel/pq/pca/oracle + IVF/PQ pruning sweeps). By design it does not change shipping code — it establishes the finding.
  • Test — pre-registered, frozen WIN gates: tests/pq_gate.rs (3) + tests/oracle_gate.rs (3).
  • Benchmark / finding — ADR-206: PQ/IVFADC within-list pruning is a scale-gated WIN over tuned plain IVF nprobe (wins at scale; the cluster-level bound was a NO-GO in ADR-205/#540, redundant with nprobe).
  • Rigordocs/plans/bet5-ivf-pq/PRE-REGISTRATION.md frozen before any run.
Loop verification (this issue)
  • Merged PR #542 onto current main (resolved a Cargo.toml members conflict).
  • cargo test -p ruvector-bet4-ivf-bench6/6 gate tests pass.
Recommendation

Land #542 as the documented finding (benchmark crate + ADR-206). The genuine productionization follow-up — wiring PQ within-list pruning into the production IVF index with a scale-gated runtime switch — is a substantial separate effort the finding sets up but does not itself do (correctly, per its scope). Not a 5-minute step; flagged as the real next work.

Source: #542 · ADR-206 · SepRAG #534. Loop job 05bbd4fb.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the self-contained ruvector-bet4-ivf-bench crate and read docs/plans/bet5-ivf-pq/PRE-REGISTRATION.md, then run cargo test -p ruvector-bet4-ivf-bench. Check tests/pq_gate.rs and tests/oracle_gate.rs, and confirm ADR-206 records the scale-gated finding as the completed outcome.

Written by the indexing model from the issue text.

Assessment

Tech stack
rust
Domain
documentation, performance, testing
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
20/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.