@mocoto/mahoraga 0.15.1 → 0.15.3

package/{docs → Docs}/.obsidian/graph.json

@@ -17,6 +17,6 @@
   "repelStrength": 10,
   "linkStrength": 1,
   "linkDistance": 250,
-  "scale": 1,
+  "scale": 0.6666666666666666,
   "close": true
 }

package/{docs → Docs}/.obsidian/workspace.json

@@ -4,21 +4,21 @@
     "type": "split",
     "children": [
       {
-        "id": "2dae1c0919723f46",
+        "id": "f49eb26fe94f5853",
         "type": "tabs",
         "children": [
           {
-            "id": "d13e1d2e479b3201",
+            "id": "8dedf7c146f5cebf",
             "type": "leaf",
             "state": {
               "type": "markdown",
               "state": {
-                "file": "02-componentes/_index.md",
+                "file": "03-guias/testes.md",
                 "mode": "source",
                 "source": false
               },
               "icon": "lucide-file",
-              "title": "_index"
+              "title": "testes"
             }
           }
         ]
@@ -94,6 +94,7 @@
             "state": {
               "type": "backlink",
               "state": {
+                "file": "06-feedbacks/feedback.md",
                 "collapseAll": false,
                 "extraContext": false,
                 "sortOrder": "alphabetical",
@@ -103,7 +104,7 @@
                 "unlinkedCollapsed": true
               },
               "icon": "links-coming-in",
-              "title": "Links inversos"
+              "title": "Links inversos para feedback"
             }
           },
           {
@@ -180,17 +181,24 @@
       "bases:Criar nova base": false
     }
   },
-  "active": "d13e1d2e479b3201",
+  "active": "8dedf7c146f5cebf",
   "lastOpenFiles": [
+    "03-guias/contribuindo.md",
+    "03-guias/_index.md",
+    "02-componentes/supressao-inline.md",
+    "02-componentes/configuracao.md",
+    "02-componentes/_index.md",
+    "01-arquitetura/_index.md",
+    "01-arquitetura/ADR-001-estrutura-testes.md",
+    "06-feedbacks/feedback.md",
+    "Sem título.md",
+    "Sem título",
+    "Sem título.base",
     "templates/guia.md",
     "templates/componente.md",
     "templates/ADR.md",
     "04-glossario/termos.md",
     "03-guias/testes.md",
-    "03-guias/contribuindo.md",
-    "02-componentes/_index.md",
-    "01-arquitetura/ADR-001-estrutura-testes.md",
-    "01-arquitetura/_index.md",
     "_home.md"
   ]
 }

package/{docs → Docs}/01-arquitetura/ADR-001-estrutura-testes.md

@@ -22,8 +22,8 @@ O projeto precisava de uma estrutura de testes que suportasse mocking de módulo
 ## Consequências
 
 - Testes rodam em ~30s (full suite) e ~6s (parciais)
-- 222 test files, 3116 testes
-- Coverage total: ~47% (target: 56%+)
+- 238 test files, 3276 testes
+- Coverage total: ~48% (target: 56%+)
 
 ## Alternativas Consideradas
 

package/Docs/02-componentes/configuracao.md

