claude-flow 3.72.1 → 3.73.0

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.
Files changed (43) hide show
  1. package/.claude/.proven-config-version +1 -0
  2. package/.claude/proven-config.json +42 -0
  3. package/.claude-plugin/marketplace.json +6 -6
  4. package/README.md +29 -21
  5. package/README.zh-CN.md +69 -4
  6. package/node_modules/@claude-flow/codex/dist/cli.js +0 -0
  7. package/node_modules/@claude-flow/plugin-agent-federation/dist/bin.js +0 -0
  8. package/node_modules/@claude-flow/plugin-agent-federation/package.json +5 -5
  9. package/node_modules/@claude-flow/security/dist/input-validator.d.ts +6 -6
  10. package/package.json +8 -8
  11. package/v3/@claude-flow/cli/README.md +29 -21
  12. package/v3/@claude-flow/cli/catalog-manifest.json +2 -2
  13. package/v3/@claude-flow/cli/dist/src/commands/agent.js +2 -0
  14. package/v3/@claude-flow/cli/dist/src/commands/funnel.d.ts +1 -0
  15. package/v3/@claude-flow/cli/dist/src/commands/funnel.js +37 -2
  16. package/v3/@claude-flow/cli/dist/src/commands/hooks.js +16 -2
  17. package/v3/@claude-flow/cli/dist/src/commands/init.js +70 -16
  18. package/v3/@claude-flow/cli/dist/src/commands/mcp.js +15 -0
  19. package/v3/@claude-flow/cli/dist/src/commands/neural.js +5 -3
  20. package/v3/@claude-flow/cli/dist/src/commands/swarm.js +2 -0
  21. package/v3/@claude-flow/cli/dist/src/funnel/activation.d.ts +30 -0
  22. package/v3/@claude-flow/cli/dist/src/funnel/activation.js +69 -0
  23. package/v3/@claude-flow/cli/dist/src/funnel/events.js +4 -1
  24. package/v3/@claude-flow/cli/dist/src/funnel/index.d.ts +2 -1
  25. package/v3/@claude-flow/cli/dist/src/funnel/index.js +2 -1
  26. package/v3/@claude-flow/cli/dist/src/funnel/message-transport.d.ts +12 -0
  27. package/v3/@claude-flow/cli/dist/src/funnel/message-transport.js +23 -1
  28. package/v3/@claude-flow/cli/dist/src/funnel/types.d.ts +2 -2
  29. package/v3/@claude-flow/cli/dist/src/init/first-win.d.ts +24 -0
  30. package/v3/@claude-flow/cli/dist/src/init/first-win.js +97 -0
  31. package/v3/@claude-flow/cli/dist/src/mcp-tools/agent-tools.js +2 -0
  32. package/v3/@claude-flow/cli/dist/src/mcp-tools/browser-session-tools.d.ts +2 -2
  33. package/v3/@claude-flow/cli/dist/src/mcp-tools/browser-session-tools.js +4 -4
  34. package/v3/@claude-flow/cli/dist/src/mcp-tools/hooks-tools.js +17 -1
  35. package/v3/@claude-flow/cli/dist/src/mcp-tools/neural-tools.js +3 -3
  36. package/v3/@claude-flow/cli/dist/src/mcp-tools/swarm-tools.js +2 -0
  37. package/v3/@claude-flow/cli/dist/src/missions/schemas.d.ts +117 -117
  38. package/v3/@claude-flow/cli/dist/src/mods/command-registry/schema.d.ts +121 -121
  39. package/v3/@claude-flow/cli/dist/src/transfer/store/download.d.ts +1 -1
  40. package/v3/@claude-flow/cli/dist/src/transfer/store/download.js +22 -21
  41. package/v3/@claude-flow/cli/dist/src/transfer/store/publish.d.ts +1 -1
  42. package/v3/@claude-flow/cli/dist/src/transfer/store/publish.js +13 -14
  43. package/v3/@claude-flow/cli/package.json +7 -7
@@ -0,0 +1 @@
1
+ sha256:6141a8ea990c5063b77e090ae8f37f9c539d8aa8f58dcceb30f3a82f97e57319
@@ -0,0 +1,42 @@
1
+ {
2
+ "adoptedAt": 1794181374201,
3
+ "championId": "sha256:6141a8ea990c5063b77e090ae8f37f9c539d8aa8f58dcceb30f3a82f97e57319",
4
+ "manifest": {
5
+ "schema": "ruflo.proven-config/v1",
6
+ "policy": {
7
+ "ref": "sha256:6141a8ea990c5063b77e090ae8f37f9c539d8aa8f58dcceb30f3a82f97e57319",
8
+ "value": {
9
+ "alpha": 0.3,
10
+ "subjectWeight": 1,
11
+ "mmrLambda": 0.5,
12
+ "bodyWeight": 1.5,
13
+ "typePenaltyFactor": 0.5
14
+ }
15
+ },
16
+ "layer": "framework/node-cli",
17
+ "compatibility": {
18
+ "ruflo": ">=3.24.0"
19
+ },
20
+ "benchmark": {
21
+ "corpus": "ADR-081-labelled-v1",
22
+ "corpusHash": "sha256:2f700b5c363e20a3bd88ce2bc9b87bbbbaa61732c6177894c6ec37890f888982"
23
+ },
24
+ "receipt": {
25
+ "heldOutDelta": 0.07381404928570845,
26
+ "redblue": "PASS",
27
+ "drift": 0,
28
+ "canary": {
29
+ "rollbackRate": 0,
30
+ "latencyP95": 244.612458000076,
31
+ "costPerTask": 0
32
+ },
33
+ "receiptCoverage": 1
34
+ },
35
+ "platform": [
36
+ "linux",
37
+ "macOS",
38
+ "windows"
39
+ ]
40
+ },
41
+ "previous": ""
42
+ }
@@ -68,10 +68,10 @@
68
68
  "source": "git-subdir",
69
69
  "url": "https://github.com/ruvnet/agentdb.git",
70
70
  "path": "plugins/agentdb",
