Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Bump GE API spec version to 2024.1 #172

Merged
merged 8 commits into from
Apr 4, 2024
Merged

Conversation

github-actions[bot]
Copy link
Contributor

@github-actions github-actions bot commented Apr 2, 2024

  • Bump API spec version to 2024.0
  • Bump library version to 2024.1.0 (next release)
  • Expose new AuthApi from library
  • Speed up integration test execution by requesting less builds

@gabrielfeo gabrielfeo closed this Apr 2, 2024
@gabrielfeo gabrielfeo reopened this Apr 2, 2024
Copy link
Contributor Author

github-actions bot commented Apr 2, 2024

Generated API diff

diff -ur ./base-ref-api/.openapi-generator/FILES ./pr-ref-api/.openapi-generator/FILES
--- ./base-ref-api/.openapi-generator/FILES	2024-04-04 23:30:19.953086484 +0000
+++ ./pr-ref-api/.openapi-generator/FILES	2024-04-04 23:30:06.885130033 +0000
@@ -1,3 +1,4 @@
+src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/AuthApi.kt
 src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/BuildCacheApi.kt
 src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/BuildsApi.kt
 src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/MetaApi.kt
@@ -25,8 +26,10 @@
 src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildModelName.kt
 src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildModelQuery.kt
 src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildModels.kt
+src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildModelsGradleArtifactTransformExecutions.kt
 src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildModelsGradleAttributes.kt
 src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildModelsGradleBuildCachePerformance.kt
+src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildModelsGradleDeprecations.kt
 src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildModelsGradleNetworkActivity.kt
 src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildModelsGradleProjects.kt
 src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildModelsMavenAttributes.kt
@@ -37,6 +40,9 @@
 src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildScanIdsByOutcome.kt
 src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildsQuery.kt
 src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/DevelocityVersion.kt
+src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/GradleArtifactTransformAttribute.kt
+src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/GradleArtifactTransformExecutionEntry.kt
+src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/GradleArtifactTransformExecutions.kt
 src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/GradleAttributes.kt
 src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/GradleBuildCachePerformance.kt
 src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/GradleBuildCachePerformanceAvoidanceSavingsSummary.kt
@@ -50,6 +56,10 @@
 src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/GradleBuildCachePerformanceWorkUnitAvoidanceSavingsSummary.kt
 src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/GradleBuildCachePerformanceWorkUnitFingerprintingSummary.kt
 src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/GradleBuildOptions.kt
+src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/GradleDeprecationEntry.kt
+src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/GradleDeprecationOwner.kt
+src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/GradleDeprecationUsage.kt
+src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/GradleDeprecations.kt
 src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/GradleDevelocitySettings.kt
 src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/GradleEnterpriseVersion.kt
 src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/GradleGradleEnterpriseSettings.kt
@@ -86,6 +96,10 @@
 src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/TestDistributionAgentPoolConfiguration.kt
 src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/TestDistributionAgentPoolConfigurationWithId.kt
 src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/TestDistributionAgentPoolPage.kt
+src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/TestDistributionAgentPoolRegistrationKey.kt
+src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/TestDistributionAgentPoolRegistrationKeyDescription.kt
+src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/TestDistributionAgentPoolRegistrationKeyPrefix.kt
+src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/TestDistributionAgentPoolRegistrationKeyPrefixPage.kt
 src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/TestDistributionAgentPoolStatus.kt
 src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/TestDistributionApiKey.kt
 src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/TestDistributionApiKeyDescription.kt
