@neocompose/cli 0.70.5 → 0.71.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neocompose/cli",
-  "version": "0.70.5",
+  "version": "0.71.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.70.5 -->
+<!-- reviewed-through-cli: 0.71.1 -->
 
 # Neo Compose CLI
 

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

@@ -57,6 +57,11 @@ CLI 0.61 adds `while` and `do / while` loops, ordinal string `Replace`,
 ordered-list `Insert`, and method calls whose results may be discarded.
 See the [NeoScript reference](neoscript.md) for authoring syntax and limits.
 
+CLI 0.71 adds collection queries, negative declaration patterns, and native
+Debug output with authored stack traces. Compiled test caches include the
+relative spec path because source coordinates are part of the compiled body.
+Keep Debug output on stderr, including during JSON test runs.
+
 ## Shared implementation contract
 
 Manifest contracts, document comparison, normalization, and three-way merge
@@ -90,7 +95,10 @@ bases. A modified CLI can therefore write bad rows to a project its user may
 already write; keep preparation in shared `src/database` code rather than
 forking it in the CLI. The server still verifies a push's uploaded
 project-file bytes, and web editor commits use the shared client preparation protocol.
-Unrelated source files are not uploaded or recompiled on every push. A CLI lowering mismatch on a normal push is exposed by the next
+Unrelated source files are not uploaded or recompiled on every push.
+Optional source maps missing from valid stored bodies do not request a backfill.
+Existing map changes still refresh locations on push; authored edits, dependency
+changes, and explicit forced recompilation retain their normal compile scope. A CLI lowering mismatch on a normal push is exposed by the next
 canonical pull; `neo push --dry-run` remains the complete source-to-record
 rehearsal.
 
@@ -110,7 +118,7 @@ wrappers.
 The marker near the top of `SKILL.md` must exactly match the package version:
 
 ```html
-<!-- reviewed-through-cli: 0.70.5 -->
+<!-- reviewed-through-cli: 0.71.1 -->
 ```
 
 The quoted version above is checked too, so this instruction cannot go stale

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

@@ -301,7 +301,9 @@ changed, skips codegen when only values changed since the last export into
 that Unity project, and writes `Library/NeoCompose/export.json` last for
 Unity to ingest.
 
-- A clean working copy exports the last pull. Local edits, `Files/` bytes
+- A clean working copy exports the pulled head. Diagnostic location differences
+  alone, including line shifts after push inserts ids, do not make it local.
+  Local edits, `Files/` bytes
   included, make the export local: `project.json` gets
   `metadata.localExport`, Unity fails player builds and keeps saves under
   `NeoCompose/LocalExport`, and a push or a clean export ends it.

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

@@ -8,11 +8,12 @@ runtime ownership, evaluation, and migrations.
 - Inline bodies and snippets
 - Nullability and ownership
 - Numeric builtins
-- List builtins
+- Collection builtins
 - Conditional and logical operators
 - Loops and transfer
 - Switch
 - Try/catch
+- Debug output
 - Evaluation and migrations
 
 ## Inline bodies and snippets
@@ -187,12 +188,17 @@ every path that falls through matched the pattern, including when the guard's
 other paths return from a nested block:
 
 ```neo
-if (!(item is BedItem bedItem)) {
+if (item is not BedItem bedItem) {
   throw "Expected a bed item";
 }
 return bedItem.Name;
 ```
 
+`value is not SomeClass` negates a type test. An optional binding, as in
+`value is not SomeClass item`, exists only where the test is known to be false:
+the `else` branch, the right side of `||`, or after a rejecting guard. The
+operand is evaluated once. `not` remains a normal identifier elsewhere.
+
 Use `SpriteInfo.Empty` when a required sprite should intentionally render no
 image. It is the canonical non-null empty sprite: it has no backing file and
 uses slice index zero.
@@ -252,6 +258,34 @@ materializing a filtered list. The same Count forms work on Dictionary and Set
 collections; dictionary predicates may accept `(key, value)` just like the
 other collection callbacks.
 
+Use `Any()` or `Any((item) => predicate)` to check for a match, and
+`All((item) => predicate)` to check every entry. Both short-circuit; an empty
+collection has `Any() == false` and `All(...) == true`.
+
+`Last`, `LastOrDefault`, `Single`, and `SingleOrDefault` accept zero arguments
+or one predicate. `Last` throws when no entry matches. `Single` throws unless
+exactly one matches; `SingleOrDefault` still throws for multiple matches.
+The `OrDefault` forms return nullable entries and use `null` for no match.
+
+Build eager, read-only list results with `SelectMany((item) => item.Children)`,
+`OrderBy((item) => item.Name)`, `OrderByDescending((item) => item.Score)`,
+`Skip(count)`, `Take(count)`, `SkipWhile((item) => predicate)`,
+`TakeWhile((item) => predicate)`, `Reverse()`, and `Concat(other)`.
+`SelectMany` requires a non-null list or set from its selector. Sorting is
+stable, evaluates each key once, uses ordinal string comparison, and accepts
+bool, int, float, decimal, or string keys, including nullable keys. Null sorts
+first ascending and last descending. Negative skip/take counts
+behave as zero. Reference entries keep their identity and storage permissions;
+a read-only result does not grant additional write access to its entries.
+
+```neo
+return this.Beds
+  .SelectMany((bed) => bed.Plants)
+  .Where((plant) => plant.Ready)
+  .OrderBy((plant) => plant.Name)
+  .Take(10);
+```
+
 Use `items.IndexOf(value)` to return the zero-based index of the first equal
 list entry, or `-1` when the value is absent. `IndexOf` is list-only and uses
 the same equality as `Contains`.
@@ -414,6 +448,26 @@ Do not use typed exception classes, parameterless catch, `finally`, `using`,
 patterns, or host-exception recovery. Completed writes before an error are not
 rolled back.
 
+## Debug output
+
+Use `Debug.Log(message)`, `Debug.LogWarning(message)`, and
+`Debug.LogError(message)` as void statements. `Debug.Assert(condition, message)`
+logs an assertion failure when its non-null bool condition is false. Errors
+and failed assertions log without throwing. Both assertion arguments are
+evaluated once even when the condition passes; disabling a host sink also
+preserves argument evaluation.
+
+```neo
+Debug.Log($"Loaded {this.Items.Count} items");
+Debug.Assert(this.Items.Any(), "Expected at least one item");
+```
+
+Messages include authored NeoScript line/column locations and stack frames
+when source metadata is available. Browser consoles and Unity use the matching
+severity; CLI logs go to stderr so JSON stdout stays machine-readable. Getter
+re-evaluation may emit the same log again. `Debug` is a builtin qualifier,
+not a type; an authored local or Class named `Debug` takes precedence.
+
 ## Evaluation and migrations
 
 `neo script eval` uses authored values and the same evaluator as the web app.