@7n/rules 1.27.0 → 1.28.1

package/rules/js/check/main.mjs

@@ -1,310 +0,0 @@
-/** @see ./docs/tooling.md */
-import { existsSync } from 'node:fs'
-import { copyFile, readFile } from 'node:fs/promises'
-import { join } from 'node:path'
-
-import { createViolationReporter } from '../../../scripts/lib/lint-surface/violation-reporter.mjs'
-
-import {
-  KNIP_CANONICAL_JSON_PATH,
-  OXLINT_CANONICAL_JSON_PATH,
-  OXLINTRC_DRIFT,
-  OXLINTRC_MISSING,
-  verifyOxlintRcAgainstCanonical
-} from '../tooling/main.mjs'
-
-import {
-  AUTO_IMPORTS_IGNORE,
-  ESLINT_CONFIG_IGNORES,
-  ESLINT_CONFIG_MISSING,
-  ESLINT_CONFIG_VUE_WORKSPACE,
-  detectWorkspaceTypes,
-  parseVueList
-} from './eslint-config.mjs'
-
-const NON_DIGITS_RE = /\D+/u
-
-/**
- * Перевіряє ESLint flat config файл.
- * @param {(msg: string) => void} passFn callback при успішній перевірці
- * @param {(msg: string) => void} failFn callback при помилці
- * @param {string} cwd корінь репозиторію
- */
-async function checkEslintConfig(passFn, failFn, cwd) {
-  let eslintPath
-  if (existsSync(join(cwd, 'eslint.config.js'))) {
-    eslintPath = 'eslint.config.js'
-    passFn('eslint.config.js існує')
-  } else if (existsSync(join(cwd, 'eslint.config.mjs'))) {
-    eslintPath = 'eslint.config.mjs'
-    passFn('eslint.config.mjs існує')
-  } else {
-    failFn('Відсутній eslint.config.js або eslint.config.mjs — flat config з getConfig (js.mdc)', ESLINT_CONFIG_MISSING)
-    return
-  }
-  const eslintRaw = await readFile(join(cwd, eslintPath), 'utf8')
-  const checks = [
-    {
-      needle: 'getConfig',
-      ok: `${eslintPath}: містить getConfig`,
-      err: `${eslintPath}: потрібен виклик getConfig (js.mdc)`
-    },
-    {
-      needle: '@nitra/eslint-config',
-      ok: `${eslintPath}: імпорт @nitra/eslint-config`,
-      err: `${eslintPath}: імпортуй getConfig з @nitra/eslint-config`
-    },
-    {
-      needle: AUTO_IMPORTS_IGNORE,
-      ok: `${eslintPath}: ignores містить ${AUTO_IMPORTS_IGNORE}`,
-      err: `${eslintPath}: додай у ignores запис ${AUTO_IMPORTS_IGNORE} (js.mdc)`,
-      reason: ESLINT_CONFIG_IGNORES
-    }
-  ]
-  for (const { needle, ok, err, reason } of checks) {
-    if (eslintRaw.includes(needle)) {
-      passFn(ok)
-    } else {
-      failFn(err, reason)
-    }
-  }
-  await checkEslintWorkspaceTypes(eslintRaw, eslintPath, passFn, failFn, cwd)
-}
-
-/**
- * Кожен vue-воркспейс (детекція: `workspaces` root package.json + vue-залежність
- * або `.vue` файли) має бути у `vue: [...]` аргументах getConfig — інакше eslint
- * не підключає vue-parser і всі `.vue` файли воркспейсу не парсяться. Ловить
- * хибний scaffold типу `getConfig({ node: ['npm'] })` у vue-монорепо.
- * @param {string} eslintRaw вміст eslint.config
- * @param {string} eslintPath ім'я файлу конфігу для повідомлень
- * @param {(msg: string) => void} passFn callback при успішній перевірці
- * @param {(msg: string, reason?: string) => void} failFn callback при помилці
- * @param {string} cwd корінь репозиторію
- */
-async function checkEslintWorkspaceTypes(eslintRaw, eslintPath, passFn, failFn, cwd) {
-  const types = await detectWorkspaceTypes(cwd)
-  if (types.vue.length === 0) return
-  const vueEntries = parseVueList(eslintRaw)
-  for (const ws of types.vue) {
-    if (vueEntries.includes(ws)) {
-      passFn(`${eslintPath}: vue-воркспейс '${ws}' у vue: [...]`)
-    } else {
-      failFn(
-        `${eslintPath}: воркспейс '${ws}' містить Vue-код, але відсутній у vue: [...] getConfig — ` +
-          '.vue файли не парсяться (js.mdc)',
-        ESLINT_CONFIG_VUE_WORKSPACE
-      )
-    }
-  }
-}
-
-// Перевірки `prettier` / `@nitra/prettier-config` у залежностях (text.mdc) і
-// `@nitra/eslint-config ≥ 3.10.0` тепер у Rego: відповідно
-// `npm/policy/text/package_json/` і `npm/policy/js_lint/package_json/`. Тут
-// лишилася лише workspace-ітерація для `type: "module"` і engines, бо js_lint
-// Rego запускається лише на кореневому `package.json`.
-
-/**
- * Перевіряє, що package.json має `"type": "module"`.
- * @param {string} label шлях або назва пакета для повідомлень
- * @param {{ type?: string }} pkg parsed package.json
- * @param {(msg: string) => void} passFn callback при успішній перевірці
- * @param {(msg: string) => void} failFn callback при помилці
- */
-function checkPackageJsonTypeModule(label, pkg, passFn, failFn) {
-  if (pkg.type === 'module') {
-    passFn(`${label}: "type": "module"`)
-  } else {
-    failFn(`${label}: має містити "type": "module" (js.mdc)`)
-  }
-}
-
-/**
- * `"type": "module"`, `engines.node >= 24` і `engines.bun >= 1.3` у кожному workspace `package.json`.
- * @param {unknown[]} workspaces поле workspaces з package.json
- * @param {(msg: string) => void} passFn callback при успішній перевірці
- * @param {(msg: string) => void} failFn callback при помилці
- * @param {string} cwd корінь репозиторію
- */
-async function checkWorkspacePackages(workspaces, passFn, failFn, cwd) {
-  for (const ws of workspaces) {
-    const wsPkgRel = `${ws}/package.json`
-    const wsPkgAbs = join(cwd, wsPkgRel)
-    if (existsSync(wsPkgAbs)) {
-      const wsPkg = JSON.parse(await readFile(wsPkgAbs, 'utf8'))
-      checkPackageJsonTypeModule(wsPkgRel, wsPkg, passFn, failFn)
-      checkEnginesNode(wsPkgRel, wsPkg, passFn, failFn)
-      checkEnginesBun(wsPkgRel, wsPkg, passFn, failFn)
-    }
-  }
-}
-
-/**
- * engines.node >= 24.
- * @param {string} label шлях або назва пакета для повідомлень
- * @param {{ engines?: { node?: string } }} pkg розпарсений package.json
- * @param {(msg: string) => void} passFn callback при успішній перевірці
- * @param {(msg: string) => void} failFn callback при помилці
- */
-function checkEnginesNode(label, pkg, passFn, failFn) {
-  const nodeEngine = pkg.engines?.node
-  if (nodeEngine) {
-    const firstNumeric = String(nodeEngine).split(NON_DIGITS_RE).find(Boolean)
-    if (firstNumeric && Number(firstNumeric) >= 24) {
-      passFn(`${label}: engines.node "${nodeEngine}"`)
-    } else {
-      failFn(`${label}: engines.node "${nodeEngine}" — має бути >=24`)
-    }
-  } else {
-    failFn(`${label} не містить engines.node — додай: "engines": { "node": ">=24" }`)
-  }
-}
-
-/**
- * engines.bun >= 1.3.
- * @param {string} label шлях або назва пакета для повідомлень
- * @param {{ engines?: { bun?: string } }} pkg розпарсений package.json
- * @param {(msg: string) => void} passFn callback при успішній перевірці
- * @param {(msg: string) => void} failFn callback при помилці
- */
-function checkEnginesBun(label, pkg, passFn, failFn) {
-  const bunEngine = pkg.engines?.bun
-  if (bunEngine) {
-    const [major, minor] = String(bunEngine).split(NON_DIGITS_RE).filter(Boolean).map(Number)
-    if (Number.isFinite(major) && Number.isFinite(minor) && (major > 1 || (major === 1 && minor >= 3))) {
-      passFn(`${label}: engines.bun "${bunEngine}"`)
-    } else {
-      failFn(`${label}: engines.bun "${bunEngine}" — має бути >=1.3`)
-    }
-  } else {
-    failFn(`${label} не містить engines.bun — додай: "engines": { "bun": ">=1.3" }`)
-  }
-}
-
-/**
- * Workspace-ітерація: для кожного workspace `package.json` перевіряємо
- * `type: "module"` і `engines.{node,bun}`. Кореневий `package.json` ці поля
- * валідує `npm/policy/js_lint/package_json/`; lint-js скрипт і `@nitra/eslint-config`
- * — теж у Rego.
- * @param {(msg: string) => void} passFn callback при успішній перевірці
- * @param {(msg: string) => void} failFn callback при помилці
- * @param {string} cwd корінь репозиторію
- */
-async function checkPackageJsonJsLint(passFn, failFn, cwd) {
-  const pkgPath = join(cwd, 'package.json')
-  if (!existsSync(pkgPath)) return
-  const pkg = JSON.parse(await readFile(pkgPath, 'utf8'))
-  const workspaces = Array.isArray(pkg.workspaces) ? pkg.workspaces : []
-  await checkWorkspacePackages(workspaces, passFn, failFn, cwd)
-}
-
-/**
- * Перевіряє .oxlintrc.json.
- * @param {(msg: string) => void} passFn callback при успішній перевірці
- * @param {(msg: string) => void} failFn callback при помилці
- * @param {string} cwd корінь репозиторію
- */
-async function checkOxlintRc(passFn, failFn, cwd) {
-  const oxPath = join(cwd, '.oxlintrc.json')
-  if (!existsSync(oxPath)) {
-    failFn('.oxlintrc.json не існує — додай конфіг oxlint (js.mdc)', OXLINTRC_MISSING)
-    return
-  }
-  let oxCfg
-  try {
-    oxCfg = JSON.parse(await readFile(oxPath, 'utf8'))
-  } catch {
-    failFn('.oxlintrc.json не є валідним JSON')
-    return
-  }
-  passFn('.oxlintrc.json існує')
-  let canonical
-  try {
-    canonical = JSON.parse(await readFile(OXLINT_CANONICAL_JSON_PATH, 'utf8'))
-  } catch {
-    failFn('внутрішня помилка: не вдалося прочитати канон oxlint з пакета @7n/rules')
-    return
-  }
-  const oxV = verifyOxlintRcAgainstCanonical(oxCfg, canonical)
-  if (oxV.ok) {
-    passFn('.oxlintrc.json збігається з каноном oxlint (@7n/rules)')
-  } else {
-    for (const msg of oxV.failures) {
-      failFn(msg, OXLINTRC_DRIFT)
-    }
-  }
-}
-
-/**
- * Cross-file перевірка: `lint.yml` (якщо існує) не дублює лінт JS-кроки з `lint-js.yml`.
- * Existence і структуру `lint-js.yml` валідує mixin-концерн `js/lint_js_yml`
- * плагіна `@7n/rules-ci-github` (провайдер-специфіка — поза ядром).
- * @param {(msg: string) => void} passFn callback при успішній перевірці
- * @param {(msg: string) => void} failFn callback при помилці
- * @param {string} cwd корінь репозиторію
- */
-async function checkLintJsWorkflows(passFn, failFn, cwd) {
-  // Existence/структуру lint-js.yml вимагає провайдер-плагін @7n/rules-ci-github
-  // (mixin js/lint_js_yml, policy required) — ядро провайдер-агностичне і тут
-  // перевіряє лише крос-файловий дубляж, коли GitHub-workflow уже існують.
-  const lintYmlPath = join(cwd, '.github/workflows/lint.yml')
-  if (existsSync(lintYmlPath)) {
-    const lintYml = await readFile(lintYmlPath, 'utf8')
-    if (lintYml.includes('bunx oxlint') && lintYml.includes('bunx eslint') && lintYml.includes('jscpd')) {
-      failFn('.github/workflows/lint.yml дублює кроки lint-js.yml — залиш один workflow на лінт JS (js.mdc)')
-    } else {
-      passFn('.github/workflows/lint.yml не дублює oxlint/eslint/jscpd з lint-js.yml')
-    }
-  }
-}
-
-/**
- * Перевіряє наявність `knip.json` у корені проєкту. Якщо файл відсутній —
- * копіює канонічний `knip-canonical.json` з пакета `@7n/rules` як стартовий
- * baseline; зміст подальших модифікацій локально не валідується (`entry` /
- * `project` / `ignore` / `ignoreDependencies` / `ignoreBinaries` дозволені
- * будь-які; це side effect — описано у js.mdc).
- * @param {(msg: string) => void} passFn callback при успішній перевірці
- * @param {(msg: string) => void} failFn callback при помилці
- * @param {string} cwd корінь репозиторію
- */
-async function checkKnipConfig(passFn, failFn, cwd) {
-  const knipPath = join(cwd, 'knip.json')
-  if (existsSync(knipPath)) {
-    passFn('knip.json існує')
-    return
-  }
-  if (!existsSync(KNIP_CANONICAL_JSON_PATH)) {
-    failFn(
-      `knip.json відсутній, і канонічний шаблон у пакеті не знайдено (${KNIP_CANONICAL_JSON_PATH}) — ` +
-        'перевстанови @7n/rules'
-    )
-    return
-  }
-  await copyFile(KNIP_CANONICAL_JSON_PATH, knipPath)
-  passFn('knip.json створено з канонічного npm/rules/js/tooling/data/tooling/knip-canonical.json (js.mdc)')
-}
-
-/**
- * Перевіряє відповідність проєкту правилам js.mdc
- * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст лінту
- * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} перелік порушень
- */
-export async function lint(ctx) {
-  const cwd = ctx.cwd
-  const reporter = createViolationReporter(ctx)
-  const { pass, fail } = reporter
-
-  await checkEslintConfig(pass, fail, cwd)
-  await checkPackageJsonJsLint(pass, fail, cwd)
-  await checkOxlintRc(pass, fail, cwd)
-  await checkLintJsWorkflows(pass, fail, cwd)
-  await checkKnipConfig(pass, fail, cwd)
-
-  for (const dup of ['.eslintrc', '.eslintrc.js', '.eslintrc.json', '.eslintrc.yml']) {
-    if (existsSync(join(cwd, dup))) fail(`Знайдено застарілий конфіг ESLint: ${dup} — видали, використовуй flat config`)
-  }
-
-  return reporter.result()
-}

