herdux-cli 0.3.1 → 0.4.1

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.1-blue.svg)
+![Version](https://img.shields.io/badge/version-0.4.1-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
-
-# Then manually drop it
-psql -U postgres -h localhost -p 5416 -c "DROP DATABASE mydb;"
+# PostgreSQL backup
+pg_dump -U postgres -h localhost -p 5416 -Fc -f ./backups/mydb.dump mydb
 
-# Restore from backup
-pg_restore -U postgres -h localhost -p 5416 -d mydb --clean --if-exists ./backups/mydb_2026-02-23.dump
+# MySQL backup
+mysqldump -u root -h localhost -P 3306 -p mydb > ./backups/mydb.sql
 
-# 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
@@ -283,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
@@ -293,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
 ```
 
@@ -302,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
@@ -316,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                                       |
 | -------- | ------------------ | --------------------------------------------- |
@@ -331,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.
 
@@ -344,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.
 
 ---
 
@@ -373,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.1-blue.svg)
+![Version](https://img.shields.io/badge/version-0.4.1-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
@@ -283,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
@@ -293,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
 ```
 
@@ -302,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
@@ -316,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                                                 |
 | ---------- | ---------------------- | ------------------------------------------------------- |
@@ -331,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.
@@ -344,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.
 
 ---
 
@@ -373,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"}

package/dist/commands/backup.js

@@ -1,9 +1,8 @@
 import chalk from "chalk";
 import ora from "ora";
 import prompts from "prompts";
-import { PostgresEngine } from "../infra/engines/postgres/postgres.engine.js";
+import { resolveEngineAndConnection } from "../infra/engines/resolve-connection.js";
 import * as config from "../infra/config/config.service.js";
-import { resolveConnectionOptions } from "../infra/engines/postgres/resolve-connection.js";
 import { join } from "path";
 import { homedir } from "os";
 export function registerBackupCommand(program) {
@@ -16,11 +15,10 @@ export function registerBackupCommand(program) {
         .option("-F, --format <type>", "Backup format format (custom, plain)", "custom")
         .action(async (database, cmdOpts) => {
         try {
-            const engine = new PostgresEngine();
+            const rawOpts = program.opts();
+            const { engine, opts } = await resolveEngineAndConnection(rawOpts);
             await engine.checkClientVersion();
             await engine.checkBackupRequirements();
-            const rawOpts = program.opts();
-            const opts = await resolveConnectionOptions(rawOpts, rawOpts.server);
             if (cmdOpts.format !== "custom" && cmdOpts.format !== "plain") {
                 console.error(chalk.red(`\n✖ Invalid format "${cmdOpts.format}". Use "custom" or "plain".\n`));
                 process.exit(1);