crackerjack 0.39.6__tar.gz → 0.39.8__tar.gz

{crackerjack-0.39.6 → crackerjack-0.39.8}/CHANGELOG.md

@@ -1,5 +1,69 @@
 ______________________________________________________________________
 
+## [0.39.8] - 2025-10-03
+
+### Testing
+
+- tests: Update CHANGELOG, pyproject, test_session_coordinator
+
+## [Unreleased] - 2025-10-03
+
+### Added
+- feat: add new feature
+
+### Fixed
+- fix: resolve bug in parser
+
+
+## [0.39.7] - 2025-10-03
+
+### Changed
+
+- Crackerjack (quality: 69/100) - 2025-10-03 10:30:07
+- Crackerjack (quality: 69/100) - 2025-10-03 11:48:05
+- Crackerjack (quality: 69/100) - 2025-10-03 12:08:12
+
+### Documentation
+
+- Complete Phase 1 & 2 documentation audit and updates
+- Complete Phase 3 optimization - 100% CLI coverage achieved
+
+### Testing
+
+- test: Update 6 files
+
+## [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
+
+- docs: Add documentation for 3 new AI agents (SemanticAgent, ArchitectAgent, EnhancedProactiveAgent)
+- docs: Comprehensive documentation audit report with 73-file inventory
+
+### Changed
+
+- docs: Update agent count from 9 to 12 across README.md and CLAUDE.md
+- docs: Enhanced agent descriptions with capabilities and use cases
+
 ## [0.39.6] - 2025-10-03
 
 ### Changed
@@ -17,15 +81,6 @@ ______________________________________________________________________
 
 - tests: Update 4 files
 
-## [Unreleased] - 2025-10-03
-
-### Added
-- feat: add new feature
-
-### Fixed
-- fix: resolve bug in parser
-
-
 ## [Unreleased] - 2025-10-02
 
 ### Added

{crackerjack-0.39.6 → crackerjack-0.39.8}/CLAUDE.md

@@ -188,12 +188,80 @@ python -m crackerjack --restart-mcp-server   # Restart MCP server
 python -m crackerjack --watchdog             # Monitor/restart services
 
 # Release
