@nitra/cursor 12.15.0 → 12.16.0

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,33 +0,0 @@
----
-type: JS Module
-title: llm-worker.mjs
-resource: npm/scripts/lib/fix/llm-worker.mjs
-docgen:
-  crc: 5d019a98
-  model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 100
----
-
-## Огляд
-
-Модуль виділяє унікальні відносні шляхи файлів, пов'язаних із порушеннями, та виконує LLM-виклик для виправлення одного rule-порушення. Підтримує вибір sub-check `.mdc` за конкретним target-файлом — замість повного `n-{id}.mdc` передає моделі лише релевантну секцію правила (1–2 KB замість 20+ KB).
-
-## Поведінка
-
-`extractFilePaths` витягує унікальні відносні шляхи файлів із violation output, пріоритетно розбираючи рядки ❌ (файли що потребують фіксу), потім generic-regex для контексту. Розуміє workspace-prefix `[npm] path/file.ext → npm/path/file.ext`.
-
-`selectSubCheckMdc` читає `policy/<concern>/target.json` з каталогу `npm/rules/{ruleId}/` пакету, знаходить concerns із `files.single`, що відповідають failing-файлам із violation output, і повертає конкатенацію відповідних `.mdc`. Повертає `null` якщо правило не має policy-підкаталогу або жоден concern не збігається з ❌-файлами.
-
-`runLlmWorker` спочатку викликає `selectSubCheckMdc` — і якщо отримує match, передає моделі лише той sub-check `.mdc`. Якщо match немає — fallback на повний `n-{id}.mdc`. Далі читає файли з violation output, будує prompt, викликає LLM через `callLlmRich` і застосовує зміни.
-
-## Публічний API
-
-`extractFilePaths(output)` — повертає унікальні відносні шляхи файлів з violation output (❌-рядки першими).
-
-`runLlmWorker(ruleId, violationOutput, projectRoot, opts)` — виправляє одне порушення правила через LLM. Повертає `{ ok, error?, changes, diagnosis, reasoning, reasoningSource, promptSummary }`. `promptSummary.subCheckMdc: boolean` вказує чи використано точковий sub-check замість повного mdc.
-
-## Гарантії поведінки
-
-- Читає `policy/` безпосередньо з пакету (`import.meta.dirname/../../../rules/`), без pre-generation файлів.
-- Fallback на повний `n-{id}.mdc` при: відсутності policy-підкаталогу, `walkGlob`-таргетах, відсутності ❌-файлів у violation, нульовому match.
-- Перехоплює всі помилки LLM і повертає структурований `{ ok: false, error }`.

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) }
-}

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

