cloudburn 0.7.0 → 0.8.2

package/README.md

@@ -76,8 +76,8 @@ cloudburn completion zsh
               "resourceId": "aws_ebs_volume.gp2_data",
               "location": {
                 "path": "main.tf",
-                "startLine": 4,
-                "startColumn": 3
+                "line": 4,
+                "column": 3
               }
             }
           ]

package/dist/cli.js

@@ -459,7 +459,7 @@ var registerCompletionCommand = (program) => {
 
 // src/commands/discover.ts
 import { assertValidAwsRegion, CloudBurnClient } from "@cloudburn/sdk";
-import { InvalidArgumentError as InvalidArgumentError2 } from "commander";
+import { InvalidArgumentError as InvalidArgumentError3 } from "commander";
 
 // src/exit-codes.ts
 var EXIT_CODE_OK = 0;
@@ -528,6 +528,9 @@ var flattenScanResult = (result) => result.providers.flatMap(
 var countScanResultFindings = (result) => flattenScanResult(result).length;
 
 // src/formatters/output.ts
+var DEFAULT_TABLE_WIDTH = 200;
+var MIN_COLUMN_WIDTH = 4;
+var PREFERRED_MIN_COLUMN_WIDTH = 8;
 var supportedOutputFormats = ["text", "json", "table"];
 var scanColumns = [
   { key: "provider", header: "Provider" },
@@ -538,8 +541,8 @@ var scanColumns = [
   { key: "accountId", header: "AccountId" },
   { key: "region", header: "Region" },
   { key: "path", header: "Path" },
-  { key: "startLine", header: "StartLine" },
-  { key: "startColumn", header: "StartColumn" },
+  { key: "line", header: "Line" },
+  { key: "column", header: "Column" },
   { key: "message", header: "Message" }
 ];
 var formatOptionDescription = "Options: table: human-readable terminal output.\ntext: tab-delimited output for grep, sed, and awk.\njson: machine-readable output for automation and downstream systems.";
@@ -645,8 +648,8 @@ var projectScanRows = (result) => flattenScanResult(result).map(({ finding, mess
   ruleId,
   service,
   source,
-  startColumn: finding.location?.startColumn ?? "",
-  startLine: finding.location?.startLine ?? ""
+  column: finding.location?.column ?? "",
+  line: finding.location?.line ?? ""
 }));
 var renderTextRows = (rows, columns, emptyMessage) => {
   if (rows.length === 0) {
@@ -694,17 +697,128 @@ var toTextCell = (value) => {
   }
   return JSON.stringify(value);
 };
-var toTableCell = (value) => toTextCell(value).replace(/\r?\n/g, "\\n");
-var renderAsciiTable = (rows, columns) => {
-  const widths = columns.map(
+var toTableCell = (value) => {
+  if (Array.isArray(value)) {
+    return value.map((item) => toTextCell(item)).join(", ").replace(/\r?\n/g, "\\n");
+  }
+  return toTextCell(value).replace(/\r?\n/g, "\\n");
+};
+var resolveTableColumns = (rows, columns) => {
+  const visibleColumns = columns.filter((column) => rows.some((row) => toTableCell(row[column.key]).length > 0));
+  return visibleColumns.length === 0 ? columns : visibleColumns;
+};
+var getTargetTableWidth = () => {
+  const terminalWidth = process.stdout.columns;
+  return typeof terminalWidth === "number" && Number.isFinite(terminalWidth) && terminalWidth > 0 ? terminalWidth : DEFAULT_TABLE_WIDTH;
+};
+var measureTableWidth = (widths) => widths.reduce((total, width) => total + width, 0) + widths.length * 3 + 1;
+var fitColumnWidths = (columns, rows) => {
+  const maxWidths = columns.map(
     (column) => Math.max(column.header.length, ...rows.map((row) => toTableCell(row[column.key]).length))
   );
+  const minWidths = columns.map(
+    (column, index) => Math.min(
+      maxWidths[index] ?? MIN_COLUMN_WIDTH,
+      Math.max(MIN_COLUMN_WIDTH, Math.min(column.header.length, PREFERRED_MIN_COLUMN_WIDTH))
+    )
+  );
+  const widths = [...maxWidths];
+  const targetWidth = getTargetTableWidth();
+  while (measureTableWidth(widths) > targetWidth) {
+    let widestColumnIndex = -1;
+    for (let index = 0; index < widths.length; index += 1) {
+      if ((widths[index] ?? 0) <= (minWidths[index] ?? MIN_COLUMN_WIDTH)) {
+        continue;
+      }
+      if (widestColumnIndex === -1 || (widths[index] ?? 0) > (widths[widestColumnIndex] ?? 0)) {
+        widestColumnIndex = index;
+      }
+    }
+    if (widestColumnIndex === -1) {
+      break;
+    }
+    widths[widestColumnIndex] = Math.max(MIN_COLUMN_WIDTH, (widths[widestColumnIndex] ?? MIN_COLUMN_WIDTH) - 1);
+  }
+  return widths;
+};
+var wrapToken = (token, width) => {
+  if (token.length <= width) {
+    return [token];
+  }
+  const segments = [];
+  for (let start = 0; start < token.length; start += width) {
+    segments.push(token.slice(start, start + width));
+  }
+  return segments;
+};
+var wrapCell = (value, width) => {
+  if (value.length <= width) {
+    return [value];
+  }
+  const words = value.split(/\s+/).filter((word) => word.length > 0);
+  if (words.length === 0) {
+    return [""];
+  }
+  const lines = [];
+  let currentLine = "";
+  for (const word of words) {
+    if (word.length > width) {
+      if (currentLine.length > 0) {
+        lines.push(currentLine);
+        currentLine = "";
+      }
+      lines.push(...wrapToken(word, width));
+      continue;
+    }
+    if (currentLine.length === 0) {
+      currentLine = word;
+      continue;
+    }
+    if (currentLine.length + 1 + word.length <= width) {
+      currentLine = `${currentLine} ${word}`;
+      continue;
+    }
+    lines.push(currentLine);
+    currentLine = word;
+  }
+  if (currentLine.length > 0) {
+    lines.push(currentLine);
+  }
+  return lines;
+};
+var renderTableLines = (cells, widths) => {
+  const wrappedCells = cells.map((cell, index) => wrapCell(cell, widths[index] ?? MIN_COLUMN_WIDTH));
+  const height = Math.max(...wrappedCells.map((lines) => lines.length));
+  return Array.from({ length: height }, (_, lineIndex) => {
+    const line = wrappedCells.map((lines, index) => (lines[lineIndex] ?? "").padEnd(widths[index] ?? MIN_COLUMN_WIDTH)).join(" | ");
+    return `| ${line} |`;
+  });
+};
+var renderAsciiTable = (rows, columns) => {
+  const visibleColumns = resolveTableColumns(rows, columns);
+  const widths = fitColumnWidths(visibleColumns, rows);
   const border = `+${widths.map((width) => "-".repeat(width + 2)).join("+")}+`;
-  const header = `| ${columns.map((column, index) => column.header.padEnd(widths[index] ?? 0)).join(" | ")} |`;
-  const body = rows.map(
-    (row) => `| ${columns.map((column, index) => toTableCell(row[column.key]).padEnd(widths[index] ?? 0)).join(" | ")} |`
+  const header = renderTableLines(
+    visibleColumns.map((column) => column.header),
+    widths
   );
-  return [border, header, border, ...body, border].join("\n");
+  const body = rows.flatMap(
+    (row) => renderTableLines(
+      visibleColumns.map((column) => toTableCell(row[column.key])),
+      widths
+    )
+  );
+  return [border, ...header, border, ...body, border].join("\n");
+};
+
+// src/commands/config-options.ts
+import { InvalidArgumentError as InvalidArgumentError2 } from "commander";
+var parseRuleIdList = (value) => {
+  const ruleIds = value.split(",").map((ruleId) => ruleId.trim()).filter((ruleId) => ruleId.length > 0);
+  if (ruleIds.length === 0) {
+    throw new InvalidArgumentError2("Provide at least one rule ID.");
+  }
+  return ruleIds;
 };
 
 // src/commands/discover.ts
@@ -712,7 +826,7 @@ var parseAwsRegion = (value) => {
   try {
     return assertValidAwsRegion(value);
   } catch (err) {
-    throw new InvalidArgumentError2(err instanceof Error ? err.message : "Invalid AWS region.");
+    throw new InvalidArgumentError3(err instanceof Error ? err.message : "Invalid AWS region.");
   }
 };
 var parseDiscoverRegion = (value) => {
@@ -722,6 +836,17 @@ var parseDiscoverRegion = (value) => {
   return parseAwsRegion(value);
 };
 var resolveDiscoveryTarget = (region) => region === void 0 ? { mode: "current" } : region === "all" ? { mode: "all" } : { mode: "region", region };
+var toDiscoveryConfigOverride = (options) => {
+  if (options.enabledRules === void 0 && options.disabledRules === void 0) {
+    return void 0;
+  }
+  return {
+    discovery: {
+      disabledRules: options.disabledRules,
+      enabledRules: options.enabledRules
+    }
+  };
+};
 var runCommand = async (action) => {
   try {
     process.exitCode = await action() ?? EXIT_CODE_OK;
@@ -737,11 +862,22 @@ var registerDiscoverCommand = (program) => {
       "--region <region>",
       'Discovery region to use. Pass "all" to require an aggregator index.',
       parseDiscoverRegion
-    ).option("--exit-code", "Exit with code 1 when findings exist").action(async (options, command) => {
+    ).option("--config <path>", "Explicit CloudBurn config file to load").option("--enabled-rules <ruleIds>", "Comma-separated rule IDs to enable", parseRuleIdList).option("--disabled-rules <ruleIds>", "Comma-separated rule IDs to disable", parseRuleIdList).option("--exit-code", "Exit with code 1 when findings exist").action(async (options, command) => {
       await runCommand(async () => {
         const scanner = new CloudBurnClient();
-        const result = await scanner.discover({ target: resolveDiscoveryTarget(options.region) });
-        const format = resolveOutputFormat(command);
+        const loadedConfig = await scanner.loadConfig(options.config);
+        const discoveryOptions = {
+          target: resolveDiscoveryTarget(options.region)
+        };
+        const configOverride = toDiscoveryConfigOverride(options);
+        if (configOverride !== void 0) {
+          discoveryOptions.config = configOverride;
+        }
+        if (options.config !== void 0) {
+          discoveryOptions.configPath = options.config;
+        }
+        const result = await scanner.discover(discoveryOptions);
+        const format = resolveOutputFormat(command, void 0, loadedConfig.discovery.format ?? "table");
         const output = renderResponse({ kind: "scan-result", result }, format);
         process.stdout.write(`${output}
 `);
@@ -874,26 +1010,105 @@ var registerEstimateCommand = (program) => {
 };
 
 // src/commands/init.ts
-var starterConfig = `version: 1
-profile: dev
+import { access, writeFile } from "fs/promises";
+import { dirname, join, resolve } from "path";
+var CONFIG_FILENAMES = [".cloudburn.yml", ".cloudburn.yaml"];
+var starterConfig = `# Static IaC scan configuration.
+# enabled-rules restricts scans to only the listed rule IDs.
+# disabled-rules removes specific rule IDs from the active set.
+# format sets the default output format when --format is not passed.
+iac:
+  enabled-rules:
+    - CLDBRN-AWS-EBS-1
+  disabled-rules:
+    - CLDBRN-AWS-EC2-2
+  format: table
 
-# Profiles are parsed but not applied yet, so configure the active rules block directly for now.
-rules:
-  ec2-instance-type-preferred:
-    severity: error
+# Live AWS discovery configuration.
+# Use the same rule controls here to tune discover runs separately from IaC scans.
+discovery:
+  enabled-rules:
+    - CLDBRN-AWS-EBS-1
+  disabled-rules:
+    - CLDBRN-AWS-S3-1
+  format: json
 `;
+var renderStarterConfig = (command) => renderResponse(
+  {
+    kind: "document",
+    content: starterConfig,
+    contentType: "application/yaml"
+  },
+  resolveOutputFormat(command, void 0, "text")
+);
+var fileExists = async (path) => {
+  try {
+    await access(path);
+    return true;
+  } catch {
+    return false;
+  }
+};
+var findProjectRoot = async (startDirectory) => {
+  let currentDirectory = resolve(startDirectory);
+  while (true) {
+    if (await fileExists(join(currentDirectory, ".git"))) {
+      return currentDirectory;
+    }
+    const parentDirectory = dirname(currentDirectory);
+    if (parentDirectory === currentDirectory) {
+      return resolve(startDirectory);
+    }
+    currentDirectory = parentDirectory;
+  }
+};
 var registerInitCommand = (program) => {
-  program.command("init").description("Print a starter .cloudburn.yml configuration").action(function() {
-    const output = renderResponse(
-      {
-        kind: "document",
-        content: starterConfig,
-        contentType: "application/yaml"
-      },
-      resolveOutputFormat(this, void 0, "text")
-    );
-    process.stdout.write(`${output}
+  const initCommand = program.command("init").description("Initialize CloudBurn scaffolding").usage("[command]").action(function() {
+    process.stdout.write(`${renderStarterConfig(this)}
 `);
+    process.exitCode = EXIT_CODE_OK;
+  });
+  initCommand.command("config").description("Create a starter .cloudburn.yml configuration").option("--print", "Print the starter config instead of writing the file").action(async function(options) {
+    try {
+      if (options.print) {
+        process.stdout.write(`${renderStarterConfig(this)}
+`);
+        process.exitCode = EXIT_CODE_OK;
+        return;
+      }
+      const rootDirectory = await findProjectRoot(process.cwd());
+      const existingConfigPath = (await Promise.all(
+        CONFIG_FILENAMES.map(async (filename) => {
+          const path = join(rootDirectory, filename);
+          return await fileExists(path) ? path : void 0;
+        })
+      )).find((path) => path !== void 0);
+      if (existingConfigPath) {
+        throw new Error(
+          `CloudBurn config already exists at ${existingConfigPath}. Use --print to inspect the template.`
+        );
+      }
+      const configPath = join(rootDirectory, ".cloudburn.yml");
+      await writeFile(configPath, starterConfig, { encoding: "utf8", flag: "wx" });
+      const output = renderResponse(
+        {
+          kind: "status",
+          data: {
+            message: "Created CloudBurn config.",
+            path: configPath
+          },
+          text: `Created ${configPath}.`
+        },
+        resolveOutputFormat(this)
+      );
+      process.stdout.write(`${output}
+`);
+      process.exitCode = EXIT_CODE_OK;
+    } catch (err) {
+      process.stderr.write(`${formatError(err)}
+`);
+      process.exitCode = EXIT_CODE_RUNTIME_ERROR;
+    }
   });
 };
 
@@ -917,13 +1132,27 @@ var registerRulesListCommand = (program) => {
 
 // src/commands/scan.ts
 import { CloudBurnClient as CloudBurnClient2 } from "@cloudburn/sdk";
+var toScanConfigOverride = (options) => {
+  if (options.enabledRules === void 0 && options.disabledRules === void 0) {
+    return void 0;
+  }
+  return {
+    iac: {
+      disabledRules: options.disabledRules,
+      enabledRules: options.enabledRules
+    }
+  };
+};
 var registerScanCommand = (program) => {
   setCommandExamples(
-    program.command("scan").description("Run an autodetected static IaC scan").argument("[path]", "Terraform file, CloudFormation template, or directory to scan").option("--exit-code", "Exit with code 1 when findings exist").action(async (path, options, command) => {
+    program.command("scan").description("Run an autodetected static IaC scan").argument("[path]", "Terraform file, CloudFormation template, or directory to scan").option("--config <path>", "Explicit CloudBurn config file to load").option("--enabled-rules <ruleIds>", "Comma-separated rule IDs to enable", parseRuleIdList).option("--disabled-rules <ruleIds>", "Comma-separated rule IDs to disable", parseRuleIdList).option("--exit-code", "Exit with code 1 when findings exist").action(async (path, options, command) => {
       try {
         const scanner = new CloudBurnClient2();
-        const result = await scanner.scanStatic(path ?? process.cwd());
-        const format = resolveOutputFormat(command);
+        const loadedConfig = await scanner.loadConfig(options.config);
+        const configOverride = toScanConfigOverride(options);
+        const scanPath = path ?? process.cwd();
+        const result = configOverride === void 0 && options.config === void 0 ? await scanner.scanStatic(scanPath) : options.config === void 0 ? await scanner.scanStatic(scanPath, configOverride) : await scanner.scanStatic(scanPath, configOverride, { configPath: options.config });
+        const format = resolveOutputFormat(command, void 0, loadedConfig.iac.format ?? "table");
         const output = renderResponse({ kind: "scan-result", result }, format);
         process.stdout.write(`${output}
 `);
@@ -945,7 +1174,7 @@ var registerScanCommand = (program) => {
 // src/cli.ts
 var createProgram = () => {
   const program = createCliCommand();
-  program.name("cloudburn").usage("[command]").description("Know what you spend. Fix what you waste.").version("0.7.0").option("--format <format>", OUTPUT_FORMAT_OPTION_DESCRIPTION, parseOutputFormat);
+  program.name("cloudburn").usage("[command]").description("Know what you spend. Fix what you waste.").version("0.8.2").option("--format <format>", OUTPUT_FORMAT_OPTION_DESCRIPTION, parseOutputFormat);
   configureCliHelp(program);
   registerCompletionCommand(program);
   registerDiscoverCommand(program);

package/package.json

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