gitpr-cli 0.0.16__py3-none-any.whl → 0.0.17__py3-none-any.whl

{gitpr_cli-0.0.16.dist-info → gitpr_cli-0.0.17.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitpr-cli
-Version: 0.0.16
+Version: 0.0.17
 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
@@ -125,11 +125,12 @@ Você pode passar as seguintes *flags* para ações específicas:
 * `--provider <gemini|deepseek>`: Força a utilização de uma IA específica apenas para esta execução, ignorando o seu padrão guardado no `.env`.
 * `-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.
+* `-s` ou `--skill`: Cria os arquivos de template de contexto da IA (`.gitpr.commit.md`, `.gitpr.pr.md`, `.gitpr.review.md`, `.gitpr.filereview.md`, `.gitpr.issue.md`, `.gitpr.blame.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.
+* `-h` ou `--help`: Mostra a ajuda geral com todas as opções. Use em conjunto com outra flag para **ajuda contextual** (ex: `gitpr -h --issue`, `gitpr -h --linter`) com link direto para a documentação detalhada de cada funcionalidade.
 * `-u` ou `--update`: Verifica e instala a versão mais recente do GitPR (Auto-Updater).
 * `-h` ou `--help`: Exibe o menu de ajuda.
 
@@ -172,6 +173,8 @@ Em vez de esconder as instruções da IA no código fonte, o GitPR utiliza arqui
 * `.gitpr.pr.md`: Estrutura de tópicos exigida para a descrição do Pull Request.
 * `.gitpr.review.md`: Define o foco de arquitetura (ex: SOLID, Clean Code) para a análise de diffs.
 * `.gitpr.filereview.md`: Define regras rígidas de coesão e acoplamento para auditoria de um ficheiro completo (usado com `--input`).
+* `.gitpr.issue.md`: Define a estrutura e o nível de detalhe exigido para a geração de Issues padronizadas (usado com `--issue`).
+* `.gitpr.blame.md`: Define o foco da análise arqueológica para o rastreamento de código legado (usado com `--blame`).
 
 ## 📚 Documentação Técnica e Guias Avançados
 
@@ -179,10 +182,18 @@ Para manter este README conciso, detalhamos as implementações mais avançadas
 
 Se você deseja implementar o GitPR como uma barreira de qualidade automatizada na sua equipe, consulte os guias abaixo:
 
-* [**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.
+* [**Git Hooks Locais (Shift-Left)**](docs/git-hooks-locais.md): Como usar o `gitpr --installhooks` para criar travas na máquina do desenvolvedor e usar a IA para escrever mensagens de commit automaticamente.
+* [**Linter Estático Customizável**](docs/linter-regras-customizadas.md): Como criar regras de validação no `.gitpr.linter.yml` para CI/CD e hooks de pre-commit.
+* [**Geração de Issues e Interface TUI**](docs/issue-tui-help.md): Como utilizar a interface gráfica de terminal (TUI) e os 3 motores de contexto para gerir Issues estruturadas.
+* [**Code Review com IA**](docs/code-review-ia.md): Guia dos modos de revisão (`--review`, `--fullreview`) e auditoria de arquivo (`--input`).
+* [**Mensagens de Commit com IA**](docs/commit-message-ia.md): Como gerar mensagens no padrão Conventional Commits e integrar com Git Hooks.
+* [**Arqueólogo de Código (Git Blame)**](docs/blame-arqueologo.md): Como rastrear a origem de regras de negócio com `git blame` e IA.
+* [**Sistema de Skills e Templates**](docs/skill-template.md): Como customizar o comportamento da IA com arquivos `.gitpr.*.md`.
+* [**Auto-Updater**](docs/auto-update.md): Como funciona a atualização automática (hot-swap) do GitPR.
+* [**Provedores de IA**](docs/providers-ia.md): Configuração e seleção entre Google Gemini e DeepSeek.
+* [**Pull Request (Modo Padrão)**](docs/pr-descricao-padrao.md): Fluxo completo de geração de descrição de PR sem flags.
+* [**Integração com CI/CD (GitHub Actions)**](docs/github-ci-linter.md): Como rodar o GitPR no pipeline para travar o "Merge" de PRs com violações.
+* [**Integração e Segurança do Token GitHub (PAT)**](docs/github-pat-integration.md): Entenda como o GitPR gera issues diretamente no repositório de forma autenticada.
 
 ## ⚡ Sistema de Cache Local (Economia de Quota)
 

{gitpr_cli-0.0.16.dist-info → gitpr_cli-0.0.17.dist-info}/RECORD

@@ -1,18 +1,18 @@
-gitpr_cli-0.0.16.dist-info/licenses/LICENSE,sha256=UQzLC6mwqb-ZNDkBBAqOxC-SMQcEID0gaM6oFcu6u48,27030
+gitpr_cli-0.0.17.dist-info/licenses/LICENSE,sha256=UQzLC6mwqb-ZNDkBBAqOxC-SMQcEID0gaM6oFcu6u48,27030
 src/__init__.py,sha256=U6ksarernNcryHO20aj4rNG7w0thT7xdMs5KzBJyPvE,28
 src/ai_providers.py,sha256=P6675oqJePikR_jwaxWboBr6nj9l3ri5HqVUZ7nNpw8,2680
 src/blame_engine.py,sha256=lLPuuOZSPdJOhKrj00Wko0-i7wzKwngkpPkiSL0nMho,10321
-src/cache.py,sha256=tHhQ0AqqjEzyVz44JDCu0zaKOBVZRrZa1er27ZbB4w4,3070
+src/cache.py,sha256=oIu4iVlqVCHmUdSjvuznbkzpxwcBrUG3Hm2uQ2GxIZs,3072
 src/config.py,sha256=BXgHArYWuuaB2GL7NynOuKtEq4kOuTUwApOcy-ApsqM,6775
 src/core.py,sha256=OqiWX63Ss4UNa_82wJYfUB88aTqX5wgh2E3io2ZbyCc,15531
 src/issue_engine.py,sha256=-cDkW7Dxo48kN_aWwGKSymVE-6nJ2bCHZW7GpM3wC00,3637
 src/linter_engine.py,sha256=ppyMje4qQCf9fMRhWOTxsfKvUBcjNoniu7v20kZ0034,4494
-src/main.py,sha256=TGvNHxJ5PTI8rwztUsMNbQgGOQByXXq2GJ3nt0Rldec,19743
+src/main.py,sha256=7bTMdu27EIgq6WUBsC5H26dlejFqSjAz9cQJN7ngjfE,28718
 src/security.py,sha256=_OKBz_R-3xM8-5XNl_dOUyPCQi6jWDeLoOykZvN1Cys,1355
 src/tui_issue.py,sha256=Aiy82hUdz8cs9lnKsxm_bT-GQ-8WDm0VtPdxOoKeOWk,1638
-src/updater.py,sha256=C_m9-1UlmOhEI6Wr-F_uF8pL-5Ujpw8E8eVZpVrrS_A,7024
-gitpr_cli-0.0.16.dist-info/METADATA,sha256=ln1aGxxMa3nb-RhZ5Zzir11zsbwLU49ycBkECfEj08A,14247
-gitpr_cli-0.0.16.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-gitpr_cli-0.0.16.dist-info/entry_points.txt,sha256=mh_4F_idM4cj0XhfRGBDQb5Nnku93YJ-dyKh5SufwlE,39
-gitpr_cli-0.0.16.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
-gitpr_cli-0.0.16.dist-info/RECORD,,
+src/updater.py,sha256=O5hq-8c57FEelDvf87T50AFu_TgwQZFpfSvCuHzUtbU,7024
+gitpr_cli-0.0.17.dist-info/METADATA,sha256=c-2tdkPnmH2xo88E1udiUmOL71VqeKhqT3sRLirgG74,15640
+gitpr_cli-0.0.17.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+gitpr_cli-0.0.17.dist-info/entry_points.txt,sha256=mh_4F_idM4cj0XhfRGBDQb5Nnku93YJ-dyKh5SufwlE,39
+gitpr_cli-0.0.17.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
+gitpr_cli-0.0.17.dist-info/RECORD,,

src/cache.py

@@ -3,8 +3,6 @@ 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/"""
     path = Path.home() / ".gitpr" / "cache" / "prompts"
@@ -35,6 +33,7 @@ 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"
+    from src.core import get_current_branch
     current_branch = get_current_branch()
     
     cache_data = {

src/main.py

@@ -20,22 +20,158 @@ from src.linter_engine import parse_diff_and_lint
 
 def print_banner():
     """Exibe a assinatura ASCII Art do projeto"""
-    banner = """
- ,----.   ,--.  ,--.  ,------. ,------.  
-'  .-./   `--',-'  '-.|  .--. '|  .--. ' 
-|  | .---.,--.'-.  .-'|  '--' ||  '--'.' 
-'  '--'  ||  |  |  |  |  | --' |  |\  \  
- `------' `--'  `--'  `--'     `--' '--' 
-                                         
+    banner = r"""
+ ,----.   ,--.  ,--.  ,------. ,------.
+'  .-./   `--',-'  '-.|  .--. '|  .--. '
+|  | .---.,--.'-.  .-'|  '--' ||  '--'.'
+'  '--'  ||  |  |  |  |  | --' |  |\  \
+ `------' `--'  `--'  `--'     `--' '--'
+
 """
     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 | -is,--issue | -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,--help (use -h --flag para ajuda contextual)\n", fg="white", dim=True)
+
+
+# ============================================================
+# Mapeamento de ajuda contextual (flag -> doc URL e descricao)
+# ============================================================
+HELP_MAP: dict[str, dict[str, str]] = {
+    'commit': {
+        'url': 'https://github.com/natanfiuza/gitpr/blob/main/docs/commit-message-ia.md',
+        'title': 'Geracao de Mensagens de Commit com IA',
+        'description': (
+            'Gera automaticamente mensagens de commit no formato Conventional '
+            'Commits usando inteligencia artificial. Suporta integracao com Git '
+            'Hooks (prepare-commit-msg) para injecao direta no editor.'
+        ),
+    },
+    'review': {
+        'url': 'https://github.com/natanfiuza/gitpr/blob/main/docs/code-review-ia.md',
+        'title': 'Code Review com IA (Alteracoes Locais)',
+        'description': (
+            'Realiza uma revisao de codigo inteligente das alteracoes locais '
+            'nao commitadas (git diff HEAD). Integra automaticamente o Linter '
+            'Estatico (.gitpr.linter.yml) no topo do relatorio.'
+        ),
+    },
+    'fullreview': {
+        'url': 'https://github.com/natanfiuza/gitpr/blob/main/docs/code-review-ia.md',
+        'title': 'Code Review Completo com IA (Full Diff)',
+        'description': (
+            'Realiza uma revisao profunda comparando toda a branch atual com '
+            'a branch principal remota (origin/main). Faz git fetch antes da '
+            'analise. Ideal para revisar antes de abrir um Pull Request.'
+        ),
+    },
+    'input': {
+        'url': 'https://github.com/natanfiuza/gitpr/blob/main/docs/code-review-ia.md',
+        'title': 'Analise de Arquivo Especifico (--input)',
+        'description': (
+            'Analisa um arquivo inteiro do sistema local, ignorando o diff do '
+            'Git. REQUER --review (-r) ou --fullreview (-f) para funcionar. '
+            'Excelente para auditoria de codigo legado e refatoracoes.'
+        ),
+    },
+    'linter': {
+        'url': 'https://github.com/natanfiuza/gitpr/blob/main/docs/linter-regras-customizadas.md',
+        'title': 'Linter Estatico Customizavel',
+        'description': (
+            'Motor de analise estatica local que verifica regras definidas no '
+            'arquivo .gitpr.linter.yml. Nao consome cotas de IA nem requer '
+            'internet. Ideal para CI/CD e hooks de pre-commit.'
+        ),
+    },
+    'skill': {
+        'url': 'https://github.com/natanfiuza/gitpr/blob/main/docs/skill-template.md',
+        'title': 'Sistema de Skills e Templates (--skill)',
+        'description': (
+            'Faz download dos arquivos de template (.gitpr.*.md e .gitpr.linter.yml) '
+            'do repositorio oficial para a raiz do projeto. Estes arquivos permitem '
+            'customizar o comportamento da IA conforme as regras da sua equipa.'
+            'NUNCA sobrescreve arquivos locais existentes.'
+        ),
+    },
+    'update': {
+        'url': 'https://github.com/natanfiuza/gitpr/blob/main/docs/auto-update.md',
+        'title': 'Auto-Update do GitPR',
+        'description': (
+            'Verifica e instala automaticamente a versao mais recente do GitPR. '
+            'Suporta atualizacao via pip (PyPI) e binario standalone (GitHub Releases) '
+            'com hot-swap e rollback automatico em caso de falha.'
+        ),
+    },
+    'installhooks': {
+        'url': 'https://github.com/natanfiuza/gitpr/blob/main/docs/git-hooks-locais.md',
+        'title': 'Instalacao de Git Hooks Locais',
+        'description': (
+            'Instala hooks de pre-commit (linter estatico automatico) e '
+            'prepare-commit-msg (geracao de mensagens com IA) no repositorio '
+            'local. Adota a pratica de Shift Left para validacao antes do push.'
+        ),
+    },
+    'blame': {
+        'url': 'https://github.com/natanfiuza/gitpr/blob/main/docs/blame-arqueologo.md',
+        'title': 'Arqueologo de Codigo (Git Blame com IA)',
+        'description': (
+            'Rastreia a origem e evolucao de regras de negocio no codigo usando '
+            'git blame com classificacao por IA (ORIGEM vs REFATORACAO). Suporta '
+            'modo direto (arquivo:10-20) e modo interativo. Pode alimentar o '
+            'contexto de Issues de divida tecnica com --issue.'
+        ),
+    },
+    'issue': {
+        'url': 'https://github.com/natanfiuza/gitpr/blob/main/docs/issue-tui-help.md',
+        'title': 'Geracao de Issues com TUI Interativa',
+        'description': (
+            'Gera issues padronizadas (O Que / Por Que / Onde / Como) usando IA '
+            'e abre uma interface interativa no terminal (Textual) para revisao. '
+            'Possui 3 motores de contexto: diff atual, historico da branch (--history) '
+            'e arqueologia de codigo (--blame). Permite salvar .md local ou publicar '
+            'diretamente no GitHub via API.'
+        ),
+    },
+    'history': {
+        'url': 'https://github.com/natanfiuza/gitpr/blob/main/docs/issue-tui-help.md',
+        'title': 'Contexto de Historico para Issues (--history)',
+        'description': (
+            'Modificador do --issue (-is): usa todo o historico da branch atual '
+            '(git log + cache de PRs anteriores) como contexto para gerar a issue. '
+            'Ideal para documentar epicos, releases e features grandes com '
+            'varios commits ao longo de dias.'
+        ),
+    },
+    'provider': {
+        'url': 'https://github.com/natanfiuza/gitpr/blob/main/docs/providers-ia.md',
+        'title': 'Selecao de Provedor de IA (--provider)',
+        'description': (
+            'Forca o uso de um provedor de IA especifico para esta execucao: '
+            'gemini (Google Gemini) ou deepseek (DeepSeek). Sobrescreve '
+            'temporariamente o provider padrao definido no ficheiro .env.'
+        ),
+    },
+}
+
+# Prioridade para help contextual quando multiplas flags sao usadas com -h
+# Menor valor = maior prioridade
+HELP_PRIORITY: dict[str, int] = {
+    'linter': 1,
+    'skill': 2,
+    'update': 3,
+    'installhooks': 4,
+    'issue': 5,
+    'blame': 6,
+    'commit': 7,
+    'fullreview': 8,
+    'review': 9,
+    'input': 10,
+    'history': 11,
+    'provider': 12,
+}
 
 
 # Configuração nativa do Click para aceitar -h além de --help
 @click.command()
-@click.help_option('-h', '--help', help='Mostra esta mensagem e sai.')
 @click.option('-c', '--commit', is_flag=True, help="Gera apenas a mensagem de commit e exibe no console.")
 @click.option('-r', '--review', is_flag=True, help="Faz um code review das alterações locais (git diff).")
 @click.option('-f', '--fullreview', is_flag=True, help="Faz um code review de todas as alterações desde a branch principal (origin/main).")
@@ -45,18 +181,75 @@ def print_banner():
 @click.option('-ih', '--installhooks', is_flag=True, help="Instala automaticamente os Git Hooks de validação no projeto.")
 @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('-i', '--input', type=click.Path(), 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,history, issue):
+@click.option('-h', '--help', 'help_flag', is_flag=True, help="Mostra esta mensagem e sai. Use com outra flag para ajuda contextual (ex: -h --issue).")
+def cli(commit, review, fullreview, linter, skill, update, installhooks, hook, quiet, provider, input, blame, history, issue, help_flag):
     """
     GitPR CLI - Automação de PRs e Code Review com IA.
 
     COMPORTAMENTO PADRÃO (Sem opções):
     Faz o fetch, compara com a branch principal remota e gera um arquivo Markdown (.md) com a descrição completa para o Pull Request.
     """
+
+    # ============================================================
+    # MANIPULADOR DE AJUDA CONTEXTUAL
+    # ============================================================
+    if help_flag:
+        # Identifica quais outras flags estao ativas (excluindo hidden: hook, quiet)
+        active_flags: list[str] = []
+        for param_name, help_info in HELP_MAP.items():
+            value = locals().get(param_name)
+            # Trata tanto flags booleanas (True) quanto parametros string (blame, input, provider)
+            if value:
+                active_flags.append(param_name)
+
+        if not active_flags:
+            # gitpr -h puro (sem outras flags): mostra help padrao do Click
+            ctx = click.get_current_context()
+            click.echo(ctx.get_help())
+            ctx.exit()
+
+        # Ordena por prioridade e seleciona a flag mais especifica
+        active_flags.sort(key=lambda f: HELP_PRIORITY.get(f, 99))
+        primary_flag = active_flags[0]
+        help_info = HELP_MAP.get(primary_flag)
+
+        if help_info:
+            click.secho(f"\n{'=' * 60}", bold=True)
+            click.secho(f"  {help_info['title']}", fg="cyan", bold=True)
+            click.secho(f"{'=' * 60}\n", bold=True)
+            click.echo(help_info['description'])
+            click.echo("")
+            click.secho(">> Documentacao completa:", fg="green")
+            click.secho(f"  {help_info['url']}", fg="blue", underline=True)
+            click.echo("")
+
+            if len(active_flags) > 1:
+                click.secho(
+                    ">> Dica: Para ajuda sobre uma unica opcao, "
+                    "use -h apenas com ela.",
+                    fg="yellow", dim=True,
+                )
+
+            # Exibe a URL da documentacao principal do GitPR como rodape
+            click.secho(
+                ">> Repositorio: https://github.com/natanfiuza/gitpr",
+                fg="bright_black",
+            )
+            click.echo("")
+        else:
+            # Fallback: mostra help padrao (nao deveria acontecer)
+            ctx = click.get_current_context()
+            click.echo(ctx.get_help())
+
+        # Garante saida limpa apos exibir ajuda contextual
+        ctx = click.get_current_context()
+        ctx.exit()
+
     # Silencia o banner se estiver no modo quiet ou via hook
     if not quiet and not hook:
         print_banner()
@@ -129,7 +322,7 @@ def cli(commit, review, fullreview, linter, skill, update, installhooks, hook, q
             click.echo("O Linter será agora executado automaticamente antes de cada commit.")
             
             click.echo("\n---")
-            click.echo("📚 Guias de Utilização:")
+            click.echo(">> Guias de Utilização:")
             
             # Link da documentação geral de Hooks
             click.echo("• Como utilizar Git Hooks:")
@@ -162,7 +355,7 @@ def cli(commit, review, fullreview, linter, skill, update, installhooks, hook, q
                 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)
+            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:
@@ -213,7 +406,7 @@ def cli(commit, review, fullreview, linter, skill, update, installhooks, hook, q
                 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)
+                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)
                     
@@ -274,10 +467,18 @@ def cli(commit, review, fullreview, linter, skill, update, installhooks, hook, q
             
         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)
-        return
+    # Validação do Modo Input (com guard para nao atrapalhar o -h contextual)
+    if input and not help_flag:
+        if not os.path.exists(input):
+            click.secho(
+                f"\n❌ Erro: O arquivo '{input}' nao foi encontrado.",
+                fg="red", bold=True,
+            )
+            return
+
+        if 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)
+            return
     
     # Garante que o ambiente e as chaves estão configurados
     setup_environment()
@@ -349,7 +550,7 @@ def cli(commit, review, fullreview, linter, skill, update, installhooks, hook, q
                 click.secho(f"❌ Erro ao injetar no hook: {e}", fg="red")
         else:
             # MODO CONSOLE: O comportamento original que já existia
-            click.secho("\n💡 Dica: Use sem --commit para gerar o PR completo.\n", fg="yellow")
+            click.secho("\n>> Dica: Use sem --commit para gerar o PR completo.\n", fg="yellow")
             click.secho("\n📝 Sugestão de Commit:\n", fg="green", bold=True)
             click.echo(msg)
             click.echo("\n")

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.16"
+__version__ = "0.0.17"
 GITHUB_API_URL = "https://api.github.com/repos/natanfiuza/gitpr/releases/latest"
 PYPI_API_URL = "https://pypi.org/pypi/gitpr-cli/json"