@nx/devkit 24.0.0-canary.20261019-c4bb923 → 24.0.0-canary.20261020-e7ffd79

package/dist/internal.d.ts

@@ -1,6 +1,7 @@
 export { signalToCode, createProjectRootMappingsFromProjectConfigurations, PluginCache, safeWriteFileCache, emitPluginWorkerLog, resolveImplementation, resolveSchema, ImplementationResolutionError, SchemaResolutionError, resolvePrompt, PromptResolutionError, acknowledgeBuildScripts, acknowledgeDeclaredBuildScripts, createCliOptions, createOverrides, isAiAgent, getCatalogManager, getDaemonClientEnvGeneration, getAppliedDaemonClientEnv, applyDaemonEnvFromClient, getGraphTimeDotEnvForTask, hashDaemonClientEnv, resolveStartupHost, } from 'nx/src/devkit-internals';
 export { detectFormatterInTree, prettierConfigFiles, oxfmtConfigFiles, } from 'nx/src/devkit-internals';
 export type { FormatterType } from 'nx/src/devkit-internals';
+export { addReadyWhenSignalToTargets, readApplicableTargetDefaults, } from './src/generators/add-ready-when-signal';
 export { determineArtifactNameAndDirectoryOptions, getRelativeCwd, type FileExtensionType, } from './src/generators/artifact-name-and-directory-utils';
 export { getE2EWebServerInfo, type E2EWebServerDetails, } from './src/generators/e2e-web-server-info-utils';
 export { forEachExecutorOptions } from './src/generators/executor-options-utils';
@@ -22,13 +23,13 @@ export { isRequireEsmRaceError, retryOnRequireEsmRace, } from './src/utils/requi
 export { findPluginForConfigFile } from './src/utils/find-plugin-for-config-file';
 export { getNamedInputs } from './src/utils/get-named-inputs';
 export { parseNxDirectives } from './src/utils/nx-directives';
+export { getForwardedArgs, getListeningUrl, getReadyCheckReadyWhen, getServerAddress, parseCacArgs, parseCommanderArgs, runReadyCheck, type ServerAddress, } from './src/utils/readiness';
 export { applyTestFileDirectives } from './src/utils/test-file-directives';
 export { hasIgnoreServerInputsDirective } from './src/utils/ignore-server-inputs-directive';
 export { logShowProjectCommand } from './src/utils/log-show-project-command';
 export { eachValueFrom } from './src/utils/rxjs-for-await';
 export { checkAndCleanWithSemver } from './src/utils/semver';
-export { splitShellArgs } from './src/utils/split-shell-args';
 export { camelize, capitalize, classify, dasherize, } from './src/utils/string-utils';
-export { runCommandsExecutor, type TaskResult, type Agent, type BatchExecutorTaskResult, BatchFunctionRunner, type BatchResults, type CLIErrorMessageConfig, type CLINoteMessageConfig, type CLISuccessMessageConfig, type CLIWarnMessageConfig, Cache, type CachedResult, type Change, type ChangedFile, CompositeLifeCycle, DeletedFileChange, confirmationPrompt, type FileChange, type FileDataDependency, type FileMapCache, type FinalConfigForProject, FsTree, type GeneratorInformation, type InputDefinition, type JsonInput, LARGE_BUFFER, type LifeCycle, LockFileChange, NX_PREFIX, type NormalizedTargetDependencyConfig, type NxCloudOnBoardingStatus, type NxReleaseVersionConfiguration, type PackageJson, type PackageJsonDependencySection, type PackageManagerCommands, type ProjectRootMappings, RemoteCacheV2, type RunCommandsOptions, SyncError, type SyncGeneratorResult, TEN_MEGABYTES, TargetProjectLocator, type TaskMetadata, type TaskStatus, type TaskWithCachedResult, type TasksRunner, type UnregisterCallback, WholeFileChange, buildPackageJsonPatterns, buildPackageJsonWorkspacesMatcher, buildProjectGraphAndSourceMapsWithoutDaemon, calculateFileChanges, calculateReverseDeps, codeFrameColumns, combineGlobPatterns, connectToNxCloud, createDirectory, createLockFile, createNxCloudOnboardingURL, createNxCloudOnboardingURLForWelcomeApp, createPackageJson, createProjectGraphAndSourceMapsAsync, createProjectRootMappings, createRunManyDynamicOutputRenderer, createTargetDefaultsResults, createTaskId, daemonClient, deduceDefaultBase, defaultFileRead, deriveGroupNameFromTarget, directoryExists, dropEmptyPeerDependencySections, expandDependencyConfigSyntaxSugar, expandInitiatingTasksThroughNoop, expandWildcardTargetConfiguration, fileDataDepTarget, fileDataDepType, fileExists, filterUsingGlobPatterns, findAllProjectNodeDependencies, findInstalledPlugins, findMatchingConfigFiles, findMatchingProjects, findMatchingTargetNames, findProjectForPath, findProjectsNpmDependencies, forceRegisterEsmLoader, generatePrunedDeployOutput, getCliPath, getCustomHasher, getDependencyConfigs, getEnvFilesForTask, getEnvPathsForTask, getExecutorForTask, getExecutorInformation, getExecutorNameForTask, getFilesInDirectoryUsingContext, getGeneratorInformation, getGlobPatternsFromPackageManagerWorkspaces, getLastValueFromAsyncIterableIterator, getLatestCommitSha, getLockFileName, getNxCloudAppOnBoardingUrl, getNxCloudUrl, getNxRequirePaths, getOutputs, getPrintableCommandArgsForTask, getRelativeProjectJsonSchemaPath, getSerializedArgsForTask, getSourceDirOfDependentProjects, getTargetConfigurationForTask, getTargetInputs, getUnparsedOverrideArgs, getWorkspacePackagesFromGraph, globWithWorkspaceContext, handleImport, handleProjectGraphError, hashFile, hashObject, hashWithWorkspaceContext, interpolate, isBuiltinModuleImport, isCI, isCacheableTask, isDeletedFileChange, isLockFileChange, isNpmProject, isNxCloudUsed, isProjectGraphExternalNode, isProjectGraphProjectNode, isRelativePath, isWholeFileChange, killChildOnHostExit, killProcessTreeGraceful, loadTsFile, mergeTargetConfigurations, movePeerDependencyToDependencies, multiselectPrompt, normalizeDependencyConfigDefinition, normalizeDependencyConfigProjects, normalizeTargetDependencyWithStringProjects, nxVersion, orange, parseExecutor, parseVersionFromPackageManagerField, preventRecursionInGraphConstruction, quoteShellArg, readCachedProjectConfiguration, readFileIfExisting, readFileMapCache, readModulePackageJson, readNxJsonFromDisk, readNxMigrateConfig, readPackageJson, readProjectAndTargetFromTargetString, registerTsConfigPaths, registerTsProject, relocatePrunedLocalPathSpec, removeTasksFromTaskGraph, requireWithTsconfigFallback, resetWorkspaceContext, resolveCommandSyntacticSugar, runNxSync, safeExecFileSync, safeSpawn, selectPrompt, setWorkspaceRoot, setupAiAgentsGenerator, setupWorkspaceContext, shouldStreamOutput, toNewFormat, toOldFormat, transformLegacyOutputs, textPrompt, unparse, validateOutputs, warnUnshippableLocalPathSpec, workspaceDataDirectory, workspaceRootInner, } from 'nx/src/devkit-internals';
+export { runCommandsExecutor, type TaskResult, type Agent, type BatchExecutorTaskResult, BatchFunctionRunner, type BatchResults, type CLIErrorMessageConfig, type CLINoteMessageConfig, type CLISuccessMessageConfig, type CLIWarnMessageConfig, Cache, type CachedResult, type Change, type ChangedFile, CompositeLifeCycle, DeletedFileChange, confirmationPrompt, type FileChange, type FileDataDependency, type FileMapCache, type FinalConfigForProject, FsTree, type GeneratorInformation, type InputDefinition, type JsonInput, LARGE_BUFFER, type LifeCycle, LockFileChange, NX_PREFIX, type NormalizedTargetDependencyConfig, type NxCloudOnBoardingStatus, type NxReleaseVersionConfiguration, type PackageJson, type PackageJsonDependencySection, type PackageManagerCommands, type ProjectRootMappings, RemoteCacheV2, type RunCommandsOptions, SyncError, type SyncGeneratorResult, TEN_MEGABYTES, TargetProjectLocator, type TaskMetadata, type TaskStatus, type TaskWithCachedResult, type TasksRunner, type UnregisterCallback, WholeFileChange, buildPackageJsonPatterns, buildPackageJsonWorkspacesMatcher, buildProjectGraphAndSourceMapsWithoutDaemon, calculateFileChanges, calculateReverseDeps, codeFrameColumns, combineGlobPatterns, connectToNxCloud, createDirectory, createLockFile, createNxCloudOnboardingURL, createNxCloudOnboardingURLForWelcomeApp, createPackageJson, createProjectGraphAndSourceMapsAsync, createProjectRootMappings, createRunManyDynamicOutputRenderer, createTargetDefaultsResults, createTaskId, daemonClient, deduceDefaultBase, defaultFileRead, deriveGroupNameFromTarget, directoryExists, dropEmptyPeerDependencySections, expandDependencyConfigSyntaxSugar, expandInitiatingTasksThroughNoop, expandWildcardTargetConfiguration, fileDataDepTarget, fileDataDepType, fileExists, filterUsingGlobPatterns, findAllProjectNodeDependencies, findInstalledPlugins, findMatchingConfigFiles, findMatchingProjects, findMatchingTargetNames, findProjectForPath, findProjectsNpmDependencies, forceRegisterEsmLoader, generatePrunedDeployOutput, getCliPath, getCustomHasher, getDependencyConfigs, getEnvFilesForTask, getEnvPathsForTask, getExecutorForTask, getExecutorInformation, getExecutorNameForTask, getFilesInDirectoryUsingContext, getGeneratorInformation, getGlobPatternsFromPackageManagerWorkspaces, getLastValueFromAsyncIterableIterator, getLatestCommitSha, getLockFileName, getNxCloudAppOnBoardingUrl, getNxCloudUrl, getNxRequirePaths, getOutputs, getPrintableCommandArgsForTask, getRelativeProjectJsonSchemaPath, getSerializedArgsForTask, getSourceDirOfDependentProjects, getTargetConfigurationForTask, getTargetInputs, getUnparsedOverrideArgs, getWorkspacePackagesFromGraph, globWithWorkspaceContext, handleImport, handleProjectGraphError, hashFile, hashObject, hashWithWorkspaceContext, interpolate, isBuiltinModuleImport, isCI, isCacheableTask, isDeletedFileChange, isLockFileChange, isNpmProject, isNxCloudUsed, isProjectGraphExternalNode, isProjectGraphProjectNode, isRelativePath, isWholeFileChange, killChildOnHostExit, killProcessTreeGraceful, loadTsFile, mergeTargetConfigurations, movePeerDependencyToDependencies, multiselectPrompt, normalizeDependencyConfigDefinition, normalizeDependencyConfigProjects, normalizeTargetDependencyWithStringProjects, nxVersion, orange, parseExecutor, parseVersionFromPackageManagerField, preventRecursionInGraphConstruction, quoteShellArg, readCachedProjectConfiguration, readFileIfExisting, readFileMapCache, readModulePackageJson, readNxJsonFromDisk, readNxMigrateConfig, readPackageJson, readProjectAndTargetFromTargetString, registerTsConfigPaths, registerTsProject, relocatePrunedLocalPathSpec, removeTasksFromTaskGraph, requireWithTsconfigFallback, resetWorkspaceContext, resolveCommandSyntacticSugar, resolveNxTokensInOptions, runNxSync, safeExecFileSync, safeSpawn, selectPrompt, setWorkspaceRoot, setupAiAgentsGenerator, setupWorkspaceContext, shouldStreamOutput, toNewFormat, toOldFormat, transformLegacyOutputs, textPrompt, unparse, validateOutputs, warnUnshippableLocalPathSpec, workspaceDataDirectory, workspaceRootInner, } from 'nx/src/devkit-internals';
 export type { AfterAllProjectsVersioned } from 'nx/release';
 export { migrateRemovedExecutors } from './src/generators/plugin-migrations/remove-executors';

