@nitra/cursor 12.8.9 → 12.9.0

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: файл не виконує операцій запису у файлову систему.
-- Не звертається до мережі.