aws-amplify · sai-ray · Mar 17, 2026 · Mar 17, 2026 · Mar 17, 2026 · Mar 17, 2026
@@ -67,6 +67,7 @@
   "captcha",
   "cfn",
   "cfnlambda",
+  "changeset",
   "chatbot",
   "chatbots",
   "chdir",
@@ -330,9 +331,12 @@
   "regenerator",
   "regexes",
   "rekognition",
+  "renderer",
   "repo",
   "reqheaders",
   "resolvers",
+  "refactorer",
+  "refactorers",
   "rethrow",
   "retrier",
   "rimraf",

@@ -39,18 +39,24 @@ Verify your changes by following these guidelines:
 - **Always** update the appropriate JSDoc strings in the code you change. Be concise.
 - Do not create additional markdown files in the repository unless you are instructed explicitly to.
 - Never commit `.ai-generated` files (`.commit-message.ai-generated.txt`, `.pr-body.ai-generated.md`, etc.) — they are gitignored and are only used as local scratch files.
-- Commit your changes in git using a well-formed commit message following the Conventional Commits format. The message must start
-  with a type prefix (e.g., `feat:`, `fix:`, `docs:`, `refactor:`, `test:`, `chore:`) followed by a single sentence summary and no more
+- Commit your changes in git using a well-formed commit message following the Conventional Commits format. The message must include
+  a scope when the change is scoped to a specific package: `type(scope): subject`. The scope is derived from the package's `name`
+  field in `package.json` with the `@aws-amplify/` prefix stripped. For example, `@aws-amplify/cli-internal` → `cli-internal`,
+  `@aws-amplify/amplify-prompts` → `amplify-prompts`. Valid scopes are enforced by commitlint via `commitlint.config.js`. The
+  message must start with a type prefix (e.g., `feat:`, `fix:`, `docs:`, `refactor:`, `test:`, `chore:`) followed by a single sentence summary and no more
   than a few paragraphs explaining the change and your testing. After this explanation, place the prompt the user used to trigger this
   work prefixed with a "Prompt: " after a single line consisting of '---'. Make sure there are no empty lines before or after this line.
   Word wrap all paragraphs at 72 columns including the prompt. For the author of the commit, use the configured username in git with
   ' (AI)' appended and the user email. For example, `git commit --author="John Doe (AI) <john@bigco.com>" -m "docs: update configuration guide"`.
   To avoid issues with multi-line commit messages, write the message to `.commit-message.ai-generated.txt` and use `-F`:
 
   ```bash
-  git commit --author="John Doe (AI) <john@bigco.com>" -F .commit-message.ai-generated.txt
+  NODE_OPTIONS="--max-old-space-size=8192" git commit --author="John Doe (AI) <john@bigco.com>" -F .commit-message.ai-generated.txt
   ```
 
+  Always set `NODE_OPTIONS="--max-old-space-size=8192"` when committing to prevent OOM failures in the lint-staged hook.
+  After a successful commit, delete the scratch file: `rm -f .commit-message.ai-generated.txt`.
+
 - Since this repo has a commit hook that takes quite a long time to run, don't immediately commit every
   change you were asked to do. Apply your judgment, if the diff is still fairly small just keep going.
   Otherwise, ask the user if they want to commit or keep going.

@@ -129,6 +129,43 @@ funcGenerator.setAuthGenerator(authGenerator);
 
 ---
 
+### Don't mutate module-level constant objects
+
+`const` prevents reassignment but does not prevent mutation of the object's properties. A module-level `const` object that gets passed to a function and mutated there silently becomes shared mutable state — every subsequent caller sees the mutations from previous calls.
+
+This is especially dangerous when the constant looks like a template or default value that multiple callers use as a starting point. The first caller mutates it, and the second caller unknowingly starts with the first caller's leftovers.
+
+```typescript
+// Bad — shared object mutated by callers
+const EMPTY_TEMPLATE = { Resources: {} };
+
+function createStack(resources: Record<string, Resource>) {
+  const template = EMPTY_TEMPLATE; // not a copy!
+  for (const [id, r] of Object.entries(resources)) {
+    template.Resources[id] = r; // mutates the shared constant
+  }
+  return template;
+}
+
+// Second call sees resources from the first call
+createStack({ BucketA: bucket });
+createStack({ BucketB: bucket }); // template now has both BucketA and BucketB
+```
+
+**Instead:** Clone the object before mutating it, or use a factory function that returns a fresh object each time.
+
+```typescript
+// Good — clone before use
+const template = JSON.parse(JSON.stringify(EMPTY_TEMPLATE));
+
+// Good — factory function
+function emptyTemplate() {
+  return { Resources: {} };
+}
+```
+
+---
+
 ### Prefer `const` over `let`
 
 Avoid `let` when the code can be restructured to use `const` instead. Even when `let` is technically correct (the variable is reassigned), the reassignment pattern itself is often the problem — it usually means branching logic is being used to populate variables that are consumed later, making it hard to reason about what values they hold at any given point.

