nx 23.0.0-beta.21 → 23.0.0-beta.23

package/dist/src/project-graph/plugins/transpiler.js

@@ -26,6 +26,14 @@ function registerPluginTSTranspiler() {
         return;
     }
     if ((0, register_1.isNativeStripPreferred)()) {
+        // Native strip handles `.ts` syntax but doesn't rewrite NodeNext-style
+        // `.js` relative specifiers to their `.ts` sources. Patch the CJS resolver
+        // so `require('./foo.js')` from a `.ts` plugin source falls back to
+        // `./foo.ts`, and register an ESM resolution hook so the same rewrite
+        // happens on the dynamic-import path (the CJS patch can't reach ESM
+        // resolution). Both are idempotent and best-effort.
+        (0, register_1.ensureCjsResolverPatched)();
+        (0, register_1.ensureNodeNextEsmResolverRegistered)();
         // Sentinel so pluginTranspilerIsRegistered() reports true and callers
         // don't keep retrying. The actual transpiler stays unregistered until
         // a fallback forces it.
@@ -71,6 +79,9 @@ function doRegisterPluginTSTranspiler() {
             ...tsConfig.options,
         }, tsConfig.raw),
     ];
+    // Fall back from NodeNext `.js` specifiers to their `.ts` sources when a
+    // `.ts` plugin source require()s a sibling. Idempotent.
+    (0, register_1.ensureCjsResolverPatched)();
     exports.unregisterPluginTSTranspiler = () => {
         cleanupFns.forEach((fn) => fn?.());
     };

package/dist/src/project-graph/plugins/utils.d.ts

@@ -1,4 +1,4 @@
-import { CreateNodesContextV2, CreateNodesResult } from './public-api';
-export declare function createNodesFromFiles<T = unknown>(createNodes: (projectConfigurationFile: string, options: T | undefined, context: CreateNodesContextV2 & {
+import { CreateNodesContext, CreateNodesResult } from './public-api';
+export declare function createNodesFromFiles<T = unknown>(createNodes: (projectConfigurationFile: string, options: T | undefined, context: CreateNodesContext & {
     configFiles: readonly string[];
-}, idx: number) => CreateNodesResult | Promise<CreateNodesResult>, configFiles: readonly string[], options: T, context: CreateNodesContextV2): Promise<[file: string, value: CreateNodesResult][]>;
+}, idx: number) => CreateNodesResult | Promise<CreateNodesResult>, configFiles: readonly string[], options: T, context: CreateNodesContext): Promise<[file: string, value: CreateNodesResult][]>;

package/dist/src/project-graph/utils/project-configuration-utils.d.ts

@@ -80,4 +80,4 @@ export declare function mergeCreateNodesResults(specifiedResults: CreateNodesRes
     rootMap: Record<string, string>;
     configurationSourceMaps: ConfigurationSourceMaps;
 };
-export declare function findMatchingConfigFiles(projectFiles: string[], pattern: string, include: string[], exclude: string[]): string[];
+export declare function findMatchingConfigFiles(projectFiles: string[], include: string[], exclude: string[]): string[];

package/dist/src/project-graph/utils/project-configuration-utils.js

