@nitra/cursor 3.14.1 → 3.15.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [3.15.0] - 2026-06-02
+
+### Added
+
+- parity-гард дзеркала правил: тест перевіряє, що .cursor/rules/n-<id>.mdc == канонічний npm/rules/<id>/<id>.mdc з inlined-шаблонами (хелпер mirror-parity.mjs), ловлячи дрейф рано. Разово регенеровано наявний дрейф (changelog/flow/ga/npm-module/test).
+
+## [3.14.2] - 2026-06-02
+
+### Fixed
+
+- Додано pull-requests: read до clean-merged-branch.yml, щоб cleanup action міг перевіряти PR-и комітів без 403.
+- detectLevel: ASCII L0-дієслова (fix/typo/bump/rename/hotfix) матчаться цілим словом, а не підрядком — опис на кшталт 'add prefix validation' більше не дає хибний L0 (раніше 'fix' ловився в 'prefix'/'fixture'/'suffix'). Кириличні L0-ключі лишаються підрядком (стемінг).
+
 ## [3.14.1] - 2026-06-02
 
 ### Changed

package/package.json

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

package/rules/ga/policy/clean_merged_branch/clean_merged_branch.rego

@@ -49,8 +49,9 @@ deny contains msg if {
 }
 
 deny contains msg if {
-	input.jobs.cleanup_old_branches.permissions.contents != expected_perms.contents
-	msg := sprintf("clean-merged-branch.yml: permissions.contents має бути %s (ga.mdc)", [expected_perms.contents])
+	some permission, expected in expected_perms
+	object.get(input.jobs.cleanup_old_branches.permissions, permission, null) != expected
+	msg := sprintf("clean-merged-branch.yml: permissions.%s має бути %s (ga.mdc)", [permission, expected])
 }
 
 deny contains msg if {

package/rules/ga/policy/clean_merged_branch/template/clean-merged-branch.yml.snippet.yml

@@ -17,6 +17,7 @@ jobs:
     runs-on: ubuntu-latest
     permissions:
       contents: write
+      pull-requests: read
     steps:
       - id: delete_stuff
         name: Delete those pesky dead branches

package/scripts/dispatcher/lib/level.mjs

@@ -10,11 +10,38 @@
 
 /** L3 — велике/архітектурне. */
 const L3_KEYS = ['platform', 'migration', 'rewrite', 'architecture', 'enterprise', 'редизайн', 'міграц', 'переписат']
-/** L0 — тривіальне. */
-const L0_KEYS = ['fix', 'typo', 'bump', 'rename', 'hotfix', 'опечат', 'перейменув']
+/** L0 — тривіальне. ASCII-дієслова: матч цілим словом (щоб `fix` не ловило `prefix`/`fixture`). */
+const L0_WORD_KEYS = ['fix', 'typo', 'bump', 'rename', 'hotfix']
+/** L0 — кириличні ключі: підрядком (стемінг: `перейменув` ловить `перейменування`). */
+const L0_SUBSTR_KEYS = ['опечат', 'перейменув']
 /** L2 — багатофайлова фіча/рефактор. */
 const L2_KEYS = ['feature', 'epic', 'refactor', 'рефактор', 'фіча']
 
+/**
+ * Чи символ — ASCII-літера/цифра (межа слова). `undefined` (край рядка) — не alnum.
+ * @param {string | undefined} ch символ
+ * @returns {boolean} результат
+ */
+function isAsciiAlnum(ch) {
+  return ch !== undefined && ((ch >= 'a' && ch <= 'z') || (ch >= '0' && ch <= '9'))
+}
+
+/**
+ * Чи містить `text` слово `word` із межами, що не є ASCII-alnum (без regex —
+ * конвенція файлу). Для ASCII L0-дієслів: `fix` у `prefix`/`fixture` не рахується.
+ * @param {string} text текст (lowercase)
+ * @param {string} word шукане ASCII-слово (lowercase)
+ * @returns {boolean} результат
+ */
+function hasWord(text, word) {
+  let i = text.indexOf(word)
+  while (i !== -1) {
+    if (!isAsciiAlnum(text[i - 1]) && !isAsciiAlnum(text[i + word.length])) return true
+    i = text.indexOf(word, i + 1)
+  }
+  return false
+}
+
 /**
  * Рівень складності задачі за описом: 0 (тривіальне) … 3 (архітектурне).
  * Пріоритет: L3 > L0 > L2 > дефолт L1.
@@ -24,8 +51,9 @@ const L2_KEYS = ['feature', 'epic', 'refactor', 'рефактор', 'фіча']
 export function detectLevel(desc) {
   const d = String(desc ?? '').toLowerCase()
   const has = keys => keys.some(k => d.includes(k))
+  const isL0 = L0_WORD_KEYS.some(k => hasWord(d, k)) || L0_SUBSTR_KEYS.some(k => d.includes(k))
   if (has(L3_KEYS)) return 3
-  if (has(L0_KEYS)) return 0
+  if (isL0) return 0
   if (has(L2_KEYS)) return 2
   return 1
 }

package/scripts/lib/mirror-parity.mjs

@@ -0,0 +1,60 @@
+/**
+ * Parity дзеркала правил: `.cursor/rules/n-<id>.mdc` має дорівнювати канонічному
+ * `npm/rules/<id>/<id>.mdc` з inlined-шаблонами — тим самим трансформом, що його
+ * застосовує синк (`readBundledRuleContent` → `inlineTemplateLinks`). Дрейф виникає,
+ * коли канонічний `.mdc` змінюють, не регенерувавши дзеркало (беклог адаптації flow #10).
+ *
+ * Використовується і тестом-гардом (drift === []), і разовою регенерацією.
+ */
+import { existsSync, readdirSync, readFileSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+
+import { inlineTemplateLinks } from './inline-template-links.mjs'
+
+const MIRROR_PREFIX = 'n-'
+const MDC_EXT = '.mdc'
+
+/**
+ * Керовані дзеркала `.cursor/rules/n-<id>.mdc`, що мають канонічне джерело
+ * `npm/rules/<id>/<id>.mdc`. Дзеркала без канону (зовнішні) пропускаються.
+ * @param {string} repoRoot корінь репо
+ * @returns {{ id: string, mirrorPath: string, canonicalPath: string }[]} список
+ */
+export function listManagedMirrors(repoRoot) {
+  const rulesDir = join(repoRoot, '.cursor/rules')
+  if (!existsSync(rulesDir)) return []
+  return readdirSync(rulesDir)
+    .filter(f => f.startsWith(MIRROR_PREFIX) && f.endsWith(MDC_EXT))
+    .map(f => {
+      const id = f.slice(MIRROR_PREFIX.length, -MDC_EXT.length)
+      return {
+        id,
+        mirrorPath: join(rulesDir, f),
+        canonicalPath: join(repoRoot, 'npm/rules', id, `${id}${MDC_EXT}`)
+      }
+    })
+    .filter(m => existsSync(m.canonicalPath))
+}
+
+/**
+ * Очікуваний вміст дзеркала = канон з inlined-шаблонами (трансформ синку).
+ * @param {string} canonicalPath абсолютний шлях `npm/rules/<id>/<id>.mdc`
+ * @returns {Promise<string>} очікуваний текст дзеркала
+ */
+export function expectedMirrorContent(canonicalPath) {
+  return inlineTemplateLinks(readFileSync(canonicalPath, 'utf8'), dirname(canonicalPath))
+}
+
+/**
+ * Id дзеркал, що розійшлися з каноном (actual ≠ expected).
+ * @param {string} repoRoot корінь репо
+ * @returns {Promise<string[]>} відсортовані id дрейфу
+ */
+export async function findMirrorDrift(repoRoot) {
+  const drift = []
+  for (const m of listManagedMirrors(repoRoot)) {
+    const expected = await expectedMirrorContent(m.canonicalPath)
+    if (readFileSync(m.mirrorPath, 'utf8') !== expected) drift.push(m.id)
+  }
+  return drift.sort()
+}