Function runCmdInStagesAcrossWorkspaces

runCmdInStagesAcrossWorkspaces(
    options: Readonly<
        {
            cmd: string;
            concurrency?: number;
            filterWorkspacePattern?: (packageName: string) => boolean;
            rootPackageJsonDir: string;
        },
    >,
): Promise<void>
Executes a npm script command across all workspace packages in dependency order stages. Packages are grouped into stages where each stage contains packages whose dependencies have been completed in previous stages. Uses fail-fast behavior - stops execution immediately when any package fails.
Parameters
- options: Readonly<
      {
          cmd: string;
          concurrency?: number;
          filterWorkspacePattern?: (packageName: string) => boolean;
          rootPackageJsonDir: string;
      },
  >
  Configuration options for the staged execution
  - rootPackageJsonDir
    The directory containing the root package.json file
  - cmd
    The npm script command to execute in each package
  - concurrency
    Maximum number of packages to process simultaneously within each stage (default: 3)
  - filterWorkspacePattern
    Optional function to filter packages by name
Returns Promise<void>
A promise that resolves when all stages have completed execution successfully, or rejects immediately on first failure
- Defined in src/functions/workspace-utils/run-cmd-in-stages.mts:24