@dbx-tools/core 0.6.87 → 0.6.89

package/src/config.ts

@@ -3,8 +3,8 @@
  *
  * Every package resolves settings the same way: take the caller's value, else
  * an environment variable, else a default. Local development adds two fallback
- * locations: `.env` files and `resources.apps.<app>.config.env` or root
- * `variables` in `databricks.yml`.
+ * locations: `.env` files and one App's `resources.apps.<app>.config.env` in
+ * `databricks.yml`.
  *
  * Two things make it cheap to call from a hot path:
  *
@@ -20,24 +20,6 @@
  * CLI is not on the image. Boolean environment overrides can force either file
  * source on or off when a tool needs different behavior.
  *
- * The bundle is gated on this being an AppKit project at all. `databricks bundle
- * validate` is a process spawn measured in seconds, and a plain library or CLI
- * consumer has no bundle to find, so the gate runs in three steps before the
- * spawn is allowed - see {@link bundleFile}:
- *
- *   1. `@databricks/appkit` is resolved WITHOUT evaluating it. It is an optional
- *      peer, so a consumer that never installed it is not an AppKit project and
- *      the bundle is never loaded. The probe is cached, so this costs one
- *      resolution for the life of the process.
- *   2. The bundle is read (once per context) and must describe EXACTLY ONE app
- *      with `config.env`. Nothing here says which of several apps this process
- *      is, so an ambiguous bundle contributes nothing rather than a guess.
- *   3. AppKit's execution context confirms this process really is that app. The
- *      context does not exist until AppKit boots and `getExecutionContext()`
- *      THROWS until then, so the probe is caught and only the affirmative is
- *      remembered - a lookup before boot still resolves, and re-confirms later
- *      once the context is available.
- *
  * Only the single app's `config.env` is consulted. Root bundle `variables` are
  * not: they are authoring inputs for the bundle itself (interpolated into
  * targets, resources, and paths), so treating one as a process setting resolves
@@ -50,16 +32,14 @@
 
 import { spawnSync } from "node:child_process";
 import { readFileSync } from "node:fs";
-import { createRequire } from "node:module";
 import { dirname, isAbsolute, relative, resolve, sep } from "node:path";
 import { parseEnv } from "node:util";
 import {
   context,
-  functionModule,
   json,
   log,
   object,
-  string as stringModule,
+  string as sharedString,
 } from "@dbx-tools/shared-core";
 import { z } from "zod";
 import { statSync } from "./file.ts";
@@ -67,22 +47,22 @@ import { root as resolveProjectRoot } from "./project.ts";
 
 const logger = log.logger("config");
 
-export type ConfigKey = string | readonly string[];
+type ConfigKey = string | readonly string[];
 
 /** Where a value may come from, consulted in the order given. */
-export type ConfigSource = "env" | "dotenv" | "bundle";
+type ConfigSource = "env" | "dotenv" | "bundle";
 
