fix(cli): uber-jar bundles libzstd natives for all platforms

The CLI is an application, not a library: it shipped the FFM
binding's classes but not the natives, silently depending on a
system libzstd. zstd-platform (runtime) now rides in the shade —
osx/linux/windows x x86_64/aarch64 all present in the jar, and the
uber-jar reads a vortex.zstd file end-to-end (verified via count
and export). Library modules keep zstd as the documented two-
artifact opt-in.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: dfa1

CHANGELOG.md

@@ -31,6 +31,7 @@ claim measured against the Rust (JNI) oracle; behavior divergences documented in
 
 ### Changed
 
+- The CLI uber-jar is now fully self-contained for `vortex.zstd` files: it bundles the FFM binding's native `libzstd` for all six platforms (osx/linux/windows × x86_64/aarch64) via `zstd-platform` — previously it shipped the binding's classes but relied on a system libzstd. The library modules keep zstd optional. ([pending-cli](https://github.com/dfa1/vortex-java/commits/main))
 - The zstd binding stays a two-artifact opt-in (`io.github.dfa1.zstd:zstd` + `zstd-platform`, both `optional`; no JNI anywhere), and touching `vortex.zstd` without it now fails with an actionable `VortexException` naming the two artifacts to add, instead of a raw `NoClassDefFoundError`. Default write/read paths never touch the binding (measured). ([ae9f95cc](https://github.com/dfa1/vortex-java/commit/ae9f95cc))
 - The little-endian `ValueLayout` constants moved from `PTypeIO.LE_*` to `VortexFormat.LE_*` — endianness is a property of the wire format, not of ptypes, and `VortexFormat` is where format facts live. Six classes that carried private copies (including reversed-name duplicates like `SHORT_LE`) now share the single source; nothing outside `VortexFormat` defines a `withOrder(LITTLE_ENDIAN)` layout. ([c060d34f](https://github.com/dfa1/vortex-java/commit/c060d34f))
 - `Chunk.columns()` returns an order-preserving `SequencedMap<ColumnName, Chunk.Column>` — one map instead of two parallel string-keyed maps, with each column's `Array` and `DType` traveling together in the `Column` carrier. `column(String)` stays as boundary sugar (plus a `column(ColumnName)` overload); iteration order is the schema/projection order, now guaranteed even for 1–2 column chunks. Typed names originate in `ScanIterator` from the file's already-certified schema. ([f8ad15d1](https://github.com/dfa1/vortex-java/commit/f8ad15d1))

cli/pom.xml

@@ -37,6 +37,14 @@
 			<groupId>io.github.dfa1.zstd</groupId>
 			<artifactId>zstd</artifactId>
 		</dependency>
+		<dependency>
+			<!-- The CLI is an application, not a library: the uber-jar must read vortex.zstd
+			     files on a machine with no system libzstd, so the all-platform natives the
+			     FFM binding loads are bundled here (the library modules keep zstd optional). -->
+			<groupId>io.github.dfa1.zstd</groupId>
+			<artifactId>zstd-platform</artifactId>
+			<scope>runtime</scope>
+		</dependency>
 		<dependency>
 			<!-- Required by hardwood-core (via vortex-parquet) for ZSTD-compressed
 			     Parquet files; listed here explicitly so the shade plugin bundles

docs/reference.md

@@ -278,6 +278,10 @@ CSV import is CLI-only — types are inferred from the data.
 
 ## CLI
 
+The `-all` uber-jar is self-contained: pure-Java code plus the native `libzstd` for all
+supported platforms (the FFM loader picks the right one at runtime) — no system libraries
+required.
+
 The `cli` module ships a fat jar with subcommands for inspecting and querying Vortex files.
 
 ```bash