@dbx-tools/projen 0.9.93 → 0.9.99

package/README.md

@@ -308,6 +308,18 @@ Built-in tag mixins set runtime defaults for `shared`, `node`, `cli`, `server`,
 and `ui`. Repo-specific mixins layer package-specific dependencies,
 scripts, and generated files on top.
 
+Every workspace root exposes a generic development watcher:
+
+```sh
+bun run dev:watch [--debounce-ms 15000] [--restart-key r] <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
+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.
+
 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
@@ -326,6 +338,22 @@ wrong fix, since the consumer authors no JSX and cannot know a transitive
 dependency started to. The option is inert without JSX in the graph: it selects
 how JSX syntax compiles and adds no lib, global, or type dependency.
 
+Keep the generated tsconfigs package-local. Each package build config owns its
+`rootDir`, declaration output, package-specific globals, and publish boundary.
+Projen also places a no-emit config in each `test/` directory so TypeScript 6,
+editors, and type-aware ESLint resolve the nearest project for test files. A
+single config per runtime folder would merge package output boundaries and would
+remove that nearest-config behavior. The runtime tag mixins already centralize
+the environment differences without replacing the package configs.
+
+Compilation preserves TypeScript's incremental cache. The root compile task
+passes the package configs to batched `tsc --build` processes, and each config
+retains its own `tsconfig.tsbuildinfo`. Synthesis also retains Projen's native
+change detection: unchanged generated files are not rewritten, and dependency
+installation runs only when the generated root manifest changes or
+`node_modules` is absent. Repository discovery is process-cached so every child
+package reuses the root probe instead of invoking `git`, `ssh`, and `gh` again.
+
 ## Work With Package Discovery
 
 ```ts
@@ -485,13 +513,15 @@ bun run release --publish local --install never
 bun run release --local-registry false --local-pypi auto
 bun run release --demo-deploy
 bun run release --no-release-notes
+bun run release --release-notes-text "# Release 1.2.3"
+bun run release --release-notes-file ./notes.md
 bun run release --release-notes-instructions "Focus on operator-visible changes."
 ```
 
-`--demo-deploy` is off by default. After tagging and any local registry
-publication it runs `bun run demo:deploy`, which stages the AppKit demo
-from locally compiled Node packages and locally built Python wheels, resolves
-the configured/default workspace profile through `@dbx-tools/auth`,
+`--demo-deploy` is off by default and requires `--profile <name>`. After tagging
+and any local registry publication it runs `bun run demo:deploy`, which stages
+the AppKit demo from locally compiled Node packages and locally built Python
+wheels, resolves only the selected workspace profile through `@dbx-tools/auth`,
 force-refreshes its token with interactive login fallback, and deploys it. That
 step is local only and is not recorded in the annotated tag.
 
@@ -500,6 +530,8 @@ After bump and configured validation, release writes
 --ephemeral -o`. The standard prompt forbids running tests or other validation
 commands. If Genie fails or writes an empty file, the step keeps going with a
 short git-log summary. `--no-release-notes` skips the file.
+`--release-notes-text` writes supplied markdown directly, while
+`--release-notes-file` copies a prepared markdown file. Both bypass Genie.
 `--release-notes-instructions` appends run-specific guidance to the standard
 Genie prompt. Notes are committed with the version bump and are not recorded in
 the annotated tag. They are skipped on `--no-bump` because that path requires an
@@ -510,7 +542,8 @@ already committed tree.
 installed while still regenerating versioned sources. Local release validation
 runs `eslint:fix` before branch preparation and bump, then runs the selected
 fail-closed tasks; CI remains check-only.
-`--no-validation` skips optional task checks locally and in CI, not version or immutable-source checks.
+CI rebuilds the selected release artifacts instead of checking generated-source fingerprints.
+`--no-validation` skips optional task checks locally and in CI, not workspace-version or immutable-source checks.
 `--no-docs` skips building and deploying the site, not package README validation.
 Scopes select artifacts, not the normal commit and tag-push transaction.
 The annotated tag records CI step selections, so publishing a selected scope does
@@ -576,10 +609,13 @@ release [options]
 | `--no-pypi`                           | skip Python build and publication, including local Python publication                         |
 | `--docs`                              | build and deploy docs for a selected scope                                                    |
 | `--no-docs`                           | skip documentation build and deployment                                                       |
-| `--no-validation`                     | skip optional release validation tasks; version/source checks remain mandatory                |
+| `--no-validation`                     | skip optional release validation tasks; workspace version checks remain mandatory             |
 | `--no-release-notes`                  | skip writing docs/releases notes (Genie and git-log fallback)                                 |
+| `--release-notes-text <markdown>`     | write supplied markdown without invoking Genie                                                |
+| `--release-notes-file <path>`         | copy supplied markdown without invoking Genie                                                 |
 | `--release-notes-instructions <text>` | append custom instructions to the Genie release-notes prompt                                  |
 | `--demo-deploy`                       | after tagging, stage and deploy the AppKit demo app (off by default)                          |
