@nitra/cursor 11.3.0 → 11.4.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [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.0",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",

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