@dbx-tools/projen 0.6.225 → 0.6.227

package/README.md

@@ -57,9 +57,13 @@ Repository policy stays in the consuming `.projenrc.ts`:
   artifact upload, and deployment without naming a docs script or output tree.
 - `releasePythonRoot` passes the actual Python package root to local release
   preparation. Omit it when the workspace has no standard Python packages.
-- `releaseSummary` controls optional AI release notes. It defaults to enabled
-  with Cursor, Codex, Claude fallback order; pass `false` to disable or provide
-  a `providers` array to choose the order/subset.
+- `releaseValidationTasks` names repository tasks that must pass in the release
+  worktree before Cargo tests, compilation, local publication, or approval.
+  Use it for repository-specific guards that also run in release CI.
+- `releaseSummary` controls versioned release notes. It defaults to Cursor,
+  Codex, Claude fallback order and writes a deterministic Git summary when every
+  configured provider is unavailable; pass `false` to disable or provide a
+  `providers` array to choose the order/subset.
 - `pullRequestTitlePolicy` configures semantic title types and scope policy.
   Omit it or pass `false` to disable the title job.
 - `workflowCacheIgnorePaths` excludes generated output trees that may contain
@@ -286,6 +290,11 @@ Built-in tag mixins set runtime defaults for `shared`, `node`, `cli`, `server`,
 `ui`, and `openapi`. Repo-specific mixins layer package-specific dependencies,
 scripts, and generated files on top.
 
+AppKit 0.81's `appkitServerConfig()` is the preferred tsdown preset for a
+consumer app using conventional compiled `server/agents/*/agent.ts` entries. It
+does not replace this engine's package discovery, Bun browser build, source-run
+server, publication, or Databricks deployment staging.
+
 A tag layers over a shared compiler floor every package gets at construction:
 ES2022 plus the web-platform globals available in every runtime, and deliberately
 no DOM lib and no Node types, so agnostic code stays isomorphic. The tags are what

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.6.225";
+export const PACKAGE_VERSION = "0.6.227";
 export * as barrels from "./src/barrels.ts";
 export * as bunApp from "./src/bun-app.ts";
 export * as bunWorkflow from "./src/bun-workflow.ts";

package/package.json

@@ -25,9 +25,9 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.7.0",
-    "@dbx-tools/core": "0.6.225",
-    "@dbx-tools/path": "0.6.225",
-    "@dbx-tools/shared-core": "0.6.225",
+    "@dbx-tools/core": "0.6.227",
+    "@dbx-tools/path": "0.6.227",
+    "@dbx-tools/shared-core": "0.6.227",
     "commander": "^15.0.0",
     "concurrently": "^10.0.3",
     "constructs": "^10.6.0",
@@ -47,7 +47,7 @@
   },
   "main": "index.ts",
   "license": "Apache-2.0",
-  "version": "0.6.225",
+  "version": "0.6.227",
   "types": "index.ts",
   "type": "module",
   "exports": {

package/src/pnpm-workspace.ts

@@ -87,8 +87,8 @@ const DEFAULT_CATALOG: Catalog = {
   tsoa: "^6.6.0",
   concurrently: "^10.0.3",
   pnpm: "^11.0.6",
-  "@databricks/appkit": "^0.60.0",
-  "@databricks/appkit-ui": "^0.60.0",
+  "@databricks/appkit": "0.81.0",
+  "@databricks/appkit-ui": "0.81.0",
   "@databricks/sdk-experimental": "^0.17.0",
 };
 

package/src/project-js.ts

@@ -621,6 +621,8 @@ export type DBXToolsJavaScriptProjectOptions = CommonProjectOptions &
     readonly releaseDocs?: ReleaseDocsOptions;
     /** Python package root passed to local release preparation when configured. */
     readonly releasePythonRoot?: string;
+    /** Repository task names run during local release preparation before publication. */
+    readonly releaseValidationTasks?: readonly string[];
     /** Optional AI-generated release summary. Defaults to enabled. */
     readonly releaseSummary?: boolean | ReleaseSummaryOptions;
     /** Set to `false` to omit normal npm workspace publication. */
@@ -1542,6 +1544,7 @@ function initProject(
       nodeRelease: options.nodeRelease,
       docs: options.releaseDocs,
       pythonRoot: options.releasePythonRoot,
+      validationTasks: options.releaseValidationTasks,
       summary: options.releaseSummary,
     });
   }

package/src/release.ts

