@nitra/cursor 1.11.12 → 1.11.13

package/CHANGELOG.md

@@ -4,6 +4,13 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
+## [1.11.13] - 2026-05-16
+
+### Fixed
+
+- **`npm/rules/{bun,image-compress,js-bun-redis,js-run,php,style-lint,text}/fix/<concern>/check.mjs`** — escape `@nitra` як `\@nitra` у JSDoc-блоках (`/** … */`), де `npx @nitra/cursor check` стояв всередині backticks. ESLint-плагін `jsdoc/escape-inline-tags` парсив `@nitra` як інлайн-тег (false-positive у backticks) і видавав 8 warnings. Виправлення — escape-символ `\` перед `@`, як уже зроблено в інших місцях коду (CHANGELOG 1.11.5 для `js-run`). Pass-повідомлення та `//`-коментарі поза JSDoc не зачіпало — там парсер не активний.
+- **`npm/skills/fix/SKILL.md`** (+`.cursor/skills/n-fix/SKILL.md` синк) — заголовок секції перейменовано з **«Скоуп»** на **«Scope»**, бо cspell флагав «Скоуп» як unknown word. Англійський «Scope» зрозумілий і не вимагає розширення словника. Тіло секції без змін.
+
 ## [1.11.12] - 2026-05-15
 
 ### Removed
@@ -50,7 +57,7 @@
 
 ### Changed
 
-- **`npm/skills/fix/SKILL.md`** (+`.cursor/skills/n-fix/SKILL.md` синк) — `/n-fix` більше **не запускає** `bun run lint` і **не делегує** до `/n-lint`. Крок 6 (`bun run lint` з делегуванням, доданий у 1.11.6) повністю видалено; замість нього на початку SKILL.md додано секцію **«Скоуп»**, де явно зафіксовано: `/n-fix` опікується лише структурою проєкту (правила `.cursor/rules/` + `npx @nitra/cursor check`), а лінт-порушення у самому коді (ESLint/oxlint/jscpd/cspell/knip/sonarjs/stylelint) — поза скоупом і виправляються винятково через `/n-lint`. Кроки 7→6 і 8→7 переномеровано; остаточний пункт 7 додатково нагадує, що лінт-помилки не входять у критерій успіху `/n-fix`. Мета — щоб агент, що виконує `/n-fix`, не плутав свою задачу з `/n-lint` і не запускав важкий `bun run lint` без потреби; те, що діагностує `/n-lint`, виправляється там же, а не дублюється тут.
+- **`npm/skills/fix/SKILL.md`** (+`.cursor/skills/n-fix/SKILL.md` синк) — `/n-fix` більше **не запускає** `bun run lint` і **не делегує** до `/n-lint`. Крок 6 (`bun run lint` з делегуванням, доданий у 1.11.6) повністю видалено; замість нього на початку SKILL.md додано секцію **«Scope»**, де явно зафіксовано: `/n-fix` опікується лише структурою проєкту (правила `.cursor/rules/` + `npx @nitra/cursor check`), а лінт-порушення у самому коді (ESLint/oxlint/jscpd/cspell/knip/sonarjs/stylelint) — поза скоупом і виправляються винятково через `/n-lint`. Кроки 7→6 і 8→7 переномеровано; остаточний пункт 7 додатково нагадує, що лінт-помилки не входять у критерій успіху `/n-fix`. Мета — щоб агент, що виконує `/n-fix`, не плутав свою задачу з `/n-lint` і не запускав важкий `bun run lint` без потреби; те, що діагностує `/n-lint`, виправляється там же, а не дублюється тут.
 
 ### Fixed
 

package/README.md

@@ -46,7 +46,7 @@
 
 ### Правило `k8s` і Kustomize
 
-У цільовому репозиторії з маніфестами під **`**/k8s`** дотримуйтесь **`rules/k8s/k8s.mdc`** з пакету (після синку — `.cursor/rules/n-k8s.mdc` або копія з `node_modules/@nitra/cursor/rules/k8s/k8s.mdc`).
+У цільовому репозиторії з маніфестами під **`**/k8s`** дотримуйтесь **`rules/k8s/k8s.mdc`** з пакету (після синку — `.cursor/rules/n-k8s.mdc`або копія з`node_modules/@nitra/cursor/rules/k8s/k8s.mdc`).
 
 Коротко:
 
