tutanus 0.12.0

package/dist/core/registry/file-registry.js

@@ -0,0 +1,160 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { messages } from '../messages/index.js';
+import { MIGRACAO_MAPA, TUTANUS_ARQUIVOS, TUTANUS_DIRS } from './paths.js';
+const log = messages.log;
+async function fileExists(fileCaminho) {
+    try {
+        await fs.stat(fileCaminho);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function ensureDir(fileCaminho) {
+    const dir = path.dirname(fileCaminho);
+    await fs.mkdir(dir, {
+        recursive: true
+    });
+}
+async function tryMigrate(targetPath) {
+    const legacyCaminho = Object.entries(MIGRACAO_MAPA).find(([_, target]) => target === targetPath)?.[0];
+    if (!legacyCaminho) {
+        return {
+            migrated: false
+        };
+    }
+    try {
+        const content = await fs.readFile(legacyCaminho, 'utf-8');
+        await ensureDir(targetPath);
+        try {
+            await fs.writeFile(targetPath, content, { encoding: 'utf-8', flag: 'wx' });
+        }
+        catch (err) {
+            const code = err.code;
+            if (code === 'EEXIST') {
+                return {
+                    migrated: true,
+                    from: legacyCaminho,
+                    to: targetPath
+                };
+            }
+            throw err;
+        }
+        const backupCaminho = `${legacyCaminho}.migrated`;
+        await fs.rename(legacyCaminho, backupCaminho).catch(() => {
+        });
+        log.info(`Migração automática: ${path.basename(legacyCaminho)} → ${path.basename(targetPath)}`);
+        return {
+            migrated: true,
+            from: legacyCaminho,
+            to: targetPath
+        };
+    }
+    catch (erro) {
+        const code = erro.code;
+        if (code === 'ENOENT') {
+            return {
+                migrated: false
+            };
+        }
+        log.aviso(`Falha na migração de ${legacyCaminho}: ${erro.message}`);
+        return {
+            migrated: false
+        };
+    }
+}
+export async function readJSON(fileCaminho, options = {}) {
+    const { default: defaultValue, migrate = true, validate } = options;
+    try {
+        if (migrate) {
+            const migration = await tryMigrate(fileCaminho);
+            if (migration.migrated && migration.to) {
+                fileCaminho = migration.to;
+            }
+        }
+        const content = await fs.readFile(fileCaminho, 'utf-8');
+        const parsed = JSON.parse(content);
+        if (validate && !validate(parsed)) {
+            throw new Error(messages.ExcecoesMensagens.validacaoFalhouPara(String(fileCaminho)));
+        }
+        return parsed;
+    }
+    catch (erro) {
+        const code = erro.code;
+        if (code === 'ENOENT' && defaultValue !== undefined) {
+            return defaultValue;
+        }
+        if (defaultValue !== undefined) {
+            return defaultValue;
+        }
+        if (code === 'ENOENT') {
+            throw new Error(messages.ExcecoesMensagens.arquivoNaoEncontrado(String(fileCaminho)));
+        }
+        throw new Error(messages.ExcecoesMensagens.erroAoLer(String(fileCaminho), erro.message));
+    }
+}
+export async function writeJSON(fileCaminho, data, options = {}) {
+    const { createDirs = true, backup = false, pretty = true } = options;
+    try {
+        if (createDirs) {
+            await ensureDir(fileCaminho);
+        }
+        if (backup) {
+            const backupCaminho = `${fileCaminho}.backup`;
+            await fs.copyFile(fileCaminho, backupCaminho).catch(() => {
+            });
+        }
+        const content = pretty ? JSON.stringify(data, null, 2) : JSON.stringify(data);
+        await fs.writeFile(fileCaminho, content, 'utf-8');
+    }
+    catch (erro) {
+        throw new Error(messages.ExcecoesMensagens.erroAoEscrever(String(fileCaminho), erro.message));
+    }
+}
+export async function deleteJSON(fileCaminho, options = {}) {
+    const { backup = true } = options;
+    try {
+        if (backup) {
+            const backupCaminho = `${fileCaminho}.deleted`;
+            await fs.rename(fileCaminho, backupCaminho);
+        }
+        else {
+            await fs.unlink(fileCaminho);
+        }
+    }
+    catch (erro) {
+        const code = erro.code;
+        if (code === 'ENOENT') {
+            return;
+        }
+        throw new Error(messages.ExcecoesMensagens.erroAoDeletar(String(fileCaminho), erro.message));
+    }
+}
+export async function listJSONFiles(dirPath) {
+    try {
+        const exists = await fileExists(dirPath);
+        if (!exists) {
+            return [];
+        }
+        const entries = await fs.readdir(dirPath, {
+            withFileTypes: true
+        });
+        const jsonArquivos = entries.filter(entry => entry.isFile() && entry.name.endsWith('.json')).map(entry => path.join(dirPath, entry.name));
+        return jsonArquivos;
+    }
+    catch (erro) {
+        log.aviso(`Erro ao listar arquivos em ${dirPath}: ${erro.message}`);
+        return [];
+    }
+}
+export const ArquivoRegistro = {
+    read: readJSON,
+    write: writeJSON,
+    delete: deleteJSON,
+    list: listJSONFiles,
+    paths: TUTANUS_ARQUIVOS,
+    dirs: TUTANUS_DIRS
+};
+//# sourceMappingURL=file-registry.js.map

package/dist/core/registry/file-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-registry.js","sourceRoot":"","sources":["../../../src/core/registry/file-registry.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI1C,OAAO,EAAE,aAAa,EAAC,gBAAgB,EAAE,YAAY,EAAwB,MAAM,YAAY,CAAC;AAEhG,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC;AA6BzB,KAAK,UAAU,UAAU,CAAC,WAAmB;IAC3C,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAKD,KAAK,UAAU,SAAS,CAAC,WAAmB;IAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACtC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;QAClB,SAAS,EAAE,IAAI;KAChB,CAAC,CAAC;AACL,CAAC;AAKD,KAAK,UAAU,UAAU,CAAC,UAAkB;IAC1C,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,MAAM,KAAK,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACtG,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO;YACL,QAAQ,EAAE,KAAK;SAChB,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QAEH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QAG1D,MAAM,SAAS,CAAC,UAAU,CAAC,CAAC;QAG5B,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAC;YACjD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAEtB,OAAO;oBACL,QAAQ,EAAE,IAAI;oBACd,IAAI,EAAE,aAAa;oBACnB,EAAE,EAAE,UAAU;iBACf,CAAC;YACJ,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;QAGD,MAAM,aAAa,GAAG,GAAG,aAAa,WAAW,CAAC;QAClD,MAAM,EAAE,CAAC,MAAM,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;QAEzD,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,IAAI,CAAC,wBAAwB,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAChG,OAAO;YACL,QAAQ,EAAE,IAAI;YACd,IAAI,EAAE,aAAa;YACnB,EAAE,EAAE,UAAU;SACf,CAAC;IACJ,CAAC;IAAC,OAAO,IAAI,EAAE,CAAC;QACd,MAAM,IAAI,GAAI,IAA8B,CAAC,IAAI,CAAC;QAClD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,OAAO;gBACL,QAAQ,EAAE,KAAK;aAChB,CAAC;QACJ,CAAC;QACD,GAAG,CAAC,KAAK,CAAC,wBAAwB,aAAa,KAAM,IAAc,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/E,OAAO;YACL,QAAQ,EAAE,KAAK;SAChB,CAAC;IACJ,CAAC;AACH,CAAC;AAgBD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAc,WAAqC,EAAE,UAA0B,EAAE;IAC7G,MAAM,EACJ,OAAO,EAAE,YAAY,EACrB,OAAO,GAAG,IAAI,EACd,QAAQ,EACT,GAAG,OAAO,CAAC;IACZ,IAAI,CAAC;QAEH,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,SAAS,GAAG,MAAM,UAAU,CAAC,WAAW,CAAC,CAAC;YAChD,IAAI,SAAS,CAAC,QAAQ,IAAI,SAAS,CAAC,EAAE,EAAE,CAAC;gBAEvC,WAAW,GAAG,SAAS,CAAC,EAAE,CAAC;YAC7B,CAAC;QACH,CAAC;QAGD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACxD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAM,CAAC;QAGxC,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC,mBAAmB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QACvF,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,IAAI,EAAE,CAAC;QACd,MAAM,IAAI,GAAI,IAA8B,CAAC,IAAI,CAAC;QAClD,IAAI,IAAI,KAAK,QAAQ,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YACpD,OAAO,YAAY,CAAC;QACtB,CAAC;QACD,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,YAAY,CAAC;QACtB,CAAC;QACD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC,oBAAoB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QACxF,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,EAAG,IAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IACtG,CAAC;AACH,CAAC;AAiBD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAc,WAAqC,EAAE,IAAO,EAAE,UAAwB,EAAE;IACrH,MAAM,EACJ,UAAU,GAAG,IAAI,EACjB,MAAM,GAAG,KAAK,EACd,MAAM,GAAG,IAAI,EACd,GAAG,OAAO,CAAC;IACZ,IAAI,CAAC;QAEH,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,SAAS,CAAC,WAAW,CAAC,CAAC;QAC/B,CAAC;QAGD,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,aAAa,GAAG,GAAG,WAAW,SAAS,CAAC;YAC9C,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;YAEzD,CAAC,CAAC,CAAC;QACL,CAAC;QAGD,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAG9E,MAAM,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,IAAI,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC,cAAc,CAAC,MAAM,CAAC,WAAW,CAAC,EAAG,IAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3G,CAAC;AACH,CAAC;AAQD,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,WAAqC,EAAE,UAEpE,EAAE;IACJ,MAAM,EACJ,MAAM,GAAG,IAAI,EACd,GAAG,OAAO,CAAC;IACZ,IAAI,CAAC;QACH,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,aAAa,GAAG,GAAG,WAAW,UAAU,CAAC;YAC/C,MAAM,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;QAC9C,CAAC;aAAM,CAAC;YACN,MAAM,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAAC,OAAO,IAAI,EAAE,CAAC;QACd,MAAM,IAAI,GAAI,IAA8B,CAAC,IAAI,CAAC;QAClD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,OAAO;QACT,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC,aAAa,CAAC,MAAM,CAAC,WAAW,CAAC,EAAG,IAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1G,CAAC;AACH,CAAC;AAQD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAe;IACjD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE;YACxC,aAAa,EAAE,IAAI;SACpB,CAAC,CAAC;QACH,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1I,OAAO,YAAY,CAAC;IACtB,CAAC;IAAC,OAAO,IAAI,EAAE,CAAC;QACd,GAAG,CAAC,KAAK,CAAC,8BAA8B,OAAO,KAAM,IAAc,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/E,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAKD,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,UAAU;IAClB,IAAI,EAAE,aAAa;IACnB,KAAK,EAAE,gBAAgB;IACvB,IAAI,EAAE,YAAY;CACV,CAAC","sourcesContent":["// SPDX-License-Identifier: MIT\n/**\n * @fileoverview Registry centralizado para operações de leitura/escrita de arquivos JSON\n *\n * Este módulo fornece uma camada de abstração sobre a persistência,\n * gerenciando migrações automáticas de arquivos legados e garantindo\n * que todos os arquivos sejam salvos nos locais corretos.\n *\n * Features:\n * - Migração automática de arquivos legados\n * - Validação de integridade de JSONs\n * - Logging de operações de I/O\n * - Fallback para configurações seguras\n */\nimport { promises as fs } from 'node:fs';\nimport path from 'node:path';\n\nimport { messages } from '@core/messages';\n\nimport type { MigrationResult } from '@';\n\nimport { MIGRACAO_MAPA,TUTANUS_ARQUIVOS, TUTANUS_DIRS, type TutanusFilePath } from './paths.js';\n\nconst log = messages.log;\n\n/**\n * Opções para operações de leitura\n */\ninterface ReadOptions<T> {\n  /** Valor padrão se arquivo não existir */\n  default?: T;\n  /** Tentar migrar de arquivo legado automaticamente */\n  migrate?: boolean;\n  /** Validar estrutura do JSON */\n  validate?: (data: unknown) => data is T;\n}\n\n/**\n * Opções para operações de escrita\n */\ninterface WriteOptions {\n  /** Criar diretórios pai se não existirem */\n  createDirs?: boolean;\n  /** Fazer backup antes de sobrescrever */\n  backup?: boolean;\n  /** Pretty print JSON */\n  pretty?: boolean;\n}\n\n/**\n * Verifica se arquivo existe\n */\nasync function fileExists(fileCaminho: string): Promise<boolean> {\n  try {\n    await fs.stat(fileCaminho);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Cria diretórios pai se não existirem\n */\nasync function ensureDir(fileCaminho: string): Promise<void> {\n  const dir = path.dirname(fileCaminho);\n  await fs.mkdir(dir, {\n    recursive: true\n  });\n}\n\n/**\n * Tenta migrar arquivo legado para novo local\n */\nasync function tryMigrate(targetPath: string): Promise<MigrationResult> {\n  const legacyCaminho = Object.entries(MIGRACAO_MAPA).find(([_, target]) => target === targetPath)?.[0];\n  if (!legacyCaminho) {\n    return {\n      migrated: false\n    };\n  }\n  try {\n    // Ler arquivo legado (falha se não existir, evitando TOCTOU)\n    const content = await fs.readFile(legacyCaminho, 'utf-8');\n\n    // Garantir diretório de destino\n    await ensureDir(targetPath);\n\n    // Escrever no novo local com flag 'wx' para evitar condição de corrida TOCTOU\n    try {\n      await fs.writeFile(targetPath, content, { encoding: 'utf-8', flag: 'wx' });\n    } catch (err) {\n      const code = (err as NodeJS.ErrnoException).code;\n      if (code === 'EEXIST') {\n        // Arquivo já foi migrado concorrentemente\n        return {\n          migrated: true,\n          from: legacyCaminho,\n          to: targetPath\n        };\n      }\n      throw err;\n    }\n\n    // Renomear arquivo legado (não deletar para segurança)\n    const backupCaminho = `${legacyCaminho}.migrated`;\n    await fs.rename(legacyCaminho, backupCaminho).catch(() => {\n      // Se falhar ao renomear, o arquivo legado permanece - não é fatal\n    });\n    log.info(`Migração automática: ${path.basename(legacyCaminho)} → ${path.basename(targetPath)}`);\n    return {\n      migrated: true,\n      from: legacyCaminho,\n      to: targetPath\n    };\n  } catch (erro) {\n    const code = (erro as NodeJS.ErrnoException).code;\n    if (code === 'ENOENT') {\n      return {\n        migrated: false\n      };\n    }\n    log.aviso(`Falha na migração de ${legacyCaminho}: ${(erro as Error).message}`);\n    return {\n      migrated: false\n    };\n  }\n}\n\n/**\n * Lê arquivo JSON do registry\n *\n * @param filePath Caminho do arquivo (use TUTANUS_FILES.*)\n * @param options Opções de leitura\n * @returns Conteúdo parseado do JSON\n *\n * @example\n * ```ts\n * const config = await readJSON(TUTANUS_FILES.CONFIG, {\n *   default: {}\n * });\n * ```\n */\nexport async function readJSON<T = unknown>(fileCaminho: TutanusFilePath | string, options: ReadOptions<T> = {}): Promise<T> {\n  const {\n    default: defaultValue,\n    migrate = true,\n    validate\n  } = options;\n  try {\n    // Tentar migração se habilitado\n    if (migrate) {\n      const migration = await tryMigrate(fileCaminho);\n      if (migration.migrated && migration.to) {\n        // Usar arquivo migrado\n        fileCaminho = migration.to;\n      }\n    }\n\n    // Ler e parsear diretamente (sem check de existência separado para evitar TOCTOU)\n    const content = await fs.readFile(fileCaminho, 'utf-8');\n    const parsed = JSON.parse(content) as T;\n\n    // Validar se fornecido\n    if (validate && !validate(parsed)) {\n      throw new Error(messages.ExcecoesMensagens.validacaoFalhouPara(String(fileCaminho)));\n    }\n    return parsed;\n  } catch (erro) {\n    const code = (erro as NodeJS.ErrnoException).code;\n    if (code === 'ENOENT' && defaultValue !== undefined) {\n      return defaultValue;\n    }\n    if (defaultValue !== undefined) {\n      return defaultValue;\n    }\n    if (code === 'ENOENT') {\n      throw new Error(messages.ExcecoesMensagens.arquivoNaoEncontrado(String(fileCaminho)));\n    }\n    throw new Error(messages.ExcecoesMensagens.erroAoLer(String(fileCaminho), (erro as Error).message));\n  }\n}\n\n/**\n * Escreve arquivo JSON no registry\n *\n * @param filePath Caminho do arquivo (use TUTANUS_FILES.*)\n * @param data Dados a serem salvos\n * @param options Opções de escrita\n *\n * @example\n * ```ts\n * await writeJSON(TUTANUS_FILES.GUARDIAN_BASELINE, snapshot, {\n *   createDirs: true,\n *   backup: true\n * });\n * ```\n */\nexport async function writeJSON<T = unknown>(fileCaminho: TutanusFilePath | string, data: T, options: WriteOptions = {}): Promise<void> {\n  const {\n    createDirs = true,\n    backup = false,\n    pretty = true\n  } = options;\n  try {\n    // Criar diretórios se necessário\n    if (createDirs) {\n      await ensureDir(fileCaminho);\n    }\n\n    // Fazer backup se solicitado (copyFile falha com ENOENT se o arquivo não existir, o que é ok)\n    if (backup) {\n      const backupCaminho = `${fileCaminho}.backup`;\n      await fs.copyFile(fileCaminho, backupCaminho).catch(() => {\n        // Se o arquivo não existir, não há backup a fazer\n      });\n    }\n\n    // Serializar JSON\n    const content = pretty ? JSON.stringify(data, null, 2) : JSON.stringify(data);\n\n    // Escrever arquivo\n    await fs.writeFile(fileCaminho, content, 'utf-8');\n  } catch (erro) {\n    throw new Error(messages.ExcecoesMensagens.erroAoEscrever(String(fileCaminho), (erro as Error).message));\n  }\n}\n\n/**\n * Deleta arquivo do registry\n *\n * @param filePath Caminho do arquivo (use TUTANUS_FILES.*)\n * @param options Opções de deleção\n */\nexport async function deleteJSON(fileCaminho: TutanusFilePath | string, options: {\n  backup?: boolean;\n} = {}): Promise<void> {\n  const {\n    backup = true\n  } = options;\n  try {\n    if (backup) {\n      const backupCaminho = `${fileCaminho}.deleted`;\n      await fs.rename(fileCaminho, backupCaminho);\n    } else {\n      await fs.unlink(fileCaminho);\n    }\n  } catch (erro) {\n    const code = (erro as NodeJS.ErrnoException).code;\n    if (code === 'ENOENT') {\n      return; // Já deletado\n    }\n    throw new Error(messages.ExcecoesMensagens.erroAoDeletar(String(fileCaminho), (erro as Error).message));\n  }\n}\n\n/**\n * Lista todos os arquivos JSON em um diretório do registry\n *\n * @param dirPath Caminho do diretório (use TUTANUS_DIRS.*)\n * @returns Lista de caminhos completos\n */\nexport async function listJSONFiles(dirPath: string): Promise<string[]> {\n  try {\n    const exists = await fileExists(dirPath);\n    if (!exists) {\n      return [];\n    }\n    const entries = await fs.readdir(dirPath, {\n      withFileTypes: true\n    });\n    const jsonArquivos = entries.filter(entry => entry.isFile() && entry.name.endsWith('.json')).map(entry => path.join(dirPath, entry.name));\n    return jsonArquivos;\n  } catch (erro) {\n    log.aviso(`Erro ao listar arquivos em ${dirPath}: ${(erro as Error).message}`);\n    return [];\n  }\n}\n\n/**\n * Exporta funções auxiliares para compatibilidade com código existente\n */\nexport const ArquivoRegistro = {\n  read: readJSON,\n  write: writeJSON,\n  delete: deleteJSON,\n  list: listJSONFiles,\n  paths: TUTANUS_ARQUIVOS,\n  dirs: TUTANUS_DIRS\n} as const;"]}

package/dist/core/registry/index.d.ts

@@ -0,0 +1,3 @@
+export * from './file-registry.js';
+export * from './paths.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/registry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/registry/index.ts"],"names":[],"mappings":"AAKA,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC"}

package/dist/core/registry/index.js

@@ -0,0 +1,3 @@
+export * from './file-registry.js';
+export * from './paths.js';
+//# sourceMappingURL=index.js.map

package/dist/core/registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/registry/index.ts"],"names":[],"mappings":"AAKA,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC","sourcesContent":["// SPDX-License-Identifier: MIT\n/**\n * @fileoverview Core registry: file registry and paths\n */\n\nexport * from './file-registry.js';\nexport * from './paths.js';\n"]}

package/dist/core/registry/paths.d.ts

@@ -0,0 +1,38 @@
+export declare const PROJETO_RAIZ: string;
+export declare const TUTANUS_DIRS: {
+    readonly STATE: string;
+    readonly METRICS_HISTORY: string;
+    readonly REPORTS: string;
+    readonly PERF: string;
+};
+export declare const TUTANUS_ARQUIVOS: {
+    readonly CONFIG: string;
+    readonly CONFIG_SAFE: string;
+    readonly GUARDIAN_BASELINE: string;
+    readonly ESTRUTURA_BASELINE: string;
+    readonly ESTRUTURA_ARQUETIPO: string;
+    readonly MAPA_REVERSAO: string;
+    readonly REGISTRO_VIGIA: string;
+    readonly GUARDIAN_CHAVE_PUBLICA: string;
+    readonly GUARDIAN_CHAVE_PRIVADA: string;
+    readonly METRICAS_HISTORICO: string;
+    readonly GUARDIAN_BASELINE_LEGACY: string;
+    readonly ESTRUTURA_BASELINE_LEGACY: string;
+    readonly ESTRUTURA_ARQUETIPO_LEGACY_ROOT: string;
+};
+export declare const REPORT_PADROES: {
+    readonly DIAGNOSTICO: (timestamp: string) => string;
+    readonly SUMMARY_JSON: (timestamp: string) => string;
+    readonly ASYNC_ANALYSIS: string;
+    readonly PERF_BASELINE: (timestamp: string) => string;
+    readonly PERF_DIFF: string;
+};
+export declare const MIGRACAO_MAPA: {
+    readonly [TUTANUS_ARQUIVOS.GUARDIAN_BASELINE_LEGACY]: string;
+    readonly [TUTANUS_ARQUIVOS.ESTRUTURA_BASELINE_LEGACY]: string;
+    readonly [TUTANUS_ARQUIVOS.ESTRUTURA_ARQUETIPO_LEGACY_ROOT]: string;
+};
+export declare function resolveFilePath(newPath: string): string;
+export type TutanusFilePath = (typeof TUTANUS_ARQUIVOS)[keyof typeof TUTANUS_ARQUIVOS];
+export type TutanusDirPath = (typeof TUTANUS_DIRS)[keyof typeof TUTANUS_DIRS];
+//# sourceMappingURL=paths.d.ts.map

package/dist/core/registry/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/core/registry/paths.ts"],"names":[],"mappings":"AAmBA,eAAO,MAAM,YAAY,QAAgB,CAAC;AAK1C,eAAO,MAAM,YAAY;;;;;CASf,CAAC;AASX,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;CA8BnB,CAAC;AAKX,eAAO,MAAM,cAAc;sCAEA,MAAM;uCAEL,MAAM;;wCAIL,MAAM;;CAGzB,CAAC;AAKX,eAAO,MAAM,aAAa;IAExB,SAAA,CAAC,gBAAgB,CAAC,wBAAwB,CAAC,SAAoC;IAE/E,SAAA,CAAC,gBAAgB,CAAC,yBAAyB,CAAC,SAAqC;IAEjF,SAAA,CAAC,gBAAgB,CAAC,+BAA+B,CAAC,SAAsC;CAChF,CAAC;AAOX,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIvD;AAKD,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AACvF,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC"}

package/dist/core/registry/paths.js

@@ -0,0 +1,40 @@
+import path from 'node:path';
+export const PROJETO_RAIZ = process.cwd();
+export const TUTANUS_DIRS = {
+    STATE: path.join(PROJETO_RAIZ, '.tutanus'),
+    METRICS_HISTORY: path.join(PROJETO_RAIZ, '.tutanus', 'historico-metricas'),
+    REPORTS: path.join(PROJETO_RAIZ, 'reports'),
+    PERF: path.join(PROJETO_RAIZ, 'docs', 'perf')
+};
+export const TUTANUS_ARQUIVOS = {
+    CONFIG: path.join(PROJETO_RAIZ, 'tutanus.config.json'),
+    CONFIG_SAFE: path.join(PROJETO_RAIZ, 'tutanus.config.safe.json'),
+    GUARDIAN_BASELINE: path.join(TUTANUS_DIRS.STATE, 'guardian.baseline.json'),
+    ESTRUTURA_BASELINE: path.join(TUTANUS_DIRS.STATE, 'estrutura.baseline.json'),
+    ESTRUTURA_ARQUETIPO: path.join(TUTANUS_DIRS.STATE, 'estrutura.arquetipo.json'),
+    MAPA_REVERSAO: path.join(TUTANUS_DIRS.STATE, 'mapa-reversao.json'),
+    REGISTRO_VIGIA: path.join(TUTANUS_DIRS.STATE, 'integridade.json'),
+    GUARDIAN_CHAVE_PUBLICA: path.join(TUTANUS_DIRS.STATE, 'guardian.chave-publica.asc'),
+    GUARDIAN_CHAVE_PRIVADA: path.join(TUTANUS_DIRS.STATE, 'guardian.chave-privada.asc'),
+    METRICAS_HISTORICO: path.join(TUTANUS_DIRS.METRICS_HISTORY, 'metricas-historico.json'),
+    GUARDIAN_BASELINE_LEGACY: path.join(TUTANUS_DIRS.STATE, 'baseline.json'),
+    ESTRUTURA_BASELINE_LEGACY: path.join(TUTANUS_DIRS.STATE, 'baseline-estrutura.json'),
+    ESTRUTURA_ARQUETIPO_LEGACY_ROOT: path.join(PROJETO_RAIZ, 'tutanus.repo.arquetipo.json')
+};
+export const REPORT_PADROES = {
+    DIAGNOSTICO: (timestamp) => path.join(TUTANUS_DIRS.REPORTS, `tutanus-diagnostico-${timestamp}.md`),
+    SUMMARY_JSON: (timestamp) => path.join(TUTANUS_DIRS.REPORTS, `tutanus-relatorio-summary-${timestamp}.json`),
+    ASYNC_ANALYSIS: path.join(TUTANUS_DIRS.REPORTS, 'async-analysis-report.json'),
+    PERF_BASELINE: (timestamp) => path.join(TUTANUS_DIRS.PERF, `baseline-${timestamp}.json`),
+    PERF_DIFF: path.join(TUTANUS_DIRS.PERF, 'ultimo-diff.json')
+};
+export const MIGRACAO_MAPA = {
+    [TUTANUS_ARQUIVOS.GUARDIAN_BASELINE_LEGACY]: TUTANUS_ARQUIVOS.GUARDIAN_BASELINE,
+    [TUTANUS_ARQUIVOS.ESTRUTURA_BASELINE_LEGACY]: TUTANUS_ARQUIVOS.ESTRUTURA_BASELINE,
+    [TUTANUS_ARQUIVOS.ESTRUTURA_ARQUETIPO_LEGACY_ROOT]: TUTANUS_ARQUIVOS.ESTRUTURA_ARQUETIPO
+};
+export function resolveFilePath(newPath) {
+    const legacyCaminho = Object.entries(MIGRACAO_MAPA).find(([_, target]) => target === newPath)?.[0];
+    return legacyCaminho || newPath;
+}
+//# sourceMappingURL=paths.js.map

package/dist/core/registry/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/core/registry/paths.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: MIT\n/**\n * @fileoverview Gerenciamento centralizado de caminhos para arquivos do Tutanus\n *\n * Este módulo define todos os caminhos de arquivos usados pelo sistema,\n * evitando hardcoding espalhado e permitindo evolução consistente.\n *\n * Convenção de nomes:\n * - guardian.baseline.json: Baseline de assinaturas GPG do Guardian\n * - guardian.chave-publica.asc: Chave pública GPG do Guardian\n * - guardian.chave-privada.asc: Chave privada GPG do Guardian\n * - estrutura.baseline.json: Baseline da estrutura de diretórios\n * - estrutura.arquetipo.json: Arquétipo personalizado do repositório\n * - tutanus.config.json: Configuração do usuário (raiz do projeto)\n */\n\nimport path from 'node:path';\n\n// Diretório base do projeto (raiz) - usa CWD quando executado pelo CLI\nexport const PROJETO_RAIZ = process.cwd();\n\n/**\n * Diretórios principais do Tutanus\n */\nexport const TUTANUS_DIRS = {\n  /** Diretório de estado interno (.tutanus/) */\n  STATE: path.join(PROJETO_RAIZ, '.tutanus'),\n  /** Diretório de histórico de métricas (.tutanus/historico-metricas/) */\n  METRICS_HISTORY: path.join(PROJETO_RAIZ, '.tutanus', 'historico-metricas'),\n  /** Diretório de relatórios (reports/) */\n  REPORTS: path.join(PROJETO_RAIZ, 'reports'),\n  /** Diretório de performance baselines (docs/perf/) */\n  PERF: path.join(PROJETO_RAIZ, 'docs', 'perf')\n} as const;\n\n/**\n * Arquivos JSON do sistema\n *\n * Categoria 1: Configuração (leitura usuário)\n * Categoria 2: Estado interno (leitura/escrita sistema)\n * Categoria 3: Relatórios (escrita sistema)\n */\nexport const TUTANUS_ARQUIVOS = {\n// ─── CONFIGURAÇÃO (raiz do projeto) ───────────────────────────\n  /** Configuração principal do usuário (tutanus.config.json) */\n  CONFIG: path.join(PROJETO_RAIZ, 'tutanus.config.json'),\n  /** Configuração segura/alternativa (tutanus.config.safe.json) */\n  CONFIG_SAFE: path.join(PROJETO_RAIZ, 'tutanus.config.safe.json'),\n// ─── ESTADO INTERNO (.tutanus/) ────────────────────────────\n  /** Baseline de assinaturas GPG do Guardian (.tutanus/guardian.baseline.json) */\n  GUARDIAN_BASELINE: path.join(TUTANUS_DIRS.STATE, 'guardian.baseline.json'),\n  /** Baseline de estrutura de diretórios (.tutanus/estrutura.baseline.json) */\n  ESTRUTURA_BASELINE: path.join(TUTANUS_DIRS.STATE, 'estrutura.baseline.json'),\n  /** Arquétipo personalizado do repo (.tutanus/estrutura.arquetipo.json) */\n  ESTRUTURA_ARQUETIPO: path.join(TUTANUS_DIRS.STATE, 'estrutura.arquetipo.json'),\n  /** Mapa de reversão de estrutura (.tutanus/mapa-reversao.json) */\n  MAPA_REVERSAO: path.join(TUTANUS_DIRS.STATE, 'mapa-reversao.json'),\n  /** Registros da Vigia Oculta (.tutanus/integridade.json) */\n  REGISTRO_VIGIA: path.join(TUTANUS_DIRS.STATE, 'integridade.json'),\n  /** Chave pública GPG do Guardian (.tutanus/guardian.chave-publica.asc) */\n  GUARDIAN_CHAVE_PUBLICA: path.join(TUTANUS_DIRS.STATE, 'guardian.chave-publica.asc'),\n  /** Chave privada GPG do Guardian (.tutanus/guardian.chave-privada.asc) */\n  GUARDIAN_CHAVE_PRIVADA: path.join(TUTANUS_DIRS.STATE, 'guardian.chave-privada.asc'),\n  /** Histórico de métricas (.tutanus/historico-metricas/metricas-historico.json) */\n  METRICAS_HISTORICO: path.join(TUTANUS_DIRS.METRICS_HISTORY, 'metricas-historico.json'),\n// ─── ARQUIVOS LEGADOS (compatibilidade) ───────────────────────\n  /** @deprecated Use GUARDIAN_BASELINE - baseline.json antigo */\n  GUARDIAN_BASELINE_LEGACY: path.join(TUTANUS_DIRS.STATE, 'baseline.json'),\n  /** @deprecated Use ESTRUTURA_BASELINE - baseline-estrutura.json antigo */\n  ESTRUTURA_BASELINE_LEGACY: path.join(TUTANUS_DIRS.STATE, 'baseline-estrutura.json'),\n  /** @deprecated Movido para .tutanus/ - tutanus.repo.arquetipo.json na raiz */\n  ESTRUTURA_ARQUETIPO_LEGACY_ROOT: path.join(PROJETO_RAIZ, 'tutanus.repo.arquetipo.json')\n} as const;\n\n/**\n * Padrões de nomenclatura para relatórios dinâmicos\n */\nexport const REPORT_PADROES = {\n  /** Relatório de diagnóstico (tutanus-diagnostico-{timestamp}.md) */\n  DIAGNOSTICO: (timestamp: string) => path.join(TUTANUS_DIRS.REPORTS, `tutanus-diagnostico-${timestamp}.md`),\n  /** Relatório JSON resumo (tutanus-relatorio-summary-{timestamp}.json) */\n  SUMMARY_JSON: (timestamp: string) => path.join(TUTANUS_DIRS.REPORTS, `tutanus-relatorio-summary-${timestamp}.json`),\n  /** Relatório de análise async (async-analysis-report.json) */\n  ASYNC_ANALYSIS: path.join(TUTANUS_DIRS.REPORTS, 'async-analysis-report.json'),\n  /** Baseline de performance (docs/perf/baseline-{timestamp}.json) */\n  PERF_BASELINE: (timestamp: string) => path.join(TUTANUS_DIRS.PERF, `baseline-${timestamp}.json`),\n  /** Diff de performance (docs/perf/ultimo-diff.json) */\n  PERF_DIFF: path.join(TUTANUS_DIRS.PERF, 'ultimo-diff.json')\n} as const;\n\n/**\n * Mapeia nomes legados para novos caminhos (migração automática)\n */\nexport const MIGRACAO_MAPA = {\n  // Guardian: baseline.json → guardian.baseline.json\n  [TUTANUS_ARQUIVOS.GUARDIAN_BASELINE_LEGACY]: TUTANUS_ARQUIVOS.GUARDIAN_BASELINE,\n  // Estrutura: baseline-estrutura.json → estrutura.baseline.json\n  [TUTANUS_ARQUIVOS.ESTRUTURA_BASELINE_LEGACY]: TUTANUS_ARQUIVOS.ESTRUTURA_BASELINE,\n  // Arquétipo: tutanus.repo.arquetipo.json (raiz) → .tutanus/estrutura.arquetipo.json\n  [TUTANUS_ARQUIVOS.ESTRUTURA_ARQUETIPO_LEGACY_ROOT]: TUTANUS_ARQUIVOS.ESTRUTURA_ARQUETIPO\n} as const;\n\n/**\n * Retorna o caminho legado (se existir) ou o novo\n * @param newPath Caminho novo desejado\n * @returns Caminho do arquivo (prioriza legado se existir)\n */\nexport function resolveFilePath(newPath: string): string {\n  // Verifica se há entrada no mapa de migração reverso\n  const legacyCaminho = Object.entries(MIGRACAO_MAPA).find(([_, target]) => target === newPath)?.[0];\n  return legacyCaminho || newPath;\n}\n\n/**\n * Tipo para caminhos de arquivos do Tutanus\n */\nexport type TutanusFilePath = (typeof TUTANUS_ARQUIVOS)[keyof typeof TUTANUS_ARQUIVOS];\nexport type TutanusDirPath = (typeof TUTANUS_DIRS)[keyof typeof TUTANUS_DIRS];\n"]}

package/dist/core/reporting/default-reporter.d.ts

@@ -0,0 +1,3 @@
+import type { Ocorrencia, ReportEvent } from '../../types/index.js';
+export declare function createDefaultReporter(): (event: ReportEvent) => Ocorrencia;
+//# sourceMappingURL=default-reporter.d.ts.map

package/dist/core/reporting/default-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-reporter.d.ts","sourceRoot":"","sources":["../../../src/core/reporting/default-reporter.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,CAAC;AAGjD,wBAAgB,qBAAqB,KAC3B,OAAO,WAAW,KAAG,UAAU,CAmHxC"}

package/dist/core/reporting/default-reporter.js

@@ -0,0 +1,96 @@
+import { messages } from '../messages/index.js';
+import { criarOcorrencia } from '../../types/index.js';
+export function createDefaultReporter() {
+    return (event) => {
+        const { code, tipo, nivel = 'info', mensagem, data, relPath, linha = 1, coluna, origem, } = event;
+        if (mensagem && typeof mensagem === 'string') {
+            return criarOcorrencia({
+                tipo,
+                nivel,
+                mensagem,
+                relPath,
+                linha,
+                coluna,
+                origem,
+            });
+        }
+        if (code === 'ARQ_PADRAO') {
+            const padrao = String(data?.padraoIdentificado ?? '');
+            const confianca = Number(data?.confianca ?? 0);
+            return criarOcorrencia({
+                tipo,
+                nivel,
+                mensagem: messages.DetectorArquiteturaMensagens.padraoArquitetural(padrao, confianca),
+                relPath,
+                linha,
+                coluna,
+                origem,
+            });
+        }
+        if (code === 'ARQ_CARACTERISTICAS') {
+            const items = Array.isArray(data?.caracteristicas)
+                ? data?.caracteristicas
+                : [];
+            return criarOcorrencia({
+                tipo,
+                nivel,
+                mensagem: messages.DetectorArquiteturaMensagens.caracteristicas(items),
+                relPath,
+                linha,
+                coluna,
+                origem,
+            });
+        }
+        if (code === 'ARQ_VIOLACAO') {
+            const violacao = String(data?.violacao ?? '');
+            return criarOcorrencia({
+                tipo,
+                nivel,
+                mensagem: messages.DetectorArquiteturaMensagens.violacao(violacao),
+                relPath,
+                linha,
+                coluna,
+                origem,
+            });
+        }
+        if (code === 'ARQ_METRICAS') {
+            const acoplamento = Number(data?.acoplamento ?? 0);
+            const coesao = Number(data?.coesao ?? 0);
+            return criarOcorrencia({
+                tipo,
+                nivel,
+                mensagem: messages.DetectorArquiteturaMensagens.metricas(acoplamento, coesao),
+                relPath,
+                linha,
+                coluna,
+                origem,
+            });
+        }
+        if (code === 'ARQ_ERRO') {
+            return criarOcorrencia({
+                tipo,
+                nivel,
+                mensagem: messages.DetectorArquiteturaMensagens.erroAnalisarArquitetura(data?.erro),
+                relPath,
+                linha,
+                coluna,
+                origem,
+            });
+        }
+        const fallbackMsg = code
+            ? `${code}${data ? ` ${JSON.stringify(data)}` : ''}`
+            : data
+                ? JSON.stringify(data)
+                : 'Ocorrência reportada';
+        return criarOcorrencia({
+            tipo,
+            nivel,
+            mensagem: fallbackMsg,
+            relPath,
+            linha,
+            coluna,
+            origem,
+        });
+    };
+}
+//# sourceMappingURL=default-reporter.js.map

package/dist/core/reporting/default-reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-reporter.js","sourceRoot":"","sources":["../../../src/core/reporting/default-reporter.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: MIT\n\n/**\n * @fileoverview Reporter padrão que converte eventos de relatório em ocorrências.\n * Mapeia códigos de evento (como ARQ_PADRAO, ARQ_VIOLACAO, etc.) para mensagens\n * formatadas usando os templates de mensagens dos detectores correspondentes.\n */\n\nimport { messages } from '@core/messages';\n\nimport type { Ocorrencia, ReportEvent } from '@';\nimport { criarOcorrencia } from '@';\n\nexport function createDefaultReporter() {\n  return (event: ReportEvent): Ocorrencia => {\n    const {\n      code,\n      tipo,\n      nivel = 'info',\n      mensagem,\n      data,\n      relPath,\n      linha = 1,\n      coluna,\n      origem,\n    } = event;\n\n    // Se a mensagem já veio formatada, apenas encaminha\n    if (mensagem && typeof mensagem === 'string') {\n      return criarOcorrencia({\n        tipo,\n        nivel,\n        mensagem,\n        relPath,\n        linha,\n        coluna,\n        origem,\n      });\n    }\n\n    // Mapeamentos mínimos (incrementais) por code\n    if (code === 'ARQ_PADRAO') {\n      const padrao = String((data?.padraoIdentificado as unknown) ?? '');\n      const confianca = Number((data?.confianca as unknown) ?? 0);\n      return criarOcorrencia({\n        tipo,\n        nivel,\n        mensagem: messages.DetectorArquiteturaMensagens.padraoArquitetural(\n          padrao,\n          confianca,\n        ),\n        relPath,\n        linha,\n        coluna,\n        origem,\n      });\n    }\n\n    if (code === 'ARQ_CARACTERISTICAS') {\n      const items = Array.isArray(data?.caracteristicas)\n        ? (data?.caracteristicas as unknown as string[])\n        : [];\n      return criarOcorrencia({\n        tipo,\n        nivel,\n        mensagem: messages.DetectorArquiteturaMensagens.caracteristicas(items),\n        relPath,\n        linha,\n        coluna,\n        origem,\n      });\n    }\n\n    if (code === 'ARQ_VIOLACAO') {\n      const violacao = String((data?.violacao as unknown) ?? '');\n      return criarOcorrencia({\n        tipo,\n        nivel,\n        mensagem: messages.DetectorArquiteturaMensagens.violacao(violacao),\n        relPath,\n        linha,\n        coluna,\n        origem,\n      });\n    }\n\n    if (code === 'ARQ_METRICAS') {\n      const acoplamento = Number((data?.acoplamento as unknown) ?? 0);\n      const coesao = Number((data?.coesao as unknown) ?? 0);\n      return criarOcorrencia({\n        tipo,\n        nivel,\n        mensagem: messages.DetectorArquiteturaMensagens.metricas(acoplamento, coesao),\n        relPath,\n        linha,\n        coluna,\n        origem,\n      });\n    }\n\n    if (code === 'ARQ_ERRO') {\n      return criarOcorrencia({\n        tipo,\n        nivel,\n        mensagem: messages.DetectorArquiteturaMensagens.erroAnalisarArquitetura(data?.erro),\n        relPath,\n        linha,\n        coluna,\n        origem,\n      });\n    }\n\n    // Fallback: mantém sinal útil mesmo sem template\n    const fallbackMsg = code\n      ? `${code}${data ? ` ${JSON.stringify(data)}` : ''}`\n      : data\n        ? JSON.stringify(data)\n        : 'Ocorrência reportada';\n\n    return criarOcorrencia({\n      tipo,\n      nivel,\n      mensagem: fallbackMsg,\n      relPath,\n      linha,\n      coluna,\n      origem,\n    });\n  };\n}\n\n"]}

package/dist/core/reporting/index.d.ts

@@ -0,0 +1,2 @@
+export * from './default-reporter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/reporting/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/reporting/index.ts"],"names":[],"mappings":"AAKA,cAAc,uBAAuB,CAAC"}

package/dist/core/reporting/index.js

@@ -0,0 +1,2 @@
+export * from './default-reporter.js';
+//# sourceMappingURL=index.js.map

package/dist/core/reporting/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/reporting/index.ts"],"names":[],"mappings":"AAKA,cAAc,uBAAuB,CAAC","sourcesContent":["// SPDX-License-Identifier: MIT\n/**\n * @fileoverview Core reporting: default reporter\n */\n\nexport * from './default-reporter.js';\n"]}

package/dist/core/runtime/index.d.ts

@@ -0,0 +1,5 @@
+import type { RuntimeAdapter } from '../../types/index.js';
+export declare function obterRuntime(): RuntimeAdapter;
+export declare function definirRuntime(adapter: RuntimeAdapter): void;
+export { criarAdapterNode } from './node-adapter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/runtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/runtime/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,GAAG,CAAC;AAMxC,wBAAgB,YAAY,IAAI,cAAc,CAE7C;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAE5D;AAED,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/core/runtime/index.js

@@ -0,0 +1,10 @@
+import { criarAdapterNode } from './node-adapter.js';
+let adapterAtual = criarAdapterNode();
+export function obterRuntime() {
+    return adapterAtual;
+}
+export function definirRuntime(adapter) {
+    adapterAtual = adapter;
+}
+export { criarAdapterNode } from './node-adapter.js';
+//# sourceMappingURL=index.js.map

package/dist/core/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/runtime/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,IAAI,YAAY,GAAmB,gBAAgB,EAAE,CAAC;AAEtD,MAAM,UAAU,YAAY;IAC1B,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAuB;IACpD,YAAY,GAAG,OAAO,CAAC;AACzB,CAAC;AAED,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC","sourcesContent":["// SPDX-License-Identifier: MIT\n/**\n * @fileoverview Gerenciamento de runtime (Node, Deno, Bun)\n */\n\nimport type { RuntimeAdapter } from '@';\n\nimport { criarAdapterNode } from './node-adapter.js';\n\nlet adapterAtual: RuntimeAdapter = criarAdapterNode();\n\nexport function obterRuntime(): RuntimeAdapter {\n  return adapterAtual;\n}\n\nexport function definirRuntime(adapter: RuntimeAdapter): void {\n  adapterAtual = adapter;\n}\n\nexport { criarAdapterNode } from './node-adapter.js';\n"]}

package/dist/core/runtime/node-adapter.d.ts

@@ -0,0 +1,3 @@
+import type { RuntimeAdapter } from '../../types/index.js';
+export declare function criarAdapterNode(): RuntimeAdapter;
+//# sourceMappingURL=node-adapter.d.ts.map

package/dist/core/runtime/node-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-adapter.d.ts","sourceRoot":"","sources":["../../../src/core/runtime/node-adapter.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAA+D,MAAM,GAAG,CAAC;AA0DrG,wBAAgB,gBAAgB,IAAI,cAAc,CASjD"}

package/dist/core/runtime/node-adapter.js

@@ -0,0 +1,66 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import process from 'node:process';
+function detectarRuntime() {
+    const globalAny = globalThis;
+    const proc = globalAny.process;
+    if (typeof proc !== 'undefined' && proc?.versions?.node) {
+        return { tipo: 'node', versao: proc.versions.node };
+    }
+    if (typeof globalAny.Deno !== 'undefined') {
+        return { tipo: 'deno', versao: 'desconhecida' };
+    }
+    if (typeof globalAny.Bun !== 'undefined') {
+        return { tipo: 'bun', versao: 'desconhecida' };
+    }
+    return { tipo: 'node', versao: process.version };
+}
+function criarFileSystem() {
+    return {
+        readFile: (caminho, encoding) => fs.promises.readFile(caminho, encoding),
+        readFileSync: (caminho, encoding) => fs.readFileSync(caminho, encoding),
+        writeFile: (caminho, conteudo) => fs.promises.writeFile(caminho, conteudo, 'utf-8'),
+        writeFileSync: (caminho, conteudo) => fs.writeFileSync(caminho, conteudo, 'utf-8'),
+        readdir: caminho => fs.promises.readdir(caminho),
+        readdirSync: caminho => fs.readdirSync(caminho),
+        mkdir: (caminho, opcoes) => fs.promises.mkdir(caminho, { recursive: opcoes?.recursive }).then(() => undefined),
+        mkdirSync: (caminho, opcoes) => fs.mkdirSync(caminho, { recursive: opcoes?.recursive }),
+        statSync: caminho => fs.statSync(caminho),
+        existsSync: caminho => fs.existsSync(caminho),
+        access: (caminho, mode) => fs.promises.access(caminho, mode),
+    };
+}
+function criarPath() {
+    return {
+        join: path.join,
+        resolve: path.resolve,
+        basename: path.basename,
+        dirname: path.dirname,
+        extname: path.extname,
+        relative: path.relative,
+        sep: path.sep,
+    };
+}
+function criarProcess() {
+    return {
+        cwd: () => process.cwd(),
+        chdir: dir => process.chdir(dir),
+        env: process.env,
+        exit: (code) => process.exit(code),
+        argv: process.argv,
+        on: (evento, listener) => process.on(evento, listener),
+        memoryUsage: () => process.memoryUsage(),
+        uptime: () => process.uptime(),
+    };
+}
+export function criarAdapterNode() {
+    const runtime = detectarRuntime();
+    return {
+        tipo: runtime.tipo,
+        info: runtime,
+        fs: criarFileSystem(),
+        path: criarPath(),
+        process: criarProcess(),
+    };
+}
+//# sourceMappingURL=node-adapter.js.map

package/dist/core/runtime/node-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-adapter.js","sourceRoot":"","sources":["../../../src/core/runtime/node-adapter.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: MIT\n/**\n * @fileoverview Adaptador de runtime para Node.js\n */\n\nimport fs from 'node:fs';\nimport path from 'node:path';\nimport process from 'node:process';\n\nimport type { RuntimeAdapter, RuntimeFileSystem, RuntimePath, RuntimeProcess, RuntimeTipo } from '@';\n\nfunction detectarRuntime(): { tipo: RuntimeTipo; versao: string } {\n  const globalAny = globalThis as Record<string, unknown>;\n  const proc = globalAny.process as { versions?: { node?: string } } | undefined;\n  if (typeof proc !== 'undefined' && proc?.versions?.node) {\n    return { tipo: 'node', versao: proc.versions.node };\n  }\n  if (typeof globalAny.Deno !== 'undefined') {\n    return { tipo: 'deno', versao: 'desconhecida' };\n  }\n  if (typeof globalAny.Bun !== 'undefined') {\n    return { tipo: 'bun', versao: 'desconhecida' };\n  }\n  return { tipo: 'node', versao: process.version };\n}\n\nfunction criarFileSystem(): RuntimeFileSystem {\n  return {\n    readFile: (caminho, encoding) => fs.promises.readFile(caminho, encoding as BufferEncoding) as Promise<string>,\n    readFileSync: (caminho, encoding) => fs.readFileSync(caminho, encoding as BufferEncoding),\n    writeFile: (caminho, conteudo) => fs.promises.writeFile(caminho, conteudo, 'utf-8'),\n    writeFileSync: (caminho, conteudo) => fs.writeFileSync(caminho, conteudo, 'utf-8'),\n    readdir: caminho => fs.promises.readdir(caminho),\n    readdirSync: caminho => fs.readdirSync(caminho),\n    mkdir: (caminho, opcoes) => fs.promises.mkdir(caminho, { recursive: opcoes?.recursive }).then(() => undefined),\n    mkdirSync: (caminho, opcoes) => fs.mkdirSync(caminho, { recursive: opcoes?.recursive }),\n    statSync: caminho => fs.statSync(caminho),\n    existsSync: caminho => fs.existsSync(caminho),\n    access: (caminho, mode) => fs.promises.access(caminho, mode),\n  };\n}\n\nfunction criarPath(): RuntimePath {\n  return {\n    join: path.join,\n    resolve: path.resolve,\n    basename: path.basename,\n    dirname: path.dirname,\n    extname: path.extname,\n    relative: path.relative,\n    sep: path.sep,\n  };\n}\n\nfunction criarProcess(): RuntimeProcess {\n  return {\n    cwd: () => process.cwd(),\n    chdir: dir => process.chdir(dir),\n    env: process.env as Record<string, string | undefined>,\n    exit: (code?: number) => process.exit(code),\n    argv: process.argv,\n    on: (evento, listener) => process.on(evento, listener as (...args: unknown[]) => void),\n    memoryUsage: () => process.memoryUsage(),\n    uptime: () => process.uptime(),\n  };\n}\n\nexport function criarAdapterNode(): RuntimeAdapter {\n  const runtime = detectarRuntime();\n  return {\n    tipo: runtime.tipo,\n    info: runtime,\n    fs: criarFileSystem(),\n    path: criarPath(),\n    process: criarProcess(),\n  };\n}\n"]}

package/dist/core/schema/index.d.ts

@@ -0,0 +1,2 @@
+export * from './version.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/schema/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/schema/index.ts"],"names":[],"mappings":"AAKA,cAAc,cAAc,CAAC"}

package/dist/core/schema/index.js

@@ -0,0 +1,2 @@
+export * from './version.js';
+//# sourceMappingURL=index.js.map

package/dist/core/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/schema/index.ts"],"names":[],"mappings":"AAKA,cAAc,cAAc,CAAC","sourcesContent":["// SPDX-License-Identifier: MIT\n/**\n * @fileoverview Core schema versioning\n */\n\nexport * from './version.js';\n"]}

package/dist/core/schema/version.d.ts

@@ -0,0 +1,14 @@
+import type { RelatorioComVersao, SchemaMetadata } from '../../types/index.js';
+export type { RelatorioComVersao, SchemaMetadata };
+export declare const VERSAO_ATUAL = "1.0.0";
+export declare const HISTORICO_VERSOES: Record<string, SchemaMetadata>;
+export declare function criarSchemaMetadata(versao?: string, descricaoPersonalizada?: string): SchemaMetadata;
+export declare function validarSchema(relatorio: Record<string, unknown>): {
+    valido: boolean;
+    erros: string[];
+};
+export declare function migrarParaVersaoAtual<T>(relatorio: Record<string, unknown>): RelatorioComVersao<T>;
+export declare function criarRelatorioComVersao<T>(dados: T, versao?: string, descricao?: string): RelatorioComVersao<T>;
+export declare function extrairDados<T>(relatorio: RelatorioComVersao<T>): T;
+export declare function versaoCompativel(versao: string): boolean;
+//# sourceMappingURL=version.d.ts.map

package/dist/core/schema/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../src/core/schema/version.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,GAAG,CAAC;AAG5D,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,CAAC;AAGnD,eAAO,MAAM,YAAY,UAAU,CAAC;AAGpC,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAS5D,CAAC;AAMF,wBAAgB,mBAAmB,CAAC,MAAM,GAAE,MAAqB,EAAE,sBAAsB,CAAC,EAAE,MAAM,GAAG,cAAc,CAWlH;AAMD,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACjE,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CA2CA;AAKD,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAsBlG;AAKD,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,GAAE,MAAqB,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAK7H;AAKD,wBAAgB,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,CAAC,CAEnE;AAMD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAIxD"}