@salesforce/plugin-release-management 4.3.1-dev.0 → 4.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -100,283 +100,257 @@ sfdx plugins
100
100
 
101
101
  <!-- commands -->
102
102
 
103
- - [`sfdx channel:promote -t <string> -c sf|sfdx [-d] [-p <array>] [-m <number>] [-i] [-x] [-T <array>] [-T <string> | | [-C <string> | -s <string>]] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-channelpromote--t-string--c-sfsfdx--d--p-array--m-number--i--x--t-array--t-string-----c-string---s-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
104
- - [`sfdx circleci [-t plugin|library|orb] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-circleci--t-pluginlibraryorb---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
105
- - [`sfdx circleci:envvar:create -e <string> [-s <string>] [--dryrun] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-circlecienvvarcreate--e-string--s-string---dryrun---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
106
- - [`sfdx circleci:envvar:update -e <string> [-s <string>] [--dryrun] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-circlecienvvarupdate--e-string--s-string---dryrun---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
107
- - [`sfdx cli:install:test -c <string> -m <string> [--channel <string>] [--output-file <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-cliinstalltest--c-string--m-string---channel-string---output-file-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
108
- - [`sfdx cli:latestrc:build [--rctag <string>] [--build-only] [--resolutions] [--only <array>] [--pinned-deps] [--patch] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-clilatestrcbuild---rctag-string---build-only---resolutions---only-array---pinned-deps---patch---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
109
- - [`sfdx cli:releasenotes -c <string> [-s <string>] [-m] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-clireleasenotes--c-string--s-string--m---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
110
- - [`sfdx cli:schemas:collect [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-clischemascollect---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
111
- - [`sfdx cli:schemas:compare [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-clischemascompare---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
112
- - [`sfdx cli:tarballs:prepare [-d] [-t] [--verbose] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-clitarballsprepare--d--t---verbose---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
113
- - [`sfdx cli:tarballs:smoke -c <string> [--verbose] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-clitarballssmoke--c-string---verbose---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
114
- - [`sfdx cli:tarballs:verify [-c sf|sfdx] [-w <number>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-clitarballsverify--c-sfsfdx--w-number---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
115
- - [`sfdx cli:versions:inspect -c <string> -l <string> --cli sf|sfdx [-d <string>] [-s] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-cliversionsinspect--c-string--l-string---cli-sfsfdx--d-string--s---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
116
- - [`sfdx dependabot:automerge -m major|minor|patch [-o <string> -r <string>] [-d] [-s] [--merge-method merge|squash|rebase] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-dependabotautomerge--m-majorminorpatch--o-string--r-string--d--s---merge-method-mergesquashrebase---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
117
- - [`sfdx dependabot:consolidate -m major|minor|patch -b <string> -t <string> [--ignore <array>] [-d] [--no-pr] [-r <string> -o <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-dependabotconsolidate--m-majorminorpatch--b-string--t-string---ignore-array--d---no-pr--r-string--o-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
118
- - [`sfdx npm:dependencies:pin [-d] [-t <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-npmdependenciespin--d--t-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
119
- - [`sfdx npm:package:promote -c <string> [-d] [-t <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-npmpackagepromote--c-string--d--t-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
120
- - [`sfdx npm:package:release [-d] [-s] [-t <string>] [-a <string>] [--install] [--prerelease <string>] [--verify] [--githubtag <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-npmpackagerelease--d--s--t-string--a-string---install---prerelease-string---verify---githubtag-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
121
- - [`sfdx npm:release:validate [--verbose] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-npmreleasevalidate---verbose---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
122
- - [`sfdx plugins:trust:verify -n <string> [-r <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-pluginstrustverify--n-string--r-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
123
- - [`sfdx`](#sfdx)
124
- - [`sfdx typescript:update [-v <string>] [-t <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-typescriptupdate--v-string--t-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
125
-
126
- ## `sfdx channel:promote -t <string> -c sf|sfdx [-d] [-p <array>] [-m <number>] [-i] [-x] [-T <array>] [-T <string> | | [-C <string> | -s <string>]] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
103
+ - [`sfdx channel:promote`](#sfdx-channelpromote)
104
+ - [`sfdx cli:artifacts:compare`](#sfdx-cliartifactscompare)
105
+ - [`sfdx cli:install:jit:test`](#sfdx-cliinstalljittest)
106
+ - [`sfdx cli:install:test`](#sfdx-cliinstalltest)
107
+ - [`sfdx cli:release:automerge`](#sfdx-clireleaseautomerge)
108
+ - [`sfdx cli:release:build`](#sfdx-clireleasebuild)
109
+ - [`sfdx cli:releasenotes`](#sfdx-clireleasenotes)
110
+ - [`sfdx cli:schemas:compare`](#sfdx-clischemascompare)
111
+ - [`sfdx cli:tarballs:prepare`](#sfdx-clitarballsprepare)
112
+ - [`sfdx cli:tarballs:smoke`](#sfdx-clitarballssmoke)
113
+ - [`sfdx cli:tarballs:verify`](#sfdx-clitarballsverify)
114
+ - [`sfdx cli:versions:inspect`](#sfdx-cliversionsinspect)
115
+ - [`sfdx dependabot:automerge`](#sfdx-dependabotautomerge)
116
+ - [`sfdx github:check:closed`](#sfdx-githubcheckclosed)
117
+ - [`sfdx npm:dependencies:pin`](#sfdx-npmdependenciespin)
118
+ - [`sfdx npm:package:release`](#sfdx-npmpackagerelease)
119
+ - [`sfdx plugins:trust:verify`](#sfdx-pluginstrustverify)
120
+ - [`sfdx repositories`](#sfdx-repositories)
121
+
122
+ ## `sfdx channel:promote`
127
123
 
128
124
  promote a s3 channel
129
125
 
130
126
  ```
131
127
  USAGE
132
- $ sfdx channel:promote -t <string> -c sf|sfdx [-d] [-p <array>] [-m <number>] [-i] [-x] [-T <array>] [-T <string> |
133
- | [-C <string> | -s <string>]] [--json] [--loglevel
134
- trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
128
+ $ sfdx channel:promote -t <value> -c sf|sfdx [--json] [-d] [-C <value>] [-p win|macos|deb] [-s <value>] [-m
129
+ <value>] [-i] [-x] [-T linux-x64|linux-arm|win32-x64|win32-x86|darwin-x64] [-v <value>]
135
130
 
136
131
  FLAGS
137
- -C, --candidate=<value> the channel name that you want to
138
- promote
139
- -T, --targets=<value> comma-separated targets to promote
140
- (e.g.: linux-arm,win32-x64)
141
- -T, --version=<value> the version of the candidate to be
142
- promoted, which must exist already
143
- in s3. Used to fetch the correct sha
144
- -c, --cli=(sf|sfdx) (required) the cli name to promote
145
- -d, --dryrun If true, only show what would happen
146
- -i, --[no-]indexes append the promoted urls into the
147
- index files
148
- -m, --maxage=<value> [default: 300] cache control max-age
149
- in seconds
150
- -p, --platform=<value>... [default: ] the platform to promote
151
- -s, --sha=<value> the short sha to promote
152
- -t, --target=<value> (required) [default: stable] the
153
- channel name that you are promoting
154
- to
155
- -x, --[no-]xz also upload xz
156
- --json format output as json
157
- --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
158
- this command invocation
132
+ -C, --promote-from-channel=<value> the channel name that you want to promote
133
+ -T, --architecture-target=<option>... comma-separated targets to promote (e.g.: linux-arm,win32-x64)
134
+ <options: linux-x64|linux-arm|win32-x64|win32-x86|darwin-x64>
135
+ -c, --cli=<option> (required) the cli name to promote
136
+ <options: sf|sfdx>
137
+ -d, --dryrun If true, only show what would happen
138
+ -i, --[no-]indexes append the promoted urls into the index files
139
+ -m, --max-age=<value> [default: 300] cache control max-age in seconds
140
+ -p, --platform=<option>... the platform to promote
141
+ <options: win|macos|deb>
142
+ -s, --sha=<value> the short sha to promote
143
+ -t, --promote-to-channel=<value> (required) [default: stable] the channel name that you are promoting to
144
+ -v, --version=<value> the version of the candidate to be promoted, which must exist already in s3.
145
+ Used to fetch the correct sha
146
+ -x, --[no-]xz also upload xz
147
+
148
+ GLOBAL FLAGS
149
+ --json Format output as json.
159
150
 
160
151
  DESCRIPTION
161
152
  promote a s3 channel
162
153
 
154
+ promote a s3 channel
155
+
163
156
  EXAMPLES
164
157
  $ sfdx channel:promote --candidate latest-rc --target latest --platform win --platform mac
165
158
  ```
166
159
 
167
- _See code: [src/commands/channel/promote.ts](https://github.com/salesforcecli/plugin-release-management/blob/v3.1.0/src/commands/channel/promote.ts)_
160
+ _See code: [src/commands/channel/promote.ts](https://github.com/salesforcecli/plugin-release-management/blob/4.3.2/src/commands/channel/promote.ts)_
168
161
 
169
- ## `sfdx circleci [-t plugin|library|orb] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
162
+ ## `sfdx cli:artifacts:compare`
170
163
 
171
- list known Circle CI slugs from 'sfdx repositories'
164
+ Look for breaking changes in artifacts (schemas and snapshots) from plugins. Must be run in CLI directory.
172
165
 
173
166
  ```
174
167
  USAGE
175
- $ sfdx circleci [-t plugin|library|orb] [--json] [--loglevel
176
- trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
168
+ $ sfdx cli:artifacts:compare [--json] [-p <value>] [-r <value>] [-c <value>]
177
169
 
178
170
  FLAGS
179
- -t, --contains-package-type=(plugin|library|orb) filter based on type of package
180
- --json format output as json
181
- --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
182
- this command invocation
171
+ -c, --current=<value> Current CLI version to compare against. Defaults to the version on the CLI in the current
172
+ directory.
173
+ -p, --plugin=<value>... List of plugins to check for breaking changes.
174
+ -r, --previous=<value> Previous CLI version to compare against. Defaults to the last published version.
183
175
 
184
- DESCRIPTION
185
- list known Circle CI slugs from 'sfdx repositories'
176
+ GLOBAL FLAGS
177
+ --json Format output as json.
186
178
 
187
179
  EXAMPLES
188
- $ sfdx circleci -t plugin
180
+ $ sfdx cli:artifacts:compare
189
181
  ```
190
182
 
191
- _See code: [src/commands/circleci/index.ts](https://github.com/salesforcecli/plugin-release-management/blob/v3.1.0/src/commands/circleci/index.ts)_
183
+ _See code: [src/commands/cli/artifacts/compare.ts](https://github.com/salesforcecli/plugin-release-management/blob/4.3.2/src/commands/cli/artifacts/compare.ts)_
192
184
 
193
- ## `sfdx circleci:envvar:create -e <string> [-s <string>] [--dryrun] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
185
+ ## `sfdx cli:install:jit:test`
194
186
 
195
- update environment variable(s) on Circle CI slug(s)
187
+ Test that all JIT plugins can be successfully installed.
196
188
 
197
189
  ```
198
190
  USAGE
199
- $ sfdx circleci:envvar:create -e <string> [-s <string>] [--dryrun] [--json] [--loglevel
200
- trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
201
-
202
- FLAGS
203
- -e, --envvar=<value>... (required) a environment variables
204
- to set on the given circle slug(s)
205
- -s, --slug=<value>... a circle ci slugs in the format
206
- <vcs>/<org name>/<repo name>
207
- --dryrun do validation but do not update the
208
- environment variable values
209
- --json format output as json
210
- --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
211
- this command invocation
212
-
213
- DESCRIPTION
214
- update environment variable(s) on Circle CI slug(s)
191
+ $ sfdx cli:install:jit:test [--json]
215
192
 
216
- Updates one or more environment variables on one or more CIrcle CI slugs. The environment variables must already exist
217
- on the slug. You will be prompted for the environment variable values unless they already exist on the process. The
218
- slugs can be piped in. If so, the environment variables must be on the process (prompting is disabled).
193
+ GLOBAL FLAGS
194
+ --json Format output as json.
219
195
 
220
196
  EXAMPLES
221
- $ sfdx circleci:envvar:create -e 'MY_ENV_VAR' -s 'gh/<org>/<repository>'
222
-
223
- echo "gh/<org>/<repository>" | sfdx circleci:envvar:create -e 'MY_ENV_VAR'
224
-
225
- $ sfdx circleci -t plugin | sfdx circleci:envvar:create -e 'MY_ENV_VAR' -e 'MY_OTHER_ENV_VAR'
197
+ $ sfdx cli:install:jit:test
226
198
  ```
227
199
 
228
- _See code: [src/commands/circleci/envvar/create.ts](https://github.com/salesforcecli/plugin-release-management/blob/v3.1.0/src/commands/circleci/envvar/create.ts)_
200
+ _See code: [src/commands/cli/install/jit/test.ts](https://github.com/salesforcecli/plugin-release-management/blob/4.3.2/src/commands/cli/install/jit/test.ts)_
229
201
 
230
- ## `sfdx circleci:envvar:update -e <string> [-s <string>] [--dryrun] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
202
+ ## `sfdx cli:install:test`
231
203
 
232
- update environment variable(s) on Circle CI slug(s)
204
+ install sf or sfdx
233
205
 
234
206
  ```
235
207
  USAGE
236
- $ sfdx circleci:envvar:update -e <string> [-s <string>] [--dryrun] [--json] [--loglevel
237
- trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
208
+ $ sfdx cli:install:test -c sf|sfdx -m installer|npm|tarball [--json] [--channel
209
+ legacy|stable|stable-rc|latest|latest-rc] [--output-file <value>]
238
210
 
239
211
  FLAGS
240
- -e, --envvar=<value>... (required) a environment variables
241
- to set on the given circle slug(s)
242
- -s, --slug=<value>... a circle ci slugs in the format
243
- <vcs>/<org name>/<repo name>
244
- --dryrun do validation but do not update the
245
- environment variable values
246
- --json format output as json
247
- --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
248
- this command invocation
212
+ -c, --cli=<option> (required) the cli to install
213
+ <options: sf|sfdx>
214
+ -m, --method=<option> (required) the installation method to use
215
+ <options: installer|npm|tarball>
216
+ --channel=<option> [default: stable] the channel to install from
217
+ <options: legacy|stable|stable-rc|latest|latest-rc>
218
+ --output-file=<value> [default: test-results.json] the file to write the JSON results to (must be .json)
219
+
220
+ GLOBAL FLAGS
221
+ --json Format output as json.
249
222
 
250
223
  DESCRIPTION
251
- update environment variable(s) on Circle CI slug(s)
224
+ install sf or sfdx
252
225
 
253
- Updates one or more environment variables on one or more CIrcle CI slugs. The environment variables must already exist
254
- on the slug. You will be prompted for the environment variable values unless they already exist on the process. The
255
- slugs can be piped in. If so, the environment variables must be on the process (prompting is disabled).
226
+ install sf or sfdx
256
227
 
257
228
  EXAMPLES
258
- $ sfdx circleci:envvar:update -e 'MY_ENV_VAR' -s 'gh/<org>/<repository>'
229
+ $ sfdx cli:install:test --cli sfdx --method installer
259
230
 
260
- echo "gh/<org>/<repository>" | sfdx circleci:envvar:update -e 'MY_ENV_VAR'
231
+ $ sfdx cli:install:test --cli sfdx --method npm
261
232
 
262
- $ sfdx circleci -t plugin | sfdx circleci:envvar:update -e 'MY_ENV_VAR' -e 'MY_OTHER_ENV_VAR'
233
+ $ sfdx cli:install:test --cli sfdx --method tarball
234
+
235
+ $ sfdx cli:install:test --cli sf --method tarball
236
+
237
+ $ sfdx cli:install:test --cli sf --method tarball --channel stable-rc
263
238
  ```
264
239
 
265
- _See code: [src/commands/circleci/envvar/update.ts](https://github.com/salesforcecli/plugin-release-management/blob/v3.1.0/src/commands/circleci/envvar/update.ts)_
240
+ _See code: [src/commands/cli/install/test.ts](https://github.com/salesforcecli/plugin-release-management/blob/4.3.2/src/commands/cli/install/test.ts)_
266
241
 
267
- ## `sfdx cli:install:test -c <string> -m <string> [--channel <string>] [--output-file <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
242
+ ## `sfdx cli:release:automerge`
268
243
 
269
- install sf or sfdx
244
+ Attempt to automerge nightly PR
270
245
 
271
246
  ```
272
247
  USAGE
273
- $ sfdx cli:install:test -c <string> -m <string> [--channel <string>] [--output-file <string>] [--json] [--loglevel
274
- trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
248
+ $ sfdx cli:release:automerge (--owner <value> --repo <value>) --pull-number <value> [--json] [-d] [--verbose]
275
249
 
276
250
  FLAGS
277
- -c, --cli=<option> (required) the cli to install
278
- <options: sf|sfdx>
279
- -m, --method=<option> (required) the installation method
280
- to use
281
- <options: installer|npm|tarball>
282
- --channel=<option> [default: stable] the channel to
283
- install from
284
- <options: legacy|stable|stable-rc|la
285
- test|latest-rc>
286
- --json format output as json
287
- --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
288
- this command invocation
289
- --output-file=<value> [default: test-results.json] the
290
- file to write the JSON results to
291
- (must be .json)
251
+ -d, --dry-run Run all checks, but do not merge PR
252
+ --owner=<value> (required) Github owner (org), example: salesforcecli
253
+ --pull-number=<value> (required) Github pull request number to merge
254
+ --repo=<value> (required) Github repo, example: sfdx-cli
255
+ --verbose Show additional debug output
292
256
 
293
- DESCRIPTION
294
- install sf or sfdx
257
+ GLOBAL FLAGS
258
+ --json Format output as json.
295
259
 
296
- EXAMPLES
297
- $ sfdx cli:install:test --cli sfdx --method installer
298
-
299
- $ sfdx cli:install:test --cli sfdx --method npm
300
-
301
- $ sfdx cli:install:test --cli sfdx --method tarball
260
+ DESCRIPTION
261
+ Attempt to automerge nightly PR
302
262
 
303
- $ sfdx cli:install:test --cli sf --method tarball
263
+ Attempt to automerge nightly PR
304
264
 
305
- $ sfdx cli:install:test --cli sf --method tarball --channel stable-rc
265
+ EXAMPLES
266
+ $ sfdx cli:release:automerge --owner salesforcecli --repo sfdx-cli --pul-number 1049
306
267
  ```
307
268
 
308
- _See code: [src/commands/cli/install/test.ts](https://github.com/salesforcecli/plugin-release-management/blob/v3.1.0/src/commands/cli/install/test.ts)_
269
+ _See code: [src/commands/cli/release/automerge.ts](https://github.com/salesforcecli/plugin-release-management/blob/4.3.2/src/commands/cli/release/automerge.ts)_
309
270
 
310
- ## `sfdx cli:latestrc:build [--rctag <string>] [--build-only] [--resolutions] [--only <array>] [--pinned-deps] [--patch] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
271
+ ## `sfdx cli:release:build`
311
272
 
312
- creates a PR to the repository property defined in the package.json to release a latest-rc build
273
+ builds a new release from a designated starting point and optionally creates PR in Github
313
274
 
314
275
  ```
315
276
  USAGE
316
- $ sfdx cli:latestrc:build [--rctag <string>] [--build-only] [--resolutions] [--only <array>] [--pinned-deps] [--patch]
317
- [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
277
+ $ sfdx cli:release:build -c <value> [--json] [-d <value>] [-g <value>] [--build-only] [--resolutions] [--only
278
+ <value>] [--pinned-deps] [--jit] [--label <value>] [--patch] [--empty] [--pr-base-branch <value>]
318
279
 
319
280
  FLAGS
320
- --build-only only build the latest rc, do not git
321
- add/commit/push
322
- --json format output as json
323
- --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
324
- this command invocation
325
- --only=<value> only bump the version of the
326
- packages passed in, uses latest if
327
- version is not provided
328
- --patch bump the release as a patch of an
329
- existing version, not a new minor
330
- version
331
- --[no-]pinned-deps bump the versions of the packages
332
- listed in the pinnedDependencies
333
- section
334
- --rctag=<value> [default: latest-rc] the tag name
335
- that corresponds to the npm RC
336
- build, usually latest-rc or
337
- stable-rc
338
- --[no-]resolutions bump the versions of packages listed
339
- in the resolutions section
281
+ -c, --release-channel=<value> (required) the channel intended for this release, examples: nightly, latest-rc,
282
+ latest, dev, beta, etc...
283
+ -d, --start-from-npm-dist-tag=<value> the npm dist-tag to start the release from, examples: nightly, latest-rc
284
+ -g, --start-from-github-ref=<value> a Github ref to start the release from, examples: main, 7.144.0, f476e8e
285
+ --build-only only build the release, do not git add/commit/push
286
+ --empty create an empty release PR for pushing changes to later (version will still be
287
+ bumped)
288
+ --[no-]jit bump the versions of the packages listed in the jitPlugins (just-in-time)
289
+ section
290
+ --label=<value>... add one or more labels to the Github PR
291
+ --only=<value>... only bump the version of the packages passed in, uses latest if version is not
292
+ provided
293
+ --patch bump the release as a patch of an existing version, not a new minor version
294
+ --[no-]pinned-deps bump the versions of the packages listed in the pinnedDependencies section
295
+ --pr-base-branch=<value> base branch to create the PR against; if not specified, the build determines
296
+ the branch for you
297
+ --[no-]resolutions bump the versions of packages listed in the resolutions section
298
+
299
+ GLOBAL FLAGS
300
+ --json Format output as json.
340
301
 
341
302
  DESCRIPTION
342
- creates a PR to the repository property defined in the package.json to release a latest-rc build
303
+ builds a new release from a designated starting point and optionally creates PR in Github
343
304
 
344
- EXAMPLES
305
+ builds a new release from a designated starting point and optionally creates PR in Github
306
+
307
+ ALIASES
345
308
  $ sfdx cli:latestrc:build
346
309
 
347
- $ sfdx cli:latestrc:build --patch
310
+ EXAMPLES
311
+ $ sfdx cli:release:build
312
+
313
+ $ sfdx cli:release:build --patch
314
+
315
+ $ sfdx cli:release:build --start-from-npm-dist-tag latest-rc --patch
316
+
317
+ $ sfdx cli:release:build --start-from-github-ref 7.144.0
348
318
 
349
- $ sfdx cli:latestrc:build --build-only
319
+ $ sfdx cli:release:build --start-from-github-ref main
350
320
 
351
- $ sfdx cli:latestrc:build --only @salesforce/plugin-source,@salesforce/plugin-info@1.2.3,@sf/config
321
+ $ sfdx cli:release:build --start-from-github-ref f476e8e
322
+
323
+ $ sfdx cli:release:build --start-from-github-ref main --prerelease beta
324
+
325
+ $ sfdx cli:release:build --build-only
326
+
327
+ $ sfdx cli:release:build --only @salesforce/plugin-source,@salesforce/plugin-info@1.2.3,@sf/config
352
328
  ```
353
329
 
354
- _See code: [src/commands/cli/latestrc/build.ts](https://github.com/salesforcecli/plugin-release-management/blob/v3.1.0/src/commands/cli/latestrc/build.ts)_
330
+ _See code: [src/commands/cli/release/build.ts](https://github.com/salesforcecli/plugin-release-management/blob/4.3.2/src/commands/cli/release/build.ts)_
355
331
 
356
- ## `sfdx cli:releasenotes -c <string> [-s <string>] [-m] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
332
+ ## `sfdx cli:releasenotes`
357
333
 
358
334
  pull all relevant information for writing release notes.
359
335
 
360
336
  ```
361
337
  USAGE
362
- $ sfdx cli:releasenotes -c <string> [-s <string>] [-m] [--json] [--loglevel
363
- trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
338
+ $ sfdx cli:releasenotes -c sf|sfdx [--json] [-s <value>] [-m]
364
339
 
365
340
  FLAGS
366
- -c, --cli=<option> (required) the cli to pull
367
- information for
368
- <options: sf|sfdx>
369
- -m, --markdown format the output in markdown
370
- -s, --since=<value> the version number of the previous
371
- release. Defaults to the latest-rc
372
- version on npm
373
- --json format output as json
374
- --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
375
- this command invocation
341
+ -c, --cli=<option> (required) the cli to pull information for
342
+ <options: sf|sfdx>
343
+ -m, --markdown format the output in markdown
344
+ -s, --since=<value> the version number of the previous release. Defaults to the latest-rc version on npm
345
+
346
+ GLOBAL FLAGS
347
+ --json Format output as json.
376
348
 
377
349
  DESCRIPTION
378
350
  pull all relevant information for writing release notes.
351
+ Requires the GH_TOKEN to be set in the environment.
379
352
 
353
+ pull all relevant information for writing release notes.
380
354
  Requires the GH_TOKEN to be set in the environment.
381
355
 
382
356
  EXAMPLES
@@ -393,132 +367,107 @@ EXAMPLES
393
367
  $ sfdx cli:releasenotes --cli sf --markdown > changes.md
394
368
  ```
395
369
 
396
- _See code: [src/commands/cli/releasenotes.ts](https://github.com/salesforcecli/plugin-release-management/blob/v3.1.0/src/commands/cli/releasenotes.ts)_
370
+ _See code: [src/commands/cli/releasenotes.ts](https://github.com/salesforcecli/plugin-release-management/blob/4.3.2/src/commands/cli/releasenotes.ts)_
397
371
 
398
- ## `sfdx cli:schemas:collect [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
399
-
400
- collect schemas from installed plugins
401
-
402
- ```
403
- USAGE
404
- $ sfdx cli:schemas:collect [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
405
-
406
- FLAGS
407
- --json format output as json
408
- --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
409
- this command invocation
410
-
411
- DESCRIPTION
412
- collect schemas from installed plugins
413
-
414
- EXAMPLES
415
- $ sfdx cli:schemas:collect
416
- ```
417
-
418
- _See code: [src/commands/cli/schemas/collect.ts](https://github.com/salesforcecli/plugin-release-management/blob/v3.1.0/src/commands/cli/schemas/collect.ts)_
419
-
420
- ## `sfdx cli:schemas:compare [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
372
+ ## `sfdx cli:schemas:compare`
421
373
 
422
374
  compare schemas from installed plugins
423
375
 
424
376
  ```
425
377
  USAGE
426
- $ sfdx cli:schemas:compare [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
378
+ $ sfdx cli:schemas:compare [--json]
427
379
 
428
- FLAGS
429
- --json format output as json
430
- --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
431
- this command invocation
380
+ GLOBAL FLAGS
381
+ --json Format output as json.
432
382
 
433
383
  DESCRIPTION
434
384
  compare schemas from installed plugins
435
385
 
386
+ compare schemas from installed plugins
387
+
436
388
  EXAMPLES
437
389
  $ sfdx cli:schemas:compare
438
390
  ```
439
391
 
440
- _See code: [src/commands/cli/schemas/compare.ts](https://github.com/salesforcecli/plugin-release-management/blob/v3.1.0/src/commands/cli/schemas/compare.ts)_
392
+ _See code: [src/commands/cli/schemas/compare.ts](https://github.com/salesforcecli/plugin-release-management/blob/4.3.2/src/commands/cli/schemas/compare.ts)_
441
393
 
442
- ## `sfdx cli:tarballs:prepare [-d] [-t] [--verbose] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
394
+ ## `sfdx cli:tarballs:prepare`
443
395
 
444
396
  remove unnecessary files from node_modules
445
397
 
446
398
  ```
447
399
  USAGE
448
- $ sfdx cli:tarballs:prepare [-d] [-t] [--verbose] [--json] [--loglevel
449
- trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
400
+ $ sfdx cli:tarballs:prepare [--json] [-d] [-t] [--verbose]
450
401
 
451
402
  FLAGS
452
- -d, --dryrun only show what would be removed from
453
- node_modules
454
- -t, --types remove all types (.d.ts) files from
455
- node_modules
456
- --json format output as json
457
- --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
458
- this command invocation
459
- --verbose show all files paths being removed
403
+ -d, --dryrun only show what would be removed from node_modules
404
+ -t, --types remove all types (.d.ts) files from node_modules
405
+ --verbose show all files paths being removed
406
+
407
+ GLOBAL FLAGS
408
+ --json Format output as json.
460
409
 
461
410
  DESCRIPTION
462
411
  remove unnecessary files from node_modules
463
412
 
413
+ remove unnecessary files from node_modules
414
+
464
415
  EXAMPLES
465
416
  $ sfdx cli:tarballs:prepare
466
417
  ```
467
418
 
468
- _See code: [src/commands/cli/tarballs/prepare.ts](https://github.com/salesforcecli/plugin-release-management/blob/v3.1.0/src/commands/cli/tarballs/prepare.ts)_
419
+ _See code: [src/commands/cli/tarballs/prepare.ts](https://github.com/salesforcecli/plugin-release-management/blob/4.3.2/src/commands/cli/tarballs/prepare.ts)_
469
420
 
470
- ## `sfdx cli:tarballs:smoke -c <string> [--verbose] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
421
+ ## `sfdx cli:tarballs:smoke`
471
422
 
472
- smoke tests for the tarballed CLI
423
+ smoke tests for the sf CLI
473
424
 
474
425
  ```
475
426
  USAGE
476
- $ sfdx cli:tarballs:smoke -c <string> [--verbose] [--json] [--loglevel
477
- trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
427
+ $ sfdx cli:tarballs:smoke [--json] [--verbose]
478
428
 
479
429
  FLAGS
480
- -c, --cli=<option> (required) the cli to install
481
- <options: sf|sfdx>
482
- --json format output as json
483
- --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
484
- this command invocation
485
- --verbose show the --help output for each
486
- command
430
+ --verbose show the --help output for each command
431
+
432
+ GLOBAL FLAGS
433
+ --json Format output as json.
487
434
 
488
435
  DESCRIPTION
489
- smoke tests for the tarballed CLI
436
+ smoke tests for the sf CLI
437
+ Tests that the CLI and every command can be initialized.
490
438
 
439
+ smoke tests for the sf CLI
491
440
  Tests that the CLI and every command can be initialized.
492
441
 
493
442
  EXAMPLES
494
- $ sfdx cli:tarballs:smoke --cli sfdx
443
+ $ sfdx cli:tarballs:smoke
495
444
 
496
- $ sfdx cli:tarballs:smoke --cli sf
445
+ $ sfdx cli:tarballs:smoke
497
446
  ```
498
447
 
499
- _See code: [src/commands/cli/tarballs/smoke.ts](https://github.com/salesforcecli/plugin-release-management/blob/v3.1.0/src/commands/cli/tarballs/smoke.ts)_
448
+ _See code: [src/commands/cli/tarballs/smoke.ts](https://github.com/salesforcecli/plugin-release-management/blob/4.3.2/src/commands/cli/tarballs/smoke.ts)_
500
449
 
501
- ## `sfdx cli:tarballs:verify [-c sf|sfdx] [-w <number>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
450
+ ## `sfdx cli:tarballs:verify`
502
451
 
503
452
  verify that tarballs are ready to be uploaded
504
453
 
505
454
  ```
506
455
  USAGE
507
- $ sfdx cli:tarballs:verify [-c sf|sfdx] [-w <number>] [--json] [--loglevel
508
- trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
456
+ $ sfdx cli:tarballs:verify [--json] [-c sf|sfdx] [-w <value>]
509
457
 
510
458
  FLAGS
511
- -c, --cli=(sf|sfdx) [default: sfdx] the cli to verify
512
- -w, --windows-username-buffer=<value> [default: 41] the number of
513
- characters to allow for windows
514
- usernames
515
- --json format output as json
516
- --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
517
- this command invocation
459
+ -c, --cli=<option> [default: sfdx] the cli to verify
460
+ <options: sf|sfdx>
461
+ -w, --windows-username-buffer=<value> [default: 41] the number of characters to allow for windows usernames
462
+
463
+ GLOBAL FLAGS
464
+ --json Format output as json.
518
465
 
519
466
  DESCRIPTION
520
467
  verify that tarballs are ready to be uploaded
521
468
 
469
+ verify that tarballs are ready to be uploaded
470
+
522
471
  EXAMPLES
523
472
  $ sfdx cli:tarballs:verify
524
473
 
@@ -527,45 +476,36 @@ EXAMPLES
527
476
  $ sfdx cli:tarballs:verify --cli sf
528
477
  ```
529
478
 
530
- _See code: [src/commands/cli/tarballs/verify.ts](https://github.com/salesforcecli/plugin-release-management/blob/v3.1.0/src/commands/cli/tarballs/verify.ts)_
479
+ _See code: [src/commands/cli/tarballs/verify.ts](https://github.com/salesforcecli/plugin-release-management/blob/4.3.2/src/commands/cli/tarballs/verify.ts)_
531
480
 
532
- ## `sfdx cli:versions:inspect -c <string> -l <string> --cli sf|sfdx [-d <string>] [-s] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
481
+ ## `sfdx cli:versions:inspect`
533
482
 
534
483
  inspect the CLI version across all install paths
535
484
 
536
485
  ```
537
486
  USAGE
538
- $ sfdx cli:versions:inspect -c <string> -l <string> --cli sf|sfdx [-d <string>] [-s] [--json] [--loglevel
539
- trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
487
+ $ sfdx cli:versions:inspect -c legacy|stable|stable-rc|latest|latest-rc|nightly -l archive|npm --cli sf|sfdx [--json]
488
+ [-d <value>] [-s]
540
489
 
541
490
  FLAGS
542
- -c, --channels=<option>...
543
- (required) the channel you want to inspect (for achives, latest and latest-rc are translated to stable and
544
- stable-rc. And vice-versa for npm)
545
- <options: legacy|stable|stable-rc|latest|latest-rc>
546
-
547
- -d, --dependencies=<value>...
548
- glob pattern of dependencies you want to see the version of
549
-
550
- -l, --locations=<option>...
551
- (required) the location you want to inspect
552
- <options: archive|npm>
553
-
554
- -s, --salesforce
555
- show versions of salesforce owned dependencies
556
-
557
- --cli=(sf|sfdx)
558
- (required) [default: sfdx] the CLI you want to inspect
559
-
560
- --json
561
- format output as json
562
-
563
- --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)
564
- [default: warn] logging level for this command invocation
491
+ -c, --channels=<option>... (required) the channel you want to inspect (for achives, latest and latest-rc are
492
+ translated to stable and stable-rc. And vice-versa for npm)
493
+ <options: legacy|stable|stable-rc|latest|latest-rc|nightly>
494
+ -d, --dependencies=<value>... glob pattern of dependencies you want to see the version of
495
+ -l, --locations=<option>... (required) the location you want to inspect
496
+ <options: archive|npm>
497
+ -s, --salesforce show versions of salesforce owned dependencies
498
+ --cli=<option> (required) [default: sfdx] the CLI you want to inspect
499
+ <options: sf|sfdx>
500
+
501
+ GLOBAL FLAGS
502
+ --json Format output as json.
565
503
 
566
504
  DESCRIPTION
567
505
  inspect the CLI version across all install paths
568
506
 
507
+ inspect the CLI version across all install paths
508
+
569
509
  EXAMPLES
570
510
  $ sfdx cli:versions:inspect -l archive -c stable
571
511
 
@@ -588,40 +528,37 @@ EXAMPLES
588
528
  $ sfdx cli:versions:inspect -l npm -c latest -d chalk -s
589
529
  ```
590
530
 
591
- _See code: [src/commands/cli/versions/inspect.ts](https://github.com/salesforcecli/plugin-release-management/blob/v3.1.0/src/commands/cli/versions/inspect.ts)_
531
+ _See code: [src/commands/cli/versions/inspect.ts](https://github.com/salesforcecli/plugin-release-management/blob/4.3.2/src/commands/cli/versions/inspect.ts)_
592
532
 
593
- ## `sfdx dependabot:automerge -m major|minor|patch [-o <string> -r <string>] [-d] [-s] [--merge-method merge|squash|rebase] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
533
+ ## `sfdx dependabot:automerge`
594
534
 
595
535
  automatically merge one green, mergeable PR up to the specified maximum bump type
596
536
 
597
537
  ```
598
538
  USAGE
599
- $ sfdx dependabot:automerge -m major|minor|patch [-o <string> -r <string>] [-d] [-s] [--merge-method
600
- merge|squash|rebase] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
539
+ $ sfdx dependabot:automerge -m major|minor|patch [--json] [-o <value> -r <value>] [-d] [-s] [--merge-method
540
+ merge|squash|rebase]
601
541
 
602
542
  FLAGS
603
- -d, --dryrun only show what would happen if you
604
- consolidated dependabot PRs
605
- -m, --max-version-bump=(major|minor|patch) (required) [default: minor] the
606
- maximum version bump you want to be
607
- included
608
- -o, --owner=<value> the organization that the repository
609
- belongs to. This defaults to the
610
- owner specified in the package.json
611
- -r, --repo=<value> the repository you want to
612
- consolidate PRs on. This defaults to
613
- the repository specified in the
614
- package.json
615
- -s, --skip-ci add [skip ci] to the merge commit
616
- title
617
- --json format output as json
618
- --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
619
- this command invocation
620
- --merge-method=(merge|squash|rebase) [default: merge] merge method to use
543
+ -d, --dryrun only show what would happen if you consolidated dependabot PRs
544
+ -m, --max-version-bump=<option> (required) [default: minor] the maximum version bump you want to be included
545
+ <options: major|minor|patch>
546
+ -o, --owner=<value> the organization that the repository belongs to. This defaults to the owner specified
547
+ in the package.json
548
+ -r, --repo=<value> the repository you want to consolidate PRs on. This defaults to the repository
549
+ specified in the package.json
550
+ -s, --skip-ci add [skip ci] to the merge commit title
551
+ --merge-method=<option> [default: merge] merge method to use
552
+ <options: merge|squash|rebase>
553
+
554
+ GLOBAL FLAGS
555
+ --json Format output as json.
621
556
 
622
557
  DESCRIPTION
623
558
  automatically merge one green, mergeable PR up to the specified maximum bump type
624
559
 
560
+ automatically merge one green, mergeable PR up to the specified maximum bump type
561
+
625
562
  EXAMPLES
626
563
  $ sfdx dependabot:automerge --max-version-bump patch
627
564
 
@@ -630,192 +567,109 @@ EXAMPLES
630
567
  $ sfdx dependabot:automerge --max-version-bump major
631
568
  ```
632
569
 
633
- _See code: [src/commands/dependabot/automerge.ts](https://github.com/salesforcecli/plugin-release-management/blob/v3.1.0/src/commands/dependabot/automerge.ts)_
570
+ _See code: [src/commands/dependabot/automerge.ts](https://github.com/salesforcecli/plugin-release-management/blob/4.3.2/src/commands/dependabot/automerge.ts)_
634
571
 
635
- ## `sfdx dependabot:consolidate -m major|minor|patch -b <string> -t <string> [--ignore <array>] [-d] [--no-pr] [-r <string> -o <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
572
+ ## `sfdx github:check:closed`
636
573
 
637
- consolidate dependabot PRs into a single PR
574
+ Show open Github issues with GUS WI
638
575
 
639
576
  ```
640
577
  USAGE
641
- $ sfdx dependabot:consolidate -m major|minor|patch -b <string> -t <string> [--ignore <array>] [-d] [--no-pr] [-r <string>
642
- -o <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
578
+ $ sfdx github:check:closed -o <value> --github-token <value> [--json]
643
579
 
644
580
  FLAGS
645
- -b, --base-branch=<value> (required) [default: main] name of
646
- the base branch for merging
647
- -d, --dryrun only show what would happen if you
648
- consolidated dependabot PRs
649
- -m, --max-version-bump=(major|minor|patch) (required) [default: minor] the
650
- maximum version bump you want to be
651
- included
652
- -o, --owner=<value> the organization that the repository
653
- belongs to. This defaults to the
654
- owner specified in the package.json
655
- -r, --repo=<value> the repository you want to
656
- consolidate PRs on. This defaults to
657
- the repository specified in the
658
- package.json
659
- -t, --target-branch=<value> (required) [default:
660
- consolidate-dependabot] name of the
661
- target branch for merging
662
- --ignore=<value> [default: ] ignore any PRs with
663
- titles that include this value
664
- --json format output as json
665
- --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
666
- this command invocation
667
- --no-pr do everything but create the PR
581
+ -o, --gus=<value> (required) Username/alias of your GUS org connection
582
+ --github-token=<value> (required) Github token--store this in the environment as GITHUB_TOKEN
668
583
 
669
- DESCRIPTION
670
- consolidate dependabot PRs into a single PR
584
+ GLOBAL FLAGS
585
+ --json Format output as json.
671
586
 
672
- EXAMPLES
673
- $ sfdx dependabot:consolidate --max-version-bump patch
587
+ DESCRIPTION
588
+ Show open Github issues with GUS WI
674
589
 
675
- $ sfdx dependabot:consolidate --max-version-bump minor
590
+ Description of a command.
676
591
 
677
- $ sfdx dependabot:consolidate --max-version-bump major
592
+ EXAMPLES
593
+ $ sfdx github:check:closed -o me@gus.com
678
594
  ```
679
595
 
680
- _See code: [src/commands/dependabot/consolidate.ts](https://github.com/salesforcecli/plugin-release-management/blob/v3.1.0/src/commands/dependabot/consolidate.ts)_
596
+ _See code: [src/commands/github/check/closed.ts](https://github.com/salesforcecli/plugin-release-management/blob/4.3.2/src/commands/github/check/closed.ts)_
681
597
 
682
- ## `sfdx npm:dependencies:pin [-d] [-t <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
598
+ ## `sfdx npm:dependencies:pin`
683
599
 
684
600
  lock a list of dependencies to a target tag or default to 'latest', place these entries in 'pinnedDependencies' entry in the package.json
685
601
 
686
602
  ```
687
603
  USAGE
688
- $ sfdx npm:dependencies:pin [-d] [-t <string>] [--json] [--loglevel
689
- trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
604
+ $ sfdx npm:dependencies:pin [--json] [-d] [-t <value>]
690
605
 
691
606
  FLAGS
692
- -d, --dryrun If true, will not make any changes
693
- to the package.json
694
- -t, --tag=<value> [default: latest] The name of the
695
- tag you want, e.g. 'latest-rc', or
696
- 'latest'
697
- --json format output as json
698
- --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
699
- this command invocation
607
+ -d, --dryrun If true, will not make any changes to the package.json
608
+ -t, --tag=<value> [default: latest] The name of the tag you want, e.g. 'latest-rc', or 'latest'
609
+
610
+ GLOBAL FLAGS
611
+ --json Format output as json.
700
612
 
701
613
  DESCRIPTION
702
614
  lock a list of dependencies to a target tag or default to 'latest', place these entries in 'pinnedDependencies' entry
703
615
  in the package.json
704
- ```
705
-
706
- _See code: [src/commands/npm/dependencies/pin.ts](https://github.com/salesforcecli/plugin-release-management/blob/v3.1.0/src/commands/npm/dependencies/pin.ts)_
707
-
708
- ## `sfdx npm:package:promote -c <string> [-d] [-t <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
709
-
710
- promote an npm package
711
-
712
- ```
713
- USAGE
714
- $ sfdx npm:package:promote -c <string> [-d] [-t <string>] [--json] [--loglevel
715
- trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
716
-
717
- FLAGS
718
- -c, --candidate=<value> (required) the npm tag that you want
719
- to promote
720
- -d, --dryrun If true, only show what would happen
721
- -t, --target=<value> [default: latest] the npm tag that
722
- you are promoting to
723
- --json format output as json
724
- --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
725
- this command invocation
726
616
 
727
- DESCRIPTION
728
- promote an npm package
729
-
730
- EXAMPLES
731
- $ sfdx npm:package:promote --candidate latest-rc --target latest
617
+ lock a list of dependencies to a target tag or default to 'latest', place these entries in 'pinnedDependencies' entry
618
+ in the package.json
732
619
  ```
733
620
 
734
- _See code: [src/commands/npm/package/promote.ts](https://github.com/salesforcecli/plugin-release-management/blob/v3.1.0/src/commands/npm/package/promote.ts)_
621
+ _See code: [src/commands/npm/dependencies/pin.ts](https://github.com/salesforcecli/plugin-release-management/blob/4.3.2/src/commands/npm/dependencies/pin.ts)_
735
622
 
736
- ## `sfdx npm:package:release [-d] [-s] [-t <string>] [-a <string>] [--install] [--prerelease <string>] [--verify] [--githubtag <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
623
+ ## `sfdx npm:package:release`
737
624
 
738
625
  publish npm package
739
626
 
740
627
  ```
741
628
  USAGE
742
- $ sfdx npm:package:release [-d] [-s] [-t <string>] [-a <string>] [--install] [--prerelease <string>] [--verify]
743
- [--githubtag <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
629
+ $ sfdx npm:package:release [--json] [-d] [-s] [-t <value>] [-a <value>] [--install] [--prerelease <value>] [--verify]
630
+ [--githubtag <value>]
744
631
 
745
632
  FLAGS
746
- -a, --npmaccess=<value> [default: public] access level to
747
- use when publishing to npm
748
- -d, --dryrun If true, will not commit changes to
749
- repo or push any tags
750
- -s, --sign If true, then the package will be
751
- signed and the signature will be
752
- uploaded to S3
753
- -t, --npmtag=<value> [default: latest] tag to use when
754
- publishing to npm
755
- --githubtag=<value> given a github tag, release the
756
- version specified in the
757
- package.json as is. Useful when
758
- you've already done a release and
759
- only need npm publish features
760
- --[no-]install run yarn install and build on
761
- repository
762
- --json format output as json
763
- --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
764
- this command invocation
765
- --prerelease=<value> determine the next version as
766
- <version>-<prerelease>.0 if version
767
- is not manually set
768
- --[no-]verify verify npm registry has new version
769
- after publish and digital signature
633
+ -a, --npmaccess=<value> [default: public] access level to use when publishing to npm
634
+ -d, --dryrun If true, will not commit changes to repo or push any tags
635
+ -s, --sign If true, then the package will be signed and the signature will be uploaded to S3
636
+ -t, --npmtag=<value> [default: latest] tag to use when publishing to npm
637
+ --githubtag=<value> given a github tag, release the version specified in the package.json as is. Useful when
638
+ you've already done a release and only need npm publish features
639
+ --[no-]install run yarn install and build on repository
640
+ --prerelease=<value> determine the next version as <version>-<prerelease>.0 if version is not manually set
641
+ --[no-]verify verify npm registry has new version after publish and digital signature
642
+
643
+ GLOBAL FLAGS
644
+ --json Format output as json.
770
645
 
771
646
  DESCRIPTION
772
647
  publish npm package
773
- ```
774
-
775
- _See code: [src/commands/npm/package/release.ts](https://github.com/salesforcecli/plugin-release-management/blob/v3.1.0/src/commands/npm/package/release.ts)_
776
-
777
- ## `sfdx npm:release:validate [--verbose] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
778
648
 
779
- inspects the git commits to see if there are any commits that will warrant a new release
780
-
781
- ```
782
- USAGE
783
- $ sfdx npm:release:validate [--verbose] [--json] [--loglevel
784
- trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
785
-
786
- FLAGS
787
- --json format output as json
788
- --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
789
- this command invocation
790
- --verbose show all commits for all packages
791
- (only works with --json flag)
792
-
793
- DESCRIPTION
794
- inspects the git commits to see if there are any commits that will warrant a new release
649
+ publish npm package
795
650
  ```
796
651
 
797
- _See code: [src/commands/npm/release/validate.ts](https://github.com/salesforcecli/plugin-release-management/blob/v3.1.0/src/commands/npm/release/validate.ts)_
652
+ _See code: [src/commands/npm/package/release.ts](https://github.com/salesforcecli/plugin-release-management/blob/4.3.2/src/commands/npm/package/release.ts)_
798
653
 
799
- ## `sfdx plugins:trust:verify -n <string> [-r <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
654
+ ## `sfdx plugins:trust:verify`
800
655
 
801
- Validate a digital signature for a npm package.
656
+ Validate a digital signature.
802
657
 
803
658
  ```
804
659
  USAGE
805
- $ sfdx plugins:trust:verify -n <string> [-r <string>] [--json] [--loglevel
806
- trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
660
+ $ sfdx plugins:trust:verify -n <value> [--json] [-r <value>]
807
661
 
808
662
  FLAGS
809
- -n, --npm=<value> (required) Specify the npm name.
810
- This can include a tag/version.
811
- -r, --registry=<value> The registry name. The behavior is
812
- the same as npm.
813
- --json format output as json
814
- --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
815
- this command invocation
663
+ -n, --npm=<value> (required) Specify the npm name. This can include a tag/version.
664
+ -r, --registry=<value> The registry name. The behavior is the same as npm.
665
+
666
+ GLOBAL FLAGS
667
+ --json Format output as json.
816
668
 
817
669
  DESCRIPTION
818
- Validate a digital signature for a npm package.
670
+ Validate a digital signature.
671
+
672
+ Verifies the digital signature on an npm package matches the signature and key stored at the expected URLs.
819
673
 
820
674
  EXAMPLES
821
675
  $ sfdx plugins:trust:verify --npm @scope/npmName --registry http://my.repo.org:4874
@@ -823,40 +677,36 @@ EXAMPLES
823
677
  $ sfdx plugins:trust:verify --npm @scope/npmName
824
678
  ```
825
679
 
826
- _See code: [@salesforce/plugin-trust](https://github.com/salesforcecli/plugin-trust/blob/v2.0.3/src/commands/plugins/trust/verify.ts)_
680
+ _See code: [@salesforce/plugin-trust](https://github.com/salesforcecli/plugin-trust/blob/2.6.8/src/commands/plugins/trust/verify.ts)_
827
681
 
828
- ## `sfdx`
682
+ ## `sfdx repositories`
829
683
 
830
684
  list repositories owned and supported by Salesforce CLI
831
685
 
832
686
  ```
833
687
  USAGE
834
- $ sfdx repositories [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
835
- [--columns <value> | -x] [--sort <value>] [--filter <value>] [--output csv|json|yaml | | [--csv | --no-truncate]]
836
- [--no-header | ]
688
+ $ sfdx repositories [--json] [--columns <value> | -x] [--sort <value>] [--filter <value>] [--output
689
+ csv|json|yaml | | [--csv | --no-truncate]] [--no-header | ]
837
690
 
838
691
  FLAGS
839
- -x, --extended show extra columns
840
- --columns=<value> only show provided columns
841
- (comma-separated)
842
- --csv output is csv format [alias:
843
- --output=csv]
844
- --filter=<value> filter property by partial string
845
- matching, ex: name=foo
846
- --json format output as json
847
- --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
848
- this command invocation
849
- --no-header hide table header from output
850
- --no-truncate do not truncate output to fit screen
851
- --output=<option> output in a more machine friendly
852
- format
853
- <options: csv|json|yaml>
854
- --sort=<value> property to sort by (prepend '-' for
855
- descending)
692
+ -x, --extended show extra columns
693
+ --columns=<value> only show provided columns (comma-separated)
694
+ --csv output is csv format [alias: --output=csv]
695
+ --filter=<value> filter property by partial string matching, ex: name=foo
696
+ --no-header hide table header from output
697
+ --no-truncate do not truncate output to fit screen
698
+ --output=<option> output in a more machine friendly format
699
+ <options: csv|json|yaml>
700
+ --sort=<value> property to sort by (prepend '-' for descending)
701
+
702
+ GLOBAL FLAGS
703
+ --json Format output as json.
856
704
 
857
705
  DESCRIPTION
858
706
  list repositories owned and supported by Salesforce CLI
707
+ For more information on the list of repositories, visit https://github.com/salesforcecli/status.
859
708
 
709
+ list repositories owned and supported by Salesforce CLI
860
710
  For more information on the list of repositories, visit https://github.com/salesforcecli/status.
861
711
 
862
712
  EXAMPLES
@@ -865,33 +715,6 @@ EXAMPLES
865
715
  $ sfdx repositories --json | jq -r '.result[] | select(.name=="sfdx-core") | .packages[] | .url
866
716
  ```
867
717
 
868
- _See code: [src/commands/repositories/index.ts](https://github.com/salesforcecli/plugin-release-management/blob/v3.1.0/src/commands/repositories/index.ts)_
869
-
870
- ## `sfdx typescript:update [-v <string>] [-t <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
871
-
872
- Runs tests with updated typescript version and ES target
873
-
874
- ```
875
- USAGE
876
- $ sfdx typescript:update [-v <string>] [-t <string>] [--json] [--loglevel
877
- trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
878
-
879
- FLAGS
880
- -t, --target=<value> [default: ESNext] Specify the ES
881
- target you'd like to use. Defaults
882
- to ESNext if not specified
883
- -v, --version=<value> [default: latest] Specify the
884
- typescript version you'd like to
885
- update to. Defaults to latest if not
886
- specified
887
- --json format output as json
888
- --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
889
- this command invocation
890
-
891
- DESCRIPTION
892
- Runs tests with updated typescript version and ES target
893
- ```
894
-
895
- _See code: [src/commands/typescript/update.ts](https://github.com/salesforcecli/plugin-release-management/blob/v3.1.0/src/commands/typescript/update.ts)_
718
+ _See code: [src/commands/repositories/index.ts](https://github.com/salesforcecli/plugin-release-management/blob/4.3.2/src/commands/repositories/index.ts)_
896
719
 
897
720
  <!-- commandsstop -->