unresolve tokens for annotations

Author: go-to-k

packages/aws-cdk-lib/core/lib/stack-synthesizers/_shared.ts

@@ -100,7 +100,23 @@ function collectStackMetadata(stack: Stack) {
 
     if (node.node.metadata.length > 0) {
       // Make the path absolute
-      output[Node.PATH_SEP + node.node.path] = node.node.metadata.map(md => stack.resolve(md) as cxschema.MetadataEntry);
+      output[Node.PATH_SEP + node.node.path] = node.node.metadata.map(md => {
+        // If Annotations include a token, the message is resolved and output as `[object Object]` after synth
+        // because the message will be object type using 'Fn::Join'.
+        // It would be easier for users to understand if the message from Annotations were output in token form,
+        // rather than in `[object Object]` or in object type using 'Fn::Join'.
+        // Therefore, we don't resolve the message if it's from Annotations.
+        if ([
+          cxschema.ArtifactMetadataEntryType.ERROR,
+          cxschema.ArtifactMetadataEntryType.WARN,
+          cxschema.ArtifactMetadataEntryType.INFO,
+        ].includes(md.type as cxschema.ArtifactMetadataEntryType)) {
+          return md;
+        }
+
+        const resolved = stack.resolve(md);
+        return resolved as cxschema.MetadataEntry;
+      });
     }
 
     for (const child of node.node.children) {