@sfdxy/mule-lint 1.18.1 → 1.19.0

package/README.md

@@ -33,19 +33,19 @@ flowchart TB
     subgraph CLI["CLI Layer"]
         A[npx @sfdxy/mule-lint command]
     end
-    
+
     subgraph Engine["LintEngine"]
         B[FileScanner] --> C[XmlParser]
         C --> D[Rule Executor]
     end
-    
+
     subgraph Rules["Rules - Strategy Pattern"]
         D --> E[MULE-001]
         D --> F[MULE-002]
         D --> G[...]
         D --> H[MULE-010]
     end
-    
+
     subgraph Output["Formatters"]
         I[Table]
         J[JSON]
@@ -53,13 +53,13 @@ flowchart TB
         L[HTML Dashboard]
         M[CSV]
     end
-    
+
     subgraph HTMLStack["HTML Report Stack"]
         L --> N[Tailwind CSS]
         L --> O[Chart.js]
         L --> P[Tabulator]
     end
-    
+
     A --> B
     D --> I
     D --> J
@@ -79,7 +79,6 @@ flowchart LR
     E --> F["Table / JSON / SARIF / HTML / CSV"]
 ```
 
-
 ---
 
 ## Installation
@@ -118,16 +117,16 @@ npx @sfdxy/mule-lint ./src/main/mule --fail-on-warning
 
 ### CLI Options
 
-| Option | Description |
-|--------|-------------|
-| `-f, --format <type>` | Output format: `table`, `json`, `sarif`, `html`, `csv` (default: `table`) |
-| `-o, --output <file>` | Write output to file instead of stdout |
-| `-c, --config <file>` | Path to configuration file |
-| `-q, --quiet` | Show only errors (suppress warnings and info) |
-| `-e, --experimental` | **Enable experimental rules (opt-in)** |
-| `-g, --quality-gate <name>` | Apply quality gate: `default`, `strict`, or `config` |
-| `--fail-on-warning` | Exit with error code if warnings found |
-| `-v, --verbose` | Show verbose output |
+| Option                      | Description                                                               |
+| --------------------------- | ------------------------------------------------------------------------- |
+| `-f, --format <type>`       | Output format: `table`, `json`, `sarif`, `html`, `csv` (default: `table`) |
+| `-o, --output <file>`       | Write output to file instead of stdout                                    |
+| `-c, --config <file>`       | Path to configuration file                                                |
+| `-q, --quiet`               | Show only errors (suppress warnings and info)                             |
+| `-e, --experimental`        | **Enable experimental rules (opt-in)**                                    |
+| `-g, --quality-gate <name>` | Apply quality gate: `default`, `strict`, or `config`                      |
+| `--fail-on-warning`         | Exit with error code if warnings found                                    |
+| `-v, --verbose`             | Show verbose output                                                       |
 
 ---
 
@@ -137,10 +136,10 @@ Quality gates provide pass/fail thresholds for your CI/CD pipelines. When a gate
 
 ### Built-in Gates
 
-| Gate | Description |
-|------|-------------|
+| Gate      | Description                                                                   |
+| --------- | ----------------------------------------------------------------------------- |
 | `default` | Fails if errors > 0, warnings > 10, complexity > 20, or security hotspots > 0 |
-| `strict` | Fails if any errors, warnings > 0, or complexity > 10 |
+| `strict`  | Fails if any errors, warnings > 0, or complexity > 10                         |
 
 ### Usage
 
@@ -148,7 +147,7 @@ Quality gates provide pass/fail thresholds for your CI/CD pipelines. When a gate
 # Apply default quality gate
 npx @sfdxy/mule-lint ./src/main/mule -g default
 
-# Apply strict quality gate  
+# Apply strict quality gate
 npx @sfdxy/mule-lint ./src/main/mule -g strict
 
 # Use custom gate from config
@@ -181,40 +180,43 @@ The HTML report displays quality ratings for four key dimensions. These follow i
 **What it measures:** Average cyclomatic complexity across all flows.
 
 **Calculation:**
+
 - Count decision points per flow: `choice/when`, `foreach`, `try`, `scatter-gather`, `async`, `until-successful`, `error-handlers`
 - Base complexity = 1 + (total decision points)
 - **Rating = Average of all flow complexities**
 
-| Rating | Threshold | Interpretation |
-|--------|-----------|----------------|
-| **A** | Avg ≤ 5 | Simple, easy to test |
-| **B** | Avg ≤ 10 | Moderate complexity |
-| **C** | Avg ≤ 15 | Complex, consider splitting |
-| **D** | Avg ≤ 20 | High complexity, refactor recommended |
-| **E** | Avg > 20 | Very complex, critical refactoring needed |
+| Rating | Threshold | Interpretation                            |
+| ------ | --------- | ----------------------------------------- |
+| **A**  | Avg ≤ 5   | Simple, easy to test                      |
+| **B**  | Avg ≤ 10  | Moderate complexity                       |
+| **C**  | Avg ≤ 15  | Complex, consider splitting               |
+| **D**  | Avg ≤ 20  | High complexity, refactor recommended     |
+| **E**  | Avg > 20  | Very complex, critical refactoring needed |
 
 #### Maintainability Rating
 
 **What it measures:** Technical debt as a percentage of estimated development time.
 
 **Calculation:**
+
 - Debt minutes = (code smells × 5min) + (bugs × 15min) + (vulnerabilities × 30min)
 - Development estimate = (flows × 10min) + (subflows × 5min), minimum 60min
 - **Debt Ratio = (Debt minutes / Development estimate) × 100%**
 
-| Rating | Debt Ratio | Interpretation |
-|--------|-----------|----------------|
-| **A** | ≤ 5% | Excellent maintainability |
-| **B** | ≤ 10% | Good maintainability |
-| **C** | ≤ 20% | Moderate technical debt |
-| **D** | ≤ 50% | High debt, plan remediation |
-| **E** | > 50% | Critical debt, immediate action needed |
+| Rating | Debt Ratio | Interpretation                         |
+| ------ | ---------- | -------------------------------------- |
+| **A**  | ≤ 5%       | Excellent maintainability              |
+| **B**  | ≤ 10%      | Good maintainability                   |
+| **C**  | ≤ 20%      | Moderate technical debt                |
+| **D**  | ≤ 50%      | High debt, plan remediation            |
+| **E**  | > 50%      | Critical debt, immediate action needed |
 
 #### Reliability Rating
 
 **What it measures:** Number of bug-type issues detected.
 
 **Bug-type rules:** All `error-handling` category rules are classified as bugs, including:
+
 - Missing error handlers (MULE-003)
 - Missing correlation ID (MULE-007)
 - Generic error handling (MULE-009)
@@ -222,19 +224,20 @@ The HTML report displays quality ratings for four key dimensions. These follow i
 - Global error handler (MULE-001)
 - Try scope usage (ERR-001)
 
-| Rating | Bug Count | Interpretation |
-|--------|-----------|----------------|
-| **A** | 0 bugs | No reliability issues |
-| **B** | 1-2 bugs | Minor reliability concerns |
-| **C** | 3-5 bugs | Moderate reliability risk |
-| **D** | 6-10 bugs | High reliability risk |
-| **E** | > 10 bugs | Critical reliability issues |
+| Rating | Bug Count | Interpretation              |
+| ------ | --------- | --------------------------- |
+| **A**  | 0 bugs    | No reliability issues       |
+| **B**  | 1-2 bugs  | Minor reliability concerns  |
+| **C**  | 3-5 bugs  | Moderate reliability risk   |
+| **D**  | 6-10 bugs | High reliability risk       |
+| **E**  | > 10 bugs | Critical reliability issues |
 
 #### Security Rating
 
 **What it measures:** Vulnerability and security hotspot count.
 
 **Vulnerability rules:** All `security` category rules are classified as vulnerabilities, including:
+
 - Hardcoded credentials (MULE-201)
 - Insecure TLS (MULE-202)
 - Plaintext secrets (YAML-004)
@@ -243,13 +246,13 @@ The HTML report displays quality ratings for four key dimensions. These follow i
 - Rate limiting (SEC-003)
 - Input validation (SEC-004)
 
-| Rating | Vulnerabilities | Interpretation |
-|--------|-----------------|----------------|
-| **A** | 0 vulns | Secure configuration |
-| **B** | 1 vuln | Minor security finding |
-| **C** | 2-3 vulns | Security review needed |
-| **D** | 4-5 vulns | Security remediation required |
-| **E** | > 5 vulns | Critical security issues |
+| Rating | Vulnerabilities | Interpretation                |
+| ------ | --------------- | ----------------------------- |
+| **A**  | 0 vulns         | Secure configuration          |
+| **B**  | 1 vuln          | Minor security finding        |
+| **C**  | 2-3 vulns       | Security review needed        |
+| **D**  | 4-5 vulns       | Security remediation required |
+| **E**  | > 5 vulns       | Critical security issues      |
 
 ### Examples
 
@@ -270,106 +273,105 @@ npx @sfdxy/mule-lint src/main/mule -f sarif -o results.sarif
 
 ### Core Rules (MVP)
 
-| ID | Name | Severity | Category | Description |
-|----|------|----------|----------|-------------|
-| MULE-001 | Global Error Handler | Error | Error Handling | Project should have global error handler |
-| MULE-002 | Flow Naming | Warning | Naming | Flows end with `-flow`, sub-flows with `-subflow` |
-| MULE-003 | Missing Error Handler | Error | Error Handling | Flows should have error handlers |
-| MULE-004 | Hardcoded URLs | Error | Security | Use property placeholders for URLs |
-| MULE-005 | HTTP Status Check | Warning | Error Handling | Error handlers should set httpStatus |
-| MULE-006 | Logger Category | Warning | Logging | Loggers should have category attribute |
-| MULE-007 | Correlation ID | Warning | Error Handling | Error handlers should reference correlationId |
-| MULE-008 | Choice Anti-Pattern | Warning | Standards | Avoid raise-error in otherwise |
-| MULE-009 | Generic Error Type | Warning | Error Handling | Avoid catching type="ANY" |
-| MULE-010 | DWL Standards | Info | Standards | Standard DataWeave files should exist |
+| ID       | Name                  | Severity | Category       | Description                                       |
+| -------- | --------------------- | -------- | -------------- | ------------------------------------------------- |
+| MULE-001 | Global Error Handler  | Error    | Error Handling | Project should have global error handler          |
+| MULE-002 | Flow Naming           | Warning  | Naming         | Flows end with `-flow`, sub-flows with `-subflow` |
+| MULE-003 | Missing Error Handler | Error    | Error Handling | Flows should have error handlers                  |
+| MULE-004 | Hardcoded URLs        | Error    | Security       | Use property placeholders for URLs                |
+| MULE-005 | HTTP Status Check     | Warning  | Error Handling | Error handlers should set httpStatus              |
+| MULE-006 | Logger Category       | Warning  | Logging        | Loggers should have category attribute            |
+| MULE-007 | Correlation ID        | Warning  | Error Handling | Error handlers should reference correlationId     |
+| MULE-008 | Choice Anti-Pattern   | Warning  | Standards      | Avoid raise-error in otherwise                    |
+| MULE-009 | Generic Error Type    | Warning  | Error Handling | Avoid catching type="ANY"                         |
+| MULE-010 | DWL Standards         | Info     | Standards      | Standard DataWeave files should exist             |
 
 ### Extended Rules
 
-| ID | Name | Severity | Category | Description |
-|----|------|----------|----------|-------------|
-| MULE-101 | Flow Casing | Warning | Naming | kebab-case for flows |
-| MULE-102 | Variable Naming | Warning | Naming | camelCase for variables |
-| MULE-201 | Hardcoded Credentials | Error | Security | Use `${secure::}` |
-| MULE-202 | Insecure TLS | Error | Security | No insecure="true" |
-| MULE-301 | Logger Payload | Warning | Logging | Don't log entire payload |
-| MULE-303 | Logger in Retry | Warning | Logging | Avoid loggers in until-successful |
-| MULE-401 | HTTP User-Agent | Warning | HTTP | Include User-Agent |
-| MULE-402 | HTTP Content-Type | Warning | HTTP | POST/PUT needs Content-Type |
-| MULE-403 | HTTP Timeout | Warning | HTTP | Set responseTimeout |
-| MULE-501 | Scatter-Gather | Info | Performance | Limit parallel routes |
-| MULE-502 | Async Error | Warning | Performance | Async needs error handling |
-| MULE-503 | Large Choice | Warning | Performance | Max 7 when clauses |
-| MULE-601 | Flow Description | Info | Documentation | Add doc:description |
-| MULE-604 | Missing doc:name | Warning | Documentation | Key components need doc:name |
-| MULE-701 | Deprecated | Warning | Standards | Detect deprecated elements |
-| MULE-801 | Flow Complexity | Warning | Complexity | Cyclomatic complexity threshold |
-| MULE-802 | Project Structure | Warning | Structure | Validate folder structure |
-| MULE-803 | Global Config | Warning | Structure | global.xml should exist |
-| MULE-804 | Monolithic XML | Warning | Structure | Split large XML files |
+| ID       | Name                  | Severity | Category      | Description                       |
+| -------- | --------------------- | -------- | ------------- | --------------------------------- |
+| MULE-101 | Flow Casing           | Warning  | Naming        | kebab-case for flows              |
+| MULE-102 | Variable Naming       | Warning  | Naming        | camelCase for variables           |
+| MULE-201 | Hardcoded Credentials | Error    | Security      | Use `${secure::}`                 |
+| MULE-202 | Insecure TLS          | Error    | Security      | No insecure="true"                |
+| MULE-301 | Logger Payload        | Warning  | Logging       | Don't log entire payload          |
+| MULE-303 | Logger in Retry       | Warning  | Logging       | Avoid loggers in until-successful |
+| MULE-401 | HTTP User-Agent       | Warning  | HTTP          | Include User-Agent                |
+| MULE-402 | HTTP Content-Type     | Warning  | HTTP          | POST/PUT needs Content-Type       |
+| MULE-403 | HTTP Timeout          | Warning  | HTTP          | Set responseTimeout               |
+| MULE-501 | Scatter-Gather        | Info     | Performance   | Limit parallel routes             |
+| MULE-502 | Async Error           | Warning  | Performance   | Async needs error handling        |
+| MULE-503 | Large Choice          | Warning  | Performance   | Max 7 when clauses                |
+| MULE-601 | Flow Description      | Info     | Documentation | Add doc:description               |
+| MULE-604 | Missing doc:name      | Warning  | Documentation | Key components need doc:name      |
+| MULE-701 | Deprecated            | Warning  | Standards     | Detect deprecated elements        |
+| MULE-801 | Flow Complexity       | Warning  | Complexity    | Cyclomatic complexity threshold   |
+| MULE-802 | Project Structure     | Warning  | Structure     | Validate folder structure         |
+| MULE-803 | Global Config         | Warning  | Structure     | global.xml should exist           |
+| MULE-804 | Monolithic XML        | Warning  | Structure     | Split large XML files             |
 
 ### DataWeave & API-Led Rules
 
-| ID | Name | Severity | Category | Description |
-|----|------|----------|----------|-------------|
-| DW-001 | External DWL | Warning | DataWeave | Externalize complex transforms |
-| DW-002 | DWL Naming | Info | DataWeave | kebab-case for .dwl files |
-| DW-003 | DWL Modules | Info | DataWeave | Use common modules |
-| DW-004 | Java 17 DW Errors | Error | DataWeave | Java 17 compatible error handling |
-| API-001 | Experience Layer | Info | API-Led | Experience API patterns |
-| API-002 | Process Layer | Info | API-Led | Process layer orchestration |
-| API-003 | System Layer | Info | API-Led | System layer connections |
-| API-004 | Single SAPI | Warning | API-Led | Single system per SAPI |
+| ID      | Name              | Severity | Category  | Description                       |
+| ------- | ----------------- | -------- | --------- | --------------------------------- |
+| DW-001  | External DWL      | Warning  | DataWeave | Externalize complex transforms    |
+| DW-002  | DWL Naming        | Info     | DataWeave | kebab-case for .dwl files         |
+| DW-003  | DWL Modules       | Info     | DataWeave | Use common modules                |
+| DW-004  | Java 17 DW Errors | Error    | DataWeave | Java 17 compatible error handling |
+| API-001 | Experience Layer  | Info     | API-Led   | Experience API patterns           |
+| API-002 | Process Layer     | Info     | API-Led   | Process layer orchestration       |
+| API-003 | System Layer      | Info     | API-Led   | System layer connections          |
+| API-004 | Single SAPI       | Warning  | API-Led   | Single system per SAPI            |
 
 ### Experimental Rules
 
-| ID | Name | Severity | Category | Description |
-|----|------|----------|----------|-------------|
-| EXP-001 | Flow Ref Depth | Info | Experimental | Limit flow-ref chains |
-| EXP-002 | Config Naming | Info | Experimental | Connector config naming |
-| EXP-003 | MUnit Coverage | Info | Experimental | Check for MUnit tests |
-| YAML-001 | Env Files | Warning | Standards | Environment YAML files |
-| YAML-003 | Property Naming | Info | Standards | Property key format |
-| YAML-004 | Plaintext Secrets | Error | Security | Encrypt sensitive YAML properties |
+| ID       | Name              | Severity | Category     | Description                       |
+| -------- | ----------------- | -------- | ------------ | --------------------------------- |
+| EXP-001  | Flow Ref Depth    | Info     | Experimental | Limit flow-ref chains             |
+| EXP-002  | Config Naming     | Info     | Experimental | Connector config naming           |
+| EXP-003  | MUnit Coverage    | Info     | Experimental | Check for MUnit tests             |
+| YAML-001 | Env Files         | Warning  | Standards    | Environment YAML files            |
+| YAML-003 | Property Naming   | Info     | Standards    | Property key format               |
+| YAML-004 | Plaintext Secrets | Error    | Security     | Encrypt sensitive YAML properties |
 
 ### 2025-2026 Best Practices Rules (NEW)
 
-| ID | Name | Severity | Category | Description |
-|----|------|----------|----------|-------------|
-| SEC-002 | TLS Version | Error | Security | Detect deprecated TLS versions (< 1.2) |
-| SEC-003 | Rate Limiting | Warning | Security | APIs should have rate limiting configured |
-| SEC-004 | Input Validation | Warning | Security | Incoming payloads should be validated |
-| LOG-001 | Structured Logging | Info | Logging | Recommend JSON logger format |
-| LOG-004 | Sensitive Data Logging | Error | Logging | Detect PII/secrets in log statements |
-| ERR-001 | Try Scope | Info | Error Handling | Complex operations should use Try scope |
-| PERF-002 | Connection Pooling | Warning | Performance | DB/HTTP should configure connection pools |
+| ID       | Name                   | Severity | Category       | Description                               |
+| -------- | ---------------------- | -------- | -------------- | ----------------------------------------- |
+| SEC-002  | TLS Version            | Error    | Security       | Detect deprecated TLS versions (< 1.2)    |
+| SEC-003  | Rate Limiting          | Warning  | Security       | APIs should have rate limiting configured |
+| SEC-004  | Input Validation       | Warning  | Security       | Incoming payloads should be validated     |
+| LOG-001  | Structured Logging     | Info     | Logging        | Recommend JSON logger format              |
+| LOG-004  | Sensitive Data Logging | Error    | Logging        | Detect PII/secrets in log statements      |
+| ERR-001  | Try Scope              | Info     | Error Handling | Complex operations should use Try scope   |
+| PERF-002 | Connection Pooling     | Warning  | Performance    | DB/HTTP should configure connection pools |
 
 ### Operations & Resilience Rules
 
-| ID | Name | Severity | Category | Description |
-|----|------|----------|----------|-------------|
-| RES-001 | Reconnection Strategy | Warning | Performance | Connectors should have reconnection strategies |
-| OPS-001 | Auto-Discovery | Info | Standards | APIs should have auto-discovery for API Manager |
-| OPS-002 | HTTP Port Placeholder | Warning | Standards | HTTP ports should use property placeholders |
-| OPS-003 | Externalized Cron | Warning | Standards | Cron expressions should use placeholders |
-| SEC-006 | Encryption Key in Logs | Error | Security | Detect sensitive data in log messages |
-| HYG-001 | Excessive Loggers | Warning | Logging | Flows should not have too many loggers |
-| HYG-002 | Commented Code | Info | Standards | Detect commented-out code blocks |
-| HYG-003 | Unused Flow | Warning | Standards | Detect flows/sub-flows never referenced |
-| API-005 | APIKit Validation | Info | Standards | APIs should use APIKit for interfaces |
-| DOC-001 | Display Name | Info | Documentation | Key components should have meaningful names |
+| ID      | Name                   | Severity | Category      | Description                                     |
+| ------- | ---------------------- | -------- | ------------- | ----------------------------------------------- |
+| RES-001 | Reconnection Strategy  | Warning  | Performance   | Connectors should have reconnection strategies  |
+| OPS-001 | Auto-Discovery         | Info     | Standards     | APIs should have auto-discovery for API Manager |
+| OPS-002 | HTTP Port Placeholder  | Warning  | Standards     | HTTP ports should use property placeholders     |
+| OPS-003 | Externalized Cron      | Warning  | Standards     | Cron expressions should use placeholders        |
+| SEC-006 | Encryption Key in Logs | Error    | Security      | Detect sensitive data in log messages           |
+| HYG-001 | Excessive Loggers      | Warning  | Logging       | Flows should not have too many loggers          |
+| HYG-002 | Commented Code         | Info     | Standards     | Detect commented-out code blocks                |
+| HYG-003 | Unused Flow            | Warning  | Standards     | Detect flows/sub-flows never referenced         |
+| API-005 | APIKit Validation      | Info     | Standards     | APIs should use APIKit for interfaces           |
+| DOC-001 | Display Name           | Info     | Documentation | Key components should have meaningful names     |
 
 ### Project Governance Rules
-| ID | Name | Severity | Category | Description |
-|----|------|----------|----------|-------------|
-| PROJ-001 | POM Validation | Error | Structure | Validates pom.xml existence and plugins |
-| PROJ-002 | Git Hygiene | Warning | Structure | Validates .gitignore existence and entries |
+
+| ID       | Name           | Severity | Category  | Description                                |
+| -------- | -------------- | -------- | --------- | ------------------------------------------ |
+| PROJ-001 | POM Validation | Error    | Structure | Validates pom.xml existence and plugins    |
+| PROJ-002 | Git Hygiene    | Warning  | Structure | Validates .gitignore existence and entries |
 
 **Total: 56 rules** across 14 categories.
 
 See [Rules Catalog](docs/best-practices/rules-catalog.md) for detailed documentation.
 
-
-
 ---
 
 ## Output Formats
@@ -466,7 +468,7 @@ Create a `.mulelintrc.json` file in your project root:
 {
   "rules": {
     "MULE-001": { "enabled": true },
-    "MULE-002": { 
+    "MULE-002": {
       "enabled": true,
       "options": {
         "flowSuffix": "-flow",
@@ -474,7 +476,7 @@ Create a `.mulelintrc.json` file in your project root:
         "excludePatterns": ["*-api-main"]
       }
     },
-    "MULE-006": { 
+    "MULE-006": {
       "enabled": true,
       "severity": "error",
       "options": {
@@ -499,10 +501,10 @@ import { LintEngine, ALL_RULES, formatSarif } from '@sfdxy/mule-lint';
 
 // Create engine with all rules
 const engine = new LintEngine({
-    rules: ALL_RULES,
-    config: {
-        include: ['src/main/mule/**/*.xml'],
-    },
+  rules: ALL_RULES,
+  config: {
+    include: ['src/main/mule/**/*.xml'],
+  },
 });
 
 // Scan a project
@@ -520,6 +522,7 @@ const issues = engine.scanContent(xmlContent, 'file.xml');
 This tool exposes a **Model Context Protocol (MCP)** server, allowing AI agents (like Claude Desktop, IDE assistants) to directly interact with the linter to discover rules, scan projects, and explain violations.
 
 ### Features
+
 - **Tools**: `run_lint_analysis` (scan project), `get_rule_details` (explain rule), `validate_snippet` (check XML/DWL).
 - **Resources**: `mule-lint://rules` (list all available rules), `mule-lint://docs/{slug}` (best practices documentation).
 - **Prompts**: `analyze-project`, `explain-rule`, `fix-issue`.
