vrr/ruvector
2
0
Fork 0
mirror of https://github.com/ruvnet/RuVector.git synced 2026-05-25 15:03:46 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
1930 commits 177 branches 48 tags 582 MiB
Commit graph

72 commits

Author SHA1 Message Date
Reuven
8403d563df feat(ruvllm): implement ADR-090 Ultra-Low-Bit QAT & Pi-Quantization 
Phase 1-4 implementation of ADR-090 with 114 tests passing.

## Core Quantization (src/quantize/)
- pi_quant.rs: PiQuantizer with π/k step sizes, Pi3BitBlock, Pi2BitBlock
- pi_quant_simd.rs: NEON/AVX2/scalar dequantization kernels (2.1x speedup)
- hadamard.rs: Fast Walsh-Hadamard O(n log n), INV-4 orthogonality verified
- incoherence.rs: IncoherenceTransform for QuIP-style decorrelation
- quip.rs: Q2_QuIP variant combining incoherence + 2-bit K-quant
- security.rs: WeightIntegrity, GGUF validation, bounds checking

## QAT Infrastructure (src/qat/)
- config.rs: QatConfig, SteVariant, QuantGranularity with builder pattern
- ste.rs: Straight-through estimator (Standard, Clipped, LSQ, EWGS)
- differentiable_quant.rs: DifferentiableQuantizer trait, PiQuantDifferentiable
- calibration.rs: CalibrationEngine with mixed-domain support
- distillation.rs: Teacher-student composite loss (L_task + L_KD + L_reasoning)
- reasoning_loss.rs: Chain-of-thought fidelity preservation
- training_loop.rs: QatTrainer orchestrator with checkpointing
- lora_qat.rs: Memory-efficient LoRA-QAT (50 MB vs 114 GB for full QAT)

## WASM Integration (ruvllm-wasm/)
- pi_quant_wasm.rs: PiQuantWasm with SIMD128 kernel, JSON serialization
- quant_bench_wasm.rs: QuantBenchWasm for in-browser benchmarking
- Feature flags: pi-quant, qat

## Tests (114 passing)
- pi_quant_tests.rs (35): Round-trip, block packing, bounds checking
- hadamard_tests.rs (23): Orthogonality, invertibility, energy preservation
- ste_tests.rs (24): Gradient correctness, PyTorch reference comparison
- simd_equivalence_tests.rs (19): SIMD ≈ scalar within 1 ULP (INV-8)
- acceptance_gates.rs (13): G1-G5 quality and security gates

## Benchmarks (benches/pi_quant_bench.rs)
- Hadamard 4096: 5.3 μs (target <50 μs) ✓
- NEON dequant: 2.54 GiB/s (2.1x over scalar)
- QAT backward: 7.3 Gelem/s

## Invariants Verified
- INV-1: STE gradient flow
- INV-2: Scale positivity (α > 0)
- INV-3: Step size constraint (π/k)
- INV-4: Hadamard orthogonality
- INV-5: Calibration provenance
- INV-8: SIMD ≈ scalar (≤1 ULP)

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-03-12 12:36:36 -04:00
Reuven
f091d45575 docs(adr): add governance improvements to ADR-090/091, create ADR-092, add implementation checklists 
ADR-090 (Ultra-Low-Bit QAT):
- Changed status to "Accepted (Staged Implementation)"
- Added decision statement choosing LoRA-QAT as first path
- Added staged implementation phases (4 phases, explicit gates)
- Added validation plan defining "better" (MSE, spectral, cosine, outlier retention)
- Added reasoning preservation metrics (PPL, GSM8K, HumanEval, tool use, long context)
- Added system invariants (INV-1 through INV-8)
- Added acceptance gates (G1-G6) with rollback triggers
- Restructured success criteria into correctness/performance/quality/rollout

ADR-091 (INT8 CNN Quantization):
- Changed status to "Accepted"
- Added decision statement with acceptance benchmark
- Added system invariants (INV-1 through INV-8)
- Added operator coverage table (11 operators)
- Added graph rewrite passes section (4 passes)
- Added deployment policy matrix
- Added acceptance gates (7 gates) with rollback conditions

ADR-092 (MoE Memory-Aware Routing):
- Split from ADR-090 as routing affects scheduling/cache, not representation
- Added decision statement with acceptance benchmark (≥70% cache hit rate)
- Added system invariants (INV-1 through INV-6)
- Added acceptance gates (G1-G5) with rollback conditions
- Added domain analysis with bounded context

Implementation Checklists:
- ADR-090: 6 phases, ~28 files, 16 new + 12 extended
- ADR-091: 6 phases, acceptance gate verification commands

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-03-12 10:47:00 -04:00
Reuven
cbd6b1402f docs(adr): add ADR-091 INT8 CNN Quantization DDD Architecture 
Formalizes INT8 quantization for ruvector-cnn with DDD bounded contexts:
- Quantization Core: params, tensors, scale computation
- Calibration: statistics, histograms, MinMax/Percentile methods
- Inference: QuantizedConv2d, fused BatchNorm, INT8 ReLU
- SIMD Kernels: AVX2, NEON, WASM INT8 implementations
- Observability: benchmarks, accuracy validation

