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

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 |

package/rules/test/no-console-store-restore/docs/main.md

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

package/rules/test/no-console-store-restore/main.mjs

@@ -0,0 +1,55 @@
+/** @see ./docs/no-console-store-restore.md */
+import { createViolationReporter } from '@7n/rules/scripts/lib/lint-surface/violation-reporter.mjs'
+import { collectTestFileOffenders } from '../lib/collect-test-file-offenders.mjs'
+
+/**
+ * Ловить пряме присвоєння `console.<method> = …` у `*.test.{js,mjs}`.
+ * `console.log = fn` — process-wide мутація; канон: `vi.spyOn(console, 'log')`.
+ * `(?!=)` виключає `==` та `===` (лише одиночний `=`).
+ */
+const CONSOLE_ASSIGN_RE =
+  /\bconsole\.(?:log|error|warn|info|debug|dir|table|trace|group|groupEnd|time|timeEnd)\s*=(?!=)/u
+
+/**
+ * Знаходить рядки з прямим присвоєнням `console.<method> = …`.
+ * @param {string} body вміст файлу
+ * @returns {Array<{line: number}>} знайдені порушення
+ */
+function findOffenders(body) {
+  const offenders = []
+  const lines = body.split('\n')
+  for (const [i, line] of lines.entries()) {
+    if (CONSOLE_ASSIGN_RE.test(line)) {
+      offenders.push({ line: i + 1 })
+    }
+  }
+  return offenders
+}
+
+/**
+ * Перевіряє, що жоден `*.test.{mjs,js}` файл не перевизначає `console.<method>`
+ * через пряме присвоєння. Канон — `vi.spyOn(console, 'log').mockReturnValue()`.
+ * @param {import('@7n/rules/scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст лінту.
+ * @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 { testFiles, offenders } = await collectTestFileOffenders(cwd, findOffenders)
+
+  if (offenders.length === 0) {
+    pass(`Жоден з ${testFiles.length} тестових файлів не присвоює console.<method> = … (test.mdc)`)
+    return reporter.result()
+  }
+
+  for (const { file, line } of offenders) {
+    fail(
+      `${file}:${line}: пряме присвоєння console.<method> = … заборонено — ` +
+        `використовуй vi.spyOn(console, 'method').mockReturnValue() (test.mdc, no-console-store-restore)`
+    )
+  }
+
+  return reporter.result()
+}

package/rules/test/no-console-store-restore/no-console-store-restore.mdc

@@ -0,0 +1,11 @@
+## Заборона ручного store/restore `console` у тестах
+
+`console.log` / `console.error` / `console.warn` — **process-wide** мутації, рівно як `process.cwd()`. Якщо тест перехоплює їх через `const orig = console.log; console.log = (...) => …; try { … } finally { console.log = orig }`, паралельний test файл у `pool: 'forks'` (різний процес) ізольований, але в межах **одного** процесу всі тести у файлі ділять єдиний `console`-об'єкт. Якщо try/finally не виконається (наприклад, асинхронна помилка повз `await`), restore не спрацює і наступні тести втрачають вивід.
+
+Тому:
+
+- **Канон**: `vi.spyOn(console, 'log').mockReturnValue()` (та аналоги для `error`/`warn`/`info`) + `afterEach(() => vi.restoreAllMocks())`. Vitest сам слідкує за scope mock-у і гарантовано відновлює оригінал між тестами, навіть якщо тест кинув виняток.
+- **Заборонено**: ручний store/restore (`const orig = console.log; console.log = stub`). Виняток — коли тест **необхідно** перехопити вивід **до** того, як завантажиться модуль із top-level-логуванням; у цьому випадку фіксуй pattern explicit-коментарем.
+- Якщо потрібен лог зі stub-ом — `const logs = []; vi.spyOn(console, 'log').mockImplementation((...args) => logs.push(args.join(' ')))`.
+
+**Перевірка** — концерн `no-console-store-restore` (`rules/test/js/no-console-store-restore.mjs`): AST-сканер, який ловить присвоєння `console.<method> = …` у `*.test.{js,mjs}`.

package/rules/test/no-process-chdir/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-process-chdir/docs/index.md

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

package/rules/test/no-process-chdir/docs/main.md

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

package/rules/test/no-process-chdir/main.mjs

@@ -0,0 +1,40 @@
+/** @see ./docs/no-process-chdir.md */
+import { readFile } from 'node:fs/promises'
+
+import { collectTestFiles, toRelPosix } from '@7n/rules/scripts/lib/collect-test-files.mjs'
+
+/** Шукаємо викликний паттерн з відкривною дужкою — не зачепить згадку у docstring. */
+const CHDIR_CALL_RE = /process\.chdir\s*\(/u
+
+/**
+ * Detector: жоден `*.test.{mjs,js}` не викликає `process.chdir(` (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')
+    if (!CHDIR_CALL_RE.test(body)) continue
+    const file = toRelPosix(cwd, absPath)
+    for (const [i, line] of body.split('\n').entries()) {
+      if (!CHDIR_CALL_RE.test(line)) continue
+      violations.push(
+        /** @type {Partial<import('@7n/rules/scripts/lib/lint-surface/types.mjs').LintViolation>} */ ({
+          reason: 'process-chdir-in-test',
+          message:
+            `${file}:${i + 1}: process.chdir() у тесті заборонений — використовуй ` +
+            'withTmpDir(async dir => …) + явні join(dir, …) + cwd: dir (test.mdc)',
+          file,
+          data: { line: i + 1 }
+        })
+      )
+    }
+  }
+
+  return { violations }
+}