@@ -0,0 +1,110 @@
+---
+Proveniência e Autoria: Este documento integra o projeto @mocoto/mahoraga (licença MIT-0).
+tags: [componente]
+status: aceito
+created: 2026-07-25
+---
+
+# Configuração (`mahoraga.config.json`)
+
+## Fluxo de Carregamento
+
+```
+mahoraga.config.json
+       │
+       ▼
+  converterConfigSimplificada()
+       │  Transforma chaves amigáveis (ex: "exclude")
+       │  em chaves internas (ex: "INCLUDE_EXCLUDE_RULES")
+       ▼
+  mesclarProfundo(config, resultado)
+       │  Deep merge com precedência:
+       │  1. CLI flags / env vars
+       │  2. mahoraga.config.json
+       │  3. System defaults (configPadrao)
+       ▼
+  config global (acessível via import { config } from '@core/config')
+```
+
+## Comportamento de Merge
+
+O `mesclarProfundo` aplica regras diferentes por tipo:
+
+| Tipo | Comportamento | Exemplo |
+|------|--------------|---------|
+| Objeto plano | Merge recursivo | `languages`, `rules`, `detectorMarkdown`, `autoFix` |
+| Array (`exclude`) | **Aditivo**: mergeado com defaults do sistema | `["temp/**"]` adiciona aos defaults |
+| Primitivo | Substitui o valor default | `locale: "en"` |
+
+### Caso crítico: `exclude`
+
+Diferentemente de outros sistemas, o campo `exclude` no `mahoraga.config.json` é **aditivo**:
+
+```jsonc
+{
+  "exclude": ["temp/**", "logs/**"]
+}
+```
+
+O resultado final será: `[...defaultsDoSistema, "temp/**", "logs/**"]` — os defaults nunca são perdidos.
+
+Isso é implementado em `converterConfigSimplificada` (`src/core/config/config.ts`), que faz o merge com `configPadrao.INCLUDE_EXCLUDE_RULES.globalExcludeGlob` antes de armazenar.
+
+## Hierarquia de Precedência
+
+1. **CLI flags**: `--include`, `--exclude` (máxima prioridade)
+2. **Environment variables**: `MAHORAGA_*`
+3. **`mahoraga.config.json** (ou `src/config.json` como fallback)
+4. **System defaults** (`configPadrao` em `src/core/config/config.ts`)
+
+## Arquitetura
+
+### `src/core/config/config.ts`
+
+- `configPadrao` — objeto com todos os valores default do sistema
+- `config` — clone profundo de `configPadrao`, exportado como singleton
+- `converterConfigSimplificada(raw)` — transforma chaves do usuário para formato interno
+- `mesclarProfundo(target, src)` — merge recursivo com proteção prototype pollution
+- `inicializarConfigDinamica()` — carrega e mergeia config do arquivo + env + CLI
+
+### `src/core/config/excludes-padrao.ts`
+
+- `EXCLUDES_PADRAO` — categorias de exclusão por tipo de projeto
+- `getExcludesRecomendados(tipo)` — obtém defaults baseados no tipo de projeto detectado
+- `mesclarConfigExcludes(usuario, tipo)` — merge dos excludes do usuário com defaults
+- `isPadraoExclusaoSeguro(padrao)` — evita padrões perigosos como `**/*`
+
+## Componentes Relacionados
+
+- `src/core/config/include-exclude.ts` — avaliação de include/exclude via micromatch
+- `src/shared/helpers/suppressao.ts` — supressão inline via `@mahoraga-disable`
+- `src/shared/helpers/rule-config.ts` — configuração por regra (`rules.nome-da-regra.exclude`)
+
+## Exemplo Completo
+
+```jsonc
+{
+  "locale": "pt",
+  "languages": {
+    "typescript": true,
+    "javascript": true,
+    "shell": true
+  },
+  "exclude": ["temp/**"],
+  "suppress": {
+    "paths": ["**/tests/**"],
+    "severity": { "no-console": "warning" }
+  },
+  "rules": {
+    "ml-magic-numbers": {
+      "severity": "off"
+    }
+  },
+  "detectorMarkdown": {
+    "checkReferences": false,
+    "whitelist": {
+      "dirs": ["Docs"]
+    }
+  }
+}
+```

package/{docs → Docs}/05-referencias/_index.md

@@ -50,6 +50,7 @@ updated: 2026-07-25
 | `tsconfig.json` | Configuração TypeScript (paths, strict, ES2024) |
 | `vitest.config.ts` | Configuração de testes e aliases |
 | `eslint.config.js` | Configuração ESLint |
+| `mahoraga.config.json` | Configuração do Mahoraga (merge aditivo com defaults) |
 | `THIRD-PARTY-NOTICES.txt` | Atribuições de licenças |
 | `.github/workflows/ci.yml` | CI pipeline |
 | `.github/workflows/publish.yml` | Publicação no npm |

package/Docs/06-feedbacks/feedback.md

@@ -0,0 +1,74 @@
+# Feedback — Análise de Relatórios do Linter
+
+## Resumo
+
+3 relatórios analisados (`erro-001.json`, `aviso-001.json`, `info-001.json`). Nenhum problema real encontrado — todos são falsos positivos ou itens puramente informativos.
+
+---
+
+## Falsos Positivos
+
+### 1. `markdown-falta-proveniencia` (erro-001.json, 9 ocorrências)
+
+**Disparo em**: `Docs/*.md`, `README.md`
+
+**Problema**: O linter exige aviso de "Proveniência e Autoria" nas primeiras linhas de todo `.md`. Esse disclaimer é pertinente para instruções de agente (`AGENTS.md`, skills), mas não para documentação de usuário (`Docs/`, `README.md`).
+
+**Sugestão**: Ignorar a pasta `Docs/` e `README.md`, ou criar um allowlist/denylist de diretórios para essa regra.
+
+### 2. `codigo-fragil` — shebang ausente (aviso-001.json, husky.sh)
+
+**Disparo em**: `.husky/_/husky.sh`
+
+**Problema**: O arquivo é gerado automaticamente pelo husky. Arquivos gerados por ferramentas externas não devem ser escaneados.
+
+**Sugestão**: Adicionar `.husky/` ao ignore pattern, ou criar um arquivo de configuração `.linterignore`.
+
+### 3. `tailwindcss/regra` — left-0 + right-0 (aviso-001.json, Header.tsx:47)
+
+**Disparo em**: `src/app/components/Header.tsx:47`
+
+**Problema**: `left-0` + `right-0` em elemento `absolute` é padrão legítimo do Tailwind para esticar o elemento horizontalmente. Não é conflito.
+
+**Sugestão**: A regra deve entender que `left-0` + `right-0` em conjunto com `position: absolute/fixed` é intencional e válido. Ignorar quando detectar `absolute` ou `fixed` no mesmo elemento.
+
+### 4. `react/regra` — dangerouslySetInnerHTML (aviso-001.json, json-ld.tsx:17 e 23)
+
+**Disparo em**: `src/app/components/json-ld.tsx:17,23`
+
+**Problema**: O componente json-ld intencionalmente usa `dangerouslySetInnerHTML` para injetar JSON-LD schema.org. É o padrão recomendado pela documentação do Next.js para SEO.
+
+**Sugestão**: Permitir esse padrão quando o componente tiver nome sugestivo (ex: contendo "json-ld", "schema", "structured-data") ou via suppress comment.
+
+### 5. `codigo-fragil` / `boa-pratica-ausente` — shell script boas práticas (info-001.json, husky.sh)
+
+**Disparo em**: `.husky/_/husky.sh` — 6 ocorrências (`set -e`, `set -u`, `IFS`, `trap`, `main()`, `command -v`, debug mode, validação de argumentos)
+
+**Problema**: Mesmo que o item 2 — arquivo gerado por ferramenta. Além disso, `husky.sh` é um script auxiliar que não é executado diretamente pelo usuário.
+
+**Sugestão**: Ignorar `.husky/` completamente no escaneamento.
+
+### 6. `problema-documentacao` — magic-constants (info-001.json, ~25 ocorrências)
+
+**Disparo em**: Quase todos os arquivos `src/app/`, `src/lib/`, `vercel.ts`, `next.config.ts`, `src/proxy.ts`
+
+**Problema**: Números como `86400` (segundos em 1 dia) ou valores de configuração são detectados como "magic constants". Muitos desses são valores de configuração autoexplicativos ou já estão próximos do uso.
+
+**Sugestão**: A regra é muito barulhenta. Recomenda-se usar um limiar mais alto de confiança, ou filtrar valores que são amplamente conhecidos (ex: `60`, `3600`, `86400`, `1000`). Alternativamente, agrupar por arquivo em vez de listar cada ocorrência individualmente.
+
+---
+
+## Sugestões Gerais para o Linter
+
+| # | Sugestão |
+|---|----------|
+| 1 | Criar um mecanismo de `ignore` (arquivo `.linterignore` ou comentários `// linter-ignore`) |
+| 2 | Ignorar diretórios de ferramentas: `.husky/`, `.next/`, `node_modules/` |
+| 3 | Ignorar `Docs/` e `README.md` para regras de disclaimer de agente |
+| 4 | Reduzir verbose de regras de "magic constants" — consolidar ocorrências por arquivo |
+| 5 | Adicionar contexto de CSS: `left-0 + right-0` não é conflito quando `position` é `absolute/fixed` |
+| 6 | Adicionar allowlist de padrões para `dangerouslySetInnerHTML` (json-ld, schema, analytics snippets) |
+
+---
+
+*Gerado em 2026-07-25 com base na análise dos relatórios `erro-001.json`, `aviso-001.json` e `info-001.json`.*

package/{docs → Docs}/_home.md

@@ -42,10 +42,10 @@ Mahoraga é uma ferramenta CLI que funciona como "médico de projetos": analisa
 |---------|-------|
 | Versão | 0.15.1 |
 | Comandos CLI | 27 |
-| Arquivos de teste | ~230 |
-| Testes | ~3200 |
-| Cobertura (statements) | ~47% |
-| Source lines | ~22k |
+| Arquivos de teste | ~240 |
+| Testes | ~3300 |
+| Cobertura (statements) | ~48% |
+| Source lines | ~31k |
 | Diretórios em `src/` | 15+ |
 | Analisadores de linguagem | 11 |
 | Analisadores de CI/CD | 5 |

package/README.md

@@ -7,7 +7,10 @@ Proveniência e Autoria: Este documento integra o projeto @mocoto/mahoraga (lice
 <p><b>@mocoto/mahoraga</b>: CLI modular para análise, diagnóstico e manutenção de projetos JavaScript/TypeScript com suporte multi-linguagem<p>
 
 </div>
-ja que temos aqui esses 60 bastiões, vou manter o projeto no ar e em evolução pra ajuda-los, no momento esta passando por ajustes, mas ja ja fica no jeito. (obrigado por usar o mahoraga).
+
+Abre seu obsidian, se não tiver instalado instala. Vai em abrir cofre, vai no seu projeto onde o mahoraga esta instalado, vai em projeto/node_modules/@mocoto/mahoraga/Docs e clique em selecionar. A documentação vai estar como obsidian do jeito que voces gostam. Como eu ia usar o projeto só pra mim então eu exclui a documentão essa é nova e vai ser completada conforme o projeto avança, mas acho que ja serve pra voces iniciar.
+
+o mahoraga deve ser instalado como devdependence npm install @mocoto/mahoraga --save-dev depois arrumo certinho. to ocupado agora.
 
 Caso queira ajudar com relatórios de bugs e erros ou com sugestões, entre em contato pelo e-mail abaixo.
 
@@ -230,6 +233,13 @@ O Mahoraga lê um arquivo `mahoraga.config.json` na raiz do seu projeto. A confi
 2. `mahoraga.config.json` (ou `src/config.json` como fallback)
 3. System defaults (hardcoded)
 
+### Comportamento de Merge
+
+- **Objetos** (`languages`, `suppress`, `rules`, `detectorMarkdown`, `autoFix`, `ANALISE_LIMITES`, `nameConventions`): faz merge recursivo — você pode definir apenas os campos que deseja sobrescrever; os demais mantêm os defaults.
+- **Arrays** (`exclude`): são **aditivos** — os padrões que você definir em `exclude` são adicionados aos defaults do sistema, não os substituem. Se você quer excluir `temp/**` além dos defaults, basta incluir `"exclude": ["temp/**"]`.
+- **Primitivos** (`locale`, `verbose`, `LOG_LEVEL`, `GUARDIAN_ENABLED`, etc.): substituem o valor default quando definidos.
+- **`suppress.paths` e `suppress.filePatterns`**: substituem a lista de supressão (não é merge).
+
 ### Exemplo Completo
 
 ```jsonc
@@ -507,7 +517,7 @@ npm run lint           # ESLint
 ## Qualidade
 
 - **TypeScript estrito**: `strict: true`, `verbatimModuleSyntax: true`
-- **Testes com Vitest**: ~3200 testes em ~230 arquivos
+- **Testes com Vitest**: ~3300 testes em ~240 arquivos
 - **ESLint 10.x**: configuração strict
 - **Worker pool**: processamento paralelo
 - **i18n**: PT, EN, ZH, JA

package/dist/analysts/detectors/detector-bugs-ml.js

@@ -2,6 +2,7 @@ import { parse as babelParse } from '@babel/parser';
 import traverse from '@babel/traverse';
 import * as t from '@babel/types';
 import { getMessages } from '../../core/messages/index.js';
+import { isWhitelistedConstant } from '../../shared/helpers/index.js';
 const MAX_MESSAGE_PREVIEW_LENGTH = 60;
 const BUG_PATTERNS = [
     {
@@ -224,6 +225,10 @@ const BUG_PATTERNS = [
             const matches = content.matchAll(magicNumPattern);
             const results = [];
             for (const m of matches) {
+                const value = parseInt(m[0], 10);
+                if (isWhitelistedConstant(value, [])) {
+                    continue;
+                }
                 const line = contarLinhasAtePos(content, m.index);
                 const lineContent = content.split('\n')[line - 1] || '';
                 if (!lineContent.includes('const') && !lineContent.includes('let') && !lineContent.includes('var') && !lineContent.includes('//') && !lineContent.includes('/*')) {

package/dist/analysts/plugins/detector-markdown.js

@@ -8,9 +8,9 @@ const LICENCA_PADROES = {
     referenciasRisco: [/Stack\s*Overflow/i, /(?:^|https?:\/\/|\/\/)(?:[^\/\s@]+\.)?stackoverflow\.com(?::\d+)?(?:[\/?#]|$)/i, /\bassign\b/i, /\bcession\b/i]
 };
 const PADRAO_LISTA_BRANCA = {
-    paths: ['.github/copilot-instructions.md', 'docs/POLICY-PROVENIENCIA.md', 'docs/partials/AVISO-PROVENIENCIA.md'],
+    paths: ['.github/copilot-instructions.md', 'docs/POLICY-PROVENIENCIA.md', 'docs/partials/AVISO-PROVENIENCIA.md', 'README.md'],
     patterns: ['**/reports/**', 'docs/history/**', 'tests/**', 'tmp*.md'],
-    dirs: ['pre-public', 'preview-mahoraga', '.abandonados', '.deprecados', 'reports']
+    dirs: ['pre-public', 'preview-mahoraga', '.abandonados', '.deprecados', 'reports', 'docs']
 };
 function createRiskRegex() {
     const allPadroes = [...LICENCA_PADROES.incompativeis, ...LICENCA_PADROES.cessaoDireitos, ...LICENCA_PADROES.referenciasRisco].map(raiz => raiz.source).join('|');

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

@@ -5,6 +5,7 @@ import { messages } from '../../../core/messages/index.js';
 import { createLineLookup, maskJsComments } from '../../../shared/helpers/index.js';
 import { criarAnalista, criarOcorrencia } from '../../../types/index.js';
 const disableEnv = process.env.MAHORAGA_DISABLE_PLUGIN_REACT === '1';
+const ALLOWLIST_DANGEROUSLY_SET_INNER_HTML = /json-ld|schema|structured-data/i;
 function hasJSX(src) {
     const hasTagLike = /(^|[^A-Za-z0-9_$])<([A-Za-z][A-Za-z0-9]*)\b/.test(src);
     const hasFragment = /<>|<\/>|<\/\s*>|<\/\s*Fragment\s*>/i.test(src);
@@ -37,6 +38,9 @@ function collectReactIssues(src, relPath) {
         if (/speculationrules/.test(lineContent)) {
             continue;
         }
+        if (ALLOWLIST_DANGEROUSLY_SET_INNER_HTML.test(relPath)) {
+            continue;
+        }
         ocorrencias.push(warn(messages.ReactMensagens.dangerouslySetInnerHTML, relPath, line));
     }
     for (const match of src.matchAll(/<img[^>]*>/gi)) {
@@ -219,6 +223,9 @@ function parseReactWithBabel(scan, relPath) {
                                 return;
                             }
                         }
+                        if (ALLOWLIST_DANGEROUSLY_SET_INNER_HTML.test(tag)) {
+                            return;
+                        }
                         pushOnce(warn(messages.ReactMensagens.dangerouslySetInnerHTML, relPath, locLine));
                     }
                     const styleAttr = findAttr(attrs, 'style');

package/dist/cli/diagnostic/filters.js

@@ -52,11 +52,8 @@ export function detectarTipoProjeto(baseDir = process.cwd()) {
 export function getDefaultExcludes(tipoProjeto) {
     const configIncluirExcluir = config.INCLUDE_EXCLUDE_RULES;
     const globalExclude = configIncluirExcluir.globalExcludeGlob;
-    if (Array.isArray(globalExclude) && globalExclude.length > 0) {
-        return Array.from(new Set(globalExclude));
-    }
     const tipo = tipoProjeto ?? detectarTipoProjeto();
-    return mesclarConfigExcludes(null, tipo);
+    return mesclarConfigExcludes(globalExclude ?? null, tipo);
 }
 export function processarFiltros(opcoes) {
     const tipoProjeto = detectarTipoProjeto();

package/dist/core/config/config.js

@@ -205,10 +205,9 @@ function converterConfigSimplificada(config) {
         delete resultado.locales;
     }
     if (Array.isArray(config.exclude)) {
+        const defaults = configPadrao.INCLUDE_EXCLUDE_RULES.globalExcludeGlob;
         resultado.INCLUDE_EXCLUDE_RULES = {
-            globalExcludeGlob: config.exclude,
-            dirRules: {},
-            defaultExcludes: null
+            globalExcludeGlob: Array.from(new Set([...defaults, ...config.exclude])),
         };
         delete resultado.exclude;
     }

package/dist/core/config/excludes-padrao.js

@@ -1,6 +1,6 @@
 import { getMessages } from '../messages/index.js';
 export const EXCLUDES_PADRAO = {
-    padroesSistema: ['node_modules', '**/node_modules/**', 'dist', 'dist/**', '**/dist/**', 'out', 'out/**', '**/out/**', '.next', '.next/**', '**/.next/**', 'build/**', '**/build/**', '**/*.log', '**/*.lock', 'package.json', 'package-lock.json', 'yarn.lock', 'pnpm-lock.yaml', '**/.git/**', '.pnpm/**', 'mahoraga/**', '**/.mahoraga/**', 'preview-mahoraga/**', 'mahoraga/PREVIEW*', 'PREVIEW*', 'tests/fixtures/**', 'THIRD-PARTY-NOTICES.txt', '**/THIRD-PARTY-NOTICES.txt', '**/*LICENSE*', '**/*NOTICE*', '**/*CHANGELOG*', '**/*.min.js', '**/*.min.css', '**/bundle.*', '**/*generated*', '**/*autogenerated*'],
+    padroesSistema: ['node_modules', '**/node_modules/**', 'dist', 'dist/**', '**/dist/**', 'out', 'out/**', '**/out/**', '.next', '.next/**', '**/.next/**', 'build/**', '**/build/**', '**/*.log', '**/*.lock', 'package.json', 'package-lock.json', 'yarn.lock', 'pnpm-lock.yaml', '**/.git/**', '.pnpm/**', 'mahoraga/**', '**/.mahoraga/**', 'preview-mahoraga/**', 'mahoraga/PREVIEW*', 'PREVIEW*', 'tests/fixtures/**', 'THIRD-PARTY-NOTICES.txt', '**/THIRD-PARTY-NOTICES.txt', '**/*LICENSE*', '**/*NOTICE*', '**/*CHANGELOG*', '**/*.min.js', '**/*.min.css', '**/bundle.*', '**/*generated*', '**/*autogenerated*', '.husky/**', '**/.husky/**'],
     nodeJs: ['node_modules/**', '**/node_modules/**', 'npm-debug.log*', 'yarn-debug.log*', 'yarn-error.log*', '.npm', '.yarn', 'coverage/**', '**/coverage/**', '.nyc_output', 'dist/**', '**/dist/**', 'build/**', '**/build/**'],
     typeScript: ['dist/**', '**/dist/**', 'build/**', '**/build/**', '*.tsbuildinfo', '**/*.tsbuildinfo', '.tsbuildinfo', 'out/**', '**/out/**'],
     python: ['__pycache__/**', '**/__pycache__/**', '*.pyc', '**/*.pyc', '*.pyo', '**/*.pyo', '*.pyd', '**/*.pyd', '.Python', 'env/**', 'venv/**', '.env/**', 'pip-log.txt', 'pip-delete-this-directory.txt', '.tox/**', '.coverage', 'htmlcov/**', '.pytest_cache/**', '.mypy_cache/**'],
