@nitra/cursor 12.6.0 → 12.7.0

package/rules/image-compress/js/docs/package_setup.md

@@ -3,27 +3,28 @@ type: JS Module
 title: package_setup.mjs
 resource: npm/rules/image-compress/js/package_setup.mjs
 docgen:
-  crc: 13f6d8f3
-  score: 95
+  crc: 8a5453c6
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
 ---
 
-Файл виконує перевірку наявності та видалення кешу. Він зчитує рядки з `.gitignore`, перевіряє наявність кешу `HASH_CACHE_FILENAME` та видаляє застарілий кеш `LEGACY_CACHE_FILENAME`. Код перевіряє відповідність правилу, визначеного в (image-compress.mdc).
+Модуль виконує перевірку репозиторіїв за допомогою публічної функції `check`. Він перевіряє відповідність конфігурації, спираючись на `package.json`. Модуль також керує кешуванням результатів у межах одного прогону. Перевірка включає відповідність політикам, зокрема щодо файлів, що ігноруються, як описано в (image-compress.mdc).
 
 ## Поведінка
 
-1. Зчитування рядків з `.gitignore`
-2. Перевірка наявності кешу `HASH_CACHE_FILENAME` у `.gitignore`
-3. Перевірка видалення застарілого кешу `LEGACY_CACHE_FILENAME`
-4. Перевірка відповідності правилу `image-compress.mdc`
+1. Перевіряє наявність файлу `package.json` у корені репозиторію. Якщо файл відсутній, повідомляє про порушення (image-compress.mdc).
+2. Якщо `package.json` знайдено, повідомляє про відповідність політики залежностей.
+3. Перевіряє, чи не містить файл `.gitignore` запису про кеш `HASH_CACHE_FILENAME`. Якщо запис знайдено, повідомляє про порушення (image-compress.mdc).
+4. Перевіряє, чи відсутній застарілий кеш `LEGACY_CACHE_FILENAME` у корені репозиторію. Якщо файл знайдено, повідомляє про порушення (image-compress.mdc) та надає інструкції щодо його видалення.
+5. Якщо `LEGACY_CACHE_FILENAME` відсутній, перевіряє, чи не містить файл `.gitignore` запису про цей застарілий кеш. Якщо запис знайдено, повідомляє про порушення (image-compress.mdc).
+6. Повертає код виходу, що відображає загальний статус перевірки.
 
 ## Публічний API
 
-check — Перевіряє, чи відсутній у `.gitignore` файл `.n-minify-image.tsv` та чи видалено `.minify-image-cache.tsv`. Package-level стискання зображень виконує `n-cursor lint image-compress`, а read-only CI-gate використовує JSON detect-mode `@nitra/minify-image --json`. (image-compress.mdc)
+check — перевіряє, чи файл `.n-minify-image.tsv` не ігнорується у `.gitignore` та чи видалено застарілий `.minify-image-cache.tsv` відповідно до правил `image-compress.mdc`.
 
 ## Гарантії поведінки
 
-- Read-only: файл не виконує операцій запису у файлову систему.
-- За невдачі повертає значення помилки (`false`/`null`/`Err`) замість генерування винятку чи паніки.
+- Read-only: не виконує операцій запису (ФС/БД).
 - Кешує результати в межах одного прогону.
 - Свідомо пропускає шляхи: `.git`.
-- Не звертається до мережі.

package/rules/image-compress/{js/lint.mjs → main.mjs}

@@ -1,10 +1,21 @@
-/** @see ./docs/lint.md */
 import { spawnSync } from 'node:child_process'
 
-import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
+import { isRunAsCli, runRuleCli } from '../../scripts/lib/run-rule-cli.mjs'
+import { runStandardRule } from '../../scripts/lib/run-standard-rule.mjs'
+import { createCheckReporter } from '../../scripts/lib/check-reporter.mjs'
 
 const JSON_MAX_BUFFER = 20 * 1024 * 1024
 
