@depup/nx 23.2.1-depup.7 → 23.3.0-depup.0

package/dist/src/command-line/nx-cloud/connect/connect-to-nx-cloud.js

@@ -7,7 +7,6 @@ exports.connectToNxCloudCommand = connectToNxCloudCommand;
 exports.connectExistingRepoToNxCloudPrompt = connectExistingRepoToNxCloudPrompt;
 exports.connectToNxCloudWithPrompt = connectToNxCloudWithPrompt;
 const tslib_1 = require("tslib");
-const path_1 = require("path");
 const prompt_helpers_1 = require("../../../utils/prompt-helpers");
 const output_1 = require("../../../utils/output");
 const configuration_1 = require("../../../config/configuration");
@@ -15,7 +14,6 @@ const tree_1 = require("../../../generators/tree");
 const connect_to_nx_cloud_1 = require("../../../nx-cloud/generators/connect-to-nx-cloud/connect-to-nx-cloud");
 const url_shorten_1 = require("../../../nx-cloud/utilities/url-shorten");
 const nx_cloud_utils_1 = require("../../../utils/nx-cloud-utils");
-const fileutils_1 = require("../../../utils/fileutils");
 const child_process_1 = require("../../../utils/child-process");
 const ab_testing_1 = require("../../../utils/ab-testing");
 const versions_1 = require("../../../utils/versions");
