@salesforce/plugin-devops-center 2.3.2 → 2.3.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +31 -31
  2. package/oclif.manifest.json +312 -312
  3. package/package.json +4 -4
package/README.md CHANGED
@@ -161,7 +161,7 @@ EXAMPLES
161
161
  https://github.com/myorg/myrepo --project-id 0Hn000000000001 --project-id 0Hn000000000002
162
162
  ```
163
163
 
164
- _See code: [src/commands/devops/pipeline/create.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.2/src/commands/devops/pipeline/create.ts)_
164
+ _See code: [src/commands/devops/pipeline/create.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.3/src/commands/devops/pipeline/create.ts)_
165
165
 
166
166
  ## `sf devops pipeline get`
167
167
 
@@ -193,7 +193,7 @@ EXAMPLES
193
193
  $ sf devops pipeline get --target-org my-devops-org --pipeline-id 0Do000000000001
194
194
  ```
195
195
 
196
- _See code: [src/commands/devops/pipeline/get.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.2/src/commands/devops/pipeline/get.ts)_
196
+ _See code: [src/commands/devops/pipeline/get.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.3/src/commands/devops/pipeline/get.ts)_
197
197
 
198
198
  ## `sf devops pipeline list`
199
199
 
@@ -224,7 +224,7 @@ EXAMPLES
224
224
  $ sf devops pipeline list --target-org my-devops-org
225
225
  ```
226
226
 
227
- _See code: [src/commands/devops/pipeline/list.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.2/src/commands/devops/pipeline/list.ts)_
227
+ _See code: [src/commands/devops/pipeline/list.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.3/src/commands/devops/pipeline/list.ts)_
228
228
 
229
229
  ## `sf devops pipeline project add`
230
230
 
@@ -258,7 +258,7 @@ EXAMPLES
258
258
  0Hn000000000001
259
259
  ```
260
260
 
261
- _See code: [src/commands/devops/pipeline/project/add.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.2/src/commands/devops/pipeline/project/add.ts)_
261
+ _See code: [src/commands/devops/pipeline/project/add.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.3/src/commands/devops/pipeline/project/add.ts)_
262
262
 
263
263
  ## `sf devops pipeline project delete`
264
264
 
@@ -292,7 +292,7 @@ EXAMPLES
292
292
  0Hn000000000001
293
293
  ```
294
294
 
295
- _See code: [src/commands/devops/pipeline/project/delete.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.2/src/commands/devops/pipeline/project/delete.ts)_
295
+ _See code: [src/commands/devops/pipeline/project/delete.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.3/src/commands/devops/pipeline/project/delete.ts)_
296
296
 
297
297
  ## `sf devops pipeline stage add`
298
298
 
@@ -333,7 +333,7 @@ EXAMPLES
333
333
  --next-stage-id 0Xc000000000003
334
334
  ```
335
335
 
336
- _See code: [src/commands/devops/pipeline/stage/add.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.2/src/commands/devops/pipeline/stage/add.ts)_
336
+ _See code: [src/commands/devops/pipeline/stage/add.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.3/src/commands/devops/pipeline/stage/add.ts)_
337
337
 
338
338
  ## `sf devops pipeline stage delete`
339
339
 
@@ -368,7 +368,7 @@ EXAMPLES
368
368
  0Xc000000000002
369
369
  ```
370
370
 
371
- _See code: [src/commands/devops/pipeline/stage/delete.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.2/src/commands/devops/pipeline/stage/delete.ts)_
371
+ _See code: [src/commands/devops/pipeline/stage/delete.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.3/src/commands/devops/pipeline/stage/delete.ts)_
372
372
 
373
373
  ## `sf devops pipeline stage update`
374
374
 
@@ -401,7 +401,7 @@ EXAMPLES
401
401
  $ sf devops pipeline stage update --target-org my-devops-org --stage-id 1QV000000000001 --name "Integration"
402
402
  ```
403
403
 
404
- _See code: [src/commands/devops/pipeline/stage/update.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.2/src/commands/devops/pipeline/stage/update.ts)_
404
+ _See code: [src/commands/devops/pipeline/stage/update.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.3/src/commands/devops/pipeline/stage/update.ts)_
405
405
 
406
406
  ## `sf devops pipeline update`
407
407
 
@@ -445,7 +445,7 @@ EXAMPLES
445
445
  Pipeline"
446
446
  ```
447
447
 
448
- _See code: [src/commands/devops/pipeline/update.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.2/src/commands/devops/pipeline/update.ts)_
448
+ _See code: [src/commands/devops/pipeline/update.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.3/src/commands/devops/pipeline/update.ts)_
449
449
 
450
450
  ## `sf devops project create`
451
451
 
@@ -482,7 +482,7 @@ EXAMPLES
482
482
  update"
483
483
  ```
484
484
 
485
- _See code: [src/commands/devops/project/create.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.2/src/commands/devops/project/create.ts)_
485
+ _See code: [src/commands/devops/project/create.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.3/src/commands/devops/project/create.ts)_
486
486
 
487
487
  ## `sf devops project list`
488
488
 
@@ -517,7 +517,7 @@ EXAMPLES
517
517
  $ sf devops project list --target-org devops-center@example.com
518
518
  ```
519
519
 
520
- _See code: [src/commands/devops/project/list.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.2/src/commands/devops/project/list.ts)_
520
+ _See code: [src/commands/devops/project/list.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.3/src/commands/devops/project/list.ts)_
521
521
 
522
522
  ## `sf devops project update`
523
523
 
@@ -567,7 +567,7 @@ EXAMPLES
567
567
  --description "Archived" --no-is-active
568
568
  ```
569
569
 
570
- _See code: [src/commands/devops/project/update.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.2/src/commands/devops/project/update.ts)_
570
+ _See code: [src/commands/devops/project/update.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.3/src/commands/devops/project/update.ts)_
571
571
 
572
572
  ## `sf devops promote`
573
573
 
@@ -669,7 +669,7 @@ FLAG DESCRIPTIONS
669
669
  spaces.
670
670
  ```
671
671
 
672
- _See code: [src/commands/devops/promote.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.2/src/commands/devops/promote.ts)_
672
+ _See code: [src/commands/devops/promote.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.3/src/commands/devops/promote.ts)_
673
673
 
674
674
  ## `sf devops promotion complete`
675
675
 
@@ -752,7 +752,7 @@ FLAG DESCRIPTIONS
752
752
  spaces.
753
753
  ```
754
754
 
755
- _See code: [src/commands/devops/promotion/complete.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.2/src/commands/devops/promotion/complete.ts)_
755
+ _See code: [src/commands/devops/promotion/complete.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.3/src/commands/devops/promotion/complete.ts)_
756
756
 
