Skip to content

🔧 commit-checker v0.6.1

Choose a tag to compare

View all tags
@AmariahAK AmariahAK released this 28 Jul 10:43
· 38 commits to main since this release
v0.6.1
4e6f23b

🔧 commit-checker v0.6.1 - Critical Fixes & Enhanced Reliability

Release Date: July 28, 2025
Priority: 🔴 High (Recommended for all v0.6.0 users)

🚨 Critical Fixes

Complete Uninstallation (Major Fix)

  • ✅ Fixed incomplete removal: --uninstall now properly removes ALL traces of commit-checker
  • ✅ Shell cleanup: Automatically removes auto-run commands from ~/.zshrc, ~/.bashrc, ~/.bash_profile, ~/.profile, and Fish config
  • ✅ No more phantom runs: Commit-checker will no longer auto-run after uninstallation
  • ✅ Smart detection: Cleans up comments, empty lines, and all commit-checker references
  • 🔧 Covers all installation methods: Works for pip, pipx, and standalone installations

Interactive Setup Wizard Validation

  • ✅ Bulletproof input validation: Fixed ability to enter invalid choices (letters, out-of-range numbers)
  • ✅ Clear error messages: Shows helpful feedback like "❌ Invalid choice. Please enter 1-5..."
  • ✅ Retry loops: Prevents wizard from crashing on invalid input
  • ✅ All prompts validated: Development paths, themes, output style, TIL configuration, final confirmation
  • 🎯 Better UX: Immediate theme confirmation with "✨ Theme set to: tech"

Repository Detection Enhancement

  • ✅ Fixed duplicate detection: No more duplicate entries like /Documents/GitHub and /Documents/Github
  • ✅ Accurate repo counting: Properly resolves symlinks and path variations
  • ✅ Sorted output: Development paths now appear in logical, sorted order
  • ✅ Better deduplication: Uses path resolution to eliminate false duplicates

🚀 Standalone Script Completeness

Feature Parity Achieved

  • ✅ All commands available: Standalone script now includes ALL v0.6.0 features
  • ✅ Gamification: --achievements, --xp commands now work in standalone
  • ✅ Analytics: --heatmap, --stats-lang, --heatmap-export svg fully functional
  • ✅ Repository Management: --scan, --repos-summary, --most-active with timeframes
  • ✅ TIL Vault: Complete template system, search, vault management in standalone
  • ✅ System Commands: --update, --diagnose now available in curl-installed version

Enhanced Module Loading

  • ✅ Auto-download: Missing modules (gamification.py, analytics.py, etc.) auto-downloaded
  • ✅ Gamification Integration: Full XP, achievement, and streak tracking in standalone
  • ✅ Complete CLI: 35+ command-line options now available in standalone version

🛠️ Technical Improvements

Code Quality & Reliability

  • ✅ Robust error handling: Better fallbacks and graceful degradation
  • ✅ Input validation framework: Consistent validation patterns across all user inputs
  • ✅ Path resolution: Smarter handling of symlinks and path variations
  • ✅ Cross-platform cleanup: Shell file cleaning works on macOS, Linux, and Windows

User Experience Enhancements

  • ✅ Instant feedback: Theme selection shows immediate confirmation
  • ✅ Better error messages: Clear, actionable error messages throughout
  • ✅ Validation consistency: All wizard inputs use same validation pattern
  • ✅ Support link update: Updated from PayPal to Buy Me A Coffee

🔄 Migration Notes

For v0.6.0 Users

  • Recommended action: Update immediately to fix uninstall and wizard issues
  • Breaking changes: None - fully backward compatible
  • Config migration: Automatic - no user action required
  • Shell cleanup: Existing auto-run commands will be properly removed on uninstall

For Standalone Users

  • Auto-update: New features automatically available via curl install
  • Feature boost: You now have access to ALL gamification and analytics features
  • No reconfiguration: Existing configs continue to work

📈 What's Fixed in Detail

Issue v0.6.0 Behavior v0.6.1 Fix
Uninstall cleanup Left auto-run commands in shell files ✅ Complete removal from all shell configs
Invalid wizard input Allowed letters/invalid numbers, crashed ✅ Validation loops with clear error messages
Duplicate repo paths Showed same path multiple times ✅ Smart deduplication with path resolution
Standalone missing features Limited to basic commands only ✅ All 35+ commands now available
Theme feedback No confirmation of theme selection ✅ Instant "Theme set to: X" confirmation
Repo counting Incorrect git repo counts in wizard ✅ Accurate counting with proper validation

🧪 Testing Verification

All fixes have been tested across:

  • ✅ macOS (Sonoma 14.5+, Sequoia 15.0+)
  • ✅ Multiple shell environments (zsh, bash, fish)
  • ✅ Installation methods (standalone, pip, pipx)
  • ✅ Edge cases (symlinks, duplicate paths, invalid inputs)

📦 Installation & Update

Update Existing Installation

# For standalone users
curl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/scripts/install-safe.sh | bash

# For pip users
pip install --upgrade git+https://github.com/AmariahAK/commit-checker.git@v0.6.1

Fresh Installation

# Recommended method
curl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/scripts/install-safe.sh | bash

🐛 Issues Resolved

  • #1: Incomplete uninstallation leaving shell startup commands
  • #2: Wizard accepting invalid input choices (letters, wrong numbers)
  • #3: Repository path duplication in setup wizard
  • #4: Standalone script missing gamification and analytics commands
  • #5: No visual feedback for theme selection
  • #6: Incorrect repository counting in path detection

💡 For Developers

New Validation Framework

# Example of new validation pattern used throughout
while True:
    choice = input("Enter 1-5: ").strip()
    if choice in ["", "1", "2", "3", "4", "5"]:
        # Process valid choice
        break
    else:
        print("❌ Invalid choice. Please enter 1-5.")
        continue

Enhanced Path Detection

# Now uses sets and path resolution for deduplication
common_paths = set()
resolved_path = str(path.resolve())
common_paths.add(resolved_path)
return sorted(list(common_paths))

🎯 Next Steps

This release focuses purely on reliability and fixes. The next major release (v0.7.0) will include:

  • 🎨 Interactive TUI Mode: Rich, colorful terminal interface
  • 🔗 Git Hooks Integration: Smart pre-commit and post-commit automation
  • 🎵 Sound System: Audio notifications for achievements and level-ups
  • 🌐 Team Features: Shared leaderboards and team challenges

☕ Support Development

If this release fixed issues for you, consider supporting development:

Buy Me A Coffee

Full Changelog: v0.6.0...v0.6.1

Assets 2
Loading