Add links to the web search in Develocity reports

For now it's not very useful given the query is just a list of CI runs
we found, but it might still help with debugging, and also if we build
the query differently in the future (e.g. match by PR tag + commit SHA).

Author: yrodiere

src/main/java/org/hibernate/infra/bot/ExtractDevelocityBuildScans.java

@@ -89,9 +89,10 @@ private void extractCIBuildScans(GHRepository repository, RepositoryConfig.Devel
 			}
 			long checkId = createDevelocityCheck( repository, sha );
 			Throwable failure = null;
+			String query = "";
 			List<DevelocityCIBuildScan> buildScans = new ArrayList<>();
 			try {
-				String query = createBuildScansQuery( checkRuns );
+				query = createBuildScansQuery( checkRuns );
 				for ( Build build : develocityBuildsApi.getBuilds( new BuildsQuery.BuildsQueryQueryParam()
 						.fromInstant( 0L )
 						.query( query )
@@ -122,7 +123,7 @@ private void extractCIBuildScans(GHRepository repository, RepositoryConfig.Devel
 			if ( failure != null ) {
 				Log.errorf( failure, "Failed to extract all build scans from commit %s" + sha );
 			}
-			updateDevelocityCheck( repository, config, checkId, buildScans, failure );
+			updateDevelocityCheck( repository, config, checkId, query, buildScans, failure );
 		}
 		catch (IOException | RuntimeException e) {
 			Log.errorf( e, "Failed to report build scans from commit %s" + sha );
@@ -249,11 +250,13 @@ private long createDevelocityCheck(GHRepository repository, String sha) throws I
 	}
 
 	private void updateDevelocityCheck(GHRepository repository, RepositoryConfig.Develocity.BuildScan config,
-			long checkId, List<DevelocityCIBuildScan> buildScans, Throwable failure)
+			long checkId, String query, List<DevelocityCIBuildScan> buildScans, Throwable failure)
 			throws IOException {
 		String formattedBuildScanList = "";
+		String footer = "";
 		try {
 			formattedBuildScanList = reportFormatter.summary( buildScans, config );
+			footer = reportFormatter.footer( query, false );
 		}
 		catch (RuntimeException e) {
 			if ( failure == null ) {
@@ -270,12 +273,18 @@ private void updateDevelocityCheck(GHRepository repository, RepositoryConfig.Dev
 		if ( failure == null ) {
 			conclusion = GHCheckRun.Conclusion.NEUTRAL;
 			title = "Found %s build scan%s".formatted( buildScans.size(), buildScans.size() != 1 ? "s" : "" );
-			text = formattedBuildScanList;
+			text = formattedBuildScanList + footer;
 		}
 		else {
 			conclusion = GHCheckRun.Conclusion.FAILURE;
 			title = "Develocity Build Scans extraction failed with exception";
-			text = formattedBuildScanList + "\n\n```\n" + ExceptionUtils.getStackTrace( failure ) + "\n```";
+			try {
+				footer = reportFormatter.footer( query, true );
+			}
+			catch (RuntimeException e) {
+				failure.addSuppressed( e );
+			}
+			text = formattedBuildScanList + "\n\n```\n" + ExceptionUtils.getStackTrace( failure ) + "\n```" + footer;
 		}
 
 		if ( deploymentConfig.isDryRun() ) {

src/main/java/org/hibernate/infra/bot/develocity/DevelocityReportFormatter.java

@@ -1,6 +1,9 @@
 package org.hibernate.infra.bot.develocity;
 
 import java.net.URI;
+import java.time.Clock;
+import java.time.temporal.ChronoUnit;
+import java.time.temporal.TemporalUnit;
 import java.util.Collection;
 import java.util.HashMap;
 import java.util.LinkedHashMap;
@@ -14,8 +17,10 @@
 import jakarta.enterprise.context.ApplicationScoped;
 import jakarta.ws.rs.core.UriBuilder;
 
+import org.hibernate.infra.bot.config.DeploymentConfig;
 import org.hibernate.infra.bot.config.RepositoryConfig;
 
+import io.quarkus.arc.Arc;
 import io.quarkus.qute.CheckedTemplate;
 import io.quarkus.qute.TemplateExtension;
 import io.quarkus.qute.TemplateInstance;
@@ -29,6 +34,11 @@ public String summary(List<DevelocityCIBuildScan> buildScans, RepositoryConfig.D
 				.render();
 	}
 
+	public String footer(String query, boolean debug) {
+		return Templates.footer( query, debug )
+				.render();
+	}
+
 	public record TagColumn(String name, Map<DevelocityCIBuildScan, Set<String>> content) {
 	}
 
@@ -85,6 +95,8 @@ private Collection<TagColumn> extractTagColumns(List<DevelocityCIBuildScan> buil
 	private static class Templates {
 		public static native TemplateInstance summary(List<DevelocityCIBuildScan> buildScans,
 				Collection<TagColumn> tagColumns);
+
+		public static native TemplateInstance footer(String query, boolean debug);
 	}
 
 	@TemplateExtension
@@ -143,4 +155,26 @@ static List<String> create(String... content) {
 			return List.of( content );
 		}
 	}
+
+	@TemplateExtension(namespace = "develocity")
+	@SuppressWarnings("unused")
+	private static class DevelocityTemplateExtensions {
+		static URI webSearchUri(String query) {
+			var config = Arc.container().instance( DeploymentConfig.class ).get();
+			var clock = Arc.container().instance( Clock.class ).get();
+			return UriBuilder.fromUri( config.develocity().uri() )
+					.path( "scans" )
+					.queryParam( "search.query", query )
+					// Make sure the query still works if new build scans are added
+					.queryParam( "search.startTimeMin", 1 )
+					.queryParam( "search.startTimeMax", clock.instant().plus( 365, ChronoUnit.DAYS ).toEpochMilli() )
+					.queryParam( "search.timeZoneId", "UTC" )
+					.build();
+		}
+
+		static String formatQuery(String query) {
+			return query.replace( "(", "(\n" )
+					.replace( ")", "\n)" );
+		}
+	}
 }

src/main/java/org/hibernate/infra/bot/util/ClockProducer.java

@@ -0,0 +1,19 @@
+package org.hibernate.infra.bot.util;
+
+import java.time.Clock;
+
+import io.quarkus.arc.Unremovable;
+import jakarta.enterprise.context.ApplicationScoped;
+import jakarta.enterprise.inject.Produces;
+
+@ApplicationScoped
+public class ClockProducer {
+
+    @Produces
+    @ApplicationScoped
+    @Unremovable
+    Clock clock() {
+        return Clock.systemUTC();
+    }
+
+}

src/main/resources/templates/DevelocityReportFormatter/footer.md

@@ -0,0 +1,11 @@
+
+
+Didn't find your build? Try [this search query]({develocity:webSearchUri(query)})
+{#if debug}
+
+Full query sent to Develocity:
+
+```
+{develocity:formatQuery(query)}
+```
+{/if}

src/test/java/org/hibernate/infra/bot/develocity/DevelocityReportFormatterTest.java

@@ -11,6 +11,10 @@
 import static org.assertj.core.api.Assertions.assertThat;
 
 import java.net.URI;
+import java.time.Clock;
+import java.time.Instant;
+import java.time.LocalDateTime;
+import java.time.ZoneOffset;
 import java.util.List;
 import java.util.Optional;
 
@@ -19,8 +23,10 @@
 import org.hibernate.infra.bot.config.RepositoryConfig;
 import org.hibernate.infra.bot.util.Patterns;
 
+import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
 
+import io.quarkus.test.junit.QuarkusMock;
 import io.quarkus.test.junit.QuarkusTest;
 
 @QuarkusTest
@@ -29,6 +35,13 @@ class DevelocityReportFormatterTest {
 	@Inject
 	DevelocityReportFormatter formatter;
 
+	@BeforeEach
+	void setup() {
+		Instant now = LocalDateTime.of( 2024, 10, 28, 0, 0 ).toInstant( ZoneOffset.UTC );
+		var clockMock = Clock.fixed( now, ZoneOffset.UTC );
+		QuarkusMock.installMockForType( clockMock, Clock.class );
+	}
+
 	@Test
 	void summary_simple() {
 		var buildScans = List.of(
@@ -254,4 +267,39 @@ private DevelocityCIBuildScan buildScanStub(String provider, String jobOrWorkflo
 				URI.create( "https://ge.hibernate.org/s/45fv2rr67ofuy/console-log" ) );
 	}
 
+	@Test
+	void footer_simple() {
+		assertThat( formatter.footer(
+				"(value:\"CI job=hibernate-orm-pipeline/PR-9171\" and value:\"CI build number=1\") or (value:\"CI run=11552691889\")",
+				false ) )
+				.isEqualTo(
+						"""
+
+
+								Didn't find your build? Try [this search query](https://ge.hibernate.org/scans?search.query=%28value%3A%22CI+job%3Dhibernate-orm-pipeline%2FPR-9171%22+and+value%3A%22CI+build+number%3D1%22%29+or+%28value%3A%22CI+run%3D11552691889%22%29&search.startTimeMin=1&search.startTimeMax=1761609600000&search.timeZoneId=UTC)
+								""" );
+	}
+
+	@Test
+	void footer_debug() {
+		assertThat( formatter.footer(
+				"(value:\"CI job=hibernate-orm-pipeline/PR-9171\" and value:\"CI build number=1\") or (value:\"CI run=11552691889\")",
+				true ) )
+				.isEqualTo(
+						"""
+
+
+								Didn't find your build? Try [this search query](https://ge.hibernate.org/scans?search.query=%28value%3A%22CI+job%3Dhibernate-orm-pipeline%2FPR-9171%22+and+value%3A%22CI+build+number%3D1%22%29+or+%28value%3A%22CI+run%3D11552691889%22%29&search.startTimeMin=1&search.startTimeMax=1761609600000&search.timeZoneId=UTC)
+
+								Full query sent to Develocity:
+
+								```
+								(
+								value:"CI job=hibernate-orm-pipeline/PR-9171" and value:"CI build number=1"
+								) or (
+								value:"CI run=11552691889"
+								)
+								```
+								""" );
+	}
 }