@nitra/cursor 3.4.0 → 3.4.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [3.4.1] - 2026-06-01
+
+### Fixed
+
+- worktree add: перевіряє зайнятість назви й автоматично обирає вільну (base, base2, base3, …) замість падіння на 'a branch named … already exists'
+
 ## [3.4.0] - 2026-06-01
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "3.4.0",
+  "version": "3.4.1",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",

package/scripts/lib/worktree.mjs

@@ -24,13 +24,39 @@ export function sanitizeBranch(branch) {
   if (typeof branch !== 'string' || branch.trim() === '') {
     throw new Error('worktree: імʼя гілки обовʼязкове')
   }
-  const sanitized = branch.trim().replace(UNSAFE_PATH_CHARS_RE, '-').replace(/^-+|-+$/gu, '')
+  const sanitized = branch
+    .trim()
+    .replace(UNSAFE_PATH_CHARS_RE, '-')
+    .replace(/^-+|-+$/gu, '')
   if (sanitized === '') {
     throw new Error(`worktree: імʼя гілки "${branch}" не містить допустимих символів`)
   }
   return sanitized
 }
 
+/**
+ * Перша вільна назва гілки за конвенцією `base`, `base2`, `base3`, … —
+ * суфікс просто число без розділювача (як `main-fix` → `main-fix2`).
+ * Дає змогу `worktree add` спершу перевірити зайнятість і обрати назву,
+ * що спрацює, замість падіння на `fatal: a branch named '…' already exists`.
+ * @param {string} branch бажане імʼя гілки
+ * @param {(candidate: string) => boolean} isTaken чи зайнята назва (гілка/worktree вже існують)
+ * @param {number} [limit] стеля кількості спроб (захист від нескінченного циклу)
+ * @returns {string} перша вільна назва (= `branch`, якщо вона вільна)
+ */
+export function firstFreeBranch(branch, isTaken, limit = 1000) {
+  if (typeof branch !== 'string' || branch.trim() === '') {
+    throw new Error('worktree: імʼя гілки обовʼязкове')
+  }
+  const base = branch.trim()
+  if (!isTaken(base)) return base
+  for (let n = 2; n <= limit; n++) {
+    const candidate = `${base}${n}`
+    if (!isTaken(candidate)) return candidate
+  }
+  throw new Error(`worktree: не знайдено вільної назви для "${base}" за ${limit} спроб`)
+}
+
 /**
  * Детерміновані шляхи checkout і файла-опису для гілки.
  * @param {string} repoRoot абсолютний корінь репозиторію

package/scripts/worktree-cli.mjs

@@ -16,7 +16,7 @@ import { join } from 'node:path'
 import { cwd as processCwd } from 'node:process'
 
 import { cleanupFlowSiblings } from './dispatcher/lib/state-store.mjs'
-import { buildDescription, findOrphanDescFiles, worktreePaths } from './lib/worktree.mjs'
+import { buildDescription, findOrphanDescFiles, firstFreeBranch, worktreePaths } from './lib/worktree.mjs'
 
 const USAGE = [
   'Usage:',
@@ -89,20 +89,34 @@ function cmdAdd(rest, ctx) {
     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 {
-    paths = worktreePaths(ctx.cwd, branch)
+    chosen = firstFreeBranch(branch, isTaken)
+    paths = worktreePaths(ctx.cwd, chosen)
   } catch (error) {
     ctx.logError(error.message)
     return 1
   }
-  const added = git(['worktree', 'add', paths.checkout, '-b', branch], ctx.cwd)
+  if (chosen !== branch) {
+    ctx.log(`ℹ️  гілка/worktree "${branch}" уже існує — обрано вільну назву "${chosen}"`)
+  }
+  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, task, baseCommit, date: today(ctx.now) })
+  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}`)