@@ -132,11 +132,11 @@ npm/rules/<id>/
 
 **Принцип:** технологія реалізації визначає директорію.
 
-| Що реалізує | Канал виклику | Куди |
-| --- | --- | --- |
-| JS-діагностика + автофікс | `npx @nitra/cursor check` (fix-канал) | `fix/<concern>/` |
-| JS-orchestrator лінту | `bun run lint-<id>` через `n-cursor lint-<id>` | `lint/` |
-| Rego-діагностика | `npx @nitra/cursor check` (fix-канал) | `policy/<concern>/` |
+| Що реалізує               | Канал виклику                                  | Куди                |
+| ------------------------- | ---------------------------------------------- | ------------------- |
+| JS-діагностика + автофікс | `npx @nitra/cursor check` (fix-канал)          | `fix/<concern>/`    |
+| JS-orchestrator лінту     | `bun run lint-<id>` через `n-cursor lint-<id>` | `lint/`             |
+| Rego-діагностика          | `npx @nitra/cursor check` (fix-канал)          | `policy/<concern>/` |
 
 `fix/` і `policy/` обидва живлять fix-канал (`npx @nitra/cursor check` запускає і JS-checks, і rego-policies), але **розділені за технологією**: JS у `fix/`, rego у `policy/`. `lint/` тримає лише JS, що оркеструє `bun run lint-<id>`.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "1.11.12",
+  "version": "1.11.13",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",
@@ -49,11 +49,11 @@
     "picomatch": "^4.0.4",
     "yaml": "^2.8.3"
   },
+  "devDependencies": {
+    "@nitra/cursor": "^1.11.9"
+  },
   "engines": {
     "bun": ">=1.3",
     "node": ">=25"
-  },
-  "devDependencies": {
-    "@nitra/cursor": "^1.11.9"
   }
 }

package/rules/bun/fix/layout/check.mjs

@@ -9,7 +9,7 @@
  *    `package.json` має бути відповідний скрипт `lint-docker` / `lint-k8s`
  *    (cross-file: два JSON-файли).
  *
- * **Що покрила Rego** (`npx @nitra/cursor check`):
+ * **Що покрила Rego** (`npx \@nitra/cursor check`):
  *  - `npm/policy/bun/bunfig/` — `[install].linker == "hoisted"` у `bunfig.toml`;
  *  - `npm/policy/bun/package_json/` — відсутність `packageManager` / `dependencies`
  *    у кореневому `package.json`, у `devDependencies` лише `@nitra/*`, агрегований

package/rules/image-compress/fix/package_setup/check.mjs

@@ -9,7 +9,7 @@
  *  - застарілий `.minify-image-cache.tsv` (з версій < 3.2) видалений з кореня та
  *    з `.gitignore`.
  *
