crackerjack 0.39.11__tar.gz → 0.40.0__tar.gz

{crackerjack-0.39.11 → crackerjack-0.40.0}/.gitignore

@@ -140,3 +140,4 @@ venv/
 /NOTES.md
 /.obsidian/
 /.smart-env/
+/.backups/

{crackerjack-0.39.11 → crackerjack-0.40.0}/.pre-commit-config.yaml

@@ -51,7 +51,7 @@ repos:
     rev: v8.28.0
     hooks:
       - id: gitleaks
-        exclude: uv\.lock|pyproject\.toml|tests/.*|docs/.*|.*\.md|^src/
+        exclude: uv\.lock|pyproject\.toml|tests/.*|docs/.*|\.claude/.*|.*\.md|^src/
   - repo: https://github.com/PyCQA/bandit
     rev: 1.8.6
     hooks:

{crackerjack-0.39.11 → crackerjack-0.40.0}/CHANGELOG.md

@@ -1,5 +1,104 @@
 ______________________________________________________________________
 
+## [0.40.0] - 2025-10-04
+
+### Added
+
+- Add AI-powered auto-fix workflow with iteration loop
+
+### Changed
+
+- Crackerjack (quality: 69/100) - 2025-10-03 21:23:05
+- Crackerjack (quality: 69/100) - 2025-10-04 03:04:08
+- Crackerjack (quality: 69/100) - 2025-10-04 03:23:36
+
+### Fixed
+
+- test: Update 8 files
+
+### Internal
+
+- Cleanup working docs and update gitignore
+
+## [Unreleased] - 2025-10-04
+
+### Added
+- feat: add new feature
+
+### Fixed
+- fix: resolve bug in parser
+
+
+## [Unreleased] - 2025-10-04
+
+### Added
+
+- feat: add new feature
+
+### Fixed
+
+- fix: resolve bug in parser
+
+## [Unreleased] - 2025-10-04
+
+### Added
+
+- feat: add new feature
+
+### Fixed
+
+- fix: resolve bug in parser
+
+## [Unreleased] - 2025-10-04
+
+### Added
+
+- feat: add new feature
+
+### Fixed
+
+- fix: resolve bug in parser
+
+## [Unreleased] - 2025-10-03
+
+### Added
+
+- feat: add new feature
+
+### Fixed
+
+- fix: resolve bug in parser
+
+## [Unreleased] - 2025-10-03
+
+### Added
+
+- feat: add new feature
+
+### Fixed
+
+- fix: resolve bug in parser
+
+## [Unreleased] - 2025-10-03
+
+### Added
+
+- feat: add new feature
+
+### Fixed
+
+- fix: resolve bug in parser
+
+## [Unreleased] - 2025-10-03
+
+### Added
+
+- feat: add new feature
+
+### Fixed
+
+- fix: resolve bug in parser
+
 ## [0.39.11] - 2025-10-03
 
 ### Changed

{crackerjack-0.39.11 → crackerjack-0.40.0}/CLAUDE.md

@@ -157,9 +157,9 @@ Remember: It's better to ask for clarification than to make assumptions that cou
 
 ## AI Documentation References
 
-- **[AI-REFERENCE.md](docs/ai/AI-REFERENCE.md)** - Command reference with decision trees
-- **\[[AGENT-CAPABILITIES.json]\]** - Structured agent data
-- **\[[ERROR-PATTERNS.yaml]\]** - Automated issue resolution patterns
+- **[AI-REFERENCE.md](<./docs/ai/AI-REFERENCE.md>)** - Command reference with decision trees
+- **[AGENT-CAPABILITIES.json](<./docs/ai/AGENT-CAPABILITIES.json>)** - Structured agent data
+- **[ERROR-PATTERNS.yaml](<./docs/ai/ERROR-PATTERNS.yaml>)** - Automated issue resolution patterns
 
 ## Essential Commands
 

