cdd-cli 3.1.3 → 3.1.4

package/CHANGELOG.md

@@ -4,6 +4,13 @@ All notable changes to this project will be documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
+## [3.1.4] - 2025-10-17
+
+### Changed
+
+- Documentation cleanup: translate `FIXES_APPLIED.md` to English, remove Spanish duplicate and references to internal audit doc.
+- No functional code changes.
+
 ## [3.1.3] - 2025-10-17
 
 ### Fixed

package/FIXES_APPLIED.md

@@ -1,127 +1,127 @@
-# Correcciones Aplicadas - CDD CLI
+# Applied Fixes - CDD CLI
 
-**Fecha:** 2025-10-17
-**Proyecto:** CDD-CLI (CLI Docker Dashboard)
+**Date:** 2025-10-17  
+**Project:** CDD-CLI (CLI Docker Dashboard)
 
 ---
 
-## Resumen de Correcciones
+## Fixes Summary
 
-Se han aplicado **11 correcciones críticas** que resuelven problemas de seguridad, estabilidad y portabilidad identificados en la auditoría de código.
+A total of 11 critical fixes were applied to address security, stability, and portability issues identified during the code audit.
 
 ---
 
-## 1. CORRECCIONES CRÍTICAS APLICADAS
+## 1. APPLIED CRITICAL FIXES
 
-### ✅ 1.1. Corrección del Orden de Imports
+### ✅ 1.1. Import Order Fix
 
-**Archivo:** `src/helpers/dockerService/serviceComponents/containerActions.js`
+**File:** `src/helpers/dockerService/serviceComponents/containerActions.js`
 
-**Problema:** Las importaciones estaban después de las exportaciones.
+**Issue:** Imports were declared after exports.
 
-**Solución aplicada:**
+**Applied fix:**
 ```javascript
-// ANTES (incorrecto):
+// BEFORE (incorrect):
 export async function removeContainer(containerId) { ... }
 import { docker } from "../dockerService";
 
-// DESPUÉS (correcto):
+// AFTER (correct):
 import { docker } from "../dockerService";
 import { imageExists, pullImage } from "./imageUtils.js";
 export async function removeContainer(containerId) { ... }
 ```
 
-**Impacto:** Elimina posibles errores de referencia y cumple con el estándar ES6.
+**Impact:** Removes potential reference errors and follows ES6 standards.
 
 ---
 
-### ✅ 1.2. Puertos Opcionales en Creación de Contenedores
+### ✅ 1.2. Optional Ports in Container Creation
 
-**Archivo:** `src/hooks/creation/useContainerCreation.js`
+**File:** `src/hooks/creation/useContainerCreation.js`
 
-**Problema:** Se obligaba al usuario a especificar puertos, pero muchos contenedores no los necesitan.
+**Issue:** Users were forced to specify ports, but many containers don’t need them.
 
-**Solución aplicada:**
+**Applied fix:**
 ```javascript
-// ANTES:
+// BEFORE:
 if (!portInput.trim()) {
   setMessage("You must specify at least one port to expose");
   return;
 }
 
-// DESPUÉS:
-// Puertos son opcionales - solo valida si se proporcionan
+// AFTER:
+// Ports are optional — only validate if provided
 if (portInput.trim() && !validatePorts(portInput)) {
   setMessage("Port format must be host:container...");
   return;
 }
 ```
 
-**Impacto:** Permite crear contenedores sin puertos expuestos (workers, servicios internos, etc.)
+**Impact:** Allows creating containers without exposed ports (workers, internal services, etc.).
 
 ---
 
-### ✅ 1.3. Manejo de Errores en getLogsStream
+### ✅ 1.3. Error Handling in getLogsStream
 
-**Archivo:** `src/helpers/dockerService/serviceComponents/containerLogs.js`
+**File:** `src/helpers/dockerService/serviceComponents/containerLogs.js`
 
-**Problema:** No había try-catch para manejar excepciones síncronas.
+**Issue:** No try-catch to handle synchronous exceptions.
 
