@salesforce/plugin-devops-center 1.4.1 → 2.0.1

package/README.md

@@ -63,15 +63,18 @@ sf plugins
 - [`sf devops pipeline project delete`](#sf-devops-pipeline-project-delete)
 - [`sf devops pipeline stage add`](#sf-devops-pipeline-stage-add)
 - [`sf devops pipeline stage delete`](#sf-devops-pipeline-stage-delete)
+- [`sf devops pipeline stage update`](#sf-devops-pipeline-stage-update)
 - [`sf devops pipeline update`](#sf-devops-pipeline-update)
 - [`sf devops project create`](#sf-devops-project-create)
 - [`sf devops project list`](#sf-devops-project-list)
 - [`sf devops project update`](#sf-devops-project-update)
 - [`sf devops promote`](#sf-devops-promote)
 - [`sf devops promotion complete`](#sf-devops-promotion-complete)
+- [`sf devops promotion validate`](#sf-devops-promotion-validate)
 - [`sf devops request status`](#sf-devops-request-status)
 - [`sf devops review create`](#sf-devops-review-create)
 - [`sf devops stage branch add`](#sf-devops-stage-branch-add)
+- [`sf devops stage branch delete`](#sf-devops-stage-branch-delete)
 - [`sf devops stage environment add`](#sf-devops-stage-environment-add)
 - [`sf devops stage environment delete`](#sf-devops-stage-environment-delete)
 - [`sf devops work-item combine`](#sf-devops-work-item-combine)
@@ -145,7 +148,7 @@ EXAMPLES
       https://bitbucket.org/myworkspace/myrepo --description "Main CI/CD pipeline for production releases"
 ```
 
-_See code: [src/commands/devops/pipeline/create.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.4.1/src/commands/devops/pipeline/create.ts)_
+_See code: [src/commands/devops/pipeline/create.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.0.1/src/commands/devops/pipeline/create.ts)_
 
 ## `sf devops pipeline get`
 
@@ -177,7 +180,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/1.4.1/src/commands/devops/pipeline/get.ts)_
+_See code: [src/commands/devops/pipeline/get.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.0.1/src/commands/devops/pipeline/get.ts)_
 
 ## `sf devops pipeline list`
 
@@ -208,7 +211,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/1.4.1/src/commands/devops/pipeline/list.ts)_
+_See code: [src/commands/devops/pipeline/list.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.0.1/src/commands/devops/pipeline/list.ts)_
 
 ## `sf devops pipeline project add`
 
@@ -242,7 +245,7 @@ EXAMPLES
       0Hn000000000001
 ```
 
-_See code: [src/commands/devops/pipeline/project/add.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.4.1/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.0.1/src/commands/devops/pipeline/project/add.ts)_
 
 ## `sf devops pipeline project delete`
 
@@ -276,7 +279,7 @@ EXAMPLES
       0Hn000000000001
 ```
 
-_See code: [src/commands/devops/pipeline/project/delete.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.4.1/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.0.1/src/commands/devops/pipeline/project/delete.ts)_
 
 ## `sf devops pipeline stage add`
 
@@ -317,7 +320,7 @@ EXAMPLES
       --next-stage-id 0Xc000000000003
 ```
 
-_See code: [src/commands/devops/pipeline/stage/add.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.4.1/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.0.1/src/commands/devops/pipeline/stage/add.ts)_
 
 ## `sf devops pipeline stage delete`
 
@@ -352,7 +355,40 @@ EXAMPLES
       0Xc000000000002
 ```
 
-_See code: [src/commands/devops/pipeline/stage/delete.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.4.1/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.0.1/src/commands/devops/pipeline/stage/delete.ts)_
+
+## `sf devops pipeline stage update`
+
+Update a DevOps Center pipeline stage.
+
+```
+USAGE
+  $ sf devops pipeline stage update -o <value> -s <value> -n <value> [--json] [--flags-dir <value>] [--api-version
+  <value>]
+
+FLAGS
+  -n, --name=<value>         (required) New name for the pipeline stage.
+  -o, --target-org=<value>   (required) Username or alias of the target org. Not required if the `target-org`
+                             configuration variable is already set.
+  -s, --stage-id=<value>     (required) ID of the pipeline stage to update.
+      --api-version=<value>  Override the api version used for api requests made by this command
+
+GLOBAL FLAGS
+  --flags-dir=<value>  Import flag values from a directory.
+  --json               Format output as json.
+
+DESCRIPTION
+  Update a DevOps Center pipeline stage.
+
+  Updates the name of a pipeline stage.
+
+EXAMPLES
+  Rename a pipeline stage.
+
+    $ 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.0.1/src/commands/devops/pipeline/stage/update.ts)_
 
 ## `sf devops pipeline update`
 
@@ -395,7 +431,7 @@ EXAMPLES
       Pipeline"
 ```
 
-_See code: [src/commands/devops/pipeline/update.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.4.1/src/commands/devops/pipeline/update.ts)_
+_See code: [src/commands/devops/pipeline/update.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.0.1/src/commands/devops/pipeline/update.ts)_
 
 ## `sf devops project create`
 
@@ -432,7 +468,7 @@ EXAMPLES
       update"
 ```
 
-_See code: [src/commands/devops/project/create.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.4.1/src/commands/devops/project/create.ts)_
+_See code: [src/commands/devops/project/create.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.0.1/src/commands/devops/project/create.ts)_
 
 ## `sf devops project list`
 
@@ -467,7 +503,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/1.4.1/src/commands/devops/project/list.ts)_
+_See code: [src/commands/devops/project/list.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.0.1/src/commands/devops/project/list.ts)_
 
 ## `sf devops project update`
 
@@ -517,7 +553,7 @@ EXAMPLES
       --description "Archived" --no-is-active
 ```
 
-_See code: [src/commands/devops/project/update.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.4.1/src/commands/devops/project/update.ts)_
+_See code: [src/commands/devops/project/update.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.0.1/src/commands/devops/project/update.ts)_
 
 ## `sf devops promote`
 
@@ -527,6 +563,7 @@ Promote work items or a pipeline stage to a target pipeline stage.
 USAGE
   $ sf devops promote -o <value> -t <value> [--json] [--flags-dir <value>] [--api-version <value>] [-i <value>... |
     -s <value>] [-a] [-l NoTestRun|RunSpecifiedTests|RunLocalTests|RunAllTestsInOrg] [--tests <value>...]
+    [--skip-validation]
 
 FLAGS
   -a, --deploy-all               Deploy all metadata in the branch to the stage's org.
@@ -539,6 +576,9 @@ FLAGS
                                  exclusive with --work-item-id.
   -t, --target-stage-id=<value>  (required) ID of the pipeline stage to promote to.
       --api-version=<value>      Override the api version used for api requests made by this command
+      --skip-validation          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.
       --tests=<value>...         Apex tests to run when --test-level is RunSpecifiedTests.
 
 GLOBAL FLAGS
@@ -613,7 +653,7 @@ FLAG DESCRIPTIONS
     spaces.
 ```
 
-_See code: [src/commands/devops/promote.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.4.1/src/commands/devops/promote.ts)_
+_See code: [src/commands/devops/promote.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.0.1/src/commands/devops/promote.ts)_
 
 ## `sf devops promotion complete`
 
@@ -650,16 +690,16 @@ DESCRIPTION
   If no undeployed work items are found for the stage, the command exits successfully with no action taken.
 
 EXAMPLES
-  Complete a promotion for an out-of-sync pipeline stage.
+  Complete a promotion for an out-of-sync pipeline stage:
 
     $ sf devops promotion complete --target-org my-devops-org --target-stage-id 1QV000000000001
 
-  Complete a promotion for a specific work item (e.g. first stage of a pipeline).
+  Complete a promotion for a specific work item (e.g. first stage of a pipeline):
 
     $ sf devops promotion complete --target-org my-devops-org --target-stage-id 1QV000000000001 --work-item-id \
       1fk000000000001
 
-  Complete a promotion with full deploy and a specific test level.
+  Complete a promotion with full deploy and a specific test level:
 
     $ sf devops promotion complete --target-org my-devops-org --target-stage-id 1QV000000000001 --deploy-all \
       --test-level RunLocalTests
@@ -696,7 +736,48 @@ FLAG DESCRIPTIONS
     spaces.
 ```
 
-_See code: [src/commands/devops/promotion/complete.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.4.1/src/commands/devops/promotion/complete.ts)_
+_See code: [src/commands/devops/promotion/complete.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.0.1/src/commands/devops/promotion/complete.ts)_
+
+## `sf devops promotion validate`
+
+Validate work item promotion for a pipeline stage.
+
+```
+USAGE
+  $ sf devops promotion validate -o <value> -t <value> -i <value>... [--json] [--flags-dir <value>] [--api-version
+  <value>]
+
+FLAGS
+  -i, --work-item-id=<value>...  (required) ID of a work item to validate for promotion. Specify multiple times for
+                                 multiple work items.
+  -o, --target-org=<value>       (required) Username or alias of the target org. Not required if the `target-org`
+                                 configuration variable is already set.
+  -t, --target-stage-id=<value>  (required) ID of the target pipeline stage to validate promotion to.
+      --api-version=<value>      Override the api version used for api requests made by this command
+
+GLOBAL FLAGS
+  --flags-dir=<value>  Import flag values from a directory.
+  --json               Format output as json.
+
+DESCRIPTION
+  Validate work item promotion for a pipeline stage.
+
+  Validates whether the specified work items can be promoted to the target pipeline stage. Checks for VCS and object
+  permission errors before a promotion is attempted.
+
+EXAMPLES
+  Validate promotion of a work item to a target stage:
+
+    $ sf devops promotion validate --target-org my-devops-org --target-stage-id 1QV000000000001 --work-item-id \
+      1fk000000000001
+
+  Validate promotion of multiple work items:
+
+    $ sf devops promotion validate --target-org my-devops-org --target-stage-id 1QV000000000001 --work-item-id \
+      1fk000000000001 --work-item-id 1fk000000000002
+```
+
+_See code: [src/commands/devops/promotion/validate.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.0.1/src/commands/devops/promotion/validate.ts)_
 
 ## `sf devops request status`
 
@@ -727,7 +808,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/1.4.1/src/commands/devops/request/status.ts)_
+_See code: [src/commands/devops/request/status.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.0.1/src/commands/devops/request/status.ts)_
 
 ## `sf devops review create`
 
@@ -764,7 +845,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/1.4.1/src/commands/devops/review/create.ts)_
+_See code: [src/commands/devops/review/create.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.0.1/src/commands/devops/review/create.ts)_
 
 ## `sf devops stage branch add`
 
@@ -807,7 +888,45 @@ EXAMPLES
       --branch-name integration --create-vcs-branch
 ```
 
-_See code: [src/commands/devops/stage/branch/add.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.4.1/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.0.1/src/commands/devops/stage/branch/add.ts)_
+
+## `sf devops stage branch delete`
+
+Delete the source code repository branch associated with a pipeline stage.
+
+```
+USAGE
+  $ sf devops stage branch delete -o <value> --pipeline-id <value> --stage-id <value> [--json] [--flags-dir <value>]
+    [--api-version <value>]
+
+FLAGS
+  -o, --target-org=<value>   (required) Username or alias of the target org. Not required if the `target-org`
+                             configuration variable is already set.
+      --api-version=<value>  Override the api version used for api requests made by this command
+      --pipeline-id=<value>  (required) ID of the pipeline that contains the stage. Used to verify the pipeline is
+                             inactive before deleting.
+      --stage-id=<value>     (required) ID of the pipeline stage whose branch you want to delete.
+
+GLOBAL FLAGS
+  --flags-dir=<value>  Import flag values from a directory.
+  --json               Format output as json.
+
+DESCRIPTION
+  Delete the source code repository branch associated with a pipeline stage.
+
+  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 the branch associated with a pipeline stage:
+
+    $ sf devops stage branch delete --target-org my-devops-org --pipeline-id 0Xo000000000001 --stage-id \
+      0Xp000000000001
+```
+
+_See code: [src/commands/devops/stage/branch/delete.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.0.1/src/commands/devops/stage/branch/delete.ts)_
 
 ## `sf devops stage environment add`
 
@@ -847,7 +966,7 @@ EXAMPLES
       Production_Org --org-type Production
 ```
 
-_See code: [src/commands/devops/stage/environment/add.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.4.1/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.0.1/src/commands/devops/stage/environment/add.ts)_
 
 ## `sf devops stage environment delete`
 
@@ -881,7 +1000,7 @@ EXAMPLES
       0Xe000000000001
 ```
 
-_See code: [src/commands/devops/stage/environment/delete.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.4.1/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.0.1/src/commands/devops/stage/environment/delete.ts)_
 
 ## `sf devops work-item combine`
 
@@ -930,7 +1049,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/1.4.1/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.0.1/src/commands/devops/work-item/combine.ts)_
 
 ## `sf devops work-item create`
 
@@ -971,7 +1090,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/1.4.1/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.0.1/src/commands/devops/work-item/create.ts)_
 
 ## `sf devops work-item list`
 
@@ -1007,7 +1126,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/1.4.1/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.0.1/src/commands/devops/work-item/list.ts)_
 
 ## `sf devops work-item prepare`
 
@@ -1048,7 +1167,7 @@ EXAMPLES
       --target-stage-id 05S000000000002
 ```
 
-_See code: [src/commands/devops/work-item/prepare.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.4.1/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.0.1/src/commands/devops/work-item/prepare.ts)_
 
 ## `sf devops work-item update`
 
@@ -1095,7 +1214,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/1.4.1/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.0.1/src/commands/devops/work-item/update.ts)_
 
 ## `sf project deploy pipeline quick`
 
@@ -1169,7 +1288,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/1.4.1/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.0.1/src/commands/project/deploy/pipeline/quick.ts)_
 
 ## `sf project deploy pipeline report`
 
@@ -1217,7 +1336,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/1.4.1/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.0.1/src/commands/project/deploy/pipeline/report.ts)_
 
 ## `sf project deploy pipeline resume`
 
@@ -1284,7 +1403,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/1.4.1/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.0.1/src/commands/project/deploy/pipeline/resume.ts)_
 
 ## `sf project deploy pipeline start`
 
@@ -1384,7 +1503,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/1.4.1/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.0.1/src/commands/project/deploy/pipeline/start.ts)_
 
 ## `sf project deploy pipeline validate`
 
@@ -1484,7 +1603,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/1.4.1/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.0.1/src/commands/project/deploy/pipeline/validate.ts)_
 
 <!-- commandsstop -->
 

package/lib/commands/devops/pipeline/stage/update.d.ts

@@ -0,0 +1,19 @@
+import { Org } from '@salesforce/core';
+import { SfCommand } from '@salesforce/sf-plugins-core';
+export type PipelineStageUpdateResult = {
+    success: boolean;
+    stageId: string;
+    name: string;
+};
+export default class DevopsPipelineStageUpdate extends SfCommand<PipelineStageUpdateResult> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        'target-org': import("@oclif/core/interfaces").OptionFlag<Org, import("@oclif/core/interfaces").CustomOptions>;
+        'api-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'stage-id': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        name: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<PipelineStageUpdateResult>;
+}

package/lib/commands/devops/pipeline/stage/update.js

@@ -0,0 +1,66 @@
+/*
+ * Copyright 2026, Salesforce, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { Messages } from '@salesforce/core';
+import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
+import { validateSalesforceId } from '../../../../utils/soqlUtils.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@salesforce/plugin-devops-center', 'devops.pipeline.stage.update');
+const commonErrorMessages = Messages.loadMessages('@salesforce/plugin-devops-center', 'commonErrors');
+export default class DevopsPipelineStageUpdate extends SfCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static flags = {
+        'target-org': Flags.requiredOrg(),
+        'api-version': Flags.orgApiVersion(),
+        'stage-id': Flags.salesforceId({
+            summary: messages.getMessage('flags.stage-id.summary'),
+            required: true,
+            char: 's',
+        }),
+        name: Flags.string({
+            summary: messages.getMessage('flags.name.summary'),
+            required: true,
+            char: 'n',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(DevopsPipelineStageUpdate);
+        const org = flags['target-org'];
+        const connection = org.getConnection(flags['api-version']);
+        const stageId = flags['stage-id'];
+        const name = flags['name'];
+        validateSalesforceId(stageId, 'stage');
+        try {
+            await connection.sobject('DevopsPipelineStage').update({ Id: stageId, Name: name });
+        }
+        catch (error) {
+            const errMsg = error instanceof Error ? error.message : String(error);
+            if (errMsg.includes('sObject type') && errMsg.includes('is not supported')) {
+                this.error(commonErrorMessages.getMessage('error.DevopsCenterNotEnabled'));
+            }
+            if (errMsg.toLowerCase().includes('not found') || errMsg.includes('entity is deleted')) {
+                this.error(messages.getMessage('error.StageNotFound', [stageId]));
+            }
+            throw error;
+        }
+        this.log(`Successfully updated stage "${name}".`);
+        this.log(`  Stage ID: ${stageId}`);
+        this.log(`  Name:     ${name}`);
+        return { success: true, stageId, name };
+    }
+}
+//# sourceMappingURL=update.js.map

package/lib/commands/devops/pipeline/stage/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../../../src/commands/devops/pipeline/stage/update.ts"],"names":[],"mappings":"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"}

package/lib/commands/devops/promote.d.ts

@@ -1,9 +1,11 @@
 import { SfCommand } from '@salesforce/sf-plugins-core';
+import { CombineDetails } from '../../utils/promotionUtils.js';
 export type PromoteResult = {
     requestId: string;
     status: string;
     message: string;
     promotedWorkitemIds: string[];
+    combineDetails?: CombineDetails | null;
 };
 export default class DevopsPromote extends SfCommand<PromoteResult> {
     static readonly summary: string;
@@ -18,7 +20,10 @@ export default class DevopsPromote extends SfCommand<PromoteResult> {
         'deploy-all': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'test-level': import("@oclif/core/interfaces").OptionFlag<import("../../common/types.js").TestLevel | undefined, import("@oclif/core/interfaces").CustomOptions>;
         tests: import("@oclif/core/interfaces").OptionFlag<string[] | undefined>;
+        'skip-validation': import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
+    private static assertWorkItemsPromotable;
     private static fetchStageWorkItems;
     run(): Promise<PromoteResult>;
+    private runValidation;
 }

package/lib/commands/devops/promote.js

@@ -20,9 +20,12 @@ import { resolveProjectIdFromWorkItem } from '../../utils/prepareWorkItem.js';
 import { getPipelineIdForProject } from '../../utils/pipelineUtils.js';
 import { deployAll, testLevel as testLevelFlag, specificTestsNoChar } from '../../common/flags/promote/promoteFlags.js';
 import { validateSalesforceId } from '../../utils/soqlUtils.js';
+import { validatePromotion, formatValidationDetails, } from '../../utils/promotionUtils.js';
 Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
 const messages = Messages.loadMessages('@salesforce/plugin-devops-center', 'devops.promote');
 const commonErrorMessages = Messages.loadMessages('@salesforce/plugin-devops-center', 'commonErrors');
+const PROMOTABLE_STATUSES = ['READY_TO_PROMOTE', 'PROMOTED'];
+const PROMOTABLE_STATUS_LIST = PROMOTABLE_STATUSES.join("', '");
 export default class DevopsPromote extends SfCommand {
     static summary = messages.getMessage('summary');
     static description = messages.getMessage('description');
@@ -55,7 +58,21 @@ export default class DevopsPromote extends SfCommand {
         'deploy-all': deployAll,
         'test-level': testLevelFlag(),
         tests: specificTestsNoChar,
+        'skip-validation': Flags.boolean({
+            summary: messages.getMessage('flags.skip-validation.summary'),
+            default: false,
+        }),
     };
+    static async assertWorkItemsPromotable(connection, workItemIds) {
+        const idList = workItemIds.map((id) => `'${id}'`).join(', ');
+        const result = await connection.query(`SELECT Id, Status FROM WorkItem WHERE Id IN (${idList})`);
+        const ineligible = result.records.filter((r) => !PROMOTABLE_STATUSES.includes(r.Status));
+        if (ineligible.length > 0) {
+            const details = ineligible.map((r) => `${r.Id} (${r.Status})`).join(', ');
+            throw new Error(`The following work items are not eligible for promotion: ${details}. Only work items with status READY_TO_PROMOTE or PROMOTED can be promoted.`);
+        }
+        return result.records.map((r) => r.Id);
+    }
     static async fetchStageWorkItems(connection, pipelineId, sourceStageId, targetStageId) {
         // Validate all IDs before using in SOQL
         validateSalesforceId(pipelineId, 'pipeline');
@@ -70,7 +87,7 @@ export default class DevopsPromote extends SfCommand {
         if (nextStageId !== targetStageId) {
             throw new Error(`Stage '${sourceStageId}' does not feed into target stage '${targetStageId}'.`);
         }
-        const workItemResult = await connection.query(`SELECT Id FROM WorkItem WHERE DevopsPipelineStageId = '${sourceStageId}' LIMIT 200`);
+        const workItemResult = await connection.query(`SELECT Id FROM WorkItem WHERE DevopsPipelineStageId = '${sourceStageId}' AND Status IN ('${PROMOTABLE_STATUS_LIST}') LIMIT 200`);
         return workItemResult.records.map((r) => r.Id);
     }
     async run() {
@@ -91,7 +108,7 @@ export default class DevopsPromote extends SfCommand {
                 this.error(`No pipeline found for work item "${workItemIds[0]}". Ensure the project has an associated pipeline.`);
             }
             pipelineId = pid;
-            resolvedWorkItemIds = workItemIds;
+            resolvedWorkItemIds = await DevopsPromote.assertWorkItemsPromotable(connection, workItemIds);
         }
         else {
             // Stage path: resolve pipelineId from the source stage
@@ -108,6 +125,9 @@ export default class DevopsPromote extends SfCommand {
                 this.error(messages.getMessage('error.NoWorkItems'));
             }
         }
+        if (!flags['skip-validation']) {
+            await this.runValidation(connection, pipelineId, resolvedWorkItemIds, targetStageId, !workItemIds?.length);
+        }
         let apiResult;
         try {
             apiResult = await promoteStage({
@@ -125,7 +145,8 @@ export default class DevopsPromote extends SfCommand {
             if (errMsg.includes('sObject type') && errMsg.includes('is not supported')) {
                 this.error(commonErrorMessages.getMessage('error.DevopsCenterNotEnabled'));
             }
-            const cleanMsg = errMsg.split('<')[0].trim();
+            const htmlStripped = errMsg.split('<')[0].trim();
+            const cleanMsg = htmlStripped.replace(/^[A-Z][A-Z0-9_]+:/, '').trim();
             this.error(messages.getMessage('error.PromoteFailed', [cleanMsg]));
         }
         this.log(`Status: ${apiResult.status}`);
@@ -144,5 +165,30 @@ export default class DevopsPromote extends SfCommand {
             promotedWorkitemIds: apiResult.promotedWorkitemIds,
         };
     }
+    async runValidation(connection, pipelineId, workItemIds, targetStageId, allWorkItemsInStage = false) {
+        let result;
+        try {
+            result = await validatePromotion(connection, pipelineId, workItemIds, targetStageId, false, allWorkItemsInStage);
+        }
+        catch (error) {
+            const errMsg = error instanceof Error ? error.message : String(error);
+            if (errMsg.includes('sObject type') && errMsg.includes('is not supported')) {
+                this.error(commonErrorMessages.getMessage('error.DevopsCenterNotEnabled'));
+            }
+            const htmlStripped = errMsg.split('<')[0].trim();
+            const cleanMsg = htmlStripped.replace(/^[A-Z][A-Z0-9_]+:/, '').trim();
+            this.error(messages.getMessage('error.ValidationRequestFailed', [cleanMsg]));
+        }
+        if (!result.success) {
+            if (result.combineDetails) {
+                this.log(messages.getMessage('error.ValidationFailedCombineRequired'));
+                this.log(JSON.stringify(result.combineDetails, null, 2));
+            }
+            this.error(messages.getMessage('error.ValidationFailed', [
+                result.errorType ?? '',
+                formatValidationDetails(result.errorDetails),
+            ]));
+        }
+    }
 }
 //# sourceMappingURL=promote.js.map