@nitra/cursor 11.3.0 → 11.4.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [11.4.1] - 2026-06-16
+
+### Fixed
+
+- release: commit-back більше не «вдається» мовчки за відхиленого push — результат `git push` тепер ЯВНО перевіряється (раніше тихий runGit повертав null, а реліз рапортував успіх, через що npm міг піти попереду git). За non-fast-forward (паралельний push у ту саму гілку) release-коміт автоматично rebase-иться на свіжий upstream, теги пересуваються на новий HEAD і push повторюється (до 5 спроб); без upstream або при rebase-конфлікті — кидаємо помилку (exit 1), тож CI-публікація не відбувається без приземленого commit-back.
+
+## [11.4.0] - 2026-06-15
+
+### Changed
+
+- Додано логіку відсіювання неактуальних правил/скілів за `availableRules`/`availableSkills
+
 ## [11.3.0] - 2026-06-15
 
 ### Changed

package/bin/docs/n-cursor.md

@@ -173,7 +173,7 @@
 #### Вкладена normalizeConfigWithAutoRules(parsedConfig)
 
 - **Сигнатура:** `async function normalizeConfigWithAutoRules(parsedConfig: Record<string, unknown>): Promise<Record<string, unknown>>`
-- **Призначення:** перевіряє типи полів, обчислює `auto-detected rules` (`detectAutoRules`), будує ефективний список правил (поточні + auto, мінус `disable-rules`), за яким `detectAutoSkills` визначає скіли. Далі `mergeConfigWithAutoDetected` зливає дані, після чого `$schema` вирівнюється до `CONFIG_SCHEMA_URL`, додаються `disable-rules`/`disable-skills` (якщо непорожні), результат проходить через `sortConfigIdArrays`.
+- **Призначення:** перевіряє типи полів, обчислює `auto-detected rules` (`detectAutoRules`), будує ефективний список правил (поточні + auto, мінус `disable-rules`), за яким `detectAutoSkills` визначає скіли. Далі `mergeConfigWithAutoDetected` зливає дані (передаючи `availableRules`/`availableSkills` із каталогів пакета, щоб відсіяти з `rules`/`skills` неактуальні id, яких уже немає у пакеті — прибрані логуються через `🧹`), після чого `$schema` вирівнюється до `CONFIG_SCHEMA_URL`, додаються `disable-rules`/`disable-skills` (якщо непорожні), результат проходить через `sortConfigIdArrays`.
 
 ### logRuleMigrationsIfAny(parsedConfig)
 

package/bin/n-cursor.js

@@ -25,7 +25,7 @@
  *   `npx \@nitra/cursor lint-text`   — канонічний lint-text (text.mdc): `cspell` → `shellcheck` (з auto-fix) →
  *                                     `markdownlint-cli2 --fix` → `v8r` (json/json5/yaml/yml/toml)
  *   `npx \@nitra/cursor lint-doc-files`  — детермінований детектор застарілості файлових док (`stale`: `missing`|`crc-mismatch`); правило doc-files (ignore-glob у `npm/rules/doc-files/js/docgen-ignore.mjs`; тека `docs/` поряд із джерелом). Режими: повний (exit 1), `--json` (exit 0), `--missing-only`, `--hook`/`--git` (hook-протокол, exit 2), `--degraded`
- *   `npx \@nitra/cursor fix-doc-files`   — JS-оркестрована генерація файлових док (роутинг local/cloud) зі штампом CRC (`--limit`/`--from`/`--overwrite`/`--retry-degraded`); `--stamp` — детерміноване перештампування CRC без LLM
+ *   `npx \@nitra/cursor fix-doc-files`   — JS-оркестрована генерація файлових док (роутинг local/cloud) зі штампом CRC (`--limit`/`--from`/`--overwrite`); `--stamp` — детерміноване перештампування CRC без LLM
  *   `npx \@nitra/cursor doc-aggregate modules` — JSON-лістинг логічних модулів (межі за `package.json`) для Tier 2 скілу doc-aggregate
  *   `npx \@nitra/cursor skill list`     — скіли пакета без синку в проєкт
  *   `npx \@nitra/cursor skill taze`     — промпт на stdout
@@ -315,9 +315,18 @@ async function readConfig(paths = {}) {
     const merged = mergeConfigWithAutoDetected({
       config: parsedConfig,
       detectedRules: autoDetectedRules.rules,
-      detectedSkills: autoDetectedSkills.skills
+      detectedSkills: autoDetectedSkills.skills,
+      availableRules,
+      availableSkills
     })
 
+    if (merged.pruned) {
+      const parts = []
+      if (merged.pruned.rules.length > 0) parts.push(`rules: ${merged.pruned.rules.join(', ')}`)
+      if (merged.pruned.skills.length > 0) parts.push(`skills: ${merged.pruned.skills.join(', ')}`)
+      console.log(`🧹 Прибрано з ${CONFIG_FILE} неактуальні (немає у пакеті) — ${parts.join('; ')}\n`)
+    }
+
     const rest = Object.fromEntries(Object.entries(parsedConfig).filter(([k]) => k !== '$schema'))
     const normalized = {
       $schema: CONFIG_SCHEMA_URL,
@@ -1650,7 +1659,7 @@ try {
     }
     case 'fix-doc-files': {
       // n-cursor fix-doc-files — local-only генерація файлових док (omlx) + CRC-штамп
-      // (--limit/--from/--overwrite/--retry-degraded); --stamp — детерміноване
+      // (--limit/--from/--overwrite); --stamp — детерміноване
       // перештампування source+crc без LLM. У CI не запускається (потрібна локальна модель).
       if (args.includes('--stamp')) {
         const { runDocFilesStampCli } = await import('../rules/doc-files/js/docgen-files-batch.mjs')

package/package.json

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

package/rules/release/release.mjs

@@ -64,6 +64,45 @@ async function collectChangeFiles(cwd, manifest, runGit) {
   return [{ file: null, entry: synthesized }]
 }
 
+/**
+ * Пушить release-коміт (із тегами) у апстрім, переживаючи паралельні push у ту саму гілку.
+ * `runGit` — ТИХИЙ раннер (повертає null при помилці), тож non-fast-forward push не кидає, а
+ * повертає null; цей хелпер ЯВНО перевіряє результат, щоб реліз не «вдався» без приземленого
+ * commit-back (саме така мовчазна поразка лишала npm попереду git). За відмовою push:
+ * fetch + rebase release-коміту на свіжий апстрім, пересунути теги на новий HEAD і повторити
+ * (до `attempts` разів). Без апстріму або при rebase-конфлікті — кидаємо, а не маскуємо.
+ * @param {(args: string[]) => Promise<string | null>} runGit git-раннер
+ * @param {string[]} tags теги релізу (вже створені на поточному HEAD)
+ * @param {number} [attempts] максимум спроб push
+ * @returns {Promise<void>} результат; кидає, якщо push так і не приземлився
+ */
+async function pushReleaseWithRetry(runGit, tags, attempts = 5) {
+  for (let attempt = 1; attempt <= attempts; attempt++) {
+    const pushed = await runGit(['push', '--follow-tags'])
+    if (pushed !== null) return
+    if (attempt === attempts) break
+    // push відхилено (найімовірніше non-fast-forward — апстрім пішов уперед) → інтегруємо й пробуємо ще
+    const upstream = (await runGit(['rev-parse', '--abbrev-ref', '--symbolic-full-name', '@{u}']))?.trim()
+    if (!upstream) {
+      throw new Error('release: git push відхилено, а upstream для rebase немає — commit-back не приземлився')
+    }
+    const remote = upstream.includes('/') ? upstream.slice(0, upstream.indexOf('/')) : 'origin'
+    await runGit(['fetch', remote])
+    const rebased = await runGit(['rebase', upstream])
+    if (rebased === null) {
+      await runGit(['rebase', '--abort'])
+      throw new Error(`release: push відхилено і rebase на ${upstream} дав конфлікт — розв'яжи вручну`)
+    }
+    // після rebase хеш release-коміту змінився → пересуваємо теги на новий HEAD
+    for (const tag of tags) {
+      await runGit(['tag', '-f', tag])
+    }
+  }
+  throw new Error(
+    `release: git push не вдався після ${attempts} спроб (non-fast-forward?) — commit-back не приземлився, реліз неуспішний`
+  )
+}
+
 /**
  * @param {object} [opts] опції
  * @param {string} [opts.cwd] корінь
@@ -112,7 +151,7 @@ export async function release(opts = {}) {
     for (const tag of tags) {
       await runGit(['tag', tag])
     }
-    await runGit(['push', '--follow-tags'])
+    await pushReleaseWithRetry(runGit, tags)
   }
   return released
 }

package/rules/vue/vue.mdc

@@ -1,6 +1,6 @@
 ---
 description: Vue
-version: '2.2'
+version: '2.3'
 globs: "**/*.vue"
 alwaysApply: false
 ---
