@nitra/cursor 1.5.0 → 1.5.2

package/README.md

@@ -14,7 +14,7 @@
 
 ```json
 {
-  "rules": ["js-format", "npm-module", "spell"]
+  "rules": ["js-format", "npm-module", "text"]
 }
 ```
 
@@ -24,14 +24,14 @@
 | ------------ | ------------------------------------------------- |
 | `js-format`  | Правила форматування JavaScript ecosystem (oxfmt) |
 | `npm-module` | Структура репозиторію для npm-модуля (bun mono)   |
-| `spell`      | Перевірка правопису через cspell                  |
+| `text`       | Текстові файли: cspell, CI                        |
 
 Щоб завантажити правила конкретної версії пакету, додайте поле `version`:
 
 ```json
 {
   "version": "2.5.0",
-  "rules": ["js-format", "spell"]
+  "rules": ["js-format", "text"]
 }
 ```
 
@@ -56,7 +56,7 @@ CLI автоматично:
 📋 Правил до завантаження: 3
   ⬇  js-format → .cursor/rules/n-js-format.mdc ... ✅
   ⬇  npm-module → .cursor/rules/n-npm-module.mdc ... ✅
-  ⬇  spell → .cursor/rules/n-spell.mdc ... ✅
+  ⬇  text → .cursor/rules/n-text.mdc ... ✅
 📝 Оновлено AGENTS.md з AGENTS.template.md
 
 ✨ Готово: 3 завантажено, 0 з помилками
@@ -70,7 +70,7 @@ npm/
 ├── mdc/                 # cursor-правила
 │   ├── js-format.mdc
 │   ├── npm-module.mdc
-│   └── spell.mdc
+│   └── text.mdc
 └── bin/
     └── n-cursor.js  # CLI-скрипт
 ```
@@ -96,7 +96,7 @@ npm/
 {{/services}}
 ```
 
-Під час запуску CLI тіло між `{{#services}}` і `{{/services}}` повторюється для кожного `*.mdc` у `.cursor/rules/`; у `{{name}}` підставляється вже готовий markdown-рядок (наприклад `- .cursor/rules/n-spell.mdc`).
+Під час запуску CLI тіло між `{{#services}}` і `{{/services}}` повторюється для кожного `*.mdc` у `.cursor/rules/`; у `{{name}}` підставляється вже готовий markdown-рядок (наприклад `- .cursor/rules/n-text.mdc`).
 
 3. Після змін у шаблоні перевірте локально: у тестовому репозиторії з `.n-cursor.json` виконайте `npx`/`bunx` на зібраному пакеті або `node npm/bin/n-cursor.js` з кореня того репозиторію і переконайтеся, що **`AGENTS.md`** виглядає як очікується.
 

package/mdc/bun.mdc

@@ -12,9 +12,11 @@ version: '1.1'
 - Якщо новий виклик CLI додається з нуля і в цьому репозиторії прийнято лише Bun — можна `bunx <tool>`.
 
 Заборонено використовувати як менеджер пакетів / lockfile:
+
 - `npm install`, `yarn`, `pnpm` (і відповідні lockfile, крім `bun.lock`)
 
 Дозволені команди:
+
 - `bun i`
 - `bun run <script>`
 - `bun add <pkg>`
@@ -23,7 +25,6 @@ version: '1.1'
 - `bunx <tool>`
 - `npx <tool>`
 
-
 - Для встановлення залежностей використовуй `bun i`.
 - Для запуску скриптів використовуй `bun run <script>`.
 - Для додавання залежностей:
@@ -32,6 +33,7 @@ version: '1.1'
 - Для одноразових CLI-команд використовуй `bunx <tool>`.
 
 Заборонено використовувати:
+
 - `npm`
 - `yarn`
 - `pnpm`
@@ -41,6 +43,7 @@ Lockfile у репозиторії: `bun.lock`.
 Видалити якщо вони є. Видалити .yarn та .yarnrc.yml якщо вони є.
 
 Для Bun monorepo:
+
 - Встановлювати залежності у відповідному пакеті, а не в корені без потреби.
 - Якщо залежність потрібна лише одному пакету, додавати її в директорії цього пакета.
 - У CI та локально запускати скрипти через `bun run`.
