@nitra/cursor 1.8.120 → 1.8.122

package/bin/n-cursor.js

@@ -384,6 +384,20 @@ function skillDescriptionSafeForMarkdownInline(desc) {
   return desc.replaceAll('<id>', '{id}')
 }
 
+/**
+ * YAML frontmatter для `.claude/commands/*.md`: поле `description` потрібне розширенню VSCode,
+ * щоб команди з’являлись у списку. Текст збігається з полем `description` у frontmatter `SKILL.md`.
+ * @param {string} descriptionRaw значення з `extractSkillDescription` (може бути порожнім)
+ * @returns {string} блок `---` … `---` і порожній рядок після
+ */
+function formatClaudeCommandFrontmatter(descriptionRaw) {
+  let text = skillDescriptionSafeForMarkdownInline(String(descriptionRaw || '').trim())
+  if (!text) {
+    text = 'Див. SKILL.md у каталозі скілу в .cursor/skills.'
+  }
+  return `---\ndescription: >-\n  ${text}\n---\n\n`
+}
+
 /**
  * Розгортає в шаблоні блок Mustache {{#section}} … {{/section}} для масиву елементів
  * @param {string} template вихідний текст шаблону
@@ -683,7 +697,8 @@ async function syncSkills(configSkills, bundledSkillsDir = BUNDLED_SKILLS_DIR) {
 
 /**
  * Синхронізує .claude/commands/n-<id>.md зі skills пакету.
- * Кожен файл містить посилання на відповідний cursor skill, а не копію інструкцій.
+ * У кожному файлі обов’язково YAML frontmatter з `description` (як у `SKILL.md`), інакше команди
+ * не з’являються у розширенні VSCode; далі — заголовок H1 лише з імені команди (без повтору опису) і посилання на `.cursor/skills/…/SKILL.md`.
  * @param {string[]} configSkills id без префікса n-
  * @param {string} [bundledSkillsDir] каталог `skills/` у корені пакету-джерела
  * @returns {Promise<{ success: number, fail: number }>} лічильники успішних і невдалих записів
@@ -710,9 +725,9 @@ async function syncCommands(configSkills, bundledSkillsDir = BUNDLED_SKILLS_DIR)
       try {
         const raw = await readFile(srcSkillMd, 'utf8')
         const descRaw = extractSkillDescription(raw)
-        const desc = descRaw ? skillDescriptionSafeForMarkdownInline(descRaw) : ''
-        const header = desc ? `# ${RULE_PREFIX}${id} — ${desc}\n\n` : ''
-        const body = `${header}Виконай інструкції зі скілу \`.cursor/skills/${destDirName}/SKILL.md\`.\n`
+        const frontmatter = formatClaudeCommandFrontmatter(descRaw || '')
+        const header = `# ${RULE_PREFIX}${id}\n\n`
+        const body = `${frontmatter}${header}Виконай інструкції зі скілу \`.cursor/skills/${destDirName}/SKILL.md\`.\n`
         await writeFile(destFile, body, 'utf8')
         console.log(`✅`)
         success++
@@ -754,7 +769,7 @@ async function removeOrphanManagedCommandFiles(commandsDir, configSkills) {
 
 /**
  * Синхронізує .claude/commands/{dirName}.md для всіх локальних скілів з .cursor/skills/
- * що не керуються пакетом (відсутні в configSkills).
+ * що не керуються пакетом (відсутні в configSkills). Frontmatter `description` — як у відповідному SKILL.md.
  * @param {string[]} configSkills id керованих skills (вже оброблені syncCommands)
  * @returns {Promise<{ success: number, fail: number }>} лічильники успішних і невдалих записів
  */
@@ -778,14 +793,15 @@ async function syncLocalOnlySkillCommands(configSkills) {
 
     process.stdout.write(`  ⬇  ${dirName} → ${COMMANDS_DIR}/${dirName}.md ... `)
     try {
-      let desc = ''
+      let descRaw = ''
       if (existsSync(skillMdPath)) {
         const raw = await readFile(skillMdPath, 'utf8')
         const parsed = extractSkillDescription(raw)
-        if (parsed) desc = skillDescriptionSafeForMarkdownInline(parsed)
+        if (parsed) descRaw = parsed
       }
-      const header = desc ? `# ${dirName} — ${desc}\n\n` : ''
-      const body = `${header}Виконай інструкції зі скілу \`${SKILLS_DIR}/${dirName}/SKILL.md\`.\n`
+      const frontmatter = formatClaudeCommandFrontmatter(descRaw)
+      const header = `# ${dirName}\n\n`
+      const body = `${frontmatter}${header}Виконай інструкції зі скілу \`${SKILLS_DIR}/${dirName}/SKILL.md\`.\n`
       await writeFile(destFile, body, 'utf8')
       console.log(`✅`)
       success++

package/package.json

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

package/skills/abie-kustomize/SKILL.md

@@ -2,12 +2,15 @@
 name: n-abie-kustomize
 description: >-
   Трансформація дерев k8s у Kustomize (base + overlays): dev → base, без окремої dev/; директорія
-  users/ у середовищах не входить у kustomization (окремі маніфести між середовищами)
-version: '1.1'
+  users/ у середовищах не входить у kustomization (окремі маніфести між середовищами); дерево з
+  CNPG Cluster (postgresql.cnpg.io/v1) не трансформувати
+version: '1.2'
 ---
 
 Спочатку знайди всі директорії `k8s/` у проєкті. Виконуй трансформацію лише для тих, у яких **немає** директорії `base/`. Якщо `base/` вже існує — пропускай цю директорію і рухайся далі.
 
+Якщо в дереві тієї директорії `k8s/`, яку збираєшся трансформувати (рекурсивно по `*.yaml`), є маніфест з **`apiVersion: postgresql.cnpg.io/v1`** і **`kind: Cluster`** (CloudNativePG) — **не застосовуй** до цього дерева описану трансформацію base/overlays: залиш структуру як є і переходь до наступної директорії `k8s/`.
+
 Трансформуй директорії, щоб виділити спільне за допомогою kustomize. За основу беремо все, що в середовищі dev, і саме в такому вигляді з dev воно має стати **base**; якщо вже є base і немає dev — це нормально, рухайся далі.
 
 У інших середовищах має бути лише `kustomization.yaml` і зміни через оверрайди.
@@ -26,6 +29,10 @@ README має бути в директорії **k8s**.
 
 Для overlays **ru** та **ua** `namespace` задавай у `kustomization.yaml` (без окремих patch лише на зміну namespace). Деталі — **n-k8s** / **abie** у `.cursor/rules/`, якщо ці правила увімкнені в проєкті.
 
+## Виключення: CNPG `Cluster`
+
+Ресурс **`Cluster`** оператора CloudNativePG (`postgresql.cnpg.io/v1`) має власні правила життєвого циклу та іменування; шаблон «dev → base + overlays» для нього не застосовується.
+
 ## Виключення: директорії `users/`
 
 Директорія `users/` у кожному середовищі — **окремий шар маніфестів**, який **не входить у Kustomize**. Так зроблено навмисно: вміст часто **різний між середовищами**, тож немає сенсу виносити його в `base` чи патчити через overlays.