@nitra/cursor 3.27.0 → 3.28.0

package/skills/fix/js/t0.mjs

@@ -1,18 +1,4 @@
-/**
- * T0-auto: детермінований рівень виправлень для n-fix оркестратора.
- *
- * Парсить `output` з `n-cursor fix --json` → застосовує програмний фікс без LLM.
- * Умова застосування: violation-message містить конкретне цільове значення
- * (назву файлу, рядок для вставки, ім'я залежності), яке можна видобути regex.
- *
- * Ієрархія: T0 (rm/create, знаний тип) → T0-auto (parse violation) → T1 (LLM).
- * T0-auto запускається першим у конвергентному циклі; T1 — лише для решти.
- *
- * Публічний API:
- *   applyT0Auto(ruleId, violationOutput, cwd) → { applied: boolean, actions: string[] }
- *   listT0AutoRules()                         → string[]  (ids що мають хоч один паттерн)
- *   runT0AutoCli(args, cwd)                   → Promise<number>  (exit 0=clean, 1=violation)
- */
+/** @see ./docs/t0.md */
 import { existsSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
 import { join } from 'node:path'
 import { spawnSync } from 'node:child_process'
@@ -57,7 +43,7 @@ const PATTERNS = [
       parsed.recommendations = [...recs, ...toAdd]
       writeFileSync(extPath, JSON.stringify(parsed, null, 2) + '\n', 'utf8')
       return { ok: true, action: `додано до extensions.json: ${toAdd.join(', ')}` }
-    },
+    }
   },
 
   // ── rm-forbidden-file ────────────────────────────────────────────────────────
@@ -80,8 +66,8 @@ const PATTERNS = [
       }
       if (removed.length === 0) return { ok: false, action: 'файлів не знайдено' }
       return { ok: true, action: `видалено: ${removed.join(', ')}` }
-    },
-  },
+    }
+  }
 ]
 
 /**
@@ -116,9 +102,7 @@ export function applyT0Auto(ruleId, violationOutput, cwd) {
  * @returns {string[]}
  */
 export function filterT0AutoRules(failedRules) {
-  return failedRules
-    .filter(r => PATTERNS.some(p => p.test(r.output)))
-    .map(r => r.ruleId)
+  return failedRules.filter(r => PATTERNS.some(p => p.test(r.output))).map(r => r.ruleId)
 }
 
 // ─── CLI entry-point ──────────────────────────────────────────────────────────
