@salesforce/plugin-devops-center 2.3.6 → 2.3.8

package/oclif.manifest.json

@@ -138,13 +138,17 @@
         "promote.js"
       ]
     },
-    "devops:project:create": {
+    "devops:pipeline:create": {
       "aliases": [],
       "args": {},
-      "description": "Creates a new DevOps Center project with the specified name and optional description.",
+      "description": "Provide the URL of an existing repository, or use `--create-repo` with a repository name to create one. After you create the pipeline, add stages, and activate the pipeline.",
       "examples": [
-        "Create a new DevOps Center project in the specified org.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"MyApp Release\"",
-        "Create a project with a name and description.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"Platform Update\" --description \"Platform services update\""
+        "Create a pipeline and associate it with an existing GitHub repository:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"Release Pipeline\" --repo https://github.com/myorg/myrepo",
+        "Create a pipeline and associate it with a new GitHub repository:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"Release Pipeline\" --repo my-new-repo --repo-type github --repo-owner myorg --create-repo",
+        "Create a pipeline and create a new Bitbucket repository:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"Release Pipeline\" --repo my-new-repo --repo-type bitbucket --bitbucket-workspace myworkspace --bitbucket-project-key PROJ --create-repo",
+        "Create a pipeline and associate it with an existing Bitbucket repository:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"Release Pipeline\" --repo https://bitbucket.org/myworkspace/myrepo",
+        "Create a pipeline with custom stage names instead of the default stages:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"Release Pipeline\" --repo https://github.com/myorg/myrepo --stage Dev --stage QA --stage Prod",
+        "Create a pipeline and associate one or more projects with it:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"Release Pipeline\" --repo https://github.com/myorg/myrepo --project-id 0Hn000000000001 --project-id 0Hn000000000002"
       ],
       "flags": {
         "json": {
@@ -183,45 +187,98 @@
           "char": "n",
           "name": "name",
           "required": true,
-          "summary": "Name of the new DevOps Center project.",
+          "summary": "Name of the pipeline.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "description": {
-          "char": "d",
-          "name": "description",
-          "summary": "Description of the new project; if not specified, the description is blank.",
+        "repo": {
+          "char": "r",
+          "name": "repo",
+          "required": true,
+          "summary": "URL of an existing repository or the name of a repository to create.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "repo-type": {
+          "name": "repo-type",
+          "summary": "Type of the source code repository. Required when creating a repository using '--create-repo'.",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "github",
+            "bitbucket"
+          ],
+          "type": "option"
+        },
+        "create-repo": {
+          "name": "create-repo",
+          "summary": "Create a repository if it doesn't exist.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "repo-owner": {
+          "name": "repo-owner",
+          "summary": "Owner (organization or user) of the GitHub repository. Required when creating a GitHub repository using '--create-repo'.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "bitbucket-workspace": {
+          "name": "bitbucket-workspace",
+          "summary": "Bitbucket workspace that will own the repository. Required when creating a Bitbucket repository using '--create-repo'.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "bitbucket-project-key": {
+          "name": "bitbucket-project-key",
+          "summary": "Bitbucket project key to associate with the repository. Optional when creating a Bitbucket repository using '--create-repo'.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "stage": {
+          "char": "s",
+          "name": "stage",
+          "summary": "Name of a pipeline stage, in promotion order. Repeat the flag for each stage. Defaults to Integration, UAT, Staging, and Production.",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "project-id": {
+          "name": "project-id",
+          "summary": "ID of a project to associate with the pipeline. Repeat the flag to associate multiple projects.",
+          "hasDynamicHelp": false,
+          "multiple": true,
           "type": "option"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "devops:project:create",
+      "id": "devops:pipeline:create",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "core",
       "strict": true,
-      "summary": "Create a DevOps Center project in a DevOps Center org.",
+      "summary": "Create a DevOps Center pipeline.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "devops",
-        "project",
+        "pipeline",
         "create.js"
       ]
     },
-    "devops:project:list": {
+    "devops:pipeline:get": {
       "aliases": [],
       "args": {},
-      "description": "This command queries the DevopsProject standard object and returns the project Id, Name, and Description for each project found.",
+      "description": "Returns full details for a single DevOps Center pipeline: its stages in order, the source code repository and branch associated with each stage, and any connected projects.",
       "examples": [
-        "List all DevOps Center projects in an org with alias \"my-devops-org\":\n<%= config.bin %> <%= command.id %> --target-org my-devops-org",
-        "List projects using an org's username:\n<%= config.bin %> <%= command.id %> --target-org devops-center@example.com"
+        "Get details for a specific pipeline:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Do000000000001"
       ],
       "flags": {
         "json": {
@@ -255,35 +312,41 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "pipeline-id": {
+          "char": "i",
+          "name": "pipeline-id",
+          "required": true,
+          "summary": "ID of the DevOps Center pipeline.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "devops:project:list",
+      "id": "devops:pipeline:get",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "core",
       "strict": true,
-      "summary": "List all DevOps Center projects in a Salesforce org.",
+      "summary": "Get details of a DevOps Center pipeline including its stages, repositories, and connected projects.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "devops",
-        "project",
-        "list.js"
+        "pipeline",
+        "get.js"
       ]
     },
-    "devops:project:update": {
+    "devops:pipeline:list": {
       "aliases": [],
       "args": {},
-      "description": "Update the name, description, or active status of a DevOps Center project. At least one of --name, --description, or --is-active must be provided.",
+      "description": "Returns all DevOps Center pipelines in the org, including each pipeline's stages (in order), source code repository information per stage, and any connected projects.",
       "examples": [
-        "Rename a project:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --name \"MyApp Release v2\"",
-        "Update the description of a project:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --description \"Updated release description\"",
-        "Deactivate a project:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --no-is-active",
-        "Update all fields at once:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --name \"Archived App\" --description \"Archived\" --no-is-active"
+        "List all pipelines in the org:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org"
       ],
       "flags": {
         "json": {
@@ -317,68 +380,33 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "project-id": {
-          "char": "i",
-          "name": "project-id",
-          "required": true,
-          "summary": "ID of the DevOps Center project to update.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "name": {
-          "char": "n",
-          "name": "name",
-          "summary": "New name for the project.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "description": {
-          "char": "d",
-          "name": "description",
-          "summary": "New description for the project.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "is-active": {
-          "name": "is-active",
-          "summary": "Set the project active status. Use --is-active to activate or --no-is-active to deactivate.",
-          "allowNo": true,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "devops:project:update",
+      "id": "devops:pipeline:list",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "core",
       "strict": true,
-      "summary": "Update a DevOps Center project.",
+      "summary": "List DevOps Center pipelines with their stages, repositories, and connected projects.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "devops",
-        "project",
-        "update.js"
+        "pipeline",
+        "list.js"
       ]
     },
-    "devops:pipeline:create": {
+    "devops:pipeline:update": {
       "aliases": [],
       "args": {},
-      "description": "Provide the URL of an existing repository, or use `--create-repo` with a repository name to create one. After you create the pipeline, add stages, and activate the pipeline.",
+      "description": "Activate, deactivate, or rename a DevOps Center pipeline. Use --activate to activate, --deactivate to deactivate, and --name to rename. You can combine --deactivate and --name in one command.\n\nA pipeline must have at least one stage before you can activate it. You can't modify the pipeline stages after you activate and promote changes through it.",
       "examples": [
-        "Create a pipeline and associate it with an existing GitHub repository:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"Release Pipeline\" --repo https://github.com/myorg/myrepo",
-        "Create a pipeline and associate it with a new GitHub repository:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"Release Pipeline\" --repo my-new-repo --repo-type github --repo-owner myorg --create-repo",
-        "Create a pipeline and create a new Bitbucket repository:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"Release Pipeline\" --repo my-new-repo --repo-type bitbucket --bitbucket-workspace myworkspace --bitbucket-project-key PROJ --create-repo",
-        "Create a pipeline and associate it with an existing Bitbucket repository:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"Release Pipeline\" --repo https://bitbucket.org/myworkspace/myrepo",
-        "Create a pipeline with custom stage names instead of the default stages:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"Release Pipeline\" --repo https://github.com/myorg/myrepo --stage Dev --stage QA --stage Prod",
-        "Create a pipeline and associate one or more projects with it:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"Release Pipeline\" --repo https://github.com/myorg/myrepo --project-id 0Hn000000000001 --project-id 0Hn000000000002"
+        "Activate a pipeline:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --activate",
+        "Deactivate and rename in one step.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --deactivate --name \"My Pipeline\""
       ],
       "flags": {
         "json": {
@@ -413,86 +441,52 @@
           "multiple": false,
           "type": "option"
         },
-        "name": {
-          "char": "n",
-          "name": "name",
-          "required": true,
-          "summary": "Name of the pipeline.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "repo": {
-          "char": "r",
-          "name": "repo",
+        "pipeline-id": {
+          "name": "pipeline-id",
           "required": true,
-          "summary": "URL of an existing repository or the name of a repository to create.",
+          "summary": "ID of the pipeline.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "repo-type": {
-          "name": "repo-type",
-          "summary": "Type of the source code repository. Required when creating a repository using '--create-repo'.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "github",
-            "bitbucket"
+        "activate": {
+          "exclusive": [
+            "deactivate"
           ],
-          "type": "option"
-        },
-        "create-repo": {
-          "name": "create-repo",
-          "summary": "Create a repository if it doesn't exist.",
+          "name": "activate",
+          "required": false,
+          "summary": "Activate the pipeline. Can't be used with --deactivate.",
           "allowNo": false,
           "type": "boolean"
         },
-        "repo-owner": {
-          "name": "repo-owner",
-          "summary": "Owner (organization or user) of the GitHub repository. Required when creating a GitHub repository using '--create-repo'.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "bitbucket-workspace": {
-          "name": "bitbucket-workspace",
-          "summary": "Bitbucket workspace that will own the repository. Required when creating a Bitbucket repository using '--create-repo'.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "deactivate": {
+          "exclusive": [
+            "activate"
+          ],
+          "name": "deactivate",
+          "required": false,
+          "summary": "Deactivate the pipeline. Can't be used with --activate.",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "bitbucket-project-key": {
-          "name": "bitbucket-project-key",
-          "summary": "Bitbucket project key to associate with the repository. Optional when creating a Bitbucket repository using '--create-repo'.",
+        "name": {
+          "char": "n",
+          "name": "name",
+          "required": false,
+          "summary": "New name for the pipeline.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "stage": {
-          "char": "s",
-          "name": "stage",
-          "summary": "Name of a pipeline stage, in promotion order. Repeat the flag for each stage. Defaults to Integration, UAT, Staging, and Production.",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "project-id": {
-          "name": "project-id",
-          "summary": "ID of a project to associate with the pipeline. Repeat the flag to associate multiple projects.",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "devops:pipeline:create",
+      "id": "devops:pipeline:update",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "core",
       "strict": true,
-      "summary": "Create a DevOps Center pipeline.",
+      "summary": "Update a DevOps Center pipeline.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -500,15 +494,16 @@
         "commands",
         "devops",
         "pipeline",
-        "create.js"
+        "update.js"
       ]
     },
-    "devops:pipeline:get": {
+    "devops:project:create": {
       "aliases": [],
       "args": {},
-      "description": "Returns full details for a single DevOps Center pipeline: its stages in order, the source code repository and branch associated with each stage, and any connected projects.",
+      "description": "Creates a new DevOps Center project with the specified name and optional description.",
       "examples": [
-        "Get details for a specific pipeline:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Do000000000001"
+        "Create a new DevOps Center project in the specified org.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"MyApp Release\"",
+        "Create a project with a name and description.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"Platform Update\" --description \"Platform services update\""
       ],
       "flags": {
         "json": {
@@ -543,11 +538,19 @@
           "multiple": false,
           "type": "option"
         },
-        "pipeline-id": {
-          "char": "i",
-          "name": "pipeline-id",
+        "name": {
+          "char": "n",
+          "name": "name",
           "required": true,
-          "summary": "ID of the DevOps Center pipeline.",
+          "summary": "Name of the new DevOps Center project.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "description": {
+          "char": "d",
+          "name": "description",
+          "summary": "Description of the new project; if not specified, the description is blank.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -555,28 +558,29 @@
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "devops:pipeline:get",
+      "id": "devops:project:create",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "core",
       "strict": true,
-      "summary": "Get details of a DevOps Center pipeline including its stages, repositories, and connected projects.",
+      "summary": "Create a DevOps Center project in a DevOps Center org.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "devops",
-        "pipeline",
-        "get.js"
+        "project",
+        "create.js"
       ]
     },
-    "devops:pipeline:list": {
+    "devops:project:list": {
       "aliases": [],
       "args": {},
-      "description": "Returns all DevOps Center pipelines in the org, including each pipeline's stages (in order), source code repository information per stage, and any connected projects.",
+      "description": "This command queries the DevopsProject standard object and returns the project Id, Name, and Description for each project found.",
       "examples": [
-        "List all pipelines in the org:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org"
+        "List all DevOps Center projects in an org with alias \"my-devops-org\":\n<%= config.bin %> <%= command.id %> --target-org my-devops-org",
+        "List projects using an org's username:\n<%= config.bin %> <%= command.id %> --target-org devops-center@example.com"
       ],
       "flags": {
         "json": {
@@ -614,29 +618,31 @@
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "devops:pipeline:list",
+      "id": "devops:project:list",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "core",
       "strict": true,
-      "summary": "List DevOps Center pipelines with their stages, repositories, and connected projects.",
+      "summary": "List all DevOps Center projects in a Salesforce org.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "devops",
-        "pipeline",
+        "project",
         "list.js"
       ]
     },
-    "devops:pipeline:update": {
+    "devops:project:update": {
       "aliases": [],
       "args": {},
-      "description": "Activate, deactivate, or rename a DevOps Center pipeline. Use --activate to activate, --deactivate to deactivate, and --name to rename. You can combine --deactivate and --name in one command.\n\nA pipeline must have at least one stage before you can activate it. You can't modify the pipeline stages after you activate and promote changes through it.",
+      "description": "Update the name, description, or active status of a DevOps Center project. At least one of --name, --description, or --is-active must be provided.",
       "examples": [
-        "Activate a pipeline:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --activate",
-        "Deactivate and rename in one step.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --deactivate --name \"My Pipeline\""
+        "Rename a project:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --name \"MyApp Release v2\"",
+        "Update the description of a project:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --description \"Updated release description\"",
+        "Deactivate a project:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --no-is-active",
+        "Update all fields at once:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --name \"Archived App\" --description \"Archived\" --no-is-active"
       ],
       "flags": {
         "json": {
@@ -671,59 +677,53 @@
           "multiple": false,
           "type": "option"
         },
-        "pipeline-id": {
-          "name": "pipeline-id",
+        "project-id": {
+          "char": "i",
+          "name": "project-id",
           "required": true,
-          "summary": "ID of the pipeline.",
+          "summary": "ID of the DevOps Center project to update.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "activate": {
-          "exclusive": [
-            "deactivate"
-          ],
-          "name": "activate",
-          "required": false,
-          "summary": "Activate the pipeline. Can't be used with --deactivate.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "deactivate": {
-          "exclusive": [
-            "activate"
-          ],
-          "name": "deactivate",
-          "required": false,
-          "summary": "Deactivate the pipeline. Can't be used with --activate.",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "name": {
           "char": "n",
           "name": "name",
-          "required": false,
-          "summary": "New name for the pipeline.",
+          "summary": "New name for the project.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "description": {
+          "char": "d",
+          "name": "description",
+          "summary": "New description for the project.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "is-active": {
+          "name": "is-active",
+          "summary": "Set the project active status. Use --is-active to activate or --no-is-active to deactivate.",
+          "allowNo": true,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "devops:pipeline:update",
+      "id": "devops:project:update",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "core",
       "strict": true,
-      "summary": "Update a DevOps Center pipeline.",
+      "summary": "Update a DevOps Center project.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "devops",
-        "pipeline",
+        "project",
         "update.js"
       ]
     },
@@ -915,13 +915,12 @@
         "validate.js"
       ]
     },
-    "devops:review:create": {
+    "devops:request:status": {
       "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": "Returns the current status of a request identified by its request token.",
       "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"
+        "Get the status of a request:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --request-token a0B000000000001"
       ],
       "flags": {
         "json": {
@@ -956,18 +955,11 @@
           "multiple": false,
           "type": "option"
         },
-        "work-item-name": {
-          "char": "n",
-          "name": "work-item-name",
-          "summary": "Name of the work item, such as WI-000001.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "work-item-id": {
-          "char": "w",
-          "name": "work-item-id",
-          "summary": "ID of the work item.",
+        "request-token": {
+          "char": "i",
+          "name": "request-token",
+          "required": true,
+          "summary": "Request token from the promote response.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -975,28 +967,29 @@
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "devops:review:create",
+      "id": "devops:request:status",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "core",
       "strict": true,
-      "summary": "Create a pull request for a work item branch.",
+      "summary": "Get the status of a request.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "devops",
-        "review",
-        "create.js"
+        "request",
+        "status.js"
       ]
     },
-    "devops:request:status": {
+    "devops:review:create": {
       "aliases": [],
       "args": {},
-      "description": "Returns the current status of a request identified by its request token.",
+      "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": [
-        "Get the status of a request:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --request-token a0B000000000001"
+        "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"
       ],
       "flags": {
         "json": {
@@ -1031,11 +1024,18 @@
           "multiple": false,
           "type": "option"
         },
-        "request-token": {
-          "char": "i",
-          "name": "request-token",
-          "required": true,
-          "summary": "Request token from the promote response.",
+        "work-item-name": {
+          "char": "n",
+          "name": "work-item-name",
+          "summary": "Name of the work item, such as WI-000001.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "work-item-id": {
+          "char": "w",
+          "name": "work-item-id",
+          "summary": "ID of the work item.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1043,20 +1043,20 @@
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "devops:request:status",
+      "id": "devops:review:create",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "core",
       "strict": true,
-      "summary": "Get the status of a request.",
+      "summary": "Create a pull request for a work item branch.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "devops",
-        "request",
-        "status.js"
+        "review",
+        "create.js"
       ]
     },
     "devops:work-item:combine": {
@@ -1872,13 +1872,12 @@
         "update.js"
       ]
     },
-    "devops:stage:branch:add": {
+    "devops:stage:environment: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": "This command triggers an OAuth flow to authenticate the environment. A browser window opens automatically for you to log in.",
       "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"
+        "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": {
@@ -1924,41 +1923,53 @@
         "stage-id": {
           "name": "stage-id",
           "required": true,
-          "summary": "ID of the pipeline stage to associate the branch with.",
+          "summary": "ID of the pipeline stage.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "branch-name": {
-          "char": "b",
-          "name": "branch-name",
+        "environment-name": {
+          "char": "e",
+          "name": "environment-name",
           "required": true,
-          "summary": "Name of the repository branch to assign to the stage.",
+          "summary": "Name of the environment.",
           "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.",
+        "org-type": {
+          "name": "org-type",
+          "required": true,
+          "summary": "Type of the Salesforce org. Valid values: Production, Sandbox.",
+          "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 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.",
+          "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:branch:add",
+      "id": "devops:stage:environment:add",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "core",
       "strict": true,
-      "summary": "Add a source code repository branch to a pipeline stage.",
+      "summary": "Add a Salesforce environment to a pipeline stage.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -1966,16 +1977,16 @@
         "commands",
         "devops",
         "stage",
-        "branch",
+        "environment",
         "add.js"
       ]
     },
-    "devops:stage:branch:delete": {
+    "devops:stage:environment: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": "Removes the specified environment from the pipeline stage. The environment must belong to an inactive pipeline.",
       "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"
+        "Delete an environment:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --environment-id 0Xe000000000001"
       ],
       "flags": {
         "json": {
@@ -2013,15 +2024,16 @@
         "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. Used to verify the pipeline is inactive before deleting.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "stage-id": {
-          "name": "stage-id",
+        "environment-id": {
+          "char": "e",
+          "name": "environment-id",
           "required": true,
-          "summary": "ID of the pipeline stage whose branch you want to delete.",
+          "summary": "ID of the environment to delete.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2029,12 +2041,12 @@
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "devops:stage:branch:delete",
+      "id": "devops:stage:environment:delete",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "core",
       "strict": true,
-      "summary": "Delete the source code repository branch associated with a pipeline stage.",
+      "summary": "Delete an environment from a DevOps Center pipeline stage.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -2042,16 +2054,17 @@
         "commands",
         "devops",
         "stage",
-        "branch",
+        "environment",
         "delete.js"
       ]
     },
-    "devops:stage:environment:add": {
+    "devops:stage:branch: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": "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": [
-        "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 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": {
@@ -2097,53 +2110,41 @@
         "stage-id": {
           "name": "stage-id",
           "required": true,
-          "summary": "ID of the pipeline stage.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "environment-name": {
-          "char": "e",
-          "name": "environment-name",
-          "required": true,
-          "summary": "Name of the environment.",
+          "summary": "ID of the pipeline stage to associate the branch with.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "org-type": {
-          "name": "org-type",
+        "branch-name": {
+          "char": "b",
+          "name": "branch-name",
           "required": true,
-          "summary": "Type of the Salesforce org. Valid values: Production, Sandbox.",
+          "summary": "Name of the repository branch to assign to the stage.",
           "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.",
+        "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 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.",
+          "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:environment:add",
+      "id": "devops:stage:branch:add",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "core",
       "strict": true,
-      "summary": "Add a Salesforce environment to a pipeline stage.",
+      "summary": "Add a source code repository branch to a pipeline stage.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -2151,16 +2152,16 @@
         "commands",
         "devops",
         "stage",
-        "environment",
+        "branch",
         "add.js"
       ]
     },
-    "devops:stage:environment:delete": {
+    "devops:stage:branch:delete": {
       "aliases": [],
       "args": {},
-      "description": "Removes the specified environment from the pipeline stage. The environment must belong to an inactive pipeline.",
+      "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": [
-        "Delete an environment:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --environment-id 0Xe000000000001"
+        "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": {
@@ -2198,16 +2199,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. Used to verify the pipeline is inactive before deleting.",
           "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 pipeline stage whose branch you want to delete.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2215,12 +2215,12 @@
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "devops:stage:environment:delete",
+      "id": "devops:stage:branch:delete",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "core",
       "strict": true,
-      "summary": "Delete an environment from a DevOps Center pipeline stage.",
+      "summary": "Delete the source code repository branch associated with a pipeline stage.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -2228,7 +2228,7 @@
         "commands",
         "devops",
         "stage",
-        "environment",
+        "branch",
         "delete.js"
       ]
     },
@@ -2809,5 +2809,5 @@
       ]
     }
   },
-  "version": "2.3.6"
+  "version": "2.3.8"
 }