@neocompose/cli 0.2.2 → 0.3.0

package/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+## [0.3.0] - 2026-07-15
+
+### Breaking
+
+- Replaced the format-2 schema vocabulary with strict format 3 Classes and
+  Members.
+- Renamed generated schema sources to `Classes/*.cs`, introduced
+  `[NeoSchemaClass]`, and moved NeoScript sidecars to
+  `Scripts/<Class>/<Member>.neo`.
+- Removed format-2 loading, legacy flags, record kinds, wire fields, and
+  compatibility conversion. Refresh existing working copies with Neo CLI 0.3.0.
+
+### Changed
+
+- Updated compiler, analyzer, language-service, VS Code protocol, status,
+  diff, and pending-ID contracts for Class/Member terminology.

package/README.md

@@ -2,7 +2,7 @@
 
 `neo` keeps a Git-friendly C# working copy of a Neo Compose project schema,
 syncs it bidirectionally with Convex, and exposes NeoScript and content
-commands. Schema format v2 is compiler-backed: authored files are real C# 11,
+commands. Schema format v3 is compiler-backed: authored files are real C# 11,
 not a handwritten C# subset.
 
 The complete contract is in
@@ -23,20 +23,20 @@ an executable when discovery needs an explicit override. Run `neo doctor` to
 see the selected host, its compatibility result, the discovery cache, and the
 bundled schema-contract versions.
 
-## Format v2 working copy
+## Format v3 working copy
 
 ```text
 neo/
-  neo.json                         # includes formatVersion: 2
+  neo.json                         # includes formatVersion: 3
   NeoCompose.Schema.csproj         # netstandard2.1, C# 11, IDE-only
-  Types/                           # custom classes
+  Classes/                          # class declarations
   Interfaces/                      # Neo interfaces
   Enums/                           # Neo enums
   Root.cs                          # [NeoRegistry] roots and loose members
   Templates/                       # typed texture/audio settings
   Localization.cs                 # typed localization settings
   LocalizationStatuses/*.cs       # typed workflow-status settings
-  Scripts/<Type>/<Member>.neo      # tracked NeoScript sidecars
+  Scripts/<Class>/<Member>.neo     # tracked NeoScript sidecars
   Migrations/*.neo
   .neo/
     state.json                     # sync bases and CAS hashes
@@ -47,17 +47,17 @@ neo/
 `.neo/`, `bin/`, and `obj/` are gitignored. The C# project is an authoring
 project only; the game never references or ships it. The public
 `NeoCompose.Schema` SDK and analyzer are materialized from the npm package
-under `.neo/tooling`. There is no generated `Schema/NeoSchemaAttributes.cs`.
+under `.neo/tooling`. There is no generated `Schema/NeoSchemaMembers.cs`.
 
-Format v2 is a clean break and `neo.json` must contain `formatVersion: 2`.
+Format v3 is a clean break and `neo.json` must contain `formatVersion: 3`.
 A workspace with a missing or different format version is unsupported. Preserve
-any source you need, then create a fresh v2 working copy with:
+any source you need, then create a fresh v3 working copy with:
 
 ```sh
 neo init --project <id> [--version <id>] [--dir neo]
 ```
 
-`neo pull --reset` remains available for an existing v2 workspace: it
+`neo pull --reset` remains available for an existing v3 workspace: it
 reconstructs its managed schema files from the server and refreshes tooling.
 
 ## Real C# authoring
@@ -71,18 +71,18 @@ method arguments, return types, and deferred `Task` results.
 using System.Threading.Tasks;
 using NeoCompose.Schema;
 
-[NeoType("type-inventory-item")]
+[NeoSchemaClass("class-inventory-item")]
 public abstract partial class InventoryItem<
     [NeoId("generic-stack-data")] TStackData>
     where TStackData : InventoryStackData
 {
-    [NeoMember("attribute-name"), NeoText(SearchKey = true)]
+    [NeoMember("member-name"), NeoText(SearchKey = true)]
     public virtual string Name { get; init; } = "";
 
-    [NeoMember("attribute-type")]
+    [NeoMember("member-type")]
     public abstract ItemType Type { get; init; }
 
-    [NeoMember("attribute-description"), NeoComputed]
+    [NeoMember("member-description"), NeoComputed]
     public virtual string Description { get; }
 
     [NeoMember("function-use-primary"), NeoScript]
@@ -94,7 +94,7 @@ 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
+- A `static` property or method is class-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>`
@@ -109,14 +109,14 @@ 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
+For example, a concrete non-generic class can declare a class-owned stored
 member:
 
 ```csharp
-[NeoType("type-game-rules")]
+[NeoSchemaClass("class-game-rules")]
 public partial class GameRules
 {
-    [NeoMember("attribute-encounter-count")]
+    [NeoMember("member-encounter-count")]
     public static int EncounterCount { get; set; }
 }
 ```
@@ -127,7 +127,7 @@ Only statically analyzable expressions are accepted: literals, enum values,
 authored assembly. JSON carriers and identity escape hatches such as
 `ExtraJson`, `DefaultJson`, `RetJson`, `ArgsJson`, `EntryChainJson`,
 `SchemaKeyOrderJson`, `GenericParamIds`, `ChainJson`, `SignatureJson`,
-`ExtendsId`, `isVirtual`, and `isAbstract` do not exist in v2.
+`ExtendsId`, `isVirtual`, and `isAbstract` do not exist in v3.
 
 Localization workflow statuses are ordinary stable records rather than IDs
 hidden in localization JSON:
@@ -150,10 +150,10 @@ public sealed partial class Approved
 
 NeoScript is tracked separately from C# metadata:
 
-- `Scripts/<DeclaringType>/<Member>.neo` is the only canonical path.
+- `Scripts/<DeclaringClass>/<Member>.neo` is the only canonical path.
 - Every file contains its complete contextual wrapper. The outer signature
   mirrors the C# member and its NeoScript result type (`Task<T>` is represented
-  as `T`), then adds `<DeclaringType> this, Root root`; this chrome is protected
+  as `T`), then adds `<DeclaringClass> this, Root root`; this chrome is protected
   in Monaco while the executable regions remain editable.
 - A computed property wrapper contains `get { ... }` and, when writable,
   `set(<Type> value) { ... }` units.
@@ -186,8 +186,8 @@ 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
+same exact type and language features. Concrete, closed, writable Classes
+support `new ClassName(...)` 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;
@@ -195,7 +195,7 @@ 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 access uses the declaring Class (`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,
@@ -213,7 +213,7 @@ uses the same results; marketplace publication is a separate release step.
 | Command                                   | Purpose                                                                                            |
 | ----------------------------------------- | -------------------------------------------------------------------------------------------------- |
 | `login`                                   | Device-code OAuth; use `--profile release`, `--token-stdin`, or `NEO_COMPOSE_TOKEN` as appropriate |
-| `init --project <id> [--version <id>]`    | Scaffold a format-v2 working copy and perform the first pull                                       |
+| `init --project <id> [--version <id>]`    | Scaffold a format-v3 working copy and perform the first pull                                       |
 | `doctor`                                  | Report runtime discovery, compatibility, cache, tooling, and contract versions                     |
 | `pull [--reset]`                          | Sync or reconstruct; normal pulls use record-level three-way merge                                 |
 | `status` / `diff`                         | Compile the working copy and compare its manifest with the base                                    |
@@ -226,7 +226,7 @@ uses the same results; marketplace publication is a separate release step.
 `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
+atomic `neo values create ... --bind <staticMemberId>` operation to manage
 an authored stored-static binding.
 
 The central invariant is unchanged: a pull followed immediately by status or