refactor(core)!: nest all packages under io.github.dfa1.vortex.core.*

Everything the vortex-core module ships now lives under a single
`io.github.dfa1.vortex.core.*` namespace, so the artifact maps cleanly to its
package root, and the formerly-flat `core`/`encoding`/`extension` packages are
regrouped by concern:

  core.model    DType, PType, TimeUnit, EncodingId, ExtensionId, Time{,stamp}Dtype
  core.io       IoBounds, PTypeIO, VortexFormat
  core.error    VortexException   (room for an exception hierarchy, future ADR)
  core.compute  FastLanes, PrimitiveArrays
  core.fbs      generated FlatBuffers + Fbs* runtime
  core.proto    generated Protobuf + Proto* runtime

The `.fbs` namespaces and `.proto` java_package options moved with them, so
regeneration reproduces the wire codecs in the new location (byte-identical).
pom regenerate-sources out-paths, the javadoc excludePackageNames, and the
pitest target classes are repointed; CLAUDE.md and the docs/ADR references are
updated.

BREAKING CHANGE: consumers importing core types must update imports, e.g.
io.github.dfa1.vortex.core.DType -> io.github.dfa1.vortex.core.model.DType.

Verified: full build, all unit tests, 275 Rust-oracle integration tests green.

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

Author: dfa1

CHANGELOG.md

@@ -15,6 +15,7 @@ Vortex now ships with **no FlatBuffers or Protobuf runtime dependency**: the `.f
 
 ### Changed
 
+- **Breaking:** every `vortex-core` type now lives under `io.github.dfa1.vortex.core.*` — `core.model` (`DType`, `PType`, `TimeUnit`, `EncodingId`, `ExtensionId`, `TimeDtype`, `TimestampDtype`), `core.io` (`IoBounds`, `PTypeIO`, `VortexFormat`), `core.error` (`VortexException`), `core.compute` (`FastLanes`, `PrimitiveArrays`), and `core.fbs` / `core.proto` for the wire codecs. Update imports accordingly (e.g. `io.github.dfa1.vortex.core.DType` → `io.github.dfa1.vortex.core.model.DType`).
 - Removed the `com.google.flatbuffers:flatbuffers-java` runtime dependency. The `.fbs`/`.proto` schemas are now compiled in-house to `MemorySegment`-native Java, dropping the last automatic-module dependency so a named JPMS `module-info` is viable (ADR 0017).
 - Generated FlatBuffers/Protobuf wire classes are prefixed `Fbs*`/`Proto*`, so the generic type names (`Array`, `Buffer`, `DType`, `Null`, …) no longer collide on the consumer classpath.
 

CLAUDE.md

@@ -22,8 +22,12 @@ Benchmark classes follow this: `JavaVsJni{Read,Write,Filter}Benchmark`,
 ## Module structure
 
 ```
-core    — DType, PType, VortexException, VortexFormat + generated fbs/proto
-          encoding: EncodingId, TimeUnit, PTypeIO   extension: ExtensionId
+core    — everything lives under `io.github.dfa1.vortex.core.*`:
+          core.model    DType, PType, TimeUnit, EncodingId, ExtensionId, TimeDtype, TimestampDtype
+          core.io       IoBounds, PTypeIO, VortexFormat
+          core.error    VortexException
+          core.compute  FastLanes, PrimitiveArrays
+          core.fbs / core.proto — generated wire codecs + their runtimes
 reader  — VortexReader, VortexHttpReader, VortexHandle, ReadRegistry, ExtensionDecoder,
           Chunk, ArrayStats, ScanOptions, RowFilter; file internals (Footer, Layout, Trailer,
           PostscriptParser, …)
@@ -71,7 +75,7 @@ Both schema languages are compiled in-process to MemorySegment-native Java, with
 `flatc`/`protoc` and no `com.google.flatbuffers`/`protobuf-java` runtime (ADR 0017):
 - **`.fbs` → `fbs-gen`** (`io.github.dfa1.vortex.fbsgen`): generates readers extending
   `FbsTable`/`FbsStruct` and builders over `FbsBuilder`, all in the same generated package
-  `io.github.dfa1.vortex.fbs`. The runtime base classes `FbsTable`/`FbsStruct` are
+  `io.github.dfa1.vortex.core.fbs`. The runtime base classes `FbsTable`/`FbsStruct` are
   package-private (only generated readers extend them); `FbsBuilder` is public because the
   writer module assembles FlatBuffers with it.
 - **`.proto` → `proto-gen`**: one record per message with static `decode(MemorySegment, long,
@@ -246,7 +250,7 @@ MemorySegment metaSeg = MemorySegment.ofBuffer(ctx.metadata().duplicate());
 FooMetadata meta = FooMetadata.decode(metaSeg, 0, metaSeg.byteSize());
 ```
 
