crackerjack 0.24.10__py3-none-any.whl → 0.26.0__py3-none-any.whl

crackerjack/.pre-commit-config-ai.yaml

@@ -66,6 +66,13 @@ repos:
       - id: ruff-format
         verbose: true
 
+  - repo: https://github.com/executablebooks/mdformat
+    rev: 0.7.18
+    hooks:
+      - id: mdformat
+        additional_dependencies:
+          - mdformat-ruff
+
   # Code quality tier 2 - analysis
   - repo: https://github.com/jendrikseipp/vulture
     rev: 'v2.14'

crackerjack/.pre-commit-config.yaml

@@ -22,7 +22,7 @@ repos:
 
   # Package management - once structure is valid
   - repo: https://github.com/astral-sh/uv-pre-commit
-    rev: 0.7.20
+    rev: 0.7.21
     hooks:
       - id: uv-lock
         files: ^pyproject\.toml$
@@ -48,6 +48,13 @@ repos:
       - id: ruff-check
       - id: ruff-format
 
+  - repo: https://github.com/executablebooks/mdformat
+    rev: 0.7.22
+    hooks:
+      - id: mdformat
+        additional_dependencies:
+          - mdformat-ruff
+
   # Code quality tier 2 - analysis
   - repo: https://github.com/jendrikseipp/vulture
     rev: 'v2.14'

crackerjack/crackerjack.py

@@ -634,7 +634,7 @@ class CodeCleaner(BaseModel, arbitrary_types_allowed=True):
                 temp_path.write_text(code)
             try:
                 result = subprocess.run(
-                    ["ruff", "format", str(temp_path)],
+                    ["uv", "run", "ruff", "format", str(temp_path)],
                     check=False,
                     capture_output=True,
                     text=True,
@@ -887,7 +887,7 @@ class ProjectManager(BaseModel, arbitrary_types_allowed=True):
             self.execute_command(["git", "branch", "-m", "main"])
             self.execute_command(["git", "add", "pyproject.toml", "uv.lock"])
             self.execute_command(["git", "config", "advice.addIgnoredFile", "false"])
-            install_cmd = ["pre-commit", "install"]
+            install_cmd = ["uv", "run", "pre-commit", "install"]
             if hasattr(self, "options") and getattr(self.options, "ai_agent", False):
                 install_cmd.extend(["-c", ".pre-commit-config-ai.yaml"])
             self.execute_command(install_cmd)
@@ -899,7 +899,7 @@ class ProjectManager(BaseModel, arbitrary_types_allowed=True):
             "[bold bright_cyan]🔍 HOOKS[/bold bright_cyan] [bold bright_white]Running code quality checks[/bold bright_white]"
         )
         self.console.print("-" * 60 + "\n")
-        cmd = ["pre-commit", "run", "--all-files"]
+        cmd = ["uv", "run", "pre-commit", "run", "--all-files"]
         if hasattr(self, "options") and getattr(self.options, "ai_agent", False):
             cmd.extend(["-c", ".pre-commit-config-ai.yaml"])
         check_all = self.execute_command(cmd)
@@ -990,7 +990,7 @@ class Crackerjack(BaseModel, arbitrary_types_allowed=True):
 
     def _update_precommit(self, options: t.Any) -> None:
         if self.pkg_path.stem == "crackerjack" and options.update_precommit:
-            update_cmd = ["pre-commit", "autoupdate"]
+            update_cmd = ["uv", "run", "pre-commit", "autoupdate"]
             if options.ai_agent:
                 update_cmd.extend(["-c", ".pre-commit-config-ai.yaml"])
             self.execute_command(update_cmd)
@@ -1076,7 +1076,7 @@ class Crackerjack(BaseModel, arbitrary_types_allowed=True):
             test.append("-xvs")
 
     def _prepare_pytest_command(self, options: OptionsProtocol) -> list[str]:
-        test = ["pytest"]
+        test = ["uv", "run", "pytest"]
         project_size = self._detect_project_size()
         test_timeout = self._get_test_timeout(options, project_size)
         if getattr(options, "ai_agent", False):

crackerjack/pyproject.toml

@@ -4,7 +4,7 @@ requires = [ "hatchling" ]
 
 [project]
 name = "crackerjack"
