@nitra/cursor 11.4.1 → 12.0.0

package/rules/security/js/docs/trufflehog.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: trufflehog.mjs
+resource: npm/rules/security/js/trufflehog.mjs
 docgen:
-  source: npm/rules/security/js/trufflehog.mjs
   crc: 83f277a6
   score: 95
 ---
 
-# trufflehog.mjs
-
-## Огляд
-
 Огляд
 
 Файл виконує перевірку конфігураційних файлів та шаблонів для забезпечення безпеки. Перевіряється наявність `package.json` та `.trufflehog-exclude`. Дані з цих файлів використовуються для перевірки відповідності шаблону файлу `security.mdc`.

package/rules/style-lint/docs/fix.md

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

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

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

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

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

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

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: lint.mjs
+resource: npm/rules/style-lint/js/lint.mjs
 docgen:
-  source: npm/rules/style-lint/js/lint.mjs
   crc: 2013a66b
   score: 100
 ---
 
-# lint.mjs
-
-## Огляд
-
 filterStyleFiles
 Вибирає файли, що мають розширення .css, .scss або .vue.
 

package/rules/style-lint/js/docs/tooling.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: tooling.mjs
+resource: npm/rules/style-lint/js/tooling.mjs
 docgen:
-  source: npm/rules/style-lint/js/tooling.mjs
   crc: 631f5de8
   score: 80
 ---
 
-# tooling.mjs
-
-## Огляд
-
 Файл виконує перевірку конфігурації stylelint та файлів, пов'язаних з лінтуванням. Перевірка включає наявність конфігурації stylelint у `package.json` або зовнішньому файлі, файлів конфігу stylelint у директорії, файлів ігнорування stylelint та файлу workflow для лінтування.
 
 ## Поведінка

package/rules/tauri/docs/fix.md

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

package/rules/tauri/docs/index.md

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

package/rules/tauri/js/docs/cargo_mutants_config.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: cargo_mutants_config.mjs
+resource: npm/rules/tauri/js/cargo_mutants_config.mjs
 docgen:
-  source: npm/rules/tauri/js/cargo_mutants_config.mjs
   crc: 7dc410ce
   score: 80
 ---
 
-# cargo_mutants_config.mjs
-
-## Огляд
-
 Огляд
 
 Файл виконує пошук пакетів у монорепо, які містять директорії `src-tauri/`. Обробляється конфігураційні файли цих пакетів. Створюється або оновлюється файл `.cargo/mutants.toml` для забезпечення наявності певних ключів у конфігурації. (tauri.mdc)

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

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

package/rules/tauri/js/docs/tooling.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: tooling.mjs
+resource: npm/rules/tauri/js/tooling.mjs
 docgen:
-  source: npm/rules/tauri/js/tooling.mjs
   crc: 8f7bbb45
   score: 90
 ---
 
-# tooling.mjs
-
-## Огляд
-
 Огляд
 Файл виконує перевірку наявності залежностей Tauri у `package.json`, одиничного workspace-пакета Tauri, маркера Tauri та конфігурації `extensions.json`. Перевірка проводиться відповідно до правил, визначених у `tauri.mdc`.
 

package/rules/test/docs/fix.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: fix.mjs
+resource: npm/rules/test/fix.mjs
 docgen:
-  source: npm/rules/test/fix.mjs
   crc: 38cf876b
   score: 80
 ---
 
-# fix.mjs
-
-## Огляд
-
 Файл ініціює виконання визначеного правила. Він передає контекст прогону і викликає `runStandardRule` для отримання результату.
 
 ## Поведінка

package/rules/test/docs/index.md

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

package/rules/test/js/data/stryker_config/docs/index.md

@@ -0,0 +1,13 @@
+---
+type: Directory Index
+title: npm/rules/test/js/data/stryker_config
+resource: npm/rules/test/js/data/stryker_config/
+---
+
+# npm/rules/test/js/data/stryker_config
+
+| Файл | Тип |
+|---|---|
+| [stryker-vue-macros-ignorer.mjs](stryker-vue-macros-ignorer.md) | JS Module |
+| [stryker.config.baseline.mjs](stryker.config.baseline.md) | JS Module |
+| [stryker.config.vue.baseline.mjs](stryker.config.vue.baseline.md) | JS Module |

package/rules/test/js/data/stryker_config/docs/stryker-vue-macros-ignorer.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: stryker-vue-macros-ignorer.mjs
+resource: npm/rules/test/js/data/stryker_config/stryker-vue-macros-ignorer.mjs
 docgen:
-  source: npm/rules/test/js/data/stryker_config/stryker-vue-macros-ignorer.mjs
   crc: 30a5e9f9
 ---
 