@@ -1,332 +0,0 @@
-/** @see ./docs/llm-worker.md */
-
-import { existsSync, readdirSync, readFileSync } from 'node:fs'
-import { join } from 'node:path'
-import { env } from 'node:process'
-import { resolveModel } from '../../../lib/models.mjs'
-import { callLlmRich } from '../../../lib/llm.mjs'
-import { applyChanges, parseChangesResponse, readFilesForFix } from './llm-fix-apply.mjs'
-
-// Дефолтна модель, коли викликач не задав `opts.model` (legacy/прямі виклики).
-// Драбина ескалації (`orchestrator.mjs`) завжди передає модель рунга явно, тож
-// тут лишається тільки fallback на min-тир. Перевизначення — `N_CURSOR_FIX_MODEL`.
-const MODEL = env.N_CURSOR_FIX_MODEL ?? resolveModel('min')
-
-// Бюджет thinking-токенів для omlx-моделей (Gemma 4 та ін., що підтримують thinking_budget).
-// Значення 0 вимикає thinking. Перевизначення — `N_CURSOR_OMLX_THINKING_BUDGET`.
-const DEFAULT_THINKING_BUDGET = Number(env.N_CURSOR_OMLX_THINKING_BUDGET ?? 4096)
-
-const API_KEY_RE = /api key/i
-
-const FILE_EXTS = 'json|js|mjs|ts|vue|yml|yaml|toml|mdc|md|sh|py'
-
-/**
- * Каталог `npm/rules/` у пакеті — для вибору sub-check .mdc.
- * Шлях: <package>/npm/scripts/lib/fix/ → ../../.. → npm/ → rules/.
- */
-const PACKAGE_RULES_DIR = join(import.meta.dirname, '..', '..', '..', 'rules')
-
-/**
- * Витягує шляхи файлів лише з рядків ❌ у violation output.
- * Без workspace-розгортання — повертає bare path для звірки з target.json.
- * @param {string} output violation output
- * @returns {string[]} унікальні шляхи з ❌-рядків
- */
-function extractFailPaths(output) {
-  const seen = new Set()
-  const add = p => {
-    seen.add(p)
-  }
-  const failSep = `(?::\\d+)?(?::\\s|[\\s—]|$)`
-  // ❌ [ws] path/file.ext → strip workspace, зберігаємо bare file
-  const failWsRe = new RegExp(`^\\s*❌\\s+\\[[\\w-]+\\]\\s+([\\w./][\\w./-]*\\.(?:${FILE_EXTS}))${failSep}`, 'gm')
-  for (const m of output.matchAll(failWsRe)) add(m[1])
-  const failRe = new RegExp(`^\\s*❌\\s+(\\.?[\\w][\\w./-]*\\.(?:${FILE_EXTS}))${failSep}`, 'gm')
-  for (const m of output.matchAll(failRe)) add(m[1])
-  return [...seen]
-}
-
-/**
- * Для правил з `policy/<concern>/` підбирає лише ті concern-.mdc, що відповідають
- * файлам з ❌-рядків violation output. Читає безпосередньо з пакету (`PACKAGE_RULES_DIR`),
- * тому не потребує pre-generation. Fallback — null (→ повний n-{id}.mdc у caller).
- * @param {string} ruleId ID правила
- * @param {string} violationOutput violation output
- * @returns {string|null} конкатенація релевантних .mdc або null
- */
-function selectSubCheckMdc(ruleId, violationOutput) {
-  const policyDir = join(PACKAGE_RULES_DIR, ruleId, 'policy')
-  if (!existsSync(policyDir)) return null
-
-  const failPaths = extractFailPaths(violationOutput)
-  if (failPaths.length === 0) return null
-
-  const matched = []
-  let concerns
-  try {
-    concerns = readdirSync(policyDir, { withFileTypes: true })
-  } catch {
-    return null
-  }
-
-  for (const entry of concerns) {
-    if (!entry.isDirectory()) continue
-    const concernDir = join(policyDir, entry.name)
-    const targetPath = join(concernDir, 'target.json')
-    if (!existsSync(targetPath)) continue
-
-    let target
-    try {
-      target = JSON.parse(readFileSync(targetPath, 'utf8'))
-    } catch {
-      continue
-    }
-
-    const targetFile = target?.files?.single
-    if (!targetFile) continue // walkGlob та інші типи → skip, fallback на main.mdc
-
-    // Перевіряємо чи хоч один failing path закінчується на targetFile
-    const hit = failPaths.some(p => p === targetFile || p.endsWith(`/${targetFile}`))
-    if (!hit) continue
-
-    const mdcEntry = readdirSync(concernDir).find(f => f.endsWith('.mdc'))
-    if (!mdcEntry) continue
-    matched.push(readFileSync(join(concernDir, mdcEntry), 'utf8').trim())
-  }
-
-  return matched.length > 0 ? matched.join('\n\n') : null
-}
-
-/**
- * Витягує відносні шляхи файлів із violation output.
- * Розуміє workspace-prefix: `[npm] skills/foo.mjs` → `npm/skills/foo.mjs`.
- * Спочатку явно парсить рядки ❌ (найвищий сигнал — файл потребує фіксу),
- * потім підхоплює решту файлів generic-regex (контекст для читання).
- * @param {string} output violation output з fix check
- * @returns {string[]} унікальні відносні шляхи (від кореня проєкту)
- */
-export function extractFilePaths(output) {
-  const seen = new Set()
-  const results = []
-  const add = p => {
-    if (!seen.has(p)) {
-      seen.add(p)
-      results.push(p)
-    }
-  }
-
-  // 1. Явні рядки ❌ — найвищий сигнал: саме ці файли потребують фіксу.
-  //    Формати: `❌ [ws] path/file.ext:line — msg` та `❌ path/file.ext: msg`
-  //    Роздільник після шляху: `:` (з пробілом або цифрою), `—` (em-dash), або кінець рядка.
-  const failSep = `(?::\\d+)?(?::\\s|[\\s—]|$)`
-  const failWsRe = new RegExp(`^\\s*❌\\s+\\[([\\w-]+)\\]\\s+([\\w./][\\w./-]*\\.(?:${FILE_EXTS}))${failSep}`, 'gm')
-  for (const m of output.matchAll(failWsRe)) add(`${m[1]}/${m[2]}`)
-
-  const failRe = new RegExp(`^\\s*❌\\s+(\\.?[\\w][\\w./-]*\\.(?:${FILE_EXTS}))${failSep}`, 'gm')
-  for (const m of output.matchAll(failRe)) add(m[1])
-
-  // 2. Generic-regex: підхоплює файли з ✅-рядків та описів (контекст для читання).
-  //    Workspace: [npm] skills/foo.mjs
-  const wsRe = new RegExp(`\\[([\\w-]+)\\]\\s+([\\w./][\\w./-]*\\.(?:${FILE_EXTS}))(?::\\d+)?`, 'gm')
-  for (const m of output.matchAll(wsRe)) add(`${m[1]}/${m[2]}`)
-
-  //    Без workspace: path/to/file.ext або ./file.ext
-  const re = new RegExp(`(?:^|\\s)(\\.?\\w[\\w./-]*\\.(?:${FILE_EXTS}))(?::\\d+)?`, 'gm')
-  for (const m of output.matchAll(re)) add(m[1])
-
-  return results
-}
-
-/**
- * Будує prompt для pi: правило + порушення + поточний вміст файлів.
- * Будує опційний feedback-блок драбини ескалації: попередній рунг застосував
- * зміни, але re-check лишився червоним. Просимо модель спершу (в полі `diagnosis`)
- * сформулювати, **чому** попередня спроба не задовольнила правило, тоді виправити.
- * @param {{ previousModel?: string, previousChanges?: Array<{path:string}>, previousError?: string|null } | null} feedback контекст попереднього рунга
- * @returns {string[]} рядки prompt-блоку (порожній масив, якщо feedback немає)
- */
-function buildFeedbackBlock(feedback) {
-  if (!feedback) return []
-  const changedPaths = (feedback.previousChanges ?? []).map(c => c.path).filter(Boolean)
-  return [
-    ``,
-    `A PREVIOUS attempt (model: ${feedback.previousModel || 'pi'}) did NOT resolve this violation.`,
-    changedPaths.length > 0
-      ? `Previously changed files: ${changedPaths.join(', ')}`
-      : `The previous attempt produced no usable changes.`,
-    feedback.previousError ? `Previous attempt error: ${feedback.previousError}` : ``,
-    `The violation output below is what STILL fails after that attempt.`,
-    `In the "diagnosis" field, briefly state WHY the previous attempt failed, then provide a corrected fix.`
-  ].filter(line => line !== ``)
-}
-
-/**
- * @param {string} ruleId ID правила
- * @param {string} ruleMdc   вміст .mdc-файлу правила
- * @param {string} output    violation output
- * @param {Array<{path:string, content:string}>} files прочитані файли (path + content)
- * @param {{ previousModel?: string, previousChanges?: Array<{path:string}>, previousError?: string|null } | null} [feedback] контекст попереднього рунга драбини (для retry-with-feedback)
- * @returns {string} текст промпта для pi
- */
-function buildPrompt(ruleId, ruleMdc, output, files, feedback = null) {
-  const filesBlock =
-    files.length === 0
-      ? '(no files identified)'
-      : files.map(f => `<file path="${f.path}">\n${f.content}\n</file>`).join('\n\n')
-
-  return [
-    `You fix project structure violations. Return ONLY valid JSON — no explanation, no markdown.`,
-    ...buildFeedbackBlock(feedback),
-    ``,
-    `Rule (n-${ruleId}.mdc):`,
-    `---`,
-    ruleMdc,
-    `---`,
-    ``,
-    `Violation output:`,
-    output,
-    ``,
-    `Current file contents:`,
-    filesBlock,
-    ``,
-    `Return JSON with this exact shape:`,
-    `{"diagnosis":"short reason the rule fails (or why prior attempt failed); empty string if first attempt","changes":[{"path":"relative/path/to/file","content":"full corrected file content"}]}`,
-    ``,
-    `Rules:`,
-    `- "path" is relative to the project root`,
-    `- "content" is the complete new file content (not a diff)`,
-    `- Only include files that actually need to change`,
-    `- "diagnosis" is plain text inside the JSON — do NOT emit prose outside the JSON`,
-    `- If nothing can be fixed automatically, return {"diagnosis":"...","changes":[],"error":"reason"}`
-  ].join('\n')
-}
-
-/**
- * Викликає LLM через `callLlmRich` (маршрут за префіксом model-id; wire-trace).
- * Повертає reasoning поряд із текстом — для verbose-блоку оркестратора.
- * Зберігає дружнє повідомлення про відсутній API-ключ для хмарних провайдерів.
- * @param {string} prompt текст промпта
- * @param {string} model назва моделі (provider/id, `omlx/...` або '')
- * @param {string} caller мітка викликача для wire-trace (`fix:<rule>:<rung>`)
- * @param {number} [timeoutMs] ліміт виклику (драбина задає per-tier; undefined → дефолт callLlmRich)
- * @param {number} [thinkingBudget] бюджет thinking-токенів (лише omlx; 0 = вимкнено)
- * @returns {{ text: string, reasoning: string|null, reasoningSource: string|null, error?: string }}
- */
-function callModel(prompt, model, caller, timeoutMs, thinkingBudget) {
-  try {
-    const { content, reasoning, reasoningSource } = callLlmRich([{ role: 'user', content: prompt }], model, {
-      timeoutMs,
-      caller,
-      thinkingBudget
-    })
-    return { text: content, reasoning, reasoningSource }
-  } catch (error) {
-    const msg = String(error.message)
-    if (API_KEY_RE.test(msg)) {
-      const provider = model ? model.split('/')[0] : 'дефолтного провайдера'
-      return {
-        text: '',
-        reasoning: null,
-        reasoningSource: null,
-        error: [
-          `pi: немає ключа для ${provider}.`,
-          `Встановіть N_CLOUD_MIN_MODEL=provider/model-id`,
-          `(напр.: openai/gpt-5.4-mini, google/gemini-2.5-flash, ollama/gemma3:4b)`
-        ].join(' ')
-      }
-    }
-    return { text: '', reasoning: null, reasoningSource: null, error: msg }
-  }
-}
-
-/**
- * LLM-worker: виправляє одне rule-порушення через pi (C1 pattern).
- * Повертає `changes`/`diagnosis` навіть при невдачі — драбина ескалації
- * (`orchestrator.mjs`) логує їх і прокидає як feedback у наступний рунг.
- * Поля `reasoning`/`reasoningSource`/`promptSummary` використовує оркестратор
- * для verbose-блоку після кожного рунга (`--full` режим).
- * @param {string} ruleId ID правила
- * @param {string} violationOutput  output з fix check для цього rule
- * @param {string} projectRoot      абсолютний шлях до кореня проєкту
- * @param {{ model?: string, feedback?: object|null, caller?: string, timeoutMs?: number, thinkingBudget?: number }} opts опції:
- *   `model` — перевизначення моделі; `feedback` — контекст попереднього рунга
- *   драбини (retry-with-feedback); `caller` — мітка для wire-trace; `timeoutMs` —
- *   per-tier ліміт виклику (драбина: локалі fail-fast, хмара повний);
- *   `thinkingBudget` — кількість thinking-токенів для omlx (дефолт `DEFAULT_THINKING_BUDGET`)
- * @returns {{ ok: boolean, error?: string, changes: Array<{path:string}>, diagnosis: string|null, reasoning: string|null, reasoningSource: string|null, promptSummary: object }}
- */
-export function runLlmWorker(ruleId, violationOutput, projectRoot, opts = {}) {
-  const model = opts.model ?? MODEL
-  const feedback = opts.feedback ?? null
-  const caller = opts.caller ?? 'fix'
-  const timeoutMs = opts.timeoutMs
-  const thinkingBudget = opts.thinkingBudget ?? DEFAULT_THINKING_BUDGET
-
-  // 1. Читаємо rule .mdc: спробуємо sub-check mdc для конкретної перевірки,
-  //    якщо не вдалося — fallback на повний n-{id}.mdc.
-  const subMdc = selectSubCheckMdc(ruleId, violationOutput)
-  const mdcPath = join(projectRoot, '.cursor', 'rules', `n-${ruleId}.mdc`)
-  const ruleMdc = subMdc ?? (existsSync(mdcPath) ? readFileSync(mdcPath, 'utf8') : '(rule file not found)')
-
-  // 2. Витягуємо файли з violation output і читаємо їх
-  const files = readFilesForFix(extractFilePaths(violationOutput), projectRoot)
-
-  // 3. Будуємо summary промпту (для verbose-блоку) до виклику моделі
-  const promptSummary = {
-    ruleMdcLen: ruleMdc.length,
-    subCheckMdc: !!subMdc,
-    violationLen: violationOutput.length,
-    filesCount: files.length,
-    filesTotalBytes: files.reduce((s, f) => s + f.content.length, 0),
-    hasFeedback: !!feedback,
-    feedbackModel: feedback?.previousModel ?? null,
-    feedbackChangesCount: feedback?.previousChanges?.length ?? 0,
-    feedbackError: feedback?.previousError ?? null
-  }
-
-  // 4. Будуємо prompt і викликаємо модель
-  const prompt = buildPrompt(ruleId, ruleMdc, violationOutput, files, feedback)
-  const {
-    text,
-    error: modelError,
-    reasoning,
-    reasoningSource
-  } = callModel(prompt, model, caller, timeoutMs, thinkingBudget)
-
-  if (modelError)
-    return { ok: false, error: modelError, changes: [], diagnosis: null, reasoning, reasoningSource, promptSummary }
-  if (!text)
-    return {
-      ok: false,
-      error: 'model returned empty response',
-      changes: [],
-      diagnosis: null,
-      reasoning,
-      reasoningSource,
-      promptSummary
-    }
-
-  // 5. Парсимо відповідь
-  const parsed = parseChangesResponse(text)
-  if (!parsed) {
-    return {
-      ok: false,
-      error: `cannot parse pi response: ${text.slice(0, 200)}`,
-      changes: [],
-      diagnosis: null,
-      reasoning,
-      reasoningSource,
-      promptSummary
-    }
-  }
-  const diagnosis = typeof parsed.diagnosis === 'string' && parsed.diagnosis ? parsed.diagnosis : null
-  const changes = parsed.changes ?? []
-  if (parsed.error)
-    return { ok: false, error: parsed.error, changes, diagnosis, reasoning, reasoningSource, promptSummary }
-  if (changes.length === 0)
-    return { ok: false, error: 'pi returned no changes', changes, diagnosis, reasoning, reasoningSource, promptSummary }
-
-  // 6. Застосовуємо зміни
-  const applied = applyChanges(changes, projectRoot)
-  return { ...applied, changes, diagnosis, reasoning, reasoningSource, promptSummary }
-}