@devdogsuga/devtools 0.1.51-next.541 → 0.1.51-next.545

package/README.md

@@ -97,12 +97,15 @@ name `devdogs-monorepo` or `backstage`; the layout code is
 
 A repository with a `devtools.config.json` at its root is a **product** (DogDays, DogPack): devtools
 reads the file and serves a smaller command set that needs no tiers, no env registry and no workspace.
-DogPack has no `package.json`, so it runs the published CLI directly:
+Both products carry a `package.json` whose `devtools` script is a `pnpm dlx` run of the published CLI, so
+inside a checkout:
 
 ```sh
-npx @devdogsuga/devtools@next setup
+pnpm devtools setup
 ```
 
+Anywhere else, the one-off form is `pnpm dlx @devdogsuga/devtools@next setup`.
+
 | Command                                 | What it does                                                                                                                                                               |
 | --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `setup [--local \| --hosted]`           | Writes `.env` from `.env.example`; starts the Docker stack (or takes your own hosted project's URL, keys and session-pooler `DB_URL`); `db sync`; the types; then `oauth`. |
@@ -136,7 +139,7 @@ How it works, in short:
   `oauth` (the tooling file) check that they are git-ignored and add them to the repo's `.gitignore`
   when they are not (Flutter's default ignore file leaves them out).
 - **The pinned CLI.** devtools finds `supabase` in `node_modules/.bin` or on PATH when its version is the
-  pin, and otherwise runs `npx --yes supabase@<pin>`.
+  pin, and otherwise runs `pnpm dlx supabase@<pin>` (`npx --yes supabase@<pin>` only when pnpm is not on PATH).
 - **A hosted project** needs custom OAuth providers turned on and the app's return addresses allowed.
   `setup` does both through the Management API when `SUPABASE_ACCESS_TOKEN` is set, and prints the two
   dashboard steps when it is not.

package/dist/{cli-BoTmTNqH.js → cli-DNZ-6WEI.js}

@@ -1,16 +1,18 @@
-import { c as ownPackageDir, g as positionals, h as flagValue, l as ownVersion, n as discoverRepoRoot, r as findRepoRoot, u as cliName } from "./root-CsocfxnK.js";
-import { A as helpPath, C as currentProduct, D as isProductMode, E as activeCatalog, M as renderHelp, S as ProductConfigError, T as loadProductConfig, _ as bail, a as recordEnteredTier, b as explainError, c as describeEnvironment, d as resolveDbConnection, f as sessionIsLocal, i as beginInvocation, j as renderCommandList, k as catalog, l as probeEnvironment, n as bareGroupStartPath, o as recordResolved, p as sessionLabel, r as runMenu, s as reproducibleCommand, t as bareGroupStartFlags, u as nonEmpty, v as errorMessage, x as unwrap, y as explain } from "./menu-C30rQm5v.js";
-import { A as dryRunKind, C as layoutAt, E as resolveLayout, O as reportRan, P as wouldRunLine, S as findApp, T as resolveAppPath, _ as loadEnvLoad, b as appWorkspaceRoot, c as reportRuns, f as supabase, g as loadEnv, h as getEnvSync, j as isDryRun, k as runInGroup, l as run$1, m as supabaseRoot, s as dbPush, u as runWithStderr, v as loadEnvSession, w as listApps, x as devdogsugaRootOrNull, y as repoPeerUrl } from "./supabase-project-BoJKMCxL.js";
-import { d as hasYes, f as isNonInteractive, n as captureDevtoolsError, o as initDevtoolsTelemetry } from "./telemetry-BKFDtzXI.js";
-import { t as runStackCommand } from "./stack-7Lbym6Wq.js";
+import { n as execSync, r as spawnProcess } from "./spawn-BvLQzc_K.js";
+import { n as discoverRepoRoot, r as findRepoRoot } from "./root-PA8K5G2d.js";
+import { A as findApp, M as listApps, N as resolveAppPath, O as appWorkspaceRoot, P as resolveLayout, _ as dryRunKind, c as supabaseRoot, d as loadEnvLoad, f as loadEnvSession, g as runInGroup, h as reportRan, i as runWithStderr, j as layoutAt, k as devdogsugaRootOrNull, l as getEnvSync, n as reportRuns, o as supabase, p as repoPeerUrl, r as run$1, t as dbPush, u as loadEnv, v as isDryRun, x as wouldRunLine } from "./run-CRBte7p0.js";
+import { A as renderHelp, C as loadProductConfig, D as catalog, M as probeEnvironment, O as helpPath, T as isProductMode, _ as explain, a as recordEnteredTier, b as ProductConfigError, c as nonEmpty, d as sessionLabel, g as errorMessage, h as bail, i as beginInvocation, j as describeEnvironment, k as renderCommandList, l as resolveDbConnection, n as bareGroupStartPath, o as recordResolved, r as runMenu, s as reproducibleCommand, t as bareGroupStartFlags, u as sessionIsLocal, v as explainError, w as activeCatalog, x as currentProduct, y as unwrap } from "./menu-oQE5IqAI.js";
+import { a as isVersionRequest, c as cliName, m as positionals, o as ownPackageDir, p as flagValue, s as ownVersion } from "./failure-log-MSdCgvLc.js";
+import { f as hasYes, n as captureDevtoolsError, o as initDevtoolsTelemetry, p as isNonInteractive } from "./telemetry-BDTAGquh.js";
+import { t as runStackCommand } from "./stack-BRevXgI3.js";
 import { register } from "node:module";
 import { appendFileSync, existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { basename, dirname, join, relative, resolve, sep } from "node:path";
 import { z } from "zod";
 import { confirm, intro, log, multiselect, note, outro, password, select, spinner, text } from "@clack/prompts";
 import { chmod, readFile, writeFile } from "node:fs/promises";
-import { execFile, execFileSync, spawn, spawnSync } from "node:child_process";
 import { pathToFileURL } from "node:url";
+import { execFileSync, spawnSync } from "node:child_process";
 import { parse } from "dotenv";
 import postgres from "postgres";
 import { flattenDiagnosticMessageText, parseConfigFileTextToJson } from "typescript";
@@ -1417,14 +1419,11 @@ function checkEnvKeysPresent(env, keys) {
 }
 function has$1(cmd, args) {
 	try {
-		return execFileSync(cmd, args, {
-			stdio: [
-				"ignore",
-				"pipe",
-				"ignore"
-			],
-			encoding: "utf8"
-		}).trim();
+		return execSync(cmd, args, { stdio: [
+			"ignore",
+			"pipe",
+			"ignore"
+		] }).trim();
 	} catch {
 		return null;
 	}
@@ -3325,7 +3324,7 @@ async function startTemporaryWrangler(app, requestedPort) {
 		process.stderr.write(`devtools jobs: building ${app}'s workspace dependencies failed (exit ${buildCode}); not starting ${runtime}.\n`);
 		return null;
 	}
-	const child = spawn("pnpm", vinextDevArgs(app, port), {
+	const child = spawnProcess("pnpm", vinextDevArgs(app, port), {
 		cwd: appWorkspaceRoot(app),
 		stdio: "inherit",
 		detached: process.platform !== "win32",
@@ -4895,9 +4894,8 @@ function formatValue(value) {
 //#endregion
 //#region src/oauth/db.ts
 function runStatus(argv, cwd) {
-	return execFileSync(argv[0], argv.slice(1), {
+	return execSync(argv[0], argv.slice(1), {
 		cwd,
-		encoding: "utf-8",
 		stdio: [
 			"pipe",
 			"pipe",
@@ -4922,7 +4920,7 @@ function productPin(cwd) {
 * a sibling project, where the Supabase CLI is normally installed globally;
 * this monorepo, where it is a workspace devDependency and not on PATH at all;
 * and a product repo (`devtools.config.json`), where `devtools setup` ran the
-* pinned CLI through `npx` and a new member has none installed. A global install
+* pinned CLI through `pnpm dlx` and a new member has none installed. A global install
 * wins, since `pnpm exec` in a non-pnpm project would fail for reasons that have
 * nothing to do with Supabase.
 */
@@ -4944,19 +4942,32 @@ function detectLocalSupabase(cwd) {
 		...status
 	]];
 	const pin = productPin(cwd);
-	if (pin !== null) attempts.push([
-		"npx",
-		"--yes",
-		`supabase@${pin}`,
-		...status
-	]);
+	if (pin !== null) {
+		attempts.push([
+			"pnpm",
+			"dlx",
+			`supabase@${pin}`,
+			...status
+		]);
+		attempts.push([
+			"npx",
+			"--yes",
+			`supabase@${pin}`,
+			...status
+		]);
+	}
 	let output;
 	let first;
-	for (const argv of attempts) try {
-		output = runStatus(argv, cwd);
-		break;
-	} catch (error) {
-		first ??= error;
+	let pnpmMissing = false;
+	for (const argv of attempts) {
+		if (argv[0] === "npx" && !pnpmMissing) continue;
+		try {
+			output = runStatus(argv, cwd);
+			break;
+		} catch (error) {
+			first ??= error;
+			if (argv[0] === "pnpm" && error.code === "ENOENT") pnpmMissing = true;
+		}
 	}
 	if (output === void 0) {
 		if (first.code === "ENOENT") throw new Error("supabase CLI not found — install it from https://supabase.com/docs/guides/cli");
@@ -5097,14 +5108,22 @@ async function fetchIssuerFromAny(baseUrls) {
 //#region src/oauth/browser.ts
 /** Opens `url` in the user's default browser, cross-platform. */
 function openBrowser(url) {
-	if (process.platform === "win32") execFile("cmd", [
-		"/c",
-		"start",
-		"",
-		url
-	]);
-	else if (process.platform === "darwin") execFile("open", [url]);
-	else execFile("xdg-open", [url]);
+	const [command, args] = browserCommand(url, process.platform);
+	spawnProcess(command, args, {
+		stdio: "ignore",
+		detached: true
+	}).on("error", () => void 0).unref();
+}
+/**
+* The program that opens `url`. Windows uses `rundll32`, a real executable, not
+* `cmd /c start`: through `cmd.exe` an `&` in the URL ends the command and
+* starts another, which truncates every OAuth authorize URL at its first query
+* parameter.
+*/
+function browserCommand(url, platform) {
+	if (platform === "win32") return ["rundll32", ["url.dll,FileProtocolHandler", url]];
+	if (platform === "darwin") return ["open", [url]];
+	return ["xdg-open", [url]];
 }
 //#endregion
 //#region src/oauth/pkce.ts
@@ -6756,14 +6775,11 @@ const handleScript = async (rest) => {
 */
 function has(cmd, args = ["--version"]) {
 	try {
-		return execFileSync(cmd, args, {
-			stdio: [
-				"ignore",
-				"pipe",
-				"ignore"
-			],
-			encoding: "utf8"
-		}).trim();
+		return execSync(cmd, args, { stdio: [
+			"ignore",
+			"pipe",
+			"ignore"
+		] }).trim();
 	} catch {
 		return null;
 	}
@@ -6988,7 +7004,7 @@ const OAUTH = {
 //#endregion
 //#region src/product/exec.ts
 const spawnRunner = (command, args, options) => new Promise((resolve, reject) => {
-	const child = spawn(command, [...args], {
+	const child = spawnProcess(command, args, {
 		cwd: options.cwd,
 		env: {
 			...process.env,
@@ -7031,7 +7047,9 @@ function commandLine(command, args) {
 *
 *   1. `node_modules/.bin/supabase` in the repo, when its version is the pin;
 *   2. a `supabase` on PATH whose version is the pin;
-*   3. `npx --yes supabase@<pin>`, which downloads and caches the right one.
+*   3. `pnpm dlx supabase@<pin>`, which downloads and caches the right one.
+*      Members are expected to have pnpm (both product repos pin it);
+*   4. `npx --yes supabase@<pin>`, only when pnpm is not on PATH.
 *
 * The pin is also part of the generated-types hash, so a contributor on a
 * different CLI would generate different types than CI; matching it is not
@@ -7060,6 +7078,13 @@ async function resolveSupabaseCli(root, pin, run, fileExists = existsSync) {
 		const result = await run(candidate.command, ["--version"], { cwd: root });
 		if (result.code === 0 && versionOf(result.stdout) === pin) return candidate;
 	} catch {}
+	try {
+		if ((await run("pnpm", ["--version"], { cwd: root })).code === 0) return {
+			command: "pnpm",
+			prefix: ["dlx", `supabase@${pin}`],
+			source: "pnpm"
+		};
+	} catch {}
 	return {
 		command: "npx",
 		prefix: ["--yes", `supabase@${pin}`],
@@ -7209,6 +7234,15 @@ var DevDataError = class extends Error {
 		this.name = "DevDataError";
 	}
 };
+/**
+* Whether `err` is Postgres saying a table or schema does not exist
+* (SQLSTATE 42P01 undefined_table, 3F000 invalid_schema_name): the database
+* has not had the product's schema applied yet.
+*/
+function isMissingSchemaError(err) {
+	const code = err?.code;
+	return code === "42P01" || code === "3F000";
+}
 function postgresSession(dbUrl) {
 	const sql = postgres(dbUrl, {
 		max: 1,
@@ -7262,22 +7296,28 @@ async function runDevData(product, target, open, options) {
 	const text = readFileSync(file, "utf8");
 	const session = open(target.dbUrl);
 	try {
-		const member = options.member ? await session.memberByRef(options.member) : (await session.members(options.provider))[0] ?? null;
-		if (!member) throw new DevDataError(options.member ? `No user matches ${options.member} in this database.` : `Nobody has signed in with DevDogs on this database yet. Start the app, sign in, then run this again (or name someone with --member).`);
-		log(`Seeding as ${member.email ?? member.id} (${member.id})`);
-		if (options.dryRun) {
-			log(`Would run ${devData.file} (${text.split("\n").length} lines) in one transaction.`);
-			return null;
-		}
-		await session.runAs(member.id, text);
-		return {
-			member,
-			file: devData.file
-		};
+		return await seed(session, devData.file, text, options, log);
+	} catch (err) {
+		if (isMissingSchemaError(err)) throw new DevDataError(`This database does not have ${product.config.name}'s tables yet (${err.message}). Run \`devtools setup\` first, or \`devtools db sync\` if you have already set up.`);
+		throw err;
 	} finally {
 		await session.close();
 	}
 }
+async function seed(session, file, text, options, log) {
+	const member = options.member ? await session.memberByRef(options.member) : (await session.members(options.provider))[0] ?? null;
+	if (!member) throw new DevDataError(options.member ? `No user matches ${options.member} in this database.` : `Nobody has signed in with DevDogs on this database yet. Start the app, sign in, then run this again (or name someone with --member).`);
+	log(`Seeding as ${member.email ?? member.id} (${member.id})`);
+	if (options.dryRun) {
+		log(`Would run ${file} (${text.split("\n").length} lines) in one transaction.`);
+		return null;
+	}
+	await session.runAs(member.id, text);
+	return {
+		member,
+		file
+	};
+}
 //#endregion
 //#region src/product/management.ts
 /**
@@ -8033,7 +8073,7 @@ async function runDoctor(product, deps) {
 	const info = (message) => void lines.push(`INFO  ${message}`);
 	ok(`${product.config.name} (${product.config.product}), Supabase CLI pinned at ${product.config.supabase.version}`);
 	const cli = await cliFor(product, deps);
-	if (cli.source === "npx") info(`The pinned Supabase CLI is fetched with npx on first use (${cliLine(cli, ["--version"])}).`);
+	if (cli.source === "pnpm" || cli.source === "npx") info(`The pinned Supabase CLI is fetched with ${cli.command} on first use (${cliLine(cli, ["--version"])}).`);
 	else ok(`Supabase CLI ${product.config.supabase.version} (${cli.source})`);
 	const docker = await deps.run("docker", [
 		"info",
@@ -8507,7 +8547,7 @@ async function main(typed) {
 		await handleCompletions(argv.slice(1));
 		return;
 	}
-	if (argv[0] === "version") {
+	if (isVersionRequest(argv)) {
 		process.stdout.write(`${ownVersion()}\n`);
 		return;
 	}
@@ -8517,6 +8557,10 @@ async function main(typed) {
 		return;
 	}
 	const startPath = process.stdin.isTTY ? bareGroupStartPath(catalog, argv) : null;
+	if (argv.length === 0 && isNonInteractive()) {
+		console.log(renderHelp(catalog));
+		return;
+	}
 	const banners = !isNonInteractive();
 	if (banners) intro("DevDogs devtools");
 	let closing;

package/dist/{root-CsocfxnK.js → failure-log-MSdCgvLc.js}

@@ -270,6 +270,10 @@ function ownVersion() {
 	const pkg = JSON.parse(readFileSync(join(ownPackageDir(), "package.json"), "utf8"));
 	return typeof pkg.version === "string" ? pkg.version : "0.0.0";
 }
+/** `devtools version`, `devtools --version`, `devtools -V`: answered anywhere. */
+function isVersionRequest(argv) {
+	return argv[0] === "version" || argv[0] === "--version" || argv[0] === "-V";
+}
 //#endregion
 //#region ../cli-core/src/failure-log.ts
 /**
@@ -425,78 +429,4 @@ function installFailureLog(options) {
 	});
 }
 //#endregion
-//#region ../cli-core/src/repo/root.ts
-/**
-* Where devtools finds the DevDogsUGA checkout it is running against.
-*
-* devtools used to live inside `packages/devtools` of that repo, so its own
-* `import.meta.url` WAS a path into the repo (`PROJECT_ROOT` /
-* `REPO_ROOT` walked up a fixed number of `..` segments from this file).
-* Published as its own package and run through `pnpm dlx`, that assumption
-* breaks: this file's `import.meta.url` points into a dlx cache directory
-* or an isolated `node_modules` tree that has nothing to do with the repo
-* the contributor is standing in.
-*
-* So repo discovery walks up from `process.cwd()` instead, looking for the
-* marker validated in the `devtools-dlx` prototype
-* (`/home/sloan/scratchpad/devdogs/prototypes/devtools-dlx/FINDINGS.md`,
-* experiment 1): a directory containing `pnpm-workspace.yaml` AND whose
-* `package.json` has `"name": "devdogs-monorepo"` (DevDogsUGA) or
-* `"backstage"` (Backstage, which the CLIs also run from; `layout.ts` says
-* what differs). The name check is not redundant — a bare
-* `pnpm-workspace.yaml` matches any pnpm workspace, which devtools should
-* refuse rather than silently "find".
-*/
-/**
-* The `package.json` names a repo root may carry: DevDogsUGA's, and Backstage's
-* (the CLIs run from both; see `layout.ts`).
-*/
-const REPO_MARKER_NAMES = ["devdogs-monorepo", "backstage"];
-var RepoNotFoundError = class extends Error {
-	constructor() {
-		super("run this from inside a DevDogsUGA clone");
-		this.name = "RepoNotFoundError";
-	}
-};
-function looksLikeRepoRoot(dir) {
-	if (!existsSync(join(dir, "pnpm-workspace.yaml"))) return false;
-	try {
-		const pkg = JSON.parse(readFileSync(join(dir, "package.json"), "utf8"));
-		return REPO_MARKER_NAMES.includes(pkg.name);
-	} catch {
-		return false;
-	}
-}
-/**
-* Walks up from `startDir` (default `process.cwd()`) looking for the repo
-* marker. Returns `null` rather than throwing — `findRepoRoot()` below is
-* the throwing convenience most callers want; this is exported for callers
-* (like `setup`) that need to know without failing.
-*/
-function discoverRepoRoot(startDir = process.cwd()) {
-	let dir = startDir;
-	for (;;) {
-		if (looksLikeRepoRoot(dir)) return dir;
-		const parent = dirname(dir);
-		if (parent === dir) return null;
-		dir = parent;
-	}
-}
-let cachedRoot;
-/**
-* The memoized, throwing repo-root lookup. Lazy on purpose: importing this
-* module must never fail just because nothing has called it yet (`setup`
-* and `completions` in `launch.ts` never need a repo at all, and must stay
-* that way — see that file's header comment on why).
-*
-* Resolved once per process: `process.cwd()` does not change mid-invocation
-* for this CLI, and re-walking the filesystem on every call would be pure
-* waste.
-*/
-function findRepoRoot() {
-	if (cachedRoot === void 0) cachedRoot = process.env.DEVTOOLS_TEST_REPO_ROOT ?? discoverRepoRoot();
-	if (cachedRoot === null) throw new RepoNotFoundError();
-	return cachedRoot;
-}
-//#endregion
-export { noteError as a, ownPackageDir as c, JSON_FLAG as d, SCOPES as f, positionals as g, flagValue as h, installFailureLog as i, ownVersion as l, createCatalog as m, discoverRepoRoot as n, noteRan as o, YES as p, findRepoRoot as r, suppressFailureLog as s, RepoNotFoundError as t, cliName as u };
+export { isVersionRequest as a, cliName as c, YES as d, createCatalog as f, suppressFailureLog as i, JSON_FLAG as l, positionals as m, noteError as n, ownPackageDir as o, flagValue as p, noteRan as r, ownVersion as s, installFailureLog as t, SCOPES as u };

package/dist/launch.js

@@ -1,7 +1,8 @@
-import { i as installFailureLog, n as discoverRepoRoot, r as findRepoRoot, t as RepoNotFoundError, u as cliName } from "./root-CsocfxnK.js";
-import { A as helpPath, O as setProductMode, _ as bail, g as setMenuEnvHook, h as realEnvEntryDeps, k as catalog, m as enterSessionEnvironment, n as bareGroupStartPath, u as nonEmpty, v as errorMessage, w as findProductRoot, x as unwrap } from "./menu-C30rQm5v.js";
-import { D as formatCommand, M as resolveDryRun, N as setDryRun, _ as loadEnvLoad, j as isDryRun, v as loadEnvSession } from "./supabase-project-BoJKMCxL.js";
-import { d as hasYes, f as isNonInteractive, m as stripTierFlag, n as captureDevtoolsError, o as initDevtoolsTelemetry, p as stripNoEnvFlag, s as lastSentryEventId } from "./telemetry-BKFDtzXI.js";
+import { n as discoverRepoRoot, r as findRepoRoot, t as RepoNotFoundError } from "./root-PA8K5G2d.js";
+import { b as setDryRun, d as loadEnvLoad, f as loadEnvSession, m as formatCommand, v as isDryRun, y as resolveDryRun } from "./run-CRBte7p0.js";
+import { D as catalog, E as setProductMode, N as setEnvironmentRoot, O as helpPath, S as findProductRoot, c as nonEmpty, f as enterSessionEnvironment, g as errorMessage, h as bail, m as setMenuEnvHook, n as bareGroupStartPath, p as realEnvEntryDeps, y as unwrap } from "./menu-oQE5IqAI.js";
+import { a as isVersionRequest, c as cliName, t as installFailureLog } from "./failure-log-MSdCgvLc.js";
+import { c as lastSentryEventId, f as hasYes, h as stripTierFlag, m as stripNoEnvFlag, n as captureDevtoolsError, o as initDevtoolsTelemetry, p as isNonInteractive } from "./telemetry-BDTAGquh.js";
 import { confirm, select } from "@clack/prompts";
 //#region ../cli-core/src/session.ts
 /**
@@ -158,10 +159,20 @@ function isEnvFreeCommand(rest) {
 function skipsEnvEntry(rest) {
 	return declaredCommand(rest)?.noEnv === true;
 }
+/**
+* The one clear sentence for a command that needs a checkout when run from
+* somewhere that is neither a DevDogsUGA clone nor a product repository.
+* Printed and exited on directly, so it is never a stack trace or a Sentry
+* event: the person only needs to change directory.
+*/
+function outsideRepoMessage(rest) {
+	const path = helpPath(rest);
+	return `${path.length > 0 ? `\`devtools ${path.join(" ")}\`` : "`devtools`"} needs a DevDogsUGA clone or a product repository (one with a devtools.config.json, like DogDays or DogPack), and this directory is neither. \`devtools --help\` and \`devtools --version\` work anywhere.`;
+}
 /** The offer's stack start (`env-entry.ts` holds the TTY prompt, this holds
 * the lifecycle command), imported lazily like the rest of the commands. */
 async function startStack() {
-	const { runStackCommand } = await import("./stack-7qA2UP9g.js");
+	const { runStackCommand } = await import("./stack-Cl_B_dt7.js");
 	return runStackCommand("start");
 }
 /**
@@ -172,11 +183,11 @@ async function startStack() {
 * post-tier-resolution path.
 */
 async function dispatch(argv) {
-	const { main } = await import("./cli-BoTmTNqH.js");
+	const { main } = await import("./cli-DNZ-6WEI.js");
 	try {
 		await main(argv);
 	} catch (err) {
-		process.stderr.write(`devtools: ${errorMessage(err)}\n`);
+		process.stderr.write(`devtools: ${err instanceof RepoNotFoundError ? outsideRepoMessage(argv) : errorMessage(err)}\n`);
 		await captureDevtoolsError(err);
 		process.exit(1);
 	}
@@ -242,8 +253,10 @@ async function launch(argv) {
 	});
 	ignoreClosedPipes();
 	initDevtoolsTelemetry(rest[0] ?? "menu");
-	if (findProductRoot() !== null) {
+	const productRoot = findProductRoot();
+	if (productRoot !== null) {
 		setProductMode(true);
+		setEnvironmentRoot(productRoot);
 		process.env.DEPLOY_ENV = "development";
 		await dispatch(rest);
 		return;
@@ -253,10 +266,14 @@ async function launch(argv) {
 		await dispatch(rest);
 		return;
 	}
-	if (rest[0] === "version") {
+	if (isVersionRequest(rest)) {
 		await dispatch(rest);
 		return;
 	}
+	if (discoverRepoRoot() === null && rest[0] !== "setup" && rest[0] !== "completions" && !skipsEnvEntry(rest) && !isEnvFreeCommand(rest)) {
+		process.stderr.write(`devtools: ${outsideRepoMessage(rest)}\n`);
+		process.exit(1);
+	}
 	const envLoad = await loadEnvLoad();
 	const envSession = await loadEnvSession();
 	process.env[envLoad.SHELL_KEYS_ENV] ??= Object.keys(process.env).join(",");
@@ -303,7 +320,7 @@ async function launch(argv) {
 		return;
 	}
 	const run = () => gated(tier, rest, () => dispatch(rest), void 0);
-	if (noEnv || skipsEnvEntry(rest)) {
+	if (noEnv || skipsEnvEntry(rest) || isEnvFreeCommand(rest) && discoverRepoRoot() === null) {
 		process.env.DEPLOY_ENV = tier;
 		if (devDatabase !== void 0) process.env.DEV_DB = devDatabase;
 		await run();
@@ -313,4 +330,4 @@ async function launch(argv) {
 }
 if (import.meta.url === `file://${process.argv[1]}`) await launch(process.argv.slice(2));
 //#endregion
-export { launch, stripTierFlag };
+export { launch, outsideRepoMessage, stripTierFlag };

package/dist/{load-Cp8AMERM.js → load-Z2CXCpyx.js}

@@ -520,7 +520,10 @@ async function probeLocalStack(port = LOCAL_STACK_PORT, timeoutMs = 250) {
 * exiting the whole process out from under an unrelated caller would be a far
 * worse failure than a rejected promise.
 */
-async function findRepoRoot() {
+async function locateRepoRoot() {
+	const { discoverRepoRoot, RepoNotFoundError } = await import("./root-DfH38DFq.js");
+	const fromCwd = discoverRepoRoot();
+	if (fromCwd !== null) return fromCwd;
 	const { existsSync } = await import("node:fs");
 	const { dirname, join, resolve } = await import("node:path");
 	const { fileURLToPath } = await import("node:url");
@@ -528,7 +531,7 @@ async function findRepoRoot() {
 	for (;;) {
 		if (existsSync(join(dir, "pnpm-workspace.yaml"))) return dir;
 		const parent = dirname(dir);
-		if (parent === dir) throw new Error("loadEnvironment: could not locate the monorepo root (no pnpm-workspace.yaml found above this package).");
+		if (parent === dir) throw new RepoNotFoundError();
 		dir = parent;
 	}
 }
@@ -564,7 +567,7 @@ async function findRepoRoot() {
 */
 async function loadEnvironment(deployEnv, options, context) {
 	const override = options?.override ?? false;
-	const root = context?.root ?? await findRepoRoot();
+	const root = context?.root ?? await locateRepoRoot();
 	let exists = context?.exists;
 	if (!exists) {
 		const { existsSync } = await import("node:fs");
@@ -637,4 +640,4 @@ async function loadEnvironment(deployEnv, options, context) {
 	};
 }
 //#endregion
-export { fileFor as _, LocalStackOfflineError as a, applyDeployTierAliases as c, loadEnvironment as d, parseRawAssignments as f, UnknownEnvironmentError as g, DEPLOY_ENVIRONMENTS as h, LOCAL_STACK_PORT as i, applyWranglerLocalDatabaseAlias as l, selectEnvFiles as m, GENERATED_FILE as n, MissingEnvFileError as o, probeLocalStack as p, HYPERDRIVE_LOCAL_CONNECTION_ENV as r, SHELL_KEYS_ENV as s, DEV_DB_ENV as t, isDevDatabase as u, isDeployEnvironment as v };
+export { UnknownEnvironmentError as _, LocalStackOfflineError as a, applyDeployTierAliases as c, loadEnvironment as d, locateRepoRoot as f, DEPLOY_ENVIRONMENTS as g, selectEnvFiles as h, LOCAL_STACK_PORT as i, applyWranglerLocalDatabaseAlias as l, probeLocalStack as m, GENERATED_FILE as n, MissingEnvFileError as o, parseRawAssignments as p, HYPERDRIVE_LOCAL_CONNECTION_ENV as r, SHELL_KEYS_ENV as s, DEV_DB_ENV as t, isDevDatabase as u, fileFor as v, isDeployEnvironment as y };

package/dist/load-yn7JCcS2.js

@@ -0,0 +1,2 @@
+import { a as LocalStackOfflineError, c as applyDeployTierAliases, d as loadEnvironment, f as locateRepoRoot, h as selectEnvFiles, i as LOCAL_STACK_PORT, l as applyWranglerLocalDatabaseAlias, m as probeLocalStack, n as GENERATED_FILE, o as MissingEnvFileError, p as parseRawAssignments, r as HYPERDRIVE_LOCAL_CONNECTION_ENV, s as SHELL_KEYS_ENV, t as DEV_DB_ENV, u as isDevDatabase } from "./load-Z2CXCpyx.js";
+export { DEV_DB_ENV, GENERATED_FILE, HYPERDRIVE_LOCAL_CONNECTION_ENV, LOCAL_STACK_PORT, LocalStackOfflineError, MissingEnvFileError, SHELL_KEYS_ENV, applyDeployTierAliases, applyWranglerLocalDatabaseAlias, isDevDatabase, loadEnvironment, locateRepoRoot, parseRawAssignments, probeLocalStack, selectEnvFiles };