@nitra/cursor 12.15.1 → 12.16.1

package/lib/omlx.mjs

@@ -1,220 +0,0 @@
-/**
- * Спільний транспорт до локального omlx-сервера (OpenAI-сумісний MLX,
- * `http://localhost:8000/v1/chat/completions`). Text-only: жодних `tools`/
- * `tool_calls` — сервер їх не підтримує (див. ADR
- * `260610-1349-агентна-пастка-js-owned-loop-через-omlx-замість-pi-tool-loop`).
- *
- * Маршрутизація між omlx і pi — за конвенцією префікса в model-id:
- *   `omlx/<model>` → прямий HTTP до omlx (локальний inference, без pi)
- *   будь-що інше    → pi CLI (хмарні провайдери або pi-дефолт)
- *
- * Так `resolveModel(tier)` лишається незмінним: достатньо виставити локальний
- * тир у форматі `N_LOCAL_MIN_MODEL=omlx/mlx-community--gemma-4-e2b-it-4bit`, і
- * виклик сам піде напряму в omlx замість pi.
- *
- * Auth: якщо в omlx увімкнено API-ключ, він резолвиться через
- * `resolveOmlxApiKey` (opts → `N_CURSOR_OMLX_KEY` → `~/.omlx/settings.json`)
- * і шлеться як `Authorization: Bearer …`.
- */
-import { spawnSync } from 'node:child_process'
-import { readFileSync } from 'node:fs'
-import { homedir } from 'node:os'
-import { join } from 'node:path'
-import { env } from 'node:process'
-
-/** Дефолтний endpoint omlx (override — `N_CURSOR_OMLX_URL`). */
-export const DEFAULT_OMLX_URL = 'http://127.0.0.1:8000/v1/chat/completions'
-
-/**
- * API-ключ для omlx-сервера, коли в ньому ввімкнено auth
- * (`~/.omlx/settings.json` → `auth.skip_api_key_verification: false`).
- * Порядок: явний `apiKey` → env `N_CURSOR_OMLX_KEY` → `auth.api_key` із
- * локального `~/.omlx/settings.json` (zero-config для власної машини; читання
- * fail-safe) → `null` (заголовок не шлеться).
- * @param {string} [apiKey] явний ключ із opts виклику
- * @returns {string|null} ключ для `Authorization: Bearer …` або null
- */
-export function resolveOmlxApiKey(apiKey) {
-  if (apiKey) return apiKey
-  if (env.N_CURSOR_OMLX_KEY) return env.N_CURSOR_OMLX_KEY
-  try {
-    const settings = JSON.parse(readFileSync(join(homedir(), '.omlx', 'settings.json'), 'utf8'))
-    return settings?.auth?.api_key || null
-  } catch {
-    return null
-  }
-}
-
-const OMLX_PREFIX = 'omlx/'
-
-/** Backoff між transient-ретраями curl (мс): 2 паузи на 3 спроби. */
-const BACKOFF_MS = [2000, 8000]
-
-/**
- * Блокуюча пауза без зайнятого циклу (sync — для retry-loop у `callOmlxRaw`).
- * @param {number} ms тривалість паузи
- * @returns {void}
- */
-function sleepSync(ms) {
-  Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms)
-}
-
-/**
- * Чи цей model-id адресує локальний omlx-бекенд (префікс `omlx/`).
- * @param {unknown} model перевірюваний model-id
- * @returns {boolean} true, якщо рядок починається з `omlx/`
- */
-export function isOmlxModel(model) {
-  return typeof model === 'string' && model.startsWith(OMLX_PREFIX)
-}
-
-/**
- * Прибирає `omlx/`-префікс → чистий model-id для omlx API.
- * Не-omlx-рядки повертає без змін.
- * @param {string} model model-id (можливо з префіксом)
- * @returns {string} model-id без `omlx/`
- */
-export function omlxModelId(model) {
-  return isOmlxModel(model) ? model.slice(OMLX_PREFIX.length) : model
-}
-
-const THINK_TAG_RE = /<think>([\s\S]*?)<\/think>/
-
-/**
- * Витягує reasoning (думки моделі) з omlx-`message`. Джерела за пріоритетом:
- *   - `field`     — окреме поле `message.reasoning_content` (Qwen3-Thinking тощо);
- *   - `think_tag` — `<think>…</think>` усередині `content` (інші thinking-моделі);
- *   - `truncated` — `finish_reason: "length"` зрізав думку в `content` до закриття
- *                   тега → сирий reasoning лишився в `content` без `</think>`;
- *   - `null`      — reasoning немає (не-thinking модель).
- * @param {{content?:string, reasoning_content?:string}} message обʼєкт `choices[0].message`
- * @param {string|null} finishReason `choices[0].finish_reason`
- * @returns {{ reasoning: string|null, reasoningSource: 'field'|'think_tag'|'truncated'|null }} текст думок і його джерело
- */
-export function extractReasoning(message, finishReason) {
-  const field = message?.reasoning_content
-  if (field && field.trim()) return { reasoning: field, reasoningSource: 'field' }
-  const content = message?.content ?? ''
-  const m = content.match(THINK_TAG_RE)
-  if (m) return { reasoning: m[1].trim(), reasoningSource: 'think_tag' }
-  if (finishReason === 'length' && content.trim()) return { reasoning: content, reasoningSource: 'truncated' }
-  return { reasoning: null, reasoningSource: null }
-}
-
-/**
- * Парсить успішну (curl-exit 0) omlx-відповідь у багатий обʼєкт.
- * @param {string} stdout сире тіло відповіді curl
- * @param {number} attempt номер успішної спроби (для поля `attempts`)
- * @returns {{ content:string, reasoning:string|null, reasoningSource:string|null, finishReason:string|null, usage:object|null, attempts:number }} багатий результат
- * @throws {Error} на поганому JSON, api-помилці чи порожньому контенті
- */
-function parseOmlxResponse(stdout, attempt) {
-  let j
-  try {
-    j = JSON.parse(stdout)
-  } catch {
-    throw new Error(`omlx bad json: ${stdout?.slice(0, 200) ?? ''}`)
-  }
-  if (j.error) throw new Error(`omlx api: ${JSON.stringify(j.error).slice(0, 300)}`)
-  const message = j.choices?.[0]?.message ?? {}
-  const finishReason = j.choices?.[0]?.finish_reason ?? null
-  const content = message.content?.trim() ?? ''
-  if (!content) throw new Error(`omlx empty content (finish=${finishReason})`)
-  const { reasoning, reasoningSource } = extractReasoning(message, finishReason)
-  return { content, reasoning, reasoningSource, finishReason, usage: j.usage ?? null, attempts: attempt }
-}
-
-/**
- * Ядро прямого HTTP-виклику до omlx через `curl` (spawnSync). Повертає **багатий**
- * обʼєкт: контент + reasoning + usage + finish_reason + кількість спроб. Ретраїть
- * transient-помилки (curl 18/28/52/56 + spawnSync ETIMEDOUT) із backoff 2s→8s.
- * @param {Array<{role:string, content:string}>} messages OpenAI-messages (system+user збережено)
- * @param {string} model model-id (з/без `omlx/`-префікса); порожній і без `fallbackModel` → throw
- * @param {{ url?: string, timeoutMs?: number, temperature?: number, maxTokens?: number, fallbackModel?: string, apiKey?: string, backoffMs?: number[], thinkingBudget?: number }} [opts] URL, timeout, температура, ліміт виходу, fallback-модель, API-ключ, backoff між ретраями (мс), бюджет thinking-токенів (0 = вимкнено)
- * @returns {{ content:string, reasoning:string|null, reasoningSource:string|null, finishReason:string|null, usage:object|null, attempts:number }} багатий результат виклику
- * @throws {Error} на curl-помилці, не-200 exit, поганому JSON чи порожньому контенті
- */
-export function callOmlxRaw(messages, model, opts = {}) {
-  const {
-    url = env.N_CURSOR_OMLX_URL ?? DEFAULT_OMLX_URL,
-    timeoutMs = 60_000,
-    temperature = 0.2,
-    maxTokens = 4096,
-    fallbackModel = env.N_CURSOR_OMLX_MODEL ?? '',
-    apiKey,
-    backoffMs = BACKOFF_MS,
-    thinkingBudget = 0
-  } = opts
-
-  const m = omlxModelId(model) || fallbackModel
-  if (!m) {
-    throw new Error('omlx: модель не задано — постав N_LOCAL_MIN_MODEL (або N_CURSOR_OMLX_MODEL)')
-  }
-  const body = JSON.stringify({
-    model: m,
-    messages,
-    max_tokens: maxTokens,
-    temperature,
-    ...(thinkingBudget > 0 ? { thinking_budget: thinkingBudget } : {})
-  })
-  // Ключ локального сервера в argv допустимий: localhost-секрет власної машини,
-  // короткоживучий процес; stdin уже зайнятий body (`--data-binary @-`).
-  const key = resolveOmlxApiKey(apiKey)
-  const authArgs = key ? ['-H', `Authorization: Bearer ${key}`] : []
-
-  // 18=transfer closed, 28=operation timeout, 52=empty reply, 56=recv failure — усі transient.
-  const TRANSIENT_CURL_CODES = new Set([18, 28, 52, 56])
-  let lastErr
-  for (let attempt = 1; attempt <= 3; attempt++) {
-    const r = spawnSync(
-      'curl',
-      [
-        '-sS',
-        '-X',
-        'POST',
-        url,
-        '-H',
-        'Content-Type: application/json',
-        '-H',
-        'Connection: close',
-        ...authArgs,
-        '--max-time',
-        String(Math.ceil(timeoutMs / 1000)),
-        '--data-binary',
-        '@-'
-      ],
-      { input: body, encoding: 'utf8', timeout: timeoutMs + 5000 }
-    )
-    if (r.error) {
-      lastErr = new Error(`omlx curl error: ${r.error.message}`)
-      // spawnSync-таймаут (ETIMEDOUT) — transient: сервер перевантажений, ретраїмо з backoff.
-      if (r.error.code === 'ETIMEDOUT' && attempt < 3) {
-        sleepSync(backoffMs[attempt - 1])
-        continue
-      }
-      break
-    }
-    if (r.status !== 0) {
-      if (TRANSIENT_CURL_CODES.has(r.status) && attempt < 3) {
-        lastErr = new Error(`omlx curl exit ${r.status} (transient, retry ${attempt})`)
-        sleepSync(backoffMs[attempt - 1])
-        continue
-      }
-      throw new Error(`omlx curl exit ${r.status}: ${r.stderr?.slice(0, 300) ?? ''}`)
-    }
-    return parseOmlxResponse(r.stdout, attempt)
-  }
-  throw lastErr ?? new Error('omlx unknown failure')
-}
-
-/**
- * Тонка обгортка над `callOmlxRaw` для споживачів, яким потрібен лише текст.
- * Контракт незмінний: повертає непорожній `choices[0].message.content`.
- * @param {Array<{role:string, content:string}>} messages OpenAI-messages
- * @param {string} model model-id (з/без `omlx/`-префікса)
- * @param {object} [opts] ті самі опції, що й у `callOmlxRaw`
- * @returns {string} непорожній контент відповіді
- */
-export function callOmlx(messages, model, opts = {}) {
-  return callOmlxRaw(messages, model, opts).content
-}

