stim 1.20.2 → 1.22.0

package/dist/{settings-B717odTD.mjs → settings-C7O8A6ZI.mjs}

@@ -1,13 +1,14 @@
-import { _ as loadConfig$1, d as getConfigDir, f as getConfigPath$1, h as getRepoSettings, m as getProjectSettings } from "./config-BYDxlMY3.mjs";
-import { n as isTimeoutError, t as getExecutor } from "./exec-DqKo9GKJ.mjs";
-import { r as gitQuiet, t as git } from "./git-DDfFzkMm.mjs";
+import { n as isTimeoutError, r as WorkspaceProcessCleanupError, t as getExecutor } from "./exec-DEoAhcze.mjs";
+import { _ as loadConfig$1, d as getConfigDir, f as getConfigPath$1, h as getRepoSettings, m as getProjectSettings } from "./config-DlrsduwG.mjs";
+import { c as gitQuiet, f as throwIfCancelled, l as gitQuietAsync, o as git, r as childEnvironment, s as gitAsync } from "./operation-exec-BW0em61G.mjs";
 import { accessSync, chmodSync, constants, lstatSync, mkdirSync, mkdtempSync, readdirSync, realpathSync, rmSync, statSync } from "node:fs";
+import { tmpdir } from "node:os";
 import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
-import { dirname as dirname$1, isAbsolute as isAbsolute$1, join as join$1, normalize, relative as relative$1, resolve as resolve$1, sep as sep$1 } from "path";
+import { ambientEnv, buildCacheRoot } from "@stim-cli/core";
 import { REMOTE_DEVICE_BACKENDS, SETTINGS, SETTING_GROUPS, TUNNEL_MODES, WEB_VIEWPORTS, acceptsShape, coerceSettingText, expectedShape, isLayeredSetting, settingDefinition, settingValueError } from "@stim-cli/core/state";
