crackerjack 0.32.0__tar.gz → 0.33.1__tar.gz

crackerjack-0.33.1/.gitignore

@@ -0,0 +1,73 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+.coverage*
+.pytest_cache/
+.hypothesis/
+
+# Development tools
+.mypy_cache/
+.ruff_cache/
+.autotyping-cache/
+
+# Build and distribution
+build/
+dist/
+*.egg-info/
+/__pypackages__/
+
+# Virtual environments
+.venv/
+venv/
+
+# IDE and OS
+.DS_STORE
+.idea/
+.envrc
+
+# UV/PDM package management
+.pdm-python
+.pdm.toml
+.pdm-build/
+
+# Project-specific generated files
+/coverage.json
+/htmlcov/
+/tests/htmlcov/
+/complexipy.json
+/test-results.xml
+crackerjack-debug-*.log
+crackerjack-ai-debug-*.log
+/hooks-analysis.json
+/quality-metrics.json
+/project-structure.json
+/error-context.json
+/ai-agent-summary.json
+/bandit-report.json
+
+# Crackerjack state and cache
+/.crackerjack/
+/.crackerjack-state
+/.crackerjack-hooks-updated
+/.crackerjack-mcp/
+/.benchmarks/
+/tests/.benchmarks/
+
+# Development artifacts (evaluate periodically)
+/feature-implementation-*.md
+/session_handoff_*.md
+/test-implementation-*.md
+
+# Temporary and scratch files
+/tmp/
+/scratch/
+/examples/
+
+# Configuration files (project-specific)
+.mcp.json
+/.mcp-proxy.json
+
+# Claude Code settings
+/.claude/
+**/.claude/settings.local.json

{crackerjack-0.32.0/crackerjack → crackerjack-0.33.1}/.pre-commit-config.yaml

@@ -7,6 +7,27 @@ repos:
         language: system
         files: \.py$
         exclude: ^\.venv/
+      - id: skylos
+        name: skylos-dead-code-detection
+        entry: skylos
+        language: system
+        args: ["crackerjack"]
+        pass_filenames: false
+        stages: ["pre-push", "manual"]
+      - id: zuban
+        name: zuban-type-checking
+        entry: uv run zuban check
+        language: system
+        args: ["--config-file", "mypy.ini", "./crackerjack"]
+        pass_filenames: false
+        stages: ["pre-push", "manual"]
+      - id: pyright
+        name: pyright-type-checking
+        entry: uv run pyright
+        language: system
+        files: ^crackerjack/.*\.py$
+        exclude: ^crackerjack/(mcp|plugins)/.*\.py$|crackerjack/code_cleaner\.py$
+        stages: ["pre-push", "manual"]
   - repo: https://github.com/pre-commit/pre-commit-hooks
     rev: v6.0.0
     hooks:
@@ -61,12 +82,6 @@ repos:
       - id: mdformat
         exclude: ^\.venv/
         additional_dependencies: ["mdformat-ruff"]
-  - repo: https://github.com/jendrikseipp/vulture
-    rev: v2.14
-    hooks:
-      - id: vulture
-        files: ^crackerjack/.*\.py$
-        stages: ["pre-push", "manual"]
   - repo: https://github.com/fredrikaverpil/creosote
     rev: v4.1.0
     hooks:
@@ -89,10 +104,3 @@ repos:
         files: ^crackerjack/.*\.py$
         exclude: ^tests/.*\.py$
         stages: ["pre-push", "manual"]
-  - repo: https://github.com/RobertCraigie/pyright-python
-    rev: v1.1.405
-    hooks:
-      - id: pyright
-        files: ^crackerjack/.*\.py$
-        exclude: ^crackerjack/(mcp|plugins)/.*\.py$|crackerjack/code_cleaner\.py$
-        stages: ["pre-push", "manual"]

{crackerjack-0.32.0 → crackerjack-0.33.1}/CHANGELOG.md

@@ -5,355 +5,22 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased] - 2025-09-06
+## [0.33.1] - 2025-09-14
 
 ### Added
 
-- feat: add new feature
+- Complete Phase 4 Advanced Features implementation
+- Complete Phase 4 enterprise features and fix hook system
+- Fix SQL syntax errors, refactor complexity violations, improve type annotations
 
