nx 19.7.0-canary.20240905-ccda7f9 → 19.7.0-canary.20240906-a3c2db8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nx",
-  "version": "19.7.0-canary.20240905-ccda7f9",
+  "version": "19.7.0-canary.20240906-a3c2db8",
   "private": false,
   "description": "The core Nx plugin contains the core functionality of Nx like the project graph, nx commands and task orchestration.",
   "repository": {
@@ -71,7 +71,7 @@
     "yargs-parser": "21.1.1",
     "node-machine-id": "1.1.12",
     "ora": "5.3.0",
-    "@nrwl/tao": "19.7.0-canary.20240905-ccda7f9"
+    "@nrwl/tao": "19.7.0-canary.20240906-a3c2db8"
   },
   "peerDependencies": {
     "@swc-node/register": "^1.8.0",
@@ -86,16 +86,16 @@
     }
   },
   "optionalDependencies": {
-    "@nx/nx-darwin-x64": "19.7.0-canary.20240905-ccda7f9",
-    "@nx/nx-darwin-arm64": "19.7.0-canary.20240905-ccda7f9",
-    "@nx/nx-linux-x64-gnu": "19.7.0-canary.20240905-ccda7f9",
-    "@nx/nx-linux-x64-musl": "19.7.0-canary.20240905-ccda7f9",
-    "@nx/nx-win32-x64-msvc": "19.7.0-canary.20240905-ccda7f9",
-    "@nx/nx-linux-arm64-gnu": "19.7.0-canary.20240905-ccda7f9",
-    "@nx/nx-linux-arm64-musl": "19.7.0-canary.20240905-ccda7f9",
-    "@nx/nx-linux-arm-gnueabihf": "19.7.0-canary.20240905-ccda7f9",
-    "@nx/nx-win32-arm64-msvc": "19.7.0-canary.20240905-ccda7f9",
-    "@nx/nx-freebsd-x64": "19.7.0-canary.20240905-ccda7f9"
+    "@nx/nx-darwin-x64": "19.7.0-canary.20240906-a3c2db8",
+    "@nx/nx-darwin-arm64": "19.7.0-canary.20240906-a3c2db8",
+    "@nx/nx-linux-x64-gnu": "19.7.0-canary.20240906-a3c2db8",
+    "@nx/nx-linux-x64-musl": "19.7.0-canary.20240906-a3c2db8",
+    "@nx/nx-win32-x64-msvc": "19.7.0-canary.20240906-a3c2db8",
+    "@nx/nx-linux-arm64-gnu": "19.7.0-canary.20240906-a3c2db8",
+    "@nx/nx-linux-arm64-musl": "19.7.0-canary.20240906-a3c2db8",
+    "@nx/nx-linux-arm-gnueabihf": "19.7.0-canary.20240906-a3c2db8",
+    "@nx/nx-win32-arm64-msvc": "19.7.0-canary.20240906-a3c2db8",
+    "@nx/nx-freebsd-x64": "19.7.0-canary.20240906-a3c2db8"
   },
   "nx-migrations": {
     "migrations": "./migrations.json",

package/src/command-line/add/command-object.js

@@ -12,11 +12,11 @@ exports.yargsAddCommand = {
     })
         .positional('packageSpecifier', {
         type: 'string',
-        description: 'The package name and optional version (e.g. `@nx/react` or `@nx/react@latest`) to install and initialize. If the version is not specified it will install the same version as the `nx` package for Nx core plugins or the latest version for other packages',
+        description: 'The package name and optional version (e.g. `@nx/react` or `@nx/react@latest`) to install and initialize. If the version is not specified it will install the same version as the `nx` package for Nx core plugins or the latest version for other packages.',
     })
         .option('updatePackageScripts', {
         type: 'boolean',
-        description: 'Update `package.json` scripts with inferred targets. Defaults to `true` when the package is a core Nx plugin',
+        description: 'Update `package.json` scripts with inferred targets. Defaults to `true` when the package is a core Nx plugin.',
     })
         .example('$0 add @nx/react', 'Install the latest version of the `@nx/react` package and run its `@nx/react:init` generator')
         .example('$0 add non-core-nx-plugin', 'Install the latest version of the `non-core-nx-plugin` package and run its `non-core-nx-plugin:init` generator if available')

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

