@nitra/cursor 5.0.2 → 5.1.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [5.1.0] - 2026-06-10
+
+### Changed
+
+- local-inference: маршрут моделей за префіксом `omlx/` напряму в omlx HTTP (npm/lib/omlx.mjs) минаючи pi; coverage-classify і fix/llm-worker переведено на спільний callOmlx, docgen де-дубльовано; pi лишається шаром для хмари й агентних задач (ADR 260610-1349)
+
+## [5.0.3] - 2026-06-10
+
+### Changed
+
+- docs(abie): regenerate hc-yaml + http-route via omlx-orchestrator
+
 ## [5.0.2] - 2026-06-10
 
 ### Changed

package/lib/models.mjs

@@ -5,13 +5,21 @@
  * Налаштовується один раз у середовищі; кожен скіл посилається на потрібний тир.
  *
  * Приклад ~/.bashrc або .env:
- *   N_LOCAL_MIN_MODEL=ollama/gemma3:4b
+ *   N_LOCAL_MIN_MODEL=omlx/mlx-community--gemma-4-e2b-it-4bit
  *   N_CLOUD_MIN_MODEL=openai/gpt-5.4-mini
  *   N_CLOUD_AVG_MODEL=openai/gpt-5.4
  *   N_CLOUD_MAX_MODEL=openai/gpt-5.5
  *
  * Значення '' означає "pi дефолтний провайдер" (залежить від ~/.pi конфігу).
  *
+ * ## Бекенд за префіксом model-id
+ *
+ * model-id з префіксом `omlx/...` маршрутизується прямим HTTP до локального
+ * omlx-сервера (`npm/lib/omlx.mjs`), минаючи pi; решта (`openai/...`,
+ * `ollama/...`, '') — через pi CLI. Тому локальні тири варто задавати у форматі
+ * `omlx/<model>`, аби local-inference йшов напряму, а pi лишався шаром для хмари
+ * (див. ADR 260610-1349).
+ *
  * ## Каскад local → cloud (контракт)
  *
  * Використовуйте resolveModel(tier) замість прямих констант — система прозоро

package/lib/omlx.mjs

@@ -0,0 +1,102 @@
+/**
+ * Спільний транспорт до локального 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.
+ */
+import { spawnSync } from 'node:child_process'
+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'
+
+/** Дефолтна модель, якщо в id лишився голий `omlx/` (override — `N_CURSOR_OMLX_MODEL`). */
+export const DEFAULT_OMLX_MODEL = 'mlx-community--gemma-4-e2b-it-4bit'
+
+const OMLX_PREFIX = 'omlx/'
+
+/**
+ * Чи цей 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
+}
+
+/**
+ * Прямий HTTP-виклик до omlx через `curl` (spawnSync). Повертає текст
+ * `choices[0].message.content`. Ретраїть лише transient curl-помилки
+ * (18 = transfer closed, 52 = empty reply, 56 = recv failure).
+ *
+ * @param {Array<{role:string, content:string}>} messages OpenAI-messages (system+user збережено)
+ * @param {string} model model-id (з/без `omlx/`-префікса); порожній → дефолт
+ * @param {{ url?: string, timeoutMs?: number, temperature?: number, maxTokens?: number, fallbackModel?: string }} [opts]
+ * @returns {string} непорожній контент відповіді
+ * @throws на curl-помилці, не-200 exit, поганому JSON чи порожньому контенті
+ */
+export function callOmlx(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 ?? DEFAULT_OMLX_MODEL
+  } = opts
+
+  const m = omlxModelId(model) || fallbackModel
+  const body = JSON.stringify({ model: m, messages, max_tokens: maxTokens, temperature })
+
+  const TRANSIENT_CURL_CODES = new Set([18, 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', '--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}`)
+      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})`)
+        continue
+      }
+      throw new Error(`omlx curl exit ${r.status}: ${r.stderr?.slice(0, 300) ?? ''}`)
+    }
+    let j
+    try {
+      j = JSON.parse(r.stdout)
+    } catch {
+      throw new Error(`omlx bad json: ${r.stdout?.slice(0, 200) ?? ''}`)
+    }
+    if (j.error) throw new Error(`omlx api: ${JSON.stringify(j.error).slice(0, 300)}`)
+    const content = j.choices?.[0]?.message?.content?.trim() ?? ''
+    if (!content) {
+      const finish = j.choices?.[0]?.finish_reason
+      throw new Error(`omlx empty content (finish=${finish})`)
+    }
+    return content
+  }
+  throw lastErr ?? new Error('omlx unknown failure')
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "5.0.2",
+  "version": "5.1.0",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",

