@neocompose/cli 0.70.0 → 0.70.2

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## [0.70.2] - 2026-10-06
+
+- After `neo push` creates, replaces or moves a project file, its committed bytes become the file's merge base at its new path, as a pull's would. Before, the re-export after the push failed for every new file with "the pull recorded no bytes for it", and for a moved file with "missing". Either failure left the Unity project marked as a local export.
+
+## [0.70.1] - 2026-10-06
+
+- `neo push` can upload a project file renamed with `@settings(name: ...)`. It used to stage the upload under the file's basename, so the commit failed with "Staged project file … did not match its source name".
+- A project file's `@settings(name: ...)` must end with its file's extension, for example `@settings(name: "ClinkingCoin1.mp3")` for `clinkingcoin1.mp3`. A pull on another machine rebuilds the file's path from that name. The symbol error now says the name needs that extension.
+- Push and pull keep `@settings(name: ...)` on a renamed file, and a new file keeps the path you gave it. Before, the rewrite after a push dropped the name and rebuilt the path from it.
+
 ## [0.70.0] - 2026-10-06
 
 - `neo export` exports the working copy, local edits included, with no network. Unity sees an edit as soon as it's saved, before `neo push`. The export says whether it holds only the pulled head ("Clean") or how many local changes it includes ("Local"). A local export is marked in `metadata.localExport`; SDK 0.59.0 refuses player builds from it and keeps play-mode saves on disk instead of the server. A clean `neo export` or a push clears the mark. A local export still stops, writing nothing, on an error diagnostic or on a project file whose pulled bytes aren't on disk yet; run `neo pull` first.

package/dist/neo.mjs

