cdd-cli 3.2.2 → 4.0.0

package/.~lock.ROADMAP.md#

@@ -0,0 +1 @@
+,caertos,Cocheroc,28.04.2026 21:42,/home/caertos/.local/share/onlyoffice;

package/CHANGELOG.md

@@ -7,6 +7,57 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 ## [Unreleased]
 - Nothing yet.
 
+## [4.0.0] - 2026-04-28
+
+### 🎉 Major release — Guided creation wizard
+
+This release transforms CDD from a monitoring dashboard into a fully guided container creation experience. The wizard now knows what images need, searches Docker Hub live, and automates the tedious parts.
+
+### Added
+- **Interactive creation wizard** (`C` to open):
+  - 20 curated image profiles with offline autocomplete (↑↓ to navigate, Enter to select)
+  - `[Tab]` on image field searches Docker Hub live — race-condition safe (AbortController + requestId)
+  - `[searching Docker Hub...]` loading indicator in suggestion panel
+  - Hub results replace static suggestions; typing reverts to local list instantly
+  - `[Tab]` on env vars field inserts next suggested `KEY=VALUE` from the image profile
+  - Context-sensitive controls HUD — shows available keys at every step
+- **Smart default tags** — no more `:latest` failures:
+  - `postgres:17-alpine`, `redis:7-alpine`, `nginx:1.27-alpine`, `mysql:8.0`, and 16 more
+  - `resolveImageTag()` pure helper — preserves explicit user tags, applies profile default otherwise
+- **Required env vars included in suggestions** — `MYSQL_ROOT_PASSWORD`, `POSTGRES_PASSWORD`, `SA_PASSWORD`, etc. are now the first entries Tab inserts, so required fields are never missed
+- **Bilingual README** — English (`README.md`) and Spanish (`README.es.md`)
+
+### Fixed
+- Images like `postgres`, `mysql`, `mariadb` no longer fail with 404 due to missing `:latest` tag
+- Required env vars were never suggested by Tab autocomplete — now always appear first
+
+## [3.2.5] - 2026-04-27
+
+### Added
+- Context-sensitive controls HUD in the creation wizard: shows available keys per step
+- Step 0: `[Tab] Search Hub · [↑↓] Browse · [Enter] Confirm · [Esc] Cancel`
+- Step 0 with suggestions: `[↑↓] Navigate · [Enter] Select · [Esc] Cancel`
+- Steps 1–3: `[Enter] Continue · [Esc] Cancel`
+- `ControlsHUD` component with pure `getHints(step, hasSuggestions, isSearchingHub)` function
+
+## [3.2.4] - 2026-04-27
+
+### Fixed
+- Images no longer default to `:latest` — each profile now ships a correct stable tag (e.g. `postgres:17-alpine`, `redis:7-alpine`, `nginx:1.27-alpine`)
+- Selecting an image suggestion or confirming step 0 auto-appends the correct tag when none is typed
+
+### Added  
+- `resolveImageTag(imageName)` pure helper — preserves explicit user tags, appends profile default otherwise
+
+## [3.2.3] - 2026-04-27
+
+### Added
+- Docker Hub live search: pressing Tab on image name field searches Docker Hub in real time
+- `searchDockerHub()` helper with AbortSignal.timeout(5000), race-condition guard (AbortController + requestId)
+- `formatHubResult()` formatter: `nginx [★ official] [1B+ pulls]`
+- `isSearchingHub` loading state with `[searching Docker Hub...]` indicator in SuggestionPanel
+- Hub results replace static suggestions; typing reverts immediately to static list
+
 ## [3.2.2] - 2026-04-27
 
 ### Added

package/README.es.md

