@nitra/cursor 1.13.87 → 1.14.0

package/scripts/utils/run-rule.mjs

@@ -1,10 +1,10 @@
 /**
- * Оркестратор одного правила під CLI `check`.
+ * Оркестратор одного правила під CLI `fix`.
  *
  * Послідовність (concerns у межах правила — алфавітно):
- *   1. **applies-гейт** з `js/applies/check.mjs`. Якщо модуль експортує `applies()` і вона повертає
+ *   1. **applies-гейт** з `js/applies.mjs`. Якщо модуль експортує `applies()` і вона повертає
  *      false — друкуємо `✅ правило не застосовне` і завершуємо без подальших викликів.
- *   2. **JS-концерни** — кожен `check*.mjs` у `js/<concern>/`. Concern `applies` теж може мати
+ *   2. **JS-концерни** — кожен файл `js/<concern>.mjs`. Concern `applies` теж може мати
  *      `check()` для друку контексту (його `applies()` уже відпрацював на кроці 1, він не повторюється).
  *   3. **Policy-концерни** — кожен `policy/<concern>/target.json` через `runConftestBatch`.
  *      Резолвер `resolveTargetFiles` ділить cache (`walkCache`) між концернами.
@@ -24,32 +24,29 @@ import { resolveConcernTemplateData } from './template.mjs'
 const APPLIES_CONCERN_NAME = 'applies'
 
 /**
- * Обчислює абсолютний шлях до файла-check у JS-концерні: `rules/<id>/js/<concern>/<file>`.
- * Convention `js/` (за технологією) повернулась у 1.13.80 після короткої епохи `fix/`
- * (1.11.10–1.13.79) — щоб не плутати з кореневим `fix.mjs` entry-point'ом.
+ * Обчислює абсолютний шлях до файла-концерну: `rules/<id>/js/<concern>.mjs`.
+ * Flat-convention з 1.14.0 — концерн = файл, не каталог.
  * @param {string} bundledRulesDir абсолютний `rules/`
  * @param {string} ruleId id правила
  * @param {import('./discover-checkable-rules.mjs').JsConcern} concern опис концерну
- * @param {string} fileName імʼя файла з `concern.files`
  * @returns {string} абсолютний шлях
  */
-function resolveJsCheckPath(bundledRulesDir, ruleId, concern, fileName) {
-  return join(bundledRulesDir, ruleId, 'js', concern.name, fileName)
+function resolveJsCheckPath(bundledRulesDir, ruleId, concern) {
+  return join(bundledRulesDir, ruleId, 'js', `${concern.name}.mjs`)
 }
 
 /**
- * Спробувати викликати applies() гейт з `js/applies/check.mjs` правила.
- * Гейт активний лише за наявності концерну з імʼям `applies` і експортом-функцією `applies` у його
- * першому check-файлі (алфавіт).
+ * Спробувати викликати applies() гейт з `js/applies.mjs` правила.
+ * Гейт активний лише за наявності концерну з імʼям `applies` і експортом-функцією `applies`.
  * @param {string} bundledRulesDir абсолютний `rules/`
  * @param {import('./discover-checkable-rules.mjs').CheckableRule} rule опис правила
  * @returns {Promise<boolean>} `true` — правило застосовне (або гейту немає); `false` — пропустити
  */
 async function evaluateAppliesGate(bundledRulesDir, rule) {
   const concern = rule.jsConcerns.find(c => c.name === APPLIES_CONCERN_NAME)
-  if (!concern || concern.files.length === 0) return true
-  const path = resolveJsCheckPath(bundledRulesDir, rule.id, concern, concern.files[0])
-  // eslint-disable-next-line no-unsanitized/method -- path будується з discovered concern/file, які пройшли regex CHECK_FILENAME_RE
+  if (!concern) return true
+  const path = resolveJsCheckPath(bundledRulesDir, rule.id, concern)
+  // eslint-disable-next-line no-unsanitized/method -- path з discovered concern, файл з whitelist'у readdir
   const mod = await import(path)
   if (typeof mod.applies !== 'function') return true
   return Boolean(await mod.applies())
@@ -116,14 +113,12 @@ export async function runRule(rule, bundledRulesDir, walkCache) {
   let totalCode = 0
 
   for (const concern of rule.jsConcerns) {
-    for (const fileName of concern.files) {
-      const path = resolveJsCheckPath(bundledRulesDir, rule.id, concern, fileName)
-      // eslint-disable-next-line no-unsanitized/method -- path будується з discovered concern/file, які пройшли regex CHECK_FILENAME_RE
-      const mod = await import(path)
-      if (typeof mod.check === 'function') {
-        const code = await mod.check()
-        if (code !== 0) totalCode = 1
-      }
+    const path = resolveJsCheckPath(bundledRulesDir, rule.id, concern)
+    // eslint-disable-next-line no-unsanitized/method -- path з discovered concern, файл з whitelist'у readdir
+    const mod = await import(path)
+    if (typeof mod.check === 'function') {
+      const code = await mod.check()
+      if (code !== 0) totalCode = 1
     }
   }
 

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` і пройдися по результатах.
-
-- Якщо є помилки — виправи відповідно до правила, на яке вказує перевірка.
-- Якщо все чисто — підтверди коротким повідомленням і переходь до наступного кроку.