@neocompose/cli 0.68.1 → 0.68.3

package/dist/test-worker.mjs

@@ -49549,6 +49549,12 @@ var SOURCE_TYPE_NAME_BY_MEMBER_KIND_NUMBER = new Map(
   ])
 );
 
+// src/project-source/value-sources.ts
+var INITIALIZER_KEY_PLACEHOLDER = new RegExp(
+  `${PENDING_ID_PREFIX}reference-key:init:\\d+`,
+  "g"
+);
+
 // src/project-manifest/record-adapters/enum.ts
 var ENUM_SCHEMA_RECORD_ADAPTER = {
   recordKind: "enum",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neocompose/cli",
-  "version": "0.68.1",
+  "version": "0.68.3",
   "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.68.1 -->
+<!-- reviewed-through-cli: 0.68.3 -->
 
 # Neo Compose CLI
 
@@ -63,8 +63,9 @@ opaque JSON or guessed syntax.
   values, files, or other records. `@system` is reserved for platform-owned
   system records; authoring it can make the record uneditable.
 - Preserve existing `@id` annotations through rename, reorder, and file moves.
-  A new row cannot reuse a stored row's `@id`, including inside a new parent:
-  author the new row without it.
+  A copy must get a new ID. A stored nested class value may keep its UUID-v4
+  when moved between compatible empty fields on existing parents, provided
+  its old parent no longer declares it. See the identity reference for limits.
 - Omit `@id` on new ordinary declarations and nested rows unless a same-push
   structural reference genuinely requires an explicit UUID. A successful push
   assigns the durable IDs and rewrites source.

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

@@ -78,7 +78,7 @@ run with `npm run lint:architecture`.
 
 Keep project context refreshable without accumulating stale Monaco providers or
 LSP state. Preserve diagnostics, completion, hover, signatures, definition,
-references, rename, symbols, semantic tokens, code actions, and formatting
+references, implementations, rename, symbols, semantic tokens, code actions, and formatting
 parity for `.neo` and `.neoflow`.
 
 The CLI prepares every push with the server's own preparation code: it
@@ -110,7 +110,7 @@ wrappers.
 The marker near the top of `SKILL.md` must exactly match the package version:
 
 ```html
-<!-- reviewed-through-cli: 0.68.1 -->
+<!-- reviewed-through-cli: 0.68.3 -->
 ```
 
 The quoted version above is checked too, so this instruction cannot go stale

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

@@ -57,12 +57,33 @@ keys as quoted IDs when their option has been deleted.
 
 ## Identity rules
 
-Preserve every existing ID through rename, reorder, and file moves. A new row
-cannot reuse a stored row's `@id`, including inside a new parent, and source
-cannot place one stored row in two collection positions. For a new ordinary record, omit
+Preserve every existing ID through rename, reorder, and file moves. A copy
+must get a new ID. A stored nested class value may keep its UUID-v4 when moved
+to an empty, compatible class field on another existing parent. Remove its
+old owning declaration in the same push. Both fields must declare the same
+non-generic class and storage rules. The move must leave exactly one owning
+path to the same root or static binding through ordinary class fields.
+Both ownership paths must use inherited storage and automatic distribution;
+member overrides are not supported for moves. Moving
+projected values, constructor-owned slots, partitioned values, generic
+instances, or unordered-list entries is refused. Moves into newly constructed
+parents are also refused; omit the ID to create a new value there.
+
+For a new ordinary record, omit
 `@id` and let a successful real push assign and insert it. Dry-run and failed pushes
 leave tracked source unchanged.
 
+A local initializer's existing row ID may precede its variable declaration:
+
+```neo
+@id("existing-quest-row-id")
+Quest HardAsStone = new Quest() { Name = "Hard as stone" };
+```
+
+This names the initializer row. It does not create a stored global. The inline
+`Quest HardAsStone = @id("...") new Quest();` spelling is also accepted, and
+formatting moves its ID above the declaration. Do not put an ID in both places.
+
 Nested class/list rows remain independently addressable and keep inline IDs:
 
 ```neo
@@ -80,6 +101,11 @@ form, an author may assign a previously unseen UUID-v4 with `@id` to the new
 row and reference it in the same edit. Reusing an existing ID means update, not
 create. The server validates authored new IDs for UUID-v4 shape and uniqueness.
 Prefer generated IDs unless the structural reference needs an ID immediately.
+Dry-run preserves a valid authored UUID-v4 ID on a new nested member or dictionary
+value, including one declared as a local initializer. An unknown malformed member
+value ID is an error at its annotation; remove `@id` to let push assign the ID,
+or supply an unused UUID v4. This does not change the derived identity of a
+root/static binding or an existing projected value.
 
 Do not invent IDs for structural rows whose identities derive from an owner
 role. Do not add a separate root/static initializer ID. A constructor argument