-**Solución aplicada:**
+**Applied fix:**
 ```javascript
 export function getLogsStream(containerId, onData, onEnd, onError) {
   try {
     const container = docker.getContainer(containerId);
-    // ... resto del código
+    // ... rest of the code
   } catch (err) {
     onError?.(err);
   }
 }
 ```
 
-**Impacto:** Previene crashes cuando el contenedor no existe o hay errores de conexión.
+**Impact:** Prevents crashes when the container doesn’t exist or connection errors occur.
 
 ---
 
-### ✅ 1.4. Configuración Cross-Platform de Docker Socket
+### ✅ 1.4. Cross-Platform Docker Socket Configuration
 
-**Archivo:** `src/helpers/dockerService/dockerService.js`
+**File:** `src/helpers/dockerService/dockerService.js`
 
-**Problema:** Path hardcodeado `/var/run/docker.sock` solo funciona en Linux/Mac.
+**Issue:** Hardcoded path `/var/run/docker.sock` only works on Linux/macOS.
 
-**Solución aplicada:**
+**Applied fix:**
 ```javascript
-// ANTES:
+// BEFORE:
 const docker = new Docker({ socketPath: "/var/run/docker.sock" });
 
-// DESPUÉS:
-// Usa configuración por defecto que maneja automáticamente:
-// - /var/run/docker.sock en Linux/Mac
-// - //./pipe/docker_engine en Windows
+// AFTER:
+// Use default configuration that automatically handles:
+// - /var/run/docker.sock on Linux/macOS
+// - //./pipe/docker_engine on Windows
 const docker = new Docker();
 ```
 
-**Impacto:** La aplicación ahora funciona en Windows, Linux y macOS sin modificaciones.
+**Impact:** Works on Windows, Linux, and macOS without manual changes.
 
 ---
 
-### ✅ 1.5. Prevención de Race Conditions en Stats
+### ✅ 1.5. Race Condition Prevention in Stats
 
-**Archivo:** `src/components/ContainerRow.jsx`
+**File:** `src/components/ContainerRow.jsx`
 
-**Problema:** Actualizaciones de estado en componentes desmontados causaban memory leaks.
+**Issue:** State updates on unmounted components caused memory leaks.
 
-**Solución aplicada:**
+**Applied fix:**
 ```javascript
 useEffect(() => {
   if (state !== "running") return;
   
-  let isMounted = true;  // ← Bandera de montaje
+  let isMounted = true;  // ← Mount flag
   
   const fetchStats = async () => {
     try {
       const s = await getStats(id);
-      if (isMounted) {  // ← Solo actualiza si está montado
+      if (isMounted) {  // ← Only update if mounted
         setStats(s);
       }
     } catch (err) {
@@ -135,23 +135,23 @@ useEffect(() => {
   const timer = setInterval(fetchStats, 1500);
   
   return () => {
-    isMounted = false;  // ← Limpieza
+    isMounted = false;  // ← Cleanup
     clearInterval(timer);
   };
 }, [id, state]);
 ```
 
-**Impacto:** Elimina warnings de React y previene memory leaks.
+**Impact:** Eliminates React warnings and prevents memory leaks.
 
 ---
 
-### ✅ 1.6. Validación de Variables de Entorno
+### ✅ 1.6. Environment Variables Validation
 
-**Archivo:** `src/helpers/validationHelpers.js`
+**File:** `src/helpers/validationHelpers.js`
 
-**Problema:** La función `validateEnvVars` siempre retornaba `true`.
+**Issue:** `validateEnvVars` always returned `true`.
 
-**Solución aplicada:**
+**Applied fix:**
 ```javascript
 export function validateEnvVars(envInput) {
   if (!envInput || !envInput.trim()) return true; // Empty is valid
@@ -159,9 +159,9 @@ export function validateEnvVars(envInput) {
   const vars = envInput.split(",").map(v => v.trim()).filter(Boolean);
   const invalid = vars.find(v => {
     const parts = v.split("=");
-    if (parts.length < 2) return true;  // Debe tener VAR=value
+    if (parts.length < 2) return true;  // Must be VAR=value
     const varName = parts[0].trim();
-    // Nombres deben ser alfanuméricos con underscores
+    // Names must be alphanumeric with underscores
     if (!/^[A-Z_][A-Z0-9_]*$/i.test(varName)) return true;
     return false;
   });
@@ -170,39 +170,39 @@ export function validateEnvVars(envInput) {
 }
 ```
 
