@nitra/cursor 12.7.0 → 12.8.1

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

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

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

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

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

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

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

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

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

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

package/rules/js-mssql/lib/docs/index.md

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

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

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

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

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

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

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

package/rules/js-run/lib/docs/index.md

@@ -6,11 +6,11 @@ resource: npm/rules/js-run/lib/
 
 # npm/rules/js-run/lib
 
-| Файл | Тип |
-|---|---|
-| [bunyan-imports.mjs](bunyan-imports.md) | JS Module |
-| [check-env-scan.mjs](check-env-scan.md) | JS Module |
-| [conn-file-rules.mjs](conn-file-rules.md) | JS Module |
-| [conn-imports-scan.mjs](conn-imports-scan.md) | JS Module |
+| Файл                                                      | Тип       |
+| --------------------------------------------------------- | --------- |
+| [bunyan-imports.mjs](bunyan-imports.md)                   | JS Module |
+| [check-env-scan.mjs](check-env-scan.md)                   | JS Module |
+| [conn-file-rules.mjs](conn-file-rules.md)                 | JS Module |
+| [conn-imports-scan.mjs](conn-imports-scan.md)             | JS Module |
 | [promise-settimeout-scan.mjs](promise-settimeout-scan.md) | JS Module |
-| [temporal-scan.mjs](temporal-scan.md) | JS Module |
+| [temporal-scan.mjs](temporal-scan.md)                     | JS Module |

package/rules/k8s/docs/fix.md

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

package/rules/k8s/docs/index.md

@@ -6,7 +6,7 @@ resource: npm/rules/k8s/
 
 # npm/rules/k8s
 
-| Файл | Тип |
-|---|---|
-| [fix.mjs](fix.md) | JS Module |
+| Файл                | Тип       |
+| ------------------- | --------- |
+| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

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

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

package/rules/nginx-default-tpl/docs/fix.md

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

package/rules/nginx-default-tpl/docs/index.md

@@ -6,7 +6,7 @@ resource: npm/rules/nginx-default-tpl/
 
 # npm/rules/nginx-default-tpl
 
-| Файл | Тип |
-|---|---|
-| [fix.mjs](fix.md) | JS Module |
+| Файл                | Тип       |
+| ------------------- | --------- |
+| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

package/rules/nginx-default-tpl/js/docs/index.md

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

package/rules/nginx-default-tpl/js/docs/template.md

@@ -39,11 +39,11 @@ check
 
 findDefaultConfTemplatePaths — Збирає повні шляхи до **default.conf.template** у репозиторії; виключає будь-який сегмент `fixtures/` (включаючи `tests/fixtures/` та ко-локальні шляхи `rules/<rule>/js/<concern>/fixtures/`).
 migrateDefaultTplConfFiles — Знаходить **default.tpl.conf** у дереві від `root`. Якщо **default.conf.template** відсутній, перейменовує **default.tpl.conf**; якщо він присутній, перезаписує **default.conf.template** вмістом **default.tpl.conf** та видаляє **default.tpl.conf**.
-migrateErrorLogOffDirective — Замінює невалідну директиву `error_log off;` на `error_log /dev/null crit;` у всіх **default.conf.template** від `root**. `error_log off;` трактується як ім'я файлу (`/etc/nginx/off`), що призводить до помилки `readOnlyRootFilesystem`. `/dev/null` — це записуваний пристрій.
+migrateErrorLogOffDirective — Замінює невалідну директиву `error_log off;` на `error_log /dev/null crit;` у всіх **default.conf.template** від `root**. `error_log off;` трактується як ім'я файлу (`/etc/nginx/off`), що призводить до помилки `readOnlyRootFilesystem`. `/dev/null`— це записуваний пристрій.
 parseIniVariableNames — Витягує імена змінних з файлів ini (рядки у форматі KEY=value, без коментарів і порожніх).
 nginxTemplateViolations — Перевіряє вміст **default.conf.template** на відповідність вимогам **nginx-default-tpl.mdc**.
 httpRouteMatchesNginxDefaultTpl — Перевіряє, чи відповідає **HTTPRoute** патерну Exact→RequestRedirect + PathPrefix→backendRefs.