@@ -204,10 +204,6 @@
           "authenticated": "arn:aws:iam::123456789012:role/amplify-backendonly-ge-amplifyAuthauthenticatedU-NrnOsacJVeCr"
         }
       },
-      "DependsOn": [
-        "amplifyAuthIdentityPool3FDE84CC",
-        "amplifyAuthUserPoolAppClient2626C6F8"
-      ],
       "Metadata": {
         "aws:cdk:path": "amplify-backendonly-gen2main-branch-8e0f260810/auth/amplifyAuth/IdentityPoolRoleAttachment"
       }

@@ -69,9 +69,6 @@
         "ServiceToken": "arn:aws:lambda:us-east-1:123456789012:function:amplify-backendonly-gen2main-branch-8e0f260810-storage0EC3F24A-1BTE7UH0TFE2I/CustomS3AutoDeleteObjectsCustomResourceProviderHandler9D90184F",
         "BucketName": "amplify-backendonly-ge-backendonlycb1a13ab81664-hysxrjfwrstc"
       },
-      "DependsOn": [
-        "backendonlycb1a13ab81664ecaa7d015068ab2d0165e0fagen2mainBucketPolicy14D90AB6"
-      ],
       "UpdateReplacePolicy": "Delete",
       "DeletionPolicy": "Delete",
       "Metadata": {
@@ -128,9 +125,6 @@
           ]
         }
       },
-      "DependsOn": [
-        "CustomS3AutoDeleteObjectsCustomResourceProviderRole3B1BD092"
-      ],
       "Metadata": {
         "aws:cdk:path": "amplify-backendonly-gen2main-branch-8e0f260810/storage/Custom::S3AutoDeleteObjectsCustomResourceProvider/Handler",
         "aws:asset:path": "asset.faa95a81ae7d7373f3e1f242268f904eb748d8d0fdd306e8a6fe515a1905a7d6",

@@ -168,10 +168,7 @@
           "RefreshToken": "days"
         },
         "UserPoolId": "us-east-1_1rvCNKN5B"
-      },
-      "DependsOn": [
-        "amplifyAuthUserPool4BA7F805"
-      ]
+      }
     },
     "amplifyAuthUserPoolNativeAppClient79534448": {
       "Type": "AWS::Cognito::UserPoolClient",
@@ -183,10 +180,7 @@
           "RefreshToken": "days"
         },
         "UserPoolId": "us-east-1_1rvCNKN5B"
-      },
-      "DependsOn": [
-        "amplifyAuthUserPool4BA7F805"
-      ]
+      }
     },
     "amplifyAuthIdentityPool3FDE84CC": {
       "Type": "AWS::Cognito::IdentityPool",
@@ -241,10 +235,7 @@
           "unauthenticated": "arn:aws:iam::123456789012:role/amplify-backendonly-main-5e0fa-unauthRole",
           "authenticated": "arn:aws:iam::123456789012:role/amplify-backendonly-main-5e0fa-authRole"
         }
-      },
-      "DependsOn": [
-        "amplifyAuthIdentityPool3FDE84CC"
-      ]
+      }
     }
   },
   "Conditions": {

@@ -213,7 +213,6 @@
           "amplify-backendonly-main-5e0fa-authRole"
         ]
       },
-      "DependsOn": [],
       "Condition": "CreateAuthPublic"
     },
     "S3AuthProtectedPolicy": {
@@ -250,7 +249,6 @@
           "amplify-backendonly-main-5e0fa-authRole"
         ]
       },
-      "DependsOn": [],
       "Condition": "CreateAuthProtected"
     },
     "S3AuthPrivatePolicy": {
@@ -287,7 +285,6 @@
           "amplify-backendonly-main-5e0fa-authRole"
         ]
       },