package/rules/js/dep-policy/concern.json

@@ -1,4 +0,0 @@
-{
-  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
-  "lint": { "scope": "full", "glob": ["**/*.{js,mjs,cjs,jsx,ts,mts,cts,tsx}"] }
-}

package/rules/js/dep-policy/dep-policy.mdc

@@ -1,36 +0,0 @@
-## Залежнісна політика (що не додавати)
-
-`@e18e/eslint-plugin` окремо не додавай — він уже в залежностях `@nitra/eslint-config` (з **3.8.0**), oxlint підвантажує його з `node_modules`. Пакети `oxlint`/`eslint`/`jscpd`/`knip` теж не додавай у `devDependencies` без потреби монорепо — `bunx` тягне їх ad-hoc.
-
-### Заборона `ua-parser-js`
-
-Пакет **`ua-parser-js`** заборонений починаючи з версії **2.x**, де ліцензія змінилась з MIT на **AGPL-3.0** — несумісну з комерційним використанням у закритому SaaS. Замінити на **`bowser`** (MIT, ~6 KB gzip):
-
-```javascript title="❌ до"
-import { UAParser } from 'ua-parser-js'
-const parser = new UAParser(userAgent)
-const result = parser.getResult()
-const browserName = result.browser.name
-```
-
-```javascript title="✅ після"
-import Bowser from 'bowser'
-const browser = Bowser.getParser(userAgent)
-const browserName = browser.getBrowserName()
-```
-
-Bowser надає ті самі поля: `getBrowserName()`, `getOSName()`, `getPlatform().vendor`. Міграція займає кілька рядків; логіка не змінюється.
-
-### Заборона `@nitra/as-integrations-fastify`
-
-Пакет **`@nitra/as-integrations-fastify`** заборонений у **`dependencies`**, **`peerDependencies`** та в import-specifier-ах. Це чистий републіш upstream, застряглий на peer `@apollo/server: "^4.0.0"`, тож на Apollo 5 `bun install` дає `warn: incorrect peer dependency`. Заміна — upstream **`@as-integrations/fastify`** (**`^3.1.0`**): peer `@apollo/server: "^4.0.0 || ^5.0.0"` + `fastify: "^5.3.0"`.
-
-Міграція — лише specifier у трьох місцях: залежність у `package.json`, `import`, та `vi.mock(...)` / `await import(...)` у тестах. **Код не міняється**, експорти ті самі: `default` → `fastifyApollo`, named → `fastifyApolloDrainPlugin`.
-
-```javascript title="❌ до"
-import fastifyApollo, { fastifyApolloDrainPlugin } from '@nitra/as-integrations-fastify'
-```
-
-```javascript title="✅ після"
-import fastifyApollo, { fastifyApolloDrainPlugin } from '@as-integrations/fastify'
-```

