@salesforce/plugin-devops-center 2.2.0 → 2.3.2

package/oclif.manifest.json

@@ -113,6 +113,12 @@
           "summary": "Skip pre-promote validation. By default, promotion is validated before proceeding to prevent promoting work items without an associated PR. Use this flag to bypass validation.",
           "allowNo": false,
           "type": "boolean"
+        },
+        "force": {
+          "name": "force",
+          "summary": "Submit the promotion even if another promotion to the same target stage is already in progress. By default, the command blocks to avoid creating duplicate promotions.",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
@@ -132,17 +138,14 @@
         "promote.js"
       ]
     },
-    "devops:pipeline:create": {
+    "devops:promotion:complete": {
       "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": "Deploys work items that were merged into the pipeline branch outside of DevOps Center (externally merged) into the target stage org and updates DevOps Center records. Equivalent to the \"Complete Promotion\" action in the DevOps Center UI when a stage is out of sync.\n\nIf no undeployed work items are found for the stage, the command exits successfully with no action taken.",
       "examples": [
-        "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"
+        "Complete a promotion for an out-of-sync pipeline stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001",
+        "Complete a promotion for a specific work item (e.g. first stage of a pipeline):\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001 --work-item-id 1fk000000000001",
+        "Complete a promotion with full deploy and a specific test level:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001 --deploy-all --test-level RunLocalTests"
       ],
       "flags": {
         "json": {
@@ -177,73 +180,51 @@
           "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",
+        "target-stage-id": {
+          "char": "t",
+          "name": "target-stage-id",
           "required": true,
-          "summary": "URL of an existing repository or the name of a repository to create.",
+          "summary": "ID of the out-of-sync pipeline stage to deploy to.",
           "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'.",
+        "work-item-id": {
+          "char": "i",
+          "name": "work-item-id",
+          "required": false,
+          "summary": "ID of a specific work item to deploy. Omit to deploy all undeployed work items for the stage. Use this for the first stage of a pipeline where no source stage exists.",
           "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "github",
-            "bitbucket"
-          ],
+          "multiple": true,
           "type": "option"
         },
-        "create-repo": {
-          "name": "create-repo",
-          "summary": "Create a repository if it doesn't exist.",
+        "deploy-all": {
+          "char": "a",
+          "description": "If you don’t specify this flag, only changes in the stage’s branch are deployed.",
+          "name": "deploy-all",
+          "summary": "Deploy all metadata in the branch to the stage's org.",
           "allowNo": false,
           "type": "boolean"
         },
-        "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'.",
+        "test-level": {
+          "char": "l",
+          "description": "Valid values are:\n\n- NoTestRun — No tests are run. This test level applies only to deployments to development environments, such as sandbox, Developer Edition, or trial orgs. This test level is the default for development environments.\n\n- RunSpecifiedTests — Runs only the tests that you specify with the --tests flag. Code coverage requirements differ from the default coverage requirements when using this test level. Executed tests must comprise a minimum of 75% code coverage for each class and trigger in the deployment package. This coverage is computed for each class and trigger individually and is different than the overall coverage percentage.\n\n- RunLocalTests — All tests in your org are run, except the ones that originate from installed managed and unlocked packages. This test level is the default for production deployments that include Apex classes or triggers.\n\n- RunAllTestsInOrg — All tests in your org are run, including tests of managed packages.\n\nIf you don’t specify a test level, the default behavior depends on the contents of your deployment package. For more information, see the section \"Running Tests in a Deployment\" in the \"Metadata API Developer Guide\". (https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_deploy_running_tests.htm)",
+          "name": "test-level",
+          "summary": "Deployment Apex testing level.",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "NoTestRun",
+            "RunSpecifiedTests",
+            "RunLocalTests",
+            "RunAllTestsInOrg"
+          ],
           "type": "option"
         },
-        "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.",
+        "tests": {
+          "description": "Separate multiple test names with commas. Enclose the entire flag value in double quotes if a test name contains spaces.",
+          "name": "tests",
+          "summary": "Apex tests to run when --test-level is RunSpecifiedTests.",
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
@@ -251,28 +232,29 @@
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "devops:pipeline:create",
+      "id": "devops:promotion:complete",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "core",
       "strict": true,
-      "summary": "Create a DevOps Center pipeline.",
+      "summary": "Deploy undeployed work items to a pipeline stage org.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "devops",
-        "pipeline",
-        "create.js"
+        "promotion",
+        "complete.js"
       ]
     },
-    "devops:pipeline:get": {
+    "devops:promotion:validate": {
       "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": "Validates whether the specified work items can be promoted to the target pipeline stage. Checks for VCS and object permission errors before a promotion is attempted.",
       "examples": [
-        "Get details for a specific pipeline:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Do000000000001"
+        "Validate promotion of a work item to a target stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001 --work-item-id 1fk000000000001",
+        "Validate promotion of multiple work items:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001 --work-item-id 1fk000000000001 --work-item-id 1fk000000000002"
       ],
       "flags": {
         "json": {
@@ -307,40 +289,50 @@
           "multiple": false,
           "type": "option"
         },
-        "pipeline-id": {
-          "char": "i",
-          "name": "pipeline-id",
+        "target-stage-id": {
+          "char": "t",
+          "name": "target-stage-id",
           "required": true,
-          "summary": "ID of the DevOps Center pipeline.",
+          "summary": "ID of the target pipeline stage to validate promotion to.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "work-item-id": {
+          "char": "i",
+          "name": "work-item-id",
+          "required": true,
+          "summary": "ID of a work item to validate for promotion. Specify multiple times for multiple work items.",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "devops:pipeline:get",
+      "id": "devops:promotion:validate",
       "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": "Validate work item promotion for a pipeline stage.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "devops",
-        "pipeline",
-        "get.js"
+        "promotion",
+        "validate.js"
       ]
     },
-    "devops:pipeline:list": {
+    "devops:project:create": {
       "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": "Creates a new DevOps Center project with the specified name and optional description.",
       "examples": [
-        "List all pipelines in the org:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org"
+        "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": {
@@ -374,33 +366,50 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "name": {
+          "char": "n",
+          "name": "name",
+          "required": true,
+          "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"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "devops:pipeline:list",
+      "id": "devops:project:create",
       "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": "Create a DevOps Center project in a DevOps Center org.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "devops",
-        "pipeline",
-        "list.js"
+        "project",
+        "create.js"
       ]
     },
-    "devops:pipeline:update": {
+    "devops:project:list": {
       "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": "This command queries the DevopsProject standard object and returns the project Id, Name, and Description for each project found.",
       "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\""
+        "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": {
@@ -434,70 +443,35 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "pipeline-id": {
-          "name": "pipeline-id",
-          "required": true,
-          "summary": "ID of the pipeline.",
-          "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.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "devops:pipeline:update",
+      "id": "devops:project:list",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "core",
       "strict": true,
-      "summary": "Update a DevOps Center pipeline.",
+      "summary": "List all DevOps Center projects in a Salesforce org.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "devops",
-        "pipeline",
-        "update.js"
+        "project",
+        "list.js"
       ]
     },
-    "devops:project:create": {
+    "devops:project:update": {
       "aliases": [],
       "args": {},
-      "description": "Creates a new DevOps Center project with the specified name and optional description.",
+      "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": [
-        "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\""
+        "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": {
@@ -532,11 +506,19 @@
           "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",
-          "required": true,
-          "summary": "Name of the new DevOps Center project.",
+          "summary": "New name for the project.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -544,20 +526,26 @@
         "description": {
           "char": "d",
           "name": "description",
-          "summary": "Description of the new project; if not specified, the description is blank.",
+          "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:create",
+      "id": "devops:project:update",
       "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": "Update a DevOps Center project.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -565,16 +553,20 @@
         "commands",
         "devops",
         "project",
-        "create.js"
+        "update.js"
       ]
     },
-    "devops:project:list": {
+    "devops:pipeline:create": {
       "aliases": [],
       "args": {},
-      "description": "This command queries the DevopsProject standard object and returns the project Id, Name, and Description for each project found.",
+      "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": [
-        "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"
+        "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": {
@@ -608,35 +600,103 @@
           "hasDynamicHelp": false,
           "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",
+          "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:list",
+      "id": "devops:pipeline:create",
       "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": "Create a DevOps Center pipeline.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "devops",
-        "project",
-        "list.js"
+        "pipeline",
+        "create.js"
       ]
     },
-    "devops:project:update": {
+    "devops:pipeline:get": {
       "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 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": [
-        "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"
+        "Get details for a specific pipeline:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Do000000000001"
       ],
       "flags": {
         "json": {
@@ -671,64 +731,40 @@
           "multiple": false,
           "type": "option"
         },
-        "project-id": {
+        "pipeline-id": {
           "char": "i",
-          "name": "project-id",
+          "name": "pipeline-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.",
+          "summary": "ID of the DevOps Center pipeline.",
           "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:get",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "core",
       "strict": true,
-      "summary": "Update a DevOps Center project.",
+      "summary": "Get details of a DevOps Center pipeline including its stages, repositories, and connected projects.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "devops",
-        "project",
-        "update.js"
+        "pipeline",
+        "get.js"
       ]
     },
-    "devops:promotion:complete": {
+    "devops:pipeline:list": {
       "aliases": [],
       "args": {},
-      "description": "Deploys work items that were merged into the pipeline branch outside of DevOps Center (externally merged) into the target stage org and updates DevOps Center records. Equivalent to the \"Complete Promotion\" action in the DevOps Center UI when a stage is out of sync.\n\nIf no undeployed work items are found for the stage, the command exits successfully with no action taken.",
+      "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": [
-        "Complete a promotion for an out-of-sync pipeline stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001",
-        "Complete a promotion for a specific work item (e.g. first stage of a pipeline):\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001 --work-item-id 1fk000000000001",
-        "Complete a promotion with full deploy and a specific test level:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001 --deploy-all --test-level RunLocalTests"
+        "List all pipelines in the org:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org"
       ],
       "flags": {
         "json": {
@@ -762,82 +798,33 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "target-stage-id": {
-          "char": "t",
-          "name": "target-stage-id",
-          "required": true,
-          "summary": "ID of the out-of-sync pipeline stage to deploy to.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "work-item-id": {
-          "char": "i",
-          "name": "work-item-id",
-          "required": false,
-          "summary": "ID of a specific work item to deploy. Omit to deploy all undeployed work items for the stage. Use this for the first stage of a pipeline where no source stage exists.",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "deploy-all": {
-          "char": "a",
-          "description": "If you don’t specify this flag, only changes in the stage’s branch are deployed.",
-          "name": "deploy-all",
-          "summary": "Deploy all metadata in the branch to the stage's org.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "test-level": {
-          "char": "l",
-          "description": "Valid values are:\n\n- NoTestRun — No tests are run. This test level applies only to deployments to development environments, such as sandbox, Developer Edition, or trial orgs. This test level is the default for development environments.\n\n- RunSpecifiedTests — Runs only the tests that you specify with the --tests flag. Code coverage requirements differ from the default coverage requirements when using this test level. Executed tests must comprise a minimum of 75% code coverage for each class and trigger in the deployment package. This coverage is computed for each class and trigger individually and is different than the overall coverage percentage.\n\n- RunLocalTests — All tests in your org are run, except the ones that originate from installed managed and unlocked packages. This test level is the default for production deployments that include Apex classes or triggers.\n\n- RunAllTestsInOrg — All tests in your org are run, including tests of managed packages.\n\nIf you don’t specify a test level, the default behavior depends on the contents of your deployment package. For more information, see the section \"Running Tests in a Deployment\" in the \"Metadata API Developer Guide\". (https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_deploy_running_tests.htm)",
-          "name": "test-level",
-          "summary": "Deployment Apex testing level.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "NoTestRun",
-            "RunSpecifiedTests",
-            "RunLocalTests",
-            "RunAllTestsInOrg"
-          ],
-          "type": "option"
-        },
-        "tests": {
-          "description": "Separate multiple test names with commas. Enclose the entire flag value in double quotes if a test name contains spaces.",
-          "name": "tests",
-          "summary": "Apex tests to run when --test-level is RunSpecifiedTests.",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "devops:promotion:complete",
+      "id": "devops:pipeline:list",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "core",
       "strict": true,
-      "summary": "Deploy undeployed work items to a pipeline stage org.",
+      "summary": "List DevOps Center pipelines with their stages, repositories, and connected projects.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "devops",
-        "promotion",
-        "complete.js"
+        "pipeline",
+        "list.js"
       ]
     },
-    "devops:promotion:validate": {
+    "devops:pipeline:update": {
       "aliases": [],
       "args": {},
-      "description": "Validates whether the specified work items can be promoted to the target pipeline stage. Checks for VCS and object permission errors before a promotion is attempted.",
+      "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": [
-        "Validate promotion of a work item to a target stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001 --work-item-id 1fk000000000001",
-        "Validate promotion of multiple work items:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001 --work-item-id 1fk000000000001 --work-item-id 1fk000000000002"
+        "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": {
@@ -872,41 +859,60 @@
           "multiple": false,
           "type": "option"
         },
-        "target-stage-id": {
-          "char": "t",
-          "name": "target-stage-id",
+        "pipeline-id": {
+          "name": "pipeline-id",
           "required": true,
-          "summary": "ID of the target pipeline stage to validate promotion to.",
+          "summary": "ID of the pipeline.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "work-item-id": {
-          "char": "i",
-          "name": "work-item-id",
-          "required": true,
-          "summary": "ID of a work item to validate for promotion. Specify multiple times for multiple work items.",
+        "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.",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "devops:promotion:validate",
+      "id": "devops:pipeline:update",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "core",
       "strict": true,
-      "summary": "Validate work item promotion for a pipeline stage.",
+      "summary": "Update a DevOps Center pipeline.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "devops",
-        "promotion",
-        "validate.js"
+        "pipeline",
+        "update.js"
       ]
     },
     "devops:request:status": {
@@ -1869,7 +1875,7 @@
     "devops:stage:branch: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. Adding a branch replaces any existing branch linked to the pipeline stage.",
+      "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 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"
@@ -1937,6 +1943,12 @@
           "summary": "Create the branch in the remote repository if it doesn't already exist.",
           "allowNo": false,
           "type": "boolean"
+        },
+        "force": {
+          "name": "force",
+          "summary": "Replace the stage's existing branch. By default, the command blocks if the stage already has a branch to avoid orphaning it. With this flag, the new branch is associated and the previous branch record is removed if no other stage references it.",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
@@ -2116,6 +2128,12 @@
           "summary": "Don't auto-open the browser for OAuth authentication. The redirect URL is printed for manual use.",
           "allowNo": false,
           "type": "boolean"
+        },
+        "force": {
+          "name": "force",
+          "summary": "Replace the stage's existing environment. By default, the command blocks if the stage already has an environment to avoid orphaning it. With this flag, the new environment is added first and the previous one is removed only after the new environment is associated successfully.",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
@@ -2791,5 +2809,5 @@
       ]
     }
   },
-  "version": "2.2.0"
+  "version": "2.3.2"
 }