@salesforce/plugin-devops-center 2.3.0 → 2.3.2

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 (48) hide show
  1. package/README.md +31 -31
  2. package/lib/commands/devops/pipeline/update.js +1 -1
  3. package/lib/commands/devops/pipeline/update.js.map +1 -1
  4. package/lib/common/base/abstractAsyncOperation.js +4 -1
  5. package/lib/common/base/abstractAsyncOperation.js.map +1 -1
  6. package/lib/common/base/abstractPromote.d.ts +2 -2
  7. package/lib/common/base/abstractPromote.js +4 -3
  8. package/lib/common/base/abstractPromote.js.map +1 -1
  9. package/lib/common/base/abstractQuick.js +2 -0
  10. package/lib/common/base/abstractQuick.js.map +1 -1
  11. package/lib/common/base/abstractReportOnPromote.js +0 -2
  12. package/lib/common/base/abstractReportOnPromote.js.map +1 -1
  13. package/lib/common/base/abstractResume.js +1 -2
  14. package/lib/common/base/abstractResume.js.map +1 -1
  15. package/lib/common/flags/flags.js +2 -0
  16. package/lib/common/flags/flags.js.map +1 -1
  17. package/lib/common/outputService/aorOutputService.js +1 -1
  18. package/lib/common/outputService/aorOutputService.js.map +1 -1
  19. package/lib/common/outputService/deployCommandOutputService.js +1 -1
  20. package/lib/common/outputService/deployCommandOutputService.js.map +1 -1
  21. package/lib/common/outputService/deploySummaryBuilder.js +5 -1
  22. package/lib/common/outputService/deploySummaryBuilder.js.map +1 -1
  23. package/lib/common/outputService/deploymentResultOutputService.js.map +1 -1
  24. package/lib/common/outputService/promoteOutputService.js +1 -1
  25. package/lib/common/outputService/promoteOutputService.js.map +1 -1
  26. package/lib/common/outputService/reportOutputService.js +0 -1
  27. package/lib/common/outputService/reportOutputService.js.map +1 -1
  28. package/lib/common/outputService/resumeCommandOutputService.js +1 -1
  29. package/lib/common/outputService/resumeCommandOutputService.js.map +1 -1
  30. package/lib/common/outputService/resumeOutputService.js +1 -0
  31. package/lib/common/outputService/resumeOutputService.js.map +1 -1
  32. package/lib/common/utils.js +0 -2
  33. package/lib/common/utils.js.map +1 -1
  34. package/lib/streamer/processors/asyncOpStream.js +0 -2
  35. package/lib/streamer/processors/asyncOpStream.js.map +1 -1
  36. package/lib/streamer/sObjectStream.js +2 -3
  37. package/lib/streamer/sObjectStream.js.map +1 -1
  38. package/lib/utils/addStageEnvironment.js +0 -1
  39. package/lib/utils/addStageEnvironment.js.map +1 -1
  40. package/lib/utils/createPullRequest.js +1 -3
  41. package/lib/utils/createPullRequest.js.map +1 -1
  42. package/lib/utils/createWorkItem.js +6 -7
  43. package/lib/utils/createWorkItem.js.map +1 -1
  44. package/lib/utils/workItems.js +1 -1
  45. package/oclif.manifest.json +257 -257
  46. package/package.json +16 -9
  47. package/npm-shrinkwrap.json +0 -16645
  48. package/oclif.lock +0 -8997
@@ -138,17 +138,14 @@
138
138
  "promote.js"
139
139
  ]
140
140
  },
