@nitra/cursor 11.4.0 → 12.0.0

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) разів, поки залишаються авто-виправні зауваження.

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

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: run-v8r.mjs
+resource: npm/rules/text/lint/run-v8r.mjs
 docgen:
-  source: npm/rules/text/lint/run-v8r.mjs
   crc: caf707a8
 ---
 
-# run-v8r.mjs
-
-## Огляд
-
 Модуль `run-v8r.mjs` — це послідовний раннер CLI-валідатора схем `v8r` для всіх типів файлів, які він підтримує (`.json`, `.json5`, `.yml`, `.yaml`, `.toml`). Він є проміжним рівнем між кореневою командою `lint-text` та `bunx v8r`.
 
 Призначення модуля — обійти специфічну ваду `v8r`: якщо у єдиний виклик передати кілька glob-патернів і хоча б один із них не знаходить жодного файлу, процес `v8r` падає з кодом виходу `98`, тому решта розширень узагалі не перевіряється. Щоб уникнути цього, скрипт виконує **окремий** `bunx v8r` на **кожен** glob і толерантно ставиться до коду `98` (порожнє співпадіння — не помилка).

package/rules/vue/docs/fix.md

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

package/rules/vue/docs/index.md

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

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

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

package/rules/vue/js/docs/packages.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: packages.mjs
+resource: npm/rules/vue/js/packages.mjs
 docgen:
-  source: npm/rules/vue/js/packages.mjs
   crc: 6119ae9c
   score: 85
 ---
 
-# packages.mjs
-
-## Огляд
-
 isVueComponentLibraryPkg
 Перевіряє, чи є пакет бібліотекою компонентів Vue шляхом перевірки `peerDependencies`.
 

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

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

package/rules/vue/lib/docs/vue-forbidden-imports.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: vue-forbidden-imports.mjs
+resource: npm/rules/vue/lib/vue-forbidden-imports.mjs
 docgen:
-  source: npm/rules/vue/lib/vue-forbidden-imports.mjs
   crc: 946eb1a6
 ---
 
-# vue-forbidden-imports.mjs
-
-## Огляд
-
 Модуль `vue-forbidden-imports.mjs` — це бібліотека статичного аналізу `import`-декларацій, призначена для виявлення двох категорій порушень у вихідному коді Vue-проєкту:
 
 1. **Явні (runtime) імпорти з модуля `vue`** у будь-яких файлах, що сканує правило. За конвенцією `vue.mdc` у проєкті працює `unplugin-auto-import`, тому імпорти `ref`, `computed`, `watch` тощо мають бути неявними. Дозволено лише: side-effect форму (`import 'vue'`), повністю type-only імпорти (`import type { ... } from 'vue'`) та змішані форми, де **всі** іменовані записи мають флаг `isType` (наприклад, `import { type A, type B } from 'vue'`).

package/rules/vue/vue.mdc

@@ -1,6 +1,6 @@
 ---
 description: Vue
-version: '2.2'
+version: '2.3'
 globs: "**/*.vue"
 alwaysApply: false
 ---
