@salesforce/plugin-devops-center 2.3.2 → 2.3.4

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 +759 -759
  3. package/package.json +4 -4
@@ -138,194 +138,6 @@
138
138
  "promote.js"
139
139
  ]
140
140
  },
141
- "devops:promotion:complete": {
142
- "aliases": [],
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.",
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"
149
- ],
150
- "flags": {
151
- "json": {
152
- "description": "Format output as json.",
153
- "helpGroup": "GLOBAL",
154
- "name": "json",
155
- "allowNo": false,
156
- "type": "boolean"
157
- },
158
- "flags-dir": {
159
- "helpGroup": "GLOBAL",
160
- "name": "flags-dir",
161
- "summary": "Import flag values from a directory.",
162
- "hasDynamicHelp": false,
163
- "multiple": false,
164
- "type": "option"
165
- },
166
- "target-org": {
167
- "char": "o",
168
- "name": "target-org",
169
- "noCacheDefault": true,
170
- "required": true,
171
- "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
172
- "hasDynamicHelp": true,
173
- "multiple": false,
174
- "type": "option"
175
- },
176
- "api-version": {
177
- "description": "Override the api version used for api requests made by this command",
178
- "name": "api-version",
179
- "hasDynamicHelp": false,
180
- "multiple": false,
181
- "type": "option"
182
- },
183
- "target-stage-id": {
184
- "char": "t",
185
- "name": "target-stage-id",
186
- "required": true,
187
- "summary": "ID of the out-of-sync pipeline stage to deploy to.",
188
- "hasDynamicHelp": false,
189
- "multiple": false,
190
- "type": "option"
191
- },
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.",
197
- "hasDynamicHelp": false,
198
- "multiple": true,
199
- "type": "option"
200
- },
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.",
214
- "hasDynamicHelp": false,
215
- "multiple": false,
216
- "options": [
217
- "NoTestRun",
218
- "RunSpecifiedTests",
219
- "RunLocalTests",
220
- "RunAllTestsInOrg"
221
- ],
222
- "type": "option"
223
- },
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",
264
- "allowNo": false,
265
- "type": "boolean"
266
- },
267
- "flags-dir": {
268
- "helpGroup": "GLOBAL",
269
- "name": "flags-dir",
270
- "summary": "Import flag values from a directory.",
271
- "hasDynamicHelp": false,
272
- "multiple": false,
273
- "type": "option"
274
- },
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,
282
- "multiple": false,
283
- "type": "option"
284
- },
285
- "api-version": {
286
- "description": "Override the api version used for api requests made by this command",
287
- "name": "api-version",
288
- "hasDynamicHelp": false,
289
- "multiple": false,
290
- "type": "option"
291
- },
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.",
297
- "hasDynamicHelp": false,
298
- "multiple": false,
299
- "type": "option"
300
- },
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.",
306
- "hasDynamicHelp": false,
307
- "multiple": true,
308
- "type": "option"
309
- }
310
- },
311
- "hasDynamicHelp": true,
312
- "hiddenAliases": [],
313
- "id": "devops:promotion:validate",
314
- "pluginAlias": "@salesforce/plugin-devops-center",
315
- "pluginName": "@salesforce/plugin-devops-center",
316
- "pluginType": "core",
317
- "strict": true,
318
- "summary": "Validate work item promotion for a pipeline stage.",
319
- "enableJsonFlag": true,
320
- "isESM": true,
321
- "relativePath": [
322
- "lib",
323
- "commands",
324
- "devops",
325
- "promotion",
326
- "validate.js"
327
- ]
328
- },
329
141
  "devops:project:create": {
330
142
  "aliases": [],
331
143
  "args": {},
@@ -915,12 +727,14 @@
915
727
  "update.js"
916
728
  ]
917
729
  },
918
- "devops:request:status": {
730
+ "devops:promotion:complete": {
919
731
  "aliases": [],
920
732
  "args": {},
921
- "description": "Returns the current status of a request identified by its request token.",
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.",
922
734
  "examples": [
923
- "Get the status of a request:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --request-token a0B000000000001"
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"
924
738
  ],
925
739
  "flags": {
926
740
  "json": {
@@ -955,38 +769,156 @@
955
769
  "multiple": false,
956
770
  "type": "option"
957
771
  },
958
- "request-token": {
959
- "char": "i",
960
- "name": "request-token",
772
+ "target-stage-id": {
773
+ "char": "t",
774
+ "name": "target-stage-id",
961
775
  "required": true,
962
- "summary": "Request token from the promote response.",
776
+ "summary": "ID of the out-of-sync pipeline stage to deploy to.",
777
+ "hasDynamicHelp": false,
778
+ "multiple": false,
779
+ "type": "option"
780
+ },
781
+ "work-item-id": {
782
+ "char": "i",
783
+ "name": "work-item-id",
784
+ "required": false,
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"
789
+ },
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.",
795
+ "allowNo": false,
796
+ "type": "boolean"
797
+ },
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.",
963
803
  "hasDynamicHelp": false,
964
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,
965
819
  "type": "option"
966
820
  }
967
821
  },
968
822
  "hasDynamicHelp": true,
969
823
  "hiddenAliases": [],
970
- "id": "devops:request:status",
824
+ "id": "devops:promotion:complete",
971
825
  "pluginAlias": "@salesforce/plugin-devops-center",
972
826
  "pluginName": "@salesforce/plugin-devops-center",
973
827
  "pluginType": "core",
974
828
  "strict": true,
975
- "summary": "Get the status of a request.",
829
+ "summary": "Deploy undeployed work items to a pipeline stage org.",
976
830
  "enableJsonFlag": true,
977
831
  "isESM": true,
978
832
  "relativePath": [
979
833
  "lib",
980
834
  "commands",
981
835
  "devops",
982
- "request",
983
- "status.js"
836
+ "promotion",
837
+ "complete.js"
984
838
  ]
985
839
  },
986
- "devops:review:create": {
840
+ "devops:promotion:validate": {
987
841
  "aliases": [],
988
842
  "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.",
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.",
844
+ "examples": [
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"
847
+ ],
848
+ "flags": {
849
+ "json": {
850
+ "description": "Format output as json.",
851
+ "helpGroup": "GLOBAL",
852
+ "name": "json",
853
+ "allowNo": false,
854
+ "type": "boolean"
855
+ },
856
+ "flags-dir": {
857
+ "helpGroup": "GLOBAL",
858
+ "name": "flags-dir",
859
+ "summary": "Import flag values from a directory.",
860
+ "hasDynamicHelp": false,
861
+ "multiple": false,
862
+ "type": "option"
863
+ },
864
+ "target-org": {
865
+ "char": "o",
866
+ "name": "target-org",
867
+ "noCacheDefault": true,
868
+ "required": true,
869
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
870
+ "hasDynamicHelp": true,
871
+ "multiple": false,
872
+ "type": "option"
873
+ },
874
+ "api-version": {
875
+ "description": "Override the api version used for api requests made by this command",
876
+ "name": "api-version",
877
+ "hasDynamicHelp": false,
878
+ "multiple": false,
879
+ "type": "option"
880
+ },
881
+ "target-stage-id": {
882
+ "char": "t",
883
+ "name": "target-stage-id",
884
+ "required": true,
885
+ "summary": "ID of the target pipeline stage to validate promotion to.",
886
+ "hasDynamicHelp": false,
887
+ "multiple": false,
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"
898
+ }
899
+ },
900
+ "hasDynamicHelp": true,
901
+ "hiddenAliases": [],
902
+ "id": "devops:promotion:validate",
903
+ "pluginAlias": "@salesforce/plugin-devops-center",
904
+ "pluginName": "@salesforce/plugin-devops-center",
905
+ "pluginType": "core",
906
+ "strict": true,
907
+ "summary": "Validate work item promotion for a pipeline stage.",
908
+ "enableJsonFlag": true,
909
+ "isESM": true,
910
+ "relativePath": [
911
+ "lib",
912
+ "commands",
913
+ "devops",
914
+ "promotion",
915
+ "validate.js"
916
+ ]
917
+ },
918
+ "devops:review:create": {
919
+ "aliases": [],
920
+ "args": {},
921
+ "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.",
990
922
  "examples": [
991
923
  "Create a pull request for a work item.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-name WI-000001",
992
924
  "Create a pull request using the work item ID.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-id 0Wx000000000001"
@@ -1059,6 +991,74 @@
1059
991
  "create.js"
1060
992
  ]
1061
993
  },
994
+ "devops:request:status": {
995
+ "aliases": [],
996
+ "args": {},
997
+ "description": "Returns the current status of a request identified by its request token.",
998
+ "examples": [
999
+ "Get the status of a request:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --request-token a0B000000000001"
1000
+ ],
1001
+ "flags": {
1002
+ "json": {
1003
+ "description": "Format output as json.",
1004
+ "helpGroup": "GLOBAL",
1005
+ "name": "json",
1006
+ "allowNo": false,
1007
+ "type": "boolean"
1008
+ },
1009
+ "flags-dir": {
1010
+ "helpGroup": "GLOBAL",
1011
+ "name": "flags-dir",
1012
+ "summary": "Import flag values from a directory.",
1013
+ "hasDynamicHelp": false,
1014
+ "multiple": false,
1015
+ "type": "option"
1016
+ },
1017
+ "target-org": {
1018
+ "char": "o",
1019
+ "name": "target-org",
1020
+ "noCacheDefault": true,
1021
+ "required": true,
1022
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
1023
+ "hasDynamicHelp": true,
1024
+ "multiple": false,
1025
+ "type": "option"
1026
+ },
1027
+ "api-version": {
1028
+ "description": "Override the api version used for api requests made by this command",
1029
+ "name": "api-version",
1030
+ "hasDynamicHelp": false,
1031
+ "multiple": false,
1032
+ "type": "option"
1033
+ },
1034
+ "request-token": {
1035
+ "char": "i",
1036
+ "name": "request-token",
1037
+ "required": true,
1038
+ "summary": "Request token from the promote response.",
1039
+ "hasDynamicHelp": false,
1040
+ "multiple": false,
1041
+ "type": "option"
1042
+ }
1043
+ },
1044
+ "hasDynamicHelp": true,
1045
+ "hiddenAliases": [],
1046
+ "id": "devops:request:status",
1047
+ "pluginAlias": "@salesforce/plugin-devops-center",
1048
+ "pluginName": "@salesforce/plugin-devops-center",
1049
+ "pluginType": "core",
1050
+ "strict": true,
1051
+ "summary": "Get the status of a request.",
1052
+ "enableJsonFlag": true,
1053
+ "isESM": true,
1054
+ "relativePath": [
1055
+ "lib",
1056
+ "commands",
1057
+ "devops",
1058
+ "request",
1059
+ "status.js"
1060
+ ]
1061
+ },
1062
1062
  "devops:work-item:combine": {
1063
1063
  "aliases": [],
1064
1064
  "args": {},
@@ -1480,12 +1480,13 @@
1480
1480
  "update.js"
1481
1481
  ]
1482
1482
  },
