claude-flow 2.7.32 → 2.7.34

package/docs/V2.7.31_RELEASE_NOTES.md

@@ -1,375 +0,0 @@
-# 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