-version = "0.24.9"
+version = "0.25.0"
 description = "Crackerjack: code quality toolkit"
 readme = "README.md"
 keywords = [
@@ -46,6 +46,7 @@ dependencies = [
     "keyring>=25.6",
     "pre-commit>=4.2",
     "pydantic>=2.11.7",
+    "pyleak>=0.1.14",
     "pytest>=8.4.1",
     "pytest-asyncio>=1",
     "pytest-benchmark>=5.1",
@@ -128,6 +129,7 @@ markers = [
     "unit: marks test as a unit test",
     "benchmark: mark test as a benchmark (disables parallel execution)",
     "integration: marks test as an integration test",
+    "no_leaks: detect asyncio task leaks, thread leaks, and event loop blocking",
 ]
 
 # Default timeout settings
@@ -237,6 +239,7 @@ exclude-deps = [
     "keyring",
     "inflection",
     "pydantic-settings",
+    "pyleak",
 ]
 
 [tool.refurb]

{crackerjack-0.24.10.dist-info → crackerjack-0.26.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crackerjack
-Version: 0.24.10
+Version: 0.26.0
 Summary: Crackerjack: code quality toolkit
 Project-URL: documentation, https://github.com/lesleslie/crackerjack
 Project-URL: homepage, https://github.com/lesleslie/crackerjack
@@ -28,6 +28,7 @@ Requires-Dist: hatchling>=1.25
 Requires-Dist: keyring>=25.6
 Requires-Dist: pre-commit>=4.2
 Requires-Dist: pydantic>=2.11.7
+Requires-Dist: pyleak>=0.1.14
 Requires-Dist: pytest-asyncio>=1
 Requires-Dist: pytest-benchmark>=5.1
 Requires-Dist: pytest-cov>=6.2.1
@@ -63,68 +64,80 @@ Crackerjack is an opinionated Python project management tool that streamlines th
 Crackerjack solves three critical challenges in Python development:
 
 1. **Project Setup & Configuration**
+
    - **Challenge**: Setting up Python projects with best practices requires knowledge of numerous tools and configurations
    - **Solution**: Crackerjack automates project initialization with pre-configured templates and industry best practices
 
-2. **Code Quality & Consistency**
+1. **Code Quality & Consistency**
+
    - **Challenge**: Maintaining consistent code quality across a project and team requires constant vigilance
    - **Solution**: Crackerjack enforces a unified style through integrated linting, formatting, and pre-commit hooks
 
-3. **Streamlined Publishing**
+1. **Streamlined Publishing**
+
    - **Challenge**: Publishing Python packages involves many manual, error-prone steps
    - **Solution**: Crackerjack automates the entire release process from testing to version bumping to publishing
 
 Crackerjack integrates powerful tools like Ruff, UV, pre-commit, pytest, and more into a cohesive system that ensures code quality, consistency, and reliability. It's designed for developers who value both productivity and excellence.
 
----
+______________________________________________________________________
 
 ## Getting Started
 
 ### Quick Start
 
 If you're new to Crackerjack, follow these steps:
+
 1. **Install Python 3.13:** Ensure you have Python 3.13 or higher installed.
-2. **Install UV:**
-    ```
-    pipx install uv
-    ```
-3. **Install Crackerjack:**
-    ```
-    pip install crackerjack
-    ```
-
-4. **Initialize a New Project:**
-    Navigate to your project's root directory and run:
-    ```
-    python -m crackerjack
-    ```
-
-    Or use the interactive Rich UI:
-    ```
-    python -m crackerjack -i
-    ```
-
----
+
+1. **Install UV:**
+
+   ```
+   pipx install uv
+   ```
+
+1. **Install Crackerjack:**
+
+   ```
+   pip install crackerjack
+   ```
+
+1. **Initialize a New Project:**
+   Navigate to your project's root directory and run:
+
+   ```
+   python -m crackerjack
+   ```
+
+   Or use the interactive Rich UI:
+
+   ```
+   python -m crackerjack -i
+   ```
+
+______________________________________________________________________
 
 ## The Crackerjack Philosophy
 
 Crackerjack is built on the following core principles:
 
--   **Code Clarity:** Code should be easy to read, understand, and maintain.
--   **Automation:** Tedious tasks should be automated, allowing developers to focus on solving problems.
--   **Consistency:** Code style, formatting, and project structure should be consistent across projects.
--   **Reliability:** Tests are essential, and code should be checked rigorously.
--   **Tool Integration:** Leverage powerful existing tools instead of reinventing the wheel.
--   **Static Typing:** Static typing is essential for all development.
+- **Code Clarity:** Code should be easy to read, understand, and maintain.
+- **Automation:** Tedious tasks should be automated, allowing developers to focus on solving problems.
+- **Consistency:** Code style, formatting, and project structure should be consistent across projects.
+- **Reliability:** Tests are essential, and code should be checked rigorously.
+- **Tool Integration:** Leverage powerful existing tools instead of reinventing the wheel.
+- **Static Typing:** Static typing is essential for all development.
 
 ## Key Features
 
 ### Project Management
+
 - **Effortless Project Setup:** Initializes new Python projects with a standard directory structure, `pyproject.toml`, and essential configuration files
 - **UV Integration:** Manages dependencies and virtual environments using [UV](https://github.com/astral-sh/uv) for lightning-fast package operations
 - **Dependency Management:** Automatically detects and manages project dependencies
 
 ### Code Quality
+
 - **Automated Code Cleaning:** Removes unnecessary docstrings, line comments, and trailing whitespace
 - **Consistent Code Formatting:** Enforces a unified style using [Ruff](https://github.com/astral-sh/ruff), the lightning-fast Python linter and formatter
 - **Comprehensive Pre-commit Hooks:** Installs and manages a robust suite of pre-commit hooks (see the "Pre-commit Hooks" section below)
@@ -132,16 +145,19 @@ Crackerjack is built on the following core principles:
 - **Static Type Checking:** Enforces type safety with Pyright integration
 
 ### Testing & Deployment
+
 - **Built-in Testing:** Automatically runs tests using `pytest`
 - **Easy Version Bumping:** Provides commands to bump the project version (patch, minor, or major)
 - **Simplified Publishing:** Automates publishing to PyPI via UV
 
 ### Git Integration
+
 - **Commit and Push:** Commits and pushes your changes with standardized commit messages
 - **Pull Request Creation:** Creates pull requests to upstream repositories on GitHub or GitLab
 - **Pre-commit Integration:** Ensures code quality before commits
 
 ### Developer Experience
+
 - **Command-Line Interface:** Simple, intuitive CLI with comprehensive options
 - **Interactive Rich UI:** Visual workflow with real-time task tracking, progress visualization, and interactive prompts
 - **Structured Error Handling:** Clear error messages with error codes, detailed explanations, and recovery suggestions
@@ -154,37 +170,37 @@ Crackerjack is built on the following core principles:
 
 Crackerjack automatically installs and manages these pre-commit hooks:
 
-1.  **uv-lock:** Ensures the `uv.lock` file is up to date.
-2.  **Core pre-commit-hooks:** Essential hooks from [pre-commit-hooks](https://github.com/pre-commit/pre-commit-hooks) (e.g., `trailing-whitespace`, `end-of-file-fixer`).
-3.  **Ruff:** [Ruff](https://github.com/astral-sh/ruff) for linting, code formatting, and general code style enforcement.
-4.  **Vulture:** [Vulture](https://github.com/jendrikseipp/vulture) to identify dead code.
-5.  **Creosote:** [Creosote](https://github.com/fredrikaverpil/creosote) to detect unused dependencies.
-6.  **Complexipy:** [Complexipy](https://github.com/rohaquinlop/complexipy-pre-commit) for analyzing code complexity.
-7.  **Codespell:** [Codespell](https://github.com/codespell-project/codespell) for correcting typos in the code.
-8.  **Autotyping:** [Autotyping](https://github.com/JelleZijlstra/autotyping) for adding type hints.
-9.  **Refurb:** [Refurb](https://github.com/dosisod/refurb) to suggest code improvements.
-10. **Bandit:** [Bandit](https://github.com/PyCQA/bandit) to identify potential security vulnerabilities.
-11. **Pyright:** [Pyright](https://github.com/RobertCraigie/pyright-python) for static type checking.
-12. **Ruff (again):** A final Ruff pass to ensure all changes comply with the enforced style.
+1. **uv-lock:** Ensures the `uv.lock` file is up to date.
+1. **Core pre-commit-hooks:** Essential hooks from [pre-commit-hooks](https://github.com/pre-commit/pre-commit-hooks) (e.g., `trailing-whitespace`, `end-of-file-fixer`).
+1. **Ruff:** [Ruff](https://github.com/astral-sh/ruff) for linting, code formatting, and general code style enforcement.
+1. **Vulture:** [Vulture](https://github.com/jendrikseipp/vulture) to identify dead code.
+1. **Creosote:** [Creosote](https://github.com/fredrikaverpil/creosote) to detect unused dependencies.
+1. **Complexipy:** [Complexipy](https://github.com/rohaquinlop/complexipy-pre-commit) for analyzing code complexity.
+1. **Codespell:** [Codespell](https://github.com/codespell-project/codespell) for correcting typos in the code.
+1. **Autotyping:** [Autotyping](https://github.com/JelleZijlstra/autotyping) for adding type hints.
+1. **Refurb:** [Refurb](https://github.com/dosisod/refurb) to suggest code improvements.
+1. **Bandit:** [Bandit](https://github.com/PyCQA/bandit) to identify potential security vulnerabilities.
+1. **Pyright:** [Pyright](https://github.com/RobertCraigie/pyright-python) for static type checking.
+1. **Ruff (again):** A final Ruff pass to ensure all changes comply with the enforced style.
 
 ## The Crackerjack Style Guide
 
 Crackerjack projects adhere to these guidelines:
 
--   **Static Typing:** Use type hints consistently throughout your code.
--   **Modern Type Hints:** Use the pipe operator (`|`) for union types (e.g., `Path | None` instead of `Optional[Path]`).
--   **Explicit Naming:** Choose clear, descriptive names for classes, functions, variables, and other identifiers.
--   **Markdown for Documentation:** Use Markdown (`.md`) for all documentation, READMEs, etc.
--   **Pathlib:** Use `pathlib.Path` for handling file and directory paths instead of `os.path`.
--   **Consistent Imports:** Use `import typing as t` for type hinting and prefix all typing references with `t.`.
--   **Protocol-Based Design:** Use `t.Protocol` for interface definitions instead of abstract base classes.
--   **Constants and Config:** Do not use all-caps for constants or configuration settings.
--   **Path Parameters:** Functions that handle file operations should accept `pathlib.Path` objects as parameters.
--   **Dependency Management:** Use UV for dependency management, package building, and publishing.
--   **Testing:** Use pytest as your testing framework.
--   **Python Version:** Crackerjack projects target Python 3.13+ and use the latest language features.
--   **Clear Code:** Avoid overly complex code.
--   **Modular:** Functions should do one thing well.
+- **Static Typing:** Use type hints consistently throughout your code.
+- **Modern Type Hints:** Use the pipe operator (`|`) for union types (e.g., `Path | None` instead of `Optional[Path]`).
+- **Explicit Naming:** Choose clear, descriptive names for classes, functions, variables, and other identifiers.
+- **Markdown for Documentation:** Use Markdown (`.md`) for all documentation, READMEs, etc.
+- **Pathlib:** Use `pathlib.Path` for handling file and directory paths instead of `os.path`.
+- **Consistent Imports:** Use `import typing as t` for type hinting and prefix all typing references with `t.`.
+- **Protocol-Based Design:** Use `t.Protocol` for interface definitions instead of abstract base classes.
+- **Constants and Config:** Do not use all-caps for constants or configuration settings.
+- **Path Parameters:** Functions that handle file operations should accept `pathlib.Path` objects as parameters.
+- **Dependency Management:** Use UV for dependency management, package building, and publishing.
+- **Testing:** Use pytest as your testing framework.
+- **Python Version:** Crackerjack projects target Python 3.13+ and use the latest language features.
+- **Clear Code:** Avoid overly complex code.
+- **Modular:** Functions should do one thing well.
 
 ## Testing Features
 
@@ -208,6 +224,7 @@ Crackerjack offers fine-grained control over test execution:
 - **Progress Tracking:** Shows periodic heartbeat messages for long-running tests
 
 Example test execution options:
+
 ```bash
 # Run tests with a single worker (no parallelization)
 python -m crackerjack -t --test-workers=1
@@ -233,12 +250,14 @@ Crackerjack includes benchmark testing capabilities:
 - **CI Integration:** Track performance across commits with benchmark history
 
 When benchmarks are run, Crackerjack:
+
 1. Disables parallel test execution (as pytest-benchmark is incompatible with pytest-xdist)
-2. Configures the pytest-benchmark plugin with optimized settings
-3. Compares benchmark results against previous runs when regression testing is enabled
-4. Fails tests if performance decreases beyond the specified threshold
+1. Configures the pytest-benchmark plugin with optimized settings
+1. Compares benchmark results against previous runs when regression testing is enabled
+1. Fails tests if performance decreases beyond the specified threshold
 
 Example benchmark usage:
+
 ```bash
 # Run benchmarks
 python -m crackerjack -t --benchmark
@@ -252,24 +271,27 @@ python -m crackerjack -t --benchmark-regression --benchmark-regression-threshold
 
 ## Installation
 
-1.  **Python:** Ensure you have Python 3.13 or higher installed.
-2.  **UV:** Install [UV](https://github.com/astral-sh/uv) using `pipx`:
+1. **Python:** Ensure you have Python 3.13 or higher installed.
+
+1. **UV:** Install [UV](https://github.com/astral-sh/uv) using `pipx`:
 
-    ```
-    pipx install uv
-    ```
+   ```
+   pipx install uv
+   ```
 
-3.  **Crackerjack:** Install Crackerjack and initialize in your project root using:
-    ```
-    pip install crackerjack
-    cd your_project_root
-    python -m crackerjack
-    ```
+1. **Crackerjack:** Install Crackerjack and initialize in your project root using:
 
-    Or with the interactive Rich UI:
-    ```
-    python -m crackerjack -i
-    ```
+   ```
+   pip install crackerjack
+   cd your_project_root
+   python -m crackerjack
+   ```
+
+   Or with the interactive Rich UI:
+
+   ```
+   python -m crackerjack -i
+   ```
 
 ## Usage
 
@@ -277,7 +299,9 @@ python -m crackerjack -t --benchmark-regression --benchmark-regression-threshold
 
 Run Crackerjack from the root of your Python project using:
 
-    python -m crackerjack
+```
+python -m crackerjack
+```
 
 ### Programmatic API
 
@@ -289,89 +313,96 @@ from pathlib import Path
 from rich.console import Console
 from crackerjack import create_crackerjack_runner
 
+
 # Create a custom options object
 class MyOptions:
     def __init__(self):
         # Core options
-        self.commit = False          # Commit changes to Git
-        self.interactive = True      # Run pre-commit hooks interactively
-        self.verbose = True          # Enable verbose output
+        self.commit = False  # Commit changes to Git
+        self.interactive = True  # Run pre-commit hooks interactively
+        self.verbose = True  # Enable verbose output
 
         # Configuration options
         self.no_config_updates = False  # Skip updating config files
-        self.update_precommit = False   # Update pre-commit hooks
+        self.update_precommit = False  # Update pre-commit hooks
 
         # Process options
-        self.clean = True            # Clean code (remove docstrings, comments, etc.)
-        self.test = True             # Run tests using pytest
-        self.skip_hooks = False      # Skip running pre-commit hooks
+        self.clean = True  # Clean code (remove docstrings, comments, etc.)
+        self.test = True  # Run tests using pytest
+        self.skip_hooks = False  # Skip running pre-commit hooks
 
         # Test execution options
-        self.test_workers = 2        # Number of parallel workers (0 = auto-detect, 1 = disable parallelization)
-        self.test_timeout = 120      # Timeout in seconds for individual tests (0 = use default based on project size)
+        self.test_workers = 2  # Number of parallel workers (0 = auto-detect, 1 = disable parallelization)
+        self.test_timeout = 120  # Timeout in seconds for individual tests (0 = use default based on project size)
 
         # Benchmark options
-        self.benchmark = False       # Run tests in benchmark mode
-        self.benchmark_regression = False  # Fail tests if benchmarks regress beyond threshold
-        self.benchmark_regression_threshold = 5.0  # Threshold percentage for benchmark regression
+        self.benchmark = False  # Run tests in benchmark mode
+        self.benchmark_regression = (
+            False  # Fail tests if benchmarks regress beyond threshold
+        )
+        self.benchmark_regression_threshold = (
+            5.0  # Threshold percentage for benchmark regression
+        )
 
         # Version and publishing options
-        self.publish = None          # Publish to PyPI (patch, minor, major)
-        self.bump = "patch"          # Bump version (patch, minor, major)
-        self.all = None              # Run with -x -t -p <version> -c
+        self.publish = None  # Publish to PyPI (patch, minor, major)
+        self.bump = "patch"  # Bump version (patch, minor, major)
+        self.all = None  # Run with -x -t -p <version> -c
 
         # Git options
-        self.create_pr = False       # Create a pull request
+        self.create_pr = False  # Create a pull request
 
         # Integration options
-        self.ai_agent = False        # Enable AI agent structured output
+        self.ai_agent = False  # Enable AI agent structured output
+
 
 # Create a Crackerjack runner with custom settings
 runner = create_crackerjack_runner(
     console=Console(force_terminal=True),  # Rich console for pretty output
-    pkg_path=Path.cwd(),                   # Path to your project
-    python_version="3.13",                 # Target Python version
-    dry_run=False                          # Set to True to simulate without changes
+    pkg_path=Path.cwd(),  # Path to your project
+    python_version="3.13",  # Target Python version
+    dry_run=False,  # Set to True to simulate without changes
 )
 
 # Run Crackerjack with your options
 runner.process(MyOptions())
 ```
 
-
 ### Command-Line Options
 
--   `-c`, `--commit`: Commit changes to Git.
--   `-i`, `--interactive`: Run pre-commit hooks interactively when possible.
--   `-n`, `--no-config-updates`: Skip updating configuration files (e.g., `pyproject.toml`).
--   `-u`, `--update-precommit`: Update pre-commit hooks to the latest versions.
--   `-v`, `--verbose`: Enable verbose output.
--   `-p`, `--publish <patch|minor|major>`: Bump the project version and publish to PyPI using UV.
--   `-b`, `--bump <patch|minor|major>`: Bump the project version without publishing.
--   `-r`, `--pr`: Create a pull request to the upstream repository.
--   `-s`, `--skip-hooks`: Skip running pre-commit hooks (useful with `-t`).
--   `-x`, `--clean`: Clean code by removing docstrings, line comments, and extra whitespace.
--   `-t`, `--test`: Run tests using `pytest`.
--   `--test-workers`: Set the number of parallel workers for testing (0 = auto-detect, 1 = disable parallelization).
--   `--test-timeout`: Set the timeout in seconds for individual tests (0 = use default based on project size).
--   `--benchmark`: Run tests in benchmark mode (disables parallel execution).
--   `--benchmark-regression`: Fail tests if benchmarks regress beyond threshold.
--   `--benchmark-regression-threshold`: Set threshold percentage for benchmark regression (default 5.0%).
--   `-a`, `--all`: Run with `-x -t -p <patch|minor|major> -c` development options.
--   `-i`, `--interactive`: Enable the interactive Rich UI for a more user-friendly experience with visual progress tracking and interactive prompts.
--   `--ai-agent`: Enable AI agent mode with structured output (see [AI Agent Integration](#ai-agent-integration)).
--   `--help`: Display help.
+- `-c`, `--commit`: Commit changes to Git.
+- `-i`, `--interactive`: Run pre-commit hooks interactively when possible.
+- `-n`, `--no-config-updates`: Skip updating configuration files (e.g., `pyproject.toml`).
+- `-u`, `--update-precommit`: Update pre-commit hooks to the latest versions.
+- `-v`, `--verbose`: Enable verbose output.
+- `-p`, `--publish <patch|minor|major>`: Bump the project version and publish to PyPI using UV.
+- `-b`, `--bump <patch|minor|major>`: Bump the project version without publishing.
+- `-r`, `--pr`: Create a pull request to the upstream repository.
+- `-s`, `--skip-hooks`: Skip running pre-commit hooks (useful with `-t`).
+- `-x`, `--clean`: Clean code by removing docstrings, line comments, and extra whitespace.
+- `-t`, `--test`: Run tests using `pytest`.
+- `--test-workers`: Set the number of parallel workers for testing (0 = auto-detect, 1 = disable parallelization).
+- `--test-timeout`: Set the timeout in seconds for individual tests (0 = use default based on project size).
+- `--benchmark`: Run tests in benchmark mode (disables parallel execution).
+- `--benchmark-regression`: Fail tests if benchmarks regress beyond threshold.
+- `--benchmark-regression-threshold`: Set threshold percentage for benchmark regression (default 5.0%).
+- `-a`, `--all`: Run with `-x -t -p <patch|minor|major> -c` development options.
+- `-i`, `--interactive`: Enable the interactive Rich UI for a more user-friendly experience with visual progress tracking and interactive prompts.
+- `--ai-agent`: Enable AI agent mode with structured output (see [AI Agent Integration](#ai-agent-integration)).
+- `--help`: Display help.
 
 ### Example Workflows
 
 #### Development Workflows
 
 - **Quick Check** - Run basic checks on your code:
+
   ```bash
   python -m crackerjack
   ```
 
 - **Full Development Cycle** - Clean, test, bump version, publish, and commit:
+
   ```bash
   python -m crackerjack -a minor  # All-in-one command
 
@@ -380,11 +411,13 @@ runner.process(MyOptions())
   ```
 
 - **Development with Tests** - Clean code, run checks, run tests, then commit:
+
   ```bash
   python -m crackerjack -c -x -t
   ```
 
 - **Fast Testing** - Run tests without running pre-commit hooks:
+
   ```bash
   python -m crackerjack -t -s
   ```
@@ -392,21 +425,25 @@ runner.process(MyOptions())
 #### Test Execution Options
 
 - **Single-Process Testing** - Run tests sequentially (no parallelization):
+
   ```bash
   python -m crackerjack -t --test-workers=1
   ```
 
 - **Customized Parallel Testing** - Run tests with a specific number of workers:
+
   ```bash
   python -m crackerjack -t --test-workers=4
   ```
 
 - **Long-Running Tests** - Increase test timeout for complex tests:
+
   ```bash
   python -m crackerjack -t --test-timeout=600
   ```
 
 - **Optimized for Large Projects** - Reduce workers and increase timeout for large codebases:
+
   ```bash
   python -m crackerjack -t --test-workers=2 --test-timeout=300
   ```
@@ -414,6 +451,7 @@ runner.process(MyOptions())
 #### Version Management
 
 - **Bump and Publish** - Bump version and publish to PyPI:
+
   ```bash
   python -m crackerjack -p patch  # For patch version
   python -m crackerjack -p minor  # For minor version
@@ -421,6 +459,7 @@ runner.process(MyOptions())
   ```
 
 - **Version Bump Only** - Bump version without publishing:
+
   ```bash
   python -m crackerjack -b major
   ```
@@ -428,11 +467,13 @@ runner.process(MyOptions())
 #### Configuration Management
 
 - **Skip Config Updates** - Run checks without updating configuration files:
+
   ```bash
   python -m crackerjack -n
   ```
 
 - **Update Hooks** - Update pre-commit hooks to latest versions:
+
   ```bash
   python -m crackerjack -u
   ```
@@ -440,11 +481,13 @@ runner.process(MyOptions())
 #### Git Operations
 
 - **Commit Changes** - Run checks and commit changes:
+
   ```bash
   python -m crackerjack -c
   ```
 
 - **Create PR** - Create a pull request to the upstream repository:
+
   ```bash
   python -m crackerjack -r
   ```
@@ -452,21 +495,25 @@ runner.process(MyOptions())
 #### Other Operations
 
 - **Interactive Mode** - Run pre-commit hooks interactively:
+
   ```bash
   python -m crackerjack -i
   ```
 
 - **Rich Interactive Mode** - Run with the interactive Rich UI:
+
   ```bash
   python -m crackerjack -i
   ```
 
 - **AI Integration** - Run with structured output for AI tools:
+
   ```bash
   python -m crackerjack --ai-agent --test
   ```
 
 - **Help** - Display command help:
+
   ```bash
   python -m crackerjack --help
   ```
@@ -504,11 +551,12 @@ python -m crackerjack -i
 ```
 
 This launches an interactive terminal interface where you can:
+
 1. View all available tasks and their dependencies
-2. Confirm each task before execution
-3. Get detailed status information for running tasks
-4. See a summary of completed, failed, and skipped tasks
-5. Visualize error details with recovery suggestions
+1. Confirm each task before execution
+1. Get detailed status information for running tasks
+1. See a summary of completed, failed, and skipped tasks
+1. Visualize error details with recovery suggestions
 
 ## Structured Error Handling
 
@@ -521,6 +569,7 @@ Crackerjack implements a comprehensive error handling system that provides:
 - **Rich Formatting:** Errors are presented with clear visual formatting (when using Rich UI or verbose mode)
 
 Error types include:
+
 - Configuration errors (1000-1999)
 - Execution errors (2000-2999)
 - Test errors (3000-3999)
@@ -553,6 +602,7 @@ Crackerjack is designed to leverage the latest Python 3.13+ language features:
 - **Modern Dictionary Patterns:** Leverages structural pattern matching with dictionaries for cleaner data handling
 
 These modern Python features contribute to:
+
 - More readable and maintainable code
 - Better static type checking with tools like pyright
 - Cleaner, more concise implementations
@@ -567,14 +617,16 @@ Crackerjack is an evolving project. Contributions are welcome! Please open a pul
 To contribute:
 
 1. Add Crackerjack as a development dependency to your project:
-  ```
-  uv add --dev crackerjack
-  ```
+
+```
+uv add --dev crackerjack
+```
 
 2. Run checks and tests before submitting:
-  ```
-  python -m crackerjack -x -t
-  ```
+
+```
+python -m crackerjack -x -t
+```
 
 This ensures your code meets all quality standards before submission.
 
@@ -598,12 +650,14 @@ Crackerjack is designed with modern Python principles in mind:
 Crackerjack stands on the shoulders of giants. We're grateful to the maintainers and contributors of these outstanding tools that make modern Python development possible:
 
 ### Core Development Tools
+
 - **[UV](https://docs.astral.sh/uv/)** - Next-generation Python package and project management
 - **[Ruff](https://docs.astral.sh/ruff/)** - Lightning-fast Python linter and formatter written in Rust
 - **[pyright](https://microsoft.github.io/pyright/)** - Fast, feature-rich static type checker for Python
 - **[pytest](https://pytest.org/)** - Flexible and powerful testing framework
 
 ### Code Quality & Security
+
 - **[pre-commit](https://pre-commit.com/)** - Multi-language pre-commit hooks framework
 - **[bandit](https://bandit.readthedocs.io/)** - Security vulnerability scanner for Python
 - **[vulture](https://github.com/jendrikseipp/vulture)** - Dead code detection tool
@@ -612,26 +666,31 @@ Crackerjack stands on the shoulders of giants. We're grateful to the maintainers
 - **[detect-secrets](https://github.com/Yelp/detect-secrets)** - Prevention of secrets in repositories
 
 ### Dependencies & Project Management
+
 - **[creosote](https://github.com/fredrikaverpil/creosote)** - Unused dependency detection
 - **[autotyping](https://github.com/JelleZijlstra/autotyping)** - Automatic type hint generation
 - **[complexipy](https://github.com/rohaquinlop/complexipy)** - Code complexity analysis
 
 ### CLI & User Interface
+
 - **[Typer](https://typer.tiangolo.com/)** - Modern CLI framework for building command-line interfaces
 - **[Rich](https://rich.readthedocs.io/)** - Rich text and beautiful formatting in the terminal
 - **[click](https://click.palletsprojects.com/)** - Python package for creating command line interfaces
 
 ### Performance & Development Tools
+
 - **[icecream](https://github.com/gruns/icecream)** - Sweet and creamy print debugging
 - **[bevy](https://github.com/ZeroIntensity/bevy)** - Lightweight dependency injection framework
 - **[msgspec](https://github.com/jcrist/msgspec)** - High-performance message serialization
 - **[attrs](https://github.com/python-attrs/attrs)** - Classes without boilerplate
 
 ### Development Environment
+
 - **[PyCharm](https://www.jetbrains.com/pycharm/)** - The premier Python IDE that powered the development of Crackerjack
 - **[Claude Code](https://claude.ai/code)** - AI-powered development assistant that accelerated development and ensured code quality
 
 ### Legacy Inspiration
+
 - **[PDM](https://pdm.fming.dev/)** - Original inspiration for modern Python dependency management patterns
 
 ### Special Recognition
@@ -642,4 +701,4 @@ The integration of these tools into Crackerjack's unified workflow demonstrates
 
 We're honored to build upon this foundation and contribute to the Python community's continued evolution toward better development practices and tools.
 
----
+______________________________________________________________________

crackerjack-0.26.0.dist-info/RECORD

@@ -0,0 +1,16 @@
+crackerjack/.gitignore,sha256=n8cD6U16L3XZn__PvhYm_F7-YeFHFucHCyxWj2NZCGs,259
+crackerjack/.libcst.codemod.yaml,sha256=a8DlErRAIPV1nE6QlyXPAzTOgkB24_spl2E9hphuf5s,772
+crackerjack/.pdm.toml,sha256=dZe44HRcuxxCFESGG8SZIjmc-cGzSoyK3Hs6t4NYA8w,23
+crackerjack/.pre-commit-config-ai.yaml,sha256=0TDQp0HIiRiy5q09H0ytJk3M6l3rLOdJNWHgkHIRCGA,3274
+crackerjack/.pre-commit-config.yaml,sha256=gXFolNsl6aBeyAefmJ6igmwaNtUHjyfziocBDiulRwU,2642
+crackerjack/__init__.py,sha256=8tBSPAru_YDuPpjz05cL7pNbZjYFoRT_agGd_FWa3gY,839
+crackerjack/__main__.py,sha256=-h6Au8CGHS9QdzzbDMGzKHAlNEx7cYmzCrV4g4vV19k,6407
+crackerjack/crackerjack.py,sha256=iYzhBdEvhCdyrqv-t0jQ862JNn3rwV15P2beaOzu3zs,49463
+crackerjack/errors.py,sha256=Wcv0rXfzV9pHOoXYrhQEjyJd4kUUBbdiY-5M9nI8pDw,4050
+crackerjack/interactive.py,sha256=pFItgRUyjOakABLCRz6nIp6_Ycx2LBSeojpYNiTelv0,16126
+crackerjack/py313.py,sha256=buYE7LO11Q64ffowEhTZRFQoAGj_8sg3DTlZuv8M9eo,5890
+crackerjack/pyproject.toml,sha256=twaeui2pJCQnpe92JN1ACxUEHJrGb4T6F6m2Jazc4JI,5401
+crackerjack-0.26.0.dist-info/METADATA,sha256=m2Xb72Fq2Py8_QE_Lu61MccpxVMYZtspu75sZ4M7l00,28758
+crackerjack-0.26.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+crackerjack-0.26.0.dist-info/licenses/LICENSE,sha256=fDt371P6_6sCu7RyqiZH_AhT1LdN3sN1zjBtqEhDYCk,1531
+crackerjack-0.26.0.dist-info/RECORD,,

crackerjack-0.24.10.dist-info/RECORD

@@ -1,16 +0,0 @@
-crackerjack/.gitignore,sha256=n8cD6U16L3XZn__PvhYm_F7-YeFHFucHCyxWj2NZCGs,259
-crackerjack/.libcst.codemod.yaml,sha256=a8DlErRAIPV1nE6QlyXPAzTOgkB24_spl2E9hphuf5s,772
-crackerjack/.pdm.toml,sha256=dZe44HRcuxxCFESGG8SZIjmc-cGzSoyK3Hs6t4NYA8w,23
-crackerjack/.pre-commit-config-ai.yaml,sha256=kPAU41yuX8XU00HDl6Y2mX-L3aLMYTNo8fnFWEZE4mM,3112
-crackerjack/.pre-commit-config.yaml,sha256=KwzEBj84K5Vp09aYXlk2H7LFlMJl6jToOl8q4u3IxuU,2480
-crackerjack/__init__.py,sha256=8tBSPAru_YDuPpjz05cL7pNbZjYFoRT_agGd_FWa3gY,839
-crackerjack/__main__.py,sha256=-h6Au8CGHS9QdzzbDMGzKHAlNEx7cYmzCrV4g4vV19k,6407
-crackerjack/crackerjack.py,sha256=Awvebtc6IZ00FUcTb7fyCTlTDoX-XqNn21VrMQJSPYk,49398
-crackerjack/errors.py,sha256=Wcv0rXfzV9pHOoXYrhQEjyJd4kUUBbdiY-5M9nI8pDw,4050
-crackerjack/interactive.py,sha256=pFItgRUyjOakABLCRz6nIp6_Ycx2LBSeojpYNiTelv0,16126
-crackerjack/py313.py,sha256=buYE7LO11Q64ffowEhTZRFQoAGj_8sg3DTlZuv8M9eo,5890
-crackerjack/pyproject.toml,sha256=VdE3zYoNgCdHEVZRi6kfoLvk22zeo7no3XZbw7ZqfXU,5283
-crackerjack-0.24.10.dist-info/METADATA,sha256=1qzw5hiz4yGCbJ99Sbuxvr-93bhGecrbQeZZ4-dCqyo,28712
-crackerjack-0.24.10.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-crackerjack-0.24.10.dist-info/licenses/LICENSE,sha256=fDt371P6_6sCu7RyqiZH_AhT1LdN3sN1zjBtqEhDYCk,1531
-crackerjack-0.24.10.dist-info/RECORD,,