---
type: JS Module
title: fix-worker.mjs
resource: npm/rules/text/cspell-fix/fix-worker.mjs
docgen:
  crc: f7dc29a5
  model: openai-codex/gpt-5.5
---

## Огляд

`text/cspell-fix` обробляє знахідки cspell з “Unknown word”, класифікує їх через `omlx` у bounded JSON і дописує валідні доменні слова до `.cspell.json#words`, щоб наступна перевірка не вважала їх помилками.

Імовірні одруки не застосовуються автоматично, бо безпечність такого виправлення не гарантована. Успішність lint-процесу визначає повторна canonical-перевірка після worker-а, а не сам worker.

Класифікація використовує `N_LOCAL_MIN_MODEL`; tier-aware routing і cloud-tier fallback у цьому кроці не виконуються.

Конфіги, на які спирається код: .cspell.json

## Поведінка

1. `fixWorker` запускає виправлення для проблем орфографічного словника, коли доступна модель класифікації та інструмент перевірки тексту.

2. Якщо перевірка не знаходить невідомих слів, `fixWorker` завершується без змін.

3. Знайдені невідомі слова передаються на bounded-класифікацію, щоб відокремити валідні доменні слова від імовірних одруків.

4. Валідні слова додаються до словника проєкту в `.cspell.json`, щоб наступні перевірки не підсвічували їх як помилки.

5. Імовірні одруки не виправляються автоматично, бо безпечне застосування таких змін потребує людського рішення.

6. `fixWorker` не визначає успішність усього lint-процесу: остаточний результат має підтвердити повторна canonical-перевірка після виконання worker-а.

7. `fixWorker` повертає перелік змінених файлів і коротку телеметрію про класифікацію, додані слова, одруки та обрізання великого набору знахідок.

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

- Read-only: не виконує операцій запису (ФС/БД).