@nitra/cursor 12.6.0 → 12.7.0

package/rules/docker/lint/docs/lint.md

@@ -1,200 +0,0 @@
----
-type: JS Module
-title: lint.mjs
-resource: npm/rules/docker/lint/lint.mjs
-docgen:
-  crc: 98a98d10
----
-
-Модуль `npm/rules/docker/lint/lint.mjs` реалізує підкоманду `lint-docker` інструмента `n-cursor`. Її задача — знайти у дереві репозиторію канонічні Dockerfile-и та пропустити їх через `hadolint`, фіксуючи результат у форматі звіту `check-reporter` і виставляючи числовий код виходу.
-
-Особливості, що визначають поведінку:
-
-- Перевіряються **лише** файли з іменем, що рівне `Dockerfile` (регістр не важливий) та файли, ім’я яких закінчується на суфікс `.dockerfile` (наприклад, `app.Dockerfile`, `worker.dockerfile`). Файли виду `Dockerfile.dev`, `Containerfile` й інші варіанти, які бере `check-docker`, тут навмисно **не** обробляються.
-- Обхід дерева виконується тим самим `walkDir`, що й у `check-docker`, з тими самими пропусками каталогів (на основі `.cursorignore`/конфігу Cursor).
-- Виклик `hadolint` йде через `lintDockerfileWithHadolint` із `../lib/docker-hadolint.mjs` — інструмент шукається у `PATH` або запускається в Docker (`docker run`).
-- Серіалізація важкої CLI-команди (тільки один паралельний прогін на репозиторій і дедуплікація за станом git-дерева) виконана через `runStandardLint` — це канонічний патерн для `lint-*` команд згідно з `.cursor/rules/scripts.mdc`, секція «Серіалізація важких CLI-команд». Прямий `withLock` тут не використовується.
-- Запуск файла напряму через Node (`node lint.mjs`) працює як CLI: модуль ставить `process.exitCode` у код, повернений `runLintDocker`.
-
-## Експорти / API
-
-| Експорт                   | Вид                     | Призначення                                                                                    |
-| ------------------------- | ----------------------- | ---------------------------------------------------------------------------------------------- |
-| `isLintDockerfileName`    | `function`              | Перевіряє basename файла: чи входить він до набору `lint-docker`.                              |
-| `findLintDockerfilePaths` | `async function`        | Збирає відсортований список абсолютних шляхів придатних для `lint-docker` файлів.              |
-| `runLintDocker`           | `() => Promise<number>` | Публічна CLI-форма команди `lint-docker`: серіалізований прогон з кешуванням за станом дерева. |
-
-Внутрішня (не експортована) функція:
-
-- `runLintDockerSteps()` — самі кроки lint-у без обгортки локу й дедупу. Викликається `runStandardLint`.
-
-CLI-режим (`if (isRunAsCli(import.meta.url))`) при прямому запуску файла ставить `process.exitCode = await runLintDocker()`.
-
-## Функції
-
-### `isLintDockerfileName(name)`
-
-```js
-export function isLintDockerfileName(name): boolean
-```
-
-- **Параметри:**
-  - `name: string` — basename шляху (тобто лише ім’я файла, без каталогів).
-- **Повертає:** `boolean` — `true`, якщо файл підходить під набір `lint-docker`, інакше `false`.
-- **Логіка:**
-  1. Зводить ім’я до нижнього регістру (`n`).
-  2. Якщо `n === 'dockerfile'` — повертає `true`.
-  3. Інакше повертає `true`, лише якщо `n` закінчується на `.dockerfile` **і** довжина `n` строго більша за довжину суфікса `.dockerfile`. Завдяки цій додатковій умові саме `.dockerfile` (без префікса) — не валідний кейс.
-- **Side effects:** немає.
-- **Приклади:**
-  - `isLintDockerfileName('Dockerfile')` → `true`
-  - `isLintDockerfileName('dockerfile')` → `true`
-  - `isLintDockerfileName('app.Dockerfile')` → `true`
-  - `isLintDockerfileName('worker.dockerfile')` → `true`
-  - `isLintDockerfileName('.dockerfile')` → `false`
-  - `isLintDockerfileName('Dockerfile.dev')` → `false`
-  - `isLintDockerfileName('Containerfile')` → `false`
-
-### `findLintDockerfilePaths(root, ignorePaths = [])`
-
-```js
-export async function findLintDockerfilePaths(root, ignorePaths = []): Promise<string[]>
-```
-
-- **Параметри:**
-  - `root: string` — корінь обходу (зазвичай корінь репозиторію).
-  - `ignorePaths?: string[]` — абсолютні шляхи каталогів, повністю виключених з обходу (за замовчуванням пустий масив).
-- **Повертає:** `Promise<string[]>` — масив абсолютних шляхів придатних файлів, відсортований за `String.prototype.localeCompare` через `Array.prototype.toSorted` (не мутує проміжний масив).
-- **Логіка:**
-  1. Створює локальний акумулятор `out`.
-  2. Викликає `walkDir(root, visit, ignorePaths)`, де `visit(p)` додає `p` до `out`, якщо `isLintDockerfileName(basename(p))` істинне.
-  3. Повертає `out.toSorted((a, b) => a.localeCompare(b))`.
-- **Side effects:** виконує асинхронний обхід файлової системи через `walkDir`. Не пише нічого на диск і нічого не виводить у stdout/stderr.
-
-### `runLintDockerSteps()` _(internal)_
-
-```js
-async function runLintDockerSteps(): Promise<number>
-```
-
-- **Параметри:** немає.
-- **Повертає:** `Promise<number>` — `reporter.getExitCode()`: `0`, якщо помилок не зафіксовано, `1`, якщо хоча б один `fail`.
-- **Логіка:**
-  1. Створює репортер: `const reporter = createCheckReporter(); const { pass, fail } = reporter`.
-  2. Бере `root = process.cwd()`.
-  3. Завантажує `ignorePaths` через `await loadCursorIgnorePaths(root)`.
-  4. Шукає кандидатів: `files = await findLintDockerfilePaths(root, ignorePaths)`.
-  5. Якщо `files.length === 0` — викликає `pass('lint-docker: немає Dockerfile / *.Dockerfile — hadolint пропущено')` і повертає `reporter.getExitCode()`.
-  6. Інакше повідомляє `pass(\`lint-docker: файлів для hadolint: ${files.length}\`)`.
-  7. Для кожного абсолютного шляху `abs`:
-     - Обчислює відносний шлях `rel = posixRel(root, abs) || basename(abs)` — якщо `posixRel` повернула порожній рядок, береться лише basename.
-     - Викликає `const { ok, stdout, stderr, via } = lintDockerfileWithHadolint(root, abs)` (синхронний виклик, як видно з відсутності `await`).
-     - Об’єднує `stdout + stderr`, тримує (`trim()`) у `tail`.
-     - Якщо `ok` — `pass(\`${rel} (${via})\`)`.
-     - Якщо ні — формує `detail = tail ? \`:\n${tail}\` : ''` і викликає `fail(\`${rel} (${via})${detail}\`)`.
-  8. Повертає `reporter.getExitCode()`.
-- **Side effects:**
-  - Читає поточну робочу директорію (`process.cwd()`).
-  - Читає файлову систему репозиторію через `walkDir`/`loadCursorIgnorePaths`.
-  - Запускає зовнішній процес `hadolint` (через `PATH` або через `docker run`) для кожного знайденого Dockerfile.
-  - Пише повідомлення у консоль/звіт через `pass`/`fail` репортера.
-
-### `runLintDocker`
-
-```js
-export const runLintDocker = (): Promise<number> =>
-  runStandardLint(import.meta.dirname, runLintDockerSteps)
-```
-
-- **Параметри:** немає.
-- **Повертає:** `Promise<number>` — фінальний код виходу команди.
-- **Логіка:** делегує виконання у `runStandardLint`, передаючи:
-  - `import.meta.dirname` — каталог цього модуля (`npm/rules/docker/lint`); `runStandardLint` використовує його як ідентифікатор/корінь для серіалізації та для дедуплікації запусків за станом git-дерева;
-  - `runLintDockerSteps` — асинхронну функцію з фактичними кроками lint-у.
-- **Side effects:** усі побічні ефекти `runStandardLint` (взяття локу `lint-docker`, перевірка попереднього стану git, можливе пропускання запуску при ідентичному стані тощо) + усі ефекти `runLintDockerSteps`.
-
-### CLI-ентрі
-
-```js
-if (isRunAsCli(import.meta.url)) {
-  process.exitCode = await runLintDocker()
-}
-```
-
-- **Поведінка:** при прямому запуску модуля як Node-скрипта (`node npm/rules/docker/lint/lint.mjs` або у вигляді ESM bin) встановлює `process.exitCode` у значення, повернене `runLintDocker()`. Імпорт як модуля з іншого файла не активує цю гілку.
-- **Side effects:** мутує `process.exitCode`.
-
-## Залежності
-
-### Зовнішні (Node API)
-
-- `node:path` — використовується лише `basename` для виділення імені файла зі шляху.
-
-### Внутрішні модулі репозиторію
-
-| Імпорт                                        | Що з нього береться                      | Роль у цьому модулі                                                                         |
-| --------------------------------------------- | ---------------------------------------- | ------------------------------------------------------------------------------------------- |
-| `../../../scripts/cli-entry.mjs`              | `isRunAsCli`                             | Визначення, чи модуль запущено як CLI напряму.                                              |
-| `../lib/docker-hadolint.mjs`                  | `lintDockerfileWithHadolint`, `posixRel` | Власне виклик `hadolint` (через PATH або `docker run`) і обчислення POSIX-відносного шляху. |
-| `../../../scripts/lib/check-reporter.mjs`     | `createCheckReporter`                    | Створення репортера з методами `pass`/`fail` і фінальним `getExitCode`.                     |
-| `../../../scripts/lib/load-cursor-config.mjs` | `loadCursorIgnorePaths`                  | Завантаження списку каталогів, які потрібно ігнорувати під час обходу.                      |
-| `../../../scripts/utils/walkDir.mjs`          | `walkDir`                                | Асинхронний обхід дерева файлів з підтримкою списку ігнорувань.                             |
-| `../../../scripts/lib/run-standard-lint.mjs`  | `runStandardLint`                        | Канонічна обгортка `lint-*`-команд: лок, дедуп за станом git-дерева, уніфікований запуск.   |
-
-### Зовнішні CLI/інструменти, що викликаються опосередковано
-
-- `hadolint` — або з `PATH`, або через `docker run` (визначається в `lintDockerfileWithHadolint`).
-- Опосередковано — `git` (для обчислення стану дерева всередині `runStandardLint`), `docker` (якщо `hadolint` запускається в контейнері).
-
-## Потік виконання / Використання
-
-### Послідовність дій при `n-cursor lint docker`
-
-1. `bin/n-cursor.js` диспатчить правило `docker` на `npm/rules/docker/js/lint.mjs`, яке використовує `runLintDocker` із цього модуля.
-2. `runLintDocker` → `runStandardLint(import.meta.dirname, runLintDockerSteps)`:
-   - бере серіалізаційний лок на ім’я `lint-docker`;
-   - перевіряє стан git-дерева; якщо стан збігається з попереднім успішним прогоном — крок може бути пропущено (дедуп);
-   - інакше викликає `runLintDockerSteps`.
-3. `runLintDockerSteps`:
-   - читає `cwd`;
-   - завантажує `ignorePaths`;
-   - обходить дерево і збирає Dockerfile-кандидатів (тільки `Dockerfile` і `*.Dockerfile`/`*.dockerfile`);
-   - якщо нічого не знайдено — фіксує `pass` про пропуск і виходить;
-   - інакше повідомляє кількість файлів і по кожному викликає `lintDockerfileWithHadolint`;
-   - кожен результат маркується як `pass` або `fail` (з прикладеним хвостом `stdout`+`stderr`).
-4. Підсумковий `reporter.getExitCode()` повертається у `runStandardLint`, а той — у `runLintDocker`.
-5. При прямому запуску файла Node — код виходу пишеться у `process.exitCode`.
-
-### Як це використовується ззовні
-
-- **CLI:** `n-cursor lint docker` — основний сценарій.
-- **Програмно з інших скриптів:**
-
-  ```js
-  import { runLintDocker } from 'npm/rules/docker/lint/lint.mjs'
-
-  const code = await runLintDocker() // 0 — OK, 1 — є зауваження/помилки
-  ```
-
-- **Тести/допоміжний код:**
-
-  ```js
-  import { isLintDockerfileName, findLintDockerfilePaths } from 'npm/rules/docker/lint/lint.mjs'
-
-  isLintDockerfileName('Dockerfile') // true
-  isLintDockerfileName('app.Dockerfile') // true
-  isLintDockerfileName('Dockerfile.dev') // false
-
-  const files = await findLintDockerfilePaths(process.cwd(), [])
-  ```
-
-### Контракт коду виходу
-
-- `0` — або не знайдено Dockerfile-ів, або всі знайдені пройшли `hadolint`.
-- `1` — хоча б один файл не пройшов `hadolint` (або зафіксована інша помилка через `fail`).
-
-### Відмінності від `check-docker`
-
-- `check-docker` працює з ширшим набором імен (зокрема `Dockerfile.*`, `Containerfile` тощо).
-- `lint-docker` свідомо звужений до канонічного `Dockerfile` та суфікса `.dockerfile`, що відповідає правилу `docker.mdc` для самого hadolint-кроку.
-- Серіалізація `lint-docker` — через `runStandardLint`, а не через прямий `withLock`, як того вимагає `scripts.mdc`.

