@neocompose/cli 0.51.0 → 0.51.2

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # 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.
+- Refuse a normal pull when the baseline is missing but authored source files remain, preventing duplicate declarations and overwritten local edits. An explicit forced refresh recovers custom file paths from the existing declarations.
+
 ## [0.51.0] - 2026-09-15
 
 Compiler revision 14 requires Unity SDK 0.37.0. The server migration recompiles stored scripts and retained history.

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);
@@ -87329,6 +87328,44 @@ function stampUILogicBody(logic, bodyKey) {
   body.compilerRevision = NEOSCRIPT_COMPILER_REVISION;
   return true;
 }
+function stampUILogicBodies(recordKind, data) {
+  const record5 = asRecord2(data);
+  if (record5 === null) return false;
+  if (recordKind === "dialogue-group") {
+    return stampConditionList(record5.conditions);
+  }
+  if (recordKind !== "dialogue-node") return false;
+  let changed = stampConditionList(record5.conditions);
+  if (Array.isArray(record5.actions)) {
+    for (const actionValue2 of record5.actions) {
+      const logic = asRecord2(asRecord2(actionValue2)?.logic);
+      changed = stampUILogicBody(logic, "action") || changed;
+    }
+  }
+  if (Array.isArray(record5.outcomes)) {
+    for (const outcomeValue of record5.outcomes) {
+      changed = stampConditionList(asRecord2(outcomeValue)?.conditions) || changed;
+    }
+  }
+  const options = asRecord2(record5.optionSettings)?.options;
+  if (Array.isArray(options)) {
+    for (const optionValue of options) {
+      const settings = asRecord2(asRecord2(optionValue)?.settings);
+      if (settings === null) continue;
+      changed = stampConditionList(settings.conditions) || changed;
+      changed = stampConditionList(settings.selectableConditions) || changed;
+    }
+  }
+  return changed;
+}
+function stampConditionList(value) {
+  if (!Array.isArray(value)) return false;
+  let changed = false;
+  for (const conditionValue of value) {
+    changed = stampUILogicBody(asRecord2(conditionValue), "getter") || changed;
+  }
+  return changed;
+}
 function asRecord2(value) {
   if (typeof value !== "object" || value === null || Array.isArray(value)) {
     return null;
@@ -88759,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();
@@ -88917,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";
@@ -88925,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;
   }
 });
@@ -115890,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;
@@ -115906,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)) {
@@ -116078,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) {
@@ -116087,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);
       }
@@ -116097,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;
@@ -116414,7 +116479,6 @@ function assertServerPreparationSucceeds(args) {
     });
     if (refusal !== null) throw new ServerPreparationPreflightError(refusal);
   }
