ruvector/docs/research
rUv a4f9991d9d
feat: add k-scoped adaptive ANN calibration (#718)
* research: add nightly survey for adaptive-recall-ann

Identifies adaptive recall-targeted ANN as the 2026-07-23 nightly topic.
Connects vector search, agent memory, edge AI, MCP tool latency SLAs,
and ruFlo workflow recall budgets. No prior nightly covered this angle.

* feat: add ruvector-adaptive-ann Rust proof of concept

Implements RecallTargetedSearch trait with three variants:
- FixedEfSearch (baseline): constant ef=64, ignore recall target
- BinarySearchCalibrated: binary-search ef per query with ground truth
- TableCalibratedSearch: O(1) ef lookup from offline calibration table

Core insight: calibration queries must match production query distribution.
CalibrationTable is a monotone ef→recall mapping from 50-100 held-out queries.

Benchmark: N=3000×D=64, recall_target=0.90
- FixedEf(64): 0.778 recall, 9,497 QPS (misses target)
- BinarySearch: 0.902 recall, 738 QPS (oracle, 13x slower)
- TableCalibrated: 0.940 recall, 4,390 QPS (exceeds target, O(1) ef)

* test: add 7 integration tests for ruvector-adaptive-ann

- beam search at ef=N achieves near-perfect recall
- recall is monotone in ef
- FixedEf(128) achieves minimum recall threshold
- CalibrationTable returns valid ef
- TableCalibratedSearch achieves recall within distribution-mismatch tolerance
- BinarySearchCalibrated achieves per-query target on 12/15 queries
- effective_ef_for_target returns Some for Table, None for Fixed

All 7 tests pass.

* docs: add ADR-272 for adaptive-recall-ann

Documents the calibration table approach, distribution matching constraint,
three implementation variants, benchmark evidence, failure modes, security
considerations, and migration path for adopting recall-targeted search.

ADR-272 status: Proposed.

* bench: capture adaptive-recall-ann benchmark results

cargo run --release -p ruvector-adaptive-ann --bin benchmark
x86_64 Linux, release build, N=3000 D=64 300 queries

FixedEf(64): recall=0.778, mean=105.3µs, QPS=9497
BinarySearch: recall=0.902, mean=1355µs, QPS=738
TableCalibrated: recall=0.940, mean=227.8µs, QPS=4390
All acceptance tests PASSED.

* fix adaptive ANN calibration scope

---------

Co-authored-by: Claude <noreply@anthropic.com>
2026-07-27 09:57:49 -07:00
..
agentic-robotics feat: Add unified ruvector-robotics crate with bridge, perception, cognitive, and MCP modules 2026-02-27 03:35:54 +00:00
claude-code-rvsource fix: 9-issue cleanup batch + regression-guard CI workflow (#466) 2026-05-16 12:14:49 -04:00
climate-consciousness feat(examples): gene, climate, ecosystem, quantum consciousness explorers 2026-03-31 22:01:55 +00:00
cnn feat(ruvector-cnn): CNN contrastive learning + SIMD optimization fixes (#252) 2026-03-11 17:41:53 -04:00
cognitive-frontier feat(ruvix): implement CLI, kernel shell, and PBFT consensus (#261) 2026-03-14 16:25:03 -04:00
DrAgnes feat: DrAgnes + Common Crawl WET + Gemini grounding agents (#282) 2026-03-23 10:12:50 -04:00
dspy feat(ruvix): implement CLI, kernel shell, and PBFT consensus (#261) 2026-03-14 16:25:03 -04:00
exotic-structure-discovery research(boundary-first): 17 experiments proving boundary-first detection across 11 domains (#347) 2026-04-13 12:01:47 -04:00
FalkorDB Add developer quickstart guide and knowledge export JSON 2026-02-27 03:41:13 +00:00
federated-rvf Add developer quickstart guide and knowledge export JSON 2026-02-27 03:41:13 +00:00
gene-consciousness feat(examples): gene, climate, ecosystem, quantum consciousness explorers 2026-03-31 22:01:55 +00:00
gnn-v2 feat(ruvix): implement CLI, kernel shell, and PBFT consensus (#261) 2026-03-14 16:25:03 -04:00
knowledge-export Add developer quickstart guide and knowledge export JSON 2026-02-27 03:41:13 +00:00
latent-space fix(brain): defer sparsifier build on startup for large graphs 2026-03-24 12:29:52 +00:00
miller-rabin-optimizations docs(adr): ADR-151 + PRD §6 — Phase 0 findings, revised perf targets, Grok review 2026-04-16 14:41:02 -04:00
mincut fix(brain): defer sparsifier build on startup for large graphs 2026-03-24 12:29:52 +00:00
models feat(ruvix): implement CLI, kernel shell, and PBFT consensus (#261) 2026-03-14 16:25:03 -04:00
nightly feat: add k-scoped adaptive ANN calibration (#718) 2026-07-27 09:57:49 -07:00
pglite feat(ruvix): implement CLI, kernel shell, and PBFT consensus (#261) 2026-03-14 16:25:03 -04:00
photonlayer feat(photonlayer): optical simulation core — field, FFT, propagation, detector, receipts (ADR-260 Phase 1) (#587) 2026-06-18 23:22:42 -04:00
pi-brain feat(ruvix): implement CLI, kernel shell, and PBFT consensus (#261) 2026-03-14 16:25:03 -04:00
quantization-edge research(kv-cache): TriAttention + TurboQuant stacked compression analysis (#342) 2026-04-08 13:29:16 -05:00
quantum-crypto fix: harden MCP, native HNSW gates, and ruvector 0.2.37 (#724) 2026-07-27 09:10:04 -07:00
ruLake feat(rulake): vector-native federation intermediary — ADR-155 + MVP crate 2026-04-23 18:38:49 -04:00
ruvllm chore: gitignore .claude/worktrees + commit ruvllm research docs 2026-04-25 17:21:54 -04:00
ruvm feat(rvm): RVM — Coherence-Native Microhypervisor for the Agentic Age 2026-04-04 12:10:19 -04:00
rv2 feat(rvAgent): Complete DeepAgents Rust Conversion (ADR-093 → ADR-103) (#262) 2026-03-16 09:52:32 -04:00
rvagent-gemini-grounding feat: DrAgnes + Common Crawl WET + Gemini grounding agents (#282) 2026-03-23 10:12:50 -04:00
rvf feat(rvf): add WASM_SEG (0x10) for self-bootstrapping RVF files 2026-02-15 15:36:34 +00:00
seizure-prediction research(boundary-first): 17 experiments proving boundary-first detection across 11 domains (#347) 2026-04-13 12:01:47 -04:00
sota-gap-implementation Add SOTA gap implementations: hybrid search, MLA, KV-cache, SSM, Graph RAG (#304) 2026-03-27 10:12:48 -04:00
sparql fix(brain): defer sparsifier build on startup for large graphs 2026-03-24 12:29:52 +00:00
spectral-sparsification feat: add ruvector-sparsifier — dynamic spectral graph sparsification 2026-03-20 10:37:39 -04:00
sublinear-time-solver fix(brain): defer sparsifier build on startup for large graphs 2026-03-24 12:29:52 +00:00
wasm-integration-2026 docs: add WASM integration research series (6 documents, 3465 lines) 2026-02-22 21:18:46 +00:00
ruvector-sota-security-review-2026-07.md fix: harden MCP, native HNSW gates, and ruvector 0.2.37 (#724) 2026-07-27 09:10:04 -07:00
sota-gap-analysis-2026.md Add SOTA gap implementations: hybrid search, MLA, KV-cache, SSM, Graph RAG (#304) 2026-03-27 10:12:48 -04:00