@@ -141,11 +125,11 @@ export async function runT0AutoCli(args, cwd) {
   const verbose = args.includes('--verbose') || args.includes('-v')
 
   // 1. Запустити fix --json
-  const fixResult = spawnSync(
-    'bun',
-    [N_CURSOR_BIN, '_fix-check', ...ruleFilter],
-    { cwd, encoding: 'utf8', timeout: 120_000 }
-  )
+  const fixResult = spawnSync('bun', [N_CURSOR_BIN, '_fix-check', ...ruleFilter], {
+    cwd,
+    encoding: 'utf8',
+    timeout: 120_000
+  })
   const raw = fixResult.stdout?.trim()
   if (!raw) {
     console.error(`n-cursor fix-t0: fix --json повернув порожній stdout`)
@@ -191,11 +175,11 @@ export async function runT0AutoCli(args, cwd) {
   }
 
   // 4. Check-gate: перевірити лише ті правила, що ми чіпали
-  const recheck = spawnSync(
-    'bun',
-    [N_CURSOR_BIN, '_fix-check', ...applied.map(a => a.ruleId)],
-    { cwd, encoding: 'utf8', timeout: 120_000 }
-  )
+  const recheck = spawnSync('bun', [N_CURSOR_BIN, '_fix-check', ...applied.map(a => a.ruleId)], {
+    cwd,
+    encoding: 'utf8',
+    timeout: 120_000
+  })
   const recheckRaw = recheck.stdout?.trim()
   if (!recheckRaw) {
     console.error(`fix-t0: check-gate: fix --json повернув порожній stdout`)
@@ -223,7 +207,7 @@ export async function runT0AutoCli(args, cwd) {
   const total = failed.length
   console.log(
     `✅ fix-t0: ${totalFixed}/${total} правил закрито T0-auto` +
-    (skipped.length > 0 ? `; ${skipped.join(', ')} → T1 (LLM)` : '')
+      (skipped.length > 0 ? `; ${skipped.join(', ')} → T1 (LLM)` : '')
   )
   return 0
 }

package/skills/start-check/js/check.mjs

@@ -1,19 +1,4 @@
-/**
- * `n-cursor start-check scan|run` — детермінована частина smoke-перевірки
- * bun-монорепо для скілу `n-start-check`.
- *
- * Мотивація: скіл раніше казав LLM-агенту вручну розгортати glob-воркспейси,
- * читати кожен `package.json`, класифікувати `start` (сервер vs CLI), запускати
- * процес із таймаутом через `perl alarm`, інтерпретувати exit-коди й парсити лог
- * на рядки готовності/помилки. Усе це детерміновано — скрипт робить це надійно й
- * крос-платформно (`spawnSync` з `timeout`), а агент лишається тільки з
- * діагностикою: **чому** саме воркспейс упав.
- *
- * `scan` — `[{workspace, name, hasStart, startCmd, type}]`.
- * `run <ws>` — `{workspace, type, exitCode, timedOut, status, ready, firstError,
- * logTail, sideEffects}` (sideEffects — read-only git-diff проти стану до запуску;
- * власне відкат лишається явним кроком скіла).
- */
+/** @see ./docs/check.md */
 import { spawnSync } from 'node:child_process'
 import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'

package/skills/start-check/js/docs/check.md

@@ -0,0 +1,34 @@
+# check.mjs
+
+## Огляд
+
+Файл `n-cursor start-check scan|run` є частиною smoke-перевірки для скілу `n-start-check`. Він автоматично аналізує та запускає воркспейси, визначаючи тип стартового скрипта (сервер чи CLI) та перевіряючи успішність його виконання з обмеженням часу. Результати аналізу та запуску записуються у форматі JSON для подальшого аналізу та діагностики проблем.
+
+## Поведінка
+
+- `classifyStartType` визначає, чи є команда `start` CLI чи довгим процесом (сервером).
+- `scanStartWorkspaces` сканує монорепо, визначаючи воркспейси з `start`, їхні команди та типи.
+- `parseStartLog` витягує готовність, першу помилку та хвіст логу з процесу.
+- `runWorkspaceStart` запускає команду `start` воркспейсу з grace-таймаутом, класифікує результат та повертає інформацію про процес.
+- `runStartCheckCli` виконує `scan` або `run` воркспейсу, приймаючи аргументи командного рядка.
+
+## Публічний API
+
+- classifyStartType — Визначає, чи є команда `start` сервером або CLI.
+- scanStartWorkspaces — Перевіряє монорепо на наявність команди `start` та її типу у кожному воркспейсі.
+- parseStartLog — Аналізує лог процесу `start` для виявлення статусу, помилок та кінця.
+- runWorkspaceStart — Запускає команду `start` у воркспейсі з обмеженим часом та визначає результат.
+- runStartCheckCli — Запускає CLI для сканування воркспейсів з `start` та індивідуального запуску воркспейсу з подальшим виводом результатів у JSON.
+
+## Гарантії поведінки
+
+- Скрипт детерміновано виконує перевірку запуску воркспейса.
+- Скрипт використовує `spawnSync` з таймаутом для запуску процесів.
+- Скрипт інтерпретує exit-коди та парсить логи.
+- Результат перевірки воркспейса представлений у форматі `[{workspace, name, hasStart, startCmd, type}]`.
+- У разі невдачі перевірки, скрипт повертає `false` або `null`.
+- Скрипт не кидає винятків.
+- Скрипт не використовує кешування.
+- Скрипт не взаємодіє з мережею.
+- Результат запуску воркспейса представлений у форматі `{workspace, type, exitCode, timedOut, status, ready, firstError, logTail, sideEffects}`.
+- `sideEffects` містить відкат стану воркспейса до його початкового стану перед запуском.

package/skills/taze/js/diff.mjs

@@ -1,18 +1,4 @@
-/**
- * `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 вважаємо
- * сумісними.
- */
+/** @see ./docs/diff.md */
 import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
 import { join } from 'node:path'

package/skills/taze/js/docs/diff.md

@@ -0,0 +1,33 @@
+# diff.mjs
+
+## Огляд
+
+Файл `n-cursor taze diff` порівнює поточну версію `package.json` з її резервною копією (`package.json.taze-bak`) для виявлення змін залежностей. Він класифікує ці зміни за семантикою версій (major, minor, patch) та надає список оновлень, які потребують уваги. Це автоматизує процес, який раніше виконувався вручну, забезпечуючи швидкий та точний аналіз змін у залежностях монорепо.
+
+## Поведінка
+
+`parseVersion` парсує версійний specifier, ігноруючи range-префікси, і повертає об'єкт з major, minor та patch компонентами, або null, якщо spec не є semver.
+`isBreaking` визначає, чи є перехід від старої до нової версії "breaking" за caret-семантикою.
+`diffPackageJson` порівнює два об'єкти `package.json`, виявляє major-оновлення та підраховує minor/patch зміни для залежностей.
+`collectTazeDiff` збирає diff по всіх воркспейсах монорепо, порівнюючи `package.json` з бекапом, та повертає список major-оновлень, кількість minor/patch змін, загальну кількість порівняних воркспейсів та кількість воркспейсів, які були порівняні.
+`runTazeCli` запускає CLI `n-cursor taze diff`, збирає diff по воркспейсах, та виводить результат у форматі JSON.
+
+## Публічний API
+
+- parseVersion — Розбирає semver-версію з специфікатора.
+- isBreaking — Визначає, чи є перехід breaking за caret-семантикою.
+- diffPackageJson — Порівнює два package.json-об'єкти та визначає зміни залежностей.
+- collectTazeDiff — Збирає diff для монорепо, порівнюючи package.json з резервною копією.
+- runTazeCli — Запускає CLI для виведення компактного JSON з інформацією про major-оновлення та кількість minor/patch.
+
+## Гарантії поведінки
+
+- Скрипт повертає `true`, якщо всі воркспейси монорепо успішно порівняні.
+- Скрипт повертає `false` та `null`, якщо виникла будь-яка помилка під час порівняння.
+- Результат порівняння завжди є `null`, якщо `package.json` або `package.json.taze-bak` не є валідним JSON.
+- Результат порівняння містить список major-оновлень, визначених за caret-семантикою.
+- Minor та patch оновлення не включаються в результат.
+- Результат завжди детермінований, тобто при однаковому вході скрипт завжди повертає однаковий результат.
+- Скрипт не використовує кешування.
+- Скрипт не кидає винятків.
+- Скрипт перехоплює помилки та повертає `false` та `null`.