Apply latest config

.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 >}}

base/src/main/java/io/spine/type/KnownTypes.java

@@ -52,7 +52,6 @@
 import static com.google.common.collect.ImmutableList.toImmutableList;
 import static io.spine.string.Strings.joinByLines;
 import static io.spine.util.Predicates2.distinctBy;
-import static java.lang.String.format;
 import static java.lang.System.lineSeparator;
 import static java.util.Comparator.comparing;
 import static java.util.stream.Collectors.toSet;

buildSrc/build.gradle.kts

@@ -192,6 +192,15 @@ dependencies {
     ).forEach {
         implementation(it)
     }
+
+    testImplementation(platform("org.junit:junit-bom:5.11.4"))
+    testImplementation("org.junit.jupiter:junit-jupiter")
+    testImplementation("io.kotest:kotest-assertions-core:6.0.4")
+    testRuntimeOnly("org.junit.platform:junit-platform-launcher")
+}
+
+tasks.test {
+    useJUnitPlatform()
 }
 
 dependOnBuildSrcJar()

buildSrc/src/main/kotlin/BuildExtensions.kt

@@ -227,6 +227,8 @@ fun Project.configureTaskDependencies() {
         "compileTestFixturesKotlin".dependOn("kspTestFixturesKotlin")
         "javadocJar".dependOn(dokkaGeneratePublicationJavadoc)
         "htmlDocsJar".dependOn(dokkaGenerate)
+
+        "kspTestKotlin".dependOn("launchTestSpineCompiler")
     }
 }
 

buildSrc/src/main/kotlin/io/spine/dependency/build/Ksp.kt

