@mocoto/mahoraga 0.14.0 → 0.14.1

package/dist/analysts/rust/detectors/detector-conventions.js

@@ -1,11 +1,13 @@
+// SPDX-License-Identifier: MIT
 import { messages } from '../../../core/messages/index.js';
 import { createLineLookup, maskRustComments } from '../../../shared/helpers/index.js';
 import { criarAnalista } from '../../../types/index.js';
-const disableEnv = process.env.MAHORAGA_DISABLE_PLUGIN_RUST === '1';
+const disableEnv = process.env.SUKUNA_DISABLE_PLUGIN_RUST === '1';
 function detectConventions(src, relPath) {
     const ocorrencias = [];
     const lineOf = createLineLookup(src).lineAt;
     const scan = maskRustComments(src);
+    // Pub function missing doc comment
     for (const match of scan.matchAll(/^\s*pub\s+fn\s+(\w+)/gm)) {
         const fnName = match[1];
         const srcBefore = src.slice(0, match.index);
@@ -24,6 +26,7 @@ function detectConventions(src, relPath) {
             });
         }
     }
+    // Const naming: SCREAMING_CASE
     for (const match of scan.matchAll(/^\s*(?:pub\s+)?(?:const)\s+(\w+)\s*:/gm)) {
         const constName = match[1];
         if (/[a-z]/.test(constName)) {
@@ -38,6 +41,7 @@ function detectConventions(src, relPath) {
             });
         }
     }
+    // Use of `return` keyword at end of function (redundant)
     for (const match of scan.matchAll(/\breturn\s+(\w[\w!]*)\s*;$/gm)) {
         const line = lineOf(match.index);
         const fnContext = src.slice(0, match.index).match(/\bfn\s+\w+\s*\(/g);
@@ -55,6 +59,7 @@ function detectConventions(src, relPath) {
             }
         }
     }
