claude-flow 2.7.29 → 2.7.31

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -5,6 +5,210 @@ All notable changes to this project will be documented in this file.
5
5
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6
6
  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
7
 
8
+ ## [2.7.31] - 2025-11-06
9
+
10
+ > **📦 Dependency Update**: Updated agentic-flow to v1.9.4 with new enterprise features
11
+
12
+ ### Summary
13
+ 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.
14
+
15
+ ### 🔧 Changes Made
16
+
17
+ **Updated Dependency** (`package.json:123`):
18
+ ```diff
19
+ "dependencies": {
20
+ - "agentic-flow": "^1.8.10", // ❌ Previous version
21
+ + "agentic-flow": "^1.9.4", // ✅ Latest with enterprise features
22
+ }
23
+ ```
24
+
25
+ ### ✨ New Features (via agentic-flow v1.9.4)
26
+
27
+ **Enterprise Provider Fallback**:
28
+ - Automatic failover: Gemini → Claude → OpenRouter → ONNX
29
+ - Circuit breaker for cascading failure prevention
30
+ - Real-time health monitoring and auto-recovery
31
+ - Cost optimization with provider selection (70% savings)
32
+
33
+ **Cloud Integration**:
34
+ - `@supabase/supabase-js@^2.78.0` for cloud database features
35
+ - Distributed agent coordination capabilities
36
+ - Real-time synchronization support
37
+
38
+ **Reliability Improvements**:
39
+ - Checkpointing for crash recovery
40
+ - Budget controls and cost tracking
41
+ - Enhanced error handling with retry logic
42
+ - Performance monitoring and diagnostics
43
+
44
+ ### 📊 Dependency Analysis
45
+
46
+ **Risk Assessment**: ✅ **LOW** - Safe to upgrade
47
+ - **16 existing dependencies**: All unchanged (no version bumps)
48
+ - **1 new dependency**: `@supabase/supabase-js@^2.78.0` (optional cloud features)
49
+ - **agentdb**: Still v1.6.1 (no regression from v2.7.30)
50
+ - **Full backwards compatibility**: No breaking changes
51
+
52
+ **Comparison (v1.8.10 → v1.9.4)**:
53
+ ```
54
+ IDENTICAL:
55
+ @anthropic-ai/sdk: ^0.65.0
56
+ better-sqlite3: ^11.10.0
57
+ agentdb: ^1.4.3 (we use 1.6.1 - compatible)
58
+ ... 13 other dependencies unchanged
59
+
60
+ NEW:
61
+ @supabase/supabase-js: ^2.78.0
62
+ ```
63
+
64
+ ### 📋 Testing
65
+
66
+ **Local Regression Tests**:
67
+ ```bash
68
+ ✅ CLI version: v2.7.31
69
+ ✅ Memory command: Working
70
+ ✅ ReasoningBank: Initialized successfully
71
+ ✅ agentdb: Still v1.6.1 (no regression)
72
+ ```
73
+
74
+ **Docker Validation** (`tests/docker/Dockerfile.v2.7.31-test`):
75
+ ```bash
76
+ # Build and test
77
+ docker build -f tests/docker/Dockerfile.v2.7.31-test -t test .
78
+ docker run --rm test
79
+
80
+ ✅ Test 1: Claude-Flow version is v2.7.31
81
+ ✅ Test 2: agentic-flow is ^1.9.4 in package.json
82
+ ✅ Test 3: agentic-flow 1.9.4 installed
83
+ ✅ Test 4: agentdb 1.6.1 still installed (no regression)
84
+ ✅ Test 5: ReasoningBank initialization works
85
+ ✅ Test 6: Memory command works
86
+ ✅ Test 7: CLI executes successfully
87
+ ✅ Test 8: @supabase/supabase-js v2.80.0 available
88
+ ```
89
+
90
+ ### 🚀 Installation
91
+
92
+ ```bash
93
+ # NPX users (recommended)
94
+ npx claude-flow@latest init
95
+
96
+ # Global installation
97
+ npm install -g claude-flow@latest
98
+
99
+ # Verify
100
+ claude-flow --version # v2.7.31
101
+ ```
102
+
103
+ ### 💡 CLI Features (via agentic-flow v1.9.4)
104
+
105
+ **New Commands Available**:
106
+ ```bash
107
+ # Enterprise provider management
108
+ npx agentic-flow@latest providers list
109
+ npx agentic-flow@latest providers health
110
+
111
+ # Cost optimization
112
+ npx agentic-flow@latest cost analyze
113
+ npx agentic-flow@latest cost budget --max 100
114
+
115
+ # Checkpointing
116
+ npx agentic-flow@latest checkpoint save
117
+ npx agentic-flow@latest checkpoint restore
118
+
119
+ # 66 specialized agents across 8 categories
120
+ npx agentic-flow@latest agents list
121
+ ```
122
+
123
+ ### 🔗 Documentation
124
+
125
+ - **Dependency Comparison**: `/tmp/compare-versions.md`
126
+ - **agentdb Deep Review**: `docs/AGENTDB_V1.6.1_DEEP_REVIEW.md` (from v2.7.30)
127
+ - **Docker Tests**: `tests/docker/Dockerfile.v2.7.31-test`
128
+
129
+ ### 📦 Package Information
130
+
131
+ **Installed Dependencies**:
132
+ - Added: 2 packages
133
+ - Removed: 16 packages
134
+ - Changed: 8 packages
135
+ - Install time: ~45 seconds (with --legacy-peer-deps)
136
+
137
+ ---
138
+
139
+ ## [2.7.30] - 2025-11-06
140
+
141
+ > **📦 Dependency Update**: Updated agentdb to v1.6.1 for better compatibility
142
+
143
+ ### Summary
144
+ Updated `agentdb` dependency from `^1.3.9` to `^1.6.1` to fix compatibility issues and improve vector database performance.
145
+
146
+ ### 🔧 Changes Made
147
+
148
+ **Updated Dependency** (`package.json:146`):
149
+ ```diff
150
+ "optionalDependencies": {
151
+ "@types/better-sqlite3": "^7.6.13",
152
+ - "agentdb": "^1.3.9", // ❌ Outdated
153
+ + "agentdb": "^1.6.1", // ✅ Latest stable
154
+ "better-sqlite3": "^12.2.0",
155
+ "diskusage": "^1.1.3",
156
+ "node-pty": "^1.0.0"
157
+ }
158
+ ```
159
+
160
+ ### ✅ Benefits
161
+
162
+ **agentdb@1.6.1 includes**:
163
+ - Better compatibility with modern Node.js versions
164
+ - Improved vector database performance (150x faster search)
165
+ - Enhanced HNSW indexing capabilities
166
+ - Better TypeScript support
167
+ - Fixed installation issues on various platforms
168
+
169
+ ### 📋 Testing
170
+
171
+ **Docker Validation** (`tests/docker/Dockerfile.v2.7.30-test`):
172
+ ```bash
173
+ # Build and test
174
+ docker build -f tests/docker/Dockerfile.v2.7.30-test -t test .
175
+ docker run --rm test
176
+
177
+ ✅ Test 1: Version is v2.7.30
178
+ ✅ Test 2: agentdb is ^1.6.1 in package.json
179
+ ✅ Test 3: agentdb 1.6.1 installed correctly
180
+ ✅ Test 4: 730 modules installed successfully
181
+ ✅ Test 5: CLI executes successfully
182
+ ```
183
+
184
+ ### 🚀 Installation
185
+
186
+ ```bash
187
+ # NPX users (recommended)
188
+ npx claude-flow@latest init
189
+
190
+ # Global installation
191
+ npm install -g claude-flow@latest
192
+
193
+ # Verify
194
+ claude-flow --version # v2.7.30
195
+ ```
196
+
197
+ ### 🔗 Related Issues
198
+
199
+ - **Fixes #848**: NPM package regression with outdated agentdb dependency
200
+ - **Dependency Chain**: agentdb@1.6.1 provides latest vector database features
201
+
202
+ ### 💡 Why This Update?
203
+
204
+ The previous agentdb version (1.3.9) was outdated and missing important compatibility fixes. Version 1.6.1 includes:
205
+ - Support for Node.js 20+
206
+ - Improved native module building
207
+ - Better error handling
208
+ - Performance optimizations
209
+
210
+ ---
211
+
8
212
  ## [2.7.29] - 2025-11-06
