Queries & Tools Test Suite

Given: Namespace "production" com 5000 chunks
And: Query "authentication handler"
When: search_context executado
Then:
  - Top 5 resultados retornados
  - Ordenados por relevância (score)
  - Score > 0.7 para resultado #1
  - Metadata incluída (file, line, type)
  - Latência < 300ms

Given: Codebase com funções de autenticação
When: Query "JWT validation"
Then:
  - Retorna JWT-related code
  - Mesmo que keywords específicos não mencionem "JWT"
  - Semântica bate (validação + tokens)
  - Precision > 0.85
  - Recall > 0.80

Given: Query que retorna 1000+ resultados
When: search_context com top_k=100
Then:
  - Top 100 retornados em < 500ms
  - Paginação disponível
  - Primeira página accuracy > segunda

Given: Query "xyzabc123nomeRandomoQueNaoExiste"
When: search_context executado
Then:
  - Array vazio retornado (não erro)
  - Status code 200
  - Mensagem clara: "No results found"

Given: Query contendo "C++", "C#", ".NET", "React.js"
When: search_context executado
Then:
  - Query parseada corretamente
  - Resultados relevantes retornados
  - Sem SQL injection vulnerabilidade

Given: Query "getUserById"
When: search_context executado
Then: Cada resultado inclui:
  - Função/classe encontrada
  - Linhas anteriores (contexto)
  - Linhas posteriores (contexto)
  - Total: janela de ~20 linhas

Given: Query com filtros:
  - file: "*.service.ts"
  - type: "function"
  - complexity: "> 3"
When: search_context com filtros
Then: Resultados respeitam todos filtros
And: Latência +50ms vs query simples

Given: Codebase com Go, TypeScript, Python
When: Query em português: "função de validação"
Then: Resultados de todas as linguagens
And: Semântica transcende linguagem

Given: Mesma query executada 10x
When: Executadas sequencialmente
Then:
  - Query 1: 300ms
  - Queries 2-10: < 50ms
  - Hit rate: 90%+

Given: Codebase com 200+ testes
And: Query "authentication tests"
When: search_tests executado
Then:
  - Testes auth encontrados
  - Test framework identificado (Jest, Go, Pytest)
  - Coverage info incluída
  - Execution time estimada

Given: Resultado de search_tests
When: Analisado
Then: Cada teste classificado como:
  - Unit / Integration / E2E
  - Fast (< 100ms) / Medium (100ms-1s) / Slow (> 1s)
  - Critical / Normal / Optional

Given: Function "validateJWT"
When: search_tests procura testes relacionados
Then:
  - Encontra "validateJWT.test.js"
  - Encontra "auth.integration.test.js"
  - Encontra testes que usam validateJWT indiretamente

Given: Function sem testes
When: search_tests executado
Then:
  - Identifica como "untested"
  - Sugere criar testes
  - Estima coverage gap

Given: Snippet:
  function calculateTotal(items) {
    return items.reduce((sum, item) => sum + item.price, 0)
  }
When: find_similar_code executado
Then: Encontra padrões similares mesmo com nomes diferentes

Given: Código de BFS traversal
When: find_similar_code executado
Then:
  - Encontra outros BFS implementations
  - Mesmo com estruturas de dados diferentes
  - Mesmo em linguagens diferentes
  - Score baseado em algoritmo, não sintaxe

Given: Anti-pattern (e.g., n+1 queries)
When: find_similar_code procura por padrão
Then: Encontra todas instâncias do anti-pattern
And: Sugere refactoring

Given: Function "getUserById"
When: analyze_dependencies executado
Then: Encontra:
  - Funções que chama
  - Libraries usadas
  - External APIs chamadas
  - Database queries

Given: Function A → B → C → D
When: analyze_dependencies com depth=all
Then:
  - Cadeia completa mapeada
  - Risco de circular dependencies detectado
  - Saída estruturada como grafo

Given: Codebase com múltiplas versões da mesma lib
When: analyze_dependencies executado
Then:
  - Conflitos identificados
  - Recomendações de resolução
  - Risk assessment

Given: Dependência com breaking change
When: analyze_dependencies com versioning
Then:
  - Breaking change detectado
  - Code impact análise
  - Migration path sugerido

Given: Directory com estrutura:
  src/
    components/
      Button.tsx
      Input.tsx
    utils/
      format.ts
When: get_file_structure executado
Then: Retorna árvore JSON estruturada
And: Includes file sizes, line counts

Given: Directory com 10000+ arquivos
When: get_file_structure executado
Then:
  - Completa em < 5s
  - Suporta paginação
  - Opcao de profundidade máxima

Given: Query: "find all XXX that YYY"
When: validate_query executado
Then:
  - Sintaxe validada
  - Ambiguidades detectadas
  - Sugestões de refinamento
  - Score de qualidade (0-100)

Given: Query ambígua: "get calls"
When: validate_query executado
Then:
  - Detecta ambiguidade
  - Sugere refinamentos:
    * "Get all functions that make calls"
    * "Get all incoming calls to function"
  - Oferece para clarificar

Given: Vectora rodando há 1 hora
When: get_metrics executado
Then: Retorna:
  - Queries processadas: N
  - Cache hit rate: X%
  - Avg latency: Yms
  - Memory usage: ZMB
  - Uptime: 1h

Given: Metrics coletadas por 24h
When: get_metrics analisado
Then:
  - Detecta degradação de performance
  - Identifica picos de uso
  - Sugere otimizações

Given: Bug report: "getUserById is slow"
When: Investigação completa executada:
  1. search_tests para encontrar testes
  2. analyze_dependencies para entender calls
  3. find_similar_code para padrões
  4. search_context para implementação
Then: Diagnóstico completo com findings

Given: Pull request com mudanças
When: Queries executadas:
  1. Encontra testes afetados
  2. Descobre dependências
  3. Procura impacto em código similar
Then: Report de review automatizado

GOOGLE_API_KEY=xxxx # Google Search
VOYAGE_API_KEY=xxxx # Embeddings + Reranking
MONGODB_ATLAS_URI=xxx # Vector database

# Todos os testes de queries
go test -v ./tests/queries/...

# Tool específica
go test -v -run TestSearchContext ./tests/queries/...

# Com benchmarks
go test -v -bench=. ./tests/queries/...

# Com coverage
go test -v -cover ./tests/queries/...

# Load test
go test -v -timeout 30m ./tests/queries/load_tests.go