Files
Reuven 6e1bdc211e fix(plugins): pin ruflo-ruvector to ruvector@0.2.25 + expand verified CLI surface
The plugin's docs had drifted from the real ruvector CLI: many documented
invocations (`embed "TEXT"`, `compare`, `cluster --namespace`, `hooks route
--task`, `brain agi status`, `midstream status`, `index create/stats`,
`embed --model poincare`) failed with "unknown command" or "unknown option"
on the installed ruvector. Probed every subcommand against ruvector@0.2.25
and rewrote the plugin to match reality.

Changes:
- Pin every `npx ruvector` call to `npx -y ruvector@0.2.25` across README,
  agent, skills, and commands
- Rewrite commands/vector.md with 80+ verified subcommands (embed, db
  lifecycle, RVF cognitive containers, GNN, attention mechanisms, hooks,
  native/workers, brain, SONA, LLM, identity, edge, server, decompile, demo)
- Add vector-setup skill that installs onnx-embeddings-wasm + pi-brain +
  ruvllm and registers the MCP server with the pinned version
- Add scripts/smoke.sh — 11-check contract test (version pin, top-level
  surface, positional-arg invariants, removed-surface-stays-removed)
- Replace stale "Search Capabilities (v2.1+)" table claiming FlashAttention-3
  / Graph RAG / DiskANN / ColBERT / Matryoshka / MLA / TurboQuant as CLI
  features with an "Attention Mechanisms" table mapped to real
  `attention compute|benchmark|hyperbolic` invocations
- Document known 0.2.25 bugs: `optimize` not yet shipped, `hooks force-learn`
  TypeError, `hooks graph-mincut` undefined.length, `benchmark` dimension bug,
  top-level `cluster` "Coming Soon"
- Add ADR-0001 documenting the pin policy, optional add-on packages, MCP
  registration, removed-surface contract, and smoke-test gate
- Bump plugin version 0.2.0 → 0.2.1

Smoke: 11/11 passing against ruvector@0.2.25.

Co-Authored-By: RuFlo <ruv@ruv.net>
2026-05-04 15:56:58 -04:00
..