package/dist/internal.js

@@ -1,10 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.addPlugin = exports.upsertTargetDefault = exports.updateTargetDefault = exports.readTargetDefaultsForTarget = exports.findTargetDefault = exports.addE2eCiTargetDefaults = exports.addBuildTargetDefaults = exports.isInteractive = exports.resolveImportPath = exports.ensureRootProjectName = exports.determineProjectNameAndRootOptions = exports.toProjectRelativePath = exports.deleteMatchingProperties = exports.processTargetOutputs = exports.NoTargetsToMigrateError = exports.migrateProjectExecutorsToPluginV1 = exports.migrateProjectExecutorsToPlugin = exports.openBatchConversionSession = exports.finalizeBatchConversion = exports.AggregatedLog = exports.forEachExecutorOptions = exports.getE2EWebServerInfo = exports.getRelativeCwd = exports.determineArtifactNameAndDirectoryOptions = exports.oxfmtConfigFiles = exports.prettierConfigFiles = exports.detectFormatterInTree = exports.resolveStartupHost = exports.hashDaemonClientEnv = exports.getGraphTimeDotEnvForTask = exports.applyDaemonEnvFromClient = exports.getAppliedDaemonClientEnv = exports.getDaemonClientEnvGeneration = exports.getCatalogManager = exports.isAiAgent = exports.createOverrides = exports.createCliOptions = exports.acknowledgeDeclaredBuildScripts = exports.acknowledgeBuildScripts = exports.PromptResolutionError = exports.resolvePrompt = exports.SchemaResolutionError = exports.ImplementationResolutionError = exports.resolveSchema = exports.resolveImplementation = exports.emitPluginWorkerLog = exports.safeWriteFileCache = exports.PluginCache = exports.createProjectRootMappingsFromProjectConfigurations = exports.signalToCode = void 0;
-exports.codeFrameColumns = exports.calculateReverseDeps = exports.calculateFileChanges = exports.buildProjectGraphAndSourceMapsWithoutDaemon = exports.buildPackageJsonWorkspacesMatcher = exports.buildPackageJsonPatterns = exports.WholeFileChange = exports.TargetProjectLocator = exports.TEN_MEGABYTES = exports.SyncError = exports.RemoteCacheV2 = exports.NX_PREFIX = exports.LockFileChange = exports.LARGE_BUFFER = exports.FsTree = exports.confirmationPrompt = exports.DeletedFileChange = exports.CompositeLifeCycle = exports.Cache = exports.BatchFunctionRunner = exports.runCommandsExecutor = exports.dasherize = exports.classify = exports.capitalize = exports.camelize = exports.splitShellArgs = exports.checkAndCleanWithSemver = exports.eachValueFrom = exports.logShowProjectCommand = exports.hasIgnoreServerInputsDirective = exports.applyTestFileDirectives = exports.parseNxDirectives = exports.getNamedInputs = exports.findPluginForConfigFile = exports.retryOnRequireEsmRace = exports.isRequireEsmRaceError = exports.clearRequireCache = exports.loadConfigFile = exports.calculateHashesForCreateNodes = exports.calculateHashForCreateNodes = exports.mapAsyncIterable = exports.combineAsyncIterables = exports.createAsyncIterable = exports.getSatisfyingInstalledPackageVersion = exports.getResolvedPackageVersion = exports.assertSupportedPackageVersion = exports.assertSupportedInstalledPackageVersion = exports.getInstalledPackageVersionFromTree = exports.getInstalledPackageVersion = exports.getDeclaredPackageVersion = void 0;
-exports.getNxCloudUrl = exports.getNxCloudAppOnBoardingUrl = exports.getLockFileName = exports.getLatestCommitSha = exports.getLastValueFromAsyncIterableIterator = exports.getGlobPatternsFromPackageManagerWorkspaces = exports.getGeneratorInformation = exports.getFilesInDirectoryUsingContext = exports.getExecutorNameForTask = exports.getExecutorInformation = exports.getExecutorForTask = exports.getEnvPathsForTask = exports.getEnvFilesForTask = exports.getDependencyConfigs = exports.getCustomHasher = exports.getCliPath = exports.generatePrunedDeployOutput = exports.forceRegisterEsmLoader = exports.findProjectsNpmDependencies = exports.findProjectForPath = exports.findMatchingTargetNames = exports.findMatchingProjects = exports.findMatchingConfigFiles = exports.findInstalledPlugins = exports.findAllProjectNodeDependencies = exports.filterUsingGlobPatterns = exports.fileExists = exports.fileDataDepType = exports.fileDataDepTarget = exports.expandWildcardTargetConfiguration = exports.expandInitiatingTasksThroughNoop = exports.expandDependencyConfigSyntaxSugar = exports.dropEmptyPeerDependencySections = exports.directoryExists = exports.deriveGroupNameFromTarget = exports.defaultFileRead = exports.deduceDefaultBase = exports.daemonClient = exports.createTaskId = exports.createTargetDefaultsResults = exports.createRunManyDynamicOutputRenderer = exports.createProjectRootMappings = exports.createProjectGraphAndSourceMapsAsync = exports.createPackageJson = exports.createNxCloudOnboardingURLForWelcomeApp = exports.createNxCloudOnboardingURL = exports.createLockFile = exports.createDirectory = exports.connectToNxCloud = exports.combineGlobPatterns = void 0;
-exports.readPackageJson = exports.readNxMigrateConfig = exports.readNxJsonFromDisk = exports.readModulePackageJson = exports.readFileMapCache = exports.readFileIfExisting = exports.readCachedProjectConfiguration = exports.quoteShellArg = exports.preventRecursionInGraphConstruction = exports.parseVersionFromPackageManagerField = exports.parseExecutor = exports.orange = exports.nxVersion = exports.normalizeTargetDependencyWithStringProjects = exports.normalizeDependencyConfigProjects = exports.normalizeDependencyConfigDefinition = exports.multiselectPrompt = exports.movePeerDependencyToDependencies = exports.mergeTargetConfigurations = exports.loadTsFile = exports.killProcessTreeGraceful = exports.killChildOnHostExit = exports.isWholeFileChange = exports.isRelativePath = exports.isProjectGraphProjectNode = exports.isProjectGraphExternalNode = exports.isNxCloudUsed = exports.isNpmProject = exports.isLockFileChange = exports.isDeletedFileChange = exports.isCacheableTask = exports.isCI = exports.isBuiltinModuleImport = exports.interpolate = exports.hashWithWorkspaceContext = exports.hashObject = exports.hashFile = exports.handleProjectGraphError = exports.handleImport = exports.globWithWorkspaceContext = exports.getWorkspacePackagesFromGraph = exports.getUnparsedOverrideArgs = exports.getTargetInputs = exports.getTargetConfigurationForTask = exports.getSourceDirOfDependentProjects = exports.getSerializedArgsForTask = exports.getRelativeProjectJsonSchemaPath = exports.getPrintableCommandArgsForTask = exports.getOutputs = exports.getNxRequirePaths = void 0;
-exports.migrateRemovedExecutors = exports.workspaceRootInner = exports.workspaceDataDirectory = exports.warnUnshippableLocalPathSpec = exports.validateOutputs = exports.unparse = exports.textPrompt = exports.transformLegacyOutputs = exports.toOldFormat = exports.toNewFormat = exports.shouldStreamOutput = exports.setupWorkspaceContext = exports.setupAiAgentsGenerator = exports.setWorkspaceRoot = exports.selectPrompt = exports.safeSpawn = exports.safeExecFileSync = exports.runNxSync = exports.resolveCommandSyntacticSugar = exports.resetWorkspaceContext = exports.requireWithTsconfigFallback = exports.removeTasksFromTaskGraph = exports.relocatePrunedLocalPathSpec = exports.registerTsProject = exports.registerTsConfigPaths = exports.readProjectAndTargetFromTargetString = void 0;
+exports.updateTargetDefault = exports.readTargetDefaultsForTarget = exports.findTargetDefault = exports.addE2eCiTargetDefaults = exports.addBuildTargetDefaults = exports.isInteractive = exports.resolveImportPath = exports.ensureRootProjectName = exports.determineProjectNameAndRootOptions = exports.toProjectRelativePath = exports.deleteMatchingProperties = exports.processTargetOutputs = exports.NoTargetsToMigrateError = exports.migrateProjectExecutorsToPluginV1 = exports.migrateProjectExecutorsToPlugin = exports.openBatchConversionSession = exports.finalizeBatchConversion = exports.AggregatedLog = exports.forEachExecutorOptions = exports.getE2EWebServerInfo = exports.getRelativeCwd = exports.determineArtifactNameAndDirectoryOptions = exports.readApplicableTargetDefaults = exports.addReadyWhenSignalToTargets = exports.oxfmtConfigFiles = exports.prettierConfigFiles = exports.detectFormatterInTree = exports.resolveStartupHost = exports.hashDaemonClientEnv = exports.getGraphTimeDotEnvForTask = exports.applyDaemonEnvFromClient = exports.getAppliedDaemonClientEnv = exports.getDaemonClientEnvGeneration = exports.getCatalogManager = exports.isAiAgent = exports.createOverrides = exports.createCliOptions = exports.acknowledgeDeclaredBuildScripts = exports.acknowledgeBuildScripts = exports.PromptResolutionError = exports.resolvePrompt = exports.SchemaResolutionError = exports.ImplementationResolutionError = exports.resolveSchema = exports.resolveImplementation = exports.emitPluginWorkerLog = exports.safeWriteFileCache = exports.PluginCache = exports.createProjectRootMappingsFromProjectConfigurations = exports.signalToCode = void 0;
+exports.TEN_MEGABYTES = exports.SyncError = exports.RemoteCacheV2 = exports.NX_PREFIX = exports.LockFileChange = exports.LARGE_BUFFER = exports.FsTree = exports.confirmationPrompt = exports.DeletedFileChange = exports.CompositeLifeCycle = exports.Cache = exports.BatchFunctionRunner = exports.runCommandsExecutor = exports.dasherize = exports.classify = exports.capitalize = exports.camelize = exports.checkAndCleanWithSemver = exports.eachValueFrom = exports.logShowProjectCommand = exports.hasIgnoreServerInputsDirective = exports.applyTestFileDirectives = exports.runReadyCheck = exports.parseCommanderArgs = exports.parseCacArgs = exports.getServerAddress = exports.getReadyCheckReadyWhen = exports.getListeningUrl = exports.getForwardedArgs = exports.parseNxDirectives = exports.getNamedInputs = exports.findPluginForConfigFile = exports.retryOnRequireEsmRace = exports.isRequireEsmRaceError = exports.clearRequireCache = exports.loadConfigFile = exports.calculateHashesForCreateNodes = exports.calculateHashForCreateNodes = exports.mapAsyncIterable = exports.combineAsyncIterables = exports.createAsyncIterable = exports.getSatisfyingInstalledPackageVersion = exports.getResolvedPackageVersion = exports.assertSupportedPackageVersion = exports.assertSupportedInstalledPackageVersion = exports.getInstalledPackageVersionFromTree = exports.getInstalledPackageVersion = exports.getDeclaredPackageVersion = exports.addPlugin = exports.upsertTargetDefault = void 0;
+exports.getExecutorNameForTask = exports.getExecutorInformation = exports.getExecutorForTask = exports.getEnvPathsForTask = exports.getEnvFilesForTask = exports.getDependencyConfigs = exports.getCustomHasher = exports.getCliPath = exports.generatePrunedDeployOutput = exports.forceRegisterEsmLoader = exports.findProjectsNpmDependencies = exports.findProjectForPath = exports.findMatchingTargetNames = exports.findMatchingProjects = exports.findMatchingConfigFiles = exports.findInstalledPlugins = exports.findAllProjectNodeDependencies = exports.filterUsingGlobPatterns = exports.fileExists = exports.fileDataDepType = exports.fileDataDepTarget = exports.expandWildcardTargetConfiguration = exports.expandInitiatingTasksThroughNoop = exports.expandDependencyConfigSyntaxSugar = exports.dropEmptyPeerDependencySections = exports.directoryExists = exports.deriveGroupNameFromTarget = exports.defaultFileRead = exports.deduceDefaultBase = exports.daemonClient = exports.createTaskId = exports.createTargetDefaultsResults = exports.createRunManyDynamicOutputRenderer = exports.createProjectRootMappings = exports.createProjectGraphAndSourceMapsAsync = exports.createPackageJson = exports.createNxCloudOnboardingURLForWelcomeApp = exports.createNxCloudOnboardingURL = exports.createLockFile = exports.createDirectory = exports.connectToNxCloud = exports.combineGlobPatterns = exports.codeFrameColumns = exports.calculateReverseDeps = exports.calculateFileChanges = exports.buildProjectGraphAndSourceMapsWithoutDaemon = exports.buildPackageJsonWorkspacesMatcher = exports.buildPackageJsonPatterns = exports.WholeFileChange = exports.TargetProjectLocator = void 0;
+exports.preventRecursionInGraphConstruction = exports.parseVersionFromPackageManagerField = exports.parseExecutor = exports.orange = exports.nxVersion = exports.normalizeTargetDependencyWithStringProjects = exports.normalizeDependencyConfigProjects = exports.normalizeDependencyConfigDefinition = exports.multiselectPrompt = exports.movePeerDependencyToDependencies = exports.mergeTargetConfigurations = exports.loadTsFile = exports.killProcessTreeGraceful = exports.killChildOnHostExit = exports.isWholeFileChange = exports.isRelativePath = exports.isProjectGraphProjectNode = exports.isProjectGraphExternalNode = exports.isNxCloudUsed = exports.isNpmProject = exports.isLockFileChange = exports.isDeletedFileChange = exports.isCacheableTask = exports.isCI = exports.isBuiltinModuleImport = exports.interpolate = exports.hashWithWorkspaceContext = exports.hashObject = exports.hashFile = exports.handleProjectGraphError = exports.handleImport = exports.globWithWorkspaceContext = exports.getWorkspacePackagesFromGraph = exports.getUnparsedOverrideArgs = exports.getTargetInputs = exports.getTargetConfigurationForTask = exports.getSourceDirOfDependentProjects = exports.getSerializedArgsForTask = exports.getRelativeProjectJsonSchemaPath = exports.getPrintableCommandArgsForTask = exports.getOutputs = exports.getNxRequirePaths = exports.getNxCloudUrl = exports.getNxCloudAppOnBoardingUrl = exports.getLockFileName = exports.getLatestCommitSha = exports.getLastValueFromAsyncIterableIterator = exports.getGlobPatternsFromPackageManagerWorkspaces = exports.getGeneratorInformation = exports.getFilesInDirectoryUsingContext = void 0;
+exports.migrateRemovedExecutors = exports.workspaceRootInner = exports.workspaceDataDirectory = exports.warnUnshippableLocalPathSpec = exports.validateOutputs = exports.unparse = exports.textPrompt = exports.transformLegacyOutputs = exports.toOldFormat = exports.toNewFormat = exports.shouldStreamOutput = exports.setupWorkspaceContext = exports.setupAiAgentsGenerator = exports.setWorkspaceRoot = exports.selectPrompt = exports.safeSpawn = exports.safeExecFileSync = exports.runNxSync = exports.resolveNxTokensInOptions = exports.resolveCommandSyntacticSugar = exports.resetWorkspaceContext = exports.requireWithTsconfigFallback = exports.removeTasksFromTaskGraph = exports.relocatePrunedLocalPathSpec = exports.registerTsProject = exports.registerTsConfigPaths = exports.readProjectAndTargetFromTargetString = exports.readPackageJson = exports.readNxMigrateConfig = exports.readNxJsonFromDisk = exports.readModulePackageJson = exports.readFileMapCache = exports.readFileIfExisting = exports.readCachedProjectConfiguration = exports.quoteShellArg = void 0;
 var devkit_internals_1 = require("nx/src/devkit-internals");
 Object.defineProperty(exports, "signalToCode", { enumerable: true, get: function () { return devkit_internals_1.signalToCode; } });
 Object.defineProperty(exports, "createProjectRootMappingsFromProjectConfigurations", { enumerable: true, get: function () { return devkit_internals_1.createProjectRootMappingsFromProjectConfigurations; } });