package/rules/test/no-process-chdir/no-process-chdir.mdc

@@ -0,0 +1,15 @@
+## Заборона `process.chdir` у тестах
+
+`process.chdir(dir)` — **process-wide** мутація. Vitest за замовчуванням ставить `pool: 'threads'`, і всі workers ділять один процес: паралельний test file може перехопити cwd сусіда посеред FS- або `git`-операції. У реальному інциденті це призвело до того, що `git init`+`git commit` із tmp-фікстури потрапив у реальний робочий репозиторій і створив rogue commit з автором `test <test@test>`, знищивши `npm/package.json` / `CHANGELOG.md`.
+
+Тому:
+
+- **У тестах заборонено** `process.chdir(...)` напряму та будь-які хелпери, що його викликають (історичний `withTmpCwd` видалений у `1.28.0`).
+- Канон: `withTmpDir(async dir => { ... })` зі `scripts/utils/test-helpers.mjs` — створює tmpdir і передає **абсолютний** `dir` у callback **без** `process.chdir`.
+- Усі 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-сумісність).
+
+**Перевірка** (`rules/test/js/no-process-chdir.mjs`): сканує `**/*.test.{js,mjs}` і падає з ❌ на будь-яке вживання `process.chdir(`.
+
+**Кожен виклик `execFile`/`execFileSync`/`spawn`/`spawnSync`** у `*.test.{js,mjs}` приймає або **явний `{ cwd: dir }`** (де `dir` — змінна, не `process.cwd()`), або працює з **абсолютними шляхами** до бінарників/fixture-файлів. Це гарантує, що мутаційний test-flow у `pool: 'forks'` не страждає від implicit-`process.cwd()`-stride між тестами в одному воркері.

package/rules/test/no-relative-fs-path/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-relative-fs-path/docs/index.md

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

package/rules/test/no-relative-fs-path/docs/main.md

@@ -0,0 +1,34 @@
+---
+type: JS Module
+title: main.mjs
+resource: plugins/lang-js/rules/test/no-relative-fs-path/main.mjs
+docgen:
+  crc: b8f4b7aa
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 95
+  issues: anchor-miss:(test.mdc),judge:inaccurate:0.99
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+main функція забезпечує виконання основного логічного блоку програми. Вона відповідає за ініціалізацію системи та керує її життєвим циклом. Кешування даних здійснюється протягом одного виконання для підвищення продуктивності за рахунок уникнення повторних обчислень. Поведінка системи включає інтеграцію маркерів повідомлень відповідно до правил `test.mdc`.
+
+## Поведінка
+
+1. Викликати `main` для запуску перевірки.
+2. Система збирає список усіх файлів, що є тестовими (завершуються на `*.test.mjs` або `*.test.js`) у директорії проєкту та її підкаталогах.
+3. Для кожного знайденого тестового файлу система зчитує його вміст.
+4. Система аналізує вміст кожного тестового файлу, шукаючи виклики функцій з модулю `node:fs` або `node:fs/promises`, які приймають шляхи.
+5. При виявленні такого виклику система перевіряє, чи використовується як літеральний шлях (string literal або template literal без виразів) відносний шлях.
+6. Якщо відносний шлях знайдено, система фіксує місце порушення: ім'я файлу, номер рядка, назву функції та позицію аргументу.
+7. Якщо порушень не знайдено у жодному тестовому файлі, виконується фіксація успішного завершення перевірки.
+8. Якщо порушення знайдено, для кожного знайденого випадку система фіксує помилку, вказуючи, що використовується відносний шлях і що слід замінити його на обчислення за допомогою `join`.
+
+## Публічний API
+
+main — Гарантує, що тестові файли не використовують відносні шляхи як перший аргумент при виклику файлових операцій з `node:fs` або `node:fs/promises`.
+
+## Гарантії поведінки
+
+- Кешує результати в межах одного прогону.