@nitra/cursor 1.3.6 → 1.4.1

package/mdc/js-format.mdc

@@ -97,3 +97,7 @@ version: '1.3'
 Також потрібно прибрати якщо є в проекті модул @nitra/prettier-config та prettier та всі виклики prettier і налаштування для нього.
 
 Завжди пиши JSDoc до функцій та методів.
+
+## Перевірка
+
+`npx @nitra/cursor check js-format`

package/mdc/js-lint.mdc

@@ -85,7 +85,7 @@ jobs:
           bunx eslint .
 ```
 
-**Без дублювання CI:** якщо в `.github/workflows` уже є `lint.yml` з тими самими кроками `oxlint` або `eslint`,  видали зайвий workflow — лінт JS має виконуватися в одному місці.
+**Без дублювання CI:** якщо в `.github/workflows` уже є `lint.yml` з тими самими кроками `oxlint` або `eslint`,  видали зайвий workflow, а саме `lint.yml` — лінт JS має виконуватися в одному місці.
 
 У корені проєкту має бути `eslint.config.js` із розподілом директорій за типом коду:
 
@@ -100,3 +100,21 @@ export default [
 ```
 
 У монорепо пакети з Vite (frontend) вкажи в секції `vue`, решту — у секції `node` у виклику `getConfig`.
+
+## Додаткові js правила
+
+Завжди додавай до package.json що підтримується 24+ версія node:
+
+```json title="package.json"
+"engines": {
+  "node": ">=24"
+}
+```
+
+Завжди код повинен використовувати синтаксис 24+ версії node
+
+Завжди повинен використовуватися top level await
+
+## Перевірка
+
+`npx @nitra/cursor check js-lint`

package/mdc/js-pino.mdc

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

package/mdc/nginx-default-tpl.mdc

