@mocoto/mahoraga 0.14.8 → 0.15.0

package/dist/analysts/js-ts/detectors/detector-types-unsafe.js

@@ -1,15 +1,3 @@
-// @mahoraga-disable ml-alta-probabilidade-bugs ml-deep-nesting
-// SPDX-License-Identifier: MIT
-/**
- * Detector de tipos inseguros (any e unknown) - Versão Inteligente
- * Identifica uso de any e unknown com análise contextual avançada
- *
- * Estratégia:
- * - Analisa contexto para determinar legitimidade do uso
- * - Sugere alternativas específicas quando possível
- * - Explica variantes e possibilidades quando análise é incerta
- * - Sempre recomenda revisão manual para casos complexos
- */
 import { config } from '../../../core/config/index.js';
 import { messages } from '../../../core/messages/index.js';
 import { categorizarUnknown, extractVariableName, isAnyInGenericFunction, isInStringOrComment, isLegacyOrVendorFile, isTypeScriptContext, isUnknownInGenericContext } from '../../corrections/type-safety/index.js';
@@ -23,43 +11,32 @@ const ANALISTA = {
     },
     aplicar: (srcParam, relPath, _ast, fullCaminho) => {
         const ocorrencias = [];
-        // IMPORTANTE: Normalização de line endings para compatibilidade Windows/Linux
-        // Sem isso, arquivos com \r\n causam split('\n') incorreto (retorna 1 linha)
-        // Ver: docs/reports/DEBUG-TYPE-SAFETY-DETECTOR-2025-11-03.md
         const src = srcParam.replace(/\r\n/g, '\n');
         const allowAnyInTests = Boolean(config.testPadroes?.allowAnyType);
         if (allowAnyInTests && isTestArquivo(fullCaminho ?? relPath)) {
             return ocorrencias;
         }
-        // Verificar se é arquivo que deve ser ignorado
         if (isLegacyOrVendorFile(fullCaminho ?? relPath)) {
             return ocorrencias;
         }
-        // Detectar uso de any
         const anyPadrao = /:\s*(any|NonNullable<any>|Partial<any>|Omit<any,\s*[^>]+>|Pick<any,\s*[^>]+>)\b/g;
         let anyMatch;
         while ((anyMatch = anyPadrao.exec(src)) !== null) {
             const position = anyMatch.index ?? 0;
-            // Pular se estiver em string ou comentário
             if (isInStringOrComment(src, position)) {
                 continue;
             }
-            // Pular se estiver em contexto TypeScript específico (type assertions)
             if (isTypeScriptContext(src, position)) {
                 continue;
             }
-            // Pular se any está em função genérica apropriada
             if (isAnyInGenericFunction(src, position)) {
                 continue;
             }
-            // Extrair nome da variável e contexto
             const varNome = extractVariableName(anyMatch, src);
             const linha = splitLines(src.substring(0, position)).length;
             const lineContext = splitLines(src)[linha - 1]?.trim() || '';
-            // Análise contextual para any
             let mensagem = '';
             let sugestao = '';
-            // Detectar padrões específicos
             if (anyMatch[1] !== 'any') {
                 mensagem = messages.DetectorJsTsMensagens.tipoAnyComUtilidade(varNome ?? '', anyMatch[1]);
                 sugestao = messages.DetectorJsTsMensagens.tipoAnyComUtilidadeSugestao(anyMatch[1]);
@@ -100,7 +77,6 @@ const ANALISTA = {
                 contextoAdicional = messages.DetectorJsTsMensagens.contextoAdicionalCore;
             }
             const mensagemCompleta = `${mensagem} | [IDEIA] ${sugestao}${contextoAdicional}${messages.DetectorJsTsMensagens.revisaoManual}`;
-            // Verifica se regra está suprimida para este arquivo
             if (shouldSuppressOccurrence('tipo-inseguro-any', relPath)) {
                 continue;
             }
@@ -113,7 +89,6 @@ const ANALISTA = {
                 contexto: lineContext
             });
         }
-        // ─── DETECTAR Object e {} (tipos fracos) ──────────────────────
         const tiposFracosPadrao = /:\s*(Object|\{\})(?![a-zA-Z0-9_$])/g;
         let matchFraco;
         while ((matchFraco = tiposFracosPadrao.exec(src)) !== null) {
@@ -121,7 +96,6 @@ const ANALISTA = {
             if (isInStringOrComment(src, position)) {
                 continue;
             }
-            // Pular se Object é usado como método estático (ex: Object.keys(), Object.create())
             const antesObj = src.substring(Math.max(0, position - 10), position);
             if (/Object\s*\.\s*$/.test(antesObj)) {
                 continue;
@@ -129,46 +103,32 @@ const ANALISTA = {
             const linha = splitLines(src.substring(0, position)).length;
             const lineContext = splitLines(src)[linha - 1]?.trim() || '';
             const tipo = matchFraco[1];
-            // Filtrar contextos legítimos onde {} é aceitável
-            // 1. Inicialização de objeto vazio: prop?: {} = {}
-            // 2. Partial types: Partial<SomeType> - contexto válido
-            // 3. Parâmetros opcionais com valor padrão
-            // 4. Type assertions em objetos reais (não tipagem explícita)
             const antes = src.substring(Math.max(0, position - 30), position);
             const depois = lineContext.substring(lineContext.indexOf(':') + 1);
-            // Pular se é inicialização de objeto vazio (prop?: {} = {})
             if (/\?\s*:\s*\{\}\s*=/.test(`${antes}: {}`)) {
                 continue;
             }
-            // Pular se é parâmetro de função com valor default
             if (/\?\s*:\s*\{\}\s*[=,)]/.test(antes)) {
                 continue;
             }
-            // Pular se é parte de Partial/Required/Readonly
             if (/Partial<|Required<|Readonly<|\}\?$/.test(antes)) {
                 continue;
             }
-            // Pular se é em contexto de catch block
             if (/catch\s*\([^)]*:\s*\{\}/.test(lineContext)) {
                 continue;
             }
-            // Pular se é inicialização de objeto vazio: algo = {}
             if (depois.trim().startsWith('=')) {
                 continue;
             }
-            // Pular se é parâmetro de função com default: : {} = ou : {} ,
             if (/^\s*\{?\s*\}\s*[,=)]/.test(depois)) {
                 continue;
             }
-            // Pular se é valor de propriedade em objeto: chave: {}
             if (/\w+\s*:\s*\{\}\s*$/.test(lineContext)) {
                 continue;
             }
-            // Pular se é spread com objeto vazio condicional: ...cond ? {x} : {}
             if (/\?\s*\{[^}]*\}\s*:\s*\{\}/.test(lineContext)) {
                 continue;
             }
-            // Pular se é ternário com objeto vazio como fallback
             if (/:\s*\{\}\s*$/.test(lineContext.trim())) {
                 continue;
             }
@@ -186,18 +146,15 @@ const ANALISTA = {
                 contexto: lineContext
             });
         }
