@nitra/cursor 1.13.87 → 1.13.89

package/CHANGELOG.md

@@ -4,6 +4,27 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
+## [1.13.89] - 2026-05-23
+
+### Changed
+
+- **Stop-hook кличе `fix` замість deprecated `check`:** `scripts/claude-stop-hook.mjs` тепер спавнить `npx --no @nitra/cursor fix` — без deprecation-warning'а на кожен Stop event Claude Code.
+- **`.claude-template/commands/n-check.md` видалено** (разом з локальним `.claude/commands/n-check.md`). Після CLI-перейменування `check` → `fix` slash-команда `/n-check` вказувала на застарілу команду. У `syncClaudeConfig` логіка sync `commands/*.md` залишилась; зараз темплейт порожній. Тест `створює settings.json + slash-команди` переписано на «без slash-команд, коли темплейт порожній».
+- **JSDoc/docstring чистка:** `bin/n-cursor.js` (CLI usage header), `scripts/claude-stop-hook.mjs`, `scripts/sync-claude-config.mjs`, `rules/image-compress/js/package_setup/check.mjs` — згадки `npx @nitra/cursor check`, `/n-check`, `npm/scripts/check-*.mjs` оновлено на актуальну CLI (`fix`) і шляхи (`rules/<id>/fix.mjs`, `rules/<id>/js/<concern>/check.mjs`).
+- **`.cursor/rules/conftest.mdc`** — алгоритм рішення / патерн Rego-authoritative / Workflow / Red-flags переписано під фактичну структуру `rules/<rule>/js/<concern>/check.mjs` + `rules/<rule>/policy/<name>/`. Прибрано згадки `npm/scripts/check-<rule>.mjs` та `npm/policy/<rule>/` (legacy шляхи); приклади `check abie`, `check ga` → `fix abie`, `fix ga`.
+- **`docs/fix-cursor-skill.md`** — ASCII-діаграми, workflow-кроки та таблиця "Анатомія Skill-файлу" → `npx @nitra/cursor fix`; згадка `check-*.mjs скрипти` → `rules/<id>/fix.mjs правил`.
+
+### Notes
+
+- Споживачі: після оновлення вручну видалити `.claude/commands/n-check.md` (sync не вичищає orphan slash-команди з темплейту). Активна команда — `/n-fix` (зі скілу `n-fix`).
+- В `.claude/settings.json` permission `Bash(npx @nitra/cursor check)` видалено як redundant — вайлдкард `Bash(npx @nitra/cursor *)` нижче вже покриває обидві команди.
+
+## [1.13.88] - 2026-05-23
+
+### Changed
+
+- **`scripts/utils/with-lock.mjs` + тести:** локальна `sleep(ms)` через `new Promise(r => setTimeout(r, ms))` замінена на іменований імпорт `setTimeout as sleep` із `node:timers/promises`. Відповідає правилу `js-run` (без ручних `setTimeout`-промісів) — перевірка `npx @nitra/cursor fix js-run` стала зеленою.
+
 ## [1.13.87] - 2026-05-23
 
 ### Added

package/bin/n-cursor.js

@@ -5,12 +5,12 @@
  *
  * Використання:
  *   `npx \@nitra/cursor`             — завантажити cursor-правила
- *   `npx \@nitra/cursor check`       — перевірити правила з `.cursor/rules/*.mdc`, для яких у пакеті є check/policy;
+ *   `npx \@nitra/cursor fix`         — перевірити правила з `.cursor/rules/*.mdc`, для яких у пакеті є `fix.mjs`/policy;
  *                                     якщо в корені вже є `.n-cursor.json`, спочатку зчитується конфіг і за потреби дописується `$schema`
- *   `npx \@nitra/cursor check bun`   — перевірити лише вказані правила (ігнорує `.cursor/rules/`)
+ *   `npx \@nitra/cursor fix bun`     — перевірити лише вказані правила (ігнорує `.cursor/rules/`)
  *   `npx \@nitra/cursor rename-yaml-extensions` — k8s `*.yml` → `*.yaml`, `.github` `*.yaml` → `*.yml` (опції: `--dry-run`, `--root=…`; див. bin/rename-yaml-extensions.mjs)
  *   `npx \@nitra/cursor stop-hook`   — точка входу Stop hook Claude Code (читає stdin, виходить 0 при `stop_hook_active`,
- *                                     інакше викликає `check`); прописується автоматично в `.claude/settings.json`
+ *                                     інакше викликає `fix`); прописується автоматично в `.claude/settings.json`
  *   `npx \@nitra/cursor lint-ga`     — канонічний lint-ga (ga.mdc): preflight на `shellcheck` →
  *                                     `bunx github-actionlint` → `uvx zizmor --offline --collect=workflows .`
  *   `npx \@nitra/cursor lint-rego`   — канонічний lint-rego (conftest.mdc + rego.mdc):
@@ -25,9 +25,8 @@
  *   `npx \@nitra/cursor skill claude taze ["task"]` — Claude Code CLI (`claude -p`)
  *
  * Agent інтеграція: під час синку, окрім `.cursor/rules` і `.claude/commands` (з skills), CLI ще раз
- * синхронізує `.claude/settings.json` (hooks + permissions; merge — користувацькі поля зберігаються),
- * `.cursor/hooks.json` (Cursor Agent hooks; merge — користувацькі hooks зберігаються),
- * і slash-команди checks (`/n-check`).
+ * синхронізує `.claude/settings.json` (hooks + permissions; merge — користувацькі поля зберігаються)
+ * і `.cursor/hooks.json` (Cursor Agent hooks; merge — користувацькі hooks зберігаються).
  * Опт-аут — поле `claude-config: false` у `.n-cursor.json`.
  *
  * Якщо у корені репозиторію немає .n-cursor.json, спочатку перейменовується за наявності nitra-cursor.json;

