@nitra/cursor 12.6.1 → 12.8.0

package/rules/js-lint/js/check.mjs

@@ -0,0 +1,268 @@
+/** @see ./docs/tooling.md */
+import { existsSync } from 'node:fs'
+import { copyFile, readFile } from 'node:fs/promises'
+import { join } from 'node:path'
+
+import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
+
+import { KNIP_CANONICAL_JSON_PATH, OXLINT_CANONICAL_JSON_PATH, verifyOxlintRcAgainstCanonical } from './tooling.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-lint.mdc)')
+    return
+  }
+  const eslintRaw = await readFile(join(cwd, eslintPath), 'utf8')
+  const checks = [
+    {
+      needle: 'getConfig',
+      ok: `${eslintPath}: містить getConfig`,
+      err: `${eslintPath}: потрібен виклик getConfig (js-lint.mdc)`
+    },
+    {
+      needle: '@nitra/eslint-config',
+      ok: `${eslintPath}: імпорт @nitra/eslint-config`,
+      err: `${eslintPath}: імпортуй getConfig з @nitra/eslint-config`
+    },
+    {
+      needle: '**/auto-imports.d.ts',
+      ok: `${eslintPath}: ignores містить **/auto-imports.d.ts`,
+      err: `${eslintPath}: додай у ignores запис **/auto-imports.d.ts (js-lint.mdc)`
+    }
+  ]
+  for (const { needle, ok, err } of checks) {
+    if (eslintRaw.includes(needle)) {
+      passFn(ok)
+    } else {
+      failFn(err)
+    }
+  }
+}
+
+// Перевірки `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-lint.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-lint.mdc)')
+    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 з пакета @nitra/cursor')
+    return
+  }
+  const oxV = verifyOxlintRcAgainstCanonical(oxCfg, canonical)
+  if (oxV.ok) {
+    passFn('.oxlintrc.json збігається з каноном oxlint (@nitra/cursor)')
+  } else {
+    for (const msg of oxV.failures) {
+      failFn(msg)
+    }
+  }
+}
+
+/**
+ * FS-existence для `lint-js.yml` + cross-file перевірка, що `lint.yml` (якщо існує)
+ * не дублює лінт JS-кроки. Структуру `lint-js.yml` (`actions/checkout@v6`,
+ * `persist-credentials: false`, `setup-bun-deps`, `bunx oxlint/eslint/jscpd .`,
+ * заборона `--fix` у CI) валідує `npm/policy/js_lint/lint_js_yml/`.
+ * @param {(msg: string) => void} passFn callback при успішній перевірці
+ * @param {(msg: string) => void} failFn callback при помилці
+ * @param {string} cwd корінь репозиторію
+ */
+async function checkLintJsWorkflows(passFn, failFn, cwd) {
+  if (existsSync(join(cwd, '.github/workflows/lint-js.yml'))) {
+    passFn('.github/workflows/lint-js.yml є (структуру перевіряє npx @nitra/cursor fix → js_lint.lint_js_yml)')
+  } else {
+    failFn('.github/workflows/lint-js.yml не існує — створи його (js-lint.mdc)')
+  }
+
+  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-lint.mdc)')
+    } else {
+      passFn('.github/workflows/lint.yml не дублює oxlint/eslint/jscpd з lint-js.yml')
+    }
+  }
+}
+
+/**
+ * Перевіряє наявність `knip.json` у корені проєкту. Якщо файл відсутній —
+ * копіює канонічний `knip-canonical.json` з пакета `@nitra/cursor` як стартовий
+ * baseline; зміст подальших модифікацій локально не валідується (`entry` /
+ * `project` / `ignore` / `ignoreDependencies` / `ignoreBinaries` дозволені
+ * будь-які; це side effect — описано у js-lint.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}) — ` +
+        'перевстанови @nitra/cursor'
+    )
+    return
+  }
+  await copyFile(KNIP_CANONICAL_JSON_PATH, knipPath)
+  passFn('knip.json створено з канонічного npm/rules/js-lint/js/data/tooling/knip-canonical.json (js-lint.mdc)')
+}
+
+/**
+ * Перевіряє відповідність проєкту правилам js-lint.mdc
+ * @param {string} [cwd] корінь репозиторію
+ * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
+ */
+export async function check(cwd = process.cwd()) {
+  const reporter = createCheckReporter()
+  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.getExitCode()
+}

