@salesforce/plugin-devops-center 1.2.26 → 1.2.28

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 (225) hide show
  1. package/LICENSE.txt +200 -6
  2. package/README.md +430 -19
  3. package/bin/dev.js +15 -0
  4. package/bin/run.js +5 -0
  5. package/lib/commands/devops/pipeline/activate.d.ts +14 -0
  6. package/lib/commands/devops/pipeline/activate.js +82 -0
  7. package/lib/commands/devops/pipeline/activate.js.map +1 -0
  8. package/lib/commands/devops/pipeline/attach-project.d.ts +15 -0
  9. package/lib/commands/devops/pipeline/attach-project.js +82 -0
  10. package/lib/commands/devops/pipeline/attach-project.js.map +1 -0
  11. package/lib/commands/devops/pipeline/create.d.ts +23 -0
  12. package/lib/commands/devops/pipeline/create.js +136 -0
  13. package/lib/commands/devops/pipeline/create.js.map +1 -0
  14. package/lib/commands/devops/pipeline/stage/add.d.ts +16 -0
  15. package/lib/commands/devops/pipeline/stage/add.js +94 -0
  16. package/lib/commands/devops/pipeline/stage/add.js.map +1 -0
  17. package/lib/commands/devops/project/create.d.ts +15 -0
  18. package/lib/commands/devops/project/create.js +72 -0
  19. package/lib/commands/devops/project/create.js.map +1 -0
  20. package/lib/commands/devops/project/list.d.ts +20 -0
  21. package/lib/commands/devops/project/list.js +59 -0
  22. package/lib/commands/devops/project/list.js.map +1 -0
  23. package/lib/commands/devops/pull-request/create.d.ts +17 -0
  24. package/lib/commands/devops/pull-request/create.js +104 -0
  25. package/lib/commands/devops/pull-request/create.js.map +1 -0
  26. package/lib/commands/devops/work-item/create.d.ts +16 -0
  27. package/lib/commands/devops/work-item/create.js +76 -0
  28. package/lib/commands/devops/work-item/create.js.map +1 -0
  29. package/lib/commands/devops/work-item/list.d.ts +17 -0
  30. package/lib/commands/devops/work-item/list.js +72 -0
  31. package/lib/commands/devops/work-item/list.js.map +1 -0
  32. package/lib/commands/devops/work-item/status/update.d.ts +16 -0
  33. package/lib/commands/devops/work-item/status/update.js +90 -0
  34. package/lib/commands/devops/work-item/status/update.js.map +1 -0
  35. package/lib/commands/project/deploy/pipeline/quick.d.ts +2 -2
  36. package/lib/commands/project/deploy/pipeline/quick.js +24 -21
  37. package/lib/commands/project/deploy/pipeline/quick.js.map +1 -1
  38. package/lib/commands/project/deploy/pipeline/report.d.ts +4 -4
  39. package/lib/commands/project/deploy/pipeline/report.js +38 -35
  40. package/lib/commands/project/deploy/pipeline/report.js.map +1 -1
  41. package/lib/commands/project/deploy/pipeline/resume.d.ts +2 -2
  42. package/lib/commands/project/deploy/pipeline/resume.js +24 -21
  43. package/lib/commands/project/deploy/pipeline/resume.js.map +1 -1
  44. package/lib/commands/project/deploy/pipeline/start.d.ts +3 -3
  45. package/lib/commands/project/deploy/pipeline/start.js +26 -23
  46. package/lib/commands/project/deploy/pipeline/start.js.map +1 -1
  47. package/lib/commands/project/deploy/pipeline/validate.d.ts +3 -3
  48. package/lib/commands/project/deploy/pipeline/validate.js +24 -21
  49. package/lib/commands/project/deploy/pipeline/validate.js.map +1 -1
  50. package/lib/common/base/abstractAsyncOperation.d.ts +3 -3
  51. package/lib/common/base/abstractAsyncOperation.js +31 -23
  52. package/lib/common/base/abstractAsyncOperation.js.map +1 -1
  53. package/lib/common/base/abstractPromote.d.ts +5 -4
  54. package/lib/common/base/abstractPromote.js +52 -38
  55. package/lib/common/base/abstractPromote.js.map +1 -1
  56. package/lib/common/base/abstractQuick.d.ts +4 -3
  57. package/lib/common/base/abstractQuick.js +44 -43
  58. package/lib/common/base/abstractQuick.js.map +1 -1
  59. package/lib/common/base/abstractReportOnPromote.d.ts +2 -1
  60. package/lib/common/base/abstractReportOnPromote.js +31 -24
  61. package/lib/common/base/abstractReportOnPromote.js.map +1 -1
  62. package/lib/common/base/abstractResume.d.ts +3 -2
  63. package/lib/common/base/abstractResume.js +40 -33
  64. package/lib/common/base/abstractResume.js.map +1 -1
  65. package/lib/common/constants.js +19 -13
  66. package/lib/common/constants.js.map +1 -1
  67. package/lib/common/deployPipelineCache.js +20 -15
  68. package/lib/common/deployPipelineCache.js.map +1 -1
  69. package/lib/common/flags/flags.d.ts +2 -2
  70. package/lib/common/flags/flags.js +34 -29
  71. package/lib/common/flags/flags.js.map +1 -1
  72. package/lib/common/flags/promote/promoteFlags.d.ts +3 -3
  73. package/lib/common/flags/promote/promoteFlags.js +26 -20
  74. package/lib/common/flags/promote/promoteFlags.js.map +1 -1
  75. package/lib/common/index.d.ts +3 -2
  76. package/lib/common/index.js +2 -17
  77. package/lib/common/index.js.map +1 -1
  78. package/lib/common/outputColumns.d.ts +3 -13
  79. package/lib/common/outputColumns.js +23 -19
  80. package/lib/common/outputColumns.js.map +1 -1
  81. package/lib/common/outputService/aorOutputService.d.ts +4 -4
  82. package/lib/common/outputService/aorOutputService.js +27 -20
  83. package/lib/common/outputService/aorOutputService.js.map +1 -1
  84. package/lib/common/outputService/deployCommandOutputService.d.ts +2 -2
  85. package/lib/common/outputService/deployCommandOutputService.js +17 -12
  86. package/lib/common/outputService/deployCommandOutputService.js.map +1 -1
  87. package/lib/common/outputService/deploySummaryBuilder.d.ts +1 -1
  88. package/lib/common/outputService/deploySummaryBuilder.js +45 -31
  89. package/lib/common/outputService/deploySummaryBuilder.js.map +1 -1
  90. package/lib/common/outputService/deploymentResultOutputService.d.ts +4 -4
  91. package/lib/common/outputService/deploymentResultOutputService.js +16 -10
  92. package/lib/common/outputService/deploymentResultOutputService.js.map +1 -1
  93. package/lib/common/outputService/index.d.ts +8 -6
  94. package/lib/common/outputService/index.js +5 -19
  95. package/lib/common/outputService/index.js.map +1 -1
  96. package/lib/common/outputService/outputService.d.ts +6 -4
  97. package/lib/common/outputService/outputService.js +20 -14
  98. package/lib/common/outputService/outputService.js.map +1 -1
  99. package/lib/common/outputService/outputServiceFactory.d.ts +8 -8
  100. package/lib/common/outputService/outputServiceFactory.js +21 -16
  101. package/lib/common/outputService/outputServiceFactory.js.map +1 -1
  102. package/lib/common/outputService/outputUtils.d.ts +1 -1
  103. package/lib/common/outputService/outputUtils.js +24 -19
  104. package/lib/common/outputService/outputUtils.js.map +1 -1
  105. package/lib/common/outputService/promoteOutputService.d.ts +4 -5
  106. package/lib/common/outputService/promoteOutputService.js +19 -13
  107. package/lib/common/outputService/promoteOutputService.js.map +1 -1
  108. package/lib/common/outputService/reportOutputService.d.ts +5 -6
  109. package/lib/common/outputService/reportOutputService.js +32 -27
  110. package/lib/common/outputService/reportOutputService.js.map +1 -1
  111. package/lib/common/outputService/resumeCommandOutputService.d.ts +3 -3
  112. package/lib/common/outputService/resumeCommandOutputService.js +19 -13
  113. package/lib/common/outputService/resumeCommandOutputService.js.map +1 -1
  114. package/lib/common/outputService/resumeOutputService.d.ts +3 -3
  115. package/lib/common/outputService/resumeOutputService.js +23 -17
  116. package/lib/common/outputService/resumeOutputService.js.map +1 -1
  117. package/lib/common/selectors/asyncOperationResultsSelector.d.ts +1 -1
  118. package/lib/common/selectors/asyncOperationResultsSelector.js +16 -10
  119. package/lib/common/selectors/asyncOperationResultsSelector.js.map +1 -1
  120. package/lib/common/selectors/deployComponentsSelector.d.ts +1 -1
  121. package/lib/common/selectors/deployComponentsSelector.js +18 -13
  122. package/lib/common/selectors/deployComponentsSelector.js.map +1 -1
  123. package/lib/common/selectors/deployProgressSummarySelector.d.ts +2 -2
  124. package/lib/common/selectors/deployProgressSummarySelector.js +16 -10
  125. package/lib/common/selectors/deployProgressSummarySelector.js.map +1 -1
  126. package/lib/common/selectors/deploymentResultsSelector.d.ts +2 -2
  127. package/lib/common/selectors/deploymentResultsSelector.js +20 -16
  128. package/lib/common/selectors/deploymentResultsSelector.js.map +1 -1
  129. package/lib/common/selectors/environmentSelector.d.ts +2 -2
  130. package/lib/common/selectors/environmentSelector.js +16 -10
  131. package/lib/common/selectors/environmentSelector.js.map +1 -1
  132. package/lib/common/selectors/namedCredentialSelector.d.ts +1 -1
  133. package/lib/common/selectors/namedCredentialSelector.js +16 -10
  134. package/lib/common/selectors/namedCredentialSelector.js.map +1 -1
  135. package/lib/common/selectors/pipelineStageSelector.d.ts +1 -1
  136. package/lib/common/selectors/pipelineStageSelector.js +18 -13
  137. package/lib/common/selectors/pipelineStageSelector.js.map +1 -1
  138. package/lib/common/selectors/selectorUtils.d.ts +1 -1
  139. package/lib/common/selectors/selectorUtils.js +17 -11
  140. package/lib/common/selectors/selectorUtils.js.map +1 -1
  141. package/lib/common/selectors/validateDeploySelector.d.ts +1 -1
  142. package/lib/common/selectors/validateDeploySelector.js +16 -10
  143. package/lib/common/selectors/validateDeploySelector.js.map +1 -1
  144. package/lib/common/selectors/workItemSelector.d.ts +2 -2
  145. package/lib/common/selectors/workItemSelector.js +16 -10
  146. package/lib/common/selectors/workItemSelector.js.map +1 -1
  147. package/lib/common/types.d.ts +4 -4
  148. package/lib/common/types.js +4 -7
  149. package/lib/common/types.js.map +1 -1
  150. package/lib/common/utils.d.ts +4 -4
  151. package/lib/common/utils.js +42 -43
  152. package/lib/common/utils.js.map +1 -1
  153. package/lib/configMeta.js +21 -15
  154. package/lib/configMeta.js.map +1 -1
  155. package/lib/streamer/doceMonitor.d.ts +3 -2
  156. package/lib/streamer/doceMonitor.js +14 -6
  157. package/lib/streamer/doceMonitor.js.map +1 -1
  158. package/lib/streamer/doceStream.d.ts +1 -1
  159. package/lib/streamer/doceStream.js +19 -11
  160. package/lib/streamer/doceStream.js.map +1 -1
  161. package/lib/streamer/processors/asyncOpStream.d.ts +2 -2
  162. package/lib/streamer/processors/asyncOpStream.js +22 -15
  163. package/lib/streamer/processors/asyncOpStream.js.map +1 -1
  164. package/lib/streamer/sObjectStream.d.ts +1 -1
  165. package/lib/streamer/sObjectStream.js +9 -10
  166. package/lib/streamer/sObjectStream.js.map +1 -1
  167. package/lib/utils/activatePipeline.d.ts +17 -0
  168. package/lib/utils/activatePipeline.js +35 -0
  169. package/lib/utils/activatePipeline.js.map +1 -0
  170. package/lib/utils/addPipelineStage.d.ts +20 -0
  171. package/lib/utils/addPipelineStage.js +43 -0
  172. package/lib/utils/addPipelineStage.js.map +1 -0
  173. package/lib/utils/attachProject.d.ts +21 -0
  174. package/lib/utils/attachProject.js +44 -0
  175. package/lib/utils/attachProject.js.map +1 -0
  176. package/lib/utils/createPipeline.d.ts +34 -0
  177. package/lib/utils/createPipeline.js +77 -0
  178. package/lib/utils/createPipeline.js.map +1 -0
  179. package/lib/utils/createProject.d.ts +17 -0
  180. package/lib/utils/createProject.js +39 -0
  181. package/lib/utils/createProject.js.map +1 -0
  182. package/lib/utils/createPullRequest.d.ts +49 -0
  183. package/lib/utils/createPullRequest.js +204 -0
  184. package/lib/utils/createPullRequest.js.map +1 -0
  185. package/lib/utils/createWorkItem.d.ts +19 -0
  186. package/lib/utils/createWorkItem.js +58 -0
  187. package/lib/utils/createWorkItem.js.map +1 -0
  188. package/lib/utils/pipelineUtils.d.ts +8 -0
  189. package/lib/utils/pipelineUtils.js +51 -0
  190. package/lib/utils/pipelineUtils.js.map +1 -0
  191. package/lib/utils/types.d.ts +57 -0
  192. package/lib/utils/types.js +17 -0
  193. package/lib/utils/types.js.map +1 -0
  194. package/lib/utils/updateWorkItemStatus.d.ts +34 -0
  195. package/lib/utils/updateWorkItemStatus.js +71 -0
  196. package/lib/utils/updateWorkItemStatus.js.map +1 -0
  197. package/lib/utils/workItems.d.ts +3 -0
  198. package/lib/utils/workItems.js +181 -0
  199. package/lib/utils/workItems.js.map +1 -0
  200. package/messages/commonErrors.md +5 -1
  201. package/messages/devops.pipeline.activate.md +29 -0
  202. package/messages/devops.pipeline.attach-project.md +29 -0
  203. package/messages/devops.pipeline.create.md +81 -0
  204. package/messages/devops.pipeline.stage.add.md +37 -0
  205. package/messages/devops.project.create.md +29 -0
  206. package/messages/devops.project.list.md +17 -0
  207. package/messages/devops.pull-request.create.md +57 -0
  208. package/messages/devops.work-item.create.md +29 -0
  209. package/messages/devops.work-item.list.md +21 -0
  210. package/messages/devops.work-item.status.update.md +29 -0
  211. package/npm-shrinkwrap.json +4594 -4552
  212. package/oclif.lock +3513 -3194
  213. package/oclif.manifest.json +863 -11
  214. package/package.json +56 -26
  215. package/schemas/devops-pipeline-activate.json +28 -0
  216. package/schemas/devops-pipeline-attach__project.json +25 -0
  217. package/schemas/devops-pipeline-create.json +50 -0
  218. package/schemas/devops-pipeline-stage-add.json +31 -0
  219. package/schemas/devops-project-create.json +28 -0
  220. package/schemas/devops-project-list.json +35 -0
  221. package/schemas/devops-pull__request-create.json +34 -0
  222. package/schemas/devops-work__item-create.json +28 -0
  223. package/schemas/devops-work__item-list.json +75 -0
  224. package/schemas/devops-work__item-status-update.json +28 -0
  225. package/schemas/project-deploy-pipeline-report.json +2 -2
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  # plugin-devops-center
4
4
 
