@nitra/cursor 1.8.83 → 1.8.85

package/README.md

@@ -6,7 +6,7 @@
 
 Репозиторій `@nitra/cursor` містить cursor-правила у директорії `mdc/`. CLI копіює обрані правила з **каталогу `mdc/` того пакету, з якого виконується `bin/n-cursor.js`**: після `npm i` / `bun add` це зазвичай `node_modules/@nitra/cursor/mdc`; при **`npx @nitra/cursor`** пакет потрапляє в **кеш npx/npm**, і правила читаються з тієї розпакованої копії (у корені проєкту залежність не обов’язкова). Жодних окремих HTTP-запитів до CDN для файлів правил немає — лише те, що вже є в tarball пакету.
 
-Наприклад, правило `mdc/js-format.mdc` буде збережено як `.cursor/rules/n-js-format.mdc`.
+Наприклад, правило `mdc/text.mdc` буде збережено як `.cursor/rules/n-text.mdc`.
 
 ## Підготовка
 
@@ -15,19 +15,18 @@
 ```json
 {
   "$schema": "https://unpkg.com/@nitra/cursor/schemas/n-cursor.json",
-  "rules": ["js-format", "npm-module", "text"],
+  "rules": ["npm-module", "text"],
   "skills": ["fix"]
 }
 ```
 
 Доступні правила:
 
-| Назва        | Опис                                              |
-| ------------ | ------------------------------------------------- |
-| `js-format`  | Правила форматування JavaScript ecosystem (oxfmt) |
-| `npm-module` | Структура репозиторію для npm-модуля (bun mono)   |
-| `text`       | Текстові файли: cspell, CI                        |
-| `k8s`        | Kubernetes YAML, Kustomize, kubeconform           |
+| Назва        | Опис                                            |
+| ------------ | ----------------------------------------------- |
+| `npm-module` | Структура репозиторію для npm-модуля (bun mono) |
+| `text`       | Текст, oxfmt, cspell, markdownlint, v8r, CI     |
+| `k8s`        | Kubernetes YAML, Kustomize, kubeconform         |
 
 Щоб використовувати конкретну версію правил, оновіть залежність `@nitra/cursor` у проєкті (`bun add -d @nitra/cursor@<версія>` тощо). Поле `version` у `.n-cursor.json`, якщо воно лишилось у старих конфігах, **ігнорується**.
 
