@nitra/cursor 12.7.0 → 12.8.1

package/rules/worktree/docs/fix.md

@@ -14,19 +14,19 @@ docgen:
 ## Поведінка
 
 1. Запуск правила.
-    *   Приймає контекст прогону.
-    *   Виконує застосування JS-занепокоєних.
-    *   Застосовує політику.
-    *   Генерує посилання MDC.
-    *   Повертає результат прогону.
+   - Приймає контекст прогону.
+   - Виконує застосування JS-занепокоєних.
+   - Застосовує політику.
+   - Генерує посилання MDC.
+   - Повертає результат прогону.
 
 2. Запуск у режимі CLI.
-    *   Виконується при запуску через CLI.
-    *   Виконує повний еквівалент команди `npx @nitra/cursor fix <id>`.
-    *   Виконує завантаження конфігурації.
-    *   Виконує перевірку дозволених елементів.
-    *   Генерує зведену інформацію.
-    *   Виконує вихід з процесу залежно від результату.
+   - Виконується при запуску через CLI.
+   - Виконує повний еквівалент команди `npx @nitra/cursor fix <id>`.
+   - Виконує завантаження конфігурації.
+   - Виконує перевірку дозволених елементів.
+   - Генерує зведену інформацію.
+   - Виконує вихід з процесу залежно від результату.
 
 ## Публічний API
 

package/rules/worktree/docs/index.md

@@ -6,7 +6,7 @@ resource: npm/rules/worktree/
 
 # npm/rules/worktree
 
-| Файл | Тип |
-|---|---|
-| [fix.mjs](fix.md) | JS Module |
+| Файл                | Тип       |
+| ------------------- | --------- |
+| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

package/scripts/coverage-classify/docs/index.md

@@ -6,9 +6,9 @@ docgen:
   crc: 06249ac8
 ---
 
