Pre-1.0 reset policy
Grid Toolkit 1.0.0 begins the published 1.x compatibility contract. Prototype, unpublished, preview, and other pre-1.0 builds are not supported as an in-place upgrade source.
API reset
- Remove the old package completely.
- Import 1.0.0 and resolve its dependencies.
- Recompile project integrations against the public 1.0.0 assemblies.
- Replace renamed or removed calls using the 1.0.0 handbook and API reference.
- Replace dependencies on unsupported internal APIs with public 1.0.0 contracts.
- Re-run project tests for previews, apply, revisions, events, rollback, persistence, and renderer binding.
Do not edit the shipped public API to make pre-1.0 project code compile.
Serialized-authoring reset
Pre-1.0 ScriptableObjects, prefabs, scenes, and managed-reference payloads may contain obsolete type names or field layouts.
- Export the game-owned source data you actually need: coordinates, IDs, footprints, placements, policy values, and extension payload data.
- Recreate Grid Toolkit board, structure, setup, policy, resolver, visual, Inventory, and Cell Metadata assets with 1.0.0 types.
- Re-enter or import game-owned data through a project-owned, reviewed migration.
- Validate and build every recreated asset.
- Review serialized diffs and keep the new
.metaGUIDs stable after acceptance.
Do not copy pre-1.0 YAML fields into 1.0.0 assets or assume a missing managed reference is harmless.
Snapshot reset
Do not feed pre-1.0 snapshots to 1.0.0 restoration.
- Start a new save-schema version.
- Discard development snapshots, or parse them with project-owned legacy code into a neutral migration model.
- Construct a valid 1.0.0 snapshot or board through public builders and resolvers.
- Validate the result, restore atomically, and verify revision/event behavior.
- Preserve unknown payloads only when their identity and byte/data contract is explicitly known; preservation does not convert an obsolete payload.
Completion criteria
The reset is complete when:
- no pre-1.0 assemblies remain;
- every integration compiles through public 1.0.0 contracts;
- every recreated authored asset builds without errors;
- old snapshots are rejected or migrated outside Grid Toolkit; and
- project tests cover the new boundary.