141
- "devops:pipeline:create": {
141
+ "devops:promotion:complete": {
142
142
  "aliases": [],
143
143
  "args": {},
144
- "description": "Provide the URL of an existing repository, or use `--create-repo` with a repository name to create one. After you create the pipeline, add stages, and activate the pipeline.",
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
145
  "examples": [
146
- "Create a pipeline and associate it with an existing GitHub repository:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"Release Pipeline\" --repo https://github.com/myorg/myrepo",
147
- "Create a pipeline and associate it with a new GitHub repository:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"Release Pipeline\" --repo my-new-repo --repo-type github --repo-owner myorg --create-repo",
148
- "Create a pipeline and create a new Bitbucket repository:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"Release Pipeline\" --repo my-new-repo --repo-type bitbucket --bitbucket-workspace myworkspace --bitbucket-project-key PROJ --create-repo",
149
- "Create a pipeline and associate it with an existing Bitbucket repository:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"Release Pipeline\" --repo https://bitbucket.org/myworkspace/myrepo",
150
- "Create a pipeline with custom stage names instead of the default stages:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"Release Pipeline\" --repo https://github.com/myorg/myrepo --stage Dev --stage QA --stage Prod",
151
- "Create a pipeline and associate one or more projects with it:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"Release Pipeline\" --repo https://github.com/myorg/myrepo --project-id 0Hn000000000001 --project-id 0Hn000000000002"
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"
152
149
  ],
153
150
  "flags": {
154
151
  "json": {
@@ -183,73 +180,51 @@
183
180
  "multiple": false,
184
181
  "type": "option"
185
182
  },
186
- "name": {
187
- "char": "n",
188
- "name": "name",
189
- "required": true,
190
- "summary": "Name of the pipeline.",
191
- "hasDynamicHelp": false,
192
- "multiple": false,
193
- "type": "option"
194
- },
195
- "repo": {
196
- "char": "r",
197
- "name": "repo",
183
+ "target-stage-id": {
184
+ "char": "t",
185
+ "name": "target-stage-id",
198
186
  "required": true,
199
- "summary": "URL of an existing repository or the name of a repository to create.",
187
+ "summary": "ID of the out-of-sync pipeline stage to deploy to.",
200
188
  "hasDynamicHelp": false,
201
189
  "multiple": false,
202
190
  "type": "option"
203
191
  },
204
- "repo-type": {
205
- "name": "repo-type",
206
- "summary": "Type of the source code repository. Required when creating a repository using '--create-repo'.",
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.",
207
197
  "hasDynamicHelp": false,
208
- "multiple": false,
209
- "options": [
210
- "github",
211
- "bitbucket"
212
- ],
198
+ "multiple": true,
213
199
  "type": "option"
214
200
  },
215
- "create-repo": {
216
- "name": "create-repo",
217
- "summary": "Create a repository if it doesn't exist.",
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.",
218
206
  "allowNo": false,
219
207
  "type": "boolean"
220
208
  },
221
- "repo-owner": {
222
- "name": "repo-owner",
223
- "summary": "Owner (organization or user) of the GitHub repository. Required when creating a GitHub repository using '--create-repo'.",
224
- "hasDynamicHelp": false,
225
- "multiple": false,
226
- "type": "option"
227
- },
228
- "bitbucket-workspace": {
229
- "name": "bitbucket-workspace",
230
- "summary": "Bitbucket workspace that will own the repository. Required when creating a Bitbucket repository using '--create-repo'.",
231
- "hasDynamicHelp": false,
232
- "multiple": false,
233
- "type": "option"
234
- },
235
- "bitbucket-project-key": {
236
- "name": "bitbucket-project-key",
237
- "summary": "Bitbucket project key to associate with the repository. Optional when creating a Bitbucket repository using '--create-repo'.",
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.",
238
214
  "hasDynamicHelp": false,
239
215
  "multiple": false,
216
+ "options": [
217
+ "NoTestRun",
218
+ "RunSpecifiedTests",
219
+ "RunLocalTests",
220
+ "RunAllTestsInOrg"
221
+ ],
240
222
  "type": "option"
241
223
  },
242
- "stage": {
243
- "char": "s",
244
- "name": "stage",
245
- "summary": "Name of a pipeline stage, in promotion order. Repeat the flag for each stage. Defaults to Integration, UAT, Staging, and Production.",
246
- "hasDynamicHelp": false,
247
- "multiple": true,
248
- "type": "option"
249
- },
250
- "project-id": {
251
- "name": "project-id",
252
- "summary": "ID of a project to associate with the pipeline. Repeat the flag to associate multiple projects.",
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.",
253
228
  "hasDynamicHelp": false,
254
229
  "multiple": true,
255
230
  "type": "option"
@@ -257,28 +232,29 @@
257
232
  },
258
233
  "hasDynamicHelp": true,
259
234
  "hiddenAliases": [],
260
- "id": "devops:pipeline:create",
235
+ "id": "devops:promotion:complete",
261
236
  "pluginAlias": "@salesforce/plugin-devops-center",
262
237
  "pluginName": "@salesforce/plugin-devops-center",
263
238
  "pluginType": "core",
264
239
  "strict": true,
265
- "summary": "Create a DevOps Center pipeline.",
240
+ "summary": "Deploy undeployed work items to a pipeline stage org.",
266
241
  "enableJsonFlag": true,
267
242
  "isESM": true,
268
243
  "relativePath": [
269
244
  "lib",
270
245
  "commands",
271
246
  "devops",
272
- "pipeline",
273
- "create.js"
247
+ "promotion",
248
+ "complete.js"
274
249
  ]
275
250
  },
276
- "devops:pipeline:get": {
251
+ "devops:promotion:validate": {
277
252
  "aliases": [],
278
253
  "args": {},
279
- "description": "Returns full details for a single DevOps Center pipeline: its stages in order, the source code repository and branch associated with each stage, and any connected projects.",
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.",
280
255
  "examples": [
281
- "Get details for a specific pipeline:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Do000000000001"
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"
282
258
  ],
283
259
  "flags": {
284
260
  "json": {
@@ -313,40 +289,50 @@
313
289
  "multiple": false,
314
290
  "type": "option"
315
291
  },
316
- "pipeline-id": {
317
- "char": "i",
318
- "name": "pipeline-id",
292
+ "target-stage-id": {
293
+ "char": "t",
294
+ "name": "target-stage-id",
319
295
  "required": true,
320
- "summary": "ID of the DevOps Center pipeline.",
296
+ "summary": "ID of the target pipeline stage to validate promotion to.",
321
297
  "hasDynamicHelp": false,
322
298
  "multiple": false,
323
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"
324
309
  }
325
310
  },
326
311
  "hasDynamicHelp": true,
327
312
  "hiddenAliases": [],
328
- "id": "devops:pipeline:get",
313
+ "id": "devops:promotion:validate",
329
314
  "pluginAlias": "@salesforce/plugin-devops-center",
330
315
  "pluginName": "@salesforce/plugin-devops-center",
331
316
  "pluginType": "core",
332
317
  "strict": true,
333
- "summary": "Get details of a DevOps Center pipeline including its stages, repositories, and connected projects.",
318
+ "summary": "Validate work item promotion for a pipeline stage.",
334
319
  "enableJsonFlag": true,
335
320
  "isESM": true,
336
321
  "relativePath": [
337
322
  "lib",
338
323
  "commands",
339
324
  "devops",
340
- "pipeline",
341
- "get.js"
325
+ "promotion",
326
+ "validate.js"
342
327
  ]
343
328
  },
344
- "devops:pipeline:list": {
329
+ "devops:project:create": {
345
330
  "aliases": [],
346
331
  "args": {},
347
- "description": "Returns all DevOps Center pipelines in the org, including each pipeline's stages (in order), source code repository information per stage, and any connected projects.",
332
+ "description": "Creates a new DevOps Center project with the specified name and optional description.",
348
333
  "examples": [
349
- "List all pipelines in the org:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org"
334
+ "Create a new DevOps Center project in the specified org.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"MyApp Release\"",
335
+ "Create a project with a name and description.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"Platform Update\" --description \"Platform services update\""
350
336
  ],
351
337
  "flags": {
352
338
  "json": {
@@ -380,33 +366,50 @@
380
366
  "hasDynamicHelp": false,
381
367
  "multiple": false,
382
368
  "type": "option"
369
+ },
370
+ "name": {
371
+ "char": "n",
372
+ "name": "name",
373
+ "required": true,
374
+ "summary": "Name of the new DevOps Center project.",
375
+ "hasDynamicHelp": false,
376
+ "multiple": false,
377
+ "type": "option"
378
+ },
379
+ "description": {
380
+ "char": "d",
381
+ "name": "description",
382
+ "summary": "Description of the new project; if not specified, the description is blank.",
383
+ "hasDynamicHelp": false,
384
+ "multiple": false,
385
+ "type": "option"
383
386
  }
384
387
  },
385
388
  "hasDynamicHelp": true,
386
389
  "hiddenAliases": [],
387
- "id": "devops:pipeline:list",
390
+ "id": "devops:project:create",
388
391
  "pluginAlias": "@salesforce/plugin-devops-center",
389
392
  "pluginName": "@salesforce/plugin-devops-center",
390
393
  "pluginType": "core",
391
394
  "strict": true,
392
- "summary": "List DevOps Center pipelines with their stages, repositories, and connected projects.",
395
+ "summary": "Create a DevOps Center project in a DevOps Center org.",
393
396
  "enableJsonFlag": true,
394
397
  "isESM": true,
395
398
  "relativePath": [
396
399
  "lib",
397
400
  "commands",
398
401
  "devops",
399
- "pipeline",
400
- "list.js"
402
+ "project",
403
+ "create.js"
401
404
  ]
402
405
  },
403
- "devops:pipeline:update": {
406
+ "devops:project:list": {
404
407
  "aliases": [],
405
408
  "args": {},
406
- "description": "Activate, deactivate, or rename a DevOps Center pipeline. Use --activate to activate, --deactivate to deactivate, and --name to rename. You can combine --deactivate and --name in one command.\n\nA pipeline must have at least one stage before you can activate it. You can't modify the pipeline stages after you activate and promote changes through it.",
409
+ "description": "This command queries the DevopsProject standard object and returns the project Id, Name, and Description for each project found.",
407
410
  "examples": [
408
- "Activate a pipeline:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --activate",
409
- "Deactivate and rename in one step.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --deactivate --name \"My Pipeline\""
411
+ "List all DevOps Center projects in an org with alias \"my-devops-org\":\n<%= config.bin %> <%= command.id %> --target-org my-devops-org",
412
+ "List projects using an org's username:\n<%= config.bin %> <%= command.id %> --target-org devops-center@example.com"
410
413
  ],
411
414
  "flags": {
412
415
  "json": {
@@ -440,70 +443,35 @@
440
443
  "hasDynamicHelp": false,
441
444
  "multiple": false,
442
445
  "type": "option"
443
- },
444
- "pipeline-id": {
445
- "name": "pipeline-id",
446
- "required": true,
447
- "summary": "ID of the pipeline.",
448
- "hasDynamicHelp": false,
449
- "multiple": false,
450
- "type": "option"
451
- },
452
- "activate": {
453
- "exclusive": [
454
- "deactivate"
455
- ],
456
- "name": "activate",
457
- "required": false,
458
- "summary": "Activate the pipeline. Can't be used with --deactivate.",
459
- "allowNo": false,
460
- "type": "boolean"
461
- },
462
- "deactivate": {
463
- "exclusive": [
464
- "activate"
465
- ],
466
- "name": "deactivate",
467
- "required": false,
468
- "summary": "Deactivate the pipeline. Can't be used with --activate.",
469
- "allowNo": false,
470
- "type": "boolean"
471
- },
472
- "name": {
473
- "char": "n",
474
- "name": "name",
475
- "required": false,
476
- "summary": "New name for the pipeline.",
477
- "hasDynamicHelp": false,
478
- "multiple": false,
479
- "type": "option"
480
446
  }
481
447
  },
482
448
  "hasDynamicHelp": true,
483
449
  "hiddenAliases": [],
484
- "id": "devops:pipeline:update",
450
+ "id": "devops:project:list",
485
451
  "pluginAlias": "@salesforce/plugin-devops-center",
486
452
  "pluginName": "@salesforce/plugin-devops-center",
487
453
  "pluginType": "core",
488
454
  "strict": true,
489
- "summary": "Update a DevOps Center pipeline.",
455
+ "summary": "List all DevOps Center projects in a Salesforce org.",
490
456
  "enableJsonFlag": true,
491
457
  "isESM": true,
492
458
  "relativePath": [
493
459
  "lib",
494
460
  "commands",
495
461
  "devops",
496
- "pipeline",
497
- "update.js"
462
+ "project",
463
+ "list.js"
498
464
  ]
499
465
  },
500
- "devops:project:create": {
466
+ "devops:project:update": {
501
467
  "aliases": [],
502
468
  "args": {},
503
- "description": "Creates a new DevOps Center project with the specified name and optional description.",
469
+ "description": "Update the name, description, or active status of a DevOps Center project. At least one of --name, --description, or --is-active must be provided.",
504
470
  "examples": [
505
- "Create a new DevOps Center project in the specified org.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"MyApp Release\"",
506
- "Create a project with a name and description.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"Platform Update\" --description \"Platform services update\""
471
+ "Rename a project:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --name \"MyApp Release v2\"",
472
+ "Update the description of a project:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --description \"Updated release description\"",
473
+ "Deactivate a project:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --no-is-active",
474
+ "Update all fields at once:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --name \"Archived App\" --description \"Archived\" --no-is-active"
507
475
  ],
508
476
  "flags": {
509
477
  "json": {
@@ -538,11 +506,19 @@
538
506
  "multiple": false,
539
507
  "type": "option"
540
508
  },
509
+ "project-id": {
510
+ "char": "i",
511
+ "name": "project-id",
512
+ "required": true,
513
+ "summary": "ID of the DevOps Center project to update.",
514
+ "hasDynamicHelp": false,
515
+ "multiple": false,
516
+ "type": "option"
517
+ },
541
518
  "name": {
542
519
  "char": "n",
543
520
  "name": "name",
544
- "required": true,
545
- "summary": "Name of the new DevOps Center project.",
521
+ "summary": "New name for the project.",
546
522
  "hasDynamicHelp": false,
547
523
  "multiple": false,
548
524
  "type": "option"
@@ -550,20 +526,26 @@
550
526
  "description": {
551
527
  "char": "d",
552
528
  "name": "description",
553
- "summary": "Description of the new project; if not specified, the description is blank.",
529
+ "summary": "New description for the project.",
554
530
  "hasDynamicHelp": false,
555
531
  "multiple": false,
556
532
  "type": "option"
533
+ },
534
+ "is-active": {
535
+ "name": "is-active",
536
+ "summary": "Set the project active status. Use --is-active to activate or --no-is-active to deactivate.",
537
+ "allowNo": true,
538
+ "type": "boolean"
557
539
  }
558
540
  },
559
541
  "hasDynamicHelp": true,
560
542
  "hiddenAliases": [],
561
- "id": "devops:project:create",
543
+ "id": "devops:project:update",
562
544
  "pluginAlias": "@salesforce/plugin-devops-center",
563
545
  "pluginName": "@salesforce/plugin-devops-center",
564
546
  "pluginType": "core",
565
547
  "strict": true,
566
- "summary": "Create a DevOps Center project in a DevOps Center org.",
548
+ "summary": "Update a DevOps Center project.",
567
549
  "enableJsonFlag": true,
568
550
  "isESM": true,
569
551
  "relativePath": [
@@ -571,16 +553,20 @@
571
553
  "commands",
572
554
  "devops",
573
555
  "project",
574
- "create.js"
556
+ "update.js"
575
557
  ]
576
558
  },
577
- "devops:project:list": {
559
+ "devops:pipeline:create": {
578
560
  "aliases": [],
579
561
  "args": {},
580
- "description": "This command queries the DevopsProject standard object and returns the project Id, Name, and Description for each project found.",
562
+ "description": "Provide the URL of an existing repository, or use `--create-repo` with a repository name to create one. After you create the pipeline, add stages, and activate the pipeline.",
581
563
  "examples": [
582
- "List all DevOps Center projects in an org with alias \"my-devops-org\":\n<%= config.bin %> <%= command.id %> --target-org my-devops-org",
583
- "List projects using an org's username:\n<%= config.bin %> <%= command.id %> --target-org devops-center@example.com"
564
+ "Create a pipeline and associate it with an existing GitHub repository:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"Release Pipeline\" --repo https://github.com/myorg/myrepo",
565
+ "Create a pipeline and associate it with a new GitHub repository:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"Release Pipeline\" --repo my-new-repo --repo-type github --repo-owner myorg --create-repo",
566
+ "Create a pipeline and create a new Bitbucket repository:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"Release Pipeline\" --repo my-new-repo --repo-type bitbucket --bitbucket-workspace myworkspace --bitbucket-project-key PROJ --create-repo",
567
+ "Create a pipeline and associate it with an existing Bitbucket repository:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"Release Pipeline\" --repo https://bitbucket.org/myworkspace/myrepo",
568
+ "Create a pipeline with custom stage names instead of the default stages:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"Release Pipeline\" --repo https://github.com/myorg/myrepo --stage Dev --stage QA --stage Prod",
569
+ "Create a pipeline and associate one or more projects with it:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"Release Pipeline\" --repo https://github.com/myorg/myrepo --project-id 0Hn000000000001 --project-id 0Hn000000000002"
584
570
  ],
585
571
  "flags": {
586
572
  "json": {
@@ -614,35 +600,103 @@
614
600
  "hasDynamicHelp": false,
615
601
  "multiple": false,
616
602
  "type": "option"
603
+ },
604
+ "name": {
605
+ "char": "n",
606
+ "name": "name",
607
+ "required": true,
608
+ "summary": "Name of the pipeline.",
609
+ "hasDynamicHelp": false,
610
+ "multiple": false,
611
+ "type": "option"
612
+ },
613
+ "repo": {
614
+ "char": "r",
615
+ "name": "repo",
616
+ "required": true,
617
+ "summary": "URL of an existing repository or the name of a repository to create.",
618
+ "hasDynamicHelp": false,
619
+ "multiple": false,
620
+ "type": "option"
621
+ },
622
+ "repo-type": {
623
+ "name": "repo-type",
624
+ "summary": "Type of the source code repository. Required when creating a repository using '--create-repo'.",
625
+ "hasDynamicHelp": false,
626
+ "multiple": false,
627
+ "options": [
628
+ "github",
629
+ "bitbucket"
630
+ ],
631
+ "type": "option"
632
+ },
633
+ "create-repo": {
634
+ "name": "create-repo",
635
+ "summary": "Create a repository if it doesn't exist.",
636
+ "allowNo": false,
637
+ "type": "boolean"
638
+ },
639
+ "repo-owner": {
640
+ "name": "repo-owner",
641
+ "summary": "Owner (organization or user) of the GitHub repository. Required when creating a GitHub repository using '--create-repo'.",
642
+ "hasDynamicHelp": false,
643
+ "multiple": false,
644
+ "type": "option"
645
+ },
646
+ "bitbucket-workspace": {
647
+ "name": "bitbucket-workspace",
648
+ "summary": "Bitbucket workspace that will own the repository. Required when creating a Bitbucket repository using '--create-repo'.",
649
+ "hasDynamicHelp": false,
650
+ "multiple": false,
651
+ "type": "option"
652
+ },
653
+ "bitbucket-project-key": {
654
+ "name": "bitbucket-project-key",
655
+ "summary": "Bitbucket project key to associate with the repository. Optional when creating a Bitbucket repository using '--create-repo'.",
656
+ "hasDynamicHelp": false,
657
+ "multiple": false,
658
+ "type": "option"
659
+ },
660
+ "stage": {
661
+ "char": "s",
662
+ "name": "stage",
663
+ "summary": "Name of a pipeline stage, in promotion order. Repeat the flag for each stage. Defaults to Integration, UAT, Staging, and Production.",
664
+ "hasDynamicHelp": false,
665
+ "multiple": true,
666
+ "type": "option"
667
+ },
668
+ "project-id": {
669
+ "name": "project-id",
670
+ "summary": "ID of a project to associate with the pipeline. Repeat the flag to associate multiple projects.",
671
+ "hasDynamicHelp": false,
672
+ "multiple": true,
673
+ "type": "option"
617
674
  }
618
675
  },
619
676
  "hasDynamicHelp": true,
620
677
  "hiddenAliases": [],
621
- "id": "devops:project:list",
678
+ "id": "devops:pipeline:create",
622
679
  "pluginAlias": "@salesforce/plugin-devops-center",
623
680
  "pluginName": "@salesforce/plugin-devops-center",
624
681
  "pluginType": "core",
625
682
  "strict": true,
626
- "summary": "List all DevOps Center projects in a Salesforce org.",
683
+ "summary": "Create a DevOps Center pipeline.",
627
684
  "enableJsonFlag": true,
628
685
  "isESM": true,
629
686
  "relativePath": [
630
687
  "lib",
631
688
  "commands",
632
689
  "devops",
633
- "project",
634
- "list.js"
690
+ "pipeline",
691
+ "create.js"
635
692
  ]
636
693
  },
637
- "devops:project:update": {
694
+ "devops:pipeline:get": {
638
695
  "aliases": [],
639
696
  "args": {},
640
- "description": "Update the name, description, or active status of a DevOps Center project. At least one of --name, --description, or --is-active must be provided.",
697
+ "description": "Returns full details for a single DevOps Center pipeline: its stages in order, the source code repository and branch associated with each stage, and any connected projects.",
641
698
  "examples": [
642
- "Rename a project:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --name \"MyApp Release v2\"",
643
- "Update the description of a project:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --description \"Updated release description\"",
644
- "Deactivate a project:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --no-is-active",
645
- "Update all fields at once:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --name \"Archived App\" --description \"Archived\" --no-is-active"
699
+ "Get details for a specific pipeline:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Do000000000001"
646
700
  ],
647
701
  "flags": {
648
702
  "json": {
@@ -677,64 +731,40 @@
677
731
  "multiple": false,
678
732
  "type": "option"
679
733
  },
680
- "project-id": {
734
+ "pipeline-id": {
681
735
  "char": "i",
682
- "name": "project-id",
736
+ "name": "pipeline-id",
683
737
  "required": true,
684
- "summary": "ID of the DevOps Center project to update.",
685
- "hasDynamicHelp": false,
686
- "multiple": false,
687
- "type": "option"
688
- },
689
- "name": {
690
- "char": "n",
691
- "name": "name",
692
- "summary": "New name for the project.",
693
- "hasDynamicHelp": false,
694
- "multiple": false,
695
- "type": "option"
696
- },
697
- "description": {
698
- "char": "d",
699
- "name": "description",
700
- "summary": "New description for the project.",
738
+ "summary": "ID of the DevOps Center pipeline.",
701
739
  "hasDynamicHelp": false,
702
740
  "multiple": false,
703
741
  "type": "option"
704
- },
705
- "is-active": {
706
- "name": "is-active",
707
- "summary": "Set the project active status. Use --is-active to activate or --no-is-active to deactivate.",
708
- "allowNo": true,
709
- "type": "boolean"
710
742
  }
711
743
  },
712
744
  "hasDynamicHelp": true,
713
745
  "hiddenAliases": [],
714
- "id": "devops:project:update",
746
+ "id": "devops:pipeline:get",
715
747
  "pluginAlias": "@salesforce/plugin-devops-center",
716
748
  "pluginName": "@salesforce/plugin-devops-center",
717
749
  "pluginType": "core",
718
750
  "strict": true,
719
- "summary": "Update a DevOps Center project.",
751
+ "summary": "Get details of a DevOps Center pipeline including its stages, repositories, and connected projects.",
720
752
  "enableJsonFlag": true,
721
753
  "isESM": true,
722
754
  "relativePath": [
723
755
  "lib",
724
756
  "commands",
725
757
  "devops",
726
- "project",
727
- "update.js"
758
+ "pipeline",
759
+ "get.js"
728
760
  ]
729
761
  },
730
- "devops:promotion:complete": {
762
+ "devops:pipeline:list": {
731
763
  "aliases": [],
732
764
  "args": {},
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.",
765
+ "description": "Returns all DevOps Center pipelines in the org, including each pipeline's stages (in order), source code repository information per stage, and any connected projects.",
734
766
  "examples": [
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"
767
+ "List all pipelines in the org:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org"
738
768
  ],
739
769
  "flags": {
740
770
  "json": {
@@ -768,82 +798,33 @@
768
798
  "hasDynamicHelp": false,
769
799
  "multiple": false,
770
800
  "type": "option"
771
- },
772
- "target-stage-id": {
773
- "char": "t",
774
- "name": "target-stage-id",
775
- "required": true,
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.",
803
- "hasDynamicHelp": false,
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,
819
- "type": "option"
820
801
  }
821
802
  },
822
803
  "hasDynamicHelp": true,
823
804
  "hiddenAliases": [],
824
- "id": "devops:promotion:complete",
805
+ "id": "devops:pipeline:list",
825
806
  "pluginAlias": "@salesforce/plugin-devops-center",
826
807
  "pluginName": "@salesforce/plugin-devops-center",
827
808
  "pluginType": "core",
828
809
  "strict": true,
829
- "summary": "Deploy undeployed work items to a pipeline stage org.",
810
+ "summary": "List DevOps Center pipelines with their stages, repositories, and connected projects.",
830
811
  "enableJsonFlag": true,
831
812
  "isESM": true,
832
813
  "relativePath": [
833
814
  "lib",
834
815
  "commands",
835
816
  "devops",
836
- "promotion",
837
- "complete.js"
817
+ "pipeline",
818
+ "list.js"
838
819
  ]
839
820
  },
840
- "devops:promotion:validate": {
821
+ "devops:pipeline:update": {
841
822
  "aliases": [],
842
823
  "args": {},
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.",
824
+ "description": "Activate, deactivate, or rename a DevOps Center pipeline. Use --activate to activate, --deactivate to deactivate, and --name to rename. You can combine --deactivate and --name in one command.\n\nA pipeline must have at least one stage before you can activate it. You can't modify the pipeline stages after you activate and promote changes through it.",
844
825
  "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"
826
+ "Activate a pipeline:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --activate",
827
+ "Deactivate and rename in one step.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --deactivate --name \"My Pipeline\""
847
828
  ],
848
829
  "flags": {
849
830
  "json": {
@@ -878,41 +859,60 @@
878
859
  "multiple": false,
879
860
  "type": "option"
880
861
  },
881
- "target-stage-id": {
882
- "char": "t",
883
- "name": "target-stage-id",
862
+ "pipeline-id": {
863
+ "name": "pipeline-id",
884
864
  "required": true,
885
- "summary": "ID of the target pipeline stage to validate promotion to.",
865
+ "summary": "ID of the pipeline.",
886
866
  "hasDynamicHelp": false,
887
867
  "multiple": false,
888
868
  "type": "option"
889
869
  },
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.",
870
+ "activate": {
871
+ "exclusive": [
872
+ "deactivate"
873
+ ],
874
+ "name": "activate",
875
+ "required": false,
876
+ "summary": "Activate the pipeline. Can't be used with --deactivate.",
877
+ "allowNo": false,
878
+ "type": "boolean"
879
+ },
880
+ "deactivate": {
881
+ "exclusive": [
882
+ "activate"
883
+ ],
884
+ "name": "deactivate",
885
+ "required": false,
886
+ "summary": "Deactivate the pipeline. Can't be used with --activate.",
887
+ "allowNo": false,
888
+ "type": "boolean"
889
+ },
890
+ "name": {
891
+ "char": "n",
892
+ "name": "name",
893
+ "required": false,
894
+ "summary": "New name for the pipeline.",
895
895
  "hasDynamicHelp": false,
896
- "multiple": true,
896
+ "multiple": false,
897
897
  "type": "option"
898
898
  }
899
899
  },
900
900
  "hasDynamicHelp": true,
901
901
  "hiddenAliases": [],
902
- "id": "devops:promotion:validate",
902
+ "id": "devops:pipeline:update",
903
903
  "pluginAlias": "@salesforce/plugin-devops-center",
904
904
  "pluginName": "@salesforce/plugin-devops-center",
905
905
  "pluginType": "core",
906
906
  "strict": true,
907
- "summary": "Validate work item promotion for a pipeline stage.",
907
+ "summary": "Update a DevOps Center pipeline.",
908
908
  "enableJsonFlag": true,
909
909
  "isESM": true,
910
910
  "relativePath": [
911
911
  "lib",
912
912
  "commands",
913
913
  "devops",
914
- "promotion",
915
- "validate.js"
914
+ "pipeline",
915
+ "update.js"
916
916
  ]
917
917
  },
918
918
  "devops:request:status": {
@@ -2809,5 +2809,5 @@
2809
2809
  ]
2810
2810
  }
2811
2811
  },
2812
- "version": "2.3.0"
2812
+ "version": "2.3.2"
2813
2813
  }