code-review-ai-cli 2.0.1__tar.gz → 2.2.0__tar.gz

code_review_ai_cli-2.2.0/PKG-INFO

@@ -0,0 +1,146 @@
+Metadata-Version: 2.4
+Name: code-review-ai-cli
+Version: 2.2.0
+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: tree-sitter
+Requires-Dist: tree-sitter-languages>=1.10.2; extra == "tree-sitter"
+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"
+Requires-Dist: tree-sitter-languages>=1.10.2; 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
+
+AI Code Review is an automated AI-powered code review CLI, compatible with various LLM providers, designed for integration with Azure DevOps, whether in the cloud or on-premises. It allows you to run a review on demand or as part of a pipeline triggered before a commit or when a pull request is created.
+
+## Features
+
+- AI Pull Request review (`pr-review`)
+- Structured PR comments (inline + general summary)
+- `dry-run` mode to validate without posting
+- PR listing with filters (`list-prs`)
+- Configuration exclusively via `config.yaml`
+- Providers LLM: OpenAI, Azure OpenAI, Gemini, Claude, Ollama, GitHub Copilot, AWS Bedrock
+- Diff filtering by **excluded path prefixes** (`excluded_paths`) and/or **file extensions** (`file_extensions_filter`)
+
+## Documentation
+
+- [Configuration Guide](docs/configuration.md) - Details on YAML parameters and settings.
+- [Commands Reference](docs/commands.md) - Complete list of CLI commands and arguments.
+- [Execution Flow](docs/execution_flow.md) - Mermaid diagram of the application's lifecycle.
+- [Troubleshooting](docs/troubleshooting.md) - Common issues and solutions.
+
+## Output Review Format
+
+![Review Output Format Example](/imgs/review_output.png)
+
+## Installation
+
+Install from PyPI:
+s
+```bash
+pip install code-review-ai-cli
+```
+
+After installing the package, generate ready-to-edit configuration files in your working directory:
+
+```bash
+ai-review init
+```
+
+This copies two bundled templates:
+
+- **`config.yaml`** — all available options with inline documentation
+- **`review_prompt.md`** — default review style rules, injected into every LLM prompt
+
+The tool looks for `config.yaml` in the **current working directory** at runtime. You can also pass a different path with `--config`:
+
+```bash
+ai-review pr-review --config ~/configs/ai-review.yaml
+```
+
+If you plan to run the test suite locally, also install development dependencies:
+
+```bash
+pip install "code-review-ai-cli[dev]"
+```
+
+## Minimal Example
+
+Example `config.yaml`:
+
+```yaml
+llm:
+  provider: openai
+  model: gpt-4o
+
+openai:
+  api_key: sk-xxxx
+
+tfs:
+  base_url: https://dev.azure.com/your-organization
+  project: ProjectName
+  pat: xxxxxxxxx
+  verify_ssl: true
+  # ca_bundle: C:/certs/corporate-root-ca.pem
+
+review:
+  verbosity: detailed
+  scope: diff_only
+  custom_prompt_file: review_prompt.md
+  # file limit sent to the LLM
+  max_diff_files: 50
+  # per-file limit
+  max_diff_lines: 2000
+  # extension allowlist (empty list = all files)
+  file_extensions_filter: [".cs", ".ts", ".py"]
+  # exclude path prefixes from the diff (applied before file_extensions_filter)
+  # leading slash is optional; add trailing slash for exact folder boundary
+  excluded_paths: ["libs/generated"]
+
+pr:
+  auto_post_comments: false
+  dry_run: false
+  comment_mode: structured
+
+output:
+  format: terminal
+  file: ""
+  color: true
+```
+
+## Available VS Code Tasks
+
+- `AI Review: Pull Request (Interactive)`
+- `AI Review: PR (Dry-Run)`
+- `AI Review: List Active PRs`
+- `AI Review: Interactive Mode`

code_review_ai_cli-2.2.0/README.md

