Refatorar Método para Reduzir Complexidade Cognitiva

Objetivo

Refatorar o método ${input:methodName}, para reduzir sua complexidade cognitiva para ${input:complexityThreshold} ou menos, extraindo a lógica em métodos auxiliares focados.

Instruções

1. Analisar o método atual para identificar fontes de complexidade cognitiva:

   • Declarações condicionais aninhadas
   • Múltiplas cadeias if-else ou switch
   • Blocos de código repetidos
   • Múltiplos loops com condições
   • Expressões booleanas complexas

2. Identificar oportunidades de extração:

   • Lógica de validação que pode ser extraída para um método separado
   • Processamento específico de tipo ou caso que se repete
   • Transformações ou cálculos complexos
   • Padrões comuns que aparecem várias vezes

3. Extrair métodos auxiliares focados:

   • Cada auxiliar deve ter uma responsabilidade única e clara
   • Extrair validação para métodos Validate* separados
   • Extrair lógica específica de tipo para métodos manipuladores (handlers)
   • Criar métodos utilitários para operações comuns
   • Usar níveis de acesso apropriados (static, private, async)

4. Simplificar o método principal:

   • Reduzir a profundidade de aninhamento
   • Substituir cadeias if-else massivas por chamadas orquestradas menores
   • Usar instruções switch onde apropriado para um despacho mais limpo
   • Garantir que o método principal seja lido como um fluxo de alto nível

5. Preservar a funcionalidade:

   • Manter o mesmo comportamento de entrada/saída
   • Manter toda a validação e tratamento de erros
   • Preservar tipos de exceção e mensagens de erro
   • Garantir que todos os parâmetros sejam passados corretamente para os auxiliares

6. Melhores práticas:

   • Tornar métodos auxiliares estáticos quando eles não precisam de estado de instância
   • Usar verificações de nulo (null checks) e cláusulas de guarda (guard clauses) cedo
   • Evitar a criação de variáveis locais desnecessárias
   • Considerar o uso de tuplas para múltiplos valores de retorno
   • Agrupar métodos auxiliares relacionados

Abordagem de Implementação

• Extrair métodos auxiliares antes de refatorar o fluxo principal
• Testar incrementalmente para garantir que não haja regressões
• Usar nomes significativos que descrevam a responsabilidade extraída
• Manter métodos extraídos próximos a onde são usados
• Considerar transformar padrões de código repetidos em métodos genéricos

Resultado

O método refatorado deve:

• Ter a complexidade cognitiva reduzida para o limite alvo de ${input:complexityThreshold} ou menos
• Ser mais legível e de fácil manutenção
• Ter clara separação de responsabilidades
• Ser mais fácil de testar e depurar
• Reter toda a funcionalidade original

Testes e Validação

CRÍTICO: Após completar a refatoração, você DEVE:

1. Executar todos os testes existentes relacionados ao método refatorado e sua funcionalidade circundante
2. MANDATÓRIO: Verificar explicitamente se os resultados dos testes mostram "failed=0"
   • NUNCA assuma que os testes passaram - sempre examine a saída real dos testes
   • Procure pela linha de resumo contendo as contagens de aprovação/falha (ex: "passed=X failed=Y")
   • Se o resumo mostrar qualquer número diferente de "failed=0", os testes FALHARAM
   • Se a saída dos testes estiver em um arquivo, leia o arquivo inteiro para localizar e verificar a contagem de falhas
   • Executar testes NÃO é o mesmo que verificar se os testes passaram
   • Não prossiga até que você tenha confirmado explicitamente zero falhas
3. Se algum teste falhar (failed > 0):
   • Declare claramente quantos testes falharam
   • Analise cada falha para entender qual funcionalidade foi quebrada
   • Causas comuns: tratamento de nulo, verificações de coleção vazia, erros na lógica condicional
   • Identifique a causa raiz no código refatorado
   • Corrija o código refatorado para restaurar o comportamento original
   • Re-execute os testes e verifique "failed=0" na saída
   • Repita até que todos os testes passem (failed=0)
4. Verificar a compilação - Certifique-se de que não há erros de compilação
5. Verificar a complexidade cognitiva - Confirme se a métrica está no limite alvo de ${input:complexityThreshold} ou abaixo

Checklist de Confirmação

• O código compila sem erros
• Os resultados dos testes declaram explicitamente "failed=0" (verificado pela leitura da saída)
• Todas as falhas de teste foram analisadas e corrigidas (se ocorreram)
• A complexidade cognitiva está no limite alvo de ${input:complexityThreshold} ou abaixo
• Toda a funcionalidade original foi preservada
• O código segue as convenções e padrões do projeto