@@ -0,0 +1,198 @@
+# CDD — CLI Docker Dashboard
+
+<p align="center">
+  <img src="https://img.shields.io/npm/v/cdd-cli?color=blue&label=npm%20package" alt="npm version"/>
+  <img src="https://img.shields.io/npm/dt/cdd-cli?color=green&label=downloads" alt="npm downloads"/>
+  <a href="https://github.com/caertos/cdd/actions/workflows/ci.yml">
+    <img src="https://github.com/caertos/cdd/actions/workflows/ci.yml/badge.svg?branch=main" alt="CI status" />
+  </a>
+  <a href="https://caertos.github.io/cdd/">
+    <img src="https://img.shields.io/badge/docs-GitHub%20Pages-blue" alt="Docs" />
+  </a>
+  <a href="https://deepwiki.com/Caertos/cdd"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
+</p>
+
+> **Un dashboard de Docker para la terminal — monitorea, gestiona y crea contenedores sin salir del teclado.**
+
+---
+
+## 🎉 Novedades en v3.2
+
+**v3.2 trae el asistente de creación interactivo — y cambia las reglas del juego.**
+
+Olvídate de los flags de `docker run`, las variables de entorno olvidadas y los tags `:latest` que fallan en silencio. Presiona `C` y CDD te guía para crear un contenedor en segundos:
+
+- **20 perfiles de imagen curados** disponibles sin conexión — postgres, redis, nginx, node, mysql, mongo y más
+- **Tags por defecto que realmente funcionan**: `postgres:17-alpine`, `redis:7-alpine`, `nginx:1.27-alpine` — sin más fallos silenciosos por `:latest`
+- **Búsqueda en vivo en Docker Hub** con un solo `Tab` — con indicador `[searching Docker Hub...]` para que siempre sepas qué está pasando
+- **Sugerencias contextuales de variables de entorno** — ¿creando un contenedor de Postgres? CDD sugiere `POSTGRES_USER`, `POSTGRES_PASSWORD`, `POSTGRES_DB` automáticamente
+- **HUD sensible al contexto** — solo se muestran las teclas que tienen sentido en ese momento, nada más
+
+Así debería sentirse la experiencia de desarrollo.
+
+---
+
+## Características
+
+- 🐳 Vista en vivo de todos los contenedores Docker con estadísticas de CPU/memoria
+- 🔄 Auto-refresco cada pocos segundos — siempre actualizado
+- ⌨️ Acciones controladas por teclado: iniciar, detener, reiniciar, ver logs, eliminar
+- 🎨 Estados de contenedor codificados por color y retroalimentación visual
+- ✨ **Asistente de creación interactivo** — configuración paso a paso con perfiles curados y búsqueda en Hub
+- 🪵 Streaming de logs en tiempo real para el contenedor seleccionado
+- 🐛 Panel de debug en vivo activable con la tecla `D`
+
+---
+
+## Instalación global
+
+```bash
+npm install -g cdd-cli
+cdd
+```
+
+---
+
+## Inicio rápido (local)
+
+```bash
+git clone https://github.com/caertos/cdd.git
+cd cdd
+npm install
+npm run build
+node dist/index.js
+```
+
+Para usar como comando global durante el desarrollo:
+
+```bash
+npm link
+cdd
+```
+
+---
+
+## Uso
+
+Usa `↑` / `↓` para navegar por los contenedores. Atajos de teclado disponibles:
+
+| Tecla | Acción |
+|-------|--------|
+| `↑` / `↓` | Navegar la lista de contenedores |
+| `I` | Iniciar el contenedor seleccionado |
+| `P` | Detener el contenedor seleccionado |
+| `R` | Reiniciar el contenedor seleccionado |
+| `C` | Abrir el asistente de creación |
+| `L` | Ver logs del contenedor seleccionado en tiempo real |
+| `E` | Eliminar el contenedor seleccionado — requiere confirmación |
+| `D` | Activar/desactivar panel de debug en vivo |
+| `Q` | Salir |
+
+---
+
+## El Asistente de Creación
+
+Presiona `C` desde el dashboard para abrir el asistente. Un **HUD sensible al contexto** en la parte inferior siempre muestra qué teclas están activas en cada paso — sin adivinar.
+
+### Paso 0 — Imagen
+
+Escribe para filtrar entre **20 perfiles offline curados** (postgres, redis, nginx, node, mysql, mongo, python, golang y más). Los resultados aparecen al instante.
+
+Presiona **`Tab`** en cualquier momento para buscar en Docker Hub en vivo. Un indicador `[searching Docker Hub...]` confirma que la búsqueda está en curso. Usa `↑` / `↓` para navegar las sugerencias y `Enter` para seleccionar.
+
+**Tags inteligentes por defecto:** al seleccionar un perfil de imagen se aplica automáticamente un tag conocido y funcional — `postgres:17-alpine`, `redis:7-alpine`, `nginx:1.27-alpine`, etc. Sin más contenedores que fallan en silencio por un `:latest` desactualizado.
+
+### Paso 1 — Nombre del contenedor
+
+Texto libre. Dale a tu contenedor un nombre memorable.
+
+### Paso 2 — Mapeo de puertos
+
+Ingresa un mapeo de puertos en formato `HOST:CONTENEDOR`, por ejemplo `8080:80`, `5432:5432`. Deja en blanco para omitir.
+
+### Paso 3 — Variables de entorno
+
+Ingresa pares `CLAVE=VALOR` de a uno. Las **sugerencias contextuales** muestran variables recomendadas para la imagen seleccionada:
+
+| Imagen | Variables sugeridas |
+|--------|---------------------|
+| postgres | `POSTGRES_USER`, `POSTGRES_PASSWORD`, `POSTGRES_DB` |
+| mysql | `MYSQL_ROOT_PASSWORD`, `MYSQL_DATABASE` |
+| redis | *(sin variables requeridas)* |
+| mongo | `MONGO_INITDB_ROOT_USERNAME`, `MONGO_INITDB_ROOT_PASSWORD` |
+| node / nginx / otros | Variables de runtime comunes según corresponda |
+
+Presiona `Enter` en una línea vacía para terminar y crear el contenedor.
+
+---
+
+## Requisitos
+
+- Node.js >= 18
+- Docker instalado y ejecutándose (CDD se conecta al socket local de Docker)
+
+---
+
+## Desarrollo
+
+```bash
+npm install
+npm run build        # compila src/ → dist/
+node dist/index.js   # ejecuta desde la salida compilada
+```
+
+Vuelve a ejecutar `npm run build` después de cualquier cambio en el código fuente. Usa `npm link` para probar el comando global `cdd` localmente.
+
+---
+
+## Tests
+
+```bash
+npm test
+```
+
+Los tests están en `test/` y cubren helpers, servicios y hooks.
+
+---
+
+## Logging
+
+Por defecto CDD muestra mensajes `info`, `warn` y `error`. Para diagnósticos más detallados:
+
+```bash
+CDD_LOG_LEVEL=debug cdd
+```
+
+Presiona `D` dentro del dashboard para activar el panel de debug en vivo. Presiona `D` nuevamente para ocultarlo.
+
+Para capturar los logs en un archivo:
+
+```bash
+CDD_LOG_LEVEL=debug cdd > cdd-debug.log 2>&1
+```
+
+---
+
+## Solución de problemas
+
+- **¿No ves contenedores?** Asegúrate de que Docker esté ejecutándose y de que tu usuario tenga acceso al socket de Docker.
+- **¿Errores de permisos en Linux/macOS?** Prueba con `sudo cdd` o agrega tu usuario al grupo `docker`.
+- **¿Windows?** Ejecuta la terminal como Administrador.
+- **¿Falta el directorio `dist/`?** Ejecuta `npm run build` — está en `.gitignore` y no se incluye en el repositorio.
+- **¿La búsqueda del asistente no funciona?** Verifica tu conexión a internet. Los perfiles offline siempre funcionan sin acceso a la red.
+
+---
+
+## Contribuciones
+
+Consulta [CONTRIBUTING.md](CONTRIBUTING.md).
+
+---
+
+## Licencia
+
+MIT/ISC — ver [`LICENSE`](LICENSE).
+
+---
+
+🇬🇧 [Read in English](README.md)

