Migrate all modules to Kora 2.0

.github/workflows/test-master.yml

@@ -5,37 +5,44 @@ on:
     branches:
       - "master"
 
+permissions:
+  contents: read
+
 jobs:
   build-tests:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        java: [ "21" ]
+        java: [ "25" ]
         type: [ "Examples", "Guides" ]
         lang: [ "Java", "Kotlin" ]
         feature: [ "Database", "Client", "Server", "Graalvm", "Kafka", "Other" ]
-    name: Pull Request Java ${{ matrix.java }} for ${{ matrix.type }}-${{ matrix.lang }}-${{ matrix.feature }}
+        exclude:
+          - type: "Examples"
+            lang: "Kotlin"
+            feature: "Graalvm"
+          - type: "Guides"
+            feature: "Graalvm"
+    name: Master Java ${{ matrix.java }} for ${{ matrix.type }}-${{ matrix.lang }}-${{ matrix.feature }}
     env:
       GRADLE_TASK_SUFFIX: ${{ matrix.type }}${{ matrix.lang }}${{ matrix.feature }}
+      MAX_PARALLEL_WORKERS: 1
+      GRADLE_ACTIONS_SKIP_BUILD_RESULT_CAPTURE: true
     steps:
       - uses: actions/checkout@v4
+        with:
+          persist-credentials: false
       - name: JDK setup
         uses: actions/setup-java@v4
         with:
           java-version: ${{ matrix.java }}
-          distribution: "adopt"
+          distribution: "temurin"
 
       - name: Gradle setup
         uses: gradle/actions/setup-gradle@v4
         with:
-          cache-read-only: ${{ github.ref != 'refs/heads/master' }}
-          gradle-home-cache-cleanup: ${{ github.ref == 'refs/heads/master' }}
-
-      - name: Gradle build classes
-        run: "./gradlew classes${{ env.GRADLE_TASK_SUFFIX }} --no-daemon --no-parallel --scan --stacktrace"
-
-      - name: Gradle build test classes
-        run: "./gradlew testClasses${{ env.GRADLE_TASK_SUFFIX }} --no-daemon --no-parallel --scan --stacktrace"
+          cache-read-only: false
+          gradle-home-cache-cleanup: true
 
       - name: Gradle run tests
-        run: "./gradlew test${{ env.GRADLE_TASK_SUFFIX }} --no-daemon --no-parallel --scan --stacktrace"
+        run: "./gradlew test${{ env.GRADLE_TASK_SUFFIX }} --no-daemon --no-parallel --console=plain --warning-mode=none --no-problems-report"

.github/workflows/test-pr.yml

@@ -2,47 +2,49 @@ name: Test PR
 
 on:
   pull_request:
-    branches:
-      - "master"
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number }}
+  cancel-in-progress: true
 
 permissions:
   contents: read
-  checks: write
-  pull-requests: write
 
 
 jobs:
   build-tests:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        java: [ "21" ]
+        java: [ "25" ]
         type: [ "Examples", "Guides" ]
         lang: [ "Java", "Kotlin" ]
         feature: [ "Database", "Client", "Server", "Graalvm", "Kafka", "Other" ]
+        exclude:
+          - type: "Examples"
+            lang: "Kotlin"
+            feature: "Graalvm"
+          - type: "Guides"
+            feature: "Graalvm"
     name: Pull Request Java ${{ matrix.java }} for ${{ matrix.type }}-${{ matrix.lang }}-${{ matrix.feature }}
     env:
       GRADLE_TASK_SUFFIX: ${{ matrix.type }}${{ matrix.lang }}${{ matrix.feature }}
+      MAX_PARALLEL_WORKERS: 1
+      GRADLE_ACTIONS_SKIP_BUILD_RESULT_CAPTURE: true
     steps:
       - uses: actions/checkout@v4
+        with:
+          persist-credentials: false
       - name: JDK setup
         uses: actions/setup-java@v4
         with:
           java-version: ${{ matrix.java }}
-          distribution: "adopt"
+          distribution: "temurin"
 
       - name: Gradle setup
         uses: gradle/actions/setup-gradle@v4
         with:
