nx 23.3.0-beta.8 → 23.3.0-beta.9

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

@@ -15,6 +15,8 @@ const configuration_1 = require("../../config/configuration");
 const find_matching_projects_1 = require("../../utils/find-matching-projects");
 const graph_1 = require("../graph/graph");
 const affected_tasks_1 = require("../../project-graph/affected/affected-tasks");
+const affected_reasons_1 = require("../../project-graph/affected/affected-reasons");
+const print_explanation_1 = require("../../project-graph/affected/print-explanation");
 async function affected(command, args, extraTargetDependencies = {}, extraOptions = {
     excludeTaskDependencies: args.excludeTaskDependencies,
     loadDotEnvFiles: process.env.NX_LOAD_DOT_ENV_FILES !== 'false',
@@ -31,12 +33,19 @@ async function affected(command, args, extraTargetDependencies = {}, extraOption
     const useTasks = (0, affected_tasks_1.selectsAffectedTasks)() &&
         command === 'affected' &&
         !!nxArgs.targets?.length;
+    if ((0, affected_reasons_1.isExplaining)(nxArgs.explain) && !useTasks) {
+        throw new Error((0, affected_reasons_1.explainUnavailable)([
+            !(0, affected_tasks_1.selectsAffectedTasks)() && 'NX_LEGACY_AFFECTED=false',
+            !nxArgs.targets?.length && 'targets passed with --targets (-t)',
+        ].filter(Boolean)));
+    }
     // Outside the try so errors reach handleErrors, as they did from inside runCommand.
     let projectGraph;
     let taskSelection;
     let projects = [];
     if (useTasks) {
-        ({ projectGraph, taskSelection } = await (0, affected_tasks_1.computeAffectedTasks)({
+        let explanation;
+        ({ projectGraph, taskSelection, explanation } = await (0, affected_tasks_1.computeAffectedTasks)({
             nxJson,
             targets: nxArgs.targets,
             touchedFiles: (0, file_utils_1.calculateFileChanges)((0, command_line_utils_1.parseFiles)(nxArgs).files, nxArgs),
@@ -50,8 +59,18 @@ async function affected(command, args, extraTargetDependencies = {}, extraOption
             extraTargetDependencies,
             excludeTaskDependencies: extraOptions.excludeTaskDependencies,
             exclude: nxArgs.exclude,
+            explain: (0, affected_reasons_1.isExplaining)(nxArgs.explain),
             ...(await (0, run_command_1.runnerInputsForSelection)(nxArgs, nxJson)),
         }));
+        // --explain reports the selection rather than acting on it: someone asking
+        // why a task is affected does not also want it to run.
+        if ((0, affected_reasons_1.isExplaining)(nxArgs.explain)) {
+            (0, print_explanation_1.printAffectedExplanation)(explanation, 'Affected tasks', nxArgs.explain, {
+                verbose: args.verbose,
+            });
+            await output_1.output.drain();
+            process.exit(0);
+        }
     }
     else {
         projectGraph = await (0, project_graph_1.createProjectGraphAsync)({ exitOnError: true });

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

@@ -8,7 +8,7 @@ const shared_options_1 = require("../yargs-utils/shared-options");
 exports.yargsAffectedCommand = {
     command: 'affected',
     describe: 'Run target for affected projects. Affected projects are projects that have been changed and projects that depend on the changed projects. See https://nx.dev/ci/features/affected for more details.',
-    builder: (yargs) => (0, documentation_1.linkToNxDevAndExamples)((0, shared_options_1.withAffectedOptions)((0, shared_options_1.withTuiOptions)((0, shared_options_1.withRunOptions)((0, shared_options_1.withOutputStyleOption)((0, shared_options_1.withTargetAndConfigurationOption)((0, shared_options_1.withBatch)(yargs))))))
+    builder: (yargs) => (0, documentation_1.linkToNxDevAndExamples)((0, shared_options_1.withAffectedOptions)((0, shared_options_1.withTuiOptions)((0, shared_options_1.withRunOptions)((0, shared_options_1.withOutputStyleOption)((0, shared_options_1.withTargetAndConfigurationOption)((0, shared_options_1.withBatch)((0, shared_options_1.withExplainOption)(yargs)))))))
         .option('all', {
         type: 'boolean',
         deprecated: 'Use `nx run-many` instead',

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

@@ -83,6 +83,11 @@ async function resetHandler(args) {
     if ((cloudEnabled && all) || args.onlyCloud) {
         try {
             await resetCloudClient();
+        }
+        catch (e) {
+            errors.push('Failed to clean up the Nx Cloud client.', e.toString());
+        }
+        try {
             await removeInstalledNxCloudClient();
         }
         catch (e) {
@@ -118,10 +123,8 @@ function cleanupDaemonWorkspaceData() {
 async function resetCloudClient() {
     // Remove nx cloud marker files. This helps if the use happens to run `nx-cloud start-ci-run` or
     // similar commands on their local machine.
-    try {
-        (await (0, client_2.getCloudClient)((0, get_cloud_options_1.getCloudOptions)())).invoke('cleanup');
-    }
-    catch { }
+    // `exit` would end the process here, before reset reports its result.
+    await (await (0, client_2.getCloudClient)((0, get_cloud_options_1.getCloudOptions)())).invoke('cleanup', false);
 }
 function removeInstalledNxCloudClient() {
     return incrementalBackoff(INCREMENTAL_BACKOFF_FIRST_DELAY, INCREMENTAL_BACKOFF_MAX_DURATION, () => {

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

@@ -37,7 +37,7 @@ exports.yargsShowCommand = {
 const showProjectsCommand = {
     command: 'projects',
     describe: 'Show a list of projects in the workspace.',
-    builder: (yargs) => (0, shared_options_1.withVerbose)((0, shared_options_1.withAffectedOptions)(yargs))
+    builder: (yargs) => (0, shared_options_1.withVerbose)((0, shared_options_1.withExplainOption)((0, shared_options_1.withAffectedOptions)(yargs)))
         .option('affected', {
         type: 'boolean',
         description: 'Show only affected projects.',

package/dist/src/command-line/show/projects.js

@@ -5,6 +5,8 @@ const output_1 = require("../../utils/output");
 const nx_json_1 = require("../../config/nx-json");
 const affected_project_graph_1 = require("../../project-graph/affected/affected-project-graph");
 const affected_tasks_1 = require("../../project-graph/affected/affected-tasks");
+const print_explanation_1 = require("../../project-graph/affected/print-explanation");
+const affected_reasons_1 = require("../../project-graph/affected/affected-reasons");
 const file_utils_1 = require("../../project-graph/file-utils");
 const operators_1 = require("../../project-graph/operators");
 const project_graph_1 = require("../../project-graph/project-graph");
@@ -18,6 +20,17 @@ async function showProjectsHandler(args) {
     const { nxArgs } = (0, command_line_utils_1.splitArgsIntoNxArgsAndOverrides)(args, 'affected', {
         printWarnings: false,
     }, nxJson);
+    const explainsTasks = args.affected &&
+        (0, affected_tasks_1.selectsAffectedTasks)() &&
+        !!args.withTarget?.length &&
+        !args.projects;
+    if ((0, affected_reasons_1.isExplaining)(nxArgs.explain) && !explainsTasks) {
+        throw new Error((0, affected_reasons_1.explainUnavailable)([
+            !(0, affected_tasks_1.selectsAffectedTasks)() && 'NX_LEGACY_AFFECTED=false',
+            !args.affected && '--affected',
+            !args.withTarget?.length && 'targets passed with --withTarget (-t)',
+        ].filter(Boolean), args.projects ? ['--projects'] : []));
+    }
     // Affected touches dependencies so it needs to be processed first.
     if (args.affected) {
         const touchedFiles = await getTouchedFiles(nxArgs);
@@ -33,8 +46,17 @@ async function showProjectsHandler(args) {
                     head: nxArgs.head,
                     files: nxArgs.files,
                 },
+                explain: (0, affected_reasons_1.isExplaining)(nxArgs.explain),
                 ...(await runCommandModule().runnerInputsForSelection(nxArgs, nxJson)),
             });
+            if ((0, affected_reasons_1.isExplaining)(nxArgs.explain)) {
+                (0, print_explanation_1.printAffectedExplanation)(affectedTasks.explanation, 'Affected tasks', 
+                // show projects declares its own --json, which has no executor to
+                // pass through to.
+                args.json ? 'stdout' : nxArgs.explain, { verbose: args.verbose });
+                await output_1.output.drain();
+                return;
+            }
             const { taskGraph, initiatingTaskIds } = affectedTasks.taskSelection;
             const owning = new Set(initiatingTaskIds.map((id) => taskGraph.tasks[id].target.project));
             // The graph selection ran against: with the daemon on, the daemon's, not `graph`.

package/dist/src/command-line/yargs-utils/shared-options.d.ts

@@ -54,6 +54,10 @@ export declare function withAffectedOptions(yargs: Argv): Argv<ExcludeOptions &
 } & {
     head: string;
 }>;
+/** Only on the commands that report instead of running when it is passed. */
+export declare function withExplainOption<T>(yargs: Argv<T>): Argv<T & {
+    explain?: string | boolean;
+}>;
 export interface RunManyOptions extends RunOptions {
     projects: string[];
     /**

package/dist/src/command-line/yargs-utils/shared-options.js

@@ -9,6 +9,7 @@ exports.withConfiguration = withConfiguration;
 exports.withVerbose = withVerbose;
 exports.withBatch = withBatch;
 exports.withAffectedOptions = withAffectedOptions;
+exports.withExplainOption = withExplainOption;
 exports.withRunManyOptions = withRunManyOptions;
 exports.withOverrides = withOverrides;
 exports.withOutputStyleOption = withOutputStyleOption;
@@ -244,6 +245,21 @@ function withAffectedOptions(yargs) {
         }
     }, true);
 }
+/** Only on the commands that report instead of running when it is passed. */
+function withExplainOption(yargs) {
+    return yargs.option('explain', {
+        type: 'string',
+        describe: 'Print why each task was considered affected, instead of running anything. Needs task selection (NX_LEGACY_AFFECTED=false). Pass a file path to save the reasons as JSON instead. Pass "stdout" to print the JSON to the terminal.',
+        // Same shape as `--graph`: the value is a destination, and a bare
+        // `--explain` has to arrive as a boolean. `nx affected` leaves `--json`
+        // undeclared so it still reaches the executor.
+        coerce: (value) => value === '' || value === 'true' || value === true
+            ? true
+            : value === 'false' || value === false
+                ? false
+                : value,
+    });
+}
 function withRunManyOptions(yargs) {
     return withRunOptions(yargs)
         .parserConfiguration(exports.defaultYargsParserConfiguration)

package/dist/src/daemon/message-types/select-affected-tasks.d.ts

@@ -2,6 +2,7 @@ import type { ProjectGraph } from '../../config/project-graph';
 import type { TaskGraph } from '../../config/task-graph';
 import type { TaskSelection } from '../../tasks-runner/run-command';
 import type { AffectedTasksRequest } from '../../project-graph/affected/affected-tasks';
+import type { InternedExplanation } from '../../project-graph/affected/affected-reasons';
 export declare const SELECT_AFFECTED_TASKS: 'SELECT_AFFECTED_TASKS';
 export type HandleSelectAffectedTasksMessage = {
     type: typeof SELECT_AFFECTED_TASKS;
@@ -14,5 +15,7 @@ export type SelectAffectedTasksResponse = {
     taskGraph: TaskGraph;
     /** Without a planning context: the plans stay in the daemon. */
     taskSelection: TaskSelection;
+    /** Interned, so it stays small on the wire; the client hydrates it. */
+    explanation?: InternedExplanation;
 };
 export declare function isHandleSelectAffectedTasksMessage(message: unknown): message is HandleSelectAffectedTasksMessage;

package/dist/src/daemon/server/handle-select-affected-tasks.js

@@ -20,6 +20,7 @@ async function handleSelectAffectedTasks(request) {
         affectedTaskIds: [...selection.affectedTaskIds],
         taskGraph: selection.taskGraph,
         taskSelection: selection.taskSelection,
+        explanation: selection.explanation,
     };
     return { response, description: 'handleSelectAffectedTasks' };
 }

package/dist/src/devkit-internals.d.ts

@@ -47,6 +47,8 @@ export { getEnvFilesForTask, getGraphTimeDotEnvForTask, } from './tasks-runner/t
 export { getEnvPathsForTask } from './tasks-runner/task-env-paths';
 export { hashDaemonClientEnv, getDaemonClientEnvGeneration, getAppliedDaemonClientEnv, applyDaemonEnvFromClient, } from './daemon/client/daemon-environment';
 export { isCI } from './utils/is-ci';
+export { createCliOptions } from './utils/create-cli-options';
+export { createOverrides } from './utils/command-line-utils';
 export { isUsingPrettierInTree, prettierConfigFiles, } from './utils/formatters/prettier';
 export { detectFormatter, detectFormatterInTree } from './utils/formatters';
 export type { FormatterType } from './utils/formatters';
@@ -85,7 +87,7 @@ export { getRelativeProjectJsonSchemaPath } from './generators/utils/project-con
 export { hashFile } from './hasher/file-hasher';
 export { filterUsingGlobPatterns, getTargetInputs } from './hasher/task-hasher';
 export type { JsonInput } from './native';
-export { killProcessTreeGraceful } from './native';
+export { isAiAgent, killProcessTreeGraceful } from './native';
 export { killChildOnHostExit } from './utils/kill-child-on-host-exit';
 export { connectToNxCloud } from './nx-cloud/generators/connect-to-nx-cloud/connect-to-nx-cloud';
 export type { NxCloudOnBoardingStatus } from './nx-cloud/models/onboarding-status';

package/dist/src/devkit-internals.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getDaemonClientEnvGeneration = exports.hashDaemonClientEnv = exports.getEnvPathsForTask = exports.getGraphTimeDotEnvForTask = exports.getEnvFilesForTask = exports.interpolate = exports.requireWithTsconfigFallback = exports.isTsEsmNamedExportLinkageError = exports.isRequireInEsmScopeError = exports.forceRegisterEsmLoader = exports.loadTsFile = exports.registerTsProject = exports.LoadedNxPlugin = exports.retrieveProjectConfigurations = exports.findProjectForPath = exports.createProjectRootMappings = exports.createProjectRootMappingsFromProjectConfigurations = exports.hashMultiGlobWithWorkspaceContext = exports.hashWithWorkspaceContext = exports.hashObject = exports.splitByColons = exports.installPackageToTmpAsync = exports.installPackageToTmp = exports.readModulePackageJson = exports.stripIndent = exports.sortObjectByKeys = exports.combineOptionsForExecutor = exports.confirmationPrompt = exports.textPrompt = exports.multiselectPrompt = exports.selectPrompt = exports.splitTarget = exports.createPrettierIgnoreChecker = exports.createOxfmtIgnoreChecker = exports.createGitIgnoreChecker = exports.readTargetDefaultsForTarget = exports.createTargetDefaultsResults = exports.findMatchingProjects = exports.findMatchingConfigFiles = exports.readProjectConfigurationsFromRootMap = exports.findMatchingTargetNames = exports.resolveCommandSyntacticSugar = exports.mergeTargetConfigurations = exports.retrieveProjectConfigurationsWithAngularProjects = exports.calculateDefaultProjectName = exports.readNxJsonFromDisk = exports.parseExecutor = exports.getExecutorInformation = exports.parseVersionFromPackageManagerField = exports.createTempNpmDirectory = void 0;
-exports.createNxCloudOnboardingURL = exports.getNxCloudAppOnBoardingUrl = exports.createNxCloudOnboardingURLForWelcomeApp = exports.connectToNxCloud = exports.killChildOnHostExit = exports.killProcessTreeGraceful = exports.getTargetInputs = exports.filterUsingGlobPatterns = exports.hashFile = exports.getRelativeProjectJsonSchemaPath = exports.FsTree = exports.LARGE_BUFFER = exports.daemonClient = exports.isProjectGraphProjectNode = exports.isProjectGraphExternalNode = exports.fileDataDepType = exports.fileDataDepTarget = exports.BatchFunctionRunner = exports.getGeneratorInformation = exports.setupAiAgentsGenerator = exports.toOldFormat = exports.toNewFormat = exports.runCommandsExecutor = exports.acknowledgeBuildScripts = exports.getCatalogDependenciesFromPackageJson = exports.getCatalogManager = exports.checkFilesAreOutputs = exports.checkFilesAreInputs = exports.PromptResolutionError = exports.resolvePrompt = exports.SchemaResolutionError = exports.ImplementationResolutionError = exports.resolveSchema = exports.resolveImplementation = exports.emitPluginWorkerLog = exports.safeWriteFileCache = exports.PluginCache = exports.handleImport = exports.signalToCode = exports.globalSpinner = exports.readYamlFile = exports.oxfmtConfigFiles = exports.formatFilesWithOxfmt = exports.detectFormatterInTree = exports.detectFormatter = exports.prettierConfigFiles = exports.isUsingPrettierInTree = exports.isCI = exports.applyDaemonEnvFromClient = exports.getAppliedDaemonClientEnv = void 0;
-exports.normalizeDependencyConfigDefinition = exports.isCacheableTask = exports.getUnparsedOverrideArgs = exports.getTargetConfigurationForTask = exports.getSerializedArgsForTask = exports.getPrintableCommandArgsForTask = exports.getOutputs = exports.getExecutorNameForTask = exports.getExecutorForTask = exports.getDependencyConfigs = exports.getCustomHasher = exports.getCliPath = exports.expandWildcardTargetConfiguration = exports.expandInitiatingTasksThroughNoop = exports.expandDependencyConfigSyntaxSugar = exports.createTaskId = exports.calculateReverseDeps = exports.createRunManyDynamicOutputRenderer = exports.CompositeLifeCycle = exports.RemoteCacheV2 = exports.Cache = exports.readCachedProjectConfiguration = exports.preventRecursionInGraphConstruction = exports.handleProjectGraphError = exports.createProjectGraphAndSourceMapsAsync = exports.buildProjectGraphAndSourceMapsWithoutDaemon = exports.isNpmProject = exports.readFileMapCache = exports.readPackageJson = exports.isWholeFileChange = exports.isLockFileChange = exports.isDeletedFileChange = exports.defaultFileRead = exports.calculateFileChanges = exports.WholeFileChange = exports.TEN_MEGABYTES = exports.LockFileChange = exports.DeletedFileChange = exports.buildPackageJsonWorkspacesMatcher = exports.buildPackageJsonPatterns = exports.getGlobPatternsFromPackageManagerWorkspaces = exports.registerTsConfigPaths = exports.getWorkspacePackagesFromGraph = exports.isBuiltinModuleImport = exports.TargetProjectLocator = exports.findProjectsNpmDependencies = exports.createPackageJson = exports.getLockFileName = exports.generatePrunedDeployOutput = exports.createLockFile = void 0;
-exports.safeSpawn = exports.safeExecFileSync = exports.workspaceRootInner = exports.setWorkspaceRoot = exports.setupWorkspaceContext = exports.resetWorkspaceContext = exports.globWithWorkspaceContext = exports.getFilesInDirectoryUsingContext = exports.nxVersion = exports.SyncError = exports.quoteShellArg = exports.getSourceDirOfDependentProjects = exports.findAllProjectNodeDependencies = exports.findInstalledPlugins = exports.deriveGroupNameFromTarget = exports.warnUnshippableLocalPathSpec = exports.relocatePrunedLocalPathSpec = exports.movePeerDependencyToDependencies = exports.dropEmptyPeerDependencySections = exports.readNxMigrateConfig = exports.isNxCloudUsed = exports.getNxCloudUrl = exports.orange = exports.NX_PREFIX = exports.getNxRequirePaths = exports.isGlobPattern = exports.combineGlobPatterns = exports.getLatestCommitSha = exports.readFileIfExisting = exports.isRelativePath = exports.fileExists = exports.directoryExists = exports.createDirectory = exports.deduceDefaultBase = exports.codeFrameColumns = exports.runNxSync = exports.workspaceDataDirectory = exports.getLastValueFromAsyncIterableIterator = exports.validateOutputs = exports.unparse = exports.transformLegacyOutputs = exports.shouldStreamOutput = exports.removeTasksFromTaskGraph = exports.readProjectAndTargetFromTargetString = exports.normalizeTargetDependencyWithStringProjects = exports.normalizeDependencyConfigProjects = void 0;
+exports.connectToNxCloud = exports.killChildOnHostExit = exports.killProcessTreeGraceful = exports.isAiAgent = exports.getTargetInputs = exports.filterUsingGlobPatterns = exports.hashFile = exports.getRelativeProjectJsonSchemaPath = exports.FsTree = exports.LARGE_BUFFER = exports.daemonClient = exports.isProjectGraphProjectNode = exports.isProjectGraphExternalNode = exports.fileDataDepType = exports.fileDataDepTarget = exports.BatchFunctionRunner = exports.getGeneratorInformation = exports.setupAiAgentsGenerator = exports.toOldFormat = exports.toNewFormat = exports.runCommandsExecutor = exports.acknowledgeBuildScripts = exports.getCatalogDependenciesFromPackageJson = exports.getCatalogManager = exports.checkFilesAreOutputs = exports.checkFilesAreInputs = exports.PromptResolutionError = exports.resolvePrompt = exports.SchemaResolutionError = exports.ImplementationResolutionError = exports.resolveSchema = exports.resolveImplementation = exports.emitPluginWorkerLog = exports.safeWriteFileCache = exports.PluginCache = exports.handleImport = exports.signalToCode = exports.globalSpinner = exports.readYamlFile = exports.oxfmtConfigFiles = exports.formatFilesWithOxfmt = exports.detectFormatterInTree = exports.detectFormatter = exports.prettierConfigFiles = exports.isUsingPrettierInTree = exports.createOverrides = exports.createCliOptions = exports.isCI = exports.applyDaemonEnvFromClient = exports.getAppliedDaemonClientEnv = void 0;
+exports.getTargetConfigurationForTask = exports.getSerializedArgsForTask = exports.getPrintableCommandArgsForTask = exports.getOutputs = exports.getExecutorNameForTask = exports.getExecutorForTask = exports.getDependencyConfigs = exports.getCustomHasher = exports.getCliPath = exports.expandWildcardTargetConfiguration = exports.expandInitiatingTasksThroughNoop = exports.expandDependencyConfigSyntaxSugar = exports.createTaskId = exports.calculateReverseDeps = exports.createRunManyDynamicOutputRenderer = exports.CompositeLifeCycle = exports.RemoteCacheV2 = exports.Cache = exports.readCachedProjectConfiguration = exports.preventRecursionInGraphConstruction = exports.handleProjectGraphError = exports.createProjectGraphAndSourceMapsAsync = exports.buildProjectGraphAndSourceMapsWithoutDaemon = exports.isNpmProject = exports.readFileMapCache = exports.readPackageJson = exports.isWholeFileChange = exports.isLockFileChange = exports.isDeletedFileChange = exports.defaultFileRead = exports.calculateFileChanges = exports.WholeFileChange = exports.TEN_MEGABYTES = exports.LockFileChange = exports.DeletedFileChange = exports.buildPackageJsonWorkspacesMatcher = exports.buildPackageJsonPatterns = exports.getGlobPatternsFromPackageManagerWorkspaces = exports.registerTsConfigPaths = exports.getWorkspacePackagesFromGraph = exports.isBuiltinModuleImport = exports.TargetProjectLocator = exports.findProjectsNpmDependencies = exports.createPackageJson = exports.getLockFileName = exports.generatePrunedDeployOutput = exports.createLockFile = exports.createNxCloudOnboardingURL = exports.getNxCloudAppOnBoardingUrl = exports.createNxCloudOnboardingURLForWelcomeApp = void 0;
+exports.safeSpawn = exports.safeExecFileSync = exports.workspaceRootInner = exports.setWorkspaceRoot = exports.setupWorkspaceContext = exports.resetWorkspaceContext = exports.globWithWorkspaceContext = exports.getFilesInDirectoryUsingContext = exports.nxVersion = exports.SyncError = exports.quoteShellArg = exports.getSourceDirOfDependentProjects = exports.findAllProjectNodeDependencies = exports.findInstalledPlugins = exports.deriveGroupNameFromTarget = exports.warnUnshippableLocalPathSpec = exports.relocatePrunedLocalPathSpec = exports.movePeerDependencyToDependencies = exports.dropEmptyPeerDependencySections = exports.readNxMigrateConfig = exports.isNxCloudUsed = exports.getNxCloudUrl = exports.orange = exports.NX_PREFIX = exports.getNxRequirePaths = exports.isGlobPattern = exports.combineGlobPatterns = exports.getLatestCommitSha = exports.readFileIfExisting = exports.isRelativePath = exports.fileExists = exports.directoryExists = exports.createDirectory = exports.deduceDefaultBase = exports.codeFrameColumns = exports.runNxSync = exports.workspaceDataDirectory = exports.getLastValueFromAsyncIterableIterator = exports.validateOutputs = exports.unparse = exports.transformLegacyOutputs = exports.shouldStreamOutput = exports.removeTasksFromTaskGraph = exports.readProjectAndTargetFromTargetString = exports.normalizeTargetDependencyWithStringProjects = exports.normalizeDependencyConfigProjects = exports.normalizeDependencyConfigDefinition = exports.isCacheableTask = exports.getUnparsedOverrideArgs = void 0;
 const tslib_1 = require("tslib");
 /**
  * Note to developers: STOP! These are nx internals, not part of the public
@@ -112,6 +112,10 @@ Object.defineProperty(exports, "getAppliedDaemonClientEnv", { enumerable: true,
 Object.defineProperty(exports, "applyDaemonEnvFromClient", { enumerable: true, get: function () { return daemon_environment_1.applyDaemonEnvFromClient; } });
 var is_ci_1 = require("./utils/is-ci");
 Object.defineProperty(exports, "isCI", { enumerable: true, get: function () { return is_ci_1.isCI; } });
+var create_cli_options_1 = require("./utils/create-cli-options");
+Object.defineProperty(exports, "createCliOptions", { enumerable: true, get: function () { return create_cli_options_1.createCliOptions; } });
+var command_line_utils_1 = require("./utils/command-line-utils");
+Object.defineProperty(exports, "createOverrides", { enumerable: true, get: function () { return command_line_utils_1.createOverrides; } });
 var prettier_1 = require("./utils/formatters/prettier");
 Object.defineProperty(exports, "isUsingPrettierInTree", { enumerable: true, get: function () { return prettier_1.isUsingPrettierInTree; } });
 Object.defineProperty(exports, "prettierConfigFiles", { enumerable: true, get: function () { return prettier_1.prettierConfigFiles; } });
@@ -181,6 +185,7 @@ var task_hasher_1 = require("./hasher/task-hasher");
 Object.defineProperty(exports, "filterUsingGlobPatterns", { enumerable: true, get: function () { return task_hasher_1.filterUsingGlobPatterns; } });
 Object.defineProperty(exports, "getTargetInputs", { enumerable: true, get: function () { return task_hasher_1.getTargetInputs; } });
 var native_1 = require("./native");
+Object.defineProperty(exports, "isAiAgent", { enumerable: true, get: function () { return native_1.isAiAgent; } });
 Object.defineProperty(exports, "killProcessTreeGraceful", { enumerable: true, get: function () { return native_1.killProcessTreeGraceful; } });
 var kill_child_on_host_exit_1 = require("./utils/kill-child-on-host-exit");
 Object.defineProperty(exports, "killChildOnHostExit", { enumerable: true, get: function () { return kill_child_on_host_exit_1.killChildOnHostExit; } });

package/dist/src/hasher/hash-task.d.ts

@@ -4,7 +4,7 @@ import { Task, TaskGraph } from '../config/task-graph';
 import { type UltracacheConfigurations, TaskDetails } from '../native';
 import { TaskHasher } from './task-hasher';
 export declare function getTaskDetails(): TaskDetails | null;
-export declare function hashTasksThatDoNotDependOnOutputsOfOtherTasks(hasher: TaskHasher, projectGraph: ProjectGraph, taskGraph: TaskGraph, nxJson: NxJsonConfiguration, tasksDetails: TaskDetails | null, ultracacheConfigurations?: UltracacheConfigurations): Promise<void>;
+export declare function hashTasksThatDoNotDependOnOutputsOfOtherTasks(hasher: TaskHasher, projectGraph: ProjectGraph, taskGraph: TaskGraph, nxJson: NxJsonConfiguration, tasksDetails: TaskDetails | null, ultracacheConfigurations?: UltracacheConfigurations): Promise<Set<string>>;
 export declare function hashTask(hasher: TaskHasher, projectGraph: ProjectGraph, taskGraph: TaskGraph, task: Task, env: NodeJS.ProcessEnv, taskDetails: TaskDetails | null): Promise<void>;
 /**
  * Batch-hash `tasks`. `perTaskEnvs` must contain an entry keyed by

package/dist/src/hasher/hash-task.js

@@ -72,6 +72,7 @@ async function hashTasksThatDoNotDependOnOutputsOfOtherTasks(hasher, projectGrap
     }
     performance.mark('hashMultipleTasks:end');
     performance.measure('hashMultipleTasks', 'hashMultipleTasks:start', 'hashMultipleTasks:end');
+    return new Set(tasks.filter((t) => !(t.id in hashes)).map((t) => t.id));
 }
 function readsDependencyOutputs(task, taskGraph, projectGraph, nxJson) {
     return (taskGraph.dependencies[task.id]?.length > 0 &&

package/dist/src/native/index.d.ts

@@ -435,6 +435,29 @@ export interface AffectedOptions {
   workspaceRoot: string
 }
 
+/**
+ * Why the change reached each task. Covers every task it reached, not just
+ * the selection, so a reason naming a producer can be looked up too.
+ */
+export interface AffectedTaskExplanation {
+  /**
+   * The reached tasks the change touched directly, sorted: a matched input,
+   * or always touched. Every other reached task was carried through outputs.
+   */
+  touched: Array<string>
+  /** Consumer -> the reached producers whose outputs it reads. */
+  producersOf: Record<string, Array<string>>
+  /** Changed project configs no longer on disk. Every task was seeded for them. */
+  deletedProjectConfigs: Array<string>
+  /**
+   * What each matching plan instruction matched. Shared rather than copied
+   * per task: one lib's fileset can be in the plan of every dependent.
+   */
+  inputMatches: Array<TaskInputMatches>
+  /** Per reached task, the indexes of the matches above that its plan holds. */
+  taskInputMatches: Record<string, Array<number>>
+}
+
 export declare function affectedTasks(projectGraph: ExternalObject<ProjectGraph>, hashPlans: ExternalObject<Record<string, Array<HashInstruction>>>, taskGraph: TaskGraph, changedFiles: Array<string>, options: AffectedTasksOptions): AffectedTaskSelection
 
 export interface AffectedTaskSelection {
@@ -442,6 +465,8 @@ export interface AffectedTaskSelection {
   affected: Array<string>
   /** `affected` plus everything it depends on, sorted: what a run keeps. */
   required: Array<string>
+  /** Why the change reached each task. Only when `explain` was asked for. */
+  explanation?: AffectedTaskExplanation
 }
 
 export interface AffectedTasksOptions {
@@ -490,6 +515,8 @@ export interface AffectedTasksOptions {
    * project's tsconfig `paths` entries, rather than none.
    */
   selectivelyHashTsConfig: boolean
+  /** Whether to return why each task was reached, for `--explain`. */
+  explain: boolean
 }
 
 export interface BatchInfo {
@@ -810,6 +837,16 @@ export declare function initializeTelemetry(connection: ExternalObject<NxDbConne
  */
 export declare function initializeTelemetryWithSessionId(sessionId: string, workspaceId: string, userId: string | undefined | null, nxVersion: string, packageManagerName: string, packageManagerVersion: string | undefined | null, nodeVersion: string, osArch: string, osPlatform: string, osRelease: string, isCi: boolean, isNxCloud: boolean): void
 
+/** A changed file that reached a task, and the input pattern it reached it by. */
+export interface InputMatch {
+  file: string
+  /**
+   * The fileset that matched. Absent for an instruction with no pattern to
+   * name, such as the root tsconfig.
+   */
+  pattern?: string
+}
+
 export interface InputsInput {
   input: string
   dependencies?: boolean
@@ -1116,6 +1153,25 @@ export interface TaskHashDetails {
   runtime?: Record<string, string>
 }
 
+/**
+ * What reached one task: the files its filesets matched and the packages it
+ * hashes that moved.
+ */
+export interface TaskInputMatches {
+  files: Array<InputMatch>
+  /** External node names the plan hashes one by one that moved. */
+  packages: Array<string>
+  /** The plan hashes every external dependency, and one moved. */
+  allExternals: boolean
+  /** Changed config files of the projects whose configuration the plan hashes. */
+  projectConfigs: Array<string>
+  /**
+   * Ecosystems a change moved whole, without naming packages, that the plan
+   * hashes packages of. Reported once rather than per package.
+   */
+  movedEcosystems: Array<string>
+}
+
 /**
  * The result of a completed Task.
  *

package/dist/src/nx-cloud/utilities/client.d.ts

@@ -5,6 +5,6 @@ export declare class UnknownCommandError extends Error {
     constructor(command: string, availableCommands: string[]);
 }
 export declare function getCloudClient(options: CloudTaskRunnerOptions): Promise<{
-    invoke: (command: string, exit?: boolean) => void;
+    invoke: (command: string, exit?: boolean) => Promise<void>;
     availableCommands: string[];
 }>;

package/dist/src/nx-cloud/utilities/client.js

@@ -19,7 +19,7 @@ async function getCloudClient(options) {
     return {
         invoke: (command, exit = true) => {
             if (command in nxCloudClient.commands) {
-                nxCloudClient.commands[command]()
+                return nxCloudClient.commands[command]()
                     .then(() => {
                     if (exit) {
                         process.exit(0);

package/dist/src/plugins/js/utils/register.js

@@ -847,6 +847,13 @@ function loadTsFile(filePath, tsConfigPath) {
     if (isInvokedByTsx) {
         return require(filePath);
     }
+    // Executors and generators load in processes that never loaded a plugin
+    // (batch workers, forked tasks), so the NodeNext `.js` -> `.ts` resolvers the
+    // plugin loader installs are not there yet. Both are idempotent.
+    ensureCjsResolverPatched();
+    if (preferNodeStripTypes) {
+        ensureNodeNextEsmResolverRegistered();
+    }
     if (!preferNodeStripTypes) {
         if (!resolvedTsConfigPath) {
             throw new Error(`${logger_1.NX_PREFIX} loadTsFile could not find a workspace tsconfig while loading ${filePath} on the swc/ts-node path. Pass an explicit tsConfigPath or add a tsconfig.base.json/tsconfig.json at the workspace root.`);
@@ -859,9 +866,10 @@ function loadTsFile(filePath, tsConfigPath) {
             cleanup();
         }
     }
-    // Native strip path: no registration up front. pnpm/npm/yarn workspaces
-    // resolve aliases without tsconfig-paths. On failure, lazy-register what
-    // the specific error code indicates is needed and retry:
+    // Native strip path: no tsconfig-paths or transpiler registration up
+    // front. pnpm/npm/yarn workspaces resolve aliases without tsconfig-paths.
+    // On failure, lazy-register what the specific error code indicates is
+    // needed and retry:
     //   - MODULE_NOT_FOUND -> first try tsconfig-paths (alias resolution).
     //     If that still fails (e.g. extensionless `import './foo'` when
     //     `foo.ts` is adjacent - Node's resolver doesn't add `.ts`), escalate

package/dist/src/project-graph/affected/affected-reasons.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Why a task was considered affected.
+ *
+ * One open shape rather than a discriminated union, because the matches behind
+ * these cross the napi boundary as `#[napi(object)]` structs, which carry no
+ * tag. `kind` is the discriminant; the rest are populated per kind and absent
+ * otherwise.
+ *
+ * Reasons are collected flat: a task lists every reason that applies to it,
+ * and propagation is expressed by naming the producer rather than nesting its
+ * reasons, so the producer's own reasons are one lookup away in the same output.
+ */
+export type AffectedReasonKind = 
+/** A changed file matched one of the task's inputs. */
+'input-file'
+/** It reads the outputs of a task the change reached. */
+ | 'dependent-output'
+/** A project config the task hashes changed. */
+ | 'project-configuration'
+/** A project config no longer on disk, so every task was selected. */
+ | 'deleted-project-configuration'
+/** A package the task hashes moved, or the root package.json names its project. */
+ | 'npm-package'
+/** It hashes every external dependency, and one moved. */
+ | 'external-dependencies'
+/** A lockfile changed and `projectsAffectedByDependencyUpdates` names its project. */
+ | 'lockfile'
+/** A dependency change could not be pinned to packages, so a whole ecosystem moved. */
+ | 'moved-ecosystem'
+/** Its executor hashes outside the plan, so it is always selected. */
+ | 'custom-hasher';
+export interface AffectedReason {
+    kind: AffectedReasonKind;
+    /** The changed file responsible, when one file is. */
+    file?: string;
+    /** The input pattern that matched, when the signal came from one. */
+    pattern?: string;
+    /** The package whose version moved. */
+    package?: string;
+    /** The package ecosystem, such as `npm`, that moved whole. */
+    ecosystem?: string;
+    /** The task whose outputs this task reads. */
+    producer?: string;
+}
+/**
+ * Why `--explain` cannot run here, naming only what is missing or in the way.
+ * It explains task selection, so it needs what task selection needs.
+ */
+export declare function explainUnavailable(missing: string[], conflicting?: string[]): string;
+/** What `--explain` reports, keyed by task id. */
+export interface AffectedExplanation {
+    /** The selection, and every reason each entry is in it. */
+    affected: Record<string, AffectedReason[]>;
+    /**
+     * Tasks the change reached that are not in the selection: those a run keeps,
+     * and every producer a reason names, followed transitively, so every chain
+     * can be traced within the same output.
+     */
+    upstream: Record<string, AffectedReason[]>;
+    /**
+     * The entries of `affected` and `upstream` the change reached directly, as
+     * selection decided it; every other entry was reached only through another.
+     */
+    touched: string[];
+    /** The requested targets, and how many of their tasks selection chose among. */
+    requested?: {
+        targets: string[];
+        total: number;
+    };
+    /** The packages each changed dependency file moved, when Nx could name them. */
+    moved?: Record<string, string[]>;
+}
+/** Stands in for a task's input reasons: entries of `inputs` to merge. */
+export interface InputsReason {
+    kind: 'inputs';
+    inputs: number[];
+}
+/**
+ * An explanation as selection builds it, before `hydrateExplanation`. A lib's
+ * matched files are one `inputs` entry however many tasks reach them, so this
+ * stays small across the daemon boundary where the expanded form would not.
+ */
+export interface InternedExplanation extends Omit<AffectedExplanation, 'affected' | 'upstream'> {
+    /** The input reasons each matching plan instruction produced, sorted per kind. */
+    inputs: AffectedReason[][];
+    affected: Record<string, (AffectedReason | InputsReason)[]>;
+    upstream: Record<string, (AffectedReason | InputsReason)[]>;
+}
+/** Expands each task's `inputs` stand-in into its reasons. */
+export declare function hydrateExplanation({ inputs, affected, upstream, ...rest }: InternedExplanation): AffectedExplanation;
+/**
+ * One line of `--explain` output, without the leading bullet. `many` is set
+ * when `file` names several files.
+ */
+export declare function formatAffectedReason(reason: AffectedReason, many?: boolean): string;
+/**
+ * Renders `--explain` output: one block per entity, its reasons beneath it.
+ *
+ * It follows the chain: what the change touched, what it reached through
+ * those, and last the selection itself, so the reader's own entries stay at
+ * the bottom however long the chain grows.
+ *
+ * An entity with no reason is still listed, with a line saying so, because a
+ * blank line is indistinguishable from a bug when you are troubleshooting.
+ */
+export declare function formatAffectedExplanation({ affected, upstream, touched: touchedNames, requested, moved, }: AffectedExplanation, heading: string, { verbose, styleTask, dim, bold, }?: {
+    verbose?: boolean;
+    /** Styles a listed task id; plain unless the printer passes a style. */
+    styleTask?: (id: string, requested: boolean) => string;
+    /** Styles the secondary part of a line, such as a matched pattern. */
+    dim?: (text: string) => string;
+    /** Styles the targets you asked for where a count names them. */
+    bold?: (text: string) => string;
+}): string;
+/** Whether `--explain` was asked for at all, in any of its forms. */
+export declare function isExplaining(value: string | boolean | undefined): boolean;