test: fail loud when the golden corpus is missing (#19)

* test: fail loud when the golden corpus is missing

locateCorpus returned null when third_party/zstd/tests was absent, and
filesIn turned that into an empty stream — so a missing submodule
silently skipped every golden test and still went green. Throw instead:
the corpus is the vendored zstd submodule, so its absence is a setup
error worth surfacing.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* build: enforce the golden corpus exists, with a friendly message

Add maven-enforcer requireFilesExist on third_party/zstd/tests in the
integration-tests module, bound to validate. A missing submodule now
fails the build up front with a message telling the user to run
'git submodule update --init --recursive', instead of failing later.
The runtime IllegalStateException stays as a backstop for direct/IDE runs.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

Author: dfa1

integration-tests/pom.xml

@@ -49,6 +49,44 @@
 		</dependency>
 	</dependencies>
 
+	<build>
+		<plugins>
+			<!-- Fail early, with a clear message, if the vendored zstd submodule
+			     (the golden corpus these tests read) has not been checked out —
+			     before compiling or running anything. -->
+			<plugin>
+				<groupId>org.apache.maven.plugins</groupId>
+				<artifactId>maven-enforcer-plugin</artifactId>
+				<version>3.5.0</version>
+				<executions>
+					<execution>
+						<id>require-golden-corpus</id>
+						<phase>validate</phase>
+						<goals>
+							<goal>enforce</goal>
+						</goals>
+						<configuration>
+							<rules>
+								<requireFilesExist>
+									<files>
+										<file>${maven.multiModuleProjectDirectory}/third_party/zstd/tests</file>
+									</files>
+									<message>
+The golden corpus is missing: third_party/zstd/tests was not found.
+These integration tests read the vendored zstd submodule. Check it out with:
+
+    git submodule update --init --recursive
+
+then re-run the build.</message>
+								</requireFilesExist>
+							</rules>
+						</configuration>
+					</execution>
+				</executions>
+			</plugin>
+		</plugins>
+	</build>
+
 	<!-- The matching native library for the host platform (test scope only). -->
 	<profiles>
 		<!-- Activated by ./mvnw verify -P coverage alongside the parent profile.

integration-tests/src/test/java/io/github/dfa1/zstd/it/GoldenCorpusTest.java

@@ -38,8 +38,9 @@ class GoldenCorpusTest {
 
     private static final Path TESTS = locateCorpus();
 
-    /// Walks up from the working directory to find `third_party/zstd/tests`,
-    /// or returns `null` if the submodule is absent.
+    /// Walks up from the working directory to find `third_party/zstd/tests`.
+    /// The corpus is the vendored zstd submodule, so its absence is a setup
+    /// error — fail loudly rather than silently skipping every golden test.
     private static Path locateCorpus() {
         Path dir = Path.of("").toAbsolutePath();
         for (; dir != null; dir = dir.getParent()) {
@@ -48,13 +49,12 @@ private static Path locateCorpus() {
                 return candidate;
             }
         }
-        return null;
+        throw new IllegalStateException(
+                "golden corpus not found: third_party/zstd/tests is missing — "
+                        + "initialise the zstd submodule (git submodule update --init --recursive)");
     }
 
     private static Stream<Arguments> filesIn(String subdir, String suffix) {
-        if (TESTS == null) {
-            return Stream.empty();
-        }
         Path dir = TESTS.resolve(subdir);
         if (!Files.isDirectory(dir)) {
             return Stream.empty();