cdd-cli 4.0.0 → 4.1.0

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.