@nitra/cursor 1.5.3 → 1.5.5

package/mdc/js-lint.mdc

@@ -1,7 +1,7 @@
 ---
 description: Перевірка JavaScript коду
 alwaysApply: true
-version: '1.4'
+version: '1.5'
 ---
 
 Перевірка виконується за допомогою **oxlint**, **ESLint** та **jscpd** (дублікати коду).
@@ -43,6 +43,17 @@ version: '1.4'
 }
 ```
 
+## jscpd: рефакторинг і структура
+
+Коли **jscpd** знаходить клони, спочатку зменшуй дублювання кодом, а не конфігом.
+
+- **Рефакторинг:** винеси спільні фрагменти в функції, модулі, утиліти, composables/hooks, спільні компоненти або базові типи — залежно від контексту.
+- **Структура:** якщо одна й та сама логіка розмазана між файлами чи пакетами, запропонуй зміну структури (наприклад, спільний модуль, `shared/`, внутрішній пакет у monorepo), щоб була **одна канонічна реалізація** і повторні місця лише викликали її.
+
+Так ти уникаєш **хибних обходів** перевірки: розширення `ignore` чи завищення `minLines` лише щоб прибрати звіт — не заміна рефакторингу для справжніх клонів. Якщо збіг **семантично випадковий** (генерований код, формальні шаблони без спільної логіки), після оцінки допустимо точковий `ignore` або зміна порогу — з коротким обґрунтуванням.
+
+Але обов'язково перед рефакторингом перевір чи є тести на блоки які підлягають зміні, а саме Bun.test для js та playwright для vue. Якщо є, то перевір чи вони покривають блоки які підлягають зміні. Якщо не покривають або тестів немає — спочатку створи їх, перевір що вони покривають і відпрацьовують коректно, а потім роби рефакторинг і ще раз запускай тести, але якщо тести не відпрацьовують коректно після рефакторингу, то не роби рефакторинг.
+
 Додай workflow `.github/workflows/lint-js.yml`:
 
 ```yaml

package/mdc/js-pino.mdc

@@ -7,7 +7,7 @@ version: '1.0'
 Проект використовує @nitra/pino для логування.
 Якщо в проекті присутній @nitra/bunyan, то він повинен бути замінений на @nitra/pino.
 
-В k8s/base/configmap.yaml повинен бути заданий OTEL_RESOURCE_ATTRIBUTES: 'service.name=<project_name>,service.namespace=<project_namespace>'
+В **/k8s/base/configmap.yaml повинен бути заданий OTEL_RESOURCE_ATTRIBUTES: 'service.name=<project_name>,service.namespace=<project_namespace>'
 а в директоріях з kustomize повинні бути перевизначені значення OTEL_RESOURCE_ATTRIBUTES і в них service.namespace повинен відповідати namespace, в якому знаходиться дана директорія.
 
 Configmap повинен бути з тією самою назвою, що і deployment, якщо у deployment тільки один configmap.

package/mdc/npm-module.mdc

@@ -13,6 +13,52 @@ version: '1.0'
 - npm/ - файли для npm модуля
 - package.json
 
+## npm publish (GitHub Actions)
+
+У `.github/workflows/` має бути workflow `npm-publish.yml`, який публікує пакет з `npm/package.json` на npm при push у `main`, коли змінюється дерево `npm/**`.
+
+Приклад вмісту:
+
+```yaml title=".github/workflows/npm-publish.yml"
+name: npm-publish
+
+on:
+  push:
+    paths:
+      - 'npm/**'
+    branches:
+      - main
+
+concurrency:
+  group: ${{ github.ref }}-${{ github.workflow }}
+  cancel-in-progress: true
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write # КРИТИЧНО для OIDC!
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          persist-credentials: false
+
+      - uses: actions/setup-node@v5
+        with:
+          node-version: '24' # includes npm@11.6.0
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Publish package
+        uses: JS-DevTools/npm-publish@v4
+        with:
+          package: npm/package.json
+```
+
+- `id-token: write` потрібен для **trusted publishing** (OIDC) на npm, якщо пакет налаштований у npm без класичного токена в секретах.
+- Шлях `package: npm/package.json` узгоджений зі структурою monorepo (`npm/` — каталог модуля).
+
 ## Перевірка
 
 `npx @nitra/cursor check npm-module`

