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

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

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: gitpr-cli
-Version: 0.0.29
-Summary: Automação de PRs, Commits e Code Review com IA (Gemini e DeepSeek)
+Version: 0.0.30
+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
 Description-Content-Type: text/markdown
@@ -311,6 +311,7 @@ If you want to implement GitPR as an automated quality barrier in your team, che
 * [**MCP Integration**](https://github.com/natanfiuza/gitpr/blob/main/docs/mcp-integration.md) — Connect GitPR to VS Code, Cursor, and Claude Desktop via Model Context Protocol.
 * [**MCP Prompts**](https://github.com/natanfiuza/gitpr/blob/main/docs/mcp-prompts.md) — Pre-built message templates (7 prompts, 35 language variants) for common GitPR workflows in your editor's AI chat.
 * [**MCP Tool Annotations**](https://github.com/natanfiuza/gitpr/blob/main/docs/mcp-annotations.md) — IDE integration hints (`readOnlyHint`, `destructiveHint`) for smarter UI behavior and safer tool execution.
+* [**Metrics & Telemetry**](https://github.com/natanfiuza/gitpr/blob/main/docs/metricas-telemetria.md) — Local offline analytics for team usage metrics, exportable CSV reports, and interactive TUI dashboard.
 
 ## ⚡ Local Cache System (Quota Savings)
 

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

@@ -292,6 +292,7 @@ If you want to implement GitPR as an automated quality barrier in your team, che
 * [**MCP Integration**](https://github.com/natanfiuza/gitpr/blob/main/docs/mcp-integration.md) — Connect GitPR to VS Code, Cursor, and Claude Desktop via Model Context Protocol.
 * [**MCP Prompts**](https://github.com/natanfiuza/gitpr/blob/main/docs/mcp-prompts.md) — Pre-built message templates (7 prompts, 35 language variants) for common GitPR workflows in your editor's AI chat.
 * [**MCP Tool Annotations**](https://github.com/natanfiuza/gitpr/blob/main/docs/mcp-annotations.md) — IDE integration hints (`readOnlyHint`, `destructiveHint`) for smarter UI behavior and safer tool execution.
+* [**Metrics & Telemetry**](https://github.com/natanfiuza/gitpr/blob/main/docs/metricas-telemetria.md) — Local offline analytics for team usage metrics, exportable CSV reports, and interactive TUI dashboard.
 
 ## ⚡ Local Cache System (Quota Savings)
 

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

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: gitpr-cli
-Version: 0.0.29
-Summary: Automação de PRs, Commits e Code Review com IA (Gemini e DeepSeek)
+Version: 0.0.30
+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
 Description-Content-Type: text/markdown
@@ -311,6 +311,7 @@ If you want to implement GitPR as an automated quality barrier in your team, che
 * [**MCP Integration**](https://github.com/natanfiuza/gitpr/blob/main/docs/mcp-integration.md) — Connect GitPR to VS Code, Cursor, and Claude Desktop via Model Context Protocol.
 * [**MCP Prompts**](https://github.com/natanfiuza/gitpr/blob/main/docs/mcp-prompts.md) — Pre-built message templates (7 prompts, 35 language variants) for common GitPR workflows in your editor's AI chat.
 * [**MCP Tool Annotations**](https://github.com/natanfiuza/gitpr/blob/main/docs/mcp-annotations.md) — IDE integration hints (`readOnlyHint`, `destructiveHint`) for smarter UI behavior and safer tool execution.
+* [**Metrics & Telemetry**](https://github.com/natanfiuza/gitpr/blob/main/docs/metricas-telemetria.md) — Local offline analytics for team usage metrics, exportable CSV reports, and interactive TUI dashboard.
 
 ## ⚡ Local Cache System (Quota Savings)
 

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

@@ -19,6 +19,7 @@ src/issue_engine.py
 src/linter_engine.py
 src/main.py
 src/mcp_server.py
+src/metrics.py
 src/security.py
 src/spinner.py
 src/tui_issue.py
@@ -27,6 +28,7 @@ src/ui/__init__.py
 src/ui/chat_app.py
 src/ui/help_screen.py
 src/ui/issue_app.py
+src/ui/metrics_app.py
 tests/test_chat_backend.py
 tests/test_core.py
 tests/test_install_wizard.py

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

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "gitpr-cli"
-version = "0.0.29"
-description = "Automação de PRs, Commits e Code Review com IA (Gemini e DeepSeek)"
+version = "0.0.30"
+description = "AI-powered PR automation, commit messages, and code review (Gemini, DeepSeek, and Ollama)"
 readme = "README.md"
 requires-python = ">=3.10"
 authors = [

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

@@ -76,6 +76,7 @@ def call_ai_model(provider, api_key, api_model, prompt, system_instruction, quie
     try:
         for attempt in range(1, max_retries + 1):
             try:
+                meta_raw = {}
                 if provider == "gemini":
                     client = genai.Client(api_key=api_key)
                     response = client.models.generate_content(
@@ -90,6 +91,13 @@ def call_ai_model(provider, api_key, api_model, prompt, system_instruction, quie
                         }
                     )
                     result_text = response.text
+                    
+                    if hasattr(response, 'usage_metadata') and response.usage_metadata:
+                        meta_raw = {
+                            "prompt_tokens": getattr(response.usage_metadata, 'prompt_token_count', 0),
+                            "completion_tokens": getattr(response.usage_metadata, 'candidates_token_count', 0),
+                            "total_tokens": getattr(response.usage_metadata, 'total_token_count', 0)
+                        }
 
                 elif provider in ["deepseek", "ollama"]:
                     # DeepSeek and Ollama are 100% compatible with the OpenAI library.
@@ -106,6 +114,13 @@ def call_ai_model(provider, api_key, api_model, prompt, system_instruction, quie
                         temperature=0.0
                     )
                     result_text = response.choices[0].message.content
+                    
+                    if hasattr(response, 'usage') and response.usage:
+                        meta_raw = {
+                            "prompt_tokens": getattr(response.usage, 'prompt_tokens', 0),
+                            "completion_tokens": getattr(response.usage, 'completion_tokens', 0),
+                            "total_tokens": getattr(response.usage, 'total_tokens', 0)
+                        }
 
                 else:
                     spinner.stop()
@@ -119,6 +134,9 @@ def call_ai_model(provider, api_key, api_model, prompt, system_instruction, quie
                 if isinstance(result_json, list):
                     result_json = result_json[0] if result_json else {}
 
+                # Inject telemetry metadata silently into the response dictionary
+                result_json["_telemetry_meta"] = meta_raw
+
                 spinner.stop()
                 return result_json
 

{gitpr_cli-0.0.29 → gitpr_cli-0.0.30}/src/cache.py

@@ -1,6 +1,7 @@
 import os
 import json
 import hashlib
+import subprocess
 from datetime import datetime
 from pathlib import Path
 
@@ -13,6 +14,15 @@ def generate_md5(text):
     """Generates the MD5 hash of a string."""
     return hashlib.md5(text.encode('utf-8')).hexdigest()
 
+def get_git_user_info():
+    """Recupera o nome e email configurados no git local."""
+    try:
+        name = subprocess.run(["git", "config", "user.name"], capture_output=True, text=True, check=True).stdout.strip()
+        email = subprocess.run(["git", "config", "user.email"], capture_output=True, text=True, check=True).stdout.strip()
+        return name, email
+    except subprocess.CalledProcessError:
+        return "unknown", "unknown"
+    
 def get_cached_response(action_folder, prompt_text):
     """Checks if a valid cache exists for the prompt and returns the content."""
     md5_hash = generate_md5(prompt_text)
@@ -27,7 +37,7 @@ def get_cached_response(action_folder, prompt_text):
             return None
     return None
 
-def save_cached_response(action_folder, action_type, prompt_text, response_dict):
+def save_cached_response(action_folder, action_type, prompt_text, response_dict, meta_raw=None):
     """Saves the AI response to the local cache."""
     md5_hash = generate_md5(prompt_text)
     folder_path = get_cache_base_dir() / action_folder
@@ -37,11 +47,17 @@ def save_cached_response(action_folder, action_type, prompt_text, response_dict)
     from src.core import get_current_branch, get_repo_name
     current_branch = get_current_branch()
     repo_name = get_repo_name()
+    user_name, user_email = get_git_user_info()
+
+    if meta_raw is not None:
+        response_dict["meta_raw"] = meta_raw
 
     cache_data = {
         "md5": md5_hash,
         "repo": repo_name,
         "branch": current_branch,
+        "author_name": user_name,
+        "author_email": user_email,
         "datetime": datetime.now().strftime("%Y-%m-%d %H:%M:%S"),
         "action_type": action_type,
         "prompt": prompt_text,

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

@@ -16,6 +16,7 @@ from src.config import get_api_key, get_api_model, get_skill_dir, resolve_skill_
 from src.ai_providers import call_ai_model
 from src.i18n import __, CURRENT_LANG
 from src.updater import __lang_version__
+# Metrics are imported lazily inside generate_pr_content() to avoid circular imports
 
 # Smart Diff filter: files that consume AI tokens without adding semantic value.
 # The pattern list is managed remotely (templates/gitpr.smart-excludes.json) and
@@ -313,15 +314,26 @@ 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")
     
     chunks = split_diff_into_chunks(diff_text, max_tokens=90000)
+    total_meta = {"prompt_tokens": 0, "completion_tokens": 0, "total_tokens": 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)
+            
     if len(chunks) == 1:
         result_json = call_ai_model(provider, api_key, api_model, prompt, instrucao_sistema, action=action_folder)
+        if result_json:
+            _aggregate_meta(result_json.pop("_telemetry_meta", None))
     else:
+        from src.metrics import log_local_metric
+        log_local_metric(command="map_reduce", status="triggered", map_reduce_triggered=True, chunks_count=len(chunks))
+        
         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 = []
@@ -332,9 +344,11 @@ def generate_pr_content(action_folder, action_type, diff_text, provider="gemini"
             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']}")
+            
+            if resposta_parcial:
+                _aggregate_meta(resposta_parcial.pop("_telemetry_meta", None))
+                if "resumo" in resposta_parcial:
+                    resumos_parciais.append(f"### Batch {i}\n{resposta_parcial['resumo']}")
             
             time.sleep(1)
             
@@ -353,12 +367,26 @@ def generate_pr_content(action_folder, action_type, diff_text, provider="gemini"
             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)
+        if result_json:
+            _aggregate_meta(result_json.pop("_telemetry_meta", None))
 
     # SAVE TO CACHE AND RETURN
     if result_json:
-        save_cached_response(action_folder, action_type, prompt, result_json)
+        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
+        log_command_metric(
+            command=action_type,
+            status="success",
+            provider=provider,
+            tokens_estimated=total_meta.get("total_tokens", 0),
+            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)
     return None
 
 
@@ -487,7 +515,10 @@ def install_git_hooks():
     # Mapping: Hook Name in Git -> Template Name on your GitHub
     hooks_to_install = {
         "pre-commit": "pre-commit-template.sh",
-        "prepare-commit-msg": "prepare-commit-msg-template.sh"
+        "prepare-commit-msg": "prepare-commit-msg-template.sh",
+        "post-checkout": "post-checkout-template.sh",
+        "pre-push": "pre-push-template.sh",
+        "post-merge": "post-merge-template.sh",
     }
 
     base_url = "https://raw.githubusercontent.com/natanfiuza/gitpr/main/scripts/"

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

@@ -117,6 +117,11 @@ HELP_MAP: dict[str, dict[str, str]] = {
         'title': __('Language Override (--lang)'),
         'description': __('Forces the interface language for this execution (e.g.: en_us, pt_br). Overrides the GITPR_LANG environment variable and OS locale detection.'),
     },
+    'metrics': {
+        'url': get_doc_url('metricas_analytics_dashboard.md'),
+        'title': __('Metrics & Analytics (--metrics)'),
+        'description': __('Export or purge local telemetry data for team analytics.'),
+    },
 }
 
 # Priority for contextual help when multiple flags are used with -h
@@ -136,6 +141,7 @@ HELP_PRIORITY: dict[str, int] = {
     'history': 11,
     'provider': 12,
     'lang': 13,
+    'metrics': 15,
 }
 
 
@@ -160,8 +166,13 @@ 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('--mcp', is_flag=True, hidden=True, help=__("Start the MCP server for integration with VS Code, Cursor, Claude Desktop, etc."))
+@click.option('--metrics', is_flag=True, help=__("Shows local telemetry summary. Use --export to consolidate, --purge to clean."))
+@click.option('--export', is_flag=True, help=__("Exports consolidated metrics to CSV and JSON in the current folder."))
+@click.option('--purge', is_flag=True, help=__("Deletes all local metric files (~/.gitpr/metrics/). Requires confirmation."))
+@click.option('--hook-event', type=str, hidden=True, help=__("Internal: logs a git hook event name."))
+@click.option('--dashboard', 'show_dashboard', is_flag=True, help=__("Opens the interactive metrics dashboard (TUI)."))
 @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, install, hook, quiet, pre_save, provider, input, blame, history, issue, chat, help_flag, lang, mcp):
+def cli(commit, review, fullreview, linter, skill, update, installhooks, install, hook, quiet, pre_save, provider, input, blame, history, issue, chat, help_flag, lang, mcp, metrics, export, purge, hook_event, show_dashboard):
     """
     GitPR CLI - Intelligent PR Automation and AI Code Review.
 
@@ -208,7 +219,7 @@ def cli(commit, review, fullreview, linter, skill, update, installhooks, install
                     fg="yellow", dim=True,
                 )
 
-            # Exibe a URL da documentacao principal do GitPR como rodape
+            # Display the main GitPR documentation URL as a footer
             click.secho(
                 __(">> Repository: https://github.com/natanfiuza/gitpr"),
                 fg="bright_black",
@@ -231,6 +242,50 @@ def cli(commit, review, fullreview, linter, skill, update, installhooks, install
         reload_thinking_words(lang)
 
     # MCP Server Mode — start stdio MCP server (handled before any interactive setup)
+    if hook_event:
+        # Hidden: fire-and-forget git hook event logging
+        from src.metrics import log_command_metric
+        log_command_metric(command=f"hook:{hook_event}", status="fired", provider="git")
+        return
+
+    if metrics and export:
+        from src.metrics import export_metrics
+        csv_path, json_path, count = export_metrics()
+        if count > 0:
+            click.secho(__("✅ Metrics exported: {count} events.", count=count), fg="green", bold=True)
+            if csv_path:
+                click.echo(f"  CSV: {csv_path}")
+            if json_path:
+                click.echo(f"  JSON: {json_path}")
+        else:
+            click.secho(__("No new metrics to export."), fg="yellow")
+        return
+
+    if metrics and purge:
+        from src.metrics import purge_metrics
+        if click.confirm(__("⚠ This will permanently delete all local metric files. Continue?")):
+            removed = purge_metrics()
+            click.secho(__("✅ Metrics purged ({count} files removed).", count=removed), fg="green")
+        else:
+            click.secho(__("Purge cancelled."), fg="yellow")
+        return
+
+    if metrics and show_dashboard:
+        from src.ui.metrics_app import launch_metrics_dashboard
+        launch_metrics_dashboard()
+        return
+
+    if metrics:
+        from src.metrics import show_metrics_summary
+        summary = show_metrics_summary()
+        click.secho(__("\n📊 Local Telemetry Summary"), fg="cyan", bold=True)
+        click.echo(f"  {__('Path')}: {summary['path']}")
+        click.echo(f"  {__('Files')}: {summary['total_files']}")
+        click.echo(f"  {__('Disk usage')}: {summary['disk_usage']}")
+        click.echo()
+        click.echo(__("Use --metrics --export to consolidate, --metrics --purge to clean."))
+        return
+
     if mcp:
         from src.mcp_server import main as mcp_main
         mcp_main()
@@ -269,9 +324,9 @@ def cli(commit, review, fullreview, linter, skill, update, installhooks, install
         has_warnings = len(linter_results["warnings"]) > 0
         has_errors = len(linter_results["errors"]) > 0
 
-        # Processamento de Warnings (Apenas Avisos)
+        # Warning processing (best-practice advisories only)
         if has_warnings:
-            # Os avisos DEVEM aparecer sempre, mesmo no modo quiet
+            # Warnings MUST always appear, even in quiet mode
             click.secho(__("\n⚠️ The Linter generated {count} best practice warning(s):", count=len(linter_results['warnings'])), fg="yellow", bold=True)
             for alert in linter_results["warnings"]:
                 click.echo(f"  - {alert}")
@@ -291,6 +346,15 @@ def cli(commit, review, fullreview, linter, skill, update, installhooks, install
                 click.secho(__("\n✅ Code approved with warnings. The commit will proceed."), fg="green")
             else:
                 click.secho(__("\n✅ Clean code! No violations found by the local Linter."), fg="green", bold=True)
+
+        # Fire-and-forget linter metric
+        from src.metrics import log_command_metric
+        log_command_metric(
+            command="linter",
+            status="error" if has_errors else "success",
+            linter_errors=len(linter_results.get("errors", [])),
+            linter_warnings=len(linter_results.get("warnings", [])),
+        )
         return
 
     # Connection Guardian (Failing Fast)
@@ -511,7 +575,7 @@ def cli(commit, review, fullreview, linter, skill, update, installhooks, install
         
         system_instruction = __("You are a Senior Software Engineer acting as a Pair Programmer. Analyze the code provided and answer the user's questions clearly, objectively, and technically. Use Markdown to format code blocks. The current git diff is:\n\n{diff}", diff=diff_text)
         
-        # Pega o modelo primário configurado no .env
+        # Use the primary model configured in .env
         env_model_key = f"{active_provider.upper()}_API_MODEL_PRIMARY"
         api_model = os.getenv(env_model_key)
         if not api_model:
@@ -632,7 +696,7 @@ def cli(commit, review, fullreview, linter, skill, update, installhooks, install
         )
         content = data.get('review', __('No analysis generated.'))
         
-        # Chama o Linter. Se for "filereview", ativa o modo de arquivo completo.
+        # Run the Linter. If "filereview", enable full-file mode.
         if action_type == "filereview":
             linter_results = parse_diff_and_lint(diff_text, is_full_file=True, file_path=input)
         else:

gitpr_cli-0.0.30/src/metrics.py

@@ -0,0 +1,266 @@
+import os
+import json
+import threading
+import subprocess
+from datetime import datetime
+from pathlib import Path
+from src.chat_memory import gerar_uuid_base_15
+from src.core import get_current_branch, get_repo_name
+
+def _get_owner_name():
+    """Returns the repository owner or the local username as fallback."""
+    repo = get_repo_name()
+    if repo and repo != "unknown/repo":
+        return repo.split('/')[0]
+    
+    try:
+        name = subprocess.run(["git", "config", "user.name"], capture_output=True, text=True, check=True).stdout.strip()
+        return name.replace(" ", "_") if name else "local_user"
+    except Exception:
+        return "local_user"
+
+def _save_metric_async(payload):
+    """Saves the JSON payload to the correct directory silently and asynchronously."""
+    try:
+        owner = _get_owner_name()
+        branch = get_current_branch().replace("/", "-")
+        
+        metrics_dir = Path.home() / ".gitpr" / "metrics" / owner / branch
+        metrics_dir.mkdir(parents=True, exist_ok=True)
+        
+        uuid_str = gerar_uuid_base_15()
+        date_str = datetime.now().strftime("%Y%m%d")
+        file_name = f"{uuid_str}_{date_str}.json"
+        
+        file_path = metrics_dir / file_name
+        
+        with open(file_path, "w", encoding="utf-8") as f:
+            json.dump(payload, f, ensure_ascii=False, indent=2)
+    except Exception:
+        pass  # Fire-and-forget: failures must never break the CLI
+
+def log_local_metric(command, status, provider="local", tokens_estimated=0, duration_ms=0, **kwargs):
+    """Fires a local metric log in a separate daemon thread."""
+    payload = {
+        "timestamp": datetime.now().isoformat(),
+        "command": command,
+        "status": status,
+        "provider": provider,
+        "tokens_estimated": tokens_estimated,
+        "duration_ms": duration_ms,
+        "repo": get_repo_name(),
+        "branch": get_current_branch(),
+        **kwargs
+    }
+
+    thread = threading.Thread(target=_save_metric_async, args=(payload,))
+    thread.daemon = True
+    thread.start()
+
+
+def log_command_metric(command, status="success", provider=None, tokens_estimated=0,
+                       duration_ms=0, cache_hit=False, map_reduce_triggered=False,
+                       **kwargs):
+    """High-level metric logger for CLI commands.
+
+    Args:
+        command: Command name ('commit', 'review', 'fullreview', 'linter', etc.)
+        status: 'success', 'error', 'triggered', 'no_changes'
+        provider: AI provider used (None = local/no AI)
+        tokens_estimated: Estimated token count from AI usage metadata
+        duration_ms: Command duration in milliseconds
+        cache_hit: True if result was served from cache
+        map_reduce_triggered: True if map-reduce chunking was activated
+        **kwargs: Extra fields (linter_errors, linter_warnings, chunks_count, etc.)
+    """
+    if provider is None:
+        # Auto-detect: try config, fallback to 'local'
+        try:
+            from src.config import get_ai_provider
+            provider = get_ai_provider()
+        except Exception:
+            provider = "local"
+
+    log_local_metric(
+        command=command,
+        status=status,
+        provider=provider,
+        tokens_estimated=tokens_estimated,
+        duration_ms=duration_ms,
+        cache_hit=cache_hit,
+        map_reduce_triggered=map_reduce_triggered,
+        **kwargs
+    )
+
+
+def get_metrics_dir():
+    """Returns the path to the local metrics directory (~/.gitpr/metrics/)."""
+    return os.path.join(Path.home(), ".gitpr", "metrics")
+
+
+def get_metrics_state_file():
+    """Returns the path to the metrics state file (~/.gitpr/metrics/config.json)."""
+    return os.path.join(get_metrics_dir(), "config.json")
+
+
+def export_metrics(output_dir=None):
+    """Scans ~/.gitpr/metrics/, consolidates all JSON files into a CSV + JSON report.
+
+    Skips files already processed (tracked via config.json UUID list).
+    Returns (csv_path, json_path, event_count).
+    """
+    import click
+    from datetime import date
+
+    metrics_dir = get_metrics_dir()
+    state_file = get_metrics_state_file()
+
+    if not os.path.isdir(metrics_dir):
+        return None, None, 0
+
+    # Load already-exported UUIDs
+    exported_uuids = set()
+    if os.path.exists(state_file):
+        try:
+            with open(state_file, "r", encoding="utf-8") as f:
+                exported_uuids = set(json.load(f).get("exported", []))
+        except Exception:
+            pass
+
+    # Collect all unexported metric files
+    all_files = []
+    for root, dirs, files in os.walk(metrics_dir):
+        # Skip the export subdirectory
+        if "export" in root.replace(metrics_dir, "").split(os.sep):
+            continue
+        for fname in files:
+            if fname.endswith(".json") and not fname.startswith("config"):
+                fpath = os.path.join(root, fname)
+                # Check UUID (first part of filename before _YYYYMMDD)
+                uuid_part = fname.split("_")[0]
+                if uuid_part not in exported_uuids:
+                    all_files.append(fpath)
+
+    if not all_files:
+        return None, None, 0
+
+    # Consolidate all payloads
+    events = []
+    with click.progressbar(all_files, label="Exporting metrics") as bar:
+        for fpath in bar:
+            try:
+                with open(fpath, "r", encoding="utf-8") as f:
+                    events.append(json.load(f))
+            except Exception:
+                pass
+
+    if not events:
+        return None, None, 0
+
+    # Determine output directory
+    if output_dir is None:
+        output_dir = os.path.join(metrics_dir, "export")
+    os.makedirs(output_dir, exist_ok=True)
+
+    today_str = date.today().strftime("%Y-%m-%d")
+    csv_path = os.path.join(output_dir, f"gitpr_metrics_{today_str}.csv")
+    json_path = os.path.join(output_dir, f"gitpr_metrics_{today_str}.json")
+
+    # Write CSV
+    csv_columns = ["timestamp", "command", "status", "provider",
+                   "tokens_estimated", "duration_ms", "repo", "branch"]
+    with open(csv_path, "w", encoding="utf-8", newline="") as f:
+        f.write(",".join(csv_columns) + "\n")
+        for evt in events:
+            row = [str(evt.get(col, "")) for col in csv_columns]
+            f.write(",".join(f'"{v}"' for v in row) + "\n")
+
+    # Write JSON
+    with open(json_path, "w", encoding="utf-8") as f:
+        json.dump(events, f, ensure_ascii=False, indent=2)
+
+    # Update state file with newly exported UUIDs
+    new_uuids = set()
+    for fpath in all_files:
+        uuid_part = os.path.basename(fpath).split("_")[0]
+        new_uuids.add(uuid_part)
+    exported_uuids.update(new_uuids)
+
+    with open(state_file, "w", encoding="utf-8") as f:
+        json.dump({
+            "exported": sorted(exported_uuids),
+            "last_export": datetime.now().isoformat(),
+            "total_events": len(events) + len(exported_uuids)
+        }, f, ensure_ascii=False, indent=2)
+
+    return csv_path, json_path, len(events)
+
+
+def purge_metrics():
+    """Deletes all metric JSON files in ~/.gitpr/metrics/ (preserves config.json).
+
+    Returns the number of files removed.
+    """
+    import click
+
+    metrics_dir = get_metrics_dir()
+    if not os.path.isdir(metrics_dir):
+        return 0
+
+    removed = 0
+    for root, dirs, files in os.walk(metrics_dir):
+        for fname in files:
+            if fname.endswith(".json") and fname != "config.json":
+                fpath = os.path.join(root, fname)
+                try:
+                    os.remove(fpath)
+                    removed += 1
+                except Exception:
+                    pass
+
+    return removed
+
+
+def show_metrics_summary():
+    """Prints a summary of the local metrics directory."""
+    metrics_dir = get_metrics_dir()
+    state_file = get_metrics_state_file()
+
+    if not os.path.isdir(metrics_dir):
+        return {"total_files": 0, "total_events": 0, "disk_usage": "0 KB"}
+
+    total_files = 0
+    exported_count = 0
+    disk_bytes = 0
+
+    if os.path.exists(state_file):
+        try:
+            with open(state_file, "r", encoding="utf-8") as f:
+                state = json.load(f)
+                exported_count = len(state.get("exported", []))
+        except Exception:
+            pass
+
+    for root, dirs, files in os.walk(metrics_dir):
+        for fname in files:
+            if fname.endswith(".json"):
+                total_files += 1
+                fpath = os.path.join(root, fname)
+                try:
+                    disk_bytes += os.path.getsize(fpath)
+                except Exception:
+                    pass
+
+    if disk_bytes < 1024:
+        disk_usage = f"{disk_bytes} B"
+    elif disk_bytes < 1024 * 1024:
+        disk_usage = f"{disk_bytes / 1024:.1f} KB"
+    else:
+        disk_usage = f"{disk_bytes / (1024 * 1024):.1f} MB"
+
+    return {
+        "total_files": total_files,
+        "total_events": exported_count,
+        "disk_usage": disk_usage,
+        "path": metrics_dir
+    }

gitpr_cli-0.0.30/src/ui/metrics_app.py

@@ -0,0 +1,168 @@
+"""
+Metrics Dashboard TUI - displays telemetry data in an interactive terminal UI.
+
+Usage: gitpr --metrics --dashboard
+"""
+from textual.app import App, ComposeResult
+from textual.widgets import Header, Footer, Static, DataTable
+from textual.containers import Vertical, Horizontal
+from textual.binding import Binding
+import json
+import os
+from datetime import datetime
+from collections import Counter
+
+from src.i18n import __
+
+
+class MetricsApp(App):
+    """Interactive terminal dashboard for local telemetry data."""
+
+    TITLE = __("GitPR - Metrics Dashboard")
+    ENABLE_COMMAND_PALETTE = False
+
+    CSS = """
+    #summary {
+        padding: 1 2;
+        background: $surface;
+        border: solid $primary;
+        margin: 1 2;
+    }
+    #table_container {
+        height: 1fr;
+        margin: 0 2;
+    }
+    #status_bar {
+        padding: 0 2;
+        color: $text-muted;
+    }
+    """
+
+    BINDINGS = [
+        Binding("f5", "refresh", __("Refresh")),
+        Binding("escape", "quit", __("Exit")),
+    ]
+
+    def __init__(self, metrics_dir=None, **kwargs):
+        super().__init__(**kwargs)
+        self.metrics_dir = metrics_dir or os.path.join(
+            os.path.expanduser("~"), ".gitpr", "metrics"
+        )
+        self.events = []
+
+    def compose(self) -> ComposeResult:
+        yield Header(show_clock=True)
+
+        yield Static("", id="summary")
+
+        with Vertical(id="table_container"):
+            yield DataTable(id="events_table")
+
+        yield Static("", id="status_bar")
+        yield Footer()
+
+    def on_mount(self) -> None:
+        """Load data and populate the table."""
+        self._load_metrics()
+        self._populate_table()
+        self._update_summary()
+
+    def _load_metrics(self) -> None:
+        """Scan the metrics directory for all event JSON files."""
+        self.events = []
+        if not os.path.isdir(self.metrics_dir):
+            return
+
+        for root, dirs, files in os.walk(self.metrics_dir):
+            for fname in files:
+                if fname.endswith(".json") and not fname.startswith("config"):
+                    fpath = os.path.join(root, fname)
+                    try:
+                        with open(fpath, "r", encoding="utf-8") as f:
+                            self.events.append(json.load(f))
+                    except Exception:
+                        pass
+
+        # Sort by timestamp, newest first
+        self.events.sort(
+            key=lambda e: e.get("timestamp", ""),
+            reverse=True,
+        )
+
+    def _populate_table(self) -> None:
+        """Fill the DataTable with the loaded events."""
+        table = self.query_one("#events_table", DataTable)
+        table.clear()
+
+        if not self.events:
+            table.add_column(__("No metrics data found."))
+            return
+
+        columns = [
+            __("Timestamp"),
+            __("Command"),
+            __("Status"),
+            __("Provider"),
+            __("Tokens"),
+            __("Duration (ms)"),
+        ]
+        for col in columns:
+            table.add_column(col)
+
+        for evt in self.events[:100]:  # Show last 100 events
+            ts = evt.get("timestamp", "")[:19].replace("T", " ")
+            table.add_row(
+                ts,
+                evt.get("command", ""),
+                evt.get("status", ""),
+                evt.get("provider", ""),
+                str(evt.get("tokens_estimated", 0)),
+                str(evt.get("duration_ms", 0)),
+            )
+
+    def _update_summary(self) -> None:
+        """Update the summary bar with aggregate stats."""
+        summary = self.query_one("#summary", Static)
+        status = self.query_one("#status_bar", Static)
+
+        if not self.events:
+            summary.update(__("No metrics data found in ~/.gitpr/metrics/"))
+            status.update(
+                __("Use 'gitpr --metrics --export' to consolidate data for dashboards.")
+            )
+            return
+
+        total = len(self.events)
+        commands = Counter(e.get("command", "?") for e in self.events)
+        providers = Counter(e.get("provider", "?") for e in self.events)
+        total_tokens = sum(e.get("tokens_estimated", 0) for e in self.events)
+        errors = sum(1 for e in self.events if e.get("status") == "error")
+
+        top_cmds = ", ".join(f"{cmd}({n})" for cmd, n in commands.most_common(3))
+        top_prov = ", ".join(f"{p}({n})" for p, n in providers.most_common(2))
+
+        lines = [
+            f"{__('Total events')}: {total}  |  {__('Errors')}: {errors}  |  {__('Total tokens')}: {total_tokens:,}",
+            f"{__('Top commands')}: {top_cmds}",
+            f"{__('Providers')}: {top_prov}",
+        ]
+        summary.update("\n".join(lines))
+
+        # Show the newest event timestamp
+        newest = self.events[0].get("timestamp", "")[:19].replace("T", " ")
+        oldest = self.events[-1].get("timestamp", "")[:19].replace("T", " ")
+        status.update(
+            f"{__('Range')}: {oldest} → {newest}  |  {__('Showing')} {min(total, 100)} {__('of')} {total} {__('events')}"
+        )
+
+    def action_refresh(self) -> None:
+        """Reload data from disk."""
+        self._load_metrics()
+        self._populate_table()
+        self._update_summary()
+
+
+def launch_metrics_dashboard(metrics_dir=None):
+    """Entry point: launches the metrics TUI."""
+    app = MetricsApp(metrics_dir=metrics_dir)
+    app.run()

{gitpr_cli-0.0.29 → gitpr_cli-0.0.30}/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.29"  # GitPR current version
-__lang_version__ = "v0.0.7"  # Language dictionary version control
+__version__ = "0.0.30"  # GitPR current version
+__lang_version__ = "v0.0.8"  # 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"