@sfdxy/mule-lint 1.4.0

package/README.md

@@ -0,0 +1,413 @@
+# Mule-Lint
+
+<p align="center">
+  <strong>Enterprise-grade static analysis tool for MuleSoft applications</strong>
+</p>
+
+<p align="center">
+  <a href="#installation">Installation</a> •
+  <a href="#quick-start">Quick Start</a> •
+  <a href="#rules">Rules</a> •
+  <a href="#output-formats">Output</a> •
+  <a href="#configuration">Configuration</a> •
+  <a href="#extending">Extending</a>
+</p>
+
+---
+
+## Overview
+
+**Mule-Lint** is a TypeScript-based linting tool designed to enforce best practices and standards for MuleSoft applications. It provides:
+
+- ✅ **10+ Built-in Rules** covering error handling, naming conventions, security, and logging
+- ✅ **Multiple Output Formats** - Table (human), JSON (scripts), SARIF (AI agents/VS Code)
+- ✅ **CI/CD Ready** - Exit codes and machine-readable output
+- ✅ **TypeScript** - Fully typed for VS Code extension integration
+- ✅ **Extensible** - Add custom rules for your organization
+
+### Architecture
+
+```mermaid
+flowchart TB
+    subgraph CLI["CLI Layer"]
+        A[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]
+        K[SARIF]
+    end
+    
+    A --> B
+    D --> I
+    D --> J
+    D --> K
+```
+
+### Data Flow
+
+```mermaid
+flowchart LR
+    A["XML Files"] --> B["Parse DOM"]
+    B --> C["Execute Rules"]
+    C --> D["Collect Issues"]
+    D --> E["Format Output"]
+    E --> F["Table / JSON / SARIF"]
+```
+
+
+---
+
+## Installation
+
+```bash
+# Global installation
+npm install -g mule-lint
+
+# Or as a dev dependency
+npm install --save-dev mule-lint
+```
+
+---
+
+## Quick Start
+
+```bash
+# Scan a directory
+mule-lint ./src/main/mule
+
+# Scan a single file
+mule-lint ./src/main/mule/implementation.xml
+
+# Output as JSON
+mule-lint ./src/main/mule -f json
+
+# Output as SARIF (for AI agents/VS Code)
+mule-lint ./src/main/mule -f sarif > report.sarif
+
+# Write to file
+mule-lint ./src/main/mule -o report.txt
+
+# Fail on warnings (for CI/CD)
+mule-lint ./src/main/mule --fail-on-warning
+```
+
+### CLI Options
+
+| Option | Description |
+|--------|-------------|
+| `-f, --format <type>` | Output format: `table`, `json`, `sarif` (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)** |
+| `--fail-on-warning` | Exit with error code if warnings found |
+| `-v, --verbose` | Show verbose output |
+
+### Examples
+
+```bash
+# Basic scan
+mule-lint .
+
+# Scan with experimental rules
+mule-lint . --experimental
+
+# Output SARIF for VS Code
+mule-lint src/main/mule -f sarif -o results.sarif
+```
+
+---
+
+## Rules
+
+### 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 |
+
+### 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 |
+
+### 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 |
+| 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 |
+
+### 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 | Encrypted secrets |
+
+**Total: 41 rules** across 13 categories.
+
+See [Rules Catalog](docs/rules-catalog.md) for detailed documentation.
+
+
+
+---
+
+## Output Formats
+
+### Table (Default)
+
+Human-readable colorized output:
+
+```
+Mule-Lint Report
+Scanned 5 files in 123ms
+
+src/main/mule/impl.xml
+  45:0 error   Flow "getOrders" is missing an error handler (MULE-003)
+  67:0 warning Logger is missing 'category' attribute (MULE-006)
+
+Summary:
+  Errors:     1
+  Warnings:   1
+  Infos:      0
+```
+
+### JSON
+
+Machine-readable for scripting:
+
+```json
+[
+  {
+    "filePath": "/path/to/impl.xml",
+    "line": 45,
+    "message": "Flow \"getOrders\" is missing an error handler",
+    "ruleId": "MULE-003",
+    "severity": "error"
+  }
+]
+```
+
+### SARIF (For AI Agents)
+
+[SARIF 2.1.0](https://sarifweb.azurewebsites.net/) format for VS Code, GitHub, and AI agents:
+
+```json
+{
+  "$schema": "https://json.schemastore.org/sarif-2.1.0.json",
+  "version": "2.1.0",
+  "runs": [{
+    "tool": {
+      "driver": {
+        "name": "mule-lint",
+        "version": "1.0.0"
+      }
+    },
+    "results": [...]
+  }]
+}
+```
+
+---
+
+## Configuration
+
+Create a `.mulelintrc.json` file in your project root:
+
+```json
+{
+  "rules": {
+    "MULE-001": { "enabled": true },
+    "MULE-002": { 
+      "enabled": true,
+      "options": {
+        "flowSuffix": "-flow",
+        "subflowSuffix": "-subflow",
+        "excludePatterns": ["*-api-main"]
+      }
+    },
+    "MULE-006": { 
+      "enabled": true,
+      "severity": "error",
+      "options": {
+        "requiredPrefix": "com.myorg"
+      }
+    }
+  },
+  "include": ["src/main/mule/**/*.xml"],
+  "exclude": ["**/test/**", "**/*.munit.xml"],
+  "failOnWarning": false
+}
+```
+
+---
+
+## Using as a Library
+
+Import directly into your TypeScript/JavaScript projects:
+
+```typescript
+import { LintEngine, ALL_RULES, formatSarif } from 'mule-lint';
+
+// Create engine with all rules
+const engine = new LintEngine({
+    rules: ALL_RULES,
+    config: {
+        include: ['src/main/mule/**/*.xml'],
+    },
+});
+
+// Scan a project
+const report = await engine.scan('./my-mule-project');
+console.log(formatSarif(report));
+
+// Scan content directly (useful for VS Code extensions)
+const issues = engine.scanContent(xmlContent, 'file.xml');
+```
+
+---
+
+## Extending
+
+### Adding Custom Rules
+
+See [Extending Guide](docs/extending.md) for detailed instructions on creating custom rules.
+
+```typescript
+import { BaseRule, ValidationContext, Issue } from '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);
+        // ...
+    }
+}
+```
+
+---
+
+## Project Inspiration
+
+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
+- Offer simpler CI/CD integration
+
+---
+
+## Documentation
+
+| Document | Description |
+|----------|-------------|
+| [Architecture](docs/architecture.md) | System design and data flow |
+| [Rules Catalog](docs/rules-catalog.md) | Complete list of all rules |
+| [Extending](docs/extending.md) | How to add custom rules |
+| [Naming Conventions](docs/naming-conventions.md) | Code style guide |
+
+---
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run tests
+npm test
+
+# Lint
+npm run lint
+```
+
+---
+
+## Credits
+
+<table>
+  <tr>
+    <td align="center">
+      <strong>Built with AI Assistance</strong><br>
+      This project was developed with the assistance of:<br><br>
+      🚀 <strong>Antigravity</strong> (Google DeepMind)<br>
+      🤖 <strong>GitHub Copilot</strong>
+    </td>
+  </tr>
+</table>
+
+---
+
+## Contributing
+
+Contributions are welcome! Please read the [Contributing Guide](CONTRIBUTING.md) for details.
+
+---
+
+## License
+
+MIT © 2024

package/dist/bin/mule-lint.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=mule-lint.d.ts.map

package/dist/bin/mule-lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mule-lint.d.ts","sourceRoot":"","sources":["../../bin/mule-lint.ts"],"names":[],"mappings":""}

package/dist/bin/mule-lint.js

@@ -0,0 +1,123 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const LintEngine_1 = require("../src/engine/LintEngine");
+const rules_1 = require("../src/rules");
+const formatters_1 = require("../src/formatters");
+const program = new commander_1.Command();
+program
+    .name('mule-lint')
+    .description('Static analysis tool for MuleSoft applications')
+    .version('1.0.0')
+    .argument('<path>', 'Path to scan (directory or file)')
+    .option('-f, --format <type>', 'Output format: table, json, sarif', 'table')
+    .option('-o, --output <file>', 'Write output to file instead of stdout')
+    .option('-c, --config <file>', 'Path to configuration file')
+    .option('-q, --quiet', 'Show only errors (suppress warnings and info)')
+    .option('--fail-on-warning', 'Exit with error code if warnings found')
+    .option('-e, --experimental', 'Enable experimental rules (opt-in)')
+    .option('-v, --verbose', 'Show verbose output')
+    .action(async (targetPath, options) => {
+    try {
+        await runLint(targetPath, options);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`Error: ${message}`);
+        process.exit(2);
+    }
+});
+async function runLint(targetPath, options) {
+    const absolutePath = path.resolve(targetPath);
+    // Validate path exists
+    if (!fs.existsSync(absolutePath)) {
+        throw new Error(`Path does not exist: ${absolutePath}`);
+    }
+    // Load configuration if specified
+    let config = {};
+    if (options.config) {
+        const configPath = path.resolve(options.config);
+        if (!fs.existsSync(configPath)) {
+            throw new Error(`Config file not found: ${configPath}`);
+        }
+        const configContent = fs.readFileSync(configPath, 'utf-8');
+        config = JSON.parse(configContent);
+    }
+    // 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');
+    if (options.verbose) {
+        console.log(`Loaded ${effectiveRules.length} rules (Experimental: ${options.experimental ? 'ON' : 'OFF'})`);
+    }
+    // Create engine
+    const engine = new LintEngine_1.LintEngine({
+        rules: effectiveRules,
+        config,
+        verbose: options.verbose,
+    });
+    // Run scan
+    const report = await engine.scan(absolutePath);
+    // Filter if quiet mode
+    if (options.quiet) {
+        for (const file of report.files) {
+            file.issues = file.issues.filter(issue => issue.severity === 'error');
+        }
+        report.summary.bySeverity.warning = 0;
+        report.summary.bySeverity.info = 0;
+    }
+    // Format output
+    const formatterType = options.format;
+    const output = (0, formatters_1.format)(report, formatterType);
+    // Write output
+    if (options.output) {
+        const outputPath = path.resolve(options.output);
+        fs.writeFileSync(outputPath, output, 'utf-8');
+        console.log(`Report written to: ${outputPath}`);
+    }
+    else {
+        console.log(output);
+    }
+    // Exit code
+    const exitCode = (0, formatters_1.getExitCode)(report, options.failOnWarning);
+    process.exit(exitCode);
+}
+// Run the CLI
+program.parse();
+//# sourceMappingURL=mule-lint.js.map

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

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

package/dist/src/core/ComplexityCalculator.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Calculates cyclomatic complexity for Mule flows
+ *
+ * Complexity = 1 + (number of decision points)
+ *
+ * Decision points in Mule XML:
+ * - <choice> with N <when> clauses = N decision points
+ * - <until-successful> = 1 decision point
+ * - <foreach> = 1 decision point
+ * - <scatter-gather> = 1 decision point (parallel execution)
+ * - <try> = 1 decision point
+ */
+export declare class ComplexityCalculator {
+    /**
+     * Calculate cyclomatic complexity for a flow element
+     */
+    static calculateFlowComplexity(flowNode: Node): ComplexityResult;
+    /**
+     * Get complexity rating
+     */
+    static getRating(complexity: number): ComplexityRating;
+    /**
+     * Helper to select nodes using XPath with Mule namespace
+     */
+    private static selectNodes;
+    /**
+     * Get the line number for a node
+     */
+    static getNodeLine(node: Node): number;
+}
+export interface ComplexityResult {
+    complexity: number;
+    details: ComplexityDetail[];
+    rating: ComplexityRating;
+}
+export interface ComplexityDetail {
+    type: string;
+    count: number;
+    contribution: number;
+}
+export type ComplexityRating = 'low' | 'moderate' | 'high';
+//# sourceMappingURL=ComplexityCalculator.d.ts.map

package/dist/src/core/ComplexityCalculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComplexityCalculator.d.ts","sourceRoot":"","sources":["../../../src/core/ComplexityCalculator.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,qBAAa,oBAAoB;IAC7B;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAAC,QAAQ,EAAE,IAAI,GAAG,gBAAgB;IA6EhE;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB;IAMtD;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;IAa1B;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM;CAGzC;AAED,MAAM,WAAW,gBAAgB;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,MAAM,EAAE,gBAAgB,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,UAAU,GAAG,MAAM,CAAC"}