mirror of
https://github.com/ruvnet/RuVector.git
synced 2026-05-23 21:25:02 +00:00
* 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> |
||
|---|---|---|
| .. | ||
| benchmarks | ||
| workflows | ||