@salesforce/cli 2.156.3 → 2.156.5

package/oclif.manifest.json

@@ -2446,194 +2446,6 @@
         "promote.js"
       ]
     },
-    "devops:promotion:complete": {
-      "aliases": [],
-      "args": {},
-      "description": "Deploys work items that were merged into the pipeline branch outside of DevOps Center (externally merged) into the target stage org and updates DevOps Center records. Equivalent to the \"Complete Promotion\" action in the DevOps Center UI when a stage is out of sync.\n\nIf no undeployed work items are found for the stage, the command exits successfully with no action taken.",
-      "examples": [
-        "Complete a promotion for an out-of-sync pipeline stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001",
-        "Complete a promotion for a specific work item (e.g. first stage of a pipeline):\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001 --work-item-id 1fk000000000001",
-        "Complete a promotion with full deploy and a specific test level:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001 --deploy-all --test-level RunLocalTests"
-      ],
-      "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"
-        },
-        "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,
-          "multiple": false,
-          "type": "option"
-        },
-        "api-version": {
-          "description": "Override the api version used for api requests made by this command",
-          "name": "api-version",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "target-stage-id": {
-          "char": "t",
-          "name": "target-stage-id",
-          "required": true,
-          "summary": "ID of the out-of-sync pipeline stage to deploy to.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "work-item-id": {
-          "char": "i",
-          "name": "work-item-id",
-          "required": false,
-          "summary": "ID of a specific work item to deploy. Omit to deploy all undeployed work items for the stage. Use this for the first stage of a pipeline where no source stage exists.",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "deploy-all": {
-          "char": "a",
-          "description": "If you don’t specify this flag, only changes in the stage’s branch are deployed.",
-          "name": "deploy-all",
-          "summary": "Deploy all metadata in the branch to the stage's org.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "test-level": {
-          "char": "l",
-          "description": "Valid values are:\n\n- NoTestRun — No tests are run. This test level applies only to deployments to development environments, such as sandbox, Developer Edition, or trial orgs. This test level is the default for development environments.\n\n- RunSpecifiedTests — Runs only the tests that you specify with the --tests flag. Code coverage requirements differ from the default coverage requirements when using this test level. Executed tests must comprise a minimum of 75% code coverage for each class and trigger in the deployment package. This coverage is computed for each class and trigger individually and is different than the overall coverage percentage.\n\n- RunLocalTests — All tests in your org are run, except the ones that originate from installed managed and unlocked packages. This test level is the default for production deployments that include Apex classes or triggers.\n\n- RunAllTestsInOrg — All tests in your org are run, including tests of managed packages.\n\nIf you don’t specify a test level, the default behavior depends on the contents of your deployment package. For more information, see the section \"Running Tests in a Deployment\" in the \"Metadata API Developer Guide\". (https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_deploy_running_tests.htm)",
-          "name": "test-level",
-          "summary": "Deployment Apex testing level.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "NoTestRun",
-            "RunSpecifiedTests",
-            "RunLocalTests",
-            "RunAllTestsInOrg"
-          ],
-          "type": "option"
-        },
-        "tests": {
-          "description": "Separate multiple test names with commas. Enclose the entire flag value in double quotes if a test name contains spaces.",
-          "name": "tests",
-          "summary": "Apex tests to run when --test-level is RunSpecifiedTests.",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": true,
-      "hiddenAliases": [],
-      "id": "devops:promotion:complete",
-      "pluginAlias": "@salesforce/plugin-devops-center",
-      "pluginName": "@salesforce/plugin-devops-center",
-      "pluginType": "jit",
-      "strict": true,
-      "summary": "Deploy undeployed work items to a pipeline stage org.",
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "lib",
-        "commands",
-        "devops",
-        "promotion",
-        "complete.js"
-      ]
-    },
-    "devops:promotion:validate": {
-      "aliases": [],
-      "args": {},
-      "description": "Validates whether the specified work items can be promoted to the target pipeline stage. Checks for VCS and object permission errors before a promotion is attempted.",
-      "examples": [
-        "Validate promotion of a work item to a target stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001 --work-item-id 1fk000000000001",
-        "Validate promotion of multiple work items:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001 --work-item-id 1fk000000000001 --work-item-id 1fk000000000002"
-      ],
-      "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"
-        },
-        "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,
-          "multiple": false,
-          "type": "option"
-        },
-        "api-version": {
-          "description": "Override the api version used for api requests made by this command",
-          "name": "api-version",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "target-stage-id": {
-          "char": "t",
-          "name": "target-stage-id",
-          "required": true,
-          "summary": "ID of the target pipeline stage to validate promotion to.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "work-item-id": {
-          "char": "i",
-          "name": "work-item-id",
-          "required": true,
-          "summary": "ID of a work item to validate for promotion. Specify multiple times for multiple work items.",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": true,
-      "hiddenAliases": [],
-      "id": "devops:promotion:validate",
-      "pluginAlias": "@salesforce/plugin-devops-center",
-      "pluginName": "@salesforce/plugin-devops-center",
-      "pluginType": "jit",
-      "strict": true,
-      "summary": "Validate work item promotion for a pipeline stage.",
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "lib",
-        "commands",
-        "devops",
-        "promotion",
-        "validate.js"
-      ]
-    },
     "devops:project:create": {
       "aliases": [],
       "args": {},
@@ -3223,12 +3035,14 @@
         "update.js"
       ]
     },