package/README.md

@@ -1,4 +1,4 @@
-## CDD-CLI — Docker Dashboard (Terminal)
+# CDD — CLI Docker Dashboard
 
 <p align="center">
   <img src="https://img.shields.io/npm/v/cdd-cli?color=blue&label=npm%20package" alt="npm version"/>
@@ -12,18 +12,35 @@
   <a href="https://deepwiki.com/Caertos/cdd"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
 </p>
 
-A terminal dashboard for monitoring and managing Docker containers in real time. Shows live CPU/memory stats, supports keyboard-driven actions, and requires no GUI.
+> **A terminal dashboard for Docker containers — monitor, manage, and create, all without leaving your keyboard.**
+
+---
+
+## 🎉 What's new in v3.2
+
+**v3.2 ships the interactive creation wizard — and it's a game changer.**
+
+Forget `docker run` flags, forgotten env vars, and broken `:latest` tags. Press `C` and CDD guides you through creating a container in seconds:
+
+- **20 curated image profiles** available offline — postgres, redis, nginx, node, mysql, mongo, and more
+- **Smart default tags** that actually work: `postgres:17-alpine`, `redis:7-alpine`, `nginx:1.27-alpine` — no more silent `:latest` failures
+- **Live Docker Hub search** with a single `Tab` keystroke — with a `[searching Docker Hub...]` indicator so you always know what's happening
+- **Contextual env var hints** — creating a Postgres container? CDD suggests `POSTGRES_USER`, `POSTGRES_PASSWORD`, `POSTGRES_DB` automatically
+- **Context-sensitive HUD** — only the keys that make sense right now are shown, nothing more
+
+This is what developer experience should feel like.
 
 ---
 
 ## Features
 
