herdux-cli 0.3.0 → 0.4.0

package/README.md

@@ -1,16 +1,22 @@
 🇺🇸 English | 🇧🇷 [Português](./README.pt-BR.md)
 
-# Herdux — Database Workflow CLI
-
 <p align="center">
   <strong>Infrastructure-grade power. Developer-grade experience.</strong>
 </p>
 
+<p align="center">
+  <img src=".github/assets/logo.svg" alt="Herdux banner" style="max-width: 100%; width: 600px;" />
+</p>
+
+## ⏭️ Herdux — Database Workflow CLI
+
 A fast, interactive CLI that removes friction from daily local database workflows, especially when juggling multiple instances and large datasets.
 
-![Version](https://img.shields.io/badge/version-0.3.0-blue.svg)
+![Version](https://img.shields.io/badge/version-0.4.0-blue.svg)
 ![License](https://img.shields.io/badge/license-MIT-green.svg)
 ![Node](https://img.shields.io/badge/node-18%2B-43853d.svg)
+![PostgreSQL](https://img.shields.io/badge/PostgreSQL-316192?style=flat&logo=postgresql&logoColor=white)
+![MySQL](https://img.shields.io/badge/MySQL-4479A1?style=flat&logo=mysql&logoColor=white)
 [![GitHub Sponsors](https://img.shields.io/badge/Sponsor-%E2%9D%A4-pink?style=flat&logo=github)](https://github.com/sponsors/eduardozaniboni)
 [![Buy Me A Coffee](https://img.shields.io/badge/Buy_Me_A_Coffee-FFDD00?style=flat&logo=buy-me-a-coffee&logoColor=black)](https://www.buymeacoffee.com/eduardozaniboni)
 
@@ -36,6 +42,55 @@ That's it. You're managing databases.
 
 ---
 
+## 🔌 Supported Engines
+
+| Engine     | Status | Client Tools Required           |
+| ---------- | ------ | ------------------------------- |
+| PostgreSQL | ✅     | `psql`, `pg_dump`, `pg_restore` |
+| MySQL      | ✅     | `mysql`, `mysqldump`            |
+
+Herdux resolves the engine explicitly using a strict priority order (CLI flags → profiles → saved defaults → fallback).
+
+Internally, no command ever runs without a fully resolved engine.
+
+```bash
+# PostgreSQL (default)
+herdux list
+herdux create mydb
+
+# MySQL
+herdux --engine mysql list
+herdux --engine mysql create mydb
+
+# Or save it in a profile and forget about it
+herdux config add mysql-local --port 3306 --user root --password secret --engine mysql
+herdux list -s mysql-local
+```
+
+---
+
+## 🧠 How Herdux Thinks
+
+Herdux is designed around **strict separation of concerns**:
+
+- **Commands decide _what_ to do**
+- **Engines decide _how_ to do it**
+- **Binaries are never called directly by commands**
+- **All external behavior is isolated behind engine contracts**
+
+This architecture guarantees:
+
+- predictable behavior
+- engine-agnostic commands
+- safer destructive operations
+- easier extension to new databases
+
+If something feels “magical”, it’s probably wrong.
+
+Any change that breaks these boundaries is considered a bug.
+
+---
+
 ## Why Herdux?
 
 Managing local databases through raw bash scripts or binaries is repetitive, error-prone, and painful at scale.
@@ -43,17 +98,14 @@ Managing local databases through raw bash scripts or binaries is repetitive, err
 ### ❌ Without Herdux
 
 ```bash
-# Backup a database
-pg_dump -U postgres -h localhost -p 5416 -Fc -f ./backups/mydb_2026-02-23.dump mydb
+# PostgreSQL backup
+pg_dump -U postgres -h localhost -p 5416 -Fc -f ./backups/mydb.dump mydb
 
-# Then manually drop it
-psql -U postgres -h localhost -p 5416 -c "DROP DATABASE mydb;"
+# MySQL backup
+mysqldump -u root -h localhost -P 3306 -p mydb > ./backups/mydb.sql
 
-# Restore from backup
-pg_restore -U postgres -h localhost -p 5416 -d mydb --clean --if-exists ./backups/mydb_2026-02-23.dump
-
-# Check if tools are installed
-psql --version && pg_dump --version && pg_restore --version
+# Manually drop, restore, check tools...
+# Different flags, different tools, different muscle memory for each engine.
 ```
 
 ### ✅ With Herdux
@@ -65,7 +117,7 @@ herdux clean                            # Multi-select and batch-drop databases
 herdux doctor                           # Full system health check
 ```
 
-Fewer flags. Fewer mistakes. Zero terminal fatigue.
+Same commands. Any engine. Fewer flags. Fewer mistakes. Zero terminal fatigue.
 
 ---
 
@@ -82,6 +134,7 @@ It is specifically designed for developers who:
 - Need safe backup & restore workflows that don't rely on fragile bash scripts.
 - Prefer terminal-first tooling.
 - Want predictable connection resolution without hidden magic.
+- Work with **multiple database engines** (PostgreSQL, MySQL) and want a unified interface.
 
 If you manage databases locally, Herdux was created to solve your pain.
 
@@ -89,12 +142,13 @@ If you manage databases locally, Herdux was created to solve your pain.
 
 ## 🚀 Key Features
 
+- **🔌 Multi-Engine Support** — First-class support for PostgreSQL and MySQL. Same commands, same workflow, any engine.
 - **📋 Smart Listing** — Optimized listing strategy for massive clusters. Optional `--size` flag for disk usage analysis, sorted largest-first.
 - **💾 Intelligent Backup & Restore** — Supports Custom (`.dump`) and Plain (`.sql`) formats. Auto-detects the right tool for restores.
 - **🧹 Bulk Cleanup** — Multi-select databases, optionally backup, and batch-drop them. Reclaim disk space instantly.
 - **🩺 System Diagnostics** — One-command health check verifying binaries, authentication, and connectivity.
-- **⚙️ Persistent Profiles** — Save named server configurations. Switch between environments with `-s pg16`.
-- **🎯 Smart Connection Resolution** — Explicit CLI flags → profiles → saved defaults → auto-discovery. Always predictable.
+- **⚙️ Persistent Profiles** — Save named server configurations with engine type. Switch between environments with `-s pg16`.
+- **🎯 Smart Connection & Engine Resolution** — Explicit CLI flags → profiles → saved defaults → auto-discovery. Always predictable.
 
 ---
 
@@ -105,7 +159,7 @@ If you manage databases locally, Herdux was created to solve your pain.
 **Herdux** follows three principles:
 
 - **Safety first** — Never drops data without explicit confirmation or a verified backup.
-- **Explicit over implicit** — Connection resolution follows a strict, documented priority. No magic.
+- **Explicit over implicit** — Connection and engine resolution follows a strict, documented priority. No magic.
 - **Developer workflow optimization** — Every command is designed to save you from repetitive terminal work.
 
 ---
@@ -116,7 +170,7 @@ If you manage databases locally, Herdux was created to solve your pain.
 
 - **Never drops a database** unless explicit confirmation is given
 - **Aborts the entire operation** if a safety backup fails during `herdux clean`
-- **Validates `pg_dump` exit codes** before considering a backup successful
+- **Validates backup tool exit codes** before considering a backup successful
 - **Requires `--drop` flag** intentionally — dropping is never the default
 - **`--yes` must be combined with `--drop`** — cannot skip confirmation alone
 
@@ -127,10 +181,11 @@ If you manage databases locally, Herdux was created to solve your pain.
 ## 🧩 Requirements
 
 - **Node.js** 18 or higher
-- **PostgreSQL client tools** (`psql`, `pg_dump`, `pg_restore`) installed and available in your `PATH`
+- **For PostgreSQL:** `psql`, `pg_dump`, `pg_restore` installed and available in your `PATH`
+- **For MySQL:** `mysql`, `mysqldump` installed and available in your `PATH`
 
 > [!TIP]
-> Run `herdux doctor` after installation to verify everything is set up correctly.
+> Run `herdux doctor` after installation to verify everything is set up correctly. The doctor command checks the tools for the active engine.
 
 ---
 
@@ -158,24 +213,28 @@ npm link
 
 ## 🛠️ Commands
 
+All commands work with both PostgreSQL and MySQL. Use `--engine mysql` or configure engine in your server profile.
+
 ### `herdux version`
 
-Shows the CLI version and the connected PostgreSQL server version.
+Shows the CLI version and the connected database server version.
 
 ```bash
 herdux version
+herdux --engine mysql version
 ```
 
 ### `herdux doctor`
 
 Runs a full system health check:
 
-- Verifies `psql`, `pg_dump`, and `pg_restore` are installed and reachable
+- Verifies the required client tools are installed and reachable (engine-specific)
 - Attempts a live connection using the resolved configuration
 - Tests authentication against the target server
 
 ```bash
 herdux doctor
+herdux --engine mysql doctor
 ```
 
 ---
@@ -190,7 +249,7 @@ herdux ls --size         # Includes disk size, sorted largest → smallest
 ```
 
 > [!NOTE]
-> The `--size` flag calculates physical disk usage via `pg_database_size()`. On servers with dozens of multi-GB databases, this may take a few minutes depending on disk speed.
+> The `--size` flag calculates physical disk usage. On servers with dozens of multi-GB databases, this may take a few minutes depending on disk speed.
 
 ---
 
@@ -200,6 +259,7 @@ Creates a new database.
 
 ```bash
 herdux create my_new_db
+herdux --engine mysql create my_new_db
 ```
 
 ### `herdux drop <name>`
@@ -236,7 +296,7 @@ This is designed for the real-world dev workflow: clone databases, experiment, t
 Generates a timestamped backup in `./backups/`.
 
 ```bash
-herdux backup mydb                       # Custom format (.dump)
+herdux backup mydb                       # Custom format (.dump for PG, .sql for MySQL)
 herdux backup mydb --format plain        # Plain SQL (.sql)
 herdux backup mydb --drop                # Backup, then ask to drop
 herdux backup mydb --drop --yes          # Backup + drop, no questions
@@ -256,8 +316,8 @@ herdux backup mydb -o ./my-backups       # Custom output directory
 
 Restores a database from a backup file. Automatically detects the format:
 
-- `.sql` → uses `psql -f`
-- `.dump` or any other extension → uses `pg_restore`
+- `.sql` → uses the appropriate SQL import tool
+- `.dump` or any other extension → uses the appropriate restore tool
 
 ```bash
 herdux restore ./backups/mydb_2026-02-23.dump --db mydb
@@ -271,6 +331,9 @@ herdux restore archive.bkp --db mydb --format custom
 herdux restore script.txt --db mydb --format plain
 ```
 
+> [!NOTE]
+> When restoring dumps from managed environments (e.g., AWS RDS), Herdux automatically configures the underlying engine to ignore ownership and role assignments. This prevents errors caused by production roles that do not exist locally. If the restore engine completes with non-fatal warnings (such as missing roles), Herdux will inform you and proceed normally rather than failing.
+
 ---
 
 ## ⚙️ Configuration & Server Profiles
@@ -280,6 +343,7 @@ herdux restore script.txt --db mydb --format plain
 ### Set Global Defaults
 
 ```bash
+herdux config set engine postgres        # Default engine
 herdux config set user postgres
 herdux config set password my_secret
 herdux config set port 5432
@@ -290,8 +354,14 @@ herdux config set port 5432
 Manage multiple database instances effortlessly:
 
 ```bash
+# PostgreSQL profiles
 herdux config add pg16 --port 5416
 herdux config add pg17 --port 5417 --user admin
+
+# MySQL profiles (engine is saved in the profile)
+herdux config add mysql-dev --port 3306 --user root --password secret --engine mysql
+
+# Remote servers
 herdux config add staging --host 192.168.0.10 --port 5432
 ```
 
@@ -299,9 +369,11 @@ Then connect using the `-s` flag:
 
 ```bash
 herdux list -s pg16
-herdux backup mydb -s staging
+herdux backup mydb -s mysql-dev
 ```
 
+Or just run a command without flags — if you have saved profiles, Herdux will show an interactive selection menu displaying the engine for each profile.
+
 ### View & Manage Config
 
 ```bash
@@ -313,9 +385,20 @@ herdux config reset          # Clear all configuration
 
 ---
 
-## 🔌 Connection Priority
+## 🔌 Connection & Engine Resolution
 
-When resolving how to connect, **Herdux** follows a strict, predictable priority order:
+When resolving how to connect and which engine to use, **Herdux** follows a strict, predictable priority order:
+
+### Engine Priority
+
+| Priority | Source             | Example                          |
+| -------- | ------------------ | -------------------------------- |
+| 1️⃣       | **CLI flag**       | `herdux --engine mysql list`     |
+| 2️⃣       | **Server profile** | Profile's `engine` field         |
+| 3️⃣       | **Saved default**  | `herdux config set engine mysql` |
+| 4️⃣       | **Fallback**       | `postgres`                       |
+
+### Connection Priority
 
 | Priority | Source             | Example                                       |
 | -------- | ------------------ | --------------------------------------------- |
@@ -328,10 +411,10 @@ This means explicit input always wins. No surprises.
 
 ---
 
-## 🤔 Why not pgAdmin?
+## 🤔 Why not pgAdmin / phpMyAdmin?
 
 **Herdux** is not a GUI replacement.
-It’s a workflow accelerator for developers who live in the terminal.
+It's a workflow accelerator for developers who live in the terminal.
 
 No GUI. No overhead. Just speed.
 
@@ -341,14 +424,17 @@ No GUI. No overhead. Just speed.
 
 - No hidden defaults.
 - No destructive magic.
-- Deterministic connection resolution.
+- Deterministic connection and engine resolution.
 - Explicit and composable commands.
+- Engine-agnostic: same interface, any database.
 
 ---
 
-## 🐳 Docker Support (Coming Soon)
+## 🐳 Docker Support
 
-**Herdux** will be able to detect and interact with PostgreSQL instances running inside Docker containers — listing, connecting, and managing them as naturally as local instances.
+> Docker MUST NOT be required for normal CLI usage.
+> Docker is currently used internally for end-to-end testing to validate real database workflows.
+> Runtime Docker integration (detecting and managing live containers) is planned.
 
 ---
 
@@ -370,10 +456,15 @@ npm run dev
 
 # Run the unit test suite
 npm run test:unit
-# Run the test suite (requires Docker for E2E)
-npm run test:e2e
+# Run the E2E test suites (requires Docker)
+npm run test:e2e:pgsql
+npm run test:e2e:mysql
 ```
 
+> Herdux follows strict architectural boundaries.
+> Commands are engine-agnostic, engines encapsulate all database-specific behavior, and all binaries are isolated behind adapters.
+> Please keep these boundaries intact when contributing.
+
 ---
 
 ## ☕ Support the Project

package/README.pt-BR.md

@@ -1,16 +1,22 @@
 🇧🇷 Português | 🇺🇸 [English](./README.md)
 
-# Herdux — Database Workflow CLI
-
 <p align="center">
   <strong>Infrastructure-grade power. Developer-grade experience.</strong>
 </p>
 
+<p align="center">
+  <img src=".github/assets/logo.svg" alt="Herdux banner" style="max-width: 100%; width: 600px;" />
+</p>
+
+## ⏭️ Herdux — Database Workflow CLI
+
 Uma CLI rápida e interativa que remove a fricção dos workflows diários com bancos de dados locais, especialmente ao lidar com múltiplas instâncias e grandes datasets.
 
-![Version](https://img.shields.io/badge/version-0.3.0-blue.svg)
+![Version](https://img.shields.io/badge/version-0.4.0-blue.svg)
 ![License](https://img.shields.io/badge/license-MIT-green.svg)
 ![Node](https://img.shields.io/badge/node-18%2B-43853d.svg)
+![PostgreSQL](https://img.shields.io/badge/PostgreSQL-316192?style=flat&logo=postgresql&logoColor=white)
+![MySQL](https://img.shields.io/badge/MySQL-4479A1?style=flat&logo=mysql&logoColor=white)
 [![GitHub Sponsors](https://img.shields.io/badge/Sponsor-%E2%9D%A4-pink?style=flat&logo=github)](https://github.com/sponsors/eduardozaniboni)
 [![Buy Me A Coffee](https://img.shields.io/badge/Buy_Me_A_Coffee-FFDD00?style=flat&logo=buy-me-a-coffee&logoColor=black)](https://www.buymeacoffee.com/eduardozaniboni)
 
@@ -36,6 +42,31 @@ herdux list
 
 ---
 
+## 🔌 Engines Suportadas
+
+| Engine     | Status | Ferramentas Cliente Necessárias |
+| ---------- | ------ | ------------------------------- |
+| PostgreSQL | ✅     | `psql`, `pg_dump`, `pg_restore` |
+| MySQL      | ✅     | `mysql`, `mysqldump`            |
+
+O Herdux detecta automaticamente a engine a partir do seu perfil de servidor ou da flag `--engine`. PostgreSQL é o padrão quando nenhuma engine é especificada.
+
+```bash
+# PostgreSQL (padrão)
+herdux list
+herdux create mydb
+
+# MySQL
+herdux --engine mysql list
+herdux --engine mysql create mydb
+
+# Ou salve no perfil e esqueça
+herdux config add mysql-local --port 3306 --user root --password secret --engine mysql
+herdux list -s mysql-local
+```
+
+---
+
 ## Por que Herdux?
 
 Gerenciar bancos de dados locais através de scripts bash ou binários crus é repetitivo, propenso a erros e doloroso em escala.
@@ -43,17 +74,14 @@ Gerenciar bancos de dados locais através de scripts bash ou binários crus é r
 ### ❌ Sem Herdux
 
 ```bash
-# Fazer backup de um banco
-pg_dump -U postgres -h localhost -p 5416 -Fc -f ./backups/mydb_2026-02-23.dump mydb
-
-# Depois dropar manualmente
-psql -U postgres -h localhost -p 5416 -c "DROP DATABASE mydb;"
+# Backup PostgreSQL
+pg_dump -U postgres -h localhost -p 5416 -Fc -f ./backups/mydb.dump mydb
 
-# Restaurar do backup
-pg_restore -U postgres -h localhost -p 5416 -d mydb --clean --if-exists ./backups/mydb_2026-02-23.dump
+# Backup MySQL
+mysqldump -u root -h localhost -P 3306 -p mydb > ./backups/mydb.sql
 
-# Verificar se as ferramentas estão instaladas
-psql --version && pg_dump --version && pg_restore --version
+# Dropar manualmente, restaurar, verificar ferramentas...
+# Flags diferentes, ferramentas diferentes, memória muscular diferente para cada engine.
 ```
 
 ### ✅ Com Herdux
@@ -65,7 +93,7 @@ herdux clean                            # Multi-seleção e batch-drop de bancos
 herdux doctor                           # Verificação completa do sistema
 ```
 
-Menos flags. Menos erros. Zero fadiga de terminal.
+Mesmos comandos. Qualquer engine. Menos flags. Menos erros. Zero fadiga de terminal.
 
 ---
 
@@ -82,6 +110,7 @@ Ele é especificamente projetado para desenvolvedores que:
 - Precisam de fluxos seguros de backup & restore que não dependam de scripts bash frágeis.
 - Preferem ferramentas focadas no terminal (terminal-first).
 - Querem resolução previsível de conexões sem mágicas ocultas.
+- Trabalham com **múltiplas engines de banco de dados** (PostgreSQL, MySQL) e querem uma interface unificada.
 
 Se você gerencia bancos de dados localmente e compartilha dessa dor, o Herdux foi criado para você.
 
@@ -89,12 +118,13 @@ Se você gerencia bancos de dados localmente e compartilha dessa dor, o Herdux f
 
 ## 🚀 Funcionalidades Principais
 
+- **🔌 Suporte Multi-Engine** — Suporte de primeira classe para PostgreSQL e MySQL. Mesmos comandos, mesmo workflow, qualquer engine.
 - **📋 Listagem Inteligente** — Estratégia otimizada para clusters massivos. Flag opcional `--size` para análise de uso de disco, ordenado do maior para o menor.
 - **💾 Backup & Restore Inteligente** — Suporta formatos Custom (`.dump`) e Plain (`.sql`). Detecta automaticamente a ferramenta correta para restauração.
 - **🧹 Limpeza em Massa** — Multi-seleção de bancos, backup opcional e batch-drop. Recupere espaço em disco instantaneamente.
 - **🩺 Diagnóstico do Sistema** — Verificação completa de saúde com um único comando: binários, autenticação e conectividade.
-- **⚙️ Perfis Persistentes** — Salve configurações de servidor nomeadas. Alterne entre ambientes com `-s pg16`.
-- **🎯 Resolução Inteligente de Conexão** — Flags CLI explícitas → perfis → padrões salvos → auto-descoberta. Sempre previsível.
+- **⚙️ Perfis Persistentes** — Salve configurações de servidor nomeadas com tipo de engine. Alterne entre ambientes com `-s pg16`.
+- **🎯 Resolução Inteligente de Conexão e Engine** — Flags CLI explícitas → perfis → padrões salvos → auto-descoberta. Sempre previsível.
 
 ---
 
@@ -105,7 +135,7 @@ Se você gerencia bancos de dados localmente e compartilha dessa dor, o Herdux f
 O **Herdux** segue três princípios:
 
 - **Segurança primeiro** — Nunca apaga dados sem confirmação explícita ou um backup verificado.
-- **Explícito sobre implícito** — A resolução de conexão segue uma prioridade estrita e documentada. Sem mágica.
+- **Explícito sobre implícito** — A resolução de conexão e engine segue uma prioridade estrita e documentada. Sem mágica.
 - **Otimização de workflow** — Cada comando é projetado para te salvar de tarefas repetitivas no terminal.
 
 ---
@@ -116,7 +146,7 @@ O **Herdux** trata operações destrutivas com cuidado:
 
 - **Nunca dropa um banco** sem confirmação explícita
 - **Aborta toda a operação** se um backup de segurança falhar durante o `herdux clean`
-- **Valida códigos de saída do `pg_dump`** antes de considerar um backup bem-sucedido
+- **Valida códigos de saída das ferramentas de backup** antes de considerar um backup bem-sucedido
 - **Requer a flag `--drop`** intencionalmente — dropar nunca é o padrão
 - **`--yes` deve ser combinado com `--drop`** — não é possível pular confirmação sozinho
 
@@ -127,10 +157,11 @@ O **Herdux** trata operações destrutivas com cuidado:
 ## 🧩 Requisitos
 
 - **Node.js** 18 ou superior
-- **Ferramentas cliente PostgreSQL** (`psql`, `pg_dump`, `pg_restore`) instaladas e disponíveis no `PATH`
+- **Para PostgreSQL:** `psql`, `pg_dump`, `pg_restore` instalados e disponíveis no `PATH`
+- **Para MySQL:** `mysql`, `mysqldump` instalados e disponíveis no `PATH`
 
 > [!TIP]
-> Execute `herdux doctor` após a instalação para verificar se tudo está configurado corretamente.
+> Execute `herdux doctor` após a instalação para verificar se tudo está configurado corretamente. O comando doctor verifica as ferramentas da engine ativa.
 
 ---
 
@@ -158,24 +189,28 @@ npm link
 
 ## 🛠️ Comandos
 
+Todos os comandos funcionam tanto com PostgreSQL quanto com MySQL. Use `--engine mysql` ou configure a engine no seu perfil de servidor.
+
 ### `herdux version`
 
-Mostra a versão da CLI e a versão do servidor PostgreSQL conectado.
+Mostra a versão da CLI e a versão do servidor de banco de dados conectado.
 
 ```bash
 herdux version
+herdux --engine mysql version
 ```
 
 ### `herdux doctor`
 
 Executa uma verificação completa de saúde do sistema:
 
-- Verifica se `psql`, `pg_dump` e `pg_restore` estão instalados e acessíveis
+- Verifica se as ferramentas cliente necessárias estão instaladas e acessíveis (específicas por engine)
 - Tenta uma conexão real usando a configuração resolvida
 - Testa autenticação contra o servidor alvo
 
 ```bash
 herdux doctor
+herdux --engine mysql doctor
 ```
 
 ---
@@ -190,7 +225,7 @@ herdux ls --size         # Inclui tamanho em disco, ordenado do maior → menor
 ```
 
 > [!NOTE]
-> A flag `--size` calcula o uso físico de disco via `pg_database_size()`. Em servidores com dezenas de bancos multi-GB, isso pode levar alguns minutos dependendo da velocidade do disco.
+> A flag `--size` calcula o uso físico de disco. Em servidores com dezenas de bancos multi-GB, isso pode levar alguns minutos dependendo da velocidade do disco.
 
 ---
 
@@ -200,6 +235,7 @@ Cria um novo banco de dados.
 
 ```bash
 herdux create meu_novo_db
+herdux --engine mysql create meu_novo_db
 ```
 
 ### `herdux drop <nome>`
@@ -236,7 +272,7 @@ Projetado para o workflow real do desenvolvedor: clonar bancos, experimentar, de
 Gera um backup com timestamp em `./backups/`.
 
 ```bash
-herdux backup mydb                       # Formato custom (.dump)
+herdux backup mydb                       # Formato custom (.dump para PG, .sql para MySQL)
 herdux backup mydb --format plain        # SQL puro (.sql)
 herdux backup mydb --drop                # Backup, depois pergunta se quer dropar
 herdux backup mydb --drop --yes          # Backup + drop, sem perguntas
@@ -256,8 +292,8 @@ herdux backup mydb -o ./meus-backups     # Diretório de saída personalizado
 
 Restaura um banco de dados a partir de um arquivo de backup. Detecta automaticamente o formato:
 
-- `.sql` → usa `psql -f`
-- `.dump` ou qualquer outra extensão → usa `pg_restore`
+- `.sql` → usa a ferramenta de importação SQL apropriada
+- `.dump` ou qualquer outra extensão → usa a ferramenta de restore apropriada
 
 ```bash
 herdux restore ./backups/mydb_2026-02-23.dump --db mydb
@@ -271,6 +307,9 @@ herdux restore arquivo.bkp --db mydb --format custom
 herdux restore script.txt --db mydb --format plain
 ```
 
+> [!NOTE]
+> Ao restaurar backups vindos de ambientes gerenciados (ex: AWS RDS), o Herdux configura automaticamente a engine subjacente para ignorar atribuições de permissões e roles. Isso evita erros com roles que existem em produção mas não no seu ambiente local. Se a engine de restauração concluir a operação com avisos não-fatais (como roles ausentes), o Herdux irá te informar no terminal e prosseguir normalmente sem interromper o fluxo.
+
 ---
 
 ## ⚙️ Configuração & Perfis de Servidor
@@ -280,6 +319,7 @@ O `herdux` armazena configurações localmente em `~/.herdux/config.json`.
 ### Definir Padrões Globais
 
 ```bash
+herdux config set engine postgres        # Engine padrão
 herdux config set user postgres
 herdux config set password minha_senha
 herdux config set port 5432
@@ -290,8 +330,14 @@ herdux config set port 5432
 Gerencie múltiplas instâncias de banco de dados sem esforço:
 
 ```bash
+# Perfis PostgreSQL
 herdux config add pg16 --port 5416
 herdux config add pg17 --port 5417 --user admin
+
+# Perfis MySQL (a engine é salva no perfil)
+herdux config add mysql-dev --port 3306 --user root --password secret --engine mysql
+
+# Servidores remotos
 herdux config add staging --host 192.168.0.10 --port 5432
 ```
 
@@ -299,9 +345,11 @@ Depois conecte usando a flag `-s`:
 
 ```bash
 herdux list -s pg16
-herdux backup mydb -s staging
+herdux backup mydb -s mysql-dev
 ```
 
+Ou simplesmente execute um comando sem flags — se você tiver perfis salvos, o Herdux mostrará um menu de seleção interativo exibindo a engine de cada perfil.
+
 ### Visualizar & Gerenciar Config
 
 ```bash
@@ -313,9 +361,20 @@ herdux config reset          # Limpa toda a configuração
 
 ---
 
-## 🔌 Prioridade de Conexão
+## 🔌 Resolução de Conexão e Engine
+
+Ao resolver como se conectar e qual engine usar, o **Herdux** segue uma ordem de prioridade estrita e previsível:
+
+### Prioridade da Engine
+
+| Prioridade | Fonte            | Exemplo                          |
+| ---------- | ---------------- | -------------------------------- |
+| 1️⃣         | **Flag CLI**     | `herdux --engine mysql list`     |
+| 2️⃣         | **Perfil**       | Campo `engine` do perfil         |
+| 3️⃣         | **Padrão salvo** | `herdux config set engine mysql` |
+| 4️⃣         | **Fallback**     | `postgres`                       |
 
-Ao resolver como se conectar, o **Herdux** segue uma ordem de prioridade estrita e previsível:
+### Prioridade da Conexão
 
 | Prioridade | Fonte                  | Exemplo                                                 |
 | ---------- | ---------------------- | ------------------------------------------------------- |
@@ -328,7 +387,7 @@ Isso significa que a entrada explícita sempre vence. Sem surpresas.
 
 ---
 
-## 🤔 Por que não pgAdmin?
+## 🤔 Por que não pgAdmin / phpMyAdmin?
 
 O **Herdux** não é um substituto de GUI.
 É um acelerador de workflow para desenvolvedores que vivem no terminal.
@@ -341,14 +400,15 @@ Sem GUI. Sem overhead. Só velocidade.
 
 - Sem padrões ocultos (hidden defaults).
 - Sem mágicas destrutivas.
-- Resolução de conexão determinística.
+- Resolução determinística de conexão e engine.
 - Comandos explícitos e combináveis.
+- Engine-agnostic: mesma interface, qualquer banco de dados.
 
 ---
 
 ## 🐳 Suporte Docker (Em Breve)
 
-O **Herdux** poderá detectar e interagir com instâncias PostgreSQL rodando dentro de containers Docker — listando, conectando e gerenciando-as tão naturalmente quanto instâncias locais.
+O **Herdux** poderá detectar e interagir com instâncias de banco de dados rodando dentro de containers Docker — listando, conectando e gerenciando-as tão naturalmente quanto instâncias locais.
 
 ---
 
@@ -370,8 +430,9 @@ npm run dev
 
 # Executar testes unitários
 npm run test:unit
-# Executar testes de integração (requer Docker para E2E)
-npm run test:e2e
+# Executar testes E2E (requer Docker)
+npm run test:e2e:pgsql
+npm run test:e2e:mysql
 ```
 
 ---

package/dist/commands/backup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/commands/backup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiG5D"}
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/commands/backup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4F5D"}