nx 23.1.0 → 23.2.0-beta.1

package/dist/bin/nx.js

@@ -258,7 +258,7 @@ function warnIfUsingOutdatedGlobalInstall(globalNxVersion, localNxVersion) {
                 `Your repository uses a higher version of Nx (${localNxVersion}) than your global CLI version (${globalNxVersion})`,
             ]
             : [];
-        bodyLines.push('For more information, see https://nx.dev/more-concepts/global-nx');
+        bodyLines.push('For more information, see https://nx.dev/docs/getting-started/installation#global-installation');
         output_1.output.warn({
             title: `It's time to update Nx 🎉`,
             bodyLines,

package/dist/src/ai/configure-ai-agents-disclaimer.d.ts

@@ -0,0 +1,5 @@
+import { AgentStatusInfo } from '../daemon/message-types/configure-ai-agents';
+/**
+ * Whether to show the "configure-ai-agents is outdated" banner after a task run.
+ */
+export declare function shouldPrintConfigureAiAgentsDisclaimer(outdatedAgents: AgentStatusInfo[], workspaceRoot: string): boolean;

package/dist/src/ai/configure-ai-agents-disclaimer.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shouldPrintConfigureAiAgentsDisclaimer = shouldPrintConfigureAiAgentsDisclaimer;
+const fs_1 = require("fs");
+const detect_ai_agent_1 = require("./detect-ai-agent");
+const constants_1 = require("./constants");
+/**
+ * Whether to show the "configure-ai-agents is outdated" banner after a task run.
+ */
+function shouldPrintConfigureAiAgentsDisclaimer(outdatedAgents, workspaceRoot) {
+    if (outdatedAgents.length === 0) {
+        return false;
+    }
+    const detectedAgent = (0, detect_ai_agent_1.detectAiAgent)();
+    if (detectedAgent) {
+        return outdatedAgents.some((agent) => agent.name === detectedAgent);
+    }
+    // Unsupported agents (e.g. qwen) cannot be configured via `nx configure-ai-agents`.
+    // If the repo already has Nx rules in AGENTS.md, skip the misleading warning.
+    const agentsMd = (0, constants_1.agentsMdPath)(workspaceRoot);
+    if (!(0, fs_1.existsSync)(agentsMd)) {
+        return true;
+    }
+    try {
+        const content = (0, fs_1.readFileSync)(agentsMd, 'utf-8');
+        return !constants_1.rulesRegex.test(content);
+    }
+    catch {
+        return true;
+    }
+}

package/dist/src/command-line/add/add.js

@@ -38,9 +38,16 @@ async function installPackage(pkgName, version, nxJson) {
         const pmv = (0, package_manager_1.getPackageManagerVersion)(pm);
         const pmc = (0, package_manager_1.getPackageManagerCommand)(pm);
         // if we explicitly specify latest in yarn berry, it won't resolve the version
-        const command = pm === 'yarn' && (0, semver_1.gte)(pmv, '2.0.0') && version === 'latest'
+        let command = pm === 'yarn' && (0, semver_1.gte)(pmv, '2.0.0') && version === 'latest'
             ? `${pmc.addDev} ${pkgName}`
             : `${pmc.addDev} ${pkgName}@${version}`;
+        // pnpm 11+ fails the install when the plugin's own dependency tree
+        // carries unacknowledged build scripts, and the plugin's generators can
+        // only record allowBuilds decisions after this install. Warn and skip
+        // for this one install, like pnpm 10 did.
+        if (pm === 'pnpm' && (0, semver_1.gte)(pmv, '11.0.0')) {
+            command += ' --config.strictDepBuilds=false';
+        }
         await new Promise((resolve) => (0, child_process_1.exec)(command, {
             windowsHide: true,
         }, (error, stdout, stderr) => {

package/dist/src/command-line/import/import.js

@@ -489,7 +489,7 @@ async function runInstallDestinationRepo(packageManager, destinationGitClient) {
         output_1.output.log({
             title: 'Installing dependencies for imported code',
         });
-        (0, utils_1.runInstall)(workspace_root_1.workspaceRoot, (0, package_manager_1.getPackageManagerCommand)(packageManager));
+        (0, utils_1.runInstall)(workspace_root_1.workspaceRoot, packageManager, (0, package_manager_1.getPackageManagerCommand)(packageManager));
         await destinationGitClient.amendCommit();
     }
     catch (e) {

package/dist/src/command-line/init/ai-agent-prompts.d.ts

@@ -1,2 +1,2 @@
 import { Agent } from '../../ai/utils';
-export declare function determineAiAgents(aiAgents?: Agent[], interactive?: boolean): Promise<Agent[]>;
+export declare function determineAiAgents(aiAgents?: (Agent | 'none')[], interactive?: boolean): Promise<Agent[]>;

package/dist/src/command-line/init/ai-agent-prompts.js

@@ -8,16 +8,17 @@ const utils_1 = require("../../ai/utils");
 const detect_ai_agent_1 = require("../../ai/detect-ai-agent");
 const pc = tslib_1.__importStar(require("picocolors"));
 async function determineAiAgents(aiAgents, interactive) {
-    if (interactive === false || (0, is_ci_1.isCI)()) {
-        if (aiAgents) {
-            return aiAgents;
+    if (aiAgents) {
+        const filtered = aiAgents.filter((a) => a !== 'none');
+        if (filtered.length > 0) {
+            return filtered;
         }
+        return [];
+    }
+    if (interactive === false || (0, is_ci_1.isCI)()) {
         const detected = (0, detect_ai_agent_1.detectAiAgent)();
         return detected ? [detected] : [];
     }
-    if (aiAgents) {
-        return aiAgents;
-    }
     return await aiAgentsPrompt();
 }
 async function aiAgentsPrompt() {

package/dist/src/command-line/init/command-object.js

@@ -64,8 +64,16 @@ async function withInitOptions(yargs) {
             .option('aiAgents', {
             type: 'array',
             string: true,
-            description: 'List of AI agents to set up.',
-            choices: ['claude', 'codex', 'copilot', 'cursor', 'gemini', 'opencode'],
+            description: 'List of AI agents to set up. Use "none" to skip.',
+            choices: [
+                'claude',
+                'codex',
+                'copilot',
+                'cursor',
+                'gemini',
+                'opencode',
+                'none',
+            ],
         })
             .option('plugins', {
             type: 'string',

package/dist/src/command-line/init/configure-plugins.js

@@ -25,8 +25,9 @@ function installPluginPackages(repoRoot, pmc = (0, package_manager_1.getPackageM
         return;
     }
     if ((0, fs_1.existsSync)((0, path_1.join)(repoRoot, 'package.json'))) {
-        (0, utils_1.addDepsToPackageJson)(repoRoot, plugins);
-        (0, utils_1.runInstall)(repoRoot, pmc);
+        const packageManager = (0, package_manager_1.detectPackageManager)(repoRoot);
+        (0, utils_1.addDepsToPackageJson)(repoRoot, packageManager, plugins);
+        (0, utils_1.runInstall)(repoRoot, packageManager, pmc);
     }
     else {
         const nxJson = (0, configuration_1.readNxJson)(repoRoot);

package/dist/src/command-line/init/implementation/add-nx-to-monorepo.js

@@ -7,6 +7,7 @@ const ignore = require("ignore");
 const path_1 = require("path");
 const fileutils_1 = require("../../../utils/fileutils");
 const output_1 = require("../../../utils/output");
+const package_manager_1 = require("../../../utils/package-manager");
 const utils_1 = require("./utils");
 const connect_to_nx_cloud_1 = require("../../nx-cloud/connect/connect-to-nx-cloud");
 async function addNxToMonorepo(options, guided = true) {
@@ -76,9 +77,10 @@ async function addNxToMonorepo(options, guided = true) {
     }
     (0, utils_1.createNxJsonFile)(repoRoot, targetDefaults, cacheableOperations, scriptOutputs);
     (0, utils_1.updateGitIgnore)(repoRoot);
-    (0, utils_1.addDepsToPackageJson)(repoRoot);
+    const packageManager = (0, package_manager_1.detectPackageManager)(repoRoot);
+    (0, utils_1.addDepsToPackageJson)(repoRoot, packageManager);
     output_1.output.log({ title: '📦 Installing dependencies' });
-    (0, utils_1.runInstall)(repoRoot);
+    (0, utils_1.runInstall)(repoRoot, packageManager);
     if (nxCloudChoice === 'yes') {
         output_1.output.log({ title: '🛠️ Setting up Nx Cloud' });
         await (0, utils_1.initCloud)('nx-init-monorepo');

package/dist/src/command-line/init/implementation/add-nx-to-nest.js

@@ -86,9 +86,10 @@ async function addNxToNest(options, packageJson) {
                         : 'skip';
     }
     (0, utils_1.createNxJsonFile)(repoRoot, [], [...cacheableOperations, ...nestCacheableScripts], scriptOutputs);
-    const pmc = (0, package_manager_1.getPackageManagerCommand)();
+    const packageManager = (0, package_manager_1.detectPackageManager)(repoRoot);
+    const pmc = (0, package_manager_1.getPackageManagerCommand)(packageManager);
     (0, utils_1.updateGitIgnore)(repoRoot);
-    (0, utils_1.addDepsToPackageJson)(repoRoot);
+    (0, utils_1.addDepsToPackageJson)(repoRoot, packageManager);
     addNestPluginToPackageJson(repoRoot);
     (0, utils_1.markRootPackageJsonAsNxProjectLegacy)(repoRoot, cacheableOperations, pmc);
     createProjectJson(repoRoot, packageJson, nestCLIConfiguration);
@@ -98,7 +99,7 @@ async function addNxToNest(options, packageJson) {
         updateTsConfig(repoRoot, nestCLIConfiguration.sourceRoot);
     }
     output_1.output.log({ title: '📦 Installing dependencies' });
-    (0, utils_1.runInstall)(repoRoot);
+    (0, utils_1.runInstall)(repoRoot, packageManager, pmc);
     if (nxCloudChoice === 'yes') {
         output_1.output.log({ title: '🛠️ Setting up Nx Cloud' });
         await (0, utils_1.initCloud)('nx-init-nest');

package/dist/src/command-line/init/implementation/add-nx-to-npm-repo.js

@@ -61,9 +61,10 @@ async function addNxToNpmRepo(options, guided = true) {
                         : 'skip';
     }
     (0, utils_1.createNxJsonFile)(repoRoot, [], cacheableOperations, scriptOutputs);
-    const pmc = (0, package_manager_1.getPackageManagerCommand)();
+    const packageManager = (0, package_manager_1.detectPackageManager)(repoRoot);
+    const pmc = (0, package_manager_1.getPackageManagerCommand)(packageManager);
     (0, utils_1.updateGitIgnore)(repoRoot);
-    (0, utils_1.addDepsToPackageJson)(repoRoot);
+    (0, utils_1.addDepsToPackageJson)(repoRoot, packageManager);
     if (options.legacy) {
         (0, utils_1.markRootPackageJsonAsNxProjectLegacy)(repoRoot, cacheableOperations, pmc);
     }
@@ -71,7 +72,7 @@ async function addNxToNpmRepo(options, guided = true) {
         (0, utils_1.markPackageJsonAsNxProject)((0, path_1.join)(repoRoot, 'package.json'));
     }
     output_1.output.log({ title: '📦 Installing dependencies' });
-    (0, utils_1.runInstall)(repoRoot, pmc);
+    (0, utils_1.runInstall)(repoRoot, packageManager, pmc);
     if (nxCloudChoice === 'yes') {
         output_1.output.log({ title: '🛠️ Setting up Nx Cloud' });
         await (0, utils_1.initCloud)('nx-init-npm-repo');

package/dist/src/command-line/init/implementation/add-nx-to-turborepo.js

@@ -42,9 +42,10 @@ async function addNxToTurborepo(_options) {
         // Apply fallback JSON write
         (0, fileutils_1.writeJsonFile)(nxJsonPath, nxJson);
     }
-    const pmc = (0, package_manager_1.getPackageManagerCommand)();
+    const packageManager = (0, package_manager_1.detectPackageManager)(repoRoot);
+    const pmc = (0, package_manager_1.getPackageManagerCommand)(packageManager);
     (0, utils_1.updateGitIgnore)(repoRoot);
-    (0, utils_1.addDepsToPackageJson)(repoRoot);
+    (0, utils_1.addDepsToPackageJson)(repoRoot, packageManager);
     output_1.output.log({ title: '📦 Installing dependencies' });
-    (0, utils_1.runInstall)(repoRoot, pmc);
+    (0, utils_1.runInstall)(repoRoot, packageManager, pmc);
 }

package/dist/src/command-line/init/implementation/angular/index.js

@@ -7,6 +7,7 @@ const fileutils_1 = require("../../../../utils/fileutils");
 const versions_1 = require("../../../../utils/versions");
 const object_sort_1 = require("../../../../utils/object-sort");
 const output_1 = require("../../../../utils/output");
+const package_manager_1 = require("../../../../utils/package-manager");
 const package_json_1 = require("../../../../utils/package-json");
 const utils_1 = require("../utils");
 const integrated_workspace_1 = require("./integrated-workspace");
@@ -86,9 +87,10 @@ async function collectCacheableOperations(options) {
     return cacheableOperations;
 }
 function installDependencies() {
-    (0, utils_1.addDepsToPackageJson)(repoRoot);
+    const packageManager = (0, package_manager_1.detectPackageManager)(repoRoot);
+    (0, utils_1.addDepsToPackageJson)(repoRoot, packageManager);
     addPluginDependencies();
-    (0, utils_1.runInstall)(repoRoot);
+    (0, utils_1.runInstall)(repoRoot, packageManager);
 }
 function addPluginDependencies() {
     const packageJsonPath = (0, path_1.join)(repoRoot, 'package.json');

package/dist/src/command-line/init/implementation/utils.d.ts

@@ -1,6 +1,6 @@
 import { NxJsonConfiguration, TargetDefaultEntry, TargetDefaults } from '../../../config/nx-json';
 import { PackageJson } from '../../../utils/package-json';
-import { PackageManagerCommands } from '../../../utils/package-manager';
+import { PackageManager, PackageManagerCommands } from '../../../utils/package-manager';
 export declare function createNxJsonFile(repoRoot: string, topologicalTargets: string[], cacheableOperations: string[], scriptOutputs: {
     [name: string]: string;
 }): void;
@@ -13,9 +13,9 @@ export declare function createNxJsonFile(repoRoot: string, topologicalTargets: s
  */
 export declare function upsertTargetDefaultEntry(targetDefaults: TargetDefaults, target: string, patch: Partial<TargetDefaultEntry>): void;
 export declare function createNxJsonFromTurboJson(turboJson: Record<string, any>): NxJsonConfiguration;
-export declare function addDepsToPackageJson(repoRoot: string, additionalPackages?: string[]): void;
+export declare function addDepsToPackageJson(repoRoot: string, packageManager: PackageManager, additionalPackages?: string[]): void;
 export declare function updateGitIgnore(root: string): void;
-export declare function runInstall(repoRoot: string, pmc?: PackageManagerCommands): void;
+export declare function runInstall(repoRoot: string, packageManager?: PackageManager, pmc?: PackageManagerCommands): void;
 /**
  * Coerce any thrown value into a non-empty telemetry string. The naive
  * `error.message || String(error)` yields "" for bare `new Error()`.

package/dist/src/command-line/init/implementation/utils.js

@@ -18,9 +18,11 @@ exports.printFinalMessage = printFinalMessage;
 exports.isMonorepo = isMonorepo;
 const child_process_1 = require("child_process");
 const path_1 = require("path");
+const semver_1 = require("semver");
 const fileutils_1 = require("../../../utils/fileutils");
 const output_1 = require("../../../utils/output");
 const package_manager_1 = require("../../../utils/package-manager");
+const acknowledge_build_scripts_1 = require("../../../utils/acknowledge-build-scripts");
 const path_2 = require("../../../utils/path");
 const versions_1 = require("../../../utils/versions");
 const fs_1 = require("fs");
@@ -207,7 +209,7 @@ function createNxJsonFromTurboJson(turboJson) {
     }
     return nxJson;
 }
-function addDepsToPackageJson(repoRoot, additionalPackages) {
+function addDepsToPackageJson(repoRoot, packageManager, additionalPackages) {
     const path = (0, path_2.joinPathFragments)(repoRoot, `package.json`);
     const json = (0, fileutils_1.readJsonFile)(path);
     if (!json.devDependencies)
@@ -219,6 +221,9 @@ function addDepsToPackageJson(repoRoot, additionalPackages) {
         }
     }
     (0, fileutils_1.writeJsonFile)(path, json);
+    // nx has a postinstall script, which pnpm 11+ refuses to install
+    // unacknowledged.
+    (0, acknowledge_build_scripts_1.acknowledgeBuildScripts)(repoRoot, packageManager, { nx: true });
 }
 function updateGitIgnore(root) {
     const ignorePath = (0, path_1.join)(root, '.gitignore');
@@ -251,9 +256,23 @@ function updateGitIgnore(root) {
     }
     catch { }
 }
-function runInstall(repoRoot, pmc = (0, package_manager_1.getPackageManagerCommand)()) {
+function runInstall(repoRoot, packageManager = (0, package_manager_1.detectPackageManager)(repoRoot), pmc = (0, package_manager_1.getPackageManagerCommand)(packageManager)) {
+    let command = pmc.install;
+    // Plugins added during init can pull build-script deps whose allowBuilds
+    // entries are only recorded by their init generators after this install;
+    // warn and skip for this one install, like pnpm 10 did.
+    if (packageManager === 'pnpm') {
+        try {
+            if ((0, semver_1.gte)((0, package_manager_1.getPackageManagerVersion)('pnpm', repoRoot), '11.0.0')) {
+                command += ' --config.strictDepBuilds=false';
+            }
+        }
+        catch {
+            // The version cannot be probed; run the install unmodified.
+        }
+    }
     try {
-        (0, child_process_1.execSync)(pmc.install, {
+        (0, child_process_1.execSync)(command, {
             stdio: ['ignore', 'ignore', 'pipe'],
             encoding: 'utf8',
             cwd: repoRoot,

package/dist/src/command-line/migrate/execute-migration.d.ts

@@ -0,0 +1,72 @@
+import { MigrationsJson } from '../../config/misc-interfaces';
+import { FileChange } from '../../generators/tree';
+import { ArrayPackageGroup, NxMigrationsConfiguration, PackageJson } from '../../utils/package-json';
+interface PackageMigrationConfig extends NxMigrationsConfiguration {
+    packageJson: PackageJson;
+    packageGroup: ArrayPackageGroup;
+}
+export declare function readPackageMigrationConfig(packageName: string, dir: string): PackageMigrationConfig;
+export declare function runInstall(nxWorkspaceRoot?: string, phase?: MigrationInstallPhase): Promise<void>;
+export type MigrationInstallPhase = 'pre-migration' | 'post-migration';
+export declare class NpmPeerDepsInstallError extends Error {
+    constructor();
+}
+/**
+ * Detects npm peer-dependency resolution failures. Keyed on the `ERESOLVE`
+ * error code, which npm consistently emits for this class of failure across
+ * v7+ (`npm ERR! code ERESOLVE` / `npm error code ERESOLVE`). Falls back to a
+ * small set of stable phrases in case the code line is missing from the
+ * captured output.
+ */
+export declare function isNpmPeerDepsError(stderr: string): boolean;
+export declare function logNpmPeerDepsError(phase: MigrationInstallPhase): void;
+export declare class ChangedDepInstaller {
+    private readonly root;
+    private readonly shouldSkipInstall;
+    private initialDeps;
+    private _skippedInstall;
+    constructor(root: string, shouldSkipInstall?: boolean);
+    get skippedInstall(): boolean;
+    installDepsIfChanged(): Promise<void>;
+}
+export declare function runNxOrAngularMigration(root: string, migration: {
+    package: string;
+    name: string;
+    description?: string;
+    version: string;
+}, isVerbose: boolean, captureGeneratorOutput?: boolean, resolvedCollection?: {
+    collection: MigrationsJson;
+    collectionPath: string;
+}): Promise<{
+    changes: FileChange[];
+    nextSteps: string[];
+    agentContext: string[];
+    logs: string;
+    madeChanges: boolean;
+}>;
+export declare function getStringifiedPackageJsonDeps(root: string): string;
+export declare function runNxMigration(root: string, collectionPath: string, collection: MigrationsJson, name: string, migrationVersion: string | undefined, captureGeneratorOutput: boolean): Promise<{
+    changes: FileChange[];
+    nextSteps: string[];
+    agentContext: string[];
+    logs: string;
+}>;
+export declare function parseMigrationReturn(value: unknown): {
+    nextSteps: string[];
+    agentContext: string[];
+};
+export declare function filterStrings(value: unknown): string[];
+export declare function readMigrationCollection(packageName: string, root: string): {
+    collection: MigrationsJson;
+    collectionPath: string;
+};
+export declare function getImplementationPath(collection: MigrationsJson, collectionPath: string, name: string, migrationVersion?: string): {
+    path: string;
+    fnSymbol: string;
+};
+export declare class MigrationImplementationMissingError extends Error {
+    constructor(baseMessage: string, collectionPath: string, migrationVersion: string | undefined);
+}
+export declare function isAngularMigration(collection: MigrationsJson, name: string): import("../../config/misc-interfaces").MigrationsJsonEntry;
+export declare const getNgCompatLayer: () => Promise<typeof import("../../adapter/ngcli-adapter")>;
+export {};