-        // ─── DETECTAR TYPE ASSERTIONS (as any) ────────────────────────
         const asAnyPadrao = /\b(as\s+any)\b/g;
         let asAnyMatch;
         while ((asAnyMatch = asAnyPadrao.exec(src)) !== null) {
             const position = asAnyMatch.index ?? 0;
-            // Pular se estiver em string ou comentário
             if (isInStringOrComment(src, position)) {
                 continue;
             }
             const linha = splitLines(src.substring(0, position)).length;
             const lineContext = splitLines(src)[linha - 1]?.trim() || '';
-            // Extrair contexto da expressão
             const after = src.substring(position, Math.min(src.length, position + 50));
             const mensagem = messages.DetectorJsTsMensagens.typeAssertionAny;
             let sugestao = '';
@@ -214,33 +171,28 @@ const ANALISTA = {
                 sugestao = messages.DetectorJsTsMensagens.assertionCastGenericoSugestao;
             }
             const mensagemCompleta = `${mensagem} | [IDEIA] ${sugestao}${messages.DetectorJsTsMensagens.assertionCritico}${messages.DetectorJsTsMensagens.revisaoManual}`;
-            // Verifica se regra está suprimida para este arquivo
             if (shouldSuppressOccurrence('tipo-inseguro-any-assertion', relPath)) {
                 continue;
             }
             ocorrencias.push({
                 tipo: 'tipo-inseguro-any-assertion',
                 nivel: 'erro',
-                // Mais severo que declaração de tipo
                 mensagem: mensagemCompleta,
                 relPath,
                 linha,
                 contexto: lineContext
             });
         }