@@ -49,12 +52,15 @@ Lockfile у репозиторії: `bun.lock`.
 
 Якщо в проекті використовується npx, то не заміняти його на bunx, а використовувати npx.
 Коли зміна відбувається в Dockerfile, то використовувати
+
 ```dockerfile
 FROM oven/bun:alpine AS build-env
 ```
+
 замість образу node
 
 В Github actions bun повинен налаштований так:
+
 ```yaml
 - uses: oven-sh/setup-bun@v2
 

package/mdc/js-lint.mdc

@@ -1,10 +1,10 @@
 ---
 description: Перевірка JavaScript коду
 alwaysApply: true
-version: '1.2'
+version: '1.4'
 ---
 
-Перевірка виконується за допомогою **oxlint** та **ESLint**.
+Перевірка виконується за допомогою **oxlint**, **ESLint** та **jscpd** (дублікати коду).
 
 У файлі `.vscode/extensions.json` мають бути рекомендації розширень:
 
@@ -18,18 +18,30 @@ version: '1.2'
 }
 ```
 
-У кореневому `package.json` додай скрипт і залежність:
+У кореневому `package.json` додай скрипт і залежності:
 
 ```json title="package.json"
   "scripts": {
-    "lint-js": "oxlint --fix && bunx eslint --fix ."
+    "lint-js": "oxlint --fix && bunx eslint --fix . && bunx jscpd ."
   },
   "devDependencies": {
     "@nitra/eslint-config": "^3.3.0"
   }
 ```
 
-У `devDependencies` достатньо `@nitra/eslint-config` (залежності ESLint підтягуються разом із ним). **oxlint** і **eslint** у скриптах викликай через `bunx`; окремо не додавай пакети `oxlint` / `eslint`, якщо цього не вимагає ваш монорепо.
+У `devDependencies` достатньо `@nitra/eslint-config` (залежності ESLint підтягуються разом із ним). **oxlint**, **eslint** та **jscpd** у скриптах викликай через `bunx`; окремо не додавай пакети `oxlint` / `eslint` / `jscpd`, якщо цього не вимагає ваш монорепо.
+
+У корені проєкту має бути `.jscpd.json`. Мінімум: увімкнути облік `.gitignore`, ненульовий код виходу при знаходженні клонів, консольний звіт. За потреби додай `ignore` (дзеркальні каталоги, шаблони) та `minLines`, щоб відсікти дрібні збіги:
+
+```json title=".jscpd.json"
+{
+  "gitignore": true,
+  "exitCode": 1,
+  "reporters": ["console"],
+  "minLines": 25,
+  "ignore": []
+}
+```
 
 Додай workflow `.github/workflows/lint-js.yml`:
 
@@ -49,6 +61,7 @@ on:
       - '**/*.tsx'
       - '**/*.vue'
       - '**/eslint.config.*'
+      - '.jscpd.json'
 
   pull_request:
     branches:
@@ -83,6 +96,7 @@ jobs:
         run: |
           bunx oxlint
           bunx eslint .
