Releases: ruvnet/ruflo
v3.5.80 — Tier A Blocker Fixes
Highlights
Fixes three Tier A blockers that made the CLI, MCP agent_spawn tool, and Claude Code memory integration partially unusable.
🐛 Fixed
- #1596 — CLI lazy-loaded command routing (
daemon start, barestart,doctor)- Two-pass parser was greedy-matching the first positional as a phantom subcommand when the outer command was lazy-loaded
- Added
lazyCommandNamesregistry toParserso Pass 1 breaks at the first non-flag positional for known-lazy commands
- #1567 — MCP
agent_spawninput validation rejected every inputvalidateAgentSpawnwas passing{agentType, name}to@claude-flow/security'sSpawnAgentSchemawhich expects{type, id}; every call failed withtype: Required- Also relaxed the strict 15-value enum so custom agent types (
memory-specialist, etc.) are accepted
- #1556 —
AutoMemoryBridge.curateIndex()destroyed hand-curatedMEMORY.md- On every Stop-hook tick when no topic files matched the hardcoded
DEFAULT_TOPIC_MAPPING, the curator overwroteMEMORY.mdwith a stub - Now exits early with an
index:skippedevent when section map is empty
- On every Stop-hook tick when no topic files matched the hardcoded
🔧 Also
@claude-flow/memory'sprebuildnow cleanstsconfig.tsbuildinfosotsc --incrementalproduces fresh output afterrm -rf dist
📦 Published packages
| Package | Version |
|---|---|
@claude-flow/cli |
3.5.80 |
@claude-flow/memory |
3.0.0-alpha.14 |
claude-flow |
3.5.80 |
ruflo |
3.5.80 |
✅ Regression tests
parser.test.ts— 52/52 (includes 4 newlazy command routing (#1596)cases)validate-input-agent-spawn.test.ts— 4/4auto-memory-bridge.test.ts— 74/74 (includes new #1556 preservation test)
🚀 Upgrade
npx @claude-flow/cli@latest --version # 3.5.80
npx ruflo@latest --version # 3.5.80Full Changelog: v3.5.78...v3.5.80
Ruflo v3.5.78 — ESM Stability, Security Hardening & Intelligence Backends
Ruflo v3.5.78
The most stable Ruflo release yet. This release eliminates an entire class of ESM module crashes, hardens security across 6 packages, introduces native intelligence backends, and resolves 10 user-reported critical issues.
34 commits, 145 files changed, ~8,000 lines of improvements since v3.5.59.
Install / Upgrade
npx ruflo@3.5.78 --version # one-shot
npx @claude-flow/cli@3.5.78 doctor # health checkAll three packages updated on npm (alpha, latest, v3alpha):
Critical Bug Fixes
ESM Module Crash Elimination
The entire codebase has been audited and purged of bare require() calls that crash in ESM mode ("type": "module"). 29 total require() calls fixed across two rounds:
| Round | PR / Commit | Files Fixed | Calls Fixed |
|---|---|---|---|
| 1 | #1564 (v3.5.77) | autopilot-state.ts, autopilot.ts, claims.ts |
12 |
| 2 | v3.5.78 | diff-classifier.ts, coverage-router.ts, performance-tools.ts, mcp-server.ts, checker.ts, security.ts |
17 |
Before: ruflo autopilot status, ruflo claims list, diff analysis, coverage routing, performance profiling, security scanning, and update checking all crashed with ReferenceError: require is not defined.
After: Every runtime code path uses proper ESM import statements or the createRequire pattern for native modules.
Closes #1559, #1560, #1561, #1563.
cleanup --force No Longer Destroys User Config (#1557)
Previously, cleanup --force deleted the entire .claude/ directory — wiping agents, skills, commands, settings, memory databases, and worktrees that belong to Claude Code, not Ruflo.
Now: Only Ruflo-owned paths are cleaned (.claude/helpers/), and settings.json is surgically edited to remove only hooks and claudeFlow keys while preserving all user configuration.
CLI One-Shot Commands No Longer Hang (#1552, #1550)
memory store, memory retrieve, config list, and other one-shot commands hung indefinitely due to open handles (MCP listeners, timers, SQLite connections) keeping the event loop alive. Fixed with process.exit(0) after cli.run() resolves.
Daemon Zombie Prevention (#1551)
daemon stop now scans running processes via ps and kills stale daemon instances — not just the PID stored in the PID file. daemon start also cleans up zombies before launching and shows a clear error if a daemon is already running.
Memory Bridge Respects CLAUDE_FLOW_CWD (#1562)
MCP memory tools under Claude Desktop were reading/writing to the wrong directory because auto-memory-bridge.ts hardcoded process.cwd(). Now respects the CLAUDE_FLOW_CWD environment variable.
Security Hardening (PR #1558)
Comprehensive security and performance fixes across 6 packages:
- SQL injection prevention — All sql.js queries converted to parameterized
db.prepare/bindstatements - Command injection prevention — Replaced
execSyncwithexecFileSync(no shell interpretation) throughout - Prototype pollution prevention — JSON reviver strips
__proto__,constructor,prototypekeys - HNSW hash collision safety — Added dual-hash (djb2 + sdbm) and 1,000-probe cap with explicit error on exhaustion
- BoundedSet FIFO eviction — Uses
Mapinsertion order for correct FIFO behavior - Resilient bulk operations —
Promise.allSettledfor operations that shouldn't fail atomically - PID validation —
Number.isIntegerguard before process operations
New Features
Native RuVLLM + Graph-Node Intelligence Backends (ADR-086, ADR-087)
New native intelligence backends for the RuVector system:
- RuVLLM backend — Direct integration with local LLM inference
- Graph-Node backend — Graph-based intelligence routing for complex reasoning chains
DiskANN Vector Search Backend (ADR-077)
Research-grade vector search with:
- 8,000x faster insert than HNSW for large datasets
- Perfect recall on benchmark suites
- SSD-optimized for datasets that exceed RAM
Claude Code ↔ AgentDB Memory Bridge (ADR-076)
Phase 2 MCP tools for bridging Claude Code's auto-memory with AgentDB:
memory_import_claude— Import Claude Code memories with 384-dim ONNX embeddingsmemory_bridge_status— Bridge health monitoringmemory_search_unified— Semantic search across all namespaces
Self-Learning Pipeline (ADR-075)
End-to-end wiring of the self-learning pipeline:
- Pattern recording from successful task completions
- Neural training on discovered patterns
- Cross-session knowledge transfer
saveCheckpoint Resilience (v3.5.75)
Checkpoint save now verifies file existence and falls through to JS fallback on native module failures.
Quality & Honesty
- README honesty audit — Removed fabricated metrics and inflated claims; all stats now reference real benchmarks
- Stub elimination — 9 remaining stub implementations replaced with real scanning, metrics, and health checks
- Comprehensive #1425 remediation — Real quantization, honest performance stubs, input validation at system boundaries
- Statusline accuracy — Replaced all fake heuristics with real data sources from hook activity and AgentDB stats
Issues Closed (10)
| Issue | Title |
|---|---|
| #1559 | Bare require() in ESM modules — autopilot/claims crash |
| #1560 | ESM/CJS regression (dup of #1559) |
| #1561 | Autopilot require is not defined (dup of #1559) |
| #1563 | Autopilot/claims fail on fresh install (dup of #1559) |
| #1557 | cleanup --force deletes entire .claude/ directory |
| #1552 | CLI one-shot commands hang indefinitely |
| #1551 | Daemon processes accumulate as zombies |
| #1550 | Memory subcommands hang (same root cause as #1552) |
| #1562 | Memory commands ignore CLAUDE_FLOW_CWD |
| #1558 | Security & performance fixes across 6 packages |
Stats
34 commits
145 files changed
7,966 insertions(+), 2,333 deletions(-)
29 bare require() calls eliminated
6 packages security-hardened
10 issues resolved
3 npm packages published (alpha, latest, v3alpha)
Full Changelog: v3.5.59...v3.5.78
v3.5.59 — Full Capability Verification: 291 Tests, 314 MCP Tools, 38 CLI Commands
Introduction
Ruflo v3.5.59 delivers a comprehensive capability verification across the entire platform — 314 MCP tools, 38 CLI commands with 140+ subcommands, 22 plugins, 16 QE plugin tools, and 60+ agent types. Every tool has been tested against real data, real APIs, and real file systems, with 291 automated tests providing continuous proof.
This release upgrades 19 MCP tools to production-grade implementations backed by AgentDB persistence, native CLI integration (git, gh), and OS-level metrics. The agentic-qe plugin (16 tools, 51 agents) is updated and verified against the live ruflo repository.
Platform Inventory
314 MCP Tools by Category
| Category | File | Tools | Description |
|---|---|---|---|
| Hooks & Intelligence | hooks-tools.ts | 62 | Lifecycle hooks, intelligence trajectories, workers, sessions, coverage routing |
| Browser Automation | browser-tools.ts | 23 | Web interaction — click, fill, screenshot, snapshot, evaluate, navigate |
| Guidance & Discovery | guidance-tools.ts | 21 | Capability discovery, workflow recommendations, quickref |
| AgentDB | agentdb-tools.ts | 15 | ReasoningBank, hierarchical memory, semantic routing, causal edges, batch ops |
| System Health | system-tools.ts | 15 | Health checks, metrics, status monitoring, system info, reset |
| Claims & Authorization | claims-tools.ts | 12 | ADR-016 issue claims, handoffs, stealing, rebalancing, board view |
| Transfer & Registry | transfer-tools.ts | 11 | IPFS plugin registry, store search, PII detection, pattern transfer |
| Autopilot | autopilot-tools.ts | 10 | Persistent completion management, learning, prediction, progress |
| ruvLLM / WASM | ruvllm-tools.ts | 10 | HNSW routing, SONA adaptation, MicroLoRA, chat formatting |
| Swarm Orchestration | swarm-tools.ts | 10 | Swarm init, status, health, shutdown |
| Workflow | workflow-tools.ts | 10 | Workflow create, execute, run, pause, resume, cancel, templates |
| WASM Agents | wasm-agent-tools.ts | 10 | Sandboxed agents with virtual filesystem, gallery, tool exec |
| Hive-Mind Consensus | hive-mind-tools.ts | 9 | Queen-led Byzantine consensus, broadcast, memory, spawn |
| DAA | daa-tools.ts | 8 | Decentralized autonomous agents, cognitive patterns, knowledge sharing |
| Agent Lifecycle | agent-tools.ts | 7 | Spawn, list, status, terminate, update, pool, health |
| Coordination | coordination-tools.ts | 7 | Consensus, topology, load balancing, sync, node management, metrics |
| Embeddings | embeddings-tools.ts | 7 | Vector embeddings, Poincaré ball, ONNX neural, search, compare |
| Memory | memory-tools.ts | 7 | Store, retrieve, search, list, delete, stats, migrate |
| Task Management | task-tools.ts | 7 | Create, assign, status, complete, cancel, list, summary |
| Code Analysis | analyze-tools.ts | 6 | Diff analysis, risk assessment, reviewer suggestions, classification |
| Configuration | config-tools.ts | 6 | Get, set, list, import, export, reset |
| Neural Learning | neural-tools.ts | 6 | Train, status, patterns, predict, optimize, compress |
| Performance | performance-tools.ts | 6 | Benchmark, profile, metrics, optimize, bottleneck, report |
| Security / AIDefence | security-tools.ts | 6 | Scan, analyze, PII detection, learning, safety checks, stats |
| Terminal | terminal-tools.ts | 6 | Create, execute, close, list, history |
| GitHub Integration | github-tools.ts | 5 | Repo analyze, PR manage, issue track, workflow, metrics |
| Session | session-tools.ts | 5 | Save, restore, list, delete, info |
| Progress Tracking | progress-tools.ts | 4 | Check, summary, sync, watch |
| Coverage Routing | coverage-tools.ts | 3 | Coverage-aware routing, gap detection, suggestions |
| TOTAL | 29 files | 314 |
38 CLI Commands (140+ Subcommands)
| Command | Subs | Description |
|---|---|---|
| agent | 10 | spawn, list, status, stop, metrics, pool, health, logs, auto-scale, follow |
| swarm | 8 | init, start, stop, status, scale, monitor, coordinate, observe |
| memory | 14 | store, retrieve, search, list, delete, init, export, import, stats, cleanup, configure, migrate, compress, rebuild-index |
| task | 8 | create, list, status, assign, cancel, retry, logs, reset-state |
| session | 9 | save, restore, list, delete, export, import, activate, current, active |
| mcp | 11 | start, stop, status, restart, exec, config, logs, list, enable, disable, toggle |
| hooks | 41 | 27 hooks + 12 workers + intelligence sub-system (trajectory, patterns) |
| init | 8 | wizard, check, upgrade, full, minimal, skills, hooks, settings |
| status | 6 | status, health-check, agents, memory, tasks, watch |
| start | 6 | start, stop, restart, daemon, force, skip-mcp |
| neural | 11 | train, status, patterns, predict, optimize, export, import, benchmark, compile, verify, evaluate |
| security | 8 | scan, audit, cve, threats, validate, report, defend, check |
| performance | 7 | benchmark, profile, metrics, optimize, bottleneck, analyze, report |
| embeddings | 17 | embed, batch, search, init, compare, configure, models, check, cache, normalize, test, generate, export, import, status, consolidate, benchmark |
| hive-mind | 13 | init, join, leave, spawn, broadcast, memory, consensus, status, shutdown, optimize-memory, save-state, watch, metrics |
| guidance | 8 | compile, apply, optimize, ab-test, status, retrieve, gates, command |
| autopilot | 12 | enable, disable, status, config, learn, predict, history, reset, check, log, watch, clear |
| config | 9 | init, get, set, add, remove, export, import, reset, providers |
| daemon | 7 | start, stop, status, trigger, enable, disable, logs |
| doctor | 2 | doctor with --fix |
| completions | 6 | bash, zsh, fish, powershell |
| migrate | 7 | status, run, verify, rollback, check, dry-run, fix |
| workflow | 8 | create, run, list, status, validate, watch, stop, show |
| analyze | 13 | diff, code, ast, dependencies, complexity, boundaries, circular, imports, modules, outdated, symbols, partitions, security |
| route | 10 | route, list-agents, explore, suggest, feedback, export, import, stats, reset, q-learning |
| progress | 6 | check, summary, sync, watch, detailed, interval |
| issues | 12 | claim, handoff, list, steal, stealable, release, status, load, mine, board, apply, rebalance |
| update | 7 | check, all, history, rollback, clear-cache, dry-run, force |
| plugins | 11 | list, install, uninstall, enable, disable, upgrade, search, info, dev, create, featured |
| providers | 7 | list, add, remove, configure, test, usage, models |
| deployment | 9 | deploy, rollback, status, environments, history, logs, release, verify, validate |
| claims | 8 | check, grant, revoke, list, policies, roles, scope, action |
| transfer-store | 7 | search, featured, trending, info, download, publish, verify |
| cleanup | 2 | cleanup with dry-run, force, keep-config |
| process | 6 | monitor, logs, signals, workers, status, follow |
| appliance | 8 | build, run, extract, inspect, verify, profile, sign, publish |
| agent-wasm | 5 | wasm-status, wasm-create, wasm-prompt, wasm-gallery, tool-execute |
| ruvector | 8 | init, setup, import, migrate, status, benchmark, optimize, backup |
22 Plugins (IPFS Registry)
Distributed via IPFS (QmXbfEAaR7D2Ujm4GAkbwcGZQMHqAMpwDoje4583uNP834). Install with npx ruflo plugins install <name>.
Core Plugins (6)
| Plugin | Version | Description |
|---|---|---|
@claude-flow/neural |
3.0.0-alpha.7 | Neural pattern training — WASM SIMD, MoE routing, Flash Attention |
@claude-flow/security |
3.0.0-alpha.1 | Security scanning, CVE detection, compliance auditing, threat modeling |
@claude-flow/embeddings |
3.0.0-alpha.1 | Vector embeddings — sql.js, document chunking, hyperbolic (Poincaré ball) |
@claude-flow/claims |
3.0.0-alpha.8 | Claims-based authorization for fine-grained access control |
@claude-flow/performance |
3.0.0-alpha.1 | Performance profiling, benchmarking, optimization recommendations |
@claude-flow/plugins |
3.0.0-alpha.1 | Plugin SDK — create, test, and publish ruflo plugins |
Integration Plugins (10)
| Plugin | Version | Description |
|---|---|---|
@claude-flow/plugin-agentic-qe |
3.5.59 | 16 MCP tools, 51 agents across 12 DDD bounded contexts |
@claude-flow/plugin-prime-radiant |
0.1.5 | Sheaf cohomology, spectral graph theory, consensus verification |
@claude-flow/plugin-gastown-bridge |
3.0.0-alpha.1 | Gas Town orchestrator — WASM formula parsing, Beads sync, 352x faster |
@claude-flow/teammate-plugin |
1.0.0-alpha.1 | TeammateTool integration — 21 MCP tools, BMSSP topology routing |
@claude-flow/plugin-code-intelligence |
0.1.0 | Semantic code analysis, architectural pattern detection, refactoring |
@claude-flow/plugin-test-intelligence |
0.1.0 | Test generation, coverage analysis, mutation testing, flaky detection |
@claude-flow/plugin-perf-optimizer |
0.1.0 | AI bottleneck detection, memory profiling, automated tuning |
@claude-flow/plugin-neural-coordination |
0.1.0 | Multi-agent neural coordination, emergent behavior modeling |
@claude-flow/plugin-cognitive-kernel |
0.1.0 | Working memory, attention mechanisms, meta-cognitive monitoring |
@claude-flow/plugin-quantum-optimizer |
0.1.0 | Quantum-inspired optimization — QAOA simulation, variational circuits |
Research Plugins (3)
| Plugin | Version | Description |
|---|---|---|
@claude-flow/plugin-hyperbolic-reasoning |
0.1.0 | Poincaré embeddings, geodesic attention for hierarchical reasoning |
@claude-flow/plugin-healthcare-clinical |
0.1.0 | HIPAA-compliant cli... |
v3.5.51 — terminal_execute, agent results, security scan, auto-discovery
Fixes
#1457: terminal_execute Now Executes Commands
- Was a stub returning
[STATE TRACKING] Command recorded: ...— now usesexecSyncfor real execution - Respects timeout parameter, captures stdout/stderr, returns real exit codes
#1448: Agent & Task Results Retrievable
agent_statusnow returnslastResultfield with output from the agent's last completed tasktask_statusnow returnsresultfield (was stored but never included in response)
#1493: Security Scan Works on Windows
- Removed
2>/dev/null || truePOSIX shell syntax fromnpm auditcalls - Uses
stdio: 'pipe'+ try/catch for cross-platform compatibility
#1497: MCP Tools Auto-Discovery via Global CLAUDE.md
init --fullnow writes ruflo tool instructions to~/.claude/CLAUDE.md- Claude will auto-discover and use ruflo MCP tools without per-project manual wiring
- Idempotent — won't duplicate the block on re-init
Stats
- 1725 tests pass (28 files, 0 failures)
- Published:
@claude-flow/cli@3.5.51,claude-flow@3.5.51,ruflo@3.5.51
v3.5.50 — 4 Critical Bug Fixes
Fixes
#1499: ReasoningBank Controller Disabled
- Missing
embedderparam when instantiatingReasoningBankinControllerRegistry - Added
createEmbeddingService()call, matching the pattern used byHierarchicalMemoryandMemoryConsolidation
#1490: SQLite Database Path Relative to CWD
- All
path.join(process.cwd(), '.swarm')changed topath.resolve() - Prevents data loss when MCP server's working directory changes between restarts
#1489: memory_search Defaults to 'default' Namespace
- When namespace is not explicitly provided, search now queries ALL namespaces
- Previously defaulted to
'default', silently returning empty results for entries in named namespaces
#1484: init --full Hooks Never Fire
writeSettingsskipped writing hooks if.claude/settings.jsonalready existed- Now merges hooks, env vars, and permissions into existing settings instead of skipping
ruflo init --fullis now a single command that produces a working setup
Stats
- 1725 tests pass (28 files, 0 failures)
- Published:
@claude-flow/cli@3.5.50,claude-flow@3.5.50,ruflo@3.5.50
v3.5.49 — P0 Daemon & AgentDB Controller Fixes
P0 Fixes
#1478: Daemon Dies Immediately After Spawn
- Removed premature PID file write that caused self-detection race condition
- Added ref'd
setIntervalkeepalive (unref'd timers don't keep Node.js alive) - Changed detached spawn stdio from numeric FDs to
'ignore'(fixes Windows child death)
#1492: ESM require('path') Disables All 15 AgentDB Controllers
require('path')throws ReferenceError in ESM context, silently killinginitAgentDB()- Replaced with
await import('node:path')— works in both ESM and CJS
#1492 (Bug 2): bridgeSearchPatterns Wrong Method
- ReasoningBank exposes
.search()not.searchPatterns()in some versions - Added fallback: tries
.searchPatterns()first, falls back to.search()
Stats
- 1725 tests pass (28 files, 0 failures)
- Published:
@claude-flow/cli@3.5.49,claude-flow@3.5.49,ruflo@3.5.49
v3.5.48 — Security, P1 Fixes, WASM CLI
What's New
Security Hardening (v3.5.45)
- Prototype pollution prevention via
safeJsonParse()— strips__proto__,constructor,prototype - NaN/Infinity bypass protection in
validateNumber() - Task source allowlist (
VALID_TASK_SOURCES) prevents injection - Atomic file writes (tmp + rename) for state persistence
- Shared
autopilot-state.tsmodule eliminates 140 lines of duplication
Token Drain Prevention (v3.5.46) — #1427, #1330
- Daemon
autoStartdefaults tofalse(opt-in only) - Session hook
startDaemondefaults tofalse - Background workers reduced 10 → 3, schedules relaxed (audit 4h, optimize 2h)
P1 Bug Fixes (v3.5.47)
- #1122: HNSW ghost entries — bridge delete path now invalidates HNSW index
- #1117: Orphan processes — worker timeout raised 5min → 16min
- #1111: Headless stdin pipe hang — already fixed (closed)
- #1109: classifyHandoffIfNeeded — Claude Code platform issue (closed)
RuVector WASM CLI Exposure (v3.5.48)
- ADR-067: RuVector WASM utilization audit and improvement plan
- 4 new CLI commands:
agent wasm-status,agent wasm-create,agent wasm-prompt,agent wasm-gallery - Fixed 16 pre-existing ruvllm-wasm test failures (mock constructors)
Test Results
- 28/28 test files pass
- 1725/1725 tests pass, 0 failures
Install
npx @claude-flow/cli@latest
npx claude-flow@latest
npx ruflo@latestv3.5.43 — Critical Issue Remediation & Stub Removal
v3.5.43 — Critical Issue Remediation & Stub Removal
Summary
Resolves 9 GitHub issues, replaces 22 fake-success stubs with honest errors, and fixes all healthcare plugin test failures. See ADR-067 for full details.
Issues Resolved
| Issue | Title | Fix |
|---|---|---|
| #1390 | memory_store crash on ONNX worker threads |
process.exit(0) after init to avoid ONNX hang |
| #1391 | MCP tool prefix inconsistency | Standardized claude-flow prefix in hive-mind prompts |
| #1392 | Worker tracking incomplete | PID singleton + SIGKILL fallback in daemon |
| #1393 | Headless worker stdin pipe error | Pipe stdin, bypass nested session detection |
| #1394 | Swarm commands stub-only | Real MCP calls + .swarm/state.json persistence |
| #1395 | Model alias resolution fails | Map short names → dated model IDs |
| #1396 | Global -f flag collision |
Removed from parser; subcommands use --format |
| #1397 | ruvllm-tools JSON Schema invalid |
Added items to 4 array schemas |
| #1398 | Vector dimension mismatch (1536 vs 384) | Updated config-adapter.ts default |
Fake-Success Stubs Replaced (22 total)
All stubs now return { success: false, exitCode: 1 } with guidance:
- config.ts (5):
init,set,reset,export,import - deployment.ts (6):
deploy,rollback,status,environments,release,logs - migrate.ts (4):
status,run,verify,rollback - claims.ts (5):
list,grant,revoke,roles,policies - providers.ts (2):
configure,test
Healthcare Plugin Fixes
- Fixed
MCPToolResulttype to match MCP SDK format ({isError, content}) - Fixed RBAC role case-sensitivity (lowercase → uppercase normalization)
- Fixed
OntologyNavigationInputSchemamissing default fordirection - Injected bridge mocks in tests (bypasses ESM vi.mock issues)
- Result: 23 test failures → 0
Test Results
- 1709 tests passing (net +6 from v3.5.42)
- 23 healthcare failures fixed
- Pre-existing failures unchanged (controller-registry: 1, ruvllm-wasm suite isolation: 16)
npm Packages
All three packages published with latest, alpha, and v3alpha dist-tags:
npm i @claude-flow/cli@3.5.43
npm i claude-flow@3.5.43
npm i ruflo@3.5.43
PR
- #1435 (
fix/critical-issues-adr-060)
🤖 Generated with claude-flow
Co-Authored-By: claude-flow ruv@ruv.net
RuFlo v3.5.31 — Intelligence Accuracy, RuVector WASM & Community Fixes
RuFlo v3.5.31
16 releases since v3.5.15 — This release brings real semantic embeddings via RuVector WASM, a complete statusline accuracy overhaul, intelligence vector store fixes, and merges from 5 community PRs.
Packages: @claude-flow/cli@3.5.31 · claude-flow@3.5.31 · ruflo@3.5.31
Highlights
RuVector WASM Integration — Real semantic embeddings are now available to all users out of the box via WebAssembly, replacing placeholder/random vectors. HNSW-indexed search delivers 150x–12,500x speedup with no native compilation required.
Intelligence Vector Store Fix — The intelligence.cjs hook was failing silently because auto-memory-store.json is a flat JSON array, but loadEntries() expected {entries: [...]}. Both the bundled helper and the init generator now handle both formats correctly.
Statusline Accuracy Overhaul — Six hardcoded/estimated values in the statusline replaced with real data: actual hook counts from settings.json, real AgentDB entry counts, deep test file scanning, stale swarm detection, audit freshness checks, and actual ADR file counts.
Features
- feat: RuVector WASM integration + real semantic embeddings (#1374) — Cross-platform WASM-based embeddings for all users, no native deps
- feat: v3.5.23 — merge 5 community PRs + ADR-065 — Batch merge of community contributions
- feat: implement all stub features + fix 8 bugs (v3.5.22) — Full implementation of previously stubbed features
Bug Fixes
- fix: intelligence vector store + statusline accuracy (#1377) — Flat array format support + 6 statusline accuracy fixes in both bundled helpers and init generator
- fix: add missing attention class wrappers + CJS/ESM interop (#1370, from #1338) — Attention class wrappers for neural module, ESM/CJS
defaultexport handling - fix: close semantic routing learning loop in hooks-tools (#1311) — Learning loop now properly feeds back into routing decisions
- fix(daemon): CPU-proportional maxCpuLoad replaces hardcoded 2.0 (#1369, rebased from #1353) — Daemon CPU limit now scales with available cores
- fix: ESM/CJS interop with 'default' in module check (#1368) — Robust module format detection
- fix(agents): make base template frontmatter YAML-safe (#1317) — Prevents YAML parse errors in agent templates
- fix: PluginManager priority and version checks (#1336) — Correct plugin load ordering
- fix: benchmark environment lookup in ESM (#1337) — Benchmark suite works in ESM contexts
- fix: hooks package type export paths (#1341) — Correct export map for hooks package
- fix(memory): add prepublishOnly guard for dist exports (#1314) — Prevents publishing without build
- fix(cli): prevent TS2307 for optional @claude-flow/codex import (#1346) — Clean compilation when codex package not installed
- fix: 7 critical audit fixes, Windows settings, ADR-063 (v3.5.21) — Windows path handling, settings validation
- fix: doctor checks + AgentDB bridge errors (v3.5.19) — Doctor command reliability improvements
- fix: statusline generator always overwrites legacy copy (#1360) — Init now generates accurate statusline
- fix: update swarm-activity.json on agent spawn/stop (#1354) — Community PR from @dancinglightning
- fix: statusline branding RuFlo V3.5, Opus 4.6 (#1351) — Correct model and product branding
- fix: use $CLAUDE_PROJECT_DIR for hooks path resolution (v3.5.15) — Portable hook paths
Documentation
- docs: Update branding from Claude Flow to Ruflo in init executor (#1305)
- docs: update MCP tool counts to 259, add beginner guidance (#1366)
Community Contributions
Thanks to @dancinglightning for the swarm activity tracking fix (#1354) and to all contributors across PRs #1336, #1337, #1341, #1314, #1317.
Upgrade
npx claude-flow@latest init
# or
npx ruflo@latest initFull Changelog
v3.5.15 — Fix hooks path resolution with $CLAUDE_PROJECT_DIR
Fix: Hooks Path Resolution (v3.5.15)
Problem
Claude Code hooks using relative paths (.claude/helpers/...) or $(git rev-parse --show-toplevel) break when Claude Code changes the working directory to a subdirectory during agent operations.
Solution
All hook commands now use $CLAUDE_PROJECT_DIR — the official Claude Code environment variable that always resolves to the project root, regardless of current working directory.
Changes
.claude/settings.json— 15 hook paths updated from$(git rev-parse --show-toplevel)to$CLAUDE_PROJECT_DIRv3/@claude-flow/cli/.claude/settings.json— 9 hook paths updated from bare relative pathssettings-generator.ts—hookHandlerCmd(),autoMemoryCmd(), andgenerateStatusLineConfig()now emit$CLAUDE_PROJECT_DIR-based paths- New projects created via
npx claude-flow@latest initwill automatically get correct paths
Published Packages
| Package | Version | Install |
|---|---|---|
@claude-flow/cli |
3.5.15 | npx @claude-flow/cli@latest |
claude-flow |
3.5.15 | npx claude-flow@latest |
ruflo |
3.5.15 | npx ruflo@latest |
References
- Upstream issue: anthropics/claude-code#9039
- Claude Code hooks docs: https://code.claude.com/docs/en/hooks