Only in ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api: AuthApi.kt
diff -ur ./base-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/BuildsApi.kt ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/BuildsApi.kt
--- ./base-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/BuildsApi.kt	2024-04-04 23:30:19.957086474 +0000
+++ ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/BuildsApi.kt	2024-04-04 23:30:06.889130024 +0000
@@ -11,10 +11,10 @@
 @JvmSuppressWildcards
 interface BuildsApi {
     /**
-     * Get the common attributes of a Build Scan.
+     * Get the common attributes of a build.
      * The contained attributes are build tool agnostic.
      * Responses:
-     *  - 200: The common attributes of a Build Scan.
+     *  - 200: The common attributes of a build.
      *  - 400: The request cannot be fulfilled due to a problem.
      *  - 404: The referenced resource either does not exist or the permissions to know about it are missing.
      *  - 500: The server encountered an unexpected error.
@@ -22,17 +22,18 @@
      *
      * @param id The Build Scan ID.
      * @param models The list of build models to return in the response for each build. If not provided, no models are returned.  (optional)
+     * @param allModels Whether to include all build models for the build. If set to `true`, the value of the `models` parameter is ignored.  (optional, default to false)
      * @param availabilityWaitTimeoutSecs The time in seconds the server should wait for ingestion before returning a wait timeout response. (optional)
      * @return [Build]
      */
     @GET("api/builds/{id}")
-    suspend fun getBuild(@Path("id") id: kotlin.String, @Query("models") models: kotlin.collections.List<BuildModelName>? = null, @Query("availabilityWaitTimeoutSecs") availabilityWaitTimeoutSecs: kotlin.Int? = null): Build
+    suspend fun getBuild(@Path("id") id: kotlin.String, @Query("models") models: kotlin.collections.List<BuildModelName>? = null, @Query("allModels") allModels: kotlin.Boolean? = false, @Query("availabilityWaitTimeoutSecs") availabilityWaitTimeoutSecs: kotlin.Int? = null): Build
 
     /**
-     * Get a list of builds with the common attributes of a Build Scan.
+     * Get a list of builds with common attributes.
      * The contained attributes are build tool agnostic. If none of &#x60;fromInstant&#x60;, &#x60;fromBuild&#x60;, or &#x60;reverse&#x60; is used, when making a request to this endpoint, it will return builds that were received and processed by Develocity after the request was made. 
      * Responses:
-     *  - 200: A list of builds with the common attributes of a Build Scan.
+     *  - 200: A list of builds with common attributes.
      *  - 400: The request cannot be fulfilled due to a problem.
      *  - 404: The referenced resource either does not exist or the permissions to know about it are missing.
      *  - 500: The server encountered an unexpected error.
@@ -45,18 +46,36 @@
      * @param reverse A boolean indicating the time direction of the query. A value of &#x60;true&#x60; indicates a backward query, and returned builds will be sorted from most to least recent. A value of &#x60;false&#x60; indicates a forward query, and returned builds will be sorted from least to most recent. This parameter has no effect if any of &#x60;since&#x60;, &#x60;sinceBuild&#x60; are used. If not provided, the default value is &#x60;false&#x60;.  (optional)
      * @param maxBuilds The maximum number of builds returned by the query. The query returns when that number is reached or when &#x60;maxWaitSecs&#x60; is reached. If not provided, the default value is &#x60;100&#x60;.  (optional)
      * @param maxWaitSecs The maximum number of seconds to wait for builds before returning. If this time is reached before &#x60;maxBuilds&#x60; is reached, the query returns with the already processed builds. Note that this time is respected with best effort. A query will return soon after this time has passed but there is no guarantee that it exactly returns before this time has passed. This parameter has no effect if &#x60;reverse&#x3D;true&#x60; is specified, because new builds cannot become available in the past. If not provided, the default value is &#x60;3&#x60;.  (optional)
-     * @param query A query for filtering builds, written in the Develocity advanced search query language See: https://gradle.com/help/enterprise-advanced-search  (optional)
+     * @param query A query for filtering builds, written in the Develocity advanced search query language See: https://gradle.com/help/advanced-search  (optional)
      * @param models The list of build models to return in the response for each build. If not provided, no models are returned.  (optional)
+     * @param allModels Whether to include all build models for each build. If set to &#x60;true&#x60;, the value of the &#x60;models&#x60; parameter is ignored.  (optional, default to false)
      * @return [kotlin.collections.List<Build>]
      */
     @GET("api/builds")
-    suspend fun getBuilds(@Query("since") since: kotlin.Long? = null, @Query("sinceBuild") sinceBuild: kotlin.String? = null, @Query("fromInstant") fromInstant: kotlin.Long? = null, @Query("fromBuild") fromBuild: kotlin.String? = null, @Query("reverse") reverse: kotlin.Boolean? = null, @Query("maxBuilds") maxBuilds: kotlin.Int? = null, @Query("maxWaitSecs") maxWaitSecs: kotlin.Int? = null, @Query("query") query: kotlin.String? = null, @Query("models") models: kotlin.collections.List<BuildModelName>? = null): kotlin.collections.List<Build>
+    suspend fun getBuilds(@Query("since") since: kotlin.Long? = null, @Query("sinceBuild") sinceBuild: kotlin.String? = null, @Query("fromInstant") fromInstant: kotlin.Long? = null, @Query("fromBuild") fromBuild: kotlin.String? = null, @Query("reverse") reverse: kotlin.Boolean? = null, @Query("maxBuilds") maxBuilds: kotlin.Int? = null, @Query("maxWaitSecs") maxWaitSecs: kotlin.Int? = null, @Query("query") query: kotlin.String? = null, @Query("models") models: kotlin.collections.List<BuildModelName>? = null, @Query("allModels") allModels: kotlin.Boolean? = false): kotlin.collections.List<Build>
 
     /**
-     * Get the attributes of a Gradle Build Scan.
+     * Get the artifact transform execution list of a Gradle build.
      * This model is Gradle specific and cannot be requested for another build tool.
      * Responses:
-     *  - 200: The attributes of a Gradle Build Scan.
+     *  - 200: The artifact transform execution list of a Gradle build.
+     *  - 400: The request cannot be fulfilled due to a problem.
+     *  - 404: The referenced resource either does not exist or the permissions to know about it are missing.
+     *  - 500: The server encountered an unexpected error.
+     *  - 503: The server is not ready to handle the request.
+     *
+     * @param id The Build Scan ID.
+     * @param availabilityWaitTimeoutSecs The time in seconds the server should wait for ingestion before returning a wait timeout response. (optional)
+     * @return [GradleArtifactTransformExecutions]
+     */
+    @GET("api/builds/{id}/gradle-artifact-transform-executions")
+    suspend fun getGradleArtifactTransformExecutions(@Path("id") id: kotlin.String, @Query("availabilityWaitTimeoutSecs") availabilityWaitTimeoutSecs: kotlin.Int? = null): GradleArtifactTransformExecutions
+
+    /**
+     * Get the attributes of a Gradle build.
+     * This model is Gradle specific and cannot be requested for another build tool.
+     * Responses:
+     *  - 200: The attributes of a Gradle build.
      *  - 400: The request cannot be fulfilled due to a problem.
      *  - 404: The referenced resource either does not exist or the permissions to know about it are missing.
      *  - 500: The server encountered an unexpected error.
@@ -70,10 +89,10 @@
     suspend fun getGradleAttributes(@Path("id") id: kotlin.String, @Query("availabilityWaitTimeoutSecs") availabilityWaitTimeoutSecs: kotlin.Int? = null): GradleAttributes
 
     /**
-     * Get the build cache performance of a Gradle Build Scan.
+     * Get the build cache performance of a Gradle build.
      * This model is Gradle specific and cannot be requested for another build tool.
      * Responses:
-     *  - 200: The build cache performance of a Gradle Build Scan.
+     *  - 200: The build cache performance of a Gradle build.
      *  - 400: The request cannot be fulfilled due to a problem.
      *  - 404: The referenced resource either does not exist or the permissions to know about it are missing.
      *  - 500: The server encountered an unexpected error.
@@ -87,10 +106,27 @@
     suspend fun getGradleBuildCachePerformance(@Path("id") id: kotlin.String, @Query("availabilityWaitTimeoutSecs") availabilityWaitTimeoutSecs: kotlin.Int? = null): GradleBuildCachePerformance
 
     /**
-     * Get the network activity of a Gradle Build Scan.
+     * Get the Gradle Build Tool deprecations of a Gradle build.
+     * This model is Gradle specific and cannot be requested for another build tool.
+     * Responses:
+     *  - 200: The deprecation list of a Gradle build.
+     *  - 400: The request cannot be fulfilled due to a problem.
+     *  - 404: The referenced resource either does not exist or the permissions to know about it are missing.
+     *  - 500: The server encountered an unexpected error.
+     *  - 503: The server is not ready to handle the request.
+     *
+     * @param id The Build Scan ID.
+     * @param availabilityWaitTimeoutSecs The time in seconds the server should wait for ingestion before returning a wait timeout response. (optional)
+     * @return [GradleDeprecations]
+     */
+    @GET("api/builds/{id}/gradle-deprecations")
+    suspend fun getGradleDeprecations(@Path("id") id: kotlin.String, @Query("availabilityWaitTimeoutSecs") availabilityWaitTimeoutSecs: kotlin.Int? = null): GradleDeprecations
+
+    /**
+     * Get the network activity of a Gradle build.
      * This model is Gradle specific and cannot be requested for another build tool. This model is only available starting with Gradle version 3.5 and Develocity Gradle Plugin version 1.6.
      * Responses:
-     *  - 200: The network activity of a Gradle Build Scan.
+     *  - 200: The network activity of a Gradle build.
      *  - 400: The request cannot be fulfilled due to a problem.
      *  - 404: The referenced resource either does not exist or the permissions to know about it are missing.
      *  - 500: The server encountered an unexpected error.
@@ -104,10 +140,10 @@
     suspend fun getGradleNetworkActivity(@Path("id") id: kotlin.String, @Query("availabilityWaitTimeoutSecs") availabilityWaitTimeoutSecs: kotlin.Int? = null): GradleNetworkActivity
 
     /**
-     * Get the projects of a Gradle Build Scan.
+     * Get the projects of a Gradle build.
      * This model is Gradle specific and cannot be requested for another build tool.
      * Responses:
-     *  - 200: The projects of a Gradle Build Scan.
+     *  - 200: The projects of a Gradle build.
      *  - 400: The request cannot be fulfilled due to a problem.
      *  - 404: The referenced resource either does not exist or the permissions to know about it are missing.
      *  - 500: The server encountered an unexpected error.
@@ -121,10 +157,10 @@
     suspend fun getGradleProjects(@Path("id") id: kotlin.String, @Query("availabilityWaitTimeoutSecs") availabilityWaitTimeoutSecs: kotlin.Int? = null): kotlin.collections.List<GradleProject>
 
     /**
-     * Get the attributes of a Maven Build Scan.
+     * Get the attributes of a Maven build.
      * This model is Maven specific and cannot be requested for another build tool.
      * Responses:
-     *  - 200: The attributes of a Maven Build Scan.
+     *  - 200: The attributes of a Maven build.
      *  - 400: The request cannot be fulfilled due to a problem.
      *  - 404: The referenced resource either does not exist or the permissions to know about it are missing.
      *  - 500: The server encountered an unexpected error.
@@ -138,10 +174,10 @@
     suspend fun getMavenAttributes(@Path("id") id: kotlin.String, @Query("availabilityWaitTimeoutSecs") availabilityWaitTimeoutSecs: kotlin.Int? = null): MavenAttributes
 
     /**
-     * Get the build cache performance of a Maven Build Scan.
+     * Get the build cache performance of a Maven build.
      * This model is Maven specific and cannot be requested for another build tool.
      * Responses:
-     *  - 200: The build cache performance of a Maven Build Scan.
+     *  - 200: The build cache performance of a Maven build.
      *  - 400: The request cannot be fulfilled due to a problem.
      *  - 404: The referenced resource either does not exist or the permissions to know about it are missing.
      *  - 500: The server encountered an unexpected error.
@@ -155,10 +191,10 @@
     suspend fun getMavenBuildCachePerformance(@Path("id") id: kotlin.String, @Query("availabilityWaitTimeoutSecs") availabilityWaitTimeoutSecs: kotlin.Int? = null): MavenBuildCachePerformance
 
     /**
-     * Get information about the dependency resolution of a Maven Build Scan.
+     * Get information about the dependency resolution of a Maven build.
      * This model is Maven specific and cannot be requested for another build tool.  This model is only available starting with the Develocity Maven Extension version 1.9.
      * Responses:
-     *  - 200: Information about the dependency resolution of a Maven Build Scan.
+     *  - 200: Information about the dependency resolution of a Maven build.
      *  - 400: The request cannot be fulfilled due to a problem.
      *  - 404: The referenced resource either does not exist or the permissions to know about it are missing.
      *  - 500: The server encountered an unexpected error.
@@ -172,10 +208,10 @@
     suspend fun getMavenDependencyResolution(@Path("id") id: kotlin.String, @Query("availabilityWaitTimeoutSecs") availabilityWaitTimeoutSecs: kotlin.Int? = null): MavenDependencyResolution
 
     /**
-     * Get the modules of a Maven Build Scan.
+     * Get the modules of a Maven build.
      * This model is Maven specific and cannot be requested for another build tool.
      * Responses:
-     *  - 200: The modules of a Maven Build Scan.
+     *  - 200: The modules of a Maven build.
      *  - 400: The request cannot be fulfilled due to a problem.
      *  - 404: The referenced resource either does not exist or the permissions to know about it are missing.
      *  - 500: The server encountered an unexpected error.
diff -ur ./base-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/ProjectsApi.kt ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/ProjectsApi.kt
--- ./base-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/ProjectsApi.kt	2024-04-04 23:30:19.965086454 +0000
+++ ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/ProjectsApi.kt	2024-04-04 23:30:06.901129997 +0000
@@ -17,7 +17,7 @@
      *  - 200: The project was created or it was updated successfully.
      *  - 400: The request body is malformed or contains invalid values for at least one of the properties.
      *  - 403: The authenticated user has insufficient permissions.
-     *  - 404: No API key was specified in the request, the key has been revoked or the user bearing the key lacks permissions for this operation.
+     *  - 404: No API key was specified in the request, the key has been revoked, or the user bearing the key lacks permissions for this operation.
      *
      * @param projectId The ID of the project.
      * @param project 
@@ -33,7 +33,7 @@
      *  - 200: The project group was created or it was updated successfully.
      *  - 400: The request body is malformed or contains invalid values for at least one of the properties.
      *  - 403: The authenticated user has insufficient permissions.
-     *  - 404: No API key was specified in the request, the key has been revoked or the user bearing the key lacks permissions for this operation.
+     *  - 404: No API key was specified in the request, the key has been revoked, or the user bearing the key lacks permissions for this operation.
      *
      * @param projectGroupId The ID of the project group.
      * @param projectGroup 
@@ -48,7 +48,7 @@
      * Responses:
      *  - 200: The projectId referenced an existing project group and it was deleted.
      *  - 403: The authenticated user has insufficient permissions.
-     *  - 404: No API key was specified in the request, the key has been revoked or the user bearing the key lacks permissions for this operation.
+     *  - 404: No API key was specified in the request, the key has been revoked, or the user bearing the key lacks permissions for this operation.
      *
      * @param projectGroupId The ID of the project group.
      * @return [Unit]
@@ -62,7 +62,7 @@
      * Responses:
      *  - 200: The requested project.
      *  - 403: The authenticated user has insufficient permissions.
-     *  - 404: No API key was specified in the request, the key has been revoked or the user bearing the key lacks permissions for this operation.
+     *  - 404: No API key was specified in the request, the key has been revoked, or the user bearing the key lacks permissions for this operation.
      *
      * @param projectId The ID of the project.
      * @return [Project]
@@ -76,7 +76,7 @@
      * Responses:
      *  - 200: The requested project group.
      *  - 403: The authenticated user has insufficient permissions.
-     *  - 404: No API key was specified in the request, the key has been revoked or the user bearing the key lacks permissions for this operation.
+     *  - 404: No API key was specified in the request, the key has been revoked, or the user bearing the key lacks permissions for this operation.
      *
      * @param projectGroupId The ID of the project group.
      * @return [ProjectGroup]
@@ -90,7 +90,7 @@
      * Responses:
      *  - 200: A list of project groups.
      *  - 403: The authenticated user has insufficient permissions.
-     *  - 404: No API key was specified in the request, the key has been revoked or the user bearing the key lacks permissions for this operation.
+     *  - 404: No API key was specified in the request, the key has been revoked, or the user bearing the key lacks permissions for this operation.
      *
      * @param pageNumber The index of the page to retrieve. The first page&#39;s index is zero.  (optional, default to 0)
      * @param pageSize The maximum number of elements to include in the fetched page. (optional)
@@ -105,7 +105,7 @@
      * Responses:
      *  - 200: A list of projects known to Develocity.
      *  - 403: The authenticated user has insufficient permissions.
-     *  - 404: No API key was specified in the request, the key has been revoked or the user bearing the key lacks permissions for this operation.
+     *  - 404: No API key was specified in the request, the key has been revoked, or the user bearing the key lacks permissions for this operation.
      *
      * @param pageNumber The index of the page to retrieve. The first page&#39;s index is zero.  (optional, default to 0)
      * @param pageSize The maximum number of elements to include in the fetched page. (optional)
diff -ur ./base-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/TestDistributionApi.kt ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/TestDistributionApi.kt
--- ./base-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/TestDistributionApi.kt	2024-04-04 23:30:19.965086454 +0000
+++ ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/TestDistributionApi.kt	2024-04-04 23:30:06.901129997 +0000
@@ -17,7 +17,7 @@
      *  - 200: The Agent Pool was created or its configuration was updated successfully.
      *  - 400: The request body is malformed or contains invalid values for at least one of the properties.
      *  - 403: The authenticated user has insufficient permissions.
-     *  - 404: No API key was specified in the request, the key has been revoked or the user bearing the key lacks permissions for this operation.
+     *  - 404: No API key was specified in the request, the key has been revoked, or the user bearing the key lacks permissions for this operation.
      *
      * @param poolId The ID of the pool to view.
      * @param testDistributionAgentPoolConfiguration 
@@ -33,7 +33,7 @@
      *  - 200: A new Agent Pool was created with the configuration specified in the request.
      *  - 400: The request body is malformed or contains invalid values for at least one of the properties.
      *  - 403: The authenticated user has insufficient permissions.
-     *  - 404: No API key was specified in the request, the key has been revoked or the user bearing the key lacks permissions for this operation.
+     *  - 404: No API key was specified in the request, the key has been revoked, or the user bearing the key lacks permissions for this operation.
      *
      * @param testDistributionAgentPoolConfiguration 
      * @return [TestDistributionAgentPoolConfigurationWithId]
@@ -47,7 +47,7 @@
      * Responses:
      *  - 200: The poolId referenced an existing Agent Pool and it was deleted.
      *  - 403: The authenticated user has insufficient permissions.
-     *  - 404: No API key was specified in the request, the key has been revoked or the user bearing the key lacks permissions for this operation.
+     *  - 404: No API key was specified in the request, the key has been revoked, or the user bearing the key lacks permissions for this operation.
      *
      * @param poolId The ID of the pool to view.
      * @return [Unit]
@@ -56,16 +56,32 @@
     suspend fun deleteTestDistributionAgentPool(@Path("poolId") poolId: kotlin.String): Unit
 
     /**
+     * Generate a new Test Distribution pool-specific agent registration key.
+     * Generate a new Test Distribution pool-specific agent registration key to connect agents and query the agent pool API.
+     * Responses:
+     *  - 200: A new registration key was successfully generated and contained in the response.
+     *  - 403: The authenticated user has insufficient permissions.
+     *  - 404: No API key was specified in the request, the key has been revoked, or the user bearing the key lacks permissions for this operation.
+     *
+     * @param poolId The ID of the pool to view.
+     * @param testDistributionAgentPoolRegistrationKeyDescription  (optional)
+     * @return [TestDistributionAgentPoolRegistrationKey]
+     */
+    @POST("api/test-distribution/agent-pools/{poolId}/registration-keys")
+    suspend fun generateTestDistributionAgentPoolRegistrationKey(@Path("poolId") poolId: kotlin.String, @Body testDistributionAgentPoolRegistrationKeyDescription: TestDistributionAgentPoolRegistrationKeyDescription? = null): TestDistributionAgentPoolRegistrationKey
+
+    /**
      * Generate a new Test Distribution API key.
-     * Generate a new Test Distribution API key to connect agents and query the agent pool API.
+     * **This operation is deprecated. Migrate to pool-specific agent registration keys instead.** Generate a new Test Distribution API key to connect agents and query the agent pool API. 
      * Responses:
      *  - 200: A new API key was successfully generated and contained in the response.
      *  - 403: The authenticated user has insufficient permissions.
-     *  - 404: No API key was specified in the request, the key has been revoked or the user bearing the key lacks permissions for this operation.
+     *  - 404: No API key was specified in the request, the key has been revoked, or the user bearing the key lacks permissions for this operation.
      *
      * @param testDistributionApiKeyDescription  (optional)
      * @return [TestDistributionApiKey]
      */
+    @Deprecated("This api was deprecated")
     @POST("api/test-distribution/api-keys")
     suspend fun generateTestDistributionApiKey(@Body testDistributionApiKeyDescription: TestDistributionApiKeyDescription? = null): TestDistributionApiKey
 
@@ -75,7 +91,7 @@
      * Responses:
      *  - 200: The poolId referenced an existing Agent Pool whose configuration is described in the response.
      *  - 403: The authenticated user has insufficient permissions.
-     *  - 404: No API key was specified in the request, the key has been revoked or the user bearing the key lacks permissions for this operation.
+     *  - 404: No API key was specified in the request, the key has been revoked, or the user bearing the key lacks permissions for this operation.
      *
      * @param poolId The ID of the pool to view.
      * @return [TestDistributionAgentPoolConfigurationWithId]
@@ -84,12 +100,27 @@
     suspend fun getTestDistributionAgentPool(@Path("poolId") poolId: kotlin.String): TestDistributionAgentPoolConfigurationWithId
 
     /**
+     * Get a Test Distribution pool-specific agent registration keyPrefix information.
+     * Returns information about a Test Distribution pool-specific agent registration keyPrefix.
+     * Responses:
+     *  - 200: The response contains information about the requested Test Distribution pool-specific agent registration keyPrefix.
+     *  - 403: The authenticated user has insufficient permissions.
+     *  - 404: No API key was specified in the request, the key has been revoked, or the user bearing the key lacks permissions for this operation.
+     *
+     * @param poolId The ID of the pool to view.
+     * @param keyPrefix The prefix of the Test Distribution pool-specific agent registration key.
+     * @return [TestDistributionAgentPoolRegistrationKeyPrefix]
+     */
+    @GET("api/test-distribution/agent-pools/{poolId}/registration-keys/{keyPrefix}")
+    suspend fun getTestDistributionAgentPoolRegistrationKey(@Path("poolId") poolId: kotlin.String, @Path("keyPrefix") keyPrefix: kotlin.String): TestDistributionAgentPoolRegistrationKeyPrefix
+
+    /**
      * View the status of an Agent Pool
      * View the status of an Agent Pool, such as its current size. To access this endpoint the user requires the &#x60;Test Distribution&#x60; permission. 
      * Responses:
      *  - 200: The poolId referenced an existing Agent Pool whose status is described in the response.
      *  - 403: The authenticated user has insufficient permissions.
-     *  - 404: No API key was specified in the request, the key has been revoked or the user bearing the key lacks permissions for this operation.
+     *  - 404: No API key was specified in the request, the key has been revoked, or the user bearing the key lacks permissions for this operation.
      *
      * @param poolId The ID of the pool to view.
      * @return [TestDistributionAgentPoolStatus]
@@ -99,41 +130,74 @@
 
     /**
      * Get a Test Distribution API keyPrefix information.
-     * Returns information about a Test Distribution API keyPrefix.
+     * **This operation is deprecated. Migrate to pool-specific agent registration keys instead.** Returns information about a Test Distribution API keyPrefix. 
      * Responses:
      *  - 200: The response contains information about the requested Test Distribution API keyPrefix.
      *  - 403: The authenticated user has insufficient permissions.
-     *  - 404: No API key was specified in the request, the key has been revoked or the user bearing the key lacks permissions for this operation.
+     *  - 404: No API key was specified in the request, the key has been revoked, or the user bearing the key lacks permissions for this operation.
      *
      * @param keyPrefix The prefix of the Test Distribution API key.
      * @return [TestDistributionApiKeyPrefix]
      */
+    @Deprecated("This api was deprecated")
     @GET("api/test-distribution/api-keys/{keyPrefix}")
     suspend fun getTestDistributionApiKey(@Path("keyPrefix") keyPrefix: kotlin.String): TestDistributionApiKeyPrefix
 
     /**
+     * Insert a specific Test Distribution pool-specific agent registration key.
+     * Inserts a specific Test Distribution pool-specific agent registration key to connect agents and query the agent pool API. If a key with the same prefix but different key already exists (regardless of which pool it belongs to), it will return 400. 
+     * Responses:
+     *  - 200: The registration key was successfully inserted.
+     *  - 400: The request body is malformed or contains invalid values for at least one of the properties.
+     *  - 403: The authenticated user has insufficient permissions.
+     *  - 404: No API key was specified in the request, the key has been revoked, or the user bearing the key lacks permissions for this operation.
+     *
+     * @param poolId The ID of the pool to view.
+     * @param keyPrefix The prefix of the Test Distribution pool-specific agent registration key.
+     * @param testDistributionAgentPoolRegistrationKey 
+     * @return [TestDistributionAgentPoolRegistrationKeyPrefix]
+     */
+    @PUT("api/test-distribution/agent-pools/{poolId}/registration-keys/{keyPrefix}")
+    suspend fun insertTestDistributionAgentPoolRegistrationKey(@Path("poolId") poolId: kotlin.String, @Path("keyPrefix") keyPrefix: kotlin.String, @Body testDistributionAgentPoolRegistrationKey: TestDistributionAgentPoolRegistrationKey): TestDistributionAgentPoolRegistrationKeyPrefix
+
+    /**
      * Insert a specific Test Distribution API key.
-     * Inserts a specific Test Distribution API key to connect agents and query the agent pool API. If a key with the same prefix but different key already exists, it will return 400. 
+     * **This operation is deprecated. Migrate to pool-specific agent registration keys instead.** Inserts a specific Test Distribution API key to connect agents and query the agent pool API. If a key with the same prefix but different key already exists, it will return 400. 
      * Responses:
      *  - 200: The API key was successfully inserted.
      *  - 400: The request body is malformed or contains invalid values for at least one of the properties.
      *  - 403: The authenticated user has insufficient permissions.
-     *  - 404: No API key was specified in the request, the key has been revoked or the user bearing the key lacks permissions for this operation.
+     *  - 404: No API key was specified in the request, the key has been revoked, or the user bearing the key lacks permissions for this operation.
      *
      * @param keyPrefix The prefix of the Test Distribution API key.
      * @param testDistributionApiKey 
      * @return [TestDistributionApiKeyPrefix]
      */
+    @Deprecated("This api was deprecated")
     @PUT("api/test-distribution/api-keys/{keyPrefix}")
     suspend fun insertTestDistributionApiKey(@Path("keyPrefix") keyPrefix: kotlin.String, @Body testDistributionApiKey: TestDistributionApiKey): TestDistributionApiKeyPrefix
 
     /**
+     * Lists Test Distribution pool-specific agent registration keys.
+     * Returns a list of all Test Distribution pool-specific agent registration key prefixes.
+     * Responses:
+     *  - 200: The response contains a listing of the requested type of (active or revoked) Test Distribution pool-specific agent registration key.
+     *  - 403: The authenticated user has insufficient permissions.
+     *  - 404: No API key was specified in the request, the key has been revoked, or the user bearing the key lacks permissions for this operation.
+     *
+     * @param poolId The ID of the pool to view.
+     * @return [TestDistributionAgentPoolRegistrationKeyPrefixPage]
+     */
+    @GET("api/test-distribution/agent-pools/{poolId}/registration-keys")
+    suspend fun listTestDistributionAgentPoolRegistrationKeys(@Path("poolId") poolId: kotlin.String): TestDistributionAgentPoolRegistrationKeyPrefixPage
+
+    /**
      * Lists Agent Pools.
      * Returns a list of all Agent Pools.
      * Responses:
      *  - 200: The response contains a listing of all Agent Pools.
      *  - 403: The authenticated user has insufficient permissions.
-     *  - 404: No API key was specified in the request, the key has been revoked or the user bearing the key lacks permissions for this operation.
+     *  - 404: No API key was specified in the request, the key has been revoked, or the user bearing the key lacks permissions for this operation.
      *
      * @return [TestDistributionAgentPoolPage]
      */
@@ -142,28 +206,45 @@
 
     /**
      * Lists Test Distribution API keys.
-     * Returns a list of all Test Distribution API key prefixes.
+     * **This operation is deprecated. Migrate to pool-specific agent registration keys instead.** Returns a list of all Test Distribution API key prefixes. 
      * Responses:
      *  - 200: The response contains a listing of the requested type of (active or revoked) Test Distribution API keys.
      *  - 403: The authenticated user has insufficient permissions.
-     *  - 404: No API key was specified in the request, the key has been revoked or the user bearing the key lacks permissions for this operation.
+     *  - 404: No API key was specified in the request, the key has been revoked, or the user bearing the key lacks permissions for this operation.
      *
      * @return [TestDistributionApiKeyPrefixPage]
      */
+    @Deprecated("This api was deprecated")
     @GET("api/test-distribution/api-keys")
     suspend fun listTestDistributionApiKeys(): TestDistributionApiKeyPrefixPage
 
     /**
+     * Revoke a Test Distribution pool-specific agent registration key.
+     * Revoke the Test Distribution pool-specific agent registration key for the given prefix which uniquely identifies a Test Distribution pool-specific agent registration key. A revoked key can no longer be used to connect agents, but it will still be queryable and returned in the list. 
+     * Responses:
+     *  - 200: The registration key was revoked successfully.
+     *  - 403: The authenticated user has insufficient permissions.
+     *  - 404: No API key was specified in the request, the key has been revoked, or the user bearing the key lacks permissions for this operation.
+     *
+     * @param poolId The ID of the pool to view.
+     * @param keyPrefix The prefix of the Test Distribution pool-specific agent registration key.
+     * @return [Unit]
+     */
+    @DELETE("api/test-distribution/agent-pools/{poolId}/registration-keys/{keyPrefix}")
+    suspend fun revokeTestDistributionAgentPoolRegistrationKey(@Path("poolId") poolId: kotlin.String, @Path("keyPrefix") keyPrefix: kotlin.String): Unit
+
+    /**
      * Revoke a Test Distribution API key.
-     * Revoke the Test Distribution API key for the given prefix which uniquely identifies a Test Distribution API key. A revoked key can no longer be used to connect agents, but it will still be queryable and returned in the list. 
+     * **This operation is deprecated. Migrate to pool-specific agent registration keys instead.** Revoke the Test Distribution API key for the given prefix which uniquely identifies a Test Distribution API key. A revoked key can no longer be used to connect agents, but it will still be queryable and returned in the list. 
      * Responses:
      *  - 200: The API key was revoked successfully.
      *  - 403: The authenticated user has insufficient permissions.
-     *  - 404: No API key was specified in the request, the key has been revoked or the user bearing the key lacks permissions for this operation.
+     *  - 404: No API key was specified in the request, the key has been revoked, or the user bearing the key lacks permissions for this operation.
      *
      * @param keyPrefix The prefix of the Test Distribution API key.
      * @return [Unit]
      */
+    @Deprecated("This api was deprecated")
     @DELETE("api/test-distribution/api-keys/{keyPrefix}")
     suspend fun revokeTestDistributionApiKey(@Path("keyPrefix") keyPrefix: kotlin.String): Unit
 
diff -ur ./base-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/TestsApi.kt ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/TestsApi.kt
--- ./base-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/TestsApi.kt	2024-04-04 23:30:19.965086454 +0000
+++ ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/TestsApi.kt	2024-04-04 23:30:06.901129997 +0000
@@ -21,7 +21,7 @@
      * @param container Must be the fully qualified name of the test container to query. May not contain any wildcards.
      * @param testOutcomes Allows restricting the search to tests that had at least one instance of the given outcome.
      * @param limit The maximum number of test outcomes to query. (optional, default to 100)
-     * @param query A query for filtering tests, written in the Develocity advanced search query language See: https://gradle.com/help/enterprise-advanced-search 
+     * @param query A query for filtering tests, written in the Develocity advanced search query language See: https://gradle.com/help/advanced-search 
      * @param include Controls which optional fields are included in the response. (optional)
      * @return [TestsResponse]
      */
@@ -38,7 +38,7 @@
      *
      * @param container Allows restricting the search to parts of the test container hierarchy. You can use wildcards to match a specific subpackage. (default to "*")
      * @param testOutcomes Allows restricting the search to tests that had at least one instance of the given outcome.
-     * @param query A query for filtering tests, written in the Develocity advanced search query language See: https://gradle.com/help/enterprise-advanced-search 
+     * @param query A query for filtering tests, written in the Develocity advanced search query language See: https://gradle.com/help/advanced-search 
      * @param include Controls which optional fields are included in the response. (optional)
      * @return [TestsResponse]
      */
diff -ur ./base-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/Build.kt ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/Build.kt
--- ./base-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/Build.kt	2024-04-04 23:30:19.957086474 +0000
+++ ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/Build.kt	2024-04-04 23:30:06.889130024 +0000
@@ -21,11 +21,11 @@
 import com.squareup.moshi.JsonClass
 
 /**
- * A build with the common attributes of a Build Scan.
+ * A build with common attributes.
  *
  * @param id The Build Scan ID.
  * @param availableAt A unix-epoch-time in milliseconds referring to the instant that Develocity completed receiving and processing the build.
- * @param buildToolType The build tool type used to capture the Build Scan.
+ * @param buildToolType The build tool type of the build.
  * @param buildToolVersion The build tool version used.
  * @param buildAgentVersion The build agent version used.
  * @param models 
@@ -42,7 +42,7 @@
     @Json(name = "availableAt")
     val availableAt: kotlin.Long,
 
-    /* The build tool type used to capture the Build Scan. */
+    /* The build tool type of the build. */
     @Json(name = "buildToolType")
     val buildToolType: kotlin.String,
 
diff -ur ./base-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildModelName.kt ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildModelName.kt
--- ./base-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildModelName.kt	2024-04-04 23:30:19.957086474 +0000
+++ ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildModelName.kt	2024-04-04 23:30:06.889130024 +0000
@@ -22,7 +22,7 @@
 /**
  * Build model names that can be requested when fetching builds.
  *
- * Values: gradleAttributes,gradleBuildCachePerformance,gradleProjects,gradleNetworkActivity,mavenAttributes,mavenBuildCachePerformance,mavenModules,mavenDependencyResolution
+ * Values: gradleAttributes,gradleBuildCachePerformance,gradleProjects,gradleNetworkActivity,gradleArtifactTransformExecutions,gradleDeprecations,mavenAttributes,mavenBuildCachePerformance,mavenModules,mavenDependencyResolution
  */
 
 @JsonClass(generateAdapter = false)
@@ -40,6 +40,12 @@
     @Json(name = "gradle-network-activity")
     gradleNetworkActivity("gradle-network-activity"),
 
+    @Json(name = "gradle-artifact-transform-executions")
+    gradleArtifactTransformExecutions("gradle-artifact-transform-executions"),
+
+    @Json(name = "gradle-deprecations")
+    gradleDeprecations("gradle-deprecations"),
+
     @Json(name = "maven-attributes")
     mavenAttributes("maven-attributes"),
 
diff -ur ./base-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildModels.kt ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildModels.kt
--- ./base-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildModels.kt	2024-04-04 23:30:19.957086474 +0000
+++ ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildModels.kt	2024-04-04 23:30:06.889130024 +0000
@@ -21,12 +21,14 @@
 import com.squareup.moshi.JsonClass
 
 /**
- * Optional requested models associated with the Build Scan.
+ * Optional requested models associated with the build.
  *
  * @param gradleAttributes 
  * @param gradleBuildCachePerformance 
  * @param gradleProjects 
  * @param gradleNetworkActivity 
+ * @param gradleArtifactTransformExecutions 
+ * @param gradleDeprecations 
  * @param mavenAttributes 
  * @param mavenBuildCachePerformance 
  * @param mavenModules 
@@ -48,6 +50,12 @@
     @Json(name = "gradleNetworkActivity")
     val gradleNetworkActivity: BuildModelsGradleNetworkActivity? = null,
 
+    @Json(name = "gradleArtifactTransformExecutions")
+    val gradleArtifactTransformExecutions: BuildModelsGradleArtifactTransformExecutions? = null,
+
+    @Json(name = "gradleDeprecations")
+    val gradleDeprecations: BuildModelsGradleDeprecations? = null,
+
     @Json(name = "mavenAttributes")
     val mavenAttributes: BuildModelsMavenAttributes? = null,
 
Only in ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model: BuildModelsGradleArtifactTransformExecutions.kt
diff -ur ./base-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildModelsGradleAttributes.kt ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildModelsGradleAttributes.kt
--- ./base-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildModelsGradleAttributes.kt	2024-04-04 23:30:19.957086474 +0000
+++ ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildModelsGradleAttributes.kt	2024-04-04 23:30:06.893130015 +0000
@@ -21,7 +21,7 @@
 import com.squareup.moshi.JsonClass
 
 /**
- * The attributes of a Gradle Build Scan, or a report of a problem encountered.
+ * The attributes of a Gradle build, or a report of a problem encountered.
  *
  * @param problem 
  * @param model 
diff -ur ./base-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildModelsGradleBuildCachePerformance.kt ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildModelsGradleBuildCachePerformance.kt
--- ./base-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildModelsGradleBuildCachePerformance.kt	2024-04-04 23:30:19.957086474 +0000
+++ ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildModelsGradleBuildCachePerformance.kt	2024-04-04 23:30:06.893130015 +0000
@@ -21,7 +21,7 @@
 import com.squareup.moshi.JsonClass
 
 /**
- * The build cache performance of a Gradle Build Scan, or a report of a problem encountered.
+ * The build cache performance of a Gradle build, or a report of a problem encountered.
  *
  * @param problem 
  * @param model 
Only in ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model: BuildModelsGradleDeprecations.kt
diff -ur ./base-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildModelsMavenAttributes.kt ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildModelsMavenAttributes.kt
--- ./base-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildModelsMavenAttributes.kt	2024-04-04 23:30:19.957086474 +0000
+++ ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildModelsMavenAttributes.kt	2024-04-04 23:30:06.893130015 +0000
@@ -21,7 +21,7 @@
 import com.squareup.moshi.JsonClass
 
 /**
- * The attributes of a Maven Build Scan, or a report of a problem encountered.
+ * The attributes of a Maven build, or a report of a problem encountered.
  *
  * @param problem 
  * @param model 
diff -ur ./base-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildModelsMavenBuildCachePerformance.kt ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildModelsMavenBuildCachePerformance.kt
--- ./base-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildModelsMavenBuildCachePerformance.kt	2024-04-04 23:30:19.957086474 +0000
+++ ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildModelsMavenBuildCachePerformance.kt	2024-04-04 23:30:06.893130015 +0000
@@ -21,7 +21,7 @@
 import com.squareup.moshi.JsonClass
 
 /**
- * The build cache performance of a Maven Build Scan, or a report of a problem encountered.
+ * The build cache performance of a Maven build, or a report of a problem encountered.
  *
  * @param problem 
  * @param model 
diff -ur ./base-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildQuery.kt ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildQuery.kt
--- ./base-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildQuery.kt	2024-04-04 23:30:19.961086464 +0000
+++ ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildQuery.kt	2024-04-04 23:30:06.893130015 +0000
@@ -24,6 +24,7 @@
  * 
  *
  * @param models The list of build models to return in the response for each build. If not provided, no models are returned. 
+ * @param allModels Whether to include all build models for the build. If set to `true`, the value of the `models` parameter is ignored. 
  * @param availabilityWaitTimeoutSecs The time in seconds the server should wait for ingestion before returning a wait timeout response.
  */
 
@@ -34,6 +35,10 @@
     @Json(name = "models")
     val models: kotlin.collections.List<BuildModelName>? = null,
 
+    /* Whether to include all build models for the build. If set to `true`, the value of the `models` parameter is ignored.  */
+    @Json(name = "allModels")
+    val allModels: kotlin.Boolean? = false,
+
     /* The time in seconds the server should wait for ingestion before returning a wait timeout response. */
     @Json(name = "availabilityWaitTimeoutSecs")
     val availabilityWaitTimeoutSecs: kotlin.Int? = null
diff -ur ./base-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildsQuery.kt ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildsQuery.kt
--- ./base-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildsQuery.kt	2024-04-04 23:30:19.961086464 +0000
+++ ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/BuildsQuery.kt	2024-04-04 23:30:06.893130015 +0000
@@ -30,8 +30,9 @@
  * @param reverse A boolean indicating the time direction of the query. A value of `true` indicates a backward query, and returned builds will be sorted from most to least recent. A value of `false` indicates a forward query, and returned builds will be sorted from least to most recent. This parameter has no effect if any of `since`, `sinceBuild` are used. If not provided, the default value is `false`. 
  * @param maxBuilds The maximum number of builds returned by the query. The query returns when that number is reached or when `maxWaitSecs` is reached. If not provided, the default value is `100`. 
  * @param maxWaitSecs The maximum number of seconds to wait for builds before returning. If this time is reached before `maxBuilds` is reached, the query returns with the already processed builds. Note that this time is respected with best effort. A query will return soon after this time has passed but there is no guarantee that it exactly returns before this time has passed. This parameter has no effect if `reverse=true` is specified, because new builds cannot become available in the past. If not provided, the default value is `3`. 
- * @param query A query for filtering builds, written in the Develocity advanced search query language See: https://gradle.com/help/enterprise-advanced-search 
+ * @param query A query for filtering builds, written in the Develocity advanced search query language See: https://gradle.com/help/advanced-search 
  * @param models The list of build models to return in the response for each build. If not provided, no models are returned. 
+ * @param allModels Whether to include all build models for each build. If set to `true`, the value of the `models` parameter is ignored. 
  */
 
 
@@ -67,13 +68,17 @@
     @Json(name = "maxWaitSecs")
     val maxWaitSecs: kotlin.Int? = null,
 
-    /* A query for filtering builds, written in the Develocity advanced search query language See: https://gradle.com/help/enterprise-advanced-search  */
+    /* A query for filtering builds, written in the Develocity advanced search query language See: https://gradle.com/help/advanced-search  */
     @Json(name = "query")
     val query: kotlin.String? = null,
 
     /* The list of build models to return in the response for each build. If not provided, no models are returned.  */
     @Json(name = "models")
-    val models: kotlin.collections.List<BuildModelName>? = null
+    val models: kotlin.collections.List<BuildModelName>? = null,
+
+    /* Whether to include all build models for each build. If set to `true`, the value of the `models` parameter is ignored.  */
+    @Json(name = "allModels")
+    val allModels: kotlin.Boolean? = false
 
 )
 