-**Impacto:** Detecta variables malformadas antes de enviarlas a Docker.
+**Impact:** Detects malformed variables before sending them to Docker.
 
 ---
 
-### ✅ 1.7. Corrección de Cálculo de CPU Stats
+### ✅ 1.7. CPU Stats Calculation Fix
 
-**Archivo:** `src/helpers/dockerService/serviceComponents/containerStats.js`
+**File:** `src/helpers/dockerService/serviceComponents/containerStats.js`
 
-**Problema:** No se normalizaba por número de CPUs, dando valores incorrectos en multi-core.
+**Issue:** Not normalized by number of CPUs, producing wrong values on multi-core hosts.
 
-**Solución aplicada:**
+**Applied fix:**
 ```javascript
-// Obtener número de CPUs
+// Determine number of CPUs
 const numCpus = stream.cpu_stats.online_cpus || 
                 stream.cpu_stats.cpu_usage.percpu_usage?.length || 1;
 
-// Calcular porcentaje normalizado
+// Compute normalized percentage
 const cpuPercent = systemDelta > 0 
   ? ((cpuDelta / systemDelta) * numCpus * 100) 
   : 0;
 ```
 
-**Impacto:** Estadísticas de CPU correctas en sistemas multi-core.
+**Impact:** Correct CPU stats on multi-core systems.
 
 ---
 
-### ✅ 1.8. Timeouts en Operaciones Docker
+### ✅ 1.8. Timeouts in Docker Operations
 
-**Archivo:** `src/helpers/dockerService/serviceComponents/containerActions.js`
+**File:** `src/helpers/dockerService/serviceComponents/containerActions.js`
 
-**Problema:** Operaciones sin timeout podían colgar la UI indefinidamente.
+**Issue:** Operations without timeouts could freeze the UI indefinitely.
 
-**Solución aplicada:**
+**Applied fix:**
 ```javascript
 function withTimeout(promise, ms = 30000) {
   return Promise.race([
@@ -219,82 +219,82 @@ export async function startContainer(containerId) {
 }
 ```
 
-**Impacto:** Previene UI congelada en operaciones largas o que fallan.
+**Impact:** Prevents frozen UI during long or failing operations.
 
 ---
 
-### ✅ 1.9. Límite de Logs en Memoria
+### ✅ 1.9. In-Memory Log Limit
 
-**Archivo:** `src/hooks/useControls.js`
+**File:** `src/hooks/useControls.js`
 
-**Problema:** Los logs se acumulaban indefinidamente causando memory leak.
+**Issue:** Logs accumulated indefinitely causing a memory leak.
 
-**Solución aplicada:**
+**Applied fix:**
 ```javascript
 getLogsStream(
   containers[selected].id,
   (data) => logsViewer.setLogs((prev) => {
     const newLogs = [...prev, ...data.split("\n").filter(Boolean)];
-    // Limitar a últimas 1000 líneas
+    // Limit to last 1000 lines
     return newLogs.slice(-1000);
   }),
   // ...
 );
 ```
 
-**Impacto:** Previene memory leaks en streams de logs largos.
+**Impact:** Prevents memory leaks on long-running log streams.
 
 ---
 
-### ✅ 1.10. Corrección de Mensaje Duplicado
+### ✅ 1.10. Duplicate Message Fix
 
-**Archivo:** `src/helpers/actionHelpers.js`
+**File:** `src/helpers/actionHelpers.js`
 
-**Problema:** El mensaje de éxito era idéntico al de inicio.
+**Issue:** Success message was identical to the start message.
 
