@salesforce/plugin-devops-center 1.4.0 → 1.4.1

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 (149) hide show
  1. package/README.md +592 -55
  2. package/lib/commands/devops/pipeline/{activate.d.ts → get.d.ts} +3 -3
  3. package/lib/commands/devops/pipeline/get.js +81 -0
  4. package/lib/commands/devops/pipeline/get.js.map +1 -0
  5. package/lib/commands/devops/pipeline/list.d.ts +13 -0
  6. package/lib/commands/devops/pipeline/list.js +58 -0
  7. package/lib/commands/devops/pipeline/list.js.map +1 -0
  8. package/lib/commands/devops/pipeline/project/delete.d.ts +15 -0
  9. package/lib/commands/devops/pipeline/project/delete.js +71 -0
  10. package/lib/commands/devops/pipeline/project/delete.js.map +1 -0
  11. package/lib/commands/devops/pipeline/stage/delete.d.ts +15 -0
  12. package/lib/commands/devops/pipeline/stage/delete.js +69 -0
  13. package/lib/commands/devops/pipeline/stage/delete.js.map +1 -0
  14. package/lib/commands/devops/pipeline/update.d.ts +18 -0
  15. package/lib/commands/devops/pipeline/update.js +126 -0
  16. package/lib/commands/devops/pipeline/update.js.map +1 -0
  17. package/lib/commands/devops/project/update.d.ts +17 -0
  18. package/lib/commands/devops/project/update.js +86 -0
  19. package/lib/commands/devops/project/update.js.map +1 -0
  20. package/lib/commands/devops/promote.d.ts +24 -0
  21. package/lib/commands/devops/promote.js +148 -0
  22. package/lib/commands/devops/promote.js.map +1 -0
  23. package/lib/commands/devops/promotion/complete.d.ts +20 -0
  24. package/lib/commands/devops/promotion/complete.js +112 -0
  25. package/lib/commands/devops/promotion/complete.js.map +1 -0
  26. package/lib/commands/devops/request/status.d.ts +14 -0
  27. package/lib/commands/devops/request/status.js +71 -0
  28. package/lib/commands/devops/request/status.js.map +1 -0
  29. package/lib/commands/devops/{pull-request → review}/create.d.ts +1 -1
  30. package/lib/commands/devops/{pull-request → review}/create.js +3 -3
  31. package/lib/commands/devops/review/create.js.map +1 -0
  32. package/lib/commands/devops/stage/environment/add.js +2 -0
  33. package/lib/commands/devops/stage/environment/add.js.map +1 -1
  34. package/lib/commands/devops/stage/environment/delete.d.ts +15 -0
  35. package/lib/commands/devops/{pipeline/activate.js → stage/environment/delete.js} +18 -30
  36. package/lib/commands/devops/stage/environment/delete.js.map +1 -0
  37. package/lib/commands/devops/work-item/combine.d.ts +15 -0
  38. package/lib/commands/devops/work-item/combine.js +109 -0
  39. package/lib/commands/devops/work-item/combine.js.map +1 -0
  40. package/lib/commands/devops/work-item/prepare.d.ts +14 -0
  41. package/lib/commands/devops/work-item/prepare.js +98 -0
  42. package/lib/commands/devops/work-item/prepare.js.map +1 -0
  43. package/lib/common/flags/promote/promoteFlags.d.ts +1 -0
  44. package/lib/common/flags/promote/promoteFlags.js +5 -0
  45. package/lib/common/flags/promote/promoteFlags.js.map +1 -1
  46. package/lib/common/outputService/aorOutputService.js +4 -4
  47. package/lib/common/outputService/aorOutputService.js.map +1 -1
  48. package/lib/common/outputService/outputUtils.js +1 -2
  49. package/lib/common/outputService/outputUtils.js.map +1 -1
  50. package/lib/common/selectors/asyncOperationResultsSelector.js +3 -1
  51. package/lib/common/selectors/asyncOperationResultsSelector.js.map +1 -1
  52. package/lib/common/selectors/deployComponentsSelector.js +5 -6
  53. package/lib/common/selectors/deployComponentsSelector.js.map +1 -1
  54. package/lib/common/selectors/deployProgressSummarySelector.js +3 -1
  55. package/lib/common/selectors/deployProgressSummarySelector.js.map +1 -1
  56. package/lib/common/selectors/deploymentResultsSelector.js +10 -6
  57. package/lib/common/selectors/deploymentResultsSelector.js.map +1 -1
  58. package/lib/common/selectors/environmentSelector.js +4 -2
  59. package/lib/common/selectors/environmentSelector.js.map +1 -1
  60. package/lib/common/selectors/namedCredentialSelector.js +2 -1
  61. package/lib/common/selectors/namedCredentialSelector.js.map +1 -1
  62. package/lib/common/selectors/pipelineStageSelector.js +5 -3
  63. package/lib/common/selectors/pipelineStageSelector.js.map +1 -1
  64. package/lib/common/selectors/validateDeploySelector.js +3 -1
  65. package/lib/common/selectors/validateDeploySelector.js.map +1 -1
  66. package/lib/common/selectors/workItemSelector.js +4 -1
  67. package/lib/common/selectors/workItemSelector.js.map +1 -1
  68. package/lib/utils/activatePipeline.d.ts +13 -4
  69. package/lib/utils/activatePipeline.js +7 -6
  70. package/lib/utils/activatePipeline.js.map +1 -1
  71. package/lib/utils/attachProject.js +2 -0
  72. package/lib/utils/attachProject.js.map +1 -1
  73. package/lib/utils/combineWorkItems.d.ts +20 -0
  74. package/lib/utils/combineWorkItems.js +42 -0
  75. package/lib/utils/combineWorkItems.js.map +1 -0
  76. package/lib/utils/createPullRequest.js +2 -1
  77. package/lib/utils/createPullRequest.js.map +1 -1
  78. package/lib/utils/deletePipelineStage.d.ts +12 -0
  79. package/lib/utils/deletePipelineStage.js +41 -0
  80. package/lib/utils/deletePipelineStage.js.map +1 -0
  81. package/lib/utils/deleteStageEnvironment.d.ts +8 -0
  82. package/lib/utils/deleteStageEnvironment.js +33 -0
  83. package/lib/utils/deleteStageEnvironment.js.map +1 -0
  84. package/lib/utils/deployStage.d.ts +29 -0
  85. package/lib/utils/deployStage.js +68 -0
  86. package/lib/utils/deployStage.js.map +1 -0
  87. package/lib/utils/detachProject.d.ts +8 -0
  88. package/lib/utils/detachProject.js +37 -0
  89. package/lib/utils/detachProject.js.map +1 -0
  90. package/lib/utils/getPipeline.d.ts +27 -0
  91. package/lib/utils/getPipeline.js +66 -0
  92. package/lib/utils/getPipeline.js.map +1 -0
  93. package/lib/utils/getRequestStatus.d.ts +10 -0
  94. package/lib/utils/getRequestStatus.js +32 -0
  95. package/lib/utils/getRequestStatus.js.map +1 -0
  96. package/lib/utils/listPipelines.d.ts +11 -0
  97. package/lib/utils/listPipelines.js +20 -0
  98. package/lib/utils/listPipelines.js.map +1 -0
  99. package/lib/utils/pipelineUtils.js +3 -0
  100. package/lib/utils/pipelineUtils.js.map +1 -1
  101. package/lib/utils/prepareWorkItem.d.ts +25 -0
  102. package/lib/utils/prepareWorkItem.js +55 -0
  103. package/lib/utils/prepareWorkItem.js.map +1 -0
  104. package/lib/utils/promoteStage.d.ts +21 -0
  105. package/lib/utils/promoteStage.js +46 -0
  106. package/lib/utils/promoteStage.js.map +1 -0
  107. package/lib/utils/soqlUtils.d.ts +23 -0
  108. package/lib/utils/soqlUtils.js +63 -0
  109. package/lib/utils/soqlUtils.js.map +1 -0
  110. package/lib/utils/updateProject.d.ts +17 -0
  111. package/lib/utils/updateProject.js +41 -0
  112. package/lib/utils/updateProject.js.map +1 -0
  113. package/lib/utils/updateWorkItem.js +3 -1
  114. package/lib/utils/updateWorkItem.js.map +1 -1
  115. package/lib/utils/workItems.js +2 -0
  116. package/lib/utils/workItems.js.map +1 -1
  117. package/messages/devops.pipeline.get.md +17 -0
  118. package/messages/devops.pipeline.list.md +13 -0
  119. package/messages/devops.pipeline.project.delete.md +25 -0
  120. package/messages/devops.pipeline.stage.delete.md +25 -0
  121. package/messages/devops.pipeline.update.md +47 -0
  122. package/messages/devops.project.update.md +45 -0
  123. package/messages/devops.promote.md +61 -0
  124. package/messages/devops.promotion.complete.md +47 -0
  125. package/messages/devops.request.status.md +21 -0
  126. package/messages/devops.stage.environment.delete.md +29 -0
  127. package/messages/devops.work-item.combine.md +39 -0
  128. package/messages/devops.work-item.prepare.md +27 -0
  129. package/npm-shrinkwrap.json +37 -174
  130. package/oclif.lock +1 -1
  131. package/oclif.manifest.json +997 -63
  132. package/package.json +20 -8
  133. package/schemas/devops-pipeline-get.json +98 -0
  134. package/schemas/devops-pipeline-list.json +38 -0
  135. package/schemas/devops-pipeline-project-delete.json +25 -0
  136. package/schemas/devops-pipeline-stage-delete.json +25 -0
  137. package/schemas/{devops-pipeline-activate.json → devops-pipeline-update.json} +5 -2
  138. package/schemas/devops-project-update.json +31 -0
  139. package/schemas/devops-promote.json +28 -0
  140. package/schemas/devops-promotion-complete.json +34 -0
  141. package/schemas/devops-request-status.json +31 -0
  142. package/schemas/devops-stage-environment-delete.json +25 -0
  143. package/schemas/devops-work__item-combine.json +25 -0
  144. package/schemas/devops-work__item-prepare.json +25 -0
  145. package/lib/commands/devops/pipeline/activate.js.map +0 -1
  146. package/lib/commands/devops/pull-request/create.js.map +0 -1
  147. package/messages/devops.pipeline.activate.md +0 -29
  148. /package/messages/{devops.pull-request.create.md → devops.review.create.md} +0 -0
  149. /package/schemas/{devops-pull__request-create.json → devops-review-create.json} +0 -0
