@7n/rules-lang-js 0.5.0 → 0.7.0

package/rules/style/vscode_settings/vscode_settings.mdc

@@ -0,0 +1,19 @@
+## .vscode/settings.json: вимкнення вбудованих CSS/SCSS/Less валідаторів
+
+Rego-пакет: `style_lint.vscode_settings`
+
+Цільовий файл: `.vscode/settings.json`
+
+Leaf-by-leaf walker: перевіряє кожен ключ з template — його значення у `settings.json` має точно збігатися. Додаткові ключі у файлі — дозволені.
+
+Канонічний template: [settings.json.snippet.json](./template/settings.json.snippet.json)
+
+Обов'язкові значення:
+
+- `"css.validate": false`
+- `"less.validate": false`
+- `"scss.validate": false`
+
+**✓ Правильно** — усі три ключі присутні зі значенням `false`; можуть бути й інші ключі.
+
+**✗ Неправильно** — будь-який з ключів відсутній, має значення `true` або рядок (`"off"`).

package/rules/style/vscode_settings/vscode_settings.rego

@@ -0,0 +1,15 @@
+# Перевірка `.vscode/settings.json` для style (style.mdc).
+#
+# Канон надходить через --data: { "template": { "snippet": ... } }
+# Структура --data сформована з template/settings.json.snippet.json.
+# Top-level літеральні keys — leaf-by-leaf walker.
+package style.vscode_settings
+
+import rego.v1
+
+deny contains msg if {
+	some key, expected_value in data.template.snippet
+	actual := object.get(input, key, null)
+	actual != expected_value
+	msg := sprintf(".vscode/settings.json: \"%s\" має бути %v (style.mdc)", [key, expected_value])
+}

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 |

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

@@ -0,0 +1,35 @@
+---
+type: JS Module
+title: main.mjs
+resource: plugins/lang-js/rules/test/no-bun-test-import/main.mjs
+docgen:
+  crc: 379b9fee
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Огляд
+Цей компонент аналізує тестові файли проекту для модернізації тестового фреймворку. Він ідентифікує імпорти з `bun:test` та перевіряє їхню сумісність для потенційного переходу на `vitest`, згенерувавши відповідні порушення для виправлення.
+
+Поведінка
+findBunTestImports виявляє імпорти з `bun:test` у коді, визначаючи, які з них можуть бути безпечно замінені на `vitest`.
+lint перевіряє тестові файли на наявність імпортів з `bun:test`, генеруючи порушення, якщо імпорт не може бути автоматично виправлений (test.mdc).
+
+## Поведінка
+
+Поведінка
+findBunTestImports знаходить усі імпорти з `bun:test` у коді, визначаючи, які з них можуть бути безпечно замінені на `vitest`.
+lint перевіряє тестові файли на наявність імпортів з `bun:test`, генеруючи порушення, якщо імпорт не може бути автоматично виправлений (test.mdc).
+
+## Публічний API
+
+findBunTestImports — шукає усі імпорти з `bun:test` у коді файлу, щоб уникнути повторного аналізу.
+lint — гарантує, що тестові файли не імпортують модулі з `bun:test`, оскільки Vitest не може їх знайти.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/test/no-bun-test-import/fix-no-bun-test-import.mjs

