@neocompose/cli 0.36.13 → 0.38.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neocompose/cli",
-  "version": "0.36.13",
+  "version": "0.38.0",
   "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.36.13 -->
+<!-- reviewed-through-cli: 0.38.0 -->
 
 # Neo Compose CLI
 
@@ -132,7 +132,7 @@ completely before editing:
   constructors, declared constructors, settlement, and inheritance.
 - [Values, identities, and references](references/values-identities-and-references.md):
   root/static bindings, nested/list identities, same-push references, unique
-  keys, files, localization, and default materialization.
+  keys, files, localization, and virtual default projection.
 - [Animation and world authoring](references/animation-and-world-authoring.md):
   objects, sorting, optional children, structured leaves, object variants and
   variant folders, partial animation overrides, segments, tracks, and NeoFlow

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

@@ -83,7 +83,7 @@ wrappers.
 The marker near the top of `SKILL.md` must exactly match the package version:
 
 ```html
-<!-- reviewed-through-cli: 0.36.13 -->
+<!-- reviewed-through-cli: 0.38.0 -->
 ```
 
 The quoted version above is checked too, so this instruction cannot go stale

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

@@ -157,10 +157,18 @@ neo login [--api <url>] [--profile editor|release] [--save-project <id>]
 neo doctor
 ```
 
+`login`, `whoami`, and `logout` use the current workspace's `apiBaseUrl` when
+run beneath a `neo.json`. An explicit `--api` takes priority. Outside a
+workspace, they use the CLI build's default API origin. Login prints the
+selected origin before it requests or stores a credential.
+
 `neo doctor` reports two different things. The authoring contracts (format,
 compiler, extension cache, source, files) decide its exit code; the document
-audit below them reports malformed records in the last pull and deliberately
-does not, so a project with records still to repair does not fail the command.
+audit below them reports the last pull's malformed records, plus base rows no
+emitted file projects and no record names, and deliberately does not, so a
+project with records still to repair does not fail the command. An unprojected
+row is invisible to `neo status` by construction, which is why `neo doctor` is
+the only place it surfaces.
 `neo doctor --json` carries a `repair` entry per finding, which is what a
 targeted repair is handed instead of scanning a project to rediscover them.
 

package/skills/neocompose-cli/references/declarations-and-construction.md

@@ -101,9 +101,10 @@ Use `.EnumCase` only when context fixes one enum type; otherwise write
 ## Member and relation rules
 
 Infer member kind and optionality from its type and nullability. Treat the
-initializer as its default. Omitted fields materialize their current defaults
-once when an instance is created; later default edits do not mutate existing
-instances.
+initializer as its default. Omitted fields remain virtual and resolve through
+the instance's recorded constructor or variant. They track later source-default
+edits until that field is explicitly overridden; resetting an override makes it
+virtual again.
 
 A lookup member's arity is its declared type. `public Config Config` selects one
 entry and its declared type is the entry type; `public Set<Config> Configs`
@@ -142,9 +143,9 @@ value-level target metadata.
 ## Computed initializers and declared constructors
 
 Use an expression initializer when a member default must be evaluated during
-construction rather than stored as a closed literal. It runs for every newly
-constructed instance in push, web, and SDK contexts; it does not rewrite
-existing saved instances.
+construction rather than stored as a closed literal. It is replayed for omitted
+members in push, web, and SDK contexts. A stored override remains pinned until
+it is reset.
 
 Operator expressions are valid member defaults and store as computed
 initializers, the same way calls do — `public float Derived =

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

@@ -70,7 +70,9 @@ create. The server validates authored new IDs for UUID-v4 shape and uniqueness.
 Prefer generated IDs unless the structural reference needs an ID immediately.
 
 Do not invent IDs for structural rows whose identities derive from an owner
-role. Do not add a separate root/static initializer ID.
+role. Do not add a separate root/static initializer ID. A constructor argument
+is one such row — its identity comes from the schema key its parameter settles
+— so it never carries `@id`, in either the named or the positional form.
 
 ## Same-push references
 
@@ -120,20 +122,19 @@ membership rules as member defaults.
 
 ## Defaults and localization
 
-Materialize omitted members from their current defaults only when an instance
-is created. Do not expect later class-default changes to update existing rows.
-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.
+Omitted members are virtual projections of the instance's recorded constructor
+or variant. Later edits to that source update every omitted member. Writing a
+member creates a sparse override with its deterministic projected ID; removing
+that member from an existing initializer resets the override and resumes source
+tracking. Require either transition to appear in `neo diff`.
+
+Editing an initializer updates sparse override rows in place: projected member
+IDs remain stable, and omitted virtual rows are never emitted as authored seed
+records. A construction whose durable constructor arguments changed, whose
+class changed, or which predates a required constructor parameter fails with
+`construction-arguments-conflict` instead of silently replaying a different
+recipe. Edit members supported by the recorded construction, or delete and
+recreate the value.
 
 Write main-locale text directly in localizable string initializers. Pull/lower
 preserves other locales, comments, statuses, archive state, and unrelated