@aws/nx-plugin-mcp 1.0.0-rc.86 → 1.0.0-rc.87

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/bin/aws-nx-mcp.js CHANGED
@@ -54023,7 +54023,7 @@ ${PACKAGE_MANAGERS.map((pm) => buildNxCommand("<options>", pm)).join(" - \n")}
54023
54023
  - Generate all projects into the \`packages/\` directory
54024
54024
  - After making changes to your projects, fix linting issues, then run a full build
54025
54025
  - 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.
54026
- - 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\`.
54026
+ - 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.
54027
54027
 
54028
54028
  ## Batching Generators
54029
54029
 
@@ -269,7 +269,7 @@ export class GameApi<
269
269
  pattern: 'isolated',
270
270
  operations: routerToOperations(appRouter),
271
271
  defaultIntegrationOptions: {
272
- runtime: Runtime.NODEJS_LATEST,
272
+ runtime: Runtime.NODEJS_24_X,
273
273
  handler: 'index.handler',
274
274
  code: Code.fromAsset(
275
275
  url.fileURLToPath(
@@ -34,7 +34,7 @@ We recommend you try your hand at extending the codebase with the following capa
34
34
 
35
35
  1. To destroy the AWS resources that were created, run the following command:
36
36
 
37
- <NxCommands commands={['destroy infra "dungeon-adventure-infra-sandbox/*"']} />
37
+ <NxCommands commands={['destroy-sandbox infra']} />
38
38
 
39
39
  This will prompt you for a list of stacks to delete which should comprise of the `dungeon-adventure-infra-sandbox/Application/GameUI/waf` and `dungeon-adventure-infra-sandbox/Application`.
40
40
 
@@ -117,6 +117,12 @@ Finally, verify everything still builds, then delete `migrations.json` and commi
117
117
 
118
118
  <PackageManagerShortCommand commands={['build']} />
119
119
 
120
+ <Aside type="caution" title="Some infrastructure changes are not migrated">
121
+ Migrations don't cover every change to the infrastructure we vend. Where updating an already-deployed stack would fail or destroy data, no migration is provided — your workspace keeps deploying the resources it deploys today, while a newly generated workspace gets the newer shape.
122
+
123
+ To pick those changes up, compare your infrastructure against what today's generators produce and apply the parts you want by hand, taking care over the deployment path for your existing resources.
124
+ </Aside>
125
+
120
126
  ## Upgrading with an AI agent
121
127
 
122
128
  The whole flow can be driven by an AI coding agent end to end — nothing blocks on an interactive terminal. When `nx migrate --run-migrations` runs from inside an agent, Nx detects this, skips the agentic consent prompt, and instead of spawning a nested agent it **defers** each prompt migration back to the agent driving the run:
@@ -102,7 +102,7 @@ new ApplicationStage(app, 'my-app-sandbox', {
102
102
 
103
103
  The `env` property tells CDK which AWS account and region to deploy to. `CDK_DEFAULT_ACCOUNT` and `CDK_DEFAULT_REGION` are resolved automatically by the CDK CLI from your active AWS credentials. See the [CDK environments documentation](https://docs.aws.amazon.com/cdk/v2/guide/environments.html) for more details.
104
104
 
105
- The sandbox stage is the one the <Link path="guides/typescript-infrastructure#deploying-your-sandbox-stage">`deploy-sandbox` target</Link> deploys.
105
+ The sandbox stage is the one the <Link path="guides/typescript-infrastructure#deploying-your-sandbox-stage">`deploy-sandbox`</Link> and <Link path="guides/typescript-infrastructure#tearing-down-your-sandbox-stage">`destroy-sandbox`</Link> targets act on.
106
106
 
107
107
  If you generated with `stageConfig`, the `main.ts` reads account and region from a centralized config file instead, falling back to environment variables when no config is set:
108
108
 
@@ -421,10 +421,34 @@ This target differs slightly from the regular `deploy` target in that it deploys
421
421
 
422
422
  ## Tearing Down AWS Infrastructure
423
423
 
424
- Use the `destroy` target to tear down your resources:
424
+ Your project has three destroy targets, mirroring the deploy ones:
425
+
426
+ | Target | Use it for |
427
+ | ----------------- | ------------------------------------------------------------------------- |
428
+ | `destroy-sandbox` | Tearing down your own sandbox stage. No stage argument needed. |
429
+ | `destroy` | Tearing down any stage, by naming the stage or stacks you want. |
430
+ | `destroy-ci` | Tearing down from a CI/CD pipeline, using a pre-synthesized cloud assembly. |
431
+
432
+ ### Tearing Down your Sandbox Stage
433
+
434
+ The `destroy-sandbox` target tears down the sandbox stage that `main.ts` declares, so you don't need to remember its stage name:
435
+
436
+ <NxCommands commands={['destroy-sandbox <my-infra>']} />
437
+
438
+ Destroying is irreversible, so CDK asks you to confirm the stacks it is about to delete. Pass `--force` to skip that confirmation, which is what you want when there is no terminal attached (in a script, say):
439
+
440
+ <NxCommands commands={['destroy-sandbox <my-infra> --force']} />
441
+
442
+ ### Tearing Down a Specific Stage
443
+
444
+ The `destroy` target tears down whichever stage or stacks you name:
425
445
 
426
446
  <NxCommands commands={['destroy <my-infra> <my-infra>-sandbox/*']} />
427
447
 
448
+ To tear down an individual stack, give the full stack name:
449
+
450
+ <NxCommands commands={['destroy <my-infra> <my-infra>-sandbox/Application']} />
451
+
428
452
  ## More Information
429
453
 
430
454
  For more information about CDK, please refer to the [CDK Developer Guide](https://docs.aws.amazon.com/cdk/v2/guide/core_concepts.html) and [API Reference](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-construct-library.html).
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aws/nx-plugin-mcp",
3
- "version": "1.0.0-rc.86",
3
+ "version": "1.0.0-rc.87",
4
4
  "repository": {
5
5
  "type": "git",
6
6
  "url": "https://github.com/awslabs/nx-plugin-for-aws.git",