tutanus 0.12.0

package/dist/analysts/architects/analyst-structure.d.ts

@@ -0,0 +1,6 @@
+import type { FileEntryWithAst, ResultadoEstrutural } from '../../types/index.js';
+export declare const CONCORRENCIA: number;
+export declare const CAMADAS: Record<string, string>;
+export declare function analisarEstrutura(fileEntries: FileEntryWithAst[], _baseDir?: string): Promise<ResultadoEstrutural[]>;
+export { analisarEstrutura as alinhamentoEstrutural };
+//# sourceMappingURL=analyst-structure.d.ts.map

package/dist/analysts/architects/analyst-structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyst-structure.d.ts","sourceRoot":"","sources":["../../../src/analysts/architects/analyst-structure.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,GAAG,CAAC;AAG/D,eAAO,MAAM,YAAY,QAA4C,CAAC;AACtE,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAY1C,CAAC;AAEF,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,gBAAgB,EAAE,EAC/B,QAAQ,GAAE,MAAsB,GAC/B,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAgChC;AAED,OAAO,EAAE,iBAAiB,IAAI,qBAAqB,EAAE,CAAC"}

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

@@ -0,0 +1,40 @@
+import path from 'node:path';
+import { config } from '../../core/config/index.js';
+import pLimit from 'p-limit';
+export const CONCORRENCIA = Number(config.STRUCTURE_CONCURRENCY ?? 5);
+export const CAMADAS = {
+    ts: 'src',
+    js: 'src',
+    tsx: 'src',
+    jsx: 'src',
+    mjs: 'src',
+    cjs: 'src',
+    json: 'config',
+    md: 'docs',
+    yml: 'config',
+    yaml: 'config',
+};
+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;
+        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 };
+    })));
+    return resultados;
+}
+export { analisarEstrutura as alinhamentoEstrutural };
+//# sourceMappingURL=analyst-structure.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analyst-structure.js","sourceRoot":"","sources":["../../../src/analysts/architects/analyst-structure.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,MAAM,MAAM,SAAS,CAAC;AAK7B,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,qBAAqB,IAAI,CAAC,CAAC,CAAC;AACtE,MAAM,CAAC,MAAM,OAAO,GAA2B;IAC7C,EAAE,EAAE,KAAK;IACT,EAAE,EAAE,KAAK;IACT,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,IAAI,EAAE,QAAQ;IACd,EAAE,EAAE,MAAM;IACV,GAAG,EAAE,QAAQ;IACb,IAAI,EAAE,QAAQ;CAEf,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,WAA+B,EAC/B,WAAmB,OAAO,CAAC,GAAG,EAAE;IAEhC,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;IAEnC,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,GAAG,CAClC,WAAW,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CACxB,KAAK,CAAC,GAAG,EAAE;QACT,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC;QAE1B,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC5C,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9C,IAAI,KAAK,GAAkB,IAAI,CAAC;QAEhC,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAC3D,WAAW,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,CACtD,CAAC;QAEF,IAAI,WAAW,EAAE,CAAC;YAChB,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAChC,MAAM,CAAC,EAAE,IAAI,CAAC,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACtD,IAAI,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1B,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IACxC,CAAC,CAAC,CACH,CACF,CAAC;IAEF,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,OAAO,EAAE,iBAAiB,IAAI,qBAAqB,EAAE,CAAC","sourcesContent":["// SPDX-License-Identifier: MIT\nimport path from 'node:path';\n\nimport { config } from '@core/config';\nimport pLimit from 'p-limit';\n\nimport type { FileEntryWithAst, ResultadoEstrutural } from '@';\n\n// Constantes para análise estrutural\nexport const CONCORRENCIA = Number(config.STRUCTURE_CONCURRENCY ?? 5);\nexport const CAMADAS: Record<string, string> = {\n  ts: 'src',\n  js: 'src',\n  tsx: 'src',\n  jsx: 'src',\n  mjs: 'src',\n  cjs: 'src',\n  json: 'config',\n  md: 'docs',\n  yml: 'config',\n  yaml: 'config',\n  // Adicione mais mapeamentos conforme necessário\n};\n\nexport async function analisarEstrutura(\n  fileEntries: FileEntryWithAst[],\n  _baseDir: string = process.cwd(),\n): Promise<ResultadoEstrutural[]> {\n  const limit = pLimit(CONCORRENCIA);\n\n  const resultados = await Promise.all(\n    fileEntries.map((entry) =>\n      limit(() => {\n        const rel = entry.relPath;\n        // Normaliza para separador POSIX para evitar dependência de platform e necessidade de mock em testes\n        const normalizado = rel.replace(/\\\\/g, '/');\n        const atual = normalizado.split('/')[0] || '';\n        let ideal: string | null = null;\n\n        const matchDireta = Object.entries(CAMADAS).find(([, dir]) =>\n          normalizado.startsWith(`${dir.replace(/\\\\/g, '/')}/`),\n        );\n\n        if (matchDireta) {\n          ideal = matchDireta[1];\n        } else {\n          const nome = path.basename(rel);\n          const [, tipo] = /\\.([^.]+)\\.[^.]+$/.exec(nome) ?? [];\n          if (tipo && CAMADAS[tipo]) {\n            ideal = CAMADAS[tipo];\n          }\n        }\n\n        return { arquivo: rel, atual, ideal };\n      }),\n    ),\n  );\n\n  return resultados;\n}\n\nexport { analisarEstrutura as alinhamentoEstrutural };\n"]}

package/dist/analysts/architects/archetypes-custom.d.ts

@@ -0,0 +1,18 @@
+import type { ArquetipoEstruturaDef, ArquetipoPersonalizado } from '../../types/index.js';
+export declare function carregarArquetipoPersonalizado(baseDir?: string): Promise<ArquetipoPersonalizado | null>;
+export declare function salvarArquetipoPersonalizado(arquetipo: Omit<ArquetipoPersonalizado, 'metadata'>, _baseDir?: string): Promise<void>;
+export declare function existeArquetipoPersonalizado(baseDir?: string): Promise<boolean>;
+export declare function obterArquetipoOficial(arquetipoPersonalizado: ArquetipoPersonalizado): ArquetipoEstruturaDef | null;
+export declare function gerarSugestaoArquetipoPersonalizado(projetoDesconhecido: {
+    nome: string;
+    estruturaDetectada: string[];
+    arquivosRaiz: string[];
+}): string;
+export declare function criarTemplateArquetipoPersonalizado(nomeProjeto: string, estruturaDetectada: string[], arquivosRaiz: string[], arquetipoSugerido?: string): Omit<ArquetipoPersonalizado, 'metadata'>;
+export declare function validarArquetipoPersonalizado(arquetipo: ArquetipoPersonalizado): {
+    valido: boolean;
+    erros: string[];
+};
+export declare function listarArquetiposOficiais(): ArquetipoEstruturaDef[];
+export declare function integrarArquetipos(personalizado: ArquetipoPersonalizado, oficial: ArquetipoEstruturaDef): ArquetipoEstruturaDef;
+//# sourceMappingURL=archetypes-custom.d.ts.map

