diff --git a/.agents/memory/reference/cache-warm-window.md b/.agents/memory/reference/cache-warm-window.md index 796dd4d303..b57ca218cb 100644 --- a/.agents/memory/reference/cache-warm-window.md +++ b/.agents/memory/reference/cache-warm-window.md @@ -18,7 +18,7 @@ same cache slot — provided they fall within the TTL. Developers must have `ENABLE_PROMPT_CACHING_1H=1` set, otherwise the window is too short for cross-session hits to occur reliably. This setting will work ONLY for Claude Code which runs the CLI binary. -It will not work for JetBrains Air or any other IDE plugin which does not +It will not work for JetBrains Air or any other IDE plugin that does not run the Claude Code CLI binary. **Cache is per Anthropic workspace.** All developers authenticated via the diff --git a/.agents/tasks/add-suppliers2-iterators2.md b/.agents/tasks/add-suppliers2-iterators2.md index f820480fc7..3573ca3465 100644 --- a/.agents/tasks/add-suppliers2-iterators2.md +++ b/.agents/tasks/add-suppliers2-iterators2.md @@ -23,7 +23,7 @@ can later drop its copies. - `io.spine.util` already hosts the Guava-companion naming pattern (`Preconditions2`, `Predicates2`) and is `@NullMarked` via `package-info.java`. - The classes keep `@Internal` (as in the source PR): they are framework - plumbing; widening to public API later is non-breaking, the reverse is not. + plumbing; widening to public API later is non-breaking; the reverse is not. - New tests follow `kotlin-jvm-tester` conventions: Kotlin, `Spec` suffix, `internal`, `UtilityClassTest` base (private ctor + final + `NullPointerTester` on public statics), Kotest assertions. diff --git a/.agents/tasks/archive/raise-base-coverage.md b/.agents/tasks/archive/raise-base-coverage.md index cfc6176fa0..f7c17f8af3 100644 --- a/.agents/tasks/archive/raise-base-coverage.md +++ b/.agents/tasks/archive/raise-base-coverage.md @@ -39,7 +39,7 @@ gaps closed without weakening Codecov settings. - [x] Analyze whether `io.spine.code.fs` is used in SpineEventEngine projects. - [x] Mark `io.spine.code.fs` types that are not used by any project as deprecated. - [x] Deprecate `io.spine.code.fs` types that are not used. -- [x] Analyse whether `RejectionType` is used in Spine SDK projects and deprecate if not. +- [x] Analyze whether `RejectionType` is used in Spine SDK projects and deprecate if not. - [x] Finalize test cases for the remaining non-deprecated API and wait for approval to write tests. - [x] Add approved Kotlin `*Spec` tests using stubs, not mocks. diff --git a/annotations/src/main/kotlin/io/spine/annotation/GeneratedMixin.kt b/annotations/src/main/kotlin/io/spine/annotation/GeneratedMixin.kt index 7df4ec651a..bc2dd286f0 100644 --- a/annotations/src/main/kotlin/io/spine/annotation/GeneratedMixin.kt +++ b/annotations/src/main/kotlin/io/spine/annotation/GeneratedMixin.kt @@ -37,14 +37,14 @@ import kotlin.annotation.AnnotationTarget.CLASS * ## Motivation * * This annotation allows documenting the intent of the interface. - * It also allows to instruct IDEs to consider annotated interfaces as implemented before + * It also allows instructing IDEs to consider annotated interfaces as implemented before * the code generation phase, or if the interfaces are used only from projects that depend * on the one declaring these interfaces. * - * For example, Spine Base project introduces the `io.spine.base.CommandMessage` interface. + * For example, the Spine Base project introduces the `io.spine.base.CommandMessage` interface. * There are no command messages generated in the Base project because it does not provide any * backend API. The interface is used by multiple subprojects of the Spine SDK that depend - * on Base, but it is not used withing the project. + * on Base, but it is not used within the project. * Annotating the interface with `GeneratedMixin` addresses the issue. * * ## Creating a mixin interface diff --git a/base/build.gradle.kts b/base/build.gradle.kts index 6be73a1bd4..6014961fea 100644 --- a/base/build.gradle.kts +++ b/base/build.gradle.kts @@ -117,7 +117,7 @@ protobuf { } /** - * Remove the code generated for Google Protobuf library types. + * Removes the code generated for Google Protobuf library types. * * The code for the `com.google` package was generated because we wanted * to have descriptors for all the types, including those from Google Protobuf library. @@ -150,7 +150,7 @@ private val Project.generatedDir /** * Obtains the `generated` directory for the source set of the task. * - * If [language] is specified returns the subdirectory for this language. + * If [language] is specified, returns the subdirectory for this language. */ private fun GenerateProtoTask.generatedDir(language: String = ""): File { val path = "${project.generatedDir}/${sourceSet.name}/$language" diff --git a/base/src/main/java/io/spine/base/Errors.java b/base/src/main/java/io/spine/base/Errors.java index 69662629dc..f147eae410 100644 --- a/base/src/main/java/io/spine/base/Errors.java +++ b/base/src/main/java/io/spine/base/Errors.java @@ -1,11 +1,11 @@ /* - * Copyright 2022, 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. * 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 @@ -43,7 +43,7 @@ private Errors() { } /** - * Creates new instance of {@link Error} by the passed {@code Throwable}. + * Creates a new instance of {@link Error} by the passed {@code Throwable}. */ public static Error fromThrowable(Throwable throwable) { var result = toErrorBuilder(throwable); diff --git a/base/src/main/java/io/spine/base/Field.java b/base/src/main/java/io/spine/base/Field.java index 8ce0cae5ba..31ab5855fe 100644 --- a/base/src/main/java/io/spine/base/Field.java +++ b/base/src/main/java/io/spine/base/Field.java @@ -402,7 +402,7 @@ static FieldPath doParse(String fieldPath) { } /** - * If the passed value is {@code EnumValueDescriptor} converts it to the corresponding + * If the passed value is {@code EnumValueDescriptor}, converts it to the corresponding * Java enum value. Otherwise, returns the passed value. * *