-**Solución aplicada:**
+**Applied fix:**
 ```javascript
-// ANTES:
-setMessage(`${actionLabel} container...`); // inicio
+// BEFORE:
+setMessage(`${actionLabel} container...`); // start
 await actionFn(c.id);
-setMessage(`${actionLabel} container...`); // éxito (duplicado)
+setMessage(`${actionLabel} container...`); // success (duplicate)
 
-// DESPUÉS:
-setMessage(`${actionLabel} container...`); // inicio
+// AFTER:
+setMessage(`${actionLabel} container...`); // start
 await actionFn(c.id);
-setMessage(`${actionLabel} container completed successfully`); // éxito
+setMessage(`${actionLabel} container completed successfully`); // success
 ```
 
-**Impacto:** Feedback claro de que la operación se completó.
+**Impact:** Clear feedback that the operation completed.
 
 ---
 
-### ✅ 1.11. Validación de Container Names
+### ✅ 1.11. Container Names Validation
 
-**Archivo:** `src/helpers/dockerService/serviceComponents/containerList.js`
+**File:** `src/helpers/dockerService/serviceComponents/containerList.js`
 
-**Problema:** No se validaba si `Names` estaba vacío.
+**Issue:** Didn’t validate when `Names` was empty.
 
-**Solución aplicada:**
+**Applied fix:**
 ```javascript
-// ANTES:
+// BEFORE:
 name: container.Names[0].replace("/", ""),
 
-// DESPUÉS:
+// AFTER:
 name: (container.Names && container.Names[0] || 'Unknown').replace("/", ""),
 ```
 
-**Impacto:** Previene crashes si Docker devuelve datos inesperados.
+**Impact:** Prevents crashes when Docker returns unexpected data.
 
 ---
 
-## 2. MEJORAS EN TESTS
+## 2. TEST IMPROVEMENTS
 
-### ✅ Tests para validateEnvVars
+### ✅ Tests for validateEnvVars
 
-**Archivo:** `test/validationHelpers.test.js`
+**File:** `test/validationHelpers.test.js`
 
-**Nuevos tests agregados:**
+**New tests added:**
 - Empty input is valid
 - Valid single env var
 - Valid multiple env vars
@@ -303,19 +303,19 @@ name: (container.Names && container.Names[0] || 'Unknown').replace("/", ""),
 - Invalid env var with invalid name
 - Invalid env var with special characters in name
 
-**Resultado:**
+**Result:**
 ```
 Test Suites: 1 passed, 1 total
-Tests:       12 passed, 12 total (antes: 5)
+Tests:       12 passed, 12 total (previously: 5)
 ```
 
 ---
 
-## 3. ANÁLISIS DE SEGURIDAD
+## 3. SECURITY ANALYSIS
 
 ### ✅ CodeQL Security Scan
 
-**Resultado:** ✅ **0 vulnerabilidades encontradas**
+**Result:** ✅ 0 vulnerabilities found
 
 ```
 Analysis Result for 'javascript'. Found 0 alert(s):
@@ -324,9 +324,9 @@ Analysis Result for 'javascript'. Found 0 alert(s):
 
 ---
 
-## 4. VERIFICACIÓN DE BUILD
+## 4. BUILD VERIFICATION
 
-### ✅ Build Exitoso
+### ✅ Successful Build
 
 ```bash
 $ npm run build
@@ -335,38 +335,38 @@ Successfully compiled 28 files with Babel (815ms).
 
 ---
 
-## 5. IMPACTO GENERAL DE LAS CORRECCIONES
+## 5. OVERALL IMPACT OF FIXES
 
-### Seguridad
-- ✅ Sin vulnerabilidades de seguridad detectadas
-- ✅ Validación de inputs mejorada
-- ✅ Manejo de errores robusto
+### Security
+- ✅ No security vulnerabilities detected
+- ✅ Improved input validation
+- ✅ Robust error handling
 
-### Estabilidad
-- ✅ Prevención de memory leaks
-- ✅ Prevención de race conditions
-- ✅ Prevención de crashes por errores no manejados
-- ✅ Timeouts en operaciones potencialmente largas
+### Stability
+- ✅ Memory leak prevention
+- ✅ Race condition prevention
+- ✅ Crash prevention due to unhandled errors
+- ✅ Timeouts for potentially long operations
 
