@neocompose/cli 0.81.0 → 0.81.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neocompose/cli",
-  "version": "0.81.0",
+  "version": "0.81.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.81.0 -->
+<!-- reviewed-through-cli: 0.81.1 -->
 
 # Neo Compose CLI
 

package/skills/neocompose-cli/references/animation-and-world-authoring.md

@@ -157,6 +157,14 @@ NeoVariant<ExampleObject> Down = new(
   deltas over existing instances. They may use inferred `new { ... }` or
   explicit `new Partial<T> { ... }`, and never pass arguments to or invoke
   `T`'s constructor—even when `T` has a required constructor.
+- `Variants.X.Initialize()` runs `initialize`, then `overrides` and child
+  overrides. `ToVariant` runs `apply`, then `overrides` and child overrides; it
+  never reruns `initialize`. An instance remembers both: the variant that built
+  it and the variant last applied. The applied variant's overrides win where
+  they answer, `apply` writes stay as instance overrides, and
+  `ToVariant(Base)` removes the applied layer. On an object nested inside
+  another instance's construction, `ToVariant` applies the layers in place and
+  records nothing.
 
 Folders are records too, declared as their own globals and assigned per
 variant. Nesting is spelled in the path with `/`; intermediate segments are

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

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

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

@@ -35,8 +35,9 @@ names with readable ones. It keeps chosen names and rewrites references. Use
 declaration file grouping already recorded by the workspace, while
 declarations with no prior placement use the canonical per-declaration layout. Use `--force` only to discard local edits for the server
 version. Normal pulls persist a transaction cursor and fetch only changed
-records. Dictionary string keys, including Unicode, round-trip through full and
-incremental reads. If the remote head is unchanged, pull preserves the local source
+records. Dictionary string keys, including Unicode, `_id`, `$name`, and `__proto__`,
+round-trip through full and incremental reads. String keys may be empty or contain
+whitespace; enum keys must name a live enum option. 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

package/skills/neocompose-cli/references/values-identities-and-references.md

@@ -278,11 +278,14 @@ rows stay reachable through the creation data that already named them.
 
 Defaulted members may be added without recreating existing instances, including
 instances whose sparse arguments are retained only as constructor data.
-A construction whose durable constructor arguments changed, whose
-class changed, or which predates a required constructor parameter fails with
-`construction-arguments-conflict` instead of silently replaying a different
-recipe. Edit members supported by the recorded construction, or delete and
-recreate the value.
+Source is authoritative for a construction: editing its constructor arguments,
+including a static's, rebuilds the instance in place on push. The value keeps
+its ID, rows at unchanged positions keep theirs, added entries create rows,
+removed entries delete them, and the stored creation data records the new
+arguments. Overrides the rebuilt construction no longer produces are deleted,
+so keep them in the construction's `{ ... }` block. A construction whose class
+changed fails with `construction-arguments-conflict`; delete and recreate the
+value to change its class.
 
 Write main-locale text directly in localizable string initializers. Pull/lower
 retargets only the edited assignment. Equal primary-locale text on the same