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 +204 -0
- package/bin/claude-flow +1 -1
- package/dist/src/cli/help-formatter.js +0 -5
- package/dist/src/cli/simple-cli.js +0 -104
- package/dist/src/cli/simple-cli.js.map +1 -1
- package/dist/src/cli/validation-helper.js.map +1 -1
- package/dist/src/core/version.js +1 -1
- package/dist/src/core/version.js.map +1 -1
- package/dist/src/utils/key-redactor.js.map +1 -1
- package/dist/src/utils/metrics-reader.js +29 -41
- package/dist/src/utils/metrics-reader.js.map +1 -1
- package/docs/AGENTDB_V1.6.1_DEEP_REVIEW.md +386 -0
- package/package.json +3 -3
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.
|
|
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
|
|
@@ -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
|