{crackerjack-0.39.11 → crackerjack-0.40.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crackerjack
-Version: 0.39.11
+Version: 0.40.0
 Summary: Crackerjack Python project management tool
 Project-URL: documentation, https://github.com/lesleslie/crackerjack
 Project-URL: homepage, https://github.com/lesleslie/crackerjack
@@ -79,7 +79,7 @@ Description-Content-Type: text/markdown
 [![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)
 [![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit)](https://github.com/pre-commit/pre-commit)
 [![License](https://img.shields.io/badge/License-BSD%203--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause)
-![Coverage](https://img.shields.io/badge/coverage-17.9%25-red)
+![Coverage](https://img.shields.io/badge/coverage-17.7%25-red)
 
 ## 🎯 Purpose
 
@@ -142,17 +142,17 @@ Crackerjack is built on the following core principles:
 
 ## Table of Contents
 
-- \[[#installation|Installation]\]
-- \[[#quick-start|Quick Start]\]
-- \[[#ai-auto-fix-features|AI Auto-Fix Features]\]
-- \[[#core-workflow|Core Workflow]\]
-- \[[#core-features|Core Features]\]
-- \[[#mcp-server-configuration|MCP Server Configuration]\]
-- \[[#pre-commit-hook-modes|Pre-commit Hook Modes]\]
-- \[[#command-reference|Command Reference]\]
-- \[[#style-guide|Style Guide]\]
-- \[[#publishing--version-management|Publishing & Version Management]\]
-- \[[#-troubleshooting|Troubleshooting]\]
+- [Installation](<#installation>)
+- [Quick Start](<#quick-start>)
+- [AI Auto-Fix Features](<#ai-auto-fix-features>)
+- [Core Workflow](<#core-workflow>)
+- [Core Features](<#core-features>)
+- [MCP Server Configuration](<#mcp-server-configuration>)
+- [Pre-commit Hook Modes](<#pre-commit-hook-modes>)
+- [Command Reference](<#command-reference>)
+- [Style Guide](<#style-guide>)
+- [Publishing & Version Management](<#publishing--version-management>)
+- [Troubleshooting](<#-troubleshooting>)
 
 ## Installation
 
@@ -241,6 +241,12 @@ The AI agent intelligently fixes:
 # Standard AI agent mode (recommended)
 python -m crackerjack --ai-fix --run-tests --verbose
 
+# Preview fixes without applying (dry-run mode)
+python -m crackerjack --dry-run --run-tests --verbose
+
+# Custom iteration limit
+python -m crackerjack --ai-fix --max-iterations 15
+
 # MCP server with WebSocket support (localhost:8675)
 python -m crackerjack --start-mcp-server
 
@@ -248,6 +254,43 @@ python -m crackerjack --start-mcp-server
 python -m crackerjack.mcp.progress_monitor <job_id> ws://localhost:8675
 ```
 
+#### MCP Integration
+
+When using crackerjack via MCP tools (session-mgmt-mcp):
+
+```python
+# ✅ CORRECT - Use semantic command + ai_agent_mode parameter
+crackerjack_run(command="test", ai_agent_mode=True)
+
+# ✅ CORRECT - With additional arguments
+crackerjack_run(command="check", args="--verbose", ai_agent_mode=True, timeout=600)
+
+# ✅ CORRECT - Dry-run mode
+crackerjack_run(command="test", args="--dry-run", ai_agent_mode=True)
+
+# ❌ WRONG - Don't put flags in command parameter
+crackerjack_run(command="--ai-fix -t")  # This will error!
+
+# ❌ WRONG - Don't use --ai-fix in args
+crackerjack_run(command="test", args="--ai-fix")  # Use ai_agent_mode=True instead
+```
+
+#### Configuration
+
+Auto-fix requires:
+
+1. **Anthropic API key**: Set environment variable
+
+   ```bash
+   export ANTHROPIC_API_KEY=sk-ant-...
+   ```
+
+1. **Configuration file**: `settings/adapters.yml`
+
+   ```yaml
+   ai: claude
+   ```
+
 #### Key Benefits
 
 - **Zero Configuration**: No complex flag combinations needed
@@ -736,7 +779,7 @@ python -m crackerjack --ai-fix
 | **Clear Caches** | `python -m crackerjack --clear-cache` | Reset all cache data |
 | **Fast Iteration** | `python -m crackerjack --skip-hooks` | Skip quality checks during dev |
 | **Documentation** | `python -m crackerjack --generate-docs` | Generate API documentation |
-| **Advanced Features** | See \[[ADVANCED-FEATURES|ADVANCED-FEATURES.md]\] | 82 enterprise/power user flags |
+| **Advanced Features** | See [ADVANCED-FEATURES.md](<./docs/guides/ADVANCED-FEATURES.md>) | 82 enterprise/power user flags |
 
 **📑 Alphabetical Flag Reference**
 
@@ -777,9 +820,9 @@ python -m crackerjack --ai-fix
 
 **🔗 Related Documentation**
 
-- **Advanced Features**: \[[ADVANCED-FEATURES|ADVANCED-FEATURES.md]\] - 82 enterprise/power user flags
-- **Developer Guide**: \[[CLAUDE|CLAUDE.md]\] - AI assistant guidelines and developer commands
-- **Phase 2 Analysis**: \[[PHASE2-CROSS-REFERENCE-ANALYSIS|docs/PHASE2-CROSS-REFERENCE-ANALYSIS.md]\] - CLI flag audit
+- **Advanced Features**: [ADVANCED-FEATURES.md](<./docs/guides/ADVANCED-FEATURES.md>) - 82 enterprise/power user flags
+- **Developer Guide**: [CLAUDE.md](<./CLAUDE.md>) - AI assistant guidelines and developer commands
+- **Phase 2 Analysis**: [PHASE2-CROSS-REFERENCE-ANALYSIS.md](<./docs/history/phases/PHASE2-CROSS-REFERENCE-ANALYSIS.md>) - CLI flag audit (archived)
 
 ______________________________________________________________________
 

{crackerjack-0.39.11 → crackerjack-0.40.0}/README.md

@@ -7,7 +7,7 @@
 [![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)
 [![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit)](https://github.com/pre-commit/pre-commit)
 [![License](https://img.shields.io/badge/License-BSD%203--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause)
-![Coverage](https://img.shields.io/badge/coverage-17.9%25-red)
+![Coverage](https://img.shields.io/badge/coverage-17.7%25-red)
 
 ## 🎯 Purpose
 
@@ -70,17 +70,17 @@ Crackerjack is built on the following core principles:
 
 ## Table of Contents
 
-- \[[#installation|Installation]\]
-- \[[#quick-start|Quick Start]\]
-- \[[#ai-auto-fix-features|AI Auto-Fix Features]\]
-- \[[#core-workflow|Core Workflow]\]
-- \[[#core-features|Core Features]\]
-- \[[#mcp-server-configuration|MCP Server Configuration]\]
-- \[[#pre-commit-hook-modes|Pre-commit Hook Modes]\]
-- \[[#command-reference|Command Reference]\]
-- \[[#style-guide|Style Guide]\]
-- \[[#publishing--version-management|Publishing & Version Management]\]
-- \[[#-troubleshooting|Troubleshooting]\]
+- [Installation](<#installation>)
+- [Quick Start](<#quick-start>)
+- [AI Auto-Fix Features](<#ai-auto-fix-features>)
+- [Core Workflow](<#core-workflow>)
+- [Core Features](<#core-features>)
+- [MCP Server Configuration](<#mcp-server-configuration>)
+- [Pre-commit Hook Modes](<#pre-commit-hook-modes>)
+- [Command Reference](<#command-reference>)
+- [Style Guide](<#style-guide>)
+- [Publishing & Version Management](<#publishing--version-management>)
+- [Troubleshooting](<#-troubleshooting>)
 
 ## Installation
 
@@ -169,6 +169,12 @@ The AI agent intelligently fixes:
 # Standard AI agent mode (recommended)
 python -m crackerjack --ai-fix --run-tests --verbose
 
+# Preview fixes without applying (dry-run mode)
+python -m crackerjack --dry-run --run-tests --verbose
+
+# Custom iteration limit
+python -m crackerjack --ai-fix --max-iterations 15
+
 # MCP server with WebSocket support (localhost:8675)
 python -m crackerjack --start-mcp-server
 
@@ -176,6 +182,43 @@ python -m crackerjack --start-mcp-server
 python -m crackerjack.mcp.progress_monitor <job_id> ws://localhost:8675
 ```
 
+#### MCP Integration
+
+When using crackerjack via MCP tools (session-mgmt-mcp):
+
+```python
+# ✅ CORRECT - Use semantic command + ai_agent_mode parameter
+crackerjack_run(command="test", ai_agent_mode=True)
+
+# ✅ CORRECT - With additional arguments
+crackerjack_run(command="check", args="--verbose", ai_agent_mode=True, timeout=600)
+
+# ✅ CORRECT - Dry-run mode
+crackerjack_run(command="test", args="--dry-run", ai_agent_mode=True)
+
+# ❌ WRONG - Don't put flags in command parameter
+crackerjack_run(command="--ai-fix -t")  # This will error!
+
+# ❌ WRONG - Don't use --ai-fix in args
+crackerjack_run(command="test", args="--ai-fix")  # Use ai_agent_mode=True instead
+```
+
+#### Configuration
+
+Auto-fix requires:
+
+1. **Anthropic API key**: Set environment variable
+
+   ```bash
+   export ANTHROPIC_API_KEY=sk-ant-...
+   ```
+
+1. **Configuration file**: `settings/adapters.yml`
+
+   ```yaml
+   ai: claude
+   ```
+
 #### Key Benefits
 
 - **Zero Configuration**: No complex flag combinations needed
@@ -664,7 +707,7 @@ python -m crackerjack --ai-fix
 | **Clear Caches** | `python -m crackerjack --clear-cache` | Reset all cache data |
 | **Fast Iteration** | `python -m crackerjack --skip-hooks` | Skip quality checks during dev |
 | **Documentation** | `python -m crackerjack --generate-docs` | Generate API documentation |
-| **Advanced Features** | See \[[ADVANCED-FEATURES|ADVANCED-FEATURES.md]\] | 82 enterprise/power user flags |
+| **Advanced Features** | See [ADVANCED-FEATURES.md](<./docs/guides/ADVANCED-FEATURES.md>) | 82 enterprise/power user flags |
 
 **📑 Alphabetical Flag Reference**
 
@@ -705,9 +748,9 @@ python -m crackerjack --ai-fix
 
 **🔗 Related Documentation**
 
-- **Advanced Features**: \[[ADVANCED-FEATURES|ADVANCED-FEATURES.md]\] - 82 enterprise/power user flags
-- **Developer Guide**: \[[CLAUDE|CLAUDE.md]\] - AI assistant guidelines and developer commands
-- **Phase 2 Analysis**: \[[PHASE2-CROSS-REFERENCE-ANALYSIS|docs/PHASE2-CROSS-REFERENCE-ANALYSIS.md]\] - CLI flag audit
+- **Advanced Features**: [ADVANCED-FEATURES.md](<./docs/guides/ADVANCED-FEATURES.md>) - 82 enterprise/power user flags
+- **Developer Guide**: [CLAUDE.md](<./CLAUDE.md>) - AI assistant guidelines and developer commands
+- **Phase 2 Analysis**: [PHASE2-CROSS-REFERENCE-ANALYSIS.md](<./docs/history/phases/PHASE2-CROSS-REFERENCE-ANALYSIS.md>) - CLI flag audit (archived)
 
 ______________________________________________________________________
 

{crackerjack-0.39.11 → crackerjack-0.40.0}/crackerjack/adapters/__init__.py

@@ -1,10 +1,15 @@
 """Rust tool adapters for unified integration."""
 
+from acb.adapters import register_adapter
+
 from .rust_tool_adapter import Issue, RustToolAdapter, ToolResult
 from .rust_tool_manager import RustToolHookManager
 from .skylos_adapter import DeadCodeIssue, SkylosAdapter
 from .zuban_adapter import TypeIssue, ZubanAdapter
 
+# Register AI adapter
+register_adapter("ai", "crackerjack.adapters.ai.claude", "ClaudeCodeFixer")
+
 __all__ = [
     "RustToolAdapter",
     "ToolResult",

crackerjack-0.40.0/crackerjack/adapters/ai/__init__.py

@@ -0,0 +1,5 @@
+"""AI adapters for code fixing and analysis."""
+
+from .claude import ClaudeCodeFixer, ClaudeCodeFixerSettings
+
+__all__ = ["ClaudeCodeFixer", "ClaudeCodeFixerSettings"]