package/dist/analysts/architects/archetypes-custom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archetypes-custom.d.ts","sourceRoot":"","sources":["../../../src/analysts/architects/archetypes-custom.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,GAAG,CAAC;AAgBvE,wBAAsB,8BAA8B,CAAC,OAAO,GAAE,MAAsB,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CA+B5H;AAKD,wBAAsB,4BAA4B,CAAC,SAAS,EAAE,IAAI,CAAC,sBAAsB,EAAE,UAAU,CAAC,EAAE,QAAQ,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBvJ;AAOD,wBAAsB,4BAA4B,CAAC,OAAO,GAAE,MAAsB,GAAG,OAAO,CAAC,OAAO,CAAC,CAapG;AAMD,wBAAgB,qBAAqB,CAAC,sBAAsB,EAAE,sBAAsB,GAAG,qBAAqB,GAAG,IAAI,CAIlH;AAMD,wBAAgB,mCAAmC,CAAC,mBAAmB,EAAE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,GAAG,MAAM,CAmBT;AAMD,wBAAgB,mCAAmC,CAAC,WAAW,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,iBAAiB,GAAE,MAAmB,GAAG,IAAI,CAAC,sBAAsB,EAAE,UAAU,CAAC,CA+D/M;AAMD,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,sBAAsB,GAAG;IAChF,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CA4BA;AAMD,wBAAgB,wBAAwB,IAAI,qBAAqB,EAAE,CAElE;AAMD,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,sBAAsB,EAAE,OAAO,EAAE,qBAAqB,GAAG,qBAAqB,CAc/H"}

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