@@ -0,0 +1,106 @@
+# AI Code Review
+
+AI Code Review is an automated AI-powered code review CLI, compatible with various LLM providers, designed for integration with Azure DevOps, whether in the cloud or on-premises. It allows you to run a review on demand or as part of a pipeline triggered before a commit or when a pull request is created.
+
+## Features
+
+- AI Pull Request review (`pr-review`)
+- Structured PR comments (inline + general summary)
+- `dry-run` mode to validate without posting
+- PR listing with filters (`list-prs`)
+- Configuration exclusively via `config.yaml`
+- Providers LLM: OpenAI, Azure OpenAI, Gemini, Claude, Ollama, GitHub Copilot, AWS Bedrock
+- Diff filtering by **excluded path prefixes** (`excluded_paths`) and/or **file extensions** (`file_extensions_filter`)
+
+## Documentation
+
+- [Configuration Guide](docs/configuration.md) - Details on YAML parameters and settings.
+- [Commands Reference](docs/commands.md) - Complete list of CLI commands and arguments.
+- [Execution Flow](docs/execution_flow.md) - Mermaid diagram of the application's lifecycle.
+- [Troubleshooting](docs/troubleshooting.md) - Common issues and solutions.
+
+## Output Review Format
+
+![Review Output Format Example](/imgs/review_output.png)
+
+## Installation
+
+Install from PyPI:
+s
+```bash
+pip install code-review-ai-cli
+```
+
+After installing the package, generate ready-to-edit configuration files in your working directory:
+
+```bash
+ai-review init
+```
+
+This copies two bundled templates:
+
+- **`config.yaml`** — all available options with inline documentation
+- **`review_prompt.md`** — default review style rules, injected into every LLM prompt
+
+The tool looks for `config.yaml` in the **current working directory** at runtime. You can also pass a different path with `--config`:
+
+```bash
+ai-review pr-review --config ~/configs/ai-review.yaml
+```
+
+If you plan to run the test suite locally, also install development dependencies:
+
+```bash
+pip install "code-review-ai-cli[dev]"
+```
+
+## Minimal Example
+
+Example `config.yaml`:
+
+```yaml
+llm:
+  provider: openai
+  model: gpt-4o
+
+openai:
+  api_key: sk-xxxx
+
+tfs:
+  base_url: https://dev.azure.com/your-organization
+  project: ProjectName
+  pat: xxxxxxxxx
+  verify_ssl: true
+  # ca_bundle: C:/certs/corporate-root-ca.pem
+
+review:
+  verbosity: detailed
+  scope: diff_only
+  custom_prompt_file: review_prompt.md
+  # file limit sent to the LLM
+  max_diff_files: 50
+  # per-file limit
+  max_diff_lines: 2000
+  # extension allowlist (empty list = all files)
+  file_extensions_filter: [".cs", ".ts", ".py"]
+  # exclude path prefixes from the diff (applied before file_extensions_filter)
+  # leading slash is optional; add trailing slash for exact folder boundary
+  excluded_paths: ["libs/generated"]
+
+pr:
+  auto_post_comments: false
+  dry_run: false
+  comment_mode: structured
+
+output:
+  format: terminal
+  file: ""
+  color: true
+```
+
+## Available VS Code Tasks
+
+- `AI Review: Pull Request (Interactive)`
+- `AI Review: PR (Dry-Run)`
+- `AI Review: List Active PRs`
+- `AI Review: Interactive Mode`

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