-python -m crackerjack --full-release patch  # Full release workflow
+python -m crackerjack --all patch  # Full release workflow
 ```
 
+## Developer Command Index
+
+**🔧 Daily Development Workflow**
+
+| Workflow Stage | Command | When to Use |
+|---------------|---------|-------------|
+| **Quick Check** | `python -m crackerjack` | Before committing changes |
+| **Full Validation** | `python -m crackerjack --run-tests` | After feature completion |
+| **AI-Assisted Fix** | `python -m crackerjack --ai-fix --run-tests` | When tests fail or quality issues found |
+| **Fast Iteration** | `python -m crackerjack --skip-hooks` | During active development/debugging |
+| **Debug AI Issues** | `python -m crackerjack --ai-debug --run-tests` | When AI agents behave unexpectedly |
+
+**🐛 Debugging & Troubleshooting**
+
+| Issue | Command | Description |
+|-------|---------|-------------|
+| **AI Agent Issues** | `python -m crackerjack --ai-debug` | Verbose AI debugging output |
+| **Slow Tests** | `python -m crackerjack --test-workers 2` | Reduce parallelization |
+| **Hook Failures** | `python -m crackerjack --skip-hooks` | Bypass pre-commit during dev |
+| **Cache Problems** | `python -m crackerjack --clear-cache` | Reset all caches |
+| **Coverage Issues** | `python -m crackerjack --coverage-status` | Check ratchet status |
+
+**🚀 Release & Publishing**
+
+| Task | Command | Notes |
+|------|---------|-------|
+| **Quick Publish** | `python -m crackerjack --publish patch` | Version bump + publish |
+| **Full Release** | `python -m crackerjack --all patch` | Complete release workflow |
+| **Version Bump Only** | `python -m crackerjack --bump minor` | Update version without publishing |
+| **Interactive Release** | `python -m crackerjack --all interactive` | Choose version interactively |
+
+**🤖 AI Agent Invocation**
+
+| Agent Task | Command Pattern | Confidence Threshold |
+|-----------|----------------|---------------------|
+| **Refactoring** | `--ai-fix` (complexity ≤15) | 0.9 |
+| **Performance** | `--ai-fix` (O(n²) detection) | 0.85 |
+| **Security** | `--ai-fix` (unsafe patterns) | 0.8 |
+| **Testing** | `--ai-fix` (test failures) | 0.8 |
+| **All Agents** | `--ai-fix --run-tests` | ≥0.7 |
+
+**⚡ Performance Optimization**
+
+| Optimization | Command | Impact |
+|--------------|---------|--------|
+| **Benchmark Mode** | `python -m crackerjack --benchmark` | Disable parallelization for accurate timing |
+| **Cache Stats** | `python -m crackerjack --cache-stats` | View hit rates and sizes |
+| **Fast Hooks Only** | `python -m crackerjack --fast` | ~5s execution (formatting only) |
+| **Comprehensive Hooks** | `python -m crackerjack --comp` | ~30s execution (full analysis) |
+| **Quick Mode (CI/CD)** | `python -m crackerjack --quick` | Max 3 iterations |
+
+**📊 Monitoring Commands**
+
+| Monitor Type | Command | Access |
+|-------------|---------|--------|
+| **Comprehensive Dashboard** | `python -m crackerjack --dashboard` | Terminal UI |
+| **Unified Dashboard** | `python -m crackerjack --unified-dashboard` | http://localhost:8675 |
+| **Multi-Project** | `python -m crackerjack --monitor` | Terminal UI |
+| **Enhanced Monitor** | `python -m crackerjack --enhanced-monitor` | Advanced patterns |
+
+**🔗 Quick Links**
+
+- **Advanced Features**: See `docs/ADVANCED-FEATURES.md` for 82 enterprise/power user flags
+- **User Reference**: See `README.md` for comprehensive command reference
+- **Error Patterns**: See `docs/ai/ERROR-PATTERNS.yaml` for automated fixes
+
+______________________________________________________________________
+
 ## AI Agent System
 
-**9 Specialized Agents** handle domain-specific issues:
+**12 Specialized Agents** handle domain-specific issues:
 
 - **RefactoringAgent** (0.9): Complexity ≤15, dead code removal
 - **PerformanceAgent** (0.85): O(n²) detection, optimization
@@ -204,6 +272,9 @@ python -m crackerjack --full-release patch  # Full release workflow
 - **FormattingAgent** (0.8): Style violations, imports
 - **ImportOptimizationAgent**: Import cleanup, reorganization
 - **TestSpecialistAgent** (0.8): Advanced testing scenarios
+- **SemanticAgent** (0.85): Semantic analysis, code comprehension, intelligent refactoring
+- **ArchitectAgent** (0.85): Architecture patterns, design recommendations, system optimization
+- **EnhancedProactiveAgent** (0.9): Proactive prevention, predictive monitoring, preemptive optimization
 
 **Usage**: `--ai-fix` enables batch fixing; confidence ≥0.7 uses specific agents
 

{crackerjack-0.39.6 → crackerjack-0.39.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crackerjack
-Version: 0.39.6
+Version: 0.39.8
 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-18.4%25-red)
+![Coverage](https://img.shields.io/badge/coverage-18.0%25-red)
 
 ## 🎯 Purpose
 
@@ -258,7 +258,7 @@ python -m crackerjack.mcp.progress_monitor <job_id> ws://localhost:8675
 
 #### 🤖 Specialized Agent Architecture
 
-**9 Domain-Specific Sub-Agents** for targeted code quality improvements:
+**12 Specialized AI Agents** for comprehensive code quality improvements:
 
 - **🔒 SecurityAgent**: Fixes shell injections, weak crypto, token exposure, unsafe library usage
 - **♻️ RefactoringAgent**: Reduces complexity ≤15, extracts helper methods, applies SOLID principles
@@ -269,6 +269,9 @@ python -m crackerjack.mcp.progress_monitor <job_id> ws://localhost:8675
 - **🧪 TestCreationAgent**: Fixes test failures, missing fixtures, dependency issues
 - **📦 ImportOptimizationAgent**: Removes unused imports, restructures import statements
 - **🔬 TestSpecialistAgent**: Advanced testing scenarios, fixture management
+- **🔍 SemanticAgent**: Advanced semantic analysis, code comprehension, intelligent refactoring suggestions based on business logic understanding
+- **🏗️ ArchitectAgent**: High-level architectural patterns, design recommendations, system-level optimization strategies
+- **🎯 EnhancedProactiveAgent**: Proactive issue prevention, predictive quality monitoring, optimization before problems occur
 
 **Agent Coordination Features**:
 
@@ -715,6 +718,71 @@ python -m crackerjack --all patch
 python -m crackerjack --ai-fix
 ```
 