package/rules/abie/lib/docs/hc-yaml.md

@@ -2,25 +2,25 @@
 
 ## Огляд
 
-Файл виконує структурну валідацію конфігураційного файлу `hc.yaml` для перевірки відповідності даних визначенню політики перевірки стану. Валідація здійснюється порівнянням даних з контрактом `HealthCheckPolicy`, який визначений у рего-файлі. Ця функція забезпечує перевірку відповідно до схеми, визначеної за посиланням https://datreeio.github.io/CRDs-catalog/networking.gke.io/healthcheckpolicy_v1.json. Використовується константа ABIE_HC_SCHEMA_URL, яка позначає цей URL. Результат валідації повертається у форматі булевого значення або null.
+Файл виконує структурну валідацію конфігурації `modeline` у файлах `hc.yaml`. Функція `validateAbieHcModeline` перевіряє відповідність конфігурації визначеному контракту. Валідація проводиться порівнянням конфігурації з визначеною схемою, доступною за посиланням https://datreeio.github.io/CRDs-catalog/networking.gke.io/healthcheckpolicy_v1.json. Цей процес забезпечує коректність конфігурації для ідентифікації (abie.mdc). Експортована константа ABIE_HC_SCHEMA_URL використовується для посилання на цю схему.
 
 ## Поведінка
 
-validateAbieHcModeline перевіряє modeline у вхідному контенті.
+validateAbieHcModeline перевіряє modeline у файлі `hc.yaml`.
 
-Перевіряє, чи перший рядок не порожній. Якщо рядок порожній, повертає повідомлення про необхідність формату modeline (abie.mdc).
+Перевіряє, чи перший рядок не порожній. Повертає повідомлення про необхідність наявності modeline `# yaml-language-server: $schema=… (abie.mdc)`.
 
-Перевіряє наявність modeline у першому рядку. Якщо modeline відсутній, повертає повідомлення про необхідність формату modeline (abie.mdc).
+Перевіряє, чи перший рядок містить необхідний modeline. Повертає повідомлення про відсутність modeline $schema (abie.mdc).
 
-Перевіряє, чи значення $schema відповідає очікуваному URL. Якщо значення не відповідає, повертає повідомлення про необхідність використання URL https://datreeio.github.io/CRDs-catalog/networking.gke.io/healthcheckpolicy_v1.json (abie.mdc).
+Перевіряє, чи значення $schema відповідає очікуваному URL. Повертає повідомлення про неправильне значення $schema, включаючи необхідний URL: https://datreeio.github.io/CRDs-catalog/networking.gke.io/healthcheckpolicy_v1.json (abie.mdc).
 
 Повертає null у разі успішної валідації.
 
 ## Публічний API
 
-ABIE_HC_SCHEMA_URL — Вказує на необхідний URL `$schema` для файлу `hc.yaml` (abie.mdc).
+ABIE_HC_SCHEMA_URL — Зберігає референтний URL `$schema` для файлу `hc.yaml` (abie.mdc).
 
-validateAbieHcModeline — Перевіряє синтаксис modeline (`# yaml-language-server: $schema=...`) у файлі `hc.yaml`.
+validateAbieHcModeline — Перевіряє формат modeline (`# yaml-language-server: $schema=...`) у файлі `hc.yaml`.
 
 ## Гарантії поведінки
 

package/rules/abie/lib/docs/http-route.md

@@ -2,31 +2,23 @@
 
 ## Огляд
 
-Файл надає інструмент для порівняльного аналізу конфігурації. Він використовується для підрахунку кількості посилань на спільні бекенди в базових маніфестах пакета. Ця інформація слугує для синхронізації кількості патчів у потоковому (overlay) прошарку з кількістю базових посилань.
+Файл надає інструмент для порівняльного аналізу конфігурації HTTP-маршрутів. Він виконує порівняння кількості `backendRefs` для сервісів `auth-run-hl` та `file-link-hl` у базових маніфестах пакета з кількістю патчів, визначеною в оверлеях. Цей механізм використовується для синхронізації кількості патчів у верхньому рівні з фактичною кількістю посилань у базі. (abie.mdc)
 
 ## Поведінка
 
