@neocompose/cli 0.49.0 → 0.50.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neocompose/cli",
-  "version": "0.49.0",
+  "version": "0.50.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.49.0 -->
+<!-- reviewed-through-cli: 0.50.1 -->
 
 # Neo Compose CLI
 

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

@@ -24,6 +24,29 @@ For world layer links, derive a concrete project class from
 `targetLayer` relation. Do not add value-level target metadata or ask painting
 operations to create/repair relation targets.
 
+## Tile placements
+
+Use `@tile(VoidTile)` on a `NeoTileInstance` construction to select its tile
+class. The named spelling `@tile(asset: VoidTile)` is equivalent; the asset is
+required and only the argument label is optional.
+
+```neo
+@tile(VoidTile)
+new NeoTileInstance() {
+  Cell = new(9, -4)
+}
+```
+
+Pull emits the positional spelling. The annotation writes the placement's
+`assetClassId` metadata and does not construct a tile value or add a generic
+argument. The asset must be a concrete, non-generic descendant of `NeoTile`.
+Use the annotation on persisted literal constructions; executable NeoScript
+and evaluated placement constructors reject it.
+The grid's imports and the tile's compatible-layer relations still constrain
+where the placement can be used. Existing placement overrides remain attached
+when the selected asset is unchanged; recreate a placement to change its asset
+when it has overrides or a variant.
+
 ## Object variants
 
 A variant is a named configuration of one `NeoObject`-derived class: how to

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.49.0 -->
+<!-- reviewed-through-cli: 0.50.1 -->
 ```
 
 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,10 @@ bodies affected by changed declarations. Use `--force-recompile` with either a
 dry run or a real push only when diagnosing stale derived IR: it retains the
 exhaustive project-wide body sweep and is intentionally slower.
 
+Changed member bodies and migration bodies share one schema projection and its
+indexes throughout push preparation. Each changed member body is compiled once,
+so a batch of scripted changes does not rebuild the whole schema for every body.
+
 Interactive status, diff, pull, and test commands report workspace loading and
 preparation phases. Spinners continue animating during synchronous compilation;
 `NO_COLOR` removes color without stopping the animation. JSON reporters and