crackerjack 0.37.9__py3-none-any.whl → 0.45.2__py3-none-any.whl

crackerjack/config/settings.py

@@ -0,0 +1,141 @@
+from pathlib import Path
+
+from acb.config import Settings
+
+
+class CleaningSettings(Settings):
+    clean: bool = True
+    update_docs: bool = False
+    force_update_docs: bool = False
+    compress_docs: bool = False
+    auto_compress_docs: bool = False
+
+
+class HookSettings(Settings):
+    skip_hooks: bool = False
+    update_precommit: bool = False
+    experimental_hooks: bool = False
+    enable_pyrefly: bool = False
+    enable_ty: bool = False
+    enable_lsp_optimization: bool = False
+
+
+class TestSettings(Settings):
+    test: bool = False
+    benchmark: bool = False
+    test_workers: int = 0
+    test_timeout: int = 0
+    auto_detect_workers: bool = True
+    max_workers: int = 8
+    min_workers: int = 2
+    memory_per_worker_gb: float = 2.0
+
+
+class PublishSettings(Settings):
+    publish: str | None = None
+    bump: str | None = None
+    all: str | None = None
+    no_git_tags: bool = False
+    skip_version_check: bool = False
+
+
+class GitSettings(Settings):
+    commit: bool = False
+    create_pr: bool = False
+
+
+class AISettings(Settings):
+    ai_agent: bool = False
+    start_mcp_server: bool = False
+    max_iterations: int = 5
+    autofix: bool = True
+    ai_agent_autofix: bool = False
+
+
+class ExecutionSettings(Settings):
+    interactive: bool = False
+    verbose: bool = False
+    async_mode: bool = False
+    no_config_updates: bool = False
+
+
+class ProgressSettings(Settings):
+    enabled: bool = False
+
+
+class CleanupSettings(Settings):
+    auto_cleanup: bool = True
+    keep_debug_logs: int = 5
+    keep_coverage_files: int = 10
+
+
+class AdvancedSettings(Settings):
+    enabled: bool = False
+    license_key: str | None = None
+    organization: str | None = None
+
+
+class ConsoleSettings(Settings):
+    """Console/UI related settings."""
+
+    width: int = 70
+
+
+class MCPServerSettings(Settings):
+    http_port: int = 8676
+    http_host: str = "127.0.0.1"
+    websocket_port: int = 8675
+    http_enabled: bool = False
+
+
+class ZubanLSPSettings(Settings):
+    enabled: bool = True
+    auto_start: bool = True
+    port: int = 8677
+    mode: str = "stdio"
+    timeout: int = 120
+
+
+class GlobalLockSettings(Settings):
+    enabled: bool = True
+    timeout_seconds: float = 1800.0
+    stale_lock_hours: float = 2.0
+    lock_directory: Path = Path.home() / ".crackerjack" / "locks"
+    session_heartbeat_interval: float = 30.0
+    max_retry_attempts: int = 3
+    retry_delay_seconds: float = 5.0
+    enable_lock_monitoring: bool = True
+
+
+class CrackerjackSettings(Settings):
+    console: ConsoleSettings = ConsoleSettings()
+    cleaning: CleaningSettings = CleaningSettings()
+    hooks: HookSettings = HookSettings()
+    testing: TestSettings = TestSettings()
+    publishing: PublishSettings = PublishSettings()
+    git: GitSettings = GitSettings()
+    ai: AISettings = AISettings()
+    execution: ExecutionSettings = ExecutionSettings()
+    progress: ProgressSettings = ProgressSettings()
+    cleanup: CleanupSettings = CleanupSettings()
+    advanced: AdvancedSettings = AdvancedSettings()
+    mcp_server: MCPServerSettings = MCPServerSettings()
+    zuban_lsp: ZubanLSPSettings = ZubanLSPSettings()
+    global_lock: GlobalLockSettings = GlobalLockSettings()
+    enable_orchestration: bool = True
+    orchestration_mode: str = "acb"
+    enable_caching: bool = True
+    cache_backend: str = "memory"
+    cache_ttl: int = 3600
+    cache_max_entries: int = 100
+    max_parallel_hooks: int = 4
+    default_timeout: int = 1800
+    stop_on_critical_failure: bool = True
+    enable_dependency_resolution: bool = True
+    log_cache_stats: bool = False
+    log_execution_timing: bool = False
+    enable_strategy_parallelism: bool = True
+    enable_adaptive_execution: bool = True
+    max_concurrent_strategies: int = 2
+    enable_tool_proxy: bool = True
+    use_precommit_legacy: bool = True

crackerjack/config/tool_commands.py

