fix: update help text for all push upgrade commands

Author: btrn11

messages/package_pushupgrade_abort.md

@@ -1,6 +1,6 @@
 # summary
 
-Aborts a package push upgrade that has been scheduled. Only push upgrade requests with a Status of Created or Pending can be aborted.
+Abort a package push upgrade that has been scheduled. Only push upgrade requests with a status of Created or Pending can be aborted.
 
 # description
 
@@ -20,7 +20,7 @@ To show all requests in the org, run "<%= config.bin %> package pushupgrade list
 
 # flags.push-request-id.summary
 
-The ID of the package push request (starts with 0DV). This ID is returned after the package pushupgrade schedule command is run.
+ID of the package push request (starts with 0DV). This ID is returned after the package push-upgrade schedule command completes successfully.
 
 # flags.target-dev-hub.summary
 
@@ -32,15 +32,15 @@ Overrides the value of the target-dev-hub configuration variable, if set.
 
 # error.invalid-push-request-id-owner
 
---push-request-id 0DV... is not owned by the org from where the CLI command is run.
+Can’t abort package push upgrade request. The specified push upgrade ID is associated with a package in a different Dev Hub org. Retry this command in the context of the Dev Hub org that owns the package.
 
 # error.invalid-push-request-id
 
-Package push upgrade request id is invalid. Please use valid ID (starts with 0DV).
+Can’t abort package push upgrade request. The specified push upgrade ID isn’t valid. Check the ID (starts with 0DV) and retry the command.
 
 # error.invalid-push-request-status
 
-The status of the push request is one of the following: In Progress, Succeeded, Failed, Canceled. Only push requests in Created or Pending statuses can be aborted.
+Can’t abort package push upgrade request with status '${pushRequest.Status}'. Only push upgrade requests with a status of 'Created' or 'Pending' can be cancelled.
 
 # status
 

messages/package_pushupgrade_list.md

@@ -10,17 +10,17 @@ All filter parameters are applied using the AND logical operator (not OR).
 
 To get information about a specific request, run "sf package pushupgrade report" and supply the request ID.
 
-# flags.package-id.summary
+# flags.package.summary
 
-Specify the package ID (starts with 033) of the package that you want push upgrade information for.
+Package ID (starts with 033) of the package that you want push upgrade information for.
 
 # flags.scheduled-last-days.summary
 
-Filter the list output to only display push upgrades scheduled in the last few days. For example, if this flag is set to 30, only push upgrade requests scheduled for the last 30 days are listed in the output.
+Number of days in the past for which to display the list of push upgrade requests that were scheduled. Used to filter the list output to only recently scheduled push upgrades.
 
 # flags.status.summary
 
-Filter the list output by one of the following statuses: Created, Canceled, Pending, In Progress, Failed, or Succeeded
+Status used to filter the list output Valid values are: Created, Canceled, Pending, In Progress, Failed, or Succeeded
 
 # flags.verbose.summary
 
@@ -30,15 +30,19 @@ Displays additional information such as number of orgs scheduled for push upgrad
 
 - List all package push upgrade requests in the specified Dev Hub org:
 
-  sf package pushupgrade list --package 033xyz --target-dev-hub myHub
+  <%= config.bin %> <%= command.id %> --package 033xyz --target-dev-hub myHub
 
 - List all package push upgrade requests in the specified Dev Hub org scheduled in the last 30 days:
 
-  sf package pushupgrade list --package 033xyz --scheduled-last-days 30 --target-dev-hub myHub
+  <%= config.bin %> <%= command.id %> --package 033xyz --scheduled-last-days 30 --target-dev-hub myHub
 
-- List all package push upgrade with a status Succeeded:
+- List all package push upgrade with a status Success:
 
-  sf package pushupgrade list --package 033xyz –-Status=Succeeded
+  <%= config.bin %> <%= command.id %> --package 033xyz –-Status=Success
+
+- List all package push upgrade with a status Error:
+
+  <%= config.bin %> <%= command.id %> --package 033xyz –-Status=Error
 
 # id
 

messages/package_pushupgrade_report.md

@@ -20,7 +20,7 @@ To show all requests in the org, run "<%= config.bin %> package pushupgrade list
 
 # flags.push-request-id.summary
 
-The ID of the package push request (starts with 0DV). This ID is returned after the package pushupgrade schedule command is run.
+ID of the package push request (starts with 0DV). This ID is returned after the package push-upgrade schedule command completes successfully.
 
 # truncatedErrors
 

messages/package_pushupgrade_schedule.md

@@ -57,11 +57,11 @@ Either org list file or org list input must be supplied.
 
 # examples
 
-Schedule a push upgrade that initiates at a specified time:
-<%= config.bin %> <%= command.id %> --package 04txyz --start-time "2024-12-06T21:00:00" --org-file upgrade-orgs.csv
+- Schedule a push upgrade that initiates at a specified time:
+  <%= config.bin %> <%= command.id %> --package 04txyz --start-time "2024-12-06T21:00:00" --org-file upgrade-orgs.csv
 
-Schedule a push upgrade that initiates as soon as possible:
-<%= config.bin %> <%= command.id %> --package 04txyz --org-file upgrade-orgs.csv
+- Schedule a push upgrade that initiates as soon as possible:
+  <%= config.bin %> <%= command.id %> --package 04txyz --org-file upgrade-orgs.csv
 
 # id
 

src/commands/package/pushupgrade/list.ts

@@ -28,9 +28,9 @@ export class PackagePushRequestListCommand extends SfCommand<PackagePushRequestL
   public static readonly flags = {
     'target-dev-hub': requiredHubFlag,
     'api-version': orgApiVersionFlagWithDeprecations,
-    packageid: Flags.string({
+    package: Flags.string({
       char: 'p',
-      summary: messages.getMessage('flags.package-id.summary'),
+      summary: messages.getMessage('flags.package.summary'),
       required: true,
     }),
     'scheduled-last-days': Flags.integer({
@@ -63,7 +63,7 @@ export class PackagePushRequestListCommand extends SfCommand<PackagePushRequestL
     // Use const since we will add verbose later
     // eslint-disable-next-line @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-assignment
     const results: PackagePushRequestListResult[] = await PackagePushUpgrade.list(connection, {
-      packageId: flags.packageid,
+      packageId: flags.package,
       status: flags.status,
       scheduledLastDays,
     });