@nitra/cursor 11.4.1 → 12.0.0

package/scripts/utils/docs/pass.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: pass.mjs
+resource: npm/scripts/utils/pass.mjs
 docgen:
-  source: npm/scripts/utils/pass.mjs
   crc: 0f69dfba
 ---
 
-# pass.mjs
-
-## Огляд
-
 Цей файл містить функцію для виведення повідомлень про успіх у консоль. Функція використовується в скриптах перевірки для інформування користувача про успішне завершення операцій. Вона забезпечує чіткий візуальний сигнал про успіх, що полегшує інтерпретацію результатів перевірки.
 
 ## Поведінка

package/scripts/utils/docs/resolve-cargo-manifest.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: resolve-cargo-manifest.mjs
+resource: npm/scripts/utils/resolve-cargo-manifest.mjs
 docgen:
-  source: npm/scripts/utils/resolve-cargo-manifest.mjs
   crc: af1efa42
 ---
 
-# resolve-cargo-manifest.mjs
-
-## Огляд
-
 Цей файл визначає шлях до файлу Cargo.toml проєкту, незалежно від того, чи це кореневий Cargo.toml або один з підкаталогів workspace-у, особливо з урахуванням Tauri-патерну. Він служить утилітою для coverage-провайдера та test-концерну cargo_mutants_config, повертаючи `null` у разі невдачі для обробки ситуації без виключень. Це забезпечує гнучкий спосіб доступу до конфігурації проєкту Cargo.
 
 ## Поведінка

package/scripts/utils/docs/resolve-cmd.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: resolve-cmd.mjs
+resource: npm/scripts/utils/resolve-cmd.mjs
 docgen:
-  source: npm/scripts/utils/resolve-cmd.mjs
   crc: 31c290fc
 ---
 
-# resolve-cmd.mjs
-
-## Огляд
-
 Цей файл надає функцію `resolveCmd` для отримання абсолютного шляху до виконуваного файлу, який відповідає заданій команді. Це дозволяє викликати зовнішні інструменти, використовуючи повний шлях до файлу, а не команду з змінної PATH. Це корисно для забезпечення чіткої та однозначної ідентифікації виконуваного файлу.
 
 ## Поведінка

package/scripts/utils/docs/resolve-js-root.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: resolve-js-root.mjs
+resource: npm/scripts/utils/resolve-js-root.mjs
 docgen:
-  source: npm/scripts/utils/resolve-js-root.mjs
   crc: 2c2b9f11
 ---
 
-# resolve-js-root.mjs
-
-## Огляд
-
 Цей файл визначає кореневий JavaScript-файл проєкту, необхідний для запуску інструментів аналізу коду. Він використовується як у великих проєктах з декількома workspace-ами, так і в окремих пакетах, забезпечуючи єдине місце для визначення кореневого розташування. Це спрощує інтеграцію з інструментами coverage та тестування.
 
 ## Поведінка

package/scripts/utils/docs/test-helpers.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: test-helpers.mjs
+resource: npm/scripts/utils/test-helpers.mjs
 docgen:
-  source: npm/scripts/utils/test-helpers.mjs
   crc: 0e4357fe
 ---
 
-# test-helpers.mjs
-
-## Огляд
-
 Цей файл надає допоміжні функції для тестування скриптів пакета `@nitra/cursor`. Він забезпечує створення тимчасових каталогів та запис JSON-файлів у абсолютний шлях, гарантуючи ізольованість тестів та запобігаючи мутації глобального контексту процесу. Ці функції використовуються для створення безпечного середовища для тестування, особливо при використанні git-операцій та інших файлових операцій.
 
 ## Поведінка

package/scripts/utils/docs/walk-cache.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: walk-cache.mjs
+resource: npm/scripts/utils/walk-cache.mjs
 docgen:
-  source: npm/scripts/utils/walk-cache.mjs
   crc: 82798fa2
 ---
 
-# walk-cache.mjs
-
-## Огляд
-
 Файл забезпечує спільний кеш результатів обходу файлової системи для всіх операцій перевірки. Він зберігає список файлів, що відповідають заданим шаблонам, щоб уникнути повторних обходів. Це підвищує ефективність процесу перевірки, особливо при великій кількості файлів та шаблонів.
 
 ## Поведінка

package/scripts/utils/docs/walkDir.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: walkDir.mjs
+resource: npm/scripts/utils/walkDir.mjs
 docgen:
-  source: npm/scripts/utils/walkDir.mjs
   crc: 5e5fec27
 ---
 
-# walkDir.mjs
-
-## Огляд
-
 Файл `n-cursor.js` забезпечує рекурсивний обхід каталогів для скриптів перевірки, дозволяючи виконувати callback-функцію для кожного звичайного файлу. Він обходить дерево каталогів від заданого кореня, ігноруючи певні директорії (наприклад, `.git`, `node_modules`) та шляхи, вказані в `ignorePaths`. Це дозволяє автоматизувати процес аналізу конфігураційних файлів та інших ресурсів у проєкті.
 
 ## Поведінка

