feat: add --poll-interval flag for retrieve

Author: cristiand391

command-snapshot.json

@@ -291,6 +291,7 @@
       "metadata",
       "output-dir",
       "package-name",
+      "poll-interval",
       "single-package",
       "source-dir",
       "target-metadata-dir",

messages/retrieve.start.md

@@ -149,6 +149,10 @@ Extract all files from the retrieved zip file.
 
 File name to use for the retrieved zip file.
 
+# flags.poll-interval.summary
+
+Number of seconds to wait between status checks.
+
 # error.Conflicts
 
 There are changes in your local files that conflict with the org changes you're trying to retrieve.

src/commands/project/retrieve/start.ts

@@ -152,6 +152,13 @@ export default class RetrieveMetadata extends SfCommand<RetrieveResultJson> {
       exclusive: ['ignore-conflicts'],
       helpGroup: mdapiFlagGroup,
     }),
+    'poll-interval': Flags.duration({
+      min: Duration.milliseconds(500).seconds,
+      required: false,
+      helpValue: '<seconds>',
+      unit: 'seconds',
+      summary: messages.getMessage('flags.poll-interval.summary'),
+    }),
   };
 
   public static configurationVariablesSection = toHelpSection(
@@ -266,7 +273,7 @@ export default class RetrieveMetadata extends SfCommand<RetrieveResultJson> {
         throw error;
       });
 
-      this.retrieveResult = await retrieve.pollStatus(500, flags.wait.seconds);
+      this.retrieveResult = await retrieve.pollStatus(flags['poll-interval']?.milliseconds ?? 500, flags.wait.seconds);
     }
 
     this.ms.stop();