Release prep: org.gamecult.cultlib 2.0.0 and org.gamecult.caching.unity 2.0.0 versions, changelogs, install docs

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

docs/nuget-packaging.md

@@ -25,5 +25,5 @@ closure through UPM rather than NuGet restore.
 Install the Unity package from the immutable release tag:
 
 ```text
-https://github.com/GameCult/CultLib.git?path=/unity/org.gamecult.cultlib#cultlib-unity-v1.0.57
+https://github.com/GameCult/CultLib.git?path=/unity/org.gamecult.cultlib#cultlib-unity-v2.0.0
 ```

src/GameCult.Unity/Assets/Caching/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 All notable changes to this package are documented in this file.
 
+## [2.0.0]
+
+### Breaking
+
+- Requires `org.gamecult.cultlib` 2.0.0. Unity Package Manager resolves one
+  cultlib per project, so taking this release moves the project to cultlib 2.0.0.
+
+### Added
+
+- Studio grouping tree: types a document model groups appear under their group,
+  with create in group.
+- Dragging a source record onto a reference field sets the reference.
+
 ## [1.4.0]
 
 ### Added

src/GameCult.Unity/Assets/Caching/package.json

@@ -1,7 +1,7 @@
 {
     "name": "org.gamecult.caching.unity",
     "displayName": "GameCult CultCache Unity Tools",
-    "version": "1.4.0",
+    "version": "2.0.0",
     "unity": "2021.3",
     "description": "Unity editor tooling for inspecting and editing CultCache .cc stores.",
     "keywords": [
@@ -10,7 +10,7 @@
         "Data"
     ],
     "dependencies": {
-        "org.gamecult.cultlib": "1.0.60"
+        "org.gamecult.cultlib": "2.0.0"
     },
     "license": "MIT",
     "category": "Scripting"

unity/org.gamecult.cultlib/CHANGELOG.md

@@ -2,7 +2,7 @@
 
 All notable changes to this package are documented in this file.
 
-## [Unreleased]
+## [2.0.0] - 2026-10-22
 
 ### Breaking
 
@@ -24,6 +24,58 @@ All notable changes to this package are documented in this file.
   open or pull must catch `InvalidDataException`. An arm key outside Int32 or not
   an integer is refused with the same union-naming refusal, and a variant
   override holding an unknown arm names the schema id.
+- Removed or retyped public API, each with its replacement (measured against 1.0.61):
+  - `GameCult.Caching`: the `CultCache(CultDocumentRegistry?)` constructor is now
+    `CultCache(CultDocumentRegistry? registry = null, CultCodec? codec = null)`; code
+    that bound the old signature by reflection or a method group must rebind.
+    `CacheBackingStore.ToStoredDocument(CultPersistedRecord, IReadOnlyCollection<..>, ..)`
+    gains an `out` report of the schema drift it shed. The
+    `CultInspectorModel(registry, Func serialize, Func deserialize)` constructor is
+    now `CultInspectorModel(registry, CultCodec codec)`.
+  - `GameCult.Mesh`: `CultMeshPeerSnapshotDocumentOptions.SchemaIds`,
+    `CultMeshSnapshotRequestOptions.SchemaIds` and `.RecordKeys` are removed; set
+    `Selection` (a `CultNetSelection`) instead. `CultMeshHotBodySubscription.SchemaIds`
+    and `.RecordKeys` are removed; read `Selection`.
+  - `GameCult.Networking`: `CultNetDatabaseSubscriptionServer` no longer takes the
+    `projectRecord` constructor argument; a subscription is narrowed by its
+    selection and `authorizeRecord`.
+  - `InitialSequence` is `uint?` instead of `uint` on `CultMeshRudpSocketOptions`,
+    `RudpCultNetSchemaServerOptions`, `CultNetRudpSessionOptions`,
+    `CultNetRudpSocketTransportOptions` and `CultNetRudpSocketTransportServerOptions`.
+    Unset, a session draws a random initial sequence in [1, 2^31) (the old defaults
+    were 1 and 100); set a value to keep a fixed one.
+- A data member aliased the same name as a reference member in one document type
+  (for example a member aliased `Owner` beside a reference member named `Owner`)
+  used to register and is now refused at registration, naming the clash.
+- A store header other than one this runtime knows, and a record with more slots
+  than its header allows, are refused by name on read instead of being skipped or
+  read as `cultcache.store.v1`. A reader from before this change silently dropped
+  the extra slot (for example a variant) and the next save wrote the loss back.
+  `cultcache.store.v1` and `cultcache.store.v2` are the formats this release reads;
+  a store stamped with a newer one is refused, so this release never rewrites it.
+- `CultNetDatabase.PutAsync` and `DeleteAsync` for a schema no shard owns throw
+  `CultNetUnownedSchemaException` (an `InvalidOperationException` naming the schema)
+  before the cache is touched. They used to cache the write and never log it. The
+  fallback shard is gone: a database with shards that do not cover a schema serves
+  and writes only what its shards own.
+- RUDP: `CultMeshRudpSocketOptions.BindHost` is nullable and unset by default. A
+  client now binds loopback for a loopback endpoint and the unspecified address of
+  the endpoint's family otherwise (it used to bind `0.0.0.0` for every client, so an
+  IPv6 endpoint could not be reached); a server still binds `0.0.0.0`. An explicit
+  `BindHost` wins for both.
+- RUDP wire behaviour changed in step across the C#, Rust, TypeScript and Python
+  runtimes: one received-through watermark per session owns ordered delivery; a
+  Connect repeats only when it carries the sequence that opened the generation, and
+  reliable data before the handshake is neither acknowledged nor delivered; the
+  sender admits a packet only within 1,023 sequences and 4 MiB above the lowest
+  unacknowledged one. A peer on 1.0.x interoperates only for traffic that stays
+  inside those bounds.
+- Variants (record-level wire and store format): a store holding at least one
+  variant declares `cultcache.store.v2` and its variant records carry a fifth slot.
+  A reader from before this change refuses the store (unknown header) rather than
+  reading it. A store with no variant stays `cultcache.store.v1`, byte-identical to
+  1.0.x. CultMesh single-file reads, the directory store and CultNet refuse a variant
+  record by name; only the C# CultCache resolves variants.
 
 ### Added
 