@@ -212,14 +210,6 @@ async function connectToNxCloudWithPrompt(command) {
     if (setNxCloud === 'yes') {
         useCloud = await connectToNxCloudCommand({ generateToken: false }, command);
     }
-    else if (setNxCloud === 'never') {
-        const nxJsonPath = (0, path_1.join)(workspace_root_1.workspaceRoot, 'nx.json');
-        const nxJson = (0, configuration_1.readNxJson)();
-        if (nxJson) {
-            nxJson.neverConnectToCloud = true;
-            (0, fileutils_1.writeJsonFile)(nxJsonPath, nxJson);
-        }
-    }
     await (0, ab_testing_1.recordStat)({
         command,
         nxVersion: versions_1.nxVersion,
@@ -249,7 +239,11 @@ function utmContentForCommand(command) {
 async function nxCloudPrompt(key, utmContent) {
     const { message, choices, initial, footer, hint } = ab_testing_1.messages.getPrompt(key);
     // No separate footer/hint slot, so both are folded into the message.
-    const suffix = [hint, footer && `${footer} ${(0, ab_testing_1.nxCloudHyperlink)(utmContent)}`]
+    const suffix = [
+        hint,
+        footer && `${footer} ${(0, ab_testing_1.nxCloudHyperlink)(utmContent)}`,
+        `See it in action: ${(0, ab_testing_1.nxCloudDemoHyperlink)(utmContent)}`,
+    ]
         .filter(Boolean)
         .map((t) => pc.dim(t));
     return (await (0, prompt_helpers_1.selectPrompt)({

package/dist/src/command-line/release/publish.js

@@ -181,6 +181,7 @@ async function runPublishOnProjects(args, projectGraph, nxJson, projectNames, ex
             targets: [requiredTargetName],
             projects: projectNamesWithTarget,
             file,
+            taskSelection: () => (0, run_command_1.selectTasksForProjects)(projectGraph, projectNamesWithTarget, { targets: [requiredTargetName] }, overrides, {}, extraOptions.excludeTaskDependencies),
         }, projectNamesWithTarget);
         return {};
     }
@@ -207,18 +208,20 @@ async function runPublishOnProjects(args, projectGraph, nxJson, projectNames, ex
      * NOTE: Force TUI to be disabled for now.
      */
     process.env.NX_TUI = 'false';
-    const { taskResults } = await (0, run_command_1.runCommandForTasks)(projectsWithTarget, projectGraph, { nxJson }, {
+    const publishOutputStyle = args.specifiedOutputStyle ?? 'static';
+    const publishArgs = {
         targets: [requiredTargetName],
-        // Everything this command reports — the registry, the tag, the
-        // package.json diff, the dry-run summary — is printed from inside the
-        // task, so the failures-only default would swallow all of it (under
-        // --dry-run every task succeeds by definition). An explicit
-        // --output-style still wins, since it comes in through the spread.
-        outputStyle: 'static',
         ...args,
+        // All output is printed from inside the task, so the failures-only default
+        // would hide it. Set after the spread, on all three fields: the middleware
+        // always writes `resolvedOutputStyle`.
+        outputStyle: publishOutputStyle,
+        specifiedOutputStyle: publishOutputStyle,
+        resolvedOutputStyle: publishOutputStyle,
         // It is possible for workspaces to have circular dependencies between packages and still release them to a registry
         nxIgnoreCycles: true,
-    }, overrides, null, {}, extraOptions);
+    };
+    const { taskResults } = await (0, run_command_1.runTasksForCommand)((0, run_command_1.selectTasksForProjects)(projectGraph, projectsWithTarget.map((p) => p.name), publishArgs, overrides, {}, extraOptions.excludeTaskDependencies), projectGraph, { nxJson }, publishArgs, overrides, null, {}, extraOptions);
     const endTime = Date.now();
     const publishProjectsResult = {};
     for (const taskData of Object.values(taskResults)) {

package/dist/src/command-line/release/utils/get-touched-projects-for-group.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createGetTouchedProjectsForGroup = createGetTouchedProjectsForGroup;
-const workspace_projects_1 = require("../../../project-graph/affected/locators/workspace-projects");
+const native_1 = require("../../../native");
+const transform_objects_1 = require("../../../native/transform-objects");
 const file_utils_1 = require("../../../project-graph/file-utils");
 const ignore_1 = require("../../../utils/ignore");
 const output_1 = require("../../../utils/output");
@@ -44,8 +45,7 @@ function createGetTouchedProjectsForGroup(nxArgs, projectGraph, changedFiles, fi
             touchedProjects = serializedIgnorePatternsToTouchedProjects.get(serializedIgnorePatterns);
         }
         else {
-            // We only care about directly touched projects, not implicitly affected ones etc
-            const touchedProjectsArr = await (0, workspace_projects_1.getTouchedProjects)((0, file_utils_1.calculateFileChanges)(changedFiles, nxArgs, undefined, ignore), projectGraph.nodes);
+            const touchedProjectsArr = (0, native_1.directlyTouchedProjects)((0, transform_objects_1.transformProjectGraphForLocators)(projectGraph), (0, file_utils_1.calculateFileChanges)(changedFiles, nxArgs, undefined, ignore).map((f) => f.file));
             touchedProjects = touchedProjectsArr.reduce((acc, project) => ({ ...acc, [project]: true }), {});
             serializedIgnorePatternsToTouchedProjects.set(serializedIgnorePatterns, touchedProjects);
         }

package/dist/src/command-line/release/utils/release-graph.js

@@ -437,7 +437,7 @@ class ReleaseGraph {
         if (!releaseGroup ||
             !this.projectsToVersionActions.has(projectName) ||
             !this.finalConfigsByProject.has(projectName)) {
-            throw new Error(`Cannot resolve a concrete current version for dependency project "${projectName}" because it is not configured for Nx Release. Include the project in an Nx Release group so that its current version resolver can be configured.`);
+            throw Object.assign(new Error(`Cannot resolve a concrete current version for dependency project "${projectName}" because it is not configured for Nx Release. Include the project in an Nx Release group so that its current version resolver can be configured.`), { code: 'NX_RELEASE_PROJECT_NOT_CONFIGURED' });
         }
         let currentVersion;
         try {

package/dist/src/command-line/release/utils/remote-release-clients/github.js

@@ -11,8 +11,7 @@ const output_1 = require("../../../../utils/output");
 const path_1 = require("../../../../utils/path");
 const extract_repo_slug_1 = require("./extract-repo-slug");
 const remote_release_client_1 = require("./remote-release-client");
-// Use default import with esModuleInterop
-const axios_1 = tslib_1.__importDefault(require("axios"));
+const http_client_1 = require("../../../../utils/http-client");
 exports.defaultCreateReleaseProvider = {
     provider: 'github',
     hostname: 'github.com',
@@ -117,9 +116,7 @@ class GithubRemoteReleaseClient extends remote_release_client_1.RemoteReleaseCli
                         break;
                     }
                 }
-                const { data } = await axios_1.default
-                    .get(`https://ungh.cc/users/find/${email}`)
-                    .catch(() => ({ data: { user: null } }));
+                const { data } = await (0, http_client_1.httpRequest)(`https://ungh.cc/users/find/${email}`).catch(() => ({ data: { user: null } }));
                 if (data?.user?.username) {
                     meta.username = data.user.username;
                     break;
@@ -227,14 +224,14 @@ class GithubRemoteReleaseClient extends remote_release_client_1.RemoteReleaseCli
                         `---`,
                         `Request Data:`,
                         `Repo: ${this.getRemoteRepoData()?.slug}`,
-                        `Token Header Data: ${this.tokenHeader}`,
+                        `Token Header: ${this.getRedactedTokenHeader()}`,
                         `Body: ${JSON.stringify(result.requestData)}`,
                     ],
                 });
             }
             else {
-                console.log(error);
-                console.error(`An unknown error occurred while trying to create a release on GitHub, please report this on https://github.com/nrwl/nx (NOTE: make sure to redact your GitHub token from the error message!)`);
+                console.log(this.inspectWithRedactedToken(error));
+                console.error(`An unknown error occurred while trying to create a release on GitHub, please report this on https://github.com/nrwl/nx (NOTE: your GitHub token is redacted above, but please double-check before sharing)`);
             }
         }
         const shouldContinueInGitHub = await this.promptForContinueInGitHub();

package/dist/src/command-line/release/utils/remote-release-clients/gitlab.js

@@ -143,14 +143,14 @@ class GitLabRemoteReleaseClient extends remote_release_client_1.RemoteReleaseCli
                         `---`,
                         `Request Data:`,
                         `Repo: ${this.getRemoteRepoData()?.slug}`,
-                        `Token Header Data: ${this.tokenHeader}`,
+                        `Token Header: ${this.getRedactedTokenHeader()}`,
                         `Body: ${JSON.stringify(result.requestData)}`,
                     ],
                 });
             }
             else {
-                console.log(error);
-                console.error(`An unknown error occurred while trying to create a release on GitLab, please report this on https://github.com/nrwl/nx (NOTE: make sure to redact your GitLab token from the error message!)`);
+                console.log(this.inspectWithRedactedToken(error));
+                console.error(`An unknown error occurred while trying to create a release on GitLab, please report this on https://github.com/nrwl/nx (NOTE: your GitLab token is redacted above, but please double-check before sharing)`);
             }
         }
         const shouldContinueInGitLab = await this.promptForContinueInGitLab();

