From dbae29ab5a62e88f5eb157aac9f39bea40bfd3b2 Mon Sep 17 00:00:00 2001
From: Martin Helmich <m.helmich@mittwald.de>
Date: Wed, 29 May 2024 16:44:00 +0200
Subject: [PATCH 01/11] Add "app update" command to change entrypoint+docroot

---
 src/commands/app/update.tsx             | 137 ++++++++++++++++++++++++
 src/commands/app/upgrade.tsx            |   8 +-
 src/rendering/process/process.tsx       |   2 +-
 src/rendering/process/process_fancy.tsx |   2 +-
 4 files changed, 140 insertions(+), 9 deletions(-)
 create mode 100644 src/commands/app/update.tsx

diff --git a/src/commands/app/update.tsx b/src/commands/app/update.tsx
new file mode 100644
index 000000000..80cc13a51
--- /dev/null
+++ b/src/commands/app/update.tsx
@@ -0,0 +1,137 @@
+import { ExecRenderBaseCommand } from "../../lib/basecommands/ExecRenderBaseCommand.js";
+import React, { ReactNode } from "react";
+import {
+  appInstallationArgs,
+  withAppInstallationId,
+} from "../../lib/resources/app/flags.js";
+import {
+  makeProcessRenderer,
+  processFlags,
+} from "../../rendering/process/process_flags.js";
+import { MittwaldAPIV2 } from "@mittwald/api-client";
+import { Success } from "../../rendering/react/components/Success.js";
+import { Value } from "../../rendering/react/components/Value.js";
+import { Flags } from "@oclif/core";
+import { CommandFlags } from "../../lib/basecommands/CommandFlags.js";
+
+type AppSavedUserInput = MittwaldAPIV2.Components.Schemas.AppSavedUserInput;
+type AppAppUpdatePolicy = MittwaldAPIV2.Components.Schemas.AppAppUpdatePolicy;
+
+/**
+ * This is a carefully selected subset of the "patchAppinstallation" request
+ * body; the type needs to be inlined, because it's not exported from the API
+ * client.
+ */
+type UpdateBody = {
+  customDocumentRoot?: string;
+  description?: string;
+  updatePolicy?: AppAppUpdatePolicy;
+  userInputs?: AppSavedUserInput[];
+};
+
+export class Update extends ExecRenderBaseCommand<typeof Update, void> {
+  static summary =
+    "Update properties of an app installation (use 'upgrade' to update the app version)";
+  static args = { ...appInstallationArgs };
+  static flags = {
+    ...processFlags,
+    description: Flags.string({
+      summary: "update the description of the app installation",
+      description:
+        "This flag updates the description of the app installation. If omitted, the description will not be changed.",
+      default: undefined,
+      required: false,
+    }),
+    entrypoint: Flags.string({
+      summary:
+        "update the entrypoint of the app installation (Python and Node.js only)",
+      description:
+        "Updates the entrypoint of the app installation. If omitted, the entrypoint will not be changed. Note that this field is only available for some types of apps (like Python and Node.js).",
+      required: false,
+      default: undefined,
+    }),
+    "document-root": Flags.string({
+      summary: "update the document root of the app installation",
+      description:
+        "Updates the document root of the app installation. If omitted, the document root will not be changed. Note that not all apps support this field.",
+      required: false,
+      default: undefined,
+    }),
+  };
+
+  protected async exec(): Promise<void> {
+    const p = makeProcessRenderer(this.flags, "Updating app installation");
+    const appInstallationId = await withAppInstallationId(
+      this.apiClient,
+      Update,
+      this.flags,
+      this.args,
+      this.config,
+    );
+
+    const [updateBody, info] = buildUpdateBodyFromFlags(this.flags);
+
+    info.forEach((i) => p.addInfo(i));
+
+    if (Object.keys(updateBody).length === 0) {
+      p.addInfo("skipping update");
+      await p.complete(<Success>No changes to apply</Success>);
+      return;
+    }
+
+    this.debug("updating app installation: %O", updateBody);
+
+    await p.runStep("updating app", async () => {
+      await this.apiClient.app.patchAppinstallation({
+        appInstallationId,
+        data: updateBody,
+      });
+    });
+
+    await p.complete(<Success>App installation successfully updated</Success>);
+  }
+
+  protected render(): React.ReactNode {
+    return undefined;
+  }
+}
+
+function buildUpdateBodyFromFlags(
+  flags: CommandFlags<typeof Update>,
+): [UpdateBody, ReactNode[]] {
+  const updateBody: UpdateBody = {};
+  const info: ReactNode[] = [];
+
+  if (flags.entrypoint) {
+    info.push(<UpdateFieldInfo name="entrypoint" value={flags.entrypoint} />);
+    updateBody.userInputs = [
+      ...(updateBody.userInputs || []),
+      {
+        name: "entrypoint",
+        value: flags.entrypoint,
+      },
+    ];
+  }
+
+  if (flags["document-root"]) {
+    info.push(
+      <UpdateFieldInfo name="document root" value={flags["document-root"]} />,
+    );
+    updateBody.customDocumentRoot = flags["document-root"];
+  }
+
+  if (flags.description !== undefined) {
+    info.push(<UpdateFieldInfo name="description" value={flags.description} />);
+    updateBody.description = flags.description;
+  }
+
+  return [updateBody, info];
+}
+
+function UpdateFieldInfo({ name, value }: { name: string; value: string }) {
+  return (
+    <>
+      setting {name} to <Value>{value}</Value>
+    </>
+  );
+}
diff --git a/src/commands/app/upgrade.tsx b/src/commands/app/upgrade.tsx
index 837630599..f3783ece4 100644
--- a/src/commands/app/upgrade.tsx
+++ b/src/commands/app/upgrade.tsx
@@ -3,7 +3,6 @@ import {
   appInstallationArgs,
   withAppInstallationId,
 } from "../../lib/resources/app/flags.js";
-import { projectFlags } from "../../lib/resources/project/flags.js";
 import { Flags, ux } from "@oclif/core";
 import React, { ReactNode } from "react";
 import { Text } from "ink";
@@ -19,7 +18,6 @@ import {
 } from "../../lib/resources/app/versions.js";
 import {
   makeProcessRenderer,
-  ProcessFlags,
   processFlags,
 } from "../../rendering/process/process_flags.js";
 import { Success } from "../../rendering/react/components/Success.js";
@@ -47,16 +45,12 @@ export class UpgradeApp extends ExecRenderBaseCommand<typeof UpgradeApp, void> {
       char: "f",
       description: "Do not ask for confirmation.",
     }),
