@mutmutco/installer-launcher 0.1.14 → 0.1.17

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";
@@ -759,15 +799,24 @@ function createFace({ product, color = false, columns, env = process.env, operat
     const record = { v: PROGRESS_PROTOCOL, step: stripColor(title), state: kind };
     if (typeof measure === "number") record.ms = Math.max(0, Math.round(measure * 1e3));
     if (kind === "running" && typeof measure === "string") record.measure = measure;
-    try {
-      if (progressFile) appendFileSync(progressFile, `${JSON.stringify(record)}
-`);
-      else writeSync(progressFd, `${JSON.stringify(record)}
-`);
-      return true;
-    } catch {
-      return false;
+    const line = `${JSON.stringify(record)}
+`;
+    if (progressFd !== null) {
+      try {
+        writeSync(progressFd, line);
+        return true;
+      } catch {
+      }
+    }
+    if (progressFile) {
+      try {
+        appendFileSync(progressFile, line);
+        return true;
+      } catch {
+        return false;
+      }
     }
+    return false;
   };
   const welcome = () => continuesFace || nested ? [] : [
     `${paint(identity.accent, GLYPH.diamond)}  ${paint(identity.accent, identity.name)} \u2014 Mutatis Mutandis`,
@@ -781,7 +830,7 @@ function createFace({ product, color = false, columns, env = process.env, operat
   };
   const step = (title, measure = null, kind = "ok") => {
     if (emitMilestone(title, measure, kind)) return "";
-    const glyph = title === "Armed hourly updates" && kind === "ok" ? GLYPH.clock : kind === "fail" ? paint(identity.accent, GLYPH.cross) : kind === "note" ? paint(PALETTE.muted, GLYPH.dot) : paint(PALETTE.green, GLYPH.check);
+    const glyph = title === "Armed hourly updates" && kind === "ok" ? GLYPH.clock : kind === "fail" ? paint(identity.accent, GLYPH.cross) : kind === "note" ? paint(PALETTE.muted, GLYPH.dot) : paint(identity.accent, GLYPH.check);
     const measured = measure === null || measure === void 0 ? "" : paint(PALETTE.muted, typeof measure === "number" ? `${Math.max(0, Math.round(measure))}s` : String(measure).trim());
     const time = measured;
     const column = Math.min(44, Math.max(0, width - 8));
@@ -802,7 +851,7 @@ function createFace({ product, color = false, columns, env = process.env, operat
     const content = Math.min(width - 6, Math.max(...body.map(visibleWidth)));
     const rule = paint(identity.accent, GLYPH.rule.repeat(content + 4));
     const frame = (left, right) => `${paint(identity.accent, left)}${rule}${paint(identity.accent, right)}`;
-    const bodyRow = (line) => line.startsWith(GLYPH.check) ? `${paint(PALETTE.green, GLYPH.check)}${line.slice(1)}` : line;
+    const bodyRow = (line) => line.startsWith(GLYPH.check) ? `${paint(identity.accent, GLYPH.check)}${line.slice(1)}` : line;
     return [
       frame(GLYPH.boxTop, GLYPH.boxTopEnd),
       ...body.map((line) => `${paint(identity.accent, GLYPH.bar)}  ${bodyRow(line)}${" ".repeat(Math.max(0, content - visibleWidth(line)))}  ${paint(identity.accent, GLYPH.bar)}`),
@@ -831,7 +880,41 @@ 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
+import { execFileSync } from "node:child_process";
+var UNICODE_SPINNER_FRAMES = Object.freeze(["\u25D2", "\u25D0", "\u25D3", "\u25D1"]);
+var ASCII_SPINNER_FRAMES = Object.freeze(["-", "\\", "|", "/"]);
+var cachedCodePage;
+function consoleOutputCodePage() {
+  if (cachedCodePage !== void 0) return cachedCodePage;
+  cachedCodePage = null;
+  try {
+    const out = execFileSync("chcp.com", { windowsHide: true, encoding: "utf8", timeout: 5e3 });
+    const pages = [...String(out).matchAll(/(\d{3,5})/gu)].map((m) => Number(m[1]));
+    cachedCodePage = pages.length ? pages[pages.length - 1] : null;
+  } catch {
+    cachedCodePage = null;
+  }
+  return cachedCodePage;
+}
+function consoleRendersUnicode(env = process.env, platform = process.platform, codePage = platform === "win32" ? consoleOutputCodePage() : null) {
+  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") {
+    if (env.WT_SESSION || env.ConEmuANSI === "ON") return true;
+    return codePage === 65001;
+  }
+  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 +939,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 +960,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 +1038,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 +1141,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 +1184,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;
@@ -1102,6 +1196,7 @@ function createInstallerRun(value, options = {}) {
   let chunkColumn = 0;
   const trailingCR = /* @__PURE__ */ new Set();
   let deferredActivity;
+  const drawnPhaseCompletions = /* @__PURE__ */ new Set();
   const closeChunk = () => {
     if (chunkOpen) emit("\n", chunkChannel);
     chunkOpen = false;
@@ -1109,6 +1204,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 +1212,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 +1228,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,7 +1251,14 @@ function createInstallerRun(value, options = {}) {
         }
         return;
       }
-      if (!face.continues(id, state)) durable(title, facts.seconds ?? facts.measure ?? null, state);
+      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 (state === "ok") drawnPhaseCompletions.add(title);
+      }
       if (facts.detail) run2.relay(facts.detail);
     },
     surface(facts) {
@@ -1179,7 +1289,9 @@ function createInstallerRun(value, options = {}) {
         }
         return;
       }
+      if (state !== "fail" && drawnPhaseCompletions.has(step)) return;
       durable(step, ms === void 0 ? null : ms / 1e3, state);
+      if (state === "ok") drawnPhaseCompletions.add(step);
     },
     signIn({ url, code }) {
       start();
@@ -1286,7 +1398,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 +1510,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 +1806,7 @@ function page(title, body) {
 }
 
 // src/index.ts
-var LAUNCHER_VERSION = true ? "0.1.14" : readVersionFromPackage();
+var LAUNCHER_VERSION = true ? "0.1.17" : readVersionFromPackage();
 function defaultPrint(message) {
   process.stdout.write(`${message}
 `);
@@ -1783,7 +1895,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 +2027,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 +2107,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 +2135,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 +2150,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 +2220,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 +2337,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 +2371,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 +2457,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;
 }
 
@@ -663,7 +703,7 @@ async function installAcquisition(dir, candidate, version, acquisition, options)
 }
 
 // src/index.ts
-var import_node_child_process4 = require("node:child_process");
+var import_node_child_process5 = require("node:child_process");
 var import_node_fs11 = require("node:fs");
 var import_node_os4 = require("node:os");
 var import_node_path6 = require("node:path");
@@ -791,15 +831,24 @@ function createFace({ product, color = false, columns, env = process.env, operat
     const record = { v: PROGRESS_PROTOCOL, step: stripColor(title), state: kind };
     if (typeof measure === "number") record.ms = Math.max(0, Math.round(measure * 1e3));
     if (kind === "running" && typeof measure === "string") record.measure = measure;
-    try {
-      if (progressFile) (0, import_node_fs6.appendFileSync)(progressFile, `${JSON.stringify(record)}
-`);
-      else (0, import_node_fs6.writeSync)(progressFd, `${JSON.stringify(record)}
-`);
-      return true;
-    } catch {
-      return false;
+    const line = `${JSON.stringify(record)}
+`;
+    if (progressFd !== null) {
+      try {
+        (0, import_node_fs6.writeSync)(progressFd, line);
+        return true;
+      } catch {
+      }
     }
+    if (progressFile) {
+      try {
+        (0, import_node_fs6.appendFileSync)(progressFile, line);
+        return true;
+      } catch {
+        return false;
+      }
+    }
+    return false;
   };
   const welcome = () => continuesFace || nested ? [] : [
     `${paint(identity.accent, GLYPH.diamond)}  ${paint(identity.accent, identity.name)} \u2014 Mutatis Mutandis`,
@@ -813,7 +862,7 @@ function createFace({ product, color = false, columns, env = process.env, operat
   };
   const step = (title, measure = null, kind = "ok") => {
     if (emitMilestone(title, measure, kind)) return "";
-    const glyph = title === "Armed hourly updates" && kind === "ok" ? GLYPH.clock : kind === "fail" ? paint(identity.accent, GLYPH.cross) : kind === "note" ? paint(PALETTE.muted, GLYPH.dot) : paint(PALETTE.green, GLYPH.check);
+    const glyph = title === "Armed hourly updates" && kind === "ok" ? GLYPH.clock : kind === "fail" ? paint(identity.accent, GLYPH.cross) : kind === "note" ? paint(PALETTE.muted, GLYPH.dot) : paint(identity.accent, GLYPH.check);
     const measured = measure === null || measure === void 0 ? "" : paint(PALETTE.muted, typeof measure === "number" ? `${Math.max(0, Math.round(measure))}s` : String(measure).trim());
     const time = measured;
     const column = Math.min(44, Math.max(0, width - 8));
@@ -834,7 +883,7 @@ function createFace({ product, color = false, columns, env = process.env, operat
     const content = Math.min(width - 6, Math.max(...body.map(visibleWidth)));
     const rule = paint(identity.accent, GLYPH.rule.repeat(content + 4));
     const frame = (left, right) => `${paint(identity.accent, left)}${rule}${paint(identity.accent, right)}`;
-    const bodyRow = (line) => line.startsWith(GLYPH.check) ? `${paint(PALETTE.green, GLYPH.check)}${line.slice(1)}` : line;
+    const bodyRow = (line) => line.startsWith(GLYPH.check) ? `${paint(identity.accent, GLYPH.check)}${line.slice(1)}` : line;
     return [
       frame(GLYPH.boxTop, GLYPH.boxTopEnd),
       ...body.map((line) => `${paint(identity.accent, GLYPH.bar)}  ${bodyRow(line)}${" ".repeat(Math.max(0, content - visibleWidth(line)))}  ${paint(identity.accent, GLYPH.bar)}`),
@@ -863,7 +912,41 @@ 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 import_node_child_process2 = require("node:child_process");
+var UNICODE_SPINNER_FRAMES = Object.freeze(["\u25D2", "\u25D0", "\u25D3", "\u25D1"]);
+var ASCII_SPINNER_FRAMES = Object.freeze(["-", "\\", "|", "/"]);
+var cachedCodePage;
+function consoleOutputCodePage() {
+  if (cachedCodePage !== void 0) return cachedCodePage;
+  cachedCodePage = null;
+  try {
+    const out = (0, import_node_child_process2.execFileSync)("chcp.com", { windowsHide: true, encoding: "utf8", timeout: 5e3 });
+    const pages = [...String(out).matchAll(/(\d{3,5})/gu)].map((m) => Number(m[1]));
+    cachedCodePage = pages.length ? pages[pages.length - 1] : null;
+  } catch {
+    cachedCodePage = null;
+  }
+  return cachedCodePage;
+}
+function consoleRendersUnicode(env = process.env, platform = process.platform, codePage = platform === "win32" ? consoleOutputCodePage() : null) {
+  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") {
+    if (env.WT_SESSION || env.ConEmuANSI === "ON") return true;
+    return codePage === 65001;
+  }
+  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 +971,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 +992,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 +1070,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 +1173,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 +1216,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;
@@ -1134,6 +1228,7 @@ function createInstallerRun(value, options = {}) {
   let chunkColumn = 0;
   const trailingCR = /* @__PURE__ */ new Set();
   let deferredActivity;
+  const drawnPhaseCompletions = /* @__PURE__ */ new Set();
   const closeChunk = () => {
     if (chunkOpen) emit("\n", chunkChannel);
     chunkOpen = false;
@@ -1141,6 +1236,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 +1244,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 +1260,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,7 +1283,14 @@ function createInstallerRun(value, options = {}) {
         }
         return;
       }
-      if (!face.continues(id, state)) durable(title, facts.seconds ?? facts.measure ?? null, state);
+      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 (state === "ok") drawnPhaseCompletions.add(title);
+      }
       if (facts.detail) run2.relay(facts.detail);
     },
     surface(facts) {
@@ -1211,7 +1321,9 @@ function createInstallerRun(value, options = {}) {
         }
         return;
       }
+      if (state !== "fail" && drawnPhaseCompletions.has(step)) return;
       durable(step, ms === void 0 ? null : ms / 1e3, state);
+      if (state === "ok") drawnPhaseCompletions.add(step);
     },
     signIn({ url, code }) {
       start();
@@ -1317,7 +1429,7 @@ function createInstallerRun(value, options = {}) {
 }
 
 // src/autoupdate.ts
-var import_node_child_process2 = require("node:child_process");
+var import_node_child_process3 = require("node:child_process");
 var import_node_fs10 = require("node:fs");
 var import_node_os3 = require("node:os");
 var import_node_path5 = require("node:path");
@@ -1327,7 +1439,7 @@ function schedulePlatform(override) {
   return null;
 }
 function defaultExec(command2, args) {
-  const result = (0, import_node_child_process2.spawnSync)(command2, args, { encoding: "utf8", windowsHide: true });
+  const result = (0, import_node_child_process3.spawnSync)(command2, args, { encoding: "utf8", windowsHide: true });
   if (result.error) return { code: 1, stdout: "", stderr: result.error.message };
   return {
     code: typeof result.status === "number" ? result.status : 1,
@@ -1492,14 +1604,14 @@ function firstLine(text) {
 }
 
 // src/login-github.ts
-var import_node_child_process3 = require("node:child_process");
+var import_node_child_process4 = require("node:child_process");
 var realSleep = (ms) => new Promise((resolve3) => setTimeout(resolve3, ms));
 function openBrowser(url) {
   if (process.env.LAUNCHER_NO_OPEN === "1") return;
   const opener = process.platform === "darwin" ? "open" : process.platform === "win32" ? "rundll32" : "xdg-open";
   const args = process.platform === "win32" ? ["url.dll,FileProtocolHandler", url] : [url];
   try {
-    const child = (0, import_node_child_process3.spawn)(opener, args, { detached: true, stdio: "ignore", windowsHide: true });
+    const child = (0, import_node_child_process4.spawn)(opener, args, { detached: true, stdio: "ignore", windowsHide: true });
     child.on("error", () => {
     });
     child.unref();
@@ -1726,7 +1838,7 @@ function page(title, body) {
 }
 
 // src/index.ts
-var LAUNCHER_VERSION = true ? "0.1.14" : readVersionFromPackage();
+var LAUNCHER_VERSION = true ? "0.1.17" : readVersionFromPackage();
 function defaultPrint(message) {
   process.stdout.write(`${message}
 `);
@@ -1979,7 +2091,7 @@ function defaultRunEntry(entry2, cwd, env) {
   const [command2, ...args] = entry2;
   const shell = needsShell(command2);
   const commandLine = shell ? [command2, ...args].map(quoteForShell).join(" ") : command2;
-  const spawnEntry = (progress2) => (0, import_node_child_process4.spawnSync)(commandLine, shell ? [] : args, {
+  const spawnEntry = (progress2) => (0, import_node_child_process5.spawnSync)(commandLine, shell ? [] : args, {
     cwd,
     stdio: progress2 ? ["inherit", "inherit", "inherit", "pipe"] : "inherit",
     shell,
@@ -2027,8 +2139,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 +2167,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 +2182,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);
@@ -2202,7 +2332,7 @@ async function runInstallEntry(entry2, cwd, env, installer, tokens = null) {
   const redact = (text) => secrets.reduce((safe, value) => safe.replaceAll(value, "[redacted]"), text);
   try {
     const result = await new Promise((resolve3) => {
-      const child = (0, import_node_child_process4.spawn)(shell ? [command2, ...args].map(quoteForShell).join(" ") : command2, shell ? [] : args, {
+      const child = (0, import_node_child_process5.spawn)(shell ? [command2, ...args].map(quoteForShell).join(" ") : command2, shell ? [] : args, {
         cwd,
         shell,
         windowsHide: true,

package/package.json

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