@autofleet/lint 1.0.0

package/.oxfmtrc.json

@@ -0,0 +1,22 @@
+{
+  "semi": true,
+  "trailingComma": "all",
+  "singleQuote": true,
+  "printWidth": 160,
+  "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"
+  ]
+}

package/.oxlintrc.json

@@ -0,0 +1,255 @@
+{
+  "$schema": "./node_modules/oxlint/configuration_schema.json",
+  "env": {
+    "node": true,
+    "jest": true,
+    "es2022": true
+  },
+  "globals": {},
+  "rules": {
+    // Core ESLint rules (migrated from .eslintrc.json)
+    "eqeqeq": "error",
+    "curly": "error",
+    "no-console": "error",
+    "no-debugger": "error",
+    "prefer-const": "error",
+    "no-var": "error",
+    "no-async-promise-executor": "error",
+    "prefer-promise-reject-errors": "error",
+    "no-await-in-loop": "warn",
+    "no-constant-condition": "warn",
+    "no-control-regex": "error",
+    "no-duplicate-case": "error",
+    "no-empty": "warn",
+    "no-ex-assign": "error",
+    "no-extra-boolean-cast": "warn",
+    "no-func-assign": "error",
+    "no-inner-declarations": "error",
+    "no-invalid-regexp": "error",
+    "no-irregular-whitespace": "error",
+    "no-loss-of-precision": "error",
+    "no-misleading-character-class": "error",
+    "no-prototype-builtins": "warn",
+    "no-regex-spaces": "error",
+    "no-self-assign": "error",
+    "no-self-compare": "error",
+    "no-setter-return": "error",
+    "no-sparse-arrays": "error",
+    "no-this-before-super": "error",
+    "no-unreachable": "error",
+    "no-unsafe-finally": "error",
+    "no-unsafe-negation": "error",
+    "no-unsafe-optional-chaining": "error",
+    "no-unused-labels": "error",
+    "no-unused-vars": "error",
+    "no-useless-catch": "warn",
+    "no-useless-escape": "warn",
+    "no-with": "error",
+    "require-await": "warn",
+    "use-isnan": "error",
+    "valid-typeof": "error",
+    "no-unused-private-class-members": "warn",
+    "no-useless-backreference": "error",
+    "no-useless-call": "warn",
+    "no-useless-constructor": "warn",
+    "no-useless-rename": "warn",
+    "no-throw-literal": "error",
+    "no-return-assign": "warn",
+    "no-sequences": "error",
+    "no-multi-assign": "warn",
+    "no-nested-ternary": "warn",
+    "no-param-reassign": "warn",
+    "operator-assignment": "warn",
+    "prefer-destructuring": "warn",
+    "prefer-exponentiation-operator": "warn",
+    "prefer-object-spread": "warn",
+    "prefer-rest-params": "warn",
+    "prefer-spread": "warn",
+    "prefer-template": "warn",
+    "no-const-assign": "error",
+    "no-dupe-keys": "error",
+    "no-import-assign": "error",
+
+    // TypeScript ESLint rules (migrated from .eslintrc.json)
+    "typescript/no-explicit-any": "warn",
+    "typescript/no-unused-vars": "error",
+    "typescript/no-floating-promises": "error",
+    "typescript/await-thenable": "error",
+    "typescript/no-misused-promises": "error",
+    "typescript/require-await": "warn",
+    "typescript/ban-types": "warn",
+    "typescript/no-array-delete": "error",
+    "typescript/no-duplicate-enum-values": "error",
+    "typescript/no-empty-interface": "warn",
+    "typescript/no-extraneous-class": "warn",
+    "typescript/no-for-in-array": "error",
+    "typescript/no-implied-eval": "error",
+    "typescript/no-misused-new": "error",
+    "typescript/no-namespace": "warn",
+    "typescript/no-non-null-assertion": "warn",
+    "typescript/no-this-alias": "warn",
+    "typescript/no-unnecessary-type-assertion": "warn",
+    "typescript/no-unnecessary-type-constraint": "warn",
+    "typescript/no-unsafe-argument": "warn",
+    "typescript/no-unsafe-assignment": "warn",
+    "typescript/no-unsafe-call": "warn",
+    "typescript/no-unsafe-member-access": "warn",
+    "typescript/no-unsafe-return": "warn",
+    "typescript/prefer-as-const": "warn",
+    "typescript/prefer-for-of": "warn",
+    "typescript/prefer-function-type": "warn",
+    "typescript/prefer-includes": "warn",
+    "typescript/prefer-nullish-coalescing": "warn",
+    "typescript/prefer-optional-chain": "warn",
+    "typescript/prefer-ts-expect-error": "warn",
+    "typescript/no-var-requires": "off",
+    "typescript/consistent-type-imports": "warn",
+    "typescript/no-import-type-side-effects": "error",
+    "typescript/adjacent-overload-signatures": "warn",
+    "typescript/array-type": "warn",
+    "typescript/consistent-type-definitions": "warn",
+    "typescript/no-base-to-string": "warn",
+    "typescript/no-confusing-non-null-assertion": "warn",
+    "typescript/no-duplicate-type-constituents": "warn",
+    "typescript/no-extra-non-null-assertion": "error",
+    "typescript/no-unnecessary-boolean-literal-compare": "warn",
+    "typescript/prefer-literal-enum-member": "warn",
+    "typescript/prefer-namespace-keyword": "warn",
+    "typescript/prefer-return-this-type": "warn",
+    "typescript/consistent-type-assertions": ["error", { "assertionStyle": "as" }],
+
+    // Unicorn rules (migrated from .eslintrc.json)
+    "unicorn/prefer-node-protocol": "error",
+    "unicorn/prefer-array-some": "error",
+    "unicorn/prefer-array-find": "error",
+    "unicorn/prefer-includes": "error",
+    "unicorn/prefer-string-starts-ends-with": "error",
+    "unicorn/throw-new-error": "error",
+    "unicorn/error-message": "error",
+    "unicorn/no-instanceof-array": "error",
+    "unicorn/prefer-default-parameters": "warn",
+    "unicorn/prefer-optional-catch-binding": "error",
+    "unicorn/no-thenable": "error",
+    "unicorn/prefer-spread": "warn",
+    "unicorn/prefer-ternary": "warn",
+    "unicorn/consistent-function-scoping": "warn",
+    "unicorn/no-useless-undefined": "warn",
+    "unicorn/no-nested-ternary": "warn",
+    "unicorn/prefer-at": "warn",
+    "unicorn/prefer-array-flat-map": "warn",
+    "unicorn/prefer-array-index-of": "warn",
+    "unicorn/prefer-set-has": "warn",
+    "unicorn/prefer-string-slice": "warn",
+    "unicorn/prefer-string-replace-all": "warn",
+    "unicorn/prefer-string-trim-start-end": "warn",
+    "unicorn/prefer-math-min-max": "warn",
+    "unicorn/prefer-number-properties": "warn",
+    "unicorn/prefer-object-from-entries": "warn",
+    "unicorn/number-literal-case": "warn",
+    "unicorn/no-lonely-if": "warn",
+    "unicorn/no-useless-spread": "warn",
+    "unicorn/no-useless-fallback-in-spread": "warn",
+    "unicorn/no-useless-length-check": "warn",
+    "unicorn/no-useless-promise-resolve-reject": "warn",
+    "unicorn/prefer-modern-math-apis": "warn",
+    "unicorn/prefer-native-coercion-functions": "warn",
+    "unicorn/prefer-add-event-listener": "warn",
+    "unicorn/prefer-dom-node-append": "warn",
+    "unicorn/prefer-dom-node-remove": "warn",
+    "unicorn/prefer-dom-node-text-content": "warn",
+    "unicorn/prefer-query-selector": "warn",
+    "unicorn/prefer-reflect-apply": "warn",
+    "unicorn/prefer-regexp-test": "warn",
+    "unicorn/prefer-prototype-methods": "warn",
+    "unicorn/prefer-code-point": "warn",
+    "unicorn/prefer-date-now": "warn",
+    "unicorn/prefer-array-flat": "warn",
+    "unicorn/escape-case": "warn",
+    "unicorn/new-for-builtins": "error",
+    "unicorn/no-console-spaces": "warn",
+    "unicorn/no-hex-escape": "warn",
+    "unicorn/no-instanceof-builtins": "error",
+    "unicorn/no-new-array": "warn",
+    "unicorn/no-new-buffer": "error",
+    "unicorn/no-typeof-undefined": "warn",
+    "unicorn/no-unreadable-array-destructuring": "warn",
+    "unicorn/no-unreadable-iife": "warn",
+    "unicorn/consistent-empty-array-spread": "warn",
+    "unicorn/prefer-structured-clone": "warn",
+    "unicorn/prefer-type-error": "warn",
+    "unicorn/relative-url-style": "warn",
+    "unicorn/require-array-join-separator": "warn",
+    "unicorn/require-number-to-fixed-digits-argument": "warn",
+
+    // Import rules
+    "import/no-duplicates": "error",
+    "import/no-self-import": "error",
+    "import/no-cycle": "warn",
+    "import/named": "error",
+    "import/namespace": "error",
+    "import/default": "error",
+    "import/no-named-as-default": "warn",
+    "import/no-named-as-default-member": "warn",
+
+    // Jest rules
+    "jest/expect-expect": "warn",
+    "jest/no-alias-methods": "warn",
+    "jest/no-commented-out-tests": "warn",
+    "jest/no-conditional-expect": "error",
+    "jest/no-disabled-tests": "warn",
+    "jest/no-focused-tests": "error",
+    "jest/no-identical-title": "error",
+    "jest/no-jasmine-globals": "error",
+    "jest/no-mocks-import": "error",
+    "jest/no-standalone-expect": "error",
+    "jest/no-test-prefixes": "warn",
+    "jest/valid-describe-callback": "error",
+    "jest/valid-expect": "error",
+    "jest/valid-title": "warn",
+    "jest/prefer-hooks-on-top": "warn",
+    "jest/prefer-spy-on": "warn",
+    "jest/prefer-todo": "warn",
+
+    // OXC custom rules
+    "oxc/approx-constant": "warn",
+    "oxc/bad-array-method-on-arguments": "error",
+    "oxc/bad-bitwise-operator": "error",
+    "oxc/bad-char-at-comparison": "error",
+    "oxc/bad-comparison-sequence": "error",
+    "oxc/bad-min-max-func": "error",
+    "oxc/bad-object-literal-comparison": "error",
+    "oxc/bad-replace-all-arg": "error",
+    "oxc/const-comparisons": "error",
+    "oxc/double-comparisons": "error",
+    "oxc/erasing-op": "warn",
+    "oxc/misrefactored-assign-op": "error",
+    "oxc/missing-throw": "error",
+    "oxc/no-accumulating-spread": "warn",
+    "oxc/number-arg-out-of-range": "error",
+    "oxc/only-used-in-recursion": "warn",
+    "oxc/uninvoked-array-callback": "error"
+  },
+  "overrides": [
+    {
+      "files": ["**/validations/**/*.ts", "**/*validation*.ts"],
+      "rules": {
+        "unicorn/no-thenable": "off"
+      }
+    },
+    {
+      "files": ["bin/*.cjs"],
+      "rules": {
+        "no-console": "off"
+      }
+    }
+  ],
+  "ignorePatterns": [
+    "dist",
+    "build",
+    "node_modules",
+    "coverage",
+    "*.config.js",
+    "**/migrations/*",
+    "**/mock.ts"
+  ]
+}