9
213
 
10
214
  > **🔴 CRITICAL FIX**: Removed non-existent dependencies blocking installation
package/bin/claude-flow CHANGED
@@ -2,7 +2,7 @@
2
2
  # Claude-Flow Smart Dispatcher - Detects and uses the best available runtime
3
3
  # Enhanced with NPX cache error handling and retry logic
4
4
 
5
- VERSION="2.7.29"
5
+ VERSION="2.7.31"
6
6
 
7
7
  # Determine the correct path based on how the script is invoked
8
8
  if [ -L "$0" ]; then
@@ -85,9 +85,4 @@ export class HelpFormatter {
85
85
  }
86
86
  }
87
87
 
88
- //# sourceMappingURL=help-formatter.js.map/\s+/g, ' ');
89
- return text;
90
- }
91
- }
92
-
93
88
  //# sourceMappingURL=help-formatter.js.map
@@ -2973,108 +2973,4 @@ if (import.meta.url === `file://${process.argv[1]}`) {
2973
2973
  await main();
2974
2974
  }
2975
2975
 
2976
- //# sourceMappingURL=simple-cli.js.map sparc run spec-pseudocode "User profile management feature"
2977
-
2978
- # 2. Design architecture
2979
- npx claude-flow sparc run architect "Profile service architecture with data validation"
2980
-
2981
- # 3. Implement with TDD
2982
- npx claude-flow sparc tdd "user profile CRUD operations"
2983
-
2984
- # 4. Security review
2985
- npx claude-flow sparc run security-review "profile data access and validation"
2986
-
2987
- # 5. Integration testing
2988
- npx claude-flow sparc run integration "profile service with authentication system"
2989
-
2990
- # 6. Documentation
2991
- npx claude-flow sparc run docs-writer "profile service API documentation"
2992
- \`\`\`
2993
-
2994
- ### Bug Fix Workflow
2995
- \`\`\`bash
2996
- # 1. Debug and analyze
2997
- npx claude-flow sparc run debug "authentication token expiration issue"
2998
-
2999
- # 2. Write regression tests
3000
- npx claude-flow sparc run tdd "token refresh mechanism tests"
3001
-
3002
- # 3. Implement fix
3003
- npx claude-flow sparc run code "fix token refresh in authentication service"
3004
-
3005
- # 4. Security review
3006
- npx claude-flow sparc run security-review "token handling security implications"
3007
- \`\`\`
3008
-
3009
- ## Configuration Files
3010
-
3011
- ### SPARC Configuration
3012
- - **\`.roomodes\`**: SPARC mode definitions and configurations
3013
- - **\`.roo/\`**: Templates, workflows, and mode-specific rules
3014
-
3015
- ### Claude-Flow Configuration
3016
- - **\`memory/\`**: Persistent memory and session data
3017
- - **\`coordination/\`**: Multi-agent coordination settings
3018
-
3019
- ## Git Workflow Integration
3020
-
3021
- ### Commit Strategy with SPARC
3022
- - **Specification commits**: After completing requirements analysis
3023
- - **Architecture commits**: After design phase completion
3024
- - **TDD commits**: After each Red-Green-Refactor cycle
3025
- - **Integration commits**: After successful component integration
3026
- - **Documentation commits**: After completing documentation updates
3027
-
3028
- ### Branch Strategy
3029
- - **\`feature/sparc-<feature-name>\`**: Feature development with SPARC methodology
3030
- - **\`hotfix/sparc-<issue>\`**: Bug fixes using SPARC debugging workflow
3031
- - **\`refactor/sparc-<component>\`**: Refactoring using optimization mode
3032
-
3033
- ## Troubleshooting
3034
-
3035
- ### Common SPARC Issues
3036
- - **Mode not found**: Check \`.roomodes\` file exists and is valid JSON
3037
- - **Memory persistence**: Ensure \`memory/\` directory has write permissions
3038
- - **Tool access**: Verify required tools are available for the selected mode
3039
- - **Namespace conflicts**: Use unique memory namespaces for different features
3040
-
3041
- ### Debug Commands
3042
- \`\`\`bash
3043
- # Check SPARC configuration
3044
- npx claude-flow sparc modes
3045
-
3046
- # Verify memory system
3047
- npx claude-flow memory stats
3048
-
3049
- # Check system status
3050
- npx claude-flow status
3051
-
3052
- # View detailed mode information
3053
- npx claude-flow sparc info <mode-name>
3054
- \`\`\`
3055
-
3056
- ## Project Architecture
3057
-
3058
- This SPARC-enabled project follows a systematic development approach:
3059
- - **Clear separation of concerns** through modular design
3060
- - **Test-driven development** ensuring reliability and maintainability
3061
- - **Iterative refinement** for continuous improvement
3062
- - **Comprehensive documentation** for team collaboration
3063
- - **AI-assisted development** through specialized SPARC modes
3064
-
3065
- ## Important Notes
3066
-
3067
- - Always run tests before committing (\`npm run test\`)
3068
- - Use SPARC memory system to maintain context across sessions
3069
- - Follow the Red-Green-Refactor cycle during TDD phases
3070
- - Document architectural decisions in memory for future reference
3071
- - Regular security reviews for any authentication or data handling code
3072
-
3073
- For more information about SPARC methodology, see: https://github.com/ruvnet/claude-code-flow/docs/sparc.md
3074
- `;
3075
- }
3076
- if (isMainModule(import.meta.url)) {
3077
- await main();
3078
- }
3079
-
3080
2976
  //# sourceMappingURL=simple-cli.js.map