vrr/ruvector
2
0
Fork 0
mirror of https://github.com/ruvnet/RuVector.git synced 2026-06-01 23:00:37 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 1
1711 commits 186 branches 49 tags 603 MiB
Commit graph

102 commits

Author SHA1 Message Date
rUv
df367267d6 docs: improve README section headings for consistency and clarity 2026-02-27 03:44:33 +00:00
rUv
b61ed0105d docs: update README formatting for improved readability 2026-02-27 03:43:18 +00:00
rUv
b1d491b107 Add developer quickstart guide and knowledge export JSON 
- Introduced QUICKSTART.md for RuVector, detailing setup, usage, and architecture.
- Added ruvector-knowledge.rvf.json for comprehensive project metadata, including architecture overview, crate taxonomy, and critical decisions.
 2026-02-27 03:41:13 +00:00
rUv
55d7dbb6fd docs: optimize 12 crate READMEs and add SONA learning loop diagram 
Standardize all linked crate READMEs to match root README style:
plain-language taglines, comparison tables, key features tables.
Add SONA feedback loop diagram to root README intro.

Crates updated: ruvector-gnn, ruvector-core, ruvector-graph,
ruvector-graph-transformer, sona, ruvector-attention, ruvllm,
ruvector-solver, ruvector-replication, ruvector-postgres,
rvf-crypto, examples/dna.

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-02-27 03:38:42 +00:00
rUv
bae1e02152 docs: README overhaul — section headlines, comparison table, plain language 
- Add headlines and descriptions to Comparison, Features, Deployment,
  Performance, Compression, Use Cases, and Installation sections
- Rewrite comparison table: categorized rows (Self-Learning, Graph,
  AI & Compute, Database, Operations), linked crate names, technical
  and exotic capabilities (genomics, quantum, graph transformers)
- Improve intro paragraph — mention self-learning, PostgreSQL, local AI
- Remove redundant capability blocks merged into comparison table

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-02-27 03:33:00 +00:00
rUv
5b6e87d97a docs: improve README readability — PostgreSQL early mention, section reorder 
- Mention PostgreSQL extension (230+ SQL functions) in the opening summary
- Add "Already use PostgreSQL?" callout with links to extension and docs
- Rewrite analogy with labeled components for clarity
- Simplify RVF cognitive container description in plain language
- Move "How the GNN Works" above Quick Start
- Move "Ecosystem" section below Quick Start

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-02-27 03:24:11 +00:00
rUv
ee1a5927fe docs: fix stale counts in root README 
- RVF examples: 46 → 56 (10 new examples added)
- Attention mechanisms: normalize all references to 46 (was inconsistently 40/46)
- RVF Rust crates: 13 → 22 (added rvf-wasm, rvf-solver-wasm, rvf-node, 6 adapters)

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-02-26 16:13:48 +00:00
rUv
4b79444bf5 feat: proof-gated graph transformer with 8 verified modules 
Add ruvector-graph-transformer crate with 8 feature-gated modules,
each backed by an Architecture Decision Record (ADR-046 through ADR-055):

- Proof-gated mutation: ProofGate<T>, MutationLedger, ProofScope, EpochBoundary
- Sublinear attention: O(n log n) via LSH buckets, PPR sampling, spectral sparsification
- Physics-informed: Hamiltonian dynamics, gauge equivariant MP, Lagrangian attention
- Biological: Spiking networks, Hebbian/STDP learning, dendritic branching
- Self-organizing: Morphogenetic fields, developmental programs, graph coarsening
- Verified training: Certificates, delta-apply rollback, fail-closed invariants
- Manifold: Product manifolds S^n x H^m x R^k, Riemannian Adam, Lie groups
- Temporal-causal: Causal masking, Granger causality, continuous-time ODE
- Economic: Nash equilibrium attention, Shapley attribution, incentive-aligned MPNN

Includes:
- 186 tests (163 unit + 23 integration), all passing
- WASM bindings (ruvector-graph-transformer-wasm) - published to crates.io
- Node.js NAPI-RS bindings (@ruvector/graph-transformer) - published to npm
- CI workflow for cross-platform binary builds (7 platforms)
- 10 ADRs (046-055) + 22 research documents
- Fix for #195: add commit-binaries job to build-gnn.yml
- Updated root README with graph transformer section

Published:
- crates.io: ruvector-graph-transformer v2.0.4
- crates.io: ruvector-graph-transformer-wasm v2.0.4
- npm: @ruvector/graph-transformer v2.0.4
- npm: @ruvector/graph-transformer-linux-x64-gnu v2.0.4

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-02-25 14:24:53 +00:00
rUv
45eaff391a feat: add formal verification layer with lean-agentic dependent types 
Introduces ruvector-verified and ruvector-verified-wasm crates providing
proof-carrying vector operations with sub-microsecond overhead. Includes
ADR-045, 10 exotic application examples (weapons filter, medical diagnostics,
financial routing, agent contracts, sensor swarm, quantization proof,
verified memory, vector signatures, simulation integrity, legal forensics),
rvf-kernel-optimized example, CI workflow, and root README integration.

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-02-25 03:45:18 +00:00
rUv
3d038d6d26 fix: correct SNP count from 17 to 20 in README 
The biomarker engine uses 20 SNPs (17 original + LPA rs10455872/rs3798220
+ PCSK9 rs11591147) but README was not updated to reflect the expansion.

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-02-22 16:07:39 +00:00
Claude
458e2f78f6 docs: update rvDNA and root READMEs with health biomarker engine 
- Add Health Biomarker Engine section to rvDNA README with usage examples
  for composite risk scoring, streaming processing, and synthetic populations
- Add biomarker.rs and biomarker_stream.rs to Modules table
- Update test count from 102 to 172 (added biomarker tests)
- Add biomarker benchmark results to Speed table
- Add Welford, CUSUM, and PRS to Published Algorithms table
- Update root README Genomics & Health capabilities (49 → 51 features)
- Add health biomarker engine and streaming biomarkers to root feature table
- Update rvDNA details section with risk scoring and streaming capabilities

https://claude.ai/code/session_014FpaYVohmyLH5dcBZTgmSY
 2026-02-22 06:13:12 +00:00