@@ -50,12 +50,13 @@ export function isPadraoExclusaoSeguro(padrao) {
 }
 export function mesclarConfigExcludes(configUsuario, tipoProjeto = 'generico') {
     if (configUsuario && Array.isArray(configUsuario) && configUsuario.length > 0) {
+        const defaults = getExcludesRecomendados(tipoProjeto);
         const padroesValidos = configUsuario.filter(isPadraoExclusaoSeguro);
         if (padroesValidos.length !== configUsuario.length) {
             const { SharedCommonMensagens } = getMessages();
             console.warn(SharedCommonMensagens.exclusaoInsegura(configUsuario.filter(caminho => !isPadraoExclusaoSeguro(caminho)).join(', ')));
         }
-        return Array.from(new Set(padroesValidos));
+        return Array.from(new Set([...defaults, ...padroesValidos]));
     }
     return getExcludesRecomendados(tipoProjeto);
 }

package/dist/reports/report-structure.js

@@ -4,18 +4,12 @@ export function gerarRelatorioEstrutura(mapa) {
     const desalinhados = mapa.filter((item) => item.ideal && item.atual !== item.ideal);
     if (desalinhados.length === 0) {
         return [
-            '# ?? Estrutura verificada',
+            RelatorioMensagens.estrutura.tituloVerificada,
             '',
-            '? Tudo está em sua camada ideal.',
+            RelatorioMensagens.estrutura.tudoIdeal,
             '',
         ].join('\\n');
     }
-    return [
-        RelatorioMensagens.estrutura.tituloVerificada,
-        '',
-        RelatorioMensagens.estrutura.tudoIdeal,
-        '',
-    ].join('\\n');
     return [
         RelatorioMensagens.estrutura.tituloDiagnostico,
         '',

package/dist/shared/helpers/magic-constants-whitelist.js

@@ -92,6 +92,16 @@ export const MATH_CONSTANTES = [{
         value: 1000,
         description: 'Milhar/conversão ms→s'
     }];
+export const TIME_CONSTANTES = [{
+        value: 60,
+        description: 'Segundos em um minuto'
+    }, {
+        value: 3600,
+        description: 'Segundos em uma hora'
+    }, {
+        value: 86400,
+        description: 'Segundos em um dia'
+    }];
 export const FRAMEWORK_WHITELISTS = {
     'Discord.js': DISCORD_LIMITES,
     Express: HTTP_STATUS_CODIGOS,
@@ -110,6 +120,9 @@ export function isWhitelistedConstant(value, frameworks, userWhitelist) {
     if (MATH_CONSTANTES.some(rule => rule.value === value)) {
         return true;
     }
+    if (TIME_CONSTANTES.some(rule => rule.value === value)) {
+        return true;
+    }
     if (COMUM_LIMITES.some(rule => rule.value === value)) {
         return true;
     }
@@ -125,7 +138,7 @@ export function isWhitelistedConstant(value, frameworks, userWhitelist) {
     return false;
 }
 export function getConstantDescription(value, frameworks) {
-    const allRules = [...MATH_CONSTANTES, ...COMUM_LIMITES, ...HTTP_STATUS_CODIGOS, ...frameworks.flatMap(arquivo => FRAMEWORK_WHITELISTS[arquivo] ?? [])];
+    const allRules = [...MATH_CONSTANTES, ...TIME_CONSTANTES, ...COMUM_LIMITES, ...HTTP_STATUS_CODIGOS, ...frameworks.flatMap(arquivo => FRAMEWORK_WHITELISTS[arquivo] ?? [])];
     const rule = allRules.find(raiz => raiz.value === value);
     return rule?.description;
 }

package/dist/types/processing/filters.js

@@ -29,11 +29,8 @@ export function expandIncludes(list) {
 export function getDefaultExcludes() {
     const configIncluirExcluir = config.INCLUDE_EXCLUDE_RULES;
     const globalExclude = configIncluirExcluir.globalExcludeGlob;
-    if (Array.isArray(globalExclude) && globalExclude.length > 0) {
-        return Array.from(new Set(configIncluirExcluir.globalExcludeGlob));
-    }
     const tipoProjeto = detectarTipoProjeto();
-    return mesclarConfigExcludes(null, tipoProjeto);
+    return mesclarConfigExcludes(globalExclude ?? null, tipoProjeto);
 }
 function detectarTipoProjeto() {
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mocoto/mahoraga",
-  "version": "0.15.1",
+  "version": "0.15.3",
   "type": "module",
   "description": "C.L.I modular para análise, diagnóstico e manutenção de projetos JavaScript/TypeScript e multi-stack leve",
   "author": "Italo Lopes",
@@ -27,12 +27,11 @@
     "security-check": "npm audit --production --audit-level=moderate",
     "test": "vitest run --passWithNoTests",
     "coverage": "vitest run --coverage",
-
     "diagnosticar": "mahoraga diagnosticar",
+    "diag": "mahoraga diagnosticar",
     "analistas": "mahoraga analistas",
     "metricas": "mahoraga metricas",
     "vulnerabilidades": "mahoraga vulnerabilidades scan",
-
     "imports": "mahoraga imports",
     "imports:scan": "mahoraga imports --scan",
     "imports:apply": "mahoraga imports --apply",
@@ -40,7 +39,6 @@
     "names:scan": "mahoraga names --scan",
     "names:apply": "mahoraga names --apply",
     "barrels": "mahoraga barrels",
-
     "formatar": "mahoraga formatar --write",
     "format:check": "mahoraga formatar --check",
     "podar": "mahoraga podar",
@@ -48,18 +46,15 @@
     "otimizar-svg": "mahoraga otimizar-svg --write",
     "atualizar": "mahoraga atualizar",
     "convert": "mahoraga convert",
-
     "perf:baseline": "mahoraga perf snapshot --baseline || true",
     "perf:compare": "mahoraga perf compare",
     "perf:gate": "mahoraga perf compare --threshold 0",
-
     "scan": "mahoraga licencas scan",
     "scan:root": "mahoraga licencas scan --root .",
     "licenses:json": "mahoraga licencas scan --json",
     "notices": "mahoraga licencas notices generate",
     "disclaimer:verify": "mahoraga licencas disclaimer verify",
     "add": "mahoraga licencas disclaimer add",
-
     "gha:scan": "mahoraga github-actions scan",
     "gha:report": "mahoraga github-actions report",
     "gha:gate": "mahoraga github-actions gate",
@@ -67,11 +62,9 @@
     "circleci:scan": "mahoraga circleci scan",
     "jenkins:scan": "mahoraga jenkins scan",
     "azure:scan": "mahoraga azure scan",
-
     "plugins:list": "mahoraga plugins list",
     "marketplace:search": "mahoraga marketplace search",
     "marketplace:list": "mahoraga marketplace list",
-
     "guardian": "mahoraga guardian",
     "reverter:listar": "mahoraga reverter listar",
     "reverter:status": "mahoraga reverter status"
@@ -99,7 +92,7 @@
     "access": "public"
   },
   "files": [
-    "docs",
+    "Docs",
     "dist",
     "README.md",
     "CHANGELOG.md",
@@ -128,11 +121,18 @@
     "yaml": "^2.9.0"
   },
   "devDependencies": {
+    "@mocoto/mahoraga": "0.15.2",
     "@types/micromatch": "^4.0.10",
     "@types/node": "^26.1.1",
+    "@typescript-eslint/eslint-plugin": "8.65.0",
+    "@typescript-eslint/parser": "8.65.0",
     "@vitest/coverage-istanbul": "^4.1.8",
     "@vitest/coverage-v8": "^4.1.8",
     "autoprefixer": "^10.5.4",
+    "eslint": "10.8.0",
+    "eslint-plugin-import-x": "4.17.1",
+    "eslint-plugin-simple-import-sort": "14.0.0",
+    "eslint-plugin-unused-imports": "4.4.1",
     "husky": "^9.1.7",
     "license-checker-rseidelsohn": "^5.0.1",
     "lint-staged": "^17.2.0",