docs: Add EXO-AI 2025 cognitive substrate research

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

examples/docs/README.md

@@ -0,0 +1,34 @@
+# RuVector Documentation
+
+Additional documentation and usage guides.
+
+## Contents
+
+| File | Description |
+|------|-------------|
+| `graph-cli-usage.md` | Command-line interface for graph operations |
+| `graph_wasm_usage.html` | Interactive WASM graph demo |
+
+## Graph CLI
+
+The graph CLI provides command-line access to RuVector's graph features:
+
+```bash
+ruvector-graph --help
+ruvector-graph query "MATCH (n) RETURN n LIMIT 10"
+ruvector-graph import data.json
+ruvector-graph export output.json
+```
+
+See [graph-cli-usage.md](graph-cli-usage.md) for full documentation.
+
+## WASM Demo
+
+Open `graph_wasm_usage.html` in a browser to see an interactive demonstration of RuVector's WebAssembly graph capabilities.
+
+## Additional Resources
+
+- [Main Examples README](../README.md)
+- [Rust Examples](../rust/README.md)
+- [Node.js Examples](../nodejs/README.md)
+- [React + WASM](../wasm-react/README.md)