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

crackerjack/.gitignore

@@ -18,3 +18,14 @@
 /coverage.json
 /test-results.xml
 /.coverage
+
+# AI agent output files
+/hooks-analysis.json
+/quality-metrics.json
+/project-structure.json
+/error-context.json
+/ai-agent-summary.json
+/bandit-report.json
+
+# Autotyping cache
+.autotyping-cache/

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

@@ -1,105 +1,112 @@
+# AI-optimized pre-commit hooks for comprehensive analysis and structured output
+# Designed for AI agent workflows with enhanced reporting and metrics
+
 repos:
-  # File structure and format validators - check structure first
+  # Group 1: File Structure & Format Validation (parallel-safe, fast)
   - repo: https://github.com/pre-commit/pre-commit-hooks
     rev: v5.0.0
     hooks:
       - id: trailing-whitespace
         name: trailing-whitespace
-        verbose: true
+        stages: [pre-commit]
       - id: end-of-file-fixer
         name: end-of-file-fixer
-        verbose: true
+        stages: [pre-commit]
       - id: check-yaml
         name: check-yaml
-        verbose: true
+        stages: [pre-commit]
       - id: check-toml
         name: check-toml
-        verbose: true
+        stages: [pre-commit]
       - id: check-added-large-files
         name: check-added-large-files
-        verbose: true
+        stages: [pre-commit]
 
+  # Group 2: Project Configuration Management
   - repo: https://github.com/abravalheri/validate-pyproject
     rev: v0.24.1
     hooks:
       - id: validate-pyproject
-        verbose: true
+        stages: [pre-commit]
 
   - repo: https://github.com/tox-dev/pyproject-fmt
     rev: "v2.6.0"
     hooks:
       - id: pyproject-fmt
         args: ["-n"]
-        verbose: true
+        stages: [pre-commit]
 
-  # Package management - once structure is valid
   - repo: https://github.com/astral-sh/uv-pre-commit
-    rev: 0.7.15
+    rev: 0.7.21
     hooks:
       - id: uv-lock
         files: ^pyproject\.toml$
-        verbose: true
+        stages: [pre-commit]
 
-  # Security check - early to prevent credential leaks
+  # Group 3: Security (early detection, critical)
   - repo: https://github.com/Yelp/detect-secrets
     rev: v1.5.0
     hooks:
       - id: detect-secrets
         exclude: 'uv\.lock|pyproject\.toml|tests/.*|docs/.*|.*\.md'
-        verbose: true
+        stages: [pre-commit]
 
-  # Code quality tier 1 - quick fixes
+  # Group 4: Code Quality & Style (fast formatting)
   - repo: https://github.com/codespell-project/codespell
     rev: v2.4.1
     hooks:
       - id: codespell
-        verbose: true
         additional_dependencies:
           - tomli
+        stages: [pre-commit]
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.12.1
+    rev: v0.12.3
     hooks:
       - id: ruff-check
-        verbose: true
-        args: [--output-format=json]
+        args: ["--output-format=json", "--fix"]
+        stages: [pre-commit]
       - id: ruff-format
-        verbose: true
+        stages: [pre-commit]
 
   - repo: https://github.com/executablebooks/mdformat
-    rev: 0.7.18
+    rev: 0.7.22
     hooks:
       - id: mdformat
         additional_dependencies:
           - mdformat-ruff
+        stages: [pre-commit]
 
-  # Code quality tier 2 - analysis
+  # Group 5: Static Analysis (comprehensive, slower)
   - repo: https://github.com/jendrikseipp/vulture
     rev: 'v2.14'
     hooks:
       - id: vulture
-        verbose: true
+        args: ["--verbose"]
+        stages: [pre-commit]
 
   - repo: https://github.com/fredrikaverpil/creosote
     rev: v4.0.3
     hooks:
       - id: creosote
-        verbose: true
+        args: ["--verbose"]
+        stages: [pre-commit]
 
   - repo: https://github.com/rohaquinlop/complexipy-pre-commit
     rev: v3.0.0
     hooks:
       - id: complexipy
-        args: ["-d", "low", "-j"]
-        verbose: true
+        args: ["-d", "low", "--output", "complexipy.json"]
+        stages: [pre-commit]
 
   - repo: https://github.com/dosisod/refurb
     rev: v2.1.0
     hooks:
       - id: refurb
-        verbose: true
+        args: ["--quiet"]
+        stages: [pre-commit]
 
-  # Code quality tier 3 - thorough checks
+  # Group 6: Type Checking & Enhancement (most expensive)
   - repo: local
     hooks:
       - id: autotyping
@@ -109,25 +116,38 @@ repos:
           - --aggressive
           - --only-without-imports
           - --guess-common-names
+          - --cache-dir=.autotyping-cache
+          - --workers=4
+          - --max-line-length=88
+          - --exclude-name=test_*,conftest
           - crackerjack
         types_or: [ python, pyi ]
         language: python
-        files: \.py$
-        verbose: true
+        files: ^crackerjack/.*\.py$
+        stages: [pre-commit]
         additional_dependencies:
           - autotyping>=24.3.0
           - libcst>=1.1.0
 
   - repo: https://github.com/PyCQA/bandit