-    "devops:request:status": {
+    "devops:promotion:complete": {
       "aliases": [],
       "args": {},
-      "description": "Returns the current status of a request identified by its request token.",
+      "description": "Deploys work items that were merged into the pipeline branch outside of DevOps Center (externally merged) into the target stage org and updates DevOps Center records. Equivalent to the \"Complete Promotion\" action in the DevOps Center UI when a stage is out of sync.\n\nIf no undeployed work items are found for the stage, the command exits successfully with no action taken.",
       "examples": [
-        "Get the status of a request:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --request-token a0B000000000001"
+        "Complete a promotion for an out-of-sync pipeline stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001",
+        "Complete a promotion for a specific work item (e.g. first stage of a pipeline):\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001 --work-item-id 1fk000000000001",
+        "Complete a promotion with full deploy and a specific test level:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001 --deploy-all --test-level RunLocalTests"
       ],
       "flags": {
         "json": {
@@ -3263,38 +3077,156 @@
           "multiple": false,
           "type": "option"
         },
-        "request-token": {
-          "char": "i",
-          "name": "request-token",
+        "target-stage-id": {
+          "char": "t",
+          "name": "target-stage-id",
           "required": true,
-          "summary": "Request token from the promote response.",
+          "summary": "ID of the out-of-sync pipeline stage to deploy to.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "work-item-id": {
+          "char": "i",
+          "name": "work-item-id",
+          "required": false,
+          "summary": "ID of a specific work item to deploy. Omit to deploy all undeployed work items for the stage. Use this for the first stage of a pipeline where no source stage exists.",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "deploy-all": {
+          "char": "a",
+          "description": "If you don’t specify this flag, only changes in the stage’s branch are deployed.",
+          "name": "deploy-all",
+          "summary": "Deploy all metadata in the branch to the stage's org.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "test-level": {
+          "char": "l",
+          "description": "Valid values are:\n\n- NoTestRun — No tests are run. This test level applies only to deployments to development environments, such as sandbox, Developer Edition, or trial orgs. This test level is the default for development environments.\n\n- RunSpecifiedTests — Runs only the tests that you specify with the --tests flag. Code coverage requirements differ from the default coverage requirements when using this test level. Executed tests must comprise a minimum of 75% code coverage for each class and trigger in the deployment package. This coverage is computed for each class and trigger individually and is different than the overall coverage percentage.\n\n- RunLocalTests — All tests in your org are run, except the ones that originate from installed managed and unlocked packages. This test level is the default for production deployments that include Apex classes or triggers.\n\n- RunAllTestsInOrg — All tests in your org are run, including tests of managed packages.\n\nIf you don’t specify a test level, the default behavior depends on the contents of your deployment package. For more information, see the section \"Running Tests in a Deployment\" in the \"Metadata API Developer Guide\". (https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_deploy_running_tests.htm)",
+          "name": "test-level",
+          "summary": "Deployment Apex testing level.",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "NoTestRun",
+            "RunSpecifiedTests",
+            "RunLocalTests",
+            "RunAllTestsInOrg"
+          ],
+          "type": "option"
+        },
+        "tests": {
+          "description": "Separate multiple test names with commas. Enclose the entire flag value in double quotes if a test name contains spaces.",
+          "name": "tests",
+          "summary": "Apex tests to run when --test-level is RunSpecifiedTests.",
+          "hasDynamicHelp": false,
+          "multiple": true,
           "type": "option"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "devops:request:status",
+      "id": "devops:promotion:complete",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "jit",
       "strict": true,
-      "summary": "Get the status of a request.",
+      "summary": "Deploy undeployed work items to a pipeline stage org.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "devops",
-        "request",
-        "status.js"
+        "promotion",
+        "complete.js"
       ]
     },
-    "devops:review:create": {
+    "devops:promotion:validate": {
       "aliases": [],
       "args": {},
-      "description": "Creates a pull request via the Salesforce DevOps Center API, using the VCS credentials stored in the org. Works with GitHub and Bitbucket without requiring local VCS authentication.",
+      "description": "Validates whether the specified work items can be promoted to the target pipeline stage. Checks for VCS and object permission errors before a promotion is attempted.",
+      "examples": [
+        "Validate promotion of a work item to a target stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001 --work-item-id 1fk000000000001",
+        "Validate promotion of multiple work items:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001 --work-item-id 1fk000000000001 --work-item-id 1fk000000000002"
+      ],
+      "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"
+        },
+        "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,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-version": {
+          "description": "Override the api version used for api requests made by this command",
+          "name": "api-version",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "target-stage-id": {
+          "char": "t",
+          "name": "target-stage-id",
+          "required": true,
+          "summary": "ID of the target pipeline stage to validate promotion to.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "work-item-id": {
+          "char": "i",
+          "name": "work-item-id",
+          "required": true,
+          "summary": "ID of a work item to validate for promotion. Specify multiple times for multiple work items.",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": true,
+      "hiddenAliases": [],
+      "id": "devops:promotion:validate",
+      "pluginAlias": "@salesforce/plugin-devops-center",
+      "pluginName": "@salesforce/plugin-devops-center",
+      "pluginType": "jit",
+      "strict": true,
+      "summary": "Validate work item promotion for a pipeline stage.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "devops",
+        "promotion",
+        "validate.js"
+      ]
+    },
+    "devops:review:create": {
+      "aliases": [],
+      "args": {},
+      "description": "Creates a pull request via the Salesforce DevOps Center API, using the VCS credentials stored in the org. Works with GitHub and Bitbucket without requiring local VCS authentication.",
       "examples": [
         "Create a pull request for a work item.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-name WI-000001",
         "Create a pull request using the work item ID.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-id 0Wx000000000001"
@@ -3367,6 +3299,74 @@
         "create.js"
       ]
     },
+    "devops:request:status": {
+      "aliases": [],
+      "args": {},
+      "description": "Returns the current status of a request identified by its request token.",
+      "examples": [
+        "Get the status of a request:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --request-token a0B000000000001"
+      ],
+      "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"
+        },
+        "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,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-version": {
+          "description": "Override the api version used for api requests made by this command",
+          "name": "api-version",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "request-token": {
+          "char": "i",
+          "name": "request-token",
+          "required": true,
+          "summary": "Request token from the promote response.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": true,
+      "hiddenAliases": [],
+      "id": "devops:request:status",
+      "pluginAlias": "@salesforce/plugin-devops-center",
+      "pluginName": "@salesforce/plugin-devops-center",
+      "pluginType": "jit",
+      "strict": true,
+      "summary": "Get the status of a request.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "devops",
+        "request",
+        "status.js"
+      ]
+    },
     "devops:work-item:combine": {
       "aliases": [],
       "args": {},
@@ -3788,12 +3788,13 @@
         "update.js"
       ]
     },
-    "devops:pipeline:project:add": {
+    "project:deploy:pipeline:quick": {
       "aliases": [],
       "args": {},
-      "description": "You can attach a project to only one pipeline.",
+      "description": "The first time you run any \"project deploy pipeline\" command, be sure to authorize the org in which DevOps Center is installed. The easiest way to authorize an org is with the \"org login web\" command.\n\nBefore you run this command, create a validated deployment with the \"project deploy pipeline validate\" command, which returns a job ID. Validated deployments haven't been deployed to the org yet; you deploy them with this command. Either pass the job ID to this command or use the --use-most-recent flag to use the job ID of the most recently validated deployment. For the quick deploy to succeed, the associated validated deployment must also have succeeded.\n\nExecuting this quick deploy command takes less time than a standard deploy because it skips running Apex tests. These tests were previously run as part of the validation. Validating first and then running a quick deploy is useful if the deployment to your production org take several hours and you don’t want to risk a failed deploy.\n\nThis command doesn't support source-tracking. The source you deploy overwrites the corresponding metadata in your org. This command doesn’t attempt to merge your source with the versions in your org.",
       "examples": [
-        "Attach a project to a pipeline using the project ID and pipeline ID.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --project-id 0Hn000000000001"
+        "Run a quick deploy using your default Devops Center org and a job ID:\n<%= config.bin %> <%= command.id %> --job-id 0Af0x000017yLUFCA2",
+        "Asynchronously run a quick deploy of the most recently validated deployment using an org with alias \"my-prod-org\":\n<%= config.bin %> <%= command.id %> --async --use-most-recent --devops-center-username my-prod-org"
       ],
       "flags": {
         "json": {
@@ -3811,65 +3812,96 @@
           "multiple": false,
           "type": "option"
         },
-        "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,
-          "multiple": false,
-          "type": "option"
+        "async": {
+          "description": "The command immediately returns the job ID and control of the terminal to you. This way, you can continue to use the CLI. To resume the deployment, run \"sf project deploy pipeline resume\". To check the status of the deployment, run \"sf project deploy pipeline report\".",
+          "name": "async",
+          "summary": "Run the command asynchronously.",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "api-version": {
-          "description": "Override the api version used for api requests made by this command",
-          "name": "api-version",
-          "hasDynamicHelp": false,
+        "concise": {
+          "exclusive": [
+            "verbose"
+          ],
+          "name": "concise",
+          "summary": "Show concise output of the command result.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "name": "verbose",
+          "summary": "Show verbose output of the command result.",
+          "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 check the status of the operation, run \"sf project deploy pipeline report\".",
+          "exclusive": [
+            "async"
+          ],
+          "name": "wait",
+          "summary": "Number of minutes to wait for command to complete and display results.",
+          "default": "33 minutes",
+          "hasDynamicHelp": true,
+          "helpValue": "<minutes>",
           "multiple": false,
           "type": "option"
         },
-        "pipeline-id": {
-          "name": "pipeline-id",
+        "devops-center-username": {
+          "char": "c",
+          "name": "devops-center-username",
           "required": true,
-          "summary": "ID of the pipeline.",
-          "hasDynamicHelp": false,
+          "summary": "Username or alias of the DevOps Center org.",
+          "hasDynamicHelp": true,
           "multiple": false,
           "type": "option"
         },
-        "project-id": {
-          "name": "project-id",
-          "required": true,
-          "summary": "ID of the DevOps Center project.",
+        "job-id": {
+          "char": "i",
+          "description": "The job ID is valid for 10 days from when you started the validation.",
+          "name": "job-id",
+          "summary": "Job ID of the validated deployment to quick deploy.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "use-most-recent": {
+          "char": "r",
+          "description": "For performance reasons, this flag uses only job IDs that were validated in the past 3 days or less. If your most recent deployment validation was more than 3 days ago, this flag won't find the job ID.",
+          "name": "use-most-recent",
+          "summary": "Use the job ID of the most recently validated deployment.",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "devops:pipeline:project:add",
+      "id": "project:deploy:pipeline:quick",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "jit",
+      "state": "beta",
       "strict": true,
-      "summary": "Attach a DevOps Center project to a pipeline.",
+      "summary": "Quickly deploy a validated deployment to an org.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
-        "devops",
-        "pipeline",
         "project",
-        "add.js"
+        "deploy",
+        "pipeline",
+        "quick.js"
       ]
     },
-    "devops:pipeline:project:delete": {
+    "project:deploy:pipeline:report": {
       "aliases": [],
       "args": {},
-      "description": "Deletes the junction record that connects the project to the pipeline. The project itself is not deleted.",
+      "description": "The first time you run any \"project deploy pipeline\" command, be sure to authorize the org in which DevOps Center is installed. The easiest way to authorize an org is with the \"org login web\" command.\n\nRun this command by either indicating a job ID or specifying the —use-most-recent flag to use the job ID of the most recent deploy operation.",
       "examples": [
-        "Remove a project from a pipeline using the project ID and pipeline ID.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --project-id 0Hn000000000001"
+        "Check the status using a job ID:\n<%= config.bin %> <%= command.id %> --devops-center-username MyStagingSandbox --job-id 0Af0x000017yLUFCA2",
+        "Check the status of the most recent deploy operation:\n<%= config.bin %> <%= command.id %> --devops-center-username MyStagingSandbox --use-most-recent"
       ],
       "flags": {
         "json": {
@@ -3887,66 +3919,60 @@
           "multiple": false,
           "type": "option"
         },
-        "target-org": {
-          "char": "o",
-          "name": "target-org",
-          "noCacheDefault": true,
+        "devops-center-username": {
+          "char": "c",
+          "name": "devops-center-username",
           "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 DevOps Center org.",
           "hasDynamicHelp": true,
           "multiple": false,
           "type": "option"
         },
-        "api-version": {
-          "description": "Override the api version used for api requests made by this command",
-          "name": "api-version",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "pipeline-id": {
-          "name": "pipeline-id",
-          "required": true,
-          "summary": "ID of the pipeline.",
+        "job-id": {
+          "char": "i",
+          "description": "The job ID is valid for 10 days from when you started the deploy operation.",
+          "name": "job-id",
+          "summary": "Job ID of the pipeline deployment to check the status of.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "project-id": {
-          "name": "project-id",
-          "required": true,
-          "summary": "ID of the DevOps Center project.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "use-most-recent": {
+          "char": "r",
+          "description": "For performance reasons, this flag uses job IDs for deploy operations that started in the past 3 days or fewer. If your most recent operation was longer than 3 days ago, this flag won't find the job ID.",
+          "name": "use-most-recent",
+          "summary": "Use the job ID of the most recent deploy operation.",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "devops:pipeline:project:delete",
+      "id": "project:deploy:pipeline:report",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "jit",
+      "state": "beta",
       "strict": true,
-      "summary": "Remove a DevOps Center project's connection to a pipeline.",
+      "summary": "Check the status of a pipeline deploy operation.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
-        "devops",
-        "pipeline",
         "project",
-        "delete.js"
+        "deploy",
+        "pipeline",
+        "report.js"
       ]
     },
-    "devops:pipeline:stage:add": {
+    "project:deploy:pipeline:resume": {
       "aliases": [],
       "args": {},
-      "description": "Inserts an empty stage before the stage specified by `--next-stage-id`. The new stage doesn't include a branch or environment. Configure them separately after you create the stage.",
+      "description": "The first time you run any \"project deploy pipeline\" command, be sure to authorize the org in which DevOps Center is installed. The easiest way to authorize an org is with the \"org login web\" command. \n\nUse this command to resume watching a pipeline deploy operation if the original command times out or you specified the --async flag.\n\nRun this command by either indicating a job ID or specifying the --use-most-recent flag to use the job ID of the most recent deploy operation.",
       "examples": [
-        "Add a Development stage before Integration in a specific pipeline.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --name \"Development\" --next-stage-id 0Xc000000000002",
-        "Add a QA stage before UAT in a specific pipeline.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --name \"QA\" --next-stage-id 0Xc000000000003"
+        "Resume watching a deploy operation using a job ID:\n<%= config.bin %> <%= command.id %> --job-id 0Af0x000017yLUFCA2",
+        "Resume watching the most recent deploy operation:\n<%= config.bin %> <%= command.id %> --use-most-recent"
       ],
       "flags": {
         "json": {
@@ -3964,74 +3990,89 @@
           "multiple": false,
           "type": "option"
         },
-        "target-org": {
-          "char": "o",
-          "name": "target-org",
-          "noCacheDefault": true,
+        "devops-center-username": {
+          "char": "c",
+          "name": "devops-center-username",
           "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 DevOps Center org.",
           "hasDynamicHelp": true,
           "multiple": false,
           "type": "option"
         },
-        "api-version": {
-          "description": "Override the api version used for api requests made by this command",
-          "name": "api-version",
+        "job-id": {
+          "char": "i",
+          "description": "These commands return a job ID if they time out or you specified the --async flag:\n\n- sf project deploy pipeline start\n- sf project deploy pipeline validate\n- sf project deploy pipeline quick\n\nThe job ID is valid for 10 days from when you started the deploy operation.",
+          "name": "job-id",
+          "summary": "Job ID of the pipeline deploy operation you want to resume.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "pipeline-id": {
-          "name": "pipeline-id",
-          "required": true,
-          "summary": "ID of the pipeline where the stage is added.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "use-most-recent": {
+          "char": "r",
+          "description": "For performance reasons, this flag uses job IDs for operations that started in the past 3 days or fewer. If your most recent operation was longer than 3 days ago, this flag won't find a job ID.",
+          "name": "use-most-recent",
+          "summary": "Use the job ID of the most recent deploy operation.",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "name": {
-          "char": "n",
-          "name": "name",
-          "required": true,
-          "summary": "Name of the pipeline stage, such as Integration, UAT, or Staging.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "concise": {
+          "exclusive": [
+            "verbose"
+          ],
+          "name": "concise",
+          "summary": "Show concise output of the command result.",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "next-stage-id": {
-          "name": "next-stage-id",
-          "required": true,
-          "summary": "ID of the stage that follows the new stage in the pipeline.",
-          "hasDynamicHelp": false,
+        "verbose": {
+          "name": "verbose",
+          "summary": "Show verbose output of the command result.",
+          "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 check the status of the operation, run \"sf project deploy pipeline report\".",
+          "exclusive": [
+            "async"
+          ],
+          "name": "wait",
+          "summary": "Number of minutes to wait for command to complete and display results.",
+          "default": "33 minutes",
+          "hasDynamicHelp": true,
+          "helpValue": "<minutes>",
           "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "devops:pipeline:stage:add",
+      "id": "project:deploy:pipeline:resume",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "jit",
+      "state": "beta",
       "strict": true,
-      "summary": "Add a stage to a DevOps Center pipeline.",
+      "summary": "Resume watching a pipeline deploy operation.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
-        "devops",
+        "project",
+        "deploy",
         "pipeline",
-        "stage",
-        "add.js"
+        "resume.js"
       ]
     },
-    "devops:pipeline:stage:delete": {
+    "project:deploy:pipeline:start": {
       "aliases": [],
       "args": {},
-      "description": "Deletes the specified stage from the pipeline. If the stage sits between two other stages, the predecessor stage is automatically re-linked to the successor so the pipeline chain stays intact.",
+      "description": "The first time you run any \"project deploy pipeline\" command, be sure to authorize the org in which DevOps Center is installed. The easiest way to authorize an org is with the \"org login web\" command.\n\nBefore you run this command, changes in the pipeline stage's branch must be merged in the source control repository.",
       "examples": [
-        "Delete a stage from a pipeline:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --stage-id 0Xc000000000002"
+        "Deploy changes in the Staging branch to the Staging environment (sandbox), if the previous stage is the bundling stage:\n<%= config.bin %> <%= command.id %> --devops-center-project-name “Recruiting App” --branch-name staging --devops-center-username MyStagingSandbox --bundle-version-name 1.0",
+        "Deploy all changes in the main branch to the release environment:\n<%= config.bin %> <%= command.id %> --devops-center-project-name “Recruiting App” --branch-name main --devops-center-username MyReleaseOrg --deploy-all"
       ],
       "flags": {
         "json": {
@@ -4049,65 +4090,138 @@
           "multiple": false,
           "type": "option"
         },
-        "target-org": {
-          "char": "o",
-          "name": "target-org",
-          "noCacheDefault": true,
+        "branch-name": {
+          "char": "b",
+          "name": "branch-name",
           "required": true,
-          "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
-          "hasDynamicHelp": true,
+          "summary": "Name of the branch in the source control repository that corresponds to the pipeline stage that you want to deploy the changes to.",
+          "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "api-version": {
-          "description": "Override the api version used for api requests made by this command",
-          "name": "api-version",
+        "bundle-version-name": {
+          "char": "v",
+          "description": "You must indicate the bundle version if deploying to the environment that corresponds to the first stage after the bundling stage.",
+          "name": "bundle-version-name",
+          "summary": "Version name of the bundle.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "pipeline-id": {
-          "name": "pipeline-id",
+        "deploy-all": {
+          "char": "a",
+          "description": "If you don’t specify this flag, only changes in the stage’s branch are deployed.",
+          "name": "deploy-all",
+          "summary": "Deploy all metadata in the branch to the stage's org.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "devops-center-project-name": {
+          "char": "p",
+          "name": "devops-center-project-name",
           "required": true,
-          "summary": "ID of the pipeline that contains the stage.",
+          "summary": "Name of the DevOps Center project.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "stage-id": {
-          "name": "stage-id",
+        "devops-center-username": {
+          "char": "c",
+          "name": "devops-center-username",
           "required": true,
-          "summary": "ID of the stage to delete.",
+          "summary": "Username or alias of the DevOps Center org.",
+          "hasDynamicHelp": true,
+          "multiple": false,
+          "type": "option"
+        },
+        "tests": {
+          "char": "t",
+          "description": "Separate multiple test names with commas. Enclose the entire flag value in double quotes if a test name contains spaces.",
+          "name": "tests",
+          "summary": "Apex tests to run when --test-level is RunSpecifiedTests.",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "test-level": {
+          "char": "l",
+          "description": "Valid values are:\n\n- NoTestRun — No tests are run. This test level applies only to deployments to development environments, such as sandbox, Developer Edition, or trial orgs. This test level is the default for development environments.\n\n- RunSpecifiedTests — Runs only the tests that you specify with the --tests flag. Code coverage requirements differ from the default coverage requirements when using this test level. Executed tests must comprise a minimum of 75% code coverage for each class and trigger in the deployment package. This coverage is computed for each class and trigger individually and is different than the overall coverage percentage.\n\n- RunLocalTests — All tests in your org are run, except the ones that originate from installed managed and unlocked packages. This test level is the default for production deployments that include Apex classes or triggers.\n\n- RunAllTestsInOrg — All tests in your org are run, including tests of managed packages.\n\nIf you don’t specify a test level, the default behavior depends on the contents of your deployment package. For more information, see the section \"Running Tests in a Deployment\" in the \"Metadata API Developer Guide\". (https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_deploy_running_tests.htm)",
+          "name": "test-level",
+          "summary": "Deployment Apex testing level.",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "NoTestRun",
+            "RunSpecifiedTests",
+            "RunLocalTests",
+            "RunAllTestsInOrg"
+          ],
+          "type": "option"
+        },
+        "async": {
+          "description": "The command immediately returns the job ID and control of the terminal to you. This way, you can continue to use the CLI. To resume the deployment, run \"sf project deploy pipeline resume\". To check the status of the deployment, run \"sf project deploy pipeline report\".",
+          "name": "async",
+          "summary": "Run the command asynchronously.",
+          "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 check the status of the operation, run \"sf project deploy pipeline report\".",
+          "exclusive": [
+            "async"
+          ],
+          "name": "wait",
+          "summary": "Number of minutes to wait for command to complete and display results.",
+          "default": "33 minutes",
+          "hasDynamicHelp": true,
+          "helpValue": "<minutes>",
+          "multiple": false,
           "type": "option"
+        },
+        "verbose": {
+          "name": "verbose",
+          "summary": "Show verbose output of the command result.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "concise": {
+          "exclusive": [
+            "verbose"
+          ],
+          "name": "concise",
+          "summary": "Show concise output of the command result.",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "devops:pipeline:stage:delete",
+      "id": "project:deploy:pipeline:start",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "jit",
+      "state": "beta",
       "strict": true,
-      "summary": "Delete a stage from a DevOps Center pipeline.",
+      "summary": "Deploy changes from a branch to the pipeline stage’s org.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
-        "devops",
+        "project",
+        "deploy",
         "pipeline",
-        "stage",
-        "delete.js"
+        "start.js"
       ]
     },
-    "devops:pipeline:stage:update": {
+    "project:deploy:pipeline:validate": {
       "aliases": [],
       "args": {},
-      "description": "Updates the name of a pipeline stage.",
+      "description": "The first time you run any \"project deploy pipeline\" command, be sure to authorize the org in which DevOps Center is installed. The easiest way to authorize an org is with the \"org login web\" command.\n\nA validation runs Apex tests to verify whether a deployment will succeed without actually deploying the metadata to your environment, so you can then quickly deploy the changes later without re-running the tests.",
       "examples": [
-        "Rename a pipeline stage.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --stage-id 1QV000000000001 --name \"Integration\""
+        "Perform a validate-only deployment from the Staging branch to the Staging environment (sandbox):\n<%= config.bin %> <%= command.id %> --devops-center-project-name “Recruiting App” --branch-name staging --devops-center-username MyStagingSandbox",
+        "Perform a validate-only deployment of all changes from the main branch to the release environment:\n<%= config.bin %> <%= command.id %> --devops-center-project-name “Recruiting App” --branch-name main --devops-center-username MyReleaseOrg --deploy-all"
       ],
       "flags": {
         "json": {
@@ -4125,68 +4239,137 @@
           "multiple": false,
           "type": "option"
         },
-        "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,
+        "branch-name": {
+          "char": "b",
+          "name": "branch-name",
+          "required": true,
+          "summary": "Name of the branch in the source control repository that corresponds to the pipeline stage that you want to deploy the changes to.",
+          "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "api-version": {
-          "description": "Override the api version used for api requests made by this command",
-          "name": "api-version",
+        "bundle-version-name": {
+          "char": "v",
+          "description": "You must indicate the bundle version if deploying to the environment that corresponds to the first stage after the bundling stage.",
+          "name": "bundle-version-name",
+          "summary": "Version name of the bundle.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "stage-id": {
-          "char": "s",
-          "name": "stage-id",
+        "deploy-all": {
+          "char": "a",
+          "description": "If you don’t specify this flag, only changes in the stage’s branch are deployed.",
+          "name": "deploy-all",
+          "summary": "Deploy all metadata in the branch to the stage's org.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "devops-center-project-name": {
+          "char": "p",
+          "name": "devops-center-project-name",
           "required": true,
-          "summary": "ID of the pipeline stage to update.",
+          "summary": "Name of the DevOps Center project.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "name": {
-          "char": "n",
-          "name": "name",
+        "devops-center-username": {
+          "char": "c",
+          "name": "devops-center-username",
           "required": true,
-          "summary": "New name for the pipeline stage.",
+          "summary": "Username or alias of the DevOps Center org.",
+          "hasDynamicHelp": true,
+          "multiple": false,
+          "type": "option"
+        },
+        "tests": {
+          "char": "t",
+          "description": "Separate multiple test names with commas. Enclose the entire flag value in double quotes if a test name contains spaces.",
+          "name": "tests",
+          "summary": "Apex tests to run when --test-level is RunSpecifiedTests.",
           "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "test-level": {
+          "char": "l",
+          "description": "Valid values are:\n\n- NoTestRun — No tests are run. This test level applies only to deployments to development environments, such as sandbox, Developer Edition, or trial orgs. This test level is the default for development environments.\n\n- RunSpecifiedTests — Runs only the tests that you specify with the --tests flag. Code coverage requirements differ from the default coverage requirements when using this test level. Executed tests must comprise a minimum of 75% code coverage for each class and trigger in the deployment package. This coverage is computed for each class and trigger individually and is different than the overall coverage percentage.\n\n- RunLocalTests — All tests in your org are run, except the ones that originate from installed managed and unlocked packages. This test level is the default for production deployments that include Apex classes or triggers.\n\n- RunAllTestsInOrg — All tests in your org are run, including tests of managed packages.\n\nIf you don’t specify a test level, the default behavior depends on the contents of your deployment package. For more information, see the section \"Running Tests in a Deployment\" in the \"Metadata API Developer Guide\". (https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_deploy_running_tests.htm)",
+          "name": "test-level",
+          "summary": "Deployment Apex testing level.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "NoTestRun",
+            "RunSpecifiedTests",
+            "RunLocalTests",
+            "RunAllTestsInOrg"
+          ],
+          "type": "option"
+        },
+        "async": {
+          "description": "The command immediately returns the job ID and control of the terminal to you. This way, you can continue to use the CLI. To resume the deployment, run \"sf project deploy pipeline resume\". To check the status of the deployment, run \"sf project deploy pipeline report\".",
+          "name": "async",
+          "summary": "Run the command asynchronously.",
+          "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 check the status of the operation, run \"sf project deploy pipeline report\".",
+          "exclusive": [
+            "async"
+          ],
+          "name": "wait",
+          "summary": "Number of minutes to wait for command to complete and display results.",
+          "default": "33 minutes",
+          "hasDynamicHelp": true,
+          "helpValue": "<minutes>",
           "multiple": false,
           "type": "option"
+        },
+        "verbose": {
+          "name": "verbose",
+          "summary": "Show verbose output of the command result.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "concise": {
+          "exclusive": [
+            "verbose"
+          ],
+          "name": "concise",
+          "summary": "Show concise output of the command result.",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "devops:pipeline:stage:update",
+      "id": "project:deploy:pipeline:validate",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "jit",
+      "state": "beta",
       "strict": true,
-      "summary": "Update a DevOps Center pipeline stage.",
+      "summary": "Perform a validate-only deployment from a branch to the pipeline stage’s org.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
-        "devops",
+        "project",
+        "deploy",
         "pipeline",
-        "stage",
-        "update.js"
+        "validate.js"
       ]
     },
-    "devops:stage:branch:add": {
+    "devops:pipeline:project:add": {
       "aliases": [],
       "args": {},
-      "description": "By default, the branch must exist in the repository. Use --create-vcs-branch to create a branch if it doesn't exist.\nEach pipeline stage supports only one branch. If the stage already has a branch, the command blocks so the existing branch isn't orphaned; pass --force to replace it.",
+      "description": "You can attach a project to only one pipeline.",
       "examples": [
-        "Add an existing branch to a stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Xo000000000001 --stage-id 0Xp000000000001 --branch-name main",
-        "Create and add a branch to a pipeline stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Xo000000000001 --stage-id 0Xp000000000002 --branch-name integration --create-vcs-branch"
+        "Attach a project to a pipeline using the project ID and pipeline ID.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --project-id 0Hn000000000001"
       ],
       "flags": {
         "json": {
@@ -4224,66 +4407,45 @@
         "pipeline-id": {
           "name": "pipeline-id",
           "required": true,
-          "summary": "ID of the pipeline that contains the stage.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "stage-id": {
-          "name": "stage-id",
-          "required": true,
-          "summary": "ID of the pipeline stage to associate the branch with.",
+          "summary": "ID of the pipeline.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "branch-name": {
-          "char": "b",
-          "name": "branch-name",
+        "project-id": {
+          "name": "project-id",
           "required": true,
-          "summary": "Name of the repository branch to assign to the stage.",
+          "summary": "ID of the DevOps Center project.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "create-vcs-branch": {
-          "name": "create-vcs-branch",
-          "summary": "Create the branch in the remote repository if it doesn't already exist.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "force": {
-          "name": "force",
-          "summary": "Replace the stage's existing branch. By default, the command blocks if the stage already has a branch to avoid orphaning it. With this flag, the new branch is associated and the previous branch record is removed if no other stage references it.",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "devops:stage:branch:add",
+      "id": "devops:pipeline:project:add",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "jit",
       "strict": true,
-      "summary": "Add a source code repository branch to a pipeline stage.",
+      "summary": "Attach a DevOps Center project to a pipeline.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "devops",
-        "stage",
-        "branch",
+        "pipeline",
+        "project",
         "add.js"
       ]
     },
-    "devops:stage:branch:delete": {
+    "devops:pipeline:project:delete": {
       "aliases": [],
       "args": {},
-      "description": "Removes the branch linked to the specified pipeline stage. Because branches are configured from right to left (a stage can have a branch only after the stage to its right does), removing a branch also removes the branches from all upstream stages (to the left) in the pipeline, keeping it in a valid state. The branch records in the repository are not deleted; only their association with the stages is removed. The stage must belong to an inactive pipeline.",
+      "description": "Deletes the junction record that connects the project to the pipeline. The project itself is not deleted.",
       "examples": [
-        "Delete the branch associated with a pipeline stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Xo000000000001 --stage-id 0Xp000000000001"
+        "Remove a project from a pipeline using the project ID and pipeline ID.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --project-id 0Hn000000000001"
       ],
       "flags": {
         "json": {
@@ -4321,15 +4483,15 @@
         "pipeline-id": {
           "name": "pipeline-id",
           "required": true,
-          "summary": "ID of the pipeline that contains the stage. Used to verify the pipeline is inactive before deleting.",
+          "summary": "ID of the pipeline.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "stage-id": {
-          "name": "stage-id",
+        "project-id": {
+          "name": "project-id",
           "required": true,
-          "summary": "ID of the pipeline stage whose branch you want to delete.",
+          "summary": "ID of the DevOps Center project.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -4337,29 +4499,30 @@
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "devops:stage:branch:delete",
+      "id": "devops:pipeline:project:delete",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "jit",
       "strict": true,
-      "summary": "Delete the source code repository branch associated with a pipeline stage.",
+      "summary": "Remove a DevOps Center project's connection to a pipeline.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "devops",
-        "stage",
-        "branch",
+        "pipeline",
+        "project",
         "delete.js"
       ]
     },
-    "devops:stage:environment:add": {
+    "devops:pipeline:stage:add": {
       "aliases": [],
       "args": {},
-      "description": "This command triggers an OAuth flow to authenticate the environment. A browser window opens automatically for you to log in.",
+      "description": "Inserts an empty stage before the stage specified by `--next-stage-id`. The new stage doesn't include a branch or environment. Configure them separately after you create the stage.",
       "examples": [
-        "Add a production environment to a stage using its ID:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --stage-id 0Xp000000000001 --environment-name Production_Org --org-type Production"
+        "Add a Development stage before Integration in a specific pipeline.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --name \"Development\" --next-stage-id 0Xc000000000002",
+        "Add a QA stage before UAT in a specific pipeline.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --name \"QA\" --next-stage-id 0Xc000000000003"
       ],
       "flags": {
         "json": {
@@ -4397,78 +4560,54 @@
         "pipeline-id": {
           "name": "pipeline-id",
           "required": true,
-          "summary": "ID of the pipeline that contains the stage.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "stage-id": {
-          "name": "stage-id",
-          "required": true,
-          "summary": "ID of the pipeline stage.",
+          "summary": "ID of the pipeline where the stage is added.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "environment-name": {
-          "char": "e",
-          "name": "environment-name",
+        "name": {
+          "char": "n",
+          "name": "name",
           "required": true,
-          "summary": "Name of the environment.",
+          "summary": "Name of the pipeline stage, such as Integration, UAT, or Staging.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "org-type": {
-          "name": "org-type",
+        "next-stage-id": {
+          "name": "next-stage-id",
           "required": true,
-          "summary": "Type of the Salesforce org. Valid values: Production, Sandbox.",
+          "summary": "ID of the stage that follows the new stage in the pipeline.",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "Production",
-            "Sandbox"
-          ],
           "type": "option"
-        },
-        "no-browser": {
-          "name": "no-browser",
-          "summary": "Don't auto-open the browser for OAuth authentication. The redirect URL is printed for manual use.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "force": {
-          "name": "force",
-          "summary": "Replace the stage's existing environment. By default, the command blocks if the stage already has an environment to avoid orphaning it. With this flag, the new environment is added first and the previous one is removed only after the new environment is associated successfully.",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "devops:stage:environment:add",
+      "id": "devops:pipeline:stage:add",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "jit",
       "strict": true,
-      "summary": "Add a Salesforce environment to a pipeline stage.",
+      "summary": "Add a stage to a DevOps Center pipeline.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "devops",
+        "pipeline",
         "stage",
-        "environment",
         "add.js"
       ]
     },
-    "devops:stage:environment:delete": {
+    "devops:pipeline:stage:delete": {
       "aliases": [],
       "args": {},
-      "description": "Removes the specified environment from the pipeline stage. The environment must belong to an inactive pipeline.",
+      "description": "Deletes the specified stage from the pipeline. If the stage sits between two other stages, the predecessor stage is automatically re-linked to the successor so the pipeline chain stays intact.",
       "examples": [
-        "Delete an environment:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --environment-id 0Xe000000000001"
+        "Delete a stage from a pipeline:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --stage-id 0Xc000000000002"
       ],
       "flags": {
         "json": {
@@ -4506,16 +4645,15 @@
         "pipeline-id": {
           "name": "pipeline-id",
           "required": true,
-          "summary": "ID of the pipeline. Used to verify the pipeline is inactive before deleting.",
+          "summary": "ID of the pipeline that contains the stage.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "environment-id": {
-          "char": "e",
-          "name": "environment-id",
+        "stage-id": {
+          "name": "stage-id",
           "required": true,
-          "summary": "ID of the environment to delete.",
+          "summary": "ID of the stage to delete.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -4523,30 +4661,29 @@
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "devops:stage:environment:delete",
+      "id": "devops:pipeline:stage:delete",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "jit",
       "strict": true,
-      "summary": "Delete an environment from a DevOps Center pipeline stage.",
+      "summary": "Delete a stage from a DevOps Center pipeline.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "devops",
+        "pipeline",
         "stage",
-        "environment",
         "delete.js"
       ]
     },
-    "project:deploy:pipeline:quick": {
+    "devops:pipeline:stage:update": {
       "aliases": [],
       "args": {},
-      "description": "The first time you run any \"project deploy pipeline\" command, be sure to authorize the org in which DevOps Center is installed. The easiest way to authorize an org is with the \"org login web\" command.\n\nBefore you run this command, create a validated deployment with the \"project deploy pipeline validate\" command, which returns a job ID. Validated deployments haven't been deployed to the org yet; you deploy them with this command. Either pass the job ID to this command or use the --use-most-recent flag to use the job ID of the most recently validated deployment. For the quick deploy to succeed, the associated validated deployment must also have succeeded.\n\nExecuting this quick deploy command takes less time than a standard deploy because it skips running Apex tests. These tests were previously run as part of the validation. Validating first and then running a quick deploy is useful if the deployment to your production org take several hours and you don’t want to risk a failed deploy.\n\nThis command doesn't support source-tracking. The source you deploy overwrites the corresponding metadata in your org. This command doesn’t attempt to merge your source with the versions in your org.",
+      "description": "Updates the name of a pipeline stage.",
       "examples": [
-        "Run a quick deploy using your default Devops Center org and a job ID:\n<%= config.bin %> <%= command.id %> --job-id 0Af0x000017yLUFCA2",
-        "Asynchronously run a quick deploy of the most recently validated deployment using an org with alias \"my-prod-org\":\n<%= config.bin %> <%= command.id %> --async --use-most-recent --devops-center-username my-prod-org"
+        "Rename a pipeline stage.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --stage-id 1QV000000000001 --name \"Integration\""
       ],
       "flags": {
         "json": {
@@ -4564,96 +4701,68 @@
           "multiple": false,
           "type": "option"
         },
-        "async": {
-          "description": "The command immediately returns the job ID and control of the terminal to you. This way, you can continue to use the CLI. To resume the deployment, run \"sf project deploy pipeline resume\". To check the status of the deployment, run \"sf project deploy pipeline report\".",
-          "name": "async",
-          "summary": "Run the command asynchronously.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "concise": {
-          "exclusive": [
-            "verbose"
-          ],
-          "name": "concise",
-          "summary": "Show concise output of the command result.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "verbose": {
-          "name": "verbose",
-          "summary": "Show verbose output of the command result.",
-          "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 check the status of the operation, run \"sf project deploy pipeline report\".",
-          "exclusive": [
-            "async"
-          ],
-          "name": "wait",
-          "summary": "Number of minutes to wait for command to complete and display results.",
-          "default": "33 minutes",
+        "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": "<minutes>",
           "multiple": false,
           "type": "option"
         },
-        "devops-center-username": {
-          "char": "c",
-          "name": "devops-center-username",
-          "required": true,
-          "summary": "Username or alias of the DevOps Center org.",
-          "hasDynamicHelp": true,
+        "api-version": {
+          "description": "Override the api version used for api requests made by this command",
+          "name": "api-version",
+          "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "job-id": {
-          "char": "i",
-          "description": "The job ID is valid for 10 days from when you started the validation.",
-          "name": "job-id",
-          "summary": "Job ID of the validated deployment to quick deploy.",
+        "stage-id": {
+          "char": "s",
+          "name": "stage-id",
+          "required": true,
+          "summary": "ID of the pipeline stage to update.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "use-most-recent": {
-          "char": "r",
-          "description": "For performance reasons, this flag uses only job IDs that were validated in the past 3 days or less. If your most recent deployment validation was more than 3 days ago, this flag won't find the job ID.",
-          "name": "use-most-recent",
-          "summary": "Use the job ID of the most recently validated deployment.",
-          "allowNo": false,
-          "type": "boolean"
+        "name": {
+          "char": "n",
+          "name": "name",
+          "required": true,
+          "summary": "New name for the pipeline stage.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "project:deploy:pipeline:quick",
+      "id": "devops:pipeline:stage:update",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "jit",
-      "state": "beta",
       "strict": true,
-      "summary": "Quickly deploy a validated deployment to an org.",
+      "summary": "Update a DevOps Center pipeline stage.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
-        "project",
-        "deploy",
+        "devops",
         "pipeline",
-        "quick.js"
+        "stage",
+        "update.js"
       ]
     },
-    "project:deploy:pipeline:report": {
+    "devops:stage:branch:add": {
       "aliases": [],
       "args": {},
-      "description": "The first time you run any \"project deploy pipeline\" command, be sure to authorize the org in which DevOps Center is installed. The easiest way to authorize an org is with the \"org login web\" command.\n\nRun this command by either indicating a job ID or specifying the —use-most-recent flag to use the job ID of the most recent deploy operation.",
+      "description": "By default, the branch must exist in the repository. Use --create-vcs-branch to create a branch if it doesn't exist.\nEach pipeline stage supports only one branch. If the stage already has a branch, the command blocks so the existing branch isn't orphaned; pass --force to replace it.",
       "examples": [
-        "Check the status using a job ID:\n<%= config.bin %> <%= command.id %> --devops-center-username MyStagingSandbox --job-id 0Af0x000017yLUFCA2",
-        "Check the status of the most recent deploy operation:\n<%= config.bin %> <%= command.id %> --devops-center-username MyStagingSandbox --use-most-recent"
+        "Add an existing branch to a stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Xo000000000001 --stage-id 0Xp000000000001 --branch-name main",
+        "Create and add a branch to a pipeline stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Xo000000000001 --stage-id 0Xp000000000002 --branch-name integration --create-vcs-branch"
       ],
       "flags": {
         "json": {
@@ -4671,60 +4780,86 @@
           "multiple": false,
           "type": "option"
         },
-        "devops-center-username": {
-          "char": "c",
-          "name": "devops-center-username",
+        "target-org": {
+          "char": "o",
+          "name": "target-org",
+          "noCacheDefault": true,
           "required": true,
-          "summary": "Username or alias of the DevOps Center 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"
         },
-        "job-id": {
-          "char": "i",
-          "description": "The job ID is valid for 10 days from when you started the deploy operation.",
-          "name": "job-id",
-          "summary": "Job ID of the pipeline deployment to check the status of.",
+        "api-version": {
+          "description": "Override the api version used for api requests made by this command",
+          "name": "api-version",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "use-most-recent": {
-          "char": "r",
-          "description": "For performance reasons, this flag uses job IDs for deploy operations that started in the past 3 days or fewer. If your most recent operation was longer than 3 days ago, this flag won't find the job ID.",
-          "name": "use-most-recent",
-          "summary": "Use the job ID of the most recent deploy operation.",
+        "pipeline-id": {
+          "name": "pipeline-id",
+          "required": true,
+          "summary": "ID of the pipeline that contains the stage.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "stage-id": {
+          "name": "stage-id",
+          "required": true,
+          "summary": "ID of the pipeline stage to associate the branch with.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "branch-name": {
+          "char": "b",
+          "name": "branch-name",
+          "required": true,
+          "summary": "Name of the repository branch to assign to the stage.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "create-vcs-branch": {
+          "name": "create-vcs-branch",
+          "summary": "Create the branch in the remote repository if it doesn't already exist.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "force": {
+          "name": "force",
+          "summary": "Replace the stage's existing branch. By default, the command blocks if the stage already has a branch to avoid orphaning it. With this flag, the new branch is associated and the previous branch record is removed if no other stage references it.",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "project:deploy:pipeline:report",
+      "id": "devops:stage:branch:add",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "jit",
-      "state": "beta",
       "strict": true,
-      "summary": "Check the status of a pipeline deploy operation.",
+      "summary": "Add a source code repository branch to a pipeline stage.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
-        "project",
-        "deploy",
-        "pipeline",
-        "report.js"
+        "devops",
+        "stage",
+        "branch",
+        "add.js"
       ]
     },
-    "project:deploy:pipeline:resume": {
+    "devops:stage:branch:delete": {
       "aliases": [],
       "args": {},
-      "description": "The first time you run any \"project deploy pipeline\" command, be sure to authorize the org in which DevOps Center is installed. The easiest way to authorize an org is with the \"org login web\" command. \n\nUse this command to resume watching a pipeline deploy operation if the original command times out or you specified the --async flag.\n\nRun this command by either indicating a job ID or specifying the --use-most-recent flag to use the job ID of the most recent deploy operation.",
+      "description": "Removes the branch linked to the specified pipeline stage. Because branches are configured from right to left (a stage can have a branch only after the stage to its right does), removing a branch also removes the branches from all upstream stages (to the left) in the pipeline, keeping it in a valid state. The branch records in the repository are not deleted; only their association with the stages is removed. The stage must belong to an inactive pipeline.",
       "examples": [
-        "Resume watching a deploy operation using a job ID:\n<%= config.bin %> <%= command.id %> --job-id 0Af0x000017yLUFCA2",
-        "Resume watching the most recent deploy operation:\n<%= config.bin %> <%= command.id %> --use-most-recent"
+        "Delete the branch associated with a pipeline stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Xo000000000001 --stage-id 0Xp000000000001"
       ],
       "flags": {
         "json": {
@@ -4742,89 +4877,65 @@
           "multiple": false,
           "type": "option"
         },
-        "devops-center-username": {
-          "char": "c",
-          "name": "devops-center-username",
+        "target-org": {
+          "char": "o",
+          "name": "target-org",
+          "noCacheDefault": true,
           "required": true,
-          "summary": "Username or alias of the DevOps Center 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"
         },
-        "job-id": {
-          "char": "i",
-          "description": "These commands return a job ID if they time out or you specified the --async flag:\n\n- sf project deploy pipeline start\n- sf project deploy pipeline validate\n- sf project deploy pipeline quick\n\nThe job ID is valid for 10 days from when you started the deploy operation.",
-          "name": "job-id",
-          "summary": "Job ID of the pipeline deploy operation you want to resume.",
+        "api-version": {
+          "description": "Override the api version used for api requests made by this command",
+          "name": "api-version",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "use-most-recent": {
-          "char": "r",
-          "description": "For performance reasons, this flag uses job IDs for operations that started in the past 3 days or fewer. If your most recent operation was longer than 3 days ago, this flag won't find a job ID.",
-          "name": "use-most-recent",
-          "summary": "Use the job ID of the most recent deploy operation.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "concise": {
-          "exclusive": [
-            "verbose"
-          ],
-          "name": "concise",
-          "summary": "Show concise output of the command result.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "verbose": {
-          "name": "verbose",
-          "summary": "Show verbose output of the command result.",
-          "allowNo": false,
-          "type": "boolean"
+        "pipeline-id": {
+          "name": "pipeline-id",
+          "required": true,
+          "summary": "ID of the pipeline that contains the stage. Used to verify the pipeline is inactive before deleting.",
+          "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 window to you and returns the job ID. To check the status of the operation, run \"sf project deploy pipeline report\".",
-          "exclusive": [
-            "async"
-          ],
-          "name": "wait",
-          "summary": "Number of minutes to wait for command to complete and display results.",
-          "default": "33 minutes",
-          "hasDynamicHelp": true,
-          "helpValue": "<minutes>",
+        "stage-id": {
+          "name": "stage-id",
+          "required": true,
+          "summary": "ID of the pipeline stage whose branch you want to delete.",
+          "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "project:deploy:pipeline:resume",
+      "id": "devops:stage:branch:delete",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "jit",
-      "state": "beta",
       "strict": true,
-      "summary": "Resume watching a pipeline deploy operation.",
+      "summary": "Delete the source code repository branch associated with a pipeline stage.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
-        "project",
-        "deploy",
-        "pipeline",
-        "resume.js"
+        "devops",
+        "stage",
+        "branch",
+        "delete.js"
       ]
     },
-    "project:deploy:pipeline:start": {
+    "devops:stage:environment:add": {
       "aliases": [],
       "args": {},
-      "description": "The first time you run any \"project deploy pipeline\" command, be sure to authorize the org in which DevOps Center is installed. The easiest way to authorize an org is with the \"org login web\" command.\n\nBefore you run this command, changes in the pipeline stage's branch must be merged in the source control repository.",
+      "description": "This command triggers an OAuth flow to authenticate the environment. A browser window opens automatically for you to log in.",
       "examples": [
-        "Deploy changes in the Staging branch to the Staging environment (sandbox), if the previous stage is the bundling stage:\n<%= config.bin %> <%= command.id %> --devops-center-project-name “Recruiting App” --branch-name staging --devops-center-username MyStagingSandbox --bundle-version-name 1.0",
-        "Deploy all changes in the main branch to the release environment:\n<%= config.bin %> <%= command.id %> --devops-center-project-name “Recruiting App” --branch-name main --devops-center-username MyReleaseOrg --deploy-all"
+        "Add a production environment to a stage using its ID:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --stage-id 0Xp000000000001 --environment-name Production_Org --org-type Production"
       ],
       "flags": {
         "json": {
@@ -4842,138 +4953,98 @@
           "multiple": false,
           "type": "option"
         },
-        "branch-name": {
-          "char": "b",
-          "name": "branch-name",
-          "required": true,
-          "summary": "Name of the branch in the source control repository that corresponds to the pipeline stage that you want to deploy the changes to.",
-          "hasDynamicHelp": false,
+        "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,
           "multiple": false,
           "type": "option"
         },
-        "bundle-version-name": {
-          "char": "v",
-          "description": "You must indicate the bundle version if deploying to the environment that corresponds to the first stage after the bundling stage.",
-          "name": "bundle-version-name",
-          "summary": "Version name of the bundle.",
+        "api-version": {
+          "description": "Override the api version used for api requests made by this command",
+          "name": "api-version",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "deploy-all": {
-          "char": "a",
-          "description": "If you don’t specify this flag, only changes in the stage’s branch are deployed.",
-          "name": "deploy-all",
-          "summary": "Deploy all metadata in the branch to the stage's org.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "devops-center-project-name": {
-          "char": "p",
-          "name": "devops-center-project-name",
+        "pipeline-id": {
+          "name": "pipeline-id",
           "required": true,
-          "summary": "Name of the DevOps Center project.",
+          "summary": "ID of the pipeline that contains the stage.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "devops-center-username": {
-          "char": "c",
-          "name": "devops-center-username",
+        "stage-id": {
+          "name": "stage-id",
           "required": true,
-          "summary": "Username or alias of the DevOps Center org.",
-          "hasDynamicHelp": true,
+          "summary": "ID of the pipeline stage.",
+          "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "tests": {
-          "char": "t",
-          "description": "Separate multiple test names with commas. Enclose the entire flag value in double quotes if a test name contains spaces.",
-          "name": "tests",
-          "summary": "Apex tests to run when --test-level is RunSpecifiedTests.",
+        "environment-name": {
+          "char": "e",
+          "name": "environment-name",
+          "required": true,
+          "summary": "Name of the environment.",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "test-level": {
-          "char": "l",
-          "description": "Valid values are:\n\n- NoTestRun — No tests are run. This test level applies only to deployments to development environments, such as sandbox, Developer Edition, or trial orgs. This test level is the default for development environments.\n\n- RunSpecifiedTests — Runs only the tests that you specify with the --tests flag. Code coverage requirements differ from the default coverage requirements when using this test level. Executed tests must comprise a minimum of 75% code coverage for each class and trigger in the deployment package. This coverage is computed for each class and trigger individually and is different than the overall coverage percentage.\n\n- RunLocalTests — All tests in your org are run, except the ones that originate from installed managed and unlocked packages. This test level is the default for production deployments that include Apex classes or triggers.\n\n- RunAllTestsInOrg — All tests in your org are run, including tests of managed packages.\n\nIf you don’t specify a test level, the default behavior depends on the contents of your deployment package. For more information, see the section \"Running Tests in a Deployment\" in the \"Metadata API Developer Guide\". (https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_deploy_running_tests.htm)",
-          "name": "test-level",
-          "summary": "Deployment Apex testing level.",
+        "org-type": {
+          "name": "org-type",
+          "required": true,
+          "summary": "Type of the Salesforce org. Valid values: Production, Sandbox.",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
-            "NoTestRun",
-            "RunSpecifiedTests",
-            "RunLocalTests",
-            "RunAllTestsInOrg"
-          ],
-          "type": "option"
-        },
-        "async": {
-          "description": "The command immediately returns the job ID and control of the terminal to you. This way, you can continue to use the CLI. To resume the deployment, run \"sf project deploy pipeline resume\". To check the status of the deployment, run \"sf project deploy pipeline report\".",
-          "name": "async",
-          "summary": "Run the command asynchronously.",
-          "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 check the status of the operation, run \"sf project deploy pipeline report\".",
-          "exclusive": [
-            "async"
+            "Production",
+            "Sandbox"
           ],
-          "name": "wait",
-          "summary": "Number of minutes to wait for command to complete and display results.",
-          "default": "33 minutes",
-          "hasDynamicHelp": true,
-          "helpValue": "<minutes>",
-          "multiple": false,
           "type": "option"
         },
-        "verbose": {
-          "name": "verbose",
-          "summary": "Show verbose output of the command result.",
+        "no-browser": {
+          "name": "no-browser",
+          "summary": "Don't auto-open the browser for OAuth authentication. The redirect URL is printed for manual use.",
           "allowNo": false,
           "type": "boolean"
         },
-        "concise": {
-          "exclusive": [
-            "verbose"
-          ],
-          "name": "concise",
-          "summary": "Show concise output of the command result.",
+        "force": {
+          "name": "force",
+          "summary": "Replace the stage's existing environment. By default, the command blocks if the stage already has an environment to avoid orphaning it. With this flag, the new environment is added first and the previous one is removed only after the new environment is associated successfully.",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "project:deploy:pipeline:start",
+      "id": "devops:stage:environment:add",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "jit",
-      "state": "beta",
       "strict": true,
-      "summary": "Deploy changes from a branch to the pipeline stage’s org.",
+      "summary": "Add a Salesforce environment to a pipeline stage.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
-        "project",
-        "deploy",
-        "pipeline",
-        "start.js"
+        "devops",
+        "stage",
+        "environment",
+        "add.js"
       ]
     },
-    "project:deploy:pipeline:validate": {
+    "devops:stage:environment:delete": {
       "aliases": [],
       "args": {},
-      "description": "The first time you run any \"project deploy pipeline\" command, be sure to authorize the org in which DevOps Center is installed. The easiest way to authorize an org is with the \"org login web\" command.\n\nA validation runs Apex tests to verify whether a deployment will succeed without actually deploying the metadata to your environment, so you can then quickly deploy the changes later without re-running the tests.",
+      "description": "Removes the specified environment from the pipeline stage. The environment must belong to an inactive pipeline.",
       "examples": [
-        "Perform a validate-only deployment from the Staging branch to the Staging environment (sandbox):\n<%= config.bin %> <%= command.id %> --devops-center-project-name “Recruiting App” --branch-name staging --devops-center-username MyStagingSandbox",
-        "Perform a validate-only deployment of all changes from the main branch to the release environment:\n<%= config.bin %> <%= command.id %> --devops-center-project-name “Recruiting App” --branch-name main --devops-center-username MyReleaseOrg --deploy-all"
+        "Delete an environment:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --environment-id 0Xe000000000001"
       ],
       "flags": {
         "json": {
@@ -4991,129 +5062,58 @@
           "multiple": false,
           "type": "option"
         },
-        "branch-name": {
-          "char": "b",
-          "name": "branch-name",
+        "target-org": {
+          "char": "o",
+          "name": "target-org",
+          "noCacheDefault": true,
           "required": true,
-          "summary": "Name of the branch in the source control repository that corresponds to the pipeline stage that you want to deploy the changes to.",
-          "hasDynamicHelp": false,
+          "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"
         },
-        "bundle-version-name": {
-          "char": "v",
-          "description": "You must indicate the bundle version if deploying to the environment that corresponds to the first stage after the bundling stage.",
-          "name": "bundle-version-name",
-          "summary": "Version name of the bundle.",
+        "api-version": {
+          "description": "Override the api version used for api requests made by this command",
+          "name": "api-version",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "deploy-all": {
-          "char": "a",
-          "description": "If you don’t specify this flag, only changes in the stage’s branch are deployed.",
-          "name": "deploy-all",
-          "summary": "Deploy all metadata in the branch to the stage's org.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "devops-center-project-name": {
-          "char": "p",
-          "name": "devops-center-project-name",
+        "pipeline-id": {
+          "name": "pipeline-id",
           "required": true,
-          "summary": "Name of the DevOps Center project.",
+          "summary": "ID of the pipeline. Used to verify the pipeline is inactive before deleting.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "devops-center-username": {
-          "char": "c",
-          "name": "devops-center-username",
+        "environment-id": {
+          "char": "e",
+          "name": "environment-id",
           "required": true,
-          "summary": "Username or alias of the DevOps Center org.",
-          "hasDynamicHelp": true,
-          "multiple": false,
-          "type": "option"
-        },
-        "tests": {
-          "char": "t",
-          "description": "Separate multiple test names with commas. Enclose the entire flag value in double quotes if a test name contains spaces.",
-          "name": "tests",
-          "summary": "Apex tests to run when --test-level is RunSpecifiedTests.",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "test-level": {
-          "char": "l",
-          "description": "Valid values are:\n\n- NoTestRun — No tests are run. This test level applies only to deployments to development environments, such as sandbox, Developer Edition, or trial orgs. This test level is the default for development environments.\n\n- RunSpecifiedTests — Runs only the tests that you specify with the --tests flag. Code coverage requirements differ from the default coverage requirements when using this test level. Executed tests must comprise a minimum of 75% code coverage for each class and trigger in the deployment package. This coverage is computed for each class and trigger individually and is different than the overall coverage percentage.\n\n- RunLocalTests — All tests in your org are run, except the ones that originate from installed managed and unlocked packages. This test level is the default for production deployments that include Apex classes or triggers.\n\n- RunAllTestsInOrg — All tests in your org are run, including tests of managed packages.\n\nIf you don’t specify a test level, the default behavior depends on the contents of your deployment package. For more information, see the section \"Running Tests in a Deployment\" in the \"Metadata API Developer Guide\". (https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_deploy_running_tests.htm)",
-          "name": "test-level",
-          "summary": "Deployment Apex testing level.",
+          "summary": "ID of the environment to delete.",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "NoTestRun",
-            "RunSpecifiedTests",
-            "RunLocalTests",
-            "RunAllTestsInOrg"
-          ],
-          "type": "option"
-        },
-        "async": {
-          "description": "The command immediately returns the job ID and control of the terminal to you. This way, you can continue to use the CLI. To resume the deployment, run \"sf project deploy pipeline resume\". To check the status of the deployment, run \"sf project deploy pipeline report\".",
-          "name": "async",
-          "summary": "Run the command asynchronously.",
-          "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 check the status of the operation, run \"sf project deploy pipeline report\".",
-          "exclusive": [
-            "async"
-          ],
-          "name": "wait",
-          "summary": "Number of minutes to wait for command to complete and display results.",
-          "default": "33 minutes",
-          "hasDynamicHelp": true,
-          "helpValue": "<minutes>",
-          "multiple": false,
           "type": "option"
-        },
-        "verbose": {
-          "name": "verbose",
-          "summary": "Show verbose output of the command result.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "concise": {
-          "exclusive": [
-            "verbose"
-          ],
-          "name": "concise",
-          "summary": "Show concise output of the command result.",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "project:deploy:pipeline:validate",
+      "id": "devops:stage:environment:delete",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "jit",
-      "state": "beta",
       "strict": true,
-      "summary": "Perform a validate-only deployment from a branch to the pipeline stage’s org.",
+      "summary": "Delete an environment from a DevOps Center pipeline stage.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
-        "project",
-        "deploy",
-        "pipeline",
-        "validate.js"
+        "devops",
+        "stage",
+        "environment",
+        "delete.js"
       ]
     },
     "flow:get:log": {
@@ -5758,15 +5758,16 @@
         "site:dev:lightning"
       ]
     },
-    "org:create:shape": {
+    "org:get:snapshot": {
       "aliases": [
-        "force:org:shape:create"
+        "force:org:snapshot:get"
       ],
       "args": {},
       "deprecateAliases": true,
-      "description": "Scratch org shapes mimic the baseline setup (features, limits, edition, and Metadata API settings) of a source org without the extraneous data and metadata.\n\nRun \"<%= config.bin %> org list shape\" to view the available org shapes and their IDs.\n\nTo create a scratch org from an org shape, include the \"sourceOrg\" property in the scratch org definition file and set it to the org ID of the source org. Then create a scratch org with the \"<%= config.bin %> org create scratch\" command.",
+      "description": "Snapshot creation can take a while. Use this command with the snapshot name or ID to check its creation status. After the status changes to Active, you can use the snapshot to create scratch orgs.\n\nTo create a snapshot, use the \"<%= config.bin %> org create snapshot\" command. To retrieve a list of all snapshots, use \"<%= config.bin %> org list snapshot\".",
       "examples": [
-        "Create an org shape for the source org with alias SourceOrg:\n<%= config.bin %> <%= command.id %> --target-org SourceOrg"
+        "Get snapshot details using its ID and the default Dev Hub org:\n<%= config.bin %> <%= command.id %> --snapshot 0Oo...",
+        "Get snapshot details using its name from a Dev Hub org with alias SnapshotDevHub:\n<%= config.bin %> <%= command.id %> --snapshot Dependencies --target-dev-hub SnapshotDevHub"
       ],
       "flags": {
         "json": {
@@ -5784,17 +5785,16 @@
           "multiple": false,
           "type": "option"
         },
-        "target-org": {
+        "target-dev-hub": {
           "aliases": [
-            "targetusername",
-            "u"
+            "targetdevhubusername"
           ],
-          "char": "o",
+          "char": "v",
           "deprecateAliases": true,
-          "name": "target-org",
+          "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. Not required if the `target-dev-hub` configuration variable is already set.",
           "hasDynamicHelp": true,
           "multiple": false,
           "type": "option"
@@ -5819,70 +5819,80 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "snapshot": {
+          "char": "s",
+          "description": "The IDs of scratch org snapshots start with 0Oo.",
+          "name": "snapshot",
+          "required": true,
+          "summary": "Name or ID of snapshot to retrieve.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "org:create:shape",
+      "id": "org:get:snapshot",
       "pluginAlias": "@salesforce/plugin-signups",
       "pluginName": "@salesforce/plugin-signups",
       "pluginType": "jit",
       "strict": true,
-      "summary": "Create a scratch org configuration (shape) based on the specified source org.",
+      "summary": "Get details about a scratch org snapshot.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "org",
-        "create",
-        "shape.js"
+        "get",
+        "snapshot.js"
       ],
       "aliasPermutations": [
-        "force:org:shape:create",
-        "org:force:shape:create",
-        "org:shape:force:create",
-        "org:shape:create:force",
-        "force:shape:org:create",
-        "shape:force:org:create",
-        "shape:org:force:create",
-        "shape:org:create:force",
-        "force:shape:create:org",
-        "shape:force:create:org",
-        "shape:create:force:org",
-        "shape:create:org:force",
-        "force:org:create:shape",
-        "org:force:create:shape",
-        "org:create:force:shape",
-        "org:create:shape:force",
-        "force:create:org:shape",
-        "create:force:org:shape",
-        "create:org:force:shape",
-        "create:org:shape:force",
-        "force:create:shape:org",
-        "create:force:shape:org",
-        "create:shape:force:org",
-        "create:shape:org:force"
+        "force:org:snapshot:get",
+        "org:force:snapshot:get",
+        "org:snapshot:force:get",
+        "org:snapshot:get:force",
+        "force:snapshot:org:get",
+        "snapshot:force:org:get",
+        "snapshot:org:force:get",
+        "snapshot:org:get:force",
+        "force:snapshot:get:org",
+        "snapshot:force:get:org",
+        "snapshot:get:force:org",
+        "snapshot:get:org:force",
+        "force:org:get:snapshot",
+        "org:force:get:snapshot",
+        "org:get:force:snapshot",
+        "org:get:snapshot:force",
+        "force:get:org:snapshot",
+        "get:force:org:snapshot",
+        "get:org:force:snapshot",
+        "get:org:snapshot:force",
+        "force:get:snapshot:org",
+        "get:force:snapshot:org",
+        "get:snapshot:force:org",
+        "get:snapshot:org:force"
       ],
       "permutations": [
-        "org:create:shape",
-        "create:org:shape",
-        "create:shape:org",
-        "org:shape:create",
-        "shape:org:create",
-        "shape:create:org"
+        "org:get:snapshot",
+        "get:org:snapshot",
+        "get:snapshot:org",
+        "org:snapshot:get",
+        "snapshot:org:get",
+        "snapshot:get:org"
       ]
     },
-    "org:create:snapshot": {
+    "org:list:shape": {
       "aliases": [
-        "force:org:snapshot:create"
+        "force:org:shape:list"
       ],
       "args": {},
       "deprecateAliases": true,
-      "description": "A snapshot is a point-in-time copy of a scratch org. The copy is referenced by its unique name in a scratch org definition file.\n\nUse \"<%= config.bin %> org get snapshot\" to get details, including status, about a snapshot creation request.\n\nTo create a scratch org from a snapshot, include the \"snapshot\" option (instead of \"edition\") in the scratch org definition file and set it to the name of the snapshot. Then use \"<%= config.bin %> org create scratch\" to create the scratch org.",
+      "description": "The output includes the alias, username, and ID of the source org, the status of the org shape creation, and more. Use the org ID to update your scratch org configuration file so you can create a scratch org based on this org shape.",
       "examples": [
-        "Create a snapshot called \"Dependencies\" using the source scratch org ID and your default Dev Hub org:\n<%= config.bin %> <%= command.id %> --source-org 00Dxx0000000000 --name Dependencies --description 'Contains PackageA v1.1.0'",
-        "Create a snapshot called \"NightlyBranch\" using the source scratch org username and a Dev Hub org with alias NightlyDevHub:\n<%= config.bin %> <%= command.id %> --source-org myuser@myorg --name NightlyBranch --description 'Contains PkgA v2.1.0 and PkgB 3.3.0' --target-dev-hub NightlyDevHub"
+        "List all org shapes you've created:\n<%= config.bin %> <%= command.id %>",
+        "List all org shapes in JSON format and write the output to a file:\n<%= config.bin %> <%= command.id %> --json > tmp/MyOrgShapeList.json"
       ],
       "flags": {
         "json": {
@@ -5900,30 +5910,12 @@
           "multiple": false,
           "type": "option"
         },
-        "target-dev-hub": {
-          "aliases": [
-            "targetdevhubusername"
-          ],
-          "char": "v",
-          "deprecateAliases": true,
-          "name": "target-dev-hub",
-          "noCacheDefault": true,
-          "required": true,
-          "summary": "Username or alias of the Dev Hub org. Not required if the `target-dev-hub` configuration variable is already set.",
-          "hasDynamicHelp": true,
-          "multiple": false,
-          "type": "option"
-        },
-        "api-version": {
-          "aliases": [
-            "apiversion"
-          ],
-          "deprecateAliases": true,
-          "description": "Override the api version used for api requests made by this command",
-          "name": "api-version",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "verbose": {
+          "hidden": true,
+          "name": "verbose",
+          "summary": "List more information about each org shape.",
+          "allowNo": false,
+          "type": "boolean"
         },
         "loglevel": {
           "deprecated": {
@@ -5934,105 +5926,70 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "source-org": {
-          "aliases": [
-            "sourceorg"
-          ],
-          "char": "o",
-          "deprecateAliases": true,
-          "name": "source-org",
-          "required": true,
-          "summary": "ID or locally authenticated username or alias of scratch org to snapshot.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "name": {
-          "aliases": [
-            "snapshotname"
-          ],
-          "char": "n",
-          "deprecateAliases": true,
-          "name": "name",
-          "required": true,
-          "summary": "Unique name of snapshot.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "description": {
-          "char": "d",
-          "description": "Use this description to document the contents of the snapshot. We suggest that you include a reference point, such as a version control system tag or commit ID.",
-          "name": "description",
-          "summary": "Description of snapshot.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
-      "hasDynamicHelp": true,
+      "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "org:create:snapshot",
+      "id": "org:list:shape",
       "pluginAlias": "@salesforce/plugin-signups",
       "pluginName": "@salesforce/plugin-signups",
       "pluginType": "jit",
       "strict": true,
-      "summary": "Create a snapshot of a scratch org.",
+      "summary": "List all org shapes you’ve created.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "org",
-        "create",
-        "snapshot.js"
+        "list",
+        "shape.js"
       ],
       "aliasPermutations": [
-        "force:org:snapshot:create",
-        "org:force:snapshot:create",
-        "org:snapshot:force:create",
-        "org:snapshot:create:force",
-        "force:snapshot:org:create",
-        "snapshot:force:org:create",
-        "snapshot:org:force:create",
-        "snapshot:org:create:force",
-        "force:snapshot:create:org",
-        "snapshot:force:create:org",
-        "snapshot:create:force:org",
-        "snapshot:create:org:force",
-        "force:org:create:snapshot",
-        "org:force:create:snapshot",
-        "org:create:force:snapshot",
-        "org:create:snapshot:force",
-        "force:create:org:snapshot",
-        "create:force:org:snapshot",
-        "create:org:force:snapshot",
-        "create:org:snapshot:force",
-        "force:create:snapshot:org",
-        "create:force:snapshot:org",
-        "create:snapshot:force:org",
-        "create:snapshot:org:force"
+        "force:org:shape:list",
+        "org:force:shape:list",
+        "org:shape:force:list",
+        "org:shape:list:force",
+        "force:shape:org:list",
+        "shape:force:org:list",
+        "shape:org:force:list",
+        "shape:org:list:force",
+        "force:shape:list:org",
+        "shape:force:list:org",
+        "shape:list:force:org",
+        "shape:list:org:force",
+        "force:org:list:shape",
+        "org:force:list:shape",
+        "org:list:force:shape",
+        "org:list:shape:force",
+        "force:list:org:shape",
+        "list:force:org:shape",
+        "list:org:force:shape",
+        "list:org:shape:force",
+        "force:list:shape:org",
+        "list:force:shape:org",
+        "list:shape:force:org",
+        "list:shape:org:force"
       ],
       "permutations": [
-        "org:create:snapshot",
-        "create:org:snapshot",
-        "create:snapshot:org",
-        "org:snapshot:create",
-        "snapshot:org:create",
-        "snapshot:create:org"
+        "org:list:shape",
+        "list:org:shape",
+        "list:shape:org",
+        "org:shape:list",
+        "shape:org:list",
+        "shape:list:org"
       ]
     },
-    "org:delete:shape": {
+    "org:list:snapshot": {
       "aliases": [
-        "force:org:shape:delete"
+        "force:org:snapshot:list"
       ],
       "args": {},
       "deprecateAliases": true,
-      "description": "A source org can have only one active org shape. If you try to create an org shape for a source org that already has one, the previous shape is marked inactive and replaced by a new active shape. If you don’t want to create scratch orgs based on this shape, you can delete the org shape.",
+      "description": "You can view all the snapshots in a Dev Hub that you have access to. If you’re an admin, you can see all snapshots associated with the Dev Hub org. If you’re a user, you can see only your snapshots unless a Dev Hub admin gives you View All permissions.\n\nTo create a snapshot, use the \"<%= config.bin %> org create snapshot\" command. To get details about a snapshot request, use \"<%= config.bin %> org get snapshot\".",
       "examples": [
-        "Delete all org shapes for the source org with alias SourceOrg:\n<%= config.bin %> <%= command.id %> --target-org SourceOrg",
-        "Delete all org shapes without prompting:\n<%= config.bin %> <%= command.id %> --target-org SourceOrg --no-prompt"
+        "List snapshots in the default Dev Hub:\n<%= config.bin %> <%= command.id %>",
+        "List snapshots in the Dev Hub with alias SnapshotDevHub:\n<%= config.bin %> <%= command.id %> --target-dev-hub SnapshotDevHub"
       ],
       "flags": {
         "json": {
@@ -6050,17 +6007,16 @@
           "multiple": false,
           "type": "option"
         },
-        "target-org": {
+        "target-dev-hub": {
           "aliases": [
-            "targetusername",
-            "u"
+            "targetdevhubusername"
           ],
-          "char": "o",
+          "char": "v",
           "deprecateAliases": true,
-          "name": "target-org",
+          "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. Not required if the `target-dev-hub` configuration variable is already set.",
           "hasDynamicHelp": true,
           "multiple": false,
           "type": "option"
@@ -6085,16 +6041,132 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "no-prompt": {
-          "aliases": [
-            "noprompt"
-          ],
-          "char": "p",
-          "deprecateAliases": true,
-          "name": "no-prompt",
-          "summary": "Don't prompt for confirmation.",
-          "allowNo": false,
+        }
+      },
+      "hasDynamicHelp": true,
+      "hiddenAliases": [],
+      "id": "org:list:snapshot",
+      "pluginAlias": "@salesforce/plugin-signups",
+      "pluginName": "@salesforce/plugin-signups",
+      "pluginType": "jit",
+      "strict": true,
+      "summary": "List scratch org snapshots.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "org",
+        "list",
+        "snapshot.js"
+      ],
+      "aliasPermutations": [
+        "force:org:snapshot:list",
+        "org:force:snapshot:list",
+        "org:snapshot:force:list",
+        "org:snapshot:list:force",
+        "force:snapshot:org:list",
+        "snapshot:force:org:list",
+        "snapshot:org:force:list",
+        "snapshot:org:list:force",
+        "force:snapshot:list:org",
+        "snapshot:force:list:org",
+        "snapshot:list:force:org",
+        "snapshot:list:org:force",
+        "force:org:list:snapshot",
+        "org:force:list:snapshot",
+        "org:list:force:snapshot",
+        "org:list:snapshot:force",
+        "force:list:org:snapshot",
+        "list:force:org:snapshot",
+        "list:org:force:snapshot",
+        "list:org:snapshot:force",
+        "force:list:snapshot:org",
+        "list:force:snapshot:org",
+        "list:snapshot:force:org",
+        "list:snapshot:org:force"
+      ],
+      "permutations": [
+        "org:list:snapshot",
+        "list:org:snapshot",
+        "list:snapshot:org",
+        "org:snapshot:list",
+        "snapshot:org:list",
+        "snapshot:list:org"
+      ]
+    },
+    "org:delete:shape": {
+      "aliases": [
+        "force:org:shape:delete"
+      ],
+      "args": {},
+      "deprecateAliases": true,
+      "description": "A source org can have only one active org shape. If you try to create an org shape for a source org that already has one, the previous shape is marked inactive and replaced by a new active shape. If you don’t want to create scratch orgs based on this shape, you can delete the org shape.",
+      "examples": [
+        "Delete all org shapes for the source org with alias SourceOrg:\n<%= config.bin %> <%= command.id %> --target-org SourceOrg",
+        "Delete all org shapes without prompting:\n<%= config.bin %> <%= command.id %> --target-org SourceOrg --no-prompt"
+      ],
+      "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"
+        },
+        "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"
+        },
+        "api-version": {
+          "aliases": [
+            "apiversion"
+          ],
+          "deprecateAliases": true,
+          "description": "Override the api version used for api requests made by this command",
+          "name": "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 `SF_LOG_LEVEL` environment variable."
+          },
+          "hidden": true,
+          "name": "loglevel",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "no-prompt": {
+          "aliases": [
+            "noprompt"
+          ],
+          "char": "p",
+          "deprecateAliases": true,
+          "name": "no-prompt",
+          "summary": "Don't prompt for confirmation.",
+          "allowNo": false,
           "type": "boolean"
         }
       },
@@ -6282,16 +6354,15 @@
         "snapshot:delete:org"
       ]
     },
-    "org:get:snapshot": {
+    "org:create:shape": {
       "aliases": [
-        "force:org:snapshot:get"
+        "force:org:shape:create"
       ],
       "args": {},
       "deprecateAliases": true,
-      "description": "Snapshot creation can take a while. Use this command with the snapshot name or ID to check its creation status. After the status changes to Active, you can use the snapshot to create scratch orgs.\n\nTo create a snapshot, use the \"<%= config.bin %> org create snapshot\" command. To retrieve a list of all snapshots, use \"<%= config.bin %> org list snapshot\".",
+      "description": "Scratch org shapes mimic the baseline setup (features, limits, edition, and Metadata API settings) of a source org without the extraneous data and metadata.\n\nRun \"<%= config.bin %> org list shape\" to view the available org shapes and their IDs.\n\nTo create a scratch org from an org shape, include the \"sourceOrg\" property in the scratch org definition file and set it to the org ID of the source org. Then create a scratch org with the \"<%= config.bin %> org create scratch\" command.",
       "examples": [
-        "Get snapshot details using its ID and the default Dev Hub org:\n<%= config.bin %> <%= command.id %> --snapshot 0Oo...",
-        "Get snapshot details using its name from a Dev Hub org with alias SnapshotDevHub:\n<%= config.bin %> <%= command.id %> --snapshot Dependencies --target-dev-hub SnapshotDevHub"
+        "Create an org shape for the source org with alias SourceOrg:\n<%= config.bin %> <%= command.id %> --target-org SourceOrg"
       ],
       "flags": {
         "json": {
@@ -6309,16 +6380,17 @@
           "multiple": false,
           "type": "option"
         },
-        "target-dev-hub": {
+        "target-org": {
           "aliases": [
-            "targetdevhubusername"
+            "targetusername",
+            "u"
           ],
-          "char": "v",
+          "char": "o",
           "deprecateAliases": true,
-          "name": "target-dev-hub",
+          "name": "target-org",
           "noCacheDefault": true,
           "required": true,
-          "summary": "Username or alias of the Dev Hub org. Not required if the `target-dev-hub` configuration variable is already set.",
+          "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"
@@ -6343,177 +6415,70 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "snapshot": {
-          "char": "s",
-          "description": "The IDs of scratch org snapshots start with 0Oo.",
-          "name": "snapshot",
-          "required": true,
-          "summary": "Name or ID of snapshot to retrieve.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "org:get:snapshot",
-      "pluginAlias": "@salesforce/plugin-signups",
-      "pluginName": "@salesforce/plugin-signups",
-      "pluginType": "jit",
-      "strict": true,
-      "summary": "Get details about a scratch org snapshot.",
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "lib",
-        "commands",
-        "org",
-        "get",
-        "snapshot.js"
-      ],
-      "aliasPermutations": [
-        "force:org:snapshot:get",
-        "org:force:snapshot:get",
-        "org:snapshot:force:get",
-        "org:snapshot:get:force",
-        "force:snapshot:org:get",
-        "snapshot:force:org:get",
-        "snapshot:org:force:get",
-        "snapshot:org:get:force",
-        "force:snapshot:get:org",
-        "snapshot:force:get:org",
-        "snapshot:get:force:org",
-        "snapshot:get:org:force",
-        "force:org:get:snapshot",
-        "org:force:get:snapshot",
-        "org:get:force:snapshot",
-        "org:get:snapshot:force",
-        "force:get:org:snapshot",
-        "get:force:org:snapshot",
-        "get:org:force:snapshot",
-        "get:org:snapshot:force",
-        "force:get:snapshot:org",
-        "get:force:snapshot:org",
-        "get:snapshot:force:org",
-        "get:snapshot:org:force"
-      ],
-      "permutations": [
-        "org:get:snapshot",
-        "get:org:snapshot",
-        "get:snapshot:org",
-        "org:snapshot:get",
-        "snapshot:org:get",
-        "snapshot:get:org"
-      ]
-    },
-    "org:list:shape": {
-      "aliases": [
-        "force:org:shape:list"
-      ],
-      "args": {},
-      "deprecateAliases": true,
-      "description": "The output includes the alias, username, and ID of the source org, the status of the org shape creation, and more. Use the org ID to update your scratch org configuration file so you can create a scratch org based on this org shape.",
-      "examples": [
-        "List all org shapes you've created:\n<%= config.bin %> <%= command.id %>",
-        "List all org shapes in JSON format and write the output to a file:\n<%= config.bin %> <%= command.id %> --json > tmp/MyOrgShapeList.json"
-      ],
-      "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"
-        },
-        "verbose": {
-          "hidden": true,
-          "name": "verbose",
-          "summary": "List more information about each org shape.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "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 `SF_LOG_LEVEL` environment variable."
-          },
-          "hidden": true,
-          "name": "loglevel",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "org:list:shape",
+      "id": "org:create:shape",
       "pluginAlias": "@salesforce/plugin-signups",
       "pluginName": "@salesforce/plugin-signups",
       "pluginType": "jit",
       "strict": true,
-      "summary": "List all org shapes you’ve created.",
+      "summary": "Create a scratch org configuration (shape) based on the specified source org.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "org",
-        "list",
+        "create",
         "shape.js"
       ],
       "aliasPermutations": [
-        "force:org:shape:list",
-        "org:force:shape:list",
-        "org:shape:force:list",
-        "org:shape:list:force",
-        "force:shape:org:list",
-        "shape:force:org:list",
-        "shape:org:force:list",
-        "shape:org:list:force",
-        "force:shape:list:org",
-        "shape:force:list:org",
-        "shape:list:force:org",
-        "shape:list:org:force",
-        "force:org:list:shape",
-        "org:force:list:shape",
-        "org:list:force:shape",
-        "org:list:shape:force",
-        "force:list:org:shape",
-        "list:force:org:shape",
-        "list:org:force:shape",
-        "list:org:shape:force",
-        "force:list:shape:org",
-        "list:force:shape:org",
-        "list:shape:force:org",
-        "list:shape:org:force"
+        "force:org:shape:create",
+        "org:force:shape:create",
+        "org:shape:force:create",
+        "org:shape:create:force",
+        "force:shape:org:create",
+        "shape:force:org:create",
+        "shape:org:force:create",
+        "shape:org:create:force",
+        "force:shape:create:org",
+        "shape:force:create:org",
+        "shape:create:force:org",
+        "shape:create:org:force",
+        "force:org:create:shape",
+        "org:force:create:shape",
+        "org:create:force:shape",
+        "org:create:shape:force",
+        "force:create:org:shape",
+        "create:force:org:shape",
+        "create:org:force:shape",
+        "create:org:shape:force",
+        "force:create:shape:org",
+        "create:force:shape:org",
+        "create:shape:force:org",
+        "create:shape:org:force"
       ],
       "permutations": [
-        "org:list:shape",
-        "list:org:shape",
-        "list:shape:org",
-        "org:shape:list",
-        "shape:org:list",
-        "shape:list:org"
+        "org:create:shape",
+        "create:org:shape",
+        "create:shape:org",
+        "org:shape:create",
+        "shape:org:create",
+        "shape:create:org"
       ]
     },
-    "org:list:snapshot": {
+    "org:create:snapshot": {
       "aliases": [
-        "force:org:snapshot:list"
+        "force:org:snapshot:create"
       ],
       "args": {},
       "deprecateAliases": true,
-      "description": "You can view all the snapshots in a Dev Hub that you have access to. If you’re an admin, you can see all snapshots associated with the Dev Hub org. If you’re a user, you can see only your snapshots unless a Dev Hub admin gives you View All permissions.\n\nTo create a snapshot, use the \"<%= config.bin %> org create snapshot\" command. To get details about a snapshot request, use \"<%= config.bin %> org get snapshot\".",
+      "description": "A snapshot is a point-in-time copy of a scratch org. The copy is referenced by its unique name in a scratch org definition file.\n\nUse \"<%= config.bin %> org get snapshot\" to get details, including status, about a snapshot creation request.\n\nTo create a scratch org from a snapshot, include the \"snapshot\" option (instead of \"edition\") in the scratch org definition file and set it to the name of the snapshot. Then use \"<%= config.bin %> org create scratch\" to create the scratch org.",
       "examples": [
-        "List snapshots in the default Dev Hub:\n<%= config.bin %> <%= command.id %>",
-        "List snapshots in the Dev Hub with alias SnapshotDevHub:\n<%= config.bin %> <%= command.id %> --target-dev-hub SnapshotDevHub"
+        "Create a snapshot called \"Dependencies\" using the source scratch org ID and your default Dev Hub org:\n<%= config.bin %> <%= command.id %> --source-org 00Dxx0000000000 --name Dependencies --description 'Contains PackageA v1.1.0'",
+        "Create a snapshot called \"NightlyBranch\" using the source scratch org username and a Dev Hub org with alias NightlyDevHub:\n<%= config.bin %> <%= command.id %> --source-org myuser@myorg --name NightlyBranch --description 'Contains PkgA v2.1.0 and PkgB 3.3.0' --target-dev-hub NightlyDevHub"
       ],
       "flags": {
         "json": {
@@ -6565,58 +6530,93 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "source-org": {
+          "aliases": [
+            "sourceorg"
+          ],
+          "char": "o",
+          "deprecateAliases": true,
+          "name": "source-org",
+          "required": true,
+          "summary": "ID or locally authenticated username or alias of scratch org to snapshot.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "aliases": [
+            "snapshotname"
+          ],
+          "char": "n",
+          "deprecateAliases": true,
+          "name": "name",
+          "required": true,
+          "summary": "Unique name of snapshot.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "description": {
+          "char": "d",
+          "description": "Use this description to document the contents of the snapshot. We suggest that you include a reference point, such as a version control system tag or commit ID.",
+          "name": "description",
+          "summary": "Description of snapshot.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "org:list:snapshot",
+      "id": "org:create:snapshot",
       "pluginAlias": "@salesforce/plugin-signups",
       "pluginName": "@salesforce/plugin-signups",
       "pluginType": "jit",
       "strict": true,
-      "summary": "List scratch org snapshots.",
+      "summary": "Create a snapshot of a scratch org.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "org",
-        "list",
+        "create",
         "snapshot.js"
       ],
       "aliasPermutations": [
-        "force:org:snapshot:list",
-        "org:force:snapshot:list",
-        "org:snapshot:force:list",
-        "org:snapshot:list:force",
-        "force:snapshot:org:list",
-        "snapshot:force:org:list",
-        "snapshot:org:force:list",
-        "snapshot:org:list:force",
-        "force:snapshot:list:org",
-        "snapshot:force:list:org",
-        "snapshot:list:force:org",
-        "snapshot:list:org:force",
-        "force:org:list:snapshot",
-        "org:force:list:snapshot",
-        "org:list:force:snapshot",
-        "org:list:snapshot:force",
-        "force:list:org:snapshot",
-        "list:force:org:snapshot",
-        "list:org:force:snapshot",
-        "list:org:snapshot:force",
-        "force:list:snapshot:org",
-        "list:force:snapshot:org",
-        "list:snapshot:force:org",
-        "list:snapshot:org:force"
+        "force:org:snapshot:create",
+        "org:force:snapshot:create",
+        "org:snapshot:force:create",
+        "org:snapshot:create:force",
+        "force:snapshot:org:create",
+        "snapshot:force:org:create",
+        "snapshot:org:force:create",
+        "snapshot:org:create:force",
+        "force:snapshot:create:org",
+        "snapshot:force:create:org",
+        "snapshot:create:force:org",
+        "snapshot:create:org:force",
+        "force:org:create:snapshot",
+        "org:force:create:snapshot",
+        "org:create:force:snapshot",
+        "org:create:snapshot:force",
+        "force:create:org:snapshot",
+        "create:force:org:snapshot",
+        "create:org:force:snapshot",
+        "create:org:snapshot:force",
+        "force:create:snapshot:org",
+        "create:force:snapshot:org",
+        "create:snapshot:force:org",
+        "create:snapshot:org:force"
       ],
       "permutations": [
-        "org:list:snapshot",
-        "list:org:snapshot",
-        "list:snapshot:org",
-        "org:snapshot:list",
-        "snapshot:org:list",
-        "snapshot:list:org"
+        "org:create:snapshot",
+        "create:org:snapshot",
+        "create:snapshot:org",
+        "org:snapshot:create",
+        "snapshot:org:create",
+        "snapshot:create:org"
       ]
     },
     "ui-bundle:dev": {
@@ -7024,5 +7024,5 @@
       "requiresProject": true
     }
   },
-  "version": "2.156.3"
+  "version": "2.156.5"
 }