package/rules/js-lint/js/docs/check.md

@@ -0,0 +1,39 @@
+---
+type: JS Module
+title: check.mjs
+resource: npm/rules/js-lint/js/check.mjs
+docgen:
+  crc: f61768f2
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+---
+
+## Огляд
+
+Модуль виконує перевірку конфігураційних файлів проєкту, забезпечуючи їхню відповідність встановленим стандартам. Він читає та аналізує конфігураційні файли, включаючи `package.json`, `.oxlintrc.json`, `knip.json`, `knip-canonical.json` та `.eslintrc.json`. Перевірка ґрунтується на логіці, визначеній у (js-lint.mdc) та (text.mdc). Функціонал реалізований у режимі лише читання, що означає відсутність змін у файловій системі чи базах даних. При виявленні проблем, система перехоплює помилки, працюючи у режимі fail-safe. Свідомо ігноруються шляхи `.github` та `.git`.
+
+## Поведінка
+
+1. Викликає `check` для початку перевірки.
+2. Перевіряє наявність та відповідність конфігурації ESLint.
+3. Перевіряє конфігурацію `package.json` для всіх робочих просторів:
+   а. Перевіряє, чи має `package.json` `"type": "module"`.
+   б. Перевіряє, чи містить `package.json` `engines.node` з версією не менше 24.
+   в. Перевіряє, чи містить `package.json` `engines.bun` з версією не менше 1.3.
+4. Перевіряє конфігураційний файл `.oxlintrc.json` на відповідність канонічному шаблону.
+5. Перевіряє файли робочих процесів у `.github/workflows/`:
+   а. Перевіряє наявність `lint-js.yml`.
+   б. Перевіряє, чи не дублює `lint.yml` кроки лінтінгу JS.
+6. Перевіряє наявність файлу `knip.json` у корені проєкту. Якщо він відсутній, копіює канонічний шаблон.
+7. Перевіряє наявність застарілих конфігурацій ESLint (`.eslintrc`, `.eslintrc.js`, `.eslintrc.json`, `.eslintrc.yml`) та повідомляє про їхнє існування.
+8. Повертає код виходу, що відображає загальний статус перевірки.
+
+## Публічний API
+
+check — забезпечує відповідність проєкту вимогам, описаним у js-lint.mdc.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).
+- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
+- Свідомо пропускає шляхи: `.github`, `.git`.

package/rules/js-lint/js/docs/index.md

@@ -6,9 +6,9 @@ resource: npm/rules/js-lint/js/
 
 # npm/rules/js-lint/js
 
-| Файл | Тип |
-|---|---|
+| Файл                                  | Тип       |
+| ------------------------------------- | --------- |
+| [check.mjs](check.md)                 | JS Module |
 | [lint-findings.mjs](lint-findings.md) | JS Module |
-| [lint.mjs](lint.md) | JS Module |
-| [tooling.mjs](tooling.md) | JS Module |
+| [tooling.mjs](tooling.md)             | JS Module |
 | [utils_imports.mjs](utils_imports.md) | JS Module |

package/rules/js-lint/js/docs/tooling.md

@@ -3,47 +3,27 @@ type: JS Module
 title: tooling.mjs
 resource: npm/rules/js-lint/js/tooling.mjs
 docgen:
-  crc: e847996e
-  score: 80
+  crc: 7ead48ee
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 95
 ---
 
-OXLINT_CANONICAL_JSON_PATH
-Повертає шлях до канонічного JSON-файлу oxlint у пакету
+## Огляд
 
-KNIP_CANONICAL_JSON_PATH
-Повертає шлях до канонічного JSON-файлу knip у пакету
-
-verifyOxlintRcAgainstCanonical
-Звіряє блок rules з `.oxlintrc.json` проти канону пакета @nitra/cursor
-
-check
-Перевіряє конфігурацію проєкту відповідно до правил js-lint.mdc
+Визначає шляхи до канонічних конфігураційних файлів для oxlint та knip за допомогою OXLINT_CANONICAL_JSON_PATH та KNIP_CANONICAL_JSON_PATH. Дозволяє перевіряти відповідність конфігураційного файлу .oxlintrc.json до канонічного файлу oxlint-canonical.json за допомогою verifyOxlintRcAgainstCanonical.
 
 ## Поведінка
 
