stim 1.6.0 → 1.7.0

package/dist/{ios-Ccm6c8Hj.mjs → ios-BRXYSxSc.mjs}

@@ -1,31 +1,31 @@
-import { t as getExecutor } from "./exec-CyylIdq9.mjs";
-import { E as ownership_claim_exports, P as deviceSlotKey, S as upsertProject, f as getProject, l as getConcurrencyLimits, z as validateDeviceSlot } from "./config-DMP7L7H6.mjs";
+import { t as getExecutor } from "./exec-B29XNuhP.mjs";
+import { B as validateDeviceSlot, E as ownership_claim_exports, F as deviceSlotKey, P as deviceSlotFileKey, S as upsertProject, f as getProject, l as getConcurrencyLimits } from "./config-B7iyKWkL.mjs";
 import { r as createNdjsonWriter } from "./ndjson-BZwI1NBv.mjs";
-import { _ as workspaceLogsDir, h as workspaceDir, o as writeWorkspaceState, r as readWorkspaceState } from "./workspace-state-WVwWw_hB.mjs";
-import { T as removeTemporaryEntry, g as repoRoot, s as gitCommonDir, w as makeTemporaryDirectory } from "./worktree-DJnBbQZ9.mjs";
-import { a as findProjectRoot, c as projectShortcut, i as detectIsExpo, r as detectBundleId, t as appProjectProblem } from "./project-B_SDt4ip.mjs";
-import { n as MODE_EXPO, p as writeWorkspaceLaunch, t as MODE_BARE } from "./state-CnWzvCWP.mjs";
-import { i as resolveProjectMetro, r as pidExists } from "./metro-ato6ef3J.mjs";
-import { n as verifyCollectorOwnership } from "./ownership-CD_XnpDu.mjs";
-import { _ as launchErrorPreview, c as launchErrorReport, g as stepTimer, h as stepClock, i as formatDuration, l as phaseLine, m as shortUdid, n as appReadinessMessage, p as shortHash } from "./command-output-BuIb_ZOI.mjs";
-import { $ as providerDownloadPath, G as buildCacheKey, J as filesystemBuildCapability, K as describeFingerprintMiss, Q as prepareProviderDownloadDir, R as WAIT_CEILING_MS, U as takeoverLine, V as releaseBuildLock, W as waitForBuild, X as fingerprintDiffSuffix, Y as fingerprintDiffRecord, Z as fingerprintProject, at as untrackedMissLine, et as providerUploadOutcome, nt as resolveBuild, ot as untrackedNativeFiles, rt as storeBuild, tt as refingerprintAfterMutation, z as acquireBuildLock } from "./android-BkYmndPp.mjs";
-import { A as resolveSettings, B as artifactCachePolicy, D as remoteDeviceSettingError, F as tunnelModeSetting, H as optimizationBuildProfile, I as unknownSettingKeys, N as settingShapeErrors, O as remoteIosSetting, R as detectProviders, T as publicUrlSetting, U as resolveOptimizations, _ as iosSigningIdentitySha1SettingError, a as SETTING_SHAPE_REMEDY, d as cacheProviderSettingError, f as iosLanHostSetting, g as iosSigningIdentitySha1Setting, h as iosSigningIdentitySettingError, k as resolveCacheProviderConfig, m as iosSigningIdentitySetting, p as iosLanHostSettingError, r as REMOTE_DEVICE_BACKENDS, x as metroWarmupUrlSetting } from "./settings-CGHTt5vb.mjs";
-import { C as resolveRemote, S as resolveEasCliBin, _ as exitAfterFlush, a as POOL_SETTING_REMEDY, f as RESOLVE_TIMEOUT_MS, g as easAuthNote, h as checkEasAuth, l as parkedMaxSetting, m as cacheLevel, p as UPLOAD_TIMEOUT_MS, v as isEasAuthFailureText, w as uploadRemote, y as loadProjectProvider } from "./teardown-sm1FwF6V.mjs";
-import { _ as easDeviceBuildRemedy, a as swapJsBundle, c as ensureWorkspaceStorageSafely, d as launchOutcomeRecord, f as noMetroMessage, g as warmMetro, h as sleep, l as gateShouldRetry, m as resolveMetroWithRetry, n as pickDevClientScheme, o as needsPrebuild, p as noMetroRemedy, r as schemesFromInfoPlist, s as runPrebuild, t as devClientScheme, u as isPhysicalDeviceRequest, v as isEasBuildFailure, y as resolveEasDevelopmentBuild } from "./dev-client-BaTXAAnC.mjs";
-import { t as withWorkspaceProcessLock } from "./workspace-process-lock-Bz19_R9R.mjs";
-import { C as launchIosApp, E as unverifiedLaunchLines, O as verifyLaunch, T as readMetroRecords, b as isBundleProof, c as RELEASE_VERIFY_WAIT_MS, f as clearOtherUserApps, i as LAUNCH_BUNDLING, k as verifyReleaseLaunch, m as devClientUrl, n as DEFAULT_METRO_PORT, o as LAUNCH_FATAL, s as LAUNCH_UNVERIFIED, v as installIosApp, w as readCollectorRecords, y as iosAppProcess } from "./app-install--PAocWvq.mjs";
-import { f as listIosRuntimes } from "./ios-Deh5js5V.mjs";
-import { a as lostLine, c as releaseLeaseOnSignal, i as leaseExpiryText, l as runLease, n as DEBUG_VERIFY_STEP_MS, o as lostRefusal, r as acquireRunLease, s as parseDeviceWait, t as selectFromPool, u as waitFlagConflict } from "./device-pool-C0s_83Og.mjs";
-import { r as releaseBuildSlot, t as acquireBuildSlot } from "./build-slots-CuPszJDu.mjs";
-import { a as statsProjectKey, i as recordRunStats, n as readRunEstimates, t as createRunRecorder } from "./stats-Fo9ACIv7.mjs";
-import { c as unknownIosRuntimeRefusal, i as ensureOwnedDevice, n as clearIosAdoptionPending, r as ensureBooted, s as unknownIosDeviceTypeRefusal, t as checkDeviceCapacity } from "./device-XY_5eGdN.mjs";
-import { a as ensureMetroReachable, b as ownedSessionName, c as remoteIosDeps, l as resolveRemoteContext, n as binOnPath, o as ensureRemoteBootOwned, r as bundleEntryPoint, w as gateMetroOrigin } from "./device-remote-D9wN3CdE.mjs";
-import { a as compilationCacheActivityLine, c as readBundleExecutable, l as readBundleId, p as describeDiagnostic, r as buildIos, s as discoverXcodeProject, t as COMPILATION_CACHE_NOT_RUN, u as resolveScheme } from "./xcode-DUF7jrXj.mjs";
-import { n as nativeRunCommand, t as launchSlotScope } from "./slot-launch-BYjnljAs.mjs";
+import { _ as workspaceLogsDir, h as workspaceDir, o as writeWorkspaceState, r as readWorkspaceState } from "./workspace-state-BT5E3SA2.mjs";
+import { T as removeTemporaryEntry, g as repoRoot, s as gitCommonDir, w as makeTemporaryDirectory } from "./worktree-FG_ZKKdb.mjs";
+import { a as findProjectRoot, c as projectShortcut, i as detectIsExpo, r as detectBundleId, t as appProjectProblem } from "./project-DDZWf_16.mjs";
+import { n as MODE_EXPO, p as writeWorkspaceLaunch, t as MODE_BARE } from "./state-DZobzxLW.mjs";
+import { a as resolveProjectMetro, i as pidExists, o as signalProcessTree } from "./metro-C7bcJ0uo.mjs";
+import { n as verifyCollectorOwnership } from "./ownership-Cp52QAK1.mjs";
+import { A as resolveSettings, B as artifactCachePolicy, D as remoteDeviceSettingError, F as tunnelModeSetting, H as optimizationBuildProfile, I as unknownSettingKeys, N as settingShapeErrors, O as remoteIosSetting, R as detectProviders, T as publicUrlSetting, U as resolveOptimizations, _ as iosSigningIdentitySha1SettingError, a as SETTING_SHAPE_REMEDY, d as cacheProviderSettingError, f as iosLanHostSetting, g as iosSigningIdentitySha1Setting, h as iosSigningIdentitySettingError, k as resolveCacheProviderConfig, m as iosSigningIdentitySetting, p as iosLanHostSettingError, r as REMOTE_DEVICE_BACKENDS, x as metroWarmupUrlSetting } from "./settings-BXXorVM2.mjs";
+import { _ as launchErrorPreview, c as launchErrorReport, g as stepTimer, h as stepClock, i as formatDuration, l as phaseLine, m as shortUdid, n as appReadinessMessage, p as shortHash } from "./command-output-B3ycpsYv.mjs";
+import { C as untrackedNativeFiles, S as untrackedMissLine, _ as providerUploadOutcome, b as storeBuild, c as buildCacheKey, d as filesystemBuildCapability, f as fingerprintDiffRecord, g as providerDownloadPath, h as prepareProviderDownloadDir, i as releaseBuildLock, l as describeFingerprintMiss, m as fingerprintProject, n as acquireBuildLock, o as takeoverLine, p as fingerprintDiffSuffix, s as waitForBuild, t as WAIT_CEILING_MS, v as refingerprintAfterMutation, y as resolveBuild } from "./build-lock-CgtsB6TV.mjs";
+import { C as resolveRemote, S as resolveEasCliBin, _ as exitAfterFlush, a as POOL_SETTING_REMEDY, f as RESOLVE_TIMEOUT_MS, g as easAuthNote, h as checkEasAuth, l as parkedMaxSetting, m as cacheLevel, p as UPLOAD_TIMEOUT_MS, v as isEasAuthFailureText, w as uploadRemote, y as loadProjectProvider } from "./teardown-5J5UXz2P.mjs";
+import { _ as easDeviceBuildRemedy, a as swapJsBundle, c as ensureWorkspaceStorageSafely, d as launchOutcomeRecord, f as noMetroMessage, g as warmMetro, h as sleep, l as gateShouldRetry, m as resolveMetroWithRetry, n as pickDevClientScheme, o as needsPrebuild, p as noMetroRemedy, r as schemesFromInfoPlist, s as runPrebuild, t as devClientScheme, u as isPhysicalDeviceRequest, v as isEasBuildFailure, y as resolveEasDevelopmentBuild } from "./dev-client-DDUkWgJL.mjs";
+import { t as withWorkspaceProcessLock } from "./workspace-process-lock-BYfZz_S-.mjs";
+import { C as launchIosApp, E as unverifiedLaunchLines, O as verifyLaunch, T as readMetroRecords, b as isBundleProof, c as RELEASE_VERIFY_WAIT_MS, f as clearOtherUserApps, i as LAUNCH_BUNDLING, k as verifyReleaseLaunch, m as devClientUrl, n as DEFAULT_METRO_PORT, o as LAUNCH_FATAL, s as LAUNCH_UNVERIFIED, v as installIosApp, w as readCollectorRecords, y as iosAppProcess } from "./app-install-DJg7bVv-.mjs";
+import { f as listIosRuntimes } from "./ios-lEJ5pKsq.mjs";
+import { a as lostLine, c as releaseLeaseOnSignal, i as leaseExpiryText, l as runLease, n as DEBUG_VERIFY_STEP_MS, o as lostRefusal, r as acquireRunLease, s as parseDeviceWait, t as selectFromPool, u as waitFlagConflict } from "./device-pool-DNSHL5z8.mjs";
+import { r as releaseBuildSlot, t as acquireBuildSlot } from "./build-slots-C-oAHRT1.mjs";
+import { a as statsProjectKey, i as recordRunStats, n as readRunEstimates, t as createRunRecorder } from "./stats-BYcZ6n1h.mjs";
+import { c as unknownIosRuntimeRefusal, i as ensureOwnedDevice, n as clearIosAdoptionPending, r as ensureBooted, s as unknownIosDeviceTypeRefusal, t as checkDeviceCapacity } from "./device-CLeDp-KH.mjs";
+import { a as ensureMetroReachable, b as ownedSessionName, c as remoteIosDeps, l as resolveRemoteContext, n as binOnPath, o as ensureRemoteBootOwned, r as bundleEntryPoint, w as gateMetroOrigin } from "./device-remote-BprxZp-m.mjs";
+import { a as compilationCacheActivityLine, c as readBundleExecutable, l as readBundleId, p as describeDiagnostic, r as buildIos, s as discoverXcodeProject, t as COMPILATION_CACHE_NOT_RUN, u as resolveScheme } from "./xcode-B6YaWeg0.mjs";
+import { n as nativeRunCommand, t as launchSlotScope } from "./slot-launch-DbLvyrup.mjs";
 import { t as spawnEntry } from "./spawn-entry-nCE6m770.mjs";
