mirror of https://github.com/ruvnet/ruflo.git synced 2026-09-14 14:01:28 +08:00

Files

T

Reuven 1ef889cb3a feat(ruflo-ruvllm): v0.2.0 — adopt plugin contract + cross-plugin tool ownership table (ADR-0001)

This plugin shares the ruvllm_* MCP family with two siblings. ADR-0001
makes the canonical ownership explicit so consumers don't reconcile
multiple stories about who owns which tool group.

Cross-plugin tool ownership:
- ruvllm_sona_create / _adapt → ruflo-intelligence ADR-0001 (4-step
  pipeline DISTILL phase)
- ruvllm_microlora_create / _adapt → ruflo-intelligence (DISTILL +
  CONSOLIDATE via --consolidate)
- ruvllm_hnsw_create / _add / _route → ruflo-agentdb ADR-0001 (WASM
  router, ~11 patterns; distinct from large-corpus embeddings_search)

This plugin is the canonical home for the LLM-config + chat-format
slice of the ruvllm_* surface.

- ADR-0001 (Proposed) at docs/adrs/0001-ruvllm-contract.md
- README adds Compatibility (pin v3.6), Cross-plugin tool ownership
  table (3 sibling-ADR cross-references with file:line citations),
  Namespace coordination (claims ruvllm-config; defers to ruflo-agentdb
  ADR-0001), Verification + Architecture Decisions
- plugin.json bumps 0.1.0 → 0.2.0; description names the multi-provider
  chat formats; keywords add mcp, local-inference, chat-templates
- scripts/smoke.sh — 10 structural checks: version + keywords, both
  skills + agent + command present, v3.6 pin, namespace coordination,
  ruvllm-config claimed, SONA cross-reference, MicroLoRA + DISTILL
  cross-reference, HNSW WASM router cross-reference, ADR Proposed,
  no wildcard tools

Verification: bash plugins/ruflo-ruvllm/scripts/smoke.sh → 10/10

Co-Authored-By: RuFlo <ruv@ruv.net>

2026-05-04 20:32:20 -04:00

3.3 KiB

Raw Blame History

ruflo-ruvllm

RuVLLM local inference with chat formatting, model configuration, MicroLoRA fine-tuning, and SONA real-time adaptation.

Install

/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-ruvllm@ruflo

Features

Model configuration: Generate optimal configs for local inference
MicroLoRA: Task-specific fine-tuning with lightweight adapters
SONA adaptation: Real-time neural adaptation (<0.05ms)
Chat formatting: Multi-provider prompt formatting (Claude, GPT, Gemini, Ollama, Cohere)
HNSW routing: Context retrieval for RAG pipelines (≤11 hot patterns; for large-corpus search see ruflo-agentdb embeddings_search)

Commands

/ruvllm -- Model status, adapters, and provider availability

Skills

llm-config -- Configure models, MicroLoRA, and SONA
chat-format -- Format prompts for different LLM providers

Compatibility

CLI: pinned to @claude-flow/cli v3.6 major+minor.
Verification: bash plugins/ruflo-ruvllm/scripts/smoke.sh is the contract.

Cross-plugin tool ownership

This plugin shares the ruvllm_* MCP family with two sibling plugins. Each tool group has a canonical owner; this plugin is the entry point for LLM-config + chat formatting:

Tool group	Canonical owner	This plugin's role
`ruvllm_sona_create`, `ruvllm_sona_adapt`	ruflo-intelligence ADR-0001 (4-step pipeline DISTILL phase)	Surfaces SONA in `llm-config` skill
`ruvllm_microlora_create`, `ruvllm_microlora_adapt`	ruflo-intelligence ADR-0001 (DISTILL + CONSOLIDATE phases via `--consolidate` flag)	Surfaces MicroLoRA in `llm-config` skill
`ruvllm_hnsw_create`, `ruvllm_hnsw_add`, `ruvllm_hnsw_route`	ruflo-agentdb ADR-0001 (WASM router, ≤11 patterns — distinct from large-corpus `embeddings_search`)	References from `chat-format` for context routing

Source: v3/@claude-flow/cli/src/mcp-tools/ruvllm-tools.ts:142, 169, 192, 222 (SONA + MicroLoRA) and :57-58 (HNSW WASM router with ~11 patterns cap).

Namespace coordination

This plugin owns the ruvllm-config AgentDB namespace (kebab-case, follows the convention from ruflo-agentdb ADR-0001 §"Namespace convention"). Reserved namespaces (pattern, claude-memories, default) MUST NOT be shadowed.

ruvllm-config stores model configurations, adapter manifests, and chat-format templates. Accessed via memory_* (namespace-routed).

Verification

bash plugins/ruflo-ruvllm/scripts/smoke.sh
# Expected: "10 passed, 0 failed"

Architecture Decisions

ADR-0001 — ruflo-ruvllm plugin contract (cross-plugin tool ownership table, namespace coordination, smoke as contract)

ruflo-intelligence — owns SONA + MicroLoRA in the 4-step pipeline
ruflo-agentdb — owns HNSW WASM router; namespace convention owner
ruflo-ruvector — sibling substrate plugin (pinned ruvector@0.2.25)
ruflo-rag-memory — consumes RAG context routing

3.3 KiB Raw Blame History