@mocoto/mahoraga 0.14.0 → 0.14.2

package/dist/analysts/architects/orchestrator-archetypes.js

@@ -1,9 +1,14 @@
+// SPDX-License-Identifier: MIT
+import { detectarContextoProjeto } from '../../shared/index.js';
 import { detectarArquetipoNode } from '../plugins/index.js';
 import { pontuarTodos } from '../scorers/index.js';
 import { ARQUETIPOS } from '../strategists/index.js';
 import { detectarArquetipoXML } from '../xml/detectors/index.js';
-import { detectarContextoProjeto } from '../../shared/index.js';
+// Evita warning de unused import - função usada em runtime
 void detectarContextoProjeto;
+/**
+ * Cria um resultado padrão para arquétipo desconhecido
+ */
 function criarResultadoDesconhecido(motivo) {
     const anomalias = motivo ? [{
             path: 'projeto',
@@ -26,24 +31,37 @@ function criarResultadoDesconhecido(motivo) {
         descricao: 'Arquétipo não identificado'
     };
 }
+/**
+ * Orquestrador central de detecção de arquétipos
+ * Agrega votos dos detectores especializados e decide o arquétipo final
+ *
+ * @param arquivos Lista de arquivos do projeto para análise
+ * @returns Melhor arquétipo detectado ou 'desconhecido' se não identificado
+ */
 export function detectarArquetipo(arquivos) {
+    // Early return para projetos muito pequenos (< 5 arquivos)
     if (arquivos.length < 5) {
         return criarResultadoDesconhecido('Projeto muito pequeno para análise de arquétipo');
     }
+    // Performance: executar detectores de forma inteligente baseado nos tipos de arquivos
     const candidatos = [];
     const hasJS = arquivos.some(arquivo => arquivo.endsWith('.js') || arquivo.endsWith('.ts') || arquivo.endsWith('.jsx') || arquivo.endsWith('.tsx'));
     const hasXML = arquivos.some(arquivo => arquivo.endsWith('.xml'));
     const hasPackageJson = arquivos.some(arquivo => arquivo.endsWith('package.json'));
+    // Executar detectores baseado nos tipos de arquivos presentes (otimização de performance)
     if (hasJS || hasPackageJson) {
         candidatos.push(...detectarArquetipoNode(arquivos));
     }
+    // Futuro: adicionar detectores para outras linguagens // }
     if (hasXML) {
         candidatos.push(...detectarArquetipoXML(arquivos));
     }
     let lista = candidatos;
     if (!lista.length) {
+        // Fallback: usar o pontuador completo quando detectores especializados não retornarem candidatos
         lista = pontuarTodos(arquivos);
     }
+    // Se ainda vazio, é desconhecido
     if (!lista.length) {
         return {
             nome: 'desconhecido',
@@ -61,59 +79,79 @@ export function detectarArquetipo(arquivos) {
             descricao: 'Arquétipo não identificado'
         };
     }
+    // Regra especial (compatibilidade com testes de penalidades):
+    // Se existir candidato cujo único "sinal" são diretórios proibidos presentes
+    // (sem matches de required/optional/dependency/pattern), priorizamos aquele
+    // com maior quantidade de diretórios proibidos detectados.
     const apenasPenalidades = lista.filter(elem => {
-        const pos = (elem.matchedRequired?.length || 0) + (elem.matchedOptional?.length || 0) + (elem.dependencyMatches?.length || 0) + (elem.filePadraoMatches?.length || 0);
-        const forb = elem.forbiddenPresent?.length || 0;
+        const pos = (elem.matchedRequired.length || 0) + (elem.matchedOptional.length || 0) + (elem.dependencyMatches.length || 0) + (elem.filePadraoMatches.length || 0);
+        const forb = elem.forbiddenPresent.length || 0;
         return forb > 0 && pos === 0;
     });
     if (apenasPenalidades.length > 0) {
+        // Heurística de segurança: ignore o candidato 'monorepo-packages' quando o único forbidden presente for 'src'
+        // (cenário comum em projetos Node simples com pasta src/, que não devem ser classificados como monorepo).
         const filtrados = apenasPenalidades.filter(elem => {
+            // Regra específica: se o candidato for 'monorepo-packages' e o único forbidden detectado for 'src', descartamos
             if (elem.nome === 'monorepo-packages') {
-                const forb = elem.forbiddenPresent || [];
-                if (forb.length === 1 && forb[0] === 'src')
+                const forb = elem.forbiddenPresent;
+                if (forb.length === 1 && forb[0] === 'src') {
                     return false;
+                }
             }
             return true;
         });
         if (filtrados.length === 0) {
+            // caso todos tenham sido filtrados, prossegue com fluxo normal
         }
         else {
+            // desempate refinado: maior cobertura relativa de forbidden (detectados/definidos)
             filtrados.sort((arquivo, base) => {
-                const forbA = arquivo.forbiddenPresent?.length || 0;
-                const forbB = base.forbiddenPresent?.length || 0;
+                const forbA = arquivo.forbiddenPresent.length || 0;
+                const forbB = base.forbiddenPresent.length || 0;
+                // Usa somente o total de diretórios proibidos definidos no alvo para o ratio
                 const defA = ARQUETIPOS?.find((diretorio) => diretorio.nome === arquivo.nome);
                 const defB = ARQUETIPOS?.find((diretorio) => diretorio.nome === base.nome);
-                const totA = defA?.forbiddenDirs?.length || 0;
-                const totB = defB?.forbiddenDirs?.length || 0;
+                const totA = defA?.forbiddenDirs?.length ?? 0;
+                const totB = defB?.forbiddenDirs?.length ?? 0;
                 const ratioA = totA > 0 ? forbA / totA : 0;
                 const ratioB = totB > 0 ? forbB / totB : 0;
-                if (ratioB !== ratioA)
+                if (ratioB !== ratioA) {
                     return ratioB - ratioA;
-                if (forbB !== forbA)
+                }
+                if (forbB !== forbA) {
                     return forbB - forbA;
-                const miss = (base.missingRequired?.length || 0) - (arquivo.missingRequired?.length || 0);
-                if (miss !== 0)
+                }
+                // depois, mais missingRequired primeiro (penalidade maior do alvo)
+                const miss = (base.missingRequired.length || 0) - (arquivo.missingRequired.length || 0);
+                if (miss !== 0) {
                     return miss;
+                }
                 return arquivo.nome.localeCompare(base.nome);
             });
             return filtrados[0];
         }
     }
+    // Ordenação: menor missingRequired, maior score, maior matchedRequired, maior confidence, nome asc
     lista.sort((arquivo, base) => {
-        const mm = (arquivo.missingRequired?.length || 0) - (base.missingRequired?.length || 0);
-        if (mm !== 0)
+        const mm = (arquivo.missingRequired.length || 0) - (base.missingRequired.length || 0);
+        if (mm !== 0) {
             return mm;
-        if (base.score !== arquivo.score)
+        }
+        if (base.score !== arquivo.score) {
             return base.score - arquivo.score;
-        const mr = (base.matchedRequired?.length || 0) - (arquivo.matchedRequired?.length || 0);
-        if (mr !== 0)
+        }
+        const mr = (base.matchedRequired.length || 0) - (arquivo.matchedRequired.length || 0);
+        if (mr !== 0) {
             return mr;
-        if (base.confidence !== arquivo.confidence)
+        }
+        if (base.confidence !== arquivo.confidence) {
             return base.confidence - arquivo.confidence;
+        }
         return arquivo.nome.localeCompare(base.nome);
     });
     const best = lista[0];
-    const hasSignals = (best.matchedRequired?.length || 0) > 0 || (best.matchedOptional?.length || 0) > 0 || (best.dependencyMatches?.length || 0) > 0 || (best.filePadraoMatches?.length || 0) > 0 || (best.forbiddenPresent?.length || 0) > 0;
+    const hasSignals = (best.matchedRequired.length || 0) > 0 || (best.matchedOptional.length || 0) > 0 || (best.dependencyMatches.length || 0) > 0 || (best.filePadraoMatches.length || 0) > 0 || (best.forbiddenPresent.length || 0) > 0;
     if (!hasSignals) {
         return {
             nome: 'desconhecido',
@@ -133,4 +171,3 @@ export function detectarArquetipo(arquivos) {
     }
     return best;
 }
-//# sourceMappingURL=orchestrator-archetypes.js.map

package/dist/analysts/architects/signals-project-advanced.js

@@ -1,7 +1,11 @@
-export function scoreArquetipo(def, _arquivos, _sinaisAvancados) {
+export function scoreArquetipo(def, _arquivos, 
+// prefixo _ para ignorar warning de unused
+_sinaisAvancados // prefixo _ para ignorar warning de unused
+) {
+    // Implementação fictícia para evitar erro de compilação
     return {
         nome: def.nome,
-        descricao: def.descricao ?? '',
+        descricao: def.descricao,
         score: 0,
         confidence: 0,
         matchedRequired: [],
@@ -14,6 +18,7 @@ export function scoreArquetipo(def, _arquivos, _sinaisAvancados) {
     };
 }
 export function extrairSinaisAvancados(fileEntries, packageJson, _p0, _baseDir, _arquivos) {
+    // Auxiliar para checar se o nó possui id.name string
     const hasIdNome = (node) => {
         return typeof node === 'object' && node !== null && 'id' in node && typeof node.id?.name === 'string';
     };
@@ -29,23 +34,28 @@ export function extrairSinaisAvancados(fileEntries, packageJson, _p0, _baseDir,
         pastasPadrao: [],
         arquivosPadrao: [],
         arquivosConfiguracao: [],
+        // Novos sinais inteligentes
         padroesArquiteturais: [],
         tecnologiasDominantes: [],
         complexidadeEstrutura: 'baixa',
         tipoDominante: 'desconhecido'
     };
+    // Análise de padrões arquiteturais baseada no código
     const padroesDetectados = new Set();
     const tecnologias = new Map();
     for (const fe of fileEntries) {
         let body = [];
-        if (fe.ast && 'node' in fe.ast && fe.ast.node && fe.ast.node.type === 'Program' && Array.isArray(fe.ast.node.body)) {
+        if (fe.ast && 'node' in fe.ast && Array.isArray(fe.ast.node.body)) {
             body = fe.ast.node.body;
         }
-        const conteudo = fe.content || '';
+        // Análise inteligente de padrões
+        const conteudo = fe.content ?? '';
         const relPath = fe.relPath.toLowerCase();
+        // Detectar padrões MVC
         if (relPath.includes('controller') || relPath.includes('model') || relPath.includes('view')) {
             padroesDetectados.add('mvc');
         }
+        // Detectar Clean Architecture patterns
         if (relPath.includes('/domain/') || relPath.includes('/entities/') || relPath.includes('value-object')) {
             padroesDetectados.add('clean-arch-domain');
         }
@@ -64,7 +74,9 @@ export function extrairSinaisAvancados(fileEntries, packageJson, _p0, _baseDir,
         if (relPath.includes('entity') || relPath.includes('aggregate')) {
             padroesDetectados.add('domain-entity');
         }
+        // Detectar Distributed Architecture patterns
         if (relPath.includes('/services/') && !relPath.includes('/services/')) {
+            // múltiplos serviços
         }
         if (relPath.match(/services\/[^/]+\//)) {
             padroesDetectados.add('microservice-boundary');
@@ -90,47 +102,64 @@ export function extrairSinaisAvancados(fileEntries, packageJson, _p0, _baseDir,
         if (relPath.includes('/monitoring') || relPath.includes('/health') || relPath.includes('/metrics')) {
             padroesDetectados.add('monitoring');
         }
+        // Detectar padrões Repository/Service
         if (relPath.includes('repository') || relPath.includes('service')) {
             padroesDetectados.add('repository-service');
         }
+        // Detectar hooks React
         if (conteudo.includes('useState') || conteudo.includes('useEffect')) {
-            tecnologias.set('react-hooks', (tecnologias.get('react-hooks') || 0) + 1);
+            tecnologias.set('react-hooks', (tecnologias.get('react-hooks') ?? 0) + 1);
         }
+        // Detectar async/await patterns
         if (conteudo.includes('async') && conteudo.includes('await')) {
             padroesDetectados.add('async-await');
         }
+        // Detectar TypeScript advanced features
         if (conteudo.includes('interface') || conteudo.includes('type ')) {
-            tecnologias.set('typescript-advanced', (tecnologias.get('typescript-advanced') || 0) + 1);
+            tecnologias.set('typescript-advanced', (tecnologias.get('typescript-advanced') ?? 0) + 1);
         }
+        // Detectar padrões de CLI
         if (conteudo.includes('commander') || conteudo.includes('yargs') || relPath.includes('bin/')) {
             padroesDetectados.add('cli-patterns');
         }
+        // Funções
         sinais.funcoes += body.filter((node) => node.type === 'FunctionDeclaration').length;
+        // Imports
         const imports = body.filter((node) => node.type === 'ImportDeclaration');
         sinais.imports.push(...imports.map(indice => indice.source.value));
+        // Variáveis
         sinais.variaveis += body.filter((node) => node.type === 'VariableDeclaration').length;
+        // Tipos (TypeScript)
         sinais.tipos.push(...body.filter((node) => ['TSTypeAliasDeclaration', 'TSInterfaceDeclaration', 'TSEnumDeclaration'].includes(node.type)).map(node => hasIdNome(node) ? node.id.name : undefined).filter((valor) => typeof valor === 'string'));
+        // Classes
         sinais.classes += body.filter((node) => node.type === 'ClassDeclaration').length;
+        // Frameworks por import (expandido)
         for (const indice of imports) {
             if (typeof indice.source.value === 'string') {
                 const importSource = indice.source.value.toLowerCase();
+                // Frameworks web
                 if (importSource.includes('react') || importSource.includes('vue') || importSource.includes('angular')) {
-                    tecnologias.set('frontend-framework', (tecnologias.get('frontend-framework') || 0) + 1);
+                    tecnologias.set('frontend-framework', (tecnologias.get('frontend-framework') ?? 0) + 1);
                 }
+                // Frameworks backend
                 if (importSource.includes('express') || importSource.includes('fastify') || importSource.includes('nestjs')) {
-                    tecnologias.set('backend-framework', (tecnologias.get('backend-framework') || 0) + 1);
+                    tecnologias.set('backend-framework', (tecnologias.get('backend-framework') ?? 0) + 1);
                 }
+                // ORMs
                 if (importSource.includes('prisma') || importSource.includes('mongoose') || importSource.includes('typeorm')) {
-                    tecnologias.set('orm', (tecnologias.get('orm') || 0) + 1);
+                    tecnologias.set('orm', (tecnologias.get('orm') ?? 0) + 1);
                 }
+                // Testing
                 if (importSource.includes('jest') || importSource.includes('vitest') || importSource.includes('mocha')) {
-                    tecnologias.set('testing-framework', (tecnologias.get('testing-framework') || 0) + 1);
+                    tecnologias.set('testing-framework', (tecnologias.get('testing-framework') ?? 0) + 1);
                 }
+                // Lista original mantida
                 if (/express|react|next|electron|discord\.js|telegraf/.test(importSource)) {
                     sinais.frameworksDetectados.push(indice.source.value);
                 }
             }
         }
+        // Padrões de pastas/arquivos (expandido)
         const rel = fe.relPath.replace(/\\/g, '/');
         if (/src\/controllers|pages|api|prisma|packages|apps|src\/routes|src\/services|src\/repositories/.test(rel)) {
             sinais.pastasPadrao.push(rel);
@@ -142,7 +171,9 @@ export function extrairSinaisAvancados(fileEntries, packageJson, _p0, _baseDir,
             sinais.arquivosConfiguracao.push(rel);
         }
     }
+    // Processar sinais inteligentes
     sinais.padroesArquiteturais = Array.from(padroesDetectados);
+    // Detectar camadas da Clean Architecture
     const temDomain = padroesDetectados.has('clean-arch-domain') || padroesDetectados.has('domain-entity');
     const temApplication = padroesDetectados.has('clean-arch-application') || padroesDetectados.has('use-case');
     const temInfrastructure = padroesDetectados.has('clean-arch-infrastructure');
@@ -155,6 +186,7 @@ export function extrairSinaisAvancados(fileEntries, packageJson, _p0, _baseDir,
     };
     sinais.padroesCleanArch = Array.from(padroesDetectados)
         .filter(p => p.startsWith('clean-arch') || p === 'use-case' || p === 'domain-entity');
+    // Detectar boundaries de serviço e padrões distribuídos
     const serviceBoundaries = new Set(fileEntries
         .map(fe => {
         const match = fe.relPath.match(/services\/([^/]+)/);
@@ -167,12 +199,13 @@ export function extrairSinaisAvancados(fileEntries, packageJson, _p0, _baseDir,
         'containerized', 'orchestrated', 'shared-library', 'monitoring'].includes(p));
     sinais.mensageriaDetectada = fileEntries
         .filter(fe => {
-        const c = fe.content?.toLowerCase() || '';
+        const c = fe.content?.toLowerCase() ?? '';
         return c.includes('kafkajs') || c.includes('amqplib') || c.includes('ioredis') ||
             c.includes('bull') || c.includes('bullmq') || c.includes('nats') ||
             c.includes('eventemitter') || c.includes('pubsub');
     })
         .map(fe => fe.relPath);
+    // Determinar tecnologia dominante
     let maxContagem = 0;
     let dominante = 'desconhecido';
     for (const [tech, count] of tecnologias) {
@@ -183,6 +216,7 @@ export function extrairSinaisAvancados(fileEntries, packageJson, _p0, _baseDir,
     }
     sinais.tecnologiasDominantes = Array.from(tecnologias.keys());
     sinais.tipoDominante = dominante;
+    // Determinar complexidade da estrutura
     const totalArquivos = fileEntries.length;
     const totalPastas = new Set(fileEntries.map(fe => fe.relPath.split('/').slice(0, -1).join('/'))).size;
     if (totalArquivos > 100 || totalPastas > 20) {
@@ -194,10 +228,12 @@ export function extrairSinaisAvancados(fileEntries, packageJson, _p0, _baseDir,
     else {
         sinais.complexidadeEstrutura = 'baixa';
     }
+    // Dependências e scripts do package.json
     if (packageJson) {
-        sinais.dependencias.push(...Object.keys(packageJson.dependencies || {}));
-        sinais.scripts.push(...Object.keys(packageJson.scripts || {}));
+        sinais.dependencias.push(...Object.keys(packageJson.dependencies ?? {}));
+        sinais.scripts.push(...Object.keys(packageJson.scripts ?? {}));
     }
+    // Normaliza arrays
     sinais.imports = Array.from(new Set(sinais.imports));
     sinais.frameworksDetectados = Array.from(new Set(sinais.frameworksDetectados));
     sinais.pastasPadrao = Array.from(new Set(sinais.pastasPadrao));
@@ -207,4 +243,3 @@ export function extrairSinaisAvancados(fileEntries, packageJson, _p0, _baseDir,
     return sinais;
 }
 export const scoreArquetipoAvancado = scoreArquetipo;
-//# sourceMappingURL=signals-project-advanced.js.map

package/dist/analysts/architects/signals-project.js

@@ -1,4 +1,5 @@
 export function extrairSinaisProjeto(fileEntries, packageJson) {
+    // Auxiliar para checar se o nó possui id.name string
     const hasIdNome = (node) => {
         return typeof node === 'object' && node !== null && 'id' in node && typeof node.id?.name === 'string';
     };
@@ -21,15 +22,21 @@ export function extrairSinaisProjeto(fileEntries, packageJson) {
     };
     for (const fe of fileEntries) {
         let body = [];
-        if (fe.ast && 'node' in fe.ast && fe.ast.node && fe.ast.node.type === 'Program' && Array.isArray(fe.ast.node.body)) {
+        if (fe.ast && 'node' in fe.ast && Array.isArray(fe.ast.node.body)) {
             body = fe.ast.node.body;
         }
+        // Funções
         sinais.funcoes += body.filter((node) => node.type === 'FunctionDeclaration').length;
+        // Imports
         const imports = body.filter((node) => node.type === 'ImportDeclaration');
         sinais.imports.push(...imports.map(indice => indice.source.value));
+        // Variáveis
         sinais.variaveis += body.filter((node) => node.type === 'VariableDeclaration').length;
+        // Tipos (TypeScript)
         sinais.tipos.push(...body.filter((node) => ['TSTypeAliasDeclaration', 'TSInterfaceDeclaration', 'TSEnumDeclaration'].includes(node.type)).map(node => hasIdNome(node) ? node.id.name : undefined).filter((valor) => typeof valor === 'string'));
+        // Classes
         sinais.classes += body.filter((node) => node.type === 'ClassDeclaration').length;
+        // Frameworks por import
         for (const indice of imports) {
             if (typeof indice.source.value === 'string') {
                 if (/express|react|next|electron|discord\.js|telegraf/.test(indice.source.value)) {
@@ -37,6 +44,7 @@ export function extrairSinaisProjeto(fileEntries, packageJson) {
                 }
             }
         }
+        // Padrões de pastas/arquivos
         const rel = fe.relPath.replace(/\\/g, '/');
         if (/src\/controllers|pages|api|prisma|packages|apps/.test(rel)) {
             sinais.pastasPadrao.push(rel);
@@ -48,10 +56,12 @@ export function extrairSinaisProjeto(fileEntries, packageJson) {
             sinais.arquivosConfiguracao.push(rel);
         }
     }
+    // Dependências e scripts do package.json
     if (packageJson) {
-        sinais.dependencias.push(...Object.keys(packageJson.dependencies || {}));
-        sinais.scripts.push(...Object.keys(packageJson.scripts || {}));
+        sinais.dependencias.push(...Object.keys(packageJson.dependencies ?? {}));
+        sinais.scripts.push(...Object.keys(packageJson.scripts ?? {}));
     }
+    // Normaliza arrays
     sinais.imports = Array.from(new Set(sinais.imports));
     sinais.frameworksDetectados = Array.from(new Set(sinais.frameworksDetectados));
     sinais.pastasPadrao = Array.from(new Set(sinais.pastasPadrao));
@@ -61,4 +71,3 @@ export function extrairSinaisProjeto(fileEntries, packageJson) {
     return sinais;
 }
 export const extrairSinais = extrairSinaisProjeto;
-//# sourceMappingURL=signals-project.js.map