@go-to-k/cdkd 0.4.1 → 0.5.1

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";
@@ -26015,7 +26161,12 @@ var RETRYABLE_ERROR_MESSAGE_PATTERNS = [
   // 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"
+  "Could not deliver test message",
+  // SQS: same-name queue can't be re-created until 60s after a delete.
+  // Hits when a stack is destroyed and re-deployed in quick succession
+  // (a common dev / iteration loop). Retry recovers within ~60s instead
+  // of failing the whole deploy.
+  "wait 60 seconds"
 ];
 var RETRYABLE_HTTP_STATUS_CODES = /* @__PURE__ */ new Set([429, 503]);
 function isRetryableTransientError(error, message) {
@@ -26030,6 +26181,39 @@ function isRetryableTransientError(error, message) {
   return RETRYABLE_ERROR_MESSAGE_PATTERNS.some((p) => message.includes(p));
 }
 
+// src/deployment/retry.ts
+var defaultSleep = (ms) => new Promise((resolve4) => setTimeout(resolve4, ms));
+async function withRetry(operation, logicalId, opts = {}) {
+  const maxRetries = opts.maxRetries ?? 8;
+  const initialDelayMs = opts.initialDelayMs ?? 1e3;
+  const maxDelayMs = opts.maxDelayMs ?? 8e3;
+  const sleep = opts.sleep ?? defaultSleep;
+  let lastError;
+  for (let attempt = 0; attempt <= maxRetries; attempt++) {
+    try {
+      return await operation();
+    } catch (error) {
+      lastError = error;
+      const message = error instanceof Error ? error.message : String(error);
+      const retryable = isRetryableTransientError(error, message);
+      if (!retryable || attempt >= maxRetries) {
+        throw error;
+      }
+      const delay = Math.min(initialDelayMs * Math.pow(2, attempt), maxDelayMs);
+      opts.logger?.debug(
+        `  \u23F3 Retrying ${logicalId} in ${delay / 1e3}s (attempt ${attempt + 1}/${maxRetries}) - ${message}`
+      );
+      for (let waited = 0; waited < delay; waited += 1e3) {
+        if (opts.isInterrupted?.()) {
+          throw opts.onInterrupted ? opts.onInterrupted() : new Error("Interrupted");
+        }
+        await sleep(Math.min(1e3, delay - waited));
+      }
+    }
+  }
+  throw lastError;
+}
+
 // src/deployment/deploy-engine.ts
 var InterruptedError = class extends Error {
   constructor() {
@@ -27016,32 +27200,20 @@ var DeployEngine = class {
     );
   }
   /**
-   * Execute an operation with retry for transient IAM propagation errors
-   */
-  async withRetry(operation, logicalId, maxRetries = 8, initialDelayMs = 1e4) {
-    let lastError;
-    for (let attempt = 0; attempt <= maxRetries; attempt++) {
-      try {
-        return await operation();
-      } catch (error) {
-        lastError = error;
-        const message = error instanceof Error ? error.message : String(error);
-        const isRetryable = isRetryableTransientError(error, message);
-        if (!isRetryable || attempt >= maxRetries) {
-          throw error;
-        }
-        const delay = initialDelayMs * Math.pow(2, attempt);
-        this.logger.debug(
-          `  \u23F3 Retrying ${logicalId} in ${delay / 1e3}s (attempt ${attempt + 1}/${maxRetries}) - ${message}`
-        );
-        for (let waited = 0; waited < delay; waited += 1e3) {
-          if (this.interrupted)
-            throw new InterruptedError();
-          await new Promise((resolve4) => setTimeout(resolve4, Math.min(1e3, delay - waited)));
-        }
-      }
-    }
-    throw lastError;
+   * Execute an operation with retry for transient IAM propagation errors.
+   *
+   * Thin wrapper over `withRetry` from ./retry.js that injects this engine's
+   * SIGINT-aware interrupt check and logger. The actual backoff schedule
+   * lives there.
+   */
+  async withRetry(operation, logicalId, maxRetries, initialDelayMs) {
+    return withRetry(operation, logicalId, {
+      ...maxRetries !== void 0 && { maxRetries },
+      ...initialDelayMs !== void 0 && { initialDelayMs },
+      logger: this.logger,
+      isInterrupted: () => this.interrupted,
+      onInterrupted: () => new InterruptedError()
+    });
   }
   /**
    * Resolve stack outputs from template and resource attributes
@@ -27082,38 +27254,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) {
@@ -27347,7 +27487,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));
@@ -27363,7 +27503,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",
@@ -27561,7 +27701,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));
@@ -27572,7 +27712,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) {
@@ -27854,7 +27994,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));
@@ -27870,7 +28010,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) {
@@ -27888,7 +28028,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"
@@ -27901,7 +28041,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();
@@ -27944,7 +28084,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;
 }
@@ -27953,6 +28093,8 @@ function createForceUnlockCommand() {
 var SUBCOMMANDS = /* @__PURE__ */ new Set([
   "bootstrap",
   "synth",
+  "list",
+  "ls",
   "deploy",
   "diff",
   "destroy",
@@ -27970,10 +28112,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.1");
+  const program = new Command9();
+  program.name("cdkd").description("CDK Direct - Deploy AWS CDK apps directly via SDK/Cloud Control API").version("0.5.1");
   program.addCommand(createBootstrapCommand());
   program.addCommand(createSynthCommand());
+  program.addCommand(createListCommand());
   program.addCommand(createDeployCommand());
   program.addCommand(createDiffCommand());
   program.addCommand(createDestroyCommand());