-# stryker-vue-macros-ignorer.mjs
-
-## Огляд
-
 Файл `stryker-vue-macros-ignorer.mjs` — це Stryker `Ignore`-plugin (мутаційне тестування), який інструктує Stryker не мутувати виклики Vue `<script setup>`-макросів: `defineProps`, `defineEmits`, `defineModel`, `defineSlots`, `defineExpose`, `defineOptions`.
 
 Контекст проблеми:

package/rules/test/js/data/stryker_config/docs/stryker.config.baseline.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: stryker.config.baseline.mjs
+resource: npm/rules/test/js/data/stryker_config/stryker.config.baseline.mjs
 docgen:
-  source: npm/rules/test/js/data/stryker_config/stryker.config.baseline.mjs
   crc: 2c7c9c37
   score: 90
 ---
 
-# stryker.config.baseline.mjs
-
-## Огляд
-
 Файл ініціює процес тестування. Він визначає конфігурацію, область покриття, директорію для тимчасових файлів та формує ім'я файлу для JSON-звіту. Він керує збереженням результатів між запусками.
 
 ## Поведінка

package/rules/test/js/data/stryker_config/docs/stryker.config.vue.baseline.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: stryker.config.vue.baseline.mjs
+resource: npm/rules/test/js/data/stryker_config/stryker.config.vue.baseline.mjs
 docgen:
-  source: npm/rules/test/js/data/stryker_config/stryker.config.vue.baseline.mjs
   crc: 579865c3
   score: 95
 ---
 
-# stryker.config.vue.baseline.mjs
-
-## Огляд
-
 Файл запускає тестування за допомогою фреймворку vitest. Використовує конфігурацію vitest з файлом mutation.json. Налаштовує аналіз покриття для запуску лише на мутовані лінії кожного тесту. Визначає директорію тимчасових файлів за допомогою tempDirName. Генерує звіти у форматах json та clear-text за допомогою reporters. Конфігурує jsonReporter для збереження результатів у файлі reports/stryker/mutation.json. Увімкнено incremental для збереження результатів між запусками та відновлення після збою. Використовує incrementalFile для збереження стану для інкрементального запуску. Ігнорує мутації Vue `<script setup>`-макросів за допомогою плагінів. Ігнорує Vue-макроси за допомогою плагінів.
 
 ## Поведінка

package/rules/test/js/data/vitest_config/docs/index.md

@@ -0,0 +1,11 @@
+---
+type: Directory Index
+title: npm/rules/test/js/data/vitest_config
+resource: npm/rules/test/js/data/vitest_config/
+---
+
+# npm/rules/test/js/data/vitest_config
+
+| Файл | Тип |
+|---|---|
+| [vitest.config.baseline.js](vitest.config.baseline.md) | JS Module |

package/rules/test/js/data/vitest_config/docs/vitest.config.baseline.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: vitest.config.baseline.js
+resource: npm/rules/test/js/data/vitest_config/vitest.config.baseline.js
 docgen:
-  source: npm/rules/test/js/data/vitest_config/vitest.config.baseline.js
   crc: d32a8e2d
 ---
 
-# vitest.config.baseline.js
-
-## Огляд
-
 Файл `vitest.config.baseline.js` — це **еталонна (baseline) конфігурація Vitest**, яка використовується як test-data fixture у правилі `test` пакета `npm/rules`. Він задає мінімальний, але достатній набір опцій Vitest, що відповідає внутрішнім конвенціям проєкту: розкладку тестових файлів, exclude-патерни для штучних artefact-директорій (наприклад, sandbox-копій Stryker), середовище виконання та модель ізоляції паралельних воркерів.
 
 Файл одночасно виконує дві ролі:

package/rules/test/js/docs/cargo_mutants_config.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: cargo_mutants_config.mjs
+resource: npm/rules/test/js/cargo_mutants_config.mjs
 docgen:
-  source: npm/rules/test/js/cargo_mutants_config.mjs
   crc: 4078e955
   score: 100
 ---
 
-# cargo_mutants_config.mjs
-
-## Огляд
-
 Огляд
 
 Файл отримує робочий каталог, читає конфігурацію курсора та перевіряє налаштування проєкту. Перевіряється наявність правил rust або їх вимкнення, маніфестів Cargo та файлу canonical baseline. Якщо знайдено файл mutants.toml, процес створення файлу mutants.toml пропускається. У випадку наявності mutants.toml, створюється директорія для цільового файлу, копіюється canonical baseline у цей файл та повідомляється про створення файлу mutants.toml (test.mdc).

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