package/scripts/lib/fix/docs/llm-fix-apply.md

@@ -1,31 +0,0 @@
----
-type: JS Module
-title: llm-fix-apply.mjs
-resource: npm/scripts/lib/fix/llm-fix-apply.mjs
-docgen:
-  crc: 49f989ca
-  model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 100
----
-
-## Огляд
-
-Це спільне ядро LLM-фіксу, призначене для оркестрації процесу застосування змін, згенерованих моделлю. Модуль використовує `llm-worker.mjs` та `llm-lint-fix.mjs` для забезпечення конформності та виконання лінтер-фіксів. Основний функціонал включає: парсинг відповіді LLM за схемою `{changes:[{path,content}]}` (через `parseChangesResponse`), зчитування необхідних файлів (`readFilesForFix`), та безпечне застосування змін (`applyChanges`). Система реалізує механізм fail-safe, перехоплюючи помилки та повертаючи `null` замість винятків для певних сценаріїв. При цьому шляхи `.git` та `node_modules` свідомо ігноруються.
-
-## Поведінка
-
-parseChangesResponse парсить сирий текст відповіді моделі, витягуючи структуру змін у форматі патчу, або повертає null, якщо парсинг неможливий.
-readFilesForFix читає вміст файлів, вказаних у списку, відносно кореня проєкту. Якщо прямий шлях не знайдено, шукає файл за його базовим ім'ям у проєкті, ігноруючи каталоги `.git` та `node_modules`.
-applyChanges записує вміст, наданий у змінних, у відповідні файли проєкту, створюючи необхідні каталоги, якщо вони відсутні.
-
-## Публічний API
-
-parseChangesResponse — розбирає JSON-відповідь моделі, витягуючи вміст першого об'єкта.
-readFilesForFix — зчитує вміст файлів за заданими шляхами, шукаючи їх у системі, якщо прямий шлях не знайдено.
-applyChanges — замінює вміст файлів на новий, наданий у змінній `changes`.
-
-## Гарантії поведінки
-
-- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
-- За певних помилок повертає порожнє значення (напр. `null`) замість винятку.
-- Свідомо пропускає шляхи: `.git`, `node_modules`.

