feat: modify multiple feature flag values to their recommended states (#750)

Allows users to change multiple feature flags to their recommended
states and displays differences in CloudFormation templates.

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

Author: vivian12300

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

@@ -1296,6 +1296,7 @@ export class Toolkit extends CloudAssemblySourceBuilder {
           recommendedValue: flagInfo.recommendedValue,
           userValue: flagInfo.userValue ?? undefined,
           explanation: flagInfo.explanation ?? '',
+          unconfiguredBehavesLike: flagInfo.unconfiguredBehavesLike,
         }));
       });
   }

packages/@aws-cdk/toolkit-lib/lib/toolkit/types.ts

@@ -123,4 +123,5 @@ export interface FeatureFlag {
   readonly recommendedValue: unknown;
   readonly userValue?: unknown;
   readonly explanation?: string;
+  readonly unconfiguredBehavesLike?: { [key: string]: any };
 }

packages/aws-cdk/lib/cli/cli-config.ts

@@ -123,6 +123,9 @@ export async function makeConfig(): Promise<CliConfig> {
           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 },
+          unconfigured: { type: 'boolean', desc: 'Modify unconfigured feature flags', requiresArg: false },
+          recommended: { type: 'boolean', desc: 'Change flags to recommended states', requiresArg: false },
+          default: { type: 'boolean', desc: 'Change flags to default state', requiresArg: false },
         },
       },
       'deploy': {

packages/aws-cdk/lib/cli/cli-type-registry.json

@@ -350,6 +350,21 @@
           "type": "boolean",
           "desc": "Modify or view all feature flags",
           "requiresArg": false
+        },
+        "unconfigured": {
+          "type": "boolean",
+          "desc": "Modify unconfigured feature flags",
+          "requiresArg": false
+        },
+        "recommended": {
+          "type": "boolean",
+          "desc": "Change flags to recommended states",
+          "requiresArg": false
+        },
+        "default": {
+          "type": "boolean",
+          "desc": "Change flags to default state",
+          "requiresArg": false
         }
       }
     },

packages/aws-cdk/lib/cli/convert-to-user-input.ts

@@ -99,6 +99,9 @@ export function convertYargsToUserInput(args: any): UserInput {
         value: args.value,
         set: args.set,
         all: args.all,
+        unconfigured: args.unconfigured,
+        recommended: args.recommended,
+        default: args.default,
         FLAGNAME: args.FLAGNAME,
       };
       break;
@@ -375,6 +378,9 @@ export function convertConfigToUserInput(config: any): UserInput {
     value: config.flags?.value,
     set: config.flags?.set,
     all: config.flags?.all,
+    unconfigured: config.flags?.unconfigured,
+    recommended: config.flags?.recommended,
+    default: config.flags?.default,
   };
   const deployOptions = {
     all: config.deploy?.all,

packages/aws-cdk/lib/cli/parse-command-line-arguments.ts

@@ -371,6 +371,24 @@ export function parseCommandLineArguments(args: Array<string>): any {
           type: 'boolean',
           desc: 'Modify or view all feature flags',
           requiresArg: false,
+        })
+        .option('unconfigured', {
+          default: undefined,
+          type: 'boolean',
+          desc: 'Modify unconfigured feature flags',
+          requiresArg: false,
+        })
+        .option('recommended', {
+          default: undefined,
+          type: 'boolean',
+          desc: 'Change flags to recommended states',
+          requiresArg: false,
+        })
+        .option('default', {
+          default: undefined,
+          type: 'boolean',
+          desc: 'Change flags to default state',
+          requiresArg: false,
         }),
     )
     .command('deploy [STACKS..]', 'Deploys the stack(s) named STACKS into your AWS account', (yargs: Argv) =>

packages/aws-cdk/lib/cli/user-input.ts

@@ -636,6 +636,27 @@ export interface FlagsOptions {
    */
   readonly all?: boolean;
 
+  /**
+   * Modify unconfigured feature flags
+   *
+   * @default - undefined
+   */
+  readonly unconfigured?: boolean;
+
+  /**
+   * Change flags to recommended states
+   *
+   * @default - undefined
+   */
+  readonly recommended?: boolean;
+
+  /**
+   * Change flags to default state
+   *
+   * @default - undefined
+   */
+  readonly default?: boolean;
+
   /**
    * Positional argument for flags
    */