@mutmutco/installer-launcher 0.1.14 → 0.1.15

package/dist/launcher.js

@@ -6,7 +6,7 @@ import { randomUUID as randomUUID4 } from "node:crypto";
 
 // src/acquisition.ts
 import { createHash as createHash3, randomUUID as randomUUID3 } from "node:crypto";
-import { existsSync as existsSync4, mkdirSync as mkdirSync4, readFileSync as readFileSync4, writeFileSync as writeFileSync4, unlinkSync, realpathSync as realpathSync2 } from "node:fs";
+import { existsSync as existsSync5, mkdirSync as mkdirSync4, readFileSync as readFileSync4, writeFileSync as writeFileSync4, unlinkSync, realpathSync as realpathSync2 } from "node:fs";
 import { join as join4, resolve, relative as relative2, isAbsolute as isAbsolute2, dirname as dirname2 } from "node:path";
 
 // src/runtime.ts
@@ -194,7 +194,7 @@ function wipeProductDir(dir) {
 
 // src/payload.ts
 import { createHash as createHash2, createPublicKey, verify } from "node:crypto";
-import { mkdirSync as mkdirSync3, renameSync as renameSync3, rmSync as rmSync3, writeFileSync as writeFileSync3 } from "node:fs";
+import { cpSync, existsSync as existsSync4, mkdirSync as mkdirSync3, renameSync as renameSync3, rmSync as rmSync3, writeFileSync as writeFileSync3 } from "node:fs";
 import { tmpdir as tmpdir2 } from "node:os";
 import { dirname, join as join3 } from "node:path";
 
@@ -403,6 +403,17 @@ async function fetchVerifiedManifest(config, accessToken, fetchImpl = fetch) {
   }
   return manifest;
 }
