SFDX Wly - Salesforce DX Coverage & Change Analyzer

Extensao do VS Code para equipes Salesforce: compara sua branch com a main, exibe cobertura de Apex direto no package.xml, gera suite/package das alteracoes, roda pipeline de validacao/deploy e traz ferramentas para diff, logs e feedback.

O que a extensao faz

• Comparacao da branch atual com main/master: painel HTML com status Git/divergencia, cobertura Apex, links para classes de teste relacionadas e atalhos para abrir arquivos.
• Geracao de package.xml e ApexTestSuite a partir das alteracoes encontradas (classes de teste detectadas por @isTest), com preview e salvamento opcional.
• Decoracao de cobertura no package.xml sem alterar o arquivo, recalculada ao abrir/editar o manifest.
• Deploy guiado (validate ou direto) com sf deploy metadata, exibindo resumo em painel e link para o status no org usando a suite gerada/selecionada.
• Pipeline passo a passo: salva suite/package, compila o manifest (dry-run opcional), executa testes e valida/deploya apos checar divergencias de Git.
• Comparacao da org com o repositorio via sf project deploy preview, filtrando diferencas irrelevantes de quebra de linha e exibindo em WebView.
• Relatorio de Approval Processes com exportacao para Excel.
• Fluxo completo de logs Apex: busca com filtro textual e destaque, opcao de abrir o log/Replay Debugger, limpeza de logs no org/local e download em background configuravel.
• Resumo dos arquivos staged/working com opcao de usar IA (OpenAI) e copia automatica do texto para a area de transferencia.
• Menu rapido na barra de status e view SFDX Wly na Activity Bar com os principais comandos, alem do atalho para enviar ideias/feedback.

Pre-requisitos

• Salesforce CLI (sf ou sfdx) instalado e autenticado no org.
• Repositorio Git com branch main ou master.
• Projeto Salesforce DX aberto no VS Code (pasta manifest/force-app).

Instalacao

1. Instale na Visual Studio Marketplace.
2. Reinicie o VS Code e abra seu projeto Salesforce.

Fluxo rapido de uso

1. Ctrl+Shift+P -> SFDX Wly: Show Coverage para comparar com main, ver cobertura/testes e gerar package.xml + suite.
2. Opcional: Ctrl+Shift+P -> SFDX Wly: Show Coverage in package.xml para ver badges de cobertura direto no arquivo.
3. Execute SFDX Wly: Deploy (validate ou deploy) ou SFDX Wly: Pipeline para compilar, testar e enviar usando a suite sugerida.
4. Se precisar auditar antes de deployar, use SFDX Wly: Compare Org with Local ou o relatorio de Approval Processes.
5. Para logs, use SFDX Wly: Search Apex logs (e os comandos de limpeza/automacao na mesma secao).

Comandos

Configuracoes

• sfdxWly.minimumCoveragePercentage (padrao 75): minimo para considerar cobertura ok.
• sfdxWly.generatePackageXmlAutomatically (padrao true): cria/atualiza package.xml ao gerar a suite.
• sfdxWly.generateTestSuiteAutomatically (padrao true): mantem ApexTestSuite com os testes encontrados.
• sfdxWly.compareWithMainBranchAutomatically (padrao true): executa a comparacao com main automaticamente.
• sfdxWly.enableBackgroundApexLogs (padrao false): ativa o download silencioso de logs Apex.
• sfdxWly.ideaApiUrl: endpoint para envio de feedback (default publico da extensao).
• OPENAI_API_KEY (variavel de ambiente): habilita o resumo com IA no comando Summarize staged files.

Anotacao @coverage (para CI/CD)

/*
 * @coverage AccountController
 * @coverage OpportunityHandler
 */
@isTest
private class AccountControllerTest {
    // seus testes aqui
}

Use a anotacao para mapear classes Apex aos testes relacionados. Isso permite executar apenas o conjunto afetado em pipelines (Azure DevOps, GitHub Actions, GitLab CI etc.).

Estrutura recomendada

manifest/
  package.xml
force-app/
  main/
    default/
      classes/
        AccountController.cls
        AccountControllerTest.cls

Contribuicao

• Abra issues e pull requests no repositorio.
• Duvidas ou sugestoes: wlysses@gmail.com

Licenca

MIT. Consulte o arquivo LICENSE.