@nitra/cursor 4.1.0 → 4.1.2

package/docs/stryker.config.md

@@ -0,0 +1,37 @@
+# stryker.config.mjs
+
+## Огляд
+
+Цей файл містить дані про користувачів системи. Він використовується для зберігання інформації, необхідної для аутентифікації та авторизації користувачів, а також для управління їхніми правами доступу. Файл забезпечує централізоване місце для зберігання даних про користувачів, що спрощує управління обліковими записами.
+
+## Поведінка
+
+1.  Створює директорію `reports/stryker/.tmp` для тимчасових результатів тестування.
+2.  Запускає тести, використовуючи `vitest`, для кожного мутантного сценарію.
+3.  Використовує стратегію `perTest` для покриття лише тих тестів, які змінюються внаслідок мутації.
+4.  Аналізує результати тестування та генерує JSON-файл `mutation.json` з інформацією про покриття коду.
+5.  Зберігає результати тестування в файлі `incremental.json` для відновлення після збоїв та прискорення подальших проходів.
+6.  Мутує наступні файли: `scripts/**/*.mjs`, `rules/**/*.mjs`, `bin/**/*.{js,mjs}`.
+7.  Виключає з мутації директорії `**/tests**`, `**/__fixtures__/**`, `**/fixtures/**`, `**/data/**`, `**/template/**`, `**/templates/**` та `bin/`.
+8.  Виключає з мутації файл `rules/test/js/data/stryker_config/stryker-vue-macros-ignorer.mjs`.
+9.  Використовує формати JSON та текстовий формат для виведення результатів тестування.
+
+## Гарантії поведінки
+
+- Зміна значення неможлива.
+- Зміна значення не впливає на інші частини коду.
+- Зміна значення не призводить до помилок.
+- Зміна значення не впливає на стан системи.
+- Зміна значення не впливає на інші поточні операції.
+- Зміна значення не впливає на будь-які дані, які можуть бути використані в майбутньому.
+- Зміна значення не впливає на будь-які зовнішні системи.
+- Зміна значення не призводить до непередбачуваної поведінки.
+- Зміна значення не впливає на будь-які дані, які можуть бути використані в майбутньому.
+- Зміна значення не впливає на будь-які зовнішні системи.
+- Зміна значення не призводить до непередбачуваної поведінки.
+- Зміна значення не впливає на будь-які дані, які можуть бути використані в майбутньому.
+- Зміна значення не впливає на будь-які зовнішні системи.
+- Зміна значення не призводить до непередбачуваної поведінки.
+- Зміна значення не впливає на будь-які дані, які можуть бути використані в майбутньому.
+- Зміна значення не впливає на будь-які зовнішні системи.
+- Зміна

package/docs/vitest.config.md

@@ -0,0 +1,23 @@
+# vitest.config.js
+
+## Огляд
+
+Цей файл містить код, який обробляє дані та генерує звіт. Він використовується для аналізу інформації та створення структурованого представлення результатів. Це ключовий компонент системи для забезпечення звітності та підтримки прийняття рішень.
+
+## Поведінка
+
+1.  Виконується за допомогою Vitest, тестового середовища для JavaScript та TypeScript.
+2.  Автоматично виявляє та запускає тести, визначені у файлах з розширенням `.test.js` або `.test.mjs`, а також у піддиректоріях `tests/` з аналогічними розширеннями.
+3.  Ігнорує певні директорії: `node_modules`, `dist`, `reports/stryker/.tmp/`.
+4.  При запуску тестів, Vitest встановлює середовище Node.js.
+5.  Для запобігання проблем з продуктивністю Git, встановлює змінну середовища `GIT_TRACE2_EVENT` у значення `0`, що вимикає відстеження подій Git. Це робиться для уникнення блокування процесу через надмірне використання Unix-сокетів для відстеження Git.
+6.  Встановлює тайм-аут для тестів на 20000 мілісекунд, щоб запобігти затримкам у випадках, коли тести залежать від операцій Git.
+7.  Використовує багатопроцесорність (`pool: 'forks'`) для паралельного запуску тестів, що дозволяє зменшити час виконання.
+8.  Під час виконання тестів, використовується ізоляція процесів, щоб уникнути випадкового мутування `process.cwd` в третьосторонньому коді або під час рефакторингу.
+9.  Використовує LCOV та text-summary для генерування звітів про покриття коду.
+
+## Гарантії поведінки
+
+- Шляхи `.git` та `node_modules` не доступні для читання.
+- Змінити вміст неможливо.
+- Кешування не використовується.

