@mocoto/mahoraga 0.14.0 → 0.14.2

package/dist/analysts/circleci/detectors/detector-circleci-security.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';
@@ -18,22 +19,25 @@ export const detectorCircleCISecurity = {
     descricao: 'Detecta vulnerabilidades em CircleCI configs',
     test: (relPath) => relPath.endsWith('.circleci/config.yml'),
     aplicar: (src, relPath) => {
-        if (!src)
+        if (!src) {
             return [];
+        }
         const ocorrencias = [];
         const linhas = splitLines(src);
         linhas.forEach((linha, index) => {
             const numeroLinha = index + 1;
+            // 1. Secrets hardcoded em environment
             if (/\b(TOKEN|SECRET|PASSWORD|KEY|ACCESS_KEY)\b.*:\s*['"][^'"]+['"]/i.test(linha) && !/\$/.test(linha)) {
                 ocorrencias.push(criarOcorrencia({
                     tipo: 'circleci-hardcoded-secret',
                     nivel: 'erro',
-                    mensagem: typeof MSG.hardcodedKeyInConfig === 'function' ? MSG.hardcodedKeyInConfig() : MSG.hardcodedKeyInConfig,
+                    mensagem: typeof MSG.hardcodedKeyInConfig === 'function' ? (MSG.hardcodedKeyInConfig)() : MSG.hardcodedKeyInConfig,
                     relPath,
                     linha: numeroLinha,
-                    sugestao: typeof MSG.hardcodedKeyInConfigSugestao === 'function' ? MSG.hardcodedKeyInConfigSugestao() : MSG.hardcodedKeyInConfigSugestao
+                    sugestao: typeof MSG.hardcodedKeyInConfigSugestao === 'function' ? (MSG.hardcodedKeyInConfigSugestao)() : MSG.hardcodedKeyInConfigSugestao
                 }));
             }
+            // 2. Uso de imagem :latest
             if (/\bimage:\s*[^\s@]+:latest\b/.test(linha) || (/\bimage:\s*[^\s@:]+$/.test(linha.trim()) && linha.includes('image:'))) {
                 ocorrencias.push(criarOcorrencia({
                     tipo: 'circleci-image-latest',
@@ -44,16 +48,18 @@ export const detectorCircleCISecurity = {
                     sugestao: 'Use um digest (SHA) ou uma versão fixa para garantir segurança e reprodutibilidade'
                 }));
             }
+            // 3. Resource class analysis
             if (/resource_class\s*:\s*(medium|small)\s*$/.test(linha)) {
                 ocorrencias.push(criarOcorrencia({
                     tipo: 'circleci-default-resource-class',
                     nivel: 'info',
-                    mensagem: typeof MSG.missingResourceClass === 'function' ? MSG.missingResourceClass() : MSG.missingResourceClass,
+                    mensagem: typeof MSG.missingResourceClass === 'function' ? (MSG.missingResourceClass)() : MSG.missingResourceClass,
                     relPath,
                     linha: numeroLinha,
-                    sugestao: typeof MSG.missingResourceClassSugestao === 'function' ? MSG.missingResourceClassSugestao() : MSG.missingResourceClassSugestao
+                    sugestao: typeof MSG.missingResourceClassSugestao === 'function' ? (MSG.missingResourceClassSugestao)() : MSG.missingResourceClassSugestao
                 }));
             }
+            // 4. Context usage without branch restriction
             if (/context\s*:/.test(linha)) {
                 const nextLines = linhas.slice(index + 1, index + 5);
                 const hasBranchFilter = nextLines.some(l => /branches\s*:/.test(l));
@@ -61,45 +67,47 @@ export const detectorCircleCISecurity = {
                     ocorrencias.push(criarOcorrencia({
                         tipo: 'circleci-context-no-branch-restriction',
                         nivel: 'aviso',
-                        mensagem: typeof MSG.unsafeContextUsage === 'function' ? MSG.unsafeContextUsage() : MSG.unsafeContextUsage,
+                        mensagem: typeof MSG.unsafeContextUsage === 'function' ? (MSG.unsafeContextUsage)() : MSG.unsafeContextUsage,
                         relPath,
                         linha: numeroLinha,
-                        sugestao: typeof MSG.unsafeContextUsageSugestao === 'function' ? MSG.unsafeContextUsageSugestao() : MSG.unsafeContextUsageSugestao
+                        sugestao: typeof MSG.unsafeContextUsageSugestao === 'function' ? (MSG.unsafeContextUsageSugestao)() : MSG.unsafeContextUsageSugestao
                     }));
                 }
             }
+            // 5. Hardcoded key/fingerprint
             if (/fingerprint\s*:\s*['"][^'"]+['"]/.test(linha) || /\bkey\s*:\s*['"][A-Za-z0-9+/]{20,}['"]/.test(linha)) {
                 ocorrencias.push(criarOcorrencia({
                     tipo: 'circleci-hardcoded-fingerprint',
                     nivel: 'erro',
-                    mensagem: typeof MSG.hardcodedKeyInConfig === 'function' ? MSG.hardcodedKeyInConfig() : MSG.hardcodedKeyInConfig,
+                    mensagem: typeof MSG.hardcodedKeyInConfig === 'function' ? (MSG.hardcodedKeyInConfig)() : MSG.hardcodedKeyInConfig,
                     relPath,
                     linha: numeroLinha,
-                    sugestao: typeof MSG.hardcodedKeyInConfigSugestao === 'function' ? MSG.hardcodedKeyInConfigSugestao() : MSG.hardcodedKeyInConfigSugestao
+                    sugestao: typeof MSG.hardcodedKeyInConfigSugestao === 'function' ? (MSG.hardcodedKeyInConfigSugestao)() : MSG.hardcodedKeyInConfigSugestao
                 }));
             }
+            // 6. Dangerous checkout path
             if (/checkout\s*:/.test(linha) && /path\s*:/.test(linha)) {
                 ocorrencias.push(criarOcorrencia({
                     tipo: 'circleci-custom-checkout-path',
                     nivel: 'info',
-                    mensagem: typeof MSG.dangerousCheckoutPath === 'function' ? MSG.dangerousCheckoutPath() : MSG.dangerousCheckoutPath,
+                    mensagem: typeof MSG.dangerousCheckoutPath === 'function' ? (MSG.dangerousCheckoutPath)() : MSG.dangerousCheckoutPath,
                     relPath,
                     linha: numeroLinha,
-                    sugestao: typeof MSG.dangerousCheckoutPathSugestao === 'function' ? MSG.dangerousCheckoutPathSugestao() : MSG.dangerousCheckoutPathSugestao
+                    sugestao: typeof MSG.dangerousCheckoutPathSugestao === 'function' ? (MSG.dangerousCheckoutPathSugestao)() : MSG.dangerousCheckoutPathSugestao
                 }));
             }
+            // 7. Sudo usage
             if (/\bsudo\s+/.test(linha)) {
                 ocorrencias.push(criarOcorrencia({
                     tipo: 'circleci-sudo-usage',
                     nivel: 'aviso',
-                    mensagem: typeof MSG.sudoWithoutPasswordless === 'function' ? MSG.sudoWithoutPasswordless() : MSG.sudoWithoutPasswordless,
+                    mensagem: typeof MSG.sudoWithoutPasswordless === 'function' ? (MSG.sudoWithoutPasswordless)() : MSG.sudoWithoutPasswordless,
                     relPath,
                     linha: numeroLinha,
-                    sugestao: typeof MSG.sudoWithoutPasswordlessSugestao === 'function' ? MSG.sudoWithoutPasswordlessSugestao() : MSG.sudoWithoutPasswordlessSugestao
+                    sugestao: typeof MSG.sudoWithoutPasswordlessSugestao === 'function' ? (MSG.sudoWithoutPasswordlessSugestao)() : MSG.sudoWithoutPasswordlessSugestao
                 }));
             }
         });
         return ocorrencias;
     }
 };
-//# sourceMappingURL=detector-circleci-security.js.map

package/dist/analysts/circleci/detectors/detector-circleci-structure.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 { criarOcorrencia } from '../../../types/index.js';
 const MSG = messages.RelatorioCircleciMensagens;
 export const detectorCircleCIEstrutura = {
@@ -8,14 +9,13 @@ export const detectorCircleCIEstrutura = {
     descricao: 'Detecta problemas estruturais em CircleCI configs',
     test: (relPath) => relPath.endsWith('.circleci/config.yml'),
     aplicar: (src, relPath) => {
-        if (!src)
+        if (!src) {
             return [];
+        }
         const ocorrencias = [];
         try {
             const doc = parseDocument(src);
             const config = doc.toJS();
-            if (!config)
-                return ocorrencias;
             const jobs = config;
             if (jobs.jobs) {
                 for (const [jobName, job] of Object.entries(jobs.jobs)) {
@@ -52,6 +52,7 @@ export const detectorCircleCIEstrutura = {
                     }
                 }
             }
+            // Orb version pinning
             const orbs = config.orbs;
             if (orbs) {
                 for (const [_orbName, orbValue] of Object.entries(orbs)) {
@@ -59,14 +60,15 @@ export const detectorCircleCIEstrutura = {
                         ocorrencias.push(criarOcorrencia({
                             tipo: 'circleci-orb-no-version',
                             nivel: 'aviso',
-                            mensagem: typeof MSG.missingOrbVersion === 'function' ? MSG.missingOrbVersion() : MSG.missingOrbVersion,
+                            mensagem: typeof MSG.missingOrbVersion === 'function' ? (MSG.missingOrbVersion)() : MSG.missingOrbVersion,
                             relPath, linha: 1,
-                            sugestao: typeof MSG.missingOrbVersionSugestao === 'function' ? MSG.missingOrbVersionSugestao() : MSG.missingOrbVersionSugestao
+                            sugestao: typeof MSG.missingOrbVersionSugestao === 'function' ? (MSG.missingOrbVersionSugestao)() : MSG.missingOrbVersionSugestao
                         }));
                         break;
                     }
                 }
             }
+            // Executor documentation
             const executors = config.executors;
             if (executors) {
                 for (const [_execName, execDef] of Object.entries(executors)) {
@@ -74,29 +76,31 @@ export const detectorCircleCIEstrutura = {
                         ocorrencias.push(criarOcorrencia({
                             tipo: 'circleci-executor-no-description',
                             nivel: 'info',
-                            mensagem: typeof MSG.executorWithoutDescription === 'function' ? MSG.executorWithoutDescription() : MSG.executorWithoutDescription,
+                            mensagem: typeof MSG.executorWithoutDescription === 'function' ? (MSG.executorWithoutDescription)() : MSG.executorWithoutDescription,
                             relPath, linha: 1,
-                            sugestao: typeof MSG.executorWithoutDescriptionSugestao === 'function' ? MSG.executorWithoutDescriptionSugestao() : MSG.executorWithoutDescriptionSugestao
+                            sugestao: typeof MSG.executorWithoutDescriptionSugestao === 'function' ? (MSG.executorWithoutDescriptionSugestao)() : MSG.executorWithoutDescriptionSugestao
                         }));
                         break;
                     }
                 }
             }
+            // Command parameter analysis
             const commands = config.commands;
             if (commands) {
                 for (const [_cmdName, cmdDef] of Object.entries(commands)) {
-                    if (cmdDef && !('parameters' in cmdDef)) {
+                    if (!('parameters' in cmdDef)) {
                         ocorrencias.push(criarOcorrencia({
                             tipo: 'circleci-command-no-parameters',
                             nivel: 'info',
-                            mensagem: typeof MSG.commandWithoutParameters === 'function' ? MSG.commandWithoutParameters() : MSG.commandWithoutParameters,
+                            mensagem: typeof MSG.commandWithoutParameters === 'function' ? (MSG.commandWithoutParameters)() : MSG.commandWithoutParameters,
                             relPath, linha: 1,
-                            sugestao: typeof MSG.commandWithoutParametersSugestao === 'function' ? MSG.commandWithoutParametersSugestao() : MSG.commandWithoutParametersSugestao
+                            sugestao: typeof MSG.commandWithoutParametersSugestao === 'function' ? (MSG.commandWithoutParametersSugestao)() : MSG.commandWithoutParametersSugestao
                         }));
                         break;
                     }
                 }
             }
+            // Workflow count and naming
             const workflows = config.workflows;
             if (workflows) {
                 const wfNames = Object.keys(workflows);
@@ -104,9 +108,9 @@ export const detectorCircleCIEstrutura = {
                     ocorrencias.push(criarOcorrencia({
                         tipo: 'circleci-too-many-workflows',
                         nivel: 'info',
-                        mensagem: typeof MSG.tooManyWorkflows === 'function' ? MSG.tooManyWorkflows() : MSG.tooManyWorkflows,
+                        mensagem: typeof MSG.tooManyWorkflows === 'function' ? (MSG.tooManyWorkflows)() : MSG.tooManyWorkflows,
                         relPath, linha: 1,
-                        sugestao: typeof MSG.tooManyWorkflowsSugestao === 'function' ? MSG.tooManyWorkflowsSugestao() : MSG.tooManyWorkflowsSugestao
+                        sugestao: typeof MSG.tooManyWorkflowsSugestao === 'function' ? (MSG.tooManyWorkflowsSugestao)() : MSG.tooManyWorkflowsSugestao
                     }));
                 }
                 for (const wfName of wfNames) {
@@ -114,24 +118,26 @@ export const detectorCircleCIEstrutura = {
                         ocorrencias.push(criarOcorrencia({
                             tipo: 'circleci-workflow-no-name',
                             nivel: 'info',
-                            mensagem: typeof MSG.missingWorkflowName === 'function' ? MSG.missingWorkflowName() : MSG.missingWorkflowName,
+                            mensagem: typeof MSG.missingWorkflowName === 'function' ? (MSG.missingWorkflowName)() : MSG.missingWorkflowName,
                             relPath, linha: 1,
-                            sugestao: typeof MSG.missingWorkflowNameSugestao === 'function' ? MSG.missingWorkflowNameSugestao() : MSG.missingWorkflowNameSugestao
+                            sugestao: typeof MSG.missingWorkflowNameSugestao === 'function' ? (MSG.missingWorkflowNameSugestao)() : MSG.missingWorkflowNameSugestao
                         }));
                     }
                 }
             }
-            if (jobs?.jobs && workflows) {
+            // Orphaned job detection
+            if (jobs.jobs && workflows) {
                 const wfValues = Object.values(workflows);
                 const usedJobs = new Set();
                 for (const wf of wfValues) {
-                    if (wf && typeof wf === 'object') {
+                    if (typeof wf === 'object') {
                         const wfJobs = wf.jobs;
                         if (Array.isArray(wfJobs)) {
                             for (const wfJob of wfJobs) {
-                                if (typeof wfJob === 'string')
+                                if (typeof wfJob === 'string') {
                                     usedJobs.add(wfJob);
-                                else if (wfJob && typeof wfJob === 'object') {
+                                }
+                                else if (typeof wfJob === 'object') {
                                     Object.keys(wfJob).forEach(k => usedJobs.add(k));
                                 }
                             }
@@ -143,34 +149,36 @@ export const detectorCircleCIEstrutura = {
                         ocorrencias.push(criarOcorrencia({
                             tipo: 'circleci-orphaned-job',
                             nivel: 'aviso',
-                            mensagem: typeof MSG.orphanedJob === 'function' ? MSG.orphanedJob() : MSG.orphanedJob,
+                            mensagem: typeof MSG.orphanedJob === 'function' ? (MSG.orphanedJob)() : MSG.orphanedJob,
                             relPath, linha: 1,
-                            sugestao: typeof MSG.orphanedJobSugestao === 'function' ? MSG.orphanedJobSugestao() : MSG.orphanedJobSugestao
+                            sugestao: typeof MSG.orphanedJobSugestao === 'function' ? (MSG.orphanedJobSugestao)() : MSG.orphanedJobSugestao
                         }));
                     }
                 }
             }
-            if (jobs?.jobs) {
+            // Resource class pricing consideration
+            if (jobs.jobs) {
                 for (const [, job] of Object.entries(jobs.jobs)) {
-                    if (job && 'resource_class' in job === false && job.steps && job.steps.length > 5) {
+                    if (!('resource_class' in job) && job.steps && job.steps.length > 5) {
                         ocorrencias.push(criarOcorrencia({
                             tipo: 'circleci-resource-class-pricing',
                             nivel: 'info',
-                            mensagem: typeof MSG.missingResourceClassPricing === 'function' ? MSG.missingResourceClassPricing() : MSG.missingResourceClassPricing,
+                            mensagem: typeof MSG.missingResourceClassPricing === 'function' ? (MSG.missingResourceClassPricing)() : MSG.missingResourceClassPricing,
                             relPath, linha: 1,
-                            sugestao: typeof MSG.missingResourceClassPricingSugestao === 'function' ? MSG.missingResourceClassPricingSugestao() : MSG.missingResourceClassPricingSugestao
+                            sugestao: typeof MSG.missingResourceClassPricingSugestao === 'function' ? (MSG.missingResourceClassPricingSugestao)() : MSG.missingResourceClassPricingSugestao
                         }));
                         break;
                     }
                 }
             }
+            // Compliance checks via regex
             if (!/circleci config validate|circleci config process|config validation/i.test(src)) {
                 ocorrencias.push(criarOcorrencia({
                     tipo: 'circleci-missing-config-validation',
                     nivel: 'info',
-                    mensagem: typeof MSG.missingConfigValidation === 'function' ? MSG.missingConfigValidation() : MSG.missingConfigValidation,
+                    mensagem: typeof MSG.missingConfigValidation === 'function' ? (MSG.missingConfigValidation)() : MSG.missingConfigValidation,
                     relPath, linha: 1,
-                    sugestao: typeof MSG.missingConfigValidationSugestao === 'function' ? MSG.missingConfigValidationSugestao() : MSG.missingConfigValidationSugestao
+                    sugestao: typeof MSG.missingConfigValidationSugestao === 'function' ? (MSG.missingConfigValidationSugestao)() : MSG.missingConfigValidationSugestao
                 }));
             }
             const hasNotify = /notify:|slack|email|webhook/i.test(src);
@@ -179,9 +187,9 @@ export const detectorCircleCIEstrutura = {
                 ocorrencias.push(criarOcorrencia({
                     tipo: 'circleci-missing-post-steps',
                     nivel: 'info',
-                    mensagem: typeof MSG.missingPostSteps === 'function' ? MSG.missingPostSteps() : MSG.missingPostSteps,
+                    mensagem: typeof MSG.missingPostSteps === 'function' ? (MSG.missingPostSteps)() : MSG.missingPostSteps,
                     relPath, linha: 1,
-                    sugestao: typeof MSG.missingPostStepsSugestao === 'function' ? MSG.missingPostStepsSugestao() : MSG.missingPostStepsSugestao
+                    sugestao: typeof MSG.missingPostStepsSugestao === 'function' ? (MSG.missingPostStepsSugestao)() : MSG.missingPostStepsSugestao
                 }));
             }
             const hasDepInstall = /\b(npm install|yarn install|pnpm install|bundle install|pip install|go mod download|mvn install|gradle build)\b/i.test(src);
@@ -189,24 +197,23 @@ export const detectorCircleCIEstrutura = {
                 ocorrencias.push(criarOcorrencia({
                     tipo: 'circleci-missing-cache-strategy',
                     nivel: 'aviso',
-                    mensagem: typeof MSG.missingCacheStrategy === 'function' ? MSG.missingCacheStrategy() : MSG.missingCacheStrategy,
+                    mensagem: typeof MSG.missingCacheStrategy === 'function' ? (MSG.missingCacheStrategy)() : MSG.missingCacheStrategy,
                     relPath, linha: 1,
-                    sugestao: typeof MSG.missingCacheStrategySugestao === 'function' ? MSG.missingCacheStrategySugestao() : MSG.missingCacheStrategySugestao
+                    sugestao: typeof MSG.missingCacheStrategySugestao === 'function' ? (MSG.missingCacheStrategySugestao)() : MSG.missingCacheStrategySugestao
                 }));
             }
-            const checkoutCount = (src.match(/checkout:/g) || []).length;
+            const checkoutCount = (src.match(/checkout:/g) ?? []).length;
             if (checkoutCount > 1 && !/when:|condition:|branches:/i.test(src)) {
                 ocorrencias.push(criarOcorrencia({
                     tipo: 'circleci-multiple-checkout-no-condition',
                     nivel: 'info',
-                    mensagem: typeof MSG.multipleCheckoutWithoutCondition === 'function' ? MSG.multipleCheckoutWithoutCondition() : MSG.multipleCheckoutWithoutCondition,
+                    mensagem: typeof MSG.multipleCheckoutWithoutCondition === 'function' ? (MSG.multipleCheckoutWithoutCondition)() : MSG.multipleCheckoutWithoutCondition,
                     relPath, linha: 1,
-                    sugestao: typeof MSG.multipleCheckoutWithoutConditionSugestao === 'function' ? MSG.multipleCheckoutWithoutConditionSugestao() : MSG.multipleCheckoutWithoutConditionSugestao
+                    sugestao: typeof MSG.multipleCheckoutWithoutConditionSugestao === 'function' ? (MSG.multipleCheckoutWithoutConditionSugestao)() : MSG.multipleCheckoutWithoutConditionSugestao
                 }));
             }
         }
-        catch { }
+        catch { /* silent parse fail */ }
         return ocorrencias;
     }
 };
-//# sourceMappingURL=detector-circleci-structure.js.map

package/dist/analysts/circleci/detectors/index.js

@@ -1,4 +1,4 @@
+// SPDX-License-Identifier: MIT
 export * from './detector-circleci-performance.js';
 export * from './detector-circleci-security.js';
 export * from './detector-circleci-structure.js';
-//# sourceMappingURL=index.js.map

package/dist/analysts/circleci/index.js

@@ -1,6 +1,9 @@
+// SPDX-License-Identifier: MIT
+/**
+ * [BUSCA] Analistas de CircleCI
+ */
 export * from './analysts/analyst-circleci.js';
 export * from './corrections/index.js';
 export * from './detectors/index.js';
 export * from './reports/index.js';
 export * from './scorers/index.js';
-//# sourceMappingURL=index.js.map

package/dist/analysts/circleci/reports/generator-report-circleci.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import fs from 'node:fs';
 import path from 'node:path';
 import { messages } from '../../../core/messages/index.js';
@@ -6,36 +7,39 @@ export function gerarRelatorioJson(dados) {
 }
 export function gerarRelatorioMarkdown(dados, opcoes) {
     const linhas = [];
-    const titulo = opcoes?.titulo || 'Relatório de Análise - CircleCI';
+    const titulo = opcoes?.titulo ?? 'Relatório de Análise - CircleCI';
     linhas.push(`# ${titulo}`, '', `**Repositório:** ${dados.nomeRepositorio}`, `**Data:** ${dados.dataAnalise}`, `**Tempo:** ${dados.tempoAnaliseMs}ms`, '');
     linhas.push('## Resumo', '', '| Métrica | Valor |', '|---|---|', `| Score Geral | ${dados.scoreGeral}/100 |`, `| Total de Configs | ${dados.totalConfigs} |`, `| Total de Ocorrências | ${dados.ocorrencias.length} |`, '');
     linhas.push('## Severidade', '', '| Severidade | Quantidade |', '|---|---|');
-    for (const [sev, count] of Object.entries(dados.resumoPorSeveridade))
+    for (const [sev, count] of Object.entries(dados.resumoPorSeveridade)) {
         linhas.push(`| ${sev} | ${count} |`);
+    }
     linhas.push('', '## Configs Analisadas', '', '| Config | Score | Ocorrências |', '|---|---|---|');
-    for (const c of dados.configs)
+    for (const c of dados.configs) {
         linhas.push(`| ${c.nome} | ${c.score}/100 | ${c.ocorrencias} |`);
+    }
     if (opcoes?.incluirDetalhes !== false && dados.ocorrencias.length > 0) {
         linhas.push('', '## Ocorrências Detalhadas', '', '| Arquivo | Linha | Severidade | Tipo | Mensagem |', '|---|---|---|---|---|');
         for (const o of dados.ocorrencias.slice(0, 200)) {
-            linhas.push(`| \`${o.relPath}\` | ${o.linha || '-'} | ${o.nivel || 'info'} | ${o.tipo || ''} | ${(o.mensagem || '').replace(/\|/g, '\\|').replace(/\n/g, ' ')} |`);
+            linhas.push(`| \`${o.relPath}\` | ${o.linha ?? '-'} | ${o.nivel ?? 'info'} | ${o.tipo ?? ''} | ${(o.mensagem || '').replace(/\|/g, '\\|').replace(/\n/g, ' ')} |`);
         }
     }
     linhas.push('', '*Gerado por Mahoraga v0.7.0*');
     return linhas.join('\n');
 }
 export function gerarRelatorioHtml(dados, opcoes) {
-    const titulo = opcoes?.titulo || 'Relatório de Análise - CircleCI';
+    const titulo = opcoes?.titulo ?? 'Relatório de Análise - CircleCI';
     const sc = dados.scoreGeral >= 80 ? '#10b981' : dados.scoreGeral >= 50 ? '#f59e0b' : '#ef4444';
-    return `<!DOCTYPE html><html lang="pt-BR"><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width,initial-scale=1.0"><title>${titulo}</title><style>*{margin:0;padding:0;box-sizing:border-box}body{font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;background:#0d1117;color:#c9d1d9;padding:2rem}.container{max-width:1200px;margin:0 auto}h1{color:#343434;margin-bottom:.5rem}h2{color:#343434;margin:2rem 0 1rem;border-bottom:1px solid #21262d;padding-bottom:.5rem}.meta{color:#8b949e;margin-bottom:2rem}.score-card{background:#161b22;border:1px solid #30363d;border-radius:12px;padding:2rem;text-align:center;margin-bottom:2rem}.score-value{font-size:4rem;font-weight:bold;color:${sc}}.score-label{color:#8b949e;font-size:1.2rem}table{width:100%;border-collapse:collapse;margin:1rem 0}th{background:#161b22;color:#343434;padding:.75rem 1rem;text-align:left;border-bottom:2px solid #30363d}td{padding:.75rem 1rem;border-bottom:1px solid #21262d}tr:hover{background:#161b22}.badge{padding:.25rem .5rem;border-radius:12px;font-size:.85rem;font-weight:600}.badge-erro{background:rgba(239,68,68,.2);color:#ef4444}.badge-aviso{background:rgba(245,158,11,.2);color:#f59e0b}.badge-info{background:rgba(56,139,253,.2);color:#388bfd}.summary-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(200px,1fr));gap:1rem;margin:1rem 0}.summary-item{background:#161b22;border:1px solid #30363d;border-radius:8px;padding:1rem}.summary-item .label{color:#8b949e;font-size:.85rem}.summary-item .value{font-size:1.5rem;font-weight:bold;color:#343434}.footer{margin-top:3rem;padding-top:1rem;border-top:1px solid #21262d;color:#8b949e;font-size:.85rem;text-align:center}code{background:#161b22;padding:.2rem .4rem;border-radius:4px;font-family:'JetBrains Mono',monospace;font-size:.9em}</style></head><body><div class="container"><h1>${titulo}</h1><div class="meta"><p><strong>Repositório:</strong> ${dados.nomeRepositorio} | <strong>Data:</strong> ${dados.dataAnalise} | <strong>Tempo:</strong> ${dados.tempoAnaliseMs}ms</p></div><div class="score-card"><div class="score-value">${dados.scoreGeral}</div><div class="score-label">Score Geral (0-100)</div></div><h2>Resumo</h2><div class="summary-grid"><div class="summary-item"><div class="label">Configs</div><div class="value">${dados.totalConfigs}</div></div><div class="summary-item"><div class="label">Ocorrências</div><div class="value">${dados.ocorrencias.length}</div></div>${Object.entries(dados.resumoPorSeveridade).map(([s, c]) => `<div class="summary-item"><div class="label">${s}</div><div class="value">${c}</div></div>`).join('')}</div><h2>Configs</h2><table><thead><tr><th>Config</th><th>Score</th><th>Ocorrências</th></tr></thead><tbody>${dados.configs.map(p => `<tr><td>${p.nome}</td><td style="color:${p.score >= 80 ? '#10b981' : p.score >= 50 ? '#f59e0b' : '#ef4444'};font-weight:bold">${p.score}/100</td><td>${p.ocorrencias}</td></tr>`).join('')}</tbody></table><h2>Ocorrências</h2><table><thead><tr><th>Arquivo</th><th>Linha</th><th>Severidade</th><th>Tipo</th><th>Mensagem</th></tr></thead><tbody>${dados.ocorrencias.slice(0, 200).map(o => `<tr><td><code>${o.relPath}</code></td><td>${o.linha || '-'}</td><td><span class="badge badge-${o.nivel || 'info'}">${o.nivel || 'info'}</span></td><td>${o.tipo || ''}</td><td>${o.mensagem || ''}</td></tr>`).join('')}</tbody></table>${dados.ocorrencias.length > 200 ? `<p style="color:#8b949e;margin-top:1rem">Mostrando 200 de ${dados.ocorrencias.length}</p>` : ''}<div class="footer"><p>Gerado por Mahoraga v0.7.0</p></div></div></body></html>`;
+    return `<!DOCTYPE html><html lang="pt-BR"><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width,initial-scale=1.0"><title>${titulo}</title><style>*{margin:0;padding:0;box-sizing:border-box}body{font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;background:#0d1117;color:#c9d1d9;padding:2rem}.container{max-width:1200px;margin:0 auto}h1{color:#343434;margin-bottom:.5rem}h2{color:#343434;margin:2rem 0 1rem;border-bottom:1px solid #21262d;padding-bottom:.5rem}.meta{color:#8b949e;margin-bottom:2rem}.score-card{background:#161b22;border:1px solid #30363d;border-radius:12px;padding:2rem;text-align:center;margin-bottom:2rem}.score-value{font-size:4rem;font-weight:bold;color:${sc}}.score-label{color:#8b949e;font-size:1.2rem}table{width:100%;border-collapse:collapse;margin:1rem 0}th{background:#161b22;color:#343434;padding:.75rem 1rem;text-align:left;border-bottom:2px solid #30363d}td{padding:.75rem 1rem;border-bottom:1px solid #21262d}tr:hover{background:#161b22}.badge{padding:.25rem .5rem;border-radius:12px;font-size:.85rem;font-weight:600}.badge-erro{background:rgba(239,68,68,.2);color:#ef4444}.badge-aviso{background:rgba(245,158,11,.2);color:#f59e0b}.badge-info{background:rgba(56,139,253,.2);color:#388bfd}.summary-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(200px,1fr));gap:1rem;margin:1rem 0}.summary-item{background:#161b22;border:1px solid #30363d;border-radius:8px;padding:1rem}.summary-item .label{color:#8b949e;font-size:.85rem}.summary-item .value{font-size:1.5rem;font-weight:bold;color:#343434}.footer{margin-top:3rem;padding-top:1rem;border-top:1px solid #21262d;color:#8b949e;font-size:.85rem;text-align:center}code{background:#161b22;padding:.2rem .4rem;border-radius:4px;font-family:'JetBrains Mono',monospace;font-size:.9em}</style></head><body><div class="container"><h1>${titulo}</h1><div class="meta"><p><strong>Repositório:</strong> ${dados.nomeRepositorio} | <strong>Data:</strong> ${dados.dataAnalise} | <strong>Tempo:</strong> ${dados.tempoAnaliseMs}ms</p></div><div class="score-card"><div class="score-value">${dados.scoreGeral}</div><div class="score-label">Score Geral (0-100)</div></div><h2>Resumo</h2><div class="summary-grid"><div class="summary-item"><div class="label">Configs</div><div class="value">${dados.totalConfigs}</div></div><div class="summary-item"><div class="label">Ocorrências</div><div class="value">${dados.ocorrencias.length}</div></div>${Object.entries(dados.resumoPorSeveridade).map(([s, c]) => `<div class="summary-item"><div class="label">${s}</div><div class="value">${c}</div></div>`).join('')}</div><h2>Configs</h2><table><thead><tr><th>Config</th><th>Score</th><th>Ocorrências</th></tr></thead><tbody>${dados.configs.map(p => `<tr><td>${p.nome}</td><td style="color:${p.score >= 80 ? '#10b981' : p.score >= 50 ? '#f59e0b' : '#ef4444'};font-weight:bold">${p.score}/100</td><td>${p.ocorrencias}</td></tr>`).join('')}</tbody></table><h2>Ocorrências</h2><table><thead><tr><th>Arquivo</th><th>Linha</th><th>Severidade</th><th>Tipo</th><th>Mensagem</th></tr></thead><tbody>${dados.ocorrencias.slice(0, 200).map(o => `<tr><td><code>${o.relPath}</code></td><td>${o.linha ?? '-'}</td><td><span class="badge badge-${o.nivel ?? 'info'}">${o.nivel ?? 'info'}</span></td><td>${o.tipo ?? ''}</td><td>${o.mensagem || ''}</td></tr>`).join('')}</tbody></table>${dados.ocorrencias.length > 200 ? `<p style="color:#8b949e;margin-top:1rem">Mostrando 200 de ${dados.ocorrencias.length}</p>` : ''}<div class="footer"><p>Gerado por Mahoraga v0.7.0</p></div></div></body></html>`;
 }
 export function gerarRelatorioCsv(dados) {
     const linhas = ['Arquivo,Linha,Severidade,Tipo,Mensagem,Sugestao'];
-    for (const o of dados.ocorrencias)
-        linhas.push([o.relPath, String(o.linha || ''), o.nivel || 'info', o.tipo || '', `"${(o.mensagem || '').replace(/"/g, '""')}"`, `"${(o.sugestao || '').replace(/"/g, '""')}"`].join(','));
+    for (const o of dados.ocorrencias) {
+        linhas.push([o.relPath, String(o.linha ?? ''), o.nivel ?? 'info', o.tipo ?? '', `"${(o.mensagem || '').replace(/"/g, '""')}"`, `"${(o.sugestao ?? '').replace(/"/g, '""')}"`].join(','));
+    }
     return linhas.join('\n');
 }
-export async function gerarRelatorio(dados, opcoes) {
+export function gerarRelatorio(dados, opcoes) {
     const conteudo = (() => {
         switch (opcoes.formato) {
             case 'json': return gerarRelatorioJson(dados);
@@ -50,15 +54,14 @@ export async function gerarRelatorio(dados, opcoes) {
     return opcoes.output;
 }
 export function prepararDadosRelatorio(ocorrencias, nomeRepositorio, tempoAnaliseMs, configs) {
-    const cList = configs || [];
+    const cList = configs ?? [];
     const resumo = {};
     const resumoTipo = {};
     for (const o of ocorrencias) {
-        const nivel = String(o.nivel || 'info');
+        const nivel = (o.nivel ?? 'info');
         resumo[nivel] = (resumo[nivel] || 0) + 1;
-        resumoTipo[o.tipo || 'desconhecido'] = (resumoTipo[o.tipo || 'desconhecido'] || 0) + 1;
+        resumoTipo[o.tipo ?? 'desconhecido'] = (resumoTipo[o.tipo ?? 'desconhecido'] || 0) + 1;
     }
     const scoreGeral = cList.length > 0 ? Math.round(cList.reduce((s, c) => s + c.score, 0) / cList.length) : Math.max(0, 100 - ocorrencias.length * 5);
     return { nomeRepositorio, dataAnalise: new Date().toISOString(), totalConfigs: cList.length || 1, scoreGeral, ocorrencias, resumoPorSeveridade: resumo, resumoPorTipo: resumoTipo, configs: cList, tempoAnaliseMs };
 }
-//# sourceMappingURL=generator-report-circleci.js.map

package/dist/analysts/circleci/reports/index.js

@@ -1,2 +1,2 @@
+// SPDX-License-Identifier: MIT
 export * from './generator-report-circleci.js';
-//# sourceMappingURL=index.js.map

package/dist/analysts/circleci/scorers/index.js

@@ -1,2 +1,2 @@
+// SPDX-License-Identifier: MIT
 export * from './scorer-circleci.js';
-//# sourceMappingURL=index.js.map

package/dist/analysts/circleci/scorers/scorer-circleci.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { splitLines } from '../../../shared/helpers/index.js';
 export function pontuarCircleCI(src, _relPath) {
     let score = 0;
@@ -6,7 +7,7 @@ export function pontuarCircleCI(src, _relPath) {
     const strengths = [];
     const _linhas = splitLines(src);
     const srcCompleto = src;
-    const hardcodedSecrets = (srcCompleto.match(/\b(TOKEN|SECRET|PASSWORD|KEY|ACCESS_KEY)\b.*:\s*['"][^'"]+['"]/gi) || []).filter(l => !/\$/.test(l)).length;
+    const hardcodedSecrets = (srcCompleto.match(/\b(TOKEN|SECRET|PASSWORD|KEY|ACCESS_KEY)\b.*:\s*['"][^'"]+['"]/gi) ?? []).filter(l => !/\$/.test(l)).length;
     if (hardcodedSecrets === 0) {
         score += 15;
         strengths.push('Sem secrets hardcoded');
@@ -87,7 +88,7 @@ export function pontuarCircleCI(src, _relPath) {
     else {
         issues.push('Documentação de executores ausente');
     }
-    const checkoutCount = (srcCompleto.match(/checkout:/g) || []).length;
+    const checkoutCount = (srcCompleto.match(/checkout:/g) ?? []).length;
     if (!hasDepInstall && checkoutCount <= 1) {
         score += 4;
         strengths.push('Configuração enxuta');
@@ -122,4 +123,3 @@ export const pontuadorCircleCI = {
     descricao: 'Pontua qualidade de CircleCI',
     pontuar: pontuarCircleCI
 };
-//# sourceMappingURL=scorer-circleci.js.map

package/dist/analysts/converters/convert-registry.js

@@ -1,6 +1,5 @@
 import { ConversorGhaToGitlab } from './engines/converter-gha-to-gitlab.js';
 export const registroConversores = [new ConversorGhaToGitlab()];
 export function obterConversor(de, para) {
-    return registroConversores?.find(elem => elem.de?.toLowerCase() === de.toLowerCase() && elem.para?.toLowerCase() === para.toLowerCase());
+    return registroConversores?.find(elem => elem.de.toLowerCase() === de.toLowerCase() && elem.para.toLowerCase() === para.toLowerCase());
 }
-//# sourceMappingURL=convert-registry.js.map

package/dist/analysts/converters/converter-base.js

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: MIT
+/**
+ * [REFRESH] Contrato Base para Conversores de Templates
+ */
 export class ConversorBase {
     criarResultado(conteudo, avisos = [], erros = []) {
         return {
@@ -8,4 +12,3 @@ export class ConversorBase {
         };
     }
 }
-//# sourceMappingURL=converter-base.js.map

package/dist/analysts/converters/engines/converter-gha-to-gitlab.js

@@ -1,3 +1,9 @@
+// SPDX-License-Identifier: MIT
+/**
+ * [LANCAMENTO] Conversor: GitHub Actions [->] GitLab CI
+ *
+ * Realiza o mapeamento best-effort de workflows GHA para pipelines GitLab.
+ */
 import { Document, parseDocument } from 'yaml';
 import { ConversorBase } from '../converter-base.js';
 export class ConversorGhaToGitlab extends ConversorBase {
@@ -12,12 +18,15 @@ export class ConversorGhaToGitlab extends ConversorBase {
                 throw new Error(doc.errors[0].message);
             }
             const gha = doc.toJS();
+            // Estrutura inicial do GitLab CI
             const gitlab = {
                 stages: []
             };
+            // 1. Mapear variáveis globais
             if (gha.env) {
                 gitlab.variables = gha.env;
             }
+            // 2. Mapear Jobs
             if (gha.jobs) {
                 const jobs = gha.jobs;
                 const jobsEntries = Object.entries(jobs);
@@ -29,20 +38,24 @@ export class ConversorGhaToGitlab extends ConversorBase {
                         script: []
                     };
                     stagesSet.add(gitlabJob.stage);
+                    // Mapear Image (executors)
                     if (job['runs-on']) {
                         avisos.push(`Job '${jobId}': Mapeamento de 'runs-on: ${job['runs-on']}' para image do GitLab pode exigir ajuste manual.`);
-                        if (String(job['runs-on']).includes('ubuntu')) {
+                        if (job['runs-on'].includes('ubuntu')) {
                             gitlabJob.image = 'ubuntu:latest';
                         }
                     }
+                    // Mapear Steps
                     if (job.steps && Array.isArray(job.steps)) {
                         const steps = job.steps;
                         for (const step of steps) {
                             if (step.run) {
-                                const cmd = String(step.run).trim();
+                                // Limpar comandos de run (remover multi-line pipe se necessário)
+                                const cmd = step.run.trim();
                                 gitlabJob.script.push(cmd);
                             }
                             else if (step.uses) {
+                                // Tratamento especial para checkout
                                 if (step.uses.includes('actions/checkout')) {
                                     gitlabJob.script.push('# Checkout automático pelo GitLab Runner');
                                 }
@@ -53,13 +66,16 @@ export class ConversorGhaToGitlab extends ConversorBase {
                             }
                         }
                     }
+                    // Mapear dependências (needs)
                     if (job.needs) {
                         gitlabJob.needs = Array.isArray(job.needs) ? job.needs : [job.needs];
                     }
+                    // Adicionar o job ao root
                     gitlab[jobId] = gitlabJob;
                 }
                 gitlab.stages = Array.from(stagesSet);
             }
+            // Gerar YAML final
             const outputDoc = new Document(gitlab);
             return this.criarResultado(outputDoc.toString(), avisos, erros);
         }
@@ -69,4 +85,3 @@ export class ConversorGhaToGitlab extends ConversorBase {
         }
     }
 }
-//# sourceMappingURL=converter-gha-to-gitlab.js.map

package/dist/analysts/converters/engines/index.js

@@ -1,2 +1 @@
 export * from './converter-gha-to-gitlab.js';
-//# sourceMappingURL=index.js.map

package/dist/analysts/converters/index.js

@@ -1,8 +1,14 @@
+// SPDX-License-Identifier: MIT
+/**
+ * [REFRESH] Registro Central de Conversores
+ */
 import { ConversorGhaToGitlab } from './engines/converter-gha-to-gitlab.js';
 export * from './converter-base.js';
 export * from './engines/converter-gha-to-gitlab.js';
 export const registroConversores = [new ConversorGhaToGitlab()];
+/**
+ * Busca um conversor compatível com as plataformas de origem e destino.
+ */
 export function obterConversor(de, para) {
-    return registroConversores?.find(elem => elem.de?.toLowerCase() === de.toLowerCase() && elem.para?.toLowerCase() === para.toLowerCase());
+    return registroConversores?.find(elem => elem.de.toLowerCase() === de.toLowerCase() && elem.para.toLowerCase() === para.toLowerCase());
 }
-//# sourceMappingURL=index.js.map