@neocompose/cli 0.2.1 → 0.2.3

package/README.md

@@ -94,6 +94,9 @@ public abstract partial class InventoryItem<
   override's base member ID is resolved from the Roslyn symbol graph.
 - Property type and nullability determine Neo kind and requiredness.
 - A property initializer is its default; declaration order is schema order.
+- A `static` property or method is type-owned. Stored static properties use a
+  replaceable binding and are not copied into instances; instance and static
+  receiver kinds cannot be changed in place.
 - Method signatures define function arguments and returns. `Task`/`Task<T>`
   means deferred execution. The bundled source generator gives concrete
   partial declarations inert compile-time implementations; authored schema
@@ -106,6 +109,18 @@ public abstract partial class InventoryItem<
   settings use strongly typed object initializers. Their complete option sets
   participate in normal C# IntelliSense.
 
+For example, a concrete non-generic type can declare a type-owned stored
+member:
+
+```csharp
+[NeoType("type-game-rules")]
+public partial class GameRules
+{
+    [NeoMember("attribute-encounter-count")]
+    public static int EncounterCount { get; set; }
+}
+```
+
 Only statically analyzable expressions are accepted: literals, enum values,
 `nameof`, `typeof`, arrays/collections, object initializers, and approved
 `Neo.*` reference constructors. The compiler never loads or executes the
@@ -165,6 +180,24 @@ bool UsePrimary(InventoryItem this, Root root) {
 }
 ```
 
+All executable body kinds use the same mutation-capable resolver and executor.
+Getters and code-authored conditions may write to Save, Session, runtime, or
+setter-backed targets; Immutable targets remain read-only. Body kind still
+controls return/deferred-call rules, not storage writability.
+
+Locals may use either an explicit type or `var`; inferred locals retain the
+same exact type and language features. Concrete, closed, writable Custom types
+support `new Type(...)` in the same required-then-optional parameter order as
+generated C#. Optional parameters have inferred `null` defaults and are
+positional, so pass `null` to skip an earlier optional slot. Constructor-call
+signature help and parameter-name inlay hints come from that shared signature;
+the names are previews, not authored named-argument syntax.
+Fresh constructor graphs use Session ownership and are reclaimed at invocation
+completion unless attached, returned, passed onward, or otherwise escaped.
+
+Static access uses the declaring type (`GameRules.EncounterCount`); stored
+static members resolve through their authored, Save, or Session binding layer.
+
 The browser-safe `neoscript-language` package is authoritative for the CLI,
 server compiler, web Monaco editor, and VS Code LSP. Monaco's existing syntax
 highlighting, comments/interpolation, scaffolds and protected regions,
@@ -187,8 +220,14 @@ uses the same results; marketplace publication is a separate release step.
 | `push [--dry-run] [--accept-bump]`        | Preview or commit one atomic compare-and-swap transaction                                          |
 | `dev [--push]`                            | Watch the Convex sync signal and local files; pushing remains opt-in                               |
 | `resolve --mine\|--theirs`                | Conflict-marker convenience; editing the final source is authoritative                             |
-| `script check\|compile\|eval\|apply`      | Use the shared NeoScript compiler/evaluator                                                        |
-| `records` / `values` / `loc` / `dialogue` | Read and batch-edit content without materializing it as schema files                               |
+| `script check\|compile\|eval\|apply`      | Use the shared NeoScript compiler/evaluator and report values, writes, and surviving Session rows  |
+| `records` / `values` / `loc` / `dialogue` | Read and batch-edit content, including stored static bindings, without schema-source value files   |
+
+`neo script eval --json` reports `value`, ordered `writes`, and
+`createdSessionValues`. The last field contains only constructor rows that
+escaped invocation cleanup. Use `neo values bind`, `neo values unbind`, or an
+atomic `neo values create ... --bind <staticAttributeId>` operation to manage
+an authored stored-static binding.
 
 The central invariant is unchanged: a pull followed immediately by status or
 push must produce no changes. The manifest contract classifies every field as