package/scripts/lib/fix/docs/llm-lint-fix.md

@@ -1,31 +0,0 @@
----
-type: JS Module
-title: llm-lint-fix.mjs
-resource: npm/scripts/lib/fix/llm-lint-fix.mjs
-docgen:
-  crc: de4439e9
-  model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 90
----
-
-Модуль реалізує механізм `omlx-фікс` для обробки знахідок лінтера, що стосуються `detect-only` тулів, які не мають нативного механізму виправлення (відповідно до `lint-orchestrator-fix-readonly`). Він зчитує уражені файли, ініціює запит до моделі через `callLlm` (маршрутизація через `omlx/<model>` з фолбеком каскаду), щоб отримати пропоновані зміни. Ці зміни застосовуються до файлової системи за допомогою спільного ядра `llm-fix-apply`.
-
-## Поведінка
-
-1. Зчитує вміст файлів, зазначених у `filePaths`, використовуючи `projectRoot`.
-2. Формує детальний запит для моделі, включаючи назву тула, інструкцію, сирий вивід знахідок та вміст зчитаних файлів.
-3. Надсилає сформований запит до моделі для отримання виправлень.
-4. Парсить відповідь моделі для вилучення пропонованих змін.
-5. Перевіряє, чи містить відповідь помилку або не містить жодних змін.
-6. Застосовує вилучені зміни до файлової системи, використовуючи `projectRoot`.
-7. Повертає результат виконання `llmLintFix`, що включає статус успіху, можливу помилку або список шляхів, які були успішно виправлені.
-
-## Публічний API
-
-llmLintFix — автоматично виправляє помилки, знайдені лінтером, використовуючи omlx.
-
-## Гарантії поведінки
-
-- Read-only: файл не виконує операцій запису у файлову систему.
-- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
-- Не звертається до мережі.

