Major Release: Revolutionary upgrade to 4-dimensional code quality analysis with strategic improvement recommendations.
🚨 Breaking Changes
Project scores will change due to the new scoring methodology:
| Before (v0.7.1) | Now (v0.8.0) |
|---|---|
| 3 dimensions | 4 dimensions |
| Complexity: 45% | Complexity: 35% |
| Maintainability: 30% | Maintainability: 25% |
| Duplication: 25% | Duplication: 20% |
| — | Reliability: 20% ⭐ |
Migration: Re-run analysis to see updated scores reflecting the enhanced methodology.
✨ Major New Features
🛡️ Reliability Score (New 4th Dimension)
- Measures code robustness based on detected quality issues and anti-patterns
- Progressive penalty system for critical/high/medium/low severity issues
- Function-level aggregation combining all detected problems
- 20% weight in overall project scoring
🎯 Quick Wins Analysis
- Strategic improvement recommendations with high ROI (impact vs effort)
- Effort estimation in hours based on complexity and criticality
- Priority categorization by strategic value and immediate impact
- Actionable insights to guide refactoring decisions
📊 Quality Patterns Detection
- Anti-pattern identification in both quality and architecture categories
- Enhanced Markdown reports with detailed pattern analysis
- Problem categorization with implications and recommendations
🚀 Performance Improvements
⚡ Function Analysis Optimization
- Batching: Process functions in batches of 50 for memory efficiency
- Smart caching: WeakMap caching to avoid redundant analysis
- Timeout guards: 30s per file with graceful partial completion
- Memory management: Periodic cache clearing during analysis
🔧 AST Performance Enhancements
- Pre-compiled regex patterns for 3x faster pattern matching
- Optimized lookups with Set data structures for O(1) operations
- Reduced redundancy with intelligent getText() caching
- Performance monitoring with detailed timing utilities
🎨 User Experience Enhancements
📱 Enhanced CLI Output
- Reliability score display in terminal overview
- Improved file sorting by architectural importance
- Better formatting with enhanced legends and visual hierarchy
📝 Improved Reports
- Quick Wins section with comprehensive ROI analysis
- Strategic narratives with problem pattern identification
- Enhanced insights for more actionable recommendations
🔧 Algorithm Improvements
🎯 Enhanced Detection
- "God Function" detection using multiple metrics (operations, complexity, lines)
- Improved responsibility analysis (IO, validation, transformation patterns)
- Enhanced purity detection for functional programming analysis
📈 Smarter Prioritization
- Criticism score-based sorting puts architecturally important files first
- Enhanced maintainability scoring with cohesion and coupling metrics
📦 Installation & Upgrade
# Install latest
npm install -g insightcode-cli
# Upgrade existing installation
npm update -g insightcode-cli
# Verify installation
insightcode --version # Should show 0.8.0
---
🔗 Resources
- 📚 https://github.com/fstepho/insightcode-cli/blob/main/CHANGELOG.md - Complete technical details
- 📖 https://github.com/fstepho/insightcode-cli#readme - Usage guide and examples
- 🐛 https://github.com/fstepho/insightcode-cli/issues - Bug reports and feature requests
- 📦 https://www.npmjs.com/package/insightcode-cli - Package page
---
🎉 What's Next?
Try the new Quick Wins analysis to identify your highest-ROI code improvements:
insightcode ./your-project --format markdown
# Look for the new "🚀 Quick Wins Analysis" section!