@neocompose/cli 0.2.0 → 0.2.2

package/dist/tooling/NeoCompose.SchemaCompiler.deps.json

@@ -6,11 +6,11 @@
   "compilationOptions": {},
   "targets": {
     ".NETCoreApp,Version=v6.0": {
-      "NeoCompose.SchemaCompiler/2.0.1": {
+      "NeoCompose.SchemaCompiler/2.1.0": {
         "dependencies": {
           "Microsoft.CodeAnalysis.CSharp": "4.11.0",
-          "NeoCompose.Schema": "2.0.1",
-          "NeoCompose.Schema.Tooling": "2.0.1"
+          "NeoCompose.Schema": "2.1.0",
+          "NeoCompose.Schema.Tooling": "2.1.0"
         },
         "runtime": {
           "NeoCompose.SchemaCompiler.dll": {}
@@ -184,26 +184,26 @@
         }
       },
       "System.Threading.Tasks.Extensions/4.5.4": {},
-      "NeoCompose.Schema/2.0.1": {
+      "NeoCompose.Schema/2.1.0": {
         "runtime": {
           "NeoCompose.Schema.dll": {
-            "assemblyVersion": "2.0.1.0",
-            "fileVersion": "2.0.1.0"
+            "assemblyVersion": "2.1.0.0",
+            "fileVersion": "2.1.0.0"
           }
         }
       },
-      "NeoCompose.Schema.Tooling/2.0.1": {
+      "NeoCompose.Schema.Tooling/2.1.0": {
         "runtime": {
           "NeoCompose.Schema.Tooling.dll": {
-            "assemblyVersion": "2.0.1.0",
-            "fileVersion": "2.0.1.0"
+            "assemblyVersion": "2.1.0.0",
+            "fileVersion": "2.1.0.0"
           }
         }
       }
     }
   },
   "libraries": {
-    "NeoCompose.SchemaCompiler/2.0.1": {
+    "NeoCompose.SchemaCompiler/2.1.0": {
       "type": "project",
       "serviceable": false,
       "sha512": ""
@@ -285,12 +285,12 @@
       "path": "system.threading.tasks.extensions/4.5.4",
       "hashPath": "system.threading.tasks.extensions.4.5.4.nupkg.sha512"
     },
-    "NeoCompose.Schema/2.0.1": {
+    "NeoCompose.Schema/2.1.0": {
       "type": "project",
       "serviceable": false,
       "sha512": ""
     },
-    "NeoCompose.Schema.Tooling/2.0.1": {
+    "NeoCompose.Schema.Tooling/2.1.0": {
       "type": "project",
       "serviceable": false,
       "sha512": ""

package/dist/tooling/schema-contract.json

@@ -1,10 +1,10 @@
 {
   "formatVersion": 2,
-  "contractVersion": "2.0",
+  "contractVersion": "2.1",
   "manifestName": "neo-schema-manifest-v2",
   "protocolVersion": 3,
-  "sdkVersion": "2.0.1",
-  "cliVersion": "0.2.0",
+  "sdkVersion": "2.1.0",
+  "cliVersion": "0.2.1",
   "apiTarget": "netstandard2.1",
   "referenceAssemblySet": "NETStandard.Library.Ref/2.1.0",
   "requiredToolingFiles": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neocompose/cli",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Neo Compose schema-as-code CLI with compiler-backed C# authoring and bidirectional sync.",
   "license": "MIT",
   "type": "module",

package/skills/neocompose-cli/SKILL.md

@@ -31,7 +31,7 @@ The compiler reports file:line:column diagnostics and never guesses. Unknown
 authorable server fields fail with “CLI contract upgrade required”; they never
 hide in an opaque JSON carrier.
 
-## Setup and format migration
+## Setup and format requirement
 
 ```sh
 npm i -g @neocompose/cli
@@ -44,16 +44,15 @@ Repository development uses `node cli/bin/neo.mjs`. Agents should always pass
 explicit flags/IDs. Human terminals may show pickers and confirms; non-TTY/CI
 use fails with an actionable missing-flag diagnostic rather than blocking.
 
-`neo.json` must contain `formatVersion: 2`. A missing marker is legacy v1.
-Normal schema commands reject v1; run:
+`neo.json` must contain `formatVersion: 2`. A missing or different marker is
+unsupported. Preserve any source you need, then create a fresh v2 working copy:
 
 ```sh
-neo pull --reset
+neo init --project <id> [--version <id>] [--dir neo]
 ```
 
-Reset reconstructs from the server using v2, refreshes the compiler SDK and
-analyzer, and deletes obsolete `Schema/NeoSchemaAttributes.cs`. There is no
-v1 parser or compatibility shim.
+`neo pull --reset` is only for an existing schema workspace; it reconstructs
+CLI-managed source from the server and refreshes the compiler SDK and analyzer.
 
 Neo never downloads or installs .NET. Compiler host discovery is:
 
@@ -108,6 +107,9 @@ Native C# carries native meaning:
   ordering attribute is present.
 - Method parameters and return type are the function signature.
   `Task`/`Task<T>` means deferred execution.
+- A C# `static` property or method is type-owned. Stored static properties use
+  one replaceable binding and are excluded from instance construction;
+  receiver kind cannot be changed in place.
 - Concrete `[NeoScript]`/`[NeoFunction]` methods are C# 11 partial
   declarations. The bundled source generator adds inert compile-only bodies.
   Abstract functions are ordinary abstract methods.
@@ -124,7 +126,7 @@ public enum ItemType
     Food,
 }
 
-[NeoType("type-inventory-item", AllowedStorage = NeoAllowedStorage.Static)]
+[NeoType("type-inventory-item", AllowedStorage = NeoAllowedStorage.Immutable)]
 [NeoSchemaOrder(nameof(Name), nameof(Type), nameof(Tags), nameof(UsePrimary))]
 public abstract partial class InventoryItem<
     [NeoId("generic-stack")] TStack>
@@ -178,7 +180,7 @@ Allowed values are statically analyzable literals, enum values, `nameof`,
 and `Neo.Ref<T>`, `Neo.Lookup<T>`, `Neo.Dialogue`, `Neo.Sprite`, `Neo.Audio`,
 or `Neo.Member` references. Authored code is never executed.
 
-Never introduce v1 carriers or identity escapes: `ExtraJson`, `DefaultJson`,
+Never introduce opaque carriers or identity escapes: `ExtraJson`, `DefaultJson`,
 `RetJson`, `ArgsJson`, `EntryChainJson`, `SchemaKeyOrderJson`,
 `GenericParamIds`, `ChainJson`, `SignatureJson`, `ExtendsId`, `isVirtual`, or
 `isAbstract`.
@@ -235,9 +237,30 @@ Canonical C# places `// NeoScript: Scripts/<Type>/<Member>.neo` above the
 linked declaration. Go-to-definition, references, and rename use the Roslyn
 source identity plus stable member ID to navigate between C# and `.neo`.
 
-NeoScript is C#-flavored: use typed declarations (`string name = ...;`, not
-`var`); `this` is the containing instance; roots include `root.Assets`,
-`root.Save`, and `root.Session`.
+NeoScript is C#-flavored. Locals may use an explicit type
+(`string name = ...;`) or inference (`var name = ...;`); inferred locals retain
+the same static type and editor intelligence. `this` is the containing
+instance; roots include `root.Assets`, `root.Save`, and `root.Session`.
+
+Every executable NeoScript unit uses the same mutation-capable resolver and
+executor. Getter and dialogue-condition bodies may write just like actions,
+setters, Functions, and migrations; the resolved target's Immutable, Save,
+Session, or runtime ownership—not the body kind—decides whether the write is
+legal. The non-code Condition builder remains a restricted read form.
+
+Concrete, closed, writable Custom types expose the same public constructor
+shape as generated C#. Use `new Type(required, optional, ...)`; required
+parameters come first, optional parameters follow in generated-code order,
+and `null` skips an optional positional slot. Arguments remain positional;
+editor parameter-name hints are previews, not named-argument syntax.
+Constructor graphs begin as parentless Session values. They survive only when
+attached, returned, or otherwise escaped from the invocation; abandoned
+graphs are reclaimed.
+
+Static members use a type receiver (`GameRules.EncounterCount`), while
+instance members use a value receiver. Stored static members resolve through
+their authored/Save/Session binding layer and are never copied into Custom
+instances.
 
 ```sh
 neo script check --all
@@ -252,7 +275,8 @@ neo script apply --mode action '...'
 
 `eval` uses authored values and the same evaluator as the web app. `apply` is
 preview-only unless its command explicitly supports a commit; it reports
-return values and write intents. Prefer `--json` for automation.
+return values, ordered write intents, and surviving constructor rows in
+`createdSessionValues`. Prefer `--json` for automation.
 
 ## Conflicts and version bumps
 
@@ -279,6 +303,9 @@ neo records get <kind> <id>
 neo values list [attributeId]
 neo values get <valueId>
 neo values set <valueId> '<raw-json-value>'
+neo values bind <staticAttributeId> <valueId>
+neo values unbind <staticAttributeId>
+neo values create '<raw-json-value>' [--type <customTypeId>] --bind <staticAttributeId>
 neo loc locales
 neo loc list
 neo loc set <textId> <locale> "text"
@@ -286,9 +313,11 @@ neo loc set <textId> <locale> "text"
 
 Write verbs accept a JSON-array batch on stdin or `--file`; use one batch when
 edits must be atomic. A `values set` payload is the raw value, not
-`{"value": ...}`. For collection rows use `values add-entry` on the live
-container value; an attribute's default container ID may not be an instance's
-container.
+`{"value": ...}`. `values bind` and `unbind` edit only a stored static
+member's authored binding; `create --bind` can atomically create and bind a
+complete Custom/collection graph supplied as one batch. For collection rows
+use `values add-entry` on the live container value; an attribute's default
+container ID may not be an instance's container.
 
 ### Dialogue authoring