+          bunx jscpd .
 ```
 
 **Без дублювання CI:** якщо в `.github/workflows` уже є `lint.yml` з тими самими кроками `oxlint` або `eslint`,  видали зайвий workflow, а саме `lint.yml` — лінт JS має виконуватися в одному місці.

package/mdc/js-pino.mdc

@@ -14,4 +14,4 @@ Configmap повинен бути з тією самою назвою, що і d
 
 ## Перевірка
 
-`npx @nitra/cursor check js-pino`
+`npx @nitra/cursor check js-pino`

package/mdc/text.mdc

@@ -0,0 +1,219 @@
+---
+description: Обробка та перевірка текстових файлів (cspell, markdownlint-cli2, v8r, CI)
+alwaysApply: true
+version: '1.12'
+---
+
+Правило описує роботу з **текстовими файлами** в репозиторії: перевірка правопису через **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.
+
+## Розширення Cursor / VS Code
+
+У файлі `.vscode/extensions.json` **додай** `DavidAnson.vscode-markdownlint` у масив `recommendations` (разом із записами з інших правил, зокрема js-lint / js-format):
+
+```json title=".vscode/extensions.json"
+{
+  "recommendations": [
+    "dbaeumer.vscode-eslint",
+    "github.vscode-github-actions",
+    "oxc.oxc-vscode",
+    "DavidAnson.vscode-markdownlint"
+  ]
+}
+```
+
+## Скрипти та залежності в package.json
+
+У кореневому `package.json` один скрипт **lint-text** має послідовно викликати **cspell**, **markdownlint-cli2** і **v8r** (і решту блоків з розділів нижче в одному файлі):
+
+```json title="package.json"
+  "scripts": {
+    "lint-text": "npx cspell . && bunx markdownlint-cli2 --fix \"**/*.md\" \"**/*.mdc\" && (bunx v8r \"**/*.json\" || [ $? -eq 98 ]) && (bunx v8r \"**/*.yml\" || [ $? -eq 98 ]) && (bunx v8r \"**/*.yaml\" || [ $? -eq 98 ]) && (bunx v8r \"**/*.toml\" || [ $? -eq 98 ])"
+  },
+  "devDependencies": {
+    "markdownlint-cli2": "^0.22.0"
+  }
+```
+
+**markdownlint-cli2** і **v8r** у скрипті викликай через `bunx`. Окремо не додавай пакет `markdownlint`, якщо достатньо `markdownlint-cli2`. Маски `**/*.md` і `**/*.mdc` охоплюють Markdown і правила Cursor (`.mdc`); виключення з `.gitignore` для markdownlint задаються в `.markdownlint-cli2.jsonc` (`gitignore: true`). За потреби можна додати окремий скрипт `lint-md` лише для markdownlint — CI все одно має викликати повний `bun run lint-text`.
+
+## v8r
+
+[v8r](https://chris48s.github.io/v8r/) — CLI-валідатор: за іменем файлу знаходить схему в [Schema Store](https://www.schemastore.org/) і перевіряє вміст. У `lint-text` — чотири послідовні виклики з масками `**/*.json`, `**/*.yml`, `**/*.yaml`, `**/*.toml`, кожен у вигляді `(bunx v8r "<glob>" || [ $? -eq 98 ])`.
+
+**Код 98:** якщо для glob **немає жодного файлу**, v8r дає **98**. Це стосується не лише TOML: репозиторій без `.yml`/`.yaml` зламає **один** спільний виклик `v8r` уже на `**/*.yml`. Окремі виклики з дозволом лише **98** покривають і такі репозиторії.
+
+За замовчуванням v8r враховує **`.gitignore`**. **`.v8rignore` не створюй завчасно** — файл потрібен **лише коли** `bunx v8r` падає на JSON/YAML без схеми в каталозі (тоді додай у ignore відповідні glob’и).
+
+Пакет **`v8r` у `devDependencies` не додавай** — у скрипті достатньо **`bunx v8r`**.
+
+## Конфігурація markdownlint-cli2
+
+У корені проєкту має бути **`.markdownlint-cli2.jsonc`** (документація: [DavidAnson/markdownlint-cli2](https://github.com/DavidAnson/markdownlint-cli2)):
+
+```json title=".markdownlint-cli2.jsonc"
+{
+  "gitignore": true,
+  "config": {
+    "default": true,
+    "MD013": false,
+    "MD029": false,
+    "MD040": false,
+    "MD041": false
+  }
+}
+```
+
+`gitignore: true` змушує markdownlint-cli2 пропускати шляхи з `.gitignore` (у тому числі `node_modules`, якщо воно там є). Додатковий glob `"#node_modules"` у скрипті не потрібен. За потреби додай власні шляхи через `ignores` у цьому ж файлі.
+
+За потреби увімкни окремі правила (наприклад `MD013` з `line_length: 120`), щоб узгодити довжину рядків з `.oxfmtrc.json`.
+
+`MD041` вимкнено навмисно: файли `.mdc` (Cursor rules) мають YAML frontmatter, після якого перший абзац часто не є заголовком H1.
+
+## Cspell
+
+У корені проєкту має бути `.cspell.json` і залежності для cspell у кореневому `package.json` (зазвичай `devDependencies`).
+
+Додай workflow `.github/workflows/lint-text.yml`:
+
+```yaml
+name: Lint Text
+
+on:
+  push:
+    branches:
+      - dev
+    paths:
+      - '.cspell.json'
+      - '.gitignore'
+      - '.markdownlint-cli2.jsonc'
+      - '**/*.js'
+      - '**/*.ts'
+      - '**/*.vue'
+      - '**/*.html'
+      - '**/*.css'
+      - '**/*.scss'
+      - '**/*.less'
+      - '**/*.json'
+      - '**/*.jsonc'
+      - '**/*.yaml'
+      - '**/*.yml'
+      - '**/*.toml'
+      - '**/*.xml'
+      - '**/*.md'
+      - '**/*.mdc'
+      - '**/*.mdс'
+      - '**/*.txt'
+      - '**/*.go'
+      - '**/*.py'
+      - '**/*.php'
+
+  pull_request:
+    branches:
+      - dev
+
+concurrency:
+  group: ${{ github.ref }}-${{ github.workflow }}
+  cancel-in-progress: true
+
+jobs:
+  text:
+    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: Lint text
+        run: bun run lint-text
+```
+
+**Без дублювання CI:** якщо в `.github/workflows` уже є workflow з тими самими кроками `cspell` або `markdownlint-cli2`, видали зайвий — перевірки тексту та Markdown мають виконуватися в одному місці.
+
+## Базовий варіант cspell (без окремого словника української)
+
+Якщо текст переважно англійською та достатньо корпоративного словника (@nitra/cspell-dict; у полі `language` cspell лишається тег `nitra`):
+
+```json title=".cspell.json"
+{
+  "version": "0.2",
+  "language": "nitra",
+  "ignorePaths": ["**/node_modules/**", "**/vscode-extension/**", "**/.git/**", ".vscode", "report"],
+  "import": ["@nitra/cspell-dict/cspell-ext.json"],
+  "words": []
+}
+```
+
+```json title="package.json"
+{
+  "scripts": {
+    "lint-text": "npx cspell . && bunx markdownlint-cli2 --fix \"**/*.md\" \"**/*.mdc\" && (bunx v8r \"**/*.json\" || [ $? -eq 98 ]) && (bunx v8r \"**/*.yml\" || [ $? -eq 98 ]) && (bunx v8r \"**/*.yaml\" || [ $? -eq 98 ]) && (bunx v8r \"**/*.toml\" || [ $? -eq 98 ])"
+  },
+  "devDependencies": {
+    "@nitra/cspell-dict": "^1.0.185",
+    "markdownlint-cli2": "^0.22.0"
+  }
+}
+```
+
+## Проєкт з українською мовою
+
+Якщо в репозиторії є українська документація, коментарі або рядки в коді — потрібен **окремий словник** `@cspell/dict-uk-ua`, інакше cspell не перевірятиме український правопис коректно.
+
+**1. Залежності** — додай пакет словника поруч із `@nitra/cspell-dict`:
+
+```json title="package.json"
+{
+  "scripts": {
+    "lint-text": "npx cspell . && bunx markdownlint-cli2 --fix \"**/*.md\" \"**/*.mdc\" && (bunx v8r \"**/*.json\" || [ $? -eq 98 ]) && (bunx v8r \"**/*.yml\" || [ $? -eq 98 ]) && (bunx v8r \"**/*.yaml\" || [ $? -eq 98 ]) && (bunx v8r \"**/*.toml\" || [ $? -eq 98 ])"
+  },
+  "devDependencies": {
+    "@nitra/cspell-dict": "^1.0.185",
+    "@cspell/dict-uk-ua": "^4.0.6",
+    "markdownlint-cli2": "^0.22.0"
+  }
+}
+```
+
+Встановлення: `bun add -d @cspell/dict-uk-ua` (або `npm i -D @cspell/dict-uk-ua`).
+
+**2. `.cspell.json`** — у полі `language` має бути `uk` (разом з іншими мовами через кому), у `import` — підключення розширення українського словника:
+
+```json title=".cspell.json"
+{
+  "version": "0.2",
+  "language": "en,uk,nitra",
+  "ignorePaths": ["**/node_modules/**", "**/vscode-extension/**", "**/.git/**", ".vscode", "report"],
+  "import": [
+    "@nitra/cspell-dict/cspell-ext.json",
+    "@cspell/dict-uk-ua/cspell-ext.json"
+  ],
+  "words": []
+}
+```
+
+Підлаштуй `language` під проєкт (наприклад додай `ru-ru`, якщо потрібна перевірка російською). Порядок у `import` може впливати на пріоритет словників — тримай корпоративний `@nitra/cspell-dict` там, де зручно для ваших правил.
+
+## Локальні виключення
+
+У секції `words` у `.cspell.json` додають власні терміни, імена та скорочення, яких немає в словниках.
+
+## Інші мови
+
+Для іншої мови встанови відповідний пакет `@cspell/dict-*`, додай його `cspell-ext.json` у `import` і код мови в `language`. Огляд словників: [streetsidesoftware/cspell-dicts](https://github.com/streetsidesoftware/cspell-dicts).
+
+## Перевірка
+
+`npx @nitra/cursor check text`

package/mdc/vue.mdc

@@ -4,8 +4,6 @@ alwaysApply: true
 version: '1.2'
 ---
 
-# Vue 3 (Composition API)
-
 # Vue 3 Composition API — правила для .cursorrules
 
 ## Найкращі практики Vue 3 Composition API

package/package.json

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

package/scripts/check-js-lint.mjs

@@ -27,8 +27,15 @@ export async function check() {
 
     if (pkg.scripts?.['lint-js']) {
       pass('package.json містить скрипт lint-js')
+      if (String(pkg.scripts['lint-js']).includes('jscpd')) {
+        pass('lint-js містить jscpd')
+      } else {
+        fail('lint-js має викликати jscpd — додай "&& bunx jscpd ." у кінець скрипта')
+      }
     } else {
-      fail('package.json не містить скрипт "lint-js" — додай: "oxlint --fix && bunx eslint --fix ."')
+      fail(
+        'package.json не містить скрипт "lint-js" — додай: "oxlint --fix && bunx eslint --fix . && bunx jscpd ."'
+      )
     }
 
     if (pkg.devDependencies?.['@nitra/eslint-config']) {
@@ -63,10 +70,40 @@ export async function check() {
     } else {
       fail('lint-js.yml не містить eslint')
     }
+    if (content.includes('jscpd')) {
+      pass('lint-js.yml містить jscpd')
+    } else {
+      fail('lint-js.yml не містить jscpd — додай крок bunx jscpd .')
+    }
   } else {
     fail('.github/workflows/lint-js.yml не існує — створи його')
   }
 
+  if (existsSync('.jscpd.json')) {
+    let jscpdCfg
+    try {
+      jscpdCfg = JSON.parse(await readFile('.jscpd.json', 'utf8'))
+    } catch {
+      fail('.jscpd.json не є валідним JSON')
+      jscpdCfg = null
+    }
+    if (jscpdCfg) {
+      pass('.jscpd.json існує')
+      if (jscpdCfg.gitignore === true) {
+        pass('.jscpd.json: gitignore увімкнено')
+      } else {
+        fail('.jscpd.json має містити "gitignore": true')
+      }
+      if (jscpdCfg.exitCode === 1) {
+        pass('.jscpd.json: exitCode 1 при дублікатах')
+      } else {
+        fail('.jscpd.json має містити "exitCode": 1 (інакше CI не впаде на клонах)')
+      }
+    }
+  } else {
+    fail('.jscpd.json не існує — створи з gitignore, exitCode та reporters згідно js-lint.mdc')
+  }
+
   for (const dup of ['.eslintrc', '.eslintrc.js', '.eslintrc.json', '.eslintrc.yml']) {
     if (existsSync(dup)) fail(`Знайдено застарілий конфіг ESLint: ${dup} — видали, використовуй eslint.config.js`)
   }

package/scripts/check-text.mjs

@@ -0,0 +1,139 @@
+import { existsSync } from 'node:fs'
+import { readFile } from 'node:fs/promises'
+
+import { pass } from './utils/pass.mjs'
+
+/**
+ * Перевіряє відповідність проєкту правилам text.mdc (cspell, markdownlint-cli2, v8r)
+ * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
+ */
+export async function check() {
+  let exitCode = 0
+  const fail = msg => {
+    console.log(`  ❌ ${msg}`)
+    exitCode = 1
+  }
+
+  if (existsSync('.vscode/extensions.json')) {
+    try {
+      const ext = JSON.parse(await readFile('.vscode/extensions.json', 'utf8'))
+      const rec = ext.recommendations
+      if (Array.isArray(rec) && rec.includes('DavidAnson.vscode-markdownlint')) {
+        pass('extensions.json містить DavidAnson.vscode-markdownlint')
+      } else {
+        fail('extensions.json: додай "DavidAnson.vscode-markdownlint" у recommendations (див. n-text.mdc)')
+      }
+    } catch {
+      fail('.vscode/extensions.json — невалідний JSON')
+    }
+  } else {
+    fail('.vscode/extensions.json не існує — створи з recommendations згідно n-text.mdc')
+  }
+
+  if (existsSync('.markdownlint-cli2.jsonc')) {
+    try {
+      const ml = JSON.parse(await readFile('.markdownlint-cli2.jsonc', 'utf8'))
+      pass('.markdownlint-cli2.jsonc існує і є валідним JSON')
+      if (ml.gitignore === true) {
+        pass('.markdownlint-cli2.jsonc: gitignore увімкнено')
+      } else {
+        fail('.markdownlint-cli2.jsonc: додай на верхньому рівні "gitignore": true (див. n-text.mdc)')
+      }
+    } catch {
+      fail('.markdownlint-cli2.jsonc — невалідний JSON; перевір синтаксис')
+    }
+  } else {
+    fail('.markdownlint-cli2.jsonc не існує — створи згідно n-text.mdc')
+  }
+
+  if (existsSync('.cspell.json')) {
+    const cfg = JSON.parse(await readFile('.cspell.json', 'utf8'))
+
+    if (cfg.version === '0.2') {
+      pass('.cspell.json version: 0.2')
+    } else {
+      fail('.cspell.json version має бути "0.2"')
+    }
+
+    if (cfg.language) {
+      pass(`.cspell.json language: "${cfg.language}"`)
+    } else {
+      fail('.cspell.json не містить поле language')
+    }
+
+    const imports = cfg.import || []
+    if (imports.some(i => i.includes('@nitra/cspell-dict'))) {
+      pass('.cspell.json імпортує @nitra/cspell-dict')
+    } else {
+      fail('.cspell.json не імпортує @nitra/cspell-dict/cspell-ext.json')
+    }
+
+    if (Array.isArray(cfg.ignorePaths)) {
+      pass('.cspell.json містить ignorePaths')
+    } else {
+      fail('.cspell.json не містить ignorePaths')
+    }
+  } else {
+    fail('.cspell.json не існує — створи його')
+  }
+
+  if (existsSync('package.json')) {
+    const pkg = JSON.parse(await readFile('package.json', 'utf8'))
+    const devDeps = pkg.devDependencies || {}
+
+    if (devDeps['@nitra/cspell-dict']) {
+      pass('@nitra/cspell-dict є в devDependencies')
+    } else {
+      fail('@nitra/cspell-dict відсутній — bun add -d @nitra/cspell-dict')
+    }
+
+    if (devDeps['markdownlint-cli2']) {
+      pass('markdownlint-cli2 є в devDependencies')
+    } else {
+      fail('markdownlint-cli2 відсутній — bun add -d markdownlint-cli2')
+    }
+
+    const lintText = pkg.scripts?.['lint-text']
+    const v8rCalls = typeof lintText === 'string' ? (lintText.match(/bunx v8r/g) || []).length : 0
+    const eq98Hints = typeof lintText === 'string' ? (lintText.match(/eq 98/g) || []).length : 0
+    if (
+      typeof lintText === 'string' &&
+      lintText.includes('cspell') &&
+      lintText.includes('markdownlint-cli2') &&
+      lintText.includes('**/*.mdc') &&
+      v8rCalls >= 4 &&
+      eq98Hints >= 4 &&
+      lintText.includes('**/*.json') &&
+      lintText.includes('**/*.yml') &&
+      lintText.includes('**/*.yaml') &&
+      lintText.includes('**/*.toml')
+    ) {
+      pass('package.json: lint-text — чотири виклики v8r з || [ $? -eq 98 ] для json/yml/yaml/toml')
+    } else {
+      fail(
+        'package.json: lint-text — чотири (bunx v8r "<glob>" || [ $? -eq 98 ]) для **/*.json **/*.yml **/*.yaml **/*.toml (див. n-text.mdc)'
+      )
+    }
+
+    if (existsSync('.github/workflows/lint-text.yml')) {
+      const wf = await readFile('.github/workflows/lint-text.yml', 'utf8')
+      if (wf.includes('bun run lint-text')) {
+        pass('lint-text.yml викликає bun run lint-text')
+      } else {
+        fail('lint-text.yml має містити крок bun run lint-text')
+      }
+    } else {
+      fail('.github/workflows/lint-text.yml не існує — створи згідно n-text.mdc')
+    }
+
+    if (existsSync('.cspell.json')) {
+      const cfg = JSON.parse(await readFile('.cspell.json', 'utf8'))
+      const hasUkImport = (cfg.import || []).some(i => i.includes('@cspell/dict-uk-ua'))
+      if (hasUkImport && !devDeps['@cspell/dict-uk-ua']) {
+        fail('.cspell.json імпортує @cspell/dict-uk-ua, але пакет відсутній в devDependencies')
+      }
+    }
+  }
+
+  return exitCode
+}

package/skills/n-fix/SKILL.md

@@ -40,6 +40,7 @@ oxfmt .
 
 ```bash
 bun run lint-js
