@nitra/cursor 1.18.3 → 1.19.0

package/CHANGELOG.md

@@ -4,6 +4,13 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
+## [1.19.0] - 2026-05-25
+
+### Added
+
+- **Pi.dev інтеграція** — CLI під час синку генерує `.pi/skills/<dir>/SKILL.md` для кожного скілу з `.cursor/skills/<dir>/` із frontmatter `name`+`description` (формат pi.dev: 1-64 chars, `[a-z0-9-]`). Тіло — делегат `Виконай інструкції зі скілу .cursor/skills/<dir>/SKILL.md.`, симетрично до `.claude/commands/<dir>.md`. Always-on, без флагу. Покриває керовані (з пакета) і локальні скіли; orphan-cleanup видаляє `.pi/skills/n-*` дири, яких немає у конфігу, і локальні дири, яких більше немає у `.cursor/skills/`.
+- `npm/bin/n-cursor.js`: константа `PI_SKILLS_DIR='.pi/skills'`, функція `formatPiSkillFrontmatter(name, desc)`, синки `syncPiSkills`/`syncLocalOnlyPiSkills` + cleanups `removeOrphanManagedPiSkillDirs`/`removeOrphanLocalPiSkillDirs`. Новий `runSyncStep('❌ Pi skills: ', …)` після Commands-блоку у головному потоці.
+
 ## [1.18.3] - 2026-05-25
 
 ### Changed

package/bin/n-cursor.js

@@ -28,6 +28,9 @@
  * синхронізує `.claude/settings.json` (hooks + permissions; merge — користувацькі поля зберігаються)
  * і `.cursor/hooks.json` (Cursor Agent hooks; merge — користувацькі hooks зберігаються).
  * Опт-аут — поле `claude-config: false` у `.n-cursor.json`.
+ * Pi.dev інтеграція: для кожного skill у `.cursor/skills/<dir>/` CLI генерує
+ * `.pi/skills/<dir>/SKILL.md` із frontmatter `name`+`description` (формат pi.dev). Тіло — делегат
+ * на джерельний `.cursor/skills/<dir>/SKILL.md`. Always-on, симетрично до `.claude/commands/`.
  *
  * Якщо у корені репозиторію немає .n-cursor.json, спочатку перейменовується за наявності nitra-cursor.json;
  * у `.cursor/rules` файли `nitra-*.mdc` перейменовуються на `n-*.mdc`; інакше конфіг створюється автоматично
@@ -104,6 +107,7 @@ const AGENTS_TEMPLATE_FILE = 'AGENTS.template.md'
 const RULES_DIR = '.cursor/rules'
 const SKILLS_DIR = '.cursor/skills'
 const COMMANDS_DIR = '.claude/commands'
+const PI_SKILLS_DIR = '.pi/skills'
 const RULE_PREFIX = 'n-'
 
 const binDir = dirname(fileURLToPath(import.meta.url))
@@ -486,6 +490,22 @@ function formatClaudeCommandFrontmatter(descriptionRaw) {
   return `---\ndescription: >-\n  ${text}\n---\n\n`
 }
 
