@salesforce/plugin-packaging 2.15.3 → 2.16.0

package/README.md

@@ -60,20 +60,22 @@ 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>]
+    <value>] [-x] [-w <value>] [-m <value>] [--verbose] [-a <value>] [-c]
 
 FLAGS
-  -a, --patch-version=<value>     Specific released patch version to convert
+  -a, --patch-version=<value>     Specific released patch version to be converted.
+  -c, --code-coverage             Calculate and store the code coverage percentage by running the packaged Apex tests
+                                  included in this package version.
   -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,21 +88,21 @@ 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 promote a package version to released, you must use the --code-coverage parameter. The package must also meet the
+  code coverage requirements.
 
   To list package version creation requests in the org, run "sf package version create list".
 
@@ -108,8 +110,8 @@ 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 +120,17 @@ EXAMPLES
     $ sf package convert --package 033... --installation-key password123 --target-dev-hub devhuborg@example.com
 
 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 to convert to a second-generation managed package version.
+
+  -c, --code-coverage
+
+    Calculate and store the code coverage percentage by running the packaged Apex tests included in this package
+    version.
 
-    Specify a released patch version as major.minor.patch.build to convert to second generation package version
+    Before you can promote and release a managed package version, the Apex code must meet a minimum 75% code coverage
+    requirement.
 
   -f, --definition-file=<value>
 
@@ -135,7 +145,7 @@ 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.
 
@@ -143,7 +153,7 @@ FLAG DESCRIPTIONS
     --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.16.0/src/commands/package/convert.ts)_
 
 ## `sf package create`
 
@@ -222,7 +232,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.16.0/src/commands/package/create.ts)_
 
 ## `sf package delete`
 
@@ -264,7 +274,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.15.3/src/commands/package/delete.ts)_
+_See code: [src/commands/package/delete.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.16.0/src/commands/package/delete.ts)_
 
 ## `sf package install`
 
@@ -363,7 +373,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.16.0/src/commands/package/install.ts)_
 
 ## `sf package install report`
 
@@ -396,7 +406,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.15.3/src/commands/package/install/report.ts)_
+_See code: [src/commands/package/install/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.16.0/src/commands/package/install/report.ts)_
 
 ## `sf package installed list`
 
@@ -428,7 +438,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.15.3/src/commands/package/installed/list.ts)_
+_See code: [src/commands/package/installed/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.16.0/src/commands/package/installed/list.ts)_
 
 ## `sf package list`
 
@@ -466,7 +476,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.15.3/src/commands/package/list.ts)_
+_See code: [src/commands/package/list.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.16.0/src/commands/package/list.ts)_
 
 ## `sf package push-upgrade abort`
 
@@ -506,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.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.16.0/src/commands/package/push-upgrade/abort.ts)_
 
 ## `sf package push-upgrade list`
 
@@ -565,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.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.16.0/src/commands/package/push-upgrade/list.ts)_
 
 ## `sf package push-upgrade report`
 
@@ -607,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.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.16.0/src/commands/package/push-upgrade/report.ts)_
 
 ## `sf package push-upgrade schedule`
 
@@ -689,7 +699,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.16.0/src/commands/package/push-upgrade/schedule.ts)_
 
 ## `sf package uninstall`
 
@@ -737,7 +747,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.16.0/src/commands/package/uninstall.ts)_
 
 ## `sf package uninstall report`
 
@@ -770,7 +780,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.15.3/src/commands/package/uninstall/report.ts)_
+_See code: [src/commands/package/uninstall/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.16.0/src/commands/package/uninstall/report.ts)_
 
 ## `sf package update`
 
@@ -825,7 +835,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.16.0/src/commands/package/update.ts)_
 
 ## `sf package version create`
 
@@ -1000,7 +1010,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.16.0/src/commands/package/version/create.ts)_
 
 ## `sf package version create list`
 
@@ -1061,7 +1071,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.16.0/src/commands/package/version/create/list.ts)_
 
 ## `sf package version create report`
 
@@ -1104,7 +1114,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.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.16.0/src/commands/package/version/create/report.ts)_
 
 ## `sf package version delete`
 
@@ -1145,7 +1155,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.15.3/src/commands/package/version/delete.ts)_
+_See code: [src/commands/package/version/delete.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.16.0/src/commands/package/version/delete.ts)_
 
 ## `sf package version displayancestry`
 
@@ -1205,7 +1215,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.16.0/src/commands/package/version/displayancestry.ts)_
 
 ## `sf package version list`
 