package/dist/src/command-line/release/utils/remote-release-clients/remote-release-client.d.ts

@@ -1,7 +1,7 @@
-import type { AxiosRequestConfig } from 'axios';
 import type { PostGitTask } from '../../changelog';
 import { ResolvedCreateRemoteReleaseProvider } from '../../config/config';
 import type { Reference } from '../git';
+import { type HttpRequestConfig } from '../../../../utils/http-client';
 import { type ReleaseVersion } from '../shared';
 import type { GithubRemoteReleaseClient } from './github';
 import type { GitLabRemoteReleaseClient } from './gitlab';
@@ -44,6 +44,8 @@ export declare abstract class RemoteReleaseClient<RemoteRelease extends Record<s
         headerName: string;
     } | null);
     getRemoteRepoData<T extends RemoteRepoData>(): T | null;
+    protected inspectWithRedactedToken(error: unknown): string;
+    protected getRedactedTokenHeader(): string;
     /**
      * Create a post git task that will be executed by nx release changelog after performing any relevant
      * git operations, if the user has opted into remote release creation.
@@ -60,7 +62,7 @@ export declare abstract class RemoteReleaseClient<RemoteRelease extends Record<s
     /**
      * Make an (optionally authenticated) API request to the remote release provider
      */
-    protected makeRequest(url: string, opts?: AxiosRequestConfig): Promise<any>;
+    protected makeRequest(url: string, opts?: HttpRequestConfig): Promise<any>;
     createOrUpdateRelease(releaseVersion: ReleaseVersion, changelogContents: string, latestCommit: string, { dryRun }: {
         dryRun: boolean;
     }): Promise<void>;

package/dist/src/command-line/release/utils/remote-release-clients/remote-release-client.js

@@ -2,9 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RemoteReleaseClient = void 0;
 exports.createRemoteReleaseClient = createRemoteReleaseClient;
-const tslib_1 = require("tslib");
-const axios_1 = tslib_1.__importDefault(require("axios"));
+const node_util_1 = require("node:util");
 const handle_import_1 = require("../../../../utils/handle-import");
