@mocoto/mahoraga 0.14.1 → 0.14.3

package/README.md

@@ -2,46 +2,12 @@
 Proveniência e Autoria: Este documento integra o projeto Mahoraga (licença MIT-0).
 ---
 
-<img src="./svg/banner-mahoraga.svg" width="100%">
-
----
-
 <div align="center">
 
-![beta](./svg/badge-beta.svg)
-![cobertura](./svg/badge-coverage.svg)
-![mantido](./svg/badge-maintained.svg)
-![pr-bem-vindo](./svg/badge-prs-welcome.svg)
-![stavel](./svg/badge-stable.svg)
----
-
 <p><b>CLI modular para análise, diagnóstico e manutenção de projetos JavaScript/TypeScript com suporte multi-linguagem</b><p>
 
 </div>
 
----
-
-## Índice
-
-- [Começar Rápido (30 segundos)](#começar-rápido-30-segundos)
-- [Fluxo Passo a Passo](#fluxo-passo-a-passo)
-- [Funcionalidades](#funcionalidades)
-- [Instalação](#instalação)
-- [Configuração](#configuração)
-- [Comandos da CLI](#comandos-da-cli)
-- [REST API](#rest-api)
-- [SDK Programático](#sdk-programático)
-- [GitHub App](#github-app)
-- [Editor (LSP / VSCode)](#editor-lsp--vscode)
-- [CI/CD](#cicd)
-- [Linguagens Suportadas](#linguagens-suportadas)
-- [Documentação Completa](#documentação-completa)
-- [Desenvolvimento](#desenvolvimento)
-- [Contribuir](#contribuir)
-- [Licença](#licença)
-
----
-
 ## Começar Rápido (30 segundos)
 
 ```bash

package/dist/analysts/architects/analyst-structure.js

@@ -3,7 +3,7 @@ import path from 'node:path';
 import pLimit from 'p-limit';
 import { config } from '../../core/config/index.js';
 // Constantes para análise estrutural
-export const CONCORRENCIA = (config.STRUCTURE_CONCURRENCY ?? 5);
+export const CONCORRENCIA = config.STRUCTURE_CONCURRENCY;
 export const CAMADAS = {
     ts: 'src',
     js: 'src',
@@ -17,27 +17,27 @@ export const CAMADAS = {
     yaml: 'config',
     // Adicione mais mapeamentos conforme necessário
 };
+function determinarCamadaIdeal(entry) {
+    const rel = entry.relPath;
+    const normalizado = rel.replace(/\\/g, '/');
+    const atual = normalizado.split('/')[0] || '';
+    let ideal = null;
+    const matchDireta = Object.entries(CAMADAS).find(([, dir]) => normalizado.startsWith(`${dir.replace(/\\/g, '/')}/`));
+    if (matchDireta) {
+        ideal = matchDireta[1];
+    }
+    else {
+        const nome = path.basename(rel);
+        const [, tipo] = /\.([^.]+)\.[^.]+$/.exec(nome) ?? [];
+        if (tipo && CAMADAS[tipo]) {
+            ideal = CAMADAS[tipo];
+        }
+    }
+    return { arquivo: rel, atual, ideal };
+}
 export async function analisarEstrutura(fileEntries, _baseDir = process.cwd()) {
     const limit = pLimit(CONCORRENCIA);
-    const resultados = await Promise.all(fileEntries.map((entry) => limit(() => {
-        const rel = entry.relPath;
-        // Normaliza para separador POSIX para evitar dependência de platform e necessidade de mock em testes
-        const normalizado = rel.replace(/\\/g, '/');
-        const atual = normalizado.split('/')[0] || '';
-        let ideal = null;
-        const matchDireta = Object.entries(CAMADAS).find(([, dir]) => normalizado.startsWith(`${dir.replace(/\\/g, '/')}/`));
-        if (matchDireta) {
-            ideal = matchDireta[1];
-        }
-        else {
-            const nome = path.basename(rel);
-            const [, tipo] = /\.([^.]+)\.[^.]+$/.exec(nome) ?? [];
-            if (tipo && CAMADAS[tipo]) {
-                ideal = CAMADAS[tipo];
-            }
-        }
-        return { arquivo: rel, atual, ideal };
-    })));
+    const resultados = await Promise.all(fileEntries.map((entry) => limit(() => determinarCamadaIdeal(entry))));
     return resultados;
 }
 export { analisarEstrutura as alinhamentoEstrutural };

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

@@ -19,6 +19,13 @@ import { lerEstado, salvarEstado } from '../../shared/persistence/index.js';
 const { log, ArquetiposExtraMensagens } = getMessages();
 // Nome do arquivo legado (para compatibilidade)
 const ARQUETIPO_PERSONALIZADO_FILENAME = 'mahoraga.repo.arquetipo.json';
+function logVerbose(fn) {
+    const isTest = (process.env.VITEST ?? '') !== '';
+    const isVerbose = log.verbose ?? false;
+    if (!isTest && isVerbose) {
+        fn();
+    }
+}
 /**
  * Carrega o arquétipo personalizado do projeto atual
  * Tenta primeiro o novo caminho (.mahoraga/estrutura.arquetipo.json),
@@ -38,12 +45,7 @@ export async function carregarArquetipoPersonalizado(baseDir = process.cwd()) {
         const arquetipoLegado = await lerEstado(caminhoLegado, null);
         // Validação básica
         if (!arquetipoLegado?.nome || !arquetipoLegado.arquetipoOficial) {
-            // Reduz ruído em testes e quando não estiver em modo verbose
-            const isTest = (process.env.VITEST ?? '') !== '';
-            const isVerbose = log.verbose ?? false;
-            if (!isTest && isVerbose) {
-                log.aviso(ArquetiposExtraMensagens.naoEncontrado.replace('{novo}', novoCaminho).replace('{legado}', caminhoLegado));
-            }
+            logVerbose(() => { log.aviso(ArquetiposExtraMensagens.naoEncontrado.replace('{novo}', novoCaminho).replace('{legado}', caminhoLegado)); });
             return null;
         }
         return arquetipoLegado;
@@ -105,8 +107,8 @@ export async function existeArquetipoPersonalizado(baseDir = process.cwd()) {
  * Obtém o arquétipo oficial base para um arquétipo personalizado
  */
 export function obterArquetipoOficial(arquetipoPersonalizado) {
-    const nomeOficial = arquetipoPersonalizado.arquetipoOficial ?? '';
-    const encontrado = ARQUETIPOS.find((arq) => arq.nome === nomeOficial);
+    const nomeOficial = arquetipoPersonalizado.arquetipoOficial;
+    const encontrado = ARQUETIPOS?.find((arq) => arq.nome === nomeOficial);
     return encontrado ?? null;
 }
 /**
@@ -209,21 +211,16 @@ export function validarArquetipoPersonalizado(arquetipo) {
     }
     else {
         // Verifica se o arquétipo oficial existe
-        const arquetipoOficial = ARQUETIPOS.find((arq) => arq.nome === arquetipo.arquetipoOficial);
+        const arquetipoOficial = ARQUETIPOS?.find((arq) => arq.nome === arquetipo.arquetipoOficial);
         if (!arquetipoOficial) {
-            erros.push(ArquetiposExtraMensagens.validacao.arquetipoNaoEncontrado.replace('{arquetipo}', arquetipo.arquetipoOficial).replace('{disponiveis}', (ARQUETIPOS ?? []).map(arquivo => (arquivo).nome).join(', ')));
+            erros.push(ArquetiposExtraMensagens.validacao.arquetipoNaoEncontrado.replace('{arquetipo}', arquetipo.arquetipoOficial).replace('{disponiveis}', ARQUETIPOS.map(arquivo => (arquivo).nome).join(', ')));
         }
     }
-    if (!arquetipo.estruturaPersonalizada) {
-        erros.push(ArquetiposExtraMensagens.validacao.estruturaObrigatoria);
+    if (!Array.isArray(arquetipo.estruturaPersonalizada.diretorios)) {
+        erros.push(ArquetiposExtraMensagens.validacao.diretoriosArray);
     }
-    else {
-        if (!Array.isArray(arquetipo.estruturaPersonalizada.diretorios)) {
-            erros.push(ArquetiposExtraMensagens.validacao.diretoriosArray);
-        }
-        if (!Array.isArray(arquetipo.estruturaPersonalizada.arquivosChave)) {
-            erros.push(ArquetiposExtraMensagens.validacao.arquivosChaveArray);
-        }
+    if (!Array.isArray(arquetipo.estruturaPersonalizada.arquivosChave)) {
+        erros.push(ArquetiposExtraMensagens.validacao.arquivosChaveArray);
     }
     return {
         valido: erros.length === 0,

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

@@ -41,6 +41,34 @@ if (process.env.VITEST) {
         scoreArquetipo
     };
 }
+function aplicarBoostConfianca(candidato, arquetiposCandidatos, melhorDeteccao) {
+    if (arquetiposCandidatos.some((arq) => candidato.nome.includes(arq) || arq.includes(candidato.nome))) {
+        const boostConfianca = Math.min(melhorDeteccao.confiancaTotal * 100 * 0.8, 60);
+        return {
+            ...candidato,
+            confidence: Math.max(candidato.confidence + boostConfianca, 70),
+            explicacaoSimilaridade: `[Boost contextual: ${melhorDeteccao.tecnologia} detectado com ${(melhorDeteccao.confiancaTotal * 100).toFixed(0)}% confiança] ${candidato.explicacaoSimilaridade ?? ''}`
+        };
+    }
+    return candidato;
+}
+function criarArquetipoVirtual(melhorDeteccao, tecnologiaDetectada) {
+    return {
+        nome: tecnologiaDetectada,
+        score: Math.round(melhorDeteccao.confiancaTotal * 100),
+        confidence: Math.round(melhorDeteccao.confiancaTotal * 100),
+        matchedRequired: [],
+        missingRequired: [],
+        matchedOptional: [],
+        dependencyMatches: (melhorDeteccao.evidencias ?? []).filter(erro => erro.tipo === 'dependencia').map(erro => erro.valor),
+        filePadraoMatches: (melhorDeteccao.evidencias ?? []).filter(erro => erro.tipo === 'estrutura').map(erro => erro.valor),
+        forbiddenPresent: [],
+        anomalias: [],
+        sugestaoPadronizacao: (melhorDeteccao.sugestoesMelhoria ?? []).join('; '),
+        explicacaoSimilaridade: `Detectado via sistema inteligente contextual com ${(melhorDeteccao.confiancaTotal * 100).toFixed(0)}% confiança`,
+        descricao: `Projeto ${melhorDeteccao.tecnologia} identificado por análise contextual`
+    };
+}
 export async function detectarArquetipos(contexto, baseDir, options) {
     if (!options?.quiet && config.VERBOSE) {
         console.log(DetectorArquetiposExtraMensagens.debugChamado, contexto.arquivos.length, 'arquivos');
@@ -91,7 +119,7 @@ export async function detectarArquetipos(contexto, baseDir, options) {
         const melhorDeteccao = resultadosContextuais.reduce((melhor, atual) => atual.confiancaTotal > melhor.confiancaTotal ? atual : melhor, {
             confiancaTotal: 0
         });
-        if (melhorDeteccao && melhorDeteccao.confiancaTotal > 0.6) {
+        if (melhorDeteccao.confiancaTotal > 0.6) {
             // Escala 0-1, não 0-100
             // Mapear tecnologias detectadas para arquétipos conhecidos
             const mapeamentoTecnologia = {
@@ -106,40 +134,19 @@ export async function detectarArquetipos(contexto, baseDir, options) {
                 'react-spa': ['react-spa', 'react', 'spa']
             };
             const tecnologiaDetectada = melhorDeteccao.tecnologia ?? 'desconhecido';
-            const arquetiposCandidatos = mapeamentoTecnologia[tecnologiaDetectada] || [];
-            // Aplicar boost de confiança para arquétipos relacionados
-            let boostAplicado = false;
-            candidatos = candidatos.map((candidato) => {
-                if (arquetiposCandidatos.some((arq) => candidato.nome.includes(arq) || arq.includes(candidato.nome))) {
-                    const boostConfianca = Math.min(melhorDeteccao.confiancaTotal * 100 * 0.8, 60); // Boost agressivo até 60%
-                    boostAplicado = true;
-                    return {
-                        ...candidato,
-                        confidence: Math.max(candidato.confidence + boostConfianca, 70),
-                        // Mínimo 70% se detectado
-                        explicacaoSimilaridade: `[Boost contextual: ${melhorDeteccao.tecnologia} detectado com ${(melhorDeteccao.confiancaTotal * 100).toFixed(0)}% confiança] ${candidato.explicacaoSimilaridade ?? ''}`
-                    };
+            const arquetiposCandidatos = mapeamentoTecnologia[tecnologiaDetectada];
+            if (!arquetiposCandidatos) {
+                if (!options?.quiet && config.VERBOSE) {
+                    console.log(`[AVISO] Tecnologia detectada "${tecnologiaDetectada}" não mapeada para nenhum arquétipo.`);
+                }
+            }
+            else {
+                // Aplicar boost de confiança para arquétipos relacionados
+                const boostAplicado = candidatos.some((candidato) => arquetiposCandidatos.some((arq) => candidato.nome.includes(arq) || arq.includes(candidato.nome)));
+                candidatos = candidatos.map((candidato) => aplicarBoostConfianca(candidato, arquetiposCandidatos, melhorDeteccao));
+                if (!boostAplicado) {
+                    candidatos.unshift(criarArquetipoVirtual(melhorDeteccao, tecnologiaDetectada));
                 }
-                return candidato;
-            });
-            // Se não encontrou arquétipo compatível, criar um virtual baseado na detecção
-            if (!boostAplicado) {
-                const arquetipoVirtual = {
-                    nome: tecnologiaDetectada,
-                    score: Math.round(melhorDeteccao.confiancaTotal * 100),
-                    confidence: Math.round(melhorDeteccao.confiancaTotal * 100),
-                    matchedRequired: [],
-                    missingRequired: [],
-                    matchedOptional: [],
-                    dependencyMatches: (melhorDeteccao.evidencias ?? []).filter(erro => erro.tipo === 'dependencia').map(erro => erro.valor),
-                    filePadraoMatches: (melhorDeteccao.evidencias ?? []).filter(erro => erro.tipo === 'estrutura').map(erro => erro.valor),
-                    forbiddenPresent: [],
-                    anomalias: [],
-                    sugestaoPadronizacao: (melhorDeteccao.sugestoesMelhoria ?? []).join('; '),
-                    explicacaoSimilaridade: `Detectado via sistema inteligente contextual com ${(melhorDeteccao.confiancaTotal * 100).toFixed(0)}% confiança`,
-                    descricao: `Projeto ${melhorDeteccao.tecnologia} identificado por análise contextual`
-                };
-                candidatos.unshift(arquetipoVirtual); // Adiciona no início
             }
         }
     }
@@ -211,7 +218,7 @@ export async function detectarArquetipos(contexto, baseDir, options) {
     const baselineCaminho = path.join(baseDir, '.mahoraga', 'baseline-estrutura.json');
     let baseline;
     const existente = await lerEstado(baselineCaminho);
-    if (existente && !Array.isArray(existente) && typeof existente === 'object' && 'arquetipo' in existente) {
+    if (!Array.isArray(existente) && typeof existente === 'object' && 'arquetipo' in existente) {
         baseline = existente;
     }
     if (!baseline && candidatos[0]) {
@@ -227,7 +234,7 @@ export async function detectarArquetipos(contexto, baseDir, options) {
     // Prioriza baseline apenas se o candidato principal for 'desconhecido' ou confiança baixa
     if (baseline && baseline.arquetipo !== 'desconhecido') {
         const arquivosRaizAtuais = arquivos.filter(caminho => !caminho.includes('/'));
-        const setBase = new Set(baseline.arquivosRaiz || []);
+        const setBase = new Set(baseline.arquivosRaiz);
         const temIntersecao = arquivosRaizAtuais.some(arquivo => setBase.has(arquivo));
         const candidatoTop = candidatos[0];
         if (temIntersecao && (candidatoTop.nome === 'desconhecido' || candidatoTop.confidence < 50)) {

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

@@ -94,7 +94,7 @@ export function detectarArquetipo(arquivos) {
         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 || [];
+                const forb = elem.forbiddenPresent;
                 if (forb.length === 1 && forb[0] === 'src') {
                     return false;
                 }
@@ -110,8 +110,8 @@ export function detectarArquetipo(arquivos) {
                 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 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 ratioA = totA > 0 ? forbA / totA : 0;

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

@@ -5,7 +5,7 @@ _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: [],
@@ -17,6 +17,28 @@ _sinaisAvancados // prefixo _ para ignorar warning de unused
         anomalias: []
     };
 }
+function processarImportsFramework(imports, tecnologias, sinais) {
+    for (const indice of imports) {
+        if (typeof indice.source.value === 'string') {
+            const importSource = indice.source.value.toLowerCase();
+            if (importSource.includes('react') || importSource.includes('vue') || importSource.includes('angular')) {
+                tecnologias.set('frontend-framework', (tecnologias.get('frontend-framework') ?? 0) + 1);
+            }
+            if (importSource.includes('express') || importSource.includes('fastify') || importSource.includes('nestjs')) {
+                tecnologias.set('backend-framework', (tecnologias.get('backend-framework') ?? 0) + 1);
+            }
+            if (importSource.includes('prisma') || importSource.includes('mongoose') || importSource.includes('typeorm')) {
+                tecnologias.set('orm', (tecnologias.get('orm') ?? 0) + 1);
+            }
+            if (importSource.includes('jest') || importSource.includes('vitest') || importSource.includes('mocha')) {
+                tecnologias.set('testing-framework', (tecnologias.get('testing-framework') ?? 0) + 1);
+            }
+            if (/express|react|next|electron|discord\.js|telegraf/.test(importSource)) {
+                sinais.frameworksDetectados.push(indice.source.value);
+            }
+        }
+    }
+}
 export function extrairSinaisAvancados(fileEntries, packageJson, _p0, _baseDir, _arquivos) {
     // Auxiliar para checar se o nó possui id.name string
     const hasIdNome = (node) => {
@@ -45,8 +67,8 @@ export function extrairSinaisAvancados(fileEntries, packageJson, _p0, _baseDir,
     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)) {
-            body = fe.ast.node.body;
+        if (fe.ast && 'node' in fe.ast && Array.isArray(fe.ast.node.body)) {
+            body = (fe.ast.node).body;
         }
         // Análise inteligente de padrões
         const conteudo = fe.content ?? '';
@@ -134,31 +156,7 @@ export function extrairSinaisAvancados(fileEntries, packageJson, _p0, _baseDir,
         // 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);
-                }
-                // Frameworks backend
-                if (importSource.includes('express') || importSource.includes('fastify') || importSource.includes('nestjs')) {
-                    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);
-                }
-                // Testing
-                if (importSource.includes('jest') || importSource.includes('vitest') || importSource.includes('mocha')) {
-                    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);
-                }
-            }
-        }
+        processarImportsFramework(imports, tecnologias, sinais);
         // 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)) {

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

@@ -22,8 +22,8 @@ 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)) {
-            body = 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;

package/dist/analysts/architects/strategist-structure.js

@@ -3,15 +3,52 @@ import { statSync } from 'node:fs';
 import path from 'node:path';
 import { getTypesDirectoryRelPosix } from '../../core/config/index.js';
 import { carregarConfigEstrategia, destinoPara, deveIgnorar, normalizarRel } from '../../shared/helpers/index.js';
-/**
- * Estrategista/Planejador de Estrutura
- *
- * Responsável por: dado o conjunto de arquivos e um catálogo de arquétipos,
- * sugerir um plano de reorganização (mover arquivos) com base em regras de nomeação
- * e diretórios-alvo padronizados. Não aplica mudanças no disco (apenas sugere).
- *
- * Domínio ideal: arquitetos (diagnóstico/planejamento). A execução fica com zeladores.
- */
+function processarArquivoParaMovimento(rel, cfg, baseDir, sinaisAvancados, rels, mover, conflitos) {
+    if (deveIgnorar(rel, cfg.ignorarPastas)) {
+        return;
+    }
+    if (/__(tests|mocks)__/.test(rel) || /\.(test|spec)\.[jt]sx?$/.test(rel) || /fixtures\//.test(rel)) {
+        return;
+    }
+    if (!rel.endsWith('.ts') && !rel.endsWith('.js')) {
+        return;
+    }
+    const base = path.posix.basename(rel);
+    if (/^(eslint|vitest|next|tailwind|postcss|prettier|jest)\.config\.[jt]s$/i.test(base)) {
+        return;
+    }
+    const res = destinoPara(rel, cfg.raizCodigo, cfg.criarSubpastasPorEntidade, cfg.apenasCategoriasConfiguradas, cfg.categoriasMapa);
+    if (!res.destinoDir) {
+        return;
+    }
+    const currentDir = path.posix.dirname(rel);
+    const alreadyInTarget = currentDir === res.destinoDir || currentDir.startsWith(`${res.destinoDir}/`);
+    if (alreadyInTarget) {
+        return;
+    }
+    let destinoDirAjustado = res.destinoDir;
+    const motivoAjustado = res.motivo ?? 'Reorganização padrão';
+    if (sinaisAvancados) {
+        destinoDirAjustado = ajustarDestinoPorSinais(rel, res.destinoDir, sinaisAvancados, motivoAjustado);
+    }
+    const destino = path.posix.join(destinoDirAjustado, path.posix.basename(rel));
+    let destinoExiste = rels.includes(destino);
+    if (!destinoExiste) {
+        try {
+            const abs = path.join(baseDir, destino.replace(/\\/g, '/'));
+            statSync(abs);
+            destinoExiste = true;
+        }
+        catch {
+            destinoExiste = false;
+        }
+    }
+    if (destinoExiste) {
+        conflitos.push({ alvo: destino, motivo: 'destino já existe' });
+        return;
+    }
+    mover.push({ de: rel, para: destino, motivo: motivoAjustado });
+}
 export async function gerarPlanoEstrategico(contexto, opcoes = {}, sinaisAvancados) {
     const typesDir = getTypesDirectoryRelPosix();
     const cfg = await carregarConfigEstrategia(contexto.baseDir, {
@@ -24,63 +61,7 @@ export async function gerarPlanoEstrategico(contexto, opcoes = {}, sinaisAvancad
     const rels = contexto.arquivos.map(arquivo => normalizarRel(arquivo.relPath));
     const isTestLike = (caminho) => /__(tests|mocks)__/.test(caminho) || /\.(test|spec)\.[jt]sx?$/.test(caminho) || /fixtures\//.test(caminho);
     for (const rel of rels) {
-        if (deveIgnorar(rel, cfg.ignorarPastas)) {
-            continue;
-        }
-        if (isTestLike(rel)) {
-            continue;
-        } // não mover testes/fixtures
-        // Evitar mexer em arquivos fora do escopo de código (por agora)
-        if (!rel.endsWith('.ts') && !rel.endsWith('.js')) {
-            continue;
-        }
-        // Respeita convenções de ferramentas no root: não mover configs globais
-        const base = path.posix.basename(rel);
-        if (/^(eslint|vitest|next|tailwind|postcss|prettier|jest)\.config\.[jt]s$/i.test(base)) {
-            continue;
-        }
-        const res = destinoPara(rel, cfg.raizCodigo, cfg.criarSubpastasPorEntidade, cfg.apenasCategoriasConfiguradas, cfg.categoriasMapa);
-        if (!res.destinoDir) {
-            continue;
-        }
-        const currentDir = path.posix.dirname(rel);
-        const alreadyInTarget = currentDir === res.destinoDir || currentDir.startsWith(`${res.destinoDir}/`);
-        if (alreadyInTarget) {
-            continue;
-        }
-        // [LANCAMENTO] INTELIGÊNCIA CONTEXTUAL: Ajustar destino baseado em sinais avançados
-        let destinoDirAjustado = res.destinoDir;
-        const motivoAjustado = res.motivo ?? 'Reorganização padrão';
-        if (sinaisAvancados) {
-            destinoDirAjustado = ajustarDestinoPorSinais(rel, res.destinoDir, sinaisAvancados, motivoAjustado);
-        }
-        // Mantém o mesmo nome do arquivo; apenas move para pasta de destino
-        const destino = path.posix.join(destinoDirAjustado, path.posix.basename(rel));
-        // Conflito se já existe arquivo listado ou presente no filesystem
-        let destinoExiste = rels.includes(destino);
-        if (!destinoExiste) {
-            try {
-                const abs = path.join(contexto.baseDir, destino.replace(/\\/g, '/'));
-                // fs.statSync usado de forma segura; se falhar, considera inexistente
-                statSync(abs);
-                destinoExiste = true;
-            }
-            catch {
-                destinoExiste = false;
-            }
-        }
-        if (destinoExiste) {
-            conflitos.push({
-                alvo: destino,
-                motivo: 'destino já existe'
-            });
-            continue;
-        }
-        mover.push({
-            de: rel,
-            para: destino,
-            motivo: motivoAjustado
-        });
+        processarArquivoParaMovimento(rel, cfg, contexto.baseDir, sinaisAvancados, rels, mover, conflitos);
     }
     // Deduplicação simples
     const seen = new Set();

package/dist/analysts/azure-pipelines/analysts/analyst-azure.js

@@ -11,6 +11,21 @@ export function registrarDetectorAzure(detector) {
 export function obterDetectoresAzure() {
     return [...detectoresRegistrados];
 }
+function processarResultadosPlugins(plugResults, ocorrencias, relPath) {
+    for (const results of plugResults) {
+        for (const item of results) {
+            ocorrencias.push({
+                tipo: `AZURE_${item.tipo.toUpperCase().replace(/-/g, '_')}`,
+                mensagem: item.descricao,
+                relPath,
+                linha: item.linha ?? 1,
+                coluna: 1,
+                sugestao: item.sugestao ?? '',
+                nivel: item.severidade === 'critica' || item.severidade === 'alta' ? 'erro' : item.severidade === 'media' ? 'aviso' : 'info',
+            });
+        }
+    }
+}
 export const analistaAzurePipelines = {
     nome: 'azure-pipelines',
     categoria: 'workflows',
@@ -23,53 +38,44 @@ export const analistaAzurePipelines = {
             const securityResults = await Promise.resolve(detectorAzureSecurity.aplicar(conteudo, relPath, null, _fc, contexto));
             const performanceResults = await Promise.resolve(detectorAzurePerformance.aplicar(conteudo, relPath, null, _fc, contexto));
             const estruturaResults = await Promise.resolve(detectorAzureEstrutura.aplicar(conteudo, relPath, null, _fc, contexto));
-            ocorrencias.push(...securityResults, ...performanceResults, ...estruturaResults);
+            for (const r of [securityResults, performanceResults, estruturaResults]) {
+                if (r) {
+                    ocorrencias.push(...(Array.isArray(r) ? r : [r]));
+                }
+            }
             // 2. Análise Estrutural básica
             const doc = parseDocument(conteudo);
             const configData = doc.toJS();
-            if (configData) {
-                // Verificar versão antiga (v0.x)
-                if (configData.version && parseFloat(String(configData.version)) < 1.0) {
+            // Verificar versão antiga (v0.x)
+            const version = configData.version;
+            if ((typeof version === 'string' || typeof version === 'number') && parseFloat(String(version)) < 1.0) {
+                ocorrencias.push({
+                    tipo: 'AZURE_OBSOLETE_VERSION',
+                    mensagem: 'Versão do schema do Azure Pipelines está obsoleta',
+                    relPath,
+                    linha: 1,
+                    nivel: 'aviso',
+                    sugestao: 'Remova o campo "version" para usar o schema YAML moderno',
+                });
+            }
+            // Detectar excesso de variáveis globais
+            if (configData.variables && typeof configData.variables === 'object') {
+                const varCount = Object.keys(configData.variables).length;
+                if (varCount > 20) {
                     ocorrencias.push({
-                        tipo: 'AZURE_OBSOLETE_VERSION',
-                        mensagem: 'Versão do schema do Azure Pipelines está obsoleta',
+                        tipo: 'AZURE_TOO_MANY_VARIABLES',
+                        mensagem: messages.RelatorioAzureMensagens.tooManyVariables,
                         relPath,
                         linha: 1,
-                        nivel: 'aviso',
-                        sugestao: 'Remova o campo "version" para usar o schema YAML moderno',
+                        nivel: 'info',
+                        sugestao: messages.RelatorioAzureMensagens.tooManyVariablesSugestao,
                     });
                 }
-                // Detectar excesso de variáveis globais
-                if (configData.variables && typeof configData.variables === 'object') {
-                    const varCount = Object.keys(configData.variables).length;
-                    if (varCount > 20) {
-                        ocorrencias.push({
-                            tipo: 'AZURE_TOO_MANY_VARIABLES',
-                            mensagem: messages.RelatorioAzureMensagens.tooManyVariables,
-                            relPath,
-                            linha: 1,
-                            nivel: 'info',
-                            sugestao: messages.RelatorioAzureMensagens.tooManyVariablesSugestao,
-                        });
-                    }
-                }
             }
             // 3. Plugins registrados
             const caminhos = contexto?.arquivos.map(arquivo => arquivo.relPath) ?? [];
             const plugResults = await Promise.all(detectoresRegistrados.map(detector => Promise.resolve(detector.testar(configData, { conteudo, caminhos })).catch(() => [])));
-            for (const results of plugResults) {
-                for (const item of results) {
-                    ocorrencias.push({
-                        tipo: `AZURE_${item.tipo.toUpperCase().replace(/-/g, '_')}`,
-                        mensagem: item.descricao,
-                        relPath,
-                        linha: item.linha ?? 1,
-                        coluna: 1,
-                        sugestao: item.sugestao ?? '',
-                        nivel: item.severidade === 'critica' || item.severidade === 'alta' ? 'erro' : item.severidade === 'media' ? 'aviso' : 'info',
-                    });
-                }
-            }
+            processarResultadosPlugins(plugResults, ocorrencias, relPath);
         }
         catch {
             // Falha silenciosa no parse