757
757
  ## `sf devops promotion validate`
758
758
 
@@ -793,7 +793,7 @@ EXAMPLES
793
793
  1fk000000000001 --work-item-id 1fk000000000002
794
794
  ```
795
795
 
796
- _See code: [src/commands/devops/promotion/validate.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.2/src/commands/devops/promotion/validate.ts)_
796
+ _See code: [src/commands/devops/promotion/validate.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.3/src/commands/devops/promotion/validate.ts)_
797
797
 
798
798
  ## `sf devops request status`
799
799
 
@@ -824,7 +824,7 @@ EXAMPLES
824
824
  $ sf devops request status --target-org my-devops-org --request-token a0B000000000001
825
825
  ```
826
826
 
827
- _See code: [src/commands/devops/request/status.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.2/src/commands/devops/request/status.ts)_
827
+ _See code: [src/commands/devops/request/status.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.3/src/commands/devops/request/status.ts)_
828
828
 
829
829
  ## `sf devops review create`
830
830
 
@@ -861,7 +861,7 @@ EXAMPLES
861
861
  $ sf devops review create --target-org my-devops-org --work-item-id 0Wx000000000001
862
862
  ```
863
863
 
864
- _See code: [src/commands/devops/review/create.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.2/src/commands/devops/review/create.ts)_
864
+ _See code: [src/commands/devops/review/create.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.3/src/commands/devops/review/create.ts)_
865
865
 
866
866
  ## `sf devops stage branch add`
867
867
 
@@ -907,7 +907,7 @@ EXAMPLES
907
907
  --branch-name integration --create-vcs-branch
908
908
  ```
909
909
 
910
- _See code: [src/commands/devops/stage/branch/add.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.2/src/commands/devops/stage/branch/add.ts)_
910
+ _See code: [src/commands/devops/stage/branch/add.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.3/src/commands/devops/stage/branch/add.ts)_
911
911
 
912
912
  ## `sf devops stage branch delete`
913
913
 
@@ -945,7 +945,7 @@ EXAMPLES
945
945
  0Xp000000000001
946
946
  ```
947
947
 
948
- _See code: [src/commands/devops/stage/branch/delete.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.2/src/commands/devops/stage/branch/delete.ts)_
948
+ _See code: [src/commands/devops/stage/branch/delete.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.3/src/commands/devops/stage/branch/delete.ts)_
949
949
 
950
950
  ## `sf devops stage environment add`
951
951
 
@@ -989,7 +989,7 @@ EXAMPLES
989
989
  Production_Org --org-type Production
990
990
  ```
991
991
 
992
- _See code: [src/commands/devops/stage/environment/add.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.2/src/commands/devops/stage/environment/add.ts)_
992
+ _See code: [src/commands/devops/stage/environment/add.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.3/src/commands/devops/stage/environment/add.ts)_
993
993
 
994
994
  ## `sf devops stage environment delete`
995
995
 
@@ -1023,7 +1023,7 @@ EXAMPLES
1023
1023
  0Xe000000000001
1024
1024
  ```
1025
1025
 
1026
- _See code: [src/commands/devops/stage/environment/delete.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.2/src/commands/devops/stage/environment/delete.ts)_
1026
+ _See code: [src/commands/devops/stage/environment/delete.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.3/src/commands/devops/stage/environment/delete.ts)_
1027
1027
 
1028
1028
  ## `sf devops work-item combine`
1029
1029
 
@@ -1072,7 +1072,7 @@ FLAG DESCRIPTIONS
1072
1072
  are merged into the parent's branch during promotion.
1073
1073
  ```
1074
1074
 
1075
- _See code: [src/commands/devops/work-item/combine.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.2/src/commands/devops/work-item/combine.ts)_
1075
+ _See code: [src/commands/devops/work-item/combine.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.3/src/commands/devops/work-item/combine.ts)_
1076
1076
 
1077
1077
  ## `sf devops work-item create`
1078
1078
 
@@ -1113,7 +1113,7 @@ EXAMPLES
1113
1113
  --description "Implement dark mode toggle in settings page"
1114
1114
  ```
1115
1115
 
1116
- _See code: [src/commands/devops/work-item/create.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.2/src/commands/devops/work-item/create.ts)_
1116
+ _See code: [src/commands/devops/work-item/create.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.3/src/commands/devops/work-item/create.ts)_
1117
1117
 
1118
1118
  ## `sf devops work-item list`
1119
1119
 
@@ -1149,7 +1149,7 @@ EXAMPLES
1149
1149
  $ sf devops work-item list --target-org my-devops-org --project-id 1Qg000000000001 --json
1150
1150
  ```
1151
1151
 
1152
- _See code: [src/commands/devops/work-item/list.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.2/src/commands/devops/work-item/list.ts)_
1152
+ _See code: [src/commands/devops/work-item/list.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.3/src/commands/devops/work-item/list.ts)_
1153
1153
 
1154
1154
  ## `sf devops work-item prepare`
1155
1155
 
@@ -1190,7 +1190,7 @@ EXAMPLES
1190
1190
  --target-stage-id 05S000000000002
1191
1191
  ```
1192
1192
 
1193
- _See code: [src/commands/devops/work-item/prepare.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.2/src/commands/devops/work-item/prepare.ts)_
1193
+ _See code: [src/commands/devops/work-item/prepare.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.3/src/commands/devops/work-item/prepare.ts)_
1194
1194
 
1195
1195
  ## `sf devops work-item update`
1196
1196
 
@@ -1237,7 +1237,7 @@ EXAMPLES
1237
1237
  --description "Users can't log in on mobile" --status "In Progress"
1238
1238
  ```
1239
1239
 
1240
- _See code: [src/commands/devops/work-item/update.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.2/src/commands/devops/work-item/update.ts)_
1240
+ _See code: [src/commands/devops/work-item/update.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.3/src/commands/devops/work-item/update.ts)_
1241
1241
 
1242
1242
  ## `sf project deploy pipeline quick`
1243
1243
 
@@ -1311,7 +1311,7 @@ FLAG DESCRIPTIONS
1311
1311
  "sf project deploy pipeline report".
1312
1312
  ```
1313
1313
 
1314
- _See code: [src/commands/project/deploy/pipeline/quick.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.2/src/commands/project/deploy/pipeline/quick.ts)_
1314
+ _See code: [src/commands/project/deploy/pipeline/quick.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.3/src/commands/project/deploy/pipeline/quick.ts)_
1315
1315
 
1316
1316
  ## `sf project deploy pipeline report`
1317
1317
 
@@ -1359,7 +1359,7 @@ FLAG DESCRIPTIONS
1359
1359
  your most recent operation was longer than 3 days ago, this flag won't find the job ID.
1360
1360
  ```
