@nitra/cursor 11.4.1 → 12.0.0

package/rules/doc-files/js/docs/docgen-files-batch.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: docgen-files-batch.mjs
+resource: npm/rules/doc-files/js/docgen-files-batch.mjs
 docgen:
-  source: npm/rules/doc-files/js/docgen-files-batch.mjs
-  crc: 6f01f8b9
+  crc: 975d6cfa
   score: 95
 ---
 
-# docgen-files-batch.mjs
-
-## Огляд
-
 runDocFilesGenCli
 Запускає генерацію документації для застарілих або відсутніх файлів.
 

package/rules/doc-files/js/docs/docgen-gen.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: docgen-gen.mjs
+resource: npm/rules/doc-files/js/docgen-gen.mjs
 docgen:
-  source: npm/rules/doc-files/js/docgen-gen.mjs
-  crc: 70215974
+  crc: 7674d2b2
   score: 100
 ---
 
-# docgen-gen.mjs
-
-## Огляд
-
 Огляд
 Публічні функції виконують операції з текстом та оцінками. Вони включають виділення коду, вставлення інформації та генерацію документів на основі визначених параметрів.
 

package/rules/doc-files/js/docs/docgen-ignore.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: docgen-ignore.mjs
+resource: npm/rules/doc-files/js/docgen-ignore.mjs
 docgen:
-  source: npm/rules/doc-files/js/docgen-ignore.mjs
   crc: c17cd785
   score: 100
 ---
 
-# docgen-ignore.mjs
-
-## Огляд
-
 DOCGEN_IGNORE_GLOBS
 Список шляхів, які docgen повинен ігнорувати.
 

package/rules/doc-files/js/docs/docgen-judge-measure.md

@@ -1,15 +1,13 @@
 ---
+type: JS Module
+title: docgen-judge-measure.mjs
+resource: npm/rules/doc-files/js/docgen-judge-measure.mjs
 docgen:
-  source: npm/rules/doc-files/js/docgen-judge-measure.mjs
   crc: 7f72e520
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
 
-# docgen-judge-measure.mjs
-
-## Огляд
-
 Файл зчитує список файлів для аналізу, спираючись на конфігурацію `report.json`. Для кожного файлу генерується технічна документація за допомогою локальної моделі. Після генерації документація оцінюється хмарною моделлю. Результати оцінки кешуються у межах прогону, а потім збираються у звіт. Звіт зберігається у `report.json` та виводиться у консоль.
 
 ## Поведінка

package/rules/doc-files/js/docs/docgen-judge.md

@@ -1,15 +1,13 @@
 ---
+type: JS Module
+title: docgen-judge.mjs
+resource: npm/rules/doc-files/js/docgen-judge.mjs
 docgen:
-  source: npm/rules/doc-files/js/docgen-judge.mjs
   crc: c6ab093a
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
 
-# docgen-judge.mjs
-
-## Огляд
-
 Модуль оцінює згенеровану документацію, порівнюючи її з вихідним файлом за допомогою великої мовної моделі. Це дозволяє визначити відповідність та якість документації. Модуль надає функції для запуску оцінки (`judgeDoc`, `judgeFailsDoc`), отримання результатів (`parseDocVerdict`), визначення моделі (`JUDGE_MODEL`), перевірки статусу оцінювача (`JUDGE_ENABLED`) та отримання рівня впевненості (`JUDGE_CONFIDENCE`).
 
 ## Поведінка

package/rules/doc-files/js/docs/docgen-prompts.md

@@ -1,15 +1,13 @@
 ---
+type: JS Module
+title: docgen-prompts.mjs
+resource: npm/rules/doc-files/js/docgen-prompts.mjs
 docgen:
-  source: npm/rules/doc-files/js/docgen-prompts.mjs
   crc: 28c9e818
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
 
-# docgen-prompts.mjs
-
-## Огляд
-
 Генерує технічну документацію на основі коду. Створює компоненти документації, такі як огляд (`overviewMessages`), повідомлення для секцій (`sectionMessages`), повідомлення для критики (`criticMessages`), повідомлення для уточнення (`refineMessages`) та гарантії, отримані з маркерів (`guaranteesFromMarkers`), застосовуючи заданий стиль (`STYLE`).
 
 ## Поведінка

package/rules/doc-files/js/docs/docgen-scan.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: docgen-scan.mjs
+resource: npm/rules/doc-files/js/docgen-scan.mjs
 docgen:
-  source: npm/rules/doc-files/js/docgen-scan.mjs
-  crc: dcc90d44
+  crc: 4c17838f
   score: 100
 ---
 
-# docgen-scan.mjs
-
-## Огляд
-
 isSourceFile перевіряє, чи є файл кодовим джерелом.
 docPathForSource обчислює шлях md-документа для кодового файлу.
 isDocCandidate перевіряє, чи підлягає файл документуванню.

