@nitra/cursor 12.8.8 → 12.9.0

package/rules/tool-surface/docs/fix.md

@@ -1,32 +0,0 @@
----
-type: JS Module
-title: fix.mjs
-resource: npm/rules/tool-surface/fix.mjs
-docgen:
-  crc: 38cf876b
-  model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 100
-  issues: judge:inaccurate:0.93
-  judgeModel: openai-codex/gpt-5.4-mini
----
-
-## Огляд
-
-Цей файл запускає логіку перевірки відповідності політики через функцію `run`, використовуючи контекст прогону, який містить дані, кешовані у межах цього прогону. При самостійному запуску скрипт ініціює повний цикл: завантажує конфігурацію, перевіряє білий список та формує підсумок. Результат виконання визначається кодом виходу, що сигналізує про успішне виконання або виявлені порушення.
-
-## Поведінка
-
-1. Викликається функція `run` для запуску правила.
-2. Правило виконується, використовуючи контекст прогону, що може містити кеш.
-3. Якщо скрипт виконується як окрема програма (standalone), запускається оркестрація правила.
-4. Оркестрація виконує завантаження конфігурації, перевірку білого списку та підсумок.
-5. Код завершує роботу з кодом виходу, який вказує на успіх або наявність порушень.
-
-## Публічний API
-
-run — виконує послідовність перевірок: застосовує правила, аналізує JS-занепокоєння, перевіряє політику та посилання MDC.
-
-## Гарантії поведінки
-
-- Read-only: не виконує операцій запису (ФС/БД).
-- Кешує результати в межах одного прогону.

package/rules/vue/docs/fix.md

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

package/rules/worktree/docs/fix.md

