@silasfmartins/testhub 1.0.0

package/scripts/consumer-postinstall.ts

@@ -0,0 +1,975 @@
+#!/usr/bin/env node
+// @ts-nocheck
+/**
+ * 🔧 Consumer Project Postinstall Script
+ * @description Instala automaticamente extensões VS Code necessárias em projetos consumidores
+ * @author TestHUB Team
+ * @version 1.0.0
+ *
+ * Este script é executado após npm install em projetos consumidores (API, Mobile, Web, SSH, Banco)
+ * e instala automaticamente as extensões VS Code necessárias apenas em ambiente local (Windows).
+ */
+
+import { exec } from "node:child_process";
+import * as fs from "node:fs";
+import { platform } from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { promisify } from "node:util";
+
+const execAsync = promisify(exec);
+
+// ✅ ESM Compatibility
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// Extensões obrigatórias para projetos AutoCore
+const REQUIRED_EXTENSIONS = [
+	{
+		id: "biomejs.biome",
+		name: "Biome (biomejs)",
+		description: "Formatter e linter unificado para projetos AutoCore",
+	},
+	{
+		id: "ms-playwright.playwright",
+		name: "Playwright Test for VSCode (Microsoft)",
+		description: "Suporte oficial para executar e debugar testes Playwright",
+	},
+	{
+		id: "dbaeumer.vscode-eslint",
+		name: "ESLint (Microsoft)",
+		description: "Linter JavaScript/TypeScript integrado ao VS Code",
+	},
+	{
+		id: "github.copilot",
+		name: "GitHub Copilot (GitHub)",
+		description: "Assistente de código AI do GitHub para produtividade",
+	},
+	{
+		id: "github.copilot-chat",
+		name: "GitHub Copilot Chat (GitHub)",
+		description: "Chat AI integrado para assistência de desenvolvimento",
+	},
+	{
+		id: "mikestead.dotenv",
+		name: "DotENV (mikestead)",
+		description:
+			"Sintaxe highlighting para arquivos .env e variáveis de ambiente",
+	},
+];
+
+/**
+ * 🔍 Detecta se está rodando em ambiente local (Windows)
+ */
+function isLocalEnvironment(): boolean {
+	const os = platform();
+	const isWindows = os === "win32";
+	const isCI =
+		process.env.CI === "true" ||
+		process.env.GITHUB_ACTIONS === "true" ||
+		process.env.AZURE_PIPELINES === "true" ||
+		process.env.BUILD_BUILDID !== undefined ||
+		process.env.SYSTEM_TEAMFOUNDATIONSERVERURI !== undefined;
+
+	console.log("🔍 Detectando ambiente:");
+	console.log(`   💻 Sistema operacional: ${os}`);
+	console.log(`   🏠 Windows (local): ${isWindows}`);
+	console.log(`   🤖 CI/CD detectado: ${isCI}`);
+
+	return isWindows && !isCI;
+}
+
+/**
+ * 🔍 Verifica se o VS Code está instalado verificando no filesystem
+ * (NÃO usa `code` CLI — evita abrir janelas do VS Code)
+ */
+function isVSCodeInstalled(): boolean {
+	const possiblePaths = [
+		path.join(
+			process.env.LOCALAPPDATA || "",
+			"Programs",
+			"Microsoft VS Code",
+			"Code.exe",
+		),
+		"C:\\Program Files\\Microsoft VS Code\\Code.exe",
+		"C:\\Program Files (x86)\\Microsoft VS Code\\Code.exe",
+	];
+	return possiblePaths.some((p) => p && fs.existsSync(p));
+}
+
+/**
+ * 🔍 Detecta extensões instaladas lendo o diretório ~/.vscode/extensions/
+ * (NÃO usa `code` CLI — evita abrir janelas do VS Code)
+ *
+ * Cada extensão fica em uma pasta: publisher.extensionname-version
+ */
+function getInstalledExtensionsFromDisk(): Set<string> {
+	const extensionsDir = path.join(
+		process.env.USERPROFILE || process.env.HOME || "",
+		".vscode",
+		"extensions",
+	);
+
+	if (!fs.existsSync(extensionsDir)) return new Set();
+
+	try {
+		const entries = fs.readdirSync(extensionsDir, { withFileTypes: true });
+		const installed = new Set<string>();
+		for (const entry of entries) {
+			if (!entry.isDirectory()) continue;
+			// Formato: publisher.name-version  →  extrair publisher.name
+			const match = entry.name.match(/^(.+?)-\d+\.\d+/);
+			if (match) {
+				installed.add(match[1].toLowerCase());
+			}
+		}
+		return installed;
+	} catch {
+		return new Set();
+	}
+}
+
+/**
+ * 🔍 Verifica se uma extensão específica está instalada (via filesystem, sem CLI)
+ */
+function isExtensionInstalled(extensionId: string): boolean {
+	const installed = getInstalledExtensionsFromDisk();
+	return installed.has(extensionId.toLowerCase());
+}
+
+// 🌐 Registry privado do Azure Artifacts (único registry para pacotes @rbqa)
+const AZURE_REGISTRY =
+	"https://pkgs.dev.azure.com/telefonica-vivo-brasil/_packaging/DevOps/npm/registry/";
+const WINDOWS_MCP_AUTOSTART_START_COMMAND =
+	"npx -y @silasfmartins/testhub-orchestrator-mcp";
+const WINDOWS_MCP_STARTUP_SCRIPT_FILE = "autocore-orchestrator-mcp.cmd";
+const WINDOWS_MCP_STARTUP_VBS_FILE = "autocore-orchestrator-mcp.vbs";
+
+/**
+ * � Executa comando shell com tratamento de erro melhorado
+ */
+async function execShellCommand(
+	command: string,
+	timeoutMs = 30000,
+	opts?: { withNpmRegistry?: boolean },
+): Promise<{ stdout: string; stderr: string } | null> {
+	try {
+		const env = opts?.withNpmRegistry
+			? { ...process.env, npm_config_registry: AZURE_REGISTRY }
+			: process.env;
+
+		const result = await execAsync(command, {
+			timeout: timeoutMs,
+			windowsHide: true,
+			shell: true,
+			env,
+		});
+		return result;
+	} catch (error) {
+		// Debug: mostrar erro se houver
+		if (process.env.DEBUG_MCP) {
+			console.log(`[DEBUG] Erro no comando: ${command}`);
+			console.log(
+				`[DEBUG] Erro: ${error instanceof Error ? error.message : error}`,
+			);
+		}
+		return null;
+	}
+}
+
+/**
+ * � Executa comando npm com registry privado configurado
+ */
+async function execNpmCommand(
+	command: string,
+	timeoutMs = 30000,
+): Promise<{ stdout: string; stderr: string } | null> {
+	return execShellCommand(command, timeoutMs, { withNpmRegistry: true });
+}
+
+/**
+ * 🔍 Obtém a versão instalada globalmente do pacote MCP
+ */
+async function getInstalledMcpVersion(): Promise<string | null> {
+	try {
+		const result = await execNpmCommand(
+			"npm list -g @silasfmartins/testhub-orchestrator-mcp --depth=0 --json",
+		);
+		if (!result) return null;
+		const data = JSON.parse(result.stdout);
+		return (
+			data.dependencies?.["@silasfmartins/testhub-orchestrator-mcp"]?.version || null
+		);
+	} catch {
+		return null;
+	}
+}
+
+/**
+ * 🔍 Obtém a última versão disponível do pacote MCP no registry privado
+ * Pacotes @rbqa só existem no registry privado do Azure
+ */
+async function getLatestMcpVersion(): Promise<string | null> {
+	try {
+		const result = await execNpmCommand(
+			`npm view @silasfmartins/testhub-orchestrator-mcp version --registry=${AZURE_REGISTRY}`,
+			30000,
+		);
+		if (!result) return null;
+		return result.stdout.trim() || null;
+	} catch {
+		return null;
+	}
+}
+
+/**
+ * 🔍 Verifica se o pacote @silasfmartins/testhub-orchestrator-mcp está instalado globalmente
+ */
+async function isMcpPackageInstalled(): Promise<boolean> {
+	try {
+		const result = await execNpmCommand(
+			"npm list -g @silasfmartins/testhub-orchestrator-mcp --depth=0",
+		);
+		return result
+			? result.stdout.includes("@silasfmartins/testhub-orchestrator-mcp")
+			: false;
+	} catch {
+		return false;
+	}
+}
+
+/**
+ * 🌐 Verifica se há acesso ao registry privado (Azure Artifacts)
+ * Retorna a versão disponível ou null se não há acesso
+ */
+async function checkRegistryAccess(): Promise<string | null> {
+	try {
+		// Tenta obter a versão do pacote no Azure Artifacts
+		const result = await execNpmCommand(
+			`npm view @silasfmartins/testhub-orchestrator-mcp version --registry=${AZURE_REGISTRY}`,
+			30000,
+		);
+		if (result && result.stdout.trim()) {
+			return result.stdout.trim();
+		}
+		return null;
+	} catch {
+		return null;
+	}
+}
+
+/**
+ * 📦 Instala ou atualiza o pacote @silasfmartins/testhub-orchestrator-mcp globalmente
+ *
+ * 🎯 COMPORTAMENTO:
+ * - Se já está na última versão: NÃO reinstala (economia de tempo)
+ * - Se versão antiga: atualiza automaticamente
+ * - Se não instalado: instala globalmente
+ * - Se offline: usa versão local existente (se houver)
+ *
+ * 🌐 INSTALAÇÃO GLOBAL:
+ * - O MCP é instalado GLOBALMENTE (npm install -g)
+ * - Fica disponível para TODOS os projetos da máquina
+ * - Não precisa reinstalar em cada projeto
+ */
+async function installMcpPackageGlobally(): Promise<boolean> {
+	console.log("📦 ======================================================");
+	console.log("📦 AutoCore Orchestrator MCP (Instalação Global)");
+	console.log("📦 ======================================================");
+	console.log();
+
+	try {
+		// 1️⃣ Verificar versão instalada globalmente
+		const installedVersion = await getInstalledMcpVersion();
+
+		if (installedVersion) {
+			console.log(`📌 Versão global instalada: ${installedVersion}`);
+		} else {
+			console.log("🆕 MCP não encontrado globalmente");
+		}
+
+		// 2️⃣ Verificar acesso ao registry e obter última versão
+		console.log("🔍 Verificando registry Azure Artifacts...");
+		const latestVersion = await checkRegistryAccess();
+
+		if (!latestVersion) {
+			console.log("🔒 Sem acesso ao registry Azure Artifacts (modo offline)");
+			if (installedVersion) {
+				console.log(`✅ Usando versão global existente: ${installedVersion}`);
+				return true;
+			}
+			console.log("⚠️  O MCP será executado via npx quando necessário");
+			console.log("   💡 Conecte-se à VPN e execute:");
+			console.log(
+				`   npm install -g @silasfmartins/testhub-orchestrator-mcp --registry=${AZURE_REGISTRY}`,
+			);
+			return false;
+		}
+
+		console.log(`🌐 Última versão disponível: ${latestVersion}`);
+
+		// 3️⃣ Comparar versões se já instalado
+		if (installedVersion) {
+			if (installedVersion === latestVersion) {
+				console.log("✅ MCP já está na última versão global - nada a fazer!");
+				console.log(
+					"   💡 Instalação global compartilhada entre todos os projetos",
+				);
+				return true;
+			}
+
+			// 4️⃣ Atualizar para última versão
+			console.log(`🔄 Atualizando MCP: ${installedVersion} → ${latestVersion}`);
+		} else {
+			console.log("🔄 Instalando MCP globalmente...");
+		}
+
+		// 5️⃣ Executar instalação/atualização
+		const installResult = await execNpmCommand(
+			`npm install -g @silasfmartins/testhub-orchestrator-mcp@${latestVersion} --registry=${AZURE_REGISTRY}`,
+			60000,
+		);
+
+		if (!installResult) {
+			console.log("⚠️  Falha ao instalar/atualizar MCP");
+			if (installedVersion) {
+				console.log(
+					`   ✅ Usando versão global existente: ${installedVersion}`,
+				);
+				return true;
+			}
+			return false;
+		}
+
+		const newVersion = await getInstalledMcpVersion();
+		if (installedVersion) {
+			console.log(
+				`✅ MCP atualizado globalmente: ${installedVersion} → ${newVersion || latestVersion}`,
+			);
+		} else {
+			console.log(
+				`✅ MCP instalado globalmente! (v${newVersion || latestVersion})`,
+			);
+		}
+		console.log("   💡 Disponível para todos os projetos da máquina");
+		return true;
+	} catch (error) {
+		console.warn("⚠️  Não foi possível instalar/atualizar MCP globalmente");
+
+		// Verificar se tem versão local que pode usar
+		const installedVersion = await getInstalledMcpVersion();
+		if (installedVersion) {
+			console.log(`   ✅ Usando versão global existente: ${installedVersion}`);
+			return true;
+		}
+
+		console.warn("   O MCP será executado via npx quando necessário");
+		if (error instanceof Error) {
+			console.warn(`   Erro: ${error.message}`);
+		}
+		return false;
+	}
+}
+
+/**
+ * ⚙️ Configura inicialização automática no Startup do usuário (sem admin, sem terminal visível)
+ */
+async function ensureWindowsStartupFolderAutostart(): Promise<boolean> {
+	try {
+		const appData =
+			process.env.APPDATA ||
+			path.join(process.env.USERPROFILE || "", "AppData", "Roaming");
+		if (!appData) return false;
+
+		const startupDir = path.join(
+			appData,
+			"Microsoft",
+			"Windows",
+			"Start Menu",
+			"Programs",
+			"Startup",
+		);
+		const startupCmdFile = path.join(
+			startupDir,
+			WINDOWS_MCP_STARTUP_SCRIPT_FILE,
+		);
+		const startupVbsFile = path.join(startupDir, WINDOWS_MCP_STARTUP_VBS_FILE);
+		const startupScript = [
+			"@echo off",
+			"cd /d %USERPROFILE%",
+			`call ${WINDOWS_MCP_AUTOSTART_START_COMMAND}`,
+			"",
+		].join("\r\n");
+		const startupVbs = [
+			'Set WshShell = CreateObject("WScript.Shell")',
+			`WshShell.Run Chr(34) & "${startupCmdFile}" & Chr(34), 0, False`,
+			"",
+		].join("\r\n");
+
+		fs.mkdirSync(startupDir, { recursive: true });
+		fs.writeFileSync(startupCmdFile, startupScript, "utf8");
+		fs.writeFileSync(startupVbsFile, startupVbs, "utf8");
+		console.log(
+			"✅ AutoStart via Startup do usuário configurado (sem admin, execução oculta)",
+		);
+		console.log(`   📍 Arquivo CMD: ${startupCmdFile}`);
+		console.log(`   📍 Arquivo VBS: ${startupVbsFile}`);
+
+		const runNow = await execShellCommand(
+			`wscript.exe "${startupVbsFile}"`,
+			15000,
+		);
+		if (runNow) {
+			console.log("✅ MCP iniciado agora em background (sem terminal visível)");
+		} else {
+			console.warn(
+				"⚠️  Startup configurado, mas não foi possível iniciar em background agora",
+			);
+			console.warn(`   💡 Rode manualmente: wscript.exe "${startupVbsFile}"`);
+		}
+		return true;
+	} catch (error) {
+		console.warn("⚠️  Falha ao configurar AutoStart via Startup do usuário");
+		if (error instanceof Error) {
+			console.warn(`   Erro: ${error.message}`);
+		}
+		return false;
+	}
+}
+
+/**
+ * ⚙️ Configura inicialização automática do MCP no logon do Windows (sem admin)
+ * Usa somente Startup do usuário (Task Scheduler removido por política).
+ */
+async function ensureWindowsMcpAutostart(): Promise<boolean> {
+	console.log("⚙️ ======================================================");
+	console.log("⚙️ Configurando AutoStart do MCP (Windows sem admin)");
+	console.log("⚙️ ======================================================");
+	console.log();
+
+	const startupOk = await ensureWindowsStartupFolderAutostart();
+	if (!startupOk) {
+		console.warn("⚠️  Falha ao configurar AutoStart do MCP via Startup.");
+	}
+	console.log();
+	return startupOk;
+}
+
+/**
+ * 🔧 Extrai user_hash de uma URL existente
+ */
+function extractUserHash(url: string): string {
+	const match = url.match(/user_hash=([a-zA-Z0-9]+)/);
+	return match ? match[1] : "";
+}
+
+/**
+ * 🔧 Cria ou atualiza o arquivo .vscode/mcp.json preservando hashes existentes
+ */
+async function ensureMcpConfig(): Promise<void> {
+	console.log("🔧 ======================================================");
+	console.log("🔧 Configurando MCP (Model Context Protocol)");
+	console.log("🔧 ======================================================");
+	console.log();
+
+	try {
+		const consumerProjectRoot = process.cwd();
+		const vscodeDir = path.join(consumerProjectRoot, ".vscode");
+		const mcpFile = path.join(vscodeDir, "mcp.json");
+
+		// Criar a pasta .vscode se não existir
+		if (!fs.existsSync(vscodeDir)) {
+			fs.mkdirSync(vscodeDir, { recursive: true });
+			console.log(`📁 Pasta .vscode criada em: ${vscodeDir}`);
+		}
+
+		// Configuração padrão (hashes vazios)
+		const defaultConfig = {
+			servers: {
+				"mcp-estimative": {
+					url: "http://brtlvlty0559pl:8080/estimative/mcp?user_hash=",
+					type: "http",
+				},
+				"autocore-orchestrator": {
+					command: "npx",
+					args: ["-y", "@silasfmartins/testhub-orchestrator-mcp"],
+					env: {
+						HUB_BACKEND_URL: "http://brtlvlty0559pl:3333",
+					},
+					type: "stdio",
+				},
+			},
+			inputs: [],
+		};
+
+		if (fs.existsSync(mcpFile)) {
+			// Arquivo existe - preservar hashes do usuário
+			const currentContent = JSON.parse(fs.readFileSync(mcpFile, "utf8"));
+
+			// Preservar hash do mcp-estimative
+			let existingEstimativeHash = "";
+			if (currentContent.servers?.["mcp-estimative"]?.url) {
+				existingEstimativeHash = extractUserHash(
+					currentContent.servers["mcp-estimative"].url,
+				);
+			}
+
+			// Construir configuração atualizada preservando hashes
+			const updatedConfig = {
+				servers: {
+					"mcp-estimative": {
+						url: `http://brtlvlty0559pl:8080/estimative/mcp?user_hash=${existingEstimativeHash}`,
+						type: "http",
+					},
+					"autocore-orchestrator": {
+						command: "npx",
+						args: ["-y", "@silasfmartins/testhub-orchestrator-mcp"],
+						env: {
+							HUB_BACKEND_URL: "http://brtlvlty0559pl:3333",
+						},
+						type: "stdio",
+					},
+				},
+				inputs: currentContent.inputs || [],
+			};
+
+			fs.writeFileSync(mcpFile, JSON.stringify(updatedConfig, null, 2));
+
+			if (existingEstimativeHash) {
+				console.log(
+					"✅ Arquivo mcp.json atualizado (hash mcp-estimative preservado)",
+				);
+			} else {
+				console.log("✅ Arquivo mcp.json atualizado");
+			}
+		} else {
+			// Criar novo arquivo com configuração padrão
+			fs.writeFileSync(mcpFile, JSON.stringify(defaultConfig, null, 2));
+			console.log("✅ Arquivo mcp.json criado");
+		}
+
+		console.log(`   📍 Local: ${mcpFile}`);
+		console.log();
+		console.log("🤖 MCP configurado para integração com AutoCore Hub!");
+		console.log(
+			"   🔹 autocore-orchestrator: Migração, geração de testes, documentação",
+		);
+		console.log("   🔹 mcp-estimative: Estimativas de produtividade AI");
+		console.log();
+		console.log("🔑 Para usar o MCP, configure seu user_hash:");
+		console.log(
+			"   📌 mcp-estimative: Adicione seu hash na URL em .vscode/mcp.json",
+		);
+		console.log("   📌 autocore-orchestrator:");
+		console.log("      No Windows: defina a variável de ambiente do usuário");
+		console.log("      HUB_MCP_USER_HASH com seu hash e reinicie o VS Code.");
+		console.log("      (Painel de Controle > Sistema > Variáveis de Ambiente)");
+	} catch (error) {
+		console.warn("⚠️  Aviso: Não foi possível configurar mcp.json");
+		if (error instanceof Error) {
+			console.warn(`   Erro: ${error.message}`);
+		}
+	}
+
+	console.log();
+}
+
+/**
+ * ✅ Verificar/Instalar browsers Playwright para projetos consumidores
+ */
+async function ensurePlaywrightForConsumer(): Promise<void> {
+	try {
+		const cwd = process.cwd();
+		const pkgFile = path.join(cwd, "package.json");
+		if (!fs.existsSync(pkgFile)) return;
+
+		const content = fs.readFileSync(pkgFile, "utf8");
+		const pkg = JSON.parse(content);
+
+		const hasPlaywright =
+			pkg.dependencies?.["@playwright/test"] ||
+			pkg.devDependencies?.["@playwright/test"];
+		if (!hasPlaywright) return;
+
+		// Respect pipeline/test-type overrides: if pipeline requests SSH tests, skip installing browsers
+		const pipelineTestType = (
+			process.env.FORCE_TEST_TYPE ||
+			process.env.TEST_TYPE ||
+			process.env.RUN_TEST_TYPE ||
+			""
+		).toUpperCase();
+		if (pipelineTestType === "SSH" || process.env.USE_SSH === "true") {
+			console.log(
+				"AutoCore Consumer: CI/pipeline indicates SSH tests - skipping Playwright browser installation",
+			);
+			return;
+		}
+
+		// Only install browsers for Web/Frontend or Scenarios projects
+		const projectTypeEnv = (
+			process.env.PROJECT_TYPE ||
+			process.env.PROJECTTYPE ||
+			""
+		).toUpperCase();
+		const isProjectTypeWebOrScenarios =
+			projectTypeEnv === "WEB" ||
+			projectTypeEnv === "FRONTEND" ||
+			projectTypeEnv === "SCENARIOS";
+
+		const hasFrontendScripts =
+			!!pkg.scripts?.["test:preprod"]?.includes("playwright test") ||
+			!!pkg.scripts?.["ui:preprod"] ||
+			!!pkg.scripts?.["codegen:preprod"];
+
+		if (!(isProjectTypeWebOrScenarios || hasFrontendScripts)) {
+			console.log(
+				"AutoCore Consumer: Projeto não é Web/Cenários — pulando instalação de browsers Playwright",
+			);
+			return;
+		}
+
+		const possiblePaths = [
+			path.join(cwd, "node_modules", ".cache", "ms-playwright"),
+			path.join(cwd, "node_modules", "playwright-core", ".local-browsers"),
+			path.join(cwd, "node_modules", "playwright", ".local-browsers"),
+		];
+
+		const browsersInstalled = possiblePaths.some((p) => fs.existsSync(p));
+		if (browsersInstalled) {
+			console.log("AutoCore Consumer: Browsers Playwright já instalados ✓");
+			return;
+		}
+
+		console.log(
+			"AutoCore Consumer: Instalando browsers Playwright (via npx)...",
+		);
+		try {
+			console.log(
+				"   ⚠️ Ajustando NODE_TLS_REJECT_UNAUTHORIZED=0 para evitar erros TLS durante o download",
+			);
+			await execAsync("npx playwright install --with-deps", {
+				timeout: 120000,
+				windowsHide: true,
+				shell: true,
+				env: { ...process.env, NODE_TLS_REJECT_UNAUTHORIZED: "0" },
+			});
+			console.log("AutoCore Consumer: Browsers Playwright instalados ✓");
+		} catch (e) {
+			console.warn(
+				"AutoCore Consumer: Falha no install --with-deps, tentando fallback...",
+			);
+			try {
+				await execAsync("npx playwright install", {
+					timeout: 120000,
+					windowsHide: true,
+					shell: true,
+					env: { ...process.env, NODE_TLS_REJECT_UNAUTHORIZED: "0" },
+				});
+				console.log("AutoCore Consumer: Browsers Playwright instalados ✓");
+			} catch (err) {
+				console.warn(
+					"AutoCore Consumer: Não foi possível instalar browsers Playwright automaticamente. Rode: npx playwright install",
+				);
+			}
+		}
+	} catch (error) {
+		if (process.env.DEBUG_MCP)
+			console.warn("Erro ao verificar Playwright consumer:", error);
+	}
+}
+
+/**
+ * 🚀 Função principal do postinstall
+ */
+async function main(): Promise<void> {
+	console.log("🎯 ======================================================");
+	console.log("🎯 AutoCore Consumer Project Postinstall");
+	console.log("🎯 ======================================================");
+	console.log();
+
+	// 1. Verificar se está em ambiente local
+	if (!isLocalEnvironment()) {
+		console.log("🤖 Ambiente CI/CD ou não-Windows detectado");
+		console.log();
+		return;
+	}
+
+	console.log("🏠 Ambiente local Windows detectado");
+	console.log();
+
+	// 2. Verificar se VS Code está instalado
+	const vscodeInstalled = isVSCodeInstalled();
+	if (!vscodeInstalled) {
+		console.log("⚠️  VS Code não foi encontrado no sistema");
+		console.log(
+			"💡 Para aproveitar todas as funcionalidades do AutoCore, instale o VS Code:",
+		);
+		console.log("   https://code.visualstudio.com/");
+		console.log();
+		return;
+	}
+
+	console.log("✅ VS Code encontrado no sistema");
+	console.log();
+
+	// 3. Verificar extensões recomendadas (NÃO instala automaticamente — evita abrir VS Code)
+	const missingExtensions: typeof REQUIRED_EXTENSIONS = [];
+
+	for (const extension of REQUIRED_EXTENSIONS) {
+		const isInstalled = isExtensionInstalled(extension.id);
+		if (isInstalled) {
+			console.log(`✅ ${extension.name}`);
+		} else {
+			missingExtensions.push(extension);
+		}
+	}
+
+	console.log();
+
+	// 4. Resumo final
+	console.log("📊 ======================================================");
+	console.log("📊 Resumo da Instalação");
+	console.log("📊 ======================================================");
+
+	if (missingExtensions.length === 0) {
+		console.log("💡 Seu ambiente AutoCore está pronto para uso!");
+	} else {
+		console.log(
+			`⚠️  ${missingExtensions.length} extensão(ões) recomendada(s) não encontrada(s):`,
+		);
+		console.log();
+		for (const ext of missingExtensions) {
+			console.log(`   📦 ${ext.name} — ${ext.description}`);
+			console.log(`      Instalar: code --install-extension ${ext.id}`);
+		}
+		console.log();
+		console.log("💡 Para instalar todas de uma vez, rode:");
+		const installCmd = missingExtensions
+			.map((e) => `code --install-extension ${e.id}`)
+			.join(" && ");
+		console.log(`   ${installCmd}`);
+	}
+
+	console.log();
+	console.log("🔧 Para mais informações sobre configuração do ambiente:");
+	console.log(
+		"   Acesse o site com a VPN ativada: http://brtlvlty0559pl:3002/",
+	);
+	console.log("   💬 Suporte: Equipe TestHUB");
+	console.log();
+
+	// 5. Instalar/Atualizar MCP globalmente
+	const mcpReady = await installMcpPackageGlobally();
+	console.log();
+
+	// 5.1 Configurar autostart local no logon do Windows
+	const autostartReady = await ensureWindowsMcpAutostart();
+	if (!mcpReady) {
+		console.log(
+			"⚠️  Instalação global do MCP não concluída; AutoStart usará npx no login do usuário",
+		);
+		console.log(
+			"   💡 Quando houver VPN/rede disponível, rode o postinstall novamente para atualizar via npm -g",
+		);
+		console.log();
+	}
+	if (!autostartReady) {
+		console.log("⚠️  AutoStart não pôde ser configurado automaticamente.");
+		console.log(
+			`   💡 Inicie manualmente em background: wscript.exe "%APPDATA%\\Microsoft\\Windows\\Start Menu\\Programs\\Startup\\${WINDOWS_MCP_STARTUP_VBS_FILE}"`,
+		);
+		console.log(
+			`   💡 Inicie agora (temporário): ${WINDOWS_MCP_AUTOSTART_START_COMMAND}`,
+		);
+		console.log();
+	}
+
+	// 6. Configurar arquivo .vscode/mcp.json
+	await ensureMcpConfig();
+
+	// 6.5 Verificar/Instalar Playwright para projetos consumidores
+	await ensurePlaywrightForConsumer();
+
+	// 7. Sincronizar configurações do AutoCore (biome.json e tsconfig.json)
+	console.log("🔄 ======================================================");
+	console.log("🔄 Sincronizando Configurações do AutoCore");
+	console.log("🔄 ======================================================");
+	console.log();
+
+	try {
+		// Executar sync-configs.ts via npx tsx (evita problemas de import/rootDir)
+		const syncConfigsPath = path.join(__dirname, "sync-configs.ts");
+
+		// 🎯 Tentar executar sync sem depender de pipeline Azure
+		// Funciona localmente e em qualquer ambiente
+		try {
+			await execAsync(`npx tsx "${syncConfigsPath}"`, {
+				timeout: 30000,
+				windowsHide: true,
+				shell: true,
+			});
+			console.log("✅ Configurações sincronizadas com sucesso!");
+		} catch (tsxError) {
+			// Fallback: tentar com ts-node se tsx falhar
+			try {
+				await execAsync(`npx ts-node "${syncConfigsPath}"`, {
+					timeout: 30000,
+					windowsHide: true,
+					shell: true,
+				});
+				console.log(
+					"✅ Configurações sincronizadas com sucesso! (via ts-node)",
+				);
+			} catch {
+				// Fallback final: tentar versão compilada JS
+				const syncConfigsJsPath = syncConfigsPath.replace(".ts", ".js");
+				if (fs.existsSync(syncConfigsJsPath)) {
+					await execAsync(`node "${syncConfigsJsPath}"`, {
+						timeout: 30000,
+						windowsHide: true,
+						shell: true,
+					});
+					console.log("✅ Configurações sincronizadas com sucesso! (via JS)");
+				} else {
+					throw tsxError;
+				}
+			}
+		}
+	} catch (error) {
+		console.warn(
+			"⚠️  Aviso: Não foi possível sincronizar configurações automaticamente",
+		);
+		console.warn(
+			"   💡 Você pode sincronizá-las manualmente executando: npm run sync",
+		);
+		if (error instanceof Error && !error.message.includes("timeout")) {
+			console.warn(`   Erro: ${error.message}`);
+		}
+	}
+
+	console.log();
+
+	// 8. Sincronizar GitHub Copilot Instructions
+	await syncCopilotInstructions();
+}
+
+/**
+ * 🤖 Sincroniza o arquivo copilot-instructions.md para o projeto consumidor
+ * Garante que o GitHub Copilot entenda os padrões do AutoCore/TestHub
+ */
+async function syncCopilotInstructions(): Promise<void> {
+	console.log("🤖 ======================================================");
+	console.log("🤖 Sincronizando GitHub Copilot Instructions");
+	console.log("🤖 ======================================================");
+	console.log();
+
+	try {
+		// Caminho do arquivo fonte no AutoCore
+		// Se estiver em dist/scripts, subir dois níveis; senão, um nível
+		const isDist = __dirname.includes("dist");
+		const levelsUp = isDist ? "../.." : "..";
+		const sourceFile = path.join(
+			__dirname,
+			levelsUp,
+			".github",
+			"copilot-instructions.md",
+		);
+
+		// Caminho do projeto consumidor (onde o npm install foi executado)
+		const consumerProjectRoot = process.cwd();
+		const targetDir = path.join(consumerProjectRoot, ".github");
+		const targetFile = path.join(targetDir, "copilot-instructions.md");
+
+		console.log(`📂 Caminho fonte: ${sourceFile}`);
+		console.log(`📂 Caminho destino: ${targetFile}`);
+		console.log();
+
+		// Verificar se o arquivo fonte existe
+		if (!fs.existsSync(sourceFile)) {
+			console.warn(
+				"⚠️  Arquivo copilot-instructions.md não encontrado no AutoCore",
+			);
+			console.warn(`   Caminho esperado: ${sourceFile}`);
+			console.warn(`   __dirname: ${__dirname}`);
+			return;
+		}
+
+		// Criar a pasta .github se não existir
+		if (!fs.existsSync(targetDir)) {
+			fs.mkdirSync(targetDir, { recursive: true });
+			console.log(`📁 Pasta .github criada em: ${targetDir}`);
+		}
+
+		// Ler o conteúdo do arquivo fonte
+		const sourceContent = fs.readFileSync(sourceFile, "utf-8");
+
+		// Verificar se o arquivo já existe no destino
+		let shouldUpdate = true;
+		if (fs.existsSync(targetFile)) {
+			const targetContent = fs.readFileSync(targetFile, "utf-8");
+
+			// Comparar conteúdos
+			if (sourceContent === targetContent) {
+				console.log("✅ copilot-instructions.md já está atualizado");
+				shouldUpdate = false;
+			} else {
+				console.log(
+					"🔄 Atualizando copilot-instructions.md (nova versão disponível)",
+				);
+			}
+		} else {
+			console.log("📝 Criando copilot-instructions.md no projeto");
+		}
+
+		// Copiar/Atualizar o arquivo se necessário
+		if (shouldUpdate) {
+			// Adicionar cabeçalho informando que é gerado automaticamente
+			const headerComment = `<!--
+  🤖 ARQUIVO GERADO AUTOMATICAMENTE PELO AUTOCORE
+  ⚠️  NÃO EDITE MANUALMENTE - Será sobrescrito no próximo npm install
+  📅 Última atualização: ${new Date().toISOString()}
+  📦 Fonte: @silasfmartins/testhub
+-->
+
+`;
+			const finalContent = headerComment + sourceContent;
+
+			fs.writeFileSync(targetFile, finalContent, "utf-8");
+			console.log("✅ copilot-instructions.md sincronizado com sucesso!");
+			console.log(`   📍 Destino: ${targetFile}`);
+		}
+
+		console.log();
+		console.log(
+			"💡 O GitHub Copilot agora entende os padrões do AutoCore/TestHub!",
+		);
+		console.log("   🔹 Migração Java → TypeScript");
+		console.log("   🔹 Geração de testes automatizados");
+		console.log("   🔹 Padrões de Page Objects, Fixtures e Statements");
+		console.log(
+			"   🔹 Uso correto de TestHubVars, DataStore, WebActions, ApiActions, SSHActions",
+		);
+	} catch (error) {
+		console.warn(
+			"⚠️  Aviso: Não foi possível sincronizar copilot-instructions.md",
+		);
+		if (error instanceof Error) {
+			console.warn(`   Erro: ${error.message}`);
+		}
+	}
+
+	console.log();
+}
+
+// Executar main() sempre que chamado diretamente via tsx/node
+const isMainModule =
+	process.argv[1]?.endsWith("consumer-postinstall.ts") ||
+	process.argv[1]?.endsWith("consumer-postinstall.js");
+if (isMainModule) {
+	main().catch((error) => {
+		console.error("💥 Erro durante o postinstall:", error);
+		process.exit(1);
+	});
+}
+
+export { main as consumerPostinstall };