Bump dependencies and adjust Maven coordinates

.agents/documentation-guidelines.md

@@ -9,6 +9,6 @@
 ## Avoid widows, runts, orphans, or rivers
 
 Agents should **AVOID** text flow patters illustrated
-on [this diagram](widow-runt-orphan-river.jpg).
+on [this diagram](widow-runt-orphan.jpg).
 
 [todo-comments]: https://github.com/SpineEventEngine/documentation/wiki/TODO-comments

.agents/skills/writer/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: writer
+description: >
+ Write, edit, and restructure user-facing and developer-facing documentation.
+ Use when asked to create/update docs such as `README.md`, `docs/**`, and
+ other Markdown documentation; 
+ when drafting tutorials, guides, troubleshooting pages, or migration notes; and
+ when improving inline API documentation (KDoc) and examples.
+---
+
+# Write documentation (repo-specific)
+
+## Decide the target and audience
+
+- Identify the target reader: end user, contributor, maintainer, or tooling/automation.
+- Identify the task type: new doc, update, restructure, or documentation audit.
+- Identify the acceptance criteria: “what is correct when the reader is done?”
+
+## Choose where the content should live
+
+- Prefer updating an existing doc over creating a new one.
+- Place content in the most discoverable location:
+ - `README.md`: project entry point and “what is this?”.
+ - `docs/`: longer-form docs (follow existing conventions in that tree).
+ - Source KDoc: API usage, examples, and semantics that belong with the code.
+
+## Follow local documentation conventions
+
+- Follow `.agents/documentation-guidelines.md` and `.agents/documentation-tasks.md`.
+- Use fenced code blocks for commands and examples; format file/dir names as code.
+- Avoid widows, runts, orphans, and rivers by reflowing paragraphs when needed.
+
+## Make docs actionable
+
+- Prefer steps the reader can execute (commands + expected outcome).
+- Prefer concrete examples over abstract descriptions.
+- Include prerequisites (versions, OS, environment) when they are easy to miss.
+- Use consistent terminology (match code identifiers and existing docs).
+
+## KDoc-specific guidance
+
+- For public/internal APIs, include at least one example snippet demonstrating common usage.
+- When converting from Javadoc/inline comments to KDoc:
+ - Remove HTML like `<p>` and preserve meaning.
+ - Prefer short paragraphs and blank lines over HTML formatting.
+
+## Validate changes
+
+- For code changes, follow `.agents/running-builds.md`.
+- For documentation-only changes in Kotlin/Java sources, prefer `./gradlew dokka`.
+

.agents/skills/writer/agents/openai.yaml

@@ -0,0 +1,5 @@
+interface:
+ display_name: "Writer"
+ short_description: "Write and update user/developer docs"
+ default_prompt: "Write or revise documentation in this repository (for example: README.md, docs/**, CONTRIBUTING.md, and API documentation/KDoc). Follow local documentation guidelines in .agents/*.md, keep changes concise and actionable, and include concrete examples and commands where appropriate."
+

.agents/skills/writer/assets/templates/doc-page.md

@@ -0,0 +1,23 @@
+# Title
+
+## Goal
+
+State what the reader will accomplish.
+
+## Prerequisites
+
+- List versions/tools the reader needs.
+
+## Steps
+
+1. Do the first thing.
+2. Do the next thing.
+
+## Verify
+
+Show how the reader can confirm success.
+
+## Troubleshooting
+
+- Common failure: likely cause → fix.
+

.agents/skills/writer/assets/templates/kdoc-example.md

@@ -0,0 +1,11 @@
+````kotlin
+/**
+ * Explain what this API does in one sentence.
+ *
+ * ## Example
+ * ```kotlin
+ * // Show the typical usage pattern.
+ * val result = doThing()
+ * ```
+ */
+````

.agents/skills/writer/assets/templates/kotlin-java-example.md

@@ -0,0 +1,13 @@
+{{< code-tabs langs="Kotlin, Java">}}
+
+{{< code-tab lang="Kotlin" >}}
+```kotlin
+```
+{{< /code-tab >}}
+
+{{< code-tab lang="Java" >}}
+```java
+```
+{{< /code-tab >}}
+
+{{< /code-tabs >}}

.github/workflows/publish.yml

@@ -58,6 +58,6 @@ jobs:
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
  FORMAL_GIT_HUB_PAGES_AUTHOR: developers@spine.io
  # https://docs.github.com/en/actions/reference/environment-variables
