issue:checkout: auto-setup missing remote instead of hard failing (#324)

* Initial plan

* feat: prompt user to set up remote when missing in issue:checkout

Co-authored-by: mglaman <3698644+mglaman@users.noreply.github.com>

* fix: cast ask() result to bool to satisfy PHPStan strict-rules

Co-authored-by: mglaman <3698644+mglaman@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: mglaman <3698644+mglaman@users.noreply.github.com>

Author: Copilot

src/Cli/Command/Issue/Checkout.php

@@ -3,10 +3,12 @@
 namespace mglaman\DrupalOrgCli\Command\Issue;
 
 use mglaman\DrupalOrg\Action\Issue\GetIssueForkAction;
+use mglaman\DrupalOrg\Action\Issue\SetupIssueRemoteAction;
 use mglaman\DrupalOrg\GitLab\Client as GitLabClient;
 use Symfony\Component\Console\Input\InputArgument;
 use Symfony\Component\Console\Input\InputInterface;
 use Symfony\Component\Console\Output\OutputInterface;
+use Symfony\Component\Console\Question\ConfirmationQuestion;
 use Symfony\Component\Process\Process;
 
 class Checkout extends IssueCommandBase
@@ -22,21 +24,52 @@ protected function configure(): void
 
     protected function execute(InputInterface $input, OutputInterface $output): int
     {
-        $action = new GetIssueForkAction($this->client, new GitLabClient());
+        $gitLabClient = new GitLabClient();
+        $action = new GetIssueForkAction($this->client, $gitLabClient);
         $fork = $action($this->nid);
 
-        // Verify the remote exists locally.
+        // Verify the remote exists locally; offer to set it up if missing.
         $checkRemote = new Process(['git', 'remote', 'get-url', $fork->remoteName]);
         $checkRemote->run();
         if (!$checkRemote->isSuccessful()) {
-            $this->stdErr->writeln(
-                sprintf(
-                    '<error>Remote %s does not exist. Run `issue:setup-remote %s` first.</error>',
-                    $fork->remoteName,
-                    $this->nid
-                )
+            $shouldSetup = true;
+            if (self::$interactive) {
+                /** @var \Symfony\Component\Console\Helper\QuestionHelper $helper */
+                $helper = $this->getHelper('question');
+                $question = new ConfirmationQuestion(
+                    sprintf(
+                        '<comment>Remote %s does not exist. Set it up now? [Y/n]</comment> ',
+                        $fork->remoteName
+                    ),
+                    true
+                );
+                // ask() returns mixed; cast to bool and fall back to the default (true) on null.
+                $shouldSetup = (bool) ($helper->ask($input, $output, $question) ?? true);
+            }
+            if (!$shouldSetup) {
+                $this->stdErr->writeln(
+                    sprintf(
+                        '<error>Remote %s does not exist. Run `issue:setup-remote %s` first.</error>',
+                        $fork->remoteName,
+                        $this->nid
+                    )
+                );
+                return 1;
+            }
+            try {
+                $setupAction = new SetupIssueRemoteAction($this->client, $gitLabClient);
+                $setupResult = $setupAction($this->nid);
+            } catch (\RuntimeException $e) {
+                $this->stdErr->writeln(
+                    sprintf('<error>Failed to set up remote: %s</error>', $e->getMessage())
+                );
+                return 1;
+            }
+            $this->stdOut->writeln(
+                sprintf('<info>Remote %s added and fetched.</info>', $setupResult->remoteName)
             );
-            return 1;
+            // Refresh fork data after setup so branches are populated.
+            $fork = $action($this->nid);
         }
 
         // Filter branches to those starting with the issue NID.