@nitra/cursor 5.2.1 → 5.3.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [5.3.0] - 2026-06-11
+
+### Added
+
+- js-lint: нові JS-файли створюються з явним розширенням .mjs/.cjs (не .js); приклади нового вихідного коду в js-run/js-bun-db/vue переведено на .mjs. test: підтримка vitest.config.mjs — pool-forks і stryker_config приймають .mjs/.js (новий канон .mjs, legacy .js не дублюється), stryker.configFile приводиться до фактичного імені. style-lint: чекер розпізнає stylelint.config.mjs/.cjs та .stylelintrc.mjs/.cjs.
+- llm wire-trace: always-on багатий JSONL-запис на кожен `callLlm` (обидва канали — reasoning + слід) у `<cwd>/.n-cursor/llm-trace.jsonl` (gitignored, недеструктивна ротація 50 MB, kill-switch `N_CURSOR_LLM_TRACE=0`); `callOmlxRaw` дістає reasoning_content/usage/finish_reason/attempts (`callOmlx` лишається `string`-обгорткою); `fix`+`coverage-classify` мігровано з прямого `callOmlx`/`pi`-spawn на спільний `callLlm` (caller-мітка). Спека: docs/specs/2026-06-10-omlx-wire-trace-capture-design.md
+
 ## [5.2.1] - 2026-06-11
 
 ### Changed

package/lib/llm.mjs

@@ -7,15 +7,16 @@
  *
  * Жодних env-перемикачів бекенда: рядок моделі сам визначає транспорт.
  *
- * Wire-trace (ADR 260610-1516/1524): якщо виставлено `N_CURSOR_LLM_TRACE=<file>`,
- * кожен виклик append-ить один JSONL-рядок з бекендом, моделлю, тривалістю і
- * розмірами prompt/output. Трейс fail-safe: помилка запису не ламає виклик.
+ * Wire-trace (спека 2026-06-10-omlx-wire-trace-capture-design): **always-on**
+ * багатий JSONL-запис на кожен виклик — обидва канали (reasoning + слід). Для
+ * omlx захоплює content/reasoning/usage/finish_reason/attempts; для pi — лише
+ * те, що CLI дає (rich-поля null). Деталі запису/шляху/ротації — `omlx-trace.mjs`.
  */
 import { spawnSync } from 'node:child_process'
-import { appendFileSync } from 'node:fs'
 import { env } from 'node:process'
 
-import { callOmlx, isOmlxModel } from './omlx.mjs'
+import { callOmlxRaw, isOmlxModel } from './omlx.mjs'
+import { buildTraceRecord, writeTrace } from './omlx-trace.mjs'
 
 /** Дефолтний timeout одного виклику (узгоджено з LOCAL_TIMEOUT доки-конвеєра). */
 const DEFAULT_TIMEOUT_MS = 120_000
@@ -29,20 +30,6 @@ export function pickBackend(model) {
   return isOmlxModel(model) ? 'omlx' : 'pi'
 }
 
-/**
- * Fail-safe append JSONL-рядка трейсу у файл з `N_CURSOR_LLM_TRACE`.
- * @param {object} entry один запис трейсу
- */
-function trace(entry) {
-  const file = env.N_CURSOR_LLM_TRACE
-  if (!file) return
-  try {
-    appendFileSync(file, JSON.stringify(entry) + '\n')
-  } catch {
-    // трейс не має ламати основний виклик
-  }
-}
-
 /**
  * Виклик через `pi` CLI: messages конкатенуються у plain prompt
  * (pi не приймає messages-масив), tools вимкнено.
@@ -64,42 +51,68 @@ function callPi(messages, model, timeoutMs) {
 }
 
 /**
- * Універсальний LLM-виклик з маршрутизацією за префіксом model-id.
+ * Універсальний LLM-виклик з маршрутизацією за префіксом model-id і always-on
+ * wire-trace (обидва канали).
  * @param {Array<{role:string, content:string}>} messages OpenAI-style messages (system зберігається на omlx)
  * @param {string} model model-id; `omlx/<m>` → прямий HTTP, інакше → pi CLI
- * @param {{ timeoutMs?: number, temperature?: number, maxTokens?: number, url?: string }} [opts] timeout, температура, ліміт виходу, override URL
+ * @param {{ timeoutMs?: number, temperature?: number, maxTokens?: number, url?: string, caller?: string }} [opts] timeout, температура, ліміт виходу, override URL, мітка викликача для trace
  * @returns {string} текст відповіді (непорожній на omlx; pi може повернути '')
  */
 export function callLlm(messages, model, opts = {}) {
-  const { timeoutMs = DEFAULT_TIMEOUT_MS, temperature = 0.2, maxTokens, url } = opts
+  const { timeoutMs = DEFAULT_TIMEOUT_MS, temperature = 0.2, maxTokens, url, caller } = opts
   const backend = pickBackend(model)
+  const resolvedCaller = caller ?? env.N_CURSOR_TRACE_CALLER ?? 'unknown'
   const t0 = Date.now()
-  const promptChars = messages.reduce((n, m) => n + (m.content?.length ?? 0), 0)
   try {
-    const out =
-      backend === 'omlx'
-        ? callOmlx(messages, model, { url, timeoutMs, temperature, ...(maxTokens ? { maxTokens } : {}) })
-        : callPi(messages, model, timeoutMs)
-    trace({
-      ts: new Date().toISOString(),
-      backend,
-      model,
-      ms: Date.now() - t0,
-      promptChars,
-      outChars: out.length,
-      ok: true
-    })
-    return out
+    let content
+    let reasoning = null
+    let reasoningSource = null
+    let finishReason = null
+    let usage = null
+    let attempts = 1
+    if (backend === 'omlx') {
+      const raw = callOmlxRaw(messages, model, { url, timeoutMs, temperature, ...(maxTokens ? { maxTokens } : {}) })
+      ;({ content, reasoning, reasoningSource, finishReason, usage, attempts } = raw)
+    } else {
+      content = callPi(messages, model, timeoutMs)
+    }
+    writeTrace(
+      buildTraceRecord({
+        ts: new Date().toISOString(),
+        caller: resolvedCaller,
+        backend,
+        model,
+        temperature,
+        maxTokens,
+        messages,
+        content,
+        reasoning,
+        reasoningSource,
+        finishReason,
+        usage,
+        ms: Date.now() - t0,
+        attempts,
+        ok: true,
+        error: null
+      })
+    )
+    return content
   } catch (error) {
-    trace({
-      ts: new Date().toISOString(),
-      backend,
-      model,
-      ms: Date.now() - t0,
-      promptChars,
-      ok: false,
-      error: String(error.message).slice(0, 200)
-    })
+    writeTrace(
+      buildTraceRecord({
+        ts: new Date().toISOString(),
+        caller: resolvedCaller,
+        backend,
+        model,
+        temperature,
+        maxTokens,
+        messages,
+        ms: Date.now() - t0,
+        attempts: null,
+        ok: false,
+        error: String(error.message).slice(0, 200)
+      })
+    )
     throw error
   }
 }
