cdd-cli 3.2.2 → 4.1.0

package/dist/hooks/useContainerCommandRouter.js

@@ -16,6 +16,7 @@ import { useCallback } from 'react';
  *   l  — open logs viewer and start log stream
  *   c  — open container creation wizard (reset + activate)
  *   d  — toggle debug log panel
+ *   s  — open interactive shell in container
  *
  * @param {Object} params
  * @param {Object} params.actions       - API from useContainerActions
@@ -27,6 +28,7 @@ import { useCallback } from 'react';
  * @param {Function} params.onStartErase    - Callback: activates confirmErase state
  * @param {Function} params.onToggleDebug   - Callback: toggles showDebugLogs state
  * @param {Function} params.onStartCreate   - Callback: sets creatingContainer = true
+ * @param {Function} params.onOpenShell     - Callback: opens interactive shell
  * @returns {{ handleDockerCommands: Function }}
  */
 export function useContainerCommandRouter(_ref) {
@@ -38,7 +40,8 @@ export function useContainerCommandRouter(_ref) {
     startLogsStream = _ref.startLogsStream,
     onStartErase = _ref.onStartErase,
     onToggleDebug = _ref.onToggleDebug,
-    onStartCreate = _ref.onStartCreate;
+    onStartCreate = _ref.onStartCreate,
+    onOpenShell = _ref.onOpenShell;
   var handleDockerCommands = useCallback(function (input) {
     var container = containers[selected];
     if (input === 'i') {
@@ -135,16 +138,23 @@ export function useContainerCommandRouter(_ref) {
       return true;
     }
     if (input === 'c') {
-      onStartCreate();
       creation.resetCreation();
+      onStartCreate();
       return true;
     }
     if (input === 'd') {
       onToggleDebug();
       return true;
     }
+    if (input === 's') {
+      if (!container) {
+        return true;
+      }
+      onOpenShell(container);
+      return true;
+    }
     return false;
-  }, [actions, containers, creation, logsViewer, onStartCreate, onStartErase, onToggleDebug, selected, startLogsStream]);
+  }, [actions, containers, creation, logsViewer, onStartCreate, onStartErase, onToggleDebug, onOpenShell, selected, startLogsStream]);
   return {
     handleDockerCommands: handleDockerCommands
   };

package/dist/hooks/useControls.js

@@ -22,6 +22,7 @@ import { useDebugLogs } from './debug/useDebugLogs.js';
 import { useEraseConfirmation } from './useEraseConfirmation.js';
 import { useExitHandler } from './useExitHandler.js';
 import { useContainerCommandRouter } from './useContainerCommandRouter.js';
+import { useShellMode } from './useShellMode.js';
 import { getLogsStream } from '../helpers/dockerService/serviceComponents/containerLogs.js';
 import { createContainer as svcCreateContainer } from '../helpers/dockerService/serviceComponents/containerActions.js';
 import { buildContainerOptions } from '../helpers/containerOptionsBuilder.js';
@@ -36,7 +37,9 @@ import { DB_IMAGES } from '../helpers/constants.js';
  * @returns {Object} controls - API for the App component
  */
 export function useControls() {
+  var _overrides$triggerHub, _overrides$isSearchin;
   var containers = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
+  var overrides = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
   var _React$useState = React.useState(false),
     _React$useState2 = _slicedToArray(_React$useState, 2),
     creatingContainer = _React$useState2[0],
@@ -46,6 +49,7 @@ export function useControls() {
   var actions = useContainerActions({
     containers: containers
   });
+  var shellMode = useShellMode();
   var creation = useContainerCreation({
     onCreate: function () {
       var _onCreate = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(_ref) {
@@ -60,8 +64,7 @@ export function useControls() {
                 portInput: portInput,
                 envInput: envInput
               });
-              actions.setMessage("Creating container ".concat(imageName, "..."));
-              actions.setMessageColor('yellow');
+              actions.setTimedMessage("Creating container ".concat(imageName, "..."), 'yellow');
               _context.p = 1;
               _context.n = 2;
               return svcCreateContainer(imageName, options);
@@ -75,15 +78,13 @@ export function useControls() {
                   return "".concat(p.hostPort, "\u2192").concat(p.containerPort, "/").concat(p.protocol);
                 }).join(', ');
               }
-              actions.setMessage("Created container ".concat(id).concat(portMsg));
-              actions.setMessageColor('green');
+              actions.setTimedMessage("Created container ".concat(id).concat(portMsg), 'green');
               _context.n = 4;
               break;
             case 3:
               _context.p = 3;
               _t = _context.v;
-              actions.setMessage("Error creating container: ".concat(_t.message));
-              actions.setMessageColor('red');
+              actions.setTimedMessage("Error creating container: ".concat(_t.message), 'red');
             case 4:
               _context.p = 4;
               setCreatingContainer(false);
@@ -106,6 +107,11 @@ export function useControls() {
   var logsViewer = useLogsViewer();
   var selection = useContainerSelection(containers.length);
   var debugLogs = useDebugLogs();
+
+  // Allow overrides for testability (e.g. injecting a mock triggerHubSearch)
+  var triggerHubSearch = (_overrides$triggerHub = overrides.triggerHubSearch) !== null && _overrides$triggerHub !== void 0 ? _overrides$triggerHub : creation.triggerHubSearch;
+  var isSearchingHub = (_overrides$isSearchin = overrides.isSearchingHub) !== null && _overrides$isSearchin !== void 0 ? _overrides$isSearchin : creation.isSearchingHub;
+  var insertNextSuggestedEnv = overrides.insertNextSuggestedEnv !== undefined ? overrides.insertNextSuggestedEnv : creation.insertNextSuggestedEnv;
   var eraseConfirmation = useEraseConfirmation({
     onConfirm: function onConfirm() {
       actions.handleAction({
@@ -172,6 +178,9 @@ export function useControls() {
     },
     onStartCreate: function onStartCreate() {
       return setCreatingContainer(true);
+    },
+    onOpenShell: function onOpenShell(container) {
+      return shellMode.openShell(container);
     }
   });
   var exitHandler = useExitHandler({
@@ -211,6 +220,18 @@ export function useControls() {
       return;
     }
 
+    // Tab on step 0: trigger Docker Hub search (with guards)
+    if (key.tab) {
+      if (step === 0) {
+        if (!isSearchingHub && (creation.imageName || '').trim() !== '') {
+          triggerHubSearch();
+        }
+      } else if (step === 3) {
+        insertNextSuggestedEnv === null || insertNextSuggestedEnv === void 0 || insertNextSuggestedEnv();
+      }
+      return;
+    }
+
     // Arrow keys on step 0: navigate suggestion list
     if (step === 0 && creation.suggestions.length > 0) {
       if (key.upArrow) {
@@ -240,7 +261,7 @@ export function useControls() {
       if (step === 2) appendChar(creation.setPortInput, creation.portInput, input);
       if (step === 3) appendChar(creation.setEnvInput, creation.envInput, input);
     }
-  }, [creation, setCreatingContainer]);
+  }, [creation, setCreatingContainer, triggerHubSearch, isSearchingHub, insertNextSuggestedEnv]);
 
   // Single keyboard entry point
   useInput(function (input, key) {

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

@@ -10,5 +10,14 @@
 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);
+});
+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": "3.2.2",
+  "version": "4.1.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"
-}