cleanup(core): address pr feedback

docs/generated/cli/add.md

@@ -23,7 +23,7 @@ Install the latest version of the `@nx/react` package and run its `@nx/react:ini
  nx add @nx/react
 ```
 
-Install the version `17.0.0` of the `@nx/react` package and run its `@nx/react:init` generator:
+Install version `17.0.0` of the `@nx/react` package and run its `@nx/react:init` generator:
 
 ```shell
  nx add @nx/[email protected]
@@ -41,7 +41,13 @@ Show help
 
 Type: `string`
 
-The name of an installed plugin to query
+The package name and optional version (e.g. `@nx/react` or `@nx/react@latest`) to install and initialize
+
+### verbose
+
+Type: `boolean`
+
+Prints additional information about the commands (e.g., stack traces)
 
 ### version
 

docs/generated/packages/nx/documents/add.md

@@ -23,7 +23,7 @@ Install the latest version of the `@nx/react` package and run its `@nx/react:ini
  nx add @nx/react
 ```
 
-Install the version `17.0.0` of the `@nx/react` package and run its `@nx/react:init` generator:
+Install version `17.0.0` of the `@nx/react` package and run its `@nx/react:init` generator:
 
 ```shell
  nx add @nx/[email protected]
@@ -41,7 +41,13 @@ Show help
 
 Type: `string`
 
-The name of an installed plugin to query
+The package name and optional version (e.g. `@nx/react` or `@nx/react@latest`) to install and initialize
+
+### verbose
+
+Type: `boolean`
+
+Prints additional information about the commands (e.g., stack traces)
 
 ### version
 

packages/nx/src/command-line/add/add.ts

@@ -8,21 +8,29 @@ import {
   getPackageManagerCommand,
   type PackageManagerCommands,
 } from '../../utils/package-manager';
+import { handleErrors } from '../../utils/params';
 import { getPluginCapabilities } from '../../utils/plugins';
 import { workspaceRoot } from '../../utils/workspace-root';
 import type { AddOptions } from './command-object';
 
-export async function addHandler(args: AddOptions): Promise<void> {
-  output.addNewline();
+export function addHandler(args: AddOptions): Promise<void> {
+  if (args.verbose) {
+    process.env.NX_VERBOSE_LOGGING = 'true';
+  }
+  const isVerbose = process.env.NX_VERBOSE_LOGGING === 'true';
+
+  return handleErrors(isVerbose, async () => {
+    output.addNewline();
 
-  const pmc = getPackageManagerCommand();
-  const [pkgName, version] = parsePackageSpecifier(args.packageSpecifier);
+    const pmc = getPackageManagerCommand();
+    const [pkgName, version] = parsePackageSpecifier(args.packageSpecifier);
 
-  await installPackage(pkgName, version, pmc);
-  await initializePlugin(pkgName, pmc);
+    await installPackage(pkgName, version, pmc);
+    await initializePlugin(pkgName, pmc);
 
-  output.success({
-    title: `Package ${pkgName} added successfully.`,
+    output.success({
+      title: `Package ${pkgName} added successfully.`,
+    });
   });
 }
 

packages/nx/src/command-line/add/command-object.ts

@@ -2,6 +2,7 @@ import { CommandModule } from 'yargs';
 
 export interface AddOptions {
   packageSpecifier: string;
+  verbose?: boolean;
 }
 
 export const yargsAddCommand: CommandModule<
@@ -14,15 +15,21 @@ export const yargsAddCommand: CommandModule<
     yargs
       .positional('packageSpecifier', {
         type: 'string',
-        description: 'The name of an installed plugin to query',
+        description:
+          'The package name and optional version (e.g. `@nx/react` or `@nx/react@latest`) to install and initialize',
+      })
+      .option('verbose', {
+        type: 'boolean',
+        description:
+          'Prints additional information about the commands (e.g., stack traces)',
       })
       .example(
         '$0 add @nx/react',
         'Install the latest version of the `@nx/react` package and run its `@nx/react:init` generator'
       )
       .example(
         '$0 add @nx/[email protected]',
-        'Install the version `17.0.0` of the `@nx/react` package and run its `@nx/react:init` generator'
-      ),
+        'Install version `17.0.0` of the `@nx/react` package and run its `@nx/react:init` generator'
+      ) as any,
   handler: (args) => import('./add').then((m) => m.addHandler(args)),
 };

packages/nx/src/command-line/examples.ts

@@ -398,7 +398,7 @@ export const examples: Record<string, Example[]> = {
     {
       command: 'add @nx/[email protected]',
       description:
-        'Install the version `17.0.0` of the `@nx/react` package and run its `@nx/react:init` generator',
+        'Install version `17.0.0` of the `@nx/react` package and run its `@nx/react:init` generator',
     },
   ],
 };