@salesforce/plugin-release-management 5.7.62 → 5.7.64

package/oclif.manifest.json

@@ -160,80 +160,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": {},
@@ -460,11 +386,17 @@
         "index.js"
       ]
     },
-    "cli:artifacts:compare": {
+    "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 %>"
+        "<%= 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": {
@@ -482,59 +414,58 @@
           "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.",
+        "cli": {
+          "char": "c",
+          "name": "cli",
+          "required": true,
+          "summary": "the cli to pull information for",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "sf",
+            "sfdx"
+          ],
           "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.",
+        "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:artifacts:compare",
+      "id": "cli:releasenotes",
       "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.",
+      "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",
-        "artifacts",
-        "compare.js"
+        "releasenotes.js"
       ]
     },
-    "cli:install:test": {
+    "github:check:closed": {
       "aliases": [],
       "args": {},
-      "description": "install sf or sfdx",
+      "description": "Description of a command.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --cli sfdx --method installer",
-        "<%= config.bin %> <%= command.id %> --cli sfdx --method npm",
-        "<%= config.bin %> <%= command.id %> --cli sfdx --method tarball",
-        "<%= config.bin %> <%= command.id %> --cli sf --method tarball",
-        "<%= config.bin %> <%= command.id %> --cli sf --method tarball --channel stable-rc"
+        "<%= config.bin %> <%= command.id %> -o me@gus.com"
       ],
       "flags": {
         "json": {
@@ -552,52 +483,76 @@
           "multiple": false,
           "type": "option"
         },
-        "cli": {
-          "char": "c",
-          "name": "cli",
+        "gus": {
+          "char": "o",
+          "name": "gus",
+          "noCacheDefault": true,
           "required": true,
-          "summary": "the cli to install",
-          "hasDynamicHelp": false,
+          "summary": "Username/alias of your GUS org connection",
+          "hasDynamicHelp": true,
           "multiple": false,
-          "options": [
-            "sf",
-            "sfdx"
-          ],
           "type": "option"
         },
-        "method": {
-          "char": "m",
-          "name": "method",
+        "github-token": {
+          "env": "GITHUB_TOKEN",
+          "name": "github-token",
           "required": true,
-          "summary": "the installation method to use",
+          "summary": "Github token--store this in the environment as GITHUB_TOKEN",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "installer",
-            "npm",
-            "tarball"
-          ],
           "type": "option"
+        }
+      },
+      "hasDynamicHelp": true,
+      "hiddenAliases": [],
+      "id": "github:check:closed",
+      "pluginAlias": "@salesforce/plugin-release-management",
+      "pluginName": "@salesforce/plugin-release-management",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Show open Github issues with GUS WI",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "github",
+        "check",
+        "closed.js"
+      ]
+    },
+    "npm:dependencies:pin": {
+      "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",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "channel": {
-          "name": "channel",
-          "summary": "the channel to install from",
-          "default": "stable",
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "legacy",
-            "stable",
-            "stable-rc",
-            "latest",
-            "latest-rc"
-          ],
           "type": "option"
         },
-        "output-file": {
-          "name": "output-file",
-          "summary": "the file to write the JSON results to (must be .json)",
-          "default": "test-results.json",
+        "dryrun": {
+          "char": "d",
+          "name": "dryrun",
+          "summary": "If true, will not make any changes to the package.json",
+          "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",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -605,29 +560,26 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "cli:install:test",
+      "id": "npm:dependencies:pin",
       "pluginAlias": "@salesforce/plugin-release-management",
       "pluginName": "@salesforce/plugin-release-management",
       "pluginType": "core",
       "strict": true,
-      "summary": "install sf or sfdx",
+      "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",
-        "install",
-        "test.js"
+        "npm",
+        "dependencies",
+        "pin.js"
       ]
     },
-    "cli:release:automerge": {
+    "npm:package:release": {
       "aliases": [],
       "args": {},
-      "description": "Attempt to automerge nightly PR",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> --owner salesforcecli --repo sfdx-cli --pul-number 1049"
-      ],
+      "description": "publish npm package",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -644,87 +596,88 @@
           "multiple": false,
           "type": "option"
         },
