nx 19.7.0-beta.3 → 19.7.0-beta.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nx",
-  "version": "19.7.0-beta.3",
+  "version": "19.7.0-beta.5",
   "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-beta.3"
+    "@nrwl/tao": "19.7.0-beta.5"
   },
   "peerDependencies": {
     "@swc-node/register": "^1.8.0",
@@ -86,16 +86,16 @@
     }
   },
   "optionalDependencies": {
-    "@nx/nx-darwin-x64": "19.7.0-beta.3",
-    "@nx/nx-darwin-arm64": "19.7.0-beta.3",
-    "@nx/nx-linux-x64-gnu": "19.7.0-beta.3",
-    "@nx/nx-linux-x64-musl": "19.7.0-beta.3",
-    "@nx/nx-win32-x64-msvc": "19.7.0-beta.3",
-    "@nx/nx-linux-arm64-gnu": "19.7.0-beta.3",
-    "@nx/nx-linux-arm64-musl": "19.7.0-beta.3",
-    "@nx/nx-linux-arm-gnueabihf": "19.7.0-beta.3",
-    "@nx/nx-win32-arm64-msvc": "19.7.0-beta.3",
-    "@nx/nx-freebsd-x64": "19.7.0-beta.3"
+    "@nx/nx-darwin-x64": "19.7.0-beta.5",
+    "@nx/nx-darwin-arm64": "19.7.0-beta.5",
+    "@nx/nx-linux-x64-gnu": "19.7.0-beta.5",
+    "@nx/nx-linux-x64-musl": "19.7.0-beta.5",
+    "@nx/nx-win32-x64-msvc": "19.7.0-beta.5",
+    "@nx/nx-linux-arm64-gnu": "19.7.0-beta.5",
+    "@nx/nx-linux-arm64-musl": "19.7.0-beta.5",
+    "@nx/nx-linux-arm-gnueabihf": "19.7.0-beta.5",
+    "@nx/nx-win32-arm64-msvc": "19.7.0-beta.5",
+    "@nx/nx-freebsd-x64": "19.7.0-beta.5"
   },
   "nx-migrations": {
     "migrations": "./migrations.json",

package/release/changelog-renderer/index.d.ts

@@ -41,7 +41,7 @@ export type ChangelogRenderer = (config: {
     changelogRenderOptions: DefaultChangelogRenderOptions;
     dependencyBumps?: DependencyBump[];
     repoSlug?: RepoSlug;
-    conventionalCommitsConfig: NxReleaseConfig['conventionalCommits'];
+    conventionalCommitsConfig: NxReleaseConfig['conventionalCommits'] | null;
 }) => Promise<string> | string;
 /**
  * The specific options available to the default implementation of the ChangelogRenderer that nx exports

package/release/changelog-renderer/index.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const semver_1 = require("semver");
+const conventional_commits_1 = require("../../src/command-line/release/config/conventional-commits");
 const github_1 = require("../../src/command-line/release/utils/github");
 // axios types and values don't seem to match
 const _axios = require("axios");
@@ -10,9 +11,7 @@ const axios = _axios;
  * from the given commits and other metadata.
  */
 const defaultChangelogRenderer = async ({ projectGraph, changes, releaseVersion, project, entryWhenNoChanges, changelogRenderOptions, dependencyBumps, repoSlug, conventionalCommitsConfig, }) => {
-    const changeTypes = conventionalCommitsConfig.types;
     const markdownLines = [];
-    const breakingChanges = [];
     // If the current range of changes contains both a commit and its revert, we strip them both from the final list. Changes from version plans are unaffected, as they have no hashes.
     for (const change of changes) {
         if (change.type === 'revert' && change.revertedHashes) {
@@ -26,10 +25,38 @@ const defaultChangelogRenderer = async ({ projectGraph, changes, releaseVersion,
         }
     }
     let relevantChanges = changes;
+    const breakingChanges = [];
+    // For now to keep the interface of the changelog renderer non-breaking for v19 releases we have a somewhat indirect check for whether or not we are generating a changelog for version plans
+    const isVersionPlans = !conventionalCommitsConfig;
+    // Only applicable for version plans
+    const additionalChangesForAuthorsSection = [];
+    // Provide a default configuration for version plans to allow most of the subsequent logic to work in the same way it would for conventional commits
+    // NOTE: The one exception is breaking/major changes, where we do not follow the same structure and instead only show the changes once
+    if (isVersionPlans) {
+        conventionalCommitsConfig = {
+            types: {
+                feat: conventional_commits_1.DEFAULT_CONVENTIONAL_COMMITS_CONFIG.types.feat,
+                fix: conventional_commits_1.DEFAULT_CONVENTIONAL_COMMITS_CONFIG.types.fix,
+            },
+        };
+        // Trim down "relevant changes" to only include non-breaking ones so that we can render them differently under version plans,
+        // but keep track of the changes for the purposes of the authors section
+        // TODO(v20): Clean this abstraction up as part of the larger overall refactor of changelog rendering
+        for (let i = 0; i < relevantChanges.length; i++) {
+            if (relevantChanges[i].isBreaking) {
+                const change = relevantChanges[i];
+                additionalChangesForAuthorsSection.push(change);
+                const line = formatChange(change, changelogRenderOptions, isVersionPlans, repoSlug);
+                breakingChanges.push(line);
+                relevantChanges.splice(i, 1);
+            }
+        }
+    }
+    const changeTypes = conventionalCommitsConfig.types;
     // workspace root level changelog
     if (project === null) {
         // No changes for the workspace
-        if (relevantChanges.length === 0) {
+        if (relevantChanges.length === 0 && breakingChanges.length === 0) {
             if (dependencyBumps?.length) {
                 applyAdditionalDependencyBumps({
                     markdownLines,
@@ -62,7 +89,7 @@ const defaultChangelogRenderer = async ({ projectGraph, changes, releaseVersion,
             for (const scope of scopesSortedAlphabetically) {
                 const changes = changesGroupedByScope[scope];
                 for (const change of changes) {
-                    const line = formatChange(change, changelogRenderOptions, repoSlug);
+                    const line = formatChange(change, changelogRenderOptions, isVersionPlans, repoSlug);
                     markdownLines.push(line);
                     if (change.isBreaking) {
                         const breakingChangeExplanation = extractBreakingChangeExplanation(change.body);
@@ -79,7 +106,7 @@ const defaultChangelogRenderer = async ({ projectGraph, changes, releaseVersion,
         relevantChanges = relevantChanges.filter((c) => c.affectedProjects &&
             (c.affectedProjects === '*' || c.affectedProjects.includes(project)));
         // Generating for a named project, but that project has no relevant changes in the current set of commits, exit early
-        if (relevantChanges.length === 0) {
+        if (relevantChanges.length === 0 && breakingChanges.length === 0) {
             if (dependencyBumps?.length) {
                 applyAdditionalDependencyBumps({
                     markdownLines,
@@ -105,7 +132,7 @@ const defaultChangelogRenderer = async ({ projectGraph, changes, releaseVersion,
             markdownLines.push('', `### ${changeTypes[type].changelog.title}`, '');
             const changesInChronologicalOrder = group.reverse();
             for (const change of changesInChronologicalOrder) {
-                const line = formatChange(change, changelogRenderOptions, repoSlug);
+                const line = formatChange(change, changelogRenderOptions, isVersionPlans, repoSlug);
                 markdownLines.push(line + '\n');
                 if (change.isBreaking) {
                     const breakingChangeExplanation = extractBreakingChangeExplanation(change.body);
@@ -117,7 +144,7 @@ const defaultChangelogRenderer = async ({ projectGraph, changes, releaseVersion,
         }
     }
     if (breakingChanges.length > 0) {
-        markdownLines.push('', '#### ⚠️  Breaking Changes', '', ...breakingChanges);
+        markdownLines.push('', '### ⚠️  Breaking Changes', '', ...breakingChanges);
     }
     if (dependencyBumps?.length) {
         applyAdditionalDependencyBumps({
@@ -129,7 +156,10 @@ const defaultChangelogRenderer = async ({ projectGraph, changes, releaseVersion,
     }
     if (changelogRenderOptions.authors) {
         const _authors = new Map();
-        for (const change of relevantChanges) {
+        for (const change of [
+            ...relevantChanges,
+            ...additionalChangesForAuthorsSection,
+        ]) {
             if (!change.author) {
                 continue;
             }
@@ -215,7 +245,7 @@ function groupBy(items, key) {
     }
     return groups;
 }
-function formatChange(change, changelogRenderOptions, repoSlug) {
+function formatChange(change, changelogRenderOptions, isVersionPlans, repoSlug) {
     let description = change.description;
     let extraLines = [];
     let extraLinesStr = '';
@@ -228,9 +258,14 @@ function formatChange(change, changelogRenderOptions, repoSlug) {
             .map((l) => `${indentation}${l}`)
             .join('\n');
     }
+    /**
+     * In version plans changelogs:
+     * - don't repeat the breaking change icon
+     * - don't render the scope
+     */
     let changeLine = '- ' +
-        (change.isBreaking ? '⚠️  ' : '') +
-        (change.scope ? `**${change.scope.trim()}:** ` : '') +
+        (!isVersionPlans && change.isBreaking ? '⚠️  ' : '') +
+        (!isVersionPlans && change.scope ? `**${change.scope.trim()}:** ` : '') +
         description;
     if (repoSlug && changelogRenderOptions.commitReferences) {
         changeLine += (0, github_1.formatReferences)(change.githubReferences, repoSlug);

package/schemas/nx-schema.json

@@ -506,6 +506,11 @@
             "type": "object"
           }
         },
+        "parallelism": {
+          "type": "boolean",
+          "default": true,
+          "description": "Whether this target can be run in parallel with other tasks"
+        },
         "inputs": {
           "$ref": "#/definitions/inputs"
         },

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

@@ -3,13 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.yargsViewLogsCommand = exports.yargsConnectCommand = void 0;
 const documentation_1 = require("../yargs-utils/documentation");
 const versions_1 = require("../../utils/versions");
+const shared_options_1 = require("../yargs-utils/shared-options");
 exports.yargsConnectCommand = {
     command: 'connect',
     aliases: ['connect-to-nx-cloud'],
-    describe: `Connect workspace to Nx Cloud`,
-    builder: (yargs) => (0, documentation_1.linkToNxDevAndExamples)(yargs, 'connect-to-nx-cloud'),
-    handler: async () => {
-        await (await Promise.resolve().then(() => require('./connect-to-nx-cloud'))).connectToNxCloudCommand();
+    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);
         await (await Promise.resolve().then(() => require('../../utils/ab-testing'))).recordStat({
             command: 'connect',
             nxVersion: versions_1.nxVersion,
@@ -18,6 +19,12 @@ exports.yargsConnectCommand = {
         process.exit(0);
     },
 };
+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.',
+    });
+}
 exports.yargsViewLogsCommand = {
     command: 'view-logs',
     describe: 'Enables you to view and interact with the logs via the advanced analytic UI from Nx Cloud to help you debug your issue. To do this, Nx needs to connect your workspace to Nx Cloud and upload the most recent run details. Only the metrics are uploaded, not the artefacts.',

package/src/command-line/connect/connect-to-nx-cloud.d.ts

@@ -5,6 +5,8 @@ import { MessageKey } from '../../utils/ab-testing';
 export declare function onlyDefaultRunnerIsUsed(nxJson: NxJsonConfiguration): boolean;
 export declare function connectToNxCloudIfExplicitlyAsked(opts: NxArgs): Promise<void>;
 export declare function connectWorkspaceToCloud(options: ConnectToNxCloudOptions, directory?: string): Promise<string>;
-export declare function connectToNxCloudCommand(command?: string): Promise<boolean>;
+export declare function connectToNxCloudCommand(options: {
+    generateToken?: boolean;
+}, command?: string): Promise<boolean>;
 export declare function connectExistingRepoToNxCloudPrompt(command?: string, key?: MessageKey): Promise<boolean>;
 export declare function connectToNxCloudWithPrompt(command: string): Promise<void>;

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

@@ -54,7 +54,7 @@ async function connectWorkspaceToCloud(options, directory = workspace_root_1.wor
     (0, tree_1.flushChanges)(directory, tree.listChanges());
     return accessToken;
 }
-async function connectToNxCloudCommand(command) {
+async function connectToNxCloudCommand(options, command) {
     const nxJson = (0, configuration_1.readNxJson)();
     const installationSource = process.env.NX_CONSOLE
         ? 'nx-console'
@@ -66,7 +66,7 @@ async function connectToNxCloudCommand(command) {
         if (!token) {
             throw new Error(`Unable to authenticate. If you are connecting to Nx Cloud locally, set Nx Cloud ID in nx.json. If you are connecting in a CI context, either define accessToken in nx.json or set the NX_CLOUD_ACCESS_TOKEN env variable.`);
         }
-        const connectCloudUrl = await (0, url_shorten_1.createNxCloudOnboardingURL)(installationSource, token);
+        const connectCloudUrl = await (0, url_shorten_1.createNxCloudOnboardingURL)(installationSource, token, options?.generateToken !== true);
         output_1.output.log({
             title: '✔ This workspace already has Nx Cloud set up',
             bodyLines: [
@@ -78,9 +78,10 @@ async function connectToNxCloudCommand(command) {
         return false;
     }
     const token = await connectWorkspaceToCloud({
+        generateToken: options?.generateToken,
         installationSource: command ?? installationSource,
     });
-    const connectCloudUrl = await (0, url_shorten_1.createNxCloudOnboardingURL)('nx-connect', token);
+    const connectCloudUrl = await (0, url_shorten_1.createNxCloudOnboardingURL)('nx-connect', token, options?.generateToken !== true);
     try {
         const cloudConnectSpinner = ora(`Opening Nx Cloud ${connectCloudUrl} in your browser to connect your workspace.`).start();
         await sleep(2000);
@@ -115,7 +116,9 @@ async function connectExistingRepoToNxCloudPrompt(command = 'init', key = 'setup
 }
 async function connectToNxCloudWithPrompt(command) {
     const setNxCloud = await nxCloudPrompt('setupNxCloud');
-    const useCloud = setNxCloud === 'yes' ? await connectToNxCloudCommand(command) : false;
+    const useCloud = setNxCloud === 'yes'
+        ? await connectToNxCloudCommand({ generateToken: false }, command)
+        : false;
     await (0, ab_testing_1.recordStat)({
         command,
         nxVersion: versions_1.nxVersion,

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,23 +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).',
     })
         .option('interactive', {
         type: 'boolean',
-        description: 'Interactive mode',
+        description: 'Interactive mode.',
         default: true,
     })), 'import'),
     handler: async (args) => {

package/src/command-line/import/import.d.ts

@@ -15,6 +15,10 @@ export interface ImportOptions {
      * The directory in the destination repo to import into
      */
     destination: string;
+    /**
+     * The depth to clone the source repository (limit this for faster clone times)
+     */
+    depth: number;
     verbose: boolean;
     interactive: boolean;
 }