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

chore(release): correct stable train to v3.32.29 (#2826)

rUv1d305b133ee9
diff --git a/package-lock.json b/package-lock.json
index a7d8eeed8f..30b9fc52c8 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "claude-flow",
- "version": "3.32.28",
+ "version": "3.32.29",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "claude-flow",
- "version": "3.32.28",
+ "version": "3.32.29",
"license": "MIT",
"dependencies": {
"@claude-flow/cli-core": "3.7.0-alpha.5",
diff --git a/package.json b/package.json
index c765cf12c1..6402bdca13 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
{
"name": "claude-flow",
- "version": "3.32.28",
+ "version": "3.32.29",
"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",
"main": "dist/index.js",
"type": "module",
diff --git a/ruflo/package.json b/ruflo/package.json
index c2cda77a54..7fde14505c 100644
--- a/ruflo/package.json
+++ b/ruflo/package.json
@@ -1,6 +1,6 @@
{
"name": "ruflo",
- "version": "3.32.28",
+ "version": "3.32.29",
"description": "Ruflo - Enterprise AI agent orchestration platform. Deploy 60+ specialized agents in coordinated swarms with self-learning, fault-tolerant consensus, vector memory, and MCP integration",
"main": "bin/ruflo.js",
"type": "module",
@@ -40,7 +40,7 @@
"package:rvf": "bash src/scripts/package-rvf.sh"
},
"dependencies": {
- "@claude-flow/cli": "^3.32.28"
+ "@claude-flow/cli": "^3.32.29"
},
"optionalDependencies": {},
"overrides": {
diff --git a/v3/@claude-flow/cli/.claude/helpers/.helpers-version b/v3/@claude-flow/cli/.claude/helpers/.helpers-version
index 5eef9918a4..f38963b891 100644
--- a/v3/@claude-flow/cli/.claude/helpers/.helpers-version
+++ b/v3/@claude-flow/cli/.claude/helpers/.helpers-version
@@ -1 +1 @@
-3.32.28
\ No newline at end of file
+3.32.29
diff --git a/v3/@claude-flow/cli/.claude/helpers/helpers.manifest.json b/v3/@claude-flow/cli/.claude/helpers/helpers.manifest.json
index fac9180509..83c2764966 100644
--- a/v3/@claude-flow/cli/.claude/helpers/helpers.manifest.json
+++ b/v3/@claude-flow/cli/.claude/helpers/helpers.manifest.json
@@ -1,6 +1,6 @@
{
"manifest": {
- "version": "3.32.28",
+ "version": "3.32.29",
"files": {
"auto-memory-hook.mjs": "68be7e9a9eba7bf9c4e8a230db7bf61a243b965639f8504842799d6c6ca28762",
"hook-handler.cjs": "50ea92a72651bdc95634f7588d56a5870963168eef5226f66ed14af3b47c8d9a",
@@ -8,6 +8,6 @@
"statusline.cjs": "d2a0eac56d1267d8dbed2d70b09feb592299469196ec4b215909f2b052144882"
}
},
- "signature": "Kht297XxwiocrMlfrPu6wlWg14RgBKM8twlvRHMmwZ+TBvRRBZGs6WfwBr05ozwVlmguO3V8zDv062k3UB1qDQ==",
+ "signature": "jF/krskPhEF+3m0rkY3my1qEuLZec5hzo3YoV7xUl8/7xZqlpTctkB9QlYACViu2GCK3AGkWS7BRf5xR6WK7Aw==",
"algorithm": "ed25519"
}
diff --git a/v3/@claude-flow/cli/package.json b/v3/@claude-flow/cli/package.json
index 75a6ff0dab..5c1ae25cf1 100644
--- a/v3/@claude-flow/cli/package.json
+++ b/v3/@claude-flow/cli/package.json
@@ -1,6 +1,6 @@
{
"name": "@claude-flow/cli",
- "version": "3.32.28",
+ "version": "3.32.29",
"type": "module",
"description": "Ruflo CLI - Enterprise AI agent orchestration with 60+ specialized agents, swarm coordination, MCP server, self-learning hooks, and vector memory for Claude Code",
"main": "dist/src/index.js",
diff --git a/v3/@claude-flow/plugin-agent-federation/__tests__/unit/plugin.test.ts b/v3/@claude-flow/plugin-agent-federation/__tests__/unit/plugin.test.ts
index 058bfdf18e..c37567d437 100644
--- a/v3/@claude-flow/plugin-agent-federation/__tests__/unit/plugin.test.ts
+++ b/v3/@claude-flow/plugin-agent-federation/__tests__/unit/plugin.test.ts
@@ -59,8 +59,8 @@ describe('AgentFederationPlugin', () => {
expect(plugin.name).toBe('@claude-flow/plugin-agent-federation');
});
- it('should have version set to 1.0.0-alpha.17', () => {
- expect(plugin.version).toBe('1.0.0-alpha.17');
+ it('should have version set to 1.0.0-alpha.18', () => {
+ expect(plugin.version).toBe('1.0.0-alpha.18');
});
it('should have a non-empty description', () => {
diff --git a/v3/@claude-flow/plugin-agent-federation/package.json b/v3/@claude-flow/plugin-agent-federation/package.json
index 3b88ac3389..61ea923010 100644
--- a/v3/@claude-flow/plugin-agent-federation/package.json
+++ b/v3/@claude-flow/plugin-agent-federation/package.json
@@ -1,6 +1,6 @@
{
"name": "@claude-flow/plugin-agent-federation",
- "version": "1.0.0-alpha.17",
+ "version": "1.0.0-alpha.18",
"description": "Cross-installation agent federation with zero-trust security, PII-gated data flow, and compliance-grade audit trails.",
"homepage": "https://github.com/ruvnet/ruflo",
"type": "module",
diff --git a/v3/@claude-flow/plugin-agent-federation/src/version.ts b/v3/@claude-flow/plugin-agent-federation/src/version.ts
index 960c167938..9722b3b4df 100644
--- a/v3/@claude-flow/plugin-agent-federation/src/version.ts
+++ b/v3/@claude-flow/plugin-agent-federation/src/version.ts
@@ -1,2 +1,2 @@
/** Single source of truth for runtime, manifest, CLI, and MCP version metadata. */
-export const FEDERATION_PLUGIN_VERSION = '1.0.0-alpha.17' as const;
+export const FEDERATION_PLUGIN_VERSION = '1.0.0-alpha.18' as const;
diff --git a/v3/docs/examples/ruflo-capability-brain-guide.md b/v3/docs/examples/ruflo-capability-brain-guide.md
index 42b2f331d8..e10ac913e1 100644
--- a/v3/docs/examples/ruflo-capability-brain-guide.md
+++ b/v3/docs/examples/ruflo-capability-brain-guide.md
@@ -4,7 +4,7 @@ Most agent frameworks make you learn the framework before the agent can use
it well. You memorize tool names, remember which plugin owns what, and discover
too late that ā€œinstalledā€ did not mean ā€œconfiguredā€ or ā€œauthorized.ā€
-Ruflo v3.32.28 changes that. Its new MCP Capability Brain lets an agent inspect
+Ruflo v3.32.29 changes that. Its new MCP Capability Brain lets an agent inspect
the running Ruflo system, see every registered capability, understand the
authority and risk boundary, and choose a safe implementation workflow for the
task in front of it.
@@ -147,14 +147,14 @@ learning.
## Install
```bash
-npm install --global [email protected]
+npm install --global [email protected]
ruflo doctor
```
Or:
```bash
-npx [email protected] --help
+npx [email protected] --help
```
## Compatibility
diff --git a/v3/docs/releases/v3.32.29.md b/v3/docs/releases/v3.32.29.md
new file mode 100644
index 0000000000..4d18bf4926
--- /dev/null
+++ b/v3/docs/releases/v3.32.29.md
@@ -0,0 +1,208 @@
+# Ruflo v3.32.29: Capability Brain — Corrected Stable Train
+
+v3.32.29 is the corrective stable publication of the Capability Brain work
+first preserved in the immutable
+[v3.32.28 source release](https://github.com/ruvnet/ruflo/releases/tag/v3.32.28).
+The v3.32.28 npm train was not published: its release credential was rejected,
+and the intended federation `1.0.0-alpha.17` coordinate was already occupied by
+an older artifact. Ruflo did not move the existing tag or reuse the immutable
+package coordinate.
+
+This release advances `ruflo`, `claude-flow`, and `@claude-flow/cli` to
+`3.32.29`, advances the federation plugin to `1.0.0-alpha.18`, and retains the
+reviewed `@claude-flow/[email protected]` and
+`@claude-flow/[email protected]` components. The original release and its end-user
+gist remain intact. The corrected end-user guide is available as a
+[separate v3.32.29 gist](https://gist.github.com/ruvnet/934130093d333bde1a3f0f83d7d95115).
+
+Ruflo has grown into a large agentic runtime, but its old MCP guidance catalog
+only knew about 61 of the 353 tools available in a fully equipped process. That
+made powerful features hard to discover and made agents more likely to guess
+at stale tool names.
+
+v3.32.29 publishes the Ruflo Capability Brain: a live, machine-readable map of
+the MCP registry, CLI commands, agents, skills, packages, plugins, authority
+boundaries, risk, and the end-to-end implementation loop. Agents can now ask
+Ruflo which capabilities fit a task and automatically choose from tools that
+are actually registered in the current process.
+
+## What you can use it for
+
+- Discover every MCP tool registered in your running Ruflo server.
+- Route a task to suitable tools, agents, skills, and a swarm topology.
+- Find capabilities across `.claude`, `.agents`, installed packages, and Ruflo
+ plugins.
+- Keep optional or remote integrations honest: registered, configured,
+ reachable, healthy, and authorized are reported as different facts.
+- Guide autonomous development through recall, inspection, planning,
+ implementation, testing, validation, benchmarking, optimization, evidence,
+ handoff, and authorized publication.
+- Distinguish policy authorization, exclusive work claims, content-safety
+ evidence, memory learning, consensus, and release authority.
+- Route Cognitum identity through the implemented PKCE/OOB profile lifecycle,
+ while reporting RFC 8628 polling and server-side logout revocation as
+ unavailable instead of guessing.
+
+## Try the Capability Brain
+
+In Codex, Claude Code, or another MCP client, ask the agent:
+
+> Use Ruflo `guidance_brain` to recommend the best workflow for implementing
+> this task, then follow the returned implementation loop.
+
+Or call the MCP tool directly:
+
+```json
+{
+ "name": "guidance_brain",
+ "arguments": {
+ "mode": "recommend",
+ "task": "Implement a secure API change with concurrent agents, tests, benchmarks, and a release"
+ }
+}
+```
+
+Useful modes:
+
+```json
+{"name":"guidance_brain","arguments":{"mode":"overview"}}
+{"name":"guidance_brain","arguments":{"mode":"capabilities","domain":"memory-knowledge"}}
+{"name":"guidance_brain","arguments":{"mode":"coverage"}}
+{"name":"guidance_brain","arguments":{"mode":"ecosystem"}}
+{"name":"guidance_brain","arguments":{"mode":"implementation-loop"}}
+```
+
+The existing `guidance_capabilities`, `guidance_recommend`,
+`guidance_discover`, `guidance_workflow`, and `guidance_quickref` tools remain
+compatible. Their old string catalog is now labeled compatibility-only, and
+stale references are never presented as live recommendations.
+
+## The implementation loop
+
+Generated Codex `AGENTS.md` guidance and capability recommendations now use one
+complete loop:
+
+1. Recall relevant memory and ADR constraints.
+2. Inspect source, runtime, dependencies, policy, and health.
+3. Route to the smallest capable topology and tool set.
+4. Plan acceptance criteria, safety, ownership, and validation.
+5. Execute in isolated scopes; Ruflo coordinates while the coding agent works.
+6. Test focused, regression, and failure paths.
+7. Validate types, security, policy, compatibility, and artifacts.
+8. Benchmark a source-bound candidate against a source-bound baseline.
+9. Optimize measured bottlenecks without weakening safety.
+10. Bind claims and evidence to exact source/build inputs.
+11. Reconcile concurrent handoffs and disclose limitations.
+12. Publish only through a separately authorized release gate.
+
+Learning and optimization remain proposal/evidence capabilities. They cannot
+promote themselves or expand network, secrets, spending, concurrency, or
+policy authority.
+
+## Federation and Cognitum foundations
+
+This release also adds opt-in foundations for policy-governed federation and
+Cognitum product actions:
+
+- Upgraded federation peers advertise recursive JCS/Ed25519 signatures by
+ default. JCS is negotiated only when the join includes a signature-verified
+ peer manifest; endpoint-only joins stay untrusted.
+- Legacy federation signatures are restricted to `heartbeat` and
+ `status-broadcast`; consequential legacy messages are rejected on ingress
+ and fail closed on egress to legacy-only peers.
+- Inbound federation authorization runs after signature verification and
+ before acceptance, replay marking, or event delivery.
+- The Security SDK adds a closed 31-action product vocabulary for the
+ Cognitum dashboard, Meta-LLM, Comms, Cog Studio, RuView, and validated
+ learning.
+- Product envelopes enforce audience, tenant, freshness, capability, policy,
+ Ed25519 signature, action-specific obligations, and atomic replay-store
+ hooks.
+- RuView exports are constrained to registered, privacy-minimized semantic
+ observations rather than raw sensor payloads.
+
+## Concurrent development foundations
+
+The Codex package now exposes:
+
+- content-addressed Git-visible source-state capture;
+- separately declared and recomputable build-input/toolchain evidence;
+- portable path/case ambiguity refusal;
+- in-memory reference implementations for fenced leases, acknowledged inbox
+ semantics, and content-addressed run receipts.
+
+These references are deliberately observe-only, unsigned, non-persistent, and
+single-process. They help adapter authors test semantics; they are not
+distributed release authorities.
+
+## Install or upgrade
+
+```bash
+npm install --global [email protected]
+ruflo doctor
+```
+
+Or run it without a global install:
+
+```bash
+npx [email protected] --help
+```
+
+Package train:
+
+- `@claude-flow/[email protected]`
+- `@claude-flow/[email protected]`
+- `@claude-flow/[email protected]`
+- `@claude-flow/[email protected]`
+
+## Compatibility
+
+- Existing guidance MCP tools remain available.
+- Existing projects stay in their current policy compatibility mode.
+- JCS federation signing is negotiated; no downgrade occurs after a failed JCS
+ verification.
+- Older installations continue local workflows when optional packages are
+ absent.
+- The new Codex harness and Cognitum product-plane APIs are additive exports.
+
+## Local validation and benchmarks
+
+Validated on Node.js 22/Linux:
+
+- Capability Brain: all 353 observed live tools assigned exactly once; zero
+ duplicate or fallback classifications.
+- CLI focused brain/guardrail tests: 12 passing.
+- Codex: 229 tests passing.
+- Security: 559 tests passing.
+- Federation: 638 tests passing.
+- Capability Brain build for a 353-tool registry: p99 about 0.44 ms in the
+ latest local run; recommendation p99 about 0.04 ms.
+- 1.5 KiB federation JCS canonicalization: p50 8.39 µs, p99 8.68 µs,
+ approximately 119,204 operations/second.
+- 1.0 KiB signed Cognitum action verification: p50 71.97 µs, p99 81.93 µs,
+ approximately 13,894 verifications/second.
+- Source-state capture over a clean 200-file Git fixture averaged 15.77 ms;
+ the dirty-patch plus 25-file manifest fixture averaged 27.09 ms.
+
+These are local microbenchmarks, not cross-platform service SLOs.
+
+## Important limitations
+
+These APIs are an opt-in foundation, not a declaration that distributed claim
+federation is production-ready. Persistent control-plane leases, durable
+inbox/outbox storage, signed receipt ledgers, release-decision composition,
+cross-service identity links, and Cognitum production adapters still require
+deployment-specific implementation and acceptance testing.
+
+A lease, signature, claim, score, memory, consensus result, or passing test is
+evidence. None grants product or release authority by itself.
+
+## Architecture
+
+- ADR-325: zero-trust claim federation and work ownership
+- ADR-326: Cognitum product-plane federation profile
+- ADR-327: federated concurrent development harness
+- ADR-328: Cognitum-assisted agent learning
+- ADR-329: Ruflo Capability Brain for MCP guidance