rUv
5712eb9269 docs: update READMEs with v0.3.0 capabilities 
Update function counts (143 SQL functions, 46 attention mechanisms),
add v0.3.0 highlights section, document 6 new modules (Solver, Math,
TDA, Extended Attention, Sona, Domain Expansion), update Docker tags,
feature flags, and capabilities table (49 features).

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-02-21 20:46:05 +00:00
rUv
256875bef6 docs: add Security Hardened RVF to README and update ADR-042 to v2.0 
- Add security_hardened.rvf entry to RVF Cognitive Containers section
- Add to examples table as top entry
- Link ADR-042 alongside ADR-030 and ADR-031
- Update capabilities table from 20 to 22 (COW branching, audited queries, exfil detection)

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-02-21 17:00:41 +00:00
Claude
05c90c77d1 docs: Add crate READMEs, AGI optimization review, and root README update 
- ruvector-solver README with algorithm table, performance optimizations
- ruvector-attn-mincut README with min-cut gating architecture
- ruvector-coherence README with metrics and comparison docs
- ruvector-profiler README with profiling hooks documentation
- AGI sublinear optimization review (18-agi-sublinear-optimization.md)
- Root README updated with sublinear solver section
- Enhanced solver_witness RVF example

https://claude.ai/code/session_01TiqLbr2DaNAntQHaVeLfiR
 2026-02-20 07:07:37 +00:00
rUv
d9da216182 docs: update READMEs with self-booting instructions, bump npm versions 
- Add Claude Code Appliance walkthrough and 5.1 MB self-boot line to
  crate, examples, npm, and root READMEs
- Add missing live_boot_proof example to table (45→46 examples)
- Update segment count references from 20→24
- Improve rvf-node npm README with full API reference
- Expand AGI Cognitive Container documentation
- Bump npm packages: rvf-node 0.1.3, rvf-wasm 0.1.3,
  rvf-mcp-server 0.1.3, rvf 0.1.5
