Merge commit 'd803bfe2b1fe7f5e219e50ac20d6801a0a58ac75' as 'vendor/ruvector'

2026-02-28 14:39:40 -05:00
parent 7885bf6278 d803bfe2b1
commit cd5943df23
7854 changed files with 3522914 additions and 0 deletions
--- a/vendor/ruvector/examples/README.md
+++ b/vendor/ruvector/examples/README.md
@@ -0,0 +1,132 @@
+# 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
+
+```bash
+cd rust
+cargo run --example basic_usage
+cargo run --example advanced_features
+cargo run --example agenticdb_demo
+```
+
+### Node.js
+
+```bash
+cd nodejs
+npm install
+node basic_usage.js
+node semantic_search.js
+```
+
+### WebAssembly (React)
+
+```bash
+cd wasm-react
+npm install
+npm run dev
+```
+
+### WebAssembly (Vanilla)
+
+```bash
+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
+
+```bash
+# 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
+
+- [Graph CLI Usage](docs/graph-cli-usage.md)
+- [Graph WASM Usage](docs/graph_wasm_usage.html)
+- [Agentic Jujutsu](agentic-jujutsu/README.md)
+- [Refrag Pipeline](refrag-pipeline/README.md)
+- [EXO-AI 2025](exo-ai-2025/README.md)
+
+## License
+
+MIT OR Apache-2.0