@nitra/cursor 4.1.0 → 4.1.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [4.1.1] - 2026-06-08
+
+### Changed
+
+- @nitra/cursor 4
+
 ## [4.1.0] - 2026-06-07
 
 ### Added

package/bin/n-cursor.js

@@ -1141,7 +1141,6 @@ async function runSyncStep(prefix, action) {
  * захаращують термінал. Тому буфер скидається в реальний stdout **лише**
  * коли крок повернув `fail > 0` (або кинув виняток); за `fail === 0` —
  * відкидається мовчки.
- *
  * @template T
  * @param {() => Promise<T>} action крок синку, що повертає обʼєкт із лічильником помилок `fail`
  * @returns {Promise<T>} результат `action` без змін
@@ -1564,21 +1563,28 @@ const ROOT_GUARDED_COMMANDS = new Set([undefined, '', 'fix', 'check', 'lint', 'c
 function describeRootGuardedAction(cmd) {
   switch (cmd) {
     case undefined:
-    case '':
+    case '': {
       return 'Дефолтна синхронізація скаффолдить .cursor/, .claude/, CLAUDE.md, .n-cursor.json і робить bun install у поточному каталозі'
+    }
     case 'fix':
-    case 'check':
+    case 'check': {
       return '`fix` запускає programmatic-перевірки правил, що переписують конфіги в поточному каталозі'
-    case 'lint':
+    }
+    case 'lint': {
       return '`lint` запускає авто-fix лінтерів (oxfmt/eslint --fix/stylelint --fix) у поточному каталозі'
-    case 'coverage':
+    }
+    case 'coverage': {
       return '`coverage` генерує COVERAGE.md і Stryker-артефакти в поточному каталозі'
-    case 'change':
+    }
+    case 'change': {
       return '`change` пише change-файл у .changes/ поточного каталогу'
-    case 'release':
+    }
+    case 'release': {
       return '`release` бампає version і переписує CHANGELOG у поточному каталозі'
-    default:
+    }
+    default: {
       return 'Команда @nitra/cursor мутує проєкт у поточному каталозі'
+    }
   }
 }
 
@@ -1768,10 +1774,16 @@ try {
       break
     }
     case 'graph': {
-      // n-cursor graph — read-only позиція DAG вузлів (node-dag-state spec):
-      // status сканує docs/graphs/<g>/nodes/ і деривує статус кожного вузла.
-      const { runGraphCli } = await import('../scripts/dispatcher/graph.mjs')
-      process.exitCode = runGraphCli(args)
+      // n-cursor graph — task DAG orchestration system (думка.MD, file-presence protocol)
+      const { runGraphTasksCli } = await import('../scripts/dispatcher/graph-tasks.mjs')
+      process.exitCode = await runGraphTasksCli(args)
+
+      break
+    }
+    case 'watch': {
+      // n-cursor watch — one-shot DAG scan: audit queue + stale worktrees + needs-plan
+      const { runGraphTasksCli } = await import('../scripts/dispatcher/graph-tasks.mjs')
+      process.exitCode = await runGraphTasksCli(['watch', ...args])
 
       break
     }
@@ -1800,7 +1812,7 @@ try {
     default: {
       console.error(`❌ Невідома команда: ${command}`)
       console.error(
-        `   Очікується: (без аргументів) синхронізація правил, fix, check, rename-yaml-extensions, post-tool-use-fix, lint, lint-ga, lint-rego, lint-k8s, lint-docker, lint-text, coverage, coverage-fix, taze, start-check, fix-t0, change, release, skill, worktree, lint-ci, flow, trace, graph, docgen`
+        `   Очікується: (без аргументів) синхронізація правил, fix, check, rename-yaml-extensions, post-tool-use-fix, lint, lint-ga, lint-rego, lint-k8s, lint-docker, lint-text, coverage, coverage-fix, taze, start-check, fix-t0, change, release, skill, worktree, lint-ci, flow, trace, graph, watch, docgen`
       )
       process.exitCode = 1
     }

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.1",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",

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))
 }