π 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
release: 3.58.0 (#4306)
rUvd529a38a7cc1
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex ef69d5c232..70e2b053ad 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -5,6 +5,30 @@ All notable changes to the Ruflo project (formerly Claude Flow) are documented hThe format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).+## [3.58.0] - 2026-10-20++Minor release: `@claude-flow/cli`, `claude-flow`, `ruflo` 3.58.0. Backward-compatible additions (new `memory peek` command, a Codex session activity viewer, configurable MCP rate limits) plus a critical install-breaking fix and a round of correctness fixes.++### Fixed++- **Critical**: `@claude-flow/[email protected]` pinned `@claude-flow/[email protected]`, which had never been published, so every fresh install of the 3.57.x line failed with `ETARGET` (#4303). Published `@claude-flow/[email protected]` standalone (verified against a clean install) and added `scripts/audit-leaf-versions-published.mjs` β a new, now-required CI check that queries the live npm registry for every non-bundled leaf pin so a PR that bumps a pin ahead of its own leaf's publish fails before merge, not after release (#4304).+- `agent spawn --name` was accepted and echoed by the CLI but never persisted to the `AgentRecord`, so `ruflo-console` could only label agents by type (#4300/#4301).+- `agent list --all` sent a literal `status: 'all'` that `agent_list` doesn't recognize, filtering out every agent; `agent list --type` was accepted but never read (#4302).+- `claims_claim`'s `expiresAt` was declared but unsettable by any handler, and the claims-load utilization math duplicated the max-claims threshold as a second magic literal (#3180/#3927).+- A stale docstring on `InMemoryClaimRepository` claimed SQLite-backed persistence that doesn't exist in this package (#3179/#3926).+- The persistent embedding cache raced concurrent cold callers into redundant SQLite initializations, and its FNV-1a cache key could collide for distinct equal-length inputs, including the lone-surrogate case (#3685, #3681).+- The embedding model cache directory could be unwritable for non-root runtime users, permanently caching the mock fallback with no retry path (#3692/#3831).+- `ruflo-mods`' risky-call/event classifier was missing several calls and hook events (`agent.register`, `tool.call`, `session.append`, read-side forgery vectors like `fs.read`/`env.get`, and more) that can rewrite or forge what other mods decide by β strictly widened, nothing un-flagged (#3802).+- `ruflo-x-gateway` could crash on a malformed relay frame instead of failing fast on the one relay connection affected (#3921).+- The standalone terminal console (`npx ruflo tui`) gave no on-screen indication that mouse support is off by default, silently dropped the `0 menu` hint from the footer below 80 columns, and dropped a mouse press+release pair when a terminal (tmux especially) coalesced them into one data chunk (#4305).+- CI reliability, found while validating this release (#4307): `v3/@claude-flow/memory`'s FTS5 tests located `sql-wasm.wasm` via a `sql.js/package.json` subpath resolve, which sql.js 1.14's tightened `exports` map rejects even though the file exists β now resolves `sql.js/dist/sql-wasm.wasm` directly; `plugins/ruflo-business-pods/scripts/pod-tick.test.mjs` (a `node:test` file) was miscategorized into the vitest-can-run-it baseline instead of the node:test-only exclusion list (#4308); `plugins/ruflo-graph-intelligence`'s knowledge-graph adapter built its optional `@claude-flow/cli` import specifier as a string literal that a bundler's static scan could eagerly (and wrongly) try to resolve during test collection, outside the method's own try/catch β now built from joined parts; the root test-suite ratchet's default vitest worker count intermittently crashed with `ERR_IPC_CHANNEL_CLOSED` partway through the ~9500-test suite β capped at 2 workers as a stopgap pending real root-cause work; `tests/all-plugins-smoke-workflow.test.mjs`'s hardcoded `timeout-minutes: 10` expectation went stale when #3950 raised the real value to 15 for the new external-plugin smoke step.++### Added++- `memory peek` β a read-only command that reports which store files the current directory resolves to, row counts, last-write time, and WAL state, without ever creating, initializing, or migrating anything (#3508/#3620).+- `@claude-flow/codex activity` β inspect a Codex helper's assignment, recorded state, progress, and tool calls/results from an existing session, with symlink-safe, TOCTOU-resistant file access and best-effort credential masking in previews (#3930/#3962).+- `mcp start` now supports configurable HTTP and per-session rate limits (#3694).+## [3.57.2] - 2026-10-19Patch release: `@claude-flow/cli`, `claude-flow`, `ruflo` 3.57.2. `@claude-flow/cli-core` 3.7.5 (#4295, #4296) published standalone and pinned exactly. A large community PR batch β mostly correctness fixes to error reporting, memory/graph boundary handling, and CLI diagnostics.diff --git a/package-lock.json b/package-lock.jsonindex 62abacf82e..5283ad1466 100644--- a/package-lock.json+++ b/package-lock.json@@ -1,12 +1,12 @@{"name": "claude-flow",- "version": "3.57.2",+ "version": "3.58.0","lockfileVersion": 3,"requires": true,"packages": {"": {"name": "claude-flow",- "version": "3.57.2",+ "version": "3.58.0","bundleDependencies": ["@claude-flow/codex","@claude-flow/mcp",diff --git a/package.json b/package.jsonindex 8c7fc0fc5a..43a58392d1 100644--- a/package.json+++ b/package.json@@ -1,6 +1,6 @@{"name": "claude-flow",- "version": "3.57.2",+ "version": "3.58.0","workspaces": ["v3/@claude-flow/codex","v3/@claude-flow/mcp",diff --git a/plugins/ruflo-console/.claude-plugin/plugin.json b/plugins/ruflo-console/.claude-plugin/plugin.jsonindex a97cffe92d..9037789387 100644--- a/plugins/ruflo-console/.claude-plugin/plugin.json+++ b/plugins/ruflo-console/.claude-plugin/plugin.json@@ -1,7 +1,7 @@{"name": "ruflo-console","description": "ruflo's cockpit inside Claude Code and the one /ruflo command for every ruflo mod (function hooks, early access). Views: overview with health alerts, swarm topology graph, claims flow with TTL rings, federation map, plugin health matrix, learning curve and pipeline, MetaHarness radar and audit trend, memory, cost gauge, agent timeline, approvals queue, event stream, a main menu, an x.ruv.io federation board, an AI terminal (codex, claude or both in remembered sessions, streamed), Skills (npx skills), a Hive-Mind view, a MetaHarness lab, agent drill-down; a command palette for confirm-gated actions through the ruflo CLI; a band above the prompt. Reads ruflo's files and the CLI's local JSON; anything not measured reads n/a. The one network call it makes by itself is a daily read of the published plugin.json at github.com/ruvnet/ruflo to offer an update (Settings β Updates: ask, auto, or off); it installs only through Claude Code's own claude plugin update, and never a new major version without asking.",- "version": "0.44.4",+ "version": "0.44.5","author": {"name": "ruvnet","url": "https://github.com/ruvnet"diff --git a/plugins/ruflo-console/CHANGELOG.md b/plugins/ruflo-console/CHANGELOG.mdindex d3aa0e7bd4..f460dfc4e7 100644--- a/plugins/ruflo-console/CHANGELOG.md+++ b/plugins/ruflo-console/CHANGELOG.md@@ -2,6 +2,11 @@Newest first. One `## <version> β <date>` heading per version, then `feat:`, `fix:`, `breaking:` and `chore:` bullets (ADR-478). Built from git history; older versions: `git log -- plugins/ruflo-console`.+## 0.44.5 β 2026-10-20+- fix: the standalone terminal console (`npx ruflo tui`) now shows a one-line notice on the first frame when mouse support is off (it's opt-in by design) and how to turn it on with `--mouse`, instead of clicking silently doing nothing (#4305).+- fix: the footer's `0 menu` key hint no longer disappears below 80 columns (a common tmux/editor-pane width) β a new footer tier keeps it visible down to 62 columns (#4305).+- fix: with `--mouse` on, a press-and-release pair delivered in a single terminal data chunk (as tmux can) is no longer dropped β `onMouse` now scans for every mouse report in the chunk instead of requiring the whole chunk to match one (#4305).+## 0.44.4 β 2026-10-18- fix: the mission ledger is kept per project (#4237, #4242, thanks @kevin9327). One machine-wide key let the active mission of one project show in, and go into the prompt of, every other project, and two sessions in different projects overwrote each other. Each project now has its own key, and a new mission records the project it was made in. This shipped in 3.57.0 under the same 0.44.3 version, so `claude plugin update` never offered it.- fix: missions from before per-project storage no longer leak into every project (#4254). The old shared key's missions with no project recorded were still taken into each project that opened, and saved into its own key. Now Mission Control offers them ("N missions from before per-project storage"), each on its own row with adopt and not here, because the old key mixes missions from several projects; with two or more, one button turns them all away. Adopt records the project on that mission and takes it out of the old key, and only once the project's own save has succeeded; a mission older than the 20 a project keeps is not adopted rather than dropped. Not here keeps that mission's offer away there. An offer that came from the project's own key (a 0.44.3 copy) stays in that key until adopted, so a save no longer drops it. A mission the old key records for this project is taken in and removed from it without asking, again only after the save. A session that starts again in another directory begins with none of the last project's missions, goal or plan. Until every Claude Code session on the machine runs 0.44.4, a session still on 0.44.2 or 0.44.3 can write its in-memory missions back to the old shared key or a project's key, bringing back offers this version pruned. Restart those sessions after updating.diff --git a/plugins/ruflo-console/hooks/version.ts b/plugins/ruflo-console/hooks/version.tsindex cb818aeadf..b5ec56aadb 100644--- a/plugins/ruflo-console/hooks/version.ts+++ b/plugins/ruflo-console/hooks/version.ts@@ -2,4 +2,4 @@* The console's version, shown on the header so a person can tell which build is running. Kept equal to the plugin's manifest* (`.claude-plugin/plugin.json`); tests/version.spec.ts fails if the two drift.*/-export const CONSOLE_VERSION = '0.44.4'+export const CONSOLE_VERSION = '0.44.5'diff --git a/plugins/ruflo-console/scripts/smoke.sh b/plugins/ruflo-console/scripts/smoke.shindex 93c86ef1ef..2be2aecb3a 100755--- a/plugins/ruflo-console/scripts/smoke.sh+++ b/plugins/ruflo-console/scripts/smoke.sh@@ -11,9 +11,9 @@ step() { printf "β %s ... " "$1"; }ok() { printf "PASS\n"; PASS=$((PASS+1)); }bad() { printf "FAIL: %s\n" "$1"; FAIL=$((FAIL+1)); }-step "1. plugin.json declares ruflo-console 0.44.4"+step "1. plugin.json declares ruflo-console 0.44.5"grep -q '"name": "ruflo-console"' "$ROOT/.claude-plugin/plugin.json" \- && grep -q '"version": "0.44.4"' "$ROOT/.claude-plugin/plugin.json" && ok || bad "name/version"+ && grep -q '"version": "0.44.5"' "$ROOT/.claude-plugin/plugin.json" && ok || bad "name/version"step "2. hooks.json names exactly one module and no classic hook commands"grep -q '"modules": \["./register.ts"\]' "$HOOKS/hooks.json" && ! grep -q '"command"' "$HOOKS/hooks.json" \diff --git a/plugins/ruflo-graph-intelligence/src/adapters/knowledge-graph-adapter.ts b/plugins/ruflo-graph-intelligence/src/adapters/knowledge-graph-adapter.tsindex 81bfc33878..e5a188d858 100644--- a/plugins/ruflo-graph-intelligence/src/adapters/knowledge-graph-adapter.ts+++ b/plugins/ruflo-graph-intelligence/src/adapters/knowledge-graph-adapter.ts@@ -128,12 +128,19 @@ export class GraphEdgesSource implements KnowledgeGraphSource {type GraphEdgeWriterModule = {getBridgeDb: (dbPath?: string) => Promise<{ exec: (sql: string) => Array<{ values?: unknown[][] }> } | null>;};+ // Built from parts, not a string literal: a bundler's static import-specifier scan (vitest's+ // module-graph crawl included β it was found tripping on this one, in CI only, even though+ // only the mocked test doubles ever execute, never this function body) tries to eagerly+ // resolve a literal specifier at collection time, outside this try/catch, for an optional+ // cross-package path that is only ever meant to be resolved when actually awaited.+ const primarySpecifier = ['@claude-flow/cli', 'src/memory/graph-edge-writer.js'].join('/');+ const fallbackSpecifier = ['..', '..', '..', '..', '..', 'v3/@claude-flow/cli/dist/src/memory/graph-edge-writer.js'].join('/');// eslint-disable-next-line @typescript-eslint/ban-ts-comment// @ts-ignore β dynamic cross-package import resolved at runtime- const mod: GraphEdgeWriterModule = await import('@claude-flow/cli/src/memory/graph-edge-writer.js')+ const mod: GraphEdgeWriterModule = await import(primarySpecifier)// eslint-disable-next-line @typescript-eslint/ban-ts-comment// @ts-ignore β fallback to local dist path in mono-repo context- .catch(() => import('../../../../../v3/@claude-flow/cli/dist/src/memory/graph-edge-writer.js'));+ .catch(() => import(fallbackSpecifier));const db = await mod.getBridgeDb();if (!db) return [];diff --git a/ruflo/package.json b/ruflo/package.jsonindex ef7ad0c4c7..cc516c5244 100644--- a/ruflo/package.json+++ b/ruflo/package.json@@ -1,6 +1,6 @@{"name": "ruflo",- "version": "3.57.2",+ "version": "3.58.0","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.57.2"+ "@claude-flow/cli": "3.58.0"},"optionalDependencies": {},"overrides": {diff --git a/scripts/ci-test-baseline.txt b/scripts/ci-test-baseline.txtindex 0dce46163d..8fe284ff18 100644--- a/scripts/ci-test-baseline.txt+++ b/scripts/ci-test-baseline.txt@@ -8,7 +8,6 @@ plugins/ruflo-adr/scripts/__tests__/index-idempotency-2660.test.mjsplugins/ruflo-adr/scripts/__tests__/parser-bullets-2659.test.mjsplugins/ruflo-adr/scripts/__tests__/skip-brain-dir-2911.test.mjsplugins/ruflo-adr/scripts/__tests__/verify-read-safety-3147.test.mjs-plugins/ruflo-business-pods/scripts/pod-tick.test.mjsplugins/ruflo-core/scripts/escape-cmd-arg.test.cjsplugins/ruflo-core/scripts/mcp-launch.test.cjsplugins/ruflo-mods/tests/cost.test.ts@@ -100,6 +99,7 @@ v3/@claude-flow/hooks/__tests__/channel-guard-worker.test.tsv3/@claude-flow/hooks/__tests__/workers.test.tsv3/@claude-flow/hooks/src/__tests__/guidance-provider.test.tsv3/@claude-flow/hooks/src/__tests__/reasoningbank.test.ts+v3/@claude-flow/integration/src/__tests__/token-optimizer.test.tsv3/@claude-flow/memory/src/agentdb-backend.test.tsv3/@claude-flow/memory/src/agentdb-retrieval-guard.test.tsv3/@claude-flow/memory/src/consolidator-embedding-benchmark.test.tsdiff --git a/scripts/ci-test-excluded.txt b/scripts/ci-test-excluded.txtindex 667a9b032c..7572e94517 100644--- a/scripts/ci-test-excluded.txt+++ b/scripts/ci-test-excluded.txt@@ -98,6 +98,7 @@ plugins/ruflo-swarm/tests/toast.test.tsplugins/ruflo-mods/tests/protector.test.tsplugins/ruflo-mods/tests/selfcheck.test.tsplugins/ruflo-testgen/scripts/tdd-repair/tdd-repair.test.mjs+plugins/ruflo-business-pods/scripts/pod-tick.test.mjsplugins/ruflo-core/scripts/background-hooks.test.cjsplugins/ruflo-core/scripts/command-recording-switch.test.cjstests/regression/oct12-coverage.test.cjsdiff --git a/scripts/ci-test-ratchet.mjs b/scripts/ci-test-ratchet.mjsindex b45b182234..46a611807a 100644--- a/scripts/ci-test-ratchet.mjs+++ b/scripts/ci-test-ratchet.mjs@@ -128,6 +128,14 @@ function main() {const run = spawnSync(process.execPath, [vitestBin,'run',+ // #4307: the default fork pool (one fork per CPU, ~4 on a standard+ // GitHub-hosted runner) intermittently crashes with tinypool's+ // ERR_IPC_CHANNEL_CLOSED partway through this ~9500-test suite β observed+ // at three different, unrelated points across repeated runs, consistent+ // with cumulative memory pressure rather than one bad file. Capping forks+ // trades wall-clock time for headroom; raise this back (or drop it) if a+ // future profiling pass finds the real cause and fixes it properly.+ '--maxWorkers=2',// The new guidance file uses Claude Code's native test kit, not// Vitest. Do not enlarge the historical known-failure baseline.'--exclude=plugins/ruflo-mods/tests/guidance.test.ts',diff --git a/tests/all-plugins-smoke-workflow.test.mjs b/tests/all-plugins-smoke-workflow.test.mjsindex b454067499..63718cb329 100644--- a/tests/all-plugins-smoke-workflow.test.mjs+++ b/tests/all-plugins-smoke-workflow.test.mjs@@ -21,12 +21,14 @@ test('node:test regression is registered with its explicit CI runner', () => {assert.equal(job.steps.filter(step => step.run?.includes('node --test tests/check-guard-tool-names.test.mjs tests/all-plugins-smoke-workflow.test.mjs')).length, 1);});-test('smoke workflow runs one suite within the unchanged deadline and always uploads its result', () => {+test('smoke workflow runs one suite within the current deadline and always uploads its result', () => {const provision = job.steps.find(step => step.run?.includes('npm install --prefix'));assert.match(provision.run, /yaml@2\.8\.0\b/);const regression = job.steps.find(step => step.run?.includes('node --test tests/check-guard-tool-names.test.mjs'));assert.equal(regression.env.NODE_PATH, '${{ runner.temp }}/esbuild/node_modules');- assert.equal(job['timeout-minutes'], 10);+ // 10 -> 15 in #3950: the job also checks out and smokes the first external (git-subdir) marketplace entry,+ // agentic-qe-fleet, which doesn't fit the original budget alongside every local plugin's smoke.sh.+ assert.equal(job['timeout-minutes'], 15);assert.equal(producers.length, 1);assert.equal(producers[0].shell, 'bash');assert.match(producers[0].run, /--timeout 300\b/);diff --git a/v3/@claude-flow/cli/package.json b/v3/@claude-flow/cli/package.jsonindex 13a3cfbd71..e505d2425e 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.57.2",+ "version": "3.58.0","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/memory/src/fts5.test.ts b/v3/@claude-flow/memory/src/fts5.test.tsindex 3f965549c8..1a7f26f65a 100644--- a/v3/@claude-flow/memory/src/fts5.test.ts+++ b/v3/@claude-flow/memory/src/fts5.test.ts@@ -22,11 +22,15 @@ const require = createRequire(import.meta.url);* Locate the local sql-wasm.wasm so vitest doesn't try to fetch it over HTTP.* Returns null if sql.js isn't installed in this env (treated as a skip* signal by the suite).+ *+ * Resolve the dist subpath directly (exposed via sql.js's "./dist/*" export),+ * not "sql.js/package.json": sql.js 1.14 tightened its exports map to "." and+ * "./dist/*" only, so a package.json subpath resolve throws+ * ERR_PACKAGE_PATH_NOT_EXPORTED there even though the wasm file is present.*/function locateSqlWasm(): string | null {try {- const sqljsPkg = require.resolve('sql.js/package.json');- const wasmPath = sqljsPkg.replace(/package\.json$/, 'dist/sql-wasm.wasm');+ const wasmPath = require.resolve('sql.js/dist/sql-wasm.wasm');return existsSync(wasmPath) ? wasmPath : null;} catch {return null;