@neocompose/cli 0.56.0 → 0.57.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neocompose/cli",
-  "version": "0.56.0",
+  "version": "0.57.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.56.0 -->
+<!-- reviewed-through-cli: 0.57.0 -->
 
 # Neo Compose CLI
 
@@ -42,7 +42,10 @@ Those are not part of format 4.
    materialization and whole-graph validation — against the pulled document,
    without prompting, uploading, committing, or rewriting the checkout. Pull
    once with the installed CLI so the workspace carries compatible
-   derived-edge extractor metadata.
+   derived-edge extractor metadata. Pending getters and functions compile before
+   local initializer evaluation, including on a project's first push. Initializers
+   resolve pending value dependencies before their consumers; cyclic dependencies
+   report the participating values.
 6. Push one reviewed atomic change with `neo push`.
    Completion arrives through a live subscription. Progress counts refresh every
    five seconds while the durable job runs; a disconnect does not cancel it.

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.56.0 -->
+<!-- reviewed-through-cli: 0.57.0 -->
 ```
 
 The quoted version above is checked too, so this instruction cannot go stale

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

@@ -201,8 +201,9 @@ it is reset.
 Operator expressions are valid member defaults and store as computed
 initializers, the same way calls do — `public float Derived =
 Flags.Start / Flags.Scale;` is fine. Positions that store no rows still
-require literals: dictionary keys must be string literals and Vector/Color
-components must be numeric literals. When a computed list or dictionary entry
+require literals: dictionary keys must be string literals or enum option
+literals for enum-keyed dictionaries, and Vector/Color components must be numeric
+literals. When a computed list or dictionary entry
 carries an authored `@id`, parenthesize the expression — `@id("row")
 (A.B / A.C)` — so the annotation names the row rather than its left operand.
 

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

@@ -271,8 +271,28 @@ foreach (var item in root.Save.Items) {
 
 A `foreach` receiver must be non-null. It snapshots membership/order once at
 entry, so adding/removing collection rows does not alter the scheduled
-iterations. Dictionary iteration binds values, not keys. The iterator binding
-is read-only, although writes through a writable entry remain valid.
+iterations. `foreach (var value in dictionary)` binds each value. To read keys
+as well, deconstruct a dictionary entry:
+
+```neo
+foreach (var (key, value) in this.Damage) {
+  if (key == ToolType.Pickaxe) {
+    ApplyDamage(value);
+  }
+}
+
+foreach ((ToolType key, float value) in this.Damage) {
+  ApplyDamage(value);
+}
+```
+
+Deconstruction accepts a dictionary local or member path. Assign a computed
+receiver to a local first. It snapshots keys once at loop entry and reads each
+value through `dictionary[key]`; removing a key follows the normal missing-key
+read behavior. Both bindings are read-only, although writes through a writable
+entry remain valid. Enum-keyed dictionaries yield enum keys, including in
+collection lambdas such as `Where((key, value) => key == ToolType.Pickaxe)`
+and `Select((key, value) => key)`. String-keyed dictionaries yield strings.
 
 Use `break` for the nearest loop or switch and `continue` for the nearest
 loop. A `continue` inside a switch nested in a loop continues the loop.

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

@@ -44,6 +44,17 @@ class Assets {
 
 A computed static getter is an alias; it creates neither a binding nor a row.
 
+Enum-keyed dictionaries accept contextual or qualified option keys in defaults
+and stored values:
+
+```neo
+Dictionary<ToolType, float> Damage = { .Pickaxe: 10, ToolType.Axe: 2 };
+```
+
+Pull writes `.Option` for known keys. A quoted raw option ID is also accepted;
+a quoted option name such as `"Pickaxe"` is not an ID. Pull preserves orphaned
+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