crackerjack 0.41.1__tar.gz → 0.41.3__tar.gz

crackerjack-0.41.3/.gitleaksignore

@@ -0,0 +1,22 @@
+# Documentation and example code containing sample secrets
+**/.claude/**
+**/*.md
+**/docs/**
+**/examples/**
+
+# IDE configuration files
+**/.idea/**
+**/.vscode/**
+
+# Test files
+**/tests/**
+
+# Lock files and configuration
+uv.lock
+pyproject.toml
+
+# Build and cache directories
+**/__pycache__/**
+**/build/**
+**/dist/**
+**/.venv/**

{crackerjack-0.41.1 → crackerjack-0.41.3}/.pre-commit-config.yaml

@@ -42,7 +42,7 @@ repos:
         name: check-added-large-files
         exclude: ^\.venv/|^src/
   - repo: https://github.com/astral-sh/uv-pre-commit
-    rev: 0.8.22
+    rev: 0.9.0
     hooks:
       - id: uv-lock
         files: ^ pyproject\.toml$
@@ -67,7 +67,7 @@ repos:
         exclude: ^\.venv/|^src/
         additional_dependencies: ["tomli"]
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.13.2
+    rev: v0.14.0
     hooks:
       - id: ruff-check
         exclude: ^\.venv/|^src/

crackerjack-0.41.3/AGENTS.md

@@ -0,0 +1,25 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+
+Crackerjack's agent runtime lives in `crackerjack/`, housing orchestrator logic, agent classes, and CLI entrypoints. Automation scripts reside in `scripts/` and `tools/`, while documentation is maintained in `docs/`, `README.md`, and `CLAUDE.md`. Tests mirror the package in `tests/`, with documentation fixtures under `test_docs_site/`, and integration examples available in `examples/` alongside `example.mcp.json`.
+
+## Build, Test, and Development Commands
+
+`uv sync --group dev` installs runtime, testing, and MCP dependencies. `uv run pre-commit run --all-files` enforces formatting, linting, and security hooks before pushing. `/crackerjack:run --debug` executes the full multi-agent workflow locally and should precede manual Python invocations. `uv run python -m crackerjack --help` enumerates CLI entrypoints when adjusting interface behavior.
+
+## Coding Style & Naming Conventions
+
+Target Python 3.13 with 4-space indentation and explicit type annotations. Keep identifiers concise yet descriptive, and maintain Ruff's cognitive complexity guidance of ≤15. Run `uv run ruff check --fix` for linting and `uv run ruff format` to enforce 88-character lines and import order. Name tests `test_<feature>.py`, fixtures descriptively, and finish agent class names with `*Agent`.
+
+## Testing Guidelines
+
+Execute `uv run pytest` for the default suite, adding `--maxfail=1` during iteration. Follow with `/crackerjack:run` to confirm the agent loop converges. Preserve ≥42% coverage by reviewing `coverage.json` or `htmlcov/` and expanding tests when metrics drop. Use markers `chaos`, `ai_generated`, and `breakthrough` to isolate expensive scenarios, and share fixtures via `tests/conftest.py`.
+
+## Commit & Pull Request Guidelines
+
+Adopt the `type(scope): summary` message pattern (e.g., `fix(agents): guard iteration retry`). Keep commits tight, reference tickets or MCP jobs, and note agent or workflow impacts. PRs should state motivation, implementation notes, validation evidence (commands run, screenshots for docs/UI changes), link issues, and flag follow-up tasks.
+
+## Agent-Aware Workflow
+
+Rely on MCP tooling where possible: kick off quality sweeps with `/crackerjack:run`, monitor progress through `get_job_progress`, and verify readiness with `/crackerjack:status`. Update `.mcp.json` whenever wiring new servers, document fresh agent capabilities here, and keep structured outputs (`test-results.xml`, `coverage.json`) current after major changes.

{crackerjack-0.41.1 → crackerjack-0.41.3}/CHANGELOG.md

@@ -1,6 +1,16 @@
 ______________________________________________________________________
 
-## [Unreleased] - 2025-10-04
+## [0.41.3] - 2025-10-08
+
+### Changed
+
+- Crackerjack (quality: 69/100) - 2025-10-08 20:46:02
+
+### Fixed
+
+- tests: Update 6 files
+
+## [Unreleased] - 2025-10-08
 
 ### Added
 - feat: add new feature
@@ -9,6 +19,31 @@ ______________________________________________________________________
 - fix: resolve bug in parser
 
 
+## [0.41.2] - 2025-10-04
+
+### Changed
+
+- Crackerjack (quality: 69/100) - 2025-10-04 12:48:19
+
+### Testing
+
+- tests: Update 5 files
+
+### Internal
+
+- Add newline at EOF and update uv.lock
+- Modernize dependency groups and fix pre-commit hook
+
+## [Unreleased] - 2025-10-04
+
+### Added
+
+- feat: add new feature
+
+### Fixed
+
+- fix: resolve bug in parser
+
 ## [0.41.0] - 2025-01-10
 
 ### BREAKING CHANGES

{crackerjack-0.41.1 → crackerjack-0.41.3}/GEMINI.md

@@ -39,11 +39,15 @@ The project follows a modular architecture, with a clear separation of concerns
 
 1. Install `uv` (if not already installed):
    ```bash
+   # Recommended: Official installer script
+   curl -LsSf https://astral.sh/uv/install.sh | sh
+
+   # Alternative: Using pipx
    pipx install uv
    ```
 1. Install Crackerjack and its dependencies:
    ```bash
-   uv sync --all-groups
+   uv sync --group dev
    ```
 
 **Running the Main Workflow:**

{crackerjack-0.41.1 → crackerjack-0.41.3}/MIGRATION-0.41.0.md

@@ -9,6 +9,7 @@ Crackerjack v0.41.0 removes self-reference from `[dependency-groups]` following
 ### Self-Reference Removed
 
 **Before (v0.40.3)**:
+
 ```toml
 [dependency-groups]
 dev = [
@@ -19,6 +20,7 @@ dev = [
 ```
 
 **After (v0.41.0)**:
+
 ```toml
 [dependency-groups]
 dev = [
@@ -30,9 +32,9 @@ dev = [
 ## Why This Change?
 
 1. **Eliminates Circular Dependencies**: Self-references create unnecessary complexity
-2. **UV Best Practices**: Modern UV doesn't require self-installation in dev groups
-3. **Consistency**: Aligns with ACB v0.24.0+ dependency group standards
-4. **Cleaner Installation**: Separates tool installation from development dependencies
+1. **UV Best Practices**: Modern UV doesn't require self-installation in dev groups
+1. **Consistency**: Aligns with ACB v0.24.0+ dependency group standards
+1. **Cleaner Installation**: Separates tool installation from development dependencies
 
 ## Migration Steps
 
@@ -75,10 +77,10 @@ uv add --group dev
 
 ## Questions?
 
-- See the main [README.md](README.md) for installation examples
-- Check [CHANGELOG.md](CHANGELOG.md) for detailed release notes
+- See the main [README.md](<./README.md>) for installation examples
+- Check [CHANGELOG.md](<./CHANGELOG.md>) for detailed release notes
 
----
+______________________________________________________________________
 
 **Version**: 0.41.0
 **Migration Difficulty**: Very Low (structural only)

{crackerjack-0.41.1 → crackerjack-0.41.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crackerjack
-Version: 0.41.1
+Version: 0.41.3
 Summary: Crackerjack Python project management tool
 Project-URL: documentation, https://github.com/lesleslie/crackerjack
 Project-URL: homepage, https://github.com/lesleslie/crackerjack
@@ -164,14 +164,26 @@ Crackerjack is built on the following core principles:
 ### Install UV
 
 ```bash
+# Recommended: Official installer script
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Alternative: Using pipx
 pipx install uv
+
+# Alternative: Using Homebrew (macOS)
+brew install uv
 ```
 
 ### Install Crackerjack
 
 ```bash
+# Recommended: Using UV (fastest)
+uv tool install crackerjack
+
+# Alternative: Using pip
 pip install crackerjack
-# or
+
+# For existing project: Add as dependency
 uv add crackerjack
 ```
 
@@ -557,10 +569,10 @@ Model Context Protocol (MCP) enables AI agents to interact directly with Cracker
 
 ### Setup MCP Server
 
-1. **Install MCP dependencies:**
+1. **Install development dependencies (includes MCP tools):**
 
    ```bash
-   uv sync --group mcp
+   uv sync --group dev
    ```
 
 1. **Start the MCP server:**
@@ -1199,7 +1211,7 @@ python -m crackerjack --start-mcp-server --verbose
 ## Contributing
 
 1. Fork and clone the repository
-1. Run `uv sync --all-groups` to install dependencies
+1. Run `uv sync --group dev` to install dependencies
 1. Ensure `python -m crackerjack` passes all checks
 1. Submit pull request
 

{crackerjack-0.41.1 → crackerjack-0.41.3}/QWEN.md

@@ -263,7 +263,7 @@ ls ~/.cache/crackerjack/logs/debug/
 ## Contributing Guidelines
 
 1. Fork and clone the repository
-1. Run `uv sync --all-groups` to install dependencies
+1. Run `uv sync --group dev` to install dependencies
 1. Ensure `python -m crackerjack` passes all checks
 1. Submit pull request
 

{crackerjack-0.41.1 → crackerjack-0.41.3}/README.md

@@ -92,14 +92,26 @@ Crackerjack is built on the following core principles:
 ### Install UV
 
 ```bash
+# Recommended: Official installer script
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Alternative: Using pipx
 pipx install uv
+
+# Alternative: Using Homebrew (macOS)
+brew install uv
 ```
 
 ### Install Crackerjack
 
 ```bash
+# Recommended: Using UV (fastest)
+uv tool install crackerjack
+
+# Alternative: Using pip
 pip install crackerjack
-# or
+
+# For existing project: Add as dependency
 uv add crackerjack
 ```
 
@@ -485,10 +497,10 @@ Model Context Protocol (MCP) enables AI agents to interact directly with Cracker
 
 ### Setup MCP Server
 
-1. **Install MCP dependencies:**
+1. **Install development dependencies (includes MCP tools):**
 
    ```bash
-   uv sync --group mcp
+   uv sync --group dev
    ```
 
 1. **Start the MCP server:**
@@ -1127,7 +1139,7 @@ python -m crackerjack --start-mcp-server --verbose
 ## Contributing
 
 1. Fork and clone the repository
-1. Run `uv sync --all-groups` to install dependencies
+1. Run `uv sync --group dev` to install dependencies
 1. Ensure `python -m crackerjack` passes all checks
 1. Submit pull request
 

{crackerjack-0.41.1 → crackerjack-0.41.3}/crackerjack/dynamic_config.py

@@ -148,7 +148,7 @@ HOOKS_REGISTRY: dict[str, list[HookMetadata]] = {
             "id": "uv-lock",
             "name": None,
             "repo": "https://github.com/astral-sh/uv-pre-commit",
-            "rev": "0.8.22",
+            "rev": "0.9.0",
             "tier": 1,
             "time_estimate": 0.5,
             "stages": None,
@@ -224,7 +224,7 @@ HOOKS_REGISTRY: dict[str, list[HookMetadata]] = {
             "id": "ruff-check",
             "name": None,
             "repo": "https://github.com/astral-sh/ruff-pre-commit",
-            "rev": "v0.13.2",
+            "rev": "v0.14.0",
             "tier": 2,
             "time_estimate": 1.5,
             "stages": None,
@@ -242,7 +242,7 @@ HOOKS_REGISTRY: dict[str, list[HookMetadata]] = {
             "id": "ruff-format",
             "name": None,
             "repo": "https://github.com/astral-sh/ruff-pre-commit",
-            "rev": "v0.13.2",
+            "rev": "v0.14.0",
             "tier": 2,
             "time_estimate": 1.0,
             "stages": None,

{crackerjack-0.41.1 → crackerjack-0.41.3}/crackerjack/tools/validate_regex_patterns.py

@@ -145,6 +145,10 @@ def validate_file(file_path: Path) -> list[tuple[int, str]]:
 
 
 def main(file_paths: list[str]) -> int:
+    if not file_paths:
+        print("✅ No Python files to validate")
+        return 0
+
     exit_code = 0
 
     for file_path_str in file_paths:

{crackerjack-0.41.1 → crackerjack-0.41.3}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "crackerjack"
-version = "0.41.1"
+version = "0.41.3"
 description = "Crackerjack Python project management tool"
 readme = "README.md"
 authors = [

crackerjack-0.41.3/tests/test_agent_selector.py

@@ -0,0 +1,11 @@
+def test_get_registry_basic(self):
+    """Test basic functionality of get_registry."""
+    try:
+        result = get_registry()
+        assert result is not None or result is None
+    except TypeError:
+        pytest.skip(
+            "Function requires specific arguments - manual implementation needed"
+        )
+    except Exception as e:
+        pytest.fail(f"Unexpected error in get_registry: {e}")

crackerjack-0.41.3/tests/test_error_handling.py

@@ -0,0 +1,71 @@
+def test_handle_subprocess_error_basic(self):
+    """Test basic functionality of handle_subprocess_error."""
+    try:
+        result = handle_subprocess_error()
+        assert result is not None or result is None
+    except TypeError:
+        pytest.skip(
+            "Function requires specific arguments - manual implementation needed"
+        )
+    except Exception as e:
+        pytest.fail(f"Unexpected error in handle_subprocess_error: {e}")
+
+def test_handle_file_operation_error_basic(self):
+    """Test basic functionality of handle_file_operation_error."""
+    try:
+        result = handle_file_operation_error()
+        assert result is not None or result is None
+    except TypeError:
+        pytest.skip(
+            "Function requires specific arguments - manual implementation needed"
+        )
+    except Exception as e:
+        pytest.fail(f"Unexpected error in handle_file_operation_error: {e}")
+
+def test_handle_timeout_error_basic(self):
+    """Test basic functionality of handle_timeout_error."""
+    try:
+        result = handle_timeout_error()
+        assert result is not None or result is None
+    except TypeError:
+        pytest.skip(
+            "Function requires specific arguments - manual implementation needed"
+        )
+    except Exception as e:
+        pytest.fail(f"Unexpected error in handle_timeout_error: {e}")
+
+def test_log_operation_success_basic(self):
+    """Test basic functionality of log_operation_success."""
+    try:
+        result = log_operation_success()
+        assert result is not None or result is None
+    except TypeError:
+        pytest.skip(
+            "Function requires specific arguments - manual implementation needed"
+        )
+    except Exception as e:
+        pytest.fail(f"Unexpected error in log_operation_success: {e}")
+
+def test_validate_required_tools_basic(self):
+    """Test basic functionality of validate_required_tools."""
+    try:
+        result = validate_required_tools()
+        assert result is not None or result is None
+    except TypeError:
+        pytest.skip(
+            "Function requires specific arguments - manual implementation needed"
+        )
+    except Exception as e:
+        pytest.fail(f"Unexpected error in validate_required_tools: {e}")
+
+def test_safe_get_attribute_basic(self):
+    """Test basic functionality of safe_get_attribute."""
+    try:
+        result = safe_get_attribute()
+        assert result is not None or result is None
+    except TypeError:
+        pytest.skip(
+            "Function requires specific arguments - manual implementation needed"
+        )
+    except Exception as e:
+        pytest.fail(f"Unexpected error in safe_get_attribute: {e}")

{crackerjack-0.41.1 → crackerjack-0.41.3}/tests/test_performance.py

@@ -212,4 +212,40 @@ def test_execute_tasks_basic(self):
             "Function requires specific arguments - manual implementation needed"
         )
     except Exception as e:
-        pytest.fail(f"Unexpected error in execute_tasks: {e}")
+        pytest.fail(f"Unexpected error in execute_tasks: {e}")
+
+def test_run_command_basic(self):
+    """Test basic functionality of run_command."""
+    try:
+        result = run_command()
+        assert result is not None or result is None
+    except TypeError:
+        pytest.skip(
+            "Function requires specific arguments - manual implementation needed"
+        )
+    except Exception as e:
+        pytest.fail(f"Unexpected error in run_command: {e}")
+
+def test_wrapper_basic(self):
+    """Test basic functionality of wrapper."""
+    try:
+        result = wrapper()
+        assert result is not None or result is None
+    except TypeError:
+        pytest.skip(
+            "Function requires specific arguments - manual implementation needed"
+        )
+    except Exception as e:
+        pytest.fail(f"Unexpected error in wrapper: {e}")
+
+def test_wrapper_basic(self):
+    """Test basic functionality of wrapper."""
+    try:
+        result = wrapper()
+        assert result is not None or result is None
+    except TypeError:
+        pytest.skip(
+            "Function requires specific arguments - manual implementation needed"
+        )
+    except Exception as e:
+        pytest.fail(f"Unexpected error in wrapper: {e}")