-Generated proto records live in `io.github.dfa1.vortex.proto`; the runtime (`ProtoReader`,
+Generated proto records live in `io.github.dfa1.vortex.core.proto`; the runtime (`ProtoReader`,
 `ProtoWriter`) is package-private. For oneof messages (e.g. `ScalarValue`) prefer the static
 `ofXxxValue(v)` factory over the multi-arg constructor.
 

SECURITY.md

@@ -34,7 +34,7 @@ Maven Central metadata.
 In scope:
 
 - Any malformed `.vortex` input that causes the reader to throw an exception other than
-  `io.github.dfa1.vortex.core.VortexException` (e.g. `IndexOutOfBoundsException`,
+  `io.github.dfa1.vortex.core.error.VortexException` (e.g. `IndexOutOfBoundsException`,
   `NegativeArraySizeException`, `OutOfMemoryError`, `StackOverflowError`, raw FlatBuffer
   runtime exceptions, raw `IOException` from the proto3 reader, or a JVM crash via the FFM layer).
 - Any malformed `.vortex` input that causes the reader to allocate memory disproportionate

cli/src/main/java/io/github/dfa1/vortex/cli/FilterCommand.java

@@ -56,7 +56,7 @@ static int run(String[] args) {
             CsvExporter.exportCsvFiltered(path, stdout, ExportOptions.defaults(), scanOptions, rowPred);
             stdout.flush();
             return ExitStatus.OK;
-        } catch (IOException | io.github.dfa1.vortex.core.VortexException e) {
+        } catch (IOException | io.github.dfa1.vortex.core.error.VortexException e) {
             // VortexException is unchecked but surfaces user-facing failures (e.g. unknown
             // column on a typo'd filter); catching it here keeps the CLI from dumping a
             // stack trace and lets shell pipelines branch on the exit code.

cli/src/main/java/io/github/dfa1/vortex/cli/SchemaCommand.java

@@ -1,6 +1,6 @@
 package io.github.dfa1.vortex.cli;
 
-import io.github.dfa1.vortex.core.DType;
+import io.github.dfa1.vortex.core.model.DType;
 import io.github.dfa1.vortex.reader.VortexReader;
 
 import java.io.IOException;

cli/src/main/java/io/github/dfa1/vortex/cli/StatsCommand.java

@@ -1,7 +1,7 @@
 package io.github.dfa1.vortex.cli;
 
 import io.github.dfa1.vortex.reader.ArrayStats;
-import io.github.dfa1.vortex.core.DType;
+import io.github.dfa1.vortex.core.model.DType;
 import io.github.dfa1.vortex.reader.VortexReader;
 
 import java.io.IOException;

cli/src/main/java/io/github/dfa1/vortex/cli/tui/GridRender.java

@@ -1,7 +1,7 @@
 package io.github.dfa1.vortex.cli.tui;
 
-import io.github.dfa1.vortex.core.DType;
-import io.github.dfa1.vortex.extension.ExtensionId;
+import io.github.dfa1.vortex.core.model.DType;
+import io.github.dfa1.vortex.core.model.ExtensionId;
 import io.github.dfa1.vortex.reader.array.Array;
 import io.github.dfa1.vortex.reader.array.BoolArray;
 import io.github.dfa1.vortex.reader.array.ByteArray;

cli/src/main/java/io/github/dfa1/vortex/cli/tui/InspectorRender.java

@@ -1,7 +1,7 @@
 package io.github.dfa1.vortex.cli.tui;
 
-import io.github.dfa1.vortex.core.DType;
-import io.github.dfa1.vortex.extension.ExtensionId;
+import io.github.dfa1.vortex.core.model.DType;
+import io.github.dfa1.vortex.core.model.ExtensionId;
 import io.github.dfa1.vortex.reader.array.Array;
 import io.github.dfa1.vortex.reader.array.BoolArray;
 import io.github.dfa1.vortex.reader.array.ByteArray;

cli/src/main/java/io/github/dfa1/vortex/cli/tui/LazyGridSource.java

@@ -1,7 +1,7 @@
 package io.github.dfa1.vortex.cli.tui;
 
-import io.github.dfa1.vortex.core.DType;
-import io.github.dfa1.vortex.core.VortexException;
+import io.github.dfa1.vortex.core.model.DType;
+import io.github.dfa1.vortex.core.error.VortexException;
 import io.github.dfa1.vortex.reader.Chunk;
 import io.github.dfa1.vortex.reader.ScanIterator;
 import io.github.dfa1.vortex.reader.ScanOptions;

cli/src/main/java/io/github/dfa1/vortex/cli/tui/VortexInspectorTui.java

@@ -2,7 +2,7 @@
 
 import io.github.dfa1.vortex.reader.Layout;
 import io.github.dfa1.vortex.reader.SegmentSpec;
-import io.github.dfa1.vortex.core.DType;
+import io.github.dfa1.vortex.core.model.DType;
 import io.github.dfa1.vortex.reader.array.Array;
 import io.github.dfa1.vortex.cli.tui.term.Ansi;
 import io.github.dfa1.vortex.cli.tui.term.Key;