address comments

Author: aknysh

website/plugins/fetch-latest-release/index.js

@@ -3,14 +3,16 @@ async function fetchLatestRelease() {
     'Accept': 'application/vnd.github.v3+json'
   };
 
-  // Use GitHub token if available to avoid rate limits
+  // Use GitHub token to avoid rate limits.
+  // In CI, GITHUB_TOKEN should always be available.
   const token = process.env.GITHUB_TOKEN || process.env.ATMOS_GITHUB_TOKEN;
   if (token) {
     headers['Authorization'] = `token ${token}`;
   }
 
   const controller = new AbortController();
-  const timeout = setTimeout(() => controller.abort(), 10000); // 10 second timeout
+  const timeout = setTimeout(() => controller.abort(), 30000); // 30 second timeout
+  const isDev = process.env.NODE_ENV !== 'production';
 
   try {
     const response = await fetch(`https://api.github.com/repos/cloudposse/atmos/releases/latest`, {
@@ -28,7 +30,26 @@ async function fetchLatestRelease() {
     const release = await response.json();
     return release.tag_name;
   } catch (error) {
-    console.error(`[fetch-latest-release] Failed to fetch latest release: ${error.message}`);
+    const errorCode = error.code || error.cause?.code;
+    let message = `Failed to fetch latest release: ${error.message}`;
+
+    if (errorCode === 'UND_ERR_CONNECT_TIMEOUT' || error.name === 'AbortError') {
+      message += '\nThis may be a network issue. Check your internet connection.';
+    } else if (errorCode === 'ENOTFOUND') {
+      message += '\nDNS resolution failed. Check your network configuration.';
+    } else if (!token) {
+      message += '\nConsider setting GITHUB_TOKEN to avoid rate limits.';
+    }
+
+    // In dev mode, use placeholder so local development isn't blocked.
+    // In production (CI/build), always fail to surface errors.
+    if (isDev) {
+      console.warn(`[fetch-latest-release] ${message}`);
+      console.warn(`[fetch-latest-release] Using placeholder 'latest' for development.`);
+      return 'latest';
+    }
+
+    console.error(`[fetch-latest-release] ${message}`);
     throw error;
   } finally {
     clearTimeout(timeout);