nx 21.6.0-canary.20250915-98c47f0 → 21.6.0-canary.20250917-93fcc48

package/generators.json

@@ -5,6 +5,12 @@
       "schema": "./src/nx-cloud/generators/connect-to-nx-cloud/schema.json",
       "description": "Connect a workspace to Nx Cloud",
       "x-hidden": true
+    },
+    "set-up-ai-agents": {
+      "factory": "./src/ai/set-up-ai-agents/set-up-ai-agents",
+      "schema": "./src/ai/set-up-ai-agents/schema.json",
+      "description": "Sets up the Nx MCP & rule files for common AI Agents",
+      "hidden": true
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nx",
-  "version": "21.6.0-canary.20250915-98c47f0",
+  "version": "21.6.0-canary.20250917-93fcc48",
   "private": false,
   "description": "The core Nx plugin contains the core functionality of Nx like the project graph, nx commands and task orchestration.",
   "repository": {
@@ -83,16 +83,16 @@
     }
   },
   "optionalDependencies": {
-    "@nx/nx-darwin-arm64": "21.6.0-canary.20250915-98c47f0",
-    "@nx/nx-darwin-x64": "21.6.0-canary.20250915-98c47f0",
-    "@nx/nx-freebsd-x64": "21.6.0-canary.20250915-98c47f0",
-    "@nx/nx-linux-arm-gnueabihf": "21.6.0-canary.20250915-98c47f0",
-    "@nx/nx-linux-arm64-gnu": "21.6.0-canary.20250915-98c47f0",
-    "@nx/nx-linux-arm64-musl": "21.6.0-canary.20250915-98c47f0",
-    "@nx/nx-linux-x64-gnu": "21.6.0-canary.20250915-98c47f0",
-    "@nx/nx-linux-x64-musl": "21.6.0-canary.20250915-98c47f0",
-    "@nx/nx-win32-arm64-msvc": "21.6.0-canary.20250915-98c47f0",
-    "@nx/nx-win32-x64-msvc": "21.6.0-canary.20250915-98c47f0"
+    "@nx/nx-darwin-arm64": "21.6.0-canary.20250917-93fcc48",
+    "@nx/nx-darwin-x64": "21.6.0-canary.20250917-93fcc48",
+    "@nx/nx-freebsd-x64": "21.6.0-canary.20250917-93fcc48",
+    "@nx/nx-linux-arm-gnueabihf": "21.6.0-canary.20250917-93fcc48",
+    "@nx/nx-linux-arm64-gnu": "21.6.0-canary.20250917-93fcc48",
+    "@nx/nx-linux-arm64-musl": "21.6.0-canary.20250917-93fcc48",
+    "@nx/nx-linux-x64-gnu": "21.6.0-canary.20250917-93fcc48",
+    "@nx/nx-linux-x64-musl": "21.6.0-canary.20250917-93fcc48",
+    "@nx/nx-win32-arm64-msvc": "21.6.0-canary.20250917-93fcc48",
+    "@nx/nx-win32-x64-msvc": "21.6.0-canary.20250917-93fcc48"
   },
   "nx-migrations": {
     "migrations": "./migrations.json",

package/src/ai/set-up-ai-agents/get-agent-rules.d.ts

@@ -0,0 +1,2 @@
+export declare function getAgentRules(nxCloud: boolean): string;
+//# sourceMappingURL=get-agent-rules.d.ts.map

package/src/ai/set-up-ai-agents/get-agent-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-agent-rules.d.ts","sourceRoot":"","sources":["../../../../../../packages/nx/src/ai/set-up-ai-agents/get-agent-rules.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,UAwB7C"}

package/src/ai/set-up-ai-agents/get-agent-rules.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAgentRules = getAgentRules;
+function getAgentRules(nxCloud) {
+    return `
+# General Guidelines for working with Nx
+
+- When running tasks (for example build, lint, test, e2e, etc.), always prefer running the task through \`nx\` (i.e. \`nx run\`, \`nx run-many\`, \`nx affected\`) instead of using the underlying tooling directly
+- You have access to the Nx MCP server and its tools, use them to help the user
+- When answering questions about the repository, use the \`nx_workspace\` tool first to gain an understanding of the workspace architecture where applicable.
+- When working in individual projects, use the \`nx_project_details\` mcp tool to analyze and understand the specific project structure and dependencies
+- For questions around nx configuration, best practices or if you're unsure, use the \`nx_docs\` tool to get relevant, up-to-date docs. Always use this instead of assuming things about nx configuration
+- If the user needs help with an Nx configuration or project graph error, use the \`nx_workspace\` tool to get any errors
+${nxCloud
+        ? `
+# CI Error Guidelines
+
+If the user wants help with fixing an error in their CI pipeline, use the following flow:
+- Retrieve the list of current CI Pipeline Executions (CIPEs) using the \`nx_cloud_cipe_details\` tool
+- If there are any errors, use the \`nx_cloud_fix_cipe_failure\` tool to retrieve the logs for a specific task
+- Use the task logs to see what's wrong and help the user fix their problem. Use the appropriate tools if necessary
+- Make sure that the problem is fixed by running the task that you passed into the \`nx_cloud_fix_cipe_failure\` tool
+`
+        : ''}
+`;
+}

package/src/ai/set-up-ai-agents/schema.d.ts

@@ -0,0 +1,8 @@
+export type SetupAiAgentsGeneratorSchema = {
+  directory: string;
+  writeNxCloudRules?: boolean;
+  packageVersion?: string;
+};
+
+export type NormalizedSetupAiAgentsGeneratorSchema =
+  Required<SetupAiAgentsGeneratorSchema>;

package/src/ai/set-up-ai-agents/schema.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "SetupAiAgents",
+  "title": "Set Up AI Agents",
+  "description": "Sets up the Nx MCP & rule files for common AI Agents.",
+  "type": "object",
+  "properties": {
+    "directory": {
+      "type": "string",
+      "description": "Directory where the AI agent configuration files will be generated",
+      "default": "."
+    },
+    "writeNxCloudRules": {
+      "type": "boolean",
+      "description": "Whether to write Nx Cloud rules",
+      "default": false
+    },
+    "packageVersion": {
+      "type": "string",
+      "description": "The version of the package to use",
+      "default": "latest"
+    }
+  },
+  "required": ["directory"]
+}

package/src/ai/set-up-ai-agents/set-up-ai-agents.d.ts

@@ -0,0 +1,6 @@
+import { Tree } from '../../generators/tree';
+import { NormalizedSetupAiAgentsGeneratorSchema, SetupAiAgentsGeneratorSchema } from './schema';
+export declare function setupAiAgentsGenerator(tree: Tree, options: SetupAiAgentsGeneratorSchema, inner?: boolean): Promise<any>;
+export declare function setupAiAgentsGeneratorImpl(tree: Tree, options: NormalizedSetupAiAgentsGeneratorSchema): Promise<void>;
+export default setupAiAgentsGenerator;
+//# sourceMappingURL=set-up-ai-agents.d.ts.map

package/src/ai/set-up-ai-agents/set-up-ai-agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-up-ai-agents.d.ts","sourceRoot":"","sources":["../../../../../../packages/nx/src/ai/set-up-ai-agents/set-up-ai-agents.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAK7C,OAAO,EACL,sCAAsC,EACtC,4BAA4B,EAC7B,MAAM,UAAU,CAAC;AAElB,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,4BAA4B,EACrC,KAAK,UAAQ,gBAoCd;AAYD,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,sCAAsC,iBAgChD;AAqBD,eAAe,sBAAsB,CAAC"}

package/src/ai/set-up-ai-agents/set-up-ai-agents.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupAiAgentsGenerator = setupAiAgentsGenerator;
+exports.setupAiAgentsGeneratorImpl = setupAiAgentsGeneratorImpl;
+const path_1 = require("path");
+const format_changed_files_with_prettier_if_available_1 = require("../../generators/internal-utils/format-changed-files-with-prettier-if-available");
+const json_1 = require("../../generators/utils/json");
+const package_json_1 = require("../../utils/package-json");
+const provenance_1 = require("../../utils/provenance");
+const get_agent_rules_1 = require("./get-agent-rules");
+async function setupAiAgentsGenerator(tree, options, inner = false) {
+    const normalizedOptions = normalizeOptions(options);
+    // Use environment variable to force local execution
+    if (process.env.NX_AI_FILES_USE_LOCAL === 'true' || inner) {
+        return await setupAiAgentsGeneratorImpl(tree, normalizedOptions);
+    }
+    try {
+        await (0, provenance_1.ensurePackageHasProvenance)('nx', normalizedOptions.packageVersion);
+        const { tempDir, cleanup } = (0, package_json_1.installPackageToTmp)('nx', normalizedOptions.packageVersion);
+        let modulePath = (0, path_1.join)(tempDir, 'node_modules', 'nx', 'src/ai/set-up-ai-agents/set-up-ai-agents.js');
+        const module = await Promise.resolve(`${modulePath}`).then(s => require(s));
+        const setupAiAgentsGeneratorResult = await module.setupAiAgentsGenerator(tree, normalizedOptions, true);
+        cleanup();
+        return setupAiAgentsGeneratorResult;
+    }
+    catch (error) {
+        return await setupAiAgentsGeneratorImpl(tree, normalizedOptions);
+    }
+}
+function normalizeOptions(options) {
+    return {
+        directory: options.directory,
+        writeNxCloudRules: options.writeNxCloudRules ?? false,
+        packageVersion: options.packageVersion ?? 'latest',
+    };
+}
+async function setupAiAgentsGeneratorImpl(tree, options) {
+    const claudePath = (0, path_1.join)(options.directory, 'CLAUDE.md');
+    if (!tree.exists(claudePath)) {
+        tree.write(claudePath, (0, get_agent_rules_1.getAgentRules)(options.writeNxCloudRules));
+    }
+    const agentsPath = (0, path_1.join)(options.directory, 'AGENTS.md');
+    if (!tree.exists(agentsPath)) {
+        tree.write(agentsPath, (0, get_agent_rules_1.getAgentRules)(options.writeNxCloudRules));
+    }
+    const mcpJsonPath = (0, path_1.join)(options.directory, '.mcp.json');
+    if (!tree.exists(mcpJsonPath)) {
+        (0, json_1.writeJson)(tree, mcpJsonPath, {});
+    }
+    (0, json_1.updateJson)(tree, mcpJsonPath, mcpConfigUpdater);
+    const geminiPath = (0, path_1.join)(options.directory, '.gemini', 'settings.json');
+    if (!tree.exists(geminiPath)) {
+        (0, json_1.writeJson)(tree, geminiPath, {});
+    }
+    (0, json_1.updateJson)(tree, geminiPath, mcpConfigUpdater);
+    // Only set contextFileName to AGENTS.md if GEMINI.md doesn't exist already to preserve existing setups
+    if (!tree.exists((0, path_1.join)(options.directory, 'GEMINI.md'))) {
+        (0, json_1.updateJson)(tree, geminiPath, (json) => ({
+            ...json,
+            contextFileName: 'AGENTS.md',
+        }));
+    }
+    await (0, format_changed_files_with_prettier_if_available_1.formatChangedFilesWithPrettierIfAvailable)(tree);
+}
+function mcpConfigUpdater(existing) {
+    if (existing.mcpServers) {
+        existing.mcpServers['nx-mcp'] = {
+            type: 'stdio',
+            command: 'npx',
+            args: ['nx', 'mcp'],
+        };
+    }
+    else {
+        existing.mcpServers = {
+            'nx-mcp': {
+                type: 'stdio',
+                command: 'npx',
+                args: ['nx', 'mcp'],
+            },
+        };
+    }
+    return existing;
+}
+exports.default = setupAiAgentsGenerator;