+const http_client_1 = require("../../../../utils/http-client");
 const print_changes_1 = require("../print-changes");
 const shared_1 = require("../shared");
 /**
@@ -30,6 +30,40 @@ class RemoteReleaseClient {
     getRemoteRepoData() {
         return this.remoteRepoData;
     }
+    inspectWithRedactedToken(error) {
+        const inspected = (0, node_util_1.inspect)(error);
+        // The dump can hold a different string than the raw token: fetch trims
+        // header values and inspect() escapes the result, while message/stack keep
+        // it bare. Redact every rendering; the Set collapses them for an ordinary
+        // token. The CR/LF needle is belt-and-braces - fetch rejects such headers.
+        const token = this.tokenData?.token?.trim();
+        if (!token) {
+            return inspected;
+        }
+        const needles = new Set([
+            token,
+            token.replace(/[\r\n]/g, ''),
+            (0, node_util_1.inspect)(token).slice(1, -1),
+        ]);
+        // inspect() renders a long string carrying a line break as concatenated
+        // per-line chunks, which no whole-token needle spans. Redact the lines too,
+        // skipping fragments short enough to collide with ordinary dump text.
+        for (const line of token.split(/[\r\n]+/)) {
+            if (line.length >= 8) {
+                needles.add(line);
+            }
+        }
+        return [...needles].reduce((text, needle) => text.split(needle).join('<redacted>'), inspected);
+    }
+    getRedactedTokenHeader() {
+        if (!this.tokenData) {
+            return 'none';
+        }
+        const { headerName } = this.tokenData;
+        return headerName === 'Authorization'
+            ? `${headerName}: Bearer <redacted>`
+            : `${headerName}: <redacted>`;
+    }
     /**
      * Make an (optionally authenticated) API request to the remote release provider
      */
@@ -46,7 +80,7 @@ class RemoteReleaseClient {
                 ...this.tokenHeader,
             },
         };
