@nitra/cursor 1.22.0 → 1.24.0

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

@@ -0,0 +1,104 @@
+/**
+ * Pi.dev extension: ADR capture + normalize.
+ *
+ * На pi `agent_end` event серіалізує `ctx.sessionManager.getEntries()` у
+ * Claude-сумісний JSONL у tmpdir, формує stdin JSON і спавнить існуючі
+ * `.claude/hooks/{capture,normalize}-decisions.sh` через `pi.exec`.
+ *
+ * Логіка skip/throttle/LLM-CLI-selection лишається у bash — TS лише
+ * адаптер pi → bash. Recursion guard через env vars, що їх bash виставляє
+ * перед спавном LLM CLI.
+ */
+
+import { randomUUID } from 'node:crypto'
+import { writeFileSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+import { env } from 'node:process'
+
+interface PiContext {
+  cwd: string
+  sessionId?: string
+  signal?: AbortSignal
+  sessionManager: { getEntries(): Array<{ message?: { role?: string; content?: unknown } }> }
+  ui?: { notify?: (msg: string, level?: 'info' | 'warning' | 'error') => void }
+}
+
+interface PiExec {
+  exec: (
+    cmd: string,
+    args: string[],
+    opts?: {
+      cwd?: string
+      env?: Record<string, string>
+      input?: string
+      signal?: AbortSignal
+      timeout?: number
+    }
+  ) => Promise<{ code: number; stdout: string; stderr: string }>
+  on: (
+    event: string,
+    handler: (event: unknown, ctx: PiContext) => Promise<void> | void
+  ) => void
+}
+
+const CAPTURE_HOOK = '.claude/hooks/capture-decisions.sh'
+const NORMALIZE_HOOK = '.claude/hooks/normalize-decisions.sh'
+
+/**
+ * Pi extension entry point.
+ * @param {PiExec} pi pi.dev extension API
+ */
+export default function (pi: PiExec): void {
+  pi.on('agent_end', async (_event, ctx) => {
+    // Recursion guard: bash спавнить LLM CLI (claude/cursor-agent), той може
+    // стартувати pi-сесію. Bash виставляє ці env-vars перед спавном — child
+    // inheritance ловить рекурсивний trigger тут.
+    if (env.CAPTURE_DECISIONS_RUNNING || env.ADR_NORMALIZE_RUNNING) {
+      return
+    }
+
+    let jsonlPath: string
+    try {
+      const entries = ctx.sessionManager.getEntries()
+      const lines = entries
+        .filter(e => e.message?.role === 'user' || e.message?.role === 'assistant')
+        .map(e => JSON.stringify({ type: e.message?.role, message: e.message }))
+        .join('\n')
+      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'
+      )
+      return
+    }
+
+    const stdinPayload = JSON.stringify({
+      transcript_path: jsonlPath,
+      session_id: ctx.sessionId ?? randomUUID()
+    })
+
+    const envOverride = { ...env, CLAUDE_PROJECT_DIR: ctx.cwd } as Record<string, string>
+
+    // Async, не блокує agent_end. Якщо bash-скриптів немає (pi-only консьюмер
+    // із claude-config: false) — pi.exec поверне ENOENT, ловимо у allSettled.
+    await Promise.allSettled([
+      pi.exec('bash', [CAPTURE_HOOK], {
+        cwd: ctx.cwd,
+        env: envOverride,
+        input: stdinPayload,
+        signal: ctx.signal,
+        timeout: 180_000
+      }),
+      pi.exec('bash', [NORMALIZE_HOOK], {
+        cwd: ctx.cwd,
+        env: envOverride,
+        input: stdinPayload,
+        signal: ctx.signal,
+        timeout: 600_000
+      })
+    ])
+  })
+}

package/.pi-template/extensions/n-cursor-adr/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "$comment": "TS-конфіг для pi.dev extension. Не компілюється сам пакетом (синкається як є у .pi/extensions/<name>/), потрібен лише для IDE/TS-сервера у проєкті-споживачі, щоб резолвити node:* модулі. Споживачу треба мати @types/node у devDependencies (зазвичай уже є транзитивно).",
+  "compilerOptions": {
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "target": "ES2022",
+    "lib": ["ES2022"],
+    "types": ["node"],
+    "strict": true,
+    "noEmit": true,
+    "isolatedModules": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true
+  },
+  "include": ["index.ts"]
+}

package/CHANGELOG.md

@@ -4,6 +4,28 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
+## [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.
+
+### 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

