Skip to content

armgit / ruflo

Public Imported from GitHub
0

🌊 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

feat(mods): guard secret-bearing MCP tools named in ADR-450 T6

ruvd973e2f93053
diff --git a/plugins/ruflo-browser/.claude-plugin/plugin.json b/plugins/ruflo-browser/.claude-plugin/plugin.json
index 9b47172186..59d6069e6c 100644
--- a/plugins/ruflo-browser/.claude-plugin/plugin.json
+++ b/plugins/ruflo-browser/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
{
"name": "ruflo-browser",
"description": "Session-as-skill browser automation: Playwright + RVF cognitive containers + ruvector trajectories + AgentDB selector memory + AIDefence PII/injection gates As a mod (ADR-445 pattern): a tighten-only tool guard, a local slash command, and a status file the console shows.",
- "version": "0.3.1",
+ "version": "0.3.2",
"author": {
"name": "ruvnet",
"url": "https://github.com/ruvnet"
diff --git a/plugins/ruflo-browser/hooks/guard.ts b/plugins/ruflo-browser/hooks/guard.ts
index c10876e76e..4a1ff3f28f 100644
--- a/plugins/ruflo-browser/hooks/guard.ts
+++ b/plugins/ruflo-browser/hooks/guard.ts
@@ -1,5 +1,5 @@
import type { ModOptions } from './options'
-import { splitName } from './screen'
+import { hasSecret, splitName, textsOf } from './screen'
export type Verdict = { readonly rule: string; readonly reason: string }
@@ -8,6 +8,8 @@ const READS = /document\s*(?:\.\s*cookie|\[\s*['"`]cookie['"`]\s*\])|\b(?:local|
const SINKS = /\b(?:fetch|XMLHttpRequest|sendBeacon|WebSocket|EventSource|importScripts)\b|new\s+Image\b|\.src\s*=(?!=)|\blocation(?:\s*\.\s*(?:href|assign|replace))?\s*(?:=(?!=)|\()|window\s*\.\s*open\b/
const METADATA = new Set(['169.254.169.254', 'metadata.google.internal', '[fd00:ec2::254]', 'metadata.azure.com', '100.100.100.200'])
const LOCAL = new Set(['localhost', '127.0.0.1', '[::1]'])
+// Tools that type or record caller-supplied text into a page or a stored session: a secret in their arguments leaves through the page.
+const TYPES = new Set(['browser_fill', 'browser_type', 'browser_session_record'])
const BAD_FLAGS = /^--(?:disable-web-security|remote-debugging-(?:port|address|pipe)|load-extension|disable-site-isolation-trials)\b/
/** Why a script is refused: it reads cookies or storage and also has a way to send them out. */
@@ -47,5 +49,8 @@ export function verdict(tool: string, input: unknown, opts: ModOptions): Verdict
if (parts.tool === 'browser_eval' && typeof args.script === 'string' && exfiltrates(args.script)) {
return refuse('exfiltration', 'this script reads cookies or storage and can send them off the page. Read them in one call, check them here, and never post them out.')
}
+ if (TYPES.has(parts.tool) && textsOf(args).some(hasSecret)) {
+ return refuse('secret', 'this call types what looks like a secret (a key, token or password) into a page or session record. Use a vaulted cookie handle (browser_cookie_use), not the value.')
+ }
return 'pass'
}
diff --git a/plugins/ruflo-browser/scripts/smoke.sh b/plugins/ruflo-browser/scripts/smoke.sh
index 7d47b7538d..40f5becb79 100755
--- a/plugins/ruflo-browser/scripts/smoke.sh
+++ b/plugins/ruflo-browser/scripts/smoke.sh
@@ -1,5 +1,5 @@
#!/usr/bin/env bash
-# Structural smoke test for ruflo-browser plugin v0.3.1.
+# Structural smoke test for ruflo-browser plugin v0.3.2.
# Verifies the file inventory, frontmatter, ADR cross-references, and
# AgentDB-namespace coverage that ADR-0001 contracts. Does NOT exercise
# the live MCP browser tools — the full Verification §1-§7 contract
@@ -15,10 +15,10 @@ ok() { printf "PASS\n"; PASS=$((PASS+1)); }
bad() { printf "FAIL: %s\n" "$1"; FAIL=$((FAIL+1)); }
# 1. plugin.json version + keywords
-step "plugin.json declares version 0.3.1 with new keywords"
+step "plugin.json declares version 0.3.2 with new keywords"
v=$(grep -E '"version"[[:space:]]*:' "$ROOT/.claude-plugin/plugin.json" | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)
-if [[ "$v" != "0.3.1" ]]; then
- bad "expected 0.3.1, got '$v'"
+if [[ "$v" != "0.3.2" ]]; then
+ bad "expected 0.3.2, got '$v'"
else
missing=""
for kw in rvf replay trajectory agentdb aidefence; do
diff --git a/plugins/ruflo-browser/tests/register.test.ts b/plugins/ruflo-browser/tests/register.test.ts
index 97dae161c9..5c85cda16f 100644
--- a/plugins/ruflo-browser/tests/register.test.ts
+++ b/plugins/ruflo-browser/tests/register.test.ts
@@ -63,6 +63,18 @@ describe('guard', () => {
expect(await evalJs('document.title')).toContain('stored')
})
+ test('browser_fill, browser_type and browser_session_record: a secret in the arguments is refused and never echoed; plain text passes', async ($, on) => {
+ world(on)
+ await $.session.start(START)
+ for (const name of ['fill', 'type', 'session_record']) {
+ const bad = await attempt($.tool.call({ tool: T(name), selector: '#pw', text: GH } as never))
+ expect(bad).toContain('secret')
+ expect(bad).not.toContain(GH)
+ expect(await attempt($.tool.call({ tool: T(name), selector: '#q', text: 'hello world' } as never))).toContain('stored')
+ }
+ expect(await attempt($.tool.call({ tool: T('fill'), selector: '#pw', value: { password: 'hunter2hunter2hunter2' } } as never))).toContain('secret')
+ })
+
test('strictUrls: on refuses plain http outside localhost', { options: { strictUrls: 'on' } }, async ($, on) => {
world(on)
await $.session.start(START)
diff --git a/plugins/ruflo-federation/.claude-plugin/plugin.json b/plugins/ruflo-federation/.claude-plugin/plugin.json
index 6cb4d8284f..442f147f1a 100644
--- a/plugins/ruflo-federation/.claude-plugin/plugin.json
+++ b/plugins/ruflo-federation/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
{
"name": "ruflo-federation",
"description": "Cross-installation agent federation with zero-trust security, peer discovery, consensus-based task routing, and per-call budget circuit breaker (ADR-097)",
- "version": "0.3.1",
+ "version": "0.3.2",
"author": {
"name": "ruvnet",
"url": "https://github.com/ruvnet"
diff --git a/plugins/ruflo-federation/hooks/guard.ts b/plugins/ruflo-federation/hooks/guard.ts
index 947c2efd06..9ccd93e064 100644
--- a/plugins/ruflo-federation/hooks/guard.ts
+++ b/plugins/ruflo-federation/hooks/guard.ts
@@ -4,7 +4,7 @@ import { hasSecret, textsOf } from './screen'
const tail = (name: string) => (name.startsWith('mcp__') ? name.slice(name.lastIndexOf('__') + 2) : name)
/** Federation tools that put content in front of another installation, plus a federation-namespaced memory write. */
-const OUTBOUND = /^(?:x_federation_(?:publish|channel_publish|sync)|federation_bbs_(?:publish|sync))$/
+const OUTBOUND = /^(?:x_federation_(?:publish|channel_publish|sync|invite_mint)|federation_bbs_(?:publish|sync))$/
/** US SSN, and a 13-16 digit run that passes the Luhn check and starts with a card network digit 2-6 (a card number; a 13-digit epoch-millisecond timestamp starts with 1 and must not read as one). */
const SSN = /\b\d{3}-\d{2}-\d{4}\b/
diff --git a/plugins/ruflo-federation/scripts/smoke.sh b/plugins/ruflo-federation/scripts/smoke.sh
index 73f8d16afa..933995fa36 100755
--- a/plugins/ruflo-federation/scripts/smoke.sh
+++ b/plugins/ruflo-federation/scripts/smoke.sh
@@ -7,9 +7,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 0.3.1 with new keywords"
+step "1. plugin.json declares 0.3.2 with new keywords"
v=$(grep -E '"version"' "$ROOT/.claude-plugin/plugin.json" | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)
-if [[ "$v" != "0.3.1" ]]; then bad "expected 0.3.1, got '$v'"; else
+if [[ "$v" != "0.3.2" ]]; then bad "expected 0.3.2, got '$v'"; else
miss=""
for k in mcp pii-pipeline audit-log; do
grep -q "\"$k\"" "$ROOT/.claude-plugin/plugin.json" || miss="$miss $k"
diff --git a/plugins/ruflo-federation/tests/mod.test.ts b/plugins/ruflo-federation/tests/mod.test.ts
index 288be8cc46..9e8796f249 100644
--- a/plugins/ruflo-federation/tests/mod.test.ts
+++ b/plugins/ruflo-federation/tests/mod.test.ts
@@ -45,6 +45,17 @@ describe('guard', () => {
expect(JSON.parse(w.files.get(STATUS) ?? '{}')).toMatchObject({ version: 1, guard: true, blocked: 1 })
})
+ test('x_federation_invite_mint is screened like the other outbound calls', async ($, on) => {
+ world(on)
+ on('tool.call', () => ({ result: 'went through' }))
+ await $.session.start(START)
+ const tool = 'mcp__plugin_ruflo-core_ruflo__x_federation_invite_mint'
+ const r = await $.tool.call(call({ tool, note: `token ${SECRET}` })).then(x => x, (e: unknown) => ({ text: String(e) }))
+ expect(denied(r)).toContain('ruflo-federation')
+ expect(denied(r)).not.toContain('ghp_')
+ expect(denied(await $.tool.call(call({ tool, note: 'for ops' })))).toContain('went through')
+ })
+
test('passes clean input and tools the plugin does not own', async ($, on) => {
world(on)
on('tool.call', () => ({ result: 'went through' }))
diff --git a/plugins/ruflo-rag-memory/.claude-plugin/plugin.json b/plugins/ruflo-rag-memory/.claude-plugin/plugin.json
index e25f9dcbb5..fc072f409b 100644
--- a/plugins/ruflo-rag-memory/.claude-plugin/plugin.json
+++ b/plugins/ruflo-rag-memory/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
{
"name": "ruflo-rag-memory",
"description": "RuVector memory with HNSW search, AgentDB, and semantic retrieval. As a mod (ADR-445): a write guard that keeps secrets out of memory, /rag-mod, and a status file the console shows",
- "version": "0.3.1",
+ "version": "0.3.2",
"author": {
"name": "ruvnet",
"url": "https://github.com/ruvnet"
diff --git a/plugins/ruflo-rag-memory/hooks/tools.ts b/plugins/ruflo-rag-memory/hooks/tools.ts
index 3090e825ad..af0ee5a64a 100644
--- a/plugins/ruflo-rag-memory/hooks/tools.ts
+++ b/plugins/ruflo-rag-memory/hooks/tools.ts
@@ -26,6 +26,7 @@ const OWNED = new Set([
/** The tools that put text somewhere durable or shared. A call through any of them is screened by the guard. */
const WRITERS = new Set([
'memory_store',
+ 'memory_import',
'agentdb_hierarchical-store',
'agentdb_pattern-store',
])
diff --git a/plugins/ruflo-rag-memory/scripts/smoke.sh b/plugins/ruflo-rag-memory/scripts/smoke.sh
index 70f9f9a4d9..12e8913da7 100755
--- a/plugins/ruflo-rag-memory/scripts/smoke.sh
+++ b/plugins/ruflo-rag-memory/scripts/smoke.sh
@@ -7,9 +7,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 0.3.1 with new keywords"
+step "1. plugin.json declares 0.3.2 with new keywords"
v=$(grep -E '"version"' "$ROOT/.claude-plugin/plugin.json" | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)
-if [[ "$v" != "0.3.1" ]]; then bad "expected 0.3.1, got '$v'"; else
+if [[ "$v" != "0.3.2" ]]; then bad "expected 0.3.2, got '$v'"; else
miss=""
for k in mcp claude-memories bridged-memory; do
grep -q "\"$k\"" "$ROOT/.claude-plugin/plugin.json" || miss="$miss $k"
diff --git a/plugins/ruflo-rag-memory/tests/rag.test.ts b/plugins/ruflo-rag-memory/tests/rag.test.ts
index 236974116c..3132ca75b6 100644
--- a/plugins/ruflo-rag-memory/tests/rag.test.ts
+++ b/plugins/ruflo-rag-memory/tests/rag.test.ts
@@ -51,6 +51,18 @@ describe('guard', () => {
expect(JSON.stringify(await $.tool.call(call('Bash', `echo ${SECRET}`)))).toContain('done')
})
+ test('memory_import: bulk imports are screened like a write', async ($, on) => {
+ world(on)
+ await $.session.start(START)
+ for (const name of ["memory_import"]) {
+ const tool = `mcp__plugin_ruflo-core_ruflo__${name}`
+ const denied = JSON.stringify(await attempt($.tool.call({ tool, data: { entries: [{ note: `token ${SECRET}` }] } } as never)))
+ expect(denied).toContain('secret')
+ expect(denied).not.toContain('ghp_')
+ expect(JSON.stringify(await $.tool.call({ tool, data: { entries: [{ note: 'a plain note' }] } } as never))).toContain('done')
+ }
+ })
+
test('guard: off lets the write through', { options: { guard: 'off' } }, async ($, on) => {
const w = world(on)
await $.session.start(START)
diff --git a/plugins/ruflo-rvf/.claude-plugin/plugin.json b/plugins/ruflo-rvf/.claude-plugin/plugin.json
index 18ac33c54c..1ad6ef1da8 100644
--- a/plugins/ruflo-rvf/.claude-plugin/plugin.json
+++ b/plugins/ruflo-rvf/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
{
"name": "ruflo-rvf",
"description": "RVF format for portable agent memory, session persistence, and cross-platform transfer. As a mod (ADR-445): a write guard that keeps secrets out of memory, sessions and transfers, /rvf-mod, and a status file the console shows",
- "version": "0.3.1",
+ "version": "0.3.2",
"author": {
"name": "ruvnet",
"url": "https://github.com/ruvnet"
diff --git a/plugins/ruflo-rvf/hooks/tools.ts b/plugins/ruflo-rvf/hooks/tools.ts
index 650a318f4e..427ccfb228 100644
--- a/plugins/ruflo-rvf/hooks/tools.ts
+++ b/plugins/ruflo-rvf/hooks/tools.ts
@@ -34,6 +34,9 @@ const OWNED = new Set([
const WRITERS = new Set([
'memory_store',
'session_save',
+ 'session_import',
+ 'memory_import',
+ 'config_import',
'hooks_session-end',
'hooks_transfer',
])
diff --git a/plugins/ruflo-rvf/scripts/smoke.sh b/plugins/ruflo-rvf/scripts/smoke.sh
index 25412e7d38..6e722edc05 100755
--- a/plugins/ruflo-rvf/scripts/smoke.sh
+++ b/plugins/ruflo-rvf/scripts/smoke.sh
@@ -7,9 +7,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 0.3.1 with new keywords"
+step "1. plugin.json declares 0.3.2 with new keywords"
v=$(grep -E '"version"' "$ROOT/.claude-plugin/plugin.json" | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)
-if [[ "$v" != "0.3.1" ]]; then bad "expected 0.3.1, got '$v'"; else
+if [[ "$v" != "0.3.2" ]]; then bad "expected 0.3.2, got '$v'"; else
miss=""
for k in mcp cognitive-containers lineage-tracking; do
grep -q "\"$k\"" "$ROOT/.claude-plugin/plugin.json" || miss="$miss $k"
diff --git a/plugins/ruflo-rvf/tests/rvf.test.ts b/plugins/ruflo-rvf/tests/rvf.test.ts
index 7c95741e7b..c75336e246 100644
--- a/plugins/ruflo-rvf/tests/rvf.test.ts
+++ b/plugins/ruflo-rvf/tests/rvf.test.ts
@@ -51,6 +51,18 @@ describe('guard', () => {
expect(JSON.stringify(await $.tool.call(call('Bash', `echo ${SECRET}`)))).toContain('done')
})
+ test('session_import, memory_import, config_import: bulk imports are screened like a write', async ($, on) => {
+ world(on)
+ await $.session.start(START)
+ for (const name of ["session_import","memory_import","config_import"]) {
+ const tool = `mcp__plugin_ruflo-core_ruflo__${name}`
+ const denied = JSON.stringify(await attempt($.tool.call({ tool, data: { entries: [{ note: `token ${SECRET}` }] } } as never)))
+ expect(denied).toContain('secret')
+ expect(denied).not.toContain('ghp_')
+ expect(JSON.stringify(await $.tool.call({ tool, data: { entries: [{ note: 'a plain note' }] } } as never))).toContain('done')
+ }
+ })
+
test('guard: off lets the write through', { options: { guard: 'off' } }, async ($, on) => {
const w = world(on)
await $.session.start(START)
diff --git a/plugins/ruflo-x-gateway/.claude-plugin/plugin.json b/plugins/ruflo-x-gateway/.claude-plugin/plugin.json
index 16b4a6d61f..f34b18d74c 100644
--- a/plugins/ruflo-x-gateway/.claude-plugin/plugin.json
+++ b/plugins/ruflo-x-gateway/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
{
"name": "ruflo-x-gateway",
"description": "Coordinate AI-agent swarms through signed federation messages, channels, and work claims. The remote Claude connector exposes a directory-safe Streamable HTTP MCP surface with OAuth-protected publishing and five ruv:// reference resources.",
- "version": "0.9.1",
+ "version": "0.9.2",
"author": {
"name": "ruvnet",
"url": "https://github.com/ruvnet"
diff --git a/plugins/ruflo-x-gateway/hooks/guard.ts b/plugins/ruflo-x-gateway/hooks/guard.ts
index a17ddbb3aa..32a5f9c460 100644
--- a/plugins/ruflo-x-gateway/hooks/guard.ts
+++ b/plugins/ruflo-x-gateway/hooks/guard.ts
@@ -10,9 +10,9 @@ const field = (input: unknown, key: string): string => {
return typeof v === 'string' ? v : ''
}
-const PUBLISH = new Set(['x_federation_publish', 'x_federation_channel_publish'])
+const PUBLISH = new Set(['x_federation_publish', 'x_federation_channel_publish', 'x_federation_invite_mint'])
-/** The label of a federation publish, else undefined: the guard only watches calls that put content on the swarm. */
+/** The label of a federation publish, else undefined: the guard only watches calls that put content on the swarm or mint a credential for it. */
export function watched(tool: string, _input: unknown): string | undefined {
const t = shortName(tool)
return PUBLISH.has(t) ? t.replace('x_federation_', '').replace('_', ' ') : undefined
diff --git a/plugins/ruflo-x-gateway/tests/mod.test.ts b/plugins/ruflo-x-gateway/tests/mod.test.ts
index 738bee41e6..6f5f2cb6d5 100644
--- a/plugins/ruflo-x-gateway/tests/mod.test.ts
+++ b/plugins/ruflo-x-gateway/tests/mod.test.ts
@@ -89,6 +89,17 @@ describe('guard', () => {
expect(await deny(() => $.tool.call(BAD))).toContain('done')
})
+ test('x_federation_invite_mint is screened: a secret in its arguments is refused, a plain mint passes', async ($, on) => {
+ world(on)
+ on('tool.call', () => ({ result: 'done' }))
+ await $.session.start(START)
+ const tool = 'mcp__plugin_ruflo-core_ruflo__x_federation_invite_mint'
+ const out = await deny(() => $.tool.call({ tool, channel: 'pub:ops', note: `key ${ghp}` } as never))
+ expect(out).toContain('secret')
+ expect(out).not.toContain(ghp)
+ expect(await deny(() => $.tool.call({ tool, channel: 'pub:ops', note: 'for the ops team' } as never))).toContain('done')
+ })
+
test('channel publish is screened too; roster and reads are not', async ($, on) => {
world(on)
on('tool.call', () => ({ result: 'done' }))