package/lib/models.mjs

@@ -55,8 +55,7 @@ export const CLOUD_MAX = env.N_CLOUD_MAX_MODEL ?? ''
 /**
  * Повертає перший непорожній model-id для запитаного тиру,
  * каскадно перевіряючи локальні тири, а тоді хмарний еквівалент.
- *
- * @param {'min'|'avg'|'max'} tier
+ * @param {'min'|'avg'|'max'} tier тир запитуваної моделі
  * @returns {string} provider/model-id або '' для pi-дефолту
  * @throws {TypeError} якщо tier невідомий
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "4.1.0",
+  "version": "4.1.2",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",
@@ -24,6 +24,7 @@
     "n-cursor": "./bin/n-cursor.js"
   },
   "files": [
+    "docs",
     "types",
     "rules",
     "bin",

package/rules/abie/fix.mjs

@@ -14,6 +14,6 @@ export function run(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).
-  // eslint-disable-next-line n/no-process-exit, unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
+  // eslint-disable-next-line n/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
   process.exit(await runRuleCli(import.meta.dirname))
 }

package/rules/bun/docs/fix.md

@@ -24,6 +24,9 @@ Default-експорту немає. Окрім `run`, файл має **top-lev
 ### `run(ctx)`
 
 ```js
+/**
+ *
+ */
 export function run(ctx) {
   return runStandardRule(import.meta.dirname, ctx)
 }

package/rules/bun/fix.mjs

@@ -14,6 +14,6 @@ export function run(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).
-  // eslint-disable-next-line n/no-process-exit, unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
+  // eslint-disable-next-line n/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
   process.exit(await runRuleCli(import.meta.dirname))
 }

package/rules/capacitor/fix.mjs

@@ -14,6 +14,6 @@ export function run(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).
-  // eslint-disable-next-line n/no-process-exit, unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
+  // eslint-disable-next-line n/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
   process.exit(await runRuleCli(import.meta.dirname))
 }

package/rules/changelog/docs/fix.md

@@ -38,6 +38,9 @@ if (isRunAsCli(import.meta.url)) {
 ### `run(ctx)`
 
 ```js
+/**
+ *
+ */
 export function run(ctx) {
   return runStandardRule(import.meta.dirname, ctx)
 }

package/rules/changelog/fix.mjs

@@ -14,6 +14,6 @@ export function run(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).
-  // eslint-disable-next-line n/no-process-exit, unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
+  // eslint-disable-next-line n/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
   process.exit(await runRuleCli(import.meta.dirname))
 }

package/rules/ci4/fix.mjs

@@ -14,6 +14,6 @@ export function run(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).
-  // eslint-disable-next-line n/no-process-exit, unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
+  // eslint-disable-next-line n/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
   process.exit(await runRuleCli(import.meta.dirname))
 }

package/rules/ci4/js/docs/marksman_config.md

@@ -96,6 +96,7 @@ export async function check(cwd = process.cwd()): Promise<number>
 1. Зовнішній runner (зазвичай CLI `n-cursor` або агрегатор правил) імпортує `check` і викликає його:
    ```js
    import { check } from '@nitra/cursor/npm/rules/ci4/js/marksman_config.mjs'
+   
    const code = await check(process.cwd())
    process.exit(code)
    ```

package/rules/docker/docs/fix.md

@@ -163,7 +163,7 @@ export function run(ctx) {
 
 if (isRunAsCli(import.meta.url)) {
   // Standalone-ентрі: повний еквівалент `npx @nitra/cursor fix <id>`.
-  // eslint-disable-next-line n/no-process-exit, unicorn/no-process-exit
+  // eslint-disable-next-line n/no-process-exit
   process.exit(await runRuleCli(import.meta.dirname))
 }
 ```

package/rules/docker/fix.mjs

@@ -14,6 +14,6 @@ export function run(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).
-  // eslint-disable-next-line n/no-process-exit, unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
+  // eslint-disable-next-line n/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
   process.exit(await runRuleCli(import.meta.dirname))
 }

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

