@mocoto/mahoraga 0.14.0 → 0.14.1

package/dist/shared/validation/validation.js

@@ -1,24 +1,35 @@
+// SPDX-License-Identifier: MIT
 import path from 'node:path';
 import { messages } from '../../core/messages/index.js';
+/** Normaliza um caminho assegurando que permanece dentro da CWD (remove tentativas de escape). */
 export function normalizePath(caminho) {
     const normalized = path.normalize(caminho);
     const resolved = path.resolve(normalized);
     const cwd = process.cwd();
+    // Assegurar que o caminho permanece dentro da CWD
     if (!resolved.startsWith(cwd)) {
         throw new Error(messages.ExcecoesMensagens.caminhoForaDaCwdNaoPermitido(caminho));
     }
     return normalized;
 }
+/** Valida se um caminho de arquivo é seguro para operações de leitura/escrita */
 export function isPathSafe(fileCaminho) {
     try {
         const normalized = normalizePath(fileCaminho);
+        // Verificar padrões perigosos
         const dangerousPadroes = [/\.\./,
+            // Directory traversal
             /^\/etc\//,
+            // System directories
             /^\/root\//,
+            // Root directory
             /^\/sys\//,
+            // System files
             /^\/proc\//,
+            // Process files
             /^C:\\Windows\\/i,
-            /^C:\\System32\\/i
+            // Windows system directory
+            /^C:\\System32\\/i // Windows system32
         ];
         return !dangerousPadroes.some(pattern => pattern.test(normalized));
     }
@@ -26,51 +37,69 @@ export function isPathSafe(fileCaminho) {
         return false;
     }
 }