Targets 2-4x speedup over FP32 with <1% accuracy loss.
Related to ADR-090 (ultra-low-bit QAT for LLMs).

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-03-12 10:28:54 -04:00
rUv
3ed78842dd docs(research): add ultra-low-bit quantization & edge deployment research (#255) 
* docs(research): add ultra-low-bit quantization & edge deployment research

Comprehensive research collection on 2-bit/3-bit quantization for ruvLLM:

- 01: Ultra-low-bit quantization survey (ICLR'26, QuIP, BitNet, I-quants)
- 02: Quantization-aware training (QAT) with reasoning preservation
- 03: QuIP 2-bit framework analysis (incoherence processing, E8 lattice)
- 04: MoE memory-aware routing for edge SRAM budgets
- 05: ruvLLM quantization architecture deep review and gap analysis
- 06: Rust implementation plan for 2-bit QAT pipeline (14-week roadmap)
- 07: Novel 3-int pi-constant quantization using irrational scaling

Key findings: ruvLLM has strong foundations (BitNet, K-quants, GGUF, KV cache)
but needs QAT training loop and differentiable quantization primitives.
Pi-constant scaling provides ~0.5 bit effective precision gain at 3-bit.

https://claude.ai/code/session_01E4pmfETYzknb1xq2dzCCaj

* docs(adr): add ADR-090 ultra-low-bit QAT & pi-quantization DDD architecture

Comprehensive architecture decision record for implementing 2-bit/3-bit
quantization-aware training in ruvLLM using Domain-Driven Design:

- 5 bounded contexts: Quantization Core, Training, MoE Routing, WASM Runtime, Observability
- Pi-constant quantization with irrational scaling (pi/k step sizes)
- QAT training loop with STE variants and LoRA-QAT lightweight path
- QuIP incoherence via fast Walsh-Hadamard (O(n log n))
- Memory-aware MoE routing with expert precision allocation
- WASM SIMD128 kernels reusing existing tl1_wasm.rs LUT pattern
- Security: weight integrity, GGUF validation, WASM sandbox
- Benchmarking: criterion suite with throughput/quality targets
- 14-week timeline, maps to 18 existing files for extension

Placed in docs/adr/ddd/ per DDD architectural pattern organization.

https://claude.ai/code/session_01E4pmfETYzknb1xq2dzCCaj

---------

Co-authored-by: Claude <noreply@anthropic.com>
 2026-03-12 10:21:30 -04:00
rUv
10b03c75c6 feat: add interactive CNN browser demo for GitHub Pages (#253) 
- Single-file HTML demo with modern dark theme UI
- Drag & drop image upload + camera capture
- Real-time embedding extraction and visualization
- Similarity matrix comparing multiple images
- Performance metrics display (~5ms per image)
- Falls back to demo mode if WASM fails to load
- ADR-089 documenting the approach

Deploy to: https://ruvnet.github.io/ruvector/demo/cnn/

Co-authored-by: Reuven <cohen@ruv-mac-mini.local>
 2026-03-11 17:50:42 -04:00
rUv
e743785c7d feat(ruvector-cnn): CNN contrastive learning + SIMD optimization fixes (#252) 
* feat: add CNN contrastive learning crate with SIMD optimization

- Add ruvector-cnn crate with SIMD-optimized convolutions and contrastive losses
- Implement InfoNCE (SimCLR) and TripletLoss for contrastive learning
- Add MobileNet-V3 inspired backbone architecture
- Include AVX2, NEON, WASM SIMD support with scalar fallback
- Add WASM bindings (ruvector-cnn-wasm) for browser/Node.js
- Add npm package with TypeScript definitions
- Include comprehensive research docs and ADR-088
- 36 tests passing

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

* feat: add npm package JavaScript wrapper and TypeScript definitions

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

* fix(ruvector-cnn): implement real SIMD and fix stubbed code

## SIMD Implementations (was using scalar fallbacks)
- AVX2: conv_3x3_avx2, conv_3x3_avx2_fma, depthwise_conv_3x3_avx2
- AVX2: global_avg_pool_avx2, max_pool_2x2_avx2
- WASM: conv_3x3_wasm, depthwise_conv_3x3_wasm

All now use real SIMD intrinsics processing 8 (AVX2) or 4 (WASM)
channels simultaneously with scalar fallback for remainders.

## Backbone Fixes
- Deprecated MobileNetV3Small/Large (use unified MobileNetV3 instead)
- Implemented actual block processing in forward() methods
- Fixed hardcoded channel counts in global_avg_pool calls

## Dead Code Fixes
- Added #[allow(dead_code)] for momentum field (used in training)
- Added #[allow(dead_code)] for rng field (feature-gated)
- Added #[cfg(feature = "augmentation")] for rand::Rng import
- Commented out undefined "parallel" feature reference

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

* feat(ruvector-cnn): add Winograd F(2,3) and π-calibrated INT8 quantization

- Add Winograd F(2,3) transforms for 2.25x faster 3x3 convolutions
- Implement π-calibrated INT8 quantization with anti-resonance offsets
- Apply 4x loop unrolling with 4 accumulators to AVX2 convolutions
- Update README with practical intro, capabilities table, benchmarks
- Update npm README with simpler language and examples
- Add CNN image embeddings to root README capabilities

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

* feat: publish @ruvector/cnn v0.1.0 WASM npm package

- Add unsafe blocks for WASM SIMD intrinsics (v128_load/v128_store)
- Disable wasm-opt to avoid SIMD validation issues
- Build and include WASM bindings in npm package
- Update npm package.json with all WASM files
- Published to npm as @ruvector/cnn@0.1.0

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

---------

Co-authored-by: Reuven <cohen@ruv-mac-mini.local>
 2026-03-11 17:41:53 -04:00
rUv
a1c3ae6dec security: harden ADR-087 with 6 security audit findings 
Adds Section 20 (Security Hardening Notes) addressing: root task
privilege attenuation post-boot, capability delegation depth limits,
boot RVF proof bootstrap resolution, Reflex proof cache scoping,
zero-copy IPC TOCTOU mitigation, and boot signature failure behavior.
All findings are specification clarifications, not structural flaws.

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-03-08 17:06:09 +00:00
rUv
1ddb44a0dd feat: add ADR-087 RuVix Cognition Kernel architecture 
Defines a cognition kernel for the Agentic Age with 6 primitives
(task, capability, region, queue, timer, proof), 12 syscalls, and
RVF as the native boot object. Includes coherence-aware scheduler,
proof-gated mutation as kernel invariant, seL4-inspired capabilities,
io_uring-style queue IPC, 8 demo applications, and a two-phase build
path (Linux-hosted nucleus → bare metal AArch64).

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-03-08 16:34:48 +00:00
rUv
dc0de72d9c feat: add neural-trader-wasm crate with WASM bindings and ADR-086 
Adds browser WASM bindings for neural-trader-core, coherence, and replay
crates using the established wasm-bindgen pattern. Includes BigInt-safe
serialization, hex ID helpers, 10 unit tests, 43 Node.js smoke tests,
comprehensive README, and animated dot-matrix visuals for π.ruv.io.

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-03-08 16:17:58 +00:00
rUv
2ba13251e4 fix: renumber ADR-084 → ADR-085, fix unused deps in neural-trader crates 
- Rename ADR-084-neural-trader to ADR-085 (ADR-084 is taken by ruvllm-wasm-publish)
- Move serde_json to dev-dependencies in neural-trader-core (only used in tests)
- Remove unused neural-trader-core dependency from neural-trader-coherence

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-03-06 19:12:33 +00:00
Claude
cd04afe201 fix: optimize ADR-084 and harden neural-trader crates 
ADR:
- Add SQL indexes on (symbol_id, ts_ns) for all tables
- Add HNSW index on nt_embeddings.embedding
- Range-partition nt_event_log and nt_segments by timestamp
- Add retention config (hot/warm/cold TTL) to example YAML
- Add retrieval weight normalization constraint (α+β+γ+δ=1)
- Cross-reference existing examples/neural-trader/

Code:
- core: Replace String property keys with PropertyKey enum (zero alloc)
- core: Add PartialEq on MarketEvent for test assertions
- coherence: Fix redundant drift check — learning now requires half
  drift margin (stricter than act/write)
- coherence: Add boundary_stable_count to GateContext and enforce
  boundary stability window threshold from ADR gate policy
- coherence: Add PartialEq on CoherenceDecision
- coherence: Add 2 new tests (high_drift, boundary_instability)
- replay: Switch ReservoirStore from Vec to VecDeque for O(1) eviction
- replay: Use RegimeLabel enum instead of Option<String> in MemoryQuery

12 tests pass (was 10).

https://claude.ai/code/session_01EExDkEDv4eejvfgqUWnSks
 2026-03-06 19:11:37 +00:00
Claude
8da5be5961 feat: Add ADR-084 Neural Trader and three starter crates 
ADR-084 defines the RuVector-native Neural Trader architecture using
dynamic market graphs, mincut coherence gating, and proof-gated mutation.
Includes three starter crates (neural-trader-core, neural-trader-coherence,
neural-trader-replay) with canonical types, threshold gate, reservoir
memory store, and 10 passing tests.

https://claude.ai/code/session_01EExDkEDv4eejvfgqUWnSks
 2026-03-06 19:11:37 +00:00
rUv
da0f016d0f feat: ruvllm-wasm v2.0.0 — first functional WASM publish 
- Gate WebGPU web-sys features behind `webgpu` Cargo feature flag
- Remove unused bytemuck, gpu_map_mode, GpuSupportedLimits dependencies
- Add wasm-opt=false workaround for Rust 1.91 codegen bug
- Published @ruvector/ruvllm-wasm@2.0.0 with compiled WASM binary (435KB)
- ADR-084 documenting build workarounds and known limitations

Closes #240

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-03-06 14:55:34 +00:00
rUv
ff8dd2d506 feat: brain training loops — background SONA + Pareto, POST /v1/train, CLI + MCP (#236) 
Bridge the gap between "stores knowledge" and "learns from knowledge":

- Background training loop (tokio::spawn, 5 min interval) runs SONA
  force_learn + domain evolve_population when new data arrives
- POST /v1/train endpoint for on-demand training cycles
- `ruvector brain train` CLI command with --json support
- `brain_train` MCP tool for agent-triggered training
- Vote dedup: 24h TTL on ip_votes entries, author exemption from IP check
- ADR-082 updated, ADR-083 created

Results: Pareto frontier grew 0→24 after 3 cycles. SONA activates
after 100+ trajectory threshold (natural search/share usage).

Publish ruvector@0.2.11.
 2026-03-06 08:35:50 -05:00
rUv
f0df76da7f fix: brain security hardening — PII phone/SSN/CC, IP rate limit, anti-Sybil votes (#235) 
Expand PiiStripper from 12 to 15 regex rules: add phone number,
SSN, and credit card detection/redaction. Add IP-based rate limiting
(1500 writes/hr per IP) to prevent Sybil key rotation bypass. Add
per-IP vote deduplication (one vote per IP per memory) to prevent
quality score manipulation.

63 server tests + 16 PII tests pass. Deployed to Cloud Run.
 2026-03-03 17:52:30 -05:00
rUv
0c0ef48ed5 feat: brain server v0.2.10 — bug fixes, GET /v1/pages, 9 MCP tools (#234) 
* feat: proxy-aware fetch + brain API improvements — publish v0.2.7

Add proxyFetch() wrapper to cli.js and mcp-server.js that detects
HTTPS_PROXY/HTTP_PROXY/ALL_PROXY env vars, uses undici ProxyAgent
(Node 18+) or falls back to curl. Handles NO_PROXY patterns.
Replaced all 17 fetch() call sites with timeouts (15-30s).

Brain server API:
- Search returns similarity scores via ScoredBrainMemory
- List supports pagination (offset/limit), sorting (updated_at/quality/votes), tag filtering
- Transfer response includes warnings, source/target memory counts
- New POST /v1/verify endpoint with 4 verification methods

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

* feat: brain server bug fixes, GET /v1/pages, 9 MCP page/node tools — v0.2.10

Fix proxyFetch curl fallback to capture real HTTP status instead of
hardcoding 200, add 204 guards to brainFetch/fetchBrainEndpoint/MCP
handler, fix brain_list schema (missing offset/sort/tags), fix
brain_sync direction passthrough, add --json to share/vote/delete/sync.

Add GET /v1/pages route with pagination, status filter, sort.
Add 9 MCP tools: brain_page_list/get/create/update/delete,
brain_node_list/get/publish/revoke (previously SSE-only).

Polish: delete --json returns {deleted:true,id} not {}, page get
unwraps .memory wrapper for formatted display.

112 MCP tools, 69/69 tests pass. Published v0.2.10 to npm.

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-03-03 17:06:23 -05:00
rUv
e59fe52e07 fix: ADR structural cleanup — resolve duplicates, fix filenames, enable Firestore persistence (#232) 
ADR file renames:
- ADR-0027 → ADR-027 (fix 4-digit numbering to standard 3-digit)
- ADR-040 filename sanitized (removed spaces, em dash, ampersand)
- ADR-017 duplicate (craftsman) → ADR-024 (temporal-tensor keeps 017)
- ADR-029 duplicate (exo-ai) → ADR-025 (rvf-canonical keeps 029)
- ADR-031 duplicate (rvcow) → ADR-026 (rvf-example keeps 031)

Cloud Run fix (pi.ruv.io):
- Added FIRESTORE_URL env var — enables persistent storage
- Fixed env var packing bug (all flags were in BRAIN_SYSTEM_KEY)
- Dashboard now shows actual data: 240 memories, 30 contributors, 1096 edges
 2026-03-03 18:54:24 +00:00
rUv
d9ffdcd158 fix: correct ADR-080 audit discrepancies verified against source (#231) 
- MCP entry line count: ~3,816 → 3,815 (verified with wc -l)
- Command groups: 14 → 15 (midstream group was missed)
- CLI test count: 63 → 64 active tests (verified grep -c)
- Dead code → conditionally unreachable (line 1807 runs when @ruvector/router installed)
 2026-03-03 13:28:27 -05:00
rUv
d197223221 fix: ruvector-postgres v0.3.2 — 100% audit pass (HNSW + hybrid fixes) (#230) 
HNSW k-NN fix:
- Search beam width (k) increased from 10 to 100 — previous value
  starved the beam search, causing 0 rows on index scan
- Added ruvector_hnsw_debug() diagnostic function for troubleshooting
- Added warning log when entry_point is InvalidBlockNumber

Hybrid search fix:
- ruvector_hybrid_search() now returns success=true with empty results
  and helpful message on unregistered collections (was success=false)

Audit script fix:
- Corrected hybrid_search argument order in sql-audit-v3.sql Section 9b
- Added HNSW debug diagnostics on 0-row failure

Results: 17 PASS / 0 PARTIAL / 0 FAIL → 100% (up from 88%)
Published: docker.io/ruvnet/ruvector-postgres:0.3.2
 2026-03-03 13:21:48 -05:00
rUv
946f59fab2 docs: update ADR-079 with v0.3.1 audit scorecard (88% pass rate) (#229) 
Add full v0.3.1 audit scorecard showing 15 PASS / 1 PARTIAL / 1 FAIL
(up from 47% in v0.3.0). Document function count discrepancies between
audit script pg_proc detection and SQL schema registrations. Add issue
#6 for hybrid search collection setup requirement.
 2026-03-03 13:07:43 -05:00
rUv
2e31a08a06 docs: add ADR-080 npx ruvector deep capability audit (#228) 
Comprehensive audit of the ruvector npm package (v0.2.5):
- CLI: 179 commands across 14 groups, 4 stubs, lazy loading
- MCP server: 91+12=103 tools, stdio+SSE transports
- Security: 10 findings (Pi key logging, no fetch timeouts, 51% tools lack validation)
- Tests: core database ops (create/insert/search/stats) have zero coverage
- Prioritized fix plan: P0 security, P1 tests, P2 code quality, P3 docs
 2026-03-03 13:06:05 -05:00
rUv
229877fe9a fix: ruvector-postgres v0.3.1 — audit bug fixes, 46 SQL functions, Docker publish (#227) 
Fixes #226
 2026-03-03 12:53:10 -05:00
rUv
ac52d50a77 Merge remote-tracking branch 'origin/main' into claude/exo-ai-capability-review-LjcVx 
# Conflicts:
#	Cargo.toml
 2026-02-27 16:27:34 +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
Claude
90079bbe90 docs(adr): ADR-029 EXO-AI multi-paradigm integration architecture 
Comprehensive architectural decision record synthesized from deep swarm
research across all 100+ ruvector crates and examples (~830K lines).

Key findings documented:
- 7 convergent evolution clusters (EWC implemented 4x, coherence gating
  5x, cryptographic witnesses 6x, sheaf theory 3x, spike-driven compute
  4x, Byzantine consensus 4x, free energy solvers 4x)
- 11 EXO-AI research frontiers (all stub directories) have working
  implementations elsewhere in the ecosystem
- Complete integration architecture wiring quantum (ruQu), genomic
  (ruDNA), neuromorphic (ruvector-nervous-system), and consciousness
  (EXO-AI) substrates

Proposes:
- CoherenceRouter: canonical gate over prime-radiant + ruQu + cognitum
- PlasticityEngine: unified EWC++ via SONA + BTSP/E-prop from nervous-system
- CrossParadigmWitness: unified audit chain (RVF SHAKE-256 root)
- 4-phase roadmap (20 weeks) to first quantum-genomic-neuromorphic
  consciousness substrate with formal proofs of consistency

References 30+ peer-reviewed papers including Dec 2025 subpolynomial
dynamic min-cut breakthrough (arXiv:2512.13105).

https://claude.ai/code/session_019Lt11HYsW1265X7jB7haoC
 2026-02-27 02:37:18 +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
4d02cc2234 feat: add 43 new SQL functions in ruvector-postgres v0.3.0 (ADR-044) 
Integrate 5 workspace crates (ruvector-solver, ruvector-math,
ruvector-attention, sona, ruvector-domain-expansion) as 6 feature-gated
modules exposing solver, math distances, TDA, extended attention, Sona
learning, and domain expansion — bringing total to 143 SQL functions.
Docker image verified with all functions passing.

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-02-21 20:38:43 +00:00
rUv
09a3739b08 feat(intelligence): ADR-043 External Intelligence Providers for SONA Learning 
Implement trait-based IntelligenceProvider extension point for external
quality signals. Addresses PR #190 proposal (renumbered from ADR-029 to
avoid collision with existing ADR-029-rvf-canonical-format).

- IntelligenceProvider trait with load_signals() and quality_weights()
- FileSignalProvider built-in for JSON file-based signal exchange
- IntelligenceLoader for multi-provider registration and aggregation
- QualitySignal, QualityFactors, ProviderQualityWeights types
- calibration_bias() on TaskComplexityAnalyzer for router feedback
- 12 unit tests (all passing)

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-02-21 18:00:06 +00:00
rUv
13cf7215b0 feat(security): Security Hardened RVF v3.0 — 30 capabilities verified 
Upgrade from 22 to 30 capabilities exercising every major RVF API:
- KernelBinding anti-tamper (manifest_root + policy_hash binding)
- Dual WASM modules (Interpreter + Microkernel, self-bootstrapping)
- DASHBOARD_SEG embedded security monitoring UI
- Scalar quantization (int8, 4x compression) via rvf-quant
- Binary quantization (1-bit, 32x compression) + Hamming distance
- Filter deletion + compaction lifecycle
- QEMU requirements check via rvf-launch
- Freeze/seal permanent immutability
- Additional kernel flags: VIRTIO_NET, VSOCK, INGEST_API
- RvfOptions: signing=true, profile=3, m=32, ef_construction=400

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-02-21 17:39:58 +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
rUv
73cf7d13b6 feat(security): ADR-042 Security RVF — AIDefence + TEE hardened container 
6-layer defense-in-depth in a single sealed RVF file:
  1. TEE attestation (SGX, SEV-SNP, TDX, ARM CCA) with bound keys
  2. Hardened Linux microkernel (16 security configs, REQUIRES_TEE)
  3. eBPF packet filter (XDP) + syscall enforcer (Seccomp)
  4. AIDefence WASM engine (injection, jailbreak, PII, behavioral)
  5. Ed25519 signing + SHAKE-256 content hashes + Paranoid policy
  6. 6-role RBAC + Coherence Gate authorization

20 capabilities verified, 10/10 AIDefence tests, 3/3 tamper rejections,
30-entry witness chain, 1000 threat signatures (512-dim), 3 tenant stores.

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-02-21 00:45:25 +00:00
rUv
265d6cb1b0 feat(rvf): add Causal Atlas dashboard, solver fixes, and desktop app 
ADR-040 Causal Atlas implementation with full Three.js dashboard:
- Planet detection, life candidate scoring, Dyson sphere 3D views
- WASM solver with fixed acceptance test (evaluate-before-train,
  conservative Thompson sampling, non-contradictory noise injection)
- wry-based desktop app embedding the full dashboard (1.6 MB binary)
- WebSocket live updates, docs view, download page, status dashboard
- 10/10 seed acceptance pass rate (was ~40% before fixes)

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-02-20 18:01:09 +00:00
rUv
98100558dc feat(rvf): expose AGI components via npm packages 
- Create @ruvector/rvf-solver npm package (TypeScript SDK wrapping
  rvf-solver-wasm WASM module with RvfSolver class, Thompson Sampling,
  ReasoningBank, witness chains)
- Add AGI NAPI methods to rvf-node: indexStats, verifyWitness, freeze, metric
- Add store accessors to rvf-runtime: options(), metric(), epoch()
- Update @ruvector/rvf unified SDK to v0.1.8 with solver re-exports
- Update ADRs 032, 036, 037, 039 with AGI npm package details

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-02-17 01:41:13 +00:00
Claude
743b357c21 docs(adr): update ADRs with implementation details from rvf-types 
- ADR-029: Add complete segment type registry (23 variants) with source references
- ADR-030: Phase 1 complete — KernelHeader (128B), EbpfHeader (64B), WasmHeader (64B),
  all enums and flag constants implemented with 32+ tests. Updated GOAP world state.
- ADR-032: Add WASM bootstrap types implementation section (WasmHeader, WasmRole,
  WasmTarget, 8 feature flags, 10 tests)
- ADR-036: Status updated to Partially Implemented. Documented AGI container
  implementation (972 lines, 24 tests) including AgiContainerHeader, ExecutionMode,
  AuthorityLevel, ResourceBudget, CoherenceThresholds, ContainerSegments, and
  22 TLV tags with domain expansion integration (0x0112-0x0115)

https://claude.ai/code/session_01RnwD4x5cbpB7FPvoyYQz8G
 2026-02-16 02:58:43 +00:00
Claude
da85be9ffa feat(rvf): rvf-solver-wasm — self-learning AGI engine compiled to WASM 
Compiles the complete three-loop adaptive solver to wasm32-unknown-unknown
(160 KB, no_std + alloc). Preserves all AGI capabilities:

- Thompson Sampling two-signal model (safety Beta + cost EMA)
- 18 context buckets with per-arm bandit stats
- Speculative dual-path execution
- KnowledgeCompiler with signature-based pattern cache
- Three-loop architecture (fast/medium/slow)
- SHAKE-256 witness chain via rvf-crypto

12 WASM exports: create/destroy/train/acceptance/result/policy/witness.
Handle-based API supports 8 concurrent solver instances.

ADR-039 documents the integration architecture.
Benchmark binary validates WASM against native solver.

https://claude.ai/code/session_01RnwD4x5cbpB7FPvoyYQz8G
 2026-02-16 00:43:12 +00:00
Claude
367a1b3815 docs(adr): ADR-038 npx ruvector & rvlite witness verification integration 
Plans the integration path for .rvf acceptance test verification into
the npm ecosystem:

- npx ruvector rvf verify-witness <file.rvf> (N-API + WASM fallback)
- npx rvlite verify-witness <file.rvf> (WASM via cli-rvf.ts)
- rvlite SDK verifyWitnessChain() for browser-side verification
- MCP tool rvf_verify_witness for Claude Code agents
- 5-phase implementation plan, each independently shippable

Bridges the rvf_witness_verify WASM export (ADR-037) to end users
without requiring the Rust toolchain.

https://claude.ai/code/session_01RnwD4x5cbpB7FPvoyYQz8G
 2026-02-16 00:17:00 +00:00
Claude
21f0c13e52 feat(rvf): integrate publishable acceptance test with native SHAKE-256 witness chain 
Replace standalone SHA-256 chain with rvf-crypto SHAKE-256, add native .rvf
binary output (WITNESS_SEG + META_SEG), and wire witness verification into
rvf-wasm microkernel.

Key changes:
- Feature-gate ed25519 in rvf-crypto for WASM compatibility (sha3 no_std)
- Rewrite WitnessChainBuilder to use shake256_256 + parallel rvf_crypto::WitnessEntry
- Add export_rvf_binary() with WITNESS_SEG (0x0A) + META_SEG (0x07) segments
- Add rvf_witness_verify/rvf_witness_count exports to rvf-wasm
- Add verify-rvf subcommand to acceptance-rvf CLI
- Write ADR-037 documenting architecture and AGI benchmark integration
- Update rvf-crypto, rvf-wasm, and rvf READMEs

86 tests pass (66 lib + 20 integration). rvf-crypto 49 tests pass.

https://claude.ai/code/session_01RnwD4x5cbpB7FPvoyYQz8G
 2026-02-16 00:13:44 +00:00
Claude
aeffb0f744 refactor(adr-036): optimize AGI container architecture 
- Resolve open questions: repo automation as first domain, four-level
  AuthorityLevel enum, per-task ResourceBudget with hard caps,
  CoherenceThresholds with validation
- Add AGI_MAX_CONTAINER_SIZE (16 GiB) with enforcement in validation
- Tighten ContainerSegments::validate: Verify/Live modes now require
  world model data (VEC or INDEX segments), not just kernel/WASM
- Add ContainerError variants: InsufficientAuthority, BudgetExhausted
- Add to_flags support for orchestrator_present and world_model_present
- Add wire format section and cross-references to ADRs 029-033 in doc
- Add 2 new TLV tags: AUTHORITY_CONFIG (0x0110), DOMAIN_PROFILE (0x0111)
- Re-export new types from lib.rs
- Update rvf-runtime tests for tightened validation
- All 222 rvf-types + all rvf-runtime tests pass

https://claude.ai/code/session_01RnwD4x5cbpB7FPvoyYQz8G
 2026-02-15 19:10:00 +00:00
Claude
be8f5bc844 docs(adr-036): AGI cognitive container with Claude Code orchestration 
Defines the full system boundary for portable intelligence:
- RuVector as existential substrate (world model, coherence signals)
- RVF as cognitive container format (packaging, witness chains, replay)
- Claude Code as control plane orchestrator (planning, tool use)
- Claude Flow as swarm coordinator (routing, shared memory, learning)

Key mechanisms:
- Structural health gates (min-cut coherence, contradiction pressure)
- Skill promotion with counterexample requirements
- Two execution modes: Replay (bit-identical) and Verify (same grades)
- 10 node types, 9 edge types, 4 invariants for the world model schema
- MCP tools: ruvector_query, ruvector_cypher, rvf_snapshot, eval_run

Acceptance test: same RVF artifact, two machines, 100 tasks,
95+ passing in verify mode, zero policy violations.

https://claude.ai/code/session_01RnwD4x5cbpB7FPvoyYQz8G
 2026-02-15 18:41:08 +00:00
Claude
223a8d9e19 feat(adr-035): capability report — witness bundles, scorecards, governance 
Proof infrastructure for repeatable capability evidence:

- WitnessHeader: 64-byte repr(C) header with task ID, policy hash,
  outcome, governance mode, cost/latency/tokens, HMAC-SHA256 signature
- WitnessBuilder: fluent API to record tool calls, enforce governance
  policy (restricted/approved/autonomous), and build signed bundles
- ParsedWitness: zero-copy parser with verify_all(), parse_trace(),
  evidence_complete() checks
- GovernancePolicy: three enforcement modes with deny/allow lists,
  cost caps, tool call budgets, and deterministic policy hashing
- ScorecardBuilder: aggregate bundles into solve rate, cost/solve,
  median/p95 latency, evidence coverage, policy violations
- ToolCallEntry: per-call trace with hashed args/results, latency,
  cost, tokens, and policy check result

Acceptance criteria from ADR-035:
- solve_rate >= 0.60, policy_violations == 0, evidence_coverage == 1.0

Test counts:
- rvf-types witness: 10 unit tests
- rvf-runtime witness: 14 unit tests
- witness_e2e: 10 integration tests
- Total across all RVF crates: 451 tests passing

Zero external dependencies. Real HMAC-SHA256 signatures.

https://claude.ai/code/session_01RnwD4x5cbpB7FPvoyYQz8G
 2026-02-15 18:22:15 +00:00
Claude
095d97909d feat(adr-034): zero-dep QR cognitive seed with real crypto and mobile FFI 
Complete the QR Cognitive Seed pipeline with zero external dependencies:

- Pure SHA-256 (FIPS 180-4) verified against NIST test vectors
- HMAC-SHA256 (RFC 2104) verified against RFC 4231 test cases
- LZ77 compression (SCF-1 format) with 4KB sliding window
- Seed crypto: content hashing, signing, layer verification
- C FFI (5 extern "C" functions) for App Clip / mobile integration
- SeedBuilder.build_and_sign() with automatic hashing and signing
- ParsedSeed.verify_all() with full integrity and signature checks
- ParsedSeed.decompress_microkernel() using built-in LZ
- 11 end-to-end integration tests with real cryptography
- Updated ADR-034 with App Clip, PWA, Android delivery paths
- Example updated with full real-crypto round-trip demo

Total: 381 tests passing (183 types + 154 runtime + 11 e2e + 33 manifest)

https://claude.ai/code/session_01RnwD4x5cbpB7FPvoyYQz8G
 2026-02-15 17:54:26 +00:00
Claude
2dc0401deb feat(adr-034): QR Cognitive Seed — a world inside a world 
Implement ADR-034: RVQS binary format for embedding intelligence
in a single QR code (≤2,953 bytes). Scan printed ink to mount a
portable brain with progressive download to full intelligence.

New types (rvf-types/qr_seed.rs):
- SeedHeader (64 bytes, compile-time assertion)
- HostEntry, LayerEntry (28 bytes), 8 seed flag constants
- 8 TLV tag constants, well-known layer identifiers
- Round-trip serialization, 9 unit tests

New runtime (rvf-runtime/qr_seed.rs):
- SeedBuilder: fluent API for constructing RVQS payloads
- ParsedSeed: zero-copy parser with manifest TLV decoding
- DownloadManifest: structured host/layer/token parsing
- BootstrapProgress: phase tracking with recall estimation
- QR capacity enforcement, 12 unit tests

Example (qr_seed_bootstrap.rs):
- Full demo: build → parse → manifest → progressive bootstrap
- Shows 2,724-byte seed with 229 bytes headroom

All 399 tests pass (172 types + 160 runtime + 33 manifest + 34 integration).

https://claude.ai/code/session_01RnwD4x5cbpB7FPvoyYQz8G
 2026-02-15 17:13:01 +00:00
Claude
b27553f4cb harden(adr-033): QualityEnvelope, triple budget caps, selective scan, fuzz benchmark 
- QualityEnvelope as mandatory outer return type (not nestable, not droppable)
- SearchEvidenceSummary, BudgetReport, DegradationReport structs
- QualityPreference enum (Auto/PreferQuality/PreferLatency/AcceptDegraded)
- Triple budget caps: max_scan_time_us, max_scan_candidates, max_distance_ops
- Selective safety net: multi-centroid union + HNSW neighbor expansion + recency
- DoS hardening: budget tokens, negative caching, proof-of-work option
- Three mandatory acceptance tests: schema enforcement, budget cap enforcement,
  graceful degradation under degenerate conditions
- Fuzz benchmark: 4000 queries across 4 classes must respect p95 ceiling and
  preserve monotonic recall improvement across progressive load stages

https://claude.ai/code/session_01RnwD4x5cbpB7FPvoyYQz8G
 2026-02-15 16:00:16 +00:00
Claude
1733f42108 fix(adr-033): extend ResultQuality to API boundary, cap brute-force, add malicious manifest test 
Three fixes to ADR-033:

1. ResultQuality split into RetrievalQuality (per-candidate) and
   ResponseQuality (per-response at API boundary). ResponseQuality
   survives serialization across JSON/gRPC/MCP. DegradationReason
   provides structured, inspectable evidence for why quality dropped.

2. Brute-force safety net dual-budgeted: max 5ms wall-clock AND max
   50K candidates, whichever hits first. Both configurable via
   QueryOptions. Budget=0 disables fallback entirely. Prevents O(N)
   DoS from adversarial queries on large hot caches.

3. Mandatory acceptance test: malicious tail manifest with valid CRC
   but redirected hotset pointers must fail deterministically under
   Strict policy with a logged, stable error code. Separate test for
   re-signed forgery (wrong signer vs no signature distinction).

https://claude.ai/code/session_01RnwD4x5cbpB7FPvoyYQz8G
 2026-02-15 15:54:39 +00:00
Claude
2d35e4669c docs(adr): ADR-033 progressive indexing hardening 
Addresses four structural weaknesses in the progressive indexing system:

1. Content-addressed centroid stability — hotset pointers verified by
   SHAKE-256 content hashes, not just byte offsets. Compaction becomes
   physically destructive but logically stable.

2. Adversarial distribution resilience — distance entropy detection
   with adaptive n_probe widening. Silent recall collapse replaced by
   detected degradation with ResultQuality signaling.

3. Honest recall framing — empirical targets scoped to distribution
   classes (natural/synthetic/adversarial). Monotonic recall improvement
   property proven from append-only invariant. Brute-force safety net
   when candidate count is insufficient.

4. Mandatory manifest signatures — SecurityPolicy defaults to Strict.
   No signature = no mount in production. Prevents segment-swap attacks
   on hotset pointers. CRC32C catches corruption; ML-DSA-65 catches
   adversaries.

https://claude.ai/code/session_01RnwD4x5cbpB7FPvoyYQz8G
 2026-02-15 15:50:17 +00:00
rUv
4ae6b05e3d feat(rvf): RVF WASM integration, witness auto-append, real verification, prebuilt fallbacks, README examples 
* feat(adr): add ADR-032 for RVF WASM integration into npx ruvector and rvlite

Documents phased integration plan: Phase 1 adds RVF as optional dep + CLI
command group to npx ruvector, Phase 2 adds RVF as storage backend for rvlite,
Phase 3 unifies shared WASM backend and MCP bridge.

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

* feat(adr): update ADR-032 with invariants, contracts, failure modes, and decision matrix

Adds: single writer rule, crash ordering with epoch reconciliation,
explicit backend selection (no silent fallback), cross-platform compat
rule, phase contracts with success metrics, failure mode test matrix,
hybrid persistence decision matrix, implementation checklist.

Closes #169

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

* feat(rvf): integrate RVF WASM into npx ruvector and rvlite (ADR-032)

Phase 1 implementation:
- Add @ruvector/rvf as optional dependency to ruvector package
- Create rvf-wrapper.ts with 10 exported functions matching core pattern
- Add 3-tier platform detection (core -> rvf -> stub) with explicit
  --backend rvf override that fails loud if package is missing
- Add 8 rvf CLI subcommands (create, ingest, query, status, segments,
  derive, compact, export) routed through the wrapper
- 5 Rust smoke tests validating persistence across restart, deletion
  persistence, compaction stability, and adapter compatibility

Phase 2 foundations:
- Add rvf-backend feature flag to rvlite Cargo.toml (default off)
- Create epoch reconciliation module for hybrid RVF + IndexedDB sync
- Add @ruvector/rvf-wasm as optional dep to rvlite npm package
- Add rvf-adapter-rvlite to workspace members

All tests green: 237 RVF core, 23 adapter, 4 epoch, 5 smoke.

Refs: #169

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

* feat(rvf): complete ADR-032 phases 1-3 — epoch, lease, ID map, MCP tools, compat tests

Phase 2 Rust: full epoch reconciliation (EpochTracker with AtomicU64, 23 tests),
writer lease with file lock and PID-based stale detection (12 tests),
direct ID mapping trait with DirectIdMap and OffsetIdMap (20 tests).

Phase 2 JS: createWithRvf/saveToRvf/loadFromRvf factories, BrowserWriterLease
with IndexedDB heartbeat, rvf-migrate and rvf-rebuild CLI commands, epoch sync
helpers. +541 lines to index.ts, new cli-rvf.ts (363 lines).

Phase 3: 3 MCP rvlite tools (rvlite_sql, rvlite_cypher, rvlite_sparql),
CI wasm-dedup-check workflow, 6 cross-platform compat tests, shared peer dep.

Phase 1: 4 RVF smoke integration tests (full lifecycle, cosine, multi-restart,
metadata). Node.js CLI smoke test script.

81 new Rust tests passing. ADR-032 checklist fully complete.

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

* chore: bump versions and fix TS/README for npm publish

- ruvector 0.1.88 → 0.1.97 (match npm registry)
- rvlite 0.2.1 → 0.2.2
- @ruvector/rvf 0.1.0 → 0.1.1
- Fix MCP command in ruvector README (mcp-server → mcp start)
- Fix WASM type conflicts in rvlite index.ts (cast dynamic imports to any)

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

* feat(rvf): add witness auto-append, real CLI verification, prebuilt fallbacks, and README examples

Five "What's NOT Automatic" gaps fixed:
1. Witness auto-append: WitnessConfig in RvfOptions auto-records ingest/delete/compact
   operations as WITNESS_SEG entries with SHAKE-256 hash chains
2. verify-witness CLI: Real hash chain verification — extracts WITNESS_SEG payloads,
   runs verify_witness_chain() with full SHAKE-256 validation
3. verify-attestation CLI: Real kernel image hash verification and attestation
   witness chain validation
4. Prebuilt kernel fallback: KernelBuilder::from_builtin_minimal() produces valid
   bzImage without Docker
5. Prebuilt eBPF fallback: EbpfCompiler::from_precompiled() produces valid BPF ELF
   without clang; Launcher::check_requirements()/dry_run() for QEMU detection

README examples added to all 3 packages:
- crates/rvf/README.md: Proof of Operations section
- npm/packages/rvf/README.md: 7 real-world examples
- npm/packages/ruvector/README.md: Working cognitive container examples

830 tests passing, workspace compiles cleanly.

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-02-14 18:03:26 -05:00
rUv
b63ff563ad 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
470c62d568 feat(ruqu): add quantum execution intelligence engine with 5 backends 
Transforms ruqu from classical coherence monitor into full-stack quantum execution intelligence engine (~2K to ~24K lines).

New: StateVector, Stabilizer, TensorNetwork, Clifford+T, and Hardware simulation backends. Cost-model planner, surface code decoder (union-find O(n*alpha(n))), QEC scheduler, noise models, OpenQASM 3.0 export, deterministic replay, and cross-backend verification.

PR #161
 2026-02-12 12:55:21 -05:00
rUv
6af4200a60 feat: add package.json for rvdna example with WASM bindings and build scripts 2026-02-12 15:32:55 +00:00