@nitra/cursor 11.4.0 → 12.0.0

package/scripts/worktree-cli.mjs

@@ -1,230 +0,0 @@
-/**
- * CLI-оркестратор worktree-tool `n-cursor worktree` (виконавець конвенції `.worktrees/`).
- *
- * Підкоманди:
- *   add <branch> "<опис>"     — git worktree add .worktrees/<sanit> -b <branch> (від HEAD) + .md-опис + нагадування про незакомічені зміни
- *   remove <branch> [--force] — прибрати checkout + .md (гілку лишає)
- *   list                      — git worktree list + вміст .md-описів
- *   prune                     — git worktree prune + видалити осиротілі .md
- *
- * Чисті функції (санітизація, шляхи, текст опису, осиротілі) — у `lib/worktree.mjs`.
- * Тут лише git-виклики, запис файлів, парсинг argv і звіт.
- */
-import { spawnSync } from 'node:child_process'
-import { existsSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
-import { join } from 'node:path'
-import { cwd as processCwd } from 'node:process'
-
-import {
-  buildDescription,
-  buildDirtyNotice,
-  findOrphanDescFiles,
-  firstFreeBranch,
-  worktreePaths
-} from './lib/worktree.mjs'
-
-const USAGE = [
-  'Usage:',
-  '  npx @nitra/cursor worktree add <branch> "<опис>"',
-  '  npx @nitra/cursor worktree remove <branch> [--force]',
-  '  npx @nitra/cursor worktree list',
-  '  npx @nitra/cursor worktree prune'
-].join('\n')
-
-/**
- * Запускає git, повертає { status, stdout, stderr }.
- * @param {string[]} args аргументи git
- * @param {string} cwd робочий каталог
- * @returns {{ status: number, stdout: string, stderr: string }} результат
- */
-function git(args, cwd) {
-  const r = spawnSync('git', args, { cwd, encoding: 'utf8' })
-  return { status: r.status ?? 1, stdout: r.stdout ?? '', stderr: r.stderr ?? '' }
-}
-
-/**
- * Поточна дата YYYY-MM-DD (ін'єкція через ctx.now для тестів).
- * @param {() => Date} now фабрика дати
- * @returns {string} дата у форматі YYYY-MM-DD
- */
-function today(now) {
-  return now().toISOString().slice(0, 10)
-}
-
-/**
- * Реєстровані worktree-checkout (абсолютні шляхи) з `git worktree list --porcelain`.
- * @param {string} cwd корінь репо
- * @returns {string[]} абсолютні шляхи checkout
- */
-function listRegisteredCheckouts(cwd) {
-  return git(['worktree', 'list', '--porcelain'], cwd)
-    .stdout.split('\n')
-    .filter(line => line.startsWith('worktree '))
-    .map(line => line.slice('worktree '.length).trim())
-}
-
-/**
- * Абсолютні шляхи `.worktrees/*.md`.
- * @param {string} cwd корінь репо
- * @returns {string[]} шляхи файлів-описів
- */
-function listDescFiles(cwd) {
-  const dir = join(cwd, '.worktrees')
-  if (!existsSync(dir)) return []
-  return readdirSync(dir)
-    .filter(n => n.endsWith('.md'))
-    .map(n => join(dir, n))
-}
-
-/**
- * add: створити worktree від HEAD + .md-опис.
- * @param {string[]} rest [branch, ...descParts]
- * @param {{ cwd: string, log: (line: string) => void, logError: (line: string) => void, now: () => Date }} ctx контекст
- * @returns {number} exit code
- */
-function cmdAdd(rest, ctx) {
-  const [branch, ...descParts] = rest
-  const task = descParts.join(' ').trim()
-  if (!branch) {
-    ctx.logError('worktree add: потрібне імʼя гілки')
-    ctx.logError(USAGE)
-    return 1
-  }
-  if (!task) {
-    ctx.logError('worktree add: опис обовʼязковий — `worktree add <branch> "<опис>"`')
-    return 1
-  }
-  // Зайнята, якщо вже є git-гілка з такою назвою або checkout-каталог `.worktrees/<sanit>`.
-  const isTaken = name => {
-    if (git(['show-ref', '--verify', '--quiet', `refs/heads/${name}`], ctx.cwd).status === 0) return true
-    try {
-      return existsSync(worktreePaths(ctx.cwd, name).checkout)
-    } catch {
-      return false // невалідна для шляху назва — впаде нижче на worktreePaths(chosen) з людинозрозумілим текстом
-    }
-  }
-  let chosen
-  let paths
-  try {
-    chosen = firstFreeBranch(branch, isTaken)
-    paths = worktreePaths(ctx.cwd, chosen)
-  } catch (error) {
-    ctx.logError(error.message)
-    return 1
-  }
-  if (chosen !== branch) {
-    ctx.log(`ℹ️  гілка/worktree "${branch}" уже існує — обрано вільну назву "${chosen}"`)
-  }
-  // Знімаємо статус ДО створення worktree: інакше щойно створений checkout/опис у `.worktrees/`
-  // потрапили б у `git status` (коли `.worktrees/` не в .gitignore) і дали б хибне нагадування.
-  const dirty = buildDirtyNotice(git(['status', '--porcelain'], ctx.cwd).stdout)
-  const added = git(['worktree', 'add', paths.checkout, '-b', chosen], ctx.cwd)
-  if (added.status !== 0) {
-    ctx.logError(`worktree add не вдався: ${added.stderr.trim()}`)
-    return 1
-  }
-  const baseCommit = git(['rev-parse', '--short', 'HEAD'], ctx.cwd).stdout.trim()
-  const md = buildDescription({ branch: chosen, task, baseCommit, date: today(ctx.now) })
-  writeFileSync(paths.descFile, md, 'utf8')
-  ctx.log(`✅ worktree: ${paths.checkout}`)
-  ctx.log(`   опис:    ${paths.descFile}`)
-  if (dirty) ctx.log(dirty) // нагадування про незакомічені зміни основного дерева (зняте ДО add)
-  return 0
-}
-
-/**
- * remove: прибрати checkout + .md (гілку лишає).
- * @param {string[]} rest [branch, ...flags]
- * @param {{ cwd: string, log: (line: string) => void, logError: (line: string) => void }} ctx контекст
- * @returns {number} exit code
- */
-function cmdRemove(rest, ctx) {
-  const branch = rest.find(a => !a.startsWith('--'))
-  const force = rest.includes('--force')
-  if (!branch) {
-    ctx.logError('worktree remove: потрібне імʼя гілки')
-    return 1
-  }
-  let paths
-  try {
-    paths = worktreePaths(ctx.cwd, branch)
-  } catch (error) {
-    ctx.logError(error.message)
-    return 1
-  }
-  const args = ['worktree', 'remove', paths.checkout]
-  if (force) args.push('--force')
-  const removed = git(args, ctx.cwd)
-  if (removed.status !== 0) {
-    ctx.logError(`worktree remove не вдався: ${removed.stderr.trim()} (спробуй --force, якщо дерево брудне)`)
-    return 1
-  }
-  if (existsSync(paths.descFile)) rmSync(paths.descFile, { force: true })
-  // Окремих sibling runtime-файлів більше немає, тож cleanup обмежений checkout і описом.
-  ctx.log(`✅ прибрано: ${paths.checkout} (гілку ${branch} лишено)`)
-  return 0
-}
-
-/**
- * list: git worktree list + вміст .md-описів.
- * @param {{ cwd: string, log: (line: string) => void }} ctx контекст
- * @returns {number} exit code
- */
-function cmdList(ctx) {
-  ctx.log(git(['worktree', 'list'], ctx.cwd).stdout.trimEnd())
-  for (const md of listDescFiles(ctx.cwd)) {
-    ctx.log(`\n--- ${md} ---`)
-    ctx.log(readFileSync(md, 'utf8').trimEnd())
-  }
-  return 0
-}
-
-/**
- * prune: git worktree prune + видалити осиротілі .md.
- * @param {{ cwd: string, log: (line: string) => void }} ctx контекст
- * @returns {number} exit code
- */
-function cmdPrune(ctx) {
-  git(['worktree', 'prune'], ctx.cwd)
-  const orphans = findOrphanDescFiles(listDescFiles(ctx.cwd), listRegisteredCheckouts(ctx.cwd))
-  for (const md of orphans) {
-    rmSync(md, { force: true })
-    ctx.log(`🧹 видалено осиротілий опис: ${md}`)
-  }
-  ctx.log(`prune завершено (осиротілих описів: ${orphans.length})`)
-  return 0
-}
-
-/**
- * Точка входу підкоманди worktree.
- * @param {string[]} argv аргументи після `worktree`
- * @param {{ cwd?: string, log?: (line: string) => void, logError?: (line: string) => void, now?: () => Date }} [options] ін'єкція для тестів
- * @returns {Promise<number>} exit code
- */
-export function runWorktreeCli(argv, options = {}) {
-  const ctx = {
-    cwd: options.cwd ?? processCwd(),
-    log: options.log ?? (line => console.log(line)),
-    logError: options.logError ?? (line => console.error(line)),
-    now: options.now ?? (() => new Date())
-  }
-  const [sub, ...rest] = argv
-  switch (sub) {
-    case 'add': {
-      return Promise.resolve(cmdAdd(rest, ctx))
-    }
-    case 'remove': {
-      return Promise.resolve(cmdRemove(rest, ctx))
-    }
-    case 'list': {
-      return Promise.resolve(cmdList(ctx))
-    }
-    case 'prune': {
-      return Promise.resolve(cmdPrune(ctx))
-    }
-    default: {
-      ctx.logError(USAGE)
-      return Promise.resolve(1)
-    }
-  }
-}

package/skills/worktree/SKILL.md

@@ -1,38 +0,0 @@
----
-name: worktree
-description: >-
-  Створення та керування git-worktree через n-cursor worktree CLI: ізольований
-  workspace у .worktrees/<branch>/ з інвентарним файлом-описом
----
-
-# worktree — ізольований workspace через CLI
-
-Для роботи в окремому git-worktree використовуй CLI `n-cursor worktree` — він
-однаковий у Claude і Cursor, кладе worktree у `.worktrees/` (gitignored) і сам
-створює інвентарний файл-опис поруч.
-
-## Команди
-
-- Створити (опис **обовʼязковий**):
-  `npx @nitra/cursor worktree add <branch> "<навіщо цей worktree>"`
-- Список активних з описами:
-  `npx @nitra/cursor worktree list`
-- Прибрати (гілку лишає; `--force` для брудного дерева):
-  `npx @nitra/cursor worktree remove <branch> [--force]`
-- Прибрати осиротілі описи / метадані:
-  `npx @nitra/cursor worktree prune`
-
-## Приклад
-
-```bash
-npx @nitra/cursor worktree add feat/skill-meta "реалізація Spec A: meta.json"
-cd .worktrees/feat-skill-meta
-# … робота в ізоляції …
-cd -
-npx @nitra/cursor worktree remove feat/skill-meta
-```
-
-Слеш у гілці перетворюється на дефіс для пласкої структури: `feat/skill-meta`
-→ `.worktrees/feat-skill-meta/`. Git-гілка лишається `feat/skill-meta`.
-
-Конвенція й заборони (де НЕ створювати worktree) — `.cursor/rules/n-worktree.mdc`.

package/skills/worktree/meta.json

@@ -1 +0,0 @@
-{ "auto": "завжди", "worktree": false, "requireRoot": false }