+/**
+ * Єдиний entrypoint правила (ADR 2026-06-21). `run()` — check-поверхня (applies → JS-concerns
+ * → policy → mdc-refs); `lint()` — lint-поверхня (`@nitra/minify-image`), імпл інлайн тут.
+ * @param {import('../../scripts/lib/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону
+ * @returns {Promise<number>} 0 — OK, 1 — порушення
+ */
+export function run(ctx) {
+  return runStandardRule(import.meta.dirname, ctx)
+}
+
 /**
  * Парсить JSON-звіт `@nitra/minify-image --json`.
  * @param {string} stdout stdout дочірнього процесу
@@ -15,8 +26,8 @@ function parseMinifyJson(stdout) {
 }
 
 /**
- * Read-only detect-mode для `image-compress`: `@nitra/minify-image --json` не стискає файли і не
- * пише cache, але повідомляє скільки зображень не відповідають `.n-minify-image.tsv`.
+ * Read-only detect-mode: `@nitra/minify-image --json` не стискає файли і не пише cache, але
+ * повідомляє скільки зображень не відповідають `.n-minify-image.tsv`.
  * @param {string} cwd корінь
  * @returns {number} exit code
  */
@@ -61,7 +72,7 @@ function runJsonDetect(cwd) {
 }
 
 /**
- * Оркестраторний адаптер `n-cursor lint image-compress`.
+ * lint-поверхня: `@nitra/minify-image` (readOnly → `--json` детект; fix → `--write`).
  * @param {string[] | undefined} _files ігнорується; `@nitra/minify-image` сам обходить дерево
  * @param {string} [cwd] корінь
  * @param {{ readOnly?: boolean }} [opts] readOnly → `--json`, fix → `--write`
@@ -76,3 +87,8 @@ export function lint(_files, cwd = process.cwd(), opts = {}) {
   }
   return Promise.resolve(typeof r.status === 'number' ? r.status : 1)
 }
+
+if (isRunAsCli(import.meta.url)) {
+  // Standalone: bun rules/<id>/main.mjs — повний еквівалент `npx @nitra/cursor check <id>`.
+  process.exitCode = await runRuleCli(import.meta.dirname)
+}

package/rules/js-bun-db/docs/index.md

@@ -9,3 +9,4 @@ resource: npm/rules/js-bun-db/
 | Файл | Тип |
 |---|---|
 | [fix.mjs](fix.md) | JS Module |
+| [main.mjs](main.md) | JS Module |

package/rules/js-bun-db/docs/main.md

@@ -0,0 +1,30 @@
+---
+type: JS Module
+title: main.mjs
+resource: npm/rules/js-bun-db/main.mjs
+docgen:
+  crc: 762b6875
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 90
+---
+
+## Огляд
+
+Модуль виконує перевірку, застосовуючи правила та політики. При виклику публічної функції `run` він завантажує конфігурації, зокрема `meta.json`, застосовує білі списки та підбиває підсумки. Модуль є Read-only, тобто не пише у файлову систему чи базу даних. Під час роботи відбувається кешування даних у межах одного прогону. Результат перевірки визначає код виходу процесу.
+
+## Поведінка
+
+1. Викликається функція `run` для виконання перевірки.
+2. Виконання перевірки включає застосування правил, обробку JS-зацікавленостей, застосування політик та збір посилань MDC.
+3. Якщо код виконується як окрема програма (CLI), ініціюється повний запуск правила.
+4. Повний запуск правила включає завантаження конфігурацій (наприклад, `meta.json`), застосування білих списків та підбиття підсумків.
+5. Результат виконання визначає код виходу процесу.
+
+## Публічний API
+
+run — виконує основну логіку правила, включаючи перевірку відповідності вимогам, застосування політик та посилання на метадані.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).
+- Кешує результати в межах одного прогону.

package/rules/js-bun-db/main.mjs

@@ -0,0 +1,20 @@
+import { isRunAsCli, runRuleCli } from '../../scripts/lib/run-rule-cli.mjs'
+import { runStandardRule } from '../../scripts/lib/run-standard-rule.mjs'
+
+/**
+ * Єдиний entrypoint правила (ADR 2026-06-21). `run()` — check-поверхня: applies →
+ * JS-concerns → policy → mdc-refs (через runStandardRule). Lint-поверхні правило не має
+ * (`meta.json` без `lint`), тож експорту `lint` тут немає.
+ * Library mode: викликається CLI orchestration через `import + run(ctx)`.
+ * @param {import('../../scripts/lib/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
+ * @returns {Promise<number>} 0 — OK, 1 — порушення
+ */
+export function run(ctx) {
+  return runStandardRule(import.meta.dirname, ctx)
+}
+
+if (isRunAsCli(import.meta.url)) {
+  // Standalone: bun rules/<id>/main.mjs — повний еквівалент `npx @nitra/cursor check <id>`
+  // (config-loading + whitelist + summary): library-роль (run) + standalone-роль (CLI-блок).
+  process.exitCode = await runRuleCli(import.meta.dirname)
+}

