fix(cli): cdk ls returns stack id instead of stack display name

[SankyRed]

Issue # (if applicable)

Closes #29420

Reason for this change

The cdk list functionality displays the stacks .

For instance

> cdk ls
producer
consumer

With the latest changes for list stack dependencies we did add a new flag -d to show the dependencies.

The dependencies between stacks can be established in 2 ways:

1. Using the resource defined from one stack in another.
2. Using addDependency() to add dependency among stacks.

Current we are fetching the dependency details through the CloudStackArtifact.

• Establishing the dependency between stacks through the first method would have the same displayName and id for the stacks.
  Using the -d flag to display dependencies -

❯ cdk list --show-dependencies
- id: producer
  dependencies: []
- id: consumer
  dependencies:
    - id: producer
      dependencies: []

• Establishing the dependency through addDependency() will create a different displayName and id.
  In such a case when a user runs cdk ls we would want to show the displayName and if not present then use the id

For instance:

> cdk ls
producer
producer/consumer

With the -d flag we would want to display something like:

> cdk ls -d
- id: producer
  dependencies: []
- id: producer/consumer
  dependencies:
    - id: producer
      dependencies: []

With our previous change we didn't consider displayName and just fetched ids which changes the previous functionality and caused a regression.

Description of changes

With the new changes we are looking out for displayName first and if it does not exist we fetch the id.

Description of how you validated changes

Added a new unit test and updated integ tests.

Checklist

• My code adheres to the CONTRIBUTING GUIDE and DESIGN GUIDELINES

---

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license

[aws-cdk-automation]

The pull request linter has failed. See the aws-cdk-automation comment below for failure reasons. If you believe this pull request should receive an exemption, please comment and provide a justification.

A comment requesting an exemption should contain the text Exemption Request. Additionally, if clarification is needed add Clarification Request to a comment.

[aws-cdk-automation]

➡️ PR build request submitted to test-main-pipeline ⬅️

A maintainer must now check the pipeline and add the pr-linter/cli-integ-tested label once the pipeline succeeds.

✅ Updated pull request passes all PRLinter validations. Dismissing previous PRLinter review.

[aws-cdk-automation]

AWS CodeBuild CI Report

• CodeBuild project: AutoBuildv2Project1C6BFA3F-wQm2hXv2jqQv
• Commit ID: 406e66c
• Result: SUCCEEDED
• Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

[mergify]

Thank you for contributing! Your pull request will be updated from main and then merged automatically (do not update manually, and be sure to allow changes to be pushed to your fork).