@nitra/cursor 1.8.16 → 1.8.18

package/mdc/js-lint.mdc

@@ -1,7 +1,7 @@
 ---
 description: Перевірка JavaScript коду
 alwaysApply: true
-version: '1.8'
+version: '1.9'
 ---
 
 **oxlint**, **ESLint**, **jscpd**. У скрипті **`lint-js`:** `oxlint` (без `bunx`), **`bunx eslint`**, **`bunx jscpd`**; у CI — `bunx oxlint` / `bunx eslint` / `bunx jscpd`. Без **prettier** і **@nitra/prettier-config**. Достатньо **`@nitra/eslint-config`** у devDependencies; пакети oxlint/eslint/jscpd не додавай без потреби монорепо.
@@ -38,7 +38,7 @@ version: '1.8'
   "exitCode": 1,
   "reporters": ["console"],
   "minLines": 25,
-  "ignore": []
+  "ignore": ["**/dist/**",]
 }
 ```
 
@@ -132,9 +132,7 @@ export default [
 
 ## Тести
 
-Проекту повинен бути покритий unit тестами за допомогою Bun test.
-
-**Код:** синтаксис Node **24+**, **top level await**.
+Проєкт має бути покритий unit-тестами (**Bun test**). Код: синтаксис Node **24+**, **top level await** (узгоджено з `engines.node` у `package.json`).
 
 ## Перевірка
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "1.8.16",
+  "version": "1.8.18",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",
@@ -35,10 +35,10 @@
   "scripts": {
     "test": "bun test tests"
   },
-  "engines": {
-    "node": ">=24"
-  },
   "dependencies": {
     "yaml": "^2.8.3"
+  },
+  "engines": {
+    "node": ">=24"
   }
 }

package/scripts/check-js-lint.mjs

@@ -1,14 +1,42 @@
 /**
  * Перевіряє лінт JavaScript за правилом js-lint.mdc.
  *
- * Flat ESLint, скрипт `lint-js` (oxlint, eslint, jscpd), `engines.node`, без prettier,
- * наявність `.jscpd.json` і workflow `lint-js.yml`.
+ * Канонічний `lint-js`, flat ESLint з getConfig і ignore для auto-imports, рекомендації VSCode,
+ * `.jscpd.json` (gitignore, exitCode, reporters, minLines), workflow `lint-js.yml` (checkout@v6,
+ * setup-bun-deps, bunx без --fix), без prettier, `engines.node` >= 24. Дубль перевірки JS у `lint.yml` —
+ * заборонено.
  */
 import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
 
 import { pass } from './utils/pass.mjs'
 
+/** Очікуваний локальний скрипт (oxlint без bunx; eslint/jscpd через bunx). */
+export const CANONICAL_LINT_JS = 'oxlint --fix && bunx eslint --fix . && bunx jscpd .'
+
+/** Мінімальні рекомендації розширень редактора з js-lint.mdc (eslint, oxlint, GA). */
+export const REQUIRED_VSCODE_EXTENSIONS = ['dbaeumer.vscode-eslint', 'github.vscode-github-actions', 'oxc.oxc-vscode']
+
+/**
+ * Нормалізує рядок скрипта для порівняння (зайві пробіли).
+ * @param {string} s вихідний рядок скрипта `lint-js`
+ * @returns {string} рядок без зайвих пробілів на краях і з одиничними пробілами всередині
+ */
+export function normalizeLintJsScript(s) {
+  return String(s).trim().replaceAll(/\s+/gu, ' ')
+}
+
+/**
+ * Чи рядок `lint-js` збігається з каноном і без `bunx oxlint`.
+ * @param {string} script значення `scripts.lint-js` з package.json
+ * @returns {boolean} true, якщо рядок канонічний
+ */
+export function isCanonicalLintJs(script) {
+  const n = normalizeLintJsScript(script)
+  if (n.includes('bunx oxlint')) return false
+  return n === CANONICAL_LINT_JS
+}
+
 /**
  * Перевіряє відповідність проєкту правилам js-lint.mdc
  * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
@@ -20,12 +48,34 @@ export async function check() {
     exitCode = 1
   }
 
+  let eslintPath = ''
   if (existsSync('eslint.config.js')) {
+    eslintPath = 'eslint.config.js'
     pass('eslint.config.js існує')
   } else if (existsSync('eslint.config.mjs')) {
+    eslintPath = 'eslint.config.mjs'
     pass('eslint.config.mjs існує')
   } else {
-    fail('Відсутній eslint.config.js — створи його з getConfig від @nitra/eslint-config')
+    fail('Відсутній eslint.config.js або eslint.config.mjs — flat config з getConfig (js-lint.mdc)')
+  }
+
+  if (eslintPath) {
+    const eslintRaw = await readFile(eslintPath, 'utf8')
+    if (eslintRaw.includes('getConfig')) {
+      pass(`${eslintPath}: містить getConfig`)
+    } else {
+      fail(`${eslintPath}: потрібен виклик getConfig (js-lint.mdc)`)
+    }
+    if (eslintRaw.includes('@nitra/eslint-config')) {
+      pass(`${eslintPath}: імпорт @nitra/eslint-config`)
+    } else {
+      fail(`${eslintPath}: імпортуй getConfig з @nitra/eslint-config`)
+    }
+    if (eslintRaw.includes('**/auto-imports.d.ts')) {
+      pass(`${eslintPath}: ignores містить **/auto-imports.d.ts`)
+    } else {
+      fail(`${eslintPath}: додай у ignores запис **/auto-imports.d.ts (js-lint.mdc)`)
+    }
   }
 
   if (existsSync('package.json')) {
@@ -34,38 +84,25 @@ export async function check() {
     if (pkg.scripts?.['lint-js']) {
       pass('package.json містить скрипт lint-js')
       const lintJs = String(pkg.scripts['lint-js'])
-      if (lintJs.includes('jscpd')) {
-        pass('lint-js містить jscpd')
-      } else {
-        fail('lint-js має викликати jscpd — додай "&& bunx jscpd ." у кінець скрипта')
-      }
-      if (lintJs.includes('bunx eslint')) {
-        pass('lint-js викликає bunx eslint')
-      } else {
-        fail('lint-js має містити bunx eslint (n-js-lint.mdc)')
-      }
-      if (lintJs.includes('bunx jscpd')) {
-        pass('lint-js викликає bunx jscpd')
-      } else {
-        fail('lint-js має містити bunx jscpd (n-js-lint.mdc)')
-      }
-      if (lintJs.includes('oxlint')) {
-        pass('lint-js містить oxlint')
+      if (isCanonicalLintJs(lintJs)) {
+        pass(`lint-js збігається з каноном: ${CANONICAL_LINT_JS}`)
       } else {
-        fail('lint-js має містити oxlint (n-js-lint.mdc)')
+        fail(
+          `lint-js має бути рівно: "${CANONICAL_LINT_JS}" (oxlint без bunx; див. js-lint.mdc / check-js-lint.mjs). Зараз: ${JSON.stringify(normalizeLintJsScript(lintJs))}`
+        )
       }
     } else {
-      fail('package.json не містить скрипт "lint-js" — додай: "oxlint --fix && bunx eslint --fix . && bunx jscpd ."')
+      fail(`package.json не містить скрипт "lint-js" — додай: ${JSON.stringify(CANONICAL_LINT_JS)}`)
     }
 
     const allDeps = { ...pkg.dependencies, ...pkg.devDependencies }
     if (allDeps.prettier) {
-      fail('package.json: видали залежність prettier (oxfmt замість prettier, n-js-lint.mdc)')
+      fail('package.json: видали залежність prettier (oxfmt замість prettier, js-lint.mdc)')
     } else {
       pass('package.json не містить prettier')
     }
     if (allDeps['@nitra/prettier-config']) {
-      fail('package.json: видали @nitra/prettier-config (n-js-lint.mdc)')
+      fail('package.json: видали @nitra/prettier-config (js-lint.mdc)')
     } else {
       pass('package.json не містить @nitra/prettier-config')
     }
@@ -78,7 +115,7 @@ export async function check() {
 
     const nodeEngine = pkg.engines?.node
     if (nodeEngine) {
-      const match = nodeEngine.match(/(\d+)/)
+      const match = nodeEngine.match(/(\d+)/u)
       if (match && Number(match[1]) >= 24) {
         pass(`engines.node: "${nodeEngine}"`)
       } else {
@@ -89,26 +126,68 @@ export async function check() {
     }
   }
 
+  if (existsSync('.vscode/extensions.json')) {
+    let ext
+    try {
+      ext = JSON.parse(await readFile('.vscode/extensions.json', 'utf8'))
+    } catch {
+      fail('.vscode/extensions.json не є валідним JSON')
+      ext = null
+    }
+    if (ext) {
+      const rec = ext.recommendations
+      if (Array.isArray(rec)) {
+        const missing = REQUIRED_VSCODE_EXTENSIONS.filter(id => !rec.includes(id))
+        if (missing.length > 0) {
+          fail(`.vscode/extensions.json: додай у recommendations: ${missing.join(', ')} (мінімум для js-lint.mdc)`)
+        } else {
+          pass('.vscode/extensions.json: є рекомендації oxlint, eslint і GitHub Actions')
+        }
+      } else {
+        fail('.vscode/extensions.json: поле recommendations має бути масивом')
+      }
+    }
+  } else {
+    fail('.vscode/extensions.json не існує — додай recommendations з js-lint.mdc (див. check-js-lint.mjs)')
+  }
+
   if (existsSync('.github/workflows/lint-js.yml')) {
     const content = await readFile('.github/workflows/lint-js.yml', 'utf8')
     pass('lint-js.yml існує')
-    if (content.includes('oxlint')) {
-      pass('lint-js.yml містить oxlint')
-    } else {
-      fail('lint-js.yml не містить oxlint')
+    const checks = [
+      ['actions/checkout@v6', 'lint-js.yml: потрібен крок actions/checkout@v6 (ga.mdc)'],
+      ['persist-credentials: false', 'lint-js.yml: checkout з persist-credentials: false'],
+      ['./.github/actions/setup-bun-deps', 'lint-js.yml: потрібен uses: ./.github/actions/setup-bun-deps'],
+      ['bunx oxlint', 'lint-js.yml: у run має бути bunx oxlint'],
+      ['bunx eslint .', 'lint-js.yml: у run має бути bunx eslint . (без --fix у CI)'],
+      ['bunx jscpd .', 'lint-js.yml: у run має бути bunx jscpd .']
+    ]
+    for (const [needle, errMsg] of checks) {
+      if (content.includes(needle)) {
+        pass(`lint-js.yml містить: ${needle}`)
+      } else {
+        fail(errMsg)
+      }
     }
-    if (content.includes('eslint')) {
-      pass('lint-js.yml містить eslint')
-    } else {
-      fail('lint-js.yml не містить eslint')
+    if (content.includes('bunx oxlint') && /bunx\s+oxlint[^\n]*--fix/u.test(content)) {
+      fail('lint-js.yml: у CI не використовуй oxlint --fix (лише bunx oxlint)')
     }
-    if (content.includes('jscpd')) {
-      pass('lint-js.yml містить jscpd')
-    } else {
-      fail('lint-js.yml не містить jscpd — додай крок bunx jscpd .')
+    if (content.includes('eslint --fix')) {
+      fail('lint-js.yml: у CI не використовуй eslint --fix (лише bunx eslint .)')
     }
   } else {
-    fail('.github/workflows/lint-js.yml не існує — створи його')
+    fail('.github/workflows/lint-js.yml не існує — створи його (див. check-js-lint.mjs / js-lint.mdc)')
+  }
+
+  if (existsSync('.github/workflows/lint.yml')) {
+    const lintYml = await readFile('.github/workflows/lint.yml', 'utf8')
+    const looksLikeJsLint =
+      /\bbunx\s+oxlint\b/u.test(lintYml) && /\bbunx\s+eslint\b/u.test(lintYml) && /\bjscpd\b/u.test(lintYml)
+    if (looksLikeJsLint) {
+      fail('.github/workflows/lint.yml дублює кроки lint-js.yml — залиш один workflow на лінт JS (js-lint.mdc)')
+    } else {
+      pass('.github/workflows/lint.yml не дублює oxlint/eslint/jscpd з lint-js.yml')
+    }
   }
 
   if (existsSync('.jscpd.json')) {
@@ -131,13 +210,25 @@ export async function check() {
       } else {
         fail('.jscpd.json має містити "exitCode": 1 (інакше CI не впаде на клонах)')
       }
+      const reporters = jscpdCfg.reporters
+      if (Array.isArray(reporters) && reporters.includes('console')) {
+        pass('.jscpd.json: reporters містить console')
+      } else {
+        fail('.jscpd.json має містити "reporters": ["console"] (або масив із "console")')
+      }
+      const minLines = jscpdCfg.minLines
+      if (typeof minLines === 'number' && minLines >= 25) {
+        pass(`.jscpd.json: minLines ${minLines} (>=25)`)
+      } else {
+        fail('.jscpd.json має містити "minLines" як число >= 25')
+      }
     }
   } else {
-    fail('.jscpd.json не існує — створи з gitignore, exitCode та reporters згідно js-lint.mdc')
+    fail('.jscpd.json не існує — створи з полями згідно check js-lint')
   }
 
   for (const dup of ['.eslintrc', '.eslintrc.js', '.eslintrc.json', '.eslintrc.yml']) {
-    if (existsSync(dup)) fail(`Знайдено застарілий конфіг ESLint: ${dup} — видали, використовуй eslint.config.js`)
+    if (existsSync(dup)) fail(`Знайдено застарілий конфіг ESLint: ${dup} — видали, використовуй flat config`)
   }
 
   return exitCode

package/scripts/check-k8s.mjs

@@ -207,17 +207,19 @@ function extractApiVersionAndKind(doc) {
 
 /**
  * Чи порушує маніфест вимогу **`Deployment.spec.template.spec.containers[].resources`** (див. k8s.mdc).
- * @param {unknown} manifest корінь розпарсеного YAML-документа
+ * @param {unknown} manifest корінь YAML-документа як об'єкт JavaScript
  * @returns {string | null} текст порушення для `fail` або null, якщо перевірка не застосовується / ок
  */
 export function deploymentResourcesViolation(manifest) {
-  if (manifest === null || manifest === undefined || typeof manifest !== 'object' || Array.isArray(manifest)) return null
+  if (manifest === null || manifest === undefined || typeof manifest !== 'object' || Array.isArray(manifest))
+    return null
   const rec = /** @type {Record<string, unknown>} */ (manifest)
   if (rec.kind !== 'Deployment') return null
   const spec = rec.spec
   if (spec === null || spec === undefined || typeof spec !== 'object' || Array.isArray(spec)) return null
   const template = /** @type {Record<string, unknown>} */ (spec).template
-  if (template === null || template === undefined || typeof template !== 'object' || Array.isArray(template)) return null
+  if (template === null || template === undefined || typeof template !== 'object' || Array.isArray(template))
+    return null
   const podSpec = /** @type {Record<string, unknown>} */ (template).spec
   if (podSpec === null || podSpec === undefined || typeof podSpec !== 'object' || Array.isArray(podSpec)) return null
   const containers = /** @type {Record<string, unknown>} */ (podSpec).containers

package/scripts/check-nginx-default-tpl.mjs

@@ -143,10 +143,11 @@ export function nginxTemplateViolations(content) {
     if (!ok(content)) return msg
   }
 
+  // cspell:ignore fastcgi uwsgi
   const proxyLike =
     /\b(proxy_pass|proxy_redirect|proxy_set_header|proxy_http_version|fastcgi_pass|grpc_pass|uwsgi_pass)\b/u
   if (proxyLike.test(content)) {
-    return 'знайдено proxy/fastcgi/grpc — прибери з шаблону, логіку винеси в HTTPRoute (k8s) (див. nginx-default-tpl.mdc)'
+    return 'знайдено proxy, gRPC або інший *_pass до бекенду — прибери з шаблону, логіку винеси в HTTPRoute (k8s) (див. nginx-default-tpl.mdc)'
   }
 
   return null
@@ -158,7 +159,8 @@ export function nginxTemplateViolations(content) {
  * @returns {boolean} true, якщо структура збігається з прикладом у nginx-default-tpl.mdc
  */
 export function httpRouteMatchesNginxDefaultTpl(manifest) {
-  if (manifest === null || manifest === undefined || typeof manifest !== 'object' || Array.isArray(manifest)) return false
+  if (manifest === null || manifest === undefined || typeof manifest !== 'object' || Array.isArray(manifest))
+    return false
   const m = /** @type {Record<string, unknown>} */ (manifest)
   if (m.kind !== 'HTTPRoute') return false
   const spec = m.spec
@@ -226,7 +228,7 @@ export function httpRouteMatchesNginxDefaultTpl(manifest) {
 export function iniKeysMissingInTemplate(keys, template) {
   for (const k of keys) {
     if (!template.includes(`$${k}`)) {
-      return `змінна "${k}" з *.ini не використовується в шаблоні — вилучи її з ini або додай плейсхолдер $${k} (див. nginx-default-tpl.mdc)`
+      return `змінна "${k}" з *.ini не використовується в шаблоні — вилучи її з ini або додай у шаблон $${k} (див. nginx-default-tpl.mdc)`
     }
   }
   return null