@nitra/cursor 11.4.1 → 12.0.1

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/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` для виконання необхідних дій.
 
 ## Поведінка

package/scripts/docs/sync-claude-config.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: sync-claude-config.mjs
+resource: npm/scripts/sync-claude-config.mjs
 docgen:
-  source: npm/scripts/sync-claude-config.mjs
   crc: ad7b8440
   score: 95
 ---
 
-# sync-claude-config.mjs
-
-## Огляд
-
 Файл синхронізує конфігурацію Claude Code (`.claude/settings.json`), slash-команди з темплейту та Cursor hooks (`.cursor/hooks.json`) у поточний проєкт з використанням темплейтів пакету `npm/.claude-template/`. Він виконує злиття користувацьких полів, дозволів та хуків з різних джерел. Синхронізуються та видаляються залежні скрипти та фрагменти конфігурації.
 
 ## Поведінка

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

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: sync-setup-bun-deps-action.mjs
+resource: npm/scripts/sync-setup-bun-deps-action.mjs
 docgen:
-  source: npm/scripts/sync-setup-bun-deps-action.mjs
   crc: 098d7209
 ---
 
-# sync-setup-bun-deps-action.mjs
-
-## Огляд
-
 Файл містить конфігурацію GitHub Action `setup-bun-deps`, яка автоматично встановлює залежності проєкту Bun. Він використовується workflow для підготовки середовища проєкту, забезпечуючи узгодженість та спрощуючи виконання тестів та інших завдань, що потребують Bun. Це дозволяє workflow, що використовує `actions/checkout@v6`, безпосередньо використовувати action, не потребуючи додаткової конфігурації.
 
 ## Поведінка

package/scripts/docs/upgrade-nitra-cursor-and-install.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: upgrade-nitra-cursor-and-install.mjs
+resource: npm/scripts/upgrade-nitra-cursor-and-install.mjs
 docgen:
-  source: npm/scripts/upgrade-nitra-cursor-and-install.mjs
   crc: b0742ab3
 ---
 
-# upgrade-nitra-cursor-and-install.mjs
-
-## Огляд
-
 Файл автоматично синхронізує правила командного інтерфейсу (CLI) з останньою версією `@nitra/cursor` з npm registry. Це забезпечує, що локальна версія `@nitra/cursor` завжди актуальна, а також інсталює необхідні залежності за допомогою `bun i`. Він використовується для підтримки узгодженості між локальним проєктом та офіційним репозиторієм npm.
 
 ## Поведінка

package/scripts/docs/worktree-cli.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: worktree-cli.mjs
+resource: npm/scripts/worktree-cli.mjs
 docgen:
-  source: npm/scripts/worktree-cli.mjs
   crc: 4fb54376
   score: 100
 ---
 
-# worktree-cli.mjs
-
-## Огляд
-
 Файл є CLI-оркестратором `worktree-tool` для керування конвенцією `.worktrees/`. Він забезпечує виконання Git-операцій для додавання, видалення, перегляду та прибирання робочих просторів.
 
 ## Поведінка

package/scripts/lib/adr/docs/index.md

@@ -0,0 +1,12 @@
+---
+type: Directory Index
+title: npm/scripts/lib/adr
+resource: npm/scripts/lib/adr/
+---
+
+# npm/scripts/lib/adr
+
+| Файл | Тип |
+|---|---|
+| [normalize-cli.mjs](normalize-cli.md) | JS Module |
+| [normalize-pipeline.mjs](normalize-pipeline.md) | JS Module |