@salesforce/plugin-org 5.9.0 → 5.9.2

package/oclif.manifest.json

@@ -385,17 +385,18 @@
         "open:org"
       ]
     },
-    "org:delete:sandbox": {
+    "org:create:sandbox": {
       "aliases": [
-        "env:delete:sandbox"
+        "env:create:sandbox"
       ],
       "args": {},
       "deprecateAliases": true,
-      "description": "Salesforce CLI marks the org for deletion in the production org that contains the sandbox licenses and then deletes all local references to the org from your computer.\nSpecify a sandbox with either the username you used when you logged into it, or the alias you gave the sandbox when you created it. Run \"<%= config.bin %> org list\" to view all your orgs, including sandboxes, and their aliases.\nBoth the sandbox and the associated production org must already be authenticated with the CLI to successfully delete the sandbox.",
+      "description": "There are two ways to create a sandbox org: specify a definition file that contains the sandbox options or use the --name and --license-type flags to specify the two required options. If you want to set an option other than name or license type, such as apexClassId, you must use a definition file.\n\nYou can also use this command to clone an existing sandbox. Use the --source-sandbox-name flag to specify the existing sandbox name and the --name flag to the name of the new sandbox.",
       "examples": [
-        "Delete a sandbox with alias my-sandbox:\n<%= config.bin %> <%= command.id %> --target-org my-sandbox",
-        "Specify a username instead of an alias:\n<%= config.bin %> <%= command.id %> --target-org myusername@example.com.qa",
-        "Delete the sandbox without prompting to confirm:\n<%= config.bin %> <%= command.id %> --target-org my-sandbox --no-prompt"
+        "Create a sandbox org using a definition file and give it the alias \"MyDevSandbox\". The production org that contains the sandbox license has the alias \"prodOrg\".\n<%= config.bin %> <%= command.id %> --definition-file config/dev-sandbox-def.json --alias MyDevSandbox --target-org prodOrg",
+        "Create a sandbox org by directly specifying its name and type of license (Developer) instead of using a definition file. Set the sandbox org as your default.\n<%= config.bin %> <%= command.id %> --name mysandbox --license-type Developer --alias MyDevSandbox --target-org prodOrg --set-default",
+        "Clone the existing sandbox with name \"ExistingSandbox\" and name the new sandbox \"NewClonedSandbox\". Set the new sandbox as your default org. Wait for 30 minutes for the sandbox creation to complete.\n<%= config.bin %> <%= command.id %> --source-sandbox-name ExistingSandbox --name NewClonedSandbox --target-org prodOrg --alias MyDevSandbox --set-default --wait 30",
+        "Clone the existing sandbox with ID \"0GQB0000000TVobOAG\" and do not wait.\n<%= config.bin %> <%= command.id %> --source-id 0GQB0000000TVobOAG --name SbxClone --target-org prodOrg --async"
       ],
       "flags": {
         "json": {
@@ -413,154 +414,193 @@
           "multiple": false,
           "type": "option"
         },
-        "target-org": {
-          "aliases": [
-            "targetusername",
-            "u"
-          ],
-          "char": "o",
-          "deprecateAliases": true,
-          "name": "target-org",
-          "required": true,
-          "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
-          "hasDynamicHelp": true,
+        "definition-file": {
+          "char": "f",
+          "description": "The sandbox definition file is a blueprint for the sandbox. You can create different definition files for each sandbox type that you use in the development process. 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.",
+          "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "no-prompt": {
-          "char": "p",
-          "name": "no-prompt",
-          "summary": "Don't prompt the user to confirm the deletion.",
+        "set-default": {
+          "char": "s",
+          "name": "set-default",
+          "summary": "Set the sandbox org as your default org.",
           "allowNo": false,
           "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": true,
-      "hiddenAliases": [],
-      "id": "org:delete:sandbox",
-      "pluginAlias": "@salesforce/plugin-org",
-      "pluginName": "@salesforce/plugin-org",
-      "pluginType": "core",
-      "strict": true,
-      "summary": "Delete a sandbox.",
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "lib",
-        "commands",
-        "org",
-        "delete",
-        "sandbox.js"
-      ],
-      "aliasPermutations": [
-        "env:delete:sandbox",
-        "delete:env:sandbox",
-        "delete:sandbox:env",
-        "env:sandbox:delete",
-        "sandbox:env:delete",
-        "sandbox:delete:env"
-      ],
-      "permutations": [
-        "org:delete:sandbox",
-        "delete:org:sandbox",
-        "delete:sandbox:org",
-        "org:sandbox:delete",
-        "sandbox:org:delete",
-        "sandbox:delete:org"
-      ]
-    },
-    "org:delete:scratch": {
-      "aliases": [
-        "env:delete:scratch"
-      ],
-      "args": {},
-      "deprecateAliases": true,
-      "description": "Salesforce CLI marks the org for deletion in the Dev Hub org and then deletes all local references to the org from your computer.\nSpecify a scratch org with either the username or the alias you gave the scratch org when you created it. Run \"<%= config.bin %> org list\" to view all your orgs, including scratch orgs, and their aliases.",
-      "examples": [
-        "Delete a scratch org with alias my-scratch-org:\n<%= config.bin %> <%= command.id %> --target-org my-scratch-org",
-        "Specify a username instead of an alias:\n<%= config.bin %> <%= command.id %> --target-org test-123456-abcdefg@example.com",
-        "Delete the scratch org without prompting to confirm :\n<%= config.bin %> <%= command.id %> --target-org my-scratch-org --no-prompt"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
+        },
+        "alias": {
+          "char": "a",
+          "description": "When you create a sandbox, the generated usernames are based on the usernames present in the production org. To ensure uniqueness, the new usernames are appended with the name of the sandbox. For example, the username \"user@example.com\" in the production org results in the username \"user@example.com.mysandbox\" in a sandbox named \"mysandbox\". When you set an alias for a sandbox org, it's assigned to the resulting username of the user running this command.",
+          "name": "alias",
+          "summary": "Alias for the sandbox org.",
+          "hasDynamicHelp": false,
+          "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 to you and displays the \"<%= config.bin %> org resume sandbox\" command you run to check the status of the create. The displayed command includes the job ID for the running sandbox creation.",
+          "exclusive": [
+            "async"
+          ],
+          "name": "wait",
+          "summary": "Number of minutes to wait for the sandbox org to be ready.",
+          "hasDynamicHelp": true,
+          "helpValue": "<minutes>",
+          "multiple": false,
+          "type": "option"
+        },
+        "poll-interval": {
+          "char": "i",
+          "exclusive": [
+            "async"
+          ],
+          "name": "poll-interval",
+          "summary": "Number of seconds to wait between retries.",
+          "hasDynamicHelp": true,
+          "helpValue": "<seconds>",
+          "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 creation, run \"<%= config.bin %> org resume sandbox\".",
+          "exclusive": [
+            "wait",
+            "poll-interval"
+          ],
+          "name": "async",
+          "summary": "Request the sandbox creation, but don't wait for it to complete.",
           "allowNo": false,
           "type": "boolean"
         },
-        "flags-dir": {
-          "helpGroup": "GLOBAL",
-          "name": "flags-dir",
-          "summary": "Import flag values from a directory.",
+        "name": {
+          "char": "n",
+          "description": "The name must be a unique alphanumeric string (10 or fewer characters) to identify the sandbox. You can’t reuse a name while a sandbox is in the process of being deleted.",
+          "name": "name",
+          "summary": "Name of the sandbox org.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "target-org": {
+        "source-sandbox-name": {
           "aliases": [
-            "targetusername",
-            "u"
+            "clone",
+            "c"
           ],
-          "char": "o",
           "deprecateAliases": true,
+          "description": "The value of --source-sandbox-name must be an existing sandbox. The existing sandbox, and the new 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 cloning an existing sandbox, but not both.",
+          "exclusive": [
+            "license-type",
+            "source-id"
+          ],
+          "name": "source-sandbox-name",
+          "summary": "Name of the sandbox org to clone.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "source-id": {
+          "description": "The value of --source-id must be an existing sandbox (SandboxInfo.Id). The existing sandbox, and the new 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 cloning an existing sandbox, but not both.",
+          "exclusive": [
+            "license-type",
+            "source-sandbox-name"
+          ],
+          "name": "source-id",
+          "summary": "ID of the sandbox org to clone.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "license-type": {
+          "char": "l",
+          "exclusive": [
+            "source-sandbox-name",
+            "source-id"
+          ],
+          "name": "license-type",
+          "summary": "Type of sandbox license.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "Developer",
+            "Developer_Pro",
+            "Partial",
+            "Full"
+          ],
+          "type": "option"
+        },
+        "target-org": {
+          "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.",
           "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"
         },
         "no-prompt": {
-          "char": "p",
           "name": "no-prompt",
-          "summary": "Don't prompt the user to confirm the deletion.",
+          "summary": "Don't prompt for confirmation about the sandbox configuration.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "no-track-source": {
+          "description": "We recommend you enable source tracking in Developer and Developer Pro sandbox, which is why it's the default behavior. Source tracking allows you to track the changes you make to your metadata, both in your local project and in the sandbox, and to detect any conflicts between the two.\n\nTo disable source tracking in the new sandbox, specify the --no-track-source flag. The main reason to disable source tracking is for performance. For example, while you probably want to deploy metadata and run Apex tests in your CI/CD jobs, you probably don't want to incur the costs of source tracking (checking for conflicts, polling the SourceMember object, various file system operations.) This is a good use case for disabling source tracking in the sandbox.",
+          "name": "no-track-source",
+          "summary": "Do not use source tracking for this sandbox.",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "org:delete:scratch",
+      "id": "org:create:sandbox",
       "pluginAlias": "@salesforce/plugin-org",
       "pluginName": "@salesforce/plugin-org",
       "pluginType": "core",
       "strict": true,
-      "summary": "Delete a scratch org.",
-      "enableJsonFlag": true,
+      "summary": "Create a sandbox org.",
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "org",
-        "delete",
-        "scratch.js"
+        "create",
+        "sandbox.js"
       ],
       "aliasPermutations": [
-        "env:delete:scratch",
-        "delete:env:scratch",
-        "delete:scratch:env",
-        "env:scratch:delete",
-        "scratch:env:delete",
-        "scratch:delete:env"
+        "env:create:sandbox",
+        "create:env:sandbox",
+        "create:sandbox:env",
+        "env:sandbox:create",
+        "sandbox:env:create",
+        "sandbox:create:env"
       ],
       "permutations": [
-        "org:delete:scratch",
-        "delete:org:scratch",
-        "delete:scratch:org",
-        "org:scratch:delete",
-        "scratch:org:delete",
-        "scratch:delete:org"
+        "org:create:sandbox",
+        "create:org:sandbox",
+        "create:sandbox:org",
+        "org:sandbox:create",
+        "sandbox:org:create",
+        "sandbox:create:org"
       ]
     },
-    "org:disable:tracking": {
-      "aliases": [],
+    "org:create:scratch": {
+      "aliases": [
+        "env:create:scratch"
+      ],
       "args": {},
-      "description": "Disabling source tracking has no direct effect on the org, it affects only your local environment. Specifically, Salesforce CLI stores the setting in the org's local configuration file so that no source tracking operations are executed when working with the org.",
+      "deprecateAliases": true,
+      "description": "There are four ways to create a scratch org:\n\n    * Specify a definition file that contains the scratch org options.\n    * Use the --edition flag to specify the one required option; this method doesn't require a defintion file.\n    * Use the --snapshot flag to create a scratch org from a snapshot. Snapshots are a point-in-time copy of a scratch org; you create a snapshot with the \"sf org create snapshot\" command.\n    * Use the --source-org flag to create a scratch org from an org shape. Org shapes mimic the baseline setup of a source org without the extraneous data and metadata; you create an org shape with the \"sf org create shape\" command.\n\nThe --edition, --snapshot, and --source-org flags are mutually exclusive, which means if you specify one, you can't also specify the others.\n\nFor any of the methods, you can also use these flags; if you use them with --definition-file, they override their equivalent option in the scratch org definition file:\n\n    * --description\n    * --name  (equivalent to the \"orgName\" option)\n    * --username\n    * --release\n    * --admin-email (equivalent to the \"adminEmail\" option)\n\nIf you want to set options such as org features or settings, you must use a definition file.\n\nYou must specify a Dev Hub to create a scratch org, either with the --target-dev-hub flag or by setting your default Dev Hub with the target-dev-hub configuration variable.",
       "examples": [
-        "Disable source tracking for an org with alias \"myscratch\":\n<%= config.bin %> <%= command.id %> --target-org myscratch",
-        "Disable source tracking for an org using a username:\n<%= config.bin %> <%= command.id %> --target-org you@example.com",
-        "Disable source tracking for your default org:\n<%= config.bin %> <%= command.id %>"
+        "Create a Developer edition scratch org using your default Dev Hub and give the scratch org an alias:\n<%= config.bin %> <%= command.id %> --edition developer --alias my-scratch-org",
+        "Create a scratch org with a definition file. Specify the Dev Hub using its alias, set the scratch org as your default, and specify that it expires in 3 days:\n<%= config.bin %> <%= command.id %> --target-dev-hub MyHub --definition-file config/project-scratch-def.json --set-default --duration-days 3",
+        "Create a preview Enterprise edition scratch org; for use only during Salesforce release transition periods:\n<%= config.bin %> <%= command.id %> --edition enterprise --alias my-scratch-org --target-dev-hub MyHub --release preview",
+        "Create a scratch org from a snapshot called \"NightlyBranch\"; be sure you specify the same Dev Hub org associated with the snapshot. We recommend you increase the --wait time because creating a scratch org from a snapshot can take a while:\n<%= config.bin %> <%= command.id %> --alias my-scratch-org --target-dev-hub MyHub --snapshot NightlyBranch --wait 10"
       ],
       "flags": {
         "json": {
@@ -578,180 +618,250 @@
           "multiple": false,
           "type": "option"
         },
-        "target-org": {
-          "char": "o",
-          "name": "target-org",
+        "alias": {
+          "char": "a",
+          "description": "New scratch orgs include one administrator by default. The admin user's username is auto-generated and looks something like test-wvkpnfm5z113@example.com. When you set an alias for a new scratch org, it's assigned this username.",
+          "name": "alias",
+          "summary": "Alias for the scratch org.",
+          "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 resume the scratch org creation, run \"<%= config.bin %> org resume scratch\".",
+          "name": "async",
+          "summary": "Request the org, but don't wait for it to complete.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "set-default": {
+          "char": "d",
+          "name": "set-default",
+          "summary": "Set the scratch org as your default org",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "definition-file": {
+          "char": "f",
+          "description": "The scratch org definition file is a blueprint for the scratch org. It mimics the shape of an org that you use in the development life cycle, such as acceptance testing, packaging, or production. See <https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_scratch_orgs_def_file.htm> for all the option you can specify in the definition file.",
+          "name": "definition-file",
+          "summary": "Path to a scratch org definition file.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "target-dev-hub": {
+          "char": "v",
+          "description": "Overrides the value of the target-dev-hub configuration variable, if set.",
+          "name": "target-dev-hub",
           "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 Dev Hub org.",
           "hasDynamicHelp": true,
           "multiple": false,
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": true,
-      "hiddenAliases": [],
-      "id": "org:disable:tracking",
-      "pluginAlias": "@salesforce/plugin-org",
-      "pluginName": "@salesforce/plugin-org",
-      "pluginType": "core",
-      "strict": true,
-      "summary": "Prevent Salesforce CLI from tracking changes in your source files between your project and an org.",
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "lib",
-        "commands",
-        "org",
-        "disable",
-        "tracking.js"
-      ],
-      "aliasPermutations": [],
-      "permutations": [
-        "org:disable:tracking",
-        "disable:org:tracking",
-        "disable:tracking:org",
-        "org:tracking:disable",
-        "tracking:org:disable",
-        "tracking:disable:org"
-      ]
-    },
-    "org:list:metadata-types": {
-      "aliases": [
-        "force:mdapi:describemetadata"
-      ],
-      "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.",
-      "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"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
+        },
+        "no-ancestors": {
+          "char": "c",
+          "helpGroup": "Packaging",
+          "name": "no-ancestors",
+          "summary": "Don't include second-generation managed package (2GP) ancestors in the scratch org.",
           "allowNo": false,
           "type": "boolean"
         },
-        "flags-dir": {
-          "helpGroup": "GLOBAL",
-          "name": "flags-dir",
-          "summary": "Import flag values from a directory.",
+        "edition": {
+          "char": "e",
+          "description": "The editions that begin with \"partner-\" are available only if the Dev Hub org is a Partner Business Org.",
+          "exclusive": [
+            "snapshot",
+            "source-org"
+          ],
+          "helpGroup": "Definition File Override",
+          "name": "edition",
+          "summary": "Salesforce edition of the scratch org. Overrides the value of the \"edition\" option in the definition file, if set.",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "developer",
+            "enterprise",
+            "group",
+            "professional",
+            "partner-developer",
+            "partner-enterprise",
+            "partner-group",
+            "partner-professional"
+          ],
           "type": "option"
         },
-        "api-version": {
-          "aliases": [
-            "apiversion",
-            "a"
+        "snapshot": {
+          "char": "s",
+          "description": "To view the names of the available snapshots for a given Dev Hub org, run the \"sf org list snapshot\" command.",
+          "exclusive": [
+            "edition",
+            "source-org"
           ],
-          "deprecateAliases": true,
+          "helpGroup": "Definition File Override",
+          "name": "snapshot",
+          "summary": "Name of the snapshot to use when creating this scratch org. Overrides the value of the \"snapshot\" option in the defintion file, if set.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "no-namespace": {
+          "char": "m",
+          "helpGroup": "Packaging",
+          "name": "no-namespace",
+          "summary": "Create the scratch org with no namespace, even if the Dev Hub has a namespace.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "duration-days": {
+          "char": "y",
+          "name": "duration-days",
+          "summary": "Number of days before the org expires.",
+          "hasDynamicHelp": true,
+          "helpValue": "<days>",
+          "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 to you and displays the job ID. To resume the scratch org creation, run the org resume scratch command and pass it the job ID.",
+          "name": "wait",
+          "summary": "Number of minutes to wait for the scratch org to be ready.",
+          "hasDynamicHelp": true,
+          "helpValue": "<minutes>",
+          "multiple": false,
+          "type": "option"
+        },
+        "api-version": {
           "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"
         },
-        "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",
+        "client-id": {
+          "char": "i",
+          "name": "client-id",
+          "summary": "Consumer key of the Dev Hub connected app.",
           "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 target org. Not required if the `target-org` configuration variable is already set.",
-          "hasDynamicHelp": true,
+        "track-source": {
+          "char": "t",
+          "description": "We recommend you enable source tracking in scratch orgs, which is why it's the default behavior. Source tracking allows you to track the changes you make to your metadata, both in your local project and in the scratch org, and to detect any conflicts between the two.\n\nTo disable source tracking in the new scratch org, specify the --no-track-source flag. The main reason to disable source tracking is for performance. For example, while you probably want to deploy metadata and run Apex tests in your CI/CD jobs, you probably don't want to incur the costs of source tracking (checking for conflicts, polling the SourceMember object, various file system operations.) This is a good use case for disabling source tracking in the scratch org.",
+          "name": "track-source",
+          "summary": "Use source tracking for this scratch org. Set --no-track-source to disable source tracking.",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "username": {
+          "description": "The username must be unique within the entire scratch org and sandbox universe. You must add your own logic to ensure uniqueness.\n\nOmit this flag to have Salesforce generate a unique username for your org.",
+          "helpGroup": "Definition File Override",
+          "name": "username",
+          "summary": "Username of the scratch org admin user. Overrides the value of the \"username\" option in the definition file, if set.",
+          "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "output-file": {
-          "aliases": [
-            "resultfile"
+        "description": {
+          "helpGroup": "Definition File Override",
+          "name": "description",
+          "summary": "Description of the scratch org in the Dev Hub. Overrides the value of the \"description\" option in the definition file, if set.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "helpGroup": "Definition File Override",
+          "name": "name",
+          "summary": "Name of the org, such as \"Acme Company\". Overrides the value of the \"orgName\" option in the definition file, if set.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "release": {
+          "description": "By default, scratch orgs are on the same release as the Dev Hub. During Salesforce release transition periods, you can override this default behavior and opt in or out of the new release.",
+          "helpGroup": "Definition File Override",
+          "name": "release",
+          "summary": "Release of the scratch org as compared to the Dev Hub release.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "preview",
+            "previous"
           ],
-          "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.",
+          "type": "option"
+        },
+        "admin-email": {
+          "helpGroup": "Definition File Override",
+          "name": "admin-email",
+          "summary": "Email address that will be applied to the org's admin user. Overrides the value of the \"adminEmail\" option in the definition file, if set.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "filter-known": {
-          "aliases": [
-            "filterknown"
+        "source-org": {
+          "description": "To view the names of the available org shapes for a given Dev Hub org, run the \"sf org list shape\" command.",
+          "exclusive": [
+            "edition",
+            "snapshot"
           ],
-          "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"
+          "helpGroup": "Definition File Override",
+          "name": "source-org",
+          "summary": "15-character ID of the org shape that the new scratch org is based on. Overrides the value of the \"sourceOrg\" option in the definition file, if set.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "org:list:metadata-types",
+      "id": "org:create:scratch",
       "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.",
+      "summary": "Create a scratch org.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "org",
-        "list",
-        "metadata-types.js"
+        "create",
+        "scratch.js"
       ],
       "aliasPermutations": [
-        "force:mdapi:describemetadata",
-        "mdapi:force:describemetadata",
-        "mdapi:describemetadata:force",
-        "force:describemetadata:mdapi",
-        "describemetadata:force:mdapi",
-        "describemetadata:mdapi:force"
+        "env:create:scratch",
+        "create:env:scratch",
+        "create:scratch:env",
+        "env:scratch:create",
+        "scratch:env:create",
+        "scratch:create: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:create:scratch",
+        "create:org:scratch",
+        "create:scratch:org",
+        "org:scratch:create",
+        "scratch:org:create",
+        "scratch:create:org"
       ]
     },
-    "org:list:metadata": {
+    "org:delete:sandbox": {
       "aliases": [
-        "force:mdapi:listmetadata"
+        "env:delete:sandbox"
       ],
       "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": "Salesforce CLI marks the org for deletion in the production org that contains the sandbox licenses and then deletes all local references to the org from your computer.\nSpecify a sandbox with either the username you used when you logged into it, or the alias you gave the sandbox when you created it. Run \"<%= config.bin %> org list\" to view all your orgs, including sandboxes, and their aliases.\nBoth the sandbox and the associated production org must already be authenticated with the CLI to successfully delete the sandbox.",
       "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"
+        "Delete a sandbox with alias my-sandbox:\n<%= config.bin %> <%= command.id %> --target-org my-sandbox",
+        "Specify a username instead of an alias:\n<%= config.bin %> <%= command.id %> --target-org myusername@example.com.qa",
+        "Delete the sandbox without prompting to confirm:\n<%= config.bin %> <%= command.id %> --target-org my-sandbox --no-prompt"
       ],
       "flags": {
         "json": {
@@ -769,29 +879,6 @@
           "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.",
-          "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"
-        },
         "target-org": {
           "aliases": [
             "targetusername",
@@ -800,93 +887,65 @@
           "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.",
           "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,
-          "multiple": false,
-          "type": "option"
+        "no-prompt": {
+          "char": "p",
+          "name": "no-prompt",
+          "summary": "Don't prompt the user to confirm the deletion.",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "org:list:metadata",
+      "id": "org:delete:sandbox",
       "pluginAlias": "@salesforce/plugin-org",
       "pluginName": "@salesforce/plugin-org",
       "pluginType": "core",
       "strict": true,
-      "summary": "List the metadata components and properties of a specified type.",
+      "summary": "Delete a sandbox.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "org",
-        "list",
-        "metadata.js"
+        "delete",
+        "sandbox.js"
       ],
       "aliasPermutations": [
-        "force:mdapi:listmetadata",
-        "mdapi:force:listmetadata",
-        "mdapi:listmetadata:force",
-        "force:listmetadata:mdapi",
-        "listmetadata:force:mdapi",
-        "listmetadata:mdapi:force"
+        "env:delete:sandbox",
+        "delete:env:sandbox",
+        "delete:sandbox:env",
+        "env:sandbox:delete",
+        "sandbox:env:delete",
+        "sandbox:delete:env"
       ],
       "permutations": [
-        "org:list:metadata",
-        "list:org:metadata",
-        "list:metadata:org",
-        "org:metadata:list",
-        "metadata:org:list",
-        "metadata:list:org"
+        "org:delete:sandbox",
+        "delete:org:sandbox",
+        "delete:sandbox:org",
+        "org:sandbox:delete",
+        "sandbox:org:delete",
+        "sandbox:delete:org"
       ]
     },
-    "org:create:sandbox": {
+    "org:delete:scratch": {
       "aliases": [
-        "env:create:sandbox"
+        "env:delete:scratch"
       ],
       "args": {},
       "deprecateAliases": true,
-      "description": "There are two ways to create a sandbox org: specify a definition file that contains the sandbox options or use the --name and --license-type flags to specify the two required options. If you want to set an option other than name or license type, such as apexClassId, you must use a definition file.\n\nYou can also use this command to clone an existing sandbox. Use the --source-sandbox-name flag to specify the existing sandbox name and the --name flag to the name of the new sandbox.",
+      "description": "Salesforce CLI marks the org for deletion in the Dev Hub org and then deletes all local references to the org from your computer.\nSpecify a scratch org with either the username or the alias you gave the scratch org when you created it. Run \"<%= config.bin %> org list\" to view all your orgs, including scratch orgs, and their aliases.",
       "examples": [
-        "Create a sandbox org using a definition file and give it the alias \"MyDevSandbox\". The production org that contains the sandbox license has the alias \"prodOrg\".\n<%= config.bin %> <%= command.id %> --definition-file config/dev-sandbox-def.json --alias MyDevSandbox --target-org prodOrg",
-        "Create a sandbox org by directly specifying its name and type of license (Developer) instead of using a definition file. Set the sandbox org as your default.\n<%= config.bin %> <%= command.id %> --name mysandbox --license-type Developer --alias MyDevSandbox --target-org prodOrg --set-default",
-        "Clone the existing sandbox with name \"ExistingSandbox\" and name the new sandbox \"NewClonedSandbox\". Set the new sandbox as your default org. Wait for 30 minutes for the sandbox creation to complete.\n<%= config.bin %> <%= command.id %> --source-sandbox-name ExistingSandbox --name NewClonedSandbox --target-org prodOrg --alias MyDevSandbox --set-default --wait 30",
-        "Clone the existing sandbox with ID \"0GQB0000000TVobOAG\" and do not wait.\n<%= config.bin %> <%= command.id %> --source-id 0GQB0000000TVobOAG --name SbxClone --target-org prodOrg --async"
+        "Delete a scratch org with alias my-scratch-org:\n<%= config.bin %> <%= command.id %> --target-org my-scratch-org",
+        "Specify a username instead of an alias:\n<%= config.bin %> <%= command.id %> --target-org test-123456-abcdefg@example.com",
+        "Delete the scratch org without prompting to confirm :\n<%= config.bin %> <%= command.id %> --target-org my-scratch-org --no-prompt"
       ],
       "flags": {
         "json": {
@@ -904,193 +963,70 @@
           "multiple": false,
           "type": "option"
         },
-        "definition-file": {
-          "char": "f",
-          "description": "The sandbox definition file is a blueprint for the sandbox. You can create different definition files for each sandbox type that you use in the development process. 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.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "set-default": {
-          "char": "s",
-          "name": "set-default",
-          "summary": "Set the sandbox org as your default org.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "alias": {
-          "char": "a",
-          "description": "When you create a sandbox, the generated usernames are based on the usernames present in the production org. To ensure uniqueness, the new usernames are appended with the name of the sandbox. For example, the username \"user@example.com\" in the production org results in the username \"user@example.com.mysandbox\" in a sandbox named \"mysandbox\". When you set an alias for a sandbox org, it's assigned to the resulting username of the user running this command.",
-          "name": "alias",
-          "summary": "Alias for the sandbox org.",
-          "hasDynamicHelp": false,
-          "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 to you and displays the \"<%= config.bin %> org resume sandbox\" command you run to check the status of the create. The displayed command includes the job ID for the running sandbox creation.",
-          "exclusive": [
-            "async"
-          ],
-          "name": "wait",
-          "summary": "Number of minutes to wait for the sandbox org to be ready.",
-          "hasDynamicHelp": true,
-          "helpValue": "<minutes>",
-          "multiple": false,
-          "type": "option"
-        },
-        "poll-interval": {
-          "char": "i",
-          "exclusive": [
-            "async"
-          ],
-          "name": "poll-interval",
-          "summary": "Number of seconds to wait between retries.",
-          "hasDynamicHelp": true,
-          "helpValue": "<seconds>",
-          "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 creation, run \"<%= config.bin %> org resume sandbox\".",
-          "exclusive": [
-            "wait",
-            "poll-interval"
-          ],
-          "name": "async",
-          "summary": "Request the sandbox creation, but don't wait for it to complete.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "name": {
-          "char": "n",
-          "description": "The name must be a unique alphanumeric string (10 or fewer characters) to identify the sandbox. You can’t reuse a name while a sandbox is in the process of being deleted.",
-          "name": "name",
-          "summary": "Name of the sandbox org.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "source-sandbox-name": {
-          "aliases": [
-            "clone",
-            "c"
-          ],
-          "deprecateAliases": true,
-          "description": "The value of --source-sandbox-name must be an existing sandbox. The existing sandbox, and the new 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 cloning an existing sandbox, but not both.",
-          "exclusive": [
-            "license-type",
-            "source-id"
-          ],
-          "name": "source-sandbox-name",
-          "summary": "Name of the sandbox org to clone.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "source-id": {
-          "description": "The value of --source-id must be an existing sandbox (SandboxInfo.Id). The existing sandbox, and the new 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 cloning an existing sandbox, but not both.",
-          "exclusive": [
-            "license-type",
-            "source-sandbox-name"
-          ],
-          "name": "source-id",
-          "summary": "ID of the sandbox org to clone.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "license-type": {
-          "char": "l",
-          "exclusive": [
-            "source-sandbox-name",
-            "source-id"
-          ],
-          "name": "license-type",
-          "summary": "Type of sandbox license.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "Developer",
-            "Developer_Pro",
-            "Partial",
-            "Full"
-          ],
-          "type": "option"
-        },
         "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,
           "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": {
+          "char": "p",
           "name": "no-prompt",
-          "summary": "Don't prompt for confirmation about the sandbox configuration.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "no-track-source": {
-          "description": "We recommend you enable source tracking in Developer and Developer Pro sandbox, which is why it's the default behavior. Source tracking allows you to track the changes you make to your metadata, both in your local project and in the sandbox, and to detect any conflicts between the two.\n\nTo disable source tracking in the new sandbox, specify the --no-track-source flag. The main reason to disable source tracking is for performance. For example, while you probably want to deploy metadata and run Apex tests in your CI/CD jobs, you probably don't want to incur the costs of source tracking (checking for conflicts, polling the SourceMember object, various file system operations.) This is a good use case for disabling source tracking in the sandbox.",
-          "name": "no-track-source",
-          "summary": "Do not use source tracking for this sandbox.",
+          "summary": "Don't prompt the user to confirm the deletion.",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "org:create:sandbox",
+      "id": "org:delete:scratch",
       "pluginAlias": "@salesforce/plugin-org",
       "pluginName": "@salesforce/plugin-org",
       "pluginType": "core",
       "strict": true,
-      "summary": "Create a sandbox org.",
+      "summary": "Delete a scratch org.",
+      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "org",
-        "create",
-        "sandbox.js"
+        "delete",
+        "scratch.js"
       ],
       "aliasPermutations": [
-        "env:create:sandbox",
-        "create:env:sandbox",
-        "create:sandbox:env",
-        "env:sandbox:create",
-        "sandbox:env:create",
-        "sandbox:create:env"
+        "env:delete:scratch",
+        "delete:env:scratch",
+        "delete:scratch:env",
+        "env:scratch:delete",
+        "scratch:env:delete",
+        "scratch:delete:env"
       ],
       "permutations": [
-        "org:create:sandbox",
-        "create:org:sandbox",
-        "create:sandbox:org",
-        "org:sandbox:create",
-        "sandbox:org:create",
-        "sandbox:create:org"
+        "org:delete:scratch",
+        "delete:org:scratch",
+        "delete:scratch:org",
+        "org:scratch:delete",
+        "scratch:org:delete",
+        "scratch:delete:org"
       ]
     },
-    "org:create:scratch": {
-      "aliases": [
-        "env:create:scratch"
-      ],
+    "org:disable:tracking": {
+      "aliases": [],
       "args": {},
-      "deprecateAliases": true,
-      "description": "There are four ways to create a scratch org:\n\n    * Specify a definition file that contains the scratch org options.\n    * Use the --edition flag to specify the one required option; this method doesn't require a defintion file.\n    * Use the --snapshot flag to create a scratch org from a snapshot. Snapshots are a point-in-time copy of a scratch org; you create a snapshot with the \"sf org create snapshot\" command.\n    * Use the --source-org flag to create a scratch org from an org shape. Org shapes mimic the baseline setup of a source org without the extraneous data and metadata; you create an org shape with the \"sf org create shape\" command.\n\nThe --edition, --snapshot, and --source-org flags are mutually exclusive, which means if you specify one, you can't also specify the others.\n\nFor any of the methods, you can also use these flags; if you use them with --definition-file, they override their equivalent option in the scratch org definition file:\n\n    * --description\n    * --name  (equivalent to the \"orgName\" option)\n    * --username\n    * --release\n    * --admin-email (equivalent to the \"adminEmail\" option)\n\nIf you want to set options such as org features or settings, you must use a definition file.\n\nYou must specify a Dev Hub to create a scratch org, either with the --target-dev-hub flag or by setting your default Dev Hub with the target-dev-hub configuration variable.",
+      "description": "Disabling source tracking has no direct effect on the org, it affects only your local environment. Specifically, Salesforce CLI stores the setting in the org's local configuration file so that no source tracking operations are executed when working with the org.",
       "examples": [
-        "Create a Developer edition scratch org using your default Dev Hub and give the scratch org an alias:\n<%= config.bin %> <%= command.id %> --edition developer --alias my-scratch-org",
-        "Create a scratch org with a definition file. Specify the Dev Hub using its alias, set the scratch org as your default, and specify that it expires in 3 days:\n<%= config.bin %> <%= command.id %> --target-dev-hub MyHub --definition-file config/project-scratch-def.json --set-default --duration-days 3",
-        "Create a preview Enterprise edition scratch org; for use only during Salesforce release transition periods:\n<%= config.bin %> <%= command.id %> --edition enterprise --alias my-scratch-org --target-dev-hub MyHub --release preview",
-        "Create a scratch org from a snapshot called \"NightlyBranch\"; be sure you specify the same Dev Hub org associated with the snapshot. We recommend you increase the --wait time because creating a scratch org from a snapshot can take a while:\n<%= config.bin %> <%= command.id %> --alias my-scratch-org --target-dev-hub MyHub --snapshot NightlyBranch --wait 10"
+        "Disable source tracking for an org with alias \"myscratch\":\n<%= config.bin %> <%= command.id %> --target-org myscratch",
+        "Disable source tracking for an org using a username:\n<%= config.bin %> <%= command.id %> --target-org you@example.com",
+        "Disable source tracking for your default org:\n<%= config.bin %> <%= command.id %>"
       ],
       "flags": {
         "json": {
@@ -1108,247 +1044,243 @@
           "multiple": false,
           "type": "option"
         },
-        "alias": {
-          "char": "a",
-          "description": "New scratch orgs include one administrator by default. The admin user's username is auto-generated and looks something like test-wvkpnfm5z113@example.com. When you set an alias for a new scratch org, it's assigned this username.",
-          "name": "alias",
-          "summary": "Alias for the scratch org.",
-          "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 resume the scratch org creation, run \"<%= config.bin %> org resume scratch\".",
-          "name": "async",
-          "summary": "Request the org, but don't wait for it to complete.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "set-default": {
-          "char": "d",
-          "name": "set-default",
-          "summary": "Set the scratch org as your default org",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "definition-file": {
-          "char": "f",
-          "description": "The scratch org definition file is a blueprint for the scratch org. It mimics the shape of an org that you use in the development life cycle, such as acceptance testing, packaging, or production. See <https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_scratch_orgs_def_file.htm> for all the option you can specify in the definition file.",
-          "name": "definition-file",
-          "summary": "Path to a scratch org definition file.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "target-dev-hub": {
-          "char": "v",
-          "description": "Overrides the value of the target-dev-hub configuration variable, if set.",
-          "name": "target-dev-hub",
+        "target-org": {
+          "char": "o",
+          "name": "target-org",
           "noCacheDefault": true,
           "required": true,
-          "summary": "Username or alias of the Dev Hub org.",
+          "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-ancestors": {
-          "char": "c",
-          "helpGroup": "Packaging",
-          "name": "no-ancestors",
-          "summary": "Don't include second-generation managed package (2GP) ancestors in the scratch org.",
+        }
+      },
+      "hasDynamicHelp": true,
+      "hiddenAliases": [],
+      "id": "org:disable:tracking",
+      "pluginAlias": "@salesforce/plugin-org",
+      "pluginName": "@salesforce/plugin-org",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Prevent Salesforce CLI from tracking changes in your source files between your project and an org.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "org",
+        "disable",
+        "tracking.js"
+      ],
+      "aliasPermutations": [],
+      "permutations": [
+        "org:disable:tracking",
+        "disable:org:tracking",
+        "disable:tracking:org",
+        "org:tracking:disable",
+        "tracking:org:disable",
+        "tracking:disable:org"
+      ]
+    },
+    "org:enable:tracking": {
+      "aliases": [],
+      "args": {},
+      "description": "Enabling source tracking has no direct effect on the org, it affects only your local environment. Specifically, Salesforce CLI stores the setting in the org's local configuration file so that source tracking operations are executed when working with the org.\n\nThis command throws an error if the org doesn't support tracking. Examples of orgs that don't support source tracking include Developer Edition orgs, production orgs, Partial Copy sandboxes, and Full sandboxes.",
+      "examples": [
+        "Enable source tracking for an org with alias \"myscratch\":\n<%= config.bin %> <%= command.id %> --target-org myscratch",
+        "Enable source tracking for an org using a username:\n<%= config.bin %> <%= command.id %> --target-org you@example.com",
+        "Enable source tracking for your default org:\n<%= config.bin %> <%= command.id %>"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
           "allowNo": false,
           "type": "boolean"
         },
-        "edition": {
-          "char": "e",
-          "description": "The editions that begin with \"partner-\" are available only if the Dev Hub org is a Partner Business Org.",
-          "exclusive": [
-            "snapshot",
-            "source-org"
-          ],
-          "helpGroup": "Definition File Override",
-          "name": "edition",
-          "summary": "Salesforce edition of the scratch org. Overrides the value of the \"edition\" option in the definition file, if set.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "developer",
-            "enterprise",
-            "group",
-            "professional",
-            "partner-developer",
-            "partner-enterprise",
-            "partner-group",
-            "partner-professional"
-          ],
-          "type": "option"
-        },
-        "snapshot": {
-          "char": "s",
-          "description": "To view the names of the available snapshots for a given Dev Hub org, run the \"sf org list snapshot\" command.",
-          "exclusive": [
-            "edition",
-            "source-org"
-          ],
-          "helpGroup": "Definition File Override",
-          "name": "snapshot",
-          "summary": "Name of the snapshot to use when creating this scratch org. Overrides the value of the \"snapshot\" option in the defintion file, if set.",
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "no-namespace": {
-          "char": "m",
-          "helpGroup": "Packaging",
-          "name": "no-namespace",
-          "summary": "Create the scratch org with no namespace, even if the Dev Hub has a namespace.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "duration-days": {
-          "char": "y",
-          "name": "duration-days",
-          "summary": "Number of days before the org expires.",
+        "target-org": {
+          "char": "o",
+          "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.",
           "hasDynamicHelp": true,
-          "helpValue": "<days>",
           "multiple": false,
           "type": "option"
+        }
+      },
+      "hasDynamicHelp": true,
+      "hiddenAliases": [],
+      "id": "org:enable:tracking",
+      "pluginAlias": "@salesforce/plugin-org",
+      "pluginName": "@salesforce/plugin-org",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Allow Salesforce CLI to track changes in your source files between your project and an org.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "org",
+        "enable",
+        "tracking.js"
+      ],
+      "aliasPermutations": [],
+      "permutations": [
+        "org:enable:tracking",
+        "enable:org:tracking",
+        "enable:tracking:org",
+        "org:tracking:enable",
+        "tracking:org:enable",
+        "tracking:enable:org"
+      ]
+    },
+    "org:list:metadata-types": {
+      "aliases": [
+        "force:mdapi:describemetadata"
+      ],
+      "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.",
+      "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"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "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 job ID. To resume the scratch org creation, run the org resume scratch command and pass it the job ID.",
-          "name": "wait",
-          "summary": "Number of minutes to wait for the scratch org to be ready.",
-          "hasDynamicHelp": true,
-          "helpValue": "<minutes>",
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
           "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.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "client-id": {
-          "char": "i",
-          "name": "client-id",
-          "summary": "Consumer key of the Dev Hub connected app.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "track-source": {
-          "char": "t",
-          "description": "We recommend you enable source tracking in scratch orgs, which is why it's the default behavior. Source tracking allows you to track the changes you make to your metadata, both in your local project and in the scratch org, and to detect any conflicts between the two.\n\nTo disable source tracking in the new scratch org, specify the --no-track-source flag. The main reason to disable source tracking is for performance. For example, while you probably want to deploy metadata and run Apex tests in your CI/CD jobs, you probably don't want to incur the costs of source tracking (checking for conflicts, polling the SourceMember object, various file system operations.) This is a good use case for disabling source tracking in the scratch org.",
-          "name": "track-source",
-          "summary": "Use source tracking for this scratch org. Set --no-track-source to disable source tracking.",
-          "allowNo": true,
-          "type": "boolean"
-        },
-        "username": {
-          "description": "The username must be unique within the entire scratch org and sandbox universe. You must add your own logic to ensure uniqueness.\n\nOmit this flag to have Salesforce generate a unique username for your org.",
-          "helpGroup": "Definition File Override",
-          "name": "username",
-          "summary": "Username of the scratch org admin user. Overrides the value of the \"username\" option in the definition file, if set.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "description": {
-          "helpGroup": "Definition File Override",
-          "name": "description",
-          "summary": "Description of the scratch org in the Dev Hub. Overrides the value of the \"description\" option in the definition file, if set.",
+        "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"
         },
-        "name": {
-          "helpGroup": "Definition File Override",
-          "name": "name",
-          "summary": "Name of the org, such as \"Acme Company\". Overrides the value of the \"orgName\" option in the definition file, if set.",
-          "hasDynamicHelp": false,
+        "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.",
+          "hasDynamicHelp": true,
           "multiple": false,
           "type": "option"
         },
-        "release": {
-          "description": "By default, scratch orgs are on the same release as the Dev Hub. During Salesforce release transition periods, you can override this default behavior and opt in or out of the new release.",
-          "helpGroup": "Definition File Override",
-          "name": "release",
-          "summary": "Release of the scratch org as compared to the Dev Hub release.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "preview",
-            "previous"
+        "output-file": {
+          "aliases": [
+            "resultfile"
           ],
-          "type": "option"
-        },
-        "admin-email": {
-          "helpGroup": "Definition File Override",
-          "name": "admin-email",
-          "summary": "Email address that will be applied to the org's admin user. Overrides the value of the \"adminEmail\" option in the definition file, if set.",
+          "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"
         },
-        "source-org": {
-          "description": "To view the names of the available org shapes for a given Dev Hub org, run the \"sf org list shape\" command.",
-          "exclusive": [
-            "edition",
-            "snapshot"
+        "filter-known": {
+          "aliases": [
+            "filterknown"
           ],
-          "helpGroup": "Definition File Override",
-          "name": "source-org",
-          "summary": "15-character ID of the org shape that the new scratch org is based on. Overrides the value of the \"sourceOrg\" option in the definition file, if set.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+          "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:create:scratch",
+      "id": "org:list:metadata-types",
       "pluginAlias": "@salesforce/plugin-org",
       "pluginName": "@salesforce/plugin-org",
       "pluginType": "core",
       "strict": true,
-      "summary": "Create a scratch org.",
+      "summary": "Display details about the metadata types that are enabled for your org.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "org",
-        "create",
-        "scratch.js"
+        "list",
+        "metadata-types.js"
       ],
       "aliasPermutations": [
-        "env:create:scratch",
-        "create:env:scratch",
-        "create:scratch:env",
-        "env:scratch:create",
-        "scratch:env:create",
-        "scratch:create:env"
+        "force:mdapi:describemetadata",
+        "mdapi:force:describemetadata",
+        "mdapi:describemetadata:force",
+        "force:describemetadata:mdapi",
+        "describemetadata:force:mdapi",
+        "describemetadata:mdapi:force"
       ],
       "permutations": [
-        "org:create:scratch",
-        "create:org:scratch",
-        "create:scratch:org",
-        "org:scratch:create",
-        "scratch:org:create",
-        "scratch:create: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:enable:tracking": {
-      "aliases": [],
+    "org:list:metadata": {
+      "aliases": [
+        "force:mdapi:listmetadata"
+      ],
       "args": {},
-      "description": "Enabling source tracking has no direct effect on the org, it affects only your local environment. Specifically, Salesforce CLI stores the setting in the org's local configuration file so that source tracking operations are executed when working with the org.\n\nThis command throws an error if the org doesn't support tracking. Examples of orgs that don't support source tracking include Developer Edition orgs, production orgs, Partial Copy sandboxes, and Full sandboxes.",
+      "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.",
       "examples": [
-        "Enable source tracking for an org with alias \"myscratch\":\n<%= config.bin %> <%= command.id %> --target-org myscratch",
-        "Enable source tracking for an org using a username:\n<%= config.bin %> <%= command.id %> --target-org you@example.com",
-        "Enable source tracking for your default org:\n<%= config.bin %> <%= command.id %>"
+        "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": {
@@ -1366,8 +1298,36 @@
           "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.",
+          "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"
+        },
         "target-org": {
+          "aliases": [
+            "targetusername",
+            "u"
+          ],
           "char": "o",
+          "deprecateAliases": true,
           "name": "target-org",
           "noCacheDefault": true,
           "required": true,
@@ -1375,33 +1335,73 @@
           "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,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "org:enable:tracking",
+      "id": "org:list:metadata",
       "pluginAlias": "@salesforce/plugin-org",
       "pluginName": "@salesforce/plugin-org",
       "pluginType": "core",
       "strict": true,
-      "summary": "Allow Salesforce CLI to track changes in your source files between your project and an org.",
+      "summary": "List the metadata components and properties of a specified type.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "org",
-        "enable",
-        "tracking.js"
+        "list",
+        "metadata.js"
+      ],
+      "aliasPermutations": [
+        "force:mdapi:listmetadata",
+        "mdapi:force:listmetadata",
+        "mdapi:listmetadata:force",
+        "force:listmetadata:mdapi",
+        "listmetadata:force:mdapi",
+        "listmetadata:mdapi:force"
       ],
-      "aliasPermutations": [],
       "permutations": [
-        "org:enable:tracking",
-        "enable:org:tracking",
-        "enable:tracking:org",
-        "org:tracking:enable",
-        "tracking:org:enable",
-        "tracking:enable:org"
+        "org:list:metadata",
+        "list:org:metadata",
+        "list:metadata:org",
+        "org:metadata:list",
+        "metadata:org:list",
+        "metadata:list:org"
       ]
     },
     "org:open:agent": {
@@ -1875,5 +1875,5 @@
       ]
     }
   },
-  "version": "5.9.0"
+  "version": "5.9.2"
 }