package/rules/docker/lint/lint.mjs

@@ -1,95 +0,0 @@
-/**
- * run-docker (скрипт lint-docker): hadolint лише для файлів з іменем Dockerfile та суфіксом .dockerfile (див. docker.mdc).
- *
- * Обхід дерева як у check-docker (walkDir, ті самі пропуски каталогів). На відміну від
- * check docker, не обробляються Dockerfile.*, Containerfile тощо — лише канонічне ім’я
- * Dockerfile та варіанти виду app.Dockerfile (регістр суфікса не важливий).
- *
- * Виклик hadolint — через ../js/lint/docker-hadolint.mjs (PATH або docker run).
- *
- * Канон патерну `lint-*` (серіалізація через `runStandardLint`, без прямого `withLock`) —
- * `.cursor/rules/scripts.mdc`, секція «Серіалізація важких CLI-команд».
- */
-import { basename } from 'node:path'
-
-import { isRunAsCli } from '../../../scripts/cli-entry.mjs'
-import { lintDockerfileWithHadolint, posixRel } from '../lib/docker-hadolint.mjs'
-import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
-import { loadCursorIgnorePaths } from '../../../scripts/lib/load-cursor-config.mjs'
-import { walkDir } from '../../../scripts/utils/walkDir.mjs'
-import { runStandardLint } from '../../../scripts/lib/run-standard-lint.mjs'
-
-/**
- * Чи входить файл до набору lint-docker: Dockerfile або *.Dockerfile (*.dockerfile).
- * @param {string} name basename шляху
- * @returns {boolean} true, якщо ім’я підходить під lint-docker
- */
-export function isLintDockerfileName(name) {
-  const n = name.toLowerCase()
-  if (n === 'dockerfile') return true
-  return n.endsWith('.dockerfile') && n.length > '.dockerfile'.length
-}
-
-/**
- * Збирає абсолютні шляхи для lint-docker.
- * @param {string} root корінь репозиторію
- * @param {string[]} [ignorePaths] абсолютні шляхи каталогів, повністю виключених з обходу
- * @returns {Promise<string[]>} відсортовані абсолютні шляхи
- */
-export async function findLintDockerfilePaths(root, ignorePaths = []) {
-  /** @type {string[]} */
-  const out = []
-  await walkDir(
-    root,
-    p => {
-      if (isLintDockerfileName(basename(p))) out.push(p)
-    },
-    ignorePaths
-  )
-  return out.toSorted((a, b) => a.localeCompare(b))
-}
-
-/**
- * Внутрішні кроки `lint-docker` без локу: hadolint по Dockerfile та *.Dockerfile.
- * @returns {Promise<number>} 0 — OK, 1 — зауваження або помилка
- */
-async function runLintDockerSteps() {
-  const reporter = createCheckReporter()
-  const { pass, fail } = reporter
-
-  const root = process.cwd()
-  const ignorePaths = await loadCursorIgnorePaths(root)
-  const files = await findLintDockerfilePaths(root, ignorePaths)
-
-  if (files.length === 0) {
-    pass('lint-docker: немає Dockerfile / *.Dockerfile — hadolint пропущено')
-    return reporter.getExitCode()
-  }
-
-  pass(`lint-docker: файлів для hadolint: ${files.length}`)
-
-  for (const abs of files) {
-    const rel = posixRel(root, abs) || basename(abs)
-    const { ok, stdout, stderr, via } = lintDockerfileWithHadolint(root, abs)
-    const tail = (stdout + stderr).trim()
-    if (ok) {
-      pass(`${rel} (${via})`)
-    } else {
-      const detail = tail ? `:\n${tail}` : ''
-      fail(`${rel} (${via})${detail}`)
-    }
-  }
-
-  return reporter.getExitCode()
-}
-
-/**
- * Публічна CLI-форма: серіалізує через `withLock('lint-docker')` + дедуп за станом git-дерева.
- * Експортовано як `runLintDocker` — використовується з `bin/n-cursor.js` як підкоманда `lint-docker`.
- * @returns {Promise<number>} код виходу
- */
-export const runLintDocker = () => runStandardLint(import.meta.dirname, runLintDockerSteps)
-
-if (isRunAsCli(import.meta.url)) {
-  process.exitCode = await runLintDocker()
-}