-import { a as printNativeCrashReport, n as IOS_CRASH_REPORT_RETRY, o as simulatorConsolePaths, r as captureNativeCrashes, t as errorDiagnostics } from "./error-diagnostics-B5STzxqN.mjs";
-import { a as iosDeviceProcess, c as listIosDevices, d as verifyIosDeviceReleaseLaunch, i as installIosDeviceApp, l as localNetworkPending, n as LAUNCH_PROBE_TIMEOUT_MS, o as iosPoolCandidates, r as awaitIosDeviceLaunch, s as iosPoolNoCandidatesRefusal, t as DEVICECTL_INSTALL_TIMEOUT_MS, u as resolveIosPhysicalDevice } from "./ios-device-DJOi9FR5.mjs";
-import { a as runPodInstall, n as podsAreStale, r as readPodState } from "./deps-C1zGnr61.mjs";
+import { a as printNativeCrashReport, n as IOS_CRASH_REPORT_RETRY, o as simulatorConsolePaths, r as captureNativeCrashes, t as errorDiagnostics } from "./error-diagnostics-D1Kaf-eT.mjs";
+import { a as iosDeviceProcess, c as listIosDevices, d as verifyIosDeviceReleaseLaunch, i as installIosDeviceApp, l as localNetworkPending, n as LAUNCH_PROBE_TIMEOUT_MS, o as iosPoolCandidates, r as awaitIosDeviceLaunch, s as iosPoolNoCandidatesRefusal, t as DEVICECTL_INSTALL_TIMEOUT_MS, u as resolveIosPhysicalDevice } from "./ios-device-CDbvn5H2.mjs";
+import { a as runPodInstall, n as podsAreStale, r as readPodState } from "./deps-oCXVNEqQ.mjs";
 import { existsSync, mkdirSync, mkdtempSync, openSync, rmSync, writeFileSync } from "node:fs";
 import { InvalidArgumentError } from "commander";
 import { X509Certificate } from "node:crypto";