- Include verified claude_code_appliance output files

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-02-16 14:43:04 +00:00
rUv
f8870b3c71 feat(rvf): RuVector Format — Universal Cognitive Container SDK (#166) 
* feat(rvf): add RuVector Format universal substrate specification

Research and design for RVF — a streaming, progressive, adaptive, quantum-secure
binary format for vector intelligence. Covers append-only segment model, two-level
tail manifests, temperature tiering, progressive HNSW indexing, epoch-based overlay
system, SIMD-optimized query paths, WASM microkernel for Cognitum tiles, domain
profiles (RVDNA, RVText, RVGraph, RVVision), and post-quantum cryptography.

https://claude.ai/code/session_01DDqjGE51JpsRE3DgUjFyjW

* feat(rvf): add deletion, filtered search, concurrency, and operations specs

Fill four specification gaps in the RVF format design:
- spec/07: Vector deletion lifecycle, JOURNAL_SEG wire format, deletion bitmaps
- spec/08: Filtered search with META_SEG, METAIDX_SEG, filter expression language
- spec/09: Writer locking, reader-writer coordination, versioning, space reclamation
- spec/10: Batch operations API, error codes, network streaming protocol

Also fixes the segment header field conflict between spec/01 and wire/binary-layout.md
(checksum_algo/compression now u8, adds uncompressed_len at 0x38).

https://claude.ai/code/session_01DDqjGE51JpsRE3DgUjFyjW

* feat(rvf): add RuVector Format SDK, 40 examples, MCP server, and documentation

Complete RVF implementation including:
- 12 Rust crates (rvf-types, rvf-wire, rvf-manifest, rvf-index, rvf-quant,
  rvf-crypto, rvf-runtime, rvf-import, rvf-wasm, rvf-node, rvf-server,
  plus integration tests)
- 40 runnable examples covering core storage, agentic AI, production
  patterns, vertical domains, exotic capabilities, runtime targets,
  network/security, POSIX/systems, and network operations
- TypeScript SDK (npm/packages/rvf) with RvfDatabase class
- MCP server (npm/packages/rvf-mcp-server) with stdio and SSE transports
- Node.js N-API bindings (npm/packages/rvf-node)
- WASM package (npm/packages/rvf-wasm)
- ADR-029 (canonical format), ADR-030 (computational container),
  ADR-031 (example repository)
- DNA-style lineage provenance, computational containers (KERNEL_SEG,
  EBPF_SEG), witness chains, TEE attestation, domain profiles
- Superseded ADR annotations for ADR-001, ADR-005, ADR-006, ADR-018-021

Co-Authored-By: claude-flow <ruv@ruv.net>

* feat(rvf): add CLI, WASM store, generate_all, and 46 output .rvf files

- Add rvf-cli crate (665 lines, 9 subcommands: create/ingest/query/delete/status/inspect/compact/derive/serve)
- Add WASM control plane store (alloc_setup, segment, store modules) for ~46 KB binary
- Add generate_all.rs example producing 46 persistent .rvf files in output/
- Add Node.js N-API bindings for lineage, kernel/eBPF, and inspection
- Add npm TypeScript backend/database/types for RVF integration
- Update READMEs with CLI sections, MCP server docs, and crate map (13 crates)
- All 40 examples verified passing

Co-Authored-By: claude-flow <ruv@ruv.net>

* feat(rvf): add Claude Code appliance, improve Quick Start, fix API docs

- Add claude_code_appliance.rs: self-booting RVF with SSH + Claude Code
  install (curl -fsSL https://claude.ai/install.sh | bash), 3 SSH users,
  eBPF filter, 20-package manifest, witness chain, lineage snapshot
- Improve Quick Start: Install section (crate/CLI/npm/WASM/MCP), WASM
  browser example, generate_all reference, expanded Rust crate deps
- Fix embed_kernel/embed_ebpf API docs to match actual signatures
  (u8 params with `as u8` cast, 6-param kernel, Option<&[u8]> btf)
- Update generate_all.rs: add claude_code_appliance generator (47 files)
- Regenerate all 47 output .rvf files

Co-Authored-By: claude-flow <ruv@ruv.net>

* feat(rvf): add RVCOW branching, real kernel/eBPF/launcher, 795 tests

Vector-native copy-on-write branching (ADR-031) with four new segment
types (COW_MAP 0x20, REFCOUNT 0x21, MEMBERSHIP 0x22, DELTA 0x23),
real Linux microkernel builder, QEMU microVM launcher, real eBPF
programs, and 128-byte KernelBinding for tamper-evident kernel-manifest
linkage.

New crates:
- rvf-kernel: Docker-based kernel build, real cpio/newc initramfs builder,
  SHA3-256 verification, prebuilt kernel support (37 tests)
- rvf-launch: QEMU microVM launcher with QMP shutdown, KVM/TCG detection,
  virtio-blk/net port forwarding, kernel extraction (8 tests)
- rvf-ebpf: 3 real BPF C programs (xdp_distance, socket_filter,
  tc_query_route) with clang compilation support (17 tests)

RVCOW runtime:
- CowEngine with read/write paths, write coalescing, snapshot-freeze
- CowMap (flat-array), MembershipFilter (bitmap), CowCompactor
- 3x read performance via pread optimization (1.3us/vector)
- Branch creation: 2.6ms for 10K vectors, child = 162 bytes

Security: 20-finding audit, 7 fixes applied including division-by-zero
guards, integer overflow checks, and KernelBinding::from_bytes_validated().

CLI: 8 new commands (launch, embed-kernel, embed-ebpf, filter, freeze,
verify-witness, verify-attestation, rebuild-refcounts), serve wired to
real rvf-server.

Co-Authored-By: claude-flow <ruv@ruv.net>

* feat(rvf): update README, add crate/npm READMEs, publish to crates.io and npm

- Rewrite README with cognitive container terminology, grouped features,
  4 comparison tables (vs Docker, Vector DBs, Git LFS, SQLite), updated
  benchmarks, architecture diagram, and 45 examples
- Add READMEs for rvf-kernel, rvf-launch, rvf-ebpf, rvf-import crates
- Add READMEs for @ruvector/rvf, rvf-node, rvf-wasm, rvf-mcp-server npm packages
- Fix Cargo.toml metadata (homepage, readme, categories, keywords) and
  add version specs to all path dependencies for crates.io publishing
- Fix clippy warnings in rvf-kernel/initramfs.rs and rvf-launch/lib.rs
- Published to crates.io: rvf-types, rvf-wire, rvf-manifest, rvf-quant,
  rvf-index, rvf-crypto (remaining crates pending rate limit)
- Published to npm: @ruvector/rvf, @ruvector/rvf-node, @ruvector/rvf-wasm,
  @ruvector/rvf-mcp-server

Co-Authored-By: claude-flow <ruv@ruv.net>

* chore: add rvf-kernel, rvf-ebpf, rvf-launch, rvf-server, rvf-import, rvf-cli to workspace

Include all 15 RVF crates plus integration tests and benchmarks in the
root workspace members list so cargo publish can resolve them by name.

Co-Authored-By: claude-flow <ruv@ruv.net>

* feat(rvf): add published packages, cognitive container branding, grouped capabilities

- Add Published Packages section with 13 crates.io + 4 npm tables
- Add Platform Support table (Linux, macOS, Windows, WASM, no_std)
- Expand capability table from 9 to 15 rows in 4 groups
- Rewrite all "How" descriptions in plain language
- Update .rvf diagram to show all 20 segment types
- Rename ADRs: computational container -> cognitive container
- Add emojis to all section headers

Co-Authored-By: claude-flow <ruv@ruv.net>

* feat: update root README with RVF cognitive containers, expanded capabilities

- Update intro: "gets smarter + ships as cognitive container"
- Add self-booting microservice row to Pinecone comparison table
- Expand capabilities from 34 to 42 features with dedicated RVF section
- Update "Think of it as" to include Docker comparison and RVF explanation
- Add RVF collapsed group to Ecosystem (13 crates, 4 npm, install commands)
- Add RVF to Platform & Edge section with install commands
- Add RVF npm packages (4) and Rust crates (13) to package reference
- Add RVF rows to feature comparison table (6 new rows)
- Add ADR-030/031 to ADR list
- Add RVF to Installation table, Project Structure
- Update attention mechanisms count from 39 to 40+
- Update npm count to 49+, Rust crates to 83
- Update footer with crates.io and RVF links

Co-Authored-By: claude-flow <ruv@ruv.net>

* feat: expand comparison table with emojis, cost, audit, branching, single-file

Co-Authored-By: claude-flow <ruv@ruv.net>

* docs: rewrite comparison table in plain language

Co-Authored-By: claude-flow <ruv@ruv.net>

* chore: clean up empty code change sections in the changes log

---------

Co-authored-by: Claude <noreply@anthropic.com>
 2026-02-14 13:14:49 -05:00
rUv
f172643f06 feat(ospipe): RuVector-enhanced personal AI memory for Screenpipe (#163) 
* feat(ospipe): implement OSpipe screenpipe integration with WASM + TypeScript SDK

Adds the OSpipe crate providing a quantum-enhanced screenpipe integration layer:
- Rust core library (7 modules): capture, storage, search, pipeline, safety, config, wasm
- WASM bindings via wasm-bindgen for browser deployment
- TypeScript SDK (@ruvector/ospipe) with SSE streaming and hybrid search
- Frame deduplication, PII safety gate, query routing, cosine similarity search
- 56 tests passing (24 unit + 32 integration), builds for native + wasm32
- Comprehensive ADR with Windows/macOS/Linux/WASM integration plans
- CI stub for cross-platform matrix builds (Linux, Windows, macOS, WASM)

Co-Authored-By: claude-flow <ruv@ruv.net>

* chore(ospipe): add README, fix clippy warnings, optimize dedup and pipeline

- Add comprehensive README.md with features, comparison tables, quick
  start guides, collapsed configuration reference, and API docs
- Fix all default clippy warnings (auto-fix + manual)
- Replace Vec with VecDeque in FrameDeduplicator for O(1) eviction
- Remove redundant frame.clone() in ingestion pipeline (move instead)
- Add is_empty() to WASM OsPipeWasm type
- Fix broken intra-doc link for cfg-gated bindings module
- Remove unused imports in integration tests (FrameContent, SearchConfig)

Co-Authored-By: claude-flow <ruv@ruv.net>

* feat(ospipe): integrate graph, attention, GNN, and quantum crates (Phase 2-4)

Add four new OSpipe modules integrating RuVector crates:

- graph: KnowledgeGraph wrapping ruvector-graph with heuristic entity
  extraction (URLs, emails, @mentions, capitalized phrases), entity/
  relationship CRUD, and frame entity ingestion
- search/reranker: AttentionReranker using ruvector-attention scaled
  dot-product attention for result re-ranking (0.6*attention + 0.4*cosine)
- learning: SearchLearner with EWC (ruvector-gnn) for continual learning
  without catastrophic forgetting, ReplayBuffer for feedback, and
  EmbeddingQuantizer for age-based vector compression
- quantum: QuantumSearch using ruqu-algorithms QAOA for diversity selection,
  Grover-inspired amplitude boosting, and optimal iteration estimation

All modules use cfg-gated dual implementations (native + WASM stub).
60 tests passing (59 integration + 1 doc-test), native + WASM builds clean.

Co-Authored-By: claude-flow <ruv@ruv.net>

* feat(ospipe): complete all 15 gap items — HNSW, persistence, REST API, MMR, safety fixes

Implements all remaining OSpipe features from the gap analysis:

High — Core functionality:
- HNSW indexing via ruvector-core with O(log n) ANN search (HnswVectorStore)
- EmbeddingModel trait + RuvectorEmbeddingModel for pluggable embedding backends
- JSON-file persistence layer (PersistenceLayer) for frames and config
- Axum REST API server matching TypeScript SDK endpoints (/search, /graph, /health, /stats, /route)
- Enhanced search pipeline wired into ingestion (router -> rerank -> quantum diversity)

Medium — Correctness:
- WASM/native routing consistency (aligned keyword sets and priority order)
- WASM/native safety consistency (email detection, deny keywords, CC/SSN patterns)
- MMR (Maximal Marginal Relevance) reranker for diversity vs relevance tradeoff
- Delete and update_metadata APIs on VectorStore and HnswVectorStore
- Email redaction preserves surrounding whitespace (tabs, newlines, multi-space)

Lower — Polish:
- TypeScript SDK: fetchWithRetry with exponential backoff, timeout, AbortSignal
- console_error_panic_hook init in WASM module
- WASM test scaffold (tests/wasm.rs)
- Quantization tiers in config (None -> Scalar -> Product -> Binary by age)
- All clippy warnings resolved (0 warnings)

82 tests passing, 1 doc-test passing, 0 clippy warnings.

Co-Authored-By: claude-flow <ruv@ruv.net>

* chore: update Cargo.lock after OSpipe dependency changes

Co-Authored-By: claude-flow <ruv@ruv.net>

* feat(ospipe): add server binary, WASM build, version-pin deps for publishing

- Add ospipe-server binary with CLI args (--port, --data-dir, --help, --version)
- Add tracing-subscriber for structured logging
- Version-pin all 9 path dependencies for crates.io readiness
- Fix ref -> ref mut for KnowledgeGraph mutable borrow in pipeline
- Fix redundant rustdoc link in embedding.rs
- Update ospipe-wasm package.json to match wasm-pack output filenames
- WASM build produces 145KB binary with full browser API

Build artifacts (not committed, in dist/):
- ospipe-server-linux-x86_64 (1.8MB)
- ospipe-server-linux-arm64 (1.6MB)
- ospipe-server-windows-x86_64.exe (3.9MB)
- ospipe_bg.wasm (145KB)
- @ruvector/ospipe npm tarball (13.9KB)

Co-Authored-By: claude-flow <ruv@ruv.net>

* docs: add OSpipe to root README, publish ospipe + deps to crates.io

Add OSpipe personal AI memory section to root README with features,
comparison table, install commands, and Rust quickstart.

Published to registries:
- ospipe v0.1.0 (crates.io)
- ruvector-delta-core v0.1.0 (crates.io)
- ruvector-cluster v2.0.2 (crates.io)
- ruvector-router-core v2.0.2 (crates.io)
- @ruvector/ospipe v0.1.0 (npm)
- @ruvector/ospipe-wasm v0.1.0 (npm)

Co-Authored-By: claude-flow <ruv@ruv.net>

* fix: add uuid dev-dep for tests, bump rvlite to 0.2.1

- Add uuid to OSpipe dev-dependencies to fix version mismatch in
  integration tests
- Bump rvlite npm package to 0.2.1 (0.2.0 blocked by npm)

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-02-12 22:45:25 -05:00
rUv
cb1b6de3be docs: add missing crates and examples to root README 
Crates added:
- ruvector-delta-core, delta-graph, delta-index, delta-consensus,
  delta-wasm (behavioral change tracking subsystem)
- profiling (real-time coherence diagnostics)

Examples added:
- dna (rvDNA genomic analysis)
- delta-behavior (change tracking math)
- data (dataset discovery framework)
- prime-radiant (coherence engine demos)
- benchmarks (temporal reasoning benchmarks)
- vwm-viewer (visual vector world model viewer)

Updated counts: 70 crates, 34 examples, 34 capabilities.

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-02-12 16:17:02 +00:00
rUv
4d6f9abbc4 docs: add rvDNA to all root README sections 
- Capabilities: new "Genomics & Health" section (items 22-25)
- Installation table: cargo add rvdna, npm install @ruvector/rvdna
- npm Packages: @ruvector/rvdna under "Genomics & Health"
- Rust Crates: rvdna with crates.io badge and feature summary
- Updated capability count from 30+ to 34

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-02-12 15:59:02 +00:00
rUv
c30c3dd8ef docs(rvdna): add health mission, npm/crate details, mermaid diagrams 
- Add "Why This Exists" section: AI for instant, private, free
  genomic diagnostics available to everyone
- Add install table with crates.io and npm links
- Add full npm API table with JS examples and NAPI-RS platform matrix
- Replace ASCII architecture with 4 mermaid diagrams in collapsed
  sections: pipeline, .rvdna format layout, data flow, WASM deployment
- Add collapsed rvDNA section to root README.md

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-02-12 15:55:02 +00:00
rUv
b67f3c9962 feat: add READMEs and publish ruqu packages v2.0.3 
Crates.io (v2.0.3):
- ruqu-core: High-performance quantum circuit simulator
- ruqu-algorithms: VQE, Grover, QAOA, Surface Code
- ruqu-exotic: Quantum-classical hybrid algorithms
- ruqu-wasm: WebAssembly bindings

npm (@ruvector/ruqu-wasm v2.0.3):
- Browser-native quantum simulation
- 25-qubit support with 105KB WASM bundle
- TypeScript definitions included

SEO-optimized READMEs with:
- Performance benchmarks
- API documentation
- Code examples
- ADR links

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-02-08 17:13:57 +00:00
rUv
00aa395976 feat: publish ruQu quantum simulation engine crates 
Published crates:
- ruqu-core v2.0.2 - State-vector simulator
- ruqu-algorithms v2.0.2 - VQE, Grover, QAOA, Surface Code
- ruqu-exotic v2.0.2 - Quantum-classical hybrids
- ruqu-wasm v2.0.2 - WebAssembly bindings

Updated README with quantum engine section linking ADRs:
- QE-001 to QE-012: Core architecture to MinCut coherence
- Code example for GHZ state creation

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-02-08 17:06:58 +00:00
rUv
00e8fc3f1e docs: expand temporal tensor store section with PR #156 details 
Added ADR links (018-023) and DDD reference for:
- Block-based storage engine
- Tiered quantization formats
- Temporal scoring tier migration
- Delta compression reconstruction
- WASM API cross-platform
- Benchmarking acceptance criteria

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-02-08 17:03:22 +00:00
rUv
8cfb2e8393 docs: update README with new crates and BitNet features 
Added:
- ruvector-temporal-tensor: Temporal tensor store with tiered quantization
- ruvector-crv: CRV signal line protocol for vector search
- BitNet 1.58-bit quantization features to ruvllm description

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-02-08 17:02:09 +00:00
rUv
f0f33625f3 feat(prime-radiant): Universal Coherence Engine with Sheaf Laplacian AI Safety (#131) 
* docs(coherence-engine): add ADR-014 and DDD for sheaf Laplacian coherence engine

Add comprehensive architecture documentation for ruvector-coherence crate:

- ADR-014: Sheaf Laplacian-based coherence witnessing architecture
  - Universal coherence object with domain-agnostic interpretation
  - 5-layer architecture (Application → Gate → Computation → Governance → Storage)
  - 4-tier compute ladder (Reflex → Retrieval → Heavy → Human)
  - Full ruvector ecosystem integration (10+ crates)
  - 15 internal architectural decisions

- DDD: Domain-Driven Design with 10 bounded contexts
  - Tile Fabric (cognitum-gate-kernel)
  - Adaptive Learning (sona)
  - Neural Gating (ruvector-nervous-system)
  - Learned Restriction Maps (ruvector-gnn)
  - Hyperbolic Coherence (ruvector-hyperbolic-hnsw)
  - Incoherence Isolation (ruvector-mincut)
  - Attention-Weighted Coherence (ruvector-attention)
  - Distributed Consensus (ruvector-raft)

Key concept: "This is not prediction. It is a continuously updated field
of coherence that shows where action is safe and where action must stop."

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* feat(prime-radiant): implement sheaf Laplacian coherence engine

Implement the complete Prime-Radiant crate based on ADR-014:

Core Modules:
- substrate/: SheafGraph, SheafNode, SheafEdge, RestrictionMap (SIMD-optimized)
- coherence/: CoherenceEngine, energy computation, spectral drift detection
- governance/: PolicyBundle, WitnessRecord, LineageRecord (Blake3 hashing)
- execution/: CoherenceGate, ComputeLane, ActionExecutor

Ecosystem Integrations (feature-gated):
- tiles/: cognitum-gate-kernel 256-tile WASM fabric adapter
- sona_tuning/: Adaptive threshold learning with EWC++
- neural_gate/: Biologically-inspired gating with HDC encoding
- learned_rho/: GNN-based learned restriction maps
- attention/: Topology-gated attention, MoE routing, PDE diffusion
- distributed/: Raft-based multi-node coherence

Testing:
- 138 tests (integration, property-based, chaos)
- 8 benchmarks covering ADR-014 performance targets

Stats: 91 files, ~30K lines of Rust code

"This is not prediction. It is a continuously updated field of coherence
that shows where action is safe and where action must stop."

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* docs(adr): add RuvLLM integration to ADR-014 v0.4

- Add coherence-gated LLM inference architecture diagram
- Add 5 integration modules with code examples:
  - SheafCoherenceValidator (replaces heuristic scoring)
  - UnifiedWitnessLog (merged audit trail)
  - PatternToRestrictionBridge (ReasoningBank → learned ρ)
  - MemoryCoherenceLayer (context as sheaf nodes)
  - CoherenceConfidence (energy → confidence mapping)
- Add 7 integration ADRs (ADR-CE-016 through ADR-CE-022)
- Add ruvllm to crate integration matrix and dependencies
- Add 4 LLM-specific benefits to consequences
- Add ruvllm feature flag

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* docs(adr): add 22 coherence engine internal ADRs

Create detailed ADR files for all internal coherence engine decisions:

Core Architecture (ADR-CE-001 to ADR-CE-008):
- 001: Sheaf Laplacian defines coherence witness
- 002: Incremental computation with stored residuals
- 003: PostgreSQL + ruvector hybrid storage
- 004: Signed event log with deterministic replay
- 005: First-class governance objects
- 006: Coherence gate controls compute ladder
- 007: Thresholds auto-tuned from traces
- 008: Multi-tenant isolation boundaries

Universal Coherence (ADR-CE-009 to ADR-CE-015):
- 009: Single coherence object (one math, many interpretations)
- 010: Domain-agnostic nodes and edges
- 011: Residual = contradiction energy
- 012: Gate = refusal mechanism with witness
- 013: Not prediction (coherence field, not forecasting)
- 014: Reflex lane default (most ops stay fast)
- 015: Adapt without losing control

RuvLLM Integration (ADR-CE-016 to ADR-CE-022):
- 016: CoherenceValidator uses sheaf energy
- 017: Unified audit trail (WitnessLog + governance)
- 018: Pattern-to-restriction bridge (ReasoningBank)
- 019: Memory as nodes (agentic, working, episodic)
- 020: Confidence from energy (sigmoid mapping)
- 021: Shared SONA between ruvllm and prime-radiant
- 022: Failure learning (ErrorPatternLearner → ρ maps)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* feat(prime-radiant): implement RuvLLM integration layer (ADR-014 v0.4)

Implement complete Prime-Radiant + RuvLLM integration per ADR-CE-016 through ADR-CE-022:

Core Integration Modules:
- coherence_validator.rs: SheafCoherenceValidator using sheaf energy
- witness_log.rs: UnifiedWitnessLog with hash chain for tamper evidence
- pattern_bridge.rs: PatternToRestrictionBridge learning from verdicts
- memory_layer.rs: MemoryCoherenceLayer tracking context as sheaf nodes
- confidence.rs: CoherenceConfidence with sigmoid energy→confidence mapping

Supporting Infrastructure:
- mod.rs: Public API, re-exports, convenience constructors
- error.rs: Comprehensive error types for each ADR
- config.rs: LlmCoherenceConfig, thresholds, policies
- gate.rs: LlmCoherenceGate high-level interface
- adapter.rs: RuvLlmAdapter bridging type systems
- bridge.rs: PolicyBridge, SonaBridge for synchronization
- witness.rs: WitnessAdapter for correlation
- traits.rs: Trait definitions for loose coupling

Testing:
- 22 integration tests covering all modules
- Self-contained mock implementations
- Feature-gated with #[cfg(feature = "ruvllm")]

Feature Flags:
- ruvllm feature in Cargo.toml
- Optional dependency on ruvllm crate
- Added to "full" feature set

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* docs(prime-radiant): add comprehensive README with examples

Add user-friendly documentation covering:
- Introduction explaining coherence vs confidence
- Core concepts (coherence field, compute ladder)
- Features overview (engine, governance, RuvLLM integration)
- Quick start code examples:
  - Basic coherence check
  - LLM response validation
  - Memory consistency tracking
  - Confidence from energy
- Application tiers (today, near-term, future)
- Domain examples (AI, finance, medical, robotics, security)
- Feature flags reference
- Performance targets
- Architecture diagram

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* docs(adr): add ADR-015 Coherence-Gated Transformer (Sheaf Attention)

Propose novel low-latency transformer architecture using coherence energy:

Core Innovation:
- Route tokens to compute lanes based on coherence energy, not confidence
- Sparse attention using residual energy (skip coherent pairs)
- Early exit when energy converges (not confidence threshold)
- Restriction maps replace QKV projections

Architecture:
- Lane 0 (Reflex): 1-2 layers, local attention, <0.1ms
- Lane 1 (Standard): 6 layers, sparse sheaf attention, ~1ms
- Lane 2 (Deep): 12+ layers, full + MoE, ~5ms
- Lane 3 (Escalate): Return uncertainty

Performance Targets:
- 5-10x latency reduction (10ms → 1-2ms for 128 tokens)
- 2.5x memory reduction
- <5% quality degradation
- Provable coherence bound on output

Mathematical Foundation:
- Attention weight ∝ exp(-β × residual_energy)
- Token routing via E(t) = Σ w_e ||ρ_t(x) - ρ_ctx(x)||²
- Early exit when ΔE < ε (energy converged)

Target: ruvector-attention crate with sheaf/ and coherence_gated/ modules

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* feat(prime-radiant): implement coherence engine with CGT attention

Complete implementation of Prime-Radiant coherence engine and
Coherence-Gated Transformer (CGT) sheaf attention module.

Core Features:
- Sheaf Laplacian energy computation with restriction maps
- 4-lane compute ladder (Reflex/Retrieval/Heavy/Human)
- Cryptographic witness chains for audit trails
- Policy bundles with multi-party approval

Storage Backends:
- InMemoryStorage with KNN search
- FileStorage with Write-Ahead Logging (WAL)
- PostgresStorage with full schema (feature-gated)
- HybridStorage combining file + optional PostgreSQL

CGT Sheaf Attention (ruvector-attention):
- RestrictionMap with residual/energy computation
- SheafAttention layer: A_ij = exp(-β×E_ij)/Z
- TokenRouter with compute lane routing
- SparseResidualAttention with energy-based masking
- EarlyExit with energy convergence detection

Performance Optimizations:
- Zero-allocation hot paths (apply_into, compute_residual_norm_sq)
- SIMD-friendly 4-way unrolled loops
- Branchless lane routing
- Pre-allocated buffers for batch operations

RuvLLM Integration:
- SheafCoherenceValidator for LLM response validation
- UnifiedWitnessLog linking inference + coherence
- MemoryCoherenceLayer for contradiction detection
- CoherenceConfidence for interpretable uncertainty

Tests: 202 passing in ruvector-attention, 180+ in prime-radiant

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* feat(prime-radiant): add GPU acceleration, SIMD optimizations, and benchmarks

GPU Acceleration (wgpu-rs):
- GpuCoherenceEngine with automatic CPU fallback
- GpuDevice: adapter/device management with high-perf selection
- GpuDispatcher: kernel execution with pipeline caching and buffer pooling
- GpuBufferManager: typed buffer management with pooling
- Compute kernels: residuals, energy reduction, sheaf attention, token routing

WGSL Compute Shaders (6 files, 1,412 lines):
- compute_residuals.wgsl: parallel edge residual computation
- compute_energy.wgsl: two-phase parallel reduction
- sheaf_attention.wgsl: energy-based attention weights A_ij = exp(-beta * E_ij)
- token_routing.wgsl: branchless lane assignment
- sparse_mask.wgsl: sparse attention mask generation
- types.wgsl: shared GPU struct definitions

SIMD Optimizations (wide crate):
- Runtime CPU feature detection (AVX2, AVX-512, SSE4.2, NEON)
- f32x8 vectorized operations
- simd/vectors.rs: dot_product_simd, norm_squared_simd, subtract_simd
- simd/matrix.rs: matmul_simd, matvec_simd, transpose_simd
- simd/energy.rs: batch_residuals_simd, weighted_energy_sum_simd
- 38 unit tests verifying SIMD correctness

Benchmarks (criterion):
- coherence_benchmarks.rs: core operations, graph scaling
- simd_benchmarks.rs: SIMD vs naive comparisons
- gpu_benchmarks.rs: CPU vs GPU performance

Tests:
- 18 GPU coherence tests (16 active, 2 perf ignored)
- GPU-CPU consistency within 1% relative error
- Error handling and fallback verification

README improvements:
- "What Prime-Radiant is NOT" section
- Concrete numeric example with arithmetic
- Flagship LLM hallucination refusal walkthrough
- Infrastructure positioning

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* perf(prime-radiant): optimize SIMD and core computation patterns

SIMD Optimizations:
- Replace element-by-element load_f32x8 with try_into for direct memory copy
- Fix redundant SIMD comparisons in lane assignment (compute masks once, use blend)
- Apply across vectors.rs, matrix.rs, and energy.rs

Core Computation Patterns:
- Replace i % 4 modulo with chunks_exact() for proper auto-vectorization
- Fix edge.rs: residual_norm_squared, residual_with_energy
- Fix node.rs: norm_squared, dot product

Graph API:
- Add get_node_ref() for zero-copy node access via DashMap reference
- Add with_node() closure API for efficient read-only operations

Benchmark findings:
- Incremental updates meet target (<100us): 59us actual
- Linear O(n) scaling confirmed
- Further SIMD/parallelization needed for <1us/edge target

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* perf(prime-radiant): add CSR sparse matrix, GPU buffer prealloc, thread-local scratch

Performance optimizations for Prime-Radiant coherence engine:

CSR Sparse Matrix (restriction.rs):
- Full CsrMatrix struct with row_ptr, col_indices, values
- COO to CSR conversion with from_coo() and from_coo_arrays()
- Zero-allocation matvec_into() and matvec_add_into()
- SIMD-friendly 4-element loop unrolling
- 13 new tests covering all CSR operations

GPU Buffer Pre-allocation (engine.rs, kernels.rs):
- Pre-allocated params, energy_params, partial_sums, staging buffers
- Zero per-frame allocations in compute_energy()
- New create_bind_group_raw() methods for raw buffer references
- CSR matrix support in convert_restriction_map()

Thread-Local Scratch Buffers (edge.rs):
- EdgeScratch struct with 3 reusable Vec<f32> buffers
- thread_local! SCRATCH for zero-allocation hot paths
- residual_norm_squared_no_alloc() and weighted_residual_energy_no_alloc()
- 7 new tests for allocation-free energy computation

WGSL Vec4 Optimization (compute_residuals.wgsl):
- vec4-based processing loop with dot(r_vec, r_vec)
- store_residuals flag in GpuParams struct
- ~4x GPU throughput improvement

README Updates:
- Root README: 40 attention mechanisms, Prime-Radiant section, CGT Sheaf Attention
- WASM README: CGT Sheaf Attention API documentation

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* chore: SEO optimize package metadata for crates.io and npm

- prime-radiant: Enhanced description, keywords, categories
- ruvector-attention-wasm: Add version to path dep, SEO keywords
- package.json: 23 keywords, better description, engines config

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* chore(hyperbolic-hnsw): SEO optimize for crates.io publish

* chore(prime-radiant): add version numbers to path dependencies for crates.io publish

* fix(prime-radiant): shorten keyword for crates.io compliance

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* docs(readme): add prime-radiant and ruvector-attention-wasm package references

- Add prime-radiant to Quantum Coherence section (sheaf Laplacian AI safety)
- Add ruvector-attention-wasm to npm WASM packages (Flash, MoE, Hyperbolic, CGT)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

---------

Co-authored-by: Reuven <cohen@ruv-mac-mini.local>
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-22 21:27:27 -05:00
Reuven
7ca24275d3 docs(readme): add Cognitum Gate and Neuromorphic Discoveries to Use Cases 
## AI Safety & Coherence (Cognitum Gate)
- 256-tile WASM fabric for real-time safety decisions
- TileZero arbiter with supergraph merging
- Permit/Defer/Deny decisions with cryptographic tokens
- Hash-chained witness receipts for audit trails
- Anytime-valid sequential hypothesis testing
- Rust and JavaScript code examples

## Neuromorphic Computing (micro-hnsw v2.3)
- Spike-Timing Vector Encoding for temporal similarity
- Homeostatic Plasticity for self-stabilizing networks
- Oscillatory Resonance (40Hz gamma) for search amplification
- Winner-Take-All circuits with lateral inhibition
- Dendritic Computation for non-linear local processing
- STDP learning integration
- 11.8KB WASM footprint for edge/embedded

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-22 00:57:36 -05:00
Reuven
2bbd54638a docs(readme): add Dynamic Embedding Fine-Tuning to RuvLLM section 
- MicroLoRA per-request adaptation (<1ms, <50KB adapters)
- Contrastive training with triplet loss and hard negatives
- Task-specific adapters: Coder, Researcher, Security, Architect, Reviewer
- EWC++ for catastrophic forgetting prevention
- Adapter merging strategies: Average, Weighted, SLERP, TIES, DARE
- JavaScript and Rust code examples for fine-tuning
- Links to Fine-Tuning Guide and Task Adapters docs

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-22 00:55:19 -05:00
Reuven
5827b31218 docs(readme): add Dynamic Embedding Fine-Tuning to Use Cases 
- Real-time MicroLoRA adaptation (<1ms per request)
- Contrastive training with triplet loss and hard negatives
- Task-specific adapters (Coder, Researcher, Security, Architect, Reviewer)
- EWC++ for catastrophic forgetting prevention
- Browser fine-tuning with MicroLoRA WASM (<50KB adapters)
- Three-tier adaptation system: Instant, Background, Deep
- Code examples for JavaScript, Rust, and browser WASM

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-22 00:54:30 -05:00
Reuven
51ecf86398 docs(readme): expand Use Cases section with 8 categories and examples 
- AI & LLM Applications: RAG, agent routing, multi-agent orchestration
- Search & Discovery: semantic, hybrid, image similarity, code search
- Recommendations & Personalization: products, content, similar items
- Knowledge Management: knowledge graphs, document Q&A, scientific papers
- Real-Time & Edge: browser AI, IoT, mobile, streaming
- Scientific & Research: neural networks, trading, quantum, brain connectivity
- Distributed & Enterprise: multi-region, HA, PostgreSQL, burst scaling
- Agentic Workflows: version control, DAG pipelines, web scraping

Each category includes feature tables, code examples, and links to examples/

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-22 00:52:10 -05:00
Reuven
b89680d17e docs(readme): complete Rust Crates section with all 63 packages 
- Add missing crates: micro-hnsw-wasm, ruvector-postgres, rvlite, sona
- Add new sections: Self-Learning (SONA), Standalone Edge Database (rvLite), PostgreSQL Extension
- Remove non-existent profiling crate reference
- All 63 crates in crates/ directory now documented

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-22 00:49:53 -05:00
Reuven
1e3f1634de docs(readme): expand npm packages section with all 45+ packages 
Reorganized npm packages into categories:
- Core Packages (4): ruvector, core, node, extensions
- Graph & GNN (4): gnn, graph-node, graph-wasm, graph-data-generator
- AI Routing & Attention (3): tiny-dancer, router, attention
- Learning & Neural (2): sona, spiking-neural
- LLM Runtime (3): ruvllm, ruvllm-cli, ruvllm-wasm
- Distributed Systems (5): cluster, server, raft, replication, burst-scaling
- Edge & Standalone (2): rvlite, rudag
- Agentic & Synthetic Data (3): agentic-synth, agentic-integration, cognitum/gate
- CLI Tools (3): cli, postgres-cli, scipix
- WASM Packages (10): wasm, wasm-unified, gnn-wasm, attention-wasm, etc.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-22 00:44:36 -05:00
Reuven
61c572b507 docs(readme): organize sections into logical groups 
Added section group headers to improve navigation:
- Package Reference (Documentation, npm, Rust crates)
- Platform Features (DAG, rvLite, Edge-Net)
- AI & Machine Learning (Synth, Neural Trader, RuvLLM, SNN, REFRAG, etc.)
- Database Extensions (PostgreSQL)
- Developer Tools (Utilities)
- Browser & Edge (WASM packages)
- Self-Learning Systems (Intelligence Hooks)
- Additional Modules (OCR, ONNX, Bindings)
- Examples & Tutorials
- Project (Structure)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-22 00:40:58 -05:00
Reuven
869fb7d305 docs(readme): add 7 comprehensive example sections 
Added collapsed sections with badges, feature tables, and tutorials for:
- Agentic-Jujutsu: Quantum-resistant version control (23x faster commits)
- SciPix: Scientific document OCR (50ms text, 80ms math)
- Meta-Cognition SNN: Spiking neural networks (5-54x SIMD speedup)
- RuvLLM: Self-learning LLM orchestration (SONA 3-tier learning)
- REFRAG: Compress-Sense-Expand RAG (~30x latency reduction)
- 7sense: Bioacoustic bird call analysis (150x HNSW speedup)
- EXO-AI: Cognitive substrate with IIT consciousness (8-54x SIMD)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-22 00:38:49 -05:00
Reuven
95a245e64d docs(readme): add Neural Trader AI trading system section 
- 4 core AI/ML engines: Kelly, LSTM-Transformer, DRL Portfolio, Sentiment
- Research-backed algorithms table
- Quick start with code examples
- Use cases: stocks, sports betting, crypto, news trading
- 20+ package ecosystem table
- CLI interface examples
- Exotic examples: swarm, GNN, quantum, hyperbolic
- Performance benchmarks table

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-22 00:33:12 -05:00
Reuven
e88adbc4e3 docs(readme): add downloads badge for rvLite, add Agentic-Synth section 
rvLite:
- Add downloads badge linking to npm package

Agentic-Synth - AI Synthetic Data Generation:
- Problem/Solution comparison table
- Key features: multi-model, caching, routing, DSPy.ts
- Data generation types: time-series, events, structured, embeddings
- Quick start with npx commands
- Basic usage examples (structured, time-series, streaming)
- Self-learning with DSPy optimizer example
- Performance metrics (98.2% faster with caching)
- Ecosystem integration table

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-22 00:31:42 -05:00
Reuven
a6dffd270c docs(readme): add rvLite and Edge-Net collapsed sections 
rvLite - Standalone Edge Database:
- Architecture diagram showing WASM crate composition
- SQL, SPARQL, Cypher query examples
- GNN embeddings and ReasoningBank learning
- Platform support table (browsers, Node, Deno, Bun, Workers)
- Size budget breakdown (~2.3MB total)

Edge-Net - Collective AI Computing Network:
- Network architecture diagram
- How it works: contribute, earn, use cycle
- AI Intelligence Stack (MicroLoRA, SONA, HNSW, Federated Learning)
- Pi-Key identity system (π, e, φ keys)
- Quick start: join collective, submit tasks, monitor stats
- Self-optimizing features (routing, topology, Q-learning security)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-22 00:30:42 -05:00
Reuven
13bacf76dd docs(readme): add comprehensive Self-Learning DAG section 
New collapsed section includes:
- Introduction and key benefits (50-80% latency reduction)
- Use cases (vector search, APIs, analytics, edge, multi-tenant)
- How it works diagram with MinCut tension explanation
- 7 DAG attention mechanisms table
- Quick start for Rust, Node.js, and Browser (WASM)
- SONA learning integration example
- Self-healing (reactive + predictive) code
- Query convergence demonstration
- Performance targets table
- Installation instructions

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-22 00:28:17 -05:00
Reuven
3aaa3c4faa docs(readme): expand Core Features and Comparison tables 
Core Features & Capabilities:
- Add LLM Runtime section (ruvllm, WebGPU, RuvLTRA, quantization)
- Add Platform & Edge section (rvLite, PostgreSQL, MCP, WASM, Node.js)
- Add Specialized Processing (SciPix, DAG, Cognitum, FPGA, ruQu, Mincut)
- Add Self-Learning & Adaptation (hooks, ReasoningBank, Economy, Nervous)
- Expand existing sections with Hyperbolic HNSW, Sparse Vectors, Local Embeddings

Comparison Table:
- Add DAG Workflows, ReasoningBank, Economy System, Nervous System
- Add Cognitum Gate, SciPix OCR, Spiking Neural Nets
- Add Node.js Native, Burst Scaling, Streaming API
- Fix Local Embeddings count (6 → 8+)
- Add WebGPU to Browser/WASM

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-22 00:26:23 -05:00
Reuven
25a6272722 docs: add ruvllm-wasm README and improve Bindings & Tools section 
- Add comprehensive README.md for ruvllm-wasm crate
- Improve Bindings & Tools section with intro and usage examples
- Add Node.js, Browser, CLI, and HTTP Server examples

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-22 00:20:50 -05:00
Reuven
75d637c6b1 docs: improve PostgreSQL section with better intro and Docker Hub info 
- Add better intro explaining why RuVector Postgres
- Update Docker Hub URL to ruvnet/ruvector-postgres
- Add environment variables table
- Update Docker Compose with correct image
- Add quick install command at top

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-22 00:18:42 -05:00
Reuven
bc43bac0fb docs: make Tools & Utilities section collapsible 
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-22 00:17:36 -05:00
Reuven
c2b63c06db docs: fix PostgreSQL section nesting - now top-level collapsible 
- Close Rust Crates section before PostgreSQL
- Remove extra </details> tag

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-22 00:16:20 -05:00
Reuven
236e91361a docs: make PostgreSQL Extension section collapsible 
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-22 00:14:39 -05:00
Reuven
e3fb4a509f docs: add rvlite to WASM & Utility Packages section 
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-22 00:13:36 -05:00
Reuven
5c6708e066 docs: add comprehensive PostgreSQL section with Docker/npm/crate instructions 
- Add feature comparison table (pgvector vs RuVector Postgres)
- Docker: quick start, docker-compose, available tags
- npm CLI: commands, programmatic TypeScript usage
- Rust crate: cargo-pgrx installation, features
- SQL examples: HNSW, hybrid search, GNN, local embeddings

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-22 00:12:52 -05:00
Reuven
8851bbd1be docs: expand capabilities section from 14 to 30+ features 
Organized into categories:
- Core Vector Database (5)
- Distributed Systems (4)
- AI & Machine Learning (7)
- Specialized Processing (5)
- Platform & Integration (4)
- Self-Learning & Adaptation (5)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-22 00:10:11 -05:00
Reuven
ea6b5f4eb7 docs: minor README formatting fixes 
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-22 00:07:54 -05:00
Reuven
ec8ecb6b89 feat(npm): add @ruvector/ruvllm-cli and @ruvector/ruvllm-wasm packages 
- Add @ruvector/ruvllm-cli v0.1.0: CLI for LLM inference with Metal/CUDA
- Add @ruvector/ruvllm-wasm v0.1.0: Browser LLM inference with WebGPU
- Remove duplicate npm/packages/wasm (replaced by ruvector-wasm)
- Fix workspace:* reference in ruvector-wasm-unified
- Update README with npm packages section

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-22 00:06:03 -05:00
Reuven
b28654c448 docs: add new npm packages to README 
- Move @ruvector/raft, @ruvector/replication, @ruvector/scipix from
  Planned to Published section with badges and download counts
- Add new "Distributed Systems (Raft & Replication)" section with:
  - Crate table with badges
  - Feature highlights (consensus, vector clocks, conflict resolution)
  - TypeScript code example for both packages
  - Links to package documentation
- Expand SciPix section with:
  - npm package reference alongside Rust crate
  - Feature list (multi-format, batch, content detection, PDF)
  - TypeScript client code example
  - Link to npm package README
- Update package count from 40+ to 45+

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-21 23:57:03 -05:00
Reuven
97301f6643 docs: add total downloads badge to README 
Add npm total downloads badge alongside monthly downloads.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-21 23:52:16 -05:00