@elliemae/pui-cli 9.0.0-alpha.1 → 9.0.0-alpha.11

package/dist/cjs/lint-config/eslint/flat/rules.mjs

@@ -0,0 +1,185 @@
+/** Shared rule sets migrated from legacy eslintrc (common.cjs + typescript/*.cjs). */
+
+export const baseRules = {
+  'arrow-body-style': ['error', 'as-needed'],
+  'class-methods-use-this': 'off',
+  'import-x/imports-first': 'off',
+  'import-x/newline-after-import': 'off',
+  'import-x/no-dynamic-require': 'off',
+  // Off — legacy parity; PUI apps import via @elliemae/app-react-dependencies (not direct package.json entries).
+  'import-x/no-extraneous-dependencies': 'off',
+  'import-x/no-named-as-default': 'off',
+  'import-x/no-unresolved': [
+    'error',
+    { caseSensitive: true, caseSensitiveStrict: true },
+  ],
+  'import-x/no-webpack-loader-syntax': 'off',
+  'import-x/prefer-default-export': 'off',
+  'import-x/default': 'off',
+  'import-x/namespace': 'off',
+  'import-x/extensions': [
+    'error',
+    'never',
+    {
+      json: 'ignorePackages',
+      js: 'ignorePackages',
+    },
+  ],
+  complexity: ['error', { max: 10 }],
+  'max-depth': ['error', { max: 4 }],
+  'max-lines-per-function': 'off',
+  'max-nested-callbacks': ['error', { max: 3 }],
+  'max-params': ['error', { max: 3 }],
+  'max-statements': ['error', { max: 20 }],
+  'max-len': 'off',
+  'newline-per-chained-call': 'off',
+  'no-confusing-arrow': 'off',
+  'no-console': 'warn',
+  'no-param-reassign': ['error', { props: false }],
+  'prefer-template': 'error',
+  'require-yield': 'off',
+};
+
+/** Relaxed type-checked rules for test files (shared by default and strict configs). */
+export const typescriptTestRelaxedRules = {
+  '@typescript-eslint/no-unsafe-assignment': 'off',
+  '@typescript-eslint/no-unsafe-member-access': 'off',
+  '@typescript-eslint/no-unsafe-call': 'off',
+  '@typescript-eslint/no-unsafe-argument': 'off',
+  '@typescript-eslint/no-unsafe-return': 'off',
+  '@typescript-eslint/unbound-method': 'off',
+  '@typescript-eslint/no-unsafe-declaration-merging': 'off',
+  '@typescript-eslint/no-unsafe-enum-comparison': 'off',
+  '@typescript-eslint/await-thenable': 'off',
+  '@typescript-eslint/prefer-promise-reject-errors': 'off',
+  'no-constant-binary-expression': 'off',
+  'valid-typeof': 'off',
+  'prefer-const': 'off',
+};
+
+/** Relaxed core rules for generated test fixture JS (checksum mocks, etc.). */
+export const testFixtureRelaxedRules = {
+  'no-unused-vars': 'off',
+  'no-console': 'off',
+  'max-lines': 'off',
+  'max-statements': 'off',
+  complexity: 'off',
+};
+
+export const jsRules = {
+  ...baseRules,
+  'max-lines': ['error', { max: 120, skipComments: true }],
+  'no-unused-vars': 'error',
+};
+
+export const typescriptRules = {
+  ...baseRules,
+  'max-lines': ['error', { max: 200, skipComments: true }],
+  '@typescript-eslint/explicit-module-boundary-types': 'off',
+  '@typescript-eslint/explicit-function-return-type': 'off',
+  '@typescript-eslint/no-use-before-define': [
+    'error',
+    { functions: false, classes: true, variables: true, typedefs: true },
+  ],
+  '@typescript-eslint/unbound-method': ['error', { ignoreStatic: true }],
+  '@typescript-eslint/no-floating-promises': ['error', { ignoreIIFE: true }],
+  '@typescript-eslint/no-misused-promises': [
+    'error',
+    { checksVoidReturn: { attributes: false } },
+  ],
+  '@typescript-eslint/no-unsafe-assignment': 'warn',
+  '@typescript-eslint/no-unsafe-member-access': 'warn',
+  '@typescript-eslint/no-unsafe-call': 'warn',
+  '@typescript-eslint/no-unsafe-argument': 'warn',
+  '@typescript-eslint/no-unsafe-return': 'warn',
+  '@typescript-eslint/consistent-type-imports': [
+    'error',
+    { prefer: 'type-imports', fixStyle: 'inline-type-imports' },
+  ],
+  '@typescript-eslint/no-import-type-side-effects': 'error',
+  'no-unused-vars': 'off',
+  '@typescript-eslint/no-unused-vars': [
+    'error',
+    { argsIgnorePattern: '^_', ignoreRestSiblings: true },
+  ],
+};
+
+/** Stricter TypeScript rules (error on unsafe any usage). */
+export const typescriptStrictRules = {
+  ...typescriptRules,
+  '@typescript-eslint/no-unsafe-assignment': 'error',
+  '@typescript-eslint/no-unsafe-member-access': 'error',
+  '@typescript-eslint/no-unsafe-call': 'error',
+  '@typescript-eslint/no-unsafe-argument': 'error',
+  '@typescript-eslint/no-unsafe-return': 'error',
+};
+
+export const reactRules = {
+  'jsx-a11y/aria-props': 'error',
+  'jsx-a11y/heading-has-content': 'off',
+  'jsx-a11y/label-has-associated-control': [
+    'error',
+    {
+      controlComponents: ['Input'],
+    },
+  ],
+  'jsx-a11y/label-has-for': 'off',
+  'jsx-a11y/mouse-events-have-key-events': 'error',
+  'jsx-a11y/role-has-required-aria-props': 'error',
+  'jsx-a11y/role-supports-aria-props': 'error',
+  'react/destructuring-assignment': 'off',
+  'react-hooks/rules-of-hooks': 'error',
+  'react-hooks/exhaustive-deps': 'warn',
+  'react/jsx-closing-tag-location': 'off',
+  'react/forbid-prop-types': 'off',
+  'react/jsx-first-prop-new-line': ['error', 'multiline'],
+  'react/jsx-no-target-blank': 'off',
+  'react/jsx-props-no-spreading': 'off',
+  'react/jsx-uses-vars': 'error',
+  'react/require-default-props': 'off',
+  'react/require-extension': 'off',
+  'react/self-closing-comp': 'off',
+  'react/sort-comp': 'off',
+  'react/react-in-jsx-scope': 'off',
+  'react/jsx-filename-extension': [
+    'warn',
+    { extensions: ['.js', '.jsx', '.tsx', '.mdx'] },
+  ],
+  'react/function-component-definition': [
+    'error',
+    { namedComponents: 'arrow-function' },
+  ],
+  'react/prop-types': 'off',
+  'redux-saga/no-yield-in-race': 'error',
+  'redux-saga/yield-effects': 'error',
+};
+
+/** Stricter React rules (exhaustive-deps as error). */
+export const reactStrictRules = {
+  ...reactRules,
+  'react-hooks/exhaustive-deps': 'error',
+};
+
+export const ignorePatterns = [
+  '**/build/**',
+  '**/node_modules/**',
+  '**/dist/**',
+  '**/reports/**',
+  '**/allure-report/**',
+  '**/coverage/**',
+  '**/demo/**',
+  '**/docs/**',
+  '**/docs/api/**',
+  '**/temp/**',
+  '**/.tmp/**',
+  '**/public/**',
+  '**/webroot/**',
+  '**/cdn/**',
+  '**/.docusaurus/**',
+  '**/vendor/*.js',
+  '**/.nx/**',
+  '**/pnpm-lock.yaml',
+  '**/.scannerwork/**',
+  '**/stats.json',
+  '**/jsconfig.json',
+];