-  assertDerivedEdgeCompatibility(args.workspace);
   try {
     return prepareServerPreparationChanges({
       ...args,
@@ -116443,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",
@@ -120468,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,
@@ -126661,6 +126735,14 @@ var init_convex = __esm({
 // src/project-source/source-layout.ts
 import { readFileSync as readFileSync8 } from "node:fs";
 import { relative as relative4, sep as sep4 } from "node:path";
+function workspaceForSourceLayoutV4(workspace, document) {
+  if (Object.keys(workspace.state.records).length > 0) return workspace;
+  const records2 = {};
+  for (const [key, record5] of document.records) {
+    if (!record5.deleted) records2[key] = record5;
+  }
+  return { ...workspace, state: { ...workspace.state, records: records2 } };
+}
 function readWorkspaceRecordFilesV4(workspace) {
   const paths = /* @__PURE__ */ new Map();
   const keysById = /* @__PURE__ */ new Map();
@@ -127446,17 +127528,7 @@ import {
 import { dirname as dirname7, join as join8, relative as relative5, sep as sep5 } from "node:path";
 function prepareWorkspaceResetV4(workspace, document, options = {}) {
   const emissionRecords = options.regenerateSourceNames ? regenerateDialogueSourceNamesV4(document.records) : document.records;
-  let layoutWorkspace = workspace;
-  if (Object.keys(workspace.state.records).length === 0) {
-    const records2 = {};
-    for (const [key, record5] of document.records) {
-      if (!record5.deleted) records2[key] = record5;
-    }
-    layoutWorkspace = {
-      ...workspace,
-      state: { ...workspace.state, records: records2 }
-    };
-  }
+  const layoutWorkspace = workspaceForSourceLayoutV4(workspace, document);
   const status = listProjectSourceFilesV4(workspace.root).length === 0 ? null : readWorkspaceLayoutStatusV4(layoutWorkspace);
   const localValues = status?.localValues ?? workspace.state.localValues;
   const emitted = emitProjectDocumentFilesV4(emissionRecords, {
@@ -127874,6 +127946,40 @@ var init_static_value_seed_records = __esm({
   }
 });
 
+// src/project-sync/compiler-metadata.ts
+function compilerMetadataChangedKeys(previous, document, changedKeys) {
+  const keys = changedKeys ?? /* @__PURE__ */ new Set([...Object.keys(previous), ...document.records.keys()]);
+  const refreshed = /* @__PURE__ */ new Set();
+  for (const key of keys) {
+    const before = previous[key];
+    const after = document.records.get(key);
+    if (before === void 0 || after === void 0 || after.deleted || before.recordId !== after.recordId || before.recordKind !== after.recordKind || !isProjectRecordKind(after.recordKind))
+      return null;
+    if (before.contentHash === after.contentHash) continue;
+    if (!isObjectRecord2(before.data) || !isObjectRecord2(after.data) || !canonicallyEqual(
+      authoredCompilerInput(after.recordKind, before.data),
+      authoredCompilerInput(after.recordKind, after.data)
+    ))
+      return null;
+    refreshed.add(key);
+  }
+  return refreshed.size === 0 ? null : refreshed;
+}
+function authoredCompilerInput(kind, data) {
+  const result = stripClientDerivedBodies(kind, data);
+  stampUILogicBodies(kind, result);
+  if (isObjectRecord2(result)) delete result.updatedAt;
+  return result;
+}
+var init_compiler_metadata = __esm({
+  "src/project-sync/compiler-metadata.ts"() {
+    "use strict";
+    init_project2();
+    init_neo_script_derived_bodies();
+    init_projection();
+  }
+});
+
 // src/commands/pull.ts
 var pull_exports = {};
 __export(pull_exports, {
@@ -127903,7 +128009,15 @@ async function runPull(workspace, options, progress = spinner("Checking local wo
 async function runNormalPull(workspace, options, progress) {
   const destructive = options.force;
   const hasBaseline = Object.keys(workspace.state.records).length > 0;
+  if (!destructive && !hasBaseline && listProjectSourceFilesV4(workspace.root).length > 0) {
+    throw new Error(
+      "Cannot merge existing Neo sources without a pull baseline in .neo/state.json. Restore that file to preserve local edits, or back up your sources and run `neo pull --force` to replace them with the server version while preserving their paths."
+    );
+  }
   const mainLocale = workspaceMainLocale(workspace.state.records);
+  const hadConflicts = Object.values(workspace.state.records).some(
+    (record5) => record5.conflictServerHash !== void 0 || record5.conflictFiles !== void 0 || record5.projectBinary?.conflict !== void 0
+  );
   if (acceptSourceEquivalentConflictBases(workspace, mainLocale) > 0) {
     writeWorkspaceState(workspace.root, workspace.state);
   }
@@ -127961,6 +128075,28 @@ async function runNormalPull(workspace, options, progress) {
     document = await fetchProjectDocument(workspace);
     nextCursor = document.revision === void 0 ? null : cursorFromRevision(document.revision);
   }
+  const compilerRefreshKeys = !destructive && hasBaseline && !hadConflicts && !options.regenerateSourceNames ? compilerMetadataChangedKeys(
+    workspace.state.records,
+    document,
+    changedRecordKeys
+  ) : null;
+  if (compilerRefreshKeys !== null) {
+    if (changedRecordKeys === null) {
+      await updateFullPullSyncMetadata(workspace, document);
+      observedHeadTransactionHash = workspace.state.headTransactionHash;
+      observedDerivedEdgeVersion = workspace.state.derivedEdgeVersion;
+    }
+    finishRecordOnlyDeltaPull({
+      workspace,
+      document,
+      changedRecordKeys: compilerRefreshKeys,
+      nextCursor,
+      observedHeadTransactionHash,
+      observedDerivedEdgeVersion,
+      progress
+    });
+    return;
+  }
   let localByKey = /* @__PURE__ */ new Map();
   let localStatus = null;
   if (hasBaseline && !destructive) {
@@ -128151,18 +128287,7 @@ async function runResetPull(workspace, progress) {
       if (record5) record5.projectBinary = state;
     }
     progress.update("Finalizing pull state\u2026");
-    try {
-      const convex = await createConvexClient(workspace);
-      const signal = await convex.query(api2.projectExportData.schemaSignal, {
-        projectId: workspace.config.projectId,
-        versionId: workspace.config.versionId
-      });
-      workspace.state.headTransactionHash = document.revision !== void 0 && signal?.transactionId === document.revision.latestTransactionId ? signal.transactionHash : null;
-      workspace.state.derivedEdgeVersion = signal?.derivedEdgeVersion ?? null;
-    } catch {
-      workspace.state.headTransactionHash = null;
-      delete workspace.state.derivedEdgeVersion;
-    }
+    await updateFullPullSyncMetadata(workspace, document);
     if (document.revision !== void 0) {
       workspace.state.documentRevisionCursor = mutableCursor(
         cursorFromRevision(document.revision)
@@ -128234,11 +128359,12 @@ async function finishFormat4Pull(args) {
       ([key, record5]) => localRecords.get(key) === record5 ? [] : [key]
     )
   );
-  const recordFiles = readWorkspaceRecordFilesV4(workspace);
+  const layoutWorkspace = workspaceForSourceLayoutV4(workspace, document);
+  const recordFiles = readWorkspaceRecordFilesV4(layoutWorkspace);
   for (const [key, record5] of localStatus?.reconstructed ?? []) {
     if (record5.file != null) recordFiles.set(key, record5.file);
   }
-  const layoutStatus = localStatus ?? (destructive ? readWorkspaceLayoutStatusV4(workspace) : null);
+  const layoutStatus = localStatus ?? (destructive ? readWorkspaceLayoutStatusV4(layoutWorkspace) : null);
   const localValues = layoutStatus?.localValues ?? workspace.state.localValues;
   const binaryPaths = workspaceBinaryPathsV4(
     workspace,
@@ -128256,6 +128382,16 @@ async function finishFormat4Pull(args) {
     buildEmitRecordSet(document, plans, "server"),
     { recordFiles, localValues, binaryPaths }
   );
+  const resolveSourcePath = createWorkspaceSourcePathResolver(workspace.root);
+  if (!destructive && Object.keys(workspace.state.records).length === 0) {
+    for (const file of localResult.files) {
+      if (existsSync8(resolveSourcePath(file.path))) {
+        throw new Error(
+          `Cannot replace existing source ${JSON.stringify(file.path)} without a pull baseline in .neo/state.json. Restore that file to preserve local edits, or back up your sources and run \`neo pull --force\` to replace them with the server version.`
+        );
+      }
+    }
+  }
   const binaries = await pullProjectBinariesV4({
     workspace,
     document,
@@ -128309,7 +128445,6 @@ async function finishFormat4Pull(args) {
   for (const key of regeneratedRecordKeys) {
     for (const path of localRecordFiles.get(key) ?? []) rewritePaths.add(path);
   }
-  const resolveSourcePath = createWorkspaceSourcePathResolver(workspace.root);
   const markedPaths = /* @__PURE__ */ new Set();
   let written = 0;
   for (const path of emittedPaths) {
@@ -128415,18 +128550,7 @@ async function finishFormat4Pull(args) {
   if (observedHeadTransactionHash !== void 0) {
     workspace.state.headTransactionHash = observedHeadTransactionHash;
   } else {
-    try {
-      const convex = await createConvexClient(workspace);
-      const signal = await convex.query(api2.projectExportData.schemaSignal, {
-        projectId: workspace.config.projectId,
-        versionId: workspace.config.versionId
-      });
-      workspace.state.headTransactionHash = document.revision !== void 0 && signal?.transactionId === document.revision.latestTransactionId ? signal.transactionHash : null;
-      workspace.state.derivedEdgeVersion = signal?.derivedEdgeVersion ?? null;
-    } catch {
-      workspace.state.headTransactionHash = null;
-      delete workspace.state.derivedEdgeVersion;
-    }
+    await updateFullPullSyncMetadata(workspace, document);
   }
   if (observedDerivedEdgeVersion !== void 0) {
     workspace.state.derivedEdgeVersion = observedDerivedEdgeVersion;
@@ -128598,6 +128722,20 @@ function finishRecordOnlyDeltaPull(args) {
     `Pulled ${args.changedRecordKeys.size} changed record(s) \u2014 0 file(s) updated \u2014 0 removed.`
   );
 }
+async function updateFullPullSyncMetadata(workspace, document) {
+  try {
+    const convex = await createConvexClient(workspace);
+    const signal = await convex.query(api2.projectExportData.schemaSignal, {
+      projectId: workspace.config.projectId,
+      versionId: workspace.config.versionId
+    });
+    workspace.state.headTransactionHash = document.revision !== void 0 && signal?.transactionId === document.revision.latestTransactionId ? signal.transactionHash : null;
+    workspace.state.derivedEdgeVersion = signal?.derivedEdgeVersion ?? null;
+  } catch {
+    workspace.state.headTransactionHash = null;
+    delete workspace.state.derivedEdgeVersion;
+  }
+}
 function cursorFromRevision(revision) {
   return {
     readBase: revision.readBase,
@@ -128755,6 +128893,7 @@ var init_pull = __esm({
     init_static_value_seed_records();
     init_static_member_ownership_recovery();
     init_value_base_desync();
+    init_compiler_metadata();
   }
 });
 
@@ -130473,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"),
@@ -131293,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
@@ -134564,6 +134706,7 @@ async function prepareLocalCandidateV4(workspace, options = {}) {
           versionId: workspace.config.versionId
         });
         workspace.state.derivedEdgeVersion = signal?.derivedEdgeVersion ?? null;
+        assertDerivedEdgeCompatibility(workspace);
       }
       preparedLocal = await prepareLocalPushArtifactsV4(
         workspace,
@@ -134903,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);
@@ -136399,7 +136543,7 @@ var init_registry2 = __esm({
   "schema-contract/registry.mjs"() {
     "use strict";
     PROJECT_SCHEMA_CONTRACT = Object.freeze({
-      cliVersion: "0.51.0",
+      cliVersion: "0.51.2",
       projectFileUploadBatchSize: 32,
       documentRecords: {
         member: {
@@ -137996,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
@@ -143628,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.0");
+    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.0",
+  "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.0 -->
+<!-- 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.0 -->
+<!-- reviewed-through-cli: 0.51.2 -->
 ```
 
 The quoted version above is checked too, so this instruction cannot go stale

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

@@ -40,9 +40,17 @@ without compiling it; use `neo status` to inspect local edits and diagnostics.
 An undo/reset metadata change invalidates the cursor and causes a safe
 full-snapshot fallback.
 
-If a compiler upgrade rejects the cached snapshot, save local edits outside the
-checkout, run `neo pull --force`, then reapply the edits. Normal pull cannot
-merge against a snapshot whose compiler revision is no longer supported.
+After a compiler upgrade, run `neo pull` with `.neo/state.json` intact. When
+remote changes affect only compiler-owned bodies or timestamps, pull refreshes
+the cached records before local compilation and leaves authored files and
+managed binaries untouched. It handles both changed-record pulls and full
+snapshot refreshes. Added or deleted records, authored changes, and unresolved
+conflicts still require the normal merge path.
+
+Keep `.neo/state.json`: it holds the merge baseline and source placements.
+Normal pull refuses existing production sources without that baseline. To
+deliberately replace a checkout whose state is gone, back it up first and use
+`neo pull --force`; the CLI recovers custom paths from the remaining declarations.
 The force pull replaces local source with the server version.
 
 Pull pins every page and snapshot batch to one published generation and logical