package/rules/js-bun-redis/docs/index.md

@@ -9,3 +9,4 @@ resource: npm/rules/js-bun-redis/
 | Файл | Тип |
 |---|---|
 | [fix.mjs](fix.md) | JS Module |
+| [main.mjs](main.md) | JS Module |

package/rules/js-bun-redis/docs/main.md

@@ -0,0 +1,29 @@
+---
+type: JS Module
+title: main.mjs
+resource: npm/rules/js-bun-redis/main.mjs
+docgen:
+  crc: 762b6875
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+---
+
+## Огляд
+
+Виконує перевірку, застосовуючи правила, аналізуючи логіку JS-контекстів та перевіряючи політики на основі конфігурацій із meta.json. Збирає посилання MDC. Публічна функція run ініціює повний запуск, що включає завантаження конфігурацій, застосування білих списків та формування зведеного звіту. Операція є Read-only (не пише ФС/БД) та використовує кешування у межах прогону.
+
+## Поведінка
+
+1. Викликається функція `run` для виконання перевірки.
+2. Виконання перевірки включає застосування правил, обробку логіки JS-контекстів, перевірку політик та збір посилань MDC.
+3. Якщо код виконується як автономна програма (CLI), ініціюється повний запуск правила.
+4. Повний запуск правила включає завантаження конфігурацій, застосування білих списків та формування зведеного звіту.
+
+## Публічний API
+
+run — виконує основну логіку правила: перевіряє відповідність до вимог, застосовує логіку, пов'язану з JS-контекстом та політикою, а також перевіряє посилання на MDC.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).
+- Кешує результати в межах одного прогону.

package/rules/js-bun-redis/main.mjs

@@ -0,0 +1,20 @@
+import { isRunAsCli, runRuleCli } from '../../scripts/lib/run-rule-cli.mjs'
+import { runStandardRule } from '../../scripts/lib/run-standard-rule.mjs'
+
+/**
+ * Єдиний entrypoint правила (ADR 2026-06-21). `run()` — check-поверхня: applies →
+ * JS-concerns → policy → mdc-refs (через runStandardRule). Lint-поверхні правило не має
+ * (`meta.json` без `lint`), тож експорту `lint` тут немає.
+ * Library mode: викликається CLI orchestration через `import + run(ctx)`.
+ * @param {import('../../scripts/lib/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
+ * @returns {Promise<number>} 0 — OK, 1 — порушення
+ */
+export function run(ctx) {
+  return runStandardRule(import.meta.dirname, ctx)
+}
+
+if (isRunAsCli(import.meta.url)) {
+  // Standalone: bun rules/<id>/main.mjs — повний еквівалент `npx @nitra/cursor check <id>`
+  // (config-loading + whitelist + summary): library-роль (run) + standalone-роль (CLI-блок).
+  process.exitCode = await runRuleCli(import.meta.dirname)
+}

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

@@ -9,3 +9,4 @@ resource: npm/rules/js-lint/
 | Файл | Тип |
 |---|---|
 | [fix.mjs](fix.md) | JS Module |
+| [main.mjs](main.md) | JS Module |

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

@@ -0,0 +1,29 @@
+---
+type: JS Module
+title: main.mjs
+resource: npm/rules/js-lint/main.mjs
+docgen:
+  crc: 4f68b557
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+---
+
+## Огляд
+
+Модуль надає інструменти для аналізу кодової бази. Функція `run` ініціює повну перевірку проєкту. Функція `filterJsFiles` відбирає файли з розширенням JavaScript. Функція `lint` запускає лінтинг для виявлення порушень у коді.
+
+## Поведінка
+
+run виконує стандартну перевірку проєкту.
+filterJsFiles відбирає з наданого списку лише файли, що мають розширення, характерне для JavaScript.
+lint запускає лінтинг для вказаних файлів або всього проєкту, залежно від аргументів, і класифікує знайдені порушення.
+
+## Публічний API
+
+run — головна точка входу для виконання правил, що включає перевірку логіки (JS-завдання → політика → посилання MDC) та запуск лінтера.
+filterJsFiles — відбирає лише файли, що відповідають формату JavaScript.
+lint — виконує аналіз коду за допомогою oxlint та eslint, з можливістю автоматичного виправлення або лише виявлення проблем.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

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

@@ -8,7 +8,7 @@ resource: 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 |
 | [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: не виконує операцій запису (ФС/БД).