claude-flow 2.7.28 → 2.7.29

package/CHANGELOG.md

@@ -5,6 +5,99 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.7.29] - 2025-11-06
+
+> **🔴 CRITICAL FIX**: Removed non-existent dependencies blocking installation
+
+### Summary
+Fixed critical installation blocker by removing `@xenova/transformers@^3.2.0` and `onnxruntime-node` from optionalDependencies. Version 3.2.0 of transformers doesn't exist (latest is 2.17.2), causing npm install failures for all users on v2.7.24-v2.7.28.
+
+### 🐛 Bug Fixed
+
+**Issue**: Users unable to install claude-flow due to non-existent dependency
+```
+npm error Could not resolve dependency:
+npm error optional @xenova/transformers@"^3.2.0"
+```
+
+**Root Cause**: `package.json` specified `@xenova/transformers@^3.2.0`, but only version 2.17.2 exists on npm.
+
+### 🔧 Changes Made
+
+**Removed Dependencies** (`package.json`):
+```diff
+  "optionalDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+-   "@xenova/transformers": "^3.2.0",  // ❌ Version doesn't exist
+    "agentdb": "^1.3.9",
+    "better-sqlite3": "^12.2.0",
+    "diskusage": "^1.1.3",
+-   "node-pty": "^1.0.0",
+-   "onnxruntime-node": "^1.23.0"     // ❌ Also removed
++   "node-pty": "^1.0.0"
+  }
+```
+
+### ✅ Impact
+
+**Before v2.7.29** (Broken):
+- ❌ v2.7.24-v2.7.28: Installation fails
+- Users forced to use v2.0.0-alpha.2 or pre-v2.7.24
+
+**After v2.7.29** (Fixed):
+- ✅ npm install works correctly
+- ✅ All features functional
+- ✅ No code changes needed (deps were optional)
+
+### 📋 Testing
+
+**Docker Validation** (`tests/docker/Dockerfile.v2.7.29-test`):
+```bash
+# Build and test
+docker build -f tests/docker/Dockerfile.v2.7.29-test -t claude-flow-v2.7.29-test .
+docker run --rm claude-flow-v2.7.29-test
+
+✅ Test 1: Version is v2.7.29
+✅ Test 2: @xenova/transformers removed
+✅ Test 3: onnxruntime-node removed
+✅ Test 4: Dependencies installed (726 modules)
+✅ Test 5: CLI executes successfully
+✅ Test 6: Removed deps not in node_modules
+```
+
+### 🚀 Installation
+
+```bash
+# NPX users (recommended)
+npx claude-flow@latest init
+
+# Global installation
+npm install -g claude-flow@latest
+
+# Verify
+claude-flow --version  # v2.7.29
+```
+
+### 📝 Affected Versions
+
+**Broken** (DO NOT USE):
+- v2.7.24 - v2.7.28
+
+**Fixed**:
+- v2.7.29 (this release)
+- v2.0.0-alpha.2 (older, still works)
+
+### 🔗 Related Issues
+
+- **Fixes #858**: Critical: Invalid @xenova/transformers dependency blocks installation
+- **Related to v2.7.24**: commit `aef451661` introduced the bug
+
+### 💡 Why This Happened
+
+The transformers dependency was added in v2.7.24 for local semantic search but used a non-existent version number (`3.2.0` instead of `2.17.2`). Since it was in `optionalDependencies`, npm still tried to resolve it, causing installation to fail.
+
+---
+
 ## [2.7.28] - 2025-11-06
 
 > **🎯 Enhancement Release**: Removed automatic installation of agentic-payments MCP server - payment integrations now opt-in

package/bin/claude-flow

@@ -2,7 +2,7 @@
 # Claude-Flow Smart Dispatcher - Detects and uses the best available runtime
 # Enhanced with NPX cache error handling and retry logic
 
-VERSION="2.7.28"
+VERSION="2.7.29"
 
 # Determine the correct path based on how the script is invoked
 if [ -L "$0" ]; then

package/dist/src/cli/help-formatter.js

@@ -85,4 +85,9 @@ export class HelpFormatter {
     }
 }
 