package/rules/doc-files/js/docs/index.md

@@ -0,0 +1,24 @@
+---
+type: Directory Index
+title: npm/rules/doc-files/js
+resource: npm/rules/doc-files/js/
+---
+
+# npm/rules/doc-files/js
+
+| Файл | Тип |
+|---|---|
+| [docgen-crc.mjs](docgen-crc.md) | JS Module |
+| [docgen-extract-anchors.mjs](docgen-extract-anchors.md) | JS Module |
+| [docgen-extract.mjs](docgen-extract.md) | JS Module |
+| [docgen-files-batch.mjs](docgen-files-batch.md) | JS Module |
+| [docgen-gen.mjs](docgen-gen.md) | JS Module |
+| [docgen-ignore.mjs](docgen-ignore.md) | JS Module |
+| [docgen-judge-measure.mjs](docgen-judge-measure.md) | JS Module |
+| [docgen-judge.mjs](docgen-judge.md) | JS Module |
+| [docgen-prompts.mjs](docgen-prompts.md) | JS Module |
+| [docgen-scan.mjs](docgen-scan.md) | JS Module |
+| [lint.mjs](lint.md) | JS Module |
+| [units-js.mjs](units-js.md) | JS Module |
+| [units-rs.mjs](units-rs.md) | JS Module |
+| [units.mjs](units.md) | JS Module |

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

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: lint.mjs
+resource: npm/rules/doc-files/js/lint.mjs
 docgen:
-  source: npm/rules/doc-files/js/lint.mjs
-  crc: f25a3bbe
+  crc: fcdc1c2a
   score: 100
 ---
 
-# lint.mjs
-
-## Огляд
-
 Адаптер правила doc-files до агрегатора `n-cursor lint`. Дає агрегатору відповідь на одне
 питання: чи має кожен дотичний кодовий файл актуальну файлову документацію поряд із собою.
 

package/rules/doc-files/js/docs/units-js.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: units-js.mjs
+resource: npm/rules/doc-files/js/units-js.mjs
 docgen:
-  source: npm/rules/doc-files/js/units-js.mjs
   crc: 58b898cc
   score: 100
 ---
 
-# units-js.mjs
-
-## Огляд
-
 Файл парсить програму, ітеруючи по її елементах для збору юнітів. Для кожної декларації визначається опис. Для функцій та класів збираються виклики інших юнітів через ребра викликів.
 
 ## Поведінка

package/rules/doc-files/js/docs/units-rs.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: units-rs.mjs
+resource: npm/rules/doc-files/js/units-rs.mjs
 docgen:
-  source: npm/rules/doc-files/js/units-rs.mjs
   crc: 114e9a0b
   score: 100
 ---
 
-# units-rs.mjs
-
-## Огляд
-
 Файл аналізує структуру коду для вилучення інформації про юніти. Процес включає сканування рядків, ітерацію для визначення глибини блоків та позиції закриваючих лапок. Обробляються рядкові літерали для визначення межі блоків та підраховуються глибини блоків для визначення видимості. Обробляються декларації для визначення публічності. Витягується тіло функцій, структур, перерахувань або трейтів. Визначається експонування функцій через атрибути. Збирається документація перед декларацією. Формується об'єкт юніту з назвою, типом, публічністю, ім'я impl та діапазон. Визначається область видимості тіла за допомогою пошуку закриваючої фігу. Збираються виклики інших юнітів у тілі функції.
 
 ## Поведінка

package/rules/doc-files/js/docs/units.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: units.mjs
+resource: npm/rules/doc-files/js/units.mjs
 docgen:
-  source: npm/rules/doc-files/js/units.mjs
   crc: af91bd0d
   score: 100
 ---
 
-# units.mjs
-
-## Огляд
-
 Файл витягує одиниці з вмісту файлу залежно від розширення шляху. Якщо розширення належить до набору JS_EXT, використовується extractUnitsJs. Якщо розширення дорівнює 'rs', використовується extractUnitsRs. В інших випадках функція повертає null.
 
 ## Поведінка

package/rules/doc-files/lint/docs/index.md

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

package/rules/doc-files/lint/docs/lint.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: lint.mjs
+resource: npm/rules/doc-files/lint/lint.mjs
 docgen:
-  source: npm/rules/doc-files/lint/lint.mjs
   crc: a30dd81f
   score: 100
 ---
 
-# lint.mjs
-
-## Огляд
-
 CLI-команда `lint-doc-files` — детермінований детектор застарілості файлових док. Працює без
 мовної моделі скрізь: локально, в hook'ах і в CI.
 

package/rules/docker/docs/fix.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: fix.mjs
+resource: npm/rules/docker/fix.mjs
 docgen:
