chore(release): 2.23.0 [skip ci]

Author: svc-cli-bot

CHANGELOG.md

@@ -1,3 +1,9 @@
+# [2.23.0](https://github.com/salesforcecli/plugin-packaging/compare/2.22.4...2.23.0) (2025-10-30)
+
+### Features
+
+- unhide package version retrieve command ([ac81bb8](https://github.com/salesforcecli/plugin-packaging/commit/ac81bb8358c84d19af8316dd138a633330974ad1))
+
 ## [2.22.4](https://github.com/salesforcecli/plugin-packaging/compare/2.22.3...2.22.4) (2025-10-26)
 
 ### Bug Fixes

README.md

@@ -53,6 +53,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)
@@ -154,7 +155,7 @@ FLAG DESCRIPTIONS
     --installation-key-bypass flag is required.
 ```
 
-_See code: [src/commands/package/convert.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.22.4/src/commands/package/convert.ts)_
+_See code: [src/commands/package/convert.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.23.0/src/commands/package/convert.ts)_
 
 ## `sf package create`
 
@@ -233,7 +234,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.22.4/src/commands/package/create.ts)_
+_See code: [src/commands/package/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.23.0/src/commands/package/create.ts)_
 
 ## `sf package delete`
 
@@ -275,7 +276,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.22.4/src/commands/package/delete.ts)_
+_See code: [src/commands/package/delete.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.23.0/src/commands/package/delete.ts)_
 
 ## `sf package install`
 
@@ -374,7 +375,7 @@ FLAG DESCRIPTIONS
     - Delete: Delete removed components, except for custom objects and custom fields, that don't have dependencies.
 ```
 
-_See code: [src/commands/package/install.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.22.4/src/commands/package/install.ts)_
+_See code: [src/commands/package/install.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.23.0/src/commands/package/install.ts)_
 
 ## `sf package install report`
 
@@ -407,7 +408,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.22.4/src/commands/package/install/report.ts)_
+_See code: [src/commands/package/install/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.23.0/src/commands/package/install/report.ts)_
 
 ## `sf package installed list`
 
@@ -439,7 +440,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.22.4/src/commands/package/installed/list.ts)_
+_See code: [src/commands/package/installed/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.23.0/src/commands/package/installed/list.ts)_
 
 ## `sf package list`
 
@@ -477,7 +478,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.22.4/src/commands/package/list.ts)_
+_See code: [src/commands/package/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.23.0/src/commands/package/list.ts)_
 
 ## `sf package push-upgrade abort`
 
@@ -516,7 +517,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.22.4/src/commands/package/push-upgrade/abort.ts)_
+_See code: [src/commands/package/push-upgrade/abort.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.23.0/src/commands/package/push-upgrade/abort.ts)_
 
 ## `sf package push-upgrade list`
 
@@ -575,7 +576,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.22.4/src/commands/package/push-upgrade/list.ts)_
+_See code: [src/commands/package/push-upgrade/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.23.0/src/commands/package/push-upgrade/list.ts)_
 
 ## `sf package push-upgrade report`
 
@@ -617,7 +618,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.22.4/src/commands/package/push-upgrade/report.ts)_
+_See code: [src/commands/package/push-upgrade/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.23.0/src/commands/package/push-upgrade/report.ts)_
 
 ## `sf package push-upgrade schedule`
 
@@ -704,7 +705,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.22.4/src/commands/package/push-upgrade/schedule.ts)_
+_See code: [src/commands/package/push-upgrade/schedule.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.23.0/src/commands/package/push-upgrade/schedule.ts)_
 
 ## `sf package uninstall`
 
@@ -752,7 +753,7 @@ EXAMPLES
     $ sf package uninstall --package "Undesirable Package Alias"
 ```
 
-_See code: [src/commands/package/uninstall.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.22.4/src/commands/package/uninstall.ts)_
+_See code: [src/commands/package/uninstall.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.23.0/src/commands/package/uninstall.ts)_
 
 ## `sf package uninstall report`
 
@@ -785,7 +786,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.22.4/src/commands/package/uninstall/report.ts)_
+_See code: [src/commands/package/uninstall/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.23.0/src/commands/package/uninstall/report.ts)_
 
 ## `sf package update`
 
@@ -848,7 +849,7 @@ FLAG DESCRIPTIONS
     notified to upgrade to the recommended version.
 ```
 
-_See code: [src/commands/package/update.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.22.4/src/commands/package/update.ts)_
+_See code: [src/commands/package/update.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.23.0/src/commands/package/update.ts)_
 
 ## `sf package version create`
 
