code-review-ai-cli 1.0.0__tar.gz → 1.0.2__tar.gz

code_review_ai_cli-1.0.2/PKG-INFO

@@ -0,0 +1,195 @@
+Metadata-Version: 2.4
+Name: code-review-ai-cli
+Version: 1.0.2
+Summary: Automated AI-powered code review CLI for Azure DevOps / TFS Pull Requests
+License: MIT
+Keywords: code-review,ai,azure-devops,tfs,pull-request,llm
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+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 :: Quality Assurance
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28.0
+Requires-Dist: PyYAML>=6.0
+Provides-Extra: bedrock
+Requires-Dist: boto3>=1.34.0; extra == "bedrock"
+Provides-Extra: openai
+Requires-Dist: openai>=1.0.0; extra == "openai"
+Provides-Extra: gemini
+Requires-Dist: google-generativeai>=0.3.0; extra == "gemini"
+Provides-Extra: claude
+Requires-Dist: anthropic>=0.18.0; extra == "claude"
+Provides-Extra: all
+Requires-Dist: boto3>=1.34.0; extra == "all"
+Requires-Dist: openai>=1.0.0; extra == "all"
+Requires-Dist: google-generativeai>=0.3.0; extra == "all"
+Requires-Dist: anthropic>=0.18.0; extra == "all"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.3.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.14.0; extra == "dev"
+
+# AI Code Review CLI
+
+Automated code review tool with Pull Request integration for Azure DevOps/TFS and support for multiple LLM providers.
+**Documentation where** [docs/index.md](docs/index.md) for complete guides on CLI usage, LLM configuration, and architecture.
+
+## Features
+
+- **AI Pull Request Review** — Automated code analysis with configurable LLM providers
+- **Structured Comments** — Inline suggestions + general summary comments
+- **Dry-run Mode** — Validate reviews before posting
+- **Multiple LLM Providers** — OpenAI, Azure OpenAI, Gemini, Claude, Ollama, GitHub Copilot, AWS Bedrock
+- **Smart Filtering** — Filter by file extensions, limit diff size
+- **Customizable Prompts** — Markdown-based review guidelines
+- **Interactive CLI** — Menu-driven selection and confirmation
+
+## Installation & Quick Start
+
+### 1. Install Package
+
+From PyPI:
+
+```bash
+pip install code-review-ai-cli
+```
+
+With optional LLM SDK extras:
+
+```bash
+pip install "code-review-ai-cli[bedrock]"    # AWS Bedrock
+pip install "code-review-ai-cli[openai]"     # OpenAI SDK
+pip install "code-review-ai-cli[gemini]"     # Google Gemini SDK
+pip install "code-review-ai-cli[claude]"     # Anthropic Claude SDK
+pip install "code-review-ai-cli[all]"        # All optional SDKs
+```
+
+For development:
+
+```bash
+pip install -r requirements.txt
+pip install "code-review-ai-cli[dev]"        # Test suite + linting
+```
+
+### 2. Initialize Configuration
+
+Generate config templates in your project directory:
+
+```bash
+ai-review init
+```
+
+Creates:
+- `config.yaml` — LLM and review settings
+- `review_prompt.md` — Customizable review guidelines
+
+### 3. Run Your First Review
+
+```bash
+# List active PRs
+ai-review list-prs
+
+# Review a specific PR
+ai-review pr-review 42
+
+# Dry-run (preview without posting)
+ai-review pr-review 42 --dry-run
+```
+
+## Configuration File
+
+After `ai-review init`, edit `config.yaml`:
+
+```yaml
+llm:
+  provider: bedrock                    # or: openai, gemini, claude, etc.
+  model: anthropic.claude-3-5-sonnet-20240620-v1:0
+
+bedrock:
+  region: us-east-1
+
+tfs:
+  base_url: https://dev.azure.com/your-org
+  project: YourProject
+  pat: xxxxxxxxx
+
+review:
+  language: pt
+  verbosity: detailed                  # or: quick, security
+  file_extensions_filter: [".cs", ".ts", ".py"]
+  max_diff_files: 50
+```
+
+## Development & Testing
+
+This is a standard Python project with the following structure:
+
+```
+src/
+  ai_review.py        # CLI entry point
+  config.py           # Configuration management
+  llm_client.py       # LLM provider abstraction
+  tfs_client.py       # Azure DevOps integration
+  git_utils.py        # Git diff processing
+  formatter.py        # Output formatting (terminal, markdown, JSON)
+
+tests/
+  test_*.py           # Unit and integration tests
+```
+
+### Run Tests
+
+```bash
+python -m pytest --cov=src --cov-report=term
+```
+
+### Code Quality
+
+Project follows PEP8 with Black formatter and Ruff linter:
+
+```bash
+# Format code
+black src/ tests/
+
+# Lint
+ruff check src/ tests/
+
+# Type checking (if using mypy)
+mypy src/
+```
+
+
+## VS Code Integration
+
+Predefined tasks for quick execution in VS Code:
+
+### Available Tasks
+
+1. **AI Review: Pull Request (Interactive)**
+  - Interactive mode with main menu
+  - Run with: `Ctrl+Shift+B` → Select task
+
+2. **AI Review: PR (Dry-Run)**
+  - Dry-run for a specific PR
+  - Prompts for PR ID
+
+3. **AI Review: List Active PRs**
+  - Lists active PRs
+  - Quick diagnostics
+
+4. **AI Review: Interactive Mode**
+  - Full tool menu
+  - Runs in background
+
+### How to run tasks
+
+In VS Code:
+1. `Ctrl+Shift+P` → "Tasks: Run Task"
+2. Select the desired task
+3. Fill in parameters if needed

