@absolutejs/absolute 0.20.0-beta.52 → 0.20.0-beta.54

package/dist/angular/components/core/streamingSlotRegistrar.js

@@ -1,7 +1,7 @@
 // @bun
 var __require = import.meta.require;
 
-// .angular-partial-tmp-x73pOK/src/core/streamingSlotRegistrar.ts
+// .angular-partial-tmp-WVc43d/src/core/streamingSlotRegistrar.ts
 var STREAMING_SLOT_REGISTRAR_KEY = Symbol.for("absolutejs.streamingSlotRegistrar");
 var STREAMING_SLOT_WARNING_STORAGE_KEY = Symbol.for("absolutejs.streamingSlotWarningController");
 var STREAMING_SLOT_COLLECTION_STORAGE_KEY = Symbol.for("absolutejs.streamingSlotCollectionController");

package/dist/angular/components/core/streamingSlotRegistry.js

@@ -1,7 +1,7 @@
 // @bun
 var __require = import.meta.require;
 
-// .angular-partial-tmp-x73pOK/src/core/streamingSlotRegistrar.ts
+// .angular-partial-tmp-WVc43d/src/core/streamingSlotRegistrar.ts
 var STREAMING_SLOT_REGISTRAR_KEY = Symbol.for("absolutejs.streamingSlotRegistrar");
 var STREAMING_SLOT_WARNING_STORAGE_KEY = Symbol.for("absolutejs.streamingSlotWarningController");
 var STREAMING_SLOT_COLLECTION_STORAGE_KEY = Symbol.for("absolutejs.streamingSlotCollectionController");
@@ -48,7 +48,7 @@ var warnMissingStreamingSlotCollector = (primitiveName) => {
   getWarningController()?.maybeWarn(primitiveName);
 };
 
-// .angular-partial-tmp-x73pOK/src/core/streamingSlotRegistry.ts
+// .angular-partial-tmp-WVc43d/src/core/streamingSlotRegistry.ts
 var STREAMING_SLOT_STORAGE_KEY = Symbol.for("absolutejs.streamingSlotAsyncLocalStorage");
 var isObjectRecord2 = (value) => Boolean(value) && typeof value === "object";
 var isAsyncLocalStorage = (value) => isObjectRecord2(value) && ("getStore" in value) && typeof value.getStore === "function" && ("run" in value) && typeof value.run === "function";

package/dist/cli/index.js

@@ -5957,7 +5957,7 @@ import {
   resolve as resolvePath,
   sep as sep5
 } from "path";