-  source: npm/rules/docker/fix.mjs
   crc: 38cf876b
   score: 100
 ---
 
-# fix.mjs
-
-## Огляд
-
 Запуск правила приймає контекст прогону, застосовує JS-занепокоєні до політики до mdc-refs та повертає результат.
 
 Виконання у режимі CLI виконує повний еквівалент команди `npx @nitra/cursor fix <id>`, включаючи завантаження конфігурації, перевірку дозволених елементів та підбиття підсумку.

package/rules/docker/docs/index.md

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

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

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

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

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: lint.mjs
+resource: npm/rules/docker/js/lint.mjs
 docgen:
-  source: npm/rules/docker/js/lint.mjs
   crc: 495d03ee
   score: 100
 ---
 
-# lint.mjs
-
-## Огляд
-
 Модуль забезпечує декомпозицію структури Dockerfile для вилучення даних про багатостадійні збірки та залежності середовища. Функції, такі як `findDockerfilePaths` та `splitDockerfileStages`, використовуються для ідентифікації та розділення стадій збірки. Модуль надає інструменти для отримання підказок про виконання, включаючи визначення багатостадійного режиму (`getMultistageAndRuntimeHint`), компіляційних налаштувань (`getBunCompileHint`), та підказок про використання образу Nginx Alpine Slim (`getNginxAlpineSlimTagHint`). Додатково, він визначає необхідність роботи без прав root (`getNonRootRuntimeHint`). (docker.mdc)
 
 ## Поведінка

package/rules/docker/lib/docs/docker-hadolint.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: docker-hadolint.mjs
+resource: npm/rules/docker/lib/docker-hadolint.mjs
 docgen:
-  source: npm/rules/docker/lib/docker-hadolint.mjs
   crc: b97701f3
 ---
 
-# docker-hadolint.mjs
-
-## Огляд
-
 Модуль `docker-hadolint.mjs` інкапсулює спільну логіку запуску статичного аналізатора `hadolint` для перевірки `Dockerfile`-ів у межах правила `docker` (див. `.cursor/rules/docker.mdc` / `n-docker`). Він є тонким адаптером поверх системного бінарника `hadolint` та надає двом викликачам — `check.mjs` (skill `check-docker`) і `../../lint/lint.mjs` (skill `run-docker`) — єдину функцію перевірки одного `Dockerfile` плюс утиліту нормалізації шляхів.
 
 Ключові архітектурні рішення:

package/rules/docker/lib/docs/docker-mirror.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: docker-mirror.mjs
+resource: npm/rules/docker/lib/docker-mirror.mjs
 docgen:
-  source: npm/rules/docker/lib/docker-mirror.mjs
   crc: b7c0bd04
 ---
 
-# docker-mirror.mjs
-
-## Огляд
-
 Модуль `docker-mirror.mjs` — це частина правила `n-docker` (тека `npm/rules/docker/lib/`) монорепо `n-cursor`. Він реалізує чисту (без I/O, без побічних ефектів) бібліотеку функцій для статичного аналізу директив `FROM` у файлах `Dockerfile` / `Containerfile` та визначає, чи звертається образ до Docker Hub без використання GCR-дзеркала `mirror.gcr.io`.
 
 Призначення:

package/rules/docker/lib/docs/docker-native-addon.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: docker-native-addon.mjs
+resource: npm/rules/docker/lib/docker-native-addon.mjs
 docgen:
-  source: npm/rules/docker/lib/docker-native-addon.mjs
   crc: 8b747dec
 ---
 
-# docker-native-addon.mjs
-
-## Огляд
-
 Модуль `docker-native-addon.mjs` — це dep-специфічний чек-модуль правила `docker` для виявлення антипатерну, коли проєкт залежить від нативного `.node`-аддона з динамічним завантаженням біндингу (через динамічний `require`), і одночасно намагається бути запакованим через `bun build --compile` у Dockerfile.
 
 Контекст проблеми:

package/rules/docker/lib/docs/docker-nginx-user.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: docker-nginx-user.mjs
+resource: npm/rules/docker/lib/docker-nginx-user.mjs
 docgen:
-  source: npm/rules/docker/lib/docker-nginx-user.mjs
   crc: 23fc4989
 ---
 
-# docker-nginx-user.mjs
-
-## Огляд
-
 Модуль `docker-nginx-user.mjs` — це чек-модуль для статичного аналізу Dockerfile (Containerfile), що спеціалізується на фінальному (runtime) `FROM`-stage на базі офіційного образу `nginxinc/nginx-unprivileged`. Належить до набору правил `npm/rules/docker/lib/` і викликається з агрегованого Docker-lint-набору.
 
 Файл вирішує дві суміжні задачі для nginx-unprivileged-stage:

package/rules/docker/lib/docs/index.md