-### Portabilidad
-- ✅ Compatibilidad con Windows
-- ✅ Compatibilidad con Linux
-- ✅ Compatibilidad con macOS
+### Portability
+- ✅ Windows compatibility
+- ✅ Linux compatibility
+- ✅ macOS compatibility
 
-### Experiencia de Usuario
-- ✅ Puertos opcionales en creación de contenedores
-- ✅ Mensajes de feedback más claros
-- ✅ Estadísticas de CPU correctas
-- ✅ Mejor manejo de errores con mensajes informativos
+### User Experience
+- ✅ Optional ports in container creation
+- ✅ Clearer feedback messages
+- ✅ Correct CPU statistics
+- ✅ Better error handling with informative messages
 
-### Calidad de Código
-- ✅ Cumple estándar ES6
-- ✅ Mejor cobertura de tests (5 → 12 tests)
-- ✅ Código más mantenible
+### Code Quality
+- ✅ ES6 compliant
+- ✅ Better test coverage (5 → 12 tests)
+- ✅ More maintainable code
 
 ---
 
-## 6. ARCHIVOS MODIFICADOS
+## 6. MODIFIED FILES
 
 1. `src/helpers/dockerService/serviceComponents/containerActions.js`
 2. `src/hooks/creation/useContainerCreation.js`
@@ -382,40 +382,38 @@ Successfully compiled 28 files with Babel (815ms).
 
 ---
 
-## 7. RECOMENDACIONES FUTURAS
+## 7. FUTURE RECOMMENDATIONS
 
-Aunque se han corregido los problemas críticos, el informe de auditoría (AUDIT_REPORT.md) contiene recomendaciones adicionales para mejoras futuras:
+While the critical issues have been addressed, the internal audit yielded additional recommendations for future improvements:
 
-### Prioridad Media
-- Agregar más tests unitarios
-- Implementar PropTypes o migrar a TypeScript
-- Extraer magic numbers a constantes
-- Mejorar sistema de logging
+### Medium Priority
+- Add more unit tests
+- Implement PropTypes or migrate to TypeScript
+- Extract magic numbers into constants
+- Improve the logging system
 
-### Prioridad Baja
-- Implementar i18n (internacionalización)
-- Mejorar documentación JSDoc
-- Considerar websockets para actualizaciones en tiempo real
-- Implementar retry logic para reconexión Docker
+### Low Priority
+- Implement i18n (internationalization)
+- Improve JSDoc documentation
+- Consider websockets for real-time updates
+- Implement retry logic for Docker reconnection
 
 ---
 
-## 8. CONCLUSIÓN
+## 8. CONCLUSION
 
-Se han aplicado **11 correcciones críticas** que mejoran significativamente:
+We applied 11 critical fixes that significantly improve:
 
-- **Seguridad**: 0 vulnerabilidades
-- **Estabilidad**: Prevención de memory leaks y race conditions
-- **Portabilidad**: Funciona en Windows, Linux y macOS
-- **Calidad**: +140% más tests (5 → 12)
+- Security: 0 vulnerabilities
+- Stability: Prevention of memory leaks and race conditions
+- Portability: Works on Windows, Linux, and macOS
+- Quality: +140% more tests (5 → 12)
 
-Todas las correcciones han sido probadas y verificadas mediante:
-- ✅ Tests unitarios (12/12 pasando)
-- ✅ Build exitoso
-- ✅ Análisis de seguridad CodeQL (0 alertas)
-
-El proyecto ahora tiene una base más sólida y está listo para uso en producción.
+All fixes have been tested and verified via:
+- ✅ Unit tests (12/12 passing)
+- ✅ Successful build
+- ✅ CodeQL security analysis (0 alerts)
 
 ---
 
-**Fin del documento de correcciones**
+**End of fixes document**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cdd-cli",
-  "version": "3.1.3",
+  "version": "3.1.4",
   "description": "CLI Docker Dashboard",
   "main": "index.js",
   "scripts": {