Add --no-cache global flag to bypass Drupal.org CDN caching (#325)

* Initial plan

* Add --no-cache global option to bypass Drupal.org HTTP caching

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

* Update src/Api/Client.php

Co-authored-by: Copilot <175728472+Copilot@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>
Co-authored-by: Matt Glaman <nmd.matt@gmail.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Author: 3 people

skills/drupalorg-cli/SKILL.md

@@ -154,11 +154,21 @@ drupalorg maintainer:release-notes <ref1> [ref2] [--format=json|md|html]
 ```bash
 # Install the drupalorg-cli agent skill into .claude/skills/drupalorg-cli/
 drupalorg skill:install
+```
+
+## Cache Bypass
+
+Drupal.org uses HTTP caching (CDN/Varnish). If you need fresh data — e.g. after a
+new comment was posted — pass `--no-cache` to any command:
 
-# Clear the local API cache
-drupalorg cache:clear
+```bash
+drupalorg issue:show <nid> --with-comments --format=llm --no-cache
+drupalorg mr:list [nid] --format=llm --no-cache
 ```
 
+`--no-cache` sends `Cache-Control: no-cache, no-store, must-revalidate` and
+`Pragma: no-cache` headers so the upstream CDN returns a fresh response.
+
 ## Error Handling
 
 | Error | Cause | Recovery |

src/Api/Client.php

@@ -22,7 +22,7 @@ class Client
      */
     public const API_URL = 'https://www.drupal.org/api-d7/';
 
-    public function __construct()
+    public function __construct(bool $noCache = false)
     {
         $stack = HandlerStack::create();
         $stack->push(GuzzleRetryMiddleware::factory([
@@ -31,16 +31,22 @@ public function __construct()
             'default_retry_multiplier' => 1.5,
         ]), 'retry');
 
+        $headers = [
+            'User-Agent' => 'DrupalOrgCli/0.0.1',
+            'Accept' => 'application/json',
+            'Accept-Encoding' => '*',
+        ];
+        if ($noCache) {
+            $headers['Cache-Control'] = 'no-cache, no-store, max-age=0';
+            $headers['Pragma'] = 'no-cache';
+        }
+
         $this->client = new \GuzzleHttp\Client(
             [
                 'base_uri' => self::API_URL,
                 'cookies' => true,
                 'handler' => $stack,
-                'headers' => [
-                    'User-Agent' => 'DrupalOrgCli/0.0.1',
-                    'Accept' => 'application/json',
-                    'Accept-Encoding' => '*',
-                ],
+                'headers' => $headers,
             ]
         );
     }

src/Cli/Application.php

@@ -4,6 +4,8 @@
 
 use Composer\InstalledVersions;
 use Symfony\Component\Console\Application as ParentApplication;
+use Symfony\Component\Console\Input\InputDefinition;
+use Symfony\Component\Console\Input\InputOption;
 
 class Application extends ParentApplication
 {
@@ -23,6 +25,18 @@ public function __construct()
         $this->addCommands($this->getCommands());
     }
 
+    protected function getDefaultInputDefinition(): InputDefinition
+    {
+        $definition = parent::getDefaultInputDefinition();
+        $definition->addOption(new InputOption(
+            'no-cache',
+            null,
+            InputOption::VALUE_NONE,
+            'Bypass Drupal.org HTTP caching and fetch a fresh response.'
+        ));
+        return $definition;
+    }
+
     /**
      * @return \Symfony\Component\Console\Command\Command[]
      */

src/Cli/Command/Command.php

@@ -45,7 +45,8 @@ protected function initialize(
         ) : $output;
         $this->stdIn = $input;
         self::$interactive = $input->isInteractive();
-        $this->client = new Client();
+        $noCache = $input->hasOption('no-cache') && (bool) $input->getOption('no-cache');
+        $this->client = new Client($noCache);
     }
 
     protected function debug(string $message): void