chore(release): 2.15.4 [skip ci]

Author: svc-cli-bot

CHANGELOG.md

@@ -1,3 +1,9 @@
+## [2.15.4](https://github.com/salesforcecli/plugin-packaging/compare/2.15.3...2.15.4) (2025-06-10)
+
+### Bug Fixes
+
+- edits ([6088dc0](https://github.com/salesforcecli/plugin-packaging/commit/6088dc01f2febad3597b0ff26826f04083e9f506))
+
 ## [2.15.3](https://github.com/salesforcecli/plugin-packaging/compare/2.15.2...2.15.3) (2025-06-09)
 
 ### Bug Fixes

README.md

@@ -60,20 +60,20 @@ See [DEVELOPING.md](DEVELOPING.md)
 
 ## `sf package convert`
 
-Create a second-generation package version from a first-generation package.
+Convert a managed-released first-generation managed package into a second-generation managed package.
 
 ```
 USAGE
   $ sf package convert -v <value> -p <value> [--json] [--flags-dir <value>] [--api-version <value>] [-k <value>] [-f
     <value>] [-x] [-w <value>] [-m <value>] [--verbose] [-a <value>]
 
 FLAGS
-  -a, --patch-version=<value>     Specific released patch version to convert
+  -a, --patch-version=<value>     Specific released patch version to be converted.
   -f, --definition-file=<value>   Path to a definition file that contains features and org preferences that the metadata
                                   of the package version depends on.
   -k, --installation-key=<value>  Installation key for key-protected package.
   -m, --seed-metadata=<value>     Directory containing metadata to be deployed prior to conversion.
-  -p, --package=<value>           (required) ID (starts with 033) of the first-generation package to convert.
+  -p, --package=<value>           (required) ID (starts with 033) of the first-generation managed package to convert.
   -v, --target-dev-hub=<value>    (required) Username or alias of the Dev Hub org. Not required if the `target-dev-hub`
                                   configuration variable is already set.
   -w, --wait=<value>              Minutes to wait for the package version to be created.
@@ -86,30 +86,27 @@ GLOBAL FLAGS
   --json               Format output as json.
 
 DESCRIPTION
-  Create a second-generation package version from a first-generation package.
+  Convert a managed-released first-generation managed package into a second-generation managed package.
 
-  The package convert creates a new package in the Dev Hub if one does not already exist for the specified
-  first-generation package.
+  The package conversion command automatically selects the latest released major.minor first-generation managed package
+  version, and converts it into a second-generation managed package version.
 
-  It then creates a new package version in the Dev Hub with contents based on the specified first-generation package.
-
-  By default, the latest released non-patch version from the specified first-generation package will be converted. Use
-  --patch-version to override the default. Read more about --patch-version option in help
+  Use --patch-version to specify a released patch version.
 
   To retrieve details about a package version create request, including status and package version ID (04t), run "sf
   package version create report -i 08c...".
 
-  We recommend specifying the --installation-key to protect the contents of your package and to prevent unauthorized
-  installation of your package.
+  To protect the contents of your package and to prevent unauthorized installation of your package, specify the
+  --installation-key flag.
 
   To list package version creation requests in the org, run "sf package version create list".
 
 ALIASES
   $ sf force package convert
 
 EXAMPLES
-  Create a second-generation package version from the first-generation package with the specified ID and give it the
-  installation key "password123"; uses your default Dev Hub org:
+  Create a second-generation managed package version from the first-generation managed package with the specified ID
+  and give it the installation key "password123"; uses your default Dev Hub org:
 
     $ sf package convert --package 033... --installation-key password123
 
@@ -118,9 +115,9 @@ EXAMPLES
     $ sf package convert --package 033... --installation-key password123 --target-dev-hub [email protected]
 
 FLAG DESCRIPTIONS
-  -a, --patch-version=<value>  Specific released patch version to convert
+  -a, --patch-version=<value>  Specific released patch version to be converted.
 
-    Specify a released patch version as major.minor.patch.build to convert to second generation package version
+    Specify a released patch version as major.minor.patch to convert to a second-generation managed package version.
 
   -f, --definition-file=<value>
 
@@ -135,15 +132,15 @@ FLAG DESCRIPTIONS
 
   -m, --seed-metadata=<value>  Directory containing metadata to be deployed prior to conversion.
 
-    The directory containing metadata that will be deployed on the build org prior to attempting conversion.
+    The directory containing metadata that will be deployed on the build org prior to attempting package conversion.
 
   -x, --installation-key-bypass  Bypass the installation key requirement.
 
     If you bypass this requirement, anyone can install your package. Either an --installation-key value or the
     --installation-key-bypass flag is required.
 ```
 
-_See code: [src/commands/package/convert.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/convert.ts)_
+_See code: [src/commands/package/convert.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/convert.ts)_
 
 ## `sf package create`
 
@@ -222,7 +219,7 @@ FLAG DESCRIPTIONS
     Org-Dependent Unlocked Packages" in the Salesforce DX Developer Guide.
 ```
 
-_See code: [src/commands/package/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/create.ts)_
+_See code: [src/commands/package/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/create.ts)_
 
 ## `sf package delete`
 
@@ -264,7 +261,7 @@ EXAMPLES
     $ sf package delete --package 0Ho... --target-dev-hub [email protected]
 ```
 
-_See code: [src/commands/package/delete.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/delete.ts)_
+_See code: [src/commands/package/delete.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/delete.ts)_
 
 ## `sf package install`
 
@@ -363,7 +360,7 @@ FLAG DESCRIPTIONS
     - Delete: Delete all removed components that can be safely deleted, and deprecate the other components.
 ```
 
-_See code: [src/commands/package/install.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/install.ts)_
+_See code: [src/commands/package/install.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/install.ts)_
 
 ## `sf package install report`
 
@@ -396,7 +393,7 @@ EXAMPLES
     $ sf package install report --request-id 0Hf... --target-org [email protected]
 ```
 
-_See code: [src/commands/package/install/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/install/report.ts)_
+_See code: [src/commands/package/install/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/install/report.ts)_
 
 ## `sf package installed list`
 
@@ -428,7 +425,7 @@ EXAMPLES
     $ sf package installed list --target-org [email protected]
 ```
 
-_See code: [src/commands/package/installed/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/installed/list.ts)_
+_See code: [src/commands/package/installed/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/installed/list.ts)_
 
 ## `sf package list`
 
@@ -466,7 +463,7 @@ EXAMPLES
     $ sf package list --target-dev-hub [email protected] --verbose
 ```
 
-_See code: [src/commands/package/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/list.ts)_
+_See code: [src/commands/package/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/list.ts)_
 
 ## `sf package push-upgrade abort`
 
@@ -506,7 +503,7 @@ EXAMPLES
     $ sf package push-upgrade abort --push-request-id 0DV... --target-dev-hub [email protected]
 ```
 
-_See code: [src/commands/package/push-upgrade/abort.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/push-upgrade/abort.ts)_
+_See code: [src/commands/package/push-upgrade/abort.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/push-upgrade/abort.ts)_
 
 ## `sf package push-upgrade list`
 
@@ -565,7 +562,7 @@ EXAMPLES
     $ sf package push-upgrade list --package 033xyz –-status Failed
 ```
 
-_See code: [src/commands/package/push-upgrade/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/push-upgrade/list.ts)_
+_See code: [src/commands/package/push-upgrade/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/push-upgrade/list.ts)_
 
 ## `sf package push-upgrade report`
 
@@ -607,7 +604,7 @@ EXAMPLES
     $ sf package push-upgrade report --push-request-id 0DV... --target-dev-hub [email protected]
 ```
 
-_See code: [src/commands/package/push-upgrade/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/push-upgrade/report.ts)_
+_See code: [src/commands/package/push-upgrade/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/push-upgrade/report.ts)_
 
 ## `sf package push-upgrade schedule`
 
@@ -689,7 +686,7 @@ FLAG DESCRIPTIONS
     Overrides the value of the target-dev-hub configuration variable, if set.
 ```
 
-_See code: [src/commands/package/push-upgrade/schedule.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/push-upgrade/schedule.ts)_
+_See code: [src/commands/package/push-upgrade/schedule.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/push-upgrade/schedule.ts)_
 
 ## `sf package uninstall`
 
@@ -737,7 +734,7 @@ EXAMPLES
     $ sf package uninstall --package "Undesirable Package Alias"
 ```
 
-_See code: [src/commands/package/uninstall.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/uninstall.ts)_
+_See code: [src/commands/package/uninstall.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/uninstall.ts)_
 
 ## `sf package uninstall report`
 
@@ -770,7 +767,7 @@ EXAMPLES
     $ sf package uninstall report --request-id 06y... --target-org [email protected]
 ```
 
-_See code: [src/commands/package/uninstall/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/uninstall/report.ts)_
+_See code: [src/commands/package/uninstall/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/uninstall/report.ts)_
 
 ## `sf package update`
 
@@ -825,7 +822,7 @@ FLAG DESCRIPTIONS
     associated with your package.
 ```
 
-_See code: [src/commands/package/update.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/update.ts)_
+_See code: [src/commands/package/update.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/update.ts)_
 
 ## `sf package version create`
 
@@ -1000,7 +997,7 @@ FLAG DESCRIPTIONS
     periods of no output from commands.
 ```
 
-_See code: [src/commands/package/version/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/version/create.ts)_
+_See code: [src/commands/package/version/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/version/create.ts)_
 
 ## `sf package version create list`
 
@@ -1061,7 +1058,7 @@ EXAMPLES
     $ sf package version create list --created-last-days 0 --status Success
 ```
 
-_See code: [src/commands/package/version/create/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/version/create/list.ts)_
+_See code: [src/commands/package/version/create/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/version/create/list.ts)_
 
 ## `sf package version create report`
 
@@ -1104,7 +1101,7 @@ EXAMPLES
     $ sf package version create report --package-create-request-id 08c... --target-dev-hub [email protected]
 ```
 
-_See code: [src/commands/package/version/create/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/version/create/report.ts)_
+_See code: [src/commands/package/version/create/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/version/create/report.ts)_
 
 ## `sf package version delete`
 
@@ -1145,7 +1142,7 @@ EXAMPLES
     $ sf package version delete --package 04t... --target-org [email protected]
 ```
 
-_See code: [src/commands/package/version/delete.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/version/delete.ts)_
+_See code: [src/commands/package/version/delete.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/version/delete.ts)_
 
 ## `sf package version displayancestry`
 
@@ -1205,7 +1202,7 @@ FLAG DESCRIPTIONS
     You can use the DOT code output in graph visualization software to create tree visualizations.
 ```
 
-_See code: [src/commands/package/version/displayancestry.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/version/displayancestry.ts)_
+_See code: [src/commands/package/version/displayancestry.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/version/displayancestry.ts)_
 
 ## `sf package version list`
 
@@ -1281,7 +1278,7 @@ EXAMPLES
     $ sf package version list --packages exp-mgr,exp-mgr-util --released --modified-last-days 0
 ```
 
-_See code: [src/commands/package/version/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/version/list.ts)_
+_See code: [src/commands/package/version/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/version/list.ts)_
 
 ## `sf package version promote`
 
@@ -1325,7 +1322,7 @@ EXAMPLES
     $ sf package version promote --package "Awesome Package Alias"
 ```
 
-_See code: [src/commands/package/version/promote.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/version/promote.ts)_
+_See code: [src/commands/package/version/promote.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/version/promote.ts)_
 
 ## `sf package version report`
 
@@ -1365,7 +1362,7 @@ EXAMPLES
     $ sf package version report --package "Your Package Alias" --target-dev-hub [email protected]
 ```
 
-_See code: [src/commands/package/version/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/version/report.ts)_
+_See code: [src/commands/package/version/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/version/report.ts)_
 
 ## `sf package version update`
 
@@ -1418,7 +1415,7 @@ EXAMPLES
     $ sf package version update --package 04t... --version-description "New Package Version Description"
 ```
 
-_See code: [src/commands/package/version/update.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/version/update.ts)_
+_See code: [src/commands/package/version/update.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/version/update.ts)_
 
 ## `sf package1 version create`
 
@@ -1485,7 +1482,7 @@ FLAG DESCRIPTIONS
     subscribers.
 ```
 
-_See code: [src/commands/package1/version/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package1/version/create.ts)_
+_See code: [src/commands/package1/version/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package1/version/create.ts)_
 
 ## `sf package1 version create get`
 
@@ -1518,7 +1515,7 @@ EXAMPLES
     $ sf package1 version create get --request-id 0HD... --target-org [email protected]
 ```
 
-_See code: [src/commands/package1/version/create/get.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package1/version/create/get.ts)_
+_See code: [src/commands/package1/version/create/get.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package1/version/create/get.ts)_
 
 ## `sf package1 version display`
 
@@ -1552,7 +1549,7 @@ EXAMPLES
     $ sf package1 version display --package-version-id 04t... --target-org [email protected]
 ```
 
-_See code: [src/commands/package1/version/display.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package1/version/display.ts)_
+_See code: [src/commands/package1/version/display.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package1/version/display.ts)_
 
 ## `sf package1 version list`
 
@@ -1590,6 +1587,6 @@ FLAG DESCRIPTIONS
     If not specified, shows all versions for all packages (managed and unmanaged) in the org.
 ```
 
-_See code: [src/commands/package1/version/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package1/version/list.ts)_
+_See code: [src/commands/package1/version/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package1/version/list.ts)_
 
 <!-- commandsstop -->

package.json

@@ -1,7 +1,7 @@
 {
   "name": "@salesforce/plugin-packaging",
   "description": "SF plugin that support Salesforce Packaging Platform",
-  "version": "2.15.3",
+  "version": "2.15.4",
   "author": "Salesforce",
   "bugs": "https://github.com/forcedotcom/cli/issues",
   "dependencies": {