fix: oracle formats UINT_32/UINT_64 Parquet columns as unsigned (#253)

INT32/INT64 columns with a UINT_32/UINT_64 Parquet logical-type annotation
were formatted using Integer.toString/Long.toString (signed), which diverges
from the unsigned U32/U64 representation stored in the Vortex file.
Values above Integer.MAX_VALUE (e.g. total_boosters in
covid-world-vaccination-progress) produced the wrong sign.

Fix: detect LogicalType.IntType with isSigned()=false and switch to
Integer.toUnsignedString / Long.toUnsignedString in oracleCell.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: dfa1

CHANGELOG.md

@@ -16,6 +16,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `SparseEncodingDecoder` now asserts exactly two children (`patch_indices`, `patch_values`) and throws `VortexException` on any other count; previously a third child was silently accepted. ([#250](https://github.com/dfa1/vortex-java/issues/250))
 - `DateTimePartsArrays.readLong` now zero-extends unsigned children (`U8`/`U16`/`U32`) instead of sign-extending them; previously a `U16` seconds-within-day value ≥ 32 768 was widened as a negative short, producing a 65 536-second error in the reconstructed timestamp (#252, bi-euro2016 corpus).
 - `RaincloudConformanceIntegrationTest` now writes both the vortex-java and Parquet oracle CSVs to temp files and streams them line-by-line for comparison; previously it materialized both into heap `String` objects, causing OOM for large corpus files (≥157 MB) that were previously hidden by throwing before reaching the corrupted line. ([#254](https://github.com/dfa1/vortex-java/issues/254))
+- `RaincloudConformanceIntegrationTest` oracle now formats `INT32`/`INT64` Parquet columns with a `UINT_32`/`UINT_64` logical-type annotation using `Integer.toUnsignedString`/`Long.toUnsignedString`, matching the unsigned representation that Vortex stores as `U32`/`U64`; previously the Parquet signed interpretation diverged for values above `Integer.MAX_VALUE` (e.g. `total_boosters` in the covid-world-vaccination-progress corpus). ([#253](https://github.com/dfa1/vortex-java/issues/253))
 
 ## [0.12.1] — 2026-07-08
 

integration/src/test/java/io/github/dfa1/vortex/integration/RaincloudConformanceIntegrationTest.java

@@ -2,6 +2,7 @@
 
 import de.siegmar.fastcsv.writer.CsvWriter;
 import dev.hardwood.InputFile;
+import dev.hardwood.metadata.LogicalType;
 import dev.hardwood.metadata.RepetitionType;
 import dev.hardwood.reader.ParquetFileReader;
 import dev.hardwood.reader.RowReader;
@@ -220,6 +221,10 @@ private static void writeOracleCsv(Path parquet, Writer out) throws IOException
     /// null rows export as an empty field, valid rows use the JDK canonical
     /// `toString` of the value.
     ///
+    /// INT32/INT64 columns with a `UINT_32`/`UINT_64` logical-type annotation are treated
+    /// as unsigned so their string representation matches the U32/U64 Vortex columns that
+    /// carry the same bits (#253).
+    ///
     /// @param col  the column schema
     /// @param rows the row reader positioned at the current row
     /// @return the formatted cell string
@@ -228,9 +233,10 @@ private static String oracleCell(ColumnSchema col, RowReader rows) {
         if (col.repetitionType() == RepetitionType.OPTIONAL && rows.isNull(name)) {
             return "";
         }
+        boolean unsignedInt = col.logicalType() instanceof LogicalType.IntType lt && !lt.isSigned();
         return switch (col.type()) {
-            case INT32 -> Integer.toString(rows.getInt(name));
-            case INT64 -> Long.toString(rows.getLong(name));
+            case INT32 -> unsignedInt ? Integer.toUnsignedString(rows.getInt(name)) : Integer.toString(rows.getInt(name));
+            case INT64 -> unsignedInt ? Long.toUnsignedString(rows.getLong(name)) : Long.toString(rows.getLong(name));
             case FLOAT -> Float.toString(rows.getFloat(name));
             case DOUBLE -> Double.toString(rows.getDouble(name));
             case BOOLEAN -> Boolean.toString(rows.getBoolean(name));

integration/src/test/resources/raincloud/expected-status.csv

@@ -82,7 +82,7 @@ coig,untriaged
 coronahack-chest-xraydataset,untriaged
 cosmopedia-stanford,untriaged
 countries-of-the-world,ok
-covid-world-vaccination-progress,gap:253
+covid-world-vaccination-progress,ok
 covid19-data-from-john-hopkins-university,untriaged
 crimes-in-boston,untriaged
 databricks-dolly-15k,untriaged