-iniKeysMissingInTemplate — Перевіряє, чи входять усі імена ключів з ini до шаблону у форматі `$KEY` (використовуючи envsubst).
+iniKeysMissingInTemplate — Перевіряє, чи входять усі імена ключів з ini до шаблону у форматі`$KEY` (використовуючи envsubst).
 check — Перевіряє відповідність проєкту правилам **nginx-default-tpl.mdc**.
 
 ## Гарантії поведінки

package/rules/npm-module/docs/fix.md

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

package/rules/npm-module/docs/index.md

@@ -6,7 +6,7 @@ resource: npm/rules/npm-module/
 
 # npm/rules/npm-module
 
-| Файл | Тип |
-|---|---|
-| [fix.mjs](fix.md) | JS Module |
+| Файл                | Тип       |
+| ------------------- | --------- |
+| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

package/rules/npm-module/js/docs/header_doc_pointer.md

@@ -3,28 +3,38 @@ type: JS Module
 title: header_doc_pointer.mjs
 resource: npm/rules/npm-module/js/header_doc_pointer.mjs
 docgen:
-  crc: d96a2957
+  crc: 90fc46dc
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
 
-Файл виконує перевірку документації для модулів. Сканує директорії npm/rules та npm/skills. Перевіряє наявність файлів docs/<stem>.md у піддиректоріях правил/скілів. Перевіряє, чи містить відповідні js-файли не більше одного рядка JSDoc. У разі перевищення ліміту, генерує звіт про порушення.
+## Огляд
+
+Модуль валідує відповідність контракту документації для файлів `.mjs` у сегментах `npm/rules` та `npm/skills`. Він виявляє порушення, якщо для файлу `.mjs` існує відповідний файл `docs/<ім'я>.md`, а його JSDoc-блок містить більше одного непорожнього рядка.
 
 ## Поведінка
 
-1. Сканувати директорії npm/rules та npm/skills.
-2. Для кожної директорії перевіряти піддиректорії правил/скілів.
-3. Для кожного знайденого js-файлу перевіряти наявність файлу docs/<stem>.md.
-4. Якщо файл docs/<stem>.md існує, перевіряти, чи містить module-level JSDoc не більше одного непорожного рядка.
-5. У разі перевищення ліміту, зарепортувати порушення.
-6. Повертати код виходу репортера.
+1. Викликається функція check з корінням репозиторію як аргументом.
+2. Ініціалізується репортер для фіксації порушень.
+3. Для кожного з сегментів 'npm/rules' та 'npm/skills' виконується наступне:
+   а. Перевіряється існування відповідного базового сегмента.
+   б. Для кожного підсегмента (правила/скіла) у базовому сегменті:
+   i. Перевіряється існування каталогу `js/` у підсегменті.
+   ii. Для кожного файлу `.mjs` у каталозі `js/`:
+   а. Перевіряється, чи є файл звичайним вихідним файлом (не тест).
+   б. Визначається ім'я без розширення файлу.
+   в. Перевіряється існування файлу `docs/<ім'я>.md` у каталозі `js/docs/`.
+   г. Якщо файл `docs/<ім'я>.md` існує:
+   i. Зчитується вміст файлу `.mjs`.
+   ii. Визначається перша не-жадібна JSDoc-блока в файлі.
+   iii. Підраховується кількість непорожніх рядків у тілі цього JSDoc-блока.
+   iv. Якщо кількість непорожніх рядків перевищує 1, фіксується порушення, оскільки `docs/<ім'я>.md` вже описує поведінку, а JSDoc має бути лише вказівником.
+4. Повертається код виходу репортера.
 
 ## Публічний API
 
-- check — сканує файли `npm/rules/*/js/*.mjs` та `npm/skills/*/js/*.mjs`.
-  - Якщо існує `docs/<stem>.md`, модуль повинен мати посилання на JSDoc (не наратив).
-  - Якщо `docs` відсутній, обмеження не застосовуються.
+check — перевіряє файли `.mjs` у директоріях `npm/rules/*\/js/` та `npm/skills/*\/js/`. Якщо поруч є відповідний файл `docs/<stem>.md`, вимагає, щоб JSDoc на рівні модуля був посиланням (не описом); якщо `docs` відсутній, обмежень немає.
 
 ## Гарантії поведінки
 