@@ -35,7 +35,7 @@ import io.spine.dependency.Dependency
  */
 @Suppress("unused")
 object Ksp : Dependency() {
-    override val version = "2.3.0"
+    override val version = "2.3.6"
     val dogfoodingVersion = version
     override val group = "com.google.devtools.ksp"
 

buildSrc/src/main/kotlin/io/spine/dependency/local/Base.kt

@@ -33,8 +33,8 @@ package io.spine.dependency.local
  */
 @Suppress("ConstPropertyName", "unused")
 object Base {
-    const val version = "2.0.0-SNAPSHOT.383"
-    const val versionForBuildScript = "2.0.0-SNAPSHOT.383"
+    const val version = "2.0.0-SNAPSHOT.386"
+    const val versionForBuildScript = "2.0.0-SNAPSHOT.386"
     const val group = Spine.group
     private const val prefix = "spine"
     const val libModule = "$prefix-base"

buildSrc/src/main/kotlin/io/spine/dependency/local/BaseTypes.kt

@@ -33,7 +33,7 @@ package io.spine.dependency.local
  */
 @Suppress("ConstPropertyName")
 object BaseTypes {
-    const val version = "2.0.0-SNAPSHOT.212"
+    const val version = "2.0.0-SNAPSHOT.223"
     const val group = Spine.group
     const val artifact = "spine-base-types"
     const val lib = "$group:$artifact:$version"

buildSrc/src/main/kotlin/io/spine/dependency/local/Change.kt

@@ -33,7 +33,7 @@ package io.spine.dependency.local
  */
 @Suppress("ConstPropertyName")
 object Change {
-    const val version = "2.0.0-SNAPSHOT.200"
+    const val version = "2.0.0-SNAPSHOT.206"
     const val group = Spine.group
     const val artifact = "spine-change"
     const val lib = "$group:$artifact:$version"

buildSrc/src/main/kotlin/io/spine/dependency/local/Compiler.kt

@@ -72,7 +72,7 @@ object Compiler : Dependency() {
      * The version of the Compiler dependencies.
      */
     override val version: String
-    private const val fallbackVersion = "2.0.0-SNAPSHOT.035"
+    private const val fallbackVersion = "2.0.0-SNAPSHOT.041"
 
     /**
      * The distinct version of the Compiler used by other build tools.
@@ -81,7 +81,7 @@ object Compiler : Dependency() {
      * transitive dependencies, this is the version used to build the project itself.
      */
     val dogfoodingVersion: String
-    private const val fallbackDfVersion = "2.0.0-SNAPSHOT.035"
+    private const val fallbackDfVersion = "2.0.0-SNAPSHOT.041"
 
     /**
      * The artifact for the Compiler Gradle plugin.

buildSrc/src/main/kotlin/io/spine/dependency/local/CoreJvm.kt

@@ -39,7 +39,7 @@ typealias CoreJava = CoreJvm
 @Suppress("ConstPropertyName", "unused")
 object CoreJvm {
     const val group = Spine.group
-    const val version = "2.0.0-SNAPSHOT.358"
+    const val version = "2.0.0-SNAPSHOT.372"
 
     const val coreArtifact = "spine-core"
     const val clientArtifact = "spine-client"

buildSrc/src/main/kotlin/io/spine/dependency/local/CoreJvmCompiler.kt

@@ -26,9 +26,6 @@
 
 package io.spine.dependency.local
 
-import io.spine.dependency.local.CoreJvmCompiler.dogfoodingVersion
-import io.spine.dependency.local.CoreJvmCompiler.version
-
 /**
  * Dependencies on the CoreJvm Compiler artifacts.
  *
@@ -49,12 +46,12 @@ object CoreJvmCompiler {
     /**
      * The version used to in the build classpath.
      */
-    const val dogfoodingVersion = "2.0.0-SNAPSHOT.042"
+    const val dogfoodingVersion = "2.0.0-SNAPSHOT.058"
 
     /**
      * The version to be used for integration tests.
      */
-    const val version = "2.0.0-SNAPSHOT.042"
+    const val version = "2.0.0-SNAPSHOT.058"
 
     /**
      * The ID of the Gradle plugin.

buildSrc/src/main/kotlin/io/spine/dependency/local/ModelCompiler.kt

@@ -33,7 +33,7 @@ package io.spine.dependency.local
  */
 @Suppress("ConstPropertyName")
 object ModelCompiler {
-    const val version = "2.0.0-SNAPSHOT.133"
+    const val version = "2.0.0-SNAPSHOT.200"
     const val group = Spine.toolsGroup
     const val artifact = "spine-model-compiler"
     const val lib = "$group:$artifact:$version"

buildSrc/src/main/kotlin/io/spine/dependency/local/Time.kt

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025, TeamDev. All rights reserved.
+ * Copyright 2026, TeamDev. All rights reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -26,18 +26,42 @@
 
 package io.spine.dependency.local
 
+import io.spine.dependency.Dependency
+
 /**
  * Spine Time library.
  *
  * @see <a href="https://github.com/SpineEventEngine/time">spine-time</a>
  */
-@Suppress("ConstPropertyName")
-object Time {
-    const val version = "2.0.0-SNAPSHOT.220"
-    const val group = Spine.group
-    const val artifact = "spine-time"
-    const val lib = "$group:$artifact:$version"
-    const val javaExtensions = "$group:$artifact-java:$version"
-    const val kotlinExtensions = "$group:$artifact-kotlin:$version"
-    const val testLib = "${Spine.toolsGroup}:spine-time-testlib:$version"
+@Suppress(
+    "unused" /* Some subprojects do not use all Time artifacts. */,
+    "ConstPropertyName" /* We use custom convention for artifact properties. */,
+    "MemberVisibilityCanBePrivate" /* The properties are used directly by other subprojects. */,
+)
+object Time : Dependency() {
+    override val group = Spine.group
+    override val version = "2.0.0-SNAPSHOT.234"
+    private const val infix = "spine-time"
+
+    fun lib(version: String): String = "$group:$infix:$version"
+    val lib get() = lib(version)
+
+    fun javaExtensions(version: String): String = "$group:$infix-java:$version"
+    val javaExtensions get() = javaExtensions(version)
+
+    fun kotlinExtensions(version: String): String = "$group:$infix-kotlin:$version"
+    val kotlinExtensions get() = kotlinExtensions(version)
+
+    fun testLib(version: String): String = "${Spine.toolsGroup}:time-testlib:$version"
+    val testLib get() = testLib(version)
+
+    override val modules: List<String>
+        get() = listOf(
+            lib,
+            javaExtensions,
+            kotlinExtensions,
+            testLib
+        ).map {
+            it.split(":").let { (g, artifact) -> "$g:$artifact" }
+        }
 }

buildSrc/src/main/kotlin/io/spine/dependency/local/ToolBase.kt

@@ -34,8 +34,8 @@ package io.spine.dependency.local
 @Suppress("ConstPropertyName", "unused")
 object ToolBase {
     const val group = Spine.toolsGroup
-    const val version = "2.0.0-SNAPSHOT.371"
-    const val dogfoodingVersion = "2.0.0-SNAPSHOT.371"
+    const val version = "2.0.0-SNAPSHOT.375"
+    const val dogfoodingVersion = "2.0.0-SNAPSHOT.375"
 
     const val lib = "$group:tool-base:$version"
     const val classicCodegen = "$group:classic-codegen:$version"

buildSrc/src/main/kotlin/io/spine/dependency/local/Validation.kt

@@ -36,7 +36,7 @@ object Validation {
     /**
      * The version of the Validation library artifacts.
      */
-    const val version = "2.0.0-SNAPSHOT.378"
+    const val version = "2.0.0-SNAPSHOT.408"
 
     /**
      * The last version of Validation compatible with ProtoData.
@@ -53,6 +53,9 @@ object Validation {
     fun runtime(version: String) = "$runtimeModule:$version"
     val runtime = runtime(version)
 
+    @Deprecated("Use `runtime` instead.", ReplaceWith("runtime"))
+    const val oldRuntime = "io.spine.validation:spine-validation-java-runtime:2.0.0-SNAPSHOT.354"
+
     const val javaModule = "$group:$prefix-java"
     const val java = "$javaModule:$version"
     const val javaBundleModule = "$group:$prefix-java-bundle"

buildSrc/src/main/kotlin/io/spine/dependency/test/JUnit.kt

@@ -33,7 +33,7 @@ import io.spine.dependency.DependencyWithBom
 @Suppress("unused", "ConstPropertyName")
 object JUnit : DependencyWithBom() {
 
-    override val version = "6.0.0"
+    override val version = "6.0.3"
     override val group: String = "org.junit"
 
     /**