@salesforce/plugin-devops-center 1.3.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 (185) hide show
  1. package/README.md +649 -102
  2. package/lib/commands/devops/pipeline/create.d.ts +2 -1
  3. package/lib/commands/devops/pipeline/create.js +37 -7
  4. package/lib/commands/devops/pipeline/create.js.map +1 -1
  5. package/lib/commands/devops/pipeline/{activate.d.ts → get.d.ts} +3 -3
  6. package/lib/commands/devops/pipeline/get.js +81 -0
  7. package/lib/commands/devops/pipeline/get.js.map +1 -0
  8. package/lib/commands/devops/pipeline/list.d.ts +13 -0
  9. package/lib/commands/devops/pipeline/list.js +58 -0
  10. package/lib/commands/devops/pipeline/list.js.map +1 -0
  11. package/lib/commands/devops/pipeline/{attach-project.d.ts → project/add.d.ts} +2 -2
  12. package/lib/commands/devops/pipeline/{attach-project.js → project/add.js} +5 -5
  13. package/lib/commands/devops/pipeline/project/add.js.map +1 -0
  14. package/lib/commands/devops/pipeline/project/delete.d.ts +15 -0
  15. package/lib/commands/devops/pipeline/{activate.js → project/delete.js} +17 -28
  16. package/lib/commands/devops/pipeline/project/delete.js.map +1 -0
  17. package/lib/commands/devops/pipeline/stage/delete.d.ts +15 -0
  18. package/lib/commands/devops/pipeline/stage/delete.js +69 -0
  19. package/lib/commands/devops/pipeline/stage/delete.js.map +1 -0
  20. package/lib/commands/devops/pipeline/update.d.ts +18 -0
  21. package/lib/commands/devops/pipeline/update.js +126 -0
  22. package/lib/commands/devops/pipeline/update.js.map +1 -0
  23. package/lib/commands/devops/project/update.d.ts +17 -0
  24. package/lib/commands/devops/project/update.js +86 -0
  25. package/lib/commands/devops/project/update.js.map +1 -0
  26. package/lib/commands/devops/promote.d.ts +24 -0
  27. package/lib/commands/devops/promote.js +148 -0
  28. package/lib/commands/devops/promote.js.map +1 -0
  29. package/lib/commands/devops/promotion/complete.d.ts +20 -0
  30. package/lib/commands/devops/promotion/complete.js +112 -0
  31. package/lib/commands/devops/promotion/complete.js.map +1 -0
  32. package/lib/commands/devops/request/status.d.ts +14 -0
  33. package/lib/commands/devops/request/status.js +71 -0
  34. package/lib/commands/devops/request/status.js.map +1 -0
  35. package/lib/commands/devops/{pull-request → review}/create.d.ts +1 -3
  36. package/lib/commands/devops/{pull-request → review}/create.js +11 -43
  37. package/lib/commands/devops/review/create.js.map +1 -0
  38. package/lib/commands/devops/stage/{add-branch.d.ts → branch/add.d.ts} +2 -2
  39. package/lib/commands/devops/stage/{add-branch.js → branch/add.js} +6 -6
  40. package/lib/commands/devops/stage/branch/add.js.map +1 -0
  41. package/lib/commands/devops/stage/{add-environment.d.ts → environment/add.d.ts} +2 -2
  42. package/lib/commands/devops/stage/{add-environment.js → environment/add.js} +13 -6
  43. package/lib/commands/devops/stage/environment/add.js.map +1 -0
  44. package/lib/commands/devops/stage/environment/delete.d.ts +15 -0
  45. package/lib/commands/devops/stage/environment/delete.js +75 -0
  46. package/lib/commands/devops/stage/environment/delete.js.map +1 -0
  47. package/lib/commands/devops/work-item/combine.d.ts +15 -0
  48. package/lib/commands/devops/work-item/combine.js +109 -0
  49. package/lib/commands/devops/work-item/combine.js.map +1 -0
  50. package/lib/commands/devops/work-item/prepare.d.ts +14 -0
  51. package/lib/commands/devops/work-item/prepare.js +98 -0
  52. package/lib/commands/devops/work-item/prepare.js.map +1 -0
  53. package/lib/commands/devops/work-item/{status/update.d.ts → update.d.ts} +6 -4
  54. package/lib/commands/devops/work-item/{status/update.js → update.js} +30 -9
  55. package/lib/commands/devops/work-item/update.js.map +1 -0
  56. package/lib/common/flags/promote/promoteFlags.d.ts +1 -0
  57. package/lib/common/flags/promote/promoteFlags.js +5 -0
  58. package/lib/common/flags/promote/promoteFlags.js.map +1 -1
  59. package/lib/common/outputService/aorOutputService.js +4 -4
  60. package/lib/common/outputService/aorOutputService.js.map +1 -1
  61. package/lib/common/outputService/outputUtils.js +1 -2
  62. package/lib/common/outputService/outputUtils.js.map +1 -1
  63. package/lib/common/selectors/asyncOperationResultsSelector.js +3 -1
  64. package/lib/common/selectors/asyncOperationResultsSelector.js.map +1 -1
  65. package/lib/common/selectors/deployComponentsSelector.js +5 -6
  66. package/lib/common/selectors/deployComponentsSelector.js.map +1 -1
  67. package/lib/common/selectors/deployProgressSummarySelector.js +3 -1
  68. package/lib/common/selectors/deployProgressSummarySelector.js.map +1 -1
  69. package/lib/common/selectors/deploymentResultsSelector.js +10 -6
  70. package/lib/common/selectors/deploymentResultsSelector.js.map +1 -1
  71. package/lib/common/selectors/environmentSelector.js +4 -2
  72. package/lib/common/selectors/environmentSelector.js.map +1 -1
  73. package/lib/common/selectors/namedCredentialSelector.js +2 -1
  74. package/lib/common/selectors/namedCredentialSelector.js.map +1 -1
  75. package/lib/common/selectors/pipelineStageSelector.js +5 -3
  76. package/lib/common/selectors/pipelineStageSelector.js.map +1 -1
  77. package/lib/common/selectors/validateDeploySelector.js +3 -1
  78. package/lib/common/selectors/validateDeploySelector.js.map +1 -1
  79. package/lib/common/selectors/workItemSelector.js +4 -1
  80. package/lib/common/selectors/workItemSelector.js.map +1 -1
  81. package/lib/utils/activatePipeline.d.ts +13 -4
  82. package/lib/utils/activatePipeline.js +7 -6
  83. package/lib/utils/activatePipeline.js.map +1 -1
  84. package/lib/utils/attachProject.js +2 -0
  85. package/lib/utils/attachProject.js.map +1 -1
  86. package/lib/utils/combineWorkItems.d.ts +20 -0
  87. package/lib/utils/combineWorkItems.js +42 -0
  88. package/lib/utils/combineWorkItems.js.map +1 -0
  89. package/lib/utils/createPipeline.d.ts +14 -1
  90. package/lib/utils/createPipeline.js +52 -6
  91. package/lib/utils/createPipeline.js.map +1 -1
  92. package/lib/utils/createProject.js +1 -0
  93. package/lib/utils/createProject.js.map +1 -1
  94. package/lib/utils/createPullRequest.d.ts +7 -19
  95. package/lib/utils/createPullRequest.js +51 -122
  96. package/lib/utils/createPullRequest.js.map +1 -1
  97. package/lib/utils/deletePipelineStage.d.ts +12 -0
  98. package/lib/utils/deletePipelineStage.js +41 -0
  99. package/lib/utils/deletePipelineStage.js.map +1 -0
  100. package/lib/utils/deleteStageEnvironment.d.ts +8 -0
  101. package/lib/utils/deleteStageEnvironment.js +33 -0
  102. package/lib/utils/deleteStageEnvironment.js.map +1 -0
  103. package/lib/utils/deployStage.d.ts +29 -0
  104. package/lib/utils/deployStage.js +68 -0
  105. package/lib/utils/deployStage.js.map +1 -0
  106. package/lib/utils/detachProject.d.ts +8 -0
  107. package/lib/utils/detachProject.js +37 -0
  108. package/lib/utils/detachProject.js.map +1 -0
  109. package/lib/utils/getPipeline.d.ts +27 -0
  110. package/lib/utils/getPipeline.js +66 -0
  111. package/lib/utils/getPipeline.js.map +1 -0
  112. package/lib/utils/getRequestStatus.d.ts +10 -0
  113. package/lib/utils/getRequestStatus.js +32 -0
  114. package/lib/utils/getRequestStatus.js.map +1 -0
  115. package/lib/utils/listPipelines.d.ts +11 -0
  116. package/lib/utils/listPipelines.js +20 -0
  117. package/lib/utils/listPipelines.js.map +1 -0
  118. package/lib/utils/pipelineUtils.js +3 -0
  119. package/lib/utils/pipelineUtils.js.map +1 -1
  120. package/lib/utils/prepareWorkItem.d.ts +25 -0
  121. package/lib/utils/prepareWorkItem.js +55 -0
  122. package/lib/utils/prepareWorkItem.js.map +1 -0
  123. package/lib/utils/promoteStage.d.ts +21 -0
  124. package/lib/utils/promoteStage.js +46 -0
  125. package/lib/utils/promoteStage.js.map +1 -0
  126. package/lib/utils/soqlUtils.d.ts +23 -0
  127. package/lib/utils/soqlUtils.js +63 -0
  128. package/lib/utils/soqlUtils.js.map +1 -0
  129. package/lib/utils/updateProject.d.ts +17 -0
  130. package/lib/utils/updateProject.js +41 -0
  131. package/lib/utils/updateProject.js.map +1 -0
  132. package/lib/utils/{updateWorkItemStatus.d.ts → updateWorkItem.d.ts} +12 -14
  133. package/lib/utils/{updateWorkItemStatus.js → updateWorkItem.js} +31 -27
  134. package/lib/utils/updateWorkItem.js.map +1 -0
  135. package/lib/utils/workItems.js +2 -0
  136. package/lib/utils/workItems.js.map +1 -1
  137. package/messages/devops.pipeline.create.md +26 -6
  138. package/messages/devops.pipeline.get.md +17 -0
  139. package/messages/devops.pipeline.list.md +13 -0
  140. package/messages/devops.pipeline.project.delete.md +25 -0
  141. package/messages/devops.pipeline.stage.delete.md +25 -0
  142. package/messages/devops.pipeline.update.md +47 -0
  143. package/messages/devops.project.update.md +45 -0
  144. package/messages/devops.promote.md +61 -0
  145. package/messages/devops.promotion.complete.md +47 -0
  146. package/messages/devops.request.status.md +21 -0
  147. package/messages/devops.review.create.md +33 -0
  148. package/messages/{devops.stage.add-environment.md → devops.stage.environment.add.md} +4 -0
  149. package/messages/devops.stage.environment.delete.md +29 -0
  150. package/messages/devops.work-item.combine.md +39 -0
  151. package/messages/devops.work-item.prepare.md +27 -0
  152. package/messages/devops.work-item.update.md +45 -0
  153. package/npm-shrinkwrap.json +37 -174
  154. package/oclif.lock +1 -1
  155. package/oclif.manifest.json +1167 -223
  156. package/package.json +20 -8
  157. package/schemas/devops-pipeline-get.json +98 -0
  158. package/schemas/devops-pipeline-list.json +38 -0
  159. package/schemas/devops-pipeline-project-delete.json +25 -0
  160. package/schemas/devops-pipeline-stage-delete.json +25 -0
  161. package/schemas/{devops-pipeline-activate.json → devops-pipeline-update.json} +5 -2
  162. package/schemas/devops-project-update.json +31 -0
  163. package/schemas/devops-promote.json +28 -0
  164. package/schemas/devops-promotion-complete.json +34 -0
  165. package/schemas/devops-request-status.json +31 -0
  166. package/schemas/{devops-pull__request-create.json → devops-review-create.json} +0 -3
  167. package/schemas/devops-stage-environment-delete.json +25 -0
  168. package/schemas/devops-work__item-combine.json +25 -0
  169. package/schemas/devops-work__item-prepare.json +25 -0
  170. package/schemas/{devops-work__item-status-update.json → devops-work__item-update.json} +8 -2
  171. package/lib/commands/devops/pipeline/activate.js.map +0 -1
  172. package/lib/commands/devops/pipeline/attach-project.js.map +0 -1
  173. package/lib/commands/devops/pull-request/create.js.map +0 -1
  174. package/lib/commands/devops/stage/add-branch.js.map +0 -1
  175. package/lib/commands/devops/stage/add-environment.js.map +0 -1
  176. package/lib/commands/devops/work-item/status/update.js.map +0 -1
  177. package/lib/utils/updateWorkItemStatus.js.map +0 -1
  178. package/messages/devops.pipeline.activate.md +0 -29
  179. package/messages/devops.pull-request.create.md +0 -57
  180. package/messages/devops.work-item.status.update.md +0 -29
  181. /package/messages/{devops.pipeline.attach-project.md → devops.pipeline.project.add.md} +0 -0
  182. /package/messages/{devops.stage.add-branch.md → devops.stage.branch.add.md} +0 -0
  183. /package/schemas/{devops-pipeline-attach__project.json → devops-pipeline-project-add.json} +0 -0
  184. /package/schemas/{devops-stage-add__branch.json → devops-stage-branch-add.json} +0 -0
  185. /package/schemas/{devops-stage-add__environment.json → devops-stage-environment-add.json} +0 -0
