@nitra/cursor 12.6.1 → 12.8.0

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

@@ -6,7 +6,7 @@ resource: npm/rules/image-compress/js/
 
 # npm/rules/image-compress/js
 
-| Файл | Тип |
-|---|---|
-| [lint.mjs](lint.md) | JS Module |
+| Файл                                  | Тип       |
+| ------------------------------------- | --------- |
+| [lint.mjs](lint.md)                   | JS Module |
 | [package_setup.mjs](package_setup.md) | JS Module |

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/fix.md

@@ -12,11 +12,11 @@ docgen:
 ## Поведінка
 
 1. Запуск правила.
-    *   Приймає контекст прогону.
-    *   Виконує застосування JS-занепокоєних.
-    *   Застосовує політику.
-    *   Генерує посилання MDC.
-    *   Повертає результат прогону.
+   - Приймає контекст прогону.
+   - Виконує застосування JS-занепокоєних.
+   - Застосовує політику.
+   - Генерує посилання MDC.
+   - Повертає результат прогону.
 
 ## Публічний API
 

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

@@ -6,6 +6,7 @@ resource: npm/rules/js-bun-db/
 
 # npm/rules/js-bun-db
 
-| Файл | Тип |
-|---|---|
-| [fix.mjs](fix.md) | JS Module |
+| Файл                | Тип       |
+| ------------------- | --------- |
+| [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/js/docs/index.md

@@ -6,6 +6,6 @@ resource: npm/rules/js-bun-db/js/
 
 # npm/rules/js-bun-db/js
 
-| Файл | Тип |
-|---|---|
+| Файл                    | Тип       |
+| ----------------------- | --------- |
 | [safety.mjs](safety.md) | JS Module |

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

@@ -6,6 +6,6 @@ resource: npm/rules/js-bun-db/lib/
 
 # npm/rules/js-bun-db/lib
 
-| Файл | Тип |
-|---|---|
+| Файл                                | Тип       |
+| ----------------------------------- | --------- |
 | [bun-sql-scan.mjs](bun-sql-scan.md) | JS Module |

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/fix.md

@@ -12,13 +12,13 @@ docgen:
 ## Поведінка
 
 1. Запуск правила.
-    *   Приймає контекст прогону.
-    *   Виконує пропуск через runStandardRule.
-    *   Повертає результат прогону.
+   - Приймає контекст прогону.
+   - Виконує пропуск через runStandardRule.
+   - Повертає результат прогону.
 2. Запуск у режимі CLI.
-    *   Виконується при запуску через CLI.
-    *   Виконує повний еквівалент `npx @nitra/cursor fix <id>`.
-    *   Встановлює код виходу процесу на результат runRuleCli.
+   - Виконується при запуску через CLI.
+   - Виконує повний еквівалент `npx @nitra/cursor fix <id>`.
+   - Встановлює код виходу процесу на результат runRuleCli.
 
 ## Публічний API
 

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

@@ -6,6 +6,7 @@ resource: npm/rules/js-bun-redis/
 
 # npm/rules/js-bun-redis
 
-| Файл | Тип |
-|---|---|
-| [fix.mjs](fix.md) | JS Module |
+| Файл                | Тип       |
+| ------------------- | --------- |
+| [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/js/docs/index.md

@@ -6,6 +6,6 @@ resource: npm/rules/js-bun-redis/js/
 
 # npm/rules/js-bun-redis/js
 
-| Файл | Тип |
-|---|---|
+| Файл                      | Тип       |
+| ------------------------- | --------- |
 | [imports.mjs](imports.md) | JS Module |

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

@@ -6,6 +6,6 @@ resource: npm/rules/js-bun-redis/lib/
 
 # npm/rules/js-bun-redis/lib
 
-| Файл | Тип |
-|---|---|
+| Файл                                  | Тип       |
+| ------------------------------------- | --------- |
 | [redis-imports.mjs](redis-imports.md) | JS Module |

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/fix.md

@@ -12,18 +12,18 @@ docgen:
 ## Поведінка
 
 1. Запуск правила.
-    *   Приймає контекст прогону.
-    *   Повертає результат прогону.
+   - Приймає контекст прогону.
+   - Повертає результат прогону.
 2. Виконання правила.
-    *   Викликає стандартне правило.
-    *   Використовує директорію модуля для прогону.
+   - Викликає стандартне правило.
+   - Використовує директорію модуля для прогону.
 3. Режим бібліотеки.
-    *   Викликається через оркестрацію CLI.
-    *   Використовує імпорт та функцію `run`.
+   - Викликається через оркестрацію CLI.
+   - Використовує імпорт та функцію `run`.
 4. Режим standalone.
-    *   Викликається через CLI.
-    *   Використовує `runRuleCli` для визначення коду виходу.
-    *   Виконує повний еквівалент команди `npx @nitra/cursor fix <id>`.
+   - Викликається через CLI.
+   - Використовує `runRuleCli` для визначення коду виходу.
+   - Виконує повний еквівалент команди `npx @nitra/cursor fix <id>`.
 
 ## Публічний API
 

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

@@ -6,6 +6,7 @@ resource: npm/rules/js-lint/
 
 # npm/rules/js-lint
 
-| Файл | Тип |
-|---|---|
-| [fix.mjs](fix.md) | JS Module |
+| Файл                | Тип       |
+| ------------------- | --------- |
+| [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: не виконує операцій запису (ФС/БД).