@@ -110,6 +110,24 @@ const additionalInstructions = `
 - **debounce/throttle** для частих подій.
 - Після ручних **addEventListener** / підписок — прибирай у **onUnmounted**.
 
+### Функції в шаблоні
+
+Виклики функцій у шаблоні дозволені **лише** в обробниках подій (`@click`, `@change` тощо). У всіх інших місцях — `v-if`, `v-show`, атрибутах (`:prop`), інтерполяціях (`{{ }}`) — замінюй функції на `computed`-властивості: функція виконується при **кожному** render-і, тоді як `computed` кешується і перераховується лише при зміні залежностей.
+
+```vue
+<!-- ❌ функція в умові, атрибуті та інтерполяції -->
+<q-item v-if="getItems(order).length" :label="getLabel(item)">
+  {{ formatName(user) }}
+</q-item>
+
+<!-- ✅ реактивні змінні / computed / props -->
+<q-item v-if="itemsMap[order.id].length" :label="item.label">
+  {{ user.displayName }}
+</q-item>
+<!-- обробник події — виклик функції дозволений -->
+<q-btn @click="doSomething(item)" />
+```
+
 ### Безпека
 
 - Не довіряй **v-html** без санітизації; для форм/API — **CSRF**-захист за потреби; валідація **на сервері** обов’язкова.

package/rules/worktree/docs/fix.md

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

package/rules/worktree/docs/index.md

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

package/rules/worktree/worktree.mdc

@@ -1,13 +1,13 @@
 ---
-description: Конвенція git-worktree у цьому репо — створення, інвентаризація та прибирання через n-cursor worktree CLI.
+description: Конвенція git-worktree у цьому репо — створення, інвентаризація та прибирання через `mt worktree` (@7n/mt).
 globs:
 alwaysApply: true
 ---
 
 # Worktree-конвенція
 
-Усі git-worktree створюй і прибирай через CLI `n-cursor worktree` — він кладе їх у
-`.worktrees/` (gitignored) і веде інвентарний файл-опис поруч.
+Усі git-worktree створюй і прибирай через `mt worktree` (з пакета `@7n/mt`) — він кладе їх у
+`.worktrees/` (gitignored, checkout `<sanit>/`) і веде інвентарний файл-опис у `.worktrees/.meta/`.
 
 ## Розташування
 
@@ -74,10 +74,10 @@ Zed **замінює** масив `file_scan_exclusions` цілком (не зл
 
 ## Команди
 
-- **Створити** (опис обовʼязковий): `npx @nitra/cursor worktree add <branch> "<навіщо>"`
-- **Інвентаризація**: `npx @nitra/cursor worktree list`
-- **Прибрати**: `npx @nitra/cursor worktree remove <branch> [--force]`
-- **Прибрати осиротілі**: `npx @nitra/cursor worktree prune`
+- **Створити** (опис обовʼязковий): `mt worktree create <branch> "<навіщо>"`
+- **Інвентаризація**: `mt worktree list` (людино-) або `mt worktree inventory` (JSON)
+- **Прибрати** (ефемерний — прибирає й git-гілку): `mt worktree remove <branch>`
+- **Прибрати осиротілі інвентарі**: `mt worktree prune`
 
 ## Завершення гілки worktree
 
@@ -97,4 +97,4 @@ git checkout <base> && git merge --squash <branch> && git commit
 
 - Не клади worktree в `.claude/worktrees/` — це приватна директорія харнесу Claude Code.
 - Не клади worktree в батьківський каталог `../cursor-<name>` — ускладнює інвентаризацію.
-- Не створюй worktree вручну (`git worktree add`) повз CLI — інакше не буде інвентарного опису.
+- Не створюй worktree вручну (`git worktree add`) повз `mt worktree create` — інакше не буде інвентарного опису.

package/scripts/coverage-classify/docs/apply.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: apply.mjs
+resource: npm/scripts/coverage-classify/apply.mjs
 docgen:
-  source: npm/scripts/coverage-classify/apply.mjs
   crc: 0f54e6a0
 ---
 
-# apply.mjs
-
-## Огляд
-
 Модуль `apply.mjs` із пакета `coverage-classify` відповідає за **застосування вердиктів класифікатора мутаційних розривів** до табличних coverage-рядків. Він фільтрує список «вижилих» мутантів (`survived`) у кожному рядку, ділячи їх на дві категорії:
 
 1. **Allowed gaps** — мутанти, які класифікатор позначив як `equivalent`, `defensive`, `glue` або `wrapper` з рівнем впевненості (`confidence`) не нижче встановленого порогу. Такі мутанти виключаються з підрахунку «killable» (зменшують `mutation.total`) та виносяться в окремий список для подальшого рендеру в `COVERAGE.md`.

package/scripts/coverage-classify/docs/cache.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: cache.mjs
+resource: npm/scripts/coverage-classify/cache.mjs
 docgen:
-  source: npm/scripts/coverage-classify/cache.mjs
   crc: 53b251b1
 ---
 
-# cache.mjs
-
-## Огляд
-
 Модуль `cache.mjs` реалізує **file-hash-keyed cache** для вердиктів класифікатора покриття мутаційного тестування (`coverage-classify`). Призначення — уникати повторної (зазвичай дорогої — через LLM) класифікації того ж самого мутанта в незмінному файлі.
 
 Ключова ідея кешу:

package/scripts/coverage-classify/docs/index.md

@@ -1,32 +1,14 @@
 ---
+type: JS Module
+title: index.mjs
+resource: npm/scripts/coverage-classify/index.mjs
 docgen:
-  source: npm/scripts/coverage-classify/index.mjs
   crc: 06249ac8
-  score: 100
 ---
 
-# index.mjs
-
-## Огляд
-
-Файл забезпечує класифікацію записів через послідовну спробу отримання результату з кешу, первинного моделі та хмарного сервісу. Якщо кеш не містить даних, відбувається перехід до наступного рівня, доки не буде досягнуто консервативного запасного варіанту. Результати класифікації записуються у кеш. Код спирається на конфіги з файлу coverage-classify.cache.json.
-
-## Поведінка
-
-1. Пошук результату в кеші.
-2. Якщо результат знайдено, використовується збережений вердикт.
-3. Якщо результат не знайдено, намагається отримати вердикт через перший рівень.
-4. Якщо перший рівень не вдається, намагається отримати вердикт через другий рівень.
-5. Якщо другий рівень не вдається, використовується консервативний запасний варіант.
-6. Результати класифікації записуються в кеш.
-
-## Публічний API
-
-classify — Класифікує survived мутанти, перенаправляючи їх до CLOUD_MIN, якщо результат resolveModel дорівнює CLOUD_MIN, інакше до fallback.
-
-## Гарантії поведінки
-
-- Read-only: файл не виконує операцій запису у файлову систему.
-- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
-- Кешує результати в межах одного прогону.
-- Не звертається до мережі.
+| Файл | Тип | Опис |
+|---|---|---|
+| [apply.mjs](apply.md) | JS Module | Модуль apply.mjs із пакета coverage-classify відповідає за **застосування вердиктів класифікатора му |
+| [cache.mjs](cache.md) | JS Module | Модуль cache.mjs реалізує **file-hash-keyed cache** для вердиктів класифікатора покриття мутаційного |
+| [prompt.mjs](prompt.md) | JS Module | Модуль prompt.mjs — це prompt-builder для скрипта coverage-classify, що класифікує вцілілих мутантів |
+| [verdict-schema.mjs](verdict-schema.md) | JS Module | Файл надає схему VerdictSchema для валідації вердиктів LLM-класифікатора. |

package/scripts/coverage-classify/docs/prompt.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: prompt.mjs
+resource: npm/scripts/coverage-classify/prompt.mjs
 docgen:
-  source: npm/scripts/coverage-classify/prompt.mjs
   crc: 12bfb99a
 ---
 
-# prompt.mjs
-
-## Огляд
-
 Модуль `prompt.mjs` — це prompt-builder для скрипта `coverage-classify`, що класифікує вцілілих мутантів зі звіту Stryker через LLM. Файл експонує дві сутності:
 
 - статичний рядок `SYSTEM_PROMPT`, який описує LLM правила класифікації та формат JSON-відповіді;

package/scripts/coverage-classify/docs/verdict-schema.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: verdict-schema.mjs
+resource: npm/scripts/coverage-classify/verdict-schema.mjs
 docgen:
-  source: npm/scripts/coverage-classify/verdict-schema.mjs
   crc: ecf5dfe1
   score: 100
 ---
 
-# verdict-schema.mjs
-
-## Огляд
-
 Файл надає схему `VerdictSchema` для валідації вердиктів LLM-класифікатора. Функція `parseVerdict` витягує JSON-об'єкт з сирої текстової відповіді моделі та перевіряє його відповідність визначеній схемі.
 
 ## Поведінка

package/scripts/dispatcher/docs/index.md

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

package/scripts/dispatcher/docs/trace.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: trace.mjs
+resource: npm/scripts/dispatcher/trace.mjs
 docgen:
-  source: npm/scripts/dispatcher/trace.mjs
   crc: 8d541669
   score: 100
 ---
 
-# trace.mjs
-
-## Огляд
-
 Файл забезпечує наскрізну простежуваність артефактів. Він читає front-matter з директорій `docs/{tasks,specs,plans,adr}`, будує ланцюг за лінками та позначає розриви. Функції генерують аналіз, який потім рендериться у текстовий вивід, а трасування виконується для зчитування артефактів.
 
 ## Поведінка

package/scripts/docs/auto-rules.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: auto-rules.mjs
+resource: npm/scripts/auto-rules.mjs
 docgen:
-  source: npm/scripts/auto-rules.mjs
   crc: d50b922f
   score: 90
 ---
 
-# auto-rules.mjs
-
-## Огляд
-
 Файл читає метадані з `npm/rules/<id>/meta.json` для автоматичного визначення порядку та залежностей правил. Він обчислює spec активації для кожного правила, використовуючи дані з `RULE_PREDICATES` з `lib/rule-predicates.mjs`, визначає активні правила, обчислює залежності та об'єднує конфігурацію з виявленими правилами та поправками на legacy-id. Код спирається на конфіги `.n-cursor.json`, `meta.json` та `package.json`.
 
 ## Поведінка

package/scripts/docs/auto-skills.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: auto-skills.mjs
+resource: npm/scripts/auto-skills.mjs
 docgen:
-  source: npm/scripts/auto-skills.mjs
   crc: 44328898
 ---
 
-# `auto-skills.mjs`
-
-## Огляд
-
 Модуль `npm/scripts/auto-skills.mjs` відповідає за **автовизначення (auto-activation) скілів** для файлу конфігурації `.n-cursor.json`. Він сканує директорію `npm/skills/` і для кожного скілу читає його `meta.json`, щоб визначити, чи має скіл активуватися автоматично — завжди або лише за наявності певних виявлених auto-правил (rules).
 
 Ключова ідея модуля: **`meta.json` — єдине джерело правди**. У коді немає жорстко прописаної мапи відповідностей між скілами та правилами; усе зчитується з метаданих скіла. Раніше використовувався hardcoded `AUTO_SKILL_ORDER`, тепер він обчислюється динамічно — експорт залишено для зворотної сумісності.

package/scripts/docs/build-agents-commands.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: build-agents-commands.mjs
+resource: npm/scripts/build-agents-commands.mjs
 docgen:
-  source: npm/scripts/build-agents-commands.mjs
   crc: 5a4cde2f
 ---
 
-# build-agents-commands.mjs
-
-## Огляд
-
 Модуль `build-agents-commands.mjs` формує перелік маркованих елементів (bullet items) для секції «Команди» у файлі `AGENTS.md`, який згенерує CLI `@nitra/cursor` під час синхронізації правил/шаблону.
 
 Принципи побудови списку:

package/scripts/docs/cli-entry.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: cli-entry.mjs
+resource: npm/scripts/cli-entry.mjs
 docgen:
-  source: npm/scripts/cli-entry.mjs
   crc: b51b5d0a
 ---
 
-# `cli-entry.mjs`
-
-## Огляд
-
 Модуль `npm/scripts/cli-entry.mjs` — невеликий утилітарний ESM-модуль (Node.js, `.mjs`), який дає можливість іншому модулю-caller'у з'ясувати, **чи запущено його як точку входу CLI** (тобто прямим викликом `node my-script.mjs` або через `bin`-shim з `package.json`), **чи його просто імпортували** з іншого модуля (наприклад, з юніт-тестів, з фасадного CLI-агрегатора, з devtools).
 
 Це класична Node.js-задача: ESM-модулі не мають `require.main === module` ідіоми CommonJS, і canonical-альтернативою служить порівняння `import.meta.url` (URL поточного файлу-модуля) із `process.argv[1]` (шлях, переданий Node.js при запуску). Модуль інкапсулює цю перевірку в одну іменовану функцію `isRunAsCli(metaUrl)` і вирішує три типові проблеми «з полів»:

package/scripts/docs/coverage-fix-extract.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: coverage-fix-extract.mjs
+resource: npm/scripts/coverage-fix-extract.mjs
 docgen:
-  source: npm/scripts/coverage-fix-extract.mjs
   crc: a7f39f0e
 ---
 
-# coverage-fix-extract.mjs
-
-## Огляд
-
 Цей файл витягує вцілілі мутанти з файлу `COVERAGE.md` у форматі JSON. Витягнуті дані надаються агенту для вирішення проблем з покриттям, зменшуючи навантаження на LLM-оркестратор та забезпечуючи ефективний обмін інформацією. Це ключовий компонент процесу `n-coverage-fix`, що дозволяє агенту швидко реагувати на зміни в покритті.
 
 ## Поведінка

package/scripts/docs/coverage-fix.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: coverage-fix.mjs
+resource: npm/scripts/coverage-fix.mjs
 docgen:
-  source: npm/scripts/coverage-fix.mjs
   crc: 7f0568dd
 ---
 
-# coverage-fix.mjs
-
-## Огляд
-
 Файл `npm/scripts/coverage-fix.mjs` — це ESM-модуль, який реалізує fix-режим команди `n-cursor coverage --fix`. Його призначення — автоматично запустити агента Claude Code (через офіційний SDK `@anthropic-ai/claude-agent-sdk`) і доручити йому дописати unit-тести, які «вб'ють» вцілілих мутантів, знайдених попереднім прогоном Stryker.
 
 Модуль не виконує власних мутацій коду й не аналізує покриття самостійно — він є тонким адаптером між інвентарем вцілілих мутантів (структури `SurvivedFileGroup[]`, отримані ззовні) і LLM-агентом: формує rich-промпт з контекстом ±3 рядки навколо кожного мутанта, опційно додає приклад уже існуючого тесту, після чого ітерує по стрімінгу повідомлень агента та виводить його текстові реплики у `stdout`.

package/scripts/docs/ensure-nitra-cursor-dev-dependencies.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: ensure-nitra-cursor-dev-dependencies.mjs
+resource: npm/scripts/ensure-nitra-cursor-dev-dependencies.mjs
 docgen:
-  source: npm/scripts/ensure-nitra-cursor-dev-dependencies.mjs
   crc: c3df2c0e
 ---
 
-# ensure-nitra-cursor-dev-dependencies.mjs
-
-## Огляд
-
 Модуль `ensure-nitra-cursor-dev-dependencies.mjs` забезпечує, що пакет `@nitra/cursor` буде оголошений у `devDependencies` workspace-root `package.json` проєкту, в якому виконується CLI `n-cursor`. Якщо запис відсутній і в `devDependencies`, і в `dependencies`, модуль дописує його з діапазоном `^<version>`, узятим з поля `version` з `package.json` фактично завантаженого пакету `@nitra/cursor`.
 
 Призначення: коли користувач викликає `npx @nitra/cursor` (зокрема команду `check`), node-кеш npx містить пакет, але після наступного `bun install` / `npm install` цей кеш може не відтворити пакет у проєкті. Дописавши пакет у `devDependencies` workspace-root, модуль гарантує, що `n-cursor` і його допоміжні скрипти з `node_modules/@nitra/cursor/scripts/` стануть відтвореною частиною проєкту й не залежатимуть від кешу npx.

package/scripts/docs/index.md

@@ -0,0 +1,24 @@
+---
+type: Directory Index
+title: npm/scripts
+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 |
+| [ensure-nitra-cursor-dev-dependencies.mjs](ensure-nitra-cursor-dev-dependencies.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/post-tool-use-fix.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: post-tool-use-fix.mjs
+resource: npm/scripts/post-tool-use-fix.mjs
 docgen:
-  source: npm/scripts/post-tool-use-fix.mjs
-  crc: f40e8a8b
+  crc: 9f313f04
   score: 95
 ---
 
-# post-tool-use-fix.mjs
-
-## Огляд
-
 Файл забезпечує точкова маршрутизацію шляху до правил для виправлення коду через хук PostToolUse. Він ініціює запуск команди `npx @nitra/cursor fix` для виправлення коду після зміни файлу.
 
 ## Поведінка

package/scripts/docs/rename-yaml-extensions.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: rename-yaml-extensions.mjs
+resource: npm/scripts/rename-yaml-extensions.mjs
 docgen:
-  source: npm/scripts/rename-yaml-extensions.mjs
   crc: 6ffbfdff
 ---
 
-# rename-yaml-extensions.mjs
-
-## Огляд
-
 Цей файл перейменовує розширення файлів YAML у репозиторіях, відповідно до узгоджених правил. Він автоматизує процес зміни розширення файлів `.yml` на `.yaml` для файлів, що відповідають певним шаблонам шляхів, зокрема для маніфестів Kubernetes та workflow-файлів GitHub. Це забезпечує узгодженість форматування YAML у репозиторії.
 
 ## Поведінка

package/scripts/docs/skills-cli.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: skills-cli.mjs
+resource: npm/scripts/skills-cli.mjs
 docgen:
-  source: npm/scripts/skills-cli.mjs
   crc: 85da573a
   score: 100
 ---
 
-# skills-cli.mjs
-
-## Огляд
-
 Файл надає інструменти для запуску скілів пакета `@nitra/cursor` без синку правил у проєкт. Він зчитує інструкції скілів з файлів `SKILL.md` та збирає контекст з `package.json`, `tsconfig.json` та `.n-cursor.json` для формування промпту. Зібраний промпт делегується в `cursor-agent` або `claude` для виконання необхідних дій.
 
 ## Поведінка