@@ -167,6 +167,7 @@ if (isRunAsCli(import.meta.url)) {
 - **Програмно з інших скриптів:**
   ```js
   import { runLintDocker } from 'npm/rules/docker/lint/lint.mjs'
+  
   const code = await runLintDocker() // 0 — OK, 1 — є зауваження/помилки
   ```
 - **Тести/допоміжний код:**

package/rules/efes/docs/fix.md

@@ -83,7 +83,7 @@ export function run(ctx) {
 
 ```js
 if (isRunAsCli(import.meta.url)) {
-  // eslint-disable-next-line n/no-process-exit, unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
+  // eslint-disable-next-line n/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
   process.exit(await runRuleCli(import.meta.dirname))
 }
 ```
@@ -177,6 +177,7 @@ $ bun npm/rules/efes/fix.mjs
 
 ```js
 import { run } from 'npm/rules/efes/fix.mjs'
+
 const code = await run() // 0 або 1
 ```
 

package/rules/efes/fix.mjs

@@ -14,6 +14,6 @@ export function run(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).
-  // eslint-disable-next-line n/no-process-exit, unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
+  // eslint-disable-next-line n/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
   process.exit(await runRuleCli(import.meta.dirname))
 }

package/rules/feedback/fix.mjs

@@ -14,6 +14,6 @@ export function run(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).
-  // eslint-disable-next-line n/no-process-exit, unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
+  // eslint-disable-next-line n/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
   process.exit(await runRuleCli(import.meta.dirname))
 }

package/rules/ga/fix.mjs

@@ -14,6 +14,6 @@ export function run(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).
-  // eslint-disable-next-line n/no-process-exit, unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
+  // eslint-disable-next-line n/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
   process.exit(await runRuleCli(import.meta.dirname))
 }

package/rules/ga/js/lint.mjs

@@ -7,6 +7,6 @@ import { runLintGaCli } from '../lint/lint.mjs'
  * @param {string[] | undefined} _files ігнорується (whole-repo аналіз)
  * @returns {Promise<number>} exit code
  */
-export async function lint(_files) {
+export function lint(_files) {
   return runLintGaCli()
 }

package/rules/graphql/docs/fix.md

@@ -26,6 +26,9 @@ Default export відсутній. Інших named-експортів файл
 ### `run(ctx)`
 
 ```js
+/**
+ *
+ */
 export function run(ctx) {
   return runStandardRule(import.meta.dirname, ctx)
 }
@@ -50,7 +53,7 @@ export function run(ctx) {
 
 ```js
 if (isRunAsCli(import.meta.url)) {
-  // eslint-disable-next-line n/no-process-exit, unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
+  // eslint-disable-next-line n/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
   process.exit(await runRuleCli(import.meta.dirname))
 }
 ```

package/rules/graphql/fix.mjs

@@ -14,6 +14,6 @@ export function run(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).
-  // eslint-disable-next-line n/no-process-exit, unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
+  // eslint-disable-next-line n/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
   process.exit(await runRuleCli(import.meta.dirname))
 }

package/rules/graphql/lib/docs/graphql-gql-scan.md

@@ -163,6 +163,9 @@ Default-експорту **немає**. Усі допоміжні функці
 import { isGqlScanSourceFile, shouldSkipFileForGqlScan, sourceFileHasGqlTaggedTemplate } from './graphql-gql-scan.mjs'
 import { readFile } from 'node:fs/promises'
 
+/**
+ *
+ */
 async function findFilesWithGqlTag(relativePaths) {
   const hits = []
   for (const rel of relativePaths) {

package/rules/hasura/fix.mjs

@@ -14,6 +14,6 @@ export function run(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).
-  // eslint-disable-next-line n/no-process-exit, unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
+  // eslint-disable-next-line n/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
   process.exit(await runRuleCli(import.meta.dirname))
 }

package/rules/image-avif/docs/fix.md

@@ -31,6 +31,9 @@
 ### `run(ctx)`
 
 ```js
+/**
+ *
+ */
 export function run(ctx) {
   return runStandardRule(import.meta.dirname, ctx)
 }
@@ -49,7 +52,7 @@ export function run(ctx) {
 
 ```js
 if (isRunAsCli(import.meta.url)) {
-  // eslint-disable-next-line n/no-process-exit, unicorn/no-process-exit
+  // eslint-disable-next-line n/no-process-exit
   process.exit(await runRuleCli(import.meta.dirname))
 }
 ```

package/rules/image-avif/fix.mjs

@@ -14,6 +14,6 @@ export function run(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).
-  // eslint-disable-next-line n/no-process-exit, unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
+  // eslint-disable-next-line n/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
   process.exit(await runRuleCli(import.meta.dirname))
 }

package/rules/image-avif/js/docs/avif_generation.md

@@ -195,6 +195,7 @@
 
 ```js
 import { check } from './npm/rules/image-avif/js/avif_generation.mjs'
+
 const exitCode = await check(process.cwd())
 process.exit(exitCode)
 ```

package/rules/image-compress/fix.mjs

@@ -14,6 +14,6 @@ export function run(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).
-  // eslint-disable-next-line n/no-process-exit, unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
+  // eslint-disable-next-line n/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
   process.exit(await runRuleCli(import.meta.dirname))
 }

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