code_review_ai_cli-1.0.2/README.md

@@ -0,0 +1,158 @@
+# AI Code Review CLI
+
+Automated code review tool with Pull Request integration for Azure DevOps/TFS and support for multiple LLM providers.
+**Documentation where** [docs/index.md](docs/index.md) for complete guides on CLI usage, LLM configuration, and architecture.
+
+## Features
+
+- **AI Pull Request Review** — Automated code analysis with configurable LLM providers
+- **Structured Comments** — Inline suggestions + general summary comments
+- **Dry-run Mode** — Validate reviews before posting
+- **Multiple LLM Providers** — OpenAI, Azure OpenAI, Gemini, Claude, Ollama, GitHub Copilot, AWS Bedrock
+- **Smart Filtering** — Filter by file extensions, limit diff size
+- **Customizable Prompts** — Markdown-based review guidelines
+- **Interactive CLI** — Menu-driven selection and confirmation
+
+## Installation & Quick Start
+
+### 1. Install Package
+
+From PyPI:
+
+```bash
+pip install code-review-ai-cli
+```
+
+With optional LLM SDK extras:
+
+```bash
+pip install "code-review-ai-cli[bedrock]"    # AWS Bedrock
+pip install "code-review-ai-cli[openai]"     # OpenAI SDK
+pip install "code-review-ai-cli[gemini]"     # Google Gemini SDK
+pip install "code-review-ai-cli[claude]"     # Anthropic Claude SDK
+pip install "code-review-ai-cli[all]"        # All optional SDKs
+```
+
+For development:
+
+```bash
+pip install -r requirements.txt
+pip install "code-review-ai-cli[dev]"        # Test suite + linting
+```
+
+### 2. Initialize Configuration
+
+Generate config templates in your project directory:
+
+```bash
+ai-review init
+```
+
+Creates:
+- `config.yaml` — LLM and review settings
+- `review_prompt.md` — Customizable review guidelines
+
+### 3. Run Your First Review
+
+```bash
+# List active PRs
+ai-review list-prs
+
+# Review a specific PR
+ai-review pr-review 42
+
+# Dry-run (preview without posting)
+ai-review pr-review 42 --dry-run
+```
+
+## Configuration File
+
+After `ai-review init`, edit `config.yaml`:
+
+```yaml
+llm:
+  provider: bedrock                    # or: openai, gemini, claude, etc.
+  model: anthropic.claude-3-5-sonnet-20240620-v1:0
+
+bedrock:
+  region: us-east-1
+
+tfs:
+  base_url: https://dev.azure.com/your-org
+  project: YourProject
+  pat: xxxxxxxxx
+
+review:
+  language: pt
+  verbosity: detailed                  # or: quick, security
+  file_extensions_filter: [".cs", ".ts", ".py"]
+  max_diff_files: 50
+```
+
+## Development & Testing
+
+This is a standard Python project with the following structure:
+
+```
+src/
+  ai_review.py        # CLI entry point
+  config.py           # Configuration management
+  llm_client.py       # LLM provider abstraction
+  tfs_client.py       # Azure DevOps integration
+  git_utils.py        # Git diff processing
+  formatter.py        # Output formatting (terminal, markdown, JSON)
+
+tests/
+  test_*.py           # Unit and integration tests
+```
+
+### Run Tests
+
+```bash
+python -m pytest --cov=src --cov-report=term
+```
+
+### Code Quality
+
+Project follows PEP8 with Black formatter and Ruff linter:
+
+```bash
+# Format code
+black src/ tests/
+
+# Lint
+ruff check src/ tests/
+
+# Type checking (if using mypy)
+mypy src/
+```
+
+
+## VS Code Integration
+
+Predefined tasks for quick execution in VS Code:
+
+### Available Tasks
+
+1. **AI Review: Pull Request (Interactive)**
+  - Interactive mode with main menu
+  - Run with: `Ctrl+Shift+B` → Select task
+
+2. **AI Review: PR (Dry-Run)**
+  - Dry-run for a specific PR
+  - Prompts for PR ID
+
+3. **AI Review: List Active PRs**
+  - Lists active PRs
+  - Quick diagnostics
+
+4. **AI Review: Interactive Mode**
+  - Full tool menu
+  - Runs in background
+
+### How to run tasks
+
+In VS Code:
+1. `Ctrl+Shift+P` → "Tasks: Run Task"
+2. Select the desired task
+3. Fill in parameters if needed

