@salesforce/plugin-devops-center 2.3.8 → 2.3.9

package/README.md

@@ -161,7 +161,7 @@ EXAMPLES
       https://github.com/myorg/myrepo --project-id 0Hn000000000001 --project-id 0Hn000000000002
 ```
 
-_See code: [src/commands/devops/pipeline/create.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.8/src/commands/devops/pipeline/create.ts)_
+_See code: [src/commands/devops/pipeline/create.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.9/src/commands/devops/pipeline/create.ts)_
 
 ## `sf devops pipeline get`
 
@@ -193,7 +193,7 @@ EXAMPLES
     $ sf devops pipeline get --target-org my-devops-org --pipeline-id 0Do000000000001
 ```
 
-_See code: [src/commands/devops/pipeline/get.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.8/src/commands/devops/pipeline/get.ts)_
+_See code: [src/commands/devops/pipeline/get.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.9/src/commands/devops/pipeline/get.ts)_
 
 ## `sf devops pipeline list`
 
@@ -224,7 +224,7 @@ EXAMPLES
     $ sf devops pipeline list --target-org my-devops-org
 ```
 
-_See code: [src/commands/devops/pipeline/list.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.8/src/commands/devops/pipeline/list.ts)_
+_See code: [src/commands/devops/pipeline/list.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.9/src/commands/devops/pipeline/list.ts)_
 
 ## `sf devops pipeline project add`
 
@@ -258,7 +258,7 @@ EXAMPLES
       0Hn000000000001
 ```
 
-_See code: [src/commands/devops/pipeline/project/add.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.8/src/commands/devops/pipeline/project/add.ts)_
+_See code: [src/commands/devops/pipeline/project/add.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.9/src/commands/devops/pipeline/project/add.ts)_
 
 ## `sf devops pipeline project delete`
 
@@ -292,7 +292,7 @@ EXAMPLES
       0Hn000000000001
 ```
 
-_See code: [src/commands/devops/pipeline/project/delete.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.8/src/commands/devops/pipeline/project/delete.ts)_
+_See code: [src/commands/devops/pipeline/project/delete.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.9/src/commands/devops/pipeline/project/delete.ts)_
 
 ## `sf devops pipeline stage add`
 
@@ -333,7 +333,7 @@ EXAMPLES
       --next-stage-id 0Xc000000000003
 ```
 
-_See code: [src/commands/devops/pipeline/stage/add.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.8/src/commands/devops/pipeline/stage/add.ts)_
+_See code: [src/commands/devops/pipeline/stage/add.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.9/src/commands/devops/pipeline/stage/add.ts)_
 
 ## `sf devops pipeline stage delete`
 
@@ -368,7 +368,7 @@ EXAMPLES
       0Xc000000000002
 ```
 
-_See code: [src/commands/devops/pipeline/stage/delete.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.8/src/commands/devops/pipeline/stage/delete.ts)_
+_See code: [src/commands/devops/pipeline/stage/delete.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.9/src/commands/devops/pipeline/stage/delete.ts)_
 
 ## `sf devops pipeline stage update`
 
@@ -401,7 +401,7 @@ EXAMPLES
     $ sf devops pipeline stage update --target-org my-devops-org --stage-id 1QV000000000001 --name "Integration"
 ```
 
-_See code: [src/commands/devops/pipeline/stage/update.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.8/src/commands/devops/pipeline/stage/update.ts)_
+_See code: [src/commands/devops/pipeline/stage/update.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.9/src/commands/devops/pipeline/stage/update.ts)_
 
 ## `sf devops pipeline update`
 
@@ -445,7 +445,7 @@ EXAMPLES
       Pipeline"
 ```
 
-_See code: [src/commands/devops/pipeline/update.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.8/src/commands/devops/pipeline/update.ts)_
+_See code: [src/commands/devops/pipeline/update.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.9/src/commands/devops/pipeline/update.ts)_
 
 ## `sf devops project create`
 
@@ -482,7 +482,7 @@ EXAMPLES
       update"
 ```
 
-_See code: [src/commands/devops/project/create.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.8/src/commands/devops/project/create.ts)_
+_See code: [src/commands/devops/project/create.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.9/src/commands/devops/project/create.ts)_
 
 ## `sf devops project list`
 
@@ -517,7 +517,7 @@ EXAMPLES
     $ sf devops project list --target-org devops-center@example.com
 ```
 
-_See code: [src/commands/devops/project/list.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.8/src/commands/devops/project/list.ts)_
+_See code: [src/commands/devops/project/list.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.9/src/commands/devops/project/list.ts)_
 
 ## `sf devops project update`
 
@@ -567,7 +567,7 @@ EXAMPLES
       --description "Archived" --no-is-active
 ```
 