+bun run lint-text
 bun run lint-style
 ```
 

package/skills/n-publish-telegram/SKILL.md

@@ -47,11 +47,12 @@ Telegram підтримує моноширний шрифт через markdown-
 <1-2 речення — що отримали, яка вигода>
 ```
 
-#тег використовуються наступні:
-якщо публікація стосовно AI, то #ai
-якщо публікація стосовно npm модуля, то #npm
-якщо публікація стосовно розробки, то #dev
-якщо публікація стосовно інфраструктури, скриптів, налаштувань, ефективності коду чи безпеки то #sre
+Теги (хештеги в кінці поста) — підбір за темою:
+
+- якщо публікація стосовно AI, то `#ai`
+- якщо публікація стосовно npm модуля, то `#npm`
+- якщо публікація стосовно розробки, то `#dev`
+- якщо публікація стосовно інфраструктури, скриптів, налаштувань, ефективності коду чи безпеки, то `#sre`
 
 ## Правила
 
@@ -68,6 +69,8 @@ Telegram підтримує моноширний шрифт через markdown-
 
 ````
 ```
+#dev
+
 📌 Міграція з Prettier на oxfmt
 
 Проблема:
@@ -87,7 +90,5 @@ Prettier повільно форматував великі файли і
 Результат:
 Форматування працює миттєво при збереженні,
 зникли конфлікти між форматером і лінтером.
-
-#dx #tooling #oxfmt
 ```
 ````

