ts-repo-utils 6.0.3 → 6.0.5

package/dist/cmd/assert-repo-is-clean.mjs

@@ -1,32 +1,32 @@
 #!/usr/bin/env -S npx tsx
-import 'child_process';
 import * as cmd from 'cmd-ts';
-import 'micromatch';
-import 'node:child_process';
-import 'prettier';
 import 'ts-data-forge';
-import { assertRepoIsClean } from '../functions/assert-repo-is-clean.mjs';
 import '../node-global.mjs';
+import { assertRepoIsClean } from '../functions/assert-repo-is-clean.mjs';
+import 'node:child_process';
+import 'prettier';
+import 'micromatch';
+import 'child_process';
 
 const cmdDef = cmd.command({
-  name: 'assert-repo-is-clean-cli',
-  version: '6.0.3',
-  args: {
-    silent: cmd.flag({
-      long: 'silent',
-      type: cmd.optional(cmd.boolean),
-      description: 'If true, suppresses output messages (default: false)',
-    }),
-  },
-  handler: (args) => {
-    main(args).catch((error) => {
-      console.error('An error occurred:', error);
-      process.exit(1);
-    });
-  },
+    name: 'assert-repo-is-clean-cli',
+    version: '6.0.5',
+    args: {
+        silent: cmd.flag({
+            long: 'silent',
+            type: cmd.optional(cmd.boolean),
+            description: 'If true, suppresses output messages (default: false)',
+        }),
+    },
+    handler: (args) => {
+        main(args).catch((error) => {
+            console.error('An error occurred:', error);
+            process.exit(1);
+        });
+    },
 });
 const main = async (args) => {
-  await assertRepoIsClean({ silent: args.silent });
+    await assertRepoIsClean({ silent: args.silent });
 };
 await cmd.run(cmdDef, process.argv.slice(2));
 //# sourceMappingURL=assert-repo-is-clean.mjs.map

package/dist/cmd/check-should-run-type-checks.mjs

@@ -1,42 +1,40 @@
 #!/usr/bin/env -S npx tsx
-import 'child_process';
 import * as cmd from 'cmd-ts';
-import 'micromatch';
+import 'ts-data-forge';
+import '../node-global.mjs';
 import 'node:child_process';
 import 'prettier';
-import 'ts-data-forge';
+import 'micromatch';
 import { checkShouldRunTypeChecks } from '../functions/should-run.mjs';
-import '../node-global.mjs';
+import 'child_process';
 
 const cmdDef = cmd.command({
-  name: 'check-should-run-type-checks-cli',
-  version: '6.0.3',
-  args: {
-    pathsIgnore: cmd.multioption({
-      long: 'paths-ignore',
-      type: cmd.optional(cmd.array(cmd.string)),
-      description:
-        'Patterns to ignore when checking if type checks should run. Supports exact file matches, directory prefixes (ending with "/"), and file extensions (starting with "**.")',
-    }),
-    baseBranch: cmd.option({
-      long: 'base-branch',
-      type: cmd.optional(cmd.string),
-      description:
-        'Base branch to compare against for determining changed files. Defaults to "origin/main"',
-    }),
-  },
-  handler: (args) => {
-    main(args).catch((error) => {
-      console.error('An error occurred:', error);
-      process.exit(1);
-    });
-  },
+    name: 'check-should-run-type-checks-cli',
+    version: '6.0.5',
+    args: {
+        pathsIgnore: cmd.multioption({
+            long: 'paths-ignore',
+            type: cmd.optional(cmd.array(cmd.string)),
+            description: 'Patterns to ignore when checking if type checks should run. Supports exact file matches, directory prefixes (ending with "/"), and file extensions (starting with "**.")',
+        }),
+        baseBranch: cmd.option({
+            long: 'base-branch',
+            type: cmd.optional(cmd.string),
+            description: 'Base branch to compare against for determining changed files. Defaults to "origin/main"',
+        }),
+    },
+    handler: (args) => {
+        main(args).catch((error) => {
+            console.error('An error occurred:', error);
+            process.exit(1);
+        });
+    },
 });
 const main = async (args) => {
-  await checkShouldRunTypeChecks({
-    pathsIgnore: args.pathsIgnore,
-    baseBranch: args.baseBranch,
-  });
+    await checkShouldRunTypeChecks({
+        pathsIgnore: args.pathsIgnore,
+        baseBranch: args.baseBranch,
+    });
 };
 await cmd.run(cmdDef, process.argv.slice(2));
 //# sourceMappingURL=check-should-run-type-checks.mjs.map

package/dist/cmd/format-diff-from.mjs

@@ -1,45 +1,44 @@
 #!/usr/bin/env -S npx tsx
-import 'child_process';
 import * as cmd from 'cmd-ts';
-import 'micromatch';
-import 'node:child_process';
 import 'ts-data-forge';
-import { formatDiffFrom } from '../functions/format.mjs';
 import '../node-global.mjs';
+import 'node:child_process';
+import { formatDiffFrom } from '../functions/format.mjs';
+import 'micromatch';
+import 'child_process';
 
 const cmdDef = cmd.command({
-  name: 'format-diff-from-cli',
-  version: '6.0.3',
-  args: {
-    base: cmd.positional({
-      type: cmd.string,
-      displayName: 'base',
-      description: 'Base branch name or commit hash to compare against',
-    }),
-    includeUntracked: cmd.flag({
-      long: 'include-untracked',
-      type: cmd.optional(cmd.boolean),
-      description:
-        'Include untracked files in addition to diff files (default: true)',
-    }),
-    silent: cmd.flag({
-      long: 'silent',
-      type: cmd.optional(cmd.boolean),
-      description: 'If true, suppresses output messages (default: false)',
-    }),
-  },
-  handler: (args) => {
-    main(args).catch((error) => {
-      console.error('An error occurred:', error);
-      process.exit(1);
-    });
-  },
+    name: 'format-diff-from-cli',
+    version: '6.0.5',
+    args: {
+        base: cmd.positional({
+            type: cmd.string,
+            displayName: 'base',
+            description: 'Base branch name or commit hash to compare against',
+        }),
+        includeUntracked: cmd.flag({
+            long: 'include-untracked',
+            type: cmd.optional(cmd.boolean),
+            description: 'Include untracked files in addition to diff files (default: true)',
+        }),
+        silent: cmd.flag({
+            long: 'silent',
+            type: cmd.optional(cmd.boolean),
+            description: 'If true, suppresses output messages (default: false)',
+        }),
+    },
+    handler: (args) => {
+        main(args).catch((error) => {
+            console.error('An error occurred:', error);
+            process.exit(1);
+        });
+    },
 });
 const main = async (args) => {
-  const result = await formatDiffFrom(args.base, args);
-  if (result === 'err') {
-    process.exit(1);
-  }
+    const result = await formatDiffFrom(args.base, args);
+    if (result === 'err') {
+        process.exit(1);
+    }
 };
 await cmd.run(cmdDef, process.argv.slice(2));
 //# sourceMappingURL=format-diff-from.mjs.map

