Skip to content

commit-checker v0.6.0

Choose a tag to compare

View all tags
@AmariahAK AmariahAK released this 28 Jul 09:39
· 40 commits to main since this release
v0.6.0
cc0638b

🎮 commit-checker v0.6.0 - "Offline Gamified Power Mode"

The biggest update yet! Transform your development workflow with gamification, advanced analytics, and an enhanced learning system - all completely offline.

🚀 Major New Features

🎮 Complete Gamification System

Turn coding into a game with our comprehensive achievement and progression system:

🏆 Achievement System

  • 6 Achievement Types with hand-crafted ASCII art
  • 5 Rarity Levels: 🟩 Common → 🟦 Rare → 🟨 Epic → 🟥 Legendary → 🟪 Mythic
  • Streak-Based Badges: 3-day, 7-day, 14-day, 30-day, 90-day, 365-day streaks
  • Milestone Achievements: First commit, 100 commits, 1000 commits, big diffs
  • Visual Gallery: commit-checker --achievements

⚡ XP & Level System

  • 10 Progressive Levels: Novice Coder → Programming Deity
  • Smart XP Calculation: Based on lines changed, deletions, and project weight
  • Configurable Weights: Set different XP multipliers per project
  • Visual Progress Bars: See your advancement with Unicode blocks
  • Level Titles: Earn prestigious titles as you advance
  • Status Command: commit-checker --xp

🔥 Automatic Streak Tracking

  • Daily Commit Streaks tracked across all repositories
  • Achievement Integration unlocks badges at milestone streaks
  • Smart Detection works across multiple development folders

📊 Advanced Analytics & Visualizations

📅 ASCII Commit Heatmap

commit-checker --heatmap           # 365-day activity view
commit-checker --heatmap --days 90 # Custom timeframe
commit-checker --heatmap --export svg # Export to file
  • GitHub-style visualization with Unicode intensity blocks
  • Customizable timeframes (30, 90, 180, 365 days)
  • SVG export for sharing and documentation
  • Activity insights with weekly summaries

💻 Programming Language Analytics

commit-checker --stats-lang
  • Comprehensive language detection (40+ languages supported)
  • Visual breakdown with Unicode bar charts
  • File and line counts across entire codebase
  • Project insights showing language distribution

😄 Dynamic Mood System
Smart status messages that adapt to your coding activity:

  • 🔥 "You're in the zone!" (high activity)
  • 💪 "Great work!" (good progress)
  • 🌱 "Every commit counts" (steady progress)
  • 💤 "Time to code?" (inactive)

📚 Enhanced TIL (Today I Learned) Vault

📝 Template System

commit-checker --list-templates                    # Show available templates
commit-checker til "Fixed async bug" --template bugfix  # Use template
  • 5 Built-in Templates: bugfix, feature, concept, tool, algorithm
  • Markdown-based with variable substitution
  • Custom template support - create your own learning formats
  • Professional structure for consistent documentation

🔍 Advanced Search & Organization

commit-checker --search-til "async"        # Fuzzy search
commit-checker --til-vault                 # Vault summary
commit-checker --view-til --filter-tag python  # Filter by tags
  • Fuzzy search with highlighted matches and scoring
  • Tag-based organization with automatic extraction
  • Individual markdown files (no more single log file)
  • Export capabilities to Markdown and JSON formats

🤖 Automated Learning Insights

commit-checker --til-from-diff             # Generate from latest commit
  • Git diff analysis extracts functions, files, and statistics
  • No AI required - pure git log parsing
  • Learning prompts help you reflect on changes
  • Code context shows what actually changed

⚡ Performance & Architecture

🔧 Offline-First Design

  • Zero external dependencies - works completely offline
  • No API calls required for core functionality
  • Local data storage in ~/.commit-checker/
  • Git-powered analytics using local repository data
  • Instant startup with optimized module loading

🏗️ Modular Architecture

  • 4 new specialized modules: gamification.py, analytics.py, til_vault.py
  • Clean separation of concerns for maintainability
  • Plugin-ready foundation for future extensions
  • Theme system groundwork with JSON configuration
  • Sound system framework for audio notifications

