@nitra/cursor 3.21.1 → 3.23.0

package/skills/taze/js/diff.mjs

@@ -0,0 +1,154 @@
+/**
+ * `n-cursor taze diff` — read-only детермінований diff версій залежностей між
+ * `package.json` і його бекапом `package.json.taze-bak` (root + усі воркспейси
+ * монорепо), із класифікацією кожної зміни за semver.
+ *
+ * Мотивація: скіл `n-taze` раніше казав LLM-агенту вручну порівнювати backup із
+ * новим `package.json` по всіх воркспейсах і вирішувати, де «змінилась перша
+ * значуща цифра semver» (major). Це детермінований JSON-diff + semver-логіка —
+ * скрипт робить це за мілісекунди й без помилок, а агент отримує готовий список
+ * major-оновлень для справді когнітивної роботи (читання CHANGELOG, рефакторинг).
+ *
+ * «Breaking» (major) рахуємо за caret-семантикою — змінилась найлівіша ненульова
+ * компонента: `1.x→2.x`, `0.4.x→0.5.x`, `0.0.3→0.0.4`. Minor/patch вважаємо
+ * сумісними.
+ */
+import { existsSync } from 'node:fs'
+import { readFile } from 'node:fs/promises'
+import { join } from 'node:path'
+
+import { getMonorepoPackageRootDirs } from '../../../scripts/lib/workspaces.mjs'
+
+/** Поля package.json із залежностями, які порівнюємо. */
+const DEP_FIELDS = ['dependencies', 'devDependencies', 'peerDependencies', 'optionalDependencies']
+
+/** Дефолтний суфікс бекапу, який створює крок 1 скіла (`cp package.json package.json.taze-bak`). */
+const DEFAULT_BACKUP_SUFFIX = '.taze-bak'
+
+// Заякорено на початок (після можливих range-операторів `^~>=<`, пробілів, `v`),
+// щоб НЕ ловити версію всередині protocol-specifier-ів (`workspace:1.0.0`, `npm:x@1.2.3`).
+const SEMVER_RE = /^[\s~^>=<v]*(\d+)\.(\d+)\.(\d+)/
+
+/**
+ * Парсить semver-ядро зі specifier-а (ігнорує range-префікси `^`/`~`/`>=` тощо).
+ * @param {string} spec версійний specifier із package.json
+ * @returns {{major:number, minor:number, patch:number}|null} ядро або null для не-semver (`workspace:*`, git-url, `*`)
+ */
+export function parseVersion(spec) {
+  if (typeof spec !== 'string') return null
+  const m = SEMVER_RE.exec(spec)
+  if (!m) return null
+  return { major: Number(m[1]), minor: Number(m[2]), patch: Number(m[3]) }
+}
+
+/**
+ * Чи є перехід `from → to` breaking за caret-семантикою (змінилась найлівіша
+ * ненульова компонента).
+ * @param {{major:number,minor:number,patch:number}} from стара версія
+ * @param {{major:number,minor:number,patch:number}} to нова версія
+ * @returns {boolean} true — major/breaking
+ */
+export function isBreaking(from, to) {
+  if (from.major !== to.major) return true
+  if (from.major > 0) return false
+  if (from.minor !== to.minor) return true
+  if (from.minor > 0) return false
+  return from.patch !== to.patch
+}
+
+/**
+ * Порівнює два package.json-обʼєкти й повертає зміни залежностей.
+ * @param {object} oldPkg розпарсений старий package.json (бекап)
+ * @param {object} newPkg розпарсений новий package.json
+ * @param {string} workspace мітка воркспейсу (`.` для кореня)
+ * @returns {{major: Array<{workspace:string, pkg:string, from:string, to:string}>, minorPatch:number}} зміни
+ */
+export function diffPackageJson(oldPkg, newPkg, workspace) {
+  const major = []
+  let minorPatch = 0
+  for (const field of DEP_FIELDS) {
+    const oldDeps = oldPkg?.[field]
+    const newDeps = newPkg?.[field]
+    if (!oldDeps || !newDeps) continue
+    for (const [pkg, from] of Object.entries(oldDeps)) {
+      const to = newDeps[pkg]
+      if (to === undefined || to === from) continue
+      const fromV = parseVersion(from)
+      const toV = parseVersion(to)
+      if (fromV && toV && isBreaking(fromV, toV)) {
+        major.push({ workspace, pkg, from, to })
+      } else {
+        minorPatch += 1
+      }
+    }
+  }
+  return { major, minorPatch }
+}
+
+/**
+ * Читає JSON-файл або повертає null, якщо файл відсутній / невалідний.
+ * @param {string} path абсолютний шлях
+ * @returns {Promise<object|null>} розпарсений обʼєкт або null
+ */
+async function readJsonOrNull(path) {
+  if (!existsSync(path)) return null
+  try {
+    return JSON.parse(await readFile(path, 'utf8'))
+  } catch {
+    return null
+  }
+}
+
+/**
+ * Збирає diff по всьому монорепо: для кожного воркспейсу порівнює
+ * `<ws>/package.json` з `<ws>/package.json<backupSuffix>`.
+ * @param {string} cwd корінь репозиторію
+ * @param {string} [backupSuffix] суфікс бекап-файлу
+ * @returns {Promise<{major: Array<{workspace:string, pkg:string, from:string, to:string}>, minorPatch:number, totalChanged:number, comparedWorkspaces:number}>} агрегований diff
+ */
+export async function collectTazeDiff(cwd, backupSuffix = DEFAULT_BACKUP_SUFFIX) {
+  const roots = await getMonorepoPackageRootDirs(cwd)
+  const major = []
+  let minorPatch = 0
+  let comparedWorkspaces = 0
+  for (const ws of roots) {
+    const dir = join(cwd, ws)
+    const oldPkg = await readJsonOrNull(join(dir, `package.json${backupSuffix}`))
+    const newPkg = await readJsonOrNull(join(dir, 'package.json'))
+    if (!oldPkg || !newPkg) continue
+    comparedWorkspaces += 1
+    const res = diffPackageJson(oldPkg, newPkg, ws)
+    major.push(...res.major)
+    minorPatch += res.minorPatch
+  }
+  return { major, minorPatch, totalChanged: major.length + minorPatch, comparedWorkspaces }
+}
+
+const USAGE = 'Usage: n-cursor taze diff [--backup-suffix <suffix>]'
+
+/**
+ * CLI: `n-cursor taze diff` друкує компактний JSON зі списком major-оновлень і
+ * лічбою minor/patch. Read-only.
+ * @param {string[]} args аргументи після `taze`
+ * @param {string} [cwd] корінь репозиторію (ін'єкція для тестів)
+ * @returns {Promise<number>} exit code
+ */
+export async function runTazeCli(args, cwd = process.cwd()) {
+  if (args[0] !== 'diff') {
+    console.error(USAGE)
+    return 1
+  }
+  const flagAt = args.indexOf('--backup-suffix')
+  const backupSuffix = flagAt === -1 ? DEFAULT_BACKUP_SUFFIX : args[flagAt + 1]
+  if (!backupSuffix) {
+    console.error(USAGE)
+    return 1
+  }
+  const diff = await collectTazeDiff(cwd, backupSuffix)
+  if (diff.comparedWorkspaces === 0) {
+    console.error(`✗ Не знайдено жодного package.json${backupSuffix} — спершу зроби бекап (крок 1 скіла).`)
+    return 1
+  }
+  process.stdout.write(`${JSON.stringify(diff)}\n`)
+  return 0
+}

