docs: remove start-cluster command + update start options (#12116)

www/apps/resources/app/medusa-cli/commands/start-cluster/page.mdx

@@ -1,85 +0,0 @@
----
-sidebar_label: "start-cluster"
-sidebar_position: 8
----
-
-import { Table } from "docs-ui"
-
-export const metadata = {
-  title: `start-cluster Command - Medusa CLI Reference`,
-}
-
-# {metadata.title}
-
-Starts the Medusa application in [cluster mode](https://expressjs.com/en/advanced/best-practice-performance.html#run-your-app-in-a-cluster).
-
-Running in cluster mode significantly improves performance as the workload and tasks are distributed among all available instances instead of a single one.
-
-```bash
-npx medusa start-cluster
-```
-
-#### Options
-
-<Table>
-  <Table.Header>
-    <Table.Row>
-      <Table.HeaderCell>Option</Table.HeaderCell>
-      <Table.HeaderCell>Description</Table.HeaderCell>
-      <Table.HeaderCell>Default</Table.HeaderCell>
-    </Table.Row>
-  </Table.Header>
-  <Table.Body>
-    <Table.Row>
-      <Table.Cell>
-      
-      `-c <number>`, `--cpus <number>`
-      
-      </Table.Cell>
-      <Table.Cell>
-
-      The number of CPUs that Medusa can consume.
-      
-      </Table.Cell>
-      <Table.Cell>
-
-      Medusa will try to consume all CPUs.
-
-      </Table.Cell>
-    </Table.Row>
-    <Table.Row>
-      <Table.Cell>
-      
-      `-H <host>`, `--host <host>`
-      
-      </Table.Cell>
-      <Table.Cell>
-
-      Set host of the Medusa server.
-      
-      </Table.Cell>
-      <Table.Cell>
-
-      `localhost`
-
-      </Table.Cell>
-    </Table.Row>
-    <Table.Row>
-      <Table.Cell>
-      
-      `-p <port>`, `--port <port>`
-      
-      </Table.Cell>
-      <Table.Cell>
-
-      Set port of the Medusa server.
-      
-      </Table.Cell>
-      <Table.Cell>
-
-      `9000`
-
-      </Table.Cell>
-    </Table.Row>
-  </Table.Body>
-</Table>

www/apps/resources/app/medusa-cli/commands/start/page.mdx

@@ -60,6 +60,23 @@ npx medusa start
 
       `9000`
 
+      </Table.Cell>
+    </Table.Row>
+    <Table.Row>
+      <Table.Cell>
+      
+      `--cluster <number>`
+      
+      </Table.Cell>
+      <Table.Cell>
+
+      Start Medusa's Node.js server in [cluster mode](https://expressjs.com/en/advanced/best-practice-performance.html#run-your-app-in-a-cluster). Running in cluster mode significantly improves performance as the workload and tasks are distributed among all available instances instead of a single one.
+      
+      </Table.Cell>
+      <Table.Cell>
+
+      Cluster mode is disabled by default. If the option is passed but no number is passed, Medusa will try to consume all available CPU cores.
+
       </Table.Cell>
     </Table.Row>
   </Table.Body>

www/apps/resources/generated/edit-dates.mjs

@@ -570,8 +570,7 @@ export const generatedEditDates = {
   "app/medusa-cli/commands/develop/page.mdx": "2024-08-28T10:43:45.452Z",
   "app/medusa-cli/commands/exec/page.mdx": "2025-01-16T09:51:17.050Z",
   "app/medusa-cli/commands/new/page.mdx": "2024-08-28T10:43:34.110Z",
-  "app/medusa-cli/commands/start-cluster/page.mdx": "2025-01-16T09:51:19.838Z",
+  "app/medusa-cli/commands/start/page.mdx": "2025-04-08T11:56:15.522Z",
-  "app/medusa-cli/commands/start/page.mdx": "2024-08-28T10:44:19.952Z",
   "app/medusa-cli/commands/telemtry/page.mdx": "2025-01-16T09:51:24.323Z",
   "app/medusa-cli/commands/user/page.mdx": "2024-08-28T10:44:52.489Z",
   "app/recipes/marketplace/examples/restaurant-delivery/page.mdx": "2025-03-11T12:10:06.352Z",

www/apps/resources/generated/files-map.mjs

@@ -883,10 +883,6 @@ export const filesMap = [
     "filePath": "/www/apps/resources/app/medusa-cli/commands/start/page.mdx",
     "pathname": "/medusa-cli/commands/start"
   },
-  {
-    "filePath": "/www/apps/resources/app/medusa-cli/commands/start-cluster/page.mdx",
-    "pathname": "/medusa-cli/commands/start-cluster"
-  },
   {
     "filePath": "/www/apps/resources/app/medusa-cli/commands/telemtry/page.mdx",
     "pathname": "/medusa-cli/commands/telemtry"

www/apps/resources/generated/generated-tools-sidebar.mjs

@@ -125,15 +125,6 @@ const generatedgeneratedToolsSidebarSidebar = {
                   "description": "",
                   "children": []
                 },
-                {
-                  "loaded": true,
-                  "isPathHref": true,
-                  "type": "link",
-                  "path": "/medusa-cli/commands/start-cluster",
-                  "title": "start-cluster",
-                  "description": "",
-                  "children": []
-                },
                 {
                   "loaded": true,
                   "isPathHref": true,

www/apps/resources/next.config.mjs

@@ -163,6 +163,11 @@ const nextConfig = {
         destination: "/troubleshooting/workflow-errors/when-then",
         permanent: true,
       },
+      {
+        source: "/medusa-cli/commands/start-cluster",
+        destination: "/medusa-cli/commands/start",
+        permanent: true,
+      },
     ]
   },
   outputFileTracingExcludes: {