Metadata-Version: 2.4
Name: aider-lint-fixer
Version: 2.0.1
Summary: AI-powered lint error detection and fixing using aider.chat
Home-page: https://github.com/tosin2023/aider-lint-fixer
Author: Tosin Akinosho
Author-email: Aider Lint Fixer Team <tosin@decisioncrafters.com>
License: MIT
Project-URL: Homepage, https://github.com/tosin2013/aider-lint-fixer
Project-URL: Repository, https://github.com/tosin2013/aider-lint-fixer
Project-URL: Issues, https://github.com/tosin2013/aider-lint-fixer/issues
Project-URL: Documentation, https://github.com/tosin2013/aider-lint-fixer/blob/main/README.md
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: aider-chat>=0.85.0
Requires-Dist: click>=8.0.0
Requires-Dist: colorama>=0.4.0
Requires-Dist: pyyaml>=6.0.0
Requires-Dist: pathlib2>=2.3.0; python_version < "3.4"
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: pytest-mock>=3.10.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: isort>=5.12.0; extra == "dev"
Requires-Dist: flake8>=6.0.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Requires-Dist: pre-commit>=3.0.0; extra == "dev"
Requires-Dist: coverage>=7.0.0; extra == "dev"
Requires-Dist: mock>=4.0.0; extra == "dev"
Requires-Dist: responses>=0.23.0; extra == "dev"
Provides-Extra: linters
Requires-Dist: flake8>=7.3.0; extra == "linters"
Requires-Dist: pylint>=3.3.0; extra == "linters"
Requires-Dist: ansible-lint>=25.6.0; extra == "linters"
Provides-Extra: learning
Requires-Dist: scikit-learn>=1.0.0; extra == "learning"
Requires-Dist: requests>=2.25.0; extra == "learning"
Requires-Dist: beautifulsoup4>=4.9.0; extra == "learning"
Requires-Dist: pyahocorasick>=1.4.0; extra == "learning"
Provides-Extra: progress
Requires-Dist: tqdm>=4.64.0; extra == "progress"
Provides-Extra: community
Provides-Extra: all
Requires-Dist: flake8>=7.3.0; extra == "all"
Requires-Dist: pylint>=3.3.0; extra == "all"
Requires-Dist: ansible-lint>=25.6.0; extra == "all"
Requires-Dist: scikit-learn>=1.0.0; extra == "all"
Requires-Dist: requests>=2.25.0; extra == "all"
Requires-Dist: beautifulsoup4>=4.9.0; extra == "all"
Requires-Dist: pyahocorasick>=1.4.0; extra == "all"
Requires-Dist: tqdm>=4.64.0; extra == "all"
Dynamic: author
Dynamic: home-page
Dynamic: requires-python

# Aider Lint Fixer

[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)

**Automated lint error detection and fixing powered by aider.chat and AI**

