ADE-119 Surface disk-space failures and recovery in desktop auto-update UX -> Primary (#776)

* Refs ADE-119: Surface auto-update disk space failures and recovery

* Refs ADE-119: Preserve cached update recovery without download preflight

* Refs ADE-119: Keep slow update refreshes outside install watchdog

* Refs ADE-119: Bound native updater handoff without losing recovery state

* Refs ADE-119: Preserve verified updates across retry feed failures

Author: arul28

apps/desktop/src/main/main.ts

@@ -2009,6 +2009,7 @@ app.whenReady().then(async () => {
     currentVersion: app.getVersion(),
     globalStatePath,
     updaterCacheDir: app.isPackaged ? resolveAutoUpdaterCacheDir() : undefined,
+    installTargetPath: process.execPath,
     autoCheckEnabled: app.isPackaged,
     beforeQuitAndInstall: prepareAutoUpdateInstall,
   });

apps/desktop/src/main/services/updates/autoUpdateErrors.ts

@@ -0,0 +1,112 @@
+import fs from "node:fs";
+import path from "node:path";
+import type { UpdateInfo } from "electron-updater";
+import type { AutoUpdateErrorKind, AutoUpdatePhase } from "../../../shared/types";
+
+const MIB = 1024 * 1024;
+const DEFAULT_UPDATE_DOWNLOAD_BYTES = 512 * MIB;
+const UPDATE_SPACE_HEADROOM_BYTES = 512 * MIB;
+
+export type DiskSpaceInfo = {
+  availableBytes: number;
+  volumePath: string;
+};
+
+function nearestExistingPath(targetPath: string): string {
+  let candidate = path.resolve(targetPath);
+  while (!fs.existsSync(candidate)) {
+    const parent = path.dirname(candidate);
+    if (parent === candidate) return candidate;
+    candidate = parent;
+  }
+  return candidate;
+}
+
+export function readDiskSpace(targetPath: string): DiskSpaceInfo {
+  const volumePath = nearestExistingPath(targetPath);
+  const stats = fs.statfsSync(volumePath, { bigint: true });
+  return {
+    availableBytes: Number(stats.bavail * stats.bsize),
+    volumePath,
+  };
+}
+
+export function finitePositive(value: unknown): number | null {
+  return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : null;
+}
+
+export function updateDownloadBytes(info: UpdateInfo | null | undefined): number | null {
+  if (!info || !Array.isArray(info.files)) return null;
+  let largest = 0;
+  for (const file of info.files) {
+    const size = finitePositive(file.size);
+    if (size && size > largest) largest = size;
+  }
+  return largest || null;
+}
+
+// electron-updater keeps the pending archive and a second update.zip used for
+// future differential downloads. Squirrel.Mac then fetches that archive again
+// and expands/replaces the app. These are deliberately conservative estimates:
+// two compressed copies for download; one staged copy plus a 4x expansion
+// allowance for install; and 512 MiB of filesystem/rollback headroom.
+export function estimateUpdateRequiredBytes(
+  phase: "download" | "install",
+  compressedBytes: number | null,
+): number {
+  const archiveBytes = compressedBytes ?? DEFAULT_UPDATE_DOWNLOAD_BYTES;
+  return phase === "download"
+    ? (archiveBytes * 2) + UPDATE_SPACE_HEADROOM_BYTES
+    : (archiveBytes * 5) + UPDATE_SPACE_HEADROOM_BYTES;
+}
+
+function errorCode(error: unknown): string {
+  if (!error || typeof error !== "object") return "";
+  const code = (error as { code?: unknown }).code;
+  return typeof code === "string" ? code.toUpperCase() : "";
+}
+
+function errorMessage(error: unknown): string {
+  return error instanceof Error ? error.message : String(error ?? "unknown");
+}
+
+export function classifyUpdateError(
+  error: unknown,
+  fallbackPhase: AutoUpdatePhase,
+): { kind: AutoUpdateErrorKind; phase: AutoUpdatePhase } {
+  const code = errorCode(error);
+  const message = errorMessage(error).toLowerCase();
+  const phase = /extract|staging|shipit|unpack/.test(message) ? "staging" : fallbackPhase;
+  if (code === "ENOSPC" || /no space left|disk(?: is)? full/.test(message)) {
+    return { kind: "disk_full", phase };
+  }
+  if (code === "EDQUOT" || /quota exceeded|disk quota/.test(message)) {
+    return { kind: "quota", phase };
+  }
+  if (/not enough (?:free )?(?:disk )?space|insufficient (?:disk )?(?:space|capacity)/.test(message)) {
+    return { kind: "insufficient_space", phase };
+  }
+  if (/signature|code requirement|notariz/.test(message)) {
+    return { kind: "signature", phase: "verification" };
+  }
+  if (/sha(?:512)?|checksum|verify|verification|corrupt/.test(message)) {
+    return { kind: "verification", phase: "verification" };
+  }
+  if (
+    code === "EACCES"
+    || code === "EPERM"
+    || code === "EROFS"
+    || /permission denied|not permitted|read-only file system/.test(message)
+  ) {
+    return { kind: "permission", phase };
+  }
+  if (
+    /\b(?:enotfound|econnreset|econnrefused|etimedout|network|offline|http 4\d\d|http 5\d\d)\b/.test(`${code.toLowerCase()} ${message}`)
+  ) {
+    return { kind: "network", phase };
+  }
+  if (phase === "install" || phase === "staging") {
+    return { kind: "installer", phase };
+  }
+  return { kind: "unknown", phase };
+}