-OXLINT_CANONICAL_JSON_PATH
-Шлях до канонічного oxlint JSON у цьому пакеті
-
-KNIP_CANONICAL_JSON_PATH
-Шлях до канонічного knip JSON у цьому пакеті
-
-verifyOxlintRcAgainstCanonical
-Звіряє блок rules з `.oxlintrc.json` проти канону пакета @nitra/cursor
-
-check
-Перевіряє конфігурацію проєкту відповідно до правил js-lint.mdc
+OXLINT_CANONICAL_JSON_PATH — Вказує шлях до канонічного JSON-файлу oxlint у цьому пакеті.
+KNIP_CANONICAL_JSON_PATH — Вказує шлях до канонічного JSON-файлу knip у цьому пакеті.
+verifyOxlintRcAgainstCanonical — Перевіряє конфігураційний файл `.oxlintrc.json` на відповідність канонічному файлу oxlint-canonical.json, виявляючи відхилення у правилах та інших полях.
 
 ## Публічний API
 
-OXLINT_CANONICAL_JSON_PATH — Шлях до канонічного oxlint JSON у пакету (для перевірки та тестів)
-KNIP_CANONICAL_JSON_PATH — Шлях до канонічного knip JSON у пакету (копіюється у корінь проєкту-споживача, якщо відсутній)
-verifyOxlintRcAgainstCanonical — Порівнює `.oxlintrc.json` з каноном пакета `@nitra/cursor` (включає всі правила з канону та інші поля з `oxlint-canonical.json`). Дозволено додати лише ключі в `rules`; інші поля мають збігатися з каноном.
-check — Перевіряє відповідність проєкту правилам js-lint.mdc
+OXLINT_CANONICAL_JSON_PATH — Вказує розташування стандартного конфігураційного файлу oxlint для валідації.
+KNIP_CANONICAL_JSON_PATH — Вказує розташування стандартного конфігураційного файлу knip, який копіюється у кореневий каталог проєкту, якщо його там немає.
+verifyOxlintRcAgainstCanonical — Порівнює конфігураційний файл `.oxlintrc.json` з канонічним файлом пакета, вимагаючи збігу всіх полів, крім додаткових ключів у секції `rules`.
 
 ## Гарантії поведінки
 
-- Read-only: файл не виконує операцій запису у файлову систему.
-- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
-- За невдачі повертає значення помилки (`false`/`null`/`Err`) замість генерування винятку чи паніки.
-- Свідомо пропускає шляхи: `.github`, `.git`.
-- Не звертається до мережі.
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/js-lint/js/tooling.mjs

@@ -1,11 +1,7 @@
 /** @see ./docs/tooling.md */
-import { existsSync } from 'node:fs'
-import { copyFile, readFile } from 'node:fs/promises'
 import { dirname, join } from 'node:path'
 import { fileURLToPath } from 'node:url'
 