-        // ─── DETECTAR ANGLE BRACKET CASTING (<any>) ───────────────────
         const angleBracketPadrao = /<any>/g;
         let angleBracketMatch;
         while ((angleBracketMatch = angleBracketPadrao.exec(src)) !== null) {
             const position = angleBracketMatch.index ?? 0;
-            // Pular se estiver em string ou comentário
             if (isInStringOrComment(src, position)) {
                 continue;
             }
             const linha = splitLines(src.substring(0, position)).length;
             const lineContext = splitLines(src)[linha - 1]?.trim() || '';
             const mensagemCompleta = `${messages.DetectorJsTsMensagens.angleBracketCast}${messages.DetectorJsTsMensagens.revisaoManual}`;
-            // Verifica se regra está suprimida para este arquivo
             if (shouldSuppressOccurrence('tipo-inseguro-any-cast', relPath)) {
                 continue;
             }
@@ -253,28 +205,6 @@ const ANALISTA = {
                 contexto: lineContext
             });
         }
-        // ─── DETECTAR 'as' QUE PODEM SER SUBSTITUÍDOS POR 'satisfies' ─
-        // Referência: https://www.typescriptlang.org/docs/handbook/release-notes/typescript-4-9.html#the-satisfies-operator
-        //
-        // PRINCÍPIO FUNDAMENTAL:
-        //   'as' (type assertion) MUDA o tipo da expressão — pode estreitar (narrow)
-        //   de unknown→concreto, string→union, tipo→subtipo, ou até mentir.
-        //   'satisfies' apenas VALIDA — o tipo da expressão permanece o original.
-        //
-        //   Portanto, 'satisfies' SÓ pode substituir 'as' sem quebrar o código
-        //   quando a expressão é um LITERAL (objeto {...} ou array [...]).
-        //   Nesse caso, 'satisfies' é ESTRITAMENTE MELHOR: valida a constraint
-        //   sem widen (perda de inferência precisa).
-        //
-        //   Para QUALQUER outra expressão (variável, função, propriedade, acesso
-        //   indexado, parênteses, operador), 'as' está fazendo narrowing que
-        //   'satisfies' não replica — NUNCA sugerir satisfies.
-        //
-        // Exemplo clássico onde satisfies é melhor:
-        //   const x = { red: [255,0,0], blue: [0,0,255] } as Record<string, number[]>
-        //   → perde inferência de 'red' e 'blue' como tuplas
-        //   const x = { red: [255,0,0], blue: [0,0,255] } satisfies Record<string, number[]>
-        //   → valida a constraint, mantém inferência precisa das tuplas
         const asTypePadrao = /\bas\s+([A-Za-z_$][A-Za-z0-9_$.]+)\b(?!\s*[=(])/g;
         let asTypeMatch;
         while ((asTypeMatch = asTypePadrao.exec(src)) !== null) {
@@ -285,71 +215,36 @@ const ANALISTA = {
             const linha = splitLines(src.substring(0, position)).length;
             const lineContext = splitLines(src)[linha - 1]?.trim() || '';
             const tipoAsserido = asTypeMatch[1];
-            // Skip 'as any' — já detectado em seção anterior como erro
-            // Skip 'as const' — é literal narrowing, não type assertion
             if (tipoAsserido === 'any' || tipoAsserido === 'const') {
                 continue;
             }
-            // ─── FILTROS DE SEGURANÇA: padrões que NUNCA devem sugerir satisfies ───
-            // Import/export rename: 'import { x as y }', 'export { x as y }'
-            // Pega linhas que começam com import/export E linhas de continuação
-            // dentro de blocos import { ... } (linhas indentadas com 'as' entre vírgulas)
             if (/^(import|export)\b/.test(lineContext)) {
                 continue;
             }
-            // Detecta 'as' dentro de blocos import/export em linhas de continuação:
-            // Padrão: linha indentada com 'identificador as identificador,' e há
-            // um import/export nas linhas anteriores próximas
             const windowBefore = src.slice(Math.max(0, position - 500), position);
             if (/^\s+\w+\s+as\s+\w+,?\s*$/.test(lineContext) &&
                 /(?:^|\n)\s*(?:import|export)\s*\{/.test(windowBefore)) {
                 continue;
             }
-            // Skip 'as' dentro de template literal ${...}
             const beforePos = src.slice(Math.max(0, position - 120), position);
             if (lineContext.includes('${') || beforePos.includes('${')) {
                 continue;
             }
-            // Skip dupla asserção 'unknown as'
             if (lineContext.includes('unknown as')) {
                 continue;
             }
-            // Skip em arrow function: (x) => x as Type
             if (/=>\s*\(?[^)]*\)?\s*as\s+\w+/.test(lineContext)) {
                 continue;
             }
-            // ─── VERIFICAÇÃO PRINCIPAL: expressão antes de 'as' é literal? ───
-            //
-            // A única situação onde 'satisfies' pode substituir 'as' com segurança
-            // é quando a expressão é um literal objeto `{...}` ou array `[...]`.
-            //
-            // Diferente da abordagem anterior (que usava 120 chars de janela e
-            // podia capturar { de linhas anteriores), aqui extraímos APENAS o
-            // texto na MESMA LINHA antes de 'as'.
-            //
-            // Critérios para identificar literal:
-            //   1. Objeto: texto (após remover declaração) começa com '{' e termina com '}'
-            //   2. Array: texto (após remover declaração) começa com '[' e termina com ']'
-            //   3. '{}' vazio → sentinel, pular
-            //
-            // Isso diferencia corretamente:
-            //   - `{ a: 1 } as T` → objeto literal ✓
-            //   - `[1, 2] as T` → array literal ✓
-            //   - `arr[i] as T` → index access (começa com 'a', não '[') ✗
-            //   - `found.ast as T` → property access (começa com 'f') ✗
-            //   - `framework as T` → variável simples ✗
             const lineText = splitLines(src)[linha - 1];
             const colMatch = src.lastIndexOf('\n', Math.max(0, position - 1));
             const posInLine = position - (colMatch >= 0 ? colMatch + 1 : 0);
             const textBeforeOnLine = lineText.substring(0, Math.max(0, posInLine - 'as'.length)).trimEnd();
-            // Remove declaração (const/let/var/return/yield) para ver a expressão pura
             const exprText = textBeforeOnLine
                 .replace(/^(?:const|let|var|return|yield)\s+\w+\s*=\s*/, '')
                 .trim();
-            // Verifica se é literal: abre e fecha com {}/{ ou [ /]
             const isObjectLiteral = /\}\s*$/.test(exprText) && /^\s*\{/.test(exprText) && !/^\s*\{\s*\}\s*$/.test(exprText);
             const isArrayLiteral = /\]\s*$/.test(exprText) && /^\s*\[/.test(exprText);
-            // Se NÃO é literal → é narrowing, NUNCA sugerir satisfies
             if (!isObjectLiteral && !isArrayLiteral) {
                 continue;
             }
@@ -366,36 +261,28 @@ const ANALISTA = {
                 contexto: lineContext
             });
         }
-        // Detectar uso de unknown
         const unknownPadrao = /:\s*unknown\b/g;
         let unknownMatch;
         while ((unknownMatch = unknownPadrao.exec(src)) !== null) {
             const position = unknownMatch.index ?? 0;
-            // Pular se estiver em string ou comentário
             if (isInStringOrComment(src, position)) {
                 continue;
             }
-            // Pular se unknown está em contexto genérico apropriado (validação básica)
             if (isUnknownInGenericContext(src, position)) {
                 continue;
             }
-            // Análise contextual inteligente
             const linha = splitLines(src.substring(0, position)).length;
             const lineContext = splitLines(src)[linha - 1]?.trim() || '';
             const categorizacao = categorizarUnknown(src, fullCaminho ?? relPath, lineContext);
-            // Extrair nome da variável
             const varNome = extractVariableName(unknownMatch, src);
-            // Construir mensagem baseada na categorização
             let mensagem = '';
             let nivel;
             if (categorizacao.categoria === 'legitimo') {
-                // Legítimo com alta confiança (>=95%) - PULAR completamente
                 if (categorizacao.confianca >= 95) {
                     continue;
                 }
                 mensagem = messages.DetectorJsTsMensagens.unknownLegitimo(varNome ?? undefined, categorizacao.motivo);
                 nivel = 'info';
-                // Se tem sugestão, adicionar
                 if (categorizacao.sugestao) {
                     mensagem += ` | [IDEIA] ${categorizacao.sugestao}`;
                 }
@@ -421,7 +308,6 @@ const ANALISTA = {
                 }
                 mensagem += messages.DetectorJsTsMensagens.unknownRevisaoObrigatoria;
             }
-            // Verifica se regra está suprimida para este arquivo
             if (shouldSuppressOccurrence('tipo-inseguro-unknown', relPath)) {
                 continue;
             }

package/dist/analysts/js-ts/detectors/index.js

@@ -1,7 +1,3 @@
-// SPDX-License-Identifier: MIT
-/**
- * @fileoverview Detectores específicos de JavaScript/TypeScript
- */
 export * from './detector-anti-patterns-async.js';
 export * from './detector-constructions-syntactic.js';
 export * from './detector-context-smart.js';

package/dist/analysts/js-ts/index.js

@@ -1,7 +1,3 @@
-// SPDX-License-Identifier: MIT
-/**
- * @fileoverview Analistas específicos de JavaScript/TypeScript
- */
 export * from './analysts/index.js';
 export * from './detectors/index.js';
 export * from './registrar.js';

package/dist/analysts/js-ts/registrar.js

@@ -1,7 +1,3 @@
-// SPDX-License-Identifier: MIT
-/**
- * @fileoverview Sistema de registro de detectores JS/TS
- */
 const detectoresJsTs = [];
 export function registrarDetectorJsTs(detector) {
     if (!detector || !detector.nome) {

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

@@ -1,9 +1,7 @@
-// @mahoraga-disable ml-deep-nesting
-// SPDX-License-Identifier: MIT
 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.SUKUNA_DISABLE_PLUGIN_PHP === '1';
+const disableEnv = process.env.MAHORAGA_DISABLE_PLUGIN_PHP === '1';
 function isPhpFile(relPath) {
     return /\.(php|phtml|php3|php4|php5|php7|php8)$/i.test(relPath);
 }
@@ -20,68 +18,54 @@ function warn(message, relPath, line, nivel) {
 function collectPhpIssues(src, relPath) {
     const ocorrencias = [];
     const lineOf = createLineLookup(src).lineAt;
-    // Reduz falsos positivos mascarando strings
     const scanWithoutStrings = src.replace(/['"`][^'"]*['"`]/g, '""');
-    // --- Security: SQL injection (mysql_query, mysqli_query, etc) ---
     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));
     }
-    // --- Security: eval() usage ---
     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));
     }
-    // --- Security: assert() with string (code injection) ---
     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));
     }
-    // --- Security: unserialize() ---
     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));
     }
-    // --- Security: extract() ---
     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));
     }
-    // --- Security: file_get_contents with URL ---
     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));
     }
-    // --- Security: system/exec/shell_exec/passthru ---
     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));
     }
-    // --- Security: $_REQUEST usage ---
     for (const match of scanWithoutStrings.matchAll(/\$_REQUEST\b/gi)) {
         const line = lineOf(match.index);
         ocorrencias.push(warn(messages.PhpMensagens.requestUsage, relPath, line));
     }
-    // --- Security: hardcoded secrets ---
     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));
     }
-    // --- Code Quality: deprecated mysql_* functions ---
     for (const match of scanWithoutStrings.matchAll(/\bmysql_\w+\s*\(/gi)) {
         const line = lineOf(match.index);
         ocorrencias.push(warn(messages.PhpMensagens.deprecatedMysql, relPath, line));
     }
-    // --- Code Quality: short_open_tag ---
     if (/^<\?[^=phHP\r\n]/m.test(src)) {
         ocorrencias.push(warn(messages.PhpMensagens.shortOpenTag, relPath, 1));
     }
-    // --- Code Quality: error suppression (@) ---
     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));
     }
-    // --- Code Quality: long function/method ---
     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 + funcMatch[0].length;
@@ -103,14 +87,12 @@ function collectPhpIssues(src, relPath) {
             ocorrencias.push(warn(messages.PhpMensagens.longFunction, relPath, line));
         }
     }
-    // --- Code Quality: var_dump/die in production ---
     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));
         }
     }
-    // --- Style: naming convention (snake_case) ---
     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)) {

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

@@ -1,2 +1 @@
-// SPDX-License-Identifier: MIT
 export {};

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

@@ -1,14 +1,11 @@
-// @mahoraga-disable ml-deep-nesting
-// SPDX-License-Identifier: MIT
 import { messages } from '../../../core/messages/index.js';
 import { createLineLookup, maskPhpComments } from '../../../shared/helpers/index.js';
 import { criarAnalista } from '../../../types/index.js';
-const disableEnv = process.env.SUKUNA_DISABLE_PLUGIN_PHP === '1';
+const disableEnv = process.env.MAHORAGA_DISABLE_PLUGIN_PHP === '1';
 function detectBestPracticesIssues(src, relPath) {
     const ocorrencias = [];
     const lineOf = createLineLookup(src).lineAt;
     const scan = maskPhpComments(src);
-    // Missing strict types declaration
     if (/^<\?php/i.test(src) && !/^<\?php\s+declare\s*\(\s*strict_types\s*=\s*1\s*\)/im.test(src)) {
         ocorrencias.push({
             relPath,
@@ -19,7 +16,6 @@ function detectBestPracticesIssues(src, relPath) {
             tipo: 'php/rule'
         });
     }
-    // Deprecated functions
     const deprecatedFns = [
         /\bmysql_\w+\s*\(/gi,
         /\bereg(?:_\w+)?\s*\(/gi,
@@ -46,7 +42,6 @@ function detectBestPracticesIssues(src, relPath) {
             });
         }
     }
-    // Magic numbers (numeric literals that aren't 0, 1, -1, or common config values)
     for (const match of scan.matchAll(/(?<!\$)[\s(,=[+\-*/%&|^]=?](\d{3,})\b(?!\s*=>)/g)) {
         const line = lineOf(match.index);
         const context = scan.slice(Math.max(0, match.index - 40), match.index);
@@ -61,7 +56,6 @@ function detectBestPracticesIssues(src, relPath) {
             });
         }
     }
-    // Complex functions (cyclomatic complexity via brace counting)
     for (const funcMatch of scan.matchAll(/(?:^|\n)\s*(?:public|private|protected|static)?\s*function\s+\w+\s*\([^)]*\)\s*(?::\s*\w+(?:\s*\|\s*\w+)*)?\s*\{/g)) {
         const funcStart = funcMatch.index;
         const bodyStart = funcStart + funcMatch[0].length;
@@ -91,7 +85,6 @@ function detectBestPracticesIssues(src, relPath) {
             });
         }
     }
-    // Missing error handling around risky operations
     const riskyOps = ['file_get_contents', 'file_put_contents', 'fopen', 'mkdir', 'unlink', 'copy', 'rename', 'move_uploaded_file', 'curl_exec', 'ftp_get', 'ftp_put'];
     for (const op of riskyOps) {
         for (const match of scan.matchAll(new RegExp(`\\b${op}\\s*\\(`, 'gi'))) {
@@ -109,7 +102,6 @@ function detectBestPracticesIssues(src, relPath) {
             }
         }
     }
-    // Superglobal access without filtering
     for (const match of scan.matchAll(/\$(?:_GET|_POST|_REQUEST|_COOKIE|_SERVER)\s*\[/gi)) {
         const line = lineOf(match.index);
         const before = scan.slice(Math.max(0, match.index - 150), match.index);
@@ -124,7 +116,6 @@ function detectBestPracticesIssues(src, relPath) {
             });
         }
     }
-    // Use of `global` keyword in functions
     for (const match of scan.matchAll(/(?:^|\n)\s*global\s+\$/gm)) {
         const line = lineOf(match.index);
         ocorrencias.push({
@@ -136,7 +127,6 @@ function detectBestPracticesIssues(src, relPath) {
             tipo: 'php/rule'
         });
     }
-    // Method naming conventions (PSR-12: methods should be camelCase)
     for (const match of scan.matchAll(/(?:^|\n)\s*(?:public|private|protected)\s+function\s+([a-zA-Z_]\w*)\s*\(/g)) {
         const funcName = match[1];
         if (funcName && /^[A-Z]/.test(funcName)) {
@@ -151,7 +141,6 @@ function detectBestPracticesIssues(src, relPath) {
             });
         }
     }
-    // Long parameter lists (>5 params)
     for (const match of scan.matchAll(/(?:^|\n)\s*(?:public|private|protected|static)?\s*function\s+\w+\s*\(([^)]*)\)/g)) {
         const params = match[1];
         if (params) {

package/dist/analysts/php/detectors/detector-php-security.js

@@ -1,14 +1,11 @@
-// @mahoraga-disable ml-deep-nesting
-// SPDX-License-Identifier: MIT
 import { messages } from '../../../core/messages/index.js';
 import { createLineLookup, maskPhpComments } from '../../../shared/helpers/index.js';
 import { criarAnalista } from '../../../types/index.js';
-const disableEnv = process.env.SUKUNA_DISABLE_PLUGIN_PHP === '1';
+const disableEnv = process.env.MAHORAGA_DISABLE_PLUGIN_PHP === '1';
 function detectSecurityIssues(src, relPath) {
     const ocorrencias = [];
     const lineOf = createLineLookup(src).lineAt;
     const scan = maskPhpComments(src);
-    // Loose comparison (== vs ===) in security-sensitive contexts
     for (const match of scan.matchAll(/(?:if|elseif|while)\s*\([^)]*==[^=][^)]*\)/gi)) {
         const line = lineOf(match.index);
         const snippet = scan.slice(Math.max(0, match.index - 40), match.index + 120);
@@ -23,7 +20,6 @@ function detectSecurityIssues(src, relPath) {
             });
         }
     }
-    // Insecure file inclusion (include/require with user input)
     for (const match of scan.matchAll(/\b(?:include|require)(?:_once)?\s*\(\s*\$/gi)) {
         const line = lineOf(match.index);
         ocorrencias.push({
@@ -35,7 +31,6 @@ function detectSecurityIssues(src, relPath) {
             tipo: 'php/rule'
         });
     }
-    // XSS: echo/print with user input without htmlspecialchars
     for (const match of scan.matchAll(/(?:echo|print)\s+.*\$(?:_GET|_POST|_REQUEST|_COOKIE|_SERVER)/gi)) {
         const line = lineOf(match.index);
         const before = scan.slice(Math.max(0, match.index - 120), match.index);
@@ -50,7 +45,6 @@ function detectSecurityIssues(src, relPath) {
             });
         }
     }
-    // CSRF protection missing
     for (const match of scan.matchAll(/<form[^>]*>/gi)) {
         const formPos = match.index;
         const formTag = match[0];
@@ -68,7 +62,6 @@ function detectSecurityIssues(src, relPath) {
             });
         }
     }
-    // Open redirect: header('Location: ...') with user input
     for (const match of scan.matchAll(/header\s*\(\s*['"]\s*Location\s*['"]\s*,\s*\$/gi)) {
         const line = lineOf(match.index);
         ocorrencias.push({
@@ -91,7 +84,6 @@ function detectSecurityIssues(src, relPath) {
             tipo: 'php/rule'
         });
     }
-    // Dangerous ini_set calls
     const dangerousIni = ['allow_url_include', 'allow_url_fopen', 'display_errors', 'register_globals', 'session.use_cookies', 'session.use_only_cookies', 'session.use_trans_sid'];
     for (const match of scan.matchAll(/ini_set\s*\(\s*['"]([^'"]+)['"]/gi)) {
         const key = match[1];
@@ -107,7 +99,6 @@ function detectSecurityIssues(src, relPath) {
             });
         }
     }
-    // register_globals usage
     for (const match of scan.matchAll(/\bregister_globals\b/gi)) {
         const line = lineOf(match.index);
         ocorrencias.push({
@@ -119,7 +110,6 @@ function detectSecurityIssues(src, relPath) {
             tipo: 'php/rule'
         });
     }
-    // Password hashing without password_hash/password_verify
     if (/password/i.test(scan)) {
         const hasHash = /\bpassword_hash\s*\(/.test(scan);
         const hasVerify = /\bpassword_verify\s*\(/.test(scan);
@@ -153,7 +143,6 @@ function detectSecurityIssues(src, relPath) {
             }
         }
     }
-    // Session fixation risks
     if (/\bsession_start\s*\(/i.test(scan)) {
         const hasRegenerate = /\bsession_regenerate_id\s*\(/i.test(scan);
         if (!hasRegenerate) {
@@ -170,7 +159,6 @@ function detectSecurityIssues(src, relPath) {
             }
         }
     }
-    // Second-order injection patterns (storing user input then using unsafely)
     for (const match of scan.matchAll(/\b(?:mysql|mysqli|sqlite|pg)_query\s*\(\s*[^)]*\$(?:row|data|result|res|item|entry)\b/gi)) {
         const line = lineOf(match.index);
         ocorrencias.push({

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

@@ -1,3 +1,2 @@
-// SPDX-License-Identifier: MIT
 export { detectorPhpBestPractices } from './detector-php-best-practices.js';
 export { detectorPhpSecurity } from './detector-php-security.js';

package/dist/analysts/php/index.js

@@ -1,4 +1,3 @@
-// SPDX-License-Identifier: MIT
 export * from './analysts/analyst-php.js';
 export * from './corrections/index.js';
 export * from './detectors/index.js';

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

@@ -1,2 +1 @@
-// SPDX-License-Identifier: MIT
 export {};