smoonb 1.0.4 → 1.0.5

package/CHANGELOG.md

@@ -4,6 +4,21 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [1.0.5] - 2026-02-21
+
+### Added
+
+- **Flexible Supabase CLI version check** – Instead of requiring the exact latest version, smoonb now accepts any CLI version that is at most 1 minor behind the latest (same major). The minimum accepted version is computed as `major.(minor_latest - 1).0` at runtime from the npm registry. Special case: if `minor_latest === 0`, only the same major.minor is accepted.
+- **`--skip-supabase-version-check` flag** – New opt-in flag for both `backup` and `restore` commands. When set, the Supabase CLI version check is skipped entirely and a warning is displayed. Useful when package managers (e.g. Scoop on Windows) lag behind on updates and the user wants to proceed at their own risk.
+
+### Changed
+
+- Error message for outdated Supabase CLI now shows the computed minimum accepted version (`minVersion`) and the current latest, instead of only the latest.
+- README (EN and PT-BR): updated Supabase CLI prerequisites section with the new version policy, added examples with `--skip-supabase-version-check`, updated commands table and troubleshooting section.
+- i18n strings (`en.json`, `pt-BR.json`): removed specific version number references in favour of evergreen language ("always use the latest version").
+
+---
+
 ## [1.0.4] - 2025-01-29
 
 ### Changed
@@ -32,56 +47,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ---
 
-## [1.0.2] - 2025-01-29
-
-### Fixed
-
-- **Backup report** – When Realtime settings are reused from a previous backup file, the final summary now correctly shows "Settings imported from backup {name}" (or the pt-BR equivalent) instead of "Configurations captured interactively"
-
----
-
-## [1.0.1] - 2025-01-29
-
-### Removed
-
-- **`check` command** – Post-restore integrity verification command removed from CLI, help and documentation
-- **`--skip-realtime`** – Backup option removed; Realtime settings are always captured interactively
-- **`--file` and `--storage` on restore** – Restore no longer accepts direct file paths; use `import` then `restore` to select from the list
-- **`--lang`** – CLI language option removed; language is determined by `SMOONB_LANG` (env or `.env.local`) and system locale only
-
-### Changed
-
-- README and README.pt-BR: all `#` comment lines removed from code blocks (replaced with normal text) to avoid light-gray rendering issues
-- Restore flow: backup selection is always interactive (no skip via `--file`)
-- i18n: `detectLocale` no longer reads `--lang` from argv; precedence is SMOONB_LANG → system locale → en
-
----
-
-## [1.0.0] - 2025-01-29
-
-### Added
-
-- Commercial release. Use requires an active license and valid subscription (or trial). See https://www.smoonb.com/#price
-- License validation (step 00) at the start of backup and restore; CLI aborts if validation fails
-- Restore disclaimer before execution: expected errors during DB restore, link to Supabase docs, wait for completion and test result
-- Environment variables: `SMOONB_LICENSE_KEY` (required), `SMOONB_TELEMETRY_ENABLED` (optional), `SUPABASE_POSTGRES_MAJOR` (required for backup and restore)
-- i18n (en, pt-BR) for all user-facing messages and help
-
-### Changed
-
-- Backup flow: terms → license validation → Docker → consent → variable mapping (license not in wizard) → component selection → summary → execution
-- Restore flow: terms → license validation → Docker → consent → mapping (includes `SUPABASE_POSTGRES_MAJOR`) → backup selection → component selection → summary → disclaimer → execution
-- Help and README aligned with commercial product; legal disclaimers unchanged
-- Documentation and links point to https://www.smoonb.com (terms, privacy, #price, #faq)
-
-### Fixed
-
-- `instructions` used before definition in interactive env mapper; blocks moved after `getVariableInstructions()`
-
 ---
 
+[1.0.5]: https://github.com/almmello/smoonb/releases/tag/v1.0.5
 [1.0.4]: https://github.com/almmello/smoonb/releases/tag/v1.0.4
-[1.0.3]: https://github.com/almmello/smoonb/releases/tag/v1.0.3
-[1.0.2]: https://github.com/almmello/smoonb/releases/tag/v1.0.2
-[1.0.1]: https://github.com/almmello/smoonb/releases/tag/v1.0.1
-[1.0.0]: https://github.com/almmello/smoonb/releases/tag/v1.0.0

