mirror of
https://github.com/ruvnet/RuVector.git
synced 2026-07-10 01:38:44 +00:00
436fb3eb11
* docs(adr): ADR-199 Sky Monitor and SkyGraph appliance Architecture decision record for the RuView SkyGraph appliance: a local sky monitoring system that treats the sky as a continuously changing spatial graph. Covers ADS-B ingestion (dump1090 + OpenSky fallback), MSC GeoMet weather, observer-frame coordinate model, canonical observation schema, SkyGraph node/edge model, RuVector embedding and novelty usage, rule layer, composite anomaly scoring, privacy and security governance, storage tiers, phased build plan, and acceptance tests. Companion implementation lands in examples/sky-monitor/. https://claude.ai/code/session_013Nh9Naw8gim75DGY9LBvK7 * feat(examples): sky-monitor SkyGraph appliance core (ADR-199 Phases 1-4) New workspace example crate implementing the RuView SkyGraph appliance pipeline on synthetic ADS-B data: - WGS-84 -> ECEF -> ENU observer-frame projection (az/el/range/bearing) - canonical observation schema (ADR-199 s11) with serde - deterministic synthetic ADS-B scenario + dump1090 JSON parser - track stitching with circular-stats summaries and overhead rule - SkyGraph on ruvector-graph GraphDB (s12 node/edge vocabulary, time-window queries, citeable explain()) - 32-dim track embeddings indexed in ruvector-core VectorDB with similarity search and calibrated novelty scoring - composite anomaly score per ADR-199 s15 with mandatory reasons - daily sky brief, end-to-end pipeline, demo binary - 27 tests (19 unit + 8 ADR acceptance), criterion benchmarks https://claude.ai/code/session_013Nh9Naw8gim75DGY9LBvK7 * feat(examples): sky-monitor WASM projection engine, canvas dashboard, perf tuning Presentation plane for the ADR-199 SkyGraph appliance (dashboard-first decision) plus measured hot-path optimizations: - feature-gate sky-monitor: default 'appliance' feature carries ruvector-core/ruvector-graph; --no-default-features yields a wasm32-compatible subset (coords, observation, adsb, track, weather, embedding, anomaly, brief) - new sky-monitor-wasm crate (wasm-bindgen): SkyProjector with single and Float64Array batch projection, polar all-sky screen mapping, AnomalyScorer sharing the exact native scorer via new TrackSummary adapter, dump1090 JSON parser binding; 5 native unit tests - canvas dashboard (ui/dashboard): polar sky plot with elevation rings, fading trails, overhead highlights, band-colored anomaly badges, track table with reasons, replay scrubber; JS projection fallback with automatic wasm-pack pkg detection; demo data generated via new --emit-json flag on the demo binary - perf: observer_frame inlined to single sin_cos per angle; track_embedding single-pass accumulation; anomaly baseline reuse Validation: 27/27 sky-monitor tests, 5/5 sky-monitor-wasm tests, wasm32-unknown-unknown builds clean for both, clippy clean, node --check on dashboard JS. https://claude.ai/code/session_013Nh9Naw8gim75DGY9LBvK7 * docs(examples): sky-monitor benchmark report and ADR-199 acceptance mapping Criterion results (baseline vs tuned): observer-frame projection -12% single / -10% batch (p<0.05), single-pass embedding -4%; anomaly/pipeline deltas attributed to the TrackSummary adapter that gives native/WASM scorer parity. Includes 1 Hz real-time headroom analysis (~129 ns/projection, ~6k tracks/s anomaly scoring, full synthetic day in ~7 ms) and the mapping of all 8 acceptance tests to ADR-199 s31/s22 criteria. 32/32 tests green across both crates. https://claude.ai/code/session_013Nh9Naw8gim75DGY9LBvK7 * fix(examples): make sky-monitor-wasm buildable offline; record WASM functional verification Disable wasm-opt in wasm-pack metadata so the dashboard pkg builds in air-gapped/appliance environments where the binaryen download is unavailable (size optimization only; documented in Cargo.toml). Verified the built module end-to-end in Node: projection geometry matches native coords (10 km north -> az 0.00, el 5.10, range 10029 m), zenith->center screen mapping, Float64Array batch projection, anomaly scorer parity through the shared TrackSummary path (night track 0.900 strong anomaly vs corridor 0.055 normal), and dump1090 JSON parsing. Recorded in BENCHMARKS.md. https://claude.ai/code/session_013Nh9Naw8gim75DGY9LBvK7 * style(examples): rustfmt sky-monitor and sky-monitor-wasm Fixes the Rustfmt CI failure on PR #549; no functional changes (32/32 tests still pass, wasm32 release build clean). https://claude.ai/code/session_013Nh9Naw8gim75DGY9LBvK7 * feat(sky-monitor): realtime-only dashboard with satellites, live §15 scoring, and SOTA pack - Dashboard rewritten realtime-only (synthetic-day replay removed): live ADS-B (airplanes.live/adsb.lol) + Open-Meteo, smoothed dead reckoning, ⚙ drawer - wasm: SatPropagator (SGP4 + pass prediction), embed_track/novelty (§13/§15), AnomalyScorer wired to live tracks with IndexedDB vector-novelty store - Sun/moon + naked-eye satellite visibility, behavior badges, CPA conflict alerts, adsbdb routes, NOAA SWPC Kp, WebGPU sat layer (fallback-safe), recorded-replay ring buffer - 13 wasm-crate tests, 10 node detector tests, Playwright-verified incl. offline Co-Authored-By: claude-flow <ruv@ruv.net> * fix(sky-monitor-wasm): clippy needless_range_loop in satellite pass prediction Enumerate the precomputed per-step sun samples instead of indexing them with the loop counter; fixes the deny-warnings Clippy CI failure on PR #549. No behavior change (13/13 wasm crate tests pass, wasm32 release build clean). https://claude.ai/code/session_013Nh9Naw8gim75DGY9LBvK7 --------- Co-authored-by: Claude <noreply@anthropic.com> Co-authored-by: ruv <ruvnet@users.noreply.github.com> Co-authored-by: ruvnet <ruvnet@gmail.com> |
||
|---|---|---|
| .. | ||
| a2a-swarm | ||
| agentic-jujutsu | ||
| apify | ||
| app-clip | ||
| benchmarks | ||
| boundary-discovery | ||
| brain-boundary-discovery | ||
| climate-consciousness | ||
| cmb-boundary-discovery | ||
| cmb-consciousness | ||
| data | ||
| decompiler-dashboard | ||
| delta-behavior | ||
| docs | ||
| dragnes | ||
| earthquake-boundary-discovery | ||
| ecosystem-consciousness | ||
| edge | ||
| edge-full/pkg | ||
| edge-net | ||
| esp32-mmwave-sensor | ||
| 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 | ||
| sky-monitor | ||
| spiking-network | ||
| subpolynomial-time | ||
| temporal-attractor-discovery | ||
| train-discoveries | ||
| ultra-low-latency-sim | ||
| vectorvroom@4c2527b452 | ||
| 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