@neocompose/cli 0.51.1 → 0.51.2

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.51.2] - 2026-09-16
+
+- Preserve aggregate arguments owned by declared constructors when materializing nested values, including `NeoCellPattern` values in stored bindings.
+- Preserve local initializer identities when canonical source emission reorders unordered lists.
+- Preserve texture and audio templates in script documents so tests and script evaluation can construct classes with template-backed sprite defaults.
+- Identify a pending server derived-edge repair explicitly instead of recommending another pull to rebuild the index.
+- Keep local tests and dialogue dry-runs available while the server's derived-edge index awaits repair. Push dry-runs still check the live server watermark.
+
 ## [0.51.1] - 2026-09-16
 
 - Refresh compiler-only changes with ordinary `neo pull` before compiling the local workspace. Preserve authored source, local edits, custom paths, and managed binaries while adopting the current server compilation.

package/dist/neo.mjs

@@ -71079,15 +71079,14 @@ function ownedConstructorArgumentValues(row, ctx, readRow) {
   }
   const classId = row.classId;
   if (typeof classId !== "string") return [];
-  const schemaClass2 = evaluatorSchemaIndex(ctx).class(classId);
-  const requiredConstructorId2 = schemaClass2?.requiredConstructorId;
-  if (requiredConstructorId2 === void 0 || requiredConstructorId2 === null) {
-    return [];
-  }
-  const constructor2 = evaluatorSchemaIndex(ctx).constructorRecord(
-    requiredConstructorId2
-  );
+  const constructorId = row.instanceConstructorId;
+  if (constructorId === void 0 || constructorId === null) return [];
+  const constructor2 = evaluatorSchemaIndex(ctx).constructorRecord(constructorId);
   if (constructor2 === void 0 || constructor2.classId !== classId) return [];
+  if (!constructor2.argumentTypes.some(
+    (typeInfo) => typeInfo.type === 7 /* Class */ || typeInfo.type === 22 /* Interface */ || typeInfo.type === 6 /* List */ || typeInfo.type === 5 /* Dictionary */ || typeInfo.type === 21 /* Generic */
+  ))
+    return [];
   let genericEnv = /* @__PURE__ */ new Map();
   try {
     genericEnv = runtimeGenericEnvForValueRow(row, ctx, /* @__PURE__ */ new Set(), readRow);
@@ -88797,6 +88796,15 @@ var init_localizable_member_value_writes = __esm({
   }
 });
 
