bun-workspaces 1.0.2 → 1.1.1

package/README.md

@@ -10,7 +10,7 @@ A CLI and API to enhance your monorepo development with Bun's [native workspaces
 
 - Works right away, with no boilerplate required 🍔🍴
 - Get metadata about your monorepo 🤖
-- Run package.json scripts across workspaces 📋
+- Orchestrate your workspaces' `package.json` scripts 📋
 - Run inline [Bun Shell](https://bun.com/docs/runtime/shell) scripts in workspaces 🐚
 
 This is a tool to help manage a Bun monorepo, offering features beyond what [Bun's --filter feature](https://bun.com/docs/pm/filter) can do. It can be used to get a variety of metadata about your project and run scripts across your workspaces with advanced control.
@@ -84,12 +84,13 @@ bw run "bun build" --inline # Run an inline command via the Bun shell
 bw run lint --parallel=false # Run in series
 bw run lint --parallel=2 # Run in parallel with a max of 2 concurrent scripts
 bw run lint --parallel=auto # Default, based on number of available logical CPUs
+bw run lint --parallel=50% # Run in parallel with a max of 50% of the "auto" limit
 
 # Use the grouped output style (default when on a TTY)
 bw run my-script --output-style=grouped
 
 # Set the max preview lines for script output in grouped output style
-bw run my-script --output-style=grouped --grouped-lines=all
+bw run my-script --output-style=grouped --grouped-lines=auto
 bw run my-script --output-style=grouped --grouped-lines=10
 
 # Use simple script output with workspace prefixes (default when not on a TTY)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bun-workspaces",
-  "version": "1.0.2",
+  "version": "1.1.1",
   "description": "A monorepo management tool for Bun, with a CLI and API to enhance Bun's native workspaces.",
   "license": "MIT",
   "main": "src/index.mjs",

package/src/cli/commands/commandHandlerUtils.d.ts

@@ -14,6 +14,7 @@ export type GlobalCommandContext = {
   middleware: CliMiddleware;
   outputWriters: Required<WriteOutputOptions>;
   terminalWidth: number;
+  terminalHeight: number;
 };
 export type ProjectCommandContext = GlobalCommandContext & {
   project: FileSystemProject;

package/src/cli/commands/commandsConfig.d.ts

@@ -26,7 +26,6 @@ export type CliProjectCommandName = Exclude<
   CliGlobalCommandName
 >;
 export declare const JSON_FLAGS: readonly ["-j", "--json"];
-export declare const DEFAULT_GROUPED_LINES = 20;
 export declare const CLI_COMMANDS_CONFIG: {
   readonly doctor: {
     readonly command: "doctor";
@@ -153,7 +152,7 @@ export declare const CLI_COMMANDS_CONFIG: {
       };
       readonly groupedLines: {
         readonly flags: ["-L", "--grouped-lines <count>"];
-        readonly description: 'With "grouped" output, the max preview lines (number or "all", default 20)';
+        readonly description: 'With grouped output, the max preview lines (number or "auto", default "auto")';
       };
       readonly noPrefix: {
         readonly flags: ["-N", "--no-prefix"];
@@ -314,7 +313,7 @@ export declare const getCliCommandConfig: (commandName: CliCommandName) =>
         };
         readonly groupedLines: {
           readonly flags: ["-L", "--grouped-lines <count>"];
-          readonly description: 'With "grouped" output, the max preview lines (number or "all", default 20)';
+          readonly description: 'With grouped output, the max preview lines (number or "auto", default "auto")';
         };
         readonly noPrefix: {
           readonly flags: ["-N", "--no-prefix"];

package/src/cli/commands/commandsConfig.mjs

@@ -4,7 +4,6 @@ import { OUTPUT_STYLE_VALUES } from "./runScript/output/outputStyle.mjs"; // CON
 // CONCATENATED MODULE: ./src/cli/commands/commandsConfig.ts
 
 const JSON_FLAGS = ["-j", "--json"];
-const DEFAULT_GROUPED_LINES = 20;
 const CLI_COMMANDS_CONFIG = {
   doctor: {
     command: "doctor",
@@ -133,7 +132,7 @@ const CLI_COMMANDS_CONFIG = {
       },
       groupedLines: {
         flags: ["-L", "--grouped-lines <count>"],
-        description: `With "grouped" output, the max preview lines (number or "all", default ${DEFAULT_GROUPED_LINES})`,
+        description: `With grouped output, the max preview lines (number or "auto", default "auto")`,
       },
       noPrefix: {
         flags: ["-N", "--no-prefix"],
@@ -176,7 +175,6 @@ const getCliCommandNames = () => Object.keys(CLI_COMMANDS_CONFIG);
 
 export {
   CLI_COMMANDS_CONFIG,
-  DEFAULT_GROUPED_LINES,
   JSON_FLAGS,
   getCliCommandConfig,
   getCliCommandNames,

package/src/cli/commands/runScript/handleRunScript.mjs

@@ -1,11 +1,11 @@
 import fs from "fs";
 import path from "path";
+import { expandHomePath } from "../../../internal/core/index.mjs";
 import { logger } from "../../../internal/logger/index.mjs";
 import {
   handleProjectCommand,
   splitWorkspacePatterns,
 } from "../commandHandlerUtils.mjs";
-import { DEFAULT_GROUPED_LINES } from "../commandsConfig.mjs";
 import {
   getDefaultOutputStyle,
   validateOutputStyle,
@@ -17,9 +17,9 @@ import {
 } from "./output/renderGroupedOutput.mjs";
 import { renderPlainOutput } from "./output/renderPlainOutput.mjs"; // CONCATENATED MODULE: external "fs"
 // CONCATENATED MODULE: external "path"
+// CONCATENATED MODULE: external "../../../internal/core/index.mjs"
 // CONCATENATED MODULE: external "../../../internal/logger/index.mjs"
 // CONCATENATED MODULE: external "../commandHandlerUtils.mjs"
-// CONCATENATED MODULE: external "../commandsConfig.mjs"
 // CONCATENATED MODULE: external "./output/outputStyle.mjs"
 // CONCATENATED MODULE: external "./output/renderGroupedOutput.mjs"
 // CONCATENATED MODULE: external "./output/renderPlainOutput.mjs"
@@ -28,7 +28,13 @@ import { renderPlainOutput } from "./output/renderPlainOutput.mjs"; // CONCATENA
 const runScript = handleProjectCommand(
   "runScript",
   async (
-    { project, postTerminatorArgs, outputWriters, terminalWidth },
+    {
+      project,
+      postTerminatorArgs,
+      outputWriters,
+      terminalWidth,
+      terminalHeight,
+    },
     positionalScript,
     positionalWorkspacePatterns,
     options,
@@ -114,10 +120,12 @@ const runScript = handleProjectCommand(
     logger.debug(`Script name: ${scriptName}`);
     const stripDisruptiveControls = workspaces.length > 1 || !!options.parallel;
     logger.debug(`Strip disruptive controls: ${stripDisruptiveControls}`);
-    let groupedLines = DEFAULT_GROUPED_LINES;
+    let groupedLines = "auto";
     if (options.groupedLines) {
       if (options.groupedLines === "all") {
         groupedLines = "all";
+      } else if (options.groupedLines === "auto") {
+        groupedLines = "auto";
       } else {
         const parsedGroupedLines = parseInt(options.groupedLines);
         if (parsedGroupedLines <= 0 || isNaN(parsedGroupedLines)) {
@@ -148,6 +156,7 @@ const runScript = handleProjectCommand(
           groupedLines,
           outputWriters,
           terminalWidth,
+          terminalHeight,
         ),
       prefixed: () =>
         renderPlainOutput(output, outputWriters, {
@@ -196,7 +205,7 @@ const runScript = handleProjectCommand(
     if (options.jsonOutfile) {
       const fullOutputPath = path.resolve(
         project.rootDirectory,
-        options.jsonOutfile,
+        expandHomePath(options.jsonOutfile),
       );
       // Check if can make directory
       const jsonOutputDir = path.dirname(fullOutputPath);

package/src/cli/commands/runScript/output/renderGroupedOutput.d.ts

@@ -67,8 +67,9 @@ export declare const renderGroupedOutput: (
   output: RunScriptAcrossWorkspacesOutput,
   summary: Promise<RunScriptsSummary<RunWorkspaceScriptMetadata>>,
   scriptEventTarget: ScriptEventTarget,
-  activeScriptLines: number | "all",
+  activeScriptLines: number | "all" | "auto",
   outputWriters: Required<WriteOutputOptions>,
   terminalWidth: number,
+  terminalHeight: number,
 ) => Promise<void>;
 export {};

package/src/cli/commands/runScript/output/renderGroupedOutput.mjs

@@ -55,7 +55,7 @@ const textOps = {
 };
 const STATUS_COLORS = {
   pending: "gray",
-  running: "intenseCyan",
+  running: "intenseMagenta",
   skipped: "gray",
   success: "intenseGreen",
   failure: "intenseRed",
@@ -63,7 +63,8 @@ const STATUS_COLORS = {
   cancelled: "gray",
   killed: "intenseRed",
 };
-const BORDER_COLOR = "blue";
+const BORDER_COLOR = "intenseCyan";
+const HEADER_ROWS_PER_WORKSPACE = 2;
 const renderGroupedOutput = async (
   workspaces,
   output,
@@ -72,6 +73,7 @@ const renderGroupedOutput = async (
   activeScriptLines,
   outputWriters,
   terminalWidth,
+  terminalHeight,
 ) => {
   const workspaceState = workspaces.reduce((acc, workspace) => {
     acc[workspace.name] = {
@@ -112,7 +114,26 @@ const renderGroupedOutput = async (
     if (isFinal) {
       didFinalRender = true;
     }
-    const width = Math.max(2, terminalWidth || process.stdout.columns);
+    const width = Math.max(2, terminalWidth || process.stdout.columns || 2);
+    const height = Math.max(1, terminalHeight || process.stdout.rows || 1);
+    // Compute the max script lines to show per workspace based on terminal
+    // height, so the live TUI never exceeds the visible viewport (cursor up
+    // is clamped and cannot recover from overflow). Each workspace occupies
+    // HEADER_ROWS_PER_WORKSPACE rows plus one row for the hidden-lines
+    // indicator, with one additional safety row to prevent scroll on the
+    // final newline. The user's activeScriptLines acts as a ceiling if lower.
+    const availableRows = Math.max(
+      1,
+      height - 1 - workspaces.length * (HEADER_ROWS_PER_WORKSPACE + 1),
+    );
+    const computedScriptLines = Math.max(
+      1,
+      Math.floor(availableRows / workspaces.length),
+    );
+    const effectiveScriptLines =
+      activeScriptLines === "all" || activeScriptLines === "auto"
+        ? computedScriptLines
+        : Math.min(activeScriptLines, computedScriptLines);
     const linesToWrite = [];
     const workspaceBoxContents = {};
     workspaces.forEach((workspace) => {
@@ -134,69 +155,51 @@ const renderGroupedOutput = async (
       } else if (exitState === "signal") {
         statusText += ` (signal: ${state.signal})`;
       }
-      const workspaceLine = "Workspace: " + textOps.bold(workspace.name);
+      const workspaceLine =
+        textOps[BORDER_COLOR]("Workspace: ") + textOps.bold(workspace.name);
       const statusLine =
-        "   Status: " + textOps[STATUS_COLORS[state.status]](statusText);
+        textOps[BORDER_COLOR]("   Status: ") +
+        textOps[STATUS_COLORS[state.status]](statusText);
       workspaceBoxContents[workspace.name] = {
         name: workspaceLine,
         status: statusLine,
       };
     });
     const padding = 4; // left border, spaces, right border
-    const workspaceBoxWidth = Math.min(
-      width,
-      Math.max(
-        ...Object.values(workspaceBoxContents).map((content) =>
-          Math.max(
-            calculateVisibleLength(content.name),
-            calculateVisibleLength(content.status),
-          ),
-        ),
-      ) + padding,
-    );
     workspaces.forEach((workspace) => {
       const state = workspaceState[workspace.name];
       const { name: workspaceNameContent, status: statusTextContent } =
         workspaceBoxContents[workspace.name];
-      linesToWrite.push({
-        text: textOps[BORDER_COLOR](
-          "┌" + "─".repeat(workspaceBoxWidth - 2) + "┐",
-        ),
-        type: "border",
-      });
-      const borderText = (text) => {
+      const borderText = (text, top, headerWidth) => {
         const visibleLength = calculateVisibleLength(text);
         const truncated =
           visibleLength > width - padding
             ? truncateTerminalString(text, width - padding - 1) + "\x1b[0m…"
             : text;
         return (
-          textOps[BORDER_COLOR]("│ ") +
+          textOps[BORDER_COLOR](top ? "┌ " : "└ ") +
           truncated +
-          " ".repeat(Math.max(0, workspaceBoxWidth - visibleLength - padding)) +
-          textOps[BORDER_COLOR](" │")
+          " ".repeat(Math.max(0, headerWidth - visibleLength - padding)) +
+          textOps[BORDER_COLOR](top ? " ┐" : " ┘")
         );
       };
+      const headerWidth = Math.min(
+        width,
+        Math.max(
+          Bun.stripANSI(workspaceNameContent).length,
+          Bun.stripANSI(statusTextContent).length,
+        ) + padding,
+      );
       linesToWrite.push({
-        text: borderText(workspaceNameContent),
+        text: borderText(workspaceNameContent, true, headerWidth),
         type: "borderedContent",
       });
       linesToWrite.push({
-        text: borderText(statusTextContent),
+        text: borderText(statusTextContent, false, headerWidth),
         type: "borderedContent",
       });
-      linesToWrite.push({
-        text: textOps[BORDER_COLOR](
-          "└" + "─".repeat(workspaceBoxWidth - 2) + "┘",
-        ),
-        type: "border",
-      });
-      if (
-        activeScriptLines !== "all" &&
-        state.lines.length > activeScriptLines &&
-        !isFinal
-      ) {
-        const hiddenLines = state.lines.length - activeScriptLines;
+      if (state.lines.length > effectiveScriptLines && !isFinal) {
+        const hiddenLines = state.lines.length - effectiveScriptLines;
         linesToWrite.push({
           text: textOps.gray(
             `(${hiddenLines} line${hiddenLines === 1 ? "" : "s"} hidden until exit)`,
@@ -206,7 +209,7 @@ const renderGroupedOutput = async (
       }
       linesToWrite.push(
         ...state.lines
-          .slice(isFinal ? undefined : -activeScriptLines)
+          .slice(isFinal ? undefined : -effectiveScriptLines)
           .map((line) => ({
             text: line.text,
             type: "scriptOutput",
@@ -214,6 +217,12 @@ const renderGroupedOutput = async (
       );
       return linesToWrite;
     });
+    if (isFinal) {
+      linesToWrite.push({
+        text: textOps[BORDER_COLOR]("─ Summary ─"),
+        type: "borderedContent",
+      });
+    }
     if (previousHeight > 0) {
       // clear previous frame
       outputWriters.stdout(cursorOps.up(previousHeight));

package/src/cli/createCli.d.ts

@@ -10,6 +10,7 @@ export interface RunCliOptions {
   middleware?: CliMiddlewareOptions;
   writeOutput?: WriteOutputOptions;
   terminalWidth?: number;
+  terminalHeight?: number;
 }
 export interface CLI {
   run: (options?: RunCliOptions) => Promise<void>;

package/src/cli/createCli.mjs

@@ -30,6 +30,7 @@ const createCli = ({ defaultCwd = process.cwd(), defaultMiddleware } = {}) => {
     middleware: _runMiddleware,
     writeOutput,
     terminalWidth = process.stdout.columns,
+    terminalHeight = process.stdout.rows,
   } = {}) => {
     const middleware = resolveMiddleware(
       defaultMiddleware ?? {},
@@ -93,7 +94,6 @@ const createCli = ({ defaultCwd = process.cwd(), defaultMiddleware } = {}) => {
       const { project, projectError } = initializeWithGlobalOptions(
         program,
         args,
-        defaultCwd,
         middleware,
       );
       middleware.findProject({
@@ -113,6 +113,7 @@ const createCli = ({ defaultCwd = process.cwd(), defaultMiddleware } = {}) => {
         middleware,
         outputWriters,
         terminalWidth,
+        terminalHeight,
       });
       defineGlobalCommands({
         program,
@@ -120,6 +121,7 @@ const createCli = ({ defaultCwd = process.cwd(), defaultMiddleware } = {}) => {
         middleware,
         outputWriters,
         terminalWidth,
+        terminalHeight,
       });
       logger.debug(`Commands initialized. Parsing args...`);
       middleware.preParse({

package/src/cli/globalOptions/globalOptions.d.ts

@@ -3,7 +3,6 @@ import type { CliMiddleware } from "../middleware";
 export declare const initializeWithGlobalOptions: (
   program: Command,
   args: string[],
-  defaultCwd: string,
   middleware: CliMiddleware,
 ) => {
   project: import("../../internal/core").Simplify<{

package/src/cli/globalOptions/globalOptions.mjs

@@ -1,7 +1,7 @@
 import fs from "fs";
 import path from "path";
 import { Option } from "commander";
-import { defineErrors } from "../../internal/core/index.mjs";
+import { defineErrors, expandHomePath } from "../../internal/core/index.mjs";
 import { logger } from "../../internal/logger/index.mjs";
 import {
   createFileSystemProject,
@@ -19,6 +19,8 @@ import { getCliGlobalOptionConfig } from "./globalOptionsConfig.mjs"; // CONCATE
 const ERRORS = defineErrors(
   "WorkingDirectoryNotFound",
   "WorkingDirectoryNotADirectory",
+  "NoCwdAndWorkspaceRoot",
+  "ProjectRootNotFound",
 );
 const addGlobalOption = (program, optionName, defaultOverride) => {
   const { mainOption, shortOption, description, param, values, defaultValue } =
@@ -42,13 +44,55 @@ const addGlobalOption = (program, optionName, defaultOverride) => {
     );
   }
 };
-const getWorkingDirectoryFromArgs = (program, args, defaultCwd) => {
-  addGlobalOption(program, "cwd", defaultCwd);
+const getWorkingDirectoryFromArgs = (program, args) => {
+  addGlobalOption(program, "cwd");
+  addGlobalOption(program, "workspaceRoot");
   program.parseOptions(args);
-  return program.opts().cwd;
+  const { cwd, workspaceRoot } = program.opts();
+  if (cwd && workspaceRoot) {
+    throw new ERRORS.NoCwdAndWorkspaceRoot(
+      `Cannot use both ${getCliGlobalOptionConfig("cwd").mainOption} (${getCliGlobalOptionConfig("cwd").shortOption}) and ${getCliGlobalOptionConfig("workspaceRoot").mainOption} (${getCliGlobalOptionConfig("workspaceRoot").shortOption}) options together`,
+    );
+  }
+  return {
+    cwdOption: cwd,
+    workspaceRootOption: workspaceRoot,
+  };
 };
-const defineGlobalOptions = (program, args, defaultCwd, middleware) => {
-  const cwd = getWorkingDirectoryFromArgs(program, args, defaultCwd);
+const findRootFromCwd = () => {
+  let currentDirectory = process.cwd();
+  while (true) {
+    const packageJsonPath = path.join(currentDirectory, "package.json");
+    if (fs.existsSync(packageJsonPath)) {
+      try {
+        const packageJsonContent = JSON.parse(
+          fs.readFileSync(packageJsonPath, "utf8"),
+        );
+        if (packageJsonContent.workspaces) {
+          return currentDirectory;
+        }
+      } catch {
+        continue;
+      }
+    }
+    const parentDirectory = path.dirname(currentDirectory);
+    if (parentDirectory === currentDirectory) {
+      break;
+    }
+    currentDirectory = parentDirectory;
+  }
+  throw new ERRORS.ProjectRootNotFound(
+    `${getCliGlobalOptionConfig("workspaceRoot").shortOption}|${getCliGlobalOptionConfig("workspaceRoot").mainOption} option: Project root not found from current working directory "${process.cwd()}"`,
+  );
+};
+const defineGlobalOptions = (program, args, middleware) => {
+  const { cwdOption, workspaceRootOption } = getWorkingDirectoryFromArgs(
+    program,
+    args,
+  );
+  const cwd = expandHomePath(
+    cwdOption || (workspaceRootOption ? findRootFromCwd() : process.cwd()),
+  );
   const exists = fs.existsSync(cwd);
   const isDirectory = exists ? fs.statSync(cwd).isDirectory() : false;
   middleware.processWorkingDirectory({
@@ -98,9 +142,9 @@ const applyGlobalOptions = (options) => {
     projectError: error,
   };
 };
-const initializeWithGlobalOptions = (program, args, defaultCwd, middleware) => {
+const initializeWithGlobalOptions = (program, args, middleware) => {
   program.allowUnknownOption(true);
-  const { cwd } = defineGlobalOptions(program, args, defaultCwd, middleware);
+  const { cwd } = defineGlobalOptions(program, args, middleware);
   program.parseOptions(args);
   program.allowUnknownOption(false);
   const options = program.opts();

package/src/cli/globalOptions/globalOptionsConfig.d.ts

@@ -3,6 +3,7 @@ export interface CliGlobalOptions {
   logLevel: LogLevelSetting;
   cwd: string;
   includeRoot: boolean;
+  workspaceRoot: boolean;
 }
 export interface CliGlobalOptionConfig {
   mainOption: string;
@@ -28,7 +29,7 @@ export declare const getCliGlobalOptionConfig: (
       readonly mainOption: "--cwd";
       readonly shortOption: "-d";
       readonly description: "Working directory";
-      readonly defaultValue: ".";
+      readonly defaultValue: "";
       readonly values: null;
       readonly param: "path";
     }
@@ -39,5 +40,13 @@ export declare const getCliGlobalOptionConfig: (
       readonly defaultValue: "";
       readonly values: null;
       readonly param: "";
+    }
+  | {
+      readonly mainOption: "--workspace-root";
+      readonly shortOption: "-w";
+      readonly description: "Run from the project root above the current working directory";
+      readonly defaultValue: "";
+      readonly values: null;
+      readonly param: "";
     };
 export declare const getCliGlobalOptionNames: () => CliGlobalOptionName[];

package/src/cli/globalOptions/globalOptionsConfig.mjs

@@ -14,7 +14,7 @@ const CLI_GLOBAL_OPTIONS_CONFIG = {
     mainOption: "--cwd",
     shortOption: "-d",
     description: "Working directory",
-    defaultValue: ".",
+    defaultValue: "",
     values: null,
     param: "path",
   },
@@ -26,6 +26,15 @@ const CLI_GLOBAL_OPTIONS_CONFIG = {
     values: null,
     param: "",
   },
+  workspaceRoot: {
+    mainOption: "--workspace-root",
+    shortOption: "-w",
+    description:
+      "Run from the project root above the current working directory",
+    defaultValue: "",
+    values: null,
+    param: "",
+  },
 };
 const getCliGlobalOptionConfig = (optionName) =>
   CLI_GLOBAL_OPTIONS_CONFIG[optionName];

package/src/internal/core/runtime/os.d.ts

@@ -1,4 +1,6 @@
 export declare const IS_WINDOWS: boolean;
 export declare const IS_MACOS: boolean;
 export declare const IS_LINUX: boolean;
-export declare const IS_UNIX: boolean;
+export declare const IS_POSIX: boolean;
+/** Expands a leading `~` or `~/` to the user's home directory */
+export declare const expandHomePath: (filePath: string) => string;

package/src/internal/core/runtime/os.mjs

@@ -1,7 +1,19 @@
+import os from "os";
+import path from "path"; // CONCATENATED MODULE: external "os"
+// CONCATENATED MODULE: external "path"
 // CONCATENATED MODULE: ./src/internal/core/runtime/os.ts
+
 const IS_WINDOWS = process.platform === "win32";
 const IS_MACOS = process.platform === "darwin";
 const IS_LINUX = process.platform === "linux";
-const IS_UNIX = IS_MACOS || IS_LINUX;
+const IS_POSIX = IS_MACOS || IS_LINUX;
+/** Expands a leading `~` or `~/` to the user's home directory */ const expandHomePath =
+  (filePath) => {
+    if (filePath === "~") return os.homedir();
+    if (filePath.startsWith("~/") || filePath.startsWith("~\\")) {
+      return path.join(os.homedir(), filePath.slice(2));
+    }
+    return filePath;
+  };
 
-export { IS_LINUX, IS_MACOS, IS_UNIX, IS_WINDOWS };
+export { IS_LINUX, IS_MACOS, IS_POSIX, IS_WINDOWS, expandHomePath };

package/src/project/implementations/fileSystemProject.mjs

@@ -4,6 +4,7 @@ import { loadRootConfig } from "../../config/index.mjs";
 import { getUserEnvVar } from "../../config/userEnvVars/index.mjs";
 import {
   DEFAULT_TEMP_DIR,
+  expandHomePath,
   isPlainObject,
   validateJSTypes,
 } from "../../internal/core/index.mjs";
@@ -76,7 +77,7 @@ class _FileSystemProject extends ProjectBase {
     }
     this.rootDirectory = path.resolve(
       process.cwd(),
-      options.rootDirectory ?? "",
+      expandHomePath(options.rootDirectory ?? ""),
     );
     const rootConfig = loadRootConfig(this.rootDirectory);
     const { workspaces, workspaceMap, rootWorkspace } = findWorkspaces({