@@ -0,0 +1,51 @@
+/**
+ * T0-autofix для `test/no-bun-test-import`: переписує `from 'bun:test'` на
+ * `from 'vitest'` у import-декларацій, чиї специфікатори мають прямий 1:1
+ * еквівалент у vitest (describe/test/it/expect/beforeEach/beforeAll/afterEach/afterAll). Import-и з
+ * mock/spyOn/jest тощо НЕ чіпаються — там потрібне ручне виправлення call-sites
+ * (`vi.fn`/`vi.spyOn` мають інший API за межами самого import), детектор лишає
+ * їх як violation для ручного/LLM-ladder фіксу.
+ */
+import { readFile, writeFile } from 'node:fs/promises'
+import { join } from 'node:path'
+
+import { findBunTestImports } from './main.mjs'
+
+const QUOTED_BUN_TEST_RE = /(['"])bun:test\1/u
+
+/** @type {import('@7n/rules/scripts/lib/lint-surface/types.mjs').T0Pattern[]} */
+export const patterns = [
+  {
+    id: 'rewrite-bun-test-import-to-vitest',
+    test: violations => violations.some(v => v.reason === 'bun-test-import' && v.data?.fixable),
+    apply: async (violations, ctx) => {
+      const files = [
+        ...new Set(violations.filter(v => v.reason === 'bun-test-import' && v.data?.fixable).map(v => v.file))
+      ]
+
+      const touchedFiles = []
+      for (const file of files) {
+        const absPath = join(ctx.cwd, file)
+        const content = await readFile(absPath, 'utf8')
+        const found = findBunTestImports(content)
+        if (found.length === 0) continue
+
+        let next = content
+        // Заміняємо з кінця файлу до початку, щоб офсети попередніх матчів не зсувались.
+        for (const imp of found.toReversed()) {
+          if (!imp.fixable) continue
+          const rewritten = imp.raw.replace(QUOTED_BUN_TEST_RE, (_match, quote) => `${quote}vitest${quote}`)
+          next = next.slice(0, imp.start) + rewritten + next.slice(imp.end)
+        }
+        if (next === content) continue
+
+        ctx.recordWrite?.(absPath)
+        await writeFile(absPath, next, 'utf8')
+        touchedFiles.push(absPath)
+      }
+
+      if (touchedFiles.length === 0) return { touchedFiles: [] }
+      return { touchedFiles, message: `bun:test → vitest: ${touchedFiles.join(', ')}` }
+    }
+  }
+]

package/rules/test/no-bun-test-import/main.mjs

@@ -0,0 +1,105 @@
+/** @see ./docs/no-bun-test-import.md */
+import { readFile } from 'node:fs/promises'
+
+import { collectTestFiles, toRelPosix } from '@7n/rules/scripts/lib/collect-test-files.mjs'
+
+/**
+ * Іменовані експорти `bun:test`, що мають прямий 1:1 еквівалент у vitest (той самий
+ * API, лише інше джерело пакета) — безпечно переписати джерело без чіпання call-sites.
+ * `mock`/`spyOn`/`jest` та інше НЕ входять сюди: у vitest вони живуть під `vi.*`
+ * namespace (`vi.fn`, `vi.spyOn`), тож переписування джерела без переписування
+ * call-sites дало б робочий import, але зламаний виклик — небезпечно для T0.
+ */
+const SAFE_SPECIFIERS = new Set([
+  'describe',
+  'test',
+  'it',
+  'expect',
+  'beforeEach',
+  'beforeAll',
+  'afterEach',
+  'afterAll'
+])
+
+/**
+ * Іменований import з `bun:test`; специфікатор-секція може бути багаторядковою.
+ * `[^}]*` замість `[\s\S]*?` — уникає super-linear backtracking (sonarjs) при `\s*`
+ * навколо групи: символьний клас без альтернативи backtrack-у на межі `}`.
+ */
+const BUN_TEST_IMPORT_RE = /import\s*\{([^}]*)\}\s*from\s*(['"])bun:test\2/gu
+/** Розділювач токенів специфікатора (замість `\s+as\s+`-regex, sonarjs/super-linear-regex). */
+const WHITESPACE_RE = /\s+/u
+
+/**
+ * Розбирає список іменованих специфікаторів `{ a, b as c }` на `{imported, local}`.
+ * @param {string} raw вміст фігурних дужок import-декларації
+ * @returns {{imported:string, local:string}[]} розібрані специфікатори
+ */
+function parseSpecifiers(raw) {
+  return raw
+    .split(',')
+    .map(s => s.trim())
+    .filter(Boolean)
+    .map(s => {
+      // Токенізація замість `\s+as\s+`-regex (sonarjs/super-linear-regex на подвійному `\s+`).
+      const tokens = s.split(WHITESPACE_RE).filter(Boolean)
+      const asIndex = tokens.indexOf('as')
+      const imported = asIndex === -1 ? tokens.join(' ') : tokens.slice(0, asIndex).join(' ')
+      const local = asIndex === -1 ? imported : tokens.slice(asIndex + 1).join(' ')
+      return { imported, local }
+    })
+}
+
+/**
+ * Знаходить усі `import { ... } from 'bun:test'` у вмісті файлу. Спільна логіка
+ * для detector-а (`lint`) і T0-фіксера (`fix-no-bun-test-import.mjs`) — уникаємо
+ * дублювання парсингу.
+ * @param {string} content вихідний код файлу
+ * @returns {{start:number, end:number, raw:string, specifiers:{imported:string,local:string}[], fixable:boolean}[]} знайдені import-декларації
+ */
+export function findBunTestImports(content) {
+  const matches = []
+  for (const m of content.matchAll(BUN_TEST_IMPORT_RE)) {
+    const specifiers = parseSpecifiers(m[1])
+    const fixable = specifiers.length > 0 && specifiers.every(s => SAFE_SPECIFIERS.has(s.imported))
+    matches.push({ start: m.index, end: m.index + m[0].length, raw: m[0], specifiers, fixable })
+  }
+  return matches
+}
+
+/**
+ * Detector: жоден `*.test.{mjs,js}` не імпортує з `bun:test` — vitest (яким
+ * запускається `@7n/test coverage` і `vitest run`) цей пакет не резолвить (test.mdc).
+ * @param {import('@7n/rules/scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст лінту (`cwd` тощо)
+ * @returns {Promise<import('@7n/rules/scripts/lib/lint-surface/types.mjs').LintResult>} результат лінту зі списком violations
+ */
+export async function lint(ctx) {
+  const { cwd } = ctx
+  const testFiles = await collectTestFiles(cwd)
+
+  /** @type {import('@7n/rules/scripts/lib/lint-surface/types.mjs').LintViolation[]} */
+  const violations = []
+  for (const absPath of testFiles) {
+    const body = await readFile(absPath, 'utf8')
+    const found = findBunTestImports(body)
+    if (found.length === 0) continue
+    const file = toRelPosix(cwd, absPath)
+    for (const imp of found) {
+      const line = body.slice(0, imp.start).split('\n').length
+      const specNames = imp.specifiers.map(s => s.imported).join(', ')
+      violations.push(
+        /** @type {Partial<import('@7n/rules/scripts/lib/lint-surface/types.mjs').LintViolation>} */ ({
+          reason: 'bun-test-import',
+          message: imp.fixable
+            ? `${file}:${line}: import з 'bun:test' — vitest не резолвить цей пакет; auto-fix перепише джерело на 'vitest' (test.mdc)`
+            : `${file}:${line}: import з 'bun:test' містить специфікатори без прямого 1:1 еквіваленту у vitest ` +
+              `(${specNames}) — потрібне ручне виправлення call-sites (vi.fn/vi.spyOn мають інший API) (test.mdc)`,
+          file,
+          data: { fixable: imp.fixable, specifiers: imp.specifiers.map(s => s.imported) }
+        })
+      )
+    }
+  }
+
+  return { violations }
+}

package/rules/test/no-bun-test-import/no-bun-test-import.mdc

@@ -0,0 +1,9 @@
+## Заборона `import ... from 'bun:test'`
+
+Тести проєкту виконуються через **vitest** (`vitest run`, а також `@7n/test coverage`, який ганяє `vitest run --coverage` + Stryker з `vitest-runner`) — `bun:test` там не резолвиться взагалі: `Cannot find package 'bun:test'`. Файл з таким імпортом ламає весь coverage/mutation-прогін workspace-а (реальні помилки не маскуються — одна `bun:test`-згадка валить весь `@7n/test coverage`).
+
+- **Заборонено** `import { ... } from 'bun:test'` у будь-якому `*.test.{mjs,js}`.
+- **Auto-fix (T0):** якщо всі імпортовані специфікатори мають прямий 1:1 еквівалент у vitest — `describe`, `test`, `it`, `expect`, `beforeEach`, `beforeAll`, `afterEach`, `afterAll` — джерело переписується на `'vitest'` без зміни специфікаторів чи call-sites.
+- **Без auto-fix:** якщо import містить `mock`, `spyOn`, `jest` чи інший специфікатор без прямого еквіваленту — T0 файл не чіпає. У vitest ці API живуть під `vi.*` namespace (`vi.fn()`, `vi.spyOn(...)`), тож самого перезапису джерела недостатньо — потрібне ручне (або LLM-ladder) виправлення call-sites. Violation залишається до фіксу.
+
+**Перевірка** (`rules/test/no-bun-test-import/main.mjs`): сканує `**/*.test.{mjs,js}`, шукає `import { ... } from 'bun:test'` (можливо багаторядковий), парсить специфікатори і визначає `fixable`.

package/rules/test/no-console-store-restore/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-console-store-restore/docs/index.md

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