Repository navigation
v4.2.0 - SwiftHAL v2.1 with Staff-Level Refactoring
✨ Features
SwiftHAL v2.1
- Visual TUI with architecture insights: Risk distribution histogram, architecture hotspots grouped by directory, files needing attention, well-factored files, and comprehensive project health metrics
- Smart summary output: Default format shows high-risk and well-factored files with intelligent filtering (use
--verbosefor all files) - ArgumentParser CLI: Professional declarative CLI with automatic
--helpgeneration, dual path support (--pathflag + positional argument) - Staff-level refactoring: Type-safe MetricKey enum with KeyPath mapping, RiskThresholds/DifficultyThresholds structs eliminating magic numbers, Swift naming conventions throughout
Summarizer
- Multi-model evaluation system: Corpus caching, LM Studio parser improvements, Patient Reported Outcome sample for evals
- Improved LLM consistency: Debug logging and better prompts
CommitCraft
- CHANGELOG automation: Automatic update on commits with conventional format parsing
🐛 Bug Fixes
SwiftHAL
- Fixed compiler warnings (unused variables)
- CI compatibility with Swift 5.9+ (lowered tools version from 6.2)
- Updated to macos-latest runner (resolves deprecation warning)
Summarizer
- Mail rule From filter for better targeting
- Multi-model eval support with LM Studio parser
- Handle None values in digest rendering
CommitCraft
- Working directory detection in Claude Code
- macOS compatibility and uninstall safety
📚 Documentation
SwiftHAL
- Complete Homebrew packaging guide (TODO-HOMEBREW.md)
- Updated README with v2.1 feature descriptions, positional args, --verbose behavior
- Marked swifthal-req.md as historical document
Summarizer
- Mail rule updates: use 'contains' + document IMAP seen flag bug
Project
- Backfilled CHANGELOG with missing commits
🔧 Other Changes
- Emoji-only tag format for Summarizer
- Relaxed validation and removed prompt examples in Summarizer
- Test file verification for CHANGELOG automation
SwiftHAL Binary Included:
SwiftHAL(18MB) - Release binary for macOS (arm64)- Compatible with macOS 13+ (Ventura and later)
- Install:
cp SwiftHAL /usr/local/bin/hal
Installation:
See SwiftHAL README for full installation instructions.