update readme

Author: RubenHalman

README.md

@@ -3,7 +3,7 @@
     <img src="media/bannerslim.png" style="width: 41%;" />
   </a>
 </p>
-<p align="center">Scans for unsafe contexts, hardcoded IDs, and other issues to optimize your Flows.</p>
+<p align="center"><i>Detect unsafe contexts, queries in loops, hardcoded IDs, and more to optimize your Salesforce Flows</i></p>
 
 <p align="center">
  <img src="media/demo.gif" alt="Flow Overview" width="88%" />
@@ -15,6 +15,7 @@ Use our side bar or the **Command Palette** and type `Flow Scanner` to see the l
 
 * `Configure Rules` Allows to define rules and expressions as per defined in the [core documentation](https://github.com/Flow-Scanner/lightning-flow-scanner-core).
 * `Scan Flows` allows choosing either a directory or a selection of flows to run the analysis against.
+* `Calc Coverage` calculates the test coverage of Flows in the default org.
 * `Fix Flows` will apply available fixes automatically.
 * `Open Documentation` can be used to reference the documentation.
 
@@ -36,29 +37,51 @@ Use our side bar or the **Command Palette** and type `Flow Scanner` to see the l
 >
 > Volta will automatically use the Node.js version defined in `package.json`.
 
-1. Clone the repo:
+1. **Clone the repository**
 
-   ```bash
-   git clone https://github.com/Flow-Scanner/lightning-flow-scanner-vsx.git
-   ```
-2. Install dependencies:
+```bash
+  git clone https://github.com/Flow-Scanner/lightning-flow-scanner-vsx.git
+```
 
-   ```bash
-   npm install
-   ```
-3. run dev environment
+2. **Install Dependencies**
 
-   ```
-   npm run watch
-   ```
-4. build vsix
+```bash
+  npm install
+```
 
-   ```
-   npm run build
-   ```
+3. **Build the Project**
 
-## Contributing
+```bash
+  npm run build
+```
 
-The original `lightning-flow-scanner-vsce` package was unpublished from the Visual Studio Marketplace after a Remote Code Execution (RCE) vulnerability was identified in its core dependency, `lightning-flow-scanner-core`. This issue, caused by unsafe custom rule loading, has been fully resolved in the [v5.1.0 release of the core library](https://github.com/Flow-Scanner/lightning-flow-scanner-core/releases/tag/v5.1.0). The [lightning-flow-scanner-vsx](https://github.com/Flow-Scanner/lightning-flow-scanner-vsx) fork, focusses on security and maintainability.
+4. **Watch for Changes**
 
-###### Want to help improve Lightning Flow Scanner? See our [Contributing Guidelines](https://github.com/Flow-Scanner/lightning-flow-scanner-core?tab=contributing-ov-file).
+```bash
+  npm run watch
+```
+
+5. **Run End-to-End Tests**
+
+```bash
+  npm run wdio-test
+```
+
+6. **Linking** **Core Module (Optional)**
+
+If you’re developing or testing updates to the core module, you can link it locally:
+
+- In the core module directory, run:
+  ```bash
+  npm run link
+  ```
+- In this CLI project directory, run:
+  ```bash
+  npm link lightning-flow-scanner-core
+  ```
+
+## VSCE to VSX
+
+The `lightning-flow-scanner-vsce` package was unpublished from the Visual Studio and Open VSX Marketplaces due to a vulnerability in `lightning-flow-scanner-core`, stemming from unsafe rule loading. This issue was addressed in [v5 of the core library](https://github.com/Flow-Scanner/lightning-flow-scanner-core/releases/tag/v5.1.0). This fork, created on 22/09/2025, emphasizes security and maintainability.
+
+<p><strong>Want to help improve Lightning Flow Scanner? See our <a href="https://github.com/Flow-Scanner/lightning-flow-scanner-core?tab=contributing-ov-file">Contributing Guidelines</a></strong></p>