claude-flow

v3.7.0 Breaking

This release includes 3 breaking changes for platform teams planning a safe upgrade.

Published 10d AI Agents & Assistants

View tool

✓ No known CVEs patched

Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

agentic-ai agentic-framework agentic-rag agentic-workflow agents ai-agents

+14 more

ai-assistant ai-coding ai-skills autonomous-agents claude-code codex mcp-server multi-agent multi-agent-systems npm skills swarm swarm-intelligence typescript

ReleasePort's take

Moderate signal

editorial:auto 10d

The release fixes legacy DB NULL status issues that caused zero memory stats and false "not initialized" reports. It also adds CI smoke tests for legacy DB validation and improves memory retrieval speed by 2.7×.

Why it matters: Fixes cause incorrect memory‑stats reporting; the new 2.70× performance boost directly impacts latency‑sensitive workloads.

Summary

AI summary

Updates Versioning policy change, Highlights, and alpha.78 across a mixed release.

Changes in this release

Type	Severity	Summary	CVE
Feature
Feature	Medium	Adds CI smoke test `smoke-memory-stats-legacy-db.mjs` for legacy DB memory stats validation. Adds CI smoke test `smoke-memory-stats-legacy-db.mjs` for legacy DB memory stats validation. Source: llm_adapter@2026-05-24 Confidence: low	—
Feature	Medium	Enables automatic initialization of ruvllm WASM (issue #2086). Enables automatic initialization of ruvllm WASM (issue #2086). Source: llm_adapter@2026-05-24 Confidence: low	—
Feature	Medium	Adds GitHub stack modernization smokes (ADR‑127) covering safe injection, actions pins, and deprecated actions checks. Adds GitHub stack modernization smokes (ADR‑127) covering safe injection, actions pins, and deprecated actions checks. Source: llm_adapter@2026-05-24 Confidence: low	—
Performance	Medium	Improves memory retrieval speed by 2.70× via RaBitQ quantization (ADR‑126). Improves memory retrieval speed by 2.70× via RaBitQ quantization (ADR‑126). Source: llm_adapter@2026-05-24 Confidence: high	—
Bugfix
Bugfix	Medium	Fixes legacy DB NULL status causing zero memory stats and false "not initialized" reports. Fixes legacy DB NULL status causing zero memory stats and false "not initialized" reports. Source: llm_adapter@2026-05-24 Confidence: high	—
Bugfix	Medium	Expands initialization check to recognize additional config files and DBs. Expands initialization check to recognize additional config files and DBs. Source: llm_adapter@2026-05-24 Confidence: high	—
Bugfix	Medium	Resolves WSL2 daemon triple bug (issue #2110). Resolves WSL2 daemon triple bug (issue #2110). Source: llm_adapter@2026-05-24 Confidence: high	—
Bugfix	Medium	Corrects OpenTelemetry overrides on ruflo wrapper (issue #2112). Corrects OpenTelemetry overrides on ruflo wrapper (issue #2112). Source: llm_adapter@2026-05-24 Confidence: high	—
Bugfix	Medium	Adds acceptance of `status IS NULL` alongside `'active'` in memory bridge logic. Adds acceptance of `status IS NULL` alongside `'active'` in memory bridge logic. Source: llm_adapter@2026-05-24 Confidence: low	—
Bugfix	Medium	Backfills missing status values to `'active'` for legacy DB entries. Backfills missing status values to `'active'` for legacy DB entries. Source: llm_adapter@2026-05-24 Confidence: low	—
Bugfix	Medium	Accepts `status IS NULL` alongside `'active'` in `memory-bridge.ts` `bridgeListEntries` function. Accepts `status IS NULL` alongside `'active'` in `memory-bridge.ts` `bridgeListEntries` function. Source: granite4.1:30b@2026-05-24-audit Confidence: low	—
Bugfix	Medium	Applies same NULL handling in raw SQL fallback within `memory-initializer.ts` `listEntries`. Applies same NULL handling in raw SQL fallback within `memory-initializer.ts` `listEntries`. Source: granite4.1:30b@2026-05-24-audit Confidence: low	—
Bugfix	Medium	Backfills missing status values to `'active'` via `memory-initializer.ts` `ensureSchemaColumns`. Backfills missing status values to `'active'` via `memory-initializer.ts` `ensureSchemaColumns`. Source: granite4.1:30b@2026-05-24-audit Confidence: low	—

Full changelog

First stable release — the alpha series (3.7.0-alpha.1 → 3.7.0-alpha.81) is now closed. From here on we ship semver-stable: 3.7.0 → 3.7.1 (patch), 3.8.0 (minor), 4.0.0 (breaking).

Highlights

#2120 — memory stats / status fixed for legacy DBs

Reporter @alexandrelealbess on WSL2: ruflo memory stats reported Total Entries: 0 against a 251-row .swarm/memory.db, and ruflo status falsely reported "not initialized".

| Fix | Where |
|---|---|
| Accept status IS NULL alongside 'active' | memory-bridge.ts bridgeListEntries |
| Same in raw sql.js fallback | memory-initializer.ts listEntries (4 prepares) |
| Backfill UPDATE ... SET status='active' WHERE status IS NULL | memory-initializer.ts ensureSchemaColumns |
| isInitialized() now accepts any of .claude-flow/config.{yaml,json}, .swarm/memory.db, .claude/settings.json | status.ts |
| New CI smoke smoke-memory-stats-legacy-db.mjs | .github/workflows/v3-ci.yml |

Versioning policy change

No more -alpha.N releases. Default npm publish tag is latest.
Legacy alpha and v3alpha dist-tags continue to point at the latest stable for backward compat — so npx ruflo@alpha and npx claude-flow@v3alpha still work.

CI surface (all guards added on alphas, still active)

5 new regression smokes from the alpha series:

smoke-agent-execute-providers.mjs (#2042)
smoke-github-safe-injection.mjs + smoke-github-actions-pins.mjs + smoke-deprecated-actions.mjs (#2089 ADR-127)
smoke-attribution-opt-in.mjs (#2089 ADR-127)
smoke-init-bundle-invariants.mjs (#2095 ADR-128)
smoke-ruvllm-wasm-auto-init.mjs (#2086)
smoke-memory-stats-legacy-db.mjs (#2120, this release)

Try it

npx ruflo@latest init        # → 3.7.0
# or upgrade in place
npm i -g ruflo@latest

Changelog

See git log v3.7.0-alpha.71...v3.7.0 for the full alpha series. Key fixes that culminated in this release:

#2120 (alpha.81 → 3.7.0) — memory stats legacy DB NULL status
#2110 (alpha.80 → alpha.81) — WSL2 daemon triple bug
#2112 (alpha.79 → alpha.80) — opentelemetry overrides on ruflo wrapper
#2086 (alpha.71 → alpha.72) — ruvllm WASM auto-init
#2042 (alpha.77 → alpha.78) — agent_execute provider routing
#2078 (alpha.78) — opt-in Co-Authored-By trailer
#2089 / ADR-127 — GitHub stack modernization
#2095 / ADR-128 — init bundle reduce
#2068 / ADR-126 — neural-trader substrate integration
#2061 / ADR-125 — memory consolidation, 2.70x retrieval speedup via RaBitQ quantization

Co-Authored-By: rUv

Breaking Changes

Alpha releases (3.7.0-alpha.*) discontinued; all future releases use stable semver tags (latest).
`npm publish` now defaults to the `latest` tag instead of `-alpha.N`.
Legacy `alpha` and `v3alpha` dist-tags are repointed to point at the latest stable version for backward compatibility.

View diff on GitHub

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Share on X Share on Bluesky

Track claude-flow

Get notified when new releases ship.

About claude-flow

Deploy multi-agent swarms with coordinated workflows.

All releases →