@W-23154741 - Devops promote commands

README.md

@@ -56,13 +56,13 @@ sf plugins
 
 <!-- commands -->
 
-- [`sf devops pipeline activate`](#sf-devops-pipeline-activate)
+- [`sf devops pipeline update`](#sf-devops-pipeline-update)
 - [`sf devops pipeline create`](#sf-devops-pipeline-create)
 - [`sf devops pipeline project add`](#sf-devops-pipeline-project-add)
 - [`sf devops pipeline stage add`](#sf-devops-pipeline-stage-add)
 - [`sf devops project create`](#sf-devops-project-create)
 - [`sf devops project list`](#sf-devops-project-list)
-- [`sf devops pull-request create`](#sf-devops-pull-request-create)
+- [`sf devops review create`](#sf-devops-review-create)
 - [`sf devops stage branch add`](#sf-devops-stage-branch-add)
 - [`sf devops stage environment add`](#sf-devops-stage-environment-add)
 - [`sf devops work-item create`](#sf-devops-work-item-create)
@@ -74,37 +74,44 @@ sf plugins
 - [`sf project deploy pipeline start`](#sf-project-deploy-pipeline-start)
 - [`sf project deploy pipeline validate`](#sf-project-deploy-pipeline-validate)
 
-## `sf devops pipeline activate`
+## `sf devops pipeline update`
 
-Activate a DevOps Center pipeline for deployments.
+Activate or deactivate a DevOps Center pipeline.
 
 ```
 USAGE
-  $ sf devops pipeline activate -o <value> --pipeline-id <value> [--json] [--flags-dir <value>] [--api-version <value>]
+  $ sf devops pipeline update -o <value> --pipeline-id <value> [--active | --no-active] [--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
+      --[no-]active          Activate the pipeline. Use --no-active to deactivate.
       --pipeline-id=<value>  (required) ID of the pipeline.
 
 GLOBAL FLAGS
   --flags-dir=<value>  Import flag values from a directory.
   --json               Format output as json.
 
 DESCRIPTION
-  Activate a DevOps Center pipeline for deployments.
+  Activate or deactivate a DevOps Center pipeline.
 
-  A pipeline must have at least one stage before you activate it. You can't modify the pipeline stages after you
+  Use --active to activate a pipeline and make it available for deployments. Use --no-active to deactivate it.
+
+  A 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
-  Activate a pipeline using the pipeline ID.
+  Activate a pipeline.
+
+    $ sf devops pipeline update --target-org my-devops-org --pipeline-id 0XB000000000001 --active
+
+  Deactivate a pipeline.
 
-    $ sf devops pipeline activate --target-org my-devops-org --pipeline-id 0XB000000000001
+    $ sf devops pipeline update --target-org my-devops-org --pipeline-id 0XB000000000001 --no-active
 ```
 
-_See code: [src/commands/devops/pipeline/activate.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.4.0/src/commands/devops/pipeline/activate.ts)_
+_See code: [src/commands/devops/pipeline/update.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.4.0/src/commands/devops/pipeline/update.ts)_
 
 ## `sf devops pipeline create`
 
@@ -315,13 +322,13 @@ EXAMPLES
 
 _See code: [src/commands/devops/project/list.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.4.0/src/commands/devops/project/list.ts)_
 
-## `sf devops pull-request create`
+## `sf devops review create`
 
 Create a pull request for a work item branch.
 
 ```
 USAGE
-  $ sf devops pull-request create -o <value> [--json] [--flags-dir <value>] [--api-version <value>] [-n <value>] [-w
+  $ sf devops review create -o <value> [--json] [--flags-dir <value>] [--api-version <value>] [-n <value>] [-w
   <value>]
 
 FLAGS
@@ -344,14 +351,14 @@ DESCRIPTION
 EXAMPLES
   Create a pull request for a work item.
 
-    $ sf devops pull-request create --target-org my-devops-org --work-item-name WI-000001
+    $ sf devops review create --target-org my-devops-org --work-item-name WI-000001
 
   Create a pull request using the work item ID.
 
-    $ sf devops pull-request create --target-org my-devops-org --work-item-id 0Wx000000000001
+    $ sf devops review create --target-org my-devops-org --work-item-id 0Wx000000000001
 ```
 
-_See code: [src/commands/devops/pull-request/create.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.4.0/src/commands/devops/pull-request/create.ts)_
+_See code: [src/commands/devops/review/create.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.4.0/src/commands/devops/review/create.ts)_
 
 ## `sf devops stage branch add`
 

command-snapshot.json

@@ -1,12 +1,4 @@
 [
-  {
-    "alias": [],
-    "command": "devops:pipeline:activate",
-    "flagAliases": [],
-    "flagChars": ["o"],
-    "flags": ["api-version", "flags-dir", "json", "pipeline-id", "target-org"],
-    "plugin": "@salesforce/plugin-devops-center"
-  },
   {
     "alias": [],
     "command": "devops:pipeline:create",
@@ -44,6 +36,14 @@
     "flags": ["api-version", "flags-dir", "json", "name", "next-stage-id", "pipeline-id", "target-org"],
     "plugin": "@salesforce/plugin-devops-center"
   },
+  {
+    "alias": [],
+    "command": "devops:pipeline:update",
+    "flagAliases": [],
+    "flagChars": ["n", "o"],
+    "flags": ["active", "api-version", "flags-dir", "json", "name", "pipeline-id", "target-org"],
+    "plugin": "@salesforce/plugin-devops-center"
+  },
   {
     "alias": [],
     "command": "devops:project:create",
@@ -62,7 +62,52 @@
   },
   {
     "alias": [],
-    "command": "devops:pull-request:create",
+    "command": "devops:promote",
+    "flagAliases": [],
+    "flagChars": ["a", "i", "l", "o", "s", "t"],
+    "flags": [
+      "api-version",
+      "deploy-all",
+      "flags-dir",
+      "json",
+      "stage-id",
+      "target-org",
+      "target-stage-id",
+      "test-level",
+      "tests",
+      "work-item-id"
+    ],
+    "plugin": "@salesforce/plugin-devops-center"
+  },
+  {
+    "alias": [],
+    "command": "devops:promotion:complete",
+    "flagAliases": [],
+    "flagChars": ["a", "i", "l", "o", "t"],
+    "flags": [
+      "api-version",
+      "deploy-all",
+      "flags-dir",
+      "json",
+      "target-org",
+      "target-stage-id",
+      "test-level",
+      "tests",
+      "work-item-id"
+    ],
+    "plugin": "@salesforce/plugin-devops-center"
+  },
+  {
+    "alias": [],
+    "command": "devops:request:status",
+    "flagAliases": [],
+    "flagChars": ["i", "o"],
+    "flags": ["api-version", "flags-dir", "json", "request-token", "target-org"],
+    "plugin": "@salesforce/plugin-devops-center"
+  },
+  {
+    "alias": [],
+    "command": "devops:review:create",
     "flagAliases": [],
     "flagChars": ["n", "o", "w"],
     "flags": ["api-version", "flags-dir", "json", "target-org", "work-item-id", "work-item-name"],
@@ -103,6 +148,22 @@
     ],
     "plugin": "@salesforce/plugin-devops-center"
   },
+  {
+    "alias": [],
+    "command": "devops:work-item:combine",
+    "flagAliases": [],
+    "flagChars": ["o", "t"],
+    "flags": [
+      "api-version",
+      "child-work-item-id",
+      "flags-dir",
+      "json",
+      "parent-work-item-id",
+      "target-org",
+      "target-stage-id"
+    ],
+    "plugin": "@salesforce/plugin-devops-center"
+  },
   {
     "alias": [],
     "command": "devops:work-item:create",
@@ -119,6 +180,14 @@
     "flags": ["api-version", "flags-dir", "json", "project-id", "target-org"],
     "plugin": "@salesforce/plugin-devops-center"
   },
+  {
+    "alias": [],
+    "command": "devops:work-item:prepare",
+    "flagAliases": [],
+    "flagChars": ["i", "o", "t"],
+    "flags": ["api-version", "flags-dir", "json", "target-org", "target-stage-id", "work-item-id"],
+    "plugin": "@salesforce/plugin-devops-center"
+  },
   {
     "alias": [],
     "command": "devops:work-item:update",

messages/devops.pipeline.update.md

@@ -0,0 +1,47 @@
+# summary
+
+Update a DevOps Center pipeline.
+
+# description
+
+Activate, deactivate, or rename a DevOps Center pipeline. Use --active to activate, --no-active to deactivate, and --name to rename. You can combine --no-active and --name in one command.
+
+A 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.
+
+# flags.pipeline-id.summary
+
+ID of the pipeline.
+
+# flags.active.summary
+
+Activate the pipeline. Use --no-active to deactivate.
+
+# flags.name.summary
+
+New name for the pipeline.
+
+# examples
+
+- Activate a pipeline:
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --active
+
+- Deactivate and rename in one step.
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --no-active --name "My Pipeline"
+
+# error.NoFlags
+
+Provide at least one of --active/--no-active or --name.
+
+# error.NoStages
+
+Can't activate pipeline %s. Add at least one stage, then try again.
+
+# error.AlreadyActive
+
+Pipeline %s is already active.
+
+# error.AlreadyInactive
+
+Pipeline %s is already inactive.

messages/devops.promote.md

@@ -0,0 +1,61 @@
+# summary
+
+Promote work items or a pipeline stage to a target pipeline stage.
+
+# description
+
+Promote specific work items or all approved work items from a source stage to the target pipeline stage.
+
+Pass --work-item-id to promote one or more specific work items to the target stage.
+
+Pass --stage-id to promote all approved work items from that source stage to the target stage.
+
+Exactly one of --work-item-id or --stage-id must be provided.
+
+Use --deploy-all to deploy all metadata in the branch rather than only changes not yet in the target stage.
+
+# flags.target-stage-id.summary
+
+ID of the pipeline stage to promote to.
+
+# flags.work-item-id.summary
+
+ID of the work item to promote. Mutually exclusive with --stage-id.
+
+# flags.work-item-id.description
+
+Specify this flag multiple times to promote multiple work items in a single operation.
+
+# flags.stage-id.summary
+
+ID of the source pipeline stage whose approved work items will be promoted. Mutually exclusive with --work-item-id.
+
+# examples
+
+- Promote all approved work items from a source stage to a target stage:
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --stage-id 1QVxx0000000001 --target-stage-id 1QVxx0000000002
+
+- Promote a specific work item to a stage:
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-id 1fkxx0000000001 --target-stage-id 1QVxx0000000001
+
+- Promote multiple work items:
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-id 1fkxx0000000001 --work-item-id 1fkxx0000000002 --target-stage-id 1QVxx0000000001
+
+- Promote a stage with full deploy:
+
+      <%= config.bin %> <%= command.id %> --target-org my-devops-org --stage-id 1QVxx0000000001 --target-stage-id 1QVxx0000000002 --deploy-all
+
+# error.NoModeFlag
+
+Provide either --work-item-id to promote specific work items or --stage-id to promote all approved work items from a stage.
+
+# error.NoWorkItems
+
+No work items found to promote from the source stage. Make sure there are approved work items before promoting.
+
+# error.PromoteFailed
+
+Failed to promote: %s