Merge pull request #75 from SpineEventEngine/force-consumer-id-property

Force `consumerId` properties in plugin components

Author: alexander-yevsyukov

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

.agents/widow-runt-orphan.jpg

@@ -70,6 +70,7 @@ buildscript {
                     jackson.bom,
                     base.annotations,
                     base.libForBuildScript,
+                    base.environment,
                     io.spine.dependency.local.Reflect.lib,
                     toolBase.lib,
                     coreJava.server,

build.gradle.kts

@@ -83,7 +83,7 @@ val kotlinEmbeddedVersion = "2.2.21"
  * 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.

buildSrc/build.gradle.kts

@@ -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"