@salesforce/plugin-release-management 5.8.18 → 5.8.20

package/README.md

@@ -145,7 +145,7 @@ EXAMPLES
   $ sfdx channel promote --candidate latest-rc --target latest --platform win --platform mac
 ```
 
-_See code: [src/commands/channel/promote.ts](https://github.com/salesforcecli/plugin-release-management/blob/5.8.18/src/commands/channel/promote.ts)_
+_See code: [src/commands/channel/promote.ts](https://github.com/salesforcecli/plugin-release-management/blob/5.8.20/src/commands/channel/promote.ts)_
 
 ## `sfdx cli artifacts compare`
 
@@ -169,7 +169,7 @@ EXAMPLES
   $ sfdx cli artifacts compare
 ```
 
-_See code: [src/commands/cli/artifacts/compare.ts](https://github.com/salesforcecli/plugin-release-management/blob/5.8.18/src/commands/cli/artifacts/compare.ts)_
+_See code: [src/commands/cli/artifacts/compare.ts](https://github.com/salesforcecli/plugin-release-management/blob/5.8.20/src/commands/cli/artifacts/compare.ts)_
 
 ## `sfdx cli install jit test`
 
@@ -190,7 +190,7 @@ EXAMPLES
   $ sfdx cli install jit test
 ```
 
-_See code: [src/commands/cli/install/jit/test.ts](https://github.com/salesforcecli/plugin-release-management/blob/5.8.18/src/commands/cli/install/jit/test.ts)_
+_See code: [src/commands/cli/install/jit/test.ts](https://github.com/salesforcecli/plugin-release-management/blob/5.8.20/src/commands/cli/install/jit/test.ts)_
 
 ## `sfdx cli install test`
 
@@ -231,7 +231,7 @@ EXAMPLES
   $ sfdx cli install test --cli sf --method tarball --channel stable-rc
 ```
 
-_See code: [src/commands/cli/install/test.ts](https://github.com/salesforcecli/plugin-release-management/blob/5.8.18/src/commands/cli/install/test.ts)_
+_See code: [src/commands/cli/install/test.ts](https://github.com/salesforcecli/plugin-release-management/blob/5.8.20/src/commands/cli/install/test.ts)_
 
 ## `sfdx cli release automerge`
 
@@ -262,7 +262,7 @@ EXAMPLES
   $ sfdx cli release automerge --owner salesforcecli --repo sfdx-cli --pul-number 1049
 ```
 
-_See code: [src/commands/cli/release/automerge.ts](https://github.com/salesforcecli/plugin-release-management/blob/5.8.18/src/commands/cli/release/automerge.ts)_
+_See code: [src/commands/cli/release/automerge.ts](https://github.com/salesforcecli/plugin-release-management/blob/5.8.20/src/commands/cli/release/automerge.ts)_
 
 ## `sfdx cli release build`
 
@@ -325,7 +325,7 @@ EXAMPLES
   $ sfdx cli release build --only @salesforce/plugin-source,@salesforce/plugin-info@1.2.3
 ```
 
-_See code: [src/commands/cli/release/build.ts](https://github.com/salesforcecli/plugin-release-management/blob/5.8.18/src/commands/cli/release/build.ts)_
+_See code: [src/commands/cli/release/build.ts](https://github.com/salesforcecli/plugin-release-management/blob/5.8.20/src/commands/cli/release/build.ts)_
 
 ## `sfdx cli releasenotes`
 
@@ -366,7 +366,7 @@ EXAMPLES
   $ sfdx cli releasenotes --cli sf --markdown > changes.md
 ```
 
-_See code: [src/commands/cli/releasenotes.ts](https://github.com/salesforcecli/plugin-release-management/blob/5.8.18/src/commands/cli/releasenotes.ts)_
+_See code: [src/commands/cli/releasenotes.ts](https://github.com/salesforcecli/plugin-release-management/blob/5.8.20/src/commands/cli/releasenotes.ts)_
 
 ## `sfdx cli tarballs prepare`
 
@@ -394,7 +394,7 @@ EXAMPLES
   $ sfdx cli tarballs prepare
 ```
 
-_See code: [src/commands/cli/tarballs/prepare.ts](https://github.com/salesforcecli/plugin-release-management/blob/5.8.18/src/commands/cli/tarballs/prepare.ts)_
+_See code: [src/commands/cli/tarballs/prepare.ts](https://github.com/salesforcecli/plugin-release-management/blob/5.8.20/src/commands/cli/tarballs/prepare.ts)_
 
 ## `sfdx cli tarballs smoke`
 
@@ -424,7 +424,7 @@ EXAMPLES
   $ sfdx cli tarballs smoke
 ```
 
-_See code: [src/commands/cli/tarballs/smoke.ts](https://github.com/salesforcecli/plugin-release-management/blob/5.8.18/src/commands/cli/tarballs/smoke.ts)_
+_See code: [src/commands/cli/tarballs/smoke.ts](https://github.com/salesforcecli/plugin-release-management/blob/5.8.20/src/commands/cli/tarballs/smoke.ts)_
 
 ## `sfdx cli tarballs verify`
 
@@ -456,7 +456,7 @@ EXAMPLES
   $ sfdx cli tarballs verify --cli sf
 ```
 
-_See code: [src/commands/cli/tarballs/verify.ts](https://github.com/salesforcecli/plugin-release-management/blob/5.8.18/src/commands/cli/tarballs/verify.ts)_
+_See code: [src/commands/cli/tarballs/verify.ts](https://github.com/salesforcecli/plugin-release-management/blob/5.8.20/src/commands/cli/tarballs/verify.ts)_
 
 ## `sfdx cli versions inspect`
 
@@ -508,7 +508,7 @@ EXAMPLES
   $ sfdx cli versions inspect -l npm -c latest -d chalk -s
 ```
 
-_See code: [src/commands/cli/versions/inspect.ts](https://github.com/salesforcecli/plugin-release-management/blob/5.8.18/src/commands/cli/versions/inspect.ts)_
+_See code: [src/commands/cli/versions/inspect.ts](https://github.com/salesforcecli/plugin-release-management/blob/5.8.20/src/commands/cli/versions/inspect.ts)_
 
 ## `sfdx dependabot automerge`
 
@@ -548,7 +548,7 @@ EXAMPLES
   $ sfdx dependabot automerge --max-version-bump major
 ```
 
-_See code: [src/commands/dependabot/automerge.ts](https://github.com/salesforcecli/plugin-release-management/blob/5.8.18/src/commands/dependabot/automerge.ts)_
+_See code: [src/commands/dependabot/automerge.ts](https://github.com/salesforcecli/plugin-release-management/blob/5.8.20/src/commands/dependabot/automerge.ts)_
 
 ## `sfdx github check closed`
 
@@ -575,7 +575,7 @@ EXAMPLES
   $ sfdx github check closed -o me@gus.com
 ```
 
-_See code: [src/commands/github/check/closed.ts](https://github.com/salesforcecli/plugin-release-management/blob/5.8.18/src/commands/github/check/closed.ts)_
+_See code: [src/commands/github/check/closed.ts](https://github.com/salesforcecli/plugin-release-management/blob/5.8.20/src/commands/github/check/closed.ts)_
 
 ## `sfdx npm dependencies pin`
 
@@ -601,7 +601,7 @@ DESCRIPTION
   in the package.json
 ```
 
-_See code: [src/commands/npm/dependencies/pin.ts](https://github.com/salesforcecli/plugin-release-management/blob/5.8.18/src/commands/npm/dependencies/pin.ts)_
+_See code: [src/commands/npm/dependencies/pin.ts](https://github.com/salesforcecli/plugin-release-management/blob/5.8.20/src/commands/npm/dependencies/pin.ts)_
 
 ## `sfdx npm package release`
 
@@ -633,7 +633,7 @@ DESCRIPTION
   publish npm package
 ```
 
-_See code: [src/commands/npm/package/release.ts](https://github.com/salesforcecli/plugin-release-management/blob/5.8.18/src/commands/npm/package/release.ts)_
+_See code: [src/commands/npm/package/release.ts](https://github.com/salesforcecli/plugin-release-management/blob/5.8.20/src/commands/npm/package/release.ts)_
 
 ## `sfdx plugins trust verify`
 
@@ -701,6 +701,6 @@ EXAMPLES
   $ sfdx repositories --json | jq -r '.result[] | select(.name=="sfdx-core") | .packages[] | .url
 ```
 
-_See code: [src/commands/repositories/index.ts](https://github.com/salesforcecli/plugin-release-management/blob/5.8.18/src/commands/repositories/index.ts)_
+_See code: [src/commands/repositories/index.ts](https://github.com/salesforcecli/plugin-release-management/blob/5.8.20/src/commands/repositories/index.ts)_
 
 <!-- commandsstop -->

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@salesforce/plugin-release-management",
-  "version": "5.8.18",
+  "version": "5.8.20",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@salesforce/plugin-release-management",
-      "version": "5.8.18",
+      "version": "5.8.20",
       "license": "BSD-3-Clause",
       "dependencies": {
         "@aws-sdk/client-s3": "^3.1024.0",
@@ -10960,10 +10960,20 @@
       }
     },
     "node_modules/fast-uri": {
-      "version": "3.0.1",
-      "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.0.1.tgz",
-      "integrity": "sha512-MWipKbbYiYI0UC7cl8m/i/IWTqfC8YXsqjzybjddLsFjStroQzsHXkc73JutMvBiXmOvapk+axIl79ig5t55Bw==",
-      "license": "MIT"
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.2.tgz",
+      "integrity": "sha512-rVjf7ArG3LTk+FS6Yw81V1DLuZl1bRbNrev6Tmd/9RaroeeRRJhAt7jg/6YFxbvAQXUCavSoZhPPj6oOx+5KjQ==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "BSD-3-Clause"
     },
     "node_modules/fast-wrap-ansi": {
       "version": "0.2.0",
@@ -10975,9 +10985,9 @@
       }
     },
     "node_modules/fast-xml-builder": {
-      "version": "1.1.4",
-      "resolved": "https://registry.npmjs.org/fast-xml-builder/-/fast-xml-builder-1.1.4.tgz",
-      "integrity": "sha512-f2jhpN4Eccy0/Uz9csxh3Nu6q4ErKxf0XIsasomfOihuSUa3/xw6w8dnOtCDgEItQFJG8KyXPzQXzcODDrrbOg==",
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/fast-xml-builder/-/fast-xml-builder-1.2.0.tgz",
+      "integrity": "sha512-00aAWieqff+ZJhsXA4g1g7M8k+7AYoMUUHF+/zFb5U6Uv/P0Vl4QZo84/IcufzYalLuEj9928bXN9PbbFzMF0Q==",
       "funding": [
         {
           "type": "github",
@@ -10986,7 +10996,23 @@
       ],
       "license": "MIT",
       "dependencies": {
-        "path-expression-matcher": "^1.1.3"
+        "path-expression-matcher": "^1.5.0",
+        "xml-naming": "^0.1.0"
+      }
+    },
+    "node_modules/fast-xml-builder/node_modules/path-expression-matcher": {
+      "version": "1.5.0",
+      "resolved": "https://registry.npmjs.org/path-expression-matcher/-/path-expression-matcher-1.5.0.tgz",
+      "integrity": "sha512-cbrerZV+6rvdQrrD+iGMcZFEiiSrbv9Tfdkvnusy6y0x0GKBXREFg/Y65GhIfm0tnLntThhzCnfKwp1WRjeCyQ==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/NaturalIntelligence"
+        }
+      ],
+      "license": "MIT",
+      "engines": {
+        "node": ">=14.0.0"
       }
     },
     "node_modules/fast-xml-parser": {
@@ -24433,6 +24459,21 @@
         }
       }
     },
+    "node_modules/xml-naming": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/xml-naming/-/xml-naming-0.1.0.tgz",
+      "integrity": "sha512-k8KO9hrMyNk6tUWqUfkTEZbezRRpONVOzUTnc97VnCvyj6Tf9lyUR9EDAIeiVLv56jsMcoXEwjW8Kv5yPY52lw==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/NaturalIntelligence"
+        }
+      ],
+      "license": "MIT",
+      "engines": {
+        "node": ">=16.0.0"
+      }
+    },
     "node_modules/xml2js": {
       "version": "0.6.2",
       "resolved": "https://registry.npmjs.org/xml2js/-/xml2js-0.6.2.tgz",

package/oclif.lock

@@ -5773,9 +5773,9 @@ fast-string-width@^3.0.2:
     fast-string-truncated-width "^3.0.2"
 
 fast-uri@^3.0.1:
-  version "3.0.1"
-  resolved "https://registry.yarnpkg.com/fast-uri/-/fast-uri-3.0.1.tgz#cddd2eecfc83a71c1be2cc2ef2061331be8a7134"
-  integrity sha512-MWipKbbYiYI0UC7cl8m/i/IWTqfC8YXsqjzybjddLsFjStroQzsHXkc73JutMvBiXmOvapk+axIl79ig5t55Bw==
+  version "3.1.2"
+  resolved "https://registry.yarnpkg.com/fast-uri/-/fast-uri-3.1.2.tgz#8af3d4fc9d3e71b11572cc2673b514a7d1a8c8ec"
+  integrity sha512-rVjf7ArG3LTk+FS6Yw81V1DLuZl1bRbNrev6Tmd/9RaroeeRRJhAt7jg/6YFxbvAQXUCavSoZhPPj6oOx+5KjQ==
 
 fast-wrap-ansi@^0.2.0:
   version "0.2.0"
@@ -5785,11 +5785,12 @@ fast-wrap-ansi@^0.2.0:
     fast-string-width "^3.0.2"
 
 fast-xml-builder@^1.1.4:
-  version "1.1.4"
-  resolved "https://registry.yarnpkg.com/fast-xml-builder/-/fast-xml-builder-1.1.4.tgz#0c407a1d9d5996336c0cd76f7ff785cac6413017"
-  integrity sha512-f2jhpN4Eccy0/Uz9csxh3Nu6q4ErKxf0XIsasomfOihuSUa3/xw6w8dnOtCDgEItQFJG8KyXPzQXzcODDrrbOg==
+  version "1.2.0"
+  resolved "https://registry.yarnpkg.com/fast-xml-builder/-/fast-xml-builder-1.2.0.tgz#abd2363145a7625d9789ad96da375fabe3cff28c"
+  integrity sha512-00aAWieqff+ZJhsXA4g1g7M8k+7AYoMUUHF+/zFb5U6Uv/P0Vl4QZo84/IcufzYalLuEj9928bXN9PbbFzMF0Q==
   dependencies:
-    path-expression-matcher "^1.1.3"
+    path-expression-matcher "^1.5.0"
+    xml-naming "^0.1.0"
 
 fast-xml-parser@5.5.8:
   version "5.5.8"
@@ -8907,7 +8908,7 @@ path-exists@^4.0.0:
   resolved "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz"
   integrity sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==
 
-path-expression-matcher@^1.1.3, path-expression-matcher@^1.2.0:
+path-expression-matcher@^1.2.0:
   version "1.2.0"
   resolved "https://registry.yarnpkg.com/path-expression-matcher/-/path-expression-matcher-1.2.0.tgz#9bdae3787f43b0857b0269e9caaa586c12c8abee"
   integrity sha512-DwmPWeFn+tq7TiyJ2CxezCAirXjFxvaiD03npak3cRjlP9+OjTmSy1EpIrEbh+l6JgUundniloMLDQ/6VTdhLQ==
@@ -8917,6 +8918,11 @@ path-expression-matcher@^1.2.1:
   resolved "https://registry.yarnpkg.com/path-expression-matcher/-/path-expression-matcher-1.2.1.tgz#04de63e98dcef3e07af8b12a41055466f200e291"
   integrity sha512-d7gQQmLvAKXKXE2GeP9apIGbMYKz88zWdsn/BN2HRWVQsDFdUY36WSLTY0Jvd4HWi7Fb30gQ62oAOzdgJA6fZw==
 
+path-expression-matcher@^1.5.0:
+  version "1.5.0"
+  resolved "https://registry.yarnpkg.com/path-expression-matcher/-/path-expression-matcher-1.5.0.tgz#3b98545dc88ffebb593e2d8458d0929da9275f4a"
+  integrity sha512-cbrerZV+6rvdQrrD+iGMcZFEiiSrbv9Tfdkvnusy6y0x0GKBXREFg/Y65GhIfm0tnLntThhzCnfKwp1WRjeCyQ==
+
 path-is-absolute@^1.0.0:
   version "1.0.1"
   resolved "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz"
@@ -10904,6 +10910,11 @@ ws@^8.15.0:
   resolved "https://registry.yarnpkg.com/ws/-/ws-8.18.0.tgz#0d7505a6eafe2b0e712d232b42279f53bc289bbc"
   integrity sha512-8VbfWfHLbbwu3+N6OKsOMpBdT4kXPDDB9cJk2bJ6mh9ucxdlnNvH1e+roYkKmN9Nxw2yjz7VzeO9oOz2zJ04Pw==
 
+xml-naming@^0.1.0:
+  version "0.1.0"
+  resolved "https://registry.yarnpkg.com/xml-naming/-/xml-naming-0.1.0.tgz#8ab7106c5b8d23caa2fabac1cadf17136379fbd8"
+  integrity sha512-k8KO9hrMyNk6tUWqUfkTEZbezRRpONVOzUTnc97VnCvyj6Tf9lyUR9EDAIeiVLv56jsMcoXEwjW8Kv5yPY52lw==
+
 xml2js@^0.6.2:
   version "0.6.2"
   resolved "https://registry.yarnpkg.com/xml2js/-/xml2js-0.6.2.tgz#dd0b630083aa09c161e25a4d0901e2b2a929b499"

package/oclif.manifest.json

@@ -848,10 +848,13 @@
         "build.js"
       ]
     },
-    "npm:dependencies:pin": {
+    "cli:tarballs:prepare": {
       "aliases": [],
       "args": {},
-      "description": "lock a list of dependencies to a target tag or default to 'latest', place these entries in 'pinnedDependencies' entry in the package.json",
+      "description": "remove unnecessary files from node_modules",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -871,42 +874,50 @@
         "dryrun": {
           "char": "d",
           "name": "dryrun",
-          "summary": "If true, will not make any changes to the package.json",
+          "summary": "only show what would be removed from node_modules",
           "allowNo": false,
           "type": "boolean"
         },
-        "tag": {
+        "types": {
           "char": "t",
-          "name": "tag",
-          "summary": "The name of the tag you want, e.g. 'latest-rc', or 'latest'",
-          "default": "latest",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+          "name": "types",
+          "summary": "remove all types (.d.ts) files from node_modules",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "name": "verbose",
+          "summary": "show all files paths being removed",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "npm:dependencies:pin",
+      "id": "cli:tarballs:prepare",
       "pluginAlias": "@salesforce/plugin-release-management",
       "pluginName": "@salesforce/plugin-release-management",
       "pluginType": "core",
       "strict": true,
-      "summary": "lock a list of dependencies to a target tag or default to 'latest', place these entries in 'pinnedDependencies' entry in the package.json",
+      "summary": "remove unnecessary files from node_modules",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
-        "npm",
-        "dependencies",
-        "pin.js"
+        "cli",
+        "tarballs",
+        "prepare.js"
       ]
     },
-    "npm:package:release": {
+    "cli:tarballs:smoke": {
       "aliases": [],
       "args": {},
-      "description": "publish npm package",
+      "description": "smoke tests for the sf CLI\nTests that the CLI and every command can be initialized.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %>"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -923,89 +934,39 @@
           "multiple": false,
           "type": "option"
         },
-        "dryrun": {
-          "char": "d",
-          "name": "dryrun",
-          "summary": "If true, will not commit changes to repo or push any tags",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "sign": {
-          "char": "s",
-          "name": "sign",
-          "summary": "If true, then the package will be signed and the signature will be uploaded to S3",
+        "verbose": {
+          "name": "verbose",
+          "summary": "show the --help output for each command",
           "allowNo": false,
           "type": "boolean"
-        },
-        "npmtag": {
-          "char": "t",
-          "name": "npmtag",
-          "summary": "tag to use when publishing to npm",
-          "default": "latest",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "npmaccess": {
-          "char": "a",
-          "name": "npmaccess",
-          "summary": "access level to use when publishing to npm",
-          "default": "public",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "install": {
-          "name": "install",
-          "summary": "run yarn install and build on repository",
-          "allowNo": true,
-          "type": "boolean"
-        },
-        "prerelease": {
-          "name": "prerelease",
-          "summary": "determine the next version as <version>-<prerelease>.0 if version is not manually set",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "verify": {
-          "name": "verify",
-          "summary": "verify npm registry has new version after publish and digital signature",
-          "allowNo": true,
-          "type": "boolean"
-        },
-        "githubtag": {
-          "name": "githubtag",
-          "summary": "given a github tag, release the version specified in the package.json as is. Useful when you've already done a release and only need npm publish features",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "npm:package:release",
+      "id": "cli:tarballs:smoke",
       "pluginAlias": "@salesforce/plugin-release-management",
       "pluginName": "@salesforce/plugin-release-management",
       "pluginType": "core",
       "strict": true,
-      "summary": "publish npm package",
+      "summary": "smoke tests for the sf CLI\nTests that the CLI and every command can be initialized.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
-        "npm",
-        "package",
-        "release.js"
+        "cli",
+        "tarballs",
+        "smoke.js"
       ]
     },
-    "github:check:closed": {
+    "cli:tarballs:verify": {
       "aliases": [],
       "args": {},
-      "description": "Description of a command.",
+      "description": "verify that tarballs are ready to be uploaded",
       "examples": [
-        "<%= config.bin %> <%= command.id %> -o me@gus.com"
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --cli sfdx",
+        "<%= config.bin %> <%= command.id %> --cli sf"
       ],
       "flags": {
         "json": {
@@ -1023,42 +984,45 @@
           "multiple": false,
           "type": "option"
         },
-        "gus": {
-          "char": "o",
-          "name": "gus",
-          "noCacheDefault": true,
-          "required": true,
-          "summary": "Username/alias of your GUS org connection",
-          "hasDynamicHelp": true,
+        "cli": {
+          "char": "c",
+          "name": "cli",
+          "summary": "the cli to verify",
+          "default": "sfdx",
+          "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "sf",
+            "sfdx"
+          ],
           "type": "option"
         },
-        "github-token": {
-          "env": "GITHUB_TOKEN",
-          "name": "github-token",
-          "required": true,
-          "summary": "Github token--store this in the environment as GITHUB_TOKEN",
+        "windows-username-buffer": {
+          "char": "w",
+          "name": "windows-username-buffer",
+          "summary": "the number of characters to allow for windows usernames",
+          "default": 41,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         }
       },
-      "hasDynamicHelp": true,
+      "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "github:check:closed",
+      "id": "cli:tarballs:verify",
       "pluginAlias": "@salesforce/plugin-release-management",
       "pluginName": "@salesforce/plugin-release-management",
       "pluginType": "core",
       "strict": true,
-      "summary": "Show open Github issues with GUS WI",
+      "summary": "verify that tarballs are ready to be uploaded",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
-        "github",
-        "check",
-        "closed.js"
+        "cli",
+        "tarballs",
+        "verify.js"
       ]
     },
     "cli:versions:inspect": {
@@ -1162,11 +1126,12 @@
         "inspect.js"
       ]
     },
-    "cli:install:jit:test": {
+    "github:check:closed": {
       "aliases": [],
       "args": {},
+      "description": "Description of a command.",
       "examples": [
-        "<%= config.bin %> <%= command.id %>"
+        "<%= config.bin %> <%= command.id %> -o me@gus.com"
       ],
       "flags": {
         "json": {
@@ -1184,41 +1149,48 @@
           "multiple": false,
           "type": "option"
         },
-        "jit-plugin": {
-          "char": "j",
-          "name": "jit-plugin",
-          "summary": "JIT plugin(s) to test, example: @salesforce/plugin-community",
+        "gus": {
+          "char": "o",
+          "name": "gus",
+          "noCacheDefault": true,
+          "required": true,
+          "summary": "Username/alias of your GUS org connection",
+          "hasDynamicHelp": true,
+          "multiple": false,
+          "type": "option"
+        },
+        "github-token": {
+          "env": "GITHUB_TOKEN",
+          "name": "github-token",
+          "required": true,
+          "summary": "Github token--store this in the environment as GITHUB_TOKEN",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         }
       },
-      "hasDynamicHelp": false,
+      "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "cli:install:jit:test",
+      "id": "github:check:closed",
       "pluginAlias": "@salesforce/plugin-release-management",
       "pluginName": "@salesforce/plugin-release-management",
       "pluginType": "core",
       "strict": true,
-      "summary": "Test that all JIT plugins can be successfully installed.",
+      "summary": "Show open Github issues with GUS WI",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
-        "cli",
-        "install",
-        "jit",
-        "test.js"
+        "github",
+        "check",
+        "closed.js"
       ]
     },
-    "cli:tarballs:prepare": {
+    "npm:dependencies:pin": {
       "aliases": [],
       "args": {},
-      "description": "remove unnecessary files from node_modules",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>"
-      ],
+      "description": "lock a list of dependencies to a target tag or default to 'latest', place these entries in 'pinnedDependencies' entry in the package.json",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1238,50 +1210,42 @@
         "dryrun": {
           "char": "d",
           "name": "dryrun",
-          "summary": "only show what would be removed from node_modules",
+          "summary": "If true, will not make any changes to the package.json",
           "allowNo": false,
           "type": "boolean"
         },
-        "types": {
+        "tag": {
           "char": "t",
-          "name": "types",
-          "summary": "remove all types (.d.ts) files from node_modules",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "verbose": {
-          "name": "verbose",
-          "summary": "show all files paths being removed",
-          "allowNo": false,
-          "type": "boolean"
+          "name": "tag",
+          "summary": "The name of the tag you want, e.g. 'latest-rc', or 'latest'",
+          "default": "latest",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "cli:tarballs:prepare",
+      "id": "npm:dependencies:pin",
       "pluginAlias": "@salesforce/plugin-release-management",
       "pluginName": "@salesforce/plugin-release-management",
       "pluginType": "core",
       "strict": true,
-      "summary": "remove unnecessary files from node_modules",
+      "summary": "lock a list of dependencies to a target tag or default to 'latest', place these entries in 'pinnedDependencies' entry in the package.json",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
-        "cli",
-        "tarballs",
-        "prepare.js"
+        "npm",
+        "dependencies",
+        "pin.js"
       ]
     },
-    "cli:tarballs:smoke": {
+    "npm:package:release": {
       "aliases": [],
       "args": {},
-      "description": "smoke tests for the sf CLI\nTests that the CLI and every command can be initialized.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %>"
-      ],
+      "description": "publish npm package",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1298,39 +1262,88 @@
           "multiple": false,
           "type": "option"
         },
-        "verbose": {
-          "name": "verbose",
-          "summary": "show the --help output for each command",
+        "dryrun": {
+          "char": "d",
+          "name": "dryrun",
+          "summary": "If true, will not commit changes to repo or push any tags",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "sign": {
+          "char": "s",
+          "name": "sign",
+          "summary": "If true, then the package will be signed and the signature will be uploaded to S3",
           "allowNo": false,
           "type": "boolean"
+        },
+        "npmtag": {
+          "char": "t",
+          "name": "npmtag",
+          "summary": "tag to use when publishing to npm",
+          "default": "latest",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "npmaccess": {
+          "char": "a",
+          "name": "npmaccess",
+          "summary": "access level to use when publishing to npm",
+          "default": "public",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "install": {
+          "name": "install",
+          "summary": "run yarn install and build on repository",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "prerelease": {
+          "name": "prerelease",
+          "summary": "determine the next version as <version>-<prerelease>.0 if version is not manually set",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "verify": {
+          "name": "verify",
+          "summary": "verify npm registry has new version after publish and digital signature",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "githubtag": {
+          "name": "githubtag",
+          "summary": "given a github tag, release the version specified in the package.json as is. Useful when you've already done a release and only need npm publish features",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "cli:tarballs:smoke",
+      "id": "npm:package:release",
       "pluginAlias": "@salesforce/plugin-release-management",
       "pluginName": "@salesforce/plugin-release-management",
       "pluginType": "core",
       "strict": true,
-      "summary": "smoke tests for the sf CLI\nTests that the CLI and every command can be initialized.",
+      "summary": "publish npm package",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
-        "cli",
-        "tarballs",
-        "smoke.js"
+        "npm",
+        "package",
+        "release.js"
       ]
     },
-    "cli:tarballs:verify": {
+    "cli:install:jit:test": {
       "aliases": [],
       "args": {},
-      "description": "verify that tarballs are ready to be uploaded",
       "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --cli sfdx",
-        "<%= config.bin %> <%= command.id %> --cli sf"
+        "<%= config.bin %> <%= command.id %>"
       ],
       "flags": {
         "json": {
@@ -1348,47 +1361,34 @@
           "multiple": false,
           "type": "option"
         },
-        "cli": {
-          "char": "c",
-          "name": "cli",
-          "summary": "the cli to verify",
-          "default": "sfdx",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "sf",
-            "sfdx"
-          ],
-          "type": "option"
-        },
-        "windows-username-buffer": {
-          "char": "w",
-          "name": "windows-username-buffer",
-          "summary": "the number of characters to allow for windows usernames",
-          "default": 41,
+        "jit-plugin": {
+          "char": "j",
+          "name": "jit-plugin",
+          "summary": "JIT plugin(s) to test, example: @salesforce/plugin-community",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "cli:tarballs:verify",
+      "id": "cli:install:jit:test",
       "pluginAlias": "@salesforce/plugin-release-management",
       "pluginName": "@salesforce/plugin-release-management",
       "pluginType": "core",
       "strict": true,
-      "summary": "verify that tarballs are ready to be uploaded",
+      "summary": "Test that all JIT plugins can be successfully installed.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "cli",
-        "tarballs",
-        "verify.js"
+        "install",
+        "jit",
+        "test.js"
       ]
     }
   },
-  "version": "5.8.18"
+  "version": "5.8.20"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@salesforce/plugin-release-management",
   "description": "A plugin for preparing and publishing npm packages",
-  "version": "5.8.18",
+  "version": "5.8.20",
   "author": "Salesforce",
   "bugs": "https://github.com/forcedotcom/cli/issues",
   "type": "module",