-### Fixed
-
-- fix: resolve bug in parser
-
-## [Unreleased] - 2025-09-06
-
-### Added
-
-- feat: add new feature
-
-### Fixed
-
-- fix: resolve bug in parser
-
-## [Unreleased] - 2025-09-06
-
-### Added
-
-- feat: add new feature
-
-### Fixed
-
-- fix: resolve bug in parser
-
-## [Unreleased] - 2025-09-06
-
-### Added
-
-- feat: add new feature
-
-### Fixed
-
-- fix: resolve bug in parser
-
-## [Unreleased] - 2025-09-06
-
-### Added
-
-- feat: add new feature
-
-### Fixed
-
-- fix: resolve bug in parser
-
-## [Unreleased] - 2025-09-06
-
-### Added
-
-- feat: add new feature
-
-### Fixed
-
-- fix: resolve bug in parser
-
-## [Unreleased] - 2025-09-06
-
-### Added
-
-- feat: add new feature
-
-### Fixed
-
-- fix: resolve bug in parser
-
-## [Unreleased] - 2025-09-06
-
-### Added
-
-- feat: add new feature
-
-### Fixed
-
-- fix: resolve bug in parser
-
-## [Unreleased] - 2025-09-06
-
-### Added
-
-- feat: add new feature
-
-### Fixed
-
-- fix: resolve bug in parser
-
-## [Unreleased] - 2025-09-06
-
-### Added
-
-- feat: add new feature
-
-### Fixed
-
-- fix: resolve bug in parser
-
-## [Unreleased] - 2025-09-06
-
-### Added
-
-- feat: add new feature
-
-### Fixed
-
-- fix: resolve bug in parser
-
-## [Unreleased] - 2025-09-06
-
-### Added
-
-- feat: add new feature
-
-### Fixed
-
-- fix: resolve bug in parser
-
-## [Unreleased] - 2025-09-06
-
-### Added
-
-- feat: add new feature
-
-### Fixed
-
-- fix: resolve bug in parser
-
-## [Unreleased] - 2025-09-06
-
-### Added
-
-- feat: add new feature
-
-### Fixed
-
-- fix: resolve bug in parser
-
-## [Unreleased] - 2025-09-06
-
-### Added
-
-- feat: add new feature
-
-### Fixed
-
-- fix: resolve bug in parser
-
-## [Unreleased] - 2025-09-06
-
-### Added
-
-- feat: add new feature
-
-### Fixed
-
-- fix: resolve bug in parser
-
-## [Unreleased] - 2025-09-06
-
-### Added
-
-- feat: add new feature
-
-### Fixed
-
-- fix: resolve bug in parser
-
-## [Unreleased] - 2025-09-06
-
-### Added
-
-- feat: add new feature
-
-### Fixed
-
-- fix: resolve bug in parser
-
-## [Unreleased] - 2025-09-06
-
-### Added
-
-- feat: add new feature
-
-### Fixed
-
-- fix: resolve bug in parser
-
-## [Unreleased] - 2025-09-06
-
-### Added
-
-- feat: add new feature
-
-### Fixed
-
-- fix: resolve bug in parser
-
-## [Unreleased] - 2025-09-06
-
-### Added
-
-- feat: add new feature
-
-### Fixed
-
-- fix: resolve bug in parser
-
-## [Unreleased] - 2025-09-06
-
-### Added
-
-- feat: add new feature
-
-### Fixed
-
-- fix: resolve bug in parser
-
-## [Unreleased] - 2025-09-06
-
-### Added
-
-- feat: add new feature
-
-### Fixed
-
-- fix: resolve bug in parser
-
-## [Unreleased] - 2025-09-06
-
-### Added
-
-- feat: add new feature
-
-### Fixed
-
-- fix: resolve bug in parser
-
-## [Unreleased] - 2025-09-05
-
-### Added
-
-- feat: add new feature
-
-### Fixed
-
-- fix: resolve bug in parser
-
-## [Unreleased] - 2025-09-05
-
-### Added
-
-- feat: add new feature
-
-### Fixed
-
-- fix: resolve bug in parser
-
-## [Unreleased] - 2025-09-05
-
-### Added
-
-- feat: add new feature
-
-### Fixed
-
-- fix: resolve bug in parser
-
-## [Unreleased] - 2025-09-05
-
-### Added
-
-- feat: add new feature
-
-### Fixed
-
-- fix: resolve bug in parser
-
-## [Unreleased] - 2025-09-05
-
-### Added
-
-- feat: add new feature
-
-### Fixed
-
-- fix: resolve bug in parser
-
-## [Unreleased] - 2025-09-05
-
-### Added
-
-- feat: add new feature
-
-### Fixed
-
-- fix: resolve bug in parser
-
-## [Unreleased] - 2025-09-05
-
-### Added
-
-- feat: add new feature
-
-### Fixed
-
-- fix: resolve bug in parser
-
-## [Unreleased] - 2025-09-05
-
-### Added
-
-- feat: add new feature
-
-### Fixed
-
-- fix: resolve bug in parser
-
-## [Unreleased] - 2025-09-04
-
-### Added
-
-- feat: add new feature
-
-### Fixed
-
-- fix: resolve bug in parser
-
-## [Unreleased] - 2025-09-04
-
-### Added
-
-- feat: add new feature
-
-### Fixed
-
-- fix: resolve bug in parser
-
-## [Unreleased] - 2025-09-04
-
-### Added
-
-- feat: add new feature
-
-### Fixed
+### Changed
 
