@nitra/cursor 12.5.0 → 12.6.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [12.6.1] - 2026-06-21
+
+### Changed
+
+- Оновлено text rule docs і helper-приклади на n-cursor lint text без package.json lint-text wrapper.
+
+## [12.6.0] - 2026-06-21
+
+### Changed
+
+- Видалено правила для package.json та оновлено логіку перевірок інструментів
+
 ## [12.5.0] - 2026-06-21
 
 ### Changed

package/package.json

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

package/rules/image-compress/js/package_setup.mjs

@@ -76,8 +76,7 @@ async function checkLegacyCacheRemoved(pass, fail, cwd) {
 
 /**
  * Перевіряє відповідність проєкту правилу `image-compress.mdc`: `.n-minify-image.tsv` НЕ
- * в `.gitignore`, застарілий `.minify-image-cache.tsv` видалений. CI-workflow для image
- * не вимагається — лінт зображень виконується лише локально.
+ * в `.gitignore`, застарілий `.minify-image-cache.tsv` видалений.
  * @param {string} [cwd] корінь репозиторію
  * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
  */
@@ -89,7 +88,7 @@ export async function check(cwd = process.cwd()) {
     fail('package.json не знайдено в корені — додай (image-compress.mdc)')
     return reporter.getExitCode()
   }
-  pass('package.json є (структуру перевіряє npx @nitra/cursor fix → image_compress.package_json)')
+  pass('package.json є (dependency policy перевіряє npx @nitra/cursor fix → image_compress.package_json)')
 
   await checkHashCacheNotIgnored(pass, fail, cwd)
   await checkLegacyCacheRemoved(pass, fail, cwd)

package/rules/php/js/tooling.mjs

@@ -18,7 +18,7 @@ export function check() {
   }
 
   if (existsSync('package.json')) {
-    pass('package.json є (наявність lint-php перевіряє npx @nitra/cursor fix → php.package_json)')
+    pass('package.json є')
   } else {
     fail('package.json не знайдено в корені — додай (php.mdc)')
   }

package/rules/php/policy/lint_php_yml/lint_php_yml.rego

@@ -2,7 +2,7 @@
 #
 # Канон надходить через --data: { "template": { "snippet": ... } }
 # Структура --data сформована з template/lint-php.yml.snippet.yml.
-# Маркер `run:` (bun run lint-php) збирається з template's php-job steps.
+# Маркер `run:` збирається з template's php-job steps.
 # Універсальні workflow-перевірки — у `ga.workflow_common`.
 package php.lint_php_yml
 

package/rules/python/js/tooling.mjs

@@ -33,9 +33,9 @@ export function check(cwd = process.cwd()) {
   }
 
   if (existsSync(join(cwd, 'package.json'))) {
-    pass('package.json є (наявність lint-python перевіряє fix → python.package_json)')
+    pass('package.json є')
   } else {
-    fail('package.json не знайдено в корені — додай для `bun run lint-python` (python.mdc)')
+    fail('package.json не знайдено в корені — додай (python.mdc)')
   }
 
   const wfPath = '.github/workflows/lint-python.yml'

package/rules/python/policy/lint_python_yml/lint_python_yml.rego

@@ -6,7 +6,7 @@
 #   - кожен `uses` з template (підмножина): actions/checkout@v6,
 #     ./.github/actions/setup-bun-deps, astral-sh/setup-uv@v8.0.0;
 #   - кожен `run` з template має бути присутнім (як substring) серед run-кроків
-#     input'а: `uv sync --frozen`, `bun run lint-python`.
+#     input'а: `uv sync --frozen`, `n-cursor lint python --read-only`.
 # Заборона Poetry-кроків (snok/install-poetry, `poetry install`) — через відсутність
 # у каноні: правило вимагає uv-кроки, а нав'язаних poetry-кроків у template немає.
 # Універсальні workflow-перевірки (name, concurrency, branches) — у `ga.workflow_common`.

package/rules/text/lint/docs/lint.md

@@ -8,7 +8,7 @@ docgen:
   score: 90
 ---
 
-runLintTextCli надає CLI-обгортку для послідовного лінтингу текстових файлів (text.mdc). Обгортка автоматично встановлює необхідні інструменти (`shellcheck`, `dotenv-linter`) через `ensureTool` перед виконанням ланцюжка перевірок. Ланцюжок включає: перевірку правопису (`cspell`), аналіз скриптів (`shellcheck`), перевірку конфігураційних файлів (`dotenv-linter`), форматування Markdown (`markdownlint-cli2`) та валідацію схем (`v8r`). При виявленні першого ненульового коду в ланцюжку, цей код повертається як код виходу, і подальші кроки не виконуються. runLintTextCli експортується для використання як підкоманда `lint-text` з `bin/n-cursor.js`.
+runLintTextCli надає внутрішню обгортку для послідовного лінтингу текстових файлів (text.mdc). Обгортка автоматично встановлює необхідні інструменти (`shellcheck`, `dotenv-linter`) через `ensureTool` перед виконанням ланцюжка перевірок. Ланцюжок включає: перевірку правопису (`cspell`), аналіз скриптів (`shellcheck`), перевірку конфігураційних файлів (`dotenv-linter`), форматування Markdown (`markdownlint-cli2`) та валідацію схем (`v8r`). При виявленні першого ненульового коду в ланцюжку, цей код повертається як код виходу, і подальші кроки не виконуються. Зовнішня точка входу правила — `n-cursor lint text`.
 
 ## Поведінка
 

package/rules/text/lint/docs/run-v8r.md

@@ -143,7 +143,7 @@ if (isRunAsCli(import.meta.url)) {
 
 ### Як частина команди `lint-text`
 
-Раннер призначений для виклику з кореневої лінт-команди репозиторію (`lint-text` у `package.json`). Замість того, щоб запускати `v8r` чотирма (або п’ятьма) окремими командами в `package.json`, використовується один виклик цього модуля, який сам обходить усі типові glob-и:
+Раннер призначений для виклику з правила `n-cursor lint text`. Замість того, щоб запускати `v8r` чотирма (або п’ятьма) окремими командами в `package.json`, використовується один виклик цього модуля, який сам обходить усі типові glob-и:
 
 ```bash
 node ./npm/rules/text/lint/run-v8r.mjs

package/rules/text/text.mdc

@@ -117,19 +117,16 @@ version: '1.30'
 
 Завжди пиши **JSDoc** до функцій та методів.
 
-**`package.json`:** скрипт **`lint-text`** і devDependencies **`@nitra/cspell-dict`** (**`^2.0.0`** або новіший у лінії 2.x) — з **2.0.0** у пакет транзитивно входять типові **`@cspell/dict-*`**, тому **не** додавай їх окремо в корінь. **`markdownlint-cli2`** викликай у `lint-text` лише через **`bunx markdownlint-cli2`**, не додавай пакет до devDependencies. **`v8r`** лише через **`bunx v8r`** (зазвичай **`bunx v8r`**), не в devDependencies. Окремий пакет **`markdownlint`** не потрібний.
+**`package.json`:** у `devDependencies` має бути **`@nitra/cspell-dict`** (**`^2.0.0`** або новіший у лінії 2.x) — з **2.0.0** у пакет транзитивно входять типові **`@cspell/dict-*`**, тому **не** додавай їх окремо в корінь. Окремий `package.json`-скрипт `lint-text` не потрібен: запуск іде через **`n-cursor lint text`**. **`markdownlint-cli2`** запускається rule-адаптером через **`bunx markdownlint-cli2`**, не додавай пакет до devDependencies. **`v8r`** лише через **`bunx v8r`**, не в devDependencies. Окремий пакет **`markdownlint`** не потрібний.
 
-**shellcheck:** інструмент лише в **`PATH`** (як у **ga.mdc** для `lint-ga`), **не** додавай до `dependencies` / `devDependencies`. Якщо `shellcheck` відсутній — встанови локально (**macOS:** `brew install shellcheck`; **Debian/Ubuntu:** `sudo apt-get install -y shellcheck`; **Arch:** `sudo pacman -S shellcheck`). Канонічний **`lint-text`** делегує до CLI **`n-cursor lint-text`** (бінарка з `node_modules/.bin/` пакету `@nitra/cursor`): після **`cspell .`** виконується **`runShellcheckText()`** з пакета — циклічно **`shellcheck -f diff`** і **`patch -p1`** для авто-виправлень, потім повний прогін **`shellcheck`** по всіх tracked `*.sh` (у git) або по `**/*.sh` без `node_modules`. Потрібен також **`patch`** у `PATH` (на macOS зазвичай уже є).
+**shellcheck:** інструмент лише в **`PATH`** (як у **ga.mdc** для `lint-ga`), **не** додавай до `dependencies` / `devDependencies`. Якщо `shellcheck` відсутній — встанови локально (**macOS:** `brew install shellcheck`; **Debian/Ubuntu:** `sudo apt-get install -y shellcheck`; **Arch:** `sudo pacman -S shellcheck`). Канонічний запуск — **`n-cursor lint text`** (бінарка з `node_modules/.bin/` пакету `@nitra/cursor`): після **`cspell .`** виконується **`runShellcheckText()`** з пакета — циклічно **`shellcheck -f diff`** і **`patch -p1`** для авто-виправлень, потім повний прогін **`shellcheck`** по всіх tracked `*.sh` (у git) або по `**/*.sh` без `node_modules`. Потрібен також **`patch`** у `PATH` (на macOS зазвичай уже є).
 
 **dotenv-linter:** після shellcheck CLI запускає **`runDotenvLinter()`** з пакета — рекурсивно по `.env*`-файлах проєкту через **`dotenv-linter fix -r --no-backup --quiet . --exclude node_modules --exclude .envrc`**, далі такий самий **`check`** для фінальної перевірки. Інструмент має бути в **`PATH`** і **не** додається в `dependencies` / `devDependencies`. Якщо `dotenv-linter` відсутній — встанови локально (**macOS:** `brew install dotenv-linter`; **Linux:** `curl -sSfL https://git.io/JLbXn | sh -s -- -b /usr/local/bin`; через **cargo:** `cargo install dotenv-linter`).
 
-У v8r **немає** прапорця тихого режиму; CLI-обгортка **`n-cursor lint-text`** на четвертому кроці викликає **`runV8rWithGlobs()`** з пакета (реалізація — `npm/rules/text/js/run-v8r.mjs`): під капотом послідовні **`bunx v8r`** для кожного типу (**json**, **json5**, **yml**, **yaml**, **toml**), бо один процес v8r з кількома глобами падає з **98**, якщо хоч один glob порожній, і тоді інші розширення не перевіряються. Вивід при кодах **0** і **98** не показується. Каталог схем **`schemas/v8r-catalog.json`** пакета `@nitra/cursor` обгортка підставляє в v8r сама.
+У v8r **немає** прапорця тихого режиму; rule-адаптер **`n-cursor lint text`** на четвертому кроці викликає **`runV8rWithGlobs()`** з пакета (реалізація — `npm/rules/text/js/run-v8r.mjs`): під капотом послідовні **`bunx v8r`** для кожного типу (**json**, **json5**, **yml**, **yaml**, **toml**), бо один процес v8r з кількома глобами падає з **98**, якщо хоч один glob порожній, і тоді інші розширення не перевіряються. Вивід при кодах **0** і **98** не показується. Каталог схем **`schemas/v8r-catalog.json`** пакета `@nitra/cursor` обгортка підставляє в v8r сама.
 
 ```json title="package.json"
 {
-  "scripts": {
-    "lint-text": "n-cursor lint-text"
-  },
   "devDependencies": {
     "@nitra/cspell-dict": "^2.1.0"
   }
@@ -174,7 +171,7 @@ version: '1.30'
 
 - Канон: [lint-text.yml.snippet.yml](./policy/lint_text/template/lint-text.yml.snippet.yml)
 
-Перед **`./.github/actions/setup-bun-deps`** — **`actions/checkout@v6`** (див. **ga.mdc**). Після composite — кроки **`Install shellcheck`** (apt) і **`Install dotenv-linter`** (curl), бо `n-cursor lint-text` вимагає обидва бінарники в PATH; на ubuntu-latest shellcheck часто вже є, dotenv-linter — ні. Composite: Node 24, Bun, кеш, `bun install --frozen-lockfile`.
+Перед **`./.github/actions/setup-bun-deps`** — **`actions/checkout@v6`** (див. **ga.mdc**). Після composite — кроки **`Install shellcheck`** (apt) і **`Install dotenv-linter`** (curl), бо `n-cursor lint text` вимагає обидва бінарники в PATH; на ubuntu-latest shellcheck часто вже є, dotenv-linter — ні. Composite: Node 24, Bun, кеш, `bun install --frozen-lockfile`.
 
 Не дублюй окремий workflow з тими самими кроками cspell/markdownlint.
 
@@ -198,9 +195,6 @@ version: '1.30'
 
 ```json title="package.json"
 {
-  "scripts": {
-    "lint-text": "n-cursor lint-text"
-  },
   "devDependencies": {
     "@nitra/cspell-dict": "^2.1.0"
   }
@@ -215,9 +209,6 @@ version: '1.30'
 
 ```json title="package.json"
 {
-  "scripts": {
-    "lint-text": "n-cursor lint-text"
-  },
   "devDependencies": {
     "@nitra/cspell-dict": "^2.1.0"
   }
@@ -262,4 +253,4 @@ kebab-case
 
 ## Перевірка
 
-`npx @nitra/cursor fix text` (охоплює oxfmt, cspell, shellcheck у `lint-text`, markdownlint, v8r, CI для `lint-text`). Зокрема падає, якщо у корені є `.prettierignore`, `.prettierrc*`, `prettier.config.*` або у `package.json#scripts` зустрічається команда з `prettier` — Prettier повністю заборонено, форматування лише через **oxfmt**.
+`npx @nitra/cursor fix text` (охоплює oxfmt, cspell, shellcheck, markdownlint, v8r і CI для `n-cursor lint text`). Зокрема падає, якщо у корені є `.prettierignore`, `.prettierrc*`, `prettier.config.*` або у `package.json#scripts` зустрічається команда з `prettier` — Prettier повністю заборонено, форматування лише через **oxfmt**.

package/scripts/lib/docs/gha-workflow.md

@@ -12,7 +12,7 @@ docgen:
 
 - `check-ga` — загальна перевірка GitHub Actions workflows;
 - `check-js-lint` — перевірка структури `lint-js.yml`;
-- `check-text` — перевірка наявності викликів `bun run lint-text` у CI;
+- `check-text` — перевірка наявності викликів `n-cursor lint text --read-only` у CI;
 - `check-style-lint` — перевірка викликів стайл-лінту в CI;
 - `check-npm-module` — перевірка workflow npm-модуля.
 
@@ -191,7 +191,7 @@ docgen:
 
 **Side effects:** немає. Ітерація припиняється на першому збігу (рання передача).
 
-**Типовий приклад:** `anyRunStepIncludes(root, 'bun run lint-text')` для `check-text` — перевірити, що CI взагалі викликає таргет лінту текстів.
+**Типовий приклад:** `anyRunStepIncludes(root, 'n-cursor lint text --read-only')` для `check-text` — перевірити, що CI взагалі викликає таргет лінту текстів.
 
 ---
 
@@ -299,14 +299,14 @@ if (!result.ok) {
 }
 ```
 
-### Приклад: перевірка наявності таргета `bun run lint-text`
+### Приклад: перевірка наявності таргета `n-cursor lint text --read-only`
 
 ```js
 import { parseWorkflowYaml, anyRunStepIncludes } from './gha-workflow.mjs'
 
 const root = parseWorkflowYaml(content)
-if (root && !anyRunStepIncludes(root, 'bun run lint-text')) {
-  console.error('у CI відсутній виклик bun run lint-text')
+if (root && !anyRunStepIncludes(root, 'n-cursor lint text --read-only')) {
+  console.error('у CI відсутній виклик n-cursor lint text --read-only')
 }
 ```
 

package/scripts/lib/gha-workflow.mjs

@@ -135,7 +135,7 @@ export function verifyLintJsWorkflowStructure(root) {
 }
 
 /**
- * Чи є в будь-якому `run` кроку підрядок (наприклад `bun run lint-text`).
+ * Чи є в будь-якому `run` кроку підрядок (наприклад `n-cursor lint text --read-only`).
  * @param {Record<string, unknown>} root корінь workflow
  * @param {string} needle підрядок для пошуку
  * @returns {boolean} `true`, якщо хоча б один `run` містить `needle`

package/scripts/lib/run-lint-step.mjs

@@ -3,7 +3,7 @@
  * команди і прокидає stdout/stderr на користувацькі stream-и (`stdio: 'inherit'`), щоб виглядало
  * як прямий виклик у shell.
  *
- * Використовується з `n-cursor lint-ga`, `n-cursor lint-text` та інших підкоманд, щоб не дублювати
+ * Використовується з rule-адаптерів `n-cursor lint <rule>`, щоб не дублювати
  * одну й ту саму обгортку у кожному `rules/<id>/js/lint.mjs` (jscpd-clone).
  */
 import { spawnSync } from 'node:child_process'

package/rules/docker/policy/package_json/package_json.rego

@@ -1,18 +0,0 @@
-# Перевірка `package.json` (docker.mdc).
-#
-# Канон надходить через --data: { "template": { "snippet": ... } }
-# Backward-compatible: перевіряє ЛИШЕ зміст значення `scripts.lint-docker`, якщо ключ
-# присутній у старому проєкті. Нові проєкти використовують `n-cursor lint docker`
-# напряму, без package.json wrapper.
-package docker.package_json
-
-import rego.v1
-
-# Conditional snippet-check: тільки якщо значення непорожнє у input.
-deny contains msg if {
-	some script_name, expected in data.template.snippet.scripts
-	actual := object.get(object.get(input, "scripts", {}), script_name, "")
-	actual != ""
-	trim_space(actual) != expected
-	msg := sprintf("package.json: scripts.%s має бути %q (зараз: %q) (docker.mdc)", [script_name, expected, actual])
-}

package/rules/docker/policy/package_json/target.json

@@ -1,4 +0,0 @@
-{
-  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
-  "files": { "single": "package.json" }
-}

package/rules/docker/policy/package_json/template/package.json.snippet.json

@@ -1 +0,0 @@
-{ "scripts": { "lint-docker": "n-cursor lint docker" } }