@@ -71,13 +70,12 @@ CLI автоматично (команда завантаження правил
 ```
 🔧 @nitra/cursor — завантаження cursor-правил
 
-📋 Правил до завантаження: 3
-  ⬇  js-format → .cursor/rules/n-js-format.mdc ... ✅
+📋 Правил до завантаження: 2
   ⬇  npm-module → .cursor/rules/n-npm-module.mdc ... ✅
   ⬇  text → .cursor/rules/n-text.mdc ... ✅
 📝 Оновлено AGENTS.md з AGENTS.template.md
 
-✨ Готово: 3 завантажено, 0 з помилками
+✨ Готово: 2 завантажено, 0 з помилками
 ```
 
 ## Структура пакету
@@ -86,7 +84,6 @@ CLI автоматично (команда завантаження правил
 npm/
 ├── AGENTS.template.md   # шаблон AGENTS.md для цільових репозиторіїв (потрапляє в npm-архів)
 ├── mdc/                 # cursor-правила (без префікса n-; після синку — .cursor/rules/n-<id>.mdc)
-│   ├── js-format.mdc
 │   ├── npm-module.mdc
 │   └── text.mdc
 ├── skills/              # skills (каталоги <id>/; після синку — .cursor/skills/n-<id>/)

package/bin/n-cursor.js

@@ -204,8 +204,8 @@ async function readConfig(paths = {}) {
 
 /**
  * Витягує чисте ім'я файлу правила (без шляху, але зберігає .mdc)
- * "npm/mdc/js-format.mdc" → "js-format.mdc"
- * "js-format"              → "js-format.mdc"
+ * "npm/mdc/text.mdc" → "text.mdc"
+ * "text"             → "text.mdc"
  * @param {string} ruleName шлях або базове ім'я, з суфіксом .mdc або без
  * @returns {string} лише ім'я файлу з суфіксом .mdc
  */

package/mdc/k8s.mdc

@@ -15,6 +15,8 @@ alwaysApply: false
 
 Далі — вміст маніфесту. Зайвий порожній рядок між коментарем і YAML не додавай, якщо в проєкті не прийнято інше.
 
+**Виняток — без modeline:** `apiVersion: alb.yc.io/v1alpha1`, `kind: HttpBackendGroup` (Yandex ALB) — рядка **`# yaml-language-server: $schema=…`** у файлі **не** має бути (ні в першому рядку, ні далі). Перший рядок — одразу YAML (`apiVersion:` тощо). Перевірка — **`check-k8s.mjs`**.
+
 **Розширення:** усі маніфести під **`k8s`**, включно з **`kustomization.yaml`**, — лише **`.yaml`** (розширення **`.yml`** не використовуй).
 
 **Dockerfile / hadolint** — окреме правило **`docker.mdc`** і **`npx @nitra/cursor check docker`**.
@@ -106,6 +108,88 @@ resources: {}
 
 Образ **`hasura/graphql-engine`**: дозволений лише канонічний тег із константи **`HASURA_GRAPHQL_ENGINE_IMAGE`** у **`check-k8s.mjs`** (допускається префікс **`docker.io/`**); решта — помилка **check k8s**.
 
+### HTTPRoute для Deployment з `hasura/graphql-engine`
+
+Якщо для такого **Deployment** описано **`HTTPRoute`**, **`spec.rules`** мають відповідати канону нижче: редірект **`/ql`** та **`/ql/`** на **`/ql/console`** (**`302`**), правило з **`PathPrefix` `/ql`**, **`URLRewrite`** префікса на **`/`**, окреме правило для **WebSocket** (**`Upgrade: websocket`**) з **`RequestHeaderModifier`** (прибрати **`Authorization`** — авторизація для WebSocket іде всередині messages), далі **`PathPrefix` `/`** на той самий backend.
+
+**`parentRefs`**, **`hostnames`**, **`metadata.namespace`** / **`name`** підлаштуй під середовище. У **`backendRefs.name`** вказуй **headless** **Service** з суфіксом **`-hl`** (див. розділ **«Service: `svc.yaml` і `svc-hl.yaml`»**); у прикладі **`db-h-hl`** заміни на фактичне ім’я.
+
+```yaml
+# yaml-language-server: $schema=https://datreeio.github.io/CRDs-catalog/gateway.networking.k8s.io/httproute_v1beta1.json
+apiVersion: gateway.networking.k8s.io/v1beta1
+kind: HTTPRoute
+metadata:
+  name: db-h
+  namespace: dev
+spec:
+  parentRefs:
+    - name: gw
+      namespace: dev
+      sectionName: https
+  hostnames:
+    - abie.cloud
+  rules:
+    - matches:
+        - path:
+            type: Exact
+            value: /ql
+      filters:
+        - type: RequestRedirect
+          requestRedirect:
+            path:
+              type: ReplaceFullPath
+              replaceFullPath: /ql/console
+            statusCode: 302
+    - matches:
+        - path:
+            type: Exact
+            value: /ql/
+      filters:
+        - type: RequestRedirect
+          requestRedirect:
+            path:
+              type: ReplaceFullPath
+              replaceFullPath: /ql/console
+            statusCode: 302
+    - matches:
+        - path:
+            type: PathPrefix
+            value: /ql
+      filters:
+        - type: URLRewrite
+          urlRewrite:
+            path:
+              type: ReplacePrefixMatch
+              replacePrefixMatch: /
+      backendRefs:
+        - name: db-h-hl
+          port: 8080
+    # У WebSocket авторизація йде всередині messages
+    - matches:
+        - path:
+            type: PathPrefix
+            value: /
+          headers:
+            - type: Exact
+              name: Upgrade
+              value: websocket
+      filters:
+        - type: RequestHeaderModifier
+          requestHeaderModifier:
+            remove:
+              - Authorization
+      backendRefs:
+        - name: db-h-hl
+          port: 8080
+    - matches:
+        - path:
+            type: PathPrefix
+            value: /
+      backendRefs:
+        - name: db-h-hl
+          port: 8080
+```
+
 ## Service: заборонені анотації GKE
 
 У **`kind: Service`** не додавай у **`metadata.annotations`** **`cloud.google.com/neg`** і **`cloud.google.com/backend-config`** (legacy під Ingress / старе балансування GKE). **check k8s** падає, якщо ключ є.
@@ -224,7 +308,7 @@ patches:
 
 **`npx @nitra/cursor check k8s`** — програмні критерії в **JSDoc на початку** **`npm/scripts/check-k8s.mjs`**. Якщо під **`k8s`** немає **`*.yaml`** — крок пропущено. Канон **`$schema`** для редактора — розділ **«Визначення схеми YAML`** нижче.
 
-**Не входить у check k8s:** наприклад **ReferenceGrant** і доступ між **namespace** (лише рекомендації тут), **kubeconform** / **kubescape** — це **`bun run lint-k8s`**.
+**Не входить у check k8s:** наприклад **ReferenceGrant** і доступ між **namespace** (лише рекомендації тут), повна структура **`HTTPRoute`** для **Hasura** (канон — у розділі про **`hasura/graphql-engine`**), **kubeconform** / **kubescape** — це **`bun run lint-k8s`**.
 
 ## Коли застосовувати (агентам)
 

package/mdc/style-lint.mdc

@@ -7,7 +7,7 @@ version: '1.2'
 ## Генерація та редагування стилів (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 не суперечили один одному.
+- **Форматування** узгоджуй з **`n-text.mdc`** (oxfmt / `.oxfmtrc.json` для css, scss тощо), щоб форматер і stylelint не суперечили один одному.
 - **Запуск stylelint:** лише **`npx stylelint`**. Локально — через скрипт **`lint-style`** (`bun run lint-style`); у **GitHub Actions** у кроці **`run`** викликай `npx stylelint '**/*.{css,scss,vue}' --fix` напряму (не через **`bun run lint-style`**). Не використовуй **`bunx stylelint`**. Після змін запускай **`bun run lint-style`** і виправляй усе, що лишилось після auto-fix; за потреби — повний набір `lint-*` (навичка **`n-fix`**).
 - **Не розширюй винятки:** не додавай зайві **`stylelint-disable`** без потреби; краще підлаштувати стилі під правила проєкту.
 

package/mdc/text.mdc

@@ -1,10 +1,10 @@
 ---
-description: Обробка та перевірка текстових файлів (cspell, markdownlint-cli2, v8r, CI)
+description: Обробка та перевірка текстових файлів, oxfmt, cspell, markdownlint-cli2, v8r, CI
 alwaysApply: true
-version: '1.24'
+version: '1.25'
 ---
 
-**cspell**, **markdownlint-cli2**, **[v8r](https://chris48s.github.io/v8r/)** ([Schema Store](https://www.schemastore.org/)), розширення **DavidAnson.vscode-markdownlint**, workflow **`lint-text`**.
+**oxfmt** (`.oxfmtrc.json`, редактор), **cspell**, **markdownlint-cli2**, **[v8r](https://chris48s.github.io/v8r/)** ([Schema Store](https://www.schemastore.org/)), розширення **DavidAnson.vscode-markdownlint**, workflow **`lint-text`**.
 
 ```json title=".vscode/extensions.json"
 {
@@ -24,10 +24,92 @@ version: '1.24'
   "files.associations": {
     "*.env.*": "env",
     "*.env": "env"
-  }
+  },
+  "editor.formatOnSave": true,
+  "[css]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[graphql]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[handlebars]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[html]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[javascript]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[json]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[json5]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[jsonc]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[less]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[markdown]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[mdx]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[scss]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[toml]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[typescript]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[vue]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[yaml]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "oxc.path.oxfmt": "/opt/homebrew/bin/oxfmt"
 }
 ```
 
+У корені проєкту має бути файл з правилами форматування для **oxfmt**:
+
+```json title=".oxfmtrc.json"
+{
+  "ignorePatterns": ["**/hasura/metadata/**", "**/schema.graphql"],
+  "arrowParens": "avoid",
+  "printWidth": 120,
+  "bracketSpacing": true,
+  "bracketSameLine": true,
+  "embeddedLanguageFormatting": "auto",
+  "endOfLine": "lf",
+  "htmlWhitespaceSensitivity": "css",
+  "insertPragma": false,
+  "jsxSingleQuote": true,
+  "proseWrap": "preserve",
+  "quoteProps": "as-needed",
+  "requirePragma": false,
+  "semi": false,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "trailingComma": "none",
+  "useTabs": false,
+  "vueIndentScriptAndStyle": false
+}
+```
+
+Поле **`ignorePatterns`** додавай за потреби (наприклад згенеровані каталоги); якщо виключень немає — ключ можна опустити.
+
+Також потрібно прибрати, якщо є в проєкті, модуль **`@nitra/prettier-config`**, **prettier** та всі виклики prettier і налаштування для нього.
+
+Завжди пиши **JSDoc** до функцій та методів.
+
 **`package.json`:** скрипт **`lint-text`** і devDependencies **`@nitra/cspell-dict`**. Для української додай **`@cspell/dict-uk-ua`**. **`markdownlint-cli2`** викликай у `lint-text` лише через **`bunx markdownlint-cli2`**, не додавай пакет до devDependencies. **`v8r`** лише через **`bunx v8r`** (зазвичай **`bunx v8r`**), не в devDependencies. Окремий пакет **`markdownlint`** не потрібний.
 
 У v8r **немає** прапорця тихого режиму; рекомендовано скрипт **`run-v8r.mjs`** з репозиторію пакета `@nitra/cursor` (`npm/scripts/run-v8r.mjs`): один виклик у `lint-text` — під капотом послідовні **`bunx v8r`** для кожного типу (**json**, **json5**, **yml**, **yaml**, **toml**), бо один процес v8r з кількома глобами падає з **98**, якщо хоч один glob порожній, і тоді інші розширення не перевіряються. Вивід при кодах **0** і **98** не показується. Каталог схем **`schemas/v8r-catalog.json`** пакета `@nitra/cursor` скрипт підставляє в v8r сам. За бажання можна передати власні glob-и аргументами скрипта. Шлях до скрипта: `./npm/scripts/…`, `./scripts/…` після копіювання, або `node_modules/@nitra/cursor/scripts/…`.
@@ -215,4 +297,4 @@ jobs:
 
 ## Перевірка
 
-`npx @nitra/cursor check text`
+`npx @nitra/cursor check text` (охоплює oxfmt, cspell, markdownlint, v8r, CI для `lint-text`)

package/mdc/vue.mdc

@@ -108,7 +108,7 @@ const additionalInstructions = `
 
 ### Інструменти (узгоджено з Vite і цим правилом)
 
-- Якість коду: **ESLint** + **eslint-plugin-vue**; форматування — **oxfmt**, див. `js-format.mdc`.
+- Якість коду: **ESLint** + **eslint-plugin-vue**; форматування — **oxfmt**, див. `text.mdc`.
 - Збірка та dev-сервер — **Vite**
 - **Vue Devtools** для дебагу; продакшен-збірка — **`vite build`**, оптимізація асетів і кешування на рівні деплою / CDN.
 

package/package.json

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

package/scripts/check-abie.mjs

@@ -13,6 +13,7 @@
  * **k8s:** якщо під деревом із сегментом **`k8s`** є YAML з **`kind: Deployment`**, у тій самій директорії
  * має існувати **`hc.yaml`** із **`HealthCheckPolicy`** (**`networking.gke.io/v1`**), modeline **`$schema`**
  * як у abie.mdc, **`/healthz`**, порт **8080**, **`targetRef`** на **Service** з тим самим **`metadata.name`**.
+ * Загальні вимоги до **`# yaml-language-server: $schema`** для інших YAML під **`k8s`** — у **check-k8s.mjs** / **k8s.mdc** (наприклад **HttpBackendGroup** `alb.yc.io/v1alpha1` — **без** modeline).
  * Якщо в дереві **k8s** є **HealthCheckPolicy**, перевіряється **`ru/kustomization.yaml`** з patch **`$patch: delete`**
  * (логіка вмісту — **`ruKustomizationHasHealthCheckDeletePatch`** у **check-k8s.mjs**, узгоджено з **k8s.mdc**).
  *

package/scripts/check-k8s.mjs

@@ -3,6 +3,7 @@
  *
  * Перший рядок `# yaml-language-server: $schema=…`, без дублікатів, розширення `.yaml`
  * (окрім `kustomization.yaml`); URL схеми за першим документом — kustomization / yannh / datree
+ * (**виняток:** `apiVersion: alb.yc.io/v1alpha1`, `kind: HttpBackendGroup` — рядка `# yaml-language-server:` у файлі бути не має).
  * (datree за замовчуванням: GitHub Pages `https://datreeio.github.io/CRDs-catalog/…`).
  *
  * Додатково: у кожному YAML-документі з **`kind: Deployment`** у кожного контейнера
@@ -47,6 +48,8 @@
  * **`apiVersion`, `kind`, `type`** (для CRD без поля `type` у маніфесті — зірочка **`*`** як третій
  * компонент). Спочатку шукається збіг за фактичним `type`, потім за **`*`**.
  * Dockerfile — правило docker.mdc, скрипт check-docker.mjs.
+ *
+ * Структура **`HTTPRoute`** для **Deployment** з образом **`hasura/graphql-engine`** (редиректи **`/ql`**, **WebSocket**, **`URLRewrite`**) — лише в **k8s.mdc**, автоматично не звіряється.
  */
 import { existsSync } from 'node:fs'
 import { readFile, stat, unlink } from 'node:fs/promises'
@@ -669,6 +672,18 @@ function extractApiVersionAndKind(doc) {
   }
 }
 
+/**
+ * Чи перший YAML-документ (до `---`) — **HttpBackendGroup** з API **alb.yc.io/v1alpha1** (Yandex ALB).
+ * Для таких файлів **check-k8s** не вимагає modeline `# yaml-language-server: $schema=…` і забороняє його.
+ * @param {string} yamlBody вміст файлу або фрагмент після modeline
+ * @returns {boolean} true, якщо `apiVersion`/`kind` першого документа збігаються з винятком
+ */
+export function k8sYamlFirstDocIsAlbYcHttpBackendGroup(yamlBody) {
+  const first = firstYamlDocument(yamlBody)
+  const { apiVersion, kind } = extractApiVersionAndKind(first)
+  return apiVersion === 'alb.yc.io/v1alpha1' && kind === 'HttpBackendGroup'
+}
+
 /**
  * Чи вміст overlay **`ru/kustomization.yaml`** містить Kustomize patch видалення **HealthCheckPolicy**.
  * @param {string} raw повний текст файлу
@@ -1597,12 +1612,38 @@ async function checkK8sYamlFile(abs, root, fail, pass, kustomizeManagedRel) {
     return
   }
 
-  const m = lines[0].match(MODELINE_RE)
-  if (!m) {
+  const firstLineIsModeline = MODELINE_RE.test(lines[0])
+  const bodyForFirstDoc = k8sYamlBodyForDocumentParse(lines)
+  const isAlbHttpBackendGroup = k8sYamlFirstDocIsAlbYcHttpBackendGroup(bodyForFirstDoc)
+
+  if (isAlbHttpBackendGroup) {
+    if (firstLineIsModeline) {
+      fail(
+        `${rel}: для kind HttpBackendGroup (apiVersion alb.yc.io/v1alpha1) не задавай # yaml-language-server: $schema — прибери перший рядок modeline (k8s.mdc)`
+      )
+      return
+    }
+    if (countSchemaModelines(lines) > 0) {
+      fail(
+        `${rel}: для kind HttpBackendGroup (apiVersion alb.yc.io/v1alpha1) не використовуй # yaml-language-server: $schema у файлі (k8s.mdc)`
+      )
+      return
+    }
+    const body = lines.join('\n')
+    scanIngressInYamlDocuments(rel, body, fail)
+    pass(`${rel}: HttpBackendGroup (alb.yc.io/v1alpha1) — modeline $schema не застосовується (k8s.mdc)`)
+    const kustomizeManaged = kustomizeManagedRel.has(rel)
+    validateK8sYamlPolicyDocuments(rel, baseLower, body, fail, kustomizeManaged)
+    scanGatewayApiRouteBackendRefsInYamlBody(rel, body, fail)
+    return
+  }
+
+  if (!firstLineIsModeline) {
     fail(`${rel}: перший рядок має бути коментарем # yaml-language-server: $schema=<url> (без префіксів перед #)`)
     return
   }
 
+  const m = /** @type {RegExpMatchArray} */ (lines[0].match(MODELINE_RE))
   const schemaUrl = m[1]
   if (countSchemaModelines(lines) > 1) {
     fail(`${rel}: кілька рядків yaml-language-server $schema — лиш один modeline на файл (див. k8s.mdc)`)

package/scripts/check-text.mjs

@@ -1,10 +1,13 @@
 /**
- * Перевіряє текстовий стек за правилом text.mdc.
+ * Перевіряє текстовий стек і форматування за правилом text.mdc.
+ *
+ * oxfmt: `.oxfmtrc.json` з обовʼязковими ключами, VSCode (formatOnSave, defaultFormatter для js/ts/json/vue/css/html),
+ * відсутність Prettier у конфігах і залежностях.
  *
  * cspell, markdownlint через `bunx markdownlint-cli2` у `lint-text` (без оголошення пакета в package.json), заборона
  * `markdownlint-cli2` у dependencies/devDependencies, v8r (`run-v8r.mjs` або чотири `bunx v8r`),
  * `.v8rignore` (vscode JSON),
- * workflow `lint-text.yml`, розширення VSCode для markdownlint.
+ * workflow `lint-text.yml`, розширення VSCode (markdownlint, oxc).
  *
  * Якщо є `.cursor/rules/n-text.mdc` і/або `npm/mdc/text.mdc` — перевіряє наявність абзацу про український
  * апостроф (U+0027 vs U+2019) і приклад з символом U+2019 у тексті.
@@ -43,7 +46,7 @@ function verifyUkApostropheRuleParagraph(filePath, body, failFn, passFn) {
 }
 
 /**
- * Перевіряє відповідність проєкту правилам text.mdc (cspell, markdownlint через bunx, v8r)
+ * Перевіряє відповідність проєкту правилам text.mdc (oxfmt, cspell, markdownlint через bunx, v8r)
  * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
  */
 export async function check() {
@@ -79,6 +82,11 @@ export async function check() {
       } else {
         fail('extensions.json: додай "DavidAnson.vscode-markdownlint" у recommendations (див. n-text.mdc)')
       }
+      if (Array.isArray(rec) && rec.includes('oxc.oxc-vscode')) {
+        pass('extensions.json містить oxc.oxc-vscode')
+      } else {
+        fail('extensions.json: додай "oxc.oxc-vscode" у recommendations (див. n-text.mdc)')
+      }
     } catch {
       fail('.vscode/extensions.json — невалідний JSON')
     }
@@ -86,6 +94,63 @@ export async function check() {
     fail('.vscode/extensions.json не існує — створи з recommendations згідно n-text.mdc')
   }
 
+  if (existsSync('.vscode/settings.json')) {
+    try {
+      const settings = JSON.parse(await readFile('.vscode/settings.json', 'utf8'))
+      if (settings['editor.formatOnSave'] === true) {
+        pass('settings.json: editor.formatOnSave увімкнено')
+      } else {
+        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`)
+        }
+      }
+    } catch {
+      fail('.vscode/settings.json — невалідний JSON')
+    }
+  } else {
+    fail('.vscode/settings.json не існує — створи згідно n-text.mdc')
+  }
+
+  const expectedOxfmtKeys = [
+    'arrowParens',
+    'printWidth',
+    'bracketSpacing',
+    'bracketSameLine',
+    'semi',
+    'singleQuote',
+    'tabWidth',
+    'trailingComma',
+    'useTabs'
+  ]
+  if (existsSync('.oxfmtrc.json')) {
+    const cfg = JSON.parse(await readFile('.oxfmtrc.json', 'utf8'))
+    const missing = expectedOxfmtKeys.filter(k => !(k in cfg))
+    if (missing.length === 0) {
+      pass('.oxfmtrc.json містить всі обовʼязкові ключі')
+    } else {
+      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 не існує — створи його')
+  }
+
+  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('.markdownlint-cli2.jsonc')) {
     try {
       const ml = JSON.parse(await readFile('.markdownlint-cli2.jsonc', 'utf8'))
@@ -145,6 +210,12 @@ export async function check() {
 
   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" — видали його')
+
     const devDeps = pkg.devDependencies || {}
 
     if (devDeps['@nitra/cspell-dict']) {

package/mdc/js-format.mdc

@@ -1,103 +0,0 @@
----
-description: Правила форматів JavaScript ecosystem
-alwaysApply: true
-version: '1.3'
----
-
-В корені проекту є файл з правилами форматування для oxfmt:
-
-```json title=".oxfmtrc.json"
-{
-  "arrowParens": "avoid",
-  "printWidth": 120,
-  "bracketSpacing": true,
-  "bracketSameLine": true,
-  "embeddedLanguageFormatting": "auto",
-  "endOfLine": "lf",
-  "htmlWhitespaceSensitivity": "css",
-  "insertPragma": false,
-  "jsxSingleQuote": true,
-  "proseWrap": "preserve",
-  "quoteProps": "as-needed",
-  "requirePragma": false,
-  "semi": false,
-  "singleQuote": true,
-  "tabWidth": 2,
-  "trailingComma": "none",
-  "useTabs": false,
-  "vueIndentScriptAndStyle": false
-}
-```
-
-в файлі .vscode/extensions.json є налаштування для oxfmt:
-
-```json title=".vscode/extensions.json"
-{
-  "recommendations": ["oxc.oxc-vscode"]
-}
-```
-
-в файлі .vscode/settings.json є налаштування для oxfmt:
-
-```json title=".vscode/settings.json"
-{
-  "editor.formatOnSave": true,
-  "[css]": {
-    "editor.defaultFormatter": "oxc.oxc-vscode"
-  },
-  "[graphql]": {
-    "editor.defaultFormatter": "oxc.oxc-vscode"
-  },
-  "[handlebars]": {
-    "editor.defaultFormatter": "oxc.oxc-vscode"
-  },
-  "[html]": {
-    "editor.defaultFormatter": "oxc.oxc-vscode"
-  },
-  "[javascript]": {
-    "editor.defaultFormatter": "oxc.oxc-vscode"
-  },
-  "[json]": {
-    "editor.defaultFormatter": "oxc.oxc-vscode"
-  },
-  "[json5]": {
-    "editor.defaultFormatter": "oxc.oxc-vscode"
-  },
-  "[jsonc]": {
-    "editor.defaultFormatter": "oxc.oxc-vscode"
-  },
-  "[less]": {
-    "editor.defaultFormatter": "oxc.oxc-vscode"
-  },
-  "[markdown]": {
-    "editor.defaultFormatter": "oxc.oxc-vscode"
-  },
-  "[mdx]": {
-    "editor.defaultFormatter": "oxc.oxc-vscode"
-  },
-  "[scss]": {
-    "editor.defaultFormatter": "oxc.oxc-vscode"
-  },
-  "[toml]": {
-    "editor.defaultFormatter": "oxc.oxc-vscode"
-  },
-  "[typescript]": {
-    "editor.defaultFormatter": "oxc.oxc-vscode"
-  },
-  "[vue]": {
-    "editor.defaultFormatter": "oxc.oxc-vscode"
-  },
-  "[yaml]": {
-    "editor.defaultFormatter": "oxc.oxc-vscode"
-  },
-  "oxc.path.oxfmt": "/opt/homebrew/bin/oxfmt"
-}
-```
-
-Також потрібно прибрати якщо є в проекті модул @nitra/prettier-config та prettier та всі виклики prettier і налаштування для нього.
-
-Завжди пиши JSDoc до функцій та методів.
-
-## Перевірка
-
-`npx @nitra/cursor check js-format`

package/scripts/check-js-format.mjs

@@ -1,96 +0,0 @@
-/**
- * Перевіряє форматування коду за правилом js-format.mdc.
- *
- * `.oxfmtrc.json` з потрібними ключами, VSCode і oxfmt, відсутність Prettier у конфігах і залежностях.
- */
-import { existsSync } from 'node:fs'
-import { readFile } from 'node:fs/promises'
-
-import { createCheckReporter } from './utils/check-reporter.mjs'
-
-/**
- * Перевіряє відповідність проєкту правилам js-format.mdc
- * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
- */
-export async function check() {
-  const reporter = createCheckReporter()
-  const { pass, fail } = reporter
-
-  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))
-    if (missing.length === 0) {
-      pass('.oxfmtrc.json містить всі обовʼязкові ключі')
-    } else {
-      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'))
-    if (ext.recommendations?.includes('oxc.oxc-vscode')) {
-      pass('extensions.json містить oxc.oxc-vscode')
-    } else {
-      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'))
-    if (settings['editor.formatOnSave'] === true) {
-      pass('settings.json: editor.formatOnSave увімкнено')
-    } else {
-      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 reporter.getExitCode()
-}