cloudburn 0.1.2 → 0.3.0

package/README.md

@@ -14,6 +14,36 @@ npm install -g cloudburn
 cloudburn
 ```
 
+`cloudburn scan --format json` emits the lean canonical grouped result:
+
+```json
+{
+  "providers": [
+    {
+      "provider": "aws",
+      "rules": [
+        {
+          "ruleId": "CLDBRN-AWS-EBS-1",
+          "service": "ebs",
+          "source": "iac",
+          "message": "EBS volumes should use current-generation storage.",
+          "findings": [
+            {
+              "resourceId": "aws_ebs_volume.gp2_data",
+              "location": {
+                "path": "main.tf",
+                "startLine": 4,
+                "startColumn": 3
+              }
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}
+```
+
 ## License
 
 Apache-2.0

package/dist/cli.js

@@ -53,29 +53,52 @@ var registerRulesListCommand = (program) => {
 
 // src/commands/scan.ts
 import { CloudBurnScanner } from "@cloudburn/sdk";
+import { InvalidArgumentError } from "commander";
 
 // src/exit-codes.ts
 var EXIT_CODE_OK = 0;
 var EXIT_CODE_POLICY_VIOLATION = 1;
 
 // src/formatters/json.ts
-var formatJson = (findings) => JSON.stringify({ findings }, null, 2);
+var formatJson = (result) => JSON.stringify(result, null, 2);
+
+// src/formatters/shared.ts
+var flattenScanResult = (result) => result.providers.flatMap(
+  (providerGroup) => providerGroup.rules.flatMap(
+    (ruleGroup) => ruleGroup.findings.map((finding) => ({
+      provider: providerGroup.provider,
+      ruleId: ruleGroup.ruleId,
+      service: ruleGroup.service,
+      source: ruleGroup.source,
+      message: ruleGroup.message,
+      finding
+    }))
+  )
+);
+var countScanResultFindings = (result) => flattenScanResult(result).length;
 
-// src/formatters/markdown.ts
-var formatMarkdown = (findings) => {
-  if (findings.length === 0) {
-    return "## CloudBurn Findings\n\nNo findings.";
+// src/formatters/sarif.ts
+var toSarifLocation = (finding) => {
+  if (!finding.location) {
+    return void 0;
   }
-  const rows = findings.map((finding) => `| ${finding.ruleId} | ${finding.resource.resourceId} | ${finding.message} |`).join("\n");
-  return `## CloudBurn Findings
-
-| Rule | Resource | Message |
-| --- | --- | --- |
-${rows}`;
+  return [
+    {
+      physicalLocation: {
+        artifactLocation: {
+          uri: finding.location.path
+        },
+        region: {
+          startLine: finding.location.startLine,
+          startColumn: finding.location.startColumn,
+          ...finding.location.endLine ? { endLine: finding.location.endLine } : {},
+          ...finding.location.endColumn ? { endColumn: finding.location.endColumn } : {}
+        }
+      }
+    }
+  ];
 };
-
-// src/formatters/sarif.ts
-var formatSarif = (findings) => JSON.stringify(
+var formatSarif = (result) => JSON.stringify(
   {
     version: "2.1.0",
     runs: [
@@ -85,11 +108,12 @@ var formatSarif = (findings) => JSON.stringify(
             name: "cloudburn"
           }
         },
-        results: findings.map((finding) => ({
-          ruleId: finding.ruleId,
+        results: flattenScanResult(result).map(({ ruleId, message, finding }) => ({
+          ruleId,
           // Severity was intentionally removed — all findings are warnings until a priority model is added.
           level: "warning",
-          message: { text: finding.message }
+          message: { text: message },
+          ...finding.location ? { locations: toSarifLocation(finding) } : {}
         }))
       }
     ]
@@ -99,29 +123,39 @@ var formatSarif = (findings) => JSON.stringify(
 );
 
 // src/formatters/table.ts
-var formatTable = (findings) => {
-  if (findings.length === 0) {
+var formatTable = (result) => {
+  const flattenedFindings = flattenScanResult(result);
+  if (flattenedFindings.length === 0) {
     return "No findings.";
   }
-  return findings.map((finding) => `${finding.ruleId} ${finding.resource.resourceId} ${finding.message}`).join("\n");
+  return flattenedFindings.map(({ provider, ruleId, source, service, message, finding }) => {
+    const location = finding.location ? ` ${finding.location.path}:${finding.location.startLine}:${finding.location.startColumn}` : "";
+    return `${provider} ${ruleId} ${source} ${service} ${finding.resourceId}${location} ${message}`;
+  }).join("\n");
 };
 
 // src/commands/scan.ts
+var supportedScanFormats = ["table", "json", "sarif"];
+var parseScanFormat = (value) => {
+  if (supportedScanFormats.includes(value)) {
+    return value;
+  }
+  throw new InvalidArgumentError(`Invalid format "${value}". Allowed formats: ${supportedScanFormats.join(", ")}.`);
+};
 var formatters = {
   json: formatJson,
-  markdown: formatMarkdown,
   sarif: formatSarif,
   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|markdown|sarif", "table").option("--exit-code", "Exit with code 1 when findings exist").action(async (path, options) => {
+  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"] ?? formatTable;
-    const output = format(result.findings);
+    const format = formatters[options.format ?? "table"];
+    const output = format(result);
     process.stdout.write(`${output}
 `);
-    if (options.exitCode && result.findings.length > 0) {
+    if (options.exitCode && countScanResultFindings(result) > 0) {
       process.exitCode = EXIT_CODE_POLICY_VIOLATION;
       return;
     }

package/package.json

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