+async function fetchReleaseVersion(config, fetchImpl = fetch) {
+  try {
+    const response = await fetchImpl(`${config.host}/release/version`);
+    if (!response.ok) return null;
+    const json = await response.json();
+    const version = typeof json?.version === "string" ? json.version.trim() : "";
+    return version || null;
+  } catch {
+    return null;
+  }
+}
 async function fetchFileBytes(config, accessToken, path, fetchImpl, onProgress, expectedSize) {
   const encoded = path.split("/").map(encodeURIComponent).join("/");
   const response = await fetchImpl(`${config.host}/release/${encoded}`, {
@@ -414,7 +425,36 @@ async function fetchFileBytes(config, accessToken, path, fetchImpl, onProgress,
   }
   return readDownload(response, onProgress, expectedSize);
 }
+var VERSION_CACHE_RE = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
+function versionCacheRoot(dir, version) {
+  return VERSION_CACHE_RE.test(version) ? join3(dir, "payload-cache", version) : "";
+}
+function cachedPayloadForVersion(dir, version) {
+  const root = versionCacheRoot(dir, version);
+  if (!root) return null;
+  const payload = join3(root, "payload");
+  return existsSync4(payload) ? payload : null;
+}
+function rememberPayloadVersion(dir, version, payload) {
+  try {
+    const root = versionCacheRoot(dir, version);
+    if (!root) return;
+    const dest = join3(root, "payload");
+    if (existsSync4(dest)) return;
+    mkdirSync3(root, { recursive: true });
+    cpSync(payload, dest, { recursive: true });
+  } catch {
+  }
+}
 async function downloadAndUnpack(config, dir, manifest, accessToken, options = {}) {
+  const target = join3(dir, "payload");
+  const cached = options.cacheDir ? cachedPayloadForVersion(options.cacheDir, manifest.version) : null;
+  if (cached) {
+    mkdirSync3(dir, { recursive: true });
+    rmSync3(target, { force: true, recursive: true });
+    cpSync(cached, target, { recursive: true });
+    return manifest.version;
+  }
   const fetchImpl = options.fetchImpl ?? fetch;
   const staging = join3(tmpdir2(), `launcher-${config.product}-${Date.now()}-${Math.floor(Math.random() * 1e6)}`);
   mkdirSync3(staging, { recursive: true });
@@ -431,7 +471,6 @@ async function downloadAndUnpack(config, dir, manifest, accessToken, options = {
       mkdirSync3(dirname(dest), { recursive: true });
       writeFileSync3(dest, bytes);
     }
-    const target = join3(dir, "payload");
     mkdirSync3(dir, { recursive: true });
     rmSync3(target, { force: true, recursive: true });
     renameSync3(staging, target);
@@ -439,6 +478,7 @@ async function downloadAndUnpack(config, dir, manifest, accessToken, options = {
     rmSync3(staging, { force: true, recursive: true });
     throw error;
   }
+  if (options.cacheDir) rememberPayloadVersion(options.cacheDir, manifest.version, target);
   return manifest.version;
 }
 
@@ -448,7 +488,7 @@ function reusableCandidate(dir, manifest) {
     const saved = JSON.parse(readFileSync4(join4(dir, "acquisition-cache.json"), "utf8"));
     if (saved.signature !== manifest.signature) return null;
     const root = candidateRoot(dir, saved.candidate);
-    if (!existsSync4(join4(root, "acquired.json"))) return null;
+    if (!existsSync5(join4(root, "acquired.json"))) return null;
     for (const file of manifest.files) {
       if (!safePath(file.path) || !verifyFileBytes(file, readFileSync4(join4(root, "payload", file.path)))) return null;
     }
@@ -555,7 +595,7 @@ function acquisitionRepairCommand(dir, version) {
   return argv(realpathSync2(state.acquired.node), productRoot, acquisition.runEntry, acquisition.repairArgs, prefix, version);
 }
 async function recoverAcquisition(dir, run2, env) {
-  if (!existsSync4(pendingPath(dir))) return;
+  if (!existsSync5(pendingPath(dir))) return;
   const pending = JSON.parse(readFileSync4(pendingPath(dir), "utf8"));
   if (pending.schema !== 1 || typeof pending.version !== "string" || typeof pending.node !== "string") throw new Error("invalid pending acquisition receipt");
   const root = candidateRoot(dir, pending.candidate);
@@ -569,7 +609,7 @@ async function recoverAcquisition(dir, run2, env) {
   const command2 = argv(pending.node, packageRoot(prefix, acquisition), acquisition.rollbackEntry, acquisition.rollbackArgs, prefix, pending.version);
   if (!await run2(command2, root, runtimeEnvironment(pending.node, env))) throw new Error("installation recovery is pending; product rollback did not finish");
   if (pending.previous) writeState(dir, pending.previous);
-  else if (existsSync4(statePath(dir))) unlinkSync(statePath(dir));
+  else if (existsSync5(statePath(dir))) unlinkSync(statePath(dir));
   unlinkSync(pendingPath(dir));
 }
 async function installAcquisition(dir, candidate, version, acquisition, options) {
@@ -579,7 +619,7 @@ async function installAcquisition(dir, candidate, version, acquisition, options)
   const prefix = join4(root, "prefix");
   const prepared = join4(root, "acquired.json");
   const archiveHash = createHash3("sha256").update(readFileSync4(join4(payload, acquisition.archive))).digest("hex");
-  const reused = existsSync4(prepared);
+  const reused = existsSync5(prepared);
   if (reused && JSON.parse(readFileSync4(prepared, "utf8")).archiveHash !== archiveHash) throw new Error("cached acquisition archive changed");
   if (!reused) mkdirSync4(prefix);
   const runtime = await (options.runtime ?? acquireRuntime)(dir, options.fetchImpl, options.onProgress);
@@ -632,7 +672,7 @@ async function installAcquisition(dir, candidate, version, acquisition, options)
 
 // src/index.ts
 import { spawn as spawn2, spawnSync as spawnSync3 } from "node:child_process";
-import { existsSync as existsSync6, readFileSync as readFileSync7, statSync, mkdtempSync as mkdtempSync2, unlinkSync as unlinkSync2, rmdirSync, mkdirSync as mkdirSync6, renameSync as renameSync4, rmSync as rmSync5 } from "node:fs";
+import { existsSync as existsSync7, readFileSync as readFileSync7, statSync, mkdtempSync as mkdtempSync2, unlinkSync as unlinkSync2, rmdirSync, mkdirSync as mkdirSync6, renameSync as renameSync4, rmSync as rmSync5 } from "node:fs";
 import { tmpdir as tmpdir4 } from "node:os";
 import { dirname as dirname3, join as join6, resolve as resolve2 } from "node:path";
 import { fileURLToPath, pathToFileURL as pathToFileURL2 } from "node:url";
@@ -831,7 +871,26 @@ var RELAY_INDENT = " ".repeat(TITLE_COLUMN - 1);
 // ../face/src/spinner.ts
 import { appendFileSync as appendFileSync2, writeSync as writeSync2 } from "node:fs";
 import { Worker } from "node:worker_threads";
-var FRAMES = ["\u25D2", "\u25D0", "\u25D3", "\u25D1"];
+
+// ../face/src/encoding.ts
+var UNICODE_SPINNER_FRAMES = Object.freeze(["\u25D2", "\u25D0", "\u25D3", "\u25D1"]);
+var ASCII_SPINNER_FRAMES = Object.freeze(["-", "\\", "|", "/"]);
+function consoleRendersUnicode(env = process.env, platform = process.platform) {
+  if (env.MM_FACE_ASCII === "1" || env.NO_UNICODE === "1") return false;
+  const locale = env.LC_ALL || env.LC_CTYPE || env.LANG || "";
+  if (locale === "C" || locale === "POSIX" || /^C\./u.test(locale) || /^POSIX\./u.test(locale)) return false;
+  if (/cp437|ibm437|\b437\b/iu.test(locale)) return false;
+  if (/utf-?8/iu.test(locale)) return true;
+  if (platform === "win32") {
+    return Boolean(env.WT_SESSION) || env.TERM_PROGRAM === "vscode" || env.CHCP === "65001" || env.ConEmuANSI === "ON";
+  }
+  return true;
+}
+function spinnerFramesFor(env = process.env, platform = process.platform) {
+  return consoleRendersUnicode(env, platform) ? UNICODE_SPINNER_FRAMES : ASCII_SPINNER_FRAMES;
+}
+
+// ../face/src/spinner.ts
 var WORKER_SOURCE = `
 const { parentPort, workerData } = require('node:worker_threads');
 const { writeSync, appendFileSync } = require('node:fs');
@@ -856,8 +915,10 @@ parentPort.on('message', (next) => {
 });
 setInterval(draw, workerData.intervalMs);
 `;
-function createSpinner(face, { animate, stream, intervalMs = 90, transcriptPath }) {
+function createSpinner(face, { animate, stream, intervalMs = 90, transcriptPath, env = process.env, platform = process.platform }) {
   animate = animate && !face.nested && !face.emitsProgress;
+  const glyphs = spinnerFramesFor(env, platform);
+  const ascii = glyphs[0] === ASCII_SPINNER_FRAMES[0];
   let timer = null;
   let worker = null;
   let control = null;
@@ -875,7 +936,8 @@ function createSpinner(face, { animate, stream, intervalMs = 90, transcriptPath
   };
   const render = (text, measure) => {
     const line = face.step(text, measure ?? "__elapsed__", "note").split("\n")[0];
-    frames = line ? FRAMES.map((glyph) => `\r\x1B[2K${line.replace(GLYPH.dot, glyph)}`) : [];
+    const prepared = line && ascii ? line.replaceAll(GLYPH.bar, "|") : line;
+    frames = prepared ? glyphs.map((glyph) => `\r\x1B[2K${prepared.replace(GLYPH.dot, glyph)}`) : [];
   };
   const draw = () => {
     if (animate && !suspended && frames.length) write(frames[frame++ % frames.length].replace("__elapsed__", `${Math.floor((Date.now() - started) / 1e3)}s`));
@@ -952,7 +1014,6 @@ function createSpinner(face, { animate, stream, intervalMs = 90, transcriptPath
     }
   };
 }
-var SPINNER_FRAMES = Object.freeze([...FRAMES]);
 
 // ../face/src/conformance.ts
 var ALLOWED = new Set(Object.values(GLYPH));
@@ -1056,6 +1117,14 @@ var PHASES = {
   doctor: ["Checking health", "Checked health"],
   rollback: ["Restoring the previous version", "Restored the previous version"]
 };
+var UPDATE_CHECK_PHASES = /* @__PURE__ */ new Set([
+  "preflight",
+  "resolve",
+  "verify-release",
+  "download",
+  "sign-in",
+  "check"
+]);
 function createInstallerRun(value, options = {}) {
   const declaration = validateInstallerProduct(value);
   const env = options.env ?? process.env;
@@ -1091,6 +1160,7 @@ function createInstallerRun(value, options = {}) {
   };
   const spinner = createSpinner(face, {
     animate: tty && env.TERM !== "dumb" && (options.animate ?? Boolean(process.stderr.isTTY)),
+    env,
     ...options.write ? { stream: { write: (text) => {
       emit(String(text), "spinner");
       return true;
@@ -1109,6 +1179,7 @@ function createInstallerRun(value, options = {}) {
   };
   let started = false;
   let finished = false;
+  let operation = options.operation;
   const start = () => {
     if (started || finished) return;
     started = true;
@@ -1116,7 +1187,7 @@ function createInstallerRun(value, options = {}) {
     const welcome = face.welcome();
     if (tty) lines(welcome);
     else if (welcome.length) {
-      const warm = options.operation === "install" ? face.identity.installWarm : face.identity.warm;
+      const warm = operation === "install" ? face.identity.installWarm : face.identity.warm;
       lines([`${face.identity.name} - Mutatis Mutandis`, warm.replaceAll("\u2014", "-").replaceAll("\u2026", "...")]);
     }
   };
@@ -1132,13 +1203,20 @@ function createInstallerRun(value, options = {}) {
     get errors() {
       return [...errors];
     },
+    get operation() {
+      return operation;
+    },
+    set operation(value2) {
+      operation = value2;
+    },
     start,
     phase(id, facts = {}) {
       if (finished) throw new Error("installer run already finished");
       if (!Object.hasOwn(PHASES, id)) throw new Error("installer run: unknown phase");
       start();
       const state = facts.state ?? "ok";
-      const title = PHASES[id][state === "ok" ? 1 : 0];
+      const fold = operation === "update" && UPDATE_CHECK_PHASES.has(id) && state !== "fail";
+      const title = PHASES[fold ? "check" : id][state === "ok" ? 1 : 0];
       if (state === "running") {
         if (face.progress(title, facts.measure ?? null)) return;
         if (activeTitle === title) spinner.say(title, facts.measure ?? null);
@@ -1148,6 +1226,10 @@ function createInstallerRun(value, options = {}) {
         }
         return;
       }
+      if (fold && id !== "check") {
+        if (facts.detail) run2.relay(facts.detail);
+        return;
+      }
       if (!face.continues(id, state)) durable(title, facts.seconds ?? facts.measure ?? null, state);
       if (facts.detail) run2.relay(facts.detail);
     },
@@ -1286,7 +1368,7 @@ function createInstallerRun(value, options = {}) {
 
 // src/autoupdate.ts
 import { spawnSync as spawnSync2 } from "node:child_process";
-import { existsSync as existsSync5, mkdirSync as mkdirSync5, readFileSync as readFileSync6, rmSync as rmSync4, writeFileSync as writeFileSync6 } from "node:fs";
+import { existsSync as existsSync6, mkdirSync as mkdirSync5, readFileSync as readFileSync6, rmSync as rmSync4, writeFileSync as writeFileSync6 } from "node:fs";
 import { tmpdir as tmpdir3 } from "node:os";
 import { join as join5 } from "node:path";
 function schedulePlatform(override) {
@@ -1398,11 +1480,11 @@ function querySchedule(config, options = {}) {
   }
   if (platform === "darwin") {
     const plist = join5(home, "Library", "LaunchAgents", `${scheduleLabel(config)}.plist`);
-    if (!existsSync5(plist)) return { supported: true, enabled: false };
+    if (!existsSync6(plist)) return { supported: true, enabled: false };
     return { supported: true, enabled: true, cadence: "hourly" };
   }
   const timer = join5(home, ".config", "systemd", "user", `${scheduleLabel(config)}.timer`);
-  if (!existsSync5(timer)) return { supported: true, enabled: false };
+  if (!existsSync6(timer)) return { supported: true, enabled: false };
   const state = { supported: true, enabled: true, cadence: "hourly" };
   const shown = exec("systemctl", ["--user", "show", `${scheduleLabel(config)}.service`, "-p", "ExecMainStartTimestamp", "--value"]);
   const stamp = (shown.stdout ?? "").trim();
@@ -1694,7 +1776,7 @@ function page(title, body) {
 }
 
 // src/index.ts
-var LAUNCHER_VERSION = true ? "0.1.14" : readVersionFromPackage();
+var LAUNCHER_VERSION = true ? "0.1.15" : readVersionFromPackage();
 function defaultPrint(message) {
   process.stdout.write(`${message}
 `);
@@ -1783,7 +1865,7 @@ async function runFile(file, args, printErr) {
     return 1;
   }
   const abs = resolve2(process.cwd(), file);
-  if (!existsSync6(abs)) {
+  if (!existsSync7(abs)) {
     printErr(`cannot run ${file}: no such file.`);
     return 1;
   }
@@ -1915,7 +1997,7 @@ function resolveEntry(entry2) {
 function needsShell(command2) {
   if (process.platform !== "win32") return false;
   if (/\.(cmd|bat)$/i.test(command2)) return true;
-  return !existsSync6(command2);
+  return !existsSync7(command2);
 }
 function quoteForShell(arg) {
   return /[\s"&|<>^%]/.test(arg) ? `"${arg.replace(/"/g, '\\"')}"` : arg;
@@ -1995,8 +2077,27 @@ async function installOrUpdate(config, dir, options, print, update) {
   let version = readState(dir)?.version ?? "unknown";
   installer.start();
   try {
+    const current = readState(dir);
+    const payloadPresent = existsSync7(payloadDir(dir));
     let started = Date.now();
+    installer.phase("resolve", { state: "running" });
+    const pointer = await fetchReleaseVersion(config, fetchImpl);
+    if (pointer && current?.version === pointer && payloadPresent) {
+      version = pointer;
+      installer.phase("resolve", { seconds: (Date.now() - started) / 1e3 });
+      installer.surface({ id: config.product, from: version, to: version, state: "current" });
+      return await finishLastMile(
+        config,
+        dir,
+        options,
+        installer,
+        version,
+        true,
+        current.acquired ? acquisitionRepairCommand(dir, version) : void 0
+      );
+    }
     installer.phase("sign-in", { state: "running" });
+    started = Date.now();
     const accessToken = await fetchAccessTokenOrLogin(config, dir, options, print, installer);
     installer.phase("sign-in", { seconds: (Date.now() - started) / 1e3 });
     installer.phase("resolve", { state: "running" });
@@ -2004,8 +2105,7 @@ async function installOrUpdate(config, dir, options, print, update) {
     const manifest = await fetchVerifiedManifest(config, accessToken, fetchImpl);
     version = manifest.version;
     installer.phase("resolve", { seconds: (Date.now() - started) / 1e3 });
-    const current = readState(dir);
-    const unchanged = current?.version === version && existsSync6(payloadDir(dir));
+    const unchanged = current?.version === version && existsSync7(payloadDir(dir));
     if (unchanged && current.acquired) {
       installer.surface({ id: config.product, from: version, to: version, state: "current" });
       return await finishLastMile(config, dir, options, installer, version, true, acquisitionRepairCommand(dir, version));
@@ -2020,8 +2120,8 @@ async function installOrUpdate(config, dir, options, print, update) {
         state: "running",
         measure: total ? `${Math.floor(done / total * 100)}% \xB7 ${done}/${total} B` : `${done} B`
       });
-      if (!cached) await downloadAndUnpack(config, candidateDir, manifest, accessToken, { fetchImpl, onProgress });
-      const acquisition = existsSync6(join6(candidateDir, "payload", "payload.json")) ? readAcquisition(join6(candidateDir, "payload")) : null;
+      if (!cached) await downloadAndUnpack(config, candidateDir, manifest, accessToken, { fetchImpl, onProgress, cacheDir: dir });
+      const acquisition = existsSync7(join6(candidateDir, "payload", "payload.json")) ? readAcquisition(join6(candidateDir, "payload")) : null;
       if (acquisition) {
         rememberCandidate(dir, candidate, manifest);
         installer.phase("download", { seconds: (Date.now() - started) / 1e3 });
@@ -2090,7 +2190,7 @@ function payloadFileAsCommand(entry2, payload) {
   if (!first || first === "$self") return null;
   if (first.includes("/") || first.includes("\\")) return null;
   const candidate = join6(payload, first);
-  if (!existsSync6(candidate)) return null;
+  if (!existsSync7(candidate)) return null;
   if (NEVER_A_PROGRAM.test(first)) return first;
   if (process.platform === "win32") return null;
   try {
@@ -2207,7 +2307,7 @@ async function runInstallEntry(entry2, cwd, env, installer, tokens = null) {
       const pollProgress = () => {
         if (progressError) return;
         try {
-          if (!existsSync6(progressFile)) return;
+          if (!existsSync7(progressFile)) return;
           const bytes = readFileSync7(progressFile);
           receive(progressDecoder.write(bytes.subarray(progressOffset)));
           progressOffset = bytes.length;
@@ -2241,13 +2341,13 @@ async function runInstallEntry(entry2, cwd, env, installer, tokens = null) {
       return { ...result, ok: false, code: result.code || 1, error: "installer outcome: invalid child result" };
     }
   } finally {
-    if (existsSync6(progressFile)) unlinkSync2(progressFile);
-    if (existsSync6(outcomeFile)) unlinkSync2(outcomeFile);
+    if (existsSync7(progressFile)) unlinkSync2(progressFile);
+    if (existsSync7(outcomeFile)) unlinkSync2(outcomeFile);
     rmdirSync(outcomeDir);
   }
 }
 function doForward(config, dir, options, command2, argv2, print, unlock) {
-  if (command2 && existsSync6(command2)) {
+  if (command2 && existsSync7(command2)) {
     print(`${command2} is a file, not a command \u2014 did you mean \`--run ${command2}\`?`);
     return 2;
   }
@@ -2327,7 +2427,7 @@ function doDoctor(config, dir, options, print, unlock) {
 function doLauncherDoctor(config, dir, options, print) {
   const tokens = readTokens(dir);
   const state = readState(dir);
-  const payloadPresent = existsSync6(payloadDir(dir));
+  const payloadPresent = existsSync7(payloadDir(dir));
   print(`product:  ${config.product}`);
   print(`host:     ${config.host}`);
   print(`login:    ${config.loginKind}`);

package/dist/launcher.sea.cjs

@@ -435,6 +435,17 @@ async function fetchVerifiedManifest(config, accessToken, fetchImpl = fetch) {
   }
   return manifest;
 }
+async function fetchReleaseVersion(config, fetchImpl = fetch) {
+  try {
+    const response = await fetchImpl(`${config.host}/release/version`);
+    if (!response.ok) return null;
+    const json = await response.json();
+    const version = typeof json?.version === "string" ? json.version.trim() : "";
+    return version || null;
+  } catch {
+    return null;
+  }
+}
 async function fetchFileBytes(config, accessToken, path, fetchImpl, onProgress, expectedSize) {
   const encoded = path.split("/").map(encodeURIComponent).join("/");
   const response = await fetchImpl(`${config.host}/release/${encoded}`, {
@@ -446,7 +457,36 @@ async function fetchFileBytes(config, accessToken, path, fetchImpl, onProgress,
   }
   return readDownload(response, onProgress, expectedSize);
 }
+var VERSION_CACHE_RE = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
+function versionCacheRoot(dir, version) {
+  return VERSION_CACHE_RE.test(version) ? (0, import_node_path3.join)(dir, "payload-cache", version) : "";
+}
+function cachedPayloadForVersion(dir, version) {
+  const root = versionCacheRoot(dir, version);
+  if (!root) return null;
+  const payload = (0, import_node_path3.join)(root, "payload");
+  return (0, import_node_fs4.existsSync)(payload) ? payload : null;
+}
+function rememberPayloadVersion(dir, version, payload) {
+  try {
+    const root = versionCacheRoot(dir, version);
+    if (!root) return;
+    const dest = (0, import_node_path3.join)(root, "payload");
+    if ((0, import_node_fs4.existsSync)(dest)) return;
+    (0, import_node_fs4.mkdirSync)(root, { recursive: true });
+    (0, import_node_fs4.cpSync)(payload, dest, { recursive: true });
+  } catch {
+  }
+}
 async function downloadAndUnpack(config, dir, manifest, accessToken, options = {}) {
+  const target = (0, import_node_path3.join)(dir, "payload");
+  const cached = options.cacheDir ? cachedPayloadForVersion(options.cacheDir, manifest.version) : null;
+  if (cached) {
+    (0, import_node_fs4.mkdirSync)(dir, { recursive: true });
+    (0, import_node_fs4.rmSync)(target, { force: true, recursive: true });
+    (0, import_node_fs4.cpSync)(cached, target, { recursive: true });
+    return manifest.version;
+  }
   const fetchImpl = options.fetchImpl ?? fetch;
   const staging = (0, import_node_path3.join)((0, import_node_os2.tmpdir)(), `launcher-${config.product}-${Date.now()}-${Math.floor(Math.random() * 1e6)}`);
   (0, import_node_fs4.mkdirSync)(staging, { recursive: true });
@@ -463,7 +503,6 @@ async function downloadAndUnpack(config, dir, manifest, accessToken, options = {
       (0, import_node_fs4.mkdirSync)((0, import_node_path3.dirname)(dest), { recursive: true });
       (0, import_node_fs4.writeFileSync)(dest, bytes);
     }
-    const target = (0, import_node_path3.join)(dir, "payload");
     (0, import_node_fs4.mkdirSync)(dir, { recursive: true });
     (0, import_node_fs4.rmSync)(target, { force: true, recursive: true });
     (0, import_node_fs4.renameSync)(staging, target);
@@ -471,6 +510,7 @@ async function downloadAndUnpack(config, dir, manifest, accessToken, options = {
     (0, import_node_fs4.rmSync)(staging, { force: true, recursive: true });
     throw error;
   }
+  if (options.cacheDir) rememberPayloadVersion(options.cacheDir, manifest.version, target);
   return manifest.version;
 }
 
@@ -863,7 +903,26 @@ var RELAY_INDENT = " ".repeat(TITLE_COLUMN - 1);
 // ../face/src/spinner.ts
 var import_node_fs7 = require("node:fs");
 var import_node_worker_threads = require("node:worker_threads");
-var FRAMES = ["\u25D2", "\u25D0", "\u25D3", "\u25D1"];
+
+// ../face/src/encoding.ts
+var UNICODE_SPINNER_FRAMES = Object.freeze(["\u25D2", "\u25D0", "\u25D3", "\u25D1"]);
+var ASCII_SPINNER_FRAMES = Object.freeze(["-", "\\", "|", "/"]);
+function consoleRendersUnicode(env = process.env, platform = process.platform) {
+  if (env.MM_FACE_ASCII === "1" || env.NO_UNICODE === "1") return false;
+  const locale = env.LC_ALL || env.LC_CTYPE || env.LANG || "";
+  if (locale === "C" || locale === "POSIX" || /^C\./u.test(locale) || /^POSIX\./u.test(locale)) return false;
+  if (/cp437|ibm437|\b437\b/iu.test(locale)) return false;
+  if (/utf-?8/iu.test(locale)) return true;
+  if (platform === "win32") {
+    return Boolean(env.WT_SESSION) || env.TERM_PROGRAM === "vscode" || env.CHCP === "65001" || env.ConEmuANSI === "ON";
+  }
+  return true;
+}
+function spinnerFramesFor(env = process.env, platform = process.platform) {
+  return consoleRendersUnicode(env, platform) ? UNICODE_SPINNER_FRAMES : ASCII_SPINNER_FRAMES;
+}
+
+// ../face/src/spinner.ts
 var WORKER_SOURCE = `
 const { parentPort, workerData } = require('node:worker_threads');
 const { writeSync, appendFileSync } = require('node:fs');
@@ -888,8 +947,10 @@ parentPort.on('message', (next) => {
 });
 setInterval(draw, workerData.intervalMs);
 `;
-function createSpinner(face, { animate, stream, intervalMs = 90, transcriptPath }) {
+function createSpinner(face, { animate, stream, intervalMs = 90, transcriptPath, env = process.env, platform = process.platform }) {
   animate = animate && !face.nested && !face.emitsProgress;
+  const glyphs = spinnerFramesFor(env, platform);
+  const ascii = glyphs[0] === ASCII_SPINNER_FRAMES[0];
   let timer = null;
   let worker = null;
   let control = null;
@@ -907,7 +968,8 @@ function createSpinner(face, { animate, stream, intervalMs = 90, transcriptPath
   };
   const render = (text, measure) => {
     const line = face.step(text, measure ?? "__elapsed__", "note").split("\n")[0];
-    frames = line ? FRAMES.map((glyph) => `\r\x1B[2K${line.replace(GLYPH.dot, glyph)}`) : [];
+    const prepared = line && ascii ? line.replaceAll(GLYPH.bar, "|") : line;
+    frames = prepared ? glyphs.map((glyph) => `\r\x1B[2K${prepared.replace(GLYPH.dot, glyph)}`) : [];
   };
   const draw = () => {
     if (animate && !suspended && frames.length) write(frames[frame++ % frames.length].replace("__elapsed__", `${Math.floor((Date.now() - started) / 1e3)}s`));
@@ -984,7 +1046,6 @@ function createSpinner(face, { animate, stream, intervalMs = 90, transcriptPath
     }
   };
 }
-var SPINNER_FRAMES = Object.freeze([...FRAMES]);
 
 // ../face/src/conformance.ts
 var ALLOWED = new Set(Object.values(GLYPH));
@@ -1088,6 +1149,14 @@ var PHASES = {
   doctor: ["Checking health", "Checked health"],
   rollback: ["Restoring the previous version", "Restored the previous version"]
 };
+var UPDATE_CHECK_PHASES = /* @__PURE__ */ new Set([
+  "preflight",
+  "resolve",
+  "verify-release",
+  "download",
+  "sign-in",
+  "check"
+]);
 function createInstallerRun(value, options = {}) {
   const declaration = validateInstallerProduct(value);
   const env = options.env ?? process.env;
@@ -1123,6 +1192,7 @@ function createInstallerRun(value, options = {}) {
   };
   const spinner = createSpinner(face, {
     animate: tty && env.TERM !== "dumb" && (options.animate ?? Boolean(process.stderr.isTTY)),
+    env,
     ...options.write ? { stream: { write: (text) => {
       emit(String(text), "spinner");
       return true;
@@ -1141,6 +1211,7 @@ function createInstallerRun(value, options = {}) {
   };
   let started = false;
   let finished = false;
+  let operation = options.operation;
   const start = () => {
     if (started || finished) return;
     started = true;
@@ -1148,7 +1219,7 @@ function createInstallerRun(value, options = {}) {
     const welcome = face.welcome();
     if (tty) lines(welcome);
     else if (welcome.length) {
-      const warm = options.operation === "install" ? face.identity.installWarm : face.identity.warm;
+      const warm = operation === "install" ? face.identity.installWarm : face.identity.warm;
       lines([`${face.identity.name} - Mutatis Mutandis`, warm.replaceAll("\u2014", "-").replaceAll("\u2026", "...")]);
     }
   };
@@ -1164,13 +1235,20 @@ function createInstallerRun(value, options = {}) {
     get errors() {
       return [...errors];
     },
+    get operation() {
+      return operation;
+    },
+    set operation(value2) {
+      operation = value2;
+    },
     start,
     phase(id, facts = {}) {
       if (finished) throw new Error("installer run already finished");
       if (!Object.hasOwn(PHASES, id)) throw new Error("installer run: unknown phase");
       start();
       const state = facts.state ?? "ok";
-      const title = PHASES[id][state === "ok" ? 1 : 0];
+      const fold = operation === "update" && UPDATE_CHECK_PHASES.has(id) && state !== "fail";
+      const title = PHASES[fold ? "check" : id][state === "ok" ? 1 : 0];
       if (state === "running") {
         if (face.progress(title, facts.measure ?? null)) return;
         if (activeTitle === title) spinner.say(title, facts.measure ?? null);
@@ -1180,6 +1258,10 @@ function createInstallerRun(value, options = {}) {
         }
         return;
       }
+      if (fold && id !== "check") {
+        if (facts.detail) run2.relay(facts.detail);
+        return;
+      }
       if (!face.continues(id, state)) durable(title, facts.seconds ?? facts.measure ?? null, state);
       if (facts.detail) run2.relay(facts.detail);
     },
@@ -1726,7 +1808,7 @@ function page(title, body) {
 }
 
 // src/index.ts
-var LAUNCHER_VERSION = true ? "0.1.14" : readVersionFromPackage();
+var LAUNCHER_VERSION = true ? "0.1.15" : readVersionFromPackage();
 function defaultPrint(message) {
   process.stdout.write(`${message}
 `);
@@ -2027,8 +2109,27 @@ async function installOrUpdate(config, dir, options, print, update) {
   let version = readState(dir)?.version ?? "unknown";
   installer.start();
   try {
+    const current = readState(dir);
+    const payloadPresent = (0, import_node_fs11.existsSync)(payloadDir(dir));
     let started = Date.now();
+    installer.phase("resolve", { state: "running" });
+    const pointer = await fetchReleaseVersion(config, fetchImpl);
+    if (pointer && current?.version === pointer && payloadPresent) {
+      version = pointer;
+      installer.phase("resolve", { seconds: (Date.now() - started) / 1e3 });
+      installer.surface({ id: config.product, from: version, to: version, state: "current" });
+      return await finishLastMile(
+        config,
+        dir,
+        options,
+        installer,
+        version,
+        true,
+        current.acquired ? acquisitionRepairCommand(dir, version) : void 0
+      );
+    }
     installer.phase("sign-in", { state: "running" });
+    started = Date.now();
     const accessToken = await fetchAccessTokenOrLogin(config, dir, options, print, installer);
     installer.phase("sign-in", { seconds: (Date.now() - started) / 1e3 });
     installer.phase("resolve", { state: "running" });
@@ -2036,7 +2137,6 @@ async function installOrUpdate(config, dir, options, print, update) {
     const manifest = await fetchVerifiedManifest(config, accessToken, fetchImpl);
     version = manifest.version;
     installer.phase("resolve", { seconds: (Date.now() - started) / 1e3 });
-    const current = readState(dir);
     const unchanged = current?.version === version && (0, import_node_fs11.existsSync)(payloadDir(dir));
     if (unchanged && current.acquired) {
       installer.surface({ id: config.product, from: version, to: version, state: "current" });
@@ -2052,7 +2152,7 @@ async function installOrUpdate(config, dir, options, print, update) {
         state: "running",
         measure: total ? `${Math.floor(done / total * 100)}% \xB7 ${done}/${total} B` : `${done} B`
       });
-      if (!cached) await downloadAndUnpack(config, candidateDir, manifest, accessToken, { fetchImpl, onProgress });
+      if (!cached) await downloadAndUnpack(config, candidateDir, manifest, accessToken, { fetchImpl, onProgress, cacheDir: dir });
       const acquisition = (0, import_node_fs11.existsSync)((0, import_node_path6.join)(candidateDir, "payload", "payload.json")) ? readAcquisition((0, import_node_path6.join)(candidateDir, "payload")) : null;
       if (acquisition) {
         rememberCandidate(dir, candidate, manifest);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mutmutco/installer-launcher",
-  "version": "0.1.14",
+  "version": "0.1.15",
   "description": "Single-executable (SEA) launcher: sign-in, gated payload fetch, self-update. One copy ships per product.",
   "type": "module",
   "license": "UNLICENSED",