+    // Wildcard imports (use of *)
     for (const match of scan.matchAll(/\buse\s+(?:\w+::)+\*\s*;/g)) {
         const line = lineOf(match.index);
         const importPath = match[0].replace('use ', '').replace(';', '');
@@ -75,11 +80,11 @@ export const detectorConvencoes = criarAnalista({
     descricao: 'Verifica conformidade com convenções de código Rust.',
     global: false,
     test: (relPath) => /\.(rs)$/i.test(relPath),
-    aplicar: async (src, relPath) => {
-        if (disableEnv)
+    aplicar: (src, relPath) => {
+        if (disableEnv) {
             return null;
+        }
         const msgs = detectConventions(src, relPath);
         return msgs.length ? msgs : null;
     }
 });
-//# sourceMappingURL=detector-conventions.js.map

package/dist/analysts/rust/detectors/detector-errors-potential.js

@@ -1,11 +1,13 @@
+// SPDX-License-Identifier: MIT
 import { messages } from '../../../core/messages/index.js';
 import { createLineLookup, maskRustComments } from '../../../shared/helpers/index.js';
 import { criarAnalista } from '../../../types/index.js';
-const disableEnv = process.env.MAHORAGA_DISABLE_PLUGIN_RUST === '1';
+const disableEnv = process.env.SUKUNA_DISABLE_PLUGIN_RUST === '1';
 function detectPotentialErrors(src, relPath) {
     const ocorrencias = [];
     const lineOf = createLineLookup(src).lineAt;
     const scan = maskRustComments(src);
+    // unwrap() with context: check if inside a function returning Result
     for (const match of scan.matchAll(/\.unwrap\(\)/g)) {
         const line = lineOf(match.index);
         const fnContext = src.slice(0, match.index).match(/\bfn\s+\w+[\s\S]{0,200}$/);
@@ -22,6 +24,7 @@ function detectPotentialErrors(src, relPath) {
             tipo: 'rust/rule'
         });
     }
+    // expect() with empty or generic message
     for (const match of scan.matchAll(/\.expect\(\)/g)) {
         const line = lineOf(match.index);
         ocorrencias.push({
@@ -44,6 +47,7 @@ function detectPotentialErrors(src, relPath) {
             tipo: 'rust/rule'
         });
     }
+    // Panic macros that should be avoided in production
     for (const match of scan.matchAll(/\b(unreachable!|unimplemented!)\s*\(/g)) {
         const line = lineOf(match.index);
         ocorrencias.push({
@@ -55,6 +59,7 @@ function detectPotentialErrors(src, relPath) {
             tipo: 'rust/rule'
         });
     }
+    // detect panic macro
     for (const match of scan.matchAll(/\btodo!\s*\(/g)) {
         const line = lineOf(match.index);
         ocorrencias.push({
@@ -74,11 +79,11 @@ export const detectorErrosPotenciais = criarAnalista({
     descricao: 'Detecta padrões de erro potencial em código Rust.',
     global: false,
     test: (relPath) => /\.(rs)$/i.test(relPath),
-    aplicar: async (src, relPath) => {
-        if (disableEnv)
+    aplicar: (src, relPath) => {
+        if (disableEnv) {
             return null;
+        }
         const msgs = detectPotentialErrors(src, relPath);
         return msgs.length ? msgs : null;
     }
 });
-//# sourceMappingURL=detector-errors-potential.js.map

package/dist/analysts/rust/detectors/detector-unsafe.js

@@ -1,16 +1,18 @@
+// SPDX-License-Identifier: MIT
 import { messages } from '../../../core/messages/index.js';
 import { createLineLookup, maskRustComments } from '../../../shared/helpers/index.js';
 import { criarAnalista } from '../../../types/index.js';
-const disableEnv = process.env.MAHORAGA_DISABLE_PLUGIN_RUST === '1';
+const disableEnv = process.env.SUKUNA_DISABLE_PLUGIN_RUST === '1';
 function detectUnsafePatterns(src, relPath) {
     const ocorrencias = [];
     const lineOf = createLineLookup(src).lineAt;
     const scan = maskRustComments(src);
+    // unsafe blocks without SAFETY comment
     for (const match of scan.matchAll(/\bunsafe\s*\{/g)) {
         const line = lineOf(match.index);
         const srcBefore = src.slice(0, match.index);
         const lineStart = srcBefore.lastIndexOf('\n') + 1;
-        const lineText = src.slice(lineStart, match.index).trim();
+        const _lineText = src.slice(lineStart, match.index).trim();
         const precedingLines = src.split('\n').slice(Math.max(0, line - 4), line).join('\n');
         if (!precedingLines.includes('// SAFETY:') && !precedingLines.includes('/* SAFETY:')) {
             ocorrencias.push({
@@ -23,6 +25,7 @@ function detectUnsafePatterns(src, relPath) {
             });
         }
     }
+    // transmute without comment
     for (const match of scan.matchAll(/\b(?:std::)?mem::transmute\b/g)) {
         const line = lineOf(match.index);
         const srcBefore = src.slice(0, match.index);
@@ -38,6 +41,7 @@ function detectUnsafePatterns(src, relPath) {
             });
         }
     }
+    // pointer dereference in safe code
     for (const match of scan.matchAll(/\b(?:const|mut)\s+ptr\s*:\s*\*/g)) {
         const line = lineOf(match.index);
         const srcAfter = src.slice(match.index, match.index + 200);
@@ -52,6 +56,7 @@ function detectUnsafePatterns(src, relPath) {
             });
         }
     }
+    // #[repr(C)] without proper justification
     for (const match of scan.matchAll(/#\[repr\(C\)\]/g)) {
         const line = lineOf(match.index);
         const srcBefore = src.slice(0, match.index);
@@ -75,11 +80,11 @@ export const detectorUnsafe = criarAnalista({
     descricao: 'Detecta uso inadequado de unsafe e operações inseguras em código Rust.',
     global: false,
     test: (relPath) => /\.(rs)$/i.test(relPath),
-    aplicar: async (src, relPath) => {
-        if (disableEnv)
+    aplicar: (src, relPath) => {
+        if (disableEnv) {
             return null;
+        }
         const msgs = detectUnsafePatterns(src, relPath);
         return msgs.length ? msgs : null;
     }
 });
-//# sourceMappingURL=detector-unsafe.js.map

package/dist/analysts/rust/detectors/index.js

@@ -1,4 +1,4 @@
+// SPDX-License-Identifier: MIT
 export * from './detector-conventions.js';
 export * from './detector-errors-potential.js';
 export * from './detector-unsafe.js';
-//# sourceMappingURL=index.js.map

package/dist/analysts/rust/index.js

@@ -1,3 +1,3 @@
+// SPDX-License-Identifier: MIT
 export * from './analysts/index.js';
 export * from './detectors/index.js';
-//# sourceMappingURL=index.js.map

package/dist/analysts/scorers/index.js

@@ -1,2 +1,5 @@
+// SPDX-License-Identifier: MIT
+/**
+ * @fileoverview Pontuadores (scorers) for analysis
+ */
 export * from './scorer.js';
-//# sourceMappingURL=index.js.map

package/dist/analysts/scorers/scorer.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { grafoDependencias } from '../detectors/index.js';
 import { ARQUETIPOS, normalizarCaminho } from '../strategists/index.js';
 const PENALIDADE_MISSING_REQUIRED = 20;
@@ -7,12 +8,14 @@ const PESO_DEPENDENCIA = 10;
 const PESO_PADRAO = 5;
 const PENALIDADE_FORBIDDEN = 20;
 export function scoreArquetipo(def, arquivos) {
-    const norm = arquivos.map(arquivo => String(normalizarCaminho(arquivo)));
-    const required = def.requiredDirs || [];
+    const norm = arquivos.map(arquivo => normalizarCaminho(arquivo));
+    const required = def.requiredDirs ?? [];
     const matchedRequired = required.filter((diretorio) => norm.some(arquivo => arquivo.startsWith(`${diretorio}/`) || arquivo === diretorio));
     const missingRequired = required.filter((diretorio) => !matchedRequired.includes(diretorio));
-    const optional = def.optionalDirs || [];
+    const optional = def.optionalDirs ?? [];
     const matchedOptional = optional.filter((diretorio) => norm.some(arquivo => arquivo.startsWith(`${diretorio}/`) || arquivo === diretorio));
+    // Verifica dependências sugeridas no grafo global (qualquer arquivo pode importar)
+    // Otimização: materializa um Set único de todas as dependências para lookup O(1)
     const allDependencies = new Set();
     for (const set of grafoDependencias.values()) {
         for (const dep of set) {
@@ -22,10 +25,10 @@ export function scoreArquetipo(def, arquivos) {
     function hasDependencyGlobal(dep) {
         return allDependencies.has(dep);
     }
-    const dependencyMatches = (def.dependencyHints || []).filter((dep) => hasDependencyGlobal(dep));
-    const filePadraoMatches = (def.filePresencePatterns || []).filter((pat) => norm.some(arquivo => arquivo.includes(pat)));
-    const forbiddenPresent = (def.forbiddenDirs || []).filter((diretorio) => norm.some(arquivo => arquivo.startsWith(`${diretorio}/`) || arquivo === diretorio));
-    let score = (def.pesoBase || 1) * 10;
+    const dependencyMatches = (def.dependencyHints ?? []).filter((dep) => hasDependencyGlobal(dep));
+    const filePadraoMatches = (def.filePresencePatterns ?? []).filter((pat) => norm.some(arquivo => arquivo.includes(pat)));
+    const forbiddenPresent = (def.forbiddenDirs ?? []).filter((diretorio) => norm.some(arquivo => arquivo.startsWith(`${diretorio}/`) || arquivo === diretorio));
+    let score = (def.pesoBase ?? 1) * 10;
     score += matchedRequired.length * PESO_REQUIRED;
     score -= missingRequired.length * PENALIDADE_MISSING_REQUIRED;
     score += matchedOptional.length * PESO_OPTIONAL;
@@ -56,15 +59,17 @@ export function scoreArquetipo(def, arquivos) {
     if (def.nome === 'api-rest-express' && grafoDependencias.has('express')) {
         if (norm.some(arquivo => arquivo.includes('pages')) && norm.some(arquivo => arquivo.includes('prisma')) && norm.some(arquivo => arquivo.includes('api'))) {
             score += 40;
-            if (score > 100)
+            if (score > 100) {
                 score = 100;
+            }
             explicacaoSimilaridade = 'Estrutura híbrida: api-rest-express + fullstack. Projeto combina backend Express/controllers e frontend (pages/prisma/api).';
             explicacaoSimilaridade += '\nOutros candidatos potenciais detectados: fullstack, api-rest-express.';
         }
         else if (norm.some(arquivo => arquivo.includes('pages')) && norm.some(arquivo => arquivo.includes('prisma'))) {
             score += 40;
-            if (score > 100)
+            if (score > 100) {
                 score = 100;
+            }
             explicacaoSimilaridade = 'Estrutura híbrida: api-rest-express + fullstack. Projeto combina backend Express/controllers e frontend (pages/prisma).';
             explicacaoSimilaridade += '\nOutros candidatos potenciais detectados: fullstack, api-rest-express.';
         }
@@ -88,6 +93,7 @@ export function scoreArquetipo(def, arquivos) {
             explicacaoSimilaridade = 'Estrutura segue o padrão oficial api-rest-express.';
         }
         else if (score >= 70) {
+            // Para simplificar a validação em testes, adotamos uma formulação curta próxima do "padrão oficial"
             explicacaoSimilaridade = 'Estrutura segue o padrão api-rest-express com pequenas diferenças.';
         }
         else if (score >= 40) {
@@ -97,6 +103,7 @@ export function scoreArquetipo(def, arquivos) {
             explicacaoSimilaridade = 'Estrutura personalizada, mas o padrão mais próximo é api-rest-express. Recomenda-se seguir boas práticas para facilitar manutenção.';
         }
     }
+    // Explicação genérica quando há penalidades/ausências e ainda não foi preenchida
     if (!explicacaoSimilaridade) {
         const partes = [];
         if (missingRequired.length > 0) {
@@ -109,10 +116,12 @@ export function scoreArquetipo(def, arquivos) {
             explicacaoSimilaridade = `${partes.join(' ')} Estrutura parcialmente compatível, personalizada ou com diferenças.`;
         }
     }
-    const maxPossible = (def.pesoBase || 1) * 10 + (def.requiredDirs?.length || 0) * PESO_REQUIRED + (def.optionalDirs?.length || 0) * PESO_OPTIONAL + (def.dependencyHints?.length || 0) * PESO_DEPENDENCIA + (def.filePresencePatterns?.length || 0) * PESO_PADRAO + 30;
+    // Importante: manter score negativo quando penalidades superam acertos,
+    // pois alguns testes validam score <= 0 para cenários de penalização.
+    const maxPossible = (def.pesoBase ?? 1) * 10 + (def.requiredDirs?.length ?? 0) * PESO_REQUIRED + (def.optionalDirs?.length ?? 0) * PESO_OPTIONAL + (def.dependencyHints?.length ?? 0) * PESO_DEPENDENCIA + (def.filePresencePatterns?.length ?? 0) * PESO_PADRAO + 30;
     const confidence = maxPossible > 0 ? Math.min(100, Math.round(score / maxPossible * 100)) : 0;
     const raizArquivos = norm.filter(caminho => typeof caminho === 'string' && !caminho.includes('/'));
-    const allowed = new Set([...(def.rootFilesAllowed || [])]);
+    const allowed = new Set([...(def.rootFilesAllowed ?? [])]);
     const anomalias = [];
     for (const rf of raizArquivos) {
         if (typeof rf === 'string' && rf.trim() !== '' && !allowed.has(rf)) {
@@ -157,56 +166,66 @@ export function pontuarTodos(arquivos) {
         const resultado = scoreArquetipo(def, arquivos);
         resultados.push(resultado);
         if (resultado.candidatoExtra) {
-            const extra = ARQUETIPOS?.find((arquivo) => arquivo.nome === resultado.candidatoExtra);
+            const extra = ARQUETIPOS.find((arquivo) => arquivo.nome === resultado.candidatoExtra);
             if (extra) {
                 const extraResultado = scoreArquetipo(extra, arquivos);
-                if (!resultados.some(x => x.nome === extraResultado.nome))
+                if (!resultados.some(x => x.nome === extraResultado.nome)) {
                     resultados.push(extraResultado);
+                }
             }
         }
     }
-    return resultados.filter(resultado => (resultado.matchedRequired?.length || 0) > 0 || (resultado.matchedOptional?.length || 0) > 0 || (resultado.dependencyMatches?.length || 0) > 0 || (resultado.filePadraoMatches?.length || 0) > 0 || (resultado.forbiddenPresent?.length || 0) > 0);
+    // Filtro: manter apenas candidatos que apresentem algum sinal (match/forbidden/pattern/dep)
+    return resultados.filter(resultado => (resultado.matchedRequired.length || 0) > 0 || (resultado.matchedOptional.length || 0) > 0 || (resultado.dependencyMatches.length || 0) > 0 || (resultado.filePadraoMatches.length || 0) > 0 || (resultado.forbiddenPresent.length || 0) > 0);
 }
+// Versão avançada do scoreArquetipo com análise de sinais do projeto
 export function scoreArquetipoAvancado(def, arquivos, sinaisAvancados) {
+    // Usa a implementação base
     const resultadoBase = scoreArquetipo(def, arquivos);
+    // Se não há sinais avançados, retorna resultado base
     if (!sinaisAvancados) {
         return resultadoBase;
     }
+    // Clona o resultado base para adicionar análises avançadas
     let score = resultadoBase.score;
-    let explicacao = resultadoBase.explicacaoSimilaridade || '';
+    let explicacao = resultadoBase.explicacaoSimilaridade ?? '';
     const frameworks = sinaisAvancados.frameworksDetectados || [];
     const deps = sinaisAvancados.dependencias || [];
     const scripts = sinaisAvancados.scripts || [];
-    const detalhes = sinaisAvancados.detalhes || {};
+    const detalhes = sinaisAvancados.detalhes ?? {};
+    // BONUS INTELIGENTE: Considerar sinais avançados para pontuação contextual
     score += calcularBonusContextual(def, sinaisAvancados);
+    // Análise específica por arquétipo
     switch (def.nome) {
         case 'next-js':
             if (frameworks.includes('Next.js') || deps.includes('next')) {
                 score += 30;
                 explicacao += '\n[V] Framework Next.js detectado via dependências e análise de código.';
             }
-            if (sinaisAvancados.pastasPadrao?.includes('pages') || sinaisAvancados.pastasPadrao?.includes('app')) {
+            if (sinaisAvancados.pastasPadrao.includes('pages') || sinaisAvancados.pastasPadrao.includes('app')) {
                 score += 20;
                 explicacao += '\n[V] Estrutura de roteamento Next.js (pages ou app dir) confirmada.';
             }
+            // Bônus por tecnologias detectadas
             if (sinaisAvancados.tecnologiasDominantes.includes('frontend-framework')) {
                 score += 15;
             }
             break;
         case 'fullstack':
+            // Detecção específica para Next.js fullstack
             if (frameworks.includes('Next.js') || deps.includes('next')) {
                 score += 35;
                 explicacao += '\n[V] Framework Next.js detectado - aplicação fullstack moderna.';
             }
-            if (sinaisAvancados.pastasPadrao?.includes('api')) {
+            if (sinaisAvancados.pastasPadrao.includes('api')) {
                 score += 25;
                 explicacao += '\n[V] API routes Next.js detectadas - backend integrado.';
             }
-            if (sinaisAvancados.pastasPadrao?.includes('pages')) {
+            if (sinaisAvancados.pastasPadrao.includes('pages')) {
                 score += 20;
                 explicacao += '\n[V] Páginas Next.js (Pages Router) detectadas.';
             }
-            if (sinaisAvancados.pastasPadrao?.includes('app')) {
+            if (sinaisAvancados.pastasPadrao.includes('app')) {
                 score += 25;
                 explicacao += '\n[V] App Router Next.js detectado - arquitetura moderna.';
             }
@@ -228,7 +247,7 @@ export function scoreArquetipoAvancado(def, arquivos, sinaisAvancados) {
                 score += 30;
                 explicacao += '\n[V] Build tool Vite detectado.';
             }
-            if (sinaisAvancados.arquivosConfiguracao?.some(arquivo => arquivo.includes('vite.config'))) {
+            if (sinaisAvancados.arquivosConfiguracao.some(arquivo => arquivo.includes('vite.config'))) {
                 score += 15;
                 explicacao += '\n[V] Arquivo de configuração Vite presente.';
             }
@@ -254,7 +273,7 @@ export function scoreArquetipoAvancado(def, arquivos, sinaisAvancados) {
                 score += 20;
                 explicacao += '\n[V] Framework Hapi detectado.';
             }
-            if (sinaisAvancados.pastasPadrao?.includes('routes') || sinaisAvancados.pastasPadrao?.includes('api') || sinaisAvancados.pastasPadrao?.includes('controllers')) {
+            if (sinaisAvancados.pastasPadrao.includes('routes') || sinaisAvancados.pastasPadrao.includes('api') || sinaisAvancados.pastasPadrao.includes('controllers')) {
                 score += 15;
                 explicacao += '\n[V] Estrutura de rotas/controllers API detectada.';
             }
@@ -270,6 +289,7 @@ export function scoreArquetipoAvancado(def, arquivos, sinaisAvancados) {
                 score += 15;
                 explicacao += '\n[V] ORM/Database layer detectado.';
             }
+            // Bônus por padrões arquiteturais
             if (sinaisAvancados.padroesArquiteturais.includes('repository-service')) {
                 score += 10;
                 explicacao += '\n[V] Padrão Repository/Service compatível com APIs REST.';
@@ -280,6 +300,7 @@ export function scoreArquetipoAvancado(def, arquivos, sinaisAvancados) {
             }
             break;
         case 'vue-spa':
+            // Detecção específica para Vue.js SPA
             if (frameworks.includes('Vue') || deps.includes('vue')) {
                 score += 30;
                 explicacao += '\n[V] Framework Vue.js detectado - SPA moderna.';
@@ -296,15 +317,15 @@ export function scoreArquetipoAvancado(def, arquivos, sinaisAvancados) {
                 score += 15;
                 explicacao += '\n[V] Build tool Vue detectado (CLI/Vite).';
             }
-            if (sinaisAvancados.pastasPadrao?.includes('src/components')) {
+            if (sinaisAvancados.pastasPadrao.includes('src/components')) {
                 score += 15;
                 explicacao += '\n[V] Estrutura de componentes Vue detectada.';
             }
-            if (sinaisAvancados.pastasPadrao?.includes('src/composables')) {
+            if (sinaisAvancados.pastasPadrao.includes('src/composables')) {
                 score += 15;
                 explicacao += '\n[V] Composables Vue 3 detectados - arquitetura moderna.';
             }
-            if (sinaisAvancados.pastasPadrao?.includes('src/views')) {
+            if (sinaisAvancados.pastasPadrao.includes('src/views')) {
                 score += 10;
                 explicacao += '\n[V] Estrutura de views/pages detectada.';
             }
@@ -322,10 +343,11 @@ export function scoreArquetipoAvancado(def, arquivos, sinaisAvancados) {
                 score += 30;
                 explicacao += '\n[V] Framework React detectado.';
             }
-            if (sinaisAvancados.pastasPadrao?.includes('components') || sinaisAvancados.pastasPadrao?.includes('src')) {
+            if (sinaisAvancados.pastasPadrao.includes('components') || sinaisAvancados.pastasPadrao.includes('src')) {
                 score += 15;
                 explicacao += '\n[V] Estrutura React típica com components detectada.';
             }
+            // Bônus por tecnologias detectadas
             if (sinaisAvancados.tecnologiasDominantes.includes('frontend-framework')) {
                 score += 15;
             }
@@ -335,17 +357,17 @@ export function scoreArquetipoAvancado(def, arquivos, sinaisAvancados) {
                 score += 30;
                 explicacao += '\n[V] Framework Vue detectado.';
             }
-            if (sinaisAvancados.pastasPadrao?.includes('components') || sinaisAvancados.arquivosPadrao?.some(arquivo => arquivo.endsWith('.vue'))) {
+            if (sinaisAvancados.pastasPadrao.includes('components') || sinaisAvancados.arquivosPadrao.some(arquivo => arquivo.endsWith('.vue'))) {
                 score += 15;
                 explicacao += '\n[V] Estrutura Vue com components detectada.';
             }
             break;
         case 'typescript-lib':
-            if (sinaisAvancados.tipos?.length > 0) {
+            if (sinaisAvancados.tipos.length > 0) {
                 score += 20;
                 explicacao += `\n[V] Tipos TypeScript detectados (${sinaisAvancados.tipos.length} tipos).`;
             }
-            if (deps.includes('typescript') || sinaisAvancados.arquivosConfiguracao?.some(arquivo => arquivo.includes('tsconfig'))) {
+            if (deps.includes('typescript') || sinaisAvancados.arquivosConfiguracao.some(arquivo => arquivo.includes('tsconfig'))) {
                 score += 15;
                 explicacao += '\n[V] Configuração TypeScript presente.';
             }
@@ -353,27 +375,29 @@ export function scoreArquetipoAvancado(def, arquivos, sinaisAvancados) {
                 score += 10;
                 explicacao += '\n[V] Scripts de build detectados.';
             }
+            // Bônus por TypeScript avançado
             if (sinaisAvancados.tecnologiasDominantes.includes('typescript-advanced')) {
                 score += 20;
                 explicacao += '\n[V] Uso avançado de TypeScript detectado.';
             }
             break;
         case 'monorepo':
-            if (sinaisAvancados.arquivosConfiguracao?.some(arquivo => arquivo.includes('lerna.json') || arquivo.includes('pnpm-workspace'))) {
+            if (sinaisAvancados.arquivosConfiguracao.some(arquivo => arquivo.includes('lerna.json') || arquivo.includes('pnpm-workspace'))) {
                 score += 25;
                 explicacao += '\n[V] Configuração de monorepo detectada (Lerna ou pnpm).';
             }
-            if (sinaisAvancados.pastasPadrao?.includes('packages') || sinaisAvancados.pastasPadrao?.includes('apps')) {
+            if (sinaisAvancados.pastasPadrao.includes('packages') || sinaisAvancados.pastasPadrao.includes('apps')) {
                 score += 20;
                 explicacao += '\n[V] Estrutura de workspaces/packages detectada.';
             }
+            // Bônus por complexidade alta
             if (sinaisAvancados.complexidadeEstrutura === 'alta') {
                 score += 20;
                 explicacao += '\n[V] Complexidade estrutural alta compatível com monorepo.';
             }
             break;
         case 'cli':
-            if (sinaisAvancados.pastasPadrao?.includes('bin') || sinaisAvancados.pastasPadrao?.includes('cli')) {
+            if (sinaisAvancados.pastasPadrao.includes('bin') || sinaisAvancados.pastasPadrao.includes('cli')) {
                 score += 20;
                 explicacao += '\n[V] Estrutura de CLI detectada (bin ou cli).';
             }
@@ -381,16 +405,19 @@ export function scoreArquetipoAvancado(def, arquivos, sinaisAvancados) {
                 score += 15;
                 explicacao += '\n[V] Biblioteca de CLI detectada (commander/yargs/inquirer).';
             }
+            // Bônus por padrões CLI
             if (sinaisAvancados.padroesArquiteturais.includes('cli-patterns')) {
                 score += 25;
                 explicacao += '\n[V] Padrões específicos de CLI detectados.';
             }
+            // Penalizar se tem estrutura web
             if (sinaisAvancados.tecnologiasDominantes.includes('frontend-framework')) {
                 score -= 30;
                 explicacao += '\n[X] Estrutura web detectada, incompatível com CLI.';
             }
             break;
         case 'clean-arch':
+            // Clean Architecture scoring
             if (sinaisAvancados.camadasCleanArch?.domain) {
                 score += 30;
                 explicacao += '\n[V] Camada de domínio detectada (entities, value-objects).';
@@ -411,6 +438,7 @@ export function scoreArquetipoAvancado(def, arquivos, sinaisAvancados) {
                 score += 20;
                 explicacao += '\n[V] Padrão Use Case detectado.';
             }
+            // Bônus por tecnologias compatíveis
             if (sinaisAvancados.dependencias.some(d => d.includes('tsyringe') || d.includes('inversify') || d.includes('awilix'))) {
                 score += 15;
                 explicacao += '\n[V] DI Container compatível com Clean Architecture.';
@@ -419,7 +447,8 @@ export function scoreArquetipoAvancado(def, arquivos, sinaisAvancados) {
                 score += 10;
                 explicacao += '\n[V] Validação de dados compatível com DTOs.';
             }
-            if (sinaisAvancados.pastasPadrao?.some(p => p.includes('pages') || p.includes('components'))) {
+            // Penalidade se tem estrutura incompatível
+            if (sinaisAvancados.pastasPadrao.some(p => p.includes('pages') || p.includes('components'))) {
                 score -= 15;
                 explicacao += '\n[X] Estrutura de frontend (pages/components) presente em projeto Clean Architecture.';
             }
@@ -457,7 +486,8 @@ export function scoreArquetipoAvancado(def, arquivos, sinaisAvancados) {
                 score += 10;
                 explicacao += '\n[V] Biblioteca compartilhada entre serviços detectada.';
             }
-            if (sinaisAvancados.pastasPadrao?.some(p => p.includes('pages') || p.includes('components'))) {
+            // Penalidades
+            if (sinaisAvancados.pastasPadrao.some(p => p.includes('pages') || p.includes('components'))) {
                 score -= 20;
                 explicacao += '\n[X] Estrutura frontend não esperada em arquitetura de microsserviços.';
             }
@@ -467,6 +497,7 @@ export function scoreArquetipoAvancado(def, arquivos, sinaisAvancados) {
             }
             break;
     }
+    // Análises genéricas aplicáveis a todos os arquétipos
     if (detalhes.testRunner) {
         score += 5;
         explicacao += `\n[V] Test runner detectado: ${detalhes.testRunner}.`;
@@ -479,6 +510,7 @@ export function scoreArquetipoAvancado(def, arquivos, sinaisAvancados) {
         score += 5;
         explicacao += `\n[V] Bundler detectado: ${detalhes.bundler}.`;
     }
+    // Detectar complexidade do projeto baseado nos sinais
     const complexidade = (sinaisAvancados.funcoes || 0) + (sinaisAvancados.classes || 0) + (sinaisAvancados.variaveis || 0);
     if (complexidade > 100) {
         explicacao += `\n[GRAFICO] Projeto de complexidade alta (${complexidade} elementos).`;
@@ -486,7 +518,8 @@ export function scoreArquetipoAvancado(def, arquivos, sinaisAvancados) {
     else if (complexidade > 50) {
         explicacao += `\n[GRAFICO] Projeto de complexidade média (${complexidade} elementos).`;
     }
-    const maxPossible = (def.pesoBase || 1) * 10 + (def.requiredDirs?.length || 0) * PESO_REQUIRED + (def.optionalDirs?.length || 0) * PESO_OPTIONAL + (def.dependencyHints?.length || 0) * PESO_DEPENDENCIA + (def.filePresencePatterns?.length || 0) * PESO_PADRAO + 100;
+    // Recalcular confidence baseado no novo score
+    const maxPossible = (def.pesoBase ?? 1) * 10 + (def.requiredDirs?.length ?? 0) * PESO_REQUIRED + (def.optionalDirs?.length ?? 0) * PESO_OPTIONAL + (def.dependencyHints?.length ?? 0) * PESO_DEPENDENCIA + (def.filePresencePatterns?.length ?? 0) * PESO_PADRAO + 100; // Adiciona margem para análise avançada
     const confidence = maxPossible > 0 ? Math.min(100, Math.round(score / maxPossible * 100)) : 0;
     return {
         ...resultadoBase,
@@ -497,42 +530,58 @@ export function scoreArquetipoAvancado(def, arquivos, sinaisAvancados) {
 }
 function calcularBonusContextual(def, sinais) {
     let bonus = 0;
+    // Bônus baseado na complexidade da estrutura
     if (def.nome === 'monorepo' && sinais.complexidadeEstrutura === 'alta') {
         bonus += 20;
     }
+    // Penalizar estruturas simples para arquetipos complexos
     if ((def.nome === 'fullstack' || def.nome === 'monorepo') && sinais.complexidadeEstrutura === 'baixa') {
         bonus -= 15;
     }
+    // Bônus por alinhamento de padrões arquiteturais
     if (def.nome === 'api-rest-express' && sinais.padroesArquiteturais.includes('repository-service')) {
         bonus += 15;
     }
     if (def.nome === 'cli' && sinais.padroesArquiteturais.includes('cli-patterns')) {
         bonus += 20;
     }
+    // Bônus Clean Architecture
     if (def.nome === 'clean-arch') {
-        if (sinais.camadasCleanArch?.domain)
+        if (sinais.camadasCleanArch?.domain) {
             bonus += 25;
-        if (sinais.camadasCleanArch?.application)
+        }
+        if (sinais.camadasCleanArch?.application) {
             bonus += 20;
-        if (sinais.camadasCleanArch?.infrastructure)
+        }
+        if (sinais.camadasCleanArch?.infrastructure) {
             bonus += 15;
-        if (sinais.camadasCleanArch?.presentation)
+        }
+        if (sinais.camadasCleanArch?.presentation) {
             bonus += 10;
-        if (sinais.padroesCleanArch?.length)
+        }
+        if (sinais.padroesCleanArch?.length) {
             bonus += 10;
+        }
     }
+    // Bônus Microservices
     if (def.nome === 'microservices') {
-        if (sinais.boundariesServicos && sinais.boundariesServicos.length > 1)
+        if (sinais.boundariesServicos && sinais.boundariesServicos.length > 1) {
             bonus += 25;
-        if (sinais.padroesDistribuidos?.includes('event-driven'))
+        }
+        if (sinais.padroesDistribuidos?.includes('event-driven')) {
             bonus += 20;
-        if (sinais.padroesDistribuidos?.includes('api-gateway'))
+        }
+        if (sinais.padroesDistribuidos?.includes('api-gateway')) {
             bonus += 15;
-        if (sinais.padroesDistribuidos?.includes('containerized'))
+        }
+        if (sinais.padroesDistribuidos?.includes('containerized')) {
             bonus += 15;
-        if (sinais.mensageriaDetectada && sinais.mensageriaDetectada.length > 0)
+        }
+        if (sinais.mensageriaDetectada && sinais.mensageriaDetectada.length > 0) {
             bonus += 20;
+        }
     }
+    // Penalizar incompatibilidades tecnológicas
     if (def.nome === 'cli' && sinais.tecnologiasDominantes.includes('frontend-framework')) {
         bonus -= 25;
     }
@@ -553,14 +602,15 @@ export function pontuarTodosAvancado(arquivos, sinaisAvancados) {
         const resultado = scoreArquetipoAvancado(def, arquivos, sinaisAvancados);
         resultados.push(resultado);
         if (resultado.candidatoExtra) {
-            const extra = ARQUETIPOS?.find((arquivo) => arquivo.nome === resultado.candidatoExtra);
+            const extra = ARQUETIPOS.find((arquivo) => arquivo.nome === resultado.candidatoExtra);
             if (extra) {
                 const extraResultado = scoreArquetipoAvancado(extra, arquivos, sinaisAvancados);
-                if (!resultados.some(x => x.nome === extraResultado.nome))
+                if (!resultados.some(x => x.nome === extraResultado.nome)) {
                     resultados.push(extraResultado);
+                }
             }
         }
     }
-    return resultados.filter(resultado => (resultado.matchedRequired?.length || 0) > 0 || (resultado.matchedOptional?.length || 0) > 0 || (resultado.dependencyMatches?.length || 0) > 0 || (resultado.filePadraoMatches?.length || 0) > 0 || (resultado.forbiddenPresent?.length || 0) > 0);
+    // Filtro: manter apenas candidatos que apresentem algum sinal (match/forbidden/pattern/dep)
+    return resultados.filter(resultado => (resultado.matchedRequired.length || 0) > 0 || (resultado.matchedOptional.length || 0) > 0 || (resultado.dependencyMatches.length || 0) > 0 || (resultado.filePadraoMatches.length || 0) > 0 || (resultado.forbiddenPresent.length || 0) > 0);
 }
-//# sourceMappingURL=scorer.js.map