+| `--profile <name>`                    | Databricks CLI profile for --demo-deploy                                                      |
 | `--no-local-publish`                  | skip publishing to configured local registries                                                |
 | `--local-registry <auto\|false\|url>` | local npm registry selection (default: "auto")                                                |
 | `--local-pypi <auto\|false\|url>`     | local devpi registry selection (default: "auto")                                              |

package/index.ts

@@ -3,13 +3,14 @@
 // 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.93";
+export const PACKAGE_VERSION = "0.9.99";
 export * as barrels from "./src/barrels.ts";
 export * as bunApp from "./src/bun-app.ts";
 export * as bunWorkflow from "./src/bun-workflow.ts";
 export * as clean from "./src/clean.ts";
 export * as codegen from "./src/codegen.ts";
 export * as dbxToolsConfig from "./src/dbx-tools-config.ts";
+export * as devWatch from "./src/dev-watch.ts";
 export * as engineRoot from "./src/engine-root.ts";
 export * as generated from "./src/generated.ts";
 export * as mixin from "./src/mixin.ts";
@@ -40,6 +41,7 @@ export { BUN_DEV_OVERRIDE, BUN_BUILD_OVERRIDE, BUN_APP_OVERRIDES, RootBunfigFile
 export { BUN_VERSION } 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, SERVER_WATCH_DISABLED_ENV } from "./src/dev-watch.ts";
 export { resolvePkgRoot } from "./src/engine-root.ts";
 export { PYTHON_GENERATED_PACKAGE, PYTHON_SYNC_PACKAGE } from "./src/generated.ts";
 export type { HeaderOpts } from "./src/generated.ts";

package/package.json

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

package/src/dev-watch.ts

@@ -0,0 +1,15 @@
+/** Root task and CLI defaults for the generic development command watcher. */
+
+/** Projen task exposed as `bun run dev:watch`. */
+export const DEV_WATCH_TASK = "dev:watch";
+/** Shipped task entrypoint invoked by {@link DEV_WATCH_TASK}. */
+export const DEV_WATCH_SCRIPT = "dev-watch.ts";
+/** Quiet period after the last watched change before restarting. */
+export const DEV_RESTART_DEBOUNCE_MS = 15_000;
+/** Interactive key that requests an immediate restart. */
+export const DEV_RESTART_KEY = "r";
+/**
+ * Process environment that skips wrapping or running the file watcher.
+ * Parsed with `configUtils.boolean` (`1` / `true` / `yes` disable watch).
+ */
+export const SERVER_WATCH_DISABLED_ENV = "SERVER_WATCH_DISABLED";

package/src/pnpm-workspace.ts

@@ -109,6 +109,7 @@ const DEFAULT_ALLOW_BUILDS: AllowBuilds = {
 const DEFAULT_OVERRIDES: Readonly<Record<string, string>> = {
   bun: BUN_VERSION,
   glob: "^13.0.0",
+  "p-map": "7.0.8",
 };
 
 /**

package/src/project-js.ts

@@ -12,7 +12,7 @@ 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, javascript, typescript } from "projen";
+import { Component, LogLevel, Project, type Task, javascript, typescript } from "projen";
 import { JobPermission, type JobStep } from "projen/lib/github/workflows-model";
 import type { ReleaseProjectOptions } from "projen/lib/release";
 import { generateBarrels } from "./barrels.ts";
@@ -21,6 +21,7 @@ import { BUN_APP_OVERRIDES, RootBunfigFile } from "./bun-app.ts";
 import { 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";
 import { resolvePkgRoot } from "./engine-root.ts";
 import * as mixin from "./mixin.ts";
 import {
@@ -586,7 +587,6 @@ export type DBXToolsJavaScriptProjectOptions = CommonProjectOptions &
     /** Release build prerequisites installed before repository validation tasks. */
     readonly releaseSetupSteps?: readonly JobStep[];
     /** Repository-specific synthesis commands run before release source verification. */
-    readonly releaseSynthesisCommands?: readonly string[];
     /** Set to `false` to omit normal npm workspace publication. */
     readonly nodeRelease?: boolean;
     /** Unified dbx-tools release workflow, or no release surface. Defaults to `dbx-tools`. */
@@ -604,8 +604,9 @@ export type DBXToolsJavaScriptProjectOptions = CommonProjectOptions &
     readonly extraWorkspaceMembers?: readonly string[];
     /**
      * Install workspace dependencies once from the custom root instead of once
-     * per child project during post-synthesis. Defaults to `true`; set `false` to
-     * preserve projen's native per-project install tasks.
+     * per child project during post-synthesis. Defaults to `true`; set `false`
+     * on the root to preserve every native child install, or on an individual
+     * child to retain that package's native install lifecycle.
      */
     readonly rootInstallOnly?: boolean;
   };
