@dbx-tools/projen 0.9.146 → 0.9.149

package/README.md

@@ -316,14 +316,14 @@ scripts, and generated files on top.
 Every workspace root exposes a generic development watcher:
 
 ```bash
-bun run dev:watch [--debounce-ms 15000] [--restart-key r] <command> [args...]
+bun run dev:watch <command> [args...]
 ```
 
-It restarts after watched writes have been quiet for 15 seconds. Command paths,
-`--cwd`, and `--filter` identify the owning package. Its transitive workspace
+It restarts after watched writes have been quiet for 15 seconds. Command paths
+and task selectors identify the owning package. Its transitive workspace
 dependencies are watched with the shared generated/dependency/test/temp ignores.
-Press the configured key for an immediate restart. The demo uses this task to
-run its concrete server entrypoint. The `server` tag does not assume one.
+The configured restart key triggers an immediate restart. The demo uses this
+task to run its concrete server entrypoint. The `server` tag does not assume one.
 
 AppKit 0.81's `appkitServerConfig()` is the preferred tsdown preset for a
 consumer app using conventional compiled `server/agents/*/agent.ts` entries. It
@@ -541,10 +541,11 @@ diverged. From `main`, it calls the existing `bump` task, commits the generated
 version changes, pushes `main`, and pushes the matching annotated `vX.Y.Z` tag.
 Pass `--no-bump` only to release an existing synchronized local bump. The tag
 workflow verifies that the tag points at the exact `origin/main` commit. The
-local task waits for this workflow by default, displays live job and step
-progress, then prints its logs. Local-only releases and repositories without a
-resolved authenticated GitHub account skip the watcher. Stopping the local
-watcher does not cancel the remote run.
+local task completes local publication and demo deployment first, then waits for
+this workflow by default. It preserves the live checklist through a scroll-safe
+non-TTY stream and prints the final logs. Local-only releases and repositories
+without a resolved authenticated GitHub account skip the watcher. Stopping the
+local watcher does not cancel the remote run.
 
 One `build-release` job installs workspace dependencies, runs validation, packs
 the npm archives, builds all Python distributions, and builds the documentation
@@ -556,7 +557,9 @@ workspace. Each Python package retains its own publishing environment and waits
 for its package dependencies to publish. The npm job uses the bundled archive
 publisher without a checkout or workspace install. Pages deploys the already
 built site after registry publication succeeds. Local npm and Python registry publication remains available
-through the direct local publication tooling.
+through the direct local publication tooling. Those local publishers run
+concurrently; a failure or release termination stops every live publisher before
+the command returns.
 
 The default release publishes npm, Python, and docs, then publishes to
 configured local registries. Use `bun run release --help` or the generated
@@ -658,8 +661,8 @@ release [options]
 | `--no-docs`                            | Disable build and deploy documentation                                                                                                                            |
 | `--validation`                         | Run optional release validation tasks before publishing (default: true, env: PROJEN_RELEASE_VALIDATION)                                                           |
 | `--no-validation`                      | Disable run optional release validation tasks before publishing                                                                                                   |
-| `-w, --watch-github-actions`           | Wait for and stream the tag-triggered GitHub Actions release (default: true, env: PROJEN_RELEASE_WATCH_GITHUB_ACTIONS)                                            |
-| `--no-watch-github-actions`            | Disable wait for and stream the tag-triggered github actions release                                                                                              |
+| `-w, --watch-github-actions`           | Wait for and log the tag-triggered GitHub Actions release (default: true, env: PROJEN_RELEASE_WATCH_GITHUB_ACTIONS)                                               |
+| `--no-watch-github-actions`            | Disable wait for and log the tag-triggered github actions release                                                                                                 |
 | `--release-notes`                      | Generate and commit release notes for a new version bump (default: true, env: PROJEN_RELEASE_RELEASE_NOTES)                                                       |
 | `--no-release-notes`                   | Disable generate and commit release notes for a new version bump                                                                                                  |
 | `--release-notes-text <value>`         | Write supplied release-note Markdown without invoking Genie (env: PROJEN_RELEASE_RELEASE_NOTES_TEXT)                                                              |

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.146";
+export const PACKAGE_VERSION = "0.9.149";
 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

@@ -30,10 +30,10 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.7.0",
-    "@dbx-tools/cli-args": "^0.9.146",
-    "@dbx-tools/core": "^0.9.146",
-    "@dbx-tools/path": "^0.9.146",
-    "@dbx-tools/shared-core": "^0.9.146",
+    "@dbx-tools/cli-args": "^0.9.149",
+    "@dbx-tools/core": "^0.9.149",
+    "@dbx-tools/path": "^0.9.149",
+    "@dbx-tools/shared-core": "^0.9.149",
     "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.146",