@@ -124,7 +137,7 @@ const AUTH_ERROR_MARKER = 'authentication_error'
 export function omlxHealthCheck(opts = {}) {
   const { url, model = '', timeoutMs = DEFAULT_TIMEOUT_MS } = opts
   try {
-    callOmlx([{ role: 'user', content: 'ok' }], model, { url, timeoutMs, maxTokens: 1, temperature: 0 })
+    callOmlxRaw([{ role: 'user', content: 'ok' }], model, { url, timeoutMs, maxTokens: 1, temperature: 0 })
     return { ok: true, reason: null, detail: '' }
   } catch (error) {
     const detail = String(error.message)

package/lib/omlx-trace.mjs

@@ -0,0 +1,158 @@
+/**
+ * Wire-trace LLM-викликів: будує й пише багатий JSONL-запис на кожен виклик
+ * `callLlm` (див. `npm/lib/llm.mjs`). Захоплює **обидва канали** — reasoning
+ * (думки моделі) і спостережуваний слід (request/response/usage/latency/retry).
+ *
+ * Дизайн-спека: `docs/specs/2026-06-10-omlx-wire-trace-capture-design.md`.
+ *
+ * Двошарова модель:
+ *   - RAW (цей модуль) → `<cwd>/.n-cursor/llm-trace.jsonl` (gitignored, локальний,
+ *     недеструктивна ротація) — сирий потік, доживає до батч-агрегації.
+ *   - AGGREGATE (друга спека) → `docs/omlx-insights/` (коммітиться в git, назавжди).
+ *
+ * Always-on: пишеться завжди. `N_CURSOR_LLM_TRACE=0|false|off|no` — kill-switch;
+ * будь-яке інше значення — override-шлях замість дефолтного.
+ */
+import { appendFileSync, existsSync, mkdirSync, renameSync, statSync } from 'node:fs'
+import { createHash } from 'node:crypto'
+import { dirname, join } from 'node:path'
+import { cwd, env } from 'node:process'
+
+/** Ліміт символів на одне `message.content` у записі (захист обсягу/чутливості). */
+export const MAX_MSG_CHARS = 8000
+
+/** Поріг недеструктивної ротації активного файлу (байти). */
+export const ROTATE_BYTES = 50 * 1024 * 1024
+
+/** Значення `N_CURSOR_LLM_TRACE`, що вимикають трасування повністю. */
+const KILL_VALUES = new Set(['0', 'false', 'off', 'no'])
+
+/**
+ * Шлях активного trace-файлу або `null`, якщо трасування вимкнено kill-switch-ем.
+ * Пріоритет: `N_CURSOR_LLM_TRACE` (kill-switch → null; інакше явний шлях) →
+ * дефолт `<cwd>/.n-cursor/llm-trace.jsonl` (корінь споживацького проєкту).
+ * @returns {string|null} абсолютний/відносний шлях до .jsonl або null
+ */
+export function tracePath() {
+  const override = env.N_CURSOR_LLM_TRACE
+  if (override !== undefined) {
+    if (KILL_VALUES.has(override.toLowerCase())) return null
+    if (override) return override
+  }
+  return join(cwd(), '.n-cursor', 'llm-trace.jsonl')
+}
+
+/**
+ * Обрізає кожне `message.content` до `MAX_MSG_CHARS` і рахує sha256 повного
+ * (необрізаного) масиву для дедуплікації.
+ * @param {Array<{role:string, content:string}>} messages вихідні messages
+ * @returns {{ messages: Array<{role:string, content:string}>, messages_sha256: string, messages_truncated: boolean }} обрізані messages, hash і прапор обрізки
+ */
+export function capMessages(messages) {
+  const src = messages ?? []
+  let truncated = false
+  const capped = src.map(m => {
+    const content = m?.content ?? ''
+    if (content.length > MAX_MSG_CHARS) {
+      truncated = true
+      return { role: m.role, content: content.slice(0, MAX_MSG_CHARS) }
+    }
+    return { role: m?.role, content }
+  })
+  const messages_sha256 = createHash('sha256').update(JSON.stringify(src)).digest('hex')
+  return { messages: capped, messages_sha256, messages_truncated: truncated }
+}
+
+/**
+ * Будує нормалізований trace-запис. Поля, яких backend не дає (pi: reasoning/
+ * usage/finish_reason), лишаються `null` за побудовою.
+ * @param {object} i вхід
+ * @param {string} i.ts ISO-час завершення виклику
+ * @param {string} i.caller хто викликав (doc-files|fix|coverage|unknown)
+ * @param {'omlx'|'pi'} i.backend бекенд
+ * @param {string} i.model model-id
+ * @param {number} [i.temperature] температура
+ * @param {number} [i.maxTokens] ліміт виходу
+ * @param {Array<{role:string, content:string}>} i.messages messages запиту
+ * @param {string|null} [i.content] відповідь
+ * @param {string|null} [i.reasoning] думки моделі
+ * @param {string|null} [i.reasoningSource] джерело reasoning
+ * @param {string|null} [i.finishReason] finish_reason
+ * @param {object|null} [i.usage] usage verbatim
+ * @param {number} i.ms latency
+ * @param {number|null} [i.attempts] кількість спроб
+ * @param {boolean} i.ok успіх
+ * @param {string|null} [i.error] текст помилки
+ * @returns {object} JSONL-готовий запис
+ */
+export function buildTraceRecord(i) {
+  const capped = capMessages(i.messages)
+  return {
+    ts: i.ts,
+    caller: i.caller,
+    backend: i.backend,
+    model: i.model,
+    temperature: i.temperature ?? null,
+    max_tokens: i.maxTokens ?? null,
+    messages: capped.messages,
+    messages_sha256: capped.messages_sha256,
+    messages_truncated: capped.messages_truncated,
+    content: i.content ?? null,
+    reasoning: i.reasoning ?? null,
+    reasoning_source: i.reasoningSource ?? null,
+    finish_reason: i.finishReason ?? null,
+    usage: i.usage ?? null,
+    ms: i.ms,
+    attempts: i.attempts ?? null,
+    ok: i.ok,
+    error: i.error ?? null
+  }
+}
+
+/**
+ * Імʼя архіву для ротації: `llm-trace.jsonl` → `llm-trace.<seq>.jsonl`
+ * (нестандартні імена без `.jsonl` → `<file>.<seq>`).
+ * @param {string} file активний trace-файл
+ * @param {number} seq порядковий номер архіву
+ * @returns {string} шлях архіву
+ */
+function archiveName(file, seq) {
+  return file.endsWith('.jsonl') ? `${file.slice(0, -'.jsonl'.length)}.${seq}.jsonl` : `${file}.${seq}`
+}
+
+/**
+ * Недеструктивна ротація: якщо активний файл перевищує `ROTATE_BYTES`,
+ * перейменовує його в перший вільний `llm-trace.<seq>.jsonl` (без перезапису
+ * наявних архівів). Відсутній файл / помилка stat — no-op.
+ * @param {string} file активний trace-файл
+ */
+export function rotateIfNeeded(file) {
+  let size
+  try {
+    size = statSync(file).size
+  } catch {
+    return // файлу ще нема — нічого ротувати
+  }
+  if (size <= ROTATE_BYTES) return
+  let seq = 1
+  while (existsSync(archiveName(file, seq))) seq++
+  renameSync(file, archiveName(file, seq))
+}
+
+/**
+ * Fail-safe запис одного trace-рядка. Резолвить шлях (kill-switch → no-op),
+ * ротує за потреби, створює теку, append-ить JSONL. Будь-яка помилка IO
+ * ковтається — трасування **ніколи** не ламає основний виклик.
+ * @param {object} record запис від `buildTraceRecord`
+ */
+export function writeTrace(record) {
+  const file = tracePath()
+  if (!file) return
+  try {
+    rotateIfNeeded(file)
+    mkdirSync(dirname(file), { recursive: true })
+    appendFileSync(file, JSON.stringify(record) + '\n')
+  } catch {
+    // трейс не має ламати основний виклик
+  }
+}

package/lib/omlx.mjs

@@ -70,16 +70,42 @@ export function omlxModelId(model) {
 }
 
 /**
- * Прямий HTTP-виклик до omlx через `curl` (spawnSync). Повертає текст
- * `choices[0].message.content`. Ретраїть лише transient curl-помилки
- * (18 = transfer closed, 52 = empty reply, 56 = recv failure).
+ * Витягує 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 }} текст думок і його джерело
+ */
+const THINK_TAG_RE = /<think>([\s\S]*?)<\/think>/
+
+/**
+ *
+ */
+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 }
+}
+
+/**
+ * Ядро прямого HTTP-виклику до omlx через `curl` (spawnSync). Повертає **багатий**
+ * обʼєкт: контент + reasoning + usage + finish_reason + кількість спроб. Ретраїть
+ * лише 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, apiKey?: string }} [opts] URL, timeout, температура, ліміт виходу, fallback-модель, API-ключ
- * @returns {string} непорожній контент відповіді
+ * @returns {{ content:string, reasoning:string|null, reasoningSource:string|null, finishReason:string|null, usage:object|null, attempts:number }} багатий результат виклику
  * @throws на curl-помилці, не-200 exit, поганому JSON чи порожньому контенті
  */