package/bin/n-cursor.js

@@ -1402,6 +1402,7 @@ async function runSync() {
     if (result.adrHook) parts.push('.claude/hooks/capture-decisions.sh')
     if (result.adrNormalizeHook) parts.push('.claude/hooks/normalize-decisions.sh')
     if (result.gitignoreAdr) parts.push('.gitignore (adr fragment)')
+    if (result.piExtension) parts.push('.pi/extensions/n-cursor-adr/')
     if (parts.length > 0) {
       console.log(`🤖 Claude-конфіг: ${parts.join(', ')}`)
     }

package/package.json

@@ -1,14 +1,19 @@
 {
   "name": "@nitra/cursor",
-  "version": "1.22.0",
+  "version": "1.24.0",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",
     "cursor",
     "cursor-rules",
     "mdc",
-    "n"
+    "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"
@@ -31,6 +36,7 @@
     "scripts",
     "skills",
     ".claude-template",
+    ".pi-template",
     "AGENTS.template.md",
     "CHANGELOG.md",
     "!**/*.test.mjs",

package/scripts/lib/run-lint-cli.mjs

@@ -41,7 +41,6 @@ export const LINT_SCRIPTS = /** @type {const} */ ([
 /**
  * Читає `scripts` з `package.json` у заданій теці. Повертає `null`, якщо файла немає, JSON
  * некоректний або поля `scripts` нема. Не кидає — викликач сам вирішує, що робити.
- *
  * @param {string} root абсолютний шлях до теки з `package.json`
  * @returns {Record<string, string> | null} мапа scripts або null
  */
@@ -75,7 +74,6 @@ function readRootScripts(root) {
 /**
  * Виконує лінт-ланцюжок з тайменгом. Повертає exit-код, не кидає винятків (для прямого
  * присвоєння у `process.exitCode`).
- *
  * @param {RunLintCliOptions} [options] DI для тестів (мокаємо spawn / fs / clock)
  * @returns {number} 0 = успіх, ненульовий = code першого впалого скрипта, або 1 при структурних проблемах
  */

package/scripts/lib/timing-summary.mjs

@@ -9,7 +9,6 @@
  * Час виводиться як `<ціла>.<десята>s`, навіть для субсекундних інтервалів — щоб одиниця була стабільна.
  *
  * Маркер `❌` на рядку — якщо `ok === false`.
- *
  * @typedef {{ id: string, ms: number, ok: boolean }} TimingEntry
  */
 
@@ -20,7 +19,6 @@ const RULER = '─'
  * Форматує мілісекунди як `<sec>.<десята>s`. Округлення до десятої — нижнє (floor), щоб
  * однаковий ms давав однаковий вивід у різних таблицях незалежно від платформи (Number.prototype.toFixed
  * робить round-half-to-even, що для 950ms дає `0.9s` — приймаємо).
- *
  * @param {number} ms тривалість у мілісекундах (>= 0)
  * @returns {string} наприклад `0.0s`, `1.2s`, `12.3s`
  */
@@ -44,7 +42,6 @@ export function formatDurationMs(ms) {
  *
  * Ширина колонки id вирівнюється під найдовший id у списку. Мінімальна ширина riski — 14
  * (узгоджено з типовою довжиною заголовків `fix-js-lint` / `lint-security`).
- *
  * @param {string} title заголовок таблиці (наприклад, `Fix timing` або `Lint timing`)
  * @param {TimingEntry[]} timings записи в порядку запуску — друкуються як є, не сортуються
  * @returns {string} готовий до stdout текст з кінцевим `\n`
@@ -61,7 +58,9 @@ export function formatTimingSummary(title, timings) {
     const failMark = ok ? '' : '  ❌'
     lines.push(`   ${id.padEnd(idWidth)}  ${formatDurationMs(ms)}${failMark}`)
   }
-  lines.push(`   ${RULER.repeat(idWidth + 2 + 6)}`)
-  lines.push(`   ${'total'.padEnd(idWidth)}  ${formatDurationMs(totalMs)}`)
+  lines.push(
+    `   ${RULER.repeat(idWidth + 2 + 6)}`,
+    `   ${'total'.padEnd(idWidth)}  ${formatDurationMs(totalMs)}`
+  )
   return `${lines.join('\n')}\n`
 }

package/scripts/sync-claude-config.mjs

@@ -27,7 +27,7 @@
  * Опт-аут — `claude-config: false` у `.n-cursor.json`.
  */
 import { existsSync } from 'node:fs'
-import { chmod, mkdir, readFile, readdir, writeFile } from 'node:fs/promises'
+import { chmod, mkdir, readFile, readdir, rm, writeFile } from 'node:fs/promises'
 import { join } from 'node:path'
 
 /** Маркер PostToolUse fix-hook'а (`npx --no \@nitra/cursor post-tool-use-fix`). */
@@ -62,6 +62,15 @@ const CURSOR_HOOKS_FILE = `${CURSOR_DIR}/hooks.json`
 const ADR_HOOK_SCRIPT_NAME = 'capture-decisions.sh'
 const ADR_NORMALIZE_HOOK_SCRIPT_NAME = 'normalize-decisions.sh'
 const TEMPLATE_DIR_NAME = '.claude-template'
+
+/** Корінь pi.dev артефактів у проєкті-споживачі. */
+export const PI_DIR = '.pi'
+/** Директорія pi.dev TS-extensions у проєкті-споживачі. */
+export const PI_EXTENSIONS_DIR = `${PI_DIR}/extensions`
+/** Назва bundled-директорії pi-template у пакеті `@nitra/cursor`. */
+export const PI_TEMPLATE_DIR_NAME = '.pi-template'
+/** Імʼя bundled pi-extension'а для ADR capture/normalize. */
+export const PI_EXTENSION_NAME = 'n-cursor-adr'
 /** Відносний шлях до канонічного фрагмента `.gitignore` для ADR Stop-hook'ів у tarball пакета. */
 export const ADR_GITIGNORE_SNIPPET_REL = 'rules/adr/js/templates/hooks/.gitignore.snippet'
 const GITIGNORE_FILE = '.gitignore'
@@ -405,6 +414,61 @@ export function syncAdrNormalizeHookScript(projectRoot, templateDir) {
   return syncHookScript(projectRoot, templateDir, ADR_NORMALIZE_HOOK_SCRIPT_NAME)
 }
 
+/**
+ * Копіює bundled pi.dev TS-extension `npm/.pi-template/extensions/n-cursor-adr/` (усі файли —
+ * `index.ts`, `tsconfig.json`, потенційні `package.json`/`.gitignore` тощо) у
+ * `.pi/extensions/n-cursor-adr/` проєкту-споживача. Тека fully-owned: при кожному sync-у
+ * перезаписується. Якщо bundled template відсутній (legacy-версії пакета без `.pi-template/`)
+ * або в ньому немає `index.ts` — повертаємо `{written: false}` без помилки.
+ *
+ * Розширення поверх `index.ts` (tsconfig тощо) потрібні, бо `.pi/extensions/` синкається як є
+ * у проєкти-споживачі, а IDE/TS-сервер мусить резолвити `node:*` модулі без додаткових
+ * project-wide конфігів.
+ * @param {string} projectRoot корінь проєкту-споживача
+ * @param {string} bundledPackageRoot корінь установленого `@nitra/cursor` (із `.pi-template/`)
+ * @returns {Promise<{ written: boolean, path: string, files: string[] }>} чи писали; відносний шлях до теки розширення; список скопійованих базових імен (відсортований)
+ */
+export async function syncPiExtensions(projectRoot, bundledPackageRoot) {
+  const srcDir = join(bundledPackageRoot, PI_TEMPLATE_DIR_NAME, 'extensions', PI_EXTENSION_NAME)
+  const indexPath = join(srcDir, 'index.ts')
+  if (!existsSync(indexPath)) {
+    return { written: false, path: '', files: [] }
+  }
+  const destDir = join(projectRoot, PI_EXTENSIONS_DIR, PI_EXTENSION_NAME)
+  await mkdir(destDir, { recursive: true })
+  const entries = await readdir(srcDir, { withFileTypes: true })
+  const copied = []
+  for (const entry of entries) {
+    if (!entry.isFile()) continue
+    const name = entry.name
+    const content = await readFile(join(srcDir, name), 'utf8')
+    await writeFile(join(destDir, name), content, 'utf8')
+    copied.push(name)
+  }
+  return {
+    written: true,
+    path: `${PI_EXTENSIONS_DIR}/${PI_EXTENSION_NAME}`,
+    files: copied.toSorted((a, b) => a.localeCompare(b))
+  }
+}
+
+/**
+ * Видаляє `.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 }>} чи було щось видалено та відносний шлях
+ */
+export async function removeOrphanPiExtension(projectRoot) {
+  const extDir = join(projectRoot, PI_EXTENSIONS_DIR, PI_EXTENSION_NAME)
+  if (!existsSync(extDir)) {
+    return { removed: false, path: '' }
+  }
+  await rm(extDir, { recursive: true, force: true })
+  return { removed: true, path: `${PI_EXTENSIONS_DIR}/${PI_EXTENSION_NAME}` }
+}
+
 /**
  * Повертає змістовні (не коментар, не порожній) рядки з text-фрагмента `.gitignore`.
  * @param {string} raw вміст snippet-файлу
@@ -494,7 +558,7 @@ export async function syncClaudeCommands(projectRoot, templateDir) {
  * @param {string} options.bundledPackageRoot корінь установленого `@nitra/cursor`
  * @param {boolean} options.enabled чи увімкнено sync (з `.n-cursor.json` `claude-config`)
  * @param {string[]} [options.rules] список увімкнених правил із `.n-cursor.json` — впливає на ADR Stop-hook (`adr`)
- * @returns {Promise<{ settings: boolean, cursorHooks: boolean, commands: string[], adrHook: boolean, adrNormalizeHook: boolean, gitignoreAdr: boolean }>} прапорці записів settings/Cursor hooks/ADR-hook(s)/`.gitignore` та список slash-команд
+ * @returns {Promise<{ settings: boolean, cursorHooks: boolean, commands: string[], adrHook: boolean, adrNormalizeHook: boolean, gitignoreAdr: boolean, piExtension: boolean }>} прапорці записів settings/Cursor hooks/ADR-hook(s)/`.gitignore`/pi-extension та список slash-команд
  */
 export async function syncClaudeConfig({ projectRoot, bundledPackageRoot, enabled, rules = [] }) {
   if (!enabled) {
@@ -504,7 +568,8 @@ export async function syncClaudeConfig({ projectRoot, bundledPackageRoot, enable
       commands: [],
       adrHook: false,
       adrNormalizeHook: false,
-      gitignoreAdr: false
+      gitignoreAdr: false,
+      piExtension: false
     }
   }
   const templateDir = join(bundledPackageRoot, TEMPLATE_DIR_NAME)
@@ -515,7 +580,8 @@ export async function syncClaudeConfig({ projectRoot, bundledPackageRoot, enable
       commands: [],
       adrHook: false,
       adrNormalizeHook: false,
-      gitignoreAdr: false
+      gitignoreAdr: false,
+      piExtension: false
     }
   }
   const includeAdrHook = Array.isArray(rules) && rules.includes('adr')
@@ -526,6 +592,9 @@ export async function syncClaudeConfig({ projectRoot, bundledPackageRoot, enable
   const gitignoreAdr = includeAdrHook
     ? await syncGitignoreAdrFragment(projectRoot, bundledPackageRoot)
     : { written: false, path: '' }
+  const piExtension = includeAdrHook
+    ? await syncPiExtensions(projectRoot, bundledPackageRoot)
+    : await removeOrphanPiExtension(projectRoot).then(r => ({ written: false, path: r.path }))
   const settings = await syncClaudeSettings(projectRoot, templateDir, { includeAdrHook })
   const cursorHooks = await syncCursorHooksConfig(projectRoot, { includeAdrHook })
   const commands = await syncClaudeCommands(projectRoot, templateDir)
@@ -535,6 +604,7 @@ export async function syncClaudeConfig({ projectRoot, bundledPackageRoot, enable
     commands,
     adrHook: adrHook.written,
     adrNormalizeHook: adrNormalizeHook.written,
-    gitignoreAdr: gitignoreAdr.written
+    gitignoreAdr: gitignoreAdr.written,
+    piExtension: piExtension.written
   }
 }

package/skills/coverage-fix/SKILL.md

@@ -0,0 +1,114 @@
+---
+name: n-coverage-fix
+description: >-
+  Автономна команда: запускає coverage, читає ## Recommendations у COVERAGE.md, ітеративно пише тести для вижилих мутантів до конвергенції
+---
+
+# /n-coverage-fix — ітеративне підвищення mutation score
+
+## Важливо
+
+⚠️ Не запускати паралельно з іншим `/n-coverage-fix` або `bun coverage` — Stryker пише `mutation.json` і `incremental.json` в одну директорію. `n-cursor coverage` всередині вже серіалізований через `withLock('coverage')`, але паралельний запуск двох ітерацій скілу зіпсує дані.
+
+## Мета
+
+Автономно підвищити mutation score: запустити `bun coverage`, записати тести для вижилих мутантів, повторити до конвергенції (score перестав зростати).
+
+## Алгоритм
+
+### Крок 1: Запусти coverage
+
+```bash
+bun coverage
+```
+
+(або `bun run coverage` якщо команда у `package.json`)
+
+Чекай завершення. Якщо команди немає у `package.json` — запусти `n-cursor coverage` з кореня.
+
+### Крок 2: Прочитай вижилих мутантів
+
+Прочитай `COVERAGE.md` — знайди секцію `## Recommendations`.
+
+Якщо секції немає або вона порожня:
+```
+✓ Нема вижилих мутантів — mutation score повний
+```
+→ DONE
+
+Запам'ятай поточний mutation score як `baseline_score` (рядок `| **Разом** |` з таблиці у COVERAGE.md).
+
+### Крок 3: Для кожного файлу з Recommendations — пиши тести
+
+Для кожного `### <file>` у секції:
+
+**3a. Читай контекст:**
+- Source-файл (`<file>` від кореня проєкту)
+- Таблицю вижилих мутантів: рядок, оригінал, заміна, тип
+- Блок `**Приклад наявного тесту:**` — style guide для нових тестів
+
+**3b. Знайди тестовий файл:**
+Перший що існує:
+1. `<dir>/<basename>.test.js` — поруч із source
+2. `<dir>/<basename>.spec.js`
+3. `test/<basename>.test.js` від кореня
+4. `tests/<basename>.test.js` від кореня
+
+Якщо жоден не знайдено — створи `<dir>/<basename>.test.js` з правильними imports (орієнтуйся на сусідні файли).
+
+**3c. Напиши тести що вбивають кожен мутант:**
+
+Керуйся типом мутації:
+- `ConditionalExpression` (`→ false` / `→ true`): протестуй обидва branch явно — значення що робить умову `true` і значення що робить її `false`
+- `BooleanLiteral` (`true → false`): перевір початковий стан — `initialValue === false`
+- `LogicalOperator` (`&&` ↔ `||`): передай `null` та `undefined` **окремо**, перевір що результат різний для кожного
+- `StringLiteral` / `EqualityOperator`: перевір точний рядок/значення, а не лише happy-path
+
+Правила:
+- НЕ видаляй і НЕ змінюй наявні тести
+- Стиль: той самий `describe`/`it`/`expect`, мова коментарів — як у прикладі тесту
+- Якщо `**Приклад наявного тесту:**` відсутній — орієнтуйся на інші test-файли у тій самій директорії
+
+**3d. Після написання тестів:**
+```bash
+bun test <testFile>
+```
+
+Якщо FAIL — виправи саме ті тести що впали (до 2 спроб). Якщо не вдалося — логуй і переходь до наступного файлу.
+
+### Крок 4: Перевір що весь suite проходить
+
+```bash
+bun test
+```
+
+Якщо FAIL:
+- Не відкочувати зміни
+- Показати: яка помилка, які файли змінені, що вже покращено
+- Очікувати рішення від user: [виправити вручну → продовжити] / [пропустити файл] / [зупинити]
+
+### Крок 5: Запусти coverage і перевір конвергенцію
+
+```bash
+bun coverage
+```
+
+Якщо CRASH (SIGURG, memory pressure): нагадати user — Stryker incremental зберіг прогрес, перезапустити `bun coverage`.
+
+Прочитай новий COVERAGE.md. Візьми `new_score` з рядка `| **Разом** |`.
+
+**Рішення:**
+- Якщо `new_score > baseline_score` → `baseline_score = new_score` → перейти до Кроку 2 (наступна ітерація)
+- Якщо `new_score <= baseline_score` → конвергенція:
+  ```
+  ✓ Конвергенція: mutation score більше не покращується.
+  Baseline: <baseline_score> → Фінал: <new_score>
+  ```
+  → DONE
+
+## Нотатки
+
+- Stryker `incremental` (`incrementalFile`) зберігає прогрес між запусками — crash ≠ перезапуск з нуля
+- Не комітити зміни автоматично — user вирішує коли комітити
+- Пріоритет файлів: більше вижилих мутантів = важливіший (першим у Recommendations = найважливіший)
+- Якщо `COVERAGE.md` відсутній — запусти `bun coverage` спочатку

package/skills/coverage-fix/auto.md

@@ -0,0 +1 @@
+[js-lint]