@@ -1,40 +0,0 @@
----
-type: JS Module
-title: fix.mjs
-resource: npm/rules/worktree/fix.mjs
-docgen:
-  crc: 38cf876b
-  score: 100
----
-
-Виконує застосування політики JS-занепокоєних та конфігурації на наданому контексті прогону, генеруючи посилання MDC та повертаючи результат.
-
-Виконується при запуску через командний рядок, виконуючи повний еквівалент команди `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/scripts/docs/post-tool-use-fix.md

@@ -1,32 +0,0 @@
----
-type: JS Module
-title: post-tool-use-fix.mjs
-resource: npm/scripts/post-tool-use-fix.mjs
-docgen:
-  crc: 9f313f04
-  score: 95
----
-
-Файл забезпечує точкова маршрутизацію шляху до правил для виправлення коду через хук PostToolUse. Він ініціює запуск команди `npx @nitra/cursor fix` для виправлення коду після зміни файлу.
-
-## Поведінка
-
-routeFilePathToRules
-Визначає список правил для пропугу на основі шляху до файлу
-
-runPostToolUseFixCli
-Виконує маршрутизацію шляху до правил та запускає команду для виправлення коду
-
-## Публічний API
-
-routeFilePathToRules — повертає список правил для обробки зміненого шляху. Перший збіг із ROUTES — переможець; невідомі шляхи або некоректні входи повертають порожній масив.
-
-runPostToolUseFixCli — точка входу. Викликається з `bin/n-cursor.js` при передачі аргументу `post-tool-use-fix`. Параметри доступні для ін'єкції для тестування: `stdinJson` замінює зчитування з `process.stdin`, `spawnFn` замінює `node:child_process.spawn` на об'єкт, сумісний з EventEmitter.
-
-## Гарантії поведінки
-
-- Read-only: файл не виконує операцій запису у файлову систему.
-- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
-- За невдачі повертає значення помилки (`false`/`null`/`Err`) замість генерування винятку чи паніки.
-- Свідомо пропускає шляхи: `.github`, `.git`.
-- Не звертається до мережі.

package/scripts/docs/worktree-cli.md

@@ -1,27 +0,0 @@
----
-type: JS Module
-title: worktree-cli.mjs
-resource: npm/scripts/worktree-cli.mjs
-docgen:
-  crc: 4fb54376
-  score: 100
----
-
-Файл є CLI-оркестратором `worktree-tool` для керування конвенцією `.worktrees/`. Він забезпечує виконання Git-операцій для додавання, видалення, перегляду та прибирання робочих просторів.
-
-## Поведінка
-
-1.  Запуск підкоманди add. Перевіряється наявність необхідного імені гілки та опису. Перевіряється унікальність назви для створення нового worktree. Збирається нагадування про незакомічені зміни основного дерева. Виконується git команда для створення worktree. Якщо команда не успішна, повертається помилка. Створюється та записується опис у файлі `.worktrees/`. Повертається код виходу.
-2.  Запуск підкоманди remove. Перевіряється наявність імені гілки. Перевіряється наявність необхідного імені гілки. Визначається шлях до worktree. Виконується git команда для видалення checkout. Якщо команда не успішна, повертається помилка. Якщо вказано прапорець --force, використовується примусовий режим. Видаляється відповідний файл опису. Повертається код виходу.
-3.  Запуск підкоманди list. Виконується git команда для отримання списку worktree. Виводиться результат. Для кожного зареєстрованого файлу опису з директорії `.worktrees/` зчитується вміст файлу та виводиться. Повертається код виходу.
-4.  Запуск підкоманди prune. Виконується git команда для прибирання worktree. Визначається список осиротілих файлів опису. Виконується git команда для прибирання worktree. Для кожного осиротілого файлу опису видаляється відповідний файл. Повертається код виходу.
-
-## Публічний API
-
-runWorktreeCli — Запускає команду для роботи з підкомандою worktree.
-
-## Гарантії поведінки
-
-- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
-- За невдачі повертає значення помилки (`false`/`null`/`Err`) замість генерування винятку чи паніки.
-- Не звертається до мережі.

package/scripts/lib/docs/worktree.md

@@ -1,42 +0,0 @@
----
-type: JS Module
-title: worktree.mjs
-resource: npm/scripts/lib/worktree.mjs
-docgen:
-  crc: ffcdbca5
----
-
-Файл містить детерміновану логіку для обробки гілок у `worktree-tool`, забезпечуючи безпечне перетворення імен гілок та створення описових файлів для `worktree`. Він використовується для генерації структури `.worktrees/` та ідентифікації неактивних описових файлів, що необхідно для операцій з видаленням. Це ключовий компонент для забезпечення консистентності та зручності роботи з `worktree-tool` безпосередньо з файловою системою.
-
-## Поведінка
-
-sanitizeBranch: Перетворює ім’я git-гілки на безпечне ім’я каталогу/файла для `.worktrees/`, замінюючи небезпечні символи на дефіс.
-firstFreeBranch: Знаходить першу вільну назву гілки, починаючи з заданої, і повертає її.
-worktreePaths: Створює абсолютні шляхи до checkout і файла-опису для заданої гілки.
-buildDescription: Генерує markdown-вміст файла-опису `.worktrees/<name>.md` на основі наданих параметрів.
-buildDirtyNotice: Створює повідомлення про незакомічені зміни основного дерева, якщо їх є, обмежуючи кількість відображених файлів.
-findOrphanDescFiles: Знаходить `.md`-описи, які не мають відповідного зареєстрованого worktree-checkout.
-
-## Публічний API
-
-- sanitizeBranch — Перетворює ім'я гілки на безпечне ім'я для каталогу/файлу.
-- firstFreeBranch — Знаходить першу вільну назву гілки, використовуючи суфікси `base`, `base2`, `base3` тощо.
-- worktreePaths — Визначає шляхи для checkout гілки та файлу опису.
-- buildDescription — Генерує текст опису для файлу опису worktree.
-- buildDirtyNotice — Виводить повідомлення про незакомічені зміни, які не включені у worktree.
-- findOrphanDescFiles — Знаходить `.md`-описи, що не мають відповідного worktree-checkout.
-
-## Гарантії поведінки
-
-- `sanitizeBranch` повертає строку, безпечну для використання в шляхах файлової системи.
-- `sanitizeBranch` не змінює вхідну строку.
-- `worktreePaths` повертає масив з двох строк, що представляють шлях до checkout та файлу опису.
-- `worktreePaths` гарантує, що обидва шляхи є дійсними.
-- `buildDescription` повертає строку, що відповідає конвенції `worktree.mdc`.
-- `buildDescription` не змінює вхідну строку.
-- `findOrphanDescFiles` повертає масив з рядків, що представляють шляхи до файлів опису.
-- `findOrphanDescFiles` гарантує, що всі рядки в масиві є дійсними шляхами файлів.
-- Функції не викликають жодних побічних ефектів, що впливають на стан файлової системи.
-- Функції не взаємодіють з Git або будь-якими іншими системами контролю версій.
-- Результат роботи функцій не залежить від будь-яких зовнішніх факторів.
-- Функції не використовують жодного кешу.

package/scripts/lib/fix/docs/run-fix-check.md

@@ -1,33 +0,0 @@
----
-type: JS Module
-title: run-fix-check.mjs
-resource: npm/scripts/lib/fix/run-fix-check.mjs
-docgen:
-  crc: 76874730
-  model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 100
----
-
-Викликає конформність-фазу `lint` (read-only), движок (`orchestrator.mjs`, `t0.mjs`) та PostToolUse-хук. Перевірка конформності виконується як пряма функція, без зовнішньої обгортки через `subprocess`. Ізоляція на рівні кожного правила зберігається: кожен файл `rules/<id>/fix.mjs` все ще запускається окремим процесом `bun` (crash-isolation). Селекція активних правил — єдине джерело: `resolveCheckRuleIds` за `.n-cursor.json`; per-rule whitelist у спавнених процесах прибрано як дубль.
-
-## Поведінка
-
-1. Визначається наявність інструменту `conftest`.
-2. Отримується список усіх доступних ідентифікаторів правил з каталогу правил.
-3. Визначається список ідентифікаторів правил для прогону (`resolveCheckRuleIds`), де `.n-cursor.json` — єдине джерело правди:
-   а. Якщо надано явний список правил — він валідується проти доступних і звужується до активних (вимкнене правило не вмикається навіть на явний запит).
-   б. Якщо явного списку нема й конфіг є — беруться активні правила конфіга (`available ∩ enabled`); `.cursor/rules/*.mdc` ігнорується (фікс дрейфу «enabled, але .mdc нема»).
-   в. Якщо конфіга нема (open-by-default debug) — fallback на скан `.cursor/rules/*.mdc`.
-4. Якщо визначено ідентифікатори правил для прогону, для кожного ідентифікатора запускається окремий процес `bun` з файлом `fix.mjs` відповідного правила.
-5. Захоплюється вивід кожного процесу.
-6. Підраховується загальна кількість правил, що не пройшли перевірку.
-7. Повертається результат, що містить загальну кількість перевірених правил, кількість невдалих перевірок та детальний список результатів для кожного правила.
-
-## Публічний API
-
-runFixCheck — Визначає відповідність коду заданим правилам, виконуючи перевірку без внесення змін.
-
-## Гарантії поведінки
-
-- Read-only: файл не виконує операцій запису у файлову систему.
-- Не звертається до мережі.