@nitra/cursor 12.8.9 → 12.9.0

package/rules/k8s/docs/fix.md

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

package/rules/nginx-default-tpl/docs/fix.md

@@ -1,35 +0,0 @@
----
-type: JS Module
-title: fix.mjs
-resource: npm/rules/nginx-default-tpl/fix.mjs
-docgen:
-  crc: 38cf876b
-  score: 100
----
-
-Виконує застосування політики безпеки до посилань 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/rules/npm-module/docs/fix.md

@@ -1,34 +0,0 @@
----
-type: JS Module
-title: fix.mjs
-resource: npm/rules/npm-module/fix.mjs
-docgen:
-  crc: 38cf876b
-  score: 100
----
-
-Виконує обробку JS-занепокоєних на наданому контексті прогону, застосовує політику [Політика_X] та генерує посилання 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/php/docs/fix.md

@@ -1,35 +0,0 @@
----
-type: JS Module
-title: fix.mjs
-resource: npm/rules/php/fix.mjs
-docgen:
-  crc: 38cf876b
-  score: 100
----
-
-Виконує застосування політики JS-занепокоєних до mdc-refs на вхідному контексті прогону та повертає результат.
-
-Виконується при запуску через командний рядок, виконуючи повний еквівалент команди `npx @nitra/cursor fix <id>` та повертає код виходу.
-
-## Поведінка
-
-1. Запуск правила.
-   - Приймає контекст прогону.
-   - Виконує застосування JS-занепокоєних до політики до mdc-refs.
-   - Повертає результат прогону.
-
-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/python/docs/fix.md

@@ -1,38 +0,0 @@
----
-type: JS Module
-title: fix.mjs
-resource: npm/rules/python/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/rego/docs/fix.md

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

package/rules/release/docs/fix.md

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

package/rules/rust/docs/fix.md

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

package/rules/security/docs/fix.md

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

package/rules/style/docs/fix.md

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

package/rules/tauri/docs/fix.md

@@ -1,39 +0,0 @@
----
-type: JS Module
-title: fix.mjs
-resource: npm/rules/tauri/fix.mjs
-docgen:
-  crc: 38cf876b
-  score: 100
----
-
-Виконує застосування політики JS-занепокоєних та генерує посилання MDC. Повертає результат.
-
-Виконується як еквівалент команди `npx @nitra/cursor fix <id>`. Завантажує конфігурацію, перевіряє дозволені записи, генерує зведену інформацію та визначає код виходу процесу.
-
-## Поведінка
-
-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/test/docs/fix.md

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

package/rules/text/docs/fix.md

@@ -1,37 +0,0 @@
----
-type: JS Module
-title: fix.mjs
-resource: npm/rules/text/fix.mjs
-docgen:
-  crc: 38cf876b
-  score: 100
----
-
-Виконує застосування JS-занепокоєних на наданому контексті прогону, застосовує визначену політику, генерує посилання MDC та повертає результат. У режимі CLI виконується як автономний скрипт, який імітує команду `npx @nitra/cursor fix <id>`, завантажує конфігурацію, перевіряє дозволені записи, генерує зведену інформацію та визначає код виходу процесу.
-
-## Поведінка
-
-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/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`) замість генерування винятку чи паніки.
-- Не звертається до мережі.