@nitra/cursor 12.11.0 → 12.11.2

package/scripts/coverage-classify/verdict-schema.mjs

@@ -1,35 +0,0 @@
-/**
- * Zod-схема для verdict-відповіді LLM-класифікатора (coverage-classify).
- * parseVerdict — витяг JSON з raw-text LLM-відповіді + validate.
- *
- * Категорії:
- *   - worth-testing: pure logic, real branches — пиши тест
- *   - equivalent:    мутант поведінково еквівалентний (не killable)
- *   - defensive:     гілка для impossible state (не killable)
- *   - glue:          CLI entry / runStandardRule wrapper (integration covers)
- *   - wrapper:       тонкий spawn/fetch wrapper (integration covers)
- */
-import { z } from 'zod'
-
-export const VerdictSchema = z.object({
-  verdict: z.enum(['worth-testing', 'equivalent', 'defensive', 'glue', 'wrapper']),
-  confidence: z.number().min(0).max(1),
-  reason: z.string().min(20).max(500),
-  suggestedTest: z.string().max(300).optional()
-})
-
-/**
- * Витягує JSON-об'єкт з raw-text LLM-відповіді і валідує через VerdictSchema.
- * @param {string} rawText raw-text відповідь LLM
- * @returns {{verdict: string, confidence: number, reason: string, suggestedTest?: string}} verdict
- * @throws {Error} якщо JSON не знайдено, не парситься, або не відповідає схемі
- */
-export function parseVerdict(rawText) {
-  const jsonStart = rawText.indexOf('{')
-  const jsonEnd = rawText.lastIndexOf('}')
-  if (jsonStart === -1 || jsonEnd === -1) {
-    throw new Error('No JSON object found in LLM response')
-  }
-  const json = JSON.parse(rawText.slice(jsonStart, jsonEnd + 1))
-  return VerdictSchema.parse(json)
-}

package/scripts/coverage-fix-extract.mjs

