Squashed 'vendor/ruvector/' content from commit b64c2172

git-subtree-dir: vendor/ruvector
git-subtree-split: b64c21726f2bb37286d9ee36a7869fef60cc6900

examples/rvf/scripts/rvf-quickstart.sh

@@ -0,0 +1,52 @@
+#!/usr/bin/env bash
+# rvf-quickstart.sh — Linux / macOS RVF quick start
+# Usage: bash scripts/rvf-quickstart.sh
+set -euo pipefail
+
+echo "=== RVF Quick Start (Linux/macOS) ==="
+
+# ── 1. Install ──────────────────────────────────────────────
+echo "[1/7] Installing RVF CLI and runtime..."
+cargo install rvf-cli 2>/dev/null || echo "  (already installed)"
+echo "  rvf version: $(rvf --version 2>/dev/null || echo 'build from source below')"
+
+# ── 2. Create a vector store ────────────────────────────────
+echo "[2/7] Creating vector store..."
+rvf create demo.rvf --dimension 128
+echo "  Created demo.rvf (128-dim, L2 metric)"
+
+# ── 3. Ingest vectors from JSON ─────────────────────────────
+echo "[3/7] Ingesting vectors..."
+cat > /tmp/rvf_vectors.json <<'VECTORS'
+[
+  {"id": 1, "vector": [0.1, 0.2, 0.3], "metadata": {"label": "alpha"}},
+  {"id": 2, "vector": [0.4, 0.5, 0.6], "metadata": {"label": "beta"}},
+  {"id": 3, "vector": [0.7, 0.8, 0.9], "metadata": {"label": "gamma"}}
+]
+VECTORS
+rvf ingest demo.rvf --input /tmp/rvf_vectors.json --format json
+echo "  Ingested 3 vectors"
+
+# ── 4. Query nearest neighbors ──────────────────────────────
+echo "[4/7] Querying nearest neighbors..."
+rvf query demo.rvf --vector "0.1,0.2,0.3" --k 2
+echo "  Top-2 results returned"
+
+# ── 5. Inspect segments ─────────────────────────────────────
+echo "[5/7] Inspecting file segments..."
+rvf inspect demo.rvf
+
+# ── 6. Derive a child (COW branch) ──────────────────────────
+echo "[6/7] Creating COW branch..."
+rvf derive demo.rvf child.rvf --type filter
+echo "  child.rvf inherits parent data, only stores changes"
+
+# ── 7. Verify witness chain ─────────────────────────────────
+echo "[7/7] Verifying tamper-evident witness chain..."
+rvf verify-witness demo.rvf
+echo "  Witness chain verified — no tampering detected"
+
+echo ""
+echo "=== Done ==="
+echo "Files created: demo.rvf, child.rvf"
+echo "Next: embed a kernel with 'rvf embed-kernel demo.rvf --arch x86_64'"