@devdogsuga/devtools 0.1.51-next.544 → 0.1.51-next.547

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-D98LfCHU.js → cli-CJtevyVy.js}

@@ -1,10 +1,10 @@
 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 { n as discoverRepoRoot, r as findRepoRoot } from "./root-RaJ8ECCO.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-D5iI9zve.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-CZK0L1Vf.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 { f as hasYes, n as captureDevtoolsError, o as initDevtoolsTelemetry, p as isNonInteractive } from "./telemetry-BDOwjuoC.js";
+import { t as runStackCommand } from "./stack-CzNe6rxl.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";
@@ -4920,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.
 */
@@ -4942,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");
@@ -7034,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
@@ -7043,7 +7058,7 @@ function commandLine(command, args) {
 function cliLine(cli, args) {
 	return commandLine(cli.command, [...cli.prefix, ...args]);
 }
-function versionOf(output) {
+function versionOf$1(output) {
 	return /\b(\d+\.\d+\.\d+)\b/.exec(output)?.[1] ?? null;
 }
 async function resolveSupabaseCli(root, pin, run, fileExists = existsSync) {
@@ -7061,7 +7076,14 @@ async function resolveSupabaseCli(root, pin, run, fileExists = existsSync) {
 	});
 	for (const candidate of candidates) try {
 		const result = await run(candidate.command, ["--version"], { cwd: root });
-		if (result.code === 0 && versionOf(result.stdout) === pin) return candidate;
+		if (result.code === 0 && versionOf$1(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",
@@ -7207,19 +7229,27 @@ async function resolveTarget(product, cli, run, preference) {
 * project, and the SQL runs in one transaction.
 */
 var DevDataError = class extends Error {
+	/** A failure the contributor or the product's SQL caused, not a devtools bug: never sent to Sentry. */
+	expected = true;
 	constructor(message) {
 		super(message);
 		this.name = "DevDataError";
 	}
 };
+/** A Postgres SQLSTATE: five characters, digits and capitals. Connection errors (`ECONNREFUSED`) are not. */
+function isSqlState(code) {
+	return typeof code === "string" && /^[0-9A-Z]{5}$/.test(code);
+}
 /**
-* 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.
+* The line of `text` a Postgres error points at, from the error's 1-based
+* character `position`, or null when it carries none.
 */
-function isMissingSchemaError(err) {
-	const code = err?.code;
-	return code === "42P01" || code === "3F000";
+function errorLine(err, text) {
+	const raw = err?.position;
+	const position = typeof raw === "string" ? Number(raw) : raw;
+	if (typeof position !== "number" || !Number.isInteger(position)) return null;
+	if (position < 1 || position > text.length + 1) return null;
+	return text.slice(0, position - 1).split("\n").length;
 }
 function postgresSession(dbUrl) {
 	const sql = postgres(dbUrl, {
@@ -7251,6 +7281,19 @@ function postgresSession(dbUrl) {
 				lastSignInAt: row.last_sign_in_at?.toISOString() ?? null
 			} : null;
 		},
+		async appliedMigrations() {
+			const [table] = await sql`
+        select to_regclass('supabase_migrations.schema_migrations')::text as present`;
+			if (!table?.present) return null;
+			return (await sql`
+        select version from supabase_migrations.schema_migrations`).map((r) => r.version);
+		},
+		async missingSchemas(schemas) {
+			const rows = await sql`
+        select nspname from pg_namespace where nspname = any(${[...schemas]})`;
+			const present = new Set(rows.map((r) => r.nspname));
+			return schemas.filter((name) => !present.has(name));
+		},
 		async runAs(memberId, text) {
 			await sql.begin(async (tx) => {
 				await tx`select set_config('devtools.member_id', ${memberId}, true)`;
@@ -7274,10 +7317,9 @@ async function runDevData(product, target, open, options) {
 	const text = readFileSync(file, "utf8");
 	const session = open(target.dbUrl);
 	try {
+		const missing = await session.missingSchemas(product.config.supabase.schemas);
+		if (missing.length > 0) throw new DevDataError(`This database does not have ${product.config.name}'s ${missing.length === 1 ? "schema" : "schemas"} yet (missing: ${missing.join(", ")}). Run \`devtools setup\` first, or \`devtools db sync\` if you have already set up.`);
 		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();
 	}
@@ -7290,7 +7332,13 @@ async function seed(session, file, text, options, log) {
 		log(`Would run ${file} (${text.split("\n").length} lines) in one transaction.`);
 		return null;
 	}
-	await session.runAs(member.id, text);
+	try {
+		await session.runAs(member.id, text);
+	} catch (err) {
+		if (!isSqlState(err?.code)) throw err;
+		const line = errorLine(err, text);
+		throw new DevDataError(`${file}${line === null ? "" : `:${line}`}: ${err.message}. This is a problem in the product's dev-data SQL, not in devtools; nothing was seeded (the file runs in one transaction).`);
+	}
 	return {
 		member,
 		file
@@ -7598,6 +7646,7 @@ async function dbSync(product, cli, target, run, options) {
 		const restored = migrationFiles(migrationsDir).length;
 		if (fetched.code === 0 && restored > 0) log(`Restored ${restored} applied migration${restored === 1 ? "" : "s"} from the project's history.`);
 	}
+	await reconcileRecord(product, cli, target, run, options, log);
 	const before = new Set(migrationFiles(migrationsDir));
 	let generated = await run(cli.command, generateArgs, { cwd: product.root });
 	if (generated.code !== 0 && isContainerFailure(generated)) {
@@ -7648,6 +7697,70 @@ async function dbSync(product, cli, target, run, options) {
 		destructive
 	};
 }
+/** `20261011120000` from `20261011120000_devtools_sync.sql`. */
+function versionOf(file) {
+	return file.split("_")[0] ?? file;
+}
+/**
+* Makes the local record agree with the database. The declarative diff only
+* compares `supabase/schemas` with `supabase/migrations`, so a database that
+* lost its contents behind the record's back (a hosted project reset from the
+* dashboard, a checkout switched from the local stack to a hosted project)
+* would read as "already matches". This asks the target:
+*
+*   - a migration in the record that is not in the database's ledger was never
+*     applied there: it is dropped from the record, so the diff re-creates it;
+*   - a configured schema that does not exist means the ledger is stale too:
+*     its entries are reverted and the whole record dropped, so the diff
+*     writes the full schema again.
+*
+* Nothing is reset or dropped in the database; only ledger rows of schemas
+* that are already gone are removed. A database that cannot be reached is
+* left to the apply step to report.
+*/
+async function reconcileRecord(product, cli, target, run, options, log) {
+	if (!options.open) return;
+	const { migrationsDir } = product.paths;
+	const files = migrationFiles(migrationsDir);
+	let ledger;
+	let missing;
+	let session;
+	try {
+		session = options.open(target.dbUrl);
+		ledger = await session.appliedMigrations();
+		missing = await session.missingSchemas(product.config.supabase.schemas);
+	} catch (err) {
+		log(`Could not check what the database has applied (${err.message}); trusting the local record.`);
+		return;
+	} finally {
+		await session?.close().catch(() => void 0);
+	}
+	if (missing.length > 0) {
+		const stale = ledger ?? [];
+		log(`The database is missing ${missing.length === 1 ? "schema" : "schemas"} ${missing.join(", ")}, so the record of applied migrations is out of date; rebuilding it from supabase/schemas.`);
+		if (stale.length > 0) {
+			const reverted = await run(cli.command, [
+				...cli.prefix,
+				"migration",
+				"repair",
+				"--status",
+				"reverted",
+				"--db-url",
+				target.dbUrl,
+				...stale
+			], { cwd: product.root });
+			if (reverted.code !== 0) throw new SyncError("The database lost its schema but its migration history still lists migrations as applied, and clearing that history failed.", reverted.stderr || reverted.stdout);
+		}
+		for (const file of files) rmSync(join(migrationsDir, file));
+		return;
+	}
+	const applied = new Set(ledger ?? []);
+	const unapplied = files.filter((file) => !applied.has(versionOf(file)));
+	if (unapplied.length > 0) {
+		log(`${unapplied.length} migration${unapplied.length === 1 ? "" : "s"} in the local record ${unapplied.length === 1 ? "is" : "are"} not in this database's history (it was reset, or this checkout switched databases); re-applying ${unapplied.length === 1 ? "it" : "them"}.`);
+		for (const file of unapplied) rmSync(join(migrationsDir, file));
+	}
+}
 function isContainerFailure(result) {
 	return /docker|container|image/i.test(result.stderr + result.stdout);
 }
@@ -7910,7 +8023,8 @@ async function runSync(product, deps, rest) {
 		yes: hasYes(rest),
 		confirmDestructive: deps.interactive() ? confirmDestructive : void 0,
 		dryRun,
-		log: (line) => log.info(line)
+		log: (line) => log.info(line),
+		open: deps.openSql
 	});
 	if (rest.includes("--rebuild") && !dryRun) try {
 		const row = await reRegisterSavedProvider(product.paths.toolingFile, target);
@@ -8051,7 +8165,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",
@@ -8211,7 +8325,8 @@ async function runSetup(product, deps, rest) {
 	const result = await dbSync(product, cli, target, deps.run, {
 		yes: hasYes(rest),
 		confirmDestructive: deps.interactive() ? confirmDestructive : void 0,
-		log: (line) => log.info(line)
+		log: (line) => log.info(line),
+		open: deps.openSql
 	});
 	log.success(result.migration ? "Applied supabase/schemas to your database." : "Your database already matched supabase/schemas.");
 	if (target.kind === "local") await waitForRest(target, deps, product);

package/dist/launch.js

@@ -1,8 +1,8 @@
-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 { i as markOutsideCheckout, n as discoverRepoRoot, r as findRepoRoot, t as RepoNotFoundError } from "./root-RaJ8ECCO.js";
+import { b as setDryRun, d as loadEnvLoad, f as loadEnvSession, m as formatCommand, v as isDryRun, y as resolveDryRun } from "./run-D5iI9zve.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-CZK0L1Vf.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 { c as lastSentryEventId, f as hasYes, h as stripTierFlag, m as stripNoEnvFlag, n as captureDevtoolsError, o as initDevtoolsTelemetry, p as isNonInteractive } from "./telemetry-BDOwjuoC.js";
 import { confirm, select } from "@clack/prompts";
 //#region ../cli-core/src/session.ts
 /**
@@ -172,7 +172,7 @@ function outsideRepoMessage(rest) {
 /** 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-Cl_B_dt7.js");
+	const { runStackCommand } = await import("./stack-VZ-1SmuM.js");
 	return runStackCommand("start");
 }
 /**
@@ -183,11 +183,12 @@ async function startStack() {
 * post-tier-resolution path.
 */
 async function dispatch(argv) {
-	const { main } = await import("./cli-D98LfCHU.js");
+	const { main } = await import("./cli-CJtevyVy.js");
 	try {
 		await main(argv);
 	} catch (err) {
-		process.stderr.write(`devtools: ${err instanceof RepoNotFoundError ? outsideRepoMessage(argv) : errorMessage(err)}\n`);
+		const outside = markOutsideCheckout(err);
+		process.stderr.write(`devtools: ${outside ? outsideRepoMessage(argv) : errorMessage(err)}\n`);
 		await captureDevtoolsError(err);
 		process.exit(1);
 	}

package/dist/{load-yn7JCcS2.js → load-aeN4iX1h.js}

@@ -1,2 +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";
+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-lrgJ5Kz7.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 };

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

@@ -521,7 +521,7 @@ async function probeLocalStack(port = LOCAL_STACK_PORT, timeoutMs = 250) {
 * worse failure than a rejected promise.
 */
 async function locateRepoRoot() {
-	const { discoverRepoRoot, RepoNotFoundError } = await import("./root-DfH38DFq.js");
+	const { discoverRepoRoot, RepoNotFoundError } = await import("./root-IVsv7i8N.js");
 	const fromCwd = discoverRepoRoot();
 	if (fromCwd !== null) return fromCwd;
 	const { existsSync } = await import("node:fs");

package/dist/{menu-oQE5IqAI.js → menu-CZK0L1Vf.js}

@@ -1,8 +1,8 @@
 import { n as execSync } from "./spawn-BvLQzc_K.js";
-import { n as discoverRepoRoot } from "./root-PA8K5G2d.js";
-import { C as containerPrefix, D as readProjectId, E as listContainerNames, P as resolveLayout, S as STACK_API_PORT, T as foreignStackProjectId, d as loadEnvLoad, k as devdogsugaRootOrNull, s as supabaseCapture, u as loadEnv, w as foreignStackMessage } from "./run-CRBte7p0.js";
+import { n as discoverRepoRoot } from "./root-RaJ8ECCO.js";
+import { C as containerPrefix, D as readProjectId, E as listContainerNames, P as resolveLayout, S as STACK_API_PORT, T as foreignStackProjectId, d as loadEnvLoad, k as devdogsugaRootOrNull, s as supabaseCapture, u as loadEnv, w as foreignStackMessage } from "./run-D5iI9zve.js";
 import { d as YES, f as createCatalog, i as suppressFailureLog, l as JSON_FLAG, m as positionals, u as SCOPES } from "./failure-log-MSdCgvLc.js";
-import { l as reportDevtoolsError, p as isNonInteractive } from "./telemetry-BDTAGquh.js";
+import { l as reportDevtoolsError, p as isNonInteractive } from "./telemetry-BDOwjuoC.js";
 import { existsSync, readFileSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
 import { z } from "zod";

package/dist/{root-DfH38DFq.js → root-IVsv7i8N.js}

@@ -1,2 +1,2 @@
-import { n as discoverRepoRoot, t as RepoNotFoundError } from "./root-PA8K5G2d.js";
+import { n as discoverRepoRoot, t as RepoNotFoundError } from "./root-RaJ8ECCO.js";
 export { RepoNotFoundError, discoverRepoRoot };

package/dist/{root-PA8K5G2d.js → root-RaJ8ECCO.js}

@@ -73,5 +73,17 @@ function findRepoRoot() {
 	if (cachedRoot === null) throw new RepoNotFoundError();
 	return cachedRoot;
 }
+/**
+* Whether `err` is the user running a checkout-requiring command with no
+* DevDogsUGA checkout above the working directory, and if so marks it
+* `expected` so telemetry drops it. A `RepoNotFoundError` raised while a
+* checkout does exist (a `findRepoRoot()` call that should not have needed
+* one, as in DEVTOOLS-D) is a bug and stays reportable.
+*/
+function markOutsideCheckout(err, startDir = process.cwd()) {
+	if (!(err instanceof RepoNotFoundError) || discoverRepoRoot(startDir) !== null) return false;
+	Object.assign(err, { expected: true });
+	return true;
+}
 //#endregion
-export { discoverRepoRoot as n, findRepoRoot as r, RepoNotFoundError as t };
+export { markOutsideCheckout as i, discoverRepoRoot as n, findRepoRoot as r, RepoNotFoundError as t };

package/dist/{run-CRBte7p0.js → run-D5iI9zve.js}

@@ -1,5 +1,5 @@
 import { n as execSync, r as spawnProcess, t as exec } from "./spawn-BvLQzc_K.js";
-import { r as findRepoRoot, t as RepoNotFoundError } from "./root-PA8K5G2d.js";
+import { r as findRepoRoot, t as RepoNotFoundError } from "./root-RaJ8ECCO.js";
 import { c as cliName, r as noteRan } from "./failure-log-MSdCgvLc.js";
 import { createRequire } from "node:module";
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
@@ -631,11 +631,11 @@ function getEnvSync() {
 }
 /** The env loader (`loadEnvironment` and the tier/file selection). Bundled. */
 function loadEnvLoad() {
-	return import("./load-yn7JCcS2.js");
+	return import("./load-aeN4iX1h.js");
 }
 /** The session policy (tier resolution, `enterEnvironment`). Bundled. */
 function loadEnvSession() {
-	return import("./session-DzgtIg6K.js");
+	return import("./session-DdF8eqv3.js");
 }
 //#endregion
 //#region ../cli-core/src/db/run.ts

package/dist/{session-DzgtIg6K.js → session-DdF8eqv3.js}

@@ -1,2 +1,2 @@
-import { a as parseSessionSelector, c as rememberDevDatabase, i as enterEnvironment, l as rememberedDevDatabase, n as availableTiers, o as resolveSessionTier, r as developmentRemoteCandidate, s as askSession, t as SESSION_SELECTORS } from "./session-CuexI1f9.js";
+import { a as parseSessionSelector, c as rememberDevDatabase, i as enterEnvironment, l as rememberedDevDatabase, n as availableTiers, o as resolveSessionTier, r as developmentRemoteCandidate, s as askSession, t as SESSION_SELECTORS } from "./session-bPPOkolU.js";
 export { SESSION_SELECTORS, askSession, availableTiers, developmentRemoteCandidate, enterEnvironment, parseSessionSelector, rememberDevDatabase, rememberedDevDatabase, resolveSessionTier };

package/dist/{session-CuexI1f9.js → session-bPPOkolU.js}

@@ -1,4 +1,4 @@
-import { d as loadEnvironment, g as DEPLOY_ENVIRONMENTS, m as probeLocalStack, p as parseRawAssignments, t as DEV_DB_ENV, u as isDevDatabase, v as fileFor, y as isDeployEnvironment } from "./load-Z2CXCpyx.js";
+import { d as loadEnvironment, g as DEPLOY_ENVIRONMENTS, m as probeLocalStack, p as parseRawAssignments, t as DEV_DB_ENV, u as isDevDatabase, v as fileFor, y as isDeployEnvironment } from "./load-lrgJ5Kz7.js";
 //#region ../cli-core/src/env-runtime/ask.ts
 /**
 * The interactive half of session resolution, shared by `with-env` and the

package/dist/{stack-BRevXgI3.js → stack-CzNe6rxl.js}

@@ -1,4 +1,4 @@
-import { D as readProjectId, E as listContainerNames, P as resolveLayout, S as STACK_API_PORT, T as foreignStackProjectId, a as seedBuckets, d as loadEnvLoad, f as loadEnvSession, o as supabase, s as supabaseCapture, v as isDryRun, w as foreignStackMessage } from "./run-CRBte7p0.js";
+import { D as readProjectId, E as listContainerNames, P as resolveLayout, S as STACK_API_PORT, T as foreignStackProjectId, a as seedBuckets, d as loadEnvLoad, f as loadEnvSession, o as supabase, s as supabaseCapture, v as isDryRun, w as foreignStackMessage } from "./run-D5iI9zve.js";
 import { join } from "node:path";
 import { writeFile } from "node:fs/promises";
 //#region src/db/session-refresh.ts

package/dist/stack-VZ-1SmuM.js

@@ -0,0 +1,2 @@
+import { t as runStackCommand } from "./stack-CzNe6rxl.js";
+export { runStackCommand };

package/dist/{telemetry-BDTAGquh.js → telemetry-BDOwjuoC.js}

@@ -1,4 +1,4 @@
-import { n as discoverRepoRoot, t as RepoNotFoundError } from "./root-PA8K5G2d.js";
+import { n as discoverRepoRoot } from "./root-RaJ8ECCO.js";
 import { c as cliName, n as noteError, s as ownVersion } from "./failure-log-MSdCgvLc.js";
 import { readFileSync } from "node:fs";
 import * as Sentry from "@sentry/node";
@@ -301,7 +301,9 @@ function hasRealCaller(inRepo, isTTY) {
 }
 /**
 * A failure the person caused and can fix without anyone's help: the wrong
-* directory, a bad flag, a database that has not been set up. These are
+* directory, a bad flag, a database that has not been set up. A `RepoNotFoundError` is
+* not on this list by class: only the dispatcher marks the genuine
+* outside-a-checkout case `expected` (`markOutsideCheckout`). These are
 * printed and exit non-zero but are not bugs, so they are never sent to Sentry
 * (the failure log still records them). Matched by name as well as class so
 * that `UsageError` (`ui.ts`, which imports this module) and the product
@@ -309,7 +311,6 @@ function hasRealCaller(inRepo, isTTY) {
 * opts in by setting `expected = true`.
 */
 function isExpectedFailure(err) {
-	if (err instanceof RepoNotFoundError) return true;
 	if (!(err instanceof Error)) return false;
 	return err.name === "UsageError" || err.expected === true;
 }

package/dist/telemetry.js

@@ -1,2 +1,2 @@
-import { a as hasRealCaller, c as lastSentryEventId, d as resolveDevtoolsDsn, i as devtoolsTelemetryEnabled, l as reportDevtoolsError, n as captureDevtoolsError, o as initDevtoolsTelemetry, r as devtoolsEnvironment, s as isExpectedFailure, t as captureDevtoolsDeprecation, u as reportDevtoolsFailure } from "./telemetry-BDTAGquh.js";
+import { a as hasRealCaller, c as lastSentryEventId, d as resolveDevtoolsDsn, i as devtoolsTelemetryEnabled, l as reportDevtoolsError, n as captureDevtoolsError, o as initDevtoolsTelemetry, r as devtoolsEnvironment, s as isExpectedFailure, t as captureDevtoolsDeprecation, u as reportDevtoolsFailure } from "./telemetry-BDOwjuoC.js";
 export { captureDevtoolsDeprecation, captureDevtoolsError, devtoolsEnvironment, devtoolsTelemetryEnabled, hasRealCaller, initDevtoolsTelemetry, isExpectedFailure, lastSentryEventId, reportDevtoolsError, reportDevtoolsFailure, resolveDevtoolsDsn };

package/dist/with-env.js

@@ -1,6 +1,6 @@
 import { r as spawnProcess, t as exec } from "./spawn-BvLQzc_K.js";
-import { _ as UnknownEnvironmentError, a as LocalStackOfflineError, c as applyDeployTierAliases, d as loadEnvironment, l as applyWranglerLocalDatabaseAlias, m as probeLocalStack, n as GENERATED_FILE, o as MissingEnvFileError } from "./load-Z2CXCpyx.js";
-import { n as availableTiers, s as askSession, t as SESSION_SELECTORS } from "./session-CuexI1f9.js";
+import { _ as UnknownEnvironmentError, a as LocalStackOfflineError, c as applyDeployTierAliases, d as loadEnvironment, l as applyWranglerLocalDatabaseAlias, m as probeLocalStack, n as GENERATED_FILE, o as MissingEnvFileError } from "./load-lrgJ5Kz7.js";
+import { n as availableTiers, s as askSession, t as SESSION_SELECTORS } from "./session-bPPOkolU.js";
 import { createRequire } from "node:module";
 import { existsSync, statSync, writeFileSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@devdogsuga/devtools",
-  "version": "0.1.51-next.544",
+  "version": "0.1.51-next.547",
   "private": false,
   "type": "module",
-  "description": "Contributor CLI for DevDogs repositories (the platform monorepo, DogDays, DogPack): the real tools with the session's tier filled in, `setup`, `db sync`, `db types`, `dev-data`, a menu over them, the checks CI runs, and the `with-env` launcher. Ships built JS; run via `pnpm dlx @devdogsuga/devtools` or `npx @devdogsuga/devtools` (or the `devtools` bin once installed) from inside a clone.",
+  "description": "Contributor CLI for DevDogs repositories (the platform monorepo, DogDays, DogPack): the real tools with the session's tier filled in, `setup`, `db sync`, `db types`, `dev-data`, a menu over them, the checks CI runs, and the `with-env` launcher. Ships built JS; run via `pnpm devtools` in a product repo, `pnpm dlx @devdogsuga/devtools` (or the `devtools` bin once installed) from inside a clone.",
   "license": "BSD-3-Clause",
   "repository": {
     "type": "git",

package/dist/stack-Cl_B_dt7.js

@@ -1,2 +0,0 @@
-import { t as runStackCommand } from "./stack-BRevXgI3.js";
-export { runStackCommand };