@nitra/cursor 1.2.2 → 1.3.1

package/bin/nitra-cursor.js

@@ -13,10 +13,13 @@
  *
  * Файл AGENTS.md у корені: щоразу повністю перезаписується змістом з AGENTS.template.md
  * пакету; список правил у шаблоні будується з файлів *.mdc у .cursor/rules поточного проєкту.
+ *
+ * Після завантаження: у .cursor/rules видаляються файли *.mdc з префіксом «nitra-» (керовані
+ * пакетом), яких немає у списку rules у nitra-cursor.json. Інші .mdc у цій директорії залишаються.
  */
 
 import { existsSync } from 'node:fs'
-import { mkdir, readdir, readFile, writeFile } from 'node:fs/promises'
+import { mkdir, readdir, readFile, unlink, writeFile } from 'node:fs/promises'
 import { basename, dirname, join } from 'node:path'
 import { cwd } from 'node:process'
 import { fileURLToPath } from 'node:url'
@@ -172,6 +175,42 @@ async function listProjectRulesMdcFiles() {
   return names.filter(n => n.endsWith('.mdc')).sort((a, b) => a.localeCompare(b))
 }
 
+/**
+ * Базові імена файлів .mdc, які очікуються згідно з nitra-cursor.json (префікс nitra-).
+ * @param {string[]} configRules елементи масиву rules з конфігу
+ * @returns {Set<string>} множина очікуваних імен файлів (наприклад nitra-bun.mdc)
+ */
+function expectedManagedRuleBasenames(configRules) {
+  return new Set(configRules.map(rule => `${RULE_PREFIX}${normalizeRuleName(rule)}`))
+}
+
+/**
+ * Видаляє з каталогу правил файли *.mdc з префіксом nitra-, яких немає у конфігурації.
+ * Файли без префікса nitra- не змінює.
+ * @param {string} rulesDir абсолютний шлях до .cursor/rules
+ * @param {string[]} configRules елементи масиву rules з nitra-cursor.json
+ * @returns {Promise<string[]>} відсортовані імена видалених файлів
+ */
+async function removeOrphanManagedRuleFiles(rulesDir, configRules) {
+  if (!existsSync(rulesDir)) {
+    return []
+  }
+  const expected = expectedManagedRuleBasenames(configRules)
+  const names = await readdir(rulesDir)
+  const removed = []
+  for (const name of names) {
+    if (!name.endsWith('.mdc') || !name.startsWith(RULE_PREFIX)) {
+      continue
+    }
+    if (expected.has(name)) {
+      continue
+    }
+    await unlink(join(rulesDir, name))
+    removed.push(name)
+  }
+  return removed.sort((a, b) => a.localeCompare(b))
+}
+
 /**
  * Повністю перезаписує AGENTS.md у корені cwd з npm/AGENTS.template.md
  * @returns {Promise<void>} завершення запису файлу
@@ -237,7 +276,21 @@ for (const rule of rules) {
   }
 }
 
-// 4. AGENTS.md зі списком файлів *.mdc у .cursor/rules (після оновлення на диску)
+// 4. Прибираємо керовані nitra-*.mdc, яких немає у nitra-cursor.json
+try {
+  const removed = await removeOrphanManagedRuleFiles(rulesDir, rules)
+  if (removed.length > 0) {
+    console.log(`\n🧹 Видалено правила поза списком ${CONFIG_FILE} (${removed.length}):`)
+    for (const name of removed) {
+      console.log(`   − ${RULES_DIR}/${name}`)
+    }
+  }
+} catch (error) {
+  console.error(`❌ Не вдалося прибрати зайві файли в ${RULES_DIR}: ${error.message}`)
+  process.exit(1)
+}
+
+// 5. AGENTS.md зі списком файлів *.mdc у .cursor/rules (після оновлення на диску)
 try {
   await syncAgentsMd()
 } catch (error) {
@@ -245,7 +298,7 @@ try {
   process.exit(1)
 }
 
-// 5. Підсумок
+// 6. Підсумок
 console.log(`\n✨ Готово: ${successCount} завантажено, ${failCount} з помилками\n`)
 if (failCount > 0) {
   process.exit(1)

package/mdc/ga.mdc

@@ -0,0 +1,92 @@
+---
+description: Правила форматів для .github/workflows
+alwaysApply: true
+version: '1.0'
+---
+
+#
+
+Всі файли в директорії .github/workflows повинні мати розширення тільки yml
+
+Якщо є .github/workflows/apply-k8s.yml, то в ньому обов'язково повинно бути вказано що критерій для запуску це:
+
+```yaml
+on:
+  push:
+    paths:
+      - '**/k8s/*.yaml'
+```
+
+Якщо є .github/workflows/apply-nats-consumer.yml, то в ньому обов'язково повинно бути вказано що критерій для запуску це:
+
+```yaml
+on:
+  push:
+    paths:
+      - '**/consumer.yaml'
+```
+
+Повинен бути файл .github/workflows/clean-ga-workflows.yml, зі змістом:
+
+```yaml
+name: Clean action for removing completed workflow runs
+
+on:
+  schedule:
+    - cron: '0 1 16 * *'
+
+  # Allow workflow to be manually run from the GitHub UI
+  workflow_dispatch:
+
+jobs:
+  cleanup_old_workflows:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Delete workflow runs
+        uses: dmvict/clean-workflow-runs@v1.0.0
+        with:
+          token: ${{ github.token }}
+          save_period: 31
+          save_min_runs_number: 0
+
+```
+
+Повинен бути файл .github/workflows/clean-merged-branch.yml, зі змістом:
+
+```yaml
+name: Clean abandoned branches
+
+on:
+  # Run daily at midnight
+  schedule:
+    - cron: '0 1 15 * *'
+
+  # Allow workflow to be manually run from the GitHub UI
+  workflow_dispatch:
+
+jobs:
+  cleanup_old_branches:
+    runs-on: ubuntu-latest
+    steps:
+      - id: delete_stuff
+        name: Delete those pesky dead branches
+        uses: phpdocker-io/github-actions-delete-abandoned-branches@v2
+        with:
+          github_token: ${{ github.token }}
+          last_commit_age_days: 90
+          ignore_branches: main,dev
+          dry_run: no
+
+      - name: Get output
+        run: "echo 'Deleted branches: ${{ steps.delete_stuff.outputs.deleted_branches }}'"
+```
+
+якщо в ignore_branches задані інші бранчі, то це допустимо.
+
+в файлі .vscode/extensions.json є налаштування для GitHub Actions:
+
+```json title=".vscode/extensions.json"
+{
+  "recommendations": ["github.vscode-github-actions"]
+}
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "1.2.2",
+  "version": "1.3.1",
   "description": "CLI для завантаження cursor-правил Nitra у локальний репозиторій",
   "keywords": [
     "cli",