@@ -6,7 +6,7 @@ const shared_options_1 = require("../yargs-utils/shared-options");
 const params_1 = require("../../utils/params");
 exports.yargsAffectedCommand = {
     command: 'affected',
-    describe: 'Run target for affected projects',
+    describe: 'Run target for affected projects.',
     builder: (yargs) => (0, documentation_1.linkToNxDevAndExamples)((0, shared_options_1.withAffectedOptions)((0, shared_options_1.withRunOptions)((0, shared_options_1.withOutputStyleOption)((0, shared_options_1.withTargetAndConfigurationOption)((0, shared_options_1.withBatch)(yargs)))))
         .option('all', {
         type: 'boolean',

package/src/command-line/connect/command-object.js

@@ -7,7 +7,7 @@ const shared_options_1 = require("../yargs-utils/shared-options");
 exports.yargsConnectCommand = {
     command: 'connect',
     aliases: ['connect-to-nx-cloud'],
-    describe: `Connect workspace to Nx Cloud`,
+    describe: `Connect workspace to Nx Cloud.`,
     builder: (yargs) => (0, documentation_1.linkToNxDevAndExamples)(withConnectOptions(yargs), 'connect-to-nx-cloud'),
     handler: async (args) => {
         await (await Promise.resolve().then(() => require('./connect-to-nx-cloud'))).connectToNxCloudCommand(args);
@@ -22,7 +22,7 @@ exports.yargsConnectCommand = {
 function withConnectOptions(yargs) {
     return (0, shared_options_1.withVerbose)(yargs).option('generateToken', {
         type: 'boolean',
-        description: 'Explicitly asks for a token to be created, do not override existing tokens from Nx Cloud',
+        description: 'Explicitly asks for a token to be created, do not override existing tokens from Nx Cloud.',
     });
 }
 exports.yargsViewLogsCommand = {

package/src/command-line/daemon/command-object.js

@@ -4,7 +4,7 @@ exports.yargsDaemonCommand = void 0;
 const documentation_1 = require("../yargs-utils/documentation");
 exports.yargsDaemonCommand = {
     command: 'daemon',
-    describe: 'Prints information about the Nx Daemon process or starts a daemon process',
+    describe: 'Prints information about the Nx Daemon process or starts a daemon process.',
     builder: (yargs) => (0, documentation_1.linkToNxDevAndExamples)(withDaemonOptions(yargs), 'daemon'),
     handler: async (args) => (await Promise.resolve().then(() => require('./daemon'))).daemonHandler(args),
 };

package/src/command-line/deprecated/command-objects.js

@@ -31,12 +31,12 @@ exports.yargsPrintAffectedCommand = {
     builder: (yargs) => (0, shared_options_1.withAffectedOptions)((0, shared_options_1.withTargetAndConfigurationOption)(yargs, false))
         .option('select', {
         type: 'string',
-        describe: 'Select the subset of the returned json document (e.g., --select=projects)',
+        describe: 'Select the subset of the returned json document (e.g., --select=projects).',
     })
         .option('type', {
         type: 'string',
         choices: ['app', 'lib'],
-        describe: 'Select the type of projects to be returned (e.g., --type=app)',
+        describe: 'Select the type of projects to be returned (e.g., --type=app).',
     }),
     handler: async (args) => {
         const exitCode = await (0, params_1.handleErrors)(false, () => {

package/src/command-line/exec/command-object.js

@@ -4,7 +4,7 @@ exports.yargsExecCommand = void 0;
 const shared_options_1 = require("../yargs-utils/shared-options");
 exports.yargsExecCommand = {
     command: 'exec',
-    describe: 'Executes any command as if it was a target on the project',
+    describe: 'Executes any command as if it was a target on the project.',
     builder: (yargs) => (0, shared_options_1.withRunManyOptions)(yargs),
     handler: async (args) => {
         try {

package/src/command-line/format/command-object.js

@@ -5,7 +5,7 @@ const documentation_1 = require("../yargs-utils/documentation");
 const shared_options_1 = require("../yargs-utils/shared-options");
 exports.yargsFormatCheckCommand = {
     command: 'format:check',
-    describe: 'Check for un-formatted files',
+    describe: 'Check for un-formatted files.',
     builder: (yargs) => (0, documentation_1.linkToNxDevAndExamples)(withFormatOptions(yargs), 'format:check'),
     handler: async (args) => {
         await (await Promise.resolve().then(() => require('./format'))).format('check', args);
@@ -14,7 +14,7 @@ exports.yargsFormatCheckCommand = {
 };
 exports.yargsFormatWriteCommand = {
     command: 'format:write',
-    describe: 'Overwrite un-formatted files',
+    describe: 'Overwrite un-formatted files.',
     aliases: ['format'],
     builder: (yargs) => (0, documentation_1.linkToNxDevAndExamples)(withFormatOptions(yargs), 'format:write'),
     handler: async (args) => {
@@ -32,12 +32,12 @@ function withFormatOptions(yargs) {
         type: 'boolean',
     })
         .option('projects', {
-        describe: 'Projects to format (comma/space delimited)',
+        describe: 'Projects to format (comma/space delimited).',
         type: 'string',
         coerce: shared_options_1.parseCSV,
     })
         .option('all', {
-        describe: 'Format all projects',
+        describe: 'Format all projects.',
         type: 'boolean',
     })
         .conflicts({

package/src/command-line/generate/command-object.js

@@ -18,23 +18,23 @@ function withGenerateOptions(yargs) {
     const generatorWillShowHelp = process.argv[3] && !process.argv[3].startsWith('-');
     const res = (0, shared_options_1.withVerbose)(yargs)
         .positional('generator', {
-        describe: 'Name of the generator (e.g., @nx/js:library, library)',
+        describe: 'Name of the generator (e.g., @nx/js:library, library).',
         type: 'string',
         required: true,
     })
         .option('dryRun', {
-        describe: 'Preview the changes without updating files',
+        describe: 'Preview the changes without updating files.',
         alias: 'd',
         type: 'boolean',
         default: false,
     })
         .option('interactive', {
-        describe: 'When false disables interactive input prompts for options',
+        describe: 'When false disables interactive input prompts for options.',
         type: 'boolean',
         default: true,
     })
         .option('quiet', {
-        describe: 'Hides logs from tree operations (e.g. `CREATE package.json`)',
+        describe: 'Hides logs from tree operations (e.g. `CREATE package.json`).',
         type: 'boolean',
         conflicts: ['verbose'],
     })

package/src/command-line/graph/command-object.js

@@ -6,12 +6,12 @@ const documentation_1 = require("../yargs-utils/documentation");
 const shared_options_1 = require("../yargs-utils/shared-options");
 exports.yargsGraphCommand = {
     command: 'graph',
-    describe: 'Graph dependencies within workspace',
+    describe: 'Graph dependencies within workspace.',
     aliases: ['dep-graph'],
     builder: (yargs) => (0, documentation_1.linkToNxDevAndExamples)((0, shared_options_1.withVerbose)((0, shared_options_1.withAffectedOptions)(withGraphOptions(yargs))), 'dep-graph')
         .option('affected', {
         type: 'boolean',
-        description: 'Highlight affected projects',
+        description: 'Highlight affected projects.',
     })
         .implies('untracked', 'affected')
         .implies('uncommitted', 'affected')
@@ -31,13 +31,13 @@ function withGraphOptions(yargs) {
         type: 'boolean',
     })
         .option('view', {
-        describe: 'Choose whether to view the projects or task graph',
+        describe: 'Choose whether to view the projects or task graph.',
         type: 'string',
         default: 'projects',
         choices: ['projects', 'tasks'],
     })
         .option('targets', {
-        describe: 'The target to show tasks for in the task graph',
+        describe: 'The target to show tasks for in the task graph.',
         type: 'string',
         coerce: shared_options_1.parseCSV,
     })
@@ -51,7 +51,7 @@ function withGraphOptions(yargs) {
         coerce: shared_options_1.parseCSV,
     })
         .option('groupByFolder', {
-        describe: 'Group projects by folder in the project graph',
+        describe: 'Group projects by folder in the project graph.',
         type: 'boolean',
     })
         .option('host', {
@@ -63,7 +63,7 @@ function withGraphOptions(yargs) {
         type: 'number',
     })
         .option('watch', {
-        describe: 'Watch for changes to project graph and update in-browser',
+        describe: 'Watch for changes to project graph and update in-browser.',
         type: 'boolean',
         default: true,
     })

package/src/command-line/import/command-object.js

@@ -10,27 +10,27 @@ exports.yargsImportCommand = {
     builder: (yargs) => (0, documentation_1.linkToNxDevAndExamples)((0, shared_options_1.withVerbose)(yargs
         .positional('sourceRemoteUrl', {
         type: 'string',
-        description: 'The remote URL of the source to import',
+        description: 'The remote URL of the source to import.',
     })
         .positional('destination', {
         type: 'string',
-        description: 'The directory in the current workspace to import into',
+        description: 'The directory in the current workspace to import into.',
     })
         .option('source', {
         type: 'string',
-        description: 'The directory in the source repository to import from',
+        description: 'The directory in the source repository to import from.',
     })
         .option('ref', {
         type: 'string',
-        description: 'The branch from the source repository to import',
+        description: 'The branch from the source repository to import.',
     })
         .option('depth', {
         type: 'number',
-        description: 'The depth to clone the source repository (limit this for faster git clone)',
+        description: 'The depth to clone the source repository (limit this for faster git clone).',
     })
         .option('interactive', {
         type: 'boolean',
-        description: 'Interactive mode',
+        description: 'Interactive mode.',
         default: true,
     })), 'import'),
     handler: async (args) => {

package/src/command-line/list/command-object.js

@@ -6,7 +6,7 @@ exports.yargsListCommand = {
     describe: 'Lists installed plugins, capabilities of installed plugins and other available plugins.',
     builder: (yargs) => yargs.positional('plugin', {
         type: 'string',
-        description: 'The name of an installed plugin to query',
+        description: 'The name of an installed plugin to query.',
     }),
     handler: async (args) => {
         await (await Promise.resolve().then(() => require('./list'))).listHandler(args);

package/src/command-line/login/command-object.js

@@ -4,7 +4,7 @@ exports.yargsLoginCommand = void 0;
 const shared_options_1 = require("../../command-line/yargs-utils/shared-options");
 exports.yargsLoginCommand = {
     command: 'login [nxCloudUrl]',
-    describe: false,
+    describe: 'Login to Nx Cloud. This command is an alias for [`nx-cloud login`](/ci/reference/nx-cloud-cli#npx-nxcloud-login).',
     builder: (yargs) => (0, shared_options_1.withVerbose)(yargs.positional('nxCloudUrl', {
         describe: 'The Nx Cloud URL of the instance you are trying to connect to. If no positional argument is provided, this command will connect to https://cloud.nx.app.',
         type: 'string',

package/src/command-line/logout/command-object.js

@@ -4,7 +4,7 @@ exports.yargsLogoutCommand = void 0;
 const shared_options_1 = require("../../command-line/yargs-utils/shared-options");
 exports.yargsLogoutCommand = {
     command: 'logout',
-    describe: false,
+    describe: 'Logout from Nx Cloud. This command is an alias for [`nx-cloud logout`](/ci/reference/nx-cloud-cli#npx-nxcloud-logout).',
     builder: (yargs) => (0, shared_options_1.withVerbose)(yargs),
     handler: async (args) => {
         process.exit(await (await Promise.resolve().then(() => require('./logout'))).logoutHandler(args));

package/src/command-line/migrate/command-object.js

@@ -30,44 +30,44 @@ function withMigrationOptions(yargs) {
     const defaultCommitPrefix = 'chore: [nx migration] ';
     return (0, shared_options_1.withVerbose)(yargs)
         .positional('packageAndVersion', {
-        describe: `The target package and version (e.g, @nx/workspace@16.0.0)`,
+        describe: `The target package and version (e.g, @nx/workspace@16.0.0).`,
         type: 'string',
     })
         .option('runMigrations', {
-        describe: `Execute migrations from a file (when the file isn't provided, execute migrations from migrations.json)`,
+        describe: `Execute migrations from a file (when the file isn't provided, execute migrations from migrations.json).`,
         type: 'string',
     })
         .option('ifExists', {
-        describe: `Run migrations only if the migrations file exists, if not continues successfully`,
+        describe: `Run migrations only if the migrations file exists, if not continues successfully.`,
         type: 'boolean',
         default: false,
     })
         .option('from', {
-        describe: 'Use the provided versions for packages instead of the ones installed in node_modules (e.g., --from="@nx/react@16.0.0,@nx/js@16.0.0")',
+        describe: 'Use the provided versions for packages instead of the ones installed in node_modules (e.g., --from="@nx/react@16.0.0,@nx/js@16.0.0").',
         type: 'string',
     })
         .option('to', {
-        describe: 'Use the provided versions for packages instead of the ones calculated by the migrator (e.g., --to="@nx/react@16.0.0,@nx/js@16.0.0")',
+        describe: 'Use the provided versions for packages instead of the ones calculated by the migrator (e.g., --to="@nx/react@16.0.0,@nx/js@16.0.0").',
         type: 'string',
     })
         .option('createCommits', {
-        describe: 'Automatically create a git commit after each migration runs',
+        describe: 'Automatically create a git commit after each migration runs.',
         type: 'boolean',
         alias: ['C'],
         default: false,
     })
         .option('commitPrefix', {
-        describe: 'Commit prefix to apply to the commit for each migration, when --create-commits is enabled',
+        describe: 'Commit prefix to apply to the commit for each migration, when --create-commits is enabled.',
         type: 'string',
         default: defaultCommitPrefix,
     })
         .option('interactive', {
-        describe: 'Enable prompts to confirm whether to collect optional package updates and migrations',
+        describe: 'Enable prompts to confirm whether to collect optional package updates and migrations.',
         type: 'boolean',
         default: false,
     })
         .option('excludeAppliedMigrations', {
-        describe: 'Exclude migrations that should have been applied on previous updates. To be used with --from',
+        describe: 'Exclude migrations that should have been applied on previous updates. To be used with --from.',
         type: 'boolean',
         default: false,
     })

package/src/command-line/new/command-object.js

@@ -13,12 +13,12 @@ exports.yargsNewCommand = {
 function withNewOptions(yargs) {
     return yargs
         .option('nxWorkspaceRoot', {
-        describe: 'The folder where the new workspace is going to be created',
+        describe: 'The folder where the new workspace is going to be created.',
         type: 'string',
         required: true,
     })
         .option('interactive', {
-        describe: 'When false disables interactive input prompts for options',
+        describe: 'When false disables interactive input prompts for options.',
         type: 'boolean',
         default: true,
     });

package/src/command-line/release/command-object.js

@@ -8,7 +8,7 @@ const logger_1 = require("../../utils/logger");
 const shared_options_1 = require("../yargs-utils/shared-options");
 exports.yargsReleaseCommand = {
     command: 'release',
-    describe: 'Orchestrate versioning and publishing of applications and libraries',
+    describe: 'Orchestrate versioning and publishing of applications and libraries.',
     builder: (yargs) => (0, shared_options_1.withVerbose)(yargs)
         .command(releaseCommand)
         .command(versionCommand)
@@ -29,10 +29,10 @@ exports.yargsReleaseCommand = {
         type: 'string',
         alias: 'p',
         coerce: shared_options_1.parseCSV,
-        describe: 'Projects to run. (comma/space delimited project names and/or patterns)',
+        describe: 'Projects to run. (comma/space delimited project names and/or patterns).',
     })
         .option('dry-run', {
-        describe: 'Preview the changes without updating files/creating releases',
+        describe: 'Preview the changes without updating files/creating releases.',
         alias: 'd',
         type: 'boolean',
         default: false,
@@ -40,7 +40,7 @@ exports.yargsReleaseCommand = {
         // NOTE: The camel case format is required for the coerce() function to be called correctly. It still supports --print-config casing.
         .option('printConfig', {
         type: 'string',
-        describe: 'Print the resolved nx release configuration that would be used for the current command and then exit',
+        describe: 'Print the resolved nx release configuration that would be used for the current command and then exit.',
         coerce: (val) => {
             if (val === '') {
                 return true;
@@ -72,7 +72,7 @@ exports.yargsReleaseCommand = {
 };
 const releaseCommand = {
     command: '$0 [specifier]',
-    describe: 'Create a version and release for the workspace, generate a changelog, and optionally publish the packages',
+    describe: 'Create a version and release for the workspace, generate a changelog, and optionally publish the packages.',
     builder: (yargs) => withFirstReleaseOptions(yargs)
         .positional('specifier', {
         type: 'string',
@@ -81,11 +81,11 @@ const releaseCommand = {
         .option('yes', {
         type: 'boolean',
         alias: 'y',
-        description: 'Automatically answer yes to the confirmation prompt for publishing',
+        description: 'Automatically answer yes to the confirmation prompt for publishing.',
     })
         .option('skip-publish', {
         type: 'boolean',
-        description: 'Skip publishing by automatically answering no to the confirmation prompt for publishing',
+        description: 'Skip publishing by automatically answering no to the confirmation prompt for publishing.',
     })
         .check((argv) => {
         if (argv.yes !== undefined && argv.skipPublish !== undefined) {
@@ -105,7 +105,7 @@ const releaseCommand = {
 const versionCommand = {
     command: 'version [specifier]',
     aliases: ['v'],
-    describe: 'Create a version and release for one or more applications and libraries',
+    describe: 'Create a version and release for one or more applications and libraries.',
     builder: (yargs) => withFirstReleaseOptions(withGitCommitAndGitTagOptions(yargs
         .positional('specifier', {
         type: 'string',
@@ -113,7 +113,7 @@ const versionCommand = {
     })
         .option('preid', {
         type: 'string',
-        describe: 'The optional prerelease identifier to apply to the version. This will only be applied in the case that the specifier argument has been set to `prerelease` OR when conventional commits are enabled, in which case it will modify the resolved specifier from conventional commits to be its prerelease equivalent. E.g. minor -> preminor',
+        describe: 'The optional prerelease identifier to apply to the version. This will only be applied in the case that the specifier argument has been set to `prerelease` OR when conventional commits are enabled, in which case it will modify the resolved specifier from conventional commits to be its prerelease equivalent. E.g. minor -> preminor.',
         default: '',
     })
         .option('stage-changes', {
@@ -132,32 +132,32 @@ const versionCommand = {
 const changelogCommand = {
     command: 'changelog [version]',
     aliases: ['c'],
-    describe: 'Generate a changelog for one or more projects, and optionally push to Github',
+    describe: 'Generate a changelog for one or more projects, and optionally push to Github.',
     builder: (yargs) => withFirstReleaseOptions(withGitCommitAndGitTagOptions(yargs
         // Disable default meaning of yargs version for this command
         .version(false)
         .positional('version', {
         type: 'string',
-        description: 'The version to create a Github release and changelog for',
+        description: 'The version to create a Github release and changelog for.',
     })
         .option('from', {
         type: 'string',
-        description: 'The git reference to use as the start of the changelog. If not set it will attempt to resolve the latest tag and use that',
+        description: 'The git reference to use as the start of the changelog. If not set it will attempt to resolve the latest tag and use that.',
     })
         .option('to', {
         type: 'string',
-        description: 'The git reference to use as the end of the changelog',
+        description: 'The git reference to use as the end of the changelog.',
         default: 'HEAD',
     })
         .option('interactive', {
         alias: 'i',
         type: 'string',
-        description: 'Interactively modify changelog markdown contents in your code editor before applying the changes. You can set it to be interactive for all changelogs, or only the workspace level, or only the project level',
+        description: 'Interactively modify changelog markdown contents in your code editor before applying the changes. You can set it to be interactive for all changelogs, or only the workspace level, or only the project level.',
         choices: ['all', 'workspace', 'projects'],
     })
         .option('git-remote', {
         type: 'string',
-        description: 'Alternate git remote in the form {user}/{repo} on which to create the Github release (useful for testing)',
+        description: 'Alternate git remote in the form {user}/{repo} on which to create the Github release (useful for testing).',
         default: 'origin',
     })
         .check((argv) => {
@@ -178,15 +178,15 @@ const changelogCommand = {
 const publishCommand = {
     command: 'publish',
     aliases: ['p'],
-    describe: 'Publish a versioned project to a registry',
+    describe: 'Publish a versioned project to a registry.',
     builder: (yargs) => withFirstReleaseOptions((0, shared_options_1.withRunManyOptions)((0, shared_options_1.withOutputStyleOption)(yargs))
         .option('registry', {
         type: 'string',
-        description: 'The registry to publish to',
+        description: 'The registry to publish to.',
     })
         .option('tag', {
         type: 'string',
-        description: 'The distribution tag to apply to the published package',
+        description: 'The distribution tag to apply to the published package.',
     })
         .option('access', {
         type: 'string',
@@ -195,7 +195,7 @@ const publishCommand = {
     })
         .option('otp', {
         type: 'number',
-        description: 'A one-time password for publishing to a registry that requires 2FA',
+        description: 'A one-time password for publishing to a registry that requires 2FA.',
     })),
     handler: async (args) => {
         const status = await (await Promise.resolve().then(() => require('./publish'))).releasePublishCLIHandler(coerceParallelOption((0, shared_options_1.withOverrides)(args, 2)));
@@ -208,7 +208,7 @@ const publishCommand = {
 const planCommand = {
     command: 'plan [bump]',
     aliases: ['pl'],
-    describe: 'Create a version plan file to specify the desired semver bump for one or more projects or groups, as well as the relevant changelog entry',
+    describe: 'Create a version plan file to specify the desired semver bump for one or more projects or groups, as well as the relevant changelog entry.',
     builder: (yargs) => (0, shared_options_1.withAffectedOptions)(yargs)
         .positional('bump', {
         type: 'string',
@@ -226,11 +226,11 @@ const planCommand = {
         .option('message', {
         type: 'string',
         alias: 'm',
-        describe: 'Custom message to use for the changelog entry',
+        describe: 'Custom message to use for the changelog entry.',
     })
         .option('onlyTouched', {
         type: 'boolean',
-        describe: 'Only include projects that have been affected by the current changes',
+        describe: 'Only include projects that have been affected by the current changes.',
         default: true,
     }),
     handler: async (args) => {
@@ -244,7 +244,7 @@ const planCommand = {
 };
 const planCheckCommand = {
     command: 'plan:check',
-    describe: 'Ensure that all touched projects have an applicable version plan created for them',
+    describe: 'Ensure that all touched projects have an applicable version plan created for them.',
     builder: (yargs) => (0, shared_options_1.withAffectedOptions)(yargs),
     handler: async (args) => {
         const release = await Promise.resolve().then(() => require('./plan-check'));
@@ -261,7 +261,7 @@ function coerceParallelOption(args) {
 function withGitCommitAndGitTagOptions(yargs) {
     return yargs
         .option('git-commit', {
-        describe: 'Whether or not to automatically commit the changes made by this command',
+        describe: 'Whether or not to automatically commit the changes made by this command.',
         type: 'boolean',
     })
         .option('git-commit-message', {
@@ -269,11 +269,11 @@ function withGitCommitAndGitTagOptions(yargs) {
         type: 'string',
     })
         .option('git-commit-args', {
-        describe: 'Additional arguments (added after the --message argument, which may or may not be customized with --git-commit-message) to pass to the `git commit` command invoked behind the scenes',
+        describe: 'Additional arguments (added after the --message argument, which may or may not be customized with --git-commit-message) to pass to the `git commit` command invoked behind the scenes.',
         type: 'string',
     })
         .option('git-tag', {
-        describe: 'Whether or not to automatically tag the changes made by this command',
+        describe: 'Whether or not to automatically tag the changes made by this command.',
         type: 'boolean',
     })
         .option('git-tag-message', {
@@ -281,7 +281,7 @@ function withGitCommitAndGitTagOptions(yargs) {
         type: 'string',
     })
         .option('git-tag-args', {
-        describe: 'Additional arguments to pass to the `git tag` command invoked behind the scenes',
+        describe: 'Additional arguments to pass to the `git tag` command invoked behind the scenes.',
         type: 'string',
     })
         .option('stage-changes', {

package/src/command-line/report/command-object.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.yargsReportCommand = void 0;
 exports.yargsReportCommand = {
     command: 'report',
-    describe: 'Reports useful version numbers to copy into the Nx issue template',
+    describe: 'Reports useful version numbers to copy into the Nx issue template.',
     handler: async () => {
         await (await Promise.resolve().then(() => require('./report'))).reportHandler();
         process.exit(0);

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

@@ -19,7 +19,7 @@ exports.yargsResetCommand = {
         type: 'boolean',
     })
         .option('onlyWorkspaceData', {
-        description: 'Clears the workspace data directory. Used by Nx to store cached data about the current workspace (e.g. partial results, incremental data, etc)',
+        description: 'Clears the workspace data directory. Used by Nx to store cached data about the current workspace (e.g. partial results, incremental data, etc).',
         type: 'boolean',
     }),
     handler: async (argv) => (await Promise.resolve().then(() => require('./reset'))).resetHandler(argv),

package/src/command-line/run/command-object.js

@@ -27,7 +27,7 @@ exports.yargsRunCommand = {
 exports.yargsNxInfixCommand = {
     ...exports.yargsRunCommand,
     command: '$0 <target> [project] [_..]',
-    describe: 'Run a target for a project',
+    describe: 'Run a target for a project.',
     handler: async (args) => {
         const exitCode = await (0, params_1.handleErrors)(args.verbose ?? process.env.NX_VERBOSE_LOGGING === 'true', async () => {
             // Yargs parses <target> as 'undefined' if running just 'nx'

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

@@ -6,7 +6,7 @@ const shared_options_1 = require("../yargs-utils/shared-options");
 const params_1 = require("../../utils/params");
 exports.yargsRunManyCommand = {
     command: 'run-many',
-    describe: 'Run target for multiple listed projects',
+    describe: 'Run target for multiple listed projects.',
     builder: (yargs) => (0, documentation_1.linkToNxDevAndExamples)((0, shared_options_1.withRunManyOptions)((0, shared_options_1.withOutputStyleOption)((0, shared_options_1.withTargetAndConfigurationOption)((0, shared_options_1.withBatch)(yargs)))), 'run-many'),
     handler: async (args) => {
         const exitCode = await (0, params_1.handleErrors)(args.verbose ?? process.env.NX_VERBOSE_LOGGING === 'true', async () => {

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

@@ -6,14 +6,14 @@ const shared_options_1 = require("../yargs-utils/shared-options");
 const params_1 = require("../../utils/params");
 exports.yargsShowCommand = {
     command: 'show',
-    describe: 'Show information about the workspace (e.g., list of projects)',
+    describe: 'Show information about the workspace (e.g., list of projects).',
     builder: (yargs) => yargs
         .command(showProjectsCommand)
         .command(showProjectCommand)
         .demandCommand()
         .option('json', {
         type: 'boolean',
-        description: 'Output JSON',
+        description: 'Output JSON.',
     })
         .example('$0 show projects', 'Show a list of all projects in the workspace')
         .example('$0 show projects --with-target serve', 'Show a list of all projects in the workspace that have a "serve" target')
@@ -25,11 +25,11 @@ exports.yargsShowCommand = {
 };
 const showProjectsCommand = {
     command: 'projects',
-    describe: 'Show a list of projects in the workspace',
+    describe: 'Show a list of projects in the workspace.',
     builder: (yargs) => (0, shared_options_1.withVerbose)((0, shared_options_1.withAffectedOptions)(yargs))
         .option('affected', {
         type: 'boolean',
-        description: 'Show only affected projects',
+        description: 'Show only affected projects.',
     })
         .option('projects', {
         type: 'string',
@@ -40,17 +40,17 @@ const showProjectsCommand = {
         .option('withTarget', {
         type: 'string',
         alias: ['t'],
-        description: 'Show only projects that have a specific target',
+        description: 'Show only projects that have a specific target.',
         coerce: shared_options_1.parseCSV,
     })
         .option('type', {
         type: 'string',
-        description: 'Select only projects of the given type',
+        description: 'Select only projects of the given type.',
         choices: ['app', 'lib', 'e2e'],
     })
         .option('sep', {
         type: 'string',
-        description: 'Outputs projects with the specified seperator',
+        description: 'Outputs projects with the specified seperator.',
     })
         .implies('untracked', 'affected')
         .implies('uncommitted', 'affected')
@@ -79,15 +79,15 @@ const showProjectCommand = {
         .positional('projectName', {
         type: 'string',
         alias: 'p',
-        description: 'Which project should be viewed?',
+        description: 'Which project should be viewed?.',
     })
         .option('web', {
         type: 'boolean',
-        description: 'Show project details in the browser. (default when interactive)',
+        description: 'Show project details in the browser. (default when interactive).',
     })
         .option('open', {
         type: 'boolean',
-        description: 'Set to false to prevent the browser from opening when using --web',
+        description: 'Set to false to prevent the browser from opening when using --web.',
         implies: 'web',
     })
         .check((argv) => {

package/src/command-line/watch/command-object.js

@@ -5,7 +5,7 @@ const documentation_1 = require("../yargs-utils/documentation");
 const shared_options_1 = require("../yargs-utils/shared-options");
 exports.yargsWatchCommand = {
     command: 'watch',
-    describe: 'Watch for changes within projects, and execute commands',
+    describe: 'Watch for changes within projects, and execute commands.',
     builder: (yargs) => (0, documentation_1.linkToNxDevAndExamples)(withWatchOptions(yargs), 'watch'),
     handler: async (args) => {
         await Promise.resolve().then(() => require('./watch')).then((m) => m.watch(args));

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

@@ -22,7 +22,7 @@ exports.defaultYargsParserConfiguration = {
 };
 function withExcludeOption(yargs) {
     return yargs.option('exclude', {
-        describe: 'Exclude certain projects from being processed',
+        describe: 'Exclude certain projects from being processed.',
         type: 'string',
         coerce: parseCSV,
     });
@@ -30,7 +30,7 @@ function withExcludeOption(yargs) {
 function withRunOptions(yargs) {
     return withVerbose(withExcludeOption(yargs))
         .option('parallel', {
-        describe: 'Max number of parallel processes [default is 3]',
+        describe: 'Max number of parallel processes [default is 3].',
         type: 'string',
     })
         .option('maxParallel', {
@@ -38,11 +38,11 @@ function withRunOptions(yargs) {
         hidden: true,
     })
         .options('runner', {
-        describe: 'This is the name of the tasks runner configured in nx.json',
+        describe: 'This is the name of the tasks runner configured in nx.json.',
         type: 'string',
     })
         .option('prod', {
-        describe: 'Use the production configuration',
+        describe: 'Use the production configuration.',
         type: 'boolean',
         default: false,
         hidden: true,
@@ -61,22 +61,22 @@ function withRunOptions(yargs) {
                 : value,
     })
         .option('nxBail', {
-        describe: 'Stop command execution after the first failed task',
+        describe: 'Stop command execution after the first failed task.',
         type: 'boolean',
         default: false,
     })
         .option('nxIgnoreCycles', {
-        describe: 'Ignore cycles in the task graph',
+        describe: 'Ignore cycles in the task graph.',
         type: 'boolean',
         default: false,
     })
         .options('skipNxCache', {
-        describe: 'Rerun the tasks even when the results are available in the cache',
+        describe: 'Rerun the tasks even when the results are available in the cache.',
         type: 'boolean',
         default: false,
     })
         .options('excludeTaskDependencies', {
-        describe: 'Skips running dependent tasks first',
+        describe: 'Skips running dependent tasks first.',
         type: 'boolean',
         default: false,
     })
@@ -101,7 +101,7 @@ function withRunOptions(yargs) {
 }
 function withTargetAndConfigurationOption(yargs, demandOption = true) {
     return withConfiguration(yargs).option('targets', {
-        describe: 'Tasks to run for affected projects',
+        describe: 'Tasks to run for affected projects.',
         type: 'string',
         alias: ['target', 't'],
         requiresArg: true,
@@ -112,7 +112,7 @@ function withTargetAndConfigurationOption(yargs, demandOption = true) {
 }
 function withConfiguration(yargs) {
     return yargs.options('configuration', {
-        describe: 'This is the configuration to use when performing tasks on projects',
+        describe: 'This is the configuration to use when performing tasks on projects.',
         type: 'string',
         alias: 'c',
     });
@@ -120,7 +120,7 @@ function withConfiguration(yargs) {
 function withVerbose(yargs) {
     return yargs
         .option('verbose', {
-        describe: 'Prints additional information about the commands (e.g., stack traces)',
+        describe: 'Prints additional information about the commands (e.g., stack traces).',
         type: 'boolean',
     })
         .middleware((args) => {
@@ -132,7 +132,7 @@ function withVerbose(yargs) {
 function withBatch(yargs) {
     return yargs.options('batch', {
         type: 'boolean',
-        describe: 'Run task(s) in batches for executors which support batches',
+        describe: 'Run task(s) in batches for executors which support batches.',
         coerce: (v) => {
             return v || process.env.NX_BATCH_MODE === 'true';
         },
@@ -143,26 +143,26 @@ function withAffectedOptions(yargs) {
     return withExcludeOption(yargs)
         .parserConfiguration(exports.defaultYargsParserConfiguration)
         .option('files', {
-        describe: 'Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas or spaces',
+        describe: 'Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas or spaces.',
         type: 'string',
         requiresArg: true,
         coerce: parseCSV,
     })
         .option('uncommitted', {
-        describe: 'Uncommitted changes',
+        describe: 'Uncommitted changes.',
         type: 'boolean',
     })
         .option('untracked', {
-        describe: 'Untracked changes',
+        describe: 'Untracked changes.',
         type: 'boolean',
     })
         .option('base', {
-        describe: 'Base of the current branch (usually main)',
+        describe: 'Base of the current branch (usually main).',
         type: 'string',
         requiresArg: true,
     })
         .option('head', {
-        describe: 'Latest commit of the current branch (usually HEAD)',
+        describe: 'Latest commit of the current branch (usually HEAD).',
         type: 'string',
         requiresArg: true,
     })
@@ -183,7 +183,7 @@ function withRunManyOptions(yargs) {
         type: 'string',
         alias: 'p',
         coerce: parseCSV,
-        describe: 'Projects to run. (comma/space delimited project names and/or patterns)',
+        describe: 'Projects to run. (comma/space delimited project names and/or patterns).',
     })
         .option('all', {
         describe: '[deprecated] `run-many` runs all targets on all projects in the workspace if no projects are provided. This option is no longer required.',
@@ -224,11 +224,11 @@ function withRunOneOptions(yargs) {
     const res = withRunOptions(withOutputStyleOption(withConfiguration(yargs), allOutputStyles))
         .parserConfiguration(exports.defaultYargsParserConfiguration)
         .option('project', {
-        describe: 'Target project',
+        describe: 'Target project.',
         type: 'string',
     })
         .option('help', {
-        describe: 'Show Help',
+        describe: 'Show Help.',
         type: 'boolean',
     });
     if (executorShouldShowHelp) {

package/src/nx-cloud/generators/connect-to-nx-cloud/connect-to-nx-cloud.js

@@ -42,18 +42,6 @@ function getNxInitDate() {
         return null;
     }
 }
-async function createNxCloudWorkspaceV1(workspaceName, installationSource, nxInitDate) {
-    const apiUrl = (0, get_cloud_options_1.getCloudUrl)();
-    const response = await require('axios').post(`${apiUrl}/nx-cloud/create-org-and-workspace`, {
-        workspaceName,
-        installationSource,
-        nxInitDate,
-    });
-    if (response.data.message) {
-        throw new Error(response.data.message);
-    }
-    return response.data;
-}
 async function createNxCloudWorkspaceV2(workspaceName, installationSource, nxInitDate) {
     const apiUrl = (0, get_cloud_options_1.getCloudUrl)();
     const response = await require('axios').post(`${apiUrl}/nx-cloud/v2/create-org-and-workspace`, {
@@ -81,19 +69,6 @@ async function printSuccessMessage(token, installationSource, usesGithub) {
     });
     return connectCloudUrl;
 }
-function addNxCloudOptionsToNxJson(tree, token, directory = '') {
-    const nxJsonPath = (0, path_1.join)(directory, 'nx.json');
-    if (tree.exists(nxJsonPath)) {
-        (0, json_1.updateJson)(tree, (0, path_1.join)(directory, 'nx.json'), (nxJson) => {
-            const overrideUrl = process.env.NX_CLOUD_API || process.env.NRWL_API;
-            if (overrideUrl) {
-                nxJson.nxCloudUrl = overrideUrl;
-            }
-            nxJson.nxCloudAccessToken = token;
-            return nxJson;
-        });
-    }
-}
 function addNxCloudIdToNxJson(tree, nxCloudId, directory = '') {
     const nxJsonPath = (0, path_1.join)(directory, 'nx.json');
     if (tree.exists(nxJsonPath)) {
@@ -124,22 +99,12 @@ async function connectToNxCloud(tree, schema, nxJson = (0, nx_json_1.readNxJson)
         isGitHubDetected &&
         schema.installationSource === 'nx-connect')
         return null;
-    if (process.env.NX_ENABLE_LOGIN === 'true') {
-        responseFromCreateNxCloudWorkspaceV2 = await createNxCloudWorkspaceV2(getRootPackageName(tree), schema.installationSource, getNxInitDate());
-        addNxCloudIdToNxJson(tree, responseFromCreateNxCloudWorkspaceV2?.nxCloudId, schema.directory);
-        await (0, format_changed_files_with_prettier_if_available_1.formatChangedFilesWithPrettierIfAvailable)(tree, {
-            silent: schema.hideFormatLogs,
-        });
-        return responseFromCreateNxCloudWorkspaceV2.nxCloudId;
-    }
-    else {
-        responseFromCreateNxCloudWorkspaceV1 = await createNxCloudWorkspaceV1(getRootPackageName(tree), schema.installationSource, getNxInitDate());
-        addNxCloudOptionsToNxJson(tree, responseFromCreateNxCloudWorkspaceV1?.token, schema.directory);
-        await (0, format_changed_files_with_prettier_if_available_1.formatChangedFilesWithPrettierIfAvailable)(tree, {
-            silent: schema.hideFormatLogs,
-        });
-        return responseFromCreateNxCloudWorkspaceV1.token;
-    }
+    responseFromCreateNxCloudWorkspaceV2 = await createNxCloudWorkspaceV2(getRootPackageName(tree), schema.installationSource, getNxInitDate());
+    addNxCloudIdToNxJson(tree, responseFromCreateNxCloudWorkspaceV2?.nxCloudId, schema.directory);
+    await (0, format_changed_files_with_prettier_if_available_1.formatChangedFilesWithPrettierIfAvailable)(tree, {
+        silent: schema.hideFormatLogs,
+    });
+    return responseFromCreateNxCloudWorkspaceV2.nxCloudId;
 }
 async function connectToNxCloudGenerator(tree, options) {
     await connectToNxCloud(tree, options);

package/src/tasks-runner/cache.d.ts

@@ -10,6 +10,7 @@ export type TaskWithCachedResult = {
     task: Task;
     cachedResult: CachedResult;
 };
+export declare function getCache(options: DefaultTasksRunnerOptions): DbCache | Cache;
 export declare class DbCache {
     private readonly options;
     private cache;
@@ -20,6 +21,7 @@ export declare class DbCache {
         nxCloudRemoteCache: RemoteCache;
     });
     get(task: Task): Promise<CachedResult | null>;
+    private applyRemoteCacheResults;
     put(task: Task, terminalOutput: string | null, outputs: string[], code: number): Promise<void>;
     copyFilesFromCache(_: string, cachedResult: CachedResult, outputs: string[]): Promise<void>;
     removeOldCacheRecords(): void;

package/src/tasks-runner/cache.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Cache = exports.DbCache = void 0;
+exports.getCache = getCache;
 const workspace_root_1 = require("../utils/workspace-root");
 const fs_extra_1 = require("fs-extra");
 const path_1 = require("path");
@@ -15,6 +16,16 @@ const nx_cloud_utils_1 = require("../utils/nx-cloud-utils");
 const nx_json_1 = require("../config/nx-json");
 const update_manager_1 = require("../nx-cloud/update-manager");
 const get_cloud_options_1 = require("../nx-cloud/utilities/get-cloud-options");
+function getCache(options) {
+    return process.env.NX_DB_CACHE === 'true'
+        ? new DbCache({
+            // Remove this in Nx 21
+            nxCloudRemoteCache: (0, nx_cloud_utils_1.isNxCloudUsed)((0, nx_json_1.readNxJson)())
+                ? options.remoteCache
+                : null,
+        })
+        : new Cache(options);
+}
 class DbCache {
     async setup() {
         this.remoteCache = await this.getRemoteCache();
@@ -37,7 +48,7 @@ class DbCache {
             // attempt remote cache
             const res = await this.remoteCache.retrieve(task.hash, this.cache.cacheDirectory);
             if (res) {
-                this.cache.applyRemoteCacheResults(task.hash, res);
+                this.applyRemoteCacheResults(task.hash, res);
                 return {
                     ...res,
                     remote: true,
@@ -51,6 +62,9 @@ class DbCache {
             return null;
         }
     }
+    applyRemoteCacheResults(hash, res) {
+        return this.cache.applyRemoteCacheResults(hash, res);
+    }
     async put(task, terminalOutput, outputs, code) {
         return tryAndRetry(async () => {
             this.cache.put(task.hash, terminalOutput, outputs, code);

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

@@ -15,8 +15,6 @@ const task_env_1 = require("./task-env");
 const workspace_root_1 = require("../utils/workspace-root");
 const output_1 = require("../utils/output");
 const params_1 = require("../utils/params");
-const nx_cloud_utils_1 = require("../utils/nx-cloud-utils");
-const nx_json_1 = require("../config/nx-json");
 class TaskOrchestrator {
     // endregion internal state
     constructor(hasher, initiatingProject, projectGraph, taskGraph, options, bail, daemon, outputStyle) {
@@ -28,14 +26,7 @@ class TaskOrchestrator {
         this.bail = bail;
         this.daemon = daemon;
         this.outputStyle = outputStyle;
-        this.cache = process.env.NX_DB_CACHE === 'true'
-            ? new cache_1.DbCache({
-                // Remove this in Nx 21
-                nxCloudRemoteCache: (0, nx_cloud_utils_1.isNxCloudUsed)((0, nx_json_1.readNxJson)())
-                    ? this.options.remoteCache
-                    : null,
-            })
-            : new cache_1.Cache(this.options);
+        this.cache = (0, cache_1.getCache)(this.options);
         this.forkedProcessTaskRunner = new forked_process_task_runner_1.ForkedProcessTaskRunner(this.options);
         this.tasksSchedule = new tasks_schedule_1.TasksSchedule(this.projectGraph, this.taskGraph, this.options);
         // region internal state