@@ -53,6 +53,8 @@ export interface DBXToolsReleaseOptions {
   readonly docs?: ReleaseDocsOptions;
   /** Python package root passed to local release preparation. */
   readonly pythonRoot?: string;
+  /** Repository task names run in the release worktree before expensive validation and publication. */
+  readonly validationTasks?: readonly string[];
   /**
    * Generate a versioned release summary locally. Defaults to enabled with the
    * standard Cursor, Codex, Claude fallback order.
@@ -371,6 +373,9 @@ export class DBXToolsRelease extends Component {
                   ...(options.pythonRoot
                     ? [`--python-root ${JSON.stringify(options.pythonRoot)}`]
                     : []),
+                  ...(options.validationTasks ?? []).map(
+                    (task) => `--validate-task ${JSON.stringify(task)}`,
+                  ),
                   ...summaryArgs,
                 ].join(" "),
               ),

package/tasks/release-pr.ts

@@ -163,6 +163,12 @@ program
   .option("--local-registry <value>", "local npm registry: auto, false, or an explicit URL", "auto")
   .option("--local-pypi <value>", "local PyPI index: auto, false, or an explicit URL", "auto")
   .option("--python-root <path>", "Python workspace package root")
+  .option(
+    "--validate-task <task>",
+    "repository task to run before release validation; repeatable",
+    (task: string, tasks: string[]) => [...tasks, task],
+    [],
+  )
   .option("--no-release-summary", "skip optional AI release summary generation")
   .option(
     "--release-summary-providers <providers>",
@@ -181,6 +187,7 @@ program
       localRegistry: string;
       localPypi: string;
       pythonRoot?: string;
+      validateTask: string[];
       releaseSummary: boolean;
       releaseSummaryProviders?: string;
       localCargo: boolean;
@@ -270,6 +277,9 @@ program
         runIgnoringStdout(releaseRoot, "cargo", ["metadata", "--format-version", "1"]);
       }
       run(releaseRoot, process.execPath, [versionCheckScript]);
+      for (const task of opts.validateTask) {
+        run(releaseRoot, process.execPath, ["run", task]);
+      }
       if (existsSync(join(releaseRoot, "Cargo.toml"))) {
         run(releaseRoot, "cargo", [
           "test",

package/tasks/release-summary.ts

@@ -215,7 +215,35 @@ function summaryPrompt(
   ].join("\n");
 }
 
-/** Generate one immutable versioned summary, or remove a stale retry artifact. */
+/** Deterministic fallback when every configured AI provider is unavailable. */
+function gitSummary(version: string, commits: string, changedFiles: string): string {
+  const subjects = commits
+    .split("\n")
+    .map((line) => line.trim())
+    .filter(Boolean)
+    .filter((line, index, lines) => lines.indexOf(line) === index)
+    .slice(0, 20);
+  const files = changedFiles
+    .split("\n")
+    .map((line) => line.trim().split(/\s+/).at(-1))
+    .filter((value): value is string => Boolean(value));
+  const areas = files
+    .map((file) => {
+      if (file.startsWith("packages/")) return file.split("/").slice(0, 4).join("/");
+      return file.split("/")[0] ?? file;
+    })
+    .filter((area, index, all) => all.indexOf(area) === index)
+    .slice(0, 12);
+  const bullets = subjects.length ? subjects : areas.map((area) => `Updated ${area}`);
+  return [
+    `dbx-tools ${version} contains the reviewed changes listed below.`,
+    "",
+    "## Changes",
+    ...(bullets.length ? bullets.map((item) => `- ${item}`) : ["- Release metadata updated."]),
+  ].join("\n");
+}
+
+/** Generate one immutable versioned summary with an AI or Git fallback. */
 export async function generateReleaseSummary(options: {
   readonly root: string;
   readonly version: string;
@@ -258,13 +286,12 @@ export async function generateReleaseSummary(options: {
     options.runner,
     options.providers,
   );
-  if (!result) {
-    logger.info("no supported AI CLI available; skipping release summary");
-    return undefined;
-  }
-  const content = `# Release ${options.version}\n\n${result.summary.trim()}\n`;
+  const summary = result?.summary ?? gitSummary(options.version, commits, changedFiles);
+  const provider = result?.provider ?? "git";
+  if (!result) logger.info("AI providers unavailable; using Git release summary");
+  const content = `# Release ${options.version}\n\n${summary.trim()}\n`;
   mkdirSync(dirname(output), { recursive: true });
   writeFileSync(output, content);
-  logger.info("generated", { provider: result.provider, path: output });
+  logger.info("generated", { provider, path: output });
   return content;
 }