-_See code: [src/commands/devops/project/update.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.8/src/commands/devops/project/update.ts)_
+_See code: [src/commands/devops/project/update.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.9/src/commands/devops/project/update.ts)_
 
 ## `sf devops promote`
 
@@ -669,7 +669,7 @@ FLAG DESCRIPTIONS
     spaces.
 ```
 
-_See code: [src/commands/devops/promote.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.8/src/commands/devops/promote.ts)_
+_See code: [src/commands/devops/promote.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.9/src/commands/devops/promote.ts)_
 
 ## `sf devops promotion complete`
 
@@ -752,7 +752,7 @@ FLAG DESCRIPTIONS
     spaces.
 ```
 
-_See code: [src/commands/devops/promotion/complete.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.8/src/commands/devops/promotion/complete.ts)_
+_See code: [src/commands/devops/promotion/complete.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.9/src/commands/devops/promotion/complete.ts)_
 
 ## `sf devops promotion validate`
 
@@ -793,7 +793,7 @@ EXAMPLES
       1fk000000000001 --work-item-id 1fk000000000002
 ```
 
-_See code: [src/commands/devops/promotion/validate.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.8/src/commands/devops/promotion/validate.ts)_
+_See code: [src/commands/devops/promotion/validate.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.9/src/commands/devops/promotion/validate.ts)_
 
 ## `sf devops request status`
 
@@ -824,7 +824,7 @@ EXAMPLES
     $ sf devops request status --target-org my-devops-org --request-token a0B000000000001
 ```
 
-_See code: [src/commands/devops/request/status.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.8/src/commands/devops/request/status.ts)_
+_See code: [src/commands/devops/request/status.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.9/src/commands/devops/request/status.ts)_
 
 ## `sf devops review create`
 
@@ -861,7 +861,7 @@ EXAMPLES
     $ sf devops review create --target-org my-devops-org --work-item-id 0Wx000000000001
 ```
 
-_See code: [src/commands/devops/review/create.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.8/src/commands/devops/review/create.ts)_
+_See code: [src/commands/devops/review/create.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.9/src/commands/devops/review/create.ts)_
 
 ## `sf devops stage branch add`
 
@@ -907,7 +907,7 @@ EXAMPLES
       --branch-name integration --create-vcs-branch
 ```
 
-_See code: [src/commands/devops/stage/branch/add.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.8/src/commands/devops/stage/branch/add.ts)_
+_See code: [src/commands/devops/stage/branch/add.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.9/src/commands/devops/stage/branch/add.ts)_
 
 ## `sf devops stage branch delete`
 
@@ -945,7 +945,7 @@ EXAMPLES
       0Xp000000000001
 ```
 
-_See code: [src/commands/devops/stage/branch/delete.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.8/src/commands/devops/stage/branch/delete.ts)_
+_See code: [src/commands/devops/stage/branch/delete.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.9/src/commands/devops/stage/branch/delete.ts)_
 
 ## `sf devops stage environment add`
 
@@ -989,7 +989,7 @@ EXAMPLES
       Production_Org --org-type Production
 ```
 
-_See code: [src/commands/devops/stage/environment/add.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.8/src/commands/devops/stage/environment/add.ts)_
+_See code: [src/commands/devops/stage/environment/add.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.9/src/commands/devops/stage/environment/add.ts)_
 
 ## `sf devops stage environment delete`
 
@@ -1023,7 +1023,7 @@ EXAMPLES
       0Xe000000000001
 ```
 
-_See code: [src/commands/devops/stage/environment/delete.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.8/src/commands/devops/stage/environment/delete.ts)_
+_See code: [src/commands/devops/stage/environment/delete.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.9/src/commands/devops/stage/environment/delete.ts)_
 
 ## `sf devops work-item combine`
 
@@ -1072,7 +1072,7 @@ FLAG DESCRIPTIONS
     are merged into the parent's branch during promotion.
 ```
 
-_See code: [src/commands/devops/work-item/combine.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.8/src/commands/devops/work-item/combine.ts)_
+_See code: [src/commands/devops/work-item/combine.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.9/src/commands/devops/work-item/combine.ts)_
 
 ## `sf devops work-item create`
 
@@ -1113,7 +1113,7 @@ EXAMPLES
       --description "Implement dark mode toggle in settings page"
 ```
 
-_See code: [src/commands/devops/work-item/create.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.8/src/commands/devops/work-item/create.ts)_
+_See code: [src/commands/devops/work-item/create.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.9/src/commands/devops/work-item/create.ts)_
 
 ## `sf devops work-item list`
 
@@ -1149,7 +1149,7 @@ EXAMPLES
     $ sf devops work-item list --target-org my-devops-org --project-id 1Qg000000000001 --json
 ```
 
