github-code-review 3.4.3__tar.gz → 3.6.0__tar.gz

{github_code_review-3.4.3 → github_code_review-3.6.0}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Vitalii Stepanenko
+Copyright (c) 2025–2026 Vitalii Stepanenko
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{github_code_review-3.4.3 → github_code_review-3.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: github-code-review
-Version: 3.4.3
+Version: 3.6.0
 Summary: AI code review tool that works with any language model provider. It detects issues in GitHub pull requests or local changes—instantly, reliably, and without vendor lock-in.
 License: MIT
 License-File: LICENSE
@@ -18,7 +18,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development
 Requires-Dist: GitPython (>=3.1.44,<4.0.0)
-Requires-Dist: ai-microcore (>=4.5,<4.6)
+Requires-Dist: ai-microcore (>=4,<5)
 Requires-Dist: anthropic (>=0.57.1,<1)
 Requires-Dist: ghapi (>=1.0.6,<1.1.0)
 Requires-Dist: google-generativeai (>=0.8.5,<0.9.0)
@@ -51,12 +51,21 @@ Get consistent, thorough code reviews in seconds—no waiting for human availabi
   - [1. Review Pull Requests via GitHub Actions](#1-review-pull-requests-via-github-actions)
   - [2. Running Code Analysis Locally](#2-running-code-analysis-locally)
 - [Configuration](#-configuration)
-- [Documentation](#-documentation)
+- [Guides & Reference](#-guides--reference)
+  - [Command Line Reference](https://github.com/Nayjest/Gito/blob/main/documentation/command_line_reference.md) ↗
+  - [Configuration Cookbook](https://github.com/Nayjest/Gito/blob/main/documentation/config_cookbook.md) ↗
+  - [GitHub Setup Guide](https://github.com/Nayjest/Gito/blob/main/documentation/github_setup.md) ↗
+  - Integrations
+    - [Linear Integration](https://github.com/Nayjest/Gito/blob/main/documentation/linear_integration.md) ↗ 
+    - [Atlassian Jira Integration](https://github.com/Nayjest/Gito/blob/main/documentation/jira_integration.md) ↗
+  - [Troubleshooting](https://github.com/Nayjest/Gito/blob/main/documentation/troubleshooting.md) ↗
+  - [Documentation generation with Gito](https://github.com/Nayjest/Gito/blob/main/documentation/documentation_generation.md) ↗
+- [Known Limitations](#-known-limitations)
 - [Development Setup](#-development-setup)
 - [Contributing](#-contributing)
 - [License](#-license)
 
-## ✨ Why Gito?
+## ✨ Why Gito?<a id="-why-gito"></a>
 
 - [⚡] **Lightning Fast:** Get detailed code reviews in seconds, not days — powered by parallelized LLM processing  
 - [🔧] **Vendor Agnostic:** Works with any language model provider (OpenAI, Anthropic, Google, local models, etc.)  
@@ -66,7 +75,7 @@ Get consistent, thorough code reviews in seconds—no waiting for human availabi
 - [🚀] **Easy Integration:** Automatically reviews pull requests via GitHub Actions and posts results as PR comments  
 - [🎛️] **Infinitely Flexible:** Adapt to any project's standards—configure review rules, severity levels, and focus areas, build custom workflows 
 
-## 🎯 Perfect For
+## 🎯 Perfect For<a id="-perfect-for"></a>
 
 - Solo developers who want expert-level code review without the wait
 - Teams looking to catch issues before human review
@@ -75,12 +84,11 @@ Get consistent, thorough code reviews in seconds—no waiting for human availabi
 
 ✨ See [code review in action](https://github.com/Nayjest/Gito/pull/99) ✨
 
-## 🚀 Quickstart
+## 🚀 Quickstart<a id="-quickstart"></a>
 
-### 1. Review Pull Requests via GitHub Actions
+### 1. Review Pull Requests via GitHub Actions<a id="1-review-pull-requests-via-github-actions"></a>
 
 Create a `.github/workflows/gito-code-review.yml` file:
-
 ```yaml
 name: "Gito: AI Code Review"
 on:
@@ -102,7 +110,7 @@ jobs:
       uses: actions/setup-python@v6
       with: { python-version: "3.13" }
     - name: Install AI Code Review tool
-      run: pip install gito.bot~=3.4
+      run: pip install gito.bot~=3.6
     - name: Run AI code analysis
       env:
         LLM_API_KEY: ${{ secrets.LLM_API_KEY }}
@@ -127,11 +135,15 @@ jobs:
 PRs to your repository will now receive AI code reviews automatically. ✨  
 See [GitHub Setup Guide](https://github.com/Nayjest/Gito/blob/main/documentation/github_setup.md) for more details.
 
-### 2. Running Code Analysis Locally
+### 2. Running Code Analysis Locally<a id="2-running-code-analysis-locally"></a>
 
 #### Initial Local Setup
 
-**Prerequisites:** [Python](https://www.python.org/downloads/) 3.11 / 3.12 / 3.13  
+**Prerequisites:** 
+- [Python](https://www.python.org/downloads/) 3.11 / 3.12 / 3.13  
+- [Git](https://git-scm.com)
+
+#### Option A: Install via pip (recommended)
 
 **Step 1:** Install [gito.bot](https://github.com/Nayjest/Gito) using [pip](https://en.wikipedia.org/wiki/Pip_(package_manager)).
 ```bash
@@ -141,12 +153,21 @@ pip install gito.bot
 > **Troubleshooting:**  
 > pip may also be available via cli as `pip3` depending on your Python installation.
 
+#### Option B: Windows Standalone Installer
+
+Download the latest Windows installer from [Releases](https://github.com/Nayjest/Gito/releases).
+
+The installer includes:
+- Standalone executable (no Python required)
+- Automatic PATH configuration
+- Start Menu shortcuts
+- Easy uninstallation
+
 **Step 2:** Perform initial setup
 
 The following command will perform one-time setup using an interactive wizard.
 You will be prompted to enter LLM configuration details (API type, API key, etc).
 Configuration will be saved to `~/.gito/.env`.
-
 ```bash
 gito setup
 ```
@@ -160,7 +181,7 @@ gito setup
 
 **Step 1:** Navigate to your repository root directory.  
 **Step 2:** Switch to the branch you want to review.  
-**Step 3:** Run following command
+**Step 3:** Run the following command:
 ```bash
 gito review
 ```
@@ -170,7 +191,6 @@ gito review
 > See `gito --help` for more options.
 
 **Reviewing remote repository**
-
 ```bash
 gito remote git@github.com:owner/repo.git <FEATURE_BRANCH>..<MAIN_BRANCH>
 ```
@@ -179,58 +199,145 @@ Use interactive help for details:
 gito remote --help
 ```
 
-## 🔧 Configuration
+## 🔧 Configuration<a id="-configuration"></a>
+
+Gito uses a two-layer configuration model:
+
+| Scope | Location | Purpose |
+|-------|----------|---------|
+| **Environment** | `~/.gito/.env` or OS environment variables | LLM provider, model, API keys, concurrency |
+| **Project** | `<repo>/.gito/config.toml` | Review behavior, prompts, templates, integrations |
+
+> **Note:** Environment configuration defines external resources and credentials — it's machine-specific and never committed to version control. Project configuration defines review behavior and can be shared across your team.
+
+### Environment Configuration
+
+Environment settings control LLM inference, API Keys and apply system-wide.
+
+Gito uses [ai-microcore](https://github.com/Nayjest/ai-microcore) for vendor-agnostic LLM access. All settings are configured via OS environment variables or `.env` files.
+
+**Default location:** `~/.gito/.env`  
+*(Created automatically via `gito setup`)*
+
+#### Example
+```bash
+# ~/.gito/.env
+LLM_API_TYPE=openai
+LLM_API_KEY=sk-...
+LLM_API_BASE=https://api.openai.com/v1/
+MODEL=gpt-5.2
+MAX_CONCURRENT_TASKS=20
+```
+
+For all supported options, see the [ai-microcore configuration guide](https://github.com/Nayjest/ai-microcore?tab=readme-ov-file#%EF%B8%8F-configuring).
+
+#### CI/CD Environments
+
+In CI workflows, configure LLM settings via workflow environment variables. Use your platform's secrets management (GitHub Secrets, GitLab CI Variables) for API keys.
+
 
-Change behavior via `.gito/config.toml`:
+### Project Configuration
 
-- Prompt templates, filtering and post-processing using Python code snippets
-- Tagging, severity, and confidence settings
-- Custom AI awards for developer brilliance
-- Output customization
+Gito supports per-repository customization through a `.gito/config.toml` file placed at the root of your project. This allows you to tailor code review behavior to your specific codebase, coding standards, and workflow requirements.
 
-You can override the default config by placing `.gito/config.toml` in your repo root.
+#### Configuration Inheritance Model
 
+Project settings follow a layered override model:
 
-See default configuration [here](https://github.com/Nayjest/Gito/blob/main/gito/config.toml).
+**Bundled Defaults** ([config.toml](https://github.com/Nayjest/Gito/blob/main/gito/config.toml)) → **Project Config** (`<your-repo>/.gito/config.toml`)
 
-More details can be found in [📖 Configuration Cookbook](https://github.com/Nayjest/Gito/blob/main/documentation/config_cookbook.md)
+Any values defined in your project's `.gito/config.toml` are merged on top of the built-in defaults. You only need to specify the settings you want to change—everything else falls back to sensible defaults.
 
-## 📚 Documentation
+#### Common Customizations
+
+- **Review prompts** — Tailor AI instructions, review criteria, and quality thresholds
+- **Output templates** — Customize report format for GitHub comments and CLI
+- **Post-processing** — Python snippets to filter or transform detected issues
+- **Bot behavior** — Mention triggers, retries, comment handling
+- **Pipeline integrations** — Jira, Linear, etc.
+
+Explore the bundled [config.toml](https://github.com/Nayjest/Gito/blob/main/gito/config.toml) for the complete list of available options.
+
+#### Example
+```toml
+# .gito/config.toml
+mention_triggers = ["gito", "/check"]
+collapse_previous_code_review_comments = true
+
+# Files to provide as context
+aux_files = [
+    'documentation/command_line_reference.md'
+]
+
+exclude_files = [
+    'poetry.lock',
+]
+
+[prompt_vars]
+# Custom instructions injected into the system prompts
+awards = ""  # Disable awards
+requirements = """
+- All public functions must have docstrings.
+"""
+```
+
+For detailed guidance, see the [📖 Configuration Cookbook](https://github.com/Nayjest/Gito/blob/main/documentation/config_cookbook.md).
+
+## 📚 Guides & Reference<a id="-guides--reference"></a>
+
+For more detailed information, check out these articles:
 
 - [Command Line Reference](https://github.com/Nayjest/Gito/blob/main/documentation/command_line_reference.md)
 - [Configuration Cookbook](https://github.com/Nayjest/Gito/blob/main/documentation/config_cookbook.md)
 - [GitHub Setup Guide](https://github.com/Nayjest/Gito/blob/main/documentation/github_setup.md)
+- Integrations
+  - [Linear Integration](https://github.com/Nayjest/Gito/blob/main/documentation/linear_integration.md)
+  - [Atlassian Jira Integration](https://github.com/Nayjest/Gito/blob/main/documentation/jira_integration.md)
+- [Documentation generation with Gito](https://github.com/Nayjest/Gito/blob/main/documentation/documentation_generation.md)
 - [Troubleshooting](https://github.com/Nayjest/Gito/blob/main/documentation/troubleshooting.md)
 
+Or browse all documentation in the [`/documentation`](https://github.com/Nayjest/Gito/tree/main/documentation) directory.
 
-## 💻 Development Setup
+## 🚧 Known Limitations<a id="-known-limitations"></a>
 
-Install dependencies:
+Gito cannot modify files inside `.github/workflows` when reacting to GitHub PR comments (e.g., "Gito fix issue 2").  
+This is a GitHub security restriction that prevents workflows from modifying other workflow files using the default `GITHUB_TOKEN`.
+
+While using a Personal Access Token (PAT) with the `workflow` scope would bypass this limitation, it is not recommended as a workaround.
+PATs have broader permissions, longer lifespans, and are tied to individual user accounts, making them less secure than the default `GITHUB_TOKEN` for CI/CD pipelines.
+
+
+## 💻 Development Setup<a id="-development-setup"></a>
+
+Cloning the repository:
+```bash
+git clone https://github.com/Nayjest/Gito.git
+cd Gito
+```
 
+Install dependencies:
 ```bash
 make install
 ```
 
 Format code and check style:
-
 ```bash
 make black
 make cs
 ```
 
 Run tests:
-
 ```bash
 pytest
 ```
 
-## 🤝 Contributing
+## 🤝 Contributing<a id="-contributing"></a>
 
 **Looking for a specific feature or having trouble?**  
 Contributions are welcome! ❤️  
 See [CONTRIBUTING.md](https://github.com/Nayjest/Gito/blob/main/CONTRIBUTING.md) for details.
 
-## 📝 License
+## 📝 License<a id="-license"></a>
 
 Licensed under the [MIT License](https://github.com/Nayjest/Gito/blob/main/LICENSE).
 

{github_code_review-3.4.3 → github_code_review-3.6.0}/README.md

@@ -19,12 +19,21 @@ Get consistent, thorough code reviews in seconds—no waiting for human availabi
   - [1. Review Pull Requests via GitHub Actions](#1-review-pull-requests-via-github-actions)
   - [2. Running Code Analysis Locally](#2-running-code-analysis-locally)
 - [Configuration](#-configuration)
-- [Documentation](#-documentation)
+- [Guides & Reference](#-guides--reference)
+  - [Command Line Reference](https://github.com/Nayjest/Gito/blob/main/documentation/command_line_reference.md) ↗
+  - [Configuration Cookbook](https://github.com/Nayjest/Gito/blob/main/documentation/config_cookbook.md) ↗
+  - [GitHub Setup Guide](https://github.com/Nayjest/Gito/blob/main/documentation/github_setup.md) ↗
+  - Integrations
+    - [Linear Integration](https://github.com/Nayjest/Gito/blob/main/documentation/linear_integration.md) ↗ 
+    - [Atlassian Jira Integration](https://github.com/Nayjest/Gito/blob/main/documentation/jira_integration.md) ↗
+  - [Troubleshooting](https://github.com/Nayjest/Gito/blob/main/documentation/troubleshooting.md) ↗
+  - [Documentation generation with Gito](https://github.com/Nayjest/Gito/blob/main/documentation/documentation_generation.md) ↗
+- [Known Limitations](#-known-limitations)
 - [Development Setup](#-development-setup)
 - [Contributing](#-contributing)
 - [License](#-license)
 
-## ✨ Why Gito?
+## ✨ Why Gito?<a id="-why-gito"></a>
 
 - [⚡] **Lightning Fast:** Get detailed code reviews in seconds, not days — powered by parallelized LLM processing  
 - [🔧] **Vendor Agnostic:** Works with any language model provider (OpenAI, Anthropic, Google, local models, etc.)  
@@ -34,7 +43,7 @@ Get consistent, thorough code reviews in seconds—no waiting for human availabi
 - [🚀] **Easy Integration:** Automatically reviews pull requests via GitHub Actions and posts results as PR comments  
 - [🎛️] **Infinitely Flexible:** Adapt to any project's standards—configure review rules, severity levels, and focus areas, build custom workflows 
 
-## 🎯 Perfect For
+## 🎯 Perfect For<a id="-perfect-for"></a>
 
 - Solo developers who want expert-level code review without the wait
 - Teams looking to catch issues before human review
@@ -43,12 +52,11 @@ Get consistent, thorough code reviews in seconds—no waiting for human availabi
 
 ✨ See [code review in action](https://github.com/Nayjest/Gito/pull/99) ✨
 
-## 🚀 Quickstart
+## 🚀 Quickstart<a id="-quickstart"></a>
 
-### 1. Review Pull Requests via GitHub Actions
+### 1. Review Pull Requests via GitHub Actions<a id="1-review-pull-requests-via-github-actions"></a>
 
 Create a `.github/workflows/gito-code-review.yml` file:
-
 ```yaml
 name: "Gito: AI Code Review"
 on:
@@ -70,7 +78,7 @@ jobs:
       uses: actions/setup-python@v6
       with: { python-version: "3.13" }
     - name: Install AI Code Review tool
-      run: pip install gito.bot~=3.4
+      run: pip install gito.bot~=3.6
     - name: Run AI code analysis
       env:
         LLM_API_KEY: ${{ secrets.LLM_API_KEY }}
@@ -95,11 +103,15 @@ jobs:
 PRs to your repository will now receive AI code reviews automatically. ✨  
 See [GitHub Setup Guide](https://github.com/Nayjest/Gito/blob/main/documentation/github_setup.md) for more details.
 
-### 2. Running Code Analysis Locally
+### 2. Running Code Analysis Locally<a id="2-running-code-analysis-locally"></a>
 
 #### Initial Local Setup
 
-**Prerequisites:** [Python](https://www.python.org/downloads/) 3.11 / 3.12 / 3.13  
+**Prerequisites:** 
+- [Python](https://www.python.org/downloads/) 3.11 / 3.12 / 3.13  
+- [Git](https://git-scm.com)
+
+#### Option A: Install via pip (recommended)
 
 **Step 1:** Install [gito.bot](https://github.com/Nayjest/Gito) using [pip](https://en.wikipedia.org/wiki/Pip_(package_manager)).
 ```bash
@@ -109,12 +121,21 @@ pip install gito.bot
 > **Troubleshooting:**  
 > pip may also be available via cli as `pip3` depending on your Python installation.
 
+#### Option B: Windows Standalone Installer
+
+Download the latest Windows installer from [Releases](https://github.com/Nayjest/Gito/releases).
+
+The installer includes:
+- Standalone executable (no Python required)
+- Automatic PATH configuration
+- Start Menu shortcuts
+- Easy uninstallation
+
 **Step 2:** Perform initial setup
 
 The following command will perform one-time setup using an interactive wizard.
 You will be prompted to enter LLM configuration details (API type, API key, etc).
 Configuration will be saved to `~/.gito/.env`.
-
 ```bash
 gito setup
 ```
@@ -128,7 +149,7 @@ gito setup
 
 **Step 1:** Navigate to your repository root directory.  
 **Step 2:** Switch to the branch you want to review.  
-**Step 3:** Run following command
+**Step 3:** Run the following command:
 ```bash
 gito review
 ```
@@ -138,7 +159,6 @@ gito review
 > See `gito --help` for more options.
 
 **Reviewing remote repository**
-
 ```bash
 gito remote git@github.com:owner/repo.git <FEATURE_BRANCH>..<MAIN_BRANCH>
 ```
@@ -147,58 +167,145 @@ Use interactive help for details:
 gito remote --help
 ```
 
-## 🔧 Configuration
+## 🔧 Configuration<a id="-configuration"></a>
+
+Gito uses a two-layer configuration model:
+
+| Scope | Location | Purpose |
+|-------|----------|---------|
+| **Environment** | `~/.gito/.env` or OS environment variables | LLM provider, model, API keys, concurrency |
+| **Project** | `<repo>/.gito/config.toml` | Review behavior, prompts, templates, integrations |
+
+> **Note:** Environment configuration defines external resources and credentials — it's machine-specific and never committed to version control. Project configuration defines review behavior and can be shared across your team.
+
+### Environment Configuration
+
+Environment settings control LLM inference, API Keys and apply system-wide.
+
+Gito uses [ai-microcore](https://github.com/Nayjest/ai-microcore) for vendor-agnostic LLM access. All settings are configured via OS environment variables or `.env` files.
+
+**Default location:** `~/.gito/.env`  
+*(Created automatically via `gito setup`)*
+
+#### Example
+```bash
+# ~/.gito/.env
+LLM_API_TYPE=openai
+LLM_API_KEY=sk-...
+LLM_API_BASE=https://api.openai.com/v1/
+MODEL=gpt-5.2
+MAX_CONCURRENT_TASKS=20
+```
+
+For all supported options, see the [ai-microcore configuration guide](https://github.com/Nayjest/ai-microcore?tab=readme-ov-file#%EF%B8%8F-configuring).
+
+#### CI/CD Environments
+
+In CI workflows, configure LLM settings via workflow environment variables. Use your platform's secrets management (GitHub Secrets, GitLab CI Variables) for API keys.
+
 
-Change behavior via `.gito/config.toml`:
+### Project Configuration
 
-- Prompt templates, filtering and post-processing using Python code snippets
-- Tagging, severity, and confidence settings
-- Custom AI awards for developer brilliance
-- Output customization
+Gito supports per-repository customization through a `.gito/config.toml` file placed at the root of your project. This allows you to tailor code review behavior to your specific codebase, coding standards, and workflow requirements.
 
-You can override the default config by placing `.gito/config.toml` in your repo root.
+#### Configuration Inheritance Model
 
+Project settings follow a layered override model:
 
-See default configuration [here](https://github.com/Nayjest/Gito/blob/main/gito/config.toml).
+**Bundled Defaults** ([config.toml](https://github.com/Nayjest/Gito/blob/main/gito/config.toml)) → **Project Config** (`<your-repo>/.gito/config.toml`)
 
-More details can be found in [📖 Configuration Cookbook](https://github.com/Nayjest/Gito/blob/main/documentation/config_cookbook.md)
+Any values defined in your project's `.gito/config.toml` are merged on top of the built-in defaults. You only need to specify the settings you want to change—everything else falls back to sensible defaults.
 
-## 📚 Documentation
+#### Common Customizations
+
+- **Review prompts** — Tailor AI instructions, review criteria, and quality thresholds
+- **Output templates** — Customize report format for GitHub comments and CLI
+- **Post-processing** — Python snippets to filter or transform detected issues
+- **Bot behavior** — Mention triggers, retries, comment handling
+- **Pipeline integrations** — Jira, Linear, etc.
+
+Explore the bundled [config.toml](https://github.com/Nayjest/Gito/blob/main/gito/config.toml) for the complete list of available options.
+
+#### Example
+```toml
+# .gito/config.toml
+mention_triggers = ["gito", "/check"]
+collapse_previous_code_review_comments = true
+
+# Files to provide as context
+aux_files = [
+    'documentation/command_line_reference.md'
+]
+
+exclude_files = [
+    'poetry.lock',
+]
+
+[prompt_vars]
+# Custom instructions injected into the system prompts
+awards = ""  # Disable awards
+requirements = """
+- All public functions must have docstrings.
+"""
+```
+
+For detailed guidance, see the [📖 Configuration Cookbook](https://github.com/Nayjest/Gito/blob/main/documentation/config_cookbook.md).
+
+## 📚 Guides & Reference<a id="-guides--reference"></a>
+
+For more detailed information, check out these articles:
 
 - [Command Line Reference](https://github.com/Nayjest/Gito/blob/main/documentation/command_line_reference.md)
 - [Configuration Cookbook](https://github.com/Nayjest/Gito/blob/main/documentation/config_cookbook.md)
 - [GitHub Setup Guide](https://github.com/Nayjest/Gito/blob/main/documentation/github_setup.md)
+- Integrations
+  - [Linear Integration](https://github.com/Nayjest/Gito/blob/main/documentation/linear_integration.md)
+  - [Atlassian Jira Integration](https://github.com/Nayjest/Gito/blob/main/documentation/jira_integration.md)
+- [Documentation generation with Gito](https://github.com/Nayjest/Gito/blob/main/documentation/documentation_generation.md)
 - [Troubleshooting](https://github.com/Nayjest/Gito/blob/main/documentation/troubleshooting.md)
 
+Or browse all documentation in the [`/documentation`](https://github.com/Nayjest/Gito/tree/main/documentation) directory.
 
-## 💻 Development Setup
+## 🚧 Known Limitations<a id="-known-limitations"></a>
 
-Install dependencies:
+Gito cannot modify files inside `.github/workflows` when reacting to GitHub PR comments (e.g., "Gito fix issue 2").  
+This is a GitHub security restriction that prevents workflows from modifying other workflow files using the default `GITHUB_TOKEN`.
+
+While using a Personal Access Token (PAT) with the `workflow` scope would bypass this limitation, it is not recommended as a workaround.
+PATs have broader permissions, longer lifespans, and are tied to individual user accounts, making them less secure than the default `GITHUB_TOKEN` for CI/CD pipelines.
+
+
+## 💻 Development Setup<a id="-development-setup"></a>
+
+Cloning the repository:
+```bash
+git clone https://github.com/Nayjest/Gito.git
+cd Gito
+```
 
+Install dependencies:
 ```bash
 make install
 ```
 
 Format code and check style:
-
 ```bash
 make black
 make cs
 ```
 
 Run tests:
-
 ```bash
 pytest
 ```
 
-## 🤝 Contributing
+## 🤝 Contributing<a id="-contributing"></a>
 
 **Looking for a specific feature or having trouble?**  
 Contributions are welcome! ❤️  
 See [CONTRIBUTING.md](https://github.com/Nayjest/Gito/blob/main/CONTRIBUTING.md) for details.
 
-## 📝 License
+## 📝 License<a id="-license"></a>
 
 Licensed under the [MIT License](https://github.com/Nayjest/Gito/blob/main/LICENSE).
 

github_code_review-3.6.0/gito/__main__.py

@@ -0,0 +1,7 @@
+"""Allow running the package with `python -m gito`."""
+# Use an absolute import (package-qualified) here; otherwise, the Windows build
+# produced by PyInstaller fails.
+from gito.entrypoint import main
+
+if __name__ == "__main__":
+    main()

{github_code_review-3.4.3 → github_code_review-3.6.0}/gito/bootstrap.py

@@ -71,7 +71,9 @@ def bootstrap(verbosity: int = 1):
             mc.logging.LoggingConfig.STRIP_REQUEST_LINES = [300, 15]
 
     except mc.LLMConfigError as e:
-        msg = str(e)
+        msg = str(e).strip()
+        if not msg.endswith((".", "!", "?")):
+            msg += "."
         if is_running_in_github_action():
             ref = os.getenv("GITHUB_WORKFLOW_REF", "")
             if ref:

{github_code_review-3.4.3 → github_code_review-3.6.0}/gito/cli.py

@@ -6,9 +6,8 @@ import textwrap
 
 import microcore as mc
 import typer
-from git import Repo
-from gito.constants import REFS_VALUE_ALL
 
+from .constants import REFS_VALUE_ALL
 from .core import review, get_diff, filter_diff, answer
 from .cli_base import (
     app,
@@ -18,6 +17,7 @@ from .cli_base import (
     arg_filters,
     arg_out,
     arg_against,
+    arg_all,
     get_repo_context,
 )
 from .report_struct import Report
@@ -89,6 +89,23 @@ def cli(
         bootstrap(verbosity)
 
 
+def _consider_arg_all(all: bool, refs: str, merge_base: bool) -> tuple[str, bool]:
+    """
+    Handle the --all option logic for commands.
+    Returns:
+        Updated (refs, merge_base) tuple.
+    """
+    if all:
+        if refs and refs != REFS_VALUE_ALL:
+            raise typer.BadParameter(
+                "The --all option overrides the refs argument. "
+                "Please remove the refs argument if you want to review all codebase."
+            )
+        refs = REFS_VALUE_ALL
+        merge_base = False
+    return refs, merge_base
+
+
 @app_no_subcommand.command(name="review", help="Perform code review")
 @app.command(name="review", help="Perform a code review of the target codebase changes.")
 @app.command(name="run", hidden=True)
@@ -110,16 +127,9 @@ def cmd_review(
         """)
     ),
     out: str = arg_out(),
-    all: bool = typer.Option(default=False, help="Review all codebase"),
+    all: bool = arg_all(),
 ):
-    if all:
-        if refs and refs != REFS_VALUE_ALL:
-            raise typer.BadParameter(
-                "The --all option overrides the refs argument. "
-                "Please remove the refs argument if you want to review all codebase."
-            )
-        refs = REFS_VALUE_ALL
-        merge_base = False
+    refs, merge_base = _consider_arg_all(all, refs, merge_base)
     _what, _against = args_to_target(refs, what, against)
     pr = pr or os.getenv("PR_NUMBER_FROM_WORKFLOW_DISPATCH")
     with get_repo_context(url, _what) as (repo, out_folder):
@@ -151,7 +161,6 @@ def cmd_review(
 
 @app.command(name="ask", help="Answer questions about the target codebase changes.")
 @app.command(name="answer", hidden=True)
-@app.command(name="talk", hidden=True)
 def cmd_answer(
     question: str = typer.Argument(help="Question to ask about the codebase changes"),
     refs: str = arg_refs(),
@@ -174,11 +183,13 @@ def cmd_answer(
         help="Auxiliary files that might be helpful"
     ),
     save_to: str = typer.Option(
-        help="Save answer to file",
+        help="Write the answer to the target file",
         default=None,
         show_default=False
-    )
+    ),
+    all: bool = arg_all(),
 ):
+    refs, merge_base = _consider_arg_all(all, refs, merge_base)
     _what, _against = args_to_target(refs, what, against)
     pr = pr or os.getenv("PR_NUMBER_FROM_WORKFLOW_DISPATCH")
     if str(question).startswith("tpl:"):
@@ -241,8 +252,7 @@ def files(
     diff: bool = typer.Option(default=False, help="Show diff content")
 ):
     _what, _against = args_to_target(refs, what, against)
-    repo = Repo(".")
-    try:
+    with get_repo_context(url=None, branch=_what) as (repo, out_folder):
         patch_set = get_diff(repo=repo, what=_what, against=_against, use_merge_base=merge_base)
         patch_set = filter_diff(patch_set, filters)
         cfg = ProjectConfig.load_for_repo(repo)
@@ -266,5 +276,3 @@ def files(
             print(f"- {color(patch.path)}")
             if diff:
                 print(mc.ui.gray(textwrap.indent(str(patch), "  ")))
-    finally:
-        repo.close()

{github_code_review-3.4.3 → github_code_review-3.6.0}/gito/cli_base.py

@@ -1,12 +1,14 @@
+"""Common CLI arguments and utilities for Gito commands."""
 import contextlib
 import logging
 import tempfile
+from typing import Iterator
 
 import microcore as mc
 import typer
-from git import Repo
-from gito.constants import REFS_VALUE_ALL
+from git import Repo, InvalidGitRepositoryError
 
+from .constants import REFS_VALUE_ALL
 from .utils import parse_refs_pair
 from .env import Env
 
@@ -73,14 +75,27 @@ def arg_against() -> typer.Option:
     )
 
 
+def arg_all() -> typer.Option:
+    return typer.Option(default=False, help="Review whole codebase")
+
+
 app = typer.Typer(pretty_exceptions_show_locals=False)
 
 
 @contextlib.contextmanager
-def get_repo_context(url: str, branch: str):
+def get_repo_context(
+    url: str | None,
+    branch: str | None
+) -> Iterator[tuple[Repo, str]]:
+    """
+    Context manager for handling both local and remote repositories.
+    Yields a tuple of (Repo object, path to the repository)
+    Args:
+        url (str): URL of the remote repository. If empty, uses the local repository.
+        branch (str): Branch to checkout when cloning the remote repository.
+    """
     if branch == REFS_VALUE_ALL:
         branch = None
-    """Context manager for handling both local and remote repositories."""
     if url:
         with tempfile.TemporaryDirectory() as temp_dir:
             logging.info(
@@ -97,7 +112,10 @@ def get_repo_context(url: str, branch: str):
                 Env.working_folder = prev_folder
     else:
         logging.info("get_repo_context: Using local repo...")
-        repo = Repo(".")
+        try:
+            repo = Repo(".")
+        except InvalidGitRepositoryError:
+            raise typer.BadParameter("Current folder is not a git repository.")
         try:
             yield repo, "."
         finally:

{github_code_review-3.4.3 → github_code_review-3.6.0}/gito/commands/fix.py

@@ -145,6 +145,10 @@ def commit_changes(
     commit_message: str = "fix by AI",
     push: bool = True
 ) -> None:
+    """
+    Commit and optionally push changes to the remote repository.
+    Raises typer.Exit on failure.
+    """
     if opened_repo := not repo:
         repo = git.Repo(".")
     for i in files:
@@ -152,7 +156,15 @@ def commit_changes(
     repo.index.commit(commit_message)
     if push:
         origin = repo.remotes.origin
-        origin.push()
+        push_results = origin.push()
+        for push_info in push_results:
+            if push_info.flags & (
+                git.PushInfo.ERROR
+                | git.PushInfo.REJECTED
+                | git.PushInfo.REMOTE_REJECTED
+            ):
+                logging.error(f"Push failed: {push_info.summary}")
+                raise typer.Exit(code=1)
         logging.info(f"Changes pushed to {origin.name}")
     else:
         logging.info("Changes committed but not pushed to remote")

github_code_review-3.6.0/gito/entrypoint.py

@@ -0,0 +1,10 @@
+"""Entry point for the Gito command-line interface (CLI)."""
+
+from .git_installation_check import ensure_git_installed
+
+ensure_git_installed()  # should be called before importing other modules that depend on Git
+
+# flake8: noqa: E402, F401
+from .cli import main
+
+__all__ = ["main"]

github_code_review-3.6.0/gito/env.py

@@ -0,0 +1,22 @@
+import logging
+from importlib.metadata import version, PackageNotFoundError
+
+
+def gito_version() -> str:
+    """
+    Retrieve the current version of gito.bot package.
+    Returns:
+        str: The version string of the gito.bot package, or "{Dev}" if not found.
+    """
+    try:
+        return version("gito.bot")
+    except PackageNotFoundError:
+        logging.warning("Could not retrieve gito.bot version.")
+        return "{Dev}"
+
+
+class Env:
+    logging_level: int = 1
+    verbosity: int = 1
+    gito_version: str = gito_version()
+    working_folder = "."

github_code_review-3.6.0/gito/git_installation_check.py

@@ -0,0 +1,57 @@
+"""
+Checks if Git is installed; if not, provides installation instructions.
+"""
+import platform
+import sys
+
+from microcore import ui
+
+
+def ensure_git_installed() -> None:
+    """Ensures that Git is installed on the system."""
+    try:
+        from git import Repo  # noqa: F401
+    except ImportError:
+        _exit_with_git_instructions()
+
+
+def _exit_with_git_instructions() -> None:
+    """Exits the program with instructions to install Git."""
+    cmd = _get_git_install_command()
+    app_name = f"{ui.bright}Gito AI Code Reviewer{ui.reset}{ui.red}"
+    msg_begin = (
+        f"{ui.red}Error: {app_name} couldn't find "
+        f"{ui.bright}Git{ui.reset}{ui.red} on the system."
+        f"\n{ui.red}"
+    )
+    if cmd:
+        details = f"To install {ui.bright}Git{ui.reset}{ui.red}, run: {ui.blue}{cmd}{ui.reset}"
+    else:
+        details = "Please install it from: https://git-scm.com"
+    sys.exit(msg_begin + details)
+
+
+def _get_git_install_command() -> str | None:
+    """Returns the command to install Git based on the operating system."""
+    system = platform.system().lower()
+
+    if system == "windows":
+        return "winget install Git.Git"
+    elif system == "darwin":
+        return "brew install git"
+    elif system == "linux":
+        try:
+            with open("/etc/os-release") as f:
+                os_release = f.read().lower()
+        except FileNotFoundError:
+            return None
+
+        if "alpine" in os_release:
+            return "apk add git"
+        if "debian" in os_release or "ubuntu" in os_release:
+            return "sudo apt install git"
+        if "fedora" in os_release:
+            return "sudo dnf install git"
+        if "arch" in os_release:
+            return "sudo pacman -S git"
+    return None

{github_code_review-3.4.3 → github_code_review-3.6.0}/gito/report_struct.py

@@ -92,7 +92,7 @@ class Report:
     number_of_processed_files: int = field(default=0)
     total_issues: int = field(init=False)
     created_at: str = field(default_factory=lambda: datetime.now().strftime("%Y-%m-%d %H:%M:%S"))
-    model: str = field(default_factory=lambda: mc.config().MODEL)
+    model: str = field(default_factory=lambda: mc.config().MODEL or "")
     pipeline_out: dict = field(default_factory=dict)
     processing_warnings: list[ProcessingWarning] = field(default_factory=list)
 

{github_code_review-3.4.3 → github_code_review-3.6.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "github-code-review"
-version = "3.4.3"
+version = "3.6.0"
 description = "AI code review tool that works with any language model provider. It detects issues in GitHub pull requests or local changes—instantly, reliably, and without vendor lock-in."
 authors = ["Nayjest <mail@vitaliy.in>"]
 readme = "README.md"
@@ -21,7 +21,7 @@ packages = [
 
 [tool.poetry.dependencies]
 python = "^3.11"
-ai-microcore = "~4.5"
+ai-microcore = "~4"
 GitPython = "^3.1.44"
 unidiff = "^0.7.5"
 google-generativeai = "^0.8.5"
@@ -51,7 +51,7 @@ requires = ["poetry-core"]
 build-backend = "poetry.core.masonry.api"
 
 [tool.poetry.scripts]
-gito = "gito.cli:main"
+gito = "gito.entrypoint:main"
 
 [tool.pytest.ini_options]
 minversion = "6.0"

github_code_review-3.4.3/gito/__main__.py

@@ -1,4 +0,0 @@
-from .cli import main
-
-if __name__ == "__main__":
-    main()

github_code_review-3.4.3/gito/env.py

@@ -1,8 +0,0 @@
-from importlib.metadata import version
-
-
-class Env:
-    logging_level: int = 1
-    verbosity: int = 1
-    gito_version: str = version("gito.bot")
-    working_folder = "."