koota-kit 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.2.1](https://github.com/jbcom/koota-kit/compare/v0.2.0...v0.2.1) (2026-10-06)
+
+
+### Bug Fixes
+
+* sync the lockfile with the docs sourcey range ([eab4ae1](https://github.com/jbcom/koota-kit/commit/eab4ae1df3194cc1157b2a59ea0b04c3bc5345eb))
+* sync the lockfile with the docs sourcey range ([be276e5](https://github.com/jbcom/koota-kit/commit/be276e52f7d58621fd3730a5762b8c4eccbc5cbb))
+
 ## [0.2.0](https://github.com/jbcom/koota-kit/compare/v0.1.1...v0.2.0) (2026-08-24)
 
 

package/README.md

@@ -137,9 +137,12 @@ the system responsible for acting on the event should drain.
 ## Persistence boundary
 
 `snapshotWorld` stores the clock and both RNG states. It intentionally does not
-serialize entities or traits: those are application data with application-
-specific schemas and migrations. `restoreWorldHeader` validates a parsed save
-before changing the handle and restores atomically.
+serialize immutable seeds, entities, or traits: persist `sim.seeds` beside the
+header so a fresh handle can retain stable derived randomness, and keep entity
+data in application-specific schemas and migrations. Stage a fresh handle when
+loading so old scratch caches and event logs cannot leak into the restored run.
+`restoreWorldHeader` validates a parsed save before changing that staged handle
+and restores atomically.
 
 Persist a version beside the header and your ECS state so the application can
 migrate its own schema.
@@ -159,6 +162,11 @@ See the [API reference](./docs/API.md) for signatures and validation behavior,
 and [architecture notes](./docs/ARCHITECTURE.md) for module boundaries and
 invariants.
 
+For task-oriented usage, read the Sourcey guides on
+[deterministic randomness](https://jonbogaty.com/koota-kit/determinism/),
+[save headers](https://jonbogaty.com/koota-kit/persistence/), and
+[event ownership](https://jonbogaty.com/koota-kit/event-logs/).
+
 ## Errors and edge cases
 
 - Seeds must be strings or finite numbers.

package/docs/API.md

@@ -43,9 +43,11 @@ function restoreWorldHeader(handle: WorldHandle, snapshot: WorldSnapshot): void;
 ```
 
 Snapshots and restores both RNG streams plus the simulation clock. The plain
-object can be round-tripped through JSON. Entity and trait data are outside
-this package's persistence boundary. Restore validates the complete replacement
-before mutating the handle.
+object can be round-tripped through JSON. It does not include `WorldHandle.seeds`:
+persist the immutable seeds separately and use them when creating a fresh
+handle for loading. Entity and trait data are also outside this package's
+persistence boundary. Restore validates the complete replacement before
+mutating the handle.
 
 ### Koota exports
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koota-kit",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Deterministic Koota simulation conventions: world lifecycle, dual RNG streams, safe object traits, and world-scoped event logs.",
   "type": "module",
   "license": "MIT",

package/docs/changelog.md

@@ -1,13 +0,0 @@
----
-title: Changelog
-description: Release history maintained by Release Please from Conventional Commits.
----
-
-Release Please maintains the canonical
-[CHANGELOG.md](https://github.com/jbcom/koota-kit/blob/main/CHANGELOG.md),
-version metadata, tags, and GitHub Releases. Published releases use npm
-provenance and the project supports the latest `0.x` line.
-
-For planned changes, use a Conventional Commit type such as `fix:`, `feat:`,
-`docs:`, `refactor:`, `test:`, or `chore:`. Breaking public API changes need a
-`!` or `BREAKING CHANGE:` footer.