@@ -1503,14 +1503,14 @@ function hostLanCandidates(interfaces = networkInterfaces) {
 //#endregion
 //#region src/commands/ios/collector.ts
 function collectorLogFile(root, slot) {
-	return join(workspaceLogsDir(root), `collector-${deviceSlotKey("ios", slot)}.log`);
+	return join(workspaceLogsDir(root), `collector-${deviceSlotFileKey("ios", slot)}.log`);
 }
 function collectorEntry() {
 	return spawnEntry("collector-run");
 }
 const COLLECTOR_EXIT_WAIT_MS = 2e3;
 const COLLECTOR_POLL_MS = 25;
-async function stopPreviousCollector({ root, slot = "default", kill = (pid, signal) => process.kill(pid, signal), alive = pidExists, readState = readWorkspaceState, verify = verifyCollectorOwnership, waitMs = COLLECTOR_EXIT_WAIT_MS, note = (_line) => {} }) {
+async function stopPreviousCollector({ root, slot = "default", kill = (pid, signal) => signalProcessTree(pid, signal), alive = pidExists, readState = readWorkspaceState, verify = verifyCollectorOwnership, waitMs = COLLECTOR_EXIT_WAIT_MS, note = (_line) => {} }) {
 	const previous = (readState(root)?.collectors)?.[deviceSlotKey("ios", slot)] || null;
 	const previousPid = Number(previous?.pid) || null;
 	let killed = null;
@@ -2138,14 +2138,11 @@ async function finishIosRun({ artifact, d, root, slot, json, release, configurat
 		event: "launch",
 		msg: release ? `launched ${bundleId} on ${udid} (${configuration}, embedded JS bundle, no Metro)` : `launched ${bundleId} on ${udid} against Metro ${lanOriginUrl ?? `port ${metroPort}`}` + (launched?.mode === "openurl" || launched?.mode === "payload-url" ? " (expo-dev-client)" : "")
 	});
-	if (remoteDevice) await d.replaceCollector({
-		root,
-		slot,
-		udid,
-		bundleId,
-		appName,
-		appExecutable,
-		note
+	if (remoteDevice) logWriter().write({
+		src: "build",
+		level: "info",
+		event: "collector_skipped",
+		msg: `remote session ${udid}: device logs come from agent-device/EAS, so no simctl log stream is attached`
 	});
 	if (physical) raiseLeaseFor(release ? RELEASE_VERIFY_WAIT_MS : DEBUG_VERIFY_STEP_MS, false);
 	const { state: launchState, warning: launchWarning } = await verifyIosRun({
@@ -2272,7 +2269,7 @@ function explicitSchemeRefusal(root, scheme, isExpo, d) {
 	return d.resolveScheme(project, { scheme }).error ?? null;
 }
 function iosSlotLogFile(root, slot) {
-	return slot === "default" ? buildLogFile(root) : join(workspaceLogsDir(root), `build-${deviceSlotKey("ios", slot)}.ndjson`);
+	return slot === "default" ? buildLogFile(root) : join(workspaceLogsDir(root), `build-${deviceSlotFileKey("ios", slot)}.ndjson`);
 }
 function iosSlotDeps(d, slot) {
 	if (slot !== "default") {

package/dist/{ios-device-DJOi9FR5.mjs → ios-device-CDbvn5H2.mjs}

@@ -1,5 +1,5 @@
-import { t as getExecutor } from "./exec-CyylIdq9.mjs";
-import { r as INSTALL_ERROR } from "./app-install--PAocWvq.mjs";
+import { t as getExecutor } from "./exec-B29XNuhP.mjs";
+import { r as INSTALL_ERROR } from "./app-install-DJg7bVv-.mjs";
 import { mkdtempSync, readFileSync, rmSync } from "node:fs";
 import { join } from "node:path";
 import { tmpdir } from "node:os";

package/dist/{ios-device-D3pzTKQE.mjs → ios-device-CFXA46ez.mjs}

@@ -1,4 +1,4 @@
-import { t as getExecutor } from "./exec-CyylIdq9.mjs";
+import { t as getExecutor } from "./exec-B29XNuhP.mjs";
 //#region src/collector/ios-device.ts
 const CONSOLE_ENV = { OS_ACTIVITY_DT_MODE: "enable" };
 const DEV_MENU_LAUNCH_ARGS = [

package/dist/{ios-Deh5js5V.mjs → ios-lEJ5pKsq.mjs}

@@ -1,5 +1,5 @@
-import { t as getExecutor } from "./exec-CyylIdq9.mjs";
-import { n as stripAnsi, r as waitForChild, t as createLineReader } from "./process-output-C7IlIzd7.mjs";
+import { t as getExecutor } from "./exec-B29XNuhP.mjs";
+import { n as stripAnsi, r as waitForChild, t as createLineReader } from "./process-output-Dl5uKE03.mjs";
 import { mkdtempSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { tmpdir } from "node:os";
@@ -22,7 +22,7 @@ function hostMemoryPressureAdvice(pressure) {
 	return `macOS reports ${pressure} host memory pressure. Simulator processes can stall even when the device is Booted. Free memory before retrying: use \`stim stop\` only in workspaces you own, and ask before closing other apps or devices. For parallel iOS work, consider a reviewed SimSlim profile (\`stim guide lifecycle simslim\`). This observation does not establish an OOM crash.`;
 }
 //#endregion
-//#region src/sim/ios.ts
+//#region src/devices/ios.ts
 function parseSimctlList(jsonOutput, { includeUnavailable = false } = {}) {
 	const parsed = JSON.parse(jsonOutput);
 	if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) throw new Error("Expected simctl list to return a JSON object with a devices object.");

package/dist/{logs-D4Poojxy.mjs → logs-CakdBTtm.mjs}

@@ -1,10 +1,10 @@
-import { g as loadConfig, h as isPathPrefix, z as validateDeviceSlot } from "./config-DMP7L7H6.mjs";
+import { B as validateDeviceSlot, g as loadConfig, h as isPathPrefix } from "./config-B7iyKWkL.mjs";
 import { n as SOURCES, t as LEVELS } from "./ndjson-BZwI1NBv.mjs";
-import { _ as workspaceLogsDir, r as readWorkspaceState } from "./workspace-state-WVwWw_hB.mjs";
-import { a as findProjectRoot } from "./project-B_SDt4ip.mjs";
-import { _ as launchErrorPreview } from "./command-output-BuIb_ZOI.mjs";
-import { i as captureWorkspaceCrashes, t as errorDiagnostics } from "./error-diagnostics-B5STzxqN.mjs";
-import { a as followLogs, c as queryLogs, i as fileSizes, n as buildCriteria, o as logFiles, r as compileGrep, s as parseSince } from "./logs-query-Cdp5aaCH.mjs";
+import { _ as workspaceLogsDir, r as readWorkspaceState } from "./workspace-state-BT5E3SA2.mjs";
+import { a as findProjectRoot } from "./project-DDZWf_16.mjs";
+import { _ as launchErrorPreview } from "./command-output-B3ycpsYv.mjs";
+import { i as captureWorkspaceCrashes, t as errorDiagnostics } from "./error-diagnostics-D1Kaf-eT.mjs";
+import { a as followLogs, c as queryLogs, i as fileSizes, n as buildCriteria, o as logFiles, r as compileGrep, s as parseSince } from "./logs-query-BGL-Pl12.mjs";
 import { realpathSync } from "node:fs";
 import { relative, sep } from "node:path";
 import chalk from "chalk";

package/dist/{logs-query-Cdp5aaCH.mjs → logs-query-BGL-Pl12.mjs}

@@ -2,7 +2,7 @@ import { a as parseNdjsonLine, i as levelRank, o as parseNdjsonText } from "./nd
 import { closeSync, openSync, readFileSync, readSync, readdirSync, statSync } from "fs";
 import { join } from "path";
 import { StringDecoder } from "string_decoder";
-//#region src/logs-query.ts
+//#region src/diagnostics/logs-query.ts
 const SINCE_UNITS = {
 	s: 1e3,
 	m: 6e4,

package/dist/metro-C7bcJ0uo.mjs

@@ -0,0 +1,233 @@
+import { t as getExecutor } from "./exec-B29XNuhP.mjs";
+import { A as isOnMountedVolume, g as loadConfig, j as listMountedVolumes, n as allMetroPorts, r as claimMetroPort, v as removeProject, w as process_identity_exports } from "./config-B7iyKWkL.mjs";
+import { r as readWorkspaceState } from "./workspace-state-BT5E3SA2.mjs";
+import { existsSync, readlinkSync, realpathSync } from "fs";
+import { sep } from "path";
+import { request } from "http";
+import { connect } from "net";
+//#region src/ports.ts
+function isMetroRunning(port) {
+	return new Promise((resolve) => {
+		const req = request({
+			hostname: "localhost",
+			port,
+			path: "/status",
+			timeout: 2e3
+		}, (res) => {
+			let data = "";
+			res.on("data", (chunk) => {
+				data += chunk;
+			});
+			res.on("end", () => resolve(data.includes("packager-status:running")));
+		});
+		req.on("error", () => resolve(false));
+		req.on("timeout", () => {
+			req.destroy();
+			resolve(false);
+		});
+		req.end();
+	});
+}
+function isPortFree(port, { timeoutMs = 400 } = {}) {
+	return new Promise((resolve) => {
+		const sock = connect({
+			port,
+			host: "127.0.0.1"
+		});
+		const done = (free) => {
+			sock.removeAllListeners();
+			sock.destroy();
+			resolve(free);
+		};
+		sock.setTimeout(timeoutMs);
+		sock.once("connect", () => done(false));
+		sock.once("error", () => done(true));
+		sock.once("timeout", () => done(false));
+	});
+}
+const FIRST_PORT = 8082;
+async function computeNextPort(isFree = isPortFree) {
+	const taken = new Set(allMetroPorts());
+	for (let port = FIRST_PORT; port < 8282; port++) {
+		if (taken.has(port)) continue;
+		if (await isFree(port)) return port;
+	}
+	throw new Error(`Found no free Metro port between ${FIRST_PORT} and 8281. Free one up, or stop a stale bundler (\`stim status\`, \`stim stop <port>\`).`);
+}
+async function findReclaimablePort(excludeProjectPath, probe = isMetroRunning, { isMounted = isOnMountedVolume, mountedVolumes } = {}) {
+	const cfg = loadConfig();
+	if (!cfg?.projects) return null;
+	const mounted = mountedVolumes || listMountedVolumes();
+	const candidates = [];
+	for (const [path, proj] of Object.entries(cfg.projects)) {
+		if (path === excludeProjectPath) continue;
+		if (Object.keys(proj.ports ?? {}).length) continue;
+		if (existsSync(path)) continue;
+		if (!isMounted(path, mounted)) continue;
+		if (typeof proj.metroPort === "number") candidates.push({
+			port: proj.metroPort,
+			ownerPath: path
+		});
+	}
+	for (const c of candidates) if (!await probe(c.port)) return c;
+	return null;
+}
+async function allocatePort(projectPath, probe = isMetroRunning, isFree = isPortFree) {
+	const reclaim = await findReclaimablePort(projectPath, probe);
+	if (reclaim && await isFree(reclaim.port)) {
+		removeProject(reclaim.ownerPath);
+		return reclaim.port;
+	}
+	return computeNextPort(isFree);
+}
+const RESERVE_ATTEMPTS = 5;
+async function reserveMetroPort(projectPath, probe = isMetroRunning, isFree = isPortFree) {
+	for (let attempt = 0; attempt < RESERVE_ATTEMPTS; attempt++) {
+		const port = await allocatePort(projectPath, probe, isFree);
+		const claimed = claimMetroPort(projectPath, port);
+		if (claimed !== null) return claimed;
+	}
+	throw new Error(`Could not reserve a Metro port after ${RESERVE_ATTEMPTS} attempts: another Stim run claimed each one first. Retry.`);
+}
+//#endregion
+//#region src/metro.ts
+/**
+* True when some process with this pid exists right now. It cannot tell a recycled pid from the
+* process that first held it, so it is only valid for a pid this run spawned and still holds a
+* handle on. For a pid read from a record on disk, decide with `inspectProcessIdentity` on that
+* record's process token, or take an ownership claim (`ownership-claim.ts`): this answer would keep
+* a dead holder's record looking live until some unrelated process exits.
+*/
+function pidExists(pid) {
+	if (!Number.isSafeInteger(pid) || pid <= 0) return false;
+	try {
+		process.kill(pid, 0);
+		return true;
+	} catch (error) {
+		return error.code !== "ESRCH";
+	}
+}
+function parseLsofPids(out) {
+	if (!out) return [];
+	return String(out).split("\n").map((s) => parseInt(s.trim(), 10)).filter((n) => Number.isFinite(n));
+}
+function addressPort(address) {
+	const colon = String(address ?? "").lastIndexOf(":");
+	return colon < 0 ? NaN : Number(String(address).slice(colon + 1));
+}
+function parseNetstatPids(out, port) {
+	const pids = [];
+	for (const line of String(out ?? "").split("\n")) {
+		const cols = line.trim().split(/\s+/);
+		if (cols.length < 5 || cols[0]?.toUpperCase() !== "TCP") continue;
+		if (addressPort(cols[1]) !== port || addressPort(cols[2]) !== 0) continue;
+		const pid = Number(cols.at(-1));
+		if (Number.isSafeInteger(pid) && pid > 0 && !pids.includes(pid)) pids.push(pid);
+	}
+	return pids;
+}
+function listeningPids(port, platform = process.platform) {
+	const pids = parseLsofPids(getExecutor().runQuiet(`lsof -nP -iTCP:${port} -sTCP:LISTEN -t`));
+	if (pids.length > 0 || platform !== "win32") return pids;
+	return parseNetstatPids(getExecutor().runQuiet("netstat -ano"), port);
+}
+function parseLsofCwd(out) {
+	if (!out) return null;
+	const lines = String(out).split("\n");
+	const idx = lines.findIndex((l) => l === "fcwd");
+	if (idx === -1) return null;
+	const nLine = lines.slice(idx + 1).find((l) => l.startsWith("n"));
+	return nLine ? nLine.slice(1) : null;
+}
+function processCwd(pid) {
+	if (process.platform === "linux") try {
+		return readlinkSync(`/proc/${pid}/cwd`);
+	} catch {}
+	return parseLsofCwd(getExecutor().runQuiet(`lsof -a -p ${pid} -d cwd -Fn`));
+}
+function canonicalPath(path) {
+	try {
+		return realpathSync(path);
+	} catch {
+		return path;
+	}
+}
+function isInsideProject(cwd, projectPath) {
+	if (!cwd || !projectPath) return false;
+	const a = canonicalPath(cwd);
+	const b = canonicalPath(projectPath);
+	return a === b || a.startsWith(b.endsWith(sep) ? b : b + sep);
+}
+const NOT_OURS_UNRESPONSIVE = "unresponsive";
+const NOT_OURS_UNREADABLE_CWD = "unreadable-cwd";
+const NOT_OURS_FOREIGN_CWD = "foreign-cwd";
+function ownedSupervisor(projectPath, port) {
+	const supervisor = readWorkspaceState(canonicalPath(projectPath))?.supervisor;
+	if (supervisor?.port !== port || (0, process_identity_exports.inspectProcessIdentity)(supervisor) !== "same") return null;
+	return supervisor;
+}
+async function resolveProjectMetro(port, projectPath, { probe = isMetroRunning, cwdOf = processCwd } = {}) {
+	const pid = listeningPids(port)[0];
+	if (pid === void 0) return { missing: true };
+	if (!await probe(port)) return {
+		notOurs: `pid ${pid} on port ${port} does not answer Metro's /status`,
+		kind: NOT_OURS_UNRESPONSIVE,
+		pid
+	};
+	const cwd = cwdOf(pid);
+	if (!cwd) {
+		const owner = ownedSupervisor(projectPath, port);
+		if (owner && (pid === owner.pid || pid === owner.serverPid)) return { metro: {
+			pid,
+			leader: owner.pid,
+			cwd: canonicalPath(projectPath),
+			processToken: owner.processToken
+		} };
+		return {
+			notOurs: `pid ${pid} on port ${port}: working directory could not be read`,
+			kind: NOT_OURS_UNREADABLE_CWD,
+			pid
+		};
+	}
+	if (!isInsideProject(cwd, projectPath)) return {
+		notOurs: `pid ${pid} on port ${port} runs from ${cwd}, outside ${projectPath}`,
+		kind: NOT_OURS_FOREIGN_CWD,
+		pid
+	};
+	const owner = ownedSupervisor(projectPath, port);
+	return { metro: {
+		pid,
+		leader: owner ? owner.pid : pid,
+		cwd,
+		...owner ? { processToken: owner.processToken } : {}
+	} };
+}
+/**
+* Terminate a process and everything it spawned. On POSIX `group` signals the process group, which
+* is what a detached leader owns. Windows has no process groups, and its SIGTERM is
+* TerminateProcess: no handler runs and no child is reached, so a spawned dev server or `adb
+* logcat` would outlive its parent. taskkill /T is the only route to the tree there, and it is
+* always forceful.
+*/
+function signalProcessTree(pid, signal = "SIGTERM", { group = false, platform = process.platform } = {}) {
+	if (platform !== "win32") return process.kill(group ? -pid : pid, signal);
+	return getExecutor().runFileQuiet("taskkill", [
+		"/PID",
+		String(pid),
+		"/T",
+		"/F"
+	]) !== null;
+}
+function killMetroTree(leader, processToken) {
+	if (!leader || leader === process.pid || (0, process_identity_exports.inspectProcessIdentity)({
+		pid: leader,
+		processToken
+	}) !== "same") return false;
+	try {
+		return signalProcessTree(leader, "SIGTERM", { group: true });
+	} catch {
+		return false;
+	}
+}
+//#endregion
+export { resolveProjectMetro as a, isPortFree as c, pidExists as i, reserveMetroPort as l, killMetroTree as n, signalProcessTree as o, listeningPids as r, isMetroRunning as s, NOT_OURS_FOREIGN_CWD as t };

package/dist/{named-ports-DH9SXd0f.mjs → named-ports-DzMOlmaX.mjs}

@@ -1,7 +1,7 @@
-import { t as getExecutor } from "./exec-CyylIdq9.mjs";
-import { C as withConfigLock, f as getProject, g as loadConfig, s as ensureConfig, u as getConfigDir, w as process_identity_exports, y as saveConfig } from "./config-DMP7L7H6.mjs";
-import { n as isPortFree } from "./ports-BZprTJRa.mjs";
-import { t as withWorkspaceProcessLock } from "./workspace-process-lock-Bz19_R9R.mjs";
+import { t as getExecutor } from "./exec-B29XNuhP.mjs";
+import { C as withConfigLock, f as getProject, g as loadConfig, s as ensureConfig, u as getConfigDir, w as process_identity_exports, y as saveConfig } from "./config-B7iyKWkL.mjs";
+import { c as isPortFree, o as signalProcessTree, r as listeningPids } from "./metro-C7bcJ0uo.mjs";
+import { t as withWorkspaceProcessLock } from "./workspace-process-lock-BYfZz_S-.mjs";
 import { realpathSync } from "node:fs";
 //#region src/named-ports.ts
 const FIRST_PORT = 8900;
@@ -10,7 +10,8 @@ function validatePortLabel(label) {
 	if (label === "metro") throw new Error("metro is managed by stim start and stim stop; choose another label.");
 	if (!/^[a-zA-Z][a-zA-Z0-9_-]{0,63}$/.test(label)) throw new Error("A port label must start with a letter and contain at most 64 letters, digits, underscores or hyphens.");
 }
-function portListeners(port) {
+function portListeners(port, platform) {
+	if (platform === "win32") return listeningPids(port, platform);
 	let out;
 	try {
 		out = getExecutor().runFile("lsof", [
@@ -28,10 +29,29 @@ function portListeners(port) {
 	if (pids.some((pid) => !Number.isSafeInteger(pid) || pid <= 0)) throw new Error(`lsof returned an invalid listener for TCP port ${port}.`);
 	return [...new Set(pids)];
 }
+function processCommand(pid, platform) {
+	const e = getExecutor();
+	if (platform === "win32") {
+		const csv = e.runFileQuiet("tasklist", [
+			"/FI",
+			`PID eq ${pid}`,
+			"/FO",
+			"CSV",
+			"/NH"
+		], { timeoutMs: 5e3 });
+		return /^"([^"]*)"/.exec((csv ?? "").trim())?.[1] ?? "";
+	}
+	return (e.runFileQuiet("ps", [
+		"-p",
+		String(pid),
+		"-o",
+		"args="
+	], { timeoutMs: 5e3 }) ?? "").trim();
+}
 function withPortsLock(fn) {
 	return withWorkspaceProcessLock(getConfigDir(), "ports", fn, { external: true });
 }
-async function getNamedPort(projectPath, label, { isFree = async (port) => await isPortFree(port) && portListeners(port).length === 0, log = console.error } = {}) {
+async function getNamedPort(projectPath, label, { isFree = async (port) => await isPortFree(port) && portListeners(port, process.platform).length === 0, log = console.error } = {}) {
 	validatePortLabel(label);
 	const root = realpathSync(projectPath);
 	return withPortsLock(async () => {
@@ -61,37 +81,33 @@ async function getNamedPort(projectPath, label, { isFree = async (port) => await
 		throw new Error(`No free named port between ${FIRST_PORT} and ${LAST_PORT}. Use stim ports stop or stim ports release in a workspace that no longer needs its ports.`);
 	});
 }
-async function stopListeners(port, label, dryRun, log) {
-	for (const pid of portListeners(port)) {
+async function stopListeners(port, label, dryRun, log, platform) {
+	const listeners = () => portListeners(port, platform);
+	for (const pid of listeners()) {
 		if (pid === process.pid) throw new Error(`Refusing to stop Stim itself on ${label} (${port}).`);
 		const identity = (0, process_identity_exports.captureProcessIdentity)(pid);
 		if (!identity.ok) {
-			if (!portListeners(port).includes(pid)) continue;
+			if (!listeners().includes(pid)) continue;
 			throw new Error(`Cannot identify pid ${pid} on ${label} (${port}): ${identity.reason}`);
 		}
 		const record = {
 			pid,
 			processToken: identity.token
 		};
-		const command = getExecutor().runFile("ps", [
-			"-p",
-			String(pid),
-			"-o",
-			"args="
-		], { timeoutMs: 5e3 }).trim();
+		const command = processCommand(pid, platform);
 		if (dryRun) {
 			log(`would stop ${label} (${port}): pid ${pid} ${command}`);
 			continue;
 		}
-		if (!portListeners(port).includes(pid)) continue;
+		if (!listeners().includes(pid)) continue;
 		const status = (0, process_identity_exports.inspectProcessIdentity)(record);
 		if (status === "gone" || status === "different") continue;
 		if (status !== "same") throw new Error(`Cannot verify pid ${pid} on ${label} (${port}); allocation kept.`);
 		try {
-			process.kill(pid, "SIGTERM");
+			signalProcessTree(pid, "SIGTERM", { platform });
 			if (!await (0, process_identity_exports.waitForProcessExit)(record, 2e3)) {
 				if ((0, process_identity_exports.inspectProcessIdentity)(record) !== "same") throw new Error(`Cannot verify pid ${pid} before SIGKILL.`);
-				process.kill(pid, "SIGKILL");
+				signalProcessTree(pid, "SIGKILL", { platform });
 				if (!await (0, process_identity_exports.waitForProcessExit)(record, 2e3)) throw new Error(`Pid ${pid} did not exit.`);
 			}
 		} catch (error) {
@@ -99,36 +115,35 @@ async function stopListeners(port, label, dryRun, log) {
 		}
 		log(`stopped ${label} (${port}): pid ${pid} ${command}`);
 	}
-	if (!dryRun && portListeners(port).length) throw new Error(`Port ${port} still has a listener; allocation kept.`);
+	if (!dryRun && listeners().length) throw new Error(`Port ${port} still has a listener; allocation kept.`);
 }
-async function clearNamedPorts(projectPath, { label, stop = false, dryRun = false, log = console.error } = {}) {
+async function clearNamedPorts(projectPath, { label, stop = false, dryRun = false, log = console.error, platform = process.platform } = {}) {
 	if (label !== void 0) validatePortLabel(label);
 	await withPortsLock(async () => {
 		const ports = getProject(projectPath)?.ports ?? {};
+		const selected = Object.entries(ports).filter(([name]) => label === void 0 || name === label);
+		if (stop && selected.length > 0 && platform !== "win32" && !getExecutor().findExecutable("lsof")) throw new Error("Cannot stop named ports: lsof is not installed.");
 		const failures = [];
-		for (const [name, port] of Object.entries(ports)) {
-			if (label !== void 0 && name !== label) continue;
-			try {
-				if (!Number.isInteger(port) || port < FIRST_PORT || port > LAST_PORT) throw new Error(`Invalid named port ${name} (${port}); repair its config record before cleanup.`);
-				if (stop) {
-					if (Object.values(loadConfig()?.projects ?? {}).some((project) => project.metroPort === port)) throw new Error(`Port ${port} is reserved for managed Metro; allocation kept.`);
-					await stopListeners(port, name, dryRun, log);
-				}
-				if (dryRun) {
-					log(`would release ${name} (${port})`);
-					continue;
-				}
-				withConfigLock(() => {
-					const cfg = loadConfig();
-					const current = cfg?.projects?.[projectPath]?.ports;
-					if (!cfg || current?.[name] !== port) return;
-					delete current[name];
-					saveConfig(cfg);
-				});
-				log(`released ${name} (${port})`);
-			} catch (error) {
-				failures.push(`${name} (${port}): ${error.message}`);
+		for (const [name, port] of selected) try {
+			if (!Number.isInteger(port) || port < FIRST_PORT || port > LAST_PORT) throw new Error(`Invalid named port ${name} (${port}); repair its config record before cleanup.`);
+			if (stop) {
+				if (Object.values(loadConfig()?.projects ?? {}).some((project) => project.metroPort === port)) throw new Error(`Port ${port} is reserved for managed Metro; allocation kept.`);
+				await stopListeners(port, name, dryRun, log, platform);
 			}
+			if (dryRun) {
+				log(`would release ${name} (${port})`);
+				continue;
+			}
+			withConfigLock(() => {
+				const cfg = loadConfig();
+				const current = cfg?.projects?.[projectPath]?.ports;
+				if (!cfg || current?.[name] !== port) return;
+				delete current[name];
+				saveConfig(cfg);
+			});
+			log(`released ${name} (${port})`);
+		} catch (error) {
+			failures.push(`${name} (${port}): ${error.message}`);
 		}
 		if (failures.length) throw new Error(failures.join("\n"));
 	});

package/dist/{ownership-CD_XnpDu.mjs → ownership-Cp52QAK1.mjs}

@@ -1,6 +1,6 @@
-import { w as process_identity_exports } from "./config-DMP7L7H6.mjs";
-import { a as withWorkspaceStateLock, o as writeWorkspaceState, r as readWorkspaceState } from "./workspace-state-WVwWw_hB.mjs";
-import { r as pidExists } from "./metro-ato6ef3J.mjs";
+import { w as process_identity_exports } from "./config-B7iyKWkL.mjs";
+import { a as withWorkspaceStateLock, o as writeWorkspaceState, r as readWorkspaceState } from "./workspace-state-BT5E3SA2.mjs";
+import { i as pidExists } from "./metro-C7bcJ0uo.mjs";
 import { realpathSync } from "node:fs";
 //#region src/collector/state.ts
 function collectorRoot(root) {