cdd-cli 4.0.0 → 4.2.0

package/dist/hooks/useShellMode.js

@@ -0,0 +1,101 @@
+function _regenerator() { /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/babel/babel/blob/main/packages/babel-helpers/LICENSE */ var e, t, r = "function" == typeof Symbol ? Symbol : {}, n = r.iterator || "@@iterator", o = r.toStringTag || "@@toStringTag"; function i(r, n, o, i) { var c = n && n.prototype instanceof Generator ? n : Generator, u = Object.create(c.prototype); return _regeneratorDefine2(u, "_invoke", function (r, n, o) { var i, c, u, f = 0, p = o || [], y = !1, G = { p: 0, n: 0, v: e, a: d, f: d.bind(e, 4), d: function d(t, r) { return i = t, c = 0, u = e, G.n = r, a; } }; function d(r, n) { for (c = r, u = n, t = 0; !y && f && !o && t < p.length; t++) { var o, i = p[t], d = G.p, l = i[2]; r > 3 ? (o = l === n) && (u = i[(c = i[4]) ? 5 : (c = 3, 3)], i[4] = i[5] = e) : i[0] <= d && ((o = r < 2 && d < i[1]) ? (c = 0, G.v = n, G.n = i[1]) : d < l && (o = r < 3 || i[0] > n || n > l) && (i[4] = r, i[5] = n, G.n = l, c = 0)); } if (o || r > 1) return a; throw y = !0, n; } return function (o, p, l) { if (f > 1) throw TypeError("Generator is already running"); for (y && 1 === p && d(p, l), c = p, u = l; (t = c < 2 ? e : u) || !y;) { i || (c ? c < 3 ? (c > 1 && (G.n = -1), d(c, u)) : G.n = u : G.v = u); try { if (f = 2, i) { if (c || (o = "next"), t = i[o]) { if (!(t = t.call(i, u))) throw TypeError("iterator result is not an object"); if (!t.done) return t; u = t.value, c < 2 && (c = 0); } else 1 === c && (t = i["return"]) && t.call(i), c < 2 && (u = TypeError("The iterator does not provide a '" + o + "' method"), c = 1); i = e; } else if ((t = (y = G.n < 0) ? u : r.call(n, G)) !== a) break; } catch (t) { i = e, c = 1, u = t; } finally { f = 1; } } return { value: t, done: y }; }; }(r, o, i), !0), u; } var a = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} t = Object.getPrototypeOf; var c = [][n] ? t(t([][n]())) : (_regeneratorDefine2(t = {}, n, function () { return this; }), t), u = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(c); function f(e) { return Object.setPrototypeOf ? Object.setPrototypeOf(e, GeneratorFunctionPrototype) : (e.__proto__ = GeneratorFunctionPrototype, _regeneratorDefine2(e, o, "GeneratorFunction")), e.prototype = Object.create(u), e; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, _regeneratorDefine2(u, "constructor", GeneratorFunctionPrototype), _regeneratorDefine2(GeneratorFunctionPrototype, "constructor", GeneratorFunction), GeneratorFunction.displayName = "GeneratorFunction", _regeneratorDefine2(GeneratorFunctionPrototype, o, "GeneratorFunction"), _regeneratorDefine2(u), _regeneratorDefine2(u, o, "Generator"), _regeneratorDefine2(u, n, function () { return this; }), _regeneratorDefine2(u, "toString", function () { return "[object Generator]"; }), (_regenerator = function _regenerator() { return { w: i, m: f }; })(); }
+function _regeneratorDefine2(e, r, n, t) { var i = Object.defineProperty; try { i({}, "", {}); } catch (e) { i = 0; } _regeneratorDefine2 = function _regeneratorDefine(e, r, n, t) { function o(r, n) { _regeneratorDefine2(e, r, function (e) { return this._invoke(r, n, e); }); } r ? i ? i(e, r, { value: n, enumerable: !t, configurable: !t, writable: !t }) : e[r] = n : (o("next", 0), o("throw", 1), o("return", 2)); }, _regeneratorDefine2(e, r, n, t); }
+function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
+function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; }
+import React from 'react';
+import { render } from 'ink';
+import { execInteractive, detectShell } from '../helpers/dockerService/serviceComponents/containerExec.js';
+import { getInkApp, setInkApp } from '../helpers/appState.js';
+import App from '../App.js';
+import { logger } from '../helpers/logger.js';
+
+/**
+ * Open an interactive shell inside a Docker container.
+ * Unmounts Ink, spawns `docker exec -it`, and re-renders the app on exit.
+ *
+ * @param {Object} container - Container object from Docker
+ * @returns {Promise<void>}
+ */
+function openShell(_x) {
+  return _openShell.apply(this, arguments);
+}
+/**
+ * Hook that provides the shell mode API.
+ * In practice, the heavy lifting (unmount/spawn/remount) is handled by
+ * `openShell` outside the React tree. This hook just exposes a stable
+ * reference for useControls.
+ *
+ * @returns {{ openShell: Function }}
+ */
+function _openShell() {
+  _openShell = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(container) {
+    var isRunning, containerId, containerName, inkApp, shell, newApp, _t;
+    return _regenerator().w(function (_context) {
+      while (1) switch (_context.p = _context.n) {
+        case 0:
+          if (container) {
+            _context.n = 1;
+            break;
+          }
+          return _context.a(2);
+        case 1:
+          isRunning = container.state === 'running' || container.status === 'running';
+          if (isRunning) {
+            _context.n = 2;
+            break;
+          }
+          logger.warn('Cannot open shell: container %s is not running', container.name);
+          return _context.a(2);
+        case 2:
+          containerId = container.id;
+          containerName = container.name || containerId.slice(0, 12); // Unmount Ink to release the terminal
+          inkApp = getInkApp();
+          if (inkApp && typeof inkApp.unmount === 'function') {
+            inkApp.unmount();
+          }
+
+          // Clear the screen for a clean shell experience
+          if (process.stdout && process.stdout.isTTY) {
+            process.stdout.write("\x1Bc");
+          }
+          _context.p = 3;
+          _context.n = 4;
+          return detectShell(containerId);
+        case 4:
+          shell = _context.v;
+          process.stdout.write("\x1B[36m[shell]\x1B[0m Opening ".concat(shell, " in ").concat(containerName, " (").concat(containerId.slice(0, 12), ")...\r\n"));
+          process.stdout.write('\x1b[33mType "exit" or press Ctrl+D to return to CDD.\x1b[0m\r\n\r\n');
+          _context.n = 5;
+          return execInteractive(containerId, {
+            shell: shell
+          });
+        case 5:
+          _context.n = 7;
+          break;
+        case 6:
+          _context.p = 6;
+          _t = _context.v;
+          process.stdout.write("\x1B[31m[shell] Error: ".concat(_t.message, "\x1B[0m\r\n"));
+          logger.error('Shell mode error', _t);
+        case 7:
+          _context.n = 8;
+          return new Promise(function (r) {
+            return setTimeout(r, 100);
+          });
+        case 8:
+          // Re-render the app
+          console.clear();
+          newApp = render(/*#__PURE__*/React.createElement(App, null));
+          setInkApp(newApp);
+        case 9:
+          return _context.a(2);
+      }
+    }, _callee, null, [[3, 6]]);
+  }));
+  return _openShell.apply(this, arguments);
+}
+export function useShellMode() {
+  return {
+    openShell: openShell
+  };
+}