@@ -0,0 +1,331 @@
+"""Tool command registry for direct tool invocation.
+
+This module provides mappings from hook names to direct tool commands,
+replacing the legacy pre-commit wrapper approach.
+
+Each command is a list of strings that can be passed directly to subprocess.run().
+Commands use 'uv run' for Python-based tools to leverage dependency management.
+"""
+
+from __future__ import annotations
+
+from functools import lru_cache
+from pathlib import Path
+
+
+@lru_cache(maxsize=8)
+def _detect_package_name_cached(pkg_path_str: str) -> str:
+    """Detect the main package name from pyproject.toml or directory structure.
+
+    Args:
+        pkg_path: Path to the project root
+
+    Returns:
+        The detected package name (defaults to 'crackerjack' if detection fails)
+    """
+    # Method 1: Try to read from pyproject.toml
+    pkg_path = Path(pkg_path_str)
+    pyproject_path = pkg_path / "pyproject.toml"
+    if pyproject_path.exists():
+        from contextlib import suppress
+
+        with suppress(Exception):
+            import tomllib
+
+            with pyproject_path.open("rb") as f:
+                data = tomllib.load(f)
+                project_name = data.get("project", {}).get("name")
+                if project_name:
+                    # Convert project name to package name (hyphens to underscores)
+                    return project_name.replace("-", "_")
+
+    # Method 2: Look for Python packages in the project root
+    for item in pkg_path.iterdir():
+        if item.is_dir() and (item / "__init__.py").exists():
+            # Skip common non-package directories
+            if item.name not in {"tests", "docs", ".venv", "venv", "build", "dist"}:
+                return item.name
+
+    # Method 3: Use the directory name as the package name
+    # Convert hyphens to underscores to match Python package naming conventions
+    return pkg_path.name.replace("-", "_")
+
+
+def _build_tool_commands(package_name: str) -> dict[str, list[str]]:
+    """Build tool command registry with dynamic package name.
+
+    Args:
+        package_name: The name of the package being analyzed
+
+    Returns:
+        Dictionary mapping hook names to command lists
+    """
+    return {
+        # ========================================================================
+        # CUSTOM TOOLS (crackerjack native)
+        # ========================================================================
+        "validate-regex-patterns": [
+            "uv",
+            "run",
+            "python",
+            "-m",
+            "crackerjack.tools.validate_regex_patterns",
+        ],
+        "skylos": [
+            "uv",
+            "run",
+            "skylos",
+            "--exclude-folder",
+            "tests",
+            f"./{package_name}",
+        ],
+        "zuban": [
+            "uv",
+            "run",
+            "zuban",
+            "mypy",  # Use mypy-compatible command as it's more likely to have expected behavior
+            "--config-file",
+            "mypy.ini",  # Required: zuban v0.2.2 can't parse [tool.mypy] from pyproject.toml
+            "--no-error-summary",  # Suppress summary line (e.g., "Found N errors") to keep issue output clean
+            f"./{package_name}",
+        ],
+        # ========================================================================
+        # PRE-COMMIT-HOOKS (native implementations in crackerjack.tools)
+        # ========================================================================
+        "trailing-whitespace": [
+            "uv",
+            "run",
+            "python",
+            "-m",
+            "crackerjack.tools.trailing_whitespace",
+        ],
+        "end-of-file-fixer": [
+            "uv",
+            "run",
+            "python",
+            "-m",
+            "crackerjack.tools.end_of_file_fixer",
+        ],
+        "check-yaml": ["uv", "run", "python", "-m", "crackerjack.tools.check_yaml"],
+        "check-toml": ["uv", "run", "python", "-m", "crackerjack.tools.check_toml"],
+        "check-json": ["uv", "run", "python", "-m", "crackerjack.tools.check_json"],
+        "format-json": ["uv", "run", "python", "-m", "crackerjack.tools.format_json"],
+        "check-jsonschema": [
+            "uv",
+            "run",
+            "python",
+            "-m",
+            "crackerjack.tools.check_jsonschema",
+        ],
+        "check-ast": ["uv", "run", "python", "-m", "crackerjack.tools.check_ast"],
+        "check-added-large-files": [
+            "uv",
+            "run",
+            "python",
+            "-m",
+            "crackerjack.tools.check_added_large_files",
+            "--maxkb",
+            "1000",  # 1MB limit for comprehensive frameworks with large lock files
+        ],
+        # ========================================================================
+        # THIRD-PARTY TOOLS (direct invocation)
+        # ========================================================================
+        "uv-lock": ["uv", "lock"],
+        "gitleaks": [
+            "uv",
+            "run",
+            "gitleaks",
+            "protect",
+            "-v",
+        ],
+        "bandit": [
+            "uv",
+            "run",
+            "bandit",
+            "-r",  # Recursive scanning
+            "--format",
+            "json",  # JSON output for structured parsing
+            "--severity-level",
+            "low",  # Detect all severity levels
+            "--confidence-level",
+            "low",  # Detect all confidence levels
+            "-x",
+            "tests",  # Exclude tests directory
+            f"./{package_name}",  # Target only the package directory
+        ],
+        "semgrep": [
+            "uvx",  # Use uvx for isolated semgrep environment
+            "--python=3.13",  # Explicitly use Python 3.13 for match/case syntax support
+            "semgrep",
+            "scan",
+            "--error",  # Exit with non-zero code when findings detected (CRITICAL security level)
+            "--json",  # JSON output for structured parsing
+            "--config",
+            "p/security-audit",  # Security-focused ruleset (comprehensive)
+            "--exclude",
+            ".pytest_cache",
+            "--exclude",
+            ".ruff_cache",
+            "--exclude",
+            "__pycache__",
+            "--exclude",
+            "tests",
+            f"./{package_name}",  # Target only the package directory
+        ],
+        "codespell": [
+            "uv",
+            "run",
+            "python",
+            "-m",
+            "crackerjack.tools.codespell_wrapper",
+        ],
+        "ruff-check": [
+            "uv",
+            "run",
+            "python",
+            "-m",
+            "ruff",
+            "check",
+            f"./{package_name}",
+        ],
+        "ruff-format": [
+            "uv",
+            "run",
+            "python",
+            "-m",
+            "ruff",
+            "format",
+            "--check",
+            f"./{package_name}",
+        ],
+        # Mdformat in auto-fix mode for fast hooks (no --check)
+        "mdformat": [
+            "uv",
+            "run",
+            "python",
+            "-m",
+            "crackerjack.tools.mdformat_wrapper",
+        ],
+        # Use explicit project path flag; include venv discovery
+        "creosote": [
+            "uv",
+            "run",
+            "creosote",
+            "-p",
+            package_name,
+            "--venv",
+            ".venv",
+        ],
+        "complexipy": [
+            "uv",
+            "run",
+            "complexipy",
+            "--max-complexity-allowed",
+            "15",
+            package_name,
+        ],
+        "refurb": ["uv", "run", "python", "-m", "refurb", package_name],
+        "pip-audit": [
+            "uv",
+            "run",
+            "pip-audit",
+            "--format",
+            "json",  # JSON output for structured parsing
+            "--desc",  # Include vulnerability descriptions
+            "--skip-editable",  # Skip editable packages in development
+            "--vulnerability-service",
+            "osv",  # Use OSV database for vulnerability data
+        ],
+        "pyscn": [
+            "uv",
+            "run",
+            "pyscn",
+            "check",  # Use check subcommand (fast, CI-friendly analysis)
+            "--max-complexity",
+            "15",  # Match crackerjack's complexity threshold
+            "--select",
+            "complexity,deadcode,deps",  # Run complexity, dead code, and dependency checks
+            package_name,
+        ],
+    }
+
+
+@lru_cache(maxsize=8)
+def _build_tool_commands_cached(package_name: str) -> dict[str, tuple[str, ...]]:
+    """Cached variant of tool command map returning immutable tuples.
+
+    Using tuples ensures cached structures aren’t accidentally mutated, while
+    get_tool_command converts back to lists for callers.
+    """
+    raw = _build_tool_commands(package_name)
+    return {k: tuple(v) for k, v in raw.items()}
+
+
+# Precompute defaults for the active working directory to avoid hot-path lookups
+_DEFAULT_CWD_STR = str(Path.cwd())
+_DEFAULT_PACKAGE_NAME = _detect_package_name_cached(_DEFAULT_CWD_STR)
+_DEFAULT_COMMANDS = _build_tool_commands_cached(_DEFAULT_PACKAGE_NAME)
+
+
+def get_tool_command(hook_name: str, pkg_path: Path | None = None) -> list[str]:
+    """Get the direct command for a tool by hook name.
+
+    Args:
+        hook_name: The name of the hook (e.g., "ruff-check", "trailing-whitespace")
+        pkg_path: Optional path to the project root (for package name detection)
+
+    Returns:
+        List of command arguments for subprocess execution
+
+    Raises:
+        KeyError: If the hook name is not found in the registry
+    """
+    # Detect package name from project root
+    if pkg_path is None or str(pkg_path) == _DEFAULT_CWD_STR:
+        tool_commands = _DEFAULT_COMMANDS
+    else:
+        package_name = _detect_package_name_cached(str(pkg_path))
+        tool_commands = _build_tool_commands_cached(package_name)
+
+    if hook_name not in tool_commands:
+        msg = f"Unknown hook name: {hook_name}"
+        raise KeyError(msg)
+
+    # Return a fresh list to prevent caller mutation
+    return list(tool_commands[hook_name])
+
+
+def list_available_tools() -> list[str]:
+    """Get list of all available tool names.
+
+    Returns:
+        Sorted list of hook names that can be executed
+    """
+    # Build with a dummy package name just to get the keys
+    tool_commands = _build_tool_commands_cached("dummy")
+    return sorted(tool_commands.keys())
+
+
+def is_native_tool(hook_name: str) -> bool:
+    """Check if a tool is implemented as a native crackerjack tool.
+
+    We classify only the built-in Python implementations as native. Wrappers
+    around third-party tools (e.g., codespell) are not considered native.
+
+    Args:
+        hook_name: The name of the hook
+
+    Returns:
+        True if the tool is natively implemented in crackerjack.tools, else False
+    """
+    NATIVE_TOOLS: set[str] = {
+        # Native Python implementations in crackerjack.tools
+        "trailing-whitespace",
+        "end-of-file-fixer",
+        "check-yaml",
+        "check-toml",
+        "check-added-large-files",
+        # Classified as native per tests and docs
+        "validate-regex-patterns",
+    }
+    return hook_name in NATIVE_TOOLS