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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitpr-cli
-Version: 0.0.13
+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)
 
@@ -190,6 +194,12 @@ Nunca mais se preocupe em baixar novas versões manualmente. O GitPR possui um G
 * 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
+pipenv run python -m build
+pipenv run twine upload dist/*
+```
 ## **🤝 Como Contribuir**
 
 Contribuições são muito bem-vindas! Para contribuir:

{gitpr_cli-0.0.13 → 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)
 
@@ -174,6 +178,12 @@ Nunca mais se preocupe em baixar novas versões manualmente. O GitPR possui um G
 * 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
+pipenv run python -m build
+pipenv run twine upload dist/*
+```
 ## **🤝 Como Contribuir**
 
 Contribuições são muito bem-vindas! Para contribuir:

{gitpr_cli-0.0.13 → 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.13
+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)
 
@@ -190,6 +194,12 @@ Nunca mais se preocupe em baixar novas versões manualmente. O GitPR possui um G
 * 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
+pipenv run python -m build
+pipenv run twine upload dist/*
+```
 ## **🤝 Como Contribuir**
 
 Contribuições são muito bem-vindas! Para contribuir:

{gitpr_cli-0.0.13 → gitpr_cli-0.0.15}/gitpr_cli.egg-info/SOURCES.txt

@@ -9,11 +9,14 @@ gitpr_cli.egg-info/requires.txt
 gitpr_cli.egg-info/top_level.txt
 src/__init__.py
 src/ai_providers.py
+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.13 → gitpr_cli-0.0.15}/pyproject.toml

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

@@ -0,0 +1,216 @@
+import subprocess
+import click
+import re
+import os
+from datetime import datetime
+from src.core import get_current_branch
+from src.config import get_api_key, get_api_model, get_ai_provider
+from src.ai_providers import call_ai_model
+
+def execute_git_blame(file_path, start_line, end_line, commit_hash=None):
+    """Executa o git blame e retorna uma lista de hashes únicos."""
+    cmd = ["git", "blame", f"-L", f"{start_line},{end_line}"]
+    if commit_hash:
+        cmd.append(commit_hash)
+    cmd.extend(["--", file_path])
+
+    try:
+        result = subprocess.run(
+            cmd, capture_output=True, text=True, encoding="utf-8", errors="replace", check=True
+        )
+        hashes = set()
+        for line in result.stdout.strip().split('\n'):
+            if line:
+                match = re.match(r'^([a-fA-F0-9]+)\s', line)
+                if match:
+                    commit = match.group(1)
+                    if not commit.startswith('000000'):
+                        hashes.add(commit)
+        return list(hashes)
+    except subprocess.CalledProcessError as e:
+        # Se falhar (ex: arquivo não existia naquele commit antigo), silenciamos e retornamos vazio
+        return []
+
+def execute_git_show(commit_hash, file_path):
+    """Executa o git show para pegar o diff exato."""
+    cmd = ["git", "show", commit_hash, "--", file_path]
+    try:
+        result = subprocess.run(
+            cmd, capture_output=True, text=True, encoding="utf-8", errors="replace", check=True
+        )
+        return result.stdout
+    except subprocess.CalledProcessError:
+        return None
+
+def get_commit_info(commit_hash):
+    """Busca autor, data e mensagem do commit."""
+    cmd = ["git", "show", "-s", "--format=%an|%ad|%s", "--date=short", commit_hash]
+    try:
+        res = subprocess.run(cmd, capture_output=True, text=True, encoding="utf-8", errors="replace", check=True)
+        parts = res.stdout.strip().split('|', 2)
+        if len(parts) == 3:
+            return {"author": parts[0], "date": parts[1], "message": parts[2]}
+    except:
+        pass
+    return {"author": "Desconhecido", "date": "Desconhecida", "message": "Sem mensagem"}
+
+def analyze_commit_with_ai(commit_hash, file_path):
+    """Usa a IA para ler o diff e classificar como ORIGEM ou REFATORACAO."""
+    diff = execute_git_show(commit_hash, file_path)
+    if not diff:
+        return {"status": "ORIGEM", "motivo": "Diff não encontrado (arquivo possivelmente criado aqui)."}
+
+    provider = get_ai_provider()
+    api_key = get_api_key(provider)
+    if not api_key:
+        return {"status": "ORIGEM", "motivo": "Sem chave de API. Assumindo origem."}
+
+    # Usamos o modelo 'simple' (Flash/Lite) para economizar dinheiro no loop
+    api_model = get_api_model(provider, task_complexity="simple")
+
+    skill_path = os.path.join(os.getcwd(), ".gitpr.blame.md")
+    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. Analise o diff e determine se é a ORIGEM da regra (lógica nova) ou REFATORAÇÃO. Responda APENAS com JSON: {"status": "ORIGEM", "motivo": "Explique o que foi introduzido"} ou {"status": "REFATORACAO", "motivo": "Explique o que foi alterado"}'
+
+    prompt = (
+        f"Analise o diff do commit {commit_hash} e retorne o JSON solicitado.\n\n"
+        f"DIFF:\n{diff[:4000]}" # Limitamos a 4000 caracteres para não pesar a requisição
+    )
+
+    click.secho(f"  🤖 Consultando a IA ({api_model}) sobre o commit {commit_hash[:8]}...", fg="cyan", dim=True)
+    
+    result_json = call_ai_model(provider, api_key, api_model, prompt, sys_inst)
+    
+    if result_json and "status" in result_json:
+        return result_json
+        
+    return {"status": "ORIGEM", "motivo": "IA não retornou formato válido."}
+
+def run_blame_analysis(file_path, start_line, end_line):
+    """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})")
+    
+    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
+        
+    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()
+    
+    # LOOP DE COLETA DE DADOS
+    for base_commit in initial_commits:
+        current_commit = base_commit
+        depth = 0
+        max_depth = 4 # Trava de segurança para não rodar infinito em código legado
+        
+        while depth < max_depth:
+            # Se já analisamos este commit em outra trilha, não gasta requisição à toa
+            if current_commit in seen_hashes:
+                break
+                
+            seen_hashes.add(current_commit)
+            info = get_commit_info(current_commit)
+            ai_analysis = analyze_commit_with_ai(current_commit, file_path)
+            
+            status = str(ai_analysis.get("status", "ORIGEM")).upper()
+            motivo = str(ai_analysis.get("motivo", ""))
+            
+            master_timeline.append({
+                "hash": current_commit[:8],
+                "info": info,
+                "status": status,
+                "motivo": motivo,
+                "raw_date": info["date"] # Usado para ordenação
+            })
+            
+            if status == "ORIGEM":
+                break
+                
+            # É refatoração, vamos buscar o commit pai no passado
+            depth += 1
+            parent_hash = f"{current_commit}^"
+            parent_commits = execute_git_blame(file_path, start_line, end_line, parent_hash)
+            
+            if not parent_commits:
+                break
+            current_commit = parent_commits[0]
+            
+    # ORDENAÇÃO CRONOLÓGICA (Do mais antigo para o mais novo)
+    master_timeline.sort(key=lambda x: x["raw_date"])
+    
+    # EXIBIÇÃO VISUAL NO TERMINAL (ÚNICA)
+    click.secho(f"\n📜 Histórico Consolidado da Regra (Linhas {start_line}-{end_line}):", fg="magenta", bold=True)
+    
+    for item in master_timeline:
+        cor = "green" if item["status"] == "ORIGEM" else "yellow"
+        icone = "👶" if item["status"] == "ORIGEM" else "🔧"
+        
+        click.secho(f"\n[{item['info']['date']}] {icone} {item['status']}: Por {item['info']['author']} (Commit: {item['hash']})", fg=cor, bold=True)
+        click.echo(f"   └─ Mensagem: \"{item['info']['message']}\"")
+        if item["motivo"]:
+            click.secho(f"   └─ Análise IA: {item['motivo']}", fg="cyan", dim=True)
+            
+    click.echo("\n" + "-"*60 + "\n")
+    
+    # GERAÇÃO DO RELATÓRIO MARKDOWN (ÚNICO)
+    click.secho("📝 Gerando relatório Markdown unificado com o resumo da IA...", fg="cyan")
+    
+    branch_name = get_current_branch()
+    safe_branch_name = branch_name.replace("/", "-").replace("\\", "-")
+    current_time = datetime.now().strftime("%Y%m%d%H%M%S")
+    
+    pattern = os.getenv("OUTPUT_FILE_NAME_BLAME", "{branch}_{datetime}_BLAME_REPORT.md")
+    output_filename = pattern.format(branch=safe_branch_name, datetime=current_time)
+    
+    # Monta a Tabela Markdown
+    md_content = f"# Linha do tempo da regra investigada\n\n"
+    md_content += f"**Arquivo:** `{file_path}` (Linhas {start_line}-{end_line})\n\n"
+    md_content += "| Data | Commit | Autor | O quê |\n"
+    md_content += "|---|---|---|---|\n"
+    
+    for item in master_timeline:
+        data_fmt = item['info']['date']
+        hash_curto = item['hash']
+        autor = item['info']['author']
+        msg_commit = item['info']['message']
+        
+        # Pega a explicação da IA ou coloca um fallback seguro
+        explicacao_ia = item['motivo'] if item['motivo'] else "Alteração identificada na regra"
+        
+        # Junta a explicação da IA com a mensagem do commit (Estilo Tabela de Referência)
+        motivo_final = f"{explicacao_ia} — *\"{msg_commit}\"*"
+        
+        md_content += f"| {data_fmt} | `{hash_curto}` | {autor} | {motivo_final} |\n"        
+    
+    # IA gera o Resumo Analítico Final
+    summary_prompt = "Baseado na seguinte linha do tempo de commits de uma regra de negócio, escreva um único parágrafo resumindo a idade da regra, o autor original, o número de refatorações e deduza qual era a intenção original de negócio (o motivo real da regra existir no sistema).\n\n"
+    for item in master_timeline:
+        summary_prompt += f"[{item['info']['date']}] {item['info']['author']} ({item['hash']}) - {item['status']}: {item['motivo']}\n"
+
+    provider = get_ai_provider()
+    api_key = get_api_key(provider)
+    api_model = get_api_model(provider, task_complexity="advanced") 
+    sys_inst = "Você é um Arquiteto de Software. Gere APENAS um objeto JSON no formato {\"resumo\": \"texto do resumo\"}."
+
+    click.secho(f"  🤖 Consultando a IA ({api_model}) para o Resumo Executivo...", fg="cyan", dim=True)
+    summary_json = call_ai_model(provider, api_key, api_model, summary_prompt, sys_inst)
+    
+    resumo_texto = summary_json.get("resumo", "Resumo não disponível.") if summary_json else "Resumo não disponível."
+    
+    md_content += f"\n**Resumo:** {resumo_texto}\n"
+    
+    # Salva no disco
+    try:
+        with open(output_filename, "w", encoding="utf-8") as f:
+            f.write(md_content)
+        click.secho(f"✅ Relatório unificado salvo com sucesso: '{output_filename}'", fg="green", bold=True)
+    except Exception as e:
+        click.secho(f"❌ Erro ao salvar o relatório: {e}", fg="red")

{gitpr_cli-0.0.13 → gitpr_cli-0.0.15}/src/config.py

@@ -20,7 +20,9 @@ DEFAULT_CONFIG = {
     "OUTPUT_FILE_NAME": "{branch}_{datetime}_PR_DESC.md",
     "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_FILEREVIEW": "{branch}_{datetime}_FILE_REVIEW.txt",
+    "OUTPUT_FILE_NAME_BLAME": "{branch}_{datetime}_BLAME_REPORT.md",
+    "OUTPUT_FILE_NAME_ISSUE": "{branch}_{datetime}_ISSUE.md"
 }
 
 def get_ai_provider():
@@ -151,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.13 → 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"
 
@@ -188,6 +190,8 @@ def generate_skill_template():
         ".gitpr.review.md": "gitpr.review.md",
         ".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.13 → 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
@@ -45,8 +45,10 @@ def print_banner():
 @click.option('--hook', type=click.Path(), hidden=True, help="Caminho do arquivo de commit (uso interno dos hooks).")
 @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):
+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.
 
@@ -137,6 +139,85 @@ def cli(commit, review, fullreview, linter, skill, update, installhooks, hook, q
             click.echo("---\n")
         return
     
+    # Módulo Arqueólogo (--blame)
+    if blame:
+        # Parser para separar o arquivo das linhas
+        if ":" in blame:
+            # Modo Direto: gitpr --blame arquivo:10-20
+            file_path, lines = blame.split(":", 1)
+            try:
+                if "-" in lines:
+                    start_line, end_line = lines.split("-")
+                else:
+                    start_line = end_line = lines
+            except ValueError:
+                click.secho("❌ Formato de linhas inválido. Use inicio-fim (ex: 10-20).", fg="red")
+                return
+        else:
+            # Modo Interativo: gitpr --blame arquivo
+            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 ou apenas 45)")
+            
+            if "-" in lines_input:
+                start_line, end_line = lines_input.split("-")
+            else:
+                start_line = end_line = lines_input
+        
+        # Validação final do arquivo
+        if not os.path.exists(file_path):
+            click.secho(f"❌ O arquivo '{file_path}' não foi encontrado.", fg="red")
+            return
+            
+        # Aciona o motor
+        from src.blame_engine import run_blame_analysis
+        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.13 → 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.13"
+__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"