@aws/nx-plugin 1.0.0-rc.9 → 1.0.0-rc.90

package/src/mcp-server/tools/general-guidance.js.map

@@ -1 +1 @@
-{"version":3,"file":"general-guidance.js","sourceRoot":"","sources":["../../../../../../packages/nx-plugin/src/mcp-server/tools/general-guidance.ts"],"names":[],"mappings":";;;AAMA,6DAA0D;AAC1D,sDAAoE;AACpE,sCAA6C;AAEhC,QAAA,oBAAoB,GAAG;;;;;gGAK4D,CAAC;AAEjG;;GAEG;AACI,MAAM,sBAAsB,GAAG,CACpC,MAAiB,EACjB,UAA6B,EAC7B,EAAE;IACF,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,KAAK,EAAE,kBAAkB;QACzB,WAAW,EACT,oFAAoF;KACvF,EACD,KAAK,IAAI,EAAE,CAAC,CAAC;QACX,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE;;EAEd,4BAAoB;;;;2DAIqC,yBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;iFACL,6BAAa,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;EAOvG,yBAAgB,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAA,+BAAc,EAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkC3E,MAAM,IAAA,gCAAe,EAAC,CAAC,WAAW,EAAE,oBAAoB,EAAE,gBAAgB,CAAC,EAAE,UAAU,CAAC;;KAErF;aACI;SACF;KACF,CAAC,CACH,CAAC;AACJ,CAAC,CAAC;AAtEW,QAAA,sBAAsB,0BAsEjC"}
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/mcp-server/tools/general-guidance.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { NxGeneratorInfo } from '../../utils/generators.js';\nimport { IAC_PROVIDERS } from '../../utils/iac-providers.js';\nimport { buildNxCommand, fetchGuidePages } from '../generator-info.js';\nimport { PACKAGE_MANAGERS } from '../schema.js';\n\nexport const TOOL_SELECTION_GUIDE = `## Tool Selection Guide\n\n- Use the \\`general-guidance\\` tool for guidance and best practices for working with Nx and the Nx Plugin for AWS.\n- Use the \\`create-workspace-command\\` tool to discover how to create a workspace to start a new project.\n- Use the \\`add-to-existing-project\\` tool when adding the plugin to an existing Nx workspace or non-Nx monorepo, or when troubleshooting configuration errors in such a workspace.\n- Use the \\`upgrade-workspace\\` tool when upgrading Nx or the Nx Plugin for AWS to a newer version.\n- Use the \\`list-generators\\` tool to discover the available generators and how to run them.\n- Use the \\`generator-guide\\` tool to retrieve detailed information about a specific generator.`;\n\n/**\n * Add a tool which provides general guidance for using Nx and the Nx Plugin for AWS\n */\nexport const addGeneralGuidanceTool = (\n  server: McpServer,\n  generators: NxGeneratorInfo[],\n) => {\n  server.registerTool(\n    'general-guidance',\n    {\n      title: 'General Guidance',\n      description:\n        'Tool for guidance and best practices for working with Nx and the Nx Plugin for AWS',\n    },\n    async () => ({\n      content: [\n        {\n          type: 'text' as const,\n          text: `# Nx Plugin for AWS Guidance\n\n${TOOL_SELECTION_GUIDE}\n\n## Getting Started\n\n- Choose a package manager first. You can choose between ${PACKAGE_MANAGERS.join(', ')}. It's recommended to use \"pnpm\" if the user has no preference\n- Choose an infrastructure as code (IaC) provider next. You can choose between ${IAC_PROVIDERS.join(', ')}. It's recommended to use CDK if the user has no preference\n- Next, you must create an Nx workspace. Use the \\`create-workspace-command\\` tool for more details, and provide it with your chosen package manager\n- After this, you can start scaffolding the main components of your application using generators. Use the \\`list-generators\\` tool to discover available generators, and the \\`generator-guide\\` tool for more detailed information about a specific generator\n\n## Nx Primer\n\n- Prefix nx commands with the appropriate prefix for your package manager, for example:\n${PACKAGE_MANAGERS.map((pm) => buildNxCommand('<options>', pm)).join(' - \\n')}\n- Each project in your workspace has a file named \\`project.json\\` which contains important project information such as its name, and defines the \"targets\" which can be run for that project, for example building or testing the project\n- Use the command \\`nx reset\\` to reset the Nx daemon when unexpected issues arise\n- After adding dependencies between TypeScript projects, use \\`nx sync\\` to ensure project references are set up correctly\n\n## General Instructions\n\n- Each project declares the third-party runtime dependencies its source imports in its own \\`package.json\\`; shared build/test tooling (test runners, bundlers, etc.) is declared in the root \\`package.json\\` \\`devDependencies\\`. Versions follow a single version policy, recorded in the package manager's dependency catalog where supported (referenced as \\`catalog:\\`). Install with the appropriate command for your package manager:\n  - Add a project runtime dependency: \\`pnpm add <package> --filter <project>\\` / \\`yarn workspace <project> add <package>\\` / \\`npm install <package> -w <project>\\` / \\`bun add <package> --cwd <project-directory>\\`\n  - Add a shared dev tool at the root: \\`pnpm add -Dw <package>\\` / \\`yarn add -D <package>\\` / \\`npm install --legacy-peer-deps -D <package>\\` / \\`bun install -D <package>\\`\n- The \\`noUndeclaredDependencies\\` lint rule enforces that a project's source only imports packages declared in its own \\`package.json\\`\n- Projects in the same workspace can import one another directly by package name (eg \\`@workspace-name/project-name\\`) without declaring a dependency in \\`package.json\\` — TypeScript path aliases in \\`tsconfig.base.json\\` resolve these imports\n- When specifying project names as arguments to generators, prefer the _fully qualified_ project name, for example \\`@workspace-name/project-name\\`. Check the \\`project.json\\` file for the specific package to find its fully qualified name\n- When no generator exists for a specific framework required, use the base \\`ts#project\\` and \\`py#project\\` generators and build on top.\n- Leave the \\`--infra\\` option at its default value unless the user has explicitly instructed otherwise. Generators choose a sensible default type of infrastructure to deploy the project with, so only override \\`--infra\\` when the user has specified a particular requirement.\n\n## Useful Commands\n\n- Fix lint issues with \\`nx run-many --target lint --configuration=fix --all --output-style=stream\\`\n- Build all projects with \\`nx run-many --target build --all --output-style=stream\\`\n- Prefer importing the CDK constructs vended by generators in \\`packages/common/constructs\\` over writing your own\n\n## Best Practices\n\n- After running a generator, use the \\`nx show projects\\` command to check which projects have been added (if any)\n- Carefully examine the files that have been generated and always refer back to the generator guide when working in a generated project\n- Generate all projects into the \\`packages/\\` directory\n- After making changes to your projects, fix linting issues, then run a full build\n- When it's time to start testing a project, suggest to the user that infrastructure is deployed to AWS. For websites, if a runtime-config.json is needed, use the load-runtime-config target after a deployment to point a local website at a sandbox stack.\n- For CDK infrastructure projects, deploy the sandbox stage with the \\`deploy-sandbox\\` target (eg \\`nx deploy-sandbox infra\\`) rather than passing a stage pattern to \\`deploy\\` — it already targets the sandbox stage declared in \\`main.ts\\`. Likewise \\`destroy-sandbox\\` tears that stage back down.\n\n## Batching Generators\n\nWhen scaffolding several projects in one go, chain generators to avoid a slow dependency install after every generator:\n\n- **Chain generators** with \\`&&\\` in a single command. Pass \\`--prefer-install-dependencies=false\\` on each generator except the last so dependencies install once at the end, for example:\n\n${PACKAGE_MANAGERS.map(\n  (pm) => `  \\`\\`\\`bash\n  ${buildNxCommand('g @aws/nx-plugin:ts#trpc-api --no-interactive --name=my-app-api --auth=iam --prefer-install-dependencies=false', pm)} && \\\\\n    ${buildNxCommand('g @aws/nx-plugin:ts#react-website --no-interactive --name=my-app-website --prefer-install-dependencies=false', pm)} && \\\\\n    ${buildNxCommand('g @aws/nx-plugin:connection --no-interactive --sourceProject=@my-app/my-app-website --targetProject=@my-app/my-app-api --prefer-install-dependencies=false', pm)} && \\\\\n    ${buildNxCommand('g @aws/nx-plugin:ts#infra --no-interactive --name=infra', pm)} && \\\\\n    ${buildNxCommand('sync', pm)}\n  \\`\\`\\``,\n).join('\\n')}\n\n- **\\`--prefer-install-dependencies=false\\`** asks a generator to defer its dependency install so the batch installs once at the end (the final generator above omits the flag and installs everything).\n- **\\`nx sync\\`** is required before building — generators modify TypeScript project references.\n\n## Detailed Guides\n\nPlease refer to the below documentation for important details regarding workspaces and working with TypeScript or Python projects.\n\n${await fetchGuidePages(['workspace', 'typescript-project', 'python-project'], generators)}\n\n    `,\n        },\n      ],\n    }),\n  );\n};\n"],"names":["IAC_PROVIDERS","buildNxCommand","fetchGuidePages","PACKAGE_MANAGERS","TOOL_SELECTION_GUIDE","addGeneralGuidanceTool","server","generators","registerTool","title","description","content","type","text","join","map","pm"],"mappings":"AAAA;;;CAGC,GAGD,SAASA,aAAa,QAAQ,+BAA+B;AAC7D,SAASC,cAAc,EAAEC,eAAe,QAAQ,uBAAuB;AACvE,SAASC,gBAAgB,QAAQ,eAAe;AAEhD,OAAO,MAAMC,uBAAuB,CAAC;;;;;;;+FAO0D,CAAC,CAAC;AAEjG;;CAEC,GACD,OAAO,MAAMC,yBAAyB,CACpCC,QACAC;IAEAD,OAAOE,YAAY,CACjB,oBACA;QACEC,OAAO;QACPC,aACE;IACJ,GACA,UAAa,CAAA;YACXC,SAAS;gBACP;oBACEC,MAAM;oBACNC,MAAM,CAAC;;AAEjB,EAAET,qBAAqB;;;;yDAIkC,EAAED,iBAAiBW,IAAI,CAAC,MAAM;+EACR,EAAEd,cAAcc,IAAI,CAAC,MAAM;;;;;;;AAO1G,EAAEX,iBAAiBY,GAAG,CAAC,CAACC,KAAOf,eAAe,aAAae,KAAKF,IAAI,CAAC,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqC9E,EAAEX,iBAAiBY,GAAG,CACpB,CAACC,KAAO,CAAC;EACT,EAAEf,eAAe,kHAAkHe,IAAI;IACrI,EAAEf,eAAe,gHAAgHe,IAAI;IACrI,EAAEf,eAAe,8JAA8Je,IAAI;IACnL,EAAEf,eAAe,2DAA2De,IAAI;IAChF,EAAEf,eAAe,QAAQe,IAAI;QACzB,CAAC,EACPF,IAAI,CAAC,MAAM;;;;;;;;;AASb,EAAE,MAAMZ,gBAAgB;wBAAC;wBAAa;wBAAsB;qBAAiB,EAAEK,YAAY;;IAEvF,CAAC;gBACG;aACD;QACH,CAAA;AAEJ,EAAE"}

package/src/mcp-server/tools/generator-guide.d.ts

@@ -3,7 +3,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { NxGeneratorInfo } from '../../utils/generators';
+import type { NxGeneratorInfo } from '../../utils/generators.js';
 /**
  * Add a tool which provides a detailed guide for an individual generator.
  *

package/src/mcp-server/tools/generator-guide.js

@@ -1,9 +1,9 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.addGeneratorGuideTool = void 0;
-const zod_1 = require("zod");
-const generator_info_1 = require("../generator-info");
-const schema_1 = require("../schema");
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ import { z } from "zod";
+import { fetchGuidePagesForGenerator, renderGeneratorInfo } from "../generator-info.js";
+import { PackageManagerSchema } from "../schema.js";
 /**
  * Add a tool which provides a detailed guide for an individual generator.
  *
@@ -12,55 +12,47 @@ const schema_1 = require("../schema");
  * — and the "unsupported combination" case, where it returns an explicit
  * warning instead of empty guide content. The tool description points
  * agents at `list-generators` for the list of filterable options.
- */
-const addGeneratorGuideTool = (server, generators) => {
+ */ export const addGeneratorGuideTool = (server, generators)=>{
     server.registerTool('generator-guide', {
-        description: 'Tool to retrieve detailed information about a specific generator. ' +
-            'Pass `options` with the values you intend to use for any filterable option ' +
-            '(e.g. infra, iac, auth, ux, protocol, sourceType, targetType) ' +
-            'to receive only the guide content relevant to those choices — this cuts noise ' +
-            'and avoids suggesting configuration from a different branch. The filterable keys ' +
-            'and their valid values for each generator are listed by the `list-generators` ' +
-            'tool; call it first if you are not sure which keys to pass. When the combination ' +
-            'you pick is not supported by the generator (e.g. connection from ts#trpc-api ' +
-            'to smithy), the tool returns an "Unsupported combination" warning with the ' +
-            'list of supported pairs. When `options` is omitted, every conditional section ' +
-            'is included and prefixed with a `> [!NOTE] Only when …` marker so you can see ' +
-            'the branching condition.',
+        description: 'Tool to retrieve detailed information about a specific generator. ' + 'Pass `options` with the values you intend to use for any filterable option ' + '(e.g. infra, iac, auth, ux, protocol, sourceType, targetType) ' + 'to receive only the guide content relevant to those choices — this cuts noise ' + 'and avoids suggesting configuration from a different branch. The filterable keys ' + 'and their valid values for each generator are listed by the `list-generators` ' + 'tool; call it first if you are not sure which keys to pass. When the combination ' + 'you pick is not supported by the generator (e.g. connection from ts#trpc-api ' + 'to smithy), the tool returns an "Unsupported combination" warning with the ' + 'list of supported pairs. When `options` is omitted, every conditional section ' + 'is included and prefixed with a `> [!NOTE] Only when …` marker so you can see ' + 'the branching condition.',
         inputSchema: {
-            packageManager: schema_1.PackageManagerSchema,
-            generator: zod_1.z.enum(generators.map((g) => g.id)),
-            options: zod_1.z
-                .record(zod_1.z.string(), zod_1.z.string())
-                .optional()
-                .describe('Optional map of generator option values (e.g. { infra: "rest-lambda", iac: "cdk" }) used to filter the guide to content that applies to those choices.'),
-        },
-    }, async ({ packageManager, generator: generatorId, options }) => {
-        const generator = generators.find((g) => g.id === generatorId);
+            packageManager: PackageManagerSchema,
+            generator: z.enum(generators.map((g)=>g.id)),
+            options: z.record(z.string(), z.string()).optional().describe('Optional map of generator option values (e.g. { infra: "rest-lambda", iac: "cdk" }) used to filter the guide to content that applies to those choices.')
+        }
+    }, async ({ packageManager, generator: generatorId, options })=>{
+        const generator = generators.find((g)=>g.id === generatorId);
         if (!generator) {
-            throw new Error(`No generator found with id ${generatorId}. Available generators: ${generators.map((g) => g.id).join(' ,')}`);
+            throw new Error(`No generator found with id ${generatorId}. Available generators: ${generators.map((g)=>g.id).join(' ,')}`);
         }
-        const guide = await (0, generator_info_1.fetchGuidePagesForGenerator)(generator, generators, packageManager, undefined, options);
+        const guide = await fetchGuidePagesForGenerator(generator, generators, packageManager, undefined, options);
         // An unsupported combination renders its own self-contained warning
         // (leads with `## <id>` and lists the supported predicates), so
         // return it directly without the usual guide header.
         if (guide.kind === 'unsupported') {
-            return { content: [{ type: 'text', text: guide.content }] };
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: guide.content
+                    }
+                ]
+            };
         }
         return {
             content: [
                 {
                     type: 'text',
-                    text: `## ${(0, generator_info_1.renderGeneratorInfo)(packageManager, generator)}
+                    text: `## ${renderGeneratorInfo(packageManager, generator)}
 
 # Guide
 
 ${guide.content}
-`,
-                },
-            ],
+`
+                }
+            ]
         };
     });
 };
-exports.addGeneratorGuideTool = addGeneratorGuideTool;
+
 //# sourceMappingURL=generator-guide.js.map

package/src/mcp-server/tools/generator-guide.js.map

@@ -1 +1 @@
-{"version":3,"file":"generator-guide.js","sourceRoot":"","sources":["../../../../../../packages/nx-plugin/src/mcp-server/tools/generator-guide.ts"],"names":[],"mappings":";;;AAKA,6BAAwB;AAExB,sDAG2B;AAC3B,sCAAiD;AAEjD;;;;;;;;GAQG;AACI,MAAM,qBAAqB,GAAG,CACnC,MAAiB,EACjB,UAA6B,EAC7B,EAAE;IACF,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,WAAW,EACT,oEAAoE;YACpE,6EAA6E;YAC7E,gEAAgE;YAChE,gFAAgF;YAChF,mFAAmF;YACnF,gFAAgF;YAChF,mFAAmF;YACnF,+EAA+E;YAC/E,6EAA6E;YAC7E,gFAAgF;YAChF,gFAAgF;YAChF,0BAA0B;QAC5B,WAAW,EAAE;YACX,cAAc,EAAE,6BAAoB;YACpC,SAAS,EAAE,OAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC9C,OAAO,EAAE,OAAC;iBACP,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC;iBAC9B,QAAQ,EAAE;iBACV,QAAQ,CACP,wJAAwJ,CACzJ;SACJ;KACF,EACD,KAAK,EAAE,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,EAAE;QAC5D,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,WAAW,CAAC,CAAC;QAC/D,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,8BAA8B,WAAW,2BAA2B,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC7G,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,IAAA,4CAA2B,EAC7C,SAAS,EACT,UAAU,EACV,cAAc,EACd,SAAS,EACT,OAAO,CACR,CAAC;QAEF,oEAAoE;QACpE,gEAAgE;QAChE,qDAAqD;QACrD,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YACjC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QACvE,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,MAAM,IAAA,oCAAmB,EAAC,cAAc,EAAE,SAAS,CAAC;;;;EAIpE,KAAK,CAAC,OAAO;CACd;iBACU;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC,CAAC;AArEW,QAAA,qBAAqB,yBAqEhC"}
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/mcp-server/tools/generator-guide.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { z } from 'zod';\nimport type { NxGeneratorInfo } from '../../utils/generators.js';\nimport {\n  fetchGuidePagesForGenerator,\n  renderGeneratorInfo,\n} from '../generator-info.js';\nimport { PackageManagerSchema } from '../schema.js';\n\n/**\n * Add a tool which provides a detailed guide for an individual generator.\n *\n * `fetchGuidePagesForGenerator` handles both the \"narrow by `options`\"\n * case — reading each page's frontmatter `when:` to pick matching variants\n * — and the \"unsupported combination\" case, where it returns an explicit\n * warning instead of empty guide content. The tool description points\n * agents at `list-generators` for the list of filterable options.\n */\nexport const addGeneratorGuideTool = (\n  server: McpServer,\n  generators: NxGeneratorInfo[],\n) => {\n  server.registerTool(\n    'generator-guide',\n    {\n      description:\n        'Tool to retrieve detailed information about a specific generator. ' +\n        'Pass `options` with the values you intend to use for any filterable option ' +\n        '(e.g. infra, iac, auth, ux, protocol, sourceType, targetType) ' +\n        'to receive only the guide content relevant to those choices — this cuts noise ' +\n        'and avoids suggesting configuration from a different branch. The filterable keys ' +\n        'and their valid values for each generator are listed by the `list-generators` ' +\n        'tool; call it first if you are not sure which keys to pass. When the combination ' +\n        'you pick is not supported by the generator (e.g. connection from ts#trpc-api ' +\n        'to smithy), the tool returns an \"Unsupported combination\" warning with the ' +\n        'list of supported pairs. When `options` is omitted, every conditional section ' +\n        'is included and prefixed with a `> [!NOTE] Only when …` marker so you can see ' +\n        'the branching condition.',\n      inputSchema: {\n        packageManager: PackageManagerSchema,\n        generator: z.enum(generators.map((g) => g.id)),\n        options: z\n          .record(z.string(), z.string())\n          .optional()\n          .describe(\n            'Optional map of generator option values (e.g. { infra: \"rest-lambda\", iac: \"cdk\" }) used to filter the guide to content that applies to those choices.',\n          ),\n      },\n    },\n    async ({ packageManager, generator: generatorId, options }) => {\n      const generator = generators.find((g) => g.id === generatorId);\n      if (!generator) {\n        throw new Error(\n          `No generator found with id ${generatorId}. Available generators: ${generators.map((g) => g.id).join(' ,')}`,\n        );\n      }\n\n      const guide = await fetchGuidePagesForGenerator(\n        generator,\n        generators,\n        packageManager,\n        undefined,\n        options,\n      );\n\n      // An unsupported combination renders its own self-contained warning\n      // (leads with `## <id>` and lists the supported predicates), so\n      // return it directly without the usual guide header.\n      if (guide.kind === 'unsupported') {\n        return { content: [{ type: 'text' as const, text: guide.content }] };\n      }\n\n      return {\n        content: [\n          {\n            type: 'text' as const,\n            text: `## ${renderGeneratorInfo(packageManager, generator)}\n\n# Guide\n\n${guide.content}\n`,\n          },\n        ],\n      };\n    },\n  );\n};\n"],"names":["z","fetchGuidePagesForGenerator","renderGeneratorInfo","PackageManagerSchema","addGeneratorGuideTool","server","generators","registerTool","description","inputSchema","packageManager","generator","enum","map","g","id","options","record","string","optional","describe","generatorId","find","Error","join","guide","undefined","kind","content","type","text"],"mappings":"AAAA;;;CAGC,GAED,SAASA,CAAC,QAAQ,MAAM;AAExB,SACEC,2BAA2B,EAC3BC,mBAAmB,QACd,uBAAuB;AAC9B,SAASC,oBAAoB,QAAQ,eAAe;AAEpD;;;;;;;;CAQC,GACD,OAAO,MAAMC,wBAAwB,CACnCC,QACAC;IAEAD,OAAOE,YAAY,CACjB,mBACA;QACEC,aACE,uEACA,gFACA,mEACA,mFACA,sFACA,mFACA,sFACA,kFACA,gFACA,mFACA,mFACA;QACFC,aAAa;YACXC,gBAAgBP;YAChBQ,WAAWX,EAAEY,IAAI,CAACN,WAAWO,GAAG,CAAC,CAACC,IAAMA,EAAEC,EAAE;YAC5CC,SAAShB,EACNiB,MAAM,CAACjB,EAAEkB,MAAM,IAAIlB,EAAEkB,MAAM,IAC3BC,QAAQ,GACRC,QAAQ,CACP;QAEN;IACF,GACA,OAAO,EAAEV,cAAc,EAAEC,WAAWU,WAAW,EAAEL,OAAO,EAAE;QACxD,MAAML,YAAYL,WAAWgB,IAAI,CAAC,CAACR,IAAMA,EAAEC,EAAE,KAAKM;QAClD,IAAI,CAACV,WAAW;YACd,MAAM,IAAIY,MACR,CAAC,2BAA2B,EAAEF,YAAY,wBAAwB,EAAEf,WAAWO,GAAG,CAAC,CAACC,IAAMA,EAAEC,EAAE,EAAES,IAAI,CAAC,OAAO;QAEhH;QAEA,MAAMC,QAAQ,MAAMxB,4BAClBU,WACAL,YACAI,gBACAgB,WACAV;QAGF,oEAAoE;QACpE,gEAAgE;QAChE,qDAAqD;QACrD,IAAIS,MAAME,IAAI,KAAK,eAAe;YAChC,OAAO;gBAAEC,SAAS;oBAAC;wBAAEC,MAAM;wBAAiBC,MAAML,MAAMG,OAAO;oBAAC;iBAAE;YAAC;QACrE;QAEA,OAAO;YACLA,SAAS;gBACP;oBACEC,MAAM;oBACNC,MAAM,CAAC,GAAG,EAAE5B,oBAAoBQ,gBAAgBC,WAAW;;;;AAIvE,EAAEc,MAAMG,OAAO,CAAC;AAChB,CAAC;gBACS;aACD;QACH;IACF;AAEJ,EAAE"}

package/src/mcp-server/tools/list-generators.d.ts

@@ -3,7 +3,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { NxGeneratorInfo } from '../../utils/generators';
+import type { NxGeneratorInfo } from '../../utils/generators.js';
 /**
  * Adds a tool which lists details about the available generators.
  *

package/src/mcp-server/tools/list-generators.js

@@ -1,8 +1,8 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.addListGeneratorsTool = void 0;
-const generator_info_1 = require("../generator-info");
-const schema_1 = require("../schema");
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ import { renderFilterableOptionsAsync, renderGeneratorInfo } from "../generator-info.js";
+import { PackageManagerSchema } from "../schema.js";
 /**
  * Adds a tool which lists details about the available generators.
  *
@@ -14,34 +14,28 @@ const schema_1 = require("../schema");
  *   - The union of `when:` frontmatter keys across the generator's guide
  *     pages (lets multi-variant generators like `connection` surface
  *     `sourceType` / `targetType` / `protocol` without any bespoke config).
- */
-const addListGeneratorsTool = (server, generators) => {
+ */ export const addListGeneratorsTool = (server, generators)=>{
     server.registerTool('list-generators', {
-        description: 'Tool to discover the available generators and how to run them. ' +
-            'Each entry includes a "Filterable options" section — pass those ' +
-            'keys to `generator-guide` before invoking a generator so the guide ' +
-            'is narrowed to the variant you intend to scaffold.',
-        inputSchema: { packageManager: schema_1.PackageManagerSchema },
-    }, async ({ packageManager }) => {
-        const entries = await Promise.all(generators.map(async (g) => {
-            const info = (0, generator_info_1.renderGeneratorInfo)(packageManager, g);
-            const filterable = await (0, generator_info_1.renderFilterableOptionsAsync)(g);
+        description: 'Tool to discover the available generators and how to run them. ' + 'Each entry includes a "Filterable options" section — pass those ' + 'keys to `generator-guide` before invoking a generator so the guide ' + 'is narrowed to the variant you intend to scaffold.',
+        inputSchema: {
+            packageManager: PackageManagerSchema
+        }
+    }, async ({ packageManager })=>{
+        const entries = await Promise.all(generators.map(async (g)=>{
+            const info = renderGeneratorInfo(packageManager, g);
+            const filterable = await renderFilterableOptionsAsync(g);
             return `### ${info}${filterable ? `\n${filterable}\n` : ''}`;
         }));
-        const guidance = 'Before running any generator below, call `generator-guide` with the ' +
-            "generator's id and `options` populated from its `generator-guide options` " +
-            'list — the guide is returned narrowed to the branches that apply to ' +
-            'those choices, which keeps you from mixing configuration from a ' +
-            'different variant.';
+        const guidance = 'Before running any generator below, call `generator-guide` with the ' + "generator's id and `options` populated from its `generator-guide options` " + 'list — the guide is returned narrowed to the branches that apply to ' + 'those choices, which keeps you from mixing configuration from a ' + 'different variant.';
         return {
             content: [
                 {
                     type: 'text',
-                    text: `## Available Generators\n\n${guidance}\n\n${entries.join('\n\n')}\n`,
-                },
-            ],
+                    text: `## Available Generators\n\n${guidance}\n\n${entries.join('\n\n')}\n`
+                }
+            ]
         };
     });
 };
-exports.addListGeneratorsTool = addListGeneratorsTool;
+
 //# sourceMappingURL=list-generators.js.map

package/src/mcp-server/tools/list-generators.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-generators.js","sourceRoot":"","sources":["../../../../../../packages/nx-plugin/src/mcp-server/tools/list-generators.ts"],"names":[],"mappings":";;;AAMA,sDAG2B;AAC3B,sCAAiD;AAEjD;;;;;;;;;;;GAWG;AACI,MAAM,qBAAqB,GAAG,CACnC,MAAiB,EACjB,UAA6B,EAC7B,EAAE;IACF,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,WAAW,EACT,iEAAiE;YACjE,kEAAkE;YAClE,qEAAqE;YACrE,oDAAoD;QACtD,WAAW,EAAE,EAAE,cAAc,EAAE,6BAAoB,EAAE;KACtD,EACD,KAAK,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE;QAC3B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;YACzB,MAAM,IAAI,GAAG,IAAA,oCAAmB,EAAC,cAAc,EAAE,CAAC,CAAC,CAAC;YACpD,MAAM,UAAU,GAAG,MAAM,IAAA,6CAA4B,EAAC,CAAC,CAAC,CAAC;YACzD,OAAO,OAAO,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,KAAK,UAAU,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC/D,CAAC,CAAC,CACH,CAAC;QACF,MAAM,QAAQ,GACZ,sEAAsE;YACtE,4EAA4E;YAC5E,sEAAsE;YACtE,kEAAkE;YAClE,oBAAoB,CAAC;QACvB,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,8BAA8B,QAAQ,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI;iBAC5E;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC,CAAC;AAtCW,QAAA,qBAAqB,yBAsChC"}
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/mcp-server/tools/list-generators.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { NxGeneratorInfo } from '../../utils/generators.js';\nimport {\n  renderFilterableOptionsAsync,\n  renderGeneratorInfo,\n} from '../generator-info.js';\nimport { PackageManagerSchema } from '../schema.js';\n\n/**\n * Adds a tool which lists details about the available generators.\n *\n * Each entry carries a \"Filterable options\" section that tells the agent\n * which keys it can pass to `generator-guide` to narrow the guide response\n * to only the branches relevant to its selection. The keys come from two\n * sources, merged transparently:\n *   - Enum properties from the generator's JSON schema.\n *   - The union of `when:` frontmatter keys across the generator's guide\n *     pages (lets multi-variant generators like `connection` surface\n *     `sourceType` / `targetType` / `protocol` without any bespoke config).\n */\nexport const addListGeneratorsTool = (\n  server: McpServer,\n  generators: NxGeneratorInfo[],\n) => {\n  server.registerTool(\n    'list-generators',\n    {\n      description:\n        'Tool to discover the available generators and how to run them. ' +\n        'Each entry includes a \"Filterable options\" section — pass those ' +\n        'keys to `generator-guide` before invoking a generator so the guide ' +\n        'is narrowed to the variant you intend to scaffold.',\n      inputSchema: { packageManager: PackageManagerSchema },\n    },\n    async ({ packageManager }) => {\n      const entries = await Promise.all(\n        generators.map(async (g) => {\n          const info = renderGeneratorInfo(packageManager, g);\n          const filterable = await renderFilterableOptionsAsync(g);\n          return `### ${info}${filterable ? `\\n${filterable}\\n` : ''}`;\n        }),\n      );\n      const guidance =\n        'Before running any generator below, call `generator-guide` with the ' +\n        \"generator's id and `options` populated from its `generator-guide options` \" +\n        'list — the guide is returned narrowed to the branches that apply to ' +\n        'those choices, which keeps you from mixing configuration from a ' +\n        'different variant.';\n      return {\n        content: [\n          {\n            type: 'text' as const,\n            text: `## Available Generators\\n\\n${guidance}\\n\\n${entries.join('\\n\\n')}\\n`,\n          },\n        ],\n      };\n    },\n  );\n};\n"],"names":["renderFilterableOptionsAsync","renderGeneratorInfo","PackageManagerSchema","addListGeneratorsTool","server","generators","registerTool","description","inputSchema","packageManager","entries","Promise","all","map","g","info","filterable","guidance","content","type","text","join"],"mappings":"AAAA;;;CAGC,GAGD,SACEA,4BAA4B,EAC5BC,mBAAmB,QACd,uBAAuB;AAC9B,SAASC,oBAAoB,QAAQ,eAAe;AAEpD;;;;;;;;;;;CAWC,GACD,OAAO,MAAMC,wBAAwB,CACnCC,QACAC;IAEAD,OAAOE,YAAY,CACjB,mBACA;QACEC,aACE,oEACA,qEACA,wEACA;QACFC,aAAa;YAAEC,gBAAgBP;QAAqB;IACtD,GACA,OAAO,EAAEO,cAAc,EAAE;QACvB,MAAMC,UAAU,MAAMC,QAAQC,GAAG,CAC/BP,WAAWQ,GAAG,CAAC,OAAOC;YACpB,MAAMC,OAAOd,oBAAoBQ,gBAAgBK;YACjD,MAAME,aAAa,MAAMhB,6BAA6Bc;YACtD,OAAO,CAAC,IAAI,EAAEC,OAAOC,aAAa,CAAC,EAAE,EAAEA,WAAW,EAAE,CAAC,GAAG,IAAI;QAC9D;QAEF,MAAMC,WACJ,yEACA,+EACA,yEACA,qEACA;QACF,OAAO;YACLC,SAAS;gBACP;oBACEC,MAAM;oBACNC,MAAM,CAAC,2BAA2B,EAAEH,SAAS,IAAI,EAAEP,QAAQW,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC7E;aACD;QACH;IACF;AAEJ,EAAE"}

package/src/mcp-server/tools/upgrade-workspace.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { NxGeneratorInfo } from '../../utils/generators.js';
+/**
+ * Add a tool which guides an agent through upgrading Nx and @aws/nx-plugin in a
+ * workspace, returning the `upgrading` docs page.
+ */
+export declare const addUpgradeWorkspaceTool: (server: McpServer, generators: NxGeneratorInfo[]) => void;

package/src/mcp-server/tools/upgrade-workspace.js

@@ -0,0 +1,32 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ import { fetchGuidePages } from "../generator-info.js";
+import { PackageManagerSchema } from "../schema.js";
+/** The guide page backing this tool, so it never drifts from the docs. */ const UPGRADING_GUIDE = 'upgrading';
+/**
+ * Add a tool which guides an agent through upgrading Nx and @aws/nx-plugin in a
+ * workspace, returning the `upgrading` docs page.
+ */ export const addUpgradeWorkspaceTool = (server, generators)=>{
+    server.registerTool('upgrade-workspace', {
+        title: 'Upgrade Workspace',
+        description: 'Tool for upgrading Nx and the Nx Plugin for AWS in a workspace. Use this when a user wants to update @aws/nx-plugin or Nx to a newer version, or asks how to run migrations with nx migrate.',
+        inputSchema: {
+            packageManager: PackageManagerSchema.optional()
+        }
+    }, async ({ packageManager })=>{
+        const guide = await fetchGuidePages([
+            UPGRADING_GUIDE
+        ], generators, packageManager);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: guide
+                }
+            ]
+        };
+    });
+};
+
+//# sourceMappingURL=upgrade-workspace.js.map

package/src/mcp-server/tools/upgrade-workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/mcp-server/tools/upgrade-workspace.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { NxGeneratorInfo } from '../../utils/generators.js';\nimport { fetchGuidePages } from '../generator-info.js';\nimport { PackageManagerSchema } from '../schema.js';\n\n/** The guide page backing this tool, so it never drifts from the docs. */\nconst UPGRADING_GUIDE = 'upgrading';\n\n/**\n * Add a tool which guides an agent through upgrading Nx and @aws/nx-plugin in a\n * workspace, returning the `upgrading` docs page.\n */\nexport const addUpgradeWorkspaceTool = (\n  server: McpServer,\n  generators: NxGeneratorInfo[],\n) => {\n  server.registerTool(\n    'upgrade-workspace',\n    {\n      title: 'Upgrade Workspace',\n      description:\n        'Tool for upgrading Nx and the Nx Plugin for AWS in a workspace. Use this when a user wants to update @aws/nx-plugin or Nx to a newer version, or asks how to run migrations with nx migrate.',\n      inputSchema: {\n        packageManager: PackageManagerSchema.optional(),\n      },\n    },\n    async ({ packageManager }) => {\n      const guide = await fetchGuidePages(\n        [UPGRADING_GUIDE],\n        generators,\n        packageManager,\n      );\n      return {\n        content: [\n          {\n            type: 'text' as const,\n            text: guide,\n          },\n        ],\n      };\n    },\n  );\n};\n"],"names":["fetchGuidePages","PackageManagerSchema","UPGRADING_GUIDE","addUpgradeWorkspaceTool","server","generators","registerTool","title","description","inputSchema","packageManager","optional","guide","content","type","text"],"mappings":"AAAA;;;CAGC,GAGD,SAASA,eAAe,QAAQ,uBAAuB;AACvD,SAASC,oBAAoB,QAAQ,eAAe;AAEpD,wEAAwE,GACxE,MAAMC,kBAAkB;AAExB;;;CAGC,GACD,OAAO,MAAMC,0BAA0B,CACrCC,QACAC;IAEAD,OAAOE,YAAY,CACjB,qBACA;QACEC,OAAO;QACPC,aACE;QACFC,aAAa;YACXC,gBAAgBT,qBAAqBU,QAAQ;QAC/C;IACF,GACA,OAAO,EAAED,cAAc,EAAE;QACvB,MAAME,QAAQ,MAAMZ,gBAClB;YAACE;SAAgB,EACjBG,YACAK;QAEF,OAAO;YACLG,SAAS;gBACP;oBACEC,MAAM;oBACNC,MAAMH;gBACR;aACD;QACH;IACF;AAEJ,EAAE"}

package/src/migrations/latest/add-assemble-target/metadata.json

@@ -0,0 +1,3 @@
+{
+  "description": "Add an assemble target as the artifact-only sibling of build, point the deploy targets at it, and narrow compile targets depending on ^build to ^compile"
+}

package/src/migrations/latest/add-assemble-target/migration.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type MigrationReturnObject, type Tree } from '@nx/devkit';
+export default function migration(tree: Tree): Promise<MigrationReturnObject>;

package/src/migrations/latest/add-assemble-target/migration.js

@@ -0,0 +1,241 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ import { getProjects, updateProjectConfiguration } from "@nx/devkit";
+import { INFRA_APP_GENERATOR_INFO } from "../../../infra/app/generator.js";
+import { TERRAFORM_PROJECT_GENERATOR_INFO } from "../../../terraform/project/generator.js";
+import { REACT_WEBSITE_APP_GENERATOR_INFO } from "../../../ts/react-website/app/generator.js";
+import { formatFilesInSubtree } from "../../../utils/format.js";
+import { normalizeTargetKeyOrder } from "../../../utils/nx.js";
+import { sortObjectKeys } from "../../../utils/object.js";
+/**
+ * `build` runs everything: it produces a project's deployable artifacts and runs
+ * its quality gates (lint, test, typecheck). The deploy targets depended on
+ * `^build`, so deploying pulled in every upstream project's gates too — work a
+ * deploy does not need.
+ *
+ * `assemble` is the artifact-only sibling of `build`, which the deploy targets
+ * depend on instead. `build` is untouched, so it remains the target that runs
+ * everything.
+ *
+ * Each project's `assemble` is derived from what its own `build` declares rather
+ * than from the generator that created it, so a project whose build has been
+ * extended with an extra artifact target keeps producing it. Anything this
+ * migration cannot classify is reported via `nextSteps` and left alone.
+ *
+ * A `compile` target depending on `^build` is also narrowed to `^compile`, which
+ * is what keeps `^assemble` from pulling the upstream quality gates back in.
+ *
+ * How to write a migration:
+ * - https://nx.dev/docs/kb/migration-generators
+ * - What `nextSteps` means: https://nx.dev/docs/reference/devkit/MigrationReturnObject
+ */ /**
+ * Targets that produce a deployable artifact, so they belong on `assemble`.
+ *
+ * `bundle-migration` and `bundle-create-db-user` are the RDB bundles, which the
+ * generator registers on `build` directly as well as on `bundle`.
+ */ const ARTIFACT_TARGETS = [
+    'compile',
+    'bundle',
+    'bundle-migration',
+    'bundle-create-db-user',
+    'docker',
+    'openapi',
+    'operations',
+    'synth',
+    'generate-ssdk'
+];
+/**
+ * Targets that check the code rather than produce an artifact. Listed so an
+ * unrecognised entry is reported rather than silently classified either way.
+ *
+ * `fmt` is the Terraform formatter, and `checkov` scans what the build has
+ * already produced, so neither produces an artifact of its own.
+ */ const QUALITY_GATES = [
+    'lint',
+    'format',
+    'fmt',
+    'test',
+    'typecheck',
+    'checkov'
+];
+/** The CDK targets whose `^build` becomes `^assemble`. */ const CDK_DEPLOY_TARGETS = [
+    'synth',
+    'deploy',
+    'deploy-sandbox',
+    'destroy',
+    'destroy-sandbox'
+];
+/** True when the project was created by the given generator. */ const generatedBy = (project, id)=>project.metadata?.generator === id;
+/**
+ * `generate:<name>` targets write generated source (an API client, operations
+ * metadata) that the infrastructure reads, so they produce artifacts.
+ */ const isGenerateTarget = (target)=>target.startsWith('generate:') || target === 'generate';
+/**
+ * The `assemble` dependencies derived from a project's `build`.
+ *
+ * Returns `'unclassifiable'` when `build` declares something this migration
+ * cannot classify, so the caller reports it rather than guessing. A `build` that
+ * declares nothing at all is not unclassifiable — it yields an empty list, and
+ * the project gets a no-op `assemble`.
+ */ const assembleDependenciesFor = (build)=>{
+    const dependsOn = build?.dependsOn;
+    if (dependsOn === undefined) return [];
+    if (!Array.isArray(dependsOn)) return 'unclassifiable';
+    const dependencies = [];
+    for (const dependency of dependsOn){
+        // The object form is valid Nx, and this plugin emits it. It names another
+        // project's target explicitly, so it is classified on that target.
+        if (typeof dependency !== 'string') {
+            const objectTarget = dependency?.target;
+            if (typeof objectTarget !== 'string') return 'unclassifiable';
+            if (objectTarget === 'build') {
+                dependencies.push({
+                    ...dependency,
+                    target: 'assemble'
+                });
+                continue;
+            }
+            if (ARTIFACT_TARGETS.includes(objectTarget) || isGenerateTarget(objectTarget)) {
+                dependencies.push(dependency);
+                continue;
+            }
+            if (QUALITY_GATES.includes(objectTarget)) continue;
+            return 'unclassifiable';
+        }
+        const [, crossProjectTarget] = dependency.match(/^.+:([^:]+)$/) ?? [];
+        if (crossProjectTarget === 'build') {
+            // Mirror the cross-project edge against the consumed project's own
+            // `assemble`, which keeps the artifact-only chain closed.
+            dependencies.push(dependency.replace(/:build$/, ':assemble'));
+            continue;
+        }
+        if (ARTIFACT_TARGETS.includes(crossProjectTarget)) {
+            // Already names an artifact target on the other project, so it carries
+            // over unchanged.
+            dependencies.push(dependency);
+            continue;
+        }
+        if (crossProjectTarget && QUALITY_GATES.includes(crossProjectTarget)) {
+            continue;
+        }
+        if (ARTIFACT_TARGETS.includes(dependency) || isGenerateTarget(dependency)) {
+            dependencies.push(dependency);
+            continue;
+        }
+        if (QUALITY_GATES.includes(dependency)) continue;
+        return 'unclassifiable';
+    }
+    return dependencies;
+};
+/**
+ * Adds the project's `assemble`, derived from its `build`. Returns whether the
+ * project was changed.
+ */ const addAssembleTarget = (projectName, project, nextSteps)=>{
+    // Already migrated. A project's own `package` target is deliberately left
+    // alone: that name is for publishing to a package manager, a different job.
+    if (project.targets.assemble) return false;
+    // Nothing to derive an `assemble` from, so there is nothing to do. Consumers
+    // reference `<project>:build`, which is untouched.
+    if (!project.targets.build) return false;
+    const dependencies = assembleDependenciesFor(project.targets.build);
+    if (dependencies === 'unclassifiable') {
+        // Consumers have already been repointed at this project's `assemble`, and Nx
+        // silently skips a dependency whose target does not exist, so say so: an
+        // unmigrated project here means its artifacts stop being built for a deploy.
+        nextSteps.push(`Add an 'assemble' target to ${projectName} by hand — its 'build' target declares dependencies this migration does not recognise. It should depend on whichever of build's dependencies produce deployable artifacts, and on none of its lint/test/typecheck gates. Projects that consume ${projectName} now depend on '${projectName}:assemble', and Nx silently skips a dependency on a target that does not exist, so until you add it a deploy will not rebuild this project's artifacts.`);
+        return false;
+    }
+    project.targets.assemble = normalizeTargetKeyOrder(dependencies.length > 0 ? {
+        dependsOn: dependencies
+    } : {
+        executor: 'nx:noop'
+    });
+    return true;
+};
+/** Repoints one entry of a target's `dependsOn`. */ const repoint = (target, from, to)=>{
+    const dependsOn = target?.dependsOn;
+    if (!Array.isArray(dependsOn)) return 'diverged';
+    if (dependsOn.includes(to)) return 'already';
+    const index = dependsOn.indexOf(from);
+    if (index === -1) return 'diverged';
+    dependsOn[index] = to;
+    return 'repointed';
+};
+/** Points a CDK infrastructure project's deploy targets at `^assemble`. */ const migrateCdkDeployTargets = (projectName, project, nextSteps)=>{
+    let changed = false;
+    const diverged = [];
+    for (const name of CDK_DEPLOY_TARGETS){
+        if (!project.targets[name]) continue;
+        const result = repoint(project.targets[name], '^build', '^assemble');
+        if (result === 'repointed') changed = true;
+        if (result === 'diverged') diverged.push(name);
+    }
+    if (diverged.length > 0) {
+        const targets = diverged.map((t)=>`'${t}'`).join(', ');
+        const singular = diverged.length === 1;
+        nextSteps.push(`Point ${targets} on ${projectName} at '^assemble' by hand — ${singular ? 'it does' : 'they do'} not depend on '^build' as the generator left ${singular ? 'it' : 'them'}.`);
+    }
+    return changed;
+};
+/**
+ * Points a Terraform application's `plan` at `assemble`, so planning no longer
+ * runs the module tests.
+ */ const migrateTerraformPlanTarget = (projectName, project, nextSteps)=>{
+    const result = repoint(project.targets.plan, 'build', 'assemble');
+    if (result === 'diverged') {
+        nextSteps.push(`Point 'plan' on ${projectName} at 'assemble' by hand — it does not depend on 'build' as the generator left it.`);
+    }
+    return result === 'repointed';
+};
+/**
+ * A website's `compile` needs its dependencies' declarations, which `compile`
+ * emits — not their lint or test results. Narrowing it is what keeps `^assemble`
+ * from pulling the upstream quality gates back in.
+ *
+ * Keyed off the target's shape rather than the generator, so a project that
+ * adopted the same `^build` compile is narrowed too. A project the plugin did
+ * not generate is reported, since its `compile` may depend on `^build` for a
+ * reason this migration cannot see.
+ */ const narrowCompileTarget = (projectName, project, nextSteps)=>{
+    if (repoint(project.targets.compile, '^build', '^compile') !== 'repointed') {
+        return false;
+    }
+    if (!generatedBy(project, REACT_WEBSITE_APP_GENERATOR_INFO.id)) {
+        nextSteps.push(`Narrowed 'compile' on ${projectName} from '^build' to '^compile', so it no longer waits for its dependencies' lint and test targets. Revert it if that project's compile relied on an upstream step that only 'build' runs.`);
+    }
+    return true;
+};
+export default async function migration(tree) {
+    const nextSteps = [];
+    for (const [projectName, project] of getProjects(tree)){
+        project.targets ??= {};
+        let changed = addAssembleTarget(projectName, project, nextSteps);
+        if (generatedBy(project, INFRA_APP_GENERATOR_INFO.id)) {
+            // `synth` is the cloud assembly, so it belongs on `assemble`; `checkov`
+            // scans that assembly and stays a `build`-only gate.
+            const assemble = project.targets.assemble;
+            if (assemble?.dependsOn && !assemble.dependsOn.includes('synth')) {
+                assemble.dependsOn.push('synth');
+                changed = true;
+            }
+            changed = migrateCdkDeployTargets(projectName, project, nextSteps) || changed;
+        }
+        if (generatedBy(project, TERRAFORM_PROJECT_GENERATOR_INFO.id) && project.projectType === 'application') {
+            changed = migrateTerraformPlanTarget(projectName, project, nextSteps) || changed;
+        }
+        changed = narrowCompileTarget(projectName, project, nextSteps) || changed;
+        if (changed) {
+            updateProjectConfiguration(tree, projectName, {
+                ...project,
+                targets: sortObjectKeys(project.targets)
+            });
+        }
+    }
+    await formatFilesInSubtree(tree);
+    return {
+        nextSteps
+    };
+}
+
+//# sourceMappingURL=migration.js.map

package/src/migrations/latest/add-assemble-target/migration.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../packages/nx-plugin/src/migrations/latest/add-assemble-target/migration.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport {\n  getProjects,\n  type MigrationReturnObject,\n  type ProjectConfiguration,\n  type Tree,\n  updateProjectConfiguration,\n} from '@nx/devkit';\nimport { INFRA_APP_GENERATOR_INFO } from '../../../infra/app/generator.js';\nimport { TERRAFORM_PROJECT_GENERATOR_INFO } from '../../../terraform/project/generator.js';\nimport { REACT_WEBSITE_APP_GENERATOR_INFO } from '../../../ts/react-website/app/generator.js';\nimport { formatFilesInSubtree } from '../../../utils/format.js';\nimport {\n  normalizeTargetKeyOrder,\n  type TargetDependency,\n} from '../../../utils/nx.js';\nimport { sortObjectKeys } from '../../../utils/object.js';\n\n/**\n * `build` runs everything: it produces a project's deployable artifacts and runs\n * its quality gates (lint, test, typecheck). The deploy targets depended on\n * `^build`, so deploying pulled in every upstream project's gates too — work a\n * deploy does not need.\n *\n * `assemble` is the artifact-only sibling of `build`, which the deploy targets\n * depend on instead. `build` is untouched, so it remains the target that runs\n * everything.\n *\n * Each project's `assemble` is derived from what its own `build` declares rather\n * than from the generator that created it, so a project whose build has been\n * extended with an extra artifact target keeps producing it. Anything this\n * migration cannot classify is reported via `nextSteps` and left alone.\n *\n * A `compile` target depending on `^build` is also narrowed to `^compile`, which\n * is what keeps `^assemble` from pulling the upstream quality gates back in.\n *\n * How to write a migration:\n * - https://nx.dev/docs/kb/migration-generators\n * - What `nextSteps` means: https://nx.dev/docs/reference/devkit/MigrationReturnObject\n */\n\n/**\n * Targets that produce a deployable artifact, so they belong on `assemble`.\n *\n * `bundle-migration` and `bundle-create-db-user` are the RDB bundles, which the\n * generator registers on `build` directly as well as on `bundle`.\n */\nconst ARTIFACT_TARGETS = [\n  'compile',\n  'bundle',\n  'bundle-migration',\n  'bundle-create-db-user',\n  'docker',\n  'openapi',\n  'operations',\n  'synth',\n  'generate-ssdk',\n];\n\n/**\n * Targets that check the code rather than produce an artifact. Listed so an\n * unrecognised entry is reported rather than silently classified either way.\n *\n * `fmt` is the Terraform formatter, and `checkov` scans what the build has\n * already produced, so neither produces an artifact of its own.\n */\nconst QUALITY_GATES = ['lint', 'format', 'fmt', 'test', 'typecheck', 'checkov'];\n\n/** The CDK targets whose `^build` becomes `^assemble`. */\nconst CDK_DEPLOY_TARGETS = [\n  'synth',\n  'deploy',\n  'deploy-sandbox',\n  'destroy',\n  'destroy-sandbox',\n];\n\n/** True when the project was created by the given generator. */\nconst generatedBy = (project: ProjectConfiguration, id: string): boolean =>\n  (project.metadata as { generator?: string } | undefined)?.generator === id;\n\n/**\n * `generate:<name>` targets write generated source (an API client, operations\n * metadata) that the infrastructure reads, so they produce artifacts.\n */\nconst isGenerateTarget = (target: string): boolean =>\n  target.startsWith('generate:') || target === 'generate';\n\n/**\n * The `assemble` dependencies derived from a project's `build`.\n *\n * Returns `'unclassifiable'` when `build` declares something this migration\n * cannot classify, so the caller reports it rather than guessing. A `build` that\n * declares nothing at all is not unclassifiable — it yields an empty list, and\n * the project gets a no-op `assemble`.\n */\nconst assembleDependenciesFor = (\n  build: ProjectConfiguration['targets'][string] | undefined,\n): TargetDependency[] | 'unclassifiable' => {\n  const dependsOn = build?.dependsOn;\n  if (dependsOn === undefined) return [];\n  if (!Array.isArray(dependsOn)) return 'unclassifiable';\n\n  const dependencies: TargetDependency[] = [];\n  for (const dependency of dependsOn) {\n    // The object form is valid Nx, and this plugin emits it. It names another\n    // project's target explicitly, so it is classified on that target.\n    if (typeof dependency !== 'string') {\n      const objectTarget = (dependency as { target?: unknown })?.target;\n      if (typeof objectTarget !== 'string') return 'unclassifiable';\n      if (objectTarget === 'build') {\n        dependencies.push({ ...dependency, target: 'assemble' });\n        continue;\n      }\n      if (\n        ARTIFACT_TARGETS.includes(objectTarget) ||\n        isGenerateTarget(objectTarget)\n      ) {\n        dependencies.push(dependency);\n        continue;\n      }\n      if (QUALITY_GATES.includes(objectTarget)) continue;\n      return 'unclassifiable';\n    }\n    const [, crossProjectTarget] = dependency.match(/^.+:([^:]+)$/) ?? [];\n    if (crossProjectTarget === 'build') {\n      // Mirror the cross-project edge against the consumed project's own\n      // `assemble`, which keeps the artifact-only chain closed.\n      dependencies.push(dependency.replace(/:build$/, ':assemble'));\n      continue;\n    }\n    if (ARTIFACT_TARGETS.includes(crossProjectTarget)) {\n      // Already names an artifact target on the other project, so it carries\n      // over unchanged.\n      dependencies.push(dependency);\n      continue;\n    }\n    if (crossProjectTarget && QUALITY_GATES.includes(crossProjectTarget)) {\n      continue;\n    }\n    if (ARTIFACT_TARGETS.includes(dependency) || isGenerateTarget(dependency)) {\n      dependencies.push(dependency);\n      continue;\n    }\n    if (QUALITY_GATES.includes(dependency)) continue;\n    return 'unclassifiable';\n  }\n  return dependencies;\n};\n\n/**\n * Adds the project's `assemble`, derived from its `build`. Returns whether the\n * project was changed.\n */\nconst addAssembleTarget = (\n  projectName: string,\n  project: ProjectConfiguration,\n  nextSteps: string[],\n): boolean => {\n  // Already migrated. A project's own `package` target is deliberately left\n  // alone: that name is for publishing to a package manager, a different job.\n  if (project.targets.assemble) return false;\n\n  // Nothing to derive an `assemble` from, so there is nothing to do. Consumers\n  // reference `<project>:build`, which is untouched.\n  if (!project.targets.build) return false;\n\n  const dependencies = assembleDependenciesFor(project.targets.build);\n\n  if (dependencies === 'unclassifiable') {\n    // Consumers have already been repointed at this project's `assemble`, and Nx\n    // silently skips a dependency whose target does not exist, so say so: an\n    // unmigrated project here means its artifacts stop being built for a deploy.\n    nextSteps.push(\n      `Add an 'assemble' target to ${projectName} by hand — its 'build' target declares dependencies this migration does not recognise. It should depend on whichever of build's dependencies produce deployable artifacts, and on none of its lint/test/typecheck gates. Projects that consume ${projectName} now depend on '${projectName}:assemble', and Nx silently skips a dependency on a target that does not exist, so until you add it a deploy will not rebuild this project's artifacts.`,\n    );\n    return false;\n  }\n\n  project.targets.assemble = normalizeTargetKeyOrder(\n    dependencies.length > 0\n      ? { dependsOn: dependencies }\n      : { executor: 'nx:noop' },\n  );\n  return true;\n};\n\n/** Repoints one entry of a target's `dependsOn`. */\nconst repoint = (\n  target: ProjectConfiguration['targets'][string] | undefined,\n  from: string,\n  to: string,\n): 'repointed' | 'already' | 'diverged' => {\n  const dependsOn = target?.dependsOn;\n  if (!Array.isArray(dependsOn)) return 'diverged';\n  if (dependsOn.includes(to)) return 'already';\n  const index = dependsOn.indexOf(from);\n  if (index === -1) return 'diverged';\n  dependsOn[index] = to;\n  return 'repointed';\n};\n\n/** Points a CDK infrastructure project's deploy targets at `^assemble`. */\nconst migrateCdkDeployTargets = (\n  projectName: string,\n  project: ProjectConfiguration,\n  nextSteps: string[],\n): boolean => {\n  let changed = false;\n  const diverged: string[] = [];\n\n  for (const name of CDK_DEPLOY_TARGETS) {\n    if (!project.targets[name]) continue;\n    const result = repoint(project.targets[name], '^build', '^assemble');\n    if (result === 'repointed') changed = true;\n    if (result === 'diverged') diverged.push(name);\n  }\n\n  if (diverged.length > 0) {\n    const targets = diverged.map((t) => `'${t}'`).join(', ');\n    const singular = diverged.length === 1;\n    nextSteps.push(\n      `Point ${targets} on ${projectName} at '^assemble' by hand — ${singular ? 'it does' : 'they do'} not depend on '^build' as the generator left ${singular ? 'it' : 'them'}.`,\n    );\n  }\n  return changed;\n};\n\n/**\n * Points a Terraform application's `plan` at `assemble`, so planning no longer\n * runs the module tests.\n */\nconst migrateTerraformPlanTarget = (\n  projectName: string,\n  project: ProjectConfiguration,\n  nextSteps: string[],\n): boolean => {\n  const result = repoint(project.targets.plan, 'build', 'assemble');\n  if (result === 'diverged') {\n    nextSteps.push(\n      `Point 'plan' on ${projectName} at 'assemble' by hand — it does not depend on 'build' as the generator left it.`,\n    );\n  }\n  return result === 'repointed';\n};\n\n/**\n * A website's `compile` needs its dependencies' declarations, which `compile`\n * emits — not their lint or test results. Narrowing it is what keeps `^assemble`\n * from pulling the upstream quality gates back in.\n *\n * Keyed off the target's shape rather than the generator, so a project that\n * adopted the same `^build` compile is narrowed too. A project the plugin did\n * not generate is reported, since its `compile` may depend on `^build` for a\n * reason this migration cannot see.\n */\nconst narrowCompileTarget = (\n  projectName: string,\n  project: ProjectConfiguration,\n  nextSteps: string[],\n): boolean => {\n  if (repoint(project.targets.compile, '^build', '^compile') !== 'repointed') {\n    return false;\n  }\n  if (!generatedBy(project, REACT_WEBSITE_APP_GENERATOR_INFO.id)) {\n    nextSteps.push(\n      `Narrowed 'compile' on ${projectName} from '^build' to '^compile', so it no longer waits for its dependencies' lint and test targets. Revert it if that project's compile relied on an upstream step that only 'build' runs.`,\n    );\n  }\n  return true;\n};\n\nexport default async function migration(\n  tree: Tree,\n): Promise<MigrationReturnObject> {\n  const nextSteps: string[] = [];\n\n  for (const [projectName, project] of getProjects(tree)) {\n    project.targets ??= {};\n\n    let changed = addAssembleTarget(projectName, project, nextSteps);\n\n    if (generatedBy(project, INFRA_APP_GENERATOR_INFO.id)) {\n      // `synth` is the cloud assembly, so it belongs on `assemble`; `checkov`\n      // scans that assembly and stays a `build`-only gate.\n      const assemble = project.targets.assemble;\n      if (assemble?.dependsOn && !assemble.dependsOn.includes('synth')) {\n        assemble.dependsOn.push('synth');\n        changed = true;\n      }\n      changed =\n        migrateCdkDeployTargets(projectName, project, nextSteps) || changed;\n    }\n\n    if (\n      generatedBy(project, TERRAFORM_PROJECT_GENERATOR_INFO.id) &&\n      project.projectType === 'application'\n    ) {\n      changed =\n        migrateTerraformPlanTarget(projectName, project, nextSteps) || changed;\n    }\n\n    changed = narrowCompileTarget(projectName, project, nextSteps) || changed;\n\n    if (changed) {\n      updateProjectConfiguration(tree, projectName, {\n        ...project,\n        targets: sortObjectKeys(project.targets),\n      });\n    }\n  }\n\n  await formatFilesInSubtree(tree);\n\n  return { nextSteps };\n}\n"],"names":["getProjects","updateProjectConfiguration","INFRA_APP_GENERATOR_INFO","TERRAFORM_PROJECT_GENERATOR_INFO","REACT_WEBSITE_APP_GENERATOR_INFO","formatFilesInSubtree","normalizeTargetKeyOrder","sortObjectKeys","ARTIFACT_TARGETS","QUALITY_GATES","CDK_DEPLOY_TARGETS","generatedBy","project","id","metadata","generator","isGenerateTarget","target","startsWith","assembleDependenciesFor","build","dependsOn","undefined","Array","isArray","dependencies","dependency","objectTarget","push","includes","crossProjectTarget","match","replace","addAssembleTarget","projectName","nextSteps","targets","assemble","length","executor","repoint","from","to","index","indexOf","migrateCdkDeployTargets","changed","diverged","name","result","map","t","join","singular","migrateTerraformPlanTarget","plan","narrowCompileTarget","compile","migration","tree","projectType"],"mappings":"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"}

package/src/migrations/latest/add-destroy-sandbox-target/metadata.json

@@ -0,0 +1,3 @@
+{
+  "description": "Add a destroy-sandbox target to CDK infrastructure projects which destroys the sandbox stage, and drop the --require-approval flag from cdk destroy, which has no such option"
+}