-        return (await (0, axios_1.default)(url, config)).data;
+        return (await (0, http_client_1.httpRequest)(url, config)).data;
     }
     async createOrUpdateRelease(releaseVersion, changelogContents, latestCommit, { dryRun }) {
         let existingRelease;

package/dist/src/command-line/release/version/version-actions.d.ts

@@ -15,6 +15,9 @@ export type SemverBumpType = ReleaseType | 'none';
  * when it is part of the release, or its current version when it is not being
  * versioned.
  *
+ * When the project is not configured for Nx Release, the returned promise
+ * rejects with an error whose `code` is `NX_RELEASE_PROJECT_NOT_CONFIGURED`.
+ *
  * @public
  */
 export type ResolveVersionForDependency = (dependencyProjectName: string) => Promise<string>;

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

@@ -12,6 +12,7 @@ const client_2 = require("../../nx-cloud/utilities/client");
 const get_cloud_options_1 = require("../../nx-cloud/utilities/get-cloud-options");
 const nx_cloud_utils_1 = require("../../utils/nx-cloud-utils");
 const configuration_1 = require("../../config/configuration");
+const db_connection_1 = require("../../utils/db-connection");
 const update_manager_1 = require("../../nx-cloud/update-manager");
 // Wait at max 5 seconds before giving up on a failing operation.
 const INCREMENTAL_BACKOFF_MAX_DURATION = 5000;
@@ -82,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) {
@@ -117,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, () => {
@@ -155,6 +159,8 @@ function cleanupNativeFileCache() {
 }
 function cleanupWorkspaceData() {
     return incrementalBackoff(INCREMENTAL_BACKOFF_FIRST_DELAY, INCREMENTAL_BACKOFF_MAX_DURATION, () => {
+        // Analytics opened the DB at startup; Windows cannot delete an open file.
+        (0, db_connection_1.removeDbConnections)();
         (0, node_fs_1.rmSync)(cache_directory_1.workspaceDataDirectory, { recursive: true, force: true });
         // Also clean wherever the DB actually lives, which is outside this
         // checkout whenever the shared root is reachable. Resolved through the

package/dist/src/command-line/run/run-one.js

@@ -37,6 +37,8 @@ async function runOne(cwd, args, extraTargetDependencies = {}, extraOptions = {
         process.exit(0);
     }
     await (0, connect_to_nx_cloud_1.connectToNxCloudIfExplicitlyAsked)(nxArgs);
+    // --graph's file output draws this selection; the live graph builds its own.
+    const selectTasks = () => (0, run_command_1.selectTasksForProjects)(projectGraph, projects.map((p) => p.name), nxArgs, overrides, extraTargetDependencies, extraOptions.excludeTaskDependencies);
     if (nxArgs.graph) {
         const projectNames = projects.map((t) => t.name);
         const file = (0, command_line_utils_1.readGraphFileFromGraphArg)(nxArgs);
@@ -47,10 +49,12 @@ async function runOne(cwd, args, extraTargetDependencies = {}, extraOptions = {
             targets: nxArgs.targets,
             projects: projectNames,
             file,
+            taskSelection: selectTasks,
+            configuration: nxArgs.configuration,
         }, projectNames);
     }
     else {
-        const status = await (0, run_command_1.runCommand)(projects, projectGraph, { nxJson }, nxArgs, overrides, projectName, extraTargetDependencies, extraOptions);
+        const status = await (0, run_command_1.runCommand)(selectTasks(), projectGraph, { nxJson }, nxArgs, overrides, projectName, extraTargetDependencies, extraOptions);
         await output_1.output.drain();
         process.exit(status);
     }

package/dist/src/command-line/run-many/run-many.js

@@ -26,6 +26,8 @@ async function runMany(args, extraTargetDependencies = {}, extraOptions = {
     await (0, connect_to_nx_cloud_1.connectToNxCloudIfExplicitlyAsked)(nxArgs);
     const projectGraph = await (0, project_graph_1.createProjectGraphAsync)({ exitOnError: true });
     const projects = projectsToRun(nxArgs, projectGraph);
+    // --graph's file output draws this selection; the live graph builds its own.
+    const selectTasks = () => (0, run_command_1.selectTasksForProjects)(projectGraph, projects.map((p) => p.name), nxArgs, overrides, extraTargetDependencies, extraOptions.excludeTaskDependencies);
     if (nxArgs.graph) {
         const file = (0, command_line_utils_1.readGraphFileFromGraphArg)(nxArgs);
         const projectNames = projects.map((t) => t.name);
@@ -37,17 +39,19 @@ async function runMany(args, extraTargetDependencies = {}, extraOptions = {
             targets: nxArgs.targets,
             projects: projectNames,
             file,
+            taskSelection: selectTasks,
+            configuration: nxArgs.configuration,
         }, projectNames);
     }
     else {
-        const status = await (0, run_command_1.runCommand)(projects, projectGraph, { nxJson }, nxArgs, overrides, null, extraTargetDependencies, extraOptions);
+        const status = await (0, run_command_1.runCommand)(selectTasks(), projectGraph, { nxJson }, nxArgs, overrides, null, extraTargetDependencies, extraOptions);
         await output_1.output.drain();
         process.exit(status);
     }
 }
 function projectsToRun(nxArgs, projectGraph) {
     const selectedProjects = {};
-    const validProjects = runnableForTarget(projectGraph.nodes, nxArgs.targets);
+    const validProjects = (0, project_graph_utils_1.runnableForTarget)(projectGraph.nodes, nxArgs.targets);
     const invalidProjects = [];
     // --all is default now, if --projects is provided, it'll override the --all
     if (nxArgs.all && nxArgs.projects.length === 0) {
@@ -78,13 +82,3 @@ function projectsToRun(nxArgs, projectGraph) {
     }
     return Object.values(selectedProjects);
 }
-function runnableForTarget(projects, targets) {
-    const runnable = new Set();
-    for (let projectName in projects) {
-        const project = projects[projectName];
-        if (targets.find((target) => (0, project_graph_utils_1.projectHasTarget)(project, target))) {
-            runnable.add(projectName);
-        }
-    }
-    return runnable;
-}

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

@@ -4,6 +4,9 @@ exports.showProjectsHandler = showProjectsHandler;
 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");
@@ -17,10 +20,54 @@ 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);
-        graph = await getAffectedGraph(touchedFiles, nxJson, graph);
+        // With a target, list projects owning an affected task for it, matching `affected -t`.
+        if ((0, affected_tasks_1.selectsAffectedTasks)() && args.withTarget?.length && !args.projects) {
+            const affectedTasks = await (0, affected_tasks_1.computeAffectedTasks)({
+                projectGraph: graph,
+                nxJson,
+                targets: args.withTarget,
+                touchedFiles,
+                fileChangeArgs: {
+                    base: nxArgs.base,
+                    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`.
+            graph = {
+                ...affectedTasks.projectGraph,
+                nodes: Object.fromEntries(Object.entries(affectedTasks.projectGraph.nodes).filter(([name]) => owning.has(name))),
+            };
+        }
+        else {
+            graph = await getAffectedGraph(touchedFiles, nxJson, graph);
+        }
     }
     const filter = (0, operators_1.filterNodes)((node) => {
         if (args.type && node.type !== args.type) {
@@ -78,3 +125,7 @@ function getAffectedGraph(touchedFiles, nxJson, graph) {
 async function getTouchedFiles(nxArgs) {
     return (0, file_utils_1.calculateFileChanges)((0, command_line_utils_1.parseFiles)(nxArgs).files, nxArgs);
 }
+/** Loaded only when task selection needs it. */
+function runCommandModule() {
+    return require('../../tasks-runner/run-command');
+}

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[];
     /**
@@ -67,7 +71,7 @@ export declare function withOverrides<T extends {
 }>(args: T, commandLevel?: number): T & {
     __overrides_unparsed__: string[];
 };
-declare const allOutputStyles: readonly ['tui', 'dynamic', 'dynamic-legacy', 'static', 'static-failures-only', 'stream', 'stream-without-prefixes'];
+declare const allOutputStyles: readonly ['tui', 'dynamic', 'dynamic-legacy', 'static', 'static-failures-only', 'summary', 'stream', 'stream-without-prefixes'];
 export type OutputStyle = (typeof allOutputStyles)[number];
 export declare function withOutputStyleOption<T>(yargs: Argv<T>, choices?: ReadonlyArray<OutputStyle>): Argv<T & {
     outputStyle: OutputStyle;

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;
@@ -17,6 +18,7 @@ exports.parseNewlines = parseNewlines;
 exports.parseCSV = parseCSV;
 exports.readParallelFromArgsAndEnv = readParallelFromArgsAndEnv;
 const nx_json_1 = require("../../config/nx-json");
+const native_1 = require("../../native");
 const is_tui_enabled_1 = require("../../tasks-runner/is-tui-enabled");
 const node_os_1 = require("node:os");
 exports.defaultYargsParserConfiguration = {
@@ -243,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)
@@ -273,6 +290,7 @@ const allOutputStyles = [
     'dynamic-legacy',
     'static',
     'static-failures-only',
+    'summary',
     'stream',
     'stream-without-prefixes',
 ];
@@ -282,12 +300,13 @@ function withOutputStyleOption(yargs, choices = [
     'tui',
     'static',
     'static-failures-only',
+    'summary',
     'stream',
     'stream-without-prefixes',
 ]) {
     return yargs
         .option('outputStyle', {
-        describe: `Defines how Nx emits outputs tasks logs. **tui**: enables the Nx Terminal UI, recommended for local development environments. **dynamic-legacy**: use dynamic-legacy output life cycle, previous content is overwritten or modified as new outputs are added, display minimal logs by default, always show errors. This output format is recommended for local development environments where tui is not supported. **static**: uses static output life cycle, no previous content is rewritten or modified as new outputs are added, and every task prints its full output regardless of status. **static-failures-only**: same as **static**, but successful and cached tasks collapse to a single line, so only failing tasks (and, for a single-project run, the project you asked for) print their full output. This is what Nx uses by default in CI and other non-interactive environments. **stream**: nx by default logs output to an internal output stream, enable this option to stream logs to stdout / stderr. **stream-without-prefixes**: nx prefixes the project name the target is running on, use this option remove the project name prefix from output.`,
+        describe: `Defines how Nx emits outputs tasks logs. **tui**: enables the Nx Terminal UI, recommended for local development environments. **dynamic-legacy**: use dynamic-legacy output life cycle, previous content is overwritten or modified as new outputs are added, display minimal logs by default, always show errors. This output format is recommended for local development environments where tui is not supported. **static**: uses static output life cycle, no previous content is rewritten or modified as new outputs are added, and every task prints its full output regardless of status. **static-failures-only**: same as **static**, but successful and cached tasks collapse to a single line, so only failing tasks (and, for a single-project run, the project you asked for) print their full output. This is what Nx uses by default in CI and other non-interactive environments. **summary**: prints only run counts and one line per failing task, naming the file on disk that holds its full output. No task output is printed inline, so the size of a run's output does not depend on how much its tasks logged. This is the default when Nx detects it is being driven by an AI agent. **stream**: nx by default logs output to an internal output stream, enable this option to stream logs to stdout / stderr. **stream-without-prefixes**: nx prefixes the project name the target is running on, use this option remove the project name prefix from output.`,
         type: 'string',
         choices,
     })
@@ -298,16 +317,31 @@ function withOutputStyleOption(yargs, choices = [
                 choices.includes(process.env.NX_DEFAULT_OUTPUT_STYLE)) {
                 args.outputStyle = process.env.NX_DEFAULT_OUTPUT_STYLE;
             }
+            // Everything above this line is the user naming a style; everything
+            // below infers one. Splitting them here is what lets the rest of the
+            // codebase ask either question without re-deriving it from a single
+            // overloaded field.
+            args.specifiedOutputStyle = args.outputStyle;
         },
         (args) => {
+            // Resolution, in precedence order. `shouldUseTui` reads
+            // `specifiedOutputStyle`, so it sees only what the user named and is
+            // not fed a value inferred here - which is what used to make this
+            // ordering circular. It also reads `NX_TUI` before its own agent check,
+            // so an explicit opt-in beats the agent default without needing a
+            // special case: agent detection is ambient (`REPL_ID` is exported into
+            // a human's shell), and a human asking for a renderer outranks it.
             const useTui = (0, is_tui_enabled_1.shouldUseTui)((0, nx_json_1.readNxJson)(), args);
+            process.env.NX_TUI = useTui.toString();
+            const resolved = args.outputStyle ??
+                (useTui ? 'tui' : (0, native_1.isAiAgent)() ? 'summary' : 'static-failures-only');
+            args.resolvedOutputStyle = resolved;
+            // `outputStyle` stays what yargs parsed, except for the TUI, whose
+            // `check` runs after kebab-case normalization and needs both spellings.
             if (useTui) {
-                // We have to set both of these because `check` runs after the normalization that
-                // handles the kebab-case'd args -> camelCase'd args translation.
                 args['output-style'] = 'tui';
                 args.outputStyle = 'tui';
             }
-            process.env.NX_TUI = useTui.toString();
         },
     ]);
 }

package/dist/src/config/task-graph.d.ts

@@ -3,4 +3,4 @@
  * `packages/nx/src/native/tasks/types.rs` and exposed to TypeScript via NAPI.
  * This file re-exports them so existing imports keep working.
  */
-export type { Task, TaskGraph, TaskTarget, TaskHashDetails } from '../native';
+export type { Task, TaskGraph, TaskTarget, TaskHashDetails, TaskUltracacheSettings, } from '../native';

package/dist/src/config/workspace-json-project-json.d.ts

@@ -1,4 +1,4 @@
-import type { JsonInput } from '../native';
+import type { JsonInput, TaskUltracacheSettings } from '../native';
 import type { PackageJson } from '../utils/package-json';
 import type { NxJsonConfiguration, NxReleaseDockerConfiguration, NxReleaseVersionConfiguration } from './nx-json';
 /**
@@ -147,6 +147,22 @@ export interface TargetMetadata {
         };
     };
 }
+/**
+ * Authoring form of a property merged key-by-key: permits the `'...'` spread
+ * token alongside the resolved keys. Merging resolves the token, so it never
+ * appears on the resolved shape.
+ */
+export type Spreadable<T> = T & {
+    '...'?: true;
+};
+/**
+ * Ultracache settings for a target's tasks.
+ *
+ * The resolved shape rides on each Task instance (`Task['ultracache']`), which
+ * is why it is shared with the native task definition. Authoring additionally
+ * permits `'...'`, which target merging resolves away.
+ */
+export type TargetUltracacheSettings = Spreadable<TaskUltracacheSettings>;
 export interface TargetDependencyConfig {
     /**
      * A list of projects that have `target`.
@@ -182,9 +198,11 @@ export type InputDefinition = {
     input: string;
 } | {
     fileset: string;
+    includeIgnored?: boolean;
 } | {
     fileset: string;
     dependencies: true;
+    includeIgnored?: boolean;
 } | {
     runtime: string;
 } | {
@@ -242,6 +260,10 @@ export interface TargetConfiguration<T = any> {
      * Determines if Nx is able to cache a given target.
      */
     cache?: boolean;
+    /**
+     * Configures ultracache for tasks of this target. Nx Cloud only.
+     */
+    ultracache?: TargetUltracacheSettings;
     /**
      * Metadata about the target
      */