package/scripts/lib/fix/docs/llm-worker.md

@@ -1,28 +0,0 @@
----
-type: JS Module
-title: llm-worker.mjs
-resource: npm/scripts/lib/fix/llm-worker.mjs
-docgen:
-  crc: b5e54981
-  model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 100
----
-
-## Огляд
-
-Модуль витягує унікальні відносні шляхи файлів з даних про порушення, використовуючи конфігурацію з target.json. Потім він викликає LLM для генерації змін, які виправляють кожне порушення.
-
-## Поведінка
-
-extractFilePaths витягує унікальні відносні шляхи файлів з вихідних даних про порушення, розпізнаючи як явні помилки, так і контекст файлів.
-runLlmWorker виправляє одне порушення правила, викликаючи LLM для генерації змін, парсить відповідь та застосовує зміни до файлової системи.
-
-## Публічний API
-
-extractFilePaths — Визначає шляхи файлів, які потребують виправлення, використовуючи `target.json` як пріоритет, а у разі його відсутності — всі знайдені шляхи.
-runLlmWorker — Виправляє одне порушення правила, використовуючи модель LLM. Повертає результати виправлення або діагностики, які використовуються для подальшої обробки.
-
-## Гарантії поведінки
-
-- Read-only: не виконує операцій запису (ФС/БД).
-- Перехоплює помилки і не пропускає винятків назовні (fail-safe).

