@dbx-tools/projen 0.9.121 → 0.9.123

package/README.md

@@ -625,7 +625,7 @@ release [options]
 | `--release-notes-instructions <value>` | Append instructions to the Genie release-note prompt (env: PROJEN_RELEASE_RELEASE_NOTES_INSTRUCTIONS)                      |
 | `--demo-deploy`                        | Deploy the AppKit demo after tagging and local publication (env: PROJEN_RELEASE_DEMO_DEPLOY)                               |
 | `--no-demo-deploy`                     | Disable deploy the appkit demo after tagging and local publication                                                         |
-| `--profile <value>`                    | Databricks CLI profile for the optional demo deployment                                                                     |
+| `--profile <value>`                    | Optional Databricks CLI profile passed to the demo deployment (env: PROJEN_RELEASE_PROFILE)                                |
 | `--local-publish`                      | Publish to configured local registries (default: true, env: PROJEN_RELEASE_LOCAL_PUBLISH)                                  |
 | `--no-local-publish`                   | Disable publish to configured local registries                                                                             |
 | `--local-registry <value>`             | Local npm registry selection: auto, false, or URL (default: "auto", env: PROJEN_RELEASE_LOCAL_REGISTRY)                    |

package/index.ts

@@ -3,7 +3,7 @@
 // Hand edits are overwritten on the next watch; this file is read-only.
 
 export const PACKAGE_IDENTIFIER = "@dbx-tools/projen";
-export const PACKAGE_VERSION = "0.9.121";
+export const PACKAGE_VERSION = "0.9.123";
 export * as barrels from "./src/barrels.ts";
 export * as bunApp from "./src/bun-app.ts";
 export * as bunWorkflow from "./src/bun-workflow.ts";
@@ -38,7 +38,7 @@ export * as watch from "./src/watch.ts";
 export * as workspaceLock from "./src/workspace-lock.ts";
 export * as workspaceVersion from "./src/workspace-version.ts";
 export { BUN_DEV_OVERRIDE, BUN_BUILD_OVERRIDE, BUN_APP_OVERRIDES, RootBunfigFile, BunfigFile, BunDevServerFile, BunBuildFile } from "./src/bun-app.ts";
-export { BUN_VERSION } from "./src/bun-workflow.ts";
+export { BUN_VERSION, MINIMUM_BUN_VERSION, BUN_VERSION_CHECK_SCRIPT } from "./src/bun-workflow.ts";
 export { DBXToolsConfigDataSchema, DBXToolsConfig } from "./src/dbx-tools-config.ts";
 export type { DBXToolsConfigOptions, DBXToolsConfigData } from "./src/dbx-tools-config.ts";
 export { DEV_WATCH_TASK, DEV_WATCH_SCRIPT, DEV_RESTART_DEBOUNCE_MS, DEV_RESTART_KEY } from "./src/dev-watch.ts";

package/package.json

@@ -30,10 +30,10 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.7.0",
-    "@dbx-tools/cli-args": "^0.9.121",
-    "@dbx-tools/core": "^0.9.121",
-    "@dbx-tools/path": "^0.9.121",
-    "@dbx-tools/shared-core": "^0.9.121",
+    "@dbx-tools/cli-args": "^0.9.123",
+    "@dbx-tools/core": "^0.9.123",
+    "@dbx-tools/path": "^0.9.123",
+    "@dbx-tools/shared-core": "^0.9.123",
     "commander": "^15.0.0",
     "concurrently": "^10.0.3",
     "constructs": "^10.6.0",
@@ -55,7 +55,7 @@
   },
   "main": "index.ts",
   "license": "Apache-2.0",