-ABIE_SHARED_CROSS_NS_BACKEND_NAMES визначає список спільних сервісів, які підлягають аналітиці.
+ABIE_SHARED_CROSS_NS_BACKEND_NAMES
+Визначає список спільних сервісів, які підлягають аналітиці.
 
-ABIE_SHARED_CROSS_NS_BACKEND_SET створює множину спільних сервісів для швидкої перевірки.
-
-checkSharedBackendRef перевіряє, чи посилається елемент на спільний сервіс, і перевіряє, чи відповідає його імена та namespace вимогам.
-
-httpRouteDocSharedCrossNsBackendStats збирає кількість посилань на спільні бекенди та фіксує помилки, якщо виявлено порушення вимог до namespace.
-
-analyzeAbieSharedBackendRefsInPackageK8s збирає статистику щодо посилань на спільні бекенди та помилки щодо namespace з базових YAML-документів пакета, виключаючи оверлей `ua`.
+analyzeAbieSharedBackendRefsInPackageK8s
+Збирає кількість посилань на спільні бекенди та порушення вимог до namespace у базових документах HTTPRoute пакета.
 
 ## Публічний API
 
-- ABIE_SHARED_CROSS_NS_BACKEND_NAMES — Ідентифікація назв бекендів, спільних між різними просторами імен.
-- analyzeAbieSharedBackendRefsInPackageK8s — Аналізує YAML-файли пакета, збираючи кількість спільних посилань на бекенди та виявляючи базові помилки.
+ABIE_SHARED_CROSS_NS_BACKEND_NAMES — Формує імена для крос-нішових зв'язків між бекендами. (abie.mdc)
+
+analyzeAbieSharedBackendRefsInPackageK8s — Збирає кількість спільних посилань `backendRefs` та базові помилки з YAML-файлів пакета, ігноруючи неймспейс `dev`. (abie.mdc)
 
 ## Гарантії поведінки
 
-*   Функція повертає підрахунок `backendRefs` для спільних сервісів.
-*   Підрахунок здійснюється у base-маніфестах пакета поза overlay `ua`.
-*   Використовується `ua_http_route_concern` для синхронізації кількості patch-ів namespace у overlay із кількістю base-reference.
-*   Функція є read-only.
-*   Функція не виконує операцій з мережею.
-*   Функція не використовує кешування.
-*   Функція не змінює стан системи.
+- Read-only: файл не виконує операцій запису у файлову систему.
+- Не звертається до мережі.

package/scripts/coverage-classify/index.mjs

@@ -3,14 +3,19 @@
  *
  * Routing:
  *   1. Cache lookup → hit → використати збережений verdict.
- *   2. Cache miss → Tier 1 (LOCAL_MIN через pi) → parseVerdict.
- *   3. Tier 1 fail (pi error / bad JSON / Zod) → Tier 2 (CLOUD_MIN через pi).
+ *   2. Cache miss → Tier 1 (resolveModel('min')) → parseVerdict.
+ *   3. Tier 1 fail (model error / bad JSON / Zod) → Tier 2 (CLOUD_MIN через pi).
  *   4. Tier 2 fail → conservative fallback worth-testing/confidence=0.
+ *
+ * Бекенд обирається за model-id: `omlx/...` → прямий HTTP до omlx (локально),
+ * решта → pi CLI. Якщо omlx-Tier 1 недоступний, помилка падає в той самий catch
+ * і класифікація відкочується на хмарний Tier 2 через pi.
  */
 import { spawnSync } from 'node:child_process'
 import { join } from 'node:path'
 
 import { CLOUD_MIN, resolveModel } from '../../lib/models.mjs'
+import { callOmlx, isOmlxModel } from '../../lib/omlx.mjs'
 import { deriveCacheKey, readCache, writeCache } from './cache.mjs'
 import { buildUserPrompt, SYSTEM_PROMPT } from './prompt.mjs'
 import { parseVerdict } from './verdict-schema.mjs'
@@ -22,13 +27,17 @@ const FALLBACK_VERDICT = {
 }
 
 /**
- * Викликає pi і повертає raw stdout.
+ * Викликає LLM за model-id і повертає raw текст відповіді.
+ * `omlx/...` → прямий HTTP до omlx (text-only); решта → pi CLI.
  * @param {string} prompt текст промпта
- * @param {string} model  provider/model-id або '' для pi-дефолту
- * @returns {string} stdout pi-процесу
- * @throws якщо pi не знайдено або повертає ненульовий exit code
+ * @param {string} model  provider/model-id, `omlx/...` або '' для pi-дефолту
+ * @returns {string} текст відповіді моделі
+ * @throws якщо backend недоступний або повертає помилку
  */