package/rules/efes/fix.mjs

@@ -1,18 +0,0 @@
-import { isRunAsCli, runRuleCli } from '../../scripts/lib/run-rule-cli.mjs'
-import { runStandardRule } from '../../scripts/lib/run-standard-rule.mjs'
-
-/**
- * Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
- * 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>/fix.mjs — повний еквівалент `npx @nitra/cursor fix <id>`
-  // (config-loading + whitelist + summary). Дві ролі fix.mjs: library (run) + standalone (main).
-  process.exitCode = await runRuleCli(import.meta.dirname)
-}

package/rules/feedback/fix.mjs

@@ -1,18 +0,0 @@
-import { isRunAsCli, runRuleCli } from '../../scripts/lib/run-rule-cli.mjs'
-import { runStandardRule } from '../../scripts/lib/run-standard-rule.mjs'
-
-/**
- * Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
- * 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>/fix.mjs — повний еквівалент `npx @nitra/cursor fix <id>`
-  // (config-loading + whitelist + summary). Дві ролі fix.mjs: library (run) + standalone (main).
-  process.exitCode = await runRuleCli(import.meta.dirname)
-}

package/rules/ga/fix.mjs

@@ -1,18 +0,0 @@
-import { isRunAsCli, runRuleCli } from '../../scripts/lib/run-rule-cli.mjs'
-import { runStandardRule } from '../../scripts/lib/run-standard-rule.mjs'
-
-/**
- * Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
- * 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>/fix.mjs — повний еквівалент `npx @nitra/cursor fix <id>`
-  // (config-loading + whitelist + summary). Дві ролі fix.mjs: library (run) + standalone (main).
-  process.exitCode = await runRuleCli(import.meta.dirname)
-}

package/rules/ga/js/docs/lint.md

@@ -1,20 +0,0 @@
----
-type: JS Module
-title: lint.mjs
-resource: npm/rules/ga/js/lint.mjs
-docgen:
-  crc: 428bf482
-  score: 100
----
-
-Делегує застосування правил зовнішньому інструменту командного рядка. Параметр `files` ігнорується, оскільки режим перевірки на рівні окремих файлів відсутній. Публічна функція `lint` повертає код виходу інструменту, який визначає успішність або невдачу перевірки.
-
-## Поведінка
-
-1. Викликає зовнішній інструмент для перевірки коду.
-2. Повертає код виходу цього інструменту.
-
-## Гарантії поведінки
-
-- Read-only: файл не виконує операцій запису у файлову систему.
-- Не звертається до мережі.

package/rules/ga/js/lint.mjs

@@ -1,12 +0,0 @@
-/**
- * Ci-крок ga: делегує у наявний CLI правила (per-file режиму немає — `files` ігнорується).
- */
-import { runLintGaCli } from '../lint/lint.mjs'
-
-/**
- * @param {string[] | undefined} _files ігнорується (whole-repo аналіз)
- * @returns {Promise<number>} exit code
- */
-export function lint(_files) {
-  return runLintGaCli()
-}