-      "DependsOn": [],
       "Condition": "CreateAuthPrivate"
     },
     "S3AuthUploadPolicy": {
@@ -324,7 +321,6 @@
           "amplify-backendonly-main-5e0fa-authRole"
         ]
       },
-      "DependsOn": [],
       "Condition": "CreateAuthUploads"
     },
     "S3GuestPublicPolicy": {
@@ -361,7 +357,6 @@
           "amplify-backendonly-main-5e0fa-unauthRole"
         ]
       },
-      "DependsOn": [],
       "Condition": "CreateGuestPublic"
     },
     "S3AuthReadPolicy": {
@@ -416,7 +411,6 @@
           "amplify-backendonly-main-5e0fa-authRole"
         ]
       },
-      "DependsOn": [],
       "Condition": "AuthReadAndList"
     },
     "S3GuestReadPolicy": {
@@ -469,7 +463,6 @@
           "amplify-backendonly-main-5e0fa-unauthRole"
         ]
       },
-      "DependsOn": [],
       "Condition": "GuestReadAndList"
     }
   }

@@ -69,9 +69,6 @@
         "ServiceToken": "arn:aws:lambda:us-east-1:123456789012:function:amplify-backendonly-gen2main-branch-8e0f260810-storage0EC3F24A-1BTE7UH0TFE2I/CustomS3AutoDeleteObjectsCustomResourceProviderHandler9D90184F",
         "BucketName": "amplify-backendonly-ge-backendonlycb1a13ab81664-hysxrjfwrstc"
       },
-      "DependsOn": [
-        "backendonlycb1a13ab81664ecaa7d015068ab2d0165e0fagen2mainBucketPolicy14D90AB6"
-      ],
       "UpdateReplacePolicy": "Delete",
       "DeletionPolicy": "Delete",
       "Metadata": {
@@ -128,9 +125,6 @@
           ]
         }
       },
-      "DependsOn": [
-        "CustomS3AutoDeleteObjectsCustomResourceProviderRole3B1BD092"
-      ],
       "Metadata": {
         "aws:cdk:path": "amplify-backendonly-gen2main-branch-8e0f260810/storage/Custom::S3AutoDeleteObjectsCustomResourceProvider/Handler",
         "aws:asset:path": "asset.faa95a81ae7d7373f3e1f242268f904eb748d8d0fdd306e8a6fe515a1905a7d6",

@@ -303,10 +303,6 @@
           "authenticated": "arn:aws:iam::123456789012:role/amplify-backendonly-ge-amplifyAuthauthenticatedU-NrnOsacJVeCr"
         }
       },
-      "DependsOn": [
-        "amplifyAuthIdentityPool3FDE84CC",
-        "amplifyAuthUserPoolAppClient2626C6F8"
-      ],
       "Metadata": {
         "aws:cdk:path": "amplify-backendonly-gen2main-branch-8e0f260810/auth/amplifyAuth/IdentityPoolRoleAttachment"
       }

@@ -141,9 +141,6 @@
         "ServiceToken": "arn:aws:lambda:us-east-1:123456789012:function:amplify-backendonly-gen2main-branch-8e0f260810-storage0EC3F24A-1BTE7UH0TFE2I/CustomS3AutoDeleteObjectsCustomResourceProviderHandler9D90184F",
         "BucketName": "amplify-backendonly-ge-backendonlycb1a13ab81664-hysxrjfwrstc"
       },
-      "DependsOn": [
-        "backendonlycb1a13ab81664ecaa7d015068ab2d0165e0fagen2mainBucketPolicy14D90AB6"
-      ],
       "UpdateReplacePolicy": "Delete",
       "DeletionPolicy": "Delete",
       "Metadata": {
@@ -200,9 +197,6 @@
           ]
         }
       },
-      "DependsOn": [
-        "CustomS3AutoDeleteObjectsCustomResourceProviderRole3B1BD092"
-      ],
       "Metadata": {
         "aws:cdk:path": "amplify-backendonly-gen2main-branch-8e0f260810/storage/Custom::S3AutoDeleteObjectsCustomResourceProvider/Handler",
         "aws:asset:path": "asset.faa95a81ae7d7373f3e1f242268f904eb748d8d0fdd306e8a6fe515a1905a7d6",

@@ -177,10 +177,7 @@
           "RefreshToken": "days"
         },
         "UserPoolId": "us-east-1_1rvCNKN5B"