package/MIGRATION_GAPS.md

@@ -0,0 +1,299 @@
+# Migration Gaps: ESLint → Oxlint/Oxfmt
+
+This document outlines the rules and features from our previous ESLint setup that are **NOT available** in Oxlint/Oxfmt.
+
+## Summary
+
+- **Previous Setup**: ESLint (190+ rules) + Oxlint (detection only)
+- **New Setup**: Oxlint (140+ rules migrated) + Oxfmt
+- **Total Gaps**: ~50 rules not supported + some configuration features
+
+---
+
+## 📋 Unsupported ESLint Rules
+
+### Airbnb Style Guide Rules (Not in Oxlint)
+
+| Rule | Reason | Workaround |
+|------|--------|------------|
+| `no-restricted-syntax` | Not implemented in Oxlint | Manual code review |
+| `import/order` | Not implemented (import sorting is manual) | Use IDE sort imports or manual ordering |
+| `import/extensions` | Not implemented | TypeScript handles this |
+| `import/prefer-default-export` | Not implemented | Follow convention manually |
+| `import/no-extraneous-dependencies` | Not implemented | Manual package.json review |
+| `max-len` | Formatting rule - handled by Oxfmt differently | Oxfmt uses `printWidth: 160` |
+
+### TypeScript ESLint Rules (Not in Oxlint)
+
+| Rule | Reason | Workaround |
+|------|--------|------------|
+| `@typescript-eslint/naming-convention` | Not implemented | Follow naming conventions manually |
+| `@typescript-eslint/no-misused-promises` (partial) | Only basic support, missing `checksVoidReturn` option | Be careful with Promise returns |
+| `@typescript-eslint/explicit-function-return-type` | Not implemented | Add return types manually when needed |
+| `@typescript-eslint/explicit-module-boundary-types` | Not implemented | TypeScript compiler handles most cases |
+| `@typescript-eslint/camelcase` | Deprecated in ESLint, use naming-convention | Follow camelCase manually |
+
+### Unicorn Rules (Not in Oxlint)
+
+| Rule | Reason | Impact |
+|------|--------|--------|
+| `unicorn/filename-case` | Not implemented | Low - naming conventions are stylistic |
+| `unicorn/prevent-abbreviations` | Not implemented | Low - was disabled in our config anyway |
+| `unicorn/no-array-reduce` | Not implemented | Low - was disabled in our config anyway |
+| `unicorn/no-array-for-each` | Not implemented | Low - was disabled in our config anyway |
+| `unicorn/no-array-method-this-argument` | Not implemented | Low - was disabled in our config anyway |
+| `unicorn/no-array-callback-reference` | Not implemented | Low - was disabled in our config anyway |
+| `unicorn/prefer-module` | Not implemented | Low - was disabled (we use CommonJS) |
+| `unicorn/prefer-top-level-await` | Not implemented | Low - was disabled |
+| `unicorn/no-null` | Not implemented | Low - was disabled (we use null) |
+
+---
+
+## ⚙️ Configuration Features
+
+### 1. **TypeScript Config Support**
+
+✅ **Oxlint**: Supports TypeScript config files (since v1.43.0) - extend `@autofleet/lint` configuration
+```typescript
+import type { Linter } from 'oxlint';
+import baseConfig from './node_modules/@autofleet/lint/oxlint.config';
+
+const config: Linter.Config = {
+  ...baseConfig,
+  // Your overrides here
+};
+
+export default config;
+```
+
+⚠️ **Oxfmt**: Does NOT support `extends` - must copy configuration file
+
+---
+
+### 2. **File-Level Override Granularity**
+
+**ESLint Had:**
+```json
+{
+  "overrides": [
+    {
+      "files": ["*.test.ts"],
+      "rules": {
+        "no-console": "error",
+        "@typescript-eslint/no-explicit-any": "off"
+      }
+    }
+  ]
+}
+```
+
+**Oxlint Support:**
+✅ Oxlint fully supports file-level overrides with glob patterns
+- Our configuration includes test file overrides
+- Works similarly to ESLint overrides
+
+**Note**: File overrides are defined in the base `oxlint.config.ts` from `@autofleet/lint`. You can add project-specific overrides by spreading the base config.
+
+---
+
+### 3. **Import Ordering Auto-Fix**
+
+**ESLint Had:**
+```json
+{
+  "import/order": ["warn", {
+    "groups": ["builtin", "external", "internal", "parent", "sibling", "index"],
+    "newlines-between": "never",
+    "alphabetize": { "order": "asc", "caseInsensitive": true }
+  }]
+}
+```
+
+**Oxlint Limitation:**
+- No automatic import sorting
+- Oxfmt (formatter) does NOT sort imports
+
+**Workaround**:
+- Use IDE's "Organize Imports" feature (VSCode: Shift+Alt+O)
+- Manually organize imports
+- Consider using a separate tool like `import-sort` if critical
+
+---
+
+### 4. **Naming Convention Enforcement**
+
+**ESLint Had:**
+```json
+{
+  "@typescript-eslint/naming-convention": [
+    "warn",
+    { "selector": "default", "format": ["camelCase"] },
+    { "selector": "variable", "format": ["camelCase", "UPPER_CASE", "PascalCase"] },
+    { "selector": "typeLike", "format": ["PascalCase"] },
+    { "selector": "enumMember", "format": ["UPPER_CASE", "PascalCase"] }
+  ]
+}
+```
+
+**Oxlint Limitation:**
+- No naming convention rule available
+
+**Workaround**:
+- Follow conventions manually
+- Use TypeScript compiler for type naming (PascalCase is natural)
+- Code review enforcement
+
+---
+
+### 5. **Test File Export Restrictions**
+
+**ESLint Had:**
+```json
+{
+  "no-restricted-syntax": [
+    "error",
+    {
+      "selector": "ExportNamedDeclaration",
+      "message": "Exporting from test files is not allowed"
+    }
+  ]
+}
+```
+
+**Oxlint Limitation:**
+- `no-restricted-syntax` with custom selectors not supported
+
+**Workaround**:
+- Manual code review
+- Document convention in CLAUDE.md
+
+---
+
+## 🎨 Oxfmt Formatting Gaps
+
+### Features NOT in Oxfmt
+
+| Feature | Status | Impact |
+|---------|--------|--------|
+| Embedded language formatting (CSS-in-JS, HTML in JS) | ⏳ Coming in Beta | Medium - may need manual formatting for styled-components |
+| Plugin system | ⏳ Researching for Beta | Low |
+| Vue/Svelte/Astro support | ⏳ Coming in Beta | N/A - not used in task-ms |
+
+### Oxfmt Notes
+
+1. **Default Line Width**: Oxfmt defaults to 100 - we override to 160
+
+2. **Formatting Algorithm**: May produce slightly different output in edge cases in rare scenarios
+
+3. **Configuration Options**: All major options supported
+   - ✅ Our config (semi, singleQuote, trailingComma, etc.) fully supported
+
+---
+
+## 📊 Migration Impact Assessment
+
+### High Priority (Must Address)
+
+✅ **None** - All critical rules are supported in Oxlint
+
+### Medium Priority (Monitor)
+
+⚠️ **Import Ordering**
+- **Old**: Auto-fixed with ESLint
+- **New**: Manual or IDE-based
+- **Action**: Document convention, use IDE features
+
+⚠️ **Naming Conventions**
+- **Old**: Enforced by `@typescript-eslint/naming-convention`
+- **New**: Manual enforcement
+- **Action**: Document in CLAUDE.md, code review
+
+### Low Priority (Acceptable Losses)
+
+✅ **Disabled Rules We Already Turned Off**
+- `unicorn/prevent-abbreviations`
+- `unicorn/no-array-reduce`
+- `unicorn/no-array-for-each`
+- `unicorn/filename-case`
+- Most were disabled in our original config
+
+✅ **Stylistic Rules**
+- Oxfmt handles all formatting
+- Edge cases (95% vs 100% Prettier compat) acceptable
+
+---
+
+## 🚀 Benefits Gained (Trade-offs Worth It)
+
+### Performance Improvements
+
+- **Oxlint**: 37x faster than ESLint (~1-2 seconds vs 60+ seconds)
+- **Oxfmt**: 30x faster than Prettier (~0.5 seconds vs 15+ seconds)
+- **CI Time**: ~80% reduction in lint+format time
+
+### Simplicity
+
+- **Before**: 10 packages (ESLint + 6 plugins + TypeScript plugins)
+- **After**: 2 packages (Oxlint + Oxfmt)
+- **Config Complexity**: Reduced from 220 lines to 140 lines
+
+### Maintenance
+
+- **Before**: Manage ESLint, TypeScript ESLint, Airbnb, Unicorn compatibility
+- **After**: Single Oxc project maintains all rules
+
+---
+
+## 📝 Recommendations
+
+### For Developers
+
+1. **Learn Oxlint CLI**:
+   ```bash
+   autofleet-lint          # Lint src directory
+   autofleet-lint --fix    # Apply safe fixes
+   autofleet-lint --fix-suggestions --fix-dangerously  # Apply all fixes
+   autofleet-fmt           # Format src directory
+   autofleet-fmt --check   # Check formatting without changing
+   ```
+
+2. **Use IDE Features**:
+   - **Organize Imports**: Shift+Alt+O (VSCode)
+   - **Format Document**: Shift+Alt+F (VSCode)
+   - **Fix on Save**: Enabled in VSCode settings
+
+3. **Manual Conventions**:
+   - Follow camelCase for variables
+   - Follow PascalCase for types/classes/enums
+   - Keep imports organized (builtin → external → internal)
+   - Don't export from test files
+
+### For Code Review
+
+Focus on:
+- Import organization (since no auto-sort)
+- Naming conventions (since no auto-enforcement)
+- Test file exports (since no restriction rule)
+
+### Future Monitoring
+
+Watch Oxc project for:
+- Import sorting feature (requested by community)
+- Naming convention rule (in backlog)
+- Oxfmt plugin system (for custom rules)
+
+---
+
+## 🔗 References
+
+- [Oxlint Documentation](https://oxc.rs/docs/guide/usage/linter.html)
+- [Oxfmt Documentation](https://oxc.rs/docs/guide/usage/formatter)
+- [Announcing Oxlint 1.0](https://voidzero.dev/posts/announcing-oxlint-1-stable)
+- [Announcing Oxfmt Alpha](https://voidzero.dev/posts/announcing-oxfmt-alpha)
+- [Oxlint Supported Rules](https://oxc.rs/docs/guide/usage/linter/rules)
+- [Oxfmt Migration Guide](https://oxc.rs/docs/guide/usage/formatter/migrate-from-prettier)
+
+---
+
+**Last Updated**: 2026-03-12
+**Migration Version**: ESLint 8.57 → Oxlint 1.43 + Oxfmt 0.28