- REPO_SLUG: $GITHUB_REPOSITORY # e.g. SpineEventEngine/core-java
+ REPO_SLUG: ${{ github.repository }} # e.g. SpineEventEngine/core-jvm
  GOOGLE_APPLICATION_CREDENTIALS: ./maven-publisher.json
  NPM_TOKEN: ${{ secrets.NPM_SECRET }}

build.gradle.kts

@@ -40,13 +40,25 @@ import io.spine.gradle.repo.standardToSpineSdk
 import io.spine.gradle.report.license.LicenseReporter
 import io.spine.gradle.report.pom.PomGenerator
 
+buildscript {
+ standardSpineSdkRepositories()
+ doForceVersions(configurations)
+ dependencies {
+ classpath(io.spine.dependency.local.ToolBase.protobufSetupPlugins)
+ }
+}
+
 plugins {
  id("module")
-`compile-protobuf`
+id("com.google.protobuf")
  id("module-testing")
  `gradle-doctor`
  `project-report`
+ `dokka-setup`
 }
+apply(plugin = "io.spine.descriptor-set-file")
+apply(plugin = "io.spine.generated-sources")
+
 apply<IncrementGuard>()
 
 apply(from = "$rootDir/version.gradle.kts")
@@ -95,14 +107,23 @@ dependencies {
 }
 
 spinePublishing {
+ // We have to have a prefix for this library because it is going to be exposed
+ // as API dependency from modules that are also, conventionally, called `testlib`.
+ // Since Gradle attempts to resolve a dependency using Maven coordinates at
+ // the build time, it will fail to resolve the `test-fixtures` capability if there are
+ // two artifacts with the "same" coordinates, that is, `io.spine.tools:testlib:$version`.
+ toolArtifactPrefix = "base-"
  destinations = with(PublishingRepos) {
  setOf(
  cloudArtifactRegistry,
  gitHub("testlib")
  )
  }
- dokkaJar {
- java = true
+}
+
+protobuf {
+ protoc {
+ artifact = Protobuf.compiler
  }
 }
 

buildSrc/build.gradle.kts

@@ -38,7 +38,7 @@ plugins {
  `kotlin-dsl`
 
  // https://github.com/jk1/Gradle-License-Report/releases
- id("com.github.jk1.dependency-license-report").version("2.7")
+ id("com.github.jk1.dependency-license-report").version("2.9")
 }
 
 repositories {
@@ -75,15 +75,15 @@ val grGitVersion = "4.1.1"
  * This version may change from the [version of Kotlin][io.spine.dependency.lib.Kotlin.version]
  * used by the project.
  */
-val kotlinEmbeddedVersion = "2.2.20"
+val kotlinEmbeddedVersion = "2.3.20"
 
 /**
  * The version of Guava used in `buildSrc`.
  *
  * Always use the same version as the one specified in [io.spine.dependency.lib.Guava].
  * Otherwise, when testing Gradle plugins, clashes may occur.
  */
-val guavaVersion = "33.4.8-jre"
+val guavaVersion = "33.5.0-jre"
 
 /**
  * The version of ErrorProne Gradle plugin.
@@ -103,7 +103,7 @@ val errorPronePluginVersion = "4.2.0"
  * @see <a href="https://github.com/google/protobuf-gradle-plugin/releases">
  * Protobuf Gradle Plugins Releases</a>
  */
-val protobufPluginVersion = "0.9.5"
+val protobufPluginVersion = "0.9.6"
 
 /**
  * The version of Dokka Gradle Plugins.
@@ -113,7 +113,7 @@ val protobufPluginVersion = "0.9.5"
  * @see <a href="https://github.com/Kotlin/dokka/releases">
  * Dokka Releases</a>
  */
-val dokkaVersion = "2.0.0"
+val dokkaVersion = "2.1.0"
 
 /**
  * The version of Detekt Gradle Plugin.
@@ -127,11 +127,6 @@ val detektVersion = "1.23.8"
  */
 val kotestJvmPluginVersion = "0.4.10"
 
-/**
- * @see [io.spine.dependency.test.Kotest.MultiplatformGradlePlugin]
- */
-val kotestMultiplatformPluginVersion = "5.9.1"
-
 /**
  * @see [io.spine.dependency.test.Kover]
  */
@@ -144,7 +139,21 @@ val koverVersion = "0.9.1"
  *
  * @see <a href="https://github.com/GradleUp/shadow">Shadow Plugin releases</a>
  */
-val shadowVersion = "8.3.6"
+val shadowVersion = "9.2.2"
+
+/**
+ * The version of JUnit used to test the build scripts.
+ *
+ * @see [io.spine.dependency.test.JUnit]
+ */
+val junitVersion = "6.0.3"
+
+/**
+ * The version of Kotest used to test the build scripts.
+ *
+ * @see [io.spine.dependency.test.Kotest]
+ */
+val kotestVersion = "6.1.10"
 
 configurations.all {
  resolutionStrategy {
@@ -185,7 +194,6 @@ dependencies {
  "com.gradleup.shadow:shadow-gradle-plugin:$shadowVersion",
  "io.gitlab.arturbosch.detekt:detekt-gradle-plugin:$detektVersion",
  "io.kotest:kotest-gradle-plugin:$kotestJvmPluginVersion",
- "io.kotest:kotest-framework-multiplatform-plugin-gradle:$kotestMultiplatformPluginVersion",
  // https://github.com/srikanth-lingala/zip4j
  "net.lingala.zip4j:zip4j:2.10.0",
  "net.ltgt.gradle:gradle-errorprone-plugin:$errorPronePluginVersion",
@@ -198,6 +206,15 @@ dependencies {
  ).forEach {
  implementation(it)
  }
+
+ testImplementation(platform("org.junit:junit-bom:$junitVersion"))
+ testImplementation("org.junit.jupiter:junit-jupiter")
+ testImplementation("io.kotest:kotest-assertions-core:$kotestVersion")
+ testRuntimeOnly("org.junit.platform:junit-platform-launcher")
+}
+
+tasks.test {
+ useJUnitPlatform()
 }
 
 dependOnBuildSrcJar()

buildSrc/src/main/kotlin/BuildExtensions.kt

@@ -156,15 +156,15 @@ val PluginDependenciesSpec.`gradle-doctor`: PluginDependencySpec
  get() = id(GradleDoctor.pluginId).version(GradleDoctor.version)
 
 val PluginDependenciesSpec.kotest: PluginDependencySpec
- get() = Kotest.MultiplatformGradlePlugin.let {
- return id(it.id).version(it.version)
+ get() = Kotest.let {
+ return id(it.gradlePluginId).version(it.version)
  }
 
 val PluginDependenciesSpec.kover: PluginDependencySpec
  get() = id(Kover.id).version(Kover.version)
 
 val PluginDependenciesSpec.ksp: PluginDependencySpec
- get() = id(Ksp.id).version(Ksp.version)
+ get() = id(Ksp.id).version(Ksp.dogfoodingVersion)
 
 val PluginDependenciesSpec.`plugin-publish`: PluginDependencySpec
  get() = id(PluginPublishPlugin.id).version(PluginPublishPlugin.version)
@@ -199,43 +199,36 @@ fun Project.configureTaskDependencies() {
  }
 
  afterEvaluate {
- val launchProtoData = "launchProtoData"
- val launchTestProtoData = "launchTestProtoData"
  val generateProto = "generateProto"
  val createVersionFile = "createVersionFile"
  val compileKotlin = "compileKotlin"
  compileKotlin.run {
  dependOn(generateProto)
- dependOn(launchProtoData)
  }
  val compileTestKotlin = "compileTestKotlin"
- compileTestKotlin.dependOn(launchTestProtoData)
  val sourcesJar = "sourcesJar"
  val kspKotlin = "kspKotlin"
  sourcesJar.run {
  dependOn(generateProto)
- dependOn(launchProtoData)
  dependOn(kspKotlin)
  dependOn(createVersionFile)
  dependOn("prepareProtocConfigVersions")
  }
- val dokkaHtml = "dokkaHtml"
-dokkaHtml.run {
+ val dokkaGenerate = "dokkaGenerate"
+dokkaGenerate.run {
  dependOn(generateProto)
- dependOn(launchProtoData)
- dependOn(kspKotlin)
- }
- val dokkaJavadoc = "dokkaJavadoc"
- dokkaJavadoc.run {
- dependOn(launchProtoData)
  dependOn(kspKotlin)
  }
+ val dokkaGeneratePublicationJavadoc = "dokkaGeneratePublicationJavadoc"
+ dokkaGeneratePublicationJavadoc.dependOn(kspKotlin)
  "publishPluginJar".dependOn(createVersionFile)
  compileKotlin.dependOn(kspKotlin)
  compileTestKotlin.dependOn("kspTestKotlin")
  "compileTestFixturesKotlin".dependOn("kspTestFixturesKotlin")
- "javadocJar".dependOn(dokkaHtml)
- "dokkaKotlinJar".dependOn(dokkaJavadoc)
+ "javadocJar".dependOn(dokkaGeneratePublicationJavadoc)
+ "htmlDocsJar".dependOn(dokkaGenerate)
+
+ "kspTestKotlin".dependOn("launchTestSpineCompiler")
  }
 }