1483
- "devops:pipeline:project:add": {
1483
+ "project:deploy:pipeline:quick": {
1484
1484
  "aliases": [],
1485
1485
  "args": {},
1486
- "description": "You can attach a project to only one pipeline.",
1486
+ "description": "The first time you run any \"project deploy pipeline\" command, be sure to authorize the org in which DevOps Center is installed. The easiest way to authorize an org is with the \"org login web\" command.\n\nBefore you run this command, create a validated deployment with the \"project deploy pipeline validate\" command, which returns a job ID. Validated deployments haven't been deployed to the org yet; you deploy them with this command. Either pass the job ID to this command or use the --use-most-recent flag to use the job ID of the most recently validated deployment. For the quick deploy to succeed, the associated validated deployment must also have succeeded.\n\nExecuting this quick deploy command takes less time than a standard deploy because it skips running Apex tests. These tests were previously run as part of the validation. Validating first and then running a quick deploy is useful if the deployment to your production org take several hours and you don’t want to risk a failed deploy.\n\nThis command doesn't support source-tracking. The source you deploy overwrites the corresponding metadata in your org. This command doesn’t attempt to merge your source with the versions in your org.",
1487
1487
  "examples": [
1488
- "Attach a project to a pipeline using the project ID and pipeline ID.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --project-id 0Hn000000000001"
1488
+ "Run a quick deploy using your default Devops Center org and a job ID:\n<%= config.bin %> <%= command.id %> --job-id 0Af0x000017yLUFCA2",
1489
+ "Asynchronously run a quick deploy of the most recently validated deployment using an org with alias \"my-prod-org\":\n<%= config.bin %> <%= command.id %> --async --use-most-recent --devops-center-username my-prod-org"
1489
1490
  ],
1490
1491
  "flags": {
1491
1492
  "json": {
@@ -1503,65 +1504,96 @@
1503
1504
  "multiple": false,
1504
1505
  "type": "option"
1505
1506
  },
1506
- "target-org": {
1507
- "char": "o",
1508
- "name": "target-org",
1509
- "noCacheDefault": true,
1510
- "required": true,
1511
- "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
1512
- "hasDynamicHelp": true,
1513
- "multiple": false,
1514
- "type": "option"
1507
+ "async": {
1508
+ "description": "The command immediately returns the job ID and control of the terminal to you. This way, you can continue to use the CLI. To resume the deployment, run \"sf project deploy pipeline resume\". To check the status of the deployment, run \"sf project deploy pipeline report\".",
1509
+ "name": "async",
1510
+ "summary": "Run the command asynchronously.",
1511
+ "allowNo": false,
1512
+ "type": "boolean"
1515
1513
  },
1516
- "api-version": {
1517
- "description": "Override the api version used for api requests made by this command",
1518
- "name": "api-version",
1519
- "hasDynamicHelp": false,
1514
+ "concise": {
1515
+ "exclusive": [
1516
+ "verbose"
1517
+ ],
1518
+ "name": "concise",
1519
+ "summary": "Show concise output of the command result.",
1520
+ "allowNo": false,
1521
+ "type": "boolean"
1522
+ },
1523
+ "verbose": {
1524
+ "name": "verbose",
1525
+ "summary": "Show verbose output of the command result.",
1526
+ "allowNo": false,
1527
+ "type": "boolean"
1528
+ },
1529
+ "wait": {
1530
+ "char": "w",
1531
+ "description": "If the command continues to run after the wait period, the CLI returns control of the terminal window to you and returns the job ID. To check the status of the operation, run \"sf project deploy pipeline report\".",
1532
+ "exclusive": [
1533
+ "async"
1534
+ ],
1535
+ "name": "wait",
1536
+ "summary": "Number of minutes to wait for command to complete and display results.",
1537
+ "default": "33 minutes",
1538
+ "hasDynamicHelp": true,
1539
+ "helpValue": "<minutes>",
1520
1540
  "multiple": false,
1521
1541
  "type": "option"
1522
1542
  },
1523
- "pipeline-id": {
1524
- "name": "pipeline-id",
1543
+ "devops-center-username": {
1544
+ "char": "c",
1545
+ "name": "devops-center-username",
1525
1546
  "required": true,
1526
- "summary": "ID of the pipeline.",
1527
- "hasDynamicHelp": false,
1547
+ "summary": "Username or alias of the DevOps Center org.",
1548
+ "hasDynamicHelp": true,
1528
1549
  "multiple": false,
1529
1550
  "type": "option"
1530
1551
  },
1531
- "project-id": {
1532
- "name": "project-id",
1533
- "required": true,
1534
- "summary": "ID of the DevOps Center project.",
1552
+ "job-id": {
1553
+ "char": "i",
1554
+ "description": "The job ID is valid for 10 days from when you started the validation.",
1555
+ "name": "job-id",
1556
+ "summary": "Job ID of the validated deployment to quick deploy.",
1535
1557
  "hasDynamicHelp": false,
1536
1558
  "multiple": false,
1537
1559
  "type": "option"
1560
+ },
1561
+ "use-most-recent": {
1562
+ "char": "r",
1563
+ "description": "For performance reasons, this flag uses only job IDs that were validated in the past 3 days or less. If your most recent deployment validation was more than 3 days ago, this flag won't find the job ID.",
1564
+ "name": "use-most-recent",
1565
+ "summary": "Use the job ID of the most recently validated deployment.",
1566
+ "allowNo": false,
1567
+ "type": "boolean"
1538
1568
  }
1539
1569
  },
1540
1570
  "hasDynamicHelp": true,
1541
1571
  "hiddenAliases": [],
1542
- "id": "devops:pipeline:project:add",
1572
+ "id": "project:deploy:pipeline:quick",
1543
1573
  "pluginAlias": "@salesforce/plugin-devops-center",
1544
1574
  "pluginName": "@salesforce/plugin-devops-center",
1545
1575
  "pluginType": "core",
1576
+ "state": "beta",
1546
1577
  "strict": true,
1547
- "summary": "Attach a DevOps Center project to a pipeline.",
1578
+ "summary": "Quickly deploy a validated deployment to an org.",
1548
1579
  "enableJsonFlag": true,
1549
1580
  "isESM": true,
1550
1581
  "relativePath": [
1551
1582
  "lib",
1552
1583
  "commands",
1553
- "devops",
1554
- "pipeline",
1555
1584
  "project",
1556
- "add.js"
1585
+ "deploy",
1586
+ "pipeline",
1587
+ "quick.js"
1557
1588
  ]
1558
1589
  },
1559
- "devops:pipeline:project:delete": {
1590
+ "project:deploy:pipeline:report": {
1560
1591
  "aliases": [],
1561
1592
  "args": {},
1562
- "description": "Deletes the junction record that connects the project to the pipeline. The project itself is not deleted.",
1593
+ "description": "The first time you run any \"project deploy pipeline\" command, be sure to authorize the org in which DevOps Center is installed. The easiest way to authorize an org is with the \"org login web\" command.\n\nRun this command by either indicating a job ID or specifying the —use-most-recent flag to use the job ID of the most recent deploy operation.",
1563
1594
  "examples": [
1564
- "Remove a project from a pipeline using the project ID and pipeline ID.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --project-id 0Hn000000000001"
1595
+ "Check the status using a job ID:\n<%= config.bin %> <%= command.id %> --devops-center-username MyStagingSandbox --job-id 0Af0x000017yLUFCA2",
1596
+ "Check the status of the most recent deploy operation:\n<%= config.bin %> <%= command.id %> --devops-center-username MyStagingSandbox --use-most-recent"
1565
1597
  ],
1566
1598
  "flags": {
1567
1599
  "json": {
@@ -1579,66 +1611,60 @@
1579
1611
  "multiple": false,
1580
1612
  "type": "option"
1581
1613
  },
1582
- "target-org": {
1583
- "char": "o",
1584
- "name": "target-org",
1585
- "noCacheDefault": true,
1614
+ "devops-center-username": {
1615
+ "char": "c",
1616
+ "name": "devops-center-username",
1586
1617
  "required": true,
1587
- "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
1618
+ "summary": "Username or alias of the DevOps Center org.",
1588
1619
  "hasDynamicHelp": true,
1589
1620
  "multiple": false,
1590
1621
  "type": "option"
1591
1622
  },
1592
- "api-version": {
1593
- "description": "Override the api version used for api requests made by this command",
1594
- "name": "api-version",
1595
- "hasDynamicHelp": false,
1596
- "multiple": false,
1597
- "type": "option"
1598
- },
1599
- "pipeline-id": {
1600
- "name": "pipeline-id",
1601
- "required": true,
1602
- "summary": "ID of the pipeline.",
1623
+ "job-id": {
1624
+ "char": "i",
1625
+ "description": "The job ID is valid for 10 days from when you started the deploy operation.",
1626
+ "name": "job-id",
1627
+ "summary": "Job ID of the pipeline deployment to check the status of.",
1603
1628
  "hasDynamicHelp": false,
1604
1629
  "multiple": false,
1605
1630
  "type": "option"
1606
1631
  },
1607
- "project-id": {
1608
- "name": "project-id",
1609
- "required": true,
1610
- "summary": "ID of the DevOps Center project.",
1611
- "hasDynamicHelp": false,
1612
- "multiple": false,
1613
- "type": "option"
1632
+ "use-most-recent": {
1633
+ "char": "r",
1634
+ "description": "For performance reasons, this flag uses job IDs for deploy operations that started in the past 3 days or fewer. If your most recent operation was longer than 3 days ago, this flag won't find the job ID.",
1635
+ "name": "use-most-recent",
1636
+ "summary": "Use the job ID of the most recent deploy operation.",
1637
+ "allowNo": false,
1638
+ "type": "boolean"
1614
1639
  }
1615
1640
  },
1616
1641
  "hasDynamicHelp": true,
1617
1642
  "hiddenAliases": [],
1618
- "id": "devops:pipeline:project:delete",
1643
+ "id": "project:deploy:pipeline:report",
1619
1644
  "pluginAlias": "@salesforce/plugin-devops-center",
1620
1645
  "pluginName": "@salesforce/plugin-devops-center",
1621
1646
  "pluginType": "core",
1647
+ "state": "beta",
1622
1648
  "strict": true,
1623
- "summary": "Remove a DevOps Center project's connection to a pipeline.",
1649
+ "summary": "Check the status of a pipeline deploy operation.",
1624
1650
  "enableJsonFlag": true,
1625
1651
  "isESM": true,
1626
1652
  "relativePath": [
1627
1653
  "lib",
1628
1654
  "commands",
1629
- "devops",
1630
- "pipeline",
1631
1655
  "project",
1632
- "delete.js"
1656
+ "deploy",
1657
+ "pipeline",
1658
+ "report.js"
1633
1659
  ]
1634
1660
  },
1635
- "devops:pipeline:stage:add": {
1661
+ "project:deploy:pipeline:resume": {
1636
1662
  "aliases": [],
1637
1663
  "args": {},
1638
- "description": "Inserts an empty stage before the stage specified by `--next-stage-id`. The new stage doesn't include a branch or environment. Configure them separately after you create the stage.",
1664
+ "description": "The first time you run any \"project deploy pipeline\" command, be sure to authorize the org in which DevOps Center is installed. The easiest way to authorize an org is with the \"org login web\" command. \n\nUse this command to resume watching a pipeline deploy operation if the original command times out or you specified the --async flag.\n\nRun this command by either indicating a job ID or specifying the --use-most-recent flag to use the job ID of the most recent deploy operation.",
1639
1665
  "examples": [
1640
- "Add a Development stage before Integration in a specific pipeline.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --name \"Development\" --next-stage-id 0Xc000000000002",
1641
- "Add a QA stage before UAT in a specific pipeline.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --name \"QA\" --next-stage-id 0Xc000000000003"
1666
+ "Resume watching a deploy operation using a job ID:\n<%= config.bin %> <%= command.id %> --job-id 0Af0x000017yLUFCA2",
1667
+ "Resume watching the most recent deploy operation:\n<%= config.bin %> <%= command.id %> --use-most-recent"
1642
1668
  ],
1643
1669
  "flags": {
1644
1670
  "json": {
@@ -1656,74 +1682,89 @@
1656
1682
  "multiple": false,
1657
1683
  "type": "option"
1658
1684
  },
1659
- "target-org": {
1660
- "char": "o",
1661
- "name": "target-org",
1662
- "noCacheDefault": true,
1685
+ "devops-center-username": {
1686
+ "char": "c",
1687
+ "name": "devops-center-username",
1663
1688
  "required": true,
1664
- "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
1689
+ "summary": "Username or alias of the DevOps Center org.",
1665
1690
  "hasDynamicHelp": true,
1666
1691
  "multiple": false,
1667
1692
  "type": "option"
1668
1693
  },
1669
- "api-version": {
1670
- "description": "Override the api version used for api requests made by this command",
1671
- "name": "api-version",
1694
+ "job-id": {
1695
+ "char": "i",
1696
+ "description": "These commands return a job ID if they time out or you specified the --async flag:\n\n- sf project deploy pipeline start\n- sf project deploy pipeline validate\n- sf project deploy pipeline quick\n\nThe job ID is valid for 10 days from when you started the deploy operation.",
1697
+ "name": "job-id",
1698
+ "summary": "Job ID of the pipeline deploy operation you want to resume.",
1672
1699
  "hasDynamicHelp": false,
1673
1700
  "multiple": false,
1674
1701
  "type": "option"
1675
1702
  },
1676
- "pipeline-id": {
1677
- "name": "pipeline-id",
1678
- "required": true,
1679
- "summary": "ID of the pipeline where the stage is added.",
1680
- "hasDynamicHelp": false,
1681
- "multiple": false,
1682
- "type": "option"
1703
+ "use-most-recent": {
1704
+ "char": "r",
1705
+ "description": "For performance reasons, this flag uses job IDs for operations that started in the past 3 days or fewer. If your most recent operation was longer than 3 days ago, this flag won't find a job ID.",
1706
+ "name": "use-most-recent",
1707
+ "summary": "Use the job ID of the most recent deploy operation.",
1708
+ "allowNo": false,
1709
+ "type": "boolean"
1683
1710
  },
1684
- "name": {
1685
- "char": "n",
1686
- "name": "name",
1687
- "required": true,
1688
- "summary": "Name of the pipeline stage, such as Integration, UAT, or Staging.",
1689
- "hasDynamicHelp": false,
1690
- "multiple": false,
1691
- "type": "option"
1711
+ "concise": {
1712
+ "exclusive": [
1713
+ "verbose"
1714
+ ],
1715
+ "name": "concise",
1716
+ "summary": "Show concise output of the command result.",
1717
+ "allowNo": false,
1718
+ "type": "boolean"
1692
1719
  },
1693
- "next-stage-id": {
1694
- "name": "next-stage-id",
1695
- "required": true,
1696
- "summary": "ID of the stage that follows the new stage in the pipeline.",
1697
- "hasDynamicHelp": false,
1720
+ "verbose": {
1721
+ "name": "verbose",
1722
+ "summary": "Show verbose output of the command result.",
1723
+ "allowNo": false,
1724
+ "type": "boolean"
1725
+ },
1726
+ "wait": {
1727
+ "char": "w",
1728
+ "description": "If the command continues to run after the wait period, the CLI returns control of the terminal window to you and returns the job ID. To check the status of the operation, run \"sf project deploy pipeline report\".",
1729
+ "exclusive": [
1730
+ "async"
1731
+ ],
1732
+ "name": "wait",
1733
+ "summary": "Number of minutes to wait for command to complete and display results.",
1734
+ "default": "33 minutes",
1735
+ "hasDynamicHelp": true,
1736
+ "helpValue": "<minutes>",
1698
1737
  "multiple": false,
1699
1738
  "type": "option"
1700
1739
  }
1701
1740
  },
1702
1741
  "hasDynamicHelp": true,
1703
1742
  "hiddenAliases": [],
1704
- "id": "devops:pipeline:stage:add",
1743
+ "id": "project:deploy:pipeline:resume",
1705
1744
  "pluginAlias": "@salesforce/plugin-devops-center",
1706
1745
  "pluginName": "@salesforce/plugin-devops-center",
1707
1746
  "pluginType": "core",
1747
+ "state": "beta",
1708
1748
  "strict": true,
1709
- "summary": "Add a stage to a DevOps Center pipeline.",
1749
+ "summary": "Resume watching a pipeline deploy operation.",
1710
1750
  "enableJsonFlag": true,
1711
1751
  "isESM": true,
1712
1752
  "relativePath": [
1713
1753
  "lib",
1714
1754
  "commands",
1715
- "devops",
1755
+ "project",
1756
+ "deploy",
1716
1757
  "pipeline",
1717
- "stage",
1718
- "add.js"
1758
+ "resume.js"
1719
1759
  ]
1720
1760
  },
1721
- "devops:pipeline:stage:delete": {
1761
+ "project:deploy:pipeline:start": {
1722
1762
  "aliases": [],
1723
1763
  "args": {},
1724
- "description": "Deletes the specified stage from the pipeline. If the stage sits between two other stages, the predecessor stage is automatically re-linked to the successor so the pipeline chain stays intact.",
1764
+ "description": "The first time you run any \"project deploy pipeline\" command, be sure to authorize the org in which DevOps Center is installed. The easiest way to authorize an org is with the \"org login web\" command.\n\nBefore you run this command, changes in the pipeline stage's branch must be merged in the source control repository.",
1725
1765
  "examples": [
1726
- "Delete a stage from a pipeline:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --stage-id 0Xc000000000002"
1766
+ "Deploy changes in the Staging branch to the Staging environment (sandbox), if the previous stage is the bundling stage:\n<%= config.bin %> <%= command.id %> --devops-center-project-name “Recruiting App” --branch-name staging --devops-center-username MyStagingSandbox --bundle-version-name 1.0",
1767
+ "Deploy all changes in the main branch to the release environment:\n<%= config.bin %> <%= command.id %> --devops-center-project-name “Recruiting App” --branch-name main --devops-center-username MyReleaseOrg --deploy-all"
1727
1768
  ],
1728
1769
  "flags": {
1729
1770
  "json": {
@@ -1741,65 +1782,138 @@
1741
1782
  "multiple": false,
1742
1783
  "type": "option"
1743
1784
  },
1744
- "target-org": {
1745
- "char": "o",
1746
- "name": "target-org",
1747
- "noCacheDefault": true,
1785
+ "branch-name": {
1786
+ "char": "b",
1787
+ "name": "branch-name",
1748
1788
  "required": true,
1749
- "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
1750
- "hasDynamicHelp": true,
1789
+ "summary": "Name of the branch in the source control repository that corresponds to the pipeline stage that you want to deploy the changes to.",
1790
+ "hasDynamicHelp": false,
1751
1791
  "multiple": false,
1752
1792
  "type": "option"
1753
1793
  },
1754
- "api-version": {
1755
- "description": "Override the api version used for api requests made by this command",
1756
- "name": "api-version",
1794
+ "bundle-version-name": {
1795
+ "char": "v",
1796
+ "description": "You must indicate the bundle version if deploying to the environment that corresponds to the first stage after the bundling stage.",
1797
+ "name": "bundle-version-name",
1798
+ "summary": "Version name of the bundle.",
1757
1799
  "hasDynamicHelp": false,
1758
1800
  "multiple": false,
1759
1801
  "type": "option"
1760
1802
  },
1761
- "pipeline-id": {
1762
- "name": "pipeline-id",
1803
+ "deploy-all": {
1804
+ "char": "a",
1805
+ "description": "If you don’t specify this flag, only changes in the stage’s branch are deployed.",
1806
+ "name": "deploy-all",
1807
+ "summary": "Deploy all metadata in the branch to the stage's org.",
1808
+ "allowNo": false,
1809
+ "type": "boolean"
1810
+ },
1811
+ "devops-center-project-name": {
1812
+ "char": "p",
1813
+ "name": "devops-center-project-name",
1763
1814
  "required": true,
1764
- "summary": "ID of the pipeline that contains the stage.",
1815
+ "summary": "Name of the DevOps Center project.",
1765
1816
  "hasDynamicHelp": false,
1766
1817
  "multiple": false,
1767
1818
  "type": "option"
1768
1819
  },
1769
- "stage-id": {
1770
- "name": "stage-id",
1820
+ "devops-center-username": {
1821
+ "char": "c",
1822
+ "name": "devops-center-username",
1771
1823
  "required": true,
1772
- "summary": "ID of the stage to delete.",
1824
+ "summary": "Username or alias of the DevOps Center org.",
1825
+ "hasDynamicHelp": true,
1826
+ "multiple": false,
1827
+ "type": "option"
1828
+ },
1829
+ "tests": {
1830
+ "char": "t",
1831
+ "description": "Separate multiple test names with commas. Enclose the entire flag value in double quotes if a test name contains spaces.",
1832
+ "name": "tests",
1833
+ "summary": "Apex tests to run when --test-level is RunSpecifiedTests.",
1834
+ "hasDynamicHelp": false,
1835
+ "multiple": true,
1836
+ "type": "option"
1837
+ },
1838
+ "test-level": {
1839
+ "char": "l",
1840
+ "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)",
1841
+ "name": "test-level",
1842
+ "summary": "Deployment Apex testing level.",
1773
1843
  "hasDynamicHelp": false,
1774
1844
  "multiple": false,
1845
+ "options": [
1846
+ "NoTestRun",
1847
+ "RunSpecifiedTests",
1848
+ "RunLocalTests",
1849
+ "RunAllTestsInOrg"
1850
+ ],
1851
+ "type": "option"
1852
+ },
1853
+ "async": {
1854
+ "description": "The command immediately returns the job ID and control of the terminal to you. This way, you can continue to use the CLI. To resume the deployment, run \"sf project deploy pipeline resume\". To check the status of the deployment, run \"sf project deploy pipeline report\".",
1855
+ "name": "async",
1856
+ "summary": "Run the command asynchronously.",
1857
+ "allowNo": false,
1858
+ "type": "boolean"
1859
+ },
1860
+ "wait": {
1861
+ "char": "w",
1862
+ "description": "If the command continues to run after the wait period, the CLI returns control of the terminal window to you and returns the job ID. To check the status of the operation, run \"sf project deploy pipeline report\".",
1863
+ "exclusive": [
1864
+ "async"
1865
+ ],
1866
+ "name": "wait",
1867
+ "summary": "Number of minutes to wait for command to complete and display results.",
1868
+ "default": "33 minutes",
1869
+ "hasDynamicHelp": true,
1870
+ "helpValue": "<minutes>",
1871
+ "multiple": false,
1775
1872
  "type": "option"
1873
+ },
1874
+ "verbose": {
1875
+ "name": "verbose",
1876
+ "summary": "Show verbose output of the command result.",
1877
+ "allowNo": false,
1878
+ "type": "boolean"
1879
+ },
1880
+ "concise": {
1881
+ "exclusive": [
1882
+ "verbose"
1883
+ ],
1884
+ "name": "concise",
1885
+ "summary": "Show concise output of the command result.",
1886
+ "allowNo": false,
1887
+ "type": "boolean"
1776
1888
  }
1777
1889
  },
1778
1890
  "hasDynamicHelp": true,
1779
1891
  "hiddenAliases": [],
1780
- "id": "devops:pipeline:stage:delete",
1892
+ "id": "project:deploy:pipeline:start",
1781
1893
  "pluginAlias": "@salesforce/plugin-devops-center",
1782
1894
  "pluginName": "@salesforce/plugin-devops-center",
1783
1895
  "pluginType": "core",
1896
+ "state": "beta",
1784
1897
  "strict": true,
1785
- "summary": "Delete a stage from a DevOps Center pipeline.",
1898
+ "summary": "Deploy changes from a branch to the pipeline stage’s org.",
1786
1899
  "enableJsonFlag": true,
1787
1900
  "isESM": true,
1788
1901
  "relativePath": [
1789
1902
  "lib",
1790
1903
  "commands",
1791
- "devops",
1904
+ "project",
1905
+ "deploy",
1792
1906
  "pipeline",
1793
- "stage",
1794
- "delete.js"
1907
+ "start.js"
1795
1908
  ]
1796
1909
  },
1797
- "devops:pipeline:stage:update": {
1910
+ "project:deploy:pipeline:validate": {
1798
1911
  "aliases": [],
1799
1912
  "args": {},
1800
- "description": "Updates the name of a pipeline stage.",
1913
+ "description": "The first time you run any \"project deploy pipeline\" command, be sure to authorize the org in which DevOps Center is installed. The easiest way to authorize an org is with the \"org login web\" command.\n\nA validation runs Apex tests to verify whether a deployment will succeed without actually deploying the metadata to your environment, so you can then quickly deploy the changes later without re-running the tests.",
1801
1914
  "examples": [
1802
- "Rename a pipeline stage.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --stage-id 1QV000000000001 --name \"Integration\""
1915
+ "Perform a validate-only deployment from the Staging branch to the Staging environment (sandbox):\n<%= config.bin %> <%= command.id %> --devops-center-project-name “Recruiting App” --branch-name staging --devops-center-username MyStagingSandbox",
1916
+ "Perform a validate-only deployment of all changes from the main branch to the release environment:\n<%= config.bin %> <%= command.id %> --devops-center-project-name “Recruiting App” --branch-name main --devops-center-username MyReleaseOrg --deploy-all"
1803
1917
  ],
1804
1918
  "flags": {
1805
1919
  "json": {
@@ -1817,68 +1931,137 @@
1817
1931
  "multiple": false,
1818
1932
  "type": "option"
1819
1933
  },
1820
- "target-org": {
1821
- "char": "o",
1822
- "name": "target-org",
1823
- "noCacheDefault": true,
1824
- "required": true,
1825
- "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
1826
- "hasDynamicHelp": true,
1934
+ "branch-name": {
1935
+ "char": "b",
1936
+ "name": "branch-name",
1937
+ "required": true,
1938
+ "summary": "Name of the branch in the source control repository that corresponds to the pipeline stage that you want to deploy the changes to.",
1939
+ "hasDynamicHelp": false,
1827
1940
  "multiple": false,
1828
1941
  "type": "option"
1829
1942
  },
1830
- "api-version": {
1831
- "description": "Override the api version used for api requests made by this command",
1832
- "name": "api-version",
1943
+ "bundle-version-name": {
1944
+ "char": "v",
1945
+ "description": "You must indicate the bundle version if deploying to the environment that corresponds to the first stage after the bundling stage.",
1946
+ "name": "bundle-version-name",
1947
+ "summary": "Version name of the bundle.",
1833
1948
  "hasDynamicHelp": false,
1834
1949
  "multiple": false,
1835
1950
  "type": "option"
1836
1951
  },
1837
- "stage-id": {
1838
- "char": "s",
1839
- "name": "stage-id",
1952
+ "deploy-all": {
1953
+ "char": "a",
1954
+ "description": "If you don’t specify this flag, only changes in the stage’s branch are deployed.",
1955
+ "name": "deploy-all",
1956
+ "summary": "Deploy all metadata in the branch to the stage's org.",
1957
+ "allowNo": false,
1958
+ "type": "boolean"
1959
+ },
1960
+ "devops-center-project-name": {
1961
+ "char": "p",
1962
+ "name": "devops-center-project-name",
1840
1963
  "required": true,
1841
- "summary": "ID of the pipeline stage to update.",
1964
+ "summary": "Name of the DevOps Center project.",
1842
1965
  "hasDynamicHelp": false,
1843
1966
  "multiple": false,
1844
1967
  "type": "option"
1845
1968
  },
1846
- "name": {
1847
- "char": "n",
1848
- "name": "name",
1969
+ "devops-center-username": {
1970
+ "char": "c",
1971
+ "name": "devops-center-username",
1849
1972
  "required": true,
1850
- "summary": "New name for the pipeline stage.",
1973
+ "summary": "Username or alias of the DevOps Center org.",
1974
+ "hasDynamicHelp": true,
1975
+ "multiple": false,
1976
+ "type": "option"
1977
+ },
1978
+ "tests": {
1979
+ "char": "t",
1980
+ "description": "Separate multiple test names with commas. Enclose the entire flag value in double quotes if a test name contains spaces.",
1981
+ "name": "tests",
1982
+ "summary": "Apex tests to run when --test-level is RunSpecifiedTests.",
1851
1983
  "hasDynamicHelp": false,
1984
+ "multiple": true,
1985
+ "type": "option"
1986
+ },
1987
+ "test-level": {
1988
+ "char": "l",
1989
+ "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)",
1990
+ "name": "test-level",
1991
+ "summary": "Deployment Apex testing level.",
1992
+ "hasDynamicHelp": false,
1993
+ "multiple": false,
1994
+ "options": [
1995
+ "NoTestRun",
1996
+ "RunSpecifiedTests",
1997
+ "RunLocalTests",
1998
+ "RunAllTestsInOrg"
1999
+ ],
2000
+ "type": "option"
2001
+ },
2002
+ "async": {
2003
+ "description": "The command immediately returns the job ID and control of the terminal to you. This way, you can continue to use the CLI. To resume the deployment, run \"sf project deploy pipeline resume\". To check the status of the deployment, run \"sf project deploy pipeline report\".",
2004
+ "name": "async",
2005
+ "summary": "Run the command asynchronously.",
2006
+ "allowNo": false,
2007
+ "type": "boolean"
2008
+ },
2009
+ "wait": {
2010
+ "char": "w",
2011
+ "description": "If the command continues to run after the wait period, the CLI returns control of the terminal window to you and returns the job ID. To check the status of the operation, run \"sf project deploy pipeline report\".",
2012
+ "exclusive": [
2013
+ "async"
2014
+ ],
2015
+ "name": "wait",
2016
+ "summary": "Number of minutes to wait for command to complete and display results.",
2017
+ "default": "33 minutes",
2018
+ "hasDynamicHelp": true,
2019
+ "helpValue": "<minutes>",
1852
2020
  "multiple": false,
1853
2021
  "type": "option"
2022
+ },
2023
+ "verbose": {
2024
+ "name": "verbose",
2025
+ "summary": "Show verbose output of the command result.",
2026
+ "allowNo": false,
2027
+ "type": "boolean"
2028
+ },
2029
+ "concise": {
2030
+ "exclusive": [
2031
+ "verbose"
2032
+ ],
2033
+ "name": "concise",
2034
+ "summary": "Show concise output of the command result.",
2035
+ "allowNo": false,
2036
+ "type": "boolean"
1854
2037
  }
1855
2038
  },
1856
2039
  "hasDynamicHelp": true,
1857
2040
  "hiddenAliases": [],
1858
- "id": "devops:pipeline:stage:update",
2041
+ "id": "project:deploy:pipeline:validate",
1859
2042
  "pluginAlias": "@salesforce/plugin-devops-center",
1860
2043
  "pluginName": "@salesforce/plugin-devops-center",
1861
2044
  "pluginType": "core",
2045
+ "state": "beta",
1862
2046
  "strict": true,
1863
- "summary": "Update a DevOps Center pipeline stage.",
2047
+ "summary": "Perform a validate-only deployment from a branch to the pipeline stage’s org.",
1864
2048
  "enableJsonFlag": true,
1865
2049
  "isESM": true,
1866
2050
  "relativePath": [
1867
2051
  "lib",
1868
2052
  "commands",
1869
- "devops",
2053
+ "project",
2054
+ "deploy",
1870
2055
  "pipeline",
1871
- "stage",
1872
- "update.js"
2056
+ "validate.js"
1873
2057
  ]
1874
2058
  },
1875
- "devops:stage:branch:add": {
2059
+ "devops:pipeline:project:add": {
1876
2060
  "aliases": [],
1877
2061
  "args": {},
1878
- "description": "By default, the branch must exist in the repository. Use --create-vcs-branch to create a branch if it doesn't exist.\nEach pipeline stage supports only one branch. If the stage already has a branch, the command blocks so the existing branch isn't orphaned; pass --force to replace it.",
2062
+ "description": "You can attach a project to only one pipeline.",
1879
2063
  "examples": [
1880
- "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",
1881
- "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"
2064
+ "Attach a project to a pipeline using the project ID and pipeline ID.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --project-id 0Hn000000000001"
1882
2065
  ],
1883
2066
  "flags": {
1884
2067
  "json": {
@@ -1916,66 +2099,45 @@
1916
2099
  "pipeline-id": {
1917
2100
  "name": "pipeline-id",
1918
2101
  "required": true,
1919
- "summary": "ID of the pipeline that contains the stage.",
1920
- "hasDynamicHelp": false,
1921
- "multiple": false,
1922
- "type": "option"
1923
- },
1924
- "stage-id": {
1925
- "name": "stage-id",
1926
- "required": true,
1927
- "summary": "ID of the pipeline stage to associate the branch with.",
2102
+ "summary": "ID of the pipeline.",
1928
2103
  "hasDynamicHelp": false,
1929
2104
  "multiple": false,
1930
2105
  "type": "option"
1931
2106
  },
1932
- "branch-name": {
1933
- "char": "b",
1934
- "name": "branch-name",
2107
+ "project-id": {
2108
+ "name": "project-id",
1935
2109
  "required": true,
1936
- "summary": "Name of the repository branch to assign to the stage.",
2110
+ "summary": "ID of the DevOps Center project.",
1937
2111
  "hasDynamicHelp": false,
1938
2112
  "multiple": false,
1939
2113
  "type": "option"
1940
- },
1941
- "create-vcs-branch": {
1942
- "name": "create-vcs-branch",
1943
- "summary": "Create the branch in the remote repository if it doesn't already exist.",
1944
- "allowNo": false,
1945
- "type": "boolean"
1946
- },
1947
- "force": {
1948
- "name": "force",
1949
- "summary": "Replace the stage's existing branch. By default, the command blocks if the stage already has a branch to avoid orphaning it. With this flag, the new branch is associated and the previous branch record is removed if no other stage references it.",
1950
- "allowNo": false,
1951
- "type": "boolean"
1952
2114
  }
1953
2115
  },
1954
2116
  "hasDynamicHelp": true,
1955
2117
  "hiddenAliases": [],
1956
- "id": "devops:stage:branch:add",
2118
+ "id": "devops:pipeline:project:add",
1957
2119
  "pluginAlias": "@salesforce/plugin-devops-center",
1958
2120
  "pluginName": "@salesforce/plugin-devops-center",
1959
2121
  "pluginType": "core",
1960
2122
  "strict": true,
1961
- "summary": "Add a source code repository branch to a pipeline stage.",
2123
+ "summary": "Attach a DevOps Center project to a pipeline.",
1962
2124
  "enableJsonFlag": true,
1963
2125
  "isESM": true,
1964
2126
  "relativePath": [
1965
2127
  "lib",
1966
2128
  "commands",
1967
2129
  "devops",
1968
- "stage",
1969
- "branch",
2130
+ "pipeline",
2131
+ "project",
1970
2132
  "add.js"
1971
2133
  ]
1972
2134
  },
1973
- "devops:stage:branch:delete": {
2135
+ "devops:pipeline:project:delete": {
1974
2136
  "aliases": [],
1975
2137
  "args": {},
1976
- "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.",
2138
+ "description": "Deletes the junction record that connects the project to the pipeline. The project itself is not deleted.",
1977
2139
  "examples": [
1978
- "Delete the branch associated with a pipeline stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Xo000000000001 --stage-id 0Xp000000000001"
2140
+ "Remove a project from a pipeline using the project ID and pipeline ID.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --project-id 0Hn000000000001"
1979
2141
  ],
1980
2142
  "flags": {
1981
2143
  "json": {
@@ -2013,15 +2175,15 @@
2013
2175
  "pipeline-id": {
2014
2176
  "name": "pipeline-id",
2015
2177
  "required": true,
2016
- "summary": "ID of the pipeline that contains the stage. Used to verify the pipeline is inactive before deleting.",
2178
+ "summary": "ID of the pipeline.",
2017
2179
  "hasDynamicHelp": false,
2018
2180
  "multiple": false,
2019
2181
  "type": "option"
2020
2182
  },
2021
- "stage-id": {
2022
- "name": "stage-id",
2183
+ "project-id": {
2184
+ "name": "project-id",
2023
2185
  "required": true,
2024
- "summary": "ID of the pipeline stage whose branch you want to delete.",
2186
+ "summary": "ID of the DevOps Center project.",
2025
2187
  "hasDynamicHelp": false,
2026
2188
  "multiple": false,
2027
2189
  "type": "option"
@@ -2029,29 +2191,30 @@
2029
2191
  },
2030
2192
  "hasDynamicHelp": true,
2031
2193
  "hiddenAliases": [],
2032
- "id": "devops:stage:branch:delete",
2194
+ "id": "devops:pipeline:project:delete",
2033
2195
  "pluginAlias": "@salesforce/plugin-devops-center",
2034
2196
  "pluginName": "@salesforce/plugin-devops-center",
2035
2197
  "pluginType": "core",
2036
2198
  "strict": true,
2037
- "summary": "Delete the source code repository branch associated with a pipeline stage.",
2199
+ "summary": "Remove a DevOps Center project's connection to a pipeline.",
2038
2200
  "enableJsonFlag": true,
2039
2201
  "isESM": true,
2040
2202
  "relativePath": [
2041
2203
  "lib",
2042
2204
  "commands",
2043
2205
  "devops",
2044
- "stage",
2045
- "branch",
2206
+ "pipeline",
2207
+ "project",
2046
2208
  "delete.js"
2047
2209
  ]
2048
2210
  },
2049
- "devops:stage:environment:add": {
2211
+ "devops:pipeline:stage:add": {
2050
2212
  "aliases": [],
2051
2213
  "args": {},
2052
- "description": "This command triggers an OAuth flow to authenticate the environment. A browser window opens automatically for you to log in.",
2214
+ "description": "Inserts an empty stage before the stage specified by `--next-stage-id`. The new stage doesn't include a branch or environment. Configure them separately after you create the stage.",
2053
2215
  "examples": [
2054
- "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"
2216
+ "Add a Development stage before Integration in a specific pipeline.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --name \"Development\" --next-stage-id 0Xc000000000002",
2217
+ "Add a QA stage before UAT in a specific pipeline.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --name \"QA\" --next-stage-id 0Xc000000000003"
2055
2218
  ],
2056
2219
  "flags": {
2057
2220
  "json": {
@@ -2089,78 +2252,54 @@
2089
2252
  "pipeline-id": {
2090
2253
  "name": "pipeline-id",
2091
2254
  "required": true,
2092
- "summary": "ID of the pipeline that contains the stage.",
2093
- "hasDynamicHelp": false,
2094
- "multiple": false,
2095
- "type": "option"
2096
- },
2097
- "stage-id": {
2098
- "name": "stage-id",
2099
- "required": true,
2100
- "summary": "ID of the pipeline stage.",
2255
+ "summary": "ID of the pipeline where the stage is added.",
2101
2256
  "hasDynamicHelp": false,
2102
2257
  "multiple": false,
2103
2258
  "type": "option"
2104
2259
  },
2105
- "environment-name": {
2106
- "char": "e",
2107
- "name": "environment-name",
2260
+ "name": {
2261
+ "char": "n",
2262
+ "name": "name",
2108
2263
  "required": true,
2109
- "summary": "Name of the environment.",
2264
+ "summary": "Name of the pipeline stage, such as Integration, UAT, or Staging.",
2110
2265
  "hasDynamicHelp": false,
2111
2266
  "multiple": false,
2112
2267
  "type": "option"
2113
2268
  },
2114
- "org-type": {
2115
- "name": "org-type",
2269
+ "next-stage-id": {
2270
+ "name": "next-stage-id",
2116
2271
  "required": true,
2117
- "summary": "Type of the Salesforce org. Valid values: Production, Sandbox.",
2272
+ "summary": "ID of the stage that follows the new stage in the pipeline.",
2118
2273
  "hasDynamicHelp": false,
2119
2274
  "multiple": false,
2120
- "options": [
2121
- "Production",
2122
- "Sandbox"
2123
- ],
2124
2275
  "type": "option"
2125
- },
2126
- "no-browser": {
2127
- "name": "no-browser",
2128
- "summary": "Don't auto-open the browser for OAuth authentication. The redirect URL is printed for manual use.",
2129
- "allowNo": false,
2130
- "type": "boolean"
2131
- },
2132
- "force": {
2133
- "name": "force",
2134
- "summary": "Replace the stage's existing environment. By default, the command blocks if the stage already has an environment to avoid orphaning it. With this flag, the new environment is added first and the previous one is removed only after the new environment is associated successfully.",
2135
- "allowNo": false,
2136
- "type": "boolean"
2137
2276
  }
2138
2277
  },
2139
2278
  "hasDynamicHelp": true,
2140
2279
  "hiddenAliases": [],
2141
- "id": "devops:stage:environment:add",
2280
+ "id": "devops:pipeline:stage:add",
2142
2281
  "pluginAlias": "@salesforce/plugin-devops-center",
2143
2282
  "pluginName": "@salesforce/plugin-devops-center",
2144
2283
  "pluginType": "core",
2145
2284
  "strict": true,
2146
- "summary": "Add a Salesforce environment to a pipeline stage.",
2285
+ "summary": "Add a stage to a DevOps Center pipeline.",
2147
2286
  "enableJsonFlag": true,
2148
2287
  "isESM": true,
2149
2288
  "relativePath": [
2150
2289
  "lib",
2151
2290
  "commands",
2152
2291
  "devops",
2292
+ "pipeline",
2153
2293
  "stage",
2154
- "environment",
2155
2294
  "add.js"
2156
2295
  ]
2157
2296
  },
2158
- "devops:stage:environment:delete": {
2297
+ "devops:pipeline:stage:delete": {
2159
2298
  "aliases": [],
2160
2299
  "args": {},
2161
- "description": "Removes the specified environment from the pipeline stage. The environment must belong to an inactive pipeline.",
2300
+ "description": "Deletes the specified stage from the pipeline. If the stage sits between two other stages, the predecessor stage is automatically re-linked to the successor so the pipeline chain stays intact.",
2162
2301
  "examples": [
2163
- "Delete an environment:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --environment-id 0Xe000000000001"
2302
+ "Delete a stage from a pipeline:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --stage-id 0Xc000000000002"
2164
2303
  ],
2165
2304
  "flags": {
2166
2305
  "json": {
@@ -2198,16 +2337,15 @@
2198
2337
  "pipeline-id": {
2199
2338
  "name": "pipeline-id",
2200
2339
  "required": true,
2201
- "summary": "ID of the pipeline. Used to verify the pipeline is inactive before deleting.",
2340
+ "summary": "ID of the pipeline that contains the stage.",
2202
2341
  "hasDynamicHelp": false,
2203
2342
  "multiple": false,
2204
2343
  "type": "option"
2205
2344
  },
2206
- "environment-id": {
2207
- "char": "e",
2208
- "name": "environment-id",
2345
+ "stage-id": {
2346
+ "name": "stage-id",
2209
2347
  "required": true,
2210
- "summary": "ID of the environment to delete.",
2348
+ "summary": "ID of the stage to delete.",
2211
2349
  "hasDynamicHelp": false,
2212
2350
  "multiple": false,
2213
2351
  "type": "option"
@@ -2215,30 +2353,29 @@
2215
2353
  },
2216
2354
  "hasDynamicHelp": true,
2217
2355
  "hiddenAliases": [],
2218
- "id": "devops:stage:environment:delete",
2356
+ "id": "devops:pipeline:stage:delete",
2219
2357
  "pluginAlias": "@salesforce/plugin-devops-center",
2220
2358
  "pluginName": "@salesforce/plugin-devops-center",
2221
2359
  "pluginType": "core",
2222
2360
  "strict": true,
2223
- "summary": "Delete an environment from a DevOps Center pipeline stage.",
2361
+ "summary": "Delete a stage from a DevOps Center pipeline.",
2224
2362
  "enableJsonFlag": true,
2225
2363
  "isESM": true,
2226
2364
  "relativePath": [
2227
2365
  "lib",
2228
2366
  "commands",
2229
2367
  "devops",
2368
+ "pipeline",
2230
2369
  "stage",
2231
- "environment",
2232
2370
  "delete.js"
2233
2371
  ]
2234
2372
  },
2235
- "project:deploy:pipeline:quick": {
2373
+ "devops:pipeline:stage:update": {
2236
2374
  "aliases": [],
2237
2375
  "args": {},
2238
- "description": "The first time you run any \"project deploy pipeline\" command, be sure to authorize the org in which DevOps Center is installed. The easiest way to authorize an org is with the \"org login web\" command.\n\nBefore you run this command, create a validated deployment with the \"project deploy pipeline validate\" command, which returns a job ID. Validated deployments haven't been deployed to the org yet; you deploy them with this command. Either pass the job ID to this command or use the --use-most-recent flag to use the job ID of the most recently validated deployment. For the quick deploy to succeed, the associated validated deployment must also have succeeded.\n\nExecuting this quick deploy command takes less time than a standard deploy because it skips running Apex tests. These tests were previously run as part of the validation. Validating first and then running a quick deploy is useful if the deployment to your production org take several hours and you don’t want to risk a failed deploy.\n\nThis command doesn't support source-tracking. The source you deploy overwrites the corresponding metadata in your org. This command doesn’t attempt to merge your source with the versions in your org.",
2376
+ "description": "Updates the name of a pipeline stage.",
2239
2377
  "examples": [
2240
- "Run a quick deploy using your default Devops Center org and a job ID:\n<%= config.bin %> <%= command.id %> --job-id 0Af0x000017yLUFCA2",
2241
- "Asynchronously run a quick deploy of the most recently validated deployment using an org with alias \"my-prod-org\":\n<%= config.bin %> <%= command.id %> --async --use-most-recent --devops-center-username my-prod-org"
2378
+ "Rename a pipeline stage.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --stage-id 1QV000000000001 --name \"Integration\""
2242
2379
  ],
2243
2380
  "flags": {
2244
2381
  "json": {
@@ -2256,96 +2393,68 @@
2256
2393
  "multiple": false,
2257
2394
  "type": "option"
2258
2395
  },
2259
- "async": {
2260
- "description": "The command immediately returns the job ID and control of the terminal to you. This way, you can continue to use the CLI. To resume the deployment, run \"sf project deploy pipeline resume\". To check the status of the deployment, run \"sf project deploy pipeline report\".",
2261
- "name": "async",
2262
- "summary": "Run the command asynchronously.",
2263
- "allowNo": false,
2264
- "type": "boolean"
2265
- },
2266
- "concise": {
2267
- "exclusive": [
2268
- "verbose"
2269
- ],
2270
- "name": "concise",
2271
- "summary": "Show concise output of the command result.",
2272
- "allowNo": false,
2273
- "type": "boolean"
2274
- },
2275
- "verbose": {
2276
- "name": "verbose",
2277
- "summary": "Show verbose output of the command result.",
2278
- "allowNo": false,
2279
- "type": "boolean"
2280
- },
2281
- "wait": {
2282
- "char": "w",
2283
- "description": "If the command continues to run after the wait period, the CLI returns control of the terminal window to you and returns the job ID. To check the status of the operation, run \"sf project deploy pipeline report\".",
2284
- "exclusive": [
2285
- "async"
2286
- ],
2287
- "name": "wait",
2288
- "summary": "Number of minutes to wait for command to complete and display results.",
2289
- "default": "33 minutes",
2396
+ "target-org": {
2397
+ "char": "o",
2398
+ "name": "target-org",
2399
+ "noCacheDefault": true,
2400
+ "required": true,
2401
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
2290
2402
  "hasDynamicHelp": true,
2291
- "helpValue": "<minutes>",
2292
2403
  "multiple": false,
2293
2404
  "type": "option"
2294
2405
  },
2295
- "devops-center-username": {
2296
- "char": "c",
2297
- "name": "devops-center-username",
2298
- "required": true,
2299
- "summary": "Username or alias of the DevOps Center org.",
2300
- "hasDynamicHelp": true,
2406
+ "api-version": {
2407
+ "description": "Override the api version used for api requests made by this command",
2408
+ "name": "api-version",
2409
+ "hasDynamicHelp": false,
2301
2410
  "multiple": false,
2302
2411
  "type": "option"
2303
2412
  },
2304
- "job-id": {
2305
- "char": "i",
2306
- "description": "The job ID is valid for 10 days from when you started the validation.",
2307
- "name": "job-id",
2308
- "summary": "Job ID of the validated deployment to quick deploy.",
2413
+ "stage-id": {
2414
+ "char": "s",
2415
+ "name": "stage-id",
2416
+ "required": true,
2417
+ "summary": "ID of the pipeline stage to update.",
2309
2418
  "hasDynamicHelp": false,
2310
2419
  "multiple": false,
2311
2420
  "type": "option"
2312
2421
  },
2313
- "use-most-recent": {
2314
- "char": "r",
2315
- "description": "For performance reasons, this flag uses only job IDs that were validated in the past 3 days or less. If your most recent deployment validation was more than 3 days ago, this flag won't find the job ID.",
2316
- "name": "use-most-recent",
2317
- "summary": "Use the job ID of the most recently validated deployment.",
2318
- "allowNo": false,
2319
- "type": "boolean"
2422
+ "name": {
2423
+ "char": "n",
2424
+ "name": "name",
2425
+ "required": true,
2426
+ "summary": "New name for the pipeline stage.",
2427
+ "hasDynamicHelp": false,
2428
+ "multiple": false,
2429
+ "type": "option"
2320
2430
  }
2321
2431
  },
2322
2432
  "hasDynamicHelp": true,
2323
2433
  "hiddenAliases": [],
2324
- "id": "project:deploy:pipeline:quick",
2434
+ "id": "devops:pipeline:stage:update",
2325
2435
  "pluginAlias": "@salesforce/plugin-devops-center",
2326
2436
  "pluginName": "@salesforce/plugin-devops-center",
2327
2437
  "pluginType": "core",
2328
- "state": "beta",
2329
2438
  "strict": true,
2330
- "summary": "Quickly deploy a validated deployment to an org.",
2439
+ "summary": "Update a DevOps Center pipeline stage.",
2331
2440
  "enableJsonFlag": true,
2332
2441
  "isESM": true,
2333
2442
  "relativePath": [
2334
2443
  "lib",
2335
2444
  "commands",
2336
- "project",
2337
- "deploy",
2445
+ "devops",
2338
2446
  "pipeline",
2339
- "quick.js"
2447
+ "stage",
2448
+ "update.js"
2340
2449
  ]
2341
2450
  },
2342
- "project:deploy:pipeline:report": {
2451
+ "devops:stage:branch:add": {
2343
2452
  "aliases": [],
2344
2453
  "args": {},
2345
- "description": "The first time you run any \"project deploy pipeline\" command, be sure to authorize the org in which DevOps Center is installed. The easiest way to authorize an org is with the \"org login web\" command.\n\nRun this command by either indicating a job ID or specifying the —use-most-recent flag to use the job ID of the most recent deploy operation.",
2454
+ "description": "By default, the branch must exist in the repository. Use --create-vcs-branch to create a branch if it doesn't exist.\nEach pipeline stage supports only one branch. If the stage already has a branch, the command blocks so the existing branch isn't orphaned; pass --force to replace it.",
2346
2455
  "examples": [
2347
- "Check the status using a job ID:\n<%= config.bin %> <%= command.id %> --devops-center-username MyStagingSandbox --job-id 0Af0x000017yLUFCA2",
2348
- "Check the status of the most recent deploy operation:\n<%= config.bin %> <%= command.id %> --devops-center-username MyStagingSandbox --use-most-recent"
2456
+ "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",
2457
+ "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"
2349
2458
  ],
2350
2459
  "flags": {
2351
2460
  "json": {
@@ -2363,60 +2472,86 @@
2363
2472
  "multiple": false,
2364
2473
  "type": "option"
2365
2474
  },
2366
- "devops-center-username": {
2367
- "char": "c",
2368
- "name": "devops-center-username",
2475
+ "target-org": {
2476
+ "char": "o",
2477
+ "name": "target-org",
2478
+ "noCacheDefault": true,
2369
2479
  "required": true,
2370
- "summary": "Username or alias of the DevOps Center org.",
2480
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
2371
2481
  "hasDynamicHelp": true,
2372
2482
  "multiple": false,
2373
2483
  "type": "option"
2374
2484
  },
2375
- "job-id": {
2376
- "char": "i",
2377
- "description": "The job ID is valid for 10 days from when you started the deploy operation.",
2378
- "name": "job-id",
2379
- "summary": "Job ID of the pipeline deployment to check the status of.",
2485
+ "api-version": {
2486
+ "description": "Override the api version used for api requests made by this command",
2487
+ "name": "api-version",
2380
2488
  "hasDynamicHelp": false,
2381
2489
  "multiple": false,
2382
2490
  "type": "option"
2383
2491
  },
2384
- "use-most-recent": {
2385
- "char": "r",
2386
- "description": "For performance reasons, this flag uses job IDs for deploy operations that started in the past 3 days or fewer. If your most recent operation was longer than 3 days ago, this flag won't find the job ID.",
2387
- "name": "use-most-recent",
2388
- "summary": "Use the job ID of the most recent deploy operation.",
2492
+ "pipeline-id": {
2493
+ "name": "pipeline-id",
2494
+ "required": true,
2495
+ "summary": "ID of the pipeline that contains the stage.",
2496
+ "hasDynamicHelp": false,
2497
+ "multiple": false,
2498
+ "type": "option"
2499
+ },
2500
+ "stage-id": {
2501
+ "name": "stage-id",
2502
+ "required": true,
2503
+ "summary": "ID of the pipeline stage to associate the branch with.",
2504
+ "hasDynamicHelp": false,
2505
+ "multiple": false,
2506
+ "type": "option"
2507
+ },
2508
+ "branch-name": {
2509
+ "char": "b",
2510
+ "name": "branch-name",
2511
+ "required": true,
2512
+ "summary": "Name of the repository branch to assign to the stage.",
2513
+ "hasDynamicHelp": false,
2514
+ "multiple": false,
2515
+ "type": "option"
2516
+ },
2517
+ "create-vcs-branch": {
2518
+ "name": "create-vcs-branch",
2519
+ "summary": "Create the branch in the remote repository if it doesn't already exist.",
2520
+ "allowNo": false,
2521
+ "type": "boolean"
2522
+ },
2523
+ "force": {
2524
+ "name": "force",
2525
+ "summary": "Replace the stage's existing branch. By default, the command blocks if the stage already has a branch to avoid orphaning it. With this flag, the new branch is associated and the previous branch record is removed if no other stage references it.",
2389
2526
  "allowNo": false,
2390
2527
  "type": "boolean"
2391
2528
  }
2392
2529
  },
2393
2530
  "hasDynamicHelp": true,
2394
2531
  "hiddenAliases": [],
2395
- "id": "project:deploy:pipeline:report",
2532
+ "id": "devops:stage:branch:add",
2396
2533
  "pluginAlias": "@salesforce/plugin-devops-center",
2397
2534
  "pluginName": "@salesforce/plugin-devops-center",
2398
2535
  "pluginType": "core",
2399
- "state": "beta",
2400
2536
  "strict": true,
2401
- "summary": "Check the status of a pipeline deploy operation.",
2537
+ "summary": "Add a source code repository branch to a pipeline stage.",
2402
2538
  "enableJsonFlag": true,
2403
2539
  "isESM": true,
2404
2540
  "relativePath": [
2405
2541
  "lib",
2406
2542
  "commands",
2407
- "project",
2408
- "deploy",
2409
- "pipeline",
2410
- "report.js"
2543
+ "devops",
2544
+ "stage",
2545
+ "branch",
2546
+ "add.js"
2411
2547
  ]
2412
2548
  },
2413
- "project:deploy:pipeline:resume": {
2549
+ "devops:stage:branch:delete": {
2414
2550
  "aliases": [],
2415
2551
  "args": {},
2416
- "description": "The first time you run any \"project deploy pipeline\" command, be sure to authorize the org in which DevOps Center is installed. The easiest way to authorize an org is with the \"org login web\" command. \n\nUse this command to resume watching a pipeline deploy operation if the original command times out or you specified the --async flag.\n\nRun this command by either indicating a job ID or specifying the --use-most-recent flag to use the job ID of the most recent deploy operation.",
2552
+ "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.",
2417
2553
  "examples": [
2418
- "Resume watching a deploy operation using a job ID:\n<%= config.bin %> <%= command.id %> --job-id 0Af0x000017yLUFCA2",
2419
- "Resume watching the most recent deploy operation:\n<%= config.bin %> <%= command.id %> --use-most-recent"
2554
+ "Delete the branch associated with a pipeline stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Xo000000000001 --stage-id 0Xp000000000001"
2420
2555
  ],
2421
2556
  "flags": {
2422
2557
  "json": {
@@ -2434,89 +2569,65 @@
2434
2569
  "multiple": false,
2435
2570
  "type": "option"
2436
2571
  },
2437
- "devops-center-username": {
2438
- "char": "c",
2439
- "name": "devops-center-username",
2572
+ "target-org": {
2573
+ "char": "o",
2574
+ "name": "target-org",
2575
+ "noCacheDefault": true,
2440
2576
  "required": true,
2441
- "summary": "Username or alias of the DevOps Center org.",
2577
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
2442
2578
  "hasDynamicHelp": true,
2443
2579
  "multiple": false,
2444
2580
  "type": "option"
2445
2581
  },
2446
- "job-id": {
2447
- "char": "i",
2448
- "description": "These commands return a job ID if they time out or you specified the --async flag:\n\n- sf project deploy pipeline start\n- sf project deploy pipeline validate\n- sf project deploy pipeline quick\n\nThe job ID is valid for 10 days from when you started the deploy operation.",
2449
- "name": "job-id",
2450
- "summary": "Job ID of the pipeline deploy operation you want to resume.",
2582
+ "api-version": {
2583
+ "description": "Override the api version used for api requests made by this command",
2584
+ "name": "api-version",
2451
2585
  "hasDynamicHelp": false,
2452
2586
  "multiple": false,
2453
2587
  "type": "option"
2454
2588
  },
2455
- "use-most-recent": {
2456
- "char": "r",
2457
- "description": "For performance reasons, this flag uses job IDs for operations that started in the past 3 days or fewer. If your most recent operation was longer than 3 days ago, this flag won't find a job ID.",
2458
- "name": "use-most-recent",
2459
- "summary": "Use the job ID of the most recent deploy operation.",
2460
- "allowNo": false,
2461
- "type": "boolean"
2462
- },
2463
- "concise": {
2464
- "exclusive": [
2465
- "verbose"
2466
- ],
2467
- "name": "concise",
2468
- "summary": "Show concise output of the command result.",
2469
- "allowNo": false,
2470
- "type": "boolean"
2471
- },
2472
- "verbose": {
2473
- "name": "verbose",
2474
- "summary": "Show verbose output of the command result.",
2475
- "allowNo": false,
2476
- "type": "boolean"
2589
+ "pipeline-id": {
2590
+ "name": "pipeline-id",
2591
+ "required": true,
2592
+ "summary": "ID of the pipeline that contains the stage. Used to verify the pipeline is inactive before deleting.",
2593
+ "hasDynamicHelp": false,
2594
+ "multiple": false,
2595
+ "type": "option"
2477
2596
  },
2478
- "wait": {
2479
- "char": "w",
2480
- "description": "If the command continues to run after the wait period, the CLI returns control of the terminal window to you and returns the job ID. To check the status of the operation, run \"sf project deploy pipeline report\".",
2481
- "exclusive": [
2482
- "async"
2483
- ],
2484
- "name": "wait",
2485
- "summary": "Number of minutes to wait for command to complete and display results.",
2486
- "default": "33 minutes",
2487
- "hasDynamicHelp": true,
2488
- "helpValue": "<minutes>",
2597
+ "stage-id": {
2598
+ "name": "stage-id",
2599
+ "required": true,
2600
+ "summary": "ID of the pipeline stage whose branch you want to delete.",
2601
+ "hasDynamicHelp": false,
2489
2602
  "multiple": false,
2490
2603
  "type": "option"
2491
2604
  }
2492
2605
  },
2493
2606
  "hasDynamicHelp": true,
2494
2607
  "hiddenAliases": [],
2495
- "id": "project:deploy:pipeline:resume",
2608
+ "id": "devops:stage:branch:delete",
2496
2609
  "pluginAlias": "@salesforce/plugin-devops-center",
2497
2610
  "pluginName": "@salesforce/plugin-devops-center",
2498
2611
  "pluginType": "core",
2499
- "state": "beta",
2500
2612
  "strict": true,
2501
- "summary": "Resume watching a pipeline deploy operation.",
2613
+ "summary": "Delete the source code repository branch associated with a pipeline stage.",
2502
2614
  "enableJsonFlag": true,
2503
2615
  "isESM": true,
2504
2616
  "relativePath": [
2505
2617
  "lib",
2506
2618
  "commands",
2507
- "project",
2508
- "deploy",
2509
- "pipeline",
2510
- "resume.js"
2619
+ "devops",
2620
+ "stage",
2621
+ "branch",
2622
+ "delete.js"
2511
2623
  ]
2512
2624
  },
2513
- "project:deploy:pipeline:start": {
2625
+ "devops:stage:environment:add": {
2514
2626
  "aliases": [],
2515
2627
  "args": {},
2516
- "description": "The first time you run any \"project deploy pipeline\" command, be sure to authorize the org in which DevOps Center is installed. The easiest way to authorize an org is with the \"org login web\" command.\n\nBefore you run this command, changes in the pipeline stage's branch must be merged in the source control repository.",
2628
+ "description": "This command triggers an OAuth flow to authenticate the environment. A browser window opens automatically for you to log in.",
2517
2629
  "examples": [
2518
- "Deploy changes in the Staging branch to the Staging environment (sandbox), if the previous stage is the bundling stage:\n<%= config.bin %> <%= command.id %> --devops-center-project-name “Recruiting App” --branch-name staging --devops-center-username MyStagingSandbox --bundle-version-name 1.0",
2519
- "Deploy all changes in the main branch to the release environment:\n<%= config.bin %> <%= command.id %> --devops-center-project-name “Recruiting App” --branch-name main --devops-center-username MyReleaseOrg --deploy-all"
2630
+ "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"
2520
2631
  ],
2521
2632
  "flags": {
2522
2633
  "json": {
@@ -2534,138 +2645,98 @@
2534
2645
  "multiple": false,
2535
2646
  "type": "option"
2536
2647
  },
2537
- "branch-name": {
2538
- "char": "b",
2539
- "name": "branch-name",
2648
+ "target-org": {
2649
+ "char": "o",
2650
+ "name": "target-org",
2651
+ "noCacheDefault": true,
2540
2652
  "required": true,
2541
- "summary": "Name of the branch in the source control repository that corresponds to the pipeline stage that you want to deploy the changes to.",
2542
- "hasDynamicHelp": false,
2653
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
2654
+ "hasDynamicHelp": true,
2543
2655
  "multiple": false,
2544
2656
  "type": "option"
2545
2657
  },
2546
- "bundle-version-name": {
2547
- "char": "v",
2548
- "description": "You must indicate the bundle version if deploying to the environment that corresponds to the first stage after the bundling stage.",
2549
- "name": "bundle-version-name",
2550
- "summary": "Version name of the bundle.",
2658
+ "api-version": {
2659
+ "description": "Override the api version used for api requests made by this command",
2660
+ "name": "api-version",
2551
2661
  "hasDynamicHelp": false,
2552
2662
  "multiple": false,
2553
2663
  "type": "option"
2554
2664
  },
2555
- "deploy-all": {
2556
- "char": "a",
2557
- "description": "If you don’t specify this flag, only changes in the stage’s branch are deployed.",
2558
- "name": "deploy-all",
2559
- "summary": "Deploy all metadata in the branch to the stage's org.",
2560
- "allowNo": false,
2561
- "type": "boolean"
2562
- },
2563
- "devops-center-project-name": {
2564
- "char": "p",
2565
- "name": "devops-center-project-name",
2665
+ "pipeline-id": {
2666
+ "name": "pipeline-id",
2566
2667
  "required": true,
2567
- "summary": "Name of the DevOps Center project.",
2668
+ "summary": "ID of the pipeline that contains the stage.",
2568
2669
  "hasDynamicHelp": false,
2569
2670
  "multiple": false,
2570
2671
  "type": "option"
2571
2672
  },
2572
- "devops-center-username": {
2573
- "char": "c",
2574
- "name": "devops-center-username",
2673
+ "stage-id": {
2674
+ "name": "stage-id",
2575
2675
  "required": true,
2576
- "summary": "Username or alias of the DevOps Center org.",
2577
- "hasDynamicHelp": true,
2676
+ "summary": "ID of the pipeline stage.",
2677
+ "hasDynamicHelp": false,
2578
2678
  "multiple": false,
2579
2679
  "type": "option"
2580
2680
  },
2581
- "tests": {
2582
- "char": "t",
2583
- "description": "Separate multiple test names with commas. Enclose the entire flag value in double quotes if a test name contains spaces.",
2584
- "name": "tests",
2585
- "summary": "Apex tests to run when --test-level is RunSpecifiedTests.",
2681
+ "environment-name": {
2682
+ "char": "e",
2683
+ "name": "environment-name",
2684
+ "required": true,
2685
+ "summary": "Name of the environment.",
2586
2686
  "hasDynamicHelp": false,
2587
- "multiple": true,
2687
+ "multiple": false,
2588
2688
  "type": "option"
2589
2689
  },
2590
- "test-level": {
2591
- "char": "l",
2592
- "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)",
2593
- "name": "test-level",
2594
- "summary": "Deployment Apex testing level.",
2690
+ "org-type": {
2691
+ "name": "org-type",
2692
+ "required": true,
2693
+ "summary": "Type of the Salesforce org. Valid values: Production, Sandbox.",
2595
2694
  "hasDynamicHelp": false,
2596
2695
  "multiple": false,
2597
2696
  "options": [
2598
- "NoTestRun",
2599
- "RunSpecifiedTests",
2600
- "RunLocalTests",
2601
- "RunAllTestsInOrg"
2697
+ "Production",
2698
+ "Sandbox"
2602
2699
  ],
2603
2700
  "type": "option"
2604
2701
  },
2605
- "async": {
2606
- "description": "The command immediately returns the job ID and control of the terminal to you. This way, you can continue to use the CLI. To resume the deployment, run \"sf project deploy pipeline resume\". To check the status of the deployment, run \"sf project deploy pipeline report\".",
2607
- "name": "async",
2608
- "summary": "Run the command asynchronously.",
2609
- "allowNo": false,
2610
- "type": "boolean"
2611
- },
2612
- "wait": {
2613
- "char": "w",
2614
- "description": "If the command continues to run after the wait period, the CLI returns control of the terminal window to you and returns the job ID. To check the status of the operation, run \"sf project deploy pipeline report\".",
2615
- "exclusive": [
2616
- "async"
2617
- ],
2618
- "name": "wait",
2619
- "summary": "Number of minutes to wait for command to complete and display results.",
2620
- "default": "33 minutes",
2621
- "hasDynamicHelp": true,
2622
- "helpValue": "<minutes>",
2623
- "multiple": false,
2624
- "type": "option"
2625
- },
2626
- "verbose": {
2627
- "name": "verbose",
2628
- "summary": "Show verbose output of the command result.",
2702
+ "no-browser": {
2703
+ "name": "no-browser",
2704
+ "summary": "Don't auto-open the browser for OAuth authentication. The redirect URL is printed for manual use.",
2629
2705
  "allowNo": false,
2630
2706
  "type": "boolean"
2631
2707
  },
2632
- "concise": {
2633
- "exclusive": [
2634
- "verbose"
2635
- ],
2636
- "name": "concise",
2637
- "summary": "Show concise output of the command result.",
2708
+ "force": {
2709
+ "name": "force",
2710
+ "summary": "Replace the stage's existing environment. By default, the command blocks if the stage already has an environment to avoid orphaning it. With this flag, the new environment is added first and the previous one is removed only after the new environment is associated successfully.",
2638
2711
  "allowNo": false,
2639
2712
  "type": "boolean"
2640
2713
  }
2641
2714
  },
2642
2715
  "hasDynamicHelp": true,
2643
2716
  "hiddenAliases": [],
2644
- "id": "project:deploy:pipeline:start",
2717
+ "id": "devops:stage:environment:add",
2645
2718
  "pluginAlias": "@salesforce/plugin-devops-center",
2646
2719
  "pluginName": "@salesforce/plugin-devops-center",
2647
2720
  "pluginType": "core",
2648
- "state": "beta",
2649
2721
  "strict": true,
2650
- "summary": "Deploy changes from a branch to the pipeline stage’s org.",
2722
+ "summary": "Add a Salesforce environment to a pipeline stage.",
2651
2723
  "enableJsonFlag": true,
2652
2724
  "isESM": true,
2653
2725
  "relativePath": [
2654
2726
  "lib",
2655
2727
  "commands",
2656
- "project",
2657
- "deploy",
2658
- "pipeline",
2659
- "start.js"
2728
+ "devops",
2729
+ "stage",
2730
+ "environment",
2731
+ "add.js"
2660
2732
  ]
2661
2733
  },
2662
- "project:deploy:pipeline:validate": {
2734
+ "devops:stage:environment:delete": {
2663
2735
  "aliases": [],
2664
2736
  "args": {},
2665
- "description": "The first time you run any \"project deploy pipeline\" command, be sure to authorize the org in which DevOps Center is installed. The easiest way to authorize an org is with the \"org login web\" command.\n\nA validation runs Apex tests to verify whether a deployment will succeed without actually deploying the metadata to your environment, so you can then quickly deploy the changes later without re-running the tests.",
2737
+ "description": "Removes the specified environment from the pipeline stage. The environment must belong to an inactive pipeline.",
2666
2738
  "examples": [
2667
- "Perform a validate-only deployment from the Staging branch to the Staging environment (sandbox):\n<%= config.bin %> <%= command.id %> --devops-center-project-name “Recruiting App” --branch-name staging --devops-center-username MyStagingSandbox",
2668
- "Perform a validate-only deployment of all changes from the main branch to the release environment:\n<%= config.bin %> <%= command.id %> --devops-center-project-name “Recruiting App” --branch-name main --devops-center-username MyReleaseOrg --deploy-all"
2739
+ "Delete an environment:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --environment-id 0Xe000000000001"
2669
2740
  ],
2670
2741
  "flags": {
2671
2742
  "json": {
@@ -2683,131 +2754,60 @@
2683
2754
  "multiple": false,
2684
2755
  "type": "option"
2685
2756
  },
2686
- "branch-name": {
2687
- "char": "b",
2688
- "name": "branch-name",
2757
+ "target-org": {
2758
+ "char": "o",
2759
+ "name": "target-org",
2760
+ "noCacheDefault": true,
2689
2761
  "required": true,
2690
- "summary": "Name of the branch in the source control repository that corresponds to the pipeline stage that you want to deploy the changes to.",
2691
- "hasDynamicHelp": false,
2762
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
2763
+ "hasDynamicHelp": true,
2692
2764
  "multiple": false,
2693
2765
  "type": "option"
2694
2766
  },
2695
- "bundle-version-name": {
2696
- "char": "v",
2697
- "description": "You must indicate the bundle version if deploying to the environment that corresponds to the first stage after the bundling stage.",
2698
- "name": "bundle-version-name",
2699
- "summary": "Version name of the bundle.",
2767
+ "api-version": {
2768
+ "description": "Override the api version used for api requests made by this command",
2769
+ "name": "api-version",
2700
2770
  "hasDynamicHelp": false,
2701
2771
  "multiple": false,
2702
2772
  "type": "option"
2703
2773
  },
2704
- "deploy-all": {
2705
- "char": "a",
2706
- "description": "If you don’t specify this flag, only changes in the stage’s branch are deployed.",
2707
- "name": "deploy-all",
2708
- "summary": "Deploy all metadata in the branch to the stage's org.",
2709
- "allowNo": false,
2710
- "type": "boolean"
2711
- },
2712
- "devops-center-project-name": {
2713
- "char": "p",
2714
- "name": "devops-center-project-name",
2774
+ "pipeline-id": {
2775
+ "name": "pipeline-id",
2715
2776
  "required": true,
2716
- "summary": "Name of the DevOps Center project.",
2777
+ "summary": "ID of the pipeline. Used to verify the pipeline is inactive before deleting.",
2717
2778
  "hasDynamicHelp": false,
2718
2779
  "multiple": false,
2719
2780
  "type": "option"
2720
2781
  },
2721
- "devops-center-username": {
2722
- "char": "c",
2723
- "name": "devops-center-username",
2782
+ "environment-id": {
2783
+ "char": "e",
2784
+ "name": "environment-id",
2724
2785
  "required": true,
2725
- "summary": "Username or alias of the DevOps Center org.",
2726
- "hasDynamicHelp": true,
2727
- "multiple": false,
2728
- "type": "option"
2729
- },
2730
- "tests": {
2731
- "char": "t",
2732
- "description": "Separate multiple test names with commas. Enclose the entire flag value in double quotes if a test name contains spaces.",
2733
- "name": "tests",
2734
- "summary": "Apex tests to run when --test-level is RunSpecifiedTests.",
2735
- "hasDynamicHelp": false,
2736
- "multiple": true,
2737
- "type": "option"
2738
- },
2739
- "test-level": {
2740
- "char": "l",
2741
- "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)",
2742
- "name": "test-level",
2743
- "summary": "Deployment Apex testing level.",
2786
+ "summary": "ID of the environment to delete.",
2744
2787
  "hasDynamicHelp": false,
2745
2788
  "multiple": false,
2746
- "options": [
2747
- "NoTestRun",
2748
- "RunSpecifiedTests",
2749
- "RunLocalTests",
2750
- "RunAllTestsInOrg"
2751
- ],
2752
2789
  "type": "option"
2753
- },
2754
- "async": {
2755
- "description": "The command immediately returns the job ID and control of the terminal to you. This way, you can continue to use the CLI. To resume the deployment, run \"sf project deploy pipeline resume\". To check the status of the deployment, run \"sf project deploy pipeline report\".",
2756
- "name": "async",
2757
- "summary": "Run the command asynchronously.",
2758
- "allowNo": false,
2759
- "type": "boolean"
2760
- },
2761
- "wait": {
2762
- "char": "w",
2763
- "description": "If the command continues to run after the wait period, the CLI returns control of the terminal window to you and returns the job ID. To check the status of the operation, run \"sf project deploy pipeline report\".",
2764
- "exclusive": [
2765
- "async"
2766
- ],
2767
- "name": "wait",
2768
- "summary": "Number of minutes to wait for command to complete and display results.",
2769
- "default": "33 minutes",
2770
- "hasDynamicHelp": true,
2771
- "helpValue": "<minutes>",
2772
- "multiple": false,
2773
- "type": "option"
2774
- },
2775
- "verbose": {
2776
- "name": "verbose",
2777
- "summary": "Show verbose output of the command result.",
2778
- "allowNo": false,
2779
- "type": "boolean"
2780
- },
2781
- "concise": {
2782
- "exclusive": [
2783
- "verbose"
2784
- ],
2785
- "name": "concise",
2786
- "summary": "Show concise output of the command result.",
2787
- "allowNo": false,
2788
- "type": "boolean"
2789
2790
  }
2790
2791
  },
2791
2792
  "hasDynamicHelp": true,
2792
2793
  "hiddenAliases": [],
2793
- "id": "project:deploy:pipeline:validate",
2794
+ "id": "devops:stage:environment:delete",
2794
2795
  "pluginAlias": "@salesforce/plugin-devops-center",
2795
2796
  "pluginName": "@salesforce/plugin-devops-center",
2796
2797
  "pluginType": "core",
2797
- "state": "beta",
2798
2798
  "strict": true,
2799
- "summary": "Perform a validate-only deployment from a branch to the pipeline stage’s org.",
2799
+ "summary": "Delete an environment from a DevOps Center pipeline stage.",
2800
2800
  "enableJsonFlag": true,
2801
2801
  "isESM": true,
2802
2802
  "relativePath": [
2803
2803
  "lib",
2804
2804
  "commands",
2805
- "project",
2806
- "deploy",
2807
- "pipeline",
2808
- "validate.js"
2805
+ "devops",
2806
+ "stage",
2807
+ "environment",
2808
+ "delete.js"
2809
2809
  ]
2810
2810
  }
2811
2811
  },
2812
- "version": "2.3.2"
2812
+ "version": "2.3.4"
2813
2813
  }