@@ -58,8 +58,8 @@ async function createProjectConfigurationsWithPlugins(root = workspace_root_1.wo
     const errors = [];
     // We iterate over plugins first - this ensures that plugins specified first take precedence.
     for (const [index, { index: pluginIndex, createNodes: createNodesTuple, include, exclude, name: pluginName, },] of allCreateNodesPlugins.entries()) {
-        const [pattern, createNodes] = createNodesTuple;
-        const matchingConfigFiles = findMatchingConfigFiles(allProjectFiles[index], pattern, include, exclude);
+        const [, createNodes] = createNodesTuple;
+        const matchingConfigFiles = findMatchingConfigFiles(allProjectFiles[index], include, exclude);
         inProgressPlugins.add(pluginName);
         let r = createNodes(matchingConfigFiles, {
             nxJsonConfiguration: nxJson,
@@ -313,22 +313,11 @@ function createMatcher(patterns, emptyValue) {
         ? (file) => matchesNegationPatterns(file, patterns)
         : (file) => matchesSimplePatterns(file, patterns);
 }
-function findMatchingConfigFiles(projectFiles, pattern, include, exclude) {
-    const matchingConfigFiles = [];
-    // Create matchers once, outside the loop
+function findMatchingConfigFiles(projectFiles, include, exclude) {
+    // projectFiles already comes from multiGlobWithWorkspaceContext for the
+    // plugin's createNodes pattern, so only include/exclude filters remain here.
     // Empty include means include everything, empty exclude means exclude nothing
     const includes = createMatcher(include, true);
     const excludes = createMatcher(exclude, false);
-    for (const file of projectFiles) {
-        if ((0, minimatch_1.minimatch)(file, pattern, { dot: true })) {
-            if (!includes(file)) {
-                continue;
-            }
-            if (excludes(file)) {
-                continue;
-            }
-            matchingConfigFiles.push(file);
-        }
-    }
-    return matchingConfigFiles;
+    return projectFiles.filter((file) => includes(file) && !excludes(file));
 }

package/dist/src/tasks-runner/init-tasks-runner.d.ts

@@ -3,5 +3,5 @@ import { Task, TaskGraph } from '../config/task-graph';
 import { LifeCycle, TaskResult } from './life-cycle';
 import type { ProjectGraph } from '../config/project-graph';
 import { RunningTask } from './running-tasks/running-task';
-export declare function runDiscreteTasks(tasks: Task[], projectGraph: ProjectGraph, taskGraphForHashing: TaskGraph, nxJson: NxJsonConfiguration, lifeCycle: LifeCycle): Promise<Array<Promise<TaskResult[]>>>;
-export declare function runContinuousTasks(tasks: Task[], projectGraph: ProjectGraph, taskGraphForHashing: TaskGraph, nxJson: NxJsonConfiguration, lifeCycle: LifeCycle): Promise<Record<string, Promise<RunningTask>>>;
+export declare function runDiscreteTasks(tasks: Task[], projectGraph: ProjectGraph, fullTaskGraph: TaskGraph, nxJson: NxJsonConfiguration, lifeCycle: LifeCycle): Promise<Array<Promise<TaskResult[]>>>;
+export declare function runContinuousTasks(tasks: Task[], projectGraph: ProjectGraph, fullTaskGraph: TaskGraph, nxJson: NxJsonConfiguration, lifeCycle: LifeCycle): Promise<Record<string, Promise<RunningTask>>>;

package/dist/src/tasks-runner/init-tasks-runner.js

@@ -10,7 +10,7 @@ const task_orchestrator_1 = require("./task-orchestrator");
 const create_task_hasher_1 = require("../hasher/create-task-hasher");
 const client_1 = require("../daemon/client/client");
 const task_results_life_cycle_1 = require("./life-cycles/task-results-life-cycle");
-async function createOrchestrator(tasks, projectGraph, taskGraphForHashing, nxJson, lifeCycle) {
+async function createOrchestrator(tasks, projectGraph, fullTaskGraph, nxJson, lifeCycle) {
     (0, dotenv_1.loadRootEnvFiles)();
     const invokeRunnerTerminalLifecycle = new invoke_runner_terminal_output_life_cycle_1.InvokeRunnerTerminalOutputLifeCycle(tasks);
     const taskResultsLifecycle = new task_results_life_cycle_1.TaskResultsLifeCycle();
@@ -42,13 +42,13 @@ async function createOrchestrator(tasks, projectGraph, taskGraphForHashing, nxJs
         lifeCycle: compositedLifeCycle,
     };
     (0, run_command_1.setEnvVarsBasedOnArgs)(nxArgs, true);
-    const orchestrator = new task_orchestrator_1.TaskOrchestrator(hasher, null, tasks, projectGraph, taskGraph, nxJson, nxArgs, false, client_1.daemonClient, undefined, taskGraphForHashing);
+    const orchestrator = new task_orchestrator_1.TaskOrchestrator(hasher, null, tasks, projectGraph, taskGraph, nxJson, nxArgs, false, client_1.daemonClient, undefined, fullTaskGraph);
     await orchestrator.init();
     orchestrator.processAllScheduledTasks();
     return orchestrator;
 }
-async function runDiscreteTasks(tasks, projectGraph, taskGraphForHashing, nxJson, lifeCycle) {
-    const orchestrator = await createOrchestrator(tasks, projectGraph, taskGraphForHashing, nxJson, lifeCycle);
+async function runDiscreteTasks(tasks, projectGraph, fullTaskGraph, nxJson, lifeCycle) {
+    const orchestrator = await createOrchestrator(tasks, projectGraph, fullTaskGraph, nxJson, lifeCycle);
     let groupId = 0;
     let nextBatch = orchestrator.nextBatch();
     const batchResults = [];
@@ -77,8 +77,8 @@ async function runDiscreteTasks(tasks, projectGraph, taskGraphForHashing, nxJson
     });
     return [...batchResults, ...taskResults];
 }
-async function runContinuousTasks(tasks, projectGraph, taskGraphForHashing, nxJson, lifeCycle) {
-    const orchestrator = await createOrchestrator(tasks, projectGraph, taskGraphForHashing, nxJson, lifeCycle);
+async function runContinuousTasks(tasks, projectGraph, fullTaskGraph, nxJson, lifeCycle) {
+    const orchestrator = await createOrchestrator(tasks, projectGraph, fullTaskGraph, nxJson, lifeCycle);
     return tasks.reduce((current, task, index) => {
         current[task.id] = orchestrator.startContinuousTask(task, index);
         return current;

package/dist/src/tasks-runner/task-orchestrator.d.ts

@@ -21,7 +21,7 @@ export declare class TaskOrchestrator {
     private readonly bail;
     private readonly daemon;
     private readonly outputStyle;
-    private readonly taskGraphForHashing;
+    private readonly fullTaskGraph;
     private taskDetails;
     private cache;
     private readonly tuiEnabled;
@@ -49,7 +49,7 @@ export declare class TaskOrchestrator {
     private discreteTaskExitHandled;
     private continuousTaskExitHandled;
     private cleanupPromise;
-    constructor(hasher: TaskHasher, initiatingProject: string | undefined, initiatingTasks: Task[], projectGraph: ProjectGraph, taskGraph: TaskGraph, nxJson: NxJsonConfiguration, options: NxArgs & DefaultTasksRunnerOptions, bail: boolean, daemon: DaemonClient, outputStyle: string, taskGraphForHashing?: TaskGraph);
+    constructor(hasher: TaskHasher, initiatingProject: string | undefined, initiatingTasks: Task[], projectGraph: ProjectGraph, taskGraph: TaskGraph, nxJson: NxJsonConfiguration, options: NxArgs & DefaultTasksRunnerOptions, bail: boolean, daemon: DaemonClient, outputStyle: string, fullTaskGraph?: TaskGraph);
     init(): Promise<void>;
     run(): Promise<{
         [k: string]: TaskStatus;

package/dist/src/tasks-runner/task-orchestrator.js

@@ -39,7 +39,7 @@ function resolveBatchTaskStatus(result) {
 }
 class TaskOrchestrator {
     // endregion internal state
-    constructor(hasher, initiatingProject, initiatingTasks, projectGraph, taskGraph, nxJson, options, bail, daemon, outputStyle, taskGraphForHashing = taskGraph) {
+    constructor(hasher, initiatingProject, initiatingTasks, projectGraph, taskGraph, nxJson, options, bail, daemon, outputStyle, fullTaskGraph = taskGraph) {
         this.hasher = hasher;
         this.initiatingProject = initiatingProject;
         this.initiatingTasks = initiatingTasks;
@@ -50,7 +50,7 @@ class TaskOrchestrator {
         this.bail = bail;
         this.daemon = daemon;
         this.outputStyle = outputStyle;
-        this.taskGraphForHashing = taskGraphForHashing;
+        this.fullTaskGraph = fullTaskGraph;
         this.taskDetails = (0, hash_task_1.getTaskDetails)();
         this.cache = (0, cache_1.getCache)(this.options);
         this.tuiEnabled = (0, is_tui_enabled_1.isTuiEnabled)();
@@ -185,7 +185,7 @@ class TaskOrchestrator {
                     for (const task of unhashed) {
                         perTaskEnvs[task.id] = (0, task_env_1.getTaskSpecificEnv)(task, this.projectGraph);
                     }
-                    await (0, hash_task_1.hashTasks)(this.hasher, this.projectGraph, this.taskGraphForHashing, perTaskEnvs, this.taskDetails, unhashed);
+                    await (0, hash_task_1.hashTasks)(this.hasher, this.projectGraph, this.fullTaskGraph, perTaskEnvs, this.taskDetails, unhashed);
                 }
             }
             // 2. Bulk-resolve cache hits before processTask — avoids N
@@ -257,7 +257,7 @@ class TaskOrchestrator {
         const task = this.taskGraph.tasks[taskId];
         const taskSpecificEnv = (0, task_env_1.getTaskSpecificEnv)(task, this.projectGraph);
         if (!task.hash) {
-            await (0, hash_task_1.hashTask)(this.hasher, this.projectGraph, this.taskGraphForHashing, task, taskSpecificEnv, this.taskDetails);
+            await (0, hash_task_1.hashTask)(this.hasher, this.projectGraph, this.fullTaskGraph, task, taskSpecificEnv, this.taskDetails);
         }
         await this.options.lifeCycle.scheduleTask(task);
         return taskSpecificEnv;
@@ -474,7 +474,7 @@ class TaskOrchestrator {
         for (const task of tasks) {
             perTaskEnvs[task.id] = (0, task_env_1.getTaskSpecificEnv)(task, this.projectGraph);
         }
-        await (0, hash_task_1.hashTasks)(this.hasher, this.projectGraph, this.taskGraphForHashing, perTaskEnvs, this.taskDetails, tasks);
+        await (0, hash_task_1.hashTasks)(this.hasher, this.projectGraph, this.fullTaskGraph, perTaskEnvs, this.taskDetails, tasks);
     }
     async applyFromCacheOrRunBatch(doNotSkipCache, batch, groupId) {
         const applyFromCacheOrRunBatchStart = perf_hooks_1.performance.mark('TaskOrchestrator-apply-from-cache-or-run-batch:start');
@@ -542,7 +542,7 @@ class TaskOrchestrator {
     async runBatch(batch, env, groupId) {
         const runBatchStart = perf_hooks_1.performance.mark('TaskOrchestrator-run-batch:start');
         try {
-            const batchProcess = await this.forkedProcessTaskRunner.forkProcessForBatch(batch, this.projectGraph, this.taskGraph, env);
+            const batchProcess = await this.forkedProcessTaskRunner.forkProcessForBatch(batch, this.projectGraph, this.fullTaskGraph, env);
             // Stream output from batch process to the batch
             batchProcess.onOutput((output) => {
                 this.options.lifeCycle.appendBatchOutput?.(batch.id, output);

package/dist/src/utils/package-json.d.ts

@@ -1,7 +1,7 @@
 import { NxJsonConfiguration } from '../config/nx-json';
 import { ProjectConfiguration, ProjectMetadata, TargetConfiguration } from '../config/workspace-json-project-json';
 import type { Tree } from '../generators/tree';
-import { PackageManagerCommands } from './package-manager';
+import { PackageManager, PackageManagerCommands } from './package-manager';
 export interface NxProjectPackageJsonConfiguration extends Partial<ProjectConfiguration> {
     includedScripts?: string[];
 }
@@ -137,11 +137,11 @@ export declare function readModulePackageJson(moduleSpecifier: string, requirePa
     packageJson: PackageJson;
     path: string;
 };
-export declare function installPackageToTmp(pkg: string, requiredVersion: string): {
+export declare function installPackageToTmp(pkg: string, requiredVersion: string, packageManager: PackageManager): {
     tempDir: string;
     cleanup: () => void;
 };
-export declare function installPackageToTmpAsync(pkg: string, requiredVersion: string): Promise<{
+export declare function installPackageToTmpAsync(pkg: string, requiredVersion: string, packageManager: PackageManager): Promise<{
     tempDir: string;
     cleanup: () => void;
 }>;

package/dist/src/utils/package-json.js

@@ -214,22 +214,20 @@ function readModulePackageJson(moduleSpecifier, requirePaths = (0, installation_
  * Prepares all necessary information for installing a package to a temporary directory.
  * This is used by both sync and async installation functions.
  */
-function preparePackageInstallation(pkg, requiredVersion) {
+function preparePackageInstallation(pkg, requiredVersion, packageManager) {
     const { dir: tempDir, cleanup } = (0, package_manager_1.createTempNpmDirectory)?.() ?? {
         dir: (0, tmp_1.dirSync)().name,
         cleanup: () => { },
     };
     console.log(`Fetching ${pkg}...`);
-    const packageManager = (0, package_manager_1.detectPackageManager)(workspace_root_1.workspaceRoot);
     const isVerbose = process.env.NX_VERBOSE_LOGGING === 'true';
     generatePackageManagerFiles(tempDir, packageManager);
+    // For pnpm, `addDev` is `pnpm add -Dw` when the workspace has a
+    // pnpm-workspace.yaml. `createTempNpmDirectory` copies a sanitized copy of
+    // it into the temp dir, so the `-w` here resolves to the temp dir.
     const pmCommands = (0, package_manager_1.getPackageManagerCommand)(packageManager);
     const preInstallCommand = pmCommands.preInstall;
-    let addCommand = pmCommands.addDev;
-    if (packageManager === 'pnpm') {
-        addCommand = 'pnpm add -D'; // we need to ensure that we are not using workspace command
-    }
-    const installCommand = `${addCommand} ${pkg}@${requiredVersion} ${pmCommands.ignoreScriptsFlag ?? ''}`;
+    const installCommand = `${pmCommands.addDev} ${pkg}@${requiredVersion} ${pmCommands.ignoreScriptsFlag ?? ''}`;
     const execOptions = {
         cwd: tempDir,
         stdio: isVerbose ? 'inherit' : 'ignore',
@@ -249,8 +247,8 @@ function preparePackageInstallation(pkg, requiredVersion) {
         execOptions,
     };
 }
-function installPackageToTmp(pkg, requiredVersion) {
-    const { tempDir, cleanup, preInstallCommand, installCommand, execOptions } = preparePackageInstallation(pkg, requiredVersion);
+function installPackageToTmp(pkg, requiredVersion, packageManager) {
+    const { tempDir, cleanup, preInstallCommand, installCommand, execOptions } = preparePackageInstallation(pkg, requiredVersion, packageManager);
     if (preInstallCommand) {
         // ensure package.json and repo in tmp folder is set to a proper package manager state
         (0, child_process_1.execSync)(preInstallCommand, execOptions);
@@ -261,8 +259,8 @@ function installPackageToTmp(pkg, requiredVersion) {
         cleanup,
     };
 }
-async function installPackageToTmpAsync(pkg, requiredVersion) {
-    const { tempDir, cleanup, preInstallCommand, installCommand, execOptions } = preparePackageInstallation(pkg, requiredVersion);
+async function installPackageToTmpAsync(pkg, requiredVersion, packageManager) {
+    const { tempDir, cleanup, preInstallCommand, installCommand, execOptions } = preparePackageInstallation(pkg, requiredVersion, packageManager);
     try {
         if (preInstallCommand) {
             // ensure package.json and repo in tmp folder is set to a proper package manager state

package/dist/src/utils/package-manager.d.ts

@@ -75,6 +75,19 @@ export declare function modifyYarnRcYmlToFitNewDirectory(contents: string): stri
  * @returns Updated string contents of the yarnrc.yml file
  */
 export declare function modifyYarnRcToFitNewDirectory(contents: string): string;
+/**
+ * We copy pnpm-workspace.yaml to the temporary directory so the workspace's
+ * registry, auth and release-age settings still apply, and so `pnpm add -w`
+ * recognizes the directory as a workspace root. `packages` (member globs) and
+ * `patchedDependencies` (relative patch paths) only resolve in the real
+ * workspace, so they are dropped.
+ *
+ * Exported for testing - not meant to be used outside of this file.
+ *
+ * @param contents The string contents of the pnpm-workspace.yaml file
+ * @returns Updated string contents of the pnpm-workspace.yaml file
+ */
+export declare function modifyPnpmWorkspaceYamlToFitNewDirectory(contents: string): string;
 export declare function copyPackageManagerConfigurationFiles(root: string, destination: string): void;
 /**
  * Creates a temporary directory where you can run package manager commands safely.

package/dist/src/utils/package-manager.js

@@ -8,6 +8,7 @@ exports.parseVersionFromPackageManagerField = parseVersionFromPackageManagerFiel
 exports.findFileInPackageJsonDirectory = findFileInPackageJsonDirectory;
 exports.modifyYarnRcYmlToFitNewDirectory = modifyYarnRcYmlToFitNewDirectory;
 exports.modifyYarnRcToFitNewDirectory = modifyYarnRcToFitNewDirectory;
+exports.modifyPnpmWorkspaceYamlToFitNewDirectory = modifyPnpmWorkspaceYamlToFitNewDirectory;
 exports.copyPackageManagerConfigurationFiles = copyPackageManagerConfigurationFiles;
 exports.createTempNpmDirectory = createTempNpmDirectory;
 exports.resolvePackageVersionUsingRegistry = resolvePackageVersionUsingRegistry;
@@ -322,12 +323,33 @@ function modifyYarnRcToFitNewDirectory(contents) {
     }
     return lines.join('\n');
 }
+/**
+ * We copy pnpm-workspace.yaml to the temporary directory so the workspace's
+ * registry, auth and release-age settings still apply, and so `pnpm add -w`
+ * recognizes the directory as a workspace root. `packages` (member globs) and
+ * `patchedDependencies` (relative patch paths) only resolve in the real
+ * workspace, so they are dropped.
+ *
+ * Exported for testing - not meant to be used outside of this file.
+ *
+ * @param contents The string contents of the pnpm-workspace.yaml file
+ * @returns Updated string contents of the pnpm-workspace.yaml file
+ */
+function modifyPnpmWorkspaceYamlToFitNewDirectory(contents) {
+    const doc = (0, yaml_1.parseDocument)(contents);
+    if (doc.contents) {
+        doc.delete('packages');
+        doc.delete('patchedDependencies');
+    }
+    return doc.toString();
+}
 function copyPackageManagerConfigurationFiles(root, destination) {
     for (const packageManagerConfigFile of [
         '.npmrc',
         '.yarnrc',
         '.yarnrc.yml',
         'bunfig.toml',
+        'pnpm-workspace.yaml',
     ]) {
         // f is an absolute path, including the {workspaceRoot}.
         const f = findFileInPackageJsonDirectory(packageManagerConfigFile, root);
@@ -355,6 +377,11 @@ function copyPackageManagerConfigurationFiles(root, destination) {
                     (0, fs_1.copyFileSync)(f, destinationPath);
                     break;
                 }
+                case 'pnpm-workspace.yaml': {
+                    const updated = modifyPnpmWorkspaceYamlToFitNewDirectory((0, fileutils_1.readFileIfExisting)(f));
+                    (0, fs_1.writeFileSync)(destinationPath, updated);
+                    break;
+                }
             }
         }
     }

package/migrations.json

@@ -41,7 +41,8 @@
       "cli": "nx",
       "version": "17.0.0-beta.1",
       "description": "Updates the default cache directory to .nx/cache",
-      "implementation": "./dist/src/migrations/update-17-0-0/move-cache-directory"
+      "implementation": "./dist/src/migrations/update-17-0-0/move-cache-directory",
+      "documentation": "./dist/src/migrations/update-17-0-0/move-cache-directory.md"
     },
     "17.0.0-use-minimal-config-for-tasks-runner-options": {
       "cli": "nx",
@@ -93,33 +94,39 @@
     "move-use-daemon-process": {
       "version": "20.0.0-beta.7",
       "description": "Migration for v20.0.0-beta.7",
-      "implementation": "./dist/src/migrations/update-20-0-0/move-use-daemon-process"
+      "implementation": "./dist/src/migrations/update-20-0-0/move-use-daemon-process",
+      "documentation": "./dist/src/migrations/update-20-0-0/move-use-daemon-process.md"
     },
     "use-legacy-cache": {
       "version": "20.0.1",
       "description": "Set `useLegacyCache` to true for migrating workspaces",
       "implementation": "./dist/src/migrations/update-20-0-1/use-legacy-cache",
-      "x-repair-skip": true
+      "x-repair-skip": true,
+      "documentation": "./dist/src/migrations/update-20-0-1/use-legacy-cache.md"
     },
     "remove-legacy-cache": {
       "version": "21.0.0-beta.8",
       "description": "Removes the legacy cache configuration from nx.json",
-      "implementation": "./dist/src/migrations/update-21-0-0/remove-legacy-cache"
+      "implementation": "./dist/src/migrations/update-21-0-0/remove-legacy-cache",
+      "documentation": "./dist/src/migrations/update-21-0-0/remove-legacy-cache.md"
     },
     "remove-custom-tasks-runner": {
       "version": "21.0.0-beta.8",
       "description": "Removes the legacy cache configuration from nx.json",
-      "implementation": "./dist/src/migrations/update-21-0-0/remove-custom-tasks-runner"
+      "implementation": "./dist/src/migrations/update-21-0-0/remove-custom-tasks-runner",
+      "documentation": "./dist/src/migrations/update-21-0-0/remove-custom-tasks-runner.md"
     },
     "release-version-config-changes": {
       "version": "21.0.0-beta.11",
       "description": "Updates release version config based on the breaking changes in Nx v21",
-      "implementation": "./dist/src/migrations/update-21-0-0/release-version-config-changes"
+      "implementation": "./dist/src/migrations/update-21-0-0/release-version-config-changes",
+      "documentation": "./dist/src/migrations/update-21-0-0/release-version-config-changes.md"
     },
     "release-changelog-config-changes": {
       "version": "21.0.0-beta.11",
       "description": "Updates release changelog config based on the breaking changes in Nx v21",
-      "implementation": "./dist/src/migrations/update-21-0-0/release-changelog-config-changes"
+      "implementation": "./dist/src/migrations/update-21-0-0/release-changelog-config-changes",
+      "documentation": "./dist/src/migrations/update-21-0-0/release-changelog-config-changes.md"
     },
     "22-0-0-release-version-config-changes": {
       "version": "22.0.0-beta.1",
@@ -159,7 +166,8 @@
       "cli": "nx",
       "version": "22.7.0-beta.0",
       "description": "Adds .nx/self-healing to .gitignore",
-      "implementation": "./dist/src/migrations/update-22-2-0/add-self-healing-to-gitignore"
+      "implementation": "./dist/src/migrations/update-22-2-0/add-self-healing-to-gitignore",
+      "documentation": "./dist/src/migrations/update-22-2-0/add-self-healing-to-gitignore.md"
     },
     "23-0-0-consolidate-release-tag-config": {
       "version": "23.0.0-beta.16",
@@ -170,7 +178,8 @@
       "cli": "nx",
       "version": "23.0.0-beta.13",
       "description": "Converts nx.json `targetDefaults` from the legacy record shape to the new filtered array shape.",
-      "implementation": "./dist/src/migrations/update-23-0-0/convert-target-defaults-to-array"
+      "implementation": "./dist/src/migrations/update-23-0-0/convert-target-defaults-to-array",
+      "documentation": "./dist/src/migrations/update-23-0-0/convert-target-defaults-to-array.md"
     },
     "23-0-0-add-migrate-runs-to-git-ignore": {
       "version": "23.0.0-beta.18",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nx",
-  "version": "23.0.0-beta.21",
+  "version": "23.0.0-beta.23",
   "private": false,
   "type": "commonjs",
   "description": "The core Nx plugin contains the core functionality of Nx like the project graph, nx commands and task orchestration.",
@@ -172,16 +172,16 @@
     }
   },
   "optionalDependencies": {
-    "@nx/nx-darwin-arm64": "23.0.0-beta.21",
-    "@nx/nx-darwin-x64": "23.0.0-beta.21",
-    "@nx/nx-freebsd-x64": "23.0.0-beta.21",
-    "@nx/nx-linux-arm-gnueabihf": "23.0.0-beta.21",
-    "@nx/nx-linux-arm64-gnu": "23.0.0-beta.21",
-    "@nx/nx-linux-arm64-musl": "23.0.0-beta.21",
-    "@nx/nx-linux-x64-gnu": "23.0.0-beta.21",
-    "@nx/nx-linux-x64-musl": "23.0.0-beta.21",
-    "@nx/nx-win32-arm64-msvc": "23.0.0-beta.21",
-    "@nx/nx-win32-x64-msvc": "23.0.0-beta.21"
+    "@nx/nx-darwin-arm64": "23.0.0-beta.23",
+    "@nx/nx-darwin-x64": "23.0.0-beta.23",
+    "@nx/nx-freebsd-x64": "23.0.0-beta.23",
+    "@nx/nx-linux-arm-gnueabihf": "23.0.0-beta.23",
+    "@nx/nx-linux-arm64-gnu": "23.0.0-beta.23",
+    "@nx/nx-linux-arm64-musl": "23.0.0-beta.23",
+    "@nx/nx-linux-x64-gnu": "23.0.0-beta.23",
+    "@nx/nx-linux-x64-musl": "23.0.0-beta.23",
+    "@nx/nx-win32-arm64-msvc": "23.0.0-beta.23",
+    "@nx/nx-win32-x64-msvc": "23.0.0-beta.23"
   },
   "nx-migrations": {
     "migrations": "./migrations.json",

package/schemas/nx-schema.json

@@ -421,6 +421,47 @@
       },
       "additionalProperties": false
     },
+    "migrate": {
+      "type": "object",
+      "description": "Configuration for the `nx migrate` command",
+      "properties": {
+        "createCommits": {
+          "type": "boolean",
+          "description": "Whether to automatically create a git commit after each migration runs. Equivalent to the `--create-commits` flag. Defaults to `false`."
+        },
+        "commitPrefix": {
+          "type": "string",
+          "description": "Commit message prefix applied to each migration commit when commits are enabled. Equivalent to the `--commit-prefix` flag. Defaults to `\"chore: [nx migration] \"`."
+        },
+        "mode": {
+          "type": "string",
+          "enum": ["first-party", "third-party", "all"],
+          "description": "Restricts which packages to migrate when migrating Nx itself. Equivalent to the `--mode` flag. Defaults to `all`."
+        },
+        "multiMajorMode": {
+          "type": "string",
+          "enum": ["direct", "gradual"],
+          "description": "How to handle a migration that crosses more than one major version. Equivalent to the `--multi-major-mode` flag. The `NX_MULTI_MAJOR_MODE` environment variable takes precedence over this setting."
+        },
+        "agentic": {
+          "oneOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "string",
+              "enum": ["claude-code", "codex", "opencode"]
+            }
+          ],
+          "description": "Default for the agentic flow used by `nx migrate --run-migrations`. Equivalent to the `--agentic` flag. `false` never uses the agentic flow, `true` uses it and resolves the installed agent, and an agent id always uses that agent."
+        },
+        "validate": {
+          "type": "boolean",
+          "description": "Whether to run agent-driven validation after generator-only migrations when the agentic flow is enabled. Equivalent to the `--validate` flag. Defaults to `true` when the agentic flow is enabled."
+        }
+      },
+      "additionalProperties": false
+    },
     "conformance": {
       "type": "object",
       "description": "Configuration for Nx Conformance",