@nitra/cursor 1.8.38 → 1.8.41

package/README.md

@@ -85,10 +85,11 @@ CLI автоматично (команда завантаження правил
 ```
 npm/
 ├── AGENTS.template.md   # шаблон AGENTS.md для цільових репозиторіїв (потрапляє в npm-архів)
-├── mdc/                 # cursor-правила
+├── mdc/                 # cursor-правила (без префікса n-; після синку — .cursor/rules/n-<id>.mdc)
 │   ├── js-format.mdc
 │   ├── npm-module.mdc
 │   └── text.mdc
+├── skills/              # skills (каталоги <id>/; після синку — .cursor/skills/n-<id>/)
 └── bin/
     └── n-cursor.js  # CLI-скрипт
 ```

package/bin/n-cursor.js

@@ -24,8 +24,9 @@
  * `github-actions/` пакету при кожному успішному синку (workflows з правил ga / js-lint / text).
  *
  * Skills копіюються з npm/skills пакету лише для id з масиву «skills» у .n-cursor.json
- * (у JSON — без префікса, каталоги в проєкті — n-<id>, як і для правил). Якщо ключа skills
- * немає, за замовчуванням підтягуються всі bundled skills з префіксом n- у пакеті.
+ * (у JSON — без префікса, як імена файлів у mdc/ без n-). У пакеті джерело — каталоги
+ * skills/<id>/ (без префікса); у проєкті — .cursor/skills/n-<id>/ (префікс n-, як n-*.mdc).
+ * Якщо ключа skills немає, за замовчуванням підтягуються всі підкаталоги skills/ (лише імена без префікса n-).
  * Зайві каталоги n-* у .cursor/skills, яких немає у списку, видаляються.
  *
  * Якщо в корені є package.json і в ньому ще немає \@nitra/cursor у devDependencies (і не оголошено
@@ -87,7 +88,7 @@ async function discoverBundledRuleNames() {
 }
 
 /**
- * Імена skills (без префікса n-) з каталогу skills пакету — лише директорії n-*
+ * Імена skills (id без префікса n-) з каталогу skills пакету — лише підкаталоги `<id>/` без префікса n-
  * @returns {Promise<string[]>} відсортовані id
  */
 async function discoverBundledSkillNames() {
@@ -96,8 +97,8 @@ async function discoverBundledSkillNames() {
   }
   const entries = await readdir(BUNDLED_SKILLS_DIR, { withFileTypes: true })
   return entries
-    .filter(e => e.isDirectory() && e.name.startsWith(RULE_PREFIX))
-    .map(e => e.name.slice(RULE_PREFIX.length))
+    .filter(e => e.isDirectory() && !e.name.startsWith('.') && !e.name.startsWith(RULE_PREFIX))
+    .map(e => e.name)
     .toSorted((a, b) => a.localeCompare(b))
 }
 
@@ -233,28 +234,13 @@ function normalizeSkillId(skillName) {
   return s
 }
 
-/** Legacy id у `.n-cursor.json` → поточний bundled id (каталог `n-<id>` у пакеті) */
-const LEGACY_SKILL_ID_MAP = {
-  'fix-cursor': 'fix'
-}
-
-/**
- * Поточний id skill для шляхів у пакеті та `.cursor/skills`
- * @param {string} skillName елемент масиву skills або ім'я каталогу
- * @returns {string} canonical id без префікса n-
- */
-function canonicalSkillId(skillName) {
-  const id = normalizeSkillId(skillName)
-  return LEGACY_SKILL_ID_MAP[id] ?? id
-}
-
 /**
  * Ім'я керованого каталогу skill у .cursor/skills (префікс n-)
- * @param {string} skillId id без префікса
+ * @param {string} skillId id без префікса (або з префіксом n- у конфігу — нормалізується)
  * @returns {string} наприклад n-fix
  */
 function managedSkillDirName(skillId) {
-  return `${RULE_PREFIX}${canonicalSkillId(skillId)}`
+  return `${RULE_PREFIX}${normalizeSkillId(skillId)}`
 }
 
 /**
@@ -445,7 +431,7 @@ async function syncClaudeMd(configRules, configSkills) {
     lines.push('', '## Skills', '')
     const skillsRoot = join(cwd(), SKILLS_DIR)
     for (const skillId of configSkills) {
-      const id = canonicalSkillId(skillId)
+      const id = normalizeSkillId(skillId)
       const dirName = managedSkillDirName(skillId)
       const skillMdPath = join(skillsRoot, dirName, 'SKILL.md')
       let desc = ''
@@ -495,7 +481,7 @@ async function syncAgentsMd(configSkills) {
 }
 
 /**
- * Копіює лише skills зі списку configSkills (каталоги n-* у пакеті)
+ * Копіює лише skills зі списку configSkills (джерело: skills/<id>/ у пакеті)
  * @param {string[]} configSkills id без префікса n-
  * @returns {Promise<{ success: number, fail: number }>} лічильники успішних і невдалих копіювань
  */
@@ -511,13 +497,13 @@ async function syncSkills(configSkills) {
   let fail = 0
 
   for (const skillId of configSkills) {
-    const id = canonicalSkillId(skillId)
-    const dirName = managedSkillDirName(skillId)
-    const srcDir = join(BUNDLED_SKILLS_DIR, dirName)
-    const destDir = join(skillsRoot, dirName)
+    const id = normalizeSkillId(skillId)
+    const srcDir = join(BUNDLED_SKILLS_DIR, id)
+    const destDirName = managedSkillDirName(skillId)
+    const destDir = join(skillsRoot, destDirName)
 
     if (existsSync(srcDir)) {
-      process.stdout.write(`  ⬇  ${id} → ${SKILLS_DIR}/${dirName} ... `)
+      process.stdout.write(`  ⬇  ${id} → ${SKILLS_DIR}/${destDirName} ... `)
       try {
         await mkdir(destDir, { recursive: true })
         const files = await readdir(srcDir)
@@ -533,9 +519,9 @@ async function syncSkills(configSkills) {
         fail++
       }
     } else {
-      process.stdout.write(`  ⬇  ${id} → ${SKILLS_DIR}/${dirName} ... `)
+      process.stdout.write(`  ⬇  ${id} → ${SKILLS_DIR}/${destDirName} ... `)
       console.log(`❌`)
-      console.error(`     Немає каталогу в пакеті: ${dirName}`)
+      console.error(`     Немає каталогу в пакеті: skills/${id}`)
       fail++
     }
   }
@@ -560,9 +546,9 @@ async function syncCommands(configSkills) {
   let fail = 0
 
   for (const skillId of configSkills) {
-    const id = canonicalSkillId(skillId)
-    const dirName = managedSkillDirName(skillId)
-    const srcSkillMd = join(BUNDLED_SKILLS_DIR, dirName, 'SKILL.md')
+    const id = normalizeSkillId(skillId)
+    const srcSkillMd = join(BUNDLED_SKILLS_DIR, id, 'SKILL.md')
+    const destDirName = managedSkillDirName(skillId)
     const destFile = join(commandsDir, `${RULE_PREFIX}${id}.md`)
 
     process.stdout.write(`  ⬇  ${id} → ${COMMANDS_DIR}/${RULE_PREFIX}${id}.md ... `)
@@ -572,7 +558,7 @@ async function syncCommands(configSkills) {
         const descRaw = extractSkillDescription(raw)
         const desc = descRaw ? skillDescriptionSafeForMarkdownInline(descRaw) : ''
         const header = desc ? `# ${RULE_PREFIX}${id} — ${desc}\n\n` : ''
-        const body = `${header}Виконай інструкції зі скілу \`.cursor/skills/${dirName}/SKILL.md\`.\n`
+        const body = `${header}Виконай інструкції зі скілу \`.cursor/skills/${destDirName}/SKILL.md\`.\n`
         await writeFile(destFile, body, 'utf8')
         console.log(`✅`)
         success++
@@ -583,7 +569,7 @@ async function syncCommands(configSkills) {
       }
     } else {
       console.log(`❌`)
-      console.error(`     Немає SKILL.md у пакеті: ${dirName}`)
+      console.error(`     Немає SKILL.md у пакеті: skills/${id}`)
       fail++
     }
   }
@@ -600,7 +586,7 @@ async function removeOrphanManagedCommandFiles(commandsDir, configSkills) {
   if (!existsSync(commandsDir)) {
     return []
   }
-  const expected = new Set(configSkills.map(s => `${RULE_PREFIX}${canonicalSkillId(s)}.md`))
+  const expected = new Set(configSkills.map(s => `${RULE_PREFIX}${normalizeSkillId(s)}.md`))
   const names = await readdir(commandsDir)
   const removed = []
   for (const name of names) {

package/package.json

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

package/schemas/n-cursor.json

@@ -21,7 +21,7 @@
     },
     "skills": {
       "type": "array",
-      "description": "Ідентифікатори skills без префікса n- (каталог .cursor/skills). Якщо відсутній, CLI доповнить списком skills з пакету.",
+      "description": "Ідентифікатори skills без префікса n- (у пакеті — підкаталог skills/<id>/, у проєкті після синку — .cursor/skills/n-<id>/). Якщо відсутній, CLI доповнить списком skills з пакету.",
       "items": {
         "type": "string",
         "minLength": 1

package/skills/abie-kustomize/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: n-abie-kustomize
+description: >-
+  Трансформація дерев k8s у структуру Kustomize (base + overlays): dev → base, без окремої dev/
+version: '1.0'
+---
+
+Трансформуй директорії, щоб виділити спільне за допомогою kustomize. За основу беремо все, що в середовищі dev, і саме в такому вигляді з dev воно має стати **base**; якщо вже є base і немає dev — це нормально, рухайся далі.
+
+У інших середовищах має бути лише `kustomization.yaml` і зміни через оверрайди.
+
+У **base** у всіх ресурсів (окрім `base/kustomization.yaml`) має бути namespace **dev**.
+
+Окремої директорії **dev** не має бути — за середовище dev відповідає **base**.
+
+README має бути в директорії **k8s**.
+
+Рядки в маніфестах у **base**, які змінюватимуться в інших середовищах, позначай коментарем на тому самому рядку: `# буде замінено через kustomize`.
+
+Патчів лише на namespace не роби — namespace задається в `kustomization.yaml`.
+
+Застарілі файли прибирай.
+
+У всіх Deployment має бути `imagePullPolicy: Always`.
+
+Для overlays **ru** та **ua** `namespace` задавай у `kustomization.yaml` (без окремих patch лише на зміну namespace). Деталі — **n-k8s** / **abie** у `.cursor/rules/`, якщо ці правила увімкнені в проєкті.

package/skills/n-mdc-check/SKILL.md

@@ -1,86 +0,0 @@
----
-name: n-mdc-check
-description: >-
-  Проаналізувати правило в npm/mdc і перенести максимум перевірюваної логіки в check-{id}.mjs;
-  залишити в .mdc лише те, що не автоматизується або служить контекстом для агента
----
-
-# n-mdc-check — від правила до скрипта
-
-Навичка для роботи з правилами пакета `@nitra/cursor`: **перевірювані критерії** мають жити в **`npm/scripts/check-<id>.mjs`**, а **`npm/mdc/<id>.mdc`** (і дзеркало **`.cursor/rules/n-<id>.mdc`**) — бути **коротким орієнтиром**: навіщо правило, як виправляти порушення, яка команда підтверджує відповідність.
-
-Канонічні вимоги до скриптів, тестів і AST — **`.cursor/rules/scripts.mdc`**.
-
-## Коли застосовувати
-
-- Додали або змінили вимоги в **`npm/mdc/<id>.mdc`** (або локальному **`n-<id>.mdc`**).
-- У правилі багато «має містити», «заборонено», точних фрагментів файлів — і агенти повторюють перевірку вручну.
-- Потрібно зменшити обсяг `.mdc` і уникнути роз’їзду тексту й фактичної перевірки.
-
-## Ідентифікатор правила
-
-- Файл правила в пакеті: **`npm/mdc/<id>.mdc`** → скрипт: **`npm/scripts/check-<id>.mjs`**, команда CLI: **`npx @nitra/cursor check <id>`**.
-- CLI підхоплює всі **`check-*.mjs`** з каталогу `scripts` пакета; окремої реєстрації не потрібно.
-- Якщо правило згадане в **`AGENTS.md`**, для нього доречна programmatic перевірка — має існувати відповідний **`check-<id>.mjs`** (коли вимоги формалізовані).
-
-## Workflow
-
-### 1. Базова лінія
-
-```bash
-npx @nitra/cursor check <id>
-```
-
-Зафіксуй поточний вивід (якщо скрипт уже є).
-
-### 2. Розбір тексту правила
-
-Прочитай **`npm/mdc/<id>.mdc`** повністю. Для кожної вимоги виріши:
-
-| Тип                                                                                | Куди                                                                                     |
-| ---------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
-| Перевірювана структура (файли, поля JSON/YAML, наявність ключів, заборонені шляхи) | **`check-<id>.mjs`**                                                                     |
-| Семантика JS/TS у файлах                                                           | **`check-<id>.mjs`** через **Oxc AST** (`oxc-parser`), не «сліпі» regex по всьому файлу  |
-| Вміст у Vue SFC / MDX / Astro                                                      | Спочатку **виділи** валідний JS/TS-фрагмент, потім AST; regex — лише для ізоляції блоків |
-| Не-JS конфіги, сирі workflow                                                       | Текстовий/структурний парсинг або обґрунтований regex; у JSDoc коротко **чому** не AST   |
-| Смак, архітектура, «навіщо так», поради без однозначного критерію                  | Залиш у **`.mdc`**                                                                       |
-
-### 3. Скрипт
-
-- **Новий** `check-<id>.mjs`: орієнтуйся на наявні файли в **`npm/scripts/`** (наприклад **`check-bun.mjs`**) — стиль **`fail` / `pass`**, **`export async function check()`**, exit code **0 / 1**.
-- **На початку файлу** (перед `import`) — **багаторядковий** верхній JSDoc **українською**: що перевіряє файл; між смисловими блоками — рядок `*`; перші рядки без службових префіксів — одразу зрозуміло призначення.
-- **JSDoc** до експортованих функцій і нетривіальних внутрішніх функцій.
-- Повідомлення **`fail`**: конкретно, що не так і як виправити (як у інших check-скриптах).
-- Залежність **`oxc-parser`** не додавай у корінь споживача — вона в **`dependencies`** пакета **`@nitra/cursor`** (див. **dev-dep** / **scripts.mdc**).
-
-### 4. Тести
-
-Якщо логіка нетривіальна або її легко зламати — додай **`npm/tests/check-<id>.test.mjs`** (або розшир наявні тести). Після змін:
-
-```bash
-cd npm && bun test
-```
-
-### 5. Спрощення `.mdc`
-
-- Прибери з правила **дубль** детальних умов, які тепер у скрипті; залиш **короткий зміст**, мотивацію, посилання на файли/конвенції.
-- Потрібно зберегти (або додати) секцію **«Перевірка»** з **`npx @nitra/cursor check <id>`** (або повним ім’ям правила з `AGENTS.md`).
-- Якщо оновлюєш пакетне правило, **синхронно** онови дзеркало **`.cursor/rules/n-<id>.mdc`**, щоб текст не розходився (як прийнято в цьому репозиторії).
-
-### 6. Верифікація та версія пакета
-
-```bash
-npx @nitra/cursor check <id>
-```
-
-Після змін у **`npm/`** (у тому числі `skills/`, `scripts/`, `mdc/`) підвищ **patch**-версію в **`npm/package.json`** на **один** крок відносно вже запланованого релізу (див. **n-npm-module**).
-
-## Антипатерни
-
-- Залишати в `.mdc` великі «еталонні» YAML/JSON, якщо перевірка може читати очікувану структуру з репозиторію або константи в скрипті.
-- Оновлювати лише текст правила без оновлення **`check-<id>.mjs`**, коли для правила вже є скрипт або з’явилась нова перевірювана умова.
-- Дублювати однакову логіку в кількох check-скриптах замість спільної утиліти в **`npm/scripts/utils/`**.
-
-## Команда в чаті
-
-`/n-mdc-check` — застосуй цей workflow до правила з поточного контексту або до `<id>`, який вкаже користувач.