@@ -138,3 +138,7 @@ RUN NAMES=$(sed -nE '/^\s*[#;]/d; /^\s*$/d; s/^\s*([A-Za-z_][A-Za-z0-9_]*)\s*=.*
   }
 }
 ```
+
+## Перевірка
+
+`npx @nitra/cursor check nginx-default-tpl`

package/mdc/npm-module.mdc

@@ -12,3 +12,7 @@ version: '1.0'
 - demo/ - опціонально демо проект
 - npm/ - файли для npm модуля
 - package.json
+
+## Перевірка
+
+`npx @nitra/cursor check npm-module`

package/mdc/spell.mdc

@@ -1,14 +1,88 @@
 ---
 description: Перевірка правопису в текстових файлах
 alwaysApply: true
-version: '1.1'
+version: '1.3'
 ---
 
-У корені проекту має бути `.cspell.json` і залежності для cspell у кореневому `package.json` (зазвичай `devDependencies`).
+У корені проєкту має бути `.cspell.json` і залежності для cspell у кореневому `package.json` (зазвичай `devDependencies`).
+
+У кореневому `package.json` додай скрипт CLI **cspell** (об’єднай з блоками з розділів нижче в одному файлі):
+
+```json title="package.json"
+  "scripts": {
+    "lint-spell": "npx cspell ."
+  }
+```
+
+Додай workflow `.github/workflows/lint-spell.yml`:
+
+```yaml
+name: Lint Spell
+
+on:
+  push:
+    branches:
+      - dev
+    paths:
+      - '.cspell.json'
+      - '**/*.js'
+      - '**/*.ts'
+      - '**/*.vue'
+      - '**/*.html'
+      - '**/*.css'
+      - '**/*.scss'
+      - '**/*.less'
+      - '**/*.json'
+      - '**/*.jsonc'
+      - '**/*.yaml'
+      - '**/*.yml'
+      - '**/*.toml'
+      - '**/*.xml'
+      - '**/*.md'
+      - '**/*.mdс'
+      - '**/*.txt'
+      - '**/*.go'
+      - '**/*.py'
+      - '**/*.php'
+
+  pull_request:
+    branches:
+      - dev
+
+concurrency:
+  group: ${{ github.ref }}-${{ github.workflow }}
+  cancel-in-progress: true
+
+jobs:
+  cspell:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: oven-sh/setup-bun@v2
+
+      - name: Cache Bun dependencies
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.bun/install/cache
+            node_modules
+          key: ${{ runner.os }}-bun-${{ hashFiles('**/bun.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-bun-
+
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Cspell
+        run: bun run lint-spell
+```
+
+**Без дублювання CI:** якщо в `.github/workflows` уже є workflow з тими самими кроками `cspell`, видали зайвий — перевірка правопису має виконуватися в одному місці.
 
 ## Базовий варіант (без окремого словника української)
 
-Якщо текст переважно англійською та достатньо словника nitra:
+Якщо текст переважно англійською та достатньо корпоративного словника (@nitra/cspell-dict; у полі `language` cspell лишається тег `nitra`):
 
 ```json title=".cspell.json"
 {
@@ -22,6 +96,9 @@ version: '1.1'
 
 ```json title="package.json"
 {
+  "scripts": {
+    "lint-spell": "npx cspell ."
+  },
   "devDependencies": {
     "@nitra/cspell-dict": "^1.0.185"
   }
@@ -36,6 +113,9 @@ version: '1.1'
 
 ```json title="package.json"
 {
+  "scripts": {
+    "lint-spell": "npx cspell ."
+  },
   "devDependencies": {
     "@nitra/cspell-dict": "^1.0.185",
     "@cspell/dict-uk-ua": "^4.0.6"
@@ -69,3 +149,7 @@ version: '1.1'
 ## Інші мови
 
 Для іншої мови встанови відповідний пакет `@cspell/dict-*`, додай його `cspell-ext.json` у `import` і код мови в `language`. Огляд словників: [streetsidesoftware/cspell-dicts](https://github.com/streetsidesoftware/cspell-dicts).
+
+## Перевірка
+
+`npx @nitra/cursor check spell`

package/mdc/style-lint.mdc

@@ -1,9 +1,16 @@
 ---
 description: Правила стилів CSS та SCSS
 alwaysApply: true
-version: '1.0'
+version: '1.1'
 ---
 
+## Генерація та редагування стилів (Cursor і інші агенти)
+
+- **Джерело правил:** перед тим як писати або суттєво змінювати **`.css`**, **`.scss`** або стилі в **`.vue`**, переглянь у корені проєкту (і в релевантних пакетах монорепо, якщо є) поле **`stylelint`** у **`package.json`** (зокрема `extends`), наявні **`.stylelintrc.*`**, **`stylelint.config.*`** та **`.stylelintignore`**. Не покладайся на «типові» правила stylelint з пам’яті — дотримуйся **проєктного** **`@nitra/stylelint-config`** і будь-яких локальних доповнень у репозиторії.
+- **Форматування** узгоджуй з **`n-js-format.mdc`** (oxfmt / `.oxfmtrc.json` для css, scss тощо), щоб форматер і stylelint не суперечили один одному.
+- **Після змін:** запускай **`bun run lint-style`** (або `bunx stylelint` з тими ж glob-ами та прапорцями, що в скрипті та CI) і виправляй усе, що лишилось після auto-fix. Якщо в репозиторії є **`n-lint`** / навичка n-lint — можна пройтись повним набором `lint-*` з `package.json`.
+- **Не розширюй винятки:** не додавай зайві **`stylelint-disable`** / вузькі придушення правил без потреби; краще змінити стилі під правила проєкту.
+
 В файлі .vscode/extensions.json є налаштування для офіційного плагіну:
 
 ```json title=".vscode/extensions.json"
@@ -89,3 +96,7 @@ jobs:
 ```text title=".stylelintignore"
 dist/
 ```
+
+## Перевірка
+
+`npx @nitra/cursor check style-lint`

package/mdc/vue.mdc

@@ -218,3 +218,7 @@ export default defineConfig({
 Потрібно використовувати unplugin-auto-import для автоматичного імпортування компонентів, composables, utils та інших функцій і прибирати з Vue sfc імпорти які їх дублюють.
 
 Потрібно використовувати vite-plugin-vue-layouts-next для автоматичного імпортування layout компонентів.
+
+## Перевірка
+
+`npx @nitra/cursor check vue`

package/package.json

@@ -1,30 +1,32 @@
 {
   "name": "@nitra/cursor",
-  "version": "1.3.6",
-  "description": "CLI для завантаження cursor-правил Nitra у локальний репозиторій",
+  "version": "1.4.1",
+  "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",
     "cursor",
     "cursor-rules",
     "mdc",
-    "nitra"
+    "n"
   ],
-  "homepage": "https://github.com/nitra/cursor#readme",
+  "homepage": "https://github.com/n/cursor#readme",
   "bugs": {
-    "url": "https://github.com/nitra/cursor/issues"
+    "url": "https://github.com/n/cursor/issues"
   },
   "license": "ISC",
   "author": "v@nitra.ai",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/nitra/cursor.git"
+    "url": "git+https://github.com/n/cursor.git"
   },
   "bin": {
-    "nitra-cursor": "./bin/nitra-cursor.js"
+    "n-cursor": "./bin/n-cursor.js"
   },
   "files": [
     "mdc",
     "bin",
+    "scripts",
+    "skills",
     "AGENTS.template.md"
   ],
   "type": "module",

package/scripts/check-bun.mjs

@@ -0,0 +1,32 @@
+import { existsSync } from 'node:fs'
+import { readFile } from 'node:fs/promises'
+
+/**
+ * Перевіряє відповідність проєкту правилам bun.mdc
+ * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
+ */
+export async function check() {
+  let exitCode = 0
+  const pass = msg => console.log(`  ✅ ${msg}`)
+  const fail = msg => {
+    console.log(`  ❌ ${msg}`)
+    exitCode = 1
+  }
+
+  const forbidden = ['package-lock.json', 'yarn.lock', 'pnpm-lock.yaml', '.yarnrc.yml']
+  for (const f of forbidden) {
+    existsSync(f) ? fail(`Знайдено заборонений файл: ${f} — видали його`) : pass(`Немає ${f}`)
+  }
+
+  existsSync('.yarn') ? fail('Знайдено директорію .yarn — видали її') : pass('Немає .yarn/')
+  existsSync('bun.lock') ? pass('bun.lock є') : fail('Відсутній bun.lock — запусти bun i')
+
+  if (existsSync('package.json')) {
+    const pkg = JSON.parse(await readFile('package.json', 'utf8'))
+    pkg.packageManager
+      ? fail(`package.json містить поле packageManager: "${pkg.packageManager}" — видали його`)
+      : pass('package.json не містить packageManager')
+  }
+
+  return exitCode
+}

package/scripts/check-ga.mjs

@@ -0,0 +1,60 @@
+import { existsSync } from 'node:fs'
+import { readdir, readFile } from 'node:fs/promises'
+
+/**
+ * Перевіряє відповідність проєкту правилам ga.mdc
+ * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
+ */
+export async function check() {
+  let exitCode = 0
+  const pass = msg => console.log(`  ✅ ${msg}`)
+  const fail = msg => {
+    console.log(`  ❌ ${msg}`)
+    exitCode = 1
+  }
+
+  const wfDir = '.github/workflows'
+
+  if (!existsSync(wfDir)) {
+    fail(`Директорія ${wfDir} не існує`)
+    return exitCode
+  }
+
+  const files = await readdir(wfDir)
+
+  const yamlFiles = files.filter(f => f.endsWith('.yaml'))
+  if (yamlFiles.length > 0) {
+    for (const f of yamlFiles) fail(`Workflow з розширенням .yaml: ${wfDir}/${f} — перейменуй на .yml`)
+  } else {
+    pass('Всі workflows мають розширення .yml')
+  }
+
+  for (const f of ['clean-ga-workflows.yml', 'clean-merged-branch.yml']) {
+    files.includes(f) ? pass(`${f} існує`) : fail(`Відсутній ${wfDir}/${f}`)
+  }
+
+  if (files.includes('apply-k8s.yml')) {
+    const content = await readFile(`${wfDir}/apply-k8s.yml`, 'utf8')
+    content.includes('**/k8s/*.yaml')
+      ? pass('apply-k8s.yml має правильний paths trigger')
+      : fail('apply-k8s.yml не містить paths: **/k8s/*.yaml')
+  }
+
+  if (files.includes('apply-nats-consumer.yml')) {
+    const content = await readFile(`${wfDir}/apply-nats-consumer.yml`, 'utf8')
+    content.includes('**/consumer.yaml')
+      ? pass('apply-nats-consumer.yml має правильний paths trigger')
+      : fail('apply-nats-consumer.yml не містить paths: **/consumer.yaml')
+  }
+
+  if (existsSync('.vscode/extensions.json')) {
+    const ext = JSON.parse(await readFile('.vscode/extensions.json', 'utf8'))
+    ext.recommendations?.includes('github.vscode-github-actions')
+      ? pass('extensions.json містить github.vscode-github-actions')
+      : fail('extensions.json не містить github.vscode-github-actions')
+  } else {
+    fail('.vscode/extensions.json не існує')
+  }
+
+  return exitCode
+}

package/scripts/check-js-format.mjs

@@ -0,0 +1,80 @@
+import { existsSync } from 'node:fs'
+import { readFile } from 'node:fs/promises'
+
+/**
+ * Перевіряє відповідність проєкту правилам js-format.mdc
+ * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
+ */
+export async function check() {
+  let exitCode = 0
+  const pass = msg => console.log(`  ✅ ${msg}`)
+  const fail = msg => {
+    console.log(`  ❌ ${msg}`)
+    exitCode = 1
+  }
+
+  const expectedKeys = [
+    'arrowParens', 'printWidth', 'bracketSpacing', 'bracketSameLine',
+    'semi', 'singleQuote', 'tabWidth', 'trailingComma', 'useTabs'
+  ]
+
+  if (existsSync('.oxfmtrc.json')) {
+    const cfg = JSON.parse(await readFile('.oxfmtrc.json', 'utf8'))
+    const missing = expectedKeys.filter(k => !(k in cfg))
+    missing.length === 0
+      ? pass('.oxfmtrc.json містить всі обовʼязкові ключі')
+      : fail(`.oxfmtrc.json відсутні ключі: ${missing.join(', ')}`)
+
+    if (cfg.semi !== false) fail('.oxfmtrc.json: semi має бути false')
+    if (cfg.singleQuote !== true) fail('.oxfmtrc.json: singleQuote має бути true')
+    if (cfg.tabWidth !== 2) fail('.oxfmtrc.json: tabWidth має бути 2')
+    if (cfg.useTabs !== false) fail('.oxfmtrc.json: useTabs має бути false')
+    if (cfg.printWidth !== 120) fail('.oxfmtrc.json: printWidth має бути 120')
+  } else {
+    fail('.oxfmtrc.json не існує — створи його')
+  }
+
+  if (existsSync('.vscode/extensions.json')) {
+    const ext = JSON.parse(await readFile('.vscode/extensions.json', 'utf8'))
+    ext.recommendations?.includes('oxc.oxc-vscode')
+      ? pass('extensions.json містить oxc.oxc-vscode')
+      : fail('extensions.json не містить oxc.oxc-vscode')
+  } else {
+    fail('.vscode/extensions.json не існує')
+  }
+
+  if (existsSync('.vscode/settings.json')) {
+    const settings = JSON.parse(await readFile('.vscode/settings.json', 'utf8'))
+    settings['editor.formatOnSave'] === true
+      ? pass('settings.json: editor.formatOnSave увімкнено')
+      : fail('settings.json: editor.formatOnSave має бути true')
+
+    const fmtTypes = ['javascript', 'typescript', 'json', 'vue', 'css', 'html']
+    for (const t of fmtTypes) {
+      const key = `[${t}]`
+      if (settings[key]?.['editor.defaultFormatter'] === 'oxc.oxc-vscode') {
+        pass(`settings.json: ${key} використовує oxc.oxc-vscode`)
+      } else {
+        fail(`settings.json: ${key} має використовувати oxc.oxc-vscode як defaultFormatter`)
+      }
+    }
+  } else {
+    fail('.vscode/settings.json не існує')
+  }
+
+  const prettierFiles = ['.prettierrc', '.prettierrc.json', '.prettierrc.js', 'prettier.config.js', '.prettierrc.yml']
+  for (const f of prettierFiles) {
+    if (existsSync(f)) fail(`Знайдено конфіг prettier: ${f} — видали його`)
+  }
+
+  if (existsSync('package.json')) {
+    const pkg = JSON.parse(await readFile('package.json', 'utf8'))
+    const allDeps = { ...pkg.dependencies, ...pkg.devDependencies }
+    for (const dep of ['prettier', '@nitra/prettier-config']) {
+      if (allDeps[dep]) fail(`package.json містить залежність ${dep} — видали її`)
+    }
+    if (pkg.prettier) fail('package.json містить поле "prettier" — видали його')
+  }
+
+  return exitCode
+}

package/scripts/check-js-lint.mjs

@@ -0,0 +1,60 @@
+import { existsSync } from 'node:fs'
+import { readFile } from 'node:fs/promises'
+
+/**
+ * Перевіряє відповідність проєкту правилам js-lint.mdc
+ * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
+ */
+export async function check() {
+  let exitCode = 0
+  const pass = msg => console.log(`  ✅ ${msg}`)
+  const fail = msg => {
+    console.log(`  ❌ ${msg}`)
+    exitCode = 1
+  }
+
+  existsSync('eslint.config.js')
+    ? pass('eslint.config.js існує')
+    : existsSync('eslint.config.mjs')
+      ? pass('eslint.config.mjs існує')
+      : fail('Відсутній eslint.config.js — створи його з getConfig від @nitra/eslint-config')
+
+  if (existsSync('package.json')) {
+    const pkg = JSON.parse(await readFile('package.json', 'utf8'))
+
+    pkg.scripts?.['lint-js']
+      ? pass('package.json містить скрипт lint-js')
+      : fail('package.json не містить скрипт "lint-js" — додай: "oxlint --fix && bunx eslint --fix ."')
+
+    pkg.devDependencies?.['@nitra/eslint-config']
+      ? pass('@nitra/eslint-config є в devDependencies')
+      : fail('@nitra/eslint-config відсутній в devDependencies — додай: bun add -d @nitra/eslint-config')
+
+    const nodeEngine = pkg.engines?.node
+    if (nodeEngine) {
+      const match = nodeEngine.match(/(\d+)/)
+      if (match && Number(match[1]) >= 24) {
+        pass(`engines.node: "${nodeEngine}"`)
+      } else {
+        fail(`engines.node: "${nodeEngine}" — має бути >=24`)
+      }
+    } else {
+      fail('package.json не містить engines.node — додай: "engines": { "node": ">=24" }')
+    }
+  }
+
+  if (existsSync('.github/workflows/lint-js.yml')) {
+    const content = await readFile('.github/workflows/lint-js.yml', 'utf8')
+    pass('lint-js.yml існує')
+    content.includes('oxlint') ? pass('lint-js.yml містить oxlint') : fail('lint-js.yml не містить oxlint')
+    content.includes('eslint') ? pass('lint-js.yml містить eslint') : fail('lint-js.yml не містить eslint')
+  } else {
+    fail('.github/workflows/lint-js.yml не існує — створи його')
+  }
+
+  for (const dup of ['.eslintrc', '.eslintrc.js', '.eslintrc.json', '.eslintrc.yml']) {
+    if (existsSync(dup)) fail(`Знайдено застарілий конфіг ESLint: ${dup} — видали, використовуй eslint.config.js`)
+  }
+
+  return exitCode
+}

package/scripts/check-js-pino.mjs

@@ -0,0 +1,39 @@
+import { existsSync } from 'node:fs'
+import { readFile } from 'node:fs/promises'
+
+/**
+ * Перевіряє відповідність проєкту правилам js-pino.mdc
+ * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
+ */
+export async function check() {
+  let exitCode = 0
+  const pass = msg => console.log(`  ✅ ${msg}`)
+  const fail = msg => {
+    console.log(`  ❌ ${msg}`)
+    exitCode = 1
+  }
+
+  if (existsSync('package.json')) {
+    const pkg = JSON.parse(await readFile('package.json', 'utf8'))
+    const allDeps = { ...pkg.dependencies, ...pkg.devDependencies }
+
+    if (allDeps['@nitra/bunyan']) fail('@nitra/bunyan знайдено — замінити на @nitra/pino')
+    if (allDeps.bunyan) fail('bunyan знайдено — замінити на @nitra/pino')
+  }
+
+  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')
+    }
+  }
+
+  return exitCode
+}

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

@@ -0,0 +1,59 @@
+import { existsSync } from 'node:fs'
+import { readFile } from 'node:fs/promises'
+
+/**
+ * Перевіряє відповідність проєкту правилам nginx-default-tpl.mdc
+ * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
+ */
+export async function check() {
+  let exitCode = 0
+  const pass = msg => console.log(`  ✅ ${msg}`)
+  const fail = msg => {
+    console.log(`  ❌ ${msg}`)
+    exitCode = 1
+  }
+
+  if (existsSync('default.tpl.conf')) {
+    fail('default.tpl.conf існує — перейменуй на default.conf.template')
+  }
+
+  const tplLocations = ['default.conf.template', 'nginx/default.conf.template', 'docker/default.conf.template']
+  const found = tplLocations.find(f => existsSync(f))
+
+  if (found) {
+    pass(`${found} існує`)
+    const content = await readFile(found, 'utf8')
+
+    content.includes('listen 8080')
+      ? pass('Nginx слухає порт 8080')
+      : fail(`${found}: має містити listen 8080`)
+
+    content.includes('/healthz')
+      ? pass('Є location /healthz')
+      : fail(`${found}: відсутній location /healthz`)
+
+    content.includes('gzip_static on')
+      ? pass('gzip_static увімкнено')
+      : fail(`${found}: має містити gzip_static on`)
+
+    if (content.includes('proxy_pass')) {
+      fail(`${found} містить proxy_pass — перенеси проксі-логіку до HTTPRoute в k8s`)
+    }
+  }
+
+  if (existsSync('.vscode/extensions.json')) {
+    const ext = JSON.parse(await readFile('.vscode/extensions.json', 'utf8'))
+    ext.recommendations?.includes('ahmadalli.vscode-nginx-conf')
+      ? pass('extensions.json містить ahmadalli.vscode-nginx-conf')
+      : fail('extensions.json не містить ahmadalli.vscode-nginx-conf')
+  }
+
+  if (existsSync('.vscode/settings.json')) {
+    const s = JSON.parse(await readFile('.vscode/settings.json', 'utf8'))
+    s['[nginx]']?.['editor.defaultFormatter'] === 'ahmadalli.vscode-nginx-conf'
+      ? pass('settings.json: nginx formatter налаштовано')
+      : fail('settings.json: [nginx] defaultFormatter має бути ahmadalli.vscode-nginx-conf')
+  }
+
+  return exitCode
+}

package/scripts/check-npm-module.mjs

@@ -0,0 +1,44 @@
+import { existsSync } from 'node:fs'
+import { readFile, stat } from 'node:fs/promises'
+
+/**
+ * Перевіряє відповідність проєкту правилам npm-module.mdc
+ * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
+ */
+export async function check() {
+  let exitCode = 0
+  const pass = msg => console.log(`  ✅ ${msg}`)
+  const fail = msg => {
+    console.log(`  ❌ ${msg}`)
+    exitCode = 1
+  }
+
+  existsSync('package.json') ? pass('package.json існує') : fail('package.json не існує')
+
+  if (existsSync('npm')) {
+    const s = await stat('npm')
+    s.isDirectory() ? pass('npm/ директорія існує') : fail('npm має бути директорією')
+  } else {
+    fail('npm/ директорія не існує')
+  }
+
+  if (existsSync('package.json')) {
+    const pkg = JSON.parse(await readFile('package.json', 'utf8'))
+    const ws = pkg.workspaces
+    if (Array.isArray(ws) && ws.includes('npm')) {
+      pass('package.json workspaces містить "npm"')
+    } else {
+      fail('package.json workspaces має містити "npm"')
+    }
+  }
+
+  existsSync('npm/package.json')
+    ? pass('npm/package.json існує')
+    : fail('npm/package.json не існує — створи package.json для npm модуля')
+
+  existsSync('.github/workflows')
+    ? pass('.github/workflows/ існує')
+    : fail('.github/workflows/ не існує')
+
+  return exitCode
+}