Retry transient cold Forge bootstrap downloads

Author: SkyBlade1978

.github/workflows/ci.yml

@@ -39,14 +39,31 @@ jobs:
           set -euo pipefail
           test ! -e .gradle
           test ! -e "$GRADLE_USER_HOME"
-          mkdir -p "$GRADLE_USER_HOME"
           chmod +x ./gradlew
-          ./gradlew verifyMavenizerCompatibilityFixture help \
-            --no-daemon --no-build-cache --stacktrace --max-workers=2 \
-            -Dorg.gradle.java.installations.paths="$JAVA_HOME" \
-            -Dorg.gradle.java.installations.auto-detect=false \
-            -Dorg.gradle.java.installations.auto-download=false \
-            | tee "$RUNNER_TEMP/cold-forge-bootstrap.log"
+          gradle_args=(
+            verifyMavenizerCompatibilityFixture help
+            --no-daemon --no-build-cache --stacktrace --max-workers=2
+            "-Dorg.gradle.java.installations.paths=$JAVA_HOME"
+            -Dorg.gradle.java.installations.auto-detect=false
+            -Dorg.gradle.java.installations.auto-download=false
+          )
+          for attempt in 1 2 3; do
+            if (( attempt > 1 )); then
+              echo "Retrying the cold Forge bootstrap after transient download failure ($attempt/3)"
+              rm -rf -- "$GRADLE_USER_HOME/caches/minecraftforge" .gradle/mavenizer
+              sleep "$((attempt * 5))"
+            fi
+            mkdir -p "$GRADLE_USER_HOME"
+            attempt_log="$RUNNER_TEMP/cold-forge-bootstrap-attempt-$attempt.log"
+            if ./gradlew "${gradle_args[@]}" 2>&1 | tee "$attempt_log"; then
+              cp "$attempt_log" "$RUNNER_TEMP/cold-forge-bootstrap.log"
+              break
+            fi
+            if (( attempt == 3 )); then
+              echo "Cold Forge bootstrap failed after $attempt attempts" >&2
+              exit 1
+            fi
+          done
           grep -F "OreSpawn Mavenizer compatibility runtime: Java 25.0.3" \
             "$RUNNER_TEMP/cold-forge-bootstrap.log"
           grep -F "OreSpawn Mavenizer compatibility: applied 0 rule(s) for net.minecraftforge:forge:26.1.2-64.0.9 (explicit no-op)" \

src/test/java/zone/moddev/mc/orespawn/ReleaseWorkflowContractTest.java

@@ -90,6 +90,17 @@ void codeQlUsesABoundedCachePreservingCompileRetry() throws Exception {
 				"CodeQL retries must preserve exact Gradle arguments");
 		assertTrue(text.contains("failed after $attempt attempts"),
 				"CodeQL must fail rather than hide a persistent bootstrap defect");
+
+		String ci = new String(Files.readAllBytes(
+				Paths.get(".github", "workflows", "ci.yml")), StandardCharsets.UTF_8);
+		assertTrue(ci.contains("gradle_args=("),
+				"the cold Forge bootstrap must pass Gradle options as an argument vector");
+		assertTrue(ci.contains("for attempt in 1 2 3; do"),
+				"the cold Forge bootstrap must bound transient Mavenizer download retries");
+		assertTrue(ci.contains("./gradlew \"${gradle_args[@]}\""),
+				"cold-bootstrap retries must preserve exact Gradle arguments");
+		assertTrue(ci.contains("Cold Forge bootstrap failed after $attempt attempts"),
+				"the cold bootstrap must fail rather than hide a persistent download defect");
 	}
 
 	private static int occurrences(String text, String needle) {