feat: add push migration flag

Author: btrn11

messages/package_pushupgrade_schedule.md

@@ -35,6 +35,14 @@ The filename of the .csv file that contains the list of orgs that need the packa
 
 Comma-separated list of subscriber org IDs that need the package upgrade.
 
+# flags.migrate-to-2gp.summary
+
+Indicates the push upgrade request is a migration from 1GP to 2GP.
+
+# flags.migrate-to-2gp.description
+
+Include this flag to specify that the push upgrade request represents a migration from a 1GP package to a 2GP package. The command must be run against the Dev Hub that owns the 2GP package.
+
 # error.invalid-package-version
 
 Invalid package version.
@@ -67,6 +75,9 @@ Either org list file or org list input must be supplied.
 - Schedule a push upgrade that initiates as soon as possible:
   <%= config.bin %> <%= command.id %> --package 04txyz --org-file upgrade-orgs.csv
 
+- Schedule a push migration from a 1GP package to a 2GP package:
+  <%= config.bin %> <%= command.id %> --migrate-to-2gp --package 04txyz --start-time "2024-12-06T21:00:00" --org-file upgrade-orgs.csv --target-dev-hub myHub
+
 # id
 
 ID
@@ -85,4 +96,4 @@ Package Version Id
 
 # output
 
-Push upgrade has been scheduled. To check the status of this push upgrade, use push upgrade request ID [%s] with either “package push-upgrade list” or “package push-upgrade report”.
+Push upgrade has been scheduled. To check the status of this push upgrade, use push upgrade request ID [%s] with either "package push-upgrade list" or "package push-upgrade report".

src/commands/package/pushupgrade/schedule.ts

@@ -48,6 +48,11 @@ export class PackagePushScheduleCommand extends SfCommand<PackagePushScheduleRes
       exists: true,
       exclusive: ['org-list'],
     }),
+    'migrate-to-2gp': Flags.boolean({
+      summary: messages.getMessage('flags.migrate-to-2gp.summary'),
+      description: messages.getMessage('flags.migrate-to-2gp.description'),
+      default: false,
+    }),
   };
 
   public async run(): Promise<PackagePushScheduleResult> {
@@ -71,17 +76,21 @@ export class PackagePushScheduleCommand extends SfCommand<PackagePushScheduleRes
     if (!startTime) {
       throw new SfError('Missing required flag: --start-time');
     }
-    
+    const isMigration = flags['migrate-to-2gp'];
+
     logger.debug(
-      `Scheduling push upgrade for package ${flags.package} with ${orgList.length} orgs, starting at ${startTime}.`
+      `Scheduling push ${isMigration ? 'migration' : 'upgrade'} for package ${flags.package} with ${
+        orgList.length
+      } orgs, starting at ${startTime}.`
     );
 
     // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-member-access
     const result: PackagePushScheduleResult = await PackagePushUpgrade.schedule(
       conn,
       flags.package,
       startTime,
-      orgList
+      orgList,
+      isMigration
     );
 
     // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access