gitpr-cli 0.0.26__py3-none-any.whl → 0.0.27__py3-none-any.whl

{gitpr_cli-0.0.26.dist-info → gitpr_cli-0.0.27.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitpr-cli
-Version: 0.0.26
+Version: 0.0.27
 Summary: Automação de PRs, Commits e Code Review com IA (Gemini e DeepSeek)
 Author-email: Natan Fiuza <contato@natanfiuza.dev.br>
 Requires-Python: >=3.10
@@ -16,8 +16,13 @@ Requires-Dist: textual
 Requires-Dist: requests
 Dynamic: license-file
 
+
 # **GitPR CLI 🚀**
 
+<p align="center">
+  <img src="docs/logo.png" alt="GitPR Logo" width="200">
+</p>
+
 GitPR CLI is a command-line automation tool that uses **Google Gemini** and **DeepSeek** artificial intelligence to analyze your code changes (git diff) or entire files. The tool automatically generates commit messages in the *Conventional Commits* standard, detailed Pull Request descriptions, and deep Code Reviews aimed at reducing technical debt.
 
 ## **🛠️ Technologies and Libraries Used**
@@ -140,6 +145,14 @@ You can pass the following *flags* for specific actions:
 * `-u` or `--update`: Checks and installs the latest version of GitPR (Auto-Updater).
 
 > **⚙️ Technical Note (--hook):** GitPR has a hidden flag `--hook <file>` that is triggered exclusively by the Git Hooks system in the background. It allows the AI to inject the suggested message directly into Git's temporary file, without cluttering your terminal.
+>
+> **⚙️ Technical Note (--pre-save):** GitPR has a hidden debug flag `--pre-save` that can be combined with any AI command (e.g.: `gitpr -c --pre-save`). Before each AI call, it saves the full payload that will be sent to the model (system instruction + prompt + character counters) to a `_{action}-{datetime}.json` file in the current folder, and then proceeds normally. Useful for inspecting very large prompts. Note: when the response comes from the local cache, no call is made and no file is generated.
+
+### 📦 Huge Diffs (Map-Reduce)
+
+When your diff is too large for a single AI call (over ~90k estimated tokens), GitPR automatically splits it into batches by file, asks the AI for a technical summary of each part (Map), and unifies everything into the final commit message, review, or PR description (Reduce). No flags needed — it activates on demand and shows the progress in the console.
+
+📚 Full documentation: [docs/map-reduce-diff.md](docs/map-reduce-diff.md)
 
 ## 🛡️ Local Linter (Static Analysis)
 

{gitpr_cli-0.0.26.dist-info → gitpr_cli-0.0.27.dist-info}/RECORD

@@ -1,25 +1,25 @@
-gitpr_cli-0.0.26.dist-info/licenses/LICENSE,sha256=UQzLC6mwqb-ZNDkBBAqOxC-SMQcEID0gaM6oFcu6u48,27030
+gitpr_cli-0.0.27.dist-info/licenses/LICENSE,sha256=UQzLC6mwqb-ZNDkBBAqOxC-SMQcEID0gaM6oFcu6u48,27030
 src/__init__.py,sha256=U6ksarernNcryHO20aj4rNG7w0thT7xdMs5KzBJyPvE,28
-src/ai_providers.py,sha256=gjWhl38AAVtCVDd4E_YOBlC_gKvtRBSoOj0b_kJ6N1I,8316
-src/blame_engine.py,sha256=Ci7t08xTcC1kBWAjQ_ulP-Zraau_PC35MDfAngc4AYk,10396
+src/ai_providers.py,sha256=cxPuytZ9LfvhQbWFPBJ4dud3lHLpAQpa3cbY8bKESk8,10954
+src/blame_engine.py,sha256=z-uh8mHOF--JxY_nnbp5r_9y_a_IO4Zn42P0AeLBpto,10436
 src/cache.py,sha256=XggMTy00GlZfeF1VoLEYCdxL5h0eTg11TJfPIRPx7fs,3201
 src/chat_memory.py,sha256=vdYuElIQb6-flFm4SfzapnQZGRIwgbLECzIcsAc0Oo8,8724
 src/config.py,sha256=VJ9ekDlTVG5ETWDuO1kZWlgrncXbrvduxa5Zg7wN_ZY,9064
-src/core.py,sha256=TGtSA_7wyNoa-B6ytFhunCpEmpW9miQzvlizUQcyhis,18259
+src/core.py,sha256=M7dPzenRa7HtOVPvFXltwg3OR2ca2EsJFJY60ajUijg,24297
 src/i18n.py,sha256=QED7hTSdWCC1lSNJ-l6VuOba18OrWgFTMQcZ7cQmXbY,3599
-src/issue_engine.py,sha256=435kPPgdsFMcY3nvutxdIfJAnLP0U4FMCPdbok6C2sc,3626
+src/issue_engine.py,sha256=XJ7WNLoeg3wct079wS7OQqU62f_avn3A8LmMuPWchzE,3642
 src/linter_engine.py,sha256=D04wvOgRa-vZEYknm-z-Cg7V_3gnoQz_64PMorWnISo,4414
-src/main.py,sha256=QryicYBsYiRaNCUTs9eJbM-x-S3Z4-jWvjGR3SwkmJ8,31412
+src/main.py,sha256=s-7JO9MudWZ5mqurDtzTtcj8GoMNirlptgbTQ6y6-vU,31742
 src/security.py,sha256=Li0zM8ZURTK2nKRHIt49TWLO4DIddBEHzXPrVycv0Rs,1343
-src/spinner.py,sha256=nnnoz91qt2NMEA3aMIT27XH7KImSMNVt_SyRAjNS8rk,6922
+src/spinner.py,sha256=16ngB2oT1t7O-c3D2DWCJbFb9nMyD-HWv6KcvhKTelQ,7651
 src/tui_issue.py,sha256=gcAJCIfMcdeMjrFJUWQQvdgBv7fnOBtxQxwdBk2Sk40,1789
-src/updater.py,sha256=BDBRFpL9ek4MvduIKa3A_UH1KM-YCOCaXwPvN-eVREw,5886
+src/updater.py,sha256=QPvYVEBpORF37rfD2oB_vVKnfNIw5amlaJk3NDSckuA,5886
 src/ui/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 src/ui/chat_app.py,sha256=y-py5UpisQbPLqqDON8AIkyA7X1IM5LAn1GbeYr2p_U,25598
 src/ui/help_screen.py,sha256=tjbokXhwyzLnkOC0S56NbpX-78hcFQnvsQMpNU1wt0c,1862
 src/ui/issue_app.py,sha256=8MdBcOVdCHPFx6EUhs80CiZ2G-29KulskkCz9qMZ_Lg,4737
-gitpr_cli-0.0.26.dist-info/METADATA,sha256=RReNTAFsjM1rMKH3aordrfMn90pZygCt0jn-tTo3X-M,17450
-gitpr_cli-0.0.26.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
-gitpr_cli-0.0.26.dist-info/entry_points.txt,sha256=mh_4F_idM4cj0XhfRGBDQb5Nnku93YJ-dyKh5SufwlE,39
-gitpr_cli-0.0.26.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
-gitpr_cli-0.0.26.dist-info/RECORD,,
+gitpr_cli-0.0.27.dist-info/METADATA,sha256=RaWiAINchrmj4I8CpZxeaObnRVH4IwpEgneVOFCxkG4,18530
+gitpr_cli-0.0.27.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+gitpr_cli-0.0.27.dist-info/entry_points.txt,sha256=mh_4F_idM4cj0XhfRGBDQb5Nnku93YJ-dyKh5SufwlE,39
+gitpr_cli-0.0.27.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
+gitpr_cli-0.0.27.dist-info/RECORD,,

src/ai_providers.py

@@ -1,5 +1,6 @@
 import json
 import time
+from datetime import datetime
 import click
 from google import genai
 from openai import OpenAI
@@ -10,13 +11,65 @@ from src.spinner import Spinner
 from src.i18n import __,CURRENT_LANG
 
 
-def call_ai_model(provider, api_key, api_model, prompt, system_instruction, quiet=False):
+# Hidden --pre-save debug flag: when enabled, every AI payload is dumped
+# to a JSON file in the current directory before being sent to the model.
+PRE_SAVE_ENABLED = False
+
+
+def set_pre_save(enabled):
+    """Enable/disable the pre-save payload dump (set once from the CLI)."""
+    global PRE_SAVE_ENABLED
+    PRE_SAVE_ENABLED = enabled
+
+
+def _save_pre_save_payload(action, provider, api_model, system_instruction, prompt=None, chat_history=None, new_message=None):
+    """
+    Dump the full AI payload to a _{action}-{datetime}.json file in the current directory.
+    Returns the filename on success or None on failure (a debug dump must never break the flow).
+    """
+    filename = f"_{action}-{datetime.now().strftime('%Y%m%d%H%M%S%f')}.json"
+
+    payload = {
+        "datetime": datetime.now().strftime("%Y-%m-%d %H:%M:%S"),
+        "action": action,
+        "provider": provider,
+        "model": api_model,
+        "system_instruction": system_instruction,
+        "system_instruction_chars": len(system_instruction) if system_instruction else 0,
+    }
+
+    if chat_history is not None:
+        payload["chat_history"] = chat_history
+        payload["new_message"] = new_message
+        payload["chat_history_chars"] = len(json.dumps(chat_history, ensure_ascii=False)) if chat_history else 0
+        payload["new_message_chars"] = len(new_message) if new_message else 0
+        payload["total_chars"] = payload["system_instruction_chars"] + payload["chat_history_chars"] + payload["new_message_chars"]
+    else:
+        payload["prompt"] = prompt
+        payload["prompt_chars"] = len(prompt) if prompt else 0
+        payload["total_chars"] = payload["system_instruction_chars"] + payload["prompt_chars"]
+
+    try:
+        with open(filename, "w", encoding="utf-8") as f:
+            json.dump(payload, f, ensure_ascii=False, indent=2)
+        return filename
+    except Exception:
+        return None
+
+
+def call_ai_model(provider, api_key, api_model, prompt, system_instruction, quiet=False, action="ai_call"):
     """
     Unified engine for AI calls.
     Supports 'gemini' and 'deepseek'.
     """
     max_retries = 3
     retry_delay = 2
+
+    if PRE_SAVE_ENABLED:
+        saved_file = _save_pre_save_payload(action, provider, api_model, system_instruction, prompt=prompt)
+        if saved_file and not quiet:
+            click.secho(__("📝 Pre-save: AI payload saved to {filename}", filename=saved_file), fg="yellow", dim=True)
+
     spinner = Spinner(quiet=quiet)
     spinner.start()
 
@@ -141,6 +194,11 @@ def call_ai_chat(provider, api_key, api_model, system_instruction, chat_history,
     Dedicated engine for the Interactive Chat.
     Keeps the historical context and returns free Markdown (does not force JSON).
     """
+    if PRE_SAVE_ENABLED:
+        saved_file = _save_pre_save_payload("chat", provider, api_model, system_instruction, chat_history=chat_history, new_message=new_message)
+        if saved_file and not quiet:
+            click.secho(__("📝 Pre-save: AI payload saved to {filename}", filename=saved_file), fg="yellow", dim=True)
+
     spinner = Spinner(quiet=quiet)
     spinner.start()
 

src/blame_engine.py

@@ -83,7 +83,7 @@ def analyze_commit_with_ai(commit_hash, file_path):
 
     click.secho(__("  🤖 Consulting AI ({api_model}) about commit {commit_hash}...", api_model=api_model, commit_hash=commit_hash[:8]), fg="cyan", dim=True)
 
-    result_json = call_ai_model(provider, api_key, api_model, prompt, sys_inst)
+    result_json = call_ai_model(provider, api_key, api_model, prompt, sys_inst, action="blame")
 
     if result_json and "status" in result_json:
         return result_json
@@ -210,7 +210,7 @@ def run_blame_analysis(file_path, start_line, end_line, return_data=False):
     sys_inst = __('You are a Software Architect. Generate ONLY a JSON object in the format {"resumo": "summary text"}.')
 
     click.secho(__("  🤖 Consulting AI ({api_model}) for the Executive Summary...", api_model=api_model), fg="cyan", dim=True)
-    summary_json = call_ai_model(provider, api_key, api_model, summary_prompt, sys_inst)
+    summary_json = call_ai_model(provider, api_key, api_model, summary_prompt, sys_inst, action="blame_summary")
 
     resumo_texto = summary_json.get("resumo", __("Summary not available.")) if summary_json else __("Summary not available.")
 

src/core.py

@@ -2,33 +2,98 @@ import os
 import re
 import json
 import stat
+import time
 import click
 import subprocess
 import urllib.request
 import urllib.error
+from pathlib import Path
 from google import genai
+from dotenv import load_dotenv, set_key
 from src.security import decrypt_data
 from src.cache import get_cached_response, save_cached_response, get_cached_pr_descriptions
 from src.config import get_api_key, get_api_model, get_skill_dir, resolve_skill_path
 from src.ai_providers import call_ai_model
 from src.i18n import __, CURRENT_LANG
-
-# Filtro Smart Diff: ficheiros que gastam tokens da IA sem acrescentar valor semântico
-SMART_EXCLUDES = [
-    ":(exclude)*.lock",
-    ":(exclude)package-lock.json",
-    ":(exclude)yarn.lock",
-    ":(exclude)pnpm-lock.yaml",
-    ":(exclude)composer.lock",
-    ":(exclude)poetry.lock",
-    ":(exclude)Pipfile.lock",
-    ":(exclude)Gemfile.lock",
-    ":(exclude)go.sum",
-    ":(exclude)*.min.js",
-    ":(exclude)*.min.css",
-    ":(exclude)*.svg"
+from src.updater import __lang_version__
+
+# Smart Diff filter: files that consume AI tokens without adding semantic value.
+# The pattern list is managed remotely (templates/gitpr.smart-excludes.json) and
+# cached at ~/.gitpr/conf/ — see _load_smart_excludes() for the update logic.
+_FALLBACK_SMART_EXCLUDES = [
+    "*.lock",
+    "package-lock.json",
+    "yarn.lock",
+    "pnpm-lock.yaml",
+    "composer.lock",
+    "poetry.lock",
+    "Pipfile.lock",
+    "Gemfile.lock",
+    "go.sum",
+    "*.min.js",
+    "*.min.css",
+    "*.svg"
 ]
 
+SMART_EXCLUDES_URL = "https://raw.githubusercontent.com/natanfiuza/gitpr/main/templates/gitpr.smart-excludes.json"
+
+
+def _load_smart_excludes():
+    """
+    Load the smart-exclude patterns and return them as git pathspec exclusions.
+
+    Resolution order:
+    1. Local copy at ~/.gitpr/conf/gitpr.smart-excludes.json when its version
+       marker (SMART_EXCLUDES_VERSION in ~/.gitpr/.env) matches __lang_version__.
+    2. Fresh download from the remote template (saved locally + marker updated).
+    3. Stale local copy when the download fails.
+    4. _FALLBACK_SMART_EXCLUDES as last resort.
+    Silent on failure — diff generation must never break because of this list.
+    """
+    env_file = Path.home() / ".gitpr" / ".env"
+    load_dotenv(env_file)
+
+    conf_dir = Path.home() / ".gitpr" / "conf"
+    local_file = conf_dir / "gitpr.smart-excludes.json"
+    needs_update = os.getenv("SMART_EXCLUDES_VERSION") != __lang_version__
+
+    def _to_pathspecs(data):
+        return [f":(exclude){pattern}" for pattern in data.get("excludes", [])]
+
+    # 1. Local copy is present and up to date
+    if local_file.exists() and not needs_update:
+        try:
+            with open(local_file, "r", encoding="utf-8", errors="replace") as f:
+                return _to_pathspecs(json.load(f))
+        except Exception:
+            pass
+
+    # 2. Download the updated list from the remote template
+    try:
+        with urllib.request.urlopen(SMART_EXCLUDES_URL, timeout=3) as response:
+            data = json.loads(response.read().decode("utf-8"))
+        conf_dir.mkdir(parents=True, exist_ok=True)
+        with open(local_file, "w", encoding="utf-8") as f:
+            json.dump(data, f, ensure_ascii=False, indent=2)
+        set_key(str(env_file), "SMART_EXCLUDES_VERSION", __lang_version__)
+        return _to_pathspecs(data)
+    except Exception:
+        pass
+
+    # 3. Offline fallback: reuse the local copy even if outdated
+    if local_file.exists():
+        try:
+            with open(local_file, "r", encoding="utf-8", errors="replace") as f:
+                return _to_pathspecs(json.load(f))
+        except Exception:
+            pass
+
+    # 4. Last resort: built-in defaults
+    return [f":(exclude){pattern}" for pattern in _FALLBACK_SMART_EXCLUDES]
+
+
+SMART_EXCLUDES = _load_smart_excludes()
+
 
 def get_doc_url(filename):
     """Returns the complete URL for a docs/ file, with language suffix if needed."""
@@ -62,7 +127,7 @@ def get_git_diff(quiet=False):
             click.secho(f"📚 {__('Understand why:')} {get_doc_url('untracked-files.md')}\n", fg="blue", underline=True)
 
         # Run the normal diff that captures tracked and staged files
-        cmd = ["git", "diff", "HEAD", "--"] + SMART_EXCLUDES
+        cmd = ["git", "diff", "-U1", "-w", "-M", "-B", "HEAD", "--"] + SMART_EXCLUDES
         result = subprocess.run(
             cmd,
             capture_output=True,
@@ -153,6 +218,35 @@ def get_skill_context(action_type="pr"):
     # Return empty if it does not exist
     return ""
 
+def estimate_token_count(text):
+    """Estimates the token count using the safe rule of 4 characters per token."""
+    return len(text) // 4
+
+def split_diff_into_chunks(diff_text, max_tokens=90000):
+    """Splits the diff based on the token limit while preserving file header integrity."""
+    if estimate_token_count(diff_text) <= max_tokens:
+        return [diff_text]
+    
+    parts = re.split(r'(^diff --git a/)', diff_text, flags=re.MULTILINE)
+    chunks = []
+    current_chunk = ""
+    
+    for i in range(1, len(parts), 2):
+        file_diff = parts[i] + parts[i+1] if i + 1 < len(parts) else parts[i]
+        
+        if estimate_token_count(current_chunk + file_diff) > max_tokens and current_chunk:
+            chunks.append(current_chunk)
+            current_chunk = file_diff
+        else:
+            current_chunk += file_diff
+            
+    if current_chunk:
+        chunks.append(current_chunk)
+        
+    if not chunks:
+        chunks = [diff_text]
+        
+    return chunks
 
 def generate_pr_content(action_folder, action_type, diff_text, provider="gemini"):
     """Sends the diff to the AI using System Instruction and returns a parsed JSON."""
@@ -212,10 +306,46 @@ def generate_pr_content(action_folder, action_type, diff_text, provider="gemini"
         click.secho(__("❌ Error: Could not determine model for provider '{provider}'.", provider=provider), fg="red")
         return None
 
+    # API CALL
     # API CALL
     click.secho(__("🤖 GitPR is analyzing your code using {provider} ({model})...\n", provider=provider.capitalize(), model=api_model), fg="cyan")
     
-    result_json = call_ai_model(provider, api_key, api_model, prompt, instrucao_sistema)
+    chunks = split_diff_into_chunks(diff_text, max_tokens=90000)
+    
+    if len(chunks) == 1:
+        result_json = call_ai_model(provider, api_key, api_model, prompt, instrucao_sistema, action=action_folder)
+    else:
+        click.secho(__("📦 Huge diff detected! Processing in {count} batches (Map-Reduce)...", count=len(chunks)), fg="yellow", bold=True)
+        click.secho(f"📚 {__('Understand why:')} {get_doc_url('map-reduce-diff.md')}\n", fg="blue", underline=True)
+        resumos_parciais = []
+
+        for i, chunk in enumerate(chunks, 1):
+            click.secho(__("⏳ Analyzing batch {current}/{total}...", current=i, total=len(chunks)), fg="cyan", dim=True)
+
+            prompt_parcial = __("Generate ONLY a JSON object in the format {json_format} containing a technical summary of what was changed in this part ({idx}) of the diff:\n", json_format='{"resumo": "..."}', idx=i) + chunk
+
+            resposta_parcial = call_ai_model(provider, api_key, api_model, prompt_parcial, instrucao_sistema, quiet=True, action=f"{action_folder}_chunk_{i}")
+
+            if resposta_parcial and "resumo" in resposta_parcial:
+                resumos_parciais.append(f"### Batch {i}\n{resposta_parcial['resumo']}")
+            
+            time.sleep(1)
+            
+        if not resumos_parciais:
+            click.secho(__("❌ Failed to extract context from the partial batches."), fg="red")
+            return None
+
+        click.secho(__("🔄 Unifying intelligence and generating the final analysis..."), fg="yellow")
+        diff_unificado = "\n\n".join(resumos_parciais)
+
+        if action_type == "commit":
+            prompt = __("Generate ONLY a JSON object in the format {json_format} for the commit message, unifying these technical summaries:\n", json_format='{"commit_message": "..."}') + diff_unificado
+        elif action_type in ["review", "fullreview", "filereview"]:
+            prompt = __("Generate ONLY a JSON object in the format {json_format} with a code review focused on improvements, using these summaries:\n", json_format='{"review": "..."}') + diff_unificado
+        else:
+            prompt = __("Unify these technical summaries and generate ONLY a JSON object in the format {json_format} describing the Pull Request:\n", json_format='{"commit_message": "...", "pr_description": "..."}') + diff_unificado
+            
+        result_json = call_ai_model(provider, api_key, api_model, prompt, instrucao_sistema, action=action_folder)
 
     # SAVE TO CACHE AND RETURN
     if result_json:
@@ -325,7 +455,7 @@ def get_git_full_diff():
 
         # Diff between that HASH and your CURRENT WORKSPACE (without using HEAD)
         # By passing only the hash, Git compares that commit with the files on your disk.
-        cmd = ["git", "diff", ancestor_hash, "--"] + SMART_EXCLUDES
+        cmd = ["git", "diff", "-U1", "-w", "-M", "-B", ancestor_hash, "--"] + SMART_EXCLUDES
         result = subprocess.run(
             cmd, 
             capture_output=True, 

src/issue_engine.py

@@ -78,7 +78,7 @@ def generate_issue_content(context_text, context_type="diff"):
 
     click.secho(__("🤖 Structuring Issue using {provider} ({api_model})...", provider=provider.capitalize(), api_model=api_model), fg="cyan", dim=True)
 
-    result_json = call_ai_model(provider, api_key, api_model, prompt, sys_inst)
+    result_json = call_ai_model(provider, api_key, api_model, prompt, sys_inst, action="issue")
 
     if result_json and "titulo" in result_json and "corpo" in result_json:
         # Save to Cache

src/main.py

@@ -143,6 +143,7 @@ HELP_PRIORITY: dict[str, int] = {
 @click.option('-ih', '--installhooks', is_flag=True, help=__("Automatically installs validation Git Hooks in the project."))
 @click.option('--hook', type=click.Path(), hidden=True, help=__("Commit file path (internal hook use)."))
 @click.option('-q', '--quiet', is_flag=True, hidden=True, help=__("Hides banner and non-essential logs (internal use)."))
+@click.option('--pre-save', is_flag=True, hidden=True, help=__("Saves the full AI payload (system + prompt) to a JSON file before each AI call (debug)."))
 @click.option('-i', '--input', type=click.Path(), help=__("Path to a specific file for full analysis."))
 @click.option('-b', '--blame', type=str, help=__("Analyzes the origin of a business rule (e.g., file.py:10-20 or just file.py)."))
 @click.option('-ht', '--history', is_flag=True, help=__("Uses the entire branch history (Git Log + PR Cache) as context to generate the issue."))
@@ -151,7 +152,7 @@ HELP_PRIORITY: dict[str, int] = {
 @click.option('-p', '--provider', type=click.Choice(['gemini', 'deepseek', 'ollama']), help=__("Forces the use of a specific AI provider for this execution."))
 @click.option('--lang', type=str, help=__("Forces the interface language for this execution (e.g.: en_us, pt_br)."))
 @click.option('-h', '--help', 'help_flag', is_flag=True, help=__("Shows this message and exits. Use with another flag for contextual help (e.g., -h --issue)."))
-def cli(commit, review, fullreview, linter, skill, update, installhooks, hook, quiet, provider, input, blame, history, issue, chat, help_flag, lang):
+def cli(commit, review, fullreview, linter, skill, update, installhooks, hook, quiet, pre_save, provider, input, blame, history, issue, chat, help_flag, lang):
     """
     GitPR CLI - Intelligent PR Automation and AI Code Review.
 
@@ -236,6 +237,11 @@ def cli(commit, review, fullreview, linter, skill, update, installhooks, hook, q
             except OSError:
                 pass
 
+    # Enable AI payload dump for inspection (hidden debug flag)
+    if pre_save:
+        from src.ai_providers import set_pre_save
+        set_pre_save(True)
+
     if linter:
         diff_text = get_git_diff()
         

src/spinner.py

@@ -13,6 +13,7 @@ import urllib.request
 from pathlib import Path
 from dotenv import load_dotenv, set_key
 from src.i18n import __, CURRENT_LANG
+from src.updater import __lang_version__
 
 # ANSI color codes
 MAGENTA = '\033[35m'
@@ -51,6 +52,12 @@ _FALLBACK_WORDS = [
     __("Calculating"),__("Reflecting"), __("Computing"),    
 ]
 
+def _parse_env_words(raw):
+    """Parses the .env word list (supports | or , separator)."""
+    sep = "|" if "|" in raw else ","
+    return [w.strip() for w in raw.split(sep) if w.strip()]
+
+
 def _load_thinking_words():
     """Loads the word list from .env or downloads from the remote template."""
     env_file = str(Path.home() / ".gitpr" / ".env")
@@ -60,12 +67,16 @@ def _load_thinking_words():
 
     raw = os.getenv("SPINNER_THINKING_WORDS", "").strip()
 
-    if raw:
-        # .env already has words: supports | or , separator
-        sep = "|" if "|" in raw else ","
-        return [w.strip() for w in raw.split(sep) if w.strip()]
+    # Version gate: when __lang_version__ changes, force a re-download so the
+    # words stay in sync with the published template (same pattern as
+    # LANG_VERSION in i18n.py and SMART_EXCLUDES_VERSION in core.py).
+    needs_update = os.getenv("THINKING_WORDS_VERSION") != __lang_version__
 
-    # .env has no words: download from GitHub
+    if raw and not needs_update:
+        # .env already has up-to-date words: supports | or , separator
+        return _parse_env_words(raw)
+
+    # .env has no words (or they are outdated): download from GitHub
     try:
         with urllib.request.urlopen(THINKING_WORDS_URL, timeout=10) as resp:
             content = resp.read().decode("utf-8")
@@ -83,12 +94,17 @@ def _load_thinking_words():
                     words.append(word)
 
         if words:
-            # Save to .env as pipe-separated
+            # Save to .env as pipe-separated and stamp the version marker
             set_key(env_file, "SPINNER_THINKING_WORDS", "|".join(words))
+            set_key(env_file, "THINKING_WORDS_VERSION", __lang_version__)
             return words
     except Exception:
         pass
 
+    # Download failed: reuse the stale .env words if available
+    if raw:
+        return _parse_env_words(raw)
+
     # Fallback: use internal list
     return list(_FALLBACK_WORDS)
 

src/updater.py

@@ -7,8 +7,8 @@ import click
 from datetime import datetime
 
 # Current version of your local executable (Update this on every new build!)
-__version__ = "0.0.26"  # GitPR current version
-__lang_version__ = "v0.0.4"  # Language dictionary version control
+__version__ = "0.0.27"  # GitPR current version
+__lang_version__ = "v0.0.5"  # Language dictionary version control
 GITHUB_API_URL = "https://api.github.com/repos/natanfiuza/gitpr/releases/latest"
 PYPI_API_URL = "https://pypi.org/pypi/gitpr-cli/json"