- * **Що покрила Rego** (`npx @nitra/cursor check`,
+ * **Що покрила Rego** (`npx \@nitra/cursor check`,
  * `npm/policy/image_compress/package_json/`):
  *  - `scripts.lint-image` викликає `npx \@nitra/minify-image --src=. --write`
  *    без `--avif` (AVIF — окреме правило `image-avif`);

package/rules/js-bun-redis/fix/imports/check.mjs

@@ -8,7 +8,7 @@
  *
  * Перевірку `dependencies` (заборона `ioredis` / `node-redis` / `redis` / `@redis/*` у будь-якому
  * `package.json`) винесено в Rego-полісі `npm/policy/js_bun_redis/package_json/`; її запускає
- * `npx @nitra/cursor check`. Тут лишився AST-скан коду через `oxc-parser`.
+ * `npx \@nitra/cursor check`. Тут лишився AST-скан коду через `oxc-parser`.
  */
 import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'

package/rules/js-run/fix/runtime/check.mjs

@@ -392,7 +392,7 @@ function packageJsonHasViteDevDependency(pkgJson) {
 /**
  * Завантажує `package.json` пакета (якщо є). Заборону `@nitra/bunyan` / `bunyan`
  * у dependencies/devDependencies перенесено в Rego (`npm/policy/js_run/package_json/`);
- * `npx @nitra/cursor check` запускає її по всіх workspace `package.json`. Тут лишилася
+ * `npx \@nitra/cursor check` запускає її по всіх workspace `package.json`. Тут лишилася
  * лише AST-перевірка імпортів.
  * @param {string} rootDir відносний шлях workspace
  * @returns {Promise<unknown>} розпарсений package.json або null
@@ -406,7 +406,7 @@ async function loadPackageJson(rootDir) {
 /**
  * Перевіряє наявність `k8s/base/configmap.yaml` пакета. Структуру (наявність
  * `OTEL_RESOURCE_ATTRIBUTES` з обов'язковими `service.name=` / `service.namespace=`)
- * перенесено в Rego (`npm/policy/js_run/configmap/`); `npx @nitra/cursor check`
+ * перенесено в Rego (`npm/policy/js_run/configmap/`); `npx \@nitra/cursor check`
  * запускає її на всіх `k8s/base/configmap.yaml`.
  * @param {string} rootDir відносний шлях workspace
  * @param {(msg: string) => void} passFn успішне повідомлення

package/rules/php/fix/tooling/check.mjs

@@ -5,7 +5,7 @@
  *  - наявність `composer.json` у корені;
  *  - наявність `.github/workflows/lint-php.yml`.
  *
- * **Що покрила Rego** (`npx @nitra/cursor check`):
+ * **Що покрила Rego** (`npx \@nitra/cursor check`):
  *  - `npm/policy/php/package_json/` — наявність скрипта `lint-php` у `package.json`;
  *  - `npm/policy/php/lint_php_yml/` — крок `run: bun run lint-php` у workflow.
  */

package/rules/style-lint/fix/tooling/check.mjs

@@ -7,7 +7,7 @@
  *    (cross-file: треба знати, чи є поле, чи немає);
  *  - `.stylelintignore` у корені.
  *
- * **Що покрила Rego** (`npx @nitra/cursor check`):
+ * **Що покрила Rego** (`npx \@nitra/cursor check`):
  *  - `npm/policy/style_lint/package_json/` — скрипт `lint-style` через `npx stylelint`,
  *    `@nitra/stylelint-config` у `devDependencies`, поле `stylelint.extends`;
  *  - `npm/policy/style_lint/lint_style_yml/` — `npx stylelint` у `run` workflow;

package/rules/text/fix/formatting/check.mjs

@@ -14,7 +14,7 @@
  *    варіантах, run-shellcheck-text.mjs, обовʼязкові glob-и);
  *  - workflow `lint-text.yml` має крок `bun run lint-text`.
  *
- * **Що покрила Rego** (`npx @nitra/cursor check`):
+ * **Що покрила Rego** (`npx \@nitra/cursor check`):
  *  - `npm/policy/text/oxfmtrc/` — обовʼязкові ключі `.oxfmtrc.json` і канонічні
  *    значення (semi/singleQuote/tabWidth/useTabs/printWidth) + `ignorePatterns`
  *    канонічні glob-и;

package/skills/fix/SKILL.md

@@ -6,7 +6,7 @@ description: >-
 
 # n-fix — автоматичне виправлення проєкту
 
-## Скоуп
+## Scope
 
 Цей скіл відповідає **лише за структуру** проєкту: щоб `.cursor/rules/` + `npx @nitra/cursor check` були задоволені (наявність конфігів, залежностей, скриптів, GitHub workflows, відсутність заборонених файлів). **Лінт-порушення у самому коді** (ESLint, oxlint, jscpd, cspell, knip, sonarjs, stylelint тощо) — **поза скоупом**; їх діагностує й виправляє **`/n-lint`** (`bun run lint`). Не запускай `bun run lint` із цього скілу і не намагайся виправляти його порушення тут — це задача `/n-lint`. Якщо `npx @nitra/cursor check` чистий, а `bun run lint` лишився червоним — запусти `/n-lint` окремо.