@@ -38,8 +90,29 @@ All notable changes to this package are documented in this file.
   in its own `Entries`. The single-file and directory stores mark every record
   they rewrite; a custom store calls it for each record its own write rewrote.
 
+- Variants: a record that stores only its difference from a base record, resolved in
+  memory when the cache admits it (`cultcache.store.v2`; see the persistence-format
+  contract). A plain write at a variant's key is refused, and `Flatten` replaces a
+  variant with a plain record.
+- CultNet selection v1: one `CultNetSelection` shape and evaluator (schemas, keys,
+  field predicates, cites, cursors) used by CultMesh snapshot requests, the database
+  server and subscriptions, with typed refusals and row identity of
+  `(schemaId, recordKey)`. v0 filters are lowered onto it with their pre-existing
+  answers.
+- Record grouping: a document type declares its inspector group, and the inspector
+  model exposes the group tree, create-in-group and reference labels.
+- `CultMath` value types have canonical MessagePack formatters and `System.Text.Json`
+  converters, including `CultPhasor`, `CultSiteCells`, `SpanNoise`, `SpanPath`,
+  `SpanStage` and the `ExprGraph` expression graph resolver.
+- CultNet publishes every committed cache change once, in `Sequence` order, from the
+  cache journal; `CultNetDatabase.Dispose` publishes what a writer logged and had
+  not yet published.
+- `CultCache` takes an optional `CultCodec`, and isolates every observer so a
+  throwing one cannot stop the others.
+
 ### Changed
 
+- Requires `org.gamecult.cultmath` exactly 0.5.0.
 - After another writer's whole-file flush or unconditional commit rewrites a
   drifted record under a schema id this cache did not read it under, keeping its
   `storedAt`, an `Expect` captured before fails until this cache re-reads the
@@ -47,6 +120,8 @@ All notable changes to this package are documented in this file.
 
 ### Fixed
 
+- The native QUIC plugins' import settings enable `Standalone: Win64` and disable the
+  32-bit target (the 1.0.61 fix, now on main).
 - `Expect` and `ExpectUnchanged` hold on an unchanged record loaded under
   compatible schema drift (written under one version of its type, read by a
   cache that knows another). Before, they always failed: conditional commit

unity/org.gamecult.cultlib/README.md

@@ -11,19 +11,19 @@ and OpenSSL license notices are included under `Third Party Notices`.
 Build it with `scripts/build-unity-package.ps1`. Do not edit generated plugin
 assemblies in the package output.
 
-Install version `1.0.57` through Unity Package Manager with:
+Install version `2.0.0` through Unity Package Manager with:
 
 ```text
-https://github.com/GameCult/CultLib.git?path=/unity/org.gamecult.cultlib#cultlib-unity-v1.0.57
+https://github.com/GameCult/CultLib.git?path=/unity/org.gamecult.cultlib#cultlib-unity-v2.0.0
 ```
 
-The package depends on `org.gamecult.cultmath` (0.3.0 or later) and does not
+The package depends on `org.gamecult.cultmath` (exactly 0.5.0) and does not
 carry its own `CultMath.dll`. Unity Package Manager resolves git packages only
 from the project manifest, so add CultMath beside CultLib in
 `Packages/manifest.json`:
 
 ```text
-"org.gamecult.cultmath": "https://github.com/GameCult/CultLib.git?path=/packages/cultmath/unity/org.gamecult.cultmath#cultmath-unity-v0.3.0"
+"org.gamecult.cultmath": "https://github.com/GameCult/CultLib.git?path=/packages/cultmath/unity/org.gamecult.cultmath#cultmath-unity-v0.5.0"
 ```
 
 CultMesh chooses mapped memory for reachable same-machine bodies and advertised

unity/org.gamecult.cultlib/package.json

@@ -1,7 +1,7 @@
 {
   "name": "org.gamecult.cultlib",
   "displayName": "CultLib",
-  "version": "1.0.61",
+  "version": "2.0.0",
   "unity": "2021.3",
   "dependencies": {
     "org.gamecult.cultmath": "0.5.0"