-- 🐳 Clear, compact view of all Docker containers
-- 🔄 Auto-refresh every few seconds
-- ⌨️ Keyboard shortcuts for fast actions (navigate, start, stop, logs, quit)
-- 📊 Live CPU and memory stats for running containers
-- 🪵 Real-time log streaming for selected containers
-- 🎨 Color-coded states and visual feedback
+- 🐳 Live view of all Docker containers with CPU/memory stats
+- 🔄 Auto-refresh every few seconds — always up to date
+- ⌨️ Keyboard-driven actions: start, stop, restart, log streaming, removal
+- 🎨 Color-coded container states and visual feedback
+- ✨ **Interactive creation wizard** — step-by-step container setup with curated profiles and live Hub search
+- 🪵 Real-time log streaming for any selected container
+- 🐛 Toggleable live debug panel (`D` key)
 
 ---
 
@@ -46,7 +63,7 @@ npm run build
 node dist/index.js
 ```
 
-To use it as a global command during development:
+To use as a global command during development:
 
 ```bash
 npm link
@@ -57,25 +74,62 @@ cdd
 
 ## Usage
 
-Use ↑/↓ to navigate containers. Available keyboard shortcuts:
+Use `↑` / `↓` to navigate containers. Available keyboard shortcuts:
 
 | Key | Action |
 |-----|--------|
+| `↑` / `↓` | Navigate container list |
 | `I` | Start selected container |
 | `P` | Stop selected container |
 | `R` | Restart selected container |
-| `C` | Create container (interactive prompt) |
-| `L` | View logs for selected container |
+| `C` | Open creation wizard |
+| `L` | Stream logs for selected container |
 | `E` | Erase (remove) selected container — confirmation required |
-| `D` | Toggle live debug log panel |
+| `D` | Toggle live debug panel |
 | `Q` | Quit |
 
 ---
 