package/dist/cmd/format-untracked.mjs

@@ -1,34 +1,34 @@
 #!/usr/bin/env -S npx tsx
-import 'child_process';
 import * as cmd from 'cmd-ts';
-import 'micromatch';
-import 'node:child_process';
 import 'ts-data-forge';
-import { formatUntracked } from '../functions/format.mjs';
 import '../node-global.mjs';
+import 'node:child_process';
+import { formatUntracked } from '../functions/format.mjs';
+import 'micromatch';
+import 'child_process';
 
 const cmdDef = cmd.command({
-  name: 'format-untracked-cli',
-  version: '6.0.3',
-  args: {
-    silent: cmd.flag({
-      long: 'silent',
-      type: cmd.optional(cmd.boolean),
-      description: 'If true, suppresses output messages (default: false)',
-    }),
-  },
-  handler: (args) => {
-    main(args).catch((error) => {
-      console.error('An error occurred:', error);
-      process.exit(1);
-    });
-  },
+    name: 'format-untracked-cli',
+    version: '6.0.5',
+    args: {
+        silent: cmd.flag({
+            long: 'silent',
+            type: cmd.optional(cmd.boolean),
+            description: 'If true, suppresses output messages (default: false)',
+        }),
+    },
+    handler: (args) => {
+        main(args).catch((error) => {
+            console.error('An error occurred:', error);
+            process.exit(1);
+        });
+    },
 });
 const main = async (args) => {
-  const result = await formatUntracked({ silent: args.silent });
-  if (result === 'err') {
-    process.exit(1);
-  }
+    const result = await formatUntracked({ silent: args.silent });
+    if (result === 'err') {
+        process.exit(1);
+    }
 };
 await cmd.run(cmdDef, process.argv.slice(2));
 //# sourceMappingURL=format-untracked.mjs.map

package/dist/cmd/gen-index-ts.mjs

@@ -1,119 +1,103 @@
 #!/usr/bin/env -S npx tsx
-import 'child_process';
 import * as cmd from 'cmd-ts';
+import 'ts-data-forge';
+import '../node-global.mjs';
 import 'node:child_process';
 import 'prettier';
-import 'ts-data-forge';
 import { genIndex } from '../functions/gen-index.mjs';