package/scripts/utils/docs/with-lock.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: with-lock.mjs
+resource: npm/scripts/utils/with-lock.mjs
 docgen:
-  source: npm/scripts/utils/with-lock.mjs
   crc: 21848085
   score: 95
 ---
 
-# with-lock.mjs
-
-## Огляд
-
 Файл реалізує механізм захисту важких команд через атомарне блокування та унікалізацію результатів. Функції дозволяють перевіряти можливість повторного використання результату з кешу та виконувати команду через серіалізований механізм. Механізм використовує `mkdirSync-based lock` та `sha256-dedup` з TTL.
 
 ## Поведінка

package/scripts/utils/docs/worktree-fingerprint.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: worktree-fingerprint.mjs
+resource: npm/scripts/utils/worktree-fingerprint.mjs
 docgen:
-  source: npm/scripts/utils/worktree-fingerprint.mjs
   crc: df297382
 ---
 
-# worktree-fingerprint.mjs
-
-## Огляд
-
 Файл надає унікальний відбиток робочої директорії. Цей відбиток використовується для ідентифікації та порівняння робочих директорій, забезпечуючи їх унікальність у системі. Він слугує базовим інструментом для відстеження та управління версіями.
 
 ## Поведінка

package/skills/doc-aggregate/js/docs/docgen-ignore.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: docgen-ignore.mjs
+resource: npm/skills/doc-aggregate/js/docgen-ignore.mjs
 docgen:
-  source: npm/skills/doc-aggregate/js/docgen-ignore.mjs
   crc: 5faaffd0
 ---
 
-# docgen-ignore
-
-## Огляд
-
 Re-export спільного списку ignore-глобів зі скіла doc-files: обидва скіли документації (пофайлові доки й агрегати) мусять бачити однакове дерево кодових файлів, інакше агрегат посилатиметься на файли без док або навпаки.
 
 ## Поведінка

package/skills/doc-aggregate/js/docs/docgen-scan.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: docgen-scan.mjs
+resource: npm/skills/doc-aggregate/js/docgen-scan.mjs
 docgen:
-  source: npm/skills/doc-aggregate/js/docgen-scan.mjs
   crc: 193dd362
   score: 100
 ---
 
-# docgen-scan.mjs
-
-## Огляд
-
 isSourceFile
 Перевіряє, чи є файл коду, який слугує джерелом для документування.
 

package/skills/doc-aggregate/js/docs/index.md

@@ -0,0 +1,12 @@
+---
+type: Directory Index
+title: npm/skills/doc-aggregate/js
+resource: npm/skills/doc-aggregate/js/
+---
+
+# npm/skills/doc-aggregate/js
+
+| Файл | Тип |
+|---|---|
+| [docgen-ignore.mjs](docgen-ignore.md) | JS Module |
+| [docgen-scan.mjs](docgen-scan.md) | JS Module |

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

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: check.mjs
+resource: npm/skills/start-check/js/check.mjs
 docgen:
-  source: npm/skills/start-check/js/check.mjs
   crc: 1f8fb2f0
   score: 95
 ---
 
-# check.mjs
-
-## Огляд
-
 Файл надає інструменти для класифікації типів процесу, сканування конфігурації воркспейсів, парсингу логів та запуску скриптів.
 
 ## Поведінка

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

@@ -0,0 +1,11 @@
+---
+type: Directory Index
+title: npm/skills/start-check/js
+resource: npm/skills/start-check/js/
+---
+
+# npm/skills/start-check/js
+
+| Файл | Тип |
+|---|---|
+| [check.mjs](check.md) | JS Module |

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

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: diff.mjs
+resource: npm/skills/taze/js/diff.mjs
 docgen:
-  source: npm/skills/taze/js/diff.mjs
   crc: fe4d76ce
   score: 100
 ---
 
-# diff.mjs
-
-## Огляд
-
 parseVersion
 Парсить версію з specifier.
 

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

@@ -0,0 +1,11 @@
+---
+type: Directory Index
+title: npm/skills/taze/js
+resource: npm/skills/taze/js/
+---
+
+# npm/skills/taze/js
+
+| Файл | Тип |
+|---|---|
+| [diff.mjs](diff.md) | JS Module |

package/scripts/lib/worktree.mjs

