@nitra/cursor 1.25.0 → 1.25.2

package/CHANGELOG.md

@@ -4,86 +4,22 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
-## [1.25.0] - 2026-05-26
+## [1.25.2] - 2026-05-26
 
 ### Added
 
-- **`.claude-template/hooks/lib/tooling-only.sh`** — спільний bash-helper із функціями `is_tooling_only_change` і `git_diff_only_version_field`. Source'ається з `capture-decisions.sh` і `normalize-decisions.sh` через `. "$SCRIPT_DIR/lib/tooling-only.sh"` — caller'и більше не дублюють ~27 рядків логіки розпізнавання "tooling-only" сесій. Bash 3.2 (macOS `/bin/bash`) сумісний.
-- **`syncAdrHookLibScripts(projectRoot, templateDir)`** у `npm/scripts/sync-claude-config.mjs` — копіює всі `*.sh` із `.claude-template/hooks/lib/` у `.claude/hooks/lib/` проєкту-споживача без exec-біта (source-only). Експортується разом із новою `removeOrphanAdrHookLib(projectRoot)` для cleanup-у при вимкненому `adr` правилі.
-- Поле `adrHookLib: string[]` у відповіді `syncClaudeConfig` — список синкнутих lib-файлів. `npm/bin/n-cursor.js` виводить їх у `🤖 Claude-конфіг` логу окремими записами.
+- **`stryker.config.mjs` baseline**: `incremental: true` + `incrementalFile: 'reports/stryker/incremental.json'` — Stryker зберігає результати між запусками і відновлює після краш/kill (SIGURG). Важливо для машин з обмеженою RAM де Stryker вбивається системою після ~100 мутантів.
 
-### Changed
-
-- **`.claude-template/hooks/{capture,normalize}-decisions.sh`** — обидва скрипти `source`-ять спільний `lib/tooling-only.sh` замість локальних копій функцій. Заголовок `# shellcheck source=lib/tooling-only.sh` тримає shellcheck-аналіз чистим.
-
-### Fixed
-
-- Усунено jscpd-дублікат `is_tooling_only_change`/`git_diff_only_version_field` між `capture-decisions.sh` і `normalize-decisions.sh` (~27 рядків / ~194 токени). Споживачам більше не потрібен ignore-запис для цих файлів у `.jscpd.json`.
-
-## [1.24.0] - 2026-05-26
+## [1.25.1] - 2026-05-26
 
 ### Added
 
-- **`.pi-template/extensions/n-cursor-adr/tsconfig.json`** — мінімальний TS-конфіг шаблону pi.dev extension, який синкається у `.pi/extensions/n-cursor-adr/` разом із `index.ts`. Дозволяє IDE/TS-серверу резолвити `node:*` модулі без project-wide tsconfig у проєкті-споживачі (`types: ["node"]`, `module/target: ES2022 + NodeNext`, `noEmit`, `isolatedModules`). Споживачу потрібен `@types/node` у devDeps (зазвичай уже є транзитивно).
-- **`pi` manifest у `npm/package.json`** — `{"skills":"skills","extensions":".pi-template/extensions"}`. Pi.dev під час `pi install npm:@nitra/cursor` тепер бачить explicit-шляхи до bundled-ресурсів, замість convention-auto-discovery. `extensions: ".pi-template/extensions"` критичний — pi за замовч. шукає `extensions/` у корені пакета, а у нас шлях нестандартний.
-- **`"pi-package"` keyword** у `npm/package.json` — пакет з’являється у pi-gallery для discoverability.
+- **`skills/coverage-fix/SKILL.md`** — автономна команда `/n-coverage-fix`: запускає `n-cursor coverage`, читає JSON-масив вижилих мутантів із секції `## Вижилі мутанти` у COVERAGE.md і ітеративно пише тести до конвергенції (max 3 ітерації). Включає заборону паралельного запуску (Stryker пише в одну директорію).
 
 ### Changed
 
