@nitra/cursor 1.25.0 → 1.25.3

package/.pi-template/extensions/n-cursor-adr/index.ts

@@ -36,10 +36,7 @@ interface PiExec {
       timeout?: number
     }
   ) => Promise<{ code: number; stdout: string; stderr: string }>
-  on: (
-    event: string,
-    handler: (event: unknown, ctx: PiContext) => Promise<void> | void
-  ) => void
+  on: (event: string, handler: (event: unknown, ctx: PiContext) => Promise<void> | void) => void
 }
 
 const CAPTURE_HOOK = '.claude/hooks/capture-decisions.sh'
@@ -68,10 +65,7 @@ export default function (pi: PiExec): void {
       jsonlPath = join(tmpdir(), `n-cursor-pi-transcript-${Date.now()}-${randomUUID()}.jsonl`)
       writeFileSync(jsonlPath, lines + '\n', 'utf8')
     } catch (error) {
-      ctx.ui?.notify?.(
-        `@nitra/cursor: transcript serialization failed — ${(error as Error).message}`,
-        'error'
-      )
+      ctx.ui?.notify?.(`@nitra/cursor: transcript serialization failed — ${(error as Error).message}`, 'error')
       return
     }
 

package/CHANGELOG.md

@@ -4,86 +4,43 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
-## [1.25.0] - 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-конфіг` логу окремими записами.
-
-### Changed
-
-- **`.claude-template/hooks/{capture,normalize}-decisions.sh`** — обидва скрипти `source`-ять спільний `lib/tooling-only.sh` замість локальних копій функцій. Заголовок `# shellcheck source=lib/tooling-only.sh` тримає shellcheck-аналіз чистим.
+## [1.25.3] - 2026-05-26
 
 ### 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
-
-### 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.
+- **JSDoc**: дописано опис `@returns`/`@param`-описи й типи в `rules/js-lint/coverage/coverage.mjs`, `rules/k8s/js/manifests.mjs`, `rules/adr/js/tests/*.test.mjs`, `rules/test/js/tests/*.test.mjs`, `scripts/coverage-fix.mjs`, `scripts/post-tool-use-fix.mjs`, `scripts/utils/tests/resolve-*.test.mjs` (oxlint/eslint jsdoc-правила).
+- **`k8s/js/manifests.mjs`**: `JSON.parse(JSON.stringify(...))` → `structuredClone(...)` (unicorn `prefer-structured-clone`); інверсія негованої умови в `validateNetworkPolicyForWorkload` (eslint `no-negated-condition`).
+- **`k8s/policy/network_policy/network_policy.rego`**: `list_contains` → `contains_item` (regal `avoid-get-and-list-prefix`); `items[i] == item` → `some candidate in items` (`prefer-some-in-iteration`); `workload_kind` без зайвого `if {}` (`unconditional-assignment`); helper-правила переміщено після всіх `deny`, щоб задовольнити `messy-rule`. `network_policy_test.rego` переформатовано через `opa fmt`.
+- **`scripts/tests/post-tool-use-fix.test.mjs`**: fake-child перероблено з `EventEmitter` на duck-typed `addListener`/`removeListener` (unicorn `prefer-event-target`).
+- **`scripts/tests/cli-entry.test.mjs`**: symlink-тест /tmp ↔ /private/tmp використовує `mkdtempSync` з префіксом, зібраним з частин (sonarjs `publicly-writable-directories`).
+- **`rules/test/coverage/coverage.mjs`**: множинні `push()` об’єднано в один виклик (unicorn `prefer-single-call`).
+- Винесено повторно-компільовані regex у module scope (`e18e/prefer-static-regex`) у `coverage.mjs`, `test/coverage/tests/coverage.test.mjs`, `k8s/tests/manifests/tests/check-schema.test.mjs`.
+- Видалено невикористаний `npm/lib/x.js` (unicorn `no-empty-file`).
 
 ### 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-помилку; функціонально без змін.