package/README.md

@@ -92,7 +92,11 @@ docker ps
 npm install -g supabase
 ```
 
-We recommend **Supabase CLI v2.72 or newer** for new features and bug fixes. To update: [Updating the Supabase CLI](https://supabase.com/docs/guides/cli/getting-started#updating-the-supabase-cli).
+**Version policy:** smoonb accepts any Supabase CLI version that is **at most 1 minor behind the latest** (same major). We recommend always using the latest version. Versions that are too old are blocked with an error message.
+
+If your package manager (e.g. **Scoop** on Windows) lags behind on updates and you want to proceed anyway, use the `--skip-supabase-version-check` flag (see usage section below).
+
+To update the Supabase CLI: [Updating the Supabase CLI](https://supabase.com/docs/guides/cli/getting-started#updating-the-supabase-cli).
 
 ### 3. Supabase Personal Access Token
 You need to obtain a Supabase personal access token to use the Management API:
@@ -190,6 +194,17 @@ Language is detected automatically in the following order of precedence:
 npx smoonb backup
 ```
 
+**Available options:**
+
+| Flag | Description |
+|------|-------------|
+| `--skip-supabase-version-check` | Skips the Supabase CLI version check. Use when your package manager (e.g. Scoop) lags behind on updates. A warning is shown and the user assumes the risk. |
+
+**Example with flag:**
+```bash
+npx smoonb backup --skip-supabase-version-check
+```
+
 **Interactive backup flow:**
 
 1. **Terms of use** - Displays and requests acceptance of terms
@@ -252,6 +267,17 @@ backups/backup-2025-10-31-09-37-54/
 npx smoonb restore
 ```
 
+**Available options:**
+
+| Flag | Description |
+|------|-------------|
+| `--skip-supabase-version-check` | Skips the Supabase CLI version check. Use when your package manager (e.g. Scoop) lags behind on updates. A warning is shown and the user assumes the risk. |
+
+**Example with flag:**
+```bash
+npx smoonb restore --skip-supabase-version-check
+```
+
 **Interactive restore flow:**
 
 1. **Terms of use** - Displays and requests acceptance of terms
@@ -345,7 +371,9 @@ After running `import`, run `restore` to choose the imported backup from the lis
 | Command | Description |
 |---------|-------------|
 | `npx smoonb backup` | Full interactive backup using Docker |
+| `npx smoonb backup --skip-supabase-version-check` | Backup skipping the Supabase CLI version check |
 | `npx smoonb restore` | Interactive restoration using psql (Docker) |
+| `npx smoonb restore --skip-supabase-version-check` | Restore skipping the Supabase CLI version check |
 | `npx smoonb import --file <path> [--storage <path>]` | Import .backup.gz file and optionally .storage.zip from Supabase Dashboard |
 
 ## 🏗️ Technical Architecture
@@ -519,6 +547,28 @@ If not, start Docker Desktop (Windows/macOS) or run `sudo systemctl start docker
 npm install -g supabase
 ```
 
+### Supabase CLI outdated (below minimum accepted version)
+
+smoonb accepts versions up to **1 minor behind the latest**. If your installed version is below that threshold, you will see a message like:
+
+```
+❌ Supabase CLI X.Y.Z is below the minimum accepted version (X.W.0). Latest: X.V.Z. Update to at least version X.W.0.
+```
+
+**Option 1 — Update the Supabase CLI:**
+```bash
+npm install -g supabase@latest   # global install
+npm install supabase@latest       # local/project install
+```
+
+**Option 2 — Skip the check (temporary, user assumes the risk):**
+```bash
+npx smoonb backup --skip-supabase-version-check
+npx smoonb restore --skip-supabase-version-check
+```
+
+> **Note for Scoop users (Windows):** the Scoop repository may take a few days to update after a release. Use `--skip-supabase-version-check` until Scoop ships the updated version.
+
 ### Invalid or missing Personal Access Token
 
 1. Verify if `SUPABASE_ACCESS_TOKEN` is in `.env.local`

package/README.pt-BR.md

@@ -92,7 +92,11 @@ docker ps
 npm install -g supabase
 ```
 
