claude-flow 3.7.0-alpha.3 → 3.7.0-alpha.30
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/agents/dual-mode/codex-coordinator.md +34 -29
- package/.claude/agents/dual-mode/codex-worker.md +39 -32
- package/.claude/helpers/hook-handler.cjs +4 -1
- package/.claude/helpers/statusline.cjs +26 -5
- package/.claude/scheduled_tasks.lock +1 -0
- package/.claude/settings.json +2 -0
- package/.claude/settings.local.json +10 -1
- package/.claude/skills/browser/SKILL.md +204 -0
- package/.claude/skills/github-project-management/SKILL.md +13 -0
- package/.claude/skills/verification-quality/SKILL.md +117 -73
- package/.claude-plugin/hooks/hooks.json +6 -5
- package/.claude-plugin/marketplace.json +3 -3
- package/.claude-plugin/scripts/ruflo-hook.sh +33 -0
- package/README.md +43 -39
- package/package.json +8 -2
- package/v3/@claude-flow/cli/README.md +43 -39
- package/v3/@claude-flow/cli/bin/cli.js +15 -2
- package/v3/@claude-flow/cli/bin/mcp-server.js +1 -1
- package/v3/@claude-flow/cli/dist/src/commands/agent-wasm.js +2 -2
- package/v3/@claude-flow/cli/dist/src/commands/daemon.d.ts +20 -0
- package/v3/@claude-flow/cli/dist/src/commands/daemon.js +338 -3
- package/v3/@claude-flow/cli/dist/src/commands/doctor.js +224 -46
- package/v3/@claude-flow/cli/dist/src/commands/hive-mind.js +25 -7
- package/v3/@claude-flow/cli/dist/src/commands/hooks.js +56 -29
- package/v3/@claude-flow/cli/dist/src/commands/memory.js +90 -3
- package/v3/@claude-flow/cli/dist/src/commands/start.js +1 -1
- package/v3/@claude-flow/cli/dist/src/commands/swarm.js +1 -1
- package/v3/@claude-flow/cli/dist/src/commands/task.js +8 -4
- package/v3/@claude-flow/cli/dist/src/config-adapter.js +1 -1
- package/v3/@claude-flow/cli/dist/src/index.d.ts +5 -1
- package/v3/@claude-flow/cli/dist/src/index.js +61 -18
- package/v3/@claude-flow/cli/dist/src/init/executor.js +92 -0
- package/v3/@claude-flow/cli/dist/src/init/helpers-generator.js +6 -2
- package/v3/@claude-flow/cli/dist/src/init/mcp-generator.js +4 -4
- package/v3/@claude-flow/cli/dist/src/init/settings-generator.js +44 -17
- package/v3/@claude-flow/cli/dist/src/init/statusline-generator.js +25 -14
- package/v3/@claude-flow/cli/dist/src/init/types.d.ts +7 -0
- package/v3/@claude-flow/cli/dist/src/mcp-client.js +12 -0
- package/v3/@claude-flow/cli/dist/src/mcp-tools/agent-execute-core.d.ts +3 -2
- package/v3/@claude-flow/cli/dist/src/mcp-tools/agent-execute-core.js +16 -9
- package/v3/@claude-flow/cli/dist/src/mcp-tools/agent-tools.js +88 -11
- package/v3/@claude-flow/cli/dist/src/mcp-tools/agentdb-tools.d.ts +3 -0
- package/v3/@claude-flow/cli/dist/src/mcp-tools/agentdb-tools.js +206 -21
- package/v3/@claude-flow/cli/dist/src/mcp-tools/analyze-tools.js +6 -6
- package/v3/@claude-flow/cli/dist/src/mcp-tools/autopilot-tools.js +10 -10
- package/v3/@claude-flow/cli/dist/src/mcp-tools/browser-session-tools.js +5 -5
- package/v3/@claude-flow/cli/dist/src/mcp-tools/browser-tools.js +23 -23
- package/v3/@claude-flow/cli/dist/src/mcp-tools/claims-tools.js +12 -12
- package/v3/@claude-flow/cli/dist/src/mcp-tools/config-tools.js +6 -6
- package/v3/@claude-flow/cli/dist/src/mcp-tools/coordination-tools.js +7 -7
- package/v3/@claude-flow/cli/dist/src/mcp-tools/daa-tools.js +8 -8
- package/v3/@claude-flow/cli/dist/src/mcp-tools/embeddings-tools.js +10 -10
- package/v3/@claude-flow/cli/dist/src/mcp-tools/github-tools.js +5 -5
- package/v3/@claude-flow/cli/dist/src/mcp-tools/guidance-tools.js +21 -21
- package/v3/@claude-flow/cli/dist/src/mcp-tools/hive-mind-tools.js +53 -9
- package/v3/@claude-flow/cli/dist/src/mcp-tools/hooks-tools.d.ts +2 -0
- package/v3/@claude-flow/cli/dist/src/mcp-tools/hooks-tools.js +183 -48
- package/v3/@claude-flow/cli/dist/src/mcp-tools/managed-agent-tools.d.ts +22 -0
- package/v3/@claude-flow/cli/dist/src/mcp-tools/managed-agent-tools.js +357 -0
- package/v3/@claude-flow/cli/dist/src/mcp-tools/memory-tools.js +400 -63
- package/v3/@claude-flow/cli/dist/src/mcp-tools/neural-tools.js +20 -7
- package/v3/@claude-flow/cli/dist/src/mcp-tools/performance-tools.js +6 -6
- package/v3/@claude-flow/cli/dist/src/mcp-tools/progress-tools.js +4 -4
- package/v3/@claude-flow/cli/dist/src/mcp-tools/ruvllm-tools.js +10 -10
- package/v3/@claude-flow/cli/dist/src/mcp-tools/security-tools.js +34 -9
- package/v3/@claude-flow/cli/dist/src/mcp-tools/session-tools.js +130 -6
- package/v3/@claude-flow/cli/dist/src/mcp-tools/swarm-tools.js +76 -7
- package/v3/@claude-flow/cli/dist/src/mcp-tools/system-tools.js +91 -18
- package/v3/@claude-flow/cli/dist/src/mcp-tools/task-tools.js +55 -7
- package/v3/@claude-flow/cli/dist/src/mcp-tools/terminal-tools.js +5 -5
- package/v3/@claude-flow/cli/dist/src/mcp-tools/transfer-tools.js +11 -11
- package/v3/@claude-flow/cli/dist/src/mcp-tools/wasm-agent-tools.js +11 -11
- package/v3/@claude-flow/cli/dist/src/mcp-tools/workflow-tools.js +118 -10
- package/v3/@claude-flow/cli/dist/src/memory/intelligence.js +28 -3
- package/v3/@claude-flow/cli/dist/src/memory/memory-bridge.d.ts +69 -0
- package/v3/@claude-flow/cli/dist/src/memory/memory-bridge.js +282 -5
- package/v3/@claude-flow/cli/dist/src/memory/memory-initializer.d.ts +8 -0
- package/v3/@claude-flow/cli/dist/src/memory/memory-initializer.js +80 -16
- package/v3/@claude-flow/cli/dist/src/memory/neural-package-bridge.d.ts +48 -0
- package/v3/@claude-flow/cli/dist/src/memory/neural-package-bridge.js +87 -0
- package/v3/@claude-flow/cli/dist/src/memory/sona-optimizer.js +3 -0
- package/v3/@claude-flow/cli/dist/src/parser.d.ts +9 -0
- package/v3/@claude-flow/cli/dist/src/parser.js +11 -0
- package/v3/@claude-flow/cli/dist/src/plugins/store/discovery.d.ts +6 -3
- package/v3/@claude-flow/cli/dist/src/plugins/store/discovery.js +11 -8
- package/v3/@claude-flow/cli/dist/src/ruvector/agent-wasm.js +4 -1
- package/v3/@claude-flow/cli/dist/src/ruvector/coverage-tools.js +6 -6
- package/v3/@claude-flow/cli/dist/src/ruvector/index.d.ts +0 -2
- package/v3/@claude-flow/cli/dist/src/ruvector/index.js +8 -2
- package/v3/@claude-flow/cli/dist/src/ruvector/model-router.d.ts +22 -1
- package/v3/@claude-flow/cli/dist/src/ruvector/model-router.js +125 -5
- package/v3/@claude-flow/cli/dist/src/services/headless-worker-executor.d.ts +6 -0
- package/v3/@claude-flow/cli/dist/src/services/headless-worker-executor.js +37 -3
- package/v3/@claude-flow/cli/dist/src/services/worker-daemon.d.ts +80 -2
- package/v3/@claude-flow/cli/dist/src/services/worker-daemon.js +372 -11
- package/v3/@claude-flow/cli/package.json +7 -5
- package/v3/@claude-flow/guidance/dist/analyzer.js +9 -0
- package/v3/@claude-flow/guidance/package.json +1 -1
- package/v3/@claude-flow/shared/dist/events/event-store.js +20 -9
- package/v3/@claude-flow/shared/dist/hooks/executor.js +7 -4
- package/v3/@claude-flow/shared/dist/hooks/verify-exports.test.js +6 -6
- package/v3/@claude-flow/shared/dist/mcp/server.js +3 -6
- package/v3/@claude-flow/shared/dist/mcp/types.d.ts +4 -6
- package/v3/@claude-flow/shared/package.json +1 -1
package/README.md
CHANGED
|
@@ -2,13 +2,15 @@
|
|
|
2
2
|
|
|
3
3
|
[](https://flo.ruv.io/)
|
|
4
4
|
|
|
5
|
-
[](https://flo.ruv.io/)
|
|
6
|
+
[](https://goal.ruv.io/)
|
|
7
|
+
[](https://goal.ruv.io/agents)
|
|
8
8
|
|
|
9
9
|
[](https://github.com/ruvnet/claude-flow)
|
|
10
10
|
[](https://opensource.org/licenses/MIT)
|
|
11
|
-
[](https://github.com/ruvnet/claude-flow)
|
|
12
|
+
[](https://www.npmjs.com/package/@claude-flow/codex)
|
|
13
|
+
[](https://github.com/ruvnet/ruvector)
|
|
12
14
|
|
|
13
15
|
# Ruflo
|
|
14
16
|
|
|
@@ -20,12 +22,12 @@ Orchestrate 100+ specialized AI agents across machines, teams, and trust boundar
|
|
|
20
22
|
|
|
21
23
|
### Why Ruflo?
|
|
22
24
|
|
|
23
|
-
> Claude Flow is now Ruflo — named by rUv, who loves Rust, flow states, and building things that feel inevitable. The "Ru" is the
|
|
25
|
+
> Claude Flow is now Ruflo — named by [`rUv`](https://ruv.io), who loves Rust, flow states, and building things that feel inevitable. The "Ru" is the rUv. The "flo" is working until 3am. Underneath, powered by [`Cognitum.One`](https://cognitum.one/?RuFlo) agentic architecture, running a supercharged Rust based AI engine, embeddings, memory, and plugin system.
|
|
24
26
|
|
|
25
27
|
|
|
26
28
|
### What Ruflo Does
|
|
27
29
|
|
|
28
|
-
One `init` gives Claude Code a nervous system: agents self-organize into swarms, learn from every task, remember across sessions, and — with federation — securely talk to agents on other machines without leaking data. You keep writing code. Ruflo handles the coordination.
|
|
30
|
+
One `npx ruvflo init` gives Claude Code a nervous system: agents self-organize into swarms, learn from every task, remember across sessions, and — with federation — securely talk to agents on other machines without leaking data. You keep writing code. Ruflo handles the coordination.
|
|
29
31
|
|
|
30
32
|
```
|
|
31
33
|
Self-Learning / Self-Optimizing Agent Architecture
|
|
@@ -69,84 +71,84 @@ There are **two different install paths** with very different surface areas. Pic
|
|
|
69
71
|
This adds slash commands and agent definitions only. The Ruflo MCP server is NOT registered, so `memory_store`, `swarm_init`, `agent_spawn`, etc. won't be callable from Claude. For the full loop, use Path B below.
|
|
70
72
|
|
|
71
73
|
<details>
|
|
72
|
-
<summary><strong
|
|
74
|
+
<summary><strong>🔌 All 32 plugins</strong></summary>
|
|
73
75
|
|
|
74
76
|
#### Core & Orchestration
|
|
75
77
|
|
|
76
78
|
| Plugin | What it does |
|
|
77
79
|
|--------|-------------|
|
|
78
|
-
| **ruflo-core** | Foundation — server, health checks, plugin discovery |
|
|
79
|
-
| **ruflo-swarm** | Coordinate multiple agents as a team |
|
|
80
|
-
| **ruflo-autopilot** | Let agents run autonomously in a loop |
|
|
81
|
-
| **ruflo-loop-workers** | Schedule background tasks on a timer |
|
|
82
|
-
| **ruflo-workflows** | Reusable multi-step task templates |
|
|
83
|
-
| **ruflo-federation** | Agents on different machines collaborate securely |
|
|
80
|
+
| [**ruflo-core**](plugins/ruflo-core/README.md) | Foundation — server, health checks, plugin discovery |
|
|
81
|
+
| [**ruflo-swarm**](plugins/ruflo-swarm/README.md) | Coordinate multiple agents as a team |
|
|
82
|
+
| [**ruflo-autopilot**](plugins/ruflo-autopilot/README.md) | Let agents run autonomously in a loop |
|
|
83
|
+
| [**ruflo-loop-workers**](plugins/ruflo-loop-workers/README.md) | Schedule background tasks on a timer |
|
|
84
|
+
| [**ruflo-workflows**](plugins/ruflo-workflows/README.md) | Reusable multi-step task templates |
|
|
85
|
+
| [**ruflo-federation**](plugins/ruflo-federation/README.md) | Agents on different machines collaborate securely |
|
|
84
86
|
|
|
85
87
|
#### Memory & Knowledge
|
|
86
88
|
|
|
87
89
|
| Plugin | What it does |
|
|
88
90
|
|--------|-------------|
|
|
89
|
-
| **ruflo-agentdb** | Fast vector database for agent memory |
|
|
90
|
-
| **ruflo-rag-memory** | Smart retrieval — hybrid search, graph hops, diversity ranking |
|
|
91
|
-
| **ruflo-rvf** | Save and restore agent memory across sessions |
|
|
92
|
-
| **ruflo-ruvector** | [`ruvector`](https://npmjs.com/package/ruvector) — GPU-accelerated search, Graph RAG, 103 tools |
|
|
93
|
-
| **ruflo-knowledge-graph** | Build and traverse entity relationship maps |
|
|
91
|
+
| [**ruflo-agentdb**](plugins/ruflo-agentdb/README.md) | Fast vector database for agent memory |
|
|
92
|
+
| [**ruflo-rag-memory**](plugins/ruflo-rag-memory/README.md) | Smart retrieval — hybrid search, graph hops, diversity ranking |
|
|
93
|
+
| [**ruflo-rvf**](plugins/ruflo-rvf/README.md) | Save and restore agent memory across sessions |
|
|
94
|
+
| [**ruflo-ruvector**](plugins/ruflo-ruvector/README.md) | [`ruvector`](https://npmjs.com/package/ruvector) — GPU-accelerated search, Graph RAG, 103 tools |
|
|
95
|
+
| [**ruflo-knowledge-graph**](plugins/ruflo-knowledge-graph/README.md) | Build and traverse entity relationship maps |
|
|
94
96
|
|
|
95
97
|
#### Intelligence & Learning
|
|
96
98
|
|
|
97
99
|
| Plugin | What it does |
|
|
98
100
|
|--------|-------------|
|
|
99
|
-
| **ruflo-intelligence** | Agents learn from past successes and get smarter |
|
|
100
|
-
| **ruflo-daa** | Dynamic agent behavior and cognitive patterns |
|
|
101
|
-
| **ruflo-ruvllm** | Run local LLMs (Ollama, etc.) with smart routing |
|
|
102
|
-
| **ruflo-goals** | Break big goals into plans and track progress |
|
|
101
|
+
| [**ruflo-intelligence**](plugins/ruflo-intelligence/README.md) | Agents learn from past successes and get smarter |
|
|
102
|
+
| [**ruflo-daa**](plugins/ruflo-daa/README.md) | Dynamic agent behavior and cognitive patterns |
|
|
103
|
+
| [**ruflo-ruvllm**](plugins/ruflo-ruvllm/README.md) | Run local LLMs (Ollama, etc.) with smart routing |
|
|
104
|
+
| [**ruflo-goals**](plugins/ruflo-goals/README.md) | Break big goals into plans and track progress |
|
|
103
105
|
|
|
104
106
|
#### Code Quality & Testing
|
|
105
107
|
|
|
106
108
|
| Plugin | What it does |
|
|
107
109
|
|--------|-------------|
|
|
108
|
-
| **ruflo-testgen** | Find missing tests and generate them automatically |
|
|
109
|
-
| **ruflo-browser** | Automate browser testing with Playwright |
|
|
110
|
-
| **ruflo-jujutsu** | Analyze git diffs, score risk, suggest reviewers |
|
|
111
|
-
| **ruflo-docs** | Generate and maintain documentation automatically |
|
|
110
|
+
| [**ruflo-testgen**](plugins/ruflo-testgen/README.md) | Find missing tests and generate them automatically |
|
|
111
|
+
| [**ruflo-browser**](plugins/ruflo-browser/README.md) | Automate browser testing with Playwright |
|
|
112
|
+
| [**ruflo-jujutsu**](plugins/ruflo-jujutsu/README.md) | Analyze git diffs, score risk, suggest reviewers |
|
|
113
|
+
| [**ruflo-docs**](plugins/ruflo-docs/README.md) | Generate and maintain documentation automatically |
|
|
112
114
|
|
|
113
115
|
#### Security & Compliance
|
|
114
116
|
|
|
115
117
|
| Plugin | What it does |
|
|
116
118
|
|--------|-------------|
|
|
117
|
-
| **ruflo-security-audit** | Scan for vulnerabilities and CVEs |
|
|
118
|
-
| **ruflo-aidefence** | Block prompt injection, detect PII, safety scanning |
|
|
119
|
+
| [**ruflo-security-audit**](plugins/ruflo-security-audit/README.md) | Scan for vulnerabilities and CVEs |
|
|
120
|
+
| [**ruflo-aidefence**](plugins/ruflo-aidefence/README.md) | Block prompt injection, detect PII, safety scanning |
|
|
119
121
|
|
|
120
122
|
#### Architecture & Methodology
|
|
121
123
|
|
|
122
124
|
| Plugin | What it does |
|
|
123
125
|
|--------|-------------|
|
|
124
|
-
| **ruflo-adr** | Track architecture decisions with a living record |
|
|
125
|
-
| **ruflo-ddd** | Scaffold domain-driven design — contexts, aggregates, events |
|
|
126
|
-
| **ruflo-sparc** | Guided 5-phase development methodology with quality gates |
|
|
126
|
+
| [**ruflo-adr**](plugins/ruflo-adr/README.md) | Track architecture decisions with a living record |
|
|
127
|
+
| [**ruflo-ddd**](plugins/ruflo-ddd/README.md) | Scaffold domain-driven design — contexts, aggregates, events |
|
|
128
|
+
| [**ruflo-sparc**](plugins/ruflo-sparc/README.md) | Guided 5-phase development methodology with quality gates |
|
|
127
129
|
|
|
128
130
|
#### DevOps & Observability
|
|
129
131
|
|
|
130
132
|
| Plugin | What it does |
|
|
131
133
|
|--------|-------------|
|
|
132
|
-
| **ruflo-migrations** | Manage database schema changes safely |
|
|
133
|
-
| **ruflo-observability** | Structured logs, traces, and metrics in one place |
|
|
134
|
-
| **ruflo-cost-tracker** | Track token usage, set budgets, get cost alerts |
|
|
134
|
+
| [**ruflo-migrations**](plugins/ruflo-migrations/README.md) | Manage database schema changes safely |
|
|
135
|
+
| [**ruflo-observability**](plugins/ruflo-observability/README.md) | Structured logs, traces, and metrics in one place |
|
|
136
|
+
| [**ruflo-cost-tracker**](plugins/ruflo-cost-tracker/README.md) | Track token usage, set budgets, get cost alerts |
|
|
135
137
|
|
|
136
138
|
#### Extensibility
|
|
137
139
|
|
|
138
140
|
| Plugin | What it does |
|
|
139
141
|
|--------|-------------|
|
|
140
|
-
| **ruflo-
|
|
141
|
-
| **ruflo-plugin-creator** | Scaffold, validate, and publish your own plugins |
|
|
142
|
+
| [**ruflo-agent**](plugins/ruflo-agent/README.md) | Run agents — local WASM sandbox (rvagent) + Anthropic Claude Managed Agents (cloud) |
|
|
143
|
+
| [**ruflo-plugin-creator**](plugins/ruflo-plugin-creator/README.md) | Scaffold, validate, and publish your own plugins |
|
|
142
144
|
|
|
143
145
|
#### Domain-Specific
|
|
144
146
|
|
|
145
147
|
| Plugin | What it does |
|
|
146
148
|
|--------|-------------|
|
|
147
|
-
| **ruflo-iot-cognitum** | IoT device management — trust scoring, anomaly detection, fleets |
|
|
148
|
-
| **ruflo-neural-trader** | [`neural-trader`](https://npmjs.com/package/neural-trader) — AI trading with 4 agents, backtesting, 112+ tools |
|
|
149
|
-
| **ruflo-market-data** | Ingest market data, vectorize OHLCV, detect patterns |
|
|
149
|
+
| [**ruflo-iot-cognitum**](plugins/ruflo-iot-cognitum/README.md) | IoT device management — trust scoring, anomaly detection, fleets |
|
|
150
|
+
| [**ruflo-neural-trader**](plugins/ruflo-neural-trader/README.md) | [`neural-trader`](https://npmjs.com/package/neural-trader) — AI trading with 4 agents, backtesting, 112+ tools |
|
|
151
|
+
| [**ruflo-market-data**](plugins/ruflo-market-data/README.md) | Ingest market data, vectorize OHLCV, detect patterns |
|
|
150
152
|
|
|
151
153
|
</details>
|
|
152
154
|
|
|
@@ -261,6 +263,8 @@ The difference: some channels are trusted, some aren't. [`@claude-flow/plugin-ag
|
|
|
261
263
|
|
|
262
264
|
You don't configure handshakes or manage certificates. You `federation init`, `federation join`, and your agents start talking. The protocol handles identity, the PII pipeline handles data safety, and the audit trail handles compliance.
|
|
263
265
|
|
|
266
|
+
> **📘 Full user guide:** [`docs/federation/`](./docs/federation/) — setup, MCP tools, trust levels, circuit breaker, and the (opt-in) WireGuard mesh layer that ties packet-layer reachability to federation trust. ADR-111 deep-dive at [`docs/federation/phase7-mesh-bringup.md`](./docs/federation/phase7-mesh-bringup.md).
|
|
267
|
+
|
|
264
268
|
<details>
|
|
265
269
|
<summary><strong>Federation capabilities</strong></summary>
|
|
266
270
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "claude-flow",
|
|
3
|
-
"version": "3.7.0-alpha.
|
|
3
|
+
"version": "3.7.0-alpha.30",
|
|
4
4
|
"description": "Ruflo - Enterprise AI agent orchestration for Claude Code. Deploy 60+ specialized agents in coordinated swarms with self-learning, fault-tolerant consensus, vector memory, and MCP integration",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"type": "module",
|
|
@@ -54,6 +54,12 @@
|
|
|
54
54
|
"v3:security": "npm run security:audit && npm run security:test"
|
|
55
55
|
},
|
|
56
56
|
"dependencies": {
|
|
57
|
+
"@claude-flow/cli-core": "^3.7.0-alpha.5",
|
|
58
|
+
"@claude-flow/mcp": "^3.0.0-alpha.8",
|
|
59
|
+
"@claude-flow/neural": "^3.0.0-alpha.8",
|
|
60
|
+
"@claude-flow/shared": "^3.0.0-alpha.7",
|
|
61
|
+
"@noble/ed25519": "^2.1.0",
|
|
62
|
+
"@ruvector/rabitq-wasm": "^0.1.0",
|
|
57
63
|
"semver": "^7.6.0",
|
|
58
64
|
"zod": "^3.22.4"
|
|
59
65
|
},
|
|
@@ -146,4 +152,4 @@
|
|
|
146
152
|
"access": "public",
|
|
147
153
|
"tag": "latest"
|
|
148
154
|
}
|
|
149
|
-
}
|
|
155
|
+
}
|
|
@@ -2,13 +2,15 @@
|
|
|
2
2
|
|
|
3
3
|
[](https://flo.ruv.io/)
|
|
4
4
|
|
|
5
|
-
[](https://flo.ruv.io/)
|
|
6
|
+
[](https://goal.ruv.io/)
|
|
7
|
+
[](https://goal.ruv.io/agents)
|
|
8
8
|
|
|
9
9
|
[](https://github.com/ruvnet/claude-flow)
|
|
10
10
|
[](https://opensource.org/licenses/MIT)
|
|
11
|
-
[](https://github.com/ruvnet/claude-flow)
|
|
12
|
+
[](https://www.npmjs.com/package/@claude-flow/codex)
|
|
13
|
+
[](https://github.com/ruvnet/ruvector)
|
|
12
14
|
|
|
13
15
|
# Ruflo
|
|
14
16
|
|
|
@@ -20,12 +22,12 @@ Orchestrate 100+ specialized AI agents across machines, teams, and trust boundar
|
|
|
20
22
|
|
|
21
23
|
### Why Ruflo?
|
|
22
24
|
|
|
23
|
-
> Claude Flow is now Ruflo — named by rUv, who loves Rust, flow states, and building things that feel inevitable. The "Ru" is the
|
|
25
|
+
> Claude Flow is now Ruflo — named by [`rUv`](https://ruv.io), who loves Rust, flow states, and building things that feel inevitable. The "Ru" is the rUv. The "flo" is working until 3am. Underneath, powered by [`Cognitum.One`](https://cognitum.one/?RuFlo) agentic architecture, running a supercharged Rust based AI engine, embeddings, memory, and plugin system.
|
|
24
26
|
|
|
25
27
|
|
|
26
28
|
### What Ruflo Does
|
|
27
29
|
|
|
28
|
-
One `init` gives Claude Code a nervous system: agents self-organize into swarms, learn from every task, remember across sessions, and — with federation — securely talk to agents on other machines without leaking data. You keep writing code. Ruflo handles the coordination.
|
|
30
|
+
One `npx ruvflo init` gives Claude Code a nervous system: agents self-organize into swarms, learn from every task, remember across sessions, and — with federation — securely talk to agents on other machines without leaking data. You keep writing code. Ruflo handles the coordination.
|
|
29
31
|
|
|
30
32
|
```
|
|
31
33
|
Self-Learning / Self-Optimizing Agent Architecture
|
|
@@ -69,84 +71,84 @@ There are **two different install paths** with very different surface areas. Pic
|
|
|
69
71
|
This adds slash commands and agent definitions only. The Ruflo MCP server is NOT registered, so `memory_store`, `swarm_init`, `agent_spawn`, etc. won't be callable from Claude. For the full loop, use Path B below.
|
|
70
72
|
|
|
71
73
|
<details>
|
|
72
|
-
<summary><strong
|
|
74
|
+
<summary><strong>🔌 All 32 plugins</strong></summary>
|
|
73
75
|
|
|
74
76
|
#### Core & Orchestration
|
|
75
77
|
|
|
76
78
|
| Plugin | What it does |
|
|
77
79
|
|--------|-------------|
|
|
78
|
-
| **ruflo-core** | Foundation — server, health checks, plugin discovery |
|
|
79
|
-
| **ruflo-swarm** | Coordinate multiple agents as a team |
|
|
80
|
-
| **ruflo-autopilot** | Let agents run autonomously in a loop |
|
|
81
|
-
| **ruflo-loop-workers** | Schedule background tasks on a timer |
|
|
82
|
-
| **ruflo-workflows** | Reusable multi-step task templates |
|
|
83
|
-
| **ruflo-federation** | Agents on different machines collaborate securely |
|
|
80
|
+
| [**ruflo-core**](plugins/ruflo-core/README.md) | Foundation — server, health checks, plugin discovery |
|
|
81
|
+
| [**ruflo-swarm**](plugins/ruflo-swarm/README.md) | Coordinate multiple agents as a team |
|
|
82
|
+
| [**ruflo-autopilot**](plugins/ruflo-autopilot/README.md) | Let agents run autonomously in a loop |
|
|
83
|
+
| [**ruflo-loop-workers**](plugins/ruflo-loop-workers/README.md) | Schedule background tasks on a timer |
|
|
84
|
+
| [**ruflo-workflows**](plugins/ruflo-workflows/README.md) | Reusable multi-step task templates |
|
|
85
|
+
| [**ruflo-federation**](plugins/ruflo-federation/README.md) | Agents on different machines collaborate securely |
|
|
84
86
|
|
|
85
87
|
#### Memory & Knowledge
|
|
86
88
|
|
|
87
89
|
| Plugin | What it does |
|
|
88
90
|
|--------|-------------|
|
|
89
|
-
| **ruflo-agentdb** | Fast vector database for agent memory |
|
|
90
|
-
| **ruflo-rag-memory** | Smart retrieval — hybrid search, graph hops, diversity ranking |
|
|
91
|
-
| **ruflo-rvf** | Save and restore agent memory across sessions |
|
|
92
|
-
| **ruflo-ruvector** | [`ruvector`](https://npmjs.com/package/ruvector) — GPU-accelerated search, Graph RAG, 103 tools |
|
|
93
|
-
| **ruflo-knowledge-graph** | Build and traverse entity relationship maps |
|
|
91
|
+
| [**ruflo-agentdb**](plugins/ruflo-agentdb/README.md) | Fast vector database for agent memory |
|
|
92
|
+
| [**ruflo-rag-memory**](plugins/ruflo-rag-memory/README.md) | Smart retrieval — hybrid search, graph hops, diversity ranking |
|
|
93
|
+
| [**ruflo-rvf**](plugins/ruflo-rvf/README.md) | Save and restore agent memory across sessions |
|
|
94
|
+
| [**ruflo-ruvector**](plugins/ruflo-ruvector/README.md) | [`ruvector`](https://npmjs.com/package/ruvector) — GPU-accelerated search, Graph RAG, 103 tools |
|
|
95
|
+
| [**ruflo-knowledge-graph**](plugins/ruflo-knowledge-graph/README.md) | Build and traverse entity relationship maps |
|
|
94
96
|
|
|
95
97
|
#### Intelligence & Learning
|
|
96
98
|
|
|
97
99
|
| Plugin | What it does |
|
|
98
100
|
|--------|-------------|
|
|
99
|
-
| **ruflo-intelligence** | Agents learn from past successes and get smarter |
|
|
100
|
-
| **ruflo-daa** | Dynamic agent behavior and cognitive patterns |
|
|
101
|
-
| **ruflo-ruvllm** | Run local LLMs (Ollama, etc.) with smart routing |
|
|
102
|
-
| **ruflo-goals** | Break big goals into plans and track progress |
|
|
101
|
+
| [**ruflo-intelligence**](plugins/ruflo-intelligence/README.md) | Agents learn from past successes and get smarter |
|
|
102
|
+
| [**ruflo-daa**](plugins/ruflo-daa/README.md) | Dynamic agent behavior and cognitive patterns |
|
|
103
|
+
| [**ruflo-ruvllm**](plugins/ruflo-ruvllm/README.md) | Run local LLMs (Ollama, etc.) with smart routing |
|
|
104
|
+
| [**ruflo-goals**](plugins/ruflo-goals/README.md) | Break big goals into plans and track progress |
|
|
103
105
|
|
|
104
106
|
#### Code Quality & Testing
|
|
105
107
|
|
|
106
108
|
| Plugin | What it does |
|
|
107
109
|
|--------|-------------|
|
|
108
|
-
| **ruflo-testgen** | Find missing tests and generate them automatically |
|
|
109
|
-
| **ruflo-browser** | Automate browser testing with Playwright |
|
|
110
|
-
| **ruflo-jujutsu** | Analyze git diffs, score risk, suggest reviewers |
|
|
111
|
-
| **ruflo-docs** | Generate and maintain documentation automatically |
|
|
110
|
+
| [**ruflo-testgen**](plugins/ruflo-testgen/README.md) | Find missing tests and generate them automatically |
|
|
111
|
+
| [**ruflo-browser**](plugins/ruflo-browser/README.md) | Automate browser testing with Playwright |
|
|
112
|
+
| [**ruflo-jujutsu**](plugins/ruflo-jujutsu/README.md) | Analyze git diffs, score risk, suggest reviewers |
|
|
113
|
+
| [**ruflo-docs**](plugins/ruflo-docs/README.md) | Generate and maintain documentation automatically |
|
|
112
114
|
|
|
113
115
|
#### Security & Compliance
|
|
114
116
|
|
|
115
117
|
| Plugin | What it does |
|
|
116
118
|
|--------|-------------|
|
|
117
|
-
| **ruflo-security-audit** | Scan for vulnerabilities and CVEs |
|
|
118
|
-
| **ruflo-aidefence** | Block prompt injection, detect PII, safety scanning |
|
|
119
|
+
| [**ruflo-security-audit**](plugins/ruflo-security-audit/README.md) | Scan for vulnerabilities and CVEs |
|
|
120
|
+
| [**ruflo-aidefence**](plugins/ruflo-aidefence/README.md) | Block prompt injection, detect PII, safety scanning |
|
|
119
121
|
|
|
120
122
|
#### Architecture & Methodology
|
|
121
123
|
|
|
122
124
|
| Plugin | What it does |
|
|
123
125
|
|--------|-------------|
|
|
124
|
-
| **ruflo-adr** | Track architecture decisions with a living record |
|
|
125
|
-
| **ruflo-ddd** | Scaffold domain-driven design — contexts, aggregates, events |
|
|
126
|
-
| **ruflo-sparc** | Guided 5-phase development methodology with quality gates |
|
|
126
|
+
| [**ruflo-adr**](plugins/ruflo-adr/README.md) | Track architecture decisions with a living record |
|
|
127
|
+
| [**ruflo-ddd**](plugins/ruflo-ddd/README.md) | Scaffold domain-driven design — contexts, aggregates, events |
|
|
128
|
+
| [**ruflo-sparc**](plugins/ruflo-sparc/README.md) | Guided 5-phase development methodology with quality gates |
|
|
127
129
|
|
|
128
130
|
#### DevOps & Observability
|
|
129
131
|
|
|
130
132
|
| Plugin | What it does |
|
|
131
133
|
|--------|-------------|
|
|
132
|
-
| **ruflo-migrations** | Manage database schema changes safely |
|
|
133
|
-
| **ruflo-observability** | Structured logs, traces, and metrics in one place |
|
|
134
|
-
| **ruflo-cost-tracker** | Track token usage, set budgets, get cost alerts |
|
|
134
|
+
| [**ruflo-migrations**](plugins/ruflo-migrations/README.md) | Manage database schema changes safely |
|
|
135
|
+
| [**ruflo-observability**](plugins/ruflo-observability/README.md) | Structured logs, traces, and metrics in one place |
|
|
136
|
+
| [**ruflo-cost-tracker**](plugins/ruflo-cost-tracker/README.md) | Track token usage, set budgets, get cost alerts |
|
|
135
137
|
|
|
136
138
|
#### Extensibility
|
|
137
139
|
|
|
138
140
|
| Plugin | What it does |
|
|
139
141
|
|--------|-------------|
|
|
140
|
-
| **ruflo-
|
|
141
|
-
| **ruflo-plugin-creator** | Scaffold, validate, and publish your own plugins |
|
|
142
|
+
| [**ruflo-agent**](plugins/ruflo-agent/README.md) | Run agents — local WASM sandbox (rvagent) + Anthropic Claude Managed Agents (cloud) |
|
|
143
|
+
| [**ruflo-plugin-creator**](plugins/ruflo-plugin-creator/README.md) | Scaffold, validate, and publish your own plugins |
|
|
142
144
|
|
|
143
145
|
#### Domain-Specific
|
|
144
146
|
|
|
145
147
|
| Plugin | What it does |
|
|
146
148
|
|--------|-------------|
|
|
147
|
-
| **ruflo-iot-cognitum** | IoT device management — trust scoring, anomaly detection, fleets |
|
|
148
|
-
| **ruflo-neural-trader** | [`neural-trader`](https://npmjs.com/package/neural-trader) — AI trading with 4 agents, backtesting, 112+ tools |
|
|
149
|
-
| **ruflo-market-data** | Ingest market data, vectorize OHLCV, detect patterns |
|
|
149
|
+
| [**ruflo-iot-cognitum**](plugins/ruflo-iot-cognitum/README.md) | IoT device management — trust scoring, anomaly detection, fleets |
|
|
150
|
+
| [**ruflo-neural-trader**](plugins/ruflo-neural-trader/README.md) | [`neural-trader`](https://npmjs.com/package/neural-trader) — AI trading with 4 agents, backtesting, 112+ tools |
|
|
151
|
+
| [**ruflo-market-data**](plugins/ruflo-market-data/README.md) | Ingest market data, vectorize OHLCV, detect patterns |
|
|
150
152
|
|
|
151
153
|
</details>
|
|
152
154
|
|
|
@@ -261,6 +263,8 @@ The difference: some channels are trusted, some aren't. [`@claude-flow/plugin-ag
|
|
|
261
263
|
|
|
262
264
|
You don't configure handshakes or manage certificates. You `federation init`, `federation join`, and your agents start talking. The protocol handles identity, the PII pipeline handles data safety, and the audit trail handles compliance.
|
|
263
265
|
|
|
266
|
+
> **📘 Full user guide:** [`docs/federation/`](./docs/federation/) — setup, MCP tools, trust levels, circuit breaker, and the (opt-in) WireGuard mesh layer that ties packet-layer reachability to federation trust. ADR-111 deep-dive at [`docs/federation/phase7-mesh-bringup.md`](./docs/federation/phase7-mesh-bringup.md).
|
|
267
|
+
|
|
264
268
|
<details>
|
|
265
269
|
<summary><strong>Federation capabilities</strong></summary>
|
|
266
270
|
|
|
@@ -39,9 +39,22 @@ console.log = (...args) => {
|
|
|
39
39
|
// Conditions:
|
|
40
40
|
// 1. stdin is being piped AND no CLI arguments provided (auto-detect)
|
|
41
41
|
// 2. stdin is being piped AND args are "mcp start" (explicit, e.g. npx claude-flow@alpha mcp start)
|
|
42
|
+
// 3. EXCEPT — if the user explicitly passed --transport <non-stdio>
|
|
43
|
+
// (e.g. -t http), defer to the parser. Without this, every smoke
|
|
44
|
+
// test or non-TTY caller of `mcp start -t http` got force-routed
|
|
45
|
+
// into stdio mode and never hit the HTTP server (#1874 follow-up).
|
|
42
46
|
const cliArgs = process.argv.slice(2);
|
|
43
47
|
const isExplicitMCP = cliArgs.length >= 1 && cliArgs[0] === 'mcp' && (cliArgs.length === 1 || cliArgs[1] === 'start');
|
|
44
|
-
const
|
|
48
|
+
const explicitNonStdioTransport = cliArgs.some((a, i) => {
|
|
49
|
+
// -t <value> | --transport <value>
|
|
50
|
+
if ((a === '-t' || a === '--transport') && cliArgs[i + 1] && cliArgs[i + 1] !== 'stdio') return true;
|
|
51
|
+
// --transport=<value>
|
|
52
|
+
if (/^--transport=/.test(a) && !/^--transport=stdio$/.test(a)) return true;
|
|
53
|
+
return false;
|
|
54
|
+
});
|
|
55
|
+
const isMCPMode = !process.stdin.isTTY
|
|
56
|
+
&& !explicitNonStdioTransport
|
|
57
|
+
&& (process.argv.length === 2 || isExplicitMCP);
|
|
45
58
|
|
|
46
59
|
if (isMCPMode) {
|
|
47
60
|
// Run MCP server mode
|
|
@@ -134,7 +147,7 @@ if (isMCPMode) {
|
|
|
134
147
|
id: message.id,
|
|
135
148
|
result: {
|
|
136
149
|
protocolVersion: '2024-11-05',
|
|
137
|
-
serverInfo: { name: '
|
|
150
|
+
serverInfo: { name: 'ruflo', version: VERSION },
|
|
138
151
|
capabilities: {
|
|
139
152
|
tools: { listChanged: true },
|
|
140
153
|
resources: { subscribe: true, listChanged: true },
|
|
@@ -138,7 +138,7 @@ async function handleMessage(message) {
|
|
|
138
138
|
id: message.id,
|
|
139
139
|
result: {
|
|
140
140
|
protocolVersion: '2024-11-05',
|
|
141
|
-
serverInfo: { name: '
|
|
141
|
+
serverInfo: { name: 'ruflo', version: VERSION },
|
|
142
142
|
capabilities: {
|
|
143
143
|
tools: { listChanged: true },
|
|
144
144
|
resources: { subscribe: true, listChanged: true },
|
|
@@ -106,7 +106,7 @@ export const wasmCreateCommand = {
|
|
|
106
106
|
{
|
|
107
107
|
name: 'model',
|
|
108
108
|
short: 'm',
|
|
109
|
-
description: 'Model identifier (default: anthropic:claude-sonnet-4-
|
|
109
|
+
description: 'Model identifier (default: anthropic:claude-sonnet-4-6)',
|
|
110
110
|
type: 'string',
|
|
111
111
|
},
|
|
112
112
|
{
|
|
@@ -125,7 +125,7 @@ export const wasmCreateCommand = {
|
|
|
125
125
|
examples: [
|
|
126
126
|
{ command: 'claude-flow agent wasm-create', description: 'Create a default WASM agent' },
|
|
127
127
|
{ command: 'claude-flow agent wasm-create -t coder', description: 'Create from gallery template' },
|
|
128
|
-
{ command: 'claude-flow agent wasm-create -m "anthropic:claude-sonnet-4-
|
|
128
|
+
{ command: 'claude-flow agent wasm-create -m "anthropic:claude-sonnet-4-6" -i "You are a security auditor"', description: 'Create with custom config' },
|
|
129
129
|
],
|
|
130
130
|
action: async (ctx) => {
|
|
131
131
|
try {
|
|
@@ -3,6 +3,26 @@
|
|
|
3
3
|
* Manages background worker daemon (Node.js-based, similar to shell helpers)
|
|
4
4
|
*/
|
|
5
5
|
import type { Command } from '../types.js';
|
|
6
|
+
/**
|
|
7
|
+
* #1914: Resolve the `--workspace` flag to an absolute path, or return null
|
|
8
|
+
* if it is absent / not a usable string. Rejects values with null bytes or
|
|
9
|
+
* shell metacharacters (defence-in-depth — the value is later embedded in a
|
|
10
|
+
* forked child's argv and compared against `ps`/`tasklist` output).
|
|
11
|
+
*/
|
|
12
|
+
export declare function resolveWorkspaceFlag(raw: unknown): string | null;
|
|
13
|
+
/**
|
|
14
|
+
* #1914: True when a process command line (from `ps -eo command` on POSIX or
|
|
15
|
+
* the tasklist Window Title column on Windows) belongs to a daemon started
|
|
16
|
+
* for `workspaceRoot`. The launcher (`startBackgroundDaemon`) always appends
|
|
17
|
+
* `--workspace <root>` as the FINAL argv entry, so an exact trailing match
|
|
18
|
+
* after stripping trailing whitespace/quotes is unambiguous — even for
|
|
19
|
+
* workspace paths containing spaces — and never a bare path-prefix match,
|
|
20
|
+
* so workspace `/a/proj` does not reap `/a/proj-other`'s daemon. A daemon
|
|
21
|
+
* whose argv puts `--workspace` mid-list (only possible via a hand-rolled
|
|
22
|
+
* invocation) simply won't be auto-reaped — `daemon stop` still handles it
|
|
23
|
+
* via the PID file.
|
|
24
|
+
*/
|
|
25
|
+
export declare function daemonCommandLineBelongsToWorkspace(commandLine: string, workspaceRoot: string): boolean;
|
|
6
26
|
export declare const daemonCommand: Command;
|
|
7
27
|
export default daemonCommand;
|
|
8
28
|
//# sourceMappingURL=daemon.d.ts.map
|