-var PROFILE_FORMAT = 1, REMOTE_STDIN_FLUSH_ATTEMPTS = 3, REMOTE_SESSION_CLOSE_TIMEOUT_MS = 2000, PROFILE_NAME, SSH_DESTINATION, defaultProfilePath = () => join15(homedir4(), ".absolutejs", "mobile", "remote-macs.json"), emptyStore = () => ({
+var PROFILE_FORMAT = 1, REMOTE_STDIN_FLUSH_ATTEMPTS = 3, REMOTE_SESSION_CLOSE_TIMEOUT_MS = 2000, REMOTE_RELEASE_LEASE_HEARTBEAT_MS = 15000, REMOTE_RELEASE_LEASE_STALE_SECONDS = 120, PROFILE_NAME, SSH_DESTINATION, defaultProfilePath = () => join15(homedir4(), ".absolutejs", "mobile", "remote-macs.json"), emptyStore = () => ({
   format: PROFILE_FORMAT,
   profiles: {}
 }), loadStore = async (path = defaultProfilePath()) => {
@@ -6142,7 +6142,111 @@ var PROFILE_FORMAT = 1, REMOTE_STDIN_FLUSH_ATTEMPTS = 3, REMOTE_SESSION_CLOSE_TI
   remoteProjectRoot: posix.join(profile.workspaceRoot, "projects", projectIdentity(projectRoot, config.appId), "current"),
   xcodebuild: "remote:xcodebuild",
   xcrun: "remote:xcrun"
-}), installAbsoluteRemoteMacAgent = async (project) => {
+}), releaseLeasePath = (project) => posix.join(posix.dirname(project.remoteProjectRoot), ".release-lease"), acquireAbsoluteRemoteMacReleaseLease = async (project, options = {}) => {
+  options.signal?.throwIfAborted();
+  const token = randomUUID4();
+  const path = releaseLeasePath(project);
+  const stalePath = `${path}.stale-${token}`;
+  const staleSeconds = options.staleSeconds ?? REMOTE_RELEASE_LEASE_STALE_SECONDS;
+  if (!Number.isSafeInteger(staleSeconds) || staleSeconds < 30)
+    throw new TypeError("Remote Mac release lease expiry must be at least 30 seconds.");
+  const owner = JSON.stringify({
+    acquiredAt: new Date().toISOString(),
+    appId: project.config.appId,
+    host: process.env.HOSTNAME ?? "unknown",
+    pid: process.pid,
+    token
+  });
+  const script = [
+    "set -eu",
+    "umask 077",
+    `mkdir -p ${shellQuote(posix.dirname(path))}`,
+    `if mkdir ${shellQuote(path)} 2>/dev/null; then status=ACQUIRED; else now=$(date +%s); modified=$(stat -f %m ${shellQuote(path)} 2>/dev/null || printf '0'); age=$((now-modified)); if [ "$age" -le ${staleSeconds} ]; then printf 'BUSY\\n'; cat ${shellQuote(posix.join(path, "owner.json"))} 2>/dev/null || true; exit 73; fi; if mv ${shellQuote(path)} ${shellQuote(stalePath)} 2>/dev/null && mkdir ${shellQuote(path)} 2>/dev/null; then status=RECOVERED; rm -rf ${shellQuote(stalePath)}; else printf 'BUSY\\n'; exit 73; fi; fi`,
+    `printf '%s\\n' ${shellQuote(token)} > ${shellQuote(posix.join(path, "token"))}`,
+    `printf '%s\\n' ${shellQuote(owner)} > ${shellQuote(posix.join(path, "owner.json"))}`,
+    `touch ${shellQuote(path)}`,
+    `printf '%s\\n' "$status"`
+  ].join("; ");
+  const capture = options.transport?.capture ?? defaultTransport.capture;
+  const result = await capture([
+    ...absoluteRemoteMacSshBase(project.profile),
+    "/bin/sh -lc",
+    shellQuote(script)
+  ]);
+  if (result.exitCode !== 0) {
+    if (result.exitCode === 73 || result.stdout.startsWith("BUSY"))
+      throw new Error(`Remote Mac ${project.profile.name} is already building ${project.config.appId}. Wait for that release to finish; a crashed lease recovers automatically after ${staleSeconds} seconds.${result.stdout.split(`
+`).slice(1).join(" ").trim() ? ` Owner: ${result.stdout.split(`
+`).slice(1).join(" ").trim()}` : ""}`);
+    requireRemoteSuccess(result, "Remote Mac release lease acquisition");
+  }
+  const recovered = result.stdout.trim().split(/\r?\n/u).at(-1) === "RECOVERED";
+  const runOwned = async (action) => {
+    const ownedScript = `test -f ${shellQuote(posix.join(path, "token"))} && ` + `test "$(cat ${shellQuote(posix.join(path, "token"))})" = ${shellQuote(token)} && ${action}`;
+    const owned = await capture([
+      ...absoluteRemoteMacSshBase(project.profile),
+      "/bin/sh -lc",
+      shellQuote(ownedScript)
+    ]);
+    requireRemoteSuccess(owned, "Remote Mac release lease ownership check");
+  };
+  return {
+    path,
+    recovered,
+    token,
+    heartbeat: () => runOwned(`touch ${shellQuote(path)}`),
+    release: () => runOwned(`rm -rf ${shellQuote(path)}`)
+  };
+}, inspectAbsoluteRemoteMacWorkspace = async (profile, transport) => {
+  const root = profile.workspaceRoot;
+  const script = [
+    "set -eu",
+    `mkdir -p ${shellQuote(root)}`,
+    `bytes=$(du -sk ${shellQuote(root)} 2>/dev/null | awk '{print $1 * 1024}')`,
+    `projects=$(find ${shellQuote(posix.join(root, "projects"))} -mindepth 1 -maxdepth 1 -type d 2>/dev/null | wc -l | tr -d ' ')`,
+    `agents=$(find ${shellQuote(posix.join(root, "agents"))} -mindepth 2 -maxdepth 2 -type d 2>/dev/null | wc -l | tr -d ' ')`,
+    `leases=$(find ${shellQuote(posix.join(root, "projects"))} -mindepth 2 -maxdepth 2 -type d -name .release-lease 2>/dev/null | wc -l | tr -d ' ')`,
+    `printf '%s\\n%s\\n%s\\n%s\\n' "${"$"}{bytes:-0}" "${"$"}{projects:-0}" "${"$"}{agents:-0}" "${"$"}{leases:-0}"`
+  ].join("; ");
+  const result = await (transport?.capture ?? defaultTransport.capture)([
+    ...absoluteRemoteMacSshBase(profile),
+    "/bin/sh -lc",
+    shellQuote(script)
+  ]);
+  const [bytes, projectCount, agentCount, leaseCount] = requireRemoteSuccess(result, "Remote Mac workspace inspection").split(/\r?\n/u).map(Number);
+  if ([bytes, projectCount, agentCount, leaseCount].some((value) => typeof value !== "number" || !Number.isSafeInteger(value) || value < 0))
+    throw new TypeError("Remote Mac returned invalid workspace statistics.");
+  return {
+    agentCount: agentCount ?? 0,
+    bytes: bytes ?? 0,
+    leaseCount: leaseCount ?? 0,
+    profile: profile.name,
+    projectCount: projectCount ?? 0,
+    workspaceRoot: root
+  };
+}, cleanAbsoluteRemoteMacWorkspace = async (profile, transport) => {
+  const root = profile.workspaceRoot;
+  const projects = posix.join(root, "projects");
+  const script = [
+    "set -eu",
+    `mkdir -p ${shellQuote(root)}`,
+    `project_staging=$(find ${shellQuote(projects)} -mindepth 2 -maxdepth 2 -type d \\( -name '.incoming-*' -o -name '.previous' -o -name '.release-lease.stale-*' \\) -mtime +0 -prune -print 2>/dev/null | wc -l | tr -d ' ')`,
+    `mobile_staging=$(find ${shellQuote(projects)} -type d \\( -path '*/current/.absolutejs/mobile/.ios-build-*' -o -path '*/current/.absolutejs/mobile/.ios-stage-*' -o -path '*/current/.absolutejs/mobile/*.incoming-*' \\) -mtime +0 -prune -print 2>/dev/null | wc -l | tr -d ' ')`,
+    `count=$((project_staging+mobile_staging))`,
+    `find ${shellQuote(projects)} -mindepth 2 -maxdepth 2 -type d \\( -name '.incoming-*' -o -name '.previous' -o -name '.release-lease.stale-*' \\) -mtime +0 -prune -exec rm -rf {} + 2>/dev/null || true`,
+    `find ${shellQuote(projects)} -type d \\( -path '*/current/.absolutejs/mobile/.ios-build-*' -o -path '*/current/.absolutejs/mobile/.ios-stage-*' -o -path '*/current/.absolutejs/mobile/*.incoming-*' \\) -mtime +0 -prune -exec rm -rf {} + 2>/dev/null || true`,
+    `printf '%s\\n' "$count"`
+  ].join("; ");
+  const result = await (transport?.capture ?? defaultTransport.capture)([
+    ...absoluteRemoteMacSshBase(profile),
+    "/bin/sh -lc",
+    shellQuote(script)
+  ]);
+  const removed = Number(requireRemoteSuccess(result, "Remote Mac workspace cleanup"));
+  if (!Number.isSafeInteger(removed) || removed < 0)
+    throw new TypeError("Remote Mac returned an invalid cleanup result.");
+  return { profile: profile.name, removed, workspaceRoot: root };
+}, installAbsoluteRemoteMacAgent = async (project) => {
   const artifact = await materializeAbsoluteRemoteMacAgent(project.projectRoot);
   const directory = posix.join(project.profile.workspaceRoot, "agents", `protocol-${ABSOLUTE_REMOTE_MAC_PROTOCOL_VERSION}`, artifact.sha256);
   const remotePath = posix.join(directory, "agent.js");
@@ -6291,13 +6395,16 @@ var PROFILE_FORMAT = 1, REMOTE_STDIN_FLUSH_ATTEMPTS = 3, REMOTE_SESSION_CLOSE_TI
       "."
     ]
   };