package/types/bin/n-cursor.d.ts

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-export {};
+export {}

package/skills/fix-tests/SKILL.md

@@ -1,119 +0,0 @@
----
-name: n-fix-tests
-description: >-
-  Ітеративно дописати тести щоб підвищити mutation score — читає вцілілі мутанти з COVERAGE.md і запускає агент до конвергенції
----
-
-# n-fix-tests — підвищення mutation score
-
-## Мета
-
-Читає структурований JSON-блок вцілілих мутантів з `COVERAGE.md` і ітеративно дописує тести що їх вловлюють. Зупиняється коли score перестає покращуватись (конвергенція).
-
-## Передумови
-
-- У `COVERAGE.md` є секція `## Вцілілі мутанти` з JSON-блоком
-- Залежності встановлені (`bun i`)
-- `bun run coverage` (або `n-cursor coverage`) доступний
-
-## Workflow
-
-### Крок 1: Зчитай вцілілих мутантів
-
-Прочитай `COVERAGE.md`. Знайди секцію `## Вцілілі мутанти`. Знайди огороджений блок ` ```json ` у цій секції і розбери JSON-масив.
-
-Якщо секція відсутня або масив порожній — зупинись з повідомленням:
-`✓ Жодних вцілілих мутантів — mutation score повний`
-
-Запамʼятай поточну кількість вцілілих: `prevCount = масив.length`
-
-### Крок 2: Знайди test-команду і coverage-команду
-
-Прочитай `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`
-
-### Крок 3: Для кожного файлу — запускає Agent
-
-Згрупуй мутанти по полю `file`. Для кожної групи виконай:
-
-**3a. Знайди / визнач test файл (завжди у `tests/` директорії):**
-
-Цільовий файл завжди: `<dir>/tests/<basename>.test.mjs`
-(де `<dir>` — директорія source-файлу, `<basename>` — ім'я без розширення)
-
-- Source: `<cwd>/<file>` (прочитай вміст)
-- 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:**
-
-```
-Тобі дані вцілілі мутанти зі Stryker для файлу `<file>`.
-Ці мутанти вціліли, тому що наявні тести НЕ вловили конкретні зміни коду.
-
-**Вихідний код** (`<file>`):
-\`\`\`
-<зміст source-файлу>
-\`\`\`
-
-**Наявні тести** (`<test-file>`):
-\`\`\`
-<зміст test-файлу або "файл ще не існує">
-\`\`\`
-
-**Вцілілі мутанти** (кожен — зміна коду що НЕ вловлена):
-<для кожного мутанта:>
-- Рядок <line>, колонка <col>: `<original>` → `<replacement>` (тип мутації: <mutantType>)
-
-**Завдання:**
-Допиши мінімальні test-cases у файл `<test-file>` які б вловили кожен із перелічених мутантів.
-Правила:
-- НЕ видаляй і НЕ змінюй наявні тести
-- Стиль тестів — відповідно до наявного файлу (той самий фреймворк, той самий стиль 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>` і переконайся що всі тести проходять (виправ якщо падають)
-```
-
-**3c. Запусти Agent** з цим промптом і дочекайся завершення.
-
-### Крок 4: Перевір що всі тести проходять
-
-```bash
-bun test  # або test-команда з кроку 2
-```
-
-Якщо тести падають — поверни конкретний Agent (для того файлу) з помилкою і попроси виправити.
-
-### Крок 5: Запусти coverage і порівняй
-
-```bash
-bun run coverage  # або coverage-команда з кроку 2
-```
-
-Прочитай новий `COVERAGE.md`, знайди і розбери JSON-масив вцілілих.
-`newCount = новий масив.length`
-
-**Рішення:**
-
-- Якщо `newCount < prevCount` → повтор з Кроку 1 з оновленим масивом
-- Якщо `newCount >= prevCount` → зупинись:
-  `✓ Конвергенція: mutation score більше не покращується. Вціліло: <newCount> мутантів.`
-
-## Зупинка після конвергенції
-
-Конвергенція — нормальний результат. Деякі мутанти не можна вбити (захищений зовнішнім станом, недетермінована логіка тощо). Не намагайся виправити те що не змінилось після ітерації.

package/skills/fix-tests/meta.json

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