@@ -0,0 +1,16 @@
+---
+type: Directory Index
+title: npm/rules/test/js
+resource: npm/rules/test/js/
+---
+
+# npm/rules/test/js
+
+| Файл | Тип |
+|---|---|
+| [cargo_mutants_config.mjs](cargo_mutants_config.md) | JS Module |
+| [location.mjs](location.md) | JS Module |
+| [no-process-chdir.mjs](no-process-chdir.md) | JS Module |
+| [no-relative-fs-path.mjs](no-relative-fs-path.md) | JS Module |
+| [stryker_config.mjs](stryker_config.md) | JS Module |
+| [vitest-config-pool-forks.mjs](vitest-config-pool-forks.md) | JS Module |

package/rules/test/js/docs/location.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: location.mjs
+resource: npm/rules/test/js/location.mjs
 docgen:
-  source: npm/rules/test/js/location.mjs
   crc: 9ea5f9b8
   score: 100
 ---
 
-# location.mjs
-
-## Огляд
-
 Файл перевіряє структуру директорій для ідентифікації та визначення тестів. Він призначений для перегляду шляхів та формування інструкцій щодо коректного розміщення тестів. (test.mdc)
 
 ## Поведінка

package/rules/test/js/docs/no-process-chdir.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: no-process-chdir.mjs
+resource: npm/rules/test/js/no-process-chdir.mjs
 docgen:
-  source: npm/rules/test/js/no-process-chdir.mjs
   crc: 0ace6be6
   score: 100
 ---
 
-# no-process-chdir.mjs
-
-## Огляд
-
 Огляд
 Файл шукає викликний паттерн process.chdir у тестових файлах. Він перевіряє, чи викликає будь-який тестовий файл process.chdir, і генерує повідомлення про порушення (test.mdc).
 

package/rules/test/js/docs/no-relative-fs-path.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: no-relative-fs-path.mjs
+resource: npm/rules/test/js/no-relative-fs-path.mjs
 docgen:
-  source: npm/rules/test/js/no-relative-fs-path.mjs
   crc: 3b8f52db
   score: 100
 ---
 
-# no-relative-fs-path.mjs
-
-## Огляд
-
 Огляд
 Модуль виконує перевірку тестових файлів на наявність визначених порушень. Перевіряється наявність певних порушень та використання абсолютних шляхів у викликах функцій.
 

package/rules/test/js/docs/stryker_config.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: stryker_config.mjs
+resource: npm/rules/test/js/stryker_config.mjs
 docgen:
-  source: npm/rules/test/js/stryker_config.mjs
   crc: 7ea109c6
   score: 95
 ---
 
-# stryker_config.mjs
-
-## Огляд
-
 Цей файл виконує перевірку наявності певних файлів та конфігурацій у кореневих пакетах. Код працює з конфігами, визначеними у `mutation.json` та `package.json`, для забезпечення певних станів у системі.
 
 ## Поведінка

package/rules/test/js/docs/vitest-config-pool-forks.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: vitest-config-pool-forks.mjs
+resource: npm/rules/test/js/vitest-config-pool-forks.mjs
 docgen:
-  source: npm/rules/test/js/vitest-config-pool-forks.mjs
   crc: bb04a54b
   score: 100
 ---
 
-# vitest-config-pool-forks.mjs
-
-## Огляд
-
 Огляд
 Файл виконує перевірку конфігураційного файлу для підтвердження наявності певного параметра. Це робиться для запобігання гонці у process.cwd між паралельними тестовими файлами (test.mdc).
 

package/rules/text/docs/fix.md

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

package/rules/text/docs/index.md

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

package/rules/text/js/docs/forbidden-prettier.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: forbidden-prettier.mjs
+resource: npm/rules/text/js/forbidden-prettier.mjs
 docgen:
-  source: npm/rules/text/js/forbidden-prettier.mjs
   crc: a5dae608
   score: 100
 ---
 
-# forbidden-prettier.mjs
-
-## Огляд
-
 Огляд
 
 Файл виконує перевірку наявність заборонених файлів у корені проєкту. Перевірка здійснюється на відповідність конфігураціям, визначеним у файлі `.prettierrc.json`.

package/rules/text/js/docs/formatting.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: formatting.mjs
+resource: npm/rules/text/js/formatting.mjs
 docgen:
-  source: npm/rules/text/js/formatting.mjs
-  crc: 835343c3
+  crc: 67b016e2
   score: 100
 ---
 
-# formatting.mjs
-
-## Огляд
-
 Перевіряє наявність файлів з конфігурацій. Код використовує дані з конфігів з extensions.json, settings.json, target.json, .oxfmtrc.json, .cspell.json та package.json для виконання операцій.
 
 ## Поведінка

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

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

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

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: lint.mjs
+resource: npm/rules/text/js/lint.mjs
 docgen:
-  source: npm/rules/text/js/lint.mjs
-  crc: 49aab7ce
+  crc: eca3c531
   score: 100
 ---
 
-# lint.mjs
-
-## Огляд
-
 Файл надає функцію lint, яка делегує завдання CLI правилам. Функція не підтримує режим per-file, і параметр files ігнорується. Функція повертає Promise з кодом виходу.
 
 ## Поведінка

