@salesforce/plugin-org 5.9.19 → 5.9.20

package/oclif.manifest.json

@@ -1145,15 +1145,16 @@
         "tracking:enable:org"
       ]
     },
-    "org:refresh:sandbox": {
-      "aliases": [],
+    "org:list:metadata-types": {
+      "aliases": [
+        "force:mdapi:describemetadata"
+      ],
       "args": {},
-      "description": "Refreshing a sandbox copies the metadata, and optionally data, from your source org to the refreshed sandbox org. You can optionally specify a definition file if you want to change the configuration of the refreshed sandbox, such as its license type or template ID. You can also use the --source-id or --source-sandbox-name flags to change the refreshed sandbox org's original source org to a new org; in this case, the refreshed sandbox org's metadata is updated with the new source org's metadata.\n\nYou're not allowed to change the sandbox name when you refresh it with this command. If you want to change the sandbox name, first delete it with the \"org delete sandbox\" command. And then recreate it with the \"org create sandbox\" command and give it a new name.",
+      "deprecateAliases": true,
+      "description": "The information includes Apex classes and triggers, custom objects, custom fields on standard objects, tab sets that define an app, and many other metadata types. Use this information to identify the syntax needed for a <name> element in a manifest file (package.xml).\n\nThe username that you use to connect to the org must have the Modify All Data or Modify Metadata Through Metadata API Functions permission.",
       "examples": [
-        "Refresh the sandbox named \"devSbx1\". The production org that contains the sandbox license has the alias \"prodOrg\".\n<%= config.bin %> <%= command.id %> --name devSbx1 --target-org prodOrg",
-        "Refresh the sandbox named \"devSbx2\", and override the configuration of the refreshed sandbox with the properties in the specified defintion file. The default target org is the production org, so you don't need to specify the `--target-org` flag in this case.\n<%= config.bin %> <%= command.id %> --name devSbx2 --definition-file devSbx2-config.json",
-        "Refresh the sandbox using the name defined in the definition file. The production org that contains the sandbox license has the alias \"prodOrg\".\n<%= config.bin %> <%= command.id %> --definition-file devSbx3-config.json --target-org prodOrg",
-        "Refresh the sandbox named \"devSbx2\" by changing its original source org to be a sandbox called \"devSbx3\":\n<%= config.bin %> <%= command.id %> --name devSbx2 --source-sandbox-name devSbx3 --target-org prodOrg"
+        "Display information about all known and enabled metadata types in the org with alias \"my-dev-org\" using API version 57.0:\n$ <%= config.bin %> <%= command.id %> --api-version 57.0 --target-org my-dev-org",
+        "Display only the metadata types that aren't yet supported by Salesforce CLI in your default org and write the results to the specified file:\n$ <%= config.bin %> <%= command.id %> --output-file /path/to/outputfilename.txt --filter-known"
       ],
       "flags": {
         "json": {
@@ -1171,142 +1172,115 @@
           "multiple": false,
           "type": "option"
         },
-        "no-auto-activate": {
-          "description": "By default, a sandbox auto-activates after a refresh. Use this flag to control sandbox activation manually.",
-          "name": "no-auto-activate",
-          "summary": "Disable auto-activation of the sandbox after a successful refresh.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "wait": {
-          "char": "w",
-          "description": "If the command continues to run after the wait period, the CLI returns control of the terminal to you and displays the \"<%= config.bin %> org resume sandbox\" command for you run to check the status of the refresh. The displayed command includes the job ID for the running sandbox refresh.",
-          "exclusive": [
-            "async"
-          ],
-          "name": "wait",
-          "summary": "Number of minutes to poll for sandbox refresh status.",
-          "hasDynamicHelp": true,
-          "helpValue": "<minutes>",
-          "multiple": false,
-          "type": "option"
-        },
-        "poll-interval": {
-          "char": "i",
-          "exclusive": [
-            "async"
-          ],
-          "name": "poll-interval",
-          "summary": "Number of seconds to wait between status polling requests.",
-          "hasDynamicHelp": true,
-          "helpValue": "<seconds>",
-          "multiple": false,
-          "type": "option"
-        },
-        "source-sandbox-name": {
-          "description": "The value of --source-sandbox-name must be an existing sandbox. The new source sandbox, and the refreshed sandbox specified with the --name flag, must both be associated with the production org (--target-org) that contains the sandbox licenses.\n\nYou can specify either --source-sandbox-name or --source-id when refreshing an existing sandbox, but not both.",
-          "exclusive": [
-            "source-id"
-          ],
-          "name": "source-sandbox-name",
-          "summary": "Name of the sandbox org that becomes the new source org for the refreshed sandbox.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "source-id": {
-          "description": "The value of --source-id must be an existing sandbox. The new source sandbox, and the refreshed sandbox specified with the --name flag, must both be associated with the production org (--target-org) that contains the sandbox licenses.\n\nYou can specify either --source-id or --source-sandbox-name when refreshing an existing sandbox, but not both.",
-          "exclusive": [
-            "source-sandbox-name"
-          ],
-          "name": "source-id",
-          "summary": "ID of the sandbox org that becomes the new source org for the refreshed sandbox.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "async": {
-          "description": "The command immediately displays the job ID and returns control of the terminal to you. This way, you can continue to use the CLI. To check the status of the sandbox refresh, run \"<%= config.bin %> org resume sandbox\".",
-          "exclusive": [
-            "wait",
-            "poll-interval"
+        "api-version": {
+          "aliases": [
+            "apiversion",
+            "a"
           ],
-          "name": "async",
-          "summary": "Request the sandbox refresh, but don't wait for it to complete.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "name": {
-          "char": "n",
-          "name": "name",
-          "summary": "Name of the existing sandbox org in your production org that you want to refresh.",
+          "deprecateAliases": true,
+          "description": "Override the api version used for api requests made by this command",
+          "name": "api-version",
+          "summary": "API version to use; default is the most recent API version.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "definition-file": {
-          "char": "f",
-          "description": "The sandbox definition file is a blueprint for the sandbox; use the file to change the sandbox configuration during a refresh. If you don't want to change the sandbox configuration when you refresh it, then simply use the --name flag to specify the sandbox and don't use this flag. See <https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_sandbox_definition.htm> for all the options you can specify in the definition file.",
-          "name": "definition-file",
-          "summary": "Path to a sandbox definition file for overriding its configuration when you refresh it.",
+        "loglevel": {
+          "deprecated": {
+            "message": "The loglevel flag is no longer in use on this command. You may use it without error, but it will be ignored.\nSet the log level using the `SFDX_LOG_LEVEL` environment variable."
+          },
+          "hidden": true,
+          "name": "loglevel",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "target-org": {
+          "aliases": [
+            "targetusername",
+            "u"
+          ],
           "char": "o",
+          "deprecateAliases": true,
           "name": "target-org",
           "noCacheDefault": true,
           "required": true,
-          "summary": "Username or alias of the production org that contains the sandbox license.",
+          "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
           "hasDynamicHelp": true,
           "multiple": false,
           "type": "option"
         },
-        "no-prompt": {
-          "name": "no-prompt",
-          "summary": "Don't prompt for confirmation about the sandbox refresh.",
+        "output-file": {
+          "aliases": [
+            "resultfile"
+          ],
+          "char": "f",
+          "deprecateAliases": true,
+          "description": "Directing the output to a file makes it easier to extract relevant information for your package.xml manifest file. The default output destination is the terminal or command window console.",
+          "name": "output-file",
+          "summary": "Pathname of the file in which to write the results.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "filter-known": {
+          "aliases": [
+            "filterknown"
+          ],
+          "char": "k",
+          "deprecateAliases": true,
+          "hidden": true,
+          "name": "filter-known",
+          "summary": "Filter the known metadata types from the result to display only the types not yet fully supported by Salesforce CLI.\n\nfilter metadata known by the CLI",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "org:refresh:sandbox",
+      "id": "org:list:metadata-types",
       "pluginAlias": "@salesforce/plugin-org",
       "pluginName": "@salesforce/plugin-org",
       "pluginType": "core",
       "strict": true,
-      "summary": "Refresh a sandbox org using the sandbox name.",
+      "summary": "Display details about the metadata types that are enabled for your org.",
+      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "org",
-        "refresh",
-        "sandbox.js"
+        "list",
+        "metadata-types.js"
+      ],
+      "aliasPermutations": [
+        "force:mdapi:describemetadata",
+        "mdapi:force:describemetadata",
+        "mdapi:describemetadata:force",
+        "force:describemetadata:mdapi",
+        "describemetadata:force:mdapi",
+        "describemetadata:mdapi:force"
       ],
-      "aliasPermutations": [],
       "permutations": [
-        "org:refresh:sandbox",
-        "refresh:org:sandbox",
-        "refresh:sandbox:org",
-        "org:sandbox:refresh",
-        "sandbox:org:refresh",
-        "sandbox:refresh:org"
+        "org:list:metadata-types",
+        "list:org:metadata-types",
+        "list:metadata-types:org",
+        "org:metadata-types:list",
+        "metadata-types:org:list",
+        "metadata-types:list:org"
       ]
     },
-    "org:resume:sandbox": {
+    "org:list:metadata": {
       "aliases": [
-        "env:resume:sandbox"
+        "force:mdapi:listmetadata"
       ],
       "args": {},
       "deprecateAliases": true,
-      "description": "Sandbox creation can take a long time. If the original \"<%= config.bin %> org create sandbox\" command either times out, or you specified the --async flag, the command displays a job ID. Use this job ID to check whether the sandbox creation is complete, and if it is, the command then logs into it.\n\nYou can also use the sandbox name to check the status or the --use-most-recent flag to use the job ID of the most recent sandbox creation.",
+      "description": "Use this command to identify individual components in your manifest file or if you want a high-level view of particular metadata types in your org. For example, you can use this command to return a list of names of all the CustomObject or Layout components in your org, then use this information in a retrieve command that returns a subset of these components.\n\nThe username that you use to connect to the org must have the Modify All Data or Modify Metadata Through Metadata API Functions permission.",
       "examples": [
-        "Check the status of a sandbox creation using its name and specify a production org with alias \"prodOrg\":\n<%= config.bin %> <%= command.id %> --name mysandbox --target-org prodOrg",
-        "Check the status using the job ID:\n<%= config.bin %> <%= command.id %> --job-id 0GRxxxxxxxx",
-        "Check the status of the most recent sandbox create request:\n<%= config.bin %> <%= command.id %> --use-most-recent"
+        "List the CustomObject components, and their properties, in the org with alias \"my-dev-org\":\n$ <%= config.bin %> <%= command.id %> --metadata-type CustomObject --target-org my-dev-org",
+        "List the CustomObject components in your default org, write the output to the specified file, and use API version 57.0:\n$ <%= config.bin %> <%= command.id %> --metadata-type CustomObject --api-version 57.0 --output-file /path/to/outputfilename.txt",
+        "List the Dashboard components in your default org that are contained in the \"folderSales\" folder, write the output to the specified file, and use API version 57.0:\n$ <%= config.bin %> <%= command.id %> --metadata-type Dashboard --folder folderSales --api-version 57.0 --output-file /path/to/outputfilename.txt"
       ],
       "flags": {
         "json": {
@@ -1324,178 +1298,110 @@
           "multiple": false,
           "type": "option"
         },
-        "wait": {
-          "char": "w",
-          "description": "If the command continues to run after the wait period, the CLI returns control of the terminal window to you and returns the job ID. To resume checking the sandbox creation, rerun this command.",
-          "name": "wait",
-          "summary": "Number of minutes to wait for the sandbox org to be ready.",
-          "default": "0 minutes",
-          "hasDynamicHelp": true,
-          "helpValue": "<minutes>",
-          "multiple": false,
-          "type": "option"
-        },
-        "name": {
-          "char": "n",
-          "exclusive": [
-            "job-id"
+        "api-version": {
+          "aliases": [
+            "apiversion",
+            "a"
           ],
-          "name": "name",
-          "summary": "Name of the sandbox org.",
+          "deprecateAliases": true,
+          "description": "Override the api version used for api requests made by this command",
+          "name": "api-version",
+          "summary": "API version to use; default is the most recent API version.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "job-id": {
-          "char": "i",
-          "description": "The job ID is valid for 24 hours after you start the sandbox creation.",
-          "exclusive": [
-            "name"
-          ],
-          "name": "job-id",
-          "summary": "Job ID of the incomplete sandbox creation that you want to check the status of.",
+        "loglevel": {
+          "deprecated": {
+            "message": "The loglevel flag is no longer in use on this command. You may use it without error, but it will be ignored.\nSet the log level using the `SFDX_LOG_LEVEL` environment variable."
+          },
+          "hidden": true,
+          "name": "loglevel",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "use-most-recent": {
-          "char": "l",
-          "name": "use-most-recent",
-          "summary": "Use the most recent sandbox create request.",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "target-org": {
+          "aliases": [
+            "targetusername",
+            "u"
+          ],
           "char": "o",
-          "description": "When it creates the sandbox org, Salesforce copies the metadata, and optionally data, from your production org to the new sandbox org.",
+          "deprecateAliases": true,
           "name": "target-org",
           "noCacheDefault": true,
-          "summary": "Username or alias of the production org that contains the sandbox license.",
+          "required": true,
+          "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
           "hasDynamicHelp": true,
           "multiple": false,
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": true,
-      "hiddenAliases": [],
-      "id": "org:resume:sandbox",
-      "pluginAlias": "@salesforce/plugin-org",
-      "pluginName": "@salesforce/plugin-org",
-      "pluginType": "core",
-      "strict": true,
-      "summary": "Check the status of a sandbox creation, and log in to it if it's ready.",
-      "isESM": true,
-      "relativePath": [
-        "lib",
-        "commands",
-        "org",
-        "resume",
-        "sandbox.js"
-      ],
-      "aliasPermutations": [
-        "env:resume:sandbox",
-        "resume:env:sandbox",
-        "resume:sandbox:env",
-        "env:sandbox:resume",
-        "sandbox:env:resume",
-        "sandbox:resume:env"
-      ],
-      "permutations": [
-        "org:resume:sandbox",
-        "resume:org:sandbox",
-        "resume:sandbox:org",
-        "org:sandbox:resume",
-        "sandbox:org:resume",
-        "sandbox:resume:org"
-      ]
-    },
-    "org:resume:scratch": {
-      "aliases": [
-        "env:resume:scratch"
-      ],
-      "args": {},
-      "deprecateAliases": true,
-      "description": "When the original \"<%= config.bin %> org create scratch\" command either times out or is run with the --async flag, it displays a job ID.\n\nRun this command by either passing it a job ID or using the --use-most-recent flag to specify the most recent incomplete scratch org.",
-      "examples": [
-        "Resume a scratch org create with a job ID:\n<%= config.bin %> <%= command.id %> --job-id 2SR3u0000008fBDGAY",
-        "Resume your most recent incomplete scratch org:\n<%= config.bin %> <%= command.id %> --use-most-recent"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
         },
-        "flags-dir": {
-          "helpGroup": "GLOBAL",
-          "name": "flags-dir",
-          "summary": "Import flag values from a directory.",
+        "output-file": {
+          "aliases": [
+            "resultfile"
+          ],
+          "char": "f",
+          "deprecateAliases": true,
+          "name": "output-file",
+          "summary": "Pathname of the file in which to write the results.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "job-id": {
-          "char": "i",
-          "description": "The job ID is the same as the record ID of the incomplete scratch org in the ScratchOrgInfo object of the Dev Hub.\n\nThe job ID is valid for 24 hours after you start the scratch org creation.",
-          "name": "job-id",
-          "summary": "Job ID of the incomplete scratch org create that you want to resume.",
+        "metadata-type": {
+          "aliases": [
+            "metadatatype"
+          ],
+          "char": "m",
+          "deprecateAliases": true,
+          "name": "metadata-type",
+          "required": true,
+          "summary": "Metadata type to be retrieved, such as CustomObject; metadata type names are case-sensitive.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "use-most-recent": {
-          "char": "r",
-          "name": "use-most-recent",
-          "summary": "Use the job ID of the most recent incomplete scratch org.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "wait": {
-          "char": "w",
-          "description": "If the command continues to run after the wait period, the CLI returns control of the terminal window to you and returns the job ID. To resume checking the scratch creation, rerun this command.",
-          "name": "wait",
-          "summary": "Number of minutes to wait for the scratch org to be ready.",
-          "default": "0 minutes",
-          "hasDynamicHelp": true,
-          "helpValue": "<minutes>",
+        "folder": {
+          "description": "Examples of metadata types that use folders are Dashboard, Document, EmailTemplate, and Report.",
+          "name": "folder",
+          "summary": "Folder associated with the component; required for components that use folders; folder names are case-sensitive.",
+          "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "org:resume:scratch",
+      "id": "org:list:metadata",
       "pluginAlias": "@salesforce/plugin-org",
       "pluginName": "@salesforce/plugin-org",
       "pluginType": "core",
       "strict": true,
-      "summary": "Resume the creation of an incomplete scratch org.",
+      "summary": "List the metadata components and properties of a specified type.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "org",
-        "resume",
-        "scratch.js"
+        "list",
+        "metadata.js"
       ],
       "aliasPermutations": [
-        "env:resume:scratch",
-        "resume:env:scratch",
-        "resume:scratch:env",
-        "env:scratch:resume",
-        "scratch:env:resume",
-        "scratch:resume:env"
+        "force:mdapi:listmetadata",
+        "mdapi:force:listmetadata",
+        "mdapi:listmetadata:force",
+        "force:listmetadata:mdapi",
+        "listmetadata:force:mdapi",
+        "listmetadata:mdapi:force"
       ],
       "permutations": [
-        "org:resume:scratch",
-        "resume:org:scratch",
-        "resume:scratch:org",
-        "org:scratch:resume",
-        "scratch:org:resume",
-        "scratch:resume:org"
+        "org:list:metadata",
+        "list:org:metadata",
+        "list:metadata:org",
+        "org:metadata:list",
+        "metadata:org:list",
+        "metadata:list:org"
       ]
     },
     "org:open:agent": {
@@ -1615,16 +1521,168 @@
         "agent:open:org"
       ]
     },
-    "org:list:metadata-types": {
+    "org:refresh:sandbox": {
+      "aliases": [],
+      "args": {},
+      "description": "Refreshing a sandbox copies the metadata, and optionally data, from your source org to the refreshed sandbox org. You can optionally specify a definition file if you want to change the configuration of the refreshed sandbox, such as its license type or template ID. You can also use the --source-id or --source-sandbox-name flags to change the refreshed sandbox org's original source org to a new org; in this case, the refreshed sandbox org's metadata is updated with the new source org's metadata.\n\nYou're not allowed to change the sandbox name when you refresh it with this command. If you want to change the sandbox name, first delete it with the \"org delete sandbox\" command. And then recreate it with the \"org create sandbox\" command and give it a new name.",
+      "examples": [
+        "Refresh the sandbox named \"devSbx1\". The production org that contains the sandbox license has the alias \"prodOrg\".\n<%= config.bin %> <%= command.id %> --name devSbx1 --target-org prodOrg",
+        "Refresh the sandbox named \"devSbx2\", and override the configuration of the refreshed sandbox with the properties in the specified defintion file. The default target org is the production org, so you don't need to specify the `--target-org` flag in this case.\n<%= config.bin %> <%= command.id %> --name devSbx2 --definition-file devSbx2-config.json",
+        "Refresh the sandbox using the name defined in the definition file. The production org that contains the sandbox license has the alias \"prodOrg\".\n<%= config.bin %> <%= command.id %> --definition-file devSbx3-config.json --target-org prodOrg",
+        "Refresh the sandbox named \"devSbx2\" by changing its original source org to be a sandbox called \"devSbx3\":\n<%= config.bin %> <%= command.id %> --name devSbx2 --source-sandbox-name devSbx3 --target-org prodOrg"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "no-auto-activate": {
+          "description": "By default, a sandbox auto-activates after a refresh. Use this flag to control sandbox activation manually.",
+          "name": "no-auto-activate",
+          "summary": "Disable auto-activation of the sandbox after a successful refresh.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "wait": {
+          "char": "w",
+          "description": "If the command continues to run after the wait period, the CLI returns control of the terminal to you and displays the \"<%= config.bin %> org resume sandbox\" command for you run to check the status of the refresh. The displayed command includes the job ID for the running sandbox refresh.",
+          "exclusive": [
+            "async"
+          ],
+          "name": "wait",
+          "summary": "Number of minutes to poll for sandbox refresh status.",
+          "hasDynamicHelp": true,
+          "helpValue": "<minutes>",
+          "multiple": false,
+          "type": "option"
+        },
+        "poll-interval": {
+          "char": "i",
+          "exclusive": [
+            "async"
+          ],
+          "name": "poll-interval",
+          "summary": "Number of seconds to wait between status polling requests.",
+          "hasDynamicHelp": true,
+          "helpValue": "<seconds>",
+          "multiple": false,
+          "type": "option"
+        },
+        "source-sandbox-name": {
+          "description": "The value of --source-sandbox-name must be an existing sandbox. The new source sandbox, and the refreshed sandbox specified with the --name flag, must both be associated with the production org (--target-org) that contains the sandbox licenses.\n\nYou can specify either --source-sandbox-name or --source-id when refreshing an existing sandbox, but not both.",
+          "exclusive": [
+            "source-id"
+          ],
+          "name": "source-sandbox-name",
+          "summary": "Name of the sandbox org that becomes the new source org for the refreshed sandbox.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "source-id": {
+          "description": "The value of --source-id must be an existing sandbox. The new source sandbox, and the refreshed sandbox specified with the --name flag, must both be associated with the production org (--target-org) that contains the sandbox licenses.\n\nYou can specify either --source-id or --source-sandbox-name when refreshing an existing sandbox, but not both.",
+          "exclusive": [
+            "source-sandbox-name"
+          ],
+          "name": "source-id",
+          "summary": "ID of the sandbox org that becomes the new source org for the refreshed sandbox.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "async": {
+          "description": "The command immediately displays the job ID and returns control of the terminal to you. This way, you can continue to use the CLI. To check the status of the sandbox refresh, run \"<%= config.bin %> org resume sandbox\".",
+          "exclusive": [
+            "wait",
+            "poll-interval"
+          ],
+          "name": "async",
+          "summary": "Request the sandbox refresh, but don't wait for it to complete.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "name": {
+          "char": "n",
+          "name": "name",
+          "summary": "Name of the existing sandbox org in your production org that you want to refresh.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "definition-file": {
+          "char": "f",
+          "description": "The sandbox definition file is a blueprint for the sandbox; use the file to change the sandbox configuration during a refresh. If you don't want to change the sandbox configuration when you refresh it, then simply use the --name flag to specify the sandbox and don't use this flag. See <https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_sandbox_definition.htm> for all the options you can specify in the definition file.",
+          "name": "definition-file",
+          "summary": "Path to a sandbox definition file for overriding its configuration when you refresh it.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "target-org": {
+          "char": "o",
+          "name": "target-org",
+          "noCacheDefault": true,
+          "required": true,
+          "summary": "Username or alias of the production org that contains the sandbox license.",
+          "hasDynamicHelp": true,
+          "multiple": false,
+          "type": "option"
+        },
+        "no-prompt": {
+          "name": "no-prompt",
+          "summary": "Don't prompt for confirmation about the sandbox refresh.",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": true,
+      "hiddenAliases": [],
+      "id": "org:refresh:sandbox",
+      "pluginAlias": "@salesforce/plugin-org",
+      "pluginName": "@salesforce/plugin-org",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Refresh a sandbox org using the sandbox name.",
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "org",
+        "refresh",
+        "sandbox.js"
+      ],
+      "aliasPermutations": [],
+      "permutations": [
+        "org:refresh:sandbox",
+        "refresh:org:sandbox",
+        "refresh:sandbox:org",
+        "org:sandbox:refresh",
+        "sandbox:org:refresh",
+        "sandbox:refresh:org"
+      ]
+    },
+    "org:resume:sandbox": {
       "aliases": [
-        "force:mdapi:describemetadata"
+        "env:resume:sandbox"
       ],
       "args": {},
       "deprecateAliases": true,
-      "description": "The information includes Apex classes and triggers, custom objects, custom fields on standard objects, tab sets that define an app, and many other metadata types. Use this information to identify the syntax needed for a <name> element in a manifest file (package.xml).\n\nThe username that you use to connect to the org must have the Modify All Data or Modify Metadata Through Metadata API Functions permission.",
+      "description": "Sandbox creation can take a long time. If the original \"<%= config.bin %> org create sandbox\" command either times out, or you specified the --async flag, the command displays a job ID. Use this job ID to check whether the sandbox creation is complete, and if it is, the command then logs into it.\n\nYou can also use the sandbox name to check the status or the --use-most-recent flag to use the job ID of the most recent sandbox creation.",
       "examples": [
-        "Display information about all known and enabled metadata types in the org with alias \"my-dev-org\" using API version 57.0:\n$ <%= config.bin %> <%= command.id %> --api-version 57.0 --target-org my-dev-org",
-        "Display only the metadata types that aren't yet supported by Salesforce CLI in your default org and write the results to the specified file:\n$ <%= config.bin %> <%= command.id %> --output-file /path/to/outputfilename.txt --filter-known"
+        "Check the status of a sandbox creation using its name and specify a production org with alias \"prodOrg\":\n<%= config.bin %> <%= command.id %> --name mysandbox --target-org prodOrg",
+        "Check the status using the job ID:\n<%= config.bin %> <%= command.id %> --job-id 0GRxxxxxxxx",
+        "Check the status of the most recent sandbox create request:\n<%= config.bin %> <%= command.id %> --use-most-recent"
       ],
       "flags": {
         "json": {
@@ -1642,115 +1700,101 @@
           "multiple": false,
           "type": "option"
         },
-        "api-version": {
-          "aliases": [
-            "apiversion",
-            "a"
+        "wait": {
+          "char": "w",
+          "description": "If the command continues to run after the wait period, the CLI returns control of the terminal window to you and returns the job ID. To resume checking the sandbox creation, rerun this command.",
+          "name": "wait",
+          "summary": "Number of minutes to wait for the sandbox org to be ready.",
+          "default": "0 minutes",
+          "hasDynamicHelp": true,
+          "helpValue": "<minutes>",
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "char": "n",
+          "exclusive": [
+            "job-id"
           ],
-          "deprecateAliases": true,
-          "description": "Override the api version used for api requests made by this command",
-          "name": "api-version",
-          "summary": "API version to use; default is the most recent API version.",
+          "name": "name",
+          "summary": "Name of the sandbox org.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "loglevel": {
-          "deprecated": {
-            "message": "The loglevel flag is no longer in use on this command. You may use it without error, but it will be ignored.\nSet the log level using the `SFDX_LOG_LEVEL` environment variable."
-          },
-          "hidden": true,
-          "name": "loglevel",
+        "job-id": {
+          "char": "i",
+          "description": "The job ID is valid for 24 hours after you start the sandbox creation.",
+          "exclusive": [
+            "name"
+          ],
+          "name": "job-id",
+          "summary": "Job ID of the incomplete sandbox creation that you want to check the status of.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
+        "use-most-recent": {
+          "char": "l",
+          "name": "use-most-recent",
+          "summary": "Use the most recent sandbox create request.",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "target-org": {
-          "aliases": [
-            "targetusername",
-            "u"
-          ],
           "char": "o",
-          "deprecateAliases": true,
+          "description": "When it creates the sandbox org, Salesforce copies the metadata, and optionally data, from your production org to the new sandbox org.",
           "name": "target-org",
           "noCacheDefault": true,
-          "required": true,
-          "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
+          "summary": "Username or alias of the production org that contains the sandbox license.",
           "hasDynamicHelp": true,
           "multiple": false,
           "type": "option"
-        },
-        "output-file": {
-          "aliases": [
-            "resultfile"
-          ],
-          "char": "f",
-          "deprecateAliases": true,
-          "description": "Directing the output to a file makes it easier to extract relevant information for your package.xml manifest file. The default output destination is the terminal or command window console.",
-          "name": "output-file",
-          "summary": "Pathname of the file in which to write the results.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "filter-known": {
-          "aliases": [
-            "filterknown"
-          ],
-          "char": "k",
-          "deprecateAliases": true,
-          "hidden": true,
-          "name": "filter-known",
-          "summary": "Filter the known metadata types from the result to display only the types not yet fully supported by Salesforce CLI.\n\nfilter metadata known by the CLI",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "org:list:metadata-types",
+      "id": "org:resume:sandbox",
       "pluginAlias": "@salesforce/plugin-org",
       "pluginName": "@salesforce/plugin-org",
       "pluginType": "core",
       "strict": true,
-      "summary": "Display details about the metadata types that are enabled for your org.",
-      "enableJsonFlag": true,
+      "summary": "Check the status of a sandbox creation, and log in to it if it's ready.",
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "org",
-        "list",
-        "metadata-types.js"
+        "resume",
+        "sandbox.js"
       ],
       "aliasPermutations": [
-        "force:mdapi:describemetadata",
-        "mdapi:force:describemetadata",
-        "mdapi:describemetadata:force",
-        "force:describemetadata:mdapi",
-        "describemetadata:force:mdapi",
-        "describemetadata:mdapi:force"
+        "env:resume:sandbox",
+        "resume:env:sandbox",
+        "resume:sandbox:env",
+        "env:sandbox:resume",
+        "sandbox:env:resume",
+        "sandbox:resume:env"
       ],
       "permutations": [
-        "org:list:metadata-types",
-        "list:org:metadata-types",
-        "list:metadata-types:org",
-        "org:metadata-types:list",
-        "metadata-types:org:list",
-        "metadata-types:list:org"
+        "org:resume:sandbox",
+        "resume:org:sandbox",
+        "resume:sandbox:org",
+        "org:sandbox:resume",
+        "sandbox:org:resume",
+        "sandbox:resume:org"
       ]
     },
-    "org:list:metadata": {
+    "org:resume:scratch": {
       "aliases": [
-        "force:mdapi:listmetadata"
+        "env:resume:scratch"
       ],
       "args": {},
       "deprecateAliases": true,
-      "description": "Use this command to identify individual components in your manifest file or if you want a high-level view of particular metadata types in your org. For example, you can use this command to return a list of names of all the CustomObject or Layout components in your org, then use this information in a retrieve command that returns a subset of these components.\n\nThe username that you use to connect to the org must have the Modify All Data or Modify Metadata Through Metadata API Functions permission.",
+      "description": "When the original \"<%= config.bin %> org create scratch\" command either times out or is run with the --async flag, it displays a job ID.\n\nRun this command by either passing it a job ID or using the --use-most-recent flag to specify the most recent incomplete scratch org.",
       "examples": [
-        "List the CustomObject components, and their properties, in the org with alias \"my-dev-org\":\n$ <%= config.bin %> <%= command.id %> --metadata-type CustomObject --target-org my-dev-org",
-        "List the CustomObject components in your default org, write the output to the specified file, and use API version 57.0:\n$ <%= config.bin %> <%= command.id %> --metadata-type CustomObject --api-version 57.0 --output-file /path/to/outputfilename.txt",
-        "List the Dashboard components in your default org that are contained in the \"folderSales\" folder, write the output to the specified file, and use API version 57.0:\n$ <%= config.bin %> <%= command.id %> --metadata-type Dashboard --folder folderSales --api-version 57.0 --output-file /path/to/outputfilename.txt"
+        "Resume a scratch org create with a job ID:\n<%= config.bin %> <%= command.id %> --job-id 2SR3u0000008fBDGAY",
+        "Resume your most recent incomplete scratch org:\n<%= config.bin %> <%= command.id %> --use-most-recent"
       ],
       "flags": {
         "json": {
@@ -1768,112 +1812,68 @@
           "multiple": false,
           "type": "option"
         },
-        "api-version": {
-          "aliases": [
-            "apiversion",
-            "a"
-          ],
-          "deprecateAliases": true,
-          "description": "Override the api version used for api requests made by this command",
-          "name": "api-version",
-          "summary": "API version to use; default is the most recent API version.",
+        "job-id": {
+          "char": "i",
+          "description": "The job ID is the same as the record ID of the incomplete scratch org in the ScratchOrgInfo object of the Dev Hub.\n\nThe job ID is valid for 24 hours after you start the scratch org creation.",
+          "name": "job-id",
+          "summary": "Job ID of the incomplete scratch org create that you want to resume.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "loglevel": {
-          "deprecated": {
-            "message": "The loglevel flag is no longer in use on this command. You may use it without error, but it will be ignored.\nSet the log level using the `SFDX_LOG_LEVEL` environment variable."
-          },
-          "hidden": true,
-          "name": "loglevel",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "use-most-recent": {
+          "char": "r",
+          "name": "use-most-recent",
+          "summary": "Use the job ID of the most recent incomplete scratch org.",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "target-org": {
-          "aliases": [
-            "targetusername",
-            "u"
-          ],
-          "char": "o",
-          "deprecateAliases": true,
-          "name": "target-org",
-          "noCacheDefault": true,
-          "required": true,
-          "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
+        "wait": {
+          "char": "w",
+          "description": "If the command continues to run after the wait period, the CLI returns control of the terminal window to you and returns the job ID. To resume checking the scratch creation, rerun this command.",
+          "name": "wait",
+          "summary": "Number of minutes to wait for the scratch org to be ready.",
+          "default": "0 minutes",
           "hasDynamicHelp": true,
-          "multiple": false,
-          "type": "option"
-        },
-        "output-file": {
-          "aliases": [
-            "resultfile"
-          ],
-          "char": "f",
-          "deprecateAliases": true,
-          "name": "output-file",
-          "summary": "Pathname of the file in which to write the results.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "metadata-type": {
-          "aliases": [
-            "metadatatype"
-          ],
-          "char": "m",
-          "deprecateAliases": true,
-          "name": "metadata-type",
-          "required": true,
-          "summary": "Metadata type to be retrieved, such as CustomObject; metadata type names are case-sensitive.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "folder": {
-          "description": "Examples of metadata types that use folders are Dashboard, Document, EmailTemplate, and Report.",
-          "name": "folder",
-          "summary": "Folder associated with the component; required for components that use folders; folder names are case-sensitive.",
-          "hasDynamicHelp": false,
+          "helpValue": "<minutes>",
           "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "org:list:metadata",
+      "id": "org:resume:scratch",
       "pluginAlias": "@salesforce/plugin-org",
       "pluginName": "@salesforce/plugin-org",
       "pluginType": "core",
       "strict": true,
-      "summary": "List the metadata components and properties of a specified type.",
+      "summary": "Resume the creation of an incomplete scratch org.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "org",
-        "list",
-        "metadata.js"
+        "resume",
+        "scratch.js"
       ],
       "aliasPermutations": [
-        "force:mdapi:listmetadata",
-        "mdapi:force:listmetadata",
-        "mdapi:listmetadata:force",
-        "force:listmetadata:mdapi",
-        "listmetadata:force:mdapi",
-        "listmetadata:mdapi:force"
+        "env:resume:scratch",
+        "resume:env:scratch",
+        "resume:scratch:env",
+        "env:scratch:resume",
+        "scratch:env:resume",
+        "scratch:resume:env"
       ],
       "permutations": [
-        "org:list:metadata",
-        "list:org:metadata",
-        "list:metadata:org",
-        "org:metadata:list",
-        "metadata:org:list",
-        "metadata:list:org"
+        "org:resume:scratch",
+        "resume:org:scratch",
+        "resume:scratch:org",
+        "org:scratch:resume",
+        "scratch:org:resume",
+        "scratch:resume:org"
       ]
     }
   },
-  "version": "5.9.19"
+  "version": "5.9.20"
 }