-- fix: resolve bug in parser
+- Crackerjack (quality: 80/100) - 2025-09-07 16:59:59
+- Crackerjack (quality: 80/100) - 2025-09-09 14:44:05
+- Crackerjack (quality: 80/100) - 2025-09-09 18:14:20
+- Fix complexity violations and regex validation
+- Post-release updates
+- Update configuration
 
 ## [0.31.9] - 2025-01-09
 

{crackerjack-0.32.0/crackerjack → crackerjack-0.33.1}/CLAUDE.md

@@ -12,7 +12,7 @@ Crackerjack is an opinionated Python project management tool unifying UV, Ruff,
 
 ## AI Documentation References
 
-- **[AI-REFERENCE.md](AI-REFERENCE.md)** - Command reference with decision trees
+- **[AI-REFERENCE.md](docs/ai/AI-REFERENCE.md)** - Command reference with decision trees
 - **[AGENT-CAPABILITIES.json](AGENT-CAPABILITIES.json)** - Structured agent data
 - **[ERROR-PATTERNS.yaml](ERROR-PATTERNS.yaml)** - Automated issue resolution patterns
 
@@ -20,21 +20,30 @@ Crackerjack is an opinionated Python project management tool unifying UV, Ruff,
 
 ```bash
 # Daily workflow
-python -m crackerjack                    # Quality checks
-python -m crackerjack -t                 # With tests
-python -m crackerjack --ai-agent -t      # AI auto-fixing (recommended)
+python -m crackerjack                       # Quality checks
+python -m crackerjack --run-tests            # With tests
+python -m crackerjack --ai-fix --run-tests   # AI auto-fixing (recommended)
 
 # Development
-python -m crackerjack --ai-debug -t      # Debug AI issues
-python -m crackerjack --skip-hooks       # Skip hooks during iteration
-python -m crackerjack -x                 # Code cleaning mode
+python -m crackerjack --ai-debug --run-tests # Debug AI issues
+python -m crackerjack --skip-hooks           # Skip hooks during iteration
+python -m crackerjack --strip-code           # Code cleaning mode
+
+# Monitoring & Performance
+python -m crackerjack --dashboard            # Comprehensive monitoring dashboard
+python -m crackerjack --unified-dashboard    # Unified real-time dashboard
+python -m crackerjack --monitor              # Multi-project progress monitor
+python -m crackerjack --benchmark            # Run in benchmark mode
+python -m crackerjack --cache-stats          # Display cache statistics
+python -m crackerjack --clear-cache          # Clear all caches
 
 # Server management
-python -m crackerjack --start-mcp-server    # MCP server
-python -m crackerjack --watchdog            # Monitor/restart services
+python -m crackerjack --start-mcp-server     # MCP server
+python -m crackerjack --restart-mcp-server   # Restart MCP server
+python -m crackerjack --watchdog             # Monitor/restart services
 
 # Release
-python -m crackerjack -a patch              # Full release workflow
+python -m crackerjack --full-release patch  # Full release workflow
 ```
 
 ## AI Agent System
@@ -51,7 +60,23 @@ python -m crackerjack -a patch              # Full release workflow
 - **ImportOptimizationAgent**: Import cleanup, reorganization
 - **TestSpecialistAgent** (0.8): Advanced testing scenarios
 
-**Usage**: `--ai-agent` enables batch fixing; confidence ≥0.7 uses specific agents
+**Usage**: `--ai-fix` enables batch fixing; confidence ≥0.7 uses specific agents
+
+## High-Performance Rust Integration
+
+**Ultra-Fast Static Analysis** with seamless Python integration:
+
+- **🦅 Skylos**: Dead code detection **20x faster** than vulture
+- **🔍 Zuban**: Type checking **20-200x faster** than pyright
+- **🚀 Performance**: 6,000+ operations/second throughput
+- **🔄 Compatibility**: Zero breaking changes, drop-in replacements
+
+**Benefits in Daily Workflow**:
+
+- Pre-commit hooks complete in seconds instead of minutes
+- `--run-tests` now blazingly fast with Rust-powered type checking
+- AI agents get faster feedback for more efficient fixing cycles
+- Development iteration speed dramatically improved
 
 ## Architecture
 
