🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
TypeScript agentic-aiagentic-frameworkagentic-workflowagentsai-agentsai-assistantai-skillsautonomous-agentsclaudecodexdsh-pluginharnessmcp-servermulti-agentmulti-agent-systemsnpmskillsswarmswarm-intelligencetypescript
feat(ruflo-console): 0.21.0 — AgentDB synthesize, intent route and pathfinder reads; ADR-419 coverage audit
ruv6739a52786d6
diff --git a/plugins/ruflo-console/.claude-plugin/plugin.json b/plugins/ruflo-console/.claude-plugin/plugin.jsonindex d419d5670c..d45b5f94d3 100644--- a/plugins/ruflo-console/.claude-plugin/plugin.json+++ b/plugins/ruflo-console/.claude-plugin/plugin.json@@ -1,7 +1,7 @@{"name": "ruflo-console","description": "ruflo's cockpit inside Claude Code and the one /ruflo command for every ruflo mod (function hooks, early access). Views: overview with health alerts, swarm topology graph, claims flow with TTL rings, federation map, plugin health matrix, learning curve and pipeline, MetaHarness radar and audit trend, memory, cost gauge, agent timeline, approvals queue, event stream, a main menu, an x.ruv.io federation board, an AI terminal (codex, claude or both in remembered sessions, streamed), Skills (npx skills), a Hive-Mind view, a MetaHarness lab, agent drill-down; a command palette for confirm-gated actions through the ruflo CLI; a band above the prompt. Reads ruflo's files and the CLI's local JSON; anything not measured reads n/a; no network by default.",- "version": "0.20.0",+ "version": "0.21.0","author": {"name": "ruvnet","url": "https://github.com/ruvnet"diff --git a/plugins/ruflo-console/hooks/memory-lab.ts b/plugins/ruflo-console/hooks/memory-lab.tsindex 9511bd9d42..1f9cac4c6d 100644--- a/plugins/ruflo-console/hooks/memory-lab.ts+++ b/plugins/ruflo-console/hooks/memory-lab.ts@@ -146,6 +146,9 @@ export const MEM_LAB: readonly MemEntry[] = [{ id: 'mem-pattern-search', group: 'agentdb', name: 'PATTERN SEARCH', about: 'the ReasoningBank patterns nearest the text', label: 'pattern search <text>: nearest ReasoningBank patterns', cost: 'read', takes: 'text', args: input => (input.text === undefined ? null : tool('agentdb_pattern-search', { query: input.text, topK: 5 })) },{ id: 'mem-recall', group: 'agentdb', name: 'RECALL', about: 'hierarchical recall across working/episodic/semantic', label: 'hierarchical recall <text>: across the three tiers', cost: 'read', takes: 'text', args: input => (input.text === undefined ? null : tool('agentdb_hierarchical-recall', { query: input.text, topK: 5 })) },{ id: 'mem-graph', group: 'agentdb', name: 'GRAPH', about: 'the causal graph two hops out from a node id', label: 'graph query <node>: k-hop, depth 2', cost: 'read', takes: 'node', args: input => (input.key === undefined ? null : tool('agentdb_graph-query', { nodeId: input.key, mode: 'k-hop', depth: 2, topK: 10 })) },+ { id: 'mem-synth', group: 'agentdb', name: 'SYNTHESIZE', about: 'a context brief assembled from the stored memories nearest the text', label: 'synthesize context <text>: a brief from the nearest memories', cost: 'read', takes: 'text', args: input => (input.text === undefined ? null : tool('agentdb_context-synthesize', { query: input.text, maxEntries: 10 })) },+ { id: 'mem-sroute', group: 'agentdb', name: 'INTENT ROUTE', about: 'which intent route the text falls under (AgentDB SemanticRouter)', label: 'intent route <text>: classify with the SemanticRouter', cost: 'read', takes: 'text', args: input => (input.text === undefined ? null : tool('agentdb_semantic-route', { input: input.text })) },+ { id: 'mem-path', group: 'agentdb', name: 'PATHFINDER', about: 'ranked graph paths from a node toward a question (personalized PageRank)', label: 'pathfinder <node> | <question>: ranked paths, depth 3', cost: 'read', takes: 'pair', args: input => (input.text === undefined || input.other === undefined ? null : tool('agentdb_graph-pathfinder', { seedNodeId: input.text.trim(), query: input.other, depth: 3, topK: 10, algorithm: 'personalized-pagerank' })) },{ id: 'mem-pattern-store', group: 'agentdb', name: 'PATTERN STORE', about: 'save the text as a ReasoningBank pattern', label: 'pattern store <text>: save a ReasoningBank pattern', cost: 'writes', takes: 'text', args: input => (input.text === undefined ? null : tool('agentdb_pattern-store', { pattern: input.text, type: 'console' })), note: '$0, local: writes one pattern to AgentDB' },{ id: 'mem-hstore', group: 'agentdb', name: 'TIER STORE', about: 'the store fields into the working tier', label: 'hierarchical store <namespace> <key> <value>: working tier', cost: 'writes', takes: 'kv', args: input => (input.key === undefined || input.value === undefined ? null : tool('agentdb_hierarchical-store', { key: input.key, value: input.value, tier: 'working' })), note: '$0, local: writes one entry to the working tier (the namespace is not used by this tool)' },{ id: 'mem-edge', group: 'agentdb', name: 'CAUSAL EDGE', about: 'link two nodes: <source> <relation> <target>', label: 'causal edge <source> <relation> <target>: link two nodes', cost: 'writes', takes: 'edge', args: input => (input.key === undefined || input.other === undefined || input.relation === undefined ? null : tool('agentdb_causal-edge', { sourceId: input.key, targetId: input.other, relation: input.relation })), note: '$0, local: writes one edge to the AgentDB causal graph' },diff --git a/plugins/ruflo-console/scripts/smoke.sh b/plugins/ruflo-console/scripts/smoke.shindex 359b676c8b..93d09f0d72 100755--- a/plugins/ruflo-console/scripts/smoke.sh+++ b/plugins/ruflo-console/scripts/smoke.sh@@ -11,9 +11,9 @@ step() { printf "→ %s ... " "$1"; }ok() { printf "PASS\n"; PASS=$((PASS+1)); }bad() { printf "FAIL: %s\n" "$1"; FAIL=$((FAIL+1)); }-step "1. plugin.json declares ruflo-console 0.20.0"+step "1. plugin.json declares ruflo-console 0.21.0"grep -q '"name": "ruflo-console"' "$ROOT/.claude-plugin/plugin.json" \- && grep -q '"version": "0.20.0"' "$ROOT/.claude-plugin/plugin.json" && ok || bad "name/version"+ && grep -q '"version": "0.21.0"' "$ROOT/.claude-plugin/plugin.json" && ok || bad "name/version"step "2. hooks.json names exactly one module and no classic hook commands"grep -q '"modules": \["./register.ts"\]' "$HOOKS/hooks.json" && ! grep -q '"command"' "$HOOKS/hooks.json" \diff --git a/plugins/ruflo-console/tests/memory-lab.spec.ts b/plugins/ruflo-console/tests/memory-lab.spec.tsindex c206b0c364..62b9c1e30d 100644--- a/plugins/ruflo-console/tests/memory-lab.spec.ts+++ b/plugins/ruflo-console/tests/memory-lab.spec.ts@@ -72,6 +72,9 @@ describe('the memory lab catalog', () => {expect(args('mem-cleanup-plan')).toEqual(['mcp', 'exec', '-t', 'memory_cleanup', '-p', '{"dryRun":true}'])expect(args('mem-cleanup')).toEqual(['mcp', 'exec', '-t', 'memory_cleanup', '-p', '{"dryRun":false}'])expect(args('mem-import-all')).toEqual(['mcp', 'exec', '-t', 'memory_import_claude', '-p', '{"allProjects":true}'])+ expect(args('mem-synth', 'token rotation')).toEqual(['mcp', 'exec', '-t', 'agentdb_context-synthesize', '-p', '{"query":"token rotation","maxEntries":10}'])+ expect(args('mem-sroute', 'fix the login bug')).toEqual(['mcp', 'exec', '-t', 'agentdb_semantic-route', '-p', '{"input":"fix the login bug"}'])+ expect(args('mem-path', 'entity:auth | why does login fail')).toEqual(['mcp', 'exec', '-t', 'agentdb_graph-pathfinder', '-p', '{"seedNodeId":"entity:auth","query":"why does login fail","depth":3,"topK":10,"algorithm":"personalized-pagerank"}'])expect(args('mem-graph', 'beta')).toEqual(['mcp', 'exec', '-t', 'agentdb_graph-query', '-p', '{"nodeId":"beta","mode":"k-hop","depth":2,"topK":10}'])expect(args('mem-edge', 'auth-bug causes login-fail')).toEqual(['mcp', 'exec', '-t', 'agentdb_causal-edge', '-p', '{"sourceId":"auth-bug","targetId":"login-fail","relation":"causes"}'])expect(args('mem-compare', 'jwt | token')).toEqual(['mcp', 'exec', '-t', 'embeddings_compare', '-p', '{"text1":"jwt","text2":"token","metric":"cosine"}'])diff --git a/v3/docs/adr/ADR-419-console-agentdb-reads-and-coverage-audit.md b/v3/docs/adr/ADR-419-console-agentdb-reads-and-coverage-audit.mdnew file mode 100644index 0000000000..8a1e78ebbc--- /dev/null+++ b/v3/docs/adr/ADR-419-console-agentdb-reads-and-coverage-audit.md@@ -0,0 +1,48 @@+# ADR 419: Three more AgentDB reads in the Memory Lab, and a coverage audit of the knowledge and automation surfaces++Status: Accepted (ships in ruflo-console 0.21.0)++Date: 2026 10 03++Decision owner: Ruflo maintainers++Scope: `plugins/ruflo-console`: `hooks/memory-lab.ts` (the catalog), `tests/memory-lab.spec.ts`.++Extends: ADR 407, ADR 411 (the plugin map). Companion to ADR 412.++## 1. Context++The roadmap listed "dedicated surfaces" for knowledge and memory, and for autonomy and workflows. Before building any, the tools were compared with what the console already reaches.++## 2. Audit++- **Memory Lab** already reaches 31 entries: stats, detailed stats, bridge, health, controllers, list, search, unified search, pattern search and store, hierarchical recall and store, graph query, causal edge, consolidate, embeddings (generate, compare, init, status, search), RaBitQ (build, search, status), import, export, migrate, compress, cleanup (plan first), delete.+- **Automation** already reaches workflows (list, status, template, create, validate, execute, pause, resume, cancel), the twelve workers and the daemon, all ten autopilot tools (status, enable, disable, reset, predict, learn, log, history, progress, config), sessions, config and tasks.+- **Not reached**: `agentdb_context-synthesize`, `agentdb_semantic-route` and `agentdb_graph-pathfinder` (reads); `agentdb_feedback`, `agentdb_batch` and the two deletes (writes).++A second surface for knowledge or for automation would duplicate rows that already exist, so none is built.++## 3. Decision++Add the three missing **reads** to the Memory Lab's AgentDB group; nothing else changes.++| Row | Tool | Takes |+|---|---|---|+| SYNTHESIZE | `agentdb_context-synthesize` | text (a brief from the 10 nearest memories) |+| INTENT ROUTE | `agentdb_semantic-route` | text (which intent route it falls under) |+| PATHFINDER | `agentdb_graph-pathfinder` | `<node> \| <question>` (personalized PageRank, depth 3, top 10) |++Each runs at once (reads, $0, local), with fixed argv through `mcp exec -t`. The writes stay out: `agentdb_feedback` is what the learning loop already records through hooks, and the two deletes are destructive and have no undo; they remain a terminal action.++## 4. Alternatives considered++- **A new knowledge view.** Rejected: it would split search and graph work across two pages and repeat existing rows.+- **Adding feedback and delete rows now.** Deferred: feedback needs a task id and scores a person would have to invent; deletes need their own confirm wording (ADR 412).++## 5. Safety++Reads only; no secret read or shown; no spend. The pathfinder's seed and question travel as JSON parameters of a fixed argv, never through a shell.++## 6. Tests++`tests/memory-lab.spec.ts`: the catalog invariants (unique `mem-` ids, one fixed argv each, no shell, reads read-only) now cover the three rows, and each has an exact-argv assertion.