tutanus 0.12.0

package/dist/analysts/python/corrections/correction-python.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"correction-python.js","sourceRoot":"","sources":["../../../../src/analysts/python/corrections/correction-python.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: MIT\n/**\n * [CHAVE-INGLESA] Correções automáticas para Python\n *\n * Fornece correções sugeridas para problemas comuns em Python:\n * - Bare except → except Exception\n * - Mutable defaults → None pattern\n * - print → logging\n */\n\nimport { maskPythonComments, splitLines } from '@shared/helpers';\n\nimport type { Analista, Ocorrencia } from '@';\nimport { criarOcorrencia } from '@';\n\nexport interface PythonCorrection {\n  tipo: string;\n  original: string;\n  sugerido: string;\n  linha: number;\n  confianca: number;\n}\nexport function detectarCorrecoesPython(src: string, _relPath: string): PythonCorrection[] {\n  const correcoes: PythonCorrection[] = [];\n  const scan = maskPythonComments(src);\n  const linhas = splitLines(scan);\n  linhas.forEach((linha, index) => {\n    const numeroLinha = index + 1;\n    if (/^\\s*except\\s*:/.test(linha)) {\n      correcoes.push({\n        tipo: 'python-bare-except',\n        original: linha.trim(),\n        sugerido: linha.replace(/except\\s*:/, 'except Exception:'),\n        linha: numeroLinha,\n        confianca: 95\n      });\n    }\n    if (/def\\s+\\w+\\s*\\([^)]*=\\s*(?:\\[|\\{)[^\\)]*\\)/.test(linha)) {\n      const match = linha.match(/def\\s+(\\w+)\\s*\\(([^)]*)\\)/);\n      if (match) {\n        correcoes.push({\n          tipo: 'python-mutable-default',\n          original: linha.trim(),\n          sugerido: `# Refatore: def ${match[1]}(${match[2].replace(/=\\s*(?:\\[|\\{)/, '=None')})`,\n          linha: numeroLinha,\n          confianca: 85\n        });\n      }\n    }\n    if (/^\\s*print\\s*\\(/.test(linha)) {\n      correcoes.push({\n        tipo: 'python-print-to-logging',\n        original: linha.trim(),\n        sugerido: linha.replace(/^\\s*print\\s*\\(/, 'logging.info('),\n        linha: numeroLinha,\n        confianca: 70\n      });\n    }\n  });\n  return correcoes;\n}\nexport const correctionPython: Analista = {\n  nome: 'correction-python',\n  categoria: 'framework',\n  descricao: 'Correções automáticas para problemas Python',\n  test: (relPath: string): boolean => /\\.(py|pyx|pyi)$/i.test(relPath),\n  aplicar: (src: string, relPath: string): Ocorrencia[] => {\n    if (!src) return [];\n    const correcoes = detectarCorrecoesPython(src, relPath);\n    return correcoes.map(elem => criarOcorrencia({\n      tipo: `correction-${elem.tipo}`,\n      nivel: elem.confianca > 85 ? 'aviso' : 'info',\n      mensagem: `Correção sugerida: ${elem.tipo}`,\n      relPath,\n      linha: elem.linha,\n      sugestao: `[ERRO] ${elem.original}\\n[OK] ${elem.sugerido}\\nConfiança: ${elem.confianca}%`\n    }));\n  }\n};"]}

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

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

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/analysts/python/corrections/index.ts"],"names":[],"mappings":"AACA,cAAc,wBAAwB,CAAC","sourcesContent":["// SPDX-License-Identifier: MIT\nexport * from './correction-python.js';\n"]}

package/dist/analysts/python/detectors/detector-python-best-practices.d.ts

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

package/dist/analysts/python/detectors/detector-python-best-practices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector-python-best-practices.d.ts","sourceRoot":"","sources":["../../../../src/analysts/python/detectors/detector-python-best-practices.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAc,MAAM,GAAG,CAAC;AAG9C,eAAO,MAAM,2BAA2B,EAAE,QA8FzC,CAAC"}

package/dist/analysts/python/detectors/detector-python-best-practices.js