@@ -0,0 +1,146 @@
+Metadata-Version: 2.4
+Name: code-review-ai-cli
+Version: 2.2.0
+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: tree-sitter
+Requires-Dist: tree-sitter-languages>=1.10.2; extra == "tree-sitter"
+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"
+Requires-Dist: tree-sitter-languages>=1.10.2; 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
+
+AI Code Review is an automated AI-powered code review CLI, compatible with various LLM providers, designed for integration with Azure DevOps, whether in the cloud or on-premises. It allows you to run a review on demand or as part of a pipeline triggered before a commit or when a pull request is created.
+
+## Features
+
+- AI Pull Request review (`pr-review`)
+- Structured PR comments (inline + general summary)
+- `dry-run` mode to validate without posting
+- PR listing with filters (`list-prs`)
+- Configuration exclusively via `config.yaml`
+- Providers LLM: OpenAI, Azure OpenAI, Gemini, Claude, Ollama, GitHub Copilot, AWS Bedrock
+- Diff filtering by **excluded path prefixes** (`excluded_paths`) and/or **file extensions** (`file_extensions_filter`)
+
+## Documentation
+
+- [Configuration Guide](docs/configuration.md) - Details on YAML parameters and settings.
+- [Commands Reference](docs/commands.md) - Complete list of CLI commands and arguments.
+- [Execution Flow](docs/execution_flow.md) - Mermaid diagram of the application's lifecycle.
+- [Troubleshooting](docs/troubleshooting.md) - Common issues and solutions.
+
+## Output Review Format
+
+![Review Output Format Example](/imgs/review_output.png)
+
+## Installation
+
+Install from PyPI:
+s
+```bash
+pip install code-review-ai-cli
+```
+
+After installing the package, generate ready-to-edit configuration files in your working directory:
+
+```bash
+ai-review init
+```
+
+This copies two bundled templates:
+
+- **`config.yaml`** — all available options with inline documentation
+- **`review_prompt.md`** — default review style rules, injected into every LLM prompt
+
+The tool looks for `config.yaml` in the **current working directory** at runtime. You can also pass a different path with `--config`:
+
+```bash
+ai-review pr-review --config ~/configs/ai-review.yaml
+```
+
+If you plan to run the test suite locally, also install development dependencies:
+
+```bash
+pip install "code-review-ai-cli[dev]"
+```
+
+## Minimal Example
+
+Example `config.yaml`:
+
+```yaml
+llm:
+  provider: openai
+  model: gpt-4o
+
+openai:
+  api_key: sk-xxxx
+
+tfs:
+  base_url: https://dev.azure.com/your-organization
+  project: ProjectName
+  pat: xxxxxxxxx
+  verify_ssl: true
+  # ca_bundle: C:/certs/corporate-root-ca.pem
+
+review:
+  verbosity: detailed
+  scope: diff_only
+  custom_prompt_file: review_prompt.md
+  # file limit sent to the LLM
+  max_diff_files: 50
+  # per-file limit
+  max_diff_lines: 2000
+  # extension allowlist (empty list = all files)
+  file_extensions_filter: [".cs", ".ts", ".py"]
+  # exclude path prefixes from the diff (applied before file_extensions_filter)
+  # leading slash is optional; add trailing slash for exact folder boundary
+  excluded_paths: ["libs/generated"]
+
+pr:
+  auto_post_comments: false
+  dry_run: false
+  comment_mode: structured
+
+output:
+  format: terminal
+  file: ""
+  color: true
+```
+
+## Available VS Code Tasks
+
+- `AI Review: Pull Request (Interactive)`
+- `AI Review: PR (Dry-Run)`
+- `AI Review: List Active PRs`
+- `AI Review: Interactive Mode`

{code_review_ai_cli-2.0.1 → code_review_ai_cli-2.2.0}/code_review_ai_cli.egg-info/SOURCES.txt

@@ -9,6 +9,7 @@ code_review_ai_cli.egg-info/top_level.txt
 src/__init__.py
 src/ai_review.py
 src/config.py
+src/context_extractor.py
 src/formatter.py
 src/git_utils.py
 src/llm_client.py
@@ -18,6 +19,7 @@ src/prompts/config.yaml.template
 src/prompts/review_prompt.md.template
 tests/test_ai_review.py
 tests/test_config.py
+tests/test_context_extractor.py
 tests/test_formatter.py
 tests/test_git_utils.py
 tests/test_llm_client.py

{code_review_ai_cli-2.0.1 → code_review_ai_cli-2.2.0}/code_review_ai_cli.egg-info/requires.txt

@@ -6,6 +6,7 @@ boto3>=1.34.0
 openai>=1.0.0
 google-generativeai>=0.3.0
 anthropic>=0.18.0
+tree-sitter-languages>=1.10.2
 
 [bedrock]
 boto3>=1.34.0
@@ -23,3 +24,6 @@ google-generativeai>=0.3.0
 
 [openai]
 openai>=1.0.0
+
+[tree-sitter]
+tree-sitter-languages>=1.10.2

