ace-git-copilot 0.1.0__tar.gz → 0.1.2__tar.gz

ace_git_copilot-0.1.2/PKG-INFO

@@ -0,0 +1,119 @@
+Metadata-Version: 2.4
+Name: ace-git-copilot
+Version: 0.1.2
+Summary: AI-powered Git copilot — talk to Git in plain English
+Requires-Python: >=3.11
+Requires-Dist: click>=8.0
+Requires-Dist: gitpython>=3.1
+Requires-Dist: langchain-nvidia-ai-endpoints>=0.3
+Requires-Dist: langchain-ollama>=0.3
+Requires-Dist: langchain>=0.3
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: rich>=13.0
+Requires-Dist: toml>=0.10.2
+Requires-Dist: typer[all]>=0.12
+Provides-Extra: dev
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# ♠️ Ace — AI-Powered Git Copilot
+
+[![PyPI Version](https://img.shields.io/pypi/v/ace-git-copilot?color=blue)](https://pypi.org/project/ace-git-copilot/)
+[![Python Version](https://img.shields.io/pypi/pyversions/ace-git-copilot)](https://pypi.org/project/ace-git-copilot/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**Ace** is an intelligent command-line tool that brings AI assistance directly to your Git workflow. Talk to Git in plain English — Ace translates your intents into Git commands, explains what it is doing, and runs them safely. It also features a fully interactive terminal user interface (TUI) dashboard to help manage your repositories with ease.
+
+---
+
+## ✨ Features
+
+*   **🧠 Natural Language Git Commands**: Translate commands like `"undo my last commit but keep changes"` or `"create a branch login-page"` into clean, standard Git actions.
+*   **📝 AI-Powered Commits**: Analyzes staged diffs and generates Conventional Commit messages automatically.
+*   **🔍 Automated Code Review**: Rates code quality and points out bugs, security flaws, or styling issues inside staged or unstaged diffs.
+*   **⚔️ Merge Conflict Resolution**: Interactively walks you through conflict blocks and suggests correct merges.
+*   **📊 Rich Repo Stats & Changelogs**: Instantly computes repository statistics (commits, additions, deletions, file counts) and generates markdown release notes since the last tag.
+*   **🔎 Semantic Commit Search**: Search commits by natural language queries (e.g. `"fixed the authorization bug"`) instead of matching literal strings.
+*   **🔥 Interactive TUI Dashboard**: Run `ace dash` to launch a beautiful terminal interface showing current status, branch info, commit charts, and interactive menus.
+*   **🛡️ Safety First**: Classifies actions into safe, moderate, or destructive levels, and requests confirmation before running destructive operations.
+
+---
+
+## 🚀 Installation
+
+Install the package directly from PyPI:
+```bash
+pip install ace-git-copilot
+```
+
+*Note: Make sure your Python scripts path (e.g., `AppData\Roaming\Python\Python3xx\Scripts` on Windows) is added to your environment `PATH` variable.*
+
+To update to the latest version:
+```bash
+pip install --upgrade ace-git-copilot
+```
+
+---
+
+## ⚙️ Configuration & Setup
+
+Run the built-in configuration wizard to select your AI model provider:
+```bash
+ace setup
+```
+Ace saves your configuration file to `~/.ace/config.toml`. It supports:
+1.  **NVIDIA NIM Cloud API** (high-speed, high-accuracy models) using your NVIDIA developer API key.
+2.  **Local Ollama Models** (100% offline, free private local models like `qwen2.5-coder`, `llama3.1`, or `mistral`). If the requested model isn't downloaded, Ace will automatically pull it for you.
+
+---
+
+## 🛠️ Usage
+
+### 💬 Natural Language Mode
+Run natural language requests directly in quotes:
+```bash
+ace "stage everything and commit with a message about authentication"
+ace "undo my last commit but keep the files"
+ace "switch to a new branch called design-updates"
+```
+
+### 📋 Command-Line Toolchain
+Ace has dedicated subcommands for specific tasks:
+
+| Command | Shorthand | Description |
+|:---|:---|:---|
+| `ace stage [files]` | `ace add` | Stage specific files or all untracked changes. |
+| `ace commit` | — | Generate Conventional Commit messages from diffs and commit. |
+| `ace review` | — | Run code review on staged, unstaged, or branch changes. |
+| `ace resolve` | — | Step-by-step interactive merge conflict resolver. |
+| `ace explain <query>`| — | Explain complex Git commands or repository errors. |
+| `ace stats` | — | Rich visualization of repo statistics, extension breakdowns, and history. |
+| `ace changelog` | — | Compile release changelogs since the last tag. |
+| `ace pr` | — | Draft a Markdown pull request title and description. |
+| `ace search <query>` | — | Semantically search commit history using natural language. |
+| `ace ignore <rule>` | — | Generate and append standard templates to `.gitignore`. |
+| `ace undo` | — | Safely revert the last action after checking repository status. |
+| `ace dash` | — | Launch the interactive repository management console. |
+| `ace config` | — | Print out active configuration settings. |
+
+---
+
+## 🎨 Interactive Terminal Dashboard (TUI)
+
+Launch the repository dashboard by running:
+```bash
+ace dash
+```
+
+The dashboard features:
+*   A vibrant start-up logo.
+*   Active branch info, tracking status, and repository charts.
+*   Interactive shortcuts for one-key commits, reviews, undos, and configuration management.
+
+---
+
+## 📄 License
+
+Distributed under the MIT License. See [LICENSE](LICENSE) for more details.

ace_git_copilot-0.1.2/README.md

@@ -0,0 +1,99 @@
+# ♠️ Ace — AI-Powered Git Copilot
+
+[![PyPI Version](https://img.shields.io/pypi/v/ace-git-copilot?color=blue)](https://pypi.org/project/ace-git-copilot/)
+[![Python Version](https://img.shields.io/pypi/pyversions/ace-git-copilot)](https://pypi.org/project/ace-git-copilot/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**Ace** is an intelligent command-line tool that brings AI assistance directly to your Git workflow. Talk to Git in plain English — Ace translates your intents into Git commands, explains what it is doing, and runs them safely. It also features a fully interactive terminal user interface (TUI) dashboard to help manage your repositories with ease.
+
+---
+
+## ✨ Features
+
+*   **🧠 Natural Language Git Commands**: Translate commands like `"undo my last commit but keep changes"` or `"create a branch login-page"` into clean, standard Git actions.
+*   **📝 AI-Powered Commits**: Analyzes staged diffs and generates Conventional Commit messages automatically.
+*   **🔍 Automated Code Review**: Rates code quality and points out bugs, security flaws, or styling issues inside staged or unstaged diffs.
+*   **⚔️ Merge Conflict Resolution**: Interactively walks you through conflict blocks and suggests correct merges.
+*   **📊 Rich Repo Stats & Changelogs**: Instantly computes repository statistics (commits, additions, deletions, file counts) and generates markdown release notes since the last tag.
+*   **🔎 Semantic Commit Search**: Search commits by natural language queries (e.g. `"fixed the authorization bug"`) instead of matching literal strings.
+*   **🔥 Interactive TUI Dashboard**: Run `ace dash` to launch a beautiful terminal interface showing current status, branch info, commit charts, and interactive menus.
+*   **🛡️ Safety First**: Classifies actions into safe, moderate, or destructive levels, and requests confirmation before running destructive operations.
+
+---
+
+## 🚀 Installation
+
+Install the package directly from PyPI:
+```bash
+pip install ace-git-copilot
+```
+
+*Note: Make sure your Python scripts path (e.g., `AppData\Roaming\Python\Python3xx\Scripts` on Windows) is added to your environment `PATH` variable.*
+
+To update to the latest version:
+```bash
+pip install --upgrade ace-git-copilot
+```
+
+---
+
+## ⚙️ Configuration & Setup
+
+Run the built-in configuration wizard to select your AI model provider:
+```bash
+ace setup
+```
+Ace saves your configuration file to `~/.ace/config.toml`. It supports:
+1.  **NVIDIA NIM Cloud API** (high-speed, high-accuracy models) using your NVIDIA developer API key.
+2.  **Local Ollama Models** (100% offline, free private local models like `qwen2.5-coder`, `llama3.1`, or `mistral`). If the requested model isn't downloaded, Ace will automatically pull it for you.
+
+---
+
+## 🛠️ Usage
+
+### 💬 Natural Language Mode
+Run natural language requests directly in quotes:
+```bash
+ace "stage everything and commit with a message about authentication"
+ace "undo my last commit but keep the files"
+ace "switch to a new branch called design-updates"
+```
+
+### 📋 Command-Line Toolchain
+Ace has dedicated subcommands for specific tasks:
+
+| Command | Shorthand | Description |
+|:---|:---|:---|
+| `ace stage [files]` | `ace add` | Stage specific files or all untracked changes. |
+| `ace commit` | — | Generate Conventional Commit messages from diffs and commit. |
+| `ace review` | — | Run code review on staged, unstaged, or branch changes. |
+| `ace resolve` | — | Step-by-step interactive merge conflict resolver. |
+| `ace explain <query>`| — | Explain complex Git commands or repository errors. |
+| `ace stats` | — | Rich visualization of repo statistics, extension breakdowns, and history. |
+| `ace changelog` | — | Compile release changelogs since the last tag. |
+| `ace pr` | — | Draft a Markdown pull request title and description. |
+| `ace search <query>` | — | Semantically search commit history using natural language. |
+| `ace ignore <rule>` | — | Generate and append standard templates to `.gitignore`. |
+| `ace undo` | — | Safely revert the last action after checking repository status. |
+| `ace dash` | — | Launch the interactive repository management console. |
+| `ace config` | — | Print out active configuration settings. |
+
+---
+
+## 🎨 Interactive Terminal Dashboard (TUI)
+
+Launch the repository dashboard by running:
+```bash
+ace dash
+```
+
+The dashboard features:
+*   A vibrant start-up logo.
+*   Active branch info, tracking status, and repository charts.
+*   Interactive shortcuts for one-key commits, reviews, undos, and configuration management.
+
+---
+
+## 📄 License
+
+Distributed under the MIT License. See [LICENSE](LICENSE) for more details.

ace_git_copilot-0.1.2/ace/__main__.py

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

{ace_git_copilot-0.1.0 → ace_git_copilot-0.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ace-git-copilot"
-version = "0.1.0"
+version = "0.1.2"
 description = "AI-powered Git copilot — talk to Git in plain English"
 readme = "README.md"
 requires-python = ">=3.11"

ace_git_copilot-0.1.0/PKG-INFO

@@ -1,113 +0,0 @@
-Metadata-Version: 2.4
-Name: ace-git-copilot
-Version: 0.1.0
-Summary: AI-powered Git copilot — talk to Git in plain English
-Requires-Python: >=3.11
-Requires-Dist: click>=8.0
-Requires-Dist: gitpython>=3.1
-Requires-Dist: langchain-nvidia-ai-endpoints>=0.3
-Requires-Dist: langchain-ollama>=0.3
-Requires-Dist: langchain>=0.3
-Requires-Dist: python-dotenv>=1.0
-Requires-Dist: rich>=13.0
-Requires-Dist: toml>=0.10.2
-Requires-Dist: typer[all]>=0.12
-Provides-Extra: dev
-Requires-Dist: pytest; extra == 'dev'
-Requires-Dist: pytest-cov; extra == 'dev'
-Requires-Dist: ruff; extra == 'dev'
-Description-Content-Type: text/markdown
-
-# Ace — AI-Powered Git Copilot
-
-> Ace is an intelligent terminal tool that understands what you want to do with Git and does it for you. Talk to Git in plain English — Ace figures out the right git commands, explains what it's doing, and executes safely.
-
----
-
-## 🚀 Installation
-
-Install in editable mode globally/user-wide:
-```bash
-python -m pip install --user -e D:\Ace
-```
-
-*Note: Make sure your Python scripts path (e.g., `AppData\Roaming\Python\Python3xx\Scripts`) is added to your Windows PATH environment variable.*
-
----
-
-## ⚙️ Configuration
-
-Configure your AI provider (NVIDIA NIM or local Ollama) by running:
-```bash
-ace setup
-```
-This will save your preferences to `~/.ace/config.toml`.
-
----
-
-## 🛠️ Usage & Commands
-
-### 🧠 Natural Language Input
-Run anything you want to do directly:
-```bash
-ace "stage all changes"
-ace "undo my last commit but keep changes"
-ace "create feature branch named login"
-```
-
-### 📋 Command Reference
-
-| Command | Shorthand | Description |
-|---------|-----------|-------------|
-| `ace add <files>` | `ace stage` | Stage files (`git add`) for commit. |
-| `ace commit` | — | Generate a smart Conventional Commit message and commit. |
-| `ace review` | — | AI code review of staged/unstaged changes. |
-| `ace resolve` | — | AI-assisted interactive merge conflict resolution. |
-| `ace changelog` | — | Generate markdown release notes since the last tag. |
-| `ace stats` | — | Enhanced visual repo overview, extension counts, and lines altered. |
-| `ace explain <cmd>` | — | Explain Git commands or concepts in plain English. |
-| `ace undo` | — | Context-aware smart undo (analyzes Git state to safely revert last action). |
-| `ace pr` | — | Generate a markdown Pull Request description comparing branches. |
-| `ace search <query>` | — | Semantic search across repository commits. |
-| `ace ignore <query>` | — | Generate and append rules to `.gitignore`. |
-| `ace dash` | — | Launch the interactive terminal dashboard TUI. |
-| `ace config` | — | View the active configuration settings. |
-
----
-
-## 📁 Codebase Directory & File Functions
-
-Here is the list of files in the project and what each one does:
-
-### 📍 Core CLI & Setup
-* **`pyproject.toml`**: Configures the project, entry points (`ace = ace.cli:app`), dependencies (`typer`, `rich`, `gitpython`, `langchain`), and build systems.
-* **`ace/cli.py`**: The entrypoint of the Typer application. Defines all CLI commands, parses command line flags, and routes calls.
-
-### ⚙️ Core Modules (`ace/core/`)
-* **`ace/core/config.py`**: Manages reading, writing, and parsing the user's TOML settings file (`config.toml`).
-* **`ace/core/git_ops.py`**: Wraps the GitPython library to perform programmatic Git commands (e.g. status, diff, log, commit, push).
-* **`ace/core/safety.py`**: Classifies Git commands into safety levels (Safe, Moderate, Destructive) and guards against destructive operations.
-* **`ace/core/context.py`**: Collects repository-wide details (branch, diffs, untracked files) to provide context for AI requests.
-
-### 🧠 AI Engine (`ace/ai/`)
-* **`ace/ai/llm_factory.py`**: Instantiates ChatNVIDIA (cloud) or ChatOllama (local) depending on configuration settings.
-* **`ace/ai/intent_parser.py`**: Translates the user's natural language input into Git commands.
-* **`ace/ai/commit_generator.py`**: Analyzes staged diffs and generates Conventional Commit messages.
-* **`ace/ai/code_reviewer.py`**: Analyzes unstaged or staged diffs to locate bugs, style flaws, security issues, and rate code.
-* **`ace/ai/conflict_resolver.py`**: Parses file-level merge conflicts and suggests correct merges.
-* **`ace/ai/changelog_generator.py`**: Collates commit messages and formats release logs.
-* **`ace/ai/history_analyzer.py`**: Runs semantic searches across log files and computes repository overview metrics.
-* **`ace/ai/pr_drafter.py`**: Drafts Pull Request titles and bodies comparing branch changes.
-* **`ace/ai/gitignore_generator.py`**: Generates `.gitignore` syntax templates.
-* **`ace/ai/prompts/`**: Houses all prompt templates for the LLMs (intent, commit, review, conflict, explain, undo, pr, search, ignore).
-
-### 🎨 User Interface (`ace/ui/`)
-* **`ace/ui/display.py`**: Directs Rich panel printouts, warning/error panels, and load spinners.
-* **`ace/ui/themes.py`**: Houses colors, styling, and markdown rules.
-* **`ace/ui/prompts.py`**: Handles keyboard selection options (e.g., commit/review prompts).
-* **`ace/ui/dashboard.py`**: Implements the interactive terminal dashboard (TUI) showing branch states and command routing menus.
-
-### 🔧 Utilities (`ace/utils/`)
-* **`ace/utils/json_utils.py`**: Extracts and parses clean JSON structures from Markdown code blocks.
-* **`ace/utils/diff_parser.py`**: Splits unified diff files into per-file chunks.
-* **`ace/utils/conflict_parser.py`**: Parses git conflict blocks inside file lines.

ace_git_copilot-0.1.0/README.md

@@ -1,93 +0,0 @@
-# Ace — AI-Powered Git Copilot
-
-> Ace is an intelligent terminal tool that understands what you want to do with Git and does it for you. Talk to Git in plain English — Ace figures out the right git commands, explains what it's doing, and executes safely.
-
----
-
-## 🚀 Installation
-
-Install in editable mode globally/user-wide:
-```bash
-python -m pip install --user -e D:\Ace
-```
-
-*Note: Make sure your Python scripts path (e.g., `AppData\Roaming\Python\Python3xx\Scripts`) is added to your Windows PATH environment variable.*
-
----
-
-## ⚙️ Configuration
-
-Configure your AI provider (NVIDIA NIM or local Ollama) by running:
-```bash
-ace setup
-```
-This will save your preferences to `~/.ace/config.toml`.
-
----
-
-## 🛠️ Usage & Commands
-
-### 🧠 Natural Language Input
-Run anything you want to do directly:
-```bash
-ace "stage all changes"
-ace "undo my last commit but keep changes"
-ace "create feature branch named login"
-```
-
-### 📋 Command Reference
-
-| Command | Shorthand | Description |
-|---------|-----------|-------------|
-| `ace add <files>` | `ace stage` | Stage files (`git add`) for commit. |
-| `ace commit` | — | Generate a smart Conventional Commit message and commit. |
-| `ace review` | — | AI code review of staged/unstaged changes. |
-| `ace resolve` | — | AI-assisted interactive merge conflict resolution. |
-| `ace changelog` | — | Generate markdown release notes since the last tag. |
-| `ace stats` | — | Enhanced visual repo overview, extension counts, and lines altered. |
-| `ace explain <cmd>` | — | Explain Git commands or concepts in plain English. |
-| `ace undo` | — | Context-aware smart undo (analyzes Git state to safely revert last action). |
-| `ace pr` | — | Generate a markdown Pull Request description comparing branches. |
-| `ace search <query>` | — | Semantic search across repository commits. |
-| `ace ignore <query>` | — | Generate and append rules to `.gitignore`. |
-| `ace dash` | — | Launch the interactive terminal dashboard TUI. |
-| `ace config` | — | View the active configuration settings. |
-
----
-
-## 📁 Codebase Directory & File Functions
-
-Here is the list of files in the project and what each one does:
-
-### 📍 Core CLI & Setup
-* **`pyproject.toml`**: Configures the project, entry points (`ace = ace.cli:app`), dependencies (`typer`, `rich`, `gitpython`, `langchain`), and build systems.
-* **`ace/cli.py`**: The entrypoint of the Typer application. Defines all CLI commands, parses command line flags, and routes calls.
-
-### ⚙️ Core Modules (`ace/core/`)
-* **`ace/core/config.py`**: Manages reading, writing, and parsing the user's TOML settings file (`config.toml`).
-* **`ace/core/git_ops.py`**: Wraps the GitPython library to perform programmatic Git commands (e.g. status, diff, log, commit, push).
-* **`ace/core/safety.py`**: Classifies Git commands into safety levels (Safe, Moderate, Destructive) and guards against destructive operations.
-* **`ace/core/context.py`**: Collects repository-wide details (branch, diffs, untracked files) to provide context for AI requests.
-
-### 🧠 AI Engine (`ace/ai/`)
-* **`ace/ai/llm_factory.py`**: Instantiates ChatNVIDIA (cloud) or ChatOllama (local) depending on configuration settings.
-* **`ace/ai/intent_parser.py`**: Translates the user's natural language input into Git commands.
-* **`ace/ai/commit_generator.py`**: Analyzes staged diffs and generates Conventional Commit messages.
-* **`ace/ai/code_reviewer.py`**: Analyzes unstaged or staged diffs to locate bugs, style flaws, security issues, and rate code.
-* **`ace/ai/conflict_resolver.py`**: Parses file-level merge conflicts and suggests correct merges.
-* **`ace/ai/changelog_generator.py`**: Collates commit messages and formats release logs.
-* **`ace/ai/history_analyzer.py`**: Runs semantic searches across log files and computes repository overview metrics.
-* **`ace/ai/pr_drafter.py`**: Drafts Pull Request titles and bodies comparing branch changes.
-* **`ace/ai/gitignore_generator.py`**: Generates `.gitignore` syntax templates.
-* **`ace/ai/prompts/`**: Houses all prompt templates for the LLMs (intent, commit, review, conflict, explain, undo, pr, search, ignore).
-
-### 🎨 User Interface (`ace/ui/`)
-* **`ace/ui/display.py`**: Directs Rich panel printouts, warning/error panels, and load spinners.
-* **`ace/ui/themes.py`**: Houses colors, styling, and markdown rules.
-* **`ace/ui/prompts.py`**: Handles keyboard selection options (e.g., commit/review prompts).
-* **`ace/ui/dashboard.py`**: Implements the interactive terminal dashboard (TUI) showing branch states and command routing menus.
-
-### 🔧 Utilities (`ace/utils/`)
-* **`ace/utils/json_utils.py`**: Extracts and parses clean JSON structures from Markdown code blocks.
-* **`ace/utils/diff_parser.py`**: Splits unified diff files into per-file chunks.
-* **`ace/utils/conflict_parser.py`**: Parses git conflict blocks inside file lines.