-export interface ConfigOptions {
+interface ConfigOptions {
   /**
    * Outermost namespaces tried before each key. Defaults to `DBX_TOOLS`.
    */
   scope?: string | readonly string[];
   /** Capability namespaces inserted after the scope and before each key. */
   prefix?: string | readonly string[];
-  /** Directory to resolve `.env` and the bundle from. Default: `process.cwd()`. */
-  cwd?: string;
   /** Sources in precedence order. Default: `env`, `dotenv`, `bundle`. */
   sources?: ConfigSource | readonly ConfigSource[];
+  /** Directory to resolve `.env` and the bundle from. Default: `process.cwd()`. */
+  cwd?: string;
 }
 
 /** One resolved value, tagged with the key and source it came from. */
@@ -93,7 +73,7 @@ interface ConfigValue {
 }
 
 /** A config file found on disk, with its parsed contents. */
-export interface ConfigFile {
+interface ConfigFile {
   path: string;
   data: Record<string, unknown>;
 }
@@ -111,51 +91,50 @@ const NODE_ENV_ALTERNATIVES = {
 export const MAX_TCP_PORT = 65_535;
 
 /** Boolean environment override for {@link isDatabricksAppEnv}. */
-export const DATABRICKS_APP_ENV_KEY = "DBX_TOOLS_DATABRICKS_APP_ENV";
+const DATABRICKS_APP_ENV_KEY = "DBX_TOOLS_DATABRICKS_APP_ENV";
 
 /** Boolean environment override for project `.env` reads. */
-export const CONFIG_DOTENV_KEY = "DBX_TOOLS_CONFIG_DOTENV";
+const CONFIG_DOTENV_KEY = "DBX_TOOLS_CONFIG_DOTENV";
 
 /** Boolean environment override for Databricks bundle reads. */
-export const CONFIG_BUNDLE_KEY = "DBX_TOOLS_CONFIG_BUNDLE";
-
-/**
- * The OPTIONAL AppKit peer whose presence marks this as a Databricks App
- * project. Held as a constant so the resolve probe and the lazy import name it
- * once, and so neither site carries a literal a bundler would try to follow.
- */
-const APPKIT_MODULE = "@databricks/appkit";
-
-/**
- * The one thing this module needs from AppKit: whether a real execution context
- * is active. Typed structurally so an OPTIONAL peer never becomes a type
- * dependency, and `client` is `unknown` because its presence is all that is read.
- */
-type AppKitModule = {
-  getExecutionContext(): { client?: unknown } | undefined;
-};
-
-/**
- * Whether AppKit's execution context has EVER been observed. Latching is the
- * point: a context confirms this process is the bundle's app, and that fact does
- * not stop being true when a later lookup happens outside a request scope.
- */
-let appKitContext = false;
-
-/** Flattened App `config.env` per parsed bundle - see {@link bundleApp}. */
-const BUNDLE_APP_CACHE = new WeakMap<object, Record<string, string>>();
+const CONFIG_BUNDLE_KEY = "DBX_TOOLS_CONFIG_BUNDLE";
 
 /** Exact process-environment lookup for callers that do not read local config files. */
 export const ENV_ONLY = { scope: [] as const, sources: "env" as const };
 
-export const bundleValue = z
+export const valueSchema = z
   .string()
-  .transform((value: string) => value.trim())
-  .refine((value: string) => value.length > 0)
+  .trim()
+  .min(1)
   .refine((value: string) => !/\$\{[^}]+\}/.test(value), {
     message: "Interpolated values are not allowed",
   });
 
+const portValueSchema = z.preprocess(
+  (input) => object.toNumber(input),
+  z.number().int().min(1).max(MAX_TCP_PORT),
+);
+
+const positiveNumberValue = z.preprocess((input) => object.toNumber(input), z.number().positive());
+const positiveIntValue = positiveNumberValue.transform(Math.floor);
+
+const workspaceHostSchema = valueSchema.refine(
+  (host) => {
+    try {
+      return ["http:", "https:"].includes(new URL(host).protocol);
+    } catch {
+      return false;
+    }
+  },
+  { message: "Must be an HTTP(S) URL" },
+);
+
+const databricksAppEnvSchema = z.object({
+  DATABRICKS_APP_NAME: valueSchema,
+  DATABRICKS_HOST: workspaceHostSchema,
+  DATABRICKS_APP_PORT: portValueSchema,
+});
+
 /**
  * The GENERIC shape of a bundle resource: a name, and whatever else the resource
  * type carries. Deliberately unopinionated and `passthrough()` - the concrete
@@ -163,24 +142,35 @@ export const bundleValue = z
  * Databricks-App concepts that belong to the package that resolves them, so
  * node-appkit `.extend()`s this rather than this module knowing about them.
  */
-export const bundleResourceSchema = z.object({ name: bundleValue.optional() }).passthrough();
+export const bundleResourceSchema = z.object({ name: valueSchema.optional() }).passthrough();
 
 export const bundleEnvEntrySchema = z.object({
-  name: bundleValue.optional(),
+  name: valueSchema.optional(),
   value: z.string().optional(),
-  value_from: bundleValue.optional(),
+  value_from: valueSchema.optional(),
 });
 
 export const bundleAppSchema = z.object({
-  name: bundleValue.optional(),
-  source_code_path: z.string().optional(),
+  name: valueSchema.optional(),
   config: z.object({ env: z.array(bundleEnvEntrySchema).optional() }).optional(),
   resources: z.array(bundleResourceSchema).optional(),
 });
 
-const bundleAppsSchema = z.object({
-  resources: z.object({ apps: z.record(z.string(), bundleAppSchema).optional() }).optional(),
-});
+const bundleAppConfigEnvSchema = z
+  .object({
+    resources: z.object({ apps: z.record(z.string(), bundleAppSchema).optional() }).optional(),
+  })
+  .transform((bundle): Record<string, string> => {
+    const apps = Object.values(bundle.resources?.apps ?? {});
+    if (apps.length !== 1) return {};
+    return Object.fromEntries(
+      (apps[0]?.config?.env ?? []).flatMap((entry) => {
+        if (!entry.name) return [];
+        const parsed = valueSchema.safeParse(entry.value);
+        return parsed.success ? ([[entry.name, parsed.data]] as const) : [];
+      }),
+    );
+  });
 
 /**
  * Detect a Databricks App runtime from its required name, host, and port.
@@ -195,48 +185,51 @@ export function isDatabricksAppEnv(
 ): boolean {
   const override = object.toBoolean(source[DATABRICKS_APP_ENV_KEY]);
   if (override !== undefined) return override;
-  const appName = source.DATABRICKS_APP_NAME?.trim();
-  const host = source.DATABRICKS_HOST?.trim();
-  const port = source.DATABRICKS_APP_PORT?.trim();
-  if (!appName || !host || !port) return false;
-  try {
-    if (!["http:", "https:"].includes(new URL(host).protocol)) return false;
-  } catch {
-    return false;
-  }
-  const portNumber = object.toNumber(port);
-  return (
-    portNumber !== undefined &&
-    Number.isInteger(portNumber) &&
-    portNumber >= 1 &&
-    portNumber <= MAX_TCP_PORT
-  );
+  const parsed = databricksAppEnvSchema.safeParse(source);
+  return parsed.success;
 }
 
 /** Candidate names in scope, prefix, and input precedence order. */
-function keys(input: ConfigKey, options: Pick<ConfigOptions, "scope" | "prefix"> = {}): string[] {
-  const scopes = object.sequence(options.scope ?? DEFAULT_SCOPE).toArray();
-  const prefixes = options.prefix === undefined ? [] : object.sequence(options.prefix).toArray();
-  return [
-    ...object
-      .sequence(input)
-      .flatMap((key) => {
-        const prefixed = prefixes.length > 0 ? prefixes.map((prefix) => join(prefix, key)) : [key];
-        return [
-          ...scopes.flatMap((scope) => prefixed.map((key) => join(scope, key))),
-          ...prefixed,
-          key,
-        ];
-      })
-      .filter((key) => key.length > 0)
-      .distinct(),
-  ];
+function keys(
+  input: ConfigKey,
+  options: Pick<ConfigOptions, "scope" | "prefix"> = {},
+): readonly string[] {
+  const scopes = object
+    .sequence(options.scope ?? DEFAULT_SCOPE)
+    .map(sharedString.trimToEmpty)
+    .filter(Boolean)
+    .distinct()
+    .toArray();
+  const prefixes =
+    options.prefix === undefined
+      ? []
+      : object
+          .sequence(options.prefix)
+          .map(sharedString.trimToEmpty)
+          .filter(Boolean)
+          .distinct()
+          .toArray();
+  return object
+    .sequence(input)
+    .map(sharedString.trimToEmpty)
+    .filter(Boolean)
+    .distinct()
+    .flatMap((key) => {
+      const prefixed = prefixes.length > 0 ? prefixes.map((prefix) => `${prefix}_${key}`) : [key];
+      return [
+        ...scopes.flatMap((scope) => prefixed.map((name) => `${scope}_${name}`)),
+        ...prefixed,
+        key,
+      ];
+    })
+    .distinct()
+    .toArray();
 }
 
 /**
  * Every value that resolves for `input`, in source-then-key precedence order,
  * as a LAZY sequence: nothing past the first consumed element is read, so
- * `values(key).first()` never spawns the Databricks CLI when the environment
+ * `values(key).at(0)` never spawns the Databricks CLI when the environment
  * already answered.
  *
  */
@@ -248,7 +241,7 @@ function values(input: ConfigKey, options: ConfigOptions = {}): object.Sequence<
       for (const source of sources) {
         for (const map of read(source, options.cwd)) {
           for (const key of candidates) {
-            const value = stringModule.trimToNull(map[key]);
+            const value = sharedString.trimToNull(map[key]);
             if (value !== null) yield { key, source, value };
           }
         }
@@ -287,7 +280,7 @@ export function name(
  * Known long and short names are interchangeable; unknown names pass through.
  */
 function nodeEnvNames(nodeEnv: unknown): string[] {
-  const name = stringModule.trimToNull(nodeEnv)?.toLowerCase();
+  const name = sharedString.trimToNull(nodeEnv)?.toLowerCase();
   if (!name || !/^[a-z0-9_-]+$/.test(name)) return [];
   for (const [canonical, alternatives] of Object.entries(NODE_ENV_ALTERNATIVES)) {
     const names: readonly string[] = alternatives;
@@ -298,13 +291,6 @@ function nodeEnvNames(nodeEnv: unknown): string[] {
   return [name];
 }
 
-function join(...parts: string[]): string {
-  return parts
-    .map((part) => part.trim())
-    .filter(Boolean)
-    .join("_");
-}
-
 /**
  * Resolve a string: `configured` when non-empty, else {@link text}, else `undefined`.
  *
@@ -319,7 +305,7 @@ export function string(
   input: ConfigKey,
   options?: ConfigOptions,
 ): string | undefined {
-  return stringModule.trimToNull(configured) ?? text(input, options);
+  return sharedString.trimToNull(configured) ?? text(input, options);
 }
 
 /**
@@ -344,7 +330,10 @@ export function positiveNumber(
   fallback: number,
   options?: ConfigOptions,
 ): number {
-  return toPositiveNumber(configured) ?? toPositiveNumber(text(input, options)) ?? fallback;
+  const fromConfig = positiveNumberValue.safeParse(configured);
+  if (fromConfig.success) return fromConfig.data;
+  const fromSources = positiveNumberValue.safeParse(text(input, options));
+  return fromSources.success ? fromSources.data : fallback;
 }
 
 /**
@@ -358,8 +347,27 @@ export function positiveInt(
   fallback: number,
   options?: ConfigOptions,
 ): number {
-  const resolved = positiveNumber(configured, input, fallback, options);
-  return Math.floor(resolved);
+  const fromConfig = positiveIntValue.safeParse(configured);
+  if (fromConfig.success) return fromConfig.data;
+  const fromSources = positiveIntValue.safeParse(text(input, options));
+  return fromSources.success ? fromSources.data : Math.floor(fallback);
+}
+
+/**
+ * Resolve a TCP port between 1 and {@link MAX_TCP_PORT}. Invalid configured or
+ * sourced values fall back to the caller's default, which may be a sentinel
+ * such as `0` when the caller uses one.
+ */
+export function port(
+  configured: unknown,
+  input: ConfigKey,
+  fallback: number,
+  options?: ConfigOptions,
+): number {
+  const fromConfig = portValueSchema.safeParse(configured);
+  if (fromConfig.success) return fromConfig.data;
+  const fromSources = portValueSchema.safeParse(text(input, options));
+  return fromSources.success ? fromSources.data : fallback;
 }
 
 /**
@@ -372,31 +380,19 @@ export function list(
   transform?: (entry: string) => string,
   options?: ConfigOptions,
 ): string[] {
-  const fromConfig = stringModule.parseList(configured, transform);
+  const fromConfig = sharedString.parseList(configured, transform);
   return fromConfig.length > 0
     ? fromConfig
-    : stringModule.parseList(text(input, options), transform);
-}
-
-function toPositiveNumber(value: unknown): number | undefined {
-  const parsed = object.toNumber(value);
-  return parsed !== undefined && parsed > 0 ? parsed : undefined;
+    : sharedString.parseList(text(input, options), transform);
 }
 
 /**
  * The Databricks bundle output for `cwd` - `databricks bundle validate --output
  * json` run from the directory holding `databricks.yml`, with the config file's
  * path. A non-zero validation may still return partial JSON with usable App
- * config. `undefined` when bundle reads are disabled, this is not an AppKit
- * project, the bundle does not describe exactly one app with `config.env`, there
- * is no bundle, or the CLI produces no JSON.
- *
- * The spawn is guarded because it is expensive and usually pointless. In order:
- * `@databricks/appkit` must be RESOLVABLE (no AppKit, no bundle - and the probe
- * never evaluates the module); the bundle must describe exactly ONE app carrying
- * `config.env`; and AppKit's execution context must confirm this process is that
- * app. Only the confirmation is remembered, so a lookup during boot - before any
- * context exists - still resolves from the bundle and re-confirms later.
+ * config. `undefined` when bundle reads are disabled, the process is production
+ * or a deployed App without an explicit override, there is no bundle, or the
+ * CLI produces no JSON.
  *
  * Cached once per resolved working-directory context and
  * `DATABRICKS_CONFIG_PROFILE` through {@link context.cached}, so repeated
@@ -404,149 +400,32 @@ function toPositiveNumber(value: unknown): number | undefined {
  * context's bundle.
  */
 export function bundleFile(cwd?: string | null): ConfigFile | undefined {
-  const production = process.env.NODE_ENV?.trim().toLowerCase() === "production";
   const override = object.toBoolean(process.env[CONFIG_BUNDLE_KEY]);
   if (override === false) return undefined;
-  // An explicit `true` is the escape hatch for a tool that wants the bundle
-  // without being the app (`dbx` commands, tests), so it skips the AppKit gate
-  // entirely - but not the App/production defaults, which it also overrides.
-  if (override === undefined) {
-    if (production || isDatabricksAppEnv()) return undefined;
-    if (!appKitInstalled()) return undefined;
+  if (
+    override === undefined &&
+    (process.env.NODE_ENV?.trim().toLowerCase() === "production" || isDatabricksAppEnv())
+  ) {
+    return undefined;
   }
-  const profile = stringModule.trimToNull(process.env.DATABRICKS_CONFIG_PROFILE);
-  const file = cachedConfig(["bundle", profile ?? ""], cwd, (resolved) =>
+  const profile = sharedString.trimToNull(process.env.DATABRICKS_CONFIG_PROFILE);
+  return cachedConfig(["bundle", profile ?? ""], cwd, (resolved) =>
     loadBundleFile(resolved, profile),
   );
-  if (override !== undefined || file === undefined) return file;
-  // Already confirmed: this process is the app, and that does not stop being
-  // true, so skip re-deriving the gate on every lookup.
-  if (appKitContext) return file;
-  // The app must be unambiguous. `bundleApp` is what decides "exactly one app
-  // with `config.env`", so an empty map IS the ambiguous or app-less bundle and
-  // needs no separate check.
-  if (Object.keys(bundleApp(file.data)).length === 0) return undefined;
-  confirmAppKitContext();
-  return file;
 }
 
-/**
- * The single App's literal `config.env` entries, flattened to `name -> value`.
- *
- * A `value_from` entry names a bundle resource whose id is known after
- * deployment, and reading it needs the resource vocabulary this module
- * deliberately does not have - node-appkit resolves those against its extended
- * {@link bundleResourceSchema}. An `apps` block with more than one app is
- * ambiguous (nothing here says which app this process is), so it yields nothing
- * rather than a guess.
- *
- * Memoized against the parsed bundle it came from, because both the gate in
- * {@link bundleFile} and the lookup in {@link read} ask the same question of the
- * same cached object - validating that payload twice per lookup would be pure
- * waste. A `WeakMap` keeps the entry alive exactly as long as the bundle is.
- */
-function bundleApp(input: unknown): Record<string, string> {
-  if (!object.isRecord(input)) return bundleAppEntries(input);
-  const cached = BUNDLE_APP_CACHE.get(input);
-  if (cached) return cached;
-  const result = bundleAppEntries(input);
-  BUNDLE_APP_CACHE.set(input, result);
-  return result;
-}
-
-/** {@link bundleApp} without the memoization, so the cache has one filler. */
-function bundleAppEntries(input: unknown): Record<string, string> {
-  const parsed = bundleAppsSchema.safeParse(input);
-  if (!parsed.success) return {};
-  const apps = parsed.data.resources?.apps;
-  if (!apps) return {};
-  const names = Object.keys(apps);
-  if (names.length !== 1) return {};
-  const entries = apps[names[0]!]?.config?.env ?? [];
-  const result: Record<string, string> = {};
-  for (const entry of entries) {
-    if (!entry.name) continue;
-    const value = resolvedString(entry.value);
-    if (value !== null) result[entry.name] = value;
-  }
-  return result;
-}
-
-/**
- * Whether `@databricks/appkit` can be RESOLVED from this process, cached for its
- * lifetime.
- *
- * Resolution, not import: this answers "is this an AppKit project" without
- * evaluating the module, so the cheap negative (a plain library or CLI consumer
- * that never installed the optional peer) costs one path lookup and never boots
- * AppKit as a side effect of reading config. A runtime with no `createRequire`
- * (a browser bundle that reached this Node-only module anyway) reports absent.
- */
-const appKitInstalled = functionModule.memoize((): boolean => {
-  try {
-    // Indirect specifier: a bundler must not try to follow an OPTIONAL peer that
-    // a browser build has no way to resolve.
-    const specifier = APPKIT_MODULE;
-    createRequire(import.meta.url).resolve(specifier);
-    return true;
-  } catch {
-    return false;
-  }
-});
-
-/**
- * AppKit's execution context once it exists, or `undefined`.
- *
- * Lazily imported (and `@vite-ignore`d) because `@databricks/appkit` is an
- * OPTIONAL peer this module must never make required. The import is only
- * attempted once {@link appKitInstalled} says there is something to import, and a
- * failure resolves to `undefined` rather than rejecting - a missing peer is the
- * expected path, not an error.
- *
- * `getExecutionContext()` THROWS until AppKit has booted, so the call is caught
- * and only a real context is reported. The module handle is memoized; the
- * context lookup is not, so a call before boot answers "not yet" and a later one
- * still sees the context.
- */
-const appKitModule = functionModule.memoize(async (): Promise<AppKitModule | undefined> => {
-  if (!appKitInstalled()) return undefined;
-  const specifier = APPKIT_MODULE;
-  return (await import(/* @vite-ignore */ specifier).catch(() => undefined)) as
-    AppKitModule | undefined;
-});
-
-/**
- * Latch {@link appKitContext} once AppKit's execution context exists.
- *
- * Fire-and-forget, because the caller is a SYNCHRONOUS lookup and the check
- * needs a lazy import. The affirmative is all that is stored: AppKit's context
- * does not exist until it boots, and `getExecutionContext()` throws until then,
- * so remembering a negative would permanently disable the bundle for a process
- * that is seconds away from having one. Every call before the latch closes
- * re-attempts, which is what makes "not available yet" retry rather than stick.
- */
-function confirmAppKitContext(): void {
-  void appKitModule()
-    .then((appkit) => {
-      if (!appkit) return;
-      try {
-        if (appkit.getExecutionContext()?.client) appKitContext = true;
-      } catch {
-        // AppKit has not booted yet; a later call re-checks.
-      }
-    })
-    .catch(() => undefined);
-}
-
-/** A non-empty bundle value with every `${...}` interpolation resolved. */
-function resolvedString(value: unknown): string | null {
-  const parsed = bundleValue.safeParse(value);
-  return parsed.success ? parsed.data : null;
+/** The single bundle App's resolved literal environment, when available. */
+function bundleEnvironment(cwd?: string): Record<string, string> | undefined {
+  const file = bundleFile(cwd);
+  if (!file) return undefined;
+  const parsed = bundleAppConfigEnvSchema.safeParse(file.data);
+  return parsed.success ? parsed.data : undefined;
 }
 
 /** Parsed `.env` for `cwd`, or `{}`. Read once per resolved context. */
 function dotenv(cwd?: string | null): Record<string, string | undefined> {
-  if (!fileSourceEnabled(CONFIG_DOTENV_KEY)) return {};
+  const enabled = object.toBoolean(process.env[CONFIG_DOTENV_KEY]) ?? !isDatabricksAppEnv();
+  if (!enabled) return {};
   const environments = nodeEnvNames(process.env.NODE_ENV);
   return cachedConfig(["dotenv", ...environments], cwd, (resolved) =>
     loadDotenv(resolved, environments),
@@ -564,11 +443,7 @@ function cachedConfig<T>(
   return context.cached(["config", active, resolved, ...name], () => loader(resolved));
 }
 
-/**
- * Maps for one source in precedence order. Bundle App config and root variables
- * stay separate so a first-match lookup does not parse variables after an App
- * value resolves.
- */
+/** Maps for one source in precedence order. */
 function read(
   source: ConfigSource,
   cwd?: string,
@@ -583,8 +458,8 @@ function read(
           yield dotenv(cwd);
           break;
         case "bundle": {
-          const bundle = bundleFile(cwd);
-          if (bundle) yield bundleApp(bundle.data);
+          const environment = bundleEnvironment(cwd);
+          if (environment) yield environment;
           break;
         }
       }
@@ -618,11 +493,6 @@ function findConfigFile(cwd: string, names: readonly string[]): string | undefin
   return undefined;
 }
 
-/** A recognized source override, else the caller's automatic default. */
-function fileSourceEnabled(key: string, fallback: boolean = !isDatabricksAppEnv()): boolean {
-  return object.toBoolean(process.env[key]) ?? fallback;
-}
-
 function loadDotenv(
   cwd: string,
   environments: readonly string[],
@@ -653,8 +523,8 @@ function loadBundleFile(cwd: string, profile: string | null): ConfigFile | undef
     encoding: "utf8",
     stdio: ["ignore", "pipe", "pipe"],
   });
-  const output = stringModule.trimToNull(result.stdout);
-  const error = stringModule.trimToNull(result.stderr);
+  const output = sharedString.trimToNull(result.stdout);
+  const error = sharedString.trimToNull(result.stderr);
   if (output === null) {
     logger.debug("bundle validate produced no JSON", { path, status: result.status, error });
     return undefined;