@@ -45,6 +45,9 @@ Object.defineProperty(exports, "detectFormatterInTree", { enumerable: true, get:
 Object.defineProperty(exports, "prettierConfigFiles", { enumerable: true, get: function () { return devkit_internals_2.prettierConfigFiles; } });
 Object.defineProperty(exports, "oxfmtConfigFiles", { enumerable: true, get: function () { return devkit_internals_2.oxfmtConfigFiles; } });
 // Generators
+var add_ready_when_signal_1 = require("./src/generators/add-ready-when-signal");
+Object.defineProperty(exports, "addReadyWhenSignalToTargets", { enumerable: true, get: function () { return add_ready_when_signal_1.addReadyWhenSignalToTargets; } });
+Object.defineProperty(exports, "readApplicableTargetDefaults", { enumerable: true, get: function () { return add_ready_when_signal_1.readApplicableTargetDefaults; } });
 var artifact_name_and_directory_utils_1 = require("./src/generators/artifact-name-and-directory-utils");
 Object.defineProperty(exports, "determineArtifactNameAndDirectoryOptions", { enumerable: true, get: function () { return artifact_name_and_directory_utils_1.determineArtifactNameAndDirectoryOptions; } });
 Object.defineProperty(exports, "getRelativeCwd", { enumerable: true, get: function () { return artifact_name_and_directory_utils_1.getRelativeCwd; } });
@@ -110,6 +113,14 @@ var get_named_inputs_1 = require("./src/utils/get-named-inputs");
 Object.defineProperty(exports, "getNamedInputs", { enumerable: true, get: function () { return get_named_inputs_1.getNamedInputs; } });
 var nx_directives_1 = require("./src/utils/nx-directives");
 Object.defineProperty(exports, "parseNxDirectives", { enumerable: true, get: function () { return nx_directives_1.parseNxDirectives; } });
+var readiness_1 = require("./src/utils/readiness");
+Object.defineProperty(exports, "getForwardedArgs", { enumerable: true, get: function () { return readiness_1.getForwardedArgs; } });
+Object.defineProperty(exports, "getListeningUrl", { enumerable: true, get: function () { return readiness_1.getListeningUrl; } });
+Object.defineProperty(exports, "getReadyCheckReadyWhen", { enumerable: true, get: function () { return readiness_1.getReadyCheckReadyWhen; } });
+Object.defineProperty(exports, "getServerAddress", { enumerable: true, get: function () { return readiness_1.getServerAddress; } });
+Object.defineProperty(exports, "parseCacArgs", { enumerable: true, get: function () { return readiness_1.parseCacArgs; } });
+Object.defineProperty(exports, "parseCommanderArgs", { enumerable: true, get: function () { return readiness_1.parseCommanderArgs; } });
+Object.defineProperty(exports, "runReadyCheck", { enumerable: true, get: function () { return readiness_1.runReadyCheck; } });
 var test_file_directives_1 = require("./src/utils/test-file-directives");
 Object.defineProperty(exports, "applyTestFileDirectives", { enumerable: true, get: function () { return test_file_directives_1.applyTestFileDirectives; } });
 var ignore_server_inputs_directive_1 = require("./src/utils/ignore-server-inputs-directive");
@@ -120,8 +131,6 @@ var rxjs_for_await_1 = require("./src/utils/rxjs-for-await");
 Object.defineProperty(exports, "eachValueFrom", { enumerable: true, get: function () { return rxjs_for_await_1.eachValueFrom; } });
 var semver_1 = require("./src/utils/semver");
 Object.defineProperty(exports, "checkAndCleanWithSemver", { enumerable: true, get: function () { return semver_1.checkAndCleanWithSemver; } });
-var split_shell_args_1 = require("./src/utils/split-shell-args");
-Object.defineProperty(exports, "splitShellArgs", { enumerable: true, get: function () { return split_shell_args_1.splitShellArgs; } });
 var string_utils_1 = require("./src/utils/string-utils");
 Object.defineProperty(exports, "camelize", { enumerable: true, get: function () { return string_utils_1.camelize; } });
 Object.defineProperty(exports, "capitalize", { enumerable: true, get: function () { return string_utils_1.capitalize; } });
@@ -258,6 +267,7 @@ Object.defineProperty(exports, "removeTasksFromTaskGraph", { enumerable: true, g
 Object.defineProperty(exports, "requireWithTsconfigFallback", { enumerable: true, get: function () { return devkit_internals_3.requireWithTsconfigFallback; } });
 Object.defineProperty(exports, "resetWorkspaceContext", { enumerable: true, get: function () { return devkit_internals_3.resetWorkspaceContext; } });
 Object.defineProperty(exports, "resolveCommandSyntacticSugar", { enumerable: true, get: function () { return devkit_internals_3.resolveCommandSyntacticSugar; } });
+Object.defineProperty(exports, "resolveNxTokensInOptions", { enumerable: true, get: function () { return devkit_internals_3.resolveNxTokensInOptions; } });
 Object.defineProperty(exports, "runNxSync", { enumerable: true, get: function () { return devkit_internals_3.runNxSync; } });
 Object.defineProperty(exports, "safeExecFileSync", { enumerable: true, get: function () { return devkit_internals_3.safeExecFileSync; } });
 Object.defineProperty(exports, "safeSpawn", { enumerable: true, get: function () { return devkit_internals_3.safeSpawn; } });

package/dist/src/generators/add-ready-when-signal.d.ts

@@ -0,0 +1,17 @@
+import { type ProjectGraphProjectNode, type TargetConfiguration, type TargetDefaults, type Tree } from 'nx/src/devkit-exports';
+/**
+ * Migration body that sets `readyWhen: { signal: true }` on the targets running
+ * one of `executors`. A target is skipped when it, or the `targetDefaults` that
+ * apply to it, already set `readyWhen`, or when its own `continuous`, else the
+ * one from `targetDefaults`, is `false`. `onAdded` gets each target it sets it
+ * on, with the `targetDefaults` that apply to it. Returning `false` from it
+ * leaves that target unchanged.
+ */
+export declare function addReadyWhenSignalToTargets(tree: Tree, executors: readonly string[], onAdded?: (target: TargetConfiguration, projectName: string, defaults: Partial<TargetConfiguration> | null) => boolean | void): Promise<{
+    skipAgentic: true;
+} | void>;
+/**
+ * The `targetDefaults` Nx applies to a target, which leaves out the entries
+ * that run another executor or a command.
+ */
+export declare function readApplicableTargetDefaults(targetName: string, executor: string | undefined, targetDefaults: TargetDefaults | undefined, projectName: string, projectNode: ProjectGraphProjectNode): Partial<TargetConfiguration> | null;

package/dist/src/generators/add-ready-when-signal.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addReadyWhenSignalToTargets = addReadyWhenSignalToTargets;
+exports.readApplicableTargetDefaults = readApplicableTargetDefaults;
+const devkit_exports_1 = require("nx/src/devkit-exports");
+const format_files_1 = require("./format-files");
+const target_defaults_utils_1 = require("./target-defaults-utils");
+/**
+ * Migration body that sets `readyWhen: { signal: true }` on the targets running
+ * one of `executors`. A target is skipped when it, or the `targetDefaults` that
+ * apply to it, already set `readyWhen`, or when its own `continuous`, else the
+ * one from `targetDefaults`, is `false`. `onAdded` gets each target it sets it
+ * on, with the `targetDefaults` that apply to it. Returning `false` from it
+ * leaves that target unchanged.
+ */
+async function addReadyWhenSignalToTargets(tree, executors, onAdded) {
+    const targetDefaults = (0, devkit_exports_1.readNxJson)(tree)?.targetDefaults;
+    let changed = false;
+    for (const [projectName, project] of (0, devkit_exports_1.getProjects)(tree)) {
+        const projectNode = {
+            name: projectName,
+            type: 'lib',
+            data: { root: project.root, tags: project.tags },
+        };
+        let projectChanged = false;
+        for (const [targetName, target] of Object.entries(project.targets ?? {})) {
+            if (target.command || target.readyWhen !== undefined) {
+                continue;
+            }
+            const defaults = readApplicableTargetDefaults(targetName, target.executor, targetDefaults, projectName, projectNode);
+            const executor = target.executor ?? (defaults?.command ? undefined : defaults?.executor);
+            if (!executor ||
+                !executors.includes(executor) ||
+                (target.continuous ?? defaults?.continuous) === false ||
+                defaults?.readyWhen !== undefined) {
+                continue;
+            }
+            target.readyWhen = { signal: true };
+            if (onAdded?.(target, projectName, defaults) === false) {
+                delete target.readyWhen;
+                continue;
+            }
+            projectChanged = true;
+        }
+        if (projectChanged) {
+            (0, devkit_exports_1.updateProjectConfiguration)(tree, projectName, project);
+            changed = true;
+        }
+    }
+    if (!changed) {
+        return { skipAgentic: true };
+    }
+    await (0, format_files_1.formatFiles)(tree);
+}
+/**
+ * The `targetDefaults` Nx applies to a target, which leaves out the entries
+ * that run another executor or a command.
+ */
+function readApplicableTargetDefaults(targetName, executor, targetDefaults, projectName, projectNode) {
+    if (!targetDefaults) {
+        return null;
+    }
+    let compatibleDefaults = targetDefaults;
+    if (executor) {
+        // Nx selects the key first, then drops the entries that run something else.
+        // A dropped entry keeps its filter so that its key still wins over the rest.
+        compatibleDefaults = {};
+        for (const [key, value] of Object.entries(targetDefaults)) {
+            const entries = Array.isArray(value)
+                ? value
+                : [value];
+            compatibleDefaults[key] = entries.map((entry) => entry.command || (entry.executor && entry.executor !== executor)
+                ? { filter: entry.filter }
+                : entry);
+        }
+    }
+    return (0, target_defaults_utils_1.readTargetDefaultsForTarget)(targetName, compatibleDefaults, executor, {
+        projectName,
+        projectNode,
+    });
+}

package/dist/src/generators/plugin-migrations/conversion-warnings.d.ts

@@ -8,6 +8,11 @@ import type { TargetConfiguration } from 'nx/src/devkit-exports';
 export type PackageJsonIdentitySource = 'script' | 'nxTargets' | 'unparseable';
 /** A migrated target was left untouched because package.json authors its identity. */
 export declare function keptPreMigrationTargetWarning(targetName: string, projectName: string, source: PackageJsonIdentitySource): string;
+/** The plugin inferred no target for a migrated project, so it was not converted. */
+export declare function uninferredTargetWarning(targetName: string, projectName: string, root: string, rootInferred: boolean, errors: Array<{
+    file: string | null;
+    message: string;
+}>): string;
 /** A target's centralization was skipped before writing anything. */
 export declare function retainedResidualsWarning(targetNames: string[], reason: string): string;
 /** Projects whose target identity lives outside the plugin were not hoisted. */

package/dist/src/generators/plugin-migrations/conversion-warnings.js

@@ -6,6 +6,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.keptPreMigrationTargetWarning = keptPreMigrationTargetWarning;
+exports.uninferredTargetWarning = uninferredTargetWarning;
 exports.retainedResidualsWarning = retainedResidualsWarning;
 exports.excludedProjectsWarning = excludedProjectsWarning;
 exports.revertedTargetsWarning = revertedTargetsWarning;
@@ -26,6 +27,18 @@ function withCauses(errors) {
         ? ` The verification pass reported errors: ${errors.join('; ')}`
         : '';
 }
+/** The plugin inferred no target for a migrated project, so it was not converted. */
+function uninferredTargetWarning(targetName, projectName, root, rootInferred, errors) {
+    const cause = rootInferred
+        ? `the plugin inferred the project at ${root} without a "${targetName}" target. Check the plugin options`
+        : errors.length > 0
+            ? `the plugin failed to infer it: ${[
+                // Each inference option set reports the same failure again.
+                ...new Set(errors.map(({ file, message }) => file ? `${file}: ${message}` : message)),
+            ].join('; ')}. Fix the error`
+            : `the plugin found no config file it detects in ${root}. Rename the config file to one the plugin detects`;
+    return `convert-to-inferred left target "${targetName}" in project "${projectName}" on its executor because ${cause}, then rerun the migration to convert it.`;
+}
 /** A target's centralization was skipped before writing anything. */
 function retainedResidualsWarning(targetNames, reason) {
     return `convert-to-inferred retained full per-project configuration for target(s) ${targetNames.join(', ')} because ${reason}; no configuration was lost, but shared configuration remains duplicated.`;

package/dist/src/generators/plugin-migrations/executor-to-plugin-migrator.d.ts

@@ -227,6 +227,7 @@ export declare function inferOncePerOptionSet<T>(tree: Tree, pluginPath: string,
     rawMatchedConfigFiles: string[];
     inferredExecutors: Set<string>;
     inferredRoots: Set<string>;
+    createNodesErrors: CreateNodesFileError[];
 }>;
 /**
  * The set of project roots a generated `include` list scopes to, or `undefined`
@@ -276,4 +277,9 @@ export declare function harvestConfigurationErrors(e: ProjectConfigurationsError
  * migrated-root sets hold.
  */
 export declare function buildOwnerRootByPath(graphRoots: Iterable<string>, inferredRoots: Iterable<string>): Map<string, string>;
+interface CreateNodesFileError {
+    /** null when the plugin failed as a whole rather than on one file. */
+    file: string | null;
+    message: string;
+}
 export {};

package/dist/src/generators/plugin-migrations/executor-to-plugin-migrator.js

@@ -991,6 +991,7 @@ async function inferOncePerOptionSet(tree, pluginPath, createNodes, createNodesV
     const inferredRoots = new Set();
     const erroredConfigFiles = new Set();
     const inferredExecutors = new Set();
+    const createNodesErrors = [];
     if (scope.optionSetGroups.length === 0) {
         return {
             inferredTargetsByOptionSet,
@@ -999,6 +1000,7 @@ async function inferOncePerOptionSet(tree, pluginPath, createNodes, createNodesV
             erroredConfigFiles: [],
             inferredExecutors,
             inferredRoots,
+            createNodesErrors,
         };
     }
     global.NX_GRAPH_CREATION = true;
@@ -1006,10 +1008,11 @@ async function inferOncePerOptionSet(tree, pluginPath, createNodes, createNodesV
         for (const group of scope.optionSetGroups) {
             const inferredByRoot = new Map();
             inferredTargetsByOptionSet.set(group.id, inferredByRoot);
-            const { result, erroredConfigFiles: groupErroredConfigFiles } = await getCreateNodesResultsForPlugin(tree, { plugin: pluginPath, options: group.options }, pluginPath, createNodes, createNodesV2, nxJson);
+            const { result, erroredConfigFiles: groupErroredConfigFiles, createNodesErrors: groupCreateNodesErrors, } = await getCreateNodesResultsForPlugin(tree, { plugin: pluginPath, options: group.options }, pluginPath, createNodes, createNodesV2, nxJson);
             for (const file of groupErroredConfigFiles) {
                 erroredConfigFiles.add(file);
             }
+            createNodesErrors.push(...groupCreateNodesErrors);
             // The plugin's glob pattern is option-independent, so every option set
             // matches the same config files; union defensively.
             for (const file of result?.matchingProjectFiles ?? []) {
@@ -1084,6 +1087,7 @@ async function inferOncePerOptionSet(tree, pluginPath, createNodes, createNodesV
         erroredConfigFiles: [...erroredConfigFiles],
         inferredExecutors,
         inferredRoots,
+        createNodesErrors,
     };
 }
 /**
@@ -1554,7 +1558,11 @@ async function migrateProjects(tree, projectGraph, pluginPath, createNodes, crea
     const projectConfigsByName = (0, devkit_exports_1.getProjects)(tree);
     // Phase 1: Infer (once per distinct option set) for the whole workspace.
     const nxJson = (0, devkit_exports_1.readNxJson)(tree);
-    const { inferredTargetsByOptionSet, matchedConfigFiles, erroredConfigFiles: erroredConfigFilesFromInference, rawMatchedConfigFiles, inferredExecutors, inferredRoots, } = await inferOncePerOptionSet(tree, pluginPath, createNodes, createNodesV2, nxJson, scope);
+    const { inferredTargetsByOptionSet, matchedConfigFiles, erroredConfigFiles: erroredConfigFilesFromInference, rawMatchedConfigFiles, inferredExecutors, inferredRoots, createNodesErrors, } = await inferOncePerOptionSet(tree, pluginPath, createNodes, createNodesV2, nxJson, scope);
+    // Single-project mode keeps throwing, like its skip filters do.
+    if (!specificProjectToMigrate) {
+        dropUninferredTargets(scope, projectGraph, inferredTargetsByOptionSet, inferredRoots, createNodesErrors, logger ?? devkit_exports_1.logger);
+    }
     // Phase 2: Per-project residual (in-memory, no re-inference). Also captures
     // `baselineFinal` (the equivalence oracle consumed in Phase 4).
     const residualByProject = await computeResidualByProject(tree, projectGraph, scope, inferredTargetsByOptionSet, nxJson, projectConfigsByName);
@@ -1713,9 +1721,46 @@ rawMatchedConfigFiles) {
     spinner.updateText(`Migrations done`);
     (0, devkit_exports_1.updateNxJson)(tree, nxJson);
 }
+/**
+ * One project the plugin cannot infer (a config file it does not match or that
+ * fails to load) must not block converting the others. Its targets keep their
+ * executor and are named in a warning.
+ */
+function dropUninferredTargets(scope, projectGraph, inferredTargetsByOptionSet, inferredRoots, createNodesErrors, log) {
+    const ownerRootByPath = buildOwnerRootByPath(Object.values(projectGraph.nodes).map((node) => node.data.root), inferredRoots);
+    const keptProjects = new Set();
+    for (const executorScope of scope.executorScopes) {
+        for (const [targetName, projectNames] of executorScope.targetAndProjects) {
+            const optionSetId = executorScope.inferenceOptionSetIdsByTarget.get(targetName);
+            for (const projectName of projectNames) {
+                const root = projectGraph.nodes[projectName].data.root;
+                if (inferredTargetsByOptionSet
+                    .get(optionSetId)
+                    ?.get(root)
+                    ?.has(targetName)) {
+                    keptProjects.add(projectName);
+                    continue;
+                }
+                projectNames.delete(projectName);
+                log.warn((0, conversion_warnings_1.uninferredTargetWarning)(targetName, projectName, root, inferredRoots.has(root), createNodesErrors.filter(({ file }) => file === null ||
+                    (0, devkit_internals_1.findProjectForPath)(file, ownerRootByPath) === root)));
+            }
+            if (projectNames.size === 0) {
+                executorScope.targetAndProjects.delete(targetName);
+            }
+        }
+    }
+    scope.executorScopes = scope.executorScopes.filter((executorScope) => executorScope.targetAndProjects.size > 0);
+    for (const projectName of scope.pluginOptionsByProject.keys()) {
+        if (!keptProjects.has(projectName)) {
+            scope.pluginOptionsByProject.delete(projectName);
+        }
+    }
+}
 async function getCreateNodesResultsForPlugin(tree, pluginConfiguration, pluginPath, createNodes, createNodesV2, nxJson) {
     let projectConfigs;
     let erroredConfigFiles = [];
+    const createNodesErrors = [];
     try {
         const plugin = new devkit_internals_1.LoadedNxPlugin({ createNodes, createNodesV2, name: pluginPath }, pluginConfiguration);
         projectConfigs = await (0, devkit_internals_1.retrieveProjectConfigurations)({ specifiedPlugins: [plugin], defaultPlugins: [] }, tree.root, nxJson);
@@ -1728,10 +1773,20 @@ async function getCreateNodesResultsForPlugin(tree, pluginConfiguration, pluginP
             // sits outside them, so the plugin is never widened to a root it would
             // fail to infer (which the verification pass would otherwise revert).
             erroredConfigFiles = harvestConfigurationErrors(e).erroredConfigFiles;
+            for (const error of e.errors) {
+                if ((0, devkit_internals_1.isAggregateCreateNodesError)(error)) {
+                    for (const [file, fileError] of error.errors) {
+                        createNodesErrors.push({
+                            file,
+                            message: fileError?.message ?? String(fileError),
+                        });
+                    }
+                }
+            }
         }
         else {
             throw e;
         }
     }
-    return { result: projectConfigs, erroredConfigFiles };
+    return { result: projectConfigs, erroredConfigFiles, createNodesErrors };
 }

package/dist/src/utils/readiness.d.ts

@@ -0,0 +1,71 @@
+import { type AddressInfo } from 'net';
+/**
+ * The url of a server listening on `address`, for `emitReadySignal`. A
+ * wildcard address maps to localhost. Undefined for a socket or a pipe.
+ */
+export declare function getListeningUrl(address: AddressInfo | string | null | undefined, https: boolean): string | undefined;
+/**
+ * A `readyWhen` that calls `waitForDevServer` from `module` when the task
+ * runs, with the config's file name, when given, and then `literals` as its
+ * arguments.
+ */
+export declare function getReadyCheckReadyWhen(module: string, configFileName?: string, ...literals: string[]): {
+    command: string;
+    interval: number;
+};
+export type TaskOptions = Record<string, unknown> & {
+    cwd?: string;
+};
+/**
+ * The arguments run-commands passes the task's command, as the command
+ * receives them: built by run-commands' own code, then split the way the shell
+ * splits them. A `{args.*}` command gets them as if appended, which matches a
+ * command that passes each value to the flag of its name.
+ */
+export declare function getForwardedArgs(options: TaskOptions): string[];
+export interface CacArgsOptions {
+    /** Each short flag and the camel-case option it aliases, such as `{ c: 'config' }`. */
+    aliases?: Record<string, string>;
+    /** The flags that take no value, by any of their names. */
+    booleans?: string[];
+}
+/**
+ * The options a cac CLI, such as Rsbuild's or Rspack's, parses from `args`,
+ * before it applies option defaults and types. Ports cac's `mri()` step:
+ * - A flag takes the next argument as its value unless that starts with `-`.
+ * - A repeated flag collects its values in an array, and numeric values
+ *   become numbers.
+ * - Every alias takes the value of the alias given first.
+ * - The kebab-case and camel-case spellings of an option take the value of
+ *   the spelling that first appears last.
+ *
+ * Dotted names stay flat keys, where cac nests them.
+ */
+export declare function parseCacArgs(args: string[], { aliases, booleans }?: CacArgsOptions): Record<string, unknown>;
+/**
+ * The options a commander 12 command, such as the Rsbuild 1.0 and 1.1 CLI's,
+ * parses from `args`, by attribute name, given its option flags such as
+ * `'-o --open [url]'`. The last value of an option wins, and no defaults or
+ * custom argument parsers apply. Throws where the command exits instead: on an
+ * unknown option, `--help` included, or a missing value.
+ */
+export declare function parseCommanderArgs(args: string[], declarations: string[]): Record<string, string | true>;
+export interface ServerAddress {
+    port: number;
+    host?: string;
+}
+/**
+ * Where to probe a server, or null when its port is not a positive integer:
+ * a server that picks its port or listens on a socket can't be probed ahead.
+ */
+export declare function getServerAddress(port: unknown, host: unknown): ServerAddress | null;
+/**
+ * Runs a task-time readiness check. Reads the options the task runs with,
+ * moves to its cwd, where the CLI resolves its config, and waits until every
+ * address `resolveAddresses` returns accepts a TCP connection. Probes nothing
+ * when it returns null.
+ */
+export declare function runReadyCheck(resolveAddresses: (task: {
+    options: TaskOptions;
+    root: string;
+}) => Promise<ServerAddress[] | null>): Promise<void>;

package/dist/src/utils/readiness.js

@@ -0,0 +1,259 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getListeningUrl = getListeningUrl;
+exports.getReadyCheckReadyWhen = getReadyCheckReadyWhen;
+exports.getForwardedArgs = getForwardedArgs;
+exports.parseCacArgs = parseCacArgs;
+exports.parseCommanderArgs = parseCommanderArgs;
+exports.getServerAddress = getServerAddress;
+exports.runReadyCheck = runReadyCheck;
+const net_1 = require("net");
+const devkit_internals_1 = require("nx/src/devkit-internals");
+const path_1 = require("path");
+const split_shell_args_1 = require("./split-shell-args");
+/**
+ * The url of a server listening on `address`, for `emitReadySignal`. A
+ * wildcard address maps to localhost. Undefined for a socket or a pipe.
+ */
+function getListeningUrl(address, https) {
+    if (!address || typeof address === 'string') {
+        return undefined;
+    }
+    const host = address.address === '::' || address.address === '0.0.0.0'
+        ? 'localhost'
+        : address.family === 'IPv6'
+            ? `[${address.address}]`
+            : address.address;
+    return `${https ? 'https' : 'http'}://${host}:${address.port}/`;
+}
+/**
+ * A `readyWhen` that calls `waitForDevServer` from `module` when the task
+ * runs, with the config's file name, when given, and then `literals` as its
+ * arguments.
+ */
+function getReadyCheckReadyWhen(module, configFileName, ...literals) {
+    // Unquoted in the command, as no quoting works in every shell
+    if (configFileName !== undefined && !/^[\w.-]+$/.test(configFileName)) {
+        throw new Error(`Unsupported config file name: ${configFileName}`);
+    }
+    const args = [
+        ...(configFileName === undefined ? [] : ['process.argv[1]']),
+        ...literals.map((literal) => `'${literal}'`),
+    ].join(', ');
+    return {
+        command: `node -e "require('${module}').waitForDevServer(${args})"${configFileName === undefined ? '' : ` ${configFileName}`}`,
+        // Each attempt starts node, and loads the config when there is one
+        interval: 1000,
+    };
+}
+/**
+ * The arguments run-commands passes the task's command, as the command
+ * receives them: built by run-commands' own code, then split the way the shell
+ * splits them. A `{args.*}` command gets them as if appended, which matches a
+ * command that passes each value to the flag of its name.
+ */
+function getForwardedArgs(options) {
+    const commands = options.command
+        ? [{ command: [options.command].flat().join(' ') }]
+        : Array.isArray(options.commands)
+            ? options.commands.map((c) => typeof c === 'string' ? { command: c } : c)
+            : [];
+    // Which of several commands starts the server is unknown
+    const server = commands.length === 1 ? commands[0] : {};
+    const template = server.command?.includes('{args}') && !server.command.includes('{args.')
+        ? '{args}'
+        : '';
+    const forwarded = (0, devkit_internals_1.interpolateArgsIntoCommand)(template, (0, devkit_internals_1.normalizeRunCommandsArgs)({
+        ...options,
+        __unparsed__: Array.isArray(options.__unparsed__)
+            ? options.__unparsed__.map(String)
+            : [],
+    }), server.forwardAllArgs ?? options.forwardAllArgs ?? true);
+    return (0, split_shell_args_1.splitShellArgs)(forwarded);
+}
+/**
+ * The options a cac CLI, such as Rsbuild's or Rspack's, parses from `args`,
+ * before it applies option defaults and types. Ports cac's `mri()` step:
+ * - A flag takes the next argument as its value unless that starts with `-`.
+ * - A repeated flag collects its values in an array, and numeric values
+ *   become numbers.
+ * - Every alias takes the value of the alias given first.
+ * - The kebab-case and camel-case spellings of an option take the value of
+ *   the spelling that first appears last.
+ *
+ * Dotted names stay flat keys, where cac nests them.
+ */
+function parseCacArgs(args, { aliases = {}, booleans = [] } = {}) {
+    const aliasOf = new Map();
+    for (const [short, long] of Object.entries(aliases)) {
+        aliasOf.set(short, long).set(long, short);
+    }
+    const isBoolean = (name) => booleans.includes(name) || booleans.includes(aliasOf.get(name));
+    const parsed = {};
+    const add = (name, value) => {
+        const number = Number(value);
+        const typed = typeof value === 'boolean'
+            ? value
+            : isBoolean(name)
+                ? value !== 'false' && value !== ''
+                : Number.isFinite(number)
+                    ? number
+                    : value;
+        parsed[name] =
+            parsed[name] === undefined ? typed : [parsed[name], typed].flat();
+    };
+    let i = 0;
+    for (; i < args.length && args[i] !== '--'; i++) {
+        const arg = args[i];
+        const dashes = arg.match(/^-*/)[0].length;
+        if (dashes === 0)
+            continue;
+        if (arg.startsWith('no-', dashes)) {
+            parsed[arg.slice(dashes + 3)] = false;
+            continue;
+        }
+        const equals = arg.indexOf('=', dashes + 1);
+        const name = arg.slice(dashes, equals === -1 ? undefined : equals);
+        const value = (equals === -1 ? '' : arg.slice(equals + 1)) ||
+            i + 1 === args.length ||
+            args[i + 1].startsWith('-') ||
+            args[++i];
+        // `-abc` sets `a` and `b` and gives its value to `c`
+        const names = dashes === 2 ? [name] : [...name];
+        names.forEach((n, index) => add(n, index + 1 < names.length || value));
+    }
+    const synced = new Set();
+    for (const name of Object.keys(parsed)) {
+        const alias = aliasOf.get(name);
+        if (alias !== undefined && !synced.has(name)) {
+            parsed[alias] = parsed[name];
+            synced.add(alias);
+        }
+    }
+    const options = { '--': args.slice(i + 1) };
+    for (const [name, value] of Object.entries(parsed)) {
+        options[name.replace(/([a-z])-([a-z])/g, (_, a, b) => a + b.toUpperCase())] = value;
+    }
+    return options;
+}
+/**
+ * The options a commander 12 command, such as the Rsbuild 1.0 and 1.1 CLI's,
+ * parses from `args`, by attribute name, given its option flags such as
+ * `'-o --open [url]'`. The last value of an option wins, and no defaults or
+ * custom argument parsers apply. Throws where the command exits instead: on an
+ * unknown option, `--help` included, or a missing value.
+ */
+function parseCommanderArgs(args, declarations) {
+    const options = declarations.map((flags) => {
+        const names = flags.split(/[ |,]+/).filter((part) => part.startsWith('-'));
+        return {
+            flags,
+            names,
+            key: names
+                .at(-1)
+                .replace(/^-+/, '')
+                .split('-')
+                .reduce((key, word) => key + word[0].toUpperCase() + word.slice(1)),
+            required: flags.includes('<'),
+            optional: flags.includes('['),
+        };
+    });
+    const find = (flag) => options.find((o) => o.names.includes(flag));
+    const isOption = (arg) => arg.length > 1 && arg[0] === '-';
+    const parsed = {};
+    const rest = [...args];
+    while (rest.length > 0 && rest[0] !== '--') {
+        const arg = rest.shift();
+        let option = find(arg);
+        if (option?.required) {
+            if (rest.length === 0) {
+                throw new Error(`option '${option.flags}' argument missing`);
+            }
+            parsed[option.key] = rest.shift();
+        }
+        else if (option) {
+            parsed[option.key] =
+                option.optional && rest.length > 0 && !isOption(rest[0])
+                    ? rest.shift()
+                    : true;
+        }
+        else if (arg.length > 2 &&
+            arg[0] === '-' &&
+            arg[1] !== '-' &&
+            (option = find(arg.slice(0, 2)))) {
+            // `-abc` gives `a` the value `bc`, or sets it and goes on with `-bc`
+            if (option.required || option.optional) {
+                parsed[option.key] = arg.slice(2);
+            }
+            else {
+                parsed[option.key] = true;
+                rest.unshift(`-${arg.slice(2)}`);
+            }
+        }
+        else if (/^--[^=]+=/.test(arg) &&
+            (option = find(arg.slice(0, arg.indexOf('=')))) &&
+            (option.required || option.optional)) {
+            parsed[option.key] = arg.slice(arg.indexOf('=') + 1);
+        }
+        else if (isOption(arg)) {
+            throw new Error(`unknown option '${arg}'`);
+        }
+    }
+    return parsed;
+}
+// The probe reaches these on loopback
+const LOOPBACK_HOSTS = new Set(['', 'localhost', '0.0.0.0', '::']);
+/**
+ * Where to probe a server, or null when its port is not a positive integer:
+ * a server that picks its port or listens on a socket can't be probed ahead.
+ */
+function getServerAddress(port, host) {
+    const number = Number(port);
+    if (!Number.isInteger(number) || number <= 0)
+        return null;
+    return typeof host === 'string' && !LOOPBACK_HOSTS.has(host)
+        ? { port: number, host }
+        : { port: number };
+}
+/**
+ * Runs a task-time readiness check. Reads the options the task runs with,
+ * moves to its cwd, where the CLI resolves its config, and waits until every
+ * address `resolveAddresses` returns accepts a TCP connection. Probes nothing
+ * when it returns null.
+ */
+async function runReadyCheck(resolveAddresses) {
+    const options = readTaskOptions();
+    const root = (0, path_1.resolve)(options.cwd ?? '.');
+    process.chdir(root);
+    const addresses = await resolveAddresses({ options, root });
+    if (addresses) {
+        await Promise.all(addresses.map(waitForAddress));
+    }
+}
+function readTaskOptions() {
+    try {
+        return JSON.parse(process.env.NX_TASK_OPTIONS ?? '{}');
+    }
+    catch {
+        return {};
+    }
+}
+async function waitForAddress({ port, host }) {
+    const hosts = host ? [host] : ['127.0.0.1', '::1'];
+    while (!(await Promise.any(hosts.map((h) => connects(port, h))).catch(() => false))) {
+        await new Promise((r) => setTimeout(r, 250));
+    }
+}
+function connects(port, host) {
+    return new Promise((resolve, reject) => {
+        const socket = (0, net_1.createConnection)({ port, host });
+        socket.once('connect', () => {
+            socket.destroy();
+            resolve(true);
+        });
+        socket.once('error', (e) => {
+            socket.destroy();
+            reject(e);
+        });
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nx/devkit",
-  "version": "24.0.0-canary.20261019-c4bb923",
+  "version": "24.0.0-canary.20261020-e7ffd79",
   "private": false,
   "type": "commonjs",
   "files": [
@@ -67,7 +67,7 @@
   },
   "devDependencies": {
     "jest": "30.3.0",
-    "nx": "24.0.0-canary.20261019-c4bb923"
+    "nx": "24.0.0-canary.20261020-e7ffd79"
   },
   "peerDependencies": {
     "nx": ">= 23 <= 25 || ^24.0.0-0"