nx 23.2.0-beta.0 → 23.2.0-beta.10

package/dist/src/command-line/init/ai-agent-prompts.js

@@ -1,35 +1,30 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.determineAiAgents = determineAiAgents;
-const tslib_1 = require("tslib");
-const enquirer_1 = require("enquirer");
+const prompt_helpers_1 = require("../../utils/prompt-helpers");
 const is_ci_1 = require("../../utils/is-ci");
 const utils_1 = require("../../ai/utils");
 const detect_ai_agent_1 = require("../../ai/detect-ai-agent");
-const pc = tslib_1.__importStar(require("picocolors"));
 async function determineAiAgents(aiAgents, interactive) {
-    if (interactive === false || (0, is_ci_1.isCI)()) {
-        if (aiAgents) {
-            return aiAgents;
+    if (aiAgents) {
+        const filtered = aiAgents.filter((a) => a !== 'none');
+        if (filtered.length > 0) {
+            return filtered;
         }
+        return [];
+    }
+    if (interactive === false || (0, is_ci_1.isCI)()) {
         const detected = (0, detect_ai_agent_1.detectAiAgent)();
         return detected ? [detected] : [];
     }
-    if (aiAgents) {
-        return aiAgents;
-    }
     return await aiAgentsPrompt();
 }
 async function aiAgentsPrompt() {
-    const promptConfig = {
-        name: 'agents',
+    return (0, prompt_helpers_1.multiselectPrompt)({
         message: 'Which AI agents, if any, would you like to set up?',
-        type: 'multiselect',
         choices: utils_1.supportedAgents.map((a) => ({
-            name: a,
-            message: utils_1.agentDisplayMap[a],
+            value: a,
+            label: utils_1.agentDisplayMap[a],
         })),
-        footer: () => pc.dim('Multiple selections possible. <Space> to select. <Enter> to confirm.'),
-    };
-    return (await (0, enquirer_1.prompt)([promptConfig])).agents;
+    });
 }

package/dist/src/command-line/init/command-object.js

@@ -17,8 +17,10 @@ exports.yargsInitCommand = {
         return withInitOptions(yargs);
     },
     handler: async (args) => {
-        // Node 24 has stricter readline behavior, and enquirer is not checking for closed state
-        // when invoking operations, thus you get an ERR_USE_AFTER_CLOSE error.
+        // Node 24's stricter readline throws ERR_USE_AFTER_CLOSE when a prompt
+        // library operates on a closed interface. Added for enquirer, which nx no
+        // longer uses; verify against Node 24 before removing.
+        // TODO(v24): drop if @clack/prompts proves not to need it.
         process.on('uncaughtException', (error) => {
             if (error &&
                 typeof error === 'object' &&
@@ -64,8 +66,16 @@ async function withInitOptions(yargs) {
             .option('aiAgents', {
             type: 'array',
             string: true,
-            description: 'List of AI agents to set up.',
-            choices: ['claude', 'codex', 'copilot', 'cursor', 'gemini', 'opencode'],
+            description: 'List of AI agents to set up. Use "none" to skip.',
+            choices: [
+                'claude',
+                'codex',
+                'copilot',
+                'cursor',
+                'gemini',
+                'opencode',
+                'none',
+            ],
         })
             .option('plugins', {
             type: 'string',

package/dist/src/command-line/init/configure-plugins.js

@@ -19,6 +19,7 @@ const configuration_1 = require("../../config/configuration");
 const versions_1 = require("../../utils/versions");
 const child_process_1 = require("../../utils/child-process");
 const fileutils_1 = require("../../utils/fileutils");
+const format_1 = require("./implementation/format");
 const spinner_1 = require("../../utils/spinner");
 function installPluginPackages(repoRoot, pmc = (0, package_manager_1.getPackageManagerCommand)(), plugins) {
     if (plugins.length === 0) {
@@ -35,7 +36,9 @@ function installPluginPackages(repoRoot, pmc = (0, package_manager_1.getPackageM
         for (const plugin of plugins) {
             nxJson.installation.plugins[plugin] = versions_1.nxVersion;
         }
-        (0, fileutils_1.writeJsonFile)((0, path_1.join)(repoRoot, 'nx.json'), nxJson);
+        const nxJsonPath = (0, path_1.join)(repoRoot, 'nx.json');
+        (0, fileutils_1.writeJsonFile)(nxJsonPath, nxJson);
+        (0, format_1.recordInitWrite)(nxJsonPath);
         try {
             (0, child_process_1.runNxSync)('--version', { stdio: 'pipe' });
         }

package/dist/src/command-line/init/implementation/add-nx-to-monorepo.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.addNxToMonorepo = addNxToMonorepo;
-const enquirer_1 = require("enquirer");
+const prompt_helpers_1 = require("../../../utils/prompt-helpers");
 const fs_1 = require("fs");
 const ignore = require("ignore");
 const path_1 = require("path");
@@ -23,38 +23,18 @@ async function addNxToMonorepo(options, guided = true) {
         output_1.output.log({
             title: '🧑‍🔧 Please answer the following questions about the scripts found in your workspace in order to generate task runner configuration',
         });
-        targetDefaults = (await (0, enquirer_1.prompt)([
-            {
-                type: 'multiselect',
-                name: 'targetDefaults',
-                message: 'Which scripts need to be run in order? (e.g. before building a project, dependent projects must be built)',
-                choices: scripts,
-                /**
-                 * limit is missing from the interface but it limits the amount of options shown
-                 */
-                limit: process.stdout.rows - 4, // 4 leaves room for the header above, the prompt and some whitespace
-            },
-        ])).targetDefaults;
-        cacheableOperations = (await (0, enquirer_1.prompt)([
-            {
-                type: 'multiselect',
-                name: 'cacheableOperations',
-                message: 'Which scripts are cacheable? (Produce the same output given the same input, e.g. build, test and lint usually are, serve and start are not)',
-                choices: scripts,
-                /**
-                 * limit is missing from the interface but it limits the amount of options shown
-                 */
-                limit: process.stdout.rows - 4, // 4 leaves room for the header above, the prompt and some whitespace
-            },
-        ])).cacheableOperations;
+        targetDefaults = await (0, prompt_helpers_1.multiselectPrompt)({
+            message: 'Which scripts need to be run in order? (e.g. before building a project, dependent projects must be built)',
+            choices: scripts,
+        });
+        cacheableOperations = await (0, prompt_helpers_1.multiselectPrompt)({
+            message: 'Which scripts are cacheable? (Produce the same output given the same input, e.g. build, test and lint usually are, serve and start are not)',
+            choices: scripts,
+        });
         for (const scriptName of cacheableOperations) {
-            scriptOutputs[scriptName] = (await (0, enquirer_1.prompt)([
-                {
-                    type: 'input',
-                    name: scriptName,
-                    message: `Does the "${scriptName}" script create any outputs? If not, leave blank, otherwise provide a path relative to a project root (e.g. dist, lib, build, coverage)`,
-                },
-            ]))[scriptName];
+            scriptOutputs[scriptName] = await (0, prompt_helpers_1.textPrompt)({
+                message: `Does the "${scriptName}" script create any outputs? If not, leave blank, otherwise provide a path relative to a project root (e.g. dist, lib, build, coverage)`,
+            });
         }
         nxCloudChoice =
             options.nxCloud === true

package/dist/src/command-line/init/implementation/add-nx-to-nest.js

@@ -1,10 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.addNxToNest = addNxToNest;
-const tslib_1 = require("tslib");
-const enquirer = tslib_1.__importStar(require("enquirer"));
+const prompt_helpers_1 = require("../../../utils/prompt-helpers");
 const node_fs_1 = require("node:fs");
 const path_1 = require("path");
+const format_1 = require("./format");
 const fileutils_1 = require("../../../utils/fileutils");
 const output_1 = require("../../../utils/output");
 const package_manager_1 = require("../../../utils/package-manager");
@@ -46,26 +46,14 @@ async function addNxToNest(options, packageJson) {
         output_1.output.log({
             title: '🧑‍🔧 Please answer the following questions about the scripts found in your package.json in order to generate task runner configuration',
         });
-        cacheableOperations = (await enquirer.prompt([
-            {
-                type: 'multiselect',
-                name: 'cacheableOperations',
-                message: 'Which of the following scripts are cacheable? (Produce the same output given the same input, e.g. build, test and lint usually are, serve and start are not)',
-                choices: scripts,
-                /**
-                 * limit is missing from the interface but it limits the amount of options shown
-                 */
-                limit: process.stdout.rows - 4, // 4 leaves room for the header above, the prompt and some whitespace
-            },
-        ])).cacheableOperations;
+        cacheableOperations = await (0, prompt_helpers_1.multiselectPrompt)({
+            message: 'Which of the following scripts are cacheable? (Produce the same output given the same input, e.g. build, test and lint usually are, serve and start are not)',
+            choices: scripts,
+        });
         for (const scriptName of cacheableOperations) {
-            scriptOutputs[scriptName] = (await enquirer.prompt([
-                {
-                    type: 'input',
-                    name: scriptName,
-                    message: `Does the "${scriptName}" script create any outputs? If not, leave blank, otherwise provide a path (e.g. dist, lib, build, coverage)`,
-                },
-            ]))[scriptName];
+            scriptOutputs[scriptName] = await (0, prompt_helpers_1.textPrompt)({
+                message: `Does the "${scriptName}" script create any outputs? If not, leave blank, otherwise provide a path (e.g. dist, lib, build, coverage)`,
+            });
         }
         nxCloudChoice =
             options.nxCloud === true
@@ -114,6 +102,7 @@ function addNestPluginToPackageJson(repoRoot) {
     json.devDependencies['@nx/nest'] = versions_1.nxVersion;
     json.devDependencies['@nx/jest'] = versions_1.nxVersion;
     (0, fileutils_1.writeJsonFile)(path, json);
+    (0, format_1.recordInitWrite)(path);
 }
 function createProjectJson(repoRoot, packageJson, nestCLIOptions) {
     const packageName = packageJson.name;
@@ -194,6 +183,7 @@ function createProjectJson(repoRoot, packageJson, nestCLIOptions) {
         addJestTargets(repoRoot, packageName, json, packageJson);
     }
     (0, fileutils_1.writeJsonFile)(path, json);
+    (0, format_1.recordInitWrite)(path);
 }
 function getJestOptions(isE2E, repoRoot, packageName, existingOptions) {
     // try get the e2e json if we find it
@@ -230,6 +220,7 @@ function tryCreateJestPreset(repoRoot) {
 const nxPreset = require('@nx/jest/preset').default;
 module.exports = {...nxPreset};
 `, 'utf8');
+        (0, format_1.recordInitWrite)(jestPresetPath);
         return true;
     }
     return false;
@@ -244,7 +235,9 @@ function addJestTargets(repoRoot, packageName, projectJson, packageJson) {
         unitTestOptions['preset'] = e2eTestOptions['preset'] = './jest.preset.js';
     }
     (0, node_fs_1.writeFileSync)(unitTestConfigPath, `export default ${JSON.stringify(unitTestOptions, null, 2)}`, 'utf8');
+    (0, format_1.recordInitWrite)(unitTestConfigPath);
     (0, node_fs_1.writeFileSync)(e2eTestConfigPath, `export default ${JSON.stringify(e2eTestOptions, null, 2)}`, 'utf8');
+    (0, format_1.recordInitWrite)(e2eTestConfigPath);
     projectJson.targets['test'] = {
         executor: '@nx/jest:jest',
         outputs: [`{workspaceRoot}/coverage/${packageName}`],
@@ -274,6 +267,7 @@ function addNrwlJsPluginsConfig(repoRoot) {
         };
     }
     (0, fileutils_1.writeJsonFile)(path, json);
+    (0, format_1.recordInitWrite)(path);
 }
 function updatePackageJsonScripts(repoRoot, isJS) {
     const path = (0, path_1.join)(repoRoot, `package.json`);
@@ -310,6 +304,7 @@ function updatePackageJsonScripts(repoRoot, isJS) {
         }
     }
     (0, fileutils_1.writeJsonFile)(path, json);
+    (0, format_1.recordInitWrite)(path);
 }
 function updateTsConfig(repoRoot, sourceRoot) {
     const path = (0, path_1.join)(repoRoot, `tsconfig.build.json`);
@@ -321,6 +316,7 @@ function updateTsConfig(repoRoot, sourceRoot) {
         json.include = [];
     json.include.push(`${sourceRoot}/**/*.ts`);
     (0, fileutils_1.writeJsonFile)(path, json);
+    (0, format_1.recordInitWrite)(path);
 }
 function removeFile(repoRoot, file) {
     const path = (0, path_1.join)(repoRoot, file);

package/dist/src/command-line/init/implementation/add-nx-to-npm-repo.js

@@ -1,8 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.addNxToNpmRepo = addNxToNpmRepo;
-const tslib_1 = require("tslib");
-const enquirer = tslib_1.__importStar(require("enquirer"));
+const prompt_helpers_1 = require("../../../utils/prompt-helpers");
 const path_1 = require("path");
 const fileutils_1 = require("../../../utils/fileutils");
 const output_1 = require("../../../utils/output");
@@ -21,26 +20,14 @@ async function addNxToNpmRepo(options, guided = true) {
         output_1.output.log({
             title: '🧑‍🔧 Please answer the following questions about the scripts found in your package.json in order to generate task runner configuration',
         });
-        cacheableOperations = (await enquirer.prompt([
-            {
-                type: 'multiselect',
-                name: 'cacheableOperations',
-                message: 'Which of the following scripts are cacheable? (Produce the same output given the same input, e.g. build, test and lint usually are, serve and start are not). You can use spacebar to select one or more scripts.',
-                choices: scripts,
-                /**
-                 * limit is missing from the interface but it limits the amount of options shown
-                 */
-                limit: process.stdout.rows - 4, // 4 leaves room for the header above, the prompt and some whitespace
-            },
-        ])).cacheableOperations;
+        cacheableOperations = await (0, prompt_helpers_1.multiselectPrompt)({
+            message: 'Which of the following scripts are cacheable? (Produce the same output given the same input, e.g. build, test and lint usually are, serve and start are not). You can use spacebar to select one or more scripts.',
+            choices: scripts,
+        });
         for (const scriptName of cacheableOperations) {
-            scriptOutputs[scriptName] = (await enquirer.prompt([
-                {
-                    type: 'input',
-                    name: scriptName,
-                    message: `Does the "${scriptName}" script create any outputs? If not, leave blank, otherwise provide a path (e.g. dist, lib, build, coverage)`,
-                },
-            ]))[scriptName];
+            scriptOutputs[scriptName] = await (0, prompt_helpers_1.textPrompt)({
+                message: `Does the "${scriptName}" script create any outputs? If not, leave blank, otherwise provide a path (e.g. dist, lib, build, coverage)`,
+            });
         }
         nxCloudChoice =
             options.nxCloud === true

package/dist/src/command-line/init/implementation/add-nx-to-turborepo.js

@@ -1,12 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.addNxToTurborepo = addNxToTurborepo;
-const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const fileutils_1 = require("../../../utils/fileutils");
-const handle_import_1 = require("../../../utils/handle-import");
 const output_1 = require("../../../utils/output");
 const package_manager_1 = require("../../../utils/package-manager");
+const format_1 = require("./format");
 const utils_1 = require("./utils");
 async function addNxToTurborepo(_options) {
     const repoRoot = process.cwd();
@@ -27,21 +26,8 @@ async function addNxToTurborepo(_options) {
     });
     let nxJson = (0, utils_1.createNxJsonFromTurboJson)((0, fileutils_1.readJsonFile)('turbo.json'));
     const nxJsonPath = (0, node_path_1.join)(repoRoot, 'nx.json');
-    // Turborepo workspaces usually have prettier installed, so try and match the formatting before writing the file
-    try {
-        const prettier = await (0, handle_import_1.handleImport)('prettier');
-        const config = await prettier.resolveConfig(repoRoot);
-        (0, node_fs_1.writeFileSync)(nxJsonPath, 
-        // @ts-ignore - Always await prettier.format, in modern versions it's async
-        await prettier.format(JSON.stringify(nxJson, null, 2), {
-            ...(config ?? {}),
-            parser: 'json',
-        }));
-    }
-    catch (err) {
-        // Apply fallback JSON write
-        (0, fileutils_1.writeJsonFile)(nxJsonPath, nxJson);
-    }
+    (0, fileutils_1.writeJsonFile)(nxJsonPath, nxJson);
+    (0, format_1.recordInitWrite)(nxJsonPath);
     const packageManager = (0, package_manager_1.detectPackageManager)(repoRoot);
     const pmc = (0, package_manager_1.getPackageManagerCommand)(packageManager);
     (0, utils_1.updateGitIgnore)(repoRoot);

package/dist/src/command-line/init/implementation/angular/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.addNxToAngularCliRepo = addNxToAngularCliRepo;
-const enquirer_1 = require("enquirer");
+const prompt_helpers_1 = require("../../../../utils/prompt-helpers");
 const path_1 = require("path");
 const fileutils_1 = require("../../../../utils/fileutils");
 const versions_1 = require("../../../../utils/versions");
@@ -14,6 +14,7 @@ const integrated_workspace_1 = require("./integrated-workspace");
 const legacy_angular_versions_1 = require("./legacy-angular-versions");
 const standalone_workspace_1 = require("./standalone-workspace");
 const connect_to_nx_cloud_1 = require("../../../nx-cloud/connect/connect-to-nx-cloud");
+const format_1 = require("../format");
 const defaultCacheableOperations = [
     'build',
     'server',
@@ -29,6 +30,8 @@ async function addNxToAngularCliRepo(options) {
     if (legacyMigrationFn) {
         output_1.output.log({ title: '💽 Running migration for a legacy Angular version' });
         await legacyMigrationFn();
+        // The exit skips the caller's drain, so format the recorded writes here.
+        await (0, format_1.formatInitWrites)(repoRoot);
         process.exit(0);
     }
     output_1.output.success({
@@ -65,20 +68,11 @@ async function collectCacheableOperations(options) {
         output_1.output.log({
             title: '🧑‍🔧 Please answer the following questions about the targets found in your angular.json in order to generate task runner configuration',
         });
-        cacheableOperations = (await (0, enquirer_1.prompt)([
-            {
-                type: 'multiselect',
-                name: 'cacheableOperations',
-                initial: defaultCacheableTargetsInWorkspace,
-                message: 'Which of the following targets are cacheable? (Produce the same output given the same input, e.g. build, test and lint usually are, serve and start are not)',
-                // enquirer mutates the array below, create a new one to avoid it
-                choices: [...workspaceTargets],
-                /**
-                 * limit is missing from the interface but it limits the amount of options shown
-                 */
-                limit: process.stdout.rows - 4, // 4 leaves room for the header above, the prompt and some whitespace
-            },
-        ])).cacheableOperations;
+        cacheableOperations = await (0, prompt_helpers_1.multiselectPrompt)({
+            message: 'Which of the following targets are cacheable? (Produce the same output given the same input, e.g. build, test and lint usually are, serve and start are not)',
+            choices: workspaceTargets,
+            initialValues: defaultCacheableTargetsInWorkspace,
+        });
     }
     else {
         cacheableOperations =
@@ -113,6 +107,7 @@ function addPluginDependencies() {
     }
     packageJson.devDependencies = (0, object_sort_1.sortObjectByKeys)(packageJson.devDependencies);
     (0, fileutils_1.writeJsonFile)(packageJsonPath, packageJson);
+    (0, format_1.recordInitWrite)(packageJsonPath);
 }
 async function setupWorkspace(cacheableOperations, isIntegratedMigration) {
     (0, utils_1.updateGitIgnore)(repoRoot);

package/dist/src/command-line/init/implementation/angular/integrated-workspace.js

@@ -1,12 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setupIntegratedWorkspace = setupIntegratedWorkspace;
-const child_process_1 = require("child_process");
-const package_manager_1 = require("../../../../utils/package-manager");
+const child_process_1 = require("../../../../utils/child-process");
 function setupIntegratedWorkspace() {
-    const pmc = (0, package_manager_1.getPackageManagerCommand)();
-    (0, child_process_1.execSync)(`${pmc.exec} nx g @nx/angular:ng-add`, {
+    (0, child_process_1.runNxSync)(`g @nx/angular:ng-add`, {
         stdio: [0, 1, 2],
-        windowsHide: true,
     });
 }

package/dist/src/command-line/init/implementation/angular/legacy-angular-versions.js

@@ -12,6 +12,7 @@ const package_json_1 = require("../../../../utils/package-json");
 const package_manager_1 = require("../../../../utils/package-manager");
 const connect_to_nx_cloud_1 = require("../../../nx-cloud/connect/connect-to-nx-cloud");
 const utils_1 = require("../utils");
+const format_1 = require("../format");
 // map of Angular major versions to Nx versions to use for legacy `nx init` migrations,
 // key is major Angular version and value is Nx version to use
 const nxAngularLegacyVersionMap = {
@@ -107,6 +108,9 @@ async function getLegacyMigrationFunctionIfApplicable(repoRoot, options) {
             unscopedPkgName,
         }, pmc);
         output_1.output.log({ title: '📝 Setting up workspace' });
+        // Intentionally not runNxSync: legacyMigrationCommand is either the Angular
+        // CLI (`ng g ...:ng-add`) or a version-pinned `nx@<version> init`, neither
+        // of which is the local nx that runNxSync would resolve.
         (0, child_process_1.execSync)(`${pmc.exec} ${legacyMigrationCommand}`, {
             stdio: [0, 1, 2],
             windowsHide: true,
@@ -138,6 +142,7 @@ async function installDependencies(repoRoot, pkgInfo, pmc) {
         json.dependencies = (0, object_sort_1.sortObjectByKeys)(json.dependencies);
     }
     (0, fileutils_1.writeJsonFile)(`package.json`, json);
+    (0, format_1.recordInitWrite)('package.json');
     (0, child_process_1.execSync)(pmc.install, { stdio: [0, 1, 2], windowsHide: true });
 }
 async function resolvePackageVersion(packageName, version) {

package/dist/src/command-line/init/implementation/angular/standalone-workspace.js

@@ -7,6 +7,7 @@ const angular_json_1 = require("../../../../adapter/angular-json");
 const fileutils_1 = require("../../../../utils/fileutils");
 const path_1 = require("../../../../utils/path");
 const utils_1 = require("../utils");
+const format_1 = require("../format");
 async function setupStandaloneWorkspace(repoRoot, cacheableOperations, workspaceTargets) {
     const angularJsonPath = (0, node_path_1.join)(repoRoot, 'angular.json');
     const angularJson = (0, fileutils_1.readJsonFile)(angularJsonPath);
@@ -25,12 +26,14 @@ async function setupStandaloneWorkspace(repoRoot, cacheableOperations, workspace
     const projects = (0, angular_json_1.toNewFormat)(angularJson).projects;
     for (const [projectName, project] of Object.entries(projects ?? {})) {
         updateProjectOutputs(repoRoot, projectName, project, cacheableOperations);
-        (0, fileutils_1.writeJsonFile)((0, node_path_1.join)(project.root, 'project.json'), {
+        const projectJsonPath = (0, node_path_1.join)(project.root, 'project.json');
+        (0, fileutils_1.writeJsonFile)(projectJsonPath, {
             $schema: (0, path_1.normalizePath)((0, node_path_1.relative)((0, node_path_1.join)(repoRoot, project.root), (0, node_path_1.join)(repoRoot, 'node_modules/nx/schemas/project-schema.json'))),
             name: projectName,
             ...project,
             root: undefined,
         });
+        (0, format_1.recordInitWrite)(projectJsonPath);
     }
     (0, fs_1.unlinkSync)(angularJsonPath);
 }
@@ -91,7 +94,9 @@ function createNxJson(repoRoot, angularJson, cacheableOperations, { eslintProjec
     if (Object.keys(defaults).length > 0) {
         nxJson.targetDefaults = defaults;
     }
-    (0, fileutils_1.writeJsonFile)((0, node_path_1.join)(repoRoot, 'nx.json'), nxJson);
+    const nxJsonPath = (0, node_path_1.join)(repoRoot, 'nx.json');
+    (0, fileutils_1.writeJsonFile)(nxJsonPath, nxJson);
+    (0, format_1.recordInitWrite)(nxJsonPath);
 }
 function updateProjectOutputs(repoRoot, projectName, project, cacheableOperations) {
     Object.entries(project.targets ?? {}).forEach(([targetName, target]) => {
@@ -195,4 +200,5 @@ function replaceNgWithNxInPackageJsonScripts(repoRoot) {
             .replace(/ ng /g, ' nx ');
     });
     (0, fileutils_1.writeJsonFile)(packageJsonPath, packageJson);
+    (0, format_1.recordInitWrite)(packageJsonPath);
 }

package/dist/src/command-line/init/implementation/check-compatible-with-plugins.js

@@ -8,6 +8,7 @@ const picocolors_1 = require("picocolors");
 const error_types_1 = require("../../../project-graph/error-types");
 const workspace_root_1 = require("../../../utils/workspace-root");
 const fileutils_1 = require("../../../utils/fileutils");
+const format_1 = require("./format");
 const output_1 = require("../../../utils/output");
 const project_graph_1 = require("../../../project-graph/project-graph");
 /**
@@ -131,4 +132,5 @@ function updatePluginsInNxJson(root = workspace_root_1.workspaceRoot, pluginToEx
         nxJson.plugins[pluginIndex] = plugin;
     });
     (0, fileutils_1.writeJsonFile)(nxJsonPath, nxJson);
+    (0, format_1.recordInitWrite)(nxJsonPath);
 }

package/dist/src/command-line/init/implementation/dot-nx/add-nx-scripts.js

@@ -12,6 +12,7 @@ exports.getBatchScriptContents = getBatchScriptContents;
 exports.sanitizeWrapperScript = sanitizeWrapperScript;
 const tslib_1 = require("tslib");
 const child_process_1 = require("child_process");
+const format_1 = require("../format");
 const fs_1 = require("fs");
 const path = tslib_1.__importStar(require("path"));
 const semver_1 = require("semver");
@@ -69,7 +70,10 @@ function generateDotNxSetup(version) {
     (0, tree_1.flushChanges)(host.root, changes);
     // Ensure that the dot-nx installation is available.
     // This is needed when using a global nx with dot-nx, otherwise running any nx command using global command will fail due to missing modules.
-    // Pipe stderr so failures surface in telemetry instead of bare "Command failed: ./nx --version".
+    // Intentionally not runNxSync: when the repo has a package.json it would run
+    // `<pm> exec nx` instead of the wrapper, but this call must run the
+    // just-written wrapper itself so it bootstraps .nx/installation.
+    // Pipe stderr so failures surface in telemetry instead of bare "Command failed".
     try {
         (0, child_process_1.execSync)(getDotNxWrapperVersionCommand(), {
             stdio: ['ignore', 'ignore', 'pipe'],
@@ -98,6 +102,10 @@ function writeMinimalNxJson(host, version) {
                 version: normalizeVersionForNxJson('nx', version),
             },
         });
+        (0, format_1.recordInitWrite)('nx.json');
+        // Only this file. The wrapper scripts written by `generateDotNxSetup`
+        // above (`.nx/nxw.js`, `nx`, `nx.bat`) are deliberately left out: they are
+        // vendored artifacts, and two of them have no formatter at all.
     }
 }
 function updateGitIgnore(host) {

package/dist/src/command-line/init/implementation/format.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Records a file for `formatInitWrites`. Only for files a formatter handles -
+ * `.gitignore` and the vendored `.nx` scripts are left out rather than
+ * filtered later.
+ *
+ * Two recording helpers are shared with `nx import`, which drains before each
+ * commit amend; draining after one would leave the formatting uncommitted.
+ * The drain is a no-op when empty.
+ */
+export declare function recordInitWrite(filePath: string): void;
+/**
+ * Formats what init just wrote and nothing else: an existing repo's other
+ * files are not init's to reformat.
+ *
+ * Never fatal - the repo is already initialised, so a formatter that cannot
+ * run costs a `nx format` the user can run themselves, not their setup.
+ */
+export declare function formatInitWrites(repoRoot: string, command?: string): Promise<void>;