@@ -1023,7 +1024,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.22.4/src/commands/package/version/create.ts)_
+_See code: [src/commands/package/version/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.23.0/src/commands/package/version/create.ts)_
 
 ## `sf package version create list`
 
@@ -1084,7 +1085,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.22.4/src/commands/package/version/create/list.ts)_
+_See code: [src/commands/package/version/create/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.23.0/src/commands/package/version/create/list.ts)_
 
 ## `sf package version create report`
 
@@ -1127,7 +1128,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.22.4/src/commands/package/version/create/report.ts)_
+_See code: [src/commands/package/version/create/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.23.0/src/commands/package/version/create/report.ts)_
 
 ## `sf package version delete`
 
@@ -1168,7 +1169,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.22.4/src/commands/package/version/delete.ts)_
+_See code: [src/commands/package/version/delete.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.23.0/src/commands/package/version/delete.ts)_
 
 ## `sf package version displayancestry`
 
@@ -1228,7 +1229,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.22.4/src/commands/package/version/displayancestry.ts)_
+_See code: [src/commands/package/version/displayancestry.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.23.0/src/commands/package/version/displayancestry.ts)_
 
 ## `sf package version displaydependencies`
 
@@ -1290,7 +1291,7 @@ FLAG DESCRIPTIONS
     package, which must be installed last.
 ```
 
-_See code: [src/commands/package/version/displaydependencies.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.22.4/src/commands/package/version/displaydependencies.ts)_
+_See code: [src/commands/package/version/displaydependencies.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.23.0/src/commands/package/version/displaydependencies.ts)_
 
 ## `sf package version list`
 
@@ -1366,7 +1367,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.22.4/src/commands/package/version/list.ts)_
+_See code: [src/commands/package/version/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.23.0/src/commands/package/version/list.ts)_
 
 ## `sf package version promote`
 
@@ -1410,7 +1411,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.22.4/src/commands/package/version/promote.ts)_
+_See code: [src/commands/package/version/promote.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.23.0/src/commands/package/version/promote.ts)_
 
 ## `sf package version report`
 
@@ -1450,7 +1451,50 @@ 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.22.4/src/commands/package/version/report.ts)_
+_See code: [src/commands/package/version/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.23.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 second-generation managed package versions or unlocked packages 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 second-generation
+  managed package versions or unlocked packages only.
+
+  Retrieving a package version downloads the metadata into the directory you specify.
+
+  When you run this command, specify the subscriber package version ID (starts with 04t) and the path to an empty
+  directory.
+
+  By default, the package version retrieve command is available to 2GP managed packages that were converted from 1GP. To
+  use this command with a managed package created using 2GP (not converted from 1GP) or with an unlocked package,
+  specify IsDevUsePkgZipRequested = true in the Package2VersionCreateRequest Tooling API object. If you run this command
+  and the zip folder with the package version’s source files is missing, confirm that IsDevUsePkgZipRequested is set to
+  true.
+
+EXAMPLES
+  Retrieve package metadata for a converted subscriber package version ID (starts with 04t) into my-directory/ within your Salesforce DX project directory:
+    sf package version retrieve --package 04tXXX --output-dir my-directory/ --target-dev-hub devhub@example.com
+```
+
+_See code: [src/commands/package/version/retrieve.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.23.0/src/commands/package/version/retrieve.ts)_
 
 ## `sf package version update`
 
@@ -1503,7 +1547,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.22.4/src/commands/package/version/update.ts)_
+_See code: [src/commands/package/version/update.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.23.0/src/commands/package/version/update.ts)_
 
 ## `sf package1 version create`
 
@@ -1570,7 +1614,7 @@ FLAG DESCRIPTIONS
     subscribers.
 ```
 
-_See code: [src/commands/package1/version/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.22.4/src/commands/package1/version/create.ts)_
+_See code: [src/commands/package1/version/create.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.23.0/src/commands/package1/version/create.ts)_
 
 ## `sf package1 version create get`
 
@@ -1603,7 +1647,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.22.4/src/commands/package1/version/create/get.ts)_
+_See code: [src/commands/package1/version/create/get.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.23.0/src/commands/package1/version/create/get.ts)_
 
 ## `sf package1 version display`
 
@@ -1637,7 +1681,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.22.4/src/commands/package1/version/display.ts)_
+_See code: [src/commands/package1/version/display.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.23.0/src/commands/package1/version/display.ts)_
 
 ## `sf package1 version list`
 
@@ -1675,6 +1719,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.22.4/src/commands/package1/version/list.ts)_
+_See code: [src/commands/package1/version/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.23.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.22.4",
+  "version": "2.23.0",
   "author": "Salesforce",
   "bugs": "https://github.com/forcedotcom/cli/issues",
   "dependencies": {