Merge pull request #586 from SpineEventEngine/update-agents-on-pull

Update agents on `pull`

Author: alexander-yevsyukov

.agents/text-formatting.md

@@ -1,8 +1,12 @@
 # Text formatting
 
-## Text width
+## Text width tasks
 - Wrap `.md` text to 80 characters for readability.
-- Wrap KDoc comments at 75 characters. 
+- Wrap Kotlin and Java code at 99 characters. This improves readability on notebooks and phones.
+
+### KDoc formatting tasks
+- Wrap at 75 characters.
+- Wrap tag description text with two leading spaces `  ` after new line.
 
 ## Using periods
 

buildSrc/src/main/resources/dokka/styles/custom-styles.css

@@ -1,11 +1,11 @@
 /*
- * Copyright 2023, TeamDev. All rights reserved.
+ * Copyright 2025, 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.
  * You may obtain a copy of the License at
  *
- * http://www.apache.org/licenses/LICENSE-2.0
+ * https://www.apache.org/licenses/LICENSE-2.0
  *
  * Redistribution and use in source and/or binary forms, with or without
  * modification, must retain the above copyright notice and the following

gradle.properties

@@ -11,6 +11,14 @@ org.gradle.parallel=true
 # Dokka plugin eats more memory than usual. Therefore, all builds should have enough.
 org.gradle.jvmargs=-Xmx4096m -XX:MaxMetaspaceSize=1024m -XX:+UseParallelGC
 
+# suppress inspection "UnusedProperty"
+# The below property enables generation of XML reports for tests.
+# If this flag is false, it causes `KotlinTestReport` task to replace these reports with one
+# consolidated HTML report.
+# See: https://github.com/JetBrains/kotlin/blob/9fd05632f0d7f074b6544527e73eb0fbb2fb1ef2/libraries/tools/kotlin-gradle-plugin/src/common/kotlin/org/jetbrains/kotlin/gradle/testing/internal/KotlinTestReport.kt#L20
+# See: https://youtrack.jetbrains.com/issue/KT-32608
+kotlin.tests.individualTaskReports=true
+
 # Enables the Dokka migration mode from v1 to v2.
 # For details please see:
 #   https://kotlinlang.org/docs/dokka-migration.html#enable-migration-helpers

gradle/wrapper/gradle-wrapper.properties

@@ -1,6 +1,6 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-8.14-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.14.2-bin.zip
 networkTimeout=10000
 validateDistributionUrl=true
 zipStoreBase=GRADLE_USER_HOME

migrate

@@ -12,11 +12,21 @@ cp CODE_OF_CONDUCT.md ..
 echo "Updating Codecov settings"
 cp .codecov.yml ..
 
-echo "Updating AGENTS.md"
+
+echo "Updating \\\`AGENTS.md\\\`"
 cp AGENTS.md ..
 
 echo "Updating Junie guidelines"
-cp -R .junie ..
+rm -rf ../.junie
+if [ -d ".junie" ]; then
+    cp -R .junie ..
+fi
+
+echo "Updating \\\`.agents\\\` directory"
+rm -rf ../.agents
+if [ -d ".agents" ]; then
+    cp -R .agents ..
+fi
 
 # Copies the file or directory passed as the first parameter to the upper directory,
 # only if such a file or directory does not exist there.
@@ -46,7 +56,7 @@ rm -f ../.github/workflows/detekt-code-analysis.yml # This one is `config`-only
 #rm -f ../buildSrc/src/main/kotlin/deps-between-tasks.kt
 
 # 2025-05-02 Remove the refactored file.
-rm -f ../buildSrc/src/main/kotin/io/spine/gradle/javadoc/TaskContainerExtensions.kt
+rm -f ../buildSrc/src/main/kotlin/io/spine/gradle/javadoc/TaskContainerExtensions.kt
 
 # 2025-04-25 Remove the refactored files moved to subpackages
 rm -f ../buildSrc/src/main/kotlin/io/spine/gradle/Repositories.kt
@@ -62,7 +72,7 @@ cp -a gradle.properties ..
 cp -a .gitignore ..
 
 # 2024-10-28
-echo "Removing old packages under 'buildSrc/src/main/kotin/'"
+echo "Removing old packages under \\\`buildSrc/src/main/kotlin/\\\`"
 rm -r ../buildSrc/src/main/kotlin/io/spine/internal/
 
 # 2023-07-12, remove outdated files.
@@ -80,7 +90,7 @@ rm -f ../.lift.toml
 # See `config#498` for more.
 rm -f ../license-report.md
 
-echo "Updating Gradle 'buildSrc'"
+echo "Updating Gradle \\\`buildSrc\\\`"
 cp -R buildSrc ..
 
 echo "Updating Gradle Wrapper"
@@ -90,5 +100,5 @@ cp gradlew.bat ..
 
 cd ..
 
-echo "Adding 'buildSrc' sources to Git..."
+echo "Adding \\\`buildSrc\\\` sources to Git..."
 git add ./buildSrc/src