Besi97 · Besi97 · Sep 2, 2026 · Sep 2, 2026 · Sep 2, 2026
diff --git a/...lugin/src/main/java/io/github/besi97/graphql/codegen/gradle/GraphQLCodegenGradleTask.java b/...lugin/src/main/java/io/github/besi97/graphql/codegen/gradle/GraphQLCodegenGradleTask.java
@@ -17,10 +17,10 @@
 import io.github.besi97.graphql.codegen.supplier.SchemaFinder;
 import org.gradle.api.Action;
 import org.gradle.api.DefaultTask;
-import org.gradle.work.DisableCachingByDefault;
 import org.gradle.api.file.DirectoryProperty;
 import org.gradle.api.file.ProjectLayout;
 import org.gradle.api.plugins.JavaPluginExtension;
+import org.gradle.api.tasks.CacheableTask;
 import org.gradle.api.tasks.Input;
 import org.gradle.api.tasks.InputDirectory;
 import org.gradle.api.tasks.InputFile;
@@ -53,7 +53,7 @@
  *
  * @author Besi97
  */
-@DisableCachingByDefault(because = "Code generation output may include timestamps")
+@CacheableTask
 public class GraphQLCodegenGradleTask extends DefaultTask implements GraphQLCodegenConfiguration {
 
     private List<String> graphqlSchemaPaths;
@@ -141,7 +141,7 @@
    private final ProjectLayout projectLayout;

    @Inject
    public GraphQLCodegenGradleTask(ProjectLayout projectLayout) {
        setGroup("codegen");
        setDescription("Generates Java POJOs and interfaces based on GraphQL schemas");
        this.projectLayout = projectLayout;
@@ -323,7 +323,7 @@
    @InputFiles
    @Optional
    @PathSensitive(PathSensitivity.RELATIVE)
    public List<String> getGraphqlSchemaPaths() {
        return graphqlSchemaPaths;
    }

@@ -334,7 +334,7 @@
    @InputFile
    @Optional
    @PathSensitive(PathSensitivity.NONE)
    public String getGraphqlQueryIntrospectionResultPath() {
        return graphqlQueryIntrospectionResultPath;
    }

@@ -344,16 +344,16 @@

    @Nested
    @Optional
    public SchemaFinderConfig getGraphqlSchemas() {
        return graphqlSchemas;
    }

    public void graphqlSchemas(Action<? super SchemaFinderConfig> action) {
        action.execute(graphqlSchemas);
    }

    @OutputDirectory
    public File getOutputDir() {
        return outputDir;
    }

@@ -995,7 +995,7 @@

    @Nested
    @Optional
    public ParentInterfacesConfig getParentInterfaces() {
        return parentInterfaces;
    }

@@ -1030,7 +1030,7 @@
    @InputFiles
    @Optional
    @PathSensitive(PathSensitivity.RELATIVE)
    public List<String> getConfigurationFiles() {
        return configurationFiles;
    }

@@ -1134,13 +1134,13 @@

    @Input
    @Optional
    public Boolean getSkip() {
        return skip;
    }

    @Deprecated
    @Internal
    public Boolean isSkip() {
        return skip;
    }


diff --git a/...c/main/java/io/github/besi97/graphql/codegen/gradle/GraphQLCodegenValidateGradleTask.java b/...c/main/java/io/github/besi97/graphql/codegen/gradle/GraphQLCodegenValidateGradleTask.java
@@ -2,28 +2,46 @@
 
 import io.github.besi97.graphql.codegen.GraphQLCodegenValidate;
 import org.gradle.api.DefaultTask;
-import org.gradle.work.DisableCachingByDefault;
+import org.gradle.api.file.ProjectLayout;
+import org.gradle.api.file.RegularFile;
+import org.gradle.api.provider.Provider;
+import org.gradle.api.tasks.CacheableTask;
 import org.gradle.api.tasks.InputFiles;
+import org.gradle.api.tasks.OutputFile;
 import org.gradle.api.tasks.PathSensitive;
 import org.gradle.api.tasks.PathSensitivity;
 import org.gradle.api.tasks.TaskAction;
 
 import java.io.IOException;
+import java.nio.charset.StandardCharsets;
+import java.nio.file.Files;
+import java.nio.file.Path;
 import java.util.List;
+import javax.inject.Inject;
 
 /**
  * Gradle task for GraphQL code generation
  *
  * @author Besi97
  */
-@DisableCachingByDefault(because = "Validation task does not produce output files")
+@CacheableTask
 public class GraphQLCodegenValidateGradleTask extends DefaultTask {
 
     private List<String> graphqlSchemaPaths;
+    private final Provider<RegularFile> validationResultFile;
+
+    @Inject
+    public GraphQLCodegenValidateGradleTask(ProjectLayout projectLayout) {
+        this.validationResultFile = projectLayout.getBuildDirectory()
+                .file("graphql-codegen-validate/validation.success");
+    }
 
     @TaskAction
     public void validate() throws IOException {
         new GraphQLCodegenValidate(graphqlSchemaPaths).validate();
+        Path resultFilePath = validationResultFile.get().getAsFile().toPath();
+        Files.createDirectories(resultFilePath.getParent());
+        Files.write(resultFilePath, "OK".getBytes(StandardCharsets.UTF_8));
     }
 
     @InputFiles
@@ -35,4 +53,18 @@ public List<String> getGraphqlSchemaPaths() {
     public void setGraphqlSchemaPaths(List<String> graphqlSchemaPaths) {
         this.graphqlSchemaPaths = graphqlSchemaPaths;
     }
+
+    /**
+     * Marker file that records a successful validation run.
+     *
+     * <p>A cacheable task must declare at least one output, otherwise Gradle silently
+     * disables caching for it. This file contains no meaningful data; it only makes
+     * the validation result incremental and cacheable.
+     *
+     * @return the validation result marker file property
+     */
+    @OutputFile
+    public Provider<RegularFile> getValidationResultFile() {
+        return validationResultFile;
+    }
 }