@@ -0,0 +1,191 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { ARQUETIPOS } from '../strategists/index.js';
+import { getMessages } from '../../core/messages/index.js';
+import { TUTANUS_ARQUIVOS } from '../../core/registry/index.js';
+import { lerEstado, salvarEstado } from '../../shared/persistence/index.js';
+const { log, ArquetiposExtraMensagens } = getMessages();
+const ARQUETIPO_PERSONALIZADO_FILENAME = 'tutanus.repo.arquetipo.json';
+export async function carregarArquetipoPersonalizado(baseDir = process.cwd()) {
+    const novoCaminho = TUTANUS_ARQUIVOS.ESTRUTURA_ARQUETIPO;
+    const caminhoLegado = path.join(baseDir, ARQUETIPO_PERSONALIZADO_FILENAME);
+    try {
+        const arquetipo = await lerEstado(novoCaminho, null);
+        if (arquetipo && arquetipo.nome && arquetipo.arquetipoOficial) {
+            return arquetipo;
+        }
+        const arquetipoLegado = await lerEstado(caminhoLegado, null);
+        if (!arquetipoLegado || !arquetipoLegado.nome || !arquetipoLegado.arquetipoOficial) {
+            const isTest = (process.env.VITEST ?? '') !== '';
+            const isVerbose = log.verbose || false;
+            if (!isTest && isVerbose) {
+                log.aviso(ArquetiposExtraMensagens.naoEncontrado.replace('{novo}', novoCaminho).replace('{legado}', caminhoLegado));
+            }
+            return null;
+        }
+        return arquetipoLegado;
+    }
+    catch {
+        return null;
+    }
+}
+export async function salvarArquetipoPersonalizado(arquetipo, _baseDir = process.cwd()) {
+    const arquetipoCompleto = {
+        ...arquetipo,
+        metadata: {
+            criadoEm: new Date().toISOString(),
+            versao: '1.0.0',
+            notasUsuario: undefined
+        }
+    };
+    const novoCaminho = TUTANUS_ARQUIVOS.ESTRUTURA_ARQUETIPO;
+    const tutanusDir = path.dirname(novoCaminho);
+    try {
+        await fs.mkdir(tutanusDir, {
+            recursive: true
+        });
+    }
+    catch {
+    }
+    await salvarEstado(novoCaminho, arquetipoCompleto);
+    log.sucesso(ArquetiposExtraMensagens.salvo.replace('{caminho}', novoCaminho));
+}
+export async function existeArquetipoPersonalizado(baseDir = process.cwd()) {
+    try {
+        await fs.stat(TUTANUS_ARQUIVOS.ESTRUTURA_ARQUETIPO);
+        return true;
+    }
+    catch {
+        const arquivoArquetipo = path.join(baseDir, ARQUETIPO_PERSONALIZADO_FILENAME);
+        try {
+            await fs.stat(arquivoArquetipo);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+export function obterArquetipoOficial(arquetipoPersonalizado) {
+    const nomeOficial = arquetipoPersonalizado.arquetipoOficial ?? '';
+    const encontrado = ARQUETIPOS?.find((arq) => arq.nome === nomeOficial);
+    return encontrado ?? null;
+}
+export function gerarSugestaoArquetipoPersonalizado(projetoDesconhecido) {
+    const sugestao = `
+${ArquetiposExtraMensagens.projetoPersonalizado.replace('{nome}', projetoDesconhecido.nome)}
+
+${ArquetiposExtraMensagens.descricaoPersonalizado}
+
+${ArquetiposExtraMensagens.estruturaDetectada}
+${projetoDesconhecido.estruturaDetectada.map(dir => `  • ${dir}`).join('\n')}
+
+${ArquetiposExtraMensagens.arquivosRaiz}
+${projetoDesconhecido.arquivosRaiz.slice(0, 5).map(file => `  • ${file}`).join('\n')}
+${projetoDesconhecido.arquivosRaiz.length > 5 ? `  • ... e mais ${projetoDesconhecido.arquivosRaiz.length - 5} arquivos` : ''}
+
+${ArquetiposExtraMensagens.dicaCriar}
+${ArquetiposExtraMensagens.comandoCriar}
+
+${ArquetiposExtraMensagens.explicacaoCriar}
+`;
+    return sugestao;
+}
+export function criarTemplateArquetipoPersonalizado(nomeProjeto, estruturaDetectada, arquivosRaiz, arquetipoSugerido = 'generico') {
+    let arquetipoOficial = arquetipoSugerido;
+    if (arquetipoOficial === 'generico' || !arquetipoOficial) {
+        const temBin = estruturaDetectada.some(dir => dir === 'bin' || dir.startsWith('bin/'));
+        const temCli = estruturaDetectada.some(dir => dir.includes('/cli') || dir === 'cli');
+        const temCommands = estruturaDetectada.some(dir => dir.includes('/commands') || dir === 'commands');
+        if (temBin && (temCli || temCommands)) {
+            arquetipoOficial = 'cli-modular';
+        }
+        else if (estruturaDetectada.some(dir => dir === 'src/bot' || dir.startsWith('src/bot/')) && estruturaDetectada.some(dir => dir.includes('events') || dir.includes('scenes'))) {
+            arquetipoOficial = 'bot';
+        }
+        else if (estruturaDetectada.some(dir => dir.includes('controllers')) && estruturaDetectada.some(dir => dir.includes('routes'))) {
+            arquetipoOficial = 'api-rest-express';
+        }
+        else if (estruturaDetectada.some(dir => dir.includes('pages')) && estruturaDetectada.some(dir => dir.includes('api'))) {
+            arquetipoOficial = 'fullstack';
+        }
+        else if (estruturaDetectada.some(dir => dir === 'src' || dir.startsWith('src/'))) {
+            arquetipoOficial = 'lib-tsc';
+        }
+    }
+    const diretoriosPrincipais = estruturaDetectada.filter(dir => !dir.includes('/') || dir.split('/').length <= 2).filter(dir => !dir.startsWith('node_modules') && !dir.startsWith('.git'));
+    const arquivosChave = arquivosRaiz.filter(file => ['package.json', 'tsconfig.json', 'README.md', '.env.example'].includes(file) || file.endsWith('.ts') || file.endsWith('.js')).slice(0, 5);
+    return {
+        nome: nomeProjeto,
+        descricao: `Projeto personalizado: ${nomeProjeto}`,
+        arquetipoOficial,
+        estruturaPersonalizada: {
+            diretorios: diretoriosPrincipais,
+            arquivosChave,
+            padroesNomenclatura: {
+                ...(estruturaDetectada.some(diretorio => diretorio.includes('components')) && {
+                    components: '*-component.*'
+                }),
+                ...(estruturaDetectada.some(diretorio => diretorio.includes('utils')) && {
+                    utils: '*-util.*'
+                }),
+                ...(estruturaDetectada.some(diretorio => diretorio.includes('test')) && {
+                    tests: '*.test.*'
+                })
+            }
+        },
+        melhoresPraticas: {
+            recomendado: ['src/', 'tests/', 'docs/', 'README.md', '.env.example'],
+            evitar: ['temp/', 'cache/', '*.log'],
+            notas: ['Mantenha código fonte organizado em src/', 'Separe testes em pasta dedicada', 'Documente APIs e funcionalidades importantes']
+        }
+    };
+}
+export function validarArquetipoPersonalizado(arquetipo) {
+    const erros = [];
+    if (!arquetipo.nome || typeof arquetipo.nome !== 'string') {
+        erros.push(ArquetiposExtraMensagens.validacao.nomeObrigatorio);
+    }
+    if (!arquetipo.arquetipoOficial || typeof arquetipo.arquetipoOficial !== 'string') {
+        erros.push(ArquetiposExtraMensagens.validacao.arquetipoObrigatorio);
+    }
+    else {
+        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(', ')));
+        }
+    }
+    if (!arquetipo.estruturaPersonalizada) {
+        erros.push(ArquetiposExtraMensagens.validacao.estruturaObrigatoria);
+    }
+    else {
+        if (!Array.isArray(arquetipo.estruturaPersonalizada.diretorios)) {
+            erros.push(ArquetiposExtraMensagens.validacao.diretoriosArray);
+        }
+        if (!Array.isArray(arquetipo.estruturaPersonalizada.arquivosChave)) {
+            erros.push(ArquetiposExtraMensagens.validacao.arquivosChaveArray);
+        }
+    }
+    return {
+        valido: erros.length === 0,
+        erros
+    };
+}
+export function listarArquetiposOficiais() {
+    return ARQUETIPOS;
+}
+export function integrarArquetipos(personalizado, oficial) {
+    return {
+        ...oficial,
+        nome: personalizado.nome,
+        descricao: personalizado.descricao || oficial.descricao,
+        requiredDirs: personalizado.estruturaPersonalizada.diretorios,
+        optionalDirs: oficial.optionalDirs,
+        rootFilesAllowed: personalizado.estruturaPersonalizada.arquivosChave,
+        forbiddenDirs: oficial.forbiddenDirs,
+        dependencyHints: oficial.dependencyHints,
+        filePresencePatterns: oficial.filePresencePatterns,
+        pesoBase: oficial.pesoBase
+    };
+}
+//# sourceMappingURL=archetypes-custom.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"archetypes-custom.js","sourceRoot":"","sources":["../../../src/analysts/architects/archetypes-custom.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGnD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAI9D,MAAM,EACJ,GAAG,EACH,wBAAwB,EACzB,GAAG,WAAW,EAAE,CAAC;AAGlB,MAAM,gCAAgC,GAAG,6BAA6B,CAAC;AAQvE,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAAC,UAAkB,OAAO,CAAC,GAAG,EAAE;IAElF,MAAM,WAAW,GAAG,gBAAgB,CAAC,mBAAmB,CAAC;IACzD,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,gCAAgC,CAAC,CAAC;IAC3E,IAAI,CAAC;QAEH,MAAM,SAAS,GAAG,MAAM,SAAS,CAAgC,WAAW,EAAE,IAAI,CAAC,CAAC;QACpF,IAAI,SAAS,IAAI,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,gBAAgB,EAAE,CAAC;YAC9D,OAAO,SAAS,CAAC;QACnB,CAAC;QAGD,MAAM,eAAe,GAAG,MAAM,SAAS,CAAgC,aAAa,EAAE,IAAI,CAAC,CAAC;QAG5F,IAAI,CAAC,eAAe,IAAI,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC,eAAe,CAAC,gBAAgB,EAAE,CAAC;YAEnF,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC;YACjD,MAAM,SAAS,GAAI,GAEjB,CAAC,OAAO,IAAI,KAAK,CAAC;YACpB,IAAI,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;gBACzB,GAAG,CAAC,KAAK,CAAC,wBAAwB,CAAC,aAAa,CAAC,OAAO,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC;YACtH,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,eAAe,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QAEP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAKD,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,SAAmD,EAAE,WAAmB,OAAO,CAAC,GAAG,EAAE;IACtI,MAAM,iBAAiB,GAA2B;QAChD,GAAG,SAAS;QACZ,QAAQ,EAAE;YACR,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAClC,MAAM,EAAE,OAAO;YACf,YAAY,EAAE,SAAS;SACxB;KACF,CAAC;IAGF,MAAM,WAAW,GAAG,gBAAgB,CAAC,mBAAmB,CAAC;IAGzD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC7C,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE;YACzB,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;IAET,CAAC;IACD,MAAM,YAAY,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC;IACnD,GAAG,CAAC,OAAO,CAAC,wBAAwB,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;AAChF,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,UAAkB,OAAO,CAAC,GAAG,EAAE;IAChF,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,mBAAmB,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,gCAAgC,CAAC,CAAC;QAC9E,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YAChC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;AACH,CAAC;AAMD,MAAM,UAAU,qBAAqB,CAAC,sBAA8C;IAClF,MAAM,WAAW,GAAG,sBAAsB,CAAC,gBAAgB,IAAI,EAAE,CAAC;IAClE,MAAM,UAAU,GAAG,UAAU,EAAE,IAAI,CAAC,CAAC,GAA0B,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;IAC9F,OAAO,UAAU,IAAI,IAAI,CAAC;AAC5B,CAAC;AAMD,MAAM,UAAU,mCAAmC,CAAC,mBAInD;IACC,MAAM,QAAQ,GAAG;EACjB,wBAAwB,CAAC,oBAAoB,CAAC,OAAO,CAAC,QAAQ,EAAE,mBAAmB,CAAC,IAAI,CAAC;;EAEzF,wBAAwB,CAAC,sBAAsB;;EAE/C,wBAAwB,CAAC,kBAAkB;EAC3C,mBAAmB,CAAC,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;EAE1E,wBAAwB,CAAC,YAAY;EACrC,mBAAmB,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;EAClF,mBAAmB,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,kBAAkB,mBAAmB,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE;;EAE3H,wBAAwB,CAAC,SAAS;EAClC,wBAAwB,CAAC,YAAY;;EAErC,wBAAwB,CAAC,eAAe;CACzC,CAAC;IACA,OAAO,QAAQ,CAAC;AAClB,CAAC;AAMD,MAAM,UAAU,mCAAmC,CAAC,WAAmB,EAAE,kBAA4B,EAAE,YAAsB,EAAE,oBAA4B,UAAU;IAGnK,IAAI,gBAAgB,GAAG,iBAAiB,CAAC;IACzC,IAAI,gBAAgB,KAAK,UAAU,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAIzD,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,KAAK,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QACvF,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,GAAG,KAAK,KAAK,CAAC,CAAC;QACrF,MAAM,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,GAAG,KAAK,UAAU,CAAC,CAAC;QACpG,IAAI,MAAM,IAAI,CAAC,MAAM,IAAI,WAAW,CAAC,EAAE,CAAC;YACtC,gBAAgB,GAAG,aAAa,CAAC;QACnC,CAAC;aAEI,IAAI,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;YAC7K,gBAAgB,GAAG,KAAK,CAAC;QAC3B,CAAC;aAEI,IAAI,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;YAC/H,gBAAgB,GAAG,kBAAkB,CAAC;QACxC,CAAC;aAEI,IAAI,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACtH,gBAAgB,GAAG,WAAW,CAAC;QACjC,CAAC;aAEI,IAAI,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,KAAK,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YACjF,gBAAgB,GAAG,SAAS,CAAC;QAC/B,CAAC;IACH,CAAC;IAGD,MAAM,oBAAoB,GAAG,kBAAkB,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAG1L,MAAM,aAAa,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7L,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,SAAS,EAAE,0BAA0B,WAAW,EAAE;QAClD,gBAAgB;QAChB,sBAAsB,EAAE;YACtB,UAAU,EAAE,oBAAoB;YAChC,aAAa;YACb,mBAAmB,EAAE;gBAEnB,GAAG,CAAC,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,IAAI;oBAC5E,UAAU,EAAE,eAAe;iBAC5B,CAAC;gBACF,GAAG,CAAC,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI;oBACvE,KAAK,EAAE,UAAU;iBAClB,CAAC;gBACF,GAAG,CAAC,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI;oBACtE,KAAK,EAAE,UAAU;iBAClB,CAAC;aACH;SACF;QACD,gBAAgB,EAAE;YAChB,WAAW,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,cAAc,CAAC;YACrE,MAAM,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC;YACpC,KAAK,EAAE,CAAC,0CAA0C,EAAE,iCAAiC,EAAE,8CAA8C,CAAC;SACvI;KACF,CAAC;AACJ,CAAC;AAMD,MAAM,UAAU,6BAA6B,CAAC,SAAiC;IAI7E,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC1D,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,CAAC,SAAS,CAAC,gBAAgB,IAAI,OAAO,SAAS,CAAC,gBAAgB,KAAK,QAAQ,EAAE,CAAC;QAClF,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;IACtE,CAAC;SAAM,CAAC;QAEN,MAAM,gBAAgB,GAAG,UAAU,EAAE,IAAI,CAAC,CAAC,GAA0B,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,gBAAgB,CAAsC,CAAC;QACxJ,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,SAAS,CAAC,sBAAsB,CAAC,OAAO,CAAC,aAAa,EAAE,SAAS,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAE,OAA4C,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtP,CAAC;IACH,CAAC;IACD,IAAI,CAAC,SAAS,CAAC,sBAAsB,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;IACtE,CAAC;SAAM,CAAC;QACN,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,sBAAsB,CAAC,UAAU,CAAC,EAAE,CAAC;YAChE,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,sBAAsB,CAAC,aAAa,CAAC,EAAE,CAAC;YACnE,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IACD,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,MAAM,KAAK,CAAC;QAC1B,KAAK;KACN,CAAC;AACJ,CAAC;AAMD,MAAM,UAAU,wBAAwB;IACtC,OAAO,UAAU,CAAC;AACpB,CAAC;AAMD,MAAM,UAAU,kBAAkB,CAAC,aAAqC,EAAE,OAA8B;IACtG,OAAO;QACL,GAAG,OAAO;QACV,IAAI,EAAE,aAAa,CAAC,IAAI;QACxB,SAAS,EAAE,aAAa,CAAC,SAAS,IAAI,OAAO,CAAC,SAAS;QACvD,YAAY,EAAE,aAAa,CAAC,sBAAsB,CAAC,UAAU;QAC7D,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,gBAAgB,EAAE,aAAa,CAAC,sBAAsB,CAAC,aAAa;QAEpE,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;QAClD,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,CAAC;AACJ,CAAC","sourcesContent":["// SPDX-License-Identifier: MIT\n// @tutanus-disable tipo-literal-inline-complexo\n// Justificativa: tipos locais para arquétipos personalizados\n/**\n * Sistema de Arquétipos Personalizados do Tutanus\n *\n * Permite que usuários criem arquétipos personalizados para seus projetos,\n * mantendo compatibilidade com arquétipos oficiais e oferecendo sugestões\n * de melhores práticas baseadas na personalização do usuário.\n */\n\nimport { promises as fs } from 'node:fs';\nimport path from 'node:path';\n\nimport { ARQUETIPOS } from '@analysts/strategists';\n// NOTA: parseFileAST ainda não foi implementado no módulo de parsing\n// import { parseFileAST } from '@core/parsing/parser.js';\nimport { getMessages } from '@core/messages';\nimport { TUTANUS_ARQUIVOS } from '@core/registry';\nimport { lerEstado, salvarEstado } from '@shared/persistence';\n\nimport type { ArquetipoEstruturaDef, ArquetipoPersonalizado } from '@';\n\nconst {\n  log,\n  ArquetiposExtraMensagens\n} = getMessages();\n\n// Nome do arquivo legado (para compatibilidade)\nconst ARQUETIPO_PERSONALIZADO_FILENAME = 'tutanus.repo.arquetipo.json';\n\n/**\n * Carrega o arquétipo personalizado do projeto atual\n * Tenta primeiro o novo caminho (.tutanus/estrutura.arquetipo.json),\n * depois o legado (raiz/tutanus.repo.arquetipo.json)\n */\n\nexport async function carregarArquetipoPersonalizado(baseDir: string = process.cwd()): Promise<ArquetipoPersonalizado | null> {\n  // Tentar novo caminho primeiro\n  const novoCaminho = TUTANUS_ARQUIVOS.ESTRUTURA_ARQUETIPO;\n  const caminhoLegado = path.join(baseDir, ARQUETIPO_PERSONALIZADO_FILENAME);\n  try {\n    // Tenta novo caminho\n    const arquetipo = await lerEstado<ArquetipoPersonalizado | null>(novoCaminho, null);\n    if (arquetipo && arquetipo.nome && arquetipo.arquetipoOficial) {\n      return arquetipo;\n    }\n\n    // Se não encontrou no novo caminho, tenta o legado\n    const arquetipoLegado = await lerEstado<ArquetipoPersonalizado | null>(caminhoLegado, null);\n\n    // Validação básica\n    if (!arquetipoLegado || !arquetipoLegado.nome || !arquetipoLegado.arquetipoOficial) {\n      // Reduz ruído em testes e quando não estiver em modo verbose\n      const isTest = (process.env.VITEST ?? '') !== '';\n      const isVerbose = (log as unknown as {\n        verbose?: boolean;\n      }).verbose || false;\n      if (!isTest && isVerbose) {\n        log.aviso(ArquetiposExtraMensagens.naoEncontrado.replace('{novo}', novoCaminho).replace('{legado}', caminhoLegado));\n      }\n      return null;\n    }\n    return arquetipoLegado;\n  } catch {\n    // Arquivo não existe ou é inválido - isso é normal\n    return null;\n  }\n}\n/**\n * Salva o arquétipo personalizado do projeto atual\n * Usa o novo caminho (.tutanus/estrutura.arquetipo.json)\n */\nexport async function salvarArquetipoPersonalizado(arquetipo: Omit<ArquetipoPersonalizado, 'metadata'>, _baseDir: string = process.cwd()): Promise<void> {\n  const arquetipoCompleto: ArquetipoPersonalizado = {\n    ...arquetipo,\n    metadata: {\n      criadoEm: new Date().toISOString(),\n      versao: '1.0.0',\n      notasUsuario: undefined\n    }\n  };\n\n  // Usar novo caminho centralizado\n  const novoCaminho = TUTANUS_ARQUIVOS.ESTRUTURA_ARQUETIPO;\n\n  // Garantir que o diretório .tutanus existe\n  const tutanusDir = path.dirname(novoCaminho);\n  try {\n    await fs.mkdir(tutanusDir, {\n      recursive: true\n    });\n  } catch {\n    // Diretório já existe\n  }\n  await salvarEstado(novoCaminho, arquetipoCompleto);\n  log.sucesso(ArquetiposExtraMensagens.salvo.replace('{caminho}', novoCaminho));\n}\n\n/**\n * Verifica se existe um arquétipo personalizado\n * Verifica tanto o novo caminho quanto o legado\n */\n\nexport async function existeArquetipoPersonalizado(baseDir: string = process.cwd()): Promise<boolean> {\n  try {\n    await fs.stat(TUTANUS_ARQUIVOS.ESTRUTURA_ARQUETIPO);\n    return true;\n  } catch {\n    const arquivoArquetipo = path.join(baseDir, ARQUETIPO_PERSONALIZADO_FILENAME);\n    try {\n      await fs.stat(arquivoArquetipo);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n}\n\n/**\n * Obtém o arquétipo oficial base para um arquétipo personalizado\n */\n\nexport function obterArquetipoOficial(arquetipoPersonalizado: ArquetipoPersonalizado): ArquetipoEstruturaDef | null {\n  const nomeOficial = arquetipoPersonalizado.arquetipoOficial ?? '';\n  const encontrado = ARQUETIPOS?.find((arq: ArquetipoEstruturaDef) => arq.nome === nomeOficial);\n  return encontrado ?? null;\n}\n\n/**\n * Gera sugestões de criação de arquétipo personalizado quando projeto é desconhecido\n */\n\nexport function gerarSugestaoArquetipoPersonalizado(projetoDesconhecido: {\n  nome: string;\n  estruturaDetectada: string[];\n  arquivosRaiz: string[];\n}): string {\n  const sugestao = `\n${ArquetiposExtraMensagens.projetoPersonalizado.replace('{nome}', projetoDesconhecido.nome)}\n\n${ArquetiposExtraMensagens.descricaoPersonalizado}\n\n${ArquetiposExtraMensagens.estruturaDetectada}\n${projetoDesconhecido.estruturaDetectada.map(dir => `  • ${dir}`).join('\\n')}\n\n${ArquetiposExtraMensagens.arquivosRaiz}\n${projetoDesconhecido.arquivosRaiz.slice(0, 5).map(file => `  • ${file}`).join('\\n')}\n${projetoDesconhecido.arquivosRaiz.length > 5 ? `  • ... e mais ${projetoDesconhecido.arquivosRaiz.length - 5} arquivos` : ''}\n\n${ArquetiposExtraMensagens.dicaCriar}\n${ArquetiposExtraMensagens.comandoCriar}\n\n${ArquetiposExtraMensagens.explicacaoCriar}\n`;\n  return sugestao;\n}\n\n/**\n * Cria um template de arquétipo personalizado baseado na estrutura atual do projeto\n */\n\nexport function criarTemplateArquetipoPersonalizado(nomeProjeto: string, estruturaDetectada: string[], arquivosRaiz: string[], arquetipoSugerido: string = 'generico'): Omit<ArquetipoPersonalizado, 'metadata'> {\n  // Usa o arquétipo sugerido pelo sistema de detecção inteligente\n  // Se não foi fornecido, tenta inferir de forma mais rigorosa\n  let arquetipoOficial = arquetipoSugerido;\n  if (arquetipoOficial === 'generico' || !arquetipoOficial) {\n    // Heurística mais rigorosa para evitar falsos positivos\n\n    // CLI: precisa ter bin/ E (cli/ OU commands/) E package.json com bin\n    const temBin = estruturaDetectada.some(dir => dir === 'bin' || dir.startsWith('bin/'));\n    const temCli = estruturaDetectada.some(dir => dir.includes('/cli') || dir === 'cli');\n    const temCommands = estruturaDetectada.some(dir => dir.includes('/commands') || dir === 'commands');\n    if (temBin && (temCli || temCommands)) {\n      arquetipoOficial = 'cli-modular';\n    }\n    // Bot: precisa ter src/bot/ E (events/ OU scenes/) - muito específico\n    else if (estruturaDetectada.some(dir => dir === 'src/bot' || dir.startsWith('src/bot/')) && estruturaDetectada.some(dir => dir.includes('events') || dir.includes('scenes'))) {\n      arquetipoOficial = 'bot';\n    }\n    // API: precisa ter controllers/ E routes/\n    else if (estruturaDetectada.some(dir => dir.includes('controllers')) && estruturaDetectada.some(dir => dir.includes('routes'))) {\n      arquetipoOficial = 'api-rest-express';\n    }\n    // Fullstack: precisa ter pages/ E api/ (ambos)\n    else if (estruturaDetectada.some(dir => dir.includes('pages')) && estruturaDetectada.some(dir => dir.includes('api'))) {\n      arquetipoOficial = 'fullstack';\n    }\n    // Fallback: lib-tsc se tem src/ organizado mas nenhum dos padrões acima\n    else if (estruturaDetectada.some(dir => dir === 'src' || dir.startsWith('src/'))) {\n      arquetipoOficial = 'lib-tsc';\n    }\n  }\n\n  // Identifica diretórios principais (não muito profundos)\n  const diretoriosPrincipais = estruturaDetectada.filter(dir => !dir.includes('/') || dir.split('/').length <= 2).filter(dir => !dir.startsWith('node_modules') && !dir.startsWith('.git'));\n\n  // Identifica arquivos-chave na raiz\n  const arquivosChave = arquivosRaiz.filter(file => ['package.json', 'tsconfig.json', 'README.md', '.env.example'].includes(file) || file.endsWith('.ts') || file.endsWith('.js')).slice(0, 5);\n  return {\n    nome: nomeProjeto,\n    descricao: `Projeto personalizado: ${nomeProjeto}`,\n    arquetipoOficial,\n    estruturaPersonalizada: {\n      diretorios: diretoriosPrincipais,\n      arquivosChave,\n      padroesNomenclatura: {\n        // Padrões comuns baseados na estrutura detectada\n        ...(estruturaDetectada.some(diretorio => diretorio.includes('components')) && {\n          components: '*-component.*'\n        }),\n        ...(estruturaDetectada.some(diretorio => diretorio.includes('utils')) && {\n          utils: '*-util.*'\n        }),\n        ...(estruturaDetectada.some(diretorio => diretorio.includes('test')) && {\n          tests: '*.test.*'\n        })\n      }\n    },\n    melhoresPraticas: {\n      recomendado: ['src/', 'tests/', 'docs/', 'README.md', '.env.example'],\n      evitar: ['temp/', 'cache/', '*.log'],\n      notas: ['Mantenha código fonte organizado em src/', 'Separe testes em pasta dedicada', 'Documente APIs e funcionalidades importantes']\n    }\n  };\n}\n\n/**\n * Valida um arquétipo personalizado\n */\n\nexport function validarArquetipoPersonalizado(arquetipo: ArquetipoPersonalizado): {\n  valido: boolean;\n  erros: string[];\n} {\n  const erros: string[] = [];\n  if (!arquetipo.nome || typeof arquetipo.nome !== 'string') {\n    erros.push(ArquetiposExtraMensagens.validacao.nomeObrigatorio);\n  }\n  if (!arquetipo.arquetipoOficial || typeof arquetipo.arquetipoOficial !== 'string') {\n    erros.push(ArquetiposExtraMensagens.validacao.arquetipoObrigatorio);\n  } else {\n    // Verifica se o arquétipo oficial existe\n    const arquetipoOficial = ARQUETIPOS?.find((arq: ArquetipoEstruturaDef) => arq.nome === arquetipo.arquetipoOficial) as ArquetipoEstruturaDef | undefined;\n    if (!arquetipoOficial) {\n      erros.push(ArquetiposExtraMensagens.validacao.arquetipoNaoEncontrado.replace('{arquetipo}', arquetipo.arquetipoOficial).replace('{disponiveis}', (ARQUETIPOS ?? []).map(arquivo => (arquivo as unknown as ArquetipoEstruturaDef).nome).join(', ')));\n    }\n  }\n  if (!arquetipo.estruturaPersonalizada) {\n    erros.push(ArquetiposExtraMensagens.validacao.estruturaObrigatoria);\n  } else {\n    if (!Array.isArray(arquetipo.estruturaPersonalizada.diretorios)) {\n      erros.push(ArquetiposExtraMensagens.validacao.diretoriosArray);\n    }\n    if (!Array.isArray(arquetipo.estruturaPersonalizada.arquivosChave)) {\n      erros.push(ArquetiposExtraMensagens.validacao.arquivosChaveArray);\n    }\n  }\n  return {\n    valido: erros.length === 0,\n    erros\n  };\n}\n\n/**\n * Lista todos os arquétipos oficiais disponíveis\n */\n\nexport function listarArquetiposOficiais(): ArquetipoEstruturaDef[] {\n  return ARQUETIPOS;\n}\n\n/**\n * Integra arquétipo personalizado com oficial para sugestões\n */\n\nexport function integrarArquetipos(personalizado: ArquetipoPersonalizado, oficial: ArquetipoEstruturaDef): ArquetipoEstruturaDef {\n  return {\n    ...oficial,\n    nome: personalizado.nome,\n    descricao: personalizado.descricao || oficial.descricao,\n    requiredDirs: personalizado.estruturaPersonalizada.diretorios,\n    optionalDirs: oficial.optionalDirs,\n    rootFilesAllowed: personalizado.estruturaPersonalizada.arquivosChave,\n    // Mantém outras propriedades do oficial como base\n    forbiddenDirs: oficial.forbiddenDirs,\n    dependencyHints: oficial.dependencyHints,\n    filePresencePatterns: oficial.filePresencePatterns,\n    pesoBase: oficial.pesoBase\n  };\n}"]}

