@salesforce/plugin-devops-center 2.0.0 → 2.0.1

package/oclif.manifest.json

@@ -107,6 +107,12 @@
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
+        },
+        "skip-validation": {
+          "name": "skip-validation",
+          "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"
         }
       },
       "hasDynamicHelp": true,
@@ -698,9 +704,9 @@
       "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.",
       "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"
+        "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": {
@@ -803,6 +809,84 @@
         "complete.js"
       ]
     },
+    "devops:promotion:validate": {
+      "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.",
+      "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"
+      ],
+      "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"
+        },
+        "target-stage-id": {
+          "char": "t",
+          "name": "target-stage-id",
+          "required": true,
+          "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:promotion:validate",
+      "pluginAlias": "@salesforce/plugin-devops-center",
+      "pluginName": "@salesforce/plugin-devops-center",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Validate work item promotion for a pipeline stage.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "devops",
+        "promotion",
+        "validate.js"
+      ]
+    },
     "devops:request:status": {
       "aliases": [],
       "args": {},
@@ -1682,12 +1766,12 @@
         "delete.js"
       ]
     },
-    "devops:stage:environment:add": {
+    "devops:pipeline:stage:update": {
       "aliases": [],
       "args": {},
-      "description": "This command triggers an OAuth flow to authenticate the environment. A browser window opens automatically for you to log in.",
+      "description": "Updates the name of a pipeline stage.",
       "examples": [
-        "Add a production environment to a stage using its ID:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --stage-id 0Xp000000000001 --environment-name Production_Org --org-type Production"
+        "Rename a pipeline stage.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --stage-id 1QV000000000001 --name \"Integration\""
       ],
       "flags": {
         "json": {
@@ -1722,58 +1806,125 @@
           "multiple": false,
           "type": "option"
         },
-        "pipeline-id": {
-          "name": "pipeline-id",
+        "stage-id": {
+          "char": "s",
+          "name": "stage-id",
           "required": true,
-          "summary": "ID of the pipeline that contains the stage.",
+          "summary": "ID of the pipeline stage to update.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "stage-id": {
-          "name": "stage-id",
+        "name": {
+          "char": "n",
+          "name": "name",
           "required": true,
-          "summary": "ID of the pipeline stage.",
+          "summary": "New name for the pipeline stage.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        }
+      },
+      "hasDynamicHelp": true,
+      "hiddenAliases": [],
+      "id": "devops:pipeline:stage:update",
+      "pluginAlias": "@salesforce/plugin-devops-center",
+      "pluginName": "@salesforce/plugin-devops-center",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Update a DevOps Center pipeline stage.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "devops",
+        "pipeline",
+        "stage",
+        "update.js"
+      ]
+    },
+    "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.",
+      "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"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "environment-name": {
-          "char": "e",
-          "name": "environment-name",
+        "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 environment.",
+          "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"
         },
-        "org-type": {
-          "name": "org-type",
+        "pipeline-id": {
+          "name": "pipeline-id",
           "required": true,
-          "summary": "Type of the Salesforce org. Valid values: Production, Sandbox.",
+          "summary": "ID of the pipeline that contains the stage.",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "Production",
-            "Sandbox"
-          ],
           "type": "option"
         },
-        "no-browser": {
-          "name": "no-browser",
-          "summary": "Don't auto-open the browser for OAuth authentication. The redirect URL is printed for manual use.",
+        "stage-id": {
+          "name": "stage-id",
+          "required": true,
+          "summary": "ID of the pipeline stage to associate the branch with.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "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:stage:environment:add",
+      "id": "devops:stage:branch:add",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "core",
       "strict": true,
-      "summary": "Add a Salesforce environment to a pipeline stage.",
+      "summary": "Add a source code repository branch to a pipeline stage.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -1781,16 +1932,16 @@
         "commands",
         "devops",
         "stage",
-        "environment",
+        "branch",
         "add.js"
       ]
     },
-    "devops:stage:environment:delete": {
+    "devops:stage:branch:delete": {
       "aliases": [],
       "args": {},
-      "description": "Removes the specified environment from the pipeline stage. The environment must belong to an inactive pipeline.",
+      "description": "Removes the branch linked to the specified pipeline stage. Because branches are configured from right to left (a stage can have a branch only after the stage to its right does), removing a branch also removes the branches from all upstream stages (to the left) in the pipeline, keeping it in a valid state. The branch records in the repository are not deleted; only their association with the stages is removed. The stage must belong to an inactive pipeline.",
       "examples": [
-        "Delete an environment:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --environment-id 0Xe000000000001"
+        "Delete the branch associated with a pipeline stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Xo000000000001 --stage-id 0Xp000000000001"
       ],
       "flags": {
         "json": {
@@ -1828,16 +1979,15 @@
         "pipeline-id": {
           "name": "pipeline-id",
           "required": true,
-          "summary": "ID of the pipeline. Used to verify the pipeline is inactive before deleting.",
+          "summary": "ID of the pipeline that contains the stage. Used to verify the pipeline is inactive before deleting.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "environment-id": {
-          "char": "e",
-          "name": "environment-id",
+        "stage-id": {
+          "name": "stage-id",
           "required": true,
-          "summary": "ID of the environment to delete.",
+          "summary": "ID of the pipeline stage whose branch you want to delete.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1845,12 +1995,12 @@
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "devops:stage:environment:delete",
+      "id": "devops:stage:branch:delete",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "core",
       "strict": true,
-      "summary": "Delete an environment from a DevOps Center pipeline stage.",
+      "summary": "Delete the source code repository branch associated with a pipeline stage.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -1858,17 +2008,16 @@
         "commands",
         "devops",
         "stage",
-        "environment",
+        "branch",
         "delete.js"
       ]
     },
-    "devops:stage:branch:add": {
+    "devops:stage:environment:add": {
       "aliases": [],
       "args": {},
-      "description": "By default, the branch must exist in the repository. Use --create-vcs-branch to create a branch if it doesn't exist.\nEach pipeline stage supports only one branch. Adding a branch replaces any existing branch linked to the pipeline stage.",
+      "description": "This command triggers an OAuth flow to authenticate the environment. A browser window opens automatically for you to log in.",
       "examples": [
-        "Add an existing branch to a stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Xo000000000001 --stage-id 0Xp000000000001 --branch-name main",
-        "Create and add a branch to a pipeline stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Xo000000000001 --stage-id 0Xp000000000002 --branch-name integration --create-vcs-branch"
+        "Add a production environment to a stage using its ID:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --stage-id 0Xp000000000001 --environment-name Production_Org --org-type Production"
       ],
       "flags": {
         "json": {
@@ -1914,35 +2063,47 @@
         "stage-id": {
           "name": "stage-id",
           "required": true,
-          "summary": "ID of the pipeline stage to associate the branch with.",
+          "summary": "ID of the pipeline stage.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "branch-name": {
-          "char": "b",
-          "name": "branch-name",
+        "environment-name": {
+          "char": "e",
+          "name": "environment-name",
           "required": true,
-          "summary": "Name of the repository branch to assign to the stage.",
+          "summary": "Name of the environment.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "create-vcs-branch": {
-          "name": "create-vcs-branch",
-          "summary": "Create the branch in the remote repository if it doesn't already exist.",
+        "org-type": {
+          "name": "org-type",
+          "required": true,
+          "summary": "Type of the Salesforce org. Valid values: Production, Sandbox.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "Production",
+            "Sandbox"
+          ],
+          "type": "option"
+        },
+        "no-browser": {
+          "name": "no-browser",
+          "summary": "Don't auto-open the browser for OAuth authentication. The redirect URL is printed for manual use.",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "devops:stage:branch:add",
+      "id": "devops:stage:environment:add",
       "pluginAlias": "@salesforce/plugin-devops-center",
       "pluginName": "@salesforce/plugin-devops-center",
       "pluginType": "core",
       "strict": true,
-      "summary": "Add a source code repository branch to a pipeline stage.",
+      "summary": "Add a Salesforce environment to a pipeline stage.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -1950,10 +2111,87 @@
         "commands",
         "devops",
         "stage",
-        "branch",
+        "environment",
         "add.js"
       ]
     },
+    "devops:stage:environment:delete": {
+      "aliases": [],
+      "args": {},
+      "description": "Removes the specified environment from the pipeline stage. The environment must belong to an inactive pipeline.",
+      "examples": [
+        "Delete an environment:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --environment-id 0Xe000000000001"
+      ],
+      "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. Used to verify the pipeline is inactive before deleting.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "environment-id": {
+          "char": "e",
+          "name": "environment-id",
+          "required": true,
+          "summary": "ID of the environment to delete.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": true,
+      "hiddenAliases": [],
+      "id": "devops:stage:environment:delete",
+      "pluginAlias": "@salesforce/plugin-devops-center",
+      "pluginName": "@salesforce/plugin-devops-center",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Delete an environment from a DevOps Center pipeline stage.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "devops",
+        "stage",
+        "environment",
+        "delete.js"
+      ]
+    },
     "project:deploy:pipeline:quick": {
       "aliases": [],
       "args": {},
@@ -2531,5 +2769,5 @@
       ]
     }
   },
-  "version": "2.0.0"
+  "version": "2.0.1"
 }

package/package.json

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

package/schemas/devops-pipeline-stage-update.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/PipelineStageUpdateResult",
+  "definitions": {
+    "PipelineStageUpdateResult": {
+      "type": "object",
+      "properties": {
+        "success": {
+          "type": "boolean"
+        },
+        "stageId": {
+          "type": "string"
+        },
+        "name": {
+          "type": "string"
+        }
+      },
+      "required": ["success", "stageId", "name"],
+      "additionalProperties": false
+    }
+  }
+}

package/schemas/devops-promote.json

@@ -19,10 +19,48 @@
           "items": {
             "type": "string"
           }
+        },
+        "combineDetails": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/CombineDetails"
+            },
+            {
+              "type": "null"
+            }
+          ]
         }
       },
       "required": ["requestId", "status", "message", "promotedWorkitemIds"],
       "additionalProperties": false
+    },
+    "CombineDetails": {
+      "type": "object",
+      "additionalProperties": {},
+      "properties": {
+        "childWorkitemsId": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "parentWorkitemId": {
+          "type": "string"
+        },
+        "sharedComponentsList": {
+          "$ref": "#/definitions/SharedComponentsList"
+        }
+      }
+    },
+    "SharedComponentsList": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        }
+      },
+      "description": "Maps a comma-separated list of work item names to the components they share."
     }
   }
 }

package/schemas/devops-promotion-validate.json

@@ -0,0 +1,66 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/PromotionValidateResult",
+  "definitions": {
+    "PromotionValidateResult": {
+      "type": "object",
+      "properties": {
+        "success": {
+          "type": "boolean"
+        },
+        "errorType": {
+          "type": ["string", "null"]
+        },
+        "errorDetails": {
+          "type": ["string", "null"]
+        },
+        "combineDetails": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/CombineDetails"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "suggestions": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "required": ["success", "errorType", "errorDetails", "combineDetails", "suggestions"],
+      "additionalProperties": false
+    },
+    "CombineDetails": {
+      "type": "object",
+      "additionalProperties": {},
+      "properties": {
+        "childWorkitemsId": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "parentWorkitemId": {
+          "type": "string"
+        },
+        "sharedComponentsList": {
+          "$ref": "#/definitions/SharedComponentsList"
+        }
+      }
+    },
+    "SharedComponentsList": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        }
+      },
+      "description": "Maps a comma-separated list of work item names to the components they share."
+    }
+  }
+}