stim 1.3.1 → 1.5.0

package/README.md

@@ -50,9 +50,9 @@ registered descendant app with logs when one exists.
 
 Use `stim start --reset-cache` to recover from stale Metro transforms or file-map
 state. It restarts only this app's verified owned Metro, keeping its port and
-devices. A fresh persistent cache namespace bypasses old entries without deleting
-shared stores or changing other apps or native build caches. Expo requires SDK
-54+ and Stim's config adapter. See `stim guide lifecycle` for scope and limitations.
+devices, with Metro's own reset: every store in the app's Metro config is cleared,
+including this app's shared transform store, so other worktrees of the same app
+rebuild their transforms too. Other apps and native build caches are unchanged.
 
 Use `stim doctor --platform ios` or `stim doctor --platform android` when only
 one native platform is in scope; shared project checks still run. Doctor also
@@ -198,3 +198,16 @@ stim stop --slot tablet
 `--slot` preserves the shared server and other devices. `stim reload ios` or
 `stim reload android` can reload multiple connected devices. Read
 `stim guide lifecycle options` for launch verification and recycling behavior.
+
+### Named server ports
+
+Use `stim ports get web` to reserve a workspace port for a server Stim does not
+manage, then pass that number to the server, for example
+`pnpm exec vite --port "$(stim ports get web)" --strictPort`.
+`stim ports` lists named allocations and managed Metro. `stim ports stop web`
+stops the TCP listener and releases its port; `--dry-run` previews the action.
+`stim ports release web` releases without stopping. Omitting the label selects
+all named ports. These commands leave Metro alone, and `stim stop` leaves
+named ports alone. Worktree removal and `gc --delete` stop and release named
+ports for removed workspaces. Read `stim guide ports` for the reserved band,
+listener ownership, and allocation limits.

package/dist/{android-hMj83VpN.mjs → android-DJWiTBkz.mjs}

@@ -1,18 +1,17 @@
 import { t as getExecutor } from "./exec-CyylIdq9.mjs";
-import { u as getConfigDir } from "./config-CcefMY2Q.mjs";
-import { r as register } from "./cache-manifest-CXR-Y8pH.mjs";
-import { b as sharedBuildCache } from "./state-B3XA2wp2.mjs";
-import { r as pidExists } from "./metro-CORqXyTL.mjs";
-import { a as formatElapsed } from "./command-output-8wHMEde0.mjs";
-import { d as releaseClaim, i as claimRemoveCommand, m as tryAcquireClaim, t as ClaimRefusedError, u as readClaimSet } from "./ownership-claim-BtPtJVmq.mjs";
-import { c as androidDataPartitionSizeBytes } from "./settings-DEJf6_kJ.mjs";
+import { E as ownership_claim_exports, u as getConfigDir } from "./config-DMP7L7H6.mjs";
+import { r as register } from "./cache-manifest-uoOKhgUD.mjs";
+import { l as sharedBuildCache } from "./workspace-state-WVwWw_hB.mjs";
+import { r as pidExists } from "./metro-ato6ef3J.mjs";
+import { a as formatElapsed } from "./command-output-BuIb_ZOI.mjs";
+import { c as androidDataPartitionSizeBytes } from "./settings-kO2ZqIKy.mjs";
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
 import { createHash } from "node:crypto";
 import { join } from "node:path";
-import { existsSync as existsSync$1, lstatSync as lstatSync$1, mkdirSync as mkdirSync$1, openSync as openSync$1, readFileSync as readFileSync$1, readdirSync as readdirSync$1, realpathSync as realpathSync$1, renameSync as renameSync$1, rmSync as rmSync$1, statSync as statSync$1, utimesSync, writeFileSync as writeFileSync$1 } from "fs";
+import { existsSync as existsSync$1, lstatSync as lstatSync$1, mkdirSync as mkdirSync$1, openSync as openSync$1, readFileSync as readFileSync$1, readdirSync as readdirSync$1, realpathSync as realpathSync$1, renameSync as renameSync$1, rmSync as rmSync$1, statSync as statSync$1, writeFileSync as writeFileSync$1 } from "fs";
 import { homedir } from "os";
