@nitra/cursor 12.8.2 → 12.8.4

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

@@ -15,15 +15,15 @@ import { parseSkillAutoSpec, readSkillMetaRaw } from '../../../scripts/lib/skill
 function checkSkillFields(id, raw, reporter) {
   let ok = true
   if (typeof raw.worktree !== 'boolean') {
-    reporter.fail(`skills/${id}: meta.json.worktree має бути boolean`)
+    reporter.fail(`skills/${id}: main.json.worktree має бути boolean`)
     ok = false
   }
   if (raw.auto !== undefined && parseSkillAutoSpec(raw.auto) === null) {
-    reporter.fail(`skills/${id}: meta.json.auto нерозпізнане — очікується "завжди" або непорожній масив правил`)
+    reporter.fail(`skills/${id}: main.json.auto нерозпізнане — очікується "завжди" або непорожній масив правил`)
     ok = false
   }
   if (raw.requireRoot !== undefined && typeof raw.requireRoot !== 'boolean') {
-    reporter.fail(`skills/${id}: meta.json.requireRoot має бути boolean`)
+    reporter.fail(`skills/${id}: main.json.requireRoot має бути boolean`)
     ok = false
   }
   if (raw.worktree === true && raw.requireRoot === false) {
@@ -46,20 +46,20 @@ function checkSkill(id, skillDir, reporter) {
   let skillOk = true
 
   if (existsSync(join(skillDir, 'auto.md'))) {
-    reporter.fail(`skills/${id}: залишковий auto.md — видали (метадані тепер у meta.json)`)
+    reporter.fail(`skills/${id}: залишковий auto.md — видали (метадані тепер у main.json)`)
     skillOk = false
   }
 
   const raw = readSkillMetaRaw(skillDir)
   if (!raw) {
-    reporter.fail(`skills/${id}: відсутній або невалідний meta.json (очікується {"auto"?, "worktree": bool})`)
+    reporter.fail(`skills/${id}: відсутній або невалідний main.json (очікується {"auto"?, "worktree": bool})`)
     return
   }
 
   if (!checkSkillFields(id, raw, reporter)) skillOk = false
 
   if (skillOk) {
-    reporter.pass(`skills/${id}: meta.json валідний`)
+    reporter.pass(`skills/${id}: main.json валідний`)
   }
 }
 

package/rules/{style-lint → style}/docs/fix.md

@@ -1,7 +1,7 @@
 ---
 type: JS Module
 title: fix.mjs
-resource: npm/rules/style-lint/fix.mjs
+resource: npm/rules/style/fix.mjs
 docgen:
   crc: 38cf876b
   score: 100

package/rules/{style-lint → style}/docs/index.md

@@ -1,10 +1,10 @@
 ---
 type: Directory Index
-title: npm/rules/style-lint
-resource: npm/rules/style-lint/
+title: npm/rules/style
+resource: npm/rules/style/
 ---
 
-# npm/rules/style-lint
+# npm/rules/style
 
 | Файл                | Тип       |
 | ------------------- | --------- |

package/rules/{style-lint → style}/docs/main.md

@@ -1,7 +1,7 @@
 ---
 type: JS Module
 title: main.mjs
-resource: npm/rules/style-lint/main.mjs
+resource: npm/rules/style/main.mjs
 docgen:
   crc: d4951ce5
   model: omlx/gemma-4-e4b-it-OptiQ-4bit

package/rules/{style-lint → style}/js/docs/index.md

@@ -1,10 +1,10 @@
 ---
 type: Directory Index
-title: npm/rules/style-lint/js
-resource: npm/rules/style-lint/js/
+title: npm/rules/style/js
+resource: npm/rules/style/js/
 ---
 
-# npm/rules/style-lint/js
+# npm/rules/style/js
 
 | Файл                      | Тип       |
 | ------------------------- | --------- |

package/rules/{style-lint → style}/js/docs/tooling.md

@@ -1,9 +1,9 @@
 ---
 type: JS Module
 title: tooling.mjs
-resource: npm/rules/style-lint/js/tooling.mjs
+resource: npm/rules/style/js/tooling.mjs
 docgen:
-  crc: 631f5de8
+  crc: bc2b0934
   score: 80
 ---
 
@@ -18,7 +18,7 @@ docgen:
 
 ## Публічний API
 
-check — Перевіряє відповідність проєкту правилам style-lint.mdc
+check — Перевіряє відповідність проєкту правилам style.mdc
 
 ## Гарантії поведінки
 

package/rules/{style-lint → style}/js/tooling.mjs

@@ -44,7 +44,7 @@ async function checkStylelintConfigPresence(reporter, cwd) {
 // `npx @nitra/cursor fix`. JS-копії видалено, щоб не було двох джерел істини.
 
 /**
- * Перевіряє відповідність проєкту правилам style-lint.mdc
+ * Перевіряє відповідність проєкту правилам style.mdc
  * @param {string} [cwd] корінь репозиторію
  * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
  */

package/rules/{style-lint/style-lint.mdc → style/main.mdc}

@@ -95,7 +95,7 @@ $white-a1: color.adjust(white, $alpha: -0.85);
 
 - **Джерело правил:** перед тим як писати або суттєво змінювати **`.css`**, **`.scss`** або стилі в **`.vue`**, переглянь у корені проєкту (і в релевантних пакетах монорепо, якщо є) поле **`stylelint`** у **`package.json`** (зокрема `extends`), наявні **`.stylelintrc.*`**, **`stylelint.config.*`** та **`.stylelintignore`**. Не покладайся на «типові» правила stylelint з пам’яті — дотримуйся **проєктного** **`@nitra/stylelint-config`** і будь-яких локальних доповнень у репозиторії.
 - **Форматування** узгоджуй з **`n-text.mdc`** (oxfmt / `.oxfmtrc.json` для css, scss тощо), щоб форматер і stylelint не суперечили один одному.
-- **Запуск stylelint:** лише через **`n-cursor lint style-lint`** (локально — з auto-fix; у CI — `--read-only`, нуль мутацій). Під капотом — `npx stylelint`; **не** використовуй **`bunx stylelint`**. Після змін запускай **`n-cursor lint style-lint`** і виправляй усе, що лишилось після auto-fix; за потреби — повний прогін `n-cursor lint --full`.
+- **Запуск stylelint:** лише через **`n-cursor lint style`** (локально — з auto-fix; у CI — `--read-only`, нуль мутацій). Під капотом — `npx stylelint`; **не** використовуй **`bunx stylelint`**. Після змін запускай **`n-cursor lint style`** і виправляй усе, що лишилось після auto-fix; за потреби — повний прогін `n-cursor lint --full`.
 - **Не розширюй винятки:** не додавай зайві **`stylelint-disable`** без потреби; краще підлаштувати стилі під правила проєкту.
 
 ## Канон
@@ -104,7 +104,7 @@ $white-a1: color.adjust(white, $alpha: -0.85);
 
 - `stylelint.extends`: [package.json.snippet.json](./policy/package_json/template/package.json.snippet.json)
 
-Окремого `lint-style` скрипта немає — запуск через **`n-cursor lint style-lint`** (CI — `--read-only`).
+Окремого `lint-style` скрипта немає — запуск через **`n-cursor lint style`** (CI — `--read-only`).
 
 ### `.vscode/extensions.json`
 
@@ -129,7 +129,7 @@ $white-a1: color.adjust(white, $alpha: -0.85);
   },
 ```
 
-Додай **`.github/workflows/lint-style.yml`** (лише **`.yml`**, **`ga.mdc`**): після **`checkout`** — локальний composite **`setup-bun-deps`**, далі `n-cursor lint style-lint --read-only` у кроці **`run`**. **Не** дублюй окремі кроки **`setup-node`** / **`oven-sh/setup-bun`** / кеш / **`npm install`**.
+Додай **`.github/workflows/lint-style.yml`** (лише **`.yml`**, **`ga.mdc`**): після **`checkout`** — локальний composite **`setup-bun-deps`**, далі `n-cursor lint style --read-only` у кроці **`run`**. **Не** дублюй окремі кроки **`setup-node`** / **`oven-sh/setup-bun`** / кеш / **`npm install`**.
 
 ```yaml title=".github/workflows/lint-style.yml"
 name: StyleLint

package/rules/{style-lint → style}/policy/lint_style_yml/lint_style_yml.rego

@@ -1,4 +1,4 @@
-# Перевірка `lint-style.yml` (style-lint.mdc).
+# Перевірка `lint-style.yml` (style.mdc).
 #
 # Канон надходить через --data: { "template": { "snippet": ... } }
 # Структура --data сформована з template/lint-style.yml.snippet.yml.
@@ -23,7 +23,7 @@ all_run_text := concat("\n", [run_text |
 deny contains msg if {
 	expected_run_blob != ""
 	not contains(all_run_text, expected_run_blob)
-	msg := sprintf("lint-style.yml: жоден крок run не містить %q (style-lint.mdc)", [expected_run_blob])
+	msg := sprintf("lint-style.yml: жоден крок run не містить %q (style.mdc)", [expected_run_blob])
 }
 
 step_run_to_text(step) := step.run if is_string(step.run)

package/rules/{style-lint → style}/policy/lint_style_yml/template/lint-style.yml.snippet.yml

@@ -36,4 +36,4 @@ jobs:
       - uses: ./.github/actions/setup-bun-deps
 
       - name: StyleLint
-        run: n-cursor lint style-lint --read-only
+        run: n-cursor lint style --read-only

package/rules/{style-lint → style}/policy/package_json/package_json.rego

@@ -1,4 +1,4 @@
-# Порт перевірок `package.json` (style-lint.mdc).
+# Порт перевірок `package.json` (style.mdc).
 #
 # Канон надходить через --data: { "template": { "contains": ..., "snippet": ... } }
 # Структура --data сформована з template/package.json.{contains,snippet}.json.
@@ -19,7 +19,7 @@ deny contains msg if {
 	some leaf_key, expected_value in expected_inner
 	actual := object.get(cfg, leaf_key, null)
 	actual != expected_value
-	msg := sprintf("package.json: %s.%s має бути %q (style-lint.mdc)", [section, leaf_key, expected_value])
+	msg := sprintf("package.json: %s.%s має бути %q (style.mdc)", [section, leaf_key, expected_value])
 }
 
 # ── deny: @nitra/stylelint-config у devDependencies (inverse) ────────────
@@ -27,5 +27,5 @@ deny contains msg if {
 deny contains msg if {
 	dev := object.get(input, "devDependencies", {})
 	not "@nitra/stylelint-config" in object.keys(dev)
-	msg := "@nitra/stylelint-config відсутній — bun add -d @nitra/stylelint-config (style-lint.mdc)"
+	msg := "@nitra/stylelint-config відсутній — bun add -d @nitra/stylelint-config (style.mdc)"
 }

package/rules/{style-lint → style}/policy/vscode_extensions/vscode_extensions.rego

@@ -1,4 +1,4 @@
-# Перевірка `.vscode/extensions.json` для style-lint (style-lint.mdc).
+# Перевірка `.vscode/extensions.json` для style (style.mdc).
 #
 # Канон надходить через --data: { "template": { "snippet": ... } }
 # Структура --data сформована з template/extensions.json.snippet.json.
@@ -9,5 +9,5 @@ import rego.v1
 deny contains msg if {
 	some rec in data.template.snippet.recommendations
 	not rec in {r | some r in object.get(input, "recommendations", [])}
-	msg := sprintf(".vscode/extensions.json: recommendations має містити %q (style-lint.mdc)", [rec])
+	msg := sprintf(".vscode/extensions.json: recommendations має містити %q (style.mdc)", [rec])
 }

package/rules/{style-lint → style}/policy/vscode_settings/vscode_settings.rego

@@ -1,4 +1,4 @@
-# Перевірка `.vscode/settings.json` для style-lint (style-lint.mdc).
+# Перевірка `.vscode/settings.json` для style (style.mdc).
 #
 # Канон надходить через --data: { "template": { "snippet": ... } }
 # Структура --data сформована з template/settings.json.snippet.json.
@@ -11,5 +11,5 @@ deny contains msg if {
 	some key, expected_value in data.template.snippet
 	actual := object.get(input, key, null)
 	actual != expected_value
-	msg := sprintf(".vscode/settings.json: \"%s\" має бути %v (style-lint.mdc)", [key, expected_value])
+	msg := sprintf(".vscode/settings.json: \"%s\" має бути %v (style.mdc)", [key, expected_value])
 }

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

@@ -6,11 +6,11 @@ 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 |
+| Файл | Тип |
+|---|---|
+| [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/stryker_config.md

@@ -3,48 +3,31 @@ type: JS Module
 title: stryker_config.mjs
 resource: npm/rules/test/js/stryker_config.mjs
 docgen:
-  crc: 7ea109c6
-  score: 95
+  crc: be62c446
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
 ---
 
-Цей файл виконує перевірку наявності певних файлів та конфігурацій у кореневих пакетах. Код працює з конфігами, визначеними у `mutation.json` та `package.json`, для забезпечення певних станів у системі.
+## Огляд
+
+Модуль ініціалізує та налаштовує середовище для покриття коду, перевіряючи конфігурації, зокрема `mutation.json` та `package.json`. Він створює або оновлює конфігураційні файли Stryker, Vue-макросів та Vitest для кожного знайденого кореневого каталогу JavaScript. Функція `check` виконує перевірку, ігноруючи каталоги `node_modules`. Поведінка модуля фіксується за маркером (test.mdc). Модуль перехоплює помилки (fail-safe) і не кидає винятків назовні.
 
 ## Поведінка
 
-1. Перевірити наявність `js` у конфігурації.
-2. Зібрати кореневі пакети.
-3. Перевірити наявність базових конфігурацій.
-4. Перевірити наявність базлайн-файлів.
-5. Для кожного кореневого пакета перевірити наявність `.vue` файлів.
-6. Для кожного кореневого пакета згенерувати ім'я конфігурації.
-7. Для кожного кореневого пакета перевірити наявність необхідних базлайн-файлів.
-8. Для кожного кореневого пакета перевірити наявність `stryker.config.mjs`.
-9. Для кожного кореневого пакета перевірити наявність `vitest.config.mjs` або `vitest.config.js`.
-10. Для кожного кореневого пакета перевірити наявність базових базлайн-файлів.
-11. Для кожного кореневого пакета перевірити наявність `stryker.config.mjs`.
-12. Для кожного кореневого пакета перевірити наявність `vitest.config.mjs` або `vitest.config.js`.
-13. Для кожного кореневого пакета перевірити наявність базових базлайн-файлів.
-14. Для кожного кореневого пакета перевірити наявність `stryker.config.mjs`.
-15. Для кожного кореневого пакета перевірити наявність `vitest.config.mjs` або `vitest.config.js`.
-16. Для кожного кореневого пакета перевірити наявність базових базлайн-файлів.
-17. Для кожного кореневого пакета перевірити наявність `stryker.config.mjs`.
-18. Для кожного кореневого пакета перевірити наявність `vitest.config.mjs` або `vitest.config.js`.
-19. Для кожного кореневого пакета перевірити наявність базових базлайн-файлів.
-20. Для кожного кореневого пакета перевірити наявність `stryker.config.mjs`.
-21. Для кожного кореневого пакета перевірити наявність `vitest.config.mjs` або `vitest.config.js`.
-22. Для кожного кореневого пакета перевірити наявність базових базлайн-файлів.
-23. Для кожного кореневого пакета перевірити наявність `stryker.config.mjs`.
-24. Для кожного кореневого пакета перевірити наявність `vitest.config.mjs` або `vitest.config.js`.
-25. Для кожного кореневого пакета перевірити наявність базових базлайн-файлів.
-26. Для кожного кореневого пакета перевірити наявність `stryker.config.mjs`.
-27. Для кожного кореневого пакета перевірити наявність `vitest.config.mjs` або `vitest.config.js`.
-28. Для кожного кореневого пакета перевірити наявність базових базлайн-файлів.
-29. Для кожного кореневого пакета перевірити наявність `stryker.config.mjs`.
-30. Для кожного кореневого пакета перевірити наявність `vitest.config.mjs` або `vitest.config.js`.
+1. Викликається `check` для ініціалізації процесу перевірки.
+2. Перевіряється, чи у конфігурації дозволено перевірку JavaScript. Якщо ні, процес завершується успішно.
+3. Знаходяться всі кореневі каталоги JavaScript у робочому просторі. Якщо їх немає, процес завершується з помилкою.
+4. Перевіряється наявність усіх канонічних базових конфігураційних файлів. Якщо хоча б один відсутній, процес завершується з помилкою.
+5. Для кожного знайденого кореневого каталогу JavaScript:
+    а. Визначається, чи містить цей каталог файли Vue.
+    б. Створюється або оновлюється конфігураційний файл Stryker для цього каталогу. Якщо файл відсутній, він копіюється з канонічного базового файлу, замінюючи ім'я конфігурації Vitest на фактичне ім'я конфігу каталогу. Якщо файл існує, він залишається без змін.
+    в. Якщо каталог містить файли Vue і конфігураційний файл Stryker вже існував, виконується аугментація конфігурації. Це додає локальний плагін Vue-макросів до конфігурації Stryker, якщо він відсутній.
+    г. Створюється або оновлюється конфігураційний файл плагіна Vue-макросів.
+    д. Створюється або оновлюється конфігураційний файл Vitest для каталогу, використовуючи фактичне ім'я конфігу.
+6. Виконується гарантія, що файли з результатами тестів Stryker та покриття (lcov) не потрапляють у систему контролю версій. Якщо додаються нові патерни до `.gitignore`, це фіксується як успіх (test.mdc).
+7. Процес завершується з кодом виходу, що відображає успіх або помилку.
 
 ## Гарантії поведінки
 
 - Перехоплює помилки і не пропускає винятків назовні (fail-safe).
-- За невдачі повертає значення помилки (`false`/`null`/`Err`) замість генерування винятку чи паніки.
 - Свідомо пропускає шляхи: `node_modules`.
-- Не звертається до мережі.

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

@@ -3,27 +3,29 @@ type: JS Module
 title: vitest-config-pool-forks.mjs
 resource: npm/rules/test/js/vitest-config-pool-forks.mjs
 docgen:
-  crc: bb04a54b
+  crc: c8640fd7
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
 
-Огляд
-Файл виконує перевірку конфігураційного файлу для підтвердження наявності певного параметра. Це робиться для запобігання гонці у process.cwd між паралельними тестовими файлами (test.mdc).
+## Огляд
+
+Модуль визначає, чи встановлено режим `pool: 'forks'` у конфігураційному файлі Vitest. Перевірка здійснюється у `vitest.config.mjs` або `vitest.config.js` кореневого репозиторію. Це забезпечує коректну поведінку при паралельному запуску тестових файлів. Результат перевірки фіксується у test.mdc.
 
 ## Поведінка
 
-1. Знайти файл конфігурації з назвою vitest.config.mjs або vitest.config.js у вказаному шляху.
-2. Якщо файл знайдено, прочитати його вміст.
-3. Перевірити вміст файлу на наявність патерну pool: 'forks'.
-4. Якщо патерн знайдено, повідомити про успішне виконання перевірки.
-5. Якщо патерн відсутній, повідомити про невдачу, вказуючи, що конфігурація повинна містити pool: 'forks' для захисту від гонки у process.cwd між паралельними test files (test.mdc).
-6. Якщо файл конфігурації не знайдено, повідомити, що перевірка пропущено.
+1. Визначається назва конфігураційного файлу Vitest, шукаючи спочатку `vitest.config.mjs`, а потім `vitest.config.js` у корені репозиторію.
+2. Якщо конфігураційний файл відсутній, виконується пропуск перевірки, і повертається код успіху.
+3. Якщо конфігураційний файл знайдено, його вміст зчитується.
+4. Перевіряється, чи містить вміст конфігураційного файлу рядок, що вказує на використання `pool: 'forks'`.
+5. Якщо рядок знайдено, фіксується успіх (test.mdc).
+6. Якщо рядок не знайдено, фіксується помилка (test.mdc), оскільки це необхідно для захисту від гонки у `process.cwd` між паралельними тестовими файлами.
+7. Функція `check` повертає код виходу, що відображає результат перевірки (0 для успіху/пропуску, 1 для помилки).
 
 ## Публічний API
 
-check — перевіряє, чи налаштування `vitest.config.{mjs,js}` використовує `pool: 'forks'`. (test.mdc)
+check — перевіряє наявність конфігурації `pool: 'forks'` у файлі `vitest.config.{mjs,js}`. (test.mdc)
 
 ## Гарантії поведінки
 
-- Read-only: файл не виконує операцій запису у файлову систему.
-- Не звертається до мережі.
+- Read-only: не виконує операцій запису (ФС/БД).

package/schemas/v8r-catalog.json

@@ -28,14 +28,14 @@
     },
     {
       "name": "n-cursor skill meta",
-      "description": "Маніфест skill-пакета n-cursor (npm/skills/<id>/meta.json) — назва, тригери, дозволи",
-      "fileMatch": ["npm/skills/*/meta.json"],
+      "description": "Маніфест skill-пакета n-cursor (npm/skills/<id>/main.json) — назва, тригери, дозволи",
+      "fileMatch": ["npm/skills/*/main.json"],
       "url": "https://unpkg.com/@nitra/cursor/schemas/skill-meta.json"
     },
     {
       "name": "n-cursor rule meta",
-      "description": "Маніфест rule-пакета n-cursor (npm/rules/<id>/meta.json) — назва, опис, версія правила",
-      "fileMatch": ["npm/rules/*/meta.json"],
+      "description": "Маніфест rule-пакета n-cursor (npm/rules/<id>/main.json) — назва, опис, версія правила",
+      "fileMatch": ["npm/rules/*/main.json"],
       "url": "https://unpkg.com/@nitra/cursor/schemas/rule-meta.json"
     }
   ]

package/scripts/docs/index.md

@@ -6,20 +6,20 @@ resource: npm/scripts/
 
 # npm/scripts
 
-| Файл                                                                                | Тип       |
-| ----------------------------------------------------------------------------------- | --------- |
-| [auto-rules.mjs](auto-rules.md)                                                     | JS Module |
-| [auto-skills.mjs](auto-skills.md)                                                   | JS Module |
-| [build-agents-commands.mjs](build-agents-commands.md)                               | JS Module |
-| [cli-entry.mjs](cli-entry.md)                                                       | JS Module |
-| [coverage-fix-extract.mjs](coverage-fix-extract.md)                                 | JS Module |
-| [coverage-fix.mjs](coverage-fix.md)                                                 | JS Module |
+| Файл | Тип |
+|---|---|
+| [auto-rules.mjs](auto-rules.md) | JS Module |
+| [auto-skills.mjs](auto-skills.md) | JS Module |
+| [build-agents-commands.mjs](build-agents-commands.md) | JS Module |
+| [cli-entry.mjs](cli-entry.md) | JS Module |
+| [coverage-fix-extract.mjs](coverage-fix-extract.md) | JS Module |
+| [coverage-fix.mjs](coverage-fix.md) | JS Module |
 | [ensure-nitra-cursor-dev-dependencies.mjs](ensure-nitra-cursor-dev-dependencies.md) | JS Module |
-| [post-tool-use-check.mjs](post-tool-use-check.md)                                   | JS Module |
-| [post-tool-use-fix.mjs](post-tool-use-fix.md)                                       | JS Module |
-| [rename-yaml-extensions.mjs](rename-yaml-extensions.md)                             | JS Module |
-| [skills-cli.mjs](skills-cli.md)                                                     | JS Module |
-| [sync-claude-config.mjs](sync-claude-config.md)                                     | JS Module |
-| [sync-setup-bun-deps-action.mjs](sync-setup-bun-deps-action.md)                     | JS Module |
-| [upgrade-nitra-cursor-and-install.mjs](upgrade-nitra-cursor-and-install.md)         | JS Module |
-| [worktree-cli.mjs](worktree-cli.md)                                                 | JS Module |
+| [post-tool-use-check.mjs](post-tool-use-check.md) | JS Module |
+| [post-tool-use-fix.mjs](post-tool-use-fix.md) | JS Module |
+| [rename-yaml-extensions.mjs](rename-yaml-extensions.md) | JS Module |
+| [skills-cli.mjs](skills-cli.md) | JS Module |
+| [sync-claude-config.mjs](sync-claude-config.md) | JS Module |
+| [sync-setup-bun-deps-action.mjs](sync-setup-bun-deps-action.md) | JS Module |
+| [upgrade-nitra-cursor-and-install.mjs](upgrade-nitra-cursor-and-install.md) | JS Module |
+| [worktree-cli.mjs](worktree-cli.md) | JS Module |

package/scripts/docs/sync-setup-bun-deps-action.md

@@ -3,28 +3,27 @@ type: JS Module
 title: sync-setup-bun-deps-action.mjs
 resource: npm/scripts/sync-setup-bun-deps-action.mjs
 docgen:
-  crc: 098d7209
+  crc: 327991b2
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
 ---
 
-Файл містить конфігурацію GitHub Action `setup-bun-deps`, яка автоматично встановлює залежності проєкту Bun. Він використовується workflow для підготовки середовища проєкту, забезпечуючи узгодженість та спрощуючи виконання тестів та інших завдань, що потребують Bun. Це дозволяє workflow, що використовує `actions/checkout@v6`, безпосередньо використовувати action, не потребуючи додаткової конфігурації.
+## Огляд
+
+Копіює composite GitHub Action `setup-bun-deps` з каталогу `github-actions/setup-bun-deps/` у цільовий репозиторій (`.github/actions/setup-bun-deps/`). Це забезпечує можливість робочим процесам з правил `ga`, `js` та `text` викликати локально розміщений action (`uses: ./.github/actions/setup-bun-deps`) одразу після виконання `actions/checkout@v6`, використовуючи CLI `npx \@nitra/cursor`.
 
 ## Поведінка
 
-1.  Перевіряє наявність шаблону composite action `action.yml` у каталозі `github-actions/setup-bun-deps/` всередині кореня пакету `@nitra/cursor`.
-2.  Якщо шаблон не знайдено, кидає помилку, вказуючи очікуваний шлях та пропонуючи перевстановити пакет.
-3.  Створює каталог `.github/actions/setup-bun-deps` у цільовому репозиторії, якщо його не існує.
-4.  Зчитує вміст файлу `action.yml` з джерела.
-5.  Записує вміст `action.yml` у файл `action.yml` у цільовому репозиторії. Додає новий рядок в кінці файлу, якщо потрібно.
-6.  Повертає об'єкт, що містить інформацію про успішність запису та повний шлях до створеного файлу.
+1. Перевіряє наявність шаблону composite action у корені встановленого пакету `@nitra/cursor`.
+2. Створює необхідну директорію для composite action у корені цільового репозиторію, ігноруючи шляхи `.github` та `.git`.
+3. Зчитує вміст шаблону composite action.
+4. Записує вміст шаблону у цільовий шлях composite action у корені цільового репозиторію, гарантуючи наявність завершального символу нового рядка.
+5. Повертає підтвердження успішного запису та повний шлях до файлу.
 
 ## Публічний API
 
-syncSetupBunDepsAction — Створює файл з залежностями Bun, використовуючи корінь пакета `@nitra/cursor`.
+syncSetupBunDepsAction — фіксує в `projectRoot` композитну дію з коренем встановленого `@nitra/cursor`.
 
 ## Гарантії поведінки
 
-- Копіює файл `action.yml` з каталогу `github-actions/setup-bun-deps/` у каталог `.github/actions/setup-bun-deps/`.
-- Забезпечує доступність action `setup-bun-deps` для workflow, що використовує `actions/checkout@v6`.
-- Використовує `npx @nitra/cursor` для ініціалізації action.
-- Не враховує наявність checkout runner.
-- Не має кешування.
+- Свідомо пропускає шляхи: `.github`, `.git`.

package/scripts/lib/check-mdc-template-refs.mjs

@@ -45,8 +45,8 @@ async function collectFiles(dir) {
  * @param {string} ruleId basename правила (напр. "security")
  * @returns {Promise<string[]>} відносні шляхи template-файлів без посилань у .mdc
  */
-export async function findMissingMdcRefs(ruleDir, ruleId) {
-  const mdcPath = join(ruleDir, `${ruleId}.mdc`)
+export async function findMissingMdcRefs(ruleDir) {
+  const mdcPath = join(ruleDir, 'main.mdc')
   if (!existsSync(mdcPath)) return []
   const mdc = await readFile(mdcPath, 'utf8')
   const allFiles = await walkTemplateDirs(ruleDir)