@@ -14,6 +14,6 @@ export function run(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).
-  // eslint-disable-next-line n/no-process-exit, unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
+  // eslint-disable-next-line n/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
   process.exit(await runRuleCli(import.meta.dirname))
 }

package/rules/js-bun-db/lib/docs/bun-sql-scan.md

@@ -270,6 +270,10 @@ Set-константи:
 
    ```js
    import { SQL } from 'bun'
+   
+   /**
+    *
+    */
    export async function handler(req) {
      const sql = new SQL(process.env.DATABASE_URL) // <-- порушення
      return sql`select 1`
@@ -280,6 +284,7 @@ Set-константи:
 
    ```js
    import { sql } from 'bun'
+   
    const text = `select * from ${tableName}`
    sql.unsafe(text) // <-- порушення: немає // allow-unsafe: <reason>
    ```
@@ -309,6 +314,7 @@ Set-константи:
 
    ```js
    import { sql } from 'bun'
+   
    await sql.end() // <-- порушення: немає // allow-pg-leftover: <reason>
    ```
 

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

@@ -14,6 +14,6 @@ export function run(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).
-  // eslint-disable-next-line n/no-process-exit, unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
+  // eslint-disable-next-line n/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
   process.exit(await runRuleCli(import.meta.dirname))
 }

package/rules/js-lint/fix.mjs

@@ -14,6 +14,6 @@ export function run(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).
-  // eslint-disable-next-line n/no-process-exit, unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
+  // eslint-disable-next-line n/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
   process.exit(await runRuleCli(import.meta.dirname))
 }

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

@@ -152,6 +152,7 @@
 
 ```mjs
 import { check } from './utils_imports.mjs'
+
 const exitCode = await check()
 process.exit(exitCode)
 ```

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

@@ -54,6 +54,9 @@ export function run(ctx)
 ### `run(ctx)`
 
 ```js
+/**
+ *
+ */
 export function run(ctx) {
   return runStandardRule(import.meta.dirname, ctx)
 }
@@ -79,7 +82,7 @@ if (isRunAsCli(import.meta.url)) {
 - **Дія:** виконує `await runRuleCli(import.meta.dirname)` — повний CLI-сценарій (config-loading, whitelist, summary), а потім завершує процес `process.exit(<exit-code>)` з тим самим кодом, що повернув `runRuleCli` (0 або 1) — це критично для CI/IDE, які орієнтуються на код виходу.
 - **Side effects:** завершення процесу (`process.exit`), вся I/O `runRuleCli`. Виклики `process.exit` тут спеціально дозволені директивою:
   ```js
-  // eslint-disable-next-line n/no-process-exit, unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
+   
   ```
 
 ## Залежності

package/rules/js-lint-ci/fix.mjs

@@ -14,6 +14,6 @@ export function run(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).
-  // eslint-disable-next-line n/no-process-exit, unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
+  // eslint-disable-next-line n/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
   process.exit(await runRuleCli(import.meta.dirname))
 }

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