Aider Lint Fixer is an intelligent tool that automatically detects lint errors in your codebase and fixes them using AI-powered code generation through [aider.chat](https://aider.chat).

## 🎉 **v2.0.0 Release: AI-Powered Intelligence & Enterprise Infrastructure**

### 🚀 **New in v2.0.0 - Major Release**
- 🧠 **AI-Powered Intelligence**: Native lint detection, pre-lint risk assessment, and ML-driven force mode
- 🔗 **Deep Code Analysis**: AST-based dependency analysis, control flow tracking, and structural analysis
- 🐳 **Enterprise Containers**: Production-ready Docker infrastructure with multi-architecture support
- 💰 **Cost Management**: Built-in LLM API cost monitoring and budget controls
- 📈 **Massive Scale**: Handle codebases with 1000+ files and complex architectural patterns

## ✨ **Features**

### 🧠 **New AI-Powered Intelligence (v2.0.0)**
- 🔍 **Native Lint Detection**: Automatically discovers and integrates with your project's existing lint configurations
- ⚠️ **Pre-Lint Risk Assessment**: Analyzes codebase health before attempting automated fixes
- 🤖 **Intelligent Force Mode**: ML-powered force mode with confidence-based auto-forcing and intelligent batching
- 💰 **Cost Monitoring**: Real-time tracking and control of LLM API costs with budget limits
- 🔗 **AST-Based Analysis**: Deep structural and dependency analysis for better fix quality
- 📊 **Advanced Analytics**: Control flow tracking, convergence analysis, and comprehensive metrics

### 📊 **Enhanced Interactive Mode & Progress Tracking (v1.8.0)**
- 🎯 **Enhanced Interactive Mode**: Per-error review with override capabilities for "unfixable" errors
- 📊 **Progress Tracking**: Visual progress bars and real-time metrics for 100+ error projects
- ⚡ **Session Recovery**: Resume interrupted sessions with `--resume-session`
- 🔧 **Force Mode**: Override all classifications with safety confirmations
- 🌍 **Community Learning**: User choices improve future error classifications
- 📈 **Performance Metrics**: Files/min, errors/min, success rates, and ETA calculations
- 💾 **Progress Persistence**: Automatic saving and recovery for long-running operations

### 🧠 **Intelligent Learning System (v1.7.0+)**
- 🧠 **Enhanced Learning**: 46.1% fixability rate (up from 0.0% in previous versions)
- ⚡ **High-Performance**: Aho-Corasick pattern matching for sub-millisecond classification
- 🎯 **TypeScript Projects**: Smart ESLint integration with project-specific configurations
- 📦 **Easy Setup**: `pip install aider-lint-fixer[learning]` includes all dependencies
- 🔍 **Auto-Detection**: Automatically detects `.eslintrc.js`, `tsconfig.json`, npm scripts
- 📊 **392+ Rules**: Auto-scraped from official linter documentation

### 🛠️ **Core Features**
- 🐍 **Python Support**: Flake8, Pylint with profile support (basic/strict)
- 🟨 **Node.js Support**: ESLint, JSHint, Prettier with comprehensive error detection
- 📋 **Ansible Support**: ansible-lint with production-ready profiles
- 🤖 **AI-Powered Fixing**: Uses aider.chat with multiple LLM providers
- 🎯 **Smart Error Analysis**: Categorizes and prioritizes errors for optimal fixing
- 🏢 **Enterprise Scalability**: Handles 200+ lint issues with intelligent batching
- ⚙️ **Profile System**: Basic (development) vs Strict (production) configurations
- 📊 **Enhanced Progress Tracking**: Visual progress bars for large projects (100+ errors)
- 🎮 **Interactive Modes**: Standard and enhanced interactive error review
- 💾 **Session Management**: Save, resume, and recover interrupted operations

## 📅 **Version History**

| Version | Release Date | Key Features |
|---------|-------------|--------------|
| **v2.0.0** | 2025-08 | AI-Powered Intelligence, Deep Code Analysis, Enterprise Infrastructure |
| **v1.9.0** | 2025-08 | Community Issue Reporting, Docker Support, Pre-built Images |
| **v1.8.0** | 2025-07 | Enhanced Interactive Mode, Progress Tracking, Session Recovery |
| **v1.7.0** | 2025-06 | Learning System, Aho-Corasick Pattern Matching, TypeScript Support |
| **v1.6.0** | 2025-05 | Multi-linter Support, Profile System, Performance Improvements |

## 📋 **Supported Linter Versions**

### **Ansible Linters**
| Linter | Tested Version | Supported Versions | Profile Support |
|--------|----------------|-------------------|-----------------|
| **ansible-lint** | `25.6.1 / 6.22.2 / 24.12.2` | All versions via ANSIBLE_LINT_VERSION | ✅ basic, production |

### **Python Linters**
| Linter | Tested Version | Supported Versions | Profile Support |
|--------|----------------|-------------------|-----------------|
| **flake8** | `7.3.0` | `7.3.0`, `7.2.x`, `7.1.x`, `7.0.x`, `6.x` | ✅ basic, strict |
| **pylint** | `3.3.7` | `3.3.7`, `3.3.x`, `3.2.x`, `3.1.x`, `3.0.x`, `2.x` | ✅ basic, strict |

### **Node.js Linters**
| Linter | Tested Version | Supported Versions | Profile Support |
|--------|----------------|-------------------|-----------------|
| **ESLint** | `8.57.1` | `8.57.1`, `8.57.x`, `8.5.x`, `8.x`, `7.x` | ✅ basic, strict |
| **JSHint** | `2.13.6` | `2.13.6`, `2.13.x`, `2.1.x`, `2.x` | ✅ basic, strict |
| **Prettier** | `3.6.2` | `3.6.2`, `3.6.x`, `3.x`, `2.x` | ✅ basic, strict |

### **Version Compatibility Notes**
- **Tested Version**: Explicitly tested and validated in our CI/CD
- **Supported Versions**: Expected to work based on API compatibility
- **Profile Support**: Configurable strictness levels for different environments

### **🏢 Enterprise & RHEL Compatibility**

**Ansible-lint Multi-Version Support** addresses the major version compatibility issues between enterprise environments and the latest container versions:

| Environment | ansible-lint | ansible-core | Usage |
|-------------|--------------|--------------|-------|
| **Latest (Technology Preview)** | 25.6.1 | 2.19.0 | `ANSIBLE_LINT_VERSION=latest` |
| **Enterprise/RHEL 9** | 6.22.2 | 2.15.13 | `ANSIBLE_LINT_VERSION=enterprise` |
| **RHEL 10 Compatible** | 24.12.2 | 2.18.8 | `ANSIBLE_LINT_VERSION=rhel10` |

**Why This Matters:**
- **RHEL 10 Incompatibility**: ansible-core 2.19 is NOT supported on RHEL 10
- **Enterprise Standards**: Many organizations standardize on ansible-lint 6.x
- **Consistency**: Ensures results match your local development environment

**Container Usage Examples:**
```bash
# Use enterprise-compatible version (default for RHEL environments)
podman run -e ANSIBLE_LINT_VERSION=enterprise \
  -v $(pwd):/workspace:Z quay.io/takinosh/aider-lint-fixer

# Use RHEL 10 compatible version
podman run -e ANSIBLE_LINT_VERSION=rhel10 \
  -v $(pwd):/workspace:Z quay.io/takinosh/aider-lint-fixer

# Use latest version (Technology Preview only)
podman run -e ANSIBLE_LINT_VERSION=latest \
  -v $(pwd):/workspace:Z quay.io/takinosh/aider-lint-fixer
```

## 🚀 Quick Start

### Prerequisites

- Python 3.11+
- [aider.chat](https://aider.chat) installed (`pip install aider-chat`)
- DeepSeek API key from [platform.deepseek.com](https://platform.deepseek.com/)

### Installation

#### Option 1: Docker (Recommended for CI/CD)
```bash
# Use pre-built Docker image from quay.io
docker run --rm -v $(pwd):/workspace:ro quay.io/takinosh/aider-lint-fixer:latest --help

# Or use with the convenience script
./scripts/containers/docker-run.sh --linters flake8,eslint
```

#### Option 2: PyPI Package
```bash
# Install aider-lint-fixer with enhanced learning features (quote for zsh compatibility)
pip install "aider-lint-fixer[learning]"
```

### 🚀 **Installation**

#### **Prerequisites**
- **Python 3.11 or higher**
- **Git**
- **pip3** (usually included with Python)
- **Node.js/npm** (for Node.js linters)
- **Supported platforms**: Linux, macOS (Windows has limited support)

#### **📦 Quick Installation (PyPI)**

```bash
# Install from PyPI (recommended)
pip install aider-lint-fixer

# Latest v1.9.0: Install with community issue reporting and enhanced workflows
pip install aider-lint-fixer[community]

# 📊 v1.8.0: Install with enhanced interactive and progress tracking
pip install aider-lint-fixer[progress]

# 🧠 v1.7.0: Install with learning features (recommended for 46.1% fixability rate)
pip install aider-lint-fixer[learning]

# Install with all optional features (includes community + progress + learning)
pip install aider-lint-fixer[all]

# Verify installation
aider-lint-fixer --version
```

#### **🔧 Development Installation (Git + Virtual Environment)**

##### **1. Clone and Set Up Virtual Environment**
```bash
# Clone the repository
git clone https://github.com/tosin2013/aider-lint-fixer.git
cd aider-lint-fixer

# Create virtual environment
python3 -m venv venv

# Activate virtual environment (Linux/macOS)
source venv/bin/activate

# Upgrade pip
pip3 install --upgrade pip
```

##### **2. Install aider-lint-fixer**
```bash
# Install in development mode (recommended for latest features)
pip3 install -e .

# Install dependencies
pip3 install -r requirements.txt
```

##### **3. Install Required Linters**
```bash
# Python linters
pip3 install flake8==7.3.0 pylint==3.3.7

# Ansible linters
pip3 install ansible-lint==25.6.1

# Node.js linters (requires Node.js/npm)
npm install -g eslint@8.57.1 jshint@2.13.6 prettier@3.6.2
```

##### **4. Verify Installation**
```bash
# Check version
python3 -m aider_lint_fixer --version

# Check supported linters
./scripts/check_supported_versions.sh
```

#### **🐳 Alternative Installation Methods**

##### **Install from Git (Latest Development)**
```bash
# Install directly from Git (latest development version)
pip install git+https://github.com/tosin2013/aider-lint-fixer.git

# With virtual environment (recommended for development)
python3 -m venv aider-env && source aider-env/bin/activate && pip install git+https://github.com/tosin2013/aider-lint-fixer.git
```

##### **Install from Source (Development)**
```bash
git clone https://github.com/tosin2013/aider-lint-fixer.git
cd aider-lint-fixer
python3 -m venv venv && source venv/bin/activate
pip3 install -e .
```

#### **⚡ Quick Start (5 Minutes)**

```bash
# 1. Clone and setup
git clone https://github.com/tosin2013/aider-lint-fixer.git
cd aider-lint-fixer
python3 -m venv venv && source venv/bin/activate

# 2. Install
pip3 install -e . && pip3 install -r requirements.txt

# 3. Install linters (choose your language)
pip3 install flake8==7.3.0 pylint==3.3.7 ansible-lint==25.6.1
npm install -g eslint@8.57.1 jshint@2.13.6 prettier@3.6.2

# 4. Setup environment
cp .env.example .env
# Edit .env and add your API key

# 5. Test installation
python3 -m aider_lint_fixer --help
```

### **🔧 Environment Setup**

#### **API Key Configuration**
```bash
# Run the setup script (recommended)
./setup_env.sh

# Or manually create .env file
cp .env.example .env
# Edit .env and add your DeepSeek API key
# DEEPSEEK_API_KEY=your_actual_api_key_here

# Export environment variables
export $(cat .env | grep -v '^#' | xargs)
```

#### **Verify Your Setup**
```bash
# Check all supported linter versions
./scripts/check_supported_versions.sh

# Test with a sample project
python3 -m aider_lint_fixer . --linters flake8 --dry-run --verbose
```

#### **🔧 Troubleshooting Installation**

##### **Common Issues and Solutions**

**1. Python Version Issues**
```bash
# Check Python version
python3 --version  # Should be 3.11+

# If python3 not found, try:
python --version   # On some systems
```

**2. Virtual Environment Issues**
```bash
# If venv creation fails:
sudo apt-get install python3-venv  # Ubuntu/Debian
brew install python3               # macOS

# Alternative virtual environment tools:
pip3 install virtualenv
virtualenv venv
```

**3. Permission Issues**
```bash
# If pip install fails with permissions:
pip3 install --user -e .

# Or use virtual environment (recommended):
python3 -m venv venv && source venv/bin/activate
```

**4. Node.js Linter Issues**
```bash
# Install Node.js if missing:
# Ubuntu/Debian:
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

# macOS:
brew install node

# Verify installation:
node --version && npm --version
```

**5. Linter Version Conflicts**
```bash
# Check current versions:
./scripts/check_supported_versions.sh

# Install specific versions:
pip3 install flake8==7.3.0 --force-reinstall
npm install -g eslint@8.57.1 --force
```

##### **Getting Help**
- **Complete installation guide**: See [`docs/INSTALLATION_GUIDE.md`](docs/INSTALLATION_GUIDE.md)
- **Automated installation**: Run `curl -fsSL https://raw.githubusercontent.com/tosin2013/aider-lint-fixer/main/scripts/install.sh | bash`
- **Check supported versions**: `./scripts/check_supported_versions.sh`
- **Verbose output**: Add `--verbose` to any command
- **Debug mode**: Set `DEBUG=1` environment variable
- **Issues**: Report at [GitHub Issues](https://github.com/tosin2013/aider-lint-fixer/issues)

### Basic Usage

```bash
# Test on a small project first
python -m aider_lint_fixer /path/to/your/project --max-files 1

# Run on your project
python -m aider_lint_fixer /path/to/your/project

# Limit scope for large projects
python -m aider_lint_fixer /path/to/your/project --max-files 5 --max-errors 10

# Verbose output for debugging
python -m aider_lint_fixer /path/to/your/project --verbose
```

### 🌍 Community Issue Reporting (v1.9.0)

Transform your successful fixes into community improvements:

```bash
# Enhanced interactive mode with community reporting
aider-lint-fixer --enhanced-interactive --linters ansible-lint

# After successful overrides, system prompts:
# "Would you like to help improve the system by creating community issues?"
# Browser opens with pre-filled GitHub issue for community benefit
```

**Community Features:**
- 🎯 **Automatic issue generation**: Successful override patterns become GitHub issues
- 🌍 **Community learning**: Your fixes help improve classification for everyone
- 📊 **Pattern analysis**: System identifies errors that should be reclassified
- 🚀 **One-click contribution**: Pre-filled GitHub issues with detailed analysis
- 📈 **Continuous improvement**: Higher automatic fix rates through shared knowledge

### 🎯 Enhanced Interactive Mode (v1.8.0)

Perfect for reviewing and overriding error classifications:

```bash
# Enhanced interactive mode - review each error individually
python -m aider_lint_fixer --enhanced-interactive --linters ansible-lint

# Force mode - attempt to fix ALL errors (use with caution)
python -m aider_lint_fixer --force --linters flake8

# Standard interactive mode - confirm before starting
python -m aider_lint_fixer --interactive --linters pylint
```

**Enhanced Interactive Features:**
- 🎯 **Per-error decisions**: Fix, skip, or abort for each error
- ⚠️ **Override "unfixable" errors**: With proper warnings and confirmations
- 🌍 **Community learning**: Your choices improve future classifications
- 📊 **Confidence scoring**: Rate your confidence to help the learning system

### 📊 Progress Tracking for Large Projects (v1.8.0)

Automatic enhanced tracking for projects with 100+ lint errors:

```bash
# Large projects automatically get enhanced progress tracking
python -m aider_lint_fixer --linters ansible-lint  # 100+ errors detected

# Install with progress tracking support
pip install aider-lint-fixer[progress]

# Session management
python -m aider_lint_fixer --list-sessions
python -m aider_lint_fixer --resume-session progress_1234567890
```

**Progress Tracking Features:**
- 📊 **Visual progress bars**: Real-time file and error progress
- ⚡ **Performance metrics**: Files/min, errors/min, success rates
- 🕐 **Time estimation**: ETA calculations for completion
- 💾 **Session persistence**: Automatic saving and recovery
- 🔄 **Resume capability**: Continue interrupted operations

**Example Output for Large Projects:**
```
🚀 Large Project Detected (250 errors)
📁 Files: ████████████████████████████████████████ 8/10 [80%]
🔧 Errors: ████████████████████████████████████████ 200/250 [80%]

⚡ Real-time Status:
   Processing rate: 2.5 files/min, 62.5 errors/min
   Success rate: 85.2% (213/250)
   ETA: 14:32:15
```

## 📋 Supported Linters

### Python
- **flake8** - Style guide enforcement
- **pylint** - Code analysis and quality
- **black** - Code formatting
- **isort** - Import sorting
- **mypy** - Type checking

### JavaScript/TypeScript
- **eslint** - Linting and code quality
- **prettier** - Code formatting

### Go
- **golint** - Go linting
- **gofmt** - Go formatting
- **go vet** - Static analysis

### Rust
- **rustfmt** - Rust formatting
- **clippy** - Rust linting

### Ansible
- **ansible-lint** - Ansible playbook linting

## ⚙️ Configuration

Create a `.aider-lint-fixer.yml` file in your project root:

```yaml
# LLM Configuration
llm:
  provider: "deepseek"  # Options: deepseek, openrouter, ollama
  model: "deepseek/deepseek-chat"
  fallback_providers:
    - "openrouter"
    - "ollama"

# Linter Configuration
linters:
  auto_detect: true
  enabled:
    - flake8
    - eslint
    - golint
    - rustfmt
    - ansible-lint

# Aider Configuration
aider:
  auto_commit: false
  backup_files: true
  max_retries: 3

# Project Settings
project:
  exclude_patterns:
    - "*.min.js"
    - "node_modules/"
    - "__pycache__/"
    - ".git/"
```

## 🎯 Command Line Options

```bash
python -m aider_lint_fixer [PROJECT_PATH] [OPTIONS]

Options:
  --config, -c PATH       Path to configuration file
  --llm TEXT             LLM provider (deepseek, openrouter, ollama)
  --model TEXT           Specific model to use
  --linters TEXT         Comma-separated list of linters to run
  --max-files INTEGER    Maximum number of files to process
  --max-errors INTEGER   Maximum errors to fix per file
  --dry-run              Show what would be fixed without making changes
  --interactive          Confirm each fix before applying
  --verbose, -v          Enable verbose output
  --log-file PATH        Path to log file
  --no-banner            Disable banner output
  --help                 Show this message and exit
  --stats                Show learning statistics and exit
```

## 🧠 Learning Features

### **Intelligent Error Classification**

Aider-lint-fixer includes an advanced learning system that improves accuracy over time by learning from successful and failed fix attempts.

#### **📦 Installation for Learning**
```bash
# Install with learning features (includes scikit-learn)
pip install aider-lint-fixer[learning]

# Or install learning dependencies manually
pip install scikit-learn>=1.0.0 requests>=2.25.0 beautifulsoup4>=4.9.0 pyahocorasick>=1.4.0
```

#### **🔍 How Learning Works**
- **Automatic**: Learning happens automatically during normal operation
- **No configuration needed**: Works out of the box once dependencies are installed
- **Language-specific**: Separate models for Python, JavaScript, Ansible, etc.
- **Persistent**: Learning data survives between runs

#### **📊 Monitor Learning Progress**
```bash
# View learning statistics
aider-lint-fixer --stats

# View in JSON format
aider-lint-fixer --stats --output-format json

# Detailed cache management
python -m aider_lint_fixer.cache_cli --action stats
```

#### **🎯 Learning Benefits**
- **Improved Accuracy**: 46.1% fixability rate on real projects
- **Faster Classification**: Sub-millisecond error analysis
- **Project-Specific**: Learns patterns specific to your codebase
- **Conservative Approach**: Avoids false positives

#### **📁 Learning Data Storage**
Learning data is stored in `.aider-lint-cache/`:
```
.aider-lint-cache/
├── ansible_training.json     # Ansible-specific learning
├── python_training.json      # Python-specific learning
├── javascript_training.json  # JavaScript-specific learning
└── scraped_rules.json       # Web-scraped rule knowledge
```

#### **🧹 Cache Management**
```bash
# Clean old learning data (30+ days)
python -m aider_lint_fixer.cache_cli --action cleanup --max-age-days 30

# Export learning data for backup
python -m aider_lint_fixer.cache_cli --action export --file backup.json

# Import learning data from backup
python -m aider_lint_fixer.cache_cli --action import --file backup.json
```

#### **🔧 Troubleshooting Learning Issues**

**Problem: "Found 0 fixable errors (0.0% of X total baseline errors)"**

This usually indicates missing learning dependencies. Check your setup:

```bash
# Quick diagnosis
python scripts/check_learning_setup.py

# Or check via stats
aider-lint-fixer --stats
```

**Common Issues:**
- **Missing scikit-learn**: `pip install aider-lint-fixer[learning]`
- **Missing Aho-Corasick**: Causes "using fallback pattern matching" warning
- **No scraped rules**: Tool will auto-create them if web dependencies are available

**Expected vs Actual (v1.7.0):**
```bash
# ❌ Without learning dependencies (v1.6.0 and earlier)
Found 0 fixable errors (0.0% of 58 total baseline errors)

# ✅ With learning dependencies (v1.7.0+)
Found 27 fixable errors (46.1% of 58 total baseline errors)
```

**🎯 v1.7.0 Performance**: This release resolves the critical 0.0% fixability issue!

## 📖 Examples

### Python Project
```bash
# Focus on Python linters
python -m aider_lint_fixer --linters flake8,black,isort

# Fix formatting issues only
python -m aider_lint_fixer --linters black,isort --max-errors 20
```

### JavaScript Project
```bash
# Focus on JavaScript linters
python -m aider_lint_fixer --linters eslint,prettier

# Interactive fixing for complex project
python -m aider_lint_fixer --linters eslint --interactive
```

### Ansible Project
```bash
# Focus on Ansible linting
python -m aider_lint_fixer --linters ansible-lint

# Dry run to see Ansible issues
python -m aider_lint_fixer --linters ansible-lint --dry-run

# Enhanced interactive mode for Ansible (v1.8.0)
python -m aider_lint_fixer --enhanced-interactive --linters ansible-lint
```

### Large Project Examples (v1.8.0)
```bash
# Large project with automatic progress tracking
python -m aider_lint_fixer --linters flake8,pylint  # 100+ errors

# Force mode for aggressive fixing (use with caution)
python -m aider_lint_fixer --force --max-errors 50 --linters eslint

# Resume interrupted session
python -m aider_lint_fixer --list-sessions
python -m aider_lint_fixer --resume-session progress_1234567890

# Enhanced interactive with progress tracking
python -m aider_lint_fixer --enhanced-interactive --linters ansible-lint
```

### Community Contribution Examples (v1.9.0)
```bash
# Override "unfixable" errors and contribute to community
python -m aider_lint_fixer --enhanced-interactive --linters ansible-lint
# → Override yaml[trailing-spaces] classification
# → System records successful fix pattern
# → Prompts to create GitHub issue for community benefit

# Example community workflow:
# 1. User overrides "unfixable" error → Success
# 2. System analyzes pattern → Identifies improvement opportunity
# 3. GitHub issue generated → "Enhancement: Improve ansible-lint yaml[trailing-spaces] classification"
# 4. Community benefits → Higher automatic fix rates for everyone

# Install with community features
pip install aider-lint-fixer[community]
```

## 🔧 How It Works

1. **Project Detection**: Automatically scans your project to identify languages, package managers, and lint configurations
2. **Lint Execution**: Runs appropriate linters and collects error reports
3. **Error Analysis**: Categorizes errors by type and complexity, prioritizes them for fixing
4. **AI-Powered Fixing**: Uses aider.chat with your chosen LLM to generate and apply fixes
5. **Verification**: Re-runs linters to verify fixes and reports success rates
6. **Community Learning** (v1.9.0): Records successful overrides and generates GitHub issues to improve the system for everyone

## 🛠️ Development

This project includes a comprehensive Makefile for development tasks:

```bash
# Show all available commands
make help

# Setup development environment
make dev-setup

# Code quality checks
make lint          # Run linters
make format        # Format code with black and isort
make type-check    # Run mypy type checking

# Testing
make test          # Run tests
make test-coverage # Run tests with coverage

# Security
make security      # Run security checks
make audit         # Comprehensive security audit

# Build and package
make build         # Build distribution packages
make clean         # Clean build artifacts

# Self-testing (test the tool on itself!)
make self-test     # Run aider-lint-fixer on its own code

# Complete quality assurance
make qa            # Run all quality checks
make ci            # Full CI pipeline
```

## 🤖 Automated Dependency Management

This project uses **Dependabot** for automated dependency updates and security monitoring:

### 📅 Update Schedule
- **Python dependencies**: Weekly (Mondays) - `pip` ecosystem
- **Node.js dependencies**: Weekly (Tuesdays) - `npm` ecosystem
- **GitHub Actions**: Weekly (Wednesdays) - Workflow dependencies
- **Docker images**: Weekly (Thursdays) - Base image updates
- **Security updates**: **Immediate** - Critical vulnerabilities

### 🔄 Auto-Merge Policy
- ✅ **Security updates**: Auto-merged after tests pass
- ✅ **Patch updates**: Auto-merged after validation
- ✅ **Testing dependencies**: Auto-merged (pytest, coverage, mock)
- ✅ **Code quality tools**: Auto-merged (black, isort, flake8, mypy)
- ✅ **GitHub Actions**: Auto-merged (actions/*, github/*)
- ⚠️ **Major updates**: Require manual review
- ⚠️ **Core dependencies**: Require manual review (aider-chat, click)

### 🔍 Weekly Health Checks (Sundays)
- **🔒 Security audit**: Vulnerability scanning with `safety`, `bandit`, `pip-audit`
- **📅 Outdated dependencies**: Tracking and automated PR creation
- **📄 License compliance**: Monitoring for license compatibility
- **🔍 Dependency conflicts**: Detecting version incompatibilities

### 🛡️ Security Features
- **Immediate security alerts**: Critical vulnerabilities trigger instant PRs
- **Automated testing**: All updates tested before merge
- **License monitoring**: GPL and unknown licenses flagged
- **Conflict detection**: Dependency version conflicts identified

## 🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

### 🔧 **Development Setup for Contributors**

#### **Quick Setup**
```bash
# Automated installation for contributors
curl -fsSL https://raw.githubusercontent.com/tosin2013/aider-lint-fixer/main/scripts/install.sh | bash

# Or manual setup
git clone https://github.com/tosin2013/aider-lint-fixer.git
cd aider-lint-fixer
python3 -m venv venv && source venv/bin/activate
pip3 install -e . && pip3 install -r requirements.txt
```

#### **Install Supported Linter Versions**
```bash
# Check your current versions
./scripts/check_supported_versions.sh

# Install supported versions
pip3 install flake8==7.3.0 pylint==3.3.7 ansible-lint==25.6.1
npm install -g eslint@8.57.1 jshint@2.13.6 prettier@3.6.2
```

### 📋 **Version Testing**
```bash
# Test Python linters
./scripts/version_tests/python_linters_test.sh

# Test Node.js linters
./scripts/version_tests/nodejs_linters_test.sh

# Run integration tests
python -m pytest tests/ -v
```

### 📚 **Version Reference**
- **Supported Versions**: See table above or `aider_lint_fixer/supported_versions.py`
- **Testing Guide**: `docs/LINTER_TESTING_GUIDE.md`
- **Node.js Guide**: `docs/NODEJS_LINTERS_GUIDE.md`

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## 👨‍💻 Author

**Tosin Akinosho**
- GitHub: [@tosin2023](https://github.com/tosin2023)
- Project: [aider-lint-fixer](https://github.com/tosin2023/aider-lint-fixer)

## 🙏 Acknowledgments

- [aider.chat](https://aider.chat) for the amazing AI-powered code editing capabilities
- The open-source community for the various linters and tools that make this project possible
- All the LLM providers (DeepSeek, OpenRouter, Ollama) for making AI accessible

## 📚 Documentation

For detailed usage instructions, configuration options, and troubleshooting, see:
- [Usage Guide](Aider%20Lint%20Fixer%20-%20Usage%20Guide.md)
- [Complete Solution Documentation](Aider%20Lint%20Fixer%20-%20Complete%20Solution%20Delivery.md)

---

**Made with ❤️ by Tosin Akinosho**