Only in ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model: GradleArtifactTransformAttribute.kt
Only in ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model: GradleArtifactTransformExecutionEntry.kt
Only in ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model: GradleArtifactTransformExecutions.kt
diff -ur ./base-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/GradleAttributes.kt ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/GradleAttributes.kt
--- ./base-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/GradleAttributes.kt	2024-04-04 23:30:19.961086464 +0000
+++ ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/GradleAttributes.kt	2024-04-04 23:30:06.893130015 +0000
@@ -21,7 +21,7 @@
 import com.squareup.moshi.JsonClass
 
 /**
- * The attributes of a Gradle Build Scan.
+ * The attributes of a Gradle build.
  *
  * @param id The Build Scan ID.
  * @param buildStartTime The time when the build starts, as milliseconds since Epoch.
diff -ur ./base-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/GradleBuildCachePerformance.kt ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/GradleBuildCachePerformance.kt
--- ./base-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/GradleBuildCachePerformance.kt	2024-04-04 23:30:19.961086464 +0000
+++ ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/GradleBuildCachePerformance.kt	2024-04-04 23:30:06.893130015 +0000
@@ -21,7 +21,7 @@
 import com.squareup.moshi.JsonClass
 
 /**
- * The build cache performance of a Gradle Build Scan.
+ * The build cache performance of a Gradle build.
  *
  * @param id The Build Scan ID.
  * @param buildTime Wall clock duration of the build in milliseconds.
diff -ur ./base-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/GradleBuildCachePerformanceTaskExecutionEntry.kt ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/GradleBuildCachePerformanceTaskExecutionEntry.kt
--- ./base-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/GradleBuildCachePerformanceTaskExecutionEntry.kt	2024-04-04 23:30:19.961086464 +0000
+++ ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/GradleBuildCachePerformanceTaskExecutionEntry.kt	2024-04-04 23:30:06.893130015 +0000
@@ -24,7 +24,7 @@
  *
  * @param taskPath The full task path.
  * @param taskType The fully qualified class name of the task.
- * @param avoidanceOutcome The avoidance outcome of this task with respect to performance:   * `avoided_up_to_date` - Task whose execution is avoided due to build incrementalism   * `avoided_from_local_cache` - Task whose execution is avoided due to reusing a local build cache entry   * `avoided_from_remote_cache` - Task whose execution is avoided due to reusing a remote build cache entry   * `executed_cacheable` - Task which is executed but is cacheable   * `executed_not_cacheable` - Task which is executed but is not cacheable   * `executed_unknown_cacheability` - Task which is executed and whose cacheability can not be determined   * `lifecycle` - Lifecycle task   * `no-source` - No-source task   * `skipped` - Skipped task 
+ * @param avoidanceOutcome The avoidance outcome of this task with respect to performance:   * `avoided_up_to_date` - Task whose execution is avoided due to build incrementalism   * `avoided_from_local_cache` - Task whose execution is avoided due to reusing a local build cache entry   * `avoided_from_remote_cache` - Task whose execution is avoided due to reusing a remote build cache entry   * `executed_cacheable` - Task which is executed but is cacheable   * `executed_not_cacheable` - Task which is executed but is not cacheable   * `executed_unknown_cacheability` - Task which is executed and whose cacheability can not be determined   * `avoided_unknown_reason` - Task which was avoided for an unknown reason   * `lifecycle` - Lifecycle task   * `no-source` - No-source task   * `skipped` - Skipped task 
  * @param duration The task duration in milliseconds.
  * @param fingerprintingDuration The task fingerprinting duration in milliseconds. This duration is part of the complete task execution duration. `null` if the task is not fingerprinted, or the information is not available.
  * @param avoidanceSavings The task avoidance savings in milliseconds, which can be negative. Negative values indicate that it takes more time to reuse outputs than it did to create them originally. `null` if the information is not available.
@@ -47,7 +47,7 @@
     @Json(name = "taskType")
     val taskType: kotlin.String,
 
-    /* The avoidance outcome of this task with respect to performance:   * `avoided_up_to_date` - Task whose execution is avoided due to build incrementalism   * `avoided_from_local_cache` - Task whose execution is avoided due to reusing a local build cache entry   * `avoided_from_remote_cache` - Task whose execution is avoided due to reusing a remote build cache entry   * `executed_cacheable` - Task which is executed but is cacheable   * `executed_not_cacheable` - Task which is executed but is not cacheable   * `executed_unknown_cacheability` - Task which is executed and whose cacheability can not be determined   * `lifecycle` - Lifecycle task   * `no-source` - No-source task   * `skipped` - Skipped task  */
+    /* The avoidance outcome of this task with respect to performance:   * `avoided_up_to_date` - Task whose execution is avoided due to build incrementalism   * `avoided_from_local_cache` - Task whose execution is avoided due to reusing a local build cache entry   * `avoided_from_remote_cache` - Task whose execution is avoided due to reusing a remote build cache entry   * `executed_cacheable` - Task which is executed but is cacheable   * `executed_not_cacheable` - Task which is executed but is not cacheable   * `executed_unknown_cacheability` - Task which is executed and whose cacheability can not be determined   * `avoided_unknown_reason` - Task which was avoided for an unknown reason   * `lifecycle` - Lifecycle task   * `no-source` - No-source task   * `skipped` - Skipped task  */
     @Json(name = "avoidanceOutcome")
     val avoidanceOutcome: GradleBuildCachePerformanceTaskExecutionEntry.AvoidanceOutcome,
 
