@neocompose/cli 0.71.3 → 0.72.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neocompose/cli",
-  "version": "0.71.3",
+  "version": "0.72.0",
   "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.3 -->
+<!-- reviewed-through-cli: 0.72.0 -->
 
 # 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.3 -->
+<!-- reviewed-through-cli: 0.72.0 -->
 ```
 
 The quoted version above is checked too, so this instruction cannot go stale

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

@@ -37,6 +37,9 @@ declarations with no prior placement use the canonical per-declaration layout. U
 version. Normal pulls persist a transaction cursor and fetch only changed
 records. If the remote head is unchanged, pull preserves the local source
 without compiling it; use `neo status` to inspect local edits and diagnostics.
+Pull ignores records whose hashes already match the saved server baseline,
+including echoes of this checkout's last push, and advances its cursor without
+compiling or rewriting source. Later remote edits still count as changes.
 An undo/reset metadata change invalidates the cursor and causes a safe
 full-snapshot fallback.
 

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