smoonb 0.0.98 → 0.0.99

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "smoonb",
-  "version": "0.0.98",
+  "version": "0.0.99",
   "description": "Complete Supabase backup and migration tool - EXPERIMENTAL VERSION - USE AT YOUR OWN RISK",
   "preferGlobal": false,
   "preventGlobalInstall": true,

package/src/commands/backup/index.js

@@ -24,6 +24,7 @@ const step09EdgeFunctions = require('./steps/09-edge-functions');
 const step10SupabaseTemp = require('./steps/10-supabase-temp');
 const step11Migrations = require('./steps/11-migrations');
 const { sendTelemetry } = require('../../telemetry');
+const ui = require('../../utils/cliUi');
 
 // Exportar FUNÇÃO em vez de objeto Command
 module.exports = async (options) => {
@@ -142,7 +143,7 @@ module.exports = async (options) => {
       console.log(chalk.yellow(`   2. ${getT('backup.error.databaseUrlStep2')}`));
       console.log('');
       console.log(chalk.blue(`💡 ${getT('backup.error.databaseUrlExample')}:`));
-      console.log(chalk.gray(`   ${getT('backup.error.databaseUrlExampleValue')}`));
+      ui.hint(`   ${getT('backup.error.databaseUrlExampleValue')}`);
       console.log('');
       console.log(chalk.red(`🚫 ${getT('backup.error.databaseUrlCancelled')}`));
       process.exit(1);
@@ -157,9 +158,9 @@ module.exports = async (options) => {
       console.log(chalk.yellow(`   3. ${getT('backup.error.accessTokenStep3')}`));
       console.log('');
       console.log(chalk.blue(`🔗 ${getT('backup.error.accessTokenHowTo')}:`));
-      console.log(chalk.gray(`   ${getT('backup.error.accessTokenStep1Detail')}`));
-      console.log(chalk.gray(`   ${getT('backup.error.accessTokenStep2Detail')}`));
-      console.log(chalk.gray(`   ${getT('backup.error.accessTokenStep3Detail')}`));
+      ui.hint(`   ${getT('backup.error.accessTokenStep1Detail')}`);
+      ui.hint(`   ${getT('backup.error.accessTokenStep2Detail')}`);
+      ui.hint(`   ${getT('backup.error.accessTokenStep3Detail')}`);
       console.log('');
       console.log(chalk.red(`🚫 ${getT('backup.error.accessTokenCancelled')}`));
       process.exit(1);
@@ -169,7 +170,7 @@ module.exports = async (options) => {
     if (!postgresMajorRaw) {
       console.log(chalk.red(`❌ ${getT('backup.error.postgresMajorNotSet')}`));
       console.log(chalk.white(`   ${getT('backup.error.postgresMajorInstructions')}`));
-      printSupabasePostgresMajorHintOnce(getT, chalk);
+      printSupabasePostgresMajorHintOnce(getT);
       console.log('');
       process.exit(1);
     }
@@ -177,7 +178,7 @@ module.exports = async (options) => {
     if (Number.isNaN(parsedMajor) || !isPostgresMajorSupported(parsedMajor, true)) {
       console.log(chalk.red(`❌ ${getT('backup.error.postgresMajorInvalid')}`));
       console.log(chalk.white(`   ${getT('backup.error.postgresMajorInstructions')}`));
-      printSupabasePostgresMajorHintOnce(getT, chalk);
+      printSupabasePostgresMajorHintOnce(getT);
       console.log('');
       process.exit(1);
     }

package/src/commands/backup/steps/00-license.js

@@ -1,10 +1,10 @@
-const chalk = require('chalk');
 const https = require('https');
 const inquirer = require('inquirer');
 const path = require('path');
 const { readEnvFile, writeEnvFile } = require('../../../utils/env');
 const { APP_CONFIG } = require('../../../config/appConfig');
 const { t } = require('../../../i18n');
+const ui = require('../../../utils/cliUi');
 const {
   createCorrelationId,
   maskSecret,
@@ -78,12 +78,12 @@ function httpsPost(url, body, headers, timeoutMs) {
 
 /**
  * Exibe erro estruturado + instruções de suporte + bundle (pronto para colar).
+ * Usa ui (sem gray/dim) para legibilidade em Windows e copy/paste.
  * @param {Function} getT
- * @param {object} chalk
  * @param {string} appUrl - APP_CONFIG.appUrl
  * @param {object} opts
  */
-function printLicenseValidationError(getT, chalk, appUrl, opts) {
+function printLicenseValidationError(getT, appUrl, opts) {
   const {
     correlationId,
     kind,
@@ -137,29 +137,29 @@ function printLicenseValidationError(getT, chalk, appUrl, opts) {
       : kind === 'parse' ? 'license.error.typeParse'
         : 'license.error.typeNetwork';
 
-  console.log(chalk.red(`\n❌ ${getT('license.error.title')}\n`));
-  console.log(chalk.white(`   ${getT('license.error.whatHappened')}`));
-  console.log(chalk.white(`   ${getT(typeKey)}`));
+  ui.error(`\n❌ ${getT('license.error.title')}\n`);
+  ui.info(`   ${getT('license.error.whatHappened')}`);
+  ui.info(`   ${getT(typeKey)}`);
   if (httpStatus != null) {
-    console.log(chalk.white(`   ${getT('license.error.status', { status: `${httpStatus} ${(httpStatusText || '').trim()}` })}`));
+    ui.info(`   ${getT('license.error.status', { status: `${httpStatus} ${(httpStatusText || '').trim()}` })}`);
   }
   if (endpoint || fullUrl) {
-    console.log(chalk.white(`   ${getT('license.error.endpoint', { endpoint: fullUrl || endpoint })}`));
+    ui.info(`   ${getT('license.error.endpoint', { endpoint: fullUrl || endpoint })}`);
   }
-  console.log(chalk.white(`   ${getT('license.error.correlationId', { id: correlationId })}\n`));
+  ui.info(`   ${getT('license.error.correlationId', { id: correlationId })}\n`);
 
-  console.log(chalk.cyan(`   ${getT('license.error.howToHelp')}`));
-  console.log(chalk.white(`   ${getT('license.error.supportStep1', { url: appUrl })}`));
-  console.log(chalk.white(`   ${getT('license.error.supportStep2')}`));
-  console.log(chalk.white(`   ${getT('license.error.supportStep3')}`));
-  console.log(chalk.white(`   ${getT('license.error.supportStep4')}`));
-  console.log(chalk.white(`   ${getT('license.error.supportStep5')}\n`));
+  ui.link(`   ${getT('license.error.howToHelp')}`);
+  ui.info(`   ${getT('license.error.supportStep1', { url: appUrl })}`);
+  ui.info(`   ${getT('license.error.supportStep2')}`);
+  ui.info(`   ${getT('license.error.supportStep3')}`);
+  ui.info(`   ${getT('license.error.supportStep4')}`);
+  ui.info(`   ${getT('license.error.supportStep5')}\n`);
 
-  console.log(chalk.gray(formatBundleForTerminal(bundleText)));
-  console.log('');
-  console.log(chalk.cyan(`   ${getT('license.error.visit', { url: appUrl })}\n`));
-  console.log(chalk.gray(`   ${getT('license.error.subjectSuggestion', { id: correlationId })}`));
-  console.log(chalk.gray(`   ${getT('license.error.messageSuggestion')}\n`));
+  ui.block(formatBundleForTerminal(bundleText));
+  ui.info('');
+  ui.link(`   ${getT('license.error.visit', { url: appUrl })}\n`);
+  ui.hint(`   ${getT('license.error.subjectSuggestion', { id: correlationId })}`);
+  ui.hint(`   ${getT('license.error.messageSuggestion')}\n`);
 }
 
 /**
@@ -191,8 +191,8 @@ module.exports = async (options) => {
     }]);
     licenseKey = (prompted || '').toString().trim();
     if (!licenseKey) {
-      console.log(chalk.red(`❌ ${getT('license.required')}`));
-      console.log(chalk.cyan(`   ${appUrl}`));
+      ui.error(`❌ ${getT('license.required')}`);
+      ui.link(`   ${appUrl}`);
       process.exit(1);
     }
     const currentEnv = await readEnvFile(envPath);
@@ -226,9 +226,9 @@ module.exports = async (options) => {
     const correlationId = createCorrelationId();
     const classification = classifyRequestError(err);
     if (classification.hintUser) {
-      console.log(chalk.yellow(`   ${classification.hintUser}`));
+      ui.warn(`   ${classification.hintUser}`);
     }
-    printLicenseValidationError(getT, chalk, appUrl, {
+    printLicenseValidationError(getT, appUrl, {
       correlationId,
       kind: classification.kind,
       endpoint: ENDPOINT_PATH,
@@ -250,7 +250,7 @@ module.exports = async (options) => {
     const correlationId = createCorrelationId();
     const responseHeadersStr = safeStringifyHeaders(headers);
     const responseBodyTruncated = truncateBody(rawBody);
-    printLicenseValidationError(getT, chalk, appUrl, {
+    printLicenseValidationError(getT, appUrl, {
       correlationId,
       kind: 'parse',
       endpoint: ENDPOINT_PATH,
@@ -269,7 +269,7 @@ module.exports = async (options) => {
     const correlationId = createCorrelationId();
     const responseHeadersStr = safeStringifyHeaders(headers);
     const responseBodyTruncated = rawBody ? truncateBody(rawBody) : '';
-    printLicenseValidationError(getT, chalk, appUrl, {
+    printLicenseValidationError(getT, appUrl, {
       correlationId,
       kind: 'http',
       httpStatus: statusCode,
@@ -290,14 +290,14 @@ module.exports = async (options) => {
   const status = resBody.status || '';
 
   if (!valid || ['expired', 'canceled'].includes(status)) {
-    console.log(chalk.red(`❌ ${getT('license.invalidOrInactive')}`));
-    console.log(chalk.white(`   ${getT('license.openDesktopApp')}`));
-    console.log(chalk.cyan(`   ${appUrl}`));
+    ui.error(`❌ ${getT('license.invalidOrInactive')}`);
+    ui.info(`   ${getT('license.openDesktopApp')}`);
+    ui.link(`   ${appUrl}`);
     process.exit(1);
   }
 
   if (status === 'trial') {
-    console.log(chalk.yellow(`   ⚠️ ${getT('license.trialNotice')}`));
+    ui.warn(`   ⚠️ ${getT('license.trialNotice')}`);
   }
 
   const license = {

package/src/commands/backup/steps/11-migrations.js

@@ -4,6 +4,7 @@ const { execSync } = require('child_process');
 const { extractPasswordFromDbUrl, ensureCleanLink } = require('../../../utils/supabaseLink');
 const { cleanDir, countFiles, copyDirSafe } = require('../../../utils/fsExtra');
 const { t } = require('../../../i18n');
+const ui = require('../../../utils/cliUi');
 
 /**
  * Etapa 10: Migrations Backup (NOVA ETAPA INDEPENDENTE)
@@ -62,7 +63,7 @@ module.exports = async (context) => {
     
     if (shouldClean) {
       await cleanDir(migrationsDir);
-      console.log(chalk.gray(`   - ${getT('backup.steps.migrations.cleaned')}`));
+      ui.hint(`   - ${getT('backup.steps.migrations.cleaned')}`);
     }
     
     return {

package/src/commands/backup/utils.js

@@ -1,5 +1,6 @@
 const chalk = require('chalk');
 const { t } = require('../../i18n');
+const ui = require('../../utils/cliUi');
 
 const SUPPORTED_MAJORS_DEFAULT = [15, 17];
 const SUPPORTED_MAJORS_ADVANCED = [16, 18];
@@ -53,7 +54,7 @@ function showDockerMessagesAndExit(reason, data = {}) {
       console.log('');
       console.log(chalk.blue(`🔗 ${getT('docker.download')}`));
       console.log('');
-      console.log(chalk.gray(`💡 ${getT('docker.requiredComponents')}`));
+      ui.hint(`💡 ${getT('docker.requiredComponents')}`);
       break;
 
     case 'docker_not_running':
@@ -66,7 +67,7 @@ function showDockerMessagesAndExit(reason, data = {}) {
       console.log('');
       console.log(chalk.blue(`💡 ${getT('docker.tip')}`));
       console.log('');
-      console.log(chalk.gray(`💡 ${getT('docker.requiredComponents')}`));
+      ui.hint(`💡 ${getT('docker.requiredComponents')}`);
       break;
 
     case 'supabase_cli_not_found':
@@ -78,7 +79,7 @@ function showDockerMessagesAndExit(reason, data = {}) {
       console.log('');
       console.log(chalk.blue(`🔗 ${getT('supabase.installLink')}`));
       console.log('');
-      console.log(chalk.gray(`💡 ${getT('supabase.requiredComponents')}`));
+      ui.hint(`💡 ${getT('supabase.requiredComponents')}`);
       break;
 
     case 'supabase_cli_outdated':
@@ -89,22 +90,22 @@ function showDockerMessagesAndExit(reason, data = {}) {
       console.log(chalk.cyan(`   ${getT('supabase.cliUpdateCommandGlobal')}`));
       console.log(chalk.cyan(`   ${getT('supabase.cliUpdateCommandLocal')}`));
       console.log('');
-      console.log(chalk.gray(`💡 ${getT('supabase.cliUpdateLink')}`));
+      ui.hint(`💡 ${getT('supabase.cliUpdateLink')}`);
       break;
 
     case 'supabase_cli_latest_unknown':
       console.log(chalk.red(`❌ ${getT('supabase.cliLatestUnknown')}`));
       console.log('');
       console.log(chalk.yellow(`📋 ${getT('supabase.cliLatestErrorLabel')}`));
-      console.log(chalk.gray(`   ${data.latestError || getT('supabase.cliLatestErrorUnknown')}`));
+      ui.hint(`   ${data.latestError || getT('supabase.cliLatestErrorUnknown')}`);
       console.log('');
-      console.log(chalk.gray(`💡 ${getT('supabase.cliUpdateLink')}`));
+      ui.hint(`💡 ${getT('supabase.cliUpdateLink')}`);
       break;
   }
 
   console.log('');
   console.log(chalk.red(`🚫 ${getT('docker.cancelled')}`));
-  console.log(chalk.gray(`   ${getT('docker.installComponents')}`));
+  ui.hint(`   ${getT('docker.installComponents')}`);
   console.log('');
   
   process.exit(1);

package/src/commands/config.js

@@ -3,6 +3,7 @@ const fs = require('fs').promises;
 const path = require('path');
 const { showBetaBanner } = require('../utils/banner');
 const { t } = require('../i18n');
+const ui = require('../utils/cliUi');
 
 // Exportar FUNÇÃO em vez de objeto Command
 module.exports = async (options) => {
@@ -20,8 +21,8 @@ module.exports = async (options) => {
       await showConfig(configPath);
     } else {
       console.log(chalk.yellow(`💡 ${getT('config.options')}`));
-      console.log(chalk.gray(`  ${getT('config.initOption')}`));
-      console.log(chalk.gray(`  ${getT('config.showOption')}`));
+      ui.hint(`  ${getT('config.initOption')}`);
+      ui.hint(`  ${getT('config.showOption')}`);
     }
 
   } catch (error) {
@@ -63,9 +64,9 @@ async function initializeConfig(configPath) {
     await fs.writeFile(configPath, JSON.stringify(defaultConfig, null, 2));
     console.log(chalk.green(`✅ ${getT('config.fileCreated', { path: '.smoonbrc' })}`));
     console.log(chalk.yellow('\n📝 Próximos passos:'));
-    console.log(chalk.gray('  1. Edite .smoonbrc com suas credenciais Supabase'));
-    console.log(chalk.gray('  2. Substitua os valores placeholder pelos reais'));
-    console.log(chalk.gray('  3. Execute: npx smoonb backup'));
+    ui.hint('  1. Edite .smoonbrc com suas credenciais Supabase');
+    ui.hint('  2. Substitua os valores placeholder pelos reais');
+    ui.hint('  3. Execute: npx smoonb backup');
   } catch (error) {
     const getT = global.smoonbI18n?.t || t;
     throw new Error(`${getT('config.error')}: ${error.message}`);
@@ -82,60 +83,60 @@ async function showConfig(configPath) {
     const config = JSON.parse(configContent);
 
     console.log(chalk.green('✅ Arquivo de configuração encontrado'));
-    console.log(chalk.gray(`   - Localização: ${configPath}`));
+    ui.hint(`   - Localização: ${configPath}`);
     
     if (config.supabase?.projectId && config.supabase.projectId !== 'your-project-id-here') {
-      console.log(chalk.gray(`   - Project ID: ${config.supabase.projectId}`));
+      ui.hint(`   - Project ID: ${config.supabase.projectId}`);
     } else {
       console.log(chalk.yellow('   - Project ID: Não configurado'));
     }
     
     if (config.supabase?.url && config.supabase.url !== 'https://your-project-id.supabase.co') {
-      console.log(chalk.gray(`   - Supabase URL: ${config.supabase.url}`));
+      ui.hint(`   - Supabase URL: ${config.supabase.url}`);
     } else {
       console.log(chalk.yellow('   - Supabase URL: Não configurado'));
     }
     
     if (config.supabase?.serviceKey && config.supabase.serviceKey !== 'your-service-key-here') {
-      console.log(chalk.gray('   - Service Key: Configurada'));
+      ui.hint('   - Service Key: Configurada');
     } else {
       console.log(chalk.yellow('   - Service Key: Não configurada'));
     }
     
     if (config.supabase?.anonKey && config.supabase.anonKey !== 'your-anon-key-here') {
-      console.log(chalk.gray('   - Anon Key: Configurada'));
+      ui.hint('   - Anon Key: Configurada');
     } else {
       console.log(chalk.yellow('   - Anon Key: Não configurada'));
     }
     
     if (config.supabase?.databaseUrl && !config.supabase.databaseUrl.includes('[password]')) {
-      console.log(chalk.gray('   - Database URL: Configurada'));
+      ui.hint('   - Database URL: Configurada');
     } else {
       console.log(chalk.yellow('   - Database URL: Não configurada'));
     }
     
     if (config.supabase?.accessToken && config.supabase.accessToken !== 'your-personal-access-token-here') {
-      console.log(chalk.gray('   - Access Token: Configurado'));
+      ui.hint('   - Access Token: Configurado');
     } else {
       console.log(chalk.yellow('   - Access Token: Não configurado (obrigatório para Management API)'));
     }
 
     console.log(chalk.blue('\n📊 Configurações de backup:'));
-    console.log(chalk.gray(`   - Output Dir: ${config.backup?.outputDir || './backups'}`));
-    console.log(chalk.gray(`   - Include Functions: ${config.backup?.includeFunctions || true}`));
-    console.log(chalk.gray(`   - Include Storage: ${config.backup?.includeStorage || true}`));
-    console.log(chalk.gray(`   - Include Auth: ${config.backup?.includeAuth || true}`));
-    console.log(chalk.gray(`   - Include Realtime: ${config.backup?.includeRealtime || true}`));
+    ui.hint(`   - Output Dir: ${config.backup?.outputDir || './backups'}`);
+    ui.hint(`   - Include Functions: ${config.backup?.includeFunctions || true}`);
+    ui.hint(`   - Include Storage: ${config.backup?.includeStorage || true}`);
+    ui.hint(`   - Include Auth: ${config.backup?.includeAuth || true}`);
+    ui.hint(`   - Include Realtime: ${config.backup?.includeRealtime || true}`);
 
     console.log(chalk.blue('\n🔄 Configurações de restore:'));
-    console.log(chalk.gray(`   - Clean Restore: ${config.restore?.cleanRestore || true}`));
-    console.log(chalk.gray(`   - Verify After Restore: ${config.restore?.verifyAfterRestore || true}`));
+    ui.hint(`   - Clean Restore: ${config.restore?.cleanRestore || true}`);
+    ui.hint(`   - Verify After Restore: ${config.restore?.verifyAfterRestore || true}`);
 
   } catch (error) {
     const getT = global.smoonbI18n?.t || t;
     if (error.code === 'ENOENT') {
       console.log(chalk.yellow(`⚠️  ${getT('config.fileNotFound', { path: configPath })}`));
-      console.log(chalk.gray('   - Use: npx smoonb config --init'));
+      ui.hint('   - Use: npx smoonb config --init');
     } else {
       throw new Error(`${getT('config.error')}: ${error.message}`);
     }

package/src/commands/functions.js

@@ -3,6 +3,7 @@ const { ensureBin, runCommand } = require('../utils/cli');
 const { readConfig, validateFor } = require('../utils/config');
 const { showBetaBanner } = require('../utils/banner');
 const { t } = require('../i18n');
+const ui = require('../utils/cliUi');
 
 // Exportar FUNÇÃO em vez de objeto Command
 module.exports = async (_options) => {
@@ -23,13 +24,13 @@ module.exports = async (_options) => {
 
     console.log(chalk.blue(`⚡ ${getT('functions.availableCommands')}`));
     console.log(chalk.yellow(`\n📋 ${getT('functions.list')}`));
-    console.log(chalk.gray('  npx smoonb functions list'));
+    ui.hint('  npx smoonb functions list');
     console.log(chalk.yellow(`\n🚀 ${getT('functions.deploy')}`));
-    console.log(chalk.gray('  npx smoonb functions push'));
+    ui.hint('  npx smoonb functions push');
     console.log(chalk.yellow(`\n📥 ${getT('functions.pull')}`));
-    console.log(chalk.gray('  npx smoonb functions pull'));
+    ui.hint('  npx smoonb functions pull');
     console.log(chalk.yellow(`\n💡 ${getT('functions.moreOptions')}`));
-    console.log(chalk.gray('  supabase functions --help'));
+    ui.hint('  supabase functions --help');
 
   } catch (error) {
     const getT = global.smoonbI18n?.t || t;
@@ -120,9 +121,9 @@ async function pullFunctions(projectRef) {
 
     console.log(chalk.yellow('⚠️ Pull de Edge Functions não é oficialmente suportado pelo Supabase CLI'));
     console.log(chalk.yellow('💡 Para baixar código das functions remotas:'));
-    console.log(chalk.gray('  1. Use o Dashboard do Supabase'));
-    console.log(chalk.gray('  2. Ou clone o código do seu repositório Git'));
-    console.log(chalk.gray('  3. Ou use a API do Supabase diretamente'));
+    ui.hint('  1. Use o Dashboard do Supabase');
+    ui.hint('  2. Ou clone o código do seu repositório Git');
+    ui.hint('  3. Ou use a API do Supabase diretamente');
     console.log(chalk.blue('\n📚 Documentação: https://supabase.com/docs/guides/functions'));
 
   } catch (error) {

package/src/commands/restore/steps/03-database.js

@@ -2,6 +2,7 @@ const chalk = require('chalk');
 const path = require('path');
 const { execSync } = require('child_process');
 const { t } = require('../../../i18n');
+const ui = require('../../../utils/cliUi');
 
 /**
  * Etapa 3: Restaurar Database via psql
@@ -62,7 +63,7 @@ module.exports = async ({ backupFilePath, targetDatabaseUrl }) => {
     execSync(restoreCmd, { stdio: 'inherit', encoding: 'utf8' });
     
     console.log(chalk.green(`   ✅ ${getT('restore.steps.database.success')}`));
-    console.log(chalk.gray(`   ℹ️ ${getT('restore.steps.database.normalErrors')}`));
+    ui.hint(`   ℹ️ ${getT('restore.steps.database.normalErrors')}`);
     
   } catch (error) {
     // Erros esperados conforme documentação oficial Supabase
@@ -73,7 +74,7 @@ module.exports = async ({ backupFilePath, targetDatabaseUrl }) => {
         error.stdout?.includes('already exists')) {
       console.log(chalk.yellow(`   ⚠️ ${getT('restore.steps.database.expectedErrors')}`));
       console.log(chalk.green(`   ✅ ${getT('restore.steps.database.success')}`));
-      console.log(chalk.gray(`   ℹ️ ${getT('restore.steps.database.errorsIgnored')}`));
+      ui.hint(`   ℹ️ ${getT('restore.steps.database.errorsIgnored')}`);
     } else {
       console.error(chalk.red(`   ❌ ${getT('restore.steps.database.error', { message: error.message })}`));
       throw error;

package/src/index.js

@@ -9,6 +9,7 @@ const chalk = require('chalk');
 const path = require('path');
 const { showBetaBanner } = require('./utils/banner');
 const { t } = require('./i18n');
+const ui = require('./utils/cliUi');
 
 // Exportar comandos
 const backupCommand = require('./commands/backup');
@@ -139,7 +140,7 @@ function showPrerequisitesStatus() {
   Object.entries(prerequisites).forEach(([name, info]) => {
     const icon = info.installed ? '✅' : '❌';
     const status = info.installed ? chalk.green('Instalado') : chalk.red('Não instalado');
-    const version = info.version ? chalk.gray(`(${info.version})`) : '';
+    const version = info.version ? `(${info.version})` : '';
     
     console.log(`  ${icon} ${chalk.cyan(name)}: ${status} ${version}`);
   });
@@ -153,11 +154,11 @@ function showPrerequisitesStatus() {
     console.log(chalk.yellow.bold('\n💡 Instruções de instalação:'));
     
     if (missing.includes('supabase_cli')) {
-      console.log(chalk.gray('  - Supabase CLI: npm install -g supabase'));
+      ui.hint('  - Supabase CLI: npm install -g supabase');
     }
     
     if (missing.includes('pg_dump')) {
-      console.log(chalk.gray('  - PostgreSQL: https://www.postgresql.org/download/'));
+      ui.hint('  - PostgreSQL: https://www.postgresql.org/download/');
     }
   }
 }
@@ -173,29 +174,29 @@ function checkCurrentConfig() {
   
   if (config) {
     console.log(chalk.green('✅ Arquivo de configuração encontrado'));
-    console.log(chalk.gray(`   - Localização: ${path.join(process.cwd(), '.env.local')}`));
+    ui.hint(`   - Localização: ${path.join(process.cwd(), '.env.local')}`);
     
     if (config.supabase?.url) {
-      console.log(chalk.gray(`   - Supabase URL: ${config.supabase.url}`));
+      ui.hint(`   - Supabase URL: ${config.supabase.url}`);
     }
     
     if (config.supabase?.serviceKey) {
-      console.log(chalk.gray('   - Service Key: Configurada'));
+      ui.hint('   - Service Key: Configurada');
     }
     
     if (config.supabase?.anonKey) {
-      console.log(chalk.gray('   - Anon Key: Configurada'));
+      ui.hint('   - Anon Key: Configurada');
     }
   } else {
     console.log(chalk.yellow('⚠️  Arquivo de configuração não encontrado'));
-    console.log(chalk.gray('   - Configure o arquivo .env.local na raiz do projeto'));
+    ui.hint('   - Configure o arquivo .env.local na raiz do projeto');
   }
   
   if (hasCredentials) {
     console.log(chalk.green('✅ Credenciais configuradas'));
   } else {
     console.log(chalk.yellow('⚠️  Credenciais não configuradas'));
-    console.log(chalk.gray('   - Configure SUPABASE_URL e SUPABASE_ANON_KEY'));
+    ui.hint('   - Configure SUPABASE_URL e SUPABASE_ANON_KEY');
   }
 }
 

package/src/interactive/envMapper.js

@@ -2,15 +2,16 @@ const inquirer = require('inquirer');
 const chalk = require('chalk');
 const { confirm } = require('../utils/prompt');
 const { t } = require('../i18n');
+const ui = require('../utils/cliUi');
 
 let _printedSupabasePostgresMajorHint = false;
 
-function printSupabasePostgresMajorHintOnce(getT, chalk) {
+function printSupabasePostgresMajorHintOnce(getT) {
   if (_printedSupabasePostgresMajorHint) return;
   _printedSupabasePostgresMajorHint = true;
-  console.log(chalk.cyan(`   ℹ️ ${getT('env.supabasePostgresMajor.hintTitle')}`));
-  console.log(chalk.white(`      ${getT('env.supabasePostgresMajor.hintPath')}`));
-  console.log(chalk.gray(`      ${getT('env.supabasePostgresMajor.hintBody')}`));
+  ui.link(`   ℹ️ ${getT('env.supabasePostgresMajor.hintTitle')}`);
+  ui.info(`      ${getT('env.supabasePostgresMajor.hintPath')}`);
+  ui.hint(`      ${getT('env.supabasePostgresMajor.hintBody')}`);
 }
 
 async function mapEnvVariablesInteractively(env, expectedKeys) {
@@ -123,13 +124,13 @@ async function mapEnvVariablesInteractively(env, expectedKeys) {
   for (const expected of expectedKeys) {
     console.log(chalk.blue(`\n🔧 ${getT('env.mapping.title', { variable: expected })}`));
     if (expected === 'SUPABASE_POSTGRES_MAJOR') {
-      printSupabasePostgresMajorHintOnce(getT, chalk);
+      printSupabasePostgresMajorHintOnce(getT);
     }
     if (expected === 'SMOONB_LICENSE_KEY' && instructions.help === '') {
-      console.log(chalk.gray(`   ${getT('env.licenseKey.help')}`));
+      ui.hint(`   ${getT('env.licenseKey.help')}`);
     }
     if (expected === 'SMOONB_TELEMETRY_ENABLED' && instructions.help === '') {
-      console.log(chalk.gray(`   ${getT('env.telemetry.help')}`));
+      ui.hint(`   ${getT('env.telemetry.help')}`);
     }
 
     let clientKey = undefined;
@@ -179,7 +180,7 @@ async function mapEnvVariablesInteractively(env, expectedKeys) {
     if (!currentValue) {
       console.log(chalk.yellow(getT('env.mapping.notFound', { variable: expected })));
       if (expected === 'SUPABASE_POSTGRES_MAJOR') {
-        printSupabasePostgresMajorHintOnce(getT, chalk);
+        printSupabasePostgresMajorHintOnce(getT);
       } else if (instructions.help) {
         // Se o help contém link (https://), mostrar como link
         if (instructions.help.includes('https://')) {

package/src/utils/cliUi.js

@@ -0,0 +1,104 @@
+/**
+ * UI/console padronizado do smoonb CLI.
+ * Toda saída para o usuário usa este módulo para legibilidade (incl. Windows PowerShell).
+ * Regras: sem chalk.dim/chalk.gray/chalk.blackBright em blocos longos; cores só para rótulos/ênfase.
+ * Saída principal em stdout.
+ */
+const chalk = require('chalk');
+
+const stdout = process.stdout;
+
+function writeOut(msg) {
+  stdout.write(msg + (msg.endsWith('\n') ? '' : '\n'));
+}
+
+/**
+ * Título / cabeçalho (cyan, boa leitura).
+ */
+function title(text) {
+  writeOut(chalk.cyan(text));
+}
+
+/**
+ * Texto informativo (branco/default, nunca dim/gray).
+ */
+function info(text) {
+  writeOut(chalk.white(text));
+}
+
+/**
+ * Aviso (amarelo).
+ */
+function warn(text) {
+  writeOut(chalk.yellow(text));
+}
+
+/**
+ * Erro (vermelho). Opcionalmente enviar só a primeira linha para stderr (resto stdout).
+ */
+function error(text) {
+  writeOut(chalk.red(text));
+}
+
+/**
+ * Passo / label de etapa (azul).
+ */
+function step(text) {
+  writeOut(chalk.blue(text));
+}
+
+/**
+ * Sucesso (verde).
+ */
+function success(text) {
+  writeOut(chalk.green(text));
+}
+
+/**
+ * Link ou destaque secundário (cyan, não apagado).
+ */
+function link(text) {
+  writeOut(chalk.cyan(text));
+}
+
+/**
+ * Bloco de texto longo (ex.: bundle de diagnóstico) — SEM cor para copiar/colar e legibilidade.
+ */
+function block(text) {
+  if (Array.isArray(text)) {
+    text.forEach((line) => writeOut(line));
+  } else {
+    writeOut(String(text));
+  }
+}
+
+/**
+ * Múltiplas linhas em cor padrão (branco), sem dim/gray.
+ */
+function multiline(text) {
+  writeOut(chalk.white(String(text)));
+}
+
+/**
+ * Sugestão / hint curto — branco para manter legível (não gray).
+ */
+function hint(text) {
+  writeOut(chalk.white(text));
+}
+
+const ui = {
+  title,
+  info,
+  warn,
+  error,
+  step,
+  success,
+  link,
+  block,
+  multiline,
+  hint,
+  // Para código que precisa do chalk com restrições (ex.: formatação inline)
+  chalk
+};
+
+module.exports = ui;