-import '../node-global.mjs';
+import 'child_process';
 
 const extensionType = cmd.extendType(cmd.string, {
-  from: (s) => {
-    if (!s.startsWith('.')) {
-      throw new Error(`ext should start with '.'`);
-    }
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
-    return Promise.resolve(s);
-  },
+    from: (s) => {
+        if (!s.startsWith('.')) {
+            throw new Error(`ext should start with '.'`);
+        }
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+        return Promise.resolve(s);
+    },
 });
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
-const nonEmptyArray = (t, commandName) =>
-  cmd.extendType(cmd.array(t), {
+const nonEmptyArray = (t, commandName) => cmd.extendType(cmd.array(t), {
     from: (arr) => {
-      if (arr.length === 0) {
-        throw new Error(
-          `No value provided for --${commandName}. At least one value is required.`,
-        );
-      }
-      // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
-      return Promise.resolve(arr);
+        if (arr.length === 0) {
+            throw new Error(`No value provided for --${commandName}. At least one value is required.`);
+        }
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+        return Promise.resolve(arr);
     },
-  });
+});
 const cmdDef = cmd.command({
-  name: 'gen-index-ts-cli',
-  version: '6.0.3',
-  args: {
-    // required args
-    targetDirectory: cmd.positional({
-      type: cmd.string,
-      displayName: 'target-directory',
-      description:
-        'Directory where the index file will be generated  (Comma-separated list can be used)',
-    }),
-    targetExtensions: cmd.multioption({
-      long: 'target-ext',
-      type: nonEmptyArray(extensionType, 'target-ext'),
-      description: 'File extensions to include in the index file',
-    }),
-    indexFileExtension: cmd.option({
-      long: 'index-ext',
-      type: extensionType,
-      description: 'Extension of the index file to be generated',
-    }),
-    exportStatementExtension: cmd.option({
-      long: 'export-ext',
-      type: cmd.union([
-        extensionType,
-        cmd.extendType(cmd.string, {
-          from: (s) => {
-            if (s !== 'none') {
-              throw new Error(
-                `export-ext should be 'none' or a valid extension`,
-              );
-            }
-            return Promise.resolve('none');
-          },
+    name: 'gen-index-ts-cli',
+    version: '6.0.5',
+    args: {
+        // required args
+        targetDirectory: cmd.positional({
+            type: cmd.string,
+            displayName: 'target-directory',
+            description: 'Directory where the index file will be generated  (Comma-separated list can be used)',
         }),
-      ]),
-      description: 'Extension of the export statements in the index file',
-    }),
-    // optional args
-    exclude: cmd.multioption({
-      long: 'exclude',
-      type: cmd.optional(cmd.array(cmd.string)),
-      description:
-        'Glob patterns of files to exclude from the index file (e.g., "*.d.mts", "*.test.mts")',
-    }),
-    formatCommand: cmd.option({
-      long: 'fmt',
-      type: cmd.optional(cmd.string),
-      description:
-        'Command to format after generating the index file (e.g., "npm run fmt")',
-    }),
-    silent: cmd.flag({
-      long: 'silent',
-      type: cmd.optional(cmd.boolean),
-      description: 'If true, suppresses output messages (default: false)',
-    }),
-  },
-  handler: (args) => {
-    console.log(args);
-    main(args).catch((error) => {
-      console.error('An error occurred:', error);
-      process.exit(1);
-    });
-  },
+        targetExtensions: cmd.multioption({
+            long: 'target-ext',
+            type: nonEmptyArray(extensionType, 'target-ext'),
+            description: 'File extensions to include in the index file',
+        }),
+        indexFileExtension: cmd.option({
+            long: 'index-ext',
+            type: extensionType,
+            description: 'Extension of the index file to be generated',
+        }),
+        exportStatementExtension: cmd.option({
+            long: 'export-ext',
+            type: cmd.union([
+                extensionType,
+                cmd.extendType(cmd.string, {
+                    from: (s) => {
+                        if (s !== 'none') {
+                            throw new Error(`export-ext should be 'none' or a valid extension`);
+                        }
+                        return Promise.resolve('none');
+                    },
+                }),
+            ]),
+            description: 'Extension of the export statements in the index file',
+        }),
+        // optional args
+        exclude: cmd.multioption({
+            long: 'exclude',
+            type: cmd.optional(cmd.array(cmd.string)),
+            description: 'Glob patterns of files to exclude from the index file (e.g., "*.d.mts", "*.test.mts")',
+        }),
+        formatCommand: cmd.option({
+            long: 'fmt',
+            type: cmd.optional(cmd.string),
+            description: 'Command to format after generating the index file (e.g., "npm run fmt")',
+        }),
+        silent: cmd.flag({
+            long: 'silent',
+            type: cmd.optional(cmd.boolean),
+            description: 'If true, suppresses output messages (default: false)',
+        }),
+    },
+    handler: (args) => {
+        console.log(args);
+        main(args).catch((error) => {
+            console.error('An error occurred:', error);
+            process.exit(1);
+        });
+    },
 });
-const main = async ({
-  targetDirectory,
-  targetExtensions,
-  exportStatementExtension,
-  indexFileExtension,
-  exclude,
-  formatCommand,
-  silent,
-}) => {
-  await genIndex({
-    targetDirectory: targetDirectory.includes(',')
-      ? targetDirectory.split(',').map((dir) => dir.trim())
-      : targetDirectory,
-    exportStatementExtension,
-    targetExtensions,
-    exclude,
-    indexFileExtension,
-    formatCommand,
-    silent,
-  });
+const main = async ({ targetDirectory, targetExtensions, exportStatementExtension, indexFileExtension, exclude, formatCommand, silent, }) => {
+    await genIndex({
+        targetDirectory: targetDirectory.includes(',')
+            ? targetDirectory.split(',').map((dir) => dir.trim())
+            : targetDirectory,
+        exportStatementExtension,
+        targetExtensions,
+        exclude,
+        indexFileExtension,
+        formatCommand,
+        silent,
+    });
 };
 await cmd.run(cmdDef, process.argv.slice(2));
 //# sourceMappingURL=gen-index-ts.mjs.map

package/dist/functions/workspace-utils/execute-parallel.d.mts

@@ -1,30 +1,33 @@
-import { Result } from 'ts-data-forge';
 import '../../node-global.mjs';
 import { type Package } from './types.mjs';
 /**
  * Executes a npm script across multiple packages in parallel with a concurrency
- * limit.
+ * limit. Uses fail-fast behavior - stops execution immediately when any package
+ * fails.
  *
  * @param packages - Array of Package objects to execute the script in
  * @param scriptName - The name of the npm script to execute
  * @param concurrency - Maximum number of packages to process simultaneously
  *   (default: 3)
- * @returns A promise that resolves to an array of execution results
+ * @returns A promise that resolves to an array of execution results, or rejects
+ *   immediately on first failure
  */
-export declare const executeParallel: (packages: readonly Package[], scriptName: string, concurrency?: number) => Promise<readonly Result<Readonly<{
+export declare const executeParallel: (packages: readonly Package[], scriptName: string, concurrency?: number) => Promise<readonly Readonly<{
     code?: number;
     skipped?: boolean;
-}>, Error>[]>;
+}>[]>;
 /**
  * Executes a npm script across packages in dependency order stages. Packages
  * are grouped into stages where each stage contains packages whose dependencies
- * have been completed in previous stages.
+ * have been completed in previous stages. Uses fail-fast behavior - stops
+ * execution immediately when any package fails.
  *
  * @param packages - Array of Package objects to execute the script in
  * @param scriptName - The name of the npm script to execute
  * @param concurrency - Maximum number of packages to process simultaneously
  *   within each stage (default: 3)
- * @returns A promise that resolves when all stages are complete
+ * @returns A promise that resolves when all stages are complete, or rejects
+ *   immediately on first failure
  */
 export declare const executeStages: (packages: readonly Package[], scriptName: string, concurrency?: number) => Promise<void>;
 //# sourceMappingURL=execute-parallel.d.mts.map

package/dist/functions/workspace-utils/execute-parallel.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"execute-parallel.d.mts","sourceRoot":"","sources":["../../../src/functions/workspace-utils/execute-parallel.mts"],"names":[],"mappings":"AACA,OAAO,EAML,MAAM,EACP,MAAM,eAAe,CAAC;AACvB,OAAO,uBAAuB,CAAC;AAC/B,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAI3C;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,GAC1B,UAAU,SAAS,OAAO,EAAE,EAC5B,YAAY,MAAM,EAClB,cAAa,MAAU,KACtB,OAAO,CACR,SAAS,MAAM,CAAC,QAAQ,CAAC;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,EAAE,KAAK,CAAC,EAAE,CAkCzE,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa,GACxB,UAAU,SAAS,OAAO,EAAE,EAC5B,YAAY,MAAM,EAClB,cAAa,MAAU,KACtB,OAAO,CAAC,IAAI,CAyCd,CAAC"}
+{"version":3,"file":"execute-parallel.d.mts","sourceRoot":"","sources":["../../../src/functions/workspace-utils/execute-parallel.mts"],"names":[],"mappings":"AAUA,OAAO,uBAAuB,CAAC;AAC/B,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAI3C;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,GAC1B,UAAU,SAAS,OAAO,EAAE,EAC5B,YAAY,MAAM,EAClB,cAAa,MAAU,KACtB,OAAO,CAAC,SAAS,QAAQ,CAAC;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,EAAE,CA8DnE,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,aAAa,GACxB,UAAU,SAAS,OAAO,EAAE,EAC5B,YAAY,MAAM,EAClB,cAAa,MAAU,KACtB,OAAO,CAAC,IAAI,CA0Dd,CAAC"}

package/dist/functions/workspace-utils/execute-parallel.mjs

@@ -1,45 +1,79 @@
 import { spawn } from 'child_process';
-import { pipe, createPromise, isRecord, hasKey, Result, isNotUndefined } from 'ts-data-forge';
+import { pipe, Result, createPromise, isRecord, hasKey, isNotUndefined } from 'ts-data-forge';
 import '../../node-global.mjs';
 
+/* eslint-disable require-atomic-updates */
 /**
  * Executes a npm script across multiple packages in parallel with a concurrency
- * limit.
+ * limit. Uses fail-fast behavior - stops execution immediately when any package
+ * fails.
  *
  * @param packages - Array of Package objects to execute the script in
  * @param scriptName - The name of the npm script to execute
  * @param concurrency - Maximum number of packages to process simultaneously
  *   (default: 3)
- * @returns A promise that resolves to an array of execution results
+ * @returns A promise that resolves to an array of execution results, or rejects
+ *   immediately on first failure
  */
 const executeParallel = async (packages, scriptName, concurrency = 3) => {
     const mut_resultPromises = [];
     const mut_executing = new Set();
+    let mut_failed = false;
     for (const pkg of packages) {
-        const promise = executeScript(pkg, scriptName);
+        // Stop starting new processes if any has failed
+        if (mut_failed) {
+            break;
+        }
+        // eslint-disable-next-line @typescript-eslint/no-loop-func
+        const promise = executeScript(pkg, scriptName).then((result) => {
+            // Check for failure immediately
+            if (Result.isErr(result)) {
+                mut_failed = true;
+                throw result.value; // Throw the error to trigger fail-fast
+            }
+            return result.value; // Return the unwrapped value for success
+        });
         mut_resultPromises.push(promise);
-        const wrappedPromise = promise.finally(() => {
+        const wrappedPromise = promise
+            // eslint-disable-next-line @typescript-eslint/no-loop-func
+            .catch((error) => {
+            mut_failed = true;
+            throw error; // Re-throw to ensure fail-fast propagation
+        })
+            .finally(() => {
             mut_executing.delete(wrappedPromise);
         });
         mut_executing.add(wrappedPromise);
         // If we reach concurrency limit, wait for one to finish
         if (mut_executing.size >= concurrency) {
-            // eslint-disable-next-line no-await-in-loop
-            await Promise.race(mut_executing);
+            try {
+                // eslint-disable-next-line no-await-in-loop
+                await Promise.race(mut_executing);
+            }
+            catch (error) {
+                // If any process fails, cancel remaining processes and throw immediately
+                // eslint-disable-next-line no-useless-assignment
+                mut_failed = true;
+                throw error;
+            }
         }
     }
+    // Wait for all started processes to complete
+    // This will throw immediately if any process fails (fail-fast)
     return Promise.all(mut_resultPromises);
 };
 /**
  * Executes a npm script across packages in dependency order stages. Packages
  * are grouped into stages where each stage contains packages whose dependencies
- * have been completed in previous stages.
+ * have been completed in previous stages. Uses fail-fast behavior - stops
+ * execution immediately when any package fails.
  *
  * @param packages - Array of Package objects to execute the script in
  * @param scriptName - The name of the npm script to execute
  * @param concurrency - Maximum number of packages to process simultaneously
  *   within each stage (default: 3)
- * @returns A promise that resolves when all stages are complete
+ * @returns A promise that resolves when all stages are complete, or rejects
+ *   immediately on first failure
  */
 const executeStages = async (packages, scriptName, concurrency = 3) => {
     const dependencyGraph = buildDependencyGraph(packages);
@@ -65,12 +99,24 @@ const executeStages = async (packages, scriptName, concurrency = 3) => {
             mut_completed.add(pkg.name);
         }
     }
-    console.log(`\nExecuting ${scriptName} in ${mut_stages.length} stages...\n`);
+    console.log(`\nExecuting ${scriptName} in ${mut_stages.length} stages (fail-fast mode)...\n`);
     for (const [i, stage] of mut_stages.entries()) {
         if (stage.length > 0) {
             console.log(`Stage ${i + 1}: ${stage.map((p) => p.name).join(', ')}`);
-            // eslint-disable-next-line no-await-in-loop
-            await executeParallel(stage, scriptName, concurrency);
+            try {
+                // eslint-disable-next-line no-await-in-loop
+                const results = await executeParallel(stage, scriptName, concurrency);
+                // Log successful completion of the stage
+                // All results are successful because executeParallel throws on any failure
+                console.log(`✅ Stage ${i + 1} completed successfully (${results.length}/${stage.length} packages)`);
+            }
+            catch (error) {
+                // executeParallel will throw immediately on any failure (fail-fast)
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                console.error(`\n❌ Stage ${i + 1} failed (fail-fast):`);
+                console.error(errorMessage);
+                throw new Error(`Stage ${i + 1} failed: ${errorMessage}`);
+            }
         }
     }
 };
@@ -107,8 +153,8 @@ const executeScript = (pkg, scriptName, { prefix = true } = {}) => pipe(createPr
         process.stderr.write(prefixStr + data.toString());
     });
     proc.on('close', (code) => {
-        if (code === 0) {
-            resolve({ code });
+        if (code === 0 || code === null) {
+            resolve({ code: code ?? 0 });
         }
         else {
             reject(new Error(`${pkg.name} exited with code ${code}`));

package/dist/functions/workspace-utils/execute-parallel.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"execute-parallel.mjs","sources":["../../../src/functions/workspace-utils/execute-parallel.mts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"execute-parallel.mjs","sources":["../../../src/functions/workspace-utils/execute-parallel.mts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/functions/workspace-utils/run-cmd-in-parallel.d.mts

@@ -1,6 +1,7 @@
 #!/usr/bin/env tsx
 /**
- * Executes a npm script command across all workspace packages in parallel.
+ * Executes a npm script command across all workspace packages in parallel. Uses
+ * fail-fast behavior - stops execution immediately when any package fails.
  *
  * @param options - Configuration options for the parallel execution
  * @param options.rootPackageJsonDir - The directory containing the root
@@ -11,6 +12,7 @@
  * @param options.filterWorkspacePattern - Optional function to filter packages
  *   by name
  * @returns A promise that resolves when all packages have completed execution
+ *   successfully, or rejects immediately on first failure
  */
 export declare const runCmdInParallelAcrossWorkspaces: ({ rootPackageJsonDir, cmd, concurrency, filterWorkspacePattern, }: Readonly<{
     rootPackageJsonDir: string;

package/dist/functions/workspace-utils/run-cmd-in-parallel.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"run-cmd-in-parallel.d.mts","sourceRoot":"","sources":["../../../src/functions/workspace-utils/run-cmd-in-parallel.mts"],"names":[],"mappings":";AAKA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gCAAgC,GAAU,mEAKpD,QAAQ,CAAC;IACV,kBAAkB,EAAE,MAAM,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sBAAsB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC;CAC3D,CAAC,KAAG,OAAO,CAAC,IAAI,CAkBhB,CAAC"}
+{"version":3,"file":"run-cmd-in-parallel.d.mts","sourceRoot":"","sources":["../../../src/functions/workspace-utils/run-cmd-in-parallel.mts"],"names":[],"mappings":";AAKA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,gCAAgC,GAAU,mEAKpD,QAAQ,CAAC;IACV,kBAAkB,EAAE,MAAM,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sBAAsB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC;CAC3D,CAAC,KAAG,OAAO,CAAC,IAAI,CAqBhB,CAAC"}

package/dist/functions/workspace-utils/run-cmd-in-parallel.mjs

@@ -3,7 +3,8 @@ import { executeParallel } from './execute-parallel.mjs';
 import { getWorkspacePackages } from './get-workspace-packages.mjs';
 
 /**
- * Executes a npm script command across all workspace packages in parallel.
+ * Executes a npm script command across all workspace packages in parallel. Uses
+ * fail-fast behavior - stops execution immediately when any package fails.
  *
  * @param options - Configuration options for the parallel execution
  * @param options.rootPackageJsonDir - The directory containing the root
@@ -14,6 +15,7 @@ import { getWorkspacePackages } from './get-workspace-packages.mjs';
  * @param options.filterWorkspacePattern - Optional function to filter packages
  *   by name
  * @returns A promise that resolves when all packages have completed execution
+ *   successfully, or rejects immediately on first failure
  */
 const runCmdInParallelAcrossWorkspaces = async ({ rootPackageJsonDir, cmd, concurrency = 3, filterWorkspacePattern, }) => {
     try {
@@ -21,11 +23,14 @@ const runCmdInParallelAcrossWorkspaces = async ({ rootPackageJsonDir, cmd, concu
         const filteredPackages = filterWorkspacePattern === undefined
             ? packages
             : packages.filter((pkg) => filterWorkspacePattern(pkg.name));
+        console.log(`\nStarting ${cmd} across ${filteredPackages.length} packages (fail-fast parallel mode)...`);
         await executeParallel(filteredPackages, cmd, concurrency);
-        console.log(`\n✅ ${cmd} completed successfully`);
+        console.log(`\n✅ ${cmd} completed successfully (all packages)`);
     }
     catch (error) {
-        console.error(`\n❌ ${cmd} failed:`, error instanceof Error ? error.message : (error?.toString() ?? ''));
+        const errorMessage = error instanceof Error ? error.message : (error?.toString() ?? '');
+        console.error(`\n❌ ${cmd} failed (fail-fast mode stopped execution):`);
+        console.error(errorMessage);
         process.exit(1);
     }
 };

package/dist/functions/workspace-utils/run-cmd-in-parallel.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"run-cmd-in-parallel.mjs","sources":["../../../src/functions/workspace-utils/run-cmd-in-parallel.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAKA;;;;;;;;;;;;AAYG;AACI,MAAM,gCAAgC,GAAG,OAAO,EACrD,kBAAkB,EAClB,GAAG,EACH,WAAW,GAAG,CAAC,EACf,sBAAsB,GAMtB,KAAmB;AACnB,IAAA,IAAI;AACF,QAAA,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,kBAAkB,CAAC;AAE/D,QAAA,MAAM,gBAAgB,GACpB,sBAAsB,KAAK;AACzB,cAAE;AACF,cAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEhE,MAAM,eAAe,CAAC,gBAAgB,EAAE,GAAG,EAAE,WAAW,CAAC;AACzD,QAAA,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,CAAA,uBAAA,CAAyB,CAAC;IAClD;IAAE,OAAO,KAAK,EAAE;AACd,QAAA,OAAO,CAAC,KAAK,CACX,CAAA,IAAA,EAAO,GAAG,CAAA,QAAA,CAAU,EACpB,KAAK,YAAY,KAAK,GAAG,KAAK,CAAC,OAAO,IAAI,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CACnE;AACD,QAAA,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACjB;AACF;;;;"}
+{"version":3,"file":"run-cmd-in-parallel.mjs","sources":["../../../src/functions/workspace-utils/run-cmd-in-parallel.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAKA;;;;;;;;;;;;;;AAcG;AACI,MAAM,gCAAgC,GAAG,OAAO,EACrD,kBAAkB,EAClB,GAAG,EACH,WAAW,GAAG,CAAC,EACf,sBAAsB,GAMtB,KAAmB;AACnB,IAAA,IAAI;AACF,QAAA,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,kBAAkB,CAAC;AAE/D,QAAA,MAAM,gBAAgB,GACpB,sBAAsB,KAAK;AACzB,cAAE;AACF,cAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEhE,OAAO,CAAC,GAAG,CACT,CAAA,WAAA,EAAc,GAAG,CAAA,QAAA,EAAW,gBAAgB,CAAC,MAAM,CAAA,sCAAA,CAAwC,CAC5F;QACD,MAAM,eAAe,CAAC,gBAAgB,EAAE,GAAG,EAAE,WAAW,CAAC;AACzD,QAAA,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,CAAA,sCAAA,CAAwC,CAAC;IACjE;IAAE,OAAO,KAAK,EAAE;QACd,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,GAAG,KAAK,CAAC,OAAO,IAAI,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AACpE,QAAA,OAAO,CAAC,KAAK,CAAC,OAAO,GAAG,CAAA,2CAAA,CAA6C,CAAC;AACtE,QAAA,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC;AAC3B,QAAA,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACjB;AACF;;;;"}

package/dist/functions/workspace-utils/run-cmd-in-stages.d.mts

@@ -2,7 +2,8 @@
 /**
  * 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.
+ * packages whose dependencies have been completed in previous stages. Uses
+ * fail-fast behavior - stops execution immediately when any package fails.
  *
  * @param options - Configuration options for the staged execution
  * @param options.rootPackageJsonDir - The directory containing the root
@@ -13,6 +14,7 @@
  * @param options.filterWorkspacePattern - Optional function to filter packages
  *   by name
  * @returns A promise that resolves when all stages have completed execution
+ *   successfully, or rejects immediately on first failure
  */
 export declare const runCmdInStagesAcrossWorkspaces: ({ rootPackageJsonDir, cmd, concurrency, filterWorkspacePattern, }: Readonly<{
     rootPackageJsonDir: string;

package/dist/functions/workspace-utils/run-cmd-in-stages.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"run-cmd-in-stages.d.mts","sourceRoot":"","sources":["../../../src/functions/workspace-utils/run-cmd-in-stages.mts"],"names":[],"mappings":";AAKA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,8BAA8B,GAAU,mEAKlD,QAAQ,CAAC;IACV,kBAAkB,EAAE,MAAM,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sBAAsB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC;CAC3D,CAAC,KAAG,OAAO,CAAC,IAAI,CAkBhB,CAAC"}
+{"version":3,"file":"run-cmd-in-stages.d.mts","sourceRoot":"","sources":["../../../src/functions/workspace-utils/run-cmd-in-stages.mts"],"names":[],"mappings":";AAKA;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,8BAA8B,GAAU,mEAKlD,QAAQ,CAAC;IACV,kBAAkB,EAAE,MAAM,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sBAAsB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC;CAC3D,CAAC,KAAG,OAAO,CAAC,IAAI,CAqBhB,CAAC"}

package/dist/functions/workspace-utils/run-cmd-in-stages.mjs

@@ -5,7 +5,8 @@ import { getWorkspacePackages } from './get-workspace-packages.mjs';
 /**
  * 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.
+ * packages whose dependencies have been completed in previous stages. Uses
+ * fail-fast behavior - stops execution immediately when any package fails.
  *
  * @param options - Configuration options for the staged execution
  * @param options.rootPackageJsonDir - The directory containing the root
@@ -16,6 +17,7 @@ import { getWorkspacePackages } from './get-workspace-packages.mjs';
  * @param options.filterWorkspacePattern - Optional function to filter packages
  *   by name
  * @returns A promise that resolves when all stages have completed execution
+ *   successfully, or rejects immediately on first failure
  */
 const runCmdInStagesAcrossWorkspaces = async ({ rootPackageJsonDir, cmd, concurrency = 3, filterWorkspacePattern, }) => {
     try {
@@ -23,11 +25,14 @@ const runCmdInStagesAcrossWorkspaces = async ({ rootPackageJsonDir, cmd, concurr
         const filteredPackages = filterWorkspacePattern === undefined
             ? packages
             : packages.filter((pkg) => filterWorkspacePattern(pkg.name));
+        console.log(`\nStarting ${cmd} across ${filteredPackages.length} packages (fail-fast mode)...`);
         await executeStages(filteredPackages, cmd, concurrency);
-        console.log(`\n✅ ${cmd} completed successfully`);
+        console.log(`\n✅ ${cmd} completed successfully (all stages)`);
     }
     catch (error) {
-        console.error(`\n❌ ${cmd} failed:`, error instanceof Error ? error.message : (error?.toString() ?? ''));
+        const errorMessage = error instanceof Error ? error.message : (error?.toString() ?? '');
+        console.error(`\n❌ ${cmd} failed (fail-fast mode stopped execution):`);
+        console.error(errorMessage);
         process.exit(1);
     }
 };

package/dist/functions/workspace-utils/run-cmd-in-stages.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"run-cmd-in-stages.mjs","sources":["../../../src/functions/workspace-utils/run-cmd-in-stages.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAKA;;;;;;;;;;;;;;AAcG;AACI,MAAM,8BAA8B,GAAG,OAAO,EACnD,kBAAkB,EAClB,GAAG,EACH,WAAW,GAAG,CAAC,EACf,sBAAsB,GAMtB,KAAmB;AACnB,IAAA,IAAI;AACF,QAAA,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,kBAAkB,CAAC;AAE/D,QAAA,MAAM,gBAAgB,GACpB,sBAAsB,KAAK;AACzB,cAAE;AACF,cAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEhE,MAAM,aAAa,CAAC,gBAAgB,EAAE,GAAG,EAAE,WAAW,CAAC;AACvD,QAAA,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,CAAA,uBAAA,CAAyB,CAAC;IAClD;IAAE,OAAO,KAAK,EAAE;AACd,QAAA,OAAO,CAAC,KAAK,CACX,CAAA,IAAA,EAAO,GAAG,CAAA,QAAA,CAAU,EACpB,KAAK,YAAY,KAAK,GAAG,KAAK,CAAC,OAAO,IAAI,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CACnE;AACD,QAAA,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACjB;AACF;;;;"}
+{"version":3,"file":"run-cmd-in-stages.mjs","sources":["../../../src/functions/workspace-utils/run-cmd-in-stages.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAKA;;;;;;;;;;;;;;;;AAgBG;AACI,MAAM,8BAA8B,GAAG,OAAO,EACnD,kBAAkB,EAClB,GAAG,EACH,WAAW,GAAG,CAAC,EACf,sBAAsB,GAMtB,KAAmB;AACnB,IAAA,IAAI;AACF,QAAA,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,kBAAkB,CAAC;AAE/D,QAAA,MAAM,gBAAgB,GACpB,sBAAsB,KAAK;AACzB,cAAE;AACF,cAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEhE,OAAO,CAAC,GAAG,CACT,CAAA,WAAA,EAAc,GAAG,CAAA,QAAA,EAAW,gBAAgB,CAAC,MAAM,CAAA,6BAAA,CAA+B,CACnF;QACD,MAAM,aAAa,CAAC,gBAAgB,EAAE,GAAG,EAAE,WAAW,CAAC;AACvD,QAAA,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,CAAA,oCAAA,CAAsC,CAAC;IAC/D;IAAE,OAAO,KAAK,EAAE;QACd,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,GAAG,KAAK,CAAC,OAAO,IAAI,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AACpE,QAAA,OAAO,CAAC,KAAK,CAAC,OAAO,GAAG,CAAA,2CAAA,CAA6C,CAAC;AACtE,QAAA,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC;AAC3B,QAAA,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACjB;AACF;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ts-repo-utils",
-  "version": "6.0.3",
+  "version": "6.0.5",
   "private": false,
   "keywords": [
     "typescript"
@@ -71,7 +71,7 @@
     "tsx": "^4.20.4"
   },
   "devDependencies": {
-    "@eslint/js": "^9.31.0",
+    "@eslint/js": "^9.34.0",
     "@rollup/plugin-replace": "^6.0.2",
     "@rollup/plugin-strip": "^3.0.4",
     "@rollup/plugin-typescript": "^12.1.4",
@@ -88,7 +88,7 @@
     "conventional-changelog-conventionalcommits": "^9.1.0",
     "cspell": "^9.2.0",
     "dedent": "^1.6.0",
-    "eslint": "^9.33.0",
+    "eslint": "^9.34.0",
     "eslint-import-resolver-typescript": "4.4.4",
     "eslint-plugin-array-func": "5.0.2",
     "eslint-plugin-functional": "9.0.2",
@@ -100,19 +100,23 @@
     "eslint-plugin-vitest": "0.5.4",
     "markdownlint-cli2": "^0.18.1",
     "npm-run-all2": "^8.0.4",
+    "prettier": "^3.6.2",
     "prettier-plugin-jsdoc": "^1.3.3",
     "prettier-plugin-organize-imports": "^4.2.0",
     "prettier-plugin-packagejson": "^2.5.19",
-    "rollup": "^4.46.2",
+    "rollup": "^4.48.0",
     "semantic-release": "^24.2.7",
     "ts-type-forge": "^2.1.1",
     "tslib": "^2.8.1",
     "typedoc": "^0.28.10",
-    "typedoc-plugin-markdown": "^4.8.0",
+    "typedoc-plugin-markdown": "^4.8.1",
     "typescript": "^5.9.2",
-    "typescript-eslint": "^8.39.1",
+    "typescript-eslint": "^8.40.0",
     "vitest": "^3.2.4"
   },
+  "peerDependencies": {
+    "prettier": "^3.6.2"
+  },
   "engines": {
     "node": ">=20.11.0"
   }

package/src/cmd/assert-repo-is-clean.mts

@@ -5,7 +5,7 @@ import { assertRepoIsClean } from '../functions/index.mjs';
 
 const cmdDef = cmd.command({
   name: 'assert-repo-is-clean-cli',
-  version: '6.0.3',
+  version: '6.0.5',
   args: {
     silent: cmd.flag({
       long: 'silent',

package/src/cmd/check-should-run-type-checks.mts

@@ -5,7 +5,7 @@ import { checkShouldRunTypeChecks } from '../functions/index.mjs';
 
 const cmdDef = cmd.command({
   name: 'check-should-run-type-checks-cli',
-  version: '6.0.3',
+  version: '6.0.5',
   args: {
     pathsIgnore: cmd.multioption({
       long: 'paths-ignore',

package/src/cmd/format-diff-from.mts

@@ -5,7 +5,7 @@ import { formatDiffFrom } from '../functions/index.mjs';
 
 const cmdDef = cmd.command({
   name: 'format-diff-from-cli',
-  version: '6.0.3',
+  version: '6.0.5',
   args: {
     base: cmd.positional({
       type: cmd.string,

package/src/cmd/format-untracked.mts

@@ -5,7 +5,7 @@ import { formatUntracked } from '../functions/index.mjs';
 
 const cmdDef = cmd.command({
   name: 'format-untracked-cli',
-  version: '6.0.3',
+  version: '6.0.5',
   args: {
     silent: cmd.flag({
       long: 'silent',

package/src/cmd/gen-index-ts.mts

@@ -38,7 +38,7 @@ const nonEmptyArray = <T extends cmd.Type<any, any>>(
 
 const cmdDef = cmd.command({
   name: 'gen-index-ts-cli',
-  version: '6.0.3',
+  version: '6.0.5',
   args: {
     // required args
     targetDirectory: cmd.positional({

package/src/functions/diff.test.mts

@@ -2,7 +2,11 @@ import { Result } from 'ts-data-forge';
 import '../node-global.mjs';
 import { getDiffFrom, getUntrackedFiles } from './diff.mjs';
 
-describe('diff', () => {
+// Check if running in CI environment (GitHub Actions or other CI)
+const isCI =
+  process.env['CI'] === 'true' || process.env['GITHUB_ACTIONS'] === 'true';
+
+describe.skipIf(!isCI)('diff', () => {
   // Helper function to clean up test files
   const cleanupTestFiles = async (files: Set<string>): Promise<void> => {
     for (const file of files) {

package/src/functions/workspace-utils/execute-parallel.mts

@@ -1,3 +1,4 @@
+/* eslint-disable require-atomic-updates */
 import { spawn } from 'child_process';
 import {
   createPromise,
@@ -14,39 +15,59 @@ const DEBUG = false as boolean;
 
 /**
  * Executes a npm script across multiple packages in parallel with a concurrency
- * limit.
+ * limit. Uses fail-fast behavior - stops execution immediately when any package
+ * fails.
  *
  * @param packages - Array of Package objects to execute the script in
  * @param scriptName - The name of the npm script to execute
  * @param concurrency - Maximum number of packages to process simultaneously
  *   (default: 3)
- * @returns A promise that resolves to an array of execution results
+ * @returns A promise that resolves to an array of execution results, or rejects
+ *   immediately on first failure
  */
 export const executeParallel = async (
   packages: readonly Package[],
   scriptName: string,
   concurrency: number = 3,
-): Promise<
-  readonly Result<Readonly<{ code?: number; skipped?: boolean }>, Error>[]
-> => {
+): Promise<readonly Readonly<{ code?: number; skipped?: boolean }>[]> => {
   const mut_resultPromises: Promise<
-    Result<Readonly<{ code?: number; skipped?: boolean }>, Error>
+    Readonly<{ code?: number; skipped?: boolean }>
   >[] = [];
 
   const mut_executing = new Set<Promise<unknown>>();
+  let mut_failed = false as boolean;
 
   for (const pkg of packages) {
-    const promise = executeScript(pkg, scriptName);
-
-    mut_resultPromises.push(promise);
+    // Stop starting new processes if any has failed
+    if (mut_failed) {
+      break;
+    }
 
-    const wrappedPromise = promise.finally(() => {
-      mut_executing.delete(wrappedPromise);
-      if (DEBUG) {
-        console.debug('executing size', mut_executing.size);
+    // eslint-disable-next-line @typescript-eslint/no-loop-func
+    const promise = executeScript(pkg, scriptName).then((result) => {
+      // Check for failure immediately
+      if (Result.isErr(result)) {
+        mut_failed = true;
+        throw result.value; // Throw the error to trigger fail-fast
       }
+      return result.value; // Return the unwrapped value for success
     });
 
+    mut_resultPromises.push(promise);
+
+    const wrappedPromise = promise
+      // eslint-disable-next-line @typescript-eslint/no-loop-func
+      .catch((error) => {
+        mut_failed = true;
+        throw error; // Re-throw to ensure fail-fast propagation
+      })
+      .finally(() => {
+        mut_executing.delete(wrappedPromise);
+        if (DEBUG) {
+          console.debug('executing size', mut_executing.size);
+        }
+      });
+
     mut_executing.add(wrappedPromise);
 
     if (DEBUG) {
@@ -55,24 +76,35 @@ export const executeParallel = async (
 
     // If we reach concurrency limit, wait for one to finish
     if (mut_executing.size >= concurrency) {
-      // eslint-disable-next-line no-await-in-loop
-      await Promise.race(mut_executing);
+      try {
+        // eslint-disable-next-line no-await-in-loop
+        await Promise.race(mut_executing);
+      } catch (error) {
+        // If any process fails, cancel remaining processes and throw immediately
+        // eslint-disable-next-line no-useless-assignment
+        mut_failed = true;
+        throw error;
+      }
     }
   }
 
+  // Wait for all started processes to complete
+  // This will throw immediately if any process fails (fail-fast)
   return Promise.all(mut_resultPromises);
 };
 
 /**
  * Executes a npm script across packages in dependency order stages. Packages
  * are grouped into stages where each stage contains packages whose dependencies
- * have been completed in previous stages.
+ * have been completed in previous stages. Uses fail-fast behavior - stops
+ * execution immediately when any package fails.
  *
  * @param packages - Array of Package objects to execute the script in
  * @param scriptName - The name of the npm script to execute
  * @param concurrency - Maximum number of packages to process simultaneously
  *   within each stage (default: 3)
- * @returns A promise that resolves when all stages are complete
+ * @returns A promise that resolves when all stages are complete, or rejects
+ *   immediately on first failure
  */
 export const executeStages = async (
   packages: readonly Package[],
@@ -110,13 +142,30 @@ export const executeStages = async (
     }
   }
 
-  console.log(`\nExecuting ${scriptName} in ${mut_stages.length} stages...\n`);
+  console.log(
+    `\nExecuting ${scriptName} in ${mut_stages.length} stages (fail-fast mode)...\n`,
+  );
 
   for (const [i, stage] of mut_stages.entries()) {
     if (stage.length > 0) {
       console.log(`Stage ${i + 1}: ${stage.map((p) => p.name).join(', ')}`);
-      // eslint-disable-next-line no-await-in-loop
-      await executeParallel(stage, scriptName, concurrency);
+      try {
+        // eslint-disable-next-line no-await-in-loop
+        const results = await executeParallel(stage, scriptName, concurrency);
+
+        // Log successful completion of the stage
+        // All results are successful because executeParallel throws on any failure
+        console.log(
+          `✅ Stage ${i + 1} completed successfully (${results.length}/${stage.length} packages)`,
+        );
+      } catch (error) {
+        // executeParallel will throw immediately on any failure (fail-fast)
+        const errorMessage =
+          error instanceof Error ? error.message : String(error);
+        console.error(`\n❌ Stage ${i + 1} failed (fail-fast):`);
+        console.error(errorMessage);
+        throw new Error(`Stage ${i + 1} failed: ${errorMessage}`);
+      }
     }
   }
 };
@@ -172,8 +221,11 @@ const executeScript = (
         });
 
         proc.on('close', (code: number | null) => {
-          if (code === 0) {
-            resolve({ code });
+          if (DEBUG) {
+            console.debug(`${pkg.name} process closed with code: ${code}`);
+          }
+          if (code === 0 || code === null) {
+            resolve({ code: code ?? 0 });
           } else {
             reject(new Error(`${pkg.name} exited with code ${code}`));
           }

package/src/functions/workspace-utils/run-cmd-in-parallel.mts

@@ -4,7 +4,8 @@ import { executeParallel } from './execute-parallel.mjs';
 import { getWorkspacePackages } from './get-workspace-packages.mjs';
 
 /**
- * Executes a npm script command across all workspace packages in parallel.
+ * Executes a npm script command across all workspace packages in parallel. Uses
+ * fail-fast behavior - stops execution immediately when any package fails.
  *
  * @param options - Configuration options for the parallel execution
  * @param options.rootPackageJsonDir - The directory containing the root
@@ -15,6 +16,7 @@ import { getWorkspacePackages } from './get-workspace-packages.mjs';
  * @param options.filterWorkspacePattern - Optional function to filter packages
  *   by name
  * @returns A promise that resolves when all packages have completed execution
+ *   successfully, or rejects immediately on first failure
  */
 export const runCmdInParallelAcrossWorkspaces = async ({
   rootPackageJsonDir,
@@ -35,13 +37,16 @@ export const runCmdInParallelAcrossWorkspaces = async ({
         ? packages
         : packages.filter((pkg) => filterWorkspacePattern(pkg.name));
 
+    console.log(
+      `\nStarting ${cmd} across ${filteredPackages.length} packages (fail-fast parallel mode)...`,
+    );
     await executeParallel(filteredPackages, cmd, concurrency);
-    console.log(`\n✅ ${cmd} completed successfully`);
+    console.log(`\n✅ ${cmd} completed successfully (all packages)`);
   } catch (error) {
-    console.error(
-      `\n❌ ${cmd} failed:`,
-      error instanceof Error ? error.message : (error?.toString() ?? ''),
-    );
+    const errorMessage =
+      error instanceof Error ? error.message : (error?.toString() ?? '');
+    console.error(`\n❌ ${cmd} failed (fail-fast mode stopped execution):`);
+    console.error(errorMessage);
     process.exit(1);
   }
 };

package/src/functions/workspace-utils/run-cmd-in-stages.mts

@@ -6,7 +6,8 @@ import { getWorkspacePackages } from './get-workspace-packages.mjs';
 /**
  * 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.
+ * packages whose dependencies have been completed in previous stages. Uses
+ * fail-fast behavior - stops execution immediately when any package fails.
  *
  * @param options - Configuration options for the staged execution
  * @param options.rootPackageJsonDir - The directory containing the root
@@ -17,6 +18,7 @@ import { getWorkspacePackages } from './get-workspace-packages.mjs';
  * @param options.filterWorkspacePattern - Optional function to filter packages
  *   by name
  * @returns A promise that resolves when all stages have completed execution
+ *   successfully, or rejects immediately on first failure
  */
 export const runCmdInStagesAcrossWorkspaces = async ({
   rootPackageJsonDir,
@@ -37,13 +39,16 @@ export const runCmdInStagesAcrossWorkspaces = async ({
         ? packages
         : packages.filter((pkg) => filterWorkspacePattern(pkg.name));
 
+    console.log(
+      `\nStarting ${cmd} across ${filteredPackages.length} packages (fail-fast mode)...`,
+    );
     await executeStages(filteredPackages, cmd, concurrency);
-    console.log(`\n✅ ${cmd} completed successfully`);
+    console.log(`\n✅ ${cmd} completed successfully (all stages)`);
   } catch (error) {
-    console.error(
-      `\n❌ ${cmd} failed:`,
-      error instanceof Error ? error.message : (error?.toString() ?? ''),
-    );
+    const errorMessage =
+      error instanceof Error ? error.message : (error?.toString() ?? '');
+    console.error(`\n❌ ${cmd} failed (fail-fast mode stopped execution):`);
+    console.error(errorMessage);
     process.exit(1);
   }
 };