claude-flow 2.7.31 → 2.7.33

package/docs/V2.7.31_RELEASE_NOTES.md

@@ -0,0 +1,375 @@
+# claude-flow v2.7.31 Release Notes
+
+**Release Date**: 2025-11-06
+**Release Type**: Dependency Update (agentic-flow v1.9.4)
+**Risk Level**: LOW ✅
+**Git Tag**: `v2.7.31`
+**NPM**: `claude-flow@2.7.31` (latest, alpha)
+
+---
+
+## 🎯 Summary
+
+Updated `agentic-flow` dependency from `^1.8.10` to `^1.9.4`, adding enterprise-grade features including provider fallback, Supabase cloud integration, circuit breaker patterns, and enhanced reliability capabilities.
+
+---
+
+## 📦 Dependency Changes
+
+### Updated Dependencies
+```json
+{
+  "agentic-flow": "^1.9.4"  // Was: ^1.8.10
+}
+```
+
+### New Transitive Dependencies
+```json
+{
+  "@supabase/supabase-js": "^2.78.0"  // Cloud database features
+}
+```
+
+### Unchanged (No Regression)
+- **agentdb**: `^1.6.1` (stable from v2.7.30)
+- **16 other dependencies**: All version numbers unchanged
+- **Full backwards compatibility**: No breaking changes
+
+---
+
+## ✨ New Features (via agentic-flow v1.9.4)
+
+### 1. Enterprise Provider Fallback
+**Automatic failover chain**: `Gemini → Claude → OpenRouter → ONNX`
+
+- **Circuit breaker**: Prevents cascading failures in distributed systems
+- **Real-time health monitoring**: Automatic provider health checks
+- **Auto-recovery**: Seamless failover when providers are down
+- **Cost optimization**: 70% cost savings with intelligent routing
+
+**Usage**:
+```bash
+# Check provider health
+npx agentic-flow@latest providers health
+
+# List available providers
+npx agentic-flow@latest providers list
+```
+
+### 2. Supabase Cloud Integration
+**Cloud database and authentication platform**
+
+- **Distributed coordination**: Multi-instance agent synchronization
+- **Real-time updates**: Live data synchronization across agents
+- **Authentication**: Secure cloud-based auth system
+- **Persistent storage**: Cloud-backed memory and state
+
+### 3. Reliability Improvements
+**Enterprise-grade stability features**
+
+- **Checkpointing**: Automatic crash recovery
+  ```bash
+  npx agentic-flow@latest checkpoint save
+  npx agentic-flow@latest checkpoint restore
+  ```
+- **Budget controls**: Cost tracking and limits
+  ```bash
+  npx agentic-flow@latest cost budget --max 100
+  ```
+- **Enhanced retry logic**: Intelligent error handling
+- **Performance monitoring**: Real-time diagnostics
+
+### 4. Cost Optimization
+- **Provider selection**: Automatic cost-aware routing
+- **Token tracking**: Real-time usage monitoring
+- **Budget alerts**: Prevent overspending
+- **Analytics**: Cost analysis and recommendations
+
+---
+
+## 🔍 Risk Assessment: LOW ✅
+
+### Why This Update is Safe
+
+1. **Minimal Dependency Changes**
+   - 16 existing dependencies: **All unchanged**
+   - 1 new optional dependency: `@supabase/supabase-js`
+   - No version bumps in critical dependencies
+
+2. **Full Backwards Compatibility**
+   - No breaking changes in agentic-flow API
+   - All existing features continue to work
+   - agentdb remains at v1.6.1 (no regression)
+
+3. **Comprehensive Testing**
+   - ✅ 8/8 Docker regression tests passed
+   - ✅ Local validation complete
+   - ✅ CLI, memory, ReasoningBank all functional
+
+---
+
+## 📋 Testing Results
+
+### Docker Validation Suite
+**Image**: `claude-flow-test:v2.7.31`
+**Test File**: `tests/docker/Dockerfile.v2.7.31-test`
+
+```bash
+# Build and run tests
+docker build -f tests/docker/Dockerfile.v2.7.31-test -t test .
+docker run --rm test
+```
+
+**Test Results**:
+1. ✅ **Version Check**: Claude-Flow v2.7.31 confirmed
+2. ✅ **package.json**: agentic-flow ^1.9.4 present
+3. ✅ **Installation**: agentic-flow 1.9.4 installed correctly
+4. ✅ **No Regression**: agentdb still v1.6.1
+5. ✅ **ReasoningBank**: Initialization successful
+6. ✅ **Memory Command**: Functional
+7. ✅ **CLI Execution**: Working correctly
+8. ✅ **New Dependency**: @supabase/supabase-js@2.80.0 available
+
+### Local Regression Tests
+```bash
+✅ CLI version: v2.7.31
+✅ Memory stats: Working
+✅ ReasoningBank init: Success
+✅ agentdb: v1.6.1 (no regression)
+```
+
+---
+
+## 💻 Installation
+
+### For End Users
+```bash
+# NPX (recommended for quick use)
+npx claude-flow@latest init
+
+# Global installation
+npm install -g claude-flow@latest
+
+# Local project installation
+npm install claude-flow@latest
+
+# Verify installation
+claude-flow --version  # Output: v2.7.31
+```
+
+### For Developers
+```bash
+# Clone repository
+git clone https://github.com/ruvnet/claude-flow.git
+cd claude-flow
+
+# Checkout v2.7.31 tag
+git checkout v2.7.31
+
+# Install dependencies
+npm install --legacy-peer-deps
+
+# Run tests
+npm test
+```
+
+---
+
+## 🚀 New CLI Commands (via agentic-flow)
+
+### Provider Management
+```bash
+# List available LLM providers
+npx agentic-flow@latest providers list
+
+# Check provider health status
+npx agentic-flow@latest providers health
+
+# Get provider details
+npx agentic-flow@latest providers info gemini
+```
+
+### Cost Management
+```bash
+# Analyze current costs
+npx agentic-flow@latest cost analyze
+
+# Set budget limit
+npx agentic-flow@latest cost budget --max 100
+
+# View cost history
+npx agentic-flow@latest cost history
+```
+
+### Checkpointing
+```bash
+# Save current state
+npx agentic-flow@latest checkpoint save
+
+# List checkpoints
+npx agentic-flow@latest checkpoint list
+
+# Restore from checkpoint
+npx agentic-flow@latest checkpoint restore <id>
+```
+
+### Agent Management
+```bash
+# List all 66 available agents
+npx agentic-flow@latest agents list
+
+# Get agent details
+npx agentic-flow@latest agent info coder
+
+# Run agent with task
+npx agentic-flow@latest agent run coder "Build REST API"
+```
+
+---
+
+## 📊 Performance Metrics
+
+### Installation
+- **Added packages**: 2
+- **Removed packages**: 16
+- **Changed packages**: 8
+- **Install time**: ~45 seconds (with --legacy-peer-deps)
+- **Total packages**: 730+ (consistent with v2.7.30)
+
+### Runtime
+- **Startup time**: No regression (< 1s)
+- **Memory usage**: Similar to v2.7.30
+- **CLI responsiveness**: Excellent
+- **ReasoningBank init**: ~2-3 seconds
+
+---
+
+## 🔗 Related Documentation
+
+### This Release
+- **CHANGELOG.md**: Full v2.7.31 release notes
+- **Docker Tests**: `tests/docker/Dockerfile.v2.7.31-test`
+- **Dependency Comparison**: `/tmp/compare-versions.md` (build artifact)
+
+### Previous Release (v2.7.30)
+- **agentdb Update**: `docs/AGENTDB_V1.6.1_DEEP_REVIEW.md`
+- **Docker Tests**: `tests/docker/Dockerfile.agentdb-deep-review`
+
+### General Documentation
+- **README.md**: Project overview and quick start
+- **CLAUDE.md**: Development guidelines and SPARC methodology
+- **GitHub**: https://github.com/ruvnet/claude-flow
+
+---
+
+## 🐛 Known Issues
+
+### None Detected
+No known issues or regressions in v2.7.31. All tests passing.
+
+If you encounter any issues, please report at:
+- **GitHub Issues**: https://github.com/ruvnet/claude-flow/issues
+
+---
+
+## 🔄 Migration Guide
+
+### From v2.7.30 to v2.7.31
+**No migration needed** - Drop-in replacement
+
+```bash
+# Update existing installation
+npm install -g claude-flow@latest
+
+# Verify update
+claude-flow --version  # Should show v2.7.31
+```
+
+### From v2.7.29 or Earlier
+If upgrading from v2.7.29 or earlier:
+1. Update to v2.7.30 first (agentdb update)
+2. Then update to v2.7.31 (agentic-flow update)
+
+Or directly update to v2.7.31 (fully compatible).
+
+---
+
+## 🎉 What's Next?
+
+### Potential Future Enhancements
+Based on new agentic-flow v1.9.4 features:
+
+1. **Cloud Coordination**: Leverage Supabase for distributed swarms
+2. **Cost Dashboards**: Visual cost analytics and budget management
+3. **Enhanced Checkpointing**: Automatic state recovery
+4. **Provider Analytics**: Deep insights into LLM usage patterns
+5. **Enterprise Features**: Multi-tenant support, SSO, audit logs
+
+---
+
+## 🙏 Credits
+
+### Contributors
+- **rUv**: Package maintainer and primary developer
+- **Claude Code**: AI assistant for testing and documentation
+- **agentic-flow team**: Upstream dependency maintainers
+
+### Dependencies
+- **agentic-flow@1.9.4**: Core agent orchestration platform
+- **agentdb@1.6.1**: High-performance vector database
+- **@supabase/supabase-js@2.78.0**: Cloud database integration
+
+---
+
+## 📝 Changelog Entry
+
+```markdown
+## [2.7.31] - 2025-11-06
+
+> **📦 Dependency Update**: Updated agentic-flow to v1.9.4 with new enterprise features
+
+### Summary
+Updated `agentic-flow` dependency from `^1.8.10` to `^1.9.4` to add new enterprise features including Supabase cloud integration, provider fallback, circuit breaker patterns, and enhanced reliability features.
+
+### Changes
+- agentic-flow: ^1.8.10 → ^1.9.4
+- NEW: @supabase/supabase-js@^2.78.0
+- agentdb: Still v1.6.1 (no regression)
+
+### Testing
+✅ 8/8 Docker tests passed
+✅ All regression tests passed
+✅ No breaking changes detected
+
+### Risk: LOW
+- 16 existing dependencies unchanged
+- 1 new optional dependency
+- Full backwards compatibility
+```
+
+---
+
+## 📅 Release Timeline
+
+- **2025-11-05**: agentdb updated to v1.6.1 (v2.7.30)
+- **2025-11-06**: agentic-flow updated to v1.9.4 (v2.7.31)
+- **Next**: Monitor for user feedback and potential hotfixes
+
+---
+
+## 🔍 Version Matrix
+
+| Package | v2.7.30 | v2.7.31 | Notes |
+|---------|---------|---------|-------|
+| claude-flow | 2.7.30 | **2.7.31** | ✅ Updated |
+| agentic-flow | 1.8.10 | **1.9.4** | ✅ Updated |
+| agentdb | 1.6.1 | 1.6.1 | ✅ Stable |
+| better-sqlite3 | 12.2.0 | 12.2.0 | ✅ Unchanged |
+| @anthropic-ai/sdk | 0.65.0 | 0.65.0 | ✅ Unchanged |
+| @supabase/supabase-js | - | **2.78.0** | ✨ NEW |
+
+---
+
+**Release Notes Generated**: 2025-11-06
+**Document Version**: 1.0
+**Status**: ✅ Published and Validated

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-flow",
-  "version": "2.7.31",
+  "version": "2.7.33",
   "description": "Enterprise-grade AI agent orchestration with WASM-powered ReasoningBank memory and AgentDB vector database (always uses latest agentic-flow)",
   "mcpName": "io.github.ruvnet/claude-flow",
   "main": "cli.mjs",