+// ../src/database/project-snapshot-derived-edge-version.ts
+var PROJECT_SNAPSHOT_DERIVED_EDGE_EXTRACTOR_VERSION;
+var init_project_snapshot_derived_edge_version = __esm({
+  "../src/database/project-snapshot-derived-edge-version.ts"() {
+    "use strict";
+    PROJECT_SNAPSHOT_DERIVED_EDGE_EXTRACTOR_VERSION = 4;
+  }
+});
+
 // ../src/database/project-snapshot-derived-edges.ts
 function extractProjectSnapshotDerivedEdges(source) {
   const edges = /* @__PURE__ */ new Map();
@@ -88955,7 +88963,7 @@ function collectDirectBodyChildIds(value) {
 function asRecord3(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
 }
-var PROJECT_SNAPSHOT_DERIVED_EDGE_EXTRACTOR_VERSION, STORED_PROJECT_RECORD_ID_PATTERN;
+var STORED_PROJECT_RECORD_ID_PATTERN;
 var init_project_snapshot_derived_edges = __esm({
   "../src/database/project-snapshot-derived-edges.ts"() {
     "use strict";
@@ -88963,7 +88971,7 @@ var init_project_snapshot_derived_edges = __esm({
     init_neo_script_recompile_scope();
     init_member_kinds();
     init_packed_value_encoding();
-    PROJECT_SNAPSHOT_DERIVED_EDGE_EXTRACTOR_VERSION = 4;
+    init_project_snapshot_derived_edge_version();
     STORED_PROJECT_RECORD_ID_PATTERN = /^(?:system_)?[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/iu;
   }
 });
@@ -115928,11 +115936,13 @@ function verifyProjectSourceCommitAgainstStateV4(args) {
     assignments
   );
   const usedAssignments = /* @__PURE__ */ new Set();
+  const positionless = positionIndependentAssignments(assignments);
+  const rewrite = (value) => rewritePending(value, assignments, usedAssignments, positionless);
   const expectedChanges = status.changes.map((change) => {
-    const rewrittenData = change.nextData === void 0 ? void 0 : rewritePending(change.nextData, assignments, usedAssignments);
+    const rewrittenData = change.nextData === void 0 ? void 0 : rewrite(change.nextData);
     return {
       recordKind: change.recordKind,
-      recordId: rewritePending(change.recordId, assignments, usedAssignments),
+      recordId: rewrite(change.recordId),
       operation: change.kind,
       // Source syntax does not author project ownership. The CLI stamps the
       // authenticated project id on creates immediately before transport;
@@ -115944,14 +115954,12 @@ function verifyProjectSourceCommitAgainstStateV4(args) {
   });
   const expectedSeeds = [...status.authoredValueSeeds].map(
     ([memberId, seed]) => ({
-      memberId: rewritePending(memberId, assignments, usedAssignments),
-      ...rewritePending(seed, assignments, usedAssignments)
+      memberId: rewrite(memberId),
+      ...rewrite(seed)
     })
   );
-  const expectedInitializerMaterialization = rewritePending(
-    status.localInitializerMaterialization ?? { roots: [] },
-    assignments,
-    usedAssignments
+  const expectedInitializerMaterialization = rewrite(
+    status.localInitializerMaterialization ?? { roots: [] }
   );
   for (const pendingId2 of assignments.keys()) {
     if (!usedAssignments.has(pendingId2)) {
@@ -116116,8 +116124,27 @@ function positionIndependentAssignments(assignments) {
   }
   return resolved;
 }
-function rewritePending(value, assignments, used, byPosition) {
-  const positionless = byPosition ?? positionIndependentAssignments(assignments);
+function relocatedAssignment(pendingId2, assignments, byPosition) {
+  const key = positionIndependentPendingKey(pendingId2);
+  const relocated = key === null ? void 0 : byPosition.get(key);
+  if (relocated !== void 0) return relocated;
+  const virtual = pendingVirtualValueIdentity(pendingId2);
+  if (virtual === null) return null;
+  let relocatedRoot = virtual.instanceRootId;
+  if (!assignments.has(relocatedRoot)) {
+    const rootKey = positionIndependentPendingKey(relocatedRoot);
+    if (rootKey === null) return null;
+    const canonicalRoot = byPosition.get(rootKey);
+    if (canonicalRoot === void 0) return null;
+    relocatedRoot = canonicalRoot;
+  }
+  const relocatedVirtual = pendingVirtualValueId(
+    relocatedRoot,
+    virtual.sourceIdentity
+  );
+  return assignments.has(relocatedVirtual) ? relocatedVirtual : null;
+}
+function rewritePending(value, assignments, used, positionless) {
   if (typeof value === "string") {
     const exact = assignments.get(value);
     if (exact !== void 0) {
@@ -116125,9 +116152,8 @@ function rewritePending(value, assignments, used, byPosition) {
       return exact;
     }
     if (value.startsWith("__pending__:")) {
-      const key = positionIndependentPendingKey(value);
-      const relocated = key === null ? void 0 : positionless.get(key);
-      if (relocated !== void 0) {
+      const relocated = relocatedAssignment(value, assignments, positionless);
+      if (relocated !== null) {
         used.add(relocated);
         return assignments.get(relocated);
       }
@@ -116135,6 +116161,7 @@ function rewritePending(value, assignments, used, byPosition) {
         `Verified source identity ${value} has no pending id assignment.`
       );
     }
+    if (!value.includes("__pending__:")) return value;
     let rewritten = value;
     for (const [pendingId2, assignedId] of assignments) {
       if (!rewritten.includes(pendingId2)) continue;
@@ -116452,7 +116479,6 @@ function assertServerPreparationSucceeds(args) {
     });
     if (refusal !== null) throw new ServerPreparationPreflightError(refusal);
   }
-  assertDerivedEdgeCompatibility(args.workspace);
   try {
     return prepareServerPreparationChanges({
       ...args,
@@ -116481,6 +116507,14 @@ function assertDerivedEdgeCompatibility(workspace) {
       `Project "${workspace.config.projectId}" has no derived-edge watermark. Run \`neo pull\` and retry. If this persists, repair the project's derived edge index.`
     );
   }
+  if (serverVersion === 0) {
+    throw new DerivedEdgeCompatibilityError(
+      "server-stale",
+      localVersion,
+      serverVersion,
+      `Project "${workspace.config.projectId}" has a pending server derived-edge repair (watermark 0). Wait for repair to complete and retry. If it remains pending, inspect the server repair status and logs; \`neo pull\` cannot rebuild this index.`
+    );
+  }
   if (serverVersion > localVersion) {
     throw new DerivedEdgeCompatibilityError(
       "cli-stale",
@@ -120506,7 +120540,9 @@ function structuralMemberByParameterName(context, effectiveClass) {
 function lowerSeedChild(context, member, expression, source, path, rows, localizedTexts, containerId, environment, authoredSlice) {
   const symbolId = sourceValueSymbol(context, expression);
   if (symbolId !== null) return symbolId;
-  const annotatedId = annotatedValue(expression).id;
+  const annotatedId = annotatedValue(
+    context.localValues.resolve(expression, source).expression
+  ).id;
   const valueId = annotatedId ?? context.structuralStoredIds.get(path) ?? pendingNestedValueId(source, path);
   lowerSeedRow(
     context,
@@ -130576,6 +130612,8 @@ function readDocumentArrays(raw) {
   return {
     project: raw.project,
     projectFiles: arrayOf2("projectFiles"),
+    textureTemplates: arrayOf2("textureTemplates"),
+    audioClipTemplates: arrayOf2("audioClipTemplates"),
     members: arrayOf2("members"),
     classes: arrayOf2("classes"),
     constructors: arrayOf2("constructors"),
@@ -131396,6 +131434,7 @@ async function runScript(workspace, command, options, dependencies = {}) {
     variants: document.variants,
     variantFolders: document.variantFolders,
     projectFiles: document.projectFiles,
+    textureTemplates: document.textureTemplates,
     localizationConfig: document.localizationConfig,
     localizedTexts: document.localizedTexts,
     ...runtime
@@ -134667,6 +134706,7 @@ async function prepareLocalCandidateV4(workspace, options = {}) {
           versionId: workspace.config.versionId
         });
         workspace.state.derivedEdgeVersion = signal?.derivedEdgeVersion ?? null;
+        assertDerivedEdgeCompatibility(workspace);
       }
       preparedLocal = await prepareLocalPushArtifactsV4(
         workspace,
@@ -135006,7 +135046,8 @@ function createPendingProjectSourceIdentityV4(workspace, status, authoredValueSe
     recordFiles: projectRecordFilesV4(
       Object.values(workspace.state.records),
       status.reconstructed.values()
-    )
+    ),
+    localValues: status.localValues
   });
   const files = emission.files.map((file) => {
     const kind = neoProjectSourceKind(file.path, file.content);
@@ -136502,7 +136543,7 @@ var init_registry2 = __esm({
   "schema-contract/registry.mjs"() {
     "use strict";
     PROJECT_SCHEMA_CONTRACT = Object.freeze({
-      cliVersion: "0.51.1",
+      cliVersion: "0.51.2",
       projectFileUploadBatchSize: 32,
       documentRecords: {
         member: {
@@ -138099,6 +138140,7 @@ function sharedEvaluatorBase(rawDocument) {
     variants: document.variants,
     variantFolders: document.variantFolders,
     projectFiles: document.projectFiles,
+    textureTemplates: document.textureTemplates,
     localizationConfig: document.localizationConfig,
     localizedTexts: document.localizedTexts,
     ...runtime
@@ -143731,7 +143773,7 @@ There is no --keep-current: preserving current semantic state defines flatten.
 async function main() {
   const args = parseArgs(process.argv.slice(2));
   if (args.command === "--version") {
-    console.log("0.51.1");
+    console.log("0.51.2");
     return;
   }
   if (args.command === null || args.command === "help" || args.command === "--help" || args.command === "-h") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neocompose/cli",
-  "version": "0.51.1",
+  "version": "0.51.2",
   "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.51.1 -->
+<!-- reviewed-through-cli: 0.51.2 -->
 
 # Neo Compose CLI
 

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

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