package/rules/ga/lint/docs/index.md

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

package/rules/ga/lint/docs/lint.md

@@ -1,31 +0,0 @@
----
-type: JS Module
-title: lint.mjs
-resource: npm/rules/ga/lint/lint.mjs
-docgen:
-  crc: c391782d
----
-
-Файл надає CLI-обгортку для інструменту `lint-ga`, який автоматично встановлює необхідні інструменти, такі як `shellcheck` та `conftest`, для перевірки коду. Він послідовно виконує перевірку коду за допомогою Rego та JavaScript, забезпечуючи узгодженість з правилами `ga.mdc`. Цей файл служить централізованим джерелом для виконання та налаштування процесу linting, що спрощує інтеграцію в CI/CD.
-
-## Поведінка
-
-1.  **Підготовка середовища:** Перевіряє наявність необхідних інструментів: `shellcheck` та `conftest`. Якщо їх немає, автоматично встановлює їх, щоб забезпечити коректну роботу.
-2.  **Перевірка залежностей:** Перевіряє наявність `uv`. Якщо `uv` відсутній, надає інструкції щодо його встановлення, щоб забезпечити виконання наступного етапу.
-3.  **Запуск попередньої перевірки:** Виконує попередню перевірку за допомогою `github-actionlint`, що дозволяє виявити проблеми на ранніх етапах.
-4.  **Виконання аналізу коду:** Запускає `uvx zizmor` для поглибленого аналізу коду, включаючи перевірку на відповідність стандартам та виявлення потенційних проблем.
-5.  **Перевірка Rego-полісів:** Запускає Rego-полісі з `npm/policy/ga/` для забезпечення відповідності коду політикам.
-6.  **Перевірка правил:** Виконує перевірку правил `ga.mdc` як для JS-коду, так і для Rego-полісів, забезпечуючи загальну відповідність стандартам.
-7.  **Звіт про результати:** Формує звіт про результати перевірки, що включає інформацію про виявлені проблеми та їх серйозність.
-8.  **Повернення статусу:** Повертає код завершення, що вказує на успішне виконання або наявність проблем, які потребують уваги.
-
-## Гарантії поведінки
-
-- `ensureTool` встановлює `shellcheck` та `conftest` згідно з обраним методом встановлення (brew, scoop, GitHub Release).
-- Якщо `uv` не встановлено, `uvx zizmor` завершується з помилкою.
-- `bunx github-actionlint` пропускає shell-перевірки в `run:` блоках, якщо `shellcheck` не вказаний у PATH.
-- `runLintGaCli` повертає `false` або `null` при помилках, не викликаючи виняток.
-- Не використовується кешування.
-- `uvx zizmor` вимагає наявності `uv`.
-- Логіка встановлення та запуску перевірок централізована у `rules/ga/fix.mjs`.
-- `runLintGaCli` використовується як підкоманда `lint-ga`.