+/** Valida se um nome de arquivo é válido e seguro */
 export function isFilenameSafe(filename) {
-    if (!filename || filename.length === 0)
+    if (!filename || filename.length === 0) {
         return false;
-    if (filename.length > 255)
+    }
+    if (filename.length > 255) {
         return false;
+    }
+    // Caracteres proibidos
     const invalidChars = /[<>:"|?*\x00-\x1f]/;
-    if (invalidChars.test(filename))
+    if (invalidChars.test(filename)) {
         return false;
+    }
+    // Nomes reservados no Windows
     const reservedNomes = /^(CON|PRN|AUX|NUL|COM[1-9]|LPT[1-9])(\.|$)/i;
-    if (reservedNomes.test(filename))
+    if (reservedNomes.test(filename)) {
         return false;
+    }
     return true;
 }
+/** Sanitiza um nome de arquivo removendo caracteres perigosos */
 export function sanitizeFilename(filename) {
     return filename.replace(/[<>:"|?*\x00-\x1f]/g, '_').replace(/^(CON|PRN|AUX|NUL|COM[1-9]|LPT[1-9])(\.|$)/i, 'file_$1$2').slice(0, 255);
 }
+/** Valida se uma string representa um caminho relativo válido */
 export function isRelativePathValid(relativePath) {
-    if (!relativePath)
+    if (!relativePath) {
         return false;
-    if (path.isAbsolute(relativePath))
+    }
+    if (path.isAbsolute(relativePath)) {
         return false;
+    }
     const normalized = path.normalize(relativePath);
     return !normalized.startsWith('..');
 }
+/** Extrai a extensão de um arquivo de forma segura */
 export function getFileExtension(filename) {
     const ext = path.extname(filename);
     return ext.toLowerCase();
 }
+/** Verifica se uma extensão está na lista de extensões permitidas */
 export function isExtensionAllowed(filename, allowedExtensions) {
     const ext = getFileExtension(filename);
     return allowedExtensions.includes(ext);
 }
+/** Alias de compatibilidade para {@link normalizePath}. */
 export function normalizarPathLocal(caminho) {
     return normalizePath(caminho);
 }
+/** Valida se um valor é um número positivo */
 export function validarNumeroPositivo(valor, _nome) {
-    if (typeof valor === 'number' && valor > 0)
+    if (typeof valor === 'number' && valor > 0) {
         return valor;
+    }
     if (typeof valor === 'string') {
         const num = Number.parseFloat(valor);
-        if (!Number.isNaN(num) && num > 0)
+        if (!Number.isNaN(num) && num > 0) {
             return num;
+        }
     }
     return null;
 }
+/** Regras simples de combinação de flags globais. Expandir conforme novos casos. */
 export function validarCombinacoes(flags) {
     const erros = [];
     if (flags.scanOnly && flags.incremental) {
@@ -81,6 +110,11 @@ export function validarCombinacoes(flags) {
     }
     return erros;
 }
+/**
+ * Sanitiza flags de CLI, lançando erro se houver combinações inválidas.
+ * @param flags - Mapa de flags da linha de comando
+ * @throws Error com detalhes das combinações inválidas encontradas
+ */
 export function sanitizarFlags(flags) {
     const erros = validarCombinacoes(flags);
     if (erros.length) {
@@ -88,4 +122,3 @@ export function sanitizarFlags(flags) {
         throw new Error(detalhe);
     }
 }
-//# sourceMappingURL=validation.js.map

package/dist/shared/validation.js

@@ -0,0 +1,108 @@
+// SPDX-License-Identifier: MIT
+import { SharedCommonMensagens } from '../core/messages/index.js';
+/**
+ * Helper para extrair mensagem de erro de forma segura
+ */
+export function extrairMensagemErro(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    if (isErroComMensagem(error)) {
+        if (typeof error.message === 'string') {
+            return error.message;
+        }
+        if (error.message instanceof Error) {
+            return error.message.message;
+        }
+    }
+    if (typeof error === 'string') {
+        return error;
+    }
+    if (error && typeof error === 'object' && 'message' in error) {
+        const msg = error.message;
+        if (typeof msg === 'string') {
+            return msg;
+        }
+    }
+    return SharedCommonMensagens.erroDesconhecido;
+}
+/**
+ * Função helper para validação segura com fallback (sem dependências externas)
+ */
+export function validarSeguro(validador, dados, fallback, contexto) {
+    if (validador(dados)) {
+        return dados;
+    }
+    // Em modo DEV, logga o problema de validação
+    if (process.env.NODE_ENV === 'development' || process.env.VITEST) {
+        console.warn(`[Validação] Falhou${contexto ? ` em ${contexto}` : ''}, usando fallback`);
+    }
+    return fallback;
+}
+/**
+ * Type guards para verificação runtime - Nossa implementação própria
+ */
+export function isErroComMensagem(obj) {
+    return typeof obj === 'object' && obj !== null && 'message' in obj;
+}
+export function isGlobalComVitest(obj) {
+    return typeof obj === 'object' && obj !== null && 'vi' in obj;
+}
+export function isIntlComDisplayNames(obj) {
+    return (typeof obj === 'object' &&
+        obj !== null &&
+        ('DisplayNames' in obj || Object.keys(obj).length >= 0));
+}
+export function isGlobalComImport(obj) {
+    return (typeof obj === 'object' &&
+        obj !== null &&
+        ('import' in obj || Object.keys(obj).length >= 0));
+}
+export function isConfigPlugin(obj) {
+    return typeof obj === 'object' && obj !== null;
+}
+export function isPlanoSugestaoEstrutura(obj) {
+    return (typeof obj === 'object' &&
+        obj !== null &&
+        'mover' in obj &&
+        Array.isArray(obj.mover));
+}
+export function isSnapshotAnalise(obj) {
+    return (typeof obj === 'object' &&
+        obj !== null &&
+        'timestamp' in obj &&
+        'arquivos' in obj &&
+        Array.isArray(obj.arquivos));
+}
+export function isEntradaMapaReversao(obj) {
+    return (typeof obj === 'object' &&
+        obj !== null &&
+        'arquivo' in obj &&
+        'operacao' in obj &&
+        typeof obj.arquivo === 'string' &&
+        ['adicionar', 'remover', 'modificar'].includes(obj.operacao));
+}
+/**
+ * Helpers para conversão segura (nossa alternativa ao casting frágil)
+ */
+export function converterSeguro(obj, validador, fallback) {
+    return validador(obj) ? obj : fallback;
+}
+/**
+ * Helper para validação de string não vazia
+ */
+export function isStringNaoVazia(valor) {
+    return typeof valor === 'string' && valor.trim().length > 0;
+}
+/**
+ * Helper para validação de número válido
+ */
+export function isNumeroValido(valor) {
+    return typeof valor === 'number' && !isNaN(valor) && isFinite(valor);
+}
+/**
+ * Helper para validação de array não vazio
+ */
+export function isArrayNaoVazio(valor) {
+    return Array.isArray(valor) && valor.length > 0;
+}

package/dist/shared/vitest-alias.js

@@ -0,0 +1,5 @@
+// SPDX-License-Identifier: MIT
+/**
+ * @fileoverview Tipos para configuração de aliases do Vitest
+ */
+export {};

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

@@ -1,2 +1,2 @@
+// SPDX-License-Identifier: MIT
 export {};
-//# sourceMappingURL=azure-pipelines.js.map

package/dist/types/analysts/circleci.js

@@ -1,2 +1,2 @@
+// SPDX-License-Identifier: MIT
 export {};
-//# sourceMappingURL=circleci.js.map

package/dist/types/analysts/context.js

@@ -1,2 +1,6 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Tipos para detecção inteligente de contexto e arquétipos
+ * Consolidação de múltiplas versões
+ */
 export {};
-//# sourceMappingURL=context.js.map

package/dist/types/analysts/corrections/index.js

@@ -1,3 +1,2 @@
 export * from './reorganize-barrels.js';
 export * from './type-safety.js';
-//# sourceMappingURL=index.js.map

package/dist/types/analysts/corrections/reorganize-barrels.js

@@ -1,2 +1,2 @@
+// SPDX-License-Identifier: MIT
 export {};
-//# sourceMappingURL=reorganize-barrels.js.map

package/dist/types/analysts/corrections/type-safety.js

@@ -1,2 +1,6 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Tipos para sistema de Type Safety Auto-Fix
+ * Suporta análise e correção inteligente de tipos `any` e `unknown`
+ */
 export {};
-//# sourceMappingURL=type-safety.js.map

package/dist/types/analysts/corrections.js

@@ -1,2 +1,7 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Tipos para sistema de correções automáticas
+ */
+// Re-exporta todos os tipos de type-safety (inclui ASTNode, CategorizacaoUnknown, etc)
+export * from './corrections/reorganize-barrels.js';
 export * from './corrections/type-safety.js';
-//# sourceMappingURL=corrections.js.map

package/dist/types/analysts/detectors.js

@@ -1,2 +1,2 @@
+// SPDX-License-Identifier: MIT
 export {};
-//# sourceMappingURL=detectors.js.map

package/dist/types/analysts/dynamic-modules.js

@@ -1,2 +1,2 @@
+// SPDX-License-Identifier: MIT
 export {};
-//# sourceMappingURL=dynamic-modules.js.map

package/dist/types/analysts/github-actions-plugins.js

@@ -1,2 +1,2 @@
+// SPDX-License-Identifier: MIT
 export {};
-//# sourceMappingURL=github-actions-plugins.js.map

package/dist/types/analysts/github-actions-reports.js

@@ -1,2 +1,5 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Tipos para relatórios de GitHub Actions
+ */
 export {};
-//# sourceMappingURL=github-actions-reports.js.map

package/dist/types/analysts/gitlab-ci.js

@@ -1,2 +1,2 @@
+// SPDX-License-Identifier: MIT
 export {};
-//# sourceMappingURL=gitlab-ci.js.map

package/dist/types/analysts/handlers.js

@@ -1,2 +1,2 @@
+// SPDX-License-Identifier: MIT
 export {};
-//# sourceMappingURL=handlers.js.map

package/dist/types/analysts/index.js

@@ -1,7 +1,19 @@
+// SPDX-License-Identifier: MIT
+/**
+ * @fileoverview Exportações centralizadas de tipos de analistas
+ *
+ * Re-exporta todos os tipos relacionados a analistas, detectores,
+ * estrategistas e suas funcionalidades.
+ */
+// Markdown
 export * from './markdown.js';
+// Detectores
 export * from './detectors.js';
+// Contexto (já exportado em detectores, mas mantido para compatibilidade)
 export * from './context.js';
+// Estrategistas
 export * from './strategists.js';
+// Correções
 export * from './azure-pipelines.js';
 export {} from './circleci.js';
 export * from './corrections.js';
@@ -12,6 +24,6 @@ export {} from './gitlab-ci.js';
 export * from './handlers.js';
 export {} from './jenkins.js';
 export * from './metrics.js';
+export * from './plugins.js';
 export * from './scoring.js';
 export * from './svg-plugins.js';
-//# sourceMappingURL=index.js.map

package/dist/types/analysts/jenkins.js

@@ -1,2 +1,2 @@
+// SPDX-License-Identifier: MIT
 export {};
-//# sourceMappingURL=jenkins.js.map

package/dist/types/analysts/markdown.js

@@ -1,2 +1,8 @@
+// SPDX-License-Identifier: MIT
+/**
+ * @fileoverview Tipos para detecção de problemas em arquivos Markdown
+ *
+ * Define estruturas para verificação de compliance de licenças,
+ * proveniência e referências em documentação Markdown.
+ */
 export {};
-//# sourceMappingURL=markdown.js.map

package/dist/types/analysts/metrics.js

@@ -1,2 +1,2 @@
+// SPDX-License-Identifier: MIT
 export {};
-//# sourceMappingURL=metrics.js.map

package/dist/types/analysts/plugins.js

@@ -1,2 +1,2 @@
+// SPDX-License-Identifier: MIT
 export {};
-//# sourceMappingURL=plugins.js.map

package/dist/types/analysts/scoring.js

@@ -1,2 +1,2 @@
+// SPDX-License-Identifier: MIT
 export {};
-//# sourceMappingURL=scoring.js.map

package/dist/types/analysts/strategists.js

@@ -1,2 +1,2 @@
+// SPDX-License-Identifier: MIT
 export {};
-//# sourceMappingURL=strategists.js.map

package/dist/types/analysts/svg-plugins.js

@@ -1,2 +1,2 @@
+// SPDX-License-Identifier: MIT
 export {};
-//# sourceMappingURL=svg-plugins.js.map

package/dist/types/common/analysts.js

@@ -1,11 +1,18 @@
+// SPDX-License-Identifier: MIT
 import { messages } from '../../core/messages/index.js';
+/**
+ * Fábrica para criar analista com validação mínima
+ */
 export function criarAnalista(def) {
-    if (!def || typeof def !== 'object')
+    if (!def || typeof def !== 'object') {
         throw new Error(messages.ExcecoesMensagens.definicaoAnalistaInvalida);
-    if (!def.nome || /\s/.test(def.nome) === false === false) {
     }
-    if (typeof def.aplicar !== 'function')
+    if (!def.nome || /\s/.test(def.nome)) {
+        // nome pode ter hifens, apenas exige não vazio
+    }
+    if (typeof def.aplicar !== 'function') {
         throw new Error(messages.ExcecoesMensagens.analistaSemFuncaoAplicar(def.nome));
+    }
     return Object.freeze(def);
 }
 export function isAnalista(item) {
@@ -13,10 +20,12 @@ export function isAnalista(item) {
 }
 export function asTecnicas(items) {
     return items.map(raw => {
+        // Trate o item como desconhecido e faça guards em runtime para evitar exceptions
         const item = raw;
         const nome = item && typeof item.nome === 'string' && item.nome.length > 0 ? item.nome : 'analista-sem-nome';
         const global = item && 'global' in item ? (typeof item.global === 'boolean' ? item.global : undefined) : undefined;
         const test = item && typeof item.test === 'function' ? item.test : undefined;
+        // preparar aplicar com fallback seguro (no-op retorna array vazio)
         const aplicar = item && typeof item.aplicar === 'function' ? async (conteudo, relPath, ast, fullCaminho, contextoGlobal) => {
             const astParam = ast;
             const aplicarFn = item.aplicar;
@@ -27,7 +36,7 @@ export function asTecnicas(items) {
             catch {
                 return [];
             }
-        } : async () => [];
+        } : () => [];
         return {
             nome,
             global,
@@ -36,4 +45,3 @@ export function asTecnicas(items) {
         };
     });
 }
-//# sourceMappingURL=analysts.js.map

package/dist/types/common/file-entries.js

@@ -1,2 +1,2 @@
+// SPDX-License-Identifier: MIT
 export {};
-//# sourceMappingURL=file-entries.js.map

package/dist/types/common/index.js

@@ -1,6 +1,9 @@
+// SPDX-License-Identifier: MIT
+/**
+ * @fileoverview Common types: analistas, file-entries, ocorrencias, utils
+ */
 export * from './analysts.js';
 export * from './file-entries.js';
 export * from './occurrences.js';
 export * from './package-json.js';
 export * from './utils.js';
-//# sourceMappingURL=index.js.map

package/dist/types/common/marketplace.js

@@ -1,2 +1,2 @@
+// SPDX-License-Identifier: MIT
 export {};
-//# sourceMappingURL=marketplace.js.map

package/dist/types/common/occurrences.js

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: MIT
+// Função para criar ocorrência (compatível com ambos os casos)
 export function criarOcorrencia(base) {
     return {
         nivel: 'info',
@@ -6,6 +8,7 @@ export function criarOcorrencia(base) {
         mensagem: base.mensagem.trim()
     };
 }
+// Funções específicas
 export function ocorrenciaErroAnalista(data) {
     return {
         tipo: 'ERRO_ANALISTA',
@@ -33,4 +36,3 @@ export function ocorrenciaParseErro(data) {
         mensagem: data.mensagem.trim()
     };
 }
-//# sourceMappingURL=occurrences.js.map

package/dist/types/common/package-json.js

@@ -1,2 +1,2 @@
+// SPDX-License-Identifier: MIT
 export {};
-//# sourceMappingURL=package-json.js.map

package/dist/types/common/utils.js

@@ -1,6 +1,9 @@
+// SPDX-License-Identifier: MIT
+// @mahoraga-disable tipo-inseguro-unknown
+// Justificativa: função é um type guard; aceita `unknown` e valida com checagem runtime.
 export function isBabelNode(obj) {
+    // Implementação de runtime fica em src/@types ou em utilitários reais.
     return (typeof obj === 'object' &&
         obj !== null &&
         typeof obj.type === 'string');
 }
-//# sourceMappingURL=utils.js.map

package/dist/types/core/config/config.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=config.js.map

package/dist/types/core/execution/analysis-cache.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=analysis-cache.js.map

package/dist/types/core/execution/ast-cache.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=ast-cache.js.map

package/dist/types/core/execution/index.js

@@ -1,13 +1 @@
-export * from './ambiente.js';
-export * from './analysis-cache.js';
-export * from './ast-cache.js';
-export * from './executor.js';
-export { ocorrenciaParseErro } from './inquisitor.js';
-export * from './linguagens.js';
-export * from './parse-errors.js';
-export * from './registry.js';
-export {} from './results.js';
-export * from './schema.js';
-export * from './structure-json.js';
-export * from './workers.js';
-//# sourceMappingURL=index.js.map
+export {};

package/dist/types/index.js

@@ -1,63 +1,9 @@
-export * from './analysts/context.js';
-export * from './analysts/corrections/index.js';
-export * from './analysts/detectors.js';
-export * from './analysts/dynamic-modules.js';
-export * from './analysts/github-actions-plugins.js';
-export * from './analysts/handlers.js';
-export * from './analysts/metrics.js';
-export * from './analysts/scoring.js';
-export * from './analysts/strategists.js';
-export * from './analysts/svg-plugins.js';
-export * from './cli/commands.js';
-export * from './cli/diagnostic.js';
-export * from './cli/diagnostic-handlers.js';
-export * from './cli/exporters.js';
-export * from './cli/formatters.js';
-export * from './cli/handlers.js';
-export * from './cli/log-extensions.js';
-export * from './cli/metrics.js';
-export * from './cli/metrics-analysts.js';
-export * from './cli/processing-diagnostic.js';
-export * from './common/analysts.js';
-export * from './common/file-entries.js';
-export * from './common/occurrences.js';
-export * from './common/package-json.js';
-export * from './common/utils.js';
-export * from './structure/archetypes.js';
-export * from './structure/plano-structure.js';
-export * from './guardian/index.js';
-export * from './licenses/licenses.js';
-export * from './vulnerabilities/vulnerabilities.js';
-export * from './core/execution/registry.js';
-export * from './core/execution/schema.js';
-export * from './core/execution/workers.js';
-export * from './core/parsing/parser.js';
-export * from './core/utils/chalk.js';
-export * from './core/messages/index.js';
-export * from './core/messages/log.js';
-export * from './core/execution/ambiente.js';
-export * from './core/execution/ast-cache.js';
-export * from './core/execution/linguagens.js';
-export * from './core/execution/parse-errors.js';
-export * from './core/execution/results.js';
-export * from './core/execution/structure-json.js';
-export * from './core/parsing/babel-narrow.js';
-export * from './core/parsing/plugins.js';
-export * from './core/config/config.js';
-export * from './core/config/filters.js';
-export * from './project/detection.js';
-export * from './reports/compliance.js';
-export * from './reports/index.js';
-export * from './core/runtime.js';
-export * from './analysts/plugins.js';
-export * from './sdk/analyzer.js';
-export * from './shared/index.js';
-export * from './project/context.js';
-export * from './reports/reader.js';
-export * from './caretakers/imports.js';
-export * from './caretakers/imports-barrel.js';
-export * from './caretakers/map-reversion.js';
-export * from './caretakers/pruning.js';
-export * from './caretakers/scoring.js';
-export * from './github/index.js';
-//# sourceMappingURL=index.js.map
+export { IntegridadeStatus } from '../guardian/integrity.js';
+export { converterResultadoGuardian } from '../guardian/result.js';
+export { extrairMensagemErro } from '../shared/validation.js';
+export * from './analysts/index.js';
+export * from './common/index.js';
+export * from './processing/index.js';
+export * from './project/index.js';
+export * from './structure/index.js';
+export { GuardianError } from '../guardian/integrity.js';

package/dist/types/licenses/header-options.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=header-options.js.map

package/dist/types/licenses/licenses.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=licenses.js.map

package/dist/types/processing/commands.js

@@ -0,0 +1,5 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Tipos para os comandos CLI
+ */
+export {};

package/dist/types/processing/diagnostic-handlers.js

@@ -0,0 +1,5 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Tipos para handlers de diagnóstico (Guardian, Arquetipo, Auto-Fix)
+ */
+export {};

package/dist/types/processing/diagnostic.js

@@ -0,0 +1,7 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Tipos para processamento de comandos de diagnóstico
+ * Nota: OpcoesProcessamentoDiagnostico e ResultadoProcessamentoDiagnostico
+ * estão em processamento-diagnostico.ts
+ */
+export {};