@@ -1,122 +0,0 @@
-/**
- * `n-cursor coverage-fix index|slice` — read-only витяг вцілілих мутантів із
- * `COVERAGE.md` для скілу `n-coverage-fix`.
- *
- * Мотивація: `COVERAGE.md` може важити мегабайти (секція `## Вцілілі мутанти`
- * з JSON-блоком на сотні файлів). Якщо цей файл читає LLM-оркестратор, він
- * спалює сотні тисяч токенів лише на парсинг. Натомість важкий парсинг несе цей
- * скрипт (для JS — мілісекунди, 0 токенів), а агенту віддається рівно потрібна
- * порція:
- *   - `index` — крихітний `[{file, mutants}]` для рішення про фан-аут;
- *   - `slice --file <path>` — промпт лише для одного файлу (контекст ±3 рядки),
- *     рівно під когнітивне навантаження одного субагента.
- *
- * Команда read-only: лише парсить наявний `COVERAGE.md`, нічого не мутує і не
- * перезапускає Stryker (тож не входить у root-guard).
- */
-import { readFile } from 'node:fs/promises'
-import { join } from 'node:path'
-
-import { buildFixPrompt } from './coverage-fix.mjs'
-
-/** Заголовок секції вцілілих мутантів у COVERAGE.md (контракт із renderMarkdown). */
-const SURVIVED_SECTION = '## Вцілілі мутанти'
-
-/**
- * Огорожа json-блоку: ≥3 бектики, далі `json` і решта рядка до `\n`. Довжина
- * захоплюється в групу 1 — renderMarkdown пише 3, але oxfmt підвищує до 4+, коли
- * сам JSON-вміст містить ``` (типово для original/replacement мутантів).
- */
-const FENCE_OPEN_RE = /(`{3,8})json[^\n]{0,200}\n/
-
-/**
- * Витягує JSON-масив вцілілих мутантів із тексту COVERAGE.md: знаходить секцію
- * `## Вцілілі мутанти`, перший огороджений ` ```json ` блок під нею і парсить.
- * @param {string} md повний текст COVERAGE.md
- * @returns {import('./coverage-fix.mjs').SurvivedFileGroup[]} групи вцілілих по файлах (порожньо, якщо секції/блоку немає або JSON невалідний)
- */
-export function parseSurvivedBlock(md) {
-  const sectionAt = md.indexOf(SURVIVED_SECTION)
-  if (sectionAt === -1) return []
-  const after = md.slice(sectionAt)
-  const open = after.match(FENCE_OPEN_RE)
-  if (!open) return []
-  const fence = open[1]
-  const bodyStart = open.index + open[0].length
-  const rest = after.slice(bodyStart)
-  // Закриття — рядок із тих самих бектиків. Усередині JSON реальних переводів
-  // рядка немає (JSON.stringify екранує їх як `\n`), тож `\n<fence>` унікально
-  // позначає кінець блоку навіть якщо значення містять бектики.
-  const closeAt = rest.indexOf(`\n${fence}`)
-  const json = closeAt === -1 ? rest : rest.slice(0, closeAt)
-  try {
-    const parsed = JSON.parse(json)
-    return Array.isArray(parsed) ? parsed : []
-  } catch {
-    return []
-  }
-}
-
-/**
- * Читає `COVERAGE.md` із кореня проєкту і повертає структуровані групи вцілілих.
- * @param {string} cwd корінь проєкту
- * @returns {Promise<import('./coverage-fix.mjs').SurvivedFileGroup[]>} групи вцілілих по файлах
- */
-export async function readSurvived(cwd) {
-  let md
-  try {
-    md = await readFile(join(cwd, 'COVERAGE.md'), 'utf8')
-  } catch {
-    return []
-  }
-  return parseSurvivedBlock(md)
-}
-
-/**
- * Згортає групи вцілілих у компактний index `[{file, mutants}]`.
- * @param {import('./coverage-fix.mjs').SurvivedFileGroup[]} survived групи вцілілих
- * @returns {Array<{file:string, mutants:number}>} файл → кількість вцілілих мутантів
- */
-export function buildIndex(survived) {
-  return survived
-    .filter(group => group && typeof group.file === 'string' && Array.isArray(group.mutants))
-    .map(group => ({ file: group.file, mutants: group.mutants.length }))
-}
-
-const USAGE = 'Usage: n-cursor coverage-fix <index | slice --file <path>>'
-
-/**
- * CLI: `index` друкує компактний JSON-масив, `slice --file <path>` — промпт для
- * одного файлу. Обидва read-only (читають лише COVERAGE.md).
- * @param {string[]} args аргументи після `coverage-fix`
- * @param {string} [cwd] корінь проєкту (ін'єкція для тестів)
- * @returns {Promise<number>} exit code
- */
-export async function runCoverageFixCli(args, cwd = process.cwd()) {
-  const sub = args[0]
-  const survived = await readSurvived(cwd)
-
-  if (sub === 'index') {
-    process.stdout.write(`${JSON.stringify(buildIndex(survived))}\n`)
-    return 0
-  }
-
-  if (sub === 'slice') {
-    const flagAt = args.indexOf('--file')
-    const file = flagAt === -1 ? undefined : args[flagAt + 1]
-    if (!file) {
-      console.error(USAGE)
-      return 1
-    }
-    const group = survived.find(g => g && g.file === file)
-    if (!group) {
-      console.error(`✗ Файл не знайдено серед вцілілих мутантів: ${file}`)
-      return 1
-    }
-    process.stdout.write(`${await buildFixPrompt([group], cwd)}\n`)
-    return 0
-  }
-
-  console.error(USAGE)
-  return 1
-}

package/scripts/coverage-fix.mjs

@@ -1,119 +0,0 @@
-/**
- * `n-cursor coverage --fix`: запускає pi-агента для написання тестів
- * по вцілілих мутантах Stryker. Агент отримує список мутантів з контекстом
- * (file, line, оригінальний код, вцілілий варіант, тип мутації) і самостійно
- * знаходить або створює відповідні test-файли.
- *
- * Модель: CLOUD_MAX (складна агентна задача) або N_CURSOR_COVERAGE_FIX_MODEL.
- */
-import { readFile } from 'node:fs/promises'
-import { join } from 'node:path'
-import { spawnSync } from 'node:child_process'
-import { env } from 'node:process'
-
-import { resolveModel } from '../lib/models.mjs'
-
-const MODEL = env.N_CURSOR_COVERAGE_FIX_MODEL ?? resolveModel('max')
-
-/**
- * @typedef {{line:number, col:number, mutantType:string, original:string, replacement:string}} MutantDetail
- * @typedef {{file:string, mutants:MutantDetail[], exampleTest:{testFile:string,code:string|null}|null, recommendationText:string|null}} SurvivedFileGroup
- */
-
-/**
- * Запускає pi-агента для написання тестів по вцілілих мутантах.
- * @param {SurvivedFileGroup[]} survived вцілілі мутанти, згруповані по файлах
- * @param {string} projectRoot абсолютний шлях до кореня проєкту
- * @param {{ callPi?: (prompt: string, model: string, opts: { cwd: string }) => void }} [opts] ін'єкції для тестів
- * @returns {Promise<void>}
- */
-export async function fixSurvivedMutants(survived, projectRoot, opts = {}) {
-  const totalMutants = survived.reduce((s, g) => s + g.mutants.length, 0)
-  if (totalMutants === 0) {
-    console.log('✓ Всі мутанти вбиті — доповнення тестів не потрібне')
-    return
-  }
-
-  const prompt = await buildFixPrompt(survived, projectRoot)
-  console.log(`\n🤖 coverage --fix: запускаю агента для ${totalMutants} вцілілих мутантів...\n`)
-
-  const callPiFn = opts.callPi ?? callPi
-  callPiFn(prompt, MODEL, { cwd: projectRoot })
-}
-
-/**
- * Викликає pi в агентному режимі з live-output до stdout.
- * @param {string} prompt текст промпта
- * @param {string} model  provider/model-id або '' для pi-дефолту
- * @param {{ cwd?: string }} [piOpts] опційні параметри (cwd)
- */
-function callPi(prompt, model, { cwd } = {}) {
-  const modelArgs = model ? ['--model', model] : []
-  spawnSync('pi', ['-p', prompt, ...modelArgs, '--no-session'], {
-    cwd,
-    stdio: 'inherit',
-    timeout: 900_000
-  })
-}
-
-/**
- * Формує rich-промпт для агента: список вцілілих мутантів згрупований по файлах,
- * з контекстом ±3 рядки навколо кожного мутанта з source-файлу.
- * @param {SurvivedFileGroup[]} survived групи вцілілих мутантів по файлах
- * @param {string} projectRoot корінь проєкту
- * @returns {Promise<string>} текст rich-промпту
- */
-export async function buildFixPrompt(survived, projectRoot) {
-  const sections = []
-
-  for (const { file, mutants, exampleTest } of survived) {
-    let srcLines = []
-    try {
-      const src = await readFile(join(projectRoot, file), 'utf8')
-      srcLines = src.split('\n')
-    } catch {
-      // файл може бути недоступним — пропускаємо контекст, але продовжуємо
-    }
-
-    const mutantDescriptions = 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\`\`\``
-      : ''
-
-    sections.push(`### \`${file}\`${exampleSection}\n${mutantDescriptions}`)
-  }
-
-  return [
-    'Твоє завдання — написати unit-тести, що вбивають наступні вцілілі мутанти Stryker.',
-    'Для кожного мутанта: знайди або створи відповідний test-файл, додай тест-кейс,',
-    'що явно перевіряє цю гілку/умову і провалиться якщо код замінити на "вцілілий варіант".',
-    '',
-    '## Вцілілі мутанти',
-    '',
-    ...sections,
-    '',
-    '## Правила',
-    '- Не змінюй source-файли — лише test-файли.',
-    '- Використовуй той самий test-фреймворк, що вже в проєкті.',
-    '- Запусти `bun test` (або відповідну команду) після кожного файлу — переконайся, що 0 fail.',
-    '- Якщо мутант охоплений іншим новим тестом — не дублюй.'
-  ].join('\n')
-}

package/scripts/docs/coverage-fix-extract.md

@@ -1,36 +0,0 @@
----
-type: JS Module
-title: coverage-fix-extract.mjs
-resource: npm/scripts/coverage-fix-extract.mjs
-docgen:
-  crc: a7f39f0e
----
-
-Цей файл витягує вцілілі мутанти з файлу `COVERAGE.md` у форматі JSON. Витягнуті дані надаються агенту для вирішення проблем з покриттям, зменшуючи навантаження на LLM-оркестратор та забезпечуючи ефективний обмін інформацією. Це ключовий компонент процесу `n-coverage-fix`, що дозволяє агенту швидко реагувати на зміни в покритті.
-
-## Поведінка
-
-parseSurvivedBlock: Витягує JSON-масив вцілілих мутантів із тексту `COVERAGE.md`.
-readSurvived: Читає `COVERAGE.md` із кореня проєкту і повертає групи вцілілих.
-buildIndex: Згортає групи вцілілих у компактний index `[{file, mutants}]`.
-runCoverageFixCli: CLI: `index` друкує компактний JSON-масив, `slice --file <path>` — промпт для одного файлу.
-
-## Публічний API
-
-- parseSurvivedBlock — Витягує дані про вцілілих мутантів з `COVERAGE.md` у форматі JSON.
-- readSurvived — Зчитує `COVERAGE.md` та повертає структуровані дані про вцілілих.
-- buildIndex — Створює компактний індекс у форматі JSON, що містить інформацію про файли та мутанти.
-- runCoverageFixCli — CLI для друку та обрізки даних з `COVERAGE.md`.
-
-## Гарантії поведінки
-
-- Скрипт парсить файл `COVERAGE.md`.
-- Результатом парсингу є об'єкт з інформацією про вцілілі мутанти.
-- Скрипт повертає об'єкт, якщо файл `COVERAGE.md` існує та може бути успішно прочитаний.
-- Якщо файл `COVERAGE.md` не існує, скрипт повертає порожній об'єкт.
-- Скрипт не змінює вміст файлу `COVERAGE.md`.
-- Скрипт не запускає Stryker.
-- Скрипт не генерує винятків.
-- Скрипт не використовує кешування.
-- Використання команди `index` повертає мінімальний об'єкт, що містить інформацію про вцілілі мутанти.
-- Використання команди `slice --file <path>` повертає промпт для одного файлу, що містить контекст ±3 рядки.

package/scripts/docs/coverage-fix.md

@@ -1,181 +0,0 @@
----
-type: JS Module
-title: coverage-fix.mjs
-resource: npm/scripts/coverage-fix.mjs
-docgen:
-  crc: 7f0568dd
----
-
-Файл `npm/scripts/coverage-fix.mjs` — це ESM-модуль, який реалізує fix-режим команди `n-cursor coverage --fix`. Його призначення — автоматично запустити агента Claude Code (через офіційний SDK `@anthropic-ai/claude-agent-sdk`) і доручити йому дописати unit-тести, які «вб'ють» вцілілих мутантів, знайдених попереднім прогоном Stryker.
-
-Модуль не виконує власних мутацій коду й не аналізує покриття самостійно — він є тонким адаптером між інвентарем вцілілих мутантів (структури `SurvivedFileGroup[]`, отримані ззовні) і LLM-агентом: формує rich-промпт з контекстом ±3 рядки навколо кожного мутанта, опційно додає приклад уже існуючого тесту, після чого ітерує по стрімінгу повідомлень агента та виводить його текстові реплики у `stdout`.
-
-Файл задумано як єдину публічну точку входу для CLI-флоу `coverage --fix`: викликається з оркестратора `n-cursor coverage`, який групує мутанти Stryker по source-файлах і передає сюди готову структуру разом з абсолютним шляхом до кореня проєкту.
-
-## Експорти / API
-
-| Експорт                                     | Тип              | Призначення                                                                                                                          |
-| ------------------------------------------- | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
-| `fixSurvivedMutants(survived, projectRoot)` | `async function` | Публічна функція. Запускає агента, проганяє промпт через `@anthropic-ai/claude-agent-sdk` і друкує текстові повідомлення в `stdout`. |
-
-Внутрішні символи (не експортуються):
-
-| Символ                                  | Тип              | Призначення                                                                                                      |
-| --------------------------------------- | ---------------- | ---------------------------------------------------------------------------------------------------------------- |
-| `buildFixPrompt(survived, projectRoot)` | `async function` | Формує текстовий rich-промпт для агента: список мутантів по файлах, контекст з source, приклади тестів, правила. |
-
-JSDoc-типи, оголошені у файлі:
-
-- `MutantDetail` — `{ line: number, col: number, mutantType: string, original: string, replacement: string }` — опис одного вцілілого мутанта.
-- `SurvivedFileGroup` — `{ file: string, mutants: MutantDetail[], exampleTest: { testFile: string, code: string | null } | null, recommendationText: string | null }` — група мутантів, об'єднаних спільним source-файлом, разом з опційним прикладом існуючого тесту й текстовою рекомендацією.
-
-## Функції
-
-### `fixSurvivedMutants(survived, projectRoot)`
-
-**Сигнатура:** `async function fixSurvivedMutants(survived: SurvivedFileGroup[], projectRoot: string): Promise<void>`
-
-**Параметри:**
-
-- `survived` — масив груп вцілілих мутантів, згрупованих по source-файлу. Кожна група містить шлях до файлу, перелік мутантів, опційний приклад тесту й опційну текстову рекомендацію.
-- `projectRoot` — абсолютний шлях до кореня проєкту. Використовується одночасно як `cwd` для агента і як база для читання source-файлів при підготовці контексту в промпті.
-
-**Що повертає:** `Promise<void>`. Корисний результат — побічний ефект: створені/оновлені тести у файловій системі (їх пише агент через інструменти `Edit`/`Bash`), а також лог у `stdout`.
-
-**Алгоритм:**
-
-1. Обчислює загальну кількість мутантів: `survived.reduce((s, g) => s + g.mutants.length, 0)`.
-2. Якщо загалом 0 мутантів — друкує `✓ Всі мутанти вбиті — доповнення тестів не потрібне` і повертається (без запуску агента, без імпорту SDK).
-3. Викликає `buildFixPrompt(survived, projectRoot)` і отримує текст промпту.
-4. Друкує заголовок `🤖 coverage --fix: запускаю агента для N вцілілих мутантів...`.
-5. Робить **динамічний** `await import('@anthropic-ai/claude-agent-sdk')` (щоб не вимагати пакет у звичайному coverage-прогоні без `--fix`) і дістає функцію `query`.
-6. Запускає агента викликом `query({ prompt, options: { cwd: projectRoot, maxTurns: 20, allowedTools: ['Read', 'Edit', 'Bash'] } })`.
-7. Ітерує отриманий `AsyncIterable` через `for await (const msg of …)`. Для повідомлень з `msg.type === 'text'` друкує `msg.text` у `process.stdout` (без додаткового переносу рядка). Інші типи повідомлень (наприклад, tool_use, tool_result) — мовчазно ігноруються.
-8. Після завершення ітерації друкує фінальний `\n`.
-
-**Опції агента:**
-
-- `cwd: projectRoot` — поточна тека агента, від якої він читає файли й запускає команди.
-- `maxTurns: 20` — обмеження на кількість turns у діалозі з моделлю, щоб уникнути нескінченних циклів.
-- `allowedTools: ['Read', 'Edit', 'Bash']` — агент має право читати файли, редагувати їх (фактично — тест-файли, бо source заборонено правилом у промпті) і виконувати shell-команди (зокрема `bun test`).
-
-**Side effects:**
-
-- Запис у `process.stdout` (`console.log` + `process.stdout.write`).
-- Динамічний імпорт зовнішнього пакету `@anthropic-ai/claude-agent-sdk` — у разі його відсутності `await import(…)` кине помилку (її обробка делегована викликачу).
-- Мережеві виклики до API Anthropic (виконує сам SDK).
-- Зміни у файловій системі проєкту: створення/редагування тест-файлів та потенційне виконання тестових команд агентом через інструмент `Bash`.
-
-**Граничні випадки:**
-
-- `totalMutants === 0` — рання терміновість без імпорту SDK.
-- Помилка `import('@anthropic-ai/claude-agent-sdk')` (пакет не встановлений) — пробрасується нагору; цей файл її не ловить.
-- Помилка з боку стріму `query(...)` — пробрасується нагору; final `\n` не друкується.
-
-### `buildFixPrompt(survived, projectRoot)` (internal)
-
-**Сигнатура:** `async function buildFixPrompt(survived: SurvivedFileGroup[], projectRoot: string): Promise<string>`
-
-**Параметри:** ті самі семантики, що у `fixSurvivedMutants`.
-
-**Що повертає:** текст rich-промпту для агента.
-
-**Алгоритм:**
-
-1. Готує пустий масив `sections`.
-2. Для кожної групи `{ file, mutants, exampleTest }`:
-   1. Намагається прочитати source-файл `join(projectRoot, file)` у `utf8` і розбити на рядки. У разі помилки (`catch {}`) — `srcLines` лишається `[]`, і контекст просто не додасться.
-   2. Для кожного мутанта в групі формує опис:
-      - `ctxStart = Math.max(0, m.line - 4)` — індекс початку контексту (0-based, бо рядки в редакторі 1-based; `m.line - 4` дає 3 рядки до мутанта).
-      - `ctxEnd = Math.min(srcLines.length, m.line + 3)` — індекс кінця (виключний), 3 рядки після мутанта.
-      - `context` — зріз `srcLines.slice(ctxStart, ctxEnd)`, де кожен рядок префіксується абсолютним номером `${ctxStart + i + 1}: ${l}` і з'єднується через `\n`.
-      - Опис мутанта — markdown-bullet з полями: рядок, колонка, тип мутації (`m.mutantType` у backticks), оригінал (`m.original`), вцілілий варіант (`m.replacement`), а нижче — fenced code block з контекстом (якщо контекст не порожній). Порожні елементи фільтруються через `.filter(Boolean)`.
-   3. Якщо є `exampleTest.code` — додає окрему секцію `Приклад тесту з \`${exampleTest.testFile}\``з fenced`js`-блоком. Інакше `exampleSection` — порожній рядок.
-   4. Заштовхує у `sections` рядок виду:
-      ```
-      ### `<file>`<exampleSection>
-      <mutantDescriptions>
-      ```
-3. Повертає одну склеєну рядкову відповідь, що складається з:
-   - Заголовка-завдання (4 рядки): «Твоє завдання — написати unit-тести…» з конкретною інструкцією: знайти/створити тест-файл, додати кейс, що провалиться при заміні коду на «вцілілий варіант».
-   - Розділу `## Вцілілі мутанти` зі склеєними `sections`.
-   - Розділу `## Правила`:
-     - «Не змінюй source-файли — лише test-файли.»
-     - «Використовуй той самий test-фреймворк, що вже в проєкті.»
-     - «Запусти `bun test` (або відповідну команду) після кожного файлу — переконайся, що 0 fail.»
-     - «Якщо мутант охоплений іншим новим тестом — не дублюй.»
-
-**Side effects:** читання source-файлів через `fs/promises.readFile`. Помилки читання (відсутній файл, нечитабельний шлях) тихо проковтуються — функція гарантує, що повертає валідний промпт навіть для повністю відсутніх файлів (просто без контексту).
-
-**Граничні випадки:**
-
-- `srcLines.length === 0` — `context` стає порожнім рядком, fenced-блок з контекстом не додається до bullet.
-- `m.line` поза межами файлу — `slice` поверне порожній зріз; жодного винятку.
-- `exampleTest === null` або `exampleTest.code === null/undefined` — `exampleSection` залишається порожнім (через `?.code` optional chaining).
-- `mutants.length === 0` у групі — група все одно потрапить у `sections` з заголовком і порожнім тілом (виклична сторона зазвичай не подає пусті групи, бо `fixSurvivedMutants` ще раніше відсіче випадок `totalMutants === 0`).
-
-## Залежності
-
-**Зовнішні (npm):**
-
-- `@anthropic-ai/claude-agent-sdk` — офіційний SDK Claude Code, експортує функцію `query()` з async-generator-інтерфейсом для стрімінгу повідомлень агента. Завантажується через **dynamic import**, виключно в момент виклику `fixSurvivedMutants` з ненульовим списком мутантів. Декларується у `dependencies` файлу `npm/package.json` (як зазначено у JSDoc-шапці модуля).
-
-**Node.js stdlib:**
-
-- `node:fs/promises` — використовується `readFile` для читання source-файлів при формуванні контексту в промпті.
-- `node:path` — використовується `join` для зчеплення `projectRoot` з відносним шляхом файлу мутанта.
-
-**Глобальні API середовища:**
-
-- `console.log` — друк інформаційних рядків (старт/пропуск).
-- `process.stdout.write` — потоковий друк reply-чанків агента (без auto-newline).
-
-**Внутрішні залежності проєкту:**
-
-- Модуль не імпортує інших файлів з `npm/scripts/` напряму, але формат вхідної структури `SurvivedFileGroup` визначається сусідніми скриптами в каталозі `npm/scripts/` (там, де живе оркестратор `coverage`, який збирає й групує мутантів Stryker і передає сюди готовий масив).
-
-## Потік виконання / Використання
-
-Типовий ланцюжок:
-
-1. CLI `n-cursor coverage --fix` (зовнішня обгортка) запускає Stryker і збирає список вцілілих мутантів.
-2. Оркестратор групує мутантів по `file`, готує `exampleTest` (опційно) і викликає:
-
-   ```js
-   import { fixSurvivedMutants } from './npm/scripts/coverage-fix.mjs'
-
-   await fixSurvivedMutants(survived, projectRoot)
-   ```
-
-3. `fixSurvivedMutants`:
-   - Перевіряє, що мутанти взагалі є; якщо ні — друкує success-повідомлення і виходить.
-   - Будує промпт через `buildFixPrompt` (читання source-файлів для контексту відбувається саме тут).
-   - Динамічно імпортує `@anthropic-ai/claude-agent-sdk`.
-   - Стрімить агента з обмеженнями: `cwd = projectRoot`, до 20 turns, інструменти `Read | Edit | Bash`.
-   - Друкує всі текстові реплики у `stdout` у реальному часі.
-4. Агент за правилами промпту читає source-файли (лише для розуміння), знаходить/створює відповідні test-файли, дописує кейси, запускає `bun test` і повторює, доки `maxTurns` або модель не вирішить, що готово.
-5. Після завершення стріму `fixSurvivedMutants` дописує фінальний `\n` і повертає `void`.
-
-**Принципи дизайну, що випливають із коду:**
-
-- **Lazy SDK loading.** Імпорт SDK — динамічний, щоб звичайний `coverage` (без `--fix`) не вимагав встановленого `@anthropic-ai/claude-agent-sdk` і не платив за його завантаження.
-- **Ізоляція знань про Stryker.** Цей файл нічого не знає про сам Stryker — він працює з уже нормалізованою структурою `SurvivedFileGroup[]`; уся інтеграція зі Stryker лежить в іншому модулі-оркестраторі.
-- **No source mutation by agent.** Жорстке правило в промпті («Не змінюй source-файли — лише test-файли») задає очікувану поведінку агента; додатково обмежений набір інструментів (`Read | Edit | Bash`) дає змогу йому редагувати тести й запускати тестову команду, але не лазити в систему по непотрібному.
-- **Стрімінг тільки текстових повідомлень.** Інші типи (наприклад, tool_use / tool_result) свідомо не рендеряться, щоб лог у консолі лишався читабельним для людини.
-
-**Приклад вхідної структури:**
-
-```js
-const survived = [
-  {
-    file: 'src/foo.js',
-    mutants: [{ line: 42, col: 10, mutantType: 'ConditionalExpression', original: 'a > b', replacement: 'a >= b' }],
-    exampleTest: { testFile: 'src/foo.test.js', code: "test('foo', () => { /* ... */ })" },
-    recommendationText: null
-  }
-]
-
-await fixSurvivedMutants(survived, '/abs/path/to/project')
-```
-
-> Примітка: поле `recommendationText` присутнє в JSDoc-типі `SurvivedFileGroup`, але в поточній реалізації `coverage-fix.mjs` воно **не** використовується при формуванні промпту — резервоване для майбутнього розширення (наприклад, додавання текстових порад поряд із прикладом тесту).

package/skills/coverage-fix/SKILL.md

@@ -1,131 +0,0 @@
----
-name: n-coverage-fix
-description: >-
-  Автономна команда: запускає n-cursor coverage → читає вцілілих мутантів → ітеративно пише тести до конвергенції (max 3 ітерації)
-version: '1.0'
----
-
-# n-coverage-fix — підвищення mutation score
-
-## Мета
-
-Автоматично підвищити mutation score: запускає coverage, знаходить survived mutants, пише тести, повторює до конвергенції.
-
-## ⚠️ Не запускати паралельно
-
-Цей скіл **не можна** запускати паралельно в різних агентах або Bash-задачах.
-
-`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
-
-### Крок 0: Визнач команди (з `package.json#scripts`)
-
-Прочитай кореневий `package.json` і зафіксуй дві команди (перша що існує):
-
-- **coverage-команда**: `scripts["coverage"]` → виклик `bun run coverage`; fallback `n-cursor coverage`
-- **test-команда**: `scripts["test"]` → виклик `bun run test` (або те, що в скрипті); fallback `bun test`
-
-Далі по тексту «coverage-команда» / «test-команда» = знайдені тут значення.
-
-### Крок 1: Згенеруй або переви́користай `COVERAGE.md`
-
-**Early-skip.** Якщо `COVERAGE.md` уже існує, свіжий (новіший за останню зміну source/тестів) і має секцію `## Вцілілі мутанти` — можеш одразу перейти до Кроку 2 без повторної генерації. Інакше — згенеруй звіт:
-
-```bash
-n-cursor coverage   # або coverage-команда з Кроку 0
-```
-
-Ця команда генерує `COVERAGE.md`. Якщо є survived mutants — COVERAGE.md матиме секцію `## Вцілілі мутанти` з JSON-блоком.
-
-### Крок 2: Прочитай компактний index вцілілих
-
-> **Не читай `COVERAGE.md` сам.** Файл може важити мегабайти (секція `## Вцілілі
-мутанти` на сотні файлів) — його читання спалило б сотні тисяч токенів. Важкий
-> парсинг несе CLI; ти отримуєш лише крихітний index.
-
-```bash
-n-cursor coverage-fix index
-```
-
-Друкує компактний JSON-масив `[{ "file": "<path>", "mutants": <N> }]` (кілобайти, не мегабайти). Якщо `[]` — зупинись:
-
-```
-✓ Жодних вцілілих мутантів — mutation score повний. Coverage завершено.
-```
-
-Запам'ятай `prevCount = сума всіх mutants` (загальна кількість вцілілих мутантів).
-
-### Крок 3: Для кожного файлу — slice + Agent
-
-Для кожного запису `{ file, mutants }` з index:
-
-**3a. Визнач test файл (завжди у `tests/` директорії):**
-
-Цільовий: `<dir>/tests/<basename>.test.mjs`
-(де `<dir>` — директорія source-файлу, `<basename>` — ім'я source без розширення)
-
-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`
-
-**3b. Отримай готовий зріз-промпт лише для цього файлу:**
-
-```bash
-n-cursor coverage-fix slice --file <file>
-```
-
-CLI друкує самодостатній промпт **рівно для одного файлу**: список вцілілих мутантів цього файлу (рядок/колонка/`original → replacement`/тип) з контекстом ±3 рядки навколо кожного та фіксовані правила. Це і є «порція під когнітивне навантаження» одного субагента — нічого зайвого.
-
-**3c. Запусти Agent** з цим зрізом як промптом, дописавши один рядок про цільовий test-файл із 3a (`<dir>/tests/<basename>.test.mjs`, з правильними відносними imports). Дочекайся завершення.
-
-### Крок 4: Перевір що всі тести проходять
-
-```bash
-bun test   # або test-команда з Кроку 0
-```
-
-Якщо падають — поверни відповідний Agent з помилкою і попроси виправити.
-
-### Крок 5: Запусти coverage і порівняй
-
-```bash
-n-cursor coverage   # або coverage-команда з Кроку 0
-n-cursor coverage-fix index
-```
-
-`newCount = сума mutants` зі свіжого index (знову — без читання `COVERAGE.md` вручну).
-
-**Рішення:**
-
-- `newCount < prevCount` AND iterations < 3 → повтор з Кроку 2 з оновленим index
-- `newCount >= prevCount` → конвергенція:
-
-  ```
-  ✓ Конвергенція: mutation score більше не покращується.
-  Було вцілілих: <prevCount>, стало: <newCount>.
-  ```
-
-- iterations == 3 → зупинись:
-
-  ```
-  ⚠️ Досягнуто максимум ітерацій (3).
-  Вціліло: <newCount> мутантів. Деякі можуть бути стійкими (dead code, external state).
-  ```
-
-## Конвергенція — нормальний результат
-
-Деякі мутанти неможливо вбити: захищений зовнішній стан, недетермінована логіка, еквівалентні мутації. Не намагайся виправити те що не змінилось після ітерації.
-
-## Нотатки
-
-- Stryker `incremental` (`incrementalFile`) зберігає прогрес між запусками — crash ≠ перезапуск з нуля
-- Не комітити зміни автоматично — user вирішує коли комітити

package/skills/coverage-fix/main.json

@@ -1 +0,0 @@
-{ "auto": ["js"], "worktree": true }