✨ Add fallback for loading version manifest from remote URL

.github/release-drafter.yml

@@ -30,7 +30,7 @@ categories:
       - "github-actions"
       - "pre-commit"
       - "submodules"
-change-template: "- $TITLE ([#$NUMBER]($URL)) ([**@$AUTHOR**](https://github.com/$AUTHOR))"
+change-template: "- $TITLE ([#$NUMBER]($URL)) (**@$AUTHOR**)"
 change-title-escapes: '\<*_&'
 version-resolver:
   major:

CHANGELOG.md

@@ -9,6 +9,13 @@ This project adheres to [Semantic Versioning], with the exception that minor rel
 
 ## [Unreleased]
 
+## [1.4.0] - 2026-06-10
+
+### Added
+
+- ✨ Add fallback for loading version manifest from remote URL ([#191]) ([**@denialhaag**])
+- ✨ Add support for new LLVM versions ([#189], [#190])
+
 ## [1.3.1] - 2026-05-18
 
 ### Added
@@ -82,7 +89,8 @@ _This is the initial release of the `setup-mlir` project._
 
 <!-- Version links -->
 
-[unreleased]: https://github.com/munich-quantum-software/setup-mlir/compare/v1.3.1...HEAD
+[unreleased]: https://github.com/munich-quantum-software/setup-mlir/compare/v1.4.0...HEAD
+[1.4.0]: https://github.com/munich-quantum-software/setup-mlir/releases/tag/v1.4.0
 [1.3.1]: https://github.com/munich-quantum-software/setup-mlir/releases/tag/v1.3.1
 [1.3.0]: https://github.com/munich-quantum-software/setup-mlir/releases/tag/v1.3.0
 [1.2.1]: https://github.com/munich-quantum-software/setup-mlir/releases/tag/v1.2.1
@@ -93,6 +101,9 @@ _This is the initial release of the `setup-mlir` project._
 
 <!-- PR links -->
 
+[#191]: https://github.com/munich-quantum-software/setup-mlir/pull/191
+[#190]: https://github.com/munich-quantum-software/setup-mlir/pull/190
+[#189]: https://github.com/munich-quantum-software/setup-mlir/pull/189
 [#177]: https://github.com/munich-quantum-software/setup-mlir/pull/177
 [#174]: https://github.com/munich-quantum-software/setup-mlir/pull/174
 [#171]: https://github.com/munich-quantum-software/setup-mlir/pull/171

__tests__/integration.test.ts

@@ -110,7 +110,7 @@ describe("setup-mlir Integration Tests", () => {
       await io.rmRF(cachedPath);
     }
     cachedPath = undefined;
-  }, 30000); // 30-second time-out for cleanup
+  }, 30000); // 30-second timeout for cleanup
 
   describe("Version Validation", () => {
     it("should validate version tag format", () => {
@@ -449,7 +449,7 @@ describe("setup-mlir Integration Tests", () => {
 
         cachedPath = cachedDir;
       }
-    }, 900000); // 15-minute time-out
+    }, 900000); // 15-minute timeout
 
     it("should reject debug flag on non-Windows platforms", async () => {
       if (process.platform === "win32") {

__tests__/update-known-versions.test.ts

@@ -148,5 +148,5 @@ describe("Update Known Versions", () => {
         "github.com/munich-quantum-software/portable-mlir-toolchain/releases/download",
       );
     }
-  }, 600000); // 10 minute timeout
+  }, 600000); // 10-minute timeout
 });

dist/index.js

@@ -34734,52 +34734,69 @@ function determineArchitecture() {
 
 
 
+
 /**
  * Get the manifest entry for the specified arguments
  * @param version The requested LLVM version
  * @param platform The platform
  * @param architecture The architecture
  * @param debug Whether to get a debug build
+ * @param forceRemote Whether to force loading the manifest from the remote URL
  * @returns The manifest entry
  */
-async function getManifestEntries(version, platform, architecture, debug) {
+async function getManifestEntries(version, platform, architecture, debug, forceRemote = false) {
     // Normalize inputs
     version = version.toLowerCase();
     platform = getPlatform(platform);
     architecture = getArchitecture(architecture);
-    const manifest = await loadManifest();
+    const manifest = await loadManifest(forceRemote);
     const entries = manifest.filter((entry) => entry.version.startsWith(version) &&
         entry.platform === platform &&
         entry.architecture === architecture &&
         entry.debug === debug);
+    if (entries.length === 0 && !forceRemote) {
+        core_debug(`No local manifest entries found for LLVM ${version}. Retrying with remote manifest.`);
+        return await getManifestEntries(version, platform, architecture, debug, true);
+    }
     if (entries.length === 0) {
         throw new Error(`No ${architecture} ${platform}${debug ? " (debug)" : ""} archive found for LLVM ${version}.`);
     }
     return entries;
 }
 /**
- * Load the manifest from the local file system or remote URL
+ * Load the manifest from the remote URL.
  * @returns The manifest entries
  */
-async function loadManifest() {
+async function loadManifestFromRemote() {
+    const actionRepo = process.env.GITHUB_ACTION_REPOSITORY ??
+        "munich-quantum-software/setup-mlir";
+    const actionRef = process.env.GITHUB_ACTION_REF ?? "main";
+    const manifestUrl = `https://raw.githubusercontent.com/${actionRepo}/${actionRef}/version-manifest.json`;
+    const response = await fetch(manifestUrl, {
+        redirect: "follow",
+        signal: AbortSignal.timeout(30000), // 30-second timeout
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to fetch version manifest from ${manifestUrl}: ${response.status} ${response.statusText}`);
+    }
+    return (await response.json());
+}
+/**
+ * Load the manifest. The manifest is loaded from file if possible, but falls back to the remote URL if the file is not found.
+ * @param forceRemote Whether to force loading the manifest from the remote URL
+ * @returns The manifest entries
+ */
+async function loadManifest(forceRemote = false) {
+    if (forceRemote) {
+        return await loadManifestFromRemote();
+    }
     try {
         const fileContent = await external_node_fs_namespaceObject.promises.readFile(MANIFEST_FILE, "utf-8");
         return JSON.parse(fileContent);
     }
     catch (error) {
         if (error instanceof Error && "code" in error && error.code === "ENOENT") {
-            const actionRepo = process.env.GITHUB_ACTION_REPOSITORY ??
-                "munich-quantum-software/setup-mlir";
-            const actionRef = process.env.GITHUB_ACTION_REF ?? "main";
-            const manifestUrl = `https://raw.githubusercontent.com/${actionRepo}/${actionRef}/version-manifest.json`;
-            const response = await fetch(manifestUrl, {
-                redirect: "follow",
-                signal: AbortSignal.timeout(30000), // 30 second timeout
-            });
-            if (!response.ok) {
-                throw new Error(`Failed to fetch version manifest from ${manifestUrl}: ${response.status} ${response.statusText}`);
-            }
-            return (await response.json());
+            return await loadManifestFromRemote();
         }
         throw error;
     }

src/utils/download.ts

@@ -16,9 +16,11 @@
  */
 
 import { promises as fs } from "node:fs";
-import { ManifestEntry } from "./manifest.js";
-import { MANIFEST_FILE } from "./constants.js";
 
+import * as core from "@actions/core";
+
+import { MANIFEST_FILE } from "./constants.js";
+import { ManifestEntry } from "./manifest.js";
 import { getPlatform, getArchitecture } from "./platform.js";
 
 /**
@@ -27,20 +29,22 @@ import { getPlatform, getArchitecture } from "./platform.js";
  * @param platform The platform
  * @param architecture The architecture
  * @param debug Whether to get a debug build
+ * @param forceRemote Whether to force loading the manifest from the remote URL
  * @returns The manifest entry
  */
 async function getManifestEntries(
   version: string,
   platform: string,
   architecture: string,
   debug: boolean,
+  forceRemote: boolean = false,
 ): Promise<ManifestEntry[]> {
   // Normalize inputs
   version = version.toLowerCase();
   platform = getPlatform(platform);
   architecture = getArchitecture(architecture);
 
-  const manifest = await loadManifest();
+  const manifest = await loadManifest(forceRemote);
 
   const entries = manifest.filter(
     (entry) =>
@@ -50,40 +54,69 @@ async function getManifestEntries(
       entry.debug === debug,
   );
 
+  if (entries.length === 0 && !forceRemote) {
+    core.debug(
+      `No local manifest entries found for LLVM ${version}. Retrying with remote manifest.`,
+    );
+    return await getManifestEntries(
+      version,
+      platform,
+      architecture,
+      debug,
+      true,
+    );
+  }
+
   if (entries.length === 0) {
     throw new Error(
       `No ${architecture} ${platform}${debug ? " (debug)" : ""} archive found for LLVM ${version}.`,
     );
   }
+
   return entries;
 }
 
 /**
- * Load the manifest from the local file system or remote URL
+ * Load the manifest from the remote URL.
  * @returns The manifest entries
  */
-async function loadManifest(): Promise<ManifestEntry[]> {
+async function loadManifestFromRemote(): Promise<ManifestEntry[]> {
+  const actionRepo =
+    process.env.GITHUB_ACTION_REPOSITORY ??
+    "munich-quantum-software/setup-mlir";
+  const actionRef = process.env.GITHUB_ACTION_REF ?? "main";
+  const manifestUrl = `https://raw.githubusercontent.com/${actionRepo}/${actionRef}/version-manifest.json`;
+
+  const response = await fetch(manifestUrl, {
+    redirect: "follow",
+    signal: AbortSignal.timeout(30000), // 30-second timeout
+  });
+  if (!response.ok) {
+    throw new Error(
+      `Failed to fetch version manifest from ${manifestUrl}: ${response.status} ${response.statusText}`,
+    );
+  }
+  return (await response.json()) as ManifestEntry[];
+}
+
+/**
+ * Load the manifest. The manifest is loaded from file if possible, but falls back to the remote URL if the file is not found.
+ * @param forceRemote Whether to force loading the manifest from the remote URL
+ * @returns The manifest entries
+ */
+async function loadManifest(
+  forceRemote: boolean = false,
+): Promise<ManifestEntry[]> {
+  if (forceRemote) {
+    return await loadManifestFromRemote();
+  }
+
   try {
     const fileContent = await fs.readFile(MANIFEST_FILE, "utf-8");
     return JSON.parse(fileContent) as ManifestEntry[];
   } catch (error) {
     if (error instanceof Error && "code" in error && error.code === "ENOENT") {
-      const actionRepo =
-        process.env.GITHUB_ACTION_REPOSITORY ??
-        "munich-quantum-software/setup-mlir";
-      const actionRef = process.env.GITHUB_ACTION_REF ?? "main";
-      const manifestUrl = `https://raw.githubusercontent.com/${actionRepo}/${actionRef}/version-manifest.json`;
-
-      const response = await fetch(manifestUrl, {
-        redirect: "follow",
-        signal: AbortSignal.timeout(30000), // 30 second timeout
-      });
-      if (!response.ok) {
-        throw new Error(
-          `Failed to fetch version manifest from ${manifestUrl}: ${response.status} ${response.statusText}`,
-        );
-      }
-      return (await response.json()) as ManifestEntry[];
+      return await loadManifestFromRemote();
     }
     throw error;
   }