-- Read-only: файл не виконує операцій запису у файлову систему.
-- Не звертається до мережі.
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/npm-module/js/docs/index.md

@@ -6,9 +6,9 @@ resource: npm/rules/npm-module/js/
 
 # npm/rules/npm-module/js
 
-| Файл | Тип |
-|---|---|
+| Файл                                            | Тип       |
+| ----------------------------------------------- | --------- |
 | [header_doc_pointer.mjs](header_doc_pointer.md) | JS Module |
-| [package_structure.mjs](package_structure.md) | JS Module |
-| [rule_meta.mjs](rule_meta.md) | JS Module |
-| [skill_meta.mjs](skill_meta.md) | JS Module |
+| [package_structure.mjs](package_structure.md)   | JS Module |
+| [rule_meta.mjs](rule_meta.md)                   | JS Module |
+| [skill_meta.mjs](skill_meta.md)                 | JS Module |

package/rules/npm-module/js/docs/rule_meta.md

@@ -17,12 +17,12 @@ docgen:
 1. Викликати `check` для початку валідації.
 2. Перевірити наявність каталогу `npm/rules` у корені репозиторію. Якщо каталог відсутній, валідація завершується успішно.
 3. Для кожного підкаталогу у `npm/rules` (який представляє правило):
-    а. Перевірити наявність файлу `auto.md`. Якщо він присутній, реєструється помилка, оскільки метадані тепер знаходяться у `meta.json`.
-    б. Перевірити наявність файлу `<id>.mdc` у каталозі правила. Якщо він відсутній, реєструється помилка, оскільки це обов'язковий файл (scripts.mdc).
-    в. Зчитати вміст `meta.json` правила. Якщо файл відсутній або невалідний, реєструється помилка, і перевірка цього правила припиняється.
-    г. Перевірити поле `auto` у `meta.json`. Якщо поле `auto` присутнє, воно повинно бути валідним (відповідати одному з визначених форматів, або бути відсутнім). Якщо поле `auto` містить невідомий предикат, реєструється помилка.
-    ґ. Перевірити поле `lint` у `meta.json`. Якщо поле `lint` присутнє, воно повинно бути валідним (відповідати "per-file" або "full"). Також перевіряється, чи експортує файл `main.mjs` у каталозі правила функцію `lint` відповідно до зазначеного значення `lint`.
-    і. Якщо всі перевірки для правила пройшли успішно, реєструється повідомлення про валідність `meta.json`.
+   а. Перевірити наявність файлу `auto.md`. Якщо він присутній, реєструється помилка, оскільки метадані тепер знаходяться у `meta.json`.
+   б. Перевірити наявність файлу `<id>.mdc` у каталозі правила. Якщо він відсутній, реєструється помилка, оскільки це обов'язковий файл (scripts.mdc).
+   в. Зчитати вміст `meta.json` правила. Якщо файл відсутній або невалідний, реєструється помилка, і перевірка цього правила припиняється.
+   г. Перевірити поле `auto` у `meta.json`. Якщо поле `auto` присутнє, воно повинно бути валідним (відповідати одному з визначених форматів, або бути відсутнім). Якщо поле `auto` містить невідомий предикат, реєструється помилка.
+   ґ. Перевірити поле `lint` у `meta.json`. Якщо поле `lint` присутнє, воно повинно бути валідним (відповідати "per-file" або "full"). Також перевіряється, чи експортує файл `main.mjs` у каталозі правила функцію `lint` відповідно до зазначеного значення `lint`.
+   і. Якщо всі перевірки для правила пройшли успішно, реєструється повідомлення про валідність `meta.json`.
 4. Після обробки всіх правил, повертається код виходу, що відображає загальний статус валідації.
 
 ## Публічний API

package/rules/npm-module/js/header_doc_pointer.mjs

