Skip to content

v4.2.0 - SwiftHAL v2.1 with Staff-Level Refactoring

Choose a tag to compare

@randynov randynov released this 08 Nov 16:05
· 41 commits to main since this release

✨ 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 --verbose for all files)
  • ArgumentParser CLI: Professional declarative CLI with automatic --help generation, dual path support (--path flag + 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.