add examples to readme

Author: RubenHalman

README.md

@@ -15,6 +15,7 @@
 ## Table of contens
 
 - **[Usage](#usage)**
+  - [Examples](#examples)
 - **[Configuration](#configuration)**
   - [Scanner Options](#scanner-options)
 - **[Installation](#installation)**
@@ -45,6 +46,23 @@ Customize the scan behavior using the following options:
 
 **Privacy:** Zero user data collected. All processing is client-side. → See Data Handling in our [Security Policy](https://github.com/Flow-Scanner/lightning-flow-scanner-cli?tab=security-ov-file).
 
+### Examples
+
+Quick local scan with JSON output
+```
+sf flow:scan -d ./flows --json
+```
+
+CI/CD ready with SARIF
+```
+sf flow:scan -d src/flows --sarif > report.sarif
+```
+
+Scan only two specific flows with beta rules
+```
+sf flow:scan -p "flows/Opportunity_Auto_Approve.flow-meta.xml" "flows/Case_Escalation.flow-meta.xml" -z --json
+```
+
 ---
 
 ## Configuration

src/commands/flow/scan.ts

@@ -115,14 +115,26 @@ export default class Scan extends SfCommand<Output> {
       this.error(`Scan failed: ${(err as Error).message}`);
     }
 
-    // BUILD RESULTS ONCE — AND ONLY ONCE
+    // BUILD RESULTS
     const results = this.buildResults(scanResults);
 
-    // SARIF: now uses correct errorCounters
+    // SARIF: output
     if (flags.sarif) {
       const sarif = await exportSarif(scanResults);
-      process.stdout.write(sarif + '\n');
-      process.exit(this.getStatus());
+      this.log(sarif); // ← ONLY THIS WORKS reliably
+      const status = this.getStatus();
+      if (status > 0) {
+        process.exitCode = status;
+      }
+      return {
+        summary: {
+          flowsNumber: scanResults.length,
+          results: results.length,
+          message: "SARIF output generated",
+        },
+        status,
+        results: [],
+      };
     }
 
     this.debug(`scan results: ${scanResults.length}`, ...scanResults);
@@ -168,7 +180,6 @@ export default class Scan extends SfCommand<Output> {
       flowsNumber: scanResults.length,
       results: results.length,
       message: `A total of ${results.length} results have been found in ${scanResults.length} flows.`,
-      errorLevelsDetails: Object.fromEntries(this.errorCounters),
     };
     return { summary, status, results };
   }