ruvector/docs/research
rUv 137a02ee9c
research(nightly): capability-gated-ann — per-vector read access control in ANN search (#604)
* research: add nightly survey for capability-gated-ann

Selects capability-gated ANN search as 2026-06-25 nightly topic.
Three research loop passes completed: Discover, Deepen, Critique.
Topic fills the missing per-vector read access control gap in RuVector
(ADR-227 already covers proof-gated writes; this adds gated reads).

Co-Authored-By: claude-flow <ruv@ruv.net>
Claude-Session: https://claude.ai/code/session_01Gayqu5K44VptZqJLhxX1Vb

* feat: add capability-gated ANN Rust proof of concept

crates/ruvector-capgated: zero-dep Rust crate implementing three
capability-gated ANN search variants using 64-bit CapMask bitsets.

- CapMask: 64-bit bitset for capability requirements/holdings
- CapGatedIndex trait: unified API across all backends
- PostFilter: O(n) scan, 100% recall, baseline
- EagerMask: O(auth_frac*n*d), 100% recall, 7.9x speedup at 12.5% access
- CapGraph: k-NN graph walk with ef-bounded exploration, 90.6% recall
- Oracle: brute-force ground truth for recall measurement
- Deterministic LCG dataset generation (no external deps)

Co-Authored-By: claude-flow <ruv@ruv.net>
Claude-Session: https://claude.ai/code/session_01Gayqu5K44VptZqJLhxX1Vb

* test: add 22 numeric acceptance tests for capability-gated-ann

Tests cover: CapMask satisfies semantics, dist_sq correctness,
recall computation, Oracle filtering/ordering, PostFilter
filtering/ordering/k-limit, EagerMask equivalence to Oracle,
EagerMask zero-access, CapGraph authorisation enforcement,
CapGraph k-limit, CapGraph empty index, CapGraph full-access,
dataset determinism, pick_caps count/range, LCG reproducibility.

All 22 tests pass with cargo test -p ruvector-capgated.

Co-Authored-By: claude-flow <ruv@ruv.net>
Claude-Session: https://claude.ai/code/session_01Gayqu5K44VptZqJLhxX1Vb

* docs: add ADR-268 for capability-gated ANN search

ADR-268-capability-gated-ann.md covers:
- Context: gap between proof-gated writes (ADR-227) and read access control
- Decision: CapGatedIndex trait, CapMask bitset, three variants
- Benchmark evidence: PostFilter 2,023 QPS, EagerMask 17,548 QPS (low-access),
  CapGraph 3,396 QPS / 0.869 recall
- Alternatives considered: post-hoc filter, per-group index, homomorphic encryption
- Failure modes and security considerations
- Migration path into ruvector-core

Co-Authored-By: claude-flow <ruv@ruv.net>
Claude-Session: https://claude.ai/code/session_01Gayqu5K44VptZqJLhxX1Vb

* bench: capture capability-gated-ann benchmark results

Real cargo run --release numbers on x86_64 Linux, Rust 1.94.1:

High-access (37.5% authorised):
  PostFilter:  494 μs mean / 2,023 QPS / 1.000 recall
  EagerMask:   175 μs mean / 5,728 QPS / 1.000 recall  (2.8x speedup)
  CapGraph:    289 μs mean / 3,466 QPS / 0.906 recall

Low-access (12.5% authorised):
  PostFilter:  450 μs mean / 2,221 QPS / 1.000 recall
  EagerMask:    57 μs mean / 17,548 QPS / 1.000 recall  (7.9x speedup)
  CapGraph:    295 μs mean / 3,396 QPS / 0.869 recall

ACCEPTANCE RESULT: PASS -- all thresholds met.

Co-Authored-By: claude-flow <ruv@ruv.net>
Claude-Session: https://claude.ai/code/session_01Gayqu5K44VptZqJLhxX1Vb

* docs: add SEO gist for capability-gated-ann

docs/research/nightly/2026-06-25-capability-gated-ann/gist.md:
- Public-facing technical article with real benchmark numbers
- Comparison table vs Milvus, Qdrant, Weaviate, Pinecone, LanceDB,
  FAISS, pgvector, Chroma, Vespa
- 8 practical applications, 8 exotic applications
- Deep research notes with ACORN, filtered-ANN, Milvus citations
- Usage guide, optimization guide, roadmap
- SEO keywords and GitHub topic tags

Co-Authored-By: claude-flow <ruv@ruv.net>
Claude-Session: https://claude.ai/code/session_01Gayqu5K44VptZqJLhxX1Vb

* fix(ruvector-capgated): clippy + rustfmt cleanup for clean CI

Resolve the clippy warnings that were red on #604: unused VecEntry import,
needless_range_loop (dataset.rs cap-mask build), useless_vec (eager_mask),
and unusual_byte_groupings (benchmark SEED literal). Apply rustfmt.

cargo clippy -p ruvector-capgated --all-targets -- -D warnings now clean;
22/22 tests pass.

Co-Authored-By: claude-flow <ruv@ruv.net>

---------

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: ruv <ruvnet@users.noreply.github.com>
2026-06-25 14:05:34 -04: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 research(nightly): capability-gated-ann — per-vector read access control in ANN search (#604) 2026-06-25 14:05:34 -04: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 feat(ruvix): implement CLI, kernel shell, and PBFT consensus (#261) 2026-03-14 16:25:03 -04: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
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