Merge pull request #155 from kaonis/feat/154-eslint-flat-config

feat: migrate linting to ESLint flat config (closes #154)

Author: kaonis

.eslintrc.json

@@ -15,7 +15,7 @@
     "test:ci": "npm run test:preflight && jest --ci --coverage --maxWorkers=2",
     "test:schema-gate": "npm run test:preflight && jest --ci --runInBand src/services/__tests__/nodeManager.test.ts",
     "test:coverage": "npm run test:preflight && jest --coverage",
-    "lint": "ESLINT_USE_FLAT_CONFIG=false eslint src --ext .ts --max-warnings=0",
+    "lint": "eslint src --max-warnings=0",
     "format": "prettier --write \"src/**/*.ts\"",
     "pm2:start": "pm2 start ecosystem.config.js",
     "pm2:stop": "pm2 stop woly-cnc",

apps/cnc/package.json

@@ -16,8 +16,8 @@
     "start": "ts-node src/app.ts",
     "dev": "nodemon --watch src --exec ts-node src/app.ts",
     "prod": "npm run build && npm run pm2:start",
-    "lint": "ESLINT_USE_FLAT_CONFIG=false eslint src --max-warnings=0",
-    "lint-fix": "ESLINT_USE_FLAT_CONFIG=false eslint --fix src --max-warnings=0",
+    "lint": "eslint src --max-warnings=0",
+    "lint-fix": "eslint --fix src --max-warnings=0",
     "format": "prettier --write src",
     "security:audit": "npm audit --audit-level=high",
     "pm2:start": "pm2 start ecosystem.config.js",

apps/node-agent/package.json

@@ -52,17 +52,20 @@ Primary impact:
    Tracking issue: #148
 4. Wave D: ESLint 10 compatibility revisit  
    Tracking issue: #150
+5. Wave E: ESLint flat config migration precondition  
+   Tracking issue: #154
 
 ## 4. Decision Table (2026-02-15)
 
 | Dependency | Decision | Rationale | Tracking |
 |---|---|---|---|
-| ESLint v9 | Merge candidate | Compatible major with typescript-eslint v8 peer requirements | #146 |
+| ESLint v9 | Merged | Adopted with typescript-eslint v8 via PR #151 | #146 |
 | ESLint v10 | Deferred pending upstream compatibility | Still blocked: latest `@typescript-eslint/*@8.55.0` peers `eslint ^8.57.0 || ^9.0.0` | #150 |
-| typescript-eslint v8 | Merge candidate | Coupled with ESLint v9 upgrade under current compatibility constraints | #146 |
-| eslint-config-prettier v10 | Merge candidate | Companion lint stack upgrade with low runtime risk | #146 |
+| typescript-eslint v8 | Merged | Upgraded with ESLint v9 toolchain migration via PR #151 | #146 |
+| eslint-config-prettier v10 | Merged | Upgraded with ESLint v9 toolchain migration via PR #151 | #146 |
 | Zod v4 | Merged | Runtime schema compatibility validated across protocol/C&C/node-agent and merged via PR #152 | #147 |
 | npm v11 | Merged | Workspace tooling and CI remained stable; adopted via PR #17 | #148 |
+| ESLint flat config mode | In progress | Removes legacy `.eslintrc`/`ESLINT_USE_FLAT_CONFIG=false` dependency to clear ESLint 10 precondition | #154 |
 
 ## 5. Exit Criteria for #144
 

docs/DEPENDENCY_MAJOR_UPGRADE_PLAN.md

@@ -6,15 +6,16 @@ Scope: New autonomous cycle after V5 completion.
 ## 1. Status Audit
 
 ### Repository and branch status
-- `master` synced at merge commit `71dd306` (PR #17).
+- `master` synced at merge commit `9182401` (PR #153).
 - Active execution branch: `master`.
 
 ### Open issue snapshot (`kaonis/woly-server`)
 - #4 `Dependency Dashboard`
+- #154 `[Lint] Migrate to ESLint flat config before ESLint 10 adoption`
 - #150 `[Dependencies] Revisit ESLint 10 adoption after typescript-eslint compatibility`
 
 ### CI snapshot
-- Post-merge checks for `71dd306` are green (CI + CodeQL).
+- Post-merge checks for `9182401` are green (CI + CodeQL).
 - Dependency triage workflow and audit/security gates are documented and active.
 
 ## 2. Iterative Phases
@@ -74,6 +75,17 @@ Acceptance criteria:
 
 Status: `Blocked` (2026-02-15; latest `@typescript-eslint/*@8.55.0` peers `eslint ^8.57 || ^9`)
 
+### Phase 6: ESLint flat config migration precondition
+Issue: #154  
+Labels: `priority:low`, `technical-debt`, `testing`
+
+Acceptance criteria:
+- Migrate `cnc` and `node-agent` lint tasks to ESLint flat config mode.
+- Remove legacy `.eslintrc` dependency and `ESLINT_USE_FLAT_CONFIG=false` usage.
+- Keep lint/typecheck/test/build gates green.
+
+Status: `In Progress` (2026-02-15)
+
 ## 3. Execution Loop Rules
 
 For each phase:
@@ -110,3 +122,7 @@ For each phase:
 - 2026-02-15: Adopted npm 11 via PR #17 (`packageManager` set to `npm@11.10.0`), closing #148.
 - 2026-02-15: Verified post-merge checks for npm 11 adoption green on `master` (CI + CodeQL, commit `71dd306`).
 - 2026-02-15: Re-validated ESLint 10 compatibility checkpoint for #150 (`npm view @typescript-eslint/eslint-plugin@latest peerDependencies` still `^8.57.0 || ^9.0.0`), keeping #150 open and blocked.
+- 2026-02-15: Merged roadmap/dependency checkpoint docs via PR #153 and verified post-merge `master` checks green (CI + CodeQL).
+- 2026-02-15: Started Phase 6 issue #154 on branch `feat/154-eslint-flat-config`.
+- 2026-02-15: Migrated lint configuration to root `eslint.config.js`, removed legacy `.eslintrc.json`, and switched app lint scripts to flat-config mode without `ESLINT_USE_FLAT_CONFIG=false`.
+- 2026-02-15: Ran local gates for #154 (`npm run lint`, `npm run typecheck`, `npm run test:ci`, `npm run build`) successfully.

docs/ROADMAP_V6.md

@@ -0,0 +1,62 @@
+const js = require('@eslint/js');
+const globals = require('globals');
+const tsPlugin = require('@typescript-eslint/eslint-plugin');
+const tsParser = require('@typescript-eslint/parser');
+const prettierConfig = require('eslint-config-prettier');
+
+module.exports = [
+  {
+    ignores: [
+      'dist/',
+      'node_modules/',
+      '**/*.js',
+      '**/*.test.ts',
+      '**/*.spec.ts',
+      '**/__tests__/**',
+    ],
+  },
+  {
+    ...js.configs.recommended,
+    languageOptions: {
+      ...js.configs.recommended.languageOptions,
+      ecmaVersion: 2022,
+      sourceType: 'module',
+      globals: {
+        ...globals.node,
+        ...globals.es2022,
+      },
+    },
+  },
+  {
+    files: ['**/*.ts'],
+    languageOptions: {
+      parser: tsParser,
+      ecmaVersion: 2022,
+      sourceType: 'module',
+      globals: {
+        ...globals.node,
+        ...globals.es2022,
+      },
+    },
+    plugins: {
+      '@typescript-eslint': tsPlugin,
+    },
+    rules: {
+      ...tsPlugin.configs.recommended.rules,
+      ...prettierConfig.rules,
+      'no-undef': 'off',
+      '@typescript-eslint/no-explicit-any': 'warn',
+      '@typescript-eslint/explicit-function-return-type': 'off',
+      '@typescript-eslint/explicit-module-boundary-types': 'off',
+      '@typescript-eslint/no-unused-vars': [
+        'warn',
+        {
+          argsIgnorePattern: '^_',
+          caughtErrorsIgnorePattern: '^_',
+        },
+      ],
+      'prefer-const': 'error',
+      'no-var': 'error',
+    },
+  },
+];

eslint.config.js

@@ -30,10 +30,12 @@
     "protocol:version:major": "npm version major --workspace=@kaonis/woly-protocol"
   },
   "devDependencies": {
+    "@eslint/js": "^9.39.2",
     "@typescript-eslint/eslint-plugin": "^8.0.0",
     "@typescript-eslint/parser": "^8.0.0",
     "eslint": "^9.0.0",
     "eslint-config-prettier": "^10.0.0",
+    "globals": "^17.3.0",
     "prettier": "^3.1.1",
     "turbo": "^2",
     "typescript": "^5.9.3"