feat(vortex-edition): session-registered editions validated by unit tests

Editions live on the session like encodings do: EditionSession is a
session variable holding the per-session registry of editions and
edition inclusions, populated explicitly at initialization time.
EditionSession::default() seeds the first-party declarations —
core2026.07.0 (a draft until its min_vortex_version is recorded, which
is the act of freezing) and the 32 inclusions for the encodings the
default writer emits — and any crate can declare further inclusions
into a session, so declarations can migrate next to each encoding's
registration.

Declarations are plain constants (EditionId, Edition,
EditionInclusion::new), with correctness enforced by unit tests rather
than macros: EditionId::validate and EditionInclusion::validate check
identifier and version forms, EditionSession::validate checks a whole
registry (undeclared references, drafts-newest chronology, malformed
versions, members requiring a release newer than their edition
declares), and the validate!(CORE_2026_07_0) macro generates a unit
test asserting an edition is well-formed, declared in the default
session, and part of a valid registry. Everything else is computed:
editions(), encodings_in(edition) (membership is inherited by later
editions of the family), and current(family). The intended
core2026.07.0 set is pinned by a golden test.

Signed-off-by: Claude <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KdR42Svu74NcNzC7XJYwLr

Author: claude

Cargo.lock

@@ -8,6 +8,7 @@ members = [
     "vortex-mask",
     "vortex-utils",
     "vortex-session",
+    "vortex-edition",
     "vortex-flatbuffers",
     "vortex-metrics",
     "vortex-io",
@@ -295,6 +296,7 @@ vortex-compute = { version = "0.1.0", path = "./vortex-compute", default-feature
 vortex-datafusion = { version = "0.1.0", path = "./vortex-datafusion", default-features = false }
 vortex-datetime-parts = { version = "0.1.0", path = "./encodings/datetime-parts", default-features = false }
 vortex-decimal-byte-parts = { version = "0.1.0", path = "encodings/decimal-byte-parts", default-features = false }
+vortex-edition = { version = "0.1.0", path = "./vortex-edition", default-features = false }
 vortex-error = { version = "0.1.0", path = "./vortex-error", default-features = false }
 vortex-fastlanes = { version = "0.1.0", path = "./encodings/fastlanes", default-features = false }
 vortex-file = { version = "0.1.0", path = "./vortex-file", default-features = false }

Cargo.toml

@@ -0,0 +1,24 @@
+[package]
+name = "vortex-edition"
+authors.workspace = true
+description = "Definitions of Vortex editions: named, frozen sets of encodings with a read-compatibility guarantee"
+edition = { workspace = true }
+homepage = { workspace = true }
+categories = { workspace = true }
+include = { workspace = true }
+keywords = { workspace = true }
+license = { workspace = true }
+readme = { workspace = true }
+repository = { workspace = true }
+rust-version = { workspace = true }
+version = { workspace = true }
+
+[package.metadata.docs.rs]
+all-features = true
+
+[lints]
+workspace = true
+
+[dependencies]
+parking_lot = { workspace = true }
+vortex-session = { workspace = true }

vortex-edition/Cargo.toml

@@ -0,0 +1,81 @@
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-FileCopyrightText: Copyright the Vortex contributors
+
+//! The first-party edition declarations, seeded into
+//! [`EditionSession::default`](crate::EditionSession).
+//!
+//! Each block declares an edition together with the encodings that join the family at it;
+//! members of earlier editions are inherited and never restated. Correctness is enforced by
+//! unit tests: [`validate!`](crate::validate) covers each declared edition, and the
+//! computed set of a frozen edition is pinned by a golden test, so any change to these
+//! declarations that alters a frozen set fails CI. New encodings are staged into the newest
+//! draft edition. Declarations live centrally here for now; they are expected to migrate
+//! next to each encoding's registration.
+
+use crate::Edition;
+use crate::EditionDeclaration;
+use crate::EditionId;
+
+/// The first edition of the `core` family: the canonical encodings — the uncompressed
+/// representations every logical type decodes to. A draft until the release shipping it is
+/// published and its version is recorded.
+pub const CORE_2026_01_0: EditionId = EditionId::new("core", 2026, 1, 0);
+
+/// The second `core` edition: inherits everything in [`CORE_2026_01_0`] and adds the
+/// container and compressed encodings the default file writer emits. A draft until the
+/// release shipping it is published and its version is recorded.
+pub const CORE_2026_07_0: EditionId = EditionId::new("core", 2026, 7, 0);
+
+/// The first-party editions, each declared together with the encodings it adds.
+pub static DEFAULT_DECLARATIONS: &[EditionDeclaration] = &[
+    EditionDeclaration {
+        edition: Edition {
+            id: CORE_2026_01_0,
+            // TODO(editions): freeze by setting this to the first release shipping this
+            //  edition, once it is published.
+            min_vortex_version: None,
+        },
+        added: &[
+            &"vortex.null",
+            &"vortex.bool",
+            &"vortex.primitive",
+            &"vortex.decimal",
+            &"vortex.varbin",
+            &"vortex.varbinview",
+            &"vortex.list",
+            &"vortex.listview",
+            &"vortex.fixed_size_list",
+            &"vortex.struct",
+            &"vortex.variant",
+            &"vortex.ext",
+        ],
+    },
+    EditionDeclaration {
+        edition: Edition {
+            id: CORE_2026_07_0,
+            min_vortex_version: None,
+        },
+        added: &[
+            &"vortex.chunked",
+            &"vortex.constant",
+            &"vortex.dict",
+            &"vortex.masked",
+            &"vortex.sparse",
+            &"vortex.alp",
+            &"vortex.alprd",
+            &"vortex.bytebool",
+            &"vortex.datetimeparts",
+            &"vortex.decimal_byte_parts",
+            &"vortex.fsst",
+            &"vortex.pco",
+            &"vortex.runend",
+            &"vortex.sequence",
+            &"vortex.zigzag",
+            &"vortex.zstd",
+            &"fastlanes.bitpacked",
+            &"fastlanes.delta",
+            &"fastlanes.for",
+            &"fastlanes.rle",
+        ],
+    },
+];