@dbx-tools/projen 0.9.93 → 0.9.99

package/tasks/release.ts

@@ -71,7 +71,9 @@ function pushAnnotatedReleaseTag(options: {
   runTaskCommand(root, "git", ["tag", "--annotate", tag, "--message", annotation]);
   const githubAccount = projectUtils.resolveProjectGhAccount(root, { remote });
   if (!githubAccount) {
-    logger.warn("no authenticated GitHub account can access the release repository; using git push");
+    logger.warn(
+      "no authenticated GitHub account can access the release repository; using git push",
+    );
     runTaskCommand(root, "git", ["push", remote, `refs/tags/${tag}`]);
     return;
   }
@@ -228,16 +230,44 @@ export async function runRelease(
     readonly validationTasks?: readonly string[];
     /** After tagging, stage and deploy the AppKit demo app. Off by default. */
     readonly demoDeploy?: boolean;
+    /** Explicit Databricks CLI profile used by the optional 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;
     /** Additional instructions appended to the standard Genie release-notes prompt. */
     readonly releaseNotesInstructions?: string;
+    /** Complete release notes supplied directly instead of invoking Genie. */
+    readonly releaseNotesText?: string;
+    /** Path to complete release notes supplied instead of invoking Genie. */
+    readonly releaseNotesFile?: string;
     readonly writeReleaseNotes?: typeof writeReleaseNotes;
   },
 ): Promise<string> {
   const { branch, prefix, remote, root } = options;
   const selection = releaseStepSelection(options);
   const install = options.install ?? "auto";
+  const demoProfile = options.demoProfile?.trim();
+
+  if (options.demoDeploy && !demoProfile) {
+    throw new Error("--demo-deploy requires --profile <name>");
+  }
+  if (options.releaseNotesText !== undefined && options.releaseNotesFile !== undefined) {
+    throw new Error("--release-notes-text and --release-notes-file are mutually exclusive");
+  }
+  if (
+    options.releaseNotesInstructions !== undefined &&
+    (options.releaseNotesText !== undefined || options.releaseNotesFile !== undefined)
+  ) {
+    throw new Error(
+      "--release-notes-instructions cannot be combined with supplied release notes",
+    );
+  }
+  if (
+    options.releaseNotes === false &&
+    (options.releaseNotesText !== undefined || options.releaseNotesFile !== undefined)
+  ) {
+    throw new Error("--no-release-notes cannot be combined with supplied release notes");
+  }
 
   if (install === "always") runTaskCommand(root, "bun", ["install"]);
   if (selection.validation && hasPackageScript(root, "eslint:fix")) {
@@ -270,6 +300,8 @@ export async function runRelease(
       prefix,
       root,
       version,
+      content: options.releaseNotesText,
+      file: options.releaseNotesFile,
       instructions: options.releaseNotesInstructions,
     });
   }
@@ -331,8 +363,8 @@ export async function runRelease(
     });
   }
 
-  if (options.demoDeploy) {
-    runTaskCommand(root, "bun", ["run", "demo:deploy"]);
+  if (options.demoDeploy && demoProfile) {
+    runTaskCommand(root, "bun", ["run", "demo:deploy", "--profile", demoProfile]);
   }
 
   return tag;
@@ -371,14 +403,17 @@ export function createReleaseCommand(): Command {
     .option("--no-docs", "skip documentation build and deployment")
     .option(
       "--no-validation",
-      "skip optional release validation tasks; version/source checks remain mandatory",
+      "skip optional release validation tasks; workspace version checks remain mandatory",
     )
     .option("--no-release-notes", "skip writing docs/releases notes (Genie and git-log fallback)")
+    .option("--release-notes-text <markdown>", "write supplied markdown without invoking Genie")
+    .option("--release-notes-file <path>", "copy supplied markdown without invoking Genie")
     .option(
       "--release-notes-instructions <text>",
       "append custom instructions to the Genie release-notes prompt",
     )
     .option("--demo-deploy", "after tagging, stage and deploy the AppKit demo app (off by default)")
+    .option("--profile <name>", "Databricks CLI profile for --demo-deploy")
     .option("--no-local-publish", "skip publishing to configured local registries")
     .option("--local-registry <auto|false|url>", "local npm registry selection", "auto")
     .option("--local-pypi <auto|false|url>", "local devpi registry selection", "auto")
@@ -397,8 +432,11 @@ export function createReleaseCommand(): Command {
           install: ReleaseInstallMode;
           validate: string[];
           demoDeploy?: boolean;
+          profile?: string;
           releaseNotes?: boolean;
           releaseNotesInstructions?: string;
+          releaseNotesText?: string;
+          releaseNotesFile?: string;
         },
       ) => {
         await runRelease({
@@ -419,8 +457,11 @@ export function createReleaseCommand(): Command {
           validation: options.validation,
           validationTasks: options.validate,
           demoDeploy: options.demoDeploy,
+          demoProfile: options.profile,
           releaseNotes: options.releaseNotes,
           releaseNotesInstructions: options.releaseNotesInstructions,
+          releaseNotesText: options.releaseNotesText,
+          releaseNotesFile: options.releaseNotesFile,
         });
       },
     );