{@link Message#getField(FieldDescriptor)} returns {@code EnumValueDescriptor} if @@ -448,7 +448,7 @@ private static Object convertIfEnum(Object currentValue) { return field; } - /** Ensures that the passed filed name does not contain the path separator. */ + /** Ensures that the passed field name does not contain the path separator. */ private static void checkName(String fieldName) { checkNotEmptyOrBlank(fieldName); checkArgument( diff --git a/base/src/main/java/io/spine/base/IdType.java b/base/src/main/java/io/spine/base/IdType.java index aa7127f7c1..492e720fc3 100644 --- a/base/src/main/java/io/spine/base/IdType.java +++ b/base/src/main/java/io/spine/base/IdType.java @@ -284,7 +284,7 @@ static IdType of(I id) { } /** - * Returns {@code true} if the passed instances of {@link Object} matches this + * Returns {@code true} if the passed instance of {@link Object} matches this * type of identifiers; {@code false} otherwise. */ abstract boolean matchValue(I id); diff --git a/base/src/main/java/io/spine/base/Identifier.java b/base/src/main/java/io/spine/base/Identifier.java index b3fd619829..29236aa394 100644 --- a/base/src/main/java/io/spine/base/Identifier.java +++ b/base/src/main/java/io/spine/base/Identifier.java @@ -289,7 +289,7 @@ private static IllegalArgumentException unsupportedClass(Class idClass) { until Java 18. So we link to the class Javadoc where the header comes first. */ public static void checkSupported(Class idClass) { checkNotNull(idClass); - // Even through `getType()` can never return null, we use its return value here + // Even though `getType()` can never return null, we use its return value here // instead of annotating the method so that the returned value can be ignored // just because of this one usage. var type = toType(idClass); @@ -343,7 +343,7 @@ public static boolean isSupportedIdType(FieldDescriptor field) { * Wraps the passed ID value into an instance of {@link Any}. * *

The passed value must be of one of the supported types listed below. - * The type of the value wrapped in to the returned instance is defined by the type + * The type of the value wrapped into the returned instance is defined by the type * of the passed value: *