@mocoto/mahoraga 0.14.8 → 0.15.0

package/dist/core/messages/zh/github/github-webhook-messages.js

@@ -1,4 +1,3 @@
-// SPDX-License-Identifier: MIT
 export const GithubWebhookMensagens = {
     checkRunTitle: (score) => `Mahoraga: 评分 ${score}/100`,
     checkRunName: 'Mahoraga GitHub Actions 分析器',

package/dist/core/messages/zh/github/index.js

@@ -1,4 +1,3 @@
-// SPDX-License-Identifier: MIT
 export * from './github-app-messages.js';
 export * from './github-push-report-messages.js';
 export * from './github-repo-downloader-messages.js';

package/dist/core/messages/zh/guardian/guardian-messages.js

@@ -1,4 +1,3 @@
-// SPDX-License-Identifier: MIT
 export const GuardianMensagens = {
     gpgChavePrivadaIndisponivel: '没有可用于签名的私有 GPG 密钥。请先生成密钥。',
     gpgChavePublicaIndisponivel: '没有可用于验证的公共 GPG 密钥。',

package/dist/core/messages/zh/guardian/index.js

@@ -1,6 +1,2 @@
-// SPDX-License-Identifier: MIT
-/**
- * Guardian 消息
- */
 export * from './guardian-messages.js';
 export * from './watcher-hidden-messages.js';

package/dist/core/messages/zh/index.js

@@ -1,7 +1,3 @@
-// SPDX-License-Identifier: MIT
-/**
- * 中文消息
- */
 export * from './analysts/index.js';
 export * from './caretakers/index.js';
 export * from './cli/index.js';

package/dist/core/messages/zh/licenses/index.js

@@ -1,5 +1 @@
-// SPDX-License-Identifier: MIT
-/**
- * 许可证消息
- */
 export * from './licenses-messages.js';

package/dist/core/messages/zh/licenses/licenses-messages.js

@@ -1,6 +1,3 @@
-/**
- * Messages for license scanning (Chinese).
- */
 export const LicensasMensagens = {
     generatedNotices: '已生成声明:',
     disclaimerInserted: '已向以下文件插入免责声明:',

package/dist/core/messages/zh/log/index.js

@@ -1,7 +1,3 @@
-// SPDX-License-Identifier: MIT
-/**
- * Logging System
- */
 export * from './log.js';
 export * from './log-engine.js';
 export * from './log-helper.js';

package/dist/core/messages/zh/log/log-engine.js

@@ -1,6 +1 @@
-// SPDX-License-Identifier: MIT
-/**
- * Re-exports the log engine from pt/ since the engine logic is identical.
- * Translation happens via LogMensagens which is locale-specific.
- */
 export { logEngine, LogEngineAdaptativo } from '../../pt/log/log-engine.js';

package/dist/core/messages/zh/log/log-helper.js

@@ -1,40 +1,24 @@
-// @mahoraga-disable tipo-literal-inline-complexo ml-deep-nesting
-// SPDX-License-Identifier: MIT
-// Justification: inline types for logging system
-/**
- * 统一日志辅助系统
- * 整合 log-helpers.ts 和 log-helpers-inteligente.ts
- * 消除重复并通过 log-engine 集中逻辑
- */
 import { config } from '../../../config/index.js';
 import { ICONES_ARQUIVO, ICONES_DIAGNOSTICO, ICONES_FEEDBACK, ICONES_STATUS } from '../../shared/index.js';
 import { logEngine } from './log-engine.js';
 import { LogMensagens } from './log-messages.js';
-/**
- * 具有统一垃圾控制的分析师日志系统
- */
 export const logAnalistas = {
     ultimoProgressoGlobal: 0,
     contadorArquivos: 0,
     totalArquivos: 0,
     ultimoEmitMs: 0,
-    /** 初始化分析批次 */
     iniciarBatch(totalArquivos) {
         this.totalArquivos = totalArquivos;
         this.contadorArquivos = 0;
         this.ultimoProgressoGlobal = 0;
         this.ultimoEmitMs = 0;
-        // 仅在复杂/详细模式下使用 logEngine 进行一致格式化
         if (logEngine.contexto === 'complexo' || config.VERBOSE) {
             logEngine.log('info', LogMensagens.analistas.execucao.inicio_detalhado, {
                 totalArquivos: totalArquivos.toString()
             });
         }
-        // 在简单模式下,不发出冗余消息 (进度已显示)
     },
-    /** 分析师开始日志 (现在仅注册) */
     iniciandoAnalista(nomeAnalista, arquivo, tamanho) {
-        // [MUTE] 反垃圾: 仅在特定上下文中记录单个分析师
         const deveLogarIndividual = logEngine.contexto === 'complexo' || config.DEV_MODE || process.env.VERBOSE === 'true';
         if (deveLogarIndividual) {
             logEngine.log('debug', LogMensagens.analistas.execucao.inicio_detalhado, {
@@ -44,14 +28,12 @@ export const logAnalistas = {
             });
         }
     },
-    /** 文件处理完毕时递增计数器 */
     arquivoProcessado() {
         this.contadorArquivos++;
         if (logEngine.contexto !== 'complexo' && !config.DEV_MODE) {
             this.logProgressoGrupado();
         }
     },
-    /** 分析师完成日志 */
     concluido(nomeAnalista, arquivo, ocorrencias, duracao) {
         const deveLogarIndividual = logEngine.contexto === 'complexo' || config.DEV_MODE || process.env.VERBOSE === 'true';
         if (deveLogarIndividual) {
@@ -62,15 +44,11 @@ export const logAnalistas = {
             });
         }
     },
-    /** 智能分组进度日志 */
     logProgressoGrupado() {
         const porcentagem = Math.round(this.contadorArquivos / this.totalArquivos * 100);
         const agora = Date.now();
-        // 自适应密度: 小型项目 5%,大型项目 10%
         const passo = this.totalArquivos < 200 ? 5 : 10;
-        // 频率限制: 每秒最多 2 次更新
         const minIntervalMs = 500;
-        // 在自适应间隔更新进度,带反垃圾
         if (porcentagem - this.ultimoProgressoGlobal >= passo || this.contadorArquivos === this.totalArquivos) {
             if (agora - this.ultimoEmitMs >= minIntervalMs || this.contadorArquivos === this.totalArquivos) {
                 logEngine.log('info', `${ICONES_DIAGNOSTICO.progresso} 进度: {arquivosProcessados}/{totalArquivos} ({percentual}%)`, {
@@ -83,7 +61,6 @@ export const logAnalistas = {
             }
         }
     },
-    /** 完成分析批次 */
     finalizarBatch(totalOcorrencias, duracaoTotal) {
         if (logEngine.contexto === 'simples') {
             logEngine.log('info', `${ICONES_STATUS.ok} 分析已完成 - 发现 {totalOcorrencias} 个问题`, {
@@ -97,21 +74,18 @@ export const logAnalistas = {
             });
         }
     },
-    /** 超时始终重要 - 使用 logEngine */
     timeout(nomeAnalista, duracao) {
         logEngine.log('aviso', LogMensagens.analistas.execucao.timeout, {
             analista: nomeAnalista,
             tempo: duracao.toString()
         });
     },
-    /** 错误始终重要 - 使用 logEngine */
     erro(nomeAnalista, erro) {
         logEngine.log('erro', LogMensagens.analistas.execucao.erro, {
             analista: nomeAnalista,
             erro
         });
     },
-    /** 复杂项目的性能 */
     performance(dados) {
         if (logEngine.contexto === 'complexo' || config.DEV_MODE) {
             logEngine.log('info', LogMensagens.analistas.metricas.performance, {
@@ -121,9 +95,6 @@ export const logAnalistas = {
         }
     }
 };
-/**
- * Logging system for scanner (now via logEngine)
- */
 export const logVarredor = {
     iniciarVarredura(diretorio) {
         if (logEngine.contexto !== 'simples') {
@@ -156,9 +127,6 @@ export const logVarredor = {
         });
     }
 };
-/**
- * Logging system for the main system (via logEngine)
- */
 export const logSistema = {
     inicializacao() {
         if (logEngine.contexto !== 'simples') {
@@ -174,7 +142,6 @@ export const logSistema = {
         const detalhesStr = detalhes ? ` - ${detalhes}` : '';
         logEngine.log('erro', `${ICONES_STATUS.falha} 错误: ${mensagem}${detalhesStr}`, {});
     },
-    // Auto fixes
     autoFixNenhumaCorrecao() {
         logEngine.log('info', LogMensagens.sistema.correcoes.nenhuma_disponivel, {});
     },
@@ -228,7 +195,6 @@ export const logSistema = {
             erro
         });
     },
-    // Diagnostic processing
     processamentoFixDetectada() {
         logEngine.log('info', LogMensagens.sistema.processamento.fix_detectada, {});
     },
@@ -301,7 +267,6 @@ export const logSistema = {
             quantidade: quantidade.toString()
         });
     },
-    // System update
     atualizacaoExecutando(comando) {
         logEngine.log('info', LogMensagens.sistema.atualizacao.executando, {
             comando
@@ -318,7 +283,6 @@ export const logSistema = {
             detalhe
         });
     },
-    // Performance
     performanceRegressaoDetectada(limite) {
         logEngine.log('aviso', LogMensagens.sistema.performance.regressao_detectada, {
             limite: limite.toString()
@@ -327,14 +291,12 @@ export const logSistema = {
     performanceSemRegressoes() {
         logEngine.log('info', LogMensagens.sistema.performance.sem_regressoes, {});
     },
-    // Pruning
     podaCancelada() {
         logEngine.log('info', LogMensagens.sistema.poda.cancelada, {});
     },
     podaConcluida() {
         logEngine.log('info', LogMensagens.sistema.poda.concluida, {});
     },
-    // Reversal
     reversaoNenhumMove(arquivo) {
         logEngine.log('erro', LogMensagens.sistema.reversao.nenhum_move, {
             arquivo
@@ -356,9 +318,6 @@ export const logSistema = {
         });
     }
 };
-/**
- * Logging system for filters (via logEngine)
- */
 export const logFiltros = {
     incluindo(pattern, matches) {
         if (config.VERBOSE || logEngine.contexto === 'complexo') {
@@ -385,9 +344,6 @@ export const logFiltros = {
         }
     }
 };
-/**
- * Logging system for project (via logEngine)
- */
 export const logProjeto = {
     detectado(tipo, confianca) {
         logEngine.log('info', LogMensagens.projeto.detectado, {
@@ -427,9 +383,6 @@ export const logProjeto = {
         }
     }
 };
-/**
- * Logging system for occurrences (via logEngine)
- */
 export const logOcorrencias = {
     critica(mensagem, arquivo, linha) {
         logEngine.log('erro', LogMensagens.ocorrencias.critica, {
@@ -446,9 +399,6 @@ export const logOcorrencias = {
         });
     }
 };
-/**
- * Logging system for reports (via logEngine)
- */
 export const logRelatorio = {
     gerado(caminho, formato) {
         logEngine.log('info', `${ICONES_ARQUIVO.arquivo} ${formato} 报告已生成: ${caminho}`, {});
@@ -471,11 +421,7 @@ export const logRelatorio = {
         logEngine.log('aviso', LogMensagens.relatorio.funcoes_longas, {});
     }
 };
-/**
- * Logging system for automation (via logEngine)
- */
 export const logAuto = {
-    // Reversal map
     mapaReversaoErroCarregar(erro) {
         logEngine.log('erro', LogMensagens.sistema.auto.mapa_reversao.erro_carregar, {
             erro
@@ -534,7 +480,6 @@ export const logAuto = {
     mapaReversaoNenhumEncontrado() {
         logEngine.log('info', LogMensagens.sistema.auto.mapa_reversao.nenhum_encontrado, {});
     },
-    // Pruning
     podaNenhumArquivo() {
         logEngine.log('info', LogMensagens.sistema.auto.poda.nenhum_arquivo, {});
     },
@@ -553,7 +498,6 @@ export const logAuto = {
             arquivo
         });
     },
-    // Structure corrector
     corretorErroCriarDiretorio(destino, erro) {
         logEngine.log('erro', LogMensagens.sistema.auto.corretor.erro_criar_diretorio, {
             destino,
@@ -572,7 +516,6 @@ export const logAuto = {
             erro
         });
     },
-    // Specific plugin
     pluginIgnorado(plugin, erro) {
         logEngine.log('aviso', LogMensagens.auto.plugin_ignorado, {
             plugin,
@@ -596,9 +539,6 @@ export const logAuto = {
         });
     }
 };
-/**
- * Logging system for Guardian (via logEngine)
- */
 export const logGuardian = {
     integridadeOk() {
         logEngine.log('info', LogMensagens.guardian.integridade_ok, {});
@@ -626,7 +566,6 @@ export const logGuardian = {
     avisosEncontrados() {
         logEngine.log('aviso', LogMensagens.guardian.avisos_encontrados, {});
     },
-    // Guardian command specific
     fullScanAviso() {
         logEngine.log('aviso', LogMensagens.guardian.full_scan_aviso, {});
     },
@@ -673,7 +612,6 @@ export const logGuardian = {
             erro
         });
     },
-    // Generic method for other Guardian messages
     info(mensagem) {
         logEngine.log('info', `${ICONES_FEEDBACK.info} ${mensagem}`, {});
     },
@@ -681,9 +619,6 @@ export const logGuardian = {
         logEngine.log('aviso', `${ICONES_FEEDBACK.atencao} ${mensagem}`, {});
     }
 };
-/**
- * Wise advisor for developer well-being
- */
 export const logConselheiro = {
     volumeAlto() {
         logEngine.log('aviso', LogMensagens.conselheiro.volume_alto, {});
@@ -700,9 +635,6 @@ export const logConselheiro = {
         });
     }
 };
-/**
- * Logging system for Metrics
- */
 export const logMetricas = {
     execucoesRegistradas(quantidade) {
         logEngine.log('info', LogMensagens.metricas.execucoes_registradas, {
@@ -713,9 +645,6 @@ export const logMetricas = {
         logEngine.log('aviso', LogMensagens.metricas.nenhum_historico, {});
     }
 };
-/**
- * Logging system for Core (parsing, etc.)
- */
 export const logCore = {
     erroBabel(erro, arquivo) {
         logEngine.log('debug', LogMensagens.core.parsing.erro_babel, {
@@ -768,7 +697,6 @@ export const logCore = {
             erro
         });
     },
-    // Plugins
     erroCarregarPlugin(nome, erro) {
         logEngine.log('debug', LogMensagens.core.plugins.erro_carregar, {
             nome,

package/dist/core/messages/zh/log/log-messages.js

@@ -1,8 +1,3 @@
-// SPDX-License-Identifier: MIT
-/**
- * 集中化上下文日志消息系统
- * 自动适应项目类型和复杂度
- */
 import { ICONES_ACAO, ICONES_ARQUIVO, ICONES_COMANDO, ICONES_DIAGNOSTICO, ICONES_FEEDBACK, ICONES_NIVEL, ICONES_RELATORIO, ICONES_STATUS } from '../../shared/icons.js';
 export const LogMensagens = {
     sistema: {
@@ -81,7 +76,7 @@ export const LogMensagens = {
             erros_criticos: `${ICONES_RELATORIO.error} 发现 {total} 个严重错误 - 请优先处理`,
             avisos_encontrados: `${ICONES_RELATORIO.warning} 发现 {total} 个警告`,
             quick_fixes_muitos: `${ICONES_ACAO.correcao} 有 {total} 个自动修正可用:`,
-            quick_fixes_comando: '   → SUKUNA_ALLOW_MUTATE_FS=1 npm run diagnosticar --fix',
+            quick_fixes_comando: '   → MAHORAGA_ALLOW_MUTATE_FS=1 npm run diagnosticar --fix',
             quick_fixes_executar: '   (命令已就绪可运行)',
             todos_muitos: `${ICONES_RELATORIO.lista} 发现 {total} 个 TODO - 建议使用 --include 聚焦特定区域`,
             todos_poucos: `${ICONES_RELATORIO.lista} 发现 {total} 个 TODO - 控制良好!`,
@@ -101,10 +96,8 @@ export const LogMensagens = {
     },
     analistas: {
         execucao: {
-            // 小型项目的简单日志
             inicio_simples: `${ICONES_DIAGNOSTICO.inicio} 正在分析 {arquivo}`,
             sucesso_simples: `${ICONES_STATUS.ok} {arquivo}: {ocorrencias} 个问题`,
-            // 大型项目的详细日志
             inicio_detalhado: `${ICONES_DIAGNOSTICO.inicio} 在 {arquivo} ({tamanho}kb) 上运行 '{analista}'`,
             sucesso_detalhado: `${ICONES_STATUS.ok} '{analista}' 完成: {ocorrencias} 个出现项 ({tempo}ms)`,
             timeout: `${ICONES_FEEDBACK.atencao} 分析员 '{analista}' 超时,已耗时 {tempo}ms`,
@@ -166,7 +159,6 @@ export const LogMensagens = {
         modo_permissivo: `${ICONES_DIAGNOSTICO.guardian} ${ICONES_NIVEL.aviso} 宽松模式: 继续操作,风险自负。`,
         scan_only: `${ICONES_DIAGNOSTICO.guardian} ${ICONES_NIVEL.info} 仅扫描模式: 已映射 {arquivos} 个文件。`,
         avisos_encontrados: `${ICONES_DIAGNOSTICO.guardian} ${ICONES_NIVEL.aviso} 存在警告级别的出现项`,
-        // Guardian 命令
         full_scan_aviso: `${ICONES_NIVEL.aviso} --full-scan 已激活: 扩展范围的基线将不会持久化。`,
         full_scan_warning_baseline: `${ICONES_NIVEL.aviso} --full-scan 已激活,但将创建临时扩展范围的基线。`,
         aceitando_baseline: `\n${ICONES_COMANDO.atualizar} 正在接受新的完整性基线...\n`,
@@ -218,41 +210,31 @@ export const LogMensagens = {
         }
     }
 };
-/**
- * 适应不同项目类型的上下文配置
- */
 export const LogContextConfiguracao = {
-    // 简单项目: 文件少,一个开发者
     simples: {
         nivel_detalhamento: 'basico',
         mostrar_performance: false,
         mostrar_cache: false,
         mostrar_workers: false,
         formato_arquivo: 'nome_apenas',
-        // 仅文件名,不含完整路径
         agrupar_ocorrencias: true
     },
-    // 中等项目: 小团队,多种语言
     medio: {
         nivel_detalhamento: 'moderado',
         mostrar_performance: true,
         mostrar_cache: false,
         mostrar_workers: false,
         formato_arquivo: 'relativo',
-        // 相对路径
         agrupar_ocorrencias: true
     },
-    // 复杂项目: 大团队,CI/CD,多模块
     complexo: {
         nivel_detalhamento: 'completo',
         mostrar_performance: true,
         mostrar_cache: true,
         mostrar_workers: true,
         formato_arquivo: 'completo',
-        // 完整路径 + 元数据
         agrupar_ocorrencias: false
     },
-    // CI/CD 环境: 结构化日志,无颜色
     ci: {
         nivel_detalhamento: 'estruturado',
         mostrar_performance: true,

package/dist/core/messages/zh/log/log.js

@@ -1,9 +1,7 @@
 import { chalk, config } from '../../../config/index.js';
 import { isJsonMode } from '../../../../shared/helpers/index.js';
-// Reexport for tests to configure flags without importing cosmos directly
 export { config } from '../../../config/index.js';
 export const LOG_SIMBOLOS = {
-    // Severity level prefixes with ANSI colors
     info: '[INFO]',
     sucesso: '[OK]',
     erro: '[ERROR]',
@@ -16,26 +14,22 @@ export const LOG_SIMBOLOS = {
     pasta: '[DIR]'
 };
 function shouldSilence() {
-    // JSON mode always silences visual logs
     if (isJsonMode()) {
         return true;
     }
-    if (process.env.SUKUNA_FORCE_SILENT_JSON === '1') {
+    if (process.env.MAHORAGA_FORCE_SILENT_JSON === '1') {
         return true;
     }
     return config.REPORT_SILENCE_LOGS;
 }
 function shouldSuppressParcial(msg) {
     try {
-        // Allows quick override via short env variable SUKUNA_SUPPRESS_PARCIAL=1
-        if (!config.SUPPRESS_PARCIAL_LOGS && process.env.SUKUNA_SUPPRESS_PARCIAL !== '1') {
+        if (!config.SUPPRESS_PARCIAL_LOGS && process.env.MAHORAGA_SUPPRESS_PARCIAL !== '1') {
             return false;
         }
         if (!msg || typeof msg !== 'string') {
             return false;
         }
-        // Suppresses when substring 'partial' (case-insensitive) appears anywhere.
-        // This covers 'partial' and variations like 'partially'.
         return /parcial/i.test(msg);
     }
     catch {
@@ -43,21 +37,18 @@ function shouldSuppressParcial(msg) {
     }
 }
 function isDebugMode() {
-    return config.DEV_MODE || process.env.SUKUNA_DEBUG === 'true';
+    return config.DEV_MODE || process.env.MAHORAGA_DEBUG === 'true';
 }
 function shouldLogLevel(nivel) {
     const niveis = ['erro', 'aviso', 'info', 'debug'];
     const nivelAtual = niveis.indexOf(config.LOG_LEVEL);
     const nivelMensagem = niveis.indexOf(nivel);
-    // Error and success are always displayed (high priority)
     if (nivel === 'erro' || nivel === 'sucesso') {
         return true;
     }
-    // Debug is only displayed in debug mode or if LOG_LEVEL=debug
     if (nivel === 'debug') {
         return isDebugMode() || config.LOG_LEVEL === 'debug';
     }
-    // For other levels, checks if within threshold
     return nivelMensagem <= nivelAtual;
 }
 function getTimestamp() {
@@ -74,11 +65,8 @@ function stripLeadingSimbolos(msg) {
         return msg;
     }
     const ansiRegex = /[\u001B\u009B][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]/g;
-    // Remove ANSI to evaluate beginning; we will keep output without styles
     let plain = msg.replace(ansiRegex, '');
-    // Normalizes line breaks and leading spaces
     plain = plain.replace(/^\s+/, '');
-    // candidates: symbols from map + frequent extras used in messages
     const extras = [];
     const candidatos = Array.from(new Set([...Object.values(LOG_SIMBOLOS), ...extras])).filter(Boolean);
     let mudou = true;
@@ -93,14 +81,11 @@ function stripLeadingSimbolos(msg) {
             }
         }
     }
-    // Remaining spaces after removal
     return plain.trimStart();
 }
-// Exported for formatting tests; internal use in logger.
 export function formatarLinha({ nivel, mensagem, sanitize = true }) {
     const ts = getTimestamp();
     const colNivelRaw = nivel.toUpperCase().padEnd(7);
-    // Resolve possible 'chalk' forms (function or mocked object with .bold)
     const hasBold = (valor) => !!valor && typeof valor.bold === 'function';
     const resolveStyle = (valor) => {
         if (typeof valor === 'function') {
@@ -132,12 +117,10 @@ export function formatarLinha({ nivel, mensagem, sanitize = true }) {
     const boldFn = resolveStyle(chalk.bold);
     const colNivel = boldFn(colNivelRaw);
     const corpo = sanitize ? stripLeadingSimbolos(mensagem) : mensagem;
-    // We highlight messages (error/warning/success) to reinforce visibility.
     const corpoFmt = nivel === 'info' || nivel === 'debug' ? corpo : cor(corpo);
     const grayFn = typeof chalk.gray === 'function' ? chalk.gray : (string) => string;
     const linha = `${grayFn(ts)} ${colNivel} ${corpoFmt}`;
-    // Centers loose lines only with explicit opt-in (SUKUNA_CENTER=1)
-    if (!process.env.VITEST && process.env.SUKUNA_CENTER === '1') {
+    if (!process.env.VITEST && process.env.MAHORAGA_CENTER === '1') {
         try {
             const cols = obterColunasTerm();
             const out = typeof process.stdout.isTTY !== 'undefined' ? process.stdout : undefined;
@@ -152,17 +135,11 @@ export function formatarLinha({ nivel, mensagem, sanitize = true }) {
             }
         }
         catch {
-            // If centering fails, return normal line
         }
     }
     return linha;
 }
-/**
- * Formats a multi-line block with consistent indentation and light frame.
- * Useful for sections (phases) or compact summaries.
- */
 function obterColunasTerm() {
-    // Tries to get terminal width safely
     try {
         const out = typeof process.stdout.columns !== 'undefined' ? process.stdout : undefined;
         const cols = out?.columns;
@@ -171,8 +148,7 @@ function obterColunasTerm() {
         }
     }
     catch { }
-    // Allows explicit override via env and fallback of common variables
-    const envOverride = Number(process.env.SUKUNA_FRAME_MAX_COLS ?? '0');
+    const envOverride = Number(process.env.MAHORAGA_FRAME_MAX_COLS ?? '0');
     if (Number.isFinite(envOverride) && envOverride > 0) {
         return envOverride;
     }
@@ -182,10 +158,8 @@ function obterColunasTerm() {
 function calcularLarguraInterna(titulo, linhas, larguraMax) {
     const ANSI_REGEX = /[\u001B\u009B][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]/g;
     const visLen = (string) => (string || '').replace(ANSI_REGEX, '').length;
-    // Desired width by content, with standard ceiling (100) if not specified
     const desejada = Math.min(100, Math.max(visLen(titulo) + 4, ...linhas.map(linha => visLen(linha) + 4), 20));
     const preferida = typeof larguraMax === 'number' ? Math.max(20, Math.min(larguraMax, 120)) : desejada;
-    // Upper limit by terminal width (responsive)
     const cols = obterColunasTerm();
     const tetoTela = typeof cols === 'number' && cols > 0 ? Math.max(20, Math.min(cols, 120)) : 120;
     const width = Math.max(20, Math.min(preferida, tetoTela));
@@ -199,7 +173,6 @@ function calcularLarguraInterna(titulo, linhas, larguraMax) {
     };
 }
 export function formatarBloco(titulo, linhas, corTitulo = typeof chalk.bold === 'function' ? chalk.bold : (string) => string, larguraMax) {
-    // ANSI-aware utilities to measure/compose by visible width
     const { width, maxInner, visLen, ANSI_REGEX } = calcularLarguraInterna(titulo, linhas, larguraMax);
     const padFimVisible = (string, target) => {
         const diff = target - visLen(string);
@@ -209,14 +182,12 @@ export function formatarBloco(titulo, linhas, corTitulo = typeof chalk.bold ===
         if (visLen(string) <= max) {
             return string;
         }
-        // Preserves ANSI sequences, counting only visible width
         let out = '';
         let count = 0;
         let indice = 0;
         while (indice < string.length && count < max - 1) {
             const ch = string[indice];
             if (ch === '\u001B' || ch === '\u009B') {
-                // Copies entire ANSI sequence
                 const metrica = string.slice(indice).match(ANSI_REGEX);
                 if (metrica?.index === 0) {
                     out += metrica[0];
@@ -236,14 +207,12 @@ export function formatarBloco(titulo, linhas, corTitulo = typeof chalk.bold ===
     const normalizar = (string) => truncateVisible(string, maxInner);
     const corpo = linhas.map(linha => `│ ${padFimVisible(normalizar(linha), maxInner)}│`).join('\n');
     const headTxt = `│ ${padFimVisible(normalizar(titulo), maxInner)}│`;
-    // Ensures corTitulo works even when mocked as object
     const corTituloFn = typeof corTitulo === 'function' ? corTitulo : (string) => string;
     const gray = typeof chalk.gray === 'function' ? chalk.gray : (x) => x;
     return [gray(topo), corTituloFn(headTxt), gray(corpo), gray(base)].filter(Boolean).join('\n');
 }
-// Optional ASCII frame fallback (avoids mojibake on Windows redirects)
 function deveUsarAsciiFrames() {
-    return process.env.SUKUNA_ASCII_FRAMES === '1';
+    return process.env.MAHORAGA_ASCII_FRAMES === '1';
 }
 function converterMolduraParaAscii(bloco) {
     return bloco.replaceAll('┌', '+').replaceAll('┐', '+').replaceAll('└', '+').replaceAll('┘', '+').replaceAll('─', '-').replaceAll('│', '|');
@@ -292,8 +261,6 @@ export const log = {
             mensagem: msg
         }));
     },
-    // INFO variant that preserves inline styles/colors (no symbol sanitization),
-    // useful for aligning columns while keeping colored numbers.
     infoSemSanitizar(msg) {
         if (shouldSilence()) {
             return;
@@ -310,8 +277,6 @@ export const log = {
             sanitize: false
         }));
     },
-    // INFO message with styled body (bold + blue) and no sanitization,
-    // preserving colors within the body. Useful for short titles and summaries.
     infoDestaque(msg) {
         if (shouldSilence()) {
             return;
@@ -384,12 +349,10 @@ export const log = {
     calcularLargura(titulo, linhas, larguraMax) {
         return calcularLarguraInterna(titulo, linhas, larguraMax).width;
     },
-    // Prints a framed block directly (without logger prefix) with optional ASCII fallback
     imprimirBloco(titulo, linhas, corTitulo = typeof chalk.bold === 'function' ? chalk.bold : (string) => string, larguraMax) {
         if (shouldSilence()) {
             return;
         }
-        // Suppresses blocks containing the word 'partial' when configured
         if (config.SUPPRESS_PARCIAL_LOGS) {
             if (shouldSuppressParcial(titulo)) {
                 return;
@@ -402,14 +365,12 @@ export const log = {
         }
         const bloco = formatarBloco(titulo, linhas, corTitulo, larguraMax);
         const out = deveUsarAsciiFrames() ? converterMolduraParaAscii(bloco) : bloco;
-        // Centers block only with explicit opt-in (SUKUNA_CENTER=1)
-        if (!process.env.VITEST && process.env.SUKUNA_CENTER === '1') {
+        if (!process.env.VITEST && process.env.MAHORAGA_CENTER === '1') {
             try {
                 const lines = out.split('\n');
                 if (!lines.length) {
                     return;
                 }
-                // measures visible width of frame (top line)
                 const ANSI_REGEX = /[\u001B\u009B][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]/g;
                 const visibleLen = (string) => string.replace(ANSI_REGEX, '').length;
                 const frameWidth = Math.max(...lines.map(linha => visibleLen(linha)));
@@ -425,7 +386,6 @@ export const log = {
                 }
             }
             catch {
-                // If centering fails, print normally
             }
         }
     }