+## Quick Reference Index
+
+**📋 Command Index by Use Case**
+
+| Use Case | Command | Description |
+|----------|---------|-------------|
+| **Basic Quality Check** | `python -m crackerjack` | Run quality checks only |
+| **Quality + Tests** | `python -m crackerjack --run-tests` | Quality checks with test suite |
+| **AI Auto-Fix** | `python -m crackerjack --ai-fix --run-tests` | AI-powered fixing + tests (recommended) |
+| **Full Release** | `python -m crackerjack --all patch` | Version bump, quality checks, publish |
+| **Quick Publish** | `python -m crackerjack --publish patch` | Version bump + publish only |
+| **Start MCP Server** | `python -m crackerjack --start-mcp-server` | Launch MCP agent integration |
+| **Monitoring Dashboard** | `python -m crackerjack --dashboard` | Comprehensive monitoring view |
+| **AI Debugging** | `python -m crackerjack --ai-debug --run-tests` | Verbose AI debugging mode |
+| **Coverage Status** | `python -m crackerjack --coverage-status` | Show coverage ratchet progress |
+| **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 |
+
+**📑 Alphabetical Flag Reference**
+
+| Flag | Short | Description |
+|------|-------|-------------|
+| `--ai-debug` | - | Verbose debugging for AI auto-fixing |
+| `--ai-fix` | - | Enable AI-powered auto-fixing |
+| `--all` | `-a` | Full release workflow (bump, test, publish) |
+| `--benchmark` | - | Run tests in benchmark mode |
+| `--boost-coverage` | - | Auto-improve test coverage (default) |
+| `--bump` | `-b` | Bump version (patch/minor/major/auto) |
+| `--cache-stats` | - | Display cache statistics |
+| `--clear-cache` | - | Clear all caches and exit |
+| `--commit` | `-c` | Commit and push changes to Git |
+| `--comp` | - | Run only comprehensive hooks |
+| `--coverage-status` | - | Show coverage ratchet status |
+| `--dashboard` | - | Start comprehensive monitoring dashboard |
+| `--debug` | - | Enable debug output |
+| `--dev` | - | Enable development mode for monitors |
+| `--enhanced-monitor` | - | Advanced monitoring with patterns |
+| `--fast` | - | Run only fast hooks |
+| `--generate-docs` | - | Generate API documentation |
+| `--interactive` | `-i` | Use Rich UI interface |
+| `--monitor` | - | Multi-project progress monitor |
+| `--orchestrated` | - | Advanced orchestrated workflow mode |
+| `--publish` | `-p` | Bump version and publish to PyPI |
+| `--quick` | - | Quick mode (3 iterations, for CI/CD) |
+| `--restart-mcp-server` | - | Restart MCP server |
+| `--run-tests` | `-t` | Execute test suite |
+| `--skip-hooks` | `-s` | Skip pre-commit hooks |
+| `--start-mcp-server` | - | Start MCP server |
+| `--stop-mcp-server` | - | Stop MCP server |
+| `--strip-code` | `-x` | Remove docstrings/comments |
+| `--thorough` | - | Thorough mode (8 iterations) |
+| `--unified-dashboard` | - | Unified real-time dashboard |
+| `--verbose` | `-v` | Enable verbose output |
+| `--watchdog` | - | Service watchdog with auto-restart |
+
+**🔗 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
+
+______________________________________________________________________
+
 ## Command Reference
 
 **Core Workflow Commands:**