package/mdc/spell.mdc

@@ -1,155 +0,0 @@
----
-description: Перевірка правопису в текстових файлах
-alwaysApply: true
-version: '1.3'
----
-
-У корені проєкту має бути `.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/cspell-dict; у полі `language` cspell лишається тег `nitra`):
-
-```json title=".cspell.json"
-{
-  "version": "0.2",
-  "language": "nitra",
-  "ignorePaths": ["**/node_modules/**", "**/vscode-extension/**", "**/.git/**", ".vscode", "report"],
-  "import": ["@nitra/cspell-dict/cspell-ext.json"],
-  "words": []
-}
-```
-
-```json title="package.json"
-{
-  "scripts": {
-    "lint-spell": "npx cspell ."
-  },
-  "devDependencies": {
-    "@nitra/cspell-dict": "^1.0.185"
-  }
-}
-```
-
-## Проєкт з українською мовою
-
-Якщо в репозиторії є українська документація, коментарі або рядки в коді — потрібен **окремий словник** `@cspell/dict-uk-ua`, інакше cspell не перевірятиме український правопис коректно.
-
-**1. Залежності** — додай пакет словника поруч із `@nitra/cspell-dict`:
-
-```json title="package.json"
-{
-  "scripts": {
-    "lint-spell": "npx cspell ."
-  },
-  "devDependencies": {
-    "@nitra/cspell-dict": "^1.0.185",
-    "@cspell/dict-uk-ua": "^4.0.6"
-  }
-}
-```
-
-Встановлення: `bun add -d @cspell/dict-uk-ua` (або `npm i -D @cspell/dict-uk-ua`).
-
-**2. `.cspell.json`** — у полі `language` має бути `uk` (разом з іншими мовами через кому), у `import` — підключення розширення українського словника:
-
-```json title=".cspell.json"
-{
-  "version": "0.2",
-  "language": "en,uk,nitra",
-  "ignorePaths": ["**/node_modules/**", "**/vscode-extension/**", "**/.git/**", ".vscode", "report"],
-  "import": [
-    "@nitra/cspell-dict/cspell-ext.json",
-    "@cspell/dict-uk-ua/cspell-ext.json"
-  ],
-  "words": []
-}
-```
-
-Підлаштуй `language` під проєкт (наприклад додай `ru-ru`, якщо потрібна перевірка російською). Порядок у `import` може впливати на пріоритет словників — тримай корпоративний `@nitra/cspell-dict` там, де зручно для ваших правил.
-
-## Локальні виключення
-
-У секції `words` у `.cspell.json` додають власні терміни, імена та скорочення, яких немає в словниках.
-
-## Інші мови
-
-Для іншої мови встанови відповідний пакет `@cspell/dict-*`, додай його `cspell-ext.json` у `import` і код мови в `language`. Огляд словників: [streetsidesoftware/cspell-dicts](https://github.com/streetsidesoftware/cspell-dicts).
-
-## Перевірка
-
-`npx @nitra/cursor check spell`

package/scripts/check-spell.mjs

@@ -1,86 +0,0 @@
-import { existsSync } from 'node:fs'
-import { readFile } from 'node:fs/promises'
-
-import { pass } from './utils/pass.mjs'
-
-/**
- * Перевіряє відповідність проєкту правилам spell.mdc
- * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
- */
-export async function check() {
-  let exitCode = 0
-  const fail = msg => {
-    console.log(`  ❌ ${msg}`)
-    exitCode = 1
-  }
-
-  if (existsSync('.cspell.json')) {
-    const cfg = JSON.parse(await readFile('.cspell.json', 'utf8'))
-
-    if (cfg.version === '0.2') {
-      pass('.cspell.json version: 0.2')
-    } else {
-      fail('.cspell.json version має бути "0.2"')
-    }
-
-    if (cfg.language) {
-      pass(`.cspell.json language: "${cfg.language}"`)
-    } else {
-      fail('.cspell.json не містить поле language')
-    }
-
-    const imports = cfg.import || []
-    if (imports.some(i => i.includes('@nitra/cspell-dict'))) {
-      pass('.cspell.json імпортує @nitra/cspell-dict')
-    } else {
-      fail('.cspell.json не імпортує @nitra/cspell-dict/cspell-ext.json')
-    }
-
-    if (Array.isArray(cfg.ignorePaths)) {
-      pass('.cspell.json містить ignorePaths')
-    } else {
-      fail('.cspell.json не містить ignorePaths')
-    }
-  } else {
-    fail('.cspell.json не існує — створи його')
-  }
-
-  if (existsSync('package.json')) {
-    const pkg = JSON.parse(await readFile('package.json', 'utf8'))
-    const devDeps = pkg.devDependencies || {}
-
-    if (devDeps['@nitra/cspell-dict']) {
-      pass('@nitra/cspell-dict є в devDependencies')
-    } else {
-      fail('@nitra/cspell-dict відсутній — bun add -d @nitra/cspell-dict')
-    }
-
-    const lintSpell = pkg.scripts?.['lint-spell']
-    if (typeof lintSpell === 'string' && lintSpell.includes('cspell')) {
-      pass('package.json містить скрипт lint-spell з cspell')
-    } else {
-      fail('package.json не містить скрипт "lint-spell": "npx cspell ." (див. n-spell.mdc)')
-    }
-
-    if (existsSync('.github/workflows/lint-spell.yml')) {
-      const wf = await readFile('.github/workflows/lint-spell.yml', 'utf8')
-      if (wf.includes('lint-spell')) {
-        pass('lint-spell.yml існує і викликає lint-spell')
-      } else {
-        fail('lint-spell.yml має містити виклик bun run lint-spell')
-      }
-    } else {
-      fail('.github/workflows/lint-spell.yml не існує — створи згідно n-spell.mdc')
-    }
-
-    if (existsSync('.cspell.json')) {
-      const cfg = JSON.parse(await readFile('.cspell.json', 'utf8'))
-      const hasUkImport = (cfg.import || []).some(i => i.includes('@cspell/dict-uk-ua'))
-      if (hasUkImport && !devDeps['@cspell/dict-uk-ua']) {
-        fail('.cspell.json імпортує @cspell/dict-uk-ua, але пакет відсутній в devDependencies')
-      }
-    }
-  }
-
-  return exitCode
-}