Feature: Migrate to Typescript7 & AdonisJs7

troubleshooting.md

@@ -0,0 +1,25 @@
+# Troubleshooting
+
+## `npm install` fails with `ERESOLVE`
+
+The project uses TypeScript 7, but `typescript-eslint@8.64.0` declares support only for TypeScript versions below 6.1. npm therefore reports a peer-dependency conflict during a normal install.
+
+The project runs ESLint through `scripts/eslint-with-typescript6.cjs`, which supplies a compatible TypeScript 6 version to ESLint. Until `typescript-eslint` officially supports TypeScript 7, install dependencies with:
+
+```bash
+npm install --force
+```
+
+For a clean, reproducible installation from `package-lock.json`, use:
+
+```bash
+npm ci --force
+```
+
+When adding or updating a dependency, include the same flag:
+
+```bash
+npm install <package-name> --force
+```
+
+Use the Node and npm versions declared by `.nvmrc` and `package.json`. The `--force` workaround can be removed once the installed `typescript-eslint` version supports TypeScript 7 and the TypeScript 6 ESLint shim is no longer needed.