@@ -0,0 +1,90 @@
+import { maskPythonComments, splitLines } from '../../../shared/helpers/index.js';
+import { criarOcorrencia } from '../../../types/index.js';
+export const detectorPythonBestPractices = {
+    nome: 'detector-python-best-practices',
+    categoria: 'framework',
+    descricao: 'Detecta más práticas em código Python',
+    test: (relPath) => /\.(py|pyx|pyi)$/i.test(relPath),
+    aplicar: (src, relPath) => {
+        if (!src)
+            return [];
+        const ocorrencias = [];
+        const scan = maskPythonComments(src);
+        const linhas = splitLines(scan);
+        linhas.forEach((linha, index) => {
+            const numeroLinha = index + 1;
+            if (/^\s*except\s*:/.test(linha)) {
+                ocorrencias.push(criarOcorrencia({
+                    tipo: 'python-bare-except',
+                    nivel: 'erro',
+                    mensagem: 'Bare except detectado - captura todas exceções incluindo SystemExit',
+                    relPath,
+                    linha: numeroLinha,
+                    sugestao: 'Use except Exception: ou exceção específica'
+                }));
+            }
+            if (/\beval\s*\(/.test(linha)) {
+                ocorrencias.push(criarOcorrencia({
+                    tipo: 'python-eval-usage',
+                    nivel: 'erro',
+                    mensagem: 'eval() detectado - risco de execução de código arbitrário',
+                    relPath,
+                    linha: numeroLinha,
+                    sugestao: 'Use ast.literal_eval() para dados seguros'
+                }));
+            }
+            if (/\bexec\s*\(/.test(linha)) {
+                ocorrencias.push(criarOcorrencia({
+                    tipo: 'python-exec-usage',
+                    nivel: 'erro',
+                    mensagem: 'exec() detectado - risco de execução de código arbitrário',
+                    relPath,
+                    linha: numeroLinha,
+                    sugestao: 'Evite exec(), refatore para funções dinâmicas seguras'
+                }));
+            }
+            if (/def\s+\w+\s*\([^)]*=\s*(?:\[|\{)/.test(linha)) {
+                ocorrencias.push(criarOcorrencia({
+                    tipo: 'python-mutable-default',
+                    nivel: 'aviso',
+                    mensagem: 'Argumento default mutável detectado',
+                    relPath,
+                    linha: numeroLinha,
+                    sugestao: 'Use None como default e inicialize dentro da função'
+                }));
+            }
+            if (/^\s*print\s*\(/.test(linha) && !/^\s*#/.test(linha)) {
+                ocorrencias.push(criarOcorrencia({
+                    tipo: 'python-print-instead-log',
+                    nivel: 'info',
+                    mensagem: 'print() usado ao invés de logging',
+                    relPath,
+                    linha: numeroLinha,
+                    sugestao: 'Use logging.info(), logging.debug(), etc.'
+                }));
+            }
+            if (/^\s*(?:async\s+)?def\s+\w+\s*\([^)]*\)(?!\s*->)/.test(linha) && !/def\s+(__init__|main|__|setUp|tearDown)/.test(linha)) {
+                ocorrencias.push(criarOcorrencia({
+                    tipo: 'python-missing-type-hints',
+                    nivel: 'info',
+                    mensagem: 'Função sem type hints',
+                    relPath,
+                    linha: numeroLinha,
+                    sugestao: 'Adicione type hints para parâmetros e retorno'
+                }));
+            }
+            if (/subprocess\.(run|Popen|call).*shell\s*=\s*True/.test(linha)) {
+                ocorrencias.push(criarOcorrencia({
+                    tipo: 'python-subprocess-shell',
+                    nivel: 'erro',
+                    mensagem: 'subprocess com shell=True - risco de injection',
+                    relPath,
+                    linha: numeroLinha,
+                    sugestao: 'Passe lista de argumentos ao invés de string com shell=True'
+                }));
+            }
+        });
+        return ocorrencias;
+    }
+};
+//# sourceMappingURL=detector-python-best-practices.js.map

package/dist/analysts/python/detectors/detector-python-best-practices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector-python-best-practices.js","sourceRoot":"","sources":["../../../../src/analysts/python/detectors/detector-python-best-practices.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: MIT\n/**\n * [BUSCA] Detector de boas práticas Python\n *\n * Detecta padrões problemáticos em Python:\n * - Bare except\n * - eval/exec usage\n * - Mutable default arguments\n * - Missing type hints\n * - print() instead of logging\n */\n\nimport { maskPythonComments, splitLines } from '@shared/helpers';\n\nimport type { Analista, Ocorrencia } from '@';\nimport { criarOcorrencia } from '@';\n\nexport const detectorPythonBestPractices: Analista = {\n  nome: 'detector-python-best-practices',\n  categoria: 'framework',\n  descricao: 'Detecta más práticas em código Python',\n  test: (relPath: string): boolean => /\\.(py|pyx|pyi)$/i.test(relPath),\n  aplicar: (src: string, relPath: string): Ocorrencia[] => {\n    if (!src) return [];\n    const ocorrencias: Ocorrencia[] = [];\n    const scan = maskPythonComments(src);\n    const linhas = splitLines(scan);\n\n    linhas.forEach((linha, index) => {\n      const numeroLinha = index + 1;\n\n      if (/^\\s*except\\s*:/.test(linha)) {\n        ocorrencias.push(criarOcorrencia({\n          tipo: 'python-bare-except',\n          nivel: 'erro',\n          mensagem: 'Bare except detectado - captura todas exceções incluindo SystemExit',\n          relPath,\n          linha: numeroLinha,\n          sugestao: 'Use except Exception: ou exceção específica'\n        }));\n      }\n\n      if (/\\beval\\s*\\(/.test(linha)) {\n        ocorrencias.push(criarOcorrencia({\n          tipo: 'python-eval-usage',\n          nivel: 'erro',\n          mensagem: 'eval() detectado - risco de execução de código arbitrário',\n          relPath,\n          linha: numeroLinha,\n          sugestao: 'Use ast.literal_eval() para dados seguros'\n        }));\n      }\n\n      if (/\\bexec\\s*\\(/.test(linha)) {\n        ocorrencias.push(criarOcorrencia({\n          tipo: 'python-exec-usage',\n          nivel: 'erro',\n          mensagem: 'exec() detectado - risco de execução de código arbitrário',\n          relPath,\n          linha: numeroLinha,\n          sugestao: 'Evite exec(), refatore para funções dinâmicas seguras'\n        }));\n      }\n\n      if (/def\\s+\\w+\\s*\\([^)]*=\\s*(?:\\[|\\{)/.test(linha)) {\n        ocorrencias.push(criarOcorrencia({\n          tipo: 'python-mutable-default',\n          nivel: 'aviso',\n          mensagem: 'Argumento default mutável detectado',\n          relPath,\n          linha: numeroLinha,\n          sugestao: 'Use None como default e inicialize dentro da função'\n        }));\n      }\n\n      if (/^\\s*print\\s*\\(/.test(linha) && !/^\\s*#/.test(linha)) {\n        ocorrencias.push(criarOcorrencia({\n          tipo: 'python-print-instead-log',\n          nivel: 'info',\n          mensagem: 'print() usado ao invés de logging',\n          relPath,\n          linha: numeroLinha,\n          sugestao: 'Use logging.info(), logging.debug(), etc.'\n        }));\n      }\n\n      if (/^\\s*(?:async\\s+)?def\\s+\\w+\\s*\\([^)]*\\)(?!\\s*->)/.test(linha) && !/def\\s+(__init__|main|__|setUp|tearDown)/.test(linha)) {\n        ocorrencias.push(criarOcorrencia({\n          tipo: 'python-missing-type-hints',\n          nivel: 'info',\n          mensagem: 'Função sem type hints',\n          relPath,\n          linha: numeroLinha,\n          sugestao: 'Adicione type hints para parâmetros e retorno'\n        }));\n      }\n\n      if (/subprocess\\.(run|Popen|call).*shell\\s*=\\s*True/.test(linha)) {\n        ocorrencias.push(criarOcorrencia({\n          tipo: 'python-subprocess-shell',\n          nivel: 'erro',\n          mensagem: 'subprocess com shell=True - risco de injection',\n          relPath,\n          linha: numeroLinha,\n          sugestao: 'Passe lista de argumentos ao invés de string com shell=True'\n        }));\n      }\n    });\n\n    return ocorrencias;\n  }\n};\n"]}

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

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

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/analysts/python/detectors/index.ts"],"names":[],"mappings":"AACA,cAAc,qCAAqC,CAAC","sourcesContent":["// SPDX-License-Identifier: MIT\nexport * from './detector-python-best-practices.js';\n"]}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/analysts/python/index.ts"],"names":[],"mappings":"AAOA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC"}

package/dist/analysts/python/index.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/analysts/python/index.ts"],"names":[],"mappings":"AAOA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC","sourcesContent":["// SPDX-License-Identifier: MIT\n/**\n * [BUSCA] Analistas de Python\n *\n * Heurísticas leves para Python (boas práticas e segurança).\n */\n\nexport * from './analysts/analyst-python.js';\nexport * from './corrections/index.js';\nexport * from './detectors/index.js';\nexport * from './scorers/index.js';\n"]}

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

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

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/analysts/python/scorers/index.ts"],"names":[],"mappings":"AACA,cAAc,oBAAoB,CAAC","sourcesContent":["// SPDX-License-Identifier: MIT\nexport * from './scorer-python.js';\n"]}

package/dist/analysts/python/scorers/scorer-python.d.ts

@@ -0,0 +1,15 @@
+export interface PythonScoreResult {
+    score: number;
+    maxScore: number;
+    percentage: number;
+    issues: string[];
+    strengths: string[];
+}
+export declare function pontuarPython(src: string, _relPath: string): PythonScoreResult;
+export declare const pontuadorPython: {
+    nome: string;
+    categoria: string;
+    descricao: string;
+    pontuar: typeof pontuarPython;
+};
+//# sourceMappingURL=scorer-python.d.ts.map

package/dist/analysts/python/scorers/scorer-python.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scorer-python.d.ts","sourceRoot":"","sources":["../../../../src/analysts/python/scorers/scorer-python.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CA2E9E;AAED,eAAO,MAAM,eAAe;;;;;CAK3B,CAAC"}

package/dist/analysts/python/scorers/scorer-python.js

@@ -0,0 +1,79 @@
+import { maskPythonComments, splitLines } from '../../../shared/helpers/index.js';
+export function pontuarPython(src, _relPath) {
+    let score = 0;
+    const maxScore = 100;
+    const issues = [];
+    const strengths = [];
+    const scan = maskPythonComments(src);
+    const _linhas = splitLines(scan);
+    const srcCompleto = scan;
+    const funcs = (srcCompleto.match(/def\s+\w+/g) || []).length;
+    const funcsWithHints = (srcCompleto.match(/def\s+\w+\s*\([^)]*\)\s*->/g) || []).length;
+    if (funcs > 0) {
+        const ratio = funcsWithHints / funcs;
+        score += Math.round(ratio * 25);
+        if (ratio > 0.8)
+            strengths.push('Boa cobertura de type hints');
+        else if (ratio > 0.5)
+            issues.push('Type hints parciais');
+        else
+            issues.push('Poucas funções com type hints');
+    }
+    else {
+        score += 25;
+    }
+    if (!/\b(eval|exec)\s*\(/.test(srcCompleto)) {
+        score += 20;
+        strengths.push('Sem uso de eval/exec');
+    }
+    else {
+        issues.push('eval/exec detectado - risco de segurança');
+    }
+    const bareExcept = (srcCompleto.match(/^\s*except\s*:/gm) || []).length;
+    if (bareExcept === 0) {
+        score += 20;
+        strengths.push('Error handling adequado');
+    }
+    else {
+        score += Math.max(0, 20 - bareExcept * 5);
+        issues.push(`${bareExcept} bare except(s) detectado(s)`);
+    }
+    const mutableDefaults = (srcCompleto.match(/def\s+\w+\s*\([^)]*=\s*(?:\[|\{)/g) || []).length;
+    if (mutableDefaults === 0) {
+        score += 15;
+        strengths.push('Sem argumentos default mutáveis');
+    }
+    else {
+        issues.push(`${mutableDefaults} função(ões) com default mutável`);
+    }
+    const printCount = (srcCompleto.match(/^\s*print\s*\(/gm) || []).length;
+    const loggingCount = (srcCompleto.match(/logging\.\w+\(/g) || []).length;
+    if (printCount === 0 || loggingCount > printCount) {
+        score += 10;
+        strengths.push('Uso adequado de logging');
+    }
+    else {
+        issues.push(`${printCount} print(s) - considere usar logging`);
+    }
+    if (!/subprocess.*shell\s*=\s*True/.test(srcCompleto)) {
+        score += 10;
+        strengths.push('Sem subprocess com shell=True');
+    }
+    else {
+        issues.push('subprocess com shell=True detectado');
+    }
+    return {
+        score,
+        maxScore,
+        percentage: Math.round((score / maxScore) * 100),
+        issues,
+        strengths
+    };
+}
+export const pontuadorPython = {
+    nome: 'pontuador-python',
+    categoria: 'framework',
+    descricao: 'Pontua qualidade de código Python',
+    pontuar: pontuarPython
+};
+//# sourceMappingURL=scorer-python.js.map

package/dist/analysts/python/scorers/scorer-python.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scorer-python.js","sourceRoot":"","sources":["../../../../src/analysts/python/scorers/scorer-python.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: MIT\n/**\n * [GRAFICO] Pontuador de qualidade Python\n *\n * Avalia a qualidade do código Python baseado em:\n * - Type hints coverage\n * - Security issues\n * - Error handling\n * - Code organization\n */\n\nimport { maskPythonComments, splitLines } from '@shared/helpers';\n\nexport interface PythonScoreResult {\n  score: number;\n  maxScore: number;\n  percentage: number;\n  issues: string[];\n  strengths: string[];\n}\n\nexport function pontuarPython(src: string, _relPath: string): PythonScoreResult {\n  let score = 0;\n  const maxScore = 100;\n  const issues: string[] = [];\n  const strengths: string[] = [];\n\n  const scan = maskPythonComments(src);\n  const _linhas = splitLines(scan);\n  const srcCompleto = scan;\n\n  // Type hints (25 pontos)\n  const funcs = (srcCompleto.match(/def\\s+\\w+/g) || []).length;\n  const funcsWithHints = (srcCompleto.match(/def\\s+\\w+\\s*\\([^)]*\\)\\s*->/g) || []).length;\n  if (funcs > 0) {\n    const ratio = funcsWithHints / funcs;\n    score += Math.round(ratio * 25);\n    if (ratio > 0.8) strengths.push('Boa cobertura de type hints');\n    else if (ratio > 0.5) issues.push('Type hints parciais');\n    else issues.push('Poucas funções com type hints');\n  } else {\n    score += 25;\n  }\n\n  // Sem eval/exec (20 pontos)\n  if (!/\\b(eval|exec)\\s*\\(/.test(srcCompleto)) {\n    score += 20;\n    strengths.push('Sem uso de eval/exec');\n  } else {\n    issues.push('eval/exec detectado - risco de segurança');\n  }\n\n  // Error handling (20 pontos)\n  const bareExcept = (srcCompleto.match(/^\\s*except\\s*:/gm) || []).length;\n  if (bareExcept === 0) {\n    score += 20;\n    strengths.push('Error handling adequado');\n  } else {\n    score += Math.max(0, 20 - bareExcept * 5);\n    issues.push(`${bareExcept} bare except(s) detectado(s)`);\n  }\n\n  // Sem mutable defaults (15 pontos)\n  const mutableDefaults = (srcCompleto.match(/def\\s+\\w+\\s*\\([^)]*=\\s*(?:\\[|\\{)/g) || []).length;\n  if (mutableDefaults === 0) {\n    score += 15;\n    strengths.push('Sem argumentos default mutáveis');\n  } else {\n    issues.push(`${mutableDefaults} função(ões) com default mutável`);\n  }\n\n  // Logging ao invés de print (10 pontos)\n  const printCount = (srcCompleto.match(/^\\s*print\\s*\\(/gm) || []).length;\n  const loggingCount = (srcCompleto.match(/logging\\.\\w+\\(/g) || []).length;\n  if (printCount === 0 || loggingCount > printCount) {\n    score += 10;\n    strengths.push('Uso adequado de logging');\n  } else {\n    issues.push(`${printCount} print(s) - considere usar logging`);\n  }\n\n  // Sem subprocess shell=True (10 pontos)\n  if (!/subprocess.*shell\\s*=\\s*True/.test(srcCompleto)) {\n    score += 10;\n    strengths.push('Sem subprocess com shell=True');\n  } else {\n    issues.push('subprocess com shell=True detectado');\n  }\n\n  return {\n    score,\n    maxScore,\n    percentage: Math.round((score / maxScore) * 100),\n    issues,\n    strengths\n  };\n}\n\nexport const pontuadorPython = {\n  nome: 'pontuador-python',\n  categoria: 'framework',\n  descricao: 'Pontua qualidade de código Python',\n  pontuar: pontuarPython\n};\n"]}

package/dist/analysts/react/analysts/analyst-react-hooks.d.ts

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

package/dist/analysts/react/analysts/analyst-react-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyst-react-hooks.d.ts","sourceRoot":"","sources":["../../../../src/analysts/react/analysts/analyst-react-hooks.ts"],"names":[],"mappings":"AAQA,OAAO,EAAiB,eAAe,EAAE,MAAM,GAAG,CAAC;AAGnD,KAAK,GAAG,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AA6J9C,eAAO,MAAM,kBAAkB;;;;;oBAKb,MAAM,KAAG,OAAO;+CACD,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;CASpD,CAAC"}

package/dist/analysts/react/analysts/analyst-react-hooks.js

@@ -0,0 +1,170 @@
+import { parse as babelParse } from '@babel/parser';
+import traverse from '@babel/traverse';
+import * as textoTitulo from '@babel/types';
+import { messages } from '../../../core/messages/index.js';
+import { criarAnalista, criarOcorrencia } from '../../../types/index.js';
+const disableEnv = process.env.TUTANUS_DISABLE_PLUGIN_REACT_HOOKS === '1';
+function hasHooksUsage(src) {
+    return /use(State|Effect|Memo|Callback|Reducer|Ref|LayoutEffect|ImperativeHandle|Transition)/.test(src);
+}
+function warn(message, relPath, line, nivel = messages.SeverityNiveis.warning) {
+    return criarOcorrencia({
+        relPath,
+        mensagem: message,
+        linha: line,
+        nivel,
+        origem: messages.AnalystOrigens.reactHooks,
+        tipo: messages.AnalystTipos.reactHooks
+    });
+}
+function extractHookCallContent(src, startIndex) {
+    let depth = 0;
+    let started = false;
+    let content = '';
+    for (let indice = startIndex; indice < src.length; indice++) {
+        const char = src[indice];
+        if (char === '(') {
+            depth++;
+            started = true;
+        }
+        else if (char === ')') {
+            depth--;
+        }
+        if (started) {
+            content += char;
+        }
+        if (started && depth === 0) {
+            break;
+        }
+    }
+    return content;
+}
+function collectHookIssues(src, relPath) {
+    const ocorrencias = [];
+    const effectMatches = [...src.matchAll(/use(Layout)?Effect\s*\(/g)];
+    effectMatches.forEach(metrica => {
+        const hookInicio = metrica.index ?? 0;
+        const fullCall = extractHookCallContent(src, hookInicio + metrica[0].length - 1);
+        const hasDepsArg = /,\s*(\[[\s\S]*?\]|\w+)\s*\)$/.test(fullCall);
+        const skip = /no-deps-ok|eslint-disable-next-line\s+react-hooks\/exhaustive-deps/i.test(fullCall);
+        if (!hasDepsArg && !skip) {
+            const line = src.slice(0, hookInicio).split(/\n/).length;
+            ocorrencias.push(warn(messages.ReactHooksMensagens.useEffectNoDeps, relPath, line));
+        }
+    });
+    const memoMatches = [...src.matchAll(/use(Memo|Callback)\s*\(/g)];
+    memoMatches.forEach(metrica => {
+        const hookInicio = metrica.index ?? 0;
+        const fullCall = extractHookCallContent(src, hookInicio + metrica[0].length - 1);
+        const hasDepsArg = /,\s*(\[[\s\S]*?\]|\w+)\s*\)$/.test(fullCall);
+        const skip = /no-deps-ok|eslint-disable-next-line\s+react-hooks\/exhaustive-deps/i.test(fullCall);
+        if (!hasDepsArg && !skip) {
+            const line = src.slice(0, hookInicio).split(/\n/).length;
+            ocorrencias.push(warn(messages.ReactHooksMensagens.memoCallbackNoDeps, relPath, line));
+        }
+    });
+    const conditionalHooks = [...src.matchAll(/(if|for|while)\s*\([^)]*\)\s*\{[\s\S]{0,160}?use[A-Z][A-Za-z0-9_]*/g)];
+    conditionalHooks.forEach(metrica => {
+        const line = src.slice(0, metrica.index || 0).split(/\n/).length;
+        ocorrencias.push(warn(messages.ReactHooksMensagens.hookInConditional, relPath, line));
+    });
+    return ocorrencias;
+}
+const traverseFn = traverse;
+function parseHooksWithBabel(src, relPath) {
+    const lower = relPath.toLowerCase();
+    const isTs = lower.endsWith('.ts') || lower.endsWith('.tsx');
+    const isJsxLike = lower.endsWith('.tsx') || lower.endsWith('.jsx');
+    try {
+        const plugins = ['decorators-legacy', 'classProperties', 'classPrivateProperties', 'classPrivateMethods', 'optionalChaining', 'nullishCoalescingOperator', 'topLevelAwait', 'importAttributes', 'importAssertions'];
+        if (isTs)
+            plugins.unshift('typescript');
+        if (isJsxLike)
+            plugins.unshift('jsx');
+        const ast = babelParse(src, {
+            sourceType: 'unambiguous',
+            errorRecovery: true,
+            plugins
+        });
+        const out = [];
+        const seen = new Set();
+        const pushOnce = (metrica) => {
+            const chave = `${metrica.mensagem}|${metrica.relPath}|${metrica.linha ?? 0}`;
+            if (seen.has(chave))
+                return;
+            seen.add(chave);
+            out.push(metrica);
+        };
+        const isHookCallee = (callee) => {
+            if (textoTitulo.isIdentifier(callee))
+                return {
+                    name: String(callee.name)
+                };
+            if (textoTitulo.isMemberExpression(callee)) {
+                const obj = callee.object;
+                const prop = callee.property;
+                const objNome = textoTitulo.isIdentifier(obj) ? String(obj.name) : '';
+                const propNome = textoTitulo.isIdentifier(prop) ? String(prop.name) : '';
+                if (objNome === 'React' && propNome)
+                    return {
+                        name: propNome
+                    };
+            }
+            return null;
+        };
+        const isEffectLike = (name) => name === 'useEffect' || name === 'useLayoutEffect';
+        const isMemoLike = (name) => name === 'useMemo' || name === 'useCallback';
+        const isAnyHook = (name) => /^use[A-Z0-9_]/.test(name);
+        const inConditionalOrLoop = (path) => {
+            return Boolean(path.findParent(caminho => caminho.isIfStatement() || caminho.isForStatement() || caminho.isWhileStatement() || caminho.isDoWhileStatement() || caminho.isSwitchStatement()));
+        };
+        const visitor = {
+            CallExpression(path) {
+                try {
+                    const calleeInfo = isHookCallee(path.node.callee);
+                    if (!calleeInfo)
+                        return;
+                    const name = calleeInfo.name;
+                    const locLine = path.node.loc?.start?.line;
+                    if (isEffectLike(name) && path.node.arguments.length < 2) {
+                        pushOnce(warn(messages.ReactHooksMensagens.useEffectNoDeps, relPath, locLine));
+                    }
+                    if (isMemoLike(name) && path.node.arguments.length < 2) {
+                        pushOnce(warn(messages.ReactHooksMensagens.memoCallbackNoDeps, relPath, locLine));
+                    }
+                    if (isAnyHook(name) && inConditionalOrLoop(path)) {
+                        pushOnce(warn(messages.ReactHooksMensagens.hookInConditional, relPath, locLine));
+                    }
+                }
+                catch {
+                }
+            }
+        };
+        traverseFn(ast, visitor);
+        return out;
+    }
+    catch {
+        return null;
+    }
+}
+export const analistaReactHooks = criarAnalista({
+    nome: 'analista-react-hooks',
+    categoria: 'framework',
+    descricao: 'Heurísticas leves de Hooks (sem ESLint).',
+    global: false,
+    test: (relPath) => /\.(jsx|tsx|js|ts)$/i.test(relPath),
+    aplicar: async (src, relPath) => {
+        if (disableEnv)
+            return null;
+        if (relPath.includes('src/analysts/react/analysts/analyst-react-hooks.ts'))
+            return null;
+        if (!hasHooksUsage(src))
+            return null;
+        const astMsgs = parseHooksWithBabel(src, relPath);
+        if (astMsgs !== null)
+            return astMsgs.length ? astMsgs : null;
+        const msgs = collectHookIssues(src, relPath);
+        return msgs.length ? msgs : null;
+    }
+});
+//# sourceMappingURL=analyst-react-hooks.js.map

package/dist/analysts/react/analysts/analyst-react-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyst-react-hooks.js","sourceRoot":"","sources":["../../../../src/analysts/react/analysts/analyst-react-hooks.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: MIT\nimport type { ParserPlugin as BabelParserPlugin } from '@babel/parser';\nimport { parse as babelParse } from '@babel/parser';\nimport type { NodePath, Visitor } from '@babel/traverse';\nimport traverse from '@babel/traverse';\nimport * as textoTitulo from '@babel/types';\nimport { messages } from '@core/messages';\n\nimport { criarAnalista, criarOcorrencia } from '@';\n\nconst disableEnv = process.env.TUTANUS_DISABLE_PLUGIN_REACT_HOOKS === '1';\ntype Msg = ReturnType<typeof criarOcorrencia>;\nfunction hasHooksUsage(src: string): boolean {\n  return /use(State|Effect|Memo|Callback|Reducer|Ref|LayoutEffect|ImperativeHandle|Transition)/.test(src);\n}\nfunction warn(message: string, relPath: string, line?: number, nivel = messages.SeverityNiveis.warning): Msg {\n  return criarOcorrencia({\n    relPath,\n    mensagem: message,\n    linha: line,\n    nivel,\n    origem: messages.AnalystOrigens.reactHooks,\n    tipo: messages.AnalystTipos.reactHooks\n  });\n}\n\n/**\n * Extrai o conteúdo completo de uma chamada de hook,\n * lidando corretamente com parênteses aninhados e arrays de dependências.\n */\nfunction extractHookCallContent(src: string, startIndex: number): string {\n  let depth = 0;\n  let started = false;\n  let content = '';\n  for (let indice = startIndex; indice < src.length; indice++) {\n    const char = src[indice];\n    if (char === '(') {\n      depth++;\n      started = true;\n    } else if (char === ')') {\n      depth--;\n    }\n    if (started) {\n      content += char;\n    }\n    if (started && depth === 0) {\n      break;\n    }\n  }\n  return content;\n}\nfunction collectHookIssues(src: string, relPath: string): Msg[] {\n  const ocorrencias: Msg[] = [];\n\n  // useEffect/useLayoutEffect sem array de dependências\n  const effectMatches = [...src.matchAll(/use(Layout)?Effect\\s*\\(/g)];\n  effectMatches.forEach(metrica => {\n    const hookInicio = metrica.index ?? 0;\n    const fullCall = extractHookCallContent(src, hookInicio + metrica[0].length - 1);\n\n    // Verificar se tem segundo argumento (array de dependências)\n    // Padrão: (callback, [deps]) ou (callback, deps)\n    // Um array vazio [] conta como dependências válidas\n    const hasDepsArg = /,\\s*(\\[[\\s\\S]*?\\]|\\w+)\\s*\\)$/.test(fullCall);\n    const skip = /no-deps-ok|eslint-disable-next-line\\s+react-hooks\\/exhaustive-deps/i.test(fullCall);\n    if (!hasDepsArg && !skip) {\n      const line = src.slice(0, hookInicio).split(/\\n/).length;\n      ocorrencias.push(warn(messages.ReactHooksMensagens.useEffectNoDeps, relPath, line));\n    }\n  });\n\n  // useMemo/useCallback sem deps\n  const memoMatches = [...src.matchAll(/use(Memo|Callback)\\s*\\(/g)];\n  memoMatches.forEach(metrica => {\n    const hookInicio = metrica.index ?? 0;\n    const fullCall = extractHookCallContent(src, hookInicio + metrica[0].length - 1);\n\n    // Verificar se tem segundo argumento (array de dependências)\n    const hasDepsArg = /,\\s*(\\[[\\s\\S]*?\\]|\\w+)\\s*\\)$/.test(fullCall);\n    const skip = /no-deps-ok|eslint-disable-next-line\\s+react-hooks\\/exhaustive-deps/i.test(fullCall);\n    if (!hasDepsArg && !skip) {\n      const line = src.slice(0, hookInicio).split(/\\n/).length;\n      ocorrencias.push(warn(messages.ReactHooksMensagens.memoCallbackNoDeps, relPath, line));\n    }\n  });\n\n  // Hooks dentro de condicionais (heurística simples)\n  const conditionalHooks = [...src.matchAll(/(if|for|while)\\s*\\([^)]*\\)\\s*\\{[\\s\\S]{0,160}?use[A-Z][A-Za-z0-9_]*/g)];\n  conditionalHooks.forEach(metrica => {\n    const line = src.slice(0, metrica.index || 0).split(/\\n/).length;\n    ocorrencias.push(warn(messages.ReactHooksMensagens.hookInConditional, relPath, line));\n  });\n  return ocorrencias;\n}\nconst traverseFn = traverse as unknown as typeof import('@babel/traverse').default;\nfunction parseHooksWithBabel(src: string, relPath: string): Msg[] | null {\n  const lower = relPath.toLowerCase();\n  const isTs = lower.endsWith('.ts') || lower.endsWith('.tsx');\n  const isJsxLike = lower.endsWith('.tsx') || lower.endsWith('.jsx');\n  try {\n    const plugins: BabelParserPlugin[] = ['decorators-legacy', 'classProperties', 'classPrivateProperties', 'classPrivateMethods', 'optionalChaining', 'nullishCoalescingOperator', 'topLevelAwait', 'importAttributes', 'importAssertions'];\n    if (isTs) plugins.unshift('typescript');\n    if (isJsxLike) plugins.unshift('jsx');\n    const ast = babelParse(src, {\n      sourceType: 'unambiguous',\n      errorRecovery: true,\n      plugins\n    });\n    const out: Msg[] = [];\n    const seen = new Set<string>();\n    const pushOnce = (metrica: Msg) => {\n      const chave = `${metrica.mensagem}|${metrica.relPath}|${metrica.linha ?? 0}`;\n      if (seen.has(chave)) return;\n      seen.add(chave);\n      out.push(metrica);\n    };\n    const isHookCallee = (callee: textoTitulo.CallExpression['callee']): {\n      name: string;\n    } | null => {\n      if (textoTitulo.isIdentifier(callee)) return {\n        name: String(callee.name)\n      };\n      if (textoTitulo.isMemberExpression(callee)) {\n        const obj = callee.object;\n        const prop = callee.property;\n        const objNome = textoTitulo.isIdentifier(obj) ? String(obj.name) : '';\n        const propNome = textoTitulo.isIdentifier(prop) ? String(prop.name) : '';\n        if (objNome === 'React' && propNome) return {\n          name: propNome\n        };\n      }\n      return null;\n    };\n    const isEffectLike = (name: string) => name === 'useEffect' || name === 'useLayoutEffect';\n    const isMemoLike = (name: string) => name === 'useMemo' || name === 'useCallback';\n    const isAnyHook = (name: string) => /^use[A-Z0-9_]/.test(name);\n    const inConditionalOrLoop = (path: NodePath<textoTitulo.CallExpression>): boolean => {\n      return Boolean(path.findParent(caminho => caminho.isIfStatement() || caminho.isForStatement() || caminho.isWhileStatement() || caminho.isDoWhileStatement() || caminho.isSwitchStatement()));\n    };\n    const visitor: Visitor<unknown> = {\n      CallExpression(path: NodePath<textoTitulo.CallExpression>) {\n        try {\n          const calleeInfo = isHookCallee(path.node.callee);\n          if (!calleeInfo) return;\n          const name = calleeInfo.name;\n          const locLine: number | undefined = path.node.loc?.start?.line;\n          if (isEffectLike(name) && path.node.arguments.length < 2) {\n            pushOnce(warn(messages.ReactHooksMensagens.useEffectNoDeps, relPath, locLine));\n          }\n          if (isMemoLike(name) && path.node.arguments.length < 2) {\n            pushOnce(warn(messages.ReactHooksMensagens.memoCallbackNoDeps, relPath, locLine));\n          }\n          if (isAnyHook(name) && inConditionalOrLoop(path)) {\n            pushOnce(warn(messages.ReactHooksMensagens.hookInConditional, relPath, locLine));\n          }\n        } catch {\n          // ignora\n        }\n      }\n    };\n    traverseFn(ast, visitor);\n    // Importante: retorna array (mesmo vazio) quando o parse foi bem-sucedido,\n    // para evitar cair no fallback regex (que é mais frágil e ruidoso).\n    return out;\n  } catch {\n    return null;\n  }\n}\nexport const analistaReactHooks = criarAnalista({\n  nome: 'analista-react-hooks',\n  categoria: 'framework',\n  descricao: 'Heurísticas leves de Hooks (sem ESLint).',\n  global: false,\n  test: (relPath: string): boolean => /\\.(jsx|tsx|js|ts)$/i.test(relPath),\n  aplicar: async (src, relPath): Promise<Msg[] | null> => {\n    if (disableEnv) return null;\n    if (relPath.includes('src/analysts/react/analysts/analyst-react-hooks.ts')) return null;\n    if (!hasHooksUsage(src)) return null;\n    const astMsgs = parseHooksWithBabel(src, relPath);\n    if (astMsgs !== null) return astMsgs.length ? astMsgs : null;\n    const msgs = collectHookIssues(src, relPath);\n    return msgs.length ? msgs : null;\n  }\n});"]}

package/dist/analysts/react/analysts/analyst-react.d.ts

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

package/dist/analysts/react/analysts/analyst-react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyst-react.d.ts","sourceRoot":"","sources":["../../../../src/analysts/react/analysts/analyst-react.ts"],"names":[],"mappings":"AASA,OAAO,EAAiB,eAAe,EAAE,MAAM,GAAG,CAAC;AAGnD,KAAK,GAAG,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAwV9C,eAAO,MAAM,aAAa;;;;;oBAKR,MAAM,KAAG,OAAO;+CACD,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;CA6BpD,CAAC"}