@nitra/cursor 1.27.3 → 1.27.6

package/schemas/v8r-catalog.json

@@ -19,6 +19,12 @@
       "description": "Каталог схем Schema Store (v8r-catalog.json у пакеті)",
       "url": "https://json.schemastore.org/schema-catalog.json",
       "fileMatch": ["npm/schemas/v8r-catalog.json"]
+    },
+    {
+      "name": "tsconfig",
+      "description": "TypeScript config для pi extension templates, які Schema Store не матчить через вкладений/прихований шлях",
+      "url": "https://json.schemastore.org/tsconfig.json",
+      "fileMatch": [".pi/extensions/*/tsconfig.json", "npm/.pi-template/extensions/*/tsconfig.json"]
     }
   ]
 }

package/scripts/coverage-fix.mjs

@@ -1,7 +1,7 @@
 /**
  * `n-cursor coverage --fix`: запускає Claude Code агента для написання тестів
- * по вижилих мутантах Stryker. Агент отримує список мутантів з контекстом
- * (file, line, оригінальний код, вижилий варіант, тип мутації) і самостійно
+ * по вцілілих мутантах Stryker. Агент отримує список мутантів з контекстом
+ * (file, line, оригінальний код, вцілілий варіант, тип мутації) і самостійно
  * знаходить або створює відповідні test-файли.
  *
  * Залежить від `@anthropic-ai/claude-agent-sdk` (dependencies у npm/package.json).
@@ -15,8 +15,8 @@ import { join } from 'node:path'
  */
 
 /**
- * Запускає Claude Code агента для написання тестів по вижилих мутантах.
- * @param {SurvivedFileGroup[]} survived вижилі мутанти, згруповані по файлах
+ * Запускає Claude Code агента для написання тестів по вцілілих мутантах.
+ * @param {SurvivedFileGroup[]} survived вцілілі мутанти, згруповані по файлах
  * @param {string} projectRoot абсолютний шлях до кореня проєкту
  * @returns {Promise<void>}
  */
@@ -28,7 +28,7 @@ export async function fixSurvivedMutants(survived, projectRoot) {
   }
 
   const prompt = await buildFixPrompt(survived, projectRoot)
-  console.log(`\n🤖 coverage --fix: запускаю агента для ${totalMutants} вижилих мутантів...\n`)
+  console.log(`\n🤖 coverage --fix: запускаю агента для ${totalMutants} вцілілих мутантів...\n`)
 
   // Dynamic import: @anthropic-ai/claude-agent-sdk завантажується лише при --fix,
   // щоб не гальмувати звичайний coverage-прогін за відсутності пакету.
@@ -48,9 +48,9 @@ export async function fixSurvivedMutants(survived, projectRoot) {
 }
 
 /**
- * Формує rich-промпт для агента: список вижилих мутантів згрупований по файлах,
+ * Формує rich-промпт для агента: список вцілілих мутантів згрупований по файлах,
  * з контекстом ±3 рядки навколо кожного мутанта з source-файлу.
- * @param {SurvivedFileGroup[]} survived групи вижилих мутантів по файлах
+ * @param {SurvivedFileGroup[]} survived групи вцілілих мутантів по файлах
  * @param {string} projectRoot корінь проєкту
  * @returns {Promise<string>} текст rich-промпту
  */
@@ -66,7 +66,7 @@ async function buildFixPrompt(survived, projectRoot) {
       // файл може бути недоступним — пропускаємо контекст, але продовжуємо
     }
 
