eventlint

EventLint -- Event & Message Queue Anti-Pattern Analyzer

EventLint scans codebases for event-driven architecture anti-patterns, producer/consumer issues, schema validation gaps, dead letter queue misconfigurations, ordering and delivery failures, and observability gaps across Kafka, RabbitMQ, SQS, NATS, and Redis Pub/Sub. It uses regex-based pattern matching against 90 event-specific patterns across 6 categories, lefthook for git hook integration, and produces markdown reports with actionable remediation guidance. 100% local. Zero telemetry.

Commands

Free Tier (No license required)

#### eventlint scan [file|directory] One-shot event architecture quality scan of files or directories.

How to execute:

bash "/scripts/dispatcher.sh" --path [target]

What it does: 1. Accepts a file path or directory (defaults to current directory) 2. Discovers all source files (skips .git, node_modules, binaries, images, .min.js) 3. Runs 30 event architecture patterns against each file (free tier limit) 4. Calculates an event architecture quality score (0-100) per file and overall 5. Grades: A (90-100), B (80-89), C (70-79), D (60-69), F (<60) 6. Outputs findings with: file, line number, check ID, severity, description, recommendation 7. Exit code 0 if score >= 70, exit code 1 if event quality is poor 8. Free tier limited to first 30 patterns (PP + CP categories)

Example usage scenarios:

Pro Tier ($19/user/month -- requires EVENTLINT_LICENSE_KEY)

#### eventlint scan --tier pro [file|directory] Extended scan with 60 patterns covering producer, consumer, schema, and dead letter patterns.

How to execute:

bash "/scripts/dispatcher.sh" --path [target] --tier pro

What it does: 1. Validates Pro+ license 2. Runs 60 event architecture patterns (PP, CP, MS, ED categories) 3. Detects schema validation gaps and breaking changes 4. Identifies dead letter queue misconfigurations 5. Full category breakdown reporting

#### eventlint scan --format json [directory] Generate JSON output for CI/CD integration.

bash "/scripts/dispatcher.sh" --path [directory] --format json

#### eventlint scan --format html [directory] Generate HTML report for browser viewing.

bash "/scripts/dispatcher.sh" --path [directory] --format html

#### eventlint scan --category ED [directory] Filter scan to a specific check category (PP, CP, MS, ED, OD, EO).

bash "/scripts/dispatcher.sh" --path [directory] --category ED

Team Tier ($39/user/month -- requires EVENTLINT_LICENSE_KEY with team tier)

#### eventlint scan --tier team [directory] Full scan with all 90 patterns across all 6 categories including ordering/delivery and observability.

How to execute:

bash "/scripts/dispatcher.sh" --path [directory] --tier team

What it does: 1. Validates Team+ license 2. Runs all 90 patterns across 6 categories 3. Includes ordering & delivery detection (dual-write, missing outbox, race conditions) 4. Includes event observability checks (no tracing, missing metrics, no audit trail) 5. Full category breakdown with per-file results

#### eventlint scan --verbose [directory] Verbose output showing every matched line and pattern details.

bash "/scripts/dispatcher.sh" --path [directory] --verbose

#### eventlint status Show license and configuration information.

bash "/scripts/dispatcher.sh" status

Check Categories

EventLint detects 90 event architecture anti-patterns across 6 categories:

| Category | Code | Patterns | Description | Severity Range | |----------|------|----------|-------------|----------------| | Producer Patterns | PP | 15 | Fire-and-forget publish, missing keys, no schema validation, acks=0 | medium -- critical | | Consumer Patterns | CP | 15 | No idempotency, auto-ack, unbounded prefetch, blocking handlers | low -- critical | | Message Schema | MS | 15 | No schema registry, unversioned, breaking changes, loose typing | low -- critical | | Error & Dead Letter | ED | 15 | Missing DLQ, infinite redelivery, swallowed exceptions, no poison handling | low -- critical | | Ordering & Delivery | OD | 15 | Dual-write, no outbox, missing dedup, saga without timeout | low -- critical | | Event Observability | EO | 15 | No tracing, missing metrics, no audit trail, no alerting | low -- medium |

Tier-Based Pattern Access

| Tier | Patterns | Categories | |------|----------|------------| | Free | 30 | PP, CP | | Pro | 60 | PP, CP, MS, ED | | Team | 90 | PP, CP, MS, ED, OD, EO | | Enterprise | 90 | PP, CP, MS, ED, OD, EO + priority support |

Scoring

EventLint uses a deductive scoring system starting at 100 (perfect):

| Severity | Point Deduction | Description | |----------|-----------------|-------------| | Critical | -25 per finding | Severe reliability issue (message loss, infinite redelivery, dual-write) | | High | -15 per finding | Significant event problem (missing DLQ, auto-ack, no idempotency) | | Medium | -8 per finding | Moderate concern (missing correlation ID, unversioned schema) | | Low | -3 per finding | Informational / best practice suggestion |

Grading Scale

| Grade | Score Range | Meaning | |-------|-------------|---------| | A | 90-100 | Excellent event architecture quality | | B | 80-89 | Good architecture with minor issues | | C | 70-79 | Acceptable but needs improvement | | D | 60-69 | Poor event architecture quality | | F | Below 60 | Critical event architecture problems |

Configuration

Users can configure EventLint in ~/.openclaw/openclaw.json:

{
  "skills": {
    "entries": {
      "eventlint": {
        "enabled": true,
        "apiKey": "YOUR_LICENSE_KEY_HERE",
        "config": {
          "severityThreshold": "medium",
          "ignorePatterns": ["/test/", "/fixtures/", "**/*.test.*"],
          "ignoreChecks": [],
          "reportFormat": "text"
        }
      }
    }
  }
}

Important Notes

Error Handling

When to Use EventLint

The user might say things like:

Users can configure EventLint in ~/.openclaw/openclaw.json:

{
  "skills": {
    "entries": {
      "eventlint": {
        "enabled": true,
        "apiKey": "YOUR_LICENSE_KEY_HERE",
        "config": {
          "severityThreshold": "medium",
          "ignorePatterns": ["/test/", "/fixtures/", "**/*.test.*"],
          "ignoreChecks": [],
          "reportFormat": "text"
        }
      }
    }
  }
}