codeshift 0.3.5__py3-none-any.whl → 0.3.6__py3-none-any.whl

codeshift-0.3.6.dist-info/METADATA

@@ -0,0 +1,473 @@
+Metadata-Version: 2.4
+Name: codeshift
+Version: 0.3.6
+Summary: AI-powered CLI tool that migrates Python code to handle breaking dependency changes
+Author: PyResolve Team
+License: MIT
+Project-URL: Homepage, https://github.com/Ragab-Technologies/Codeshift
+Project-URL: Repository, https://github.com/Ragab-Technologies/Codeshift
+Project-URL: Issues, https://github.com/Ragab-Technologies/Codeshift/issues
+Keywords: migration,dependencies,ast,refactoring,pydantic
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0
+Requires-Dist: libcst>=1.0
+Requires-Dist: anthropic>=0.20
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0
+Requires-Dist: toml>=0.10
+Requires-Dist: packaging>=23.0
+Requires-Dist: httpx>=0.25
+Requires-Dist: pytest>=8.4.2
+Requires-Dist: nox>=2025.11.12
+Requires-Dist: black>=24.10.0
+Requires-Dist: mypy>=1.19.1
+Requires-Dist: supabase>=2.27.2
+Requires-Dist: pre-commit>=4.5.1
+Provides-Extra: api
+Requires-Dist: fastapi>=0.109.0; extra == "api"
+Requires-Dist: uvicorn>=0.27.0; extra == "api"
+Requires-Dist: supabase>=2.3.0; extra == "api"
+Requires-Dist: stripe>=7.0.0; extra == "api"
+Requires-Dist: pydantic-settings>=2.1.0; extra == "api"
+Requires-Dist: email-validator>=2.0.0; extra == "api"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: black<25.0,>=24.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Requires-Dist: nox>=2024.0; extra == "dev"
+Requires-Dist: pre-commit>=3.6.0; extra == "dev"
+Requires-Dist: types-toml>=0.10; extra == "dev"
+Requires-Dist: types-PyYAML>=6.0; extra == "dev"
+Provides-Extra: all
+Requires-Dist: codeshift[api,dev]; extra == "all"
+Dynamic: license-file
+
+# Codeshift
+
+[![CI](https://github.com/Ragab-Technologies/Codeshift/actions/workflows/ci.yml/badge.svg)](https://github.com/Ragab-Technologies/Codeshift/actions/workflows/ci.yml)
+[![PyPI version](https://badge.fury.io/py/codeshift.svg)](https://pypi.org/project/codeshift/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+**Don't just flag the update. Fix the break.**
+
+Codeshift is an AI-powered CLI tool that migrates Python code when dependencies are upgraded. Unlike Dependabot or Renovate which only bump version numbers, Codeshift rewrites your code to be compatible with new library APIs.
+
+## Why Codeshift?
+
+Upgrading a dependency often means updating dozens of call sites to match a new API. Codeshift automates that:
+
+- **Scans** your project for outdated dependencies
+- **Detects** breaking changes from changelogs and migration guides
+- **Rewrites** your code using deterministic AST transforms or LLM assistance
+- **Shows** a detailed diff with explanations before touching any file
+
+## Features
+
+- **Deterministic AST transforms** for 15 popular libraries (no LLM required)
+- **Auto-generated knowledge bases** - fetches changelogs and migration guides from GitHub, parses them with an LLM to detect breaking changes
+- **Tiered migration engine** - deterministic transforms first, KB-guided LLM second, pure LLM fallback last
+- **Confidence-based change detection** - shows HIGH/MEDIUM/LOW confidence breaking changes before migration
+- **Beautiful diff output** with per-change explanations
+- **Backup and restore** so you can safely revert
+- **Batch upgrades** - migrate all outdated dependencies in one command
+
+## Supported Libraries
+
+### Tier 1 (Deterministic AST Transforms - Free, No LLM Required)
+
+| Library | Migration Path | Status |
+|---------|---------------|--------|
+| Pydantic | v1 → v2 | Supported |
+| FastAPI | 0.x → 0.100+ | Supported |
+| SQLAlchemy | 1.4 → 2.0 | Supported |
+| Pandas | 1.x → 2.x | Supported |
+| Requests | Various | Supported |
+| Django | 3.x → 4.x/5.x | Supported |
+| Flask | 1.x → 2.x/3.x | Supported |
+| NumPy | 1.x → 2.x | Supported |
+| attrs | attr → attrs | Supported |
+| Celery | 4.x → 5.x | Supported |
+| Click | 7.x → 8.x | Supported |
+| aiohttp | 2.x → 3.x | Supported |
+| httpx | 0.x → 0.24+ | Supported |
+| Marshmallow | 2.x → 3.x | Supported |
+| pytest | 6.x → 7.x/8.x | Supported |
+
+### Any Library (Auto-Generated Knowledge Base)
+
+Codeshift can migrate **any Python library** by automatically fetching changelogs from GitHub and detecting breaking changes. For libraries not in Tier 1, it uses KB-guided or pure LLM migration.
+
+## Installation
+
+```bash
+pip install codeshift
+```
+
+For development:
+
+```bash
+pip install codeshift[dev]
+```
+
+Verify the installation:
+
+```bash
+codeshift --help
+```
+
+## Quick Start
+
+```bash
+# 1. Scan your project for outdated dependencies
+codeshift scan
+
+# 2. Upgrade a specific library
+codeshift upgrade pydantic --target 2.5.0
+
+# 3. Review the proposed changes
+codeshift diff
+
+# 4. Apply the changes
+codeshift apply
+
+# 5. Run your tests to verify
+pytest
+```
+
+Or upgrade everything at once:
+
+```bash
+codeshift upgrade-all
+```
+
+### Example Output
+
+```
+$ codeshift upgrade pydantic --target 2.5.0
+
+╭──────────────────────── Codeshift Migration ─────────────────────────╮
+│ Upgrading Pydantic to version 2.5.0                                  │
+│ Migration guide: https://docs.pydantic.dev/latest/migration/         │
+╰──────────────────────────────────────────────────────────────────────╯
+
+Fetching knowledge sources...
+   ✓ GitHub: CHANGELOG.md
+   ✓ GitHub: docs/migration.md
+
+Breaking changes detected:
+
+   HIGH CONFIDENCE:
+   ├── .dict() → .model_dump()
+   ├── @validator → @field_validator
+   └── class Config → model_config = ConfigDict()
+
+   MEDIUM CONFIDENCE:
+   ├── .json() → .model_dump_json()
+   └── parse_obj() → model_validate()
+
+Scanning for library usage...
+Found 12 imports from pydantic
+Found 45 usages of pydantic symbols
+
+┏━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━┓
+┃ File               ┃ Changes ┃ Status ┃
+┡━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━╇━━━━━━━━┩
+│ src/models/user.py │       5 │ Ready  │
+│ src/api/schemas.py │       3 │ Ready  │
+└────────────────────┴─────────┴────────┘
+
+Total: 8 changes across 2 files
+```
+
+## Commands
+
+### `codeshift scan`
+
+Scan your project for outdated dependencies and available migrations.
+
+```bash
+codeshift scan [OPTIONS]
+
+Options:
+  --path, -p PATH       Path to scan (default: current directory)
+  --fetch-changes       Fetch changelogs and detect breaking changes
+  --major-only          Only show major version upgrades
+  --json-output         Output results as JSON
+  --verbose, -v         Show detailed output
+```
+
+Example:
+
+```
+$ codeshift scan
+
+Found 13 dependencies
+
+Outdated Dependencies (5)
+┏━━━━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━┳━━━━━━━┳━━━━━━━━━━┓
+┃ Package    ┃ Current ┃ Latest ┃ Type  ┃   Tier   ┃
+┡━━━━━━━━━━━━╇━━━━━━━━━╇━━━━━━━━╇━━━━━━━╇━━━━━━━━━━┩
+│ pydantic   │     1.0 │  2.5.0 │ Major │  Tier 1  │
+│ rich       │    13.0 │ 14.0.0 │ Major │ Tier 2/3 │
+└────────────┴─────────┴────────┴───────┴──────────┘
+
+Suggested Migrations (2)
+  pydantic 1.0 → 2.5.0 (Tier 1 - deterministic)
+  rich 13.0 → 14.0.0 (Tier 2/3 - LLM-assisted)
+
+Quick commands:
+  codeshift upgrade pydantic --target 2.5.0
+  codeshift upgrade rich --target 14.0.0
+```
+
+### `codeshift upgrade`
+
+Analyze your codebase and propose changes for a specific library upgrade.
+
+```bash
+codeshift upgrade <library> --target <version> [OPTIONS]
+
+Arguments:
+  LIBRARY               Library name to upgrade (required)
+
+Options:
+  --target, -t VERSION  Target version to upgrade to (required)
+  --path, -p PATH       Path to analyze (default: current directory)
+  --file, -f PATH       Analyze a single file instead of the entire project
+  --dry-run             Show what would be changed without saving state
+  --verbose, -v         Show detailed output
+```
+
+### `codeshift upgrade-all`
+
+Upgrade all outdated packages to their latest versions in one go.
+
+```bash
+codeshift upgrade-all [OPTIONS]
+
+Options:
+  --path, -p PATH       Path to analyze (default: current directory)
+  --all                 Include all outdated packages (not just Tier 1)
+  --tier1-only          Only upgrade Tier 1 libraries (deterministic transforms)
+  --major-only          Only perform major version upgrades
+  --include, -i LIB     Only include specific libraries (repeatable)
+  --exclude, -e LIB     Exclude specific libraries (repeatable)
+  --update-deps         Update dependency files with new versions (default: yes)
+  --no-update-deps      Skip updating dependency files
+  --dry-run             Show what would be changed without saving state
+  --verbose, -v         Show detailed output
+```
+
+### `codeshift diff`
+
+View the detailed diff of proposed changes.
+
+```bash
+codeshift diff [OPTIONS]
+
+Options:
+  --path, -p PATH       Path to the project (default: current directory)
+  --file, -f FILE       Show diff for a specific file only
+  --no-color            Disable colored output
+  --context, -c INT     Number of context lines (default: 3)
+  --summary             Show only a summary without the full diff
+```
+
+### `codeshift show`
+
+Show the full transformed or original code for a file.
+
+```bash
+codeshift show <file_path> [OPTIONS]
+
+Arguments:
+  FILE_PATH             File to display (required)
+
+Options:
+  --path, -p PATH       Path to the project (default: current directory)
+  --original            Show the original code instead of the transformed version
+```
+
+### `codeshift apply`
+
+Apply the proposed changes to your files.
+
+```bash
+codeshift apply [OPTIONS]
+
+Options:
+  --path, -p PATH       Path to the project (default: current directory)
+  --file, -f FILE       Apply changes to a specific file only
+  --backup              Create .bak backup files before applying changes
+  --yes, -y             Skip confirmation prompt
+  --validate            Validate syntax after applying (default: yes)
+  --no-validate         Skip syntax validation
+```
+
+### `codeshift reset`
+
+Cancel the current migration and clear all pending changes.
+
+```bash
+codeshift reset [OPTIONS]
+
+Options:
+  --path, -p PATH       Path to the project (default: current directory)
+  --yes, -y             Skip confirmation prompt
+```
+
+### `codeshift restore`
+
+Restore files from a backup created by `apply --backup`.
+
+```bash
+codeshift restore <backup_dir> [OPTIONS]
+
+Arguments:
+  BACKUP_DIR            Path to backup directory (required)
+
+Options:
+  --path, -p PATH       Path to the project (default: current directory)
+  --yes, -y             Skip confirmation prompt
+```
+
+### `codeshift libraries`
+
+List all supported libraries and their migration paths.
+
+```bash
+codeshift libraries
+```
+
+### `codeshift status`
+
+Show current migration status, pending changes, and quota info.
+
+```bash
+codeshift status [OPTIONS]
+
+Options:
+  --path, -p PATH       Path to the project (default: current directory)
+```
+
+### Account Commands
+
+```bash
+codeshift login              # Login to enable cloud features
+codeshift register           # Create a new account
+codeshift logout             # Logout and remove credentials
+codeshift whoami             # Show current user info
+codeshift quota              # Show usage and limits
+codeshift upgrade-plan       # View or upgrade your plan
+codeshift billing            # Open billing portal
+```
+
+## How It Works
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│                     Knowledge Acquisition Pipeline                   │
+│  ┌─────────────┐   ┌──────────────────┐   ┌─────────────────────┐  │
+│  │ Local Cache │──▶│ On-Demand Gen    │──▶│ LLM Parser          │  │
+│  │ (instant)   │   │ (fetches sources)│   │ (breaking changes)  │  │
+│  └─────────────┘   └──────────────────┘   └─────────────────────┘  │
+│                            │                                        │
+│            ┌───────────────┴───────────────┐                       │
+│            │  Source Fetchers              │                       │
+│            │  ├── GitHub (CHANGELOG.md)    │                       │
+│            │  ├── Docs (migration guides)  │                       │
+│            │  └── Release notes            │                       │
+│            └───────────────────────────────┘                       │
+└─────────────────────────────────────────────────────────────────────┘
+                          │
+                          ▼
+┌─────────────────────────────────────────────────────────────────────┐
+│                    Migration Engine (Tiered)                        │
+│  Tier 1: AST Transforms  │  Tier 2: KB-Guided  │  Tier 3: LLM      │
+│  (deterministic)         │  (context + LLM)    │  (fallback)       │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+1. **Fetch Knowledge** - discovers and fetches changelogs, migration guides from GitHub/PyPI
+2. **Parse Changes** - uses an LLM to extract breaking changes with confidence levels (HIGH/MEDIUM/LOW)
+3. **Scan Codebase** - finds imports and usage of the target library using libcst
+4. **Tiered Migration**:
+   - **Tier 1**: deterministic AST transforms for 15 supported libraries - no LLM needed
+   - **Tier 2**: knowledge base guided migration with LLM assistance
+   - **Tier 3**: pure LLM migration for unknown patterns
+5. **Validate** - runs syntax checks on the transformed code
+6. **Report** - shows a detailed diff with explanations for each change
+
+## Pydantic v1 → v2 Example
+
+Codeshift handles the following Pydantic migrations automatically:
+
+| v1 Pattern | v2 Replacement |
+|---|---|
+| `Config` class | `model_config = ConfigDict(...)` |
+| `@validator` | `@field_validator` with `@classmethod` |
+| `@root_validator` | `@model_validator` |
+| `.dict()` | `.model_dump()` |
+| `.json()` | `.model_dump_json()` |
+| `.schema()` | `.model_json_schema()` |
+| `.parse_obj()` | `.model_validate()` |
+| `orm_mode = True` | `from_attributes = True` |
+| `Field(regex=...)` | `Field(pattern=...)` |
+
+## Configuration
+
+Codeshift can be configured via `pyproject.toml`:
+
+```toml
+[tool.codeshift]
+# Path patterns to exclude from scanning
+exclude = ["tests/*", "migrations/*"]
+
+# Enable/disable LLM fallback
+use_llm = true
+
+# Anthropic API key (can also use ANTHROPIC_API_KEY env var)
+# anthropic_api_key = "sk-..."
+```
+
+## Environment Variables
+
+| Variable | Required | Description |
+|---|---|---|
+| `ANTHROPIC_API_KEY` | For Tier 2/3 | Enables LLM-powered migrations |
+| `GITHUB_TOKEN` | No | Higher GitHub API rate limits |
+
+## Pricing
+
+| Tier | Price | What You Get |
+|------|-------|--------------|
+| **Free** | $0/month | Tier 1 deterministic transforms for all 15 supported libraries. Runs entirely locally. |
+| **Pro** | $19/month | Tier 2 KB-guided LLM migrations for any library |
+| **Unlimited** | $49/month | Tier 3 pure LLM migrations + priority support |
+
+```bash
+# Login to access Pro/Unlimited features
+codeshift login
+
+# Check your current plan and usage
+codeshift quota
+```
+
+## License
+
+This software is licensed under the [MIT License](LICENSE).
+
+You are free to use, modify, and distribute this software. The CLI tool and all transforms are fully open source.

{codeshift-0.3.5.dist-info → codeshift-0.3.6.dist-info}/RECORD

@@ -83,9 +83,9 @@ codeshift/utils/llm_client.py,sha256=WkT3KftJi7rsj8MXH4MVJvznugicb2XpkKqnqRET1eo
 codeshift/validator/__init__.py,sha256=WRQSfJ7eLJdjR2_f_dXSaBtfawkvu1Dlu20Gh76D12c,280
 codeshift/validator/syntax_checker.py,sha256=FJeLIqhNhV7_Xj2RskHScJZks6A9fybaqv5Z1-MGDfo,5343
 codeshift/validator/test_runner.py,sha256=VX0OqkuI3AJxOUzRW2_BEjdDsMw1N4a0od-pPbSF6O8,6760
-codeshift-0.3.5.dist-info/licenses/LICENSE,sha256=SrjIFBfm7GQh90Giv7mEiPnYdgp1wsp0RnOTT6HkeVw,1066
-codeshift-0.3.5.dist-info/METADATA,sha256=CX0pZvNDbIZg_4_pQppo0PibOBsQgUh4ieAs6wFqHH4,14492
-codeshift-0.3.5.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-codeshift-0.3.5.dist-info/entry_points.txt,sha256=AlJ8V7a2pNyu-9UiRKUWiTMIJtaYAUnlg53Y-wFHiK0,53
-codeshift-0.3.5.dist-info/top_level.txt,sha256=Ct42mtGs5foZ4MyYSksd5rXP0qFhWSZz8Y8mON0EEds,10
-codeshift-0.3.5.dist-info/RECORD,,
+codeshift-0.3.6.dist-info/licenses/LICENSE,sha256=SrjIFBfm7GQh90Giv7mEiPnYdgp1wsp0RnOTT6HkeVw,1066
+codeshift-0.3.6.dist-info/METADATA,sha256=BRjtZ7e2RGOGGe4zpbyv-AW6TVfY4LMqMpVpCjwyMI8,17478
+codeshift-0.3.6.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+codeshift-0.3.6.dist-info/entry_points.txt,sha256=AlJ8V7a2pNyu-9UiRKUWiTMIJtaYAUnlg53Y-wFHiK0,53
+codeshift-0.3.6.dist-info/top_level.txt,sha256=Ct42mtGs5foZ4MyYSksd5rXP0qFhWSZz8Y8mON0EEds,10
+codeshift-0.3.6.dist-info/RECORD,,

codeshift-0.3.5.dist-info/METADATA

@@ -1,368 +0,0 @@
-Metadata-Version: 2.4
-Name: codeshift
-Version: 0.3.5
-Summary: AI-powered CLI tool that migrates Python code to handle breaking dependency changes
-Author: PyResolve Team
-License: MIT
-Project-URL: Homepage, https://github.com/youssefragab/PyResolve
-Project-URL: Repository, https://github.com/youssefragab/PyResolve
-Project-URL: Issues, https://github.com/youssefragab/PyResolve/issues
-Keywords: migration,dependencies,ast,refactoring,pydantic
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: click>=8.0
-Requires-Dist: libcst>=1.0
-Requires-Dist: anthropic>=0.20
-Requires-Dist: pyyaml>=6.0
-Requires-Dist: rich>=13.0
-Requires-Dist: toml>=0.10
-Requires-Dist: packaging>=23.0
-Requires-Dist: httpx>=0.25
-Requires-Dist: pytest>=8.4.2
-Requires-Dist: nox>=2025.11.12
-Requires-Dist: black>=24.10.0
-Requires-Dist: mypy>=1.19.1
-Requires-Dist: supabase>=2.27.2
-Requires-Dist: pre-commit>=4.5.1
-Provides-Extra: api
-Requires-Dist: fastapi>=0.109.0; extra == "api"
-Requires-Dist: uvicorn>=0.27.0; extra == "api"
-Requires-Dist: supabase>=2.3.0; extra == "api"
-Requires-Dist: stripe>=7.0.0; extra == "api"
-Requires-Dist: pydantic-settings>=2.1.0; extra == "api"
-Requires-Dist: email-validator>=2.0.0; extra == "api"
-Provides-Extra: dev
-Requires-Dist: pytest>=7.0; extra == "dev"
-Requires-Dist: pytest-cov>=4.0; extra == "dev"
-Requires-Dist: black<25.0,>=24.0; extra == "dev"
-Requires-Dist: ruff>=0.1.0; extra == "dev"
-Requires-Dist: mypy>=1.0; extra == "dev"
-Requires-Dist: nox>=2024.0; extra == "dev"
-Requires-Dist: pre-commit>=3.6.0; extra == "dev"
-Requires-Dist: types-toml>=0.10; extra == "dev"
-Requires-Dist: types-PyYAML>=6.0; extra == "dev"
-Provides-Extra: all
-Requires-Dist: codeshift[api,dev]; extra == "all"
-Dynamic: license-file
-
-# PyResolve
-
-[![CI](https://github.com/youssefragab/PyResolve/actions/workflows/ci.yml/badge.svg)](https://github.com/youssefragab/PyResolve/actions/workflows/ci.yml)
-[![PyPI version](https://badge.fury.io/py/pyresolve.svg)](https://pypi.org/project/pyresolve/)
-[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
-
-**Don't just flag the update. Fix the break.**
-
-PyResolve is an AI-powered CLI tool that migrates Python code to handle breaking dependency changes. Unlike Dependabot/Renovate which just bump versions, PyResolve actually rewrites code to be compatible with new library versions.
-
-## Features
-
-- **Auto-generated knowledge bases** - Fetches changelogs and migration guides from GitHub, parses them with LLM to detect breaking changes
-- **Tiered migration approach** - Deterministic AST transforms for known patterns, KB-guided LLM for medium confidence, pure LLM fallback for complex cases
-- **Confidence-based change detection** - Shows HIGH/MEDIUM/LOW confidence breaking changes before migration
-- **Local test execution** to validate changes before applying
-- **Beautiful diff output** with explanations for each change
-
-## Supported Libraries
-
-### Tier 1 Libraries (Deterministic AST Transforms)
-
-| Library | Migration Path | Status |
-|---------|---------------|--------|
-| Pydantic | v1 → v2 | ✅ Full support |
-| FastAPI | 0.x → 0.100+ | ✅ Supported |
-| SQLAlchemy | 1.4 → 2.0 | ✅ Supported |
-| Pandas | 1.x → 2.x | ✅ Supported |
-| Requests | Various | ✅ Supported |
-| Django | 3.x → 4.x/5.x | ✅ Supported |
-| Flask | 1.x → 2.x/3.x | ✅ Supported |
-| NumPy | 1.x → 2.x | ✅ Supported |
-| attrs | attr → attrs | ✅ Supported |
-| Celery | 4.x → 5.x | ✅ Supported |
-| Click | 7.x → 8.x | ✅ Supported |
-| aiohttp | 2.x → 3.x | ✅ Supported |
-| httpx | 0.x → 0.24+ | ✅ Supported |
-| Marshmallow | 2.x → 3.x | ✅ Supported |
-| pytest | 6.x → 7.x/8.x | ✅ Supported |
-
-### Any Library (Auto-Generated Knowledge Base)
-
-PyResolve can migrate **any Python library** by automatically fetching changelogs from GitHub and detecting breaking changes. For libraries not in Tier 1, it uses KB-guided or pure LLM migration.
-
-## Installation
-
-```bash
-pip install pyresolve
-```
-
-## Quick Start
-
-```bash
-# Scan your project for all possible migrations
-pyresolve scan
-
-# Scan with detailed breaking change analysis
-pyresolve scan --fetch-changes
-
-# Upgrade all outdated packages at once
-pyresolve upgrade-all
-
-# Or analyze and propose changes for a specific library
-pyresolve upgrade pydantic --target 2.5.0
-
-# View detailed diff of proposed changes
-pyresolve diff
-
-# Apply changes to your files
-pyresolve apply
-```
-
-### Example Output
-
-```bash
-$ pyresolve upgrade pydantic --target 2.5.0
-
-╭──────────────────────── PyResolve Migration ─────────────────────────╮
-│ Upgrading Pydantic to version 2.5.0                                  │
-│ Migration guide: https://docs.pydantic.dev/latest/migration/         │
-╰──────────────────────────────────────────────────────────────────────╯
-
-Fetching knowledge sources...
-   ✓ GitHub: CHANGELOG.md
-   ✓ GitHub: docs/migration.md
-
-Breaking changes detected:
-
-   HIGH CONFIDENCE:
-   ├── .dict() → .model_dump()
-   ├── @validator → @field_validator
-   └── class Config → model_config = ConfigDict()
-
-   MEDIUM CONFIDENCE:
-   ├── .json() → .model_dump_json()
-   └── parse_obj() → model_validate()
-
-Scanning for library usage...
-Found 12 imports from pydantic
-Found 45 usages of pydantic symbols
-
-┏━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━┓
-┃ File               ┃ Changes ┃ Status ┃
-┡━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━╇━━━━━━━━┩
-│ src/models/user.py │       5 │ Ready  │
-│ src/api/schemas.py │       3 │ Ready  │
-└────────────────────┴─────────┴────────┘
-
-Total: 8 changes across 2 files
-```
-
-## Usage
-
-### Scan Command
-
-Scan your entire project for possible dependency migrations:
-
-```bash
-pyresolve scan
-
-# Options:
-#   --path, -p         Path to scan (default: current directory)
-#   --fetch-changes    Fetch changelogs and detect breaking changes (slower)
-#   --major-only       Only show major version upgrades
-#   --json-output      Output results as JSON
-#   --verbose, -v      Show detailed output
-```
-
-Example output:
-
-```bash
-$ pyresolve scan
-
-Found 13 dependencies
-
-Outdated Dependencies (5)
-┏━━━━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━┳━━━━━━━┳━━━━━━━━━━┓
-┃ Package    ┃ Current ┃ Latest ┃ Type  ┃   Tier   ┃
-┡━━━━━━━━━━━━╇━━━━━━━━━╇━━━━━━━━╇━━━━━━━╇━━━━━━━━━━┩
-│ pydantic   │     1.0 │  2.5.0 │ Major │  Tier 1  │
-│ rich       │    13.0 │ 14.0.0 │ Major │ Tier 2/3 │
-└────────────┴─────────┴────────┴───────┴──────────┘
-
-Suggested Migrations (2)
-  pydantic 1.0 → 2.5.0 (Tier 1 - deterministic)
-  rich 13.0 → 14.0.0 (Tier 2/3 - LLM-assisted)
-
-Quick commands:
-  pyresolve upgrade pydantic --target 2.5.0
-  pyresolve upgrade rich --target 14.0.0
-```
-
-### Upgrade Command
-
-Analyze your codebase and propose changes for a library upgrade:
-
-```bash
-pyresolve upgrade <library> --target <version>
-
-# Options:
-#   --target, -t    Target version to upgrade to
-#   --path, -p      Path to analyze (default: current directory)
-#   --dry-run       Show what would be changed without saving state
-```
-
-### Diff Command
-
-View the detailed diff of proposed changes:
-
-```bash
-pyresolve diff
-
-# Options:
-#   --file, -f      Show diff for specific file only
-#   --no-color      Disable colored output
-```
-
-### Apply Command
-
-Apply the proposed changes to your files:
-
-```bash
-pyresolve apply
-
-# Options:
-#   --backup        Create backup files before applying changes
-#   --file, -f      Apply changes to specific file only
-```
-
-### Upgrade-All Command
-
-Upgrade all outdated packages to their latest versions in one go:
-
-```bash
-pyresolve upgrade-all
-
-# Options:
-#   --all, -a       Include all outdated packages (not just Tier 1)
-#   --path, -p      Path to analyze (default: current directory)
-#   --dry-run       Show what would be changed without saving state
-```
-
-### Libraries Command
-
-List all supported libraries and their migration paths:
-
-```bash
-pyresolve libraries
-```
-
-### Status Command
-
-Show current migration status, pending changes, and quota information:
-
-```bash
-pyresolve status
-```
-
-## How It Works
-
-```text
-┌─────────────────────────────────────────────────────────────────────┐
-│                     Knowledge Acquisition Pipeline                   │
-│  ┌─────────────┐   ┌──────────────────┐   ┌─────────────────────┐  │
-│  │ Local Cache │──▶│ On-Demand Gen    │──▶│ LLM Parser          │  │
-│  │ (instant)   │   │ (fetches sources)│   │ (breaking changes)  │  │
-│  └─────────────┘   └──────────────────┘   └─────────────────────┘  │
-│                            │                                        │
-│            ┌───────────────┴───────────────┐                       │
-│            │  Source Fetchers              │                       │
-│            │  ├── GitHub (CHANGELOG.md)    │                       │
-│            │  ├── Docs (migration guides)  │                       │
-│            │  └── Release notes            │                       │
-│            └───────────────────────────────┘                       │
-└─────────────────────────────────────────────────────────────────────┘
-                          │
-                          ▼
-┌─────────────────────────────────────────────────────────────────────┐
-│                    Migration Engine (Tiered)                        │
-│  Tier 1: AST Transforms  │  Tier 2: KB-Guided  │  Tier 3: LLM      │
-│  (deterministic)         │  (context + LLM)    │  (fallback)       │
-└─────────────────────────────────────────────────────────────────────┘
-```
-
-1. **Fetch Knowledge**: Discovers and fetches changelogs, migration guides from GitHub/PyPI
-2. **Parse Changes**: Uses LLM to extract breaking changes with confidence levels (HIGH/MEDIUM/LOW)
-3. **Scan Codebase**: Finds imports and usage of the target library
-4. **Tiered Migration**:
-   - **Tier 1**: Deterministic AST transforms for 15 supported libraries (Pydantic, FastAPI, SQLAlchemy, Django, Flask, NumPy, Pandas, Requests, attrs, Celery, Click, aiohttp, httpx, Marshmallow, pytest)
-   - **Tier 2**: Knowledge base guided migration with LLM assistance
-   - **Tier 3**: Pure LLM migration for unknown patterns
-5. **Validate**: Runs syntax checks and optionally your test suite
-6. **Report**: Shows a detailed diff with explanations for each change
-
-## Pydantic v1 → v2 Transforms
-
-PyResolve handles the following Pydantic migrations automatically:
-
-- `Config` class → `model_config = ConfigDict(...)`
-- `@validator` → `@field_validator` with `@classmethod`
-- `@root_validator` → `@model_validator`
-- `.dict()` → `.model_dump()`
-- `.json()` → `.model_dump_json()`
-- `.schema()` → `.model_json_schema()`
-- `.parse_obj()` → `.model_validate()`
-- `orm_mode = True` → `from_attributes = True`
-- `Field(regex=...)` → `Field(pattern=...)`
-
-## Configuration
-
-PyResolve can be configured via `pyproject.toml`:
-
-```toml
-[tool.pyresolve]
-# Path patterns to exclude from scanning (defaults: .pyresolve/*, tests/*, .venv/*, venv/*)
-exclude = ["tests/*", "migrations/*"]
-
-# Enable/disable LLM fallback
-use_llm = true
-
-# Anthropic API key (can also use ANTHROPIC_API_KEY env var)
-# anthropic_api_key = "sk-..."
-```
-
-## Pricing
-
-PyResolve uses a tiered pricing model:
-
-| Tier | Price | Features |
-|------|-------|----------|
-| **Free** | $0/month | Tier 1 deterministic transforms (15 libraries including Pydantic, Django, Flask, SQLAlchemy, and more) |
-| **Pro** | $19/month | Tier 2 KB-guided LLM migrations for any library |
-| **Unlimited** | $49/month | Tier 3 pure LLM migrations + priority support |
-
-**How it works:**
-- **Tier 1 (Free)**: Runs entirely locally using deterministic AST transforms. No account required.
-- **Tier 2/3 (Paid)**: LLM-powered migrations are processed through the PyResolve API to ensure quality and manage costs.
-
-```bash
-# Login to access Pro/Unlimited features
-pyresolve login
-
-# Check your current plan and usage
-pyresolve quota
-```
-
-## License
-
-This software is licensed under the [MIT License](LICENSE).
-
-You are free to use, modify, and distribute this software. The CLI tool and all transforms are fully open source.