package/mdc/text.mdc

@@ -1,7 +1,7 @@
 ---
 description: Обробка та перевірка текстових файлів (cspell, markdownlint-cli2, v8r, CI)
 alwaysApply: true
-version: '1.12'
+version: '1.13'
 ---
 
 Правило описує роботу з **текстовими файлами** в репозиторії: перевірка правопису через **cspell**, стиль **Markdown** через **markdownlint-cli2**, валідація **JSON/YAML/TOML** через **[v8r](https://chris48s.github.io/v8r/)** ([Schema Store](https://www.schemastore.org/)), розширення **DavidAnson.vscode-markdownlint** у Cursor/VS Code та інтеграція в CI.
@@ -210,9 +210,15 @@ jobs:
 
 Підлаштуй `language` під проєкт (наприклад додай `ru-ru`, якщо потрібна перевірка російською). Порядок у `import` може впливати на пріоритет словників — тримай корпоративний `@nitra/cspell-dict` там, де зручно для ваших правил.
 
-## Локальні виключення
+## Локальні виключення (cspell `words`)
 
-У секції `words` у `.cspell.json` додають власні терміни, імена та скорочення, яких немає в словниках.
+Коли **cspell** підсвічує слово, спочатку **виправ текст**, а не розширюй словник:
+
+- виправ **друкарські помилки** та неправильні форми;
+- **перефразуй коректною українською** (або англійською, залежно від контексту файлу): заміни кальки й випадкові склади на звичні формулювання зі словників;
+- заміни **жаргон**, якщо є природний еквівалент у тому ж стилі документації (наприклад, у коментарях пиши «функція зворотного виклику» замість розмовного запозичення з англійського `callback`).
+
+У секцію `words` у `.cspell.json` додавай записи **лише якщо переписати коректно неможливо** або **недоречно**: власні назви, стабільні технічні терміни без усталеного перекладу в проєкті, ідентифікатори зовнішніх API тощо.
 
 ## Інші мови
 

package/package.json

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

package/scripts/check-js-pino.mjs

@@ -1,10 +1,51 @@
 import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
+import { join } from 'node:path'
 
 import { pass } from './utils/pass.mjs'
+import { getMonorepoPackageRootDirs } from './utils/workspaces.mjs'
 
 /**
- * Перевіряє відповідність проєкту правилам js-pino.mdc
+ * Перевіряє відповідність правилам js-pino.mdc для одного workspace-пакета.
+ * @param {string} rootDir відносний шлях workspace (не `'.'`)
+ * @param {(msg: string) => void} fail функція зворотного виклику для реєстрації помилки перевірки
+ * @returns {Promise<void>} завершується після перевірок цього пакета
+ */
+async function checkWorkspacePackage(rootDir, fail) {
+  const label = `[${rootDir}] `
+  const pkgPath = join(rootDir, 'package.json')
+  if (existsSync(pkgPath)) {
+    const pkg = JSON.parse(await readFile(pkgPath, 'utf8'))
+    const allDeps = { ...pkg.dependencies, ...pkg.devDependencies }
+
+    if (allDeps['@nitra/bunyan']) {
+      fail(`${label}@nitra/bunyan знайдено — замінити на @nitra/pino`)
+    }
+    if (allDeps.bunyan) {
+      fail(`${label}bunyan знайдено — замінити на @nitra/pino`)
+    }
+  }
+
+  const configmapPath = join(rootDir, 'k8s/base/configmap.yaml')
+  if (existsSync(configmapPath)) {
+    const content = await readFile(configmapPath, 'utf8')
+    if (content.includes('OTEL_RESOURCE_ATTRIBUTES')) {
+      pass(`${label}k8s/base/configmap.yaml містить OTEL_RESOURCE_ATTRIBUTES`)
+      if (content.includes('service.name=') && content.includes('service.namespace=')) {
+        pass(`${label}OTEL_RESOURCE_ATTRIBUTES містить service.name та service.namespace`)
+      } else {
+        fail(
+          `${label}OTEL_RESOURCE_ATTRIBUTES має містити service.name=<name>,service.namespace=<namespace>`
+        )
+      }
+    } else {
+      fail(`${label}k8s/base/configmap.yaml не містить OTEL_RESOURCE_ATTRIBUTES`)
+    }
+  }
+}
+
+/**
+ * Перевіряє відповідність проєкту правилам js-pino.mdc лише для workspace-пакетів (не корінь репо).
  * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
  */
 export async function check() {
@@ -14,26 +55,18 @@ export async function check() {
     exitCode = 1
   }
 
-  if (existsSync('package.json')) {
-    const pkg = JSON.parse(await readFile('package.json', 'utf8'))
-    const allDeps = { ...pkg.dependencies, ...pkg.devDependencies }
+  const roots = await getMonorepoPackageRootDirs()
+  const workspaceRoots = roots.filter(r => r !== '.')
 
-    if (allDeps['@nitra/bunyan']) fail('@nitra/bunyan знайдено — замінити на @nitra/pino')
-    if (allDeps.bunyan) fail('bunyan знайдено — замінити на @nitra/pino')
+  if (workspaceRoots.length === 0) {
+    pass(
+      'js-pino: немає workspace-пакетів у кореневому package.json — перевірку залежностей і k8s у пакетах пропущено'
+    )
+    return exitCode
   }
 
-  if (existsSync('k8s/base/configmap.yaml')) {
-    const content = await readFile('k8s/base/configmap.yaml', 'utf8')
-    if (content.includes('OTEL_RESOURCE_ATTRIBUTES')) {
-      pass('k8s/base/configmap.yaml містить OTEL_RESOURCE_ATTRIBUTES')
-      if (content.includes('service.name=') && content.includes('service.namespace=')) {
-        pass('OTEL_RESOURCE_ATTRIBUTES містить service.name та service.namespace')
-      } else {
-        fail('OTEL_RESOURCE_ATTRIBUTES має містити service.name=<name>,service.namespace=<namespace>')
-      }
-    } else {
-      fail('k8s/base/configmap.yaml не містить OTEL_RESOURCE_ATTRIBUTES')
-    }
+  for (const r of workspaceRoots) {
+    await checkWorkspacePackage(r, fail)
   }
 
   return exitCode

package/scripts/check-vue.mjs

@@ -1,10 +1,98 @@
 import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
+import { join } from 'node:path'
 
 import { pass } from './utils/pass.mjs'
+import { getMonorepoPackageRootDirs } from './utils/workspaces.mjs'
 
 /**
- * Перевіряє відповідність проєкту правилам vue.mdc
+ * Формує зрозумілий для людини підпис пакета для повідомлень перевірки.
+ * @param {string} rootDir відносний шлях (`'.'` або `site` тощо)
+ * @returns {string} підпис для логів перевірки
+ */
+function packageLabel(rootDir) {
+  return rootDir === '.' ? 'корінь' : rootDir
+}
+
+/**
+ * Перевіряє залежності та vite.config одного Vue-пакета.
+ * @param {string} rootDir відносний шлях до пакета
+ * @param {(msg: string) => void} fail функція зворотного виклику для реєстрації помилки перевірки
+ * @returns {Promise<void>} завершується після перевірок залежностей і Vite
+ */
+async function checkVuePackage(rootDir, fail) {
+  const label = packageLabel(rootDir)
+  const prefix = `[${label}] `
+
+  const pkgPath = join(rootDir, 'package.json')
+  const pkg = JSON.parse(await readFile(pkgPath, 'utf8'))
+  const deps = pkg.dependencies || {}
+  const devDeps = pkg.devDependencies || {}
+  const allDeps = { ...deps, ...devDeps }
+
+  if (deps.vue) {
+    pass(`${prefix}vue в dependencies: ${deps.vue}`)
+  } else {
+    fail(`${prefix}vue відсутній в dependencies`)
+  }
+
+  if (devDeps.vite) {
+    const match = devDeps.vite.match(/(\d+)/)
+    if (match && Number(match[1]) >= 8) {
+      pass(`${prefix}vite >= 8: ${devDeps.vite}`)
+    } else {
+      fail(`${prefix}vite має бути >= 8, знайдено: ${devDeps.vite}`)
+    }
+  } else {
+    fail(`${prefix}vite відсутній в devDependencies`)
+  }
+
+  if (devDeps['@vitejs/plugin-vue']) {
+    pass(`${prefix}@vitejs/plugin-vue: ${devDeps['@vitejs/plugin-vue']}`)
+  } else {
+    fail(`${prefix}@vitejs/plugin-vue відсутній в devDependencies`)
+  }
+
+  if (allDeps['vue-macros']) {
+    pass(`${prefix}vue-macros: ${allDeps['vue-macros']}`)
+  } else {
+    fail(`${prefix}vue-macros відсутній — bun add -d vue-macros`)
+  }
+
+  if (allDeps['unplugin-auto-import']) {
+    pass(`${prefix}unplugin-auto-import присутній`)
+  } else {
+    fail(`${prefix}unplugin-auto-import відсутній — bun add -d unplugin-auto-import`)
+  }
+
+  if (allDeps['vite-plugin-vue-layouts-next']) {
+    pass(`${prefix}vite-plugin-vue-layouts-next присутній`)
+  } else {
+    fail(`${prefix}vite-plugin-vue-layouts-next відсутній — bun add -d vite-plugin-vue-layouts-next`)
+  }
+
+  const configFiles = ['vite.config.js', 'vite.config.ts', 'vite.config.mjs']
+  const viteConfig = configFiles.find(f => existsSync(join(rootDir, f)))
+  if (viteConfig) {
+    const relConfig = join(rootDir, viteConfig)
+    const content = await readFile(relConfig, 'utf8')
+    if (content.includes('VueMacros')) {
+      pass(`${prefix}${viteConfig} використовує VueMacros`)
+    } else {
+      fail(`${prefix}${viteConfig} не містить VueMacros`)
+    }
+    if (content.includes('AutoImport')) {
+      pass(`${prefix}${viteConfig} використовує AutoImport`)
+    } else {
+      fail(`${prefix}${viteConfig} не містить AutoImport`)
+    }
+  } else {
+    fail(`${prefix}немає vite.config.js|ts|mjs у каталозі пакета`)
+  }
+}
+
+/**
+ * Перевіряє відповідність проєкту правилам vue.mdc (корінь і всі workspace-пакети з `vue` у dependencies).
  * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
  */
 export async function check() {
@@ -25,70 +113,26 @@ export async function check() {
     fail('.vscode/extensions.json не існує')
   }
 
-  if (existsSync('package.json')) {
-    const pkg = JSON.parse(await readFile('package.json', 'utf8'))
-    const deps = pkg.dependencies || {}
-    const devDeps = pkg.devDependencies || {}
-    const allDeps = { ...deps, ...devDeps }
-
-    if (deps.vue) {
-      pass(`vue в dependencies: ${deps.vue}`)
-    } else {
-      fail('vue відсутній в dependencies')
-    }
-
-    if (devDeps.vite) {
-      const match = devDeps.vite.match(/(\d+)/)
-      if (match && Number(match[1]) >= 8) {
-        pass(`vite >= 8: ${devDeps.vite}`)
-      } else {
-        fail(`vite має бути >= 8, знайдено: ${devDeps.vite}`)
-      }
-    } else {
-      fail('vite відсутній в devDependencies')
-    }
-
-    if (devDeps['@vitejs/plugin-vue']) {
-      pass(`@vitejs/plugin-vue: ${devDeps['@vitejs/plugin-vue']}`)
-    } else {
-      fail('@vitejs/plugin-vue відсутній в devDependencies')
-    }
-
-    if (allDeps['vue-macros']) {
-      pass(`vue-macros: ${allDeps['vue-macros']}`)
-    } else {
-      fail('vue-macros відсутній — bun add -d vue-macros')
-    }
-
-    if (allDeps['unplugin-auto-import']) {
-      pass('unplugin-auto-import присутній')
-    } else {
-      fail('unplugin-auto-import відсутній — bun add -d unplugin-auto-import')
+  const roots = await getMonorepoPackageRootDirs()
+  /** @type {string[]} */
+  const vueRoots = []
+  for (const r of roots) {
+    const p = join(r, 'package.json')
+    if (existsSync(p)) {
+      const pkg = JSON.parse(await readFile(p, 'utf8'))
+      if (pkg.dependencies?.vue) vueRoots.push(r)
     }
+  }
 
-    if (allDeps['vite-plugin-vue-layouts-next']) {
-      pass('vite-plugin-vue-layouts-next присутній')
-    } else {
-      fail('vite-plugin-vue-layouts-next відсутній — bun add -d vite-plugin-vue-layouts-next')
-    }
+  if (vueRoots.length === 0) {
+    fail(
+      'vue не знайдено в dependencies жодного пакета (корінь репо та каталоги з кореневого workspaces)'
+    )
+    return exitCode
   }
 
-  const configFiles = ['vite.config.js', 'vite.config.ts', 'vite.config.mjs']
-  const viteConfig = configFiles.find(f => existsSync(f))
-  if (viteConfig) {
-    const content = await readFile(viteConfig, 'utf8')
-    if (content.includes('VueMacros')) {
-      pass('vite.config використовує VueMacros')
-    } else {
-      fail(`${viteConfig} не містить VueMacros`)
-    }
-    if (content.includes('AutoImport')) {
-      pass('vite.config використовує AutoImport')
-    } else {
-      fail(`${viteConfig} не містить AutoImport`)
-    }
-  } else {
-    fail('vite.config.js не існує')
+  for (const r of vueRoots) {
+    await checkVuePackage(r, fail)
   }
 
   return exitCode

package/scripts/utils/workspaces.mjs

@@ -0,0 +1,52 @@
+import { existsSync } from 'node:fs'
+import { glob, readFile } from 'node:fs/promises'
+import { dirname, join, relative } from 'node:path'
+
+/**
+ * Нормалізує поле `workspaces` з package.json до масиву шляхів / glob-патернів.
+ * @param {unknown} workspaces значення `workspaces` з кореневого package.json
+ * @returns {string[]} масив патернів workspaces
+ */
+export function normalizeWorkspacePatterns(workspaces) {
+  if (!workspaces) return []
+  if (Array.isArray(workspaces)) return workspaces
+  if (typeof workspaces === 'object' && workspaces !== null && Array.isArray(workspaces.packages)) {
+    return workspaces.packages
+  }
+  return []
+}
+
+/**
+ * Повертає каталоги з `package.json`: корінь репозиторію та всі пакети з `workspaces`.
+ * @param {string} repoRoot зазвичай `process.cwd()`
+ * @returns {Promise<string[]>} відносні шляхи до коренів пакетів; `'.'` першим, без дублікатів
+ */
+export async function getMonorepoPackageRootDirs(repoRoot = '.') {
+  const roots = new Set(['.'])
+  const rootPkgPath = join(repoRoot, 'package.json')
+  if (!existsSync(rootPkgPath)) {
+    return ['.']
+  }
+  const pkg = JSON.parse(await readFile(rootPkgPath, 'utf8'))
+  for (const raw of normalizeWorkspacePatterns(pkg.workspaces)) {
+    const w = raw.replaceAll('\\', '/').replace(/\/+$/, '') || '.'
+    if (w.includes('*')) {
+      const globPat = `${w}/package.json`
+      for await (const f of glob(globPat, { cwd: repoRoot })) {
+        const abs = join(repoRoot, f)
+        const rel = relative(repoRoot, dirname(abs))
+        roots.add(rel === '' ? '.' : rel)
+      }
+    } else {
+      const pkgJson = join(repoRoot, w, 'package.json')
+      if (existsSync(pkgJson)) roots.add(w)
+    }
+  }
+  const list = [...roots]
+  list.sort((a, b) => {
+    if (a === '.') return -1
+    if (b === '.') return 1
+    return a.localeCompare(b)
+  })
+  return list
+}