cloudburn 0.3.1 → 0.4.0

package/README.md

@@ -14,6 +14,16 @@ npm install -g cloudburn
 cloudburn
 ```
 
+Static scans auto-detect Terraform and CloudFormation from the file or
+directory path you pass to `cloudburn scan`.
+
+```sh
+cloudburn scan ./main.tf
+cloudburn scan ./template.yaml
+cloudburn scan ./iac
+cloudburn scan --live
+```
+
 `cloudburn scan --format json` emits the lean canonical grouped result:
 
 ```json

package/dist/cli.js

@@ -58,6 +58,35 @@ import { InvalidArgumentError } from "commander";
 // src/exit-codes.ts
 var EXIT_CODE_OK = 0;
 var EXIT_CODE_POLICY_VIOLATION = 1;
+var EXIT_CODE_RUNTIME_ERROR = 2;
+
+// src/formatters/error.ts
+var formatError = (err) => {
+  const envelope = { error: categorize(err) };
+  return JSON.stringify(envelope, null, 2);
+};
+var categorize = (err) => {
+  if (!(err instanceof Error)) {
+    return { code: "RUNTIME_ERROR", message: "An unexpected error occurred." };
+  }
+  if (err.name === "CredentialsProviderError" || err.name === "ExpiredTokenException") {
+    return {
+      code: "CREDENTIALS_ERROR",
+      message: "AWS credentials not found or expired. Run 'aws sts get-caller-identity' to verify your session."
+    };
+  }
+  if (err.name.includes("AccessDenied")) {
+    return {
+      code: "ACCESS_DENIED",
+      message: "Insufficient AWS permissions. Check your IAM role or policy."
+    };
+  }
+  if (err.code === "ENOENT") {
+    const path = err.path ?? "unknown";
+    return { code: "PATH_NOT_FOUND", message: `Path not found: ${path}` };
+  }
+  return { code: "RUNTIME_ERROR", message: err.message || "An unexpected error occurred." };
+};
 
 // src/formatters/json.ts
 var formatJson = (result) => JSON.stringify(result, null, 2);
@@ -148,25 +177,40 @@ var formatters = {
   table: formatTable
 };
 var registerScanCommand = (program) => {
-  program.command("scan [path]").description("Run static IaC scan or live AWS scan").option("--live", "Run live AWS scan").option("--format <format>", "Output format: table|json|sarif", parseScanFormat, "table").option("--exit-code", "Exit with code 1 when findings exist").action(async (path, options) => {
-    const scanner = new CloudBurnScanner();
-    const result = options.live ? await scanner.scanLive() : await scanner.scanStatic(path ?? process.cwd());
-    const format = formatters[options.format ?? "table"];
-    const output = format(result);
-    process.stdout.write(`${output}
+  program.command("scan").description("Run an autodetected static IaC scan, or a live AWS scan with --live").argument("[path]", "Terraform file, CloudFormation template, or directory to scan").option("--live", "Run live AWS scan").option("--format <format>", "Output format: table|json|sarif", parseScanFormat, "table").option("--exit-code", "Exit with code 1 when findings exist").addHelpText(
+    "after",
+    `
+Examples:
+  cloudburn scan ./main.tf
+  cloudburn scan ./template.yaml
+  cloudburn scan ./iac
+  cloudburn scan --live
+`
+  ).action(async (path, options) => {
+    try {
+      const scanner = new CloudBurnScanner();
+      const result = options.live ? await scanner.scanLive() : await scanner.scanStatic(path ?? process.cwd());
+      const format = formatters[options.format ?? "table"];
+      const output = format(result);
+      process.stdout.write(`${output}
 `);
-    if (options.exitCode && countScanResultFindings(result) > 0) {
-      process.exitCode = EXIT_CODE_POLICY_VIOLATION;
-      return;
+      if (options.exitCode && countScanResultFindings(result) > 0) {
+        process.exitCode = EXIT_CODE_POLICY_VIOLATION;
+        return;
+      }
+      process.exitCode = EXIT_CODE_OK;
+    } catch (err) {
+      process.stderr.write(`${formatError(err)}
+`);
+      process.exitCode = EXIT_CODE_RUNTIME_ERROR;
     }
-    process.exitCode = EXIT_CODE_OK;
   });
 };
 
 // src/cli.ts
 var createProgram = () => {
   const program = new Command();
-  program.name("cloudburn").description("Know what you spend. Fix what you waste.").version("0.0.0");
+  program.name("cloudburn").description("Know what you spend. Fix what you waste.").version("0.4.0");
   registerScanCommand(program);
   registerInitCommand(program);
   registerRulesListCommand(program);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cloudburn",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Cloudburn CLI for cloud cost optimization",
   "type": "module",
   "bin": {
@@ -11,7 +11,7 @@
   ],
   "dependencies": {
     "commander": "^13.1.0",
-    "@cloudburn/sdk": "0.6.0"
+    "@cloudburn/sdk": "0.6.1"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.6",