feat: modify a single feature flag configuration (#738)

This change allows a user to modify a single feature flag value, view
the difference in CloudFormation templates, and accept or reject the
change.

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

Author: vivian12300

.projenrc.ts

@@ -21,9 +21,6 @@ import { TypecheckTests } from './projenrc/TypecheckTests';
 
 const TYPESCRIPT_VERSION = '5.8';
 
-// This is a temporary aws-cdk-lib version until this PR is released: https://github.com/aws/aws-cdk/pull/34919
-const AWS_CDK_LIB_VERSION = '2.203.0';
-
 /**
  * When adding an SDK dependency for a library, use this function
  *
@@ -854,7 +851,7 @@ const toolkitLib = configureProject(
       '@smithy/util-stream',
       '@types/fs-extra',
       '@types/split2',
-      `aws-cdk-lib@${AWS_CDK_LIB_VERSION}`,
+      'aws-cdk-lib',
       'aws-sdk-client-mock',
       'aws-sdk-client-mock-jest',
       'fast-check',

packages/@aws-cdk/toolkit-lib/.projen/deps.json

@@ -133,6 +133,7 @@ Please let us know by [opening an issue](https://github.com/aws/aws-cdk-cli/issu
 | `CDK_TOOLKIT_I9210` | Confirm the deletion of a batch of assets | `info` | {@link AssetBatchDeletionRequest} |
 | `CDK_TOOLKIT_I9900` | Bootstrap results on success | `result` | [cxapi.Environment](https://docs.aws.amazon.com/cdk/api/v2/docs/@aws-cdk_cx-api.Environment.html) |
 | `CDK_TOOLKIT_E9900` | Bootstrap failed | `error` | {@link ErrorPayload} |
+| `CDK_TOOLKIT_I9300` | Confirm the feature flag configuration changes | `info` | {@link FeatureFlagChangeRequest} |
 | `CDK_TOOLKIT_I0100` | Notices decoration (the header or footer of a list of notices) | `info` | n/a |
 | `CDK_TOOLKIT_W0101` | A notice that is marked as a warning | `warn` | n/a |
 | `CDK_TOOLKIT_E0101` | A notice that is marked as an error | `error` | n/a |

packages/@aws-cdk/toolkit-lib/.projen/tasks.json

@@ -7,6 +7,7 @@ import type { MissingContext, UpdatedContext } from '../../../payloads/context';
 import type { BuildAsset, DeployConfirmationRequest, PublishAsset, StackDeployProgress, SuccessfulDeployStackResult } from '../../../payloads/deploy';
 import type { StackDestroy, StackDestroyProgress } from '../../../payloads/destroy';
 import type { DriftResultPayload } from '../../../payloads/drift';
+import type { FeatureFlagChangeRequest } from '../../../payloads/flags';
 import type { AssetBatchDeletionRequest } from '../../../payloads/gc';
 import type { HotswapDeploymentDetails, HotswapDeploymentAttempt, HotswappableChange, HotswapResult } from '../../../payloads/hotswap';
 import type { ResourceIdentificationRequest, ResourceImportRequest } from '../../../payloads/import';
@@ -416,6 +417,13 @@ export const IO = {
     interface: 'ErrorPayload',
   }),
 
+  // flags (93xxx)
+  CDK_TOOLKIT_I9300: make.info<FeatureFlagChangeRequest>({
+    code: 'CDK_TOOLKIT_I9300',
+    description: 'Confirm the feature flag configuration changes',
+    interface: 'FeatureFlagChangeRequest',
+  }),
+
   // Notices
   CDK_TOOLKIT_I0100: make.info({
     code: 'CDK_TOOLKIT_I0100',

packages/@aws-cdk/toolkit-lib/docs/message-registry.md

@@ -0,0 +1,11 @@
+import type { DataRequest } from './types';
+
+/**
+ * Request to confirm or deny the feature flag configuration changes.
+ *
+ */
+export interface FeatureFlagChangeRequest extends DataRequest {
+  readonly flagName: string;
+  readonly currentValue?: boolean;
+  readonly newValue: boolean;
+}

packages/@aws-cdk/toolkit-lib/lib/api/io/private/messages.ts

@@ -6,4 +6,3 @@ export * from '../../@aws-cdk/toolkit-lib/lib/api/io/private';
 export * from '../../@aws-cdk/toolkit-lib/lib/api/tags/private';
 export * from '../../@aws-cdk/toolkit-lib/lib/private/activity-printer';
 export * from '../../@aws-cdk/toolkit-lib/lib/api/cloud-assembly/private/borrowed-assembly';
-

packages/@aws-cdk/toolkit-lib/lib/payloads/flags.ts

@@ -1913,7 +1913,6 @@ export interface GarbageCollectionOptions {
    */
   readonly confirm?: boolean;
 }
-
 export interface MigrateOptions {
   /**
    * The name assigned to the generated stack. This is also used to get

packages/@aws-cdk/toolkit-lib/package.json

@@ -115,6 +115,15 @@ export async function makeConfig(): Promise<CliConfig> {
       },
       'flags': {
         description: 'View and toggle feature flags.',
+        arg: {
+          name: 'FLAGNAME',
+          variadic: true,
+        },
+        options: {
+          value: { type: 'string', desc: 'The value the user would like to set the feature flag configuration to', requiresArg: true },
+          set: { type: 'boolean', desc: 'Signifies the user would like to modify their feature flag configuration', requiresArg: false },
+          all: { type: 'boolean', desc: 'Modify or view all feature flags', requiresArg: false },
+        },
       },
       'deploy': {
         description: 'Deploys the stack(s) named STACKS into your AWS account',