package/dist/cjs/lint-config/eslint/typescript/non-react.cjs

@@ -1,4 +1,4 @@
-/* eslint-disable max-lines */
+ 
 const { baseRules } = require('../common.cjs');
 const { tsBaseExtends, tsBaseRules, tsBaseConfig } = require('./common.cjs');
 

package/dist/cjs/lint-config/eslint/typescript/react.cjs

@@ -1,4 +1,4 @@
-/* eslint-disable max-lines */
+ 
 const { baseRules, reactRules } = require('../common.cjs');
 const { tsBaseExtends, tsBaseRules, tsBaseConfig } = require('./common.cjs');
 

package/dist/cjs/lint-config/stylelint/config.mjs

@@ -0,0 +1,27 @@
+/** @type {import('stylelint').Config} */
+export const stylelintConfig = {
+  ignoreFiles: [
+    '/dist/**/*',
+    '/coverage/**/*',
+    '/build/**/*',
+    '/reports/**/*',
+    '/temp/**/*',
+    '/docs/**/*',
+    '/demo/**/*',
+    '/node_modules/**/*',
+    '/vendor/**/*',
+  ],
+  customSyntax: 'postcss-styled-syntax',
+  extends: ['stylelint-config-recommended'],
+  rules: {
+    'selector-type-no-unknown': null,
+    'function-no-unknown': null,
+    // Formerly from stylelint-config-styled-components (unmaintained; references
+    // removed rules like no-missing-end-of-source-newline in Stylelint 17).
+    'value-no-vendor-prefix': true,
+    'property-no-vendor-prefix': true,
+    'no-empty-source': null,
+  },
+};
+
+export default stylelintConfig;

