diff --git a/README.md b/README.md
index a32c572..c4072f5 100644
--- a/README.md
+++ b/README.md
@@ -24,7 +24,7 @@ For installation into a Maven project the `provided` scope is recommended so tha
com.diffblue.cover
cover-annotations
- 1.7.0
+ 1.8.0
provided
@@ -36,9 +36,9 @@ For installation into a Gradle project the `compileOnly` and `testImplementation
```
dependencies {
- compileOnly("com.diffblue.cover:cover-annotations:1.7.0")
+ compileOnly("com.diffblue.cover:cover-annotations:1.8.0")
- testImplementation("com.diffblue.cover:cover-annotations:1.7.0")
+ testImplementation("com.diffblue.cover:cover-annotations:1.8.0")
}
```
@@ -343,3 +343,17 @@ public class CarPainter {
}
```
+### Experimental Annotations
+
+Experimental annotations should not be used in a production setting, but are
+included to allow Diffblue to perform experiments with new features.
+
+> [!NOTE]
+> The annotations in the `experimental` package can change at any time.
+>
+> Do not rely on them in production code!
+
+#### Using `@InTestsUseLLM`
+
+Indicates that LLMs can be used in this context.
+
diff --git a/pom.xml b/pom.xml
index 0347d9e..2df075f 100644
--- a/pom.xml
+++ b/pom.xml
@@ -16,7 +16,7 @@
4.0.0
com.diffblue.cover
cover-annotations
- 1.7.0
+ 1.8.0
jar
Cover Annotations
diff --git a/src/main/java/com/diffblue/cover/annotations/experimental/InTestsUseLLM.java b/src/main/java/com/diffblue/cover/annotations/experimental/InTestsUseLLM.java
new file mode 100644
index 0000000..c9ce816
--- /dev/null
+++ b/src/main/java/com/diffblue/cover/annotations/experimental/InTestsUseLLM.java
@@ -0,0 +1,40 @@
+/*
+ * Copyright 2025 Diffblue Limited.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License").
+ * You may not use this file except in compliance with the License.
+ * A copy of the License is located at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * or in the "license" file accompanying this file. This file is distributed
+ * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
+ * express or implied. See the License for the specific language governing
+ * permissions and limitations under the License.
+ */
+package com.diffblue.cover.annotations.experimental;
+
+import static java.lang.annotation.ElementType.METHOD;
+import static java.lang.annotation.ElementType.PACKAGE;
+import static java.lang.annotation.ElementType.PARAMETER;
+import static java.lang.annotation.ElementType.TYPE;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
+
+import java.lang.annotation.Retention;
+import java.lang.annotation.Target;
+
+/**
+ * Indicates the annotated element can request assistance from LLMs.
+ *
+ *
The specific assistance will depend on: the element, what features Diffblue Cover has
+ * implemented, and any number of other things.
+ *
+ *
Note: this annotation may change in the future without further warning.
+ *
+ * @deprecated This annotation is experimental and may change or be removed in future releases. Its
+ * use is discouraged except for internal experimental purposes.
+ */
+@Retention(RUNTIME)
+@Target({PACKAGE, TYPE, METHOD, PARAMETER})
+@Deprecated
+public @interface InTestsUseLLM {}