@go-to-k/cdkd 0.4.0 → 0.5.0

package/README.md

@@ -342,6 +342,9 @@ alias cdkd="node $(pwd)/dist/cli.js"
 # Bootstrap (creates S3 state bucket - only needed once per account/region)
 cdkd bootstrap
 
+# List stacks in the CDK app
+cdkd list
+
 # Deploy your CDK app
 cdkd deploy
 
@@ -367,6 +370,14 @@ cdkd bootstrap \
 # Synthesize only
 cdkd synth --app "npx ts-node app.ts"
 
+# List all stacks in the CDK app (alias: ls)
+cdkd list
+cdkd ls
+cdkd list --long              # YAML records with id/name/environment
+cdkd list --long --json       # same, but JSON
+cdkd list --show-dependencies # id + dependency list per stack
+cdkd list 'MyStage/*'         # filter by display path (CDK CLI parity)
+
 # Deploy from a pre-synthesized cloud assembly directory
 cdkd deploy --app cdk.out
 

package/dist/cli.js

@@ -447,7 +447,7 @@ var init_aws_clients = __esm({
 });
 
 // src/cli/index.ts
-import { Command as Command8 } from "commander";
+import { Command as Command9 } from "commander";
 
 // src/cli/commands/bootstrap.ts
 import { Command } from "commander";
@@ -2357,6 +2357,62 @@ function setsEqual(a, b) {
   return true;
 }
 