+- **`.claude/hooks/{capture,normalize}-decisions.sh`** синхронізовано з `npm/.claude-template/hooks/` (включно з новим `lib/tooling-only.sh`).
+- **`knip.json`**: додано entry-патерни для динамічно імпортованих/зовнішніх скриптів (stryker configs, pi extensions, fixtures, `coverage-fix.mjs`); `@anthropic-ai/claude-code`, `@anthropic-ai/sdk`, `@stryker-mutator/core` додано в `ignoreDependencies` (тип-only або dynamic import).
+- **`.jscpd.json`**: ігнор-патерни розширено для template/canonical пар тієї ж природи, що вже були в винятках (`npm/.pi-template/**`, `knip-canonical.json`, `*.snippet.yaml`).
+- **`.cspell.json`**: до `ignorePaths` додано `**/reports/stryker/**` (генеровані Stryker-репорти, вже в .gitignore).
+- **Кореневий `package.json#scripts.lint`** — чейн `bun run lint-ga && lint-js && lint-rego && lint-security && lint-style && lint-text && oxfmt .` замість делегування до CLI (bun.mdc + security.mdc).
 
-## [1.23.0] - 2026-05-25
+## [1.25.2] - 2026-05-26
 
 ### 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 згенерована.
+- **`stryker.config.mjs` baseline**: `incremental: true` + `incrementalFile: 'reports/stryker/incremental.json'` — Stryker зберігає результати між запусками і відновлює після краш/kill (SIGURG). Важливо для машин з обмеженою RAM де Stryker вбивається системою після ~100 мутантів.
 
-## [1.22.0] - 2026-05-25
+## [1.25.1] - 2026-05-26
 
 ### 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
+- **`skills/coverage-fix/SKILL.md`** — автономна команда `/n-coverage-fix`: запускає `n-cursor coverage`, читає JSON-масив вижилих мутантів із секції `## Вижилі мутанти` у COVERAGE.md і ітеративно пише тести до конвергенції (max 3 ітерації). Включає заборону паралельного запуску (Stryker пише в одну директорію).
 
 ### 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.3",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",
@@ -10,10 +10,6 @@
     "n",
     "pi-package"
   ],
-  "pi": {
-    "skills": "skills",
-    "extensions": ".pi-template/extensions"
-  },
   "homepage": "https://github.com/n/cursor#readme",
   "bugs": {
     "url": "https://github.com/n/cursor/issues"
@@ -64,5 +60,9 @@
   "engines": {
     "bun": ">=1.3",
     "node": ">=25"
+  },
+  "pi": {
+    "skills": "skills",
+    "extensions": ".pi-template/extensions"
   }
 }

package/rules/js-lint/coverage/coverage.mjs

@@ -13,6 +13,9 @@ import { join } from 'node:path'
 
 import { resolveJsRoot } from '../../../scripts/utils/resolve-js-root.mjs'
 
