@mocoto/mahoraga 0.14.8 → 0.14.9

package/dist/core/parsing/filters.js

@@ -3,10 +3,6 @@ function globPatternToRegExp(pattern) {
     const regexText = `^${escaped.replace(/\\\*/g, '.*').replace(/\\\?/g, '.')}$`;
     return new RegExp(regexText);
 }
-/**
- * Aplica supressão às ocorrências baseado na configuração.
- * IMPORTANTE: Isso é para filtrar SAÍDA/RELATÓRIOS, não varredura de arquivos.
- */
 export function aplicarSupressaoOcorrencias(ocorrencias, filtros) {
     if (!filtros) {
         return ocorrencias;
@@ -15,22 +11,18 @@ export function aplicarSupressaoOcorrencias(ocorrencias, filtros) {
         const tipo = (ocorrencia).tipo ?? '';
         const relPath = ocorrencia.relPath || '';
         const mensagem = (ocorrencia).mensagem || '';
-        // Suprime por tipo/regra (verifica tanto o tipo quanto a mensagem)
         if (filtros.suppressRules?.some((rule) => tipo.includes(rule) || mensagem.includes(rule))) {
             return false;
         }
-        // Suprime por severidade: se a regra tiver override de severidade "off", suprime
         if (filtros.suppressBySeverity?.[tipo] === 'off') {
             return false;
         }
-        // Suprime por caminho (glob patterns)
         if (filtros.suppressByPath?.some((pattern) => {
             const regex = globPatternToRegExp(pattern);
             return regex.test(relPath);
         })) {
             return false;
         }
-        // Suprime por padrão de arquivo
         if (filtros.suppressByFilePattern?.some((pattern) => {
             const fileNome = relPath.split('/').pop() ?? '';
             const regex = globPatternToRegExp(pattern);

package/dist/core/parsing/index.js

@@ -1,7 +1,3 @@
-// SPDX-License-Identifier: MIT
-/**
- * @fileoverview Core parsing: filters and parser
- */
 export * from './babel-narrow.js';
 export * from './filters.js';
 export * from './parser.js';

package/dist/core/parsing/langs/css.js

@@ -1,5 +1,3 @@
-// @mahoraga-disable ml-deep-nesting
-// SPDX-License-Identifier: MIT
 import { wrapMinimal } from '../utils.js';
 export function parseComCss(codigo) {
     try {

package/dist/core/parsing/langs/go.js

@@ -1,6 +1,4 @@
-// SPDX-License-Identifier: MIT
 import { wrapMinimal } from '../utils.js';
-/** Analisa código Go usando regex estrutural e retorna AST wrapper */
 export function parseComGo(codigo) {
     const functions = Array.from(codigo.matchAll(/\bfunc\s+([A-Za-z0-9_]+)/g)).map(m => m[1]);
     const types = Array.from(codigo.matchAll(/\btype\s+([A-Za-z0-9_]+)\s/gs)).map(m => m[1]);

package/dist/core/parsing/langs/html.js

@@ -1,7 +1,4 @@
-// @mahoraga-disable ml-deep-nesting
-// SPDX-License-Identifier: MIT
 import { wrapMinimal } from '../utils.js';
-/** Analisa código HTML, extrai tags e metadados estruturais */
 export function parseComHtmlFunc(codigo) {
     try {
         if (!codigo.trim()) {

package/dist/core/parsing/langs/index.js

@@ -1,4 +1,3 @@
-// SPDX-License-Identifier: MIT
 export { parseComBabel } from './babel.js';
 export { parseComCss } from './css.js';
 export { parseComGo } from './go.js';

package/dist/core/parsing/langs/json.js

@@ -1,7 +1,4 @@
-// @mahoraga-disable ml-deep-nesting
-// SPDX-License-Identifier: MIT
 import { wrapMinimal } from '../utils.js';
-/** Analisa código JSON, infere tipo, profundidade e estrutura */
 export function parseComJson(codigo) {
     try {
         const parsed = JSON.parse(codigo);

package/dist/core/parsing/langs/markdown.js

@@ -1,6 +1,4 @@
-// SPDX-License-Identifier: MIT
 import { wrapMinimal } from '../utils.js';
-/** Analisa código Markdown, extraindo cabeçalhos, code blocks, links e métricas */
 export function parseComMarkdown(codigo) {
     const headings = Array.from(codigo.matchAll(/^(#{1,6})\s+(.+)$/gm)).map(m => ({
         level: m[1].length,

package/dist/core/parsing/langs/php.js

@@ -1,7 +1,4 @@
-// @mahoraga-disable ml-deep-nesting
-// SPDX-License-Identifier: MIT
 import { getCurrentParsingFile, log, logCore, ParserExtraMensagens, wrapMinimal } from '../utils.js';
-/** Analisa código PHP, extrai classes, funções, namespaces e metadados */
 export function parseComPhp(codigo) {
     try {
         const classes = Array.from(codigo.matchAll(/\bclass\s+([A-Za-z0-9_]+)/g)).map(m => m[1]);

package/dist/core/parsing/langs/python.js

@@ -1,7 +1,4 @@
-// @mahoraga-disable ml-deep-nesting
-// SPDX-License-Identifier: MIT
 import { getCurrentParsingFile, log, logCore, ParserExtraMensagens, wrapMinimal } from '../utils.js';
-/** Analisa código Python, extrai classes, funções, imports e decorators */
 export function parseComPython(codigo) {
     try {
         const classes = Array.from(codigo.matchAll(/^\s*class\s+([A-Za-z0-9_]+)/gm)).map(m => m[1]);

package/dist/core/parsing/langs/rust.js

@@ -1,7 +1,4 @@
-// @mahoraga-disable ml-deep-nesting
-// SPDX-License-Identifier: MIT
 import { wrapMinimal } from '../utils.js';
-/** Analisa código Rust, extrai funções, structs, enums, traits e metadados */
 export function parseComRust(codigo) {
     const functions = Array.from(codigo.matchAll(/\bfn\s+([A-Za-z0-9_]+)/g)).map(m => m[1]);
     const structs = Array.from(codigo.matchAll(/\bstruct\s+([A-Za-z0-9_]+)/g)).map(m => m[1]);

package/dist/core/parsing/langs/scss.js

@@ -1,8 +1,5 @@
-// @mahoraga-disable ml-deep-nesting
-// SPDX-License-Identifier: MIT
 import { wrapMinimal } from '../utils.js';
 import { parseComCss } from './css.js';
-/** Analisa código SCSS, extrai variáveis, mixins, includes e aninhamento */
 export function parseComScss(codigo) {
     try {
         const variables = [...new Set(Array.from(codigo.matchAll(/\$([A-Za-z_][\w-]*)\s*:/g)).map(m => m[1]))];

package/dist/core/parsing/langs/shell.js

@@ -1,7 +1,4 @@
-// @mahoraga-disable ml-deep-nesting
-// SPDX-License-Identifier: MIT
 import { wrapMinimal } from '../utils.js';
-/** Analisa script Shell, extrai funções, variáveis, exports e estrutura de controle */
 export function parseComShell(codigo) {
     const functions = Array.from(codigo.matchAll(/^\s*(function\s+)?([A-Za-z0-9_]+)\s*\(\)\s*\{/gm)).map(m => m[2]);
     const exports = Array.from(codigo.matchAll(/\bexport\s+([A-Za-z0-9_]+)=/g)).map(m => m[1]);

package/dist/core/parsing/langs/text.js

@@ -1,4 +1,3 @@
-// SPDX-License-Identifier: MIT
 import { wrapMinimal } from '../utils.js';
 export function parseComText(codigo) {
     const lines = codigo.split('\n');

package/dist/core/parsing/langs/typescript.js

@@ -1,18 +1,7 @@
-// SPDX-License-Identifier: MIT
 import { parse as babelParse } from '@babel/parser';
 import { getCurrentParsingFile, logCore, wrapMinimal } from '../utils.js';
-/**
- * Analisa código TypeScript/TSX.
- * Nota de migração (TS 7 / compilador nativo em Go): o compilador TypeScript
- * não expõe mais a API programática (ts.createSourceFile etc.). Usamos o
- * @babel/parser (já dependência do projeto) para obter o AST de forma estável
- * e compatível com o TS 7.
- */
 export function parseComTypeScript(codigo, tsx = false) {
     try {
-        // Lista de plugins alinhada aos demais parsers do projeto (babel 8).
-        // Tipada como string[] para acomodar plugins que deixaram de figurar no
-        // enum ParserPlugin do babel 8 (passaram a ser comportamento padrão).
         const plugins = [
             'decorators-legacy', 'classProperties', 'classPrivateProperties',
             'classPrivateMethods', 'optionalChaining', 'nullishCoalescingOperator',

package/dist/core/parsing/langs/vue.js

@@ -1,5 +1,3 @@
-// @mahoraga-disable ml-deep-nesting
-// SPDX-License-Identifier: MIT
 import { parse as babelParse } from '@babel/parser';
 import { wrapMinimal } from '../utils.js';
 function extractTags(codigo) {

package/dist/core/parsing/langs/xml.js

@@ -1,4 +1,3 @@
-// SPDX-License-Identifier: MIT
 import { wrapMinimal } from '../utils.js';
 export function parseComXml(codigo) {
     try {

package/dist/core/parsing/langs/yaml.js

@@ -1,4 +1,3 @@
-// SPDX-License-Identifier: MIT
 import { wrapMinimal } from '../utils.js';
 export function parseComYaml(codigo) {
     try {

package/dist/core/parsing/parser.js

@@ -1,5 +1,3 @@
-// SPDX-License-Identifier: MIT
-// @mahoraga-disable ml-deep-nesting
 import { getMessages } from '../messages/index.js';
 import { getGlobalRegistry, initializeDefaultPlugins } from '../../shared/plugins/index.js';
 import { parseComBabel, parseComCss, parseComGo, parseComHtmlFunc, parseComJson, parseComMarkdown, parseComPhp, parseComPython, parseComRust, parseComScss, parseComShell, parseComText, parseComTypeScript, parseComVue, parseComXml, parseComYaml, } from './langs/index.js';
@@ -64,7 +62,6 @@ export async function decifrarSintaxe(codigo, ext, opts = {}) {
             parseResultado ??= parseComBabel(codigo, ['jsx', 'decorators-legacy', 'importAttributes', 'classProperties', 'classPrivateProperties', 'classPrivateMethods', 'optionalChaining', 'nullishCoalescingOperator', 'topLevelAwait']);
         }
         catch {
-            // mantém null
         }
     }
     if (parseResultado === null && (ext === '.ts' || ext === '.tsx')) {

package/dist/core/parsing/plugins.js

@@ -1,2 +1 @@
-// SPDX-License-Identifier: MIT
 export {};

package/dist/core/parsing/utils.js

@@ -1,16 +1,12 @@
-// SPDX-License-Identifier: MIT
 import { getMessages } from '../messages/index.js';
 const { log, logCore, ParserExtraMensagens } = getMessages();
 let currentParsingArquivo;
-/** Define o arquivo sendo parseado atualmente (para logs de erro) */
 export function setCurrentParsingFile(file) {
     currentParsingArquivo = file;
 }
-/** Retorna o arquivo sendo parseado atualmente ou 'desconhecido' */
 export function getCurrentParsingFile() {
     return currentParsingArquivo ?? 'desconhecido';
 }
-/** Cria um wrapper AST mínimo para linguagens sem parser Babel dedicado */
 export function wrapMinimal(lang, rawAst) {
     return {
         type: 'File',

package/dist/core/registry/file-registry.js

@@ -1,24 +1,7 @@
-// SPDX-License-Identifier: MIT
-/**
- * @fileoverview Registry centralizado para operações de leitura/escrita de arquivos JSON
- *
- * Este módulo fornece uma camada de abstração sobre a persistência,
- * gerenciando migrações automáticas de arquivos legados e garantindo
- * que todos os arquivos sejam salvos nos locais corretos.
- *
- * Features:
- * - Migração automática de arquivos legados
- * - Validação de integridade de JSONs
- * - Logging de operações de I/O
- * - Fallback para configurações seguras
- */
 import { promises as fs } from 'node:fs';
 import path from 'node:path';
 import { messages } from '../messages/index.js';
-import { MIGRACAO_MAPA, SUKUNA_ARQUIVOS, SUKUNA_DIRS } from './paths.js';
-/**
- * Verifica se arquivo existe
- */
+import { MIGRACAO_MAPA, MAHORAGA_ARQUIVOS, MAHORAGA_DIRS } from './paths.js';
 async function fileExists(fileCaminho) {
     try {
         await fs.stat(fileCaminho);
@@ -28,18 +11,12 @@ async function fileExists(fileCaminho) {
         return false;
     }
 }
-/**
- * Cria diretórios pai se não existirem
- */
 async function ensureDir(fileCaminho) {
     const dir = path.dirname(fileCaminho);
     await fs.mkdir(dir, {
         recursive: true
     });
 }
-/**
- * Tenta migrar arquivo legado para novo local
- */
 async function tryMigrate(targetPath) {
     const legacyCaminho = Object.entries(MIGRACAO_MAPA).find(([_, target]) => target === targetPath)?.[0];
     if (!legacyCaminho) {
@@ -48,18 +25,14 @@ async function tryMigrate(targetPath) {
         };
     }
     try {
-        // Ler arquivo legado (falha se não existir, evitando TOCTOU)
         const content = await fs.readFile(legacyCaminho, 'utf-8');
-        // Garantir diretório de destino
         await ensureDir(targetPath);
-        // Escrever no novo local com flag 'wx' para evitar condição de corrida TOCTOU
         try {
             await fs.writeFile(targetPath, content, { encoding: 'utf-8', flag: 'wx' });
         }
         catch (err) {
             const code = err.code;
             if (code === 'EEXIST') {
-                // Arquivo já foi migrado concorrentemente
                 return {
                     migrated: true,
                     from: legacyCaminho,
@@ -68,10 +41,8 @@ async function tryMigrate(targetPath) {
             }
             throw err;
         }
-        // Renomear arquivo legado (não deletar para segurança)
         const backupCaminho = `${legacyCaminho}.migrated`;
         await fs.rename(legacyCaminho, backupCaminho).catch(() => {
-            // Se falhar ao renomear, o arquivo legado permanece - não é fatal
         });
         messages.log.info(`Migração automática: ${path.basename(legacyCaminho)} → ${path.basename(targetPath)}`);
         return {
@@ -93,36 +64,18 @@ async function tryMigrate(targetPath) {
         };
     }
 }
-/**
- * Lê arquivo JSON do registry
- *
- * @param filePath Caminho do arquivo (use SUKUNA_FILES.*)
- * @param options Opções de leitura
- * @returns Conteúdo parseado do JSON
- *
- * @example
- * ```ts
- * const config = await readJSON(SUKUNA_FILES.CONFIG, {
- *   default: {}
- * });
- * ```
- */
 export async function readJSON(fileCaminho, options = {}) {
     const { default: defaultValue, migrate = true, validate } = options;
     let resolvedPath = fileCaminho;
     try {
-        // Tentar migração se habilitado
         if (migrate) {
             const migration = await tryMigrate(fileCaminho);
             if (migration.migrated && migration.to) {
-                // Usar arquivo migrado
                 resolvedPath = migration.to;
             }
         }
-        // Ler e parsear diretamente (sem check de existência separado para evitar TOCTOU)
         const content = await fs.readFile(resolvedPath, 'utf-8');
         const parsed = JSON.parse(content);
-        // Validar se fornecido
         if (validate && !validate(parsed)) {
             throw new Error(messages.ExcecoesMensagens.validacaoFalhouPara(fileCaminho));
         }
@@ -142,50 +95,24 @@ export async function readJSON(fileCaminho, options = {}) {
         throw new Error(messages.ExcecoesMensagens.erroAoLer(fileCaminho, erro.message));
     }
 }
-/**
- * Escreve arquivo JSON no registry
- *
- * @param filePath Caminho do arquivo (use SUKUNA_FILES.*)
- * @param data Dados a serem salvos
- * @param options Opções de escrita
- *
- * @example
- * ```ts
- * await writeJSON(SUKUNA_FILES.GUARDIAN_BASELINE, snapshot, {
- *   createDirs: true,
- *   backup: true
- * });
- * ```
- */
 export async function writeJSON(fileCaminho, data, options = {}) {
     const { createDirs = true, backup = false, pretty = true } = options;
     try {
-        // Criar diretórios se necessário
         if (createDirs) {
             await ensureDir(fileCaminho);
         }
-        // Fazer backup se solicitado (copyFile falha com ENOENT se o arquivo não existir, o que é ok)
         if (backup) {
             const backupCaminho = `${fileCaminho}.backup`;
             await fs.copyFile(fileCaminho, backupCaminho).catch(() => {
-                // Se o arquivo não existir, não há backup a fazer
             });
         }
-        // Serializar JSON
         const content = pretty ? JSON.stringify(data, null, 2) : JSON.stringify(data);
-        // Escrever arquivo
         await fs.writeFile(fileCaminho, content, 'utf-8');
     }
     catch (erro) {
         throw new Error(messages.ExcecoesMensagens.erroAoEscrever(fileCaminho, erro.message));
     }
 }
-/**
- * Deleta arquivo do registry
- *
- * @param filePath Caminho do arquivo (use SUKUNA_FILES.*)
- * @param options Opções de deleção
- */
 export async function deleteJSON(fileCaminho, options = {}) {
     const { backup = true } = options;
     try {
@@ -200,17 +127,11 @@ export async function deleteJSON(fileCaminho, options = {}) {
     catch (erro) {
         const code = erro.code;
         if (code === 'ENOENT') {
-            return; // Já deletado
+            return;
         }
         throw new Error(messages.ExcecoesMensagens.erroAoDeletar(fileCaminho, erro.message));
     }
 }
-/**
- * Lista todos os arquivos JSON em um diretório do registry
- *
- * @param dirPath Caminho do diretório (use SUKUNA_DIRS.*)
- * @returns Lista de caminhos completos
- */
 export async function listJSONFiles(dirPath) {
     try {
         const exists = await fileExists(dirPath);
@@ -228,14 +149,11 @@ export async function listJSONFiles(dirPath) {
         return [];
     }
 }
-/**
- * Exporta funções auxiliares para compatibilidade com código existente
- */
 export const ArquivoRegistro = {
     read: readJSON,
     write: writeJSON,
     delete: deleteJSON,
     list: listJSONFiles,
-    paths: SUKUNA_ARQUIVOS,
-    dirs: SUKUNA_DIRS
+    paths: MAHORAGA_ARQUIVOS,
+    dirs: MAHORAGA_DIRS
 };

package/dist/core/registry/index.js

@@ -1,6 +1,2 @@
-// SPDX-License-Identifier: MIT
-/**
- * @fileoverview Core registry: file registry and paths
- */
 export * from './file-registry.js';
 export * from './paths.js';

package/dist/core/registry/paths.js

@@ -1,105 +1,39 @@
-// SPDX-License-Identifier: MIT
-/**
- * @fileoverview Gerenciamento centralizado de caminhos para arquivos do Mahoraga
- *
- * Este módulo define todos os caminhos de arquivos usados pelo sistema,
- * evitando hardcoding espalhado e permitindo evolução consistente.
- *
- * Convenção de nomes:
- * - guardian.baseline.json: Baseline de assinaturas GPG do Guardian
- * - guardian.chave-publica.asc: Chave pública GPG do Guardian
- * - guardian.chave-privada.asc: Chave privada GPG do Guardian
- * - estrutura.baseline.json: Baseline da estrutura de diretórios
- * - estrutura.arquetipo.json: Arquétipo personalizado do repositório
- * - mahoraga.config.json: Configuração do usuário (raiz do projeto)
- */
 import path from 'node:path';
-// Diretório base do projeto (raiz) - usa CWD quando executado pelo CLI
 export const PROJETO_RAIZ = process.cwd();
-/**
- * Diretórios principais do Mahoraga
- */
-export const SUKUNA_DIRS = {
-    /** Diretório de estado interno (.mahoraga/) */
+export const MAHORAGA_DIRS = {
     STATE: path.join(PROJETO_RAIZ, '.mahoraga'),
-    /** Diretório de histórico de métricas (.mahoraga/historico-metricas/) */
     METRICS_HISTORY: path.join(PROJETO_RAIZ, '.mahoraga', 'historico-metricas'),
-    /** Diretório de relatórios (reports/) */
     REPORTS: path.join(PROJETO_RAIZ, 'reports'),
-    /** Diretório de performance baselines (docs/perf/) */
     PERF: path.join(PROJETO_RAIZ, 'docs', 'perf')
 };
-/**
- * Arquivos JSON do sistema
- *
- * Categoria 1: Configuração (leitura usuário)
- * Categoria 2: Estado interno (leitura/escrita sistema)
- * Categoria 3: Relatórios (escrita sistema)
- */
-export const SUKUNA_ARQUIVOS = {
-    // ─── CONFIGURAÇÃO (raiz do projeto) ───────────────────────────
-    /** Configuração principal do usuário (mahoraga.config.json) */
+export const MAHORAGA_ARQUIVOS = {
     CONFIG: path.join(PROJETO_RAIZ, 'mahoraga.config.json'),
-    /** Configuração segura/alternativa (mahoraga.config.safe.json) */
     CONFIG_SAFE: path.join(PROJETO_RAIZ, 'mahoraga.config.safe.json'),
-    // ─── ESTADO INTERNO (.mahoraga/) ────────────────────────────
-    /** Baseline de assinaturas GPG do Guardian (.mahoraga/guardian.baseline.json) */
-    GUARDIAN_BASELINE: path.join(SUKUNA_DIRS.STATE, 'guardian.baseline.json'),
-    /** Baseline de estrutura de diretórios (.mahoraga/estrutura.baseline.json) */
-    ESTRUTURA_BASELINE: path.join(SUKUNA_DIRS.STATE, 'estrutura.baseline.json'),
-    /** Arquétipo personalizado do repo (.mahoraga/estrutura.arquetipo.json) */
-    ESTRUTURA_ARQUETIPO: path.join(SUKUNA_DIRS.STATE, 'estrutura.arquetipo.json'),
-    /** Mapa de reversão de estrutura (.mahoraga/mapa-reversao.json) */
-    MAPA_REVERSAO: path.join(SUKUNA_DIRS.STATE, 'mapa-reversao.json'),
-    /** Registros da Vigia Oculta (.mahoraga/integridade.json) */
-    REGISTRO_VIGIA: path.join(SUKUNA_DIRS.STATE, 'integridade.json'),
-    /** Chave pública GPG do Guardian (.mahoraga/guardian.chave-publica.asc) */
-    GUARDIAN_CHAVE_PUBLICA: path.join(SUKUNA_DIRS.STATE, 'guardian.chave-publica.asc'),
-    /** Chave privada GPG do Guardian (.mahoraga/guardian.chave-privada.asc) */
-    GUARDIAN_CHAVE_PRIVADA: path.join(SUKUNA_DIRS.STATE, 'guardian.chave-privada.asc'),
-    /** Histórico de métricas (.mahoraga/historico-metricas/metricas-historico.json) */
-    METRICAS_HISTORICO: path.join(SUKUNA_DIRS.METRICS_HISTORY, 'metricas-historico.json'),
-    // ─── ARQUIVOS LEGADOS (compatibilidade) ───────────────────────
-    /** @deprecated Use GUARDIAN_BASELINE - baseline.json antigo */
-    GUARDIAN_BASELINE_LEGACY: path.join(SUKUNA_DIRS.STATE, 'baseline.json'),
-    /** @deprecated Use ESTRUTURA_BASELINE - baseline-estrutura.json antigo */
-    ESTRUTURA_BASELINE_LEGACY: path.join(SUKUNA_DIRS.STATE, 'baseline-estrutura.json'),
-    /** @deprecated Movido para .mahoraga/ - mahoraga.repo.arquetipo.json na raiz */
+    GUARDIAN_BASELINE: path.join(MAHORAGA_DIRS.STATE, 'guardian.baseline.json'),
+    ESTRUTURA_BASELINE: path.join(MAHORAGA_DIRS.STATE, 'estrutura.baseline.json'),
+    ESTRUTURA_ARQUETIPO: path.join(MAHORAGA_DIRS.STATE, 'estrutura.arquetipo.json'),
+    MAPA_REVERSAO: path.join(MAHORAGA_DIRS.STATE, 'mapa-reversao.json'),
+    REGISTRO_VIGIA: path.join(MAHORAGA_DIRS.STATE, 'integridade.json'),
+    GUARDIAN_CHAVE_PUBLICA: path.join(MAHORAGA_DIRS.STATE, 'guardian.chave-publica.asc'),
+    GUARDIAN_CHAVE_PRIVADA: path.join(MAHORAGA_DIRS.STATE, 'guardian.chave-privada.asc'),
+    METRICAS_HISTORICO: path.join(MAHORAGA_DIRS.METRICS_HISTORY, 'metricas-historico.json'),
+    GUARDIAN_BASELINE_LEGACY: path.join(MAHORAGA_DIRS.STATE, 'baseline.json'),
+    ESTRUTURA_BASELINE_LEGACY: path.join(MAHORAGA_DIRS.STATE, 'baseline-estrutura.json'),
     ESTRUTURA_ARQUETIPO_LEGACY_ROOT: path.join(PROJETO_RAIZ, 'mahoraga.repo.arquetipo.json')
 };
-/**
- * Padrões de nomenclatura para relatórios dinâmicos
- */
 export const REPORT_PADROES = {
-    /** Relatório de diagnóstico (mahoraga-diagnostico-{timestamp}.md) */
-    DIAGNOSTICO: (timestamp) => path.join(SUKUNA_DIRS.REPORTS, `mahoraga-diagnostico-${timestamp}.md`),
-    /** Relatório JSON resumo (mahoraga-relatorio-summary-{timestamp}.json) */
-    SUMMARY_JSON: (timestamp) => path.join(SUKUNA_DIRS.REPORTS, `mahoraga-relatorio-summary-${timestamp}.json`),
-    /** Relatório de análise async (async-analysis-report.json) */
-    ASYNC_ANALYSIS: path.join(SUKUNA_DIRS.REPORTS, 'async-analysis-report.json'),
-    /** Baseline de performance (docs/perf/baseline-{timestamp}.json) */
-    PERF_BASELINE: (timestamp) => path.join(SUKUNA_DIRS.PERF, `baseline-${timestamp}.json`),
-    /** Diff de performance (docs/perf/ultimo-diff.json) */
-    PERF_DIFF: path.join(SUKUNA_DIRS.PERF, 'ultimo-diff.json')
+    DIAGNOSTICO: (timestamp) => path.join(MAHORAGA_DIRS.REPORTS, `mahoraga-diagnostico-${timestamp}.md`),
+    SUMMARY_JSON: (timestamp) => path.join(MAHORAGA_DIRS.REPORTS, `mahoraga-relatorio-summary-${timestamp}.json`),
+    ASYNC_ANALYSIS: path.join(MAHORAGA_DIRS.REPORTS, 'async-analysis-report.json'),
+    PERF_BASELINE: (timestamp) => path.join(MAHORAGA_DIRS.PERF, `baseline-${timestamp}.json`),
+    PERF_DIFF: path.join(MAHORAGA_DIRS.PERF, 'ultimo-diff.json')
 };
-/**
- * Mapeia nomes legados para novos caminhos (migração automática)
- */
 export const MIGRACAO_MAPA = {
-    // Guardian: baseline.json → guardian.baseline.json
-    [path.join(SUKUNA_DIRS.STATE, 'baseline.json')]: SUKUNA_ARQUIVOS.GUARDIAN_BASELINE,
-    // Estrutura: baseline-estrutura.json → estrutura.baseline.json
-    [path.join(SUKUNA_DIRS.STATE, 'baseline-estrutura.json')]: SUKUNA_ARQUIVOS.ESTRUTURA_BASELINE,
-    // Arquétipo: mahoraga.repo.arquetipo.json (raiz) → .mahoraga/estrutura.arquetipo.json
-    [path.join(PROJETO_RAIZ, 'mahoraga.repo.arquetipo.json')]: SUKUNA_ARQUIVOS.ESTRUTURA_ARQUETIPO
+    [path.join(MAHORAGA_DIRS.STATE, 'baseline.json')]: MAHORAGA_ARQUIVOS.GUARDIAN_BASELINE,
+    [path.join(MAHORAGA_DIRS.STATE, 'baseline-estrutura.json')]: MAHORAGA_ARQUIVOS.ESTRUTURA_BASELINE,
+    [path.join(PROJETO_RAIZ, 'mahoraga.repo.arquetipo.json')]: MAHORAGA_ARQUIVOS.ESTRUTURA_ARQUETIPO
 };
-/**
- * Retorna o caminho legado (se existir) ou o novo
- * @param newPath Caminho novo desejado
- * @returns Caminho do arquivo (prioriza legado se existir)
- */
 export function resolveFilePath(newPath) {
-    // Verifica se há entrada no mapa de migração reverso
     const legacyCaminho = Object.entries(MIGRACAO_MAPA).find(([_, target]) => target === newPath)?.[0];
     return legacyCaminho ?? newPath;
 }

package/dist/core/reporting/default-reporter.js

@@ -1,15 +1,8 @@
-// SPDX-License-Identifier: MIT
-/**
- * @fileoverview Reporter padrão que converte eventos de relatório em ocorrências.
- * Mapeia códigos de evento (como ARQ_PADRAO, ARQ_VIOLACAO, etc.) para mensagens
- * formatadas usando os templates de mensagens dos detectores correspondentes.
- */
 import { messages } from '../messages/index.js';
 import { criarOcorrencia } from '../../types/index.js';
 export function createDefaultReporter() {
     return (event) => {
         const { code, tipo, nivel = 'info', mensagem, data, relPath, linha = 1, coluna, origem, } = event;
-        // Se a mensagem já veio formatada, apenas encaminha
         if (mensagem && typeof mensagem === 'string') {
             return criarOcorrencia({
                 tipo,
@@ -21,7 +14,6 @@ export function createDefaultReporter() {
                 origem,
             });
         }
-        // Mapeamentos mínimos (incrementais) por code
         if (code === 'ARQ_PADRAO') {
             const padrao = typeof data?.padraoIdentificado === 'string' ? data.padraoIdentificado : '';
             const confianca = Number((data?.confianca) ?? 0);
@@ -85,7 +77,6 @@ export function createDefaultReporter() {
                 origem,
             });
         }
-        // Fallback: mantém sinal útil mesmo sem template
         const fallbackMsg = code
             ? `${code}${data ? ` ${JSON.stringify(data)}` : ''}`
             : data

package/dist/core/reporting/index.js

@@ -1,5 +1 @@
-// SPDX-License-Identifier: MIT
-/**
- * @fileoverview Core reporting: default reporter
- */
 export * from './default-reporter.js';

package/dist/core/runtime/index.js

@@ -1,7 +1,3 @@
-// SPDX-License-Identifier: MIT
-/**
- * @fileoverview Gerenciamento de runtime (Node, Deno, Bun)
- */
 import { criarAdapterNode } from './node-adapter.js';
 let adapterAtual = criarAdapterNode();
 export function obterRuntime() {

package/dist/core/runtime/node-adapter.js

@@ -1,7 +1,3 @@
-// SPDX-License-Identifier: MIT
-/**
- * @fileoverview Adaptador de runtime para Node.js
- */
 import fs from 'node:fs';
 import path from 'node:path';
 import process from 'node:process';

package/dist/core/runtime.js

@@ -1,2 +1 @@
-// SPDX-License-Identifier: MIT
 export {};

package/dist/core/schema/index.js

@@ -1,5 +1 @@
-// SPDX-License-Identifier: MIT
-/**
- * @fileoverview Core schema versioning
- */
 export * from './version.js';