@neocompose/cli 0.71.4 → 0.72.1

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## [0.72.1] - 2026-10-07
+
+- Speed up `neo export` and `neo dev`: reuse verified unchanged exports, cache unchanged parsing and preparation work, share dialogue compiler symbols, and index Unity generation. Regenerate C# only when its schema inputs change; continue validating edited content and repairing changed output files.
+- Reuse current compiled bodies for local tests, recompiling missing or stale member and constructor bodies without rewriting the pulled state.
+- Share prepared commit records across export, tests, and push hooks. Avoid recompiling prepared schema bodies, reuse test preparation in doctor, and retain source analysis when showing status during `neo dev`.
+- Keep source analysis and construction caches across processes and pulls. Reuse unchanged schema analysis after dialogue prose edits, and invalidate construction results when their structural inputs or observed localized values change. Restore missing or modified Unity output files from verified cached bytes.
+- Persist validated source lowering, prepared candidates, animation validation proofs, and Unity builds in a shared file cache. Reuse them in fresh CLI processes, and preserve unaffected export structure across prose-only pulls.
+- Reuse file reachability when construction inputs are unchanged, including dialogue text edits that do not affect file selection.
+- Watch before the initial `neo dev` export, batch saves with a shorter bounded delay, ignore unrelated asset events, and recover after workspace lock failures.
+
+## [0.72.0] - 2026-10-07
+
+- Add the User root and `User` storage for per-player data shared across saves. Every project has `root.User` in its root source, and `@storage(allowed: .User)` marks a User class. A `Root.neo` pulled before the User root reports that it needs `neo pull`.
+- User classes are checked on push: their members can't declare storage, they extend only User classes, they declare no static stored members, and the types they name must be User-safe. Lookups and delegates can't cross between User and Save data.
+- NeoScript in a User class reads only `root.User` and names only User-safe types. Other code reads User data but can't change it.
+- `neo dialogue dryrun` reports a User write from dialogue code, a User class instance placed in Save data, and a Save delegate that references a User row.
+- Export schema 38 requires Neo Compose SDK 0.62.0.
+- Generated Neo source no longer contains whitespace-only lines. Blank lines inside indented root, dialogue, and supplemental blocks are now empty.
+
 ## [0.71.4] - 2026-10-07
 
 - Do not report records already acknowledged by `neo push` as new pull changes. Advance the pull cursor without compiling or rewriting unchanged sources, while retaining concurrent remote changes and reset detection.

package/README.md

@@ -107,6 +107,17 @@ those IDs and receives branch/version switches. `neo export` writes into that
 Unity project; without `unityConfigPath`, it offers to link the config asset
 for this project it finds in the Unity project around the working copy.
 
+Validated source lowering, commit preparation, animation validation, and Unity
+builds live in a shared file cache under `.neo/build/`. A new CLI process can
+reuse them; keeping `neo dev` running is not required. Exact input and dependency
+checks invalidate affected results. Independent dialogue prose changes preserve
+structural work, including a pull that commits those changes. Structural source
+edits still require broader analysis and preparation.
+
+Export checks output bytes and restores missing or modified generated files
+from its cache, without rewriting unchanged files. `neo dev` uses the same
+preparation and export rules after each save.
+
 Pull, push, and export refuse a working copy whose pulled project or version
 differs from the config's, which happens when the asset changes outside the
 CLI. Run `neo branch switch <versionId>` to reset and pull the config's
@@ -234,8 +245,8 @@ Tags = [
 
 `Root.neo` contains the compiler-owned `Root root = new() { ... }` envelope.
 Its member names, types, IDs, lock annotations, and storage settings are
-protected, while the `root.Assets`, `root.Save`, and `root.Session` value
-initializers are editable.
+protected, while the `root.Assets`, `root.Save`, `root.Session`, and
+`root.User` value initializers are editable.
 
 Reusable values are stored static members on ordinary project classes. There
 is no `ValueRegistry` or generated `Values` namespace.