@nitra/cursor 5.2.1 → 5.3.1

package/rules/npm-module/js/skill_meta.mjs

@@ -5,6 +5,64 @@ import { join } from 'node:path'
 import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
 import { parseSkillAutoSpec, readSkillMetaRaw } from '../../../scripts/lib/skill-meta.mjs'
 
+/**
+ * Перевіряє поля сирого meta.json одного скіла (без auto.md / відсутності файлу).
+ * @param {string} id ідентифікатор скіла
+ * @param {Record<string, unknown>} raw сирий meta.json
+ * @param {ReturnType<typeof createCheckReporter>} reporter репортер
+ * @returns {boolean} true, якщо всі поля валідні
+ */
+function checkSkillFields(id, raw, reporter) {
+  let ok = true
+  if (typeof raw.worktree !== 'boolean') {
+    reporter.fail(`skills/${id}: meta.json.worktree має бути boolean`)
+    ok = false
+  }
+  if (raw.auto !== undefined && parseSkillAutoSpec(raw.auto) === null) {
+    reporter.fail(`skills/${id}: meta.json.auto нерозпізнане — очікується "завжди" або непорожній масив правил`)
+    ok = false
+  }
+  if (raw.requireRoot !== undefined && typeof raw.requireRoot !== 'boolean') {
+    reporter.fail(`skills/${id}: meta.json.requireRoot має бути boolean`)
+    ok = false
+  }
+  if (raw.worktree === true && raw.requireRoot === false) {
+    reporter.fail(
+      `skills/${id}: requireRoot:false суперечить worktree:true (worktree вже вимагає кореня — прибери поле)`
+    )
+    ok = false
+  }
+  return ok
+}
+
+/**
+ * Валідує meta.json одного скіла.
+ * @param {string} id ідентифікатор скіла
+ * @param {string} skillDir каталог скіла
+ * @param {ReturnType<typeof createCheckReporter>} reporter репортер
+ * @returns {void}
+ */
+function checkSkill(id, skillDir, reporter) {
+  let skillOk = true
+
+  if (existsSync(join(skillDir, 'auto.md'))) {
+    reporter.fail(`skills/${id}: залишковий auto.md — видали (метадані тепер у meta.json)`)
+    skillOk = false
+  }
+
+  const raw = readSkillMetaRaw(skillDir)
+  if (!raw) {
+    reporter.fail(`skills/${id}: відсутній або невалідний meta.json (очікується {"auto"?, "worktree": bool})`)
+    return
+  }
+
+  if (!checkSkillFields(id, raw, reporter)) skillOk = false
+
+  if (skillOk) {
+    reporter.pass(`skills/${id}: meta.json валідний`)
+  }
+}
+
 /**
  * Валідує всі `npm/skills/<id>/meta.json`.
  * @param {string} [cwd] корінь репозиторію
@@ -20,41 +78,7 @@ export function check(cwd = process.cwd()) {
 
   for (const entry of readdirSync(skillsDir, { withFileTypes: true })) {
     if (!entry.isDirectory() || entry.name.startsWith('.')) continue
-    const id = entry.name
-    const skillDir = join(skillsDir, id)
-    let skillOk = true
-
-    if (existsSync(join(skillDir, 'auto.md'))) {
-      reporter.fail(`skills/${id}: залишковий auto.md — видали (метадані тепер у meta.json)`)
-      skillOk = false
-    }
-
-    const raw = readSkillMetaRaw(skillDir)
-    if (!raw) {
-      reporter.fail(`skills/${id}: відсутній або невалідний meta.json (очікується {"auto"?, "worktree": bool})`)
-      continue
-    }
-    if (typeof raw.worktree !== 'boolean') {
-      reporter.fail(`skills/${id}: meta.json.worktree має бути boolean`)
-      skillOk = false
-    }
-    if (raw.auto !== undefined && parseSkillAutoSpec(raw.auto) === null) {
-      reporter.fail(`skills/${id}: meta.json.auto нерозпізнане — очікується "завжди" або непорожній масив правил`)
-      skillOk = false
-    }
-    if (raw.requireRoot !== undefined && typeof raw.requireRoot !== 'boolean') {
-      reporter.fail(`skills/${id}: meta.json.requireRoot має бути boolean`)
-      skillOk = false
-    }
-    if (raw.worktree === true && raw.requireRoot === false) {
-      reporter.fail(
-        `skills/${id}: requireRoot:false суперечить worktree:true (worktree вже вимагає кореня — прибери поле)`
-      )
-      skillOk = false
-    }
-    if (skillOk) {
-      reporter.pass(`skills/${id}: meta.json валідний`)
-    }
+    checkSkill(entry.name, join(skillsDir, entry.name), reporter)
   }
 
   return Promise.resolve(reporter.getExitCode())

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 недоступний або повертає помилку
+ * @throws {Error} якщо 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' })
 }
 
 /**
@@ -80,7 +68,7 @@ function classifyOne(group, mutant, cwd, callModelFn) {
  * Класифікує 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, callModel?: Function}} [opts] ін'єкції для тестів
+ * @param {{cachePath?: string, callModel?: (prompt: string, model: string) => string}} [opts] ін'єкції для тестів
  * @returns {Promise<Array<{key: string, verdict: object}>>} verdicts
  */
 export function classify(survived, cwd, opts = {}) {

package/scripts/coverage-classify/verdict-schema.mjs

@@ -22,7 +22,7 @@ export const VerdictSchema = z.object({
  * Витягує JSON-об'єкт з raw-text LLM-відповіді і валідує через VerdictSchema.
  * @param {string} rawText raw-text відповідь LLM
  * @returns {{verdict: string, confidence: number, reason: string, suggestedTest?: string}} verdict
- * @throws якщо JSON не знайдено, не парситься, або не відповідає схемі
+ * @throws {Error} якщо JSON не знайдено, не парситься, або не відповідає схемі
  */
 export function parseVerdict(rawText) {
   const jsonStart = rawText.indexOf('{')

package/scripts/lib/assert-project-root.mjs

@@ -1,5 +1,5 @@
 /**
- * Guard для дефолтної синхронізації `npx @nitra/cursor` (гілка без підкоманди).
+ * Guard для дефолтної синхронізації `npx \@nitra/cursor` (гілка без підкоманди).
  *
  * Дефолтний sync (`runSync` у `bin/n-cursor.js`) скаффолдить у `cwd()` керовані
  * артефакти — `.cursor/rules/`, `.cursor/skills/`, `.claude/`, `AGENTS.md`,

package/scripts/lib/discover-check-rules-from-cursor.mjs

@@ -1,5 +1,5 @@
 /**
- * Визначає список id правил для `npx @nitra/cursor fix` без аргументів:
+ * Визначає список id правил для `npx \@nitra/cursor fix` без аргументів:
  * зчитує базові імена `*.mdc` у `.cursor/rules/` і залишає лише ті id,
  * для яких у пакеті є programmatic перевірка (JS-концерн або policy з target.json).
  */

package/scripts/lib/rule-predicates.mjs

@@ -23,35 +23,44 @@ const IGNORED_DIR_NAMES = new Set(['node_modules', '.git', '.next', '.turbo'])
  */
 async function anyDepInTree(root, keys) {
   const wanted = new Set(keys)
-  let found = false
-  /** @param {string} dir каталог обходу @returns {Promise<void>} */
+  /**
+   * Чи package.json за `abs` оголошує будь-який пакет із `wanted` у `dependencies`.
+   * @param {string} abs шлях до package.json
+   * @returns {Promise<boolean>} true, якщо знайдено хоч один
+   */
+  async function pkgDeclaresWanted(abs) {
+    try {
+      const deps = JSON.parse(await readFile(abs, 'utf8'))?.dependencies
+      if (deps && typeof deps === 'object' && !Array.isArray(deps)) {
+        for (const k of wanted) if (Object.hasOwn(deps, k)) return true
+      }
+    } catch {
+      /* ігноруємо пошкоджені package.json */
+    }
+    return false
+  }
+  /**
+   * @param {string} dir каталог обходу
+   * @returns {Promise<boolean>} true, якщо знайдено хоч один пакет
+   */
   async function walk(dir) {
-    if (found) return
     let entries
     try {
       entries = await readdir(dir, { withFileTypes: true })
     } catch {
-      return
+      return false
     }
     for (const entry of entries) {
-      if (found) return
       const abs = join(dir, entry.name)
       if (entry.isDirectory()) {
-        if (!IGNORED_DIR_NAMES.has(entry.name)) await walk(abs)
-      } else if (entry.isFile() && entry.name === 'package.json') {
-        try {
-          const deps = JSON.parse(await readFile(abs, 'utf8'))?.dependencies
-          if (deps && typeof deps === 'object' && !Array.isArray(deps)) {
-            for (const k of wanted) if (Object.hasOwn(deps, k)) found = true
-          }
-        } catch {
-          /* ігноруємо пошкоджені package.json */
-        }
+        if (!IGNORED_DIR_NAMES.has(entry.name) && (await walk(abs))) return true
+      } else if (entry.isFile() && entry.name === 'package.json' && (await pkgDeclaresWanted(abs))) {
+        return true
       }
     }
+    return false
   }
-  await walk(root)
-  return found
+  return walk(root)
 }
 
 /**
@@ -62,7 +71,10 @@ async function anyDepInTree(root, keys) {
 async function nestedWithoutVite(root) {
   const rootPkg = join(root, 'package.json')
   let result = false
-  /** @param {string} dir каталог @returns {Promise<void>} */
+  /**
+   * @param {string} dir каталог
+   * @returns {Promise<void>}
+   */
   async function walk(dir) {
     if (result) return
     let entries

package/scripts/lib/run-rule-cli.mjs

@@ -1,7 +1,7 @@
 /**
  * Standalone CLI runner для одного правила. Викликається з `rules/<id>/fix.mjs`
  * у блоці `if (import.meta.main)` — це робить `bun rules/<id>/fix.mjs` повним
- * еквівалентом старого `npx @nitra/cursor fix <id>`: читає `.n-cursor.json`,
+ * еквівалентом старого `npx \@nitra/cursor fix <id>`: читає `.n-cursor.json`,
  * перевіряє whitelist, друкує summary, повертає aggregated exit-code.
  *
  * Library-mode виклик з CLI orchestration — інше: див. `runStandardRule` + `fix.mjs::run(ctx)`.

package/scripts/lib/run-standard-rule.mjs

@@ -5,7 +5,7 @@
  * Локальна логіка в правилах заборонена; розширення поведінки — через `ctx`-опції.
  *
  * Серіалізація: загортає виконання у `withLock('fix-<ruleId>')` — паралельні запуски
- * того самого правила (через `npx @nitra/cursor fix`, прямий `bun rules/<id>/fix.mjs`
+ * того самого правила (через `npx \@nitra/cursor fix`, прямий `bun rules/<id>/fix.mjs`
  * чи `run(ctx)`-композицію) дедупляться за станом git-дерева; різні правила можуть
  * виконуватись паралельно. Точка інтеграції — тут, щоб не дублювати лок у кожному
  * `fix.mjs`.

package/scripts/post-tool-use-fix.mjs

@@ -1,5 +1,5 @@
 /**
- * PostToolUse hook для Claude Code: точкова маршрутизація `npx @nitra/cursor fix`
+ * PostToolUse hook для Claude Code: точкова маршрутизація `npx \@nitra/cursor fix`
  * за типом зміненого файла. Запускається після кожного `Edit` / `Write` / `MultiEdit`;
  * замінює дорогий синхронний `Stop`-хук, що ганяв повний `fix` усіх правил на кожному
  * turn-і.
@@ -8,7 +8,7 @@
  * - stdin Claude Code: JSON із `tool_input.file_path` (відносний шлях зміненого файла);
  * - exit 0, якщо файл не має маршрут (PostToolUse не блокує turn у будь-якому випадку,
  *   але ми лишаємо exit-код прозорим — для діагностики);
- * - інакше spawn `npx --no @nitra/cursor fix <rules…>` із передаванням exit-коду.
+ * - інакше spawn `npx --no \@nitra/cursor fix <rules…>` із передаванням exit-коду.
  *
  * Маршрути впорядковані від найбільш специфічного до загального; перший збіг — переможець.
  * `docs/adr/**\/*.md` свідомо повертає `[]`: ADR-нормалізація вже покривається async
@@ -46,7 +46,7 @@ const ROUTES = Object.freeze([
  * Повертає список правил, які слід прогнати для зміненого `filePath`.
  * Перший збіг із `ROUTES` — переможець; невідомі шляхи / некоректні входи → `[]`.
  * @param {unknown} filePath відносний шлях зміненого файла зі stdin Claude Code
- * @returns {string[]} ID правил для `npx @nitra/cursor fix`
+ * @returns {string[]} ID правил для `npx \@nitra/cursor fix`
  */
 export function routeFilePathToRules(filePath) {
   if (typeof filePath !== 'string' || filePath === '') {

package/scripts/skills-cli.mjs

@@ -6,11 +6,11 @@
  * `.n-cursor.json`) — далі stdout або делегування в `cursor-agent` / `claude`.
  *
  * Підтримувані формати:
- *   `npx @nitra/cursor skill list`
- *   `npx @nitra/cursor skill taze`
- *   `npx @nitra/cursor skill cursor taze`
- *   `npx @nitra/cursor skill cursor taze "онови залежності"`
- *   `npx @nitra/cursor skill claude taze` — те саме через Claude Code CLI
+ *   `npx \@nitra/cursor skill list`
+ *   `npx \@nitra/cursor skill taze`
+ *   `npx \@nitra/cursor skill cursor taze`
+ *   `npx \@nitra/cursor skill cursor taze "онови залежності"`
+ *   `npx \@nitra/cursor skill claude taze` — те саме через Claude Code CLI
  */
 
 import { spawnSync } from 'node:child_process'