fix: download pinned laufey archives directly for CI prewarm

.github/workflows/ci.ts

@@ -1388,6 +1388,12 @@ const buildJobs = buildItems.map((rawBuildItem) => {
       }),
     });
     const testCrateNameExpr = testMatrix.test_crate;
+    // Desktop spec tests (part of the "specs" crate) launch a real GUI
+    // backend, which needs a display. Linux CI runners have no display, so
+    // run the test binary under a virtual X display via xvfb-run.
+    const cargoTestCmdPrefix = rawBuildItem.os === "linux"
+      ? "xvfb-run -a "
+      : "";
     const {
       restoreCacheStep,
       saveCacheStep,
@@ -1484,6 +1490,36 @@ const buildJobs = buildItems.map((rawBuildItem) => {
               '"$DENO_BIN" run -A ./tools/download_tsc.ts',
             ].join("\n"),
           },
+          {
+            name: "Set up native laufey cache",
+            if: testCrateNameExpr.equals("specs"),
+            uses: "actions/cache@v5",
+            with: {
+              // Keyed on laufey_sums.lock so a pinned-version bump re-downloads.
+              path: "./target/.native_laufey",
+              key:
+                "laufey-${{ runner.os }}-${{ runner.arch }}-${{ hashFiles('cli/laufey_sums.lock') }}",
+            },
+          },
+          {
+            // Warm the cache with the "laufey" desktop backend that `deno
+            // desktop` downloads (into the default target/.native_laufey) so
+            // the test step doesn't re-download the (100+ MB) archive for
+            // every test's fresh DENO_DIR. The harness resolves that path and
+            // injects DENO_LAUFEY_CACHE_DIR per-test itself (see
+            // test_util::native_laufey_cache_dir); no env export needed. Run
+            // it with the built deno binary (the test job has no system
+            // `deno` on PATH).
+            name: "Pre-download native laufey",
+            if: testCrateNameExpr.equals("specs"),
+            run: [
+              'DENO_BIN=""',
+              "for c in ./target/release/deno ./target/release/deno.exe ./target/debug/deno ./target/debug/deno.exe; do",
+              '  [ -f "$c" ] && DENO_BIN="$c" && break',
+              "done",
+              '"$DENO_BIN" run -A ./tools/download_laufey.ts',
+            ].join("\n"),
+          },
           {
             if: buildItem.os.equals("linux").and(
               buildItem.arch.equals("aarch64"),
@@ -1504,8 +1540,10 @@ const buildJobs = buildItems.map((rawBuildItem) => {
           {
             name: "Test (debug)",
             if: isDebug,
+            // Desktop spec tests launch a GUI backend, so run under a virtual
+            // X display on Linux where no real display is available.
             run:
-              `cargo test -p ${testMatrix.test_package} --test ${testMatrix.test_crate}`,
+              `${cargoTestCmdPrefix}cargo test -p ${testMatrix.test_package} --test ${testMatrix.test_crate}`,
             env: {
               CARGO_PROFILE_DEV_DEBUG: 0,
               CI_SHARD_INDEX: isPr.then(testMatrix.shard_index).else(""),
@@ -1518,7 +1556,7 @@ const buildJobs = buildItems.map((rawBuildItem) => {
               isDenoland.or(buildItem.use_sysroot),
             ),
             run:
-              `cargo test -p ${testMatrix.test_package} --test ${testMatrix.test_crate} --release`,
+              `${cargoTestCmdPrefix}cargo test -p ${testMatrix.test_package} --test ${testMatrix.test_crate} --release`,
             env: {
               CI_SHARD_INDEX: isPr.then(testMatrix.shard_index).else(""),
               CI_SHARD_TOTAL: isPr.then(testMatrix.shard_total).else(""),

Cargo.toml

@@ -309,6 +309,7 @@ serde = { version = "1.0.149", features = ["derive"] }
 serde_bytes = "0.11"
 serde_json = { version = "1.0.85", features = ["raw_value"] }
 serde_repr = "=0.1.19"
+shell-words = "1.1.0"
 shlex = "1.3.0"
 signal-hook = "0.3"
 slab = "0.4"

cli/Cargo.toml

@@ -178,6 +178,7 @@ same-file.workspace = true
 serde.workspace = true
 serde_repr.workspace = true
 sha2.workspace = true
+shell-words.workspace = true
 shlex.workspace = true
 spki = { workspace = true, features = ["pem"] }
 strsim.workspace = true

cli/schemas/config-file.v1.json

@@ -193,6 +193,21 @@
           "description": "Backend to use for the desktop app.",
           "enum": ["webview", "cef"]
         },
+        "backendArgs": {
+          "type": "object",
+          "description": "Optional backend-specific arguments.",
+          "additionalProperties": false,
+          "properties": {
+            "cef": {
+              "type": "string",
+              "description": "Optional argument for the CEF backend."
+            },
+            "webview": {
+              "type": "string",
+              "description": "Optional argument for the webview backend."
+            }
+          }
+        },
         "output": {
           "type": "object",
           "description": "Platform-specific output paths.",