v3.13.3

ruvnet/ruflov3.13.3Jun 22, 2026by ruvnet

AI Summary

Critical fix for a kernel panic issue on macOS caused by stale `npx @latest` hook migrations that resulted in continuous cold-spawning.

Key Highlights

Fixes kernel-panic class issue on macOS caused by stale hooks
Adds migration logic for broken `npx @latest` patterns
Adds `checkStaleSettingsNpx` doctor check component

New Features

Hook migration logic
Doctor check for stale settings
Kernel panic fix

Full Release Notes

## 🔧 Critical fix — #2448

**Affected user reported load average 49 / jetsam / kernel watchdog panic** on macOS. Pre-#2337 init wrote \`npx @claude-flow/cli@latest hooks <sub>\` into the statusLine + per-action hooks. Each invocation cold-spawns ~130 MB Node + npm registry round-trip; statusLine refires every few hundred ms.

The current init source already emits the local-helper form — but \`executor.ts:362\` preserved the user's existing command on re-init, so anyone who installed pre-#2337 and upgraded never received the fix.

### Two changes

- **init migration:** detect the broken \`npx @latest hooks <sub>\` pattern in \`existing.statusLine.command\` AND every \`hooks.<event>[].hooks[].command\`. Regenerate to local-helper form. Idempotent on already-correct settings. Captures the subcommand from the broken string so intent is preserved.
- **doctor check:** new \`checkStaleSettingsNpx\` reports \`fail\` if the broken pattern is detected anywhere in project-local or \`\$HOME/.claude/settings.json\`. Run \`ruflo doctor --component stale-settings\` to check directly.

### How to recover if you're affected

\`\`\`bash
# Detect (no changes)
npx ruflo@latest doctor --component stale-settings

# Migrate (re-runs init merge logic, regenerates the broken commands)
npx ruflo@latest init

# Verify
npx ruflo@latest doctor --component stale-settings   # should now ✓
\`\`\`

### Distribution

| Package | latest | alpha | v3alpha |
|---|---|---|---|
| \`@claude-flow/cli\` | 3.13.3 | 3.13.3 | 3.13.3 |
| \`claude-flow\` | 3.13.3 | 3.13.3 | 3.13.3 |
| \`ruflo\` | 3.13.3 | 3.13.3 | 3.13.3 |

### Cross-references
- 🔗 Issue: #2448 (CRITICAL, closed)
- 🔗 Prior partial fix: #2337 (statusline storm) — fixed the generator but not the upgrade path
- 🔗 Companion: #2443 (doctor MetaHarness locator), #2444 (sql.js MEMFS leak)

---
🤖 Generated with [RuFlo](https://github.com/ruvnet/ruflo)