-- **`syncPiExtensions`** тепер копіює **всі файли** з теки `.pi-template/extensions/<name>/`, а не лише `index.ts`. Контракт повернення: `{ written, path, files }` — `path` тепер тека (а не файл), `files` — відсортований список базових імен. У `🤖 Claude-конфіг` логу та у `result.piExtension` caller-стороні виводиться тека.
-- **`.pi-template/extensions/n-cursor-adr/index.ts`** — порядок імпортів виправлено (всі `node:*` імпорти підняті на самий верх, перед `interface PiContext`). Усувало `import/first` ESLint-помилку; функціонально без змін.
-
-## [1.23.0] - 2026-05-25
-
-### Added
-
-- **Pi.dev ADR hooks** — bundled TS-extension `npm/.pi-template/extensions/n-cursor-adr/index.ts` копіюється у `.pi/extensions/n-cursor-adr/index.ts` проєкту-споживача коли `adr` ∈ `.n-cursor.json#rules`. На pi `agent_end` event серіалізує `ctx.sessionManager.getEntries()` у Claude-сумісний JSONL у `tmpdir()`, спавнить існуючі `.claude/hooks/{capture,normalize}-decisions.sh` через `pi.exec` (async, `signal: ctx.signal`, timeouts 180s/600s). Жодного дублювання bash-логіки: skip/throttle/LLM-CLI-selection лишається у bash. Recursion guard через env-vars `CAPTURE_DECISIONS_RUNNING` / `ADR_NORMALIZE_RUNNING`, які bash виставляє перед спавном LLM CLI.
-- `npm/scripts/sync-claude-config.mjs`: експорт `PI_DIR`, `PI_EXTENSIONS_DIR`, `PI_TEMPLATE_DIR_NAME`, `PI_EXTENSION_NAME`; нова функція `syncPiExtensions(projectRoot, bundledPackageRoot)` (copy) і `removeOrphanPiExtension(projectRoot)` (cleanup); поле `piExtension: boolean` у відповіді `syncClaudeConfig` (gated на `adr` ∈ rules).
-- `npm/package.json` `files` array: додано `.pi-template` — bundled-директорія шипиться разом із пакетом.
-- `npm/bin/n-cursor.js`: у `🤖 Claude-конфіг`-логу після sync додається `.pi/extensions/n-cursor-adr/index.ts` коли pi-extension згенерована.
-
-## [1.22.0] - 2026-05-25
-
-### Added
-
-- **`npx @nitra/cursor lint`** — оркестратор лінт-ланцюжка з тайменгом на кожен крок. Послідовно запускає присутні у root `package.json` скрипти з фіксованого списку (`lint-ga`, `lint-js`, `lint-rego`, `lint-style`, `lint-text`, `lint-security`, `oxfmt`), **fail-fast** на першому ненульовому exit-коді. Наприкінці друкує таблицю `⏱ Lint timing` з часом кожного кроку — для атрибуції повільних кроків замість анонімного `&&`-агрегатора.
-- **`runFixCommand` тепер друкує `⏱ Fix timing`** після прогону всіх `rules/<id>/fix.mjs` — per-rule час + сума. Маркер `❌` на впалих рядках.
-- `npm/scripts/lib/timing-summary.mjs` — чистий форматер `formatTimingSummary(title, entries)` (спільний для fix і lint). 9 тестів у `tests/timing-summary.test.mjs`.
-- `npm/scripts/lib/run-lint-cli.mjs` — `runLintCli({ cwd, spawnSyncFn, now, log, logError })` з DI для юніт-тестів. 7 тестів у `tests/run-lint-cli.test.mjs`.
-
-### Changed
-
-- Кореневий `package.json` цього монорепо: `lint` → `n-cursor lint`; додано окремий скрипт `oxfmt: "oxfmt ."`, який раніше йшов у хвості ланцюжка прямою командою.
-- Скіли `/n-fix` і `/n-lint`: додано вимогу копіювати таблицю `⏱` з виводу інструмента у фінальне резюме відповіді користувачу.
-
-## [1.21.0] - 2026-05-25
-
-### Changed
-
-- **Stop-hook → PostToolUse з маршрутизацією за типом файла** (BREAKING для консьюмерів із кастомним `stop-hook` записом). `.claude-template/settings.template.json` тепер реєструє `PostToolUse` (matcher `Edit|Write|MultiEdit`, timeout 300) із командою `npx --no @nitra/cursor post-tool-use-fix` замість попереднього синхронного `Stop`-хука, що ганяв повний `fix` усіх правил на кожному turn-і. Новий хук читає `tool_input.file_path` зі stdin і запускає `fix` **лише** з релевантними правилами: `*.{mjs,js,cjs,ts,tsx,jsx}` → `js-lint`; `*.vue` → `js-lint style-lint vue`; `*.{css,scss,sass}` → `style-lint`; `**/k8s/**/*.{yaml,yml}` → `k8s`; `*.rego` → `rego`; `Dockerfile`/`*.Dockerfile` → `docker`; `.github/workflows/*.{yml,yaml}` → `ga`; `package.json` → `npm-module bun`; `*.sh` → `security`; `*.md` → `text` (поза `docs/adr/**` — там покриває async `normalize-decisions.sh`).
-- **CLI**: підкоманду `npx @nitra/cursor stop-hook` видалено; замість неї — `npx @nitra/cursor post-tool-use-fix`. `MANAGED_HOOK_COMMAND_MARKER` у `sync-claude-config.mjs` змінено на `@nitra/cursor post-tool-use-fix`; legacy-маркер `@nitra/cursor stop-hook` лишається у `MANAGED_HOOK_COMMAND_MARKERS` для автоматичного cleanup-у старих entries при наступному `npx @nitra/cursor`. `mergeHooks` тепер обходить union usually template+existing events, тому застарілі managed-групи у вже-непотрібних подіях (`Stop` у даному випадку) теж зачищаються.
-
-### Added
-
-- `npm/scripts/post-tool-use-fix.mjs` — реалізація `routeFilePathToRules(filePath)` (чиста функція, picomatch) і `runPostToolUseFixCli({ stdinJson, spawnFn })` (DI-friendly для тестів). 21 тест у `npm/scripts/tests/post-tool-use-fix.test.mjs`.
-- `LEGACY_STOP_HOOK_COMMAND_MARKER` — публічний export для тестів і потенційних консьюмерів, які перевіряють відсутність застарілого хука.
-
-### Removed
-
-- `npm/scripts/claude-stop-hook.mjs` — більше не потрібен.
-
-## [1.20.0] - 2026-05-25
-
-### Added
-
-- **NetworkPolicy: два повних канон-snippets**: `deployment.snippet.yaml` (для `Deployment`/`Job`/`CronJob`/`DaemonSet`) і `statefulset.snippet.yaml` (повний канон для `StatefulSet` з intra-replica правилами). Жодного runtime-merge — JS-генератор/rego обирають один за `kind` workload-у через анотацію `metadata.annotations['nitra.dev/workload-kind']`. Нові publiс exports: `loadSnippetSpec('deployment'|'statefulset')`, `KIND_TO_SNIPPET`, `snippetNameForKind(kind)`. `buildNetworkPolicyYaml(deployName, appLabel, kind)` — `kind` тепер обовʼязковий (throws на невідомий). Rego (`network_policy.rego`) робить superset-перевірку проти обраного канону; safety-net deny на allow-all `egress: [{}]`. GKE NodeLocal DNSCache: link-local `169.254.0.0/16` UDP/TCP 53 — у обох канонах. **Breaking** з v1.19.x: видалено `networkPolicyManifestViolations` (структуру тримає rego); `buildNetworkPolicyYaml` без `kind` тепер throws. Перейменування `common.snippet.yaml` → `deployment.snippet.yaml`; `data.template.snippet` → `data.template.deployment_snippet` у rego.
-- **`rules/js-lint/coverage`**: `parseStrykerReport` тепер зчитує оригінальний код вижилих мутантів (`extractOriginal`), групує по файлах і повертає `survived: [{file, mutants: [{line,col,mutantType,original,replacement}], exampleTest, recommendationText}]`; `findExampleTest` + `extractFirstTestBlock` знаходять і витягують перший тест-блок із тест-файлу поруч — для стилю.
-- **LLM-рекомендації у COVERAGE.md**: коли встановлено `ANTHROPIC_API_KEY`, `n-cursor coverage` робить один Anthropic API-виклик на кожен файл з вижилими мутантами та записує рекомендацію «Що треба протестувати» у секцію `## Recommendations`. Модель: `claude-haiku-4-5-20251001` з prompt caching (`ephemeral`). Без ключа — секція генерується без LLM-тексту.
-- **`rules/js-lint/coverage/lib/generate-recommendation.mjs`**: `generateMutantRecommendation(client, sourceContent, mutants)` — ізольований модуль LLM-виклику.
-- **`@anthropic-ai/sdk`** у dependencies — потрібен для LLM-рекомендацій (опціонально: якщо `ANTHROPIC_API_KEY` не задано, sdk не викликається).
-- **`rules/test/coverage`**: `renderMarkdown` генерує секцію `## Recommendations` з per-file підрозділами (`### <file>`) — таблиця мутантів + приклад тесту + LLM-текст (якщо є).
-- **Stryker incremental mode** у `stryker.config.baseline.mjs`: `incremental: true` + `incrementalFile: 'reports/stryker/stryker-incremental.json'` — Stryker зберігає прогрес між прогонами, відновлює стан після переривання (SIGURG, OOM тощо).
-- **`skills/coverage-fix`**: новий скіл `/n-coverage-fix` — читає `## Recommendations` з COVERAGE.md і ітеративно дописує тести до конвергенції mutation score, включаючи LLM-рекомендації та приклади тестів у промпт агента.
+- **`rules/test/coverage/coverage.mjs` → `renderMarkdown`**: секція вижилих мутантів перейменована `## Recommendations` → `## Вижилі мутанти`; доданий ` ```json ` блок з масивом survived перед таблицею — парситься скілами `/n-fix-tests` і `/n-coverage-fix`.
+- **`skills/fix-tests/SKILL.md`**: конвенція test-файлів оновлена — цільовий файл завжди `<dir>/tests/<basename>.test.mjs`; якщо знайдено co-located тест (`.test.js`/`.test.mjs`) — переноситься в `tests/` з оновленням imports.
 
 ## [1.19.2] - 2026-05-25
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "1.25.0",
+  "version": "1.25.2",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",

package/rules/test/coverage/coverage.mjs

@@ -92,7 +92,12 @@ export function renderMarkdown(rows) {
 
   const allSurvived = rows.flatMap(r => r.survived ?? [])
   if (allSurvived.length > 0) {
-    lines.push('', '## Recommendations')
+    lines.push('', '## Вижилі мутанти')
+    // JSON-блок для /n-fix-tests skill — парситься скілом для написання тестів
+    lines.push('', '```json')
+    lines.push(JSON.stringify(allSurvived, null, 2))
+    lines.push('```')
+    // Людиночитабельна таблиця
     for (const group of allSurvived) {
       lines.push('', `### ${group.file}`, '')
       lines.push('| Рядок | Оригінал | Заміна | Тип |')

package/rules/test/js/data/stryker_config/stryker.config.baseline.mjs

@@ -9,7 +9,7 @@ export default {
   reporters: ['json', 'clear-text'],
   jsonReporter: { fileName: 'reports/stryker/mutation.json' },
   coverageAnalysis: 'off',
-  // incremental: зберігає прогрес між прогонами — відновлення після переривання без старту з нуля.
+  // incremental: зберігає результати між запусками, відновлює після краш/kill.
   incremental: true,
-  incrementalFile: 'reports/stryker/stryker-incremental.json',
+  incrementalFile: 'reports/stryker/incremental.json',
 }

package/skills/coverage-fix/SKILL.md

@@ -1,114 +1,138 @@
 ---
 name: n-coverage-fix
 description: >-
-  Автономна команда: запускає coverage, читає ## Recommendations у COVERAGE.md, ітеративно пише тести для вижилих мутантів до конвергенції
+  Автономна команда: запускає n-cursor coverage → читає вижилих мутантів → ітеративно пише тести до конвергенції (max 3 ітерації)
 ---
 
-# /n-coverage-fix — ітеративне підвищення mutation score
+# n-coverage-fix — підвищення mutation score
 
-## Важливо
+## Мета
 
-⚠️ Не запускати паралельно з іншим `/n-coverage-fix` або `bun coverage` — Stryker пише `mutation.json` і `incremental.json` в одну директорію. `n-cursor coverage` всередині вже серіалізований через `withLock('coverage')`, але паралельний запуск двох ітерацій скілу зіпсує дані.
+Автоматично підвищити mutation score: запускає coverage, знаходить survived mutants, пише тести, повторює до конвергенції.
 
-## Мета
+## ⚠️ Не запускати паралельно
+
+Цей скіл **не можна** запускати паралельно в різних агентах або Bash-задачах.
 
-Автономно підвищити mutation score: запустити `bun coverage`, записати тести для вижилих мутантів, повторити до конвергенції (score перестав зростати).
+`n-cursor coverage` всередині серіалізований через `withLock('coverage')` — другий виклик чекатиме. Але Stryker пише `mutation.json` і `incremental.json` в одну директорію: паралельний запуск **зіпсує обидва файли**. Запускай тільки один `/n-coverage-fix` одночасно.
 
-## Алгоритм
+## Передумови
+
+- Поточна директорія — корінь проєкту (де `.n-cursor.json` і `COVERAGE.md`)
+- `n-cursor coverage` доступний (`npx @nitra/cursor coverage` або `bun run coverage`)
+- Залежності встановлені (`bun i`)
+
+## Workflow
 
 ### Крок 1: Запусти coverage
 
 ```bash
-bun coverage
+n-cursor coverage
 ```
 
-(або `bun run coverage` якщо команда у `package.json`)
+Або якщо є у `package.json#scripts`:
 
-Чекай завершення. Якщо команди немає у `package.json` — запусти `n-cursor coverage` з кореня.
+```bash
+bun run coverage
+```
+
+Ця команда генерує `COVERAGE.md`. Якщо є survived mutants — COVERAGE.md матиме секцію `## Вижилі мутанти` з JSON-блоком.
+
+### Крок 2: Перевір вижилих
 
-### Крок 2: Прочитай вижилих мутантів
+Прочитай `COVERAGE.md`. Знайди секцію `## Вижилі мутанти`. Знайди фенсований блок ` ```json ` і розпарси JSON-масив.
 
-Прочитай `COVERAGE.md` — знайди секцію `## Recommendations`.
+Якщо секція відсутня або масив порожній — зупинись:
 
-Якщо секції немає або вона порожня:
 ```
-✓ Нема вижилих мутантів — mutation score повний
+✓ Жодних вижилих мутантів — mutation score повний. Coverage завершено.
 ```
-→ DONE
 
-Запам'ятай поточний mutation score як `baseline_score` (рядок `| **Разом** |` з таблиці у COVERAGE.md).
+Запам'ятай `prevCount = масив.length`.
 
-### Крок 3: Для кожного файлу з Recommendations — пиши тести
+### Крок 3: Для кожного файлу — спауни Agent
 
-Для кожного `### <file>` у секції:
+Згрупуй мутанти по полю `file`. Для кожної групи:
 
-**3a. Читай контекст:**
-- Source-файл (`<file>` від кореня проєкту)
-- Таблицю вижилих мутантів: рядок, оригінал, заміна, тип
-- Блок `**Приклад наявного тесту:**` — style guide для нових тестів
+**3a. Визнач test файл (завжди у `tests/` директорії):**
 
-**3b. Знайди тестовий файл:**
-Перший що існує:
-1. `<dir>/<basename>.test.js` — поруч із source
-2. `<dir>/<basename>.spec.js`
-3. `test/<basename>.test.js` від кореня
-4. `tests/<basename>.test.js` від кореня
+Цільовий: `<dir>/tests/<basename>.test.mjs`
+(де `<dir>` — директорія source-файлу, `<basename>` — ім'я source без розширення)
 
-Якщо жоден не знайдено — створи `<dir>/<basename>.test.js` з правильними imports (орієнтуйся на сусідні файли).
+1. Якщо `<dir>/tests/<basename>.test.mjs` існує → використай
+2. Якщо `<dir>/<basename>.test.js` або `<dir>/<basename>.test.mjs` існує (co-located) →
+   - Перенеси до `<dir>/tests/<basename>.test.mjs`
+   - Оновити відносні imports (тепер `../` рівень вгору до source)
+3. Жоден не знайдено → буде створено `<dir>/tests/<basename>.test.mjs`
 
-**3c. Напиши тести що вбивають кожен мутант:**
+**3b. Сформуй промпт для Agent:**
+
+```
+Тобі дані вижилі мутанти зі Stryker для файлу `<file>`.
+Ці мутанти вижили бо наявні тести НЕ вловили конкретні зміни коду.
 
-Керуйся типом мутації:
-- `ConditionalExpression` (`→ false` / `→ true`): протестуй обидва branch явно — значення що робить умову `true` і значення що робить її `false`
-- `BooleanLiteral` (`true → false`): перевір початковий стан — `initialValue === false`
-- `LogicalOperator` (`&&` ↔ `||`): передай `null` та `undefined` **окремо**, перевір що результат різний для кожного
-- `StringLiteral` / `EqualityOperator`: перевір точний рядок/значення, а не лише happy-path
+**Вихідний код** (`<file>`):
+\`\`\`
+<зміст source-файлу>
+\`\`\`
 
+**Наявні тести** (`<test-file>`):
+\`\`\`
+<зміст test-файлу або "файл ще не існує">
+\`\`\`
+
+**Вижилі мутанти** (кожен — зміна коду що НЕ вловлена):
+<для кожного мутанта:>
+- Рядок <line>, колонка <col>: `<original>` → `<replacement>` (тип: <mutantType>)
+
+**Завдання:**
+Допиши мінімальні test-cases у файл `<test-file>` які вловлять кожен мутант.
 Правила:
 - НЕ видаляй і НЕ змінюй наявні тести
-- Стиль: той самий `describe`/`it`/`expect`, мова коментарів — як у прикладі тесту
-- Якщо `**Приклад наявного тесту:**` відсутній — орієнтуйся на інші test-файли у тій самій директорії
-
-**3d. Після написання тестів:**
-```bash
-bun test <testFile>
+- Стиль тестів — відповідно до наявного файлу (той самий фреймворк, describe/test)
+- Якщо файл ще не існує — створи `<dir>/tests/<basename>.test.mjs` з правильними імпортами.
+  Приклад: source `src/services/auth-store.js` → import `import { ... } from '../auth-store.js'`
+- Після написання запусти: `bun test <test-file>` і переконайся що тести проходять (виправ якщо падають, 1-2 спроби)
 ```
 
-Якщо FAIL — виправи саме ті тести що впали (до 2 спроб). Якщо не вдалося — логуй і переходь до наступного файлу.
+**3c. Запусти Agent** з цим промптом. Дочекайся завершення.
 
-### Крок 4: Перевір що весь suite проходить
+### Крок 4: Перевір що всі тести проходять
 
 ```bash
 bun test
 ```
 
-Якщо FAIL:
-- Не відкочувати зміни
-- Показати: яка помилка, які файли змінені, що вже покращено
-- Очікувати рішення від user: [виправити вручну → продовжити] / [пропустити файл] / [зупинити]
+Якщо падають — поверни відповідний Agent з помилкою і попроси виправити.
 
-### Крок 5: Запусти coverage і перевір конвергенцію
+### Крок 5: Запусти coverage і порівняй
 
 ```bash
-bun coverage
+n-cursor coverage
 ```
 
-Якщо CRASH (SIGURG, memory pressure): нагадати user — Stryker incremental зберіг прогрес, перезапустити `bun coverage`.
-
-Прочитай новий COVERAGE.md. Візьми `new_score` з рядка `| **Разом** |`.
+Прочитай новий `COVERAGE.md`. Розпарси JSON-масив вижилих.
+`newCount = новий масив.length`
 
 **Рішення:**
-- Якщо `new_score > baseline_score` → `baseline_score = new_score` → перейти до Кроку 2 (наступна ітерація)
-- Якщо `new_score <= baseline_score` → конвергенція:
+
+- `newCount < prevCount` AND iterations < 3 → повтор з Кроку 2 з оновленим масивом
+- `newCount >= prevCount` → конвергенція:
   ```
   ✓ Конвергенція: mutation score більше не покращується.
-  Baseline: <baseline_score> → Фінал: <new_score>
+  Було вижилих: <prevCount>, стало: <newCount>.
+  ```
+- iterations == 3 → зупинись:
+  ```
+  ⚠️ Досягнуто максимум ітерацій (3).
+  Вижило: <newCount> мутантів. Деякі можуть бути невбивними (dead code, external state).
   ```
-  → DONE
+
+## Конвергенція — нормальний результат
+
+Деякі мутанти неможливо вбити: захищений зовнішній стан, недетермінована логіка, еквівалентні мутації. Не намагайся виправити те що не змінилось після ітерації.
 
 ## Нотатки
 
 - Stryker `incremental` (`incrementalFile`) зберігає прогрес між запусками — crash ≠ перезапуск з нуля
 - Не комітити зміни автоматично — user вирішує коли комітити
-- Пріоритет файлів: більше вижилих мутантів = важливіший (першим у Recommendations = найважливіший)
-- Якщо `COVERAGE.md` відсутній — запусти `bun coverage` спочатку

package/skills/fix-tests/SKILL.md

@@ -43,13 +43,18 @@ description: >-
 
 Згрупуй мутанти по полю `file`. Для кожної групи виконай:
 
-**3a. Знайди файли:**
+**3a. Знайди / визнач test файл (завжди у `tests/` директорії):**
+
+Цільовий файл завжди: `<dir>/tests/<basename>.test.mjs`
+(де `<dir>` — директорія source-файлу, `<basename>` — ім'я без розширення)
+
 - Source: `<cwd>/<file>` (прочитай вміст)
-- Test файл (перший що існує):
-  - `<dir>/<basename>.test.<ext>` — поруч із source
-  - `<dir>/tests/<basename>.test.<ext>`
-  - `tests/<basename>.test.<ext>` від кореня
-  - Якщо жоден не знайдено — буде створено поруч із source
+- Test файл:
+  1. Якщо `<dir>/tests/<basename>.test.mjs` існує → використай його
+  2. Якщо `<dir>/<basename>.test.js` або `<dir>/<basename>.test.mjs` існує (co-located) →
+     - Перенеси файл до `<dir>/tests/<basename>.test.mjs`
+     - Оновити відносні `import` шляхи якщо є (тепер треба `../` рівень вгору)
+  3. Якщо жоден не знайдено → буде створено `<dir>/tests/<basename>.test.mjs`
 
 **3b. Сформуй промпт для Agent:**
 
@@ -76,7 +81,9 @@ description: >-
 Правила:
 - НЕ видаляй і НЕ змінюй наявні тести
 - Стиль тестів — відповідно до наявного файлу (той самий фреймворк, той самий стиль describe/test)
-- Якщо файл ще не існує — створи його з правильними імпортами відповідно до файлів у тому самому каталозі
+- Якщо файл ще не існує — створи `<dir>/tests/<basename>.test.mjs` з правильними імпортами.
+  Приклад: source `src/services/auth-store.js` → test `src/services/tests/auth-store.test.mjs`,
+  import: `import { ... } from '../auth-store.js'`
 - Після написання запусти: `bun test <test-file>` і переконайся що всі тести проходять (виправ якщо падають)
 ```