+const TEST_BLOCK_START = /^\s*(it|test)\(/
+const FILE_EXTENSION = /\.[^.]+$/
+
 /**
  * Чи `scripts` містить coverage-сумісну команду.
  * @param {Record<string, string> | undefined} scripts секція scripts з package.json
@@ -89,13 +92,15 @@ export function extractFirstTestBlock(content) {
   let depth = 0
   let inBlock = false
   const result = []
-  for (let i = 0; i < lines.length; i++) {
-    if (startLine === -1 && /^\s*(it|test)\(/.test(lines[i])) startLine = i
+  for (const [i, line] of lines.entries()) {
+    if (startLine === -1 && TEST_BLOCK_START.test(line)) startLine = i
     if (startLine === -1) continue
-    result.push(lines[i])
-    for (const ch of lines[i]) {
-      if (ch === '{') { depth++; inBlock = true }
-      else if (ch === '}') depth--
+    result.push(line)
+    for (const ch of line) {
+      if (ch === '{') {
+        depth++
+        inBlock = true
+      } else if (ch === '}') depth--
     }
     if (inBlock && depth === 0) break
   }
@@ -110,7 +115,7 @@ export function extractFirstTestBlock(content) {
  * @returns {{testFile:string, code:string|null} | null} null — якщо тест-файл не знайдено
  */
 export function findExampleTest(jsRoot, filename) {
-  const base = filename.replace(/\.[^.]+$/, '')
+  const base = filename.replace(FILE_EXTENSION, '')
   const candidates = [`${base}.test.js`, `${base}.test.mjs`, `${base}.test.ts`]
   const lastSlash = base.lastIndexOf('/')
   if (lastSlash !== -1) {
@@ -131,9 +136,9 @@ export function findExampleTest(jsRoot, filename) {
  * Парс Stryker mutation.json: Killed+Timeout → caught; Survived+NoCoverage → до total.
  * Compile/Runtime errors виключаються з total.
  * Survived мутанти групуються по файлах з exampleTest.
- * @param {{files:Record<string,{mutants:Array<{status:string,mutatorName?:string,replacement?:string,location?:{start:{line:number,column:number},end:{line:number,column:number}}}>}>}} report
+ * @param {{files:Record<string,{mutants:Array<{status:string,mutatorName?:string,replacement?:string,location?:{start:{line:number,column:number},end:{line:number,column:number}}}>}>}} report Stryker mutation.json
  * @param {string|null} [jsRoot] корінь для читання source-рядків і пошуку тест-файлів
- * @returns {{caught:number,total:number,survived:Array<{file:string,mutants:Array<{line:number,col:number,mutantType:string,original:string,replacement:string}>,exampleTest:{testFile:string,code:string|null}|null,recommendationText:string|null}>}}
+ * @returns {{caught:number,total:number,survived:Array<{file:string,mutants:Array<{line:number,col:number,mutantType:string,original:string,replacement:string}>,exampleTest:{testFile:string,code:string|null}|null,recommendationText:string|null}>}} результат парсу: caught/total та згруповані survived мутанти
  */
 export function parseStrykerReport(report, jsRoot) {
   let caught = 0

package/rules/k8s/js/manifests.mjs

@@ -4245,7 +4245,7 @@ export function pdbManifestViolations(manifest, expectedAppLabel, isDevLike) {
 
 const NETWORK_POLICY_SNIPPET_URLS = {
   deployment: new URL('../policy/network_policy/template/deployment.snippet.yaml', import.meta.url),
-  statefulset: new URL('../policy/network_policy/template/statefulset.snippet.yaml', import.meta.url),
+  statefulset: new URL('../policy/network_policy/template/statefulset.snippet.yaml', import.meta.url)
 }
 
 /** @type {Record<string, Record<string, unknown>>} */
@@ -4256,7 +4256,7 @@ const _snippetCache = {}
  * Кожен snippet — повний самодостатній канон NetworkPolicy для своєї групи workload-типів
  * (без merge між snippets у runtime).
  * @param {'deployment' | 'statefulset'} snippetName ім'я сніпету
- * @returns {{ podSelector?: Record<string, unknown>, policyTypes?: string[], ingress?: unknown[], egress?: unknown[] }}
+ * @returns {{ podSelector?: Record<string, unknown>, policyTypes?: string[], ingress?: unknown[], egress?: unknown[] }} розпарсений spec
  */
 export function loadSnippetSpec(snippetName) {
   if (_snippetCache[snippetName]) return _snippetCache[snippetName]
@@ -4277,13 +4277,13 @@ export const KIND_TO_SNIPPET = {
   Job: 'deployment',
   CronJob: 'deployment',
   DaemonSet: 'deployment',
-  StatefulSet: 'statefulset',
+  StatefulSet: 'statefulset'
 }
 
 /**
  * Обирає snippet name для конкретного workload-kind; throws на невідомий.
  * @param {string} kind workload-kind
- * @returns {'deployment' | 'statefulset'}
+ * @returns {'deployment' | 'statefulset'} snippet name
  */
 export function snippetNameForKind(kind) {
   const name = KIND_TO_SNIPPET[kind]
@@ -4294,7 +4294,7 @@ export function snippetNameForKind(kind) {
 /**
  * Читає deployment.snippet.yaml і повертає розпарсений spec.
  * @deprecated Використовуй loadSnippetSpec('deployment')
- * @returns {{ podSelector: Record<string, unknown>, policyTypes: string[], ingress: unknown[], egress: unknown[] }}
+ * @returns {{ podSelector: Record<string, unknown>, policyTypes: string[], ingress: unknown[], egress: unknown[] }} розпарсений spec deployment snippet
  */
 export function readNetworkPolicySnippet() {
   return /** @type {any} */ (loadSnippetSpec('deployment'))
@@ -4312,9 +4312,11 @@ export function readNetworkPolicySnippet() {
 export function buildNetworkPolicyYaml(deployName, appLabel, kind) {
   const schemaUrl = `${YANNH_BASE}networkpolicy-networking-v1.json`
   const snippetName = snippetNameForKind(kind)
-  const spec = JSON.parse(JSON.stringify(loadSnippetSpec(snippetName)))
+  const spec = structuredClone(loadSnippetSpec(snippetName))
   spec.podSelector.matchLabels = { app: appLabel }
-  const specYaml = stringify(spec, { indent: 2 }).replaceAll(/^(?!$)/gm, '  ').trimEnd()
+  const specYaml = stringify(spec, { indent: 2 })
+    .replaceAll(/^(?!$)/gm, '  ')
+    .trimEnd()
   return `# yaml-language-server: $schema=${schemaUrl}
 apiVersion: networking.k8s.io/v1
 kind: NetworkPolicy
@@ -4326,7 +4328,6 @@ spec:
 ${specYaml}`
 }
 
-
 /**
  * Додає `resourceName` у `resources:` kustomization/Component YAML, якщо ще немає; сортує за алфавітом (en).
  * @param {string} raw вміст `kustomization.yaml`
@@ -5094,12 +5095,12 @@ function validateNetworkPolicyForWorkload(npDocs, workloadName, appLabel, worklo
   }
   const spec = /** @type {Record<string, unknown>} */ (matchedNp).spec
   const foundLabel = networkPolicyPodSelectorAppLabel(spec)
-  if (foundLabel !== appLabel) {
+  if (foundLabel === appLabel) {
+    passFn(`${npRel}: NetworkPolicy для ${workloadKind} '${workloadName}' валідний (k8s.mdc)`)
+  } else {
     fail(
       `${npRel}: NetworkPolicy '${workloadName}' spec.podSelector.matchLabels.app='${foundLabel}' не відповідає мітці workload '${appLabel}' (k8s.mdc)`
     )
-  } else {
-    passFn(`${npRel}: NetworkPolicy для ${workloadKind} '${workloadName}' валідний (k8s.mdc)`)
   }
 }
 
@@ -6379,12 +6380,14 @@ export async function regenerateLegacyNetworkPolicyDocsInFile(npAbs) {
     const spec = docRec.spec
     const appLabel = networkPolicyPodSelectorAppLabel(spec)
     const meta = docRec.metadata
-    const annotations = (meta !== null && typeof meta === 'object' && !Array.isArray(meta))
-      ? /** @type {Record<string, unknown>} */ (meta).annotations
-      : null
-    const rawKind = (annotations !== null && typeof annotations === 'object' && !Array.isArray(annotations))
-      ? /** @type {Record<string, unknown>} */ (annotations)['nitra.dev/workload-kind']
-      : null
+    const annotations =
+      meta !== null && typeof meta === 'object' && !Array.isArray(meta)
+        ? /** @type {Record<string, unknown>} */ (meta).annotations
+        : null
+    const rawKind =
+      annotations !== null && typeof annotations === 'object' && !Array.isArray(annotations)
+        ? /** @type {Record<string, unknown>} */ (annotations)['nitra.dev/workload-kind']
+        : null
     const kind = typeof rawKind === 'string' && rawKind !== '' ? rawKind : 'Deployment'
     if (typeof name === 'string' && name !== '' && appLabel !== '') specs.push({ name, appLabel, kind })
   }
@@ -6572,8 +6575,8 @@ function runAllK8sRego(root, yamlFiles, fail) {
       files: allYaml,
       templateData: {
         deployment_snippet: loadSnippetSpec('deployment'),
-        statefulset_snippet: loadSnippetSpec('statefulset'),
-      },
+        statefulset_snippet: loadSnippetSpec('statefulset')
+      }
     },
     { ns: 'k8s.kustomization', dir: 'k8s/kustomization', files: kustYaml },
     { ns: 'k8s.svc_yaml', dir: 'k8s/svc_yaml', files: svcYaml },
@@ -6584,7 +6587,12 @@ function runAllK8sRego(root, yamlFiles, fail) {
 
   for (const t of targets) {
     if (t.files.length === 0) continue
-    const violations = runConftestBatch({ policyDirRel: t.dir, namespace: t.ns, files: t.files, templateData: t.templateData })
+    const violations = runConftestBatch({
+      policyDirRel: t.dir,
+      namespace: t.ns,
+      files: t.files,
+      templateData: t.templateData
+    })
     for (const v of violations) {
       fail(`${relOf(v.filename)}: ${v.message}`)
     }

package/rules/k8s/policy/network_policy/network_policy.rego

@@ -72,31 +72,13 @@ deny contains "spec.ingress має містити from.podSelector (NetworkPolic
 	not ingress_has_pod_selector_rule(spec)
 }
 
-# Dispatch на повний canon-snippet за анотацією nitra.dev/workload-kind.
-# StatefulSet → statefulset_snippet (з intra-replica), решта → deployment_snippet.
-canon_for_kind("StatefulSet") := data.template.statefulset_snippet
-
-canon_for_kind(kind) := data.template.deployment_snippet if {
-	kind != "StatefulSet"
-}
-
-snippet_name_for_kind("StatefulSet") := "statefulset"
-
-snippet_name_for_kind(kind) := "deployment" if {
-	kind != "StatefulSet"
-}
-
-workload_kind := kind if {
-	kind := object.get(object.get(input.metadata, "annotations", {}), "nitra.dev/workload-kind", "")
-}
-
 # Superset-check egress: кожне канонічне правило має бути в input.spec.egress.
 deny contains msg if {
 	is_np_doc
 	is_object(object.get(input, "spec", null))
 	canon := canon_for_kind(workload_kind)
 	some canon_rule in canon.egress
-	not list_contains(object.get(input.spec, "egress", []), canon_rule)
+	not contains_item(object.get(input.spec, "egress", []), canon_rule)
 	msg := sprintf(
 		"NetworkPolicy %v: відсутнє обовʼязкове egress-правило (%v.snippet.yaml; k8s.mdc): %v",
 		[input.metadata.name, snippet_name_for_kind(workload_kind), json.marshal(canon_rule)],
@@ -109,7 +91,7 @@ deny contains msg if {
 	is_object(object.get(input, "spec", null))
 	canon := canon_for_kind(workload_kind)
 	some canon_rule in canon.ingress
-	not list_contains(object.get(input.spec, "ingress", []), canon_rule)
+	not contains_item(object.get(input.spec, "ingress", []), canon_rule)
 	msg := sprintf(
 		"NetworkPolicy %v: відсутнє обовʼязкове ingress-правило (%v.snippet.yaml; k8s.mdc): %v",
 		[input.metadata.name, snippet_name_for_kind(workload_kind), json.marshal(canon_rule)],
@@ -124,6 +106,22 @@ deny contains "spec.egress: заборонено allow-all {} — додавай
 	count(object.keys(rule)) == 0
 }
 
+# Dispatch на повний canon-snippet за анотацією nitra.dev/workload-kind.
+# StatefulSet → statefulset_snippet (з intra-replica), решта → deployment_snippet.
+canon_for_kind("StatefulSet") := data.template.statefulset_snippet
+
+canon_for_kind(kind) := data.template.deployment_snippet if {
+	kind != "StatefulSet"
+}
+
+snippet_name_for_kind("StatefulSet") := "statefulset"
+
+snippet_name_for_kind(kind) := "deployment" if {
+	kind != "StatefulSet"
+}
+
+workload_kind := object.get(object.get(input.metadata, "annotations", {}), "nitra.dev/workload-kind", "")
+
 is_np_doc if input.kind == "NetworkPolicy"
 
 is_np_doc if startswith(object.get(input, "apiVersion", ""), "networking.k8s.io/")
@@ -146,8 +144,8 @@ ingress_has_pod_selector_rule(spec) if {
 	object.get(peer, "podSelector", null) != null
 }
 
-list_contains(items, item) if {
+contains_item(items, item) if {
 	is_array(items)
-	some i
-	items[i] == item
+	some candidate in items
+	candidate == item
 }

package/rules/test/coverage/coverage.mjs

@@ -92,18 +92,15 @@ export function renderMarkdown(rows) {
 
   const allSurvived = rows.flatMap(r => r.survived ?? [])
   if (allSurvived.length > 0) {
-    lines.push('', '## Recommendations')
+    lines.push('', '## Вижилі мутанти', '', '```json', JSON.stringify(allSurvived, null, 2), '```')
+    // Людиночитабельна таблиця
     for (const group of allSurvived) {
-      lines.push('', `### ${group.file}`, '')
-      lines.push('| Рядок | Оригінал | Заміна | Тип |')
-      lines.push('| --- | --- | --- | --- |')
+      lines.push('', `### ${group.file}`, '', '| Рядок | Оригінал | Заміна | Тип |', '| --- | --- | --- | --- |')
       for (const m of group.mutants) {
         lines.push(`| ${m.line} | \`${m.original}\` | \`${m.replacement}\` | ${m.mutantType} |`)
       }
       if (group.exampleTest) {
-        lines.push('', `**Приклад тесту** (\`${group.exampleTest.testFile}\`):`, '', '```js')
-        lines.push(group.exampleTest.code ?? '')
-        lines.push('```')
+        lines.push('', `**Приклад тесту** (\`${group.exampleTest.testFile}\`):`, '', '```js', group.exampleTest.code ?? '', '```')
       }
       if (group.recommendationText) {
         lines.push('', '**Що треба протестувати:**', '', group.recommendationText)
@@ -184,9 +181,7 @@ export async function runCoverageSteps(opts = {}) {
   if (opts.fix) {
     const allSurvived = rows.flatMap(r => r.survived ?? [])
     // eslint-disable-next-line no-unsanitized/method -- шлях відносний до пакету, не user-input
-    const { fixSurvivedMutants } = await import(
-      new URL('../../scripts/coverage-fix.mjs', import.meta.url).href
-    )
+    const { fixSurvivedMutants } = await import(new URL('../../scripts/coverage-fix.mjs', import.meta.url).href)
     await fixSurvivedMutants(allSurvived, cwd)
   }
 

package/rules/test/js/cargo_mutants_config.mjs

@@ -42,9 +42,7 @@ export async function check() {
   }
 
   if (!existsSync(BASELINE_PATH)) {
-    reporter.fail(
-      `.cargo/mutants.toml canonical baseline не знайдено (${BASELINE_PATH}) — перевстанови @nitra/cursor`
-    )
+    reporter.fail(`.cargo/mutants.toml canonical baseline не знайдено (${BASELINE_PATH}) — перевстанови @nitra/cursor`)
     return reporter.getExitCode()
   }
 

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/rules/test/js/stryker_config.mjs

@@ -49,9 +49,7 @@ export async function check() {
   }
 
   if (!existsSync(BASELINE_PATH)) {
-    reporter.fail(
-      `stryker.config.mjs canonical baseline не знайдено (${BASELINE_PATH}) — перевстанови @nitra/cursor`
-    )
+    reporter.fail(`stryker.config.mjs canonical baseline не знайдено (${BASELINE_PATH}) — перевстанови @nitra/cursor`)
     return reporter.getExitCode()
   }
 

package/scripts/coverage-fix.mjs

@@ -39,7 +39,7 @@ export async function fixSurvivedMutants(survived, projectRoot) {
     options: {
       cwd: projectRoot,
       maxTurns: 20,
-      allowedTools: ['Read', 'Edit', 'Bash'],
+      allowedTools: ['Read', 'Edit', 'Bash']
     }
   })) {
     if (msg.type === 'text') process.stdout.write(msg.text)
@@ -50,9 +50,9 @@ export async function fixSurvivedMutants(survived, projectRoot) {
 /**
  * Формує rich-промпт для агента: список вижилих мутантів згрупований по файлах,
  * з контекстом ±3 рядки навколо кожного мутанта з source-файлу.
- * @param {SurvivedFileGroup[]} survived
- * @param {string} projectRoot
- * @returns {Promise<string>}
+ * @param {SurvivedFileGroup[]} survived групи вижилих мутантів по файлах
+ * @param {string} projectRoot корінь проєкту
+ * @returns {Promise<string>} текст rich-промпту
  */
 async function buildFixPrompt(survived, projectRoot) {
   const sections = []
@@ -60,25 +60,30 @@ async function buildFixPrompt(survived, projectRoot) {
   for (const { file, mutants, exampleTest } of survived) {
     let srcLines = []
     try {
-      srcLines = (await readFile(join(projectRoot, file), 'utf8')).split('\n')
+      const src = await readFile(join(projectRoot, file), 'utf8')
+      srcLines = src.split('\n')
     } catch {
       // файл може бути недоступним — пропускаємо контекст, але продовжуємо
     }
 
-    const mutantDescs = mutants.map(m => {
-      const ctxStart = Math.max(0, m.line - 4)
-      const ctxEnd = Math.min(srcLines.length, m.line + 3)
-      const context = srcLines
-        .slice(ctxStart, ctxEnd)
-        .map((l, i) => `${ctxStart + i + 1}: ${l}`)
-        .join('\n')
-      return [
-        `  - Рядок ${m.line}, колонка ${m.col}, тип мутації \`${m.mutantType}\``,
-        `    Оригінал: \`${m.original}\``,
-        `    Вижив варіант: \`${m.replacement}\``,
-        context ? `    Контекст:\n\`\`\`\n${context}\n\`\`\`` : ''
-      ].filter(Boolean).join('\n')
-    }).join('\n')
+    const mutantDescs = mutants
+      .map(m => {
+        const ctxStart = Math.max(0, m.line - 4)
+        const ctxEnd = Math.min(srcLines.length, m.line + 3)
+        const context = srcLines
+          .slice(ctxStart, ctxEnd)
+          .map((l, i) => `${ctxStart + i + 1}: ${l}`)
+          .join('\n')
+        return [
+          `  - Рядок ${m.line}, колонка ${m.col}, тип мутації \`${m.mutantType}\``,
+          `    Оригінал: \`${m.original}\``,
+          `    Вижив варіант: \`${m.replacement}\``,
+          context ? `    Контекст:\n\`\`\`\n${context}\n\`\`\`` : ''
+        ]
+          .filter(Boolean)
+          .join('\n')
+      })
+      .join('\n')
 
     const exampleSection = exampleTest?.code
       ? `\n\nПриклад тесту з \`${exampleTest.testFile}\`:\n\`\`\`js\n${exampleTest.code}\n\`\`\``

package/scripts/lib/timing-summary.mjs

@@ -58,9 +58,6 @@ export function formatTimingSummary(title, timings) {
     const failMark = ok ? '' : '  ❌'
     lines.push(`   ${id.padEnd(idWidth)}  ${formatDurationMs(ms)}${failMark}`)
   }
-  lines.push(
-    `   ${RULER.repeat(idWidth + 2 + 6)}`,
-    `   ${'total'.padEnd(idWidth)}  ${formatDurationMs(totalMs)}`
-  )
+  lines.push(`   ${RULER.repeat(idWidth + 2 + 6)}`, `   ${'total'.padEnd(idWidth)}  ${formatDurationMs(totalMs)}`)
   return `${lines.join('\n')}\n`
 }

package/scripts/post-tool-use-fix.mjs

@@ -104,7 +104,7 @@ function extractFilePath(stdinJson) {
  * Точка входу. Викликається з `bin/n-cursor.js` коли argv[0] === `post-tool-use-fix`.
  * Параметри ін'єктовні для тестів: `stdinJson` обходить read від `process.stdin`,
  * `spawnFn` — заміна `node:child_process.spawn` (повертає EventEmitter-сумісний об'єкт).
- * @param {{ stdinJson?: string, spawnFn?: typeof spawn }} [options]
+ * @param {{ stdinJson?: string, spawnFn?: typeof spawn }} [options] параметри для тестів (ін'єкція stdin/spawn)
  * @returns {Promise<number>} exit code (0 — пропущено / fix ОК; інше — exit-код `fix`)
  */
 export async function runPostToolUseFixCli(options = {}) {

package/scripts/sync-claude-config.mjs

@@ -502,7 +502,6 @@ export async function syncPiExtensions(projectRoot, bundledPackageRoot) {
  * Видаляє `.pi/extensions/n-cursor-adr/` директорію з проєкту-споживача.
  * Викликається коли правило `adr` вимкнено у `.n-cursor.json` (симетрично до
  * cleanup-у `.claude/hooks/{capture,normalize}-decisions.sh`).
- *
  * @param {string} projectRoot корінь проєкту-споживача
  * @returns {Promise<{ removed: boolean, path: string }>} чи було щось видалено та відносний шлях
  */

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

@@ -32,10 +32,12 @@ description: >-
 Прочитай `package.json` у кореневій директорії.
 
 **test-команда** (перша що існує):
+
 1. `scripts["test"]` з `package.json`
 2. fallback: `bun test`
 
 **coverage-команда** (перша що існує):
+
 1. `scripts["coverage"]` з `package.json` → виклик: `bun run coverage`
 2. fallback: `n-cursor coverage`
 
@@ -43,13 +45,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 +83,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>` і переконайся що всі тести проходять (виправ якщо падають)
 ```
 
@@ -100,6 +109,7 @@ bun run coverage  # або coverage-команда з кроку 2
 `newCount = новий масив.length`
 
 **Рішення:**
+
 - Якщо `newCount < prevCount` → повтор з Кроку 1 з оновленим масивом
 - Якщо `newCount >= prevCount` → зупинись:
   `✓ Конвергенція: mutation score більше не покращується. Вижило: <newCount> мутантів.`