@nitra/cursor 5.2.0 → 5.3.0

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/doc-files/js/docgen-extract-anchors.mjs

@@ -15,9 +15,15 @@
  */
 
 const URL_RE = /https?:\/\/[^\s'"`)<>]+/g
+// Після обрізання template-частини URL має лишитися host (R10).
+const STATIC_URL_RE = /^https?:\/\/[^/${]+/
 const EXPORT_CONST_RE = /export\s+const\s+([A-Z][A-Z0-9_]+)\s*=\s*(['"`])([^'"`]+)\2/g
 const ERROR_MARKER_RE = /\(([a-z][\w-]*\.mdc)\)/g
-const CONFIG_REF_RE = /\b(\.[a-z][\w.-]*\.json)\b/gi
+// Повне ім'я json-конфіга (з опційним провідним дотом). Lookbehind `(?<![\w.])`
+// не дає почати матч усередині складеного імені — інакше `settings.local.json`
+// дало б хибний анкор `.local.json`, а `capacitor.config.json` → `.config.json`,
+// і модель, маючи їх у «обов'язкових анкорах», писала б неіснуючий файл як факт.
+const CONFIG_REF_RE = /(?<![\w.])(\.?[a-z][\w.-]*\.json)\b/gi
 const FILE_HEADER_RE = /^\s*\/\*\*([\s\S]*?)\*\//
 const CODE_BLOCK_RE = /```[a-z]{0,12}\n([\s\S]*?)\n[ \t]{0,8}\*?[ \t]{0,8}```/g
 
@@ -50,7 +56,16 @@ function uniq(arr) {
  * }} категоризовані анкори файлу
  */
 export function extractAnchors(src) {
-  const urls = uniq(Array.from(src.matchAll(URL_RE), m => m[0]))
+  // R10: template-literal URL (`https://h/${expr}/x`) — обрізаємо на `${`, лишаючи
+  // статичний префікс. Інакше анкор тягне у доку сміття типу `…/${encodeURIComponent(name`.
+  const urls = uniq(
+    Array.from(src.matchAll(URL_RE), m => m[0])
+      .map(u => {
+        const i = u.indexOf('${')
+        return i === -1 ? u : u.slice(0, i)
+      })
+      .filter(u => STATIC_URL_RE.test(u))
+  )
 
   const magicStrings = []
   const seenNames = new Set()
@@ -73,6 +88,17 @@ export function extractAnchors(src) {
   return { urls, magicStrings, errorMarkers, configRefs, examples }
 }
 
+/**
+ * Плоский список анкор-токенів, які мають дослівно зʼявитися в документі (R5):
+ * URLs, імена констант-рядків, маркери `(rule.mdc)`, конфіги. Приклади й
+ * code-блоки опускаються — їх багаторядковість не звіряється підрядком.
+ * @param {ReturnType<typeof extractAnchors>} a анкори файлу
+ * @returns {string[]} токени для перевірки покриття/валідності
+ */
+export function anchorTokens(a) {
+  return [...a.urls, ...a.magicStrings.map(s => s.name), ...a.errorMarkers.map(m => `(${m})`), ...a.configRefs]
+}
+
 /**
  * Форматує анкори у компактний текст для system-промпта.
  * Якщо анкорів немає взагалі — повертає порожній рядок (системний блок про

package/skills/doc-files/js/docgen-extract.mjs

@@ -30,6 +30,9 @@ const RETURNS_LINE_RE = /^@returns?[ \t]{1,8}(?:\{[^}]{0,200}\}[ \t]{1,8})?(.{0,
 const FILE_HEADER_RE = /^\s*\/\*\*([\s\S]*?)\*\//
 const PRECEDING_JSDOC_RE = /\/\*\*(?:(?!\*\/)[\s\S])*\*\/\s*$/
 const EXPORT_DECL_RE = /export\s+(?:async\s+)?(function|const|class)\s+(\w+)/g
+// Top-level function/class декларації (колонка 0) — для R6: службові функції,
+// які не експортуються, не мають протікати у Поведінку/API як «публічні».
+const TOP_FN_DECL_RE = /^(?:export\s+)?(?:default\s+)?(?:async\s+)?(?:function\*?|class)\s+(\w+)/gm
 const IMPORT_FROM_RE = /^import[ \t]{1,8}[\s\S]{0,300}?from\s{1,8}['"]([^'"]+)['"]/gm
 const NODE_PREFIX_RE = /^node:/
 const INTERNAL_IMPORT_RE = /import[ \t]{1,8}([^'"]{0,300}?)from[ \t]{1,8}['"]\.[^'"]{1,300}['"]/g
@@ -41,7 +44,10 @@ const CATCH_RE = /catch\s*\(/
 const TRY_RE = /\btry\s*\{/
 const FALSY_RETURN_RE = /return\s+(false|null|''|"")/
 const NETWORK_RE = /\bfetch\(|https?\.|axios|got\(/
-const CACHE_RE = /new Map\(\)|Cache|cache/
+// Кеш — лише за ІМЕНОВАНИМ маркером (`cache`/`Cache`/`memoize`), не за будь-яким
+// `new Map()`: акумулятор (напр. `byPath = new Map()`) — не кеш, а хибна гарантія
+// «Кешує результати» гірша за пропуск (фабрикація > мовчання).
+const CACHE_RE = /cache|memoi[sz]e/i
 
 /**
  * Прибирає `/** *​/`-обрамлення й `*`-префікси, повертає чистий текст рядками.
@@ -168,6 +174,22 @@ function extractInternalSymbols(src) {
   return [...out]
 }
 
+/**
+ * Імена top-level функцій/класів, які НЕ експортуються (службові помічники).
+ * Модель не має подавати їх як «публічні функції» у Поведінці/API (R6).
+ * Const-стрілки свідомо не ловимо — менше false-positive на змістовних константах.
+ * @param {string} src вміст файлу
+ * @returns {Array<string>} список імен неекспортованих функцій/класів
+ */
+function extractLocalSymbols(src) {
+  const exported = new Set(Array.from(src.matchAll(EXPORT_DECL_RE), m => m[2]))
+  const out = new Set()
+  for (const m of src.matchAll(TOP_FN_DECL_RE)) {
+    if (!exported.has(m[1])) out.add(m[1])
+  }
+  return [...out]
+}
+
 /**
  * Поведінкові маркери — евристики регулярками.
  * @param {string} src вміст файлу
@@ -207,6 +229,7 @@ export function extractFacts(src, relPath) {
     exports: extractExports(src),
     imports: extractImports(src),
     internalSymbols: extractInternalSymbols(src),
+    localSymbols: extractLocalSymbols(src),
     markers: extractMarkers(src)
   }
 }