+/**
+ * YAML frontmatter для `.pi/skills/<dir>/SKILL.md` згідно зі специфікацією pi.dev:
+ * обов'язкові поля `name` (1-64, `[a-z0-9-]`) і `description` (≤ 1024). Текст description збігається
+ * з полем `description` у frontmatter джерельного `SKILL.md`.
+ * @param {string} skillName ім'я скілу (наприклад `n-fix`); має бути валідним pi-name
+ * @param {string} descriptionRaw значення з `extractSkillDescription` (може бути порожнім)
+ * @returns {string} блок `---` … `---` і порожній рядок після
+ */
+function formatPiSkillFrontmatter(skillName, descriptionRaw) {
+  let text = skillDescriptionSafeForMarkdownInline(String(descriptionRaw || '').trim())
+  if (!text) {
+    text = 'Див. SKILL.md у каталозі скілу в .cursor/skills.'
+  }
+  return `---\nname: ${skillName}\ndescription: >-\n  ${text}\n---\n\n`
+}
+
 /**
  * Повертає відсортовані імена *.mdc у .cursor/rules поточного проєкту
  * @returns {Promise<string[]>} базові імена файлів (лише .mdc)
@@ -901,6 +921,149 @@ async function removeOrphanLocalSkillCommandFiles(commandsDir, configSkills) {
   return removed.toSorted((a, b) => a.localeCompare(b))
 }
 
+/**
+ * Синхронізує .pi/skills/n-<id>/SKILL.md зі skills пакету для pi.dev-сумісності.
+ * Pi-skill — це директорія з SKILL.md (frontmatter `name`+`description`), тіло-делегат на джерельний
+ * `.cursor/skills/<dir>/SKILL.md`. Симетрично до `syncCommands`, але дир замість `.md`-файлу.
+ * @param {string[]} configSkills id без префікса n-
+ * @param {string} [bundledSkillsDir] каталог `skills/` у корені пакету-джерела
+ * @returns {Promise<{ success: number, fail: number }>} лічильники успішних і невдалих записів
+ */
+async function syncPiSkills(configSkills, bundledSkillsDir = BUNDLED_SKILLS_DIR) {
+  if (configSkills.length === 0 || !existsSync(bundledSkillsDir)) {
+    return { success: 0, fail: 0 }
+  }
+
+  const piSkillsRoot = join(cwd(), PI_SKILLS_DIR)
+  await mkdir(piSkillsRoot, { recursive: true })
+
+  let success = 0
+  let fail = 0
+
+  for (const skillId of configSkills) {
+    const id = normalizeSkillId(skillId)
+    const srcSkillMd = join(bundledSkillsDir, id, 'SKILL.md')
+    const destDirName = managedSkillDirName(skillId)
+    const destDir = join(piSkillsRoot, destDirName)
+    const destFile = join(destDir, 'SKILL.md')
+
+    process.stdout.write(`  ⬇  ${id} → ${PI_SKILLS_DIR}/${destDirName}/SKILL.md ... `)
+    if (existsSync(srcSkillMd)) {
+      try {
+        const raw = await readFile(srcSkillMd, 'utf8')
+        const descRaw = extractSkillDescription(raw)
+        await mkdir(destDir, { recursive: true })
+        const frontmatter = formatPiSkillFrontmatter(destDirName, descRaw || '')
+        const header = `# ${destDirName}\n\n`
+        const body = `${frontmatter}${header}Виконай інструкції зі скілу \`.cursor/skills/${destDirName}/SKILL.md\`.\n`
+        await writeFile(destFile, body, 'utf8')
+        console.log(`✅`)
+        success++
+      } catch (error) {
+        console.log(`❌`)
+        console.error(`     Помилка: ${errorMessage(error)}`)
+        fail++
+      }
+    } else {
+      console.log(`❌`)
+      console.error(`     Немає SKILL.md у пакеті: skills/${id}`)
+      fail++
+    }
+  }
+  return { success, fail }
+}
+
+/**
+ * Синхронізує .pi/skills/{dirName}/SKILL.md для всіх локальних скілів з .cursor/skills/
+ * що не керуються пакетом. Симетрично до `syncLocalOnlySkillCommands`.
+ * @param {string[]} configSkills id керованих skills (уже оброблені syncPiSkills)
+ * @returns {Promise<{ success: number, fail: number }>} лічильники успішних і невдалих записів
+ */
+async function syncLocalOnlyPiSkills(configSkills) {
+  const skillsRoot = join(cwd(), SKILLS_DIR)
+  if (!existsSync(skillsRoot)) return { success: 0, fail: 0 }
+
+  const piSkillsRoot = join(cwd(), PI_SKILLS_DIR)
+  await mkdir(piSkillsRoot, { recursive: true })
+
+  const managedDirNames = new Set(configSkills.map(s => managedSkillDirName(s)))
+  const allDirNames = await listProjectSkillDirNames()
+  const localOnly = allDirNames.filter(d => !managedDirNames.has(d))
+
+  let success = 0
+  let fail = 0
+
+  for (const dirName of localOnly) {
+    const skillMdPath = join(skillsRoot, dirName, 'SKILL.md')
+    const destDir = join(piSkillsRoot, dirName)
+    const destFile = join(destDir, 'SKILL.md')
+
+    process.stdout.write(`  ⬇  ${dirName} → ${PI_SKILLS_DIR}/${dirName}/SKILL.md ... `)
+    try {
+      let descRaw = ''
+      if (existsSync(skillMdPath)) {
+        const raw = await readFile(skillMdPath, 'utf8')
+        const parsed = extractSkillDescription(raw)
+        if (parsed) descRaw = parsed
+      }
+      await mkdir(destDir, { recursive: true })
+      const frontmatter = formatPiSkillFrontmatter(dirName, descRaw)
+      const header = `# ${dirName}\n\n`
+      const body = `${frontmatter}${header}Виконай інструкції зі скілу \`${SKILLS_DIR}/${dirName}/SKILL.md\`.\n`
+      await writeFile(destFile, body, 'utf8')
+      console.log(`✅`)
+      success++
+    } catch (error) {
+      console.log(`❌`)
+      console.error(`     Помилка: ${errorMessage(error)}`)
+      fail++
+    }
+  }
+  return { success, fail }
+}
+
+/**
+ * Видаляє n-* директорії у .pi/skills, яких немає у конфігурації skills.
+ * @param {string} piSkillsDir абсолютний шлях до .pi/skills
+ * @param {string[]} configSkills id без префікса n-
+ * @returns {Promise<string[]>} імена видалених директорій
+ */
+async function removeOrphanManagedPiSkillDirs(piSkillsDir, configSkills) {
+  if (!existsSync(piSkillsDir)) return []
+  const expected = new Set(configSkills.map(s => managedSkillDirName(s)))
+  const entries = await readdir(piSkillsDir, { withFileTypes: true })
+  const removed = []
+  for (const entry of entries) {
+    if (entry.isDirectory() && entry.name.startsWith(RULE_PREFIX) && !expected.has(entry.name)) {
+      await rm(join(piSkillsDir, entry.name), { recursive: true, force: true })
+      removed.push(entry.name)
+    }
+  }
+  return removed.toSorted((a, b) => a.localeCompare(b))
+}
+
+/**
+ * Видаляє .pi/skills/{dirName} директорії локальних скілів, яких більше немає в .cursor/skills/.
+ * @param {string} piSkillsDir абсолютний шлях до .pi/skills
+ * @param {string[]} configSkills id керованих skills
+ * @returns {Promise<string[]>} імена видалених директорій
+ */
+async function removeOrphanLocalPiSkillDirs(piSkillsDir, configSkills) {
+  if (!existsSync(piSkillsDir)) return []
+  const managedDirNames = new Set(configSkills.map(s => managedSkillDirName(s)))
+  const allDirNames = new Set(await listProjectSkillDirNames())
+  const entries = await readdir(piSkillsDir, { withFileTypes: true })
+  const removed = []
+  for (const entry of entries) {
+    if (!entry.isDirectory() || entry.name.startsWith(RULE_PREFIX)) continue
+    if (!managedDirNames.has(entry.name) && !allDirNames.has(entry.name)) {
+      await rm(join(piSkillsDir, entry.name), { recursive: true, force: true })
+      removed.push(entry.name)
+    }
+  }
+  return removed.toSorted((a, b) => a.localeCompare(b))
+}
+
 /**
  * Людинозрозумілий текст винятку для логів.
  * @param {unknown} error виняток із catch
@@ -1184,6 +1347,24 @@ async function runSync() {
     }
   })
 
+  await runSyncStep('❌ Pi skills: ', async () => {
+    const { success: piOk, fail: piFail } = await syncPiSkills(skills, bundledSkillsDir)
+    const { success: piLocalOk, fail: piLocalFail } = await syncLocalOnlyPiSkills(skills)
+    const totalOk = piOk + piLocalOk
+    const totalFail = piFail + piLocalFail
+    if (totalOk + totalFail > 0) {
+      console.log(`\n🥧 Pi skills: ${totalOk} скопійовано, ${totalFail} з помилками`)
+    }
+    const piSkillsDir = join(cwd(), PI_SKILLS_DIR)
+    const removedPi = await removeOrphanManagedPiSkillDirs(piSkillsDir, skills)
+    logRemovedManagedItems('pi skills', PI_SKILLS_DIR, removedPi)
+    const removedLocalPi = await removeOrphanLocalPiSkillDirs(piSkillsDir, skills)
+    logRemovedManagedItems('pi skills (local)', PI_SKILLS_DIR, removedLocalPi)
+    if (totalFail > 0) {
+      throw new Error(`Не вдалося скопіювати ${totalFail} pi skills`)
+    }
+  })
+
   await runSyncStep(`❌ Не вдалося оновити ${AGENTS_FILE}: `, () => syncAgentsMd(bundledAgentsTemplatePath))
   await runSyncStep('❌ Не вдалося оновити CLAUDE.md: ', () =>
     syncClaudeMd(/** @type {string[] | undefined} */ (ignore))

package/package.json

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