@@ -0,0 +1,14 @@
+---
+type: Directory Index
+title: npm/rules/docker/lib
+resource: npm/rules/docker/lib/
+---
+
+# npm/rules/docker/lib
+
+| Файл | Тип |
+|---|---|
+| [docker-hadolint.mjs](docker-hadolint.md) | JS Module |
+| [docker-mirror.mjs](docker-mirror.md) | JS Module |
+| [docker-native-addon.mjs](docker-native-addon.md) | JS Module |
+| [docker-nginx-user.mjs](docker-nginx-user.md) | JS Module |

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

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

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

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: lint.mjs
+resource: npm/rules/docker/lint/lint.mjs
 docgen:
-  source: npm/rules/docker/lint/lint.mjs
   crc: 98a98d10
 ---
 
-# lint.mjs — реалізація підкоманди `lint-docker`
-
-## Огляд
-
 Модуль `npm/rules/docker/lint/lint.mjs` реалізує підкоманду `lint-docker` інструмента `n-cursor`. Її задача — знайти у дереві репозиторію канонічні Dockerfile-и та пропустити їх через `hadolint`, фіксуючи результат у форматі звіту `check-reporter` і виставляючи числовий код виходу.
 
 Особливості, що визначають поведінку:

package/rules/efes/docs/fix.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: fix.mjs
+resource: npm/rules/efes/fix.mjs
 docgen:
-  source: npm/rules/efes/fix.mjs
   crc: 38cf876b
   score: 100
 ---
 
-# fix.mjs
-
-## Огляд
-
 Виконує застосування політики JS-занепокоєних та політики на наданому контексті прогону, генеруючи посилання MDC та повертаючи результат.
 
 Виконується при запуску через командний рядок, виконуючи повний еквівалент команди `npx @nitra/cursor fix <id>` та повертаючи код виходу.

package/rules/efes/docs/index.md

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

package/rules/feedback/docs/fix.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: fix.mjs
+resource: npm/rules/feedback/fix.mjs
 docgen:
-  source: npm/rules/feedback/fix.mjs
   crc: 38cf876b
   score: 100
 ---
 
-# fix.mjs
-
-## Огляд
-
 Виконує обробку JS-занепокоєних на наданому контексті прогону. Застосовує визначену політику та генерує посилання MDC. Повертає результат прогону.
 
 ## Поведінка

package/rules/feedback/docs/index.md

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

package/rules/ga/docs/fix.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: fix.mjs
+resource: npm/rules/ga/fix.mjs
 docgen:
-  source: npm/rules/ga/fix.mjs
   crc: 38cf876b
   score: 100
 ---
 
-# fix.mjs
-
-## Огляд
-
 Виконує обробку JS-занепокоєних на наданому контексті прогону. Застосовує визначену політику та генерує посилання MDC. Повертає результат прогону.
 
 ## Поведінка

package/rules/ga/docs/index.md

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

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

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

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

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

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

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: workflows.mjs
+resource: npm/rules/ga/js/workflows.mjs
 docgen:
-  source: npm/rules/ga/js/workflows.mjs
   crc: a9296cf1
   score: 100
 ---
 
-# workflows.mjs
-
-## Огляд
-
 Модуль виявляє наявність інструменту `shellcheck` та підтверджує відповідність конфігурації проєкту правилам ga.mdc. Він перевіряє відповідність workflow-файлів Rego-полісі, наявність обов'язкових компонентів та коректність шляхів тригерів GitHub Actions. Модуль свідомо пропускає шляхи `.github` та `.git` під час перевірки.
 
 ## Поведінка

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

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

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

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: lint.mjs
+resource: npm/rules/ga/lint/lint.mjs
 docgen:
-  source: npm/rules/ga/lint/lint.mjs
   crc: c391782d
 ---
 
-# lint.mjs
-
-## Огляд
-
 Файл надає CLI-обгортку для інструменту `lint-ga`, який автоматично встановлює необхідні інструменти, такі як `shellcheck` та `conftest`, для перевірки коду. Він послідовно виконує перевірку коду за допомогою Rego та JavaScript, забезпечуючи узгодженість з правилами `ga.mdc`. Цей файл служить централізованим джерелом для виконання та налаштування процесу linting, що спрощує інтеграцію в CI/CD.
 
 ## Поведінка

package/rules/graphql/docs/fix.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: fix.mjs
+resource: npm/rules/graphql/fix.mjs
 docgen:
-  source: npm/rules/graphql/fix.mjs
   crc: 38cf876b
   score: 100
 ---
 
-# fix.mjs
-
-## Огляд
-
 Виконує обробку JS-занепокоєних та політики на вхідному контексті прогону, генеруючи посилання MDC та повертаючи результат.
 
 Виконується як автономний скрипт для виконання повного еквіваленту команди `npx @nitra/cursor fix <id>` та перевірки результату прогону.