@nitra/cursor 1.9.23 → 1.11.0

package/rules/adr/js/check.mjs

@@ -1,14 +1,17 @@
 /**
- * Перевіряє вимоги правила adr.mdc: ADR Stop-hook capture-decisions.sh у Claude Code.
+ * Перевіряє вимоги правила adr.mdc: ADR Stop-hook'и `capture-decisions.sh` і
+ * `normalize-decisions.sh` у Claude Code.
  *
  * Очікування:
- * - `.claude/hooks/capture-decisions.sh` існує і байт-у-байт збігається з канонічним
- *   `.claude-template/hooks/capture-decisions.sh` пакета (sync керує файлом повністю).
- * - `.claude/settings.json` (project-shared) має managed-групу у `hooks.Stop`, яка
- *   викликає цей bash-скрипт; маркер у `command` — `.claude/hooks/capture-decisions.sh`.
- * - `.claude/settings.local.json` (якщо існує) НЕ має дубля цієї managed-групи —
- *   після переходу на project-shared такий запис створив би два запуски на одну подію.
- * - `.gitignore` у корені містить шаблон, який покриває `.claude/hooks/capture-decisions.log`.
+ * - `.claude/hooks/capture-decisions.sh` та `.claude/hooks/normalize-decisions.sh`
+ *   існують і байт-у-байт збігаються з канонічними `.claude-template/hooks/*`
+ *   пакета (sync керує файлами повністю).
+ * - `.claude/settings.json` (project-shared) має managed-групи у `hooks.Stop` для
+ *   обох скриптів (маркери у `command` — самі шляхи до скриптів).
+ * - `.claude/settings.local.json` (якщо існує) НЕ має дублів цих managed-груп —
+ *   після переходу на project-shared такі записи створили б два запуски на одну подію.
+ * - `.gitignore` у корені містить шаблон, який покриває
+ *   `.claude/hooks/capture-decisions.log` і `.claude/hooks/normalize-decisions.log`.
  *
  * LLM CLI (`claude` або `cursor-agent`) у `PATH` — інформативна перевірка: якщо жодного
  * немає, скрипт працює, але мовчки виходить, тому це warning, а не fail.
@@ -21,26 +24,48 @@ import { fileURLToPath } from 'node:url'
 
 import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
 
-const PROJECT_HOOK_PATH = '.claude/hooks/capture-decisions.sh'
+/** Один hook-артефакт: bash-скрипт + його лог-файл, які перевіряємо однотипно. */
+const HOOK_ARTIFACTS = /** @type {const} */ ([
+  { scriptName: 'capture-decisions.sh', logName: 'capture-decisions.log' },
+  { scriptName: 'normalize-decisions.sh', logName: 'normalize-decisions.log' }
+])
+
 const PROJECT_SETTINGS_PATH = '.claude/settings.json'
-const PROJECT_LOG_PATH = '.claude/hooks/capture-decisions.log'
 const EOL_RE = /\r?\n/u
 
 const here = dirname(fileURLToPath(import.meta.url))
-/** Канонічний bundled-скрипт у пакеті — джерело правди для звірки з проєктним. */
-const BUNDLED_HOOK_PATH = join(here, '..', '.claude-template', 'hooks', 'capture-decisions.sh')
+const BUNDLED_HOOKS_DIR = join(here, '..', '..', '..', '.claude-template', 'hooks')
+
+/**
+ * Відносний шлях до managed hook-скрипта у проєкті.
+ * @param {string} scriptName базове ім'я скрипта (наприклад `capture-decisions.sh`)
+ * @returns {string} `.claude/hooks/<scriptName>`
+ */
+function projectHookPath(scriptName) {
+  return `.claude/hooks/${scriptName}`
+}
+
+/**
+ * Відносний шлях до лог-файлу managed hook'а у проєкті.
+ * @param {string} logName базове ім'я лог-файлу (наприклад `capture-decisions.log`)
+ * @returns {string} `.claude/hooks/<logName>`
+ */
+function projectLogPath(logName) {
+  return `.claude/hooks/${logName}`
+}
 
 /**
- * Чи містить рядок `.gitignore` шаблон, який покриває `.claude/hooks/capture-decisions.log`.
+ * Чи містить рядок `.gitignore` шаблон, який покриває цей конкретний лог-файл хука.
  * Враховує точний шлях, glob `.claude/hooks/*.log` та широкий glob `**\/*.log`.
  * @param {string} line одна нормалізована (trim) лінія `.gitignore`
- * @returns {boolean} `true`, якщо лінія матчить лог-файл хука
+ * @param {string} logPath шлях `.claude/hooks/<name>.log`, який треба покрити
+ * @returns {boolean} `true`, якщо лінія матчить цей лог-файл
  */