-}, syncAbsoluteRemoteMacProject = async (project) => {
+}, syncAbsoluteRemoteMacProject = async (project, options = {}) => {
+  options.signal?.throwIfAborted();
   const commands = absoluteRemoteProjectSyncCommands(project);
   const archive = Bun.spawn(commands.tar, {
+    signal: options.signal,
     stderr: "pipe",
     stdout: "pipe"
   });
   const upload = Bun.spawn(commands.remote, {
+    signal: options.signal,
     stderr: "pipe",
     stdin: archive.stdout,
     stdout: "pipe"
@@ -6342,13 +6449,16 @@ var PROFILE_FORMAT = 1, REMOTE_STDIN_FLUSH_ATTEMPTS = 3, REMOTE_SESSION_CLOSE_TI
     ],
     tar: ["tar", "-cf", "-", "-C", project.config.bundleDirectory, "."]
   };
-}, syncAbsoluteRemoteMacReleaseInputs = async (project) => {
+}, syncAbsoluteRemoteMacReleaseInputs = async (project, options = {}) => {
+  options.signal?.throwIfAborted();
   const commands = absoluteRemoteReleaseInputSyncCommands(project);
   const archive = Bun.spawn(commands.tar, {
+    signal: options.signal,
     stderr: "pipe",
     stdout: "pipe"
   });
   const upload = Bun.spawn(commands.remote, {
+    signal: options.signal,
     stderr: "pipe",
     stdin: archive.stdout,
     stdout: "pipe"
@@ -6440,114 +6550,176 @@ var PROFILE_FORMAT = 1, REMOTE_STDIN_FLUSH_ATTEMPTS = 3, REMOTE_SESSION_CLOSE_TI
   }
 }, buildAbsoluteRemoteIosRelease = async (options) => {
   const startedAt = performance.now();
-  const syncStartedAt = performance.now();
-  await (options.syncProject ?? syncAbsoluteRemoteMacProject)(options.project);
-  await (options.syncReleaseInputs ?? syncAbsoluteRemoteMacReleaseInputs)(options.project);
-  const syncDuration = performance.now() - syncStartedAt;
+  options.signal?.throwIfAborted();
+  const operation2 = new AbortController;
+  const abort = () => operation2.abort(options.signal?.reason ?? new Error("Remote iOS release cancelled."));
+  options.signal?.addEventListener("abort", abort, { once: true });
+  let lease;
+  const leaseStartedAt = performance.now();
+  try {
+    lease = await (options.acquireLease ?? ((project, signal) => acquireAbsoluteRemoteMacReleaseLease(project, {
+      signal,
+      transport: options.transport
+    })))(options.project, operation2.signal);
+  } catch (error) {
+    options.signal?.removeEventListener("abort", abort);
+    throw error;
+  }
+  options.log?.(`${lease.recovered ? "Recovered stale" : "Acquired"} Remote Mac release lease for ${options.project.config.appId}.`);
+  const leaseDuration = performance.now() - leaseStartedAt;
   options.onPhaseTiming?.({
-    durationMs: syncDuration,
-    phase: "remote-release-sync"
+    durationMs: leaseDuration,
+    phase: "remote-release-lease"
   });
-  const agentStartedAt = performance.now();
-  const agent = await (options.installAgent ?? installAbsoluteRemoteMacAgent)(options.project);
-  const agentDuration = performance.now() - agentStartedAt;
-  const encodedConfig = Buffer.from(JSON.stringify(portableMobileConfig(options.project))).toString("base64url");
-  const remoteCommand = [
-    `cd ${shellQuote(options.project.remoteProjectRoot)}`,
-    "&&",
-    "exec",
-    shellQuote(options.project.profile.bunPath),
-    shellQuote(agent.remotePath),
-    "--release-ios",
-    "--mobile-config",
-    shellQuote(encodedConfig),
-    ...options.allowUnsigned ? ["--unsigned"] : [],
-    ...options.prepareBuildNumber ? ["--request-build-number"] : [],
-    ...options.developmentTeam ? ["--development-team", shellQuote(options.developmentTeam)] : []
-  ].join(" ");
-  const process2 = (options.transport?.spawn ?? defaultTransport.spawn)([
-    ...absoluteRemoteMacSshBase(options.project.profile),
-    "/bin/sh -lc",
-    shellQuote(remoteCommand)
-  ], {});
-  let failure;
-  let metadata;
-  const responses = [];
-  const stdoutDone = consumeLines2(process2.stdout, (line) => {
-    if (!line.startsWith(ABSOLUTE_REMOTE_MAC_EVENT_PREFIX))
+  let heartbeat;
+  const heartbeatTimer = setInterval(() => {
+    if (heartbeat)
       return;
-    try {
-      const event = JSON.parse(line.slice(ABSOLUTE_REMOTE_MAC_EVENT_PREFIX.length));
-      if (event.v !== ABSOLUTE_REMOTE_MAC_PROTOCOL_VERSION)
-        throw new Error("Remote Mac protocol version mismatch.");
-      if (event.type === "log")
-        options.log?.(event.message);
-      if (event.type === "timing") {
-        const durationMs = Reflect.get(event, "durationMs");
-        const phase = Reflect.get(event, "phase");
-        if (typeof durationMs === "number" && typeof phase === "string")
-          options.onPhaseTiming?.({ durationMs, phase });
-      }
-      if (event.type === "fatal")
-        failure = new Error(event.error);
-      if (event.type === "release")
-        metadata = requireAbsoluteIosReleaseMetadata(event.metadata);
-      if (event.type === "build-number-request") {
-        if (!options.prepareBuildNumber || !/^[a-f0-9]{64}$/u.test(event.buildIdentity) || !event.id)
-          throw new TypeError("Remote Mac requested an invalid iOS build number.");
-        responses.push(options.prepareBuildNumber(event.buildIdentity).then(async (buildNumber) => {
-          if (!Number.isSafeInteger(buildNumber) || buildNumber < 1)
-            throw new TypeError("iOS release publisher returned an invalid build number.");
-          process2.stdin.write(`${JSON.stringify({ buildNumber, command: "build-number", id: event.id, v: ABSOLUTE_REMOTE_MAC_PROTOCOL_VERSION })}
+    heartbeat = lease.heartbeat().catch((error) => operation2.abort(error)).finally(() => {
+      heartbeat = undefined;
+    });
+  }, REMOTE_RELEASE_LEASE_HEARTBEAT_MS);
+  heartbeatTimer.unref();
+  try {
+    const syncStartedAt = performance.now();
+    if (options.syncProject)
+      await options.syncProject(options.project);
+    else
+      await syncAbsoluteRemoteMacProject(options.project, {
+        signal: operation2.signal
+      });
+    operation2.signal.throwIfAborted();
+    if (options.syncReleaseInputs)
+      await options.syncReleaseInputs(options.project);
+    else
+      await syncAbsoluteRemoteMacReleaseInputs(options.project, {
+        signal: operation2.signal
+      });
+    operation2.signal.throwIfAborted();
+    const syncDuration = performance.now() - syncStartedAt;
+    options.onPhaseTiming?.({
+      durationMs: syncDuration,
+      phase: "remote-release-sync"
+    });
+    const agentStartedAt = performance.now();
+    const agent = await (options.installAgent ?? installAbsoluteRemoteMacAgent)(options.project);
+    operation2.signal.throwIfAborted();
+    const agentDuration = performance.now() - agentStartedAt;
+    const encodedConfig = Buffer.from(JSON.stringify(portableMobileConfig(options.project))).toString("base64url");
+    const remoteCommand = [
+      `cd ${shellQuote(options.project.remoteProjectRoot)}`,
+      "&&",
+      "exec",
+      shellQuote(options.project.profile.bunPath),
+      shellQuote(agent.remotePath),
+      "--release-ios",
+      "--mobile-config",
+      shellQuote(encodedConfig),
+      ...options.allowUnsigned ? ["--unsigned"] : [],
+      ...options.prepareBuildNumber ? ["--request-build-number"] : [],
+      ...options.developmentTeam ? ["--development-team", shellQuote(options.developmentTeam)] : []
+    ].join(" ");
+    const process2 = (options.transport?.spawn ?? defaultTransport.spawn)([
+      ...absoluteRemoteMacSshBase(options.project.profile),
+      "/bin/sh -lc",
+      shellQuote(remoteCommand)
+    ], { signal: operation2.signal });
+    const killOnAbort = () => process2.kill();
+    operation2.signal.addEventListener("abort", killOnAbort, { once: true });
+    let failure;
+    let metadata;
+    const responses = [];
+    const stdoutDone = consumeLines2(process2.stdout, (line) => {
+      if (!line.startsWith(ABSOLUTE_REMOTE_MAC_EVENT_PREFIX))
+        return;
+      try {
+        const event = JSON.parse(line.slice(ABSOLUTE_REMOTE_MAC_EVENT_PREFIX.length));
+        if (event.v !== ABSOLUTE_REMOTE_MAC_PROTOCOL_VERSION)
+          throw new Error("Remote Mac protocol version mismatch.");
+        if (event.type === "log")
+          options.log?.(event.message);
+        if (event.type === "timing") {
+          const durationMs = Reflect.get(event, "durationMs");
+          const phase = Reflect.get(event, "phase");
+          if (typeof durationMs === "number" && typeof phase === "string")
+            options.onPhaseTiming?.({ durationMs, phase });
+        }
+        if (event.type === "fatal")
+          failure = new Error(event.error);
+        if (event.type === "release")
+          metadata = requireAbsoluteIosReleaseMetadata(event.metadata);
+        if (event.type === "build-number-request") {
+          if (!options.prepareBuildNumber || !/^[a-f0-9]{64}$/u.test(event.buildIdentity) || !event.id)
+            throw new TypeError("Remote Mac requested an invalid iOS build number.");
+          responses.push(options.prepareBuildNumber(event.buildIdentity).then(async (buildNumber) => {
+            if (!Number.isSafeInteger(buildNumber) || buildNumber < 1)
+              throw new TypeError("iOS release publisher returned an invalid build number.");
+            process2.stdin.write(`${JSON.stringify({ buildNumber, command: "build-number", id: event.id, v: ABSOLUTE_REMOTE_MAC_PROTOCOL_VERSION })}
 `);
-          for (let attempt = 0;attempt < REMOTE_STDIN_FLUSH_ATTEMPTS; attempt++) {
-            try {
-              await process2.stdin.flush();
-              break;
-            } catch {
-              await Promise.resolve();
+            for (let attempt = 0;attempt < REMOTE_STDIN_FLUSH_ATTEMPTS; attempt++) {
+              try {
+                await process2.stdin.flush();
+                break;
+              } catch {
+                await Promise.resolve();
+              }
             }
-          }
-        }).catch((error) => {
-          failure = error instanceof Error ? error : new Error("Failed to allocate an iOS build number.");
-          process2.kill();
-          return;
-        }));
+          }).catch((error) => {
+            failure = error instanceof Error ? error : new Error("Failed to allocate an iOS build number.");
+            process2.kill();
+            return;
+          }));
+        }
+      } catch (error) {
+        failure = error instanceof Error ? error : new Error("Remote Mac emitted an invalid release event.");
+        process2.kill();
+      }
+    });
+    const stderrDone = consumeLines2(process2.stderr, (line) => options.log?.(`[remote] ${line}`));
+    const exitCode = await process2.exited;
+    operation2.signal.removeEventListener("abort", killOnAbort);
+    try {
+      process2.stdin.end();
+    } catch {}
+    await Promise.all([stdoutDone, stderrDone, ...responses]);
+    operation2.signal.throwIfAborted();
+    if (failure)
+      throw failure;
+    if (exitCode !== 0)
+      throw new Error(`Remote iOS release agent exited with status ${exitCode}.`);
+    if (!metadata)
+      throw new Error("Remote iOS release agent did not return an IPA.");
+    const downloadStartedAt = performance.now();
+    const release = await (options.retrieveRelease ?? retrieveAbsoluteRemoteIosRelease)(options.project, metadata, options.outputDirectory);
+    const downloadDuration = performance.now() - downloadStartedAt;
+    options.onPhaseTiming?.({
+      durationMs: downloadDuration,
+      phase: "remote-release-download"
+    });
+    options.log?.(`Remote Mac ${options.project.profile.name} built and verified iOS release ${metadata.releaseId} in ${(performance.now() - startedAt).toFixed(2)}ms (agent ${agent.uploaded ? "uploaded" : "cache hit"}).`);
+    return {
+      ...release,
+      timings: {
+        "remote-agent": agentDuration,
+        "remote-release-download": downloadDuration,
+        "remote-release-lease": leaseDuration,
+        "remote-release-sync": syncDuration,
+        total: performance.now() - startedAt
       }
+    };
+  } finally {
+    clearInterval(heartbeatTimer);
+    await heartbeat?.catch(() => {
+      return;
+    });
+    options.signal?.removeEventListener("abort", abort);
+    try {
+      await lease.release();
+      options.log?.("Released Remote Mac release lease.");
     } catch (error) {
-      failure = error instanceof Error ? error : new Error("Remote Mac emitted an invalid release event.");
-      process2.kill();
-    }
-  });
-  const stderrDone = consumeLines2(process2.stderr, (line) => options.log?.(`[remote] ${line}`));
-  const exitCode = await process2.exited;
-  try {
-    process2.stdin.end();
-  } catch {}
-  await Promise.all([stdoutDone, stderrDone, ...responses]);
-  if (failure)
-    throw failure;
-  if (exitCode !== 0)
-    throw new Error(`Remote iOS release agent exited with status ${exitCode}.`);
-  if (!metadata)
-    throw new Error("Remote iOS release agent did not return an IPA.");
-  const downloadStartedAt = performance.now();
-  const release = await (options.retrieveRelease ?? retrieveAbsoluteRemoteIosRelease)(options.project, metadata, options.outputDirectory);
-  const downloadDuration = performance.now() - downloadStartedAt;
-  options.onPhaseTiming?.({
-    durationMs: downloadDuration,
-    phase: "remote-release-download"
-  });
-  options.log?.(`Remote Mac ${options.project.profile.name} built and verified iOS release ${metadata.releaseId} in ${(performance.now() - startedAt).toFixed(2)}ms (agent ${agent.uploaded ? "uploaded" : "cache hit"}).`);
-  return {
-    ...release,
-    timings: {
-      "remote-agent": agentDuration,
-      "remote-release-download": downloadDuration,
-      "remote-release-sync": syncDuration,
-      total: performance.now() - startedAt
+      options.log?.(`Remote Mac release lease cleanup failed and will recover after expiry: ${error instanceof Error ? error.message : String(error)}`);
     }
-  };
+  }
 }, startAbsoluteRemoteExpoIosDevSession = async (options) => {
   const session = await startAbsoluteRemoteDevSession({
     certificateAuthorityPath: options.certificateAuthorityPath,
@@ -22251,6 +22423,32 @@ var NOT_FOUND4 = -1, isRecord17 = (value) => typeof value === "object" && value
   });
   console.log(`Paired remote Mac ${profile.name} (${profile.xcodeVersion}) and selected it as the default iOS development host.`);
 }, listRemoteMacs = async (args) => {
+  if (args[0] === "inspect") {
+    const requested = args[1]?.startsWith("-") ? undefined : args[1];
+    const profile = await getAbsoluteRemoteMacProfile(requested, remoteProfilePath());
+    if (!profile)
+      throw new TypeError("No Remote Mac is selected. Pair one before inspecting its workspace.");
+    const inspection = await inspectAbsoluteRemoteMacWorkspace(profile);
+    console.log(args.includes("--json") ? JSON.stringify(inspection, null, 2) : [
+      `Remote Mac: ${inspection.profile}`,
+      `Workspace: ${inspection.workspaceRoot}`,
+      `Cache: ${(inspection.bytes / 1048576).toFixed(1)} MiB across ${inspection.projectCount} project(s) and ${inspection.agentCount} agent artifact(s)`,
+      `Active release leases: ${inspection.leaseCount}`
+    ].join(`
+`));
+    return;
+  }
+  if (args[0] === "clean") {
+    if (!args.includes("--yes"))
+      throw new TypeError("Remote Mac cleanup requires --yes. It removes only abandoned staging directories older than one day.");
+    const requested = args[1]?.startsWith("-") ? undefined : args[1];
+    const profile = await getAbsoluteRemoteMacProfile(requested, remoteProfilePath());
+    if (!profile)
+      throw new TypeError("No Remote Mac is selected. Pair one before cleaning its workspace.");
+    const result2 = await cleanAbsoluteRemoteMacWorkspace(profile);
+    console.log(`Removed ${result2.removed} abandoned Remote Mac staging director${result2.removed === 1 ? "y" : "ies"}; project caches, releases, and active leases were retained.`);
+    return;
+  }
   const result = await listAbsoluteRemoteMacProfiles(remoteProfilePath());
   if (args.includes("--json")) {
     console.log(JSON.stringify(result, null, 2));
@@ -22748,6 +22946,18 @@ Mobile release security and compliance checks failed.`);
     ...options.prepareBuildNumber === undefined ? {} : { prepareBuildNumber: options.prepareBuildNumber },
     projectRoot: options.projectRoot
   });
+}, listenForRemoteReleaseCancellation = (cancellation) => {
+  if (!cancellation)
+    return () => {
+      return;
+    };
+  const cancel = () => cancellation.abort(new Error("Remote iOS release interrupted."));
+  process.once("SIGINT", cancel);
+  process.once("SIGTERM", cancel);
+  return () => {
+    process.removeListener("SIGINT", cancel);
+    process.removeListener("SIGTERM", cancel);
+  };
 }, buildIos = async (args, prepareBuildNumber) => {
   const configPath2 = valueAfter(args, "--config");
   const { mobile, projectRoot } = await loadMobile(configPath2);
@@ -22762,10 +22972,15 @@ Mobile release security and compliance checks failed.`);
   if (process.platform !== "darwin" && !remoteProfile)
     throw new TypeError("iOS release builds require macOS or a paired Remote Mac. Run `absolute mobile pair mac <name> <user@host>`.");
   let success = false;
+  const cancellation = remoteProfile ? new AbortController : undefined;
+  let stopListeningForCancellation = () => {
+    return;
+  };
   try {
     if (!remoteProfile && mobile.engine === "capacitor")
       await repairAbsoluteIosDevSession(projectRoot);
     await start(mobileBuildServerEntry(args), valueAfter(args, "--web-outdir"), configPath2, { prepareOnly: true });
+    stopListeningForCancellation = listenForRemoteReleaseCancellation(cancellation);
     const release = remoteProfile ? await buildAbsoluteRemoteIosRelease({
       allowUnsigned: args.includes("--unsigned"),
       developmentTeam: process.env.ABSOLUTE_IOS_DEVELOPMENT_TEAM,
@@ -22782,7 +22997,8 @@ Mobile release security and compliance checks failed.`);
         });
       },
       ...prepareBuildNumber === undefined ? {} : { prepareBuildNumber },
-      project: createAbsoluteRemoteIosDevProject(mobile, projectRoot, remoteProfile)
+      project: createAbsoluteRemoteIosDevProject(mobile, projectRoot, remoteProfile),
+      signal: cancellation?.signal
     }) : await buildLocalIosRelease({
       args,
       mobile,
@@ -22796,6 +23012,7 @@ Mobile release security and compliance checks failed.`);
     console.log(`Metadata: ${join56(release.releaseRoot, "release.json")}`);
     return release;
   } finally {
+    stopListeningForCancellation();
     sendTelemetryEvent("mobile:ios-release-build", {
       durationMs: Math.round(performance.now() - startedAt),
       engine: mobile.engine,
@@ -23722,7 +23939,7 @@ Emulator setup verification:`);
     await publishIos(args.slice(2));
     return;
   }
-  throw new TypeError("Usage: absolute mobile <pair mac <name> <user@host> [--port n] [--workspace path] | remotes [--json] | unpair mac <name> | init [--no-native] [--force] | sync [ios|android] | inspect [--json] [--require-bundle] | associations [--outdir dir] [--verify] | ci github [server-entry] [--publish] [--registry module] [--secret-env NAME] [--output path] [--force] [--json] | doctor [ios|android|release [ios|android]] [--remote name] [--json|--fix [--yes]] | build <android|ios> [server-entry] [--remote name] [--outdir dir] [--web-outdir dir] [--unsigned] | publish android [server-entry] [--registry module] [--channel name] [--play-track track] [--play-status completed|draft|halted|in-progress] [--play-rollout fraction] [--play-name name] [--play-notes language=text] [--play-update-priority 0..5] [--play-hold-review] [--play-cancel-existing-review] [--outdir dir] [--web-outdir dir] [--unsigned] | publish ios [server-entry] [--remote name] [--registry module] [--channel name] [--testflight-group name-or-id] [--testflight-notes locale=text] [--testflight-submit-review] [--outdir dir] [--web-outdir dir] [--unsigned] | test android [--route path] [--wait-for-hmr] [--report [dir]] [--timeout ms] [--port n] [--serial id] [--artifacts dir] [--json] | test ios [--device identifier [--remote name] | --udid id] [--wait-for-hmr] [--report [dir]] [--timeout ms] [--port n] [--artifacts dir] [--json]> [--config path]");
+  throw new TypeError("Usage: absolute mobile <pair mac <name> <user@host> [--port n] [--workspace path] | remotes [inspect [name] [--json] | clean [name] --yes | --json] | unpair mac <name> | init [--no-native] [--force] | sync [ios|android] | inspect [--json] [--require-bundle] | associations [--outdir dir] [--verify] | ci github [server-entry] [--publish] [--registry module] [--secret-env NAME] [--output path] [--force] [--json] | doctor [ios|android|release [ios|android]] [--remote name] [--json|--fix [--yes]] | build <android|ios> [server-entry] [--remote name] [--outdir dir] [--web-outdir dir] [--unsigned] | publish android [server-entry] [--registry module] [--channel name] [--play-track track] [--play-status completed|draft|halted|in-progress] [--play-rollout fraction] [--play-name name] [--play-notes language=text] [--play-update-priority 0..5] [--play-hold-review] [--play-cancel-existing-review] [--outdir dir] [--web-outdir dir] [--unsigned] | publish ios [server-entry] [--remote name] [--registry module] [--channel name] [--testflight-group name-or-id] [--testflight-notes locale=text] [--testflight-submit-review] [--outdir dir] [--web-outdir dir] [--unsigned] | test android [--route path] [--wait-for-hmr] [--report [dir]] [--timeout ms] [--port n] [--serial id] [--artifacts dir] [--json] | test ios [--device identifier [--remote name] | --udid id] [--wait-for-hmr] [--report [dir]] [--timeout ms] [--port n] [--artifacts dir] [--json]> [--config path]");
 };
 var init_mobile = __esm(() => {
   init_dependencies();