@autofleet/lint 1.0.0

package/README.md

@@ -0,0 +1,273 @@
+# @autofleet/lint
+
+**Rust-powered, ultra-fast linting and formatting for Autofleet projects** using [Oxlint v1.43.0](https://oxc.rs/) and [Oxfmt v0.28.0](https://oxc.rs/docs/guide/usage/formatter).
+
+## 🚀 Why Oxlint + Oxfmt?
+
+- **37x faster** than ESLint (~1-2 seconds vs 60+ seconds)
+- **30x faster** than Prettier (~0.5 seconds vs 15+ seconds)
+- **100% Prettier conformance** - Oxfmt now has 100% compatibility with Prettier output
+- **80% reduction** in CI lint+format time
+- **Type-safe config** - TypeScript config files with full autocomplete (since v1.43.0)
+- **Batteries included** - all dependencies bundled, no peer dependency hell
+- **Single toolchain** - Oxc project maintains all rules consistently
+
+## 📦 Installation
+
+```bash
+npm install --save-dev @autofleet/lint
+```
+
+## 🔧 Usage
+
+### NPM Scripts
+
+Add these to your `package.json`:
+
+```json
+{
+  "scripts": {
+    "lint": "autofleet-lint",
+    "lint:fix": "autofleet-lint --fix",
+    "lint:fix-all": "autofleet-lint --fix-suggestions --fix-dangerously",
+    "format": "autofleet-fmt",
+    "format:check": "autofleet-fmt --check"
+  }
+}
+```
+
+### CLI Commands
+
+```bash
+# Lint with default (src directory)
+npm run lint
+
+# Lint specific files/directories
+autofleet-lint src/lib
+
+# Auto-fix safe issues
+npm run lint:fix
+
+# Auto-fix all issues (including suggestions and dangerous)
+npm run lint:fix-all
+
+# Format code
+npm run format
+
+# Check formatting without modifying files
+npm run format:check
+
+# Format specific files
+autofleet-fmt src/utils/**/*.ts
+```
+
+## 📋 Configuration
+
+### Oxlint Configuration
+
+✅ **Oxlint supports `extends`** - Create an `.oxlintrc.json` in your project root:
+
+```json
+{
+  "extends": ["./node_modules/@autofleet/lint/.oxlintrc.json"]
+}
+```
+
+**Override rules** for your specific project:
+
+```json
+{
+  "extends": ["./node_modules/@autofleet/lint/.oxlintrc.json"],
+  "rules": {
+    "no-console": "off",
+    "unicorn/no-array-callback-reference": "off"
+  }
+}
+```
+
+**File-specific overrides** using the `overrides` field:
+
+```json
+{
+  "extends": ["./node_modules/@autofleet/lint/.oxlintrc.json"],
+  "overrides": [
+    {
+      "files": ["scripts/**/*.js"],
+      "rules": {
+        "no-console": "off"
+      }
+    },
+    {
+      "files": ["**/*.test.ts"],
+      "rules": {
+        "typescript/no-explicit-any": "off"
+      }
+    }
+  ]
+}
+```
+
+**Note:** TypeScript config (`oxlint.config.ts`) is supported in v1.43.0+ but requires Node.js >= 22.12.0. For Node.js < 22.12.0, use `.oxlintrc.json` with `extends`
+
+### Oxfmt Configuration
+
+⚠️ **Oxfmt does NOT support `extends`** - you must **copy** the configuration file.
+
+```bash
+# Copy from @autofleet/lint to your project
+cp node_modules/@autofleet/lint/.oxfmtrc.json .oxfmtrc.json
+```
+
+Our default settings:
+```json
+{
+  "semi": true,
+  "trailingComma": "all",
+  "singleQuote": true,
+  "printWidth": 120,
+  "tabWidth": 2,
+  "useTabs": false,
+  "arrowParens": "always",
+  "endOfLine": "lf",
+  "ignorePatterns": [
+    "dist",
+    "build",
+    "node_modules",
+    "coverage",
+    "**/migrations/*",
+    "*.min.js",
+    "*.min.css",
+    "package-lock.json",
+    "pnpm-lock.yaml",
+    "yarn.lock"
+  ]
+}
+```
+
+**Note**: Oxfmt also respects `.gitignore` files automatically.
+
+## 🎨 VSCode Integration
+
+Install the Oxc extension:
+```
+ext install oxc.oxc-vscode
+```
+
+Update your `.vscode/settings.json`:
+
+```json
+{
+  "editor.formatOnSave": true,
+  "editor.defaultFormatter": "oxc.oxc-vscode",
+  "[typescript]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[javascript]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[json]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  }
+}
+```
+
+## 🔄 Migrating from ESLint + Prettier
+
+We've migrated **140+ rules** from our previous ESLint setup to Oxlint. See [MIGRATION_GAPS.md](./MIGRATION_GAPS.md) for:
+- Complete list of unsupported rules
+- Workarounds for missing features
+- Impact assessment
+- Benefits analysis
+
+### Key Differences
+
+1. **Import Ordering**: Not auto-sorted by Oxlint
+   - **Workaround**: Use IDE "Organize Imports" (VSCode: Shift+Alt+O)
+
+2. **Naming Conventions**: Not enforced by Oxlint
+   - **Workaround**: Follow conventions manually, enforce in code review
+
+3. **Formatting**: Oxfmt has 95% Prettier compatibility
+   - May produce slightly different output in edge cases
+   - Aiming for 99.99% compatibility in future releases
+
+## 📚 Available Rules
+
+Oxlint includes **665+ built-in rules** from:
+- ✅ ESLint core rules
+- ✅ TypeScript ESLint rules
+- ✅ Unicorn rules (modern JavaScript patterns)
+- ✅ Import rules
+- ✅ Jest rules
+- ✅ OXC custom rules (unique performance & correctness checks)
+
+Our configuration enables **140+ rules** carefully selected for:
+- Code correctness
+- TypeScript best practices
+- Modern JavaScript patterns
+- Performance optimizations
+
+## 🛠️ Auto-Fix Capabilities
+
+Oxlint categorizes fixes into three types:
+
+### Safe Fixes (`--fix`)
+Changes that do NOT alter program behavior:
+- Remove unused variables
+- Fix import ordering
+- Simplify boolean expressions
+
+### Suggestions (`--fix-suggestions`)
+Changes that MAY alter behavior:
+- Convert `var` to `const`/`let`
+- Simplify conditional logic
+- Optimize array methods
+
+### Dangerous Fixes (`--fix-dangerously`)
+Aggressive changes that may break code:
+- Remove unused function parameters
+- Aggressive dead code removal
+
+**Recommendation**: Use `--fix` regularly, use `--fix-suggestions --fix-dangerously` carefully.
+
+## 🔍 Ignore Patterns
+
+Default ignore patterns (configured in `oxlint.config.ts`):
+- `dist/`
+- `build/`
+- `node_modules/`
+- `coverage/`
+- `*.config.js`
+- `**/migrations/*`
+- `**/mock.ts`
+
+To customize, edit `oxlint.config.ts` in your project:
+```typescript
+import type { Linter } from 'oxlint';
+import baseConfig from './node_modules/@autofleet/lint/oxlint.config';
+
+const config: Linter.Config = {
+  ...baseConfig,
+  ignorePatterns: [
+    ...baseConfig.ignorePatterns,
+    'your-custom-ignore-pattern',
+  ],
+};
+
+export default config;
+```
+
+## 📖 Documentation
+
+- [Oxlint Documentation](https://oxc.rs/docs/guide/usage/linter.html)
+- [Oxfmt Documentation](https://oxc.rs/docs/guide/usage/formatter)
+- [Supported Rules](https://oxc.rs/docs/guide/usage/linter/rules)
+- [Migration Gaps](./MIGRATION_GAPS.md)
+
+## 🤝 Contributing
+
+This package is maintained by the Autofleet engineering team. For issues or suggestions, please reach out on Slack or create an issue in the autorepo.
+
+## 📜 License
+
+ISC © Autofleet

package/RULES.md

@@ -0,0 +1,396 @@
+# @autofleet/lint - Complete Rules Documentation
+
+Complete documentation of all linting and formatting rules in `@autofleet/lint` v2.0.0.
+
+## Overview
+
+This package provides a batteries-included linting solution with two Rust-powered tools:
+
+1. **Oxlint v1.43.0** - Ultra-fast linter (37x faster than ESLint) with 665+ rules
+2. **Oxfmt v0.28.0** - Ultra-fast formatter (30x faster than Prettier) with 100% Prettier conformance
+
+---
+
+## Table of Contents
+
+- [Oxlint Rules](#oxlint-rules)
+  - [Core ESLint Rules](#core-eslint-rules)
+  - [TypeScript Rules](#typescript-rules)
+  - [Unicorn Rules (Modern JavaScript)](#unicorn-rules-modern-javascript)
+  - [Import Rules](#import-rules)
+  - [Jest Rules](#jest-rules)
+  - [OXC Custom Rules](#oxc-custom-rules)
+- [Oxfmt Configuration](#oxfmt-configuration)
+- [Rule Severity Levels](#rule-severity-levels)
+
+---
+
+# Oxlint Rules
+
+Oxlint v1.43.0 includes **665 built-in rules** from ESLint, TypeScript ESLint, Unicorn, Import, Jest, React, and custom OXC rules.
+
+Our configuration enables **140+ carefully selected rules** focused on:
+- Code correctness and safety
+- TypeScript best practices
+- Modern JavaScript patterns
+- Performance optimizations
+
+---
+
+## Core ESLint Rules
+
+### Critical Safety Rules (Error Level)
+
+| Rule | Level | Purpose | Auto-Fix |
+|------|-------|---------|----------|
+| `no-console` | error | Prevents console statements in production | ❌ |
+| `no-debugger` | error | Prevents debugger statements | ✅ |
+| `no-var` | error | Enforces `const`/`let` over `var` | ✅ |
+| `prefer-const` | error | Enforces `const` for never-reassigned variables | ✅ |
+| `eqeqeq` | error | Requires `===` and `!==` | ✅ |
+| `curly` | error | Requires curly braces for all control statements | ✅ |
+| `no-async-promise-executor` | error | Prevents async functions as Promise executors | ❌ |
+| `prefer-promise-reject-errors` | error | Requires Error objects for Promise rejections | ❌ |
+| `no-unreachable` | error | Detects unreachable code after return/throw | ❌ |
+| `no-unsafe-negation` | error | Prevents unsafe negation of left operand | ✅ |
+| `no-unsafe-optional-chaining` | error | Prevents unsafe optional chaining usage | ❌ |
+| `use-isnan` | error | Requires isNaN() for NaN checks | ✅ |
+| `valid-typeof` | error | Ensures valid typeof comparisons | ❌ |
+| `no-const-assign` | error | Prevents reassigning const variables | ❌ |
+| `no-dupe-keys` | error | Prevents duplicate keys in object literals | ❌ |
+| `no-import-assign` | error | Prevents assignment to imported bindings | ❌ |
+
+### Code Quality Rules (Warning Level)
+
+| Rule | Level | Purpose | Auto-Fix |
+|------|-------|---------|----------|
+| `no-await-in-loop` | warn | Suggests Promise.all for concurrent ops | ❌ |
+| `no-constant-condition` | warn | Detects constant conditions in loops/ifs | ❌ |
+| `no-empty` | warn | Warns on empty block statements | ❌ |
+| `no-prototype-builtins` | warn | Prevents direct use of Object.prototype methods | ✅ |
+| `require-await` | warn | Requires await in async functions | ❌ |
+| `no-useless-catch` | warn | Detects unnecessary catch clauses | ✅ |
+| `no-useless-escape` | warn | Detects unnecessary escape characters | ✅ |
+| `no-return-assign` | warn | Prevents assignment in return statement | ❌ |
+| `no-sequences` | error | Prevents comma operator usage | ❌ |
+| `no-multi-assign` | warn | Prevents chained assignments | ❌ |
+| `no-nested-ternary` | warn | Prevents nested ternary expressions | ❌ |
+| `no-param-reassign` | warn | Prevents parameter reassignment | ❌ |
+| `operator-assignment` | warn | Requires shorthand assignment operators | ✅ |
+| `prefer-destructuring` | warn | Suggests destructuring for arrays/objects | ✅ |
+| `prefer-exponentiation-operator` | warn | Prefers `**` over Math.pow() | ✅ |
+| `prefer-object-spread` | warn | Prefers object spread over Object.assign() | ✅ |
+| `prefer-rest-params` | warn | Prefers rest parameters over arguments | ✅ |
+| `prefer-spread` | warn | Prefers spread operator over .apply() | ✅ |
+| `prefer-template` | warn | Prefers template literals over string concatenation | ✅ |
+
+---
+
+## TypeScript Rules
+
+### Critical TypeScript Rules (Error Level)
+
+| Rule | Level | Purpose | Auto-Fix |
+|------|-------|---------|----------|
+| `typescript/no-floating-promises` | error | Catches unhandled promise rejections | ❌ |
+| `typescript/await-thenable` | error | Prevents awaiting non-promises | ❌ |
+| `typescript/no-misused-promises` | error | Prevents async mistakes in conditionals | ❌ |
+| `typescript/no-array-delete` | error | Prevents using delete on arrays | ❌ |
+| `typescript/no-duplicate-enum-values` | error | Prevents duplicate enum member values | ❌ |
+| `typescript/no-for-in-array` | error | Prevents for-in loops on arrays | ❌ |
+| `typescript/no-implied-eval` | error | Prevents eval-like patterns | ❌ |
+| `typescript/no-import-type-side-effects` | error | Prevents type import side effects | ✅ |
+| `typescript/no-extra-non-null-assertion` | error | Prevents redundant non-null assertions | ✅ |
+| `typescript/no-unused-vars` | error | Detects unused variables (with _ exceptions) | ❌ |
+
+### TypeScript Best Practices (Warning Level)
+
+| Rule | Level | Purpose | Auto-Fix |
+|------|-------|---------|----------|
+| `typescript/no-explicit-any` | warn | Discourages `any` type (allows in tests) | ❌ |
+| `typescript/require-await` | warn | Requires await in async functions | ❌ |
+| `typescript/ban-types` | warn | Warns on problematic type aliases | ❌ |
+| `typescript/no-empty-interface` | warn | Prevents empty interfaces | ✅ |
+| `typescript/no-extraneous-class` | warn | Prevents classes used only as namespaces | ❌ |
+| `typescript/no-namespace` | warn | Discourages TypeScript namespaces | ❌ |
+| `typescript/no-non-null-assertion` | warn | Warns on non-null assertions | ❌ |
+| `typescript/no-this-alias` | warn | Prevents `const self = this` patterns | ✅ |
+| `typescript/no-unnecessary-type-assertion` | warn | Detects redundant type assertions | ✅ |
+| `typescript/no-unnecessary-type-constraint` | warn | Detects redundant type constraints | ✅ |
+| `typescript/no-unsafe-argument` | warn | Warns on unsafe argument types | ❌ |
+| `typescript/no-unsafe-assignment` | warn | Warns on unsafe assignments | ❌ |
+| `typescript/no-unsafe-call` | warn | Warns on unsafe function calls | ❌ |
+| `typescript/no-unsafe-member-access` | warn | Warns on unsafe property access | ❌ |
+| `typescript/no-unsafe-return` | warn | Warns on unsafe return types | ❌ |
+| `typescript/prefer-as-const` | warn | Prefers `as const` assertions | ✅ |
+| `typescript/prefer-for-of` | warn | Prefers for-of over indexed loops | ❌ |
+| `typescript/prefer-function-type` | warn | Prefers function types over interfaces | ✅ |
+| `typescript/prefer-includes` | warn | Prefers .includes() over .indexOf() | ✅ |
+| `typescript/prefer-nullish-coalescing` | warn | Prefers ?? over \|\| for null checks | ✅ |
+| `typescript/prefer-optional-chain` | warn | Prefers ?. over manual null checks | ✅ |
+| `typescript/prefer-ts-expect-error` | warn | Prefers @ts-expect-error over @ts-ignore | ✅ |
+| `typescript/consistent-type-imports` | warn | Enforces type import style | ✅ |
+| `typescript/adjacent-overload-signatures` | warn | Groups overload signatures together | ❌ |
+| `typescript/array-type` | warn | Enforces consistent array type syntax | ✅ |
+| `typescript/consistent-type-definitions` | warn | Enforces interface or type alias | ✅ |
+| `typescript/no-base-to-string` | warn | Prevents calling toString() on objects | ❌ |
+| `typescript/no-confusing-non-null-assertion` | warn | Prevents confusing ! placements | ✅ |
+| `typescript/no-duplicate-type-constituents` | warn | Prevents duplicate union/intersection types | ✅ |
+| `typescript/no-unnecessary-boolean-literal-compare` | warn | Simplifies boolean comparisons | ✅ |
+| `typescript/prefer-literal-enum-member` | warn | Requires literal values for enum members | ❌ |
+| `typescript/prefer-namespace-keyword` | warn | Prefers namespace over module keyword | ✅ |
+| `typescript/prefer-return-this-type` | warn | Improves method chaining types | ❌ |
+
+---
+
+## Unicorn Rules (Modern JavaScript)
+
+### Critical Unicorn Rules (Error Level)
+
+| Rule | Level | Purpose | Auto-Fix |
+|------|-------|---------|----------|
+| `unicorn/prefer-node-protocol` | error | Requires node: protocol for imports | ✅ |
+| `unicorn/prefer-array-some` | error | Prefers .some() over .find() for boolean checks | ✅ |
+| `unicorn/prefer-array-find` | error | Prefers .find() over .filter()[0] | ✅ |
+| `unicorn/prefer-includes` | error | Prefers .includes() over .indexOf() !== -1 | ✅ |
+| `unicorn/prefer-string-starts-ends-with` | error | Prefers .startsWith()/.endsWith() | ✅ |
+| `unicorn/throw-new-error` | error | Requires `new Error()` for throwing | ✅ |
+| `unicorn/error-message` | error | Requires error messages | ❌ |
+| `unicorn/no-instanceof-array` | error | Requires Array.isArray() | ✅ |
+| `unicorn/prefer-optional-catch-binding` | error | Allows optional catch binding | ✅ |
+| `unicorn/new-for-builtins` | error | Requires new for built-in constructors | ✅ |
+| `unicorn/no-instanceof-builtins` | error | Prevents instanceof for built-ins | ✅ |
+| `unicorn/no-new-buffer` | error | Prevents deprecated Buffer constructor | ✅ |
+
+### Unicorn Best Practices (Warning Level)
+
+| Rule | Level | Purpose | Auto-Fix |
+|------|-------|---------|----------|
+| `unicorn/prefer-default-parameters` | warn | Prefers default parameters | ✅ |
+| `unicorn/prefer-spread` | warn | Prefers spread operator | ✅ |
+| `unicorn/prefer-ternary` | warn | Prefers ternary over if/else for assignment | ✅ |
+| `unicorn/consistent-function-scoping` | warn | Moves functions to appropriate scope | ❌ |
+| `unicorn/no-useless-undefined` | warn | Prevents explicit undefined returns | ✅ |
+| `unicorn/no-nested-ternary` | warn | Prevents nested ternary expressions | ❌ |
+| `unicorn/prefer-at` | warn | Prefers .at() for array access | ✅ |
+| `unicorn/prefer-array-flat-map` | warn | Prefers .flatMap() over .map().flat() | ✅ |
+| `unicorn/prefer-array-index-of` | warn | Prefers .indexOf() over .findIndex() for primitives | ✅ |
+| `unicorn/prefer-set-has` | warn | Prefers Set.has() over array.includes() | ❌ |
+| `unicorn/prefer-string-slice` | warn | Prefers .slice() over .substr() | ✅ |
+| `unicorn/prefer-string-replace-all` | warn | Prefers .replaceAll() over regex replace | ✅ |
+| `unicorn/prefer-string-trim-start-end` | warn | Prefers .trimStart()/.trimEnd() | ✅ |
+| `unicorn/prefer-math-min-max` | warn | Prefers Math.min/max over ternary | ✅ |
+| `unicorn/prefer-number-properties` | warn | Prefers Number.isNaN() over global | ✅ |
+| `unicorn/prefer-object-from-entries` | warn | Prefers Object.fromEntries() | ❌ |
+| `unicorn/number-literal-case` | warn | Enforces lowercase for number literals | ✅ |
+| `unicorn/no-lonely-if` | warn | Prevents lonely if in else block | ✅ |
+| `unicorn/no-useless-spread` | warn | Prevents unnecessary spread | ✅ |
+| `unicorn/no-useless-fallback-in-spread` | warn | Prevents useless fallback in spread | ✅ |
+| `unicorn/no-useless-length-check` | warn | Simplifies .length checks | ✅ |
+| `unicorn/no-useless-promise-resolve-reject` | warn | Simplifies Promise patterns | ✅ |
+| `unicorn/prefer-modern-math-apis` | warn | Prefers modern Math methods | ✅ |
+| `unicorn/prefer-native-coercion-functions` | warn | Prefers native coercion | ✅ |
+| `unicorn/prefer-add-event-listener` | warn | Prefers addEventListener | ✅ |
+| `unicorn/prefer-dom-node-append` | warn | Prefers .append() over .appendChild() | ✅ |
+| `unicorn/prefer-dom-node-remove` | warn | Prefers .remove() over .removeChild() | ✅ |
+| `unicorn/prefer-dom-node-text-content` | warn | Prefers .textContent over .innerText | ✅ |
+| `unicorn/prefer-query-selector` | warn | Prefers querySelector | ✅ |
+| `unicorn/prefer-reflect-apply` | warn | Prefers Reflect.apply() | ❌ |
+| `unicorn/prefer-regexp-test` | warn | Prefers .test() over .match() | ✅ |
+| `unicorn/prefer-prototype-methods` | warn | Prefers prototype methods | ❌ |
+| `unicorn/prefer-code-point` | warn | Prefers .codePointAt() | ✅ |
+| `unicorn/prefer-date-now` | warn | Prefers Date.now() over new Date() | ✅ |
+| `unicorn/prefer-array-flat` | warn | Prefers .flat() over array flattening | ✅ |
+| `unicorn/escape-case` | warn | Enforces lowercase escape sequences | ✅ |
+| `unicorn/no-console-spaces` | warn | Prevents spaces in console calls | ✅ |
+| `unicorn/no-hex-escape` | warn | Prevents hex escapes | ✅ |
+| `unicorn/no-new-array` | warn | Prevents new Array() | ✅ |
+| `unicorn/no-typeof-undefined` | warn | Simplifies typeof checks | ✅ |
+| `unicorn/no-unreadable-array-destructuring` | warn | Prevents unclear destructuring | ❌ |
+| `unicorn/no-unreadable-iife` | warn | Prevents unclear IIFEs | ❌ |
+| `unicorn/consistent-empty-array-spread` | warn | Enforces consistent empty array spread | ✅ |
+| `unicorn/prefer-structured-clone` | warn | Prefers structuredClone() | ❌ |
+| `unicorn/prefer-type-error` | warn | Requires TypeError for type errors | ❌ |
+| `unicorn/relative-url-style` | warn | Enforces relative URL style | ✅ |
+| `unicorn/require-array-join-separator` | warn | Requires explicit separator in .join() | ❌ |
+| `unicorn/require-number-to-fixed-digits-argument` | warn | Requires argument in .toFixed() | ❌ |
+
+**Special Unicorn Rules:**
+- `unicorn/no-thenable` - Error level, but disabled via overrides for validation files (`**/validations/**/*.ts`, `**/*validation*.ts`) to allow Joi/Yup `.then()` syntax
+
+---
+
+## Import Rules
+
+| Rule | Level | Purpose | Auto-Fix |
+|------|-------|---------|----------|
+| `import/no-duplicates` | error | Prevents duplicate imports | ✅ |
+| `import/no-self-import` | error | Prevents importing itself | ❌ |
+| `import/no-cycle` | warn | Detects circular dependencies | ❌ |
+| `import/named` | error | Ensures named imports exist | ❌ |
+| `import/namespace` | error | Ensures namespace imports are valid | ❌ |
+| `import/default` | error | Ensures default export exists | ❌ |
+| `import/no-named-as-default` | warn | Warns when importing default as named | ❌ |
+| `import/no-named-as-default-member` | warn | Warns on default import property access | ❌ |
+
+---
+
+## Jest Rules
+
+| Rule | Level | Purpose | Auto-Fix |
+|------|-------|---------|----------|
+| `jest/no-conditional-expect` | error | Prevents expect in conditionals | ❌ |
+| `jest/no-focused-tests` | error | Prevents .only tests | ✅ |
+| `jest/no-identical-title` | error | Prevents duplicate test names | ❌ |
+| `jest/no-jasmine-globals` | error | Prevents Jasmine globals | ✅ |
+| `jest/no-mocks-import` | error | Prevents importing from __mocks__ | ❌ |
+| `jest/no-standalone-expect` | error | Prevents expect outside tests | ❌ |
+| `jest/valid-describe-callback` | error | Validates describe callbacks | ❌ |
+| `jest/valid-expect` | error | Validates expect usage | ❌ |
+| `jest/expect-expect` | warn | Ensures tests have assertions | ❌ |
+| `jest/no-alias-methods` | warn | Prevents Jest alias methods | ✅ |
+| `jest/no-commented-out-tests` | warn | Detects commented tests | ❌ |
+| `jest/no-disabled-tests` | warn | Detects disabled tests | ❌ |
+| `jest/no-test-prefixes` | warn | Prevents fdescribe/fit | ✅ |
+| `jest/valid-title` | warn | Validates test titles | ✅ |
+| `jest/prefer-hooks-on-top` | warn | Places hooks at top | ❌ |
+| `jest/prefer-spy-on` | warn | Prefers jest.spyOn() | ✅ |
+| `jest/prefer-todo` | warn | Prefers test.todo() | ✅ |
+
+---
+
+## OXC Custom Rules
+
+Unique performance and correctness checks created by the Oxc team:
+
+| Rule | Level | Purpose | Auto-Fix |
+|------|-------|---------|----------|
+| `oxc/bad-array-method-on-arguments` | error | Prevents array methods on arguments | ❌ |
+| `oxc/bad-bitwise-operator` | error | Detects misused bitwise operators | ❌ |
+| `oxc/bad-char-at-comparison` | error | Detects incorrect charAt comparisons | ✅ |
+| `oxc/bad-comparison-sequence` | error | Detects incorrect comparison chains | ✅ |
+| `oxc/bad-min-max-func` | error | Detects incorrect Math.min/max usage | ✅ |
+| `oxc/bad-object-literal-comparison` | error | Detects object literal comparisons | ❌ |
+| `oxc/bad-replace-all-arg` | error | Detects incorrect replaceAll arguments | ❌ |
+| `oxc/const-comparisons` | error | Detects always-true/false comparisons | ✅ |
+| `oxc/double-comparisons` | error | Simplifies redundant comparisons | ✅ |
+| `oxc/misrefactored-assign-op` | error | Detects misrefactored assignments | ✅ |
+| `oxc/missing-throw` | error | Detects Error objects not thrown | ✅ |
+| `oxc/number-arg-out-of-range` | error | Detects out-of-range number arguments | ❌ |
+| `oxc/uninvoked-array-callback` | error | Detects callback not invoked | ❌ |
+| `oxc/approx-constant` | warn | Suggests built-in constants | ❌ |
+| `oxc/erasing-op` | warn | Detects operations that erase values | ✅ |
+| `oxc/no-accumulating-spread` | warn | Warns on performance issues with spread | ❌ |
+| `oxc/only-used-in-recursion` | warn | Detects variables only used recursively | ❌ |
+
+---
+
+# Oxfmt Configuration
+
+Oxfmt v0.28.0 has **100% Prettier conformance** and supports all major Prettier options.
+
+## Configured Options
+
+```json
+{
+  "semi": true,
+  "trailingComma": "all",
+  "singleQuote": true,
+  "printWidth": 120,
+  "tabWidth": 2,
+  "useTabs": false,
+  "arrowParens": "always",
+  "endOfLine": "lf"
+}
+```
+
+## Option Descriptions
+
+| Option | Value | Purpose |
+|--------|-------|---------|
+| `semi` | `true` | Add semicolons at the end of statements |
+| `trailingComma` | `"all"` | Add trailing commas wherever possible |
+| `singleQuote` | `true` | Use single quotes instead of double quotes |
+| `printWidth` | `120` | Wrap lines at 120 characters |
+| `tabWidth` | `2` | Use 2 spaces for indentation |
+| `useTabs` | `false` | Use spaces instead of tabs |
+| `arrowParens` | `"always"` | Always include parens around arrow function params |
+| `endOfLine` | `"lf"` | Use Unix line endings (LF) |
+
+---
+
+# Rule Severity Levels
+
+## Error (Block CI/Pull Requests)
+
+Rules marked as `error` will:
+- Fail CI builds
+- Block pull requests
+- Must be fixed before merging
+
+**Examples:**
+- `no-console` - Production code safety
+- `no-debugger` - Production code safety
+- `typescript/no-floating-promises` - Prevents silent failures
+- `eqeqeq` - Type safety
+
+## Warning (Should Fix)
+
+Rules marked as `warn` will:
+- Show in linting output
+- Not block CI/pull requests
+- Should be addressed when convenient
+
+**Examples:**
+- `typescript/no-explicit-any` - Type safety (allowed in tests)
+- `no-await-in-loop` - Performance suggestion
+- `prefer-const` - Best practice
+- Most Unicorn rules - Modern JavaScript patterns
+
+---
+
+# Auto-Fix Categories
+
+Oxlint categorizes auto-fixes into three types:
+
+## Safe Fixes (`--fix`)
+Changes that do NOT alter program behavior:
+- Formatting fixes
+- Adding missing semicolons
+- Removing unused imports
+- Simplifying boolean expressions
+
+## Suggestions (`--fix-suggestions`)
+Changes that MAY alter behavior:
+- Converting `var` to `const`/`let`
+- Simplifying conditional logic
+- Optimizing array methods
+
+## Dangerous Fixes (`--fix-dangerously`)
+Aggressive changes that may break code:
+- Removing unused function parameters
+- Aggressive dead code removal
+
+**Usage:**
+```bash
+npm run lint:fix              # Safe fixes only
+npm run lint:fix-all          # All fixes (use carefully)
+```
+
+---
+
+# Summary
+
+- **Total Rules**: 140+ enabled from 665+ available
+- **Error Rules**: ~50 (critical safety and correctness)
+- **Warning Rules**: ~90 (best practices and modern patterns)
+- **Auto-Fixable**: ~110 rules support automatic fixes
+- **Performance**: 37x faster than ESLint, 30x faster than Prettier
+- **Compatibility**: 100% Prettier conformance with Oxfmt v0.28.0
+
+---
+
+**Last Updated**: 2026-02-10
+**Package Version**: @autofleet/lint v2.0.0
+**Oxlint Version**: v1.43.0
+**Oxfmt Version**: v0.28.0