-  "version": "0.9.121",
+  "version": "0.9.123",
   "types": "index.ts",
   "type": "module",
   "exports": {

package/src/bun-workflow.ts

@@ -2,3 +2,9 @@
 
 /** Bun version used by package manifests, generated workflows, and CLI services. */
 export const BUN_VERSION = "1.4.2";
+
+/** Oldest Bun release allowed to run generated project tasks. */
+export const MINIMUM_BUN_VERSION = BUN_VERSION;
+
+/** Generated runtime-version guard executed before dependency installation. */
+export const BUN_VERSION_CHECK_SCRIPT = "scripts/check-bun.ts";

package/src/project-js.ts

@@ -12,13 +12,17 @@ import * as projectUtils from "@dbx-tools/core/project-utils";
 import { ignore, match } from "@dbx-tools/path";
 import { object, stringUtils, type OneOrMany } from "@dbx-tools/shared-core";
 import { type IConstruct } from "constructs";
-import { Component, LogLevel, Project, type Task, javascript, typescript } from "projen";
+import { Component, LogLevel, Project, type Task, TextFile, javascript, typescript } from "projen";
 import { JobPermission, type JobStep } from "projen/lib/github/workflows-model";
 import type { ReleaseProjectOptions } from "projen/lib/release";
 import { generateBarrels, isGeneratedBarrel } from "./barrels.ts";
 
 import { BUN_APP_OVERRIDES, RootBunfigFile } from "./bun-app.ts";
-import { BUN_VERSION } from "./bun-workflow.ts";
+import {
+  BUN_VERSION,
+  BUN_VERSION_CHECK_SCRIPT,
+  MINIMUM_BUN_VERSION,
+} from "./bun-workflow.ts";
 import { codegenModulePaths, generateCodegen } from "./codegen.ts";
 import { DBXToolsConfig, type DBXToolsConfigOptions } from "./dbx-tools-config.ts";
 import { DEV_WATCH_SCRIPT, DEV_WATCH_TASK } from "./dev-watch.ts";
@@ -503,10 +507,53 @@ function defaultTypeScriptProjectOptions(options: DBXToolsTypeScriptProjectOptio
 // Pinned to match the subproject defaults so bun resolves one TypeScript and
 // one runtime-compatible set of Bun globals across the workspace.
 const DEV_DEPS_ROOT: string[] = [
+  `bun@${BUN_VERSION}`,
   "typescript@^5.9.3",
   `@types/bun@${BUN_VERSION}`,
   "@types/node@^24.6.0",
 ];
+
+function configureRootBunRuntime(project: DBXToolsJavaScriptProject): void {
+  new TextFile(project, BUN_VERSION_CHECK_SCRIPT, {
+    lines: stringUtils
+      .dedent(
+        // ============================================================================
+        /*ts*/`
+          /** Minimum Bun version accepted by this workspace. */
+          const MINIMUM_VERSION = ${JSON.stringify(MINIMUM_BUN_VERSION)};
+
+          /** Convert one Bun version into a three-part numeric tuple. */
+          function versionTuple(version: string): [number, number, number] {
+            const parts = version.split("-", 1)[0]!.split(".");
+            return [0, 1, 2].map((index) => Number.parseInt(parts[index] ?? "0", 10)) as [
+              number,
+              number,
+              number,
+            ];
+          }
+
+          const current = versionTuple(Bun.version);
+          const minimum = versionTuple(MINIMUM_VERSION);
+          const isTooOld = current.some(
+            (part, index) =>
+              part < minimum[index]! &&
+              current.slice(0, index).every((value, prefix) => value === minimum[prefix]),
+          );
+
+          if (isTooOld) {
+            throw new Error(
+              \`Bun \${MINIMUM_VERSION} or newer is required; running \${Bun.version}. Use "bun run bun" to select the workspace-local Bun binary.\`,
+            );
+          }
+        `,
+        // ============================================================================
+      )
+      .split("\n"),
+  });
+  const check = `bun ${BUN_VERSION_CHECK_SCRIPT}`;
+  project.package.installTask.prependExec(check);
+  project.package.installCiTask.prependExec(check);
+}
 function validateReleaseOptions(options: DBXToolsJavaScriptProjectOptions): void {
   if (
     options.releaseMode === "disabled" &&
@@ -1209,6 +1256,7 @@ function initProject(
   // Workspaces generated by this engine intentionally do not track local-registry
   // lockfiles, so the CI-named install task must resolve from manifests as well.
   project.package.installCiTask.reset("bun install");
+  configureRootBunRuntime(project);
   const roots = options.packageRoots ?? DEFAULT_PACKAGE_ROOTS;
   project.dbxToolsConfig.packageRoots = [...roots];
   if (options.syncResynthPaths?.length) {

package/src/vscode.ts

@@ -33,6 +33,11 @@ export function configureVsCode(scope: javascript.NodeProject): void {
       "**/node_modules/**": true,
       "**/dist/**": true,
     },
+    "search.exclude": {
+      "**/.prettierrc.json": true,
+      "**/eslintrc.json": true,
+      "docs/**/archived/**": true,
+    },
   });
   editor.extensions.addRecommendations(
     "esbenp.prettier-vscode",

package/tasks/dev-watch.ts

@@ -265,24 +265,14 @@ export async function main(args: string[] = process.argv.slice(2)): Promise<void
     },
   });
 
-  function interruptChild(): void {
-    const current = child;
-    if (!current?.pid) return;
-    try {
-      current.kill("SIGINT");
-    } catch {
-      // The command already exited.
-    }
-  }
-
   async function stopChild(): Promise<void> {
     const current = child;
     if (!current) return;
     child = undefined;
     try {
-      await exec.kill(current, {
-        gracefulTimeoutMs: SHUTDOWN_TIMEOUT_MS,
-        forceTimeoutMs: SHUTDOWN_TIMEOUT_MS,
+      await current.shutdown({
+        terminateTimeout: SHUTDOWN_TIMEOUT_MS,
+        killTimeout: SHUTDOWN_TIMEOUT_MS,
       });
     } catch (err) {
       logger.error("failed to stop command process tree", {
@@ -300,6 +290,7 @@ export async function main(args: string[] = process.argv.slice(2)): Promise<void
       stdout: "inherit",
       stderr: "inherit",
       check: false,
+      forwardTerminationSignals: false,
     });
     child = current;
     void current
@@ -387,7 +378,6 @@ export async function main(args: string[] = process.argv.slice(2)): Promise<void
     clearTimeout(timer);
     restartReason = undefined;
     restoreStdin();
-    interruptChild();
     await Promise.race([
       Promise.allSettled([watcher.close(), stopChild()]),
       asyncUtils.sleep(SHUTDOWN_TIMEOUT_MS),

package/tasks/release.ts

@@ -233,7 +233,7 @@ export async function runRelease(
     readonly validationTasks?: readonly string[];
     /** After tagging, stage and deploy the AppKit demo app. Off by default. */
     readonly demoDeploy?: boolean;
-    /** Databricks CLI profile used only by the optional local demo deployment. */
+    /** Optional Databricks CLI profile passed to the local demo deployment. */
     readonly demoProfile?: string;
     /** Write `docs/releases/vX.Y.Z.md` via Genie, with a git-log fallback. On by default. */
     readonly releaseNotes?: boolean;
@@ -361,12 +361,11 @@ export async function runRelease(
   }
 
   if (options.demoDeploy) {
-    runTaskCommand(root, "bun", ["run", "demo:deploy"], {
-      env: {
-        ...process.env,
-        ...(options.demoProfile ? { DATABRICKS_CONFIG_PROFILE: options.demoProfile } : {}),
-      },
-    });
+    runTaskCommand(root, "bun", [
+      "run",
+      "demo:deploy",
+      ...(options.demoProfile ? ["--", "--profile", options.demoProfile] : []),
+    ]);
   }
 
   return tag;
@@ -421,7 +420,7 @@ export const ReleaseOptionsSchema = z.object({
     .trim()
     .min(1)
     .optional()
-    .describe("Databricks CLI profile for the optional demo deployment"),
+    .describe("Optional Databricks CLI profile passed to the demo deployment"),
   localPublish: z.boolean().default(true).describe("Publish to configured local registries"),
   localRegistry: z
     .string()