@@ -84,7 +109,7 @@ python -m pytest tests/test_file.py::TestClass::test_method -v
 python -m pytest --cov=crackerjack --cov-report=html
 
 # Custom workers
-python -m crackerjack -t --test-workers 4
+python -m crackerjack --run-tests --test-workers 4
 
 # Version bump
 python -m crackerjack --bump patch
@@ -139,7 +164,7 @@ text = SAFE_PATTERNS["fix_hyphenated_names"].apply(text)
 
 **Development**:
 
-- **AI agent ineffective**: Use `--ai-debug -t` for analysis
+- **AI agent ineffective**: Use `--ai-debug --run-tests` for analysis
 - **Import errors**: Always import protocols from `models/protocols.py`
 - **Test hangs**: Avoid complex async tests, use simple synchronous config tests
 - **Coverage failing**: Never reduce below baseline, add tests incrementally
@@ -167,6 +192,73 @@ python -m crackerjack.mcp.progress_monitor <job_id>
 
 **Slash Commands**: `/crackerjack:run`, `/crackerjack:status`, `/crackerjack:init`
 
+## Session Management Integration
+
+**Automatic Lifecycle**: Crackerjack projects (git repositories) get automatic session management via session-mgmt-mcp:
+
+- **Session Start**: Automatically initialized when Claude Code connects
+- **Mid-Session**: `/session-mgmt:checkpoint` performs quality checks with intelligent auto-compaction
+- **Session End**: Automatically executed on `/quit`, disconnect, or crash with graceful cleanup
+
+**Enhanced Workflow Integration**:
+
+```bash
+# Standard crackerjack workflow with automatic session management
+python -m crackerjack --ai-fix --run-tests  # Quality + AI fixing
+# Session checkpoints happen automatically during long runs
+# Session cleanup happens automatically when you quit Claude Code
+```
+
+**Key Features**:
+
+- **Crash Resilience**: Session data preserved through network/system failures
+- **Memory Management**: Auto-compaction during checkpoints when context is heavy
+- **Progress Continuity**: Next session resumes with accumulated learning from previous work
+- **Zero Manual Intervention**: All session lifecycle managed automatically for git repos
+
+**Manual Override**: Use `/session-mgmt:init`, `/session-mgmt:checkpoint`, `/session-mgmt:end` if needed for fine control
+
+**Integration Benefits**:
+
+- Crackerjack quality metrics tracked over time
+- Test patterns and failure resolutions remembered
+- Error fix strategies learned and suggested
+- Command effectiveness optimized based on history
+
+## Experimental Features
+
+**Framework for Future Innovations**: Crackerjack includes a comprehensive experimental features framework designed to safely evaluate and integrate next-generation tools.
+
+### Experimental Hook Framework
+
+The experimental hook system provides a structured pathway for evaluating new tools before promoting them to stable status:
+
+```bash
+# Framework supports experimental evaluation
+python -m crackerjack --experimental-hooks  # (when experimental hooks are available)
+```
+
+**Evaluation Criteria**:
+
+1. **Availability**: Tool consistently available across environments
+1. **Stability**: No crashes or inconsistent results across runs
+1. **Value Added**: Catches issues not found by existing tools
+1. **Performance**: Stays within time budgets
+1. **Integration**: Works reliably with pre-commit workflow
+
+**Promotion Lifecycle**:
+
+1. **Experimental Phase**: Limited to `manual` stage only
+1. **Evaluation Period**: 30-90 day assessment with metrics
+1. **Promotion Decision**: Move to appropriate tier if criteria met
+1. **Removal**: Clean removal if criteria not met
+
+**Current Status**:
+
+- **No Active Experimental Hooks**: Previous experimental candidates (pyrefly, ty) failed availability testing and were removed
+- **Framework Ready**: System prepared for future experimental tool evaluation
+- **Documentation**: Complete evaluation criteria in [EXPERIMENTAL-EVALUATION.md](EXPERIMENTAL-EVALUATION.md)
+
 ## Critical Reminders
 
 **Core Instructions**:
@@ -205,3 +297,7 @@ from ..models.protocols import TestManagerProtocol
 ```
 
 **Current Status**: 10.11% coverage baseline targeting 100% (ratchet system: 2% tolerance, never reduce)
+
+- make sure to run `python -m crackerjack` after every editing/debugging cycle for quality checking
+- always put implementation plans in a md doc for review and reference
+- think when you need to think, think harder when you need to think harder