Caveman Commit

Extensão do VS Code que gera a mensagem de commit em português brasileiro usando Codex CLI ou Claude Code CLI, copia para a área de transferência e nunca executa o commit.

feat(usuarios): adicionar filtro por secretaria

O que faz

• Analisa todas as alterações ou somente staged, conforme o escopo escolhido.
• Copia automaticamente a mensagem individual quando o diff continua atualizado.
• Preview com edição, regeneração, cópia e preenchimento do campo de commit no Git.
• Interface discreta, inspirada no ChatGPT para Windows, acompanha o tema do VS Code.
• Resposta vazia ou fora do formato: até 8 retentativas após a chamada inicial, usando o motivo da rejeição e a resposta anterior para corrigir o formato. Se a nona resposta também for inválida, encerra com erro e o último motivo. Timeout: refaz até duas vezes, dobrando o prazo até 600 segundos por tentativa. Cancelamento, falhas do CLI e esgotamento das retentativas interrompem a geração.

As instruções e a skill empacotada usam texto compacto, preservando as regras de idioma, formato e fidelidade ao diff. O diff continua integral. Limites de rejeição e timeout são separados: no máximo 9 respostas rejeitadas e 2 retentativas de timeout, totalizando até 11 chamadas à IA no pior caso.

O que não faz

• Não executa git add, commit, push, reset nem checkout.
• Não altera o index.
• Não armazena nem solicita API key.

Quick start

Pré-requisitos:

• VS Code 1.94 ou superior
• Git no PATH
• Codex CLI ou Claude Code CLI instalado no PATH, ou extensão correspondente (openai.chatgpt / anthropic.claude-code) com executável embutido compatível. A autenticação do provider continua necessária.

Passos:

1. Faça as alterações; git add não é necessário.
2. Clique em Caveman Commit na Status Bar.
3. Aguarde a geração: a mensagem individual atualizada já estará na área de transferência.
4. Revise o preview; edite, regenere ou selecione Usar no Git.
5. Faça o commit quando decidir, pelo fluxo Git de sua preferência.

Um novo clique durante a execução cancela o fluxo atual e inicia outra geração. Notificações abertas não bloqueiam novos cliques na barra de status.

A extensão procura primeiro o CLI no PATH. Se ausente, usa o executável embutido na extensão correspondente, sem abrir seu painel, terminal ou console. O diretório é consultado novamente a cada geração para acompanhar atualizações. Somente o login, quando necessário, abre terminal integrado e navegador. Falhas de autenticação ou geração não provocam troca automática de instalação. Layouts internos desconhecidos ou incompatíveis produzem orientação para instalar o CLI separado. Em SSH/containers, o executável precisa estar disponível no host onde a Caveman Commit está executando.

Se a sessão do Claude estiver ausente ou expirada, a extensão abre automaticamente um terminal integrado executando claude auth login. Conclua a autenticação no navegador e clique novamente em Caveman Commit. Também é possível abrir o login pela Command Palette (Caveman Commit: Login Claude Code) ou pelo hover da barra.

Instalação

npm install
npm run package

npm run package executa vsce package --allow-missing-repository e gera um .vsix na raiz. Instale-o pelo VS Code (Extensions: Install from VSIX...). Nenhuma publicação é feita automaticamente.

Comandos

Configurações são gravadas no workspace quando ele existe; caso contrário, globalmente.

Modelos padrão

Não há fallback automático: modelo indisponível produz erro explícito.

Configuração

{
  "cavemanCommit.provider": "codex",
  "cavemanCommit.diffScope": "all",
  "cavemanCommit.model": "",
  "cavemanCommit.reasoningEffort": "medium",
  "cavemanCommit.skillPath": "skills/caveman-commit/SKILL.md",
  "cavemanCommit.timeout": 120000,
  "cavemanCommit.maxDiffSize": 500000
}

Ao trocar de provider, a extensão limpa o override de modelo para impedir que um identificador do provider anterior seja reutilizado.

Vários repositórios no workspace

• Somente repositórios com alterações são processados.
• Um repositório alterado: preview da mensagem, com edição e regeneração.
• Dois ou mais: editor com cópia, Usar no Git e regeneração por repositório. Copiar ou preencher o Git confirma o resultado no próprio editor, que permanece aberto.
• O botão Caveman Commit no cabeçalho do Source Control gera somente para o repositório daquele painel. Sem contexto inequívoco, permite escolher o repositório.

Diff atualizado e mensagens reutilizadas

O preview mostra o escopo enviado. staged considera a versão no index, inclusive em arquivos parcialmente staged; all mantém o comportamento de analisar as alterações locais, incluindo arquivos novos não ignorados. Escopo vazio avisa e não chama a IA. Funciona também antes do primeiro commit.

Regenerar relê diff, configurações e conteúdo da skill, sempre chama a IA e só substitui o resultado anterior após sucesso. Também funciona em cada repositório do editor múltiplo. Falhas e cancelamentos preservam a mensagem anterior.

Cada resultado registra repositório, escopo e hash do diff enviado. A extensão relê esse diff após gerar e antes de copiar ou preencher o Git. Se houver mudanças, preserva o texto e mostra um aviso: regenere ou escolha explicitamente copiar/usar a mensagem anterior. Resposta desatualizada não é copiada automaticamente.

Até 20 resultados ficam em cache na memória da sessão. Um clique normal reutiliza mensagem válida para o mesmo repositório, escopo, diff, provider, modelo, effort e conteúdo da skill, indicando Mensagem reutilizada. Resultados mais recentemente usados são mantidos; recarregar/fechar a extensão limpa o cache. Edições válidas copiadas ou aplicadas ao Git atualizam a entrada quando o diff continua correspondente. Mensagens desatualizadas não são gravadas no cache.

Usar no Git

Usar no Git preenche apenas o campo de commit do repositório exato pela API da extensão nativa vscode.git. Texto vazio ou idêntico dispensa confirmação; texto diferente exige Substituir ou Cancelar. Se o campo mudar durante a confirmação, a operação é interrompida para preservar a nova edição.

Após sucesso, o Source Control é revelado. Preview/editor individual fecha; editor múltiplo permanece aberto com confirmação por repositório. Erros mantêm o painel e seu texto. Com Git nativo indisponível, a ação fica desabilitada com explicação; geração e cópia continuam funcionando. Nenhum stage, commit ou push é executado.

Segurança

• Processos recebem argumentos separados, sem shell: true.
• Prompt e diff entram por stdin; o projeto é fornecido à IA somente pelo diff.
• Nenhum comando Git mutável é executado.
• Codex roda com sandbox read-only, sessão efêmera e configuração ignorada.
• Claude roda sem ferramentas, sem persistência de sessão e em safe mode.
• Providers executam em diretório isolado da extensão.
• No Windows, shims npm como codex.cmd e claude.cmd são resolvidos para o entrypoint Node.js correspondente sem ativar shell intermediário.

Troubleshooting

Abra Output → Caveman Commit para ver provider, modelo, repositório, tamanho do diff, origem/versão do executável, duração e exit code. O diff completo nunca aparece nos logs.

Desenvolvimento

npm install
npm run check

npm run build:icons regenera SVGs, PNGs e a fonte da barra de status a partir de media/status-icon.svg.

npm run check roda typecheck, lint, testes e build. Pressione F5 no VS Code para abrir o Extension Development Host.