package/rules/js/dep-policy/docs/main.md

@@ -1,35 +0,0 @@
----
-type: JS Module
-title: main.mjs
-resource: npm/rules/js/dep-policy/main.mjs
-docgen:
-  crc: 12ae4636
-  model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 100
-  issues: judge:inaccurate:0.98
-  judgeModel: openai-codex/gpt-5.4-mini
----
-
-## Огляд
-
-Файл сканує всі JS/TS-файли у поточному робочому каталозі, виключаючи конфігураційно визначені шляхи. Завдяки публічній функції main, він перевіряє відповідність усіх імпортів у коді політиці залежностей, визначеній у dep-policy.mdc. Ця **read-only** операція виявляє та фіксує будь-які імпорти, заборонені в dep-policy.mdc, надаючи підказки заміни з js.mdc. Механізм працює з fail-safe принципом, перехоплюючи помилки та не дозволяючи виняткам виходити назовні.
-
-## Поведінка
-
-Поведінка:
-
-1. Виконується функція main.
-2. Аналізуються всі JS/TS-файли у поточному робочому каталозі, виключаючи шляхи, визначені конфігурацією.
-3. Для кожного файлу витягуються всі імпорти (статичні, динамічні та виклики require).
-4. Знаходяться імпорти, які знаходяться у списку заборонених especifiers (dep-policy.mdc).
-5. Якщо знайдений імпорт заборонений, реєструється помилка, яка вказує на шлях до файлу, заборонений імпорт та підказку про його заміну (js.mdc).
-6. Після перевірки всіх файлів, якщо заборонених імпортів не знайдено, реєструється повідомлення про успішне завершення перевірки.
-
-## Публічний API
-
-main — перевіряє імпорти у файлах JavaScript та TypeScript на відповідність політиці залежностей.
-
-## Гарантії поведінки
-
-- Read-only: не виконує операцій запису (ФС/БД).
-- Перехоплює помилки і не пропускає винятків назовні (fail-safe).