71
- "ref": "plugin-v3.3.0",
72
- "sha": "d3df60d4f94f29199373fd45e837085c0d92a2b2"
71
+ "ref": "main",
72
+ "sha": "27678c302e6c70d6db800c9ad1259b41800f420e"
73
73
  },
74
- "description": "AgentDB (external: maintained in ruvnet/agentdb, pinned to plugin-v3.3.0): agentdb's own standalone MCP server pinned to agentdb@3.3.0 (vector memory with get/list/update/delete for records, patterns and skills, hybrid keyword + vector episode search and an opt-in local cross-encoder, reflexion, skills, outcome feedback, capabilities report), a memory-specialist agent, 3 skills, /agentdb-status, and the agentdb mod guard that keeps secrets out of memory and refuses delete/reset unless allowed. Complements ruflo-agentdb, which reaches AgentDB through ruflo's server"
74
+ "description": "AgentDB (external: maintained in ruvnet/agentdb, pinned to commit 27678c3, plugin 3.6.0): agentdb's own standalone MCP server pinned to agentdb@3.6.0 (vector memory with get/list/update/delete for records, patterns and skills, hybrid keyword + vector episode search and an opt-in local cross-encoder, an opt-in aidefence injection guard on memory writes, reflexion, skills, outcome feedback, capabilities report), a memory-specialist agent, 3 skills, /agentdb-status, and the agentdb mod guard that keeps secrets out of memory and refuses delete/reset unless allowed. Complements ruflo-agentdb, which reaches AgentDB through ruflo's server"
75
75
  },
76
76
  {
77
77
  "name": "agentic-flow",
@@ -79,10 +79,10 @@
79
79
  "source": "git-subdir",
80
80
  "url": "https://github.com/ruvnet/agentic-flow.git",
81
81
  "path": "plugins/agentic-flow",
82
- "ref": "plugin-v3.1.0",
83
- "sha": "2c86073bf55a105282bbdd4476fc18f5b7e6f97d"
82
+ "ref": "main",
83
+ "sha": "d19737b8574c956d17d695f09113e8b445d965b0"
84
84
  },
85
- "description": "agentic-flow (external: maintained in ruvnet/agentic-flow, pinned to plugin-v3.1.0): the agentic-flow MCP server pinned to agentic-flow@3.1.0 (ReasoningBank learning, multi-provider routing, autopilot learning; readonly profile by default, no tool pre-approved), 2 agents, 3 skills, /agentic-flow-status, and a mod guard on agentic_flow_agent with /agentic-flow-guard"
85
+ "description": "agentic-flow (external: maintained in ruvnet/agentic-flow, pinned to commit d19737b, plugin 3.4.0): the agentic-flow MCP server pinned to agentic-flow@3.4.0 (ReasoningBank learning, ecosystem tools prompt_injection_scan, swarm_partition_tasks, sublinear_solve, sublinear_pagerank and ecosystem_status, multi-provider routing, autopilot learning; readonly profile by default, no tool pre-approved), 2 agents, 4 skills, /agentic-flow-status, and a mod guard on agentic_flow_agent with /agentic-flow-guard"
86
86
  },