package/rules/graphql/fix.mjs

@@ -1,18 +0,0 @@
-import { isRunAsCli, runRuleCli } from '../../scripts/lib/run-rule-cli.mjs'
-import { runStandardRule } from '../../scripts/lib/run-standard-rule.mjs'
-
-/**
- * Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
- * 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>/fix.mjs — повний еквівалент `npx @nitra/cursor fix <id>`
-  // (config-loading + whitelist + summary). Дві ролі fix.mjs: library (run) + standalone (main).
-  process.exitCode = await runRuleCli(import.meta.dirname)
-}

package/rules/hasura/fix.mjs

@@ -1,18 +0,0 @@
-import { isRunAsCli, runRuleCli } from '../../scripts/lib/run-rule-cli.mjs'
-import { runStandardRule } from '../../scripts/lib/run-standard-rule.mjs'
-
-/**
- * Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
- * 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>/fix.mjs — повний еквівалент `npx @nitra/cursor fix <id>`
-  // (config-loading + whitelist + summary). Дві ролі fix.mjs: library (run) + standalone (main).
-  process.exitCode = await runRuleCli(import.meta.dirname)
-}

package/rules/image-avif/fix.mjs

@@ -1,18 +0,0 @@
-import { isRunAsCli, runRuleCli } from '../../scripts/lib/run-rule-cli.mjs'
-import { runStandardRule } from '../../scripts/lib/run-standard-rule.mjs'
-
-/**
- * Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
- * 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>/fix.mjs — повний еквівалент `npx @nitra/cursor fix <id>`
-  // (config-loading + whitelist + summary). Дві ролі fix.mjs: library (run) + standalone (main).
-  process.exitCode = await runRuleCli(import.meta.dirname)
-}

package/rules/image-compress/fix.mjs

@@ -1,18 +0,0 @@
-import { isRunAsCli, runRuleCli } from '../../scripts/lib/run-rule-cli.mjs'
-import { runStandardRule } from '../../scripts/lib/run-standard-rule.mjs'
-
-/**
- * Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
- * 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>/fix.mjs — повний еквівалент `npx @nitra/cursor fix <id>`
-  // (config-loading + whitelist + summary). Дві ролі fix.mjs: library (run) + standalone (main).
-  process.exitCode = await runRuleCli(import.meta.dirname)
-}

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

@@ -1,24 +0,0 @@
----
-type: JS Module
-title: lint.mjs
-resource: npm/rules/image-compress/js/lint.mjs
----
-
-Адаптер підключає `@nitra/minify-image` до єдиної точки входу `n-cursor lint image-compress`.
-
-## Поведінка
-
-1. У fix-режимі запускає `npx @nitra/minify-image --src=. --write`.
-2. У read-only режимі запускає `npx @nitra/minify-image --src=. --json`.
-3. Парсить JSON-звіт і падає, якщо `summary.needsCompression > 0`.
-4. Повертає exit code дочірнього процесу або reporter exit code.
-
-## Публічний API
-
-`lint` — оркестраторний entrypoint для правила `image-compress`.
-
-## Гарантії поведінки
-
-- Read-only режим не стискає файли і не пише cache, покладаючись на `--json` detect-mode у `@nitra/minify-image`.
-- Fix-режим делегує запис тільки `@nitra/minify-image --write`.
-- За помилки запуску або невалідного JSON повертає ненульовий exit code.

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

@@ -1,18 +0,0 @@
-import { isRunAsCli, runRuleCli } from '../../scripts/lib/run-rule-cli.mjs'
-import { runStandardRule } from '../../scripts/lib/run-standard-rule.mjs'
-
-/**
- * Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
- * 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>/fix.mjs — повний еквівалент `npx @nitra/cursor fix <id>`
-  // (config-loading + whitelist + summary). Дві ролі fix.mjs: library (run) + standalone (main).
-  process.exitCode = await runRuleCli(import.meta.dirname)
-}

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

@@ -1,18 +0,0 @@
-import { isRunAsCli, runRuleCli } from '../../scripts/lib/run-rule-cli.mjs'
-import { runStandardRule } from '../../scripts/lib/run-standard-rule.mjs'
-
-/**
- * Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
- * 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>/fix.mjs — повний еквівалент `npx @nitra/cursor fix <id>`
-  // (config-loading + whitelist + summary). Дві ролі fix.mjs: library (run) + standalone (main).
-  process.exitCode = await runRuleCli(import.meta.dirname)
-}

package/rules/js-lint/fix.mjs

@@ -1,18 +0,0 @@
-import { isRunAsCli, runRuleCli } from '../../scripts/lib/run-rule-cli.mjs'
-import { runStandardRule } from '../../scripts/lib/run-standard-rule.mjs'
-
-/**
- * Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
- * 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>/fix.mjs — повний еквівалент `npx @nitra/cursor fix <id>`
-  // (config-loading + whitelist + summary). Дві ролі fix.mjs: library (run) + standalone (main).
-  process.exitCode = await runRuleCli(import.meta.dirname)
-}

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

@@ -1,32 +0,0 @@
----
-type: JS Module
-title: lint.mjs
-resource: npm/rules/js-lint/js/lint.mjs
-docgen:
-  crc: 1f38613e
-  score: 100
----
-
-filterJsFiles
-Перевіряє шляхи та повертає лише ті, що відповідають розширенням js-подібних файлів.
-
-lint
-Запускає інструмент для перевірки лінтування, працюючи з вибраними файлами або з усім проєктом.
-
-## Поведінка
-
-filterJsFiles
-Фільтрує список шляхів, повертаючи лише ті, що відповідають розширенням js-подібних файлів.
-
-lint
-Запускає інструмент для перевірки лінтування. Може працювати з вибраними файлами або з усім проєктом.
-
-## Публічний API
-
-filterJsFiles — відбирає лише файли з розширенням .js.
-lint — запускає oxlint та eslint з можливістю автоматичного виправлення помилок.
-
-## Гарантії поведінки
-
-- Read-only: файл не виконує операцій запису у файлову систему.
-- Не звертається до мережі.