@nitra/cursor 12.8.9 → 12.10.0

package/scripts/lib/mirror-parity.mjs

@@ -9,7 +9,7 @@
 import { existsSync, readdirSync, readFileSync } from 'node:fs'
 import { dirname, join } from 'node:path'
 
-import { inlineMarkdownIncludes, inlineTemplateLinks } from './inline-template-links.mjs'
+import { appendDiscoveredMdcFiles, inlineTemplateLinks } from './inline-template-links.mjs'
 
 const MIRROR_PREFIX = 'n-'
 const MDC_EXT = '.mdc'
@@ -44,7 +44,7 @@ export function listManagedMirrors(repoRoot) {
 export async function expectedMirrorContent(canonicalPath) {
   const dir = dirname(canonicalPath)
   const withTemplates = await inlineTemplateLinks(readFileSync(canonicalPath, 'utf8'), dir)
-  return inlineMarkdownIncludes(withTemplates, dir)
+  return appendDiscoveredMdcFiles(withTemplates, dir)
 }
 
 /**

package/scripts/lib/run-lint.mjs

@@ -237,16 +237,18 @@ async function runScopedRules(rules, ctx) {
 
 /**
  * Запускає lint-оркестрацію.
- * @param {{ full?: boolean, readOnly?: boolean, rules?: string[], cwd?: string, rulesDir?: string, log?: (s: string) => void }} [opts] параметри
+ * @param {{ full?: boolean, readOnly?: boolean, rules?: string[], files?: string[], cwd?: string, rulesDir?: string, log?: (s: string) => void }} [opts] параметри
  *   - `full` — весь репо (`true`) проти дельти vs origin (`false`, default);
  *   - `readOnly` — лише детект без мутацій (`true`) проти fix (`false`, default);
- *   - `rules` — непорожній scope → повний прогін лише цих правил (лінтер + конформність, whole-repo).
+ *   - `rules` — непорожній scope → повний прогін лише цих правил (лінтер + конформність, whole-repo);
+ *   - `files` — явний список файлів (hook-режим): per-file правила без conformance/format/delta-full.
  * @returns {Promise<number>} exit code
  */
 export async function runLint(opts = {}) {
   const full = opts.full === true
   const readOnly = opts.readOnly === true
   const rules = Array.isArray(opts.rules) ? opts.rules : []
+  const explicitFiles = Array.isArray(opts.files) ? opts.files : null
   const cwd = opts.cwd ?? processCwd()
   const rulesDir = opts.rulesDir ?? RULES_DIR
   const log = opts.log ?? (s => process.stdout.write(s))
@@ -256,6 +258,17 @@ export async function runLint(opts = {}) {
     return runScopedRules(rules, { cwd, readOnly, rulesDir, conformance: opts.rulesDir === undefined, log })
   }
 
+  // Hook-режим (явний список файлів): per-file правила, без conformance/format/delta-full.
+  // Правила отримують точний список файлів; пусті files (Stop без змін) — правила однаково
+  // викликаються (orphan-детект у doc-files не залежить від списку джерел).
+  if (explicitFiles !== null) {
+    const metaById = readAllMeta(rulesDir)
+    const enabledRuleIds = await readEnabledLintRuleIds(metaById, cwd)
+    const ids = selectLintRules(metaById, false, enabledRuleIds)
+    const perFile = await runPerFileRules(ids, { rulesDir, changed: explicitFiles, cwd, readOnly, metaById, log })
+    return perFile.stop ? perFile.code : perFile.code
+  }
+
   // Default scope — дельта vs origin (merge-base main/origin/main); `--full` — весь репо.
   const changed = full ? undefined : collectChangedFilesSince(resolveChangedBase(cwd), cwd)
   if (!full && changed.length === 0) {

package/scripts/lib/run-rule.mjs

@@ -117,8 +117,7 @@ async function runPolicyConcern(bundledRulesDir, ruleId, concernName, walkCache)
   if (files.length === 0) {
     if (target.files.required && target.files.single) {
       const msg =
-        target.missingMessage ??
-        `${target.files.single} не існує — створи згідно main.mdc (${ruleId}.${concernName})`
+        target.missingMessage ?? `${target.files.single} не існує — створи згідно main.mdc (${ruleId}.${concernName})`
       reporter.fail(msg)
     }
     return reporter.getExitCode()

package/scripts/sync-claude-config.mjs

@@ -30,11 +30,13 @@ import { existsSync } from 'node:fs'
 import { chmod, mkdir, readFile, readdir, rm, writeFile } from 'node:fs/promises'
 import { join } from 'node:path'
 
-/** Маркер PostToolUse fix-hook'а (`npx --no \@nitra/cursor post-tool-use-check`). */
-export const MANAGED_HOOK_COMMAND_MARKER = '@nitra/cursor post-tool-use-check'
-/** Маркер doc-files staleness-hook'ів (PostToolUse `--hook` і Stop-гейт `--git`). */
+/** Маркер hook-ів пакета (`hook --post-tool-use`, `hook --stop`). */
+export const MANAGED_HOOK_COMMAND_MARKER = '@nitra/cursor hook'
+/** @deprecated — замінено на `hook --post-tool-use`; маркер лишається для cleanup наявних конфігів при ресинку. */
+export const LEGACY_POST_TOOL_USE_HOOK_COMMAND_MARKER = '@nitra/cursor post-tool-use-check'
+/** @deprecated — doc-files hook перенесено до `hook --post-tool-use`; маркер лишається для cleanup наявних конфігів при ресинку. */
 export const DOC_FILES_HOOK_COMMAND_MARKER = '@nitra/cursor lint-doc-files'
-/** Legacy-маркер старих doc-files hook'ів (`doc-files check`) — cleanup при ресинку наявних інсталяцій. */
+/** @deprecated — ще старіший legacy-маркер doc-files hook'ів (`doc-files check`) — cleanup при ресинку. */
 export const LEGACY_DOC_FILES_HOOK_COMMAND_MARKER = '@nitra/cursor doc-files check'
 /** Legacy-маркер старого Stop-hook'а — лишаємо для cleanup-у при оновленні існуючих інсталяцій. */
 export const LEGACY_STOP_HOOK_COMMAND_MARKER = '@nitra/cursor stop-hook'
@@ -52,6 +54,7 @@ export const CURSOR_ADR_NORMALIZE_HOOK_COMMAND_MARKER = '.claude/hooks/normalize
  */
 export const MANAGED_HOOK_COMMAND_MARKERS = Object.freeze([
   MANAGED_HOOK_COMMAND_MARKER,
+  LEGACY_POST_TOOL_USE_HOOK_COMMAND_MARKER,
   DOC_FILES_HOOK_COMMAND_MARKER,
   LEGACY_DOC_FILES_HOOK_COMMAND_MARKER,
   LEGACY_STOP_HOOK_COMMAND_MARKER,

package/scripts/utils/docs/resolve-js-root.md

@@ -8,8 +8,6 @@ docgen:
   score: 100
 ---
 
-## Огляд
-
 Визначає корінь JS-коду в проєкті, відповідно до логіки для workspace-projects (перший workspace з підтримкою glob-патернів `cf/*`) або single-package (корінь cwd). Ця утиліта є спільною для coverage-провайдера JS та test-концерну `stryker_config` (DRY). Публічні функції дозволяють отримати один або повний список шляхів до всіх JS-коренів, при цьому свідомо виключаються каталоги `.git` та `node_modules`. Код спирається на конфігураційні файли `package.json` та `.n-cursor.json`.
 
 ## Поведінка

package/skills/adr-normalize/SKILL.md

@@ -3,6 +3,7 @@ name: n-adr-normalize
 description: >-
   Ручний запуск ADR-нормалізації — обхід порогу й min-interval, прогон одного
   батчу чернеток через LLM, перегляд результату через git diff
+version: '1.0'
 ---
 
 # n-adr-normalize — ручна нормалізація ADR-чернеток

package/skills/coverage-fix/SKILL.md

@@ -2,6 +2,7 @@
 name: n-coverage-fix
 description: >-
   Автономна команда: запускає n-cursor coverage → читає вцілілих мутантів → ітеративно пише тести до конвергенції (max 3 ітерації)
+version: '1.0'
 ---
 
 # n-coverage-fix — підвищення mutation score

package/skills/doc-aggregate/SKILL.md

@@ -2,6 +2,7 @@
 name: doc-aggregate
 description: >-
   Агрегуюча документація за запитом: module-summary на кожен логічний модуль (docs/ARCHITECTURE.md) і доменні доки бізнес-процесів у кореневій docs/ — синтез поверх готових файлових док (doc-files), батч-диспатч субагентів у worktree
+version: '1.0'
 ---
 
 # doc-aggregate — агрегуюча документація (за запитом)

package/skills/doc-files/SKILL.md

@@ -2,6 +2,7 @@
 name: doc-files
 description: >-
   Обовʼязковий крок задачі (як lint): для кожного зміненого/нового кодового файлу (js/mjs/ts/vue/py) JS-оркестрована генерація лаконічної поведінкової української md-документації у теку docs/ поряд із кодом, зі звіркою застарілості за CRC у frontmatter
+version: '1.0'
 ---
 
 # doc-files — файлова документація (обовʼязковий крок)
@@ -30,8 +31,8 @@ docgen:
 
 ## Оркестрацію веде JS, не модель; конвеєр — local-only
 
-Уся важка робота — черга, батчинг, виклики LLM і штамп CRC — живе в JS-команді
-`fix-doc-files`. **Ти не диспатчиш субагентів і не тримаєш сотні файлів у контексті**
+Уся важка робота — черга, батчинг, виклики LLM і штамп CRC — живе у JS-оркестрації
+`lint doc-files`. **Ти не диспатчиш субагентів і не тримаєш сотні файлів у контексті**
 — тому навіть масовий перший прогін усього репо не «заморює». Цей скіл **тонкий**: твоє завдання —
 запустити генерацію і прочитати підсумок.
 
@@ -50,34 +51,20 @@ docgen:
 ### Крок 1: Генерація застарілих/відсутніх док
 
 ```bash
-npx @nitra/cursor fix-doc-files
+npx @nitra/cursor lint doc-files
 ```
 
-Команда сама: перевіряє omlx (preflight: «сервер лежить» / «модель не влазить у пам'ять
-зайнятої машини» / «потрібен API-ключ» → одна зрозуміла зупинка замість лавини «✗») →
-сканує проєкт → фільтрує застарілі (`stale`) → генерує локальною моделлю → пише доку зі
-**свіжим CRC** (і degraded-маркером, якщо не дотягнула) → друкує прогрес і підсумок.
-
-- Для дуже великого прогону можна порціями: `--from N --limit M`.
-- Перегенерувати **всі** доки (не лише застарілі): `--overwrite`.
-- Перегенерувати лише degraded (свіжі за CRC, score < порогу): `--retry-degraded`.
+Команда запускає doc-files лінтер у fix-режимі (весь репо): перевіряє omlx
+(preflight: «сервер лежить» / «модель не влазить у пам'ять зайнятої машини» /
+«потрібен API-ключ» → одна зрозуміла зупинка замість лавини «✗») → фільтрує застарілі
+(`stale`) → генерує локальною моделлю → пише доку зі **свіжим CRC** (і degraded-маркером,
+якщо не дотягнула) → друкує прогрес і підсумок.
 
 ### Крок 2: Підтвердження
 
 Дочекайся підсумку `✓ OK: <N>  ⚠ degraded: <D>  ✗ Err: <E>`. Якщо є помилки — перелічи
 проблемні файли. Exit-код `1` означає, що хоча б один файл не згенерувався (або не пройшов
-preflight). Degraded — не помилка: дока існує, борг видно у `lint-doc-files --degraded`.
-
-### Крок 3 (за потреби): перевірка перед завершенням
-
-```bash
-npx @nitra/cursor lint-doc-files --git
-```
-
-Перевіряє змінені у задачі джерела (`git diff --name-only HEAD`) проти CRC їхніх док.
-Цю ж перевірку виконує **Stop-hook** як твердий гейт: завершити задачу зі застарілими
-доками не можна (виняток — масовий прогін понад поріг `N_CURSOR_DOC_FILES_GATE_MAX`, дефолт 50).
-Degraded-доки гейт **не** блокує (CRC свіжий); їх список — `lint-doc-files --degraded`.
+preflight). Degraded — не помилка: дока існує, CRC свіжий.
 
 ## Правила стилю документа (за adr/ci4)
 
@@ -97,4 +84,3 @@ Degraded-доки гейт **не** блокує (CRC свіжий); їх спи
   усі теки `docs/`, а також `*.test.*` / `*.spec.*` / `*.d.ts`. Кореневий repo `docs/` —
   system-wide only: file-level docs туди не пишуться. Список glob-ів — `docgen-ignore.mjs`.
 - Агрегуюча документація (module-summary, доменні доки) — окремий скіл `doc-aggregate`, за запитом.
-- Для наявних док без CRC одноразово: `npx @nitra/cursor fix-doc-files --stamp` (штампує frontmatter без LLM).

package/skills/lint/SKILL.md

@@ -1,39 +1,42 @@
 ---
 name: n-lint
 description: >-
-  Запустити кореневий bun run lint, виправити порушення й підтвердити чистий вихід
+  Запустити дельта-лінт (npx @nitra/cursor lint) по змінених файлах vs origin, виправити порушення й підтвердити чистий вихід
+version: '1.0'
 ---
 
-# n-lint — лінт проєкту через кореневий скрипт
+# n-lint — лінт проєкту по змінених файлах
 
 ## Мета
 
-Один раз узгоджено прогнати весь ланцюжок **`lint`** з кореневого **`package.json`**, усунути помилки (авто- та вручну) і переконатися, що **`bun run lint`** завершується з кодом **`0`**.
+Прогнати **`npx @nitra/cursor lint`** (**дельта-режим**: лише файли, змінені vs `origin`), усунути порушення (авто- та вручну) і переконатися, що команда завершується з кодом **`0`**.
+
+> **Чому дельта, не `--full`?** `--full` — CI-режим: сканує весь репо незалежно від змін. Під час задачі це зайво — перевіряємо лише те, що змінили. `lint --full` запускати **не треба**.
 
 ## Передумови
 
-- Поточна робоча директорія — **корінь репозиторію**, де є **`package.json`** зі скриптом **`lint`**.
+- Поточна робоча директорія — **корінь репозиторію**.
 - Залежності встановлені (**`bun i`**) — якщо після правок змінювався **`package.json`** / lockfile, знову виконай **`bun i`** перед наступним запуском лінту.
 
 ## Workflow
 
-1. **Запуск** — виконай повний лінт:
+1. **Запуск** — дельта-лінт по змінених файлах:
 
 ```bash
-bun run lint
+npx @nitra/cursor lint
 ```
 
-2. **Якщо exit code не 0** — проаналізуй вивід (останній упавший крок у ланцюжку **`lint`** часто видно з stderr / логів):
-   - Де скрипт уже робить **auto-fix** (**`--fix`**, **`markdownlint-cli2 --fix`**, **`oxfmt`** тощо) — перезапусти **`bun run lint`** після змін файлів.
-   - Де auto-fix **немає** (наприклад, **jscpd**, **cspell**, **zizmor**, перевірки без прапорця fix) — **за замовчуванням рефактори код проєкту**, щоб усунути порушення: перейменуй ідентифікатори, перепиши логіку, видали дублікати тощо. **Не** розширюй конфіги з винятками «мовчки» — див. блок **«Винятки в конфігурації»** нижче.
+2. **Якщо exit code не 0** — проаналізуй вивід:
+   - Де лінт уже робить **auto-fix** (**`--fix`**, **`oxfmt`** тощо) — перезапусти **`npx @nitra/cursor lint`** після змін файлів.
+   - Де auto-fix **немає** (наприклад, **jscpd**, **cspell**, **zizmor**) — **за замовчуванням рефактори код проєкту**, щоб усунути порушення. **Не** розширюй конфіги з винятками «мовчки» — див. блок **«Винятки в конфігурації»** нижче.
    - Якщо спрацьовує **`sonarjs/cognitive-complexity`** — див. окремий блок нижче.
 
-3. **Цикл** — повторюй кроки 1–2, доки **`bun run lint`** не завершиться успішно. Після суттєвих правок за потреби ще раз **`bun run lint`**, щоб переконатися, що не зламав наступний крок у скрипті **`lint`**.
+3. **Цикл** — повторюй кроки 1–2, доки **`npx @nitra/cursor lint`** не завершиться успішно.
 
-4. **Верифікація** — фінальна перевірка (обов’язково з кодом **0**):
+4. **Верифікація** — фінальна перевірка (обов'язково з кодом **0**):
 
 ```bash
-bun run lint
+npx @nitra/cursor lint
 ```
 
 5. **Результат** — коротко опиши, що саме виправлено; якщо щось блокує нульовий exit code — залиш чітке пояснення й наступні кроки для людини.
@@ -88,20 +91,20 @@ bun run lint
 - **Перед будь-яким рефакторингом** перевір, чи є **тести**, які покривають змінювану поведінку:
   - **unit** — **`bun test`** (або скрипт тестів у відповідному пакеті репозиторію);
   - **e2e** — **Playwright**, якщо в проєкті він використовується для UI/потоків.
-- Якщо тестів **немає** або вони **не покривають** блок, який змінюєш — **спочатку** додай/розшир тести, переконайся, що вони стабільно проходять, **потім** роби рефакторинг, **потім** знову прогони тести й **`bun run lint`**, щоб підтвердити, що функціональність коректна й лінт чистий.
+- Якщо тестів **немає** або вони **не покривають** блок, який змінюєш — **спочатку** додай/розшир тести, переконайся, що вони стабільно проходять, **потім** роби рефакторинг, **потім** знову прогони тести й **`npx @nitra/cursor lint`**, щоб підтвердити, що функціональність коректна й лінт чистий.
 - Якщо після рефакторингу тести або лінт падають — **не** залишай «половинчастий» рефакторинг: відкотись або доведи зміни до зеленого стану.
 
 ## Паралелізм і навантаження на macOS
 
-**Паралельно по різних файлах — дозволено.** Диз'юнктні набори (per-file `n-cursor lint` на змінених vs origin) не конфліктують: кожен процес обробляє свій підмножину файлів, тож гонки за тим самим корпусом немає.
+**Паралельно по різних файлах — дозволено.** Дельта-прогони на диз'юнктних наборах файлів не конфліктують.
 
-Проблема — не паралелізм як такий, а **кілька одночасних whole-tree прогонів того самого корпусу** (**`bun run lint`**, **`n-cursor lint --full`**) у різних Bash-задачах/shells: кожен повторно сканує **весь** репо (eslint + oxlint + jscpd + knip), і диск/CPU перевантажуються дублюванням важкого full-scan.
+Серіалізувати треба лише **`n-cursor lint --full`** (whole-tree CI-прогін) — запускати не більше одного за раз. Але цей скіл `--full` **не використовує**: `npx @nitra/cursor lint` (дельта) сам по собі не перевантажує репо.
 
 ### Що робити агенту під час виконання цього скілу
 
-1. **Whole-tree** прогін (**`bun run lint`** / **`lint --full`**) — **один** за раз, у одному foreground shell; **не** запускати другий full-прогін того самого корпусу паралельно.
-2. **Per-file** лінт по диз'юнктних файлах (різні субагенти на різні файли) — **дозволено** й не потребує серіалізації.
-3. Якщо сесія/користувач уже запускає **whole-tree** лінт — не дублювати його; зачекати завершення.
+1. **Дельта-лінт** (`npx @nitra/cursor lint`) — можна запускати повторно; паралелізм із субагентами по різних файлах — OK.
+2. **`lint --full`** у цьому скілі **не запускати** — це CI-команда, не задачна.
+3. Якщо сесія/користувач уже запускає `lint --full` — не дублювати; зачекати завершення.
 
 **Що можна змінити у проєкті (локально або в `package.json`)**
 
@@ -113,4 +116,6 @@ bun run lint
 
 ## Примітка
 
-Цей скіл **не** замінює **`npx @nitra/cursor fix`**: **`lint`** перевіряє лінтери/формат у **`package.json`**, а **`check`** — програмні правила пакета **`@nitra/cursor`**. За потреби запускай обидва.
+Цей скіл **не** замінює **`npx @nitra/cursor fix`**: **`lint`** перевіряє лінтери/формат (eslint, oxlint, rego тощо), а **`check`** / **`fix`** — програмні правила пакета **`@nitra/cursor`**. За потреби запускай обидва.
+
+Для CI або явного повного сканування всього репо незалежно від змін — `npx @nitra/cursor lint --full`. Але в рамках задачі це **зайво**.

package/skills/llm-patch/SKILL.md

@@ -3,6 +3,7 @@ name: n-llm-patch
 description: >-
   Підготовка самодостатнього текстового промпта для іншого Claude/Cursor-агента —
   read-only аналіз CWD без жодних змін у поточному репо
+version: '1.0'
 ---
 
 <!-- markdownlint-disable-file MD024 MD025 -->
@@ -73,12 +74,12 @@ description: >-
   inflight-міграції, breaking-change політика, зовнішні залежності.
 - **Change-file flow,** якщо завдання змінює файли у пакетному workspace (код,
   правила, скіли, конфіги, тести — не лише `docs/`): промпт має вимагати
-  `npx @nitra/cursor change --bump <major|minor|patch> --section <Added|Changed|Fixed|Removed> --message "<опис>" [--ws <шлях>]`
+  `npx @7n/n ch [--bump <major|minor|patch>] [--section <Added|Changed|Fixed|Removed>] [--message "<опис>"]`
   і `npx @nitra/cursor fix changelog`. **Ніколи** не інструктуй ручне редагування
   `CHANGELOG.md` чи bump `version` — це робить release flow / CI (деталь —
   `.cursor/rules/n-changelog.mdc`, не дублюй її текст). Якщо потрібна реліз-нота —
   це change-файл `<ws>/.changes/<timestamp>-<rand>.md` з `bump:` і `section:`,
-  який створює саме `change` CLI, а не редагування файлу вручну.
+  який створює `@7n/n ch`, а не редагування файлу вручну.
 - **Як перевірити** — конкретні команди й специфічні до завдання сигнали
   успіху.
 
@@ -196,7 +197,7 @@ description: >-
 - **Без ручного changelog/version у промпті:** не формулюй у виводі інструкції
   на кшталт "додати запис у `CHANGELOG.md`", "bump `version` вручну" чи
   "оновити `package.json#version`". Зміни у workspace фіксуються винятково
-  через change-file flow (`npx @nitra/cursor change …` → `npx @nitra/cursor fix changelog`);
+  через change-file flow (`npx @7n/n ch` → `npx @nitra/cursor fix changelog`);
   `version`/`CHANGELOG.md` формує CI.
 - **Не вмикай у промпт:** секрети, `.env`, `node_modules`, бінарні файли,
   довгі логи, дампи `tree`, повні JSON конфігів, цитати існуючих
@@ -238,7 +239,7 @@ description: >-
 - Підняти `engines.node` до `>=25`; якщо peer `eslint ^9` несумісний —
   підняти range.
 - Зафіксувати зміну change-файлом (НЕ редагувати `CHANGELOG.md` чи `version`
-  вручну): `npx @nitra/cursor change --bump minor --section Changed --message "engines.node >=25"`.
+  вручну): `npx @7n/n ch --bump minor --section Changed --message "engines.node >=25"`.
 
 # Обмеження
 

package/skills/publish-telegram/SKILL.md

@@ -2,6 +2,7 @@
 name: n-publish-telegram
 description: >-
   Підготовка матеріалу з поточного контексту для публікації в Telegram-каналі команди
+version: '1.0'
 ---
 
 # Публікація в Telegram

package/skills/start-check/SKILL.md

@@ -3,6 +3,7 @@ name: n-start-check
 description: >-
   Smoke-перевірка bun-монорепо: зайти в кожен воркспейс зі `start`-скриптом, прогнати
   `start` і зафіксувати, чи проєкт взагалі запускається без негайного краху
+version: '1.0'
 ---
 
 # n-start-check — чи запускається кожен воркспейс

package/skills/taze/SKILL.md

@@ -3,6 +3,7 @@ name: n-taze
 description: >-
   Оновлення версій модулів проекту з аналізом major-змін і автоматичним
   рефакторингом несумісного коду
+version: '1.0'
 ---
 
 # n-taze — Оновлення версій проекту
@@ -81,7 +82,7 @@ rg -n "<імпорт|функція|опція>" --type ts --type js --type vue
 Для кожного несумісного місця — застосувати міграцію згідно з changelog модуля (перейменувати імпорт, оновити сигнатуру виклику, замінити видалену опцію еквівалентом тощо). Після правок:
 
 ```bash
-bun run lint
+npx @nitra/cursor lint
 bun run typecheck   # якщо є
 bun test            # якщо є
 ```
@@ -108,6 +109,6 @@ rm package.json.taze-bak bun.lock.taze-bak
 
 ## Примітка
 
-- Не запускати `bun run lint` паралельно з іншими ESLint-задачами — діє правило з кореневого `CLAUDE.md`.
+- Не запускати `npx @nitra/cursor lint` паралельно з іншими ESLint-задачами — діє правило з кореневого `CLAUDE.md`.
 - Якщо проект — `npm/` пакет цього репо, після змін у `package.json` / коді треба підняти `version` і додати запис у `CHANGELOG.md` згідно з `npm/CLAUDE.md`.
 - При великій кількості major-оновлень розбити PR по одному модулю на коміт — щоб `git bisect` залишався корисним.

package/types/bin/n-cursor.d.ts

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-export {};
+export {}

package/rules/abie/docs/fix.md

@@ -1,37 +0,0 @@
----
-type: JS Module
-title: fix.mjs
-resource: npm/rules/abie/fix.mjs
-docgen:
-  crc: 38cf876b
-  score: 100
----
-
-Запуск правила приймає контекст прогону, застосовує JS-занепокоєні та політику, генерує посилання MDC та повертає результат прогону.
-
-Виконання у режимі CLI виконує повний еквівалент команди `npx @nitra/cursor fix <id>` та повертає код виходу.
-
-## Поведінка
-
-1. Запуск правила.
-   - Приймає контекст прогону.
-   - Виконує застосування JS-занепокоєних.
-   - Застосовує політику.
-   - Генерує посилання MDC.
-   - Повертає результат прогону.
-
-2. Виконання у режимі CLI.
-   - Виконується при запуску через CLI.
-   - Виконує повний еквівалент команди `npx @nitra/cursor fix <id>`.
-   - Повертає код виходу.
-
-## Публічний API
-
-run — запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
-Library mode — викликається CLI orchestration через `import + run`.
-
-## Гарантії поведінки
-
-- Read-only: файл не виконує операцій запису у файлову систему.
-- Кешує результати в межах одного прогону.
-- Не звертається до мережі.

package/rules/adr/docs/fix.md

@@ -1,37 +0,0 @@
----
-type: JS Module
-title: fix.mjs
-resource: npm/rules/adr/fix.mjs
-docgen:
-  crc: 38cf876b
-  score: 100
----
-
-Виконує обробку JS-занепокоєних та політики на наданому контексті прогону. Генерація посилання MDC та повернення результату прогону.
-
-## Поведінка
-
-1. Запуск правила.
-    *   Приймає контекст прогону.
-    *   Виконує застосування JS-занепокоєних.
-    *   Застосовує політику.
-    *   Генерує посилання MDC.
-    *   Повертає результат прогону.
-2. Виконання у режимі CLI.
-    *   Виконується як автономний скрипт.
-    *   Виконує повний еквівалент команди `npx @nitra/cursor fix <id>`.
-    *   Виконує завантаження конфігурації.
-    *   Виконує перевірку дозволених елементів.
-    *   Генерує зведену інформацію.
-    *   Визначає код виходу процесу.
-
-## Публічний API
-
-run — запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
-Library mode — викликається CLI orchestration через `import + run`.
-
-## Гарантії поведінки
-
-- Read-only: файл не виконує операцій запису у файлову систему.
-- Кешує результати в межах одного прогону.
-- Не звертається до мережі.

package/rules/bun/docs/fix.md

@@ -1,30 +0,0 @@
----
-type: JS Module
-title: fix.mjs
-resource: npm/rules/bun/fix.mjs
-docgen:
-  crc: 38cf876b
-  score: 100
----
-
-Виконує обробку JS-занепокоєних даних у наданому контексті прогону. Застосовує визначену політику та генерує посилання MDC. Повертає результат прогону.
-
-## Поведінка
-
-1. Запуск правила.
-   - Приймає контекст прогону.
-   - Виконує застосування JS-занепокоєних.
-   - Застосовує політику.
-   - Генерує посилання MDC.
-   - Повертає результат прогону.
-
-## Публічний API
-
-run — запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
-Library mode — викликається CLI orchestration через `import + run`.
-
-## Гарантії поведінки
-
-- Read-only: файл не виконує операцій запису у файлову систему.
-- Кешує результати в межах одного прогону.
-- Не звертається до мережі.

package/rules/capacitor/docs/fix.md

@@ -1,36 +0,0 @@
----
-type: JS Module
-title: fix.mjs
-resource: npm/rules/capacitor/fix.mjs
-docgen:
-  crc: 38cf876b
-  score: 100
----
-
-Виконує застосування JS-занепокоєних на вхідний контекст прогону, застосовує визначену політику, генерує посилання MDC та повертає результат
-
-## Поведінка
-
-1. Запуск правила.
-   - Приймає контекст прогону.
-   - Виконує застосування JS-занепокоєних.
-   - Застосовує політику.
-   - Генерує посилання MDC.
-   - Повертає результат.
-2. Запуск у режимі CLI.
-   - Виконується як повний еквівалент команди `npx @nitra/cursor fix <id>`.
-   - Виконує завантаження конфігурації.
-   - Виконує перевірку дозволених записів.
-   - Генерує зведену інформацію.
-   - Використовує `process.exitCode` для визначення виходу.
-
-## Публічний API
-
-run — запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
-Library mode — викликається CLI orchestration через `import + run`.
-
-## Гарантії поведінки
-
-- Read-only: файл не виконує операцій запису у файлову систему.
-- Кешує результати в межах одного прогону.
-- Не звертається до мережі.

package/rules/changelog/docs/fix.md

@@ -1,37 +0,0 @@
----
-type: JS Module
-title: fix.mjs
-resource: npm/rules/changelog/fix.mjs
-docgen:
-  crc: 38cf876b
-  score: 100
----
-
-Виконує застосування JS-занепокоєних на наданому контексті прогону. Застосовує визначену політику та генерує посилання MDC. Повертає результат прогону.
-
-## Поведінка
-
-1. Запуск правила.
-   - Приймає контекст прогону.
-   - Виконує застосування JS-занепокоєних.
-   - Застосовує політику.
-   - Генерує посилання MDC.
-   - Повертає результат прогону.
-2. Виконання у режимі CLI.
-   - Виконується як окремий скрипт.
-   - Еквівалент команди `npx @nitra/cursor fix <id>`.
-   - Виконує завантаження конфігурації.
-   - Виконує перевірку дозволених елементів.
-   - Генерує зведену інформацію.
-   - Виконує повний еквівалент `fix.mjs`.
-
-## Публічний API
-
-run — запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
-Library mode — викликається CLI orchestration через `import + run`.
-
-## Гарантії поведінки
-
-- Read-only: файл не виконує операцій запису у файлову систему.
-- Кешує результати в межах одного прогону.
-- Не звертається до мережі.

package/rules/ci4/docs/fix.md

@@ -1,32 +0,0 @@
----
-type: JS Module
-title: fix.mjs
-resource: npm/rules/ci4/fix.mjs
-docgen:
-  crc: 38cf876b
-  score: 100
----
-
-Огляд
-Файл надає функціонал для виконання визначених правил. Публічні методи забезпечують запуск цих правил, повертаючи отримані результати. Дозволяє запускати правила у режимі командного рядка, керуючи виходом процесу на основі отриманих даних.
-
-## Поведінка
-
-1. Запуск правила.
-   - Виклик runStandardRule з контекстом.
-   - Повернення результату.
-
-2. Запуск правила у режимі CLI.
-   - Виклик runRuleCli з директорією модуля.
-   - Вихід з процесом залежно від результату.
-
-## Публічний API
-
-run — запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
-Library mode — викликається CLI orchestration через `import + run`.
-
-## Гарантії поведінки
-
-- Read-only: файл не виконує операцій запису у файлову систему.
-- Кешує результати в межах одного прогону.
-- Не звертається до мережі.