tutanus 0.12.0

package/dist/analysts/php/analysts/analyst-php.js

@@ -0,0 +1,116 @@
+import { messages } from '../../../core/messages/index.js';
+import { createLineLookup } from '../../../shared/helpers/index.js';
+import { criarAnalista, criarOcorrencia } from '../../../types/index.js';
+const disableEnv = process.env.TUTANUS_DISABLE_PLUGIN_PHP === '1';
+function isPhpFile(relPath) {
+    return /\.(php|phtml|php3|php4|php5|php7|php8)$/i.test(relPath);
+}
+function warn(message, relPath, line, nivel) {
+    return criarOcorrencia({
+        relPath,
+        mensagem: message,
+        linha: line,
+        nivel: nivel ?? messages.SeverityNiveis.warning,
+        origem: messages.AnalystOrigens.php,
+        tipo: messages.AnalystTipos.php
+    });
+}
+function collectPhpIssues(src, relPath) {
+    const ocorrencias = [];
+    const lineOf = createLineLookup(src).lineAt;
+    const scanWithoutStrings = src.replace(/['"`][^'"]*['"`]/g, '""');
+    for (const match of scanWithoutStrings.matchAll(/\b(?:mysql|mysqli|sqlite|pg)_query\s*\(\s*\$[^)]*(?:\$|\.)/gi)) {
+        const line = lineOf(match.index);
+        ocorrencias.push(warn(messages.PhpMensagens.sqlInjection, relPath, line, messages.SeverityNiveis.error));
+    }
+    for (const match of scanWithoutStrings.matchAll(/\beval\s*\(/gi)) {
+        const line = lineOf(match.index);
+        ocorrencias.push(warn(messages.PhpMensagens.evalUsage, relPath, line, messages.SeverityNiveis.error));
+    }
+    for (const match of scanWithoutStrings.matchAll(/\bassert\s*\(\s*['"]/gi)) {
+        const line = lineOf(match.index);
+        ocorrencias.push(warn(messages.PhpMensagens.assertString, relPath, line, messages.SeverityNiveis.error));
+    }
+    for (const match of scanWithoutStrings.matchAll(/\bunserialize\s*\(/gi)) {
+        const line = lineOf(match.index);
+        ocorrencias.push(warn(messages.PhpMensagens.unserializeUsage, relPath, line, messages.SeverityNiveis.error));
+    }
+    for (const match of scanWithoutStrings.matchAll(/\bextract\s*\(/gi)) {
+        const line = lineOf(match.index);
+        ocorrencias.push(warn(messages.PhpMensagens.extractUsage, relPath, line, messages.SeverityNiveis.error));
+    }
+    for (const match of scanWithoutStrings.matchAll(/\bfile_get_contents\s*\(\s*['"](?:https?:\/\/)/gi)) {
+        const line = lineOf(match.index);
+        ocorrencias.push(warn(messages.PhpMensagens.urlFetch, relPath, line));
+    }
+    for (const match of scanWithoutStrings.matchAll(/\b(?:system|exec|shell_exec|passthru|popen|proc_open)\s*\(/gi)) {
+        const line = lineOf(match.index);
+        ocorrencias.push(warn(messages.PhpMensagens.commandExecution, relPath, line, messages.SeverityNiveis.error));
+    }
+    for (const match of scanWithoutStrings.matchAll(/\$_REQUEST\b/gi)) {
+        const line = lineOf(match.index);
+        ocorrencias.push(warn(messages.PhpMensagens.requestUsage, relPath, line));
+    }
+    for (const match of scanWithoutStrings.matchAll(/(?:password|secret|api[_-]?key|token|credential|db_password|db_user)\s*(?::\s*|=>\s*|=\s*["'`])([^"'`\s]{4,})/gi)) {
+        const line = lineOf(match.index);
+        ocorrencias.push(warn(messages.PhpMensagens.hardcodedSecret, relPath, line, messages.SeverityNiveis.error));
+    }
+    for (const match of scanWithoutStrings.matchAll(/\bmysql_\w+\s*\(/gi)) {
+        const line = lineOf(match.index);
+        ocorrencias.push(warn(messages.PhpMensagens.deprecatedMysql, relPath, line));
+    }
+    if (/^<\?[^=phHP\r\n]/m.test(src)) {
+        ocorrencias.push(warn(messages.PhpMensagens.shortOpenTag, relPath, 1));
+    }
+    for (const match of src.matchAll(/@\s*(?:mkdir|file_put_contents|fopen|include|require|unlink|copy|rename|move_uploaded_file|file_get_contents)\s*\(/g)) {
+        const line = lineOf(match.index);
+        ocorrencias.push(warn(messages.PhpMensagens.errorSuppression, relPath, line));
+    }
+    const funcMatches = src.matchAll(/(?:^|\n)\s*(?:public|private|protected|static)?\s*function\s+\w+\s*\([^)]*\)\s*(?::\s*\w+)?\s*\{/g);
+    for (const funcMatch of funcMatches) {
+        const startIdx = (funcMatch.index ?? 0) + (funcMatch[0]?.length ?? 0);
+        let braceCount = 1;
+        let endIdx = startIdx;
+        for (let i = startIdx; i < src.length && braceCount > 0; i++) {
+            if (src[i] === '{')
+                braceCount++;
+            if (src[i] === '}')
+                braceCount--;
+            endIdx = i;
+        }
+        const body = src.slice(startIdx, endIdx);
+        const lines = body.split('\n').length;
+        if (lines > 60) {
+            const line = lineOf(funcMatch.index ?? 0);
+            ocorrencias.push(warn(messages.PhpMensagens.longFunction, relPath, line));
+        }
+    }
+    for (const match of src.matchAll(/\b(?:var_dump|dump|print_r|die|exit)\s*\(/g)) {
+        const line = lineOf(match.index);
+        if (!relPath.includes('tests/') && !relPath.includes('debug/')) {
+            ocorrencias.push(warn(messages.PhpMensagens.debugOutput, relPath, line));
+        }
+    }
+    for (const match of scanWithoutStrings.matchAll(/\bfunction\s+([a-z][a-zA-Z0-9]*)\s*\(/g)) {
+        const funcName = match[1] ?? '';
+        if (/^[a-z]+[A-Z]/.test(funcName)) {
+            const line = lineOf(match.index);
+            ocorrencias.push(warn(messages.PhpMensagens.camelCaseFunction, relPath, line, messages.SeverityNiveis.suggestion));
+        }
+    }
+    return ocorrencias;
+}
+export const analistaPhp = criarAnalista({
+    nome: 'analista-php',
+    categoria: 'linguagem',
+    descricao: 'Analisa código PHP em busca de segurança, boas práticas e qualidade com parser dedicado.',
+    global: false,
+    test: (relPath) => isPhpFile(relPath),
+    aplicar: async (src, relPath) => {
+        if (disableEnv)
+            return null;
+        const msgs = collectPhpIssues(src, relPath);
+        return msgs.length ? msgs : null;
+    }
+});
+//# sourceMappingURL=analyst-php.js.map

package/dist/analysts/php/analysts/analyst-php.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyst-php.js","sourceRoot":"","sources":["../../../../src/analysts/php/analysts/analyst-php.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: MIT\nimport { messages } from '@core/messages';\nimport { createLineLookup } from '@shared/helpers';\n\nimport { criarAnalista, criarOcorrencia } from '@';\n\nconst disableEnv = process.env.TUTANUS_DISABLE_PLUGIN_PHP === '1';\ntype Msg = ReturnType<typeof criarOcorrencia>;\n\nfunction isPhpFile(relPath: string): boolean {\n  return /\\.(php|phtml|php3|php4|php5|php7|php8)$/i.test(relPath);\n}\n\nfunction warn(message: string, relPath: string, line?: number, nivel?: string): Msg {\n  return criarOcorrencia({\n    relPath,\n    mensagem: message,\n    linha: line,\n    nivel: nivel ?? messages.SeverityNiveis.warning,\n    origem: messages.AnalystOrigens.php,\n    tipo: messages.AnalystTipos.php\n  });\n}\n\nfunction collectPhpIssues(src: string, relPath: string): Msg[] {\n  const ocorrencias: Msg[] = [];\n  const lineOf = createLineLookup(src).lineAt;\n\n  // Reduz falsos positivos mascarando strings\n  const scanWithoutStrings = src.replace(/['\"`][^'\"]*['\"`]/g, '\"\"');\n\n  // --- Security: SQL injection (mysql_query, mysqli_query, etc) ---\n  for (const match of scanWithoutStrings.matchAll(/\\b(?:mysql|mysqli|sqlite|pg)_query\\s*\\(\\s*\\$[^)]*(?:\\$|\\.)/gi)) {\n    const line = lineOf(match.index);\n    ocorrencias.push(warn(messages.PhpMensagens.sqlInjection, relPath, line, messages.SeverityNiveis.error));\n  }\n\n  // --- Security: eval() usage ---\n  for (const match of scanWithoutStrings.matchAll(/\\beval\\s*\\(/gi)) {\n    const line = lineOf(match.index);\n    ocorrencias.push(warn(messages.PhpMensagens.evalUsage, relPath, line, messages.SeverityNiveis.error));\n  }\n\n  // --- Security: assert() with string (code injection) ---\n  for (const match of scanWithoutStrings.matchAll(/\\bassert\\s*\\(\\s*['\"]/gi)) {\n    const line = lineOf(match.index);\n    ocorrencias.push(warn(messages.PhpMensagens.assertString, relPath, line, messages.SeverityNiveis.error));\n  }\n\n  // --- Security: unserialize() ---\n  for (const match of scanWithoutStrings.matchAll(/\\bunserialize\\s*\\(/gi)) {\n    const line = lineOf(match.index);\n    ocorrencias.push(warn(messages.PhpMensagens.unserializeUsage, relPath, line, messages.SeverityNiveis.error));\n  }\n\n  // --- Security: extract() ---\n  for (const match of scanWithoutStrings.matchAll(/\\bextract\\s*\\(/gi)) {\n    const line = lineOf(match.index);\n    ocorrencias.push(warn(messages.PhpMensagens.extractUsage, relPath, line, messages.SeverityNiveis.error));\n  }\n\n  // --- Security: file_get_contents with URL ---\n  for (const match of scanWithoutStrings.matchAll(/\\bfile_get_contents\\s*\\(\\s*['\"](?:https?:\\/\\/)/gi)) {\n    const line = lineOf(match.index);\n    ocorrencias.push(warn(messages.PhpMensagens.urlFetch, relPath, line));\n  }\n\n  // --- Security: system/exec/shell_exec/passthru ---\n  for (const match of scanWithoutStrings.matchAll(/\\b(?:system|exec|shell_exec|passthru|popen|proc_open)\\s*\\(/gi)) {\n    const line = lineOf(match.index);\n    ocorrencias.push(warn(messages.PhpMensagens.commandExecution, relPath, line, messages.SeverityNiveis.error));\n  }\n\n  // --- Security: $_REQUEST usage ---\n  for (const match of scanWithoutStrings.matchAll(/\\$_REQUEST\\b/gi)) {\n    const line = lineOf(match.index);\n    ocorrencias.push(warn(messages.PhpMensagens.requestUsage, relPath, line));\n  }\n\n  // --- Security: hardcoded secrets ---\n  for (const match of scanWithoutStrings.matchAll(/(?:password|secret|api[_-]?key|token|credential|db_password|db_user)\\s*(?::\\s*|=>\\s*|=\\s*[\"'`])([^\"'`\\s]{4,})/gi)) {\n    const line = lineOf(match.index);\n    ocorrencias.push(warn(messages.PhpMensagens.hardcodedSecret, relPath, line, messages.SeverityNiveis.error));\n  }\n\n  // --- Code Quality: deprecated mysql_* functions ---\n  for (const match of scanWithoutStrings.matchAll(/\\bmysql_\\w+\\s*\\(/gi)) {\n    const line = lineOf(match.index);\n    ocorrencias.push(warn(messages.PhpMensagens.deprecatedMysql, relPath, line));\n  }\n\n  // --- Code Quality: short_open_tag ---\n  if (/^<\\?[^=phHP\\r\\n]/m.test(src)) {\n    ocorrencias.push(warn(messages.PhpMensagens.shortOpenTag, relPath, 1));\n  }\n\n  // --- Code Quality: error suppression (@) ---\n  for (const match of src.matchAll(/@\\s*(?:mkdir|file_put_contents|fopen|include|require|unlink|copy|rename|move_uploaded_file|file_get_contents)\\s*\\(/g)) {\n    const line = lineOf(match.index);\n    ocorrencias.push(warn(messages.PhpMensagens.errorSuppression, relPath, line));\n  }\n\n  // --- Code Quality: long function/method ---\n  const funcMatches = src.matchAll(/(?:^|\\n)\\s*(?:public|private|protected|static)?\\s*function\\s+\\w+\\s*\\([^)]*\\)\\s*(?::\\s*\\w+)?\\s*\\{/g);\n  for (const funcMatch of funcMatches) {\n    const startIdx = (funcMatch.index ?? 0) + (funcMatch[0]?.length ?? 0);\n    let braceCount = 1;\n    let endIdx = startIdx;\n    for (let i = startIdx; i < src.length && braceCount > 0; i++) {\n      if (src[i] === '{') braceCount++;\n      if (src[i] === '}') braceCount--;\n      endIdx = i;\n    }\n    const body = src.slice(startIdx, endIdx);\n    const lines = body.split('\\n').length;\n    if (lines > 60) {\n      const line = lineOf(funcMatch.index ?? 0);\n      ocorrencias.push(warn(messages.PhpMensagens.longFunction, relPath, line));\n    }\n  }\n\n  // --- Code Quality: var_dump/die in production ---\n  for (const match of src.matchAll(/\\b(?:var_dump|dump|print_r|die|exit)\\s*\\(/g)) {\n    const line = lineOf(match.index);\n    if (!relPath.includes('tests/') && !relPath.includes('debug/')) {\n      ocorrencias.push(warn(messages.PhpMensagens.debugOutput, relPath, line));\n    }\n  }\n\n  // --- Style: naming convention (snake_case) ---\n  for (const match of scanWithoutStrings.matchAll(/\\bfunction\\s+([a-z][a-zA-Z0-9]*)\\s*\\(/g)) {\n    const funcName = match[1] ?? '';\n    if (/^[a-z]+[A-Z]/.test(funcName)) {\n      const line = lineOf(match.index);\n      ocorrencias.push(warn(messages.PhpMensagens.camelCaseFunction, relPath, line, messages.SeverityNiveis.suggestion));\n    }\n  }\n\n  return ocorrencias;\n}\n\nexport const analistaPhp = criarAnalista({\n  nome: 'analista-php',\n  categoria: 'linguagem',\n  descricao: 'Analisa código PHP em busca de segurança, boas práticas e qualidade com parser dedicado.',\n  global: false,\n  test: (relPath: string): boolean => isPhpFile(relPath),\n  aplicar: async (src, relPath): Promise<Msg[] | null> => {\n    if (disableEnv) return null;\n    const msgs = collectPhpIssues(src, relPath);\n    return msgs.length ? msgs : null;\n  }\n});\n"]}

package/dist/analysts/php/analysts/index.d.ts

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

package/dist/analysts/php/analysts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/analysts/php/analysts/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}

package/dist/analysts/php/analysts/index.js

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

package/dist/analysts/php/analysts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/analysts/php/analysts/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC","sourcesContent":["export * from './analyst-php.js';\n"]}

package/dist/analysts/php/corrections/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/analysts/php/corrections/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/analysts/php/corrections/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC"}

package/dist/analysts/php/corrections/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/analysts/php/corrections/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/analysts/php/corrections/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC","sourcesContent":["// SPDX-License-Identifier: MIT\nexport {};\n"]}

package/dist/analysts/php/detectors/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/analysts/php/detectors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/analysts/php/detectors/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/analysts/php/detectors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/analysts/php/detectors/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC","sourcesContent":["// SPDX-License-Identifier: MIT\nexport {};\n"]}

package/dist/analysts/php/index.d.ts

@@ -0,0 +1,5 @@
+export * from './analysts/analyst-php.js';
+export * from './corrections/index.js';
+export * from './detectors/index.js';
+export * from './scorers/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/analysts/php/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/analysts/php/index.ts"],"names":[],"mappings":"AACA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC"}

package/dist/analysts/php/index.js

@@ -0,0 +1,5 @@
+export * from './analysts/analyst-php.js';
+export * from './corrections/index.js';
+export * from './detectors/index.js';
+export * from './scorers/index.js';
+//# sourceMappingURL=index.js.map

package/dist/analysts/php/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/analysts/php/index.ts"],"names":[],"mappings":"AACA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC","sourcesContent":["// SPDX-License-Identifier: MIT\nexport * from './analysts/analyst-php.js';\nexport * from './corrections/index.js';\nexport * from './detectors/index.js';\nexport * from './scorers/index.js';\n"]}

package/dist/analysts/php/scorers/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/analysts/php/scorers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/analysts/php/scorers/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC"}

package/dist/analysts/php/scorers/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/analysts/php/scorers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/analysts/php/scorers/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC","sourcesContent":["// SPDX-License-Identifier: MIT\nexport {};\n"]}

package/dist/analysts/plugins/analyst-formatter.d.ts

@@ -0,0 +1,12 @@
+import { criarOcorrencia } from '../../types/index.js';
+type Msg = ReturnType<typeof criarOcorrencia>;
+export declare const analistaFormatador: {
+    nome: string;
+    categoria: string;
+    descricao: string;
+    global: false;
+    test: (relPath: string) => boolean;
+    aplicar: (src: string, relPath: string) => Promise<Msg[] | null>;
+};
+export {};
+//# sourceMappingURL=analyst-formatter.d.ts.map

package/dist/analysts/plugins/analyst-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyst-formatter.d.ts","sourceRoot":"","sources":["../../../src/analysts/plugins/analyst-formatter.ts"],"names":[],"mappings":"AAKA,OAAO,EAAiB,eAAe,EAAE,MAAM,GAAG,CAAC;AAGnD,KAAK,GAAG,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAoC9C,eAAO,MAAM,kBAAkB;;;;;oBAKb,MAAM,KAAG,OAAO;+CAID,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;CA6BpD,CAAC"}

package/dist/analysts/plugins/analyst-formatter.js

@@ -0,0 +1,83 @@
+import { messages } from '../../core/messages/index.js';
+import { formatarMarkdownMinimo, formatarPrettierMinimo } from '../../shared/formatters/index.js';
+import { extrairSupressoes, shouldSuppressOccurrence } from '../../shared/helpers/index.js';
+import { criarAnalista, criarOcorrencia } from '../../types/index.js';
+const disableEnv = process.env.TUTANUS_DISABLE_PLUGIN_FORMATADOR === '1';
+function parserParaTipo(parser) {
+    return `formatador-${parser}`;
+}
+function msg(message, relPath, parser, nivel = messages.SeverityNiveis.warning, line = 1) {
+    return criarOcorrencia({
+        relPath,
+        mensagem: message,
+        linha: line,
+        nivel,
+        origem: messages.AnalystOrigens.formatador,
+        tipo: parserParaTipo(parser)
+    });
+}
+function normalizarEol(code) {
+    return code.replace(/\r\n?/g, '\n');
+}
+function primeiraLinhaDiferente(arquivo, base) {
+    const aLines = normalizarEol(arquivo).split('\n');
+    const bLines = normalizarEol(base).split('\n');
+    const len = Math.max(aLines.length, bLines.length);
+    for (let indice = 0; indice < len; indice++) {
+        if ((aLines[indice] ?? '') !== (bLines[indice] ?? ''))
+            return indice + 1;
+    }
+    return 1;
+}
+function extrairLinhasProtegidas(src) {
+    const supressoes = extrairSupressoes(src);
+    const protegidas = new Set();
+    for (const [linha, regras] of supressoes.porLinha) {
+        if (regras.has('pontuacao-repetida') || regras.has('espacamento-incorreto') || regras.has('*') || regras.has('analista-formatador')) {
+            protegidas.add(linha);
+        }
+    }
+    return protegidas;
+}
+export const analistaFormatador = criarAnalista({
+    nome: 'analista-formatador',
+    categoria: 'formatacao',
+    descricao: 'Verifica formatação mínima interna do Tutanus (JSON/Markdown/YAML).',
+    global: false,
+    test: (relPath) => {
+        if (/package-lock\.json$/i.test(relPath) || /yarn\.lock$/i.test(relPath) || /pnpm-lock\.yaml$/i.test(relPath))
+            return false;
+        return /\.(json|md|markdown|ya?ml)$/i.test(relPath);
+    },
+    aplicar: async (src, relPath) => {
+        if (disableEnv)
+            return null;
+        const isMarkdown = /\.(md|markdown)$/i.test(relPath);
+        let res;
+        if (isMarkdown) {
+            const protectedLines = extrairLinhasProtegidas(src);
+            res = formatarMarkdownMinimo(src, protectedLines.size > 0 ? protectedLines : undefined);
+        }
+        else {
+            res = formatarPrettierMinimo({
+                code: src,
+                relPath
+            });
+        }
+        if (!res.ok) {
+            const tipo = parserParaTipo(res.parser);
+            if (shouldSuppressOccurrence(tipo, relPath))
+                return null;
+            return [msg(messages.FormatadorMensagens.parseErro(res.parser, res.error), relPath, res.parser, messages.SeverityNiveis.error, 1)];
+        }
+        if (!res.changed)
+            return null;
+        const tipo = parserParaTipo(res.parser);
+        if (shouldSuppressOccurrence(tipo, relPath))
+            return null;
+        const linha = primeiraLinhaDiferente(src, res.formatted);
+        const detalhes = [`primeira diferença na linha ${linha}`, res.reason ? `motivo: ${res.reason}` : null].filter(Boolean).join(', ');
+        return [msg(messages.FormatadorMensagens.naoFormatado(res.parser, detalhes || undefined), relPath, res.parser, messages.SeverityNiveis.warning, linha)];
+    }
+});
+//# sourceMappingURL=analyst-formatter.js.map

package/dist/analysts/plugins/analyst-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyst-formatter.js","sourceRoot":"","sources":["../../../src/analysts/plugins/analyst-formatter.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: MIT\nimport { messages } from '@core/messages';\nimport { formatarMarkdownMinimo,formatarPrettierMinimo } from '@shared/formatters';\nimport { extrairSupressoes,shouldSuppressOccurrence } from '@shared/helpers';\n\nimport { criarAnalista, criarOcorrencia } from '@';\n\nconst disableEnv = process.env.TUTANUS_DISABLE_PLUGIN_FORMATADOR === '1';\ntype Msg = ReturnType<typeof criarOcorrencia>;\nfunction parserParaTipo(parser: string): string {\n  return `formatador-${parser}`;\n}\nfunction msg(message: string, relPath: string, parser: string, nivel: (typeof messages.SeverityNiveis)[keyof typeof messages.SeverityNiveis] = messages.SeverityNiveis.warning, line = 1): Msg {\n  return criarOcorrencia({\n    relPath,\n    mensagem: message,\n    linha: line,\n    nivel,\n    origem: messages.AnalystOrigens.formatador,\n    tipo: parserParaTipo(parser)\n  });\n}\nfunction normalizarEol(code: string): string {\n  return code.replace(/\\r\\n?/g, '\\n');\n}\nfunction primeiraLinhaDiferente(arquivo: string, base: string): number {\n  const aLines = normalizarEol(arquivo).split('\\n');\n  const bLines = normalizarEol(base).split('\\n');\n  const len = Math.max(aLines.length, bLines.length);\n  for (let indice = 0; indice < len; indice++) {\n    if ((aLines[indice] ?? '') !== (bLines[indice] ?? '')) return indice + 1;\n  }\n  return 1;\n}\nfunction extrairLinhasProtegidas(src: string): Set<number> {\n  const supressoes = extrairSupressoes(src);\n  const protegidas = new Set<number>();\n  for (const [linha, regras] of supressoes.porLinha) {\n    if (regras.has('pontuacao-repetida') || regras.has('espacamento-incorreto') || regras.has('*') || regras.has('analista-formatador')) {\n      protegidas.add(linha);\n    }\n  }\n  return protegidas;\n}\nexport const analistaFormatador = criarAnalista({\n  nome: 'analista-formatador',\n  categoria: 'formatacao',\n  descricao: 'Verifica formatação mínima interna do Tutanus (JSON/Markdown/YAML).',\n  global: false,\n  test: (relPath: string): boolean => {\n    if (/package-lock\\.json$/i.test(relPath) || /yarn\\.lock$/i.test(relPath) || /pnpm-lock\\.yaml$/i.test(relPath)) return false;\n    return /\\.(json|md|markdown|ya?ml)$/i.test(relPath);\n  },\n  aplicar: async (src, relPath): Promise<Msg[] | null> => {\n    if (disableEnv) return null;\n\n    // Para markdown, extrair supressões inline e passar ao formatter\n    const isMarkdown = /\\.(md|markdown)$/i.test(relPath);\n    let res: ReturnType<typeof formatarPrettierMinimo>;\n    if (isMarkdown) {\n      const protectedLines = extrairLinhasProtegidas(src);\n      res = formatarMarkdownMinimo(src, protectedLines.size > 0 ? protectedLines : undefined);\n    } else {\n      res = formatarPrettierMinimo({\n        code: src,\n        relPath\n      });\n    }\n    if (!res.ok) {\n      const tipo = parserParaTipo(res.parser);\n      if (shouldSuppressOccurrence(tipo, relPath)) return null;\n      return [msg(messages.FormatadorMensagens.parseErro(res.parser, res.error), relPath, res.parser, messages.SeverityNiveis.error, 1)];\n    }\n    if (!res.changed) return null;\n    const tipo = parserParaTipo(res.parser);\n    if (shouldSuppressOccurrence(tipo, relPath)) return null;\n    const linha = primeiraLinhaDiferente(src, res.formatted);\n    const detalhes = [`primeira diferença na linha ${linha}`, res.reason ? `motivo: ${res.reason}` : null].filter(Boolean).join(', ');\n\n    // Manter como aviso (alinha com intenção de \"check\" sem mutação)\n    return [msg(messages.FormatadorMensagens.naoFormatado(res.parser, detalhes || undefined), relPath, res.parser, messages.SeverityNiveis.warning, linha)];\n  }\n});\n"]}

package/dist/analysts/plugins/detector-documentation.d.ts

@@ -0,0 +1,3 @@
+import type { Analista } from '../../types/index.js';
+export declare const analistaDocumentacao: Analista;
+//# sourceMappingURL=detector-documentation.d.ts.map

package/dist/analysts/plugins/detector-documentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector-documentation.d.ts","sourceRoot":"","sources":["../../../src/analysts/plugins/detector-documentation.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAoC,MAAM,GAAG,CAAC;AAGpE,eAAO,MAAM,oBAAoB,EAAE,QA0DlC,CAAC"}

package/dist/analysts/plugins/detector-documentation.js

@@ -0,0 +1,220 @@
+import { messages } from '../../core/messages/index.js';
+import { detectarContextoProjeto } from '../../shared/index.js';
+import { filtrarOcorrenciasSuprimidas } from '../../shared/helpers/index.js';
+import { criarOcorrencia } from '../../types/index.js';
+export const analistaDocumentacao = {
+    nome: 'documentacao',
+    categoria: 'manutenibilidade',
+    descricao: 'Detecta problemas de documentação e legibilidade do código',
+    test: (relPath) => {
+        return /\.(js|jsx|ts|tsx|mjs|cjs)$/.test(relPath);
+    },
+    aplicar: (src, relPath, ast) => {
+        if (!src)
+            return [];
+        const contextoArquivo = detectarContextoProjeto({
+            arquivo: relPath,
+            conteudo: src,
+            relPath
+        });
+        const problemas = [];
+        try {
+            detectarPadroesDocumentacao(src, problemas, relPath);
+            if (ast) {
+                detectarProblemasDocumentacaoAST(ast, problemas);
+            }
+            const ocorrencias = [];
+            const porPrioridade = agruparPorPrioridade(problemas);
+            for (const [prioridade, items] of Object.entries(porPrioridade)) {
+                if (items.length > 0) {
+                    const nivel = mapearPrioridadeParaNivel(prioridade);
+                    const nivelAjustado = (contextoArquivo.isTest || contextoArquivo.isConfiguracao) && nivel === 'aviso' ? 'info' : nivel;
+                    const resumo = items.slice(0, 3).map(caminho => caminho.tipo).join(', ');
+                    ocorrencias.push(criarOcorrencia({
+                        tipo: 'problema-documentacao',
+                        nivel: nivelAjustado,
+                        mensagem: messages.DetectorAgregadosMensagens.problemasDocumentacaoResumo(prioridade, resumo, items.length),
+                        relPath,
+                        linha: items[0].linha
+                    }));
+                }
+            }
+            return filtrarOcorrenciasSuprimidas(ocorrencias, 'documentacao', src);
+        }
+        catch (erro) {
+            return [criarOcorrencia({
+                    tipo: 'ERRO_ANALISE',
+                    nivel: 'aviso',
+                    mensagem: messages.DetectorAgregadosMensagens.erroAnalisarDocumentacao(erro),
+                    relPath,
+                    linha: 1
+                })];
+        }
+    }
+};
+function detectarPadroesDocumentacao(src, problemas, relPath) {
+    const linhas = src.split('\n');
+    const isLibraryArquivo = relPath.includes('src/shared/') || relPath.includes('src/core/') || relPath.includes('lib/');
+    const isInternalArquivo = relPath.includes('/cli/') || relPath.includes('/test') || relPath.includes('/spec') || relPath.includes('/__tests__/') || relPath.includes('/fixtures/') || relPath.includes('/mocks/') || relPath.includes('config.') || relPath.includes('setup.') || relPath.includes('/messages/');
+    let temExportacaoPublica = false;
+    let temJSDoc = false;
+    let dentroDeJSDoc = false;
+    linhas.forEach((linha, index) => {
+        const numeroLinha = index + 1;
+        if (/\/\*\*/.test(linha)) {
+            temJSDoc = true;
+            dentroDeJSDoc = true;
+        }
+        const linhaJSDoc = dentroDeJSDoc || /^\s*\*/.test(linha);
+        if (linhaJSDoc) {
+            if (/\*\//.test(linha)) {
+                dentroDeJSDoc = false;
+            }
+            return;
+        }
+        if (/^export\s+(function|class|const|let|var|default)/.test(linha.trim())) {
+            temExportacaoPublica = true;
+        }
+        const singleLetterMatch = /\b(const|let|var)\s+([a-z])\s*=/.exec(linha);
+        if (singleLetterMatch && !/for\s*\(/.test(linha) && !/while\s*\(/.test(linha)) {
+            const varNome = singleLetterMatch[2];
+            const isLoopContext = /\b(i|j|k)\s*=\s*\d+/.test(linha) || /\b(i|j|k)\s*[+\-]=/.test(linha);
+            const isTipoCast = /as\s+\w+/.test(linha) || /:\s*\w+\s*=/.test(linha);
+            if (!isLoopContext && !isTipoCast) {
+                problemas.push({
+                    tipo: 'poor-naming',
+                    descricao: `Variável '${varNome}' com nome de uma letra dificulta compreensão`,
+                    prioridade: 'media',
+                    linha: numeroLinha,
+                    coluna: linha.indexOf(singleLetterMatch[0]) + 1,
+                    contexto: linha.trim(),
+                    sugestao: 'Use nomes descritivos para variáveis'
+                });
+            }
+        }
+        const numMagico = /\b(\d{2,})\b/.exec(linha);
+        if (numMagico && !/(length|size|count)\s*[=><!]/.test(linha) && !/\[\s*\d+\s*\]/.test(linha) && parseInt(numMagico[1]) > 10) {
+            problemas.push({
+                tipo: 'magic-constants',
+                descricao: `Número mágico ${numMagico[1]} sem explicação`,
+                prioridade: 'baixa',
+                linha: numeroLinha,
+                coluna: linha.indexOf(numMagico[0]) + 1,
+                contexto: linha.trim(),
+                sugestao: 'Extraia para constante nomeada com comentário'
+            });
+        }
+        if (/TODO.*\d{4}/.test(linha)) {
+            const ano = /TODO.*(\d{4})/.exec(linha)?.[1];
+            const anoAtual = new Date().getFullYear();
+            if (ano && anoAtual - parseInt(ano) > 1) {
+                problemas.push({
+                    tipo: 'outdated-comments',
+                    descricao: `TODO de ${ano} pode estar desatualizado`,
+                    prioridade: 'baixa',
+                    linha: numeroLinha,
+                    coluna: linha.indexOf('TODO') + 1,
+                    contexto: linha.trim(),
+                    sugestao: 'Revisar e atualizar ou implementar TODO antigo'
+                });
+            }
+        }
+        if (/:\s*any\b/.test(linha) && !/\/\/|\/\*/.test(linha)) {
+            const anyMatch = /:\s*any\b/.exec(linha);
+            if (anyMatch) {
+                const position = anyMatch.index;
+                const before = linha.substring(0, position);
+                const singleQuotes = (before.match(/'/g) || []).length;
+                const doubleQuotes = (before.match(/"/g) || []).length;
+                const backticks = (before.match(/`/g) || []).length;
+                const dentroDeString = singleQuotes % 2 !== 0 || doubleQuotes % 2 !== 0 || backticks % 2 !== 0;
+                if (!dentroDeString) {
+                    problemas.push({
+                        tipo: 'missing-types',
+                        descricao: 'Tipo any sem justificativa via comentário',
+                        prioridade: 'media',
+                        linha: numeroLinha,
+                        coluna: position + 1,
+                        contexto: linha.trim(),
+                        sugestao: 'Adicione comentário explicando uso de any ou use tipo mais específico'
+                    });
+                }
+            }
+        }
+    });
+    if (isLibraryArquivo && temExportacaoPublica && !temJSDoc && !isInternalArquivo && src.length > 200) {
+        problemas.push({
+            tipo: 'missing-jsdoc',
+            descricao: 'Arquivo de biblioteca pública sem documentação',
+            prioridade: 'media',
+            linha: 1,
+            coluna: 1,
+            contexto: 'Arquivo de biblioteca',
+            sugestao: 'Considere adicionar JSDoc para APIs públicas (funções/classes exportadas principais)'
+        });
+    }
+}
+function detectarProblemasDocumentacaoAST(ast, problemas) {
+    try {
+        ast.traverse({
+            ExportDefaultDeclaration(path) {
+                if ((path.node.declaration.type === 'FunctionDeclaration' || path.node.declaration.type === 'ClassDeclaration') && !path.node.leadingComments?.some(elem => elem.value.startsWith('*'))) {
+                    problemas.push({
+                        tipo: 'missing-jsdoc',
+                        descricao: 'Export default (principal) sem JSDoc',
+                        prioridade: 'media',
+                        linha: path.node.loc?.start.line || 0,
+                        coluna: path.node.loc?.start.column || 0,
+                        contexto: 'Export default',
+                        sugestao: 'Documente a API principal do módulo para facilitar uso'
+                    });
+                }
+            },
+            ClassDeclaration(path) {
+                const node = path.node;
+                if (node.body.body.length > 3 &&
+                    !node.leadingComments?.some(elem => elem.value.startsWith('*')) && node.id?.name && !node.id.name.toLowerCase().includes('test') && !node.id.name.toLowerCase().includes('mock')) {
+                    const parent = path.parent;
+                    const isExported = parent.type === 'ExportNamedDeclaration' || parent.type === 'ExportDefaultDeclaration';
+                    if (isExported) {
+                        problemas.push({
+                            tipo: 'missing-jsdoc',
+                            descricao: `Classe pública ${node.id.name} (${node.body.body.length} membros) sem documentação`,
+                            prioridade: 'media',
+                            linha: node.loc?.start.line || 0,
+                            coluna: node.loc?.start.column || 0,
+                            contexto: 'ClassDeclaration',
+                            sugestao: 'Documente o propósito e principais responsabilidades da classe'
+                        });
+                    }
+                }
+            }
+        });
+    }
+    catch {
+    }
+}
+function agruparPorPrioridade(problemas) {
+    return problemas.reduce((acc, problema) => {
+        const prioridade = problema.prioridade;
+        if (prioridade) {
+            if (!acc[prioridade]) {
+                acc[prioridade] = [];
+            }
+            acc[prioridade].push(problema);
+        }
+        return acc;
+    }, {});
+}
+function mapearPrioridadeParaNivel(prioridade) {
+    switch (prioridade) {
+        case 'alta':
+            return 'aviso';
+        case 'media':
+            return 'aviso';
+        case 'baixa':
+        default:
+            return 'info';
+    }
+}
+//# sourceMappingURL=detector-documentation.js.map

package/dist/analysts/plugins/detector-documentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector-documentation.js","sourceRoot":"","sources":["../../../src/analysts/plugins/detector-documentation.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: MIT\nimport type { NodePath } from '@babel/traverse';\nimport type { Node } from '@babel/types';\nimport { messages } from '@core/messages';\nimport { detectarContextoProjeto } from '@shared';\nimport { filtrarOcorrenciasSuprimidas } from '@shared/helpers';\n\nimport type { Analista, Ocorrencia, ProblemaDocumentacao } from '@';\nimport { criarOcorrencia } from '@';\n\nexport const analistaDocumentacao: Analista = {\n  nome: 'documentacao',\n  categoria: 'manutenibilidade',\n  descricao: 'Detecta problemas de documentação e legibilidade do código',\n  test: (relPath: string): boolean => {\n    return /\\.(js|jsx|ts|tsx|mjs|cjs)$/.test(relPath);\n  },\n  aplicar: (src: string, relPath: string, ast: NodePath<Node> | null): Ocorrencia[] => {\n    if (!src) return [];\n    const contextoArquivo = detectarContextoProjeto({\n      arquivo: relPath,\n      conteudo: src,\n      relPath\n    });\n    const problemas: ProblemaDocumentacao[] = [];\n    try {\n      // Detectar problemas por padrões de texto\n      detectarPadroesDocumentacao(src, problemas, relPath);\n\n      // Detectar problemas via AST quando disponível\n      if (ast) {\n        detectarProblemasDocumentacaoAST(ast, problemas);\n      }\n\n      // Converter para ocorrências\n      const ocorrencias: Ocorrencia[] = [];\n\n      // Agrupar por prioridade\n      const porPrioridade = agruparPorPrioridade(problemas);\n      for (const [prioridade, items] of Object.entries(porPrioridade)) {\n        if (items.length > 0) {\n          const nivel = mapearPrioridadeParaNivel(prioridade as ProblemaDocumentacao['prioridade']);\n\n          // Ser mais relaxado com testes e arquivos de configuração\n          const nivelAjustado = (contextoArquivo.isTest || contextoArquivo.isConfiguracao) && nivel === 'aviso' ? 'info' : nivel;\n          const resumo = items.slice(0, 3).map(caminho => caminho.tipo).join(', ');\n          ocorrencias.push(criarOcorrencia({\n            tipo: 'problema-documentacao',\n            nivel: nivelAjustado,\n            mensagem: messages.DetectorAgregadosMensagens.problemasDocumentacaoResumo(prioridade, resumo, items.length),\n            relPath,\n            linha: items[0].linha\n          }));\n        }\n      }\n\n      // Aplicar supressões inline antes de retornar\n      return filtrarOcorrenciasSuprimidas(ocorrencias, 'documentacao', src);\n    } catch (erro) {\n      return [criarOcorrencia({\n        tipo: 'ERRO_ANALISE',\n        nivel: 'aviso',\n        mensagem: messages.DetectorAgregadosMensagens.erroAnalisarDocumentacao(erro),\n        relPath,\n        linha: 1\n      })];\n    }\n  }\n};\nfunction detectarPadroesDocumentacao(src: string, problemas: ProblemaDocumentacao[], relPath: string): void {\n  const linhas = src.split('\\n');\n\n  // [ALVO] FILOSOFIA: Documentação é importante mas não deve poluir\n  // - Detectar apenas problemas reais, não ausência de JSDoc em código interno\n  // - Priorizar qualidade do código sobre quantidade de comentários\n  // - Arquivos de biblioteca pública precisam mais documentação que utils internos\n\n  // Verificar se é arquivo de biblioteca pública (requer documentação rigorosa)\n  const isLibraryArquivo = relPath.includes('src/shared/') || relPath.includes('src/core/') || relPath.includes('lib/');\n\n  // Arquivos que não precisam JSDoc rigoroso\n  const isInternalArquivo = relPath.includes('/cli/') || relPath.includes('/test') || relPath.includes('/spec') || relPath.includes('/__tests__/') || relPath.includes('/fixtures/') || relPath.includes('/mocks/') || relPath.includes('config.') || relPath.includes('setup.') || relPath.includes('/messages/');\n  let temExportacaoPublica = false;\n  let temJSDoc = false;\n  let dentroDeJSDoc = false;\n  linhas.forEach((linha, index) => {\n    const numeroLinha = index + 1;\n\n    // Rastrear contexto JSDoc\n    if (/\\/\\*\\*/.test(linha)) {\n      temJSDoc = true;\n      dentroDeJSDoc = true;\n    }\n\n    // Pular análise de problemas se estiver dentro de JSDoc ou linha começa com * (JSDoc)\n    const linhaJSDoc = dentroDeJSDoc || /^\\s*\\*/.test(linha);\n    if (linhaJSDoc) {\n      // Verificar fechamento depois de pular análise\n      if (/\\*\\//.test(linha)) {\n        dentroDeJSDoc = false;\n      }\n      return; // Não analisar código dentro de comentários JSDoc\n    }\n\n    // Detectar exportações\n    if (/^export\\s+(function|class|const|let|var|default)/.test(linha.trim())) {\n      temExportacaoPublica = true;\n    }\n\n    // Variáveis com nomes de uma letra (exceto loops, cast types, e contextos legítimos)\n    const singleLetterMatch = /\\b(const|let|var)\\s+([a-z])\\s*=/.exec(linha);\n    if (singleLetterMatch && !/for\\s*\\(/.test(linha) && !/while\\s*\\(/.test(linha)) {\n      const varNome = singleLetterMatch[2];\n      // Excluir variáveis legítimas: i, j, k em contexto de iteração, tipos (x as Type)\n      const isLoopContext = /\\b(i|j|k)\\s*=\\s*\\d+/.test(linha) || /\\b(i|j|k)\\s*[+\\-]=/.test(linha);\n      const isTipoCast = /as\\s+\\w+/.test(linha) || /:\\s*\\w+\\s*=/.test(linha);\n      if (!isLoopContext && !isTipoCast) {\n        problemas.push({\n          tipo: 'poor-naming',\n          descricao: `Variável '${varNome}' com nome de uma letra dificulta compreensão`,\n          prioridade: 'media',\n          linha: numeroLinha,\n          coluna: linha.indexOf(singleLetterMatch[0]) + 1,\n          contexto: linha.trim(),\n          sugestao: 'Use nomes descritivos para variáveis'\n        });\n      }\n    }\n\n    // Números mágicos (não em arrays ou comparações simples)\n    const numMagico = /\\b(\\d{2,})\\b/.exec(linha);\n    if (numMagico && !/(length|size|count)\\s*[=><!]/.test(linha) && !/\\[\\s*\\d+\\s*\\]/.test(linha) && parseInt(numMagico[1]) > 10) {\n      problemas.push({\n        tipo: 'magic-constants',\n        descricao: `Número mágico ${numMagico[1]} sem explicação`,\n        prioridade: 'baixa',\n        linha: numeroLinha,\n        coluna: linha.indexOf(numMagico[0]) + 1,\n        contexto: linha.trim(),\n        sugestao: 'Extraia para constante nomeada com comentário'\n      });\n    }\n\n    // Comentários TODO antigos (aproximação heurística)\n    if (/TODO.*\\d{4}/.test(linha)) {\n      const ano = /TODO.*(\\d{4})/.exec(linha)?.[1];\n      const anoAtual = new Date().getFullYear();\n      if (ano && anoAtual - parseInt(ano) > 1) {\n        problemas.push({\n          tipo: 'outdated-comments',\n          descricao: `TODO de ${ano} pode estar desatualizado`,\n          prioridade: 'baixa',\n          linha: numeroLinha,\n          coluna: linha.indexOf('TODO') + 1,\n          contexto: linha.trim(),\n          sugestao: 'Revisar e atualizar ou implementar TODO antigo'\n        });\n      }\n    }\n\n    // TypeScript: tipos 'any' sem comentário explicativo (exceto em strings literais)\n    if (/:\\s*any\\b/.test(linha) && !/\\/\\/|\\/\\*/.test(linha)) {\n      // Verificar se não está dentro de string (ex: const code = 'x: any')\n      const anyMatch = /:\\s*any\\b/.exec(linha);\n      if (anyMatch) {\n        const position = anyMatch.index;\n        const before = linha.substring(0, position);\n        // Contar aspas antes da posição\n        const singleQuotes = (before.match(/'/g) || []).length;\n        const doubleQuotes = (before.match(/\"/g) || []).length;\n        const backticks = (before.match(/`/g) || []).length;\n\n        // Se número ímpar de aspas, está dentro de string\n        const dentroDeString = singleQuotes % 2 !== 0 || doubleQuotes % 2 !== 0 || backticks % 2 !== 0;\n        if (!dentroDeString) {\n          problemas.push({\n            tipo: 'missing-types',\n            descricao: 'Tipo any sem justificativa via comentário',\n            prioridade: 'media',\n            linha: numeroLinha,\n            coluna: position + 1,\n            contexto: linha.trim(),\n            sugestao: 'Adicione comentário explicando uso de any ou use tipo mais específico'\n          });\n        }\n      }\n    }\n  });\n\n  // [BIBLIOTECA] DETECÇÃO INTELIGENTE DE FALTA DE DOCUMENTAÇÃO\n  // Apenas reportar se:\n  // 1. É arquivo de biblioteca pública (shared/, core/, lib/) E\n  // 2. Tem exportações públicas E\n  // 3. Não tem nenhum JSDoc E\n  // 4. Não é arquivo de teste/config/setup\n  if (isLibraryArquivo && temExportacaoPublica && !temJSDoc && !isInternalArquivo && src.length > 200) {\n    // Arquivo grande o suficiente para justificar documentação\n    problemas.push({\n      tipo: 'missing-jsdoc',\n      descricao: 'Arquivo de biblioteca pública sem documentação',\n      prioridade: 'media',\n      // Reduzido de 'alta' para 'media'\n      linha: 1,\n      coluna: 1,\n      contexto: 'Arquivo de biblioteca',\n      sugestao: 'Considere adicionar JSDoc para APIs públicas (funções/classes exportadas principais)'\n    });\n  }\n}\nfunction detectarProblemasDocumentacaoAST(ast: NodePath<Node>, problemas: ProblemaDocumentacao[]): void {\n  try {\n    ast.traverse({\n      // [ALVO] FILOSOFIA: Detectar apenas exports DEFAULT sem JSDoc\n      // Exports nomeados podem ser auto-explicativos pelo nome\n      ExportDefaultDeclaration(path) {\n        if ((path.node.declaration.type === 'FunctionDeclaration' || path.node.declaration.type === 'ClassDeclaration') && !path.node.leadingComments?.some(elem => elem.value.startsWith('*'))) {\n          problemas.push({\n            tipo: 'missing-jsdoc',\n            descricao: 'Export default (principal) sem JSDoc',\n            prioridade: 'media',\n            // Reduzido de 'alta'\n            linha: path.node.loc?.start.line || 0,\n            coluna: path.node.loc?.start.column || 0,\n            contexto: 'Export default',\n            sugestao: 'Documente a API principal do módulo para facilitar uso'\n          });\n        }\n      },\n      // Classes públicas complexas (>3 métodos) sem documentação\n      ClassDeclaration(path) {\n        const node = path.node;\n        if (node.body.body.length > 3 &&\n        // Apenas classes não-triviais\n        !node.leadingComments?.some(elem => elem.value.startsWith('*')) && node.id?.name && !node.id.name.toLowerCase().includes('test') && !node.id.name.toLowerCase().includes('mock')) {\n          // Verificar se é exportada\n          const parent = path.parent;\n          const isExported = parent.type === 'ExportNamedDeclaration' || parent.type === 'ExportDefaultDeclaration';\n          if (isExported) {\n            problemas.push({\n              tipo: 'missing-jsdoc',\n              descricao: `Classe pública ${node.id.name} (${node.body.body.length} membros) sem documentação`,\n              prioridade: 'media',\n              linha: node.loc?.start.line || 0,\n              coluna: node.loc?.start.column || 0,\n              contexto: 'ClassDeclaration',\n              sugestao: 'Documente o propósito e principais responsabilidades da classe'\n            });\n          }\n        }\n      }\n\n      // 🚫 REMOVIDO: Detecção de funções com muitos parâmetros\n      // Motivo: Gera muito ruído em código interno/utils\n      // Alternativa: Revisar code review manual ou usar linter específico\n    });\n  } catch {\n    // Ignorar erros de traverse\n  }\n}\nfunction agruparPorPrioridade(problemas: ProblemaDocumentacao[]): Record<string, ProblemaDocumentacao[]> {\n  return problemas.reduce((acc, problema) => {\n    const prioridade = problema.prioridade;\n    if (prioridade) {\n      if (!acc[prioridade]) {\n        acc[prioridade] = [];\n      }\n      acc[prioridade].push(problema);\n    }\n    return acc;\n  }, {} as Record<string, ProblemaDocumentacao[]>);\n}\nfunction mapearPrioridadeParaNivel(prioridade: ProblemaDocumentacao['prioridade']): 'info' | 'aviso' | 'erro' {\n  switch (prioridade) {\n    case 'alta':\n      return 'aviso';\n    // Documentação raramente é erro crítico\n    case 'media':\n      return 'aviso';\n    case 'baixa':\n    default:\n      return 'info';\n  }\n}"]}