mirror of
https://github.com/ruvnet/RuVector.git
synced 2026-05-27 08:45:07 +00:00
07cbb8d8ca
Ships the public ABIs + productized wrappers that move three of
Connectome OS's exotic applications (README Part 3) one concrete
step closer to feasible. Each is scaffolding, not a full
implementation — the production pieces (MuJoCo bridge, mouse
connectome, real FlyWire data) genuinely can't ship from this
branch — but each gives external code the typed surface to build
against today.
Three new top-level modules:
1. src/embodiment.rs — BodySimulator trait + 2 implementations
(247 LOC incl. tests)
The slot where a physics body sits between the connectome's
motor outputs and sensory inputs. Defines the per-tick ABI
(, , ) that Phase-3 MuJoCo + NeuroMechFly
will drop into. Ships two impls:
- StubBody — deterministic open-loop drive over an existing
Stimulus schedule. Preserves AC-1. This is what the
Tier-1 demo runs with.
- MujocoBody — Phase-3 panic-stub. Constructs without
panicking (so downstream code can Box<dyn BodySimulator>
against it today); panics on step/reset with an
actionable diagnostic pointing at ADR-154 §13 and
04-embodiment.md.
Unblocks application #10 — 'embodied fly navigation in VR'.
The remaining Phase-3 work is the cxx bridge + NeuroMechFly
MJCF ingest; the wiring is now waiting, not un-designed.
2. src/lesion.rs — LesionStudy + CandidateCut + LesionReport
(374 LOC incl. tests)
Productization of AC-5 σ-separation. Outside code can now
answer 'which edges are load-bearing for behaviour X?'
without copy-pasting the test internals. Paired-trial loop,
σ distance against a nominated reference cut, deterministic
across repeat runs. Includes boundary_edges() / interior_edges()
helpers so callers can build cuts from a FunctionalPartition
without re-deriving the traversal.
Unblocks application #11 — 'in-silico circuit-lesion studies'.
Also powers the audit module (next).
3. src/audit.rs — StructuralAudit + StructuralAuditReport
(235 LOC incl. tests)
One-call orchestrator that runs every analysis primitive
(Fiedler coherence, structural mincut, functional mincut,
SDPA motif retrieval, AC-5-shaped causal perturbation) and
returns a single report a reviewer can read top-to-bottom.
Auto-generates boundary-vs-interior candidate cuts when the
caller doesn't supply explicit ones. Same determinism
contract as every underlying primitive.
Unblocks application #13 — 'connectome-grounded AI safety
auditing'. The framing is 'safety auditing'; the deliverable
is a reproducible report, not a safety guarantee.
Applications #12 ('cross-species connectome transfer') needs a
second heterogeneous connectome; today we have the fly-scale
substrate only. Deferred until Tier-2 mouse data lands.
Application #14 ('substrate for structural-intelligence research
papers') was already open — it's the meta-application, no
scaffolding needed.
Lib.rs re-exports the new public types so downstream consumers
can
directly.
Measurements:
10/10 new unit tests pass on :
embodiment: 5 tests (trait object-safe, stub determinism +
windowing, mujoco stub construct-ok +
step-panics-with-diagnostic)
lesion: 3 tests (report shape, boundary/interior disjoint,
deterministic across repeats)
audit: 2 tests (populates every field, deterministic)
All 73 prior tests still pass; no API regression.
Total new LOC: 856 (247 + 374 + 235) src + tests; all files
under the 500-line ADR-154 §3.2 file budget.
Positioning rubric held. Scaffolding is scaffolding — not new
scientific claims. Every module docstring links back to the
Connectome-OS README Part 3 application it unblocks.
Co-Authored-By: claude-flow <ruv@ruv.net>
|
||
|---|---|---|
| .. | ||
| agentic-jujutsu | ||
| apify | ||
| app-clip | ||
| benchmarks | ||
| boundary-discovery | ||
| brain-boundary-discovery | ||
| climate-consciousness | ||
| cmb-boundary-discovery | ||
| cmb-consciousness | ||
| connectome-fly | ||
| data | ||
| decompiler-dashboard | ||
| delta-behavior | ||
| dna | ||
| docs | ||
| dragnes | ||
| earthquake-boundary-discovery | ||
| ecosystem-consciousness | ||
| edge | ||
| edge-full/pkg | ||
| edge-net | ||
| exo-ai-2025 | ||
| frb-boundary-discovery | ||
| gene-consciousness | ||
| google-cloud | ||
| graph | ||
| gw-consciousness | ||
| health-boundary-discovery | ||
| infrastructure-boundary-discovery | ||
| market-boundary-discovery | ||
| meta-cognition-spiking-neural-network | ||
| mincut | ||
| music-boundary-discovery | ||
| neural-trader | ||
| nodejs | ||
| onnx-embeddings | ||
| onnx-embeddings-wasm | ||
| OSpipe | ||
| pandemic-boundary-discovery | ||
| prime-radiant | ||
| pwa-loader | ||
| quantum-consciousness | ||
| real-eeg-analysis | ||
| real-eeg-multi-seizure | ||
| refrag-pipeline | ||
| robotics | ||
| rust | ||
| ruvLLM | ||
| rvf | ||
| rvf-desktop | ||
| rvf-kernel-optimized | ||
| scipix | ||
| seizure-clinical-report | ||
| seizure-therapeutic-sim | ||
| seti-boundary-discovery | ||
| seti-exotic-signals | ||
| spiking-network | ||
| subpolynomial-time | ||
| temporal-attractor-discovery | ||
| train-discoveries | ||
| ultra-low-latency-sim | ||
| verified-applications | ||
| vibecast-7sense | ||
| void-boundary-discovery | ||
| vwm-viewer | ||
| wasm/ios | ||
| wasm-react | ||
| wasm-vanilla | ||
| weather-boundary-discovery | ||
| bounded_instance_demo.rs | ||
| README.md | ||
| security_hardened.rvf | ||
RuVector Examples
Comprehensive examples demonstrating RuVector's capabilities across multiple platforms and use cases.
Directory Structure
examples/
├── rust/ # Rust SDK examples
├── nodejs/ # Node.js SDK examples
├── graph/ # Graph database features
├── wasm-react/ # React + WebAssembly integration
├── wasm-vanilla/ # Vanilla JS + WebAssembly
├── agentic-jujutsu/ # AI agent version control
├── exo-ai-2025/ # Advanced cognitive substrate
├── refrag-pipeline/ # Document processing pipeline
└── docs/ # Additional documentation
Quick Start by Platform
Rust
cd rust
cargo run --example basic_usage
cargo run --example advanced_features
cargo run --example agenticdb_demo
Node.js
cd nodejs
npm install
node basic_usage.js
node semantic_search.js
WebAssembly (React)
cd wasm-react
npm install
npm run dev
WebAssembly (Vanilla)
cd wasm-vanilla
# Open index.html in browser
Example Categories
| Category | Directory | Description |
|---|---|---|
| Core API | rust/basic_usage.rs |
Vector DB fundamentals |
| Batch Ops | rust/batch_operations.rs |
High-throughput ingestion |
| RAG Pipeline | rust/rag_pipeline.rs |
Retrieval-Augmented Generation |
| Advanced | rust/advanced_features.rs |
Hypergraphs, neural hashing |
| AgenticDB | rust/agenticdb_demo.rs |
AI agent memory system |
| GNN | rust/gnn_example.rs |
Graph Neural Networks |
| Graph | graph/ |
Cypher queries, clustering |
| Node.js | nodejs/ |
JavaScript integration |
| WASM React | wasm-react/ |
Modern React apps |
| WASM Vanilla | wasm-vanilla/ |
Browser without framework |
| Agentic Jujutsu | agentic-jujutsu/ |
Multi-agent version control |
| EXO-AI 2025 | exo-ai-2025/ |
Cognitive substrate research |
| Refrag | refrag-pipeline/ |
Document fragmentation |
Feature Highlights
Vector Database Core
- High-performance similarity search
- Multiple distance metrics (Cosine, Euclidean, Dot Product)
- Metadata filtering
- Batch operations
Advanced Features
- Hypergraph Index: Multi-entity relationships
- Temporal Hypergraph: Time-aware relationships
- Causal Memory: Cause-effect chains
- Learned Index: ML-optimized indexing
- Neural Hash: Locality-sensitive hashing
- Topological Analysis: Persistent homology
AgenticDB
- Reflexion episodes (self-critique)
- Skill library (consolidated patterns)
- Causal memory (hypergraph relationships)
- Learning sessions (RL training data)
- Vector embeddings (core storage)
EXO-AI Cognitive Substrate
- exo-core: IIT consciousness, thermodynamics
- exo-temporal: Causal memory coordination
- exo-hypergraph: Topological structures
- exo-manifold: Continuous deformation
- exo-exotic: 10 cutting-edge experiments
- exo-wasm: Browser deployment
- exo-federation: Distributed consensus
- exo-node: Native bindings
- exo-backend-classical: Classical compute
Running Benchmarks
# Rust benchmarks
cargo bench --example advanced_features
# Refrag pipeline benchmarks
cd refrag-pipeline
cargo bench
# EXO-AI benchmarks
cd exo-ai-2025
cargo bench
Related Documentation
License
MIT OR Apache-2.0