@getmonoceros/workbench 1.0.1 → 1.2.0

package/dist/bin.js

@@ -20,6 +20,13 @@ var bold = (s) => color(s, ANSI_BOLD);
 var underline = (s) => color(s, ANSI_UNDERLINE);
 var cyan = (s) => color(s, ANSI_CYAN);
 var grey = (s) => color(s, ANSI_GREY);
+var GROUPS = [
+  { key: "lifecycle", label: "Container lifecycle" },
+  { key: "run", label: "Run + inspect" },
+  { key: "edit", label: "Edit container yml" },
+  { key: "discovery", label: "Discovery" },
+  { key: "tooling", label: "Tooling" }
+];
 function resolveArgs(argsDef) {
   if (!argsDef) return [];
   const out = [];
@@ -52,19 +59,92 @@ function renderArgDescription(arg, isRequired) {
   return parts.join(" ");
 }
 var ANSI_RE = /\x1b\[[0-9;]*m/g;
+function visibleLen(s) {
+  return s.replace(ANSI_RE, "").length;
+}
+function terminalWidth() {
+  return process.stdout.columns && process.stdout.columns > 40 ? process.stdout.columns : 100;
+}
+function wrapText(text, width, continuationIndent) {
+  if (visibleLen(text) <= width) return text;
+  const words = text.split(/(\s+)/);
+  const lines = [];
+  let current = "";
+  for (const w of words) {
+    if (visibleLen(current) + visibleLen(w) <= width) {
+      current += w;
+      continue;
+    }
+    if (current.length > 0) lines.push(current.replace(/\s+$/, ""));
+    current = w.replace(/^\s+/, "");
+  }
+  if (current.length > 0) lines.push(current.replace(/\s+$/, ""));
+  return lines.map((l, i) => i === 0 ? l : continuationIndent + l).join("\n");
+}
 function alignTable(rows, indent) {
   if (rows.length === 0) return "";
-  const visibleLen = (s) => s.replace(ANSI_RE, "").length;
-  const width = Math.max(...rows.map((r) => visibleLen(r[0])));
+  const labelWidth = Math.max(...rows.map((r) => visibleLen(r[0])));
+  const gutter = "    ";
+  const descWidth = terminalWidth() - indent.length - labelWidth - gutter.length;
+  const continuationIndent = " ".repeat(
+    indent.length + labelWidth + gutter.length
+  );
   return rows.map(([left, right]) => {
-    const pad = " ".repeat(width - visibleLen(left));
-    return `${indent}${left}${pad}    ${right}`;
+    const pad = " ".repeat(labelWidth - visibleLen(left));
+    const wrapped = wrapText(right, descWidth, continuationIndent);
+    return `${indent}${left}${pad}${gutter}${wrapped}`;
   }).join("\n");
 }
+function collectSubCommands(cmd) {
+  const subs = cmd.subCommands ?? {};
+  const out = [];
+  for (const [name, sub] of Object.entries(subs)) {
+    const meta = sub?.meta ?? {};
+    if (meta.hidden) continue;
+    out.push({
+      name,
+      description: meta.description ?? "",
+      group: meta.group ?? "other"
+    });
+  }
+  return out;
+}
+function renderCommandsBlock(entries) {
+  if (entries.length === 0) return [];
+  const lines = [];
+  lines.push(underline(bold("COMMANDS")));
+  const byGroup = /* @__PURE__ */ new Map();
+  for (const entry2 of entries) {
+    const arr = byGroup.get(entry2.group) ?? [];
+    arr.push(entry2);
+    byGroup.set(entry2.group, arr);
+  }
+  const renderSection = (label, items) => {
+    if (items.length === 0) return;
+    lines.push("");
+    lines.push(underline(grey(label)));
+    lines.push("");
+    const rows = items.map((e) => [
+      cyan(e.name),
+      e.description
+    ]);
+    lines.push(alignTable(rows, ""));
+  };
+  for (const { key, label } of GROUPS) {
+    renderSection(label, byGroup.get(key) ?? []);
+    byGroup.delete(key);
+  }
+  for (const [groupKey, items] of byGroup) {
+    const label = groupKey === "other" ? "Other" : groupKey;
+    renderSection(label, items);
+  }
+  lines.push("");
+  return lines;
+}
 function renderUsageBlock(cmd, commandPath) {
   const meta = cmd.meta ?? {};
   const args = resolveArgs(cmd.args ?? {});
-  const subCommands = cmd.subCommands ?? {};
+  const subCommandEntries = collectSubCommands(cmd);
   const fullName = commandPath.join(" ") || meta.name || "monoceros";
   const positionals = args.filter((a) => a.type === "positional");
   const flags = args.filter((a) => a.type !== "positional");
@@ -74,17 +154,12 @@ function renderUsageBlock(cmd, commandPath) {
     const t = p.name.toUpperCase();
     usageTokens.push(isRequired ? `<${t}>` : `[${t}]`);
   }
-  const subCommandNames = Object.keys(subCommands).filter((n) => {
-    const sub = subCommands[n];
-    const subMeta = sub?.meta ?? {};
-    return !subMeta.hidden;
-  });
-  if (subCommandNames.length > 0) usageTokens.push(subCommandNames.join("|"));
+  if (subCommandEntries.length > 0) usageTokens.push("<command>");
   if (flags.length > 0) usageTokens.push("[OPTIONS]");
   const lines = [];
   const version = meta.version;
   const header = `${meta.description ?? ""} (${fullName}${version ? ` v${version}` : ""})`;
-  lines.push(grey(header));
+  lines.push(grey(wrapText(header, terminalWidth(), "")));
   lines.push("");
   lines.push(
     `${underline(bold("USAGE"))} ${cyan([fullName, ...usageTokens].join(" "))}`
@@ -112,17 +187,10 @@ function renderUsageBlock(cmd, commandPath) {
     lines.push(alignTable(rows, "  "));
     lines.push("");
   }
-  if (subCommandNames.length > 0) {
-    lines.push(underline(bold("COMMANDS")));
-    lines.push("");
-    const rows = [];
-    for (const n of subCommandNames) {
-      const sub = subCommands[n];
-      const subMeta = sub?.meta ?? {};
-      rows.push([cyan(n), subMeta.description ?? ""]);
+  if (subCommandEntries.length > 0) {
+    for (const line of renderCommandsBlock(subCommandEntries)) {
+      lines.push(line);
     }
-    lines.push(alignTable(rows, "  "));
-    lines.push("");
     lines.push(
       `Use ${cyan(`${fullName} <command> --help`)} for more information about a command.`
     );
@@ -185,7 +253,7 @@ function getInnerArgs() {
 }
 
 // src/main.ts
-import { defineCommand as defineCommand24 } from "citty";
+import { defineCommand as defineCommand25 } from "citty";
 
 // src/commands/add-apt-packages.ts
 import { defineCommand } from "citty";
@@ -1279,6 +1347,7 @@ var defaultConfirm = async (message) => {
 var addAptPackagesCommand = defineCommand({
   meta: {
     name: "add-apt-packages",
+    group: "edit",
     description: "Add Debian/Ubuntu apt packages to the container config. Pass package names after `--` (e.g. `monoceros add-apt-packages sandbox -- make openssh-client jq`). Idempotent. No curated whitelist \u2014 invalid names surface as apt errors at container build time."
   },
   args: {
@@ -1322,6 +1391,7 @@ import { consola as consola3 } from "consola";
 var addFeatureCommand = defineCommand2({
   meta: {
     name: "add-feature",
+    group: "edit",
     description: "Add a devcontainer feature by ref to the container config. Options follow `--` as `key=value` pairs. Idempotent (same ref + same options is a no-op). Adding the same ref with different options is an error."
   },
   args: {
@@ -1395,6 +1465,7 @@ import { consola as consola4 } from "consola";
 var addFromUrlCommand = defineCommand3({
   meta: {
     name: "add-from-url",
+    group: "edit",
     description: "Add an https:// install URL to the container config. The URL gets piped to sh on every container rebuild. Loudly warns about remote-code execution before persisting. Idempotent."
   },
   args: {
@@ -1466,6 +1537,7 @@ import { consola as consola5 } from "consola";
 var addRepoCommand = defineCommand4({
   meta: {
     name: "add-repo",
+    group: "edit",
     description: "Add a git repo to the container config. Cloned into projects/<folder>/ on container build. Idempotent \u2014 existing project subfolders are left alone. Folder name derived from URL by default; override with --as."
   },
   args: {
@@ -1517,6 +1589,7 @@ import { consola as consola6 } from "consola";
 var addLanguageCommand = defineCommand5({
   meta: {
     name: "add-language",
+    group: "edit",
     description: "Add a language toolchain (devcontainer feature) to the container config. Idempotent, prints a diff before writing."
   },
   args: {
@@ -1558,6 +1631,7 @@ import { consola as consola7 } from "consola";
 var addServiceCommand = defineCommand6({
   meta: {
     name: "add-service",
+    group: "edit",
     description: "Add a compose service (postgres, mysql, redis, \u2026) to the container config. Idempotent, prints a diff before writing."
   },
   args: {
@@ -2289,7 +2363,7 @@ function warnOnDeprecatedFeatureRefs(containerFeatures, globalConfig, logger) {
 }
 
 // src/version.ts
-var CLI_VERSION = "1.0.1";
+var CLI_VERSION = "1.2.0";
 
 // src/commands/_dispatch.ts
 import { consola as consola11 } from "consola";
@@ -2307,6 +2381,7 @@ async function dispatch(runner) {
 var applyCommand = defineCommand7({
   meta: {
     name: "apply",
+    group: "lifecycle",
     description: "Materialize a container config into $MONOCEROS_HOME/container/<name>/ and bring the dev-container up. Close any VS Code Remote Containers session for the target first \u2014 the extension auto-recreates and races with apply."
   },
   args: {
@@ -2327,8 +2402,215 @@ var applyCommand = defineCommand7({
   }
 });
 
-// src/commands/init.ts
+// src/commands/completion.ts
 import { defineCommand as defineCommand8 } from "citty";
+var ALL_COMMANDS = [
+  "init",
+  "list-components",
+  "shell",
+  "run",
+  "logs",
+  "start",
+  "stop",
+  "status",
+  "apply",
+  "remove",
+  "restore",
+  "add-service",
+  "add-language",
+  "add-apt-packages",
+  "add-feature",
+  "add-from-url",
+  "add-repo",
+  "remove-service",
+  "remove-language",
+  "remove-apt-packages",
+  "remove-feature",
+  "remove-from-url",
+  "remove-repo",
+  "completion"
+];
+var COMMANDS_WITH_CONTAINER_ARG = [
+  "shell",
+  "run",
+  "logs",
+  "start",
+  "stop",
+  "status",
+  "apply",
+  "remove",
+  "add-service",
+  "add-language",
+  "add-apt-packages",
+  "add-feature",
+  "add-from-url",
+  "add-repo",
+  "remove-service",
+  "remove-language",
+  "remove-apt-packages",
+  "remove-feature",
+  "remove-from-url",
+  "remove-repo"
+];
+var SHELLS = ["bash", "zsh", "pwsh"];
+function renderCompletionScript(shell) {
+  const commands = ALL_COMMANDS.join(" ");
+  const containerCommandsRegex = COMMANDS_WITH_CONTAINER_ARG.join("|");
+  if (shell === "bash") {
+    return [
+      "# bash completion for monoceros",
+      "# install: source this file from .bashrc, e.g.",
+      "#   monoceros completion bash > ~/.bash_completion.d/monoceros",
+      '#   echo "source ~/.bash_completion.d/monoceros" >> ~/.bashrc',
+      "",
+      "_monoceros() {",
+      "  local cur prev cmd home configs_dir names",
+      '  cur="${COMP_WORDS[COMP_CWORD]}"',
+      "",
+      "  if [[ $COMP_CWORD -eq 1 ]]; then",
+      `    COMPREPLY=( $(compgen -W "${commands}" -- "$cur") )`,
+      "    return",
+      "  fi",
+      "",
+      '  cmd="${COMP_WORDS[1]}"',
+      "  if [[ $COMP_CWORD -eq 2 ]]; then",
+      '    case "$cmd" in',
+      `      ${containerCommandsRegex})`,
+      '        home="${MONOCEROS_HOME:-$HOME/.monoceros}"',
+      '        configs_dir="$home/container-configs"',
+      '        if [[ -d "$configs_dir" ]]; then',
+      `          names=$(cd "$configs_dir" && ls *.yml 2>/dev/null | sed 's/\\.yml$//')`,
+      '          COMPREPLY=( $(compgen -W "$names" -- "$cur") )',
+      "        fi",
+      "        ;;",
+      "      completion)",
+      `        COMPREPLY=( $(compgen -W "${SHELLS.join(" ")}" -- "$cur") )`,
+      "        ;;",
+      "    esac",
+      "  fi",
+      "}",
+      "complete -F _monoceros monoceros",
+      ""
+    ].join("\n");
+  }
+  if (shell === "pwsh") {
+    return [
+      "# PowerShell completion for monoceros",
+      "# install: dot-source this file from your $PROFILE, e.g.",
+      "#   monoceros completion pwsh > $HOME/.config/monoceros/completion.ps1",
+      "#   Add-Content $PROFILE '. $HOME/.config/monoceros/completion.ps1'",
+      "",
+      "Register-ArgumentCompleter -Native -CommandName monoceros -ScriptBlock {",
+      "    param($wordToComplete, $commandAst, $cursorPosition)",
+      "",
+      "    $commands = @(",
+      ...ALL_COMMANDS.map((c) => `        '${c}'`),
+      "    )",
+      `    $shells = @('${SHELLS.join("', '")}')`,
+      "    $containerCommands = @(",
+      ...COMMANDS_WITH_CONTAINER_ARG.map((c) => `        '${c}'`),
+      "    )",
+      "",
+      "    $tokens = $commandAst.CommandElements",
+      "    $position = $tokens.Count",
+      "    if ($wordToComplete) { $position-- }",
+      "",
+      "    if ($position -eq 1) {",
+      '        $commands | Where-Object { $_ -like "$wordToComplete*" } |',
+      '            ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, "ParameterValue", $_) }',
+      "        return",
+      "    }",
+      "",
+      "    if ($position -eq 2) {",
+      "        $cmd = $tokens[1].Value",
+      "        if ($containerCommands -contains $cmd) {",
+      '            $home = if ($env:MONOCEROS_HOME) { $env:MONOCEROS_HOME } else { Join-Path $env:USERPROFILE ".monoceros" }',
+      '            $configsDir = Join-Path $home "container-configs"',
+      "            if (Test-Path $configsDir) {",
+      '                Get-ChildItem -Path $configsDir -Filter "*.yml" |',
+      "                    ForEach-Object { $_.BaseName } |",
+      '                    Where-Object { $_ -like "$wordToComplete*" } |',
+      '                    ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, "ParameterValue", $_) }',
+      "            }",
+      '        } elseif ($cmd -eq "completion") {',
+      '            $shells | Where-Object { $_ -like "$wordToComplete*" } |',
+      '                ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, "ParameterValue", $_) }',
+      "        }",
+      "    }",
+      "}",
+      ""
+    ].join("\n");
+  }
+  return [
+    "#compdef monoceros",
+    "# zsh completion for monoceros",
+    "# install: drop this file somewhere on your $fpath as `_monoceros`,",
+    "# then start a new shell (or run `compinit`). Example:",
+    '#   monoceros completion zsh > "${fpath[1]}/_monoceros"',
+    "",
+    "_monoceros() {",
+    "  local -a commands shells",
+    "  commands=(",
+    ...ALL_COMMANDS.map((c) => `    '${c}'`),
+    "  )",
+    `  shells=(${SHELLS.map((s) => `'${s}'`).join(" ")})`,
+    "",
+    "  if (( CURRENT == 2 )); then",
+    "    _describe 'monoceros command' commands",
+    "    return",
+    "  fi",
+    "",
+    "  local cmd=${words[2]}",
+    "  if (( CURRENT == 3 )); then",
+    "    case $cmd in",
+    `      ${containerCommandsRegex})`,
+    '        local home="${MONOCEROS_HOME:-$HOME/.monoceros}"',
+    '        local configs_dir="$home/container-configs"',
+    "        if [[ -d $configs_dir ]]; then",
+    "          local -a names",
+    "          names=(${configs_dir}/*.yml(N:t:r))",
+    "          _describe 'container' names",
+    "        fi",
+    "        ;;",
+    "      completion)",
+    "        _describe 'shell' shells",
+    "        ;;",
+    "    esac",
+    "  fi",
+    "}",
+    "",
+    '_monoceros "$@"',
+    ""
+  ].join("\n");
+}
+var completionCommand = defineCommand8({
+  meta: {
+    name: "completion",
+    group: "tooling",
+    description: "Print a shell completion script for bash, zsh or PowerShell to stdout. Pipe the output into a file your shell loads at startup. The install scripts (install.sh / install.ps1) call this automatically."
+  },
+  args: {
+    shell: {
+      type: "positional",
+      description: "Target shell. One of: 'bash', 'zsh', 'pwsh'.",
+      required: true
+    }
+  },
+  run({ args }) {
+    const shell = args.shell;
+    if (shell !== "bash" && shell !== "zsh" && shell !== "pwsh") {
+      process.stderr.write(
+        `Unknown shell: ${JSON.stringify(shell)}. Supported: ${SHELLS.join(", ")}.
+`
+      );
+      process.exit(2);
+    }
+    process.stdout.write(renderCompletionScript(shell));
+  }
+});
+
+// src/commands/init.ts
+import { defineCommand as defineCommand9 } from "citty";
 import { consola as consola13 } from "consola";
 
 // src/init/index.ts
@@ -2788,9 +3070,10 @@ async function runInit(opts) {
 }
 
 // src/commands/init.ts
-var initCommand = defineCommand8({
+var initCommand = defineCommand9({
   meta: {
     name: "init",
+    group: "lifecycle",
     description: "Create a fresh container-config yml at .local/container-configs/<name>.yml. Without --with, the file is a documented default with every component commented out. With --with=<names>, the named components are composed into an active, immediately-applyable yml. Then run `monoceros apply <name>`."
   },
   args: {
@@ -2841,11 +3124,12 @@ function collectWithList(withArg, rawArgs) {
 }
 
 // src/commands/list-components.ts
-import { defineCommand as defineCommand9 } from "citty";
+import { defineCommand as defineCommand10 } from "citty";
 import { consola as consola14 } from "consola";
-var listComponentsCommand = defineCommand9({
+var listComponentsCommand = defineCommand10({
   meta: {
     name: "list-components",
+    group: "discovery",
     description: "Print the components catalog used by `monoceros init --with=\u2026`. Each line is `name<TAB>category<TAB>displayName`, grouped by category for readability."
   },
   args: {},
@@ -2885,10 +3169,11 @@ var listComponentsCommand = defineCommand9({
 });
 
 // src/commands/logs.ts
-import { defineCommand as defineCommand10 } from "citty";
-var logsCommand = defineCommand10({
+import { defineCommand as defineCommand11 } from "citty";
+var logsCommand = defineCommand11({
   meta: {
     name: "logs",
+    group: "run",
     description: "Tail logs from the compose services of the named dev-container. Pass --no-follow for a one-shot dump."
   },
   args: {
@@ -2920,11 +3205,12 @@ var logsCommand = defineCommand10({
 });
 
 // src/commands/remove-apt-packages.ts
-import { defineCommand as defineCommand11 } from "citty";
+import { defineCommand as defineCommand12 } from "citty";
 import { consola as consola15 } from "consola";
-var removeAptPackagesCommand = defineCommand11({
+var removeAptPackagesCommand = defineCommand12({
   meta: {
     name: "remove-apt-packages",
+    group: "edit",
     description: "Remove apt packages from the container config. Pass package names after `--` (e.g. `monoceros remove-apt-packages sandbox -- make jq`). Idempotent, prints a diff before writing."
   },
   args: {
@@ -2963,11 +3249,12 @@ var removeAptPackagesCommand = defineCommand11({
 });
 
 // src/commands/remove-feature.ts
-import { defineCommand as defineCommand12 } from "citty";
+import { defineCommand as defineCommand13 } from "citty";
 import { consola as consola16 } from "consola";
-var removeFeatureCommand = defineCommand12({
+var removeFeatureCommand = defineCommand13({
   meta: {
     name: "remove-feature",
+    group: "edit",
     description: "Remove a devcontainer feature from the container config (by its OCI ref). Idempotent, prints a diff before writing."
   },
   args: {
@@ -3004,7 +3291,7 @@ var removeFeatureCommand = defineCommand12({
 });
 
 // src/commands/remove.ts
-import { defineCommand as defineCommand13 } from "citty";
+import { defineCommand as defineCommand14 } from "citty";
 import { consola as consola18 } from "consola";
 import { createInterface } from "readline/promises";
 
@@ -3090,9 +3377,10 @@ async function runRemove(opts) {
 }
 
 // src/commands/remove.ts
-var removeCommand = defineCommand13({
+var removeCommand = defineCommand14({
   meta: {
     name: "remove",
+    group: "lifecycle",
     description: "Wipe everything belonging to a container: stop and remove the docker objects, back up the container-configs yml + container directory (incl. home/, projects/, data/), then delete them from disk. Shared docker images stay. By default the destructive step is confirmed interactively; pass -y to skip."
   },
   args: {
@@ -3150,7 +3438,7 @@ var removeCommand = defineCommand13({
 });
 
 // src/commands/restore.ts
-import { defineCommand as defineCommand14 } from "citty";
+import { defineCommand as defineCommand15 } from "citty";
 import { consola as consola20 } from "consola";
 
 // src/restore/index.ts
@@ -3218,9 +3506,10 @@ async function runRestore(opts) {
 }
 
 // src/commands/restore.ts
-var restoreCommand = defineCommand14({
+var restoreCommand = defineCommand15({
   meta: {
     name: "restore",
+    group: "lifecycle",
     description: "Restore a container's host-side state from a backup written by `monoceros remove`. Copies the yml and the container directory back into $MONOCEROS_HOME. Refuses to overwrite an existing config or container \u2014 remove the in-place container first if you need to clobber. Run `monoceros apply <name>` afterwards to bring it back up."
   },
   args: {
@@ -3241,11 +3530,12 @@ var restoreCommand = defineCommand14({
 });
 
 // src/commands/remove-from-url.ts
-import { defineCommand as defineCommand15 } from "citty";
+import { defineCommand as defineCommand16 } from "citty";
 import { consola as consola21 } from "consola";
-var removeFromUrlCommand = defineCommand15({
+var removeFromUrlCommand = defineCommand16({
   meta: {
     name: "remove-from-url",
+    group: "edit",
     description: "Remove a previously-added install URL from the container config. Idempotent, prints a diff before writing. The URL is dropped from post-create.sh on the next `monoceros apply`."
   },
   args: {
@@ -3282,11 +3572,12 @@ var removeFromUrlCommand = defineCommand15({
 });
 
 // src/commands/remove-language.ts
-import { defineCommand as defineCommand16 } from "citty";
+import { defineCommand as defineCommand17 } from "citty";
 import { consola as consola22 } from "consola";
-var removeLanguageCommand = defineCommand16({
+var removeLanguageCommand = defineCommand17({
   meta: {
     name: "remove-language",
+    group: "edit",
     description: "Remove a language toolchain from the container config. Idempotent, prints a diff before writing."
   },
   args: {
@@ -3323,11 +3614,12 @@ var removeLanguageCommand = defineCommand16({
 });
 
 // src/commands/remove-repo.ts
-import { defineCommand as defineCommand17 } from "citty";
+import { defineCommand as defineCommand18 } from "citty";
 import { consola as consola23 } from "consola";
-var removeRepoCommand = defineCommand17({
+var removeRepoCommand = defineCommand18({
   meta: {
     name: "remove-repo",
+    group: "edit",
     description: "Remove a repo from the container config (matches by URL or by its projects/<folder> name). Does NOT delete the existing projects/<folder> directory \u2014 local edits are preserved; clean it up manually."
   },
   args: {
@@ -3364,11 +3656,12 @@ var removeRepoCommand = defineCommand17({
 });
 
 // src/commands/remove-service.ts
-import { defineCommand as defineCommand18 } from "citty";
+import { defineCommand as defineCommand19 } from "citty";
 import { consola as consola24 } from "consola";
-var removeServiceCommand = defineCommand18({
+var removeServiceCommand = defineCommand19({
   meta: {
     name: "remove-service",
+    group: "edit",
     description: "Remove a compose service from the container config. Idempotent, prints a diff before writing. Note: data volumes (e.g. postgres-data) are NOT cleaned up automatically."
   },
   args: {
@@ -3405,7 +3698,7 @@ var removeServiceCommand = defineCommand18({
 });
 
 // src/commands/run.ts
-import { defineCommand as defineCommand19 } from "citty";
+import { defineCommand as defineCommand20 } from "citty";
 import { consola as consola25 } from "consola";
 
 // src/devcontainer/shell.ts
@@ -3455,9 +3748,10 @@ async function runInContainer(opts) {
 }
 
 // src/commands/run.ts
-var runCommand = defineCommand19({
+var runCommand = defineCommand20({
   meta: {
     name: "run",
+    group: "run",
     description: "Run a one-off command inside the named dev-container. Use `--` to separate monoceros flags from the inner command."
   },
   args: {
@@ -3489,11 +3783,12 @@ var runCommand = defineCommand19({
 });
 
 // src/commands/shell.ts
-import { defineCommand as defineCommand20 } from "citty";
+import { defineCommand as defineCommand21 } from "citty";
 import { consola as consola26 } from "consola";
-var shellCommand = defineCommand20({
+var shellCommand = defineCommand21({
   meta: {
     name: "shell",
+    group: "run",
     description: "Open an interactive bash session inside the named dev-container."
   },
   args: {
@@ -3515,10 +3810,11 @@ var shellCommand = defineCommand20({
 });
 
 // src/commands/start.ts
-import { defineCommand as defineCommand21 } from "citty";
-var startCommand = defineCommand21({
+import { defineCommand as defineCommand22 } from "citty";
+var startCommand = defineCommand22({
   meta: {
     name: "start",
+    group: "run",
     description: "Bring the named dev-container up via `devcontainer up` (workspace + runServices, postCreate, features)."
   },
   args: {
@@ -3534,10 +3830,11 @@ var startCommand = defineCommand21({
 });
 
 // src/commands/status.ts
-import { defineCommand as defineCommand22 } from "citty";
-var statusCommand = defineCommand22({
+import { defineCommand as defineCommand23 } from "citty";
+var statusCommand = defineCommand23({
   meta: {
     name: "status",
+    group: "run",
     description: "Show whether the compose services for the named dev-container are running."
   },
   args: {
@@ -3562,10 +3859,11 @@ var statusCommand = defineCommand22({
 });
 
 // src/commands/stop.ts
-import { defineCommand as defineCommand23 } from "citty";
-var stopCommand = defineCommand23({
+import { defineCommand as defineCommand24 } from "citty";
+var stopCommand = defineCommand24({
   meta: {
     name: "stop",
+    group: "run",
     description: "Stop the compose services for the named dev-container. Volumes are preserved."
   },
   args: {
@@ -3590,7 +3888,7 @@ var stopCommand = defineCommand23({
 });
 
 // src/main.ts
-var main = defineCommand24({
+var main = defineCommand25({
   meta: {
     name: "monoceros",
     version: CLI_VERSION,
@@ -3619,7 +3917,8 @@ var main = defineCommand24({
     "remove-apt-packages": removeAptPackagesCommand,
     "remove-feature": removeFeatureCommand,
     "remove-from-url": removeFromUrlCommand,
-    "remove-repo": removeRepoCommand
+    "remove-repo": removeRepoCommand,
+    completion: completionCommand
   }
 });