@@ -1,126 +0,0 @@
-/**
- * Чиста логіка worktree-tool `n-cursor worktree` (без git/fs side-effects).
- *
- * Тут — детерміновані, тестовані без git функції:
- *  - `sanitizeBranch` — імʼя гілки → безпечне імʼя каталогу/файла (слеш та інші
- *    небезпечні для шляху символи → дефіс), щоб структура `.worktrees/` лишалась пласкою;
- *  - `worktreePaths` — шляхи checkout і файла-опису поруч;
- *  - `buildDescription` — текст інвентарного `.worktrees/<name>.md` за конвенцією worktree.mdc;
- *  - `findOrphanDescFiles` — `.md`-описи без зареєстрованого worktree (для `prune`).
- *
- * Оркестрація (виклики git, запис файлів, argv) — у `npm/scripts/worktree-cli.mjs`.
- */
-import { basename, join } from 'node:path'
-
-/** Символи, безпечні для імені каталогу/файла; решта → дефіс. */
-const UNSAFE_PATH_CHARS_RE = /[^a-zA-Z0-9._-]+/gu
-const MD_EXTENSION_RE = /\.md$/u
-
-/**
- * Перетворює імʼя git-гілки на безпечне імʼя каталогу/файла для `.worktrees/`.
- * @param {string} branch імʼя git-гілки (наприклад `feat/skill-meta`)
- * @returns {string} пласке імʼя (наприклад `feat-skill-meta`)
- */
-export function sanitizeBranch(branch) {
-  if (typeof branch !== 'string' || branch.trim() === '') {
-    throw new Error('worktree: імʼя гілки обовʼязкове')
-  }
-  const sanitized = branch
-    .trim()
-    .replace(UNSAFE_PATH_CHARS_RE, '-')
-    .replaceAll(/^-{1,80}|-{1,80}$/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 абсолютний корінь репозиторію
- * @param {string} branch імʼя git-гілки
- * @returns {{ checkout: string, descFile: string }} абсолютні шляхи
- */
-export function worktreePaths(repoRoot, branch) {
-  const name = sanitizeBranch(branch)
-  const dir = join(repoRoot, '.worktrees')
-  return { checkout: join(dir, name), descFile: join(dir, `${name}.md`) }
-}
-
-/**
- * Текст інвентарного файла-опису worktree.
- * @param {{ branch: string, task: string, baseCommit: string, date: string }} params поля опису
- * @returns {string} markdown-вміст `.worktrees/<name>.md`
- */
-export function buildDescription({ branch, task, baseCommit, date }) {
-  return [
-    `# ${branch}`,
-    '',
-    `**Задача:** ${task}`,
-    `**Дата:** ${date}`,
-    `**База (коміт):** ${baseCommit}`,
-    '',
-    `Прибрати: \`npx @nitra/cursor worktree remove ${branch}\``,
-    ''
-  ].join('\n')
-}
-
-/** Поріг переліку файлів у нагадуванні: понад нього показуємо лише кількість. */
-const DIRTY_LIST_LIMIT = 10
-
-/**
- * Нагадування про незакомічені зміни основного дерева, які **не** потрапляють
- * у новий worktree (він створюється від HEAD, без брудного стану). До
- * `limit` файлів — перелік шляхів; більше — лише підсумкова кількість, щоб не
- * залити екран. Призначене для виводу одразу після `worktree add`.
- * @param {string} porcelain вивід `git status --porcelain` основного дерева
- * @param {number} [limit] поріг переліку (понад нього — лише кількість)
- * @returns {string | null} текст нагадування або `null`, якщо дерево чисте
- */
-export function buildDirtyNotice(porcelain, limit = DIRTY_LIST_LIMIT) {
-  // Порядок: XY + пробіл (3 символи) + шлях; для перейменування — `orig -> dest`.
-  const files = String(porcelain ?? '')
-    .split('\n')
-    .map(line => line.slice(3).trim())
-    .filter(Boolean)
-  if (files.length === 0) return null
-  const head = `⚠️  Основне дерево має ${files.length} незакомічених змін — вони НЕ потрапили в цей worktree (створено від HEAD).`
-  const tail = '   Закоміть потрібні файли, якщо worktree-скіл має їх бачити.'
-  if (files.length > limit) return `${head}\n${tail}`
-  const list = files.map(f => `   - ${f}`).join('\n')
-  return `${head}\n${list}\n${tail}`
-}
-
-/**
- * `.md`-описи без відповідного зареєстрованого worktree-checkout.
- * @param {string[]} descFiles абсолютні шляхи `.worktrees/*.md`
- * @param {string[]} registeredCheckouts абсолютні шляхи зареєстрованих worktree-checkout
- * @returns {string[]} осиротілі `.md` (підмножина `descFiles`)
- */
-export function findOrphanDescFiles(descFiles, registeredCheckouts) {
-  const checkoutBasenames = new Set(registeredCheckouts.map(c => basename(c)))
-  return descFiles.filter(md => !checkoutBasenames.has(basename(md).replace(MD_EXTENSION_RE, '')))
-}

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