updates golden file generation to work on clsuters and updates readme with instructions to pull the submodules for gtest

Author: skyler-ruiter

CMakeLists.txt

@@ -97,8 +97,9 @@ if(BUILD_TESTING)
     # ── generate_golden_files target ─────────────────────────────────────────
     # Builds and runs the golden-file generator so that tests/golden/ contains
     # fresh reference files matching the current FZM format version.
+    # EXCLUDE_FROM_ALL keeps cluster/head-node default builds GPU-free.
     # Usage: cmake --build <build-dir> --target generate_golden_files
-    add_executable(generate_golden_files
+    add_executable(generate_golden_files EXCLUDE_FROM_ALL
         tests/golden/regenerate.cpp
     )
     target_link_libraries(generate_golden_files PRIVATE fzgmod)
@@ -107,7 +108,7 @@ if(BUILD_TESTING)
     )
     # After the binary is built, immediately run it to write the reference files.
     add_custom_command(TARGET generate_golden_files POST_BUILD
-        COMMAND generate_golden_files
+      COMMAND $<TARGET_FILE:generate_golden_files>
                 "${CMAKE_CURRENT_SOURCE_DIR}/tests/golden"
         COMMENT "Generating golden reference FZM files in tests/golden/"
         VERBATIM

README.md

@@ -103,6 +103,8 @@ See `examples/caller_allocated_output.cpp` for a minimal end-to-end example.
 ## Building from Source
 
 ```bash
+git clone https://github.com/szcompressor/FZGPUModules.git
+git submodule update --init --recursive
 cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
 cmake --build build -j
 ```

tests/golden/README.md

@@ -34,6 +34,10 @@ cmake --preset release
 cmake --build --preset release --target generate_golden_files
 ```
 
+`generate_golden_files` is intentionally excluded from the default `all` build.
+This keeps head/login-node builds on clusters GPU-free while still allowing
+explicit regeneration on GPU-capable nodes or GPU CI jobs.
+
 This runs `tests/golden/regenerate` which writes fresh reference files to this
 directory.  Commit the new files alongside the version bump.