-function callPi(prompt, model) {
+function callModel(prompt, model) {
+  if (isOmlxModel(model)) {
+    return callOmlx([{ role: 'user', content: prompt }], model, { timeoutMs: 60_000 })
+  }
   const modelArgs = model ? ['--model', model] : []
   const r = spawnSync('pi', ['-p', prompt, ...modelArgs, '--no-session', '--mode', 'text', '--no-tools'], {
     encoding: 'utf8',
@@ -44,21 +53,21 @@ function callPi(prompt, model) {
  * @param {{file: string, mutants: object[]}} group група мутантів одного файлу
  * @param {object} mutant конкретний мутант
  * @param {string} cwd корінь проєкту
- * @param {(prompt: string, model: string) => string} callPiFn  ін'єкція для тестів
+ * @param {(prompt: string, model: string) => string} callModelFn  ін'єкція для тестів
  * @returns {object} verdict класифікації
  */
-function classifyOne(group, mutant, cwd, callPiFn) {
+function classifyOne(group, mutant, cwd, callModelFn) {
   const prompt = `${SYSTEM_PROMPT}\n\n${buildUserPrompt({ ...mutant, file: group.file }, cwd)}`
   const loc = `${group.file}:${mutant.line}:${mutant.col}`
 
   // Tier 1: resolveModel('min') — каскад local→cloud якщо локалі нема
   try {
-    const text = callPiFn(prompt, resolveModel('min'))
+    const text = callModelFn(prompt, resolveModel('min'))
     return parseVerdict(text)
   } catch {
     // Tier 2: CLOUD_MIN
     try {
-      const text = callPiFn(prompt, CLOUD_MIN)
+      const text = callModelFn(prompt, CLOUD_MIN)
       return parseVerdict(text)
     } catch (error) {
       console.warn(`⚠ coverage classify: ${loc} both tiers failed: ${error.message}`)
@@ -68,15 +77,15 @@ function classifyOne(group, mutant, cwd, callPiFn) {
 }
 
 /**
- * Класифікує survived мутантів через pi (LOCAL_MIN → CLOUD_MIN → fallback).
+ * Класифікує survived мутантів (resolveModel('min') → CLOUD_MIN → fallback).
  * @param {Array<{file: string, mutants: object[], exampleTest?: object|null, recommendationText?: string|null}>} survived список вцілілих мутантів
  * @param {string} cwd корінь проєкту
- * @param {{cachePath?: string, callPi?: Function}} [opts] ін'єкції для тестів
+ * @param {{cachePath?: string, callModel?: Function}} [opts] ін'єкції для тестів
  * @returns {Promise<Array<{key: string, verdict: object}>>} verdicts
  */
 export function classify(survived, cwd, opts = {}) {
   const cachePath = opts.cachePath ?? join(cwd, 'npm/reports/coverage-classify.cache.json')
-  const callPiFn = opts.callPi ?? callPi
+  const callModelFn = opts.callModel ?? callModel
   const cacheModel = `${resolveModel('min') || 'default'}+${CLOUD_MIN || 'cloud'}`
 
   const cache = readCache(cachePath)
@@ -102,7 +111,7 @@ export function classify(survived, cwd, opts = {}) {
         }
       }
       if (!verdict) {
-        verdict = classifyOne(group, mutant, cwd, callPiFn)
+        verdict = classifyOne(group, mutant, cwd, callModelFn)
         if (cacheKey) {
           cache.entries[cacheKey] = { ...verdict, classifiedAt: new Date().toISOString() }
         }

package/skills/docgen/js/docgen-compare-pi-vs-direct.mjs

@@ -0,0 +1,95 @@
+/**
+ * A/B: docgen Tier 1 через pi cli (з omlx-провайдером у ~/.pi/agent/models.json)
+ * vs прямий callOmlxMessages (`N_CURSOR_DOCGEN_BACKEND=omlx`).
+ *
+ * Однаковий 8-сет файлів, однаковий оркестратор (E1+E2+E3+E4), різний backend.
+ * Пише в /tmp/docgen-compare/{pi,direct}/<idx>-<stem>.md і збирає метрики.
+ *
+ * Запуск: node npm/skills/docgen/js/docgen-compare-pi-vs-direct.mjs [--from N] [--limit N]
+ */
+import { readFileSync, mkdirSync, writeFileSync, existsSync } from 'node:fs'
+import { join, resolve, basename } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { execSync } from 'node:child_process'
+import { env } from 'node:process'
+import { generateDoc } from './docgen-gen.mjs'
+import { extractFacts } from './docgen-extract.mjs'
+
+const ROOT = resolve(fileURLToPath(import.meta.url), '../../../../..')
+const TMP = '/tmp/docgen-compare'
+
+const args = process.argv.slice(2)
+const limitIdx = args.indexOf('--limit')
+const limit = limitIdx !== -1 ? Number(args[limitIdx + 1]) : 8
+const fromIdx = args.indexOf('--from')
+const from = fromIdx !== -1 ? Number(args[fromIdx + 1]) : 1
+
+const scanOut = execSync('node npm/bin/n-cursor.js docgen scan', { cwd: ROOT, encoding: 'utf8' })
+const all = JSON.parse(scanOut)
+
+const local = []
+for (const f of all) {
+  try {
+    const src = readFileSync(join(ROOT, f.sourcePath), 'utf8')
+    const facts = extractFacts(src, join(ROOT, f.sourcePath))
+    const sym = (facts.internalSymbols ?? []).length
+    if (sym < 4) local.push({ ...f, sym })
+  } catch {}
+}
+const slice = local.slice(from, from + limit)
+
+mkdirSync(join(TMP, 'pi'), { recursive: true })
+mkdirSync(join(TMP, 'direct'), { recursive: true })
+
+async function runBackendAsync(kind) {
+  if (kind === 'direct') env.N_CURSOR_DOCGEN_BACKEND = 'omlx'
+  else delete env.N_CURSOR_DOCGEN_BACKEND
+  const out = { ok: 0, err: 0, totalMs: 0, scores: [], lengths: [], errors: [], times: [] }
+  console.log(`\n══════ Backend: ${kind} ══════`)
+  for (let i = 0; i < slice.length; i++) {
+    const f = slice[i]
+    const t0 = Date.now()
+    const stem = basename(f.sourcePath).replace(/\.[^.]+$/, '')
+    const destFile = join(TMP, kind, `${String(i + 1).padStart(2, '0')}-${stem}.md`)
+    process.stdout.write(`  [${i + 1}/${slice.length}] sym=${f.sym} ${f.sourcePath} ... `)
+    try {
+      const r = await generateDoc(join(ROOT, f.sourcePath), { symThreshold: 999, cloudModel: null })
+      writeFileSync(destFile, r.md)
+      const ms = Date.now() - t0
+      out.ok++
+      out.totalMs += ms
+      out.times.push(ms)
+      out.scores.push(r.score ?? 0)
+      out.lengths.push(r.md.length)
+      process.stdout.write(`✓ ${Math.round(ms / 1000)}s score=${r.score ?? '?'} chars=${r.md.length}\n`)
+    } catch (error) {
+      out.err++
+      out.errors.push({ path: f.sourcePath, msg: error.message })
+      process.stdout.write(`✗ ${error.message}\n`)
+    }
+  }
+  return out
+}
+
+const direct = await runBackendAsync('direct')
+const pi = await runBackendAsync('pi')
+
+function avg(a) { return a.length ? Math.round(a.reduce((x, y) => x + y, 0) / a.length) : 0 }
+function median(a) {
+  if (!a.length) return 0
+  const s = a.toSorted((x, y) => x - y)
+  return s[Math.floor(s.length / 2)]
+}
+
+const report = {
+  files: slice.map(f => f.sourcePath),
+  direct: { ok: direct.ok, err: direct.err, avgMs: avg(direct.times), medianMs: median(direct.times), avgScore: avg(direct.scores), avgChars: avg(direct.lengths), totalSec: Math.round(direct.totalMs / 1000) },
+  pi: { ok: pi.ok, err: pi.err, avgMs: avg(pi.times), medianMs: median(pi.times), avgScore: avg(pi.scores), avgChars: avg(pi.lengths), totalSec: Math.round(pi.totalMs / 1000) }
+}
+writeFileSync(join(TMP, 'report.json'), JSON.stringify(report, null, 2))
+
+console.log(`\n${'─'.repeat(60)}\nA/B SUMMARY (${slice.length} файлів, той самий оркестратор)\n${'─'.repeat(60)}`)
+console.log(`Backend        | ok | err | avg s | median s | avg score | avg chars | total s`)
+console.log(`direct (curl)  | ${direct.ok}  | ${direct.err}   | ${Math.round(report.direct.avgMs / 1000)}    | ${Math.round(report.direct.medianMs / 1000)}        | ${report.direct.avgScore}        | ${report.direct.avgChars}      | ${report.direct.totalSec}`)
+console.log(`pi cli         | ${pi.ok}  | ${pi.err}   | ${Math.round(report.pi.avgMs / 1000)}    | ${Math.round(report.pi.medianMs / 1000)}        | ${report.pi.avgScore}        | ${report.pi.avgChars}      | ${report.pi.totalSec}`)
+console.log(`\nФайли: ${TMP}/{direct,pi}/<idx>-<stem>.md\nReport: ${TMP}/report.json`)

package/skills/docgen/js/docgen-extract-anchors.mjs

@@ -46,7 +46,7 @@ function uniq(arr) {
  * }}
  */
 export function extractAnchors(src) {
-  const urls = uniq([...src.matchAll(URL_RE)].map(m => m[0]))
+  const urls = uniq(Array.from(src.matchAll(URL_RE), m => m[0]))
 
   const magicStrings = []
   const seenNames = new Set()
@@ -59,12 +59,12 @@ export function extractAnchors(src) {
     }
   }
 
-  const errorMarkers = uniq([...src.matchAll(ERROR_MARKER_RE)].map(m => m[1]))
-  const configRefs = uniq([...src.matchAll(CONFIG_REF_RE)].map(m => m[1]))
+  const errorMarkers = uniq(Array.from(src.matchAll(ERROR_MARKER_RE), m => m[1]))
+  const configRefs = uniq(Array.from(src.matchAll(CONFIG_REF_RE), m => m[1]))
 
   // Витягуємо code-block приклади тільки з file-header — там автор зазвичай показує контракт.
   const headerMatch = src.match(FILE_HEADER_RE)
-  const examples = headerMatch ? uniq([...headerMatch[1].matchAll(CODE_BLOCK_RE)].map(m => m[1].trim())) : []
+  const examples = headerMatch ? uniq(Array.from(headerMatch[1].matchAll(CODE_BLOCK_RE), m => m[1].trim())) : []
 
   return { urls, magicStrings, errorMarkers, configRefs, examples }
 }

package/skills/docgen/js/docgen-gen.mjs

@@ -4,6 +4,7 @@ import { basename } from 'node:path'
 import { spawnSync } from 'node:child_process'
 import { env } from 'node:process'
 import { resolveModel } from '../../../lib/models.mjs'
+import { callOmlx } from '../../../lib/omlx.mjs'
 import { extractFacts } from './docgen-extract.mjs'
 import { extractAnchors } from './docgen-extract-anchors.mjs'
 import { oneShotMessages, sectionMessages, criticMessages, refineMessages, guaranteesFromMarkers } from './docgen-prompts.mjs'
@@ -92,50 +93,16 @@ function scoreDoc(md, facts) {
 
 /**
  * omlx-бекенд: справжні OpenAI-сумісні messages (system+user збереженi).
- * Вмикається `N_CURSOR_DOCGEN_BACKEND=omlx`.
- * URL: `N_CURSOR_DOCGEN_OMLX_URL` або http://127.0.0.1:8000/v1/chat/completions.
- * Модель: переданий `model`, потім `N_CURSOR_DOCGEN_OMLX_MODEL`, потім дефолт.
+ * Вмикається `N_CURSOR_DOCGEN_BACKEND=omlx`. Делегує у спільний `callOmlx`
+ * (npm/lib/omlx.mjs) з docgen-специфічними env-дефолтами URL/моделі.
  */
 function callOmlxMessages(messages, model, timeoutMs, temperature = 0.2) {
-  const url = env.N_CURSOR_DOCGEN_OMLX_URL ?? 'http://127.0.0.1:8000/v1/chat/completions'
-  const m = model || env.N_CURSOR_DOCGEN_OMLX_MODEL || 'mlx-community--gemma-4-e2b-it-4bit'
-  const body = JSON.stringify({
-    model: m,
-    messages,
-    max_tokens: 4096,
-    temperature
+  return callOmlx(messages, model, {
+    url: env.N_CURSOR_DOCGEN_OMLX_URL,
+    timeoutMs,
+    temperature,
+    fallbackModel: env.N_CURSOR_DOCGEN_OMLX_MODEL
   })
-  // Ретраїмо лише transient curl-помилки (18 = transfer closed, 56 = recv failure, 52 = empty reply).
-  const TRANSIENT_CURL_CODES = new Set([18, 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', '--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}`)
-      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})`)
-        continue
-      }
-      throw new Error(`omlx curl exit ${r.status}: ${r.stderr?.slice(0, 300) ?? ''}`)
-    }
-    let j
-    try { j = JSON.parse(r.stdout) } catch { throw new Error(`omlx bad json: ${r.stdout?.slice(0, 200) ?? ''}`) }
-    if (j.error) throw new Error(`omlx api: ${JSON.stringify(j.error).slice(0, 300)}`)
-    const content = j.choices?.[0]?.message?.content?.trim() ?? ''
-    if (!content) {
-      const finish = j.choices?.[0]?.finish_reason
-      throw new Error(`omlx empty content (finish=${finish})`)
-    }
-    return content
-  }
-  throw lastErr ?? new Error('omlx unknown failure')
 }
 
 /**

package/skills/fix/js/llm-worker.mjs

@@ -5,6 +5,7 @@ import { join } from 'node:path'
 import { spawnSync } from 'node:child_process'
 import { env } from 'node:process'
 import { resolveModel } from '../../../lib/models.mjs'
+import { callOmlx, isOmlxModel } from '../../../lib/omlx.mjs'
 
 // Тир за замовчуванням: min → avg при ескалації (каскад local→cloud).
 // Перевизначення через N_CURSOR_FIX_MODEL / N_CURSOR_FIX_MODEL_HEAVY.
@@ -86,12 +87,20 @@ function buildPrompt(ruleId, ruleMdc, output, files) {
 }
 
 /**
- * Запускає pi і повертає stdout як рядок.
+ * Викликає LLM за model-id і повертає текст відповіді.
+ * `omlx/...` → прямий HTTP до omlx (text-only, локально); решта → pi CLI.
  * @param {string} prompt текст промпта
- * @param {string} model назва моделі (provider/id)
- * @returns {{ text: string, error?: string }} stdout pi або повідомлення про помилку
+ * @param {string} model назва моделі (provider/id, `omlx/...` або '')
+ * @returns {{ text: string, error?: string }} текст відповіді або повідомлення про помилку
  */
-function callPi(prompt, model) {
+function callModel(prompt, model) {
+  if (isOmlxModel(model)) {
+    try {
+      return { text: callOmlx([{ role: 'user', content: prompt }], model, { timeoutMs: 120_000 }) }
+    } catch (error) {
+      return { text: '', error: error.message }
+    }
+  }
   const modelArgs = model ? ['--model', model] : []
   const r = spawnSync('pi', ['-p', prompt, ...modelArgs, '--no-session', '--mode', 'text', '--no-tools'], {
     encoding: 'utf8',
@@ -117,9 +126,9 @@ function callPi(prompt, model) {
 }
 
 /**
- * Парсить JSON-відповідь від pi.
- * pi може обгорнути JSON у ```json ... ```, тому пробуємо витягти.
- * @param {string} text сирий stdout pi
+ * Парсить JSON-відповідь від моделі.
+ * Модель може обгорнути JSON у ```json ... ```, тому пробуємо витягти.
+ * @param {string} text сирий текст відповіді
  * @returns {{ changes: Array<{path:string,content:string}>, error?: string } | null} розпарсений патч або null
  */
 function parseResponse(text) {
@@ -183,12 +192,12 @@ export function runLlmWorker(ruleId, violationOutput, projectRoot, opts = {}) {
     })
     .filter(Boolean)
 
-  // 3. Будуємо prompt і викликаємо pi
+  // 3. Будуємо prompt і викликаємо модель
   const prompt = buildPrompt(ruleId, ruleMdc, violationOutput, files)
-  const { text, error: piError } = callPi(prompt, model)
+  const { text, error: modelError } = callModel(prompt, model)
 
-  if (piError) return { ok: false, error: piError }
-  if (!text) return { ok: false, error: 'pi returned empty response' }
+  if (modelError) return { ok: false, error: modelError }
+  if (!text) return { ok: false, error: 'model returned empty response' }
 
   // 4. Парсимо відповідь
   const parsed = parseResponse(text)