RuVector Integration Map

April 5, 2026 · View on GitHub

RVM integrates with the RuVector ecosystem via the ruvector/ submodule. This document maps RuVector components to their RVM usage.

Submodule

ruvector/    → https://github.com/ruvnet/RuVector (submodule)

Core Crates Used by RVM

RuVector CratePathRVM Usage
ruvector-mincutruvector/crates/ruvector-mincut/Partition placement, isolation decisions, coherence graph mincut
ruvector-sparsifierruvector/crates/ruvector-sparsifier/Compressed shadow graph for Laplacian operations
ruvector-solverruvector/crates/ruvector-solver/Effective resistance → coherence scores
ruvector-coherenceruvector/crates/ruvector-coherence/Spectral coherence tracking, engine backend

RVF Package Format

RVF CratePathPurpose
rvf-typesruvector/crates/rvf/rvf-types/Core RVF types: manifest, vectors, metadata
rvf-cryptoruvector/crates/rvf/rvf-crypto/Cryptographic signing and verification
rvf-manifestruvector/crates/rvf/rvf-manifest/Package manifest parsing and generation
rvf-indexruvector/crates/rvf/rvf-index/HNSW vector indexing
rvf-runtimeruvector/crates/rvf/rvf-runtime/Runtime execution environment
rvf-kernelruvector/crates/rvf/rvf-kernel/Kernel-level RVF integration
rvf-quantruvector/crates/rvf/rvf-quant/Quantization for memory reduction
rvf-wasmruvector/crates/rvf/rvf-wasm/WASM runtime for RVF containers
rvf-cliruvector/crates/rvf/rvf-cli/CLI for RVF operations
rvf-wireruvector/crates/rvf/rvf-wire/Wire protocol for RVF transfer
rvf-federationruvector/crates/rvf/rvf-federation/Federated RVF distribution
rvf-adaptersruvector/crates/rvf/rvf-adapters/Adapter layer for external formats

RuVix Kernel Primitives

ComponentPathPurpose
ruvixruvector/crates/ruvix/Kernel primitives (Task, Capability, Region, Queue, Timer, Proof)
aarch64-bootruvector/crates/ruvix/aarch64-boot/AArch64 bare-metal boot

Architecture Decision Records

ADRPathRelevance
ADR-001ruvector/docs/adr/ADR-001-ruvector-core-architecture.mdCore architecture that RVM builds upon
ADR-006ruvector/docs/adr/ADR-006-memory-management.mdMemory model informing RVM's 4-tier system
ADR-007ruvector/docs/adr/ADR-007-security-review-technical-debt.mdSecurity patterns adopted by RVM
ADR-012ruvector/docs/adr/ADR-012-security-remediation.mdSecurity remediation patterns
ADR-014ruvector/docs/adr/ADR-014-coherence-engine.mdCoherence engine design inherited by RVM
ADR-015ruvector/docs/adr/ADR-015-coherence-gated-transformer.mdGated transformer architecture

Research & Documentation

ResourcePathContent
Architecture overviewruvector/docs/architecture/System architecture documents
Benchmarksruvector/docs/benchmarks/Performance benchmark results
Analysisruvector/docs/analysis/Code and performance analysis
API docsruvector/docs/api/API reference documentation
Cloud architectureruvector/docs/cloud-architecture/Cloud deployment patterns

Quick Access

# Browse RVF crates
ls ruvector/crates/rvf/

# Browse RuVix kernel primitives
ls ruvector/crates/ruvix/crates/

# Browse mincut algorithm
ls ruvector/crates/ruvector-mincut/src/

# Read coherence ADR
cat ruvector/docs/adr/ADR-014-coherence-engine.md

# Read core architecture
cat ruvector/docs/adr/ADR-001-ruvector-core-architecture.md

Updating the Submodule

# Pull latest RuVector
cd ruvector && git pull origin main && cd ..
git add ruvector && git commit -m "chore: update ruvector submodule"