@neocompose/cli 0.23.1 → 0.24.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neocompose/cli",
-  "version": "0.23.1",
+  "version": "0.24.0",
   "description": "Neo Compose native project-source CLI with bidirectional sync.",
   "license": "MIT",
   "type": "module",
@@ -35,7 +35,8 @@
   },
   "dependencies": {
     "@inquirer/prompts": "^8.5.2",
-    "convex": "^1.40.0"
+    "convex": "^1.40.0",
+    "ignore": "^7.0.6"
   },
   "devDependencies": {
     "esbuild": "^0.28.1",

package/skills/neocompose-cli/SKILL.md

@@ -2,14 +2,14 @@
 name: neocompose-cli
 description: >-
   Edit, validate, and synchronize Neo Compose format-4 projects with the `neo`
-  CLI. Use when working in a `neo/` checkout or with `.neo`/`.neoflow` source:
+  CLI. Use when working in a `neo/` checkout or with `.neo`/`.neoflow`/`.spec.neo` source:
   schema declarations, constructors, values and references, world objects and
   animation, dialogue, NeoScript, localization, migrations, managed image or
   audio files, branches and releases, or batch repair. Run `neo` from
   `@neocompose/cli` or `node cli/bin/neo.mjs` in the neo-compose repository.
 ---
 
-<!-- reviewed-through-cli: 0.23.1 -->
+<!-- reviewed-through-cli: 0.24.0 -->
 
 # Neo Compose CLI
 
@@ -24,11 +24,12 @@ Those are not part of format 4.
 ## Follow the safe workflow
 
 1. Run `neo pull` before editing. Pull again before pushing if time has passed.
-2. Edit tracked `.neo`, `.neoflow`, and managed binary files only. Never edit
+2. Edit tracked `.neo`, `.neoflow`, `.spec.neo`, and managed binary files only. Never edit
    `.neo/state.json`, analysis caches, or `.neo/conflicts` as source.
 3. Run `neo status` and `neo diff`. Review every change, including changes that
    existed before the task began.
-4. Run `neo dialogue dryrun <ref>` after dialogue changes.
+4. Run `neo test` after NeoScript changes and `neo dialogue dryrun <ref>` after
+   dialogue changes.
 5. Run `neo push --dry-run` before every real push. It performs the full local
    source emission, ID-assignment, transport-shape, hash, and repeat-verification path,
    then rehearses the server's preparation phase — schema-commit
@@ -100,10 +101,13 @@ neo/
   DialogueGroups/
   Dialogues/*.neoflow
   Migrations/*.neo
+  **/*.spec.neo
   .neo/{state.json,conflicts/}
 ```
 
-All non-hidden `.neo`, `.neoflow`, and supported managed binaries are tracked.
+Production `.neo`/`.neoflow` files and supported managed binaries are tracked.
+Colocated `.spec.neo` files are test-only and never enter status, source hashes,
+pull/reset, or push.
 Normal pull preserves declaration placement and spelling by stable ID when it
 can. Force/reset may regroup source into the canonical layout.
 

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

@@ -41,8 +41,10 @@ Read the relevant specs in full:
 - [P50 loops](https://github.com/ryanbliss/neo-compose-specs/blob/main/new-features/p50-neoscript-for-and-foreach-loops.md)
 - [P51 switch](https://github.com/ryanbliss/neo-compose-specs/blob/main/new-features/p51-neoscript-switch-statements.md)
 - [P52 try/catch](https://github.com/ryanbliss/neo-compose-specs/blob/main/new-features/p52-neoscript-try-catch-blocks.md)
+- [P64 NeoScript unit testing and push hooks](https://github.com/ryanbliss/neo-compose-specs/blob/main/new-features/p64-neoscript-unit-testing-and-push-hooks.md)
 
-P38–P44 and P47–P51 are implemented. P45 remains deliberately deferred; do not
+P38–P44, P47–P52, and the initial P64 test/push-hook vertical slice are
+implemented. P45 remains deliberately deferred; do not
 build or teach runtime-child provenance. P46 is a hardening proposal, not an
 authoring capability. P52's document header still says proposed, but try/catch
 shipped in CLI 0.18; implementation and parity tests take precedence over that
@@ -78,7 +80,7 @@ wrappers.
 The marker near the top of `SKILL.md` must exactly match the package version:
 
 ```html
-<!-- reviewed-through-cli: 0.23.1 -->
+<!-- reviewed-through-cli: 0.24.0 -->
 ```
 
 The quoted version above is checked too, so this instruction cannot go stale

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

@@ -118,6 +118,15 @@ Removing an explicitly materialized field from an existing initializer requests
 a reset through the current default; require that change to appear in
 `neo diff`.
 
+Editing an initializer on an already-materialized instance updates the stored
+rows in place: the plan carries leaf updates with stable sub-row ids, never a
+delete-and-recreate, and never strips the instance back to an unconstructed
+value. A construction the stored rows cannot be reprojected onto — one that
+changes durable constructor arguments, swaps the class, or predates a new
+constructor parameter — fails with `construction-arguments-conflict` instead of
+lowering. Edit the instance's members, or delete and recreate the value with the
+new construction.
+
 Write main-locale text directly in localizable string initializers. Pull/lower
 preserves other locales, comments, statuses, archive state, and unrelated
 localized-text links. Do not author localized-text IDs in place of prose.