snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)

packages/twenty-oxlint-rules/OXLINT_MIGRATION_TODO.md

@@ -0,0 +1,55 @@
+# Oxlint Migration TODO
+
+This file tracks what was lost or temporarily disabled during the ESLint to Oxlint migration, and what needs to be re-activated or addressed.
+
+## Temporarily Disabled Rules
+
+### twenty-server
+
+| Rule | Reason | Violations | Auto-fixable |
+|------|--------|------------|-------------|
+| `typescript/consistent-type-imports` | 3814 pre-existing violations. **Cannot be auto-fixed** because NestJS relies on `emitDecoratorMetadata` for DI — the auto-fixer converts constructor parameter imports to `import type`, which erases them at runtime and breaks dependency injection. | 3814 | No (unsafe auto-fix) |
+| `twenty/max-consts-per-file` | 94 pre-existing violations across 24 constant files with >1 export | 94 | No |
+
+## Re-activated Rules
+
+### twenty-front
+
+| Rule | Violations Fixed | Method |
+|------|-----------------|--------|
+| `twenty/sort-css-properties-alphabetically` | 578 | Auto-fix via `npx nx lint twenty-front --configuration=fix` |
+
+## Dropped Plugins (No Oxlint Equivalent)
+
+These plugins were in use but have no oxlint equivalent. Consider whether alternative tooling is needed.
+
+| Plugin | Where Used | What It Did | Replacement / Status |
+|--------|-----------|-------------|---------------------|
+| `eslint-plugin-project-structure` | Frontend | Enforced folder naming and structure conventions for `src/modules/` (kebab-case dirs, allowed subdirs like hooks/utils/components, file naming for hooks/utils). Config still in `folderStructure.json`. | Re-implemented as `twenty/folder-structure` custom oxlint rule. Enabled as `"warn"` — 403 pre-existing violations (160 non-kebab-case names, 215 depth > 4, 28 naming). |
+| `lingui/*` | Frontend, emails | i18n extraction and consistency rules | No equivalent |
+| `@stylistic/*` | Server | Formatting rules (indentation, spacing) | Use Prettier instead |
+| `import/order`, `simple-import-sort/imports` | Server | Import sorting and ordering | No equivalent |
+| `prefer-arrow/prefer-arrow-functions` | Frontend | Enforced arrow functions over function declarations | No equivalent |
+| `eslint-plugin-mdx` | Docs | MDX file linting | Not supported by oxlint |
+| `@next/eslint-plugin-next` | Website | Next.js-specific rules (no `<img>`, link handling, etc.) | Not supported by oxlint |
+| `eslint-plugin-unused-imports` | Frontend | Removed unused imports on save | Partially covered by `no-unused-vars` |
+| `eslint-plugin-storybook` | Frontend | Storybook best practices (story structure, naming) | No equivalent |
+| `eslint-plugin-jsx-a11y` | Frontend | Accessibility rules (alt text, aria, roles, etc.) | Partial equivalent in Oxlint (`jsx-a11y` plugin), but coverage is limited. |
+| `eslint-plugin-react-refresh` | Frontend | React Refresh boundary validation (HMR) | No equivalent |
+
+## IDE Integration
+
+The `oxc.oxc-vscode` extension provides inline diagnostics for built-in oxlint rules but does **not** yet support `jsPlugins` (custom `twenty/*` rules). Custom rule violations are only caught by `nx lint` and CI.
+
+## Remaining Re-activation Plan
+
+1. **Consistent type imports** (`twenty-server`): Cannot safely auto-fix due to NestJS `emitDecoratorMetadata`. Options:
+   - Manually add `import type` only where safe (not for DI constructor params)
+   - Enable TypeScript's `verbatimModuleSyntax` (major migration)
+   - Keep disabled until oxlint supports decorator-aware type import analysis
+2. **Max consts per file** (`twenty-server`): Manually split 24 constant files to have at most 1 exported const each, then re-enable the rule.
+3. **Folder structure enforcement** (`twenty-front`): Re-implemented as `twenty/folder-structure` custom oxlint rule (enabled as `"warn"`). 403 pre-existing violations to address:
+   - 160 non-kebab-case module folder names (e.g. `graphWidgetBarChart` → `graph-widget-bar-chart`)
+   - 215 modules nested deeper than 4 levels
+   - 28 util/hook file naming violations (`.util.ts` suffixes, kebab-case filenames, PascalCase)
+   - Promote to `"error"` once violations are resolved