gitpr-cli 0.0.30__tar.gz → 0.0.31__tar.gz

{gitpr_cli-0.0.30 → gitpr_cli-0.0.31}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitpr-cli
-Version: 0.0.30
+Version: 0.0.31
 Summary: AI-powered PR automation, commit messages, and code review (Gemini, DeepSeek, and Ollama)
 Author-email: Natan Fiuza <contato@natanfiuza.dev.br>
 Requires-Python: >=3.10
@@ -28,6 +28,29 @@ GitPR CLI is a command-line automation tool that uses **Google Gemini** and **De
 
 🌐 **Website:** [gitpr.natanfiuza.dev.br](https://gitpr.natanfiuza.dev.br/) · 📂 **Repository:** [github.com/natanfiuza/gitpr](https://github.com/natanfiuza/gitpr)
 
+----
+
+## ⚡ **Quick Start**
+
+### **1. Installation via PyPI**
+
+Install GitPR CLI using `pip`:
+
+```bash
+pip install gitpr-cli
+```
+
+### **2. Initializing in a Repository**
+
+To set up GitPR in a folder of a new repository, run:
+
+```bash
+gitpr --install
+```
+
+> **Guided Setup:** Guided configuration that downloads skill templates, installs Git Hooks, configures MCP for your editors, and verifies the API key for your AI provider.  
+> 📖 **Full Documentation:** [https://gitpr.natanfiuza.dev.br/docs/install-wizard?lang=en_us](https://gitpr.natanfiuza.dev.br/docs/install-wizard?lang=en_us)
+
 ## **🛠️ Technologies and Libraries Used**
 
 This project was developed in Python and uses the following main libraries:

{gitpr_cli-0.0.30 → gitpr_cli-0.0.31}/README.md

@@ -9,6 +9,29 @@ GitPR CLI is a command-line automation tool that uses **Google Gemini** and **De
 
 🌐 **Website:** [gitpr.natanfiuza.dev.br](https://gitpr.natanfiuza.dev.br/) · 📂 **Repository:** [github.com/natanfiuza/gitpr](https://github.com/natanfiuza/gitpr)
 
+----
+
+## ⚡ **Quick Start**
+
+### **1. Installation via PyPI**
+
+Install GitPR CLI using `pip`:
+
+```bash
+pip install gitpr-cli
+```
+
+### **2. Initializing in a Repository**
+
+To set up GitPR in a folder of a new repository, run:
+
+```bash
+gitpr --install
+```
+
+> **Guided Setup:** Guided configuration that downloads skill templates, installs Git Hooks, configures MCP for your editors, and verifies the API key for your AI provider.  
+> 📖 **Full Documentation:** [https://gitpr.natanfiuza.dev.br/docs/install-wizard?lang=en_us](https://gitpr.natanfiuza.dev.br/docs/install-wizard?lang=en_us)
+
 ## **🛠️ Technologies and Libraries Used**
 
 This project was developed in Python and uses the following main libraries:

{gitpr_cli-0.0.30 → gitpr_cli-0.0.31}/gitpr_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitpr-cli
-Version: 0.0.30
+Version: 0.0.31
 Summary: AI-powered PR automation, commit messages, and code review (Gemini, DeepSeek, and Ollama)
 Author-email: Natan Fiuza <contato@natanfiuza.dev.br>
 Requires-Python: >=3.10
@@ -28,6 +28,29 @@ GitPR CLI is a command-line automation tool that uses **Google Gemini** and **De
 
 🌐 **Website:** [gitpr.natanfiuza.dev.br](https://gitpr.natanfiuza.dev.br/) · 📂 **Repository:** [github.com/natanfiuza/gitpr](https://github.com/natanfiuza/gitpr)
 
+----
+
+## ⚡ **Quick Start**
+
+### **1. Installation via PyPI**
+
+Install GitPR CLI using `pip`:
+
+```bash
+pip install gitpr-cli
+```
+
+### **2. Initializing in a Repository**
+
+To set up GitPR in a folder of a new repository, run:
+
+```bash
+gitpr --install
+```
+
+> **Guided Setup:** Guided configuration that downloads skill templates, installs Git Hooks, configures MCP for your editors, and verifies the API key for your AI provider.  
+> 📖 **Full Documentation:** [https://gitpr.natanfiuza.dev.br/docs/install-wizard?lang=en_us](https://gitpr.natanfiuza.dev.br/docs/install-wizard?lang=en_us)
+
 ## **🛠️ Technologies and Libraries Used**
 
 This project was developed in Python and uses the following main libraries:

{gitpr_cli-0.0.30 → gitpr_cli-0.0.31}/gitpr_cli.egg-info/SOURCES.txt

@@ -34,6 +34,7 @@ tests/test_core.py
 tests/test_install_wizard.py
 tests/test_mcp_prompts.py
 tests/test_mcp_server.py
+tests/test_metrics.py
 tests/test_pre_save.py
 tests/test_skill_command.py
 tests/test_smart_excludes.py

{gitpr_cli-0.0.30 → gitpr_cli-0.0.31}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "gitpr-cli"
-version = "0.0.30"
+version = "0.0.31"
 description = "AI-powered PR automation, commit messages, and code review (Gemini, DeepSeek, and Ollama)"
 readme = "README.md"
 requires-python = ">=3.10"

{gitpr_cli-0.0.30 → gitpr_cli-0.0.31}/src/ai_providers.py

@@ -73,6 +73,8 @@ def call_ai_model(provider, api_key, api_model, prompt, system_instruction, quie
     spinner = Spinner(quiet=quiet)
     spinner.start()
 
+    start_time = time.perf_counter()
+
     try:
         for attempt in range(1, max_retries + 1):
             try:
@@ -135,6 +137,9 @@ def call_ai_model(provider, api_key, api_model, prompt, system_instruction, quie
                     result_json = result_json[0] if result_json else {}
 
                 # Inject telemetry metadata silently into the response dictionary
+                meta_raw["duration_ms"] = int((time.perf_counter() - start_time) * 1000)
+                meta_raw["provider"] = provider
+                meta_raw["model"] = api_model
                 result_json["_telemetry_meta"] = meta_raw
 
                 spinner.stop()

{gitpr_cli-0.0.30 → gitpr_cli-0.0.31}/src/config.py

@@ -211,7 +211,35 @@ def get_github_token():
     """Reads and decrypts the GitHub Personal Access Token (PAT)."""
     load_dotenv(ENV_FILE)
     encrypted_token = os.getenv("GITHUB_TOKEN_ENCRYPTED")
-    
+
     if encrypted_token:
         return decrypt_data(encrypted_token)
-    return None
+    return None
+
+
+def validate_github_token(token):
+    """
+    Validates a GitHub PAT by making a lightweight API call to /user.
+    Returns (is_valid: bool, error_message: str).
+    """
+    import requests
+
+    try:
+        headers = {
+            "Authorization": f"token {token}",
+            "Accept": "application/vnd.github.v3+json"
+        }
+        response = requests.get("https://api.github.com/user", headers=headers, timeout=10)
+
+        if response.status_code == 200:
+            return True, ""
+        elif response.status_code == 401:
+            return False, __("Token expired or invalid. Please generate a new one.")
+        else:
+            return False, __("Unexpected response from GitHub (HTTP {code})", code=response.status_code)
+    except requests.exceptions.ConnectionError:
+        return False, __("No internet connection. Cannot validate GitHub token.")
+    except requests.exceptions.Timeout:
+        return False, __("GitHub API timeout. Check your connection and try again.")
+    except Exception as e:
+        return False, __("Failed to validate token: {error}", error=str(e))

{gitpr_cli-0.0.30 → gitpr_cli-0.0.31}/src/core.py

@@ -262,6 +262,8 @@ def generate_pr_content(action_folder, action_type, diff_text, provider="gemini"
         click.secho(__("⚠️ No diff found. Make some changes before running the command."), fg="yellow")
         return None
 
+    t_start = time.perf_counter()
+
     # Cache folder configuration
     action_folder_map = {
         "pr": "pr_desc",
@@ -299,6 +301,15 @@ def generate_pr_content(action_folder, action_type, diff_text, provider="gemini"
     cached_data = get_cached_response(action_folder, prompt)
     if cached_data:
         click.secho(__("⚡ Response retrieved from local cache."), fg="green", dim=True)
+        from src.metrics import log_command_metric
+        duration_ms = int((time.perf_counter() - t_start) * 1000)
+        log_command_metric(
+            command=action_type,
+            status="success",
+            provider=provider,
+            duration_ms=duration_ms,
+            cache_hit=True,
+        )
         return cached_data
 
     # Key Preparation (Now dynamic per Provider)
@@ -318,13 +329,14 @@ def generate_pr_content(action_folder, action_type, diff_text, provider="gemini"
     click.secho(__("🤖 GitPR is analyzing your code using {provider} ({model})...\n", provider=provider.capitalize(), model=api_model), fg="cyan")
     
     chunks = split_diff_into_chunks(diff_text, max_tokens=90000)
-    total_meta = {"prompt_tokens": 0, "completion_tokens": 0, "total_tokens": 0}
-    
+    total_meta = {"prompt_tokens": 0, "completion_tokens": 0, "total_tokens": 0, "duration_ms": 0}
+
     def _aggregate_meta(new_meta):
         if new_meta:
             total_meta["prompt_tokens"] += new_meta.get("prompt_tokens", 0)
             total_meta["completion_tokens"] += new_meta.get("completion_tokens", 0)
             total_meta["total_tokens"] += new_meta.get("total_tokens", 0)
+            total_meta["duration_ms"] += new_meta.get("duration_ms", 0)
             
     if len(chunks) == 1:
         result_json = call_ai_model(provider, api_key, api_model, prompt, instrucao_sistema, action=action_folder)
@@ -375,18 +387,21 @@ def generate_pr_content(action_folder, action_type, diff_text, provider="gemini"
         save_cached_response(action_folder, action_type, prompt, result_json, meta_raw=total_meta)
         # Fire-and-forget metric for successful AI-powered command
         from src.metrics import log_command_metric
+        duration_ms = int((time.perf_counter() - t_start) * 1000)
         log_command_metric(
             command=action_type,
             status="success",
             provider=provider,
             tokens_estimated=total_meta.get("total_tokens", 0),
+            duration_ms=duration_ms,
             map_reduce_triggered=(len(chunks) > 1),
         )
         return result_json
 
     # Command failed (AI returned None)
     from src.metrics import log_command_metric
-    log_command_metric(command=action_type, status="error", provider=provider)
+    duration_ms = int((time.perf_counter() - t_start) * 1000)
+    log_command_metric(command=action_type, status="error", provider=provider, duration_ms=duration_ms)
     return None
 
 

{gitpr_cli-0.0.30 → gitpr_cli-0.0.31}/src/issue_engine.py

@@ -1,6 +1,7 @@
 import subprocess
 import re
 import os
+import time
 import click
 from src.ai_providers import call_ai_model
 from src.cache import get_cached_response, save_cached_response
@@ -32,14 +33,20 @@ def get_github_repo_info():
 
 def generate_issue_content(context_text, context_type="diff"):
     """Sends the context (diff, blame, or history) to the AI and returns an issue dictionary."""
+    from src.metrics import log_command_metric
+
     if not context_text or not str(context_text).strip():
         return None
 
+    t_start = time.perf_counter()
+
     provider = get_ai_provider()
     api_key = get_api_key(provider)
 
     if not api_key:
         click.secho(__("❌ Error: API Key not found."), fg="red")
+        duration_ms = int((time.perf_counter() - t_start) * 1000)
+        log_command_metric(command="issue", status="error", provider=provider, duration_ms=duration_ms)
         return None
 
     # Use the advanced model to ensure Issue structure quality
@@ -69,11 +76,13 @@ def generate_issue_content(context_text, context_type="diff"):
         __("Generate the requested JSON object following the system instructions to {target_action}\n\n", target_action=target_action) +
         f"{data_label}\n{context_text}"
     )
-    
+
     # Try to retrieve from Cache
     cached_data = get_cached_response("issue", prompt)
     if cached_data:
         click.secho(__("⚡ Issue response retrieved from local cache."), fg="green", dim=True)
+        duration_ms = int((time.perf_counter() - t_start) * 1000)
+        log_command_metric(command="issue", status="success", provider=provider, duration_ms=duration_ms, cache_hit=True)
         return cached_data
 
     click.secho(__("🤖 Structuring Issue using {provider} ({api_model})...", provider=provider.capitalize(), api_model=api_model), fg="cyan", dim=True)
@@ -81,8 +90,19 @@ def generate_issue_content(context_text, context_type="diff"):
     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
-        save_cached_response("issue", "issue", prompt, result_json)
+        # Extract telemetry metadata and save to cache with real token counts
+        meta = result_json.pop("_telemetry_meta", None)
+        save_cached_response("issue", "issue", prompt, result_json, meta_raw=meta)
+        duration_ms = int((time.perf_counter() - t_start) * 1000)
+        log_command_metric(
+            command="issue",
+            status="success",
+            provider=provider,
+            tokens_estimated=(meta or {}).get("total_tokens", 0),
+            duration_ms=duration_ms,
+        )
         return result_json
-        
+
+    duration_ms = int((time.perf_counter() - t_start) * 1000)
+    log_command_metric(command="issue", status="error", provider=provider, duration_ms=duration_ms)
     return {"titulo": __("Error generating title"), "corpo": __("Could not generate issue body by AI.")}

{gitpr_cli-0.0.30 → gitpr_cli-0.0.31}/src/main.py

@@ -250,7 +250,8 @@ def cli(commit, review, fullreview, linter, skill, update, installhooks, install
 
     if metrics and export:
         from src.metrics import export_metrics
-        csv_path, json_path, count = export_metrics()
+        from src.core import get_repo_name
+        csv_path, json_path, count = export_metrics(repo_filter=get_repo_name())
         if count > 0:
             click.secho(__("✅ Metrics exported: {count} events.", count=count), fg="green", bold=True)
             if csv_path:
@@ -270,9 +271,10 @@ def cli(commit, review, fullreview, linter, skill, update, installhooks, install
             click.secho(__("Purge cancelled."), fg="yellow")
         return
 
-    if metrics and show_dashboard:
+    if show_dashboard:
         from src.ui.metrics_app import launch_metrics_dashboard
-        launch_metrics_dashboard()
+        from src.core import get_repo_name
+        launch_metrics_dashboard(repo_filter=get_repo_name())
         return
 
     if metrics:
@@ -364,20 +366,27 @@ def cli(commit, review, fullreview, linter, skill, update, installhooks, install
     if update:
         click.secho(__("🔍 Checking for updates..."), fg="cyan")
         check_and_update()
+        from src.metrics import log_command_metric
+        log_command_metric(command="update", status="success", provider="git")
         return
 
     # --install option: Interactive setup wizard
     if install:
         run_install_wizard()
+        from src.metrics import log_command_metric
+        log_command_metric(command="install", status="success", provider="git")
         return
 
     # --skill option: Generate template and exit
     if skill:
         generate_skill_template()
+        from src.metrics import log_command_metric
+        log_command_metric(command="skill", status="success", provider="git")
         return
     
     if installhooks:
-        if install_git_hooks():
+        hooks_ok = install_git_hooks()
+        if hooks_ok:
             click.secho("\n" + __("✅ Git Hooks successfully installed!"), fg="green", bold=True)
             click.echo(__("The Linter will now run automatically before each commit."))
 
@@ -392,6 +401,8 @@ def cli(commit, review, fullreview, linter, skill, update, installhooks, install
             click.echo(__("• How to create new Linter rules (.gitpr.linter.yml):"))
             click.secho(f"  {get_doc_url("linter-regras-customizadas.md")}", fg="blue")
             click.echo("---\n")
+        from src.metrics import log_command_metric
+        log_command_metric(command="installhooks", status="success" if hooks_ok else "error", provider="git")
         return
 
     # Archaeologist Module (--blame)
@@ -431,6 +442,8 @@ def cli(commit, review, fullreview, linter, skill, update, installhooks, install
         # Trigger the engine
         from src.blame_engine import run_blame_analysis
         run_blame_analysis(file_path.strip(), start_line.strip(), end_line.strip())
+        from src.metrics import log_command_metric
+        log_command_metric(command="blame", status="success", provider="git")
         return
 
     # Issue Module (Hybrid)
@@ -526,19 +539,32 @@ def cli(commit, review, fullreview, linter, skill, update, installhooks, install
 
         # Validate or request PAT Token
         github_token = validate_or_request_github_token(repo_info)
-        
+
         if not github_token:
             click.secho(__("❌ Access canceled. GitHub Token is mandatory for this action."), fg="red")
             return
-            
-        # Run the Terminal Graphical Interface
-        app = IssueApp(issue_data=issue_data, repo_info=repo_info, github_token=github_token)
-        app.run()
 
-        # Display return message after closing the TUI
-        if app.final_message:
-            cor = "green" if app.final_action in ["saved", "created"] else "red"
-            click.secho(f"\n{app.final_message}\n", fg=cor, bold=True)
+        # Run the Terminal Graphical Interface (with reauth loop for expired tokens)
+        while True:
+            app = IssueApp(issue_data=issue_data, repo_info=repo_info, github_token=github_token)
+            app.run()
+
+            # If token expired during the TUI session, re-prompt and relaunch
+            if app.final_action == "reauth":
+                click.secho(f"\n{app.final_message}\n", fg="yellow")
+                github_token = validate_or_request_github_token(repo_info)
+                if not github_token:
+                    click.secho(__("❌ Access canceled. GitHub Token is mandatory for this action."), fg="red")
+                    return
+                # Restart TUI with the same issue data and new token
+                continue
+
+            # Display return message after closing the TUI
+            if app.final_message:
+                cor = "green" if app.final_action in ["saved", "created"] else "red"
+                click.secho(f"\n{app.final_message}\n", fg=cor, bold=True)
+
+            break
 
         return
 
@@ -590,6 +616,8 @@ def cli(commit, review, fullreview, linter, skill, update, installhooks, install
             system_instruction=system_instruction
         )
         app.run()
+        from src.metrics import log_command_metric
+        log_command_metric(command="chat", status="success", provider=active_provider)
         click.secho(f"📚 {__('Chat documentation:')} {get_doc_url('understanding_chat_functionality.md')}", fg="cyan")
         return