@@ -110,6 +110,24 @@ const additionalInstructions = `
 - **debounce/throttle** для частих подій.
 - Після ручних **addEventListener** / підписок — прибирай у **onUnmounted**.
 
+### Функції в шаблоні
+
+Виклики функцій у шаблоні дозволені **лише** в обробниках подій (`@click`, `@change` тощо). У всіх інших місцях — `v-if`, `v-show`, атрибутах (`:prop`), інтерполяціях (`{{ }}`) — замінюй функції на `computed`-властивості: функція виконується при **кожному** render-і, тоді як `computed` кешується і перераховується лише при зміні залежностей.
+
+```vue
+<!-- ❌ функція в умові, атрибуті та інтерполяції -->
+<q-item v-if="getItems(order).length" :label="getLabel(item)">
+  {{ formatName(user) }}
+</q-item>
+
+<!-- ✅ реактивні змінні / computed / props -->
+<q-item v-if="itemsMap[order.id].length" :label="item.label">
+  {{ user.displayName }}
+</q-item>
+<!-- обробник події — виклик функції дозволений -->
+<q-btn @click="doSomething(item)" />
+```
+
 ### Безпека
 
 - Не довіряй **v-html** без санітизації; для форм/API — **CSRF**-захист за потреби; валідація **на сервері** обов’язкова.

package/scripts/auto-rules.mjs

@@ -392,14 +392,45 @@ export async function detectAutoRules({
 }
 
 /**
- * Доповнює конфіг автодетектом (лише додає; існуючі вручну задані елементи не прибирає).
+ * Розділяє список id на доступні в пакеті й застарілі (відсутні).
+ * Без `available` нічого не прибирає — усе вважається доступним.
+ * @param {string[]} ids перелік id (rules або skills)
+ * @param {string[] | undefined} available id, що реально є у каталозі пакета
+ * @returns {{ kept: string[], pruned: string[] }} відфільтровані й прибрані id
+ */
+function partitionByAvailability(ids, available) {
+  if (!available) return { kept: ids, pruned: [] }
+  const availableSet = new Set(available)
+  const kept = []
+  const pruned = []
+  for (const id of ids) {
+    if (availableSet.has(id)) kept.push(id)
+    else pruned.push(id)
+  }
+  return { kept, pruned }
+}
+
+/**
+ * Доповнює конфіг автодетектом (лише додає; існуючі вручну задані елементи не прибирає),
+ * а за наявності `availableRules`/`availableSkills` ще й прибирає з `rules`/`skills`
+ * неактуальні id, яких уже немає у пакеті (наприклад, правило чи скіл видалено з нової
+ * версії \@nitra/cursor) — інакше sync щоразу падав би на завантаженні відсутнього
+ * `rules/<id>.mdc` чи `skills/<id>/`. Прибрані id повертаються у полі `pruned` (для логу).
  * @param {object} params параметри оновлення
  * @param {{ rules: unknown, skills?: unknown, ['disable-rules']?: unknown, ['disable-skills']?: unknown }} params.config розпарсений `.n-cursor.json`
  * @param {string[]} params.detectedRules правила, визначені автодетектом
  * @param {string[]} params.detectedSkills skills, визначені автодетектом
- * @returns {{ rules: string[], skills: string[] } & Record<string, unknown>} новий нормалізований конфіг
+ * @param {string[]} [params.availableRules] id правил, наявних у каталозі `rules/` пакета (для відсіву неактуальних)
+ * @param {string[]} [params.availableSkills] id skills, наявних у каталозі `skills/` пакета (для відсіву неактуальних)
+ * @returns {{ rules: string[], skills: string[], pruned?: { rules: string[], skills: string[] } } & Record<string, unknown>} новий нормалізований конфіг
  */
-export function mergeConfigWithAutoDetected({ config, detectedRules, detectedSkills }) {
+export function mergeConfigWithAutoDetected({
+  config,
+  detectedRules,
+  detectedSkills,
+  availableRules,
+  availableSkills
+}) {
   const existingRules = migrateRuleIds(normalizeIdList(config.rules))
   const existingSkills = normalizeIdList(config.skills)
   const disableRules = migrateRuleIds(normalizeIdList(config['disable-rules']))
@@ -419,13 +450,19 @@ export function mergeConfigWithAutoDetected({ config, detectedRules, detectedSki
     }
   }
 
-  /** @type {{ rules: string[], skills: string[] } & Record<string, unknown>} */
-  const normalized = { rules, skills }
+  const { kept: keptRules, pruned: prunedRules } = partitionByAvailability(rules, availableRules)
+  const { kept: keptSkills, pruned: prunedSkills } = partitionByAvailability(skills, availableSkills)
+
+  /** @type {{ rules: string[], skills: string[], pruned?: { rules: string[], skills: string[] } } & Record<string, unknown>} */
+  const normalized = { rules: keptRules, skills: keptSkills }
   if (disableRules.length > 0) {
     normalized['disable-rules'] = disableRules
   }
   if (disableSkills.length > 0) {
     normalized['disable-skills'] = disableSkills
   }
+  if (prunedRules.length > 0 || prunedSkills.length > 0) {
+    normalized.pruned = { rules: prunedRules, skills: prunedSkills }
+  }
   return normalized
 }

package/scripts/docs/auto-rules.md

@@ -1,7 +1,7 @@
 ---
 docgen:
   source: npm/scripts/auto-rules.mjs
-  crc: 972b56fc
+  crc: d50b922f
   score: 90
 ---
 
@@ -29,7 +29,7 @@ detectAutoRules
 Визначає активні правила на основі spec, перевіряючи їх проти згенерованих фактів.
 
 mergeConfigWithAutoDetected
-Доповнює конфігурацію, додаючи визначені автоправила та налаштування, з урахуванням legacy-ID.
+Доповнює конфігурацію, додаючи визначені автоправила та налаштування, з урахуванням legacy-ID; за наявності `availableRules`/`availableSkills` ще й відсіює з `rules`/`skills` неактуальні id, яких немає у пакеті (повертає їх у полі `pruned`).
 
 ## Публічний API