package/rules/js/dep-policy/main.mjs

@@ -1,99 +0,0 @@
-/** @see ./docs/dep-policy.md */
-import { readFile } from 'node:fs/promises'
-import { relative } from 'node:path'
-
-import { parseSync } from 'oxc-parser'
-
-import { createViolationReporter } from '../../../scripts/lib/lint-surface/violation-reporter.mjs'
-import { loadCursorIgnorePaths } from '../../../scripts/lib/load-cursor-config.mjs'
-import { walkDir } from '../../../scripts/utils/walkDir.mjs'
-import {
-  dynamicImportModule,
-  langFromPath,
-  requireCallModule,
-  walkAstWithAncestors
-} from '../../../scripts/utils/ast-scan-utils.mjs'
-
-const JS_SOURCE_RE = /\.(?:[cm]?[jt]sx?)$/u
-
-/**
- * Пакети, заборонені як import-specifier у будь-якому JS/TS-файлі.
- * Ключ — specifier, значення — підказка про заміну.
- */
-const BANNED_SPECIFIERS = new Map([
-  ['@nitra/as-integrations-fastify', 'використовуй @as-integrations/fastify'],
-  [
-    'ua-parser-js',
-    'замінити на bowser (MIT, ~6 KB) — npm i bowser. ua-parser-js v2 змінив ліцензію на AGPL-3.0, несумісну з комерційним використанням'
-  ]
-])
-
-/**
- * Витягає з джерела всі import-specifier'и (static + dynamic + require).
- * @param {string} source текст файлу
- * @param {string} filePath шлях до файлу (для вибору мови OXC-парсера)
- * @returns {string[]} список specifier'ів
- */
-function extractImportSpecifiers(source, filePath) {
-  /** @type {string[]} */
-  const result = []
-  let parsed
-  try {
-    parsed = parseSync(filePath, source, { lang: langFromPath(filePath) })
-  } catch {
-    return result
-  }
-  for (const imp of parsed?.module?.staticImports ?? []) {
-    if (typeof imp?.moduleRequest?.value === 'string') result.push(imp.moduleRequest.value)
-  }
-  const program = parsed?.program
-  if (program && typeof program === 'object') {
-    walkAstWithAncestors(program, [], node => {
-      const dyn = dynamicImportModule(node)
-      if (dyn !== null) result.push(dyn)
-      const req = requireCallModule(node)
-      if (req !== null) result.push(req)
-    })
-  }
-  return result
-}
-
-/**
- * Сканує всі JS/TS-файли проєкту на заборонені import-specifier'и (dep-policy.mdc).
- * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст лінту
- * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} Результат лінту з переліком порушень.
- */
-export async function lint(ctx) {
-  const reporter = createViolationReporter(ctx)
-  const cwd = ctx.cwd
-  const ignorePaths = await loadCursorIgnorePaths(cwd)
-
-  const files = []
-  await walkDir(
-    cwd,
-    p => {
-      if (JS_SOURCE_RE.test(p)) files.push(p)
-    },
-    ignorePaths
-  )
-
-  let violations = 0
-  for (const absPath of files) {
-    const source = await readFile(absPath, 'utf8')
-    const specifiers = extractImportSpecifiers(source, absPath)
-    for (const spec of specifiers) {
-      const hint = BANNED_SPECIFIERS.get(spec)
-      if (hint !== undefined) {
-        const rel = relative(cwd, absPath)
-        reporter.fail(`${rel}: заборонений import '${spec}' — ${hint} (js.mdc dep-policy)`)
-        violations += 1
-      }
-    }
-  }
-
-  if (violations === 0) {
-    reporter.pass(`dep-policy: перевірено ${files.length} файлів — заборонених import-specifier'ів немає (js.mdc)`)
-  }
-
-  return reporter.result()
-}