-    ...projectFlags,
     ...processFlags,
     ...waitFlags,
   };
 
   protected async exec(): Promise<void> {
-    const process = makeProcessRenderer(
-      this.flags as ProcessFlags,
-      "App upgrade",
-    );
+    const process = makeProcessRenderer(this.flags, "App upgrade");
     const appInstallationId: string = await withAppInstallationId(
         this.apiClient,
         UpgradeApp,
diff --git a/src/rendering/process/process.tsx b/src/rendering/process/process.tsx
index fce29bfcd..591a4425c 100644
--- a/src/rendering/process/process.tsx
+++ b/src/rendering/process/process.tsx
@@ -110,7 +110,7 @@ export interface ProcessRenderer {
   start(): void;
   addStep(title: ReactNode): RunnableHandler;
   runStep<TRes>(title: ReactNode, fn: () => Promise<TRes>): Promise<TRes>;
-  addInfo(title: ReactElement): void;
+  addInfo(title: ReactNode): void;
   addConfirmation(question: ReactElement): Promise<boolean>;
   addInput(question: ReactNode, mask?: boolean): Promise<string>;
   addSelect<TVal>(
diff --git a/src/rendering/process/process_fancy.tsx b/src/rendering/process/process_fancy.tsx
index 4715f201d..fb0ea84c8 100644
--- a/src/rendering/process/process_fancy.tsx
+++ b/src/rendering/process/process_fancy.tsx
@@ -68,7 +68,7 @@ export class FancyProcessRenderer implements ProcessRenderer {
     }
   }
 
-  public addInfo(title: ReactElement) {
+  public addInfo(title: ReactNode) {
     this.start();
 
     if (this.currentHandler !== null) {

From 7991b3a35ba07915e576862dd7ebf72eda677f83 Mon Sep 17 00:00:00 2001
From: Martin Helmich <m.helmich@mittwald.de>
Date: Wed, 29 May 2024 16:44:44 +0200
Subject: [PATCH 02/11] Update README

---
 README.md | 50 +++++++++++++++++++++++++++++++++++++++++---------
 1 file changed, 41 insertions(+), 9 deletions(-)

diff --git a/README.md b/README.md
index 76aa41ee3..919d05073 100644
--- a/README.md
+++ b/README.md
@@ -139,6 +139,7 @@ USAGE
 * [`mw app list-upgrade-candidates [INSTALLATION-ID]`](#mw-app-list-upgrade-candidates-installation-id)
 * [`mw app ssh [INSTALLATION-ID]`](#mw-app-ssh-installation-id)
 * [`mw app uninstall [INSTALLATION-ID]`](#mw-app-uninstall-installation-id)
+* [`mw app update [INSTALLATION-ID]`](#mw-app-update-installation-id)
 * [`mw app upgrade [INSTALLATION-ID]`](#mw-app-upgrade-installation-id)
 * [`mw app upload [INSTALLATION-ID]`](#mw-app-upload-installation-id)
 * [`mw app versions [APP]`](#mw-app-versions-app)
@@ -1896,14 +1897,52 @@ FLAG DESCRIPTIONS
     scripts), you can use this flag to easily get the IDs of created resources for further processing.
 ```
 
+## `mw app update [INSTALLATION-ID]`
+
+Update properties of an app installation (use 'upgrade' to update the app version)
+
+```
+USAGE
+  $ mw app update [INSTALLATION-ID] [-q] [--description <value>] [--entrypoint <value>] [--document-root <value>]
+
+ARGUMENTS
+  INSTALLATION-ID  ID or short ID of an app installation; this argument is optional if a default app installation is set
+                   in the context.
+
+FLAGS
+  -q, --quiet                  suppress process output and only display a machine-readable summary.
+      --description=<value>    update the description of the app installation
+      --document-root=<value>  update the document root of the app installation
+      --entrypoint=<value>     update the entrypoint of the app installation (Python and Node.js only)
+
+FLAG DESCRIPTIONS
+  -q, --quiet  suppress process output and only display a machine-readable summary.
+
+    This flag controls if you want to see the process output or only a summary. When using mw non-interactively (e.g. in
+    scripts), you can use this flag to easily get the IDs of created resources for further processing.
+
+  --description=<value>  update the description of the app installation
+
+    This flag updates the description of the app installation. If omitted, the description will not be changed.
+
+  --document-root=<value>  update the document root of the app installation
+
+    Updates the document root of the app installation. If omitted, the document root will not be changed. Note that not
+    all apps support this field.
+
+  --entrypoint=<value>  update the entrypoint of the app installation (Python and Node.js only)
+
+    Updates the entrypoint of the app installation. If omitted, the entrypoint will not be changed. Note that this field
+    is only available for some types of apps (like Python and Node.js).
+```
+
 ## `mw app upgrade [INSTALLATION-ID]`
 
 Upgrade app installation to target version
 
 ```
 USAGE
-  $ mw app upgrade [INSTALLATION-ID] [--target-version <value>] [-f] [-p <value>] [-q] [-w] [--wait-timeout
-    <value>]
+  $ mw app upgrade [INSTALLATION-ID] [--target-version <value>] [-f] [-q] [-w] [--wait-timeout <value>]
 
 ARGUMENTS
   INSTALLATION-ID  ID or short ID of an app installation; this argument is optional if a default app installation is set
@@ -1911,8 +1950,6 @@ ARGUMENTS
 
 FLAGS
   -f, --force                   Do not ask for confirmation.
-  -p, --project-id=<value>      ID or short ID of a project; this flag is optional if a default project is set in the
-                                context
   -q, --quiet                   suppress process output and only display a machine-readable summary.
   -w, --wait                    wait for the resource to be ready.
       --target-version=<value>  target version to upgrade app to; if omitted, target version will be prompted
@@ -1924,11 +1961,6 @@ DESCRIPTION
   Upgrade app installation to target version
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
-
-    May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
-    to persistently set a default project for all commands that accept this flag.
-
   -q, --quiet  suppress process output and only display a machine-readable summary.
 
     This flag controls if you want to see the process output or only a summary. When using mw non-interactively (e.g. in

From 67af55244b085a16890328b4aa3954f9a6d97fd9 Mon Sep 17 00:00:00 2001
From: Michel Hopfner <m.hopfner@mittwald.de>
Date: Tue, 20 Aug 2024 10:29:36 +0200
Subject: [PATCH 03/11]  implement reactive dependency upgrade for app upgrades

---
 README.md                    | 540 +++++++++++++++++++++++++----------
 src/commands/app/upgrade.tsx | 162 +++++++++--
 2 files changed, 526 insertions(+), 176 deletions(-)

diff --git a/README.md b/README.md
index b99f3fbbe..2ce37f813 100644
--- a/README.md
+++ b/README.md
@@ -149,7 +149,10 @@ USAGE
 * [`mw backup download BACKUP-ID`](#mw-backup-download-backup-id)
 * [`mw backup get BACKUP-ID`](#mw-backup-get-backup-id)
 * [`mw backup list`](#mw-backup-list)
+* [`mw backup schedule create`](#mw-backup-schedule-create)
+* [`mw backup schedule delete [BACKUP-SCHEDULE-ID]`](#mw-backup-schedule-delete-backup-schedule-id)
 * [`mw backup schedule list`](#mw-backup-schedule-list)
+* [`mw backup schedule update [BACKUP-SCHEDULE-ID]`](#mw-backup-schedule-update-backup-schedule-id)
 * [`mw context get`](#mw-context-get)
 * [`mw context reset`](#mw-context-reset)
 * [`mw context set`](#mw-context-set)
@@ -169,6 +172,7 @@ USAGE
 * [`mw cronjob execution logs CRONJOB-ID EXECUTION-ID`](#mw-cronjob-execution-logs-cronjob-id-execution-id)
 * [`mw cronjob get CRONJOB-ID`](#mw-cronjob-get-cronjob-id)
 * [`mw cronjob list`](#mw-cronjob-list)
+* [`mw cronjob update CRONJOB-ID`](#mw-cronjob-update-cronjob-id)
 * [`mw database mysql charsets`](#mw-database-mysql-charsets)
 * [`mw database mysql create`](#mw-database-mysql-create)
 * [`mw database mysql delete DATABASE-ID`](#mw-database-mysql-delete-database-id)
@@ -179,9 +183,11 @@ USAGE
 * [`mw database mysql phpmyadmin DATABASE-ID`](#mw-database-mysql-phpmyadmin-database-id)
 * [`mw database mysql port-forward DATABASE-ID`](#mw-database-mysql-port-forward-database-id)
 * [`mw database mysql shell DATABASE-ID`](#mw-database-mysql-shell-database-id)
+* [`mw database mysql user create [DATABASE-ID]`](#mw-database-mysql-user-create-database-id)
 * [`mw database mysql user delete USER-ID`](#mw-database-mysql-user-delete-user-id)
 * [`mw database mysql user get ID`](#mw-database-mysql-user-get-id)
 * [`mw database mysql user list`](#mw-database-mysql-user-list)
+* [`mw database mysql user update [DATABASE-ID]`](#mw-database-mysql-user-update-database-id)
 * [`mw database mysql versions`](#mw-database-mysql-versions)
 * [`mw database redis create`](#mw-database-redis-create)
 * [`mw database redis get ID`](#mw-database-redis-get-id)
@@ -248,10 +254,14 @@ USAGE
 * [`mw project update [PROJECT-ID]`](#mw-project-update-project-id)
 * [`mw server get [SERVER-ID]`](#mw-server-get-server-id)
 * [`mw server list`](#mw-server-list)
+* [`mw sftp-user create`](#mw-sftp-user-create)
 * [`mw sftp-user delete SFTP-USER-ID`](#mw-sftp-user-delete-sftp-user-id)
 * [`mw sftp-user list`](#mw-sftp-user-list)
+* [`mw sftp-user update SFTP-USER-ID`](#mw-sftp-user-update-sftp-user-id)
+* [`mw ssh-user create`](#mw-ssh-user-create)
 * [`mw ssh-user delete SSH-USER-ID`](#mw-ssh-user-delete-ssh-user-id)
 * [`mw ssh-user list`](#mw-ssh-user-list)
+* [`mw ssh-user update SSH-USER-ID`](#mw-ssh-user-update-ssh-user-id)
 * [`mw update [CHANNEL]`](#mw-update-channel)
 * [`mw user api-token create`](#mw-user-api-token-create)
 * [`mw user api-token get TOKEN-ID`](#mw-user-api-token-get-token-id)
@@ -315,9 +325,7 @@ DESCRIPTION
   Creates new custom Node.js installation.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -363,9 +371,7 @@ DESCRIPTION
   Creates new custom PHP installation.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -412,9 +418,7 @@ DESCRIPTION
   Creates new custom python site installation.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -460,9 +464,7 @@ DESCRIPTION
   Creates new custom static site installation.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -516,8 +518,7 @@ Update the dependencies of an app
 
 ```
 USAGE
-  $ mw app dependency update [INSTALLATION-ID] --set <value>... [-q] [--update-policy
-  none|inheritedFromApp|patchLevel|all]
+  $ mw app dependency update [INSTALLATION-ID] --set <value> [-q] [--update-policy none|inheritedFromApp|patchLevel|all]
 
 ARGUMENTS
   INSTALLATION-ID  ID or short ID of an app installation; this argument is optional if a default app installation is set
@@ -581,7 +582,7 @@ Download the filesystem of an app within a project to your local machine
 ```
 USAGE
   $ mw app download [INSTALLATION-ID] --target <value> [-q] [--ssh-user <value>] [--ssh-identity-file <value>]
-    [--exclude <value>...] [--dry-run] [--delete]
+    [--exclude <value>] [--dry-run] [--delete]
 
 ARGUMENTS
   INSTALLATION-ID  ID or short ID of an app installation; this argument is optional if a default app installation is set
@@ -689,9 +690,7 @@ DESCRIPTION
   Creates new Contao installation.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -778,9 +777,7 @@ DESCRIPTION
   Creates new Drupal installation.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -857,9 +854,7 @@ DESCRIPTION
   Creates new Grav installation.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -943,9 +938,7 @@ DESCRIPTION
   Creates new Joomla! installation.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -1032,9 +1025,7 @@ DESCRIPTION
   Creates new Matomo installation.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -1109,9 +1100,7 @@ DESCRIPTION
   Creates new Moodle installation.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -1186,9 +1175,7 @@ DESCRIPTION
   Creates new NEOS installation.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -1263,9 +1250,7 @@ DESCRIPTION
   Creates new Nextcloud installation.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -1344,9 +1329,7 @@ DESCRIPTION
   Creates new PrestaShop installation.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -1441,9 +1424,7 @@ DESCRIPTION
   Creates new Shopware 5 installation.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -1555,9 +1536,7 @@ DESCRIPTION
   Creates new Shopware 6 installation.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -1665,9 +1644,7 @@ DESCRIPTION
   Creates new TYPO3 installation.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -1749,9 +1726,7 @@ DESCRIPTION
   Creates new WordPress installation.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -1824,9 +1799,7 @@ DESCRIPTION
   List installed apps in a project.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -1979,7 +1952,8 @@ Upgrade app installation to target version
 
 ```
 USAGE
-  $ mw app upgrade [INSTALLATION-ID] [--target-version <value>] [-f] [-q] [-w] [--wait-timeout <value>]
+  $ mw app upgrade [INSTALLATION-ID] [--target-version <value>] [-f] [-p <value>] [-q] [-w] [--wait-timeout
+    <value>]
 
 ARGUMENTS
   INSTALLATION-ID  ID or short ID of an app installation; this argument is optional if a default app installation is set
@@ -1987,6 +1961,8 @@ ARGUMENTS
 
 FLAGS
   -f, --force                   Do not ask for confirmation.
+  -p, --project-id=<value>      ID or short ID of a project; this flag is optional if a default project is set in the
+                                context
   -q, --quiet                   suppress process output and only display a machine-readable summary.
   -w, --wait                    wait for the resource to be ready.
       --target-version=<value>  target version to upgrade app to; if omitted, target version will be prompted
@@ -1998,6 +1974,11 @@ DESCRIPTION
   Upgrade app installation to target version
 
 FLAG DESCRIPTIONS
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+
+    May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
+    to persistently set a default project for all commands that accept this flag.
+
   -q, --quiet  suppress process output and only display a machine-readable summary.
 
     This flag controls if you want to see the process output or only a summary. When using mw non-interactively (e.g. in
@@ -2011,7 +1992,7 @@ Upload the filesystem of an app to a project
 ```
 USAGE
   $ mw app upload [INSTALLATION-ID] --source <value> [-q] [--ssh-user <value>] [--ssh-identity-file <value>]
-    [--exclude <value>...] [--dry-run] [--delete]
+    [--exclude <value>] [--dry-run] [--delete]
 
 ARGUMENTS
   INSTALLATION-ID  ID or short ID of an app installation; this argument is optional if a default app installation is set
@@ -2115,7 +2096,7 @@ EXAMPLES
   $ mw autocomplete --refresh-cache
 ```
 
-_See code: [@oclif/plugin-autocomplete](https://github.com/oclif/plugin-autocomplete/blob/v3.1.5/src/commands/autocomplete/index.ts)_
+_See code: [@oclif/plugin-autocomplete](https://github.com/oclif/plugin-autocomplete/blob/v3.1.7/src/commands/autocomplete/index.ts)_
 
 ## `mw backup create`
 
@@ -2139,9 +2120,7 @@ ALIASES
   $ mw project backup create
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -2278,12 +2257,65 @@ ALIASES
   $ mw project backup list
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+
+    May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
+    to persistently set a default project for all commands that accept this flag.
+```
+
+## `mw backup schedule create`
 
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+Create a new backup schedule
+
+```
+USAGE
+  $ mw backup schedule create --schedule <value> --ttl <value> [-p <value>] [-q] [--description <value>]
+
+FLAGS
+  -p, --project-id=<value>   ID or short ID of a project; this flag is optional if a default project is set in the
+                             context
+  -q, --quiet                suppress process output and only display a machine-readable summary.
+      --description=<value>  Set the description for the backup schedule
+      --schedule=<value>     (required) Define the schedule itself
+      --ttl=<value>          (required) Define the backup storage period in days, for through this schedule created
+                             backups
+
+FLAG DESCRIPTIONS
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
+
+  -q, --quiet  suppress process output and only display a machine-readable summary.
+
+    This flag controls if you want to see the process output or only a summary. When using mw non-interactively (e.g. in
+    scripts), you can use this flag to easily get the IDs of created resources for further processing.
+```
+
+## `mw backup schedule delete [BACKUP-SCHEDULE-ID]`
+
+Delete a backup schedule
+
+```
+USAGE
+  $ mw backup schedule delete [BACKUP-SCHEDULE-ID] [-q] [-f] [--backup-schedule-id <value>]
+
+ARGUMENTS
+  BACKUP-SCHEDULE-ID  ID of schedule to delete
+
+FLAGS
+  -f, --force                       Do not ask for confirmation
+  -q, --quiet                       suppress process output and only display a machine-readable summary.
+      --backup-schedule-id=<value>  ID of backup schedule to delete
+
+DESCRIPTION
+  Delete a backup schedule
+
+FLAG DESCRIPTIONS
+  -q, --quiet  suppress process output and only display a machine-readable summary.
+
+    This flag controls if you want to see the process output or only a summary. When using mw non-interactively (e.g. in
+    scripts), you can use this flag to easily get the IDs of created resources for further processing.
 ```
 
 ## `mw backup schedule list`
@@ -2314,14 +2346,41 @@ ALIASES
   $ mw project backupschedule list
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
 ```
 
+## `mw backup schedule update [BACKUP-SCHEDULE-ID]`
+
+Update an existing backup schedule
+
+```
+USAGE
+  $ mw backup schedule update [BACKUP-SCHEDULE-ID] [-q] [--backup-schedule-id <value>] [--description <value>] [--schedule
+    <value>] [--ttl <value>]
+
+ARGUMENTS
+  BACKUP-SCHEDULE-ID  Define the backup schedule that is to be updated
+
+FLAGS
+  -q, --quiet                       suppress process output and only display a machine-readable summary.
+      --backup-schedule-id=<value>  Define the backup schedule that is to be updated
+      --description=<value>         Set the description for the backup schedule
+      --schedule=<value>            Define the schedule itself
+      --ttl=<value>                 Define the backup storage period in days, for through this schedule created backups
+
+DESCRIPTION
+  Update an existing backup schedule
+
+FLAG DESCRIPTIONS
+  -q, --quiet  suppress process output and only display a machine-readable summary.
+
+    This flag controls if you want to see the process output or only a summary. When using mw non-interactively (e.g. in
+    scripts), you can use this flag to easily get the IDs of created resources for further processing.
+```
+
 ## `mw context get`
 
 Print an overview of currently set context parameters
@@ -2744,14 +2803,47 @@ ALIASES
   $ mw project cronjob list
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
 ```
 
+## `mw cronjob update CRONJOB-ID`
+
+Update an existing cron job
+
+```
+USAGE
+  $ mw cronjob update CRONJOB-ID [--description <value>] [--interval <value>] [--disable | --enable] [--email
+    <value>] [--timeout <value>] [--url <value>] [--command <value>] [--interpreter bash|php] [-q]
+
+ARGUMENTS
+  CRONJOB-ID  ID of the cron job to be updated.
+
+FLAGS
+  -q, --quiet                 suppress process output and only display a machine-readable summary.
+      --command=<value>       Set file and parameters to execute on cron job execution
+      --description=<value>   Set cron job description
+      --disable               Disable cron job automated execution
+      --email=<value>         Set target email to send error messages to
+      --enable                Enable cron job automated execution
+      --interpreter=<option>  Set interpreter to use for execution
+                              <options: bash|php>
+      --interval=<value>      Set cron job execution interval
+      --timeout=<value>       Set timeout in seconds after wich the process is killed
+      --url=<value>           Set url to use on cron job execution
+
+DESCRIPTION
+  Update an existing cron job
+
+FLAG DESCRIPTIONS
+  -q, --quiet  suppress process output and only display a machine-readable summary.
+
+    This flag controls if you want to see the process output or only a summary. When using mw non-interactively (e.g. in
+    scripts), you can use this flag to easily get the IDs of created resources for further processing.
+```
+
 ## `mw database mysql charsets`
 
 List available MySQL character sets and collations, optionally filtered by a MySQLVersion.
@@ -2798,9 +2890,7 @@ FLAGS
       --version=<value>             (required) the MySQL version to use
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -3051,9 +3141,7 @@ DESCRIPTION
   List MySQLDatabases belonging to a Project.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -3186,6 +3274,38 @@ FLAG DESCRIPTIONS
     You can also set this value by setting the MITTWALD_SSH_USER environment variable.
 ```
 
+## `mw database mysql user create [DATABASE-ID]`
+
+Create a new mysql user
+
+```
+USAGE
+  $ mw database mysql user create [DATABASE-ID] --database-id <value> --access-level readonly|full --description <value>
+    --password <value> [-q] [--access-ip-mask <value>] [--external-access]
+
+ARGUMENTS
+  DATABASE-ID  ID of the MySQL Database to create a user for
+
+FLAGS
+  -q, --quiet                   suppress process output and only display a machine-readable summary.
+      --access-ip-mask=<value>  IP from wich external access will be exclusively allowed
+      --access-level=<option>   (required) Access level for this mysql user
+                                <options: readonly|full>
+      --database-id=<value>     (required) ID of the MySQL Database to create a user for
+      --description=<value>     (required) Description of the mysql user
+      --external-access         Enable/Disable external access for this user.
+      --password=<value>        (required) Password used for authentication
+
+DESCRIPTION
+  Create a new mysql user
+
+FLAG DESCRIPTIONS
+  -q, --quiet  suppress process output and only display a machine-readable summary.
+
+    This flag controls if you want to see the process output or only a summary. When using mw non-interactively (e.g. in
+    scripts), you can use this flag to easily get the IDs of created resources for further processing.
+```
+
 ## `mw database mysql user delete USER-ID`
 
 Delete a MySQL user
@@ -3254,6 +3374,38 @@ DESCRIPTION
   List MySQL users belonging to a database.
 ```
 
+## `mw database mysql user update [DATABASE-ID]`
+
+Create a new mysql user
+
+```
+USAGE
+  $ mw database mysql user update [DATABASE-ID] [-q] [--database-id <value>] [--access-level readonly|full] [--description
+    <value>] [--password <value>] [--access-ip-mask <value>] [--external-access]
+
+ARGUMENTS
+  DATABASE-ID  MySQL User ID of the user to be updated
+
+FLAGS
+  -q, --quiet                   suppress process output and only display a machine-readable summary.
+      --access-ip-mask=<value>  IP from wich external access will be exclusively allowed
+      --access-level=<option>   Access level for this mysql user
+                                <options: readonly|full>
+      --database-id=<value>     MySQL User ID of the user to be updated
+      --description=<value>     Description of the mysql user
+      --external-access         Enable/Disable external access for this user.
+      --password=<value>        Password used for authentication
+
+DESCRIPTION
+  Create a new mysql user
+
+FLAG DESCRIPTIONS
+  -q, --quiet  suppress process output and only display a machine-readable summary.
+
+    This flag controls if you want to see the process output or only a summary. When using mw non-interactively (e.g. in
+    scripts), you can use this flag to easily get the IDs of created resources for further processing.
+```
+
 ## `mw database mysql versions`
 
 List available MySQL versions.
@@ -3300,9 +3452,7 @@ FLAGS
       --version=<value>             (required) the Redis version to use
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -3372,9 +3522,7 @@ DESCRIPTION
   List Redis databases belonging to a project.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -3457,9 +3605,7 @@ DESCRIPTION
   List available Redis versions.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -3640,9 +3786,7 @@ DESCRIPTION
   list all DNS zones by project ID
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -3654,7 +3798,7 @@ Updates a record set of a DNS zone
 
 ```
 USAGE
-  $ mw domain dnszone update DNSZONE-ID RECORD-SET [-q] [-p <value>] [--record <value>... | --managed | --unset] [--ttl
+  $ mw domain dnszone update DNSZONE-ID RECORD-SET [-q] [-p <value>] [--record <value> | --managed | --unset] [--ttl
     <value>]
 
 ARGUMENTS
@@ -3684,9 +3828,7 @@ EXAMPLES
       mail2.domain.example"
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -3752,9 +3894,7 @@ DESCRIPTION
   List domains belonging to a project.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -3766,8 +3906,8 @@ Create a new ingress
 
 ```
 USAGE
-  $ mw domain virtualhost create --hostname <value> [-q] [-p <value>] [--path-to-dir <value>...] [--path-to-app <value>...]
-    [--path-to-url <value>...]
+  $ mw domain virtualhost create --hostname <value> [-q] [-p <value>] [--path-to-dir <value>] [--path-to-app <value>]
+    [--path-to-url <value>]
 
 FLAGS
   -p, --project-id=<value>      ID or short ID of a project; this flag is optional if a default project is set in the
@@ -3795,9 +3935,7 @@ EXAMPLES
     $ mw domain virtualhost create --hostname mw.example --path-to-url /:https://redirect.example
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -3894,9 +4032,7 @@ DESCRIPTION
   List virtualhosts for a project.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -3920,7 +4056,7 @@ DESCRIPTION
   Display help for mw.
 ```
 
-_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v6.2.4/src/commands/help.ts)_
+_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v6.2.6/src/commands/help.ts)_
 
 ## `mw login reset`
 
@@ -3968,7 +4104,7 @@ Create a new mail address
 ```
 USAGE
   $ mw mail address create -a <value> [-p <value>] [-q] [--catch-all] [--enable-spam-protection] [--quota <value>]
-    [--password <value>] [--random-password] [--forward-to <value>...]
+    [--password <value>] [--random-password] [--forward-to <value>]
 
 FLAGS
   -a, --address=<value>              (required) mail address
@@ -4014,9 +4150,7 @@ EXAMPLES
     $ mw mail address create --address foo@bar.example --forward-to bar@bar.example --forward-to baz@bar.example
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -4115,9 +4249,7 @@ DESCRIPTION
   Get all mail addresses for a project ID
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -4130,7 +4262,7 @@ Update a mail address
 ```
 USAGE
   $ mw mail address update MAILADDRESS-ID [-q] [-a <value>] [--catch-all] [--quota <value>] [--password <value>]
-    [--random-password] [--forward-to <value>...]
+    [--random-password] [--forward-to <value>]
 
 ARGUMENTS
   MAILADDRESS-ID  ID or mail address of a mailaddress
@@ -4241,9 +4373,7 @@ DESCRIPTION
   Get all deliveryboxes by project ID
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -4525,9 +4655,7 @@ ALIASES
   $ mw project backup create
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -4664,9 +4792,7 @@ ALIASES
   $ mw project backup list
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -4700,9 +4826,7 @@ ALIASES
   $ mw project backupschedule list
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -4735,9 +4859,7 @@ FLAG DESCRIPTIONS
     This flag controls if you want to see the process output or only a summary. When using mw non-interactively (e.g. in
     scripts), you can use this flag to easily get the IDs of created resources for further processing.
 
-  -s, --server-id=<value>
-
-    ID or short ID of a server; this flag is optional if a default server is set in the context
+  -s, --server-id=<value>  ID or short ID of a server; this flag is optional if a default server is set in the context
 
     May contain a short ID or a full ID of a server; you can also use the "mw context set --server-id=<VALUE>" command
     to persistently set a default server for all commands that accept this flag.
@@ -4849,9 +4971,7 @@ ALIASES
   $ mw project cronjob list
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -4965,9 +5085,7 @@ DESCRIPTION
   List all invites belonging to a project.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -5056,9 +5174,7 @@ DESCRIPTION
   Get the executing user's membership in a Project.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -5089,9 +5205,7 @@ DESCRIPTION
   List all memberships for a Project.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -5148,9 +5262,7 @@ ALIASES
   $ mw project sftp-user list
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -5227,9 +5339,7 @@ ALIASES
   $ mw project ssh-user list
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -5292,6 +5402,39 @@ DESCRIPTION
   List servers for an organization or user.
 ```
 
+## `mw sftp-user create`
+
+Create a new sftp user
+
+```
+USAGE
+  $ mw sftp-user create --description <value> --directories <value> [-p <value>] [-q] [--public-key <value>]
+    [--password <value>] [--expires <value>] [--access-level read|full]
+
+FLAGS
+  -p, --project-id=<value>      ID or short ID of a project; this flag is optional if a default project is set in the
+                                context
+  -q, --quiet                   suppress process output and only display a machine-readable summary.
+      --access-level=<option>   Set access level privileges for the sftp user
+                                <options: read|full>
+      --description=<value>     (required) Description of sftp user
+      --directories=<value>...  (required) Set directories to restrict the sftp users access to
+      --expires=<value>         Date at wich the sftp user get disabled automatically
+      --password=<value>        Password used for authentication
+      --public-key=<value>      Public Key used for authentication
+
+FLAG DESCRIPTIONS
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+
+    May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
+    to persistently set a default project for all commands that accept this flag.
+
+  -q, --quiet  suppress process output and only display a machine-readable summary.
+
+    This flag controls if you want to see the process output or only a summary. When using mw non-interactively (e.g. in
+    scripts), you can use this flag to easily get the IDs of created resources for further processing.
+```
+
 ## `mw sftp-user delete SFTP-USER-ID`
 
 Delete an SFTP user
@@ -5345,12 +5488,74 @@ ALIASES
   $ mw project sftp-user list
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+
+    May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
+    to persistently set a default project for all commands that accept this flag.
+```
+
+## `mw sftp-user update SFTP-USER-ID`
+
+Update an existing sftp user
+
+```
+USAGE
+  $ mw sftp-user update SFTP-USER-ID [-q] [--description <value>] [--public-key <value> | --password <value>]
+    [--expires <value>] [--access-level read|full] [--directories <value>] [--disable | --enable]
+
+ARGUMENTS
+  SFTP-USER-ID  The ID of the sftp user to update
+
+FLAGS
+  -q, --quiet                   suppress process output and only display a machine-readable summary.
+      --access-level=<option>   Set access level privileges for the sftp user
+                                <options: read|full>
+      --description=<value>     Set the sftp users description
+      --directories=<value>...  Set directories to restrict the sftp users access to
+      --disable                 Disable sftp user
+      --enable                  Enable sftp user
+      --expires=<value>         Date at wich the sftp user will be disabled automatically
+      --password=<value>        Password used for authentication
+      --public-key=<value>      Public Key used for authentication
+
+DESCRIPTION
+  Update an existing sftp user
+
+FLAG DESCRIPTIONS
+  -q, --quiet  suppress process output and only display a machine-readable summary.
+
+    This flag controls if you want to see the process output or only a summary. When using mw non-interactively (e.g. in
+    scripts), you can use this flag to easily get the IDs of created resources for further processing.
+```
+
+## `mw ssh-user create`
+
+Create a new ssh user
+
+```
+USAGE
+  $ mw ssh-user create --description <value> [-p <value>] [-q] [--expires <value>] [--public-key <value>] [--password
+    <value>]
+
+FLAGS
+  -p, --project-id=<value>   ID or short ID of a project; this flag is optional if a default project is set in the
+                             context
+  -q, --quiet                suppress process output and only display a machine-readable summary.
+      --description=<value>  (required) Description of ssh user
+      --expires=<value>      Date at wich the ssh user get disabled automatically
+      --password=<value>     Password used for authentication
+      --public-key=<value>   Public Key used for authentication
 
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+FLAG DESCRIPTIONS
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
+
+  -q, --quiet  suppress process output and only display a machine-readable summary.
+
+    This flag controls if you want to see the process output or only a summary. When using mw non-interactively (e.g. in
+    scripts), you can use this flag to easily get the IDs of created resources for further processing.
 ```
 
 ## `mw ssh-user delete SSH-USER-ID`
@@ -5406,14 +5611,43 @@ ALIASES
   $ mw project ssh-user list
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>
-
-    ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
 ```
 
+## `mw ssh-user update SSH-USER-ID`
+
+Update an existing cron job
+
+```
+USAGE
+  $ mw ssh-user update SSH-USER-ID [-q] [--description <value>] [--public-key <value>] [--password <value>]
+    [--expires <value>] [--disable | --enable]
+
+ARGUMENTS
+  SSH-USER-ID  The ID of the SSH user to update
+
+FLAGS
+  -q, --quiet                suppress process output and only display a machine-readable summary.
+      --description=<value>  Set cron job description
+      --disable              Disable ssh user
+      --enable               Enable ssh user
+      --expires=<value>      Date at wich the User get disabled automatically
+      --password=<value>     Password used for authentication
+      --public-key=<value>   Public Key used for authentication
+
+DESCRIPTION
+  Update an existing cron job
+
+FLAG DESCRIPTIONS
+  -q, --quiet  suppress process output and only display a machine-readable summary.
+
+    This flag controls if you want to see the process output or only a summary. When using mw non-interactively (e.g. in
+    scripts), you can use this flag to easily get the IDs of created resources for further processing.
+```
+
 ## `mw update [CHANNEL]`
 
 update the mw CLI
@@ -5449,7 +5683,7 @@ EXAMPLES
     $ mw update --available
 ```
 
-_See code: [@oclif/plugin-update](https://github.com/oclif/plugin-update/blob/v4.4.6/src/commands/update.ts)_
+_See code: [@oclif/plugin-update](https://github.com/oclif/plugin-update/blob/v4.4.9/src/commands/update.ts)_
 
 ## `mw user api-token create`
 
@@ -5457,7 +5691,7 @@ Create a new API token
 
 ```
 USAGE
-  $ mw user api-token create --description <value> --roles api_read|api_write... [-q] [--expires <value>]
+  $ mw user api-token create --description <value> --roles api_read|api_write [-q] [--expires <value>]
 
 FLAGS
   -q, --quiet                suppress process output and only display a machine-readable summary.
diff --git a/src/commands/app/upgrade.tsx b/src/commands/app/upgrade.tsx
index f3783ece4..14fd79c96 100644
--- a/src/commands/app/upgrade.tsx
+++ b/src/commands/app/upgrade.tsx
@@ -3,6 +3,7 @@ import {
   appInstallationArgs,
   withAppInstallationId,
 } from "../../lib/resources/app/flags.js";
+import { projectFlags } from "../../lib/resources/project/flags.js";
 import { Flags, ux } from "@oclif/core";
 import React, { ReactNode } from "react";
 import { Text } from "ink";
@@ -26,10 +27,17 @@ import { MittwaldAPIV2, MittwaldAPIV2Client } from "@mittwald/api-client";
 import { waitUntilAppStateHasNormalized } from "../../lib/resources/app/wait.js";
 import { assertStatus } from "@mittwald/api-client-commons";
 import { waitFlags } from "../../lib/wait.js";
+import assertSuccess from "../../lib/apiutil/assert_success.js";
+import { ProcessFlags } from "../../rendering/process/process_flags.js";
+import semver from "semver/preload.js";
 
 type AppApp = MittwaldAPIV2.Components.Schemas.AppApp;
 type AppAppInstallation = MittwaldAPIV2.Components.Schemas.AppAppInstallation;
 type AppAppVersion = MittwaldAPIV2.Components.Schemas.AppAppVersion;
+type AppSystemSoftwareVersion =
+  MittwaldAPIV2.Components.Schemas.AppSystemSoftwareVersion;
+type AppSystemSoftwareDependency =
+  MittwaldAPIV2.Components.Schemas.AppSystemSoftwareDependency;
 
 export class UpgradeApp extends ExecRenderBaseCommand<typeof UpgradeApp, void> {
   static description = "Upgrade app installation to target version";
@@ -45,30 +53,34 @@ export class UpgradeApp extends ExecRenderBaseCommand<typeof UpgradeApp, void> {
       char: "f",
       description: "Do not ask for confirmation.",
     }),
+    ...projectFlags,
     ...processFlags,
     ...waitFlags,
   };
 
   protected async exec(): Promise<void> {
-    const process = makeProcessRenderer(this.flags, "App upgrade");
+    const process = makeProcessRenderer(
+      this.flags as ProcessFlags,
+      "App upgrade",
+    );
     const appInstallationId: string = await withAppInstallationId(
-        this.apiClient,
-        UpgradeApp,
-        this.flags,
-        this.args,
-        this.config,
-      ),
-      currentAppInstallation: AppAppInstallation =
+      this.apiClient,
+      UpgradeApp,
+      this.flags,
+      this.args,
+      this.config,
+    );
+    const currentAppInstallation: AppAppInstallation =
         await getAppInstallationFromUuid(this.apiClient, appInstallationId),
       currentApp: AppApp = await getAppFromUuid(
         this.apiClient,
         currentAppInstallation.appId,
-      ),
-      targetAppVersionCandidates: AppAppVersion[] =
-        await getAllUpgradeCandidatesFromAppInstallationId(
-          this.apiClient,
-          currentAppInstallation.id,
-        );
+      );
+    const targetAppVersionCandidates: AppAppVersion[] =
+      await getAllUpgradeCandidatesFromAppInstallationId(
+        this.apiClient,
+        currentAppInstallation.id,
+      );
 
     if (currentAppInstallation.appVersion.current === undefined) {
       process.error("Current version could not be determined properly.");
@@ -82,25 +94,24 @@ export class UpgradeApp extends ExecRenderBaseCommand<typeof UpgradeApp, void> {
     );
 
     if (targetAppVersionCandidates.length == 0) {
-      process.addInfo(
+      process.complete(
         <Text>
           Your {currentApp.name} {currentAppVersion.externalVersion} is already
           Up-To-Date. ✅
         </Text>,
       );
-      process.complete(<></>);
       ux.exit(0);
     }
 
-    let targetAppVersion;
+    let targetAppVersion: AppAppVersion;
 
     if (this.flags["target-version"] == "latest") {
       targetAppVersion =
-        await getLatestAvailableTargetAppVersionForAppVersionUpgradeCandidates(
+        (await getLatestAvailableTargetAppVersionForAppVersionUpgradeCandidates(
           this.apiClient,
           currentApp.id,
           currentAppVersion.id,
-        );
+        )) as AppAppVersion;
     } else if (this.flags["target-version"]) {
       const targetVersionMatchFromCandidates: AppAppVersion | undefined =
         targetAppVersionCandidates.find(
@@ -118,22 +129,22 @@ export class UpgradeApp extends ExecRenderBaseCommand<typeof UpgradeApp, void> {
             candidate.
           </Text>,
         );
-        targetAppVersion = await forceTargetVersionSelection(
+        targetAppVersion = (await forceTargetVersionSelection(
           process,
           this.apiClient,
           targetAppVersionCandidates,
           currentApp,
           currentAppVersion,
-        );
+        )) as AppAppVersion;
       }
     } else {
-      targetAppVersion = await forceTargetVersionSelection(
+      targetAppVersion = (await forceTargetVersionSelection(
         process,
         this.apiClient,
         targetAppVersionCandidates,
         currentApp,
         currentAppVersion,
-      );
+      )) as AppAppVersion;
     }
 
     if (!targetAppVersion) {
@@ -166,6 +177,34 @@ export class UpgradeApp extends ExecRenderBaseCommand<typeof UpgradeApp, void> {
       );
     }
 
+    const missingDependencies =
+      await this.apiClient.app.getMissingDependenciesForAppinstallation({
+        queryParameters: {
+          targetAppVersionID: targetAppVersion.id,
+        },
+        appInstallationId,
+      });
+
+    if (missingDependencies.data.missingSystemSoftwareDependencies) {
+      process.addInfo(
+        <Text>
+          In order to update your {currentApp.name} to Version
+          {targetAppVersion.externalVersion} some dependencies need to be
+          updated too.
+        </Text>,
+      );
+      for (const missingSystemSoftwareDependency of missingDependencies.data
+        .missingSystemSoftwareDependencies as AppSystemSoftwareDependency[]) {
+        await updateMissingSystemSoftwareDependency(
+          process,
+          this.apiClient,
+          appInstallationId,
+          missingSystemSoftwareDependency,
+          this.flags.force,
+        );
+      }
+    }
+
     const patchAppTriggerResponse =
       await this.apiClient.app.patchAppinstallation({
         appInstallationId,
@@ -221,3 +260,80 @@ async function forceTargetVersionSelection(
     targetAppVersionString,
   );
 }
+
+async function updateMissingSystemSoftwareDependency(
+  process: ProcessRenderer,
+  apiClient: MittwaldAPIV2Client,
+  appInstallationId: string,
+  dependency: AppSystemSoftwareDependency,
+  force: boolean,
+) {
+  const dependencySoftware = await apiClient.app.getSystemsoftware({
+    systemSoftwareId: dependency.systemSoftwareId,
+  });
+  assertSuccess(dependencySoftware);
+
+  const dependencyVersionList = await apiClient.app.listSystemsoftwareversions({
+    systemSoftwareId: dependency.systemSoftwareId,
+  });
+  assertSuccess(dependencyVersionList);
+
+  let dependencyTargetVersion: AppSystemSoftwareVersion = {
+    id: "not yet set",
+    externalVersion: "0.0.0",
+    internalVersion: "0.0.0",
+  };
+  for (const dependencyVersion of dependencyVersionList.data) {
+    if (
+      semver.satisfies(
+        dependencyVersion.internalVersion,
+        dependency.versionRange,
+      ) &&
+      semver.gt(
+        dependencyVersion.internalVersion,
+        dependencyTargetVersion.internalVersion,
+      )
+    ) {
+      dependencyTargetVersion = dependencyVersion;
+    }
+  }
+
+  if (!force) {
+    const confirmed: boolean = await process.addConfirmation(
+      <Text>
+        {dependencySoftware.data.name as string} will be updated to Version{" "}
+        {dependencyTargetVersion.externalVersion} - Continue?
+      </Text>,
+    );
+    if (!confirmed) {
+      process.addInfo(<Text>Upgrade will not be triggered.</Text>);
+      process.complete(<></>);
+      ux.exit(1);
+    }
+  } else {
+    process.addInfo(
+      <Text>
+        Commencing upgrade of {dependencySoftware.data.name as string} to{" "}
+        Version {dependencyTargetVersion.externalVersion}.
+      </Text>,
+    );
+  }
+
+  const systemSoftware: {
+    [x: string]: {
+      systemSoftwareVersion: string | undefined;
+    };
+  } = {};
+  systemSoftware[dependencySoftware.data.id as string] = {
+    systemSoftwareVersion: dependencyTargetVersion.id,
+  };
+
+  const data = { systemSoftware };
+
+  const dependencyUpgradeResponse = await apiClient.app.patchAppinstallation({
+    appInstallationId,
+    data,
+  });
+
+  assertSuccess(dependencyUpgradeResponse);
+}

From 9f3443dfbe602590b3669e4a2a8c684805417616 Mon Sep 17 00:00:00 2001
From: martin-helmich <martin-helmich@users.noreply.github.com>
Date: Thu, 22 Aug 2024 11:47:48 +0000
Subject: [PATCH 04/11] chore: re-generate README

---
 README.md | 528 ++++++++++++++++--------------------------------------
 1 file changed, 152 insertions(+), 376 deletions(-)

diff --git a/README.md b/README.md
index 2ce37f813..5f4ea449a 100644
--- a/README.md
+++ b/README.md
@@ -149,10 +149,7 @@ USAGE
 * [`mw backup download BACKUP-ID`](#mw-backup-download-backup-id)
 * [`mw backup get BACKUP-ID`](#mw-backup-get-backup-id)
 * [`mw backup list`](#mw-backup-list)
-* [`mw backup schedule create`](#mw-backup-schedule-create)
-* [`mw backup schedule delete [BACKUP-SCHEDULE-ID]`](#mw-backup-schedule-delete-backup-schedule-id)
 * [`mw backup schedule list`](#mw-backup-schedule-list)
-* [`mw backup schedule update [BACKUP-SCHEDULE-ID]`](#mw-backup-schedule-update-backup-schedule-id)
 * [`mw context get`](#mw-context-get)
 * [`mw context reset`](#mw-context-reset)
 * [`mw context set`](#mw-context-set)
@@ -172,7 +169,6 @@ USAGE
 * [`mw cronjob execution logs CRONJOB-ID EXECUTION-ID`](#mw-cronjob-execution-logs-cronjob-id-execution-id)
 * [`mw cronjob get CRONJOB-ID`](#mw-cronjob-get-cronjob-id)
 * [`mw cronjob list`](#mw-cronjob-list)
-* [`mw cronjob update CRONJOB-ID`](#mw-cronjob-update-cronjob-id)
 * [`mw database mysql charsets`](#mw-database-mysql-charsets)
 * [`mw database mysql create`](#mw-database-mysql-create)
 * [`mw database mysql delete DATABASE-ID`](#mw-database-mysql-delete-database-id)
@@ -183,11 +179,9 @@ USAGE
 * [`mw database mysql phpmyadmin DATABASE-ID`](#mw-database-mysql-phpmyadmin-database-id)
 * [`mw database mysql port-forward DATABASE-ID`](#mw-database-mysql-port-forward-database-id)
 * [`mw database mysql shell DATABASE-ID`](#mw-database-mysql-shell-database-id)
-* [`mw database mysql user create [DATABASE-ID]`](#mw-database-mysql-user-create-database-id)
 * [`mw database mysql user delete USER-ID`](#mw-database-mysql-user-delete-user-id)
 * [`mw database mysql user get ID`](#mw-database-mysql-user-get-id)
 * [`mw database mysql user list`](#mw-database-mysql-user-list)
-* [`mw database mysql user update [DATABASE-ID]`](#mw-database-mysql-user-update-database-id)
 * [`mw database mysql versions`](#mw-database-mysql-versions)
 * [`mw database redis create`](#mw-database-redis-create)
 * [`mw database redis get ID`](#mw-database-redis-get-id)
@@ -254,14 +248,10 @@ USAGE
 * [`mw project update [PROJECT-ID]`](#mw-project-update-project-id)
 * [`mw server get [SERVER-ID]`](#mw-server-get-server-id)
 * [`mw server list`](#mw-server-list)
-* [`mw sftp-user create`](#mw-sftp-user-create)
 * [`mw sftp-user delete SFTP-USER-ID`](#mw-sftp-user-delete-sftp-user-id)
 * [`mw sftp-user list`](#mw-sftp-user-list)
-* [`mw sftp-user update SFTP-USER-ID`](#mw-sftp-user-update-sftp-user-id)
-* [`mw ssh-user create`](#mw-ssh-user-create)
 * [`mw ssh-user delete SSH-USER-ID`](#mw-ssh-user-delete-ssh-user-id)
 * [`mw ssh-user list`](#mw-ssh-user-list)
-* [`mw ssh-user update SSH-USER-ID`](#mw-ssh-user-update-ssh-user-id)
 * [`mw update [CHANNEL]`](#mw-update-channel)
 * [`mw user api-token create`](#mw-user-api-token-create)
 * [`mw user api-token get TOKEN-ID`](#mw-user-api-token-get-token-id)
@@ -325,7 +315,9 @@ DESCRIPTION
   Creates new custom Node.js installation.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -371,7 +363,9 @@ DESCRIPTION
   Creates new custom PHP installation.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -418,7 +412,9 @@ DESCRIPTION
   Creates new custom python site installation.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -464,7 +460,9 @@ DESCRIPTION
   Creates new custom static site installation.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -518,7 +516,8 @@ Update the dependencies of an app
 
 ```
 USAGE
-  $ mw app dependency update [INSTALLATION-ID] --set <value> [-q] [--update-policy none|inheritedFromApp|patchLevel|all]
+  $ mw app dependency update [INSTALLATION-ID] --set <value>... [-q] [--update-policy
+  none|inheritedFromApp|patchLevel|all]
 
 ARGUMENTS
   INSTALLATION-ID  ID or short ID of an app installation; this argument is optional if a default app installation is set
@@ -582,7 +581,7 @@ Download the filesystem of an app within a project to your local machine
 ```
 USAGE
   $ mw app download [INSTALLATION-ID] --target <value> [-q] [--ssh-user <value>] [--ssh-identity-file <value>]
-    [--exclude <value>] [--dry-run] [--delete]
+    [--exclude <value>...] [--dry-run] [--delete]
 
 ARGUMENTS
   INSTALLATION-ID  ID or short ID of an app installation; this argument is optional if a default app installation is set
@@ -690,7 +689,9 @@ DESCRIPTION
   Creates new Contao installation.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -777,7 +778,9 @@ DESCRIPTION
   Creates new Drupal installation.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -854,7 +857,9 @@ DESCRIPTION
   Creates new Grav installation.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -938,7 +943,9 @@ DESCRIPTION
   Creates new Joomla! installation.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -1025,7 +1032,9 @@ DESCRIPTION
   Creates new Matomo installation.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -1100,7 +1109,9 @@ DESCRIPTION
   Creates new Moodle installation.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -1175,7 +1186,9 @@ DESCRIPTION
   Creates new NEOS installation.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -1250,7 +1263,9 @@ DESCRIPTION
   Creates new Nextcloud installation.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -1329,7 +1344,9 @@ DESCRIPTION
   Creates new PrestaShop installation.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -1424,7 +1441,9 @@ DESCRIPTION
   Creates new Shopware 5 installation.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -1536,7 +1555,9 @@ DESCRIPTION
   Creates new Shopware 6 installation.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -1644,7 +1665,9 @@ DESCRIPTION
   Creates new TYPO3 installation.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -1726,7 +1749,9 @@ DESCRIPTION
   Creates new WordPress installation.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -1799,7 +1824,9 @@ DESCRIPTION
   List installed apps in a project.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -1974,7 +2001,9 @@ DESCRIPTION
   Upgrade app installation to target version
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -1992,7 +2021,7 @@ Upload the filesystem of an app to a project
 ```
 USAGE
   $ mw app upload [INSTALLATION-ID] --source <value> [-q] [--ssh-user <value>] [--ssh-identity-file <value>]
-    [--exclude <value>] [--dry-run] [--delete]
+    [--exclude <value>...] [--dry-run] [--delete]
 
 ARGUMENTS
   INSTALLATION-ID  ID or short ID of an app installation; this argument is optional if a default app installation is set
@@ -2120,7 +2149,9 @@ ALIASES
   $ mw project backup create
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -2257,65 +2288,12 @@ ALIASES
   $ mw project backup list
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
-
-    May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
-    to persistently set a default project for all commands that accept this flag.
-```
-
-## `mw backup schedule create`
-
-Create a new backup schedule
-
-```
-USAGE
-  $ mw backup schedule create --schedule <value> --ttl <value> [-p <value>] [-q] [--description <value>]
-
-FLAGS
-  -p, --project-id=<value>   ID or short ID of a project; this flag is optional if a default project is set in the
-                             context
-  -q, --quiet                suppress process output and only display a machine-readable summary.
-      --description=<value>  Set the description for the backup schedule
-      --schedule=<value>     (required) Define the schedule itself
-      --ttl=<value>          (required) Define the backup storage period in days, for through this schedule created
-                             backups
+  -p, --project-id=<value>
 
-FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
-
-  -q, --quiet  suppress process output and only display a machine-readable summary.
-
-    This flag controls if you want to see the process output or only a summary. When using mw non-interactively (e.g. in
-    scripts), you can use this flag to easily get the IDs of created resources for further processing.
-```
-
-## `mw backup schedule delete [BACKUP-SCHEDULE-ID]`
-
-Delete a backup schedule
-
-```
-USAGE
-  $ mw backup schedule delete [BACKUP-SCHEDULE-ID] [-q] [-f] [--backup-schedule-id <value>]
-
-ARGUMENTS
-  BACKUP-SCHEDULE-ID  ID of schedule to delete
-
-FLAGS
-  -f, --force                       Do not ask for confirmation
-  -q, --quiet                       suppress process output and only display a machine-readable summary.
-      --backup-schedule-id=<value>  ID of backup schedule to delete
-
-DESCRIPTION
-  Delete a backup schedule
-
-FLAG DESCRIPTIONS
-  -q, --quiet  suppress process output and only display a machine-readable summary.
-
-    This flag controls if you want to see the process output or only a summary. When using mw non-interactively (e.g. in
-    scripts), you can use this flag to easily get the IDs of created resources for further processing.
 ```
 
 ## `mw backup schedule list`
@@ -2346,41 +2324,14 @@ ALIASES
   $ mw project backupschedule list
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
 ```
 
-## `mw backup schedule update [BACKUP-SCHEDULE-ID]`
-
-Update an existing backup schedule
-
-```
-USAGE
-  $ mw backup schedule update [BACKUP-SCHEDULE-ID] [-q] [--backup-schedule-id <value>] [--description <value>] [--schedule
-    <value>] [--ttl <value>]
-
-ARGUMENTS
-  BACKUP-SCHEDULE-ID  Define the backup schedule that is to be updated
-
-FLAGS
-  -q, --quiet                       suppress process output and only display a machine-readable summary.
-      --backup-schedule-id=<value>  Define the backup schedule that is to be updated
-      --description=<value>         Set the description for the backup schedule
-      --schedule=<value>            Define the schedule itself
-      --ttl=<value>                 Define the backup storage period in days, for through this schedule created backups
-
-DESCRIPTION
-  Update an existing backup schedule
-
-FLAG DESCRIPTIONS
-  -q, --quiet  suppress process output and only display a machine-readable summary.
-
-    This flag controls if you want to see the process output or only a summary. When using mw non-interactively (e.g. in
-    scripts), you can use this flag to easily get the IDs of created resources for further processing.
-```
-
 ## `mw context get`
 
 Print an overview of currently set context parameters
@@ -2803,47 +2754,14 @@ ALIASES
   $ mw project cronjob list
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
 ```
 
-## `mw cronjob update CRONJOB-ID`
-
-Update an existing cron job
-
-```
-USAGE
-  $ mw cronjob update CRONJOB-ID [--description <value>] [--interval <value>] [--disable | --enable] [--email
-    <value>] [--timeout <value>] [--url <value>] [--command <value>] [--interpreter bash|php] [-q]
-
-ARGUMENTS
-  CRONJOB-ID  ID of the cron job to be updated.
-
-FLAGS
-  -q, --quiet                 suppress process output and only display a machine-readable summary.
-      --command=<value>       Set file and parameters to execute on cron job execution
-      --description=<value>   Set cron job description
-      --disable               Disable cron job automated execution
-      --email=<value>         Set target email to send error messages to
-      --enable                Enable cron job automated execution
-      --interpreter=<option>  Set interpreter to use for execution
-                              <options: bash|php>
-      --interval=<value>      Set cron job execution interval
-      --timeout=<value>       Set timeout in seconds after wich the process is killed
-      --url=<value>           Set url to use on cron job execution
-
-DESCRIPTION
-  Update an existing cron job
-
-FLAG DESCRIPTIONS
-  -q, --quiet  suppress process output and only display a machine-readable summary.
-
-    This flag controls if you want to see the process output or only a summary. When using mw non-interactively (e.g. in
-    scripts), you can use this flag to easily get the IDs of created resources for further processing.
-```
-
 ## `mw database mysql charsets`
 
 List available MySQL character sets and collations, optionally filtered by a MySQLVersion.
@@ -2890,7 +2808,9 @@ FLAGS
       --version=<value>             (required) the MySQL version to use
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -3141,7 +3061,9 @@ DESCRIPTION
   List MySQLDatabases belonging to a Project.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -3274,38 +3196,6 @@ FLAG DESCRIPTIONS
     You can also set this value by setting the MITTWALD_SSH_USER environment variable.
 ```
 
-## `mw database mysql user create [DATABASE-ID]`
-
-Create a new mysql user
-
-```
-USAGE
-  $ mw database mysql user create [DATABASE-ID] --database-id <value> --access-level readonly|full --description <value>
-    --password <value> [-q] [--access-ip-mask <value>] [--external-access]
-
-ARGUMENTS
-  DATABASE-ID  ID of the MySQL Database to create a user for
-
-FLAGS
-  -q, --quiet                   suppress process output and only display a machine-readable summary.
-      --access-ip-mask=<value>  IP from wich external access will be exclusively allowed
-      --access-level=<option>   (required) Access level for this mysql user
-                                <options: readonly|full>
-      --database-id=<value>     (required) ID of the MySQL Database to create a user for
-      --description=<value>     (required) Description of the mysql user
-      --external-access         Enable/Disable external access for this user.
-      --password=<value>        (required) Password used for authentication
-
-DESCRIPTION
-  Create a new mysql user
-
-FLAG DESCRIPTIONS
-  -q, --quiet  suppress process output and only display a machine-readable summary.
-
-    This flag controls if you want to see the process output or only a summary. When using mw non-interactively (e.g. in
-    scripts), you can use this flag to easily get the IDs of created resources for further processing.
-```
-
 ## `mw database mysql user delete USER-ID`
 
 Delete a MySQL user
@@ -3374,38 +3264,6 @@ DESCRIPTION
   List MySQL users belonging to a database.
 ```
 
-## `mw database mysql user update [DATABASE-ID]`
-
-Create a new mysql user
-
-```
-USAGE
-  $ mw database mysql user update [DATABASE-ID] [-q] [--database-id <value>] [--access-level readonly|full] [--description
-    <value>] [--password <value>] [--access-ip-mask <value>] [--external-access]
-
-ARGUMENTS
-  DATABASE-ID  MySQL User ID of the user to be updated
-
-FLAGS
-  -q, --quiet                   suppress process output and only display a machine-readable summary.
-      --access-ip-mask=<value>  IP from wich external access will be exclusively allowed
-      --access-level=<option>   Access level for this mysql user
-                                <options: readonly|full>
-      --database-id=<value>     MySQL User ID of the user to be updated
-      --description=<value>     Description of the mysql user
-      --external-access         Enable/Disable external access for this user.
-      --password=<value>        Password used for authentication
-
-DESCRIPTION
-  Create a new mysql user
-
-FLAG DESCRIPTIONS
-  -q, --quiet  suppress process output and only display a machine-readable summary.
-
-    This flag controls if you want to see the process output or only a summary. When using mw non-interactively (e.g. in
-    scripts), you can use this flag to easily get the IDs of created resources for further processing.
-```
-
 ## `mw database mysql versions`
 
 List available MySQL versions.
@@ -3452,7 +3310,9 @@ FLAGS
       --version=<value>             (required) the Redis version to use
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -3522,7 +3382,9 @@ DESCRIPTION
   List Redis databases belonging to a project.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -3605,7 +3467,9 @@ DESCRIPTION
   List available Redis versions.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -3786,7 +3650,9 @@ DESCRIPTION
   list all DNS zones by project ID
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -3798,7 +3664,7 @@ Updates a record set of a DNS zone
 
 ```
 USAGE
-  $ mw domain dnszone update DNSZONE-ID RECORD-SET [-q] [-p <value>] [--record <value> | --managed | --unset] [--ttl
+  $ mw domain dnszone update DNSZONE-ID RECORD-SET [-q] [-p <value>] [--record <value>... | --managed | --unset] [--ttl
     <value>]
 
 ARGUMENTS
@@ -3828,7 +3694,9 @@ EXAMPLES
       mail2.domain.example"
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -3894,7 +3762,9 @@ DESCRIPTION
   List domains belonging to a project.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -3906,8 +3776,8 @@ Create a new ingress
 
 ```
 USAGE
-  $ mw domain virtualhost create --hostname <value> [-q] [-p <value>] [--path-to-dir <value>] [--path-to-app <value>]
-    [--path-to-url <value>]
+  $ mw domain virtualhost create --hostname <value> [-q] [-p <value>] [--path-to-dir <value>...] [--path-to-app <value>...]
+    [--path-to-url <value>...]
 
 FLAGS
   -p, --project-id=<value>      ID or short ID of a project; this flag is optional if a default project is set in the
@@ -3935,7 +3805,9 @@ EXAMPLES
     $ mw domain virtualhost create --hostname mw.example --path-to-url /:https://redirect.example
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -4032,7 +3904,9 @@ DESCRIPTION
   List virtualhosts for a project.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -4104,7 +3978,7 @@ Create a new mail address
 ```
 USAGE
   $ mw mail address create -a <value> [-p <value>] [-q] [--catch-all] [--enable-spam-protection] [--quota <value>]
-    [--password <value>] [--random-password] [--forward-to <value>]
+    [--password <value>] [--random-password] [--forward-to <value>...]
 
 FLAGS
   -a, --address=<value>              (required) mail address
@@ -4150,7 +4024,9 @@ EXAMPLES
     $ mw mail address create --address foo@bar.example --forward-to bar@bar.example --forward-to baz@bar.example
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -4249,7 +4125,9 @@ DESCRIPTION
   Get all mail addresses for a project ID
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -4262,7 +4140,7 @@ Update a mail address
 ```
 USAGE
   $ mw mail address update MAILADDRESS-ID [-q] [-a <value>] [--catch-all] [--quota <value>] [--password <value>]
-    [--random-password] [--forward-to <value>]
+    [--random-password] [--forward-to <value>...]
 
 ARGUMENTS
   MAILADDRESS-ID  ID or mail address of a mailaddress
@@ -4373,7 +4251,9 @@ DESCRIPTION
   Get all deliveryboxes by project ID
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -4655,7 +4535,9 @@ ALIASES
   $ mw project backup create
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -4792,7 +4674,9 @@ ALIASES
   $ mw project backup list
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -4826,7 +4710,9 @@ ALIASES
   $ mw project backupschedule list
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -4859,7 +4745,9 @@ FLAG DESCRIPTIONS
     This flag controls if you want to see the process output or only a summary. When using mw non-interactively (e.g. in
     scripts), you can use this flag to easily get the IDs of created resources for further processing.
 
-  -s, --server-id=<value>  ID or short ID of a server; this flag is optional if a default server is set in the context
+  -s, --server-id=<value>
+
+    ID or short ID of a server; this flag is optional if a default server is set in the context
 
     May contain a short ID or a full ID of a server; you can also use the "mw context set --server-id=<VALUE>" command
     to persistently set a default server for all commands that accept this flag.
@@ -4971,7 +4859,9 @@ ALIASES
   $ mw project cronjob list
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -5085,7 +4975,9 @@ DESCRIPTION
   List all invites belonging to a project.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -5174,7 +5066,9 @@ DESCRIPTION
   Get the executing user's membership in a Project.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -5205,7 +5099,9 @@ DESCRIPTION
   List all memberships for a Project.
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -5262,7 +5158,9 @@ ALIASES
   $ mw project sftp-user list
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -5339,7 +5237,9 @@ ALIASES
   $ mw project ssh-user list
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
@@ -5402,39 +5302,6 @@ DESCRIPTION
   List servers for an organization or user.
 ```
 
-## `mw sftp-user create`
-
-Create a new sftp user
-
-```
-USAGE
-  $ mw sftp-user create --description <value> --directories <value> [-p <value>] [-q] [--public-key <value>]
-    [--password <value>] [--expires <value>] [--access-level read|full]
-
-FLAGS
-  -p, --project-id=<value>      ID or short ID of a project; this flag is optional if a default project is set in the
-                                context
-  -q, --quiet                   suppress process output and only display a machine-readable summary.
-      --access-level=<option>   Set access level privileges for the sftp user
-                                <options: read|full>
-      --description=<value>     (required) Description of sftp user
-      --directories=<value>...  (required) Set directories to restrict the sftp users access to
-      --expires=<value>         Date at wich the sftp user get disabled automatically
-      --password=<value>        Password used for authentication
-      --public-key=<value>      Public Key used for authentication
-
-FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
-
-    May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
-    to persistently set a default project for all commands that accept this flag.
-
-  -q, --quiet  suppress process output and only display a machine-readable summary.
-
-    This flag controls if you want to see the process output or only a summary. When using mw non-interactively (e.g. in
-    scripts), you can use this flag to easily get the IDs of created resources for further processing.
-```
-
 ## `mw sftp-user delete SFTP-USER-ID`
 
 Delete an SFTP user
@@ -5488,74 +5355,12 @@ ALIASES
   $ mw project sftp-user list
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
-
-    May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
-    to persistently set a default project for all commands that accept this flag.
-```
-
-## `mw sftp-user update SFTP-USER-ID`
-
-Update an existing sftp user
-
-```
-USAGE
-  $ mw sftp-user update SFTP-USER-ID [-q] [--description <value>] [--public-key <value> | --password <value>]
-    [--expires <value>] [--access-level read|full] [--directories <value>] [--disable | --enable]
-
-ARGUMENTS
-  SFTP-USER-ID  The ID of the sftp user to update
-
-FLAGS
-  -q, --quiet                   suppress process output and only display a machine-readable summary.
-      --access-level=<option>   Set access level privileges for the sftp user
-                                <options: read|full>
-      --description=<value>     Set the sftp users description
-      --directories=<value>...  Set directories to restrict the sftp users access to
-      --disable                 Disable sftp user
-      --enable                  Enable sftp user
-      --expires=<value>         Date at wich the sftp user will be disabled automatically
-      --password=<value>        Password used for authentication
-      --public-key=<value>      Public Key used for authentication
-
-DESCRIPTION
-  Update an existing sftp user
-
-FLAG DESCRIPTIONS
-  -q, --quiet  suppress process output and only display a machine-readable summary.
+  -p, --project-id=<value>
 
-    This flag controls if you want to see the process output or only a summary. When using mw non-interactively (e.g. in
-    scripts), you can use this flag to easily get the IDs of created resources for further processing.
-```
-
-## `mw ssh-user create`
-
-Create a new ssh user
-
-```
-USAGE
-  $ mw ssh-user create --description <value> [-p <value>] [-q] [--expires <value>] [--public-key <value>] [--password
-    <value>]
-
-FLAGS
-  -p, --project-id=<value>   ID or short ID of a project; this flag is optional if a default project is set in the
-                             context
-  -q, --quiet                suppress process output and only display a machine-readable summary.
-      --description=<value>  (required) Description of ssh user
-      --expires=<value>      Date at wich the ssh user get disabled automatically
-      --password=<value>     Password used for authentication
-      --public-key=<value>   Public Key used for authentication
-
-FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
-
-  -q, --quiet  suppress process output and only display a machine-readable summary.
-
-    This flag controls if you want to see the process output or only a summary. When using mw non-interactively (e.g. in
-    scripts), you can use this flag to easily get the IDs of created resources for further processing.
 ```
 
 ## `mw ssh-user delete SSH-USER-ID`
@@ -5611,43 +5416,14 @@ ALIASES
   $ mw project ssh-user list
 
 FLAG DESCRIPTIONS
-  -p, --project-id=<value>  ID or short ID of a project; this flag is optional if a default project is set in the context
+  -p, --project-id=<value>
+
+    ID or short ID of a project; this flag is optional if a default project is set in the context
 
     May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
     to persistently set a default project for all commands that accept this flag.
 ```
 
-## `mw ssh-user update SSH-USER-ID`
-
-Update an existing cron job
-
-```
-USAGE
-  $ mw ssh-user update SSH-USER-ID [-q] [--description <value>] [--public-key <value>] [--password <value>]
-    [--expires <value>] [--disable | --enable]
-
-ARGUMENTS
-  SSH-USER-ID  The ID of the SSH user to update
-
-FLAGS
-  -q, --quiet                suppress process output and only display a machine-readable summary.
-      --description=<value>  Set cron job description
-      --disable              Disable ssh user
-      --enable               Enable ssh user
-      --expires=<value>      Date at wich the User get disabled automatically
-      --password=<value>     Password used for authentication
-      --public-key=<value>   Public Key used for authentication
-
-DESCRIPTION
-  Update an existing cron job
-
-FLAG DESCRIPTIONS
-  -q, --quiet  suppress process output and only display a machine-readable summary.
-
-    This flag controls if you want to see the process output or only a summary. When using mw non-interactively (e.g. in
-    scripts), you can use this flag to easily get the IDs of created resources for further processing.
-```
-
 ## `mw update [CHANNEL]`
 
 update the mw CLI
@@ -5691,7 +5467,7 @@ Create a new API token
 
 ```
 USAGE
-  $ mw user api-token create --description <value> --roles api_read|api_write [-q] [--expires <value>]
+  $ mw user api-token create --description <value> --roles api_read|api_write... [-q] [--expires <value>]
 
 FLAGS
   -q, --quiet                suppress process output and only display a machine-readable summary.

From 1fc965c7c890fdd459aaa2bf7123274c22ccc767 Mon Sep 17 00:00:00 2001
From: Michel Hopfner <m.hopfner@mittwald.de>
Date: Tue, 27 Aug 2024 10:12:32 +0200
Subject: [PATCH 05/11] minimize amount of necessary API calls, unify wording
 to "upgrade"

---
 src/commands/app/upgrade.tsx | 67 +++++++++++++++++-------------------
 1 file changed, 31 insertions(+), 36 deletions(-)

diff --git a/src/commands/app/upgrade.tsx b/src/commands/app/upgrade.tsx
index 14fd79c96..aa62f4358 100644
--- a/src/commands/app/upgrade.tsx
+++ b/src/commands/app/upgrade.tsx
@@ -38,6 +38,9 @@ type AppSystemSoftwareVersion =
   MittwaldAPIV2.Components.Schemas.AppSystemSoftwareVersion;
 type AppSystemSoftwareDependency =
   MittwaldAPIV2.Components.Schemas.AppSystemSoftwareDependency;
+type AppUpgradePayload = Parameters<
+  MittwaldAPIV2Client["app"]["patchAppinstallation"]
+>[0]["data"];
 
 export class UpgradeApp extends ExecRenderBaseCommand<typeof UpgradeApp, void> {
   static description = "Upgrade app installation to target version";
@@ -100,7 +103,7 @@ export class UpgradeApp extends ExecRenderBaseCommand<typeof UpgradeApp, void> {
           Up-To-Date. ✅
         </Text>,
       );
-      ux.exit(0);
+      return;
     }
 
     let targetAppVersion: AppAppVersion;
@@ -149,7 +152,7 @@ export class UpgradeApp extends ExecRenderBaseCommand<typeof UpgradeApp, void> {
 
     if (!targetAppVersion) {
       process.error("Target app version could not be determined properly.");
-      return;
+      ux.exit(1);
     }
 
     if (!this.flags.force) {
@@ -177,6 +180,10 @@ export class UpgradeApp extends ExecRenderBaseCommand<typeof UpgradeApp, void> {
       );
     }
 
+    const appUpgradePayload: AppUpgradePayload = {
+      appVersionId: targetAppVersion.id,
+    };
+
     const missingDependencies =
       await this.apiClient.app.getMissingDependenciesForAppinstallation({
         queryParameters: {
@@ -186,29 +193,36 @@ export class UpgradeApp extends ExecRenderBaseCommand<typeof UpgradeApp, void> {
       });
 
     if (missingDependencies.data.missingSystemSoftwareDependencies) {
+      appUpgradePayload.systemSoftware = {};
       process.addInfo(
         <Text>
-          In order to update your {currentApp.name} to Version
+          In order to upgrade your {currentApp.name} to Version
           {targetAppVersion.externalVersion} some dependencies need to be
-          updated too.
+          upgraded too.
         </Text>,
       );
       for (const missingSystemSoftwareDependency of missingDependencies.data
         .missingSystemSoftwareDependencies as AppSystemSoftwareDependency[]) {
-        await updateMissingSystemSoftwareDependency(
-          process,
-          this.apiClient,
-          appInstallationId,
-          missingSystemSoftwareDependency,
-          this.flags.force,
-        );
+        const dependencyUpdateData =
+          await updateMissingSystemSoftwareDependency(
+            process,
+            this.apiClient,
+            appInstallationId,
+            missingSystemSoftwareDependency,
+            this.flags.force,
+          );
+        appUpgradePayload.systemSoftware[
+          dependencyUpdateData.dependencySoftwareId
+        ] = {
+          systemSoftwareVersion: dependencyUpdateData.dependencyTargetVersionId,
+        };
       }
     }
 
     const patchAppTriggerResponse =
       await this.apiClient.app.patchAppinstallation({
         appInstallationId,
-        data: { appVersionId: targetAppVersion.id },
+        data: appUpgradePayload,
       });
 
     assertStatus(patchAppTriggerResponse, 204);
@@ -283,6 +297,7 @@ async function updateMissingSystemSoftwareDependency(
     externalVersion: "0.0.0",
     internalVersion: "0.0.0",
   };
+
   for (const dependencyVersion of dependencyVersionList.data) {
     if (
       semver.satisfies(
@@ -301,7 +316,7 @@ async function updateMissingSystemSoftwareDependency(
   if (!force) {
     const confirmed: boolean = await process.addConfirmation(
       <Text>
-        {dependencySoftware.data.name as string} will be updated to Version{" "}
+        {dependencySoftware.data.name as string} will be upgraded to Version{" "}
         {dependencyTargetVersion.externalVersion} - Continue?
       </Text>,
     );
@@ -310,30 +325,10 @@ async function updateMissingSystemSoftwareDependency(
       process.complete(<></>);
       ux.exit(1);
     }
-  } else {
-    process.addInfo(
-      <Text>
-        Commencing upgrade of {dependencySoftware.data.name as string} to{" "}
-        Version {dependencyTargetVersion.externalVersion}.
-      </Text>,
-    );
   }
 
-  const systemSoftware: {
-    [x: string]: {
-      systemSoftwareVersion: string | undefined;
-    };
-  } = {};
-  systemSoftware[dependencySoftware.data.id as string] = {
-    systemSoftwareVersion: dependencyTargetVersion.id,
+  return {
+    dependencySoftwareId: dependencySoftware.data.id as string,
+    dependencyTargetVersionId: dependencyTargetVersion.id,
   };
-
-  const data = { systemSoftware };
-
-  const dependencyUpgradeResponse = await apiClient.app.patchAppinstallation({
-    appInstallationId,
-    data,
-  });
-
-  assertSuccess(dependencyUpgradeResponse);
 }

From 32534549b850aa34e94c6181ce5587568549b964 Mon Sep 17 00:00:00 2001
From: Michel Hopfner <m.hopfner@mittwald.de>
Date: Wed, 28 Aug 2024 11:03:18 +0200
Subject: [PATCH 06/11] assert success of Target version loop, reduce
 confirmation requests and let api handle dependency version restrains

---
 src/commands/app/upgrade.tsx | 53 ++++++++++++++++++++++--------------
 1 file changed, 32 insertions(+), 21 deletions(-)

diff --git a/src/commands/app/upgrade.tsx b/src/commands/app/upgrade.tsx
index aa62f4358..b2c35d964 100644
--- a/src/commands/app/upgrade.tsx
+++ b/src/commands/app/upgrade.tsx
@@ -194,9 +194,9 @@ export class UpgradeApp extends ExecRenderBaseCommand<typeof UpgradeApp, void> {
 
     if (missingDependencies.data.missingSystemSoftwareDependencies) {
       appUpgradePayload.systemSoftware = {};
-      process.addInfo(
+      process.addStep(
         <Text>
-          In order to upgrade your {currentApp.name} to Version
+          In order to upgrade your {currentApp.name} to Version{" "}
           {targetAppVersion.externalVersion} some dependencies need to be
           upgraded too.
         </Text>,
@@ -209,7 +209,6 @@ export class UpgradeApp extends ExecRenderBaseCommand<typeof UpgradeApp, void> {
             this.apiClient,
             appInstallationId,
             missingSystemSoftwareDependency,
-            this.flags.force,
           );
         appUpgradePayload.systemSoftware[
           dependencyUpdateData.dependencySoftwareId
@@ -217,6 +216,17 @@ export class UpgradeApp extends ExecRenderBaseCommand<typeof UpgradeApp, void> {
           systemSoftwareVersion: dependencyUpdateData.dependencyTargetVersionId,
         };
       }
+
+      if (!this.flags.force) {
+        const confirmed: boolean = await process.addConfirmation(
+          <Text>Do you want to continue?</Text>,
+        );
+        if (!confirmed) {
+          process.addInfo(<Text>Upgrade will not be triggered.</Text>);
+          process.complete(<></>);
+          ux.exit(1);
+        }
+      }
     }
 
     const patchAppTriggerResponse =
@@ -280,7 +290,6 @@ async function updateMissingSystemSoftwareDependency(
   apiClient: MittwaldAPIV2Client,
   appInstallationId: string,
   dependency: AppSystemSoftwareDependency,
-  force: boolean,
 ) {
   const dependencySoftware = await apiClient.app.getSystemsoftware({
     systemSoftwareId: dependency.systemSoftwareId,
@@ -289,8 +298,13 @@ async function updateMissingSystemSoftwareDependency(
 
   const dependencyVersionList = await apiClient.app.listSystemsoftwareversions({
     systemSoftwareId: dependency.systemSoftwareId,
+    queryParameters: {
+      versionRange: dependency.versionRange,
+      recommended: true,
+    },
   });
   assertSuccess(dependencyVersionList);
+  console.log(dependencyVersionList);
 
   let dependencyTargetVersion: AppSystemSoftwareVersion = {
     id: "not yet set",
@@ -300,10 +314,6 @@ async function updateMissingSystemSoftwareDependency(
 
   for (const dependencyVersion of dependencyVersionList.data) {
     if (
-      semver.satisfies(
-        dependencyVersion.internalVersion,
-        dependency.versionRange,
-      ) &&
       semver.gt(
         dependencyVersion.internalVersion,
         dependencyTargetVersion.internalVersion,
@@ -313,22 +323,23 @@ async function updateMissingSystemSoftwareDependency(
     }
   }
 
-  if (!force) {
-    const confirmed: boolean = await process.addConfirmation(
+  if (dependencyTargetVersion.internalVersion == "0.0.0") {
+    throw new Error(
+      "Dependency Target Version for " +
+        dependencySoftware.data.name +
+        " could not be determined",
+    );
+  } else {
+    process.addInfo(
       <Text>
         {dependencySoftware.data.name as string} will be upgraded to Version{" "}
-        {dependencyTargetVersion.externalVersion} - Continue?
+        {dependencyTargetVersion.externalVersion}.
       </Text>,
     );
-    if (!confirmed) {
-      process.addInfo(<Text>Upgrade will not be triggered.</Text>);
-      process.complete(<></>);
-      ux.exit(1);
-    }
-  }
 
-  return {
-    dependencySoftwareId: dependencySoftware.data.id as string,
-    dependencyTargetVersionId: dependencyTargetVersion.id,
-  };
+    return {
+      dependencySoftwareId: dependencySoftware.data.id as string,
+      dependencyTargetVersionId: dependencyTargetVersion.id,
+    };
+  }
 }

From ea64924c701e9c3a233e334dcb1592b672521ec1 Mon Sep 17 00:00:00 2001
From: Michel Hopfner <m.hopfner@mittwald.de>
Date: Wed, 28 Aug 2024 11:05:02 +0200
Subject: [PATCH 07/11] remove debug output

---
 src/commands/app/upgrade.tsx | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/commands/app/upgrade.tsx b/src/commands/app/upgrade.tsx
index b2c35d964..f6bd863c3 100644
--- a/src/commands/app/upgrade.tsx
+++ b/src/commands/app/upgrade.tsx
@@ -304,7 +304,6 @@ async function updateMissingSystemSoftwareDependency(
     },
   });
   assertSuccess(dependencyVersionList);
-  console.log(dependencyVersionList);
 
   let dependencyTargetVersion: AppSystemSoftwareVersion = {
     id: "not yet set",

From c867315eb1553ccacbec38ad930b03b9b06ee712 Mon Sep 17 00:00:00 2001
From: Martin Helmich <m.helmich@mittwald.de>
Date: Thu, 29 Aug 2024 15:24:54 +0200
Subject: [PATCH 08/11] Use "assertStatus" instead of "assertSuccess"

---
 src/commands/app/upgrade.tsx | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/commands/app/upgrade.tsx b/src/commands/app/upgrade.tsx
index f6bd863c3..49ed10503 100644
--- a/src/commands/app/upgrade.tsx
+++ b/src/commands/app/upgrade.tsx
@@ -294,7 +294,7 @@ async function updateMissingSystemSoftwareDependency(
   const dependencySoftware = await apiClient.app.getSystemsoftware({
     systemSoftwareId: dependency.systemSoftwareId,
   });
-  assertSuccess(dependencySoftware);
+  assertStatus(dependencySoftware, 200);
 
   const dependencyVersionList = await apiClient.app.listSystemsoftwareversions({
     systemSoftwareId: dependency.systemSoftwareId,
@@ -303,7 +303,7 @@ async function updateMissingSystemSoftwareDependency(
       recommended: true,
     },
   });
-  assertSuccess(dependencyVersionList);
+  assertStatus(dependencyVersionList, 200);
 
   let dependencyTargetVersion: AppSystemSoftwareVersion = {
     id: "not yet set",

From 6297cf95eba63ee3c4671e952f3a4af3362056d5 Mon Sep 17 00:00:00 2001
From: Martin Helmich <m.helmich@mittwald.de>
Date: Thu, 29 Aug 2024 15:25:17 +0200
Subject: [PATCH 09/11] Remove unused parameter

---
 src/commands/app/upgrade.tsx | 2 --
 1 file changed, 2 deletions(-)

diff --git a/src/commands/app/upgrade.tsx b/src/commands/app/upgrade.tsx
index 49ed10503..5a5a6c015 100644
--- a/src/commands/app/upgrade.tsx
+++ b/src/commands/app/upgrade.tsx
@@ -207,7 +207,6 @@ export class UpgradeApp extends ExecRenderBaseCommand<typeof UpgradeApp, void> {
           await updateMissingSystemSoftwareDependency(
             process,
             this.apiClient,
-            appInstallationId,
             missingSystemSoftwareDependency,
           );
         appUpgradePayload.systemSoftware[
@@ -288,7 +287,6 @@ async function forceTargetVersionSelection(
 async function updateMissingSystemSoftwareDependency(
   process: ProcessRenderer,
   apiClient: MittwaldAPIV2Client,
-  appInstallationId: string,
   dependency: AppSystemSoftwareDependency,
 ) {
   const dependencySoftware = await apiClient.app.getSystemsoftware({

From 95300e5a39e6af544443b0a266d3679ed77f9faf Mon Sep 17 00:00:00 2001
From: martin-helmich <martin-helmich@users.noreply.github.com>
Date: Thu, 29 Aug 2024 13:26:18 +0000
Subject: [PATCH 10/11] chore: re-generate README

---
 docs/app.md | 40 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)

diff --git a/docs/app.md b/docs/app.md
index c328dbdf0..654f2b3ed 100644
--- a/docs/app.md
+++ b/docs/app.md
@@ -32,6 +32,7 @@ Manage apps, and app installations in your projects
 * [`mw app list-upgrade-candidates [INSTALLATION-ID]`](#mw-app-list-upgrade-candidates-installation-id)
 * [`mw app ssh [INSTALLATION-ID]`](#mw-app-ssh-installation-id)
 * [`mw app uninstall [INSTALLATION-ID]`](#mw-app-uninstall-installation-id)
+* [`mw app update [INSTALLATION-ID]`](#mw-app-update-installation-id)
 * [`mw app upgrade [INSTALLATION-ID]`](#mw-app-upgrade-installation-id)
 * [`mw app upload [INSTALLATION-ID]`](#mw-app-upload-installation-id)
 * [`mw app versions [APP]`](#mw-app-versions-app)
@@ -1923,6 +1924,45 @@ FLAG DESCRIPTIONS
     scripts), you can use this flag to easily get the IDs of created resources for further processing.
 ```
 
+## `mw app update [INSTALLATION-ID]`
+
+Update properties of an app installation (use 'upgrade' to update the app version)
+
+```
+USAGE
+  $ mw app update [INSTALLATION-ID] [-q] [--description <value>] [--entrypoint <value>] [--document-root <value>]
+
+ARGUMENTS
+  INSTALLATION-ID  ID or short ID of an app installation; this argument is optional if a default app installation is set
+                   in the context.
+
+FLAGS
+  -q, --quiet                  suppress process output and only display a machine-readable summary.
+      --description=<value>    update the description of the app installation
+      --document-root=<value>  update the document root of the app installation
+      --entrypoint=<value>     update the entrypoint of the app installation (Python and Node.js only)
+
+FLAG DESCRIPTIONS
+  -q, --quiet  suppress process output and only display a machine-readable summary.
+
+    This flag controls if you want to see the process output or only a summary. When using mw non-interactively (e.g. in
+    scripts), you can use this flag to easily get the IDs of created resources for further processing.
+
+  --description=<value>  update the description of the app installation
+
+    This flag updates the description of the app installation. If omitted, the description will not be changed.
+
+  --document-root=<value>  update the document root of the app installation
+
+    Updates the document root of the app installation. If omitted, the document root will not be changed. Note that not
+    all apps support this field.
+
+  --entrypoint=<value>  update the entrypoint of the app installation (Python and Node.js only)
+
+    Updates the entrypoint of the app installation. If omitted, the entrypoint will not be changed. Note that this field
+    is only available for some types of apps (like Python and Node.js).
+```
+
 ## `mw app upgrade [INSTALLATION-ID]`
 
 Upgrade app installation to target version

From e4ee1eae2c736b6886ddc0103ec32ca1e293bb54 Mon Sep 17 00:00:00 2001
From: Martin Helmich <m.helmich@mittwald.de>
Date: Thu, 29 Aug 2024 15:37:05 +0200
Subject: [PATCH 11/11] Remove unused import

---
 src/commands/app/upgrade.tsx | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/commands/app/upgrade.tsx b/src/commands/app/upgrade.tsx
index 5a5a6c015..042bb9376 100644
--- a/src/commands/app/upgrade.tsx
+++ b/src/commands/app/upgrade.tsx
@@ -27,7 +27,6 @@ import { MittwaldAPIV2, MittwaldAPIV2Client } from "@mittwald/api-client";
 import { waitUntilAppStateHasNormalized } from "../../lib/resources/app/wait.js";
 import { assertStatus } from "@mittwald/api-client-commons";
 import { waitFlags } from "../../lib/wait.js";
-import assertSuccess from "../../lib/apiutil/assert_success.js";
 import { ProcessFlags } from "../../rendering/process/process_flags.js";
 import semver from "semver/preload.js";