package/dist/cjs/lint-config/stylelint/export.mjs

@@ -0,0 +1 @@
+export { stylelintConfig, default } from './config.mjs';

package/dist/cjs/lint-config/stylelint.config.cjs

@@ -1,19 +1,3 @@
-exports.stylelintConfig = {
-  ignoreFiles: [
-    "/dist/**/*",
-    "/coverage/**/*",
-    "/build/**/*",
-    "/reports/**/*",
-    "/temp/**/*",
-    "/docs/**/*",
-    "/demo/**/*",
-    "/node_modules/**/*",
-    "/vendor/**/*",
-  ],
-  customSyntax: "postcss-styled-syntax",
-  extends: [
-    "stylelint-config-recommended",
-    "stylelint-config-styled-components",
-  ],
-  rules: { "selector-type-no-unknown": null, "function-no-unknown": null },
-};
+const { stylelintConfig } = require('./stylelint/export.mjs');
+
+exports.stylelintConfig = stylelintConfig;

package/dist/cjs/monorepo/utils.cjs

@@ -1,22 +1,30 @@
 const path = require('path');
-const { execSync } = require('child_process');
+const { execFileSync } = require('child_process');
 
 const WORKSPACE_DIR_ENV_VAR = 'NPM_CONFIG_WORKSPACE_DIR';
 const WORKSPACE_MANIFEST_FILENAME = 'pnpm-workspace.yaml';
 