code_review_ai_cli-1.0.2/code_review_ai_cli.egg-info/PKG-INFO

@@ -0,0 +1,195 @@
+Metadata-Version: 2.4
+Name: code-review-ai-cli
+Version: 1.0.2
+Summary: Automated AI-powered code review CLI for Azure DevOps / TFS Pull Requests
+License: MIT
+Keywords: code-review,ai,azure-devops,tfs,pull-request,llm
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+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 :: Quality Assurance
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28.0
+Requires-Dist: PyYAML>=6.0
+Provides-Extra: bedrock
+Requires-Dist: boto3>=1.34.0; extra == "bedrock"
+Provides-Extra: openai
+Requires-Dist: openai>=1.0.0; extra == "openai"
+Provides-Extra: gemini
+Requires-Dist: google-generativeai>=0.3.0; extra == "gemini"
+Provides-Extra: claude
+Requires-Dist: anthropic>=0.18.0; extra == "claude"
+Provides-Extra: all
+Requires-Dist: boto3>=1.34.0; extra == "all"
+Requires-Dist: openai>=1.0.0; extra == "all"
+Requires-Dist: google-generativeai>=0.3.0; extra == "all"
+Requires-Dist: anthropic>=0.18.0; extra == "all"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.3.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.14.0; extra == "dev"
+
+# AI Code Review CLI
+
+Automated code review tool with Pull Request integration for Azure DevOps/TFS and support for multiple LLM providers.
+**Documentation where** [docs/index.md](docs/index.md) for complete guides on CLI usage, LLM configuration, and architecture.
+
+## Features
+
+- **AI Pull Request Review** — Automated code analysis with configurable LLM providers
+- **Structured Comments** — Inline suggestions + general summary comments
+- **Dry-run Mode** — Validate reviews before posting
+- **Multiple LLM Providers** — OpenAI, Azure OpenAI, Gemini, Claude, Ollama, GitHub Copilot, AWS Bedrock
+- **Smart Filtering** — Filter by file extensions, limit diff size
+- **Customizable Prompts** — Markdown-based review guidelines
+- **Interactive CLI** — Menu-driven selection and confirmation
+
+## Installation & Quick Start
+
+### 1. Install Package
+
+From PyPI:
+
+```bash
+pip install code-review-ai-cli
+```
+
+With optional LLM SDK extras:
+
+```bash
+pip install "code-review-ai-cli[bedrock]"    # AWS Bedrock
+pip install "code-review-ai-cli[openai]"     # OpenAI SDK
+pip install "code-review-ai-cli[gemini]"     # Google Gemini SDK
+pip install "code-review-ai-cli[claude]"     # Anthropic Claude SDK
+pip install "code-review-ai-cli[all]"        # All optional SDKs
+```
+
+For development:
+
+```bash
+pip install -r requirements.txt
+pip install "code-review-ai-cli[dev]"        # Test suite + linting
+```
+
+### 2. Initialize Configuration
+
+Generate config templates in your project directory:
+
+```bash
+ai-review init
+```
+
+Creates:
+- `config.yaml` — LLM and review settings
+- `review_prompt.md` — Customizable review guidelines
+
+### 3. Run Your First Review
+
+```bash
+# List active PRs
+ai-review list-prs
+
+# Review a specific PR
+ai-review pr-review 42
+
+# Dry-run (preview without posting)
+ai-review pr-review 42 --dry-run
+```
+
+## Configuration File
+
+After `ai-review init`, edit `config.yaml`:
+
+```yaml
+llm:
+  provider: bedrock                    # or: openai, gemini, claude, etc.
+  model: anthropic.claude-3-5-sonnet-20240620-v1:0
+
+bedrock:
+  region: us-east-1
+
+tfs:
+  base_url: https://dev.azure.com/your-org
+  project: YourProject
+  pat: xxxxxxxxx
+
+review:
+  language: pt
+  verbosity: detailed                  # or: quick, security
+  file_extensions_filter: [".cs", ".ts", ".py"]
+  max_diff_files: 50
+```
+
+## Development & Testing
+
+This is a standard Python project with the following structure:
+
+```
+src/
+  ai_review.py        # CLI entry point
+  config.py           # Configuration management
+  llm_client.py       # LLM provider abstraction
+  tfs_client.py       # Azure DevOps integration
+  git_utils.py        # Git diff processing
+  formatter.py        # Output formatting (terminal, markdown, JSON)
+
+tests/
+  test_*.py           # Unit and integration tests
+```
+
+### Run Tests
+
+```bash
+python -m pytest --cov=src --cov-report=term
+```
+
+### Code Quality
+
+Project follows PEP8 with Black formatter and Ruff linter:
+
+```bash
+# Format code
+black src/ tests/
+
+# Lint
+ruff check src/ tests/
+
+# Type checking (if using mypy)
+mypy src/
+```
+
+
+## VS Code Integration
+
+Predefined tasks for quick execution in VS Code:
+
+### Available Tasks
+
+1. **AI Review: Pull Request (Interactive)**
+  - Interactive mode with main menu
+  - Run with: `Ctrl+Shift+B` → Select task
+
+2. **AI Review: PR (Dry-Run)**
+  - Dry-run for a specific PR
+  - Prompts for PR ID
+
+3. **AI Review: List Active PRs**
+  - Lists active PRs
+  - Quick diagnostics
+
+4. **AI Review: Interactive Mode**
+  - Full tool menu
+  - Runs in background
+
+### How to run tasks
+
+In VS Code:
+1. `Ctrl+Shift+P` → "Tasks: Run Task"
+2. Select the desired task
+3. Fill in parameters if needed