-Recomendamos **Supabase CLI v2.72 ou mais recente** para novos recursos e correções. Para atualizar: [Atualizando o Supabase CLI](https://supabase.com/docs/guides/cli/getting-started#updating-the-supabase-cli).
+**Política de versão:** o smoonb aceita qualquer versão do Supabase CLI que esteja **no máximo 1 minor atrás da latest** (mesma major). Recomendamos sempre usar a versão mais recente. Versões muito antigas são bloqueadas com mensagem de erro.
+
+Se o seu gerenciador de pacotes (ex.: **Scoop** no Windows) instala com atraso e você quer avançar mesmo assim, use a flag `--skip-supabase-version-check` (veja a seção de uso abaixo).
+
+Para atualizar o Supabase CLI: [Atualizando o Supabase CLI](https://supabase.com/docs/guides/cli/getting-started#updating-the-supabase-cli).
 
 ### 3. Personal Access Token do Supabase
 É necessário obter um token de acesso pessoal do Supabase para usar a Management API:
@@ -190,6 +194,17 @@ O idioma é detectado automaticamente na seguinte ordem de precedência:
 npx smoonb backup
 ```
 
+**Opções disponíveis:**
+
+| Flag | Descrição |
+|------|-----------|
+| `--skip-supabase-version-check` | Pula a checagem de versão do Supabase CLI. Use quando seu gerenciador de pacotes (ex.: Scoop) instala com atraso. Um aviso é exibido e o usuário assume o risco. |
+
+**Exemplo com a flag:**
+```bash
+npx smoonb backup --skip-supabase-version-check
+```
+
 **Fluxo interativo do backup:**
 
 1. **Termo de uso** - Exibe e solicita aceitação dos termos
@@ -252,6 +267,17 @@ backups/backup-2025-10-31-09-37-54/
 npx smoonb restore
 ```
 
+**Opções disponíveis:**
+
+| Flag | Descrição |
+|------|-----------|
+| `--skip-supabase-version-check` | Pula a checagem de versão do Supabase CLI. Use quando seu gerenciador de pacotes (ex.: Scoop) instala com atraso. Um aviso é exibido e o usuário assume o risco. |
+
+**Exemplo com a flag:**
+```bash
+npx smoonb restore --skip-supabase-version-check
+```
+
 **Fluxo interativo do restore:**
 
 1. **Termo de uso** - Exibe e solicita aceitação dos termos
@@ -345,7 +371,9 @@ Após executar `import`, execute `restore` para escolher o backup importado na l
 | Comando | Descrição |
 |---------|-----------|
 | `npx smoonb backup` | Backup completo interativo usando Docker |
+| `npx smoonb backup --skip-supabase-version-check` | Backup pulando a checagem de versão do Supabase CLI |
 | `npx smoonb restore` | Restauração interativa usando psql (Docker) |
+| `npx smoonb restore --skip-supabase-version-check` | Restore pulando a checagem de versão do Supabase CLI |
 | `npx smoonb import --file <path> [--storage <path>]` | Importar arquivo .backup.gz e opcionalmente .storage.zip do Dashboard do Supabase |
 
 ## 🏗️ Arquitetura Técnica
@@ -519,6 +547,28 @@ Se não estiver, inicie o Docker Desktop (Windows/macOS) ou execute `sudo system
 npm install -g supabase
 ```
 
+### Supabase CLI desatualizado (abaixo da versão mínima aceita)
+
+O smoonb aceita versões até **1 minor atrás da latest**. Se sua versão instalada estiver abaixo desse limite, você verá uma mensagem como:
+
+```
+❌ Supabase CLI X.Y.Z está abaixo da versão mínima aceita (X.W.0). Versão latest: X.V.Z. Atualize para pelo menos a versão X.W.0.
+```
+
+**Opção 1 — Atualizar o Supabase CLI:**
+```bash
+npm install -g supabase@latest   # instalação global
+npm install supabase@latest       # instalação local/projeto
+```
+
+**Opção 2 — Pular a checagem (temporariamente, risco do usuário):**
+```bash
+npx smoonb backup --skip-supabase-version-check
+npx smoonb restore --skip-supabase-version-check
+```
+
+> **Nota para usuários de Scoop (Windows):** o repositório do Scoop pode levar alguns dias para atualizar após um release. Use `--skip-supabase-version-check` até que o Scoop disponibilize a versão atualizada.
+
 ### Personal Access Token inválido ou ausente
 
 1. Verificar se `SUPABASE_ACCESS_TOKEN` está no `.env.local`

package/bin/smoonb.js

@@ -79,6 +79,10 @@ program
     const getT = global.smoonbI18n?.t || t;
     return getT('help.commands.backupDesc');
   })