@@ -47,9 +47,7 @@ function moduleJsDoc(source) {
  * @returns {boolean} true для звичайних source-файлів
  */
 function isSourceMjs(fileEntry) {
-  return (
-    fileEntry.isFile() && fileEntry.name.endsWith('.mjs') && !fileEntry.name.endsWith('.test.mjs')
-  )
+  return fileEntry.isFile() && fileEntry.name.endsWith('.mjs') && !fileEntry.name.endsWith('.test.mjs')
 }
 
 /**

package/rules/php/docs/fix.md

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

package/rules/php/docs/index.md

@@ -6,7 +6,7 @@ resource: npm/rules/php/
 
 # npm/rules/php
 
-| Файл | Тип |
-|---|---|
-| [fix.mjs](fix.md) | JS Module |
+| Файл                | Тип       |
+| ------------------- | --------- |
+| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

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

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

package/rules/python/docs/fix.md

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

package/rules/python/docs/index.md

@@ -6,7 +6,7 @@ resource: npm/rules/python/
 
 # npm/rules/python
 
-| Файл | Тип |
-|---|---|
-| [fix.mjs](fix.md) | JS Module |
+| Файл                | Тип       |
+| ------------------- | --------- |
+| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

package/rules/python/docs/main.md

@@ -3,28 +3,28 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/python/main.mjs
 docgen:
-  crc: 8ceba96a
+  crc: d8a3aa1f
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 90
 ---
 
 ## Огляд
 
-Виконує логіку `lint-python` за правилом `python.mdc` для забезпечення якості коду Python. Якщо файл `pyproject.toml` відсутній у корені, виконання завершується з кодом 0. Якщо файл присутній, але `uv` не знайдено у системному шляху, це вважається помилкою, оскільки `uv` є єдиним дозволеним пакет-менеджером (без Poetry). Для роботи необхідно виконати `uv lock --check` для підтвердження актуальності файлу блокування та `uv sync --frozen` для створення середовища, що відповідає `uv.lock` (детальніше про `uv` на https://docs.astral.sh/uv/). Опціональні лінтери запускаються лише за умови їх доступності через `uv run`. Запускаються `ruff` у режимі автоматичного виправлення (`--fix`) та форматування, а також `mypy` для статичного аналізу коду, використовуючи канонічний патерн серіалізації через `runStandardLint`.
+Реалізує логіку запуску `lint-python` за правилом `python.mdc` на базі [uv](https://docs.astral.sh/uv/). Якщо `pyproject.toml` у корені відсутній, процес завершується з кодом виходу 0. Якщо файл присутній, але інструмент `uv` не знайдено в PATH, це розглядається як помилка. Обов'язкові кроки включають перевірку актуальності lock-файлу (`uv lock --check`) та синхронізацію середовища (`uv sync --frozen`). Опційні лінтери (`ruff`, `mypy`) запускаються лише за умови їх доступності через `uv run`. `ruff` виконується у режимі автоматичного виправлення (`--fix`) для мутації робочого дерева та для форматування. Цей підхід відповідає канону патерну `lint-*` (серіалізація через `runStandardLint`, без прямого `withLock`).
 
 ## Поведінка
 
-run виконує стандартну перевірку на основі контексту.
-runLintPythonSteps виконує послідовність кроків лінтування Python, включаючи перевірку `pyproject.toml`, виконання `uv lock --check` та `uv sync --frozen`, а також запуск опціональних лінтерів (`ruff`, `mypy`) через `uv run`.
-runLintPython запускає послідовність кроків лінтування Python, використовуючи механізм стандартного лінтування.
-lint оркеструє запуск `runLintPython` для аналізу всього проєкту.
+run виконує стандартну перевірку для правила, використовуючи контекст прогону.
+runLintPythonSteps виконує послідовність кроків лінтування Python, перевіряючи наявність `pyproject.toml` та виконуючи команди `uv lock --check` та `uv sync --frozen`, а також запускаючи опціональні лінтери (`ruff`, `mypy`) через `uv run` на базі https://docs.astral.sh/uv/.
+runLintPython запускає послідовність кроків лінтування Python, серіалізуючи її через стандартний механізм перевірки.
+lint делегує виклик до `runLintPython`, забезпечуючи можливість запуску в режимі, що не мутує робоче дерево.
 
 ## Публічний API
 
-run — Основна точка входу для виконання правил, що включає перевірку логіки застосування (JS-concerns → policy → mdc-refs) та виконання лінтингу.
-runLintPythonSteps — Виконує внутрішні етапи лінтингу для Python без збереження логів.
-runLintPython — Публічний інтерфейс для запуску лінтингу Python, що забезпечує унікальність виконання через блокування та аналіз стану репозиторію.
-lint — Координатор, який ініціює запуск лінтингу Python, делегуючи це `runLintPython`.
+run — Основна точка входу для виконання правил, яка перевіряє логіку застосування (JS-занепокложення $\rightarrow$ політика $\rightarrow$ mdc-посилання) та запускає перевірку коду (uv/ruff/mypy).
+runLintPythonSteps — Виконує внутрішні етапи перевірки Python-коду без збереження логу.
+runLintPython — Публічний інтерфейс для запуску перевірки Python-коду, який гарантує унікальність виконання через блокування та аналіз стану Git-дерева.
+lint — Адаптер, що керує запуском перевірки Python-коду, делегуючи цю роботу `runLintPython`.
 
 ## Гарантії поведінки
 

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

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

package/rules/python/main.mjs

@@ -115,7 +115,8 @@ export function runLintPythonSteps(cwd = process.cwd(), opts = {}) {
   const ruffCheck = readOnly ? ['check', '.'] : ['check', '--fix', '.']
   const ruffFormat = readOnly ? ['format', '--check', '.'] : ['format', '.']
   if (!runOptionalUvTool('ruff', readOnly ? 'ruff check' : 'ruff check --fix', ruffCheck)) return reporter.getExitCode()
-  if (!runOptionalUvTool('ruff', readOnly ? 'ruff format --check' : 'ruff format', ruffFormat)) return reporter.getExitCode()
+  if (!runOptionalUvTool('ruff', readOnly ? 'ruff format --check' : 'ruff format', ruffFormat))
+    return reporter.getExitCode()
   if (!runOptionalUvTool('mypy', 'mypy', ['.'])) return reporter.getExitCode()
 
   return reporter.getExitCode()

package/rules/rego/docs/fix.md

@@ -12,12 +12,12 @@ docgen:
 ## Поведінка
 
 1. Запуск правила.
-    - Вхід: контекст прогону.
-    - Вихід: обіцянка, що повертає число. 0 означає успіх, 1 означає порушення.
+   - Вхід: контекст прогону.
+   - Вихід: обіцянка, що повертає число. 0 означає успіх, 1 означає порушення.
 2. Виконання правила у режимі CLI.
-    - Умова: виконання через командний рядок.
-    - Дія: повернення коду виходу з функції.
-    - Вихід: встановлення коду виходу процесу.
+   - Умова: виконання через командний рядок.
+   - Дія: повернення коду виходу з функції.
+   - Вихід: встановлення коду виходу процесу.
 
 ## Публічний API
 

package/rules/rego/docs/index.md

@@ -6,7 +6,7 @@ resource: npm/rules/rego/
 
 # npm/rules/rego
 
-| Файл | Тип |
-|---|---|
-| [fix.mjs](fix.md) | JS Module |
+| Файл                | Тип       |
+| ------------------- | --------- |
+| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

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

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

package/rules/release/docs/index.md

@@ -6,9 +6,9 @@ resource: npm/rules/release/
 
 # npm/rules/release
 
-| Файл | Тип |
-|---|---|
-| [change.mjs](change.md) | JS Module |
-| [fix.mjs](fix.md) | JS Module |
-| [main.mjs](main.md) | JS Module |
+| Файл                      | Тип       |
+| ------------------------- | --------- |
+| [change.mjs](change.md)   | JS Module |
+| [fix.mjs](fix.md)         | JS Module |
+| [main.mjs](main.md)       | JS Module |
 | [release.mjs](release.md) | JS Module |