airev 1.7.0
CLI tool for AI-powered code review with context backtracking
License: MIT
Requires Python: >=3.10
Keywords: code-review, ai, cli, git, security

# airev

CLI para revisão de código automatizada com IA. Analisa diffs de branches Git e identifica problemas de segurança, performance, bugs e vazamentos de recursos.

## Funcionalidades

- **Análise de diff inteligente**: Compara sua branch com a branch base e analisa apenas o código modificado
- **Context backtracking**: Identifica automaticamente funções que chamam ou são chamadas pelo código modificado
- **Múltiplos runners de IA**: Suporte a Gemini CLI e GitHub Copilot CLI
- **Output estruturado**: Resultados em terminal colorido ou JSON para integração com CI/CD
- **Internacionalização**: Suporte a português (pt-br) e inglês (en)
- **Categorização de findings**: Severidade (CRITICAL, WARNING, INFO) e categoria (security, performance, bug, resource-leak)

## Instalação

### Requisitos

- Python 3.10+
- Git
- Um CLI de IA instalado:
  - [Gemini CLI](https://github.com/google-gemini/gemini-cli) (padrão)
  - [GitHub Copilot CLI](https://github.com/github/copilot-cli)

### Via pipx (Recomendado)

```bash
# Instala o pipx se ainda não tiver
pip install pipx
pipx ensurepath

# Instala o airev
pipx install airev
```

### Via pip

```bash
pip install airev
```

### Desenvolvimento local

```bash
# Clone o repositório
git clone https://github.com/tarcisiojr/airev.git
cd airev

# Instala em modo desenvolvimento
pip install -e ".[dev]"
```

## Atualização

O airev verifica automaticamente por novas versões e notifica quando há atualizações disponíveis.

```bash
# Atualiza para a versão mais recente
airev upgrade

# Ou manualmente
pipx upgrade airev
# ou
pip install --upgrade airev
```

Para desabilitar a verificação automática:
```bash
export AIREV_NO_UPDATE_CHECK=1
```

## Uso

### Comando básico

```bash
# Analisa a branch atual contra main
airev review --base main

# Analisa contra develop usando Copilot
airev review --base develop --runner copilot

# Output em JSON para CI/CD
airev review --base main --json-output

# Modo silencioso (sem animações)
airev review --base main --no-progress

# Em inglês
airev review --base main --lang en
```

### Opções do comando `review`

| Opção | Descrição |
|-------|-----------|
| `--base`, `-b` | Branch base para comparação (obrigatório) |
| `--runner`, `-r` | Runner de IA: `gemini` (padrão) ou `copilot` |
| `--json-output`, `-j` | Retorna resultado em JSON |
| `--workdir`, `-w` | Diretório do repositório (padrão: atual) |
| `--no-progress` | Desabilita animações (modo CI) |
| `--progress` | Força animações mesmo em CI |
| `--lang`, `-l` | Idioma: `pt-br` (padrão) ou `en` |

### Listar runners disponíveis

```bash
airev runners
```

## Runners de IA

### Gemini CLI (padrão)

Instale o Gemini CLI:

```bash
npm install -g @anthropic/gemini-cli
# ou
brew install gemini-cli
```

### GitHub Copilot CLI

Instale o Copilot CLI standalone:

```bash
npm install -g @github/copilot-cli
# ou
brew install github/gh/copilot-cli
# ou
winget install GitHub.CopilotCLI
```

## Output

### Terminal

O output no terminal inclui:

- Lista de arquivos modificados com estatísticas de linhas
- Dependências identificadas (callers/callees)
- Findings categorizados por severidade com cores
- Resumo final com contagem por tipo

### JSON

Com `--json-output`, o resultado segue a estrutura:

```json
{
  "branch": "feature/x",
  "base": "main",
  "files_analyzed": 5,
  "findings": [
    {
      "file": "src/auth.py",
      "line": 42,
      "severity": "CRITICAL",
      "category": "security",
      "title": "SQL Injection",
      "description": "Query concatenada sem sanitização",
      "suggestion": "Use prepared statements"
    }
  ],
  "summary": {
    "total": 3,
    "critical": 1,
    "warning": 2,
    "info": 0
  }
}
```

## Integração com CI/CD

### GitHub Actions

```yaml
- name: Code Review
  run: |
    pip install airev
    airev review --base main --no-progress --json-output > review.json

- name: Check Critical Findings
  run: |
    CRITICAL=$(jq '.summary.critical' review.json)
    if [ "$CRITICAL" -gt 0 ]; then
      echo "Found $CRITICAL critical issues!"
      exit 1
    fi
```

## Desenvolvimento

### Executar testes

```bash
pytest
```

### Executar com cobertura

```bash
pytest --cov=code_reviewer
```

### Verificar código

```bash
python -m py_compile src/code_reviewer/*.py
```

## Arquitetura

```
src/code_reviewer/
├── cli.py              # Entry point e comandos Click
├── diff_parser.py      # Parser de git diff
├── context_builder.py  # Backtracking de dependências
├── prompt_builder.py   # Construção do prompt para IA
├── response_parser.py  # Parser da resposta da IA
├── models.py           # Modelos Pydantic
├── formatters/
│   ├── terminal.py     # Formatação colorida com rich
│   └── progress.py     # Reporter de progresso
├── runners/
│   ├── base.py         # Interface AIRunner
│   ├── gemini.py       # Runner Gemini CLI
│   └── copilot.py      # Runner Copilot CLI
├── i18n/               # Sistema de internacionalização
├── locales/            # Arquivos de tradução (YAML)
└── prompts/            # Templates de prompt
```

## Licença

MIT