@7n/rules-lang-js 0.6.0 → 0.7.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [0.7.1] - 2026-07-20
+
+### Fixed
+
+- style/lint: stylelint — задекларована залежність плагіна (раніше резолвилась лише транзитивно у цьому монорепо через @nitra/stylelint-config); відсутність тула тепер дає видимий warn-diagnostic замість мовчазного no-op (незалежний консюмер бачив би 'зелений' style-лінт, який насправді нічого не перевіряв)
+
+## [0.7.0] - 2026-07-19
+
+### Added
+
+- правило test з ядра: розміщення тест-файлів у tests/, ізоляція (no-process-chdir, no-relative-fs-path, no-console-store-restore, sandbox-aware-test, no-bun-test-import), канон vitest/stryker конфігів і vitest-api-конвенції — без cargo-mutants (він у правилі rust плагіна lang-rust)
+
 ## [0.6.0] - 2026-07-19
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@7n/rules-lang-js",
-  "version": "0.6.0",
+  "version": "0.7.1",
   "description": "Плагін @7n/rules: JS/npm/bun-екосистема — lint-правила (js/bun/vue/js-run/npm-module/db), taze-провайдер (package.json, bunx taze) і doc-files-екстрактори (oxc AST)",
   "keywords": [
     "javascript",
@@ -58,7 +58,8 @@
     "jscpd": "^5.0.11",
     "knip": "^6.22.0",
     "oxc-parser": "^0.137.0",
-    "oxlint": "^1.68.0"
+    "oxlint": "^1.68.0",
+    "stylelint": "^17.6.0"
   },
   "peerDependencies": {
     "@7n/rules": ">=1.27.0"

package/rules/js-bun-redis/lib/docs/redis-imports.md

@@ -122,7 +122,7 @@ export function findRedisImportsInText(
 
 ### Внутрішні (репозиторій)
 
-Імпорт із `'../../../scripts/utils/ast-scan-utils.mjs'` — спільні утиліти AST-сканера для всіх правил у `npm/rules/*/lib/`:
+Імпорт із `'@7n/rules/scripts/utils/ast-scan-utils.mjs'` (ядро) — спільні утиліти AST-сканера, які використовують правила з декількох плагінів:
 
 - `dynamicImportModule(node)` — якщо вузол AST є динамічним `import('mod')`, повертає рядок `'mod'`, інакше `null`/`undefined`.
 - `langFromPath(path)` — обчислює `lang` для `oxc-parser` за розширенням шляху.
@@ -198,7 +198,7 @@ import x from 'my-redis-helpers' // довільний сторонній пак
 Контрольний перелік, за яким можна **відтворити** функціонал модуля «з нуля»:
 
 1. Створити файл `redis-imports.mjs`, що імпортує `parseSync` з `oxc-parser`.
-2. Імпортувати з `'../../../scripts/utils/ast-scan-utils.mjs'` шість утиліт: `dynamicImportModule`, `langFromPath`, `normalizeSnippet`, `offsetToLine`, `requireCallModule`, `walkAstWithAncestors`.
+2. Імпортувати з `'@7n/rules/scripts/utils/ast-scan-utils.mjs'` шість утиліт: `dynamicImportModule`, `langFromPath`, `normalizeSnippet`, `offsetToLine`, `requireCallModule`, `walkAstWithAncestors`.
 3. Оголосити константу `SOURCE_FILE_RE = /\.([cm]?[jt]sx?)$/u`.
 4. Оголосити константу `FORBIDDEN_MODULE_NAMES` як `Set` із елементами: `'ioredis'`, `'node-redis'`, `'redis'`, `'@redis/client'`, `'@redis/json'`, `'@redis/search'`, `'@redis/time-series'`, `'@redis/bloom'`.
 5. Реалізувати приватну функцію `isForbiddenRedisModule(mod)`: повертає `true`, якщо `FORBIDDEN_MODULE_NAMES.has(mod)` **або** `mod.startsWith('ioredis/')` **або** `mod.startsWith('redis/')` **або** `mod.startsWith('@redis/')`.

package/rules/style/admin_table/docs/main.md

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: plugins/lang-js/rules/style/admin_table/main.mjs
 docgen:
-  crc: 267496d1
+  crc: fb8f81a5
 ---
 
 ## Огляд

package/rules/style/admin_table/main.mjs

@@ -13,8 +13,8 @@ const DEFINITION_RE = /\.n-admin-table\b/u
  * клас `n-admin-table`, він має бути визначений хоч в одному `.scss`/`.css`/`.vue`
  * (guide: `admin_table.mdc`). Для усунення false positives — крос-файлова перевірка,
  * тож потребує whole-repo сканування незалежно від `ctx.files`.
- * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст lint-прогону (cwd)
- * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} результат зі зібраними violations
+ * @param {import('@7n/rules/scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст lint-прогону (cwd)
+ * @returns {Promise<import('@7n/rules/scripts/lib/lint-surface/types.mjs').LintResult>} результат зі зібраними violations
  */
 export async function lint(ctx) {
   const reporter = createViolationReporter(ctx)

package/rules/style/gap/docs/main.md

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: plugins/lang-js/rules/style/gap/main.mjs
 docgen:
-  crc: 23cd7951
+  crc: 5d9d76e7
 ---
 
 ## Огляд

package/rules/style/gap/main.mjs

@@ -13,8 +13,8 @@ const DEFINITION_RE = /\.n-gap-(xs|sm|md|lg)\b/gu
  * використаний у `.vue`, має бути визначений хоч в одному `.scss`/`.css`/`.vue`
  * (guide: `gap.mdc`). Крос-файлова перевірка usage↔definition — потребує whole-repo
  * сканування незалежно від `ctx.files`.
- * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст lint-прогону (cwd)
- * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} результат зі зібраними violations
+ * @param {import('@7n/rules/scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст lint-прогону (cwd)
+ * @returns {Promise<import('@7n/rules/scripts/lib/lint-surface/types.mjs').LintResult>} результат зі зібраними violations
  */
 export async function lint(ctx) {
   const reporter = createViolationReporter(ctx)

package/rules/style/lint/docs/fix-lint.md

@@ -3,7 +3,7 @@ type: JS Module
 title: fix-lint.mjs
 resource: plugins/lang-js/rules/style/lint/fix-lint.mjs
 docgen:
-  crc: a63dc24c
+  crc: a44c6b01
 ---
 
 ## Огляд

package/rules/style/lint/docs/main.md

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: plugins/lang-js/rules/style/lint/main.mjs
 docgen:
-  crc: c9a94f80
+  crc: 25130f97
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   issues: judge:inaccurate:0.99

package/rules/style/lint/fix-lint.mjs

@@ -40,7 +40,7 @@ async function listStyleFiles(cwd, ctxFiles) {
   return (r.stdout ?? '').split('\0').filter(Boolean)
 }
 
-/** @type {import('../../../scripts/lib/lint-surface/types.mjs').T0Pattern[]} */
+/** @type {import('@7n/rules/scripts/lib/lint-surface/types.mjs').T0Pattern[]} */
 export const patterns = [
   {
     id: 'style-stylelint-fix',

package/rules/style/lint/main.mjs

@@ -1,7 +1,9 @@
 /**
  * lint-поверхня style: read-only detector (stylelint без --fix) для css/scss/vue.
- * Per-file (ctx.files) або весь проєкт (ctx.files === undefined). Якщо stylelint
- * недоступний — крок пропускається (без npx-автовстановлення).
+ * Per-file (ctx.files) або весь проєкт (ctx.files === undefined). `stylelint` —
+ * задекларована залежність плагіна (справжній `npm install` завжди його ставить);
+ * якщо резолв все ж не вдався (побитий install, hoisting-аномалія) — крок
+ * пропускається з видимим warn-diagnostic, а не мовчки (без npx-автовстановлення).
  */
 import { existsSync } from 'node:fs'
 import { join } from 'node:path'
@@ -33,8 +35,8 @@ export function resolveStylelint(cwd) {
 
 /**
  * Detector style/lint (read-only).
- * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст lint-прогону (cwd, files)
- * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} результат зі зібраними violations
+ * @param {import('@7n/rules/scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст lint-прогону (cwd, files)
+ * @returns {Promise<import('@7n/rules/scripts/lib/lint-surface/types.mjs').LintResult>} результат зі зібраними violations
  */
 export async function lint(ctx) {
   const reporter = createViolationReporter(ctx)
@@ -54,8 +56,18 @@ export async function lint(ctx) {
 
   const stylelint = resolveStylelint(cwd)
   if (!stylelint) {
-    // stylelint недоступний → крок пропущено (без автовстановлення)
-    return reporter.result()
+    // stylelint — задекларована залежність плагіна, тож відсутність тут аномальна
+    // (побитий install, hoisting) — крок пропущено з видимим warn, не мовчки.
+    const result = reporter.result()
+    result.diagnostics = [
+      {
+        level: 'warn',
+        message:
+          'lint-style: `stylelint` не резолвиться (ні node_modules/.bin, ні PATH) — CSS/SCSS/Vue-стилі НЕ перевірені ' +
+          'цим прогоном (style.mdc). `stylelint` — залежність @7n/rules-lang-js; переустанови плагін, якщо бачиш це.'
+      }
+    ]
+    return result
   }
 
   const r = await spawnAsync(stylelint, targets, { cwd, shell: false })

package/rules/style/quasar_fixes/docs/main.md

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: plugins/lang-js/rules/style/quasar_fixes/main.mjs
 docgen:
-  crc: 0f9c4631
+  crc: dec47808
 ---
 
 ## Огляд

package/rules/style/quasar_fixes/main.mjs

@@ -21,8 +21,8 @@ const FIXES = [
  * `<q-scroll-area>` або `<q-tooltip>`, у `.scss`/`.css`/`.vue` має бути відповідний
  * CSS-фікс (guide: `quasar_fixes.mdc`). Крос-файлова перевірка usage↔definition —
  * потребує whole-repo сканування незалежно від `ctx.files`.
- * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст lint-прогону (cwd)
- * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} результат зі зібраними violations
+ * @param {import('@7n/rules/scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст lint-прогону (cwd)
+ * @returns {Promise<import('@7n/rules/scripts/lib/lint-surface/types.mjs').LintResult>} результат зі зібраними violations
  */
 export async function lint(ctx) {
   const reporter = createViolationReporter(ctx)

package/rules/style/tooling/docs/fix-tooling.md

@@ -3,7 +3,7 @@ type: JS Module
 title: fix-tooling.mjs
 resource: plugins/lang-js/rules/style/tooling/fix-tooling.mjs
 docgen:
-  crc: a25e47d2
+  crc: 033af5f9
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   issues: judge:inaccurate:0.98

package/rules/style/tooling/docs/main.md

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: plugins/lang-js/rules/style/tooling/main.mjs
 docgen:
-  crc: c96a4b01
+  crc: aeb36134
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 90
   issues: anchor-miss:extensions.json,anchor-miss:settings.json,judge:inaccurate:0.99

package/rules/style/tooling/fix-tooling.mjs

@@ -12,7 +12,7 @@ const STYLELINTIGNORE_MISSING_RE = /\.stylelintignore не існує/u
 const STYLELINTIGNORE_NO_DIST_RE = /\.stylelintignore не містить рядка dist\//u
 const NO_STYLELINT_CONFIG_RE = /Немає конфігу stylelint/u
 
-/** @type {import('../../../scripts/lib/lint-surface/types.mjs').T0Pattern[]} */
+/** @type {import('@7n/rules/scripts/lib/lint-surface/types.mjs').T0Pattern[]} */
 export const patterns = [
   {
     id: 'style-stylelintignore-create',

package/rules/style/tooling/main.mjs

@@ -45,8 +45,8 @@ async function checkStylelintConfigPresence(reporter, cwd) {
 
 /**
  * Перевіряє відповідність проєкту правилам style.mdc
- * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст lint-прогону (cwd тощо)
- * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} результат зі зібраними violations
+ * @param {import('@7n/rules/scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст lint-прогону (cwd тощо)
+ * @returns {Promise<import('@7n/rules/scripts/lib/lint-surface/types.mjs').LintResult>} результат зі зібраними violations
  */
 export async function lint(ctx) {
   const cwd = ctx.cwd

package/rules/test/docs/index.md

@@ -0,0 +1,11 @@
+---
+type: Directory Index
+title: npm/rules/test
+resource: plugins/lang-js/rules/test/
+---
+
+# npm/rules/test
+
+| Файл                | Тип       |
+| ------------------- | --------- |
+| [main.mjs](main.md) | JS Module |

package/rules/test/lib/collect-test-file-offenders.mjs

@@ -0,0 +1,49 @@
+/** @see ../docs/collect-test-file-offenders.md */
+import { readFile } from 'node:fs/promises'
+import { basename, relative } from 'node:path'
+
+import { loadCursorIgnorePaths } from '@7n/rules/scripts/lib/load-cursor-config.mjs'
+import { walkDir } from '@7n/rules/scripts/utils/walkDir.mjs'
+
+/**
+ * Чи файл — JS-тест (`*.test.mjs` / `*.test.js`).
+ * @param {string} absPath абсолютний шлях
+ * @returns {boolean} `true` для `.test.{mjs,js}` файлів
+ */
+export function isTestFile(absPath) {
+  const name = basename(absPath)
+  return name.endsWith('.test.mjs') || name.endsWith('.test.js')
+}
+
+/**
+ * Обходить репо (поважаючи `.n-rules.json:ignore`), збирає `*.test.{mjs,js}` файли
+ * і прогонить кожен через `findOffenders(body)` — спільний скелет для per-file
+ * regex/parse-based test-конвенцій (напр. `no-console-store-restore`, `vitest-api-conventions`).
+ * @param {string} cwd корінь репозиторію
+ * @param {(body: string) => Array<{line: number}>} findOffenders детектор порушень у тілі файлу
+ * @returns {Promise<{ testFiles: string[], offenders: Array<{file: string, line: number}> }>} усі тестові файли й знайдені порушення (з relative-шляхом)
+ */
+export async function collectTestFileOffenders(cwd, findOffenders) {
+  const ignorePaths = await loadCursorIgnorePaths(cwd)
+
+  /** @type {string[]} */
+  const testFiles = []
+  await walkDir(
+    cwd,
+    absPath => {
+      if (isTestFile(absPath)) testFiles.push(absPath)
+    },
+    ignorePaths
+  )
+
+  /** @type {Array<{file: string, line: number}>} */
+  const offenders = []
+  for (const absPath of testFiles) {
+    const body = await readFile(absPath, 'utf8')
+    for (const o of findOffenders(body)) {
+      offenders.push({ file: relative(cwd, absPath), ...o })
+    }
+  }
+
+  return { testFiles, offenders }
+}

package/rules/test/lib/docs/collect-test-file-offenders.md

@@ -0,0 +1,29 @@
+---
+type: JS Module
+title: collect-test-file-offenders.mjs
+resource: plugins/lang-js/rules/test/lib/collect-test-file-offenders.mjs
+docgen:
+  crc: bf54977d
+  model: openai-codex/gpt-5.4-mini
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Файл знаходить JS-тести `*.test.mjs` і `*.test.js` у репозиторії з урахуванням `.n-rules.json` та повертає для кожного з них відносні шляхи до offenders. Це дає змогу окремо перевіряти, які саме тестові файли виходять за межі правил проєкту, без додаткового парсингу чи нормалізації результату.
+
+## Поведінка
+
+- `isTestFile` — визначає, чи шлях належить до JS-тесту `*.test.mjs` або `*.test.js`.
+- `collectTestFileOffenders` — знаходить усі тестові файли в репозиторії з урахуванням `.n-rules.json` та збирає для них знайдені порушення з відносними шляхами.
+
+## Публічний API
+
+- isTestFile — Розпізнає JS-файли з тестовою назвою `*.test.mjs` або `*.test.js`.
+- collectTestFileOffenders — Обходить репозиторій з урахуванням `.n-rules.json:ignore`, знаходить `*.test.{mjs,js}` і проганяє кожен файл через `findOffenders` для спільних test-конвенцій на кшталт `no-console-store-restore` і `vitest-api-conventions`.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/test/lib/docs/index.md

@@ -0,0 +1,9 @@
+---
+type: Directory Index
+title: npm/rules/test/lib
+resource: plugins/lang-js/rules/test/lib/
+---
+
+| Файл                                                              | Тип       |
+| ----------------------------------------------------------------- | --------- |
+| [collect-test-file-offenders.mjs](collect-test-file-offenders.md) | JS Module |

package/rules/test/location/concern.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
+  "fixability": "structural",
+  "lint": {
+    "scope": "full",
+    "glob": ["**/*.test.mjs"]
+  }
+}

package/rules/test/location/docs/index.md

@@ -0,0 +1,11 @@
+---
+type: Directory Index
+title: npm/rules/test/location
+resource: plugins/lang-js/rules/test/location/
+---
+
+# npm/rules/test/location
+
+| Файл                | Тип       |
+| ------------------- | --------- |
+| [main.mjs](main.md) | JS Module |

package/rules/test/location/docs/main.md

@@ -0,0 +1,36 @@
+---
+type: JS Module
+title: main.mjs
+resource: plugins/lang-js/rules/test/location/main.mjs
+docgen:
+  crc: 88077b29
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+  issues: judge:inaccurate:0.99
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Огляд
+Файл гарантує відповідність усіх тестових файлів встановленому розташуванню. Він сканує репозиторій, щоб підтвердити, що всі файли з розширенням `*.test.mjs` знаходяться у директорії `tests`.
+
+Поведінка
+Запускає `main` для перевірки коректності розташування всіх тестових файлів (`*.test.mjs`). Сканує репозиторій, ігноруючи директорії, визначені у конфігурації. Для кожного тестового файлу перевіряє його наявність у каталозі `tests`. Якщо тест виявлено поза директорією `tests`, фіксується його повний відносний шлях. У випадку відсутності порушень, інформується, що всі тестові файли розташовані коректно (test.mdc). Якщо виявлено порушення, для кожного файлу, що не відповідає правилам (test.mdc), повідомляється його шлях та необхідність переміщення до відповідної піддиректорії `tests`.
+
+## Поведінка
+
+1. Запускає `main` для перевірки розташування всіх тестових файлів з розширенням `*.test.mjs`.
+2. Сканує репозиторій, ігноруючи директорії, вказані в конфігурації.
+3. Для кожного знайденого тестового файлу перевіряє, чи він знаходиться в каталозі з назвою `tests`.
+4. Якщо тест знайдено поза директорією `tests`, фіксує його повний відносний шлях.
+5. Якщо порушень немає, повідомляє, що всі тестові файли розташовані коректно (test.mdc).
+6. Якщо порушення виявлено, для кожного файлу, що порушує правила (test.mdc), повідомляє шлях та вказує, що тест має бути переміщено до відповідної піддиректорії `tests`.
+
+## Публічний API
+
+- main — Встановлює, чи знаходяться файли, призначені для тестування, у відповідному каталозі `tests/` (test.mdc).
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/test/location/location.mdc

@@ -0,0 +1,52 @@
+## Розміщення тестових файлів у каталозі `tests/`
+
+JS-тести у пакеті лежать у **піддиректорії `tests/`** поряд із кодом, який тестується, а **не безпосередньо біля джерельного файлу**.
+
+```
+rules/foo/js/bar/
+├── check.mjs               ← JS-джерело
+└── tests/
+    └── check.test.mjs      ← тест check.mjs
+```
+
+**Чому так:**
+
+- Каталог-з-кодом залишається чистим: продакшен-модулі, политики, темплейти не миготять серед тестових файлів.
+- Один погляд на дерево показує, що піде у npm tarball (все, крім `tests/` і `__fixtures__/` — їх ловить `package.json#files` через негативні globs).
+- Якщо тест переростає у мульти-файловий — він уже у власному каталозі, без хаотичного розкидання.
+
+**Виняток — Rego unit-тести (`*_test.rego`):** лишаються **поряд із полісі-файлом** відповідно до загальноприйнятого OPA/Conftest community-патерну. `conftest verify -p <dir>` рекурсивно підхоплює їх незалежно від місця в каталозі.
+
+```
+rules/foo/policy/package_json/
+├── package_json.rego       ← Rego-правило
+├── package_json_test.rego  ← Rego unit-тести (поряд, не у tests/)
+└── target.json
+```
+
+**Спеціальні випадки:**
+
+- **Integration-тести на рівні пакета** — у `<root>/tests/` (наприклад `npm/tests/`). Це не «біля файлу», а виокремлений каталог для тестів, що покривають весь пакет.
+- **Fixtures**: `__fixtures__/` (для shared) і `fixtures/` (для rule-specific) також живуть **усередині `tests/`**: `tests/__fixtures__/...` і `tests/fixtures/...`.
+- **Test helpers** (`test-helpers.mjs`) можуть лишатися у `scripts/utils/` як shared infra — конвенція стосується файлів `*.test.mjs`.
+
+**Гарантії tarball-чистоти** через `package.json#files`:
+
+```json
+"files": [
+  "...",
+  "!**/*.test.mjs",
+  "!**/*_test.rego",
+  "!**/__fixtures__/**",
+  "!**/fixtures/**",
+  "!**/test-helpers.mjs"
+]
+```
+
+Recursive globs ловлять файли всередині `tests/` так само, як ловили б їх біля джерела.
+
+`npx @7n/rules fix test` (concern `location`) проходить деревом пакета й перевіряє: **кожен `*.test.mjs` файл лежить усередині каталогу з ім'ям `tests`** (точне співпадіння басенейму батьківської директорії). Файли поза цим каталогом репортуються з порадою куди їх перенести.
+
+`*_test.rego` перевіркою **не охоплюються** — вони не переміщуються.
+
+Пропускаються: `node_modules`, `.git`, `dist`, `build`, `.venv`, `venv`, шляхи з `.n-rules.json:ignore`.

package/rules/test/location/main.mjs

@@ -0,0 +1,70 @@
+/** @see ./docs/location.md */
+import { basename, dirname, relative } from 'node:path'
+
+import { createViolationReporter } from '@7n/rules/scripts/lib/lint-surface/violation-reporter.mjs'
+import { loadCursorIgnorePaths } from '@7n/rules/scripts/lib/load-cursor-config.mjs'
+import { walkDir } from '@7n/rules/scripts/utils/walkDir.mjs'
+
+const TESTS_DIR_NAME = 'tests'
+
+/**
+ * Чи файл є JS-тестом (`*.test.mjs`).
+ * @param {string} absPath абсолютний шлях
+ * @returns {boolean} true для шляхів із суфіксом `.test.mjs`
+ */
+function isTestFile(absPath) {
+  return basename(absPath).endsWith('.test.mjs')
+}
+
+/**
+ * Перевіряє, чи лежить тест у каталозі з іменем `tests`.
+ * @param {string} absPath абсолютний шлях до тесту
+ * @returns {boolean} `true`, якщо басенейм батьківської директорії — `tests`
+ */
+function isInsideTestsDir(absPath) {
+  return basename(dirname(absPath)) === TESTS_DIR_NAME
+}
+
+/**
+ * Перевіряє розміщення тестових файлів у каталозі `tests/` (test.mdc).
+ * @param {import('@7n/rules/scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст lint-прогону
+ * @returns {Promise<import('@7n/rules/scripts/lib/lint-surface/types.mjs').LintResult>} результат перевірки
+ */
+export async function lint(ctx) {
+  const reporter = createViolationReporter(ctx)
+  const { pass, fail } = reporter
+
+  const cwd = ctx.cwd
+  const ignorePaths = await loadCursorIgnorePaths(cwd)
+
+  /** @type {string[]} */
+  const offenders = []
+  let totalTests = 0
+
+  await walkDir(
+    cwd,
+    absPath => {
+      if (!isTestFile(absPath)) {
+        return
+      }
+      totalTests++
+      if (!isInsideTestsDir(absPath)) {
+        offenders.push(relative(cwd, absPath))
+      }
+    },
+    ignorePaths
+  )
+
+  if (offenders.length === 0) {
+    pass(`Всі ${totalTests} файлів *.test.mjs у каталозі tests/ (test.mdc)`)
+    return reporter.result()
+  }
+
+  for (const offenderPath of offenders) {
+    const parentDir = dirname(offenderPath)
+    const base = basename(offenderPath)
+    fail(`${offenderPath}: тест має лежати у tests/ — перенеси у ${parentDir}/${TESTS_DIR_NAME}/${base} (test.mdc)`)
+  }
+
+  return reporter.result()
+}

package/rules/test/main.json

@@ -0,0 +1 @@
+{ "auto": "завжди" }

package/rules/test/main.mdc

@@ -0,0 +1,26 @@
+---
+description: JS-тести (*.test.mjs) живуть у tests/. Правило `test` керує stryker.config.mjs + vitest.config.mjs (конфіг cargo-mutants — концерн cargo_mutants_config правила rust у @7n/rules-lang-rust).
+version: '2.8'
+globs: "**/{.n-rules.json,package.json,stryker.config.mjs,vitest.config.mjs,vitest.config.js},**/*.test.mjs"
+alwaysApply: false
+---
+
+Правило **test** керує розміщенням тестових файлів, безпекою ізоляції тестів (заборона `process.chdir`, відносних шляхів у FS, ручного store/restore console), налаштуванням Vitest/Stryker baseline. Конфігурація cargo-mutants для Rust — концерн `cargo_mutants_config` правила `rust` (@7n/rules-lang-rust).
+
+## Покриття + мутаційне тестування
+
+Канонічна команда — `npx @7n/test coverage` (пакет `@7n/test`, **не** `@7n/rules` — цей пакет лише постачає providers, оркестратор живе окремо): збирає метрики покриття (`vitest run --coverage`, `cargo llvm-cov` тощо) і мутаційного тестування (Stryker з vitest-runner + `coverageAnalysis: 'perTest'`, `cargo-mutants`) з усіх активних провайдерів у `.n-rules.json#rules` і пише `COVERAGE.md` у корінь проєкту.
+
+**Scoped-режим `--changed`:** `npx @7n/test coverage --changed` звужує scope до файлів, змінених від git merge-base поточної гілки з `main` або `origin/main`. У changed-режимі `COVERAGE.md` **не** перезаписується і LLM-класифікація не запускається.
+
+**`--fix`:** `npx @7n/test coverage --fix` — після збору метрик агент виправляє survived-мутанти й повторює coverage.
+
+Провайдери живуть у `npm/rules/<rule>/coverage/coverage.mjs` (цей пакет, `@7n/rules`). Оркестратор — у `@7n/test` (`npm/src/coverage/coverage.mjs`), який резолвить providers з `node_modules/@7n/rules/rules`. Проєкт-споживач має мати `@7n/test` як devDependency, аби `npx @7n/test coverage` резолвився без мережевого fetch щоразу.
+
+У `package.json` (корінь) має бути `scripts.coverage` із викликом `npx @7n/test coverage`.
+
+### Multi-workspace iteration
+
+У monorepo `@7n/test coverage` ітерує усі workspaces з власним `package.json` і агрегує метрики lcov + Stryker у єдиний `JS`-рядок `COVERAGE.md`. Workspace без тестів пропускається без помилки.
+
+- [package.json.contains.json](./package_json/template/package.json.contains.json)

package/rules/test/no-bun-test-import/concern.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
+  "lint": {
+    "scope": "full",
+    "glob": ["**/*.test.mjs", "**/*.test.js"]
+  }
+}

package/rules/test/no-bun-test-import/docs/fix-no-bun-test-import.md

@@ -0,0 +1,30 @@
+---
+type: JS Module
+title: fix-no-bun-test-import.mjs
+resource: plugins/lang-js/rules/test/no-bun-test-import/fix-no-bun-test-import.mjs
+docgen:
+  crc: 06d778e7
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Цей файл забезпечує автоматичне виправлення імпортів у контексті `test/no-bun-test-import`. Він сканує файли та замінює декларації імпорту з `bun:test` на їхні еквіваленти з `vitest` (такі як `describe`, `test`, `it`, `expect`, `beforeEach`, `beforeAll`, `afterEach`, `afterAll`). Мета полягає в уніфікації тестового середовища за допомогою `vitest`. Зауважте, що імпорти, які містять `mock`, `spyOn` або `jest`, не підлягають автоматичній заміні, оскільки вони вимагають ручного коригування місць виклику API (`vi.fn`/`vi.spyOn`).
+
+## Поведінка
+
+Поведінка:
+1. Ініціалізувати процес автофіксу для виявлених порушень, пов'язаних із використанням `bun-test-import`.
+2. Ітеративно обробити кожен файл, у якому виявлено такі порушення.
+3. Для кожного файлу прочитати його вміст.
+4. Виявити імпорти з `bun:test`, які можуть бути замінені на еквівалент у `vitest`.
+5. Замінити ці імпорти з кінця файлу до початку, щоб уникнути зсуву позицій наступних матчів.
+6. Записати змінений вміст назад у файл.
+7. Після обробки всіх файлів повернути перелік змінених файлів та повідомлення про застосовані зміни.
+8. Використовувати наданий об'єкт `patterns` для визначення логіки обробки.
+
+## Гарантії поведінки
+
+- (специфічних машинно-виведених гарантій немає)

package/rules/test/no-bun-test-import/docs/index.md

@@ -0,0 +1,10 @@
+---
+type: Directory Index
+title: npm/rules/test/no-bun-test-import
+resource: plugins/lang-js/rules/test/no-bun-test-import/
+---
+
+| Файл                                                    | Тип       |
+| ------------------------------------------------------- | --------- |
+| [fix-no-bun-test-import.mjs](fix-no-bun-test-import.md) | JS Module |
+| [main.mjs](main.md)                                     | JS Module |