{code_review_ai_cli-2.0.1 → code_review_ai_cli-2.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "code-review-ai-cli"
-version = "2.0.1"
+version = "2.2.0"
 description = "Automated AI-powered code review CLI for Azure DevOps / TFS Pull Requests"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -31,11 +31,13 @@ bedrock = ["boto3>=1.34.0"]
 openai = ["openai>=1.0.0"]
 gemini = ["google-generativeai>=0.3.0"]
 claude = ["anthropic>=0.18.0"]
+tree-sitter = ["tree-sitter-languages>=1.10.2"]
 all = [
     "boto3>=1.34.0",
     "openai>=1.0.0",
     "google-generativeai>=0.3.0",
     "anthropic>=0.18.0",
+    "tree-sitter-languages>=1.10.2",
 ]
 dev = [
     "pytest>=8.3.0",

{code_review_ai_cli-2.0.1 → code_review_ai_cli-2.2.0}/src/ai_review.py

@@ -79,7 +79,7 @@ SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
 PROJECT_ROOT = _ensure_project_root_on_path(__file__)
 
 from src.config import ReviewConfig, VALID_PROVIDERS  # noqa: E402
-from src.git_utils import GitUtils, GitError  # noqa: E402
+from src.git_utils import GitUtils  # noqa: E402
 from src.llm_client import LLMClient, LLMError  # noqa: E402
 from src.formatter import ReviewFormatter, Colors, save_output  # noqa: E402
 from src import __version__ as VERSION  # noqa: E402
@@ -426,6 +426,8 @@ def run_pr_review_workflow(args: argparse.Namespace, config: ReviewConfig,
             repo_name,
             pr_id,
             review_scope=config.review_scope,
+            excluded_paths=config.excluded_paths or None,
+            file_extensions_filter=config.file_extensions_filter or None,
         )
     except TFSError as exc:
         print(formatter.format_error(str(exc)))
@@ -451,17 +453,6 @@ def run_pr_review_workflow(args: argparse.Namespace, config: ReviewConfig,
     git_utils = GitUtils.__new__(GitUtils)
     git_utils.repo_path = os.getcwd()
 
-    # Filter extensions before limiting/truncating the diff sent to the LLM
-    if config.file_extensions_filter:
-        try:
-            diff = git_utils.filter_diff_by_extensions(
-                diff,
-                config.file_extensions_filter,
-            )
-        except GitError as exc:
-            print(formatter.format_warning(str(exc)))
-            return 0
-
     # Keep only added lines (+): ignore context and removed lines
     diff = git_utils.filter_diff_additions_only(diff)
     if not diff.strip():

{code_review_ai_cli-2.0.1 → code_review_ai_cli-2.2.0}/src/config.py

@@ -89,8 +89,12 @@ class ReviewConfig:
     review_scope: str = "diff_only"         # "diff_only" | "full_code"
     max_diff_files: int = 50                 # Max diff files sent to LLM
     max_diff_lines: int = 2000              # Max diff lines
+    max_scope_blocks: int = 3               # Max changed blocks for Enclosing Scopes strategy
+    max_scope_lines: int = 250              # Max lines in a single scope block before fallback to file_skeleton
+    adaptive_context_lines: int = 10        # Context lines for Adaptive Diff fallback
     custom_prompt_file: str = "review_prompt.md"  # Markdown file with extra rules/context
-    file_extensions_filter: list = field(default_factory=list)
+    file_extensions_filter: list = field(default_factory=list)  # File extensions to include (empty = all)
+    excluded_paths: list = field(default_factory=list)  # Folder path segments to exclude from diff
 
     # --- PR Review ----------------------------------------------------
     auto_post_comments: bool = False        # Post comments automatically
@@ -214,8 +218,12 @@ class ReviewConfig:
             "review_scope": ("review", "scope"),
             "max_diff_files": ("review", "max_diff_files"),
             "max_diff_lines": ("review", "max_diff_lines"),
+            "max_scope_blocks": ("review", "max_scope_blocks"),
+            "max_scope_lines": ("review", "max_scope_lines"),
+            "adaptive_context_lines": ("review", "adaptive_context_lines"),
             "custom_prompt_file": ("review", "custom_prompt_file"),
             "file_extensions_filter": ("review", "file_extensions_filter"),
+            "excluded_paths": ("review", "excluded_paths"),
             # PR
             "auto_post_comments": ("pr", "auto_post_comments"),
             "dry_run": ("pr", "dry_run"),