package/rules/text/lint/docs/cspell-fix.md

@@ -1,15 +1,13 @@
 ---
+type: JS Module
+title: cspell-fix.mjs
+resource: npm/rules/text/lint/cspell-fix.mjs
 docgen:
-  source: npm/rules/text/lint/cspell-fix.mjs
-  crc: 3ce66d8a
+  crc: b5585e0f
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 90
 ---
 
-# cspell-fix.mjs
-
-## Огляд
-
 Модуль інтегрує `cspell` у ланцюжок `lint-text` для виявлення орфографічних помилок. У режимі з можливістю виправлення, процес відбувається шляхом: детект (захоплення виводу) $\rightarrow$ групування знахідок по файлах $\rightarrow$ per-file `omlx-фікс` справжніх помилок (`llmLintFix`) $\rightarrow$ re-detect. У read-only режимі виконується лише детект, що гарантує нуль мутацій. Валідні терміни omlx залишаються, їх ловить повторний `cspell` (далі — у словник `@nitra/cspell-dict`).
 
 ## Поведінка

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

@@ -0,0 +1,15 @@
+---
+type: Directory Index
+title: npm/rules/text/lint
+resource: npm/rules/text/lint/
+---
+
+# npm/rules/text/lint
+
+| Файл | Тип |
+|---|---|
+| [cspell-fix.mjs](cspell-fix.md) | JS Module |
+| [lint.mjs](lint.md) | JS Module |
+| [run-dotenv-linter.mjs](run-dotenv-linter.md) | JS Module |
+| [run-shellcheck.mjs](run-shellcheck.md) | JS Module |
+| [run-v8r.mjs](run-v8r.md) | JS Module |

package/rules/text/lint/docs/lint.md

@@ -1,15 +1,13 @@
 ---
+type: JS Module
+title: lint.mjs
+resource: npm/rules/text/lint/lint.mjs
 docgen:
-  source: npm/rules/text/lint/lint.mjs
-  crc: d475ffbb
+  crc: 02550273
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 90
 ---
 
-# lint.mjs
-
-## Огляд
-
 runLintTextCli надає CLI-обгортку для послідовного лінтингу текстових файлів (text.mdc). Обгортка автоматично встановлює необхідні інструменти (`shellcheck`, `dotenv-linter`) через `ensureTool` перед виконанням ланцюжка перевірок. Ланцюжок включає: перевірку правопису (`cspell`), аналіз скриптів (`shellcheck`), перевірку конфігураційних файлів (`dotenv-linter`), форматування Markdown (`markdownlint-cli2`) та валідацію схем (`v8r`). При виявленні першого ненульового коду в ланцюжку, цей код повертається як код виходу, і подальші кроки не виконуються. runLintTextCli експортується для використання як підкоманда `lint-text` з `bin/n-cursor.js`.
 
 ## Поведінка

package/rules/text/lint/docs/run-dotenv-linter.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: run-dotenv-linter.mjs
+resource: npm/rules/text/lint/run-dotenv-linter.mjs
 docgen:
-  source: npm/rules/text/lint/run-dotenv-linter.mjs
   crc: 4719ac66
 ---
 
-# run-dotenv-linter.mjs
-
-## Огляд
-
 Модуль `run-dotenv-linter.mjs` інкапсулює інтеграцію зовнішнього інструмента **dotenv-linter** у ланцюжок `lint-text` правила `text` (тека `npm/rules/text/lint/`). Він виконує дві послідовні фази:
 
 1. **Авто-фікс** — `dotenv-linter fix -r --no-backup --quiet . --exclude …`. dotenv-linter сам застосовує всі підтримувані виправлення на місці (на відміну від shellcheck, який лише пропонує diff).

package/rules/text/lint/docs/run-shellcheck.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: run-shellcheck.mjs
+resource: npm/rules/text/lint/run-shellcheck.mjs
 docgen:
-  source: npm/rules/text/lint/run-shellcheck.mjs
   crc: 6b2daaa8
 ---
 
-# run-shellcheck.mjs
-
-## Огляд
-
 Модуль `run-shellcheck.mjs` — частина ланцюжка `lint-text` для перевірки якості shell-скриптів (`*.sh`) у проєкті за допомогою зовнішнього інструменту **ShellCheck**. Скрипт виконує два етапи:
 
 1. **Авто-виправлення**: оскільки ShellCheck не має прапорця `--fix`, для кожного знайденого `*.sh` файла модуль запускає `shellcheck -f diff` і застосовує отриманий unified-diff через системну утиліту `patch -p1` у корені проєкту. Цикл повторюється до `MAX_FIX_ROUNDS_PER_FILE` (32) разів, поки залишаються авто-виправні зауваження.