-import { chmodSync as chmodSync$1, existsSync as existsSync$1, lstatSync as lstatSync$1, mkdirSync as mkdirSync$1, readFileSync as readFileSync$1, readdirSync as readdirSync$1, realpathSync as realpathSync$1, statSync as statSync$1, utimesSync as utimesSync$1 } from "fs";
-import { buildCacheRoot } from "@stim-cli/core";
-import { tmpdir } from "node:os";
+import { dirname as dirname$1, isAbsolute as isAbsolute$1, join as join$1, normalize, relative as relative$1, resolve as resolve$1, sep as sep$1 } from "path";
+import { existsSync as existsSync$1, lstatSync as lstatSync$1, readFileSync as readFileSync$1, readdirSync as readdirSync$1, realpathSync as realpathSync$1, statSync as statSync$1 } from "fs";
+import { chmod, lstat, mkdir, readdir, rm, utimes } from "node:fs/promises";
 //#region src/temporary.ts
 function existingPath(path) {
 	const missing = [];
@@ -41,7 +42,7 @@ function inside(parent, path) {
 function temporaryRoot(near) {
 	const reference = existingPath(near);
 	const insideReference = (path) => inside(reference.resolved, path);
-	const override = process.env.STIM_TMPDIR ?? loadConfig$1()?.tempDir;
+	const override = ambientEnv().STIM_TMPDIR ?? loadConfig$1()?.tempDir;
 	if (override !== void 0) {
 		if (typeof override !== "string" || !isAbsolute(override)) throw new Error("STIM_TMPDIR / tempDir must be an absolute directory path.");
 		const { existing, resolved } = existingPath(override);
@@ -88,13 +89,31 @@ function removeTemporaryEntry(path) {
 		force: true
 	});
 }
+async function removeTemporaryEntryAsync(path, signal) {
+	signal?.throwIfAborted();
+	const info = await lstat(path).catch((error) => {
+		if (error instanceof Error && "code" in error && error.code === "ENOENT") return null;
+		throw error;
+	});
+	if (info?.isDirectory()) {
+		await chmod(path, info.mode | 448);
+		for (const entry of await readdir(path, { withFileTypes: true })) if (entry.isDirectory()) await removeTemporaryEntryAsync(join(path, entry.name), signal);
+	}
+	signal?.throwIfAborted();
+	await rm(path, {
+		recursive: true,
+		force: true
+	});
+	signal?.throwIfAborted();
+}
 //#endregion
 //#region src/workspace/worktree.ts
 const CARRY_SKIP_BASENAMES = /* @__PURE__ */ new Set([
 	".DerivedData",
 	".DS_Store",
 	".idea",
-	".jj"
+	".jj",
+	".pnpm-store"
 ]);
 function isCarrySkipped(rel) {
 	return /(^|\/)android\/build\/generated\/autolinking(\/|$)/.test(rel) || String(rel).split("/").some((seg) => CARRY_SKIP_BASENAMES.has(seg));
@@ -102,6 +121,24 @@ function isCarrySkipped(rel) {
 function nativePath(path) {
 	return sep$1 === "/" ? path : path.replaceAll("/", sep$1);
 }
+async function gitReadAsync(dir, args, { removal, env, signal, declareFor, untrimmed }) {
+	signal ??= getExecutor().reportSignal?.();
+	try {
+		return await gitAsync(dir, args, {
+			...env ? childEnvironment(env) : {},
+			signal,
+			...removal ? { timeoutMs: REMOVAL_CHECK_TIMEOUT_MS } : {},
+			killSignal: "SIGKILL",
+			declareFor,
+			untrimmed
+		});
+	} catch (error) {
+		if (error instanceof WorkspaceProcessCleanupError || error instanceof Error && "reportCleanup" in error) throw error;
+		signal?.throwIfAborted();
+		if (removal && isTimeoutError(error)) throw error;
+		return null;
+	}
+}
 function gitRead(dir, args, { removal }) {
 	return removal ? removalCheck(dir, args) : gitQuiet(dir, args);
 }
@@ -113,48 +150,82 @@ function gitCommonDir(cwd, opts = {}) {
 	], opts);
 	return out ? nativePath(out.trim()) : null;
 }
+async function gitCommonDirAsync(cwd, options = {}) {
+	const out = await gitReadAsync(cwd, [
+		"rev-parse",
+		"--path-format=absolute",
+		"--git-common-dir"
+	], options);
+	return out ? nativePath(out.trim()) : null;
+}
 function repoRoot(cwd) {
 	const out = gitQuiet(cwd, ["rev-parse", "--show-toplevel"]);
 	return out ? nativePath(out.trim()) : null;
 }
+async function repoRootAsync(cwd, options = {}) {
+	const out = await gitReadAsync(cwd, ["rev-parse", "--show-toplevel"], options);
+	return out ? nativePath(out.trim()) : null;
+}
+function upstreamState(name, counts) {
+	const [ahead = NaN, behind = NaN] = counts.trim().split(/\s+/).map(Number);
+	if (!name || !Number.isInteger(ahead) || !Number.isInteger(behind)) return null;
+	return {
+		name,
+		ahead,
+		behind
+	};
+}
 function locallyKnownUpstream(projectRoot) {
 	try {
-		const name = git(projectRoot, [
+		return upstreamState(git(projectRoot, [
 			"rev-parse",
 			"--abbrev-ref",
 			"--symbolic-full-name",
 			"@{upstream}"
-		], { timeoutMs: 5e3 });
-		const counts = git(projectRoot, [
+		], { timeoutMs: 5e3 }), git(projectRoot, [
 			"rev-list",
 			"--left-right",
 			"--count",
 			"HEAD...@{upstream}"
-		], { timeoutMs: 5e3 }).trim().split(/\s+/).map(Number);
-		const ahead = counts[0] ?? NaN;
-		const behind = counts[1] ?? NaN;
-		if (!name || !Number.isInteger(ahead) || !Number.isInteger(behind)) return null;
-		return {
-			name,
-			ahead,
-			behind
-		};
+		], { timeoutMs: 5e3 }));
 	} catch {
 		return null;
 	}
 }
-function warmWorktreePaths(cwd) {
-	const currentRoot = repoRoot(cwd);
+async function locallyKnownUpstreamAsync(projectRoot) {
+	try {
+		return upstreamState(await gitAsync(projectRoot, [
+			"rev-parse",
+			"--abbrev-ref",
+			"--symbolic-full-name",
+			"@{upstream}"
+		], { timeoutMs: 5e3 }), await gitAsync(projectRoot, [
+			"rev-list",
+			"--left-right",
+			"--count",
+			"HEAD...@{upstream}"
+		], { timeoutMs: 5e3 }));
+	} catch {
+		return null;
+	}
+}
+async function warmWorktreePaths(cwd, operation) {
+	const options = {
+		env: operation?.env,
+		signal: operation?.signal,
+		declareFor: operation
+	};
+	const currentRoot = await repoRootAsync(cwd, options);
 	if (!currentRoot) throw new Error("Not a git repository.");
 	const target = realpathSync$1(currentRoot);
-	const source = resolveSourceCheckout(target);
+	const source = await resolveSourceCheckoutAsync(target, options);
 	if ("refusal" in source) throw new Error(source.refusal);
-	if (!source.entries.find((entry) => canonicalPath(entry.path) === target)) throw new Error("Could not identify the linked worktree and its source checkout.");
+	if (!source.entries.some((entry) => canonicalPath(entry.path) === target)) throw new Error("Could not identify the linked worktree and its source checkout.");
 	const root = realpathSync$1(source.path);
 	if (root === target) throw new Error("Run stim worktree warm from a linked worktree, not the source checkout.");
-	const sourceRoot = repoRoot(root);
-	const sourceCommon = gitCommonDir(root);
-	const targetCommon = gitCommonDir(target);
+	const sourceRoot = await repoRootAsync(root, options);
+	const sourceCommon = await gitCommonDirAsync(root, options);
+	const targetCommon = await gitCommonDirAsync(target, options);
 	if (!sourceRoot || realpathSync$1(sourceRoot) !== root || !sourceCommon || !targetCommon || realpathSync$1(sourceCommon) !== realpathSync$1(targetCommon)) throw new Error("Could not verify that the source checkout belongs to this linked worktree.");
 	return {
 		root,
@@ -184,16 +255,19 @@ function canonicalPath(path) {
 		return resolve$1(path);
 	}
 }
-function nestedWorktreePaths(root) {
-	const source = canonicalPath(root);
-	const paths = /* @__PURE__ */ new Set();
-	const out = gitQuiet(root, [
+async function nestedWorktreePaths(root, options = {}) {
+	const out = await gitReadAsync(root, [
 		"worktree",
 		"list",
 		"--porcelain"
-	]);
+	], options);
 	if (out === null) throw new Error("Could not list Git worktrees. Refusing to carry ignored files.");
-	for (const entry of parseWorktrees(out)) {
+	return relativeWorktreePaths(root, parseWorktrees(out));
+}
+function relativeWorktreePaths(root, entries) {
+	const source = canonicalPath(root);
+	const paths = /* @__PURE__ */ new Set();
+	for (const entry of entries) {
 		const rel = relative$1(source, canonicalPath(entry.path));
 		if (!rel || rel === ".." || rel.startsWith(`..${sep$1}`) || isAbsolute$1(rel)) continue;
 		paths.add(rel.split(sep$1).join("/"));
@@ -204,13 +278,15 @@ function overlapsNestedWorktree(rel, nestedPaths) {
 	const path = String(rel).replaceAll("\\", "/").replace(/^\.\//, "").replace(/\/$/, "");
 	return nestedPaths.some((nested) => path === nested || path.startsWith(`${nested}/`) || nested.startsWith(`${path}/`));
 }
-function listTrackedPaths(dir) {
-	const out = gitQuiet(dir, ["ls-files", "-z"]);
+async function listTrackedPaths(dir, options = {}) {
+	const out = await gitReadAsync(dir, ["ls-files", "-z"], {
+		...options,
+		untrimmed: true
+	});
 	if (out === null) return null;
 	return out.split("\0").filter(Boolean);
 }
-function trackedGuard(dir) {
-	const paths = listTrackedPaths(dir);
+function trackedPathsGuard(paths) {
 	if (paths === null) return {
 		known: false,
 		covers: () => false
@@ -227,8 +303,8 @@ function trackedGuard(dir) {
 		}
 	};
 }
-function listGitignoredEntries(root) {
-	const out = git(root, [
+async function listGitignoredEntries(root, options = {}) {
+	return (await gitAsync(root, [
 		"ls-files",
 		"--others",
 		"--ignored",
@@ -236,13 +312,17 @@ function listGitignoredEntries(root) {
 		"--directory",
 		"--no-empty-directory",
 		"-z"
-	], { timeoutMs: "unbounded" });
-	if (!out) return [];
-	return out.split("\0").filter(Boolean).map((e) => e.endsWith("/") ? e.slice(0, -1) : e);
-}
-function listCarryableIgnoredEntries(root, patterns) {
-	const nested = nestedWorktreePaths(root);
-	return listGitignoredEntries(root).filter((rel) => !isCarrySkipped(rel) && !overlapsNestedWorktree(rel, nested) && !matchesInclude(rel, patterns));
+	], {
+		...options.env ? childEnvironment(options.env) : {},
+		signal: options.signal,
+		declareFor: options.declareFor,
+		timeoutMs: "unbounded",
+		untrimmed: true
+	})).split("\0").filter(Boolean).map((entry) => entry.endsWith("/") ? entry.slice(0, -1) : entry);
+}
+async function listCarryableIgnoredEntries(root, patterns, options = {}) {
+	const nested = await nestedWorktreePaths(root, options);
+	return (await listGitignoredEntries(root, options)).filter((rel) => !isCarrySkipped(rel) && !overlapsNestedWorktree(rel, nested) && !matchesInclude(rel, patterns));
 }
 function missingDestinationReason(target, rel) {
 	const parts = rel.split("/");
@@ -254,35 +334,54 @@ function missingDestinationReason(target, rel) {
 	}
 	return lstatSync$1(join$1(target, rel), { throwIfNoEntry: false }) ? "exists" : null;
 }
-function removeCopiedExclusions(path, rel) {
-	const entries = readdirSync$1(path, { withFileTypes: true });
+async function removeCopiedExclusionsAsync(path, rel, signal) {
+	signal.throwIfAborted();
+	const entries = await readdir(path, { withFileTypes: true });
 	const excluded = entries.filter((entry) => isCarrySkipped(`${rel}/${entry.name}`));
-	if (excluded.length > 0) {
-		const stat = lstatSync$1(path);
-		chmodSync$1(path, stat.mode | 448);
+	if (excluded.length) {
+		const stat = await lstat(path);
+		await chmod(path, stat.mode | 448);
 		try {
-			for (const entry of excluded) removeTemporaryEntry(join$1(path, entry.name));
+			for (const entry of excluded) {
+				signal.throwIfAborted();
+				await removeTemporaryEntryAsync(join$1(path, entry.name), signal);
+			}
 		} finally {
-			utimesSync$1(path, stat.atime, stat.mtime);
-			chmodSync$1(path, stat.mode);
+			await utimes(path, stat.atime, stat.mtime);
+			await chmod(path, stat.mode);
 		}
 	}
 	for (const entry of entries) {
 		const child = `${rel}/${entry.name}`;
-		if (entry.isDirectory() && !isCarrySkipped(child)) removeCopiedExclusions(join$1(path, entry.name), child);
+		if (entry.isDirectory() && !isCarrySkipped(child)) await removeCopiedExclusionsAsync(join$1(path, entry.name), child, signal);
 	}
 }
-function cloneIgnoredEntries({ root, target, patterns }) {
+async function cloneIgnoredEntries({ root, target, patterns, operation }) {
+	const options = {
+		...childEnvironment(operation.env),
+		signal: operation.signal,
+		declareFor: operation,
+		timeoutMs: "unbounded",
+		untrimmed: true
+	};
+	const reads = {
+		env: operation.env,
+		signal: operation.signal,
+		declareFor: operation
+	};
+	const guard = trackedPathsGuard(await listTrackedPaths(target, reads));
+	if (!guard.known) throw new Error("Could not list the destination's tracked files.");
+	const nested = await nestedWorktreePaths(target, reads);
+	const entries = await listCarryableIgnoredEntries(root, patterns, reads);
 	const copied = [];
 	const skipped = [];
 	const failed = [];
 	let cloned = true;
-	const guard = trackedGuard(target);
-	if (!guard.known) throw new Error("Could not list the destination's tracked files.");
-	const nested = nestedWorktreePaths(target);
-	for (const rel of listCarryableIgnoredEntries(root, patterns)) {
+	for (const rel of entries) {
+		operation.signal.throwIfAborted();
 		const from = join$1(root, rel);
 		const to = join$1(target, rel);
+		let copying = false;
 		try {
 			const reason = guard.covers(rel) ? "tracked" : overlapsNestedWorktree(rel, nested) ? "nested worktree" : missingDestinationReason(target, rel);
 			if (reason) {
@@ -292,28 +391,34 @@ function cloneIgnoredEntries({ root, target, patterns }) {
 				});
 				continue;
 			}
-			mkdirSync$1(dirname$1(to), { recursive: true });
+			await mkdir(dirname$1(to), { recursive: true });
+			copying = true;
 			try {
-				getExecutor().runFile("cp", [
+				await getExecutor().runFileAsync("cp", [
 					"-Rc",
 					from,
 					to
-				], { timeoutMs: "unbounded" });
-			} catch {
-				removeTemporaryEntry(to);
-				getExecutor().runFile("cp", [
+				], options);
+			} catch (cause) {
+				if (cause instanceof WorkspaceProcessCleanupError || cause instanceof Error && "reportCleanup" in cause) throw cause;
+				operation.signal.throwIfAborted();
+				await removeTemporaryEntryAsync(to);
+				await getExecutor().runFileAsync("cp", [
 					"-R",
 					from,
 					to
-				], { timeoutMs: "unbounded" });
+				], options);
 				cloned = false;
 			}
-			if (lstatSync$1(to).isDirectory()) removeCopiedExclusions(to, rel);
+			if ((await lstat(to)).isDirectory()) await removeCopiedExclusionsAsync(to, rel, operation.signal);
 			copied.push(rel);
-		} catch (e) {
+		} catch (cause) {
+			if (cause instanceof WorkspaceProcessCleanupError || cause instanceof Error && "reportCleanup" in cause) throw cause;
+			if (copying) await removeTemporaryEntryAsync(to);
+			operation.signal.throwIfAborted();
 			failed.push({
 				file: rel,
-				error: String(e?.message || e)
+				error: String(cause?.message || cause)
 			});
 		}
 	}
@@ -452,8 +557,8 @@ const FINGERPRINT_INPUT_FILES = [
 	"app.config.mjs",
 	"package.json"
 ];
-function dirtyFingerprintFiles(root) {
-	const out = gitQuiet(root, [
+async function dirtyFingerprintFiles(root) {
+	const out = await gitQuietAsync(root, [
 		"status",
 		"--porcelain",
 		"--",
@@ -475,86 +580,113 @@ function removalCheck(dir, args) {
 		return null;
 	}
 }
-function hasUncommittedWork(dir) {
-	const out = removalCheck(dir, ["status", "--porcelain"]);
+function removalCheckAsync(dir, args, options = {}) {
+	return gitReadAsync(dir, args, {
+		...options,
+		removal: true
+	});
+}
+async function hasUncommittedWorkAsync(dir, options = {}) {
+	const out = await removalCheckAsync(dir, ["status", "--porcelain"], options);
 	if (out === null) return null;
 	return out.trim().length > 0;
 }
 /** The porcelain status lines, or null when git cannot answer; throws when git times out. */
-function dirtyPaths(dir, { limit = 10 } = {}) {
-	const out = removalCheck(dir, ["status", "--porcelain"]);
+async function dirtyPathsAsync(dir, { limit = 10 } = {}, options = {}) {
+	const out = await removalCheckAsync(dir, ["status", "--porcelain"], options);
 	if (out === null) return null;
-	return out.split("\n").map((l) => normalizePorcelainLine(l.trimEnd())).filter(Boolean).slice(0, limit);
+	return out.split("\n").map((line) => normalizePorcelainLine(line.trimEnd())).filter(Boolean).slice(0, limit);
 }
 function normalizePorcelainLine(line) {
 	if (line === "" || line[2] === " ") return line;
 	return ` ${line}`;
 }
-function restoreFile(dir, file) {
-	return gitQuiet(dir, [
-		"checkout",
-		"--",
-		file
-	], { write: true }) !== null;
-}
 function isPodInstallChurn(paths) {
 	if (!paths || paths.length === 0) return false;
 	return paths.every((line) => /(?:^|\/)(?:Podfile\.lock|project\.pbxproj)$/.test(line.slice(3).trim()));
 }
 const SAFE_BRANCH_NAME = /^[A-Za-z0-9@._/-]+$/;
-function unpushedCommits(dir) {
-	const branch = removalCheck(dir, [
+async function unpushedCommitsAsync(dir, options = {}) {
+	const branch = await removalCheckAsync(dir, [
 		"symbolic-ref",
 		"--quiet",
 		"--short",
 		"HEAD"
-	]);
+	], options);
 	const own = branch === null ? "" : branch.trim();
 	const protection = own && SAFE_BRANCH_NAME.test(own) ? [
 		"--remotes",
 		`--exclude=${own}`,
 		"--branches"
 	] : ["--remotes"];
-	if (!own && removalCheck(dir, [
+	if (!own && await removalCheckAsync(dir, [
 		"rev-parse",
 		"--abbrev-ref",
 		"HEAD"
-	]) === "HEAD") protection.push("--branches");
-	const out = removalCheck(dir, [
+	], options) === "HEAD") protection.push("--branches");
+	const out = await removalCheckAsync(dir, [
 		"log",
 		"--oneline",
 		"HEAD",
 		"--not",
 		...protection
-	]);
+	], options);
 	if (out === null) return null;
-	return out.split("\n").map((l) => l.trim()).filter(Boolean);
-}
-function hasRemote(dir) {
-	const out = gitQuiet(dir, ["remote"]);
-	return Boolean(out && out.trim().length > 0);
+	return out.split("\n").map((line) => line.trim()).filter(Boolean);
 }
-function branchExists(cwd, branch, opts = {}) {
+function resolveFullRef(cwd, ref, opts = {}) {
 	const out = gitRead(cwd, [
 		"rev-parse",
 		"--verify",
 		"--quiet",
-		`refs/heads/${branch}`
+		"--end-of-options",
+		`${ref}^{commit}`
 	], opts);
-	return Boolean(out);
+	return out && out.trim() ? out.trim() : null;
 }
-function resolveFullRef(cwd, ref, opts = {}) {
-	const out = gitRead(cwd, [
+async function resolveFullRefAsync(cwd, ref, options = {}) {
+	const out = await gitReadAsync(cwd, [
 		"rev-parse",
 		"--verify",
 		"--quiet",
 		"--end-of-options",
 		`${ref}^{commit}`
-	], opts);
+	], options);
 	return out && out.trim() ? out.trim() : null;
 }
-function removeWorktree(path, { from, force = false, platform = process.platform }) {
-	const args = [
+async function hasRemoteAsync(dir, options = {}) {
+	const out = await gitReadAsync(dir, ["remote"], options);
+	return Boolean(out && out.trim().length > 0);
+}
+async function branchExistsAsync(cwd, branch, options = {}) {
+	return Boolean(await gitReadAsync(cwd, [
+		"rev-parse",
+		"--verify",
+		"--quiet",
+		`refs/heads/${branch}`
+	], options));
+}
+async function restoreFileAsync(dir, file, options = {}) {
+	try {
+		await gitAsync(dir, [
+			"checkout",
+			"--",
+			file
+		], {
+			...options.env ? childEnvironment(options.env) : {},
+			signal: options.signal,
+			declareFor: options.declareFor,
+			write: true
+		});
+		return true;
+	} catch (error) {
+		if (error instanceof WorkspaceProcessCleanupError || error instanceof Error && "reportCleanup" in error) throw error;
+		options.signal?.throwIfAborted();
+		return false;
+	}
+}
+function worktreeRemoveArgs(path, force, platform) {
+	return [
 		...platform === "win32" ? ["-c", "core.longpaths=true"] : [],
 		"worktree",
 		"remove",
@@ -562,19 +694,32 @@ function removeWorktree(path, { from, force = false, platform = process.platform
 		"--",
 		path
 	];
-	git(from, args, {
+}
+async function removeWorktreeAsync(path, { from, force = false, platform = process.platform, env, signal, declareFor }) {
+	await gitAsync(from, worktreeRemoveArgs(path, force, platform), {
+		...env ? childEnvironment(env) : {},
+		signal,
+		declareFor,
 		write: true,
 		timeoutMs: "unbounded"
 	});
 }
-function deleteBranch(cwd, branch, expectedSha) {
+function branchDeleteArgs(branch, expectedSha) {
 	if (!SAFE_BRANCH_NAME.test(branch) || branch.startsWith("-")) throw new Error(`Refusing branch ${JSON.stringify(branch)}: it is not a safe local branch name.`);
-	git(cwd, [
+	return [
 		"update-ref",
 		"-d",
 		`refs/heads/${branch}`,
 		expectedSha
-	], { write: true });
+	];
+}
+async function deleteBranchAsync(cwd, branch, expectedSha, options = {}) {
+	await gitAsync(cwd, branchDeleteArgs(branch, expectedSha), {
+		...options.env ? childEnvironment(options.env) : {},
+		signal: options.signal,
+		declareFor: options.declareFor,
+		write: true
+	});
 }
 function parseWorktrees(out) {
 	const entries = [];
@@ -590,18 +735,18 @@ function parseWorktrees(out) {
 	return entries;
 }
 /** Null when git cannot list the index, so the answer is unknown; throws when git times out. */
-function hasPopulatedSubmodules(worktree) {
-	const modules = removalCheck(worktree, [
+async function hasPopulatedSubmodulesAsync(worktree, options = {}) {
+	const modules = await removalCheckAsync(worktree, [
 		"rev-parse",
 		"--git-path",
 		"modules"
-	]);
+	], options);
 	if (modules && existsSync$1(resolve$1(worktree, nativePath(modules)))) return true;
-	const staged = removalCheck(worktree, [
+	const staged = await removalCheckAsync(worktree, [
 		"ls-files",
 		"--stage",
 		"-z"
-	]);
+	], options);
 	if (staged === null) return null;
 	return staged.split("\0").some((line) => line.startsWith("160000 ") && existsSync$1(join$1(worktree, line.slice(line.indexOf("	") + 1), ".git")));
 }
@@ -613,6 +758,14 @@ function listWorktrees(cwd, opts = {}) {
 	], opts);
 	return out ? parseWorktrees(out) : [];
 }
+async function listWorktreesAsync(cwd, options = {}) {
+	const out = await gitReadAsync(cwd, [
+		"worktree",
+		"list",
+		"--porcelain"
+	], options);
+	return out ? parseWorktrees(out) : [];
+}
 function branchOf(head) {
 	return head.startsWith("ref: refs/heads/") ? head.slice(16) : void 0;
 }
@@ -699,11 +852,17 @@ function sourceCheckoutOf(entries) {
 	const first = entries[0];
 	return selectSourceCheckout(entries, first?.bare ? bareHeadBranch(first.path) : null);
 }
-function resolveSourceCheckout(cwd) {
-	const entries = listWorktrees(cwd);
+async function resolveSourceCheckoutAsync(cwd, options = {}) {
+	const entries = await listWorktreesAsync(cwd, options);
+	const first = entries[0];
+	const head = first?.bare ? (await gitReadAsync(first.path, [
+		"symbolic-ref",
+		"--quiet",
+		"HEAD"
+	], options))?.trim() : null;
 	return {
 		entries,
-		...sourceCheckoutOf(entries)
+		...selectSourceCheckout(entries, head?.startsWith("refs/heads/") ? head.slice(11) : null)
 	};
 }
 //#endregion
@@ -1286,6 +1445,37 @@ function resolveProjectSettings(root) {
 		settings: resolveSettings(context)
 	};
 }
+/** Resolves repository paths asynchronously; declared probes run sequentially and cancellation rejects. */
+async function projectSettingsContextAsync(root, git = {
+	gitCommonDir: gitCommonDirAsync,
+	repoRoot: repoRootAsync
+}, { env = process.env, signal, declareFor } = {}) {
+	throwIfCancelled(signal, "settings resolution");
+	const options = {
+		env,
+		signal,
+		declareFor
+	};
+	const common = Promise.resolve(git.gitCommonDir(root, options));
+	const repo = declareFor ? common.then(() => git.repoRoot(root, options)) : git.repoRoot(root, options);
+	const [commonResult, repoResult] = await Promise.allSettled([common, repo]);
+	for (const result of [commonResult, repoResult]) if (result.status === "rejected" && (result.reason instanceof WorkspaceProcessCleanupError || result.reason instanceof Error && "reportCleanup" in result.reason)) throw result.reason;
+	throwIfCancelled(signal, "settings resolution");
+	if (commonResult.status === "rejected") throw commonResult.reason;
+	if (repoResult.status === "rejected") throw repoResult.reason;
+	return {
+		projectPath: root,
+		gitCommonDir: commonResult.value,
+		repoRoot: repoResult.value
+	};
+}
+async function resolveProjectSettingsAsync(root, options) {
+	const context = await projectSettingsContextAsync(root, void 0, options);
+	return {
+		context,
+		settings: resolveSettings(context)
+	};
+}
 const METRO_COMMAND_PORT = "{port}";
 function metroCommandSetting(settings) {
 	const value = settingValueAt(settings, "metro.command");
@@ -1348,7 +1538,7 @@ function cacheProviderSettingError(settings) {
 	if ("options" in block && !isPlainObject(block.options)) return `Invalid cache.options setting ${JSON.stringify(block.options)}. Expected an object.`;
 	return null;
 }
-/** The remote target `remote` names, or null for `local`, which runs on this Mac whatever a lower layer sets. */
+/** The remote target `remote` names, or null for `local`, which runs on this machine whatever a lower layer sets. */
 function parseIosRemote(remote) {
 	const selected = remote.trim();
 	const reserved = selected.toLowerCase();
@@ -1459,4 +1649,4 @@ function webSettings(settings) {
 	};
 }
 //#endregion
-export { settingValueAt as $, metroIdleStopMinutesSetting as A, restoreFile as At, remoteAndroidSetting as B, iosSigningIdentitySha1Setting as C, locallyKnownUpstream as Ct, mergeSettingsLayers as D, repoRoot as Dt, maintenanceKeepSetting as E, removeWorktree as Et, parseIosRemote as F, makeTemporaryDirectory as Ft, resolveIosProjectDir as G, remoteIosSetting as H, projectSettingsContext as I, removeTemporaryEntry as It, runnableMetroCommand as J, resolveProjectSettings as K, publicUrlSetting as L, temporaryRoot as Lt, metroTunnelSettingError as M, unpushedCommits as Mt, metroWarmupUrlSetting as N, warmWorktreePaths as Nt, metroCommandSetting as O, resolveFullRef as Ot, ngrokUrlSetting as P, filesystemDevice as Pt, settingShapeErrors as Q, readCommittedSettings as R, iosSigningIdentitySettingError as S, listWorktrees as St, iosSimSlimProfileSetting as T, readWorktreeExclude as Tt, resolveAndroidLayout as U, remoteEasFallbackSetting as V, resolveCacheProviderConfig as W, settingOrigin as X, settingFile as Y, settingOriginScope as Z, iosLanHostSetting as _, hasPopulatedSubmodules as _t, SETTING_SHAPE_REMEDY as a, PUBLIC_METRO_ENV as at, iosProjectDirSettingError as b, isPodInstallChurn as bt, androidDataPartitionSizeBytes as c, resolveTailscaleBinary as ct, androidLayoutSetting as d, deleteBranch as dt, settingsLayers as et, androidLayoutSettingError as f, depsOutOfSync as ft, deviceReclaimIdleMinutesSetting as g, gitCommonDirOnDisk as gt, deviceIdleShutdownMinutesSetting as h, gitCommonDir as ht, SETTINGS_WITH_RESOLVE_TIME_FALLBACK as i, workspaceHiddenSetting as it, metroPortSetting as j, sourceCheckoutOf as jt, metroCommandSettingError as k, resolveSourceCheckout as kt, androidDataPartitionSizeGbSetting as l, branchExists as lt, defaultAndroidLayout as m, dirtyPaths as mt, METRO_COMMAND_PORT as n, unknownSettingKeys as nt, androidAvdConfigSetting as o, detectProviders as ot, cacheProviderSettingError as p, dirtyFingerprintFiles as pt, resolveSettings as q, PATH_SETTINGS as r, webSettings as rt, androidAvdConfigSettingError as s, planMetroReach as st, ANDROID_AVD_CONFIG_HELP as t, tunnelModeSetting as tt, androidDataPartitionSizeGbSettingError as u, cloneIgnoredEntries as ut, iosLanHostSettingError as v, hasRemote as vt, iosSigningIdentitySha1SettingError as w, podsOutOfSync as wt, iosSigningIdentitySetting as x, linkedWorktreesOnDisk as xt, iosProjectDirSetting as y, hasUncommittedWork as yt, realpathInside as z };
+export { settingOriginScope as $, metroIdleStopMinutesSetting as A, readWorktreeExclude as At, realpathInside as B, warmWorktreePaths as Bt, iosSigningIdentitySha1Setting as C, isPodInstallChurn as Ct, mergeSettingsLayers as D, locallyKnownUpstream as Dt, maintenanceKeepSetting as E, listWorktreesAsync as Et, parseIosRemote as F, resolveFullRefAsync as Ft, resolveCacheProviderConfig as G, temporaryRoot as Gt, remoteEasFallbackSetting as H, makeTemporaryDirectory as Ht, projectSettingsContext as I, resolveSourceCheckoutAsync as It, resolveProjectSettingsAsync as J, resolveIosProjectDir as K, projectSettingsContextAsync as L, restoreFileAsync as Lt, metroTunnelSettingError as M, repoRoot as Mt, metroWarmupUrlSetting as N, repoRootAsync as Nt, metroCommandSetting as O, locallyKnownUpstreamAsync as Ot, ngrokUrlSetting as P, resolveFullRef as Pt, settingOrigin as Q, publicUrlSetting as R, sourceCheckoutOf as Rt, iosSigningIdentitySettingError as S, hasUncommittedWorkAsync as St, iosSimSlimProfileSetting as T, listWorktrees as Tt, remoteIosSetting as U, removeTemporaryEntry as Ut, remoteAndroidSetting as V, filesystemDevice as Vt, resolveAndroidLayout as W, removeTemporaryEntryAsync as Wt, runnableMetroCommand as X, resolveSettings as Y, settingFile as Z, iosLanHostSetting as _, gitCommonDir as _t, SETTING_SHAPE_REMEDY as a, webSettings as at, iosProjectDirSettingError as b, hasPopulatedSubmodulesAsync as bt, androidDataPartitionSizeBytes as c, detectProviders as ct, androidLayoutSetting as d, branchExistsAsync as dt, settingShapeErrors as et, androidLayoutSettingError as f, cloneIgnoredEntries as ft, deviceReclaimIdleMinutesSetting as g, dirtyPathsAsync as gt, deviceIdleShutdownMinutesSetting as h, dirtyFingerprintFiles as ht, SETTINGS_WITH_RESOLVE_TIME_FALLBACK as i, unknownSettingKeys as it, metroPortSetting as j, removeWorktreeAsync as jt, metroCommandSettingError as k, podsOutOfSync as kt, androidDataPartitionSizeGbSetting as l, planMetroReach as lt, defaultAndroidLayout as m, depsOutOfSync as mt, METRO_COMMAND_PORT as n, settingsLayers as nt, androidAvdConfigSetting as o, workspaceHiddenSetting as ot, cacheProviderSettingError as p, deleteBranchAsync as pt, resolveProjectSettings as q, PATH_SETTINGS as r, tunnelModeSetting as rt, androidAvdConfigSettingError as s, PUBLIC_METRO_ENV as st, ANDROID_AVD_CONFIG_HELP as t, settingValueAt as tt, androidDataPartitionSizeGbSettingError as u, resolveTailscaleBinary as ut, iosLanHostSettingError as v, gitCommonDirAsync as vt, iosSigningIdentitySha1SettingError as w, linkedWorktreesOnDisk as wt, iosSigningIdentitySetting as x, hasRemoteAsync as xt, iosProjectDirSetting as y, gitCommonDirOnDisk as yt, readCommittedSettings as z, unpushedCommitsAsync as zt };