-function gitignoreLineCoversHookLog(line) {
+function gitignoreLineCoversHookLog(line, logPath) {
   if (!line || line.startsWith('#')) {
     return false
   }
-  if (line === PROJECT_LOG_PATH) {
+  if (line === logPath) {
     return true
   }
   if (line === '.claude/hooks/*.log' || line === '.claude/hooks/**/*.log') {
@@ -53,28 +78,28 @@ function gitignoreLineCoversHookLog(line) {
 }
 
 /**
- * Перевіряє наявність і канонічність `.claude/hooks/capture-decisions.sh` у проєкті.
+ * Перевіряє наявність і канонічність одного hook-скрипта.
  * @param {import('./utils/check-reporter.mjs').CheckReporter} reporter репортер для збору результатів
+ * @param {string} scriptName базове ім'я скрипта (наприклад `capture-decisions.sh`)
  * @returns {Promise<void>}
  */
-async function checkHookScript(reporter) {
+async function checkHookScript(reporter, scriptName) {
   const { pass, fail } = reporter
-  if (!existsSync(PROJECT_HOOK_PATH)) {
-    fail(`${PROJECT_HOOK_PATH} не існує — запусти \`npx @nitra/cursor\` (правило adr копіює канонічний скрипт)`)
+  const projectPath = projectHookPath(scriptName)
+  const bundledPath = join(BUNDLED_HOOKS_DIR, scriptName)
+  if (!existsSync(projectPath)) {
+    fail(`${projectPath} не існує — запусти \`npx @nitra/cursor\` (правило adr копіює канонічний скрипт)`)
     return
   }
-  if (!existsSync(BUNDLED_HOOK_PATH)) {
-    fail(`канонічний скрипт у пакеті не знайдено: ${BUNDLED_HOOK_PATH} — перевстанови @nitra/cursor`)
+  if (!existsSync(bundledPath)) {
+    fail(`канонічний скрипт у пакеті не знайдено: ${bundledPath} — перевстанови @nitra/cursor`)
     return
   }
-  const [project, bundled] = await Promise.all([
-    readFile(PROJECT_HOOK_PATH, 'utf8'),
-    readFile(BUNDLED_HOOK_PATH, 'utf8')
-  ])
+  const [project, bundled] = await Promise.all([readFile(projectPath, 'utf8'), readFile(bundledPath, 'utf8')])
   if (project === bundled) {
-    pass(`${PROJECT_HOOK_PATH} збігається з канонічним`)
+    pass(`${projectPath} збігається з канонічним`)
   } else {
-    fail(`${PROJECT_HOOK_PATH} відрізняється від канонічного — запусти \`npx @nitra/cursor\` для повторного синку`)
+    fail(`${projectPath} відрізняється від канонічного — запусти \`npx @nitra/cursor\` для повторного синку`)
   }
 }
 
@@ -95,25 +120,42 @@ function checkProjectSettings(reporter) {
 }
 
 /**
- * Перевіряє `.gitignore` на ігнорування лог-файлу хука.
+ * Перевіряє `.gitignore` на ігнорування лог-файлу одного хука.
+ * @param {import('./utils/check-reporter.mjs').CheckReporter} reporter репортер для збору результатів
+ * @param {string} logName базове ім'я лог-файлу (наприклад `capture-decisions.log`)
+ * @param {string} gitignoreContent попередньо прочитаний вміст `.gitignore`
+ * @returns {void}
+ */
+function checkGitignoreForLog(reporter, logName, gitignoreContent) {
+  const { pass, fail } = reporter
+  const logPath = projectLogPath(logName)
+  const covers = gitignoreContent
+    .split(EOL_RE)
+    .map(l => l.trim())
+    .some(line => gitignoreLineCoversHookLog(line, logPath))
+  if (covers) {
+    pass(`.gitignore покриває ${logPath}`)
+  } else {
+    fail(`.gitignore не ігнорує \`${logPath}\` — додай цей рядок`)
+  }
+}
+
+/**
+ * Перевіряє `.gitignore` для всіх hook-логів одним проходом.
  * @param {import('./utils/check-reporter.mjs').CheckReporter} reporter репортер для збору результатів
  * @returns {Promise<void>}
  */
 async function checkGitignore(reporter) {
-  const { pass, fail } = reporter
+  const { fail } = reporter
   if (!existsSync('.gitignore')) {
-    fail(`.gitignore не існує — додай рядок \`${PROJECT_LOG_PATH}\``)
+    for (const { logName } of HOOK_ARTIFACTS) {
+      fail(`.gitignore не існує — додай рядок \`${projectLogPath(logName)}\``)
+    }
     return
   }
   const content = await readFile('.gitignore', 'utf8')
-  const covers = content
-    .split(EOL_RE)
-    .map(l => l.trim())
-    .some(line => gitignoreLineCoversHookLog(line))
-  if (covers) {
-    pass(`.gitignore покриває ${PROJECT_LOG_PATH}`)
-  } else {
-    fail(`.gitignore не ігнорує \`${PROJECT_LOG_PATH}\` — додай цей рядок`)
+  for (const { logName } of HOOK_ARTIFACTS) {
+    checkGitignoreForLog(reporter, logName, content)
   }
 }
 
@@ -166,7 +208,9 @@ function checkLlmCliAvailable(reporter) {
  */
 export async function check() {
   const reporter = createCheckReporter()
-  await checkHookScript(reporter)
+  for (const { scriptName } of HOOK_ARTIFACTS) {
+    await checkHookScript(reporter, scriptName)
+  }
   checkProjectSettings(reporter)
   await checkGitignore(reporter)
   checkLlmCliAvailable(reporter)

package/rules/adr/policy/settings_json/settings_json.rego

@@ -1,13 +1,13 @@
-# Порт перевірки `.claude/settings.json` з `npm/scripts/check-adr.mjs` (adr.mdc):
-# `hooks.Stop[*]` має містити групу, де хоча б один елемент `hooks[]` має `command`
-# зі substring `.claude/hooks/capture-decisions.sh`.
+# Перевірка `.claude/settings.json` для правила adr.mdc:
+# `hooks.Stop[*]` має містити дві managed-групи — capture і normalize — у
+# кожній хоча б один елемент `hooks[]` з відповідним маркером у `command`.
 #
 # Запуск (локально):
-#   conftest test .claude/settings.json -p npm/policy/adr \
+#   conftest test .claude/settings.json -p npm/rules/adr/policy \
 #     --namespace adr.settings_json
 #
-# Hash-порівняння bash-скрипта з канонічним bundled-варіантом і `.gitignore`-перевірки
-# — у JS (`check-adr.mjs`).
+# Hash-порівняння bash-скриптів з канонічними bundled-варіантами і `.gitignore`-перевірки
+# — у JS (`js/check.mjs`).
 #
 # Структура каталогу збігається зі шляхом пакету (regal: directory-package-mismatch).
 # Конвенція проєкту — `import rego.v1` + multi-value `deny contains msg if { … }`
@@ -16,16 +16,22 @@ package adr.settings_json
 
 import rego.v1
 
-hook_command_marker := ".claude/hooks/capture-decisions.sh"
+capture_marker := ".claude/hooks/capture-decisions.sh"
+normalize_marker := ".claude/hooks/normalize-decisions.sh"
 
 deny contains msg if {
-	not has_adr_stop_hook
+	not has_stop_hook_with_marker(capture_marker)
 	msg := ".claude/settings.json: відсутній Stop-hook для `capture-decisions.sh` у hooks.Stop (adr.mdc)"
 }
 
-# Чи є в `hooks.Stop[*].hooks[*].command` рядок з маркером скрипта.
-has_adr_stop_hook if {
+deny contains msg if {
+	not has_stop_hook_with_marker(normalize_marker)
+	msg := ".claude/settings.json: відсутній Stop-hook для `normalize-decisions.sh` у hooks.Stop (adr.mdc)"
+}
+
+# Чи є в `hooks.Stop[*].hooks[*].command` рядок з заданим маркером.
+has_stop_hook_with_marker(marker) if {
 	some group in object.get(object.get(input, "hooks", {}), "Stop", [])
 	some hook in object.get(group, "hooks", [])
-	contains(object.get(hook, "command", ""), hook_command_marker)
+	contains(object.get(hook, "command", ""), marker)
 }

package/rules/adr/policy/settings_json/target.json

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

package/rules/adr/policy/settings_local_json/settings_local_json.rego

@@ -1,10 +1,10 @@
-# Порт перевірки `.claude/settings.local.json` з `npm/scripts/check-adr.mjs`
-# (adr.mdc): після переходу на project-shared `settings.json` цей файл (якщо є)
-# НЕ повинен мати дубля Stop-хука з маркером `.claude/hooks/capture-decisions.sh`,
-# інакше один і той самий скрипт виконається двічі на одну подію.
+# Перевірка `.claude/settings.local.json` для правила adr.mdc: після переходу на
+# project-shared `settings.json` цей файл (якщо є) НЕ повинен мати дубля жодного
+# з керованих Stop-хуків (`capture-decisions.sh` або `normalize-decisions.sh`),
+# інакше відповідний скрипт виконається двічі на одну подію.
 #
 # Запуск (локально):
-#   conftest test .claude/settings.local.json -p npm/policy/adr \
+#   conftest test .claude/settings.local.json -p npm/rules/adr/policy \
 #     --namespace adr.settings_local_json
 #
 # Структура каталогу збігається зі шляхом пакету (regal: directory-package-mismatch).
@@ -14,15 +14,27 @@ package adr.settings_local_json
 
 import rego.v1
 
-hook_command_marker := ".claude/hooks/capture-decisions.sh"
+capture_marker := ".claude/hooks/capture-decisions.sh"
+normalize_marker := ".claude/hooks/normalize-decisions.sh"
 
-duplicate_template := concat(" ", [
-	".claude/settings.local.json: видали дубль Stop-хука для",
-	"`capture-decisions.sh` — він уже у project-shared settings.json (adr.mdc)",
-])
+deny contains msg if {
+	has_stop_hook_with_marker(capture_marker)
+	msg := concat(" ", [
+		".claude/settings.local.json: видали дубль Stop-хука для",
+		"`capture-decisions.sh` — він уже у project-shared settings.json (adr.mdc)",
+	])
+}
+
+deny contains msg if {
+	has_stop_hook_with_marker(normalize_marker)
+	msg := concat(" ", [
+		".claude/settings.local.json: видали дубль Stop-хука для",
+		"`normalize-decisions.sh` — він уже у project-shared settings.json (adr.mdc)",
+	])
+}
 
-deny contains duplicate_template if {
+has_stop_hook_with_marker(marker) if {
 	some group in object.get(object.get(input, "hooks", {}), "Stop", [])
 	some hook in object.get(group, "hooks", [])
-	contains(object.get(hook, "command", ""), hook_command_marker)
+	contains(object.get(hook, "command", ""), marker)
 }

package/rules/adr/policy/settings_local_json/target.json

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

package/rules/bun/policy/bunfig/target.json

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

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

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

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

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

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

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

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

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

package/rules/hasura/policy/svc_hl/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": "hasura/k8s/base/svc-hl.yaml" }
+}

package/rules/image-avif/policy/package_json/target.json

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

package/rules/image-compress/policy/package_json/target.json

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

package/rules/js-bun-db/policy/package_json/target.json

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

package/rules/js-bun-redis/policy/package_json/target.json

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

package/rules/js-lint/policy/lint_js_yml/target.json

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

package/rules/js-lint/policy/package_json/target.json

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

package/rules/js-mssql/policy/package_json/target.json

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

package/rules/js-run/policy/configmap/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "walkGlob": "**/k8s/*/configmap.yaml" }
+}

package/rules/js-run/policy/package_json/target.json

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

package/rules/k8s/policy/base_kustomization/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "walkGlob": "**/k8s/**/base/**/kustomization.yaml" }
+}

package/rules/k8s/policy/base_manifest/target.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": {
+    "walkGlob": [
+      "**/k8s/**/base/**/*.yaml",
+      "**/k8s/**/base/**/*.yml",
+      "!**/k8s/**/base/**/kustomization.yaml"
+    ]
+  }
+}

package/rules/k8s/policy/gateway/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "walkGlob": ["**/k8s/**/*.yaml", "**/k8s/**/*.yml"] }
+}

package/rules/k8s/policy/hpa_pdb/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "walkGlob": ["**/k8s/**/*.yaml", "**/k8s/**/*.yml"] }
+}

package/rules/k8s/policy/kustomization/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "walkGlob": "**/k8s/**/kustomization.yaml" }
+}

