š The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
TypeScript agentic-aiagentic-frameworkagentic-workflowagentsai-agentsai-assistantai-skillsautonomous-agentsclaudecodexdsh-pluginharnessmcp-servermulti-agentmulti-agent-systemsnpmskillsswarmswarm-intelligencetypescript
chore(release): correct stable train to v3.32.29 (#2826)
rUv1d305b133ee9
diff --git a/package-lock.json b/package-lock.jsonindex 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.jsonindex 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.jsonindex 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-versionindex 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.29diff --git a/v3/@claude-flow/cli/.claude/helpers/helpers.manifest.json b/v3/@claude-flow/cli/.claude/helpers/helpers.manifest.jsonindex 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.jsonindex 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.tsindex 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.jsonindex 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.tsindex 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.mdindex 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 useit well. You memorize tool names, remember which plugin owns what, and discovertoo 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 inspectthe running Ruflo system, see every registered capability, understand theauthority and risk boundary, and choose a safe implementation workflow for thetask 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```## Compatibilitydiff --git a/v3/docs/releases/v3.32.29.md b/v3/docs/releases/v3.32.29.mdnew file mode 100644index 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:++- `[email protected]`+- `[email protected]`+- `@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