@neocompose/cli 0.36.13 → 0.37.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neocompose/cli",
-  "version": "0.36.13",
+  "version": "0.37.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.36.13 -->
+<!-- reviewed-through-cli: 0.37.0 -->
 
 # Neo Compose CLI
 
@@ -132,7 +132,7 @@ completely before editing:
   constructors, declared constructors, settlement, and inheritance.
 - [Values, identities, and references](references/values-identities-and-references.md):
   root/static bindings, nested/list identities, same-push references, unique
-  keys, files, localization, and default materialization.
+  keys, files, localization, and virtual default projection.
 - [Animation and world authoring](references/animation-and-world-authoring.md):
   objects, sorting, optional children, structured leaves, object variants and
   variant folders, partial animation overrides, segments, tracks, and NeoFlow

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

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

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

@@ -101,9 +101,10 @@ Use `.EnumCase` only when context fixes one enum type; otherwise write
 ## Member and relation rules
 
 Infer member kind and optionality from its type and nullability. Treat the
-initializer as its default. Omitted fields materialize their current defaults
-once when an instance is created; later default edits do not mutate existing
-instances.
+initializer as its default. Omitted fields remain virtual and resolve through
+the instance's recorded constructor or variant. They track later source-default
+edits until that field is explicitly overridden; resetting an override makes it
+virtual again.
 
 A lookup member's arity is its declared type. `public Config Config` selects one
 entry and its declared type is the entry type; `public Set<Config> Configs`
@@ -142,9 +143,9 @@ value-level target metadata.
 ## Computed initializers and declared constructors
 
 Use an expression initializer when a member default must be evaluated during
-construction rather than stored as a closed literal. It runs for every newly
-constructed instance in push, web, and SDK contexts; it does not rewrite
-existing saved instances.
+construction rather than stored as a closed literal. It is replayed for omitted
+members in push, web, and SDK contexts. A stored override remains pinned until
+it is reset.
 
 Operator expressions are valid member defaults and store as computed
 initializers, the same way calls do — `public float Derived =

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

@@ -120,20 +120,19 @@ membership rules as member defaults.
 
 ## Defaults and localization
 
-Materialize omitted members from their current defaults only when an instance
-is created. Do not expect later class-default changes to update existing rows.
-Removing an explicitly materialized field from an existing initializer requests
-a reset through the current default; require that change to appear in
-`neo diff`.
-
-Editing an initializer on an already-materialized instance updates the stored
-rows in place: the plan carries leaf updates with stable sub-row ids, never a
-delete-and-recreate, and never strips the instance back to an unconstructed
-value. A construction the stored rows cannot be reprojected onto — one that
-changes durable constructor arguments, swaps the class, or predates a new
-constructor parameter — fails with `construction-arguments-conflict` instead of
-lowering. Edit the instance's members, or delete and recreate the value with the
-new construction.
+Omitted members are virtual projections of the instance's recorded constructor
+or variant. Later edits to that source update every omitted member. Writing a
+member creates a sparse override with its deterministic projected ID; removing
+that member from an existing initializer resets the override and resumes source
+tracking. Require either transition to appear in `neo diff`.
+
+Editing an initializer updates sparse override rows in place: projected member
+IDs remain stable, and omitted virtual rows are never emitted as authored seed
+records. 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.
 
 Write main-locale text directly in localizable string initializers. Pull/lower
 preserves other locales, comments, statuses, archive state, and unrelated