-          cache-read-only: ${{ github.ref != 'refs/heads/master' }}
-          gradle-home-cache-cleanup: ${{ github.ref == 'refs/heads/master' }}
-
-      - name: Gradle build classes
-        run: "./gradlew classes${{ env.GRADLE_TASK_SUFFIX }} --no-daemon --no-parallel --scan --stacktrace"
-
-      - name: Gradle build test classes
-        run: "./gradlew testClasses${{ env.GRADLE_TASK_SUFFIX }} --no-daemon --no-parallel --scan --stacktrace"
+          cache-read-only: true
 
       - name: Gradle run tests
-        run: "./gradlew test${{ env.GRADLE_TASK_SUFFIX }} --no-daemon --no-parallel --scan --stacktrace"
+        run: "./gradlew test${{ env.GRADLE_TASK_SUFFIX }} --no-daemon --no-parallel --console=plain --warning-mode=none --no-problems-report"

.gitignore

@@ -15,4 +15,10 @@ target/
 .idea
 .settings/
 *.iml
-out/
+out/
+
+### Local reference checkouts used during the Kora 2.0 migration
+agents-md/
+
+### Local working artifacts (never commit)
+docs/superpowers/

build.gradle

@@ -3,13 +3,20 @@ import org.gradle.api.services.BuildServiceParameters
 
 plugins {
     id "com.diffplug.spotless" version "6.19.0"
-    id "com.asarkar.gradle.build-time-tracker" version "4.3.0"
-    id "org.graalvm.buildtools.native" version "0.11.5" apply false // or dependsOn fails in graalvm examples
+    id "com.asarkar.gradle.build-time-tracker" version "4.3.0" apply false
+    id "org.graalvm.buildtools.native" version "1.1.7" apply false // or dependsOn fails in graalvm examples
     id "org.jetbrains.kotlin.jvm" version "2.4.10" apply false
-    id "org.jetbrains.kotlin.kapt" version "2.4.10" apply false
     id "com.google.devtools.ksp" version "2.3.11" apply false
 }
 
+def isCiBuild = providers.environmentVariable("CI").map { it.toBoolean() }.orElse(false).get()
+if (isCiBuild) {
+    URLConnection.setDefaultUseCaches("jar", false)
+}
+if (!isCiBuild) {
+    apply plugin: "com.asarkar.gradle.build-time-tracker"
+}
+
 group = groupId
 version = koraVersion
 
@@ -53,7 +60,9 @@ subprojects {
     }
 
     apply plugin: "java"
