@salesforce/plugin-devops-center 1.2.28 → 1.4.0

package/oclif.manifest.json

@@ -1,11 +1,12 @@
 {
   "commands": {
-    "devops:pipeline:activate": {
+    "devops:project:create": {
       "aliases": [],
       "args": {},
-      "description": "A pipeline must have at least one stage before you activate it. You can't modify the pipeline stages after you activate and promote changes through it.",
+      "description": "Creates a new DevOps Center project with the specified name and optional description.",
       "examples": [
-        "Activate a pipeline using the pipeline ID.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001"
+        "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": {
@@ -40,10 +41,19 @@
           "multiple": false,
           "type": "option"
         },
-        "pipeline-id": {
-          "name": "pipeline-id",
+        "name": {
+          "char": "n",
+          "name": "name",
           "required": true,
-          "summary": "ID of the 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"
@@ -51,28 +61,29 @@
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "devops:pipeline:activate",
+      "id": "devops:project:create",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "core",
       "strict": true,
-      "summary": "Activate a DevOps Center pipeline for deployments.",
+      "summary": "Create a DevOps Center project in a DevOps Center org.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "devops",
-        "pipeline",
-        "activate.js"
+        "project",
+        "create.js"
       ]
     },
-    "devops:pipeline:attach-project": {
+    "devops:project:list": {
       "aliases": [],
       "args": {},
-      "description": "You can attach a project to only one pipeline.",
+      "description": "This command queries the DevopsProject standard object and returns the project Id, Name, and Description for each project found.",
       "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"
+        "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": {
@@ -106,19 +117,70 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        }
+      },
+      "hasDynamicHelp": true,
+      "hiddenAliases": [],
+      "id": "devops:project:list",
+      "pluginAlias": "@salesforce/plugin-devops-center",
+      "pluginName": "@salesforce/plugin-devops-center",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "List all DevOps Center projects in a Salesforce org.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "devops",
+        "project",
+        "list.js"
+      ]
+    },
+    "devops:pipeline:activate": {
+      "aliases": [],
+      "args": {},
+      "description": "A pipeline must have at least one stage before you activate it. You can't modify the pipeline stages after you activate and promote changes through it.",
+      "examples": [
+        "Activate a pipeline using the pipeline ID.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "pipeline-id": {
-          "name": "pipeline-id",
+        "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": "ID of the pipeline.",
+          "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"
         },
-        "project-id": {
-          "name": "project-id",
+        "pipeline-id": {
+          "name": "pipeline-id",
           "required": true,
-          "summary": "ID of the DevOps Center project.",
+          "summary": "ID of the pipeline.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -126,12 +188,12 @@
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "devops:pipeline:attach-project",
+      "id": "devops:pipeline:activate",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "core",
       "strict": true,
-      "summary": "Attach a DevOps Center project to a pipeline.",
+      "summary": "Activate a DevOps Center pipeline for deployments.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -139,7 +201,7 @@
         "commands",
         "devops",
         "pipeline",
-        "attach-project.js"
+        "activate.js"
       ]
     },
     "devops:pipeline:create": {
@@ -149,7 +211,8 @@
       "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 with a description and associate it with a Bitbucket repository.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"Release Pipeline\" --repo https://bitbucket.org/myorg/myrepo --description \"Main CI/CD pipeline for production releases\""
+        "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 with a description 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 --description \"Main CI/CD pipeline for production releases\""
       ],
       "flags": {
         "json": {
@@ -221,14 +284,21 @@
         },
         "repo-owner": {
           "name": "repo-owner",
-          "summary": "Owner (organization or user) of the repository. Required when creating a repository using '--create-repo'.",
+          "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-project": {
-          "name": "bitbucket-project",
-          "summary": "Bitbucket project key for the repository. Used when creating a Bitbucket repository with '--create-repo'.",
+        "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"
@@ -260,13 +330,13 @@
         "create.js"
       ]
     },
-    "devops:project:create": {
+    "devops:pull-request:create": {
       "aliases": [],
       "args": {},
-      "description": "Creates a new DevOps Center project with the specified name and optional description.",
+      "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 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 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": {
@@ -301,11 +371,96 @@
           "multiple": false,
           "type": "option"
         },
-        "name": {
+        "work-item-name": {
           "char": "n",
-          "name": "name",
+          "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"
+        }
+      },
+      "hasDynamicHelp": true,
+      "hiddenAliases": [],
+      "id": "devops:pull-request:create",
+      "pluginAlias": "@salesforce/plugin-devops-center",
+      "pluginName": "@salesforce/plugin-devops-center",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Create a pull request for a work item branch.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "devops",
+        "pull-request",
+        "create.js"
+      ]
+    },
+    "devops:work-item:create": {
+      "aliases": [],
+      "args": {},
+      "description": "The command creates the work item using the Connect API. Requires a project ID and a subject for the new work item; run the `devops project list` command to get the IDs for all existing projects.",
+      "examples": [
+        "Create a work item for the project with the specified ID and give the work item the specified subject (title); use the DevOps Center org with alias \"my-devops-org\":\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --subject \"Fix login bug\"",
+        "Create a work item with a subject and description:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --subject \"Add dark mode\" --description \"Implement dark mode toggle in settings page\""
+      ],
+      "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": "Name of the new DevOps Center project.",
+          "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"
+        },
+        "project-id": {
+          "char": "p",
+          "name": "project-id",
+          "required": true,
+          "summary": "ID of the DevOps Center project to create the work item in.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "subject": {
+          "char": "s",
+          "name": "subject",
+          "required": true,
+          "summary": "Subject (title) of the new work item.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -313,7 +468,7 @@
         "description": {
           "char": "d",
           "name": "description",
-          "summary": "Description of the new project; if not specified, the description is blank.",
+          "summary": "Description of the new work item; if not specified, the description is blank.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -321,29 +476,29 @@
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "devops:project:create",
+      "id": "devops:work-item: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 new work item in a DevOps Center project.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "devops",
-        "project",
+        "work-item",
         "create.js"
       ]
     },
-    "devops:project:list": {
+    "devops:work-item:list": {
       "aliases": [],
       "args": {},
-      "description": "This command queries the DevopsProject standard object and returns the project Id, Name, and Description for each project found.",
+      "description": "Each work item displays the branch, environment, and repository details needed for checkout and promotion. Requires a project ID; run the `devops project list` command to get the IDs for all existing 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"
+        "List work items for a specific project in the DevOps org with alias \"my-devops-org\":\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001",
+        "List work items using JSON output:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --json"
       ],
       "flags": {
         "json": {
@@ -377,33 +532,43 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "project-id": {
+          "char": "p",
+          "name": "project-id",
+          "required": true,
+          "summary": "ID of the DevOps Center project to list work items for.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "devops:project:list",
+      "id": "devops:work-item:list",
       "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": "List all work items for a DevOps Center project.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "devops",
-        "project",
+        "work-item",
         "list.js"
       ]
     },
-    "devops:pull-request:create": {
+    "devops:work-item:update": {
       "aliases": [],
       "args": {},
-      "description": "The pull request title defaults to the work item subject. The work item must have an associated branch and repository. Requires VCS authentication: set GITHUB_TOKEN (or use `gh auth login`) for GitHub, or set BITBUCKET_TOKEN for Bitbucket.",
+      "description": "Update the subject, description, or status of a work item. At least one of --subject, --description, or --status must be provided.",
       "examples": [
-        "Create a pull request for a work item using the default title.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-name WI-000001",
-        "Create a pull request with a custom title and description.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-id 0Wx000000000001 --title \"Fix: Login timeout\" --body \"Resolves the 30s timeout on the login page\""
+        "Update the subject of a work item by name:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-name WI-000001 --subject \"Fix login bug\"",
+        "Update the status of a work item by ID:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-id 0Wx000000000001 --status \"In Progress\"",
+        "Update multiple fields at once:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-name WI-000001 --subject \"Fix login bug\" --description \"Users can't log in on mobile\" --status \"In Progress\""
       ],
       "flags": {
         "json": {
@@ -454,16 +619,188 @@
           "multiple": false,
           "type": "option"
         },
-        "title": {
-          "name": "title",
-          "summary": "Title of the pull request.",
+        "subject": {
+          "name": "subject",
+          "summary": "New subject for the work item.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "description": {
+          "name": "description",
+          "summary": "New description for the work item.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "status": {
+          "name": "status",
+          "summary": "New status for the work item. Allowed values: \"In Progress\", \"Ready to Promote\".",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "In Progress",
+            "Ready to Promote"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": true,
+      "hiddenAliases": [],
+      "id": "devops:work-item:update",
+      "pluginAlias": "@salesforce/plugin-devops-center",
+      "pluginName": "@salesforce/plugin-devops-center",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Update a work item in DevOps Center.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "devops",
+        "work-item",
+        "update.js"
+      ]
+    },
+    "devops:pipeline:project:add": {
+      "aliases": [],
+      "args": {},
+      "description": "You can attach a project to only one pipeline.",
+      "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"
+      ],
+      "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"
+        },
+        "pipeline-id": {
+          "name": "pipeline-id",
+          "required": true,
+          "summary": "ID of the pipeline.",
+          "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"
+        }
+      },
+      "hasDynamicHelp": true,
+      "hiddenAliases": [],
+      "id": "devops:pipeline:project:add",
+      "pluginAlias": "@salesforce/plugin-devops-center",
+      "pluginName": "@salesforce/plugin-devops-center",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Attach a DevOps Center project to a pipeline.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "devops",
+        "pipeline",
+        "project",
+        "add.js"
+      ]
+    },
+    "devops:pipeline:stage:add": {
+      "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.",
+      "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"
+      ],
+      "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"
+        },
+        "pipeline-id": {
+          "name": "pipeline-id",
+          "required": true,
+          "summary": "ID of the pipeline where the stage is added.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "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"
         },
-        "body": {
-          "name": "body",
-          "summary": "Description of the pull request.",
+        "next-stage-id": {
+          "name": "next-stage-id",
+          "required": true,
+          "summary": "ID of the stage that follows the new stage in the pipeline.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -471,29 +808,30 @@
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "devops:pull-request:create",
+      "id": "devops:pipeline:stage:add",
       "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": "Add a stage to a DevOps Center pipeline.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "devops",
-        "pull-request",
-        "create.js"
+        "pipeline",
+        "stage",
+        "add.js"
       ]
     },
-    "devops:work-item:create": {
+    "devops:stage:branch:add": {
       "aliases": [],
       "args": {},
-      "description": "The command creates the work item using the Connect API. Requires a project ID and a subject for the new work item; run the `devops project list` command to get the IDs for all existing projects.",
+      "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. Adding a branch replaces any existing branch linked to the pipeline stage.",
       "examples": [
-        "Create a work item for the project with the specified ID and give the work item the specified subject (title); use the DevOps Center org with alias \"my-devops-org\":\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --subject \"Fix login bug\"",
-        "Create a work item with a subject and description:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --subject \"Add dark mode\" --description \"Implement dark mode toggle in settings page\""
+        "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": {
@@ -528,58 +866,63 @@
           "multiple": false,
           "type": "option"
         },
-        "project-id": {
-          "char": "p",
-          "name": "project-id",
+        "pipeline-id": {
+          "name": "pipeline-id",
           "required": true,
-          "summary": "ID of the DevOps Center project to create the work item in.",
+          "summary": "ID of the pipeline that contains the stage.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "subject": {
-          "char": "s",
-          "name": "subject",
+        "stage-id": {
+          "name": "stage-id",
           "required": true,
-          "summary": "Subject (title) of the new work item.",
+          "summary": "ID of the pipeline stage to associate the branch with.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "description": {
-          "char": "d",
-          "name": "description",
-          "summary": "Description of the new work item; if not specified, the description is blank.",
+        "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"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "devops:work-item:create",
+      "id": "devops:stage:branch:add",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "core",
       "strict": true,
-      "summary": "Create a new work item in a DevOps Center project.",
+      "summary": "Add a source code repository branch to a pipeline stage.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "devops",
-        "work-item",
-        "create.js"
+        "stage",
+        "branch",
+        "add.js"
       ]
     },
-    "devops:work-item:list": {
+    "devops:stage:environment:add": {
       "aliases": [],
       "args": {},
-      "description": "Each work item displays the branch, environment, and repository details needed for checkout and promotion. Requires a project ID; run the `devops project list` command to get the IDs for all existing projects.",
+      "description": "This command triggers an OAuth flow to authenticate the environment. A browser window opens automatically for you to log in.",
       "examples": [
-        "List work items for a specific project in the DevOps org with alias \"my-devops-org\":\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001",
-        "List work items using JSON output:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --json"
+        "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": {
@@ -614,32 +957,67 @@
           "multiple": false,
           "type": "option"
         },
-        "project-id": {
-          "char": "p",
-          "name": "project-id",
+        "pipeline-id": {
+          "name": "pipeline-id",
           "required": true,
-          "summary": "ID of the DevOps Center project to list work items for.",
+          "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.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "environment-name": {
+          "char": "e",
+          "name": "environment-name",
+          "required": true,
+          "summary": "Name of the environment.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "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"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "devops:work-item:list",
+      "id": "devops:stage:environment:add",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "core",
       "strict": true,
-      "summary": "List all work items for a DevOps Center project.",
+      "summary": "Add a Salesforce environment to a pipeline stage.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "devops",
-        "work-item",
-        "list.js"
+        "stage",
+        "environment",
+        "add.js"
       ]
     },
     "project:deploy:pipeline:quick": {
@@ -1217,182 +1595,7 @@
         "pipeline",
         "validate.js"
       ]
-    },
-    "devops:pipeline:stage:add": {
-      "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.",
-      "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"
-      ],
-      "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"
-        },
-        "pipeline-id": {
-          "name": "pipeline-id",
-          "required": true,
-          "summary": "ID of the pipeline where the stage is added.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "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"
-        },
-        "next-stage-id": {
-          "name": "next-stage-id",
-          "required": true,
-          "summary": "ID of the stage that follows the new stage in the pipeline.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": true,
-      "hiddenAliases": [],
-      "id": "devops:pipeline:stage:add",
-      "pluginAlias": "@salesforce/plugin-devops-center",
-      "pluginName": "@salesforce/plugin-devops-center",
-      "pluginType": "core",
-      "strict": true,
-      "summary": "Add a stage to a DevOps Center pipeline.",
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "lib",
-        "commands",
-        "devops",
-        "pipeline",
-        "stage",
-        "add.js"
-      ]
-    },
-    "devops:work-item:status:update": {
-      "aliases": [],
-      "args": {},
-      "description": "Allowed statuses are \"In Progress\" and \"Ready to Promote\".",
-      "examples": [
-        "Update a work item status by its name to indicate the work is underway:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-name WI-000001 --status \"In Progress\"",
-        "Update a work item status by its ID to indicate the changes are ready for promotion:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-id 0Wx000000000001 --status \"Ready to Promote\""
-      ],
-      "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"
-        },
-        "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"
-        },
-        "status": {
-          "name": "status",
-          "required": true,
-          "summary": "Status to set for the work item. Allowed values: \"In Progress\", \"Ready to Promote\".",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "In Progress",
-            "Ready to Promote"
-          ],
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": true,
-      "hiddenAliases": [],
-      "id": "devops:work-item:status:update",
-      "pluginAlias": "@salesforce/plugin-devops-center",
-      "pluginName": "@salesforce/plugin-devops-center",
-      "pluginType": "core",
-      "strict": true,
-      "summary": "Update the status of a work item in DevOps Center.",
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "lib",
-        "commands",
-        "devops",
-        "work-item",
-        "status",
-        "update.js"
-      ]
     }
   },
-  "version": "1.2.28"
+  "version": "1.4.0"
 }