-| Файл | Тип | Опис |
-|---|---|---|
-| [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-класифікатора. |
+| Файл                                    | Тип       | Опис                                                                                                   |
+| --------------------------------------- | --------- | ------------------------------------------------------------------------------------------------------ |
+| [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/dispatcher/docs/index.md

@@ -6,6 +6,6 @@ resource: npm/scripts/dispatcher/
 
 # npm/scripts/dispatcher
 
-| Файл | Тип |
-|---|---|
+| Файл                  | Тип       |
+| --------------------- | --------- |
 | [trace.mjs](trace.md) | JS Module |

package/scripts/docs/index.md

@@ -6,20 +6,20 @@ 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 |
+| Файл                                                                                | Тип       |
+| ----------------------------------------------------------------------------------- | --------- |
+| [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-check.mjs](post-tool-use-check.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 |
+| [post-tool-use-check.mjs](post-tool-use-check.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/lib/docs/index.md

@@ -6,40 +6,40 @@ resource: npm/scripts/lib/
 
 # npm/scripts/lib
 
-| Файл | Тип |
-|---|---|
-| [assert-project-root.mjs](assert-project-root.md) | JS Module |
-| [changed-files.mjs](changed-files.md) | JS Module |
-| [check-mdc-template-refs.mjs](check-mdc-template-refs.md) | JS Module |
-| [check-reporter.mjs](check-reporter.md) | JS Module |
-| [diff-added-lines.mjs](diff-added-lines.md) | JS Module |
+| Файл                                                                        | Тип       |
+| --------------------------------------------------------------------------- | --------- |
+| [assert-project-root.mjs](assert-project-root.md)                           | JS Module |
+| [changed-files.mjs](changed-files.md)                                       | JS Module |
+| [check-mdc-template-refs.mjs](check-mdc-template-refs.md)                   | JS Module |
+| [check-reporter.mjs](check-reporter.md)                                     | JS Module |
+| [diff-added-lines.mjs](diff-added-lines.md)                                 | JS Module |
 | [discover-check-rules-from-cursor.mjs](discover-check-rules-from-cursor.md) | JS Module |
-| [discover-checkable-rules.mjs](discover-checkable-rules.md) | JS Module |
-| [ensure-tool.mjs](ensure-tool.md) | JS Module |
-| [generated-markdown.mjs](generated-markdown.md) | JS Module |
-| [gha-workflow.mjs](gha-workflow.md) | JS Module |
-| [inline-template-links.mjs](inline-template-links.md) | JS Module |
-| [list-project-rules-mdc.mjs](list-project-rules-mdc.md) | JS Module |
-| [list-rule-ids.mjs](list-rule-ids.md) | JS Module |
-| [load-cursor-config.mjs](load-cursor-config.md) | JS Module |
-| [mirror-parity.mjs](mirror-parity.md) | JS Module |
-| [read-n-cursor-config-lite.mjs](read-n-cursor-config-lite.md) | JS Module |
-| [resolve-target-files.mjs](resolve-target-files.md) | JS Module |
-| [root-notice.mjs](root-notice.md) | JS Module |
-| [rule-meta-helpers.mjs](rule-meta-helpers.md) | JS Module |
-| [rule-meta.mjs](rule-meta.md) | JS Module |
-| [rule-predicates.mjs](rule-predicates.md) | JS Module |
-| [run-conftest-batch.mjs](run-conftest-batch.md) | JS Module |
-| [run-lint-step.mjs](run-lint-step.md) | JS Module |
-| [run-lint.mjs](run-lint.md) | JS Module |
-| [run-rule-cli.mjs](run-rule-cli.md) | JS Module |
-| [run-rule.mjs](run-rule.md) | JS Module |
-| [run-standard-lint.mjs](run-standard-lint.md) | JS Module |
-| [run-standard-rule.mjs](run-standard-rule.md) | JS Module |
-| [skill-meta.mjs](skill-meta.md) | JS Module |
-| [sync-gitignore-worktree.mjs](sync-gitignore-worktree.md) | JS Module |
-| [template.mjs](template.md) | JS Module |
-| [timing-summary.mjs](timing-summary.md) | JS Module |
-| [workspaces.mjs](workspaces.md) | JS Module |
-| [worktree-notice.mjs](worktree-notice.md) | JS Module |
-| [worktree.mjs](worktree.md) | JS Module |
+| [discover-checkable-rules.mjs](discover-checkable-rules.md)                 | JS Module |
+| [ensure-tool.mjs](ensure-tool.md)                                           | JS Module |
+| [generated-markdown.mjs](generated-markdown.md)                             | JS Module |
+| [gha-workflow.mjs](gha-workflow.md)                                         | JS Module |
+| [inline-template-links.mjs](inline-template-links.md)                       | JS Module |
+| [list-project-rules-mdc.mjs](list-project-rules-mdc.md)                     | JS Module |
+| [list-rule-ids.mjs](list-rule-ids.md)                                       | JS Module |
+| [load-cursor-config.mjs](load-cursor-config.md)                             | JS Module |
+| [mirror-parity.mjs](mirror-parity.md)                                       | JS Module |
+| [read-n-cursor-config-lite.mjs](read-n-cursor-config-lite.md)               | JS Module |
+| [resolve-target-files.mjs](resolve-target-files.md)                         | JS Module |
+| [root-notice.mjs](root-notice.md)                                           | JS Module |
+| [rule-meta-helpers.mjs](rule-meta-helpers.md)                               | JS Module |
+| [rule-meta.mjs](rule-meta.md)                                               | JS Module |
+| [rule-predicates.mjs](rule-predicates.md)                                   | JS Module |
+| [run-conftest-batch.mjs](run-conftest-batch.md)                             | JS Module |
+| [run-lint-step.mjs](run-lint-step.md)                                       | JS Module |
+| [run-lint.mjs](run-lint.md)                                                 | JS Module |
+| [run-rule-cli.mjs](run-rule-cli.md)                                         | JS Module |
+| [run-rule.mjs](run-rule.md)                                                 | JS Module |
+| [run-standard-lint.mjs](run-standard-lint.md)                               | JS Module |
+| [run-standard-rule.mjs](run-standard-rule.md)                               | JS Module |
+| [skill-meta.mjs](skill-meta.md)                                             | JS Module |
+| [sync-gitignore-worktree.mjs](sync-gitignore-worktree.md)                   | JS Module |
+| [template.mjs](template.md)                                                 | JS Module |
+| [timing-summary.mjs](timing-summary.md)                                     | JS Module |
+| [workspaces.mjs](workspaces.md)                                             | JS Module |
+| [worktree-notice.mjs](worktree-notice.md)                                   | JS Module |
+| [worktree.mjs](worktree.md)                                                 | JS Module |

package/scripts/lib/docs/run-lint.md

@@ -3,27 +3,27 @@ type: JS Module
 title: run-lint.mjs
 resource: npm/scripts/lib/run-lint.mjs
 docgen:
-  crc: dd80d058
+  crc: 24827b04
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
 
 ## Огляд
 
-Модуль керує вибором та виконанням правил лінтування. Він визначає набір правил для лінтування, спираючись на конфігурації `meta.json` та `.n-cursor.json`. Публічна функція `selectLintRules` вибирає та сортує ці правила на основі їхньої лінт-поверхні. Публічна функція `runLint` ініціює виконання визначеного набору правил, перевіряючи змінені файли або весь репозиторій.
+Модуль ініціалізує та керує процесом лінтування коду. Він вибирає та сортує набір правил для перевірки, використовуючи конфігурації `meta.json` та `.n-cursor.json`. Публічна функція `selectLintRules` виконує вибір правил. Публічна функція `runLint` ініціює повний цикл лінтування, який може включати перевірку змінених файлів або всього репозиторію.
 
 ## Поведінка
 
-selectLintRules вибирає і алфавітно сортує ідентифікатори правил для лінтування на основі їхньої лінт-поверхні та наявності в активних конфігураціях.
-runLint запускає лінт-оркестрацію, виконуючи перевірку змінених файлів або повний прогін репозиторію, залежно від наданих опцій.
+selectLintRules вибирає і алфавітно сортує ідентифікатори правил для лінтування, ґрунтуючись на наявності в конфігурації та заданому обсязі перевірки.
+runLint запускає повну оркестрацію лінтування, виконуючи перевірку змінених файлів або весь репозиторій, залежно від параметрів, і може включати фази конформності та форматування.
 
 ## Публічний API
 
 selectLintRules — обирає ідентифікатори правил для контексту, розташовуючи їх в алфавітному порядку.
 runLint — ініціює процес лінтування.
-  full — сканує весь репозиторій, порівнюючи його з початковим станом.
-  readOnly — лише виявляє проблеми без внесення змін.
-  rules — виконує повне сканування репозиторію, застосовуючи лише вказаний набір правил.
+full — сканує весь репозиторій, порівнюючи його з початковим станом.
+readOnly — лише виявляє проблеми, не вносячи змін, порівнюючи з початковим станом.
+rules — виконує повне сканування лише для вказаних правил у заданому обсязі.
 
 ## Гарантії поведінки
 

package/scripts/lib/docs/run-standard-lint.md

@@ -11,11 +11,12 @@ docgen:
 ## Огляд
 
 Спільна точка входу для канонічних `lint-<rule>` підкоманд `@nitra/cursor`. Файл серіалізує та дедуплікує запуски лінту через `withLock`. `ruleId` визначається зі шляху незалежно від глибини виклику (наприклад, `rules/<id>`). Це дозволяє уніфікувати крос-cutting концерни. Інтеграція з боку правила виглядає так:
-* import { runStandardLint } from '../../scripts/lib/run-standard-lint.mjs'
- *
- * async function runLintFooSteps { ... }
- *
- * export function lint { return runStandardLint }
+
+- import { runStandardLint } from '../../scripts/lib/run-standard-lint.mjs'
+-
+- async function runLintFooSteps { ... }
+-
+- export function lint { return runStandardLint }
 
 ## Поведінка
 
@@ -29,6 +30,7 @@ lint — є спільною точкою входу для канонічних
 runStandardLint — виконує стандартний лінтинг у директорії, приймаючи контекст директорії та функцію, що описує кроки лінтингу.
 
 Приклад інтеграції:
+
 ```js
 import { runStandardLint } from '../../scripts/lib/run-standard-lint.mjs'
 

package/scripts/lib/fix/analyze-escalation.mjs

@@ -231,7 +231,10 @@ function buildSynthesisPrompt(partials) {
  */
 function safeCall(call, prompt, model) {
   try {
-    const text = call([{ role: 'user', content: prompt }], model, { timeoutMs: ANALYZE_TIMEOUT_MS, caller: 'fix-analyze' })
+    const text = call([{ role: 'user', content: prompt }], model, {
+      timeoutMs: ANALYZE_TIMEOUT_MS,
+      caller: 'fix-analyze'
+    })
     return text || null
   } catch {
     return null

package/scripts/lib/fix/docs/analyze-escalation.md

@@ -3,31 +3,44 @@ type: JS Module
 title: analyze-escalation.mjs
 resource: npm/scripts/lib/fix/analyze-escalation.mjs
 docgen:
-  crc: 5a586df6
+  crc: f26cd4c7
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
 
-Аналітика escalation-логу fix-конформності. Читає записи рунгів драбини (`escalation-log.mjs`) — весь лог або записи одного прогону (від байтового зсуву), — ділить на чанки за бюджетом символів і просить хмарну **avg**-модель запропонувати, як зменшити LLM-залежність: нові детерміновані T0-патерни, уточнення `.mdc`-інструкцій або зміни скриптів пакета. Результат — markdown-звіт у `.n-cursor/fix-escalation-analysis.md` (append із timestamp). Викликається CLI `n-cursor analyze-escalation` (весь лог) і наприкінці `lint --full` (записи прогону).
+## Огляд
+
+Аналізує записи рунгів драбини з `escalation-log.mjs` для виявлення шляхів зменшення LLM-залежності у fix-конформності. Лог обробляється за один прогін (від байтового зсуву) або повністю, ділячись на чанки для аналізу хмарною **avg**-моделлю. Мета аналізу — визначити конкретні правки пакета `@nitra/cursor`: (A) новий ДЕТЕРМІНОВАНИЙ T0-патерн (`t0.mjs`), (B) уточнення `.mdc`-інструкцій правила, або (C) зміна скрипта/чека. Результат зберігається у markdown-звіт `.n-cursor/fix-escalation-analysis.md` (append із timestamp) після виклику CLI `n-cursor analyze-escalation`.
 
 ## Поведінка
 
-`readEscalationRecords` читає JSONL від байтового зсуву (зсув на межі рядка — мультибайт не б'ється; биті рядки пропускаються); `escalationLogSize` дає зсув для scope «цей прогін». `chunkRecords` стискає записи й ділить на чанки, щоб JSON кожного не перевищив бюджет. `analyzeEscalations` (синхронний — callLlm spawnSync-based) робить виклик avg-моделі по кожному чанку, а за кількох чанків — фінальний синтез; помилки моделі ковтаються в `null` (аналіз не валить lint). `maybeAnalyzeEscalation` — хук lint: gated kill-switch `N_CURSOR_FIX_ANALYZE`, наявністю `CLOUD_AVG` і записів.
+analysisEnabled визначає, чи дозволено виконувати автоматичний аналіз ескалації наприкінці процесу `lint`.
+escalationLogSize повертає розмір файлу логу ескалації у байтах.
+readEscalationRecords читає записи логу ескалації, починаючи з заданого байтового зсуву, та повертає їх як масив об'єктів.
+summarizeCalls рахує кількість викликів моделей для різних рівнів (локальний, cloud-min, cloud-avg) у наданих записах.
+reportRunStats друкує резюме кількості викликів моделей для поточного прогону, використовуючи заданий байтовий зсув.
+chunkRecords ділить масив стиснених записів на менші чанки, щоб кожен чанк не перевищив заданий бюджет символів.
+analyzeEscalations аналізує надані записи, ділить їх на чанки, викликає модель для аналізу кожного чанка, а потім синтезує фінальний звіт.
+analysisReportPath повертає шлях до файлу, де зберігається звіт аналізу ескалації.
+writeAnalysisReport дописує згенерований звіт у markdown-файл у відповідному шляху, додаючи до нього мітку часу.
+runEscalationAnalysisCli виконує повний аналіз всього логу ескалації та записує звіт.
+maybeAnalyzeEscalation виконує аналіз ескалацій лише для записів поточного прогону, якщо дозволено та є необхідні умови.
 
 ## Публічний API
 
-- `summarizeCalls(records)` — лічильники фактичних викликів за тирами `{ local, cloudMin, cloudAvg }` (skip-записи avg-кепу не рахуються).
-- `reportRunStats(sinceOffset, log)` — друкує резюме викликів моделей за прогін (no-op, якщо викликів не було).
-- `analysisEnabled()` — чи дозволено авто-аналіз (kill-switch `N_CURSOR_FIX_ANALYZE`).
-- `escalationLogSize(path?)` — розмір логу в байтах (since-offset).
-- `readEscalationRecords(path, sinceOffset?)` — записи від зсуву.
-- `chunkRecords(records, maxChars?)` — чанки стиснених записів.
-- `analyzeEscalations(records, opts?)` — `{ report, chunks, reason }`; `opts.callLlm` інжектовний.
-- `analysisReportPath(cwd?)` / `writeAnalysisReport(report, cwd, ts)` — шлях/запис звіту.
-- `runEscalationAnalysisCli(args, cwd?)` — CLI: весь лог → звіт.
-- `maybeAnalyzeEscalation(cwd, sinceOffset, log)` — хук наприкінці `lint --full`.
+analysisEnabled — Вмикає автоматичний аналіз після завершення lint.
+escalationLogSize — Визначає максимальний розмір escalation-логу в байтах.
+readEscalationRecords — Зчитує записи з логу, починаючи з заданого байтового зсуву.
+summarizeCalls — Підраховує реальні виклики моделей за тирами, ігноруючи записи про середнє кешування.
+reportRunStats — Виводить підсумок викликів моделей за поточний запуск.
+chunkRecords — Розбиває записи на менші частини, щоб розмір JSON кожного чанку не перевищував заданий ліміт.
+analyzeEscalations — Обробляє записи: розбиває їх на чанки, викликає модель для кожного чанку та синтезує результат, якщо чанків більше одного.
+analysisReportPath — Вказує шлях для збереження markdown-звіту аналізу.
+writeAnalysisReport — Додає звіт до markdown-файлу, додаючи до нього мітку часу.
+runEscalationAnalysisCli — Виконує повний аналіз всього логу escalation через інтерфейс командного рядка.
+maybeAnalyzeEscalation — Запускає аналіз записів поточного прогону після `lint --full`, якщо це дозволено налаштуваннями.
 
 ## Гарантії поведінки
 
-- Звертається до мережі лише при виклику avg-моделі (через pi/omlx за префіксом model-id).
-- Помилки виклику моделі перехоплює (fail-safe): аналіз не впливає на exit-код lint.
+- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
+- За певних помилок повертає порожнє значення (напр. `null`) замість винятку.

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

@@ -6,14 +6,14 @@ resource: npm/scripts/lib/fix/
 
 # npm/scripts/lib/fix
 
-| Файл | Тип |
-|---|---|
-| [analyze-escalation.mjs](analyze-escalation.md) | JS Module |
-| [escalation-log.mjs](escalation-log.md) | JS Module |
-| [llm-fix-apply.mjs](llm-fix-apply.md) | JS Module |
-| [llm-lint-fix.mjs](llm-lint-fix.md) | JS Module |
-| [llm-worker.mjs](llm-worker.md) | JS Module |
-| [orchestrator.mjs](orchestrator.md) | JS Module |
+| Файл                                                  | Тип       |
+| ----------------------------------------------------- | --------- |
+| [analyze-escalation.mjs](analyze-escalation.md)       | JS Module |
+| [escalation-log.mjs](escalation-log.md)               | JS Module |
+| [llm-fix-apply.mjs](llm-fix-apply.md)                 | JS Module |
+| [llm-lint-fix.mjs](llm-lint-fix.md)                   | JS Module |
+| [llm-worker.mjs](llm-worker.md)                       | JS Module |
+| [orchestrator.mjs](orchestrator.md)                   | JS Module |
 | [run-conformance-check.mjs](run-conformance-check.md) | JS Module |
-| [run-fix-check.mjs](run-fix-check.md) | JS Module |
-| [t0.mjs](t0.md) | JS Module |
+| [run-fix-check.mjs](run-fix-check.md)                 | JS Module |
+| [t0.mjs](t0.md)                                       | JS Module |

package/scripts/lib/fix/docs/orchestrator.md

@@ -3,38 +3,37 @@ type: JS Module
 title: orchestrator.mjs
 resource: npm/scripts/lib/fix/orchestrator.mjs
 docgen:
-  crc: fbc91330
+  crc: 3bb1b761
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
 
 ## Огляд
 
-Модуль керує процесом вирішення порушень за допомогою багаторівневої системи ескалації. Він збирає послідовність рівнів моделей, починаючи з локальних і закінчуючи хмарними. Модуль парсить параметри запуску за допомогою `parseOrchestratorArgs` та виконує повний цикл фіксації, застосовуючи детермінований фікс. Для невирішених проблем застосовується ескалація правил через `escalateRule`, а фінальний запуск оркестратора здійснюється через `runOrchestratorCli`, який використовує структуру, побудовану за допомогою `buildLadder`.
+Модуль відповідає за управління процесом виправлення порушень. Він будує послідовність тирів ескалації за допомогою `buildLadder`, парсить аргументи командного рядка за допомогою `parseOrchestratorArgs` та запускає повний цикл виправлення за допомогою `runOrchestratorCli`. Цей цикл включає автоматичний фікс та ескалацію через LLM-моделі, що реалізується функцією `escalateRule`.
 
 ## Поведінка
 
 buildLadder будує послідовність тирів ескалації для вирішення порушень, від локальних мінімальних моделей до хмарних середніх моделей.
-escalateRule проводить один прохід по послідовності тирів, намагаючись вирішити порушення, і повертає статус вирішення та використаний бюджет хмарних викликів.
-parseOrchestratorArgs парсить аргументи командного рядка для визначення максимального бюджету хмарних викликів та фільтра правил.
-runOrchestratorCli виконує повний цикл фіксації: перевіряє правила, застосовує детермінований фікс (T0-auto), а потім використовує LLM-драбину ескалації для невирішених порушень.
+escalateRule виконує один прогін по послідовності тирів, намагаючись вирішити порушення, використовуючи LLM-моделі та фіксуючи результат.
+parseOrchestratorArgs парсить аргументи командного рядка для визначення максимального ліміту викликів хмарної моделі та фільтра правил.
+runOrchestratorCli керує повним процесом виправлення порушень: виконує початкову перевірку, застосовує детермінований фікс (T0-auto), а потім ініціює LLM-драбину ескалації для невирішених правил.
 
 ## Публічний API
 
-buildLadder — Створює послідовність моделей для ескалації, виходячи з доступних рівнів.
+buildLadder — Створює послідовність моделей для ескалації, обмежуючись лише тирами, які доступні.
 
-local-min — Запускає первинний прохід з найменшою локальною моделлю.
-local-min-retry — Повторює локальний прохід, використовуючи відгук від попереднього кроку.
-cloud-min — Запускає прохід з найменшою хмарною моделлю, використовуючи відгук.
-cloud-avg — Запускає прохід з середньою хмарною моделлю, використовуючи відгук та обмеження середнього.
+local-min — Виконує перший прохід з локальною мінімальною моделлю.
+local-min-retry — Повторює локальний прохід, використовуючи результати попереднього рунгу.
+cloud-min — Виконує прохід з хмарною мінімальною моделлю, використовуючи результати попереднього рунгу.
+cloud-avg — Виконує прохід з хмарною середньою моделлю, використовуючи результати попереднього рунгу та обмеження середнього.
 
-escalateRule — Виконує одне правило по драбині ескалації до першого успішного перевірки.
-Кожен рунг — Запускає роботу моделі з урахуванням попереднього відгуку, перевіряє правило, фіксує результат у лозі.
-Достроковий вихід — Зупиняє процес при певних умовах (відсутність ключа, пропуск моделі на системному рівні) або при досягненні ліміту середнього.
+escalateRule — Застосовує одне правило по драбині ескалації до першого позитивного результату.
+Кожен рунг — Викликає модель з попереднім відгуком, перевіряє правило, фіксує результат у лозі. Зупиняється при певних умовах (відсутність ключа, пропуск моделі, перевищення бюджету).
 
-parseOrchestratorArgs — Витягує максимальне значення середнього та збирає список правил для фільтрації з командного рядка.
+parseOrchestratorArgs — Витягує максимальне значення середнього та список фільтрів правил з командного рядка.
 
-runOrchestratorCli — Запускає основний процес оркестрації, обробляючи аргументи та виконуючи ескалацію правил.
+runOrchestratorCli — Запускає основну логіку оркестратора на основі аргументів командного рядка.
 
 ## Гарантії поведінки
 

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

@@ -21,9 +21,10 @@ runConformanceCheck виконує перевірку конформності
 ## Публічний API
 
 resolveCheckRuleIds — Визначає, які правила будуть застосовані для перевірки, використовуючи `.n-cursor.json` як основне джерело:
-*   Якщо вказані правила, вони фільтруються до активних у конфігурації.
-*   Якщо правила не вказані, беруться всі активні правила з конфігу.
-*   Якщо правила не вказані і конфіг відсутній, використовується список правил, що були збережені локально.
+
+- Якщо вказані правила, вони фільтруються до активних у конфігурації.
+- Якщо правила не вказані, беруться всі активні правила з конфігу.
+- Якщо правила не вказані і конфіг відсутній, використовується список правил, що були збережені локально.
 
 runConformanceCheck — Виконує перевірку відповідності для кожного окремого правила без внесення змін.
 

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

@@ -15,9 +15,9 @@ docgen:
 1. Визначається наявність інструменту `conftest`.
 2. Отримується список усіх доступних ідентифікаторів правил з каталогу правил.
 3. Визначається список ідентифікаторів правил для прогону (`resolveCheckRuleIds`), де `.n-cursor.json` — єдине джерело правди:
-    а. Якщо надано явний список правил — він валідується проти доступних і звужується до активних (вимкнене правило не вмикається навіть на явний запит).
-    б. Якщо явного списку нема й конфіг є — беруться активні правила конфіга (`available ∩ enabled`); `.cursor/rules/*.mdc` ігнорується (фікс дрейфу «enabled, але .mdc нема»).
-    в. Якщо конфіга нема (open-by-default debug) — fallback на скан `.cursor/rules/*.mdc`.
+   а. Якщо надано явний список правил — він валідується проти доступних і звужується до активних (вимкнене правило не вмикається навіть на явний запит).
+   б. Якщо явного списку нема й конфіг є — беруться активні правила конфіга (`available ∩ enabled`); `.cursor/rules/*.mdc` ігнорується (фікс дрейфу «enabled, але .mdc нема»).
+   в. Якщо конфіга нема (open-by-default debug) — fallback на скан `.cursor/rules/*.mdc`.
 4. Якщо визначено ідентифікатори правил для прогону, для кожного ідентифікатора запускається окремий процес `bun` з файлом `fix.mjs` відповідного правила.
 5. Захоплюється вивід кожного процесу.
 6. Підраховується загальна кількість правил, що не пройшли перевірку.

package/scripts/lib/fix/docs/t0.md

@@ -3,26 +3,27 @@ type: JS Module
 title: t0.mjs
 resource: npm/scripts/lib/fix/t0.mjs
 docgen:
-  crc: 49c0669b
+  crc: cfb0d5c9
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
 
 ## Огляд
 
-Модуль керує автоматичним застосуванням T0-auto паттернів до виводів порушень. Він визначає, які правила можуть бути оброблені автоматично, використовуючи конфігурації з `extensions.json` та `package-lock.json`. Функціонал реалізовано через публічні функції: `filterT0AutoRules` для визначення правил, `applyT0Auto` для автоматичного застосування паттернів до виводів, та `runT0AutoCli` для запуску процесу. Модуль працює у режимі fail-safe, перехоплюючи помилки та не кидаючи винятків назовні, надаючи звіт про застосовані автоматичні виправлення.
+Модуль керує автоматичним застосуванням паттернів T0-auto до виводів порушень. Він використовує конфігурації з `extensions.json` та `package-lock.json` для визначення правил. Модуль фільтрує правила, які можуть бути автоматично оброблені, застосовує паттерни за допомогою `applyT0Auto`, а потім запускає повний цикл перевірки для всіх провальних правил через `runT0AutoCli`. Усі операції виконуються з механізмом fail-safe, що запобігає виникненню винятків назовні.
 
 ## Поведінка
 
-applyT0Auto застосовує всі визначені T0-auto паттерни до одного виводу порушення, повертаючи результат застосування.
-filterT0AutoRules повертає список ID правил, для яких існує хоча б один T0-auto паттерн, виходячи з виводів порушень.
-runT0AutoCli запускає T0-auto для кожного провального правила, повторно перевіряє конформність та виводить підсумок.
+Поведінка
+applyT0Auto застосовує всі визначені T0-auto паттерни до одного виводу порушення, повертаючи результат застосування та список виконаних дій.
+filterT0AutoRules повертає список ID правил, для яких існує хоча б один T0-auto паттерн, виходячи з виводу порушення.
+runT0AutoCli запускає T0-auto для всіх провальних правил, повторно перевіряє конформність та виводить підсумок щодо закритого чи незакритого порушень.
 
 ## Публічний API
 
 applyT0Auto — вносить зміни до виводу порушень, використовуючи всі визначені T0-auto шаблони.
-filterT0AutoRules — визначає, які правила мають принаймні один T0-auto шаблон, ґрунтуючись на виводі порушень у форматі JSON.
-runT0AutoCli — виконує команду `n-cursor fix-t0 [rule...]`, яка застосовує T0-auto до кожного порушення, повторно перевіряє check-gate та надає звіт.
+filterT0AutoRules — визначає, які правила мають відповідні T0-auto шаблони, аналізуючи вивід порушень, отриманий з `fix --json`.
+runT0AutoCli — виконує команду `n-cursor fix-t0 [rule...]`, що включає застосування T0-auto до кожного порушення, повторну перевірку check-gate та виведення результату.
 
 ## Гарантії поведінки
 

package/scripts/lib/fix/orchestrator.mjs

@@ -45,7 +45,14 @@ const CLOUD_TRANSPORT_RE = /etimedout|timed out|pi error/i
 export function buildLadder({ localMin, cloudMin, cloudAvg }) {
   return [
     { tier: 'local-min', model: localMin, feedback: false, local: true, isAvg: false, timeoutMs: LOCAL_TIMEOUT_MS },
-    { tier: 'local-min-retry', model: localMin, feedback: true, local: true, isAvg: false, timeoutMs: LOCAL_TIMEOUT_MS },
+    {
+      tier: 'local-min-retry',
+      model: localMin,
+      feedback: true,
+      local: true,
+      isAvg: false,
+      timeoutMs: LOCAL_TIMEOUT_MS
+    },
     { tier: 'cloud-min', model: cloudMin, feedback: true, local: false, isAvg: false, timeoutMs: CLOUD_TIMEOUT_MS },
     { tier: 'cloud-avg', model: cloudAvg, feedback: true, local: false, isAvg: true, timeoutMs: CLOUD_TIMEOUT_MS }
   ].filter(r => r.model)
@@ -103,7 +110,15 @@ export async function escalateRule(rule, cwd, deps) {
 
     const common = { rung: idx, tier: rung.tier, model: rung.model, withFeedback: rung.feedback }
     if (rung.isAvg && avgBudget - avgUsed <= 0) {
-      record({ ...common, callOk: false, callError: 'cloud-avg cap reached', recheckOk: false, remainingViolation: currentViolation, diagnosis: null, ms: 0 })
+      record({
+        ...common,
+        callOk: false,
+        callError: 'cloud-avg cap reached',
+        recheckOk: false,
+        remainingViolation: currentViolation,
+        diagnosis: null,
+        ms: 0
+      })
       log(`  ⏭️  ${rule.ruleId}: ${rung.tier} пропущено (avg-кеп вичерпано)`)
       continue
     }
@@ -120,7 +135,15 @@ export async function escalateRule(rule, cwd, deps) {
     const recheck = await check([rule.ruleId], cwd)
     const recheckOk = recheck.rules.every(r => r.ok)
     const remaining = recheckOk ? '' : (recheck.rules.find(r => !r.ok)?.output ?? '')
-    record({ ...common, callOk: res.ok, callError: res.error ?? null, recheckOk, remainingViolation: remaining, diagnosis: res.diagnosis ?? null, ms: clock() - startedAt })
+    record({
+      ...common,
+      callOk: res.ok,
+      callError: res.error ?? null,
+      recheckOk,
+      remainingViolation: remaining,
+      diagnosis: res.diagnosis ?? null,
+      ms: clock() - startedAt
+    })
 
     if (recheckOk) {
       log(`  ✅ ${rung.tier} (${rung.model || 'pi'}): ${rule.ruleId}`)

package/scripts/lib/fix/t0.mjs

@@ -210,7 +210,10 @@ export async function runT0AutoCli(args, cwd) {
   }
 
   // 4. Check-gate: перевірити лише ті правила, що ми чіпали
-  const recheckJson = await runConformanceCheck(applied.map(a => a.ruleId), cwd)
+  const recheckJson = await runConformanceCheck(
+    applied.map(a => a.ruleId),
+    cwd
+  )
   const stillFailed = recheckJson.rules.filter(r => !r.ok)
 
   if (verbose) {

package/scripts/lib/run-lint.mjs

@@ -148,9 +148,7 @@ async function runPerFileRules(ids, ctx) {
  * @returns {Promise<number>} код конформності
  */
 async function runFullConformancePhase(cwd, readOnly, log) {
-  const { escalationLogSize, maybeAnalyzeEscalation, reportRunStats } = await import(
-    './fix/analyze-escalation.mjs'
-  )
+  const { escalationLogSize, maybeAnalyzeEscalation, reportRunStats } = await import('./fix/analyze-escalation.mjs')
   const escOffset = readOnly ? 0 : escalationLogSize()
   const conformanceCode = await runConformance(cwd, readOnly, log)
   if (!readOnly) {