@@ -90,9 +90,9 @@
 ) {
 
     /**
-     * The avoidance outcome of this task with respect to performance:   * `avoided_up_to_date` - Task whose execution is avoided due to build incrementalism   * `avoided_from_local_cache` - Task whose execution is avoided due to reusing a local build cache entry   * `avoided_from_remote_cache` - Task whose execution is avoided due to reusing a remote build cache entry   * `executed_cacheable` - Task which is executed but is cacheable   * `executed_not_cacheable` - Task which is executed but is not cacheable   * `executed_unknown_cacheability` - Task which is executed and whose cacheability can not be determined   * `lifecycle` - Lifecycle task   * `no-source` - No-source task   * `skipped` - Skipped task 
+     * The avoidance outcome of this task with respect to performance:   * `avoided_up_to_date` - Task whose execution is avoided due to build incrementalism   * `avoided_from_local_cache` - Task whose execution is avoided due to reusing a local build cache entry   * `avoided_from_remote_cache` - Task whose execution is avoided due to reusing a remote build cache entry   * `executed_cacheable` - Task which is executed but is cacheable   * `executed_not_cacheable` - Task which is executed but is not cacheable   * `executed_unknown_cacheability` - Task which is executed and whose cacheability can not be determined   * `avoided_unknown_reason` - Task which was avoided for an unknown reason   * `lifecycle` - Lifecycle task   * `no-source` - No-source task   * `skipped` - Skipped task 
      *
-     * Values: avoidedUpToDate,avoidedFromLocalCache,avoidedFromRemoteCache,executedCacheable,executedNotCacheable,executedUnknownCacheability,lifecycle,noMinusSource,skipped
+     * Values: avoidedUpToDate,avoidedFromLocalCache,avoidedFromRemoteCache,executedCacheable,executedNotCacheable,executedUnknownCacheability,avoidedUnknownReason,lifecycle,noMinusSource,skipped
      */
     @JsonClass(generateAdapter = false)
     enum class AvoidanceOutcome(val value: kotlin.String) {
@@ -102,6 +102,7 @@
         @Json(name = "executed_cacheable") executedCacheable("executed_cacheable"),
         @Json(name = "executed_not_cacheable") executedNotCacheable("executed_not_cacheable"),
         @Json(name = "executed_unknown_cacheability") executedUnknownCacheability("executed_unknown_cacheability"),
+        @Json(name = "avoided_unknown_reason") avoidedUnknownReason("avoided_unknown_reason"),
         @Json(name = "lifecycle") lifecycle("lifecycle"),
         @Json(name = "no-source") noMinusSource("no-source"),
         @Json(name = "skipped") skipped("skipped");
Only in ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model: GradleDeprecationEntry.kt
Only in ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model: GradleDeprecationOwner.kt
Only in ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model: GradleDeprecationUsage.kt
Only in ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model: GradleDeprecations.kt
diff -ur ./base-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/GradleDevelocitySettings.kt ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/GradleDevelocitySettings.kt
--- ./base-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/GradleDevelocitySettings.kt	2024-04-04 23:30:19.961086464 +0000
+++ ./pr-ref-api/src/main/kotlin/com/gabrielfeo/gradle/enterprise/api/model/GradleDevelocitySettings.kt	2024-04-04 23:30:06.897130006 +0000
@@ -22,28 +22,34 @@
 /**
  * Settings for Develocity.
  *
- * @param backgroundPublicationEnabled Indicates whether background Build Scan publication is enabled for the build. `null` if Gradle version is < `5.0` or Develocity Gradle plugin version is < `3.4`. See https://docs.gradle.com/enterprise/gradle-plugin/#configuring_background_uploading.
- * @param buildOutputCapturingEnabled Indicates whether build logging output capturing is enabled for the build. `null` if Gradle version is < `5.0` or Develocity Gradle plugin version is < `3.7`. See https://docs.gradle.com/enterprise/gradle-plugin/#capturing_build_and_test_outputs.
- * @param taskInputsFileCapturingEnabled Indicates whether task input file snapshots capturing is enabled for the build. `null` if Gradle version is < `5.0` or Develocity Gradle plugin version is < `2.1`. See https://docs.gradle.com/enterprise/gradle-plugin/#capturing_task_input_files.
- * @param testOutputCapturingEnabled Indicates whether test logging output capturing is enabled for the build. `null` if Gradle version is < `5.0` or Develocity Gradle plugin version is < `3.7`. See https://do...*[Comment body truncated]*

@gabrielfeo gabrielfeo force-pushed the feature/api-spec-2024.1 branch 2 times, most recently from 63e6299 to c860092 Compare April 2, 2024 22:11
@gabrielfeo gabrielfeo changed the base branch from main to next April 2, 2024 22:12
@gabrielfeo gabrielfeo force-pushed the feature/api-spec-2024.1 branch from c860092 to b878141 Compare April 4, 2024 21:21
@gabrielfeo gabrielfeo merged commit 835e9ab into next Apr 4, 2024
8 checks passed
@gabrielfeo gabrielfeo deleted the feature/api-spec-2024.1 branch April 4, 2024 23:33
@gabrielfeo gabrielfeo restored the feature/api-spec-2024.1 branch November 30, 2024 02:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant