@mocoto/mahoraga 0.14.0 → 0.14.2

package/dist/analysts/architects/strategist-structure.js

@@ -1,44 +1,67 @@
+// SPDX-License-Identifier: MIT
 import { statSync } from 'node:fs';
 import path from 'node:path';
 import { getTypesDirectoryRelPosix } from '../../core/config/index.js';
 import { carregarConfigEstrategia, destinoPara, deveIgnorar, normalizarRel } from '../../shared/helpers/index.js';
+/**
+ * Estrategista/Planejador de Estrutura
+ *
+ * Responsável por: dado o conjunto de arquivos e um catálogo de arquétipos,
+ * sugerir um plano de reorganização (mover arquivos) com base em regras de nomeação
+ * e diretórios-alvo padronizados. Não aplica mudanças no disco (apenas sugere).
+ *
+ * Domínio ideal: arquitetos (diagnóstico/planejamento). A execução fica com zeladores.
+ */
 export async function gerarPlanoEstrategico(contexto, opcoes = {}, sinaisAvancados) {
     const typesDir = getTypesDirectoryRelPosix();
     const cfg = await carregarConfigEstrategia(contexto.baseDir, {
         ...opcoes,
-        ignorarPastas: Array.from(new Set([...(opcoes.ignorarPastas || []), typesDir])).filter(Boolean)
+        ignorarPastas: Array.from(new Set([...(opcoes.ignorarPastas ?? []), typesDir])).filter(Boolean)
     });
     const mover = [];
     const conflitos = [];
+    // Estratégia atual: heurística de nomeação + config/preset (sem consultar arquétipos aqui para evitar ciclos)
     const rels = contexto.arquivos.map(arquivo => normalizarRel(arquivo.relPath));
     const isTestLike = (caminho) => /__(tests|mocks)__/.test(caminho) || /\.(test|spec)\.[jt]sx?$/.test(caminho) || /fixtures\//.test(caminho);
     for (const rel of rels) {
-        if (deveIgnorar(rel, cfg.ignorarPastas))
+        if (deveIgnorar(rel, cfg.ignorarPastas)) {
             continue;
-        if (isTestLike(rel))
+        }
+        if (isTestLike(rel)) {
             continue;
-        if (!rel.endsWith('.ts') && !rel.endsWith('.js'))
+        } // não mover testes/fixtures
+        // Evitar mexer em arquivos fora do escopo de código (por agora)
+        if (!rel.endsWith('.ts') && !rel.endsWith('.js')) {
             continue;
+        }
+        // Respeita convenções de ferramentas no root: não mover configs globais
         const base = path.posix.basename(rel);
-        if (/^(eslint|vitest|next|tailwind|postcss|prettier|jest)\.config\.[jt]s$/i.test(base))
+        if (/^(eslint|vitest|next|tailwind|postcss|prettier|jest)\.config\.[jt]s$/i.test(base)) {
             continue;
+        }
         const res = destinoPara(rel, cfg.raizCodigo, cfg.criarSubpastasPorEntidade, cfg.apenasCategoriasConfiguradas, cfg.categoriasMapa);
-        if (!res.destinoDir)
+        if (!res.destinoDir) {
             continue;
+        }
         const currentDir = path.posix.dirname(rel);
         const alreadyInTarget = currentDir === res.destinoDir || currentDir.startsWith(`${res.destinoDir}/`);
-        if (alreadyInTarget)
+        if (alreadyInTarget) {
             continue;
+        }
+        // [LANCAMENTO] INTELIGÊNCIA CONTEXTUAL: Ajustar destino baseado em sinais avançados
         let destinoDirAjustado = res.destinoDir;
-        const motivoAjustado = res.motivo || 'Reorganização padrão';
+        const motivoAjustado = res.motivo ?? 'Reorganização padrão';
         if (sinaisAvancados) {
             destinoDirAjustado = ajustarDestinoPorSinais(rel, res.destinoDir, sinaisAvancados, motivoAjustado);
         }
+        // Mantém o mesmo nome do arquivo; apenas move para pasta de destino
         const destino = path.posix.join(destinoDirAjustado, path.posix.basename(rel));
+        // Conflito se já existe arquivo listado ou presente no filesystem
         let destinoExiste = rels.includes(destino);
         if (!destinoExiste) {
             try {
                 const abs = path.join(contexto.baseDir, destino.replace(/\\/g, '/'));
+                // fs.statSync usado de forma segura; se falhar, considera inexistente
                 statSync(abs);
                 destinoExiste = true;
             }
@@ -59,11 +82,13 @@ export async function gerarPlanoEstrategico(contexto, opcoes = {}, sinaisAvancad
             motivo: motivoAjustado
         });
     }
+    // Deduplicação simples
     const seen = new Set();
     const moverFiltrado = mover.filter(migracao => {
         const migrationChave = `${migracao.de}→${migracao.para}`;
-        if (seen.has(migrationChave))
+        if (seen.has(migrationChave)) {
             return false;
+        }
         seen.add(migrationChave);
         return true;
     });
@@ -77,12 +102,17 @@ export async function gerarPlanoEstrategico(contexto, opcoes = {}, sinaisAvancad
         }
     };
 }
+/**
+ * Ajusta o destino de um arquivo baseado nos sinais avançados do projeto
+ */
 function ajustarDestinoPorSinais(relPath, destinoOriginal, sinais, motivoOriginal) {
     let destino = destinoOriginal;
     let _motivo = motivoOriginal;
+    // Análise baseada no tipo dominante do projeto
     if (sinais.tipoDominante) {
         switch (sinais.tipoDominante) {
             case 'api-rest':
+                // Para APIs REST, priorizar estrutura controllers/routes
                 if (relPath.includes('controller') || relPath.includes('route')) {
                     if (!destino.includes('controllers') && !destino.includes('routes')) {
                         destino = 'src/controllers';
@@ -91,24 +121,28 @@ function ajustarDestinoPorSinais(relPath, destinoOriginal, sinais, motivoOrigina
                 }
                 break;
             case 'frontend-framework':
+                // Para frontend, manter componentes organizados
                 if (relPath.includes('component') && !destino.includes('components')) {
                     destino = 'src/components';
                     _motivo += ' | Ajustado para estrutura frontend típica';
                 }
                 break;
             case 'cli-tool':
+                // Para CLI, manter binários e comandos organizados
                 if (relPath.includes('cli') || relPath.includes('command')) {
                     destino = 'src/cli';
                     _motivo += ' | Ajustado para estrutura CLI típica';
                 }
                 break;
             case 'library':
+                // Para bibliotecas, focar em exports e tipos
                 if (relPath.includes('index') || relPath.includes('export')) {
                     destino = 'src';
                     _motivo += ' | Mantido na raiz src para biblioteca';
                 }
                 break;
             case 'clean-arch':
+                // Clean Architecture: organização por camadas
                 if (relPath.includes('entity') || relPath.includes('value-object')) {
                     destino = 'src/domain';
                     _motivo += ' | Clean Architecture: camada de domínio';
@@ -128,6 +162,7 @@ function ajustarDestinoPorSinais(relPath, destinoOriginal, sinais, motivoOrigina
                 break;
             case 'distributed':
             case 'microservices':
+                // Arquitetura Distribuída: inferir boundary de serviço do nome do arquivo
                 if (relPath.includes('gateway')) {
                     destino = 'src/infrastructure/gateways';
                     _motivo += ' | Distributed Arch: gateways';
@@ -145,6 +180,7 @@ function ajustarDestinoPorSinais(relPath, destinoOriginal, sinais, motivoOrigina
                     _motivo += ' | Distributed Arch: monitoramento';
                 }
                 else {
+                    // Tentar inferir o serviço a partir do nome
                     const nomeBase = path.posix.basename(relPath, path.posix.extname(relPath));
                     const servicosConhecidos = ['auth', 'user', 'payment', 'order', 'product', 'notification', 'email', 'catalog', 'inventory', 'shipping'];
                     for (const servico of servicosConhecidos) {
@@ -158,6 +194,7 @@ function ajustarDestinoPorSinais(relPath, destinoOriginal, sinais, motivoOrigina
                 break;
         }
     }
+    // Ajustes baseados em padrões arquiteturais detectados
     if (sinais.padroesArquiteturais.includes('repository-service')) {
         if (relPath.includes('repository') && !destino.includes('repositories')) {
             destino = 'src/repositories';
@@ -174,60 +211,75 @@ function ajustarDestinoPorSinais(relPath, destinoOriginal, sinais, motivoOrigina
             _motivo += ' | Padrão CLI detectado';
         }
     }
+    // CLEAN ARCHITECTURE: Organizar por camadas
     if (sinais.padroesArquiteturais.includes('clean-arch-domain') ||
         sinais.padroesArquiteturais.includes('clean-arch-application') ||
         sinais.padroesArquiteturais.includes('clean-arch-infrastructure') ||
         sinais.padroesArquiteturais.includes('clean-arch-presentation')) {
+        // Entity → domain/entities
         if ((relPath.includes('entity') || relPath.includes('entities')) && !destino.includes('domain')) {
             destino = 'src/domain/entities';
             _motivo += ' | Clean Architecture: domínio/entities';
         }
+        // Value Object → domain/value-objects
         if ((relPath.includes('value-object') || relPath.includes('value-objects')) && !destino.includes('domain')) {
             destino = 'src/domain/value-objects';
             _motivo += ' | Clean Architecture: domínio/value-objects';
         }
+        // Use Case / Interactor → application/use-cases
         if ((relPath.includes('use-case') || relPath.includes('usecase') || relPath.includes('interactor')) && !destino.includes('application')) {
             destino = 'src/application/use-cases';
             _motivo += ' | Clean Architecture: aplicação/use-cases';
         }
+        // Port → application/ports
         if (relPath.includes('/ports/') && !destino.includes('application')) {
             destino = 'src/application/ports';
             _motivo += ' | Clean Architecture: aplicação/ports';
         }
+        // DTO → application/dto
         if ((relPath.includes('.dto.') || relPath.includes('/dto/')) && !destino.includes('application')) {
             destino = 'src/application/dto';
             _motivo += ' | Clean Architecture: aplicação/dto';
         }
+        // Repository implementation → infrastructure/repositories
         if (relPath.includes('repository') && !relPath.includes('domain') && !destino.includes('infrastructure')) {
             destino = 'src/infrastructure/repositories';
             _motivo += ' | Clean Architecture: infraestrutura/repositories';
         }
+        // Controller/Handler → presentation/controllers
         if ((relPath.includes('controller') || relPath.includes('handler')) && !destino.includes('presentation') && !destino.includes('controllers')) {
             destino = 'src/presentation/controllers';
             _motivo += ' | Clean Architecture: apresentação/controllers';
         }
+        // Presenter → presentation/presenters
         if (relPath.includes('presenter') && !destino.includes('presentation')) {
             destino = 'src/presentation/presenters';
             _motivo += ' | Clean Architecture: apresentação/presenters';
         }
     }
+    // DISTRIBUTED / MICROSERVICES: Organizar por boundaries de serviço
     if (sinais.boundariesServicos && sinais.boundariesServicos.length > 0) {
+        // Se o arquivo está em um boundary de serviço, mantém a estrutura
         for (const boundary of sinais.boundariesServicos) {
             if (relPath.includes(`/services/${boundary}/`)) {
+                // Já está no boundary correto
                 _motivo += ` | Microsserviço '${boundary}' detectado`;
                 break;
             }
         }
     }
     if (sinais.padroesDistribuidos?.includes('api-gateway') || sinais.padroesDistribuidos?.includes('event-driven')) {
+        // Gateway → infrastructure/gateways
         if ((relPath.includes('gateway') || relPath.includes('api-gateway')) && !destino.includes('gateways') && !destino.includes('infrastructure')) {
             destino = 'src/infrastructure/gateways';
             _motivo += ' | Distributed Arch: infrastructure/gateways';
         }
+        // Event/Message → infrastructure/events ou infrastructure/messaging
         if ((relPath.includes('event') || relPath.includes('message')) && (relPath.includes('handler') || relPath.includes('consumer')) && !destino.includes('infrastructure')) {
             destino = 'src/infrastructure/events';
             _motivo += ' | Distributed Arch: infrastructure/events';
         }
+        // Consumer/Producer → infrastructure/consumers ou infrastructure/producers
         if ((relPath.includes('consumer') || relPath.includes('subscriber')) && !destino.includes('infrastructure')) {
             destino = 'src/infrastructure/consumers';
             _motivo += ' | Distributed Arch: infrastructure/consumers';
@@ -237,15 +289,19 @@ function ajustarDestinoPorSinais(relPath, destinoOriginal, sinais, motivoOrigina
             _motivo += ' | Distributed Arch: infrastructure/producers';
         }
     }
+    // Ajustes baseados em tecnologias dominantes
     if (sinais.tecnologiasDominantes.includes('typescript-advanced')) {
         if (relPath.includes('type') || relPath.includes('interface')) {
             destino = 'src/types';
             _motivo += ' | TypeScript avançado detectado';
         }
     }
+    // Ajustes baseados na complexidade estrutural
     if (sinais.complexidadeEstrutura === 'alta') {
+        // Para projetos complexos, criar subpastas por domínio
         const nomeArquivo = path.posix.basename(relPath, path.posix.extname(relPath));
         if (nomeArquivo.length > 3) {
+            // Tentar inferir domínio do nome do arquivo
             const dominioInferido = inferirDominio(nomeArquivo);
             if (dominioInferido && !destino.includes(dominioInferido)) {
                 destino = `src/${dominioInferido}`;
@@ -255,6 +311,9 @@ function ajustarDestinoPorSinais(relPath, destinoOriginal, sinais, motivoOrigina
     }
     return destino;
 }
+/**
+ * Tenta inferir um domínio de negócio baseado no nome do arquivo
+ */
 function inferirDominio(nomeArquivo) {
     const padroesDominio = {
         auth: ['auth', 'login', 'user', 'session', 'security'],
@@ -263,11 +322,13 @@ function inferirDominio(nomeArquivo) {
         order: ['order', 'cart', 'purchase', 'sale'],
         report: ['report', 'analytics', 'metric', 'dashboard'],
         admin: ['admin', 'management', 'config', 'setting'],
+        // Clean Architecture domains
         customer: ['customer', 'client', 'account'],
         billing: ['billing', 'invoice', 'receipt', 'payment'],
         shipping: ['shipping', 'delivery', 'freight', 'logistics'],
         inventory: ['inventory', 'stock', 'warehouse', 'supply'],
         catalog: ['catalog', 'product', 'item', 'category'],
+        // Microservices domains
         'api-gateway': ['gateway', 'proxy', 'router'],
         notification: ['notification', 'notify', 'alert', 'push', 'email', 'message'],
         analytics: ['analytics', 'tracking', 'event', 'metric']
@@ -284,4 +345,3 @@ export const EstrategistaEstrutura = {
     nome: 'estrategista-estrutura',
     gerarPlano: gerarPlanoEstrategico
 };
-//# sourceMappingURL=strategist-structure.js.map

package/dist/analysts/azure-pipelines/analysts/analyst-azure.js

@@ -1,5 +1,6 @@
-import { messages } from '../../../core/messages/index.js';
+// SPDX-License-Identifier: MIT
 import { parseDocument } from 'yaml';
+import { messages } from '../../../core/messages/index.js';
 import { detectorAzurePerformance } from '../detectors/detector-azure-performance.js';
 import { detectorAzureSecurity } from '../detectors/detector-azure-security.js';
 import { detectorAzureEstrutura } from '../detectors/detector-azure-structure.js';
@@ -15,41 +16,45 @@ export const analistaAzurePipelines = {
     categoria: 'workflows',
     descricao: 'Analista de configurações do Azure Pipelines',
     test: (relPath) => (relPath === 'azure-pipelines.yml' || relPath.endsWith('azure-pipelines.yml') || relPath.includes('/azure-pipelines/')) && /\.(ya?ml)$/i.test(relPath),
-    aplicar: async (conteudo, relPath, _ast = null, _fc, contexto) => {
+    aplicar: async (conteudo, relPath, _ast, _fc, contexto) => {
         const ocorrencias = [];
         try {
+            // 1. Detectores baseados em regex (rápidos)
             const securityResults = await Promise.resolve(detectorAzureSecurity.aplicar(conteudo, relPath, null, _fc, contexto));
             const performanceResults = await Promise.resolve(detectorAzurePerformance.aplicar(conteudo, relPath, null, _fc, contexto));
             const estruturaResults = await Promise.resolve(detectorAzureEstrutura.aplicar(conteudo, relPath, null, _fc, contexto));
             ocorrencias.push(...securityResults, ...performanceResults, ...estruturaResults);
+            // 2. Análise Estrutural básica
             const doc = parseDocument(conteudo);
             const configData = doc.toJS();
-            if (configData) {
-                if (configData.version && parseFloat(String(configData.version)) < 1.0) {
+            // Verificar versão antiga (v0.x)
+            const version = configData.version;
+            if ((typeof version === 'string' || typeof version === 'number') && parseFloat(String(version)) < 1.0) {
+                ocorrencias.push({
+                    tipo: 'AZURE_OBSOLETE_VERSION',
+                    mensagem: 'Versão do schema do Azure Pipelines está obsoleta',
+                    relPath,
+                    linha: 1,
+                    nivel: 'aviso',
+                    sugestao: 'Remova o campo "version" para usar o schema YAML moderno',
+                });
+            }
+            // Detectar excesso de variáveis globais
+            if (configData.variables && typeof configData.variables === 'object') {
+                const varCount = Object.keys(configData.variables).length;
+                if (varCount > 20) {
                     ocorrencias.push({
-                        tipo: 'AZURE_OBSOLETE_VERSION',
-                        mensagem: 'Versão do schema do Azure Pipelines está obsoleta',
+                        tipo: 'AZURE_TOO_MANY_VARIABLES',
+                        mensagem: messages.RelatorioAzureMensagens.tooManyVariables,
                         relPath,
                         linha: 1,
-                        nivel: 'aviso',
-                        sugestao: 'Remova o campo "version" para usar o schema YAML moderno',
+                        nivel: 'info',
+                        sugestao: messages.RelatorioAzureMensagens.tooManyVariablesSugestao,
                     });
                 }
-                if (configData.variables && typeof configData.variables === 'object') {
-                    const varCount = Object.keys(configData.variables).length;
-                    if (varCount > 20) {
-                        ocorrencias.push({
-                            tipo: 'AZURE_TOO_MANY_VARIABLES',
-                            mensagem: messages.RelatorioAzureMensagens.tooManyVariables,
-                            relPath,
-                            linha: 1,
-                            nivel: 'info',
-                            sugestao: messages.RelatorioAzureMensagens.tooManyVariablesSugestao,
-                        });
-                    }
-                }
             }
-            const caminhos = contexto?.arquivos.map(arquivo => arquivo.relPath) || [];
+            // 3. Plugins registrados
+            const caminhos = contexto?.arquivos.map(arquivo => arquivo.relPath) ?? [];
             const plugResults = await Promise.all(detectoresRegistrados.map(detector => Promise.resolve(detector.testar(configData, { conteudo, caminhos })).catch(() => [])));
             for (const results of plugResults) {
                 for (const item of results) {
@@ -57,17 +62,17 @@ export const analistaAzurePipelines = {
                         tipo: `AZURE_${item.tipo.toUpperCase().replace(/-/g, '_')}`,
                         mensagem: item.descricao,
                         relPath,
-                        linha: item.linha || 1,
+                        linha: item.linha ?? 1,
                         coluna: 1,
-                        sugestao: item.sugestao || '',
+                        sugestao: item.sugestao ?? '',
                         nivel: item.severidade === 'critica' || item.severidade === 'alta' ? 'erro' : item.severidade === 'media' ? 'aviso' : 'info',
                     });
                 }
             }
         }
         catch {
+            // Falha silenciosa no parse
         }
         return ocorrencias;
     }
 };
-//# sourceMappingURL=analyst-azure.js.map

package/dist/analysts/azure-pipelines/analysts/index.js

@@ -1,2 +1 @@
 export * from './analyst-azure.js';
-//# sourceMappingURL=index.js.map

package/dist/analysts/azure-pipelines/corrections/autofix-engine.js

@@ -1,19 +1,21 @@
+// SPDX-License-Identifier: MIT
 import { parseDocument } from 'yaml';
 export class AutofixEngine {
     aplicarFixes(content, fixers) {
-        if (!content || fixers.length === 0)
+        if (!content || fixers.length === 0) {
             return content;
+        }
         const doc = parseDocument(content);
-        if (doc.errors.length > 0)
+        if (doc.errors.length > 0) {
             return content;
+        }
         for (const fix of fixers) {
             try {
                 fix(doc);
             }
-            catch { }
+            catch { /* skip failed fix */ }
         }
         return doc.toString();
     }
 }
 export const autofixEngine = new AutofixEngine();
-//# sourceMappingURL=autofix-engine.js.map

package/dist/analysts/azure-pipelines/corrections/correction-azure.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { messages } from '../../../core/messages/index.js';
 import { splitLines } from '../../../shared/helpers/index.js';
 import { criarOcorrencia } from '../../../types/index.js';
@@ -43,8 +44,9 @@ export const correctionAzure = {
     descricao: 'Correções automáticas para Azure Pipelines',
     test: (relPath) => relPath === 'azure-pipelines.yml' || relPath.endsWith('azure-pipelines.yml'),
     aplicar: (src, relPath) => {
-        if (!src)
+        if (!src) {
             return [];
+        }
         const correcoes = detectarCorrecoesAzure(src, relPath);
         return correcoes.map(elem => criarOcorrencia({
             tipo: `correction-${elem.tipo}`,
@@ -61,4 +63,3 @@ export const correctionAzure = {
         }));
     }
 };
-//# sourceMappingURL=correction-azure.js.map

package/dist/analysts/azure-pipelines/corrections/index.js

@@ -1,3 +1,3 @@
+// SPDX-License-Identifier: MIT
 export * from './autofix-engine.js';
 export * from './correction-azure.js';
-//# sourceMappingURL=index.js.map

package/dist/analysts/azure-pipelines/detectors/detector-azure-performance.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { messages } from '../../../core/messages/index.js';
 import { criarOcorrencia } from '../../../types/index.js';
 export const detectorAzurePerformance = {
@@ -6,9 +7,11 @@ export const detectorAzurePerformance = {
     descricao: 'Detecta problemas de performance em Azure Pipelines',
     test: (relPath) => relPath.includes('azure-pipelines') && /\.(ya?ml)$/i.test(relPath),
     aplicar: (src, relPath) => {
-        if (!src)
+        if (!src) {
             return [];
+        }
         const ocorrencias = [];
+        // 1. Cache de dependências
         if (!/task:\s*Cache@/i.test(src) && !/CacheBeta@/i.test(src)) {
             ocorrencias.push(criarOcorrencia({
                 tipo: 'azure-pipelines-missing-cache',
@@ -19,6 +22,7 @@ export const detectorAzurePerformance = {
                 sugestao: messages.RelatorioAzureMensagens.missingCacheTaskSugestao,
             }));
         }
+        // 2. Paralelismo em Testes
         if (/task:\s*DotNetCoreCLI@.*test/i.test(src) || /task:\s*Npm@.*test/i.test(src)) {
             if (!/parallel:\s*\d+/i.test(src) && !/strategy:\s*matrix:/i.test(src)) {
                 ocorrencias.push(criarOcorrencia({
@@ -31,6 +35,7 @@ export const detectorAzurePerformance = {
                 }));
             }
         }
+        // 3. Checkout desnecessário em pipelines de deploy
         if (/(stage|job).*deploy/i.test(src) && !/checkout:\s*none/i.test(src)) {
             ocorrencias.push(criarOcorrencia({
                 tipo: 'azure-pipelines-checkout-none',
@@ -41,6 +46,7 @@ export const detectorAzurePerformance = {
                 sugestao: 'Use "checkout: none" se o job apenas consome artifacts, economizando tempo de clonagem',
             }));
         }
+        // 4. Parallel deployment detection
         if (/environment:/i.test(src) && /deploy/i.test(src)) {
             const deployJobs = src.match(/- job:\s*\w+/g);
             const deployStages = src.match(/- stage:\s*\w+/g);
@@ -59,6 +65,7 @@ export const detectorAzurePerformance = {
                 }
             }
         }
+        // 5. Large artifact staging
         const publishArtifacts = src.match(/task:\s*PublishBuildArtifacts@/gi);
         if (publishArtifacts && publishArtifacts.length > 3) {
             ocorrencias.push(criarOcorrencia({
@@ -70,6 +77,7 @@ export const detectorAzurePerformance = {
                 sugestao: messages.RelatorioAzureMensagens.largeArtifactStagingSugestao,
             }));
         }
+        // 6. Matrix strategy detection for multi-platform builds
         if (/platform|os:|vmImage/i.test(src)) {
             const hasMatrix = /strategy:\s*matrix:/i.test(src);
             const hasMultiplePlatforms = /(ubuntu|windows|macos|linux)/i.test(src);
@@ -84,9 +92,10 @@ export const detectorAzurePerformance = {
                 }));
             }
         }
+        // 7. Conditional step analysis
         const stepLines = src.match(/^\s*-\s+(task|script|bash|powershell|pwsh|checkout):/gim);
         if (stepLines && stepLines.length > 0) {
-            const conditionalCount = (src.match(/condition:/gi) || []).length;
+            const conditionalCount = (src.match(/condition:/gi) ?? []).length;
             const unconditionalRatio = stepLines.length / (conditionalCount + 1);
             if (unconditionalRatio > 5 && stepLines.length > 5) {
                 ocorrencias.push(criarOcorrencia({
@@ -102,4 +111,3 @@ export const detectorAzurePerformance = {
         return ocorrencias;
     }
 };
-//# sourceMappingURL=detector-azure-performance.js.map

package/dist/analysts/azure-pipelines/detectors/detector-azure-security.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { messages } from '../../../core/messages/index.js';
 import { criarOcorrencia } from '../../../types/index.js';
 const VULNERABLE_TASKS = {
@@ -21,9 +22,11 @@ export const detectorAzureSecurity = {
     descricao: 'Detecta vulnerabilidades em Azure Pipelines',
     test: (relPath) => relPath.includes('azure-pipelines') && /\.(ya?ml)$/i.test(relPath),
     aplicar: (src, relPath) => {
-        if (!src)
+        if (!src) {
             return [];
+        }
         const ocorrencias = [];
+        // 1. Imagem latest
         if (/vmImage:\s*['"]?.*latest['"]?/i.test(src)) {
             ocorrencias.push(criarOcorrencia({
                 tipo: 'azure-pipelines-latest-image',
@@ -34,6 +37,7 @@ export const detectorAzureSecurity = {
                 sugestao: messages.RelatorioAzureMensagens.vulnerableTaskSugestao,
             }));
         }
+        // 2. Vulnerable task versions
         for (const [taskPattern, taskName] of Object.entries(VULNERABLE_TASKS)) {
             const taskRegex = new RegExp(`task:\\s*${taskPattern.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}`, 'i');
             if (taskRegex.test(src)) {
@@ -47,6 +51,7 @@ export const detectorAzureSecurity = {
                 }));
             }
         }
+        // 3. Hardcoded Secrets (heurística)
         const secretRegex = /(password|token|secret|key|password):\s*['"]?([^$({][a-zA-Z0-9_\-]{8,})['"]?/gi;
         let match;
         while ((match = secretRegex.exec(src)) !== null) {
@@ -59,6 +64,7 @@ export const detectorAzureSecurity = {
                 sugestao: 'Use Azure Key Vault ou variáveis de biblioteca com $(NOME_DA_VARIAVEL)',
             }));
         }
+        // 4. Comandos perigosos
         if (/bash:\s*curl.*\|\s*bash/i.test(src)) {
             ocorrencias.push(criarOcorrencia({
                 tipo: 'azure-pipelines-dangerous-curl',
@@ -69,6 +75,7 @@ export const detectorAzureSecurity = {
                 sugestao: 'Baixe o script, valide o checksum e execute localmente para evitar Remote Code Execution',
             }));
         }
+        // 5. Checkout token configuration
         if (/checkout:\s*self/i.test(src) || /checkout:\s*[a-z]/i.test(src)) {
             const hasToken = /persistCredentials|persist-credentials/i.test(src);
             if (!hasToken) {
@@ -82,6 +89,7 @@ export const detectorAzureSecurity = {
                 }));
             }
         }
+        // 6. Inline secrets in scripts
         for (const pattern of SECRET_PATTERNS) {
             const secretMatch = pattern.exec(src);
             if (secretMatch) {
@@ -95,6 +103,7 @@ export const detectorAzureSecurity = {
                 }));
             }
         }
+        // 7. Environment approval gates
         if (/environment:/i.test(src)) {
             const hasApproval = /approvals?|approval|reviewers?/i.test(src);
             if (!hasApproval) {
@@ -108,6 +117,7 @@ export const detectorAzureSecurity = {
                 }));
             }
         }
+        // 8. Environment without reviewers
         const envBlocks = src.match(/environment:\s*[^\n]+/gi);
         if (envBlocks) {
             for (const envBlock of envBlocks) {
@@ -123,6 +133,7 @@ export const detectorAzureSecurity = {
                 }
             }
         }
+        // 9. Variable injection safety
         if (/\$\s*\(/i.test(src) && /script:|bash:|powershell:|pwsh:/i.test(src)) {
             const unsafeInjection = /script:.*\$\s*\(/i.test(src) || /bash:.*\$\s*\(/i.test(src) || /powershell:.*\$\s*\(/i.test(src) || /pwsh:.*\$\s*\(/i.test(src);
             if (unsafeInjection) {
@@ -136,6 +147,7 @@ export const detectorAzureSecurity = {
                 }));
             }
         }
+        // 10. Secret variable detection in plain text
         const variableLines = src.match(/^\s*variables\s*:\s*$/im);
         if (variableLines) {
             const varSection = src.slice(src.indexOf('variables:'));
@@ -159,4 +171,3 @@ export const detectorAzureSecurity = {
         return ocorrencias;
     }
 };
-//# sourceMappingURL=detector-azure-security.js.map