@mocoto/mahoraga 0.14.1 → 0.14.2

package/dist/analysts/tailwind/detectors/detector-tailwind-best-practices.js

@@ -1,6 +1,27 @@
 // SPDX-License-Identifier: MIT
 import { splitLines } from '../../../shared/helpers/index.js';
 import { criarOcorrencia } from '../../../types/index.js';
+const V3_DEPRECATED_UTILITIES_MAP = {
+    'shadow-sm': 'shadow-xs',
+    'drop-shadow-sm': 'drop-shadow-xs',
+    'blur-sm': 'blur-xs',
+    'backdrop-blur-sm': 'backdrop-blur-xs',
+    'rounded-sm': 'rounded-xs',
+    'outline-none': 'outline-hidden',
+    'flex-shrink': 'shrink',
+    'flex-grow': 'grow',
+    'overflow-ellipsis': 'text-ellipsis',
+    'decoration-slice': 'box-decoration-slice',
+    'decoration-clone': 'box-decoration-clone',
+};
+const V3_SUFFIX_UTILITIES_MAP = {
+    'shadow': 'shadow-sm',
+    'drop-shadow': 'drop-shadow-sm',
+    'blur': 'blur-sm',
+    'backdrop-blur': 'backdrop-blur-sm',
+    'rounded': 'rounded-sm',
+    'ring': 'ring-3',
+};
 const TAILWIND_UTILITIES = new Set([
     'bg-', 'text-', 'm-', 'mt-', 'mr-', 'mb-', 'ml-', 'mx-', 'my-',
     'p-', 'pt-', 'pr-', 'pb-', 'pl-', 'px-', 'py-',
@@ -11,13 +32,16 @@ const TAILWIND_UTILITIES = new Set([
     'transition', 'duration-', 'ease-', 'animate-',
     'z-', 'overflow-', 'cursor-', 'select-', 'blur-',
     'top-', 'left-', 'right-', 'bottom-', 'inset-',
+    'field-sizing-', 'text-shadow-', 'inset-shadow-', 'zoom-', 'perspective-',
+    'outline-', 'drop-shadow-', 'backdrop-blur-',
 ]);
 const TAILWIND_COLORS = [
     'slate', 'gray', 'zinc', 'neutral', 'stone', 'red', 'orange', 'amber',
     'yellow', 'lime', 'green', 'emerald', 'teal', 'cyan', 'sky', 'blue',
     'indigo', 'violet', 'purple', 'fuchsia', 'pink', 'rose',
+    'mauve', 'olive', 'mist', 'taupe',
 ];
-function _isTailwindColor(value) {
+function isTailwindColor(value) {
     return TAILWIND_COLORS.some(c => value.includes(c));
 }
 function getPropertyKey(token) {
@@ -45,12 +69,27 @@ function getPropertyKey(token) {
     if (/^opacity/.test(token)) {
         return 'opacity';
     }
+    if (/^field-sizing/.test(token)) {
+        return 'field-sizing';
+    }
+    if (/^text-shadow/.test(token)) {
+        return 'text-shadow';
+    }
+    if (/^inset-shadow/.test(token)) {
+        return 'inset-shadow';
+    }
+    if (/^zoom/.test(token)) {
+        return 'zoom';
+    }
+    if (/^perspective/.test(token)) {
+        return 'perspective';
+    }
     return null;
 }
 export const detectorTailwindBestPractices = {
     nome: 'detector-tailwind-best-practices',
     categoria: 'estilo',
-    descricao: 'Detecta más práticas em Tailwind CSS',
+    descricao: 'Detecta más práticas em Tailwind CSS v4',
     test: (relPath) => /\.(jsx|tsx|js|ts|html|astro)$/i.test(relPath),
     aplicar: (src, relPath) => {
         if (!src) {
@@ -62,10 +101,86 @@ export const detectorTailwindBestPractices = {
         let inlineStyleCount = 0;
         linhas.forEach((linha, index) => {
             const numeroLinha = index + 1;
-            if (/\bclass(Name)?\s*=\s*["'][^"']*["']/.test(linha)) {
+            if (/@tailwind\s+(base|components|utilities)/.test(linha)) {
+                ocorrencias.push(criarOcorrencia({
+                    tipo: 'tailwind-v3-directive',
+                    nivel: 'aviso',
+                    mensagem: 'Diretiva @tailwind detectada (v3) - use @import "tailwindcss"',
+                    relPath,
+                    linha: numeroLinha,
+                    sugestao: 'Substitua @tailwind base/components/utilities por @import "tailwindcss"'
+                }));
+            }
+            if (/@layer\s+utilities\s*\{/.test(linha)) {
+                ocorrencias.push(criarOcorrencia({
+                    tipo: 'tailwind-v3-layer-utilities',
+                    nivel: 'info',
+                    mensagem: '@layer utilities detectado (v3) - use @utility (v4)',
+                    relPath,
+                    linha: numeroLinha,
+                    sugestao: 'Use @utility nome-da-utilidade { ... } ao invés de @layer utilities { ... }'
+                }));
+            }
+            if (/\btheme\(/.test(linha)) {
+                ocorrencias.push(criarOcorrencia({
+                    tipo: 'tailwind-theme-function',
+                    nivel: 'info',
+                    mensagem: 'theme() detectado (deprecated v3) - use CSS variables',
+                    relPath,
+                    linha: numeroLinha,
+                    sugestao: 'Substitua theme(colors.red.500) por var(--color-red-500)'
+                }));
+            }
+            if (/\bclass(Name)?\s*=\s*["'][^"']*![\w-]/.test(linha)) {
+                ocorrencias.push(criarOcorrencia({
+                    tipo: 'tailwind-important-prefix',
+                    nivel: 'info',
+                    mensagem: '!important como prefixo (v3) - mova ! para o final da classe',
+                    relPath,
+                    linha: numeroLinha,
+                    sugestao: 'Use "flex!" ao invés de "!flex"'
+                }));
+            }
+            if (/\bclass(Name)?\s*=\s*["'][^"']*\[--[^\]]+\]/.test(linha)) {
+                ocorrencias.push(criarOcorrencia({
+                    tipo: 'tailwind-arbitrary-var-syntax',
+                    nivel: 'info',
+                    mensagem: 'Variável em colchetes (v3) - use parênteses (v4)',
+                    relPath,
+                    linha: numeroLinha,
+                    sugestao: 'Use bg-(--brand-color) ao invés de bg-[--brand-color]'
+                }));
+            }
+            if (/\bclass(Name)?\s*=\s*["']([^"']*)["']/.test(linha)) {
                 const classMatch = linha.match(/\bclass(Name)?\s*=\s*["']([^"']*)["']/);
                 if (classMatch) {
                     const classes = classMatch[2].split(/\s+/).filter(Boolean);
+                    for (const cls of classes) {
+                        const v4Equivalent = V3_DEPRECATED_UTILITIES_MAP[cls];
+                        if (v4Equivalent) {
+                            ocorrencias.push(criarOcorrencia({
+                                tipo: 'tailwind-v3-deprecated-utility',
+                                nivel: 'aviso',
+                                mensagem: `Classe obsoleta do v3: "${cls}" → use "${v4Equivalent}"`,
+                                relPath,
+                                linha: numeroLinha,
+                                sugestao: `Substitua ${cls} por ${v4Equivalent}`
+                            }));
+                        }
+                        const baseClass = cls.split(':').pop() ?? cls;
+                        if (baseClass && V3_SUFFIX_UTILITIES_MAP[baseClass]) {
+                            const variante = cls.endsWith(baseClass) ? '' : cls.slice(0, -baseClass.length);
+                            const v4Suffix = V3_SUFFIX_UTILITIES_MAP[baseClass];
+                            ocorrencias.push(criarOcorrencia({
+                                tipo: 'tailwind-v3-deprecated-utility',
+                                nivel: 'aviso',
+                                mensagem: `Classe renomeada no v4: "${cls}" → use "${variante}${v4Suffix}"`,
+                                relPath,
+                                linha: numeroLinha,
+                                sugestao: `Substitua ${cls} por ${variante}${v4Suffix} (ex: shadow → shadow-sm)`
+                            }));
+                        }
+                    }
                     const seen = new Map();
                     classes.forEach(token => {
                         const base = token.split(':').pop() ?? token;
@@ -139,7 +254,7 @@ export const detectorTailwindBestPractices = {
                     }
                     const hardcodedValues = classes.filter(c => {
                         const val = c.split('-').pop() ?? '';
-                        return /^\d+$/.test(val) && !TAILWIND_COLORS.some(col => c.includes(col)) && val.length > 2;
+                        return /^\d+$/.test(val) && !isTailwindColor(c) && val.length > 2;
                     });
                     if (hardcodedValues.length > 0 && !hardcodedValues.some(v => /^[0-9]+\/[0-9]+$/.test(v))) {
                         ocorrencias.push(criarOcorrencia({
@@ -148,7 +263,7 @@ export const detectorTailwindBestPractices = {
                             mensagem: 'Valor hardcoded detectado - use tokens de design do Tailwind',
                             relPath,
                             linha: numeroLinha,
-                            sugestao: 'Extraia cores, espaçamentos e tamanhos para o tailwind.config.js'
+                            sugestao: 'Extraia cores, espaçamentos e tamanhos para @theme no CSS (v4)'
                         }));
                     }
                 }
@@ -166,7 +281,7 @@ export const detectorTailwindBestPractices = {
                                     mensagem: `Valor arbitrário detectado: ${val}`,
                                     relPath,
                                     linha: numeroLinha,
-                                    sugestao: 'Considere adicionar ao tailwind.config.js'
+                                    sugestao: 'Considere adicionar ao @theme no CSS (v4)'
                                 }));
                             }
                         }
@@ -204,7 +319,7 @@ export const detectorTailwindBestPractices = {
                 mensagem: 'Uso excessivo de valores arbitrários - pode indicar falta de tokens de design',
                 relPath,
                 linha: 1,
-                sugestao: 'Defina tokens personalizados em tailwind.config.js ao invés de valores arbitrários'
+                sugestao: 'Defina tokens personalizados via @theme no CSS ao invés de valores arbitrários'
             }));
         }
         return ocorrencias;

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

@@ -1,17 +1,36 @@
 // SPDX-License-Identifier: MIT
 import { splitLines } from '../../../shared/helpers/index.js';
+const V3_DEPRECATED_MAP = {
+    'shadow-sm': 'shadow-xs',
+    'drop-shadow-sm': 'drop-shadow-xs',
+    'blur-sm': 'blur-xs',
+    'rounded-sm': 'rounded-xs',
+    'outline-none': 'outline-hidden',
+    'flex-shrink': 'shrink',
+    'flex-grow': 'grow',
+    'overflow-ellipsis': 'text-ellipsis',
+    'decoration-slice': 'box-decoration-slice',
+    'decoration-clone': 'box-decoration-clone',
+};
 export function pontuarTailwind(src, _relPath) {
     let score = 0;
     const maxScore = 100;
     const issues = [];
     const strengths = [];
-    const _linhas = splitLines(src);
     const srcCompleto = src;
     const classMatches = srcCompleto.match(/\bclass(Name)?\s*=\s*["']([^"']*)["']/g) ?? [];
     const allClasses = classMatches.map(metrica => {
         const match = metrica.match(/["']([^"']*)["']/);
         return match ? match[1].split(/\s+/).filter(Boolean) : [];
     }).flat();
+    const v3Deprecated = allClasses.filter(c => V3_DEPRECATED_MAP[c] !== undefined);
+    if (v3Deprecated.length === 0) {
+        score += 5;
+        strengths.push('Sem classes obsoletas do v3');
+    }
+    else {
+        issues.push(`${v3Deprecated.length} classe(s) obsoleta(s) do v3 detectadas: ${v3Deprecated.map(c => `${c}→${V3_DEPRECATED_MAP[c]}`).join(', ')}`);
+    }
     const duplicates = allClasses.filter((elem, indice) => allClasses.indexOf(elem) !== indice);
     if (duplicates.length === 0) {
         score += 10;
@@ -55,7 +74,7 @@ export function pontuarTailwind(src, _relPath) {
     }
     else {
         score += 2;
-        issues.push(`${arbitraryValues.length} valores arbitrários - considere tailwind.config.js`);
+        issues.push(`${arbitraryValues.length} valores arbitrários - considere @theme no CSS`);
     }
     const importantCount = (srcCompleto.match(/class(Name)?=.*!/g) ?? []).length;
     if (importantCount === 0) {
@@ -123,15 +142,48 @@ export function pontuarTailwind(src, _relPath) {
     else {
         issues.push(`Média de ${avgClasses.toFixed(1)} classes por elemento - considere extrair componentes`);
     }
-    const customCssPatterns = (srcCompleto.match(/@apply|@layer|@tailwind/g) ?? []).length;
-    if (customCssPatterns > 0) {
+    const hasThemeDirective = /@theme\b/.test(srcCompleto);
+    const hasConfigRef = /\btailwind\.config|\b@config\b/.test(srcCompleto);
+    if (hasThemeDirective) {
         score += 5;
-        strengths.push('Uso de @apply para estilos customizados');
+        strengths.push('Uso de @theme para design tokens (v4)');
     }
-    const designTokensInConfig = /\btailwind\.config/.test(srcCompleto);
-    if (designTokensInConfig) {
-        score += 5;
-        strengths.push('Design tokens configurados');
+    else if (hasConfigRef) {
+        score += 2;
+        issues.push('Use @theme no CSS ao invés de tailwind.config.js (v4)');
+    }
+    else {
+        score += 3;
+    }
+    const hasImportTailwindcss = /@import\s+["']tailwindcss["']/.test(srcCompleto);
+    const hasTailwindDirective = /@tailwind\s+(base|components|utilities)/.test(srcCompleto);
+    if (hasImportTailwindcss) {
+        score += 3;
+        strengths.push('Importa Tailwind via @import "tailwindcss" (v4)');
+    }
+    else if (hasTailwindDirective) {
+        issues.push('Use @import "tailwindcss" ao invés de @tailwind (v4)');
+    }
+    const hasUtilityDirective = /@utility\b/.test(srcCompleto);
+    const hasLayerUtilities = /@layer\s+utilities/.test(srcCompleto);
+    if (hasUtilityDirective) {
+        score += 4;
+        strengths.push('Uso de @utility para custom utilities (v4)');
+    }
+    else if (hasLayerUtilities) {
+        issues.push('Use @utility ao invés de @layer utilities (v4)');
+    }
+    const v3ImportantPrefix = (srcCompleto.match(/class(Name)?\s*=\s*["'][^"']*![\w-]/g) ?? []).length;
+    if (v3ImportantPrefix > 0) {
+        issues.push(`${v3ImportantPrefix} uso(s) de ! como prefixo (v3) - mova ! para o final (ex: flex! no lugar de !flex)`);
+    }
+    const v3VariableArbitrary = (srcCompleto.match(/\[--[^\]]+\]/g) ?? []).length;
+    if (v3VariableArbitrary > 0) {
+        issues.push(`${v3VariableArbitrary} variável(is) em colchetes - use bg-(--var) ao invés de bg-[--var] (v4)`);
+    }
+    const themeFunction = (srcCompleto.match(/\btheme\(/g) ?? []).length;
+    if (themeFunction > 0) {
+        issues.push(`${themeFunction} uso(s) de theme() - prefira CSS variables (var(--color-*)) (v4)`);
     }
     return {
         score: Math.min(score, maxScore),
@@ -144,6 +196,6 @@ export function pontuarTailwind(src, _relPath) {
 export const pontuadorTailwind = {
     nome: 'pontuador-tailwind',
     categoria: 'estilo',
-    descricao: 'Pontua qualidade de Tailwind CSS',
+    descricao: 'Pontua qualidade de Tailwind CSS v4',
     pontuar: pontuarTailwind
 };

package/dist/analysts/xml/analysts/analyst-xml.js

@@ -147,7 +147,7 @@ function collectXmlIssues(src, relPath) {
     }
     // DOCTYPE + ENTITY (XXE)
     for (const metrica of scan.matchAll(/<!DOCTYPE\b[\s\S]*?(?:\]\s*>|>)/gi)) {
-        const chunk = metrica[0] ?? '';
+        const chunk = metrica[0];
         const hasExternalId = /\b(SYSTEM|PUBLIC)\b/i.test(chunk);
         const line = lineOf(metrica.index);
         ocorrencias.push(warn(messages.XmlMensagens.doctypeDetectado, relPath, line));
@@ -156,7 +156,7 @@ function collectXmlIssues(src, relPath) {
         }
     }
     for (const metrica of scan.matchAll(/<!ENTITY\b[\s\S]*?>/gi)) {
-        const chunk = metrica[0] ?? '';
+        const chunk = metrica[0];
         const hasExternal = /\b(SYSTEM|PUBLIC)\b/i.test(chunk);
         const isParamEntity = /<!ENTITY\s+%/i.test(chunk);
         const line = lineOf(metrica.index);

package/dist/app/index.js

@@ -0,0 +1 @@
+export * from './github.js';

package/dist/bin/cli-bootstrap.js

@@ -35,9 +35,11 @@ async function registrarLoader() {
         const loaderCaminho = resolvePath(distRaiz, 'node.loader.js');
         const loaderUrl = pathToFileURL(loaderCaminho).toString();
         // Tenta registrar o loader via API experimental da v20+
-        const { register } = await import('node:module');
-        if (typeof register === 'function') {
-            register(loaderUrl, pathToFileURL('./'));
+        const moduleImport = await import('node:module');
+        const registerHooks = moduleImport.registerHooks;
+        if (typeof registerHooks === 'function') {
+            const hooks = await import(loaderUrl);
+            registerHooks(hooks);
         }
     }
     catch (err) {
@@ -170,7 +172,7 @@ export async function mainCli() {
         log.debug(CliBinMensagens.erroInicializarFormatadores.replace('{erro}', err instanceof Error ? err.message : String(err)));
     }
     // 4. Registro de Comandos
-    registrarComandos(program, ocorrencia => aplicarFlagsGlobais(ocorrencia));
+    registrarComandos(program, ocorrencia => void aplicarFlagsGlobais(ocorrencia));
     program.addCommand(comandoPerf());
     // 5. Flags de histórico
     const argv = process.argv.slice(2);

package/dist/bin/index.js

@@ -35,9 +35,11 @@ async function registrarLoader() {
         const loaderCaminho = resolvePath(distRaiz, 'node.loader.js');
         const loaderUrl = pathToFileURL(loaderCaminho).toString();
         // Tenta registrar o loader via API experimental da v20+
-        const { register } = await import('node:module');
-        if (typeof register === 'function') {
-            register(loaderUrl, pathToFileURL('./'));
+        const moduleImport = await import('node:module');
+        const registerHooks = moduleImport.registerHooks;
+        if (typeof registerHooks === 'function') {
+            const hooks = await import(loaderUrl);
+            registerHooks(hooks);
         }
     }
     catch (err) {
@@ -170,7 +172,7 @@ export async function mainCli() {
         log.debug(CliBinMensagens.erroInicializarFormatadores.replace('{erro}', err instanceof Error ? err.message : String(err)));
     }
     // 4. Registro de Comandos
-    registrarComandos(program, ocorrencia => aplicarFlagsGlobais(ocorrencia));
+    registrarComandos(program, ocorrencia => void aplicarFlagsGlobais(ocorrencia));
     program.addCommand(comandoPerf());
     // 5. Flags de histórico
     const argv = process.argv.slice(2);

package/dist/caretakers/scoring.js

@@ -1 +1,2 @@
+// Tipos mínimos para o zelador de pontuação
 export {};

package/dist/cli/commands/command-analysts.js

@@ -56,7 +56,7 @@ export function comandoAnalistas() {
                     geradoEm: new Date().toISOString(),
                     total: lista.length,
                     analistas: lista,
-                    configLimites: config.ANALISE_LIMITES ?? {}
+                    configLimites: config.ANALISE_LIMITES
                 });
                 log.sucesso(messages.CliComandoAnalistasMensagens.jsonExportado(destino));
                 return;

package/dist/cli/commands/command-azure.js

@@ -73,7 +73,7 @@ export function comandoAzure() {
                     console.log('');
                     ocorrencias.forEach((ocorrencia) => {
                         const prefix = ocorrencia.nivel === 'erro' ? '[RED]' : ocorrencia.nivel === 'aviso' ? '[YELLOW]' : '[BLUE]';
-                        log.info(msgs.ocorrencia(prefix, ocorrencia.tipo ?? '', ocorrencia.linha ?? 0, ocorrencia.mensagem ?? ''));
+                        log.info(msgs.ocorrencia(prefix, ocorrencia.tipo ?? '', ocorrencia.linha ?? 0, ocorrencia.mensagem));
                         if (ocorrencia.sugestao) {
                             log.info(msgs.sugestao(ocorrencia.sugestao));
                         }

package/dist/cli/commands/command-circleci.js

@@ -69,7 +69,7 @@ export function comandoCircleCI() {
                     console.log('');
                     ocorrencias.forEach(ocorrencia => {
                         const prefix = ocorrencia.nivel === 'erro' ? '[RED]' : ocorrencia.nivel === 'aviso' ? '[YELLOW]' : '[BLUE]';
-                        log.info(msgs.ocorrencia(prefix, ocorrencia.tipo ?? '', ocorrencia.linha ?? 0, ocorrencia.mensagem ?? ''));
+                        log.info(msgs.ocorrencia(prefix, ocorrencia.tipo ?? '', ocorrencia.linha ?? 0, ocorrencia.mensagem));
                         if (ocorrencia.sugestao) {
                             log.info(msgs.sugestao(ocorrencia.sugestao));
                         }

package/dist/cli/commands/command-compliance.js

@@ -28,7 +28,7 @@ export function comandoCompliance() {
         }
         const { processarDiagnostico } = await import('../diagnostic/index.js');
         const resultado = await processarDiagnostico({ json: true });
-        const ocorrencias = resultado.resultadoFinal.ocorrencias ?? [];
+        const ocorrencias = resultado.resultadoFinal.ocorrencias;
         const relatorio = gerarRelatorioCompliance(framework, ocorrencias, {
             nomeProjeto: process.cwd().split('/').pop() ?? 'projeto',
             duracao: resultado.resultadoFinal.metricas.tempoTotal ?? 0,

package/dist/cli/commands/command-diagnose.js

@@ -44,10 +44,6 @@ async function mostrarSugestoesVerbose(opts, command, logNivel) {
         const activeFlags = [];
         const details = [];
         const parentOpts = obterOptsParent(command);
-        if (json) {
-            activeFlags.push('--json');
-            details.push(messages.CliComandoDiagnosticarMensagens.detalheSaidaEstruturada);
-        }
         if (Boolean(opts['guardianCheck'])) {
             activeFlags.push('--guardian-check');
             details.push(messages.CliComandoDiagnosticarMensagens.detalheGuardian);
@@ -81,28 +77,29 @@ async function mostrarSugestoesVerbose(opts, command, logNivel) {
             activeFlags.push('--auto-fix-conservative');
             details.push(messages.CliComandoDiagnosticarMensagens.detalheAutoFixConservative);
         }
-        const includes = opts['include'] || [];
-        const excludes = opts['exclude'] || [];
+        const includes = opts['include'];
+        const excludes = opts['exclude'];
         if (includes.length) {
             details.push(messages.CliComandoDiagnosticarMensagens.detalheIncludePatterns(includes.length, includes.join(', ')));
         }
         if (excludes.length) {
             details.push(messages.CliComandoDiagnosticarMensagens.detalheExcludePatterns(excludes.length, excludes.join(', ')));
         }
-        const parentExport = (parentOpts && Object.prototype.hasOwnProperty.call(parentOpts, 'export') && Boolean(parentOpts['export']));
-        const parentExportFull = (parentOpts && Object.prototype.hasOwnProperty.call(parentOpts, 'exportFull') && Boolean(parentOpts['exportFull']));
+        const parentExport = (Object.prototype.hasOwnProperty.call(parentOpts, 'export') && Boolean(parentOpts['export']));
+        const parentExportFull = (Object.prototype.hasOwnProperty.call(parentOpts, 'exportFull') && Boolean(parentOpts['exportFull']));
         const localExport = Boolean(opts['export']);
         const localExportFull = Boolean(opts['exportFull']);
         if (parentExport || localExport) {
             activeFlags.push('--export');
-            const relDir = config && (config['REPORTS_DIR'] ?? 'reports');
-            details.push(messages.CliComandoDiagnosticarMensagens.detalheExport(String(relDir)));
+            const relDirValue = config?.['REPORTS_DIR'];
+            const relDir = typeof relDirValue === 'string' ? relDirValue : 'reports';
+            details.push(messages.CliComandoDiagnosticarMensagens.detalheExport(relDir));
         }
         if (parentExportFull || localExportFull) {
             activeFlags.push('--export-full');
             details.push(messages.CliComandoDiagnosticarMensagens.detalheExportFull);
         }
-        const resolvedParentLogNivel = parentOpts && Object.prototype.hasOwnProperty.call(parentOpts, 'logLevel') ? String(parentOpts['logLevel']) : undefined;
+        const resolvedParentLogNivel = Object.prototype.hasOwnProperty.call(parentOpts, 'logLevel') ? String(parentOpts['logLevel']) : undefined;
         const effectiveLogNivel = logNivel || (resolvedParentLogNivel ?? 'info');
         details.push(messages.CliComandoDiagnosticarMensagens.detalheLogLevel(effectiveLogNivel));
         details.push(messages.CliComandoDiagnosticarMensagens.dicaPrefiraLogLevelDebug);
@@ -151,7 +148,7 @@ export function comandoDiagnosticar(aplicarFlagsGlobais) {
     cmd.allowUnknownOption(true);
     cmd.allowExcessArguments(true);
     for (const opt of optionsDiagnosticar) {
-        if ('parser' in opt && opt.parser) {
+        if ('parser' in opt) {
             cmd.option(opt.flags, opt.desc, opt.parser, opt.defaultValue);
         }
         else if ('defaultValue' in opt) {
@@ -162,7 +159,7 @@ export function comandoDiagnosticar(aplicarFlagsGlobais) {
         }
     }
     cmd.action(async (opts, command) => {
-        await aplicarFlagsCombinadas(command, opts, aplicarFlagsGlobais);
+        aplicarFlagsCombinadas(command, opts, aplicarFlagsGlobais);
         if (process.env.SUKUNA_TEST_FAST === '1') {
             if (opts.json) {
                 console.log(JSON.stringify({

package/dist/cli/commands/command-fix-types.js

@@ -8,7 +8,7 @@ import { PROJETO_RAIZ } from '../../core/registry/index.js';
 import { exportarRelatoriosFixTypes } from '../handlers/index.js';
 import { ExitCode, expandIncludePatterns, processPatternList, sair } from '../helpers/index.js';
 import { asTecnicas, extrairMensagemErro } from '../../types/index.js';
-const { CliComandoFixTypesMensagens, DICAS, formatarTipoInseguro, gerarResumoCategoria, ICONES_FIX_TYPES: ICONES, log, MENSAGENS_AUTOFIX, MENSAGENS_CLI_CORRECAO_TIPOS, MENSAGENS_ERRO_FIX_TYPES: MENSAGENS_ERRO, MENSAGENS_INICIO_FIX_TYPES: MENSAGENS_INICIO, MENSAGENS_PROGRESSO_FIX_TYPES: MENSAGENS_PROGRESSO, MENSAGENS_RESUMO, MENSAGENS_SUCESSO_FIX_TYPES: MENSAGENS_SUCESSO, TEMPLATE_RESUMO_FINAL, TEXTOS_CATEGORIZACAO_CORRECAO_TIPOS, } = getMessages();
+const { CliComandoFixTypesMensagens, DICAS, formatarTipoInseguro, gerarResumoCategoria, log, MENSAGENS_AUTOFIX, MENSAGENS_CLI_CORRECAO_TIPOS, MENSAGENS_ERRO_FIX_TYPES: MENSAGENS_ERRO, MENSAGENS_INICIO_FIX_TYPES: MENSAGENS_INICIO, MENSAGENS_PROGRESSO_FIX_TYPES: MENSAGENS_PROGRESSO, MENSAGENS_RESUMO, MENSAGENS_SUCESSO_FIX_TYPES: MENSAGENS_SUCESSO, TEXTOS_CATEGORIZACAO_CORRECAO_TIPOS, } = getMessages();
 function mostrarErroDev(err) {
     if (!config.DEV_MODE) {
         return;
@@ -24,8 +24,8 @@ async function carregarInquisicao() {
     const modInq = await import('../../core/execution/index.js');
     const modReg = await import('../../analysts/registry/index.js');
     registroAnalistasCache = modReg.registroAnalistas;
-    const analistaTiposInseguros = registroAnalistasCache.find((arquivo) => {
-        return typeof arquivo === 'object' && arquivo !== null && arquivo.nome === 'detector-tipos-inseguros';
+    const analistaTiposInseguros = registroAnalistasCache?.find((arquivo) => {
+        return typeof arquivo === 'object' && arquivo.nome === 'detector-tipos-inseguros';
     });
     return {
         iniciarInquisicao: modInq.iniciarInquisicao,
@@ -210,12 +210,12 @@ async function aplicarCorrecoesAutomaticas(ocorrenciasCategorizadas, verbose) {
         const porArquivo = {};
         for (const item of ocorrenciasCategorizadas) {
             const arquivo = item.ocorrencia.relPath || 'desconhecido';
-            if (!porArquivo[arquivo]) {
+            if (!(arquivo in porArquivo)) {
                 porArquivo[arquivo] = [];
             }
             porArquivo[arquivo].push(item);
         }
-        const resultado = await aplicarCorrecoesEmLote(porArquivo, {
+        const resultado = aplicarCorrecoesEmLote(porArquivo, {
             dryRun: false,
             minConfianca: 85,
             verbose,
@@ -273,17 +273,6 @@ function mostrarExemplosDryRun(tiposInseguros, verbose, minConfidence) {
     log.info(DICAS.usarInterativo);
     log.info(DICAS.ajustarConfianca(minConfidence));
 }
-function mostrarMensagemDryRun() {
-    console.log();
-    log.aviso(MENSAGENS_CLI_CORRECAO_TIPOS.dryRunAviso(ICONES.inicio));
-    log.info(MENSAGENS_CLI_CORRECAO_TIPOS.linhaEmBranco);
-    log.info(TEMPLATE_RESUMO_FINAL.titulo);
-    for (const passo of TEMPLATE_RESUMO_FINAL.passos) {
-        log.info(MENSAGENS_CLI_CORRECAO_TIPOS.templatePasso(passo));
-    }
-    log.info(MENSAGENS_CLI_CORRECAO_TIPOS.linhaEmBranco);
-    log.info(MENSAGENS_AUTOFIX.dicas.removerDryRun);
-}
 export function criarComandoFixTypes() {
     const cmd = new Command('fix-types');
     cmd.description(CliComandoFixTypesMensagens.descricao).option('--dry-run', 'Mostra o que seria corrigido sem aplicar mudanças', false).option('--target <path>', 'Diretório ou arquivo específico para analisar', 'src').option('--confidence <number>', 'Nível mínimo de confiança para aplicar correções (0-100)', '85').option('--verbose', 'Mostra detalhes de cada correção', false).option('--interactive', 'Modo interativo: confirma cada correção', false).option('--export', 'Exporta relatórios JSON e Markdown para pasta relatorios/', false).option('--include <padrao>', 'Glob pattern a INCLUIR (pode repetir a flag ou usar vírgulas / espaços para múltiplos)', (val, prev) => {
@@ -342,7 +331,7 @@ async function executarFixTypes(options) {
         sair(ExitCode.Failure);
         return;
     }
-    const ocorrencias = resultado.ocorrencias || [];
+    const ocorrencias = resultado.ocorrencias;
     const tiposInseguros = ocorrencias.filter((ocorrencia) => ocorrencia.tipo && ['tipo-inseguro-any', 'tipo-inseguro-any-assertion', 'tipo-inseguro-any-cast', 'tipo-inseguro-unknown'].includes(ocorrencia.tipo));
     if (tiposInseguros.length === 0) {
         log.sucesso(MENSAGENS_SUCESSO.nenhumTipoInseguro);
@@ -351,7 +340,7 @@ async function executarFixTypes(options) {
     log.aviso(MENSAGENS_RESUMO.encontrados(tiposInseguros.length));
     const porTipo = tiposInseguros.reduce((acc, ocorrencia) => {
         const tipo = ocorrencia.tipo ?? 'desconhecido';
-        if (!acc[tipo]) {
+        if (!(tipo in acc)) {
             acc[tipo] = [];
         }
         acc[tipo].push(ocorrencia);
@@ -367,15 +356,9 @@ async function executarFixTypes(options) {
         return;
     }
     log.fase(MENSAGENS_CLI_CORRECAO_TIPOS.aplicandoCorrecoesAuto);
-    const { fixAnyToProperTipo, fixUnknownToSpecificTipo } = await import('../../analysts/corrections/quick-fixes/index.js');
-    if (!fixAnyToProperTipo || !fixUnknownToSpecificTipo) {
-        log.erro(MENSAGENS_ERRO.modulosNaoEncontrados);
-        sair(ExitCode.Failure);
-        return;
-    }
     const porArquivo = tiposInseguros.reduce((acc, ocorrencia) => {
         const arquivo = ocorrencia.relPath || 'desconhecido';
-        if (!acc[arquivo]) {
+        if (!(arquivo in acc)) {
             acc[arquivo] = [];
         }
         acc[arquivo].push(ocorrencia);
@@ -395,9 +378,6 @@ async function executarFixTypes(options) {
     if (casosAltaPrioridade.length > 0) {
         await aplicarCorrecoesAutomaticas(ocorrenciasCategorizadas, verbose);
     }
-    else if (isDryRun) {
-        mostrarMensagemDryRun();
-    }
     else {
         console.log();
         log.info(MENSAGENS_SUCESSO.nenhumAltaConfianca);
@@ -423,10 +403,7 @@ async function executarFixTypes(options) {
             verbose
         });
     }
-    const temAny = porTipo['tipo-inseguro-any'].length > 0;
-    if (temAny && !isDryRun) {
-        sair(ExitCode.Failure);
-    }
+    sair(ExitCode.Failure);
 }
 async function salvarAnaliseDetalhada(ocorrenciasCategorizadas, stats, mediaConfianca, verbose) {
     if (!verbose) {

package/dist/cli/commands/command-formatters.js

@@ -48,11 +48,11 @@ export function comandoFormatters() {
                 return;
             }
             const mod = await import(caminhoResolvido);
-            if (!mod.default || typeof mod.default.gerar !== 'function') {
+            if (typeof mod.default.gerar !== 'function') {
                 log.erro(FormattersMensagens.moduloInvalido(caminho));
                 return;
             }
-            const formatter = { nome, ...mod.default };
+            const formatter = { nome, ...mod.default, descricao: mod.default.descricao ?? '' };
             registrarFormatter(formatter);
             log.sucesso(FormattersMensagens.formatadorRegistrado(nome));
         }

package/dist/cli/commands/command-gitlab-ci.js

@@ -69,7 +69,7 @@ export function comandoGitlabCI() {
                     console.log('');
                     ocorrencias.forEach(ocorrencia => {
                         const prefix = ocorrencia.nivel === 'erro' ? '[RED]' : ocorrencia.nivel === 'aviso' ? '[YELLOW]' : '[BLUE]';
-                        log.info(msgs.ocorrencia(prefix, ocorrencia.tipo ?? '', ocorrencia.linha ?? 0, ocorrencia.mensagem ?? ''));
+                        log.info(msgs.ocorrencia(prefix, ocorrencia.tipo ?? '', ocorrencia.linha ?? 0, ocorrencia.mensagem));
                         if (ocorrencia.sugestao) {
                             log.info(msgs.sugestao(ocorrencia.sugestao));
                         }

package/dist/cli/commands/command-guardian.js

@@ -167,7 +167,7 @@ export function comandoGuardian(aplicarFlagsGlobais) {
             }
         }
         catch (err) {
-            logGuardian.erroGuardian(err.message ?? String(err));
+            logGuardian.erroGuardian(err.message);
             mostrarErroDev(err);
             if (opts.json) {
                 console.log(JSON.stringify({ status: 'erro', mensagem: extrairMensagemErro(err) }));