Skip to content

armgit / ruflo

Public Imported from GitHub
0

🌊 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

Checkpoint: File edits

rUvf0ba075c9c19
diff --git a/v3/implementation/adrs/ADR-STATUS-SUMMARY.md b/v3/implementation/adrs/ADR-STATUS-SUMMARY.md
index e7633c8947..2827a7c14d 100644
--- a/v3/implementation/adrs/ADR-STATUS-SUMMARY.md
+++ b/v3/implementation/adrs/ADR-STATUS-SUMMARY.md
@@ -345,6 +345,39 @@ console.warn(`âš  [Discovery] OFFLINE MODE - Could not resolve IPNS: ${ipnsName}
---
+## Alpha.85-86 Release - MCP Fix & Version Check (2026-01-13)
+
+### MCP Server Fix
+
+**Problem:** `npx claude-flow@alpha mcp start` failed with "Cannot read properties of undefined (reading 'split')"
+
+**Root Cause:** npm resolved `^3.0.0-alpha.84` to buggy version `3.0.2` (semver: `3.0.2 > 3.0.0-alpha.84`)
+
+**Solution:**
+1. Pinned exact version in wrapper: `"@claude-flow/cli": "3.0.0-alpha.86"` (no caret)
+2. Deprecated buggy versions: 3.0.0, 3.0.1, 3.0.2
+3. Published [email protected] with fix
+
+### Doctor Version Freshness Check (alpha.86)
+
+Added `checkVersionFreshness()` to doctor command:
+- Detects if running via npx (checks process paths)
+- Queries npm registry for latest alpha version
+- Compares versions including prerelease numbers
+- Warns if stale npx cache detected
+- Provides fix command: `rm -rf ~/.npm/_npx/* && npx -y @claude-flow/cli@latest`
+
+```bash
+# Check version freshness
+npx @claude-flow/cli@alpha doctor -c version
+
+# Example output when outdated:
+âš  Version Freshness: v3.0.0-alpha.84 (latest: v3.0.0-alpha.86) [npx cache stale]
+ Fix: rm -rf ~/.npm/_npx/* && npx -y @claude-flow/cli@latest
+```
+
+---
+
## Auto-Update System (ADR-025)
| Component | File | Description |