@salesforce/plugin-release-management 6.1.20 → 6.1.22

package/README.md

@@ -29,7 +29,7 @@ Once the package has been built and signed it will be published to npm. The comm
 ## Install
 
 ```bash
-sfdx plugins:install release-management@x.y.z
+sf plugins install @salesforce/plugin-release-management@x.y.z
 ```
 
 ## Issues
@@ -38,22 +38,7 @@ Please report any issues at https://github.com/forcedotcom/cli/issues
 
 ## Contributing
 
-1. Please read our [Code of Conduct](CODE_OF_CONDUCT.md)
-2. Create a new issue before starting your project so that we can keep track of
-   what you are trying to add/fix. That way, we can also offer suggestions or
-   let you know if there is already an effort in progress.
-3. Fork this repository.
-4. [Build the plugin locally](#build)
-5. Create a _topic_ branch in your fork. Note, this step is recommended but technically not required if contributing using a fork.
-6. Edit the code in your fork.
-7. Write appropriate tests for your changes. Try to achieve at least 95% code coverage on any new code. No pull request will be accepted without unit tests.
-8. Sign CLA (see [CLA](#cla) below).
-9. Send us a pull request when you are done. We'll review your code, suggest any needed changes, and merge it in.
-
-### CLA
-
-External contributors will be required to sign a Contributor's License
-Agreement. You can do so by going to https://cla.salesforce.com/sign-cla.
+If you're interested in contributing, take a look at the [CONTRIBUTING](CONTRIBUTING.md) guide.
 
 ### Build
 
@@ -64,24 +49,23 @@ To build the plugin locally, make sure to have yarn installed and run the follow
 git clone git@github.com:salesforcecli/plugin-release-management
 
 # Install the dependencies and compile
-yarn install
-yarn build
+yarn && yarn build
 ```
 
-To use your plugin, run using the local `./bin/dev` or `./bin/dev.cmd` file.
+To use your plugin, run using the local `./bin/dev.js` or `./bin/dev.cmd` file.
 
 ```bash
 # Run using local run file.
-./bin/dev npm
+./bin/dev.js npm
 ```
 
 There should be no differences when running via the Salesforce CLI or using the local run file. However, it can be useful to link the plugin to do some additional testing or run your commands from anywhere on your machine.
 
 ```bash
-# Link your plugin to the sfdx cli
-sfdx plugins:link .
+# Link your plugin to the sf cli
+sf plugins link .
 # To verify
-sfdx plugins
+sf plugins
 ```
 
 # Commands
@@ -149,7 +133,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/6.1.20/src/commands/channel/promote.ts)_
+_See code: [src/commands/channel/promote.ts](https://github.com/salesforcecli/plugin-release-management/blob/6.1.22/src/commands/channel/promote.ts)_
 
 ## `sfdx cli artifacts compare`
 
@@ -173,7 +157,7 @@ EXAMPLES
   $ sfdx cli artifacts compare
 ```
 
-_See code: [src/commands/cli/artifacts/compare.ts](https://github.com/salesforcecli/plugin-release-management/blob/6.1.20/src/commands/cli/artifacts/compare.ts)_
+_See code: [src/commands/cli/artifacts/compare.ts](https://github.com/salesforcecli/plugin-release-management/blob/6.1.22/src/commands/cli/artifacts/compare.ts)_
 
 ## `sfdx cli install jit test`
 
@@ -194,7 +178,7 @@ EXAMPLES
   $ sfdx cli install jit test
 ```
 
-_See code: [src/commands/cli/install/jit/test.ts](https://github.com/salesforcecli/plugin-release-management/blob/6.1.20/src/commands/cli/install/jit/test.ts)_
+_See code: [src/commands/cli/install/jit/test.ts](https://github.com/salesforcecli/plugin-release-management/blob/6.1.22/src/commands/cli/install/jit/test.ts)_
 
 ## `sfdx cli install test`
 
@@ -235,7 +219,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/6.1.20/src/commands/cli/install/test.ts)_
+_See code: [src/commands/cli/install/test.ts](https://github.com/salesforcecli/plugin-release-management/blob/6.1.22/src/commands/cli/install/test.ts)_
 
 ## `sfdx cli release automerge`
 
@@ -266,7 +250,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/6.1.20/src/commands/cli/release/automerge.ts)_
+_See code: [src/commands/cli/release/automerge.ts](https://github.com/salesforcecli/plugin-release-management/blob/6.1.22/src/commands/cli/release/automerge.ts)_
 
 ## `sfdx cli release build`
 
@@ -329,7 +313,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/6.1.20/src/commands/cli/release/build.ts)_
+_See code: [src/commands/cli/release/build.ts](https://github.com/salesforcecli/plugin-release-management/blob/6.1.22/src/commands/cli/release/build.ts)_
 
 ## `sfdx cli releasenotes`
 
@@ -370,7 +354,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/6.1.20/src/commands/cli/releasenotes.ts)_
+_See code: [src/commands/cli/releasenotes.ts](https://github.com/salesforcecli/plugin-release-management/blob/6.1.22/src/commands/cli/releasenotes.ts)_
 
 ## `sfdx cli tarballs prepare`
 
@@ -398,7 +382,7 @@ EXAMPLES
   $ sfdx cli tarballs prepare
 ```
 
-_See code: [src/commands/cli/tarballs/prepare.ts](https://github.com/salesforcecli/plugin-release-management/blob/6.1.20/src/commands/cli/tarballs/prepare.ts)_
+_See code: [src/commands/cli/tarballs/prepare.ts](https://github.com/salesforcecli/plugin-release-management/blob/6.1.22/src/commands/cli/tarballs/prepare.ts)_
 
 ## `sfdx cli tarballs smoke`
 
@@ -428,7 +412,7 @@ EXAMPLES
   $ sfdx cli tarballs smoke
 ```
 
-_See code: [src/commands/cli/tarballs/smoke.ts](https://github.com/salesforcecli/plugin-release-management/blob/6.1.20/src/commands/cli/tarballs/smoke.ts)_
+_See code: [src/commands/cli/tarballs/smoke.ts](https://github.com/salesforcecli/plugin-release-management/blob/6.1.22/src/commands/cli/tarballs/smoke.ts)_
 
 ## `sfdx cli tarballs verify`
 
@@ -460,7 +444,7 @@ EXAMPLES
   $ sfdx cli tarballs verify --cli sf
 ```
 
-_See code: [src/commands/cli/tarballs/verify.ts](https://github.com/salesforcecli/plugin-release-management/blob/6.1.20/src/commands/cli/tarballs/verify.ts)_
+_See code: [src/commands/cli/tarballs/verify.ts](https://github.com/salesforcecli/plugin-release-management/blob/6.1.22/src/commands/cli/tarballs/verify.ts)_
 
 ## `sfdx cli versions inspect`
 
@@ -512,7 +496,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/6.1.20/src/commands/cli/versions/inspect.ts)_
+_See code: [src/commands/cli/versions/inspect.ts](https://github.com/salesforcecli/plugin-release-management/blob/6.1.22/src/commands/cli/versions/inspect.ts)_
 
 ## `sfdx dependabot automerge`
 
@@ -552,7 +536,7 @@ EXAMPLES
   $ sfdx dependabot automerge --max-version-bump major
 ```
 
-_See code: [src/commands/dependabot/automerge.ts](https://github.com/salesforcecli/plugin-release-management/blob/6.1.20/src/commands/dependabot/automerge.ts)_
+_See code: [src/commands/dependabot/automerge.ts](https://github.com/salesforcecli/plugin-release-management/blob/6.1.22/src/commands/dependabot/automerge.ts)_
 
 ## `sfdx github check closed`
 
@@ -579,7 +563,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/6.1.20/src/commands/github/check/closed.ts)_
+_See code: [src/commands/github/check/closed.ts](https://github.com/salesforcecli/plugin-release-management/blob/6.1.22/src/commands/github/check/closed.ts)_
 
 ## `sfdx npm dependencies pin`
 
@@ -605,7 +589,7 @@ DESCRIPTION
   in the package.json
 ```
 
-_See code: [src/commands/npm/dependencies/pin.ts](https://github.com/salesforcecli/plugin-release-management/blob/6.1.20/src/commands/npm/dependencies/pin.ts)_
+_See code: [src/commands/npm/dependencies/pin.ts](https://github.com/salesforcecli/plugin-release-management/blob/6.1.22/src/commands/npm/dependencies/pin.ts)_
 
 ## `sfdx npm package release`
 
@@ -639,7 +623,7 @@ DESCRIPTION
   publish npm package
 ```
 
-_See code: [src/commands/npm/package/release.ts](https://github.com/salesforcecli/plugin-release-management/blob/6.1.20/src/commands/npm/package/release.ts)_
+_See code: [src/commands/npm/package/release.ts](https://github.com/salesforcecli/plugin-release-management/blob/6.1.22/src/commands/npm/package/release.ts)_
 
 ## `sfdx plugins trust allowlist add`
 
@@ -809,6 +793,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/6.1.20/src/commands/repositories/index.ts)_
+_See code: [src/commands/repositories/index.ts](https://github.com/salesforcecli/plugin-release-management/blob/6.1.22/src/commands/repositories/index.ts)_
 
 <!-- commandsstop -->

package/oclif.manifest.json

@@ -161,80 +161,6 @@
         "promote.js"
       ]
     },
-    "cli:releasenotes": {
-      "aliases": [],
-      "args": {},
-      "description": "pull all relevant information for writing release notes.\nRequires the GH_TOKEN to be set in the environment.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> --cli sf",
-        "<%= config.bin %> <%= command.id %> --cli sfdx",
-        "<%= config.bin %> <%= command.id %> --cli sf --since 1.0.0",
-        "<%= config.bin %> <%= command.id %> --cli sfdx --since 7.19.0",
-        "<%= config.bin %> <%= command.id %> --cli sf > changes.txt",
-        "<%= config.bin %> <%= command.id %> --cli sf --markdown > changes.md"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "flags-dir": {
-          "helpGroup": "GLOBAL",
-          "name": "flags-dir",
-          "summary": "Import flag values from a directory.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "cli": {
-          "char": "c",
-          "name": "cli",
-          "required": true,
-          "summary": "the cli to pull information for",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "sf",
-            "sfdx"
-          ],
-          "type": "option"
-        },
-        "since": {
-          "char": "s",
-          "name": "since",
-          "summary": "the version number of the previous release. Defaults to the latest-rc version on npm",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "markdown": {
-          "char": "m",
-          "name": "markdown",
-          "summary": "format the output in markdown",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "cli:releasenotes",
-      "pluginAlias": "@salesforce/plugin-release-management",
-      "pluginName": "@salesforce/plugin-release-management",
-      "pluginType": "core",
-      "strict": true,
-      "summary": "pull all relevant information for writing release notes.\nRequires the GH_TOKEN to be set in the environment.",
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "lib",
-        "commands",
-        "cli",
-        "releasenotes.js"
-      ]
-    },
     "dependabot:automerge": {
       "aliases": [],
       "args": {},
@@ -342,6 +268,80 @@
         "automerge.js"
       ]
     },
+    "cli:releasenotes": {
+      "aliases": [],
+      "args": {},
+      "description": "pull all relevant information for writing release notes.\nRequires the GH_TOKEN to be set in the environment.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --cli sf",
+        "<%= config.bin %> <%= command.id %> --cli sfdx",
+        "<%= config.bin %> <%= command.id %> --cli sf --since 1.0.0",
+        "<%= config.bin %> <%= command.id %> --cli sfdx --since 7.19.0",
+        "<%= config.bin %> <%= command.id %> --cli sf > changes.txt",
+        "<%= config.bin %> <%= command.id %> --cli sf --markdown > changes.md"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "cli": {
+          "char": "c",
+          "name": "cli",
+          "required": true,
+          "summary": "the cli to pull information for",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "sf",
+            "sfdx"
+          ],
+          "type": "option"
+        },
+        "since": {
+          "char": "s",
+          "name": "since",
+          "summary": "the version number of the previous release. Defaults to the latest-rc version on npm",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "markdown": {
+          "char": "m",
+          "name": "markdown",
+          "summary": "format the output in markdown",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cli:releasenotes",
+      "pluginAlias": "@salesforce/plugin-release-management",
+      "pluginName": "@salesforce/plugin-release-management",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "pull all relevant information for writing release notes.\nRequires the GH_TOKEN to be set in the environment.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "cli",
+        "releasenotes.js"
+      ]
+    },
     "repositories": {
       "aliases": [],
       "args": {},
@@ -461,71 +461,6 @@
         "index.js"
       ]
     },
-    "cli:artifacts:compare": {
-      "aliases": [],
-      "args": {},
-      "examples": [
-        "<%= config.bin %> <%= command.id %>"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "flags-dir": {
-          "helpGroup": "GLOBAL",
-          "name": "flags-dir",
-          "summary": "Import flag values from a directory.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "plugin": {
-          "char": "p",
-          "name": "plugin",
-          "summary": "List of plugins to check for breaking changes.",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "previous": {
-          "char": "r",
-          "name": "previous",
-          "summary": "Previous CLI version to compare against. Defaults to the last published version.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "current": {
-          "char": "c",
-          "name": "current",
-          "summary": "Current CLI version to compare against. Defaults to the version on the CLI in the current directory.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "cli:artifacts:compare",
-      "pluginAlias": "@salesforce/plugin-release-management",
-      "pluginName": "@salesforce/plugin-release-management",
-      "pluginType": "core",
-      "strict": true,
-      "summary": "Look for breaking changes in artifacts (schemas and snapshots) from plugins. Must be run in CLI directory.",
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "lib",
-        "commands",
-        "cli",
-        "artifacts",
-        "compare.js"
-      ]
-    },
     "cli:install:test": {
       "aliases": [],
       "args": {},
@@ -849,21 +784,12 @@
         "build.js"
       ]
     },
-    "cli:versions:inspect": {
+    "cli:tarballs:prepare": {
       "aliases": [],
       "args": {},
-      "description": "inspect the CLI version across all install paths",
+      "description": "remove unnecessary files from node_modules",
       "examples": [
-        "<%= config.bin %> <%= command.id %> -l archive -c stable",
-        "<%= config.bin %> <%= command.id %> -l archive -c stable-rc",
-        "<%= config.bin %> <%= command.id %> -l archive npm -c stable",
-        "<%= config.bin %> <%= command.id %> -l archive npm -c latest",
-        "<%= config.bin %> <%= command.id %> -l archive npm -c latest latest-rc",
-        "<%= config.bin %> <%= command.id %> -l archive npm -c stable stable-rc",
-        "<%= config.bin %> <%= command.id %> -l npm -c latest --salesforce",
-        "<%= config.bin %> <%= command.id %> -l npm -c latest -d @salesforce/core",
-        "<%= config.bin %> <%= command.id %> -l npm -c latest -d @salesforce/\\*\\*/ salesforce-alm",
-        "<%= config.bin %> <%= command.id %> -l npm -c latest -d chalk -s"
+        "<%= config.bin %> <%= command.id %>"
       ],
       "flags": {
         "json": {
@@ -881,73 +807,158 @@
           "multiple": false,
           "type": "option"
         },
-        "dependencies": {
+        "dryrun": {
           "char": "d",
-          "name": "dependencies",
-          "summary": "glob pattern of dependencies you want to see the version of",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
+          "name": "dryrun",
+          "summary": "only show what would be removed from node_modules",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "salesforce": {
-          "char": "s",
-          "name": "salesforce",
-          "summary": "show versions of salesforce owned dependencies",
+        "types": {
+          "char": "t",
+          "name": "types",
+          "summary": "remove all types (.d.ts) files from node_modules",
           "allowNo": false,
           "type": "boolean"
         },
-        "channels": {
-          "char": "c",
-          "name": "channels",
-          "required": true,
-          "summary": "the channel you want to inspect (for achives, latest and latest-rc are translated to stable and stable-rc. And vice-versa for npm)",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "options": [
-            "stable",
-            "stable-rc",
-            "latest",
-            "latest-rc",
-            "nightly"
-          ],
+        "verbose": {
+          "name": "verbose",
+          "summary": "show all files paths being removed",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cli:tarballs:prepare",
+      "pluginAlias": "@salesforce/plugin-release-management",
+      "pluginName": "@salesforce/plugin-release-management",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "remove unnecessary files from node_modules",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "cli",
+        "tarballs",
+        "prepare.js"
+      ]
+    },
+    "cli:tarballs:smoke": {
+      "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 %>"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
           "type": "option"
         },
-        "locations": {
-          "char": "l",
-          "name": "locations",
-          "required": true,
-          "summary": "the location you want to inspect",
+        "verbose": {
+          "name": "verbose",
+          "summary": "show the --help output for each command",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cli:tarballs:smoke",
+      "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.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "cli",
+        "tarballs",
+        "smoke.js"
+      ]
+    },
+    "cli:tarballs:verify": {
+      "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"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
+          "type": "option"
+        },
+        "cli": {
+          "char": "c",
+          "name": "cli",
+          "summary": "the cli to verify",
+          "default": "sfdx",
+          "hasDynamicHelp": false,
+          "multiple": false,
           "options": [
-            "archive",
-            "npm"
+            "sf",
+            "sfdx"
           ],
           "type": "option"
         },
-        "ignore-missing": {
-          "name": "ignore-missing",
-          "summary": "skip missing archives. Useful when supporting new architectures in oclif",
-          "allowNo": false,
-          "type": "boolean"
+        "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": false,
       "hiddenAliases": [],
-      "id": "cli:versions:inspect",
+      "id": "cli:tarballs:verify",
       "pluginAlias": "@salesforce/plugin-release-management",
       "pluginName": "@salesforce/plugin-release-management",
       "pluginType": "core",
       "strict": true,
-      "summary": "inspect the CLI version across all install paths",
+      "summary": "verify that tarballs are ready to be uploaded",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "cli",
-        "versions",
-        "inspect.js"
+        "tarballs",
+        "verify.js"
       ]
     },
     "github:check:closed": {
@@ -1011,10 +1022,22 @@
         "closed.js"
       ]
     },
-    "npm:dependencies:pin": {
+    "cli:versions:inspect": {
       "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": "inspect the CLI version across all install paths",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> -l archive -c stable",
+        "<%= config.bin %> <%= command.id %> -l archive -c stable-rc",
+        "<%= config.bin %> <%= command.id %> -l archive npm -c stable",
+        "<%= config.bin %> <%= command.id %> -l archive npm -c latest",
+        "<%= config.bin %> <%= command.id %> -l archive npm -c latest latest-rc",
+        "<%= config.bin %> <%= command.id %> -l archive npm -c stable stable-rc",
+        "<%= config.bin %> <%= command.id %> -l npm -c latest --salesforce",
+        "<%= config.bin %> <%= command.id %> -l npm -c latest -d @salesforce/core",
+        "<%= config.bin %> <%= command.id %> -l npm -c latest -d @salesforce/\\*\\*/ salesforce-alm",
+        "<%= config.bin %> <%= command.id %> -l npm -c latest -d chalk -s"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1031,18 +1054,117 @@
           "multiple": false,
           "type": "option"
         },
-        "dryrun": {
+        "dependencies": {
           "char": "d",
-          "name": "dryrun",
-          "summary": "If true, will not make any changes to the package.json",
+          "name": "dependencies",
+          "summary": "glob pattern of dependencies you want to see the version of",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "salesforce": {
+          "char": "s",
+          "name": "salesforce",
+          "summary": "show versions of salesforce owned dependencies",
           "allowNo": false,
           "type": "boolean"
         },
-        "tag": {
-          "char": "t",
-          "name": "tag",
-          "summary": "The name of the tag you want, e.g. 'latest-rc', or 'latest'",
-          "default": "latest",
+        "channels": {
+          "char": "c",
+          "name": "channels",
+          "required": true,
+          "summary": "the channel you want to inspect (for achives, latest and latest-rc are translated to stable and stable-rc. And vice-versa for npm)",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "options": [
+            "stable",
+            "stable-rc",
+            "latest",
+            "latest-rc",
+            "nightly"
+          ],
+          "type": "option"
+        },
+        "locations": {
+          "char": "l",
+          "name": "locations",
+          "required": true,
+          "summary": "the location you want to inspect",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "options": [
+            "archive",
+            "npm"
+          ],
+          "type": "option"
+        },
+        "ignore-missing": {
+          "name": "ignore-missing",
+          "summary": "skip missing archives. Useful when supporting new architectures in oclif",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cli:versions:inspect",
+      "pluginAlias": "@salesforce/plugin-release-management",
+      "pluginName": "@salesforce/plugin-release-management",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "inspect the CLI version across all install paths",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "cli",
+        "versions",
+        "inspect.js"
+      ]
+    },
+    "cli:artifacts:compare": {
+      "aliases": [],
+      "args": {},
+      "examples": [
+        "<%= config.bin %> <%= command.id %>"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "plugin": {
+          "char": "p",
+          "name": "plugin",
+          "summary": "List of plugins to check for breaking changes.",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "previous": {
+          "char": "r",
+          "name": "previous",
+          "summary": "Previous CLI version to compare against. Defaults to the last published version.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "current": {
+          "char": "c",
+          "name": "current",
+          "summary": "Current CLI version to compare against. Defaults to the version on the CLI in the current directory.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1050,20 +1172,20 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "npm:dependencies:pin",
+      "id": "cli:artifacts:compare",
       "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": "Look for breaking changes in artifacts (schemas and snapshots) from plugins. Must be run in CLI directory.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
-        "npm",
-        "dependencies",
-        "pin.js"
+        "cli",
+        "artifacts",
+        "compare.js"
       ]
     },
     "npm:package:release": {
@@ -1169,13 +1291,10 @@
         "release.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.",
@@ -1195,134 +1314,15 @@
         "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"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "cli:tarballs:prepare",
-      "pluginAlias": "@salesforce/plugin-release-management",
-      "pluginName": "@salesforce/plugin-release-management",
-      "pluginType": "core",
-      "strict": true,
-      "summary": "remove unnecessary files from node_modules",
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "lib",
-        "commands",
-        "cli",
-        "tarballs",
-        "prepare.js"
-      ]
-    },
-    "cli:tarballs:smoke": {
-      "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 %>"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "flags-dir": {
-          "helpGroup": "GLOBAL",
-          "name": "flags-dir",
-          "summary": "Import flag values from a directory.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "verbose": {
-          "name": "verbose",
-          "summary": "show the --help output for each command",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "cli:tarballs:smoke",
-      "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.",
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "lib",
-        "commands",
-        "cli",
-        "tarballs",
-        "smoke.js"
-      ]
-    },
-    "cli:tarballs:verify": {
-      "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"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "flags-dir": {
-          "helpGroup": "GLOBAL",
-          "name": "flags-dir",
-          "summary": "Import flag values from a directory.",
-          "hasDynamicHelp": false,
-          "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,
+          "name": "tag",
+          "summary": "The name of the tag you want, e.g. 'latest-rc', or 'latest'",
+          "default": "latest",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1330,20 +1330,20 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "cli:tarballs:verify",
+      "id": "npm:dependencies:pin",
       "pluginAlias": "@salesforce/plugin-release-management",
       "pluginName": "@salesforce/plugin-release-management",
       "pluginType": "core",
       "strict": true,
-      "summary": "verify that tarballs are ready to be uploaded",
+      "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",
-        "verify.js"
+        "npm",
+        "dependencies",
+        "pin.js"
       ]
     },
     "cli:install:jit:test": {
@@ -1397,5 +1397,5 @@
       ]
     }
   },
-  "version": "6.1.20"
+  "version": "6.1.22"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@salesforce/plugin-release-management",
   "description": "A plugin for preparing and publishing npm packages",
-  "version": "6.1.20",
+  "version": "6.1.22",
   "author": "Salesforce",
   "bugs": "https://github.com/forcedotcom/cli/issues",
   "type": "module",
@@ -14,7 +14,7 @@
     "@octokit/core": "^6.1.6",
     "@octokit/plugin-paginate-rest": "^11.6.0",
     "@octokit/plugin-throttling": "^9.6.1",
-    "@salesforce/cli-plugins-testkit": "^5.3.66",
+    "@salesforce/cli-plugins-testkit": "^5.3.81",
     "@salesforce/core": "^9.1.9",
     "@salesforce/kit": "^4.0.1",
     "@salesforce/plugin-command-reference": "^3.1.141",
@@ -29,7 +29,7 @@
     "got": "^13",
     "just-diff": "^5.2.0",
     "proxy-agent": "^6.4.0",
-    "semver": "^7.7.2",
+    "semver": "^7.8.6",
     "shelljs": "^0.10.0",
     "strip-ansi": "^6",
     "yarn-deduplicate": "^6.0.2"
@@ -47,7 +47,7 @@
     "aws-sdk-client-mock": "^4.1.0",
     "eslint": "^10.12.0",
     "eslint-config-salesforce-typescript": "^7.0.5",
-    "eslint-plugin-sf-plugin": "^3.0.0",
+    "eslint-plugin-sf-plugin": "^3.0.4",
     "oclif": "^5.0.2",
     "ts-node": "^10.9.2",
     "typescript": "^6.0.0"