package/rules/js/docs/index.md

@@ -1,11 +0,0 @@
----
-type: Directory Index
-title: npm/rules/js
-resource: npm/rules/js/
----
-
-# npm/rules/js
-
-| Файл                | Тип       |
-| ------------------- | --------- |
-| [main.mjs](main.md) | JS Module |

package/rules/js/eslint/concern.json

@@ -1,8 +0,0 @@
-{
-  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
-  "skipLocalTier": true,
-  "lint": {
-    "scope": "per-file",
-    "glob": ["**/*.{js,mjs,cjs,jsx,ts,tsx,vue}"]
-  }
-}

package/rules/js/eslint/docs/fix-eslint.md

@@ -1,50 +0,0 @@
----
-type: JS Module
-title: fix-eslint.mjs
-resource: npm/rules/js/eslint/fix-eslint.mjs
-docgen:
-  crc: 31afb96e
-  model: manual
----
-
-## Огляд
-
-T0-autofix для `js/eslint`, два патерни в порядку застосування. `js-eslint-autofix`:
-детермінований прогін лінтерів у fix-режимі (`oxlint --fix` + `eslint --fix`) по файлах, де
-детектор знайшов порушення — виправляє лише авто-fixable правила. `js-eslint-mechanical-text-fix`:
-для правил, які `--fix` НЕ покриває (suggestion-only у власній реалізації інструментів, перевірено
-емпірично на реальних lint-прогонах), але заміна на позначеному `data.line` текстуально однозначна
-й безпечна без AST-парсингу. Усе, що лишається непокритим — детектору на повторну перевірку, а
-далі LLM-ладдеру. Запис незворотний (поза rollback).
-
-## Поведінка
-
-`js-eslint-autofix`:
-- Збирає унікальні файли з порушень концерну, лишає лише js-сімейство (`.mjs/.cjs/.js/.jsx/.ts/.tsx/.vue`).
-- Послідовно застосовує `oxlint --fix` (CLI) і `eslint --fix` (через API з `outputFixes`).
-- До списку змінених потрапляють лише файли, чий вміст фактично змінився (порівняння до/після).
-
-`js-eslint-mechanical-text-fix`:
-- `MECHANICAL_TEXT_FIXES` — реєстр `{ reasons, replace }`: `reasons` покриває обидва формати
-  `violation.reason` (eslint `"plugin/rule"`, oxlint `"plugin(rule)"` — той самий rule різні тули
-  віддають по-різному); `replace(line)` — чиста функція рядка, `null` якщо шаблон не знайдено.
-- Групує порушення за файлом, для кожного цільового `data.line` (1-indexed) застосовує
-  відповідну `replace`; рядок без очікуваного шаблону (файл змінився з моменту detect-у) —
-  пропускається без гадання.
-- Наразі покриває `unicorn/prefer-number-is-safe-integer` (`Number.isInteger` → `Number.isSafeInteger`).
-
-## Публічний API
-
-- `patterns` — масив T0-патернів (`id` / `test` / `apply`), що його споживає центральний fix-pipeline:
-  `js-eslint-autofix` (лінтери в fix-режимі), `js-eslint-mechanical-text-fix` (текстові заміни для
-  suggestion-only правил).
-
-## Гарантії поведінки
-
-- `js-eslint-autofix`: якщо серед порушень немає js-файлів — лінтери не запускаються, змін немає.
-- `js-eslint-mechanical-text-fix`: пише лише файли з реальною зміною рядка (шаблон збігся); не
-  чіпає рядки поза `MECHANICAL_TEXT_FIXES`-реєстром.
-- Обидва патерни повертають лише фактично змінені файли; перед записом кожен реєструється через
-  `recordWrite`.
-- Межа CI: модуль належить fix-фазі; у `--no-fix` (CI) не запускається — узгоджено із
-  забороною `oxlint --fix`/`eslint --fix` у CI.

