@devdogsuga/devtools 0.1.38 → 0.1.40

package/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2026 DevDogs at UGA contributors
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/bin/devtools.mjs

@@ -14,17 +14,9 @@
  * only programmatically (`src/repo/tsx-loader.ts`) to load that repo's own
  * TypeScript (env manifests, cron contracts, `devdogs-source` packages).
  */
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const launchEntry = join(
-  dirname(fileURLToPath(import.meta.url)),
-  "..",
-  "dist",
-  "launch.js",
-);
-
-const { launch } = await import(launchEntry);
+// Relative specifiers, not joined paths: `import()` takes URLs, and a Windows
+// absolute path (`C:\...`) reads as the URL scheme `c:`.
+const { launch } = await import("../dist/launch.js");
 try {
   await launch(process.argv.slice(2));
 } catch (err) {
@@ -33,9 +25,7 @@ try {
   process.stderr.write(
     `devtools: ${err instanceof Error ? err.message : String(err)}\n`,
   );
-  const { captureDevtoolsError } = await import(
-    join(dirname(fileURLToPath(import.meta.url)), "..", "dist", "telemetry.js")
-  );
+  const { captureDevtoolsError } = await import("../dist/telemetry.js");
   await captureDevtoolsError(err);
   process.exitCode = 1;
 }

package/dist/launch.js

@@ -1,5 +1,5 @@
 import { a as cliName, t as installFailureLog } from "./failure-log-B5GG_8T1.js";
-import { C as helpPath, S as catalog, g as setMenuEnvHook, h as realEnvEntryDeps, m as enterSessionEnvironment, n as bareGroupStartPath, u as nonEmpty, v as errorMessage, x as unwrap } from "./menu-Craj11Sn.js";
+import { C as helpPath, S as catalog, _ as bail, g as setMenuEnvHook, h as realEnvEntryDeps, m as enterSessionEnvironment, n as bareGroupStartPath, u as nonEmpty, v as errorMessage, x as unwrap } from "./menu-Craj11Sn.js";
 import { b as setDryRun, m as formatCommand, v as isDryRun, y as resolveDryRun } from "./supabase-project-Bw8sBFcE.js";
 import { n as discoverRepoRoot, r as findRepoRoot, t as RepoNotFoundError } from "./root-C2OmZDwD.js";
 import { i as loadEnvSession, r as loadEnvLoad } from "./peers-RBplwovA.js";
@@ -197,6 +197,27 @@ async function gated(tier, commandArgv, proceed, blocked) {
 	return proceed();
 }
 /**
+* The session resolution from before `askSession` existed, for a repo whose
+* `@devdogsuga/env` does not have it yet: the development database is asked
+* about every time and never remembered.
+*/
+async function resolveAskingEveryTime(envSession, envLoad, opts) {
+	const deployEnv = process.env.DEPLOY_ENV ?? "";
+	const remoteCandidate = (process.env.DEV_DB ?? "") === "" && (opts.explicit === "development" || opts.explicit === void 0 && (deployEnv === "" || deployEnv === "development")) ? await envSession.developmentRemoteCandidate(opts.root) : void 0;
+	const localStackOnline = typeof remoteCandidate === "string" ? await envLoad.probeLocalStack() : void 0;
+	return envSession.resolveSessionTier({
+		explicit: opts.explicit,
+		deployEnv: process.env.DEPLOY_ENV,
+		devDb: process.env.DEV_DB,
+		available: opts.available,
+		isTTY: process.stdin.isTTY === true,
+		prompt: promptTier,
+		promptMessage: "Which environment should this session use?",
+		remoteCandidate,
+		localStackOnline
+	});
+}
+/**
 * Resolves the session's deploy tier, enters it (or defers entry to the
 * menu — see this file's header), and hands off to `cli.ts`.
 *
@@ -238,19 +259,22 @@ async function launch(argv) {
 			process.stderr.write("devtools: no tier named. With no terminal (or CI=true) the tier must be explicit: pass --tier <development:local|development:remote|staging|production> or set DEPLOY_ENV.\n");
 			process.exit(1);
 		}
-		const deployEnv = process.env.DEPLOY_ENV ?? "";
-		const remoteCandidate = !noEnv && (process.env.DEV_DB ?? "") === "" && (explicit === "development" || explicit === void 0 && (deployEnv === "" || deployEnv === "development")) ? await envSession.developmentRemoteCandidate(findRepoRoot()) : void 0;
-		const localStackOnline = typeof remoteCandidate === "string" ? await envLoad.probeLocalStack() : void 0;
-		const resolution = noEnv ? resolveWithoutEnv(envSession, explicit) : await envSession.resolveSessionTier({
+		const repoRoot = findRepoRoot();
+		const available = noEnv ? [] : await envSession.availableTiers(repoRoot);
+		const resolution = noEnv ? resolveWithoutEnv(envSession, explicit) : typeof envSession.askSession === "function" ? await envSession.askSession({
+			root: repoRoot,
 			explicit,
 			deployEnv: process.env.DEPLOY_ENV,
 			devDb: process.env.DEV_DB,
-			available: await envSession.availableTiers(findRepoRoot()),
-			isTTY: process.stdin.isTTY === true,
-			prompt: promptTier,
-			promptMessage: "Which environment should this session use?",
-			remoteCandidate,
-			localStackOnline
+			available,
+			canAsk: !isNonInteractive(),
+			unanswered: "refuse",
+			name: "devtools",
+			onCancel: () => bail()
+		}) : await resolveAskingEveryTime(envSession, envLoad, {
+			root: repoRoot,
+			explicit,
+			available
 		});
 		if (!resolution.ok) {
 			process.stderr.write(`devtools: ${resolution.reason}\n`);

package/env.ts

@@ -148,6 +148,16 @@ declare({
       scope: "developer",
       secrecy: "public",
     }),
+    DEV_DB: define(z.enum(["local", "remote"]).optional(), {
+      doc:
+        "Which development database this machine uses when .env names a " +
+        "remote DB_URL: local (the Docker stack) or remote (that DB_URL). " +
+        "Written by the first-run question in with-env and devtools when " +
+        'you choose "Remember my decision"; delete it to be asked again. ' +
+        "An exported DEV_DB, or --tier development:local|remote, wins.",
+      scope: "developer",
+      secrecy: "public",
+    }),
     SKIP_ENV_VALIDATION: define(z.string().optional(), {
       doc:
         "Any non-empty value skips env-schema validation, for builds that " +

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@devdogsuga/devtools",
-  "version": "0.1.38",
+  "version": "0.1.40",
   "private": false,
   "type": "module",
   "description": "Contributor CLI for a DevDogsUGA checkout: the real tools with the session's tier filled in, a menu over them, and the checks CI runs. Ships built JS; run via `pnpm dlx @devdogsuga/devtools` (or the `devtools` bin once installed) from inside a DevDogsUGA clone.",
-  "license": "MIT",
+  "license": "BSD-3-Clause",
   "repository": {
     "type": "git",
     "url": "https://github.com/DevDogsUGA/Backstage.git",
@@ -31,7 +31,7 @@
     "tsx": "^4.23.12",
     "typescript": "^6.0.3",
     "zod": "4.4.3",
-    "@devdogsuga/telemetry": "0.1.4"
+    "@devdogsuga/telemetry": "0.1.5"
   },
   "peerDependencies": {
     "@devdogsuga/db": "*",
@@ -51,10 +51,10 @@
     "eslint": "^9.39.5",
     "tsdown": "^0.23.0",
     "vitest": "^4.1.11",
-    "@devdogsuga/db": "0.1.3",
-    "@devdogsuga/env": "0.1.5",
     "@devdogsuga/cli-core": "0.0.0",
-    "@devdogsuga/config": "0.1.2"
+    "@devdogsuga/config": "0.1.3",
+    "@devdogsuga/env": "0.1.6",
+    "@devdogsuga/db": "0.1.4"
   },
   "scripts": {
     "build": "tsdown && node scripts/write-build-info.mjs && node ../../scripts/check-bundle-imports.mjs",