1361
1361
 
1362
- _See code: [src/commands/project/deploy/pipeline/report.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.2/src/commands/project/deploy/pipeline/report.ts)_
1362
+ _See code: [src/commands/project/deploy/pipeline/report.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.3/src/commands/project/deploy/pipeline/report.ts)_
1363
1363
 
1364
1364
  ## `sf project deploy pipeline resume`
1365
1365
 
@@ -1426,7 +1426,7 @@ FLAG DESCRIPTIONS
1426
1426
  returns the job ID. To check the status of the operation, run "sf project deploy pipeline report".
1427
1427
  ```
1428
1428
 
1429
- _See code: [src/commands/project/deploy/pipeline/resume.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.2/src/commands/project/deploy/pipeline/resume.ts)_
1429
+ _See code: [src/commands/project/deploy/pipeline/resume.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.3/src/commands/project/deploy/pipeline/resume.ts)_
1430
1430
 
1431
1431
  ## `sf project deploy pipeline start`
1432
1432
 
@@ -1526,7 +1526,7 @@ FLAG DESCRIPTIONS
1526
1526
  "sf project deploy pipeline report".
1527
1527
  ```
1528
1528
 
1529
- _See code: [src/commands/project/deploy/pipeline/start.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.2/src/commands/project/deploy/pipeline/start.ts)_
1529
+ _See code: [src/commands/project/deploy/pipeline/start.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.3/src/commands/project/deploy/pipeline/start.ts)_
1530
1530
 
1531
1531
  ## `sf project deploy pipeline validate`
1532
1532
 
@@ -1626,7 +1626,7 @@ FLAG DESCRIPTIONS
1626
1626
  "sf project deploy pipeline report".