@@ -1281,7 +1291,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.16.0/src/commands/package/version/list.ts)_
 
 ## `sf package version promote`
 
@@ -1325,7 +1335,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.16.0/src/commands/package/version/promote.ts)_
 
 ## `sf package version report`
 
@@ -1365,7 +1375,7 @@ 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.15.3/src/commands/package/version/report.ts)_
+_See code: [src/commands/package/version/report.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.16.0/src/commands/package/version/report.ts)_
 
 ## `sf package version update`
 
@@ -1418,7 +1428,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.16.0/src/commands/package/version/update.ts)_
 
 ## `sf package1 version create`
 
@@ -1485,7 +1495,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.16.0/src/commands/package1/version/create.ts)_
 
 ## `sf package1 version create get`
 
@@ -1518,7 +1528,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.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.16.0/src/commands/package1/version/create/get.ts)_
 
 ## `sf package1 version display`
 
@@ -1552,7 +1562,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.15.3/src/commands/package1/version/display.ts)_
+_See code: [src/commands/package1/version/display.ts](https://github.com/salesforcecli/plugin-packaging/blob/2.16.0/src/commands/package1/version/display.ts)_
 
 ## `sf package1 version list`
 
@@ -1590,6 +1600,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.16.0/src/commands/package1/version/list.ts)_
 
 <!-- commandsstop -->

package/lib/commands/package/convert.d.ts

@@ -20,6 +20,7 @@ export declare class PackageConvert extends SfCommand<PackageVersionCreateReques
         'seed-metadata': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'patch-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'code-coverage': import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<PackageVersionCreateRequestResult>;
     private display;

package/lib/commands/package/convert.js

@@ -80,6 +80,12 @@ export class PackageConvert extends SfCommand {
             deprecateAliases: true,
             aliases: ['patchversion'],
         }),