package/scripts/lib/fix/docs/verbose-block.md

@@ -1,27 +0,0 @@
----
-type: JS Module
-title: verbose-block.mjs
-resource: npm/scripts/lib/fix/verbose-block.mjs
-docgen:
-  crc: 1a921dca
-  model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 100
----
-
-Цей файл виводить детальний блок інформації після кожного LLM-рунга у режимі `--full`. Він друкує стислий опис промпту, включаючи деталі про правила, порушення та зворотний зв'язок. Також виводиться монолог моделі, якщо він присутній. Вивід блоку вимикається при встановленні `N_CURSOR_FIX_VERBOSE=off`.
-
-## Поведінка
-
-1. Викликається `printVerboseBlock` для виведення детальної інформації після кожного LLM-рунга у режимі `--full`.
-2. `printVerboseBlock` виводить стислий опис промпту, включаючи ID правила, довжину правила, довжину порушення, кількість та розмір файлів, а також інформацію про зворотний зв'язок (наявність, модель, кількість змін, помилка).
-3. Якщо надано монолог моделі (reasoning), `printVerboseBlock` виводить його, показуючи прев'ю (з можливим зазначенням загальної довжини), і вказує джерело цього монологу.
-4. Якщо монологу моделі немає, `printVerboseBlock` виводить повідомлення про відсутність монологу.
-5. Виведення здійснюється лише якщо змінна середовища `N_CURSOR_FIX_VERBOSE` не встановлена як `off`.
-
-## Публічний API
-
-printVerboseBlock — виводить детальний опис промпту та внутрішній роздум моделі після символу завершення рядка рунга.
-
-## Гарантії поведінки
-
-- Read-only: не виконує операцій запису (ФС/БД).

package/scripts/lib/fix/llm-fix-apply.mjs