+  "version": "0.9.149",
   "types": "index.ts",
   "type": "module",
   "exports": {

package/src/_task-command.ts

@@ -40,7 +40,17 @@ export async function runTaskCommandAsync(
   args: readonly string[],
   options: TaskCommandOptions & { readonly signal?: AbortSignal } = {},
 ): Promise<void> {
-  await exec.spawn(executable(command), [...args], {
+  await spawnTaskCommand(cwd, command, args, options);
+}
+
+/** Start one supervised task command and return its live process handle. */
+export function spawnTaskCommand(
+  cwd: string,
+  command: string,
+  args: readonly string[],
+  options: TaskCommandOptions & { readonly signal?: AbortSignal } = {},
+): exec.ChildProcessResult {
+  return exec.spawn(executable(command), [...args], {
     cwd,
     env: options.env,
     stdout: "inherit",
@@ -51,6 +61,31 @@ export async function runTaskCommandAsync(
   });
 }
 
+/**
+ * Run a command with piped stdout forwarded line-by-line.
+ *
+ * The child sees a non-TTY output stream, so interactive redraw commands fall
+ * back to append-only output while the parent still receives live progress.
+ */
+export async function streamTaskCommand(
+  cwd: string,
+  command: string,
+  args: readonly string[],
+  options: TaskCommandOptions = {},
+): Promise<void> {
+  await exec.spawn(executable(command), [...args], {
+    cwd,
+    env: options.env,
+    stdout: {
+      capture: false,
+      onLine: (line) => console.log(line),
+    },
+    stderr: options.stderr ?? "inherit",
+    stdin: "ignore",
+    check: true,
+  });
+}
+
 /** Capture trimmed stdout, optionally throwing when the command fails. */
 export function captureTaskCommand(
   cwd: string,

package/tasks/local-publish.ts

@@ -1,10 +1,11 @@
 /** Build and publish the current workspace to configured loopback registries. */
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
+import type { ChildProcessResult } from "@dbx-tools/core/exec";
 import * as projectUtils from "@dbx-tools/core/project-utils";
 import { log, net } from "@dbx-tools/shared-core";
 import { activePythonIndexes, resolveLocalPypi } from "./python-registry.ts";
-import { runTaskCommandAsync } from "../src/_task-command.ts";
+import { spawnTaskCommand } from "../src/_task-command.ts";
 
 const logger = log.logger("projen:local-publish");
 
@@ -38,6 +39,24 @@ export function localPublishTaskPath(task: "publish.ts" | "publish-python.ts"):
   return fileURLToPath(new URL(task, import.meta.url));
 }
 
+/** Await concurrent publishers and terminate every live sibling after one fails. */
+export async function awaitLocalPublishers(
+  publishes: readonly ChildProcessResult[],
+): Promise<void> {
+  try {
+    await Promise.all(publishes);
+  } catch (error) {
+    await Promise.all(
+      publishes.map((publish) =>
+        publish.exitCode === null && publish.signalCode === null
+          ? publish.shutdown()
+          : Promise.resolve(),
+      ),
+    );
+    throw error;
+  }
+}
+
 /** Build and publish the current workspace directly to local registries. */
 export async function publishLocalRelease(
   options: LocalPublishOptions,
@@ -46,7 +65,7 @@ export async function publishLocalRelease(
   const localRegistry = resolveLocalRegistry(options.localRegistry);
   const activeIndexes = activePythonIndexes();
   const localPypi = resolveLocalPypi(options.localPypi, activeIndexes);
-  const publishes: Promise<unknown>[] = [];
+  const publishes: ChildProcessResult[] = [];
 
   if (
     options.localPypi.toLowerCase() === "auto" &&
@@ -62,7 +81,7 @@ export async function publishLocalRelease(
     const publishNpmScript = localPublishTaskPath("publish.ts");
     logger.info(`building and publishing npm workspace to ${localRegistry}`);
     publishes.push(
-      runTaskCommandAsync(root, process.execPath, [
+      spawnTaskCommand(root, process.execPath, [
         publishNpmScript,
         options.version,
         "--registry",
@@ -75,7 +94,7 @@ export async function publishLocalRelease(
     const publishPythonScript = localPublishTaskPath("publish-python.ts");
     logger.info(`building and publishing Python workspace to ${localPypi.publishUrl}`);
     publishes.push(
-      runTaskCommandAsync(root, process.execPath, [
+      spawnTaskCommand(root, process.execPath, [
         publishPythonScript,
         options.version,
         "--root",
@@ -93,7 +112,7 @@ export async function publishLocalRelease(
     return { npm: false, python: false };
   }
 
-  await Promise.all(publishes);
+  await awaitLocalPublishers(publishes);
   logger.success(`published local workspace ${options.version}`);
   return { npm: Boolean(localRegistry), python: Boolean(localPypi) };
 }

package/tasks/release.ts

@@ -11,7 +11,12 @@ import { publishLocalRelease } from "./local-publish.ts";
 import { TaskDirectoriesOptionSchema, TaskRootOptionSchema } from "./options.ts";
 import { writeReleaseNotes } from "./release-notes.ts";
 import { assertReleaseVersion } from "./release-version.ts";
-import { captureTaskCommand, runTaskCommand, taskCommandSucceeds } from "../src/_task-command.ts";
+import {
+  captureTaskCommand,
+  runTaskCommand,
+  streamTaskCommand,
+  taskCommandSucceeds,
+} from "../src/_task-command.ts";
 import { RELEASE_WORKFLOW_FILE } from "../src/release-context.ts";
 import {
   RELEASE_INSTALL_MODES,
@@ -134,11 +139,19 @@ export async function watchReleaseGithubActions(
     url: run.url,
   });
   try {
-    runTaskCommand(
+    await streamTaskCommand(
       root,
       "gh",
-      ["run", "watch", String(run.databaseId), "--repo", repository, "--interval", "3"],
-      { env: account.env },
+      [
+        "run",
+        "watch",
+        String(run.databaseId),
+        "--repo",
+        repository,
+        "--interval",
+        String(Math.max(1, Math.round(pollIntervalMs / 1_000))),
+      ],
+      { env: { ...account.env, NO_COLOR: "1" } },
     );
     runTaskCommand(
       root,
@@ -374,9 +387,10 @@ export async function runRelease(
     /** Path to complete release notes supplied instead of invoking Genie. */
     readonly releaseNotesFile?: string;
     readonly writeReleaseNotes?: typeof writeReleaseNotes;
-    /** Wait for and stream a matching tag-triggered GitHub Actions run. */
+    /** After local release actions, wait for and stream the matching GitHub Actions run. */
     readonly watchGithubActions?: boolean;
     readonly githubActionsWatcher?: ReleaseGithubActionsWatcher;
+    readonly resolveGithubAccount?: typeof projectUtils.resolveProjectGhAccount;
   },
 ): Promise<string> {
   const { branch, prefix, remote, root } = options;
@@ -480,23 +494,6 @@ export async function runRelease(
   }
   logger.success(`released ${tag}`, { sha: head });
 
-  if (shouldWatchReleaseGithubActions(options, selection)) {
-    const account = projectUtils.resolveProjectGhAccount(root, { remote });
-    if (account) {
-      await (options.githubActionsWatcher ?? watchReleaseGithubActions)({
-        account,
-        head,
-        root,
-        tag,
-      });
-    } else {
-      logger.info("skipping GitHub Actions release watch: no authenticated account", {
-        remote,
-        tag,
-      });
-    }
-  }
-
   // Restore local deploys: when a non-standard (loopback) npm or uv registry is
   // configured, publish the freshly tagged version to it directly. Detection and
   // publishing are owned by local-publish.ts; this no-ops on standard registries.
@@ -518,6 +515,25 @@ export async function runRelease(
     ]);
   }
 
+  if (shouldWatchReleaseGithubActions(options, selection)) {
+    const account = (options.resolveGithubAccount ?? projectUtils.resolveProjectGhAccount)(root, {
+      remote,
+    });
+    if (account) {
+      await (options.githubActionsWatcher ?? watchReleaseGithubActions)({
+        account,
+        head,
+        root,
+        tag,
+      });
+    } else {
+      logger.info("skipping GitHub Actions release watch: no authenticated account", {
+        remote,
+        tag,
+      });
+    }
+  }
+
   return tag;
 }
 
@@ -552,7 +568,7 @@ export const ReleaseOptionsSchema = z.object({
   watchGithubActions: z
     .boolean()
     .default(true)
-    .describe("Wait for and stream the tag-triggered GitHub Actions release"),
+    .describe("Wait for and log the tag-triggered GitHub Actions release"),
   releaseNotes: z
     .boolean()
     .default(true)