---
docgen:
  source: npm/rules/text/lint/cspell-fix.mjs
  crc: 3ce66d8a
  model: omlx/gemma-4-e4b-it-OptiQ-4bit
  score: 90
---

# cspell-fix.mjs

## Огляд

Модуль інтегрує `cspell` у ланцюжок `lint-text` для виявлення орфографічних помилок. У режимі з можливістю виправлення, процес відбувається шляхом: детект (захоплення виводу) $\rightarrow$ групування знахідок по файлах $\rightarrow$ per-file `omlx-фікс` справжніх помилок (`llmLintFix`) $\rightarrow$ re-detect. У read-only режимі виконується лише детект, що гарантує нуль мутацій. Валідні терміни omlx залишаються, їх ловить повторний `cspell` (далі — у словник `@nitra/cspell-dict`).

## Поведінка

groupFindingsByFile групує вивід `cspell` за файлами, виділяючи знахідки.
runCspellText запускає `cspell` для виявлення орфографічних помилок, а при вимкненому режимі читання виконує автоматичне виправлення помилок за допомогою зовнішнього інструменту для файлів, що містять справжні помилки, і повторно перевіряє файли.

## Публічний API

groupFindingsByFile — збирає знайдені помилки cspell у групи за файлами.
runCspellText — виконує перевірку тексту за правилами cspell, застосовуючи автоматичне виправлення від omlx.

## Гарантії поведінки

- Read-only: файл не виконує операцій запису у файлову систему.
- Не звертається до мережі.