+        'code-coverage': Flags.boolean({
+            char: 'c',
+            summary: messages.getMessage('flags.code-coverage.summary'),
+            description: messages.getMessage('flags.code-coverage.description'),
+            default: false,
+        }),
     };
     async run() {
         const { flags } = await this.parse(PackageConvert);
@@ -117,6 +123,7 @@ export class PackageConvert extends SfCommand {
             buildInstance: flags['build-instance'],
             seedMetadata: flags['seed-metadata'],
             patchversion: flags['patch-version'],
+            codecoverage: flags['code-coverage'],
         }, project);
         switch (result.Status) {
             case PackagingSObjects['Package2VersionStatus'].error:

package/lib/commands/package/convert.js.map

@@ -1 +1 @@
-{"version":3,"file":"convert.js","sourceRoot":"","sources":["../../../src/commands/package/convert.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"convert.js","sourceRoot":"","sources":["../../../src/commands/package/convert.ts"],"names":[],"mappings":"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"}

package/messages/package_convert.md

@@ -1,24 +1,24 @@
 # summary
 
-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.
 
 # description
 
-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 "<%= config.bin %> 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 promote a package version to released, you must use the --code-coverage parameter. The package must also meet the code coverage requirements.
 
 To list package version creation requests in the org, run "<%= config.bin %> package version create list".
 
 # 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:
 
   <%= config.bin %> <%= command.id %> --package 033... --installation-key password123
 
@@ -28,7 +28,7 @@ To list package version creation requests in the org, run "<%= config.bin %> pac
 
 # flags.package.summary
 
-ID (starts with 033) of the first-generation package to convert.
+ID (starts with 033) of the first-generation managed package to convert.
 
 # flags.installation-key.summary
 
@@ -68,7 +68,7 @@ Display verbose command output.
 
 # in-progress
 
-Request in progress. Will wait a total of %s more seconds before timing out. Current Status='%s'
+Request in progress. Will wait a total of %s more seconds before timing out. Current Status='%s'.
 
 # flags.seed-metadata.summary
 
@@ -76,12 +76,20 @@ Directory containing metadata to be deployed prior to conversion.
 
 # flags.seed-metadata.description
 
-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.
 
 # flags.patch-version.summary
 
-Specific released patch version to convert
+Specific released patch version to be converted.
 
 # flags.patch-version.description
 
-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.
+
+# flags.code-coverage.summary
+
+Calculate and store the code coverage percentage by running the packaged Apex tests included in this package version.
+
+# flags.code-coverage.description
+
+Before you can promote and release a managed package version, the Apex code must meet a minimum 75% code coverage requirement.

package/oclif.manifest.json

@@ -6,9 +6,9 @@
       ],
       "args": {},
       "deprecateAliases": true,
-      "description": "The package convert creates a new package in the Dev Hub if one does not already exist for the specified first-generation package.\n\nIt then creates a new package version in the Dev Hub with contents based on the specified first-generation package.\n\nBy 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\n\nTo retrieve details about a package version create request, including status and package version ID (04t), run \"<%= config.bin %> package version create report -i 08c...\".\n\nWe recommend specifying the --installation-key to protect the contents of your package and to prevent unauthorized installation of your package.\n\nTo list package version creation requests in the org, run \"<%= config.bin %> package version create list\".",
+      "description": "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.\n\nUse --patch-version to specify a released patch version.\n\nTo retrieve details about a package version create request, including status and package version ID (04t), run \"<%= config.bin %> package version create report -i 08c...\".\n\nTo protect the contents of your package and to prevent unauthorized installation of your package, specify the --installation-key flag.\n\nTo promote a package version to released, you must use the --code-coverage parameter. The package must also meet the code coverage requirements.\n\nTo list package version creation requests in the org, run \"<%= config.bin %> package version create list\".",
       "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:\n<%= config.bin %> <%= command.id %> --package 033... --installation-key password123",
+        "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:\n<%= config.bin %> <%= command.id %> --package 033... --installation-key password123",
         "Similar to previous example, but uses the specified Dev Hub org:\n<%= config.bin %> <%= command.id %> --package 033... --installation-key password123 --target-dev-hub devhuborg@example.com"
       ],
       "flags": {
@@ -67,7 +67,7 @@
           "char": "p",
           "name": "package",
           "required": true,
-          "summary": "ID (starts with 033) of the first-generation package to convert.",
+          "summary": "ID (starts with 033) of the first-generation managed package to convert.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -133,7 +133,7 @@
         },
         "seed-metadata": {
           "char": "m",
-          "description": "The directory containing metadata that will be deployed on the build org prior to attempting conversion.",
+          "description": "The directory containing metadata that will be deployed on the build org prior to attempting package conversion.",
           "name": "seed-metadata",
           "summary": "Directory containing metadata to be deployed prior to conversion.",
           "hasDynamicHelp": false,
@@ -152,12 +152,20 @@
           ],
           "char": "a",
           "deprecateAliases": true,
-          "description": "Specify a released patch version as major.minor.patch.build to convert to second generation package version",
+          "description": "Specify a released patch version as major.minor.patch to convert to a second-generation managed package version.",
           "name": "patch-version",
-          "summary": "Specific released patch version to convert",
+          "summary": "Specific released patch version to be converted.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "code-coverage": {
+          "char": "c",
+          "description": "Before you can promote and release a managed package version, the Apex code must meet a minimum 75% code coverage requirement.",
+          "name": "code-coverage",
+          "summary": "Calculate and store the code coverage percentage by running the packaged Apex tests included in this package version.",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
@@ -167,7 +175,7 @@
       "pluginName": "@salesforce/plugin-packaging",
       "pluginType": "core",
       "strict": true,
-      "summary": "Create a second-generation package version from a first-generation package.",
+      "summary": "Convert a managed-released first-generation managed package into a second-generation managed package.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -4542,5 +4550,5 @@
       ]
     }
   },
-  "version": "2.15.3"
+  "version": "2.16.0"
 }

package/package.json

@@ -1,14 +1,14 @@
 {
     "name": "@salesforce/plugin-packaging",
     "description": "SF plugin that support Salesforce Packaging Platform",
-    "version": "2.15.3",
+    "version": "2.16.0",
     "author": "Salesforce",
     "bugs": "https://github.com/forcedotcom/cli/issues",
     "dependencies": {
         "@oclif/core": "^4",
         "@salesforce/core": "^8.12.0",
         "@salesforce/kit": "^3.2.3",
-        "@salesforce/packaging": "^4.6.0",
+        "@salesforce/packaging": "^4.7.0",
         "@salesforce/sf-plugins-core": "^12.2.2",
         "chalk": "^5.4.1"
     },
@@ -247,7 +247,7 @@
     "exports": "./lib/index.js",
     "type": "module",
     "sfdx": {
-        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-packaging/2.15.3.crt",
-        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-packaging/2.15.3.sig"
+        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-packaging/2.16.0.crt",
+        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-packaging/2.16.0.sig"
     }
 }