@neocompose/cli 0.71.4 → 0.72.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neocompose/cli",
-  "version": "0.71.4",
+  "version": "0.72.1",
   "description": "Neo Compose native project-source CLI with bidirectional sync.",
   "license": "MIT",
   "type": "module",

package/skills/neocompose-cli/SKILL.md

@@ -9,7 +9,7 @@ description: >-
   `@neocompose/cli` or `node cli/bin/neo.mjs` in the neo-compose repository.
 ---
 
-<!-- reviewed-through-cli: 0.71.4 -->
+<!-- reviewed-through-cli: 0.72.1 -->
 
 # Neo Compose CLI
 

package/skills/neocompose-cli/references/cli-development.md

@@ -118,7 +118,7 @@ wrappers.
 The marker near the top of `SKILL.md` must exactly match the package version:
 
 ```html
-<!-- reviewed-through-cli: 0.71.4 -->
+<!-- reviewed-through-cli: 0.72.1 -->
 ```
 
 The quoted version above is checked too, so this instruction cannot go stale

package/skills/neocompose-cli/references/commands-and-sync.md

@@ -300,9 +300,11 @@ it into the directories the Unity project's `NeoComposeConfig` asset names:
 `project.json` with a partition index, `Partitions/*.json` holding value rows
 by storage partition, localization files, and generated C# under
 `<generatedTypesDirectory>/Generated/`. It writes only files whose bytes
-changed, skips codegen when only values changed since the last export into
-that Unity project, and writes `Library/NeoCompose/export.json` last for
-Unity to ingest.
+changed, skips codegen when its schema inputs are unchanged, and writes
+`Library/NeoCompose/export.json` last for Unity to ingest. Repeated exports
+verify current inputs and output bytes before reusing the last successful
+export; changed or missing outputs are regenerated. Edited content is validated
+even when C# generation is skipped.
 
 - A clean working copy exports the pulled head. Diagnostic location differences
   alone, including line shifts after push inserts ids, do not make it local.
@@ -313,8 +315,10 @@ Unity to ingest.
 - Ids minted for local declarations are kept in `.neo/export.json`'s
   `identityLedger`, so the push commits the ids Unity already saw. A push
   re-exports into the Unity project a local export went to.
-- `neo dev` runs `neo export` after every change to source, `Files/`,
-  `neo.json`, `.neo/state.json` or the config asset. It never pulls or pushes.
+- `neo dev` watches before its initial export and batches relevant source,
+  binary, ignore-rule, workspace-state, and config changes. It waits for a
+  20 ms quiet period, capped at 250 ms, and processes edits made during an
+  export in the next batch. It never pulls or pushes.
 - Pull, push, branch, merge, resolve, init and export take turns through
   `.neo/workspace.lock`; a lock whose process died is taken over.
 

package/skills/neocompose-cli/references/declarations-and-construction.md

@@ -148,6 +148,24 @@ On a class, `@storage(allowed: .Writable)` means every placement must resolve
 to Save or Session. A subclass may narrow it to `.Save` or `.Session`. An
 undeclared static member of such a class is Session.
 
+`root.User` holds per-player data that every save shares, such as settings.
+Only User classes go under it. Declare one with `@storage(allowed: .User)` on
+the class; its subclasses and base must be User classes too:
+
+```neo
+@storage(allowed: .User)
+class AudioPrefs {
+  public float Volume = 1;
+}
+```
+
+Members of a User class declare no `@storage` and no stored statics, and every
+type they name must be User-safe: primitives, enums, User classes, collections
+and delegates of those, and interfaces whose signatures are User-safe. Code in
+a User class reads only `root.User`. Other code reads `root.User` but can't
+assign, mutate, construct, or invoke User data. Lookups and listeners don't
+cross between User and Save data; Session lookups may target `root.User`.
+
 `@index(member: Field, kind: .Unique)` and
 `@column(member: Field, width: ..., visibility: ..., pin: ..., overflow: ...)`
 are repeatable List annotations. `member:` is a bare field name on the entry