package/dist/index.js

@@ -11,6 +11,7 @@ import React from 'react';
 import { render } from 'ink';
 import App from './App.js';
 import { logger } from './helpers/logger.js';
+import { setInkApp } from './helpers/appState.js';
 process.on('uncaughtException', function (err) {
   return logger.error('Uncaught exception', err);
 });
@@ -18,4 +19,5 @@ process.on('unhandledRejection', function (reason) {
   return logger.error('Unhandled rejection', reason);
 });
 console.clear();
-render(/*#__PURE__*/React.createElement(App, null));
+var inkApp = render(/*#__PURE__*/React.createElement(App, null));
+setInkApp(inkApp);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cdd-cli",
-  "version": "4.0.0",
+  "version": "4.2.0",
   "description": "CLI Docker Dashboard",
   "main": "index.js",
   "scripts": {
@@ -16,6 +16,9 @@
   "author": "",
   "license": "ISC",
   "type": "module",
+  "files": [
+    "dist"
+  ],
   "dependencies": {
     "chalk": "^5.6.2",
     "dockerode": "^4.0.9",

package/.atl/skill-registry.md

@@ -1,30 +0,0 @@
-# Skill Registry — CDD
-
-Generated: 2026-04-25
-
-## User Skills (from ~/.config/opencode/skills/)
-
-| Skill | Trigger |
-|-------|---------|
-| branch-pr | Creating a pull request, opening a PR, or preparing changes for review |
-| go-testing | Writing Go tests, using teatest, or adding test coverage |
-| issue-creation | Creating a GitHub issue, reporting a bug, or requesting a feature |
-| judgment-day | "judgment day", "review adversarial", "dual review", "juzgar", "que lo juzguen" |
-| reporter | Creating a sprint report, updating CHANGELOG, or documenting completed work |
-| sdd-apply | Orchestrator launches to implement one or more tasks from a change |
-| sdd-archive | Orchestrator launches to archive a change after implementation and verification |
-| sdd-design | Orchestrator launches to write or update the technical design for a change |
-| sdd-explore | Orchestrator launches to think through a feature, investigate the codebase, or clarify requirements |
-| sdd-propose | Orchestrator launches to create or update a proposal for a change |
-| sdd-spec | Orchestrator launches to write or update specs for a change |
-| sdd-tasks | Orchestrator launches to create or update the task breakdown for a change |
-| sdd-verify | Orchestrator launches to verify a completed change |
-| skill-creator | Creating a new skill, adding agent instructions, or documenting patterns for AI |
-| skill-registry | "update skills", "skill registry", "actualizar skills", "update registry" |
-
-## Project Conventions
-
-- No project-level AGENTS.md / CLAUDE.md / .cursorrules found
-- ESLint config: `.eslintrc.json` (eslint:recommended + plugin:react/recommended)
-- No Prettier config detected — formatting via Babel only
-- No TypeScript (plain JS/JSX with Babel)

package/.editorconfig

@@ -1,12 +0,0 @@
-root = true
-
-[*]
-indent_style = space
-indent_size = 2
-end_of_line = lf
-charset = utf-8
-trim_trailing_whitespace = true
-insert_final_newline = true
-
-[*.md]
-trim_trailing_whitespace = false

package/.eslintrc.json

@@ -1,30 +0,0 @@
-{
-  "env": {
-    "browser": true,
-    "node": true,
-    "es2021": true,
-    "jest": true
-  },
-  "extends": ["eslint:recommended", "plugin:react/recommended", "prettier"],
-  "parserOptions": {
-    "ecmaVersion": 2021,
-    "sourceType": "module",
-    "ecmaFeatures": { "jsx": true }
-  },
-  "rules": {
-    "no-unsafe-optional-chaining": "error",
-    "react/react-in-jsx-scope": "off",
-    "no-console": "off",
-    "react/prop-types": "warn",
-    "no-unused-vars": [
-      "warn",
-      {
-        "argsIgnorePattern": "^_",
-        "varsIgnorePattern": "^(?:_|React)$"
-      }
-    ]
-  },
-  "settings": {
-    "react": { "version": "detect" }
-  }
-}

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,30 +0,0 @@
----
-name: Bug report
-about: Create a report to help us improve
-title: ''
-labels: bug
-assignees: ''
----
-
-**Describe the bug**
-A clear and concise description of what the bug is.
-
-**To Reproduce**
-Steps to reproduce the behavior:
-1. Go to '...'
-2. Run '...'
-3. See error
-
-**Expected behavior**
-A clear and concise description of what you expected to happen.
-
-**Screenshots or logs**
-If applicable, add screenshots or logs to help explain your problem.
-
-**Environment (please complete the following information):**
-- OS: (e.g. Ubuntu 22.04)
-- Node version: (e.g. 18.x)
-- cdd-cli version: (e.g. 3.1.0)
-
-**Additional context**
-Add any other context about the problem here.

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,19 +0,0 @@
----
-name: Feature request
-about: Suggest an idea for this project
-title: ''
-labels: enhancement
-assignees: ''
----
-
-**Is your feature request related to a problem? Please describe.**
-A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
-
-**Describe the solution you'd like**
-A clear and concise description of what you want to happen.
-
-**Describe alternatives you've considered**
-A clear and concise description of any alternative solutions or features you've considered.
-
-**Additional context**
-Add any other context or screenshots about the feature request here.

package/.github/PULL_REQUEST_TEMPLATE/pull_request.md

@@ -1,14 +0,0 @@
-<!-- Please replace the placeholders and remove this comment -->
-## Summary
-
-What does this PR change and why?
-
-## Checklist
-
-- [ ] I have read the contributing guidelines
-- [ ] Tests added / updated
-- [ ] Documentation updated
-
-## Related issues
-
-Closes: # (issue)

package/.github/workflows/ci.yml

@@ -1,32 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches: [ main ]
-  pull_request:
-    branches: [ main ]
-
-jobs:
-  test-and-build:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '18'
-          cache: 'npm'
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Lint
-        run: npm run lint
-
-      - name: Run tests
-        run: npm test
-
-      - name: Build
-        run: npm run build

package/.github/workflows/docs.yml

@@ -1,42 +0,0 @@
-name: Build and deploy docs
-
-on:
-  workflow_run:
-    workflows: ["CI"]
-    types:
-      - completed
-    branches:
-      - main
-
-jobs:
-  build-and-deploy:
-    if: ${{ github.event.workflow_run.conclusion == 'success' }}
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-      pages: write
-      id-token: write
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '18'
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Build docs
-        run: npm run docs
-
-      - name: Ensure .nojekyll
-        run: mkdir -p docs && touch docs/.nojekyll
-
-      - name: Deploy to GitHub Pages (push to gh-pages)
-        uses: peaceiris/actions-gh-pages@v3
-        with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: ./docs

package/.prettierignore

@@ -1,4 +0,0 @@
-node_modules/
-dist/
-coverage/
-*.cjs

package/.prettierrc

@@ -1,8 +0,0 @@
-{
-  "semi": true,
-  "singleQuote": true,
-  "trailingComma": "es5",
-  "printWidth": 80,
-  "tabWidth": 2,
-  "arrowParens": "always"
-}

package/.~lock.ROADMAP.md#

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

package/CHANGELOG.md

@@ -1,216 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-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
-
-- Interactive suggestion panel in container creation wizard (step 0) — shows filtered image suggestions below the input as the user types, navigable with ↑↓ and selectable with Enter
-- `IMAGE_PROFILES` expanded from 6 to 20 curated images (nginx, node, python, postgres, mysql, mongo, redis, kafka, elasticsearch, minio, wordpress, and more) each with `requiredEnv`, `defaultPort`, and `suggestedEnv`
-- `SuggestionPanel` component (`src/components/SuggestionPanel.jsx`) — offline, non-overlay panel with scrollable window and focused-row highlight
-- Contextual env var hints in step 3 — when a known image is selected, suggested variables (e.g. `POSTGRES_USER`, `POSTGRES_DB`) are shown as guidance
-- `updateImageInput()`, `moveSuggestionSelection()`, `applyFocusedSuggestion()` functions in `useContainerCreation` hook for autocomplete state management
-- Ink mock infrastructure (`__mocks__/ink.cjs`) with `triggerInput` helper for reliable keyboard routing tests
-
-### Changed
-
-- `useControls.js` keyboard routing — ↑↓ and Enter are conditionally intercepted for suggestion navigation only on step 0 when suggestions are visible; all other steps preserve existing behavior
-- `ContainerCreationPrompt.jsx` — renders `SuggestionPanel` below the image input field on step 0
-
-## [3.2.1] - 2026-04-27
-
-### Changed
-
-- Unified `normalizeImageName` into a single `src/helpers/imageNameUtils.js` module; removed duplicate definitions from `validationHelpers.js` and `containerActions.js`.
-- Added Prettier and EditorConfig for automatic code formatting enforcement; 37 source files reformatted to consistent style (single quotes, 2-space indent, trailing commas ES5).
-- Added `eslint-config-prettier` to disable ESLint rules that conflict with Prettier.
-- Added `format` and `format:check` npm scripts.
-
-### Fixed
-
-- Missing `.jsx` extension on `import App from './App'` in `src/index.js` (ESM correctness).
-
-## [3.2.0] - 2026-04-25
-
-### Added
-
-- `IMAGE_PROFILES` map in `src/helpers/constants.js` — defines `requiredEnv` and `defaultPort` per image type (mysql, mariadb, postgres, mongo, mssql, redis).
-- `DB_IMAGES` constant exported from `src/helpers/constants.js`.
-- Contextual validation in wizard: if image matches a known profile, required env vars are enforced before creation.
-- Auto-assigned port feedback: after successful container creation, the success message shows which ports were mapped (e.g. `Ports: 3306→3306/tcp`).
-- Image name normalization: tags and registry prefixes are stripped before profile lookup (`mysql:8`, `docker.io/library/postgres:16` → `mysql`, `postgres`).
-- New test files: `test/containerOptionsBuilder.test.js`, `test/useControls.dom.test.js`.
-
-### Fixed
-
-- `validateEnvVars()` was never called in the container creation wizard step 3 — now connected and blocks on invalid input.
-- Env var parsing split on all `=` characters — fixed to split only on the first `=`, preserving values like `JWT=abc=def`.
-- `dbImages` was hardcoded in `useControls.js` — now imports `DB_IMAGES` from constants.
-
-## [3.1.9] - 2026-04-11
-
-### Changed
-
-- CI: added lint step to the test-and-build job; docs deploy now waits for CI to pass successfully via `workflow_run` trigger.
-
-## [3.1.8] - 2026-04-11
-
-### Refactored
-
-- Removed dead code: `actionHelpers`, `useLogsStream`, and esbuild-related artifacts that were no longer in use.
-- Consolidated Babel configuration into a single env-aware file, eliminating duplicate/split config files.
-- Decomposed `useControls` god hook into focused single-responsibility hooks, each owning one concern.
-- Extracted `useContainerStats` hook from `ContainerRow` to separate data-fetching from rendering.
-- Set Jest default environment to `node`; `jsdom` is now opt-in per test file, reducing unnecessary DOM overhead.
-
-### Changed
-
-- Removed generated JSDoc output from the repository; added the generated docs directory to `.gitignore`.
-- Enabled `react/prop-types` ESLint rule project-wide and resolved all resulting warnings.
-- Rewrote `README.md` and `CONTRIBUTING.md`: consolidated overlapping content, removed duplication, and updated both for accuracy.
-- Various `docs(style)` and `docs` commits between v3.1.5 and the refactor wave: dark theme, sticky nav, landing page rewrite, CSS consolidation, and English translation for the JSDoc home (GitHub Pages site).
-
-## [3.1.5] - 2025-10-18
-_Note: I'm sorry about the issues you've run into; this is a brand-new app and I'm still learning, but I'm moving as quickly as I can to deliver a quality experience._
-
-### Added
-
-- `safeCall` utility to safely invoke optional callbacks and avoid uncaught errors from consumer callbacks.
-- PropTypes added to core React components for runtime prop validation (ContainerRow, ContainerList, LogViewer, StatsBar, ContainerCreationPrompt, PromptField, MessageFeedback, Header, ContainerSection).
-
-### Changed
-
-- Container creation now inspects image `EXPOSE` declarations and auto-binds ports when the user leaves the ports step empty, reusing the next free host port to avoid conflicts (e.g. second `nginx` gets `81:80`).
-- CLI clears the terminal when starting and again after exiting with `q` for a cleaner shell experience.
-- Replaced direct optional callback invocations and stream destruction calls with `safeCall` in several modules (`containerLogs`, `useLogsStream`, `useLogsViewer`, `useContainerCreation`, `useContainerActions`, `LogViewer`).
-- ESLint config updated to include `jest` env and allow keeping `import React` for build compatibility.
-- Extracted common magic numbers into `src/helpers/constants.js` and replaced hardcoded values across the codebase:
-	- `REFRESH_INTERVALS.CONTAINER_LIST` (3000)
-	- `REFRESH_INTERVALS.CONTAINER_STATS` (1500)
-	- `MESSAGE_TIMEOUTS.SHORT` (2000) and `MESSAGE_TIMEOUTS.DEFAULT` (3000)
-	- `EXIT_DELAY` (500)
-	- `TIMEOUTS.CONTAINER_OP` (30000) and `TIMEOUTS.PULL_IMAGE` (300000)
-- Files updated to use constants: `useContainers`, `ContainerRow`, `actionHelpers`, `useControls`, `exitWithMessage`, `containerActions`.
-
-### Fixed
-
-- Added unit tests for `safeCall` and adjusted several components to silence lint warnings (unused variables).
-- Clamp `StatsBar` CPU/memory percentages to avoid negative repeat errors when streaming container stats (also refreshed component JSDoc to note the clamping).
-
-### Testing
-
-- Added additional unit tests for Docker service functions and hooks. All tests pass locally (5 suites, 26 tests).
-- Removed generated `dist/` artifacts and deleted obsolete test files that referenced incompatible test helpers.
-
-Incoming fixes and smaller tests / docs updates
-
-## [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
-
-- Addressed critical security and stability issues identified in internal audit.
-- Improved Docker service components robustness (`containerActions`, `containerList`, `containerLogs`, `containerStats`).
-- Strengthened validation helpers and extended unit tests.
-
-### Added
-
-- Documentation: `FIXES_APPLIED.md` summarizing analysis and mitigations.
-
-### Changed
-
-- Minor code refactors and clarifications across components and hooks.
-
-## [3.1.2] - 2025-10-16
-
-### Changed
-
-- Docs cleanup: remove Spanish inline comments; add English JSDoc across source files.
-
-## [3.1.0] - 2025-10-16
-
-### Added
-
-- Modularized hooks: `useContainerCreation`, `useContainerActions`, `useLogsViewer`.
-- Validation helpers and unit tests for port validation.
-- CI workflow (GitHub Actions) and README improvements.
-
-### Changed
-
-- Container creation UX: English feedback messages, mandatory/validated port input, DB image warnings.
-- Added erase action (key `E`) with confirmation to delete containers.
-- Normalized source imports to include explicit `.js`/`.jsx` extensions for ESM compatibility.
-
-### Fixed
-
-- Various runtime & build issues after modularization (import fixes, exposing container action functions, creation flow wiring).
-
-## [3.1.1] - 2025-10-16
-
-### Fixed
-
-- Minor docs typo fixes and README global install note added.
-

package/CODE_OF_CONDUCT.md

@@ -1,12 +0,0 @@
-# Contributor Covenant Code of Conduct
-
-This project follows the Contributor Covenant Code of Conduct. By participating, you agree to abide by its terms.
-
-Please see https://www.contributor-covenant.org/ for the full text.
-## Code of Conduct
-
-This project follows the [Contributor Covenant](https://www.contributor-covenant.org/).
-
-Be respectful, inclusive, and kind. Harassment, discrimination, or abusive language will not be tolerated.
-
-If you experience or witness unacceptable behavior, please contact the maintainers.

package/CONTRIBUTING.md

@@ -1,35 +0,0 @@
-# Contributing to CDD-CLI
-
-Thanks for your interest in contributing! Here are the guidelines to make collaboration smooth.
-
-## Getting started
-
-1. Fork the repo and create a branch for your feature or fix:
-
-```bash
-git checkout -b feat/my-feature
-```
-
-2. Install dependencies and verify everything works before making changes:
-
-```bash
-npm install
-npm test
-npm run build
-```
-
-## Guidelines
-
-- Keep changes small and focused — one concern per PR.
-- Write tests for any new behavior and ensure existing tests pass (`npm test`).
-- Run `npm run build` and verify the CLI starts (`node dist/index.js`) before opening a PR.
-- Use [Conventional Commits](https://www.conventionalcommits.org/) for commit messages.
-- For large or design-changing contributions, open an issue first to discuss the approach.
-
-## Opening a Pull Request
-
-- Describe the motivation and what changed.
-- Link any related issues.
-- Tag reviewers if applicable.
-
-We appreciate clear, well-tested contributions.