-import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
-
 /** Шлях до канонічного oxlint JSON у цьому пакеті (для перевірки та тестів). */
 export const OXLINT_CANONICAL_JSON_PATH = join(
   dirname(fileURLToPath(import.meta.url)),
@@ -22,15 +18,13 @@ export const KNIP_CANONICAL_JSON_PATH = join(
   'knip-canonical.json'
 )
 
-const NON_DIGITS_RE = /\D+/u
-
 // Канонічний рядок `lint-js`-скрипта і мінімальна версія `@nitra/eslint-config` —
 // у rego (`npm/policy/js_lint/package_json/`). JS-копії (`CANONICAL_LINT_JS`,
 // `isCanonicalLintJs`, `nitraEslintConfigMeetsMinVersion`) видалено, щоб не
 // було двох джерел істини й ризику дрифту.
 
 /**
- * Рекурсивне порівняння фрагментів канону oxlint (масиви — порядок як у каноні; об’єкти — той самий набір ключів і вкладеність).
+ * Рекурсивне порівняння фрагментів канону oxlint (масиви — порядок як у каноні; об'єкти — той самий набір ключів і вкладеність).
  * @param {unknown} actual значення з `.oxlintrc.json`
  * @param {unknown} expected значення з канону
  * @returns {boolean} true, якщо значення збігаються за правилами канону
@@ -154,261 +148,3 @@ export function verifyOxlintRcAgainstCanonical(cfg, canonical) {
 
   return { ok: failures.length === 0, failures }
 }
-
-/**
- * Перевіряє 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-lint.mdc)')
-    return
-  }
-  const eslintRaw = await readFile(join(cwd, eslintPath), 'utf8')
-  const checks = [
-    {
-      needle: 'getConfig',
-      ok: `${eslintPath}: містить getConfig`,
-      err: `${eslintPath}: потрібен виклик getConfig (js-lint.mdc)`
-    },
-    {
-      needle: '@nitra/eslint-config',
-      ok: `${eslintPath}: імпорт @nitra/eslint-config`,
-      err: `${eslintPath}: імпортуй getConfig з @nitra/eslint-config`
-    },
-    {
-      needle: '**/auto-imports.d.ts',
-      ok: `${eslintPath}: ignores містить **/auto-imports.d.ts`,
-      err: `${eslintPath}: додай у ignores запис **/auto-imports.d.ts (js-lint.mdc)`
-    }
-  ]
-  for (const { needle, ok, err } of checks) {
-    if (eslintRaw.includes(needle)) {
-      passFn(ok)
-    } else {
-      failFn(err)
-    }
-  }
-}
-
-// Перевірки `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-lint.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-lint.mdc)')
-    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 з пакета @nitra/cursor')
-    return
-  }
-  const oxV = verifyOxlintRcAgainstCanonical(oxCfg, canonical)
-  if (oxV.ok) {
-    passFn('.oxlintrc.json збігається з каноном oxlint (@nitra/cursor)')
-  } else {
-    for (const msg of oxV.failures) {
-      failFn(msg)
-    }
-  }
-}
-
-/**
- * FS-existence для `lint-js.yml` + cross-file перевірка, що `lint.yml` (якщо існує)
- * не дублює лінт JS-кроки. Структуру `lint-js.yml` (`actions/checkout@v6`,
- * `persist-credentials: false`, `setup-bun-deps`, `bunx oxlint/eslint/jscpd .`,
- * заборона `--fix` у CI) валідує `npm/policy/js_lint/lint_js_yml/`.
- * @param {(msg: string) => void} passFn callback при успішній перевірці
- * @param {(msg: string) => void} failFn callback при помилці
- * @param {string} cwd корінь репозиторію
- */
-async function checkLintJsWorkflows(passFn, failFn, cwd) {
-  if (existsSync(join(cwd, '.github/workflows/lint-js.yml'))) {
-    passFn('.github/workflows/lint-js.yml є (структуру перевіряє npx @nitra/cursor fix → js_lint.lint_js_yml)')
-  } else {
-    failFn('.github/workflows/lint-js.yml не існує — створи його (див. rules/js-lint/fix.mjs / js-lint.mdc)')
-  }
-
-  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-lint.mdc)')
-    } else {
-      passFn('.github/workflows/lint.yml не дублює oxlint/eslint/jscpd з lint-js.yml')
-    }
-  }
-}
-
-/**
- * Перевіряє наявність `knip.json` у корені проєкту. Якщо файл відсутній —
- * копіює канонічний `knip-canonical.json` з пакета `@nitra/cursor` як стартовий
- * baseline; зміст подальших модифікацій локально не валідується (`entry` /
- * `project` / `ignore` / `ignoreDependencies` / `ignoreBinaries` дозволені
- * будь-які; це side effect — описано у js-lint.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}) — ` +
-        'перевстанови @nitra/cursor'
-    )
-    return
-  }
-  await copyFile(KNIP_CANONICAL_JSON_PATH, knipPath)
-  passFn('knip.json створено з канонічного npm/rules/js-lint/js/data/tooling/knip-canonical.json (js-lint.mdc)')
-}
-
-/**
- * Перевіряє відповідність проєкту правилам js-lint.mdc
- * @param {string} [cwd] корінь репозиторію
- * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
- */
-export async function check(cwd = process.cwd()) {
-  const reporter = createCheckReporter()
-  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.getExitCode()
-}