-    const mutantDescs = mutants
+    const mutantDescriptions = mutants
       .map(m => {
         const ctxStart = Math.max(0, m.line - 4)
         const ctxEnd = Math.min(srcLines.length, m.line + 3)
@@ -89,15 +89,15 @@ async function buildFixPrompt(survived, projectRoot) {
       ? `\n\nПриклад тесту з \`${exampleTest.testFile}\`:\n\`\`\`js\n${exampleTest.code}\n\`\`\``
       : ''
 
-    sections.push(`### \`${file}\`${exampleSection}\n${mutantDescs}`)
+    sections.push(`### \`${file}\`${exampleSection}\n${mutantDescriptions}`)
   }
 
   return [
-    'Твоє завдання — написати unit-тести, що вбивають наступні вижилі мутанти Stryker.',
+    'Твоє завдання — написати unit-тести, що вбивають наступні вцілілі мутанти Stryker.',
     'Для кожного мутанта: знайди або створи відповідний test-файл, додай тест-кейс,',
-    'що явно перевіряє цю гілку/умову і провалиться якщо код замінити на "вижилий варіант".',
+    'що явно перевіряє цю гілку/умову і провалиться якщо код замінити на "вцілілий варіант".',
     '',
-    '## Вижилі мутанти',
+    '## Вцілілі мутанти',
     '',
     ...sections,
     '',

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

@@ -1,8 +1,8 @@
 /**
- * `n-cursor lint` — оркестратор лінт-ланцюжка з тайменгом на кожен крок.
+ * `n-cursor lint` — оркестратор лінт-ланцюжка з вимірюванням часу на кожен крок.
  *
  * Замість агрегатора `bun run lint-ga && bun run lint-js && ... && oxfmt .` у кореневому
- * `package.json` (де child-процеси анонімні і час кожного не видно), цей орекстратор:
+ * `package.json` (де child-процеси анонімні і час кожного не видно), цей оркестратор:
  *
  *  - читає `scripts` з кореневого `package.json`,
  *  - бере **присутні** ключі з фіксованого списку `LINT_SCRIPTS` (відсутні мовчки пропускає),
@@ -14,7 +14,7 @@
  *
  * Список + порядок зумисне фіксований: збігається з канонічним ланцюжком, що його раніше
  * тримав root `package.json`. Динамічний discovery (`scripts/^lint-/`) дав би непередбачуваний
- * порядок і небажану інтерпретацію кастомних `lint-*` користувача.
+ * порядок і небажану інтерпретацію власних `lint-*` користувача.
  *
  * `oxfmt` — окремий рядок поза префіксом `lint-`, ставиться в кінець (як було у `lint`).
  */
@@ -72,9 +72,9 @@ function readRootScripts(root) {
  */
 
 /**
- * Виконує лінт-ланцюжок з тайменгом. Повертає exit-код, не кидає винятків (для прямого
+ * Виконує лінт-ланцюжок з вимірюванням часу. Повертає exit-код, не кидає винятків (для прямого
  * присвоєння у `process.exitCode`).
- * @param {RunLintCliOptions} [options] DI для тестів (мокаємо spawn / fs / clock)
+ * @param {RunLintCliOptions} [options] DI для тестів (підміняємо spawn / fs / clock)
  * @returns {number} 0 = успіх, ненульовий = code першого впалого скрипта, або 1 при структурних проблемах
  */
 export function runLintCli(options = {}) {

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

@@ -11,7 +11,7 @@ import { spawnSync } from 'node:child_process'
 import { resolveCmd } from '../utils/resolve-cmd.mjs'
 
 /**
- * Запускає один крок lint-обгортки: резолвить `cmd` у PATH і `spawnSync` із успадкованим stdio.
+ * Запускає один крок lint-обгортки: визначає `cmd` у PATH і `spawnSync` із успадкованим stdio.
  * @param {string} title заголовок для логу (наприклад `actionlint`)
  * @param {string} cmd ім'я команди (`bunx`, `uvx`, `npx`, …)
  * @param {string[]} args аргументи команди

package/scripts/lib/run-rule.mjs

@@ -54,7 +54,7 @@ async function evaluateAppliesGate(bundledRulesDir, rule) {
 
 /**
  * Запускає одну policy-полісі через `runConftestBatch`. Створює локальний репортер,
- * читає `target.json`, резолвить файли, фіксує fail/pass — і повертає exit-код.
+ * читає `target.json`, визначає файли, фіксує fail/pass — і повертає exit-код.
  * @param {string} bundledRulesDir абсолютний `rules/`
  * @param {string} ruleId id правила
  * @param {string} concernName імʼя полісі (= підкаталог у `policy/`)

package/scripts/lib/timing-summary.mjs

@@ -1,12 +1,12 @@
 /**
- * Формат таблиці-резюме часу виконання для оркестраторів `fix` / `lint`.
+ * Формат таблиці-резюме часу виконання для orchestrator `fix` / `lint`.
  *
  * Дві спільні точки використання:
  *  - `runFixCommand` у `bin/n-cursor.js` — після прогону всіх `rules/<id>/fix.mjs`.
  *  - `runLintCli` у `scripts/lib/run-lint-cli.mjs` — після прогону `lint-*` скриптів з кореневого `package.json`.
  *
  * Чиста функція без I/O — повертає готовий рядок (з фінальним `\n`), друк — на стороні виклику.
- * Час виводиться як `<ціла>.<десята>s`, навіть для субсекундних інтервалів — щоб одиниця була стабільна.
+ * Час виводиться як `<ціла>.<десята>s`, навіть для коротших за секунду інтервалів — щоб одиниця була стабільна.
  *
  * Маркер `❌` на рядку — якщо `ok === false`.
  * @typedef {{ id: string, ms: number, ok: boolean }} TimingEntry
@@ -40,7 +40,7 @@ export function formatDurationMs(ms) {
  *    total         <sum>
  * ```
  *
- * Ширина колонки id вирівнюється під найдовший id у списку. Мінімальна ширина riski — 14
+ * Ширина колонки id вирівнюється під найдовший id у списку. Мінімальна ширина risk — 14
  * (узгоджено з типовою довжиною заголовків `fix-js-lint` / `lint-security`).
  * @param {string} title заголовок таблиці (наприклад, `Fix timing` або `Lint timing`)
  * @param {TimingEntry[]} timings записи в порядку запуску — друкуються як є, не сортуються

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

@@ -6,9 +6,9 @@
  *
  * Контракт:
  * - stdin Claude Code: JSON із `tool_input.file_path` (відносний шлях зміненого файла);
- * - exit 0, якщо файл не маршрутизується (PostToolUse не блокує turn у будь-якому випадку,
+ * - exit 0, якщо файл не має маршрут (PostToolUse не блокує turn у будь-якому випадку,
  *   але ми лишаємо exit-код прозорим — для діагностики);
- * - інакше spawn `npx --no @nitra/cursor fix <rules…>` із пробрасуванням exit-коду.
+ * - інакше spawn `npx --no @nitra/cursor fix <rules…>` із передаванням exit-коду.
  *
  * Маршрути впорядковані від найбільш специфічного до загального; перший збіг — переможець.
  * `docs/adr/**\/*.md` свідомо повертає `[]`: ADR-нормалізація вже покривається async
@@ -83,7 +83,7 @@ async function readStdin() {
 
 /**
  * Дістає `tool_input.file_path` зі stdin JSON Claude Code. Невалідний JSON
- * або відсутнє поле → `null` (не помилка: дехто з тулів — напр. Bash — не пише `file_path`).
+ * або відсутнє поле → `null` (не помилка: дехто з інструментів — напр. Bash — не пише `file_path`).
  * @param {string} stdinJson сирий вміст stdin
  * @returns {string | null} відносний шлях або `null`
  */
@@ -102,7 +102,7 @@ function extractFilePath(stdinJson) {
 
 /**
  * Точка входу. Викликається з `bin/n-cursor.js` коли argv[0] === `post-tool-use-fix`.
- * Параметри ін'єктовні для тестів: `stdinJson` обходить read від `process.stdin`,
+ * Параметри доступні для інʼєкції для тестів: `stdinJson` обходить read від `process.stdin`,
  * `spawnFn` — заміна `node:child_process.spawn` (повертає EventEmitter-сумісний об'єкт).
  * @param {{ stdinJson?: string, spawnFn?: typeof spawn }} [options] параметри для тестів (ін'єкція stdin/spawn)
  * @returns {Promise<number>} exit code (0 — пропущено / fix ОК; інше — exit-код `fix`)

package/scripts/sync-claude-config.mjs

@@ -467,7 +467,7 @@ export async function removeOrphanAdrHookLib(projectRoot) {
  * перезаписується. Якщо bundled template відсутній (legacy-версії пакета без `.pi-template/`)
  * або в ньому немає `index.ts` — повертаємо `{written: false}` без помилки.
  *
- * Розширення поверх `index.ts` (tsconfig тощо) потрібні, бо `.pi/extensions/` синкається як є
+ * Розширення поверх `index.ts` (tsconfig тощо) потрібні, бо `.pi/extensions/` синхронізується як є
  * у проєкти-споживачі, а IDE/TS-сервер мусить резолвити `node:*` модулі без додаткових
  * project-wide конфігів.
  * @param {string} projectRoot корінь проєкту-споживача
@@ -637,7 +637,7 @@ export async function syncClaudeConfig({ projectRoot, bundledPackageRoot, enable
     ? await syncAdrNormalizeHookScript(projectRoot, templateDir)
     : { written: false, path: '' }
   // Lib-файли мають сенс лише з активним хоча б одним ADR-хуком — без caller'а
-  // нікому source-ити; при вимкненому правилі прибираємо орфан-теку.
+  // нікому source-ити; при вимкненому правилі прибираємо осиротілу-теку.
   const adrHookLibEntries = includeAdrHook
     ? await syncAdrHookLibScripts(projectRoot, templateDir)
     : (await removeOrphanAdrHookLib(projectRoot), [])

package/scripts/utils/ensure-gitignore-entries.mjs

@@ -1,7 +1,7 @@
 /**
- * Idempotent append-only оновлювач `.gitignore` у корені проєкту. Перевіряє,
+ * Idempotent append-only модуль оновлення `.gitignore` у корені проєкту. Перевіряє,
  * чи задані entries уже присутні (точне співпадіння рядка після `trim`); відсутні
- * дописує під header-комент, не порушуючи решту файлу. Якщо `.gitignore` немає —
+ * дописує під header-коментар, не порушуючи решту файлу. Якщо `.gitignore` немає —
  * створюється з заданими entries + header.
  *
  * Викликається з test-концерну `stryker_config` (gitignore Stryker temp dirs).

package/scripts/utils/resolve-cargo-manifest.mjs

@@ -2,7 +2,7 @@
  * Резолвить шлях до Cargo.toml у проєкті: cwd/Cargo.toml або в одному з
  * workspace-підкаталогів (з підтримкою Tauri-патерну `<workspace>/src-tauri/`).
  * Спільна утиліта для coverage-провайдера rust і test-концерну cargo_mutants_config.
- * Повертає null (а не throw) щоб callsite-и могли gracefully skip-нути.
+ * Повертає null (а не throw) щоб callsite-и могли gracefully skip-пропустити.
  */
 import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'

package/scripts/utils/resolve-js-root.mjs

@@ -1,6 +1,6 @@
 /**
  * Резолвить корінь JS-коду в проєкті: для workspace-projects — перший workspace
- * (наприклад `app/` у mlmail), для single-package — корінь cwd. Спільна утиліта
+ * (наприклад `app/` у mail app), для single-package — корінь cwd. Спільна утиліта
  * для coverage-провайдера js-lint і test-концерну stryker_config (DRY).
  */
 import { existsSync } from 'node:fs'

package/scripts/utils/walkDir.mjs

@@ -42,7 +42,7 @@ function isIgnoredDir(dirAbsPosix, ignorePosix) {
  * @param {string} dir абсолютний шлях
  * @param {(filePath: string) => void} onFile виклик для кожного файлу
  * @param {string[]} [ignorePaths] шляхи каталогів (відносні від cwd або абсолютні), що повністю виключаються з обходу
- * @returns {Promise<void>} резолвиться по завершенню обходу
+ * @returns {Promise<void>} визначається по завершенню обходу
  */
 export async function walkDir(dir, onFile, ignorePaths = []) {
   const ignorePosix = ignorePaths.map(p => toAbsPosix(p))
@@ -54,7 +54,7 @@ export async function walkDir(dir, onFile, ignorePaths = []) {
  * @param {string} dir абсолютний шлях каталогу для обходу
  * @param {(filePath: string) => void} onFile колбек, що викликається для кожного звичайного файлу
  * @param {string[]} ignorePosix вже нормалізовані абсолютні posix-шляхи ігнорованих каталогів
- * @returns {Promise<void>} резолвиться по завершенню рекурсії
+ * @returns {Promise<void>} визначається по завершенню рекурсії
  */
 async function walkDirInner(dir, onFile, ignorePosix) {
   if (ignorePosix.length > 0 && isIgnoredDir(toAbsPosix(dir), ignorePosix)) return

package/skills/coverage-fix/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: n-coverage-fix
 description: >-
-  Автономна команда: запускає n-cursor coverage → читає вижилих мутантів → ітеративно пише тести до конвергенції (max 3 ітерації)
+  Автономна команда: запускає n-cursor coverage → читає вцілілих мутантів → ітеративно пише тести до конвергенції (max 3 ітерації)
 ---
 
 # n-coverage-fix — підвищення mutation score
@@ -36,21 +36,21 @@ n-cursor coverage
 bun run coverage
 ```
 
-Ця команда генерує `COVERAGE.md`. Якщо є survived mutants — COVERAGE.md матиме секцію `## Вижилі мутанти` з JSON-блоком.
+Ця команда генерує `COVERAGE.md`. Якщо є survived mutants — COVERAGE.md матиме секцію `## Вцілілі мутанти` з JSON-блоком.
 
-### Крок 2: Перевір вижилих
+### Крок 2: Перевір вцілілих
 
-Прочитай `COVERAGE.md`. Знайди секцію `## Вижилі мутанти`. Знайди фенсований блок ` ```json ` і розпарси JSON-масив.
+Прочитай `COVERAGE.md`. Знайди секцію `## Вцілілі мутанти`. Знайди огороджений блок ` ```json ` і розбери JSON-масив.
 
 Якщо секція відсутня або масив порожній — зупинись:
 
 ```
-✓ Жодних вижилих мутантів — mutation score повний. Coverage завершено.
+✓ Жодних вцілілих мутантів — mutation score повний. Coverage завершено.
 ```
 
 Запам'ятай `prevCount = масив.length`.
 
-### Крок 3: Для кожного файлу — спауни Agent
+### Крок 3: Для кожного файлу — запускає Agent
 
 Згрупуй мутанти по полю `file`. Для кожної групи:
 
@@ -68,8 +68,8 @@ bun run coverage
 **3b. Сформуй промпт для Agent:**
 
 ```
-Тобі дані вижилі мутанти зі Stryker для файлу `<file>`.
-Ці мутанти вижили бо наявні тести НЕ вловили конкретні зміни коду.
+Тобі дані вцілілі мутанти зі Stryker для файлу `<file>`.
+Ці мутанти вціліли, бо наявні тести НЕ вловили конкретні зміни коду.
 
 **Вихідний код** (`<file>`):
 \`\`\`
@@ -81,7 +81,7 @@ bun run coverage
 <зміст test-файлу або "файл ще не існує">
 \`\`\`
 
-**Вижилі мутанти** (кожен — зміна коду що НЕ вловлена):
+**Вцілілі мутанти** (кожен — зміна коду що НЕ вловлена):
 <для кожного мутанта:>
 - Рядок <line>, колонка <col>: `<original>` → `<replacement>` (тип: <mutantType>)
 
@@ -111,21 +111,24 @@ bun test
 n-cursor coverage
 ```
 
-Прочитай новий `COVERAGE.md`. Розпарси JSON-масив вижилих.
+Прочитай новий `COVERAGE.md`. Розбери JSON-масив вцілілих.
 `newCount = новий масив.length`
 
 **Рішення:**
 
 - `newCount < prevCount` AND iterations < 3 → повтор з Кроку 2 з оновленим масивом
 - `newCount >= prevCount` → конвергенція:
+
   ```
   ✓ Конвергенція: mutation score більше не покращується.
-  Було вижилих: <prevCount>, стало: <newCount>.
+  Було вцілілих: <prevCount>, стало: <newCount>.
   ```
+
 - iterations == 3 → зупинись:
+
   ```
   ⚠️ Досягнуто максимум ітерацій (3).
-  Вижило: <newCount> мутантів. Деякі можуть бути невбивними (dead code, external state).
+  Вціліло: <newCount> мутантів. Деякі можуть бути стійкими (dead code, external state).
   ```
 
 ## Конвергенція — нормальний результат

package/skills/fix-tests/SKILL.md

@@ -1,31 +1,31 @@
 ---
 name: n-fix-tests
 description: >-
-  Ітеративно дописати тести щоб підвищити mutation score — читає вижилі мутанти з COVERAGE.md і запускає агент до конвергенції
+  Ітеративно дописати тести щоб підвищити mutation score — читає вцілілі мутанти з COVERAGE.md і запускає агент до конвергенції
 ---
 
 # n-fix-tests — підвищення mutation score
 
 ## Мета
 
-Читає структурований JSON-блок вижилих мутантів з `COVERAGE.md` і ітеративно дописує тести що їх вловлюють. Зупиняється коли score перестає покращуватись (конвергенція).
+Читає структурований JSON-блок вцілілих мутантів з `COVERAGE.md` і ітеративно дописує тести що їх вловлюють. Зупиняється коли score перестає покращуватись (конвергенція).
 
 ## Передумови
 
-- У `COVERAGE.md` є секція `## Вижилі мутанти` з JSON-блоком
+- У `COVERAGE.md` є секція `## Вцілілі мутанти` з JSON-блоком
 - Залежності встановлені (`bun i`)
 - `bun run coverage` (або `n-cursor coverage`) доступний
 
 ## Workflow
 
-### Крок 1: Зчитай вижилих мутантів
+### Крок 1: Зчитай вцілілих мутантів
 
-Прочитай `COVERAGE.md`. Знайди секцію `## Вижилі мутанти`. Знайди фенсований блок ` ```json ` у цій секції і розпарси JSON-масив.
+Прочитай `COVERAGE.md`. Знайди секцію `## Вцілілі мутанти`. Знайди огороджений блок ` ```json ` у цій секції і розбери JSON-масив.
 
 Якщо секція відсутня або масив порожній — зупинись з повідомленням:
-`✓ Жодних вижилих мутантів — mutation score повний`
+`✓ Жодних вцілілих мутантів — mutation score повний`
 
-Запамʼятай поточну кількість вижилих: `prevCount = масив.length`
+Запамʼятай поточну кількість вцілілих: `prevCount = масив.length`
 
 ### Крок 2: Знайди test-команду і coverage-команду
 
@@ -41,7 +41,7 @@ description: >-
 1. `scripts["coverage"]` з `package.json` → виклик: `bun run coverage`
 2. fallback: `n-cursor coverage`
 
-### Крок 3: Для кожного файлу — спауни Agent
+### Крок 3: Для кожного файлу — запускає Agent
 
 Згрупуй мутанти по полю `file`. Для кожної групи виконай:
 
@@ -61,8 +61,8 @@ description: >-
 **3b. Сформуй промпт для Agent:**
 
 ```
-Тобі дані вижилі мутанти зі Stryker для файлу `<file>`.
-Ці мутанти вижили тому що наявні тести НЕ вловили конкретні зміни коду.
+Тобі дані вцілілі мутанти зі Stryker для файлу `<file>`.
+Ці мутанти вціліли, тому що наявні тести НЕ вловили конкретні зміни коду.
 
 **Вихідний код** (`<file>`):
 \`\`\`
@@ -74,7 +74,7 @@ description: >-
 <зміст test-файлу або "файл ще не існує">
 \`\`\`
 
-**Вижилі мутанти** (кожен — зміна коду що НЕ вловлена):
+**Вцілілі мутанти** (кожен — зміна коду що НЕ вловлена):
 <для кожного мутанта:>
 - Рядок <line>, колонка <col>: `<original>` → `<replacement>` (тип мутації: <mutantType>)
 
@@ -105,14 +105,14 @@ bun test  # або test-команда з кроку 2
 bun run coverage  # або coverage-команда з кроку 2
 ```
 
-Прочитай новий `COVERAGE.md`, знайди і розпарси JSON-масив вижилих.
+Прочитай новий `COVERAGE.md`, знайди і розбери JSON-масив вцілілих.
 `newCount = новий масив.length`
 
 **Рішення:**
 
 - Якщо `newCount < prevCount` → повтор з Кроку 1 з оновленим масивом
 - Якщо `newCount >= prevCount` → зупинись:
-  `✓ Конвергенція: mutation score більше не покращується. Вижило: <newCount> мутантів.`
+  `✓ Конвергенція: mutation score більше не покращується. Вціліло: <newCount> мутантів.`
 
 ## Зупинка після конвергенції