mirror of
https://github.com/ruvnet/RuVector.git
synced 2026-08-24 08:03:45 +00:00
fe11269ed1
- #706: apply_micro_lora/apply_base_lora seeded their output buffer with zeros in napi.rs, napi_simple.rs, and wasm.rs, but the Rust LoRA forward pass has residual semantics (adds delta into the buffer). Cold queries collapsed to the zero vector, and post-feedback queries returned only the delta instead of input+delta. Fixed by seeding with a clone of the input in all three binding layers. Added regression tests. - #705: WasmBackend had no byte-level persistence. The underlying rvf_store_export/rvf_store_open C-ABI functions already existed — wired them into WasmBackend.exportBytes()/openBytes() and RvfDatabase.exportBytes()/openBytes(), verified against the real compiled .wasm binary. - #704: NodeBackend.ingestBatch() silently dropped RvfIngestEntry.metadata instead of forwarding it, and query() filter serialization omitted the native parser's required valueType. Since a full field-name-to-id design for metadata durability is a larger follow-up, applied the issue's own suggested interim fix: ingest now throws MetadataNotSupported instead of silently losing data. Filter serialization now infers and includes valueType. - #707: docs/api/NODEJS_API.md and docs/guides/ADVANCED_FEATURES.md advertised HybridSearch/FilteredSearch/MMRSearch/ConformalPredictor as Node exports; none are bound by crates/ruvector-node. Corrected with explicit "not yet shipped" notes pointing at the tracking issue. README corrections for #705/#707 (WasmRvfStore, HybridSearch docs) are staged separately — a repo hook requires a visual design-grade ritual for any README change that this session cannot complete (no browser/screenshot access), so they'll follow once that's resolved. |
||
|---|---|---|
| .. | ||
| README.md | ||
| rvf-browser.html | ||
| rvf-claude-appliance.ps1 | ||
| rvf-claude-appliance.sh | ||
| rvf-docker.sh | ||
| rvf-mcp-server.ps1 | ||
| rvf-mcp-server.sh | ||
| rvf-node-example.mjs | ||
| rvf-quickstart.ps1 | ||
| rvf-quickstart.sh | ||
RVF Platform Scripts
Environment-specific scripts for working with RVF across Linux, macOS, Windows, Node.js, browsers, and Docker.
Quick Start
| Script | Platform | What It Does |
|---|---|---|
rvf-quickstart.sh |
Linux / macOS | Create, ingest, query, branch, verify — 7 steps |
rvf-quickstart.ps1 |
Windows PowerShell | Same 7-step workflow for Windows |
rvf-node-example.mjs |
Node.js (any OS) | Full API walkthrough via @ruvector/rvf-node |
rvf-browser.html |
Browser (WASM) | Vector search in the browser, zero backend |
rvf-docker.sh |
Docker (any OS) | Containerized RVF CLI for CI/CD pipelines |
Claude Code Appliance
| Script | Platform | What It Does |
|---|---|---|
rvf-claude-appliance.sh |
Linux / macOS | Build the 5.1 MB self-booting appliance, optionally boot on QEMU |
rvf-claude-appliance.ps1 |
Windows PowerShell | Build via Docker Desktop, boot via WSL2 or Windows QEMU |
MCP Server for AI Agents
| Script | Platform | What It Does |
|---|---|---|
rvf-mcp-server.sh |
Linux / macOS | Start stdio or SSE MCP server for Claude Code, Cursor |
rvf-mcp-server.ps1 |
Windows PowerShell | Same MCP server on Windows |
Usage
# Linux / macOS
bash scripts/rvf-quickstart.sh
bash scripts/rvf-claude-appliance.sh
bash scripts/rvf-mcp-server.sh stdio
bash scripts/rvf-docker.sh
node scripts/rvf-node-example.mjs
open scripts/rvf-browser.html
# Windows PowerShell
.\scripts\rvf-quickstart.ps1
.\scripts\rvf-claude-appliance.ps1
.\scripts\rvf-mcp-server.ps1 -Transport stdio
node scripts\rvf-node-example.mjs
start scripts\rvf-browser.html
Prerequisites
| Script | Requires |
|---|---|
.sh scripts |
Rust 1.87+, cargo |
.ps1 scripts |
Rust 1.87+, cargo |
rvf-claude-appliance.* |
+ Docker (for kernel build) |
rvf-node-example.mjs |
Node.js 18+, npm install @ruvector/rvf-node |
rvf-browser.html |
Any modern browser |
rvf-docker.sh |
Docker |
rvf-mcp-server.* |
Node.js 18+ |