package/dist/analysts/architects/detector-archetypes.d.ts

@@ -0,0 +1,10 @@
+import type { ArquetipoDrift, ArquetipoPersonalizado, ContextoExecucao, ResultadoDeteccaoArquetipo, SnapshotEstruturaBaseline } from '../../types/index.js';
+export declare function detectarArquetipos(contexto: Pick<ContextoExecucao, 'arquivos' | 'baseDir'>, baseDir: string, options?: {
+    quiet?: boolean;
+}): Promise<{
+    candidatos: ResultadoDeteccaoArquetipo[];
+    baseline?: SnapshotEstruturaBaseline;
+    drift?: ArquetipoDrift;
+    arquetipoPersonalizado?: ArquetipoPersonalizado | null;
+}>;
+//# sourceMappingURL=detector-archetypes.d.ts.map

package/dist/analysts/architects/detector-archetypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector-archetypes.d.ts","sourceRoot":"","sources":["../../../src/analysts/architects/detector-archetypes.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAyB,sBAAsB,EAAE,gBAAgB,EAAkC,0BAA0B,EAA0B,yBAAyB,EAAE,MAAM,GAAG,CAAC;AA8CxN,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,IAAI,CAAC,gBAAgB,EAAE,UAAU,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAC5H,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GAAG,OAAO,CAAC;IACV,UAAU,EAAE,0BAA0B,EAAE,CAAC;IACzC,QAAQ,CAAC,EAAE,yBAAyB,CAAC;IACrC,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,sBAAsB,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAC;CACxD,CAAC,CAuQD"}

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