@@ -1,5 +1,131 @@
1
1
  {
2
2
  "commands": {
3
+ "devops:promote": {
4
+ "aliases": [],
5
+ "args": {},
6
+ "description": "Promote specific work items or all approved work items from a source stage to the target pipeline stage.\n\nPass --work-item-id to promote one or more specific work items to the target stage.\n\nPass --stage-id to promote all approved work items from that source stage to the target stage.\n\nExactly one of --work-item-id or --stage-id must be provided.\n\nUse --deploy-all to deploy all metadata in the branch rather than only changes not yet in the target stage.",
7
+ "examples": [
8
+ "Promote all approved work items from a source stage to a target stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --stage-id 1QVxx0000000001 --target-stage-id 1QVxx0000000002",
9
+ "Promote a specific work item to a stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-id 1fkxx0000000001 --target-stage-id 1QVxx0000000001",
10
+ "Promote multiple work items:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-id 1fkxx0000000001 --work-item-id 1fkxx0000000002 --target-stage-id 1QVxx0000000001",
11
+ "Promote a stage with full deploy:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --stage-id 1QVxx0000000001 --target-stage-id 1QVxx0000000002 --deploy-all"
12
+ ],
13
+ "flags": {
14
+ "json": {
15
+ "description": "Format output as json.",
16
+ "helpGroup": "GLOBAL",
17
+ "name": "json",
18
+ "allowNo": false,
19
+ "type": "boolean"
20
+ },
21
+ "flags-dir": {
22
+ "helpGroup": "GLOBAL",
23
+ "name": "flags-dir",
24
+ "summary": "Import flag values from a directory.",
25
+ "hasDynamicHelp": false,
26
+ "multiple": false,
27
+ "type": "option"
28
+ },
29
+ "target-org": {
30
+ "char": "o",
31
+ "name": "target-org",
32
+ "noCacheDefault": true,
33
+ "required": true,
34
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
35
+ "hasDynamicHelp": true,
36
+ "multiple": false,
37
+ "type": "option"
38
+ },
39
+ "api-version": {
40
+ "description": "Override the api version used for api requests made by this command",
41
+ "name": "api-version",
42
+ "hasDynamicHelp": false,
43
+ "multiple": false,
44
+ "type": "option"
45
+ },
46
+ "target-stage-id": {
47
+ "char": "t",
48
+ "name": "target-stage-id",
49
+ "required": true,
50
+ "summary": "ID of the pipeline stage to promote to.",
51
+ "hasDynamicHelp": false,
52
+ "multiple": false,
53
+ "type": "option"
54
+ },
55
+ "work-item-id": {
56
+ "char": "i",
57
+ "description": "Specify this flag multiple times to promote multiple work items in a single operation.",
58
+ "exclusive": [
59
+ "stage-id"
60
+ ],
61
+ "name": "work-item-id",
62
+ "required": false,
63
+ "summary": "ID of the work item to promote. Mutually exclusive with --stage-id.",
64
+ "hasDynamicHelp": false,
65
+ "multiple": true,
66
+ "type": "option"
67
+ },
68
+ "stage-id": {
69
+ "char": "s",
70
+ "exclusive": [
71
+ "work-item-id"
72
+ ],
73
+ "name": "stage-id",
74
+ "required": false,
75
+ "summary": "ID of the source pipeline stage whose approved work items will be promoted. Mutually exclusive with --work-item-id.",
76
+ "hasDynamicHelp": false,
77
+ "multiple": false,
78
+ "type": "option"
79
+ },
80
+ "deploy-all": {
81
+ "char": "a",
82
+ "description": "If you don’t specify this flag, only changes in the stage’s branch are deployed.",
83
+ "name": "deploy-all",
84
+ "summary": "Deploy all metadata in the branch to the stage's org.",
85
+ "allowNo": false,
86
+ "type": "boolean"
87
+ },
88
+ "test-level": {
89
+ "char": "l",
90
+ "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)",
91
+ "name": "test-level",
92
+ "summary": "Deployment Apex testing level.",
93
+ "hasDynamicHelp": false,
94
+ "multiple": false,
95
+ "options": [
96
+ "NoTestRun",
97
+ "RunSpecifiedTests",
98
+ "RunLocalTests",
99
+ "RunAllTestsInOrg"
100
+ ],
101
+ "type": "option"
102
+ },
103
+ "tests": {
104
+ "description": "Separate multiple test names with commas. Enclose the entire flag value in double quotes if a test name contains spaces.",
105
+ "name": "tests",
106
+ "summary": "Apex tests to run when --test-level is RunSpecifiedTests.",
107
+ "hasDynamicHelp": false,
108
+ "multiple": true,
109
+ "type": "option"
110
+ }
111
+ },
112
+ "hasDynamicHelp": true,
113
+ "hiddenAliases": [],
114
+ "id": "devops:promote",
115
+ "pluginAlias": "@salesforce/plugin-devops-center",
116
+ "pluginName": "@salesforce/plugin-devops-center",
117
+ "pluginType": "core",
118
+ "strict": true,
119
+ "summary": "Promote work items or a pipeline stage to a target pipeline stage.",
120
+ "enableJsonFlag": true,
121
+ "isESM": true,
122
+ "relativePath": [
123
+ "lib",
124
+ "commands",
125
+ "devops",
126
+ "promote.js"
127
+ ]
128
+ },
3
129
  "devops:project:create": {
4
130
  "aliases": [],
5
131
  "args": {},
@@ -137,12 +263,15 @@
137
263
  "list.js"
138
264
  ]
139
265
  },
140
- "devops:pipeline:activate": {
266
+ "devops:project:update": {
141
267
  "aliases": [],
142
268
  "args": {},
143
- "description": "A pipeline must have at least one stage before you activate it. You can't modify the pipeline stages after you activate and promote changes through it.",
269
+ "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.",
144
270
  "examples": [
145
- "Activate a pipeline using the pipeline ID.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001"
271
+ "Rename a project:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --name \"MyApp Release v2\"",
272
+ "Update the description of a project:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --description \"Updated release description\"",
273
+ "Deactivate a project:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --no-is-active",
274
+ "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"
146
275
  ],
147
276
  "flags": {
148
277
  "json": {
@@ -177,31 +306,54 @@
177
306
  "multiple": false,
178
307
  "type": "option"
179
308
  },
180
- "pipeline-id": {
181
- "name": "pipeline-id",
309
+ "project-id": {
310
+ "char": "i",
311
+ "name": "project-id",
182
312
  "required": true,
183
- "summary": "ID of the pipeline.",
313
+ "summary": "ID of the DevOps Center project to update.",
314
+ "hasDynamicHelp": false,
315
+ "multiple": false,
316
+ "type": "option"
317
+ },
318
+ "name": {
319
+ "char": "n",
320
+ "name": "name",
321
+ "summary": "New name for the project.",
184
322
  "hasDynamicHelp": false,
185
323
  "multiple": false,
186
324
  "type": "option"
325
+ },
326
+ "description": {
327
+ "char": "d",
328
+ "name": "description",
329
+ "summary": "New description for the project.",
330
+ "hasDynamicHelp": false,
331
+ "multiple": false,
332
+ "type": "option"
333
+ },
334
+ "is-active": {
335
+ "name": "is-active",
336
+ "summary": "Set the project active status. Use --is-active to activate or --no-is-active to deactivate.",
337
+ "allowNo": true,
338
+ "type": "boolean"
187
339
  }
188
340
  },
189
341
  "hasDynamicHelp": true,
190
342
  "hiddenAliases": [],
191
- "id": "devops:pipeline:activate",
343
+ "id": "devops:project:update",
192
344
  "pluginAlias": "@salesforce/plugin-devops-center",
193
345
  "pluginName": "@salesforce/plugin-devops-center",
194
346
  "pluginType": "core",
195
347
  "strict": true,
196
- "summary": "Activate a DevOps Center pipeline for deployments.",
348
+ "summary": "Update a DevOps Center project.",
197
349
  "enableJsonFlag": true,
198
350
  "isESM": true,
199
351
  "relativePath": [
200
352
  "lib",
201
353
  "commands",
202
354
  "devops",
203
- "pipeline",
204
- "activate.js"
355
+ "project",
356
+ "update.js"
205
357
  ]
206
358
  },
207
359
  "devops:pipeline:create": {
@@ -330,13 +482,12 @@
330
482
  "create.js"
331
483
  ]
332
484
  },
333
- "devops:pull-request:create": {
485
+ "devops:pipeline:get": {
334
486
  "aliases": [],
335
487
  "args": {},
336
- "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.",
488
+ "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.",
337
489
  "examples": [
338
- "Create a pull request for a work item.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-name WI-000001",
339
- "Create a pull request using the work item ID.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-id 0Wx000000000001"
490
+ "Get details for a specific pipeline:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Do000000000001"
340
491
  ],
341
492
  "flags": {
342
493
  "json": {
@@ -371,18 +522,70 @@
371
522
  "multiple": false,
372
523
  "type": "option"
373
524
  },
374
- "work-item-name": {
375
- "char": "n",
376
- "name": "work-item-name",
377
- "summary": "Name of the work item, such as WI-000001.",
525
+ "pipeline-id": {
526
+ "char": "i",
527
+ "name": "pipeline-id",
528
+ "required": true,
529
+ "summary": "ID of the DevOps Center pipeline.",
530
+ "hasDynamicHelp": false,
531
+ "multiple": false,
532
+ "type": "option"
533
+ }
534
+ },
535
+ "hasDynamicHelp": true,
536
+ "hiddenAliases": [],
537
+ "id": "devops:pipeline:get",
538
+ "pluginAlias": "@salesforce/plugin-devops-center",
539
+ "pluginName": "@salesforce/plugin-devops-center",
540
+ "pluginType": "core",
541
+ "strict": true,
542
+ "summary": "Get details of a DevOps Center pipeline including its stages, repositories, and connected projects.",
543
+ "enableJsonFlag": true,
544
+ "isESM": true,
545
+ "relativePath": [
546
+ "lib",
547
+ "commands",
548
+ "devops",
549
+ "pipeline",
550
+ "get.js"
551
+ ]
552
+ },
553
+ "devops:pipeline:list": {
554
+ "aliases": [],
555
+ "args": {},
556
+ "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.",
557
+ "examples": [
558
+ "List all pipelines in the org:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org"
559
+ ],
560
+ "flags": {
561
+ "json": {
562
+ "description": "Format output as json.",
563
+ "helpGroup": "GLOBAL",
564
+ "name": "json",
565
+ "allowNo": false,
566
+ "type": "boolean"
567
+ },
568
+ "flags-dir": {
569
+ "helpGroup": "GLOBAL",
570
+ "name": "flags-dir",
571
+ "summary": "Import flag values from a directory.",
378
572
  "hasDynamicHelp": false,
379
573
  "multiple": false,
380
574
  "type": "option"
381
575
  },
382
- "work-item-id": {
383
- "char": "w",
384
- "name": "work-item-id",
385
- "summary": "ID of the work item.",
576
+ "target-org": {
577
+ "char": "o",
578
+ "name": "target-org",
579
+ "noCacheDefault": true,
580
+ "required": true,
581
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
582
+ "hasDynamicHelp": true,
583
+ "multiple": false,
584
+ "type": "option"
585
+ },
586
+ "api-version": {
587
+ "description": "Override the api version used for api requests made by this command",
588
+ "name": "api-version",
386
589
  "hasDynamicHelp": false,
387
590
  "multiple": false,
388
591
  "type": "option"
@@ -390,29 +593,539 @@
390
593
  },
391
594
  "hasDynamicHelp": true,
392
595
  "hiddenAliases": [],
393
- "id": "devops:pull-request:create",
596
+ "id": "devops:pipeline:list",
394
597
  "pluginAlias": "@salesforce/plugin-devops-center",
395
598
  "pluginName": "@salesforce/plugin-devops-center",
396
599
  "pluginType": "core",
397
600
  "strict": true,
398
- "summary": "Create a pull request for a work item branch.",
601
+ "summary": "List DevOps Center pipelines with their stages, repositories, and connected projects.",
399
602
  "enableJsonFlag": true,
400
603
  "isESM": true,
401
604
  "relativePath": [
402
605
  "lib",
403
606
  "commands",
404
607
  "devops",
405
- "pull-request",
406
- "create.js"
608
+ "pipeline",
609
+ "list.js"
407
610
  ]
408
611
  },
409
- "devops:work-item:create": {
612
+ "devops:pipeline:update": {
410
613
  "aliases": [],
411
614
  "args": {},
412
- "description": "The command creates the work item using the Connect API. Requires a project ID and a subject for the new work item; run the `devops project list` command to get the IDs for all existing projects.",
615
+ "description": "Activate, deactivate, or rename a DevOps Center pipeline. Use --active to activate, --no-active to deactivate, and --name to rename. You can combine --no-active and --name in one command.\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.",
616
+ "examples": [
617
+ "Activate a pipeline:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --active",
618
+ "Deactivate and rename in one step.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --no-active --name \"My Pipeline\""
619
+ ],
620
+ "flags": {
621
+ "json": {
622
+ "description": "Format output as json.",
623
+ "helpGroup": "GLOBAL",
624
+ "name": "json",
625
+ "allowNo": false,
626
+ "type": "boolean"
627
+ },
628
+ "flags-dir": {
629
+ "helpGroup": "GLOBAL",
630
+ "name": "flags-dir",
631
+ "summary": "Import flag values from a directory.",
632
+ "hasDynamicHelp": false,
633
+ "multiple": false,
634
+ "type": "option"
635
+ },
636
+ "target-org": {
637
+ "char": "o",
638
+ "name": "target-org",
639
+ "noCacheDefault": true,
640
+ "required": true,
641
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
642
+ "hasDynamicHelp": true,
643
+ "multiple": false,
644
+ "type": "option"
645
+ },
646
+ "api-version": {
647
+ "description": "Override the api version used for api requests made by this command",
648
+ "name": "api-version",
649
+ "hasDynamicHelp": false,
650
+ "multiple": false,
651
+ "type": "option"
652
+ },
653
+ "pipeline-id": {
654
+ "name": "pipeline-id",
655
+ "required": true,
656
+ "summary": "ID of the pipeline.",
657
+ "hasDynamicHelp": false,
658
+ "multiple": false,
659
+ "type": "option"
660
+ },
661
+ "active": {
662
+ "name": "active",
663
+ "required": false,
664
+ "summary": "Activate the pipeline. Use --no-active to deactivate.",
665
+ "allowNo": true,
666
+ "type": "boolean"
667
+ },
668
+ "name": {
669
+ "char": "n",
670
+ "name": "name",
671
+ "required": false,
672
+ "summary": "New name for the pipeline.",
673
+ "hasDynamicHelp": false,
674
+ "multiple": false,
675
+ "type": "option"
676
+ }
677
+ },
678
+ "hasDynamicHelp": true,
679
+ "hiddenAliases": [],
680
+ "id": "devops:pipeline:update",
681
+ "pluginAlias": "@salesforce/plugin-devops-center",
682
+ "pluginName": "@salesforce/plugin-devops-center",
683
+ "pluginType": "core",
684
+ "strict": true,
685
+ "summary": "Update a DevOps Center pipeline.",
686
+ "enableJsonFlag": true,
687
+ "isESM": true,
688
+ "relativePath": [
689
+ "lib",
690
+ "commands",
691
+ "devops",
692
+ "pipeline",
693
+ "update.js"
694
+ ]
695
+ },
696
+ "devops:promotion:complete": {
697
+ "aliases": [],
698
+ "args": {},
699
+ "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.",
700
+ "examples": [
701
+ "Complete a promotion for an out-of-sync pipeline stage.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --target-stage-id 1QV000000000001",
702
+ "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",
703
+ "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"
704
+ ],
705
+ "flags": {
706
+ "json": {
707
+ "description": "Format output as json.",
708
+ "helpGroup": "GLOBAL",
709
+ "name": "json",
710
+ "allowNo": false,
711
+ "type": "boolean"
712
+ },
713
+ "flags-dir": {
714
+ "helpGroup": "GLOBAL",
715
+ "name": "flags-dir",
716
+ "summary": "Import flag values from a directory.",
717
+ "hasDynamicHelp": false,
718
+ "multiple": false,
719
+ "type": "option"
720
+ },
721
+ "target-org": {
722
+ "char": "o",
723
+ "name": "target-org",
724
+ "noCacheDefault": true,
725
+ "required": true,
726
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
727
+ "hasDynamicHelp": true,
728
+ "multiple": false,
729
+ "type": "option"
730
+ },
731
+ "api-version": {
732
+ "description": "Override the api version used for api requests made by this command",
733
+ "name": "api-version",
734
+ "hasDynamicHelp": false,
735
+ "multiple": false,
736
+ "type": "option"
737
+ },
738
+ "target-stage-id": {
739
+ "char": "t",
740
+ "name": "target-stage-id",
741
+ "required": true,
742
+ "summary": "ID of the out-of-sync pipeline stage to deploy to.",
743
+ "hasDynamicHelp": false,
744
+ "multiple": false,
745
+ "type": "option"
746
+ },
747
+ "work-item-id": {
748
+ "char": "i",
749
+ "name": "work-item-id",
750
+ "required": false,
751
+ "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.",
752
+ "hasDynamicHelp": false,
753
+ "multiple": true,
754
+ "type": "option"
755
+ },
756
+ "deploy-all": {
757
+ "char": "a",
758
+ "description": "If you don’t specify this flag, only changes in the stage’s branch are deployed.",
759
+ "name": "deploy-all",
760
+ "summary": "Deploy all metadata in the branch to the stage's org.",
761
+ "allowNo": false,
762
+ "type": "boolean"
763
+ },
764
+ "test-level": {
765
+ "char": "l",
766
+ "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)",
767
+ "name": "test-level",
768
+ "summary": "Deployment Apex testing level.",
769
+ "hasDynamicHelp": false,
770
+ "multiple": false,
771
+ "options": [
772
+ "NoTestRun",
773
+ "RunSpecifiedTests",
774
+ "RunLocalTests",
775
+ "RunAllTestsInOrg"
776
+ ],
777
+ "type": "option"
778
+ },
779
+ "tests": {
780
+ "description": "Separate multiple test names with commas. Enclose the entire flag value in double quotes if a test name contains spaces.",
781
+ "name": "tests",
782
+ "summary": "Apex tests to run when --test-level is RunSpecifiedTests.",
783
+ "hasDynamicHelp": false,
784
+ "multiple": true,
785
+ "type": "option"
786
+ }
787
+ },
788
+ "hasDynamicHelp": true,
789
+ "hiddenAliases": [],
790
+ "id": "devops:promotion:complete",
791
+ "pluginAlias": "@salesforce/plugin-devops-center",
792
+ "pluginName": "@salesforce/plugin-devops-center",
793
+ "pluginType": "core",
794
+ "strict": true,
795
+ "summary": "Deploy undeployed work items to a pipeline stage org.",
796
+ "enableJsonFlag": true,
797
+ "isESM": true,
798
+ "relativePath": [
799
+ "lib",
800
+ "commands",
801
+ "devops",
802
+ "promotion",
803
+ "complete.js"
804
+ ]
805
+ },
806
+ "devops:request:status": {
807
+ "aliases": [],
808
+ "args": {},
809
+ "description": "Returns the current status of a request identified by its request token.",
810
+ "examples": [
811
+ "Get the status of a request:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --request-token a0B000000000001"
812
+ ],
813
+ "flags": {
814
+ "json": {
815
+ "description": "Format output as json.",
816
+ "helpGroup": "GLOBAL",
817
+ "name": "json",
818
+ "allowNo": false,
819
+ "type": "boolean"
820
+ },
821
+ "flags-dir": {
822
+ "helpGroup": "GLOBAL",
823
+ "name": "flags-dir",
824
+ "summary": "Import flag values from a directory.",
825
+ "hasDynamicHelp": false,
826
+ "multiple": false,
827
+ "type": "option"
828
+ },
829
+ "target-org": {
830
+ "char": "o",
831
+ "name": "target-org",
832
+ "noCacheDefault": true,
833
+ "required": true,
834
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
835
+ "hasDynamicHelp": true,
836
+ "multiple": false,
837
+ "type": "option"
838
+ },
839
+ "api-version": {
840
+ "description": "Override the api version used for api requests made by this command",
841
+ "name": "api-version",
842
+ "hasDynamicHelp": false,
843
+ "multiple": false,
844
+ "type": "option"
845
+ },
846
+ "request-token": {
847
+ "char": "i",
848
+ "name": "request-token",
849
+ "required": true,
850
+ "summary": "Request token from the promote response.",
851
+ "hasDynamicHelp": false,
852
+ "multiple": false,
853
+ "type": "option"
854
+ }
855
+ },
856
+ "hasDynamicHelp": true,
857
+ "hiddenAliases": [],
858
+ "id": "devops:request:status",
859
+ "pluginAlias": "@salesforce/plugin-devops-center",
860
+ "pluginName": "@salesforce/plugin-devops-center",
861
+ "pluginType": "core",
862
+ "strict": true,
863
+ "summary": "Get the status of a request.",
864
+ "enableJsonFlag": true,
865
+ "isESM": true,
866
+ "relativePath": [
867
+ "lib",
868
+ "commands",
869
+ "devops",
870
+ "request",
871
+ "status.js"
872
+ ]
873
+ },
874
+ "devops:review:create": {
875
+ "aliases": [],
876
+ "args": {},
877
+ "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.",
878
+ "examples": [
879
+ "Create a pull request for a work item.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-name WI-000001",
880
+ "Create a pull request using the work item ID.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-id 0Wx000000000001"
881
+ ],
882
+ "flags": {
883
+ "json": {
884
+ "description": "Format output as json.",
885
+ "helpGroup": "GLOBAL",
886
+ "name": "json",
887
+ "allowNo": false,
888
+ "type": "boolean"
889
+ },
890
+ "flags-dir": {
891
+ "helpGroup": "GLOBAL",
892
+ "name": "flags-dir",
893
+ "summary": "Import flag values from a directory.",
894
+ "hasDynamicHelp": false,
895
+ "multiple": false,
896
+ "type": "option"
897
+ },
898
+ "target-org": {
899
+ "char": "o",
900
+ "name": "target-org",
901
+ "noCacheDefault": true,
902
+ "required": true,
903
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
904
+ "hasDynamicHelp": true,
905
+ "multiple": false,
906
+ "type": "option"
907
+ },
908
+ "api-version": {
909
+ "description": "Override the api version used for api requests made by this command",
910
+ "name": "api-version",
911
+ "hasDynamicHelp": false,
912
+ "multiple": false,
913
+ "type": "option"
914
+ },
915
+ "work-item-name": {
916
+ "char": "n",
917
+ "name": "work-item-name",
918
+ "summary": "Name of the work item, such as WI-000001.",
919
+ "hasDynamicHelp": false,
920
+ "multiple": false,
921
+ "type": "option"
922
+ },
923
+ "work-item-id": {
924
+ "char": "w",
925
+ "name": "work-item-id",
926
+ "summary": "ID of the work item.",
927
+ "hasDynamicHelp": false,
928
+ "multiple": false,
929
+ "type": "option"
930
+ }
931
+ },
932
+ "hasDynamicHelp": true,
933
+ "hiddenAliases": [],
934
+ "id": "devops:review:create",
935
+ "pluginAlias": "@salesforce/plugin-devops-center",
936
+ "pluginName": "@salesforce/plugin-devops-center",
937
+ "pluginType": "core",
938
+ "strict": true,
939
+ "summary": "Create a pull request for a work item branch.",
940
+ "enableJsonFlag": true,
941
+ "isESM": true,
942
+ "relativePath": [
943
+ "lib",
944
+ "commands",
945
+ "devops",
946
+ "review",
947
+ "create.js"
948
+ ]
949
+ },
950
+ "devops:work-item:combine": {
951
+ "aliases": [],
952
+ "args": {},
953
+ "description": "Use this command when work items in the same stage share metadata or have dependencies. DevOps Center combines the selected work items so they can be promoted together during custom promotion.\n\nAfter running this command, use \"sf devops work-item promote\" with the parent work item ID to complete the promotion. The combined work items are promoted as a single unit.",
954
+ "examples": [
955
+ "Prepare three work items to be combined to prevent conflicts during promotion:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --parent-work-item-id 0Wx000000000001 --child-work-item-id 0Wx000000000002 --child-work-item-id 0Wx000000000003 --target-stage-id 05S000000000002"
956
+ ],
957
+ "flags": {
958
+ "json": {
959
+ "description": "Format output as json.",
960
+ "helpGroup": "GLOBAL",
961
+ "name": "json",
962
+ "allowNo": false,
963
+ "type": "boolean"
964
+ },
965
+ "flags-dir": {
966
+ "helpGroup": "GLOBAL",
967
+ "name": "flags-dir",
968
+ "summary": "Import flag values from a directory.",
969
+ "hasDynamicHelp": false,
970
+ "multiple": false,
971
+ "type": "option"
972
+ },
973
+ "target-org": {
974
+ "char": "o",
975
+ "name": "target-org",
976
+ "noCacheDefault": true,
977
+ "required": true,
978
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
979
+ "hasDynamicHelp": true,
980
+ "multiple": false,
981
+ "type": "option"
982
+ },
983
+ "api-version": {
984
+ "description": "Override the api version used for api requests made by this command",
985
+ "name": "api-version",
986
+ "hasDynamicHelp": false,
987
+ "multiple": false,
988
+ "type": "option"
989
+ },
990
+ "parent-work-item-id": {
991
+ "description": "The parent work item is the primary work item that continues through the pipeline. Changes from all child work items are merged into the parent's branch during promotion.",
992
+ "name": "parent-work-item-id",
993
+ "required": true,
994
+ "summary": "ID of the parent work item.",
995
+ "hasDynamicHelp": false,
996
+ "multiple": false,
997
+ "type": "option"
998
+ },
999
+ "child-work-item-id": {
1000
+ "description": "Specify this flag multiple times to combine multiple work items with the parent.",
1001
+ "name": "child-work-item-id",
1002
+ "required": true,
1003
+ "summary": "ID of a work item to combine.",
1004
+ "hasDynamicHelp": false,
1005
+ "multiple": true,
1006
+ "type": "option"
1007
+ },
1008
+ "target-stage-id": {
1009
+ "char": "t",
1010
+ "name": "target-stage-id",
1011
+ "required": true,
1012
+ "summary": "ID of the pipeline stage to promote the combined work item to.",
1013
+ "hasDynamicHelp": false,
1014
+ "multiple": false,
1015
+ "type": "option"
1016
+ }
1017
+ },
1018
+ "hasDynamicHelp": true,
1019
+ "hiddenAliases": [],
1020
+ "id": "devops:work-item:combine",
1021
+ "pluginAlias": "@salesforce/plugin-devops-center",
1022
+ "pluginName": "@salesforce/plugin-devops-center",
1023
+ "pluginType": "core",
1024
+ "strict": true,
1025
+ "summary": "Prepare work items to be combined for custom promotion.",
1026
+ "enableJsonFlag": true,
1027
+ "isESM": true,
1028
+ "relativePath": [
1029
+ "lib",
1030
+ "commands",
1031
+ "devops",
1032
+ "work-item",
1033
+ "combine.js"
1034
+ ]
1035
+ },
1036
+ "devops:work-item:create": {
1037
+ "aliases": [],
1038
+ "args": {},
1039
+ "description": "The command creates the work item using the Connect API. Requires a project ID and a subject for the new work item; run the `devops project list` command to get the IDs for all existing projects.",
1040
+ "examples": [
1041
+ "Create a work item for the project with the specified ID and give the work item the specified subject (title); use the DevOps Center org with alias \"my-devops-org\":\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --subject \"Fix login bug\"",
1042
+ "Create a work item with a subject and description:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --subject \"Add dark mode\" --description \"Implement dark mode toggle in settings page\""
1043
+ ],
1044
+ "flags": {
1045
+ "json": {
1046
+ "description": "Format output as json.",
1047
+ "helpGroup": "GLOBAL",
1048
+ "name": "json",
1049
+ "allowNo": false,
1050
+ "type": "boolean"
1051
+ },
1052
+ "flags-dir": {
1053
+ "helpGroup": "GLOBAL",
1054
+ "name": "flags-dir",
1055
+ "summary": "Import flag values from a directory.",
1056
+ "hasDynamicHelp": false,
1057
+ "multiple": false,
1058
+ "type": "option"
1059
+ },
1060
+ "target-org": {
1061
+ "char": "o",
1062
+ "name": "target-org",
1063
+ "noCacheDefault": true,
1064
+ "required": true,
1065
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
1066
+ "hasDynamicHelp": true,
1067
+ "multiple": false,
1068
+ "type": "option"
1069
+ },
1070
+ "api-version": {
1071
+ "description": "Override the api version used for api requests made by this command",
1072
+ "name": "api-version",
1073
+ "hasDynamicHelp": false,
1074
+ "multiple": false,
1075
+ "type": "option"
1076
+ },
1077
+ "project-id": {
1078
+ "char": "p",
1079
+ "name": "project-id",
1080
+ "required": true,
1081
+ "summary": "ID of the DevOps Center project to create the work item in.",
1082
+ "hasDynamicHelp": false,
1083
+ "multiple": false,
1084
+ "type": "option"
1085
+ },
1086
+ "subject": {
1087
+ "char": "s",
1088
+ "name": "subject",
1089
+ "required": true,
1090
+ "summary": "Subject (title) of the new work item.",
1091
+ "hasDynamicHelp": false,
1092
+ "multiple": false,
1093
+ "type": "option"
1094
+ },
1095
+ "description": {
1096
+ "char": "d",
1097
+ "name": "description",
1098
+ "summary": "Description of the new work item; if not specified, the description is blank.",
1099
+ "hasDynamicHelp": false,
1100
+ "multiple": false,
1101
+ "type": "option"
1102
+ }
1103
+ },
1104
+ "hasDynamicHelp": true,
1105
+ "hiddenAliases": [],
1106
+ "id": "devops:work-item:create",
1107
+ "pluginAlias": "@salesforce/plugin-devops-center",
1108
+ "pluginName": "@salesforce/plugin-devops-center",
1109
+ "pluginType": "core",
1110
+ "strict": true,
1111
+ "summary": "Create a new work item in a DevOps Center project.",
1112
+ "enableJsonFlag": true,
1113
+ "isESM": true,
1114
+ "relativePath": [
1115
+ "lib",
1116
+ "commands",
1117
+ "devops",
1118
+ "work-item",
1119
+ "create.js"
1120
+ ]
1121
+ },
1122
+ "devops:work-item:list": {
1123
+ "aliases": [],
1124
+ "args": {},
1125
+ "description": "Each work item displays the branch, environment, and repository details needed for checkout and promotion. Requires a project ID; run the `devops project list` command to get the IDs for all existing projects.",
413
1126
  "examples": [
414
- "Create a work item for the project with the specified ID and give the work item the specified subject (title); use the DevOps Center org with alias \"my-devops-org\":\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --subject \"Fix login bug\"",
415
- "Create a work item with a subject and description:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --subject \"Add dark mode\" --description \"Implement dark mode toggle in settings page\""
1127
+ "List work items for a specific project in the DevOps org with alias \"my-devops-org\":\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001",
1128
+ "List work items using JSON output:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --json"
416
1129
  ],
417
1130
  "flags": {
418
1131
  "json": {
@@ -451,24 +1164,7 @@
451
1164
  "char": "p",
452
1165
  "name": "project-id",
453
1166
  "required": true,
454
- "summary": "ID of the DevOps Center project to create the work item in.",
455
- "hasDynamicHelp": false,
456
- "multiple": false,
457
- "type": "option"
458
- },
459
- "subject": {
460
- "char": "s",
461
- "name": "subject",
462
- "required": true,
463
- "summary": "Subject (title) of the new work item.",
464
- "hasDynamicHelp": false,
465
- "multiple": false,
466
- "type": "option"
467
- },
468
- "description": {
469
- "char": "d",
470
- "name": "description",
471
- "summary": "Description of the new work item; if not specified, the description is blank.",
1167
+ "summary": "ID of the DevOps Center project to list work items for.",
472
1168
  "hasDynamicHelp": false,
473
1169
  "multiple": false,
474
1170
  "type": "option"
@@ -476,12 +1172,12 @@
476
1172
  },
477
1173
  "hasDynamicHelp": true,
478
1174
  "hiddenAliases": [],
479
- "id": "devops:work-item:create",
1175
+ "id": "devops:work-item:list",
480
1176
  "pluginAlias": "@salesforce/plugin-devops-center",
481
1177
  "pluginName": "@salesforce/plugin-devops-center",
482
1178
  "pluginType": "core",
483
1179
  "strict": true,
484
- "summary": "Create a new work item in a DevOps Center project.",
1180
+ "summary": "List all work items for a DevOps Center project.",
485
1181
  "enableJsonFlag": true,
486
1182
  "isESM": true,
487
1183
  "relativePath": [
@@ -489,16 +1185,16 @@
489
1185
  "commands",
490
1186
  "devops",
491
1187
  "work-item",
492
- "create.js"
1188
+ "list.js"
493
1189
  ]
494
1190
  },
495
- "devops:work-item:list": {
1191
+ "devops:work-item:prepare": {
496
1192
  "aliases": [],
497
1193
  "args": {},
498
- "description": "Each work item displays the branch, environment, and repository details needed for checkout and promotion. Requires a project ID; run the `devops project list` command to get the IDs for all existing projects.",
1194
+ "description": "Prepares a work item for one-off promotion by creating the necessary branches and pull requests in the source control repository. Run this command before running \"sf devops work-item promote\" for a one-off promotion.\n\nUse \"sf devops work-item list\" to find the work item ID and target stage ID for a project.",
499
1195
  "examples": [
500
- "List work items for a specific project in the DevOps org with alias \"my-devops-org\":\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001",
501
- "List work items using JSON output:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --json"
1196
+ "Prepare a work item for one-off promotion to the UAT stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-id 0Wx000000000001 --target-stage-id 05S000000000002",
1197
+ "Prepare a work item using a DevOps Center org username:\n<%= config.bin %> <%= command.id %> --target-org devops-center@example.com --work-item-id 0Wx000000000001 --target-stage-id 05S000000000002"
502
1198
  ],
503
1199
  "flags": {
504
1200
  "json": {
@@ -533,11 +1229,20 @@
533
1229
  "multiple": false,
534
1230
  "type": "option"
535
1231
  },
536
- "project-id": {
537
- "char": "p",
538
- "name": "project-id",
1232
+ "work-item-id": {
1233
+ "char": "i",
1234
+ "name": "work-item-id",
539
1235
  "required": true,
540
- "summary": "ID of the DevOps Center project to list work items for.",
1236
+ "summary": "ID of the work item to prepare for one-off promotion.",
1237
+ "hasDynamicHelp": false,
1238
+ "multiple": false,
1239
+ "type": "option"
1240
+ },
1241
+ "target-stage-id": {
1242
+ "char": "t",
1243
+ "name": "target-stage-id",
1244
+ "required": true,
1245
+ "summary": "ID of the pipeline stage to promote the work item to.",
541
1246
  "hasDynamicHelp": false,
542
1247
  "multiple": false,
543
1248
  "type": "option"
@@ -545,12 +1250,12 @@
545
1250
  },
546
1251
  "hasDynamicHelp": true,
547
1252
  "hiddenAliases": [],
548
- "id": "devops:work-item:list",
1253
+ "id": "devops:work-item:prepare",
549
1254
  "pluginAlias": "@salesforce/plugin-devops-center",
550
1255
  "pluginName": "@salesforce/plugin-devops-center",
551
1256
  "pluginType": "core",
552
1257
  "strict": true,
553
- "summary": "List all work items for a DevOps Center project.",
1258
+ "summary": "Prepare a work item for one-off promotion between pipeline stages.",
554
1259
  "enableJsonFlag": true,
555
1260
  "isESM": true,
556
1261
  "relativePath": [
@@ -558,7 +1263,7 @@
558
1263
  "commands",
559
1264
  "devops",
560
1265
  "work-item",
561
- "list.js"
1266
+ "prepare.js"
562
1267
  ]
563
1268
  },
564
1269
  "devops:work-item:update": {
@@ -739,6 +1444,82 @@
739
1444
  "add.js"
740
1445
  ]
741
1446
  },
1447
+ "devops:pipeline:project:delete": {
1448
+ "aliases": [],
1449
+ "args": {},
1450
+ "description": "Deletes the junction record that connects the project to the pipeline. The project itself is not deleted.",
1451
+ "examples": [
1452
+ "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"
1453
+ ],
1454
+ "flags": {
1455
+ "json": {
1456
+ "description": "Format output as json.",
1457
+ "helpGroup": "GLOBAL",
1458
+ "name": "json",
1459
+ "allowNo": false,
1460
+ "type": "boolean"
1461
+ },
1462
+ "flags-dir": {
1463
+ "helpGroup": "GLOBAL",
1464
+ "name": "flags-dir",
1465
+ "summary": "Import flag values from a directory.",
1466
+ "hasDynamicHelp": false,
1467
+ "multiple": false,
1468
+ "type": "option"
1469
+ },
1470
+ "target-org": {
1471
+ "char": "o",
1472
+ "name": "target-org",
1473
+ "noCacheDefault": true,
1474
+ "required": true,
1475
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
1476
+ "hasDynamicHelp": true,
1477
+ "multiple": false,
1478
+ "type": "option"
1479
+ },
1480
+ "api-version": {
1481
+ "description": "Override the api version used for api requests made by this command",
1482
+ "name": "api-version",
1483
+ "hasDynamicHelp": false,
1484
+ "multiple": false,
1485
+ "type": "option"
1486
+ },
1487
+ "pipeline-id": {
1488
+ "name": "pipeline-id",
1489
+ "required": true,
1490
+ "summary": "ID of the pipeline.",
1491
+ "hasDynamicHelp": false,
1492
+ "multiple": false,
1493
+ "type": "option"
1494
+ },
1495
+ "project-id": {
1496
+ "name": "project-id",
1497
+ "required": true,
1498
+ "summary": "ID of the DevOps Center project.",
1499
+ "hasDynamicHelp": false,
1500
+ "multiple": false,
1501
+ "type": "option"
1502
+ }
1503
+ },
1504
+ "hasDynamicHelp": true,
1505
+ "hiddenAliases": [],
1506
+ "id": "devops:pipeline:project:delete",
1507
+ "pluginAlias": "@salesforce/plugin-devops-center",
1508
+ "pluginName": "@salesforce/plugin-devops-center",
1509
+ "pluginType": "core",
1510
+ "strict": true,
1511
+ "summary": "Remove a DevOps Center project's connection to a pipeline.",
1512
+ "enableJsonFlag": true,
1513
+ "isESM": true,
1514
+ "relativePath": [
1515
+ "lib",
1516
+ "commands",
1517
+ "devops",
1518
+ "pipeline",
1519
+ "project",
1520
+ "delete.js"
1521
+ ]
1522
+ },
742
1523
  "devops:pipeline:stage:add": {
743
1524
  "aliases": [],
744
1525
  "args": {},
@@ -825,6 +1606,82 @@
825
1606
  "add.js"
826
1607
  ]
827
1608
  },
1609
+ "devops:pipeline:stage:delete": {
1610
+ "aliases": [],
1611
+ "args": {},
1612
+ "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.",
1613
+ "examples": [
1614
+ "Delete a stage from a pipeline:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --stage-id 0Xc000000000002"
1615
+ ],
1616
+ "flags": {
1617
+ "json": {
1618
+ "description": "Format output as json.",
1619
+ "helpGroup": "GLOBAL",
1620
+ "name": "json",
1621
+ "allowNo": false,
1622
+ "type": "boolean"
1623
+ },
1624
+ "flags-dir": {
1625
+ "helpGroup": "GLOBAL",
1626
+ "name": "flags-dir",
1627
+ "summary": "Import flag values from a directory.",
1628
+ "hasDynamicHelp": false,
1629
+ "multiple": false,
1630
+ "type": "option"
1631
+ },
1632
+ "target-org": {
1633
+ "char": "o",
1634
+ "name": "target-org",
1635
+ "noCacheDefault": true,
1636
+ "required": true,
1637
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
1638
+ "hasDynamicHelp": true,
1639
+ "multiple": false,
1640
+ "type": "option"
1641
+ },
1642
+ "api-version": {
1643
+ "description": "Override the api version used for api requests made by this command",
1644
+ "name": "api-version",
1645
+ "hasDynamicHelp": false,
1646
+ "multiple": false,
1647
+ "type": "option"
1648
+ },
1649
+ "pipeline-id": {
1650
+ "name": "pipeline-id",
1651
+ "required": true,
1652
+ "summary": "ID of the pipeline that contains the stage.",
1653
+ "hasDynamicHelp": false,
1654
+ "multiple": false,
1655
+ "type": "option"
1656
+ },
1657
+ "stage-id": {
1658
+ "name": "stage-id",
1659
+ "required": true,
1660
+ "summary": "ID of the stage to delete.",
1661
+ "hasDynamicHelp": false,
1662
+ "multiple": false,
1663
+ "type": "option"
1664
+ }
1665
+ },
1666
+ "hasDynamicHelp": true,
1667
+ "hiddenAliases": [],
1668
+ "id": "devops:pipeline:stage:delete",
1669
+ "pluginAlias": "@salesforce/plugin-devops-center",
1670
+ "pluginName": "@salesforce/plugin-devops-center",
1671
+ "pluginType": "core",
1672
+ "strict": true,
1673
+ "summary": "Delete a stage from a DevOps Center pipeline.",
1674
+ "enableJsonFlag": true,
1675
+ "isESM": true,
1676
+ "relativePath": [
1677
+ "lib",
1678
+ "commands",
1679
+ "devops",
1680
+ "pipeline",
1681
+ "stage",
1682
+ "delete.js"
1683
+ ]
1684
+ },
828
1685
  "devops:stage:branch:add": {
829
1686
  "aliases": [],
830
1687
  "args": {},
@@ -1020,6 +1877,83 @@
1020
1877
  "add.js"
1021
1878
  ]
1022
1879
  },
1880
+ "devops:stage:environment:delete": {
1881
+ "aliases": [],
1882
+ "args": {},
1883
+ "description": "Removes the specified environment from the pipeline stage. The environment must belong to an inactive pipeline.",
1884
+ "examples": [
1885
+ "Delete an environment:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --environment-id 0Xe000000000001"
1886
+ ],
1887
+ "flags": {
1888
+ "json": {
1889
+ "description": "Format output as json.",
1890
+ "helpGroup": "GLOBAL",
1891
+ "name": "json",
1892
+ "allowNo": false,
1893
+ "type": "boolean"
1894
+ },
1895
+ "flags-dir": {
1896
+ "helpGroup": "GLOBAL",
1897
+ "name": "flags-dir",
1898
+ "summary": "Import flag values from a directory.",
1899
+ "hasDynamicHelp": false,
1900
+ "multiple": false,
1901
+ "type": "option"
1902
+ },
1903
+ "target-org": {
1904
+ "char": "o",
1905
+ "name": "target-org",
1906
+ "noCacheDefault": true,
1907
+ "required": true,
1908
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
1909
+ "hasDynamicHelp": true,
1910
+ "multiple": false,
1911
+ "type": "option"
1912
+ },
1913
+ "api-version": {
1914
+ "description": "Override the api version used for api requests made by this command",
1915
+ "name": "api-version",
1916
+ "hasDynamicHelp": false,
1917
+ "multiple": false,
1918
+ "type": "option"
1919
+ },
1920
+ "pipeline-id": {
1921
+ "name": "pipeline-id",
1922
+ "required": true,
1923
+ "summary": "ID of the pipeline. Used to verify the pipeline is inactive before deleting.",
1924
+ "hasDynamicHelp": false,
1925
+ "multiple": false,
1926
+ "type": "option"
1927
+ },
1928
+ "environment-id": {
1929
+ "char": "e",
1930
+ "name": "environment-id",
1931
+ "required": true,
1932
+ "summary": "ID of the environment to delete.",
1933
+ "hasDynamicHelp": false,
1934
+ "multiple": false,
1935
+ "type": "option"
1936
+ }
1937
+ },
1938
+ "hasDynamicHelp": true,
1939
+ "hiddenAliases": [],
1940
+ "id": "devops:stage:environment:delete",
1941
+ "pluginAlias": "@salesforce/plugin-devops-center",
1942
+ "pluginName": "@salesforce/plugin-devops-center",
1943
+ "pluginType": "core",
1944
+ "strict": true,
1945
+ "summary": "Delete an environment from a DevOps Center pipeline stage.",
1946
+ "enableJsonFlag": true,
1947
+ "isESM": true,
1948
+ "relativePath": [
1949
+ "lib",
1950
+ "commands",
1951
+ "devops",
1952
+ "stage",
1953
+ "environment",
1954
+ "delete.js"
1955
+ ]
1956
+ },
1023
1957
  "project:deploy:pipeline:quick": {
1024
1958
  "aliases": [],
1025
1959
  "args": {},
@@ -1597,5 +2531,5 @@
1597
2531
  ]
1598
2532
  }
1599
2533
  },
1600
- "version": "1.4.0"
2534
+ "version": "1.4.1"
1601
2535
  }