87
87
  {
88
88
  "name": "ruflo-docs",
package/README.md CHANGED
@@ -7,7 +7,7 @@
7
7
  <!-- Try Ruflo — the 3 badges first-time visitors actually act on -->
8
8
  [![npm version (ruflo)](https://img.shields.io/npm/v/ruflo?label=npx%20ruflo&style=for-the-badge&logo=npm&color=cb3837)](https://www.npmjs.com/package/ruflo)
9
9
  [![MIT License](https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge)](https://opensource.org/licenses/MIT)
10
- [![Star on GitHub](https://img.shields.io/github/stars/ruvnet/claude-flow?style=for-the-badge&logo=github&color=gold)](https://github.com/ruvnet/claude-flow)
10
+ [![Star on GitHub](https://img.shields.io/github/stars/ruvnet/ruflo?style=for-the-badge&logo=github&color=gold)](https://github.com/ruvnet/ruflo)
11
11
  [![Follow @rUv on X](https://img.shields.io/badge/Follow-@rUv-000000?style=for-the-badge&logo=x&logoColor=white)](https://x.com/rUv)
12
12
 
13
13
  <p align="center">
@@ -23,42 +23,49 @@
23
23
 
24
24
  <a id="start-here"></a>
25
25
 
26
- ## <img src="docs/assets/readme/icons/terminal.svg" width="32" height="32" alt=""> Get started with Ruflo
26
+ ## <img src="docs/assets/readme/icons/terminal.svg" width="32" height="32" alt=""> Get started in one command
27
27
 
28
- <img src="docs/assets/readme/icons/plugins.svg" width="28" height="28" alt=""> **Start in Claude Code** with core tools, the visual console and runtime mods. Requires Claude Code **2.1.287 or later**. Run inside Claude Code:
28
+ Run this in your project folder:
29
+
30
+ ```bash
31
+ npx ruflo@latest init
32
+ ```
33
+
34
+ Then open Claude Code in the same folder and give it a real task, for example:
29
35
 
30
36
  ```text
31
- /plugin marketplace add ruvnet/ruflo
32
- /plugin install ruflo-core@ruflo
33
- /plugin install ruflo-console@ruflo
34
- /plugin install ruflo-mods@ruflo
35
- /reload-plugins
36
- /ruflo
37
+ Use a ruflo swarm to review this repo: find the riskiest module, write tests for it, and summarise what you changed.
37
38
  ```
38
39
 
39
- From a terminal on Claude Code 2.1.292 or later, one command adds the marketplace and installs a plugin: `claude plugin install ruflo-core@ruflo --marketplace ruvnet/ruflo`.
40
+ `init` adds ruflo's agents, hooks, memory and MCP server to the project, and Claude Code picks them up on its next start. Codex and other MCP clients work too: point them at `npx -y ruflo@latest mcp start`.
40
41
 
41
- **Core** provides foundation tools. **Console** opens the agent cockpit. **Mods** add routing and policy enforcement inside Claude Code. Mods run with your account's permissions; review their code before installing.
42
+ <p align="center"><img src="docs/assets/ruflo-console-tour.gif" width="720" alt="Looping recording of the ruflo console: overview, swarm view and missions in a sample project"></p>
42
43
 
43
- <img src="docs/assets/readme/icons/terminal.svg" width="28" height="28" alt=""> **Using Codex or another MCP enabled tool?** Use NPX for Ruflo project setup and connect your client to the Ruflo MCP server. Run the setup wizard in your project terminal:
44
+ [First useful task, step by step](docs/ruflo-explained.md) · [User guide](docs/USERGUIDE.md) · [Compare install paths](#quick-start)
44
45
 
45
- ```bash
46
- npx ruflo@latest init wizard
47
- ```
46
+ <details>
47
+ <summary><b>Other ways to install</b> (Claude Code plugins only, MCP-only clients, terminal UI)</summary>
48
48
 
49
- For clients that support local stdio MCP servers, configure **command** `npx` and **arguments** `["-y", "ruflo@latest", "mcp", "start"]`. The equivalent server command is:
49
+ **Claude Code plugins only.** This route installs core tools, the visual console and runtime mods, with no files added to your project. It needs Claude Code **2.1.287 or later**. Run inside Claude Code:
50
50
 
51
- ```bash
52
- npx -y ruflo@latest mcp start
51
+ ```text
52
+ /plugin marketplace add ruvnet/ruflo
53
+ /plugin install ruflo-core@ruflo
54
+ /plugin install ruflo-console@ruflo
55
+ /plugin install ruflo-mods@ruflo
56
+ /reload-plugins
57
+ /ruflo
53
58
  ```
54
59
 
55
- MCP exposes Ruflo tools to your client. The console and mods above are Claude Code integrations; hook support depends on the client.
60
+ From a terminal, on Claude Code 2.1.292 or later: `claude plugin install ruflo-core@ruflo --marketplace ruvnet/ruflo`. Mods run with your account's permissions, so review their code before installing.
61
+
62
+ **Codex or another MCP client, without project setup.** Configure the **command** `npx` with the **arguments** `["-y", "ruflo@latest", "mcp", "start"]`. To set up a project interactively, run `npx ruflo@latest init wizard`.
56
63
 
57
- <img src="docs/assets/readme/icons/terminal.svg" width="28" height="28" alt=""> **Prefer a plain terminal? Optional.** The console also runs on its own, with no Claude Code: `npx ruflo tui` (add `--plain` to print one frame for scripts). It shows Overview, Cost, Swarm, Events and Missions, plus an optional AI page. [Terminal UI guide](docs/USERGUIDE.md#terminal-ui-optional)
64
+ **Plain terminal.** The console also runs on its own, without Claude Code: `npx ruflo tui`. Add `--plain` to print one frame for scripts. See the [terminal UI guide](docs/USERGUIDE.md#terminal-ui-optional).
58
65
 
59
66
  <p align="center"><img src="docs/assets/ruflo-tui-compact.svg" width="640" alt="Looping recording of the optional ruflo terminal UI with its pictures: Overview in the Classic BBS look, the Orbital look with its moving globe, and the Swarm graph, in a sample project"></p>
60
67
 
61
- [Compare install paths](#quick-start) · [Open the console](#console-walkthrough) · [User guide](docs/USERGUIDE.md)
68
+ </details>
62
69
 
63
70
  <div align="center">
64
71
 
@@ -484,6 +491,7 @@ Four docs for four audiences:
484
491
  |-----|-----------------|
485
492
  | **[Status](docs/STATUS.md)** | See what currently works — capability counts, test baselines, recent fixes, what's next. The *is-it-ready* doc. |
486
493
  | **[User Guide](docs/USERGUIDE.md)** | Daily reference — every command, every config flag, every plugin. The *how-do-I* doc. |
494
+ | **[Compare frameworks](docs/compare.md)** | Deciding between Ruflo, Claude Code built-in agents, CrewAI, LangGraph, or AutoGen. The *which-one-for-me* doc. |
487
495
  | **[MetaHarness Guide](docs/metaharness-user-guide.md)** | How to grade your agent setup, scan tool configs for security, detect changes between runs, and eject a project into a standalone agent toolkit. The *audit-my-setup* doc. |
488
496
  | **[Benchmarks](https://gist.github.com/ruvnet/298f8c668c8859b369f91734a0e9cbbe)** | v3.8.0 SOTA matrix vs LangGraph / AutoGen / CrewAI on darwin-arm64 + linux-x64. ruflo wins cold start, single turn, RSS by 1.3×–1953×. The *is-it-fast* doc. |
489
497
  | **[Verification](verification.md)** | Cryptographically prove your installed bytes match the signed witness — `ruflo verify`. The *trust-but-verify* doc. |
package/README.zh-CN.md CHANGED
@@ -1,11 +1,13 @@
1
1
  <div align="center">
2
2
 
3
- [![Ruflo Banner](ruflo/assets/ruflo-small.jpeg)](https://cognitum.one/agentic-engineering)
3
+ <a href="https://cognitum.one/agentic-engineering"><img src="ruflo/assets/ruflo-neon-flicker.gif" alt="Ruflo animated neon sign" width="100%"></a>
4
+
5
+ **面向 Claude Code 与 Codex 的智能体元基座(meta-harness)。**
4
6
 
5
7
  <!-- Try Ruflo — the 3 badges first-time visitors actually act on -->
6
8
  [![npm version (ruflo)](https://img.shields.io/npm/v/ruflo?label=npx%20ruflo&style=for-the-badge&logo=npm&color=cb3837)](https://www.npmjs.com/package/ruflo)
7
9
  [![MIT License](https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge)](https://opensource.org/licenses/MIT)
8
- [![Star on GitHub](https://img.shields.io/github/stars/ruvnet/claude-flow?style=for-the-badge&logo=github&color=gold)](https://github.com/ruvnet/claude-flow)
10
+ [![Star on GitHub](https://img.shields.io/github/stars/ruvnet/ruflo?style=for-the-badge&logo=github&color=gold)](https://github.com/ruvnet/ruflo)
9
11
 
10
12
  <!-- Ecosystem strip (collapsed visually with flat-square) -->
11
13
  [![🕸️ RuVector Agentic DB](https://img.shields.io/badge/RuVector_Agentic-DB-06b6d4?style=flat-square&logoColor=white&logo=graphql)](https://github.com/ruvnet/ruvector)
@@ -14,12 +16,75 @@
14
16
  [![Claude Code](https://img.shields.io/badge/Claude%20Code-Plugin-D97757?style=flat-square&logoColor=white&logo=anthropic)](https://github.com/ruvnet/claude-flow)
15
17
  [![Codex Plugin](https://img.shields.io/badge/Codex-Plugin-412991?style=flat-square&logoColor=white&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI%2BPHBhdGggZmlsbD0id2hpdGUiIGQ9Ik0yMi4yODIgOS44MjFhNS45ODUgNS45ODUgMCAwIDAtLjUxNi00LjkxIDYuMDQ2IDYuMDQ2IDAgMCAwLTYuNTEtMi45QTYuMDY1IDYuMDY1IDAgMCAwIDQuOTgxIDQuMThhNS45ODUgNS45ODUgMCAwIDAtMy45OTggMi45IDYuMDQ2IDYuMDQ2IDAgMCAwIC43NDMgNy4wOTcgNS45OCA1Ljk4IDAgMCAwIC41MSA0LjkxMSA2LjA1MSA2LjA1MSAwIDAgMCA2LjUxNSAyLjlBNS45ODUgNS45ODUgMCAwIDAgMTMuMjYgMjRhNi4wNTYgNi4wNTYgMCAwIDAgNS43NzItNC4yMDYgNS45OSA1Ljk5IDAgMCAwIDMuOTk4LTIuOSA2LjA1NiA2LjA1NiAwIDAgMC0uNzQ3LTcuMDczek0xMy4yNiAyMi40M2E0LjQ3NiA0LjQ3NiAwIDAgMS0yLjg3Ni0xLjA0bC4xNDItLjA4IDQuNzc4LTIuNzU4YS43OTUuNzk1IDAgMCAwIC4zOTMtLjY4MXYtNi43MzdsMi4wMiAxLjE2OGEuMDcxLjA3MSAwIDAgMSAuMDM4LjA1MnY1LjU4M2E0LjUwNCA0LjUwNCAwIDAgMS00LjQ5NSA0LjQ5NHpNMy42IDE4LjMwNGE0LjQ3IDQuNDcgMCAwIDEtLjUzNS0zLjAxNGwuMTQyLjA4NSA0Ljc4MyAyLjc1OWEuNzcxLjc3MSAwIDAgMCAuNzgxIDBsNS44NDMtMy4zNjl2Mi4zMzJhLjA4LjA4IDAgMCAxLS4wMzMuMDYyTDkuNzQgMTkuOTVhNC41IDQuNSAwIDAgMS02LjE0LTEuNjQ2ek0yLjM0IDcuODk2YTQuNDg1IDQuNDg1IDAgMCAxIDIuMzY2LTEuOTczVjExLjZhLjc2Ni43NjYgMCAwIDAgLjM4OC42NzdsNS44MTUgMy4zNTQtMi4wMiAxLjE2OGEuMDc2LjA3NiAwIDAgMS0uMDcyIDBsLTQuODMtMi43ODZBNC41MDQgNC41MDQgMCAwIDEgMi4zNCA3Ljg3MnptMTYuNTk3IDMuODU1LTUuODMzLTMuMzg3IDIuMDE2LTEuMTY1YS4wNzYuMDc2IDAgMCAxIC4wNzEgMGw0LjgzIDIuNzkxYTQuNDk0IDQuNDk0IDAgMCAxLS42NzYgOC4xMDR2LTUuNjc3YS43OS43OSAwIDAgMC0uNDA3LS42Njd6bTIuMDEtMy4wMjMtLjE0MS0uMDg1LTQuNzc0LTIuNzgyYS43NzYuNzc2IDAgMCAwLS43ODUgMEw5LjQwOSA5LjIzVjYuODk3YS4wNjYuMDY2IDAgMCAxIC4wMjgtLjA2Mmw0LjgzLTIuNzg3YTQuNDk5IDQuNDk5IDAgMCAxIDYuNjggNC42NnpNOC4zMDcgMTIuODYzbC0yLjAyLTEuMTY0YS4wOC4wOCAwIDAgMS0uMDM4LS4wNTdWNi4wNzRhNC40OTkgNC40OTkgMCAwIDEgNy4zNzYtMy40NTRsLS4xNDIuMDgtNC43NzggMi43NThhLjc5NS43OTUgMCAwIDAtLjM5My42ODJ6bTEuMDk3LTIuMzY2IDIuNjAyLTEuNSAyLjYwNyAxLjV2Mi45OTlsLTIuNTk3IDEuNS0yLjYwNy0xLjVaIi8%2BPC9zdmc%2B)](https://www.npmjs.com/package/@claude-flow/codex)
16
18
 
19
+ <a id="start-here"></a>
20
+
21
+ ## <img src="docs/assets/readme/icons/terminal.svg" width="32" height="32" alt=""> 一条命令快速开始
22
+
23
+ 在你的项目文件夹中运行:
24
+
25
+ ```bash
26
+ npx ruflo@latest init
27
+ ```
28
+
29
+ 然后在同一文件夹打开 Claude Code 并给它一个真实的任务,例如:
30
+
31
+ ```text
32
+ 用 ruflo 蜂群来审查这个代码库:找出风险最高的模块,为它写测试,总结你改了什么。
33
+ ```
34
+
35
+ `init` 会为项目添加 ruflo 的智能体、钩子、记忆和 MCP 服务器。Claude Code 在下次启动时会自动识别它们。Codex 和其他 MCP 客户端也支持:只需指向 `npx -y ruflo@latest mcp start`。
36
+
37
+ <p align="center"><img src="docs/assets/ruflo-console-tour.gif" width="720" alt="ruflo 控制台演示:概览、蜂群视图和任务"></p>
38
+
39
+ [第一个实用任务,逐步讲解](docs/ruflo-explained.md) · [用户指南](docs/USERGUIDE.md) · [比较安装路径](#快速开始)
40
+
41
+ <details>
42
+ <summary><b>其他安装方式</b>(仅 Claude Code 插件、MCP 客户端、终端 UI)</summary>
43
+
44
+ **仅 Claude Code 插件。** 这种方式安装核心工具、可视控制台和运行时 mod,无需向项目添加文件。需要 Claude Code **2.1.287 或更高版本**。在 Claude Code 中运行:
45
+
46
+ ```text
47
+ /plugin marketplace add ruvnet/ruflo
48
+ /plugin install ruflo-core@ruflo
49
+ /plugin install ruflo-console@ruflo
50
+ /plugin install ruflo-mods@ruflo
51
+ /reload-plugins
52
+ /ruflo
53
+ ```
54
+
55
+ 从终端运行(Claude Code 2.1.292 或更高版本):`claude plugin install ruflo-core@ruflo --marketplace ruvnet/ruflo`。Mod 运行在你的账户权限下,安装前请审查代码。
56
+
57
+ **Codex 或其他 MCP 客户端,无需项目配置。** 配置 **命令** 为 `npx`,**参数** 为 `["-y", "ruflo@latest", "mcp", "start"]`。要进行交互式项目配置,运行 `npx ruflo@latest init wizard`。
58
+
59
+ **纯终端。** 控制台也可独立运行,无需 Claude Code:`npx ruflo tui`。加上 `--plain` 为脚本打印单一画面。详见[终端 UI 指南](docs/USERGUIDE.md#terminal-ui-optional)。
60
+
61
+ <p align="center"><img src="docs/assets/ruflo-tui-compact.svg" width="640" alt="可选的 ruflo 终端 UI 及其界面:经典 BBS 外观、带移动地球的 Orbital 外观、和蜂群图表"></p>
62
+
63
+ </details>
64
+
65
+ <div align="center">
66
+
67
+ ### 可选:ruOS Desktop
68
+
69
+ <a href="https://ruos.cognitum.one"><img src="ruflo/assets/ruos-animated.svg" alt="ruOS — 一个能自己运行的桌面" width="100%"></a>
70
+
71
+ **通过 MCP 将 ruOS 连接到 ChatGPT 或 Claude:**
72
+
73
+ ```text
74
+ https://ruos.cognitum.one/mcp
75
+ ```
76
+
77
+ <!-- RuVector promo -->
78
+ <a href="https://github.com/ruvnet/ruvector"><img src="docs/assets/readme/ruvector-promo-depth.svg" width="100%" alt="RuVector:给智能体加装记忆。本地向量搜索、持久上下文、图关系、反馈学习。探索 RuVector。"></a>
79
+
80
+ ```bash
81
+ npx ruvector
82
+ ```
83
+
17
84
  # Ruflo
18
85
 
19
86
  [English](README.md) · [简体中文](README.zh-CN.md)
20
87
 
21
- **面向 Claude Code 与 Codex 的智能体元基座(meta-harness)。**
22
-
23
88
  [![RuFlo Explained — build an AI team that plans, remembers, tests, and improves](docs/assets/ruflo-explained/ch14.jpg)](docs/ruflo-explained.md)
24
89
 
25
90
  **[📖 RuFlo 详解——组建一支会规划、会记忆、会测试、会自我改进的 AI 团队](docs/ruflo-explained.md)**
File without changes
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@claude-flow/plugin-agent-federation",
3
- "version": "1.0.5",
3
+ "version": "1.0.7",
4
4
  "description": "Cross-installation agent federation with zero-trust security, PII-gated data flow, and compliance-grade audit trails.",
5
5
  "homepage": "https://github.com/ruvnet/ruflo",
6
6
  "type": "module",
@@ -26,7 +26,7 @@
26
26
  "@claude-flow/shared": "^3.0.0",
27
27
  "@claude-flow/security": "^3.0.0",
28
28
  "@types/ws": "^8.18.1",
29
- "agentic-flow": "2.0.12-fix.8",
29
+ "agentic-flow": "2.0.14",
30
30
  "typescript": "^5.4.0",
31
31
  "vitest": "^4.1.0"
32
32
  },
@@ -46,11 +46,11 @@
46
46
  "sourceDependencies": {
47
47
  "dependencies": {
48
48
  "@noble/ed25519": "^2.0.0",
49
- "ws": "^8.20.0"
49
+ "ws": "^8.21.0"
50
50
  },
51
51
  "peerDependencies": {
52
- "agentic-flow": ">=2.0.12-fix.8 <4.0.0",
53
- "midstreamer": ">=0.3.1"
52
+ "agentic-flow": "^2.0.14 || ^3.0.0",
53
+ "midstreamer": "^0.3.2"
54
54
  },
55
55
  "peerDependenciesMeta": {
56
56
  "agentic-flow": {
@@ -159,14 +159,14 @@ export declare const SpawnAgentSchema: z.ZodObject<{
159
159
  timeout: z.ZodOptional<z.ZodNumber>;
160
160
  }, "strip", z.ZodTypeAny, {
161
161
  type: "coder" | "reviewer" | "tester" | "planner" | "researcher" | "security-architect" | "security-auditor" | "memory-specialist" | "swarm-specialist" | "integration-architect" | "performance-engineer" | "core-architect" | "test-architect" | "queen-coordinator" | "project-coordinator";
162
+ id?: string | undefined;
162
163
  config?: Record<string, unknown> | undefined;
163
164
  timeout?: number | undefined;
164
- id?: string | undefined;
165
165
  }, {
166
166
  type: "coder" | "reviewer" | "tester" | "planner" | "researcher" | "security-architect" | "security-auditor" | "memory-specialist" | "swarm-specialist" | "integration-architect" | "performance-engineer" | "core-architect" | "test-architect" | "queen-coordinator" | "project-coordinator";
167
+ id?: string | undefined;
167
168
  config?: Record<string, unknown> | undefined;
168
169
  timeout?: number | undefined;
169
- id?: string | undefined;
170
170
  }>;
171
171
  /**
172
172
  * Task input schema
@@ -181,13 +181,13 @@ export declare const TaskInputSchema: z.ZodObject<{
181
181
  taskId: string;
182
182
  content: string;
183
183
  agentType: "coder" | "reviewer" | "tester" | "planner" | "researcher" | "security-architect" | "security-auditor" | "memory-specialist" | "swarm-specialist" | "integration-architect" | "performance-engineer" | "core-architect" | "test-architect" | "queen-coordinator" | "project-coordinator";
184
- priority?: "critical" | "high" | "medium" | "low" | undefined;
184
+ priority?: "low" | "medium" | "high" | "critical" | undefined;
185
185
  metadata?: Record<string, unknown> | undefined;
186
186
  }, {
187
187
  taskId: string;
188
188
  content: string;
189
189
  agentType: "coder" | "reviewer" | "tester" | "planner" | "researcher" | "security-architect" | "security-auditor" | "memory-specialist" | "swarm-specialist" | "integration-architect" | "performance-engineer" | "core-architect" | "test-architect" | "queen-coordinator" | "project-coordinator";
190
- priority?: "critical" | "high" | "medium" | "low" | undefined;
190
+ priority?: "low" | "medium" | "high" | "critical" | undefined;
191
191
  metadata?: Record<string, unknown> | undefined;
192
192
  }>;
193
193
  /**
@@ -234,16 +234,16 @@ export declare const ExecutorConfigSchema: z.ZodObject<{
234
234
  cwd: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
235
235
  allowSudo: z.ZodDefault<z.ZodBoolean>;
236
236
  }, "strip", z.ZodTypeAny, {
237
- allowedCommands: string[];
238
237
  timeout: number;
238
+ allowedCommands: string[];
239
239
  maxBuffer: number;
240
240
  allowSudo: boolean;
241
241
  blockedPatterns?: string[] | undefined;
242
242
  cwd?: string | undefined;
243
243
  }, {
244
244
  allowedCommands: string[];
245
- blockedPatterns?: string[] | undefined;
246
245
  timeout?: number | undefined;
246
+ blockedPatterns?: string[] | undefined;
247
247
  maxBuffer?: number | undefined;
248
248
  cwd?: string | undefined;
249
249
  allowSudo?: boolean | undefined;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "claude-flow",
3
- "version": "3.72.1",
3
+ "version": "3.73.0",
4
4
  "workspaces": [
5
5
  "v3/@claude-flow/codex",
6
6
  "v3/@claude-flow/mcp",
@@ -72,23 +72,24 @@
72
72
  "@claude-flow/cli-core": "3.7.5",
73
73
  "@claude-flow/codex": "3.0.6",
74
74
  "@claude-flow/mcp": "3.1.6",
75
- "@claude-flow/neural": "3.0.2",
76
- "@claude-flow/plugin-agent-federation": "1.0.5",
75
+ "@claude-flow/neural": "3.0.3",
76
+ "@claude-flow/plugin-agent-federation": "1.0.7",
77
77
  "@claude-flow/security": "3.0.6",
78
78
  "@claude-flow/shared": "3.0.7",
79
79
  "@electron/asar": "^4.3.1",
80
80
  "@iarna/toml": "^2.2.5",
81
81
  "@noble/ed25519": "2.3.0",
82
+ "@ruvector/attention": "^2.2.3",
82
83
  "@ruvector/rabitq-wasm": "0.1.2",
83
84
  "ajv": "^8.20.0",
84
85
  "bcryptjs": "^3.0.3",
85
86
  "chalk": "^5.3.0",
86
87
  "commander": "^12.0.0",
87
88
  "cors": "^2.8.5",
88
- "fs-extra": "^11.2.0",
89
89
  "express": ">=4.22.2",
90
90
  "express-rate-limit": ">=8.4.1",
91
91
  "fast-uri": "^3.1.6",
92
+ "fs-extra": "^11.2.0",
92
93
  "helmet": "^7.2.0",
93
94
  "inquirer": "^9.2.0",
94
95
  "semver": "7.7.3",
@@ -99,20 +100,19 @@
99
100
  "optionalDependencies": {
100
101
  "@napi-rs/keyring": "1.3.0",
101
102
  "@claude-flow/plugin-gastown-bridge": "^0.1.3",
102
- "@ruvector/attention": "^0.1.3",
103
103
  "@ruvector/core": "^0.1.30",
104
104
  "@ruvector/router": "^0.1.31",
105
105
  "@ruvector/router-linux-x64-gnu": "^0.1.31",
106
- "@ruvector/sona": "^0.1.5",
106
+ "@ruvector/sona": "^0.1.11",
107
107
  "agentdb": "^3.3.0",
108
108
  "agentic-flow": "^3.0.0",
109
109
  "better-sqlite3": "12.9.0",
110
- "ruvector": "^0.3.11",
110
+ "ruvector": "^0.3.13",
111
111
  "@ruvector/learning-wasm": "0.1.29",
112
112
  "agent-booster": "^0.2.2"
113
113
  },
114
114
  "overrides": {
115
- "ruvector": "^0.3.11",
115
+ "ruvector": "^0.3.13",
116
116
  "better-sqlite3": "12.9.0",
117
117
  "js-yaml": ">=4.3.0",
118
118
  "hono": ">=4.13.2",
@@ -7,7 +7,7 @@
7
7
  <!-- Try Ruflo — the 3 badges first-time visitors actually act on -->
8
8
  [![npm version (ruflo)](https://img.shields.io/npm/v/ruflo?label=npx%20ruflo&style=for-the-badge&logo=npm&color=cb3837)](https://www.npmjs.com/package/ruflo)
9
9
  [![MIT License](https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge)](https://opensource.org/licenses/MIT)
10
- [![Star on GitHub](https://img.shields.io/github/stars/ruvnet/claude-flow?style=for-the-badge&logo=github&color=gold)](https://github.com/ruvnet/claude-flow)
10
+ [![Star on GitHub](https://img.shields.io/github/stars/ruvnet/ruflo?style=for-the-badge&logo=github&color=gold)](https://github.com/ruvnet/ruflo)
11
11
  [![Follow @rUv on X](https://img.shields.io/badge/Follow-@rUv-000000?style=for-the-badge&logo=x&logoColor=white)](https://x.com/rUv)
12
12
 
13
13
  <p align="center">
@@ -23,42 +23,49 @@
23
23
 
24
24
  <a id="start-here"></a>
25
25
 
26
- ## <img src="docs/assets/readme/icons/terminal.svg" width="32" height="32" alt=""> Get started with Ruflo
26
+ ## <img src="docs/assets/readme/icons/terminal.svg" width="32" height="32" alt=""> Get started in one command
27
27
 
28
- <img src="docs/assets/readme/icons/plugins.svg" width="28" height="28" alt=""> **Start in Claude Code** with core tools, the visual console and runtime mods. Requires Claude Code **2.1.287 or later**. Run inside Claude Code:
28
+ Run this in your project folder:
29
+
30
+ ```bash
31
+ npx ruflo@latest init
32
+ ```
33
+
34
+ Then open Claude Code in the same folder and give it a real task, for example:
29
35
 
30
36
  ```text
31
- /plugin marketplace add ruvnet/ruflo
32
- /plugin install ruflo-core@ruflo
33
- /plugin install ruflo-console@ruflo
34
- /plugin install ruflo-mods@ruflo
35
- /reload-plugins
36
- /ruflo
37
+ Use a ruflo swarm to review this repo: find the riskiest module, write tests for it, and summarise what you changed.
37
38
  ```
38
39
 
39
- From a terminal on Claude Code 2.1.292 or later, one command adds the marketplace and installs a plugin: `claude plugin install ruflo-core@ruflo --marketplace ruvnet/ruflo`.
40
+ `init` adds ruflo's agents, hooks, memory and MCP server to the project, and Claude Code picks them up on its next start. Codex and other MCP clients work too: point them at `npx -y ruflo@latest mcp start`.
40
41
 
41
- **Core** provides foundation tools. **Console** opens the agent cockpit. **Mods** add routing and policy enforcement inside Claude Code. Mods run with your account's permissions; review their code before installing.
42
+ <p align="center"><img src="docs/assets/ruflo-console-tour.gif" width="720" alt="Looping recording of the ruflo console: overview, swarm view and missions in a sample project"></p>
42
43
 
43
- <img src="docs/assets/readme/icons/terminal.svg" width="28" height="28" alt=""> **Using Codex or another MCP enabled tool?** Use NPX for Ruflo project setup and connect your client to the Ruflo MCP server. Run the setup wizard in your project terminal:
44
+ [First useful task, step by step](docs/ruflo-explained.md) · [User guide](docs/USERGUIDE.md) · [Compare install paths](#quick-start)
44
45
 
45
- ```bash
46
- npx ruflo@latest init wizard
47
- ```
46
+ <details>
47
+ <summary><b>Other ways to install</b> (Claude Code plugins only, MCP-only clients, terminal UI)</summary>
48
48
 
49
- For clients that support local stdio MCP servers, configure **command** `npx` and **arguments** `["-y", "ruflo@latest", "mcp", "start"]`. The equivalent server command is:
49
+ **Claude Code plugins only.** This route installs core tools, the visual console and runtime mods, with no files added to your project. It needs Claude Code **2.1.287 or later**. Run inside Claude Code:
50
50
 
51
- ```bash
52
- npx -y ruflo@latest mcp start
51
+ ```text
52
+ /plugin marketplace add ruvnet/ruflo
53
+ /plugin install ruflo-core@ruflo
54
+ /plugin install ruflo-console@ruflo
55
+ /plugin install ruflo-mods@ruflo
56
+ /reload-plugins
57
+ /ruflo
53
58
  ```
54
59
 
55
- MCP exposes Ruflo tools to your client. The console and mods above are Claude Code integrations; hook support depends on the client.
60
+ From a terminal, on Claude Code 2.1.292 or later: `claude plugin install ruflo-core@ruflo --marketplace ruvnet/ruflo`. Mods run with your account's permissions, so review their code before installing.
61
+
62
+ **Codex or another MCP client, without project setup.** Configure the **command** `npx` with the **arguments** `["-y", "ruflo@latest", "mcp", "start"]`. To set up a project interactively, run `npx ruflo@latest init wizard`.
56
63
 
57
- <img src="docs/assets/readme/icons/terminal.svg" width="28" height="28" alt=""> **Prefer a plain terminal? Optional.** The console also runs on its own, with no Claude Code: `npx ruflo tui` (add `--plain` to print one frame for scripts). It shows Overview, Cost, Swarm, Events and Missions, plus an optional AI page. [Terminal UI guide](docs/USERGUIDE.md#terminal-ui-optional)
64
+ **Plain terminal.** The console also runs on its own, without Claude Code: `npx ruflo tui`. Add `--plain` to print one frame for scripts. See the [terminal UI guide](docs/USERGUIDE.md#terminal-ui-optional).
58
65
 
59
66
  <p align="center"><img src="docs/assets/ruflo-tui-compact.svg" width="640" alt="Looping recording of the optional ruflo terminal UI with its pictures: Overview in the Classic BBS look, the Orbital look with its moving globe, and the Swarm graph, in a sample project"></p>
60
67
 
61
- [Compare install paths](#quick-start) · [Open the console](#console-walkthrough) · [User guide](docs/USERGUIDE.md)
68
+ </details>
62
69
 
63
70
  <div align="center">
64
71
 
@@ -484,6 +491,7 @@ Four docs for four audiences:
484
491
  |-----|-----------------|
485
492
  | **[Status](docs/STATUS.md)** | See what currently works — capability counts, test baselines, recent fixes, what's next. The *is-it-ready* doc. |
486
493
  | **[User Guide](docs/USERGUIDE.md)** | Daily reference — every command, every config flag, every plugin. The *how-do-I* doc. |
494
+ | **[Compare frameworks](docs/compare.md)** | Deciding between Ruflo, Claude Code built-in agents, CrewAI, LangGraph, or AutoGen. The *which-one-for-me* doc. |
487
495
  | **[MetaHarness Guide](docs/metaharness-user-guide.md)** | How to grade your agent setup, scan tool configs for security, detect changes between runs, and eject a project into a standalone agent toolkit. The *audit-my-setup* doc. |
488
496
  | **[Benchmarks](https://gist.github.com/ruvnet/298f8c668c8859b369f91734a0e9cbbe)** | v3.8.0 SOTA matrix vs LangGraph / AutoGen / CrewAI on darwin-arm64 + linux-x64. ruflo wins cold start, single turn, RSS by 1.3×–1953×. The *is-it-fast* doc. |
489
497
  | **[Verification](verification.md)** | Cryptographically prove your installed bytes match the signed witness — `ruflo verify`. The *trust-but-verify* doc. |
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "schemaVersion": 1,
3
3
  "generation": 7,
4
- "generatedAt": "2026-11-06T02:50:18.000Z",
5
- "gitSha": "29b327ee",
4
+ "generatedAt": "2026-11-09T01:20:38.869Z",
5
+ "gitSha": "a8b3304b",
6
6
  "catalog": {
7
7
  "agents": 177,
8
8
  "tools": 451,
@@ -9,6 +9,7 @@ import { wasmSubcommands } from './agent-wasm.js';
9
9
  import { agentPublishCommand } from './agntcy/publish.js';
10
10
  import * as fs from 'fs';
11
11
  import * as path from 'path';
12
+ import { noteFirstAgentRun } from '../funnel/activation.js';
12
13
  /**
13
14
  * Update swarm-activity.json metrics after agent count changes.
14
15
  * The statusline reads this file to display the swarm agent count.
@@ -172,6 +173,7 @@ const spawnCommand = {
172
173
  if (ctx.flags.format === 'json') {
173
174
  output.printJson(result);
174
175
  }
176
+ noteFirstAgentRun('cli'); // activation funnel (opt-in; no-op without telemetry consent)
175
177
  return { success: true, data: result };
176
178
  }
177
179
  catch (error) {
@@ -11,6 +11,7 @@
11
11
  * funnel earnings show accrued and paid revenue-share balance
12
12
  * funnel unenroll revoke local enrollment (funnel itself stays enabled)
13
13
  * funnel id print the pseudonymous funnel ID, if one exists
14
+ * funnel telemetry opt in or out of anonymous usage telemetry (on | off | status)
14
15
  */
15
16
  import type { Command } from '../types.js';
16
17
  export declare const funnelCommand: Command;
@@ -11,6 +11,7 @@
11
11
  * funnel earnings show accrued and paid revenue-share balance
12
12
  * funnel unenroll revoke local enrollment (funnel itself stays enabled)
13
13
  * funnel id print the pseudonymous funnel ID, if one exists
14
+ * funnel telemetry opt in or out of anonymous usage telemetry (on | off | status)
14
15
  */
15
16
  import { execFile } from 'node:child_process';
16
17
  import * as fs from 'node:fs';
@@ -63,11 +64,45 @@ const disableSub = {
63
64
  action: async () => {
64
65
  setUserConfigEnabled(false);
65
66
  recordDisclosureDeclined();
67
+ // "All surfaces" includes opt-in event telemetry: revoke it too.
68
+ if (hasConsent('telemetry'))
69
+ recordConsent('telemetry', false, 'cli-funnel-disable');
66
70
  deleteFunnelData(); // opt-out deletes the pseudonymous ID + local event queue
67
- output.printSuccess('Funnel disabled. All promotional surfaces are off; local funnel data deleted.');
71
+ output.printSuccess('Funnel disabled. All promotional surfaces are off, no funnel.ruv.io requests are made, and local funnel data is deleted.');
68
72
  return { success: true };
69
73
  },
70
74
  };
75
+ // ADR-302 consent domain `telemetry` (ADR-305/309): explicit opt-in to the
76
+ // anonymous funnel event stream. Enrollment never toggles it; only this
77
+ // command does. Off by default.
78
+ const telemetrySub = {
79
+ name: 'telemetry',
80
+ description: 'Opt in or out of anonymous usage telemetry: telemetry on | off | status',
81
+ action: async (ctx) => {
82
+ const verb = String(ctx.args[0] ?? 'status').toLowerCase();
83
+ if (verb === 'on') {
84
+ recordConsent('telemetry', true, 'cli-funnel-telemetry');
85
+ const id = getFunnelId();
86
+ output.printSuccess('Telemetry on. Once per session ruflo sends anonymous funnel events (daily-bucketed, no paths, prompts, code or account data) with a random ID that rotates every 90 days.');
87
+ output.writeln('Turn it off any time with `ruflo funnel telemetry off`; that also deletes the ID and the local event queue.');
88
+ return { success: true, data: { telemetry: true, id } };
89
+ }
90
+ if (verb === 'off') {
91
+ recordConsent('telemetry', false, 'cli-funnel-telemetry');
92
+ deleteFunnelData();
93
+ output.printSuccess('Telemetry off. The pseudonymous ID and the local event queue are deleted.');
94
+ return { success: true, data: { telemetry: false } };
95
+ }
96
+ if (verb !== 'status') {
97
+ output.printError(`Unknown telemetry option "${verb}". Use: on | off | status`);
98
+ return { success: false, exitCode: 1 };
99
+ }
100
+ const on = hasConsent('telemetry');
101
+ output.writeln(`Telemetry: ${on ? 'on (opted in)' : 'off'}`);
102
+ output.writeln('Without opting in, ruflo makes one anonymous request per session to fetch tips (release + OS only); `ruflo funnel disable` stops that too.');
103
+ return { success: true, data: { telemetry: on } };
104
+ },
105
+ };
71
106
  const enableSub = {
72
107
  name: 'enable',
73
108
  description: 'Re-enable funnel surfaces at the user tier (env/enterprise disables still win)',
@@ -287,7 +322,7 @@ const idSub = {
287
322
  export const funnelCommand = {
288
323
  name: 'funnel',
289
324
  description: 'Control the Cognitum lifecycle funnel surfaces (tips, enrollment, notices)',
290
- subcommands: [statusSub, disableSub, enableSub, acceptSub, openSub, enrollSub, earningsSub, unenrollSub, idSub],
325
+ subcommands: [statusSub, disableSub, enableSub, acceptSub, openSub, enrollSub, earningsSub, unenrollSub, idSub, telemetrySub],
291
326
  examples: [
292
327
  { command: 'ruflo funnel status', description: 'Effective state + deciding source' },
293
328
  { command: 'ruflo funnel accept', description: 'Skip the 24h grace so rotation starts now' },