-export function callOmlx(messages, model, opts = {}) {
+export function callOmlxRaw(messages, model, opts = {}) {
   const {
     url = env.N_CURSOR_OMLX_URL ?? DEFAULT_OMLX_URL,
     timeoutMs = 60_000,
@@ -136,12 +162,24 @@ export function callOmlx(messages, model, opts = {}) {
       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
+    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 }
   }
   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/package.json

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

package/rules/js-bun-db/js-bun-db.mdc

@@ -2,7 +2,7 @@
 description: Використання pg / mysql2 / Bun SQL у Node.js та Bun
 globs: "**/package.json,**/src/conn/**"
 alwaysApply: false
-version: '1.14'
+version: '1.15'
 ---
 
 ## Підтримувані версії баз даних
@@ -300,10 +300,10 @@ const rows = await sql.unsafe(query, values)
 
 Дефолтний експорт `sql` з `'bun'` сам читає змінні середовища (`DATABASE_URL`, `POSTGRES_URL`, `MYSQL_URL`, `PGHOST`/`PGUSER`/... та `MYSQL_HOST`/`MYSQL_USER`/...) і керує пулом — окремий `Pool` як у `pg` створювати не треба.
 
-Для явного конфігу — `new SQL(...)` як **singleton** на рівні модуля, а не на кожен запит. Файл кладеться у `src/conn/db.js` і експортує іменовані константи `pgWrite` (основний запис) та `pgRead` (read-only replica), щоб glob `**/src/conn/**` у правилах покривав ці файли:
+Для явного конфігу — `new SQL(...)` як **singleton** на рівні модуля, а не на кожен запит. Файл кладеться у `src/conn/db.mjs` і експортує іменовані константи `pgWrite` (основний запис) та `pgRead` (read-only replica), щоб glob `**/src/conn/**` у правилах покривав ці файли:
 
 ```javascript
-// src/conn/db.js
+// src/conn/db.mjs
 import { SQL } from 'bun'
 
 export const pgWrite = new SQL({
@@ -454,16 +454,16 @@ ${pgRead.array(ids, 'int4')}
 
 OXC formatter (oxfmt ≥ 0.49) примусово розгортає будь-який `CallExpression`, де перший аргумент є `CallExpression` з callback, у багаторядковий блок — незалежно від `printWidth`. Тому `pgWrite.array(arr.map(r => r.field), 'type')` всередині tagged template literal завжди стає 4-рядковим блоком. `col(arr, 'field')` (перший аргумент — identifier, другий — string literal) цей тригер не зачіпає і лишається однорядковим.
 
-Канонічне місце хелпера — `src/utils/col.js` (або `src/conn/col.js` залежно від структури проєкту):
+Канонічне місце хелпера — `src/utils/col.mjs` (або `src/conn/col.mjs` залежно від структури проєкту):
 
 ```javascript
-// src/utils/col.js
+// src/utils/col.mjs
 export const col = (arr, key) => arr.map(r => r[key])
 ```
 
 ```javascript
-import { pgWrite } from '#src/conn/db.js'
-import { col } from '#src/utils/col.js'
+import { pgWrite } from '#src/conn/db.mjs'
+import { col } from '#src/utils/col.mjs'
 
 // ❌ oxfmt розгортає на 4+ рядки незалежно від printWidth
 ${pgWrite.array(rows.map(r => r.id), 'int4')}

package/rules/js-lint/js-lint.mdc

@@ -2,7 +2,7 @@
 description: Перевірка JavaScript коду
 globs: "**/{.oxlintrc.json,eslint.config.js,.jscpd.json,knip.json,package.json},**/*.{js,mjs,cjs,jsx,ts,tsx}"
 alwaysApply: false
-version: '1.29'
+version: '1.30'
 ---
 
 **oxlint**, **ESLint**, **jscpd**, **knip**. У скрипті **`lint-js`** і в CI — **`bunx oxlint`**, **`bunx eslint`**, **`bunx jscpd`**, **`bunx knip`** (у CI без **`--fix`** для oxlint/eslint — див. приклад workflow нижче). Без **prettier** і **@nitra/prettier-config**. У **`devDependencies`** має бути **`@nitra/eslint-config`** — версія не нижче канонічного мінімуму зі snippet нижче (semver-поріг, єдине джерело істини) (з **3.8.0** правило `no-restricted-syntax` забороняє `for...in`; з **3.9.2** у `getConfig` вбудовано ignore для **`**/adr/**`** — ADR-документи не валідуються ESLint, локально цей glob додавати не потрібно; також транзитивно йде **`@e18e/eslint-plugin`** для oxlint). Dependency-політику CI-етапу (`@e18e/eslint-plugin` і oxlint/eslint/jscpd/knip окремо не додавати) винесено в `js-lint-ci`.
@@ -23,6 +23,19 @@ version: '1.29'
 
 Канон `type` + `scripts.lint-js` (substring requirement) і мінімальна `@nitra/eslint-config` (semver-поріг `devDependencies`): [package.json.snippet.json](./policy/package_json/template/package.json.snippet.json)
 
+## Розширення нових файлів — `.mjs` / `.cjs`, не `.js`
+
+**Нові** JS-файли створюй з явним розширенням модуля:
+
+- **`.mjs`** — для ESM (типовий випадок);
+- **`.cjs`** — для CommonJS, де він справді потрібен.
+
+Голий **`.js`** для нового файлу **заборонено**. Розширення `.js` інтерпретується як ESM чи CJS лише за полем `package.json#type`, тож той самий файл читається по-різному залежно від пакета. Явне `.mjs`/`.cjs` робить тип модуля однозначним **без читання `package.json`** — навіть якщо `type` зміниться або файл перемістять в інший пакет. Це доповнює вимогу `"type": "module"` вище: `type` лишається каноном для всього дерева, а розширення нового файлу прибирає залежність від нього.
+
+Стосується **backend і frontend** — будь-який новий вихідний файл: `src/`, тести `*.test.*`, `scripts/`, `src/conn/` тощо.
+
+**Існуючі `.js` лишаються як є** — масово перейменовувати не треба; це конвенція для нового коду. Автоматичної перевірки тут немає: stateless-скан не відрізнить новий файл від існуючого, тож `.js` нікого не фейлить.
+
 У `.vscode/extensions.json` `recommendations` мають містити `dbaeumer.vscode-eslint`, `github.vscode-github-actions`, `oxc.oxc-vscode`: [extensions.json.snippet.json](./policy/vscode_extensions/template/extensions.json.snippet.json)
 
 У корені має бути **`.oxlintrc.json`**, який **збігається з каноном** oxlint з пакета **`@nitra/cursor`**: файл **`npm/rules/js-lint/js/data/tooling/oxlint-canonical.json`** (plugins, jsPlugins з **`@e18e/eslint-plugin`**, categories, повний набір **rules** із канону — додаткові записи в **`rules`** дозволені; також **`settings`**, **`env`**, **`globals`**). Поле **`ignorePatterns`** працює як **`rules`**: канонічні патерни з **`oxlint-canonical.json`** (наразі **`**/schema.graphql`**, **`**/auto-imports.d.ts`**) мають бути присутні, додаткові локальні glob-и дозволені. Канон **`oxlint-canonical.json`** — source-of-truth, редагується напряму; у споживачі оновлюється копіюванням файлу з репозиторію пакета. Модуль **`@e18e/eslint-plugin`** не оголошуй окремо в **`package.json`** — він уже в залежностях **`@nitra/eslint-config`** (з **3.8.0**), oxlint підвантажує його з **`node_modules`**.

package/rules/js-run/js-run.mdc

@@ -2,7 +2,7 @@
 description: Це правила для backend проектів на JavaScript/Node.js, сюди входять і job і WEB сервери.
 globs: "**/package.json,**/jsconfig.json,**/src/**/*.{js,mjs,cjs,ts,tsx}"
 alwaysApply: false
-version: '1.11'
+version: '1.12'
 ---
 
 ## Область застосування
@@ -97,7 +97,7 @@ import sql from 'mssql'
 import { GraphQLClient } from '@nitra/graphql-request'
 ```
 
-то ці підключення повинні бути винесені в окремий файл, наприклад `/src/conn/pg.js`, в package.json повинні бути додано аліас:
+то ці підключення повинні бути винесені в окремий файл, наприклад `/src/conn/pg.mjs`, в package.json повинні бути додано аліас:
 
 ```json
 {
@@ -110,7 +110,7 @@ import { GraphQLClient } from '@nitra/graphql-request'
 
 так виглядатиме підключення до PostgreSQL в коді:
 
-```javascript title="Приклад підключення до PostgreSQL в /src/conn/pg.js"
+```javascript title="Приклад підключення до PostgreSQL в /src/conn/pg.mjs"
 import { checkEnv, env } from '@nitra/check-env'
 import { SQL } from 'bun'
 
@@ -140,7 +140,7 @@ export const graphQLClientSmart = new GraphQLClient(env.QL, {
 а в коді повинно бути використано:
 
 ```js
-import { pool } from '#conn/pg.js'
+import { pool } from '#conn/pg.mjs'
 
 // або
 
@@ -152,24 +152,24 @@ import { gql, graphQLClient } from '@nitra/graphql-request'
 Назва файла в `src/conn/` має одразу повідомляти, **до чого** підключаємось і **в якому режимі**:
 
 - **GraphQL** — префікс `ql-`, далі ідентифікатор endpoint:
-  - `src/conn/ql-contract.js`
-  - `src/conn/ql-smart.js`
+  - `src/conn/ql-contract.mjs`
+  - `src/conn/ql-smart.mjs`
 - **PostgreSQL** — префікс `pg-`, далі тип підключення (репліка vs мастер): `read` або `write`:
-  - `src/conn/pg-read.js`
-  - `src/conn/pg-write.js`
+  - `src/conn/pg-read.mjs`
+  - `src/conn/pg-write.mjs`
 - **PostgreSQL до кількох БД** — додатково ідентифікатор підключення після типу:
-  - `src/conn/pg-read-smart.js`
-  - `src/conn/pg-write-contract.js`
-- **MySQL** — префікс `mysql-` за тією ж схемою (`mysql-read.js`, `mysql-write-<id>.js` тощо).
-- **MSSQL** — префікс `mssql-` за тією ж схемою (`mssql-read.js`, `mssql-write-<id>.js` тощо). Хоча npm-пакет один (`mssql`), а драйвер MS SQL Server під капотом T-SQL — у файловій назві відрізняємо MS SQL Server від MySQL, бо це різні СУБД, різні діалекти, різні рантаймні залежності. Якщо проєкт історично використовує `mysql-…` для MSSQL-підключень — він валідний і далі (для backward-compat), але новий код пишемо з префіксом `mssql-`.
+  - `src/conn/pg-read-smart.mjs`
+  - `src/conn/pg-write-contract.mjs`
+- **MySQL** — префікс `mysql-` за тією ж схемою (`mysql-read.mjs`, `mysql-write-<id>.mjs` тощо).
+- **MSSQL** — префікс `mssql-` за тією ж схемою (`mssql-read.mjs`, `mssql-write-<id>.mjs` тощо). Хоча npm-пакет один (`mssql`), а драйвер MS SQL Server під капотом T-SQL — у файловій назві відрізняємо MS SQL Server від MySQL, бо це різні СУБД, різні діалекти, різні рантаймні залежності. Якщо проєкт історично використовує `mysql-…` для MSSQL-підключень — він валідний і далі (для backward-compat), але новий код пишемо з префіксом `mssql-`.
 
-Підключення до БД **обов'язково** має бути ідентифіковано як `read` (репліка) або `write` (мастер). Якщо з імені змінної оточення (наприклад, `env.PG_CONN`) це не очевидно — визнач режим за операціями в коді: якщо немає операцій зміни даних (`INSERT`/`UPDATE`/`DELETE`/DDL) — це `pg-read.js`, інакше `pg-write.js`.
+Підключення до БД **обов'язково** має бути ідентифіковано як `read` (репліка) або `write` (мастер). Якщо з імені змінної оточення (наприклад, `env.PG_CONN`) це не очевидно — визнач режим за операціями в коді: якщо немає операцій зміни даних (`INSERT`/`UPDATE`/`DELETE`/DDL) — це `pg-read.mjs`, інакше `pg-write.mjs`.
 
 ### Експорти у файлах `src/conn/`
 
 У файлах підключень **заборонений** `export default`. Експорт має бути **іменований** і збігатися з назвою файла в camelCase.
 
-Приклад — `src/conn/ql-smart.js`:
+Приклад — `src/conn/ql-smart.mjs`:
 
 ```javascript title="❌ Так не можна"
 export default new GraphQLClient(env.SMART_QL, {
@@ -187,13 +187,13 @@ export const qlSmart = new GraphQLClient(env.SMART_QL, {
 })
 ```
 
-Відповідно: `pg-read.js` → `export const pgRead = …`, `pg-write-contract.js` → `export const pgWriteContract = …`, `ql-contract.js` → `export const qlContract = …`.
+Відповідно: `pg-read.mjs` → `export const pgRead = …`, `pg-write-contract.mjs` → `export const pgWriteContract = …`, `ql-contract.mjs` → `export const qlContract = …`.
 
 ## CheckEnv
 
 Усі змінні оточення, які використовуються в коді, повинні бути перевірені за допомогою `checkEnv` з пакету `@nitra/check-env`. Це гарантує, що всі необхідні змінні оточення встановлені перед запуском програми.
 
-```javascript title="Приклад підключення до PostgreSQL в /src/conn/pg.js"
+```javascript title="Приклад підключення до PostgreSQL в /src/conn/pg.mjs"
 import { checkEnv, env } from '@nitra/check-env'
 import { SQL } from 'bun'
 

package/rules/style-lint/js/tooling.mjs

@@ -5,6 +5,18 @@ import { join } from 'node:path'
 
 import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
 
+// Зовнішні файли конфігу stylelint, які підхоплює cosmiconfig. Канон нових
+// JS-конфігів — `.mjs`/`.cjs` (js-lint.mdc), legacy `.js` лишається валідним.
+const STYLELINT_CONFIG_FILES = [
+  '.stylelintrc.json',
+  '.stylelintrc.js',
+  '.stylelintrc.cjs',
+  '.stylelintrc.mjs',
+  'stylelint.config.js',
+  'stylelint.config.cjs',
+  'stylelint.config.mjs'
+]
+
 /**
  * Альтернатива полю `stylelint` у `package.json` — зовнішній файл конфігу. Якщо
  * поля немає і файлу немає, фейлимося; якщо є хоч щось — пропускаємо. Поле
@@ -18,10 +30,7 @@ async function checkStylelintConfigPresence(reporter, cwd) {
   if (!existsSync(pkgPath)) return
   const pkg = JSON.parse(await readFile(pkgPath, 'utf8'))
   const hasField = pkg.stylelint && typeof pkg.stylelint === 'object'
-  const hasExternalCfg =
-    existsSync(join(cwd, '.stylelintrc.json')) ||
-    existsSync(join(cwd, '.stylelintrc.js')) ||
-    existsSync(join(cwd, 'stylelint.config.js'))
+  const hasExternalCfg = STYLELINT_CONFIG_FILES.some(name => existsSync(join(cwd, name)))
   if (hasField || hasExternalCfg) {
     pass('Конфіг stylelint є — у package.json або окремим файлом')
   } else {

package/rules/style-lint/style-lint.mdc

@@ -1,6 +1,6 @@
 ---
 description: Правила стилів CSS та SCSS
-version: '1.4'
+version: '1.5'
 globs: "**/*.{css,scss,vue}"
 alwaysApply: false
 ---

package/rules/test/js/data/stryker_config/stryker.config.baseline.mjs

@@ -1,7 +1,7 @@
 /** @type {import('@stryker-mutator/core').PartialStrykerOptions} */
 export default {
   testRunner: 'vitest',
-  vitest: { configFile: 'vitest.config.js' },
+  vitest: { configFile: 'vitest.config.mjs' },
   // perTest: Stryker запускає лише тести, що покривають мутовану лінію — головний приріст
   // швидкості проти command runner (де треба було б ганяти ввесь test-suite на кожен мутант).
   coverageAnalysis: 'perTest',

package/rules/test/js/data/stryker_config/stryker.config.vue.baseline.mjs

@@ -1,7 +1,7 @@
 /** @type {import('@stryker-mutator/core').PartialStrykerOptions} */
 export default {
   testRunner: 'vitest',
-  vitest: { configFile: 'vitest.config.js' },
+  vitest: { configFile: 'vitest.config.mjs' },
   // perTest: Stryker запускає лише тести, що покривають мутовану лінію — головний приріст
   // швидкості проти command runner (де треба було б ганяти ввесь test-suite на кожен мутант).
   coverageAnalysis: 'perTest',

package/rules/test/js/stryker_config.mjs

@@ -18,6 +18,24 @@ const STRYKER_VUE_PLUGIN_PATH = join(HERE, 'data', 'stryker_config', 'stryker-vu
 const STRYKER_VUE_PLUGIN_FILENAME = 'stryker-vue-macros-ignorer.mjs'
 const VITEST_BASELINE_PATH = join(HERE, 'data', 'vitest_config', 'vitest.config.baseline.js')
 
+// Канонічна назва vitest-конфіга — `.mjs` (нові файли, js-lint.mdc); legacy
+// `.js` лишається валідним. Перший знайдений виграє (.mjs пріоритетніший).
+const VITEST_CONFIG_NAMES = ['vitest.config.mjs', 'vitest.config.js']
+// Заміна literal `configFile` у скопійованому stryker-baseline на фактичне
+// ім'я vitest-конфіга jsRoot-а (узгодження Stryker ↔ vitest).
+const STRYKER_CONFIG_FILE_RE = /configFile: 'vitest\.config\.[cm]?js'/u
+
+/**
+ * Визначає ім'я vitest-конфіга для jsRoot: існуючий `.mjs`/`.js` (якщо є),
+ * інакше дефолт `vitest.config.mjs` (нові файли — `.mjs`). Існуючий
+ * `vitest.config.js` лишається валідним (backward-compat), новий не плодиться.
+ * @param {string} jsRoot абсолютний шлях до workspace-каталогу
+ * @returns {string} ім'я vitest-конфіга
+ */
+function resolveVitestConfigName(jsRoot) {
+  return VITEST_CONFIG_NAMES.find(name => existsSync(join(jsRoot, name))) ?? 'vitest.config.mjs'
+}
+
 // Канонічні entries, які vue-варіант baseline тримає у `plugins`/`ignorers`.
 // Augment-крок (augmentVueStrykerConfig) дбає, щоб саме вони були присутні в
 // уже-існуючому `stryker.config.mjs` Vue-root-а. Нову property пишемо у
@@ -64,15 +82,20 @@ async function hasVueFiles(jsRoot) {
  * @param {string} cwd корінь проєкту (для relative-шляхів у логах)
  * @param {string} baselinePath абсолютний шлях до canonical baseline
  * @param {string} target абсолютний шлях, куди копіювати
- * @param {string} label зрозуміла для людини мітка ("stryker.config.mjs" / "vitest.config.js")
+ * @param {string} label зрозуміла для людини мітка ("stryker.config.mjs" / "vitest.config.mjs")
+ * @param {(content: string) => string} [transform] опційне перетворення тексту baseline перед записом
  * @returns {Promise<void>}
  */
-async function ensureBaselineFile(reporter, cwd, baselinePath, target, label) {
+async function ensureBaselineFile(reporter, cwd, baselinePath, target, label, transform) {
   if (existsSync(target)) {
     reporter.pass(`${label} існує (${relative(cwd, target)})`)
     return
   }
-  await copyFile(baselinePath, target)
+  if (transform) {
+    await writeFile(target, transform(await readFile(baselinePath, 'utf8')), 'utf8')
+  } else {
+    await copyFile(baselinePath, target)
+  }
   reporter.pass(`${label} створено з canonical baseline (${relative(cwd, target)}) (test.mdc)`)
 }
 
@@ -341,7 +364,12 @@ export async function check(cwd = process.cwd()) {
     // і саме тут augment закриває drift-hole.
     const wasMissing = !existsSync(strykerTarget)
     const strykerBaseline = isVueRoot ? STRYKER_VUE_BASELINE_PATH : STRYKER_BASELINE_PATH
-    await ensureBaselineFile(reporter, cwd, strykerBaseline, strykerTarget, 'stryker.config.mjs')
+    // configFile у новоствореному baseline має вказувати на фактичний vitest-конфіг
+    // jsRoot-а (existing `.js`/`.mjs` або дефолтний `.mjs`).
+    const vitestName = resolveVitestConfigName(jsRoot)
+    await ensureBaselineFile(reporter, cwd, strykerBaseline, strykerTarget, 'stryker.config.mjs', content =>
+      content.replace(STRYKER_CONFIG_FILE_RE, `configFile: '${vitestName}'`)
+    )
     if (isVueRoot) {
       if (!wasMissing) {
         await augmentVueStrykerConfig(reporter, cwd, jsRoot)
@@ -354,7 +382,7 @@ export async function check(cwd = process.cwd()) {
         STRYKER_VUE_PLUGIN_FILENAME
       )
     }
-    await ensureBaselineFile(reporter, cwd, VITEST_BASELINE_PATH, join(jsRoot, 'vitest.config.js'), 'vitest.config.js')
+    await ensureBaselineFile(reporter, cwd, VITEST_BASELINE_PATH, join(jsRoot, vitestName), vitestName)
   }
 
   // Гарантуємо що тест-артефакти (Stryker output, lcov HTML-звіт) ніколи не

package/rules/test/js/vitest-config-pool-forks.mjs

@@ -8,8 +8,12 @@ import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
 /** Subтring-pattern: `pool: 'forks'` або `pool: "forks"` (з опційним whitespace). */
 const POOL_FORKS_RE = /pool\s*:\s*['"]forks['"]/u
 
+// Канонічна назва — `.mjs` (нові файли, js-lint.mdc), але legacy `.js` лишається
+// валідним. Перший знайдений виграє: `.mjs` пріоритетніший.
+const VITEST_CONFIG_NAMES = ['vitest.config.mjs', 'vitest.config.js']
+
 /**
- * Перевіряє, що `vitest.config.js` (якщо існує) містить `pool: 'forks'`.
+ * Перевіряє, що `vitest.config.{mjs,js}` (якщо існує) містить `pool: 'forks'`.
  * @param {string} [cwdParam] корінь репозиторію
  * @returns {Promise<number>} 0 — OK або skip, 1 — config без `pool: 'forks'`
  */
@@ -17,18 +21,18 @@ export async function check(cwdParam = process.cwd()) {
   const reporter = createCheckReporter()
   const { pass, fail } = reporter
 
-  const configPath = join(cwdParam, 'vitest.config.js')
-  if (!existsSync(configPath)) {
-    pass('vitest.config.js відсутній — pool-перевірку пропущено')
+  const configName = VITEST_CONFIG_NAMES.find(name => existsSync(join(cwdParam, name)))
+  if (!configName) {
+    pass('vitest.config.mjs/.js відсутній — pool-перевірку пропущено')
     return reporter.getExitCode()
   }
 
-  const body = await readFile(configPath, 'utf8')
+  const body = await readFile(join(cwdParam, configName), 'utf8')
   if (POOL_FORKS_RE.test(body)) {
-    pass("vitest.config.js містить pool: 'forks' (test.mdc)")
+    pass(`${configName} містить pool: 'forks' (test.mdc)`)
   } else {
     fail(
-      "vitest.config.js має містити pool: 'forks' — defense-in-depth для race у process.cwd() між паралельними test files (test.mdc)"
+      `${configName} має містити pool: 'forks' — defense-in-depth для race у process.cwd() між паралельними test files (test.mdc)`
     )
   }
 

package/rules/test/test.mdc

@@ -1,7 +1,7 @@
 ---
-description: JS-тести (*.test.mjs) живуть у tests/. Правило `test` керує stryker.config.mjs + vitest.config.js (якщо js-lint enabled) і .cargo/mutants.toml (якщо rust enabled).
-version: '2.7'
-globs: "**/{.n-cursor.json,package.json,Cargo.toml,stryker.config.mjs,vitest.config.js,.cargo/mutants.toml},**/*.test.mjs"
+description: JS-тести (*.test.mjs) живуть у tests/. Правило `test` керує stryker.config.mjs + vitest.config.mjs (якщо js-lint enabled) і .cargo/mutants.toml (якщо rust enabled).
+version: '2.8'
+globs: "**/{.n-cursor.json,package.json,Cargo.toml,stryker.config.mjs,vitest.config.mjs,vitest.config.js,.cargo/mutants.toml},**/*.test.mjs"
 alwaysApply: false
 ---
 
@@ -71,15 +71,15 @@ Recursive globs ловлять файли всередині `tests/` так с
 - Усі FS-операції у тесті — через `join(dir, …)` і `writeJson(join(dir, …), …)` / `ensureDir(join(dir, …))` (хелпери валідують `isAbsolute`).
 - Усі child-процеси — `execFile(bin, args, { cwd: dir })`, `spawnSync(bin, args, { cwd: dir })`.
 - Concern-функції правил — `await check(dir)`, `await applies(dir)`, `await fix(dir)`; усі production функції приймають перший параметр `cwd = process.cwd()` (default зберігає CLI-сумісність).
-- `vitest.config.js` додатково ставить `pool: 'forks'` як defense-in-depth: навіть якщо хтось пропустить правило вище, fork-ізоляція не дасть race у production tree.
+- `vitest.config.mjs` (або legacy `vitest.config.js`) додатково ставить `pool: 'forks'` як defense-in-depth: навіть якщо хтось пропустить правило вище, fork-ізоляція не дасть race у production tree.
 
 Це **обов'язково** і для тестів пакета `@nitra/cursor`, і для кожного проєкту-споживача. Триплет перевірок:
 
 - **`no-process-chdir`** (`rules/test/js/no-process-chdir.mjs`) — сканує `**/*.test.{js,mjs}` і падає з ❌ на будь-яке вживання `process.chdir(`.
 - **`no-relative-fs-path`** (`rules/test/js/no-relative-fs-path.mjs`) — AST-сканер (`oxc-parser`): знаходить виклики FS-функцій із `node:fs`/`node:fs/promises` (`writeFile`, `copyFile`, `mkdir`, `readFile`, `existsSync`, `rename`, `symlink`, `cp`, … включно з `*Sync`-варіантами та `writeJson`/`ensureDir`-хелперами), де path-аргумент — це **string literal** без префікса `/`, `\`, `file:`, `http(s):`, `data:`, чи Windows-disk-letter `C:\`. Виклики `copyFile`/`rename`/`symlink`/`link`/`cp` перевіряють обидва path-аргументи. Виклики з обчисленим path (`join(dir, …)`, змінна, template-literal з виразом) пропускаються. Виловив би інцидент v1.28.0 у `tests/check-rule-fixtures.test.mjs` (`copyFile(src, 'default.conf.template')` → файл у production tree).
-- **`vitest-config-pool-forks`** (`rules/test/js/vitest-config-pool-forks.mjs`) — substring-перевірка `pool: 'forks'` у `vitest.config.js`. Defense-in-depth.
+- **`vitest-config-pool-forks`** (`rules/test/js/vitest-config-pool-forks.mjs`) — substring-перевірка `pool: 'forks'` у `vitest.config.mjs` (або legacy `vitest.config.js`; `.mjs` пріоритетніший). Defense-in-depth.
 
-Canonical `vitest.config.js` (для довідки — `pool: 'forks'` + `include` + `coverage`) — у `rules/test/js/data/vitest_config/vitest.config.baseline.js` (концерн `stryker_config` копіює його у кожен JS-root).
+Canonical `vitest.config.mjs` (для довідки — `pool: 'forks'` + `include` + `coverage`) — у `rules/test/js/data/vitest_config/vitest.config.baseline.js` (концерн `stryker_config` копіює його у кожен JS-root; нові файли — `.mjs`, наявний `vitest.config.js` лишається валідним і не дублюється).
 
 ## Console mocking у тестах
 
@@ -144,7 +144,7 @@ test.skipIf(env.STRYKER_MUTATOR_WORKER)('узгоджені з поточним
 
 ## Налаштування mutation-testing
 
-Якщо у `.n-cursor.json#rules` присутнє правило `js-lint` — правило `test` створює canonical baseline `stryker.config.mjs` + `vitest.config.js` у **кожному** JS-root проєкту: у кожному workspace з власним `package.json` (або в корені для single-package). У monorepo з `workspaces: ['app', 'scripts']` отримаєте `app/stryker.config.mjs` + `app/vitest.config.js` і `scripts/stryker.config.mjs` + `scripts/vitest.config.js`.
+Якщо у `.n-cursor.json#rules` присутнє правило `js-lint` — правило `test` створює canonical baseline `stryker.config.mjs` + `vitest.config.mjs` у **кожному** JS-root проєкту: у кожному workspace з власним `package.json` (або в корені для single-package). У monorepo з `workspaces: ['app', 'scripts']` отримаєте `app/stryker.config.mjs` + `app/vitest.config.mjs` і `scripts/stryker.config.mjs` + `scripts/vitest.config.mjs`. Якщо у JS-root уже лежить legacy `vitest.config.js` — він лишається валідним, новий `.mjs` поряд не створюється, а `vitest.configFile` у скопійованому `stryker.config.mjs` приводиться до фактичного імені.
 
 Канон Stryker config (Vitest runner + perTest): [stryker.config.baseline.mjs](./js/data/stryker_config/stryker.config.baseline.mjs)
 
@@ -160,7 +160,7 @@ JS-root без `.vue` отримує дефолтний baseline без `plugins
 
 ### Vitest baseline та `package.json#scripts`
 
-Поряд зі Stryker концерн `stryker_config` без дублювання копіює `vitest.config.js` (теж тільки якщо файлу немає). Canonical: [vitest.config.baseline.js](./js/data/vitest_config/vitest.config.baseline.js) — `environment: 'node'`, `coverage.provider: 'v8'` з lcov+text-summary репортами, `include: ['**/*.test.{js,mjs}', 'tests/**/*.test.{js,mjs}']` (підхоплює обидві розкладки — тести у `tests/`-піддиректоріях і top-level integration suites у `<root>/tests/`).
+Поряд зі Stryker концерн `stryker_config` без дублювання копіює `vitest.config.mjs` (тільки якщо немає ні `.mjs`, ні legacy `.js`). Canonical: [vitest.config.baseline.js](./js/data/vitest_config/vitest.config.baseline.js) — `environment: 'node'`, `coverage.provider: 'v8'` з lcov+text-summary репортами, `include: ['**/*.test.{js,mjs}', 'tests/**/*.test.{js,mjs}']` (підхоплює обидві розкладки — тести у `tests/`-піддиректоріях і top-level integration suites у `<root>/tests/`).
 
 У `package.json#scripts` має бути `"test": "vitest run"` (canonical contains-substring `vitest` — допустимо `vitest run` та інші локальні розширення); опційно — `"test:watch": "vitest"`.
 
@@ -168,7 +168,7 @@ JS-root без `.vue` отримує дефолтний baseline без `plugins
 
 ### Frontend-варіант (Vue/Vite + happy-dom)
 
-Для проєктів зі своїм `vite.config.js` `vitest.config.js` має повторно використовувати vite-плагіни та aliases і перемкнути `environment` на `'happy-dom'` (або `'jsdom'`):
+Для проєктів зі своїм `vite.config.js` `vitest.config.mjs` має повторно використовувати vite-плагіни та aliases і перемкнути `environment` на `'happy-dom'` (або `'jsdom'`):
 
 ```js
 import { defineConfig, mergeConfig } from 'vitest/config'

package/rules/vue/vue.mdc

@@ -1,6 +1,6 @@
 ---
 description: Vue
-version: '2.1'
+version: '2.2'
 globs: "**/*.vue"
 alwaysApply: false
 ---
@@ -44,14 +44,14 @@ const folderStructure = `
   assets/
   public/
   App.vue
-  main.js
+  main.mjs
 `
 ```
 
 ### Найменування файлів
 
 - **SFC:** імена файлів компонентів у **PascalCase** починаючи з букви N(`NMyWidget.vue`).
-- **Інші JS-модулі:** узгоджено **kebab-case** (`date-utils.js`).
+- **Інші JS-модулі:** узгоджено **kebab-case** (`date-utils.mjs`).
 
 ### Модулі та архітектура
 
@@ -116,9 +116,9 @@ const additionalInstructions = `
 
 ### Тестування
 
-- **Unit + Component / DOM:** **Vitest** (`vitest`) + **Vue Test Utils** з **happy-dom** як DOM-середовищем. Це канон, узгоджений з `test.mdc` (Stryker з vitest-runner + `perTest`-аналіз покриття). `vitest.config.js` повторно використовує `vite.config.js` через `mergeConfig` і перемикає `environment` на `'happy-dom'`:
+- **Unit + Component / DOM:** **Vitest** (`vitest`) + **Vue Test Utils** з **happy-dom** як DOM-середовищем. Це канон, узгоджений з `test.mdc` (Stryker з vitest-runner + `perTest`-аналіз покриття). `vitest.config.mjs` повторно використовує `vite.config.js` через `mergeConfig` і перемикає `environment` на `'happy-dom'`:
 
-```js title="vitest.config.js"
+```js title="vitest.config.mjs"
 import { defineConfig, mergeConfig } from 'vitest/config'
 import viteConfig from './vite.config.js'
 
@@ -590,7 +590,7 @@ function getTr() {
 Називай store за назвою сторінки або компонента — `customerPageStore`, `routePageStore` тощо. На сторінці звертайся до нього через змінну `pageStore`.
 
 ```javascript
-// store/customerPage.js
+// store/customerPage.mjs
 export const useCustomerPageStore = defineStore('customerPage', {
   state: () => ({
     filterName: '',

package/scripts/coverage-classify/index.mjs

@@ -11,11 +11,10 @@
  * решта → 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 { callLlm } from '../../lib/llm.mjs'
 import { deriveCacheKey, readCache, writeCache } from './cache.mjs'
 import { buildUserPrompt, SYSTEM_PROMPT } from './prompt.mjs'
 import { parseVerdict } from './verdict-schema.mjs'
@@ -27,25 +26,14 @@ const FALLBACK_VERDICT = {
 }
 
 /**
- * Викликає LLM за model-id і повертає raw текст відповіді.
- * `omlx/...` → прямий HTTP до omlx (text-only); решта → pi CLI.
+ * Викликає LLM через спільний `callLlm` (маршрут за префіксом model-id; wire-trace).
  * @param {string} prompt текст промпта
  * @param {string} model  provider/model-id, `omlx/...` або '' для pi-дефолту
  * @returns {string} текст відповіді моделі
  * @throws якщо backend недоступний або повертає помилку
  */
 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',
-    timeout: 60_000
-  })
-  if (r.error) throw new Error(`pi error: ${r.error.message}`)
-  if (r.status !== 0) throw new Error(`pi exit ${r.status}: ${r.stderr?.slice(0, 200) ?? ''}`)
-  return r.stdout?.trim() ?? ''
+  return callLlm([{ role: 'user', content: prompt }], model, { timeoutMs: 60_000, caller: 'coverage' })
 }
 
 /**

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

@@ -2,10 +2,9 @@
 
 import { existsSync, readFileSync, writeFileSync } from 'node:fs'
 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'
+import { callLlm } from '../../../lib/llm.mjs'
 
 // Тир за замовчуванням: min → avg при ескалації (каскад local→cloud).
 // Перевизначення через N_CURSOR_FIX_MODEL / N_CURSOR_FIX_MODEL_HEAVY.
@@ -13,6 +12,7 @@ export const MODEL = env.N_CURSOR_FIX_MODEL ?? resolveModel('min')
 export const MODEL_HEAVY = env.N_CURSOR_FIX_MODEL_HEAVY ?? resolveModel('avg')
 
 const JSON_CODE_BLOCK_RE = /```(?:json)?[ \t]{0,8}\n?([\s\S]*?)```/
+const API_KEY_RE = /api key/i
 
 /**
  * Витягує відносні шляхи файлів із violation output.
@@ -87,29 +87,18 @@ function buildPrompt(ruleId, ruleMdc, output, files) {
 }
 
 /**
- * Викликає LLM за model-id і повертає текст відповіді.
- * `omlx/...` → прямий HTTP до omlx (text-only, локально); решта → pi CLI.
+ * Викликає LLM через спільний `callLlm` (маршрут за префіксом model-id; wire-trace).
+ * Зберігає дружнє повідомлення про відсутній API-ключ для хмарних провайдерів.
  * @param {string} prompt текст промпта
  * @param {string} model назва моделі (provider/id, `omlx/...` або '')
  * @returns {{ text: string, error?: string }} текст відповіді або повідомлення про помилку
  */
 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',
-    timeout: 120_000
-  })
-  if (r.error) return { text: '', error: r.error.message }
-  if (r.status !== 0) {
-    const stderr = r.stderr?.slice(0, 300) ?? ''
-    if (stderr.toLowerCase().includes('no api key') || stderr.toLowerCase().includes('api key')) {
+  try {
+    return { text: callLlm([{ role: 'user', content: prompt }], model, { timeoutMs: 120_000, caller: 'fix' }) }
+  } catch (error) {
+    const msg = String(error.message)
+    if (API_KEY_RE.test(msg)) {
       const provider = model ? model.split('/')[0] : 'дефолтного провайдера'
       return {
         text: '',
@@ -120,9 +109,8 @@ function callModel(prompt, model) {
         ].join(' ')
       }
     }
-    return { text: '', error: `pi exit ${r.status}: ${stderr}` }
+    return { text: '', error: msg }
   }
-  return { text: r.stdout?.trim() ?? '' }
 }
 
 /**