@@ -1,113 +0,0 @@
-/**
- * Спільне ядро LLM-фіксу: парс відповіді `{changes:[{path,content}]}`, читання файлів
- * під фікс і застосування змін. Використовують і `llm-worker.mjs` (конформність), і
- * `llm-lint-fix.mjs` (per-tool лінтер-фіксери) — щоб не дублювати парс/apply (knip/jscpd).
- */
-import { execSync } from 'node:child_process'
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
-import { basename, dirname, join } from 'node:path'
-
-const JSON_CODE_BLOCK_RE = /```(?:json)?[ \t]{0,8}\n?([\s\S]*?)```/
-
-/**
- * Парсить JSON-відповідь моделі: прямий JSON → ```json-блок``` → перший `{…}`-блок.
- * @param {string} text сирий текст відповіді
- * @returns {{ changes?: Array<{path:string,content:string}>, error?: string } | null} патч або null
- */
-export function parseChangesResponse(text) {
-  try {
-    return JSON.parse(text)
-  } catch {
-    /* fallthrough */
-  }
-  const block = text.match(JSON_CODE_BLOCK_RE)
-  if (block) {
-    try {
-      return JSON.parse(block[1].trim())
-    } catch {
-      /* fallthrough */
-    }
-  }
-  const start = text.indexOf('{')
-  const end = text.lastIndexOf('}')
-  if (start !== -1 && end > start) {
-    try {
-      return JSON.parse(text.slice(start, end + 1))
-    } catch {
-      /* fallthrough */
-    }
-  }
-  return null
-}
-
-/**
- * Шукає файл за basename у дереві проєкту (fallback коли прямий шлях не існує).
- * Повертає відносний шлях якщо знайдено рівно один матч, інакше `null` (ambiguous/not found).
- * @param {string} name basename файлу
- * @param {string} projectRoot абсолютний корінь
- * @returns {string|null} відносний шлях або null
- */
-function findByBasename(name, projectRoot) {
-  try {
-    const raw = execSync(
-      `find . -maxdepth 7 -name '${name.replace(/'/g, "'\\''")}' -not -path '*/node_modules/*' -not -path '*/.git/*' -not -path '*/.worktrees/*'`,
-      { cwd: projectRoot, encoding: 'utf8', timeout: 3000 }
-    ).trim()
-    const hits = raw.split('\n').filter(Boolean)
-    return hits.length === 1 ? hits[0].replace(/^\.\//, '') : null
-  } catch {
-    return null
-  }
-}
-
-/**
- * Читає існуючі файли за відносними шляхами у форму `{path, content}` (для prompt).
- * Якщо файл не знайдений за прямим шляхом — намагається знайти за basename через `find`.
- * Повертає resolved path (може відрізнятись від вхідного коли `find` знайшов реальне місце).
- * @param {string[]} filePaths відносні шляхи від кореня
- * @param {string} projectRoot абсолютний корінь
- * @returns {Array<{path:string, content:string}>} наявні файли з вмістом
- */
-export function readFilesForFix(filePaths, projectRoot) {
-  return filePaths
-    .map(p => {
-      let abs = join(projectRoot, p)
-      let resolvedPath = p
-      if (!existsSync(abs)) {
-        const found = findByBasename(basename(p), projectRoot)
-        if (found) {
-          resolvedPath = found
-          abs = join(projectRoot, found)
-        }
-      }
-      if (!existsSync(abs)) return null
-      try {
-        return { path: resolvedPath, content: readFileSync(abs, 'utf8') }
-      } catch {
-        return null
-      }
-    })
-    .filter(Boolean)
-}
-
-/**
- * Застосовує `changes` до ФС (повний вміст файлу, не diff).
- * @param {Array<{path:string, content:string}>} changes зміни
- * @param {string} projectRoot абсолютний корінь
- * @returns {{ ok: boolean, error?: string }} статус
- */
-export function applyChanges(changes, projectRoot) {
-  for (const change of changes) {
-    if (!change.path || typeof change.content !== 'string') continue
-    try {
-      const abs = join(projectRoot, change.path)
-      // Створюємо батьківську теку перед записом: модель може запропонувати новий файл
-      // у ще неіснуючому каталозі (напр. `<ws>/.changes/…`) — інакше writeFileSync ENOENT.
-      mkdirSync(dirname(abs), { recursive: true })
-      writeFileSync(abs, change.content, 'utf8')
-    } catch (error) {
-      return { ok: false, error: `write ${change.path}: ${error.message}` }
-    }
-  }
-  return { ok: true }
-}

package/scripts/lib/fix/llm-lint-fix.mjs

@@ -1,82 +0,0 @@
-/**
- * Per-tool omlx-фікс лінтер-знахідок (point 4 спеки lint-orchestrator-fix-readonly).
- *
- * Для detect-only тулів без нативного `--fix` (cspell, knip, actionlint, v8r тощо): читає
- * уражені файли, просить omlx виправити за tool-специфічною інструкцією, застосовує `{changes}`.
- * Re-detect (перевірка, що знахідка закрита) — на стороні caller (convergence-патерн).
- *
- * Маршрут моделі — через `callLlm` за префіксом: `omlx/<model>` → локальний HTTP (дефолт
- * `resolveModel('min')`); cloud — фолбек каскаду. Парс/застосування — спільне ядро `llm-fix-apply`.
- */
-import { env } from 'node:process'
-
-import { resolveModel } from '../../../lib/models.mjs'
-import { callLlm } from '../../../lib/llm.mjs'
-import { applyChanges, parseChangesResponse, readFilesForFix } from './llm-fix-apply.mjs'
-
-/** Дефолтний локальний тир (omlx); env `N_CURSOR_FIX_MODEL` перекриває. */
-const DEFAULT_MODEL = env.N_CURSOR_FIX_MODEL ?? resolveModel('min')
-
-/**
- * Будує prompt для omlx: tool-інструкція + знахідки + повний вміст файлів.
- * @param {string} tool назва тула (cspell/knip/…)
- * @param {string} instruction що саме виправити (tool-специфічно)
- * @param {string} findings сирий вивід тула (знахідки)
- * @param {Array<{path:string, content:string}>} files файли під фікс
- * @returns {string} prompt
- */
-function buildLintFixPrompt(tool, instruction, findings, files) {
-  const filesBlock = files.map(f => `<file path="${f.path}">\n${f.content}\n</file>`).join('\n\n')
-  return [
-    `You fix ${tool} lint findings. Return ONLY valid JSON — no explanation, no markdown.`,
-    ``,
-    `Task: ${instruction}`,
-    ``,
-    `${tool} findings:`,
-    findings,
-    ``,
-    `Current file contents:`,
-    filesBlock,
-    ``,
-    `Return JSON with this exact shape:`,
-    `{"changes":[{"path":"relative/path","content":"full corrected file content"}]}`,
-    ``,
-    `Rules:`,
-    `- "path" is relative to the project root (use the path from the <file> tag)`,
-    `- "content" is the COMPLETE new file content (not a diff)`,
-    `- Only include files that actually need to change; preserve everything unrelated verbatim`,
-    `- If nothing should be auto-fixed, return {"changes":[],"error":"reason"}`
-  ].join('\n')
-}
-
-/**
- * Виправляє лінтер-знахідки через omlx і застосовує зміни.
- * @param {{ tool:string, instruction:string, findings:string, filePaths:string[], projectRoot:string, model?:string }} opts параметри
- * @returns {{ ok:boolean, error?:string, fixed:string[] }} статус + список змінених шляхів
- */
-export function llmLintFix({ tool, instruction, findings, filePaths, projectRoot, model }) {
-  const m = model ?? DEFAULT_MODEL
-  const files = readFilesForFix(filePaths, projectRoot)
-  if (files.length === 0) return { ok: false, error: 'no readable files to fix', fixed: [] }
-
-  let text
-  try {
-    text = callLlm([{ role: 'user', content: buildLintFixPrompt(tool, instruction, findings, files) }], m, {
-      timeoutMs: 120_000,
-      caller: `lint:${tool}`
-    })
-  } catch (error) {
-    return { ok: false, error: String(error.message), fixed: [] }
-  }
-
-  const parsed = parseChangesResponse(text)
-  if (!parsed) return { ok: false, error: `cannot parse omlx response: ${String(text).slice(0, 200)}`, fixed: [] }
-  if (parsed.error) return { ok: false, error: parsed.error, fixed: [] }
-
-  const changes = (parsed.changes ?? []).filter(c => c.path && typeof c.content === 'string')
-  if (changes.length === 0) return { ok: false, error: 'omlx returned no changes', fixed: [] }
-
-  const applied = applyChanges(changes, projectRoot)
-  if (!applied.ok) return { ok: false, error: applied.error, fixed: [] }
-  return { ok: true, fixed: changes.map(c => c.path) }
-}