@nitra/cursor 3.26.0 → 3.28.0

package/skills/fix/js/t0.mjs

@@ -0,0 +1,213 @@
+/** @see ./docs/t0.md */
+import { existsSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
+import { join } from 'node:path'
+import { spawnSync } from 'node:child_process'
+import { dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+/**
+ * Патерни T0-auto.
+ * Кожен паттерн: {
+ *   id:      string         — унікальна назва паттерну (для логу)
+ *   test:    (output)=>bool — чи підходить цей output до паттерну
+ *   apply:   (match, cwd)=>{ ok: bool, action: string } — застосувати фікс
+ * }
+ */
+const PATTERNS = [
+  // ── vscode-ext-add ──────────────────────────────────────────────────────────
+  // Violation: «recommendations має містити "tsandall.opa"»
+  // Fix: додати рядок у .vscode/extensions.json#recommendations
+  {
+    id: 'vscode-ext-add',
+    test: out => /recommendations має містити "[^"]+"/.test(out),
+    apply: (out, cwd) => {
+      const matches = [...out.matchAll(/recommendations має містити "([^"]+)"/g)]
+      if (matches.length === 0) return { ok: false, action: 'no match' }
+
+      const extPath = join(cwd, '.vscode/extensions.json')
+      if (!existsSync(extPath)) {
+        return { ok: false, action: '.vscode/extensions.json не знайдено' }
+      }
+
+      let parsed
+      try {
+        parsed = JSON.parse(readFileSync(extPath, 'utf8'))
+      } catch {
+        return { ok: false, action: '.vscode/extensions.json: невалідний JSON' }
+      }
+
+      const recs = Array.isArray(parsed.recommendations) ? parsed.recommendations : []
+      const toAdd = matches.map(m => m[1]).filter(e => !recs.includes(e))
+      if (toAdd.length === 0) return { ok: false, action: 'вже є' }
+
+      parsed.recommendations = [...recs, ...toAdd]
+      writeFileSync(extPath, JSON.stringify(parsed, null, 2) + '\n', 'utf8')
+      return { ok: true, action: `додано до extensions.json: ${toAdd.join(', ')}` }
+    }
+  },
+
+  // ── rm-forbidden-file ────────────────────────────────────────────────────────
+  // Violation: «Знайдено заборонений файл: package-lock.json»
+  // Fix: видалити файл
+  {
+    id: 'rm-forbidden-file',
+    test: out => /Знайдено заборонений файл: \S+/.test(out),
+    apply: (out, cwd) => {
+      const matches = [...out.matchAll(/Знайдено заборонений файл: (\S+)/g)]
+      if (matches.length === 0) return { ok: false, action: 'no match' }
+
+      const removed = []
+      for (const m of matches) {
+        const filePath = join(cwd, m[1])
+        if (existsSync(filePath)) {
+          rmSync(filePath, { force: true })
+          removed.push(m[1])
+        }
+      }
+      if (removed.length === 0) return { ok: false, action: 'файлів не знайдено' }
+      return { ok: true, action: `видалено: ${removed.join(', ')}` }
+    }
+  }
+]
+
+/**
+ * Застосовує всі T0-auto паттерни до одного violation-output.
+ *
+ * @param {string} ruleId id правила (для логу)
+ * @param {string} violationOutput рядок з поля `output` у `fix --json`
+ * @param {string} cwd корінь проєкту
+ * @returns {{ applied: boolean, actions: string[] }}
+ */
+export function applyT0Auto(ruleId, violationOutput, cwd) {
+  const actions = []
+  let applied = false
+
+  for (const p of PATTERNS) {
+    if (!p.test(violationOutput)) continue
+    const result = p.apply(violationOutput, cwd)
+    actions.push(`[${p.id}] ${result.action}`)
+    if (result.ok) {
+      applied = true
+    }
+  }
+
+  return { applied, actions }
+}
+
+/**
+ * Повертає список id правил, для яких є хоча б один T0-auto паттерн
+ * (визначається по violation-output із `fix --json`).
+ *
+ * @param {{ ruleId: string, output: string }[]} failedRules
+ * @returns {string[]}
+ */
+export function filterT0AutoRules(failedRules) {
+  return failedRules.filter(r => PATTERNS.some(p => p.test(r.output))).map(r => r.ruleId)
+}
+
+// ─── CLI entry-point ──────────────────────────────────────────────────────────
+
+const HERE = dirname(fileURLToPath(import.meta.url))
+/** Абсолютний шлях до npm/bin/n-cursor.js відносно цього файлу */
+const N_CURSOR_BIN = join(HERE, '../../../bin/n-cursor.js')
+
+/**
+ * CLI підкоманда `n-cursor fix-t0 [rule...]`.
+ * Запускає `fix --json`, застосовує T0-auto для кожного violation,
+ * повторно перевіряє check-gate, виводить підсумок.
+ *
+ * @param {string[]} args аргументи підкоманди (опційний список rule-ids)
+ * @param {string}   cwd  корінь проєкту
+ * @returns {Promise<number>} 0 — T0-auto закрив всі або немає порушень; 1 — лишились
+ */
+export async function runT0AutoCli(args, cwd) {
+  const ruleFilter = args.filter(a => !a.startsWith('--'))
+  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 raw = fixResult.stdout?.trim()
+  if (!raw) {
+    console.error(`n-cursor fix-t0: fix --json повернув порожній stdout`)
+    console.error(fixResult.stderr?.slice(0, 300) ?? '')
+    return 1
+  }
+
+  let fixJson
+  try {
+    fixJson = JSON.parse(raw)
+  } catch {
+    console.error(`n-cursor fix-t0: fix --json повернув невалідний JSON`)
+    return 1
+  }
+
+  const failed = fixJson.rules.filter(r => !r.ok)
+  if (failed.length === 0) {
+    console.log(`✅ fix-t0: всі правила чисті — T0 не потрібен`)
+    return 0
+  }
+
+  // 2. Застосувати T0-auto
+  const applied = []
+  const skipped = []
+  for (const r of failed) {
+    const result = applyT0Auto(r.ruleId, r.output, cwd)
+    if (result.applied) {
+      applied.push({ ruleId: r.ruleId, actions: result.actions })
+    } else {
+      skipped.push(r.ruleId)
+    }
+  }
+
+  if (applied.length === 0) {
+    console.log(`⏭️  fix-t0: T0-auto паттерн не підходить для: ${failed.map(r => r.ruleId).join(', ')}`)
+    return 1
+  }
+
+  // 3. Вивести що зробили
+  for (const { ruleId, actions } of applied) {
+    console.log(`⚙️  ${ruleId}:`)
+    for (const a of actions) console.log(`   ${a}`)
+  }
+
+  // 4. Check-gate: перевірити лише ті правила, що ми чіпали
+  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`)
+    return 1
+  }
+
+  const recheckJson = JSON.parse(recheckRaw)
+  const stillFailed = recheckJson.rules.filter(r => !r.ok)
+
+  if (verbose) {
+    for (const r of recheckJson.rules) {
+      console.log(`  ${r.ok ? '✅' : '❌'} ${r.ruleId}`)
+    }
+  }
+
+  if (stillFailed.length > 0) {
+    console.log(`❌ fix-t0 check-gate: ${stillFailed.map(r => r.ruleId).join(', ')} — лишились`)
+    if (skipped.length > 0) {
+      console.log(`⏭️  без T0 паттерну: ${skipped.join(', ')} → потрібен LLM`)
+    }
+    return 1
+  }
+
+  const totalFixed = applied.length
+  const total = failed.length
+  console.log(
+    `✅ fix-t0: ${totalFixed}/${total} правил закрито T0-auto` +
+      (skipped.length > 0 ? `; ${skipped.join(', ')} → T1 (LLM)` : '')
+  )
+  return 0
+}

package/skills/fix/meta.json

@@ -1 +1 @@
-{ "auto": "завжди", "worktree": true }
+{ "auto": "завжди", "worktree": true, "orchestrator": true }

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`.