{code_review_ai_cli-1.0.0 → code_review_ai_cli-1.0.2}/code_review_ai_cli.egg-info/SOURCES.txt

@@ -14,6 +14,7 @@ src/git_utils.py
 src/llm_client.py
 src/tfs_client.py
 src/prompts/config.yaml.template
+src/prompts/review_prompt.md.template
 tests/test_ai_review.py
 tests/test_config.py
 tests/test_formatter.py

{code_review_ai_cli-1.0.0 → code_review_ai_cli-1.0.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "code-review-ai-cli"
-version = "1.0.0"
+version = "1.0.2"
 description = "Automated AI-powered code review CLI for Azure DevOps / TFS Pull Requests"
 readme = "README.md"
 requires-python = ">=3.10"

{code_review_ai_cli-1.0.0 → code_review_ai_cli-1.0.2}/src/ai_review.py

@@ -40,6 +40,7 @@ Version: see pyproject.toml
 """
 
 import argparse
+import importlib.resources
 import os
 import sys
 import time
@@ -872,16 +873,16 @@ def _show_config(config: ReviewConfig) -> None:
 # Init command
 # ---------------------------------------------------------------------------
 def cmd_init() -> int:
-    """Copies a config.yaml template to the current working directory.
+    """Copies a config.yaml template and review_prompt.md to the current working directory.
 
     Creates a ``config.yaml`` file pre-populated with all available options
-    and inline documentation. If the file already exists in the current
-    directory the user is prompted for confirmation before overwriting.
+    and inline documentation, and a ``review_prompt.md`` file with default
+    review style rules. If either file already exists in the current directory
+    the user is prompted for confirmation before overwriting.
 
-    The template is bundled with the package at
-    ``src/prompts/config.yaml.template`` and is resolved at runtime via
-    :mod:`importlib.resources`, so it works regardless of how the package
-    was installed.
+    Both files are bundled with the package at ``src/prompts/`` and are
+    resolved at runtime via :mod:`importlib.resources`, so they work
+    regardless of how the package was installed.
 
     Returns:
         int: Exit code. ``0`` on success or user cancellation, ``1`` on error.
@@ -891,14 +892,15 @@ def cmd_init() -> int:
 
             $ ai-review init
             ✅ config.yaml created at: /home/user/my-project/config.yaml
-               Edit it to add your credentials and preferences.
+            ✅ review_prompt.md created at: /home/user/my-project/review_prompt.md
+               Edit them to add your credentials, preferences and review rules.
     """
-    import importlib.resources as pkg_resources
-
-    dest = os.path.join(os.getcwd(), "config.yaml")
+    cwd = os.getcwd()
     c = Colors()
 
-    if os.path.exists(dest):
+    # --- config.yaml ---
+    config_dest = os.path.join(cwd, "config.yaml")
+    if os.path.exists(config_dest):
         print(f"{c.YELLOW}config.yaml already exists in the current directory.{c.RESET}")
         answer = input("Overwrite? [y/N] ").strip().lower()
         if answer != "y":
@@ -906,17 +908,38 @@ def cmd_init() -> int:
             return 0
 
     try:
-        ref = pkg_resources.files("src.prompts").joinpath("config.yaml.template")
-        template_content = ref.read_text(encoding="utf-8")
+        ref = importlib.resources.files("src.prompts").joinpath("config.yaml.template")
+        config_content = ref.read_text(encoding="utf-8")
+    except (FileNotFoundError, TypeError) as exc:
+        print(f"{c.RED}Error: could not locate config template: {exc}{c.RESET}")
+        return 1
+
+    with open(config_dest, "w", encoding="utf-8") as fh:
+        fh.write(config_content)
+
+    # --- review_prompt.md ---
+    prompt_dest = os.path.join(cwd, "review_prompt.md")
+    if os.path.exists(prompt_dest):
+        print(f"{c.YELLOW}review_prompt.md already exists in the current directory.{c.RESET}")
+        answer = input("Overwrite? [y/N] ").strip().lower()
+        if answer != "y":
+            print(f"{c.GREEN}✅ config.yaml created at:{c.RESET} {config_dest}")
+            print("   Skipped review_prompt.md (kept existing).")
+            return 0
+
+    try:
+        ref = importlib.resources.files("src.prompts").joinpath("review_prompt.md.template")
+        prompt_content = ref.read_text(encoding="utf-8")
     except (FileNotFoundError, TypeError) as exc:
-        print(f"{c.RED}Error: could not locate template file: {exc}{c.RESET}")
+        print(f"{c.RED}Error: could not locate review_prompt template: {exc}{c.RESET}")
         return 1
 
-    with open(dest, "w", encoding="utf-8") as fh:
-        fh.write(template_content)
+    with open(prompt_dest, "w", encoding="utf-8") as fh:
+        fh.write(prompt_content)
 
-    print(f"{c.GREEN}✅ config.yaml created at:{c.RESET} {dest}")
-    print(f"   Edit it to add your credentials and preferences.")
+    print(f"{c.GREEN}✅ config.yaml created at:{c.RESET} {config_dest}")
+    print(f"{c.GREEN}✅ review_prompt.md created at:{c.RESET} {prompt_dest}")
+    print("   Edit them to add your credentials, preferences and review rules.")
     return 0