@go-to-k/cdkd 0.31.0 → 0.31.1

package/README.md

@@ -414,6 +414,24 @@ per-resource timeout flags (`--resource-warn-after`,
 and the rationale for the 30m default), see
 **[docs/cli-reference.md](docs/cli-reference.md)**.
 
+## Exit codes
+
+cdkd commands distinguish three outcomes via the process exit code so
+CI / bench scripts can react without grepping log output:
+
+| Exit | Meaning |
+|------|---------|
+| `0` | Success — command completed and no resources are in an error state |
+| `1` | Command-level failure — auth error, bad arguments, synth crash, unhandled exception |
+| `2` | **Partial failure** — work completed but one or more resources failed (state.json is preserved, re-running typically resolves it) |
+
+Exit `2` is currently emitted by `cdkd destroy` and `cdkd state
+destroy` when one or more per-resource deletes fail. The summary line
+also switches from `✓ Stack X destroyed` to `⚠ Stack X partially
+destroyed (...). State preserved — re-run 'cdkd destroy' / 'cdkd
+state destroy' to clean up.` so the visual marker matches the exit
+code.
+
 ## Example
 
 ```typescript

package/dist/cli.js

@@ -1170,6 +1170,14 @@ var DependencyError = class _DependencyError extends CdkdError {
     Object.setPrototypeOf(this, _DependencyError.prototype);
   }
 };
+var PartialFailureError = class _PartialFailureError extends CdkdError {
+  exitCode = 2;
+  constructor(message, cause) {
+    super(message, "PARTIAL_FAILURE", cause);
+    this.name = "PartialFailureError";
+    Object.setPrototypeOf(this, _PartialFailureError.prototype);
+  }
+};
 function isCdkdError(error) {
   return error instanceof CdkdError;
 }
@@ -1193,7 +1201,8 @@ function handleError(error) {
   if (error instanceof Error && error.stack) {
     logger.debug("Stack trace:", error.stack);
   }
-  process.exit(1);
+  const exitCode = error instanceof PartialFailureError ? error.exitCode : 1;
+  process.exit(exitCode);
 }
 function withErrorHandling(fn) {
   return async (...args) => {
@@ -33548,10 +33557,17 @@ Acquiring lock for stack ${stackName}...`);
     } else {
       logger.warn(`${result.errorCount} resource(s) failed to delete. State preserved.`);
     }
-    logger.info(
-      `
+    if (result.errorCount === 0) {
+      logger.info(
+        `
 \u2713 Stack ${stackName} destroyed (${result.deletedCount} deleted, ${result.errorCount} errors)`
-    );
+      );
+    } else {
+      logger.warn(
+        `
+\u26A0 Stack ${stackName} partially destroyed (${result.deletedCount} deleted, ${result.errorCount} errors). State preserved \u2014 re-run 'cdkd destroy' / 'cdkd state destroy' to clean up.`
+      );
+    }
   } finally {
     renderer.stop();
     logger.debug("Releasing lock...");
@@ -33671,6 +33687,7 @@ async function destroyCommand(stackArgs, options) {
       arr.push(ref);
       stateRefsByName.set(ref.stackName, arr);
     }
+    let totalErrors = 0;
     for (const stackName of stackNames) {
       logger.info(`
 Preparing to destroy stack: ${stackName}`);
@@ -33701,7 +33718,7 @@ Preparing to destroy stack: ${stackName}`);
         logger.warn(`No state found for stack ${stackName}, skipping`);
         continue;
       }
-      await runDestroyForStack(stackName, stateResult.state, {
+      const result = await runDestroyForStack(stackName, stateResult.state, {
         stateBackend,
         lockManager,
         providerRegistry,
@@ -33723,6 +33740,12 @@ Preparing to destroy stack: ${stackName}`);
           resourceTimeoutByType: options.resourceTimeout.perTypeMs
         }
       });
+      totalErrors += result.errorCount;
+    }
+    if (totalErrors > 0) {
+      throw new PartialFailureError(
+        `Destroy completed with ${totalErrors} resource error(s). State preserved \u2014 inspect 'cdkd state show <stack>' and re-run 'cdkd destroy' to retry.`
+      );
     }
   } finally {
     awsClients.destroy();
@@ -35420,8 +35443,8 @@ Preparing to destroy stack: ${stackName}${ref.region ? ` (${ref.region})` : ""}`
       }
     }
     if (totalErrors > 0) {
-      throw new Error(
-        `Destroy completed with ${totalErrors} resource error(s). Inspect 'cdkd state show <stack>' and re-run.`
+      throw new PartialFailureError(
+        `Destroy completed with ${totalErrors} resource error(s). State preserved \u2014 inspect 'cdkd state show <stack>' and re-run 'cdkd state destroy' to retry.`
       );
     }
   } finally {
@@ -36330,7 +36353,7 @@ function reorderArgs(argv) {
 }
 async function main() {
   const program = new Command13();
-  program.name("cdkd").description("CDK Direct - Deploy AWS CDK apps directly via SDK/Cloud Control API").version("0.31.0");
+  program.name("cdkd").description("CDK Direct - Deploy AWS CDK apps directly via SDK/Cloud Control API").version("0.31.1");
   program.addCommand(createBootstrapCommand());
   program.addCommand(createSynthCommand());
   program.addCommand(createListCommand());