@silasfmartins/testhub 1.0.0

package/scripts/package-versions.ts

@@ -0,0 +1,978 @@
+// @ts-nocheck
+import fs from 'node:fs'
+import { execSync } from 'child_process'
+import path from 'path'
+import { fileURLToPath } from 'url'
+
+// ✅ ESM Compatibility: Define __dirname for ES modules
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+
+/**
+ * Versões centralizadas das dependências
+ * Atualizado automaticamente via npm-check-updates
+ */
+
+export interface PackageVersions {
+  dependencies: Record<string, string>
+  devDependencies: Record<string, string>
+}
+
+/**
+ * Busca as versões mais atuais das dependências
+ */
+export async function getLatestVersions(): Promise<PackageVersions> {
+  try {
+    console.log('🔍 Verificando versões mais recentes...')
+
+    // Lista de pacotes base que sempre usamos
+    const baseDependencies = [
+      '@silasfmartins/testhub',
+      'cross-env',
+      'dotenv',
+      'tsx',
+    ]
+
+    const baseDevDependencies = [
+      '@biomejs/biome',
+      '@playwright/test',
+      '@vitest/coverage-v8',
+      'typescript',
+      'ultracite',
+      'vitest',
+    ]
+
+    // Buscar versões mais recentes via npm view
+    const getLatestVersion = (packageName: string): string => {
+      try {
+        const result = execSync(`npm view ${packageName} version`, {
+          encoding: 'utf8',
+        })
+        return `^${result.trim()}`
+      } catch (error) {
+        console.warn(
+          `⚠️ Erro ao buscar versão de ${packageName}, usando fallback`,
+        )
+        return getVersionFallback(packageName)
+      }
+    }
+
+    // Versões de fallback caso npm view falhe
+    const getVersionFallback = (packageName: string): string => {
+      const fallbacks: Record<string, string> = {
+        '@silasfmartins/testhub': '^1.0.90',
+        'cross-env': '^7.0.3',
+        '@biomejs/biome': '2.0.6',
+        tsx: '^4.20.3',
+        '@playwright/test': '^1.53.2',
+        '@vitest/coverage-v8': '^3.2.4',
+        '@vitest/ui': '^3.2.4',
+        'happy-dom': '^18.0.1',
+        typescript: '^5.8.3',
+        ultracite: '5.0.32',
+        vitest: '^3.2.4',
+      }
+      return fallbacks[packageName] || '^1.0.0'
+    }
+
+    const dependencies: Record<string, string> = {}
+    const devDependencies: Record<string, string> = {}
+
+    // Buscar versões das dependências
+    for (const pkg of baseDependencies) {
+      dependencies[pkg] = getLatestVersion(pkg)
+      console.log(`  ✓ ${pkg}: ${dependencies[pkg]}`)
+    }
+
+    // Buscar versões das devDependencies
+    for (const pkg of baseDevDependencies) {
+      devDependencies[pkg] = getLatestVersion(pkg)
+      console.log(`  ✓ ${pkg}: ${devDependencies[pkg]}`)
+    }
+
+    console.log('✅ Versões atualizadas obtidas com sucesso')
+
+    return {
+      dependencies,
+      devDependencies,
+    }
+  } catch (error) {
+    console.warn('⚠️ Erro ao buscar versões, usando fallbacks')
+
+    // Retornar versões de fallback
+    return {
+      dependencies: {
+        '@silasfmartins/testhub': '^2.0.0',
+        'cross-env': '^10.1.0'
+      },
+      devDependencies: {
+        '@biomejs/biome': '2.2.5',
+        tsx: '^4.20.5',
+        '@playwright/test': '^1.56.0',
+        typescript: '^5.9.3',
+        ultracite: '5.6.1',
+      },
+    }
+  }
+}
+
+/**
+ * ✅ NOVO - Lê o vitest.config.ts do projeto AutoCore para manter consistência
+ */
+export function getAutocoreVitestConfig(): any {
+  try {
+    // Obter caminho do arquivo atual
+    const currentDir = path.dirname(fileURLToPath(import.meta.url))
+    // Navegar para o diretório raiz do projeto
+    // Se estivermos em dist/scripts/, subir 2 níveis; se em scripts/, subir 1 nível
+    const autocoreRoot = currentDir.includes('dist')
+      ? path.resolve(currentDir, '..', '..') // dist/scripts/ -> raiz
+      : path.resolve(currentDir, '..') // scripts/ -> raiz
+    const vitestConfigPath = path.join(autocoreRoot, 'vitest.config.ts')
+
+    console.log(`🔍 Procurando vitest.config.ts em: ${vitestConfigPath}`)
+
+    if (fs.existsSync(vitestConfigPath)) {
+      const vitestConfigContent = fs.readFileSync(vitestConfigPath, 'utf8')
+
+      // Parse simples extraindo a configuração do defineConfig
+      // Removemos imports e export e mantemos só a configuração
+      const configMatch = vitestConfigContent.match(
+        /defineConfig\(([\s\S]*)\)/m,
+      )
+      if (configMatch) {
+        // Parseando manualmente para manter comentários e estrutura
+        const configStr = configMatch[1]
+
+        // Estrutura base similar ao que temos no AutoCore
+        const baseConfig = {
+          test: {
+            globals: false, // Sempre false para evitar conflitos Jest/Vitest
+            environment: 'node',
+            setupFiles: ['./tests/unit/setup.ts'],
+            include: ['tests/**/*.test.ts', 'src/**/*.test.ts'],
+            coverage: {
+              provider: 'v8',
+              reporter: ['text', 'html', 'lcov'],
+              include: ['src/**/*.ts'],
+              exclude: [
+                'tests/**',
+                'node_modules/',
+                'dist/',
+                '**/*.d.ts',
+                '**/*.config.ts',
+              ],
+            },
+          },
+        }
+
+        console.log('✅ vitest.config.ts do AutoCore carregado com sucesso')
+        return baseConfig
+      }
+    }
+    console.warn(
+      '⚠️ vitest.config.ts do AutoCore não encontrado, usando configuração padrão',
+    )
+    return getDefaultVitestConfig()
+  } catch (error) {
+    console.warn(
+      `⚠️ Erro ao ler vitest.config.ts do AutoCore: ${error}, usando configuração padrão`,
+    )
+    return getDefaultVitestConfig()
+  }
+}
+
+/**
+ * ✅ NOVO - Configuração padrão de fallback para vitest.config.ts
+ */
+function getDefaultVitestConfig(): any {
+  return {
+    test: {
+      // Default safe config
+      globals: false,
+      environment: 'node',
+      setupFiles: ['./tests/unit/setup.ts'],
+      include: ['tests/**/*.test.ts', 'src/**/*.test.ts'],
+      coverage: {
+        provider: 'v8',
+        reporter: ['text', 'html', 'lcov'],
+        include: ['src/**/*.ts'],
+        exclude: [
+          'tests/**',
+          'node_modules/',
+          'dist/',
+          '**/*.d.ts',
+          '**/*.config.ts',
+          '**/coverage/**',
+        ],
+      },
+    },
+  }
+}
+
+/**
+ * ✅ NOVO - Gera vitest.config.ts para projeto consumidor
+ */
+export function generateVitestConfigForProject(
+  projectType: 'api' | 'frontend' | 'mobile' | 'ssh' | 'banco' | 'scenarios',
+): any {
+  const baseVitestConfig = getAutocoreVitestConfig()
+
+  // Personaliza configuração baseada no tipo de projeto
+  const projectVitestConfig = {
+    ...baseVitestConfig,
+    test: {
+      ...baseVitestConfig.test,
+      // Ajustes específicos por tipo de projeto
+      ...(projectType === 'scenarios' && {
+        // Para cenários, incluir coverage mais abrangente
+        coverage: {
+          ...baseVitestConfig.test.coverage,
+          include: ['src/**/*.ts', 'tests/helpers/**/*.ts'],
+          reporter: ['text', 'html', 'lcov', 'json'],
+        },
+      }),
+      ...(projectType === 'api' && {
+        // Para API, incluir testes de integração
+        include: [
+          'tests/**/*.test.ts',
+          'src/**/*.test.ts',
+          'tests/**/*.integration.test.ts',
+        ],
+      }),
+    },
+  }
+
+  console.log(
+    `✅ vitest.config.ts gerado para projeto ${projectType} (sincronizado com AutoCore)`,
+  )
+  return projectVitestConfig
+}
+
+/**
+ * ✅ NOVO - Gera vitest.config.ts como string TypeScript (IGUAL AO AUTOCORE)
+ */
+export function generateVitestConfigString(
+  projectType: 'api' | 'frontend' | 'mobile' | 'ssh' | 'banco' | 'scenarios',
+): string {
+  // 🔧 Configuração otimizada para evitar conflitos Jest/Vitest/Playwright
+  return `import { defineConfig } from 'vitest/config'
+
+export default defineConfig({
+  test: {
+    // ✅ CRÍTICO: globals: false evita conflitos com Jest/Playwright
+    globals: false,
+    environment: 'node',
+
+    // ✅ Jest-safe setup para resolver conflitos de símbolos
+    setupFiles: [
+      '@silasfmartins/testhub/jest-safe',  // ← Deve ser PRIMEIRO
+      './tests/unit/setup.ts'
+    ],
+    
+    // 🎯 CRÍTICO: Apenas .test.ts para evitar conflito com Playwright .spec.ts
+    include: ['tests/**/*.test.ts'],
+    
+    // 🔧 Excluir arquivos que podem causar conflito
+    exclude: [
+      'node_modules/**',
+      'dist/**',
+      '.git/**',
+      'coverage/**',
+      'playwright-report/**',
+      'test-results/**',
+      '**/*.spec.ts',  // ← EXCLUIR .spec.ts (são do Playwright)
+      'tests/e2e/**'   // ← EXCLUIR testes E2E (são do Playwright)
+    ],
+    
+    // ✅ Configurações de isolamento para evitar conflitos de símbolos
+    isolate: true,
+    pool: 'forks',  // Forks em vez de threads
+    
+    // ✅ Execução sequencial para evitar race conditions
+    sequence: {
+      concurrent: false,
+      shuffle: false
+    },
+    
+    // ✅ Worker único para evitar conflitos de Symbol registry
+    maxWorkers: 1,
+    retry: 0,
+    testTimeout: 30_000,
+    hookTimeout: 10_000,
+    
+    coverage: {
+      provider: 'v8',
+      reporter: ['text', 'html', 'lcov'],
+      include: ['src/**/*.ts'],
+      exclude: [
+        'tests/**', 
+        'src/**/*.d.ts',
+        'src/**/*.test.ts',
+        'src/**/*.spec.ts'
+      ],
+    },
+  },
+  esbuild: {
+    target: 'node24'
+  }
+})
+`
+}
+
+/**
+ * Lê o tsconfig.json do projeto AutoCore para manter consistência
+ */
+export function getAutocoreTsConfig(): any {
+  try {
+    // Obter caminho do arquivo atual
+    const currentDir = path.dirname(fileURLToPath(import.meta.url))
+    // Navegar para o diretório raiz do projeto
+    // Se estivermos em dist/scripts/, subir 2 níveis; se em scripts/, subir 1 nível
+    const autocoreRoot = currentDir.includes('dist')
+      ? path.resolve(currentDir, '..', '..') // dist/scripts/ -> raiz
+      : path.resolve(currentDir, '..') // scripts/ -> raiz
+    const tsconfigPath = path.join(autocoreRoot, 'tsconfig.json')
+
+    console.log(`🔍 Procurando tsconfig.json em: ${tsconfigPath}`)
+
+    if (fs.existsSync(tsconfigPath)) {
+      const tsconfigContent = fs.readFileSync(tsconfigPath, 'utf8')
+      const tsconfig = JSON.parse(tsconfigContent)
+
+      console.log('✅ tsconfig.json do AutoCore carregado com sucesso')
+      return tsconfig
+    }
+    console.warn(
+      '⚠️ tsconfig.json do AutoCore não encontrado, usando configuração padrão',
+    )
+    return getDefaultTsConfig()
+  } catch (error) {
+    console.warn(
+      `⚠️ Erro ao ler tsconfig.json do AutoCore: ${error}, usando configuração padrão`,
+    )
+    return getDefaultTsConfig()
+  }
+}
+
+/**
+ * Configuração padrão de fallback para tsconfig.json
+ */
+function getDefaultTsConfig(): any {
+  return {
+    $schema: 'https://json.schemastore.org/tsconfig',
+    compilerOptions: {
+      // ✅ IMPORTANTE: manter checks básicos como strictNullChecks
+      strictNullChecks: true,
+    },
+  }
+}
+
+/**
+ * ✅ CORRIGIDO: Função única para gerar tsconfig.json
+ */
+export function generateTsConfigForProject(
+  projectType: 'api' | 'frontend' | 'mobile' | 'ssh' | 'banco' | 'scenarios',
+): any {
+  const baseTsConfig = getAutocoreTsConfig()
+
+  // Retorna cópia idêntica do AutoCore sem modificações
+  const projectTsConfig = {
+    ...baseTsConfig,
+  }
+
+  console.log(
+    `✅ tsconfig.json gerado para projeto ${projectType} (sincronizado com AutoCore)`,
+  )
+  return projectTsConfig
+}
+
+/**
+ * Gera package.json com versões específicas por tipo de projeto
+ */
+export function generatePackageJson(
+  projectName: string,
+  projectType: 'api' | 'frontend' | 'mobile' | 'ssh' | 'banco' | 'scenarios',
+  versions: PackageVersions,
+): any {
+  // ✅ NOVO: Package.json base para scenarios (sem main)
+  const basePackageJsonScenarios = {
+    name: `@rbqa/${projectName}`,
+    version: '1.0.0',
+    type: 'module',
+    keywords: [],
+    author: '',
+    license: 'ISC',
+  }
+
+  // ✅ Package.json base para outros tipos (com main)
+  const basePackageJson = {
+    name: `@rbqa/${projectName}`,
+    version: '1.0.0',
+    type: 'module',
+    main: 'dist/index.js',
+    keywords: [],
+    author: '',
+    license: 'ISC',
+  }
+
+  // ✅ Escolher configuração base baseada no tipo de projeto
+  const selectedBase =
+    projectType === 'scenarios' ? basePackageJsonScenarios : basePackageJson
+
+  // Scripts específicos por tipo de projeto
+  const scriptsConfig = getScriptsForProjectType(projectType)
+
+  // Dependências específicas por tipo
+  const specificDependencies = getSpecificDependencies(projectType, versions)
+
+  // Build base package object
+  const pkg: any = {
+    ...selectedBase,
+    description: `Projeto ${getProjectTypeDescription(projectType)} baseado no AutoCore para Automação`,
+    scripts: scriptsConfig,
+    devDependencies: {
+      ...versions.devDependencies,
+      ...specificDependencies.devDependencies,
+    },
+  }
+
+  if (projectType === 'scenarios') {
+    // For scenarios: keep runtime deps minimal (only specificDependencies)
+    pkg.dependencies = {
+      ...specificDependencies.dependencies,
+    }
+
+    // Move common system packages (that represent other "system" projects) to peerDependencies
+    // so they are declared but NOT installed automatically on `npm install`.
+    const systemPatterns = [/^@sfa\//i, /test-sanity/i]
+    const peerDeps: Record<string, string> = {}
+
+    for (const [name, ver] of Object.entries(versions.dependencies || {})) {
+      const isSystem = systemPatterns.some((rx) => rx.test(name))
+      if (isSystem) {
+        peerDeps[name] = ver
+      }
+    }
+
+    if (Object.keys(peerDeps).length > 0) {
+      pkg.peerDependencies = peerDeps
+    }
+  } else {
+    pkg.dependencies = {
+      // Remover automaticamente `zod` dos packages gerados para consumidores
+      ...Object.fromEntries(
+        Object.entries(versions.dependencies || {}).filter(([k]) => k !== 'zod'),
+      ),
+      ...specificDependencies.dependencies,
+    }
+  }
+
+  return pkg
+}
+
+/**
+ * Dependências específicas por tipo de projeto
+ */
+function getSpecificDependencies(
+  projectType: string,
+  versions: PackageVersions,
+): {
+  dependencies: Record<string, string>
+  devDependencies: Record<string, string>
+} {
+  const specific = {
+    dependencies: {} as Record<string, string>,
+    devDependencies: {} as Record<string, string>,
+  }
+
+  switch (projectType) {
+    case 'scenarios':
+      // ✅ Scenarios: keep dependencies minimal to avoid heavy installs on `npm i`
+      // Only install @silasfmartins/testhub by default; move other tools to devDependencies
+      specific.dependencies['@silasfmartins/testhub'] =
+        versions.dependencies?.['@silasfmartins/testhub'] || '^1.0.0'
+
+      // Minimal devDependencies helpful for development (tsx/biome if present)
+      specific.devDependencies['tsx'] =
+        versions.devDependencies?.['tsx'] || versions.dependencies?.['tsx'] || '^4.20.0'
+      specific.devDependencies['@biomejs/biome'] =
+        versions.devDependencies?.['@biomejs/biome'] || '^2.0.0'
+      break
+
+    default:
+      // Para outros tipos, manter tsx nas dependencies normais
+      break
+  }
+
+  return specific
+}
+
+/**
+ * Scripts específicos por tipo de projeto
+ */
+function getScriptsForProjectType(projectType: string): Record<string, string> {
+  const baseScripts = {
+    generate: 'npx autocore-generate',
+    update: 'npx autocore-sync-configs && npm run generate && rimraf dist && tsc && rimraf index.ts',
+    build: 'npm run update',
+    sync: 'npx autocore-sync-configs',
+    format: 'npx @biomejs/biome format --write',
+    "check-updates": "npx npm-check-updates -u",
+    register: "npx tsx node_modules/@silasfmartins/testhub/scripts/smart-override.ts register",
+  }
+
+  // ✅ Scripts do Vitest para testes unitários de utilitários
+  const vitestScripts = {
+    'test:unit': 'vitest run',
+    'test:unit:watch': 'vitest',
+    'test:unit:ui': 'vitest --ui',
+    'test:unit:coverage': 'vitest run',
+  }
+
+  const testScripts = {
+    test: 'cross-env NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test',
+    'test:esteira1':
+      'cross-env NODE_ENV=esteira1 NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test',
+    'test:esteira2':
+      'cross-env NODE_ENV=esteira2 NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test',
+    'test:preprod':
+      'cross-env NODE_ENV=preprod NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test',
+    'test:prodlike':
+      'cross-env NODE_ENV=prodlike NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test',
+  }
+
+  // ✅ Scripts de CodeGen com contexto do AutoCore
+  const codegenScripts = {
+    codegen:
+      'cross-env NODE_ENV=preprod NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright codegen',
+    'codegen:esteira1':
+      'cross-env NODE_ENV=esteira1 NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright codegen',
+    'codegen:esteira2':
+      'cross-env NODE_ENV=esteira2 NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright codegen',
+    'codegen:preprod':
+      'cross-env NODE_ENV=preprod NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright codegen',
+    'codegen:prodlike':
+      'cross-env NODE_ENV=prodlike NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright codegen',
+  }
+
+  // ✅ Scripts de Debug com contexto do AutoCore
+  const debugScripts = {
+    debug:
+      'cross-env NODE_ENV=preprod NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --debug',
+    'debug:esteira1':
+      'cross-env NODE_ENV=esteira1 NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --debug',
+    'debug:esteira2':
+      'cross-env NODE_ENV=esteira2 NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --debug',
+    'debug:preprod':
+      'cross-env NODE_ENV=preprod NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --debug',
+    'debug:prodlike':
+      'cross-env NODE_ENV=prodlike NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --debug',
+  }
+
+  // ✅ Scripts de UI com contexto do AutoCore (Web/Frontend)
+  const uiScripts = {
+    ui: 'cross-env NODE_ENV=preprod NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --ui',
+    'ui:esteira1':
+      'cross-env NODE_ENV=esteira1 NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --ui',
+    'ui:esteira2':
+      'cross-env NODE_ENV=esteira2 NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --ui',
+    'ui:preprod':
+      'cross-env NODE_ENV=preprod NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --ui',
+    'ui:prodlike':
+      'cross-env NODE_ENV=prodlike NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --ui',
+  }
+
+  const uiScriptsChromium = {
+    'ui:chromium': 'cross-env NODE_ENV=preprod NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --ui --project=chromium',
+    'ui:esteira1:chromium':
+      'cross-env NODE_ENV=esteira1 NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --ui --project=chromium',
+    'ui:esteira2:chromium':
+      'cross-env NODE_ENV=esteira2 NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --ui --project=chromium',
+    'ui:preprod:chromium':
+      'cross-env NODE_ENV=preprod NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --ui --project=chromium',
+    'ui:prodlike:chromium':
+      'cross-env NODE_ENV=prodlike NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --ui --project=chromium',
+  }
+
+  const testScriptsChromium = {
+    ui: 'cross-env NODE_ENV=preprod NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --ui --project=chromium',
+    'ui:esteira1':
+      'cross-env NODE_ENV=esteira1 NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --ui --project=chromium',
+    'ui:esteira2':
+      'cross-env NODE_ENV=esteira2 NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --ui --project=chromium',
+    'ui:preprod':
+      'cross-env NODE_ENV=preprod NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --ui --project=chromium',
+    'ui:prodlike':
+      'cross-env NODE_ENV=prodlike NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --ui --project=chromium',
+  }
+
+  // ✅ Scripts MOBILE em modo HEADLESS (sem Appium Inspector - para CI/CD)
+  const mobileTestScripts = {
+    'test:esteira1':
+      'cross-env MOBILE_UI_MODE=false NODE_ENV=esteira1 NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test',
+    'test:esteira2':
+      'cross-env MOBILE_UI_MODE=false NODE_ENV=esteira2 NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test',
+    'test:preprod':
+      'cross-env MOBILE_UI_MODE=false NODE_ENV=preprod NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test',
+    'test:prodlike':
+      'cross-env MOBILE_UI_MODE=false NODE_ENV=prodlike NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test',
+  }
+
+  // ✅ Scripts MOBILE DEBUG em modo HEADLESS
+  const mobileDebugScripts = {
+    debug:
+      'cross-env MOBILE_UI_MODE=false NODE_ENV=preprod NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --debug',
+    'debug:esteira1':
+      'cross-env MOBILE_UI_MODE=false NODE_ENV=esteira1 NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --debug',
+    'debug:esteira2':
+      'cross-env MOBILE_UI_MODE=false NODE_ENV=esteira2 NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --debug',
+    'debug:preprod':
+      'cross-env MOBILE_UI_MODE=false NODE_ENV=preprod NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --debug',
+    'debug:prodlike':
+      'cross-env MOBILE_UI_MODE=false NODE_ENV=prodlike NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --debug',
+  }
+
+  // ✅ Scripts MOBILE com UI (Appium Inspector VISÍVEL - para desenvolvimento)
+  const mobileUiScripts = {
+    'ui:esteira1':
+      'cross-env MOBILE_UI_MODE=true NODE_ENV=esteira1 NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test',
+    'ui:esteira2':
+      'cross-env MOBILE_UI_MODE=true NODE_ENV=esteira2 NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test',
+    'ui:preprod':
+      'cross-env MOBILE_UI_MODE=true NODE_ENV=preprod NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test',
+    'ui:prodlike':
+      'cross-env MOBILE_UI_MODE=true NODE_ENV=prodlike NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test',
+    'ui:esteira1:debug':
+      'cross-env MOBILE_UI_MODE=true AUTOCORE_DEBUG_LOGS=true NODE_ENV=esteira1 NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --debug',
+    'ui:esteira2:debug':
+      'cross-env MOBILE_UI_MODE=true AUTOCORE_DEBUG_LOGS=true NODE_ENV=esteira2 NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --debug',
+    'ui:preprod:debug':
+      'cross-env MOBILE_UI_MODE=true AUTOCORE_DEBUG_LOGS=true NODE_ENV=preprod NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --debug',
+    'ui:prodlike:debug':
+      'cross-env MOBILE_UI_MODE=true AUTOCORE_DEBUG_LOGS=true NODE_ENV=prodlike NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --debug',
+  }
+
+  // ✅ Script de postinstall AUTOMÁTICO (roda após npm install)
+  // Sincroniza tsconfig.json, biome.json e instala extensões VS Code
+  // Usa binários do AutoCore (evita erros de .ts não encontrado)
+  const postinstallScript = {
+    postinstall: 'npx autocore-postinstall',
+  }
+
+  switch (projectType) {
+    case 'api':
+      return {
+        ...testScripts,
+        ...debugScripts,
+        ...baseScripts,
+        ...postinstallScript,
+      }
+
+    case 'scenarios':
+      // ✅ CORRIGIDO: Scenarios usa preinstall (antes) + postinstall (depois)
+      return {
+        sync: 'npx autocore-sync-configs',
+        'test:esteira1':
+          'cross-env NODE_ENV=esteira1 NODE_ORACLEDB_DRIVER_MODE=thick NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test',
+        'test:esteira2':
+          'cross-env NODE_ENV=esteira2 NODE_ORACLEDB_DRIVER_MODE=thick NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test',
+        'test:preprod':
+          'cross-env NODE_ENV=preprod NODE_ORACLEDB_DRIVER_MODE=thick NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test',
+        'test:prodlike':
+          'cross-env NODE_ENV=prodlike NODE_ORACLEDB_DRIVER_MODE=thick NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test',
+        // ✅ Debug para cenários
+        debug:
+          'cross-env NODE_ENV=preprod NODE_ORACLEDB_DRIVER_MODE=thick NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --debug',
+        'debug:esteira1':
+          'cross-env NODE_ENV=esteira1 NODE_ORACLEDB_DRIVER_MODE=thick NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --debug',
+        'debug:esteira2':
+          'cross-env NODE_ENV=esteira2 NODE_ORACLEDB_DRIVER_MODE=thick NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --debug',
+        'debug:preprod':
+          'cross-env NODE_ENV=preprod NODE_ORACLEDB_DRIVER_MODE=thick NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --debug',
+        'debug:prodlike':
+          'cross-env NODE_ENV=prodlike NODE_ORACLEDB_DRIVER_MODE=thick NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --debug',
+        ui: 'cross-env NODE_ENV=preprod NODE_ORACLEDB_DRIVER_MODE=thick NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --ui',
+        'ui:esteira1':
+          'cross-env NODE_ENV=esteira1 NODE_ORACLEDB_DRIVER_MODE=thick NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --ui',
+        'ui:esteira2':
+          'cross-env NODE_ENV=esteira2 NODE_ORACLEDB_DRIVER_MODE=thick NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --ui',
+        'ui:preprod':
+          'cross-env NODE_ENV=preprod NODE_ORACLEDB_DRIVER_MODE=thick NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --ui',
+        'ui:prodlike':
+          'cross-env NODE_ENV=prodlike NODE_ORACLEDB_DRIVER_MODE=thick NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --ui',
+        ...uiScriptsChromium,
+        ...testScriptsChromium,
+        postinstall: "node -e \"const fs=require('fs'), cp=require('child_process'); if(!fs.existsSync('node_modules/@silasfmartins/testhub')){console.log('@silasfmartins/testhub missing - installing'); cp.execSync('npm install @silasfmartins/testhub --no-audit --no-fund --silent',{stdio:'inherit'});} try{ cp.execSync('npx tsx ./node_modules/@silasfmartins/testhub/scripts/consumer-postinstall.ts',{stdio:'inherit'});}catch(e){ console.warn('consumer-postinstall failed', e); }\""
+
+      }
+
+    case 'banco':
+      return {
+        'test:esteira1':
+          'cross-env NODE_ENV=esteira1 NODE_ORACLEDB_DRIVER_MODE=thick NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test',
+        'test:esteira2':
+          'cross-env NODE_ENV=esteira2 NODE_ORACLEDB_DRIVER_MODE=thick NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test',
+        'test:preprod':
+          'cross-env NODE_ENV=preprod NODE_ORACLEDB_DRIVER_MODE=thick NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test',
+        'test:prodlike':
+          'cross-env NODE_ENV=prodlike NODE_ORACLEDB_DRIVER_MODE=thick NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test',
+        debug:
+          'cross-env NODE_ENV=preprod NODE_ORACLEDB_DRIVER_MODE=thick NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --debug',
+        'debug:esteira1':
+          'cross-env NODE_ENV=esteira1 NODE_ORACLEDB_DRIVER_MODE=thick NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --debug',
+        'debug:esteira2':
+          'cross-env NODE_ENV=esteira2 NODE_ORACLEDB_DRIVER_MODE=thick NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --debug',
+        'debug:preprod':
+          'cross-env NODE_ENV=preprod NODE_ORACLEDB_DRIVER_MODE=thick NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --debug',
+        'debug:prodlike':
+          'cross-env NODE_ENV=prodlike NODE_ORACLEDB_DRIVER_MODE=thick NODE_OPTIONS="--loader ./node_modules/@silasfmartins/testhub/protect-loader.mjs" playwright test --debug',
+        ...baseScripts,
+        ...postinstallScript
+      }
+
+    case 'frontend':
+      return {
+        ...testScripts,
+        ...debugScripts,
+        ...baseScripts,
+        ...uiScripts,
+        ...uiScriptsChromium,
+        ...testScriptsChromium,
+        ...postinstallScript
+      }
+
+    case 'mobile':
+      return {
+        ...mobileTestScripts,
+        ...mobileDebugScripts,
+        ...mobileUiScripts,
+        ...baseScripts,
+        ...postinstallScript
+      }
+
+    case 'ssh':
+      return {
+        ...testScripts,
+        ...debugScripts,
+        ...baseScripts,
+        ...postinstallScript
+      }
+
+    default:
+      return {
+        ...testScripts,
+        ...debugScripts,
+        ...baseScripts,
+        ...postinstallScript
+      }
+  }
+}
+
+/**
+ * Descrição por tipo de projeto
+ */
+function getProjectTypeDescription(projectType: string): string {
+  const descriptions = {
+    api: 'de API',
+    frontend: 'Frontend',
+    mobile: 'Mobile',
+    ssh: 'de SSH',
+    banco: 'de Banco de Dados',
+    scenarios: 'de Cenários',
+  }
+
+  return descriptions[projectType as keyof typeof descriptions] || 'AutoCore'
+}
+
+/**
+ * Tipo para configuração do Biome
+ */
+type BiomeConfig = {
+  $schema?: string
+  extends?: string[]
+  [key: string]: unknown
+}
+
+/**
+ * ✅ NOVO - Gera biome.json sincronizado com o AutoCore
+ */
+export function generateBiomeConfigForProject(): BiomeConfig {
+  // Lê o biome.json do AutoCore como template
+  const autocoreBiomeConfig = getAutocoreBiomeConfig()
+
+  console.log('✅ biome.json sincronizado com AutoCore')
+  return autocoreBiomeConfig
+}
+
+/**
+ * ✅ Parse robusto de JSONC - Remove comentários e caracteres de controle
+ */
+function parseJsonc(content: string): BiomeConfig {
+  // 1. Remover comentários de bloco /* */
+  let cleaned = content.replace(/\/\*[\s\S]*?\*\//g, '')
+
+  // 2. Remover comentários de linha // (processar linha por linha para não afetar URLs)
+  const lines = cleaned.split('\n')
+  const processedLines = lines.map((line) => {
+    // Se a linha tem aspas, verificar se // está dentro de string
+    if (line.includes('"')) {
+      const commentPos = line.indexOf('//')
+      if (commentPos === -1) {
+        return line
+      }
+
+      // Verificar se // está dentro de string (contar aspas antes)
+      const beforeComment = line.substring(0, commentPos)
+      const quoteCount = (beforeComment.match(/"/g) || []).length
+
+      // Se número ímpar de aspas, // está dentro de string
+      if (quoteCount % 2 === 1) {
+        return line // Manter linha inteira (// está dentro de string)
+      }
+
+      // // está fora de string, remover comentário
+      return line.substring(0, commentPos)
+    }
+
+    // Linha sem aspas, pode remover // normalmente
+    const commentPos = line.indexOf('//')
+    return commentPos === -1 ? line : line.substring(0, commentPos)
+  })
+
+  cleaned = processedLines.join('\n')
+
+  // 3. Normalizar quebras de linha
+  cleaned = cleaned.replace(/\r\n/g, '\n').replace(/\r/g, '\n')
+
+  // 4. ✅ CORRIGIDO: Remover caracteres de controle inválidos (ASCII 0-8, 11-12, 14-31)
+  // Remove caracteres de controle que causam "Bad control character in string literal"
+  // Mantém apenas tab(9), newline(10), carriage return(13) e caracteres imprimíveis (32+)
+  cleaned = cleaned.replace(/[\u0000-\u0008\u000B\u000C\u000E-\u001F]/g, '')
+
+  // 5. Remover trailing commas antes de } ou ]
+  cleaned = cleaned.replace(/,(\s*[}\]])/g, '$1')
+
+  // 6. Trim e fazer parse com try/catch para debugging
+  try {
+    return JSON.parse(cleaned.trim()) as BiomeConfig
+  } catch (error) {
+    console.warn('❌ Erro ao fazer parse do biome.json:', error)
+    console.warn(
+      '📝 Conteúdo problemático (primeiros 200 chars):',
+      cleaned.trim().substring(0, 200),
+    )
+    throw error
+  }
+}
+
+/**
+ * ✅ NOVO - Obtém configuração do Biome do AutoCore
+ */
+function getAutocoreBiomeConfig(): BiomeConfig {
+  try {
+    // Tentar ler o biome.json do AutoCore
+    const currentDir = path.dirname(fileURLToPath(import.meta.url))
+    // Navegar para o diretório raiz do projeto
+    // Se estivermos em dist/scripts/, subir 2 níveis; se em scripts/, subir 1 nível
+    const autocoreRoot = currentDir.includes('dist')
+      ? path.resolve(currentDir, '..', '..') // dist/scripts/ -> raiz
+      : path.resolve(currentDir, '..') // scripts/ -> raiz
+    const autoCorePath = path.join(autocoreRoot, 'biome.json')
+
+    if (fs.existsSync(autoCorePath)) {
+      const biomeContent = fs.readFileSync(autoCorePath, 'utf-8')
+      const biomeConfig = parseJsonc(biomeContent)
+      console.log('📋 Configuração do Biome carregada do AutoCore')
+      return biomeConfig
+    }
+  } catch (error) {
+    console.warn('⚠️ Erro ao ler biome.json do AutoCore:', error)
+  }
+
+  // Fallback para configuração padrão
+  console.log('📋 Usando configuração padrão do Biome')
+  return getDefaultBiomeConfig()
+}
+
+/**
+ * ✅ NOVO - Configuração padrão do Biome (fallback)
+ */
+function getDefaultBiomeConfig(): BiomeConfig {
+  return {
+    $schema: 'https://biomejs.dev/schemas/2.0.6/schema.json',
+    extends: ['ultracite'],
+    javascript: {
+      formatter: {
+        semicolons: 'asNeeded',
+      },
+    },
+  }
+}
+
+/**
+ * ✅ ATUALIZADO - Função helper para gerar biome.json como string
+ */
+export function generateBiomeConfigString(): string {
+  const biomeConfig = generateBiomeConfigForProject()
+  return JSON.stringify(biomeConfig, null, 2)
+}
+
+/**
+ * 📊 NOVO - Gera README de cobertura personalizado para o projeto
+ */
+export function generateCoverageReadme(projectName: string): string {
+  // ✅ ESM-compatible __dirname definition
+  const __filename = fileURLToPath(import.meta.url)
+  const __dirname = path.dirname(__filename)
+
+  const templatePaths = [
+    path.join(__dirname, 'templates', 'coverage-readme.template.md'),
+    path.join(
+      process.cwd(),
+      'node_modules/@silasfmartins/testhub/dist/scripts/templates/coverage-readme.template.md',
+    ),
+    path.join(process.cwd(), 'scripts/templates/coverage-readme.template.md'),
+  ]
+
+  let template = ''
+
+  for (const templatePath of templatePaths) {
+    try {
+      template = fs.readFileSync(templatePath, 'utf-8')
+      break
+    } catch (error) {}
+  }
+
+  if (!template) {
+    // Fallback: template inline se nenhum arquivo for encontrado
+    template = `# 📊 Cobertura de Testes - \${projectName}
+
+Este documento contém informações sobre a cobertura de testes do projeto **\${projectName}**.
+
+## 🎯 Objetivos de Cobertura
+
+- **Statements**: >= 80%
+- **Branches**: >= 75%
+- **Functions**: >= 85%
+- **Lines**: >= 80%
+
+## 📈 Como Visualizar a Cobertura
+
+### 1. Executar testes com cobertura:
+\`\`\`bash
+npm test
+\`\`\`
+
+### 2. Visualizar relatório HTML:
+\`\`\`bash
+npm run coverage:open
+\`\`\`
+
+---
+
+📊 **Gerado automaticamente pelo @silasfmartins/testhub**`
+  }
+
+  return template.replace(/\$\{projectName\}/g, projectName)
+}