+const findUpCli = path.join(
+  path.dirname(require.resolve('find-up-cli/package.json')),
+  'cli.js',
+);
+
 const getPNPMWorkspaceLocation = (cwd) => {
-  let location = null;
-  // eslint-disable-next-line no-restricted-syntax
   for (const fileName of [WORKSPACE_MANIFEST_FILENAME, 'pnpm-workspace.yml']) {
     try {
-      const result = execSync(`npx find-up ${fileName}`, { cwd });
-      location = result.toString().trim();
-      break;
-    } catch (err) {
+      const location = execFileSync(
+        process.execPath,
+        [findUpCli, fileName, `--cwd=${cwd}`],
+        { encoding: 'utf8' },
+      ).trim();
+      if (location) {
+        return location;
+      }
+    } catch {
       // ignore
     }
   }
-  return location;
+  return null;
 };
 
 exports.findMonoRepoRoot = (cwd = process.cwd()) => {

package/dist/cjs/monorepo/utils.js

@@ -32,20 +32,17 @@ __export(utils_exports, {
 });
 module.exports = __toCommonJS(utils_exports);
 var import_node_path = __toESM(require("node:path"), 1);
-var import_child_process = require("child_process");
+var import_find_up = require("find-up");
 const WORKSPACE_DIR_ENV_VAR = "NPM_CONFIG_WORKSPACE_DIR";
 const WORKSPACE_MANIFEST_FILENAME = "pnpm-workspace.yaml";
 const getPNPMWorkspaceLocation = (cwd) => {
-  let location = null;
   for (const fileName of [WORKSPACE_MANIFEST_FILENAME, "pnpm-workspace.yml"]) {
-    try {
-      const result = (0, import_child_process.execSync)(`npx find-up ${fileName}`, { cwd });
-      location = result.toString().trim();
-      break;
-    } catch (err) {
+    const location = (0, import_find_up.findUpSync)(fileName, { cwd });
+    if (location) {
+      return location;
     }
   }
-  return location;
+  return null;
 };
 const findMonoRepoRoot = (cwd = process.cwd()) => {
   const workspaceManifestDirEnvVar = process.env[WORKSPACE_DIR_ENV_VAR] ?? process.env[WORKSPACE_DIR_ENV_VAR.toLowerCase()];

package/dist/cjs/{release.config.cjs → release.config.mjs}

@@ -1,4 +1,5 @@
-module.exports = {
+/** @type {import('semantic-release').GlobalConfig} */
+export default {
   branches: [
     '+([0-9])?(.{+([0-9]),x}).x',
     'master',
@@ -21,7 +22,7 @@ module.exports = {
       },
     ],
     '@semantic-release/npm',
-    './semantic-release-plugin.cjs',
+    './semantic-release-plugin.mjs',
     '@semantic-release/github',
   ],
 };

package/dist/cjs/{semantic-release-plugin.cjs → semantic-release-plugin.mjs}

@@ -1,11 +1,11 @@
-const fs = require('fs');
-const path = require('path');
+import fs from 'node:fs';
+import path from 'node:path';
 
 /**
  * Semantic Release plugin to write publish info and set dist tag
  * @see https://semantic-release.gitbook.io/semantic-release/developer-guide/plugin
  */
-module.exports = {
+export default {
   success: async (pluginConfig, context) => {
     const { nextRelease, logger } = context;
 

package/dist/cjs/skills/migrate-to-pui-cli-9/SKILL.md

@@ -0,0 +1,309 @@
+---
+name: migrate-to-pui-cli-9
+description: >-
+  Migrate a PUI app or library to pui-cli 9 (Node 24, pnpm 11, ESLint 10 flat config, Stylelint 17,
+  Husky 9, Vitest 4, semantic-release 25, Lerna 9, Nx 22). Use when upgrading @elliemae/pui-cli,
+  migrating from .eslintrc.cjs to eslint.config.mjs, release.config.cjs to release.config.mjs,
+  upgrading Husky 8 hooks, fixing Vitest 4 / coverage-v8 breakages, migrating monorepo nx.json from
+  @nrwl/workspace to nx 22, or adopting shared configs from pui-cli. App/library production builds
+  stay on Webpack.
+---
+
+# Migrate to pui-cli 9
+
+Upgrades a PUI repo from pui-cli 8 (ESLint 8 + `.eslintrc.cjs`) to pui-cli 9
+(ESLint 10 + `eslint.config.mjs` + Node 24 + pnpm 11). Production bundling remains Webpack;
+Vitest 4 uses Vite only as the test runner when you run `pui-cli vitest`.
+
+## Pre-flight: Toolchain
+
+| Requirement         | Version                           |
+| ------------------- | --------------------------------- |
+| Node.js             | **24** (see repo `.node-version`) |
+| pnpm                | **11**                            |
+| `@elliemae/pui-cli` | **9.x** (alpha/beta until GA)     |
+
+```bash
+fnm use 24   # or nvm/volta equivalent
+corepack enable
+pnpm install
+```
+
+## Migration steps (phased PRs recommended)
+
+### Phase 1 — Toolchain only
+
+1. Update `.node-version` to `24` if needed.
+2. Ensure CI Jenkins/docker images use Node 24.
+3. Upgrade pnpm to 11 (`packageManager` field in root `package.json`).
+4. Run `pnpm install`, `pnpm test`, `pnpm run build` — fix any Node/pnpm breakages only.
+
+### Phase 2 — Bump pui-cli
+
+```bash
+pnpm add -D @elliemae/pui-cli@9
+```
+
+Re-run install and smoke-test build/test without ESLint changes yet if the bump is large.
+
+### Phase 3 — ESLint 10 flat config
+
+**React apps and libraries:**
+
+```js
+// eslint.config.mjs
+import { eslintFlatConfig } from '@elliemae/pui-cli/eslint';
+
+export default eslintFlatConfig;
+```
+
+**Node / TS services (non-React):**
+
+```js
+// eslint.config.mjs
+import { eslintFlatBaseConfig } from '@elliemae/pui-cli/eslint';
+
+export default eslintFlatBaseConfig;
+```
+
+Then:
+
+1. Delete `.eslintrc.cjs` and `.eslintignore` (ignores are in the shared config).
+2. Run `pnpm exec pui-cli lint --fix`.
+3. Run `pnpm exec pui-cli lint` until **zero errors** (warnings may remain).
+
+**Strict mode** (only after default config is clean):
+
+```js
+import { eslintFlatConfigStrict } from '@elliemae/pui-cli/eslint';
+export default eslintFlatConfigStrict;
+```
+
+### Phase 4 — Repo-specific overrides (if needed)
+
+Add overrides **after** importing the shared config only when lint debt blocks the migration:
+
+```js
+import { eslintFlatConfig } from '@elliemae/pui-cli/eslint';
+
+export default [
+  ...eslintFlatConfig,
+  {
+    rules: {
+      // Temporary: legacy had ~100 no-explicit-any warnings via @typescript-eslint v5
+      '@typescript-eslint/no-explicit-any': 'warn',
+    },
+  },
+];
+```
+
+Remove overrides in a follow-up debt PR. Do not copy Airbnb or legacy `.eslintrc` rules.
+
+### Phase 5 — Husky 9 (if `.husky/` exists)
+
+Skip this phase if the repo has no git hooks. Most PUI apps/libs copied hooks from pui-cli boilerplate and still use Husky 8.
+
+1. Upgrade and remove deprecated package:
+
+```bash
+pnpm add -D husky@9
+pnpm remove husky-init   # if present
+```
+
+2. Update `package.json` `prepare` script:
+
+```diff
+- "prepare": "[ -n \"$CI\" ] || husky install"
++ "prepare": "[ -n \"$CI\" ] || husky"
+```
+
+3. Simplify each hook in `.husky/` — remove the shebang and `husky.sh` source. Keep only the command(s):
+
+**`.husky/pre-commit`** (typical PUI repo):
+
+```sh
+pnpm -s dlx lint-staged
+```
+
+**`.husky/commit-msg`** (if commitlint is enabled):
+
+```sh
+pnpm exec commitlint --edit $1
+```
+
+```diff
+- #!/bin/sh
+- . "$(dirname "$0")/_/husky.sh"
+-
+  pnpm -s dlx lint-staged
+```
+
+4. Delete `.husky/.gitignore` if present (Husky 9 regenerates `.husky/_` on install).
+
+5. Run `pnpm prepare`, then verify hooks with a test commit.
+
+**Environment variable changes (Husky 9):**
+
+| Husky 8                                   | Husky 9       |
+| ----------------------------------------- | ------------- |
+| `HUSKY_SKIP_HOOKS` / `HUSKY_SKIP_INSTALL` | `HUSKY=0`     |
+| `HUSKY_GIT_PARAMS` in commit-msg hooks    | `$1`, `$2`, … |
+
+Reference hooks: [pui-cli/.husky](https://git.elliemae.io/platform-ui/pui-cli/tree/master/.husky)
+
+### Phase 6 — Stylelint 17 (if CSS / styled-components)
+
+1. Simplify `stylelint.config.cjs` — remove `stylelint-config-styled-components` workarounds.
+2. Optional ESM: `stylelint.config.mjs` importing `@elliemae/pui-cli/stylelint`.
+3. Run `pnpm exec pui-cli lint` (CSS pass).
+
+See [stylelint-migration.md](https://docs.pui.mortgagetech.q1.ice.com/cli/stylelint-migration) in pui-cli docs.
+
+### Phase 7 — Vitest 4 (if using `pui-cli vitest`)
+
+Skip if the repo uses Jest (`pui-cli test`) only.
+
+1. Align devDependencies with pui-cli 9 (Vitest 4 stack):
+
+```bash
+pnpm add -D vitest@4 @vitest/coverage-v8@4 vite@8 @vitejs/plugin-react@6 vite-tsconfig-paths@6
+pnpm remove @vitest/coverage-c8 @types/uuid   # when upgrading uuid to 14+
+```
+
+2. Prefer extending shared config:
+
+```typescript
+import { defineConfig, mergeConfig } from 'vitest/config';
+import { vitestConfig } from '@elliemae/pui-cli/vitest';
+
+export default mergeConfig(
+  vitestConfig,
+  defineConfig({
+    test: {
+      /* overrides */
+    },
+  }),
+);
+```
+
+3. Update custom Vitest 1.x options:
+
+| Old                       | New                          |
+| ------------------------- | ---------------------------- |
+| `test.deps.optimizer.web` | `test.deps.optimizer.client` |
+| `@vitest/coverage-c8`     | `@vitest/coverage-v8`        |
+
+4. If `tsconfig.json` extends `@elliemae/pui-cli/app.tsconfig.json` or `library.tsconfig.json`, ensure pui-cli 9 is installed — shared tsconfigs use `moduleResolution: "bundler"`. Custom tsconfigs importing `vitest/config` may need the same.
+
+5. Smoke-test: `pnpm exec pui-cli vitest --passWithNoTests`
+
+### Phase 8 — semantic-release 25 (libraries that publish to npm)
+
+Skip if the repo does not run `semantic-release` (most apps). Libraries with `release.config.cjs` extending `@elliemae/pui-cli/releaseConfig` must migrate — pui-cli 9 exports an ESM shareable config; semantic-release 25 loads ESM `extends` via dynamic `import()`.
+
+1. Upgrade local pins if present:
+
+```bash
+pnpm add -D semantic-release@25 @semantic-release/changelog@6 @semantic-release/exec@7 @semantic-release/git@10
+```
+
+2. Replace `release.config.cjs` with `release.config.mjs`:
+
+```javascript
+/** @type {import('semantic-release').GlobalConfig} */
+export default {
+  extends: '@elliemae/pui-cli/releaseConfig',
+};
+```
+
+3. Delete `release.config.cjs`.
+
+4. Custom plugins: use relative `.mjs` paths with `export default`, or keep `.cjs` plugins by path.
+
+5. Dry-run: `pnpm exec semantic-release --dry-run`
+
+### Phase 9 — Lerna 9 and Nx 22 (monorepos only)
+
+Skip for single-package apps/libs. Applies to repos with `lerna.json`, `nx.json`, and `libs/*` workspaces.
+
+1. After `@elliemae/pui-cli@9` is installed, confirm CLIs:
+
+```bash
+pnpm install
+pnpm exec nx --version    # 22.x
+pnpm exec lerna --version # 9.x
+```
+
+2. Remove legacy pins if present (`@nrwl/cli`, `@nrwl/tao`, `@nrwl/workspace`, direct `lerna`/`nx`).
+
+3. Migrate `nx.json`:
+   - `extends`: `@nrwl/workspace/presets/npm.json` → `nx/presets/npm.json`
+   - Add `$schema`: `./node_modules/nx/schemas/nx-schema.json`
+   - Replace `targetDependencies` with `targetDefaults.<target>.dependsOn` (use `^target` for dependency projects)
+   - Remove `tasksRunnerOptions`; move cacheable targets to `"cache": true` in `targetDefaults`
+   - Optional: `pnpm exec nx migrate latest && pnpm exec nx migrate --run-migrations`
+
+4. Lerna 9: stop using `lerna bootstrap` / `lerna add` / `lerna link` — use pnpm workspaces. Keep existing `lerna.json` unless it referenced removed commands. `pui-cli version` unchanged.
+
+5. Smoke-test:
+
+```bash
+pnpm exec nx run-many --target=build --all --parallel
+pnpm exec nx affected --target=lint --uncommitted
+pnpm exec pui-cli lint
+```
+
+See [pui-cli 9 migration guide](https://docs.pui.mortgagetech.q1.ice.com/cli/pui-cli-9-migration) — **Lerna 9 and Nx 22** section for the full `nx.json` template.
+
+### Phase 10 — Verify
+
+- [ ] `pnpm exec pui-cli lint` — 0 errors
+- [ ] `pnpm exec pui-cli tscheck --files`
+- [ ] `pnpm test` (or `pui-cli vitest` if applicable)
+- [ ] `pnpm run build` (or `pui-cli build`) — Webpack, unchanged
+- [ ] Pre-commit / lint-staged passes (after Husky 9 migration if applicable)
+- [ ] Monorepos: `nx run-many --target=build --all` and `pui-cli version --help`
+- [ ] CI green on the target branch
+
+## Common lint fixes after upgrade
+
+| Symptom                              | Fix                                                                                 |
+| ------------------------------------ | ----------------------------------------------------------------------------------- |
+| `import-x/no-unresolved`             | Use `import type` for type-only imports                                             |
+| `@typescript-eslint/no-explicit-any` | Type the value or add targeted override (warn) during transition                    |
+| `@typescript-eslint/no-unused-vars`  | Remove or prefix with `_`                                                           |
+| Stale `eslint-disable` comments      | Remove disables for rules no longer in config                                       |
+| Test/fixture files flagged           | Shared config includes `lib/**/tests/**` globs — ensure pui-cli 9.0.0+              |
+| `.d.ts` files                        | pui-cli turns off `no-explicit-any` for `**/*.d.ts`                                 |
+| Cannot find module `vite` in tscheck | Set `moduleResolution: "bundler"` or extend pui-cli 9 tsconfig                      |
+| Vitest `optimizer.web` unknown       | Rename to `test.deps.optimizer.client` (Vitest 4)                                   |
+| Coverage fails after upgrade         | Remove `@vitest/coverage-c8`; use `@vitest/coverage-v8@4`                           |
+| `release.config.cjs` extends fails   | Migrate to `release.config.mjs`; requires semantic-release 22+ (pui-cli 9 ships 25) |
+| `nx` fails after pui-cli 9 bump      | Migrate `nx.json` off `@nrwl/*`; use `targetDefaults` not `targetDependencies`      |
+| `lerna bootstrap` / `add` / `link`   | Removed in lerna 9 — use `pnpm` workspaces and `pnpm add --filter`                  |
+| Stale `@nrwl/workspace` in lockfile  | Remove direct `@nrwl/*` pins; rely on pui-cli's `nx` + `@nx/workspace`              |
+
+Full rule comparison: [eslint-rules-migration.md](https://docs.pui.mortgagetech.q1.ice.com/cli/eslint-rules-migration) (also at `docs/eslint-rules-migration.md` in pui-cli).
+
+## Install this skill in Cursor
+
+From the consumer repo (after `@elliemae/pui-cli` is installed):
+
+```bash
+pnpm exec pui-cli skills install migrate-to-pui-cli-9 --target all
+```
+
+Skills are copied to `.cursor/skills/`, `.claude/skills/`, and `.github/skills/` for Cursor, Claude Code, and GitHub Copilot.
+
+## What NOT to change
+
+- Application business logic — migration is tooling/config only
+- Webpack/babel production build config — pui-cli 9 does not migrate apps to Vite for bundling
+- Prettier / commitlint configs unless pui-cli 9 bumps those presets
+
+## Additional resources
+
+- [pui-cli 9 migration guide](https://docs.pui.mortgagetech.q1.ice.com/cli/pui-cli-9-migration)
+- [ESLint rules migration guide](https://docs.pui.mortgagetech.q1.ice.com/cli/eslint-rules-migration)
+- [Stylelint migration guide](https://docs.pui.mortgagetech.q1.ice.com/cli/stylelint-migration)
+- Reference one-liner: `pui-react-boilerplate/eslint.config.mjs`