package/rules/js/eslint/docs/fix-worker.md

@@ -1,31 +0,0 @@
----
-type: JS Module
-title: fix-worker.mjs
-resource: npm/rules/js/eslint/fix-worker.mjs
-docgen:
-  crc: 802ef1f3
-  model: manual
----
-
-## Огляд
-
-Custom fix-worker `js/eslint` (перекриває дефолтний `default-worker.mjs`): замість одного `runAgentFix`-виклику з усіма порушеннями з усіх файлів concern-а — окрема агентна сесія на кожен файл, ПАРАЛЕЛЬНО (обмежений пул, не більше `MAX_PARALLEL_FILES`). Мотивація й еволюція дизайну — `docs/adr/260718-0754-js-eslint-fix-worker-per-session-overhead.md`: послідовна версія стабільно впиралась у timeout на всіх 4 rung-ах драбини (local-min→cloud-avg); профайлінг реального прогону показав, що домінує кількість/довжина раундів моделі на файл, а не фіксовані bootstrap-витрати сесії — тож паралелізм (кілька файлів одночасно замість черги) дає пряме пришвидшення незалежно від причини.
-
-## Поведінка
-
-1. Групує вхідні `violations` за `file`; порушення без `file` ігноруються.
-2. Дедлайн — `DEADLINE_FRACTION` (0.8) від `ctx.timeoutMs`; гейтить лише СТАРТ нового файлу з черги (не скасовує вже запущені).
-3. `runPooled` — обмежений пул воркерів (`MAX_PARALLEL_FILES=4`): при `files.length ≤ MAX_PARALLEL_FILES` усі файли стартують майже одночасно й отримують практично весь бюджет незалежно один від одного; при більшій кількості черга природно звужує бюджет пізніших хвиль (`callTimeoutMs` рахується в момент старту файлу з черги, не наперед).
-4. На кожен файл — окремий `runAgentFix` із `targetFiles: [file]` і власним `verify` (`verifyFile`): item-scoped canonical re-detect лише цього файлу, не всього concern-а — інакше evidence-гейт хибно вважав би файл незакритим через порушення в ІНШИХ файлах.
-5. Один файл, що завершився з `error` АБО кинув виняток (try/catch у тілі воркера), не обриває пул — пропускається, решта файлів обробляються незалежно.
-6. Повертає лише `touchedFiles` з успішних (`!error`) викликів; success rung-а все одно визначає whole-concern canonical re-detect runner-а (`runRung`), не цей worker.
-
-## Публічний API
-
-- `fixWorker(violations, ctx)` — контракт `FixWorkerFn`; резолвиться автоматично замість `default-worker.mjs`, бо лежить як `fix-worker.mjs` поруч із `main.mjs` concern-а.
-
-## Гарантії поведінки
-
-- Пише лише у файли з переданих `violations` (`targetFiles: [file]` на кожен виклик) — той самий semantic-collateral guard, що й у дефолтного worker-а.
-- `recordWrite` (не durable) на кожен файл: rollback-контракт незмінний — якщо після worker-а в concern-і лишилось хоч одне порушення будь-де, `runRung` відкочує ВСІ правки цього rung-а, включно з уже полагодженими файлами.
-- Конкурентні виклики `recordWrite` безпечні: central snapshot — синхронні Map-операції без `await` усередині, event loop не перериває їх посеред виконання.