-        "owner": {
-          "aliases": [
-            "org"
-          ],
-          "dependsOn": [
-            "repo"
-          ],
-          "name": "owner",
-          "required": true,
-          "summary": "Github owner (org), example: salesforcecli",
-          "hasDynamicHelp": false,
-          "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"
         },
-        "repo": {
-          "dependsOn": [
-            "owner"
-          ],
-          "name": "repo",
-          "required": true,
-          "summary": "Github repo, example: sfdx-cli",
+        "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"
         },
-        "pull-number": {
-          "name": "pull-number",
-          "required": true,
-          "summary": "Github pull request number to merge",
+        "npmaccess": {
+          "char": "a",
+          "name": "npmaccess",
+          "summary": "access level to use when publishing to npm",
+          "default": "public",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "dry-run": {
-          "char": "d",
-          "name": "dry-run",
-          "summary": "Run all checks, but do not merge PR",
-          "allowNo": false,
+        "install": {
+          "name": "install",
+          "summary": "run yarn install and build on repository",
+          "allowNo": true,
           "type": "boolean"
         },
-        "verbose": {
-          "name": "verbose",
-          "summary": "Show additional debug output",
-          "allowNo": false,
+        "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:release:automerge",
+      "id": "npm:package:release",
       "pluginAlias": "@salesforce/plugin-release-management",
       "pluginName": "@salesforce/plugin-release-management",
       "pluginType": "core",
       "strict": true,
-      "summary": "Attempt to automerge nightly PR",
+      "summary": "publish npm package",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
-        "cli",
-        "release",
-        "automerge.js"
+        "npm",
+        "package",
+        "release.js"
       ]
     },
-    "cli:release:build": {
-      "aliases": [
-        "cli:latestrc:build"
-      ],
+    "cli:artifacts:compare": {
+      "aliases": [],
       "args": {},
-      "description": "builds a new release from a designated starting point and optionally creates PR in Github",
       "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --patch",
-        "<%= config.bin %> <%= command.id %> --start-from-npm-dist-tag latest-rc --patch",
-        "<%= config.bin %> <%= command.id %> --start-from-github-ref 7.144.0",
-        "<%= config.bin %> <%= command.id %> --start-from-github-ref main",
-        "<%= config.bin %> <%= command.id %> --start-from-github-ref f476e8e",
-        "<%= config.bin %> <%= command.id %> --start-from-github-ref main --prerelease beta",
-        "<%= config.bin %> <%= command.id %> --build-only",
-        "<%= config.bin %> <%= command.id %> --only @salesforce/plugin-source,@salesforce/plugin-info@1.2.3"
+        "<%= config.bin %> <%= command.id %>"
       ],
       "flags": {
         "json": {
@@ -742,89 +695,26 @@
           "multiple": false,
           "type": "option"
         },
-        "start-from-npm-dist-tag": {
-          "aliases": [
-            "rctag"
-          ],
-          "char": "d",
-          "deprecateAliases": true,
-          "name": "start-from-npm-dist-tag",
-          "summary": "the npm dist-tag to start the release from, examples: nightly, latest-rc",
+        "plugin": {
+          "char": "p",
+          "name": "plugin",
+          "summary": "List of plugins to check for breaking changes.",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
-        "start-from-github-ref": {
-          "char": "g",
-          "name": "start-from-github-ref",
-          "summary": "a Github ref to start the release from, examples: main, 7.144.0, f476e8e",
+        "previous": {
+          "char": "r",
+          "name": "previous",
+          "summary": "Previous CLI version to compare against. Defaults to the last published version.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "release-channel": {
+        "current": {
           "char": "c",
-          "name": "release-channel",
-          "required": true,
-          "summary": "the channel intended for this release, examples: nightly, latest-rc, latest, dev, beta, etc...",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "build-only": {
-          "name": "build-only",
-          "summary": "only build the release, do not git add/commit/push",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "resolutions": {
-          "name": "resolutions",
-          "summary": "bump the versions of packages listed in the resolutions section",
-          "allowNo": true,
-          "type": "boolean"
-        },
-        "only": {
-          "name": "only",
-          "summary": "only bump the version of the packages passed in, uses latest if version is not provided",
-          "delimiter": ",",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "pinned-deps": {
-          "name": "pinned-deps",
-          "summary": "bump the versions of the packages listed in the pinnedDependencies section",
-          "allowNo": true,
-          "type": "boolean"
-        },
-        "jit": {
-          "name": "jit",
-          "summary": "bump the versions of the packages listed in the jitPlugins (just-in-time) section",
-          "allowNo": true,
-          "type": "boolean"
-        },
-        "label": {
-          "name": "label",
-          "summary": "add one or more labels to the Github PR",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "patch": {
-          "name": "patch",
-          "summary": "bump the release as a patch of an existing version, not a new minor version",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "empty": {
-          "name": "empty",
-          "summary": "create an empty release PR for pushing changes to later (version will still be bumped)",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "pr-base-branch": {
-          "name": "pr-base-branch",
-          "summary": "base branch to create the PR against; if not specified, the build determines the branch for you",
+          "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"
@@ -832,28 +722,32 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "cli:release:build",
+      "id": "cli:artifacts:compare",
       "pluginAlias": "@salesforce/plugin-release-management",
       "pluginName": "@salesforce/plugin-release-management",
       "pluginType": "core",
       "strict": true,
-      "summary": "builds a new release from a designated starting point and optionally creates PR in Github",
+      "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",
-        "release",
-        "build.js"
+        "artifacts",
+        "compare.js"
       ]
     },
-    "cli:tarballs:prepare": {
+    "cli:install:test": {
       "aliases": [],
       "args": {},
-      "description": "remove unnecessary files from node_modules",
+      "description": "install sf or sfdx",
       "examples": [
-        "<%= config.bin %> <%= command.id %>"
+        "<%= config.bin %> <%= command.id %> --cli sfdx --method installer",
+        "<%= config.bin %> <%= command.id %> --cli sfdx --method npm",
+        "<%= config.bin %> <%= command.id %> --cli sfdx --method tarball",
+        "<%= config.bin %> <%= command.id %> --cli sf --method tarball",
+        "<%= config.bin %> <%= command.id %> --cli sf --method tarball --channel stable-rc"
       ],
       "flags": {
         "json": {
@@ -871,52 +765,81 @@
           "multiple": false,
           "type": "option"
         },
-        "dryrun": {
-          "char": "d",
-          "name": "dryrun",
-          "summary": "only show what would be removed from node_modules",
-          "allowNo": false,
-          "type": "boolean"
+        "cli": {
+          "char": "c",
+          "name": "cli",
+          "required": true,
+          "summary": "the cli to install",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "sf",
+            "sfdx"
+          ],
+          "type": "option"
         },
-        "types": {
-          "char": "t",
-          "name": "types",
-          "summary": "remove all types (.d.ts) files from node_modules",
-          "allowNo": false,
-          "type": "boolean"
+        "method": {
+          "char": "m",
+          "name": "method",
+          "required": true,
+          "summary": "the installation method to use",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "installer",
+            "npm",
+            "tarball"
+          ],
+          "type": "option"
         },
-        "verbose": {
-          "name": "verbose",
-          "summary": "show all files paths being removed",
-          "allowNo": false,
-          "type": "boolean"
+        "channel": {
+          "name": "channel",
+          "summary": "the channel to install from",
+          "default": "stable",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "legacy",
+            "stable",
+            "stable-rc",
+            "latest",
+            "latest-rc"
+          ],
+          "type": "option"
+        },
+        "output-file": {
+          "name": "output-file",
+          "summary": "the file to write the JSON results to (must be .json)",
+          "default": "test-results.json",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "cli:tarballs:prepare",
+      "id": "cli:install:test",
       "pluginAlias": "@salesforce/plugin-release-management",
       "pluginName": "@salesforce/plugin-release-management",
       "pluginType": "core",
       "strict": true,
-      "summary": "remove unnecessary files from node_modules",
+      "summary": "install sf or sfdx",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "cli",
-        "tarballs",
-        "prepare.js"
+        "install",
+        "test.js"
       ]
     },
-    "cli:tarballs:smoke": {
+    "cli:release:automerge": {
       "aliases": [],
       "args": {},
-      "description": "smoke tests for the sf CLI\nTests that the CLI and every command can be initialized.",
+      "description": "Attempt to automerge nightly PR",
       "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %>"
+        "<%= config.bin %> <%= command.id %> --owner salesforcecli --repo sfdx-cli --pul-number 1049"
       ],
       "flags": {
         "json": {
@@ -934,39 +857,87 @@
           "multiple": false,
           "type": "option"
         },
+        "owner": {
+          "aliases": [
+            "org"
+          ],
+          "dependsOn": [
+            "repo"
+          ],
+          "name": "owner",
+          "required": true,
+          "summary": "Github owner (org), example: salesforcecli",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "repo": {
+          "dependsOn": [
+            "owner"
+          ],
+          "name": "repo",
+          "required": true,
+          "summary": "Github repo, example: sfdx-cli",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "pull-number": {
+          "name": "pull-number",
+          "required": true,
+          "summary": "Github pull request number to merge",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dry-run": {
+          "char": "d",
+          "name": "dry-run",
+          "summary": "Run all checks, but do not merge PR",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "verbose": {
           "name": "verbose",
-          "summary": "show the --help output for each command",
+          "summary": "Show additional debug output",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "cli:tarballs:smoke",
+      "id": "cli:release:automerge",
       "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": "Attempt to automerge nightly PR",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "cli",
-        "tarballs",
-        "smoke.js"
+        "release",
+        "automerge.js"
       ]
     },
-    "cli:tarballs:verify": {
-      "aliases": [],
+    "cli:release:build": {
+      "aliases": [
+        "cli:latestrc:build"
+      ],
       "args": {},
-      "description": "verify that tarballs are ready to be uploaded",
+      "description": "builds a new release from a designated starting point and optionally creates PR in Github",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --cli sfdx",
-        "<%= config.bin %> <%= command.id %> --cli sf"
+        "<%= config.bin %> <%= command.id %> --patch",
+        "<%= config.bin %> <%= command.id %> --start-from-npm-dist-tag latest-rc --patch",
+        "<%= config.bin %> <%= command.id %> --start-from-github-ref 7.144.0",
+        "<%= config.bin %> <%= command.id %> --start-from-github-ref main",
+        "<%= config.bin %> <%= command.id %> --start-from-github-ref f476e8e",
+        "<%= config.bin %> <%= command.id %> --start-from-github-ref main --prerelease beta",
+        "<%= config.bin %> <%= command.id %> --build-only",
+        "<%= config.bin %> <%= command.id %> --only @salesforce/plugin-source,@salesforce/plugin-info@1.2.3"
       ],
       "flags": {
         "json": {
@@ -984,24 +955,89 @@
           "multiple": false,
           "type": "option"
         },
-        "cli": {
+        "start-from-npm-dist-tag": {
+          "aliases": [
+            "rctag"
+          ],
+          "char": "d",
+          "deprecateAliases": true,
+          "name": "start-from-npm-dist-tag",
+          "summary": "the npm dist-tag to start the release from, examples: nightly, latest-rc",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "start-from-github-ref": {
+          "char": "g",
+          "name": "start-from-github-ref",
+          "summary": "a Github ref to start the release from, examples: main, 7.144.0, f476e8e",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "release-channel": {
           "char": "c",
-          "name": "cli",
-          "summary": "the cli to verify",
-          "default": "sfdx",
+          "name": "release-channel",
+          "required": true,
+          "summary": "the channel intended for this release, examples: nightly, latest-rc, latest, dev, beta, etc...",
           "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,
+        "build-only": {
+          "name": "build-only",
+          "summary": "only build the release, do not git add/commit/push",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "resolutions": {
+          "name": "resolutions",
+          "summary": "bump the versions of packages listed in the resolutions section",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "only": {
+          "name": "only",
+          "summary": "only bump the version of the packages passed in, uses latest if version is not provided",
+          "delimiter": ",",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "pinned-deps": {
+          "name": "pinned-deps",
+          "summary": "bump the versions of the packages listed in the pinnedDependencies section",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "jit": {
+          "name": "jit",
+          "summary": "bump the versions of the packages listed in the jitPlugins (just-in-time) section",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "label": {
+          "name": "label",
+          "summary": "add one or more labels to the Github PR",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "patch": {
+          "name": "patch",
+          "summary": "bump the release as a patch of an existing version, not a new minor version",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "empty": {
+          "name": "empty",
+          "summary": "create an empty release PR for pushing changes to later (version will still be bumped)",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "pr-base-branch": {
+          "name": "pr-base-branch",
+          "summary": "base branch to create the PR against; if not specified, the build determines the branch for you",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1009,20 +1045,20 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "cli:tarballs:verify",
+      "id": "cli:release:build",
       "pluginAlias": "@salesforce/plugin-release-management",
       "pluginName": "@salesforce/plugin-release-management",
       "pluginType": "core",
       "strict": true,
-      "summary": "verify that tarballs are ready to be uploaded",
+      "summary": "builds a new release from a designated starting point and optionally creates PR in Github",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "cli",
-        "tarballs",
-        "verify.js"
+        "release",
+        "build.js"
       ]
     },
     "cli:versions:inspect": {
@@ -1126,12 +1162,12 @@
         "inspect.js"
       ]
     },
-    "github:check:closed": {
+    "cli:tarballs:prepare": {
       "aliases": [],
       "args": {},
-      "description": "Description of a command.",
+      "description": "remove unnecessary files from node_modules",
       "examples": [
-        "<%= config.bin %> <%= command.id %> -o me@gus.com"
+        "<%= config.bin %> <%= command.id %>"
       ],
       "flags": {
         "json": {
@@ -1149,48 +1185,53 @@
           "multiple": false,
           "type": "option"
         },
-        "gus": {
-          "char": "o",
-          "name": "gus",
-          "noCacheDefault": true,
-          "required": true,
-          "summary": "Username/alias of your GUS org connection",
-          "hasDynamicHelp": true,
-          "multiple": false,
-          "type": "option"
+        "dryrun": {
+          "char": "d",
+          "name": "dryrun",
+          "summary": "only show what would be removed from node_modules",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "github-token": {
-          "env": "GITHUB_TOKEN",
-          "name": "github-token",
-          "required": true,
-          "summary": "Github token--store this in the environment as GITHUB_TOKEN",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "types": {
+          "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": true,
+      "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "github:check:closed",
+      "id": "cli:tarballs:prepare",
       "pluginAlias": "@salesforce/plugin-release-management",
       "pluginName": "@salesforce/plugin-release-management",
       "pluginType": "core",
       "strict": true,
-      "summary": "Show open Github issues with GUS WI",
+      "summary": "remove unnecessary files from node_modules",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
-        "github",
-        "check",
-        "closed.js"
+        "cli",
+        "tarballs",
+        "prepare.js"
       ]
     },
-    "npm:dependencies:pin": {
+    "cli:tarballs:smoke": {
       "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": "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.",
@@ -1207,45 +1248,40 @@
           "multiple": false,
           "type": "option"
         },
-        "dryrun": {
-          "char": "d",
-          "name": "dryrun",
-          "summary": "If true, will not make any changes to the package.json",
+        "verbose": {
+          "name": "verbose",
+          "summary": "show the --help output for each command",
           "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",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "npm:dependencies:pin",
+      "id": "cli:tarballs:smoke",
       "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": "smoke tests for the sf CLI\nTests that the CLI and every command can be initialized.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
-        "npm",
-        "dependencies",
-        "pin.js"
+        "cli",
+        "tarballs",
+        "smoke.js"
       ]
     },
-    "npm:package:release": {
+    "cli:tarballs:verify": {
       "aliases": [],
       "args": {},
-      "description": "publish npm package",
+      "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.",
@@ -1262,60 +1298,24 @@
           "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",
-          "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",
+        "cli": {
+          "char": "c",
+          "name": "cli",
+          "summary": "the cli to verify",
+          "default": "sfdx",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "sf",
+            "sfdx"
+          ],
           "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",
+        "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"
@@ -1323,20 +1323,20 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "npm:package:release",
+      "id": "cli:tarballs:verify",
       "pluginAlias": "@salesforce/plugin-release-management",
       "pluginName": "@salesforce/plugin-release-management",
       "pluginType": "core",
       "strict": true,
-      "summary": "publish npm package",
+      "summary": "verify that tarballs are ready to be uploaded",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
-        "npm",
-        "package",
-        "release.js"
+        "cli",
+        "tarballs",
+        "verify.js"
       ]
     },
     "cli:install:jit:test": {
@@ -1390,5 +1390,5 @@
       ]
     }
   },
-  "version": "5.7.62"
+  "version": "5.7.64"
 }