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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitpr-cli
-Version: 0.0.14
+Version: 0.0.15
 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,7 @@ 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** a partir do diff e abre uma interface interativa (TUI) para edição, salvamento ou envio direto para o repositório no GitHub via API REST.
 * `-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 +178,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 +193,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.15}/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,7 @@ 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** a partir do diff e abre uma interface interativa (TUI) para edição, salvamento ou envio direto para o repositório no GitHub via API REST.
 * `-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 +162,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 +177,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.15}/gitpr_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitpr-cli
-Version: 0.0.14
+Version: 0.0.15
 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,7 @@ 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** a partir do diff e abre uma interface interativa (TUI) para edição, salvamento ou envio direto para o repositório no GitHub via API REST.
 * `-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 +178,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 +193,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.15}/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.15}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "gitpr-cli"
-version = "0.0.14"
+version = "0.0.15"
 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.15}/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.15}/src/core.py

@@ -76,6 +76,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 +191,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

gitpr_cli-0.0.15/src/issue_engine.py

@@ -0,0 +1,76 @@
+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(diff_text):
+    """Envia o diff para a IA e retorna um dicionário com título e corpo da issue."""
+    if not diff_text or not diff_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."
+
+    prompt = (
+        f"Gere o objeto JSON solicitado seguindo as instruções de sistema para documentar a seguinte alteração:\n\n"
+        f"DIFF PARA ANÁLISE:\n{diff_text}"
+    )
+
+    # --- NOVO: 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:
+        # --- NOVO: 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.15}/src/main.py

@@ -29,7 +29,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 +46,9 @@ 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('-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, issue):
     """
     GitPR CLI - Automação de PRs e Code Review com IA.
 
@@ -177,6 +178,46 @@ def cli(commit, review, fullreview, linter, skill, update, installhooks, hook, q
         run_blame_analysis(file_path.strip(), start_line.strip(), end_line.strip())
         return 
  
+    # Módulo Issue (--issue)
+    if issue:
+        # Importações sob demanda para não atrasar a CLI se não for usar a TUI
+        from src.issue_engine import generate_issue_content, get_github_repo_info
+        from src.tui_issue import validate_or_request_github_token, IssueApp
+        
+        diff_text = get_git_diff()
+        if not diff_text or not diff_text.strip():
+            click.secho("\n⚠️ Nenhum código novo encontrado. Faça alguma alteração antes de gerar a issue.\n", fg="yellow")
+            return
+
+        # Garante que as chaves da IA estão configuradas antes de chamar o motor
+        setup_environment()
+        
+        # Gera o conteúdo com a IA
+        issue_data = generate_issue_content(diff_text)
+        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.15/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)
+    
+    # --- NOVO: 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.15}/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.15"
 GITHUB_API_URL = "https://api.github.com/repos/natanfiuza/gitpr/releases/latest"
 PYPI_API_URL = "https://pypi.org/pypi/gitpr-cli/json"