@go-to-k/cdkd 0.91.5 → 0.93.0

package/README.md

@@ -1,6 +1,6 @@
-# cdkd
+# cdkd (CDK Direct)
 
-**cdkd** (CDK Direct) — a from-scratch CDK CLI that provisions via AWS SDK instead of CloudFormation.
+Drop-in CDK CLI for existing CDK apps — faster deploys via AWS SDK instead of CloudFormation, with local emulation for Lambda, API Gateway, and ECS.
 
 - **Drop-in CDK compatible** — your existing CDK app code runs as-is.
 - **Up to 15x faster deploys than the AWS CDK CLI (CloudFormation)**
@@ -453,6 +453,47 @@ Two `orphan` variants at different granularities:
 Both `cdkd destroy` (synth-driven) and `cdkd state destroy`
 (state-driven, no synth) delete AWS resources + state.
 
+## Stack-name prefix on physical names
+
+cdkd prepends the **stack name** to physical names you declare in CDK
+code: `new iam.Role(this, 'CRRole', { roleName: 'my-role' })` in stack
+`MyStack` is created in AWS as `MyStack-my-role`. The prefix protects
+cross-stack uniqueness (two stacks declaring `roleName: 'my-role'`
+otherwise collide on a single AWS account). Pre-PR this behavior was
+**inconsistent**: only IAM Role / User / Group / InstanceProfile and
+ELBv2 LoadBalancer / TargetGroup actually got the prefix; Lambda, S3,
+SNS, SQS, DynamoDB, etc. used the user's declared name as-is.
+
+`cdkd deploy --no-prefix-user-supplied-names` opts in to skipping
+the prefix on user-declared physical names, making cdkd consistent
+across all resource types. Off by default for backward compatibility.
+
+| | Default (no flag) | `--no-prefix-user-supplied-names` |
+| --- | --- | --- |
+| `new iam.Role({ roleName: 'my-role' })` | `MyStack-my-role` | `my-role` |
+| `new s3.Bucket({ bucketName: 'my-bucket' })` | `my-bucket` (already no prefix — Pattern A) | `my-bucket` (unchanged) |
+| `new iam.Role(...)` (no `roleName`) | `MyStack-CRRole-<hash>` (auto-generated, prefix kept for uniqueness) | `MyStack-CRRole-<hash>` (unchanged) |
+
+Resolution chain (highest wins): `--no-prefix-user-supplied-names`
+CLI flag → `CDKD_NO_PREFIX_USER_SUPPLIED_NAMES=true` env var →
+`cdk.json` `context.cdkd.noPrefixUserSuppliedNames: true` → default
+`false`.
+
+Affects `cdkd deploy` only. Already-deployed stacks deployed under
+the legacy prefixed-name scheme keep working — the flag only controls
+what AWS resource cdkd creates on **future** deploys. Switching the
+flag mid-flight on an existing stack would propose REPLACEMENT on
+every Pattern B resource (the existing AWS resource has the prefixed
+name; the new template intent has the un-prefixed name).
+
+Surfaced by [PR #285 `cdkd export`](https://github.com/go-to-k/cdkd/pull/285)
+where the CFn IMPORT changeset's identifier check would fail on a
+synth `RoleName: 'my-role'` vs the AWS-deployed `MyStack-my-role`;
+the export command currently overlays `ResourceIdentifier` onto
+`Properties` to bridge the gap. A future major-version PR will flip
+the default of `--no-prefix-user-supplied-names` to `true`, after
+which the overlay can be dropped.
+
 ## `--remove-protection`: one-shot bypass for protected resources
 
 CDK's `new Stack(app, 'X', { terminationProtection: true })` is honored

package/dist/cli.js

@@ -17823,10 +17823,31 @@ function withStackName(stackName, fn) {
 function getCurrentStackName() {
   return stackNameStore.getStore();
 }
+var skipPrefixStore = new AsyncLocalStorage();
+function withSkipPrefix(skip, fn) {
+  return skipPrefixStore.run(skip, fn);
+}
+function getCurrentSkipPrefix() {
+  return skipPrefixStore.getStore() ?? false;
+}
+var PATTERN_B_RESOURCE_TYPES = [
+  "AWS::IAM::Role",
+  "AWS::IAM::User",
+  "AWS::IAM::Group",
+  "AWS::IAM::InstanceProfile",
+  "AWS::ElasticLoadBalancingV2::LoadBalancer",
+  "AWS::ElasticLoadBalancingV2::TargetGroup"
+];
 function generateResourceName(name, options) {
-  const { maxLength, lowercase = false, allowedPattern = /[^a-zA-Z0-9-]/g } = options;
+  const {
+    maxLength,
+    lowercase = false,
+    allowedPattern = /[^a-zA-Z0-9-]/g,
+    userSupplied = false
+  } = options;
   const currentStackName = stackNameStore.getStore();
-  const fullName = currentStackName ? `${currentStackName}-${name}` : name;
+  const shouldPrefix = currentStackName && !(userSupplied && getCurrentSkipPrefix());
+  const fullName = shouldPrefix ? `${currentStackName}-${name}` : name;
   let sanitized = lowercase ? fullName.toLowerCase() : fullName;
   sanitized = sanitized.replace(allowedPattern, "-");
   sanitized = sanitized.replace(/-{2,}/g, "-").replace(/^-+|-+$/g, "");
@@ -17838,6 +17859,12 @@ function generateResourceName(name, options) {
   const prefix = sanitized.substring(0, maxPrefixLength).replace(/-+$/, "");
   return `${prefix}-${hash}`;
 }
+function generateResourceNameWithFallback(userSuppliedName, logicalId, options) {
+  if (userSuppliedName !== void 0 && userSuppliedName !== "") {
+    return generateResourceName(userSuppliedName, { ...options, userSupplied: true });
+  }
+  return generateResourceName(logicalId, { ...options, userSupplied: false });
+}
 var FALLBACK_NAME_RULES = {
   "AWS::S3::Bucket": { nameProperty: "BucketName", options: { maxLength: 63, lowercase: true } },
   "AWS::SQS::Queue": { nameProperty: "QueueName", options: { maxLength: 80 } },
@@ -23368,6 +23395,10 @@ var deployOptions = [
     "--no-capture-observed-state",
     "Skip capturing AWS-current properties after each create/update (adds a fire-and-forget readCurrentState per resource so cdkd drift can compare against the real deploy-time AWS snapshot instead of the template). On by default. Disable when deploy speed matters more than rich drift detection \u2014 falls back to comparing against template properties (the pre-v3 behavior)."
   ),
+  new Option(
+    "--no-prefix-user-supplied-names",
+    'Do NOT prepend the stack name to physical names the user explicitly supplied in their CDK code (e.g. `new iam.Role(this, "X", { roleName: "my-role" })` \u2192 AWS resource named `my-role` instead of `MyStack-my-role`). Auto-generated-name resources (where the user did not declare a physical name) keep the prefix unchanged. Off by default for backward compatibility; enable via this flag, CDKD_NO_PREFIX_USER_SUPPLIED_NAMES=true, or cdk.json context.cdkd.noPrefixUserSuppliedNames=true. Applies to `cdkd deploy` only.'
+  ),
   noWaitOption,
   aggressiveVpcParallelOption,
   new Option(
@@ -23512,6 +23543,19 @@ function resolveCaptureObservedState(cliValue) {
     return v;
   return true;
 }
+function resolveSkipPrefix(cliValue) {
+  if (cliValue === false)
+    return true;
+  const envValue = process.env["CDKD_NO_PREFIX_USER_SUPPLIED_NAMES"];
+  if (envValue === "true")
+    return true;
+  const cdkJson = loadCdkJson();
+  const cdkdContext = cdkJson?.context?.["cdkd"];
+  const v = cdkdContext?.["noPrefixUserSuppliedNames"];
+  if (typeof v === "boolean" && v === true)
+    return true;
+  return false;
+}
 function resolveStateBucketWithSource(cliBucket) {
   if (cliBucket)
     return { bucket: cliBucket, source: "cli-flag" };
@@ -27789,8 +27833,9 @@ var IAMRoleProvider = class {
    */
   async create(logicalId, resourceType, properties) {
     this.logger.debug(`Creating IAM role ${logicalId}`);
-    const roleName = generateResourceName(
-      properties["RoleName"] || logicalId,
+    const roleName = generateResourceNameWithFallback(
+      properties["RoleName"],
+      logicalId,
       { maxLength: 64 }
     );
     const assumeRolePolicyDocument = properties["AssumeRolePolicyDocument"];
@@ -27882,8 +27927,9 @@ var IAMRoleProvider = class {
    */
   async update(logicalId, physicalId, resourceType, properties, previousProperties) {
     this.logger.debug(`Updating IAM role ${logicalId}: ${physicalId}`);
-    const newRoleName = generateResourceName(
-      properties["RoleName"] || logicalId,
+    const newRoleName = generateResourceNameWithFallback(
+      properties["RoleName"],
+      logicalId,
       { maxLength: 64 }
     );
     const newPath = properties["Path"] || "/";
@@ -29004,8 +29050,9 @@ var IAMInstanceProfileProvider = class {
    */
   async create(logicalId, resourceType, properties) {
     this.logger.debug(`Creating IAM instance profile ${logicalId}`);
-    const instanceProfileName = generateResourceName(
-      properties["InstanceProfileName"] || logicalId,
+    const instanceProfileName = generateResourceNameWithFallback(
+      properties["InstanceProfileName"],
+      logicalId,
       { maxLength: 128 }
     );
     const path3 = properties["Path"] || "/";
@@ -29399,8 +29446,9 @@ var IAMUserGroupProvider = class {
   // ─── AWS::IAM::User ──────────────────────────────────────────────
   async createUser(logicalId, resourceType, properties) {
     this.logger.debug(`Creating IAM user ${logicalId}`);
-    const userName = generateResourceName(
-      properties["UserName"] || logicalId,
+    const userName = generateResourceNameWithFallback(
+      properties["UserName"],
+      logicalId,
       { maxLength: 64 }
     );
     try {
@@ -29883,8 +29931,9 @@ var IAMUserGroupProvider = class {
   // ─── AWS::IAM::Group ─────────────────────────────────────────────
   async createGroup(logicalId, resourceType, properties) {
     this.logger.debug(`Creating IAM group ${logicalId}`);
-    const groupName = generateResourceName(
-      properties["GroupName"] || logicalId,
+    const groupName = generateResourceNameWithFallback(
+      properties["GroupName"],
+      logicalId,
       { maxLength: 128 }
     );
     try {
@@ -48542,9 +48591,11 @@ var ELBv2Provider = class {
     this.logger.debug(`Creating LoadBalancer ${logicalId}`);
     try {
       const tags = this.extractTags(properties);
-      const lbName = generateResourceName(properties["Name"] || logicalId, {
-        maxLength: 32
-      });
+      const lbName = generateResourceNameWithFallback(
+        properties["Name"],
+        logicalId,
+        { maxLength: 32 }
+      );
       const response = await this.getClient().send(
         new CreateLoadBalancerCommand({
           Name: lbName,
@@ -48743,9 +48794,11 @@ var ELBv2Provider = class {
     try {
       const tags = this.extractTags(properties);
       const matcher = properties["Matcher"];
-      const tgName = generateResourceName(properties["Name"] || logicalId, {
-        maxLength: 32
-      });
+      const tgName = generateResourceNameWithFallback(
+        properties["Name"],
+        logicalId,
+        { maxLength: 32 }
+      );
       const response = await this.getClient().send(
         new CreateTargetGroupCommand({
           Name: tgName,
@@ -65426,6 +65479,72 @@ function registerAllProviders(registry) {
 
 // src/cli/commands/deploy.ts
 init_aws_clients();
+
+// src/cli/commands/prefix-migration-check.ts
+import * as readline from "node:readline/promises";
+function findPendingPrefixRenames(stackName, state) {
+  if (!state)
+    return [];
+  const patternB = new Set(PATTERN_B_RESOURCE_TYPES);
+  const prefix = `${stackName}-`;
+  const out = [];
+  for (const [logicalId, resource] of Object.entries(state.resources)) {
+    if (!patternB.has(resource.resourceType))
+      continue;
+    if (typeof resource.physicalId !== "string")
+      continue;
+    if (!resource.physicalId.startsWith(prefix))
+      continue;
+    const newPhysicalId = resource.physicalId.slice(prefix.length);
+    if (newPhysicalId.length === 0)
+      continue;
+    out.push({
+      logicalId,
+      resourceType: resource.resourceType,
+      oldPhysicalId: resource.physicalId,
+      newPhysicalId
+    });
+  }
+  return out;
+}
+async function promptMigrationConfirm(renames, opts) {
+  if (renames.length === 0)
+    return true;
+  const logger = getLogger();
+  logger.warn("");
+  logger.warn(
+    `WARNING: --no-prefix-user-supplied-names will REPLACE ${renames.length} resource(s) whose AWS physical name is still prefixed with the stack name:`
+  );
+  for (const r of renames) {
+    logger.warn(`  - ${r.logicalId} (${r.resourceType}): ${r.oldPhysicalId} -> ${r.newPhysicalId}`);
+  }
+  logger.warn(
+    "These resources will be REPLACED because the new naming convention drops the stack-name prefix."
+  );
+  if (opts.yes)
+    return true;
+  if (process.stdin.isTTY !== true) {
+    throw new Error(
+      "--no-prefix-user-supplied-names migration confirm prompt cannot run in a non-interactive environment. Pass --yes / -y to confirm the REPLACEMENT, or run the deploy from a real terminal."
+    );
+  }
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  try {
+    const answer = await rl.question("\nContinue? (y/N): ");
+    const trimmed = answer.trim().toLowerCase();
+    if (trimmed === "y" || trimmed === "yes")
+      return true;
+    logger.info("Deploy cancelled \u2014 no resources modified.");
+    return false;
+  } finally {
+    rl.close();
+  }
+}
+
+// src/cli/commands/deploy.ts
 async function deployCommand(stacks, options) {
   const logger = getLogger();
   if (options.verbose) {
@@ -65438,6 +65557,12 @@ async function deployCommand(stacks, options) {
   if (!options.wait) {
     process.env["CDKD_NO_WAIT"] = "true";
   }
+  const skipPrefix = resolveSkipPrefix(options.prefixUserSuppliedNames);
+  if (skipPrefix) {
+    logger.debug(
+      "Skipping stack-name prefix on user-supplied physical names (--no-prefix-user-supplied-names / CDKD_NO_PREFIX_USER_SUPPLIED_NAMES / cdk.json context.cdkd.noPrefixUserSuppliedNames)"
+    );
+  }
   const app = resolveApp(options.app);
   if (!app) {
     throw new Error(
@@ -65597,6 +65722,9 @@ async function deployCommand(stacks, options) {
     logger.debug(`Work graph: ${summary["asset-publish"]} asset(s), ${summary["stack"]} stack(s)`);
     const bufferStackOutput = targetStacks.length > 1;
     const runStack = async (stackInfo) => {
+      return withSkipPrefix(skipPrefix, () => runStackInner(stackInfo));
+    };
+    const runStackInner = async (stackInfo) => {
       const stackRegion = stackInfo.region || baseRegion;
       logger.info(
         `
@@ -65620,33 +65748,43 @@ Deploying stack: ${stackInfo.stackName}${stackRegion !== baseRegion ? ` (region:
       const stackProviderRegistry = new ProviderRegistry();
       registerAllProviders(stackProviderRegistry);
       stackProviderRegistry.setCustomResourceResponseBucket(stateBucket, baseRegion);
-      const stackDeployEngine = new DeployEngine(
-        stackStateBackend,
-        stackLockManager,
-        dagBuilder,
-        diffCalculator,
-        stackProviderRegistry,
-        {
-          concurrency: options.concurrency,
-          dryRun: options.dryRun,
-          noRollback: !options.rollback,
-          captureObservedState: resolveCaptureObservedState(options.captureObservedState),
-          ...options.resourceWarnAfter?.globalMs !== void 0 && {
-            resourceWarnAfterMs: options.resourceWarnAfter.globalMs
-          },
-          ...options.resourceTimeout?.globalMs !== void 0 && {
-            resourceTimeoutMs: options.resourceTimeout.globalMs
-          },
-          ...options.resourceWarnAfter?.perTypeMs && {
-            resourceWarnAfterByType: options.resourceWarnAfter.perTypeMs
-          },
-          ...options.resourceTimeout?.perTypeMs && {
-            resourceTimeoutByType: options.resourceTimeout.perTypeMs
-          }
-        },
-        stackRegion
-      );
       try {
+        if (skipPrefix) {
+          const existing = await stackStateBackend.getState(stackInfo.stackName, stackRegion);
+          const pending = findPendingPrefixRenames(stackInfo.stackName, existing?.state);
+          if (pending.length > 0) {
+            const proceed = await promptMigrationConfirm(pending, { yes: options.yes });
+            if (!proceed) {
+              return;
+            }
+          }
+        }
+        const stackDeployEngine = new DeployEngine(
+          stackStateBackend,
+          stackLockManager,
+          dagBuilder,
+          diffCalculator,
+          stackProviderRegistry,
+          {
+            concurrency: options.concurrency,
+            dryRun: options.dryRun,
+            noRollback: !options.rollback,
+            captureObservedState: resolveCaptureObservedState(options.captureObservedState),
+            ...options.resourceWarnAfter?.globalMs !== void 0 && {
+              resourceWarnAfterMs: options.resourceWarnAfter.globalMs
+            },
+            ...options.resourceTimeout?.globalMs !== void 0 && {
+              resourceTimeoutMs: options.resourceTimeout.globalMs
+            },
+            ...options.resourceWarnAfter?.perTypeMs && {
+              resourceWarnAfterByType: options.resourceWarnAfter.perTypeMs
+            },
+            ...options.resourceTimeout?.perTypeMs && {
+              resourceTimeoutByType: options.resourceTimeout.perTypeMs
+            }
+          },
+          stackRegion
+        );
         const deployResult = await stackDeployEngine.deploy(
           stackInfo.stackName,
           stackInfo.template
@@ -65931,7 +66069,7 @@ function createDiffCommand() {
 }
 
 // src/cli/commands/drift.ts
-import * as readline from "node:readline/promises";
+import * as readline2 from "node:readline/promises";
 import { Command as Command6, Option as Option3 } from "commander";
 init_aws_clients();
 
@@ -66640,7 +66778,7 @@ async function runWithConcurrency(tasks, concurrency) {
   await Promise.all(workers);
 }
 async function confirmPrompt(prompt) {
-  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  const rl = readline2.createInterface({ input: process.stdin, output: process.stdout });
   try {
     const ans = await rl.question(`${prompt} [y/N] `);
     return /^y(es)?$/i.test(ans.trim());
@@ -66753,7 +66891,7 @@ import { Command as Command7 } from "commander";
 init_aws_clients();
 
 // src/cli/commands/destroy-runner.ts
-import * as readline2 from "node:readline/promises";
+import * as readline3 from "node:readline/promises";
 init_aws_clients();
 var PROTECTION_PROPERTY_BY_TYPE = {
   "AWS::Logs::LogGroup": "DeletionProtectionEnabled",
@@ -66825,7 +66963,7 @@ Resources to be deleted (${resourceCount}):`);
   }
   const protectedCount = ctx.removeProtection ? countProtectedResources(state) : 0;
   if (!ctx.skipConfirmation) {
-    const rl = readline2.createInterface({
+    const rl = readline3.createInterface({
       input: process.stdin,
       output: process.stdout
     });
@@ -67259,7 +67397,7 @@ function createDestroyCommand() {
 }
 
 // src/cli/commands/orphan.ts
-import * as readline3 from "node:readline/promises";
+import * as readline4 from "node:readline/promises";
 import { Command as Command8 } from "commander";
 init_aws_clients();
 
@@ -67932,7 +68070,7 @@ function stringifyForAudit(value) {
   return JSON.stringify(value);
 }
 async function confirmPrompt2(prompt) {
-  const rl = readline3.createInterface({ input: process.stdin, output: process.stdout });
+  const rl = readline4.createInterface({ input: process.stdin, output: process.stdout });
   try {
     const ans = await rl.question(`${prompt} [y/N] `);
     return /^y(es)?$/i.test(ans.trim());
@@ -68207,7 +68345,7 @@ function createForceUnlockCommand() {
 }
 
 // src/cli/commands/state.ts
-import * as readline5 from "node:readline/promises";
+import * as readline6 from "node:readline/promises";
 import { Command as Command12, Option as Option6 } from "commander";
 import {
   GetBucketLocationCommand as GetBucketLocationCommand2,
@@ -68217,7 +68355,7 @@ import {
 init_aws_clients();
 
 // src/cli/commands/state-migrate.ts
-import * as readline4 from "node:readline/promises";
+import * as readline5 from "node:readline/promises";
 import { Command as Command11 } from "commander";
 import {
   CopyObjectCommand,
@@ -68493,7 +68631,7 @@ async function emptyBucketAllVersions(s3, bucket) {
   } while (keyMarker || versionIdMarker);
 }
 async function confirmPrompt3(prompt) {
-  const rl = readline4.createInterface({ input: process.stdin, output: process.stdout });
+  const rl = readline5.createInterface({ input: process.stdin, output: process.stdout });
   try {
     const ans = await rl.question(`${prompt} [y/N] `);
     return /^y(es)?$/i.test(ans.trim());
@@ -68901,7 +69039,7 @@ Use 'cdkd destroy ${stackName}' if you want to delete the actual resources.
 
 `
         );
-        const rl = readline5.createInterface({
+        const rl = readline6.createInterface({
           input: process.stdin,
           output: process.stdout
         });
@@ -68989,7 +69127,7 @@ WARNING: This destroys ${stackNames.length} stack(s) and removes their state rec
 `);
       }
       process.stdout.write("\n");
-      const rl = readline5.createInterface({
+      const rl = readline6.createInterface({
         input: process.stdin,
         output: process.stdout
       });
@@ -69415,7 +69553,7 @@ async function refreshObservedForStack(stackName, region, stateBackend, lockMana
   }
 }
 async function confirmRefresh(prompt) {
-  const rl = readline5.createInterface({ input: process.stdin, output: process.stdout });
+  const rl = readline6.createInterface({ input: process.stdin, output: process.stdout });
   try {
     const ans = await rl.question(`${prompt} [y/N] `);
     return /^y(es)?$/i.test(ans.trim());
@@ -69446,12 +69584,12 @@ function createStateCommand() {
 
 // src/cli/commands/import.ts
 import { readFileSync as readFileSync5, writeFileSync as writeFileSync4 } from "node:fs";
-import * as readline7 from "node:readline/promises";
+import * as readline8 from "node:readline/promises";
 import { Command as Command13 } from "commander";
 init_aws_clients();
 
 // src/cli/commands/retire-cfn-stack.ts
-import * as readline6 from "node:readline/promises";
+import * as readline7 from "node:readline/promises";
 import {
   DescribeStacksCommand,
   DescribeStackResourcesCommand,
@@ -69657,7 +69795,7 @@ async function getCloudFormationResourceMapping(cfnStackName, cfnClient) {
   return map;
 }
 async function confirmPrompt4(prompt) {
-  const rl = readline6.createInterface({ input: process.stdin, output: process.stdout });
+  const rl = readline7.createInterface({ input: process.stdin, output: process.stdout });
   try {
     const ans = await rl.question(`${prompt} [y/N] `);
     return /^y(es)?$/i.test(ans.trim());
@@ -70119,7 +70257,7 @@ function formatOutcome(outcome) {
   }
 }
 async function confirmPrompt5(prompt) {
-  const rl = readline7.createInterface({ input: process.stdin, output: process.stdout });
+  const rl = readline8.createInterface({ input: process.stdin, output: process.stdout });
   try {
     const ans = await rl.question(`${prompt} [y/N] `);
     return /^y(es)?$/i.test(ans.trim());
@@ -79782,7 +79920,7 @@ function createLocalCommand() {
 }
 
 // src/cli/commands/export.ts
-import * as readline8 from "node:readline/promises";
+import * as readline9 from "node:readline/promises";
 import { readFileSync as readFileSync9 } from "node:fs";
 import { Command as Command17 } from "commander";
 import {
@@ -80727,7 +80865,7 @@ function printNextSteps(args) {
   logger.info("");
 }
 async function confirmPrompt6(prompt) {
-  const rl = readline8.createInterface({ input: process.stdin, output: process.stdout });
+  const rl = readline9.createInterface({ input: process.stdin, output: process.stdout });
   try {
     const ans = await rl.question(`${prompt} [y/N] `);
     return /^y(es)?$/i.test(ans.trim());
@@ -80800,7 +80938,7 @@ function reorderArgs(argv) {
 }
 async function main() {
   const program = new Command18();
-  program.name("cdkd").description("CDK Direct - Deploy AWS CDK apps directly via SDK/Cloud Control API").version("0.91.5");
+  program.name("cdkd").description("CDK Direct - Deploy AWS CDK apps directly via SDK/Cloud Control API").version("0.93.0");
   program.addCommand(createBootstrapCommand());
   program.addCommand(createSynthCommand());
   program.addCommand(createListCommand());