nx 19.7.0-beta.3 → 19.7.0-beta.4

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

@@ -103,6 +103,9 @@ async function runPublishOnProjects(args, projectGraph, nxJson, projectNames, is
     if (args.otp) {
         overrides.otp = args.otp;
     }
+    if (args.access) {
+        overrides.access = args.access;
+    }
     if (args.dryRun) {
         overrides.dryRun = args.dryRun;
         /**

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

@@ -94,7 +94,7 @@ function createAPI(overrideReleaseConfig) {
             output_1.output.error(filterError);
             process.exit(1);
         }
-        (0, version_plans_1.setResolvedVersionPlansOnGroups)(rawVersionPlans, releaseGroups, Object.keys(projectGraph.nodes));
+        await (0, version_plans_1.setResolvedVersionPlansOnGroups)(rawVersionPlans, releaseGroups, Object.keys(projectGraph.nodes), args.verbose);
         const planFiles = new Set();
         releaseGroups.forEach((group) => {
             if (group.resolvedVersionPlans) {

package/src/command-line/release/utils/get-touched-projects-for-group.d.ts

@@ -0,0 +1,7 @@
+import { FileData, ProjectGraph } from '../../../config/project-graph';
+import { NxArgs } from '../../../utils/command-line-utils';
+import { ReleaseGroupWithName } from '../config/filter-release-groups';
+/**
+ * Create a function that returns the touched projects for a given release group. Only relevant when version plans are enabled.
+ */
+export declare function createGetTouchedProjectsForGroup(nxArgs: NxArgs, projectGraph: ProjectGraph, changedFiles: string[], fileData: FileData[]): (releaseGroup: ReleaseGroupWithName, releaseGroupFilteredProjectNames: string[], hasProjectsFilter: boolean) => Promise<string[]>;

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

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createGetTouchedProjectsForGroup = createGetTouchedProjectsForGroup;
+const workspace_projects_1 = require("../../../project-graph/affected/locators/workspace-projects");
+const file_utils_1 = require("../../../project-graph/file-utils");
+const ignore_1 = require("../../../utils/ignore");
+const output_1 = require("../../../utils/output");
+const config_1 = require("../config/config");
+/**
+ * Create a function that returns the touched projects for a given release group. Only relevant when version plans are enabled.
+ */
+function createGetTouchedProjectsForGroup(nxArgs, projectGraph, changedFiles, fileData) {
+    /**
+     * Create a minimal subset of touched projects based on the configured ignore patterns, we only need
+     * to recompute when the ignorePatternsForPlanCheck differs between release groups.
+     */
+    const serializedIgnorePatternsToTouchedProjects = new Map();
+    return async function getTouchedProjectsForGroup(releaseGroup, 
+    // We don't access releaseGroups.projects directly, because we need to take the --projects filter into account
+    releaseGroupFilteredProjectNames, hasProjectsFilter) {
+        // The current release group doesn't leverage version plans
+        if (!releaseGroup.versionPlans) {
+            return [];
+        }
+        // Exclude patterns from .nxignore, .gitignore and explicit version plan config
+        let serializedIgnorePatterns = '[]';
+        const ignore = (0, ignore_1.getIgnoreObject)();
+        if (typeof releaseGroup.versionPlans !== 'boolean' &&
+            Array.isArray(releaseGroup.versionPlans.ignorePatternsForPlanCheck) &&
+            releaseGroup.versionPlans.ignorePatternsForPlanCheck.length) {
+            output_1.output.note({
+                title: `Applying configured ignore patterns to changed files${releaseGroup.name !== config_1.IMPLICIT_DEFAULT_RELEASE_GROUP
+                    ? ` for release group "${releaseGroup.name}"`
+                    : ''}`,
+                bodyLines: [
+                    ...releaseGroup.versionPlans.ignorePatternsForPlanCheck.map((pattern) => `  - ${pattern}`),
+                ],
+            });
+            ignore.add(releaseGroup.versionPlans.ignorePatternsForPlanCheck);
+            serializedIgnorePatterns = JSON.stringify(releaseGroup.versionPlans.ignorePatternsForPlanCheck);
+        }
+        let touchedProjects = {};
+        if (serializedIgnorePatternsToTouchedProjects.has(serializedIgnorePatterns)) {
+            touchedProjects = serializedIgnorePatternsToTouchedProjects.get(serializedIgnorePatterns);
+        }
+        else {
+            // We only care about directly touched projects, not implicitly affected ones etc
+            const touchedProjectsArr = await (0, workspace_projects_1.getTouchedProjects)((0, file_utils_1.calculateFileChanges)(changedFiles, fileData, nxArgs, undefined, ignore), projectGraph.nodes);
+            touchedProjects = touchedProjectsArr.reduce((acc, project) => ({ ...acc, [project]: true }), {});
+            serializedIgnorePatternsToTouchedProjects.set(serializedIgnorePatterns, touchedProjects);
+        }
+        const touchedProjectsUnderReleaseGroup = releaseGroupFilteredProjectNames.filter((project) => touchedProjects[project]);
+        if (touchedProjectsUnderReleaseGroup.length) {
+            output_1.output.log({
+                title: `Touched projects${hasProjectsFilter ? ` (after --projects filter applied)` : ''} based on changed files${releaseGroup.name !== config_1.IMPLICIT_DEFAULT_RELEASE_GROUP
+                    ? ` under release group "${releaseGroup.name}"`
+                    : ''}`,
+                bodyLines: [
+                    ...touchedProjectsUnderReleaseGroup.map((project) => `  - ${project}`),
+                    '',
+                    'NOTE: You can adjust your "versionPlans.ignorePatternsForPlanCheck" config to stop certain files from resulting in projects being classed as touched for the purposes of this command.',
+                ],
+            });
+        }
+        else {
+            output_1.output.log({
+                title: `No touched projects${hasProjectsFilter ? ` (after --projects filter applied)` : ''} found based on changed files${typeof releaseGroup.versionPlans !== 'boolean' &&
+                    Array.isArray(releaseGroup.versionPlans.ignorePatternsForPlanCheck) &&
+                    releaseGroup.versionPlans.ignorePatternsForPlanCheck.length
+                    ? ' combined with configured ignore patterns'
+                    : ''}${releaseGroup.name !== config_1.IMPLICIT_DEFAULT_RELEASE_GROUP
+                    ? ` under release group "${releaseGroup.name}"`
+                    : ''}`,
+            });
+        }
+        return touchedProjectsUnderReleaseGroup;
+    };
+}

package/src/command-line/release/utils/git.d.ts

@@ -62,6 +62,6 @@ export declare function parseConventionalCommitsMessage(message: string): {
     description: string;
     breaking: boolean;
 } | null;
-export declare function parseGitCommit(commit: RawGitCommit): GitCommit | null;
+export declare function parseGitCommit(commit: RawGitCommit, isVersionPlanCommit?: boolean): GitCommit | null;
 export declare function getCommitHash(ref: string): Promise<string>;
 export declare function getFirstGitCommit(): Promise<string>;

package/src/command-line/release/utils/git.js

@@ -136,7 +136,7 @@ async function gitAdd({ changedFiles, deletedFiles, dryRun, verbose, logFn, cwd,
                 ignoredFiles.push(f);
                 // git add will fail if trying to add an untracked file that doesn't exist
             }
-            else if (changedTrackedFiles.has(f)) {
+            else if (changedTrackedFiles.has(f) || dryRun) {
                 filesToAdd.push(f);
             }
         }
@@ -281,6 +281,30 @@ function parseConventionalCommitsMessage(message) {
         breaking: Boolean(match.groups.breaking),
     };
 }
+function extractReferencesFromCommitMessage(message, shortHash) {
+    const references = [];
+    for (const m of message.matchAll(PullRequestRE)) {
+        references.push({ type: 'pull-request', value: m[1] });
+    }
+    for (const m of message.matchAll(IssueRE)) {
+        if (!references.some((i) => i.value === m[1])) {
+            references.push({ type: 'issue', value: m[1] });
+        }
+    }
+    references.push({ value: shortHash, type: 'hash' });
+    return references;
+}
+function getAllAuthorsForCommit(commit) {
+    const authors = [commit.author];
+    // Additional authors can be specified in the commit body (depending on the VCS provider)
+    for (const match of commit.body.matchAll(CoAuthoredByRegex)) {
+        authors.push({
+            name: (match.groups.name || '').trim(),
+            email: (match.groups.email || '').trim(),
+        });
+    }
+    return authors;
+}
 // https://www.conventionalcommits.org/en/v1.0.0/
 // https://regex101.com/r/FSfNvA/1
 const ConventionalCommitRegex = /(?<type>[a-z]+)(\((?<scope>.+)\))?(?<breaking>!)?: (?<description>.+)/i;
@@ -289,7 +313,25 @@ const PullRequestRE = /\([ a-z]*(#\d+)\s*\)/gm;
 const IssueRE = /(#\d+)/gm;
 const ChangedFileRegex = /(A|M|D|R\d*|C\d*)\t([^\t\n]*)\t?(.*)?/gm;
 const RevertHashRE = /This reverts commit (?<hash>[\da-f]{40})./gm;
-function parseGitCommit(commit) {
+function parseGitCommit(commit, isVersionPlanCommit = false) {
+    // For version plans, we do not require conventional commits and therefore cannot extract data based on that format
+    if (isVersionPlanCommit) {
+        return {
+            ...commit,
+            description: commit.message,
+            type: '',
+            scope: '',
+            references: extractReferencesFromCommitMessage(commit.message, commit.shortHash),
+            // The commit message is not the source of truth for a breaking (major) change in version plans, so the value is not relevant
+            // TODO(v20): Make the current GitCommit interface more clearly tied to conventional commits
+            isBreaking: false,
+            authors: getAllAuthorsForCommit(commit),
+            // Not applicable to version plans
+            affectedFiles: [],
+            // Not applicable, a version plan cannot have been added in a commit that also reverts another commit
+            revertedHashes: [],
+        };
+    }
     const parsedMessage = parseConventionalCommitsMessage(commit.message);
     if (!parsedMessage) {
         return null;
@@ -298,16 +340,7 @@ function parseGitCommit(commit) {
     const isBreaking = parsedMessage.breaking || commit.body.includes('BREAKING CHANGE:');
     let description = parsedMessage.description;
     // Extract references from message
-    const references = [];
-    for (const m of description.matchAll(PullRequestRE)) {
-        references.push({ type: 'pull-request', value: m[1] });
-    }
-    for (const m of description.matchAll(IssueRE)) {
-        if (!references.some((i) => i.value === m[1])) {
-            references.push({ type: 'issue', value: m[1] });
-        }
-    }
-    references.push({ value: commit.shortHash, type: 'hash' });
+    const references = extractReferencesFromCommitMessage(description, commit.shortHash);
     // Remove references and normalize
     description = description.replace(PullRequestRE, '').trim();
     let type = parsedMessage.type;
@@ -322,13 +355,7 @@ function parseGitCommit(commit) {
         description = commit.message;
     }
     // Find all authors
-    const authors = [commit.author];
-    for (const match of commit.body.matchAll(CoAuthoredByRegex)) {
-        authors.push({
-            name: (match.groups.name || '').trim(),
-            email: (match.groups.email || '').trim(),
-        });
-    }
+    const authors = getAllAuthorsForCommit(commit);
     // Extract file changes from commit body
     const affectedFiles = Array.from(commit.body.matchAll(ChangedFileRegex)).reduce((prev, [fullLine, changeType, file1, file2]) => 
     // file2 only exists for some change types, such as renames

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

@@ -82,7 +82,7 @@ function createAPI(overrideReleaseConfig) {
         }
         if (!args.specifier) {
             const rawVersionPlans = await (0, version_plans_1.readRawVersionPlans)();
-            (0, version_plans_1.setResolvedVersionPlansOnGroups)(rawVersionPlans, releaseGroups, Object.keys(projectGraph.nodes));
+            await (0, version_plans_1.setResolvedVersionPlansOnGroups)(rawVersionPlans, releaseGroups, Object.keys(projectGraph.nodes), args.verbose);
         }
         else {
             if (args.verbose && releaseGroups.some((g) => !!g.versionPlans)) {

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.d.ts

@@ -3,7 +3,7 @@ interface ExcludeOptions {
     exclude: string[];
 }
 export declare const defaultYargsParserConfiguration: Partial<ParserConfigurationOptions>;
-export declare function withExcludeOption(yargs: Argv): Argv<ExcludeOptions>;
+export declare function withExcludeOption<T>(yargs: Argv<T>): Argv<T & ExcludeOptions>;
 export interface RunOptions {
     exclude: string;
     parallel: string;
@@ -20,6 +20,7 @@ export interface RunOptions {
     batch: boolean;
     useAgents: boolean;
     excludeTaskDependencies: boolean;
+    skipSync: boolean;
 }
 export declare function withRunOptions<T>(yargs: Argv<T>): Argv<T & RunOptions>;
 export declare function withTargetAndConfigurationOption(yargs: Argv, demandOption?: boolean): Argv<{

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,24 +61,29 @@ 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,
+    })
+        .option('skipSync', {
+        type: 'boolean',
+        // TODO(leo): add description and make it visible once it is stable
+        hidden: true,
     })
         .options('cloud', {
         type: 'boolean',
@@ -96,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,
@@ -107,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',
     });
@@ -115,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) => {
@@ -127,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';
         },
@@ -138,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,
     })
@@ -178,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.',
@@ -209,15 +214,7 @@ function withOutputStyleOption(yargs, choices = [
     'stream-without-prefixes',
 ]) {
     return yargs.option('output-style', {
-        describe: `Defines how Nx emits outputs tasks logs
-
-| option | description |
-| --- | --- |
-| dynamic | use dynamic output life cycle, previous content is overwritten or modified as new outputs are added, display minimal logs by default, always show errors. This output format is recommended on your local development environments. |
-| static | uses static output life cycle, no previous content is rewritten or modified as new outputs are added. This output format is recommened for CI environments. |
-| stream | nx by default logs output to an internal output stream, enable this option to stream logs to stdout / stderr |
-| stream-without-prefixes | nx prefixes the project name the target is running on, use this option remove the project name prefix from output |
-`,
+        describe: `Defines how Nx emits outputs tasks logs. **dynamic**: use dynamic output life cycle, previous content is overwritten or modified as new outputs are added, display minimal logs by default, always show errors. This output format is recommended on your local development environments. **static**: uses static output life cycle, no previous content is rewritten or modified as new outputs are added. This output format is recommened for CI environments. **stream**: nx by default logs output to an internal output stream, enable this option to stream logs to stdout / stderr. **stream-without-prefixes**: nx prefixes the project name the target is running on, use this option remove the project name prefix from output.`,
         type: 'string',
         choices,
     });
@@ -227,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) {