+  .option('--skip-supabase-version-check', () => {
+    const getT = global.smoonbI18n?.t || t;
+    return getT('help.commands.skipSupabaseVersionCheck');
+  })
   .addHelpText('after', () => {
     const getT = global.smoonbI18n?.t || t;
     return `
@@ -86,6 +90,9 @@ ${chalk.yellow.bold(getT('help.commands.backupExamples'))}
   ${chalk.white(getT('help.commands.backupExample1'))}
   ${chalk.white(getT('help.commands.backupExample1Desc'))}
 
+  ${chalk.white(getT('help.commands.backupExample3'))}
+  ${chalk.white(getT('help.commands.backupExample3Desc'))}
+
 ${chalk.yellow.bold(getT('help.commands.backupFlow'))}
   ${getT('help.commands.backupFlow1')}
   ${getT('help.commands.backupFlow2')}
@@ -120,6 +127,10 @@ program
     const getT = global.smoonbI18n?.t || t;
     return getT('help.commands.restoreDesc');
   })
+  .option('--skip-supabase-version-check', () => {
+    const getT = global.smoonbI18n?.t || t;
+    return getT('help.commands.skipSupabaseVersionCheck');
+  })
   .addHelpText('after', () => {
     const getT = global.smoonbI18n?.t || t;
     return `
@@ -127,6 +138,9 @@ ${chalk.yellow.bold(getT('help.commands.restoreExamples'))}
   ${chalk.white(getT('help.commands.restoreExample1'))}
   ${chalk.white(getT('help.commands.restoreExample1Desc'))}
 
+  ${chalk.white(getT('help.commands.restoreExample4'))}
+  ${chalk.white(getT('help.commands.restoreExample4Desc'))}
+
 ${chalk.yellow.bold(getT('help.commands.restoreFlow'))}
   ${getT('help.commands.restoreFlow1')}
   ${getT('help.commands.restoreFlow2')}
@@ -144,7 +158,7 @@ ${chalk.yellow.bold(getT('help.commands.restoreFormats'))}
   ${getT('help.commands.restoreFormats2')}
 `;
   })
-  .action(() => commands.restore({}));
+  .action((options) => commands.restore(options));
 
 program
   .command('import')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "smoonb",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "Complete Supabase backup and migration tool. https://www.smoonb.com/#price",
   "preferGlobal": false,
   "preventGlobalInstall": true,

package/src/commands/backup/index.js

@@ -51,7 +51,7 @@ module.exports = async (options) => {
     const licenseResult = await step00License({ envPath, command: 'backup' });
 
     // Executar validação Docker
-    await step01DockerValidation();
+    await step01DockerValidation({ skipSupabaseVersionCheck: !!(options && options.skipSupabaseVersionCheck) });
 
     // Consentimento para leitura e escrita do .env.local
     console.log(chalk.yellow(`\n⚠️  ${getT('consent.title')}`));

package/src/commands/backup/steps/01-docker-validation.js

@@ -6,17 +6,25 @@ const { t } = require('../../../i18n');
 /**
  * Etapa 0: Validação Docker
  * Deve ocorrer antes de tudo
+ * @param {object} [options]
+ * @param {boolean} [options.skipSupabaseVersionCheck=false]
  */
-module.exports = async () => {
+module.exports = async (options = {}) => {
   const getT = global.smoonbI18n?.t || t;
   console.log(chalk.blue(`\n🐳 ${getT('docker.validation.title')}`));
   console.log(chalk.cyan(`🔍 ${getT('docker.validation.checking')}`));
   
-  const backupCapability = await canPerformCompleteBackup();
+  const backupCapability = await canPerformCompleteBackup({
+    skipSupabaseVersionCheck: options.skipSupabaseVersionCheck || false
+  });
 
   if (!backupCapability.canBackupComplete) {
     showDockerMessagesAndExit(backupCapability.reason, backupCapability);
   }
+
+  if (backupCapability.supabaseVersionCheckSkipped) {
+    console.log(chalk.yellow(`⚠️  ${getT('supabase.cliVersionSkipWarning')}`));
+  }
   
   console.log(chalk.green(`✅ ${getT('docker.validation.detected')}`));
   console.log(chalk.white(`🐳 ${getT('docker.validation.version', { version: backupCapability.dockerStatus.version })}`));

package/src/commands/backup/utils.js

@@ -83,7 +83,7 @@ function showDockerMessagesAndExit(reason, data = {}) {
       break;
 
     case 'supabase_cli_outdated':
-      console.log(chalk.red(`❌ ${getT('supabase.cliOutdated', { version: data.supabaseCliVersion || '?', latest: data.supabaseCliLatest || '?' })}`));
+      console.log(chalk.red(`❌ ${getT('supabase.cliOutdated', { version: data.supabaseCliVersion || '?', minVersion: data.supabaseCliMinVersion || '?', latest: data.supabaseCliLatest || '?' })}`));
       console.log('');
       console.log(chalk.yellow(`📋 ${getT('supabase.cliUpdateInstructions')}`));
       console.log(chalk.cyan(`   ${getT('supabase.cliUpdateCommandExamples')}`));

package/src/commands/restore/index.js

@@ -25,7 +25,7 @@ const step07DatabaseSettings = require('./steps/07-database-settings');
 const step08RealtimeSettings = require('./steps/08-realtime-settings');
 const { sendTelemetry } = require('../../telemetry');
 
-module.exports = async () => {
+module.exports = async (options = {}) => {
   showBetaBanner();
   const restoreStartTime = Date.now();
   let telemetryEnabled = (process.env.SMOONB_TELEMETRY_ENABLED || 'true') !== 'false';
@@ -49,7 +49,7 @@ module.exports = async () => {
     await step00License({ envPath: envPathForLicense, command: 'restore' });
 
     // Executar validação Docker
-    await step01DockerValidation();
+    await step01DockerValidation({ skipSupabaseVersionCheck: !!(options && options.skipSupabaseVersionCheck) });
 
     // Consentimento para leitura e escrita do .env.local
     ui.warn(`\n⚠️  ${getT('consent.title')}`);

package/src/i18n/locales/en.json

@@ -72,8 +72,10 @@
   "supabase.installLink": "Installation: npm install -g supabase",
   "supabase.required": "Supabase CLI is required for full Supabase backup",
   "supabase.requiredComponents": "Supabase CLI is required for full Supabase backup\n   - PostgreSQL Database\n   - Edge Functions\n   - All components via Docker",
-  "supabase.cliUpdateRecommended": "Supabase CLI {version} detected. We recommend v2.72 or newer for new features and bug fixes: https://supabase.com/docs/guides/cli/getting-started#updating-the-supabase-cli",
-  "supabase.cliOutdated": "Supabase CLI {version} is not the latest ({latest}). Update to the latest version.",
+  "supabase.cliVersionPolicy": "Version policy: accepts any version up to 1 minor behind the latest (same major). Use --skip-supabase-version-check to bypass the check.",
+  "supabase.cliUpdateRecommended": "Supabase CLI {version} detected. We recommend always using the latest version for new features and bug fixes: https://supabase.com/docs/guides/cli/getting-started#updating-the-supabase-cli",
+  "supabase.cliOutdated": "Supabase CLI {version} is below the minimum accepted version ({minVersion}). Latest: {latest}. Update to at least version {minVersion}.",
+  "supabase.cliVersionSkipWarning": "Supabase CLI version check disabled (--skip-supabase-version-check). Proceeding without version check — user assumes the risk.",
   "supabase.cliUpdateInstructions": "Update the Supabase CLI and run smoonb again:",
   "supabase.cliUpdateCommandExamples": "Examples (depending on how you installed):",
   "supabase.cliUpdateCommandGlobal": "npm install -g supabase@latest   (global)",
@@ -166,6 +168,7 @@
   "help.tip5": "• Storage file format must be: *.storage.zip",
 
   "help.commands.backupDesc": "Create a full backup of your Supabase project using Supabase CLI",
+  "help.commands.skipSupabaseVersionCheck": "Skip the Supabase CLI version check (user assumes the risk)",
   "help.commands.backupSkipRealtime": "Skip interactive capture of Realtime Settings",
   "help.commands.backupPostgresMajor": "Postgres major version for dump (15, 17). Non-interactive; no menu.",
   "help.commands.backupExamples": "Examples:",
@@ -173,6 +176,8 @@
   "help.commands.backupExample1Desc": "# Complete interactive process",
   "help.commands.backupExample2": "npx smoonb backup --skip-realtime",
   "help.commands.backupExample2Desc": "# Skips Realtime Settings configuration",
+  "help.commands.backupExample3": "npx smoonb backup --skip-supabase-version-check",
+  "help.commands.backupExample3Desc": "# Skips Supabase CLI version check (use when your package manager lags behind, e.g. Scoop)",
   "help.commands.backupWhat": "What is captured:",
   "help.commands.backupWhat1": "• Database PostgreSQL (pg_dumpall + separate SQL)",
   "help.commands.backupWhat2": "• Database Extensions and Settings",
@@ -206,6 +211,8 @@
   "help.commands.restoreExample2Desc": "# Imports and restores backup file directly",
   "help.commands.restoreExample3": "npx smoonb restore --file \"backup.backup.gz\" --storage \"my-project.storage.zip\"",
   "help.commands.restoreExample3Desc": "# Imports and restores backup and storage together",
+  "help.commands.restoreExample4": "npx smoonb restore --skip-supabase-version-check",
+  "help.commands.restoreExample4Desc": "# Skips Supabase CLI version check (use when your package manager lags behind, e.g. Scoop)",
   "help.commands.restoreFlow": "Restore flow:",
   "help.commands.restoreFlow1": "1. Terms of use",
   "help.commands.restoreFlow2": "2. License validation (SMOONB_LICENSE_KEY)",

package/src/i18n/locales/pt-BR.json

@@ -72,8 +72,10 @@
   "supabase.installLink": "Instalação: npm install -g supabase",
   "supabase.required": "Supabase CLI é obrigatório para backup completo do Supabase",
   "supabase.requiredComponents": "Supabase CLI é obrigatório para backup completo do Supabase\n   - Database PostgreSQL\n   - Edge Functions\n   - Todos os componentes via Docker",
-  "supabase.cliUpdateRecommended": "Supabase CLI {version} detectado. Recomendamos v2.72 ou mais recente para novos recursos e correções: https://supabase.com/docs/guides/cli/getting-started#updating-the-supabase-cli",
-  "supabase.cliOutdated": "Supabase CLI {version} não é a versão mais recente ({latest}). Atualize para a última versão.",
+  "supabase.cliVersionPolicy": "Política de versão: aceita qualquer versão até 1 minor atrás da latest (mesma major). Use --skip-supabase-version-check para pular a checagem.",
+  "supabase.cliUpdateRecommended": "Supabase CLI {version} detectado. Recomendamos sempre usar a versão mais recente para obter novos recursos e correções: https://supabase.com/docs/guides/cli/getting-started#updating-the-supabase-cli",
+  "supabase.cliOutdated": "Supabase CLI {version} está abaixo da versão mínima aceita ({minVersion}). Versão latest: {latest}. Atualize para pelo menos a versão {minVersion}.",
+  "supabase.cliVersionSkipWarning": "Checagem de versão do Supabase CLI desabilitada (--skip-supabase-version-check). Prosseguindo sem verificar a versão — o usuário assume o risco.",
   "supabase.cliUpdateInstructions": "Atualize o Supabase CLI e execute o smoonb novamente:",
   "supabase.cliUpdateCommandExamples": "Exemplos (conforme a forma de instalação):",
   "supabase.cliUpdateCommandGlobal": "npm install -g supabase@latest   (global)",
@@ -166,6 +168,7 @@
   "help.tip5": "• O formato do arquivo de storage deve ser: *.storage.zip",
 
   "help.commands.backupDesc": "Fazer backup completo do projeto Supabase usando Supabase CLI",
+  "help.commands.skipSupabaseVersionCheck": "Pular checagem de versão do Supabase CLI (o usuário assume o risco)",
   "help.commands.backupSkipRealtime": "Pular captura interativa de Realtime Settings",
   "help.commands.backupPostgresMajor": "Versão major do Postgres para o dump (15, 17). Não interativo; sem menu.",
   "help.commands.backupExamples": "Exemplos:",
@@ -173,6 +176,8 @@
   "help.commands.backupExample1Desc": "# Processo interativo completo",
   "help.commands.backupExample2": "npx smoonb backup --skip-realtime",
   "help.commands.backupExample2Desc": "# Pula configuração de Realtime Settings",
+  "help.commands.backupExample3": "npx smoonb backup --skip-supabase-version-check",
+  "help.commands.backupExample3Desc": "# Pula checagem de versão do Supabase CLI (use quando seu gerenciador de pacotes instala com atraso, ex.: Scoop)",
   "help.commands.backupWhat": "O que é capturado:",
   "help.commands.backupWhat1": "• Database PostgreSQL (pg_dumpall + SQL separado)",
   "help.commands.backupWhat2": "• Database Extensions and Settings",
@@ -206,6 +211,8 @@
   "help.commands.restoreExample2Desc": "# Importa e restaura diretamente o arquivo de backup",
   "help.commands.restoreExample3": "npx smoonb restore --file \"backup.backup.gz\" --storage \"meu-projeto.storage.zip\"",
   "help.commands.restoreExample3Desc": "# Importa e restaura backup e storage juntos",
+  "help.commands.restoreExample4": "npx smoonb restore --skip-supabase-version-check",
+  "help.commands.restoreExample4Desc": "# Pula checagem de versão do Supabase CLI (use quando seu gerenciador de pacotes instala com atraso, ex.: Scoop)",
   "help.commands.restoreFlow": "Fluxo do restore:",
   "help.commands.restoreFlow1": "1. Termo de uso",
   "help.commands.restoreFlow2": "2. Validação de licença (SMOONB_LICENSE_KEY)",

package/src/utils/docker.js

@@ -100,6 +100,21 @@ function compareSemver(a, b) {
   return 0;
 }
 
+/**
+ * Calcula a versão mínima aceita: no máximo 1 minor atrás da latest.
+ * Ex: latest "2.76.12" → "2.75.0"; latest "3.0.5" → "3.0.0"
+ * @param {string} latestVersion
+ * @returns {string|null}
+ */
+function getMinAcceptableVersion(latestVersion) {
+  if (!latestVersion) return null;
+  const parts = latestVersion.split('.').map(Number);
+  const major = parts[0] || 0;
+  const minor = parts[1] || 0;
+  const minMinor = Math.max(0, minor - 1);
+  return `${major}.${minMinor}.0`;
+}
+
 /**
  * Detecta Docker Desktop completo com versão
  * @returns {Promise<{installed: boolean, running: boolean, version: string}>}
@@ -159,9 +174,11 @@ async function detectDockerDependencies() {
 
 /**
  * Detecta se é possível fazer backup completo via Docker
+ * @param {object} [opts]
+ * @param {boolean} [opts.skipSupabaseVersionCheck=false] - Pular checagem de versão do Supabase CLI
  * @returns {Promise<{canBackupComplete: boolean, reason?: string, dockerStatus: any}>}
  */
-async function canPerformCompleteBackup() {
+async function canPerformCompleteBackup({ skipSupabaseVersionCheck = false } = {}) {
   const dockerStatus = await detectDockerDesktop();
   
   if (!dockerStatus.installed) {
@@ -189,6 +206,14 @@ async function canPerformCompleteBackup() {
     };
   }
 
+  if (skipSupabaseVersionCheck) {
+    return {
+      canBackupComplete: true,
+      supabaseVersionCheckSkipped: true,
+      dockerStatus
+    };
+  }
+
   const supabaseCliVersion = await getSupabaseCLIVersion();
   const latestResult = await getSupabaseCLILatestVersion();
   if (latestResult.error) {
@@ -200,12 +225,15 @@ async function canPerformCompleteBackup() {
       dockerStatus
     };
   }
-  if (supabaseCliVersion && latestResult.version && compareSemver(supabaseCliVersion, latestResult.version) < 0) {
+
+  const minVersion = getMinAcceptableVersion(latestResult.version);
+  if (supabaseCliVersion && minVersion && compareSemver(supabaseCliVersion, minVersion) < 0) {
     return {
       canBackupComplete: false,
       reason: 'supabase_cli_outdated',
       supabaseCliVersion,
       supabaseCliLatest: latestResult.version,
+      supabaseCliMinVersion: minVersion,
       dockerStatus
     };
   }
@@ -226,5 +254,6 @@ module.exports = {
   getSupabaseCLIVersion,
   getSupabaseCLILatestVersion,
   compareSemver,
+  getMinAcceptableVersion,
   canPerformCompleteBackup
 };