+## The Creation Wizard
+
+Press `C` from the dashboard to launch the wizard. A **context-sensitive HUD** at the bottom always shows which keys are active at each step — no guessing required.
+
+### Step 0 — Image
+
+Type to filter through **20 curated offline profiles** (postgres, redis, nginx, node, mysql, mongo, python, golang, and more). Results appear instantly.
+
+Press **`Tab`** at any time to search Docker Hub live. A `[searching Docker Hub...]` indicator confirms the search is running. Use `↑` / `↓` to navigate suggestions, `Enter` to select.
+
+**Smart default tags:** selecting an image profile automatically applies a known-good tag — `postgres:17-alpine`, `redis:7-alpine`, `nginx:1.27-alpine`, etc. No more containers that fail silently because of a stale `:latest`.
+
+### Step 1 — Container name
+
+Free-text input. Give your container a memorable name.
+
+### Step 2 — Port mapping
+
+Enter a port mapping in `HOST:CONTAINER` format, e.g. `8080:80`, `5432:5432`. Leave blank to skip.
+
+### Step 3 — Environment variables
+
+Enter `KEY=VALUE` pairs one at a time. **Contextual hints** show recommended variables for the selected image:
+
+| Image | Suggested vars |
+|-------|---------------|
+| postgres | `POSTGRES_USER`, `POSTGRES_PASSWORD`, `POSTGRES_DB` |
+| mysql | `MYSQL_ROOT_PASSWORD`, `MYSQL_DATABASE` |
+| redis | *(no required vars)* |
+| mongo | `MONGO_INITDB_ROOT_USERNAME`, `MONGO_INITDB_ROOT_PASSWORD` |
+| node / nginx / others | Common runtime vars as applicable |
+
+Press `Enter` on an empty line to finish and create the container.
+
+---
+
 ## Requirements
 
 - Node.js >= 18
-- Docker installed and running (CLI connects to the local Docker socket)
+- Docker installed and running (CDD connects to the local Docker socket)
 
 ---
 
@@ -87,7 +141,7 @@ npm run build        # compile src/ → dist/
 node dist/index.js   # run from compiled output
 ```
 
-Re-run `npm run build` after any source changes.
+Re-run `npm run build` after any source changes. Use `npm link` to test the global `cdd` command locally.
 
 ---
 
@@ -97,21 +151,19 @@ Re-run `npm run build` after any source changes.
 npm test
 ```
 
-Tests are in `test/` and cover helpers, services, and hooks.
+Tests live in `test/` and cover helpers, services, and hooks.
 
 ---
 
 ## Logging
 
-By default the CLI shows `info`, `warn`, and `error` messages. For deeper diagnostics:
+By default CDD shows `info`, `warn`, and `error` messages. For deeper diagnostics:
 
 ```bash
 CDD_LOG_LEVEL=debug cdd
-# or
-CDD_LOG_LEVEL=debug node dist/index.js
 ```
 
-Press `D` inside the CLI to toggle the live debug panel. Press `D` again or `Esc` to hide it.
+Press `D` inside the dashboard to toggle the live debug panel in real time. Press `D` again to hide it.
 
 To capture logs to a file:
 
@@ -123,9 +175,11 @@ CDD_LOG_LEVEL=debug cdd > cdd-debug.log 2>&1
 
 ## Troubleshooting
 
-- If you don't see containers, ensure Docker is running and your user has access to the Docker socket.
-- On Linux/macOS, try `sudo cdd` if you have permission issues. On Windows, run as Administrator.
-- `dist/` is generated by the build — it's in `.gitignore` and should not be committed.
+- **No containers visible?** Make sure Docker is running and your user has access to the Docker socket.
+- **Permission errors on Linux/macOS?** Try `sudo cdd` or add your user to the `docker` group.
+- **Windows?** Run your terminal as Administrator.
+- **`dist/` missing?** Run `npm run build` — it's in `.gitignore` and not committed.
+- **Wizard search not working?** Check your internet connection. Offline profiles always work without network access.
 
 ---
 
@@ -138,3 +192,7 @@ See [CONTRIBUTING.md](CONTRIBUTING.md).
 ## License
 
 MIT/ISC — see [`LICENSE`](LICENSE).
+
+---
+
+🇪🇸 [Ver en Español](README.es.md)