@@ -635,7 +636,7 @@ export class DBXToolsNodeProject
   rootTsconfig?: DBXToolsRootTsconfig;
   readonly extraWorkspaceMembers: readonly string[];
   readonly releaseBranch: string;
-  private readonly rootInstallOnly: boolean;
+  readonly rootInstallOnly: boolean;
 
   constructor(options: DBXToolsJavaScriptProjectOptions = {}) {
     validateReleaseOptions(options);
@@ -683,18 +684,66 @@ export class DBXToolsNodeProject
  *
  * Every projen child has its own `NodePackage` post-synth hook, which otherwise
  * runs the install task against the same root workspace once per package. Clear
- * the public child install tasks while leaving dependency resolution and the
- * root's real install/install:ci tasks intact. Applied in root `preSynthesize`
- * so manually attached late children are included and repeated synths remain
- * idempotent.
+ * the public child install tasks and suppress Projen's protected install hook,
+ * while leaving the rest of `NodePackage.postSynthesize` (including dependency
+ * resolution) and the root's real install/install:ci tasks intact. A child can
+ * set `rootInstallOnly: false` when it owns a package-local dependency tree.
+ * Applied in root `preSynthesize` so manually attached late children are
+ * included and repeated synths remain idempotent.
  */
+class RootInstallOnlyChild extends Component {
+  private readonly child: DBXToolsNodeProject | DBXToolsTypeScriptProject;
+  private readonly installDependencies: (trigger: unknown) => void;
+  private suppressed = false;
+
+  constructor(child: DBXToolsNodeProject | DBXToolsTypeScriptProject) {
+    super(child, "RootInstallOnly");
+    this.child = child;
+    const nodePackage = child.package as unknown as {
+      installDependencies(trigger: unknown): void;
+    };
+    if (typeof nodePackage.installDependencies !== "function") {
+      throw new Error("Projen NodePackage no longer exposes installDependencies");
+    }
+    this.installDependencies = nodePackage.installDependencies;
+  }
+
+  public override preSynthesize(): void {
+    const nodePackage = this.child.package as unknown as {
+      installDependencies(trigger: unknown): void;
+    };
+    if (
+      hasCustomInstallSteps(
+        this.child.package.installTask,
+        this.child.package.installAndUpdateLockfileCommand,
+      ) ||
+      hasCustomInstallSteps(this.child.package.installCiTask, this.child.package.installCommand)
+    ) {
+      if (this.suppressed) nodePackage.installDependencies = this.installDependencies;
+      this.suppressed = false;
+      return;
+    }
+    this.child.package.installTask.reset();
+    this.child.package.installCiTask.reset();
+    nodePackage.installDependencies = () => {};
+    this.suppressed = true;
+  }
+}
+
+function hasCustomInstallSteps(task: Task, defaultCommand: string): boolean {
+  if (task.steps.length === 0) return false;
+  if (task.steps.length !== 1) return true;
+  const step = task.steps[0]!;
+  return step.exec !== defaultCommand;
+}
+
 export const ROOT_INSTALL_ONLY_MIXIN = mixin.create(
   (construct: IConstruct): construct is DBXToolsNodeProject | DBXToolsTypeScriptProject =>
     (construct instanceof DBXToolsNodeProject || construct instanceof DBXToolsTypeScriptProject) &&
-    construct.parent !== undefined,
+    construct.parent !== undefined &&
+    construct.rootInstallOnly,
   (child) => {
-    child.package.installTask.reset();
-    child.package.installCiTask.reset();
+    if (!child.node.tryFindChild("RootInstallOnly")) new RootInstallOnlyChild(child);
   },
 );
 
@@ -716,7 +765,7 @@ export class DBXToolsTypeScriptProject
   rootTsconfig?: DBXToolsRootTsconfig;
   readonly extraWorkspaceMembers: readonly string[];
   readonly releaseBranch: string;
-  private readonly rootInstallOnly: boolean;
+  readonly rootInstallOnly: boolean;
 
   constructor(options: DBXToolsTypeScriptProjectOptions) {
     validateReleaseOptions(options);
@@ -1070,6 +1119,11 @@ function resolveTags(p: DiscoveredPackage, tagPaths: Record<string, string[]>):
 function registerRootTasks(project: javascript.NodeProject): void {
   project.addTask("barrels", { execArgs: taskCommand("barrels.ts") });
   project.addTask("clean", { execArgs: taskCommand("clean.ts"), receiveArgs: true });
+  project.addTask(DEV_WATCH_TASK, {
+    description: "Restart a development command after watched changes settle",
+    execArgs: taskCommand(DEV_WATCH_SCRIPT),
+    receiveArgs: true,
+  });
   project.addTask("sync", {
     execArgs: taskCommand("sync.ts"),
     receiveArgs: true,
@@ -1325,7 +1379,6 @@ function initProject(
       pythonRoot: options.releasePythonRoot,
       validationTasks: options.releaseValidationTasks,
       setupSteps: options.releaseSetupSteps,
-      synthesisCommands: options.releaseSynthesisCommands,
     });
   }
 }