@@ -568,17 +571,17 @@ See [Extending Guide](docs/linter/extending.md) for detailed instructions on cre
 import { BaseRule, ValidationContext, Issue } from '@sfdxy/mule-lint';
 
 export class MyCustomRule extends BaseRule {
-    id = 'CUSTOM-001';
-    name = 'My Custom Rule';
-    description = 'Enforces my organization standards';
-    severity = 'warning' as const;
-    category = 'standards' as const;
-
-    validate(doc: Document, context: ValidationContext): Issue[] {
-        // Your validation logic using XPath
-        const flows = this.select('//mule:flow', doc);
-        // ...
-    }
+  id = 'CUSTOM-001';
+  name = 'My Custom Rule';
+  description = 'Enforces my organization standards';
+  severity = 'warning' as const;
+  category = 'standards' as const;
+
+  validate(doc: Document, context: ValidationContext): Issue[] {
+    // Your validation logic using XPath
+    const flows = this.select('//mule:flow', doc);
+    // ...
+  }
 }
 ```
 
@@ -591,6 +594,7 @@ This project is inspired by and builds upon the ideas from:
 - **[mule-lint/mule-lint](https://github.com/mule-lint/mule-lint)** - The original Groovy-based MuleSoft linting tool with DSL-based rule definitions
 
 While the original project uses Groovy and a custom DSL, this TypeScript implementation was created to:
+
 - Enable easier VS Code extension integration
 - Provide better AI agent compatibility via SARIF output
 - Leverage the modern npm ecosystem
@@ -600,13 +604,13 @@ While the original project uses Groovy and a custom DSL, this TypeScript impleme
 
 ## Documentation
 
-| Document | Description |
-|----------|-------------|
-| [Architecture](docs/linter/architecture.md) | System design and data flow |
-| [Rules Catalog](docs/best-practices/rules-catalog.md) | Complete list of all rules |
+| Document                                                         | Description                     |
+| ---------------------------------------------------------------- | ------------------------------- |
+| [Architecture](docs/linter/architecture.md)                      | System design and data flow     |
+| [Rules Catalog](docs/best-practices/rules-catalog.md)            | Complete list of all rules      |
 | [Best Practices](docs/best-practices/mulesoft-best-practices.md) | MuleSoft development guidelines |
-| [Extending](docs/linter/extending.md) | How to add custom rules |
-| [Naming Conventions](docs/linter/naming-conventions.md) | Code style guide |
+| [Extending](docs/linter/extending.md)                            | How to add custom rules         |
+| [Naming Conventions](docs/linter/naming-conventions.md)          | Code style guide                |
 
 ---
 
@@ -651,4 +655,4 @@ Contributions are welcome! Please read the [Contributing Guide](CONTRIBUTING.md)
 
 ## License
 
-MIT © 2024
+MIT © 2024

package/dist/bin/mule-lint-mcp.js.map

@@ -1 +1 @@
-{"version":3,"file":"mule-lint-mcp.js","sourceRoot":"","sources":["../../bin/mule-lint-mcp.ts"],"names":[],"mappings":";;;AACA,oCAA+C;AAE/C,KAAK,UAAU,IAAI;IACf,MAAM,MAAM,GAAG,IAAI,uBAAiB,EAAE,CAAC;IACvC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;AACzB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;IACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"mule-lint-mcp.js","sourceRoot":"","sources":["../../bin/mule-lint-mcp.ts"],"names":[],"mappings":";;;AACA,oCAA+C;AAE/C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,IAAI,uBAAiB,EAAE,CAAC;IACvC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;AACvB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;IACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/bin/mule-lint.js

@@ -118,7 +118,7 @@ async function runLint(targetPath, options) {
     // Filter rules based on keys (experimental is opt-in)
     const effectiveRules = options.experimental
         ? rules_1.ALL_RULES
-        : rules_1.ALL_RULES.filter(rule => rule.category !== 'experimental');
+        : rules_1.ALL_RULES.filter((rule) => rule.category !== 'experimental');
     if (options.verbose) {
         console.log(`Loaded ${effectiveRules.length} rules (Experimental: ${options.experimental ? 'ON' : 'OFF'})`);
     }
@@ -133,7 +133,7 @@ async function runLint(targetPath, options) {
     // Filter if quiet mode
     if (options.quiet) {
         for (const file of report.files) {
-            file.issues = file.issues.filter(issue => issue.severity === 'error');
+            file.issues = file.issues.filter((issue) => issue.severity === 'error');
         }
         report.summary.bySeverity.warning = 0;
         report.summary.bySeverity.info = 0;

package/dist/bin/mule-lint.js.map

@@ -1 +1 @@
-{"version":3,"file":"mule-lint.js","sourceRoot":"","sources":["../../bin/mule-lint.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mule-lint.js","sourceRoot":"","sources":["../../bin/mule-lint.ts"],"names":[],"mappings":"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"}

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@sfdxy/mule-lint",
-    "version": "1.18.1",
+    "version": "1.19.0",
     "description": "Static analysis tool for MuleSoft applications - supports humans, AI agents, and CI/CD pipelines",
     "author": "Avinava",
     "license": "MIT",
@@ -28,15 +28,22 @@
     "scripts": {
         "build": "tsc",
         "build:watch": "tsc --watch",
-        "test": "NODE_OPTIONS='--experimental-vm-modules' jest",
-        "test:watch": "NODE_OPTIONS='--experimental-vm-modules' jest --watch",
-        "test:coverage": "NODE_OPTIONS='--experimental-vm-modules' jest --coverage",
-        "lint": "eslint src/ --ext .ts",
-        "lint:fix": "eslint src/ --ext .ts --fix",
+        "typecheck": "tsc --noEmit",
+        "test": "vitest run",
+        "test:watch": "vitest watch",
+        "test:coverage": "vitest run --coverage",
+        "lint": "eslint 'src/**/*.ts'",
+        "lint:unused": "knip",
         "format": "prettier --write \"src/**/*.{ts,js,json,md}\"",
+        "prettier:check": "prettier --check '**/*.{ts,js,json,md,yml}'",
+        "prettier:fix": "prettier --write '**/*.{ts,js,json,md,yml}'",
         "clean": "rm -rf dist",
         "prepublishOnly": "npm run clean && npm run build && npm test",
-        "release": "git tag v$(node -p 'require(\"./package.json\").version') && git push origin v$(node -p 'require(\"./package.json\").version')"
+        "release": "git tag v$(node -p 'require(\"./package.json\").version') && git push origin v$(node -p 'require(\"./package.json\").version')",
+        "prepare": "lefthook install"
+    },
+    "lint-staged": {
+        "*.{ts,tsx,js,jsx,mjs,cjs,json,md,css,html,yml,yaml}": "prettier --write"
     },
     "dependencies": {
         "@modelcontextprotocol/sdk": "^1.25.2",
@@ -51,18 +58,22 @@
         "zod": "^3.25.0"
     },
     "devDependencies": {
-        "@types/jest": "^29.5.11",
+        "@commitlint/cli": "^19.0.0",
+        "@commitlint/config-conventional": "^19.0.0",
         "@types/js-yaml": "^4.0.9",
         "@types/node": "^20.19.27",
-        "@typescript-eslint/eslint-plugin": "^6.15.0",
-        "@typescript-eslint/parser": "^6.15.0",
-        "eslint": "^8.56.0",
-        "jest": "^29.7.0",
-        "ts-jest": "^29.1.1",
-        "typescript": "^5.3.3"
+        "eslint": "^9.0.0",
+        "eslint-config-prettier": "^10.0.0",
+        "knip": "^5.0.0",
+        "lefthook": "^1.10.0",
+        "lint-staged": "^15.0.0",
+        "publint": "^0.3.0",
+        "typescript": "^5.7.0",
+        "typescript-eslint": "^8.0.0",
+        "vitest": "^3.0.0"
     },
     "engines": {
-        "node": ">=18.0.0"
+        "node": ">=20.0.0"
     },
     "repository": {
         "type": "git",