@@ -31811,7 +31811,7 @@ var init_registry = __esm({
   "../packages/manifest/schema-contract/registry.mjs"() {
     "use strict";
     PROJECT_SCHEMA_CONTRACT = Object.freeze({
-      cliVersion: "0.70.0",
+      cliVersion: "0.70.2",
       projectFileUploadBatchSize: 32,
       documentRecords: {
         member: {
@@ -60588,7 +60588,7 @@ function validateProjectFileDeclarationSymbolsV4(declarations) {
     const expected = expectedSymbols.get(declaration.recordId);
     if (expected === void 0 || declaration.symbol === expected) continue;
     throw new Error(
-      `Project file ${declaration.symbol} must use registry symbol ${expected}, derived from its persisted name ${JSON.stringify(declaration.persistedName)}. Rename the declaration or set @settings(name: ...) so the runtime derives the authored symbol.`
+      `Project file ${declaration.symbol} must use registry symbol ${expected}, derived from its persisted name ${JSON.stringify(declaration.persistedName)}. Rename the declaration, or set @settings(name: ...) to a file name ending in ${JSON.stringify(sourceExtension(declaration.persistedName))} that derives ${declaration.symbol}.`
     );
   }
 }
@@ -60621,7 +60621,6 @@ function emitProjectFileRegistrySourcesV4(records2, binaryPaths = /* @__PURE__ *
     const registryType = kind === "image" ? "ImageRegistry" : "AudioClipRegistry";
     const registryName = kind === "image" ? "Images" : "AudioClips";
     const valueType = kind === "image" ? "NeoImage" : "NeoAudioClip";
-    const directory = kind === "image" ? "Files/Images" : "Files/AudioClips";
     const entries = liveFiles.filter(({ data }) => data.fileType === kind).sort((left, right) => {
       const leftSymbol = symbols.get(left.record.recordId) ?? "";
       const rightSymbol = symbols.get(right.record.recordId) ?? "";
@@ -60638,12 +60637,16 @@ function emitProjectFileRegistrySourcesV4(records2, binaryPaths = /* @__PURE__ *
       const templateName = templateId === null ? null : (kind === "image" ? textureTemplates : audioTemplates).get(
         templateId
       );
-      const annotation2 = templateName ? `  @settings(template: ${templateName})
-` : "";
       const path = normalizeTrustedProjectBinaryPath(
-        binaryPaths.get(record6.recordId) ?? `${directory}/${safeFileName(String(data.name))}`,
+        binaryPaths.get(record6.recordId) ?? canonicalProjectBinaryPathV4(data),
         kind
       );
+      const options = [
+        ...templateName ? [`template: ${templateName}`] : [],
+        ...data.name === sourceBasename(path) ? [] : [`name: ${JSON.stringify(data.name)}`]
+      ];
+      const annotation2 = options.length === 0 ? "" : `  @settings(${options.join(", ")})
+`;
       return `  @id(${JSON.stringify(record6.recordId)})
 ${annotation2}  ${valueType} ${symbol} = new(${JSON.stringify(path)});`;
     });
@@ -60665,10 +60668,7 @@ function projectFileDeclarationsV4(analysis) {
   );
 }
 function lowerTrustedProjectFileRegistrySourcesV4(state, analysis, trustedPendingFiles = /* @__PURE__ */ new Map()) {
-  const templateIds = fileTemplateIdsByName(analysis);
-  const declarations = analysis.files.registries.flatMap(
-    (registry) => parseRegistry(registry, templateIds)
-  );
+  const declarations = projectFileDeclarationsV4(analysis);
   validateProjectFileDeclarationSymbolsV4(declarations);
   const seenPaths = /* @__PURE__ */ new Map();
   const seenSymbols = /* @__PURE__ */ new Map();
@@ -60848,7 +60848,7 @@ function canonicalProjectBinaryPathV4(data) {
   if (typeof data.name !== "string") {
     throw new Error("Project file name is missing.");
   }
-  return `${kind === "image" ? "Files/Images" : "Files/AudioClips"}/${safeFileName(data.name)}`;
+  return `${kind === "image" ? "Files/Images" : "Files/AudioClips"}/${safeProjectFileName(data.name)}`;
 }
 function fileTemplateIdsByName(analysis) {
   const templateIds = /* @__PURE__ */ new Map();
@@ -60900,13 +60900,22 @@ function parseRegistry(registry, templateIds) {
     const settings = parseFileSettings(match[2], templateIds);
     const path = JSON.parse(match[5]);
     const recordId = match[1] ? JSON.parse(match[1]) : `__pending__:project-file:${encodeURIComponent(registry.source.uri)}:${registry.source.range.start.line}:${encodeURIComponent(match[4])}`;
+    const fileName2 = sourceBasename(path);
+    if (settings.name !== null) {
+      const extension = sourceExtension(fileName2);
+      if (!settings.name.toLowerCase().endsWith(extension.toLowerCase())) {
+        throw new Error(
+          `Project file ${match[4]} @settings(name: ${JSON.stringify(settings.name)}) must end with ${JSON.stringify(extension)}, the extension of ${JSON.stringify(path)}.`
+        );
+      }
+    }
     result.push({
       recordId,
       symbol: match[4],
       path,
       kind,
       templateId: settings.templateId,
-      persistedName: settings.name ?? sourceBasename(path),
+      persistedName: settings.name ?? fileName2,
       sourceFile: registry.source.uri,
       sourceLine: registry.source.range.start.line + 1
     });
@@ -60992,7 +61001,7 @@ function templateNames(records2, kind) {
     })
   );
 }
-function safeFileName(value) {
+function safeProjectFileName(value) {
   const fileName2 = sourceBasename(value).replace(/[\\/]/g, "-");
   if (fileName2 === "." || fileName2 === ".." || fileName2.length === 0) {
     throw new Error(`Invalid project filename ${JSON.stringify(value)}.`);
@@ -61002,6 +61011,9 @@ function safeFileName(value) {
 function sourceBasename(value) {
   return value.replaceAll("\\", "/").split("/").at(-1) ?? "";
 }
+function sourceExtension(value) {
+  return /\.[^.]+$/.exec(value)?.[0] ?? "";
+}
 function optionalString(value) {
   return typeof value === "string" ? value : null;
 }
@@ -136733,10 +136745,7 @@ import {
 } from "node:fs";
 import { basename, dirname as dirname7, extname, join as join6, relative as relative2, sep as sep2 } from "node:path";
 function lowerProjectFileRegistrySourcesV4(root, state, analysis, options = {}) {
-  const templateIds = fileTemplateIdsByName2(analysis);
-  const declarations = analysis.files.registries.flatMap(
-    (registry) => parseRegistry2(registry, templateIds)
-  );
+  const declarations = projectFileDeclarationsV4(analysis);
   validateProjectFileDeclarationSymbolsV4(declarations);
   const seenPaths = /* @__PURE__ */ new Map();
   const seenSymbols = /* @__PURE__ */ new Map();
@@ -136821,14 +136830,8 @@ function lowerProjectFileRegistrySourcesV4(root, state, analysis, options = {})
     };
   });
 }
-function projectFileDeclarationsV42(analysis) {
-  const templateIds = fileTemplateIdsByName2(analysis);
-  return analysis.files.registries.flatMap(
-    (registry) => parseRegistry2(registry, templateIds)
-  );
-}
 function lowerDiscoveredProjectBinariesV4(root, state, analysis) {
-  const explicit = projectFileDeclarationsV42(analysis);
+  const explicit = projectFileDeclarationsV4(analysis);
   const project = Object.values(state).find(
     (entry) => entry.recordKind === "project" && isObjectRecord2(entry.data)
   );
@@ -136869,7 +136872,7 @@ function lowerDiscoveredProjectBinariesV4(root, state, analysis) {
   });
 }
 function inspectProjectBinaryStatusV4(root, state, analysis) {
-  const explicit = projectFileDeclarationsV42(analysis);
+  const explicit = projectFileDeclarationsV4(analysis);
   const result = explicit.map((declaration) => {
     const baseState = state[`project-file:${declaration.recordId}`];
     const data = isObjectRecord2(baseState?.data) ? baseState.data : {};
@@ -136927,16 +136930,6 @@ function inspectProjectBinaryStatusV4(root, state, analysis) {
 function pendingDiscoveredFileId(path) {
   return `__pending__:project-file:drag:${encodeURIComponent(normalizeSlash2(path))}`;
 }
-function canonicalProjectBinaryPathV42(data) {
-  if (!isObjectRecord2(data))
-    throw new Error("Project file metadata must be an object.");
-  if (data.fileType !== "image" && data.fileType !== "audio")
-    throw new Error("Project file metadata has an unsupported fileType.");
-  if (typeof data.name !== "string")
-    throw new Error("Project file metadata has no filename.");
-  const directory = data.fileType === "image" ? "Files/Images" : "Files/AudioClips";
-  return `${directory}/${safeFileName2(data.name)}`;
-}
 function discoverProjectBinariesV4(root, explicit, ignoredPaths = []) {
   const explicitPaths = new Set(
     [...explicit.map((entry) => entry.path), ...ignoredPaths].map(
@@ -137012,124 +137005,11 @@ function writeBinaryConflictArtifactV4(root, fileId, fileName2, bytes, expectedS
     "conflicts",
     "files",
     safePathSegment2(fileId),
-    safeFileName2(fileName2)
+    safeProjectFileName(fileName2)
   );
   writeVerifiedBinaryDownloadV4(destination, bytes, expectedSha256);
   return normalizeSlash2(relative2(root, destination));
 }
-function fileTemplateIdsByName2(analysis) {
-  const templateIds = /* @__PURE__ */ new Map();
-  for (const global of analysis.configuration.globals) {
-    const kind = global.type.name === "TextureTemplate" ? "texture-template" : global.type.name === "AudioTemplate" ? "audio-template" : null;
-    if (kind === null) continue;
-    templateIds.set(
-      global.name,
-      global.id ?? `__pending__:${kind}:${encodeURIComponent(global.source.uri)}:${global.source.range.start.line}:${global.source.range.start.character}:${encodeURIComponent(global.name)}`
-    );
-  }
-  return templateIds;
-}
-function parseRegistry2(registry, templateIds) {
-  const kind = registry.type.name === "ImageRegistry" ? "image" : registry.type.name === "AudioClipRegistry" ? "audio" : null;
-  if (kind === null)
-    throw new Error(
-      `Unsupported project file registry type ${registry.type.name}.`
-    );
-  const expectedName = kind === "image" ? "Images" : "AudioClips";
-  if (registry.name !== expectedName)
-    throw new Error(
-      `${registry.type.name} must use the canonical global name ${expectedName}.`
-    );
-  const body = objectInitializerBody2(registry.initializer, registry.type.name);
-  const result = [];
-  let cursor = 0;
-  while (cursor < body.length) {
-    const whitespace = /^(?:\s|\/\/[^\n]*(?:\n|$)|\/\*[\s\S]*?\*\/)+/.exec(
-      body.slice(cursor)
-    );
-    if (whitespace) cursor += whitespace[0].length;
-    if (cursor >= body.length) break;
-    REGISTRY_ENTRY2.lastIndex = cursor;
-    const match = REGISTRY_ENTRY2.exec(body);
-    if (!match)
-      throw new Error(
-        `${registry.type.name} ${registry.name} contains an invalid file declaration near ${JSON.stringify(body.slice(cursor, cursor + 80))}.`
-      );
-    const entryType = match[3];
-    if (kind === "image" && entryType !== "NeoImage" || kind === "audio" && entryType !== "NeoAudioClip") {
-      throw new Error(
-        `${registry.type.name} cannot contain ${entryType} declarations.`
-      );
-    }
-    const settings = parseFileSettings2(match[2], templateIds);
-    const path = JSON.parse(match[5]);
-    const recordId = match[1] ? JSON.parse(match[1]) : `__pending__:project-file:${encodeURIComponent(registry.source.uri)}:${registry.source.range.start.line}:${encodeURIComponent(match[4])}`;
-    result.push({
-      recordId,
-      symbol: match[4],
-      path,
-      kind,
-      templateId: settings.templateId,
-      persistedName: settings.name ?? basename(path),
-      sourceFile: registry.source.uri,
-      sourceLine: registry.source.range.start.line + 1
-    });
-    cursor = REGISTRY_ENTRY2.lastIndex;
-  }
-  return result;
-}
-function parseFileSettings2(source, templateIds) {
-  if (!source) return { templateId: null, name: null };
-  const expression = parseExpression(`new(${source})`);
-  if (expression.kind !== "new")
-    throw new Error("File @settings arguments are invalid.");
-  let templateId = null;
-  let name = null;
-  expression.args.forEach((argument2, index) => {
-    const argumentName = expression.argumentNames?.[index];
-    if (!argumentName)
-      throw new Error("File @settings arguments must be named.");
-    if (argumentName === "template") {
-      templateId = resolveTemplate2(argument2, templateIds);
-      return;
-    }
-    if (argumentName === "name") {
-      if (argument2.kind !== "litString")
-        throw new Error("File @settings name must be a string literal.");
-      name = argument2.value;
-      return;
-    }
-    throw new Error(
-      `Unknown project file @settings option ${argumentName}; expected template or name.`
-    );
-  });
-  return { templateId, name };
-}
-function resolveTemplate2(expression, templates) {
-  if (expression.kind === "litNull") return null;
-  if (expression.kind === "ident") {
-    const id2 = templates.get(expression.name);
-    if (!id2)
-      throw new Error(`Unknown file import template ${expression.name}.`);
-    return id2;
-  }
-  if (expression.kind === "call" && expression.callee.kind === "ident" && expression.callee.name === "Reference") {
-    const index = expression.argumentNames?.findIndex((name) => name === "id") ?? -1;
-    const id2 = expression.args[index >= 0 ? index : 0];
-    if (id2?.kind === "litString") return id2.value;
-  }
-  throw new Error(
-    "File template must be a template symbol, Reference(id: ...), or null."
-  );
-}
-function objectInitializerBody2(initializer, typeName) {
-  const open = initializer.indexOf("{");
-  const close = initializer.lastIndexOf("}");
-  if (!/^new\s*\(\s*\)/.test(initializer.trim()) || open < 0 || close < open) {
-    throw new Error(`${typeName} must use new() { ... }.`);
-  }
-  return initializer.slice(open + 1, close);
-}
 function optionalString3(value) {
   return typeof value === "string" ? value : null;
 }
@@ -137178,25 +137058,18 @@ function visitBinaryFiles(directory, visit) {
       visit(path);
   }
 }
-function safeFileName2(value) {
-  const fileName2 = basename(value).replace(/[\\/]/g, "-");
-  if (fileName2 === "." || fileName2 === ".." || fileName2.length === 0)
-    throw new Error(`Invalid project filename ${JSON.stringify(value)}.`);
-  return fileName2;
-}
 function safePathSegment2(value) {
   return value.replace(/[^A-Za-z0-9._-]/g, "_") || "file";
 }
 function normalizeSlash2(value) {
   return value.split(sep2).join("/").replaceAll("\\", "/");
 }
-var SUPPORTED_BINARY_TYPES, REGISTRY_ENTRY2;
+var SUPPORTED_BINARY_TYPES;
 var init_project_files = __esm({
   "src/project-source/project-files.ts"() {
     "use strict";
     init_project_file_source();
     init_workspace_source_path();
-    init_executable_parser();
     init_value_comparison();
     init_source_format();
     init_project_file_source();
@@ -137210,7 +137083,6 @@ var init_project_files = __esm({
       [".mp3", { kind: "audio", mimeType: "audio/mpeg" }],
       [".ogg", { kind: "audio", mimeType: "audio/ogg" }]
     ]);
-    REGISTRY_ENTRY2 = /(?:@id\(\s*("(?:[^"\\]|\\.)*")\s*\)\s*)?(?:@settings\(([\s\S]*?)\)\s*)?(NeoImage|NeoAudioClip)\s+([A-Za-z_][A-Za-z0-9_]*)\s*=\s*new\(\s*("(?:[^"\\]|\\.)*")\s*\)\s*;/gy;
   }
 });
 
@@ -140008,7 +139880,7 @@ async function pullProjectBinariesV4(args) {
     const previous = args.previousRecords[key];
     const localStatus = localById.get(record6.recordId);
     const declarationPresent = args.destructive === true || args.localBinaries === void 0 || previous === void 0 || localStatus !== void 0;
-    const path = localStatus?.path ?? previous?.projectBinary?.path ?? canonicalProjectBinaryPathV42(record6.data);
+    const path = localStatus?.path ?? previous?.projectBinary?.path ?? canonicalProjectBinaryPathV4(record6.data);
     const absolute = resolvePath(path);
     const localDigest = existsSync9(absolute) ? sha256File(absolute) : null;
     const baseDigest = previous?.projectBinary?.sha256 ?? readSha256(previous?.data) ?? null;
@@ -140130,7 +140002,7 @@ async function pullProjectBinariesV4(args) {
       if (previous.recordKind !== "project-file") continue;
       if (args.document.records.has(key)) continue;
       const localStatus = localById.get(previous.recordId);
-      const path = localStatus?.path ?? previous.projectBinary?.path ?? canonicalProjectBinaryPathV42(previous.data);
+      const path = localStatus?.path ?? previous.projectBinary?.path ?? canonicalProjectBinaryPathV4(previous.data);
       const absolute = resolvePath(path);
       const localDigest = existsSync9(absolute) ? sha256File(absolute) : null;
       const baseDigest = previous.projectBinary?.sha256 ?? readSha256(previous.data) ?? null;
@@ -140198,8 +140070,8 @@ async function download(data, fileId, client, workspace) {
   }
   return { bytes: response.bytes, sha256: computed };
 }
-function committedProjectBinaryStateV4(previous, data) {
-  return isObjectRecord2(data) ? binaryState(previous.path, readSha256(data), data) : previous;
+function committedProjectBinaryStateV4(path, data) {
+  return binaryState(path, readSha256(data), isObjectRecord2(data) ? data : {});
 }
 function binaryState(path, sha2562, data) {
   return {
@@ -140241,13 +140113,14 @@ var init_project_file_pull = __esm({
     init_concurrency();
     init_http();
     init_value_comparison();
+    init_project_file_source();
     init_project_files();
     DOWNLOAD_CONCURRENCY = 8;
   }
 });
 
 // src/project-source/project-file-push.ts
-import { basename as basename2, join as join11 } from "node:path";
+import { join as join11 } from "node:path";
 import { readFileSync as readFileSync13 } from "node:fs";
 import { randomUUID as randomUUID4 } from "node:crypto";
 async function cleanupRejectedProjectFilePushesV4(args) {
@@ -140323,11 +140196,17 @@ function prepareProjectFilePushesV4(args) {
     if (mimeType === null) {
       throw new Error(`Project file ${binary.path} has no MIME type.`);
     }
+    const name = change.nextData.name;
+    if (typeof name !== "string") {
+      throw new Error(
+        `Project file ${recordId} has upload bytes but its source change has no name.`
+      );
+    }
     prepared.push({
       uploadToken: `${recordId}-${prepared.length}`,
       recordId,
       replaceFileId: binary.action === "upload" ? recordId : null,
-      name: basename2(binary.path),
+      name,
       fileType: binary.kind,
       mimeType,
       byteLength: bytes.byteLength,
@@ -155834,12 +155713,12 @@ import {
   unlinkSync as unlinkSync2,
   writeFileSync as writeFileSync10
 } from "node:fs";
-import { basename as basename3, dirname as dirname8, join as join12 } from "node:path";
+import { basename as basename2, dirname as dirname8, join as join12 } from "node:path";
 function writeUnityFile(path, content) {
   mkdirSync9(dirname8(path), { recursive: true });
   const temporary = join12(
     dirname8(path),
-    `.${basename3(path)}.${randomUUID5()}.tmp`
+    `.${basename2(path)}.${randomUUID5()}.tmp`
   );
   try {
     writeFileSync10(temporary, content);
@@ -158903,6 +158782,18 @@ ${blockingErrors.map((error) => `  ${error.message}`).join("\n")}`
       data: local.fullData
     });
   }
+  for (const binary of localStatus.binaryFiles ?? []) {
+    const key = recordStateKey(
+      "project-file",
+      rewriteAssignedString(binary.fileId, replacements)
+    );
+    const record6 = nextRecords[key];
+    if (record6 === void 0 || !changedKeys.has(key)) continue;
+    nextRecords[key] = {
+      ...record6,
+      projectBinary: committedProjectBinaryStateV4(binary.path, record6.data)
+    };
+  }
   const previousState = workspace.state;
   workspace.state = {
     ...previousState,
@@ -158921,7 +158812,11 @@ ${blockingErrors.map((error) => `  ${error.message}`).join("\n")}`
           (id2) => rewritePlacementValueId(id2, replacements)
         )
       })),
-      localStatus.sourceSnapshot
+      localStatus.sourceSnapshot,
+      localStatus.binaryFiles?.map((binary) => ({
+        fileId: rewriteAssignedString(binary.fileId, replacements),
+        path: binary.path
+      }))
     );
   } catch (error) {
     workspace.state = {
@@ -159131,14 +159026,13 @@ function foldChangedRecords(previous, changedRecords) {
         `Changed record "${key}" response is missing its snapshot content hash.`
       );
     }
-    const projectBinary = records2[key]?.projectBinary;
     records2[key] = {
       recordKind,
       recordId,
       contentHash: snapshot.contentHash,
       data: changed.data,
       file: records2[key]?.file,
-      projectBinary: projectBinary && committedProjectBinaryStateV4(projectBinary, changed.data)
+      projectBinary: records2[key]?.projectBinary
     };
   }
   return records2;
@@ -159199,7 +159093,7 @@ function rewriteFilesFromState(workspace, records2 = new Map(
       data: recordState.data
     }
   ])
-), preservedSourceFiles = /* @__PURE__ */ new Map(), recordFiles = /* @__PURE__ */ new Map(), localValues = workspace.state.localValues, sourceSnapshot) {
+), preservedSourceFiles = /* @__PURE__ */ new Map(), recordFiles = /* @__PURE__ */ new Map(), localValues = workspace.state.localValues, sourceSnapshot, binaryFiles) {
   const result = emitProjectDocumentSourcesV4(
     candidateValueRecordsForEmissionV4(
       records2,
@@ -159209,7 +159103,7 @@ function rewriteFilesFromState(workspace, records2 = new Map(
     {
       recordFiles,
       localValues,
-      binaryPaths: workspaceBinaryPathsV4(workspace)
+      binaryPaths: workspaceBinaryPathsV4(workspace, binaryFiles)
     }
   );
   workspace.state.localValues = localValues;
@@ -172920,7 +172814,7 @@ import {
   writeFileSync as writeFileSync15
 } from "node:fs";
 import {
-  basename as basename4,
+  basename as basename3,
   dirname as dirname12,
   isAbsolute as isAbsolute3,
   join as join20,
@@ -173364,7 +173258,7 @@ function selectedSpecPaths(workspace, selectors) {
   for (const selector of normalizedSelectors) {
     if (selector.includes("/") || /[*?]/u.test(selector)) continue;
     const basenameMatches = [...relativePaths.values()].filter(
-      (path) => basename4(path) === selector
+      (path) => basename3(path) === selector
     );
     if (basenameMatches.length > 1) {
       throw new Error(
@@ -173373,7 +173267,7 @@ function selectedSpecPaths(workspace, selectors) {
     }
   }
   const configuredIncludes = workspace.config.test?.include ?? [];
-  const selectorMatches = (selector, path) => path === selector || basename4(path) === selector || path.startsWith(`${selector.replace(/\/$/u, "")}/`) || globMatches(selector, path);
+  const selectorMatches = (selector, path) => path === selector || basename3(path) === selector || path.startsWith(`${selector.replace(/\/$/u, "")}/`) || globMatches(selector, path);
   const selectedPaths = all.filter((absolutePath) => {
     const path = relativePaths.get(absolutePath);
     const configured = configuredIncludes.length === 0 || configuredIncludes.some((pattern) => globMatches(pattern, path));
@@ -174135,14 +174029,14 @@ function maintainNeoTestBuildCache(root, maxBytes = TEST_BUILD_CACHE_LIMIT_BYTES
     return fromProtected === "" || !fromProtected.startsWith(`..${sep9}`) && fromProtected !== ".." && !isAbsolute3(fromProtected);
   };
   for (const file of testBuildFiles(root)) {
-    if (!isProtected(file.path) && basename4(file.path).includes(".tmp-") && now - file.modifiedMs >= ABANDONED_TEMP_MAX_AGE_MS) {
+    if (!isProtected(file.path) && basename3(file.path).includes(".tmp-") && now - file.modifiedMs >= ABANDONED_TEMP_MAX_AGE_MS) {
       rmSync10(file.path, { force: true });
     }
   }
   const files = testBuildFiles(root);
   let total = files.reduce((sum, file) => sum + file.size, 0);
   const removable = files.filter(
-    (file) => basename4(file.path) !== "manifest.json" && !isProtected(file.path)
+    (file) => basename3(file.path) !== "manifest.json" && !isProtected(file.path)
   ).sort((left, right) => left.modifiedMs - right.modifiedMs);
   for (const file of removable) {
     if (total <= maxBytes) break;
@@ -180887,7 +180781,7 @@ __export(dev_exports, {
   runDev: () => runDev
 });
 import { watch } from "node:fs";
-import { basename as basename5, dirname as dirname13 } from "node:path";
+import { basename as basename4, dirname as dirname13 } from "node:path";
 import { emitKeypressEvents } from "node:readline";
 async function runDev(loadWorkspace2, options) {
   const root = loadWorkspace2().root;
@@ -180924,7 +180818,7 @@ async function runDev(loadWorkspace2, options) {
   const watchConfigAsset = (path) => {
     if (configWatch?.path === path) return;
     configWatch?.watcher.close();
-    const name = basename5(path);
+    const name = basename4(path);
     const watcher = watch(dirname13(path), (_event, filename) => {
       if (filename === name) schedule();
     });
@@ -181391,7 +181285,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.70.0");
+    console.log("0.70.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.70.0",
+  "version": "0.70.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.70.0 -->
+<!-- reviewed-through-cli: 0.70.2 -->
 
 # Neo Compose CLI
 
@@ -237,7 +237,9 @@ Registry declarations and their image/audio paths may be in any project folder
 outside ignored/private directories. Update the registry path when moving a
 binary file. Renaming the registry symbol or replacing bytes retains the file
 ID when the declaration keeps its `@id`; keep the symbol aligned with the
-persisted file name, or set `@settings(name: ...)` explicitly.
+persisted file name, or set `@settings(name: ...)` explicitly. The name must
+end with the binary's extension, as in `@settings(name: "ClinkingCoin1.mp3")`,
+because pull rebuilds the file's path from it.
 Omitting `@settings(template: ...)` uses the complete built-in Unity import
 defaults for that file kind.
 

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

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

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

@@ -263,7 +263,8 @@ Registry symbols derive deterministically from the persisted file name. For
 example, `tree.cherryblossom.png` becomes `TreeCherryblossom`. Keep an authored
 declaration aligned with that spelling, or set an explicit persisted name such
 as `@settings(name: "TreeCherryBlossom.png")` when the binary path should stay
-different. With no template annotation, the CLI persists the complete built-in
+different. The name must end with the binary's extension, because pull
+rebuilds the file's path from it. With no template annotation, the CLI persists the complete built-in
 Unity defaults for the file kind.
 
 Pull/push compare server-verified SHA-256, not storage ETags. A divergent