Skip to content

research(nightly): coherence-gated multi-tenant vector namespace router#545

Draft
ruvnet wants to merge 4 commits into
mainfrom
research/nightly/2026-06-07-coherence-namespace-router
Draft

research(nightly): coherence-gated multi-tenant vector namespace router#545
ruvnet wants to merge 4 commits into
mainfrom
research/nightly/2026-06-07-coherence-namespace-router

Conversation

@ruvnet

@ruvnet ruvnet commented Jun 7, 2026

Copy link
Copy Markdown
Owner

Nightly RuVector Research — 2026-06-07

coherence-gated-namespace-router

Adds the retrieval-layer isolation primitive that multi-agent RuVector deployments need: a multi-tenant vector namespace router with three variants of increasing semantic awareness, a coherence-based federation gate, and a tamper-evident witness log for cross-boundary access events.


What's included

  1. Working Rust PoCcrates/ruvector-namespace-router

    • FlatIsolated: strict per-namespace linear scan (zero cross-namespace visibility)
    • CentroidRouted: centroid-pruned namespace selection with configurable probe depth
    • CoherenceGated: coherence threshold τ gates cross-namespace results + WitnessLog audit
    • 16 unit tests, all green
    • Benchmark binary (namespace-bench)
  2. ADRdocs/adr/ADR-196-coherence-namespace-router.md

  3. Research documentdocs/research/nightly/2026-06-07-coherence-namespace-router/README.md

  4. SEO gistdocs/research/nightly/2026-06-07-coherence-namespace-router/gist.md


Real benchmark results

All numbers from cargo run --release -p ruvector-namespace-router, Intel Celeron N4020, x86-64, Linux 6.18.5, rustc 1.94.1. N=4,000 (8 namespaces × 500 vectors), D=128, 1,600 queries, K=10.

Variant Insert (vecs/s) Mean (µs) p50 (µs) p95 (µs) Recall@10 Memory (KB)
FlatIsolated 3,037,157 78.79 76.17 96.19 1.000 2,031.2
CentroidRouted 5,222,566 81.05 78.08 98.40 1.000 2,035.2
CoherenceGated 3,045,712 84.99 81.45 105.08 1.000 2,035.2

ACCEPTANCE: PASS — all variants recall@10 ≥ 0.99

CoherenceGated adds ~7.8% latency overhead over FlatIsolated for coherence computation + witness log infrastructure.


Ecosystem connections

  • RuVector vector search (core linear scan all variants)
  • ruvector-mincut (namespace boundaries from graph partitions)
  • RVF portable format (namespace = RVF domain)
  • ruFlo workflows (each stage gets a namespace, τ adjustable per stage pair)
  • MCP tools (namespace ID maps to MCP resource URI)
  • Proof-gated writes (WitnessLog feeds into the verified-write chain)
  • Edge/WASM (FlatIsolated has no runtime deps, WASM32-compatible)

Research doc: docs/research/nightly/2026-06-07-coherence-namespace-router/README.md
ADR: docs/adr/ADR-196-coherence-namespace-router.md
Gist: docs/research/nightly/2026-06-07-coherence-namespace-router/gist.md


Generated by Claude Code

claude added 4 commits June 7, 2026 07:23
Introduces crates/ruvector-namespace-router with three variants:
FlatIsolated (strict per-namespace scan), CentroidRouted (centroid
pruning with configurable probe), CoherenceGated (coherence threshold
gating with WitnessLog audit). All 16 tests pass; recall@10=1.000 for
all variants on N=4,000 D=128 benchmark.
Documents the NamespaceIndex trait design, three variant trade-offs,
benchmark evidence, failure modes, security considerations, and
migration path. Status: accepted.
…ace-router

Research doc covers 2026 SOTA multi-tenant vector isolation survey,
10-20 year forward thesis, full benchmark methodology, real measured
results, practical and exotic applications, and production hardening
roadmap. Gist includes comparison table against Milvus, Qdrant,
Weaviate, Pinecone, LanceDB, FAISS, pgvector, Chroma, Vespa.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants