gitpr-cli 0.0.14__tar.gz → 0.0.16__tar.gz

{gitpr_cli-0.0.14 → gitpr_cli-0.0.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitpr-cli
-Version: 0.0.14
+Version: 0.0.16
 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
@@ -29,6 +29,8 @@ Este projeto foi desenvolvido em Python e utiliza as seguintes bibliotecas princ
 * [**Pytest**](https://docs.pytest.org/): Para execução de testes unitários de forma simples, colorida e legível no console.
 * [**Cryptography**](https://cryptography.io/): Para garantir que sua `GEMINI_API_KEY` seja armazenada de forma encriptada e segura no disco.
 * [**PyYAML**](https://pyyaml.org/): Utilizado para ler e processar as regras customizadas de análise estática do arquivo `.gitpr.linter.yml`.
+* [**Textual**](https://textual.textualize.io/): Biblioteca poderosa para a criação de Interfaces Gráficas de Terminal (TUI), utilizada no painel interativo de geração e edição de Issues.
+* [**Requests**](https://pypi.org/project/requests/): Biblioteca elegante e robusta para requisições HTTP, utilizada para a comunicação com a API REST do GitHub.
 
 ----
 
@@ -124,6 +126,10 @@ Você pode passar as seguintes *flags* para ações específicas:
 * `-l` ou `--linter`: Roda **apenas o linter estático local** (sem chamadas de IA). Ideal para usar em pipelines de CI/CD para bloquear código fora do padrão.
 * `-ih` ou `--installhooks`: Instala automaticamente os **Git Hooks locais** (`pre-commit` e `prepare-commit-msg`) no seu repositório.
 * `-s` ou `--skill`: Cria os arquivos de template de contexto da IA (`.gitpr.commit.md`, `.gitpr.pr.md`, `.gitpr.review.md`, `.gitpr.filereview.md`) e do Linter (`.gitpr.linter.yml`) na raiz do projeto.
+* `-is` ou `--issue`: Gera automaticamente o rascunho de uma **Issue padronizada** e abre uma interface interativa (TUI) para edição ou envio direto via API REST. Esta funcionalidade possui **3 motores de contexto** dependendo da combinação de comandos:
+  * **Issue de Código Novo (`gitpr -is`):** Lê o `git diff` atual. **Por que usar:** Ideal para documentar rapidamente a tarefa que você acabou de programar, antes de commitar.
+  * **Issue de Épico/Release (`gitpr -is -ht`):** Lê o histórico completo da branch atual (Git Log + Cache de PRs). **Por que usar:** Ideal para gerar uma documentação consolidada de uma release inteira ou de uma *feature* grande que levou vários dias/commits para ser concluída.
+  * **Issue Arqueológica/Dívida Técnica (`gitpr -is -b arquivo:linhas`):** Lê a linha do tempo de uma regra específica. **Por que usar:** Ideal para documentar dívidas técnicas, explicando como um bloco de código legado evoluiu e por que precisa ser refatorado.
 * `-u` ou `--update`: Verifica e instala a versão mais recente do GitPR (Auto-Updater).
 * `-h` ou `--help`: Exibe o menu de ajuda.
 
@@ -175,7 +181,8 @@ Se você deseja implementar o GitPR como uma barreira de qualidade automatizada
 
 * [**Guia de Git Hooks Locais (Shift-Left)**](docs/local-git-hooks.md): Como usar o `gitpr --installhooks` para criar travas na máquina do desenvolvedor (bloqueio de *console.log*, *localhost*, etc.) e usar a IA para escrever mensagens de commit automaticamente no editor.
 * [**Integração com CI/CD (GitHub Actions)**](docs/github-ci-linter.md): Como rodar o GitPR no seu pipeline na nuvem para realizar a validação estática e travar o botão de "Merge" de Pull Requests que violem as regras do projeto.
-
+* [**Geração de Issues e Interface TUI**](docs/issue-tui-help.md): Como utilizar a interface gráfica de terminal (TUI) para revisar e gerenciar Issues estruturadas antes do envio.
+* [**Integração e Segurança do Token GitHub (PAT)**](docs/github-pat-integration.md): Entenda como o GitPR gera issues diretamente no seu repositório de forma autenticada, mantendo suas credenciais criptografadas localmente.
 
 ## ⚡ Sistema de Cache Local (Economia de Quota)
 
@@ -189,6 +196,7 @@ Nunca mais se preocupe em baixar novas versões manualmente. O GitPR possui um G
 * Em cada execução, ele verifica silenciosamente se há um novo release oficial na API do GitHub.
 * Você pode forçar a busca e instalação rodando `gitpr --update` ou `gitpr -u`.
 * A ferramenta utiliza a técnica de *Hot-Swap*, baixando o novo `.exe` e substituindo a versão antiga de forma transparente.
+
 ## Publicar no PyPi
 
 ```bash

{gitpr_cli-0.0.14 → gitpr_cli-0.0.16}/README.md

@@ -13,6 +13,8 @@ Este projeto foi desenvolvido em Python e utiliza as seguintes bibliotecas princ
 * [**Pytest**](https://docs.pytest.org/): Para execução de testes unitários de forma simples, colorida e legível no console.
 * [**Cryptography**](https://cryptography.io/): Para garantir que sua `GEMINI_API_KEY` seja armazenada de forma encriptada e segura no disco.
 * [**PyYAML**](https://pyyaml.org/): Utilizado para ler e processar as regras customizadas de análise estática do arquivo `.gitpr.linter.yml`.
+* [**Textual**](https://textual.textualize.io/): Biblioteca poderosa para a criação de Interfaces Gráficas de Terminal (TUI), utilizada no painel interativo de geração e edição de Issues.
+* [**Requests**](https://pypi.org/project/requests/): Biblioteca elegante e robusta para requisições HTTP, utilizada para a comunicação com a API REST do GitHub.
 
 ----
 
@@ -108,6 +110,10 @@ Você pode passar as seguintes *flags* para ações específicas:
 * `-l` ou `--linter`: Roda **apenas o linter estático local** (sem chamadas de IA). Ideal para usar em pipelines de CI/CD para bloquear código fora do padrão.
 * `-ih` ou `--installhooks`: Instala automaticamente os **Git Hooks locais** (`pre-commit` e `prepare-commit-msg`) no seu repositório.
 * `-s` ou `--skill`: Cria os arquivos de template de contexto da IA (`.gitpr.commit.md`, `.gitpr.pr.md`, `.gitpr.review.md`, `.gitpr.filereview.md`) e do Linter (`.gitpr.linter.yml`) na raiz do projeto.
+* `-is` ou `--issue`: Gera automaticamente o rascunho de uma **Issue padronizada** e abre uma interface interativa (TUI) para edição ou envio direto via API REST. Esta funcionalidade possui **3 motores de contexto** dependendo da combinação de comandos:
+  * **Issue de Código Novo (`gitpr -is`):** Lê o `git diff` atual. **Por que usar:** Ideal para documentar rapidamente a tarefa que você acabou de programar, antes de commitar.
+  * **Issue de Épico/Release (`gitpr -is -ht`):** Lê o histórico completo da branch atual (Git Log + Cache de PRs). **Por que usar:** Ideal para gerar uma documentação consolidada de uma release inteira ou de uma *feature* grande que levou vários dias/commits para ser concluída.
+  * **Issue Arqueológica/Dívida Técnica (`gitpr -is -b arquivo:linhas`):** Lê a linha do tempo de uma regra específica. **Por que usar:** Ideal para documentar dívidas técnicas, explicando como um bloco de código legado evoluiu e por que precisa ser refatorado.
 * `-u` ou `--update`: Verifica e instala a versão mais recente do GitPR (Auto-Updater).
 * `-h` ou `--help`: Exibe o menu de ajuda.
 
@@ -159,7 +165,8 @@ Se você deseja implementar o GitPR como uma barreira de qualidade automatizada
 
 * [**Guia de Git Hooks Locais (Shift-Left)**](docs/local-git-hooks.md): Como usar o `gitpr --installhooks` para criar travas na máquina do desenvolvedor (bloqueio de *console.log*, *localhost*, etc.) e usar a IA para escrever mensagens de commit automaticamente no editor.
 * [**Integração com CI/CD (GitHub Actions)**](docs/github-ci-linter.md): Como rodar o GitPR no seu pipeline na nuvem para realizar a validação estática e travar o botão de "Merge" de Pull Requests que violem as regras do projeto.
-
+* [**Geração de Issues e Interface TUI**](docs/issue-tui-help.md): Como utilizar a interface gráfica de terminal (TUI) para revisar e gerenciar Issues estruturadas antes do envio.
+* [**Integração e Segurança do Token GitHub (PAT)**](docs/github-pat-integration.md): Entenda como o GitPR gera issues diretamente no seu repositório de forma autenticada, mantendo suas credenciais criptografadas localmente.
 
 ## ⚡ Sistema de Cache Local (Economia de Quota)
 
@@ -173,6 +180,7 @@ Nunca mais se preocupe em baixar novas versões manualmente. O GitPR possui um G
 * Em cada execução, ele verifica silenciosamente se há um novo release oficial na API do GitHub.
 * Você pode forçar a busca e instalação rodando `gitpr --update` ou `gitpr -u`.
 * A ferramenta utiliza a técnica de *Hot-Swap*, baixando o novo `.exe` e substituindo a versão antiga de forma transparente.
+
 ## Publicar no PyPi
 
 ```bash

{gitpr_cli-0.0.14 → gitpr_cli-0.0.16}/gitpr_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitpr-cli
-Version: 0.0.14
+Version: 0.0.16
 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
@@ -29,6 +29,8 @@ Este projeto foi desenvolvido em Python e utiliza as seguintes bibliotecas princ
 * [**Pytest**](https://docs.pytest.org/): Para execução de testes unitários de forma simples, colorida e legível no console.
 * [**Cryptography**](https://cryptography.io/): Para garantir que sua `GEMINI_API_KEY` seja armazenada de forma encriptada e segura no disco.
 * [**PyYAML**](https://pyyaml.org/): Utilizado para ler e processar as regras customizadas de análise estática do arquivo `.gitpr.linter.yml`.
+* [**Textual**](https://textual.textualize.io/): Biblioteca poderosa para a criação de Interfaces Gráficas de Terminal (TUI), utilizada no painel interativo de geração e edição de Issues.
+* [**Requests**](https://pypi.org/project/requests/): Biblioteca elegante e robusta para requisições HTTP, utilizada para a comunicação com a API REST do GitHub.
 
 ----
 
@@ -124,6 +126,10 @@ Você pode passar as seguintes *flags* para ações específicas:
 * `-l` ou `--linter`: Roda **apenas o linter estático local** (sem chamadas de IA). Ideal para usar em pipelines de CI/CD para bloquear código fora do padrão.
 * `-ih` ou `--installhooks`: Instala automaticamente os **Git Hooks locais** (`pre-commit` e `prepare-commit-msg`) no seu repositório.
 * `-s` ou `--skill`: Cria os arquivos de template de contexto da IA (`.gitpr.commit.md`, `.gitpr.pr.md`, `.gitpr.review.md`, `.gitpr.filereview.md`) e do Linter (`.gitpr.linter.yml`) na raiz do projeto.
+* `-is` ou `--issue`: Gera automaticamente o rascunho de uma **Issue padronizada** e abre uma interface interativa (TUI) para edição ou envio direto via API REST. Esta funcionalidade possui **3 motores de contexto** dependendo da combinação de comandos:
+  * **Issue de Código Novo (`gitpr -is`):** Lê o `git diff` atual. **Por que usar:** Ideal para documentar rapidamente a tarefa que você acabou de programar, antes de commitar.
+  * **Issue de Épico/Release (`gitpr -is -ht`):** Lê o histórico completo da branch atual (Git Log + Cache de PRs). **Por que usar:** Ideal para gerar uma documentação consolidada de uma release inteira ou de uma *feature* grande que levou vários dias/commits para ser concluída.
+  * **Issue Arqueológica/Dívida Técnica (`gitpr -is -b arquivo:linhas`):** Lê a linha do tempo de uma regra específica. **Por que usar:** Ideal para documentar dívidas técnicas, explicando como um bloco de código legado evoluiu e por que precisa ser refatorado.
 * `-u` ou `--update`: Verifica e instala a versão mais recente do GitPR (Auto-Updater).
 * `-h` ou `--help`: Exibe o menu de ajuda.
 
@@ -175,7 +181,8 @@ Se você deseja implementar o GitPR como uma barreira de qualidade automatizada
 
 * [**Guia de Git Hooks Locais (Shift-Left)**](docs/local-git-hooks.md): Como usar o `gitpr --installhooks` para criar travas na máquina do desenvolvedor (bloqueio de *console.log*, *localhost*, etc.) e usar a IA para escrever mensagens de commit automaticamente no editor.
 * [**Integração com CI/CD (GitHub Actions)**](docs/github-ci-linter.md): Como rodar o GitPR no seu pipeline na nuvem para realizar a validação estática e travar o botão de "Merge" de Pull Requests que violem as regras do projeto.
-
+* [**Geração de Issues e Interface TUI**](docs/issue-tui-help.md): Como utilizar a interface gráfica de terminal (TUI) para revisar e gerenciar Issues estruturadas antes do envio.
+* [**Integração e Segurança do Token GitHub (PAT)**](docs/github-pat-integration.md): Entenda como o GitPR gera issues diretamente no seu repositório de forma autenticada, mantendo suas credenciais criptografadas localmente.
 
 ## ⚡ Sistema de Cache Local (Economia de Quota)
 
@@ -189,6 +196,7 @@ Nunca mais se preocupe em baixar novas versões manualmente. O GitPR possui um G
 * Em cada execução, ele verifica silenciosamente se há um novo release oficial na API do GitHub.
 * Você pode forçar a busca e instalação rodando `gitpr --update` ou `gitpr -u`.
 * A ferramenta utiliza a técnica de *Hot-Swap*, baixando o novo `.exe` e substituindo a versão antiga de forma transparente.
+
 ## Publicar no PyPi
 
 ```bash

{gitpr_cli-0.0.14 → gitpr_cli-0.0.16}/gitpr_cli.egg-info/SOURCES.txt

@@ -13,8 +13,10 @@ src/blame_engine.py
 src/cache.py
 src/config.py
 src/core.py
+src/issue_engine.py
 src/linter_engine.py
 src/main.py
 src/security.py
+src/tui_issue.py
 src/updater.py
 tests/test_core.py

{gitpr_cli-0.0.14 → gitpr_cli-0.0.16}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "gitpr-cli"
-version = "0.0.14"
+version = "0.0.16"
 description = "Automação de PRs, Commits e Code Review com IA (Gemini e DeepSeek)"
 readme = "README.md"
 requires-python = ">=3.10"

{gitpr_cli-0.0.14 → gitpr_cli-0.0.16}/src/blame_engine.py

@@ -89,19 +89,23 @@ def analyze_commit_with_ai(commit_hash, file_path):
         
     return {"status": "ORIGEM", "motivo": "IA não retornou formato válido."}
 
-def run_blame_analysis(file_path, start_line, end_line):
+def run_blame_analysis(file_path, start_line, end_line, return_data=False):
     """Motor de Loop Temporal que constrói a Timeline consolidada."""
-    click.secho(f"\n🔍 Iniciando Arqueologia de Código...", fg="cyan", bold=True)
-    click.echo(f"📍 Arquivo: {file_path} (Linhas: {start_line} até {end_line})")
+    
+    # Se for acionado para retorno de dados (via --issue), silencia os prints
+    if not return_data:
+        click.secho(f"\n🔍 Iniciando Arqueologia de Código...", fg="cyan", bold=True)
+        click.echo(f"📍 Arquivo: {file_path} (Linhas: {start_line} até {end_line})")
     
     initial_commits = execute_git_blame(file_path, start_line, end_line)
     
     if not initial_commits:
-        click.secho("⚠️ Nenhum commit rastreável encontrado nestas linhas.", fg="yellow")
-        return
+        if not return_data: 
+            click.secho("⚠️ Nenhum commit rastreável encontrado nestas linhas.", fg="yellow")
+        return [] if return_data else None
         
-    click.secho(f"✅ Encontrado(s) {len(initial_commits)} commit(s) na superfície. Iniciando viagem no tempo...\n", fg="green")
-    
+    if not return_data:
+        click.secho(f"✅ Encontrado(s) {len(initial_commits)} commit(s) na superfície. Iniciando viagem no tempo...\n", fg="green")
     master_timeline = []
     seen_hashes = set()
     
@@ -146,6 +150,10 @@ def run_blame_analysis(file_path, start_line, end_line):
     # ORDENAÇÃO CRONOLÓGICA (Do mais antigo para o mais novo)
     master_timeline.sort(key=lambda x: x["raw_date"])
     
+    # Retorno Direto para a IA
+    if return_data:
+        return master_timeline
+    
     # EXIBIÇÃO VISUAL NO TERMINAL (ÚNICA)
     click.secho(f"\n📜 Histórico Consolidado da Regra (Linhas {start_line}-{end_line}):", fg="magenta", bold=True)
     

{gitpr_cli-0.0.14 → gitpr_cli-0.0.16}/src/cache.py

@@ -3,6 +3,7 @@ import json
 import hashlib
 from datetime import datetime
 from pathlib import Path
+from src.core import get_current_branch
 
 def get_cache_base_dir():
     """Retorna o caminho ~/.gitpr/cache/prompts/"""
@@ -34,9 +35,11 @@ def save_cached_response(action_folder, action_type, prompt_text, response_dict)
     folder_path.mkdir(parents=True, exist_ok=True)
     
     cache_file = folder_path / f"{md5_hash}.json"
+    current_branch = get_current_branch()
     
     cache_data = {
         "md5": md5_hash,
+        "branch": current_branch,
         "datetime": datetime.now().strftime("%Y-%m-%d %H:%M:%S"),
         "action_type": action_type,
         "prompt": prompt_text,
@@ -47,4 +50,34 @@ def save_cached_response(action_folder, action_type, prompt_text, response_dict)
         with open(cache_file, "w", encoding="utf-8") as f:
             json.dump(cache_data, f, indent=2, ensure_ascii=False)
     except IOError:
-        pass # Falha silenciosa no cache para não travar a ferramenta
+        pass # Falha silenciosa no cache para não travar a ferramenta
+    
+def get_cached_pr_descriptions(branch_name):
+    """Busca no cache todos os PRs gerados historicamente para esta branch."""
+    pr_cache_folder = get_cache_base_dir() / "pr_desc"
+    history_texts = []
+    
+    if not pr_cache_folder.exists():
+        return ""
+        
+    for cache_file in pr_cache_folder.glob("*.json"):
+        try:
+            with open(cache_file, "r", encoding="utf-8") as f:
+                data = json.load(f)
+                
+                # Verifica se o cache pertence à branch solicitada
+                if data.get("branch") == branch_name:
+                    response_dict = data.get("response", {})
+                    pr_desc = response_dict.get("pr_description")
+                    if pr_desc:
+                        date_str = data.get("datetime", "Data desconhecida")
+                        history_texts.append(f"[{date_str}]\n{pr_desc}\n")
+        except (json.JSONDecodeError, IOError):
+            continue
+            
+    if history_texts:
+        # Ordena cronologicamente (usando a data extraída no colchete)
+        history_texts.sort()
+        return "=== HISTÓRICO DE PRs DA IA ===\n" + "\n".join(history_texts)
+        
+    return ""

{gitpr_cli-0.0.14 → gitpr_cli-0.0.16}/src/config.py

@@ -21,7 +21,8 @@ DEFAULT_CONFIG = {
     "OUTPUT_FILE_NAME_REVIEW": "{branch}_{datetime}_PR_REVIEW.txt",
     "OUTPUT_FILE_NAME_FULLREVIEW": "{branch}_{datetime}_PR_FULLREVIEW.txt",
     "OUTPUT_FILE_NAME_FILEREVIEW": "{branch}_{datetime}_FILE_REVIEW.txt",
-    "OUTPUT_FILE_NAME_BLAME": "{branch}_{datetime}_BLAME_REPORT.md"
+    "OUTPUT_FILE_NAME_BLAME": "{branch}_{datetime}_BLAME_REPORT.md",
+    "OUTPUT_FILE_NAME_ISSUE": "{branch}_{datetime}_ISSUE.md"
 }
 
 def get_ai_provider():
@@ -152,4 +153,13 @@ def load_linter_rules():
         return []
     except Exception as e:
         click.secho(f"\n❌ Erro inesperado ao ler as regras do linter: {e}", fg="red")
-        return []        
+        return []        
+    
+def get_github_token():
+    """Lê e desencripta o token de acesso pessoal (PAT) do GitHub."""
+    load_dotenv(ENV_FILE)
+    encrypted_token = os.getenv("GITHUB_TOKEN_ENCRYPTED")
+    
+    if encrypted_token:
+        return decrypt_data(encrypted_token)
+    return None

{gitpr_cli-0.0.14 → gitpr_cli-0.0.16}/src/core.py

@@ -7,11 +7,12 @@ import urllib.request
 import urllib.error
 from google import genai
 from src.security import decrypt_data
-from src.cache import get_cached_response, save_cached_response
+from src.cache import get_cached_response, save_cached_response, get_cached_pr_descriptions
 from src.config import get_api_key, get_api_model
 from src.ai_providers import call_ai_model
 
 
+
 def get_git_diff():
     """Executa 'git diff HEAD' e retorna a saída, alertando sobre arquivos não monitorados (untracked)."""
     try:
@@ -76,6 +77,8 @@ def get_skill_context(action_type="pr"):
         target_file = ".gitpr.pr.md"
     elif action_type == "filereview": # NOVO!
         target_file = ".gitpr.filereview.md"        
+    elif action_type == "issue":
+        target_file = ".gitpr.issue.md"        
     else: # review ou fullreview
         target_file = ".gitpr.review.md"
 
@@ -189,6 +192,7 @@ def generate_skill_template():
         ".gitpr.linter.yml": "gitpr.linter.yml",
         ".gitpr.filereview.md": "gitpr.filereview.md", 
         ".gitpr.blame.md": "gitpr.blame.md", 
+        ".gitpr.issue.md": "gitpr.issue.md",
     }
     
     success_count = 0
@@ -309,4 +313,47 @@ def install_git_hooks():
         except Exception as e:
             click.secho(f"⚠️ Falha ao instalar {hook_name}: {e}", fg="yellow")
 
-    return success_count == len(hooks_to_install)
+    return success_count == len(hooks_to_install)
+
+def get_branch_history_text():
+    """Compila o Git Log e o Cache de PRs da branch atual para gerar o contexto épico."""
+    branch = get_current_branch()
+    base_branch = get_base_branch()
+    
+    click.secho(f"🔄 Compilando histórico da branch '{branch}' contra '{base_branch}'...", fg="cyan")
+    
+    hybrid_context = f"Resumo Histórico da Branch: {branch}\n\n"
+    
+    # Pega os Commits reais do Git
+    try:
+        # Pega a linha do tempo desde o merge base
+        merge_base_res = subprocess.run(
+            ["git", "merge-base", f"origin/{base_branch}", "HEAD"],
+            capture_output=True, text=True, check=True
+        )
+        ancestor_hash = merge_base_res.stdout.strip()
+        
+        # Formato: Hash | Data | Autor | Mensagem
+        git_log_res = subprocess.run(
+            ["git", "log", f"{ancestor_hash}..HEAD", "--format=%h | %ad | %an | %s", "--date=short"],
+            capture_output=True, text=True, encoding="utf-8", check=True
+        )
+        git_log = git_log_res.stdout.strip()
+        
+        hybrid_context += "=== COMMITS REGISTRADOS ===\n"
+        if git_log:
+            hybrid_context += f"{git_log}\n\n"
+        else:
+            hybrid_context += "Nenhum commit exclusivo encontrado nesta branch.\n\n"
+            
+    except subprocess.CalledProcessError as e:
+        click.secho(f"⚠️ Aviso: Não foi possível obter o Git Log: {e.stderr}", fg="yellow")
+    
+    # Pega a memória histórica da IA (Cache de PRs antigos dessa branch)
+    cached_prs = get_cached_pr_descriptions(branch)
+    if cached_prs:
+        hybrid_context += f"{cached_prs}\n"
+    else:
+        hybrid_context += "=== HISTÓRICO DE PRs DA IA ===\nNenhum PR anterior gerado por IA encontrado em cache para esta branch.\n"
+        
+    return hybrid_context

gitpr_cli-0.0.16/src/issue_engine.py

@@ -0,0 +1,87 @@
+import subprocess
+import re
+import os
+import click
+from src.ai_providers import call_ai_model
+from src.cache import get_cached_response, save_cached_response
+from src.config import get_api_key, get_api_model, get_ai_provider
+from src.ai_providers import call_ai_model
+
+def get_github_repo_info():
+    """Extrai o formato owner/repo do comando git remote -v."""
+    try:
+        result = subprocess.run(
+            ["git", "remote", "-v"],
+            capture_output=True,
+            text=True,
+            check=True
+        )
+        
+        # Busca padrões como git@github.com:owner/repo.git ou https://github.com/owner/repo.git
+        match = re.search(r'github\.com[:/](.+?)/(.+?)(\.git)?\s+\(push\)', result.stdout)
+        
+        if match:
+            owner = match.group(1)
+            repo = match.group(2).replace('.git', '')
+            return f"{owner}/{repo}"
+            
+        return None
+    except subprocess.CalledProcessError:
+        return None
+
+def generate_issue_content(context_text, context_type="diff"):
+    """Envia o contexto (diff, blame ou history) para a IA e retorna um dicionário da issue."""
+    if not context_text or not str(context_text).strip():
+        return None
+
+    provider = get_ai_provider()
+    api_key = get_api_key(provider)
+    
+    if not api_key:
+        click.secho("❌ Erro: Chave de API não encontrada.", fg="red")
+        return None
+
+    # Utilizamos o modelo avançado para garantir a qualidade da estrutura da Issue
+    api_model = get_api_model(provider, task_complexity="advanced")
+
+    skill_path = os.path.join(os.getcwd(), ".gitpr.issue.md")
+    sys_inst = ""
+    
+    if os.path.exists(skill_path):
+        with open(skill_path, "r", encoding="utf-8") as f:
+            sys_inst = f.read()
+    else:
+        sys_inst = "Você é um Arquiteto de Software. Siga o formato O Que / Por Que / Onde / Como para documentar a Issue."
+
+    # Cérebro Adaptativo (Prompt Dinâmico)
+    if context_type == "blame":
+        target_action = "documentar a evolução arquitetural, refatorações e a dívida técnica desta regra de negócio baseando-se no histórico de commits."
+        data_label = "LINHA DO TEMPO DA REGRA (DO MAIS ANTIGO PARA O MAIS NOVO):"
+    elif context_type == "history":
+        target_action = "documentar o Épico/Release detalhando todas as funcionalidades implementadas baseando-se no histórico integral da branch."
+        data_label = "HISTÓRICO CONSOLIDADO DA BRANCH (COMMITS + PRS ANTIGOS):"
+    else:
+        target_action = "documentar a seguinte alteração de código recém introduzida."
+        data_label = "DIFF PARA ANÁLISE:"
+
+    prompt = (
+        f"Gere o objeto JSON solicitado seguindo as instruções de sistema para {target_action}\n\n"
+        f"{data_label}\n{context_text}"
+    )
+    
+    # Tenta recuperar do Cache
+    cached_data = get_cached_response("issue", prompt)
+    if cached_data:
+        click.secho("⚡ Resposta da Issue recuperada do cache local.", fg="green", dim=True)
+        return cached_data
+
+    click.secho(f"🤖 Estruturando a Issue usando {provider.capitalize()} ({api_model})...", fg="cyan", dim=True)
+    
+    result_json = call_ai_model(provider, api_key, api_model, prompt, sys_inst)
+    
+    if result_json and "titulo" in result_json and "corpo" in result_json:
+        # Salva no Cache 
+        save_cached_response("issue", "issue", prompt, result_json)
+        return result_json
+        
+    return {"titulo": "Erro ao gerar título", "corpo": "Não foi possível gerar o corpo da issue pela IA."}

{gitpr_cli-0.0.14 → gitpr_cli-0.0.16}/src/main.py

@@ -12,7 +12,8 @@ from src.core import (
     get_current_branch, 
     generate_pr_content,  
     generate_skill_template,
-    install_git_hooks
+    install_git_hooks,
+    get_branch_history_text
 )
 from src.linter_engine import parse_diff_and_lint
 
@@ -29,7 +30,7 @@ def print_banner():
 """
     click.secho(banner, fg="cyan", bold=True)
     click.secho(f"  🚀 Automação Inteligente de PRs com IA (v{__version__})", fg="yellow", bold=True)
-    click.secho("  Opções: -c,--commit | -r,--review | -f,--fullreview | -l,--linter | -s,--skill | -u,--update | -ih,--installhooks | -h ou --help\n", fg="white", dim=True)
+    click.secho("  Opções: -c,--commit | -r,--review | -f,--fullreview | -l,--linter | -s,--skill | -u,--update | -ih,--installhooks | -is,--issue | -h ou --help\n", fg="white", dim=True)
 
 
 # Configuração nativa do Click para aceitar -h além de --help
@@ -46,8 +47,10 @@ def print_banner():
 @click.option('-q', '--quiet', is_flag=True, hidden=True, help="Oculta o banner e logs não essenciais (uso interno).")
 @click.option('-i', '--input', type=click.Path(exists=True), help="Caminho de um arquivo específico para análise completa.")
 @click.option('-b', '--blame', type=str, help="Analisa a origem de uma regra de negócio (ex: arquivo.py:10-20 ou apenas arquivo.py).")
+@click.option('-ht', '--history', is_flag=True, help="Usa todo o histórico da branch (Git Log + Cache de PR) como contexto para gerar a issue.")
+@click.option('-is', '--issue', is_flag=True, help="Gera uma Issue padronizada das alterações atuais e abre a interface interativa.")
 @click.option('-p', '--provider', type=click.Choice(['gemini', 'deepseek']), help="Força a utilização de um provedor de IA específico nesta execução.")
-def cli(commit, review, fullreview, linter, skill, update, installhooks, hook, quiet, provider, input, blame):
+def cli(commit, review, fullreview, linter, skill, update, installhooks, hook, quiet, provider, input, blame,history, issue):
     """
     GitPR CLI - Automação de PRs e Code Review com IA.
 
@@ -139,7 +142,7 @@ def cli(commit, review, fullreview, linter, skill, update, installhooks, hook, q
         return
     
     # Módulo Arqueólogo (--blame)
-    if blame:
+    if blame and not issue:
         # Parser para separar o arquivo das linhas
         if ":" in blame:
             # Modo Direto: gitpr --blame arquivo:10-20
@@ -176,7 +179,101 @@ def cli(commit, review, fullreview, linter, skill, update, installhooks, hook, q
         from src.blame_engine import run_blame_analysis
         run_blame_analysis(file_path.strip(), start_line.strip(), end_line.strip())
         return 
- 
+
+# Módulo Issue (Híbrido)
+    if issue:
+        from src.issue_engine import generate_issue_content, get_github_repo_info
+        from src.tui_issue import validate_or_request_github_token, IssueApp
+        
+        setup_environment()
+        
+        context_text = ""
+        context_type = "diff"
+        
+        # Roteador de Contexto Inteligente
+        if history:
+            context_type = "history"
+            context_text = get_branch_history_text()
+            if not context_text or ("Nenhum commit exclusivo" in context_text and "Nenhum PR anterior" in context_text):
+                click.secho("\n⚠️ Nenhum histórico encontrado para esta branch.\n", fg="yellow")
+                return
+                
+        elif blame:
+            context_type = "blame"
+            # Reaproveita o parser de arquivo/linhas da opção blame
+            if ":" in blame:
+                file_path, lines = blame.split(":", 1)
+                try:
+                    start_line, end_line = lines.split("-") if "-" in lines else (lines, lines)
+                except ValueError:
+                    click.secho("❌ Formato de linhas inválido. Use inicio-fim (ex: 10-20).", fg="red")
+                    return
+            else:
+                file_path = blame
+                if not os.path.exists(file_path):
+                    click.secho(f"❌ O arquivo '{file_path}' não foi encontrado.", fg="red")
+                    return
+                click.secho(f"📂 Arquivo selecionado: {file_path}", fg="cyan", bold=True)
+                lines_input = click.prompt("Quais linhas você deseja investigar? (Ex: 10-20)")
+                start_line, end_line = lines_input.split("-") if "-" in lines_input else (lines_input, lines_input)
+                    
+            if not os.path.exists(file_path.strip()):
+                click.secho(f"❌ O arquivo '{file_path}' não foi encontrado.", fg="red")
+                return
+                
+            from src.blame_engine import run_blame_analysis
+            click.secho("🔍 Extraindo linha do tempo arqueológica em background...", fg="cyan")
+            
+            # Aciona o arqueólogo no modo silencioso
+            timeline = run_blame_analysis(file_path.strip(), start_line.strip(), end_line.strip(), return_data=True)
+            
+            if not timeline:
+                click.secho("\n⚠️ Nenhum histórico rastreável para alimentar a issue.\n", fg="yellow")
+                return
+            
+            # Traduz a lista de dicionários para um texto legível para a IA
+            formatted_timeline = []
+            for item in timeline:
+                formatted_timeline.append(
+                    f"[{item['raw_date']}] Commit {item['hash']} por {item['info']['author']}:\n"
+                    f"Ação: {item['status']}\n"
+                    f"Motivo IA: {item['motivo']}\n"
+                )
+            context_text = "\n".join(formatted_timeline)
+
+        else:
+            context_type = "diff"
+            context_text = get_git_diff()
+            if not context_text or not context_text.strip():
+                click.secho("\n⚠️ Nenhum código novo encontrado. Faça alguma alteração antes de gerar a issue.\n", fg="yellow")
+                return
+
+        # Gera o conteúdo com a IA enviando o idioma correto
+        issue_data = generate_issue_content(context_text, context_type=context_type)
+        if not issue_data:
+            return
+            
+        # Pega informações do repositório
+        repo_info = get_github_repo_info()
+        
+        # Valida ou solicita o Token PAT
+        github_token = validate_or_request_github_token(repo_info)
+        
+        if not github_token:
+            click.secho("❌ Acesso cancelado. O Token do GitHub é obrigatório para esta ação.", fg="red")
+            return
+            
+        # Roda a Interface Gráfica do Terminal
+        app = IssueApp(issue_data=issue_data, repo_info=repo_info, github_token=github_token)
+        app.run()
+        
+        # Exibe a mensagem de retorno após fechar a 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)
+            
+        return 
+
     # Validação do Modo Input
     if input and not (review or fullreview):
         click.secho("\n❌ Erro: A opção --input (-i) só pode ser utilizada em conjunto com --review (-r) ou --fullreview (-f).", fg="red", bold=True)

gitpr_cli-0.0.16/src/tui_issue.py

@@ -0,0 +1,34 @@
+import click
+from dotenv import set_key
+from src.security import encrypt_data
+from src.config import get_github_token, ENV_FILE
+
+# Importa a classe do aplicativo da nossa nova pasta de classes
+from src.ui.issue_app import IssueApp
+
+def validate_or_request_github_token(repo_info):
+    """Verifica se o PAT existe, caso contrário solicita ao usuário, encripta e salva."""
+    token = get_github_token()
+    if token:
+        return token
+    
+    click.secho(f"\n🔐 Autenticação do GitHub Necessária", fg="cyan", bold=True)
+    click.echo("Para criar issues diretamente, precisamos de um Personal Access Token (PAT).")
+    click.echo("Clique no link abaixo para gerar um com a permissão 'repo' já selecionada:")
+    
+    repo_param = repo_info if repo_info else "seu-repositorio"
+    url_token = f"https://github.com/settings/tokens/new?scopes=repo&description=GitPR+Token+({repo_param})"
+    click.secho(f"👉 {url_token}\n", fg="blue", underline=True)
+    
+    # Link dinâmico para a documentação técnica
+    click.secho("📚 Entenda por que precisamos do Token e como ele é protegido por criptografia:", fg="cyan", dim=True)
+    click.secho("👉 https://github.com/natanfiuza/gitpr/blob/main/docs/github-pat-integration.md\n", fg="blue", underline=True)
+    
+    raw_token = click.prompt("Cole aqui o seu Token (PAT)", hide_input=True)
+    
+    encrypted_token = encrypt_data(raw_token.strip())
+    
+    set_key(ENV_FILE, "GITHUB_TOKEN_ENCRYPTED", encrypted_token)
+    click.secho("✅ Token encriptado e salvo com segurança no .env!\n", fg="green")
+    
+    return raw_token.strip()

{gitpr_cli-0.0.14 → gitpr_cli-0.0.16}/src/updater.py

@@ -7,7 +7,7 @@ import click
 from datetime import datetime
 
 # Versão atual do seu executável local (Atualize isso a cada novo build!)
-__version__ = "0.0.14"
+__version__ = "0.0.16"
 GITHUB_API_URL = "https://api.github.com/repos/natanfiuza/gitpr/releases/latest"
 PYPI_API_URL = "https://pypi.org/pypi/gitpr-cli/json"