-_See code: [src/commands/devops/work-item/list.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.8/src/commands/devops/work-item/list.ts)_
+_See code: [src/commands/devops/work-item/list.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.9/src/commands/devops/work-item/list.ts)_
 
 ## `sf devops work-item prepare`
 
@@ -1190,7 +1190,7 @@ EXAMPLES
       --target-stage-id 05S000000000002
 ```
 
-_See code: [src/commands/devops/work-item/prepare.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.8/src/commands/devops/work-item/prepare.ts)_
+_See code: [src/commands/devops/work-item/prepare.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.9/src/commands/devops/work-item/prepare.ts)_
 
 ## `sf devops work-item update`
 
@@ -1237,7 +1237,7 @@ EXAMPLES
       --description "Users can't log in on mobile" --status "In Progress"
 ```
 
-_See code: [src/commands/devops/work-item/update.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.8/src/commands/devops/work-item/update.ts)_
+_See code: [src/commands/devops/work-item/update.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.9/src/commands/devops/work-item/update.ts)_
 
 ## `sf project deploy pipeline quick`
 
@@ -1311,7 +1311,7 @@ FLAG DESCRIPTIONS
     "sf project deploy pipeline report".
 ```
 
-_See code: [src/commands/project/deploy/pipeline/quick.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.8/src/commands/project/deploy/pipeline/quick.ts)_
+_See code: [src/commands/project/deploy/pipeline/quick.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.9/src/commands/project/deploy/pipeline/quick.ts)_
 
 ## `sf project deploy pipeline report`
 
@@ -1359,7 +1359,7 @@ FLAG DESCRIPTIONS
     your most recent operation was longer than 3 days ago, this flag won't find the job ID.
 ```
 
-_See code: [src/commands/project/deploy/pipeline/report.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.8/src/commands/project/deploy/pipeline/report.ts)_
+_See code: [src/commands/project/deploy/pipeline/report.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.9/src/commands/project/deploy/pipeline/report.ts)_
 
 ## `sf project deploy pipeline resume`
 
@@ -1426,7 +1426,7 @@ FLAG DESCRIPTIONS
     returns the job ID. To check the status of the operation, run "sf project deploy pipeline report".
 ```
 
-_See code: [src/commands/project/deploy/pipeline/resume.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.8/src/commands/project/deploy/pipeline/resume.ts)_
+_See code: [src/commands/project/deploy/pipeline/resume.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.9/src/commands/project/deploy/pipeline/resume.ts)_
 
 ## `sf project deploy pipeline start`
 
@@ -1526,7 +1526,7 @@ FLAG DESCRIPTIONS
     "sf project deploy pipeline report".
 ```
 
-_See code: [src/commands/project/deploy/pipeline/start.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.8/src/commands/project/deploy/pipeline/start.ts)_
+_See code: [src/commands/project/deploy/pipeline/start.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.9/src/commands/project/deploy/pipeline/start.ts)_
 
 ## `sf project deploy pipeline validate`
 
@@ -1626,7 +1626,7 @@ FLAG DESCRIPTIONS
     "sf project deploy pipeline report".
 ```
 
-_See code: [src/commands/project/deploy/pipeline/validate.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.8/src/commands/project/deploy/pipeline/validate.ts)_
+_See code: [src/commands/project/deploy/pipeline/validate.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.9/src/commands/project/deploy/pipeline/validate.ts)_
 
 <!-- commandsstop -->
 

package/oclif.manifest.json

@@ -1872,12 +1872,13 @@
         "update.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": {
@@ -1923,53 +1924,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": [
@@ -1977,16 +1966,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": {
@@ -2024,16 +2013,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"
@@ -2041,12 +2029,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": [
@@ -2054,17 +2042,16 @@
         "commands",
         "devops",
         "stage",
-        "environment",
+        "branch",
         "delete.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": {
@@ -2110,41 +2097,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": [
@@ -2152,16 +2151,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": {
@@ -2199,15 +2198,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"
@@ -2215,12 +2215,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": [
@@ -2228,7 +2228,7 @@
         "commands",
         "devops",
         "stage",
-        "branch",
+        "environment",
         "delete.js"
       ]
     },
@@ -2809,5 +2809,5 @@
       ]
     }
   },
-  "version": "2.3.8"
+  "version": "2.3.9"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@salesforce/plugin-devops-center",
     "description": "The DevOps Center CLI plugin provides a command-line alternative to performing equivalent actions in the DevOps Center graphical UI",
-    "version": "2.3.8",
+    "version": "2.3.9",
     "type": "module",
     "author": "Salesforce",
     "bugs": "https://github.com/forcedotcom/cli/issues",
@@ -263,7 +263,7 @@
         }
     },
     "sfdx": {
-        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-devops-center/2.3.8.crt",
-        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-devops-center/2.3.8.sig"
+        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-devops-center/2.3.9.crt",
+        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-devops-center/2.3.9.sig"
     }
 }