-      },
-      "DependsOn": [
-        "UserPool"
-      ]
+      }
     },
     "UserPoolClient": {
       "Type": "AWS::Cognito::UserPoolClient",
@@ -192,10 +189,7 @@
           "RefreshToken": "days"
         },
         "UserPoolId": "us-east-1_1rvCNKN5B"
-      },
-      "DependsOn": [
-        "UserPool"
-      ]
+      }
     },
     "UserPoolClientRole": {
       "Type": "AWS::IAM::Role",
@@ -288,10 +282,7 @@
           "unauthenticated": "arn:aws:iam::123456789012:role/amplify-backendonly-main-5e0fa-unauthRole",
           "authenticated": "arn:aws:iam::123456789012:role/amplify-backendonly-main-5e0fa-authRole"
         }
-      },
-      "DependsOn": [
-        "IdentityPool"
-      ]
+      }
     }
   },
   "Outputs": {

@@ -277,7 +277,6 @@
           "amplify-backendonly-main-5e0fa-authRole"
         ]
       },
-      "DependsOn": [],
       "Condition": "CreateAuthPublic"
     },
     "S3AuthProtectedPolicy": {
@@ -314,7 +313,6 @@
           "amplify-backendonly-main-5e0fa-authRole"
         ]
       },
-      "DependsOn": [],
       "Condition": "CreateAuthProtected"
     },
     "S3AuthPrivatePolicy": {
@@ -351,7 +349,6 @@
           "amplify-backendonly-main-5e0fa-authRole"
         ]
       },
-      "DependsOn": [],
       "Condition": "CreateAuthPrivate"
     },
     "S3AuthUploadPolicy": {
@@ -388,7 +385,6 @@
           "amplify-backendonly-main-5e0fa-authRole"
         ]
       },
-      "DependsOn": [],
       "Condition": "CreateAuthUploads"
     },
     "S3GuestPublicPolicy": {
@@ -425,7 +421,6 @@
           "amplify-backendonly-main-5e0fa-unauthRole"
         ]
       },
-      "DependsOn": [],
       "Condition": "CreateGuestPublic"
     },
     "S3AuthReadPolicy": {
@@ -480,7 +475,6 @@
           "amplify-backendonly-main-5e0fa-authRole"
         ]
       },
-      "DependsOn": [],
       "Condition": "AuthReadAndList"
     },
     "S3GuestReadPolicy": {
@@ -533,7 +527,6 @@
           "amplify-backendonly-main-5e0fa-unauthRole"
         ]
       },
-      "DependsOn": [],
       "Condition": "GuestReadAndList"
     }
   }

@@ -209,10 +209,6 @@
           "authenticated": "arn:aws:iam::123456789012:role/amplify-discussions-ge-amplifyAuthauthenticatedU-fjzgnNdQ7Oe2"
         }
       },
-      "DependsOn": [
-        "amplifyAuthIdentityPool3FDE84CC",
-        "amplifyAuthUserPoolAppClient2626C6F8"
-      ],
       "Metadata": {
         "aws:cdk:path": "amplify-discussions-gen2main-branch-a27e51c30a/auth/amplifyAuth/IdentityPoolRoleAttachment"
       }

@@ -69,9 +69,6 @@
         "ServiceToken": "arn:aws:lambda:us-east-1:123456789012:function:amplify-discussions-gen2main-branch-a27e51c30a-storage0EC3F24A-O1Q835F0QK5N/CustomS3AutoDeleteObjectsCustomResourceProviderHandler9D90184F",
         "BucketName": "amplify-discussions-ge-discusavatarsc39a5gen2ma-tofeojsv2jx4"
       },
-      "DependsOn": [
-        "discusavatarsc39a5gen2mainBucketPolicy73EB7DB2"
-      ],
       "UpdateReplacePolicy": "Delete",
       "DeletionPolicy": "Delete",
       "Metadata": {
@@ -128,9 +125,6 @@
           ]
         }
       },
-      "DependsOn": [
-        "CustomS3AutoDeleteObjectsCustomResourceProviderRole3B1BD092"
-      ],
       "Metadata": {
         "aws:cdk:path": "amplify-discussions-gen2main-branch-a27e51c30a/storage/Custom::S3AutoDeleteObjectsCustomResourceProvider/Handler",
         "aws:asset:path": "asset.faa95a81ae7d7373f3e1f242268f904eb748d8d0fdd306e8a6fe515a1905a7d6",