package/package.json

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

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

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

package/scripts/claude-stop-hook.mjs

@@ -1,6 +1,6 @@
 /**
  * Stop-hook для Claude Code: запускається hook'ом із `.claude/settings.json` після того,
- * як агент сигналізує завершення ходу. Прозоро прокидає `npx \@nitra/cursor check`
+ * як агент сигналізує завершення ходу. Прозоро прокидає `npx \@nitra/cursor fix`
  * і повертає його exit code, щоб помилки правил блокували завершення.
  *
  * Захист від нескінченної рекурсії: якщо stdin містить `"stop_hook_active": true`
@@ -63,7 +63,7 @@ export async function runStopHookCli() {
     return 0
   }
 
-  const child = spawn('npx', ['--no', '@nitra/cursor', 'check'], { stdio: 'inherit' })
+  const child = spawn('npx', ['--no', '@nitra/cursor', 'fix'], { stdio: 'inherit' })
   try {
     const [code] = await once(child, 'exit')
     return code ?? 1

package/scripts/sync-claude-config.mjs

@@ -1,14 +1,15 @@
 /**
  * Синхронізує конфігурацію Claude Code (`.claude/settings.json`,
- * slash-команди для checks, ADR Stop-hook) і Cursor hooks (`.cursor/hooks.json`)
- * у поточний проєкт із темплейтів пакету
+ * slash-команди з `commands/` темплейту, ADR Stop-hook) і Cursor hooks
+ * (`.cursor/hooks.json`) у поточний проєкт із темплейтів пакету
  * `npm/.claude-template/`.
  *
  * Архітектура:
  * - `settings.json` — **merge**: користувацькі поля зберігаються; наші hooks
  *   ідентифікуються командою-маркером (`MANAGED_HOOK_COMMAND_MARKERS`) і
  *   перезаписуються; permissions.allow зливається через union (із дедублікацією).
- * - `.claude/commands/n-check.md` — fully owned slash-команда.
+ * - `.claude/commands/*.md` — fully owned slash-команди з темплейту
+ *   `.claude-template/commands/` (зараз порожньо; sync no-op).
  * - `.claude/hooks/capture-decisions.sh` — fully owned bash-скрипт ADR capture Stop-hook;
  *   копіюється з `.claude-template/hooks/`, лише коли в `.n-cursor.json` `rules`
  *   присутнє `adr` (правило увімкнене за замовчуванням; вимикається через

package/scripts/utils/with-lock.mjs

@@ -5,21 +5,23 @@
 import * as fs from 'node:fs'
 import * as path from 'node:path'
 import * as os from 'node:os'
+import { setTimeout as sleep } from 'node:timers/promises'
 import { worktreeFingerprint } from './worktree-fingerprint.mjs'
 
 const DEFAULTS = {
   ttl: 600_000,
   staleThreshold: 1_800_000,
   waitTimeout: 1_200_000,
-  pollInterval: 1_500,
+  pollInterval: 1_500
 }
 
 function isAlive(pid) {
-  try { process.kill(pid, 0); return true } catch { return false }
-}
-
-function sleep(ms) {
-  return new Promise(r => setTimeout(r, ms))
+  try {
+    process.kill(pid, 0)
+    return true
+  } catch {
+    return false
+  }
 }
 
 function makeRelease(lockDir) {
@@ -67,18 +69,23 @@ export async function withLock(key, runFn, opts = {}) {
     }
     try {
       fs.mkdirSync(lockDir)
-      fs.writeFileSync(ownerFile, JSON.stringify({ pid: process.pid, host: os.hostname(), startedAt: Date.now(), fingerprint }))
+      fs.writeFileSync(
+        ownerFile,
+        JSON.stringify({ pid: process.pid, host: os.hostname(), startedAt: Date.now(), fingerprint })
+      )
       locked = true
       break
     } catch (error) {
       if (error.code !== 'EEXIST') throw error
       let owner
-      try { owner = JSON.parse(fs.readFileSync(ownerFile, 'utf8')) } catch {
+      try {
+        owner = JSON.parse(fs.readFileSync(ownerFile, 'utf8'))
+      } catch {
         fs.rmSync(lockDir, { recursive: true, force: true })
         continue
       }
-      const stale = (Date.now() - owner.startedAt > staleThreshold) ||
-        (os.hostname() === owner.host && !isAlive(owner.pid))
+      const stale =
+        Date.now() - owner.startedAt > staleThreshold || (os.hostname() === owner.host && !isAlive(owner.pid))
       if (stale) {
         console.error(`🧹 ${key}: знайдено застарілий лок — очищаю`)
         fs.rmSync(lockDir, { recursive: true, force: true })
@@ -100,9 +107,14 @@ export async function withLock(key, runFn, opts = {}) {
       release()
       return 0
     }
-  } catch { /* result.json не існує або пошкоджений */ }
+  } catch {
+    /* result.json не існує або пошкоджений */
+  }
 
-  const onSignal = () => { release(); process.exit(130) }
+  const onSignal = () => {
+    release()
+    process.exit(130)
+  }
   process.once('SIGINT', onSignal)
   process.once('SIGTERM', onSignal)
 

package/.claude-template/commands/n-check.md

@@ -1,11 +0,0 @@
----
-description: >-
-  Запустити всі програмні перевірки правил (`npx @nitra/cursor fix`)
----
-
-# n-check
-
-Запусти `npx @nitra/cursor fix` і пройдися по результатах.
-
-- Якщо є помилки — виправи відповідно до правила, на яке вказує перевірка.
-- Якщо все чисто — підтверди коротким повідомленням і переходь до наступного кроку.