{crackerjack-0.39.6 → crackerjack-0.39.8}/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-18.4%25-red)
+![Coverage](https://img.shields.io/badge/coverage-18.0%25-red)
 
 ## 🎯 Purpose
 
@@ -186,7 +186,7 @@ python -m crackerjack.mcp.progress_monitor <job_id> ws://localhost:8675
 
 #### 🤖 Specialized Agent Architecture
 
-**9 Domain-Specific Sub-Agents** for targeted code quality improvements:
+**12 Specialized AI Agents** for comprehensive code quality improvements:
 
 - **🔒 SecurityAgent**: Fixes shell injections, weak crypto, token exposure, unsafe library usage
 - **♻️ RefactoringAgent**: Reduces complexity ≤15, extracts helper methods, applies SOLID principles
@@ -197,6 +197,9 @@ python -m crackerjack.mcp.progress_monitor <job_id> ws://localhost:8675
 - **🧪 TestCreationAgent**: Fixes test failures, missing fixtures, dependency issues
 - **📦 ImportOptimizationAgent**: Removes unused imports, restructures import statements
 - **🔬 TestSpecialistAgent**: Advanced testing scenarios, fixture management
+- **🔍 SemanticAgent**: Advanced semantic analysis, code comprehension, intelligent refactoring suggestions based on business logic understanding
+- **🏗️ ArchitectAgent**: High-level architectural patterns, design recommendations, system-level optimization strategies
+- **🎯 EnhancedProactiveAgent**: Proactive issue prevention, predictive quality monitoring, optimization before problems occur
 
 **Agent Coordination Features**:
 
@@ -643,6 +646,71 @@ python -m crackerjack --all patch
 python -m crackerjack --ai-fix
 ```
 
+## Quick Reference Index
+
+**📋 Command Index by Use Case**
+
+| Use Case | Command | Description |
+|----------|---------|-------------|
+| **Basic Quality Check** | `python -m crackerjack` | Run quality checks only |
+| **Quality + Tests** | `python -m crackerjack --run-tests` | Quality checks with test suite |
+| **AI Auto-Fix** | `python -m crackerjack --ai-fix --run-tests` | AI-powered fixing + tests (recommended) |
+| **Full Release** | `python -m crackerjack --all patch` | Version bump, quality checks, publish |
+| **Quick Publish** | `python -m crackerjack --publish patch` | Version bump + publish only |
+| **Start MCP Server** | `python -m crackerjack --start-mcp-server` | Launch MCP agent integration |
+| **Monitoring Dashboard** | `python -m crackerjack --dashboard` | Comprehensive monitoring view |
+| **AI Debugging** | `python -m crackerjack --ai-debug --run-tests` | Verbose AI debugging mode |
+| **Coverage Status** | `python -m crackerjack --coverage-status` | Show coverage ratchet progress |
+| **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 |
+
+**📑 Alphabetical Flag Reference**
+
+| Flag | Short | Description |
+|------|-------|-------------|
+| `--ai-debug` | - | Verbose debugging for AI auto-fixing |
+| `--ai-fix` | - | Enable AI-powered auto-fixing |
+| `--all` | `-a` | Full release workflow (bump, test, publish) |
+| `--benchmark` | - | Run tests in benchmark mode |
+| `--boost-coverage` | - | Auto-improve test coverage (default) |
+| `--bump` | `-b` | Bump version (patch/minor/major/auto) |
+| `--cache-stats` | - | Display cache statistics |
+| `--clear-cache` | - | Clear all caches and exit |
+| `--commit` | `-c` | Commit and push changes to Git |
+| `--comp` | - | Run only comprehensive hooks |
+| `--coverage-status` | - | Show coverage ratchet status |
+| `--dashboard` | - | Start comprehensive monitoring dashboard |
+| `--debug` | - | Enable debug output |
+| `--dev` | - | Enable development mode for monitors |
+| `--enhanced-monitor` | - | Advanced monitoring with patterns |
+| `--fast` | - | Run only fast hooks |
+| `--generate-docs` | - | Generate API documentation |
+| `--interactive` | `-i` | Use Rich UI interface |
+| `--monitor` | - | Multi-project progress monitor |
+| `--orchestrated` | - | Advanced orchestrated workflow mode |
+| `--publish` | `-p` | Bump version and publish to PyPI |
+| `--quick` | - | Quick mode (3 iterations, for CI/CD) |
+| `--restart-mcp-server` | - | Restart MCP server |
+| `--run-tests` | `-t` | Execute test suite |
+| `--skip-hooks` | `-s` | Skip pre-commit hooks |
+| `--start-mcp-server` | - | Start MCP server |
+| `--stop-mcp-server` | - | Stop MCP server |
+| `--strip-code` | `-x` | Remove docstrings/comments |
+| `--thorough` | - | Thorough mode (8 iterations) |
+| `--unified-dashboard` | - | Unified real-time dashboard |
+| `--verbose` | `-v` | Enable verbose output |
+| `--watchdog` | - | Service watchdog with auto-restart |
+
+**🔗 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
+
+______________________________________________________________________
+
 ## Command Reference
 
 **Core Workflow Commands:**