gac 1.8.0__py3-none-any.whl → 1.9.1__py3-none-any.whl

gac/__version__.py

@@ -1,3 +1,3 @@
 """Version information for gac package."""
 
-__version__ = "1.8.0"
+__version__ = "1.9.1"

gac/ai.py

@@ -73,7 +73,7 @@ def generate_commit_message(
         "chutes": call_chutes_api,
         "gemini": call_gemini_api,
         "groq": call_groq_api,
-        "lmstudio": call_lmstudio_api,
+        "lm-studio": call_lmstudio_api,
         "ollama": call_ollama_api,
         "openai": call_openai_api,
         "openrouter": call_openrouter_api,

gac/ai_utils.py

@@ -96,6 +96,7 @@ def generate_with_retries(
     supported_providers = [
         "anthropic",
         "cerebras",
+        "chutes",
         "gemini",
         "groq",
         "lm-studio",

gac/cli.py

@@ -45,7 +45,12 @@ logger = logging.getLogger(__name__)
 @click.option("--model", "-m", help="Override the default model (format: 'provider:model_name')")
 # Output options
 @click.option("--quiet", "-q", is_flag=True, help="Suppress non-error output")
-@click.option("--verbose", "-v", is_flag=True, help="Increase output verbosity to INFO")
+@click.option(
+    "--verbose",
+    "-v",
+    is_flag=True,
+    help="Generate detailed commit messages with motivation, architecture, and impact sections",
+)
 @click.option(
     "--log-level",
     default=config["log_level"],
@@ -82,8 +87,6 @@ def cli(
             print(f"Git Auto Commit (gac) version: {__version__}")
             sys.exit(0)
         effective_log_level = log_level
-        if verbose and log_level not in ("DEBUG", "INFO"):
-            effective_log_level = "INFO"
         if quiet:
             effective_log_level = "ERROR"
         setup_logging(effective_log_level)
@@ -92,6 +95,9 @@ def cli(
         # Determine if we should infer scope based on -s flag or always_include_scope setting
         infer_scope = bool(scope or config.get("always_include_scope", False))
 
+        # Determine if verbose mode should be enabled based on -v flag or verbose config setting
+        use_verbose = bool(verbose or config.get("verbose", False))
+
         try:
             main(
                 stage_all=add_all,
@@ -104,6 +110,7 @@ def cli(
                 push=push,
                 quiet=quiet,
                 dry_run=dry_run,
+                verbose=use_verbose,
                 no_verify=no_verify,
                 skip_secret_scan=skip_secret_scan or bool(config.get("skip_secret_scan", False)),
             )

gac/config.py

@@ -37,6 +37,7 @@ def load_config() -> dict[str, str | int | float | bool]:
         in ("true", "1", "yes", "on"),
         "skip_secret_scan": os.getenv("GAC_SKIP_SECRET_SCAN", str(EnvDefaults.SKIP_SECRET_SCAN)).lower()
         in ("true", "1", "yes", "on"),
+        "verbose": os.getenv("GAC_VERBOSE", str(EnvDefaults.VERBOSE)).lower() in ("true", "1", "yes", "on"),
     }
 
     return config

gac/constants.py

@@ -25,6 +25,7 @@ class EnvDefaults:
     WARNING_LIMIT_TOKENS: int = 16384
     ALWAYS_INCLUDE_SCOPE: bool = False
     SKIP_SECRET_SCAN: bool = False
+    VERBOSE: bool = False
 
 
 class Logging:

gac/main.py

@@ -43,6 +43,7 @@ def main(
     push: bool = False,
     quiet: bool = False,
     dry_run: bool = False,
+    verbose: bool = False,
     no_verify: bool = False,
     skip_secret_scan: bool = False,
 ) -> None:
@@ -178,6 +179,7 @@ def main(
         one_liner=one_liner,
         hint=hint,
         infer_scope=infer_scope,
+        verbose=verbose,
     )
 
     if show_prompt:
@@ -275,6 +277,7 @@ def main(
                                 one_liner=one_liner,
                                 hint=combined_hint,
                                 infer_scope=infer_scope,
+                                verbose=verbose,
                             )
                         else:
                             # No hint given, just reroll with same prompts

gac/prompt.py

@@ -43,7 +43,43 @@ When changes span multiple areas:
   - Detailed body with multiple bullet points explaining the key changes
   - Focus on WHY changes were made, not just WHAT was changed
   - Order points from most important to least important
-  </multi_line>
+  </multi_line><verbose>
+  IMPORTANT: You MUST create a MULTI-PARAGRAPH commit message with detailed sections.
+  DO NOT create a single-line commit message.
+
+  Your commit message MUST follow this structure:
+
+  Line 1: A concise summary (up to ~72 characters) with conventional commit prefix
+  Line 2: BLANK LINE (required)
+  Lines 3+: Detailed multi-paragraph body with the following sections:
+
+  ## Motivation
+  Explain why this commit exists in 2-3 sentences. What problem does it solve? What need does it address?
+
+  ## Architecture / Approach
+  Describe how it was implemented in 2-4 sentences. Include key design decisions and any rejected alternatives.
+  Reference specific modules, functions, or classes when relevant.
+
+  ## Affected Components
+  List the main modules, subsystems, or directories impacted by this change.
+
+  OPTIONAL sections (include only if relevant):
+
+  ## Performance / Security Impact
+  Describe any performance improvements, trade-offs, or security considerations.
+  Include concrete data such as benchmark results if available.
+
+  ## Compatibility / Testing
+  Mention any compatibility considerations, known limitations, testing performed, or next steps for validation.
+
+  REQUIREMENTS:
+  - Your response MUST be at least 10 lines long with multiple paragraphs
+  - Use active voice and present tense ("Implements", "Adds", "Refactors")
+  - Provide concrete, specific information rather than vague descriptions
+  - Keep the tone professional and technical
+  - Focus on intent and reasoning, not just code changes
+  - Use markdown headers (##) for section organization
+  </verbose>
 </format>
 
 <conventions_no_scope>
@@ -158,8 +194,50 @@ Bad commit messages:
 [ERROR] Changes
 </examples_no_scope>
 
+<examples_verbose_no_scope>
+Example of a good VERBOSE commit message (without scope):
+
+feat: add verbose mode for detailed commit message generation
+
+## Motivation
+Users need the ability to generate comprehensive commit messages that follow best practices for code review and documentation. The existing one-liner and multi-line modes don't provide sufficient structure for complex changes that require detailed explanations of motivation, architecture decisions, and impact.
+
+## Architecture / Approach
+Adds a new --verbose/-v flag to the CLI that modifies the prompt generation in build_prompt(). When enabled, the prompt instructs the AI to generate commit messages with structured sections including Motivation, Architecture/Approach, Affected Components, and optional Performance/Testing sections. The implementation uses the existing format selection logic with verbose taking priority over one_liner and multi_line modes.
+
+## Affected Components
+- src/gac/cli.py: Added --verbose flag and parameter passing
+- src/gac/main.py: Extended main() to accept and pass verbose parameter
+- src/gac/prompt.py: Added <verbose> template section with detailed instructions
+- tests/test_prompt.py: Added test coverage for verbose mode
+
+## Compatibility / Testing
+Added new test test_build_prompt_verbose_mode to verify the verbose template generation. All existing tests pass. The verbose mode is opt-in via the -v flag, maintaining backward compatibility.
+</examples_verbose_no_scope>
+
+<examples_verbose_with_scope>
+Example of a good VERBOSE commit message (with scope):
+
+feat(cli): add verbose mode for detailed commit message generation
+
+## Motivation
+Users need the ability to generate comprehensive commit messages that follow best practices for code review and documentation. The existing one-liner and multi-line modes don't provide sufficient structure for complex changes that require detailed explanations of motivation, architecture decisions, and impact.
+
+## Architecture / Approach
+Adds a new --verbose/-v flag to the CLI that modifies the prompt generation in build_prompt(). When enabled, the prompt instructs the AI to generate commit messages with structured sections including Motivation, Architecture/Approach, Affected Components, and optional Performance/Testing sections. The implementation uses the existing format selection logic with verbose taking priority over one_liner and multi_line modes.
+
+## Affected Components
+- src/gac/cli.py: Added --verbose flag and parameter passing
+- src/gac/main.py: Extended main() to accept and pass verbose parameter
+- src/gac/prompt.py: Added <verbose> template section with detailed instructions
+- tests/test_prompt.py: Added test coverage for verbose mode
+
+## Compatibility / Testing
+Added new test test_build_prompt_verbose_mode to verify the verbose template generation. All existing tests pass. The verbose mode is opt-in via the -v flag, maintaining backward compatibility.
+</examples_verbose_with_scope>
+
 <examples_with_scope>
-Good commit messages (with scope):
+Good commit message top lines (with scope):
 [OK] feat(auth): add OAuth2 integration with Google and GitHub
 [OK] fix(api): resolve race condition in user session management
 [OK] docs(readme): add troubleshooting section for common installation issues
@@ -201,6 +279,7 @@ def build_prompt(
     one_liner: bool = False,
     infer_scope: bool = False,
     hint: str = "",
+    verbose: bool = False,
 ) -> tuple[str, str]:
     """Build system and user prompts for the AI model using the provided template and git information.
 
@@ -211,6 +290,7 @@ def build_prompt(
         one_liner: Whether to request a one-line commit message
         infer_scope: Whether to infer scope for the commit message
         hint: Optional hint to guide the AI
+        verbose: Whether to generate detailed commit messages with motivation, architecture, and impact sections
 
     Returns:
         Tuple of (system_prompt, user_prompt) ready to be sent to an AI model
@@ -251,21 +331,60 @@ def build_prompt(
         template = re.sub(r"<hint>.*?</hint>", "", template, flags=re.DOTALL)
         logger.debug("No hint provided")
 
-    # Process format options (one-liner vs multi-line)
-    if one_liner:
+    # Process format options (verbose, one-liner, or multi-line)
+    # Priority: verbose > one_liner > multi_line
+    if verbose:
+        # Verbose mode: remove one_liner and multi_line, keep verbose
+        template = re.sub(r"<one_liner>.*?</one_liner>", "", template, flags=re.DOTALL)
+        template = re.sub(r"<multi_line>.*?</multi_line>", "", template, flags=re.DOTALL)
+    elif one_liner:
+        # One-liner mode: remove multi_line and verbose
         template = re.sub(r"<multi_line>.*?</multi_line>", "", template, flags=re.DOTALL)
+        template = re.sub(r"<verbose>.*?</verbose>", "", template, flags=re.DOTALL)
     else:
+        # Multi-line mode (default): remove one_liner and verbose
         template = re.sub(r"<one_liner>.*?</one_liner>", "", template, flags=re.DOTALL)
+        template = re.sub(r"<verbose>.*?</verbose>", "", template, flags=re.DOTALL)
 
-    # Clean up examples sections based on infer_scope settings
-    if infer_scope:
-        # With scope (inferred) - keep scope examples, remove no_scope examples
+    # Clean up examples sections based on verbose and infer_scope settings
+    if verbose and infer_scope:
+        # Verbose mode with scope - keep verbose_with_scope examples
+        template = re.sub(r"<examples_no_scope>.*?</examples_no_scope>\n?", "", template, flags=re.DOTALL)
+        template = re.sub(r"<examples_with_scope>.*?</examples_with_scope>\n?", "", template, flags=re.DOTALL)
+        template = re.sub(
+            r"<examples_verbose_no_scope>.*?</examples_verbose_no_scope>\n?", "", template, flags=re.DOTALL
+        )
+        template = template.replace("<examples_verbose_with_scope>", "<examples>")
+        template = template.replace("</examples_verbose_with_scope>", "</examples>")
+    elif verbose:
+        # Verbose mode without scope - keep verbose_no_scope examples
+        template = re.sub(r"<examples_no_scope>.*?</examples_no_scope>\n?", "", template, flags=re.DOTALL)
+        template = re.sub(r"<examples_with_scope>.*?</examples_with_scope>\n?", "", template, flags=re.DOTALL)
+        template = re.sub(
+            r"<examples_verbose_with_scope>.*?</examples_verbose_with_scope>\n?", "", template, flags=re.DOTALL
+        )
+        template = template.replace("<examples_verbose_no_scope>", "<examples>")
+        template = template.replace("</examples_verbose_no_scope>", "</examples>")
+    elif infer_scope:
+        # With scope (inferred) - keep scope examples, remove all others
         template = re.sub(r"<examples_no_scope>.*?</examples_no_scope>\n?", "", template, flags=re.DOTALL)
+        template = re.sub(
+            r"<examples_verbose_no_scope>.*?</examples_verbose_no_scope>\n?", "", template, flags=re.DOTALL
+        )
+        template = re.sub(
+            r"<examples_verbose_with_scope>.*?</examples_verbose_with_scope>\n?", "", template, flags=re.DOTALL
+        )
         template = template.replace("<examples_with_scope>", "<examples>")
         template = template.replace("</examples_with_scope>", "</examples>")
     else:
-        # No scope - keep no_scope examples, remove scope examples
+        # No scope - keep no_scope examples, remove all others
         template = re.sub(r"<examples_with_scope>.*?</examples_with_scope>\n?", "", template, flags=re.DOTALL)
+        template = re.sub(
+            r"<examples_verbose_no_scope>.*?</examples_verbose_no_scope>\n?", "", template, flags=re.DOTALL
+        )
+        template = re.sub(
+            r"<examples_verbose_with_scope>.*?</examples_verbose_with_scope>\n?", "", template, flags=re.DOTALL
+        )
         template = template.replace("<examples_no_scope>", "<examples>")
         template = template.replace("</examples_no_scope>", "</examples>")
 

{gac-1.8.0.dist-info → gac-1.9.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gac
-Version: 1.8.0
+Version: 1.9.1
 Summary: AI-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
@@ -60,7 +60,7 @@ Description-Content-Type: text/markdown
 - **Deep Contextual Analysis:** Understands your code by analyzing staged changes, repository structure, and recent commit history to provide highly relevant suggestions.
 - **Multi-Provider & Model Support:** Flexibly works with leading AI providers (Anthropic, Cerebras, Chutes.ai, Gemini, Groq, OpenAI, OpenRouter, Streamlake/Vanchin, Synthetic.new, & Z.AI) and local providers (LM Studio & Ollama), easily configured through an interactive setup or environment variables.
 - **Seamless Git Workflow:** Integrates smoothly into your existing Git routine as a simple drop-in replacement for `git commit`.
-- **Extensive Customization:** Tailor commit messages to your needs with a rich set of flags, including one-liners (`-o`), AI hints (`-h`), scope inference (`-s`), and specific model selection (`-m`).
+- **Extensive Customization:** Tailor commit messages to your needs with a rich set of flags, including one-liners (`-o`), detailed verbose messages (`-v`), AI hints (`-h`), scope inference (`-s`), and specific model selection (`-m`).
 - **Streamlined Workflow Commands:** Boost your productivity with convenient options to stage all changes (`-a`), auto-confirm commits (`-y`), and push to your remote repository (`-p`) in a single step.
 - **Interactive Reroll with Feedback:** Not satisfied with the generated commit message? Use `r` for a simple regeneration, or `r <feedback>` to provide specific improvement suggestions (e.g., `r make it shorter`, `r focus on the bug fix`).
 - **Token Usage Tracking:** Display token consumption statistics (prompt, completion, and total tokens).

{gac-1.8.0.dist-info → gac-1.9.1.dist-info}/RECORD

@@ -1,18 +1,18 @@
 gac/__init__.py,sha256=z9yGInqtycFIT3g1ca24r-A3699hKVaRqGUI79wsmMc,415
-gac/__version__.py,sha256=ZrEUwsZomybTNkOGMfS08i073_U6EUzf2X5DfW6ia3g,66
-gac/ai.py,sha256=T8o7ZenWDB94ILMvt5hp8mp_J6BbMJ3h5Y_0y2kRrX8,3512
-gac/ai_utils.py,sha256=kz_ROoJjFZGPXxiyy225MuvMv9DikiqJBXOqKVlLVlc,7253
-gac/cli.py,sha256=nvJW_FmS0xA8Vs7x-JdIu4mW9Ze7IelYP8bnZYVFB4E,4885
-gac/config.py,sha256=N62phuLUyVj54eLDiDL6VN8-2_Zt6yB5zsnimFavU3I,1630
+gac/__version__.py,sha256=G1n_WKkZXSioJbRY3wekL5t5AcCwR3K2fA6ITDQQ1NI,66
+gac/ai.py,sha256=-0rIZQCHC7yOEmkLtCLDzeInnrm960hVpiEELi8NM_U,3513
+gac/ai_utils.py,sha256=dGfac6ZWQARZDnH6ygnqQ2W4eTIDh_wOx6iGg5lA_Gw,7271
+gac/cli.py,sha256=15Io35xSvoZ7_q9ADgely1un0tAprNuLRPdghGaIQTg,5058
+gac/config.py,sha256=nVEnjCPmobspQl9NEcFLBYcIeUi2J9cui8CEzqIHnFY,1739
 gac/config_cli.py,sha256=v9nFHZO1RvK9fzHyuUS6SG-BCLHMsdOMDwWamBhVVh4,1608
-gac/constants.py,sha256=hGzmLGhVDB2KPIqwtl6tHMNuSwHj-2P1RK0cGm4pyNA,4962
+gac/constants.py,sha256=R3oUwPLk_uWnBkg-J7Or-vomRr-iVKeLf1xljJeKclo,4988
 gac/diff_cli.py,sha256=wnVQ9OFGnM0d2Pj9WVjWbo0jxqIuRHVAwmb8wU9Pa3E,5676
 gac/errors.py,sha256=ysDIVRCd0YQVTOW3Q6YzdolxCdtkoQCAFf3_jrqbjUY,7916
 gac/git.py,sha256=_Co25XA1Nku03h50C_HiEf4ugEz6rK5j_IYi-rr5gco,8005
 gac/init_cli.py,sha256=LEw26g-tb6GZdN3DaUuLx3OFvZPKPOIFKnqgDRe6Y8s,4677
-gac/main.py,sha256=ot1DEbJHsZ0SzdZUuRXIm9pz1xbm4hxARzUjwytGdfc,15670
+gac/main.py,sha256=odWu_1Z0KVr--3duc4iFOE9ix0SGqykgzRDz-JY482c,15771
 gac/preprocess.py,sha256=krrLPHsccYMdn_YAtUrppBJIoRgevxGWusDwhE40LEo,15366
-gac/prompt.py,sha256=K6r9q2cAlyPu1fud6-jJsZ4zeweEo3yt6_WeYv8a_SQ,17087
+gac/prompt.py,sha256=d_kBXmhf3bDVLyDj8J7AS7GBAxF2jlc8lXoHX3Dzi5k,24255
 gac/security.py,sha256=M1MZm6BLOeKl6rH_-UdXsSKol39FnA5fIP3YP394yZE,9898
 gac/utils.py,sha256=W3ladtmsH01MNLdckQYTzYrYbTGEdzCKI36he9C-y_E,3945
 gac/providers/__init__.py,sha256=ejIM5vvmfTp7vfJSNeQQPIEJusOkKTUZpUE7OeWBc9Y,876
@@ -28,8 +28,8 @@ gac/providers/openrouter.py,sha256=H3ce8JcRUYq1I30lOjGESdX7jfoPkW3mKAYnc2aYfBw,2
 gac/providers/streamlake.py,sha256=KAA2ZnpuEI5imzvdWVWUhEBHSP0BMnprKXte6CbwBWY,2047
 gac/providers/synthetic.py,sha256=sRMIJTS9LpcXd9A7qp_ZjZxdqtTKRn9fl1W4YwJZP4c,1855
 gac/providers/zai.py,sha256=kywhhrCfPBu0rElZyb-iENxQxxpVGykvePuL4xrXlaU,2739
-gac-1.8.0.dist-info/METADATA,sha256=4z_AS3NKai5FD1xvY8hYH_lWVGioLT7tpv93y_dhIAY,9245
-gac-1.8.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-gac-1.8.0.dist-info/entry_points.txt,sha256=tdjN-XMmcWfL92swuRAjT62bFLOAwk9bTMRLGP5Z4aI,36
-gac-1.8.0.dist-info/licenses/LICENSE,sha256=vOab37NouL1PNs5BswnPayrMCqaN2sqLfMQfqPDrpZg,1103
-gac-1.8.0.dist-info/RECORD,,
+gac-1.9.1.dist-info/METADATA,sha256=xUSS5EcAO1_k4RJ-ukG_XN7g_twtCy2F0jgjgn0RBLE,9279
+gac-1.9.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+gac-1.9.1.dist-info/entry_points.txt,sha256=tdjN-XMmcWfL92swuRAjT62bFLOAwk9bTMRLGP5Z4aI,36
+gac-1.9.1.dist-info/licenses/LICENSE,sha256=vOab37NouL1PNs5BswnPayrMCqaN2sqLfMQfqPDrpZg,1103
+gac-1.9.1.dist-info/RECORD,,