@neocompose/cli 0.58.1 → 0.58.2

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## [0.58.2] - 2026-09-24
+
+- Pull downloads up to eight managed image or audio files concurrently. Matching local bytes are still reused.
+- Pull verifies and stages all downloaded files before replacing local binaries or updating conflict artifacts. A failed transfer leaves existing files intact.
+
 ## [0.58.1] - 2026-09-24
 
 - Push writes `@id` on list entries nested inside a new computed row, such as the items of a list on a new `new Event(...) { ... }` entry, so `neo status` is clean afterwards. Before, those entries stayed without ids and status kept reporting changes.

package/dist/neo.mjs

@@ -92493,7 +92493,8 @@ function planCommitPreparationLoadedClosureScope(args) {
     if (rules.has("ancestor-paths") && record6.parentRecordKind !== null && record6.parentRecordKind !== void 0 && record6.parentRecordId !== null && record6.parentRecordId !== void 0) {
       rememberExact(record6.parentRecordKind, record6.parentRecordId);
     }
-    const canOwnStoredDescendants = record6.recordKind !== "value" || !isLiteralValueContent(record6.data) || !["string", "number", "boolean"].includes(typeof record6.data.value) || typeof record6.data.classId === "string" || isVirtualInstanceRootShape(record6.data);
+    const memberWithoutStoredChildren = record6.recordKind === "member" && isMemberBase(record6.data) && getOptionalString(record6.data, "valueId") === void 0 && record6.data.defaultValue === void 0;
+    const canOwnStoredDescendants = !memberWithoutStoredChildren && (record6.recordKind !== "value" || !isLiteralValueContent(record6.data) || !["string", "number", "boolean"].includes(typeof record6.data.value) || typeof record6.data.classId === "string" || isVirtualInstanceRootShape(record6.data));
     if (rules.has("descendants") && record6.includeDescendants !== false && canOwnStoredDescendants && (record6.recordKind === "member" || record6.recordKind === "value" || record6.recordKind === "class" || record6.recordKind === "variant")) {
       rememberRange({
         rangeKind: "children",
@@ -131065,6 +131066,35 @@ var init_push_hook = __esm({
   }
 });
 
+// src/concurrency.ts
+async function mapWithConcurrency(values, concurrency, run) {
+  let nextIndex = 0;
+  let failure;
+  const results = new Array(values.length);
+  const worker = async () => {
+    while (failure === void 0) {
+      const index = nextIndex;
+      nextIndex += 1;
+      if (index >= values.length) return;
+      try {
+        results[index] = await run(values[index], index);
+      } catch (error) {
+        failure ??= { error };
+      }
+    }
+  };
+  await Promise.all(
+    Array.from({ length: Math.min(concurrency, values.length) }, worker)
+  );
+  if (failure !== void 0) throw failure.error;
+  return results;
+}
+var init_concurrency = __esm({
+  "src/concurrency.ts"() {
+    "use strict";
+  }
+});
+
 // src/project-source/project-file-push.ts
 import { basename as basename2, join as join9 } from "node:path";
 import { readFileSync as readFileSync11 } from "node:fs";
@@ -131493,28 +131523,6 @@ async function waitForRetry(attempt, signal) {
     signal.addEventListener("abort", abort, { once: true });
   });
 }
-async function mapWithConcurrency(values, concurrency, run) {
-  let nextIndex = 0;
-  let firstError;
-  const results = new Array(values.length);
-  const worker = async () => {
-    while (firstError === void 0) {
-      const index = nextIndex;
-      nextIndex += 1;
-      if (index >= values.length) return;
-      try {
-        results[index] = await run(values[index]);
-      } catch (error) {
-        firstError ??= error;
-      }
-    }
-  };
-  await Promise.all(
-    Array.from({ length: Math.min(concurrency, values.length) }, worker)
-  );
-  if (firstError !== void 0) throw firstError;
-  return results;
-}
 function combineSignals(...signals) {
   const defined = signals.filter(
     (signal) => signal !== void 0
@@ -131545,6 +131553,7 @@ var UPLOAD_CONCURRENCY, PRESIGN_BATCH_SIZE, MULTIPART_PART_CONCURRENCY, PRESIGN_
 var init_project_file_push = __esm({
   "src/project-source/project-file-push.ts"() {
     "use strict";
+    init_concurrency();
     init_project_files();
     init_projection();
     init_src();
@@ -136245,11 +136254,19 @@ var init_reset = __esm({
 });
 
 // src/project-source/project-file-pull.ts
-import { existsSync as existsSync11, rmSync as rmSync7 } from "node:fs";
+import {
+  existsSync as existsSync11,
+  mkdtempSync,
+  readFileSync as readFileSync15,
+  rmSync as rmSync7,
+  writeFileSync as writeFileSync10
+} from "node:fs";
+import { tmpdir } from "node:os";
 import { join as join13 } from "node:path";
 async function pullProjectBinariesV4(args) {
   const resolvePath = createWorkspaceSourcePathResolver(args.workspace.root);
-  let client = args.client ?? null;
+  const plans = /* @__PURE__ */ new Map();
+  const downloads = [];
   const localById = new Map(
     (args.localBinaries ?? []).map((binary) => [binary.fileId, binary])
   );
@@ -136263,7 +136280,14 @@ async function pullProjectBinariesV4(args) {
       throw new Error(`project-file:${record6.recordId} must be an object.`);
     }
     if (record6.data.status !== "uploaded") continue;
-    client ??= NeoApiClient.forBaseUrl(args.workspace.config.apiBaseUrl);
+    const existing = plans.get(record6.recordId);
+    if (existing !== void 0) {
+      if (existing.contentHash !== record6.contentHash)
+        throw new Error(
+          `Project file ${record6.recordId} appears with conflicting content hashes in the pulled document.`
+        );
+      continue;
+    }
     const key = `project-file:${record6.recordId}`;
     const previous = args.previousRecords[key];
     const localStatus = localById.get(record6.recordId);
@@ -136276,7 +136300,6 @@ async function pullProjectBinariesV4(args) {
       record6.data,
       `project-file:${record6.recordId} metadata`
     );
-    let remoteBytes = null;
     let action = planBinaryMergeV4({
       baseDigest,
       localDigest,
@@ -136287,98 +136310,142 @@ async function pullProjectBinariesV4(args) {
     if (args.destructive === true) {
       action = localDigest === remoteDigest ? "unchanged" : "download";
     }
-    if (action === "download" || action === "conflict") {
-      if (remoteBytes === null) {
-        const response = await download(
-          record6.data,
-          record6.recordId,
-          client,
-          args.workspace
-        );
-        remoteBytes = response.bytes;
-        if (response.sha256 !== remoteDigest) {
+    const plan = {
+      key,
+      fileId: record6.recordId,
+      contentHash: record6.contentHash,
+      data: record6.data,
+      previous,
+      path,
+      baseDigest,
+      remoteDigest,
+      action
+    };
+    plans.set(record6.recordId, plan);
+    if (action === "download" || action === "conflict") downloads.push(plan);
+  }
+  let stagingDirectory;
+  try {
+    const stagedPaths = /* @__PURE__ */ new Map();
+    if (downloads.length > 0) {
+      stagingDirectory = mkdtempSync(join13(tmpdir(), "neo-pull-files-"));
+      const directory = stagingDirectory;
+      const client = args.client ?? NeoApiClient.forBaseUrl(args.workspace.config.apiBaseUrl);
+      await mapWithConcurrency(
+        downloads,
+        DOWNLOAD_CONCURRENCY,
+        async (plan, index) => {
+          const response = await download(
+            plan.data,
+            plan.fileId,
+            client,
+            args.workspace
+          );
+          if (response.sha256 !== plan.remoteDigest) {
+            throw new Error(
+              `Project file ${plan.fileId} content changed while pull was in progress (${plan.remoteDigest} -> ${response.sha256}). Pull again against a stable version head.`
+            );
+          }
+          const stagedPath = join13(directory, String(index));
+          writeFileSync10(stagedPath, response.bytes);
+          stagedPaths.set(plan.fileId, stagedPath);
+        }
+      );
+    }
+    for (const plan of plans.values()) {
+      const {
+        key,
+        fileId,
+        data,
+        previous,
+        path,
+        baseDigest,
+        remoteDigest,
+        action
+      } = plan;
+      const absolute = resolvePath(path);
+      const stagedPath = stagedPaths.get(fileId);
+      const remoteBytes = stagedPath === void 0 ? null : readFileSync15(stagedPath);
+      if (action === "download") {
+        if (remoteBytes === null) {
           throw new Error(
-            `Project file ${record6.recordId} content changed while pull was in progress (${remoteDigest} -> ${response.sha256}). Pull again against a stable version head.`
+            `Project file ${fileId} download plan has no verified remote bytes.`
           );
         }
+        writeVerifiedBinaryDownloadV4(absolute, remoteBytes, remoteDigest);
+        downloaded += 1;
+        states.set(key, binaryState(path, remoteDigest, data));
+        continue;
       }
-    }
-    if (action === "download") {
-      if (remoteBytes === null) {
-        throw new Error(
-          `Project file ${record6.recordId} download plan has no verified remote bytes.`
-        );
+      if (action === "conflict") {
+        if (remoteBytes === null) {
+          throw new Error(
+            `Project file ${fileId} conflict plan has no verified remote bytes.`
+          );
+        }
+        const artifactPath = writeBinaryConflictArtifactV4(
+          args.workspace.root,
+          fileId,
+          fileName(data),
+          remoteBytes,
+          remoteDigest
+        );
+        const state = binaryState(path, baseDigest, data);
+        states.set(key, {
+          ...state,
+          conflict: {
+            action: "conflict",
+            remoteSha256: remoteDigest,
+            artifactPath
+          }
+        });
+        conflicts.push(path);
+        conflicted += 1;
+        continue;
       }
-      writeVerifiedBinaryDownloadV4(absolute, remoteBytes, remoteDigest);
-      downloaded += 1;
-      states.set(key, binaryState(path, remoteDigest, record6.data));
-      continue;
-    }
-    if (action === "conflict") {
-      if (remoteBytes === null) {
-        throw new Error(
-          `Project file ${record6.recordId} conflict plan has no verified remote bytes.`
-        );
+      if (action === "converged" || action === "unchanged") {
+        states.set(key, binaryState(path, remoteDigest, data));
+        removePreviousConflict(args.workspace.root, previous?.projectBinary);
+        continue;
       }
-      const artifactPath = writeBinaryConflictArtifactV4(
-        args.workspace.root,
-        record6.recordId,
-        fileName(record6.data),
-        remoteBytes,
-        remoteDigest
-      );
-      const state = binaryState(path, baseDigest, record6.data);
-      states.set(key, {
-        ...state,
-        conflict: {
-          action: "conflict",
-          remoteSha256: remoteDigest,
-          artifactPath
-        }
-      });
-      conflicts.push(path);
-      conflicted += 1;
-      continue;
-    }
-    if (action === "converged" || action === "unchanged") {
-      states.set(key, binaryState(path, remoteDigest, record6.data));
-      removePreviousConflict(args.workspace.root, previous?.projectBinary);
-      continue;
-    }
-    states.set(key, binaryState(path, baseDigest, record6.data));
-  }
-  for (const [key, previous] of Object.entries(args.previousRecords)) {
-    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 absolute = resolvePath(path);
-    const localDigest = existsSync11(absolute) ? sha256File(absolute) : null;
-    const baseDigest = previous.projectBinary?.sha256 ?? readSha256(previous.data) ?? null;
-    const action = planBinaryMergeV4({
-      baseDigest,
-      localDigest,
-      remoteDigest: null,
-      declarationPresent: localStatus !== void 0,
-      hadLocalBytes: previous.projectBinary !== void 0
-    });
-    if (action === "delete-modify") {
-      const data = isObjectRecord2(previous.data) ? previous.data : {};
-      states.set(key, {
-        ...binaryState(path, baseDigest, data),
-        conflict: {
-          action: "delete-modify",
-          remoteSha256: null
-        }
+      states.set(key, binaryState(path, baseDigest, data));
+    }
+    for (const [key, previous] of Object.entries(args.previousRecords)) {
+      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 absolute = resolvePath(path);
+      const localDigest = existsSync11(absolute) ? sha256File(absolute) : null;
+      const baseDigest = previous.projectBinary?.sha256 ?? readSha256(previous.data) ?? null;
+      const action = planBinaryMergeV4({
+        baseDigest,
+        localDigest,
+        remoteDigest: null,
+        declarationPresent: localStatus !== void 0,
+        hadLocalBytes: previous.projectBinary !== void 0
       });
-      conflicts.push(path);
-      conflicted += 1;
-      continue;
+      if (action === "delete-modify") {
+        const data = isObjectRecord2(previous.data) ? previous.data : {};
+        states.set(key, {
+          ...binaryState(path, baseDigest, data),
+          conflict: {
+            action: "delete-modify",
+            remoteSha256: null
+          }
+        });
+        conflicts.push(path);
+        conflicted += 1;
+        continue;
+      }
+      rmSync7(absolute, { force: true });
+      removePreviousConflict(args.workspace.root, previous.projectBinary);
     }
-    rmSync7(absolute, { force: true });
-    removePreviousConflict(args.workspace.root, previous.projectBinary);
+    return { states, downloaded, conflicted, conflicts };
+  } finally {
+    if (stagingDirectory !== void 0)
+      rmSync7(stagingDirectory, { recursive: true, force: true });
   }
-  return { states, downloaded, conflicted, conflicts };
 }
 async function download(data, fileId, client, workspace) {
   const version = typeof data.storageETag === "string" ? `?v=${encodeURIComponent(data.storageETag)}` : "";
@@ -136447,13 +136514,16 @@ function removePreviousConflict(root, state) {
   if (state?.conflict?.artifactPath === void 0) return;
   rmSync7(join13(root, state.conflict.artifactPath), { force: true });
 }
+var DOWNLOAD_CONCURRENCY;
 var init_project_file_pull = __esm({
   "src/project-source/project-file-pull.ts"() {
     "use strict";
     init_workspace_source_path();
+    init_concurrency();
     init_http();
     init_projection();
     init_project_files();
+    DOWNLOAD_CONCURRENCY = 8;
   }
 });
 
@@ -136578,10 +136648,10 @@ __export(pull_exports, {
 });
 import {
   mkdirSync as mkdirSync10,
-  writeFileSync as writeFileSync10,
+  writeFileSync as writeFileSync11,
   rmSync as rmSync8,
   existsSync as existsSync12,
-  readFileSync as readFileSync15
+  readFileSync as readFileSync16
 } from "node:fs";
 import { dirname as dirname9 } from "node:path";
 async function runPull(workspace, options, progress = spinner("Checking local workspace\u2026")) {
@@ -137048,7 +137118,7 @@ async function finishFormat4Pull(args) {
   let written = 0;
   for (const path of emittedPaths) {
     const absolute = resolveSourcePath(path);
-    const existing = existsSync12(absolute) ? readFileSync15(absolute, "utf8") : null;
+    const existing = existsSync12(absolute) ? readFileSync16(absolute, "utf8") : null;
     const unprojectedConflictKeys = authoredLocalConflictKeysByPath.get(path) ?? [];
     if (unprojectedConflictKeys.length > 0 && existing === null) {
       throw new Error(
@@ -137070,7 +137140,7 @@ async function finishFormat4Pull(args) {
     mkdirSync10(dirname9(absolute), { recursive: true });
     if (existing !== null && !marked && !rewritePaths.has(path)) continue;
     if (existing !== content) {
-      writeFileSync10(absolute, content, "utf8");
+      writeFileSync11(absolute, content, "utf8");
       written += 1;
     }
   }
@@ -137504,7 +137574,7 @@ var init_exports = {};
 __export(init_exports, {
   runInit: () => runInit
 });
-import { existsSync as existsSync13, mkdirSync as mkdirSync11, readFileSync as readFileSync16, writeFileSync as writeFileSync11 } from "node:fs";
+import { existsSync as existsSync13, mkdirSync as mkdirSync11, readFileSync as readFileSync17, writeFileSync as writeFileSync12 } from "node:fs";
 import { join as join14, resolve as resolve3 } from "node:path";
 async function runInit(options) {
   let projectId = options.projectId;
@@ -137629,13 +137699,13 @@ async function runInit(options) {
 }
 function ensurePrivateStateIgnored(root) {
   const path = join14(root, ".gitignore");
-  const existing = existsSync13(path) ? readFileSync16(path, "utf8") : "";
+  const existing = existsSync13(path) ? readFileSync17(path, "utf8") : "";
   if (existing.split(/\r?\n/u).some((line) => line.trim() === ".neo/" || line.trim() === ".neo")) {
     return;
   }
   const prefix = existing.length === 0 || existing.endsWith("\n") ? existing : `${existing}
 `;
-  writeFileSync11(path, `${prefix}.neo/
+  writeFileSync12(path, `${prefix}.neo/
 `, "utf8");
 }
 var init_init = __esm({
@@ -139039,7 +139109,7 @@ __export(script_exports, {
   readDocumentArrays: () => readDocumentArrays,
   runScript: () => runScript
 });
-import { readFileSync as readFileSync17 } from "node:fs";
+import { readFileSync as readFileSync18 } from "node:fs";
 function readDocumentArrays(raw) {
   const arrayOf2 = (field) => {
     const value = raw[field];
@@ -139559,9 +139629,9 @@ function buildRootValue(document, lookups) {
 }
 function readSource(options, fallback) {
   if (options.source !== null) return options.source;
-  if (options.file !== null) return readFileSync17(options.file, "utf8");
+  if (options.file !== null) return readFileSync18(options.file, "utf8");
   if (fallback !== void 0) return fallback;
-  const stdin = readFileSync17(0, "utf8");
+  const stdin = readFileSync18(0, "utf8");
   if (stdin.trim().length === 0) {
     throw new Error(
       "Provide NeoScript source as an argument, --file, or stdin."
@@ -140610,7 +140680,7 @@ var init_registry2 = __esm({
   "schema-contract/registry.mjs"() {
     "use strict";
     PROJECT_SCHEMA_CONTRACT = Object.freeze({
-      cliVersion: "0.58.1",
+      cliVersion: "0.58.2",
       projectFileUploadBatchSize: 32,
       documentRecords: {
         member: {
@@ -142038,12 +142108,12 @@ import {
   existsSync as existsSync14,
   mkdirSync as mkdirSync12,
   readdirSync as readdirSync4,
-  readFileSync as readFileSync18,
+  readFileSync as readFileSync19,
   realpathSync as realpathSync2,
   renameSync as renameSync7,
   rmSync as rmSync9,
   statSync as statSync2,
-  writeFileSync as writeFileSync12
+  writeFileSync as writeFileSync13
 } from "node:fs";
 import {
   basename as basename3,
@@ -142257,7 +142327,7 @@ function preparedHookCandidate(workspace) {
       );
     }
     const parsed = JSON.parse(
-      readFileSync18(join15(directory, "candidate.json"), "utf8")
+      readFileSync19(join15(directory, "candidate.json"), "utf8")
     );
     if (!isRecord10(parsed)) {
       throw new NeoTestPreparedCandidateError(
@@ -142327,7 +142397,7 @@ function testCandidateCachePath(workspace, inputFingerprint) {
 function cachedTestCandidate(workspace, inputFingerprint) {
   try {
     const candidatePath = testCandidateCachePath(workspace, inputFingerprint);
-    const parsed = JSON.parse(readFileSync18(candidatePath, "utf8"));
+    const parsed = JSON.parse(readFileSync19(candidatePath, "utf8"));
     if (!isRecord10(parsed)) return null;
     if (parsed.version !== 1) return null;
     if (parsed.candidateRevision !== TEST_CANDIDATE_CACHE_REVISION) return null;
@@ -142338,7 +142408,7 @@ function cachedTestCandidate(workspace, inputFingerprint) {
       return null;
     }
     if (typeof parsed.documentSha256 !== "string") return null;
-    const documentJson = readFileSync18(
+    const documentJson = readFileSync19(
       join15(dirname10(candidatePath), "document.json"),
       "utf8"
     );
@@ -142378,7 +142448,7 @@ function cacheTestCandidate(workspace, inputFingerprint, candidate) {
 function compileSpec(workspace, document, absolutePath, projectCompilationHash2) {
   const scriptDocument = readDocumentArrays(document);
   const path = relative8(workspace.root, absolutePath).split(sep8).join("/");
-  const source = readFileSync18(absolutePath, "utf8");
+  const source = readFileSync19(absolutePath, "utf8");
   const sourceHash = createHash11("sha256").update(source).digest("hex");
   const artifactPath = join15(
     workspace.root,
@@ -142389,7 +142459,7 @@ function compileSpec(workspace, document, absolutePath, projectCompilationHash2)
     `${sourceHash}.json`
   );
   try {
-    const cached = JSON.parse(readFileSync18(artifactPath, "utf8"));
+    const cached = JSON.parse(readFileSync19(artifactPath, "utf8"));
     if (isRecord10(cached) && cached.version === 1 && cached.compilerRevision === NEOSCRIPT_COMPILER_REVISION && cached.projectCompilationHash === projectCompilationHash2 && cached.sourceHash === sourceHash && isRecord10(cached.action) && typeof cached.artifactSha256 === "string" && createHash11("sha256").update(JSON.stringify(cached.action)).digest("hex") === cached.artifactSha256 && cached.action.compilerRevision === NEOSCRIPT_COMPILER_REVISION && Array.isArray(cached.action.parameters) && Array.isArray(cached.action.instructions) && isRecord10(cached.action.typeInfo)) {
       return {
         path,
@@ -143206,7 +143276,7 @@ async function executeRegisteredSpec(registered, document, selected, timeoutMs,
 function atomicWrite(path, content) {
   mkdirSync12(dirname10(path), { recursive: true });
   const temporary = `${path}.tmp-${String(process.pid)}-${randomUUID6()}`;
-  writeFileSync12(temporary, content, "utf8");
+  writeFileSync13(temporary, content, "utf8");
   renameSync7(temporary, path);
 }
 function testBuildFiles(root) {
@@ -143752,7 +143822,7 @@ import {
   constants as fsConstants,
   accessSync,
   existsSync as existsSync15,
-  readFileSync as readFileSync19
+  readFileSync as readFileSync20
 } from "node:fs";
 import { extname as extname2, isAbsolute as isAbsolute4, join as join16, relative as relative9, sep as sep9 } from "node:path";
 function inspectNeoDoctor(workspace) {
@@ -143837,7 +143907,7 @@ function inspectSourceContract(workspace) {
   );
   try {
     const inputs = files.map((file, index) => {
-      const text = readFileSync19(file, "utf8");
+      const text = readFileSync20(file, "utf8");
       return {
         uri: relativeFiles[index],
         kind: requiredProjectSourceKindV4(relativeFiles[index], text),
@@ -143885,7 +143955,7 @@ function inspectExtensionContract(root) {
     };
   }
   try {
-    const value = JSON.parse(readFileSync19(cachePath, "utf8"));
+    const value = JSON.parse(readFileSync20(cachePath, "utf8"));
     assertProjectSourceAnalysisV4(value);
     return {
       id: NEO_VSCODE_EXTENSION_ID,
@@ -144231,7 +144301,7 @@ __export(migrate_exports, {
   runMigrate: () => runMigrate
 });
 import { randomUUID as randomUUID7 } from "node:crypto";
-import { existsSync as existsSync16, mkdirSync as mkdirSync13, readFileSync as readFileSync20, writeFileSync as writeFileSync13 } from "node:fs";
+import { existsSync as existsSync16, mkdirSync as mkdirSync13, readFileSync as readFileSync21, writeFileSync as writeFileSync14 } from "node:fs";
 import { join as join17, relative as relative10 } from "node:path";
 async function runMigrate(workspace, subcommand, positional, targetRef, json, dependencies = {}) {
   if (subcommand === "new") {
@@ -144245,7 +144315,7 @@ async function runMigrate(workspace, subcommand, positional, targetRef, json, de
     mkdirSync13(migrationsDir, { recursive: true });
     let nextOrder = 1;
     for (const path of listProjectSourceFilesV4(workspace.root)) {
-      const source = readFileSync20(path, "utf8");
+      const source = readFileSync21(path, "utf8");
       if (neoProjectSourceKind(path, source) !== "migration") continue;
       const migration = parseMigrationFile(
         source,
@@ -144268,7 +144338,7 @@ async function runMigrate(workspace, subcommand, positional, targetRef, json, de
       target === "project" ? "// Runs once with root context. Write the NeoScript action below." : `// Runs once per ${target} value; \`this\` is the instance.`,
       ""
     ].join("\n");
-    writeFileSync13(absolute, template, "utf8");
+    writeFileSync14(absolute, template, "utf8");
     console.log(`Created ${relPath} \u2014 edit the action body, then "neo push".`);
     console.log("(The id is assigned at push, same as schema creates.)");
     return;
@@ -146431,7 +146501,7 @@ __export(content_exports, {
   makeContentContext: () => makeContentContext,
   runLoc: () => runLoc
 });
-import { readFileSync as readFileSync21 } from "node:fs";
+import { readFileSync as readFileSync22 } from "node:fs";
 import { randomUUID as randomUUID8 } from "node:crypto";
 function versionPath2(workspace, suffix) {
   return `/api/projects/${workspace.config.projectId}/versions/${workspace.config.versionId}/${suffix}`;
@@ -146439,9 +146509,9 @@ function versionPath2(workspace, suffix) {
 function readBatch(file) {
   let raw = null;
   if (file !== null) {
-    raw = readFileSync21(file, "utf8");
+    raw = readFileSync22(file, "utf8");
   } else if (!process.stdin.isTTY) {
-    raw = readFileSync21(0, "utf8");
+    raw = readFileSync22(0, "utf8");
     if (raw.trim().length === 0) raw = null;
   }
   if (raw === null) return null;
@@ -147689,9 +147759,9 @@ import { createHash as createHash12 } from "node:crypto";
 import {
   existsSync as existsSync17,
   mkdirSync as mkdirSync14,
-  readFileSync as readFileSync22,
+  readFileSync as readFileSync23,
   unlinkSync,
-  writeFileSync as writeFileSync14
+  writeFileSync as writeFileSync15
 } from "node:fs";
 import { dirname as dirname11, join as join18 } from "node:path";
 function validatePath(path) {
@@ -147702,7 +147772,7 @@ function validatePath(path) {
 }
 function readManifest(path) {
   if (!existsSync17(path)) return null;
-  const data = JSON.parse(readFileSync22(path, "utf8"));
+  const data = JSON.parse(readFileSync23(path, "utf8"));
   if (data === null || typeof data !== "object" || !("schemaVersion" in data) || data.schemaVersion !== 1)
     throw new Error(`Invalid generated-file manifest version: ${path}`);
   if (!("files" in data) || !Array.isArray(data.files) || data.files.length === 0)
@@ -147782,7 +147852,7 @@ function writeUnityGeneratedFiles(directory, projectId, files) {
       const meta = join18(directory, old.path + ".meta");
       operations.push([
         path + ".meta",
-        existsSync17(meta) ? readFileSync22(meta, "utf8") : null
+        existsSync17(meta) ? readFileSync23(meta, "utf8") : null
       ]);
     }
     operations.push([path, file.content]);
@@ -147809,7 +147879,7 @@ function writeUnityGeneratedFiles(directory, projectId, files) {
     if (!previous.has(key))
       previous.set(key, {
         path,
-        content: existsSync17(path) ? readFileSync22(path, "utf8") : null
+        content: existsSync17(path) ? readFileSync23(path, "utf8") : null
       });
   }
   const write = (path, content) => {
@@ -147817,13 +147887,13 @@ function writeUnityGeneratedFiles(directory, projectId, files) {
       if (existsSync17(path)) unlinkSync(path);
     } else {
       mkdirSync14(dirname11(path), { recursive: true });
-      writeFileSync14(path, content);
+      writeFileSync15(path, content);
     }
   };
   const changed = [];
   try {
     for (const [path, content] of operations) {
-      const current = existsSync17(path) ? readFileSync22(path, "utf8") : null;
+      const current = existsSync17(path) ? readFileSync23(path, "utf8") : null;
       if (current === content) continue;
       changed.push(path);
       write(path, content);
@@ -147836,7 +147906,7 @@ function writeUnityGeneratedFiles(directory, projectId, files) {
       restored.add(key);
       const original = previous.get(key);
       if (original.path !== path && existsSync17(path)) unlinkSync(path);
-      const current = existsSync17(original.path) ? readFileSync22(original.path, "utf8") : null;
+      const current = existsSync17(original.path) ? readFileSync23(original.path, "utf8") : null;
       if (current !== original.content) write(original.path, original.content);
     }
     throw error;
@@ -147853,7 +147923,7 @@ var export_exports = {};
 __export(export_exports, {
   runExportUnity: () => runExportUnity
 });
-import { mkdirSync as mkdirSync15, writeFileSync as writeFileSync15 } from "node:fs";
+import { mkdirSync as mkdirSync15, writeFileSync as writeFileSync16 } from "node:fs";
 import { join as join19 } from "node:path";
 async function runExportUnity(workspace, outDir) {
   if (outDir === null) {
@@ -147876,9 +147946,9 @@ async function runExportUnity(workspace, outDir) {
     response.projectId,
     response.generatedFiles
   );
-  writeFileSync15(join19(resourcesDir, "project.json"), response.projectJson);
+  writeFileSync16(join19(resourcesDir, "project.json"), response.projectJson);
   for (const file of response.localizationFiles ?? []) {
-    writeFileSync15(join19(localizationDir, file.fileName), file.content);
+    writeFileSync16(join19(localizationDir, file.fileName), file.content);
   }
   console.log(`wrote ${join19(resourcesDir, "project.json")}`);
   console.log(`synchronized generated files in ${scriptsDir}`);
@@ -148077,7 +148147,7 @@ __export(resolve_exports, {
   resolveMarkers: () => resolveMarkers,
   runResolve: () => runResolve
 });
-import { readFileSync as readFileSync23, rmSync as rmSync10, writeFileSync as writeFileSync16 } from "node:fs";
+import { readFileSync as readFileSync24, rmSync as rmSync10, writeFileSync as writeFileSync17 } from "node:fs";
 import { join as join21, relative as relative11 } from "node:path";
 function runResolve(workspace, side) {
   const marked = readMarkedProjectSourcesV4(workspace.root);
@@ -148088,7 +148158,7 @@ function runResolve(workspace, side) {
   const resolvedRecords = adoptServerConflictBases(workspace);
   let resolvedFiles = 0;
   for (const file of marked) {
-    writeFileSync16(file.absolutePath, resolveMarkers(file.source, side), "utf8");
+    writeFileSync17(file.absolutePath, resolveMarkers(file.source, side), "utf8");
     resolvedFiles += 1;
   }
   let resolvedBinaries = 0;
@@ -148101,7 +148171,7 @@ function runResolve(workspace, side) {
       if (conflict2.remoteSha256 !== null && conflict2.artifactPath !== void 0) {
         writeVerifiedBinaryDownloadV4(
           destination,
-          readFileSync23(join21(workspace.root, conflict2.artifactPath)),
+          readFileSync24(join21(workspace.root, conflict2.artifactPath)),
           conflict2.remoteSha256
         );
         binary.sha256 = conflict2.remoteSha256;
@@ -148130,7 +148200,7 @@ function runResolve(workspace, side) {
 function readMarkedProjectSourcesV4(root) {
   const files = [];
   for (const absolutePath of listProjectSourceFilesV4(root)) {
-    const source = readFileSync23(absolutePath, "utf8");
+    const source = readFileSync24(absolutePath, "utf8");
     if (detectConflictMarkers(source) === null) continue;
     files.push({
       path: normalizeWorkspaceSourcePath(relative11(root, absolutePath)),
@@ -148431,7 +148501,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.58.1");
+    console.log("0.58.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.58.1",
+  "version": "0.58.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.58.1 -->
+<!-- reviewed-through-cli: 0.58.2 -->
 
 # Neo Compose CLI
 

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

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

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

@@ -61,6 +61,11 @@ 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 downloads up to eight managed image or audio files concurrently and reuses
+matching local bytes. It verifies all downloads before replacing binaries or
+updating conflict artifacts. A failed transfer leaves existing files intact;
+retry the pull after resolving the reported download error.
+
 Pull pins every page and snapshot batch to one published generation and logical
 revision. If either changes during assembly, the CLI discards the attempt and
 restarts. Upgrade the CLI together with the P83 server read protocol.