+// src/utils/yaml.ts
+function toYaml(obj, indent = 0) {
+  const prefix = "  ".repeat(indent);
+  if (obj === null || obj === void 0)
+    return "null\n";
+  if (typeof obj === "boolean")
+    return `${obj}
+`;
+  if (typeof obj === "number")
+    return `"${obj}"
+`;
+  if (typeof obj === "string") {
+    if (obj.includes("\n")) {
+      return `'${obj.replace(/'/g, "''")}'
+`;
+    }
+    if (obj.startsWith("{") || obj.startsWith("[") || obj.startsWith('"')) {
+      return `'${obj.replace(/'/g, "''")}'
+`;
+    }
+    if (obj.includes("#") || obj === "" || obj === "true" || obj === "false" || obj === "null") {
+      return `"${obj}"
+`;
+    }
+    return `${obj}
+`;
+  }
+  if (Array.isArray(obj)) {
+    if (obj.length === 0)
+      return "[]\n";
+    let result = "\n";
+    for (const item of obj) {
+      const value = toYaml(item, indent + 1).trimStart();
+      result += `${prefix}- ${value}`;
+    }
+    return result;
+  }
+  if (typeof obj === "object") {
+    const entries = Object.entries(obj);
+    if (entries.length === 0)
+      return "{}\n";
+    let result = "\n";
+    for (const [key, value] of entries) {
+      const safeKey = key.includes(" ") ? `"${key}"` : key;
+      if (typeof value === "object" && value !== null) {
+        result += `${prefix}${safeKey}:${toYaml(value, indent + 1)}`;
+      } else {
+        result += `${prefix}${safeKey}: ${toYaml(value, indent + 1).trimStart()}`;
+      }
+    }
+    return result;
+  }
+  return `${String(obj)}
+`;
+}
+
 // src/cli/commands/synth.ts
 async function synthCommand(options) {
   const logger = getLogger();
@@ -2407,68 +2463,158 @@ async function synthCommand(options) {
   logger.info(`
 Output: ${assemblyDir}`);
 }
-function toYaml(obj, indent = 0) {
-  const prefix = "  ".repeat(indent);
-  if (obj === null || obj === void 0)
-    return "null\n";
-  if (typeof obj === "boolean")
-    return `${obj}
-`;
-  if (typeof obj === "number")
-    return `"${obj}"
-`;
-  if (typeof obj === "string") {
-    if (obj.includes("\n")) {
-      return `'${obj.replace(/'/g, "''")}'
-`;
-    }
-    if (obj.startsWith("{") || obj.startsWith("[") || obj.startsWith('"')) {
-      return `'${obj.replace(/'/g, "''")}'
-`;
-    }
-    if (obj.includes("#") || obj === "" || obj === "true" || obj === "false" || obj === "null") {
-      return `"${obj}"
-`;
+function createSynthCommand() {
+  const cmd = new Command2("synth").description("Synthesize CDK app to CloudFormation template").action(withErrorHandling(synthCommand));
+  [...commonOptions, ...appOptions, ...contextOptions].forEach((opt) => cmd.addOption(opt));
+  return cmd;
+}
+
+// src/cli/commands/list.ts
+import { Command as Command3 } from "commander";
+
+// src/cli/stack-matcher.ts
+function matchStacks(stacks, patterns) {
+  if (patterns.length === 0)
+    return [];
+  const seen = /* @__PURE__ */ new Set();
+  const result = [];
+  for (const stack of stacks) {
+    const matched = patterns.some((pattern) => stackMatchesPattern(stack, pattern));
+    if (matched && !seen.has(stack.stackName)) {
+      seen.add(stack.stackName);
+      result.push(stack);
     }
-    return `${obj}
-`;
   }
-  if (Array.isArray(obj)) {
-    if (obj.length === 0)
-      return "[]\n";
-    let result = "\n";
-    for (const item of obj) {
-      const value = toYaml(item, indent + 1).trimStart();
-      result += `${prefix}- ${value}`;
+  return result;
+}
+function describeStack(stack) {
+  if (stack.displayName && stack.displayName !== stack.stackName) {
+    return `${stack.stackName} (${stack.displayName})`;
+  }
+  return stack.stackName;
+}
+function stackMatchesPattern(stack, pattern) {
+  const target = pattern.includes("/") ? stack.displayName ?? stack.stackName : stack.stackName;
+  if (pattern.includes("*")) {
+    const regex = new RegExp("^" + pattern.replace(/\*/g, ".*") + "$");
+    return regex.test(target);
+  }
+  return target === pattern;
+}
+
+// src/cli/commands/list.ts
+function sortByDependency(stacks) {
+  const byName = new Map(stacks.map((s) => [s.stackName, s]));
+  const visited = /* @__PURE__ */ new Set();
+  const result = [];
+  const visit = (stack, ancestors) => {
+    if (visited.has(stack.stackName))
+      return;
+    if (ancestors.has(stack.stackName))
+      return;
+    ancestors.add(stack.stackName);
+    for (const depName of stack.dependencyNames) {
+      const dep = byName.get(depName);
+      if (dep)
+        visit(dep, ancestors);
+    }
+    ancestors.delete(stack.stackName);
+    if (!visited.has(stack.stackName)) {
+      visited.add(stack.stackName);
+      result.push(stack);
     }
-    return result;
+  };
+  for (const stack of stacks) {
+    visit(stack, /* @__PURE__ */ new Set());
   }
-  if (typeof obj === "object") {
-    const entries = Object.entries(obj);
-    if (entries.length === 0)
-      return "{}\n";
-    let result = "\n";
-    for (const [key, value] of entries) {
-      const safeKey = key.includes(" ") ? `"${key}"` : key;
-      if (typeof value === "object" && value !== null) {
-        result += `${prefix}${safeKey}:${toYaml(value, indent + 1)}`;
-      } else {
-        result += `${prefix}${safeKey}: ${toYaml(value, indent + 1).trimStart()}`;
-      }
+  return result;
+}
+function toLongRecord(stack, includeDeps) {
+  const record = {
+    id: stack.displayName,
+    name: stack.stackName,
+    environment: {
+      account: stack.account ?? "unknown-account",
+      region: stack.region ?? "unknown-region"
     }
-    return result;
+  };
+  if (includeDeps) {
+    record.dependencies = [...stack.dependencyNames];
   }
-  return `${String(obj)}
-`;
+  return record;
 }
-function createSynthCommand() {
-  const cmd = new Command2("synth").description("Synthesize CDK app to CloudFormation template").action(withErrorHandling(synthCommand));
+async function listCommand(patterns, options) {
+  const logger = getLogger();
+  if (options.verbose) {
+    logger.setLevel("debug");
+  }
+  const app = resolveApp(options.app);
+  if (!app) {
+    throw new Error(
+      'No app command specified. Use --app, set CDKD_APP env var, or add "app" to cdk.json'
+    );
+  }
+  logger.debug("Listing stacks...");
+  logger.debug("App command:", app);
+  const synthesizer = new Synthesizer();
+  const context = parseContextOptions(options.context);
+  const synthOptions = {
+    app,
+    output: options.output,
+    ...options.region && { region: options.region },
+    ...options.profile && { profile: options.profile },
+    ...Object.keys(context).length > 0 && { context }
+  };
+  const result = await synthesizer.synthesize(synthOptions);
+  const allStacks = result.stacks;
+  if (allStacks.length === 0) {
+    throw new Error("No stacks found in assembly");
+  }
+  const selected = patterns.length > 0 ? matchStacks(allStacks, patterns) : allStacks;
+  if (selected.length === 0) {
+    throw new Error(
+      `No stacks matching ${patterns.join(", ")} found in assembly. Available: ${allStacks.map(describeStack).join(", ")}`
+    );
+  }
+  const sorted = sortByDependency(selected);
+  if (options.long) {
+    const records = sorted.map((s) => toLongRecord(s, options.showDependencies));
+    emitStructured(records, options.json);
+    return;
+  }
+  if (options.showDependencies) {
+    const records = sorted.map((s) => ({
+      id: s.displayName,
+      dependencies: [...s.dependencyNames]
+    }));
+    emitStructured(records, options.json);
+    return;
+  }
+  for (const stack of sorted) {
+    process.stdout.write(`${stack.displayName}
+`);
+  }
+}
+function emitStructured(payload, asJson) {
+  if (asJson) {
+    process.stdout.write(`${JSON.stringify(payload, null, 2)}
+`);
+    return;
+  }
+  const yaml = toYaml(payload).replace(/^\n/, "");
+  process.stdout.write(yaml);
+}
+function createListCommand() {
+  const cmd = new Command3("list").alias("ls").description("List all stacks in the CDK app").argument(
+    "[stacks...]",
+    "Stack name pattern(s). Accepts physical CloudFormation names (e.g. 'MyStage-Api') or CDK display paths (e.g. 'MyStage/Api'). Supports wildcards (e.g. 'MyStage/*')."
+  ).option("-l, --long", "Display environment information for each stack", false).option("-d, --show-dependencies", "Display stack dependency information for each stack", false).option("--json", "Output as JSON instead of YAML for --long / --show-dependencies", false).action(withErrorHandling(listCommand));
   [...commonOptions, ...appOptions, ...contextOptions].forEach((opt) => cmd.addOption(opt));
   return cmd;
 }
 
 // src/cli/commands/deploy.ts
-import { Command as Command3 } from "commander";
+import { Command as Command4 } from "commander";
 
 // src/assets/asset-publisher.ts
 import { readFileSync as readFileSync4 } from "node:fs";
@@ -25979,6 +26125,57 @@ var IMPLICIT_DELETE_DEPENDENCIES = {
   ]
 };
 
+// src/deployment/retryable-errors.ts
+var RETRYABLE_ERROR_MESSAGE_PATTERNS = [
+  // IAM propagation
+  "cannot be assumed",
+  "role defined for the function",
+  "not authorized to perform",
+  "execution role",
+  "trust policy",
+  "Role validation failed",
+  "does not have required permissions",
+  "Trusted Entity",
+  "currently in the following state: Pending",
+  // DELETE dependency ordering (parallel deletion race conditions)
+  "has dependencies and cannot be deleted",
+  "can't be deleted since it has",
+  "DependencyViolation",
+  // AWS eventual consistency (dependency just created but not yet visible)
+  // e.g., RDS DBCluster referencing a just-created DBSubnetGroup
+  "does not exist",
+  // AppSync schema is being created asynchronously
+  "Schema is currently being altered",
+  // IAM principal not yet propagated to S3 bucket policy
+  "Invalid principal in policy",
+  // S3 bucket creation/deletion still in progress
+  "conflicting conditional operation",
+  // Secrets Manager: ForceDeleteWithoutRecovery may take a moment to propagate
+  "scheduled for deletion",
+  // DynamoDB Streams / Kinesis: IAM role not yet propagated
+  "Cannot access stream",
+  "Please ensure the role can perform",
+  // KMS: IAM role not yet propagated for CreateGrant
+  "KMS key is invalid for CreateGrant",
+  // CloudWatch Logs SubscriptionFilter: Kinesis stream eventual consistency
+  // or SubscriptionFilter role propagation. CW Logs probes the destination
+  // by delivering a test message; if the stream is freshly ACTIVE or the
+  // assumed role hasn't propagated, the probe fails with "Invalid request".
+  "Could not deliver test message"
+];
+var RETRYABLE_HTTP_STATUS_CODES = /* @__PURE__ */ new Set([429, 503]);
+function isRetryableTransientError(error, message) {
+  const metadata = error.$metadata;
+  const statusCode = metadata?.httpStatusCode;
+  if (statusCode !== void 0 && RETRYABLE_HTTP_STATUS_CODES.has(statusCode))
+    return true;
+  const cause = error.cause;
+  const causeStatus = cause?.$metadata?.httpStatusCode;
+  if (causeStatus !== void 0 && RETRYABLE_HTTP_STATUS_CODES.has(causeStatus))
+    return true;
+  return RETRYABLE_ERROR_MESSAGE_PATTERNS.some((p) => message.includes(p));
+}
+
 // src/deployment/deploy-engine.ts
 var InterruptedError = class extends Error {
   constructor() {
@@ -26975,7 +27172,7 @@ var DeployEngine = class {
       } catch (error) {
         lastError = error;
         const message = error instanceof Error ? error.message : String(error);
-        const isRetryable = this.isRetryableError(error, message);
+        const isRetryable = isRetryableTransientError(error, message);
         if (!isRetryable || attempt >= maxRetries) {
           throw error;
         }
@@ -26992,53 +27189,6 @@ var DeployEngine = class {
     }
     throw lastError;
   }
-  /**
-   * Determine if an error is retryable (transient).
-   * Checks HTTP status codes (429 throttle, 503 unavailable)
-   * and IAM propagation delay message patterns.
-   */
-  isRetryableError(error, message) {
-    const metadata = error.$metadata;
-    const statusCode = metadata?.httpStatusCode;
-    if (statusCode === 429 || statusCode === 503)
-      return true;
-    const cause = error.cause;
-    const causeStatus = cause?.$metadata?.httpStatusCode;
-    if (causeStatus === 429 || causeStatus === 503)
-      return true;
-    const retryablePatterns = [
-      "cannot be assumed",
-      "role defined for the function",
-      "not authorized to perform",
-      "execution role",
-      "trust policy",
-      "Role validation failed",
-      "does not have required permissions",
-      "Trusted Entity",
-      "currently in the following state: Pending",
-      // DELETE dependency ordering (parallel deletion race conditions)
-      "has dependencies and cannot be deleted",
-      "can't be deleted since it has",
-      "DependencyViolation",
-      // AWS eventual consistency (dependency just created but not yet visible)
-      // e.g., RDS DBCluster referencing a just-created DBSubnetGroup
-      "does not exist",
-      // AppSync schema is being created asynchronously
-      "Schema is currently being altered",
-      // IAM principal not yet propagated to S3 bucket policy
-      "Invalid principal in policy",
-      // S3 bucket creation/deletion still in progress
-      "conflicting conditional operation",
-      // Secrets Manager: ForceDeleteWithoutRecovery may take a moment to propagate
-      "scheduled for deletion",
-      // DynamoDB Streams / Kinesis: IAM role not yet propagated
-      "Cannot access stream",
-      "Please ensure the role can perform",
-      // KMS: IAM role not yet propagated for CreateGrant
-      "KMS key is invalid for CreateGrant"
-    ];
-    return retryablePatterns.some((p) => message.includes(p));
-  }
   /**
    * Resolve stack outputs from template and resource attributes
    *
@@ -27078,38 +27228,6 @@ var DeployEngine = class {
 
 // src/cli/commands/deploy.ts
 init_aws_clients();
-
-// src/cli/stack-matcher.ts
-function matchStacks(stacks, patterns) {
-  if (patterns.length === 0)
-    return [];
-  const seen = /* @__PURE__ */ new Set();
-  const result = [];
-  for (const stack of stacks) {
-    const matched = patterns.some((pattern) => stackMatchesPattern(stack, pattern));
-    if (matched && !seen.has(stack.stackName)) {
-      seen.add(stack.stackName);
-      result.push(stack);
-    }
-  }
-  return result;
-}
-function describeStack(stack) {
-  if (stack.displayName && stack.displayName !== stack.stackName) {
-    return `${stack.stackName} (${stack.displayName})`;
-  }
-  return stack.stackName;
-}
-function stackMatchesPattern(stack, pattern) {
-  const target = pattern.includes("/") ? stack.displayName ?? stack.stackName : stack.stackName;
-  if (pattern.includes("*")) {
-    const regex = new RegExp("^" + pattern.replace(/\*/g, ".*") + "$");
-    return regex.test(target);
-  }
-  return target === pattern;
-}
-
-// src/cli/commands/deploy.ts
 async function deployCommand(stacks, options) {
   const logger = getLogger();
   if (options.verbose) {
@@ -27343,7 +27461,7 @@ Deploying stack: ${stackInfo.stackName}${stackRegion !== baseRegion ? ` (region:
   }
 }
 function createDeployCommand() {
-  const cmd = new Command3("deploy").description("Deploy CDK app using SDK/Cloud Control API").argument(
+  const cmd = new Command4("deploy").description("Deploy CDK app using SDK/Cloud Control API").argument(
     "[stacks...]",
     "Stack name(s) to deploy. Accepts physical CloudFormation names (e.g. 'MyStage-Api') or CDK display paths (e.g. 'MyStage/Api'). Supports wildcards (e.g. 'MyStage/*')."
   ).option("--all", "Deploy all stacks", false).action(withErrorHandling(deployCommand));
@@ -27359,7 +27477,7 @@ function createDeployCommand() {
 }
 
 // src/cli/commands/diff.ts
-import { Command as Command4 } from "commander";
+import { Command as Command5 } from "commander";
 init_aws_clients();
 var INTRINSIC_KEYS = /* @__PURE__ */ new Set([
   "Ref",
@@ -27557,7 +27675,7 @@ ${createCount} to create, ${updateCount} to update, ${deleteCount} to delete`);
   }
 }
 function createDiffCommand() {
-  const cmd = new Command4("diff").description("Show difference between current state and desired state").argument(
+  const cmd = new Command5("diff").description("Show difference between current state and desired state").argument(
     "[stacks...]",
     "Stack name(s) to diff. Accepts physical CloudFormation names (e.g. 'MyStage-Api') or CDK display paths (e.g. 'MyStage/Api'). Supports wildcards (e.g. 'MyStage/*')."
   ).option("--all", "Diff all stacks", false).action(withErrorHandling(diffCommand));
@@ -27568,7 +27686,7 @@ function createDiffCommand() {
 }
 
 // src/cli/commands/destroy.ts
-import { Command as Command5 } from "commander";
+import { Command as Command6 } from "commander";
 init_aws_clients();
 import * as readline from "node:readline/promises";
 async function destroyCommand(stackArgs, options) {
@@ -27850,7 +27968,7 @@ Acquiring lock for stack ${stackName}...`);
   }
 }
 function createDestroyCommand() {
-  const cmd = new Command5("destroy").description("Destroy all resources in the stack").argument(
+  const cmd = new Command6("destroy").description("Destroy all resources in the stack").argument(
     "[stacks...]",
     "Stack name(s) to destroy. Accepts physical CloudFormation names (e.g. 'MyStage-Api') or CDK display paths (e.g. 'MyStage/Api'). Supports wildcards (e.g. 'MyStage/*')."
   ).option("--all", "Destroy all stacks", false).action(withErrorHandling(destroyCommand));
@@ -27866,7 +27984,7 @@ function createDestroyCommand() {
 }
 
 // src/cli/commands/publish-assets.ts
-import { Option as Option2, Command as Command6 } from "commander";
+import { Option as Option2, Command as Command7 } from "commander";
 async function publishAssetsCommand(options) {
   const logger = getLogger();
   if (options.verbose) {
@@ -27884,7 +28002,7 @@ async function publishAssetsCommand(options) {
   logger.info("\u2705 Asset publishing complete");
 }
 function createPublishAssetsCommand() {
-  const cmd = new Command6("publish-assets").description("Publish assets to S3/ECR from asset manifest").requiredOption("--path <path>", "Path to asset manifest file or directory").addOption(
+  const cmd = new Command7("publish-assets").description("Publish assets to S3/ECR from asset manifest").requiredOption("--path <path>", "Path to asset manifest file or directory").addOption(
     new Option2(
       "--asset-publish-concurrency <number>",
       "Maximum concurrent asset publish operations"
@@ -27897,7 +28015,7 @@ function createPublishAssetsCommand() {
 }
 
 // src/cli/commands/force-unlock.ts
-import { Command as Command7 } from "commander";
+import { Command as Command8 } from "commander";
 init_aws_clients();
 async function forceUnlockCommand(stackArgs, options) {
   const logger = getLogger();
@@ -27940,7 +28058,7 @@ async function forceUnlockCommand(stackArgs, options) {
   }
 }
 function createForceUnlockCommand() {
-  const cmd = new Command7("force-unlock").description("Force-release a stale lock on a stack").argument("[stacks...]", "Stack name(s) to unlock").action(withErrorHandling(forceUnlockCommand));
+  const cmd = new Command8("force-unlock").description("Force-release a stale lock on a stack").argument("[stacks...]", "Stack name(s) to unlock").action(withErrorHandling(forceUnlockCommand));
   [...commonOptions, ...stateOptions, ...stackOptions].forEach((opt) => cmd.addOption(opt));
   return cmd;
 }
@@ -27949,6 +28067,8 @@ function createForceUnlockCommand() {
 var SUBCOMMANDS = /* @__PURE__ */ new Set([
   "bootstrap",
   "synth",
+  "list",
+  "ls",
   "deploy",
   "diff",
   "destroy",
@@ -27966,10 +28086,11 @@ function reorderArgs(argv) {
   return [...prefix, ...cmdAndAfter, ...beforeCmd];
 }
 async function main() {
-  const program = new Command8();
-  program.name("cdkd").description("CDK Direct - Deploy AWS CDK apps directly via SDK/Cloud Control API").version("0.4.0");
+  const program = new Command9();
+  program.name("cdkd").description("CDK Direct - Deploy AWS CDK apps directly via SDK/Cloud Control API").version("0.5.0");
   program.addCommand(createBootstrapCommand());
   program.addCommand(createSynthCommand());
+  program.addCommand(createListCommand());
   program.addCommand(createDeployCommand());
   program.addCommand(createDiffCommand());
   program.addCommand(createDestroyCommand());