@@ -1,11 +1,14 @@
1
1
  {
2
2
  "commands": {
3
- "devops:pipeline:activate": {
3
+ "devops:promote": {
4
4
  "aliases": [],
5
5
  "args": {},
6
- "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.",
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
7
  "examples": [
8
- "Activate a pipeline using the pipeline ID.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001"
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"
9
12
  ],
10
13
  "flags": {
11
14
  "json": {
@@ -40,39 +43,96 @@
40
43
  "multiple": false,
41
44
  "type": "option"
42
45
  },
43
- "pipeline-id": {
44
- "name": "pipeline-id",
46
+ "target-stage-id": {
47
+ "char": "t",
48
+ "name": "target-stage-id",
45
49
  "required": true,
46
- "summary": "ID of the pipeline.",
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.",
47
93
  "hasDynamicHelp": false,
48
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,
49
109
  "type": "option"
50
110
  }
51
111
  },
52
112
  "hasDynamicHelp": true,
53
113
  "hiddenAliases": [],
54
- "id": "devops:pipeline:activate",
114
+ "id": "devops:promote",
55
115
  "pluginAlias": "@salesforce/plugin-devops-center",
56
116
  "pluginName": "@salesforce/plugin-devops-center",
57
117
  "pluginType": "core",
58
118
  "strict": true,
59
- "summary": "Activate a DevOps Center pipeline for deployments.",
119
+ "summary": "Promote work items or a pipeline stage to a target pipeline stage.",
60
120
  "enableJsonFlag": true,
61
121
  "isESM": true,
62
122
  "relativePath": [
63
123
  "lib",
64
124
  "commands",
65
125
  "devops",
66
- "pipeline",
67
- "activate.js"
126
+ "promote.js"
68
127
  ]
69
128
  },
70
- "devops:pipeline:attach-project": {
129
+ "devops:project:create": {
71
130
  "aliases": [],
72
131
  "args": {},
73
- "description": "You can attach a project to only one pipeline.",
132
+ "description": "Creates a new DevOps Center project with the specified name and optional description.",
74
133
  "examples": [
75
- "Attach a project to a pipeline using the project ID and pipeline ID.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --project-id 0Hn000000000001"
134
+ "Create a new DevOps Center project in the specified org.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"MyApp Release\"",
135
+ "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\""
76
136
  ],
77
137
  "flags": {
78
138
  "json": {
@@ -107,39 +167,193 @@
107
167
  "multiple": false,
108
168
  "type": "option"
109
169
  },
110
- "pipeline-id": {
111
- "name": "pipeline-id",
170
+ "name": {
171
+ "char": "n",
172
+ "name": "name",
112
173
  "required": true,
113
- "summary": "ID of the pipeline.",
174
+ "summary": "Name of the new DevOps Center project.",
175
+ "hasDynamicHelp": false,
176
+ "multiple": false,
177
+ "type": "option"
178
+ },
179
+ "description": {
180
+ "char": "d",
181
+ "name": "description",
182
+ "summary": "Description of the new project; if not specified, the description is blank.",
183
+ "hasDynamicHelp": false,
184
+ "multiple": false,
185
+ "type": "option"
186
+ }
187
+ },
188
+ "hasDynamicHelp": true,
189
+ "hiddenAliases": [],
190
+ "id": "devops:project:create",
191
+ "pluginAlias": "@salesforce/plugin-devops-center",
192
+ "pluginName": "@salesforce/plugin-devops-center",
193
+ "pluginType": "core",
194
+ "strict": true,
195
+ "summary": "Create a DevOps Center project in a DevOps Center org.",
196
+ "enableJsonFlag": true,
197
+ "isESM": true,
198
+ "relativePath": [
199
+ "lib",
200
+ "commands",
201
+ "devops",
202
+ "project",
203
+ "create.js"
204
+ ]
205
+ },
206
+ "devops:project:list": {
207
+ "aliases": [],
208
+ "args": {},
209
+ "description": "This command queries the DevopsProject standard object and returns the project Id, Name, and Description for each project found.",
210
+ "examples": [
211
+ "List all DevOps Center projects in an org with alias \"my-devops-org\":\n<%= config.bin %> <%= command.id %> --target-org my-devops-org",
212
+ "List projects using an org's username:\n<%= config.bin %> <%= command.id %> --target-org devops-center@example.com"
213
+ ],
214
+ "flags": {
215
+ "json": {
216
+ "description": "Format output as json.",
217
+ "helpGroup": "GLOBAL",
218
+ "name": "json",
219
+ "allowNo": false,
220
+ "type": "boolean"
221
+ },
222
+ "flags-dir": {
223
+ "helpGroup": "GLOBAL",
224
+ "name": "flags-dir",
225
+ "summary": "Import flag values from a directory.",
226
+ "hasDynamicHelp": false,
227
+ "multiple": false,
228
+ "type": "option"
229
+ },
230
+ "target-org": {
231
+ "char": "o",
232
+ "name": "target-org",
233
+ "noCacheDefault": true,
234
+ "required": true,
235
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
236
+ "hasDynamicHelp": true,
237
+ "multiple": false,
238
+ "type": "option"
239
+ },
240
+ "api-version": {
241
+ "description": "Override the api version used for api requests made by this command",
242
+ "name": "api-version",
243
+ "hasDynamicHelp": false,
244
+ "multiple": false,
245
+ "type": "option"
246
+ }
247
+ },
248
+ "hasDynamicHelp": true,
249
+ "hiddenAliases": [],
250
+ "id": "devops:project:list",
251
+ "pluginAlias": "@salesforce/plugin-devops-center",
252
+ "pluginName": "@salesforce/plugin-devops-center",
253
+ "pluginType": "core",
254
+ "strict": true,
255
+ "summary": "List all DevOps Center projects in a Salesforce org.",
256
+ "enableJsonFlag": true,
257
+ "isESM": true,
258
+ "relativePath": [
259
+ "lib",
260
+ "commands",
261
+ "devops",
262
+ "project",
263
+ "list.js"
264
+ ]
265
+ },
266
+ "devops:project:update": {
267
+ "aliases": [],
268
+ "args": {},
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.",
270
+ "examples": [
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"
275
+ ],
276
+ "flags": {
277
+ "json": {
278
+ "description": "Format output as json.",
279
+ "helpGroup": "GLOBAL",
280
+ "name": "json",
281
+ "allowNo": false,
282
+ "type": "boolean"
283
+ },
284
+ "flags-dir": {
285
+ "helpGroup": "GLOBAL",
286
+ "name": "flags-dir",
287
+ "summary": "Import flag values from a directory.",
288
+ "hasDynamicHelp": false,
289
+ "multiple": false,
290
+ "type": "option"
291
+ },
292
+ "target-org": {
293
+ "char": "o",
294
+ "name": "target-org",
295
+ "noCacheDefault": true,
296
+ "required": true,
297
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
298
+ "hasDynamicHelp": true,
299
+ "multiple": false,
300
+ "type": "option"
301
+ },
302
+ "api-version": {
303
+ "description": "Override the api version used for api requests made by this command",
304
+ "name": "api-version",
114
305
  "hasDynamicHelp": false,
115
306
  "multiple": false,
116
307
  "type": "option"
117
308
  },
118
309
  "project-id": {
310
+ "char": "i",
119
311
  "name": "project-id",
120
312
  "required": true,
121
- "summary": "ID of the DevOps Center project.",
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.",
122
322
  "hasDynamicHelp": false,
123
323
  "multiple": false,
124
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"
125
339
  }
126
340
  },
127
341
  "hasDynamicHelp": true,
128
342
  "hiddenAliases": [],
129
- "id": "devops:pipeline:attach-project",
343
+ "id": "devops:project:update",
130
344
  "pluginAlias": "@salesforce/plugin-devops-center",
131
345
  "pluginName": "@salesforce/plugin-devops-center",
132
346
  "pluginType": "core",
133
347
  "strict": true,
134
- "summary": "Attach a DevOps Center project to a pipeline.",
348
+ "summary": "Update a DevOps Center project.",
135
349
  "enableJsonFlag": true,
136
350
  "isESM": true,
137
351
  "relativePath": [
138
352
  "lib",
139
353
  "commands",
140
354
  "devops",
141
- "pipeline",
142
- "attach-project.js"
355
+ "project",
356
+ "update.js"
143
357
  ]
144
358
  },
145
359
  "devops:pipeline:create": {
@@ -149,7 +363,8 @@
149
363
  "examples": [
150
364
  "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",
151
365
  "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",
152
- "Create a pipeline with a description and associate it with a Bitbucket repository.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"Release Pipeline\" --repo https://bitbucket.org/myorg/myrepo --description \"Main CI/CD pipeline for production releases\""
366
+ "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",
367
+ "Create a pipeline with a description 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 --description \"Main CI/CD pipeline for production releases\""
153
368
  ],
154
369
  "flags": {
155
370
  "json": {
@@ -221,14 +436,21 @@
221
436
  },
222
437
  "repo-owner": {
223
438
  "name": "repo-owner",
224
- "summary": "Owner (organization or user) of the repository. Required when creating a repository using '--create-repo'.",
439
+ "summary": "Owner (organization or user) of the GitHub repository. Required when creating a GitHub repository using '--create-repo'.",
440
+ "hasDynamicHelp": false,
441
+ "multiple": false,
442
+ "type": "option"
443
+ },
444
+ "bitbucket-workspace": {
445
+ "name": "bitbucket-workspace",
446
+ "summary": "Bitbucket workspace that will own the repository. Required when creating a Bitbucket repository using '--create-repo'.",
225
447
  "hasDynamicHelp": false,
226
448
  "multiple": false,
227
449
  "type": "option"
228
450
  },
229
- "bitbucket-project": {
230
- "name": "bitbucket-project",
231
- "summary": "Bitbucket project key for the repository. Used when creating a Bitbucket repository with '--create-repo'.",
451
+ "bitbucket-project-key": {
452
+ "name": "bitbucket-project-key",
453
+ "summary": "Bitbucket project key to associate with the repository. Optional when creating a Bitbucket repository using '--create-repo'.",
232
454
  "hasDynamicHelp": false,
233
455
  "multiple": false,
234
456
  "type": "option"
@@ -260,13 +482,12 @@
260
482
  "create.js"
261
483
  ]
262
484
  },
263
- "devops:project:create": {
485
+ "devops:pipeline:get": {
264
486
  "aliases": [],
265
487
  "args": {},
266
- "description": "Creates a new DevOps Center project with the specified name and optional description.",
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.",
267
489
  "examples": [
268
- "Create a new DevOps Center project in the specified org.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --name \"MyApp Release\"",
269
- "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\""
490
+ "Get details for a specific pipeline:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Do000000000001"
270
491
  ],
271
492
  "flags": {
272
493
  "json": {
@@ -301,19 +522,11 @@
301
522
  "multiple": false,
302
523
  "type": "option"
303
524
  },
304
- "name": {
305
- "char": "n",
306
- "name": "name",
525
+ "pipeline-id": {
526
+ "char": "i",
527
+ "name": "pipeline-id",
307
528
  "required": true,
308
- "summary": "Name of the new DevOps Center project.",
309
- "hasDynamicHelp": false,
310
- "multiple": false,
311
- "type": "option"
312
- },
313
- "description": {
314
- "char": "d",
315
- "name": "description",
316
- "summary": "Description of the new project; if not specified, the description is blank.",
529
+ "summary": "ID of the DevOps Center pipeline.",
317
530
  "hasDynamicHelp": false,
318
531
  "multiple": false,
319
532
  "type": "option"
@@ -321,29 +534,28 @@
321
534
  },
322
535
  "hasDynamicHelp": true,
323
536
  "hiddenAliases": [],
324
- "id": "devops:project:create",
537
+ "id": "devops:pipeline:get",
325
538
  "pluginAlias": "@salesforce/plugin-devops-center",
326
539
  "pluginName": "@salesforce/plugin-devops-center",
327
540
  "pluginType": "core",
328
541
  "strict": true,
329
- "summary": "Create a DevOps Center project in a DevOps Center org.",
542
+ "summary": "Get details of a DevOps Center pipeline including its stages, repositories, and connected projects.",
330
543
  "enableJsonFlag": true,
331
544
  "isESM": true,
332
545
  "relativePath": [
333
546
  "lib",
334
547
  "commands",
335
548
  "devops",
336
- "project",
337
- "create.js"
549
+ "pipeline",
550
+ "get.js"
338
551
  ]
339
552
  },
340
- "devops:project:list": {
553
+ "devops:pipeline:list": {
341
554
  "aliases": [],
342
555
  "args": {},
343
- "description": "This command queries the DevopsProject standard object and returns the project Id, Name, and Description for each project found.",
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.",
344
557
  "examples": [
345
- "List all DevOps Center projects in an org with alias \"my-devops-org\":\n<%= config.bin %> <%= command.id %> --target-org my-devops-org",
346
- "List projects using an org's username:\n<%= config.bin %> <%= command.id %> --target-org devops-center@example.com"
558
+ "List all pipelines in the org:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org"
347
559
  ],
348
560
  "flags": {
349
561
  "json": {
@@ -381,29 +593,787 @@
381
593
  },
382
594
  "hasDynamicHelp": true,
383
595
  "hiddenAliases": [],
384
- "id": "devops:project:list",
596
+ "id": "devops:pipeline:list",
597
+ "pluginAlias": "@salesforce/plugin-devops-center",
598
+ "pluginName": "@salesforce/plugin-devops-center",
599
+ "pluginType": "core",
600
+ "strict": true,
601
+ "summary": "List DevOps Center pipelines with their stages, repositories, and connected projects.",
602
+ "enableJsonFlag": true,
603
+ "isESM": true,
604
+ "relativePath": [
605
+ "lib",
606
+ "commands",
607
+ "devops",
608
+ "pipeline",
609
+ "list.js"
610
+ ]
611
+ },
612
+ "devops:pipeline:update": {
613
+ "aliases": [],
614
+ "args": {},
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.",
1126
+ "examples": [
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"
1129
+ ],
1130
+ "flags": {
1131
+ "json": {
1132
+ "description": "Format output as json.",
1133
+ "helpGroup": "GLOBAL",
1134
+ "name": "json",
1135
+ "allowNo": false,
1136
+ "type": "boolean"
1137
+ },
1138
+ "flags-dir": {
1139
+ "helpGroup": "GLOBAL",
1140
+ "name": "flags-dir",
1141
+ "summary": "Import flag values from a directory.",
1142
+ "hasDynamicHelp": false,
1143
+ "multiple": false,
1144
+ "type": "option"
1145
+ },
1146
+ "target-org": {
1147
+ "char": "o",
1148
+ "name": "target-org",
1149
+ "noCacheDefault": true,
1150
+ "required": true,
1151
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
1152
+ "hasDynamicHelp": true,
1153
+ "multiple": false,
1154
+ "type": "option"
1155
+ },
1156
+ "api-version": {
1157
+ "description": "Override the api version used for api requests made by this command",
1158
+ "name": "api-version",
1159
+ "hasDynamicHelp": false,
1160
+ "multiple": false,
1161
+ "type": "option"
1162
+ },
1163
+ "project-id": {
1164
+ "char": "p",
1165
+ "name": "project-id",
1166
+ "required": true,
1167
+ "summary": "ID of the DevOps Center project to list work items for.",
1168
+ "hasDynamicHelp": false,
1169
+ "multiple": false,
1170
+ "type": "option"
1171
+ }
1172
+ },
1173
+ "hasDynamicHelp": true,
1174
+ "hiddenAliases": [],
1175
+ "id": "devops:work-item:list",
1176
+ "pluginAlias": "@salesforce/plugin-devops-center",
1177
+ "pluginName": "@salesforce/plugin-devops-center",
1178
+ "pluginType": "core",
1179
+ "strict": true,
1180
+ "summary": "List all work items for a DevOps Center project.",
1181
+ "enableJsonFlag": true,
1182
+ "isESM": true,
1183
+ "relativePath": [
1184
+ "lib",
1185
+ "commands",
1186
+ "devops",
1187
+ "work-item",
1188
+ "list.js"
1189
+ ]
1190
+ },
1191
+ "devops:work-item:prepare": {
1192
+ "aliases": [],
1193
+ "args": {},
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.",
1195
+ "examples": [
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"
1198
+ ],
1199
+ "flags": {
1200
+ "json": {
1201
+ "description": "Format output as json.",
1202
+ "helpGroup": "GLOBAL",
1203
+ "name": "json",
1204
+ "allowNo": false,
1205
+ "type": "boolean"
1206
+ },
1207
+ "flags-dir": {
1208
+ "helpGroup": "GLOBAL",
1209
+ "name": "flags-dir",
1210
+ "summary": "Import flag values from a directory.",
1211
+ "hasDynamicHelp": false,
1212
+ "multiple": false,
1213
+ "type": "option"
1214
+ },
1215
+ "target-org": {
1216
+ "char": "o",
1217
+ "name": "target-org",
1218
+ "noCacheDefault": true,
1219
+ "required": true,
1220
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
1221
+ "hasDynamicHelp": true,
1222
+ "multiple": false,
1223
+ "type": "option"
1224
+ },
1225
+ "api-version": {
1226
+ "description": "Override the api version used for api requests made by this command",
1227
+ "name": "api-version",
1228
+ "hasDynamicHelp": false,
1229
+ "multiple": false,
1230
+ "type": "option"
1231
+ },
1232
+ "work-item-id": {
1233
+ "char": "i",
1234
+ "name": "work-item-id",
1235
+ "required": true,
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.",
1246
+ "hasDynamicHelp": false,
1247
+ "multiple": false,
1248
+ "type": "option"
1249
+ }
1250
+ },
1251
+ "hasDynamicHelp": true,
1252
+ "hiddenAliases": [],
1253
+ "id": "devops:work-item:prepare",
1254
+ "pluginAlias": "@salesforce/plugin-devops-center",
1255
+ "pluginName": "@salesforce/plugin-devops-center",
1256
+ "pluginType": "core",
1257
+ "strict": true,
1258
+ "summary": "Prepare a work item for one-off promotion between pipeline stages.",
1259
+ "enableJsonFlag": true,
1260
+ "isESM": true,
1261
+ "relativePath": [
1262
+ "lib",
1263
+ "commands",
1264
+ "devops",
1265
+ "work-item",
1266
+ "prepare.js"
1267
+ ]
1268
+ },
1269
+ "devops:work-item:update": {
1270
+ "aliases": [],
1271
+ "args": {},
1272
+ "description": "Update the subject, description, or status of a work item. At least one of --subject, --description, or --status must be provided.",
1273
+ "examples": [
1274
+ "Update the subject of a work item by name:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-name WI-000001 --subject \"Fix login bug\"",
1275
+ "Update the status of a work item by ID:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-id 0Wx000000000001 --status \"In Progress\"",
1276
+ "Update multiple fields at once:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-name WI-000001 --subject \"Fix login bug\" --description \"Users can't log in on mobile\" --status \"In Progress\""
1277
+ ],
1278
+ "flags": {
1279
+ "json": {
1280
+ "description": "Format output as json.",
1281
+ "helpGroup": "GLOBAL",
1282
+ "name": "json",
1283
+ "allowNo": false,
1284
+ "type": "boolean"
1285
+ },
1286
+ "flags-dir": {
1287
+ "helpGroup": "GLOBAL",
1288
+ "name": "flags-dir",
1289
+ "summary": "Import flag values from a directory.",
1290
+ "hasDynamicHelp": false,
1291
+ "multiple": false,
1292
+ "type": "option"
1293
+ },
1294
+ "target-org": {
1295
+ "char": "o",
1296
+ "name": "target-org",
1297
+ "noCacheDefault": true,
1298
+ "required": true,
1299
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
1300
+ "hasDynamicHelp": true,
1301
+ "multiple": false,
1302
+ "type": "option"
1303
+ },
1304
+ "api-version": {
1305
+ "description": "Override the api version used for api requests made by this command",
1306
+ "name": "api-version",
1307
+ "hasDynamicHelp": false,
1308
+ "multiple": false,
1309
+ "type": "option"
1310
+ },
1311
+ "work-item-name": {
1312
+ "char": "n",
1313
+ "name": "work-item-name",
1314
+ "summary": "Name of the work item, such as WI-000001.",
1315
+ "hasDynamicHelp": false,
1316
+ "multiple": false,
1317
+ "type": "option"
1318
+ },
1319
+ "work-item-id": {
1320
+ "char": "w",
1321
+ "name": "work-item-id",
1322
+ "summary": "ID of the work item.",
1323
+ "hasDynamicHelp": false,
1324
+ "multiple": false,
1325
+ "type": "option"
1326
+ },
1327
+ "subject": {
1328
+ "name": "subject",
1329
+ "summary": "New subject for the work item.",
1330
+ "hasDynamicHelp": false,
1331
+ "multiple": false,
1332
+ "type": "option"
1333
+ },
1334
+ "description": {
1335
+ "name": "description",
1336
+ "summary": "New description for the work item.",
1337
+ "hasDynamicHelp": false,
1338
+ "multiple": false,
1339
+ "type": "option"
1340
+ },
1341
+ "status": {
1342
+ "name": "status",
1343
+ "summary": "New status for the work item. Allowed values: \"In Progress\", \"Ready to Promote\".",
1344
+ "hasDynamicHelp": false,
1345
+ "multiple": false,
1346
+ "options": [
1347
+ "In Progress",
1348
+ "Ready to Promote"
1349
+ ],
1350
+ "type": "option"
1351
+ }
1352
+ },
1353
+ "hasDynamicHelp": true,
1354
+ "hiddenAliases": [],
1355
+ "id": "devops:work-item:update",
385
1356
  "pluginAlias": "@salesforce/plugin-devops-center",
386
1357
  "pluginName": "@salesforce/plugin-devops-center",
387
1358
  "pluginType": "core",
388
1359
  "strict": true,
389
- "summary": "List all DevOps Center projects in a Salesforce org.",
1360
+ "summary": "Update a work item in DevOps Center.",
390
1361
  "enableJsonFlag": true,
391
1362
  "isESM": true,
392
1363
  "relativePath": [
393
1364
  "lib",
394
1365
  "commands",
395
1366
  "devops",
396
- "project",
397
- "list.js"
1367
+ "work-item",
1368
+ "update.js"
398
1369
  ]
399
1370
  },
400
- "devops:pull-request:create": {
1371
+ "devops:pipeline:project:add": {
401
1372
  "aliases": [],
402
1373
  "args": {},
403
- "description": "The pull request title defaults to the work item subject. The work item must have an associated branch and repository. Requires VCS authentication: set GITHUB_TOKEN (or use `gh auth login`) for GitHub, or set BITBUCKET_TOKEN for Bitbucket.",
1374
+ "description": "You can attach a project to only one pipeline.",
404
1375
  "examples": [
405
- "Create a pull request for a work item using the default title.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-name WI-000001",
406
- "Create a pull request with a custom title and description.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-id 0Wx000000000001 --title \"Fix: Login timeout\" --body \"Resolves the 30s timeout on the login page\""
1376
+ "Attach a project to a pipeline using the project ID and pipeline ID.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --project-id 0Hn000000000001"
407
1377
  ],
408
1378
  "flags": {
409
1379
  "json": {
@@ -438,32 +1408,18 @@
438
1408
  "multiple": false,
439
1409
  "type": "option"
440
1410
  },
441
- "work-item-name": {
442
- "char": "n",
443
- "name": "work-item-name",
444
- "summary": "Name of the work item, such as WI-000001.",
445
- "hasDynamicHelp": false,
446
- "multiple": false,
447
- "type": "option"
448
- },
449
- "work-item-id": {
450
- "char": "w",
451
- "name": "work-item-id",
452
- "summary": "ID of the work item.",
453
- "hasDynamicHelp": false,
454
- "multiple": false,
455
- "type": "option"
456
- },
457
- "title": {
458
- "name": "title",
459
- "summary": "Title of the pull request.",
1411
+ "pipeline-id": {
1412
+ "name": "pipeline-id",
1413
+ "required": true,
1414
+ "summary": "ID of the pipeline.",
460
1415
  "hasDynamicHelp": false,
461
1416
  "multiple": false,
462
1417
  "type": "option"
463
1418
  },
464
- "body": {
465
- "name": "body",
466
- "summary": "Description of the pull request.",
1419
+ "project-id": {
1420
+ "name": "project-id",
1421
+ "required": true,
1422
+ "summary": "ID of the DevOps Center project.",
467
1423
  "hasDynamicHelp": false,
468
1424
  "multiple": false,
469
1425
  "type": "option"
@@ -471,29 +1427,29 @@
471
1427
  },
472
1428
  "hasDynamicHelp": true,
473
1429
  "hiddenAliases": [],
474
- "id": "devops:pull-request:create",
1430
+ "id": "devops:pipeline:project:add",
475
1431
  "pluginAlias": "@salesforce/plugin-devops-center",
476
1432
  "pluginName": "@salesforce/plugin-devops-center",
477
1433
  "pluginType": "core",
478
1434
  "strict": true,
479
- "summary": "Create a pull request for a work item branch.",
1435
+ "summary": "Attach a DevOps Center project to a pipeline.",
480
1436
  "enableJsonFlag": true,
481
1437
  "isESM": true,
482
1438
  "relativePath": [
483
1439
  "lib",
484
1440
  "commands",
485
1441
  "devops",
486
- "pull-request",
487
- "create.js"
1442
+ "pipeline",
1443
+ "project",
1444
+ "add.js"
488
1445
  ]
489
1446
  },
490
- "devops:stage:add-branch": {
1447
+ "devops:pipeline:project:delete": {
491
1448
  "aliases": [],
492
1449
  "args": {},
493
- "description": "By default, the branch must exist in the repository. Use --create-vcs-branch to create a branch if it doesn't exist.\nEach pipeline stage supports only one branch. Adding a branch replaces any existing branch linked to the pipeline stage.",
1450
+ "description": "Deletes the junction record that connects the project to the pipeline. The project itself is not deleted.",
494
1451
  "examples": [
495
- "Add an existing branch to a stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Xo000000000001 --stage-id 0Xp000000000001 --branch-name main",
496
- "Create and add a branch to a pipeline stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Xo000000000001 --stage-id 0Xp000000000002 --branch-name integration --create-vcs-branch"
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"
497
1453
  ],
498
1454
  "flags": {
499
1455
  "json": {
@@ -531,59 +1487,46 @@
531
1487
  "pipeline-id": {
532
1488
  "name": "pipeline-id",
533
1489
  "required": true,
534
- "summary": "ID of the pipeline that contains the stage.",
535
- "hasDynamicHelp": false,
536
- "multiple": false,
537
- "type": "option"
538
- },
539
- "stage-id": {
540
- "name": "stage-id",
541
- "required": true,
542
- "summary": "ID of the pipeline stage to associate the branch with.",
1490
+ "summary": "ID of the pipeline.",
543
1491
  "hasDynamicHelp": false,
544
1492
  "multiple": false,
545
1493
  "type": "option"
546
1494
  },
547
- "branch-name": {
548
- "char": "b",
549
- "name": "branch-name",
1495
+ "project-id": {
1496
+ "name": "project-id",
550
1497
  "required": true,
551
- "summary": "Name of the repository branch to assign to the stage.",
1498
+ "summary": "ID of the DevOps Center project.",
552
1499
  "hasDynamicHelp": false,
553
1500
  "multiple": false,
554
1501
  "type": "option"
555
- },
556
- "create-vcs-branch": {
557
- "name": "create-vcs-branch",
558
- "summary": "Create the branch in the remote repository if it doesn't already exist.",
559
- "allowNo": false,
560
- "type": "boolean"
561
1502
  }
562
1503
  },
563
1504
  "hasDynamicHelp": true,
564
1505
  "hiddenAliases": [],
565
- "id": "devops:stage:add-branch",
1506
+ "id": "devops:pipeline:project:delete",
566
1507
  "pluginAlias": "@salesforce/plugin-devops-center",
567
1508
  "pluginName": "@salesforce/plugin-devops-center",
568
1509
  "pluginType": "core",
569
1510
  "strict": true,
570
- "summary": "Add a source code repository branch to a pipeline stage.",
1511
+ "summary": "Remove a DevOps Center project's connection to a pipeline.",
571
1512
  "enableJsonFlag": true,
572
1513
  "isESM": true,
573
1514
  "relativePath": [
574
1515
  "lib",
575
1516
  "commands",
576
1517
  "devops",
577
- "stage",
578
- "add-branch.js"
1518
+ "pipeline",
1519
+ "project",
1520
+ "delete.js"
579
1521
  ]
580
1522
  },
581
- "devops:stage:add-environment": {
1523
+ "devops:pipeline:stage:add": {
582
1524
  "aliases": [],
583
1525
  "args": {},
584
- "description": "This command triggers an OAuth flow to authenticate the environment. A browser window opens automatically for you to log in.",
1526
+ "description": "Inserts an empty stage before the stage specified by `--next-stage-id`. The new stage doesn't include a branch or environment. Configure them separately after you create the stage.",
585
1527
  "examples": [
586
- "Add a production environment to a stage using its ID:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --stage-id 0Xp000000000001 --environment-name Production_Org --org-type Production"
1528
+ "Add a Development stage before Integration in a specific pipeline.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --name \"Development\" --next-stage-id 0Xc000000000002",
1529
+ "Add a QA stage before UAT in a specific pipeline.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --name \"QA\" --next-stage-id 0Xc000000000003"
587
1530
  ],
588
1531
  "flags": {
589
1532
  "json": {
@@ -621,72 +1564,54 @@
621
1564
  "pipeline-id": {
622
1565
  "name": "pipeline-id",
623
1566
  "required": true,
624
- "summary": "ID of the pipeline that contains the stage.",
625
- "hasDynamicHelp": false,
626
- "multiple": false,
627
- "type": "option"
628
- },
629
- "stage-id": {
630
- "name": "stage-id",
631
- "required": true,
632
- "summary": "ID of the pipeline stage.",
1567
+ "summary": "ID of the pipeline where the stage is added.",
633
1568
  "hasDynamicHelp": false,
634
1569
  "multiple": false,
635
1570
  "type": "option"
636
1571
  },
637
- "environment-name": {
638
- "char": "e",
639
- "name": "environment-name",
1572
+ "name": {
1573
+ "char": "n",
1574
+ "name": "name",
640
1575
  "required": true,
641
- "summary": "Name of the environment.",
1576
+ "summary": "Name of the pipeline stage, such as Integration, UAT, or Staging.",
642
1577
  "hasDynamicHelp": false,
643
1578
  "multiple": false,
644
1579
  "type": "option"
645
1580
  },
646
- "org-type": {
647
- "name": "org-type",
1581
+ "next-stage-id": {
1582
+ "name": "next-stage-id",
648
1583
  "required": true,
649
- "summary": "Type of the Salesforce org. Valid values: Production, Sandbox.",
1584
+ "summary": "ID of the stage that follows the new stage in the pipeline.",
650
1585
  "hasDynamicHelp": false,
651
1586
  "multiple": false,
652
- "options": [
653
- "Production",
654
- "Sandbox"
655
- ],
656
1587
  "type": "option"
657
- },
658
- "no-browser": {
659
- "name": "no-browser",
660
- "summary": "Don't auto-open the browser for OAuth authentication. The redirect URL is printed for manual use.",
661
- "allowNo": false,
662
- "type": "boolean"
663
1588
  }
664
1589
  },
665
1590
  "hasDynamicHelp": true,
666
1591
  "hiddenAliases": [],
667
- "id": "devops:stage:add-environment",
1592
+ "id": "devops:pipeline:stage:add",
668
1593
  "pluginAlias": "@salesforce/plugin-devops-center",
669
1594
  "pluginName": "@salesforce/plugin-devops-center",
670
1595
  "pluginType": "core",
671
1596
  "strict": true,
672
- "summary": "Add a Salesforce environment to a pipeline stage.",
1597
+ "summary": "Add a stage to a DevOps Center pipeline.",
673
1598
  "enableJsonFlag": true,
674
1599
  "isESM": true,
675
1600
  "relativePath": [
676
1601
  "lib",
677
1602
  "commands",
678
1603
  "devops",
1604
+ "pipeline",
679
1605
  "stage",
680
- "add-environment.js"
1606
+ "add.js"
681
1607
  ]
682
1608
  },
683
- "devops:work-item:create": {
1609
+ "devops:pipeline:stage:delete": {
684
1610
  "aliases": [],
685
1611
  "args": {},
686
- "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.",
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.",
687
1613
  "examples": [
688
- "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\"",
689
- "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\""
1614
+ "Delete a stage from a pipeline:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --stage-id 0Xc000000000002"
690
1615
  ],
691
1616
  "flags": {
692
1617
  "json": {
@@ -721,28 +1646,18 @@
721
1646
  "multiple": false,
722
1647
  "type": "option"
723
1648
  },
724
- "project-id": {
725
- "char": "p",
726
- "name": "project-id",
1649
+ "pipeline-id": {
1650
+ "name": "pipeline-id",
727
1651
  "required": true,
728
- "summary": "ID of the DevOps Center project to create the work item in.",
1652
+ "summary": "ID of the pipeline that contains the stage.",
729
1653
  "hasDynamicHelp": false,
730
1654
  "multiple": false,
731
1655
  "type": "option"
732
1656
  },
733
- "subject": {
734
- "char": "s",
735
- "name": "subject",
1657
+ "stage-id": {
1658
+ "name": "stage-id",
736
1659
  "required": true,
737
- "summary": "Subject (title) of the new work item.",
738
- "hasDynamicHelp": false,
739
- "multiple": false,
740
- "type": "option"
741
- },
742
- "description": {
743
- "char": "d",
744
- "name": "description",
745
- "summary": "Description of the new work item; if not specified, the description is blank.",
1660
+ "summary": "ID of the stage to delete.",
746
1661
  "hasDynamicHelp": false,
747
1662
  "multiple": false,
748
1663
  "type": "option"
@@ -750,29 +1665,30 @@
750
1665
  },
751
1666
  "hasDynamicHelp": true,
752
1667
  "hiddenAliases": [],
753
- "id": "devops:work-item:create",
1668
+ "id": "devops:pipeline:stage:delete",
754
1669
  "pluginAlias": "@salesforce/plugin-devops-center",
755
1670
  "pluginName": "@salesforce/plugin-devops-center",
756
1671
  "pluginType": "core",
757
1672
  "strict": true,
758
- "summary": "Create a new work item in a DevOps Center project.",
1673
+ "summary": "Delete a stage from a DevOps Center pipeline.",
759
1674
  "enableJsonFlag": true,
760
1675
  "isESM": true,
761
1676
  "relativePath": [
762
1677
  "lib",
763
1678
  "commands",
764
1679
  "devops",
765
- "work-item",
766
- "create.js"
1680
+ "pipeline",
1681
+ "stage",
1682
+ "delete.js"
767
1683
  ]
768
1684
  },
769
- "devops:work-item:list": {
1685
+ "devops:stage:branch:add": {
770
1686
  "aliases": [],
771
1687
  "args": {},
772
- "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.",
1688
+ "description": "By default, the branch must exist in the repository. Use --create-vcs-branch to create a branch if it doesn't exist.\nEach pipeline stage supports only one branch. Adding a branch replaces any existing branch linked to the pipeline stage.",
773
1689
  "examples": [
774
- "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",
775
- "List work items using JSON output:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 1Qg000000000001 --json"
1690
+ "Add an existing branch to a stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Xo000000000001 --stage-id 0Xp000000000001 --branch-name main",
1691
+ "Create and add a branch to a pipeline stage:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0Xo000000000001 --stage-id 0Xp000000000002 --branch-name integration --create-vcs-branch"
776
1692
  ],
777
1693
  "flags": {
778
1694
  "json": {
@@ -807,41 +1723,63 @@
807
1723
  "multiple": false,
808
1724
  "type": "option"
809
1725
  },
810
- "project-id": {
811
- "char": "p",
812
- "name": "project-id",
1726
+ "pipeline-id": {
1727
+ "name": "pipeline-id",
813
1728
  "required": true,
814
- "summary": "ID of the DevOps Center project to list work items for.",
1729
+ "summary": "ID of the pipeline that contains the stage.",
1730
+ "hasDynamicHelp": false,
1731
+ "multiple": false,
1732
+ "type": "option"
1733
+ },
1734
+ "stage-id": {
1735
+ "name": "stage-id",
1736
+ "required": true,
1737
+ "summary": "ID of the pipeline stage to associate the branch with.",
1738
+ "hasDynamicHelp": false,
1739
+ "multiple": false,
1740
+ "type": "option"
1741
+ },
1742
+ "branch-name": {
1743
+ "char": "b",
1744
+ "name": "branch-name",
1745
+ "required": true,
1746
+ "summary": "Name of the repository branch to assign to the stage.",
815
1747
  "hasDynamicHelp": false,
816
1748
  "multiple": false,
817
1749
  "type": "option"
1750
+ },
1751
+ "create-vcs-branch": {
1752
+ "name": "create-vcs-branch",
1753
+ "summary": "Create the branch in the remote repository if it doesn't already exist.",
1754
+ "allowNo": false,
1755
+ "type": "boolean"
818
1756
  }
819
1757
  },
820
1758
  "hasDynamicHelp": true,
821
1759
  "hiddenAliases": [],
822
- "id": "devops:work-item:list",
1760
+ "id": "devops:stage:branch:add",
823
1761
  "pluginAlias": "@salesforce/plugin-devops-center",
824
1762
  "pluginName": "@salesforce/plugin-devops-center",
825
1763
  "pluginType": "core",
826
1764
  "strict": true,
827
- "summary": "List all work items for a DevOps Center project.",
1765
+ "summary": "Add a source code repository branch to a pipeline stage.",
828
1766
  "enableJsonFlag": true,
829
1767
  "isESM": true,
830
1768
  "relativePath": [
831
1769
  "lib",
832
1770
  "commands",
833
1771
  "devops",
834
- "work-item",
835
- "list.js"
1772
+ "stage",
1773
+ "branch",
1774
+ "add.js"
836
1775
  ]
837
1776
  },
838
- "devops:pipeline:stage:add": {
1777
+ "devops:stage:environment:add": {
839
1778
  "aliases": [],
840
1779
  "args": {},
841
- "description": "Inserts an empty stage before the stage specified by `--next-stage-id`. The new stage doesn't include a branch or environment. Configure them separately after you create the stage.",
1780
+ "description": "This command triggers an OAuth flow to authenticate the environment. A browser window opens automatically for you to log in.",
842
1781
  "examples": [
843
- "Add a Development stage before Integration in a specific pipeline.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --name \"Development\" --next-stage-id 0Xc000000000002",
844
- "Add a QA stage before UAT in a specific pipeline.\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --name \"QA\" --next-stage-id 0Xc000000000003"
1782
+ "Add a production environment to a stage using its ID:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --stage-id 0Xp000000000001 --environment-name Production_Org --org-type Production"
845
1783
  ],
846
1784
  "flags": {
847
1785
  "json": {
@@ -879,55 +1817,72 @@
879
1817
  "pipeline-id": {
880
1818
  "name": "pipeline-id",
881
1819
  "required": true,
882
- "summary": "ID of the pipeline where the stage is added.",
1820
+ "summary": "ID of the pipeline that contains the stage.",
883
1821
  "hasDynamicHelp": false,
884
1822
  "multiple": false,
885
1823
  "type": "option"
886
1824
  },
887
- "name": {
888
- "char": "n",
889
- "name": "name",
1825
+ "stage-id": {
1826
+ "name": "stage-id",
890
1827
  "required": true,
891
- "summary": "Name of the pipeline stage, such as Integration, UAT, or Staging.",
1828
+ "summary": "ID of the pipeline stage.",
892
1829
  "hasDynamicHelp": false,
893
1830
  "multiple": false,
894
1831
  "type": "option"
895
1832
  },
896
- "next-stage-id": {
897
- "name": "next-stage-id",
1833
+ "environment-name": {
1834
+ "char": "e",
1835
+ "name": "environment-name",
898
1836
  "required": true,
899
- "summary": "ID of the stage that follows the new stage in the pipeline.",
1837
+ "summary": "Name of the environment.",
1838
+ "hasDynamicHelp": false,
1839
+ "multiple": false,
1840
+ "type": "option"
1841
+ },
1842
+ "org-type": {
1843
+ "name": "org-type",
1844
+ "required": true,
1845
+ "summary": "Type of the Salesforce org. Valid values: Production, Sandbox.",
900
1846
  "hasDynamicHelp": false,
901
1847
  "multiple": false,
1848
+ "options": [
1849
+ "Production",
1850
+ "Sandbox"
1851
+ ],
902
1852
  "type": "option"
1853
+ },
1854
+ "no-browser": {
1855
+ "name": "no-browser",
1856
+ "summary": "Don't auto-open the browser for OAuth authentication. The redirect URL is printed for manual use.",
1857
+ "allowNo": false,
1858
+ "type": "boolean"
903
1859
  }
904
1860
  },
905
1861
  "hasDynamicHelp": true,
906
1862
  "hiddenAliases": [],
907
- "id": "devops:pipeline:stage:add",
1863
+ "id": "devops:stage:environment:add",
908
1864
  "pluginAlias": "@salesforce/plugin-devops-center",
909
1865
  "pluginName": "@salesforce/plugin-devops-center",
910
1866
  "pluginType": "core",
911
1867
  "strict": true,
912
- "summary": "Add a stage to a DevOps Center pipeline.",
1868
+ "summary": "Add a Salesforce environment to a pipeline stage.",
913
1869
  "enableJsonFlag": true,
914
1870
  "isESM": true,
915
1871
  "relativePath": [
916
1872
  "lib",
917
1873
  "commands",
918
1874
  "devops",
919
- "pipeline",
920
1875
  "stage",
1876
+ "environment",
921
1877
  "add.js"
922
1878
  ]
923
1879
  },
924
- "devops:work-item:status:update": {
1880
+ "devops:stage:environment:delete": {
925
1881
  "aliases": [],
926
1882
  "args": {},
927
- "description": "Allowed statuses are \"In Progress\" and \"Ready to Promote\".",
1883
+ "description": "Removes the specified environment from the pipeline stage. The environment must belong to an inactive pipeline.",
928
1884
  "examples": [
929
- "Update a work item status by its name to indicate the work is underway:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-name WI-000001 --status \"In Progress\"",
930
- "Update a work item status by its ID to indicate the changes are ready for promotion:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --work-item-id 0Wx000000000001 --status \"Ready to Promote\""
1885
+ "Delete an environment:\n<%= config.bin %> <%= command.id %> --target-org my-devops-org --pipeline-id 0XB000000000001 --environment-id 0Xe000000000001"
931
1886
  ],
932
1887
  "flags": {
933
1888
  "json": {
@@ -962,52 +1917,41 @@
962
1917
  "multiple": false,
963
1918
  "type": "option"
964
1919
  },
965
- "work-item-name": {
966
- "char": "n",
967
- "name": "work-item-name",
968
- "summary": "Name of the work item, such as WI-000001.",
969
- "hasDynamicHelp": false,
970
- "multiple": false,
971
- "type": "option"
972
- },
973
- "work-item-id": {
974
- "char": "w",
975
- "name": "work-item-id",
976
- "summary": "ID of the work item.",
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.",
977
1924
  "hasDynamicHelp": false,
978
1925
  "multiple": false,
979
1926
  "type": "option"
980
1927
  },
981
- "status": {
982
- "name": "status",
1928
+ "environment-id": {
1929
+ "char": "e",
1930
+ "name": "environment-id",
983
1931
  "required": true,
984
- "summary": "Status to set for the work item. Allowed values: \"In Progress\", \"Ready to Promote\".",
1932
+ "summary": "ID of the environment to delete.",
985
1933
  "hasDynamicHelp": false,
986
1934
  "multiple": false,
987
- "options": [
988
- "In Progress",
989
- "Ready to Promote"
990
- ],
991
1935
  "type": "option"
992
1936
  }
993
1937
  },
994
1938
  "hasDynamicHelp": true,
995
1939
  "hiddenAliases": [],
996
- "id": "devops:work-item:status:update",
1940
+ "id": "devops:stage:environment:delete",
997
1941
  "pluginAlias": "@salesforce/plugin-devops-center",
998
1942
  "pluginName": "@salesforce/plugin-devops-center",
999
1943
  "pluginType": "core",
1000
1944
  "strict": true,
1001
- "summary": "Update the status of a work item in DevOps Center.",
1945
+ "summary": "Delete an environment from a DevOps Center pipeline stage.",
1002
1946
  "enableJsonFlag": true,
1003
1947
  "isESM": true,
1004
1948
  "relativePath": [
1005
1949
  "lib",
1006
1950
  "commands",
1007
1951
  "devops",
1008
- "work-item",
1009
- "status",
1010
- "update.js"
1952
+ "stage",
1953
+ "environment",
1954
+ "delete.js"
1011
1955
  ]
1012
1956
  },
1013
1957
  "project:deploy:pipeline:quick": {
@@ -1587,5 +2531,5 @@
1587
2531
  ]
1588
2532
  }
1589
2533
  },
1590
- "version": "1.3.0"
2534
+ "version": "1.4.1"
1591
2535
  }