gac 1.12.1__tar.gz → 2.7.3__tar.gz

{gac-1.12.1 → gac-2.7.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gac
-Version: 1.12.1
+Version: 2.7.3
 Summary: LLM-powered Git commit message generator with multi-provider support
 Project-URL: Homepage, https://github.com/cellwebb/gac
 Project-URL: Documentation, https://github.com/cellwebb/gac#readme
@@ -25,6 +25,7 @@ Requires-Dist: click>=8.3.0
 Requires-Dist: halo
 Requires-Dist: httpcore>=1.0.9
 Requires-Dist: httpx>=0.28.0
+Requires-Dist: prompt-toolkit>=3.0.36
 Requires-Dist: pydantic>=2.12.0
 Requires-Dist: python-dotenv>=1.1.1
 Requires-Dist: questionary
@@ -40,6 +41,9 @@ Requires-Dist: twine; extra == 'dev'
 Description-Content-Type: text/markdown
 
 <!-- markdownlint-disable MD013 -->
+<!-- markdownlint-disable MD033 MD036 -->
+
+<div align="center">
 
 # 🚀 Git Auto Commit (gac)
 
@@ -49,12 +53,14 @@ Description-Content-Type: text/markdown
 [![codecov](https://codecov.io/gh/cellwebb/gac/branch/main/graph/badge.svg)](https://app.codecov.io/gh/cellwebb/gac)
 [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
 [![mypy](https://img.shields.io/badge/mypy-checked-blue.svg)](https://mypy-lang.org/)
-[![Contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg)](docs/CONTRIBUTING.md)
+[![Contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg)](docs/en/CONTRIBUTING.md)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
-**LLM-powered commit messages that understand your code.**
+**English** | [简体中文](docs/zh-CN/README.md) | [繁體中文](docs/zh-TW/README.md) | [日本語](docs/ja/README.md) | [한국어](docs/ko/README.md) | [हिन्दी](docs/hi/README.md) | [Tiếng Việt](docs/vi/README.md) | [Français](docs/fr/README.md) | [Русский](docs/ru/README.md) | [Español](docs/es/README.md) | [Português](docs/pt/README.md) | [Norsk](docs/no/README.md) | [Svenska](docs/sv/README.md) | [Deutsch](docs/de/README.md) | [Nederlands](docs/nl/README.md) | [Italiano](docs/it/README.md)
+
+**LLM-powered commit messages that understand your code!**
 
-**Tired of writing commit messages?** Replace `git commit -m "..."` with `gac` for contextual, well-formatted commit messages generated by large language models.
+**Automate your commits!** Replace `git commit -m "..."` with `gac` for contextual, well-formatted commit messages generated by large language models!
 
 ---
 
@@ -66,18 +72,22 @@ Intelligent, contextual messages that explain the **why** behind your changes:
 
 ---
 
+</div>
+
+<!-- markdownlint-enable MD033 MD036 -->
+
 ## Quick Start
 
-### Use without installing
+### Use gac without installing
 
 ```bash
-uvx gac init  # Configure your LLM provider
+uvx gac init   # Configure your provider, model, and language
 uvx gac  # Generate and commit with LLM
 ```
 
 That's it! Review the generated message and confirm with `y`.
 
-### Install gac globally
+### Install and use gac
 
 ```bash
 uv tool install gac
@@ -85,21 +95,29 @@ gac init
 gac
 ```
 
+### Upgrade installed gac
+
+```bash
+uv tool upgrade gac
+```
+
 ---
 
 ## Key Features
 
 ### 🌐 **Supported Providers**
 
-- **Anthropic** • **Cerebras** • **Chutes.ai** • **DeepSeek** • **Fireworks** • **Gemini**
-- **Groq** • **LM Studio** • **MiniMax** • **Ollama** • **OpenAI** • **OpenRouter**
-- **Streamlake** • **Synthetic.new** • **Together AI** • **Z.AI** • **Z.AI Coding**
+- **Anthropic** • **Cerebras** • **Chutes.ai** • **Claude Code** • **DeepSeek**
+- **Fireworks** • **Gemini** • **Groq** • **LM Studio** • **MiniMax** • **Mistral** • **Ollama**
+- **OpenAI** • **OpenRouter** • **Streamlake** • **Synthetic.new** • **Together AI**
+- **Z.AI** • **Z.AI Coding** • **Custom Endpoints (Anthropic/OpenAI)**
 
 ### 🧠 **Smart LLM Analysis**
 
 - **Understands intent**: Analyzes code structure, logic, and patterns to understand the "why" behind your changes, not just what changed
 - **Semantic awareness**: Recognizes refactoring, bug fixes, features, and breaking changes to generate contextually appropriate messages
 - **Intelligent filtering**: Prioritizes meaningful changes while ignoring generated files, dependencies, and artifacts
+- **Intelligent commit grouping** - Automatically group related changes into multiple logical commits with `--group`
 
 ### 📝 **Multiple Message Formats**
 
@@ -107,9 +125,16 @@ gac
 - **Standard** (default): Summary with bullet points explaining implementation details
 - **Verbose** (-v flag): Comprehensive explanations including motivation, technical approach, and impact analysis
 
+### 🌍 **Multilingual Support**
+
+- **25+ languages**: Generate commit messages in English, Chinese, Japanese, Korean, Spanish, French, German, and 20+ more languages
+- **Flexible translation**: Choose to keep conventional commit prefixes in English for tool compatibility, or fully translate them
+- **Multiple workflows**: Set a default language with `gac language`, or use `-l <language>` flag for one-time overrides
+- **Native script support**: Full support for non-Latin scripts including CJK, Cyrillic, Arabic, and more
+
 ### 💻 **Developer Experience**
 
-- **Interactive feedback**: Regenerate messages with specific requests like `r "make it shorter"` or `r "focus on the bug fix"`
+- **Interactive feedback**: Type `r` to reroll, `e` to edit in-place with vi/emacs keybindings, or directly type your feedback like `make it shorter` or `focus on the bug fix`
 - **One-command workflows**: Complete workflows with flags like `gac -ayp` (stage all, auto-confirm, push)
 - **Git integration**: Respects pre-commit and lefthook hooks, running them before expensive LLM operations
 
@@ -132,7 +157,7 @@ git add .
 # Generate and commit with LLM
 gac
 
-# Review → y (commit) | n (cancel) | r (reroll)
+# Review → y (commit) | n (cancel) | r (reroll) | e (edit) | or type feedback
 ```
 
 ### Common Commands
@@ -160,6 +185,9 @@ gac -v -s
 # Quick one-liner for small changes
 gac -o
 
+# Group changes into logically related commits
+gac -ag
+
 # Debug what the LLM sees
 gac --show-prompt
 
@@ -167,26 +195,42 @@ gac --show-prompt
 gac --skip-secret-scan
 ```
 
-### Interactive Reroll System
+### Interactive Feedback System
 
-Not happy with the result? Use the reroll feature for intelligent regeneration:
+Not happy with the result? You have several options:
 
 ```bash
-# Simple reroll
+# Simple reroll (no feedback)
 r
 
-# With specific feedback
-r make it shorter and focus on the performance improvement
-r use conventional commit format with scope
-r explain the security implications
+# Edit in-place with rich terminal editing
+e
+# Uses prompt_toolkit for multi-line editing with vi/emacs keybindings
+# Press Esc+Enter or Ctrl+S to submit, Ctrl+C to cancel
+
+# Or just type your feedback directly!
+make it shorter and focus on the performance improvement
+use conventional commit format with scope
+explain the security implications
+
+# Press Enter on empty input to see the prompt again
 ```
 
+The edit feature (`e`) provides rich in-place terminal editing, allowing you to:
+
+- **Edit naturally**: Multi-line editing with familiar vi/emacs key bindings
+- **Make quick fixes**: Correct typos, adjust wording, or refine formatting
+- **Add details**: Include information the LLM might have missed
+- **Restructure**: Reorganize bullet points or change the message structure
+
 ---
 
 ## Configuration
 
 Run `gac init` to configure your provider interactively, or set environment variables:
 
+Need to change providers or models later without touching language settings? Use `gac model` for a streamlined flow that skips the language prompts.
+
 ```bash
 # Example configuration
 GAC_MODEL=anthropic:your-model-name
@@ -196,13 +240,26 @@ ANTHROPIC_API_KEY=your_key_here
 
 See `.gac.env.example` for all available options.
 
+**Want commit messages in another language?** Run `gac language` to select from 25+ languages including Español, Français, 日本語, and more.
+
+**Want to customize commit message style?** See [docs/CUSTOM_SYSTEM_PROMPTS.md](docs/en/CUSTOM_SYSTEM_PROMPTS.md) for guidance on writing custom system prompts.
+
+---
+
+## Project Analytics
+
+📊 **[View live usage analytics and statistics →](https://clickpy.clickhouse.com/dashboard/gac)**
+
+Track real-time installation metrics and package download statistics.
+
 ---
 
 ## Getting Help
 
-- **Full documentation**: [USAGE.md](USAGE.md) - Complete CLI reference
-- **Troubleshooting**: [TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md) - Common issues and solutions
-- **Contributing**: [CONTRIBUTING.md](docs/CONTRIBUTING.md) - Development setup and guidelines
+- **Full documentation**: [docs/USAGE.md](docs/en/USAGE.md) - Complete CLI reference
+- **Custom prompts**: [docs/CUSTOM_SYSTEM_PROMPTS.md](docs/en/CUSTOM_SYSTEM_PROMPTS.md) - Customize commit message style
+- **Troubleshooting**: [docs/TROUBLESHOOTING.md](docs/en/TROUBLESHOOTING.md) - Common issues and solutions
+- **Contributing**: [docs/CONTRIBUTING.md](docs/en/CONTRIBUTING.md) - Development setup and guidelines
 
 ---
 
@@ -212,7 +269,7 @@ See `.gac.env.example` for all available options.
 
 Made with ❤️ for developers who want better commit messages
 
-[⭐ Star us on GitHub](https://github.com/cellwebb/gac) • [🐛 Report issues](https://github.com/cellwebb/gac/issues) • [📖 Full docs](USAGE.md)
+[⭐ Star us on GitHub](https://github.com/cellwebb/gac) • [🐛 Report issues](https://github.com/cellwebb/gac/issues) • [📖 Full docs](docs/en/USAGE.md)
 
 </div>
 

{gac-1.12.1 → gac-2.7.3}/README.md

@@ -1,4 +1,7 @@
 <!-- markdownlint-disable MD013 -->
+<!-- markdownlint-disable MD033 MD036 -->
+
+<div align="center">
 
 # 🚀 Git Auto Commit (gac)
 
@@ -8,12 +11,14 @@
 [![codecov](https://codecov.io/gh/cellwebb/gac/branch/main/graph/badge.svg)](https://app.codecov.io/gh/cellwebb/gac)
 [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
 [![mypy](https://img.shields.io/badge/mypy-checked-blue.svg)](https://mypy-lang.org/)
-[![Contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg)](docs/CONTRIBUTING.md)
+[![Contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg)](docs/en/CONTRIBUTING.md)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
-**LLM-powered commit messages that understand your code.**
+**English** | [简体中文](docs/zh-CN/README.md) | [繁體中文](docs/zh-TW/README.md) | [日本語](docs/ja/README.md) | [한국어](docs/ko/README.md) | [हिन्दी](docs/hi/README.md) | [Tiếng Việt](docs/vi/README.md) | [Français](docs/fr/README.md) | [Русский](docs/ru/README.md) | [Español](docs/es/README.md) | [Português](docs/pt/README.md) | [Norsk](docs/no/README.md) | [Svenska](docs/sv/README.md) | [Deutsch](docs/de/README.md) | [Nederlands](docs/nl/README.md) | [Italiano](docs/it/README.md)
+
+**LLM-powered commit messages that understand your code!**
 
-**Tired of writing commit messages?** Replace `git commit -m "..."` with `gac` for contextual, well-formatted commit messages generated by large language models.
+**Automate your commits!** Replace `git commit -m "..."` with `gac` for contextual, well-formatted commit messages generated by large language models!
 
 ---
 
@@ -25,18 +30,22 @@ Intelligent, contextual messages that explain the **why** behind your changes:
 
 ---
 
+</div>
+
+<!-- markdownlint-enable MD033 MD036 -->
+
 ## Quick Start
 
-### Use without installing
+### Use gac without installing
 
 ```bash
-uvx gac init  # Configure your LLM provider
+uvx gac init   # Configure your provider, model, and language
 uvx gac  # Generate and commit with LLM
 ```
 
 That's it! Review the generated message and confirm with `y`.
 
-### Install gac globally
+### Install and use gac
 
 ```bash
 uv tool install gac
@@ -44,21 +53,29 @@ gac init
 gac
 ```
 
+### Upgrade installed gac
+
+```bash
+uv tool upgrade gac
+```
+
 ---
 
 ## Key Features
 
 ### 🌐 **Supported Providers**
 
-- **Anthropic** • **Cerebras** • **Chutes.ai** • **DeepSeek** • **Fireworks** • **Gemini**
-- **Groq** • **LM Studio** • **MiniMax** • **Ollama** • **OpenAI** • **OpenRouter**
-- **Streamlake** • **Synthetic.new** • **Together AI** • **Z.AI** • **Z.AI Coding**
+- **Anthropic** • **Cerebras** • **Chutes.ai** • **Claude Code** • **DeepSeek**
+- **Fireworks** • **Gemini** • **Groq** • **LM Studio** • **MiniMax** • **Mistral** • **Ollama**
+- **OpenAI** • **OpenRouter** • **Streamlake** • **Synthetic.new** • **Together AI**
+- **Z.AI** • **Z.AI Coding** • **Custom Endpoints (Anthropic/OpenAI)**
 
 ### 🧠 **Smart LLM Analysis**
 
 - **Understands intent**: Analyzes code structure, logic, and patterns to understand the "why" behind your changes, not just what changed
 - **Semantic awareness**: Recognizes refactoring, bug fixes, features, and breaking changes to generate contextually appropriate messages
 - **Intelligent filtering**: Prioritizes meaningful changes while ignoring generated files, dependencies, and artifacts
+- **Intelligent commit grouping** - Automatically group related changes into multiple logical commits with `--group`
 
 ### 📝 **Multiple Message Formats**
 
@@ -66,9 +83,16 @@ gac
 - **Standard** (default): Summary with bullet points explaining implementation details
 - **Verbose** (-v flag): Comprehensive explanations including motivation, technical approach, and impact analysis
 
+### 🌍 **Multilingual Support**
+
+- **25+ languages**: Generate commit messages in English, Chinese, Japanese, Korean, Spanish, French, German, and 20+ more languages
+- **Flexible translation**: Choose to keep conventional commit prefixes in English for tool compatibility, or fully translate them
+- **Multiple workflows**: Set a default language with `gac language`, or use `-l <language>` flag for one-time overrides
+- **Native script support**: Full support for non-Latin scripts including CJK, Cyrillic, Arabic, and more
+
 ### 💻 **Developer Experience**
 
-- **Interactive feedback**: Regenerate messages with specific requests like `r "make it shorter"` or `r "focus on the bug fix"`
+- **Interactive feedback**: Type `r` to reroll, `e` to edit in-place with vi/emacs keybindings, or directly type your feedback like `make it shorter` or `focus on the bug fix`
 - **One-command workflows**: Complete workflows with flags like `gac -ayp` (stage all, auto-confirm, push)
 - **Git integration**: Respects pre-commit and lefthook hooks, running them before expensive LLM operations
 
@@ -91,7 +115,7 @@ git add .
 # Generate and commit with LLM
 gac
 
-# Review → y (commit) | n (cancel) | r (reroll)
+# Review → y (commit) | n (cancel) | r (reroll) | e (edit) | or type feedback
 ```
 
 ### Common Commands
@@ -119,6 +143,9 @@ gac -v -s
 # Quick one-liner for small changes
 gac -o
 
+# Group changes into logically related commits
+gac -ag
+
 # Debug what the LLM sees
 gac --show-prompt
 
@@ -126,26 +153,42 @@ gac --show-prompt
 gac --skip-secret-scan
 ```
 
-### Interactive Reroll System
+### Interactive Feedback System
 
-Not happy with the result? Use the reroll feature for intelligent regeneration:
+Not happy with the result? You have several options:
 
 ```bash
-# Simple reroll
+# Simple reroll (no feedback)
 r
 
-# With specific feedback
-r make it shorter and focus on the performance improvement
-r use conventional commit format with scope
-r explain the security implications
+# Edit in-place with rich terminal editing
+e
+# Uses prompt_toolkit for multi-line editing with vi/emacs keybindings
+# Press Esc+Enter or Ctrl+S to submit, Ctrl+C to cancel
+
+# Or just type your feedback directly!
+make it shorter and focus on the performance improvement
+use conventional commit format with scope
+explain the security implications
+
+# Press Enter on empty input to see the prompt again
 ```
 
+The edit feature (`e`) provides rich in-place terminal editing, allowing you to:
+
+- **Edit naturally**: Multi-line editing with familiar vi/emacs key bindings
+- **Make quick fixes**: Correct typos, adjust wording, or refine formatting
+- **Add details**: Include information the LLM might have missed
+- **Restructure**: Reorganize bullet points or change the message structure
+
 ---
 
 ## Configuration
 
 Run `gac init` to configure your provider interactively, or set environment variables:
 
+Need to change providers or models later without touching language settings? Use `gac model` for a streamlined flow that skips the language prompts.
+
 ```bash
 # Example configuration
 GAC_MODEL=anthropic:your-model-name
@@ -155,13 +198,26 @@ ANTHROPIC_API_KEY=your_key_here
 
 See `.gac.env.example` for all available options.
 
+**Want commit messages in another language?** Run `gac language` to select from 25+ languages including Español, Français, 日本語, and more.
+
+**Want to customize commit message style?** See [docs/CUSTOM_SYSTEM_PROMPTS.md](docs/en/CUSTOM_SYSTEM_PROMPTS.md) for guidance on writing custom system prompts.
+
+---
+
+## Project Analytics
+
+📊 **[View live usage analytics and statistics →](https://clickpy.clickhouse.com/dashboard/gac)**
+
+Track real-time installation metrics and package download statistics.
+
 ---
 
 ## Getting Help
 
-- **Full documentation**: [USAGE.md](USAGE.md) - Complete CLI reference
-- **Troubleshooting**: [TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md) - Common issues and solutions
-- **Contributing**: [CONTRIBUTING.md](docs/CONTRIBUTING.md) - Development setup and guidelines
+- **Full documentation**: [docs/USAGE.md](docs/en/USAGE.md) - Complete CLI reference
+- **Custom prompts**: [docs/CUSTOM_SYSTEM_PROMPTS.md](docs/en/CUSTOM_SYSTEM_PROMPTS.md) - Customize commit message style
+- **Troubleshooting**: [docs/TROUBLESHOOTING.md](docs/en/TROUBLESHOOTING.md) - Common issues and solutions
+- **Contributing**: [docs/CONTRIBUTING.md](docs/en/CONTRIBUTING.md) - Development setup and guidelines
 
 ---
 
@@ -171,7 +227,7 @@ See `.gac.env.example` for all available options.
 
 Made with ❤️ for developers who want better commit messages
 
-[⭐ Star us on GitHub](https://github.com/cellwebb/gac) • [🐛 Report issues](https://github.com/cellwebb/gac/issues) • [📖 Full docs](USAGE.md)
+[⭐ Star us on GitHub](https://github.com/cellwebb/gac) • [🐛 Report issues](https://github.com/cellwebb/gac/issues) • [📖 Full docs](docs/en/USAGE.md)
 
 </div>
 

{gac-1.12.1 → gac-2.7.3}/pyproject.toml

@@ -41,6 +41,7 @@ dependencies = [
     "halo",
     "questionary",
     "rich>=14.1.0",
+    "prompt_toolkit>=3.0.36",
 
 ]
 

{gac-1.12.1 → gac-2.7.3}/src/gac/__version__.py

@@ -1,3 +1,3 @@
 """Version information for gac package."""
 
-__version__ = "1.12.1"
+__version__ = "2.7.3"

{gac-1.12.1 → gac-2.7.3}/src/gac/ai.py

@@ -13,12 +13,16 @@ from gac.providers import (
     call_anthropic_api,
     call_cerebras_api,
     call_chutes_api,
+    call_claude_code_api,
+    call_custom_anthropic_api,
+    call_custom_openai_api,
     call_deepseek_api,
     call_fireworks_api,
     call_gemini_api,
     call_groq_api,
     call_lmstudio_api,
     call_minimax_api,
+    call_mistral_api,
     call_ollama_api,
     call_openai_api,
     call_openrouter_api,
@@ -39,11 +43,13 @@ def generate_commit_message(
     max_tokens: int = EnvDefaults.MAX_OUTPUT_TOKENS,
     max_retries: int = EnvDefaults.MAX_RETRIES,
     quiet: bool = False,
+    is_group: bool = False,
+    skip_success_message: bool = False,
 ) -> str:
     """Generate a commit message using direct API calls to AI providers.
 
     Args:
-        model: The model to use in provider:model_name format (e.g., 'anthropic:claude-3-5-haiku-latest')
+        model: The model to use in provider:model_name format (e.g., 'anthropic:claude-haiku-4-5')
         prompt: Either a string prompt (for backward compatibility) or tuple of (system_prompt, user_prompt)
         temperature: Controls randomness (0.0-1.0), lower values are more deterministic
         max_tokens: Maximum tokens in the response
@@ -57,7 +63,7 @@ def generate_commit_message(
         AIError: If generation fails after max_retries attempts
 
     Example:
-        >>> model = "anthropic:claude-3-5-haiku-latest"
+        >>> model = "anthropic:claude-haiku-4-5"
         >>> system_prompt, user_prompt = build_prompt("On branch main", "diff --git a/README.md b/README.md")
         >>> generate_commit_message(model, (system_prompt, user_prompt))
         'docs: Update README with installation instructions'
@@ -83,13 +89,17 @@ def generate_commit_message(
     provider_funcs = {
         "anthropic": call_anthropic_api,
         "cerebras": call_cerebras_api,
+        "claude-code": call_claude_code_api,
         "chutes": call_chutes_api,
+        "custom-anthropic": call_custom_anthropic_api,
+        "custom-openai": call_custom_openai_api,
         "deepseek": call_deepseek_api,
         "fireworks": call_fireworks_api,
         "gemini": call_gemini_api,
         "groq": call_groq_api,
         "lm-studio": call_lmstudio_api,
         "minimax": call_minimax_api,
+        "mistral": call_mistral_api,
         "ollama": call_ollama_api,
         "openai": call_openai_api,
         "openrouter": call_openrouter_api,
@@ -110,6 +120,8 @@ def generate_commit_message(
             max_tokens=max_tokens,
             max_retries=max_retries,
             quiet=quiet,
+            is_group=is_group,
+            skip_success_message=skip_success_message,
         )
     except AIError:
         # Re-raise AIError exceptions as-is to preserve error classification
@@ -117,3 +129,25 @@ def generate_commit_message(
     except Exception as e:
         logger.error(f"Failed to generate commit message: {e}")
         raise AIError.model_error(f"Failed to generate commit message: {e}") from e
+
+
+def generate_grouped_commits(
+    model: str,
+    prompt: list[dict[str, str]],
+    temperature: float,
+    max_tokens: int,
+    max_retries: int,
+    quiet: bool = False,
+    skip_success_message: bool = False,
+) -> str:
+    """Generate grouped commits JSON response."""
+    return generate_commit_message(
+        model=model,
+        prompt=prompt,
+        temperature=temperature,
+        max_tokens=max_tokens,
+        max_retries=max_retries,
+        quiet=quiet,
+        is_group=True,
+        skip_success_message=skip_success_message,
+    )