package/rules/js/eslint/docs/index.md

@@ -1,11 +0,0 @@
----
-type: Directory Index
-title: npm/rules/js/eslint
-resource: npm/rules/js/eslint/
----
-
-| Файл                            | Тип       |
-| ------------------------------- | --------- |
-| [fix-eslint.mjs](fix-eslint.md) | JS Module |
-| [fix-worker.mjs](fix-worker.md) | JS Module |
-| [main.mjs](main.md)             | JS Module |

package/rules/js/eslint/docs/main.md

@@ -1,35 +0,0 @@
----
-type: JS Module
-title: main.mjs
-resource: npm/rules/js/eslint/main.mjs
-docgen:
-  crc: e831a6e8
-  model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 100
-  issues: judge:inaccurate:0.99
-  judgeModel: openai-codex/gpt-5.4-mini
----
-
-## Огляд
-
-Цей файл надає публічний інтерфейс для валідації коду, використовуючи інструменти Oxlint та ESLint. Він дозволяє визначати набір JavaScript-файлів для аналізу через функцію `filterJsFiles` та виконувати сам процес лінтингу за допомогою функції `lint`. Компонент є read-only, оскільки не здійснює змін до файлової системи чи баз даних. У разі виявлення помилок, механізм забезпечує fail-safe режим, перехоплюючи їх та не викликаючи винятків назовні.
-
-## Поведінка
-
-Поведінка:
-filterJsFiles фільтрує список вказаних файлів, залишаючи лише ті, що відповідають розширенням JavaScript.
-lint запускає лінтинг для файлів. Якщо передаються файли, він аналізує їх на наявність порушень; якщо не передані, він виконує повний аналіз проекту.
-
-## Публічний API
-
-filterJsFiles — відбирає файли для подальшої обробки.
-lint — проводить статичний аналіз коду (пофайлово або по всьому проєкту).
-
-## Гарантії поведінки
-
-- Read-only: не виконує операцій запису (ФС/БД).
-- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
-
-**warnIgnored: false.** ESLint конструюється з `warnIgnored: false` — файли з delta-списку, що матчать ignore-патерни `eslint.config.js` (наприклад, синковані `.pi/extensions/**` чи згенеровані `npm/types/**`), не рахуються порушеннями.
-
-**Worktree-чекаути ігноруються.** Обидва інструменти виключають `.worktrees/**` і `.claude/worktrees/**` (копії репо від сесійних git-worktree, яких споживацький конфіг зазвичай не виключає): ESLint — через global ignores у `overrideConfig`, oxlint — через `--ignore-pattern`. Діє і у full-режимі, і для явно переданих файлів.