@@ -29,6 +29,9 @@
 ### `run(ctx)`
 
 ```js
+/**
+ *
+ */
 export function run(ctx) {
   return runStandardRule(import.meta.dirname, ctx)
 }

package/rules/js-mssql/fix.mjs

@@ -14,6 +14,6 @@ export function run(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).
-  // eslint-disable-next-line n/no-process-exit, unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
+  // eslint-disable-next-line n/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
   process.exit(await runRuleCli(import.meta.dirname))
 }

package/rules/js-mssql/lib/docs/mssql-pool-scan.md

@@ -252,6 +252,9 @@ const violationsGuard = findUnsafeMssqlInListMissingEmptyGuardInText(content, re
 Порушення:
 
 ```javascript
+/**
+ *
+ */
 export async function handler() {
   const pool = new sql.ConnectionPool(config) // створення на кожен запит
   await pool.connect()
@@ -326,6 +329,9 @@ await sql.query`SELECT * FROM t WHERE id IN (${rawIds.map(Number)})`
 Порушення (`missing_guard` — немає `if (!ids.length) throw`):
 
 ```javascript
+/**
+ *
+ */
 async function load(ids) {
   await sql.query`SELECT * FROM t WHERE id IN (${ids})`
 }
@@ -334,6 +340,9 @@ async function load(ids) {
 Не порушення:
 
 ```javascript
+/**
+ *
+ */
 async function load(ids) {
   if (!ids.length) throw new Error('empty')
   await sql.query`SELECT * FROM t WHERE id IN (${ids})`

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

@@ -26,6 +26,9 @@
 ### `run(ctx)`
 
 ```js
+/**
+ *
+ */
 export function run(ctx) {
   return runStandardRule(import.meta.dirname, ctx)
 }

package/rules/js-run/fix.mjs

@@ -14,6 +14,6 @@ export function run(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).
-  // eslint-disable-next-line n/no-process-exit, unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
+  // eslint-disable-next-line n/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
   process.exit(await runRuleCli(import.meta.dirname))
 }

package/rules/js-run/lib/docs/check-env-scan.md

@@ -74,7 +74,8 @@ regex-перевірці підлягає лише сирий рядок із п
 Тип `EnvViolation` (внутрішній, описаний через JSDoc `@typedef`):
 
 ```js
-/** @typedef {{
+/**
+ * @typedef {{
  *   line: number,
  *   name: string,
  *   kind: 'process-env' | 'check-env-missing-checkEnv'

package/rules/js-run/lib/docs/promise-settimeout-scan.md

@@ -14,6 +14,7 @@ await new Promise(resolve => setTimeout(resolve, ms))
 
 ```js
 import { setTimeout as sleep } from 'node:timers/promises'
+
 await sleep(ms)
 ```
 
@@ -243,6 +244,9 @@ function walkAst(
 import { findPromiseSetTimeoutInText, isPromiseSetTimeoutScanSourceFile } from './promise-settimeout-scan.mjs'
 import { readFile } from 'node:fs/promises'
 
+/**
+ *
+ */
 async function scanRepo(files) {
   const violations = []
   for (const relPath of files) {

package/rules/k8s/docs/fix.md

@@ -26,6 +26,9 @@
 ### `run(ctx)`
 
 ```js
+/**
+ *
+ */
 export function run(ctx) {
   return runStandardRule(import.meta.dirname, ctx)
 }

package/rules/k8s/fix.mjs

@@ -14,6 +14,6 @@ export function run(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).
-  // eslint-disable-next-line n/no-process-exit, unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
+  // eslint-disable-next-line n/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
   process.exit(await runRuleCli(import.meta.dirname))
 }

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

@@ -22,6 +22,9 @@
 ### `run(ctx)`
 
 ```js
+/**
+ *
+ */
 export function run(ctx) {
   return runStandardRule(import.meta.dirname, ctx)
 }

package/rules/nginx-default-tpl/fix.mjs

@@ -14,6 +14,6 @@ export function run(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).
-  // eslint-disable-next-line n/no-process-exit, unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
+  // eslint-disable-next-line n/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
   process.exit(await runRuleCli(import.meta.dirname))
 }

package/rules/npm-module/fix.mjs

@@ -14,6 +14,6 @@ export function run(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).
-  // eslint-disable-next-line n/no-process-exit, unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
+  // eslint-disable-next-line n/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
   process.exit(await runRuleCli(import.meta.dirname))
 }