@@ -168,6 +168,7 @@
     "@typescript-eslint/eslint-plugin": "^6.21.0",
     "@typescript-eslint/parser": "^6.21.0",
     "@vercel/ncc": "^0.38.3",
+    "agentic-jujutsu": "^2.3.2",
     "babel-jest": "^29.7.0",
     "eslint": "^8.57.1",
     "eslint-plugin-react": "^7.37.5",

package/src/cli/simple-commands/init/agent-copier.js

@@ -135,35 +135,30 @@ export async function copyAgentFiles(targetDir, options = {}) {
  * Create agent directories structure
  */
 export async function createAgentDirectories(targetDir, dryRun = false) {
+  // Flat structure - all .md files directly in category folders
   const agentDirs = [
     '.claude',
     '.claude/agents',
     '.claude/agents/core',
-    '.claude/agents/swarm', 
+    '.claude/agents/swarm',
     '.claude/agents/hive-mind',
     '.claude/agents/consensus',
     '.claude/agents/optimization',
     '.claude/agents/github',
     '.claude/agents/sparc',
     '.claude/agents/testing',
-    '.claude/agents/testing/unit',
-    '.claude/agents/testing/validation',
     '.claude/agents/templates',
     '.claude/agents/analysis',
-    '.claude/agents/analysis/code-review',
     '.claude/agents/architecture',
-    '.claude/agents/architecture/system-design',
     '.claude/agents/data',
-    '.claude/agents/data/ml',
     '.claude/agents/development',
-    '.claude/agents/development/backend',
     '.claude/agents/devops',
-    '.claude/agents/devops/ci-cd',
     '.claude/agents/documentation',
-    '.claude/agents/documentation/api-docs',
     '.claude/agents/specialized',
-    '.claude/agents/specialized/mobile',
     '.claude/agents/flow-nexus',
+    '.claude/agents/goal',
+    '.claude/agents/neural',
+    '.claude/agents/reasoning',
     '.claude/commands',
     '.claude/commands/flow-nexus'
   ];

package/src/cli/simple-commands/memory.js

@@ -49,6 +49,7 @@ export async function memoryCommand(subArgs, flags) {
   }
 
   // NEW: Delegate to ReasoningBank for regular commands if mode is set
+  // Note: 'stats' is handled in switch statement for unified output
   if (mode === 'reasoningbank' && ['store', 'query', 'list'].includes(memorySubcommand)) {
     return await handleReasoningBankCommand(memorySubcommand, subArgs, flags);
   }
@@ -63,7 +64,9 @@ export async function memoryCommand(subArgs, flags) {
       break;
 
     case 'stats':
-      await showMemoryStats(loadMemory);
+      // Always use showMemoryStats for unified output
+      // It will detect mode and show appropriate stats
+      await showMemoryStats(loadMemory, mode);
       break;
 
     case 'export':
@@ -214,28 +217,95 @@ async function queryMemory(subArgs, loadMemory, namespace, enableRedaction = fal
   }
 }
 
-async function showMemoryStats(loadMemory) {
+async function showMemoryStats(loadMemory, mode) {
   try {
-    const data = await loadMemory();
-    let totalEntries = 0;
-    const namespaceStats = {};
+    const rbInitialized = await isReasoningBankInitialized();
 
-    for (const [namespace, entries] of Object.entries(data)) {
-      namespaceStats[namespace] = entries.length;
-      totalEntries += entries.length;
-    }
+    // If in auto mode and ReasoningBank is initialized, show unified stats
+    if (mode === 'reasoningbank' || (rbInitialized && mode !== 'basic')) {
+      // Show unified statistics for both backends
+      printSuccess('Memory Bank Statistics:\n');
 
-    printSuccess('Memory Bank Statistics:');
-    console.log(`   Total Entries: ${totalEntries}`);
-    console.log(`   Namespaces: ${Object.keys(data).length}`);
-    console.log(
-      `   Size: ${(new TextEncoder().encode(JSON.stringify(data)).length / 1024).toFixed(2)} KB`,
-    );
+      // JSON Storage stats
+      const data = await loadMemory();
+      let totalEntries = 0;
+      const namespaceStats = {};
 
-    if (Object.keys(data).length > 0) {
-      console.log('\n📁 Namespace Breakdown:');
-      for (const [namespace, count] of Object.entries(namespaceStats)) {
-        console.log(`   ${namespace}: ${count} entries`);
+      for (const [namespace, entries] of Object.entries(data)) {
+        namespaceStats[namespace] = entries.length;
+        totalEntries += entries.length;
+      }
+
+      console.log('📁 JSON Storage (./memory/memory-store.json):');
+      console.log(`   Total Entries: ${totalEntries}`);
+      console.log(`   Namespaces: ${Object.keys(data).length}`);
+      console.log(
+        `   Size: ${(new TextEncoder().encode(JSON.stringify(data)).length / 1024).toFixed(2)} KB`,
+      );
+
+      if (Object.keys(data).length > 0) {
+        console.log('   Namespace Breakdown:');
+        for (const [namespace, count] of Object.entries(namespaceStats)) {
+          console.log(`     ${namespace}: ${count} entries`);
+        }
+      }
+
+      // ReasoningBank stats
+      if (rbInitialized) {
+        try {
+          const { getStatus } = await import('../../reasoningbank/reasoningbank-adapter.js');
+          const rbStats = await getStatus();
+
+          console.log('\n🧠 ReasoningBank Storage (.swarm/memory.db):');
+          console.log(`   Total Memories: ${rbStats.total_memories}`);
+          console.log(`   Categories: ${rbStats.total_categories}`);
+          console.log(`   Average Confidence: ${(rbStats.avg_confidence * 100).toFixed(1)}%`);
+          console.log(`   Embeddings: ${rbStats.total_embeddings}`);
+          console.log(`   Trajectories: ${rbStats.total_trajectories}`);
+
+          // Get database file size
+          try {
+            const dbPath = rbStats.database_path || '.swarm/memory.db';
+            const stats = await fs.stat(dbPath);
+            console.log(`   Database Size: ${(stats.size / 1024 / 1024).toFixed(2)} MB`);
+          } catch (sizeErr) {
+            // Ignore size calculation errors
+          }
+
+          console.log('\n💡 Active Mode: ReasoningBank (auto-selected)');
+          console.log('   Use --basic flag to force JSON-only statistics');
+        } catch (rbErr) {
+          console.log('\n⚠️  ReasoningBank stats unavailable:', rbErr.message);
+        }
+      }
+    } else {
+      // Basic mode - JSON only
+      const data = await loadMemory();
+      let totalEntries = 0;
+      const namespaceStats = {};
+
+      for (const [namespace, entries] of Object.entries(data)) {
+        namespaceStats[namespace] = entries.length;
+        totalEntries += entries.length;
+      }
+
+      printSuccess('Memory Bank Statistics (JSON Mode):');
+      console.log(`   Total Entries: ${totalEntries}`);
+      console.log(`   Namespaces: ${Object.keys(data).length}`);
+      console.log(
+        `   Size: ${(new TextEncoder().encode(JSON.stringify(data)).length / 1024).toFixed(2)} KB`,
+      );
+
+      if (Object.keys(data).length > 0) {
+        console.log('\n📁 Namespace Breakdown:');
+        for (const [namespace, count] of Object.entries(namespaceStats)) {
+          console.log(`   ${namespace}: ${count} entries`);
+        }
+      }
+
+      if (!rbInitialized) {
+        console.log('\n💡 Tip: Initialize ReasoningBank for AI-powered memory');
+        console.log('   Run: memory init --reasoningbank');
       }
     }
   } catch (err) {
@@ -578,6 +648,10 @@ async function handleReasoningBankCommand(command, subArgs, flags) {
         await handleReasoningBankStatus(getStatus);
         break;
 
+      case 'stats':
+        await handleReasoningBankStatus(getStatus);
+        break;
+
       case 'consolidate':
       case 'demo':
       case 'test':