@neocompose/cli 0.47.1 → 0.48.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neocompose/cli",
-  "version": "0.47.1",
+  "version": "0.48.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.47.1 -->
+<!-- reviewed-through-cli: 0.48.1 -->
 
 # Neo Compose CLI
 
@@ -102,9 +102,9 @@ neo/
   neo.json
   Project.neo
   Root.neo
-  Classes/
-  Interfaces/
-  Enums/
+  Classes/{System/, ...}
+  Interfaces/{System/, ...}
+  Enums/{System/, ...}
   Relations.neo
   Templates/
   Localization.neo
@@ -122,9 +122,12 @@ Production `.neo`/`.neoflow` files and supported managed binaries are tracked.
 Colocated `.spec.neo` files are test-only and never enter status, source hashes,
 pull/reset, or push.
 Normal pull preserves declaration placement and spelling by stable ID when it
-can. Force/reset regenerates canonical text while retaining the declaration
-file grouping recorded by the workspace; declarations with no prior placement
-use the canonical per-declaration layout.
+can. Force/reset regenerates canonical text while retaining the current declaration
+paths and extracted initializer bindings, including moves made since the last
+sync. New server declarations use the default layout. System declarations
+default to a `System` subfolder under their category, including classes, enums,
+interfaces, templates, localization statuses, and priority/dialogue groups.
+Ownership comes from the reserved system identity, not the declaration name.
 
 ## Load the focused contract you need
 
@@ -165,7 +168,7 @@ Do not invent lowercase persistence-kind declarations such as `project`,
 `values`, `files`, or `relations`. Named arguments and contextual enum literals
 come from generated contracts; do not invent raw fields or property bags.
 
-Reusable values are static members on ordinary project classes:
+Persisted reusable values are static members on ordinary project classes:
 
 ```neo
 @id("assets-class-id")
@@ -182,6 +185,29 @@ class Assets {
 The member ID anchors the stored binding. A computed static getter is an alias
 and creates no stored binding or value row.
 
+Local project initializers may live in any `.neo` file and need no imports:
+
+```neo
+List<NeoSortingLayer> SORTING_LAYERS = [
+  @id("existing-layer-id")
+  new NeoSortingLayer() { Name = "Default" }
+];
+```
+
+Use `SortingLayers = SORTING_LAYERS` in Root or another stored initializer.
+The consuming member owns the value identity; do not add an ID at the use.
+Preserve existing nested IDs when extracting, and omit IDs on new rows.
+An aggregate has one owning assignment. Use `Reference(SORTING_LAYERS)` only
+where the receiving member permits that reference type. For independent
+copies, use the editor's duplicate action or copy the initializer without IDs.
+Scalars may have several owners. If those values diverge in web, pull keeps
+the different server values by inlining the differing uses. Initializer
+aliases are local source organization, not runtime globals or server records.
+Use their names as complete value initializers; executable expressions such as
+`BASE + 1` cannot access these local declarations.
+The shared editor offers extract-to-file on a selected complete initializer,
+inline on its sole use, and duplicate at a use. Move the created file freely.
+
 Declare managed files in typed registries:
 
 ```neo
@@ -199,7 +225,9 @@ AudioClipRegistry AudioClips = new() {
 ```
 
 Use `Images.Sword.Slice(0)` for a sprite and `AudioClips.SwordHit` for audio.
-Renaming the registry symbol, moving the local presentation, or replacing bytes
+Registry declarations and their image/audio paths may be in any project folder
+outside ignored/private directories. Update the registry path when moving a
+binary file. Renaming the registry symbol or replacing bytes
 retains the file ID.
 Omitting `@settings(template: ...)` uses the complete built-in Unity import
 defaults for that file kind.

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

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

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

@@ -121,6 +121,13 @@ membership rules as member defaults.
 
 ## Defaults and localization
 
+A class member with an empty construction default emits `= new Type()` even
+when its value row is virtual. Edit that declaration with `new() { ... }` to
+change the shared default, or assign the member inside an instance initializer
+to override only that instance. Leaving the emitted construction unchanged
+creates no redundant value rows. A nullable member with no default remains bare;
+an explicit null default emits `= null`.
+
 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