@@ -0,0 +1,262 @@
+import path from 'node:path';
+import { scoreArquetipoAvancado } from '../scorers/index.js';
+import { ARQUETIPOS, OperarioEstrutura } from '../strategists/index.js';
+import { config } from '../../core/config/index.js';
+import { getMessages } from '../../core/messages/index.js';
+import { lerEstado, salvarEstado } from '../../shared/persistence/index.js';
+import { carregarArquetipoPersonalizado, integrarArquetipos, obterArquetipoOficial } from './archetypes-custom.js';
+import { extrairSinaisAvancados } from './signals-project-advanced.js';
+const { DetectorArquetiposExtraMensagens } = getMessages();
+function scoreArquetipo(def, arquivos, _sinaisAvancados) {
+    const matchedRequired = (def.requiredDirs || []).filter(diretorio => arquivos.some(arquivo => arquivo.startsWith(`${diretorio}/`) || arquivo === diretorio));
+    const missingRequired = (def.requiredDirs || []).filter(diretorio => !matchedRequired.includes(diretorio));
+    return {
+        nome: def.nome,
+        score: def.pesoBase ? def.pesoBase * 10 : 10,
+        confidence: 50,
+        matchedRequired,
+        missingRequired,
+        matchedOptional: [],
+        dependencyMatches: [],
+        filePadraoMatches: [],
+        forbiddenPresent: [],
+        anomalias: [],
+        sugestaoPadronizacao: '',
+        explicacaoSimilaridade: '',
+        descricao: def.descricao || '',
+        candidatoExtra: undefined
+    };
+}
+if (process.env.VITEST) {
+    const grupo = globalThis;
+    const prev = grupo.__TUTANUS_TESTS__ ?? {};
+    grupo.__TUTANUS_TESTS__ = {
+        ...prev,
+        scoreArquetipo
+    };
+}
+export async function detectarArquetipos(contexto, baseDir, options) {
+    if (!options?.quiet && config.VERBOSE) {
+        console.log(DetectorArquetiposExtraMensagens.debugChamado, contexto.arquivos.length, 'arquivos');
+    }
+    const arquivos = contexto.arquivos.map(arquivo => arquivo.relPath);
+    const arquetipoPersonalizado = await carregarArquetipoPersonalizado(baseDir);
+    let arquetiposParaAvaliar = ARQUETIPOS;
+    if (arquetipoPersonalizado) {
+        const arquetipoOficial = obterArquetipoOficial(arquetipoPersonalizado);
+        if (arquetipoOficial) {
+            const arquetipoIntegrado = integrarArquetipos(arquetipoPersonalizado, arquetipoOficial);
+            arquetiposParaAvaliar = ARQUETIPOS.map((arq) => arq.nome === arquetipoPersonalizado.arquetipoOficial ? arquetipoIntegrado : arq);
+        }
+    }
+    let packageJsonParaSinais = {};
+    try {
+        packageJsonParaSinais = (await lerEstado(path.join(baseDir, 'package.json')));
+    }
+    catch {
+        packageJsonParaSinais = {};
+    }
+    const sinaisAvancados = extrairSinaisAvancados(contexto.arquivos, packageJsonParaSinais, undefined, baseDir, arquivos);
+    let candidatos = arquetiposParaAvaliar.map((def) => scoreArquetipoAvancado(def, arquivos, sinaisAvancados));
+    if (!options?.quiet && config.VERBOSE) {
+        console.log(DetectorArquetiposExtraMensagens.debugContextual);
+    }
+    try {
+        const { detectarContextoInteligente } = await import('../js-ts/detectors/index.js');
+        const estruturaDetectada = arquivos;
+        let packageJsonContent = {};
+        try {
+            packageJsonContent = (await lerEstado(path.join(baseDir, 'package.json')));
+        }
+        catch {
+            packageJsonContent = {};
+        }
+        const resultadosContextuais = detectarContextoInteligente(estruturaDetectada, contexto.arquivos, packageJsonContent, options);
+        const melhorDeteccao = resultadosContextuais.reduce((melhor, atual) => atual.confiancaTotal > melhor.confiancaTotal ? atual : melhor, {
+            confiancaTotal: 0
+        });
+        if (melhorDeteccao && melhorDeteccao.confiancaTotal > 0.6) {
+            const mapeamentoTecnologia = {
+                'discord-bot': ['bot-discord', 'bot', 'discord-bot'],
+                'telegram-bot': ['bot-telegram', 'bot', 'telegram-bot'],
+                'express-api': ['api-rest-express', 'api-rest', 'express-api'],
+                'fastify-api': ['api-rest-fastify', 'api-rest', 'fastify-api'],
+                'nestjs-api': ['api-rest-nestjs', 'api-rest', 'nestjs-api'],
+                'cli-modular': ['cli-modular', 'cli', 'cli-tool'],
+                'electron-app': ['electron-app', 'electron', 'desktop-app'],
+                'nextjs-app': ['nextjs-app', 'nextjs', 'fullstack'],
+                'react-spa': ['react-spa', 'react', 'spa']
+            };
+            const tecnologiaDetectada = melhorDeteccao.tecnologia ?? 'desconhecido';
+            const arquetiposCandidatos = mapeamentoTecnologia[tecnologiaDetectada] || [];
+            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);
+                    boostAplicado = true;
+                    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;
+            });
+            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);
+            }
+        }
+    }
+    catch (error) {
+        if (process.env.NODE_ENV !== 'production') {
+            console.debug('Sistema inteligente não disponível:', error);
+        }
+    }
+    candidatos.sort((arquivo, base) => base.confidence - arquivo.confidence || base.score - arquivo.score);
+    const scoresValidos = candidatos.filter(elem => elem.confidence >= 30);
+    if (!scoresValidos.length) {
+        const temAlgumaEstrutura = arquivos.some(arquivo => arquivo.includes('src/') || arquivo.includes('lib/') || arquivo.includes('app/') || arquivo.includes('packages/'));
+        candidatos = [{
+                nome: 'desconhecido',
+                score: 0,
+                confidence: temAlgumaEstrutura ? 10 : 0,
+                matchedRequired: [],
+                missingRequired: [],
+                matchedOptional: [],
+                dependencyMatches: [],
+                filePadraoMatches: [],
+                forbiddenPresent: [],
+                anomalias: [],
+                sugestaoPadronizacao: temAlgumaEstrutura ? 'Projeto tem alguma estrutura, mas não corresponde a arquétipos conhecidos. Considere organizar em src/, lib/ ou app/.' : 'Projeto sem estrutura clara detectada. Considere criar uma organização básica.',
+                explicacaoSimilaridade: temAlgumaEstrutura ? 'Estrutura parcial detectada, mas não suficiente para classificação.' : 'Nenhum arquétipo identificado.',
+                descricao: 'Nenhum arquétipo identificado.'
+            }];
+    }
+    else {
+        const top = scoresValidos[0];
+        const proximos = scoresValidos.filter(elem => elem !== top && Math.abs(elem.confidence - top.confidence) <= 15);
+        const ehHibridoReal = proximos.some(elem => elem.matchedRequired.some(req => top.matchedRequired.includes(req)) || elem.dependencyMatches.some(dep => top.dependencyMatches.includes(dep)));
+        if (proximos.length > 0 && ehHibridoReal) {
+            const scoreHibrido = top.score * 0.7 + proximos.reduce((acc, elem) => acc + elem.score * 0.3 / proximos.length, 0);
+            const confidenceHibrido = Math.max(top.confidence - 10, 40);
+            candidatos = [{
+                    nome: 'misto',
+                    score: Math.round(scoreHibrido),
+                    confidence: confidenceHibrido,
+                    matchedRequired: [],
+                    missingRequired: [],
+                    matchedOptional: [],
+                    dependencyMatches: [],
+                    filePadraoMatches: [],
+                    forbiddenPresent: [],
+                    anomalias: [],
+                    sugestaoPadronizacao: '',
+                    explicacaoSimilaridade: `Estrutura híbrida detectada: combina elementos de ${[top.nome, ...proximos.map(caminho => caminho.nome)].join(', ')}. Recomenda-se avaliar se a separação em projetos distintos seria benéfica.`,
+                    descricao: 'Estrutura híbrida'
+                }];
+        }
+        else {
+            candidatos = [top];
+        }
+    }
+    const baselineCaminho = path.join(baseDir, '.tutanus', 'baseline-estrutura.json');
+    let baseline;
+    const existente = await lerEstado(baselineCaminho);
+    if (existente && !Array.isArray(existente) && typeof existente === 'object' && 'arquetipo' in existente) {
+        baseline = existente;
+    }
+    if (!baseline && candidatos[0]) {
+        baseline = {
+            version: 1,
+            timestamp: new Date().toISOString(),
+            arquetipo: candidatos[0].nome,
+            confidence: candidatos[0].confidence,
+            arquivosRaiz: arquivos.filter(caminho => !caminho.includes('/')).sort()
+        };
+        await salvarEstado(baselineCaminho, baseline);
+    }
+    if (baseline && baseline.arquetipo !== 'desconhecido') {
+        const arquivosRaizAtuais = arquivos.filter(caminho => !caminho.includes('/'));
+        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)) {
+            const melhorLinhaBase = {
+                nome: baseline.arquetipo,
+                score: 999,
+                confidence: baseline.confidence,
+                matchedRequired: [],
+                missingRequired: [],
+                matchedOptional: [],
+                dependencyMatches: [],
+                filePadraoMatches: [],
+                forbiddenPresent: [],
+                anomalias: [],
+                sugestaoPadronizacao: '',
+                explicacaoSimilaridade: 'Detectado via baseline existente (.tutanus/baseline-estrutura.json).',
+                descricao: 'Arquétipo determinado pelo baseline'
+            };
+            candidatos = [melhorLinhaBase, ...candidatos.filter((elem) => elem.nome !== baseline.arquetipo)];
+        }
+    }
+    let drift;
+    if (baseline && candidatos[0]) {
+        const atual = candidatos[0];
+        const arquivosRaizAtuais = arquivos.filter(caminho => !caminho.includes('/')).sort();
+        const setBase = new Set(baseline.arquivosRaiz);
+        const setAtual = new Set(arquivosRaizAtuais);
+        const novos = [];
+        const removidos = [];
+        for (const arquivo of setAtual)
+            if (!setBase.has(arquivo))
+                novos.push(arquivo);
+        for (const arquivo of setBase)
+            if (!setAtual.has(arquivo))
+                removidos.push(arquivo);
+        drift = {
+            alterouArquetipo: baseline.arquetipo !== atual.nome,
+            anterior: baseline.arquetipo,
+            atual: atual.nome,
+            deltaConfidence: atual.confidence - baseline.confidence,
+            arquivosRaizNovos: novos,
+            arquivosRaizRemovidos: removidos
+        };
+    }
+    if (candidatos[0]) {
+        try {
+            const preset = contexto.preset ?? 'tutanus';
+            const emTeste = !!process.env.VITEST;
+            const preferEstrategista = preset === 'tutanus' && !emTeste;
+            const { plano } = await OperarioEstrutura.planejar(baseDir, contexto.arquivos, {
+                preferEstrategista,
+                preset
+            });
+            if (plano)
+                candidatos[0].planoSugestao = plano;
+        }
+        catch {
+        }
+    }
+    return {
+        candidatos,
+        baseline,
+        drift,
+        arquetipoPersonalizado
+    };
+}
+//# sourceMappingURL=detector-archetypes.js.map