+//# sourceMappingURL=help-formatter.js.map/\s+/g, ' ');
+        return text;
+    }
+}
+
 //# sourceMappingURL=help-formatter.js.map

package/dist/src/cli/simple-cli.js

@@ -2973,4 +2973,108 @@ if (import.meta.url === `file://${process.argv[1]}`) {
     await main();
 }
 
+//# sourceMappingURL=simple-cli.js.map sparc run spec-pseudocode "User profile management feature"
+
+# 2. Design architecture
+npx claude-flow sparc run architect "Profile service architecture with data validation"
+
+# 3. Implement with TDD
+npx claude-flow sparc tdd "user profile CRUD operations"
+
+# 4. Security review
+npx claude-flow sparc run security-review "profile data access and validation"
+
+# 5. Integration testing
+npx claude-flow sparc run integration "profile service with authentication system"
+
+# 6. Documentation
+npx claude-flow sparc run docs-writer "profile service API documentation"
+\`\`\`
+
+### Bug Fix Workflow
+\`\`\`bash
+# 1. Debug and analyze
+npx claude-flow sparc run debug "authentication token expiration issue"
+
+# 2. Write regression tests
+npx claude-flow sparc run tdd "token refresh mechanism tests"
+
+# 3. Implement fix
+npx claude-flow sparc run code "fix token refresh in authentication service"
+
+# 4. Security review
+npx claude-flow sparc run security-review "token handling security implications"
+\`\`\`
+
+## Configuration Files
+
+### SPARC Configuration
+- **\`.roomodes\`**: SPARC mode definitions and configurations
+- **\`.roo/\`**: Templates, workflows, and mode-specific rules
+
+### Claude-Flow Configuration
+- **\`memory/\`**: Persistent memory and session data
+- **\`coordination/\`**: Multi-agent coordination settings
+
+## Git Workflow Integration
+
+### Commit Strategy with SPARC
+- **Specification commits**: After completing requirements analysis
+- **Architecture commits**: After design phase completion
+- **TDD commits**: After each Red-Green-Refactor cycle
+- **Integration commits**: After successful component integration
+- **Documentation commits**: After completing documentation updates
+
+### Branch Strategy
+- **\`feature/sparc-<feature-name>\`**: Feature development with SPARC methodology
+- **\`hotfix/sparc-<issue>\`**: Bug fixes using SPARC debugging workflow
+- **\`refactor/sparc-<component>\`**: Refactoring using optimization mode
+
+## Troubleshooting
+
+### Common SPARC Issues
+- **Mode not found**: Check \`.roomodes\` file exists and is valid JSON
+- **Memory persistence**: Ensure \`memory/\` directory has write permissions
+- **Tool access**: Verify required tools are available for the selected mode
+- **Namespace conflicts**: Use unique memory namespaces for different features
+
+### Debug Commands
+\`\`\`bash
+# Check SPARC configuration
+npx claude-flow sparc modes
+
+# Verify memory system
+npx claude-flow memory stats
+
+# Check system status
+npx claude-flow status
+
+# View detailed mode information
+npx claude-flow sparc info <mode-name>
+\`\`\`
+
+## Project Architecture
+
+This SPARC-enabled project follows a systematic development approach:
+- **Clear separation of concerns** through modular design
+- **Test-driven development** ensuring reliability and maintainability
+- **Iterative refinement** for continuous improvement
+- **Comprehensive documentation** for team collaboration
+- **AI-assisted development** through specialized SPARC modes
+
+## Important Notes
+
+- Always run tests before committing (\`npm run test\`)
+- Use SPARC memory system to maintain context across sessions
+- Follow the Red-Green-Refactor cycle during TDD phases
+- Document architectural decisions in memory for future reference
+- Regular security reviews for any authentication or data handling code
+
+For more information about SPARC methodology, see: https://github.com/ruvnet/claude-code-flow/docs/sparc.md
+`;
+}
+if (isMainModule(import.meta.url)) {
+    await main();
+}
+
 //# sourceMappingURL=simple-cli.js.map