Guia de Configuracao do vdiff

Arquivos de config

O vdiff usa dois arquivos de configuração. Local sobrescreve global.

Schema de config

{
  "llm": {
    "provider": "anthropic",
    "apiKey": "sk-ant-...",
    "model": "claude-haiku-4-5",
    "highModel": "claude-sonnet-4-6"
  },
  "analysis": {
    "contextThreshold": 1.0,
    "graphPath": "graphify-out/graph.json",
    "maxGraphContextChars": 8192
  },
  "review": {
    "historyLimit": 10
  }
}

Configurações LLM

Configurações de análise

Configurações de revisão

Regras customizadas

Crie regras específicas do projeto em .vdiff/rules/ como arquivos .md ou .txt. Elas são carregadas em ordem alfabética e injetadas no passo de análise de risco.

mkdir -p .vdiff/rules

Exemplo .vdiff/rules/billing.md:

- Qualquer mudança em src/billing/ deve incluir um arquivo de migração.
- Nunca remover middleware de rate limiting de endpoints de pagamento.
- Sinalizar qualquer valor de preço ou moeda hardcoded.

Diretivas de skip

Arquivos de regras podem conter diretivas de skip para suprimir permanentemente categorias específicas ou seções da saída:

skip: test_integrity
skip: missing_evidence

Grafo de conhecimento

O grafo de conhecimento fornece contexto de dependências cross-file. Ele é construído com o Graphify, uma ferramenta Python separada.

# Instalar graphify (requer Python 3.10+)
pip install graphifyy

# Construir o grafo
vdiff graph init

# Verificar status
vdiff graph status

Uma vez construído, o contexto do grafo é automaticamente incluído nas análises. O grafo é armazenado em graphify-out/graph.json por padrão.

Sobrescreva o caminho com analysis.graphPath na config ou --graph em tempo de execução. Pule com --no-graph.

O vdiff avisa no rodapé quando o grafo está 20+ commits atrás do HEAD.

Dados locais

Todos os dados ficam na sua máquina. Nenhum conteúdo de código, caminhos de arquivo ou informações pessoais são coletados. Chamadas de API LLM usam sua própria chave diretamente com o provedor.