chore(release): 2.17.0 [skip ci]

Author: svc-cli-bot

CHANGELOG.md

@@ -1,3 +1,9 @@
+# [2.17.0](https://github.com/salesforcecli/plugin-packaging/compare/2.16.0...2.17.0) (2025-07-01)
+
+### Features
+
+- **W-17369132:** reflect feat change to use Package2Version instead of MetadataP… ([#984](https://github.com/salesforcecli/plugin-packaging/issues/984)) ([31d12db](https://github.com/salesforcecli/plugin-packaging/commit/31d12dbd42ac6721483599a29067994073108358))
+
 # [2.16.0](https://github.com/salesforcecli/plugin-packaging/compare/2.15.4...2.16.0) (2025-06-13)
 
 ### Features

README.md

@@ -52,6 +52,7 @@ See [DEVELOPING.md](DEVELOPING.md)
 - [`sf package version list`](#sf-package-version-list)
 - [`sf package version promote`](#sf-package-version-promote)
 - [`sf package version report`](#sf-package-version-report)
+- [`sf package version retrieve`](#sf-package-version-retrieve)
 - [`sf package version update`](#sf-package-version-update)
 - [`sf package1 version create`](#sf-package1-version-create)
 - [`sf package1 version create get`](#sf-package1-version-create-get)
@@ -153,7 +154,7 @@ FLAG DESCRIPTIONS
     --installation-key-bypass flag is required.
 ```
 
-_See code: [src/commands/package/convert.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.16.0/src/commands/package/convert.ts)_
+_See code: [src/commands/package/convert.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.17.0/src/commands/package/convert.ts)_
 
 ## `sf package create`
 
@@ -232,7 +233,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.16.0/src/commands/package/create.ts)_
+_See code: [src/commands/package/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.17.0/src/commands/package/create.ts)_
 
 ## `sf package delete`
 
@@ -274,7 +275,7 @@ EXAMPLES
     $ sf package delete --package 0Ho... --target-dev-hub devhub@example.com
 ```
 
-_See code: [src/commands/package/delete.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.16.0/src/commands/package/delete.ts)_
+_See code: [src/commands/package/delete.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.17.0/src/commands/package/delete.ts)_
 
 ## `sf package install`
 
@@ -373,7 +374,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.16.0/src/commands/package/install.ts)_
+_See code: [src/commands/package/install.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.17.0/src/commands/package/install.ts)_
 
 ## `sf package install report`
 
@@ -406,7 +407,7 @@ EXAMPLES
     $ sf package install report --request-id 0Hf... --target-org me@example.com
 ```
 
-_See code: [src/commands/package/install/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.16.0/src/commands/package/install/report.ts)_
+_See code: [src/commands/package/install/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.17.0/src/commands/package/install/report.ts)_
 
 ## `sf package installed list`
 
@@ -438,7 +439,7 @@ EXAMPLES
     $ sf package installed list --target-org me@example.com
 ```
 
-_See code: [src/commands/package/installed/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.16.0/src/commands/package/installed/list.ts)_
+_See code: [src/commands/package/installed/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.17.0/src/commands/package/installed/list.ts)_
 
 ## `sf package list`
 
@@ -476,7 +477,7 @@ EXAMPLES
     $ sf package list --target-dev-hub devhub@example.com --verbose
 ```
 
-_See code: [src/commands/package/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.16.0/src/commands/package/list.ts)_
+_See code: [src/commands/package/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.17.0/src/commands/package/list.ts)_
 
 ## `sf package push-upgrade abort`
 
@@ -501,8 +502,7 @@ DESCRIPTION
   Abort a package push upgrade that has been scheduled. Only push upgrade requests with a status of Created or Pending
   can be aborted.
 
-  Specify the request ID for which you want abort the request. If applicable, the command displays errors related to the
-  request.
+  Specify the request ID that you want to abort. If applicable, the command displays errors related to the request.
 
   To show all requests in the org, run "sf package pushupgrade list --package 033...".
 
@@ -516,7 +516,7 @@ EXAMPLES
     $ sf package push-upgrade abort --push-request-id 0DV... --target-dev-hub devhub@example.com
 ```
 
-_See code: [src/commands/package/push-upgrade/abort.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.16.0/src/commands/package/push-upgrade/abort.ts)_
+_See code: [src/commands/package/push-upgrade/abort.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.17.0/src/commands/package/push-upgrade/abort.ts)_
 
 ## `sf package push-upgrade list`
 
@@ -575,7 +575,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.16.0/src/commands/package/push-upgrade/list.ts)_
+_See code: [src/commands/package/push-upgrade/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.17.0/src/commands/package/push-upgrade/list.ts)_
 
 ## `sf package push-upgrade report`
 
@@ -617,7 +617,7 @@ EXAMPLES
     $ sf package push-upgrade report --push-request-id 0DV... --target-dev-hub devhub@example.com
 ```
 
-_See code: [src/commands/package/push-upgrade/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.16.0/src/commands/package/push-upgrade/report.ts)_
+_See code: [src/commands/package/push-upgrade/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.17.0/src/commands/package/push-upgrade/report.ts)_
 
 ## `sf package push-upgrade schedule`
 
@@ -629,13 +629,15 @@ USAGE
     <value> | -f <value>] [--migrate-to-2gp]
 
 FLAGS
-  -f, --org-file=<value>        Filename of the CSV file that contains the list of orgs that need the package upgrade.
-  -l, --org-list=<value>        Comma-separated list of subscriber org IDs that need the package upgrade.
+  -f, --org-file=<value>        Filename of the CSV file that contains the list of subscriber org IDs that need the
+                                package upgrade. Either --org-list or --org-file must be specified.
+  -l, --org-list=<value>        Comma-separated list of subscriber org IDs that need the package upgrade. Either
+                                --org-list or --org-file must be specified.
   -p, --package=<value>         (required) ID (starts with 04t) of the package version that the package is being
                                 upgraded to. The package version must be an active, non-beta package version.
   -t, --start-time=<value>      Date and time (UTC) when the push upgrade is processed. Set to the earliest time that
                                 you want Salesforce to attempt to start the upgrade.
-  -v, --target-dev-hub=<value>  (required) Username or alias of the Dev Hub org.
+  -v, --target-dev-hub=<value>  (required) Username or alias of the Dev Hub org that owns the package.
       --api-version=<value>     Override the api version used for api requests made by this command
       --migrate-to-2gp          Upgrade from a first-generation managed package (1GP) to a second-generation managed
                                 package (2GP). Required when you’re pushing a 2GP package to orgs with the 1GP version
@@ -663,23 +665,26 @@ EXAMPLES
   Schedule a push upgrade that initiates at a specified time:
 
     $ sf package push-upgrade schedule --package 04txyz --start-time "2024-12-06T21:00:00" --org-file \
-      upgrade-orgs.csv
+      upgrade-orgs.csv --target-dev-hub myHub
 
   Schedule a push upgrade that initiates as soon as possible:
 
-    $ sf package push-upgrade schedule --package 04txyz --org-file upgrade-orgs.csv
+    $ sf package push-upgrade schedule --package 04txyz --org-file upgrade-orgs.csv --target-dev-hub myHub
 
   Schedule a push migration from a 1GP package to a 2GP package:
 
     $ sf package push-upgrade schedule --migrate-to-2gp --package 04txyz --start-time "2024-12-06T21:00:00" \
       --org-file upgrade-orgs.csv --target-dev-hub myHub
 
 FLAG DESCRIPTIONS
-  -f, --org-file=<value>  Filename of the CSV file that contains the list of orgs that need the package upgrade.
+  -f, --org-file=<value>
+
+    Filename of the CSV file that contains the list of subscriber org IDs that need the package upgrade. Either
+    --org-list or --org-file must be specified.
 
     The file must contain one org per line. The org ID must be the only value in each row.
     All listed orgs must have a package version installed in their org that is lower than the package version you
-    specified for the --package-version flag.
+    specified for the --package flag.
 
   -t, --start-time=<value>
 
@@ -694,12 +699,12 @@ FLAG DESCRIPTIONS
     If you don't specify this flag, the push upgrade is scheduled to run as soon as resources are available on the
     Salesforce instance.
 
-  -v, --target-dev-hub=<value>  Username or alias of the Dev Hub org.
+  -v, --target-dev-hub=<value>  Username or alias of the Dev Hub org that owns the package.
 
     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.16.0/src/commands/package/push-upgrade/schedule.ts)_
+_See code: [src/commands/package/push-upgrade/schedule.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.17.0/src/commands/package/push-upgrade/schedule.ts)_
 
 ## `sf package uninstall`
 
@@ -747,7 +752,7 @@ EXAMPLES
     $ sf package uninstall --package "Undesirable Package Alias"
 ```
 
-_See code: [src/commands/package/uninstall.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.16.0/src/commands/package/uninstall.ts)_
+_See code: [src/commands/package/uninstall.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.17.0/src/commands/package/uninstall.ts)_
 
 ## `sf package uninstall report`
 
@@ -780,7 +785,7 @@ EXAMPLES
     $ sf package uninstall report --request-id 06y... --target-org me@example.com
 ```
 
-_See code: [src/commands/package/uninstall/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.16.0/src/commands/package/uninstall/report.ts)_
+_See code: [src/commands/package/uninstall/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.17.0/src/commands/package/uninstall/report.ts)_
 
 ## `sf package update`
 
@@ -835,7 +840,7 @@ FLAG DESCRIPTIONS
     associated with your package.
 ```
 
-_See code: [src/commands/package/update.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.16.0/src/commands/package/update.ts)_
+_See code: [src/commands/package/update.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.17.0/src/commands/package/update.ts)_
 
 ## `sf package version create`
 
@@ -1010,7 +1015,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.16.0/src/commands/package/version/create.ts)_
+_See code: [src/commands/package/version/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.17.0/src/commands/package/version/create.ts)_
 
 ## `sf package version create list`
 
@@ -1071,7 +1076,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.16.0/src/commands/package/version/create/list.ts)_
+_See code: [src/commands/package/version/create/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.17.0/src/commands/package/version/create/list.ts)_
 
 ## `sf package version create report`
 
@@ -1114,7 +1119,7 @@ EXAMPLES
     $ sf package version create report --package-create-request-id 08c... --target-dev-hub devhub@example.com
 ```
 
-_See code: [src/commands/package/version/create/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.16.0/src/commands/package/version/create/report.ts)_
+_See code: [src/commands/package/version/create/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.17.0/src/commands/package/version/create/report.ts)_
 
 ## `sf package version delete`
 
@@ -1155,7 +1160,7 @@ EXAMPLES
     $ sf package version delete --package 04t... --target-org devhub@example.com
 ```
 
-_See code: [src/commands/package/version/delete.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.16.0/src/commands/package/version/delete.ts)_
+_See code: [src/commands/package/version/delete.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.17.0/src/commands/package/version/delete.ts)_
 
 ## `sf package version displayancestry`
 
@@ -1215,7 +1220,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.16.0/src/commands/package/version/displayancestry.ts)_
+_See code: [src/commands/package/version/displayancestry.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.17.0/src/commands/package/version/displayancestry.ts)_
 
 ## `sf package version list`
 
@@ -1291,7 +1296,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.16.0/src/commands/package/version/list.ts)_
+_See code: [src/commands/package/version/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.17.0/src/commands/package/version/list.ts)_
 
 ## `sf package version promote`
 
@@ -1335,7 +1340,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.16.0/src/commands/package/version/promote.ts)_
+_See code: [src/commands/package/version/promote.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.17.0/src/commands/package/version/promote.ts)_
 
 ## `sf package version report`
 
@@ -1375,7 +1380,46 @@ EXAMPLES
     $ sf package version report --package "Your Package Alias" --target-dev-hub devhub@example.com
 ```
 
-_See code: [src/commands/package/version/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.16.0/src/commands/package/version/report.ts)_
+_See code: [src/commands/package/version/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.17.0/src/commands/package/version/report.ts)_
+
+## `sf package version retrieve`
+
+Retrieve package metadata for a specified package version. Package metadata can be retrieved for converted second-generation managed package versions only.
+
+```
+USAGE
+  $ sf package version retrieve -v <value> -p <value> [--json] [--flags-dir <value>] [--api-version <value>] [-d
+  <value>]
+
+FLAGS
+  -d, --output-dir=<value>      [default: force-app] Path within your Salesforce DX project directory in which to
+                                download the metadata. This directory must be empty.
+  -p, --package=<value>         (required) Subscriber package version ID (starts with 04t).
+  -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.
+      --api-version=<value>     Override the api version used for api requests made by this command
+
+GLOBAL FLAGS
+  --flags-dir=<value>  Import flag values from a directory.
+  --json               Format output as json.
+
+DESCRIPTION
+  Retrieve package metadata for a specified package version. Package metadata can be retrieved for converted
+  second-generation managed package versions only.
+
+  Retrieving a package version downloads the metadata into the directory you specify.
+
+  Specify the subscriber package version ID (starts with 04t) and the path to an empty directory when you run this
+  command.
+
+EXAMPLES
+  Retrieve package metadata for a converted subscriber package version ID (starts with 04t) into my-folder/ within
+  your Salesforce DX project directory:
+
+    $ sf package version retrieve --package 04t... --output-dir my-folder –-target-dev-hub my-devhub
+```
+
+_See code: [src/commands/package/version/retrieve.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.17.0/src/commands/package/version/retrieve.ts)_
 
 ## `sf package version update`
 
@@ -1428,7 +1472,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.16.0/src/commands/package/version/update.ts)_
+_See code: [src/commands/package/version/update.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.17.0/src/commands/package/version/update.ts)_
 
 ## `sf package1 version create`
 
@@ -1495,7 +1539,7 @@ FLAG DESCRIPTIONS
     subscribers.
 ```
 
-_See code: [src/commands/package1/version/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.16.0/src/commands/package1/version/create.ts)_
+_See code: [src/commands/package1/version/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.17.0/src/commands/package1/version/create.ts)_
 
 ## `sf package1 version create get`
 
@@ -1528,7 +1572,7 @@ EXAMPLES
     $ sf package1 version create get --request-id 0HD... --target-org myorg@example.com
 ```
 
-_See code: [src/commands/package1/version/create/get.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.16.0/src/commands/package1/version/create/get.ts)_
+_See code: [src/commands/package1/version/create/get.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.17.0/src/commands/package1/version/create/get.ts)_
 
 ## `sf package1 version display`
 
@@ -1562,7 +1606,7 @@ EXAMPLES
     $ sf package1 version display --package-version-id 04t... --target-org myorg@example.com
 ```
 
-_See code: [src/commands/package1/version/display.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.16.0/src/commands/package1/version/display.ts)_
+_See code: [src/commands/package1/version/display.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.17.0/src/commands/package1/version/display.ts)_
 
 ## `sf package1 version list`
 
@@ -1600,6 +1644,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.16.0/src/commands/package1/version/list.ts)_
+_See code: [src/commands/package1/version/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.17.0/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.16.0",
+  "version": "2.17.0",
   "author": "Salesforce",
   "bugs": "https://github.com/forcedotcom/cli/issues",
   "dependencies": {