package/rules/k8s/policy/manifest/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "walkGlob": ["**/k8s/**/*.yaml", "**/k8s/**/*.yml"] }
+}

package/rules/k8s/policy/svc_hl_yaml/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "walkGlob": "**/k8s/**/svc-hl.yaml" }
+}

package/rules/k8s/policy/svc_yaml/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "walkGlob": "**/k8s/**/svc.yaml" }
+}

package/rules/npm-module/policy/emit_types_config/target.json

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

package/rules/npm-module/policy/npm_package_json/target.json

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

package/rules/npm-module/policy/npm_publish_yml/target.json

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

package/rules/npm-module/policy/root_package_json/target.json

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

package/rules/php/policy/lint_php_yml/target.json

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

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

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

package/rules/rego/js/applies/check.mjs

@@ -0,0 +1,54 @@
+/**
+ * Applies-гейт правила `rego` (rego.mdc): правило застосовне, лише якщо в репозиторії є
+ * хоча б один `.rego`-файл (під типовими skip-ами і `.n-cursor.json:ignore`).
+ *
+ * Якщо `.rego` нема — CLI пропускає правило цілком (включно з polices `package_json`,
+ * `vscode_extensions`, `vscode_settings`), бо вимоги rego-tooling неактуальні. Якщо є — CLI
+ * прогонить policy-концерни через `target.json`-маніфести у `rules/rego/policy/<name>/`.
+ *
+ * JS тут лишається лише як cross-file гейт: walkDir не виразити декларативно через `target.json`.
+ * Друк короткого pass-повідомлення з контекстом робить `check()` (необовʼязковий).
+ */
+import { createCheckReporter } from '../../../../scripts/utils/check-reporter.mjs'
+import { loadCursorIgnorePaths } from '../../../../scripts/utils/load-cursor-config.mjs'
+import { walkDir } from '../../../../scripts/utils/walkDir.mjs'
+
+/**
+ * Чи є хоча б один `.rego`-файл у дереві від `cwd`. Зупиняється на першому матчі.
+ * @param {string} root абсолютний шлях кореня
+ * @param {string[]} ignorePaths шляхи каталогів, повністю виключених з обходу
+ * @returns {Promise<boolean>} `true`, якщо знайдено хоч один `.rego`
+ */
+async function projectHasRegoFiles(root, ignorePaths) {
+  let found = false
+  await walkDir(
+    root,
+    p => {
+      if (p.endsWith('.rego')) {
+        found = true
+      }
+    },
+    ignorePaths
+  )
+  return found
+}
+
+/**
+ * Rule-level applies-гейт: CLI пропускає правило, якщо в репо немає `.rego` файлів.
+ * @returns {Promise<boolean>} `true`, якщо правило застосовне
+ */
+export async function applies() {
+  const root = process.cwd()
+  const ignorePaths = await loadCursorIgnorePaths(root)
+  return projectHasRegoFiles(root, ignorePaths)
+}
+
+/**
+ * Друкує короткий context-pass — самі полісі прогонить CLI через `policy/<name>/target.json`.
+ * @returns {Promise<number>} 0 — все ок (фактичні порушення повертають policy-концерни)
+ */
+export async function check() {
+  const reporter = createCheckReporter()
+  reporter.pass('Знайдено *.rego у дереві — перевіряємо канонічні конфіги rego.mdc')
+  return reporter.getExitCode()
+}

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

@@ -0,0 +1,5 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": "package.json", "required": true },
+  "missingMessage": "package.json не існує — створи згідно rego.mdc (rego.package_json)"
+}

package/rules/rego/policy/vscode_extensions/target.json

@@ -0,0 +1,5 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": ".vscode/extensions.json", "required": true },
+  "missingMessage": ".vscode/extensions.json не існує — створи згідно rego.mdc (rego.vscode_extensions)"
+}

package/rules/rego/policy/vscode_settings/target.json

@@ -0,0 +1,5 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": ".vscode/settings.json", "required": true },
+  "missingMessage": ".vscode/settings.json не існує — створи згідно rego.mdc (rego.vscode_settings)"
+}

package/rules/style-lint/policy/lint_style_yml/target.json

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

package/rules/style-lint/policy/package_json/target.json

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

package/rules/style-lint/policy/vscode_extensions/target.json

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

package/rules/style-lint/policy/vscode_settings/target.json

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

package/rules/text/policy/cspell/target.json

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

package/rules/text/policy/markdownlint/target.json

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

package/rules/text/policy/oxfmtrc/target.json

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

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

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

package/rules/text/policy/vscode_extensions/target.json

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

package/rules/text/policy/vscode_settings/target.json

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