1627
1627
  ```
1628
1628
 
1629
- _See code: [src/commands/project/deploy/pipeline/validate.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.2/src/commands/project/deploy/pipeline/validate.ts)_
1629
+ _See code: [src/commands/project/deploy/pipeline/validate.ts](https://github.com/salesforcecli/plugin-devops-center/blob/2.3.3/src/commands/project/deploy/pipeline/validate.ts)_
1630
1630
 
1631
1631
  <!-- commandsstop -->
1632
1632
 
@@ -138,14 +138,17 @@
138
138
  "promote.js"
139
139
  ]
140
140
  },
141
- "devops:promotion:complete": {
141
+ "devops:pipeline:create": {
142
142
  "aliases": [],
143
143
  "args": {},
144
- "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.",
144
+ "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.",
145
145
  "examples": [
146
- "Complete a promotion for an out-of-sync pipeline stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001",
147
- "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",
148
- "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"
146
+ "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",
147
+ "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",
148
+ "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",
149
+ "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",
150
+ "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",
151
+ "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"
149
152
  ],
150
153
  "flags": {
151
154
  "json": {
@@ -180,129 +183,73 @@
180
183
  "multiple": false,
181
184
  "type": "option"
182
185
  },
183
- "target-stage-id": {
184
- "char": "t",
185
- "name": "target-stage-id",
186
+ "name": {
187
+ "char": "n",
188
+ "name": "name",
186
189
  "required": true,
187
- "summary": "ID of the out-of-sync pipeline stage to deploy to.",
190
+ "summary": "Name of the pipeline.",
188
191
  "hasDynamicHelp": false,
189
192
  "multiple": false,
190
193
  "type": "option"
191
194
  },
192
- "work-item-id": {
193
- "char": "i",
194
- "name": "work-item-id",
195
- "required": false,
196
- "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.",
195
+ "repo": {
196
+ "char": "r",
197
+ "name": "repo",
198
+ "required": true,
199
+ "summary": "URL of an existing repository or the name of a repository to create.",
197
200
  "hasDynamicHelp": false,
198
- "multiple": true,
201
+ "multiple": false,
199
202
  "type": "option"
200
203
  },
201
- "deploy-all": {
202
- "char": "a",
203
- "description": "If you don’t specify this flag, only changes in the stage’s branch are deployed.",
204
- "name": "deploy-all",
205
- "summary": "Deploy all metadata in the branch to the stage's org.",
206
- "allowNo": false,
207
- "type": "boolean"
208
- },
209
- "test-level": {
210
- "char": "l",
211
- "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)",
212
- "name": "test-level",
213
- "summary": "Deployment Apex testing level.",
204
+ "repo-type": {
205
+ "name": "repo-type",
206
+ "summary": "Type of the source code repository. Required when creating a repository using '--create-repo'.",
214
207
  "hasDynamicHelp": false,
215
208
  "multiple": false,
216
209
  "options": [
217
- "NoTestRun",
218
- "RunSpecifiedTests",
219
- "RunLocalTests",
220
- "RunAllTestsInOrg"
210
+ "github",
211
+ "bitbucket"
221
212
  ],
222
213
  "type": "option"
223
214
  },
224
- "tests": {
225
- "description": "Separate multiple test names with commas. Enclose the entire flag value in double quotes if a test name contains spaces.",
226
- "name": "tests",
227
- "summary": "Apex tests to run when --test-level is RunSpecifiedTests.",
228
- "hasDynamicHelp": false,
229
- "multiple": true,
230
- "type": "option"
231
- }
232
- },
233
- "hasDynamicHelp": true,
234
- "hiddenAliases": [],
235
- "id": "devops:promotion:complete",
236
- "pluginAlias": "@salesforce/plugin-devops-center",
237
- "pluginName": "@salesforce/plugin-devops-center",
238
- "pluginType": "core",
239
- "strict": true,
240
- "summary": "Deploy undeployed work items to a pipeline stage org.",
241
- "enableJsonFlag": true,
242
- "isESM": true,
243
- "relativePath": [
244
- "lib",
245
- "commands",
246
- "devops",
247
- "promotion",
248
- "complete.js"
249
- ]
250
- },
251
- "devops:promotion:validate": {
252
- "aliases": [],
253
- "args": {},
254
- "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.",
255
- "examples": [
256
- "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",
257
- "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"
258
- ],
259
- "flags": {
260
- "json": {
261
- "description": "Format output as json.",
262
- "helpGroup": "GLOBAL",
263
- "name": "json",
215
+ "create-repo": {
216
+ "name": "create-repo",
217
+ "summary": "Create a repository if it doesn't exist.",
264
218
  "allowNo": false,
265
219
  "type": "boolean"
266
220
  },
267
- "flags-dir": {
268
- "helpGroup": "GLOBAL",
269
- "name": "flags-dir",
270
- "summary": "Import flag values from a directory.",
221
+ "repo-owner": {
222
+ "name": "repo-owner",
223
+ "summary": "Owner (organization or user) of the GitHub repository. Required when creating a GitHub repository using '--create-repo'.",
271
224
  "hasDynamicHelp": false,
272
225
  "multiple": false,
273
226
  "type": "option"
274
227
  },
275
- "target-org": {
276
- "char": "o",
277
- "name": "target-org",
278
- "noCacheDefault": true,
279
- "required": true,
280
- "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
281
- "hasDynamicHelp": true,
228
+ "bitbucket-workspace": {
229
+ "name": "bitbucket-workspace",
230
+ "summary": "Bitbucket workspace that will own the repository. Required when creating a Bitbucket repository using '--create-repo'.",
231
+ "hasDynamicHelp": false,
282
232
  "multiple": false,
283
233
  "type": "option"
284
234
  },
285
- "api-version": {
286
- "description": "Override the api version used for api requests made by this command",
287
- "name": "api-version",
235
+ "bitbucket-project-key": {
236
+ "name": "bitbucket-project-key",
237
+ "summary": "Bitbucket project key to associate with the repository. Optional when creating a Bitbucket repository using '--create-repo'.",
288
238
  "hasDynamicHelp": false,
289
239
  "multiple": false,
290
240
  "type": "option"
291
241
  },
292
- "target-stage-id": {
293
- "char": "t",
294
- "name": "target-stage-id",
295
- "required": true,
296
- "summary": "ID of the target pipeline stage to validate promotion to.",
242
+ "stage": {
243
+ "char": "s",
244
+ "name": "stage",
245
+ "summary": "Name of a pipeline stage, in promotion order. Repeat the flag for each stage. Defaults to Integration, UAT, Staging, and Production.",
297
246
  "hasDynamicHelp": false,
298
- "multiple": false,
247
+ "multiple": true,
299
248
  "type": "option"
300
249
  },
301
- "work-item-id": {
302
- "char": "i",
303
- "name": "work-item-id",
304
- "required": true,
305
- "summary": "ID of a work item to validate for promotion. Specify multiple times for multiple work items.",
250
+ "project-id": {
251
+ "name": "project-id",
252
+ "summary": "ID of a project to associate with the pipeline. Repeat the flag to associate multiple projects.",
306
253
  "hasDynamicHelp": false,
307
254
  "multiple": true,
308
255
  "type": "option"
@@ -310,29 +257,28 @@
310
257
  },
311
258
  "hasDynamicHelp": true,
312
259
  "hiddenAliases": [],
313
- "id": "devops:promotion:validate",
260
+ "id": "devops:pipeline:create",
314
261
  "pluginAlias": "@salesforce/plugin-devops-center",
315
262
  "pluginName": "@salesforce/plugin-devops-center",
316
263
  "pluginType": "core",
317
264
  "strict": true,
318
- "summary": "Validate work item promotion for a pipeline stage.",
265
+ "summary": "Create a DevOps Center pipeline.",
319
266
  "enableJsonFlag": true,
320
267
  "isESM": true,
321
268
  "relativePath": [
322
269
  "lib",
323
270
  "commands",
324
271
  "devops",
325
- "promotion",
326
- "validate.js"
272
+ "pipeline",
273
+ "create.js"
327
274
  ]
328
275
  },
329
- "devops:project:create": {
276
+ "devops:pipeline:get": {
330
277
  "aliases": [],
331
278
  "args": {},
332
- "description": "Creates a new DevOps Center project with the specified name and optional description.",
279
+ "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.",
333
280
  "examples": [
334
- "Create a new DevOps Center project in the specified org.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"MyApp Release\"",
335
- "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\""
281
+ "Get details for a specific pipeline:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Do000000000001"
336
282
  ],
337
283
  "flags": {
338
284
  "json": {
@@ -367,19 +313,11 @@
367
313
  "multiple": false,
368
314
  "type": "option"
369
315
  },
370
- "name": {
371
- "char": "n",
372
- "name": "name",
316
+ "pipeline-id": {
317
+ "char": "i",
318
+ "name": "pipeline-id",
373
319
  "required": true,
374
- "summary": "Name of the new DevOps Center project.",
375
- "hasDynamicHelp": false,
376
- "multiple": false,
377
- "type": "option"
378
- },
379
- "description": {
380
- "char": "d",
381
- "name": "description",
382
- "summary": "Description of the new project; if not specified, the description is blank.",
320
+ "summary": "ID of the DevOps Center pipeline.",
383
321
  "hasDynamicHelp": false,
384
322
  "multiple": false,
385
323
  "type": "option"
@@ -387,29 +325,28 @@
387
325
  },
388
326
  "hasDynamicHelp": true,
389
327
  "hiddenAliases": [],
390
- "id": "devops:project:create",
328
+ "id": "devops:pipeline:get",
391
329
  "pluginAlias": "@salesforce/plugin-devops-center",
392
330
  "pluginName": "@salesforce/plugin-devops-center",
393
331
  "pluginType": "core",
394
332
  "strict": true,
395
- "summary": "Create a DevOps Center project in a DevOps Center org.",
333
+ "summary": "Get details of a DevOps Center pipeline including its stages, repositories, and connected projects.",
396
334
  "enableJsonFlag": true,
397
335
  "isESM": true,
398
336
  "relativePath": [
399
337
  "lib",
400
338
  "commands",
401
339
  "devops",
402
- "project",
403
- "create.js"
340
+ "pipeline",
341
+ "get.js"
404
342
  ]
405
343
  },
406
- "devops:project:list": {
344
+ "devops:pipeline:list": {
407
345
  "aliases": [],
408
346
  "args": {},
409
- "description": "This command queries the DevopsProject standard object and returns the project Id, Name, and Description for each project found.",
347
+ "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.",
410
348
  "examples": [
411
- "List all DevOps Center projects in an org with alias \"my-devops-org\":\n<%= config.bin %> <%= command.id %> --target-org my-devops-org",
412
- "List projects using an org's username:\n<%= config.bin %> <%= command.id %> --target-org devops-center@example.com"
349
+ "List all pipelines in the org:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org"
413
350
  ],
414
351
  "flags": {
415
352
  "json": {
@@ -447,31 +384,29 @@
447
384
  },
448
385
  "hasDynamicHelp": true,
449
386
  "hiddenAliases": [],
450
- "id": "devops:project:list",
387
+ "id": "devops:pipeline:list",
451
388
  "pluginAlias": "@salesforce/plugin-devops-center",
452
389
  "pluginName": "@salesforce/plugin-devops-center",
453
390
  "pluginType": "core",
454
391
  "strict": true,
455
- "summary": "List all DevOps Center projects in a Salesforce org.",
392
+ "summary": "List DevOps Center pipelines with their stages, repositories, and connected projects.",
456
393
  "enableJsonFlag": true,
457
394
  "isESM": true,
458
395
  "relativePath": [
459
396
  "lib",
460
397
  "commands",
461
398
  "devops",
462
- "project",
399
+ "pipeline",
463
400
  "list.js"
464
401
  ]
465
402
  },
466
- "devops:project:update": {
403
+ "devops:pipeline:update": {
467
404
  "aliases": [],
468
405
  "args": {},
469
- "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.",
406
+ "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.",
470
407
  "examples": [
471
- "Rename a project:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --name \"MyApp Release v2\"",
472
- "Update the description of a project:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --description \"Updated release description\"",
473
- "Deactivate a project:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --no-is-active",
474
- "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"
408
+ "Activate a pipeline:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --activate",
409
+ "Deactivate and rename in one step.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --deactivate --name \"My Pipeline\""
475
410
  ],
476
411
  "flags": {
477
412
  "json": {
@@ -506,67 +441,69 @@
506
441
  "multiple": false,
507
442
  "type": "option"
508
443
  },
509
- "project-id": {
510
- "char": "i",
511
- "name": "project-id",
444
+ "pipeline-id": {
445
+ "name": "pipeline-id",
512
446
  "required": true,
513
- "summary": "ID of the DevOps Center project to update.",
447
+ "summary": "ID of the pipeline.",
514
448
  "hasDynamicHelp": false,
515
449
  "multiple": false,
516
450
  "type": "option"
517
451
  },
452
+ "activate": {
453
+ "exclusive": [
454
+ "deactivate"
455
+ ],
456
+ "name": "activate",
457
+ "required": false,
458
+ "summary": "Activate the pipeline. Can't be used with --deactivate.",
459
+ "allowNo": false,
460
+ "type": "boolean"
461
+ },
462
+ "deactivate": {
463
+ "exclusive": [
464
+ "activate"
465
+ ],
466
+ "name": "deactivate",
467
+ "required": false,
468
+ "summary": "Deactivate the pipeline. Can't be used with --activate.",
469
+ "allowNo": false,
470
+ "type": "boolean"
471
+ },
518
472
  "name": {
519
473
  "char": "n",
520
474
  "name": "name",
521
- "summary": "New name for the project.",
522
- "hasDynamicHelp": false,
523
- "multiple": false,
524
- "type": "option"
525
- },
526
- "description": {
527
- "char": "d",
528
- "name": "description",
529
- "summary": "New description for the project.",
475
+ "required": false,
476
+ "summary": "New name for the pipeline.",
530
477
  "hasDynamicHelp": false,
531
478
  "multiple": false,
532
479
  "type": "option"
533
- },
534
- "is-active": {
535
- "name": "is-active",
536
- "summary": "Set the project active status. Use --is-active to activate or --no-is-active to deactivate.",
537
- "allowNo": true,
538
- "type": "boolean"
539
480
  }
540
481
  },
541
482
  "hasDynamicHelp": true,
542
483
  "hiddenAliases": [],
543
- "id": "devops:project:update",
484
+ "id": "devops:pipeline:update",
544
485
  "pluginAlias": "@salesforce/plugin-devops-center",
545
486
  "pluginName": "@salesforce/plugin-devops-center",
546
487
  "pluginType": "core",
547
488
  "strict": true,
548
- "summary": "Update a DevOps Center project.",
489
+ "summary": "Update a DevOps Center pipeline.",
549
490
  "enableJsonFlag": true,
550
491
  "isESM": true,
551
492
  "relativePath": [
552
493
  "lib",
553
494
  "commands",
554
495
  "devops",
555
- "project",
496
+ "pipeline",
556
497
  "update.js"
557
498
  ]
558
499
  },
559
- "devops:pipeline:create": {
500
+ "devops:project:create": {
560
501
  "aliases": [],
561
502
  "args": {},
562
- "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.",
503
+ "description": "Creates a new DevOps Center project with the specified name and optional description.",
563
504
  "examples": [
564
- "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",
565
- "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",
566
- "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",
567
- "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",
568
- "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",
569
- "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"
505
+ "Create a new DevOps Center project in the specified org.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"MyApp Release\"",
506
+ "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\""
570
507
  ],
571
508
  "flags": {
572
509
  "json": {
@@ -605,98 +542,45 @@
605
542
  "char": "n",
606
543
  "name": "name",
607
544
  "required": true,
608
- "summary": "Name of the pipeline.",
609
- "hasDynamicHelp": false,
610
- "multiple": false,
611
- "type": "option"
612
- },
613
- "repo": {
614
- "char": "r",
615
- "name": "repo",
616
- "required": true,
617
- "summary": "URL of an existing repository or the name of a repository to create.",
618
- "hasDynamicHelp": false,
619
- "multiple": false,
620
- "type": "option"
621
- },
622
- "repo-type": {
623
- "name": "repo-type",
624
- "summary": "Type of the source code repository. Required when creating a repository using '--create-repo'.",
625
- "hasDynamicHelp": false,
626
- "multiple": false,
627
- "options": [
628
- "github",
629
- "bitbucket"
630
- ],
631
- "type": "option"
632
- },
633
- "create-repo": {
634
- "name": "create-repo",
635
- "summary": "Create a repository if it doesn't exist.",
636
- "allowNo": false,
637
- "type": "boolean"
638
- },
639
- "repo-owner": {
640
- "name": "repo-owner",
641
- "summary": "Owner (organization or user) of the GitHub repository. Required when creating a GitHub repository using '--create-repo'.",
642
- "hasDynamicHelp": false,
643
- "multiple": false,
644
- "type": "option"
645
- },
646
- "bitbucket-workspace": {
647
- "name": "bitbucket-workspace",
648
- "summary": "Bitbucket workspace that will own the repository. Required when creating a Bitbucket repository using '--create-repo'.",
545
+ "summary": "Name of the new DevOps Center project.",
649
546
  "hasDynamicHelp": false,
650
547
  "multiple": false,
651
548
  "type": "option"
652
549
  },
653
- "bitbucket-project-key": {
654
- "name": "bitbucket-project-key",
655
- "summary": "Bitbucket project key to associate with the repository. Optional when creating a Bitbucket repository using '--create-repo'.",
550
+ "description": {
551
+ "char": "d",
552
+ "name": "description",
553
+ "summary": "Description of the new project; if not specified, the description is blank.",
656
554
  "hasDynamicHelp": false,
657
555
  "multiple": false,
658
556
  "type": "option"
659
- },
660
- "stage": {
661
- "char": "s",
662
- "name": "stage",
663
- "summary": "Name of a pipeline stage, in promotion order. Repeat the flag for each stage. Defaults to Integration, UAT, Staging, and Production.",
664
- "hasDynamicHelp": false,
665
- "multiple": true,
666
- "type": "option"
667
- },
668
- "project-id": {
669
- "name": "project-id",
670
- "summary": "ID of a project to associate with the pipeline. Repeat the flag to associate multiple projects.",
671
- "hasDynamicHelp": false,
672
- "multiple": true,
673
- "type": "option"
674
557
  }
675
558
  },
676
559
  "hasDynamicHelp": true,
677
560
  "hiddenAliases": [],
678
- "id": "devops:pipeline:create",
561
+ "id": "devops:project:create",
679
562
  "pluginAlias": "@salesforce/plugin-devops-center",
680
563
  "pluginName": "@salesforce/plugin-devops-center",
681
564
  "pluginType": "core",
682
565
  "strict": true,
683
- "summary": "Create a DevOps Center pipeline.",
566
+ "summary": "Create a DevOps Center project in a DevOps Center org.",
684
567
  "enableJsonFlag": true,
685
568
  "isESM": true,
686
569
  "relativePath": [
687
570
  "lib",
688
571
  "commands",
689
572
  "devops",
690
- "pipeline",
573
+ "project",
691
574
  "create.js"
692
575
  ]
693
576
  },
694
- "devops:pipeline:get": {
577
+ "devops:project:list": {
695
578
  "aliases": [],
696
579
  "args": {},
697
- "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.",
580
+ "description": "This command queries the DevopsProject standard object and returns the project Id, Name, and Description for each project found.",
698
581
  "examples": [
699
- "Get details for a specific pipeline:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Do000000000001"
582
+ "List all DevOps Center projects in an org with alias \"my-devops-org\":\n<%= config.bin %> <%= command.id %> --target-org my-devops-org",
583
+ "List projects using an org's username:\n<%= config.bin %> <%= command.id %> --target-org devops-center@example.com"
700
584
  ],
701
585
  "flags": {
702
586
  "json": {
@@ -730,41 +614,35 @@
730
614
  "hasDynamicHelp": false,
731
615
  "multiple": false,
732
616
  "type": "option"
733
- },
734
- "pipeline-id": {
735
- "char": "i",
736
- "name": "pipeline-id",
737
- "required": true,
738
- "summary": "ID of the DevOps Center pipeline.",
739
- "hasDynamicHelp": false,
740
- "multiple": false,
741
- "type": "option"
742
617
  }
743
618
  },
744
619
  "hasDynamicHelp": true,
745
620
  "hiddenAliases": [],
746
- "id": "devops:pipeline:get",
621
+ "id": "devops:project:list",
747
622
  "pluginAlias": "@salesforce/plugin-devops-center",
748
623
  "pluginName": "@salesforce/plugin-devops-center",
749
624
  "pluginType": "core",
750
625
  "strict": true,
751
- "summary": "Get details of a DevOps Center pipeline including its stages, repositories, and connected projects.",
626
+ "summary": "List all DevOps Center projects in a Salesforce org.",
752
627
  "enableJsonFlag": true,
753
628
  "isESM": true,
754
629
  "relativePath": [
755
630
  "lib",
756
631
  "commands",
757
632
  "devops",
758
- "pipeline",
759
- "get.js"
633
+ "project",
634
+ "list.js"
760
635
  ]
761
636
  },
762
- "devops:pipeline:list": {
637
+ "devops:project:update": {
763
638
  "aliases": [],
764
639
  "args": {},
765
- "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.",
640
+ "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.",
766
641
  "examples": [
767
- "List all pipelines in the org:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org"
642
+ "Rename a project:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --name \"MyApp Release v2\"",
643
+ "Update the description of a project:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --description \"Updated release description\"",
644
+ "Deactivate a project:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --no-is-active",
645
+ "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"
768
646
  ],
769
647
  "flags": {
770
648
  "json": {
@@ -798,33 +676,65 @@
798
676
  "hasDynamicHelp": false,
799
677
  "multiple": false,
800
678
  "type": "option"
679
+ },
680
+ "project-id": {
681
+ "char": "i",
682
+ "name": "project-id",
683
+ "required": true,
684
+ "summary": "ID of the DevOps Center project to update.",
685
+ "hasDynamicHelp": false,
686
+ "multiple": false,
687
+ "type": "option"
688
+ },
689
+ "name": {
690
+ "char": "n",
691
+ "name": "name",
692
+ "summary": "New name for the project.",
693
+ "hasDynamicHelp": false,
694
+ "multiple": false,
695
+ "type": "option"
696
+ },
697
+ "description": {
698
+ "char": "d",
699
+ "name": "description",
700
+ "summary": "New description for the project.",
701
+ "hasDynamicHelp": false,
702
+ "multiple": false,
703
+ "type": "option"
704
+ },
705
+ "is-active": {
706
+ "name": "is-active",
707
+ "summary": "Set the project active status. Use --is-active to activate or --no-is-active to deactivate.",
708
+ "allowNo": true,
709
+ "type": "boolean"
801
710
  }
802
711
  },
803
712
  "hasDynamicHelp": true,
804
713
  "hiddenAliases": [],
805
- "id": "devops:pipeline:list",
714
+ "id": "devops:project:update",
806
715
  "pluginAlias": "@salesforce/plugin-devops-center",
807
716
  "pluginName": "@salesforce/plugin-devops-center",
808
717
  "pluginType": "core",
809
718
  "strict": true,
810
- "summary": "List DevOps Center pipelines with their stages, repositories, and connected projects.",
719
+ "summary": "Update a DevOps Center project.",
811
720
  "enableJsonFlag": true,
812
721
  "isESM": true,
813
722
  "relativePath": [
814
723
  "lib",
815
724
  "commands",
816
725
  "devops",
817
- "pipeline",
818
- "list.js"
726
+ "project",
727
+ "update.js"
819
728
  ]
820
729
  },
821
- "devops:pipeline:update": {
730
+ "devops:promotion:complete": {
822
731
  "aliases": [],
823
732
  "args": {},
824
- "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.",
733
+ "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.",
825
734
  "examples": [
826
- "Activate a pipeline:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --activate",
827
- "Deactivate and rename in one step.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --deactivate --name \"My Pipeline\""
735
+ "Complete a promotion for an out-of-sync pipeline stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001",
736
+ "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",
737
+ "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"
828
738
  ],
829
739
  "flags": {
830
740
  "json": {
@@ -859,68 +769,81 @@
859
769
  "multiple": false,
860
770
  "type": "option"
861
771
  },
862
- "pipeline-id": {
863
- "name": "pipeline-id",
772
+ "target-stage-id": {
773
+ "char": "t",
774
+ "name": "target-stage-id",
864
775
  "required": true,
865
- "summary": "ID of the pipeline.",
776
+ "summary": "ID of the out-of-sync pipeline stage to deploy to.",
866
777
  "hasDynamicHelp": false,
867
778
  "multiple": false,
868
779
  "type": "option"
869
780
  },
870
- "activate": {
871
- "exclusive": [
872
- "deactivate"
873
- ],
874
- "name": "activate",
781
+ "work-item-id": {
782
+ "char": "i",
783
+ "name": "work-item-id",
875
784
  "required": false,
876
- "summary": "Activate the pipeline. Can't be used with --deactivate.",
877
- "allowNo": false,
878
- "type": "boolean"
785
+ "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.",
786
+ "hasDynamicHelp": false,
787
+ "multiple": true,
788
+ "type": "option"
879
789
  },
880
- "deactivate": {
881
- "exclusive": [
882
- "activate"
883
- ],
884
- "name": "deactivate",
885
- "required": false,
886
- "summary": "Deactivate the pipeline. Can't be used with --activate.",
790
+ "deploy-all": {
791
+ "char": "a",
792
+ "description": "If you don’t specify this flag, only changes in the stage’s branch are deployed.",
793
+ "name": "deploy-all",
794
+ "summary": "Deploy all metadata in the branch to the stage's org.",
887
795
  "allowNo": false,
888
796
  "type": "boolean"
889
797
  },
890
- "name": {
891
- "char": "n",
892
- "name": "name",
893
- "required": false,
894
- "summary": "New name for the pipeline.",
798
+ "test-level": {
799
+ "char": "l",
800
+ "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)",
801
+ "name": "test-level",
802
+ "summary": "Deployment Apex testing level.",
895
803
  "hasDynamicHelp": false,
896
804
  "multiple": false,
805
+ "options": [
806
+ "NoTestRun",
807
+ "RunSpecifiedTests",
808
+ "RunLocalTests",
809
+ "RunAllTestsInOrg"
810
+ ],
811
+ "type": "option"
812
+ },
813
+ "tests": {
814
+ "description": "Separate multiple test names with commas. Enclose the entire flag value in double quotes if a test name contains spaces.",
815
+ "name": "tests",
816
+ "summary": "Apex tests to run when --test-level is RunSpecifiedTests.",
817
+ "hasDynamicHelp": false,
818
+ "multiple": true,
897
819
  "type": "option"
898
820
  }
899
821
  },
900
822
  "hasDynamicHelp": true,
901
823
  "hiddenAliases": [],
902
- "id": "devops:pipeline:update",
824
+ "id": "devops:promotion:complete",
903
825
  "pluginAlias": "@salesforce/plugin-devops-center",
904
826
  "pluginName": "@salesforce/plugin-devops-center",
905
827
  "pluginType": "core",
906
828
  "strict": true,
907
- "summary": "Update a DevOps Center pipeline.",
829
+ "summary": "Deploy undeployed work items to a pipeline stage org.",
908
830
  "enableJsonFlag": true,
909
831
  "isESM": true,
910
832
  "relativePath": [
911
833
  "lib",
912
834
  "commands",
913
835
  "devops",
914
- "pipeline",
915
- "update.js"
836
+ "promotion",
837
+ "complete.js"
916
838
  ]
917
839
  },
918
- "devops:request:status": {
840
+ "devops:promotion:validate": {
919
841
  "aliases": [],
920
842
  "args": {},
921
- "description": "Returns the current status of a request identified by its request token.",
843
+ "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.",
922
844
  "examples": [
923
- "Get the status of a request:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --request-token a0B000000000001"
845
+ "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",
846
+ "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"
924
847
  ],
925
848
  "flags": {
926
849
  "json": {
@@ -955,41 +878,49 @@
955
878
  "multiple": false,
956
879
  "type": "option"
957
880
  },
958
- "request-token": {
959
- "char": "i",
960
- "name": "request-token",
881
+ "target-stage-id": {
882
+ "char": "t",
883
+ "name": "target-stage-id",
961
884
  "required": true,
962
- "summary": "Request token from the promote response.",
885
+ "summary": "ID of the target pipeline stage to validate promotion to.",
963
886
  "hasDynamicHelp": false,
964
887
  "multiple": false,
965
888
  "type": "option"
889
+ },
890
+ "work-item-id": {
891
+ "char": "i",
892
+ "name": "work-item-id",
893
+ "required": true,
894
+ "summary": "ID of a work item to validate for promotion. Specify multiple times for multiple work items.",
895
+ "hasDynamicHelp": false,
896
+ "multiple": true,
897
+ "type": "option"
966
898
  }
967
899
  },
968
900
  "hasDynamicHelp": true,
969
901
  "hiddenAliases": [],
970
- "id": "devops:request:status",
902
+ "id": "devops:promotion:validate",
971
903
  "pluginAlias": "@salesforce/plugin-devops-center",
972
904
  "pluginName": "@salesforce/plugin-devops-center",
973
905
  "pluginType": "core",
974
906
  "strict": true,
975
- "summary": "Get the status of a request.",
907
+ "summary": "Validate work item promotion for a pipeline stage.",
976
908
  "enableJsonFlag": true,
977
909
  "isESM": true,
978
910
  "relativePath": [
979
911
  "lib",
980
912
  "commands",
981
913
  "devops",
982
- "request",
983
- "status.js"
914
+ "promotion",
915
+ "validate.js"
984
916
  ]
985
917
  },
986
- "devops:review:create": {
918
+ "devops:request:status": {
987
919
  "aliases": [],
988
920
  "args": {},
989
- "description": "Creates a pull request via the Salesforce DevOps Center API, using the VCS credentials stored in the org. Works with GitHub and Bitbucket without requiring local VCS authentication.",
921
+ "description": "Returns the current status of a request identified by its request token.",
990
922
  "examples": [
991
- "Create a pull request for a work item.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-name WI-000001",
992
- "Create a pull request using the work item ID.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-id 0Wx000000000001"
923
+ "Get the status of a request:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --request-token a0B000000000001"
993
924
  ],
994
925
  "flags": {
995
926
  "json": {
@@ -1024,18 +955,11 @@
1024
955
  "multiple": false,
1025
956
  "type": "option"
1026
957
  },
1027
- "work-item-name": {
1028
- "char": "n",
1029
- "name": "work-item-name",
1030
- "summary": "Name of the work item, such as WI-000001.",
1031
- "hasDynamicHelp": false,
1032
- "multiple": false,
1033
- "type": "option"
1034
- },
1035
- "work-item-id": {
1036
- "char": "w",
1037
- "name": "work-item-id",
1038
- "summary": "ID of the work item.",
958
+ "request-token": {
959
+ "char": "i",
960
+ "name": "request-token",
961
+ "required": true,
962
+ "summary": "Request token from the promote response.",
1039
963
  "hasDynamicHelp": false,
1040
964
  "multiple": false,
1041
965
  "type": "option"
@@ -1043,20 +967,20 @@
1043
967
  },
1044
968
  "hasDynamicHelp": true,
1045
969
  "hiddenAliases": [],
1046
- "id": "devops:review:create",
970
+ "id": "devops:request:status",
1047
971
  "pluginAlias": "@salesforce/plugin-devops-center",
1048
972
  "pluginName": "@salesforce/plugin-devops-center",
1049
973
  "pluginType": "core",
1050
974
  "strict": true,
1051
- "summary": "Create a pull request for a work item branch.",
975
+ "summary": "Get the status of a request.",
1052
976
  "enableJsonFlag": true,
1053
977
  "isESM": true,
1054
978
  "relativePath": [
1055
979
  "lib",
1056
980
  "commands",
1057
981
  "devops",
1058
- "review",
1059
- "create.js"
982
+ "request",
983
+ "status.js"
1060
984
  ]
1061
985
  },
1062
986
  "devops:work-item:combine": {
@@ -1480,6 +1404,82 @@
1480
1404
  "update.js"
1481
1405
  ]
1482
1406
  },
1407
+ "devops:review:create": {
1408
+ "aliases": [],
1409
+ "args": {},
1410
+ "description": "Creates a pull request via the Salesforce DevOps Center API, using the VCS credentials stored in the org. Works with GitHub and Bitbucket without requiring local VCS authentication.",
1411
+ "examples": [
1412
+ "Create a pull request for a work item.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-name WI-000001",
1413
+ "Create a pull request using the work item ID.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-id 0Wx000000000001"
1414
+ ],
1415
+ "flags": {
1416
+ "json": {
1417
+ "description": "Format output as json.",
1418
+ "helpGroup": "GLOBAL",
1419
+ "name": "json",
1420
+ "allowNo": false,
1421
+ "type": "boolean"
1422
+ },
1423
+ "flags-dir": {
1424
+ "helpGroup": "GLOBAL",
1425
+ "name": "flags-dir",
1426
+ "summary": "Import flag values from a directory.",
1427
+ "hasDynamicHelp": false,
1428
+ "multiple": false,
1429
+ "type": "option"
1430
+ },
1431
+ "target-org": {
1432
+ "char": "o",
1433
+ "name": "target-org",
1434
+ "noCacheDefault": true,
1435
+ "required": true,
1436
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
1437
+ "hasDynamicHelp": true,
1438
+ "multiple": false,
1439
+ "type": "option"
1440
+ },
1441
+ "api-version": {
1442
+ "description": "Override the api version used for api requests made by this command",
1443
+ "name": "api-version",
1444
+ "hasDynamicHelp": false,
1445
+ "multiple": false,
1446
+ "type": "option"
1447
+ },
1448
+ "work-item-name": {
1449
+ "char": "n",
1450
+ "name": "work-item-name",
1451
+ "summary": "Name of the work item, such as WI-000001.",
1452
+ "hasDynamicHelp": false,
1453
+ "multiple": false,
1454
+ "type": "option"
1455
+ },
1456
+ "work-item-id": {
1457
+ "char": "w",
1458
+ "name": "work-item-id",
1459
+ "summary": "ID of the work item.",
1460
+ "hasDynamicHelp": false,
1461
+ "multiple": false,
1462
+ "type": "option"
1463
+ }
1464
+ },
1465
+ "hasDynamicHelp": true,
1466
+ "hiddenAliases": [],
1467
+ "id": "devops:review:create",
1468
+ "pluginAlias": "@salesforce/plugin-devops-center",
1469
+ "pluginName": "@salesforce/plugin-devops-center",
1470
+ "pluginType": "core",
1471
+ "strict": true,
1472
+ "summary": "Create a pull request for a work item branch.",
1473
+ "enableJsonFlag": true,
1474
+ "isESM": true,
1475
+ "relativePath": [
1476
+ "lib",
1477
+ "commands",
1478
+ "devops",
1479
+ "review",
1480
+ "create.js"
1481
+ ]
1482
+ },
1483
1483
  "devops:pipeline:project:add": {
1484
1484
  "aliases": [],
1485
1485
  "args": {},
@@ -2809,5 +2809,5 @@
2809
2809
  ]
2810
2810
  }
2811
2811
  },
2812
- "version": "2.3.2"
2812
+ "version": "2.3.3"
2813
2813
  }
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@salesforce/plugin-devops-center",
3
3
  "description": "The DevOps Center CLI plugin provides a command-line alternative to performing equivalent actions in the DevOps Center graphical UI",
4
- "version": "2.3.2",
4
+ "version": "2.3.3",
5
5
  "type": "module",
6
6
  "author": "Salesforce",
7
7
  "bugs": "https://github.com/forcedotcom/cli/issues",
@@ -16,7 +16,7 @@
16
16
  "devDependencies": {
17
17
  "@oclif/plugin-command-snapshot": "^5.2.3",
18
18
  "@oclif/test": "^3",
19
- "@salesforce/cli-plugins-testkit": "^5.3.20",
19
+ "@salesforce/cli-plugins-testkit": "^5.3.75",
20
20
  "@salesforce/dev-scripts": "^15.0.0",
21
21
  "@salesforce/plugin-command-reference": "^3.1.141",
22
22
  "@salesforce/ts-sinon": "^1.4.39",
@@ -263,7 +263,7 @@
263
263
  }
264
264
  },
265
265
  "sfdx": {
266
- "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-devops-center/2.3.2.crt",
267
- "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-devops-center/2.3.2.sig"
266
+ "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-devops-center/2.3.3.crt",
267
+ "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-devops-center/2.3.3.sig"
268
268
  }
269
269
  }