Major Update to PureCode v0.2.0

[harkaranbrar7]

Summary

This PR introduces a major update to PureCode, evolving it from a simple git diff analyzer to a comprehensive code analysis tool with support for both diff and snapshot modes, configuration files, and enhanced CI integration.

Key Changes

🚀 New Features

• Snapshot Mode: Added purecode files command to analyze entire directories/files instead of just diffs
• Configuration Support: Introduced .purecode.toml for default settings (base branch, format, thresholds, etc.)
• Subcommand Structure: Refactored CLI with diff and files subcommands for better organization
• Complexity Scoring: Added review complexity calculation based on churn and code type
• Token Estimation: Improved token counting for added code
• Per-File Reporting: Option to show detailed statistics per file
• CI Mode: Machine-readable output with summary lines for automated processing

🔧 Improvements

• Enhanced Classifiers: Improved HTML/Vue comment handling and C-style block comment logic
• Better Error Handling: More robust parsing with warnings for context lines and binary files
• Language Detection: Centralized language detection using a proper enum
• Output Formats: Redesigned human-readable reports with colors, plain text, and structured JSON
• Threshold Checks: More flexible threshold validation with detailed error messages

🛠️ Technical Changes

• Dependencies: Added serde, serde_json, toml, walkdir, glob for configuration and file handling
• Code Structure: Split functionality into dedicated modules (config.rs, files.rs, language.rs)
• Data Models: Introduced FileStats, AnalysisResult, and ThresholdError for better type safety
• GitHub Actions:
  • Improved auto-release workflow to skip existing releases and use generated notes
  • Added code formatting and linting checks in CI

📚 Documentation

• README Overhaul: Complete rewrite with architecture overview, installation guides, and comprehensive usage examples
• Configuration Guide: Detailed .purecode.toml configuration options
• Integration Examples: Updated pre-commit hooks and GitHub Actions workflows

Breaking Changes

• CLI Interface: Root command now defaults to diff mode; use subcommands for explicit modes
• Configuration: Some flags now have defaults from config file; CLI flags still override
• Output Format: Human-readable output redesigned with new layout and metrics

Migration Guide

• Existing scripts using purecode directly will continue to work (diff mode)
• For new snapshot functionality, use purecode files
• Add .purecode.toml to your repo root for project-specific defaults
• Update CI scripts to use --ci flag for machine-readable output

Testing

• All existing tests pass
• Added tests for new classifiers and parsing logic
• Manual testing of diff and files modes with various file types

This update significantly expands PureCode's capabilities while maintaining backward compatibility for core diff analysis functionality. The tool is now ready for broader use cases including codebase audits, CI/CD pipelines, and team workflow integration.