5
- <!--[![NPM](https://img.shields.io/npm/v/@salesforce/plugin-template-sf.svg?label=@salesforce/plugin-template-sf)](https://www.npmjs.com/package/@salesforce/plugin-template-sf) [![Downloads/week](https://img.shields.io/npm/dw/@salesforce/plugin-template-sf.svg)](https://npmjs.org/package/@salesforce/plugin-template-sf) [![License](https://img.shields.io/badge/License-BSD%203--Clause-brightgreen.svg)](https://raw.githubusercontent.com/salesforcecli/plugin-template-sf/main/LICENSE.txt) -->
5
+ <!--[![NPM](https://img.shields.io/npm/v/@salesforce/plugin-template-sf.svg?label=@salesforce/plugin-template-sf)](https://www.npmjs.com/package/@salesforce/plugin-template-sf) [![Downloads/week](https://img.shields.io/npm/dw/@salesforce/plugin-template-sf.svg)](https://npmjs.org/package/@salesforce/plugin-template-sf) [![License](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](https://opensource.org/license/apache-2-0) -->
6
6
 
7
7
  ## Contributing
8
8
 
@@ -56,20 +56,423 @@ sf plugins
56
56
 
57
57
  <!-- commands -->
58
58
 
59
+ - [`sf devops pipeline activate`](#sf-devops-pipeline-activate)
60
+ - [`sf devops pipeline attach-project`](#sf-devops-pipeline-attach-project)
61
+ - [`sf devops pipeline create`](#sf-devops-pipeline-create)
62
+ - [`sf devops pipeline stage add`](#sf-devops-pipeline-stage-add)
63
+ - [`sf devops project create`](#sf-devops-project-create)
64
+ - [`sf devops project list`](#sf-devops-project-list)
65
+ - [`sf devops pull-request create`](#sf-devops-pull-request-create)
66
+ - [`sf devops work-item create`](#sf-devops-work-item-create)
67
+ - [`sf devops work-item list`](#sf-devops-work-item-list)
68
+ - [`sf devops work-item status update`](#sf-devops-work-item-status-update)
59
69
  - [`sf project deploy pipeline quick`](#sf-project-deploy-pipeline-quick)
60
70
  - [`sf project deploy pipeline report`](#sf-project-deploy-pipeline-report)
61
71
  - [`sf project deploy pipeline resume`](#sf-project-deploy-pipeline-resume)
62
72
  - [`sf project deploy pipeline start`](#sf-project-deploy-pipeline-start)
63
73
  - [`sf project deploy pipeline validate`](#sf-project-deploy-pipeline-validate)
64
74
 
75
+ ## `sf devops pipeline activate`
76
+
77
+ Activate a DevOps Center pipeline for deployments.
78
+
79
+ ```
80
+ USAGE
81
+ $ sf devops pipeline activate -o <value> --pipeline-id <value> [--json] [--flags-dir <value>] [--api-version <value>]
82
+
83
+ FLAGS
84
+ -o, --target-org=<value> (required) Username or alias of the target org. Not required if the `target-org`
85
+ configuration variable is already set.
86
+ --api-version=<value> Override the api version used for api requests made by this command
87
+ --pipeline-id=<value> (required) ID of the pipeline.
88
+
89
+ GLOBAL FLAGS
90
+ --flags-dir=<value> Import flag values from a directory.
91
+ --json Format output as json.
92
+
93
+ DESCRIPTION
94
+ Activate a DevOps Center pipeline for deployments.
95
+
96
+ A pipeline must have at least one stage before you activate it. You can't modify the pipeline stages after you
97
+ activate and promote changes through it.
98
+
99
+ EXAMPLES
100
+ Activate a pipeline using the pipeline ID.
101
+
102
+ $ sf devops pipeline activate --target-org my-devops-org --pipeline-id 0XB000000000001
103
+ ```
104
+
105
+ _See code: [src/commands/devops/pipeline/activate.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.2.28/src/commands/devops/pipeline/activate.ts)_
106
+
107
+ ## `sf devops pipeline attach-project`
108
+
109
+ Attach a DevOps Center project to a pipeline.
110
+
111
+ ```
112
+ USAGE
113
+ $ sf devops pipeline attach-project -o <value> --pipeline-id <value> --project-id <value> [--json] [--flags-dir <value>]
114
+ [--api-version <value>]
115
+
116
+ FLAGS
117
+ -o, --target-org=<value> (required) Username or alias of the target org. Not required if the `target-org`
118
+ configuration variable is already set.
119
+ --api-version=<value> Override the api version used for api requests made by this command
120
+ --pipeline-id=<value> (required) ID of the pipeline.
121
+ --project-id=<value> (required) ID of the DevOps Center project.
122
+
123
+ GLOBAL FLAGS
124
+ --flags-dir=<value> Import flag values from a directory.
125
+ --json Format output as json.
126
+
127
+ DESCRIPTION
128
+ Attach a DevOps Center project to a pipeline.
129
+
130
+ You can attach a project to only one pipeline.
131
+
132
+ EXAMPLES
133
+ Attach a project to a pipeline using the project ID and pipeline ID.
134
+
135
+ $ sf devops pipeline attach-project --target-org my-devops-org --pipeline-id 0XB000000000001 --project-id \
136
+ 0Hn000000000001
137
+ ```
138
+
139
+ _See code: [src/commands/devops/pipeline/attach-project.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.2.28/src/commands/devops/pipeline/attach-project.ts)_
140
+
141
+ ## `sf devops pipeline create`
142
+
143
+ Create a DevOps Center pipeline.
144
+
145
+ ```
146
+ USAGE
147
+ $ sf devops pipeline create -o <value> -n <value> -r <value> [--json] [--flags-dir <value>] [--api-version <value>]
148
+ [--repo-type github|bitbucket] [--create-repo] [--repo-owner <value>] [--bitbucket-project <value>] [-d <value>]
149
+
150
+ FLAGS
151
+ -d, --description=<value> Description of the pipeline.
152
+ -n, --name=<value> (required) Name of the pipeline.
153
+ -o, --target-org=<value> (required) Username or alias of the target org. Not required if the `target-org`
154
+ configuration variable is already set.
155
+ -r, --repo=<value> (required) URL of an existing repository or the name of a repository to create.
156
+ --api-version=<value> Override the api version used for api requests made by this command
157
+ --bitbucket-project=<value> Bitbucket project key for the repository. Used when creating a Bitbucket repository
158
+ with '--create-repo'.
159
+ --create-repo Create a repository if it doesn't exist.
160
+ --repo-owner=<value> Owner (organization or user) of the repository. Required when creating a repository
161
+ using '--create-repo'.
162
+ --repo-type=<option> Type of the source code repository. Required when creating a repository using
163
+ '--create-repo'.
164
+ <options: github|bitbucket>
165
+
166
+ GLOBAL FLAGS
167
+ --flags-dir=<value> Import flag values from a directory.
168
+ --json Format output as json.
169
+
170
+ DESCRIPTION
171
+ Create a DevOps Center pipeline.
172
+
173
+ Provide the URL of an existing repository, or use `--create-repo` with a repository name to create one. After you
174
+ create the pipeline, add stages, and activate the pipeline.
175
+
176
+ EXAMPLES
177
+ Create a pipeline and associate it with an existing GitHub repository.
178
+
179
+ $ sf devops pipeline create --target-org my-devops-org --name "Release Pipeline" --repo \
180
+ https://github.com/myorg/myrepo
181
+
182
+ Create a pipeline and associate it with a new GitHub repository.
183
+
184
+ $ sf devops pipeline create --target-org my-devops-org --name "Release Pipeline" --repo my-new-repo --repo-type \
185
+ github --repo-owner myorg --create-repo
186
+
187
+ Create a pipeline with a description and associate it with a Bitbucket repository.
188
+
189
+ $ sf devops pipeline create --target-org my-devops-org --name "Release Pipeline" --repo \
190
+ https://bitbucket.org/myorg/myrepo --description "Main CI/CD pipeline for production releases"
191
+ ```
192
+
193
+ _See code: [src/commands/devops/pipeline/create.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.2.28/src/commands/devops/pipeline/create.ts)_
194
+
195
+ ## `sf devops pipeline stage add`
196
+
197
+ Add a stage to a DevOps Center pipeline.
198
+
199
+ ```
200
+ USAGE
201
+ $ sf devops pipeline stage add -o <value> --pipeline-id <value> -n <value> --next-stage-id <value> [--json] [--flags-dir
202
+ <value>] [--api-version <value>]
203
+
204
+ FLAGS
205
+ -n, --name=<value> (required) Name of the pipeline stage, such as Integration, UAT, or Staging.
206
+ -o, --target-org=<value> (required) Username or alias of the target org. Not required if the `target-org`
207
+ configuration variable is already set.
208
+ --api-version=<value> Override the api version used for api requests made by this command
209
+ --next-stage-id=<value> (required) ID of the stage that follows the new stage in the pipeline.
210
+ --pipeline-id=<value> (required) ID of the pipeline where the stage is added.
211
+
212
+ GLOBAL FLAGS
213
+ --flags-dir=<value> Import flag values from a directory.
214
+ --json Format output as json.
215
+
216
+ DESCRIPTION
217
+ Add a stage to a DevOps Center pipeline.
218
+
219
+ Inserts an empty stage before the stage specified by `--next-stage-id`. The new stage doesn't include a branch or
220
+ environment. Configure them separately after you create the stage.
221
+
222
+ EXAMPLES
223
+ Add a Development stage before Integration in a specific pipeline.
224
+
225
+ $ sf devops pipeline stage add --target-org my-devops-org --pipeline-id 0XB000000000001 --name "Development" \
226
+ --next-stage-id 0Xc000000000002
227
+
228
+ Add a QA stage before UAT in a specific pipeline.
229
+
230
+ $ sf devops pipeline stage add --target-org my-devops-org --pipeline-id 0XB000000000001 --name "QA" \
231
+ --next-stage-id 0Xc000000000003
232
+ ```
233
+
234
+ _See code: [src/commands/devops/pipeline/stage/add.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.2.28/src/commands/devops/pipeline/stage/add.ts)_
235
+
236
+ ## `sf devops project create`
237
+
238
+ Create a DevOps Center project in a DevOps Center org.
239
+
240
+ ```
241
+ USAGE
242
+ $ sf devops project create -o <value> -n <value> [--json] [--flags-dir <value>] [--api-version <value>] [-d <value>]
243
+
244
+ FLAGS
245
+ -d, --description=<value> Description of the new project; if not specified, the description is blank.
246
+ -n, --name=<value> (required) Name of the new DevOps Center project.
247
+ -o, --target-org=<value> (required) Username or alias of the target org. Not required if the `target-org`
248
+ configuration variable is already set.
249
+ --api-version=<value> Override the api version used for api requests made by this command
250
+
251
+ GLOBAL FLAGS
252
+ --flags-dir=<value> Import flag values from a directory.
253
+ --json Format output as json.
254
+
255
+ DESCRIPTION
256
+ Create a DevOps Center project in a DevOps Center org.
257
+
258
+ Creates a new DevOps Center project with the specified name and optional description.
259
+
260
+ EXAMPLES
261
+ Create a new DevOps Center project in the specified org.
262
+
263
+ $ sf devops project create --target-org my-devops-org --name "MyApp Release"
264
+
265
+ Create a project with a name and description.
266
+
267
+ $ sf devops project create --target-org my-devops-org --name "Platform Update" --description "Platform services \
268
+ update"
269
+ ```
270
+
271
+ _See code: [src/commands/devops/project/create.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.2.28/src/commands/devops/project/create.ts)_
272
+
273
+ ## `sf devops project list`
274
+
275
+ List all DevOps Center projects in a Salesforce org.
276
+
277
+ ```
278
+ USAGE
279
+ $ sf devops project list -o <value> [--json] [--flags-dir <value>] [--api-version <value>]
280
+
281
+ FLAGS
282
+ -o, --target-org=<value> (required) Username or alias of the target org. Not required if the `target-org`
283
+ configuration variable is already set.
284
+ --api-version=<value> Override the api version used for api requests made by this command
285
+
286
+ GLOBAL FLAGS
287
+ --flags-dir=<value> Import flag values from a directory.
288
+ --json Format output as json.
289
+
290
+ DESCRIPTION
291
+ List all DevOps Center projects in a Salesforce org.
292
+
293
+ This command queries the DevopsProject standard object and returns the project Id, Name, and Description for each
294
+ project found.
295
+
296
+ EXAMPLES
297
+ List all DevOps Center projects in an org with alias "my-devops-org":
298
+
299
+ $ sf devops project list --target-org my-devops-org
300
+
301
+ List projects using an org's username:
302
+
303
+ $ sf devops project list --target-org devops-center@example.com
304
+ ```
305
+
306
+ _See code: [src/commands/devops/project/list.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.2.28/src/commands/devops/project/list.ts)_
307
+
308
+ ## `sf devops pull-request create`
309
+
310
+ Create a pull request for a work item branch.
311
+
312
+ ```
313
+ USAGE
314
+ $ sf devops pull-request create -o <value> [--json] [--flags-dir <value>] [--api-version <value>] [-n <value>] [-w <value>]
315
+ [--title <value>] [--body <value>]
316
+
317
+ FLAGS
318
+ -n, --work-item-name=<value> Name of the work item, such as WI-000001.
319
+ -o, --target-org=<value> (required) Username or alias of the target org. Not required if the `target-org`
320
+ configuration variable is already set.
321
+ -w, --work-item-id=<value> ID of the work item.
322
+ --api-version=<value> Override the api version used for api requests made by this command
323
+ --body=<value> Description of the pull request.
324
+ --title=<value> Title of the pull request.
325
+
326
+ GLOBAL FLAGS
327
+ --flags-dir=<value> Import flag values from a directory.
328
+ --json Format output as json.
329
+
330
+ DESCRIPTION
331
+ Create a pull request for a work item branch.
332
+
333
+ The pull request title defaults to the work item subject. The work item must have an associated branch and repository.
334
+ Requires VCS authentication: set GITHUB_TOKEN (or use `gh auth login`) for GitHub, or set BITBUCKET_TOKEN for
335
+ Bitbucket.
336
+
337
+ EXAMPLES
338
+ Create a pull request for a work item using the default title.
339
+
340
+ $ sf devops pull-request create --target-org my-devops-org --work-item-name WI-000001
341
+
342
+ Create a pull request with a custom title and description.
343
+
344
+ $ sf devops pull-request create --target-org my-devops-org --work-item-id 0Wx000000000001 --title "Fix: Login \
345
+ timeout" --body "Resolves the 30s timeout on the login page"
346
+ ```
347
+
348
+ _See code: [src/commands/devops/pull-request/create.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.2.28/src/commands/devops/pull-request/create.ts)_
349
+
350
+ ## `sf devops work-item create`
351
+
352
+ Create a new work item in a DevOps Center project.
353
+
354
+ ```
355
+ USAGE
356
+ $ sf devops work-item create -o <value> -p <value> -s <value> [--json] [--flags-dir <value>] [--api-version <value>] [-d
357
+ <value>]
358
+
359
+ FLAGS
360
+ -d, --description=<value> Description of the new work item; if not specified, the description is blank.
361
+ -o, --target-org=<value> (required) Username or alias of the target org. Not required if the `target-org`
362
+ configuration variable is already set.
363
+ -p, --project-id=<value> (required) ID of the DevOps Center project to create the work item in.
364
+ -s, --subject=<value> (required) Subject (title) of the new work item.
365
+ --api-version=<value> Override the api version used for api requests made by this command
366
+
367
+ GLOBAL FLAGS
368
+ --flags-dir=<value> Import flag values from a directory.
369
+ --json Format output as json.
370
+
371
+ DESCRIPTION
372
+ Create a new work item in a DevOps Center project.
373
+
374
+ The command creates the work item using the Connect API. Requires a project ID and a subject for the new work item;
375
+ run the `devops project list` command to get the IDs for all existing projects.
376
+
377
+ EXAMPLES
378
+ Create a work item for the project with the specified ID and give the work item the specified subject (title); use
379
+ the DevOps Center org with alias "my-devops-org":
380
+
381
+ $ sf devops work-item create --target-org my-devops-org --project-id 1Qg000000000001 --subject "Fix login bug"
382
+
383
+ Create a work item with a subject and description:
384
+
385
+ $ sf devops work-item create --target-org my-devops-org --project-id 1Qg000000000001 --subject "Add dark mode" \
386
+ --description "Implement dark mode toggle in settings page"
387
+ ```
388
+
389
+ _See code: [src/commands/devops/work-item/create.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.2.28/src/commands/devops/work-item/create.ts)_
390
+
391
+ ## `sf devops work-item list`
392
+
393
+ List all work items for a DevOps Center project.
394
+
395
+ ```
396
+ USAGE
397
+ $ sf devops work-item list -o <value> -p <value> [--json] [--flags-dir <value>] [--api-version <value>]
398
+
399
+ FLAGS
400
+ -o, --target-org=<value> (required) Username or alias of the target org. Not required if the `target-org`
401
+ configuration variable is already set.
402
+ -p, --project-id=<value> (required) ID of the DevOps Center project to list work items for.
403
+ --api-version=<value> Override the api version used for api requests made by this command
404
+
405
+ GLOBAL FLAGS
406
+ --flags-dir=<value> Import flag values from a directory.
407
+ --json Format output as json.
408
+
409
+ DESCRIPTION
410
+ List all work items for a DevOps Center project.
411
+
412
+ Each work item displays the branch, environment, and repository details needed for checkout and promotion. Requires a
413
+ project ID; run the `devops project list` command to get the IDs for all existing projects.
414
+
415
+ EXAMPLES
416
+ List work items for a specific project in the DevOps org with alias "my-devops-org":
417
+
418
+ $ sf devops work-item list --target-org my-devops-org --project-id 1Qg000000000001
419
+
420
+ List work items using JSON output:
421
+
422
+ $ sf devops work-item list --target-org my-devops-org --project-id 1Qg000000000001 --json
423
+ ```
424
+
425
+ _See code: [src/commands/devops/work-item/list.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.2.28/src/commands/devops/work-item/list.ts)_
426
+
427
+ ## `sf devops work-item status update`
428
+
429
+ Update the status of a work item in DevOps Center.
430
+
431
+ ```
432
+ USAGE
433
+ $ sf devops work-item status update -o <value> --status In Progress|Ready to Promote [--json] [--flags-dir <value>] [--api-version
434
+ <value>] [-n <value>] [-w <value>]
435
+
436
+ FLAGS
437
+ -n, --work-item-name=<value> Name of the work item, such as WI-000001.
438
+ -o, --target-org=<value> (required) Username or alias of the target org. Not required if the `target-org`
439
+ configuration variable is already set.
440
+ -w, --work-item-id=<value> ID of the work item.
441
+ --api-version=<value> Override the api version used for api requests made by this command
442
+ --status=<option> (required) Status to set for the work item. Allowed values: "In Progress", "Ready to
443
+ Promote".
444
+ <options: In Progress|Ready to Promote>
445
+
446
+ GLOBAL FLAGS
447
+ --flags-dir=<value> Import flag values from a directory.
448
+ --json Format output as json.
449
+
450
+ DESCRIPTION
451
+ Update the status of a work item in DevOps Center.
452
+
453
+ Allowed statuses are "In Progress" and "Ready to Promote".
454
+
455
+ EXAMPLES
456
+ Update a work item status by its name to indicate the work is underway:
457
+
458
+ $ sf devops work-item status update --target-org my-devops-org --work-item-name WI-000001 --status "In Progress"
459
+
460
+ Update a work item status by its ID to indicate the changes are ready for promotion:
461
+
462
+ $ sf devops work-item status update --target-org my-devops-org --work-item-id 0Wx000000000001 --status "Ready to \
463
+ Promote"
464
+ ```
465
+
466
+ _See code: [src/commands/devops/work-item/status/update.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.2.28/src/commands/devops/work-item/status/update.ts)_
467
+
65
468
  ## `sf project deploy pipeline quick`
66
469
 
67
470
  Quickly deploy a validated deployment to an org.
68
471
 
69
472
  ```
70
473
  USAGE
71
- $ sf project deploy pipeline quick -c <value> [--json] [--concise | --verbose] [-w <minutes> | --async] [-i <value>]
72
- [-r]
474
+ $ sf project deploy pipeline quick -c <value> [--json] [--flags-dir <value>] [--concise | --verbose] [-w <minutes> | --async] [-i
475
+ <value>] [-r]
73
476
 
74
477
  FLAGS
75
478
  -c, --devops-center-username=<value> (required) Username or alias of the DevOps Center org.
@@ -82,7 +485,8 @@ FLAGS
82
485
  --verbose Show verbose output of the command result.
83
486
 
84
487
  GLOBAL FLAGS
85
- --json Format output as json.
488
+ --flags-dir=<value> Import flag values from a directory.
489
+ --json Format output as json.
86
490
 
87
491
  DESCRIPTION
88
492
  Quickly deploy a validated deployment to an org.
@@ -133,7 +537,7 @@ FLAG DESCRIPTIONS
133
537
  "sf project deploy pipeline report".
134
538
  ```
135
539
 
136
- _See code: [src/commands/project/deploy/pipeline/quick.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.2.26/src/commands/project/deploy/pipeline/quick.ts)_
540
+ _See code: [src/commands/project/deploy/pipeline/quick.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.2.28/src/commands/project/deploy/pipeline/quick.ts)_
137
541
 
138
542
  ## `sf project deploy pipeline report`
139
543
 
@@ -141,7 +545,7 @@ Check the status of a pipeline deploy operation.
141
545
 
142
546
  ```
143
547
  USAGE
144
- $ sf project deploy pipeline report -c <value> [--json] [-i <value>] [-r]
548
+ $ sf project deploy pipeline report -c <value> [--json] [--flags-dir <value>] [-i <value>] [-r]
145
549
 
146
550
  FLAGS
147
551
  -c, --devops-center-username=<value> (required) Username or alias of the DevOps Center org.
@@ -149,7 +553,8 @@ FLAGS
149
553
  -r, --use-most-recent Use the job ID of the most recent deploy operation.
150
554
 
151
555
  GLOBAL FLAGS
152
- --json Format output as json.
556
+ --flags-dir=<value> Import flag values from a directory.
557
+ --json Format output as json.
153
558
 
154
559
  DESCRIPTION
155
560
  Check the status of a pipeline deploy operation.
@@ -180,7 +585,7 @@ FLAG DESCRIPTIONS
180
585
  your most recent operation was longer than 3 days ago, this flag won't find the job ID.
181
586
  ```
182
587
 
183
- _See code: [src/commands/project/deploy/pipeline/report.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.2.26/src/commands/project/deploy/pipeline/report.ts)_
588
+ _See code: [src/commands/project/deploy/pipeline/report.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.2.28/src/commands/project/deploy/pipeline/report.ts)_
184
589
 
185
590
  ## `sf project deploy pipeline resume`
186
591
 
@@ -188,7 +593,8 @@ Resume watching a pipeline deploy operation.
188
593
 
189
594
  ```
190
595
  USAGE
191
- $ sf project deploy pipeline resume -c <value> [--json] [-i <value>] [-r] [--concise | --verbose] [-w <minutes> | ]
596
+ $ sf project deploy pipeline resume -c <value> [--json] [--flags-dir <value>] [-i <value>] [-r] [--concise | --verbose] [-w
597
+ <minutes> | ]
192
598
 
193
599
  FLAGS
194
600
  -c, --devops-center-username=<value> (required) Username or alias of the DevOps Center org.
@@ -200,7 +606,8 @@ FLAGS
200
606
  --verbose Show verbose output of the command result.
201
607
 
202
608
  GLOBAL FLAGS
203
- --json Format output as json.
609
+ --flags-dir=<value> Import flag values from a directory.
610
+ --json Format output as json.
204
611
 
205
612
  DESCRIPTION
206
613
  Resume watching a pipeline deploy operation.
@@ -245,7 +652,7 @@ FLAG DESCRIPTIONS
245
652
  returns the job ID. To check the status of the operation, run "sf project deploy pipeline report".
246
653
  ```
247
654
 
248
- _See code: [src/commands/project/deploy/pipeline/resume.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.2.26/src/commands/project/deploy/pipeline/resume.ts)_
655
+ _See code: [src/commands/project/deploy/pipeline/resume.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.2.28/src/commands/project/deploy/pipeline/resume.ts)_
249
656
 
250
657
  ## `sf project deploy pipeline start`
251
658
 
@@ -253,8 +660,9 @@ Deploy changes from a branch to the pipeline stage’s org.
253
660
 
254
661
  ```
255
662
  USAGE
256
- $ sf project deploy pipeline start -b <value> -p <value> -c <value> [--json] [-v <value>] [-a] [-t <value>...] [-l
257
- NoTestRun|RunSpecifiedTests|RunLocalTests|RunAllTestsInOrg] [-w <minutes> | --async] [--concise | --verbose]
663
+ $ sf project deploy pipeline start -b <value> -p <value> -c <value> [--json] [--flags-dir <value>] [-v <value>] [-a] [-t
664
+ <value>...] [-l NoTestRun|RunSpecifiedTests|RunLocalTests|RunAllTestsInOrg] [-w <minutes> | --async] [--concise |
665
+ --verbose]
258
666
 
259
667
  FLAGS
260
668
  -a, --deploy-all Deploy all metadata in the branch to the stage's org.
@@ -273,7 +681,8 @@ FLAGS
273
681
  --verbose Show verbose output of the command result.
274
682
 
275
683
  GLOBAL FLAGS
276
- --json Format output as json.
684
+ --flags-dir=<value> Import flag values from a directory.
685
+ --json Format output as json.
277
686
 
278
687
  DESCRIPTION
279
688
  Deploy changes from a branch to the pipeline stage’s org.
@@ -343,7 +752,7 @@ FLAG DESCRIPTIONS
343
752
  "sf project deploy pipeline report".
344
753
  ```
345
754
 
346
- _See code: [src/commands/project/deploy/pipeline/start.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.2.26/src/commands/project/deploy/pipeline/start.ts)_
755
+ _See code: [src/commands/project/deploy/pipeline/start.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.2.28/src/commands/project/deploy/pipeline/start.ts)_
347
756
 
348
757
  ## `sf project deploy pipeline validate`
349
758
 
@@ -351,8 +760,9 @@ Perform a validate-only deployment from a branch to the pipeline stage’s org.
351
760
 
352
761
  ```
353
762
  USAGE
354
- $ sf project deploy pipeline validate -b <value> -p <value> -c <value> [--json] [-v <value>] [-a] [-t <value>...] [-l
355
- NoTestRun|RunSpecifiedTests|RunLocalTests|RunAllTestsInOrg] [-w <minutes> | --async] [--concise | --verbose]
763
+ $ sf project deploy pipeline validate -b <value> -p <value> -c <value> [--json] [--flags-dir <value>] [-v <value>] [-a] [-t
764
+ <value>...] [-l NoTestRun|RunSpecifiedTests|RunLocalTests|RunAllTestsInOrg] [-w <minutes> | --async] [--concise |
765
+ --verbose]
356
766
 
357
767
  FLAGS
358
768
  -a, --deploy-all Deploy all metadata in the branch to the stage's org.
@@ -371,7 +781,8 @@ FLAGS
371
781
  --verbose Show verbose output of the command result.
372
782
 
373
783
  GLOBAL FLAGS
374
- --json Format output as json.
784
+ --flags-dir=<value> Import flag values from a directory.
785
+ --json Format output as json.
375
786
 
376
787
  DESCRIPTION
377
788
  Perform a validate-only deployment from a branch to the pipeline stage’s org.
@@ -441,7 +852,7 @@ FLAG DESCRIPTIONS
441
852
  "sf project deploy pipeline report".
442
853
  ```
443
854
 
444
- _See code: [src/commands/project/deploy/pipeline/validate.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.2.26/src/commands/project/deploy/pipeline/validate.ts)_
855
+ _See code: [src/commands/project/deploy/pipeline/validate.ts](https://github.com/salesforcecli/plugin-devops-center/blob/1.2.28/src/commands/project/deploy/pipeline/validate.ts)_
445
856
 
446
857
  <!-- commandsstop -->
447
858
 
package/bin/dev.js ADDED
@@ -0,0 +1,15 @@
1
+ #!/usr/bin/env node
2
+
3
+ import { execute, settings } from '@oclif/core';
4
+ import { fileURLToPath } from 'node:url';
5
+ import { join, dirname } from 'node:path';
6
+
7
+ const __filename = fileURLToPath(import.meta.url);
8
+ const __dirname = dirname(__filename);
9
+ const project = join(__dirname, '..', 'tsconfig.json');
10
+
11
+ process.env.NODE_ENV = 'development';
12
+
13
+ settings.debug = true;
14
+
15
+ await execute({ development: true, dir: import.meta.url });
package/bin/run.js ADDED
@@ -0,0 +1,5 @@
1
+ #!/usr/bin/env node
2
+
3
+ import { execute } from '@oclif/core';
4
+
5
+ await execute({ dir: import.meta.url });
@@ -0,0 +1,14 @@
1
+ import { Org } from '@salesforce/core';
2
+ import { SfCommand } from '@salesforce/sf-plugins-core';
3
+ import { ActivatePipelineResult } from '../../../utils/activatePipeline.js';
4
+ export default class DevopsPipelineActivate extends SfCommand<ActivatePipelineResult> {
5
+ static readonly summary: string;
6
+ static readonly description: string;
7
+ static readonly examples: string[];
8
+ static readonly flags: {
9
+ 'target-org': import("@oclif/core/interfaces").OptionFlag<Org, import("@oclif/core/interfaces").CustomOptions>;
10
+ 'api-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
11
+ 'pipeline-id': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
12
+ };
13
+ run(): Promise<ActivatePipelineResult>;
14
+ }