Gemini CLI Integration Test Suite

Given: gemini-cli com Vectora instalado e disponível
When: CLI iniciada
Then:
  - Detecta Vectora no PATH
  - Conecta via MCP (STDIO)
  - Estado: "ready"
  - Timeout de conexão < 5s

Given: Vectora não está disponível
When: CLI iniciada
Then:
  - Continua funcionando
  - Avisa user: "Vectora não está disponível"
  - Oferece usar funcionalidades base
  - Comportamento graceful degradation

Given: CLI pronta para conectar
When: MCP handshake iniciado
Then:
  - Initialize request enviado
  - Server info recebido
  - Tools listadas
  - Conectado em < 2s

Given: MCP conectado
When: CLI descobre tools
Then: Lista inclui:
  - search_context
  - search_tests
  - find_similar_code
  - analyze_dependencies
  - get_file_structure
  - Todas com schemas corretos

Given: User pergunta: "Como encontrar todas as chamadas para getUserById?"
When: CLI processa query
Then:
  - Reconhece como code-related
  - Chama Vectora com query apropriada
  - Mapeia para tool: analyze_dependencies
  - Executa: vectora.analyze_dependencies({symbol: "getUserById"})
  - Retorna results em < 1s

Given: User pergunta: "Como fazer um bolo de chocolate?"
When: CLI processa query
Then:
  - Reconhece como não code-related
  - NÃO chama Vectora
  - Responde diretamente com conhecimento Gemini
  - Sem menção desnecessária a Vectora

Given: User pergunta: "Qual é a melhor forma de autenticar?"
When: CLI processa query
Then: Oferece opções:
  Option A: "Quer buscar exemplos no seu codebase?" (com Vectora)
  Option B: "Ou explicar padrões genéricos?" (sem Vectora)

Given: Conversation com histórico
And: User: "Qual é o bug aqui?" (referenciando código anterior)
When: CLI processa
Then:
  - Entende contexto da conversa
  - Usa Vectora para procurar código similar
  - Conecta findings ao contexto anterior

Given: Query: "Como fazer error handling em Go?"
When: CLI processa
Then:
  - Pode ir para Vectora (buscar no codebase)
  - Pode responder diretamente (padrão genérico)
  - Ou combinar (responda padrão + exemplos do codebase)
  - Todos os caminhos são válidos

Given: Query mapeada para search_context
When: Tool invocado com:
  {query: "authentication handler", top_k: 5}
Then:
  - Vectora processa
  - Resultados retornados
  - CLI formata como resposta natural
  - Usuário vê: "Found 3 authentication handlers in your code..."

Given: Query mapeada para analyze_dependencies
When: Tool invocado com:
  {symbol: "processPayment"}
Then:
  - Dependências mapeadas
  - Grafo de chamadas retornado
  - CLI visualiza como texto/diagrama
  - Risco de circular dependencies alertado

Given: Tool invocado com dados inválidos
When: Error retornado de Vectora
Then:
  - CLI recebe erro
  - Mostra mensagem clara ao user
  - Sugere como refinar query
  - Continua conversa sem crash

Given: Tool retorna 1000+ resultados
When: Processado
Then:
  - Pagina resultados
  - User vê top 10 por padrão
  - Opção para ver mais
  - Performance não degrada

Given: Tool demora > 10s
When: Processado
Then:
  - Timeout acionado após 10s
  - User avisado: "Query está demorando"
  - Oferta para cancelar
  - Se cancelado, sem crash

Given: User: "Qual é a função getCachedUser?"
And: CLI busca com Vectora
And: Retorna: "In auth/cache.ts, linha 42"
When: User: "Qual é o bug nela?"
Then:
  - Contexto da conversa mantido
  - CLI sabe qual função é "nela"
  - Proxima busca em Vectora é para essa função

Given: 5-step investigation usando Vectora
When: Cada passo completado
Then:
  - Contexto preservado entre steps
  - Findings acumulam
  - Diagrama mental construído
  - Final summary conecta todos steps

Given: Primeira query retorna muitos resultados
When: User: "Mais específico, apenas TypeScript"
Then:
  - Novo parâmetro aplicado
  - Mesma estrutura de conversa mantida
  - Resultados refinados

Given: Tool retorna dados estruturados:
  [{file: "auth/jwt.ts", line: 42, score: 0.95}]
When: Formatado para user
Then: Exibido como:
  "Found JWT validation in auth/jwt.ts (line 42, match: 95%)"
  Não como: "{file: ..., line: ...}"

Given: Tool retorna código snippet
When: Formatado
Then:
  - Sintaxe highlightada
  - Line numbers mostrados
  - Contexto visível
  - Fácil de ler no terminal

Given: 50 resultados de search
When: User solicitou resumo
Then: Mostrado sumário (5 top results)
And: User pode pedir detalhes
When: Usuário pede detalhes
Then: Todos 50 mostrados com paginação

Given: Network goes down during tool invocation
When: Vectora desconecta
Then:
  - Reconhece desconexão
  - User avisado
  - Oferece retry ou offline alternatives
  - Reconnect automático quando online

Given: User query é malformado
When: CLI processa
Then:
  - Detecta problema
  - Sugere correção
  - Oferece exemplo de boa query
  - Oferece retry

Given: Codebase vazio ou muito pequeno
When: Search executado
Then:
  - Não crash
  - Mensagem clara: "No matching code found"
  - Sugestão para adicionar código

Given: User query que usa Vectora
When: Query processada
Then: CLI mostra:
  "Using Vectora tool: search_context"
  "Query: 'authentication handler'"
  "Results: 3 found (score > 0.7)"

Given: CLI em verbose mode
When: Tool invocado
Then: Mostra:
  - Exact query enviado
  - Response recebido (JSON)
  - Parsing steps
  - Final formatting

Given: Tool executado
When: Completo
Then: Exibido:
  "Query took 250ms (cache hit)"
  "Network: 120ms, Processing: 130ms"

Given: Query que beneficia de ambas respostas
When: CLI processa:
  1. Busca em Vectora (exemplos reais)
  2. Responde com conhecimento Gemini (padrões)
Then: Response combina ambas:
  "Here are the patterns, and in your code specifically..."

Given: Query onde Vectora pode ajudar
When: Score de relevância é baixo (< 0.6)
Then:
  - Usa resposta Gemini como primária
  - Vectora como supplementary
  - User vê diferença na apresentação

# Todos os testes
go test -v ./tests/gemini-cli/...

# Suite específica
go test -v -run TestDecisionIntelligence ./tests/gemini-cli/...

# Com conversation replay
python scripts/test_conversation_flows.py

# Load test (100 concurrent conversations)
go test -v -timeout 10m ./tests/gemini-cli/load_test.go

# Manual testing
gemini-cli --verbose # Mostra detail