📈 Enhanced Performance

  • Intelligent caching prevents redundant git operations
  • Background processing for non-blocking updates
  • Lazy loading of optional dependencies
  • Memory optimization for large repositories
  • Cross-platform compatibility (macOS, Linux, Windows)

🛠️ Developer Experience

🔧 15+ New CLI Commands

# Gamification
--achievements          # Display achievement gallery
--xp                   # Show XP and level status

# Analytics  
--heatmap              # ASCII commit heatmap
--heatmap-days N       # Custom timeframe
--heatmap-export svg   # Export visualization
--stats-lang           # Language breakdown

# Enhanced TIL
--search-til "query"   # Fuzzy search entries
--til-vault            # Vault summary
--til-from-diff        # Auto-generate from commits
--template NAME        # Use template
--list-templates       # Show available templates

# Export & Organization
--export md|json       # Export TIL data
--filter-tag TAG       # Filter by tag

🎣 Developer-Friendly Git Hooks

  • Non-blocking design - never prevents commits
  • Optional TIL prompts with smart timeout (10 seconds)
  • Background XP updates via post-commit hook
  • Easy opt-out with environment variables
  • CI/CD friendly - automatically skips in automated environments
  • Team-safe - works with or without commit-checker installed

📋 Enhanced Configuration

  • XP weight customization per project
  • Multiple development folders support
  • Theme system foundation for visual customization
  • Backwards compatibility with existing configs
  • Auto-migration of old settings

🐛 Bug Fixes & Improvements

✅ Critical Fixes

  • Fixed argument parsing for multi-word TIL entries
  • Resolved import conflicts in standalone mode
  • Corrected SVG export path handling
  • Fixed dependency issues with Python 3.13
  • Improved error handling for missing git repositories

🔧 Stability Improvements

  • Graceful fallbacks when optional dependencies unavailable
  • Better error messages with actionable guidance
  • Robust git parsing handles edge cases and malformed logs
  • Memory leak prevention in long-running operations
  • Cross-platform path handling for Windows compatibility

📦 Dependency Management

  • Updated requirements: Added textual and plotext
  • Removed problematic pydub dependency (deferred to future release)
  • Improved bootstrap with better fallback strategies
  • PEP 668 compliance for externally managed environments

📖 Documentation & Support

📚 Comprehensive Documentation

  • roadmap.md: Detailed roadmap through v1.0.0
  • DEVELOPMENT.md: Complete developer setup guide
  • Updated README: Comprehensive feature showcase
  • Example files: Templates, themes, plugins for customization

💰 Updated Support

🧪 Testing & Quality Assurance

✅ Thoroughly Tested

  • All 15+ new commands verified working
  • Gamification system tested with real commits
  • Analytics accuracy validated against git logs
  • Cross-platform compatibility verified
  • Git hook safety tested in team environments

🔧 Quality Metrics

  • 2,000+ lines of new, tested code
  • Zero breaking changes to existing functionality
  • Backwards compatible configuration
  • Graceful degradation when features unavailable

🎯 Getting Started

Quick Install

# Standalone (recommended)
curl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/scripts/install-safe.sh | bash

# Traditional pip
pip install commit-checker

Try the New Features

# Check your current status
commit-checker

# View your achievements
commit-checker --achievements

# See your coding heatmap
commit-checker --heatmap

# Add a learning entry
commit-checker til "Learned about async/await" --template concept

# Explore your TIL vault
commit-checker --til-vault

🔮 What's Next

v0.6.0 sets the foundation for exciting future features:

  • 🧠 v0.7.0: AI-powered insights with Ollama integration
  • 🧪 v0.8.0: VS Code extension and team collaboration
  • 🚀 v0.9.0: Enterprise features and advanced analytics
  • 🎯 v1.0.0: The ultimate developer productivity suite

💖 Community

Love commit-checker? Support continued development:

  • ⭐ Star the repository
  • ☕ Buy me a coffee
  • 🐛 Report bugs and suggest features
  • 🤝 Contribute to the codebase

Built by Amariah Kamau with ❤️ for developers worldwide.

Assets 2
Loading