From a17b0b5a89a07a6d0fca8d137c8e72eac0fd7ca9 Mon Sep 17 00:00:00 2001
From: JakeSCahill <jake@redpanda.com>
Date: Fri, 23 Oct 2026 09:07:18 +0100
Subject: [PATCH 1/3] Stop gulp bundle hanging when antora.yml cannot be
 fetched

---
 compile-partial.js | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/compile-partial.js b/compile-partial.js
index 4a5b181e..dfc31416 100644
--- a/compile-partial.js
+++ b/compile-partial.js
@@ -22,8 +22,12 @@ if (fs.existsSync(helpersDir)) {
 function fetchRemoteAntoraVersion() {
   const url = 'https://raw.githubusercontent.com/redpanda-data/docs/main/antora.yml'
   return new Promise((resolve, reject) => {
-    https.get(url, res => {
+    // agent: false so no kept-alive socket holds the process open afterwards.
+    const req = https.get(url, { agent: false }, res => {
       if (res.statusCode !== 200) {
+        // Drain the response: an unread body keeps the socket, and the
+        // process, open, so the build hangs here (docs is private: 404).
+        res.resume()
         return reject(new Error(`Failed to fetch antora.yml: ${res.statusCode}`))
       }
       let body = ''
@@ -40,7 +44,9 @@ function fetchRemoteAntoraVersion() {
           reject(err)
         }
       })
-    }).on('error', reject)
+    })
+    req.on('error', reject)
+    req.setTimeout(10000, () => req.destroy(new Error('timed out after 10 s')))
   })
 }
 

From 38569c5354acce5fa815840dcfac48fa2a6dc61d Mon Sep 17 00:00:00 2001
From: JakeSCahill <jake@redpanda.com>
Date: Fri, 23 Oct 2026 09:18:57 +0100
Subject: [PATCH 2/3] Read the latest Redpanda version from the live docs site
 for the Bump widgets, and fail CI builds without one

---
 compile-partial.js | 45 ++++++++++++++++++++++++++-------------------
 1 file changed, 26 insertions(+), 19 deletions(-)

diff --git a/compile-partial.js b/compile-partial.js
index dfc31416..48c30535 100644
--- a/compile-partial.js
+++ b/compile-partial.js
@@ -2,7 +2,6 @@ const fs = require('fs');
 const path = require('path');
 const Handlebars = require('handlebars');
 const https = require('https');
-const yaml = require('js-yaml');
 
 const helpersDir = path.join(__dirname, 'src', 'helpers');
 if (fs.existsSync(helpersDir)) {
@@ -19,30 +18,31 @@ if (fs.existsSync(helpersDir)) {
   });
 }
 
-function fetchRemoteAntoraVersion() {
-  const url = 'https://raw.githubusercontent.com/redpanda-data/docs/main/antora.yml'
+// The latest Self-Managed version, as the live docs site states it in every
+// page's <meta name="latest-redpanda-version">. The site is public, so this
+// needs no token (redpanda-data/docs, which holds antora.yml, is private).
+const LATEST_VERSION_URL = 'https://docs.redpanda.com/home/'
+
+function fetchLatestVersion () {
   return new Promise((resolve, reject) => {
     // agent: false so no kept-alive socket holds the process open afterwards.
-    const req = https.get(url, { agent: false }, res => {
+    const req = https.get(LATEST_VERSION_URL, { agent: false }, (res) => {
       if (res.statusCode !== 200) {
         // Drain the response: an unread body keeps the socket, and the
-        // process, open, so the build hangs here (docs is private: 404).
+        // process, open, so the build would hang here.
         res.resume()
-        return reject(new Error(`Failed to fetch antora.yml: ${res.statusCode}`))
+        return reject(new Error(`${LATEST_VERSION_URL} returned ${res.statusCode}`))
       }
       let body = ''
-      res.on('data', chunk => (body += chunk))
+      res.setEncoding('utf8')
+      res.on('data', (chunk) => (body += chunk))
       res.on('end', () => {
-        try {
-          const cfg = yaml.load(body)
-          if (cfg.version == null) {
-            throw new Error('version field missing')
-          }
-          const version = String(cfg.version).trim()
-          resolve(version)
-        } catch (err) {
-          reject(err)
+        const match = /<meta\s+name="latest-redpanda-version"\s+content="([^"]*)"/i.exec(body)
+        const version = match && match[1].trim()
+        if (!version || !/^\d+\.\d+$/.test(version)) {
+          return reject(new Error(`no latest-redpanda-version meta tag in ${LATEST_VERSION_URL}`))
         }
+        resolve(version)
       })
     })
     req.on('error', reject)
@@ -128,13 +128,20 @@ async function ensureRootVersion(context) {
     return;
   }
 
-  // Fallback: remote fetch
+  // Fallback: the live docs site
   try {
-    const remoteVersion = await fetchRemoteAntoraVersion();
+    const remoteVersion = await fetchLatestVersion();
     rootComponent.latest = rootComponent.latest || {};
     rootComponent.latest.version = remoteVersion;
   } catch (err) {
-    console.warn(`⚠️ Could not fetch Antora version: ${err.message}`);
+    // Without a version the Bump widgets ship "Self-Managed v" as the search
+    // tag and an empty latest-redpanda-version meta tag, so a release build
+    // (CI) stops here. Locally it only warns, so the build works offline.
+    if (process.env.CI) {
+      console.error(`❌ Could not get the latest Redpanda version: ${err.message}. Set LATEST_ENTERPRISE to build without it.`);
+      process.exit(1);
+    }
+    console.warn(`⚠️ Could not get the latest Redpanda version: ${err.message}`);
   }
 }
 

From 01a8f5c60c43ca295daff58d206d9a3b94b7cdea Mon Sep 17 00:00:00 2001
From: JakeSCahill <jake@redpanda.com>
Date: Tue, 27 Oct 2026 10:28:02 +0000
Subject: [PATCH 3/3] Handle response stream errors and only fail the version
 lookup when CI is true

---
 compile-partial.js | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/compile-partial.js b/compile-partial.js
index 48c30535..51b49b68 100644
--- a/compile-partial.js
+++ b/compile-partial.js
@@ -35,6 +35,8 @@ function fetchLatestVersion () {
       }
       let body = ''
       res.setEncoding('utf8')
+      // A connection dropped mid-body errors on res, not req.
+      res.on('error', reject)
       res.on('data', (chunk) => (body += chunk))
       res.on('end', () => {
         const match = /<meta\s+name="latest-redpanda-version"\s+content="([^"]*)"/i.exec(body)
@@ -137,7 +139,7 @@ async function ensureRootVersion(context) {
     // Without a version the Bump widgets ship "Self-Managed v" as the search
     // tag and an empty latest-redpanda-version meta tag, so a release build
     // (CI) stops here. Locally it only warns, so the build works offline.
-    if (process.env.CI) {
+    if (process.env.CI === 'true') {
       console.error(`❌ Could not get the latest Redpanda version: ${err.message}. Set LATEST_ENTERPRISE to build without it.`);
       process.exit(1);
     }