-    apply plugin: "com.asarkar.gradle.build-time-tracker"
+    if (!isCiBuild) {
+        apply plugin: "com.asarkar.gradle.build-time-tracker"
+    }
 
     if (!project.name.contains("kotlin")) {
         apply plugin: "com.diffplug.spotless"
@@ -93,4 +102,21 @@ subprojects {
     tasks.register("allDeps", DependencyReportTask)
 }
 
+if (isCiBuild) {
+    subprojects {
+        afterEvaluate {
+            tasks.withType(Test).configureEach {
+                testLogging {
+                    showStandardStreams = false
+                    events = [org.gradle.api.tasks.testing.logging.TestLogEvent.FAILED]
+                    exceptionFormat = org.gradle.api.tasks.testing.logging.TestExceptionFormat.FULL
+                    showExceptions = true
+                    showCauses = true
+                    showStackTraces = true
+                }
+            }
+        }
+    }
+}
+
 apply from: "${project.rootDir}/grouping.gradle"

examples/graalvm/kora-java-graalvm-crud-cassandra/Dockerfile

@@ -1,4 +1,4 @@
-FROM ghcr.io/graalvm/native-image-community:21 as builder
+FROM ghcr.io/graalvm/native-image-community:25 as builder
 
 ARG TARGET_DIR=/opt/app
 ARG SOURCE_DIR=build/libs

examples/graalvm/kora-java-graalvm-crud-cassandra/README.md

@@ -15,7 +15,7 @@
 - [Validation](https://kora-projects.github.io/kora-docs/ru/documentation/validation/)
 - [Cache Redis](https://kora-projects.github.io/kora-docs/ru/documentation/cache/#redis)
 
-Скомпилирован с помощью [GraalVM](https://www.graalvm.org/release-notes/JDK_21/)
+Скомпилирован с помощью [GraalVM](https://www.graalvm.org/release-notes/JDK_25/)
 
 ## Build
 

examples/graalvm/kora-java-graalvm-crud-cassandra/build.gradle

@@ -34,7 +34,7 @@ configurations {
 }
 
 dependencies {
-    koraBom platform("io.koraframework:kora-parent:$koraVersion")
+    koraBom platform("io.koraframework:kora-bom:$koraVersion")
     annotationProcessor "org.mapstruct:mapstruct-processor:1.5.5.Final"
     annotationProcessor "io.koraframework:annotation-processors"
     annotationProcessor "io.goodforgod:graalvm-hint-processor:1.2.0"
@@ -51,7 +51,6 @@ dependencies {
     implementation "io.koraframework:openapi-management"
     implementation "io.koraframework:logging-logback"
 
-    implementation "io.projectreactor:reactor-core:3.6.18" // For reactive examples (optional)
     implementation "org.mapstruct:mapstruct:1.5.5.Final"
 
     testImplementation "org.json:json:20231013"
@@ -60,8 +59,8 @@ dependencies {
 
     testImplementation "org.mockito:mockito-core:5.18.0"
     testImplementation "io.koraframework:test-junit5"
-    testImplementation "io.goodforgod:testcontainers-extensions-scylla:0.13.1"
-    testImplementation "io.goodforgod:testcontainers-extensions-redis:0.13.1"
+    testImplementation "io.goodforgod:testcontainers-extensions-scylla:0.15.0"
+    testImplementation "io.goodforgod:testcontainers-extensions-redis:0.15.0"
     testImplementation "org.testcontainers:junit-jupiter:1.21.4"
 }
 
@@ -89,8 +88,8 @@ compileJava.dependsOn openApiGenerateHttpServer
 graalvmNative {
     binaries {
         main {
-            imageName = "$project.name"
-            mainClass = "$application.mainClass"
+            imageName = project.name
+            mainClass = application.mainClass
             javaLauncher = javaToolchains.launcherFor {
                 languageVersion = JavaLanguageVersion.of(25)
                 vendor = JvmVendorSpec.matching("GraalVM Community")
@@ -119,7 +118,7 @@ run {
     ])
 }
 
-jar.enabled = false
+// nativeCompile takes the project's own artifact as its classpath entry, so the plain jar must stay enabled
 shadowJar {
     mergeServiceFiles()
     manifest {
@@ -138,10 +137,6 @@ test {
             "-XX:TieredStopAtLevel=1",
     ]
 
-    environment([
-            "": ""
-    ])
-
     useJUnitPlatform()
     testLogging {
         showStandardStreams = true
@@ -181,4 +176,4 @@ javadoc {
     if (JavaVersion.current().isJava9Compatible()) {
         options.addBooleanOption("html5", true)
     }
-}
+}

examples/graalvm/kora-java-graalvm-crud-cassandra/docker-compose.yml

@@ -2,8 +2,40 @@ services:
   scylla:
     image: scylladb/scylla:2025.3
     restart: unless-stopped
+    command: --smp 1 --developer-mode 1 --authenticator PasswordAuthenticator
     ports:
-      - '5432:5432'
+      - '9042:9042'
+    healthcheck:
+      test: [ "CMD-SHELL", "cqlsh -u cassandra -p cassandra -e 'DESCRIBE KEYSPACES' || exit 1" ]
+      interval: 10s
+      timeout: 10s
+      retries: 30
+      start_period: 20s
+
+
+  redis:
+    image: redis:8.0-alpine
+    restart: unless-stopped
+    command: [ "redis-server", "--requirepass", "redis" ]
+    ports:
+      - '6379:6379'
+
+
+  scylla-init:
+    image: scylladb/scylla:2025.3
+    restart: "no"
+    depends_on:
+      scylla:
+        condition: service_healthy
+    volumes:
+      - ./src/main/resources/migrations:/migrations:ro
+    entrypoint: [ "sh", "-c" ]
+    command:
+      - |
+        cqlsh scylla -u cassandra -p cassandra -e "CREATE KEYSPACE IF NOT EXISTS petshop WITH replication = {'class': 'SimpleStrategy', 'replication_factor': 1}" &&
+        cqlsh scylla -u cassandra -p cassandra -k petshop -f /migrations/setup.cql
+
+
 # Можно закомментировать секцию application и использовать docker-compose
 # как окружения для запуска сервиса через gradle run
   application:
@@ -14,14 +46,18 @@ services:
       - '8080:8080'
       - '8085:8085'
     environment:
-      CASSANDRA_CONTACT_POINTS: jdbc:postgresql://postgres:5432/postgres
+      CASSANDRA_CONTACT_POINTS: scylla:9042
       CASSANDRA_USER: cassandra
       CASSANDRA_PASS: cassandra
-      CASSANDRA_DC: cassandra
-      CASSANDRA_KEYSPACE: cassandra
-      REDIS_URL: redis
-      REDIS_USER: redis
+      CASSANDRA_DC: datacenter1
+      CASSANDRA_KEYSPACE: petshop
+      REDIS_URL: redis://redis:6379/0
+      REDIS_USER: default
       REDIS_PASS: redis
     depends_on:
-      - scylla
-      - redis
+      scylla:
+        condition: service_healthy
+      scylla-init:
+        condition: service_completed_successfully
+      redis:
+        condition: service_started

examples/graalvm/kora-java-graalvm-crud-cassandra/src/main/java/io/koraframework/example/graalvm/crud/cassandra/controller/HttpExceptionHandler.java

@@ -1,19 +1,22 @@
 package io.koraframework.example.graalvm.crud.cassandra.controller;
 
-import io.micrometer.core.instrument.config.validate.ValidationException;
-import java.util.concurrent.CompletionStage;
-import java.util.concurrent.TimeoutException;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
 import io.koraframework.common.annotation.Component;
-import io.koraframework.common.Context;
 import io.koraframework.common.annotation.Tag;
 import io.koraframework.example.graalvm.crud.openapi.server.model.MessageTO;
 import io.koraframework.http.common.body.HttpBody;
-import io.koraframework.http.server.common.*;
+import io.koraframework.http.server.common.HttpServer;
+import io.koraframework.http.server.common.interceptor.HttpServerInterceptor;
+import io.koraframework.http.server.common.request.HttpServerRequest;
+import io.koraframework.http.server.common.response.HttpServerResponse;
+import io.koraframework.http.server.common.response.HttpServerResponseException;
 import io.koraframework.json.common.JsonWriter;
+import io.micrometer.core.instrument.config.validate.ValidationException;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+import java.util.concurrent.TimeoutException;
 
-@Tag(HttpServerModule.class)
+@Tag(HttpServer.class)
 @Component
 public final class HttpExceptionHandler implements HttpServerInterceptor {
 
@@ -26,14 +29,15 @@ public HttpExceptionHandler(JsonWriter<MessageTO> errorJsonWriter) {
     }
 
     @Override
-    public CompletionStage<HttpServerResponse> intercept(Context context, HttpServerRequest request, InterceptChain chain)
-            throws Exception {
-        return chain.process(context, request).exceptionally(e -> {
+    public HttpServerResponse intercept(HttpServerRequest request, InterceptChain chain) {
+        try {
+            return chain.process(request);
+        } catch (Exception e) {
             if (e instanceof HttpServerResponseException ex) {
                 return ex;
             }
 
-            var body = HttpBody.json(errorJsonWriter.toByteArrayUnchecked(new MessageTO(e.getMessage())));
+            var body = HttpBody.json(errorJsonWriter.toByteArray(new MessageTO(e.getMessage())));
             if (e instanceof IllegalArgumentException || e instanceof ValidationException) {
                 return HttpServerResponse.of(400, body);
             } else if (e instanceof TimeoutException) {
@@ -42,6 +46,6 @@ public CompletionStage<HttpServerResponse> intercept(Context context, HttpServer
                 logger.error("Request '{} {}' failed", request.method(), request.path(), e);
                 return HttpServerResponse.of(500, body);
             }
-        });
+        }
     }
 }