fix(core): log more information when ProjectConfigurationsError is thrown (#30661)

## Current Behavior

When the `ProjectConfigurationsError` is thrown, no helpful information
is logged.

## Expected Behavior

When the `ProjectConfigurationsError` is thrown, helpful information
should be logged.

It replicates the handling previously done for `ProjectGraphError`.

## Related Issue(s)

Fixes #

Author: leosvelperez

packages/nx/src/project-graph/error-types.ts

@@ -202,8 +202,40 @@ export class ProjectConfigurationsError extends Error {
     >,
     public readonly partialProjectConfigurationsResult: ConfigurationResult
   ) {
-    super('Failed to create project configurations');
+    const messageFragments = ['Failed to create project configurations.'];
+    const mergeNodesErrors = [];
+    const unknownErrors = [];
+    for (const e of errors) {
+      if (
+        // Known error type, but unlikely to be caused by the user
+        isMergeNodesError(e)
+      ) {
+        mergeNodesErrors.push(e);
+      } else if (
+        // Known errors that are self-explanatory
+        !isAggregateCreateNodesError(e) &&
+        !isProjectsWithNoNameError(e) &&
+        !isMultipleProjectsWithSameNameError(e)
+      ) {
+        unknownErrors.push(e);
+      }
+    }
+    if (mergeNodesErrors.length > 0) {
+      messageFragments.push(
+        `This type of error most likely points to an issue within Nx. Please report it.`
+      );
+    }
+    if (unknownErrors.length > 0) {
+      messageFragments.push(
+        `If the error cause is not obvious from the below error messages, running "nx reset" may fix it. Please report the issue if you keep seeing it.`
+      );
+    }
+    super(messageFragments.join(' '));
     this.name = this.constructor.name;
+    this.errors = errors;
+    this.stack = errors
+      .map((error) => indentString(formatErrorStackAndCause(error), 2))
+      .join('\n');
   }
 }
 

packages/nx/src/utils/handle-errors.ts

@@ -1,4 +1,7 @@
-import { ProjectGraphError } from '../project-graph/error-types';
+import type {
+  ProjectConfigurationsError,
+  ProjectGraphError,
+} from '../project-graph/error-types';
 import { logger } from './logger';
 import { output } from './output';
 
@@ -33,6 +36,23 @@ export async function handleErrors(
           ? formatErrorStackAndCause(projectGraphError, isVerbose)
           : projectGraphError.getErrors().map((e) => e.message),
       });
+    } else if (err.name === 'ProjectConfigurationsError') {
+      const projectConfigurationsError = err as ProjectConfigurationsError;
+      let title = projectConfigurationsError.message;
+      if (
+        projectConfigurationsError.cause &&
+        typeof projectConfigurationsError.cause === 'object' &&
+        'message' in projectConfigurationsError.cause
+      ) {
+        title += ' ' + projectConfigurationsError.cause.message + '.';
+      }
+
+      output.error({
+        title,
+        bodyLines: isVerbose
+          ? formatErrorStackAndCause(projectConfigurationsError, isVerbose)
+          : projectConfigurationsError.errors.map((e) => e.message),
+      });
     } else {
       const lines = (err.message ? err.message : err.toString()).split('\n');
       const bodyLines: string[] = lines.slice(1);