-import { basename as basename$1, dirname as dirname$1, isAbsolute as isAbsolute$1, join as join$1, resolve as resolve$1 } from "path";
-import { buildCacheKey } from "@stim-cli/core";
+import { dirname as dirname$1, isAbsolute as isAbsolute$1, join as join$1, resolve as resolve$1 } from "path";
+import { buildCacheKey, resolveArtifact, storeArtifact } from "@stim-cli/core";
 import * as expoFingerprint from "@expo/fingerprint";
 import { buildUploadTimeoutMs } from "@stim-cli/cache";
 const ASSET_MANIFEST_FILE = "assets-manifest.json";
@@ -163,16 +162,6 @@ function safeList$1(dir) {
 function entryDir(platform, key, root = sharedBuildCache()) {
 	return join$1(root, platform, key);
 }
-function artifactIn(dir) {
-	if (!existsSync$1(dir)) return null;
-	let found;
-	try {
-		found = readdirSync$1(dir).find((f) => f.endsWith(".app") || f.endsWith(".apk"));
-	} catch {
-		return null;
-	}
-	return found ? join$1(dir, found) : null;
-}
 const FINGERPRINT_PLATFORMS = /* @__PURE__ */ new Set(["ios", "android"]);
 /**
 * Paths that exist in a working checkout and not in a fresh one, which
@@ -211,55 +200,25 @@ function registerOnce(root) {
 	} catch {}
 }
 function resolveBuild(platform, key, root = sharedBuildCache()) {
-	const hit = artifactIn(entryDir(platform, key, root));
-	if (!hit) return null;
-	try {
-		utimesSync(dirname$1(hit), /* @__PURE__ */ new Date(), /* @__PURE__ */ new Date());
-	} catch {}
-	return hit;
+	return resolveArtifact(entryDir(platform, key, root));
 }
 function storeBuild(platform, key, buildPath, rootOrOptions = {}) {
 	const options = typeof rootOrOptions === "string" ? { root: rootOrOptions } : rootOrOptions || {};
 	const root = options.root || sharedBuildCache();
-	const overwrite = Boolean(options.overwrite);
 	if (!buildPath || !existsSync$1(buildPath)) throw new Error(`No build to store at ${buildPath}`);
 	registerOnce(root);
-	const dest = entryDir(platform, key, root);
-	const existing = artifactIn(dest);
-	if (existing && !overwrite) return existing;
-	const staging = `${dest}.staging-${process.pid}`;
-	rmSync$1(staging, {
-		recursive: true,
-		force: true
-	});
-	mkdirSync$1(staging, { recursive: true });
-	try {
-		getExecutor().runFile("cp", [
-			"-c",
-			"-R",
-			buildPath,
-			join$1(staging, basename$1(buildPath))
-		]);
-	} catch {
-		getExecutor().runFile("cp", [
-			"-R",
-			buildPath,
-			join$1(staging, basename$1(buildPath))
-		]);
-	}
-	if (Array.isArray(options.sources)) try {
-		writeFileSync$1(join$1(staging, SOURCES_FILE), JSON.stringify(options.sources));
-	} catch {}
-	if (options.assetManifest) try {
-		writeFileSync$1(join$1(staging, ASSET_MANIFEST_FILE), JSON.stringify(options.assetManifest));
-	} catch {}
-	mkdirSync$1(dirname$1(dest), { recursive: true });
-	rmSync$1(dest, {
-		recursive: true,
-		force: true
+	return storeArtifact(entryDir(platform, key, root), buildPath, {
+		runFile: getExecutor().runFile,
+		overwrite: Boolean(options.overwrite),
+		writeMetadata: (staging) => {
+			if (Array.isArray(options.sources)) try {
+				writeFileSync$1(join$1(staging, SOURCES_FILE), JSON.stringify(options.sources));
+			} catch {}
+			if (options.assetManifest) try {
+				writeFileSync$1(join$1(staging, ASSET_MANIFEST_FILE), JSON.stringify(options.assetManifest));
+			} catch {}
+		}
 	});
-	renameSync$1(staging, dest);
-	return artifactIn(dest);
 }
 const PROVIDER_DOWNLOAD_DIR = "cache-provider";
 function providerDownloadPath(workspacePath) {
@@ -498,13 +457,13 @@ function toRecord(holder) {
 }
 function readBuildLock(pathOrSpec) {
 	const path = typeof pathOrSpec === "string" ? pathOrSpec : buildLockPath(pathOrSpec.platform, pathOrSpec.key);
-	const survey = readClaimSet(path);
+	const survey = (0, ownership_claim_exports.readClaimSet)(path);
 	const holder = survey.live[0] ?? survey.dead[0];
 	return holder ? toRecord(holder) : null;
 }
 function acquireBuildLock({ platform, key, root = null, logFile = null }) {
 	const path = buildLockPath(platform, key);
-	const attempt = tryAcquireClaim({
+	const attempt = (0, ownership_claim_exports.tryAcquireClaim)({
 		root: path,
 		mode: "exclusive",
 		label: label(platform),
@@ -531,7 +490,7 @@ function acquireBuildLock({ platform, key, root = null, logFile = null }) {
 			tookOver: toRecord(reaped)
 		} : handle;
 	}
-	if (attempt.pending) releaseClaim(attempt.pending);
+	if (attempt.pending) (0, ownership_claim_exports.releaseClaim)(attempt.pending);
 	const holder = attempt.held ?? attempt.waitingFor?.[0];
 	return holder ? {
 		held: toRecord(holder),
@@ -539,7 +498,7 @@ function acquireBuildLock({ platform, key, root = null, logFile = null }) {
 	} : { path };
 }
 function releaseBuildLock(handle) {
-	return releaseClaim(handle?.claim);
+	return (0, ownership_claim_exports.releaseClaim)(handle?.claim);
 }
 function listBuildLocks() {
 	const dir = buildLocksDir();
@@ -560,7 +519,7 @@ function listBuildLocks() {
 		}
 		const stem = name.slice(0, -5);
 		const cut = stem.indexOf("-");
-		const survey = readClaimSet(path);
+		const survey = (0, ownership_claim_exports.readClaimSet)(path);
 		const holder = survey.live[0] ?? survey.dead[0];
 		const info = holder ? toRecord(holder) : null;
 		locks.push({
@@ -601,9 +560,9 @@ async function waitForBuild({ platform, key, resolve = resolveBuild, intervalMs
 			hit,
 			waitedMs: now() - started
 		};
-		const survey = readClaimSet(path);
+		const survey = (0, ownership_claim_exports.readClaimSet)(path);
 		const unresolved = survey.unresolved[0];
-		if (unresolved) throw new ClaimRefusedError({
+		if (unresolved) throw new ownership_claim_exports.ClaimRefusedError({
 			claimPath: unresolved.path,
 			root: path,
 			label: label(platform),
@@ -626,7 +585,7 @@ async function waitForBuild({ platform, key, resolve = resolveBuild, intervalMs
 		}
 		const elapsed = now() - started;
 		if (elapsed >= ceilingMs) {
-			const err = /* @__PURE__ */ new Error(`Waited ${formatElapsed(elapsed)} for ${holder?.projectRoot || "another workspace"}'s ${platform} build of ${key} without an artifact, and pid ${holder?.pid} is still the live holder. The lock is ${path}; remove it if that process is not really building:\n  ${claimRemoveCommand(path)}`);
+			const err = /* @__PURE__ */ new Error(`Waited ${formatElapsed(elapsed)} for ${holder?.projectRoot || "another workspace"}'s ${platform} build of ${key} without an artifact, and pid ${holder?.pid} is still the live holder. The lock is ${path}; remove it if that process is not really building:\n  ${(0, ownership_claim_exports.claimRemoveCommand)(path)}`);
 			err.code = "STIM_BUILD_WAIT_TIMEOUT";
 			err.lockPath = path;
 			err.holder = holder ?? void 0;
@@ -750,14 +709,48 @@ function pickDefaultSystemImage(images, { systemImage, hostArch } = {}) {
 	if (matching.length === 0) return null;
 	return matching.toSorted((a, b) => pageSizeRank(a) - pageSizeRank(b) || b.api - a.api || (b.tag === "google_apis" ? 1 : 0) - (a.tag === "google_apis" ? 1 : 0))[0] ?? null;
 }
-function createOwnedAvd(label, { systemImage } = {}) {
+async function createOwnedAvd(label, { systemImage, spawn = (...args) => getExecutor().spawn(...args) } = {}) {
 	const pick = pickDefaultSystemImage(listInstalledSystemImages(), { systemImage });
 	if (!pick) {
 		const arch = hostSystemImageArch();
 		throw new Error(`No ${arch} Android system image is installed. Install one, e.g.: sdkmanager "system-images;android-36;google_apis;${arch}"`);
 	}
 	const avdName = ownedAvdName(label);
-	getExecutor().run(`echo no | ${androidTool("avdmanager")} create avd -n "${avdName}" -k "${pick.pkg}" --device "${DEFAULT_AVD_DEVICE}"`);
+	const tool = androidToolPath("avdmanager");
+	const args = [
+		"create",
+		"avd",
+		"-n",
+		avdName,
+		"-k",
+		pick.pkg,
+		"--device",
+		DEFAULT_AVD_DEVICE
+	];
+	const child = spawn(tool, args, {
+		detached: true,
+		stdio: [
+			"pipe",
+			"pipe",
+			"pipe"
+		]
+	});
+	let stderr = "";
+	child.stdout?.on("data", () => {});
+	child.stderr?.on("data", (chunk) => {
+		stderr = (stderr + String(chunk)).slice(-67108864);
+	});
+	const completed = new Promise((finish, reject) => {
+		child.once("error", reject);
+		child.once("close", (code, signal) => finish({
+			code,
+			signal
+		}));
+	});
+	child.stdin?.on("error", () => {});
+	child.stdin?.end("no\n");
+	const result = await completed;
+	if (result.code !== 0) throw new Error(`Command failed: ${tool} ${args.join(" ")} (${result.signal ?? result.code})\n${stderr.trim()}`);
 	return {
 		avdName,
 		systemImage: pick.pkg

package/dist/{android-cas-DXorPCi_.mjs → android-cas-CSS8gjR7.mjs}

@@ -1,11 +1,11 @@
 import { t as getExecutor } from "./exec-CyylIdq9.mjs";
-import { k as withDirLock, u as getConfigDir } from "./config-CcefMY2Q.mjs";
-import { r as register } from "./cache-manifest-CXR-Y8pH.mjs";
-import { D as workspaceLogsDir, x as sharedCcache, y as ensureWorkspaceStorage } from "./state-B3XA2wp2.mjs";
+import { D as withDirLock, u as getConfigDir } from "./config-DMP7L7H6.mjs";
+import { r as register } from "./cache-manifest-uoOKhgUD.mjs";
+import { _ as workspaceLogsDir, c as ensureWorkspaceStorage, u as sharedCcache } from "./workspace-state-WVwWw_hB.mjs";
 import { n as stripAnsi, r as waitForChild, t as createLineReader } from "./process-output-C7IlIzd7.mjs";
-import { l as phaseLine } from "./command-output-8wHMEde0.mjs";
-import { n as androidHome } from "./android-hMj83VpN.mjs";
-import { f as startBuildHeartbeat, r as HEARTBEAT_INTERVAL_MS } from "./xcode-xnxyvJkD.mjs";
+import { l as phaseLine } from "./command-output-BuIb_ZOI.mjs";
+import { n as androidHome } from "./android-DJWiTBkz.mjs";
+import { d as startBuildHeartbeat, n as HEARTBEAT_INTERVAL_MS } from "./xcode-BqDeRkpT.mjs";
 import { accessSync, constants, existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, symlinkSync, writeFileSync } from "node:fs";
 import { createHash, randomUUID } from "node:crypto";
 import { dirname, isAbsolute, join, relative } from "node:path";
@@ -717,7 +717,10 @@ function gradleArgs(task, { buildCache = true, abi = null } = {}) {
 async function buildAndroid({ root, logWriter, variant = null, abi = null }, { spawnFn = null, now = Date.now, env = process.env, buildCache = true, ccache = null, cas = null, pch = "auto", compilerCacheDisabled = false, heartbeatMs = HEARTBEAT_INTERVAL_MS, estimateMs = null, onHeartbeat = (line) => console.error(line), onNote = (line) => console.error(line) } = {}) {
 	const project = discoverAndroidProject(root);
 	if (project.failed) return {
-		...project,
+		ok: false,
+		code: project.code,
+		reason: project.reason,
+		remedy: project.remedy,
 		diagnostics: [],
 		truncated: 0,
 		lastLines: [],
@@ -730,7 +733,7 @@ async function buildAndroid({ root, logWriter, variant = null, abi = null }, { s
 		hasLocalProperties: existsSync(join(project.androidDir, "local.properties"))
 	});
 	if (refusal) return {
-		failed: true,
+		ok: false,
 		...refusal,
 		diagnostics: [],
 		truncated: 0,
@@ -841,7 +844,7 @@ async function buildAndroid({ root, logWriter, variant = null, abi = null }, { s
 		const how = result.signal ? `signal ${result.signal}` : `exit code ${result.code}`;
 		const { shown, truncated } = capDiagnostics(extractGradleDiagnostics(transcript));
 		return {
-			failed: true,
+			ok: false,
 			code: BUILD_ERROR,
 			reason: `\`./gradlew ${task}\` failed (${how}).`,
 			diagnostics: shown,
@@ -853,7 +856,7 @@ async function buildAndroid({ root, logWriter, variant = null, abi = null }, { s
 	}
 	const located = locateApk(root, transcript, variant);
 	if (!located.apkPath && located.candidates?.length) return {
-		failed: true,
+		ok: false,
 		code: BUILD_ERROR,
 		reason: `\`./gradlew ${task}\` left ${located.candidates.length} debug APKs under ${apkOutputsDir(root)}, and nothing says which flavor to install.`,
 		remedy: `Set the android.variant setting to the variant to install -- e.g. {"android": {"variant": "${variantNameOf(relative(apkOutputsDir(root), located.candidates[0]).split("/").slice(0, -1))}"}} in .stim.json.`,
@@ -864,7 +867,7 @@ async function buildAndroid({ root, logWriter, variant = null, abi = null }, { s
 		ccache: ccacheActivity
 	};
 	if (!located.apkPath) return {
-		failed: true,
+		ok: false,
 		code: BUILD_ERROR,
 		reason: variant ? `\`./gradlew ${task}\` succeeded but produced no APK under ${apkOutputsDir(root)} for variant "${variant}".` : `\`./gradlew ${task}\` succeeded but produced no APK in ${debugApkDir(root)}.`,
 		remedy: variant ? `Check that the android.variant setting ("${variant}") names a real variant (\`./gradlew :app:tasks\` lists the assemble tasks).` : `Check that ${task} builds the app module (\`./gradlew :app:${task}\` in android/) and that no flavour redirects the output.`,
@@ -894,7 +897,7 @@ function spawnFailure(err, project, durationMs) {
 	const message = String(nodeErr?.message || err || "");
 	const permissionDenied = nodeErr?.code === "EACCES" || /EACCES|permission denied/i.test(message);
 	return {
-		failed: true,
+		ok: false,
 		code: BUILD_ERROR,
 		reason: `Could not run ${project.gradlew}: ${message}`,
 		remedy: permissionDenied ? `Make the wrapper executable: \`chmod +x ${project.gradlew}\`.` : "Check that the gradle wrapper is intact (android/gradlew and android/gradle/wrapper/) and that JAVA_HOME points at a JDK 17 install.",