@neocompose/cli 0.58.0 → 0.58.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neocompose/cli",
-  "version": "0.58.0",
+  "version": "0.58.2",
   "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.58.0 -->
+<!-- reviewed-through-cli: 0.58.2 -->
 
 # Neo Compose CLI
 
@@ -63,6 +63,8 @@ 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.
 - 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

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

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

@@ -61,6 +61,11 @@ deliberately replace a checkout whose state is gone, back it up first and use
 `neo pull --force`; the CLI recovers custom paths from the remaining declarations.
 The force pull replaces local source with the server version.
 
+Pull downloads up to eight managed image or audio files concurrently and reuses
+matching local bytes. It verifies all downloads before replacing binaries or
+updating conflict artifacts. A failed transfer leaves existing files intact;
+retry the pull after resolving the reported download error.
+
 Pull pins every page and snapshot batch to one published generation and logical
 revision. If either changes during assembly, the CLI discards the attempt and
 restarts. Upgrade the CLI together with the P83 server read protocol.

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

@@ -57,9 +57,11 @@ keys as quoted IDs when their option has been deleted.
 
 ## Identity rules
 
-Preserve every existing ID through rename, reorder, and file moves. 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.
+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
+`@id` and let a successful real push assign and insert it. Dry-run and failed pushes
+leave tracked source unchanged.
 
 Nested class/list rows remain independently addressable and keep inline IDs: