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.
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.0.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 →
