build: add Lombok 1.18.46 (provided scope) + lombok.config

Cross-repo decision to use Lombok at the latest version for
compile-time generation of equals/hashCode/toString without runtime
reflection. See BAF commit 31eb6ef for the full decision record.

`<scope>provided</scope>` keeps Lombok off the runtime classpath;
`requires static lombok;` in module-info.java keeps it compile-time
only. The new lombok.config pins the standard cross-repo settings
(addLombokGeneratedAnnotation, callSuper = call, stopBubbling).

This commit is dependency-only. Per-class @tostring /
@EqualsAndHashCode adoption is deferred until after the BAF
restoration loop concludes and the user reviews the BAF approach.

https://claude.ai/code/session_01LzoKmqzgtQsELS5tsH4Wog

Author: claude

lombok.config

@@ -0,0 +1,23 @@
+# SPDX-FileCopyrightText: 2026 Bernard Ladenthin <bernard.ladenthin@gmail.com>
+#
+# SPDX-License-Identifier: Apache-2.0
+
+# Stop the config-resolution from bubbling up into parent directories.
+config.stopBubbling = true
+
+# Emit @lombok.Generated on every generated member. SpotBugs / JaCoCo /
+# SonarQube special-case this annotation and skip the synthetic methods
+# from coverage requirements and bug detectors.
+lombok.addLombokGeneratedAnnotation = true
+
+# Default to "call" on @EqualsAndHashCode / @ToString: when extending a
+# non-Object parent we want the parent's state included; failing loud
+# forces an explicit decision per class.
+lombok.equalsAndHashCode.callSuper = call
+lombok.toString.callSuper = call
+
+# Do NOT generate Spring-style @ConstructorProperties; java.beans is not
+# needed by this codebase and pulls in the desktop module on some JDKs.
+lombok.anyConstructor.addConstructorProperties = false
+
+lombok.accessors.flagUsage = ALLOW

pom.xml

@@ -51,6 +51,7 @@ SPDX-License-Identifier: MIT
 	<properties>
 		<jna.version>5.18.1</jna.version>
 		<jspecify.version>1.0.0</jspecify.version>
+		<lombok.version>1.18.46</lombok.version>
 		<errorprone.version>2.49.0</errorprone.version>
 		<nullaway.version>0.13.4</nullaway.version>
 		<checker.version>4.2.0</checker.version>
@@ -100,6 +101,12 @@ SPDX-License-Identifier: MIT
 	</dependencyManagement>
 
 	<dependencies>
+		<dependency>
+			<groupId>org.projectlombok</groupId>
+			<artifactId>lombok</artifactId>
+			<version>${lombok.version}</version>
+			<scope>provided</scope>
+		</dependency>
 		<dependency>
 			<groupId>org.junit.jupiter</groupId>
 			<artifactId>junit-jupiter</artifactId>

src/main/java/module-info.java

@@ -41,6 +41,11 @@
 module net.ladenthin.llama {
     requires static org.jspecify;
 
+    // Lombok is `provided` scope: only used at compile time to generate equals/hashCode/toString.
+    // `requires static` means the runtime does not need the lombok jar on the module path —
+    // the @lombok.Generated annotation carried on generated members has CLASS retention.
+    requires static lombok;
+
     exports net.ladenthin.llama;
     exports net.ladenthin.llama.args;
     exports net.ladenthin.llama.json;