Overview
ESLint rules for reducing cognitive load and ensuring code readability
Live from GitHub
This content is fetched directly from README.md on GitHub and cached for 1 hour.
Readable Code
Reduce cognitive load and improve code readability with consistent patterns.
Maintainability rules — complexity ceilings, dead code, and readability guardrails.
⭐ If this plugin caught a real bug for you, star the repo — it's the signal that keeps these rules maintained.
Description
This plugin provides Maintainability rules — complexity ceilings, dead code, and readability guardrails.
Philosophy
Interlace fosters strength through integration. Instead of stacking isolated rules, we interlace security directly into your workflow to create a resilient fabric of code. We believe tools should guide rather than gatekeep, providing educational feedback that strengthens the developer with every interaction.
Why these rules are quiet
Noise creates apathy, and apathy is not a security posture. A linter that reports a thousand things a week gets switched off in a month, and the real finding goes with it. So every rule here is built to be worth reading: we would rather miss a finding than spend your attention on one that was never real.
That is a trade, and it is made deliberately. It costs recall, and we measure what it costs rather than assuming it is free.
How the rules decide
Evidence, not names. A rule fires on what the code does, resolved through the
AST and ESLint's own scope analysis — not on an identifier that happens to contain
query, a method called setItem, or a file whose path contains key. Every one of
those was a real false positive in this ecosystem, found by reading our own output on
open-source projects and fixed with a test that fails on the unfixed rule.
Where a rule has known false-positive shapes, its page carries a Not a finding section: what it deliberately stays quiet on, and what to check first when it fires and you disagree.
What you get
The rules below. Security rules carry a CWE mapping and, where one is assigned, a
CVSS score; every rule carries a fix on its message — in prose for a human and as
structured JSON for an agent. Install it, enable
recommended, and read the findings. If one of them is wrong,
open an issue — a false positive is a
bug here, not a tuning exercise for you.
How that is measured, on which projects, and where it falls short: benchmark methodology and results.
Getting Started
- To check out the guide, visit eslint.interlace.tools. 📚
- 要查看中文 指南, 请访问 eslint.interlace.tools. 📚
- 가이드 문서는 eslint.interlace.tools에서 확인하실 수 있습니다. 📚
- ガイドは eslint.interlace.toolsでご確認ください。 📚
- Para ver la guía, visita eslint.interlace.tools. 📚
- للاطلاع على الدليل، قم بزيارة eslint.interlace.tools. 📚
npm install eslint-plugin-maintainability --save-dev⚙️ Configuration Presets
| Preset | Description |
|---|---|
recommended | Recommended code quality rules as warnings |
📦 Compatibility
| Package | Version |
|---|---|
| ESLint | ^8.40.0 || ^9.0.0 || ^10.0.0 |
| Node.js | >=18.0.0 |
See the ESLint Version Support Policy — current ecosystem share data, the 20% gate, and the forward-looking exception that covers v10.
Rules
Legend
| Icon | Description |
|---|---|
| 💼 | Recommended: Included in the recommended preset. |
| ⚠️ | Warns: Set to warn in recommended preset. |
| 🔧 | Auto-fixable: Automatically fixable by the --fix CLI option. |
| 💡 | Suggestions: Providing code suggestions in IDE. |
| 🚫 | Deprecated: This rule is deprecated. |
| 🟢 | Type-unaware: AST-only, runs in oxlint JS-plugin tier. |
| 🟡 | Type-aware (refining): pure-AST primary path; types refine precision. |
| 🟠 | Type-aware (graceful): requires TS program; silent without it. |
| Rule | CWE | OWASP | CVSS | Description | 🧠 | 💼 | ⚠️ | 🔧 | 💡 | 🚫 |
|---|---|---|---|---|---|---|---|---|---|---|
| cognitive-complexity | Enforces a maximum cognitive complexity threshold with refactoring guidance | 🟢 | ⚠️ | 💡 | ||||||
| consistent-function-scoping | Move functions to the highest possible scope | 🟢 | 💡 | |||||||
| error-message | Enforce providing a message when creating built-in Error objects for better debugging | 🟢 | 💡 | |||||||
| identical-functions | CWE-1104 | Detects duplicate function implementations with DRY refactoring suggestions | 🟢 | ⚠️ | 💡 | |||||
| max-parameters | ESLint Rule: max-parameters with LLM-optimized suggestions and auto-fix capabilities. | 🟢 | ⚠️ | 💡 | ||||||
| nested-complexity-hotspots | ESLint Rule: nested-complexity-hotspots with LLM-optimized suggestions and auto-fix capabilities. | 🟢 | 💡 | |||||||
| no-lonely-if | Disallow if statements as the only statement in else blocks | 🟢 | 💡 | |||||||
| no-missing-error-context | ESLint Rule: no-missing-error-context with LLM-optimized suggestions and auto-fix capabilities. | 🟢 | 💡 | |||||||
| no-nested-ternary | Prevent nested ternary expressions for better readability | 🟢 | 💡 | |||||||
| no-silent-errors | ESLint Rule: no-silent-errors with LLM-optimized suggestions and auto-fix capabilities. | 🟢 | 💡 | |||||||
| no-unhandled-promise | CWE-1024 | Disallow unhandled Promise rejections with LLM-optimized suggestions for proper async error handling | 🟢 | 💡 | ||||||
| no-unreadable-iife | Disallow unreadable IIFE (Immediately Invoked Function Expression) patterns | 🟢 | 💡 |
🔗 Related ESLint Plugins
Part of the Interlace ESLint Ecosystem — AI-native security plugins with LLM-optimized error messages:
| Plugin | Downloads | Description |
|---|---|---|
eslint-plugin-secure-coding | General security rules & OWASP guidelines. | |
eslint-plugin-pg | PostgreSQL security & best practices. | |
eslint-plugin-node-security | Node.js core-module security (fs, child_process, vm, crypto, Buffer). | |
eslint-plugin-jwt | JWT security & best practices. | |
eslint-plugin-browser-security | Browser-specific security & XSS prevention. | |
eslint-plugin-express-security | Express.js security hardening rules. | |
eslint-plugin-lambda-security | AWS Lambda security best practices. | |
eslint-plugin-nestjs-security | NestJS security rules & patterns. | |
eslint-plugin-mongodb-security | MongoDB security best practices. | |
eslint-plugin-vercel-ai-security | Vercel AI SDK security hardening. | |
eslint-plugin-import-next | Next-gen import sorting & architecture. |
⭐ Support & follow
If this plugin caught a real bug for you, star the repo — stars are the signal that keeps the Interlace ESLint ecosystem maintained — and follow the writeups on Dev.to for the benchmarks and security research behind these rules.
📄 License
MIT © Ofri Peretz
View README.md on GitHub →
Building secure JavaScript with Interlace? Star the repo to get new rules and CWE coverage as we ship them — or follow the AI-code-security benchmarks behind them.