-    rev: '1.8.5'
+    rev: '1.8.6'
     hooks:
       - id: bandit
-        args: ["-c", "pyproject.toml", "--format", "json"]
-        verbose: true
+        args: ["-c", "pyproject.toml", "-f", "json", "-o", "bandit-report.json", "-r", "-ll"]
+        stages: [pre-commit]
 
   - repo: https://github.com/RobertCraigie/pyright-python
-    rev: v1.1.402
+    rev: v1.1.403
     hooks:
       - id: pyright
-        verbose: true
         args: ["--outputjson"]
+        stages: [pre-commit]
+
+  # Group 7: Documentation & Security Enhancement (AI-specific)
+  # pydocstyle temporarily disabled - conflicts with code cleaning functionality
+  # - repo: https://github.com/PyCQA/pydocstyle
+  #   rev: 6.3.0
+  #   hooks:
+  #     - id: pydocstyle
+  #       args: ["--config=pyproject.toml"]
+  #       stages: [pre-commit]

crackerjack/.pre-commit-config.yaml

@@ -55,29 +55,33 @@ repos:
         additional_dependencies:
           - mdformat-ruff
 
-  # Code quality tier 2 - analysis
+  # Code quality tier 2 - analysis (moved to pre-push for performance)
   - repo: https://github.com/jendrikseipp/vulture
     rev: 'v2.14'
     hooks:
       - id: vulture
+        stages: [pre-push, manual]
 
   - repo: https://github.com/fredrikaverpil/creosote
     rev: v4.0.3
     hooks:
       - id: creosote
+        stages: [pre-push, manual]
 
   - repo: https://github.com/rohaquinlop/complexipy-pre-commit
     rev: v3.0.0
     hooks:
       - id: complexipy
         args: ["-d", "low"]
+        stages: [pre-push, manual]
 
   - repo: https://github.com/dosisod/refurb
     rev: v2.1.0
     hooks:
       - id: refurb
+        stages: [pre-push, manual]
 
-  # Code quality tier 3 - thorough checks
+  # Code quality tier 3 - thorough checks (moved to pre-push for performance)
   - repo: local
     hooks:
       - id: autotyping
@@ -90,7 +94,8 @@ repos:
           - crackerjack
         types_or: [ python, pyi ]
         language: python
-        files: \.py$
+        files: ^crackerjack/.*\.py$
+        stages: [pre-push, manual]
         additional_dependencies:
           - autotyping>=24.3.0
           - libcst>=1.1.0
@@ -99,9 +104,11 @@ repos:
     rev: '1.8.6'
     hooks:
       - id: bandit
-        args: ["-c", "pyproject.toml"]
+        args: ["-c", "pyproject.toml", "-r", "-ll"]
+        stages: [pre-push, manual]
 
   - repo: https://github.com/RobertCraigie/pyright-python
     rev: v1.1.403
     hooks:
       - id: pyright
+        stages: [pre-push, manual]

crackerjack/__main__.py

@@ -1,9 +1,11 @@
+import asyncio
 from enum import Enum
 
 import typer
 from pydantic import BaseModel, field_validator
 from rich.console import Console
-from crackerjack import create_crackerjack_runner
+
+from .crackerjack import create_crackerjack_runner
 
 console = Console(force_terminal=True)
 app = typer.Typer(
@@ -39,6 +41,8 @@ class Options(BaseModel):
     ai_agent: bool = False
     create_pr: bool = False
     skip_hooks: bool = False
+    comprehensive: bool = False
+    async_mode: bool = False
 
     @classmethod
     @field_validator("publish", "bump", mode="before")
@@ -137,6 +141,17 @@ cli_options = {
         help="Enable AI agent mode with structured output.",
         hidden=True,
     ),
+    "comprehensive": typer.Option(
+        False,
+        "--comprehensive",
+        help="Use comprehensive pre-commit hooks (slower but thorough).",
+    ),
+    "async_mode": typer.Option(
+        False,
+        "--async",
+        help="Enable async mode for faster file operations (experimental).",
+        hidden=True,
+    ),
 }
 
 
@@ -162,6 +177,8 @@ def main(
     skip_hooks: bool = cli_options["skip_hooks"],
     create_pr: bool = cli_options["create_pr"],
     ai_agent: bool = cli_options["ai_agent"],
+    comprehensive: bool = cli_options["comprehensive"],
+    async_mode: bool = cli_options["async_mode"],
 ) -> None:
     options = Options(
         commit=commit,
@@ -181,14 +198,16 @@ def main(
         skip_hooks=skip_hooks,
         all=all,
         ai_agent=ai_agent,
+        comprehensive=comprehensive,
         create_pr=create_pr,
+        async_mode=async_mode,
     )
     if ai_agent:
         import os
 
         os.environ["AI_AGENT"] = "1"
     if interactive:
-        from crackerjack.interactive import launch_interactive_cli
+        from .interactive import launch_interactive_cli
 
         try:
             from importlib.metadata import version
@@ -199,7 +218,10 @@ def main(
         launch_interactive_cli(pkg_version)
     else:
         runner = create_crackerjack_runner(console=console)
-        runner.process(options)
+        if async_mode:
+            asyncio.run(runner.process_async(options))
+        else:
+            runner.process(options)
 
 
 if __name__ == "__main__":