@ohos-ports/nx 23.2.1-beta.0 → 23.3.0-beta.0

package/dist/src/tasks-runner/run-command.js

@@ -0,0 +1,971 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.selectTasksForProjects = selectTasksForProjects;
+exports.runCommand = runCommand;
+exports.runTasksForCommand = runTasksForCommand;
+exports.setEnvVarsBasedOnArgs = setEnvVarsBasedOnArgs;
+exports.invokeTasksRunner = invokeTasksRunner;
+exports.constructLifeCycles = constructLifeCycles;
+exports.runnerInputsForSelection = runnerInputsForSelection;
+exports.getRunner = getRunner;
+exports.getRunnerOptions = getRunnerOptions;
+const tslib_1 = require("tslib");
+const prompt_helpers_1 = require("../utils/prompt-helpers");
+const node_util_1 = require("node:util");
+const nx_json_1 = require("../config/nx-json");
+const client_1 = require("../daemon/client/client");
+const spinner_1 = require("../utils/spinner");
+const create_task_hasher_1 = require("../hasher/create-task-hasher");
+const hash_task_1 = require("../hasher/hash-task");
+const native_1 = require("../native");
+const tasks_execution_hooks_1 = require("../project-graph/plugins/tasks-execution-hooks");
+const project_graph_1 = require("../project-graph/project-graph");
+const handle_errors_1 = require("../utils/handle-errors");
+const is_ci_1 = require("../utils/is-ci");
+const nx_cloud_utils_1 = require("../utils/nx-cloud-utils");
+const update_manager_1 = require("../nx-cloud/update-manager");
+const logger_1 = require("../utils/logger");
+const overrides_1 = require("../ultracache/overrides");
+const report_1 = require("../ultracache/report");
+const store_1 = require("../ultracache/store");
+const nx_key_1 = require("../utils/nx-key");
+const output_1 = require("../utils/output");
+const configure_ai_agents_disclaimer_1 = require("../ai/configure-ai-agents-disclaimer");
+const sync_generators_1 = require("../utils/sync-generators");
+const workspace_root_1 = require("../utils/workspace-root");
+const create_task_graph_1 = require("./create-task-graph");
+const is_tui_enabled_1 = require("./is-tui-enabled");
+const life_cycle_1 = require("./life-cycle");
+const dynamic_run_many_terminal_output_life_cycle_1 = require("./life-cycles/dynamic-run-many-terminal-output-life-cycle");
+const dynamic_run_one_terminal_output_life_cycle_1 = require("./life-cycles/dynamic-run-one-terminal-output-life-cycle");
+const static_run_many_terminal_output_life_cycle_1 = require("./life-cycles/static-run-many-terminal-output-life-cycle");
+const static_run_one_terminal_output_life_cycle_1 = require("./life-cycles/static-run-one-terminal-output-life-cycle");
+const summary_terminal_output_life_cycle_1 = require("./life-cycles/summary-terminal-output-life-cycle");
+const store_run_information_life_cycle_1 = require("./life-cycles/store-run-information-life-cycle");
+const task_history_life_cycle_1 = require("./life-cycles/task-history-life-cycle");
+const task_profiling_life_cycle_1 = require("./life-cycles/task-profiling-life-cycle");
+const performance_life_cycle_1 = require("./life-cycles/performance-life-cycle");
+const performance_report_1 = require("./life-cycles/performance-report");
+const task_results_life_cycle_1 = require("./life-cycles/task-results-life-cycle");
+const task_telemetry_life_cycle_1 = require("./life-cycles/task-telemetry-life-cycle");
+const task_timings_life_cycle_1 = require("./life-cycles/task-timings-life-cycle");
+const tui_summary_life_cycle_1 = require("./life-cycles/tui-summary-life-cycle");
+const task_graph_utils_1 = require("./task-graph-utils");
+const utils_1 = require("./utils");
+const exit_codes_1 = require("../utils/exit-codes");
+const handle_import_1 = require("../utils/handle-import");
+const pc = tslib_1.__importStar(require("picocolors"));
+const originalStdoutWrite = process.stdout.write.bind(process.stdout);
+const originalStderrWrite = process.stderr.write.bind(process.stderr);
+const originalConsoleLog = console.log.bind(console);
+const originalConsoleError = console.error.bind(console);
+// Only used in the non-TTY error path. In non-TTY the function `process.exit(1)`s
+// before the `applyChanges` branch can auto-sync, so the auto-sync bullet keeps
+// the "interactive environments" qualifier to avoid suggesting a config change
+// that won't help in CI/agent contexts.
+const SYNC_FIX_MESSAGE_LINES = [
+    'To sync the workspace:',
+    '- Run `nx sync` (no flags) to sync now.',
+    '- Run `nx sync:check` to preview the changes without modifying any files.',
+    '- Set `sync.applyChanges` to `true` in your `nx.json` to sync automatically when running tasks in interactive environments.',
+    '',
+    'For more information, refer to the docs: https://nx.dev/concepts/sync-generators',
+];
+const APPLY_CHANGES_FALSE_FIX_MESSAGE_LINES = [
+    'Your workspace is set to not sync automatically (`sync.applyChanges` is `false` in your `nx.json`).',
+    'Run `nx sync` (no flags) to sync now, or set `sync.applyChanges` to `true` to sync automatically before each task run.',
+];
+const SYNC_SKIPPED_FIX_MESSAGE_LINES = [
+    'This could lead to unexpected results or errors when running tasks.',
+    '',
+    'Run `nx sync` (no flags) later to sync the workspace.',
+];
+async function getTerminalOutputLifeCycle(initiatingProject, initiatingTasks, projectNames, tasks, taskGraph, nxArgs, nxJson, overrides) {
+    const overridesWithoutHidden = { ...overrides };
+    delete overridesWithoutHidden['__overrides_unparsed__'];
+    const isRunOne = initiatingProject != null;
+    if (tasks.length === 1 && !is_tui_enabled_1.ORIGINAL_TUI_ENV_VALUE) {
+        process.env.NX_TUI = 'false';
+    }
+    // Kick off in the background so the URL is ready by the exit report. A brief
+    // sync preamble (git remote lookup) runs here; the network call does not.
+    (0, performance_report_1.prefetchRemoteCacheOnboardingUrl)(nxJson);
+    if ((0, is_tui_enabled_1.isTuiEnabled)()) {
+        const interceptedNxCloudLogs = [];
+        // Resolve where the Nx Cloud client bundle actually loads from so the
+        // stack-trace check below matches its frames. It is essentially never
+        // `{workspaceRoot}/.nx/cache/cloud`: the cache normally lives in the shared
+        // per-user `~/.nx/<hash>/cache`, and it can also be relocated via
+        // NX_CACHE_DIRECTORY, a custom `cacheDirectory` in nx.json, or the lerna
+        // `node_modules/.cache` location. Using the client's own resolver keeps the
+        // interception working in all of those cases.
+        const nxCloudClientDir = (0, update_manager_1.getBundleInstallDefaultLocation)();
+        const createPatchedConsoleMethod = (originalMethod) => {
+            return (...args) => {
+                // Check if the log came from the Nx Cloud client, otherwise invoke the original write method
+                const stackTrace = new Error().stack;
+                const isNxCloudLog = stackTrace.includes(nxCloudClientDir);
+                if (!isNxCloudLog) {
+                    return originalMethod(...args);
+                }
+                // No-op the Nx Cloud client logs
+            };
+        };
+        // The cloud client calls console.log when NX_VERBOSE_LOGGING is set to true
+        console.log = createPatchedConsoleMethod(originalConsoleLog);
+        console.error = createPatchedConsoleMethod(originalConsoleError);
+        const patchedWrite = (_chunk, _encoding, callback) => {
+            // Preserve original behavior around callback and return value, just in case
+            if (callback) {
+                callback();
+            }
+            return true;
+        };
+        process.stdout.write = patchedWrite;
+        process.stderr.write = patchedWrite;
+        const { AppLifeCycle, restoreTerminal } = await (0, handle_import_1.handleImport)('../native/index.js', __dirname);
+        let appLifeCycle;
+        const isRunOne = initiatingProject != null;
+        const pinnedTasks = [];
+        let titleText = '';
+        if (isRunOne) {
+            const mainTaskId = initiatingTasks[0].id;
+            pinnedTasks.push(mainTaskId);
+            const mainContinuousDependencies = taskGraph.continuousDependencies[mainTaskId];
+            if (mainContinuousDependencies.length > 0) {
+                pinnedTasks.push(mainContinuousDependencies[0]);
+            }
+            const [, target] = mainTaskId.split(':');
+            titleText = `1 ${target} task`;
+            if (tasks.length > 1) {
+                const dependentTasksCount = tasks.length - 1;
+                const dependentTaskText = dependentTasksCount === 1 ? 'other' : 'others';
+                titleText += `, and ${dependentTasksCount} ${dependentTaskText} they depend on`;
+            }
+        }
+        else {
+            const mainTasksCount = projectNames.length;
+            const targetText = nxArgs.targets.join(', ');
+            const mainTaskText = mainTasksCount === 1 ? 'task' : 'tasks';
+            titleText = `${mainTasksCount} ${targetText} ${mainTaskText}`;
+            if (tasks.length > projectNames.length) {
+                const dependentTasksCount = tasks.length - projectNames.length;
+                const dependentTaskText = dependentTasksCount === 1 ? 'other' : 'others';
+                titleText += `, and ${dependentTasksCount} ${dependentTaskText} they depend on`;
+            }
+        }
+        let resolveRenderIsDonePromise;
+        // Default renderIsDone that will be overridden if the TUI is used
+        let renderIsDone = new Promise((resolve) => (resolveRenderIsDonePromise = resolve));
+        const { lifeCycle: tsLifeCycle, printSummary } = (0, tui_summary_life_cycle_1.getTuiTerminalSummaryLifeCycle)({
+            projectNames,
+            tasks,
+            taskGraph,
+            args: nxArgs,
+            overrides: overridesWithoutHidden,
+            initiatingProject,
+            initiatingTasks,
+            resolveRenderIsDonePromise,
+        });
+        if (tasks.length === 0) {
+            renderIsDone = renderIsDone.then(() => {
+                // Revert the patched methods
+                process.stdout.write = originalStdoutWrite;
+                process.stderr.write = originalStderrWrite;
+                console.log = originalConsoleLog;
+                console.error = originalConsoleError;
+            });
+        }
+        const lifeCycles = [tsLifeCycle];
+        // Only run the TUI if there are tasks to run
+        if (tasks.length > 0) {
+            appLifeCycle = new AppLifeCycle(tasks, initiatingTasks.map((t) => t.id), isRunOne ? 0 /* RunMode.RunOne */ : 1 /* RunMode.RunMany */, pinnedTasks, nxArgs ?? {}, nxJson.tui ?? {}, titleText, workspace_root_1.workspaceRoot, taskGraph, (0, nx_cloud_utils_1.isNxCloudUsed)(nxJson));
+            // The native endCommand renders the perf report in the exit popup; the runner
+            // sources the payload and CompositeLifeCycle forwards it here.
+            lifeCycles.unshift(appLifeCycle);
+            /**
+             * Patch stdout.write and stderr.write methods to pass Nx Cloud client logs to the TUI via the lifecycle
+             */
+            const createPatchedLogWrite = (originalWrite, isError) => {
+                // @ts-ignore
+                return (chunk, encoding, callback) => {
+                    if (isError) {
+                        (0, native_1.logDebug)(Buffer.isBuffer(chunk)
+                            ? chunk.toString(encoding)
+                            : chunk.toString());
+                    }
+                    else {
+                        (0, native_1.logDebug)(Buffer.isBuffer(chunk)
+                            ? chunk.toString(encoding)
+                            : chunk.toString());
+                    }
+                    // Check if the log came from the Nx Cloud client, otherwise invoke the original write method
+                    const stackTrace = new Error().stack;
+                    const isNxCloudLog = stackTrace.includes(nxCloudClientDir);
+                    if (isNxCloudLog) {
+                        interceptedNxCloudLogs.push(chunk);
+                        // Do not bother to store logs with only whitespace characters, they aren't relevant for the TUI
+                        const trimmedChunk = chunk.toString().trim();
+                        if (trimmedChunk.length) {
+                            // Remove ANSI escape codes, the TUI will control the formatting
+                            // NOTE: this shows any message from the Nx Cloud client, including errors
+                            appLifeCycle?.__setCloudMessage((0, node_util_1.stripVTControlCharacters)(trimmedChunk));
+                        }
+                    }
+                    // Preserve original behavior around callback and return value, just in case
+                    if (callback) {
+                        callback();
+                    }
+                    return true;
+                };
+            };
+            const createPatchedConsoleMethod = (originalMethod) => {
+                return (...args) => {
+                    // Check if the log came from the Nx Cloud client, otherwise invoke the original write method
+                    const stackTrace = new Error().stack;
+                    const isNxCloudLog = stackTrace.includes(nxCloudClientDir);
+                    if (!isNxCloudLog) {
+                        return originalMethod(...args);
+                    }
+                    // No-op the Nx Cloud client logs
+                };
+            };
+            process.stdout.write = createPatchedLogWrite(originalStdoutWrite, false);
+            process.stderr.write = createPatchedLogWrite(originalStderrWrite, true);
+            // The cloud client calls console.log when NX_VERBOSE_LOGGING is set to true
+            console.log = createPatchedConsoleMethod(originalConsoleLog);
+            console.error = createPatchedConsoleMethod(originalConsoleError);
+            globalThis.tuiOnProcessExit = () => {
+                restoreTerminal();
+                // Revert the patched methods
+                process.stdout.write = originalStdoutWrite;
+                process.stderr.write = originalStderrWrite;
+                console.log = originalConsoleLog;
+                console.error = originalConsoleError;
+                process.stdout.write('\n');
+                // Print the intercepted Nx Cloud logs
+                for (const log of interceptedNxCloudLogs) {
+                    const logString = log.toString().trimStart();
+                    process.stdout.write(logString);
+                    if (logString) {
+                        process.stdout.write('\n');
+                    }
+                }
+            };
+            renderIsDone = new Promise((resolve) => {
+                appLifeCycle.__init(() => {
+                    resolve();
+                });
+            });
+        }
+        return {
+            lifeCycle: new life_cycle_1.CompositeLifeCycle(lifeCycles),
+            restoreTerminal: () => {
+                process.stdout.write = originalStdoutWrite;
+                process.stderr.write = originalStderrWrite;
+                console.log = originalConsoleLog;
+                console.error = originalConsoleError;
+                restoreTerminal();
+            },
+            printSummary: () => printSummary(),
+            renderIsDone,
+        };
+    }
+    if (nxArgs.resolvedOutputStyle === 'summary') {
+        return {
+            lifeCycle: new summary_terminal_output_life_cycle_1.SummaryTerminalOutputLifeCycle(tasks),
+            renderIsDone: Promise.resolve(),
+        };
+    }
+    const { runnerOptions } = getRunner(nxArgs, nxJson);
+    const useDynamicOutput = shouldUseDynamicLifeCycle(tasks, runnerOptions, nxArgs.specifiedOutputStyle);
+    if (isRunOne) {
+        if (useDynamicOutput) {
+            return await (0, dynamic_run_one_terminal_output_life_cycle_1.createRunOneDynamicOutputRenderer)({
+                initiatingProject,
+                tasks,
+                args: nxArgs,
+                overrides: overridesWithoutHidden,
+            });
+        }
+        return {
+            lifeCycle: new static_run_one_terminal_output_life_cycle_1.StaticRunOneTerminalOutputLifeCycle(initiatingProject, projectNames, tasks, nxArgs),
+            renderIsDone: Promise.resolve(),
+        };
+    }
+    else {
+        if (useDynamicOutput) {
+            return await (0, dynamic_run_many_terminal_output_life_cycle_1.createRunManyDynamicOutputRenderer)({
+                projectNames,
+                tasks,
+                args: nxArgs,
+                overrides: overridesWithoutHidden,
+            });
+        }
+        else {
+            return {
+                lifeCycle: new static_run_many_terminal_output_life_cycle_1.StaticRunManyTerminalOutputLifeCycle(projectNames, tasks, nxArgs, overridesWithoutHidden),
+                renderIsDone: Promise.resolve(),
+            };
+        }
+    }
+}
+/**
+ * `targets` on whole projects, as `run-many` runs them: every task of the
+ * projects' targets and what they depend on, with those tasks initiating.
+ */
+function selectTasksForProjects(projectGraph, projectNames, nxArgs, overrides, extraTargetDependencies, excludeTaskDependencies) {
+    const taskGraph = (0, create_task_graph_1.createTaskGraph)(projectGraph, extraTargetDependencies, projectNames, nxArgs.targets, nxArgs.configuration, overrides, excludeTaskDependencies);
+    const projects = new Set(projectNames);
+    return {
+        taskGraph,
+        initiatingTaskIds: Object.values(taskGraph.tasks)
+            .filter((t) => projects.has(t.target.project) &&
+            nxArgs.targets.includes(t.target.target))
+            .map((t) => t.id),
+    };
+}
+function runValidations(projectGraph, taskGraph, nxArgs) {
+    (0, task_graph_utils_1.assertTaskGraphDoesNotContainInvalidTargets)(taskGraph);
+    const cycle = (0, task_graph_utils_1.findCycle)(taskGraph);
+    if (cycle) {
+        if (process.env.NX_IGNORE_CYCLES === 'true' || nxArgs.nxIgnoreCycles) {
+            output_1.output.warn({
+                title: `The task graph has a circular dependency`,
+                bodyLines: [`${cycle.join(' --> ')}`],
+            });
+            (0, task_graph_utils_1.makeAcyclic)(taskGraph);
+        }
+        else {
+            output_1.output.error({
+                title: `Could not execute command because the task graph has a circular dependency`,
+                bodyLines: [`${cycle.join(' --> ')}`],
+            });
+            process.exit(1);
+        }
+    }
+    // validate that no atomized tasks like e2e-ci are used without Nx Cloud
+    if (!(0, nx_cloud_utils_1.isNxCloudUsed)((0, nx_json_1.readNxJson)()) &&
+        !process.env['NX_SKIP_ATOMIZER_VALIDATION']) {
+        (0, task_graph_utils_1.validateNoAtomizedTasks)(taskGraph, projectGraph);
+    }
+    return taskGraph;
+}
+async function runCommand(taskSelection, currentProjectGraph, { nxJson }, nxArgs, overrides, initiatingProject, extraTargetDependencies, extraOptions) {
+    const status = await (0, handle_errors_1.handleErrors)(process.env.NX_VERBOSE_LOGGING === 'true', async () => {
+        const id = (0, native_1.hashArray)([...process.argv, Date.now().toString()]);
+        await (0, tasks_execution_hooks_1.runPreTasksExecution)({
+            id,
+            workspaceRoot: workspace_root_1.workspaceRoot,
+            nxJsonConfiguration: nxJson,
+            argv: process.argv,
+        });
+        const startTime = Date.now();
+        const { taskResults, completed } = await runTasksForCommand(taskSelection, currentProjectGraph, { nxJson }, {
+            ...nxArgs,
+            skipNxCache: nxArgs.skipNxCache ||
+                process.env.NX_SKIP_NX_CACHE === 'true' ||
+                process.env.NX_DISABLE_NX_CACHE === 'true',
+        }, overrides, initiatingProject, extraTargetDependencies, extraOptions);
+        const endTime = Date.now();
+        const exitCode = !completed
+            ? (0, exit_codes_1.signalToCode)('SIGINT')
+            : Object.values(taskResults).some((taskResult) => taskResult.status === 'failure' ||
+                taskResult.status === 'skipped')
+                ? 1
+                : 0;
+        await (0, tasks_execution_hooks_1.runPostTasksExecution)({
+            id,
+            taskResults,
+            workspaceRoot: workspace_root_1.workspaceRoot,
+            nxJsonConfiguration: nxJson,
+            argv: process.argv,
+            startTime,
+            endTime,
+        });
+        return exitCode;
+    });
+    return status;
+}
+async function runTasksForCommand(taskSelection, currentProjectGraph, { nxJson }, nxArgs, overrides, initiatingProject, extraTargetDependencies, extraOptions) {
+    // Kick off the license lookup in the background so it overlaps with task
+    // execution. The log itself is deferred to the print site below so it
+    // never lands in the middle of task output.
+    const nxKeyPromise = (0, nx_key_1.getNxKeyInformation)().catch(() => null);
+    const { projectGraph, taskGraph } = await ensureWorkspaceIsInSyncAndGetGraphs(currentProjectGraph, nxJson, nxArgs, overrides, extraTargetDependencies, extraOptions, taskSelection);
+    const tasks = Object.values(taskGraph.tasks);
+    // A sync generator can remove a selected task, so absent ids are skipped.
+    const initiatingTasks = taskSelection.initiatingTaskIds
+        .map((id) => taskGraph.tasks[id])
+        .filter(Boolean);
+    const projectNames = [
+        ...new Set(initiatingTasks.map((t) => t.target.project)),
+    ];
+    const { lifeCycle, renderIsDone, printSummary, restoreTerminal } = await getTerminalOutputLifeCycle(initiatingProject, initiatingTasks, projectNames, tasks, taskGraph, nxArgs, nxJson, overrides);
+    try {
+        const taskResults = await invokeTasksRunner({
+            tasks,
+            projectGraph,
+            taskGraph,
+            lifeCycle,
+            nxJson,
+            nxArgs,
+            loadDotEnvFiles: extraOptions.loadDotEnvFiles,
+            initiatingProject,
+            initiatingTasks,
+            planningContext: taskSelection.planningContext,
+            ultracacheConfigurationOutcome: taskSelection.ultracacheConfigurationOutcome,
+        });
+        await renderIsDone.finally(() => restoreTerminal?.());
+        if (printSummary) {
+            printSummary();
+        }
+        await printConfigureAiAgentsDisclaimer();
+        const nxKey = await nxKeyPromise;
+        if (nxKey)
+            logger_1.logger.log((0, nx_key_1.createNxKeyLicenseeInformation)(nxKey));
+        return {
+            taskResults,
+            completed: didCommandComplete(tasks, taskResults),
+        };
+    }
+    catch (e) {
+        restoreTerminal?.();
+        throw e;
+    }
+    finally {
+        // Print the report once, on success or failure (restoreTerminal has run in both
+        // paths). No-ops if a multi-task TUI run already delivered it via the popup; its own
+        // try/catch means it never masks `e`.
+        (0, performance_life_cycle_1.flushPerformanceReport)();
+    }
+}
+async function printConfigureAiAgentsDisclaimer() {
+    try {
+        if ((0, is_ci_1.isCI)()) {
+            return;
+        }
+        if (!client_1.daemonClient.enabled() || !(await client_1.daemonClient.isServerAvailable())) {
+            return;
+        }
+        const { outdatedAgents } = await client_1.daemonClient.getConfigureAiAgentsStatus();
+        if (!(0, configure_ai_agents_disclaimer_1.shouldPrintConfigureAiAgentsDisclaimer)(outdatedAgents, workspace_root_1.workspaceRoot)) {
+            return;
+        }
+        output_1.output.logRawLine(output_1.output.dim('Your AI agent configuration is outdated. Run "nx configure-ai-agents" to update.'));
+    }
+    catch {
+        // Silently ignore errors
+    }
+}
+function didCommandComplete(tasks, taskResults) {
+    if (tasks.length === 0)
+        return true;
+    for (const task of tasks) {
+        if (!task.continuous) {
+            // Discrete task must have a result (was started and finished)
+            if (!taskResults[task.id])
+                return false;
+        }
+    }
+    // Any stopped task means the run was interrupted
+    return !Object.values(taskResults).some((r) => r.status === 'stopped');
+}
+async function ensureWorkspaceIsInSyncAndGetGraphs(projectGraph, nxJson, nxArgs, overrides, extraTargetDependencies, extraOptions, taskSelection) {
+    let taskGraph = runValidations(projectGraph, taskSelection.taskGraph, nxArgs);
+    if (nxArgs.skipSync || (0, is_ci_1.isCI)()) {
+        return { projectGraph, taskGraph };
+    }
+    // collect unique syncGenerators from the tasks
+    const uniqueSyncGenerators = (0, sync_generators_1.collectEnabledTaskSyncGeneratorsFromTaskGraph)(taskGraph, projectGraph, nxJson);
+    if (!uniqueSyncGenerators.size) {
+        // There are no sync generators registered in the tasks to run
+        return { projectGraph, taskGraph };
+    }
+    const syncGenerators = Array.from(uniqueSyncGenerators);
+    const results = await (0, sync_generators_1.getSyncGeneratorChanges)(syncGenerators);
+    if (!results.length) {
+        // There are no changes to sync, workspace is up to date
+        return { projectGraph, taskGraph };
+    }
+    const { failedGeneratorsCount, areAllResultsFailures, anySyncGeneratorsFailed, } = (0, sync_generators_1.processSyncGeneratorResultErrors)(results);
+    const failedSyncGeneratorsFixMessageLines = (0, sync_generators_1.getFailedSyncGeneratorsFixMessageLines)(results, nxArgs.verbose);
+    const outOfSyncTitle = 'The workspace is out of sync';
+    const resultBodyLines = (0, sync_generators_1.getSyncGeneratorSuccessResultsMessageLines)(results);
+    if (!process.stdout.isTTY) {
+        // If the user is running a non-TTY environment we
+        // throw an error to stop the execution of the tasks.
+        if (areAllResultsFailures) {
+            output_1.output.error({
+                title: `The workspace is probably out of sync because ${failedGeneratorsCount === 1
+                    ? 'a sync generator'
+                    : 'some sync generators'} failed to run`,
+                bodyLines: failedSyncGeneratorsFixMessageLines,
+            });
+        }
+        else {
+            output_1.output.error({
+                title: outOfSyncTitle,
+                bodyLines: [...resultBodyLines, '', ...SYNC_FIX_MESSAGE_LINES],
+            });
+            if (anySyncGeneratorsFailed) {
+                output_1.output.error({
+                    title: failedGeneratorsCount === 1
+                        ? 'A sync generator failed to run'
+                        : 'Some sync generators failed to run',
+                    bodyLines: failedSyncGeneratorsFixMessageLines,
+                });
+            }
+        }
+        process.exit(1);
+    }
+    if (areAllResultsFailures) {
+        output_1.output.warn({
+            title: `The workspace is probably out of sync because ${failedGeneratorsCount === 1
+                ? 'a sync generator'
+                : 'some sync generators'} failed to run`,
+            bodyLines: failedSyncGeneratorsFixMessageLines,
+        });
+        await confirmRunningTasksWithSyncFailures();
+        // if all sync generators failed to run there's nothing to sync, we just let the tasks run
+        return { projectGraph, taskGraph };
+    }
+    if (nxJson.sync?.applyChanges === false) {
+        // If the user has set `sync.applyChanges` to `false` in their `nx.json`
+        // we don't prompt the them and just log a warning informing them that
+        // the workspace is out of sync and they have it set to not apply changes
+        // automatically.
+        output_1.output.warn({
+            title: outOfSyncTitle,
+            bodyLines: [
+                ...resultBodyLines,
+                '',
+                ...APPLY_CHANGES_FALSE_FIX_MESSAGE_LINES,
+            ],
+        });
+        if (anySyncGeneratorsFailed) {
+            output_1.output.warn({
+                title: failedGeneratorsCount === 1
+                    ? 'A sync generator failed to run'
+                    : 'Some sync generators failed to run',
+                bodyLines: failedSyncGeneratorsFixMessageLines,
+            });
+            await confirmRunningTasksWithSyncFailures();
+        }
+        return { projectGraph, taskGraph };
+    }
+    output_1.output.warn({
+        title: outOfSyncTitle,
+        bodyLines: [
+            ...resultBodyLines,
+            ...(nxJson.sync?.applyChanges === true
+                ? [
+                    '',
+                    'Proceeding to sync the identified changes automatically (`sync.applyChanges` is set to `true` in your `nx.json`).',
+                ]
+                : []),
+        ],
+    });
+    const applyChanges = nxJson.sync?.applyChanges === true ||
+        (await promptForApplyingSyncGeneratorChanges());
+    if (applyChanges) {
+        const spinner = spinner_1.globalSpinner.start('Syncing the workspace...');
+        // Flush sync generator changes to disk
+        const flushResult = await (0, sync_generators_1.flushSyncGeneratorChanges)(results);
+        if ('generatorFailures' in flushResult) {
+            spinner.fail();
+            output_1.output.error({
+                title: 'Failed to sync the workspace',
+                bodyLines: [
+                    ...(0, sync_generators_1.getFlushFailureMessageLines)(flushResult, nxArgs.verbose),
+                    ...(flushResult.generalFailure
+                        ? [
+                            'If needed, you can run the tasks with the `--skip-sync` flag to disable syncing.',
+                        ]
+                        : []),
+                ],
+            });
+            await confirmRunningTasksWithSyncFailures();
+        }
+        // Rebuild rather than carry: a sync generator may remove tasks or move inferred
+        // outputs, so the old graph and planning context are stale.
+        taskSelection.planningContext = undefined;
+        const projectNames = [
+            ...new Set(taskSelection.initiatingTaskIds
+                .filter((id) => taskGraph.tasks[id])
+                .map((id) => taskGraph.tasks[id].target.project)),
+        ];
+        projectGraph = await (0, project_graph_1.createProjectGraphAsync)();
+        const rebuilt = selectTasksForProjects(projectGraph, projectNames, nxArgs, overrides, extraTargetDependencies ?? {}, extraOptions.excludeTaskDependencies).taskGraph;
+        taskGraph = runValidations(projectGraph, 
+        // Before validation, so a cycle or atomizer error names what will actually run.
+        taskSelection.taskIds
+            ? (0, utils_1.pruneToSelectedTasks)(rebuilt, taskSelection.taskIds)
+            : rebuilt, nxArgs);
+        const successTitle = anySyncGeneratorsFailed
+            ? // the identified changes were synced successfully, but the workspace
+                // is still not up to date, which we'll mention next
+                'The identified changes were synced successfully!'
+            : // the workspace is fully up to date
+                'The workspace was synced successfully!';
+        const successSubtitle = nxJson.sync?.applyChanges === true
+            ? 'Please make sure to commit the changes to your repository or this will error in CI.'
+            : // The user was prompted and we already logged a message about erroring in CI
+                // so here we just tell them to commit the changes.
+                'Please make sure to commit the changes to your repository.';
+        spinner.succeed(`${successTitle}\n\n${successSubtitle}`);
+        if (anySyncGeneratorsFailed) {
+            output_1.output.warn({
+                title: `The workspace is probably still out of sync because ${failedGeneratorsCount === 1
+                    ? 'a sync generator'
+                    : 'some sync generators'} failed to run`,
+                bodyLines: failedSyncGeneratorsFixMessageLines,
+            });
+            await confirmRunningTasksWithSyncFailures();
+        }
+    }
+    else {
+        if (anySyncGeneratorsFailed) {
+            output_1.output.warn({
+                title: failedGeneratorsCount === 1
+                    ? 'A sync generator failed to report the sync status'
+                    : 'Some sync generators failed to report the sync status',
+                bodyLines: failedSyncGeneratorsFixMessageLines,
+            });
+            await confirmRunningTasksWithSyncFailures();
+        }
+        else {
+            output_1.output.warn({
+                title: 'Syncing the workspace was skipped',
+                bodyLines: SYNC_SKIPPED_FIX_MESSAGE_LINES,
+            });
+        }
+    }
+    return { projectGraph, taskGraph };
+}
+async function promptForApplyingSyncGeneratorChanges() {
+    try {
+        // No footer slot, so the opt-out note is part of the message.
+        const applyChanges = await (0, prompt_helpers_1.selectPrompt)({
+            message: `Would you like to sync the identified changes to get your workspace up to date?${pc.dim('\nYou can skip this prompt by setting the `sync.applyChanges` option to `true` in your `nx.json`.\nFor more information, refer to the docs: https://nx.dev/concepts/sync-generators.')}`,
+            choices: [
+                { value: 'yes', label: 'Yes, sync the changes and run the tasks' },
+                {
+                    value: 'no',
+                    label: 'No, run the tasks without syncing the changes',
+                },
+            ],
+            onCancel: () => process.exit(1),
+        });
+        return applyChanges === 'yes';
+    }
+    catch {
+        process.exit(1);
+    }
+}
+async function confirmRunningTasksWithSyncFailures() {
+    try {
+        const runTasks = await (0, prompt_helpers_1.selectPrompt)({
+            message: `Would you like to ignore the sync failures and continue running the tasks?${pc.dim(`\nWhen running in CI and there are sync failures, the tasks won't run. Addressing the errors above is highly recommended to prevent failures in CI.`)}`,
+            choices: [
+                { value: 'yes', label: 'Yes, ignore the failures and run the tasks' },
+                { value: 'no', label: `No, don't run the tasks` },
+            ],
+            onCancel: () => process.exit(1),
+        });
+        if (runTasks !== 'yes') {
+            process.exit(1);
+        }
+    }
+    catch {
+        process.exit(1);
+    }
+}
+function setEnvVarsBasedOnArgs(nxArgs, loadDotEnvFiles) {
+    // Batch mode turns on streaming implicitly, but streamed output interleaves
+    // between tasks and so cannot be wrapped in collapsible log groups. Where
+    // grouping applies, let it win over the implicit request; an output style the
+    // user asked for explicitly still wins over grouping.
+    const batchMode = process.env.NX_BATCH_MODE === 'true' || nxArgs.batch;
+    if (nxArgs.specifiedOutputStyle == 'stream' ||
+        (batchMode && !(0, output_1.isLogGroupingEnabled)())) {
+        process.env.NX_STREAM_OUTPUT = 'true';
+        process.env.NX_PREFIX_OUTPUT = 'true';
+    }
+    if (nxArgs.specifiedOutputStyle == 'stream-without-prefixes') {
+        process.env.NX_STREAM_OUTPUT = 'true';
+        process.env.NX_PREFIX_OUTPUT = 'false';
+    }
+    // Force streaming only when the TUI is active, so it can capture and
+    // render task output. Other output styles manage their own streaming.
+    if ((0, is_tui_enabled_1.isTuiEnabled)()) {
+        process.env.NX_STREAM_OUTPUT = 'true';
+    }
+    if (loadDotEnvFiles) {
+        process.env.NX_LOAD_DOT_ENV_FILES = 'true';
+    }
+}
+async function invokeTasksRunner({ tasks, projectGraph, taskGraph, lifeCycle, nxJson, nxArgs, loadDotEnvFiles, initiatingProject, initiatingTasks, planningContext, ultracacheConfigurationOutcome: loadedUltracacheConfigurationOutcome, }) {
+    setEnvVarsBasedOnArgs(nxArgs, loadDotEnvFiles);
+    // this needs to be done before we start to run the tasks
+    const taskDetails = (0, hash_task_1.getTaskDetails)();
+    const { tasksRunner, runnerOptions } = getRunner(nxArgs, nxJson);
+    // Must precede hashing: the Ultracache configurations are a source for task hashes.
+    const ultracacheConfigurationOutcome = loadedUltracacheConfigurationOutcome !== undefined
+        ? loadedUltracacheConfigurationOutcome
+        : await (0, store_1.loadUltracacheConfigurationsForRun)(nxJson, runnerOptions);
+    const ultracacheConfigurations = (0, store_1.configurationsOf)(ultracacheConfigurationOutcome);
+    let hasher = (0, create_task_hasher_1.createTaskHasher)(projectGraph, nxJson, runnerOptions, ultracacheConfigurations, planningContext);
+    // this is used for two reasons: to fetch all remote cache hits AND
+    // to submit everything that is known in advance to Nx Cloud to run in
+    // a distributed fashion
+    const deferredTaskIds = await (0, hash_task_1.hashTasksThatDoNotDependOnOutputsOfOtherTasks)(hasher, projectGraph, taskGraph, nxJson, taskDetails, ultracacheConfigurations);
+    reportUltracacheConfigurations(ultracacheConfigurationOutcome, projectGraph, taskGraph, nxArgs);
+    const taskResultsLifecycle = new task_results_life_cycle_1.TaskResultsLifeCycle();
+    const compositedLifeCycle = new life_cycle_1.CompositeLifeCycle([
+        ...constructLifeCycles(lifeCycle, taskGraph, nxJson, nxArgs.skipNxCache),
+        taskResultsLifecycle,
+    ]);
+    let promiseOrObservable = tasksRunner(tasks, {
+        ...runnerOptions,
+        lifeCycle: compositedLifeCycle,
+    }, {
+        initiatingProject,
+        initiatingTasks,
+        projectGraph,
+        nxJson,
+        nxArgs,
+        taskGraph,
+        hasher: {
+            hashTask(task, taskGraph_, env) {
+                if (!taskGraph_) {
+                    output_1.output.warn({
+                        title: `TaskGraph is now required as an argument to hashTask`,
+                        bodyLines: [
+                            `The TaskGraph object can be retrieved from the context`,
+                            'This will result in an error in Nx 20',
+                        ],
+                    });
+                    taskGraph_ = taskGraph;
+                }
+                if (!env) {
+                    output_1.output.warn({
+                        title: `The environment variables are now required as an argument to hashTask`,
+                        bodyLines: [
+                            `Please pass the environment variables used when running the task`,
+                            'This will result in an error in Nx 20',
+                        ],
+                    });
+                    env = process.env;
+                }
+                return hasher.hashTask(task, taskGraph_, env);
+            },
+            hashTasks(tasks, taskGraph_, envOrPerTaskEnvs) {
+                if (!taskGraph_) {
+                    output_1.output.warn({
+                        title: `TaskGraph is now required as an argument to hashTasks`,
+                        bodyLines: [
+                            `The TaskGraph object can be retrieved from the context`,
+                            'This will result in an error in Nx 20',
+                        ],
+                    });
+                    taskGraph_ = taskGraph;
+                }
+                if (!envOrPerTaskEnvs) {
+                    output_1.output.warn({
+                        title: `The environment variables are now required as an argument to hashTasks`,
+                        bodyLines: [
+                            `Please pass the environment variables used when running the tasks`,
+                            'This will result in an error in Nx 20',
+                        ],
+                    });
+                    envOrPerTaskEnvs = process.env;
+                }
+                // hasher.hashTasks accepts either legacy single-env or the new
+                // per-task-env shape and normalizes internally.
+                return hasher.hashTasks(tasks, taskGraph_, envOrPerTaskEnvs);
+            },
+            hashTasksUpfront(tasks, taskGraph_, perTaskEnvs) {
+                return hasher.hashTasksUpfront(tasks, taskGraph_, perTaskEnvs);
+            },
+        },
+        daemon: client_1.daemonClient,
+        deferredTaskIds,
+    });
+    if (promiseOrObservable.subscribe) {
+        promiseOrObservable = convertObservableToPromise(promiseOrObservable);
+    }
+    await promiseOrObservable;
+    return taskResultsLifecycle.getTaskResults();
+}
+function constructLifeCycles(lifeCycle, taskGraph, nxJson, skipNxCache) {
+    const lifeCycles = [];
+    lifeCycles.push(new store_run_information_life_cycle_1.StoreRunInformationLifeCycle());
+    lifeCycles.push(lifeCycle);
+    if (process.env.NX_PERF_LOGGING === 'true') {
+        lifeCycles.push(new task_timings_life_cycle_1.TaskTimingsLifeCycle());
+    }
+    if (process.env.NX_PROFILE) {
+        lifeCycles.push(new task_profiling_life_cycle_1.TaskProfilingLifeCycle(process.env.NX_PROFILE));
+    }
+    lifeCycles.push(new performance_life_cycle_1.PerformanceLifeCycle(taskGraph, { skipNxCache, nxJson }));
+    lifeCycles.push(new task_telemetry_life_cycle_1.TaskTelemetryLifeCycle());
+    const historyLifeCycle = (0, task_history_life_cycle_1.getTasksHistoryLifeCycle)();
+    lifeCycles.push(historyLifeCycle);
+    return lifeCycles;
+}
+async function convertObservableToPromise(obs) {
+    return await new Promise((res) => {
+        let tasksResults = {};
+        obs.subscribe({
+            next: (t) => {
+                tasksResults[t.task.id] = t.success ? 'success' : 'failure';
+            },
+            error: (error) => {
+                output_1.output.error({
+                    title: 'Unhandled error in task executor',
+                });
+                console.error(error);
+                res(tasksResults);
+            },
+            complete: () => {
+                res(tasksResults);
+            },
+        });
+    });
+}
+function shouldUseDynamicLifeCycle(tasks, options, outputStyle) {
+    if (process.env.NX_BATCH_MODE === 'true' ||
+        process.env.NX_VERBOSE_LOGGING === 'true' ||
+        process.env.NX_TASKS_RUNNER_DYNAMIC_OUTPUT === 'false') {
+        return false;
+    }
+    if (!process.stdout.isTTY)
+        return false;
+    if ((0, is_ci_1.isCI)())
+        return false;
+    if ((0, output_1.isStaticOutputStyle)(outputStyle) ||
+        outputStyle === 'summary' ||
+        outputStyle === 'stream' ||
+        outputStyle === 'stream-without-prefixes')
+        return false;
+    return !tasks.find((t) => (0, utils_1.shouldStreamOutput)(t, null));
+}
+function loadTasksRunner(modulePath) {
+    try {
+        const maybeTasksRunner = require(modulePath);
+        // to support both babel and ts formats
+        return 'default' in maybeTasksRunner
+            ? maybeTasksRunner.default
+            : maybeTasksRunner;
+    }
+    catch (e) {
+        if (e.code === 'MODULE_NOT_FOUND' &&
+            (modulePath === 'nx-cloud' || modulePath === '@nrwl/nx-cloud')) {
+            return require('../nx-cloud/nx-cloud-tasks-runner-shell')
+                .nxCloudTasksRunnerShell;
+        }
+        throw e;
+    }
+}
+function reportUltracacheConfigurations(outcome, projectGraph, taskGraph, nxArgs) {
+    if (!outcome || outcome.status === 'skipped')
+        return;
+    if (!nxArgs.verbose && process.env.NX_VERBOSE_LOGGING !== 'true')
+        return;
+    const summary = (0, report_1.formatUltracacheSummary)((0, overrides_1.buildUltracacheOverrides)(projectGraph, taskGraph, outcome.configurations), outcome.status);
+    output_1.output.note({ title: summary.line, bodyLines: summary.bodyLines });
+}
+/**
+ * What affected task selection reads from the runner options, so it plans as
+ * the run hashes. The Ultracache configurations are loaded once, for selection and the run.
+ */
+async function runnerInputsForSelection(nxArgs, nxJson) {
+    const { runnerOptions } = getRunner(nxArgs, nxJson);
+    return {
+        ultracacheConfigurationOutcome: await (0, store_1.loadUltracacheConfigurationsForRun)(nxJson, runnerOptions),
+        selectivelyHashTsConfig: runnerOptions?.selectivelyHashTsConfig ?? false,
+    };
+}
+function getRunner(nxArgs, nxJson) {
+    let runner = nxArgs.runner;
+    runner = runner ?? 'default';
+    if (runner !== 'default' && !nxJson.tasksRunnerOptions?.[runner]) {
+        throw new Error(`Could not find runner configuration for ${runner}`);
+    }
+    const modulePath = getTasksRunnerPath(runner, nxJson);
+    try {
+        const tasksRunner = loadTasksRunner(modulePath);
+        return {
+            tasksRunner,
+            runnerOptions: getRunnerOptions(runner, nxJson, nxArgs, modulePath === 'nx-cloud'),
+        };
+    }
+    catch {
+        throw new Error(`Could not find runner configuration for ${runner}`);
+    }
+}
+const defaultTasksRunnerPath = require.resolve('./default-tasks-runner');
+function getTasksRunnerPath(runner, nxJson) {
+    // If running inside of Codex, there will be no internet access, so we cannot use the cloud runner, regardless of other config.
+    // We can infer this scenario by checking for certain environment variables defined in their base image: https://github.com/openai/codex-universal
+    if (process.env.CODEX_ENV_NODE_VERSION) {
+        output_1.output.warn({
+            title: 'Codex environment detected, using default tasks runner',
+            bodyLines: [
+                'Codex does not have internet access when it runs tasks, so Nx will use the default tasks runner and only leverage local caching.',
+            ],
+        });
+        return defaultTasksRunnerPath;
+    }
+    const isCloudRunner = 
+    // No tasksRunnerOptions for given --runner
+    nxJson.nxCloudAccessToken ||
+        // No runner prop in tasks runner options, check if access token is set.
+        nxJson.tasksRunnerOptions?.[runner]?.options?.accessToken ||
+        ['nx-cloud', '@nrwl/nx-cloud'].includes(nxJson.tasksRunnerOptions?.[runner]?.runner) ||
+        // Cloud access token specified in env var.
+        process.env.NX_CLOUD_AUTH_TOKEN ||
+        process.env.NX_CLOUD_ACCESS_TOKEN ||
+        // Nx Cloud ID specified in nxJson
+        nxJson.nxCloudId;
+    // NX_NO_CLOUD / neverConnectToCloud wins over any ambient token — otherwise
+    // a surrounding CI env variable would still route through the cloud shell,
+    // which resolves the default tasks runner via its own require bridge and
+    // can pull in a different Nx version than the workspace's own.
+    return isCloudRunner && !(0, nx_cloud_utils_1.isNxCloudDisabled)(nxJson)
+        ? 'nx-cloud'
+        : defaultTasksRunnerPath;
+}
+function getRunnerOptions(runner, nxJson, nxArgs, isCloudDefault) {
+    const result = {
+        ...nxJson.tasksRunnerOptions?.[runner]?.options,
+        ...nxArgs,
+    };
+    // NOTE: we don't pull from env here because the cloud package
+    // supports it within nx-cloud's implementation. We could
+    // normalize it here, and that may make more sense, but
+    // leaving it as is for now.
+    if (nxJson.nxCloudAccessToken && isCloudDefault) {
+        result.accessToken ??= nxJson.nxCloudAccessToken;
+    }
+    if (nxJson.nxCloudId && isCloudDefault) {
+        result.nxCloudId ??= nxJson.nxCloudId;
+    }
+    if (nxJson.nxCloudUrl && isCloudDefault) {
+        result.url ??= nxJson.nxCloudUrl;
+    }
+    if (nxJson.nxCloudEncryptionKey && isCloudDefault) {
+        result.encryptionKey ??= nxJson.nxCloudEncryptionKey;
+    }
+    if (nxJson.parallel) {
+        result.parallel ??= nxJson.parallel;
+    }
+    if (nxJson.cacheDirectory) {
+        result.cacheDirectory ??= nxJson.cacheDirectory;
+    }
+    if (nxJson.useDaemonProcess !== undefined) {
+        result.useDaemonProcess ??= nxJson.useDaemonProcess;
+    }
+    return result;
+}