@nitra/cursor 12.8.8 → 12.9.0

package/CHANGELOG.md

@@ -1,10 +1,23 @@
 # Changelog
 
+## [12.9.0] - 2026-06-24
+
+### Changed
+
+- Додано підтримку hook-режиму для linting через `n-cursor
+- Додано перевірку порту 8080 для HTTPRoute та політики HealthCheckPolicy
+
+## [12.8.9] - 2026-06-22
+
+### Changed
+
+- ♻️ refactor(npm): Вдосконалено логіку `full`-scope правил у delta-режимі
+
 ## [12.8.8] - 2026-06-22
 
 ### Changed
 
-- ✨ feat(rules): policy mdc для всіх npm/rules/*/policy/<concern>/
+- ✨ feat(rules): policy mdc для всіх npm/rules/\*/policy/<concern>/
 
 ## [12.8.7] - 2026-06-22
 

package/bin/n-cursor.js

@@ -142,7 +142,7 @@ function sortConfigIdArrays(config) {
 
 /**
  * Імена правил з каталогу `rules/` поточної інсталяції пакету. Кожне правило — окремий
- * підкаталог `rules/<id>/`, у якому має бути `<id>.mdc`.
+ * підкаталог `rules/<id>/`, у якому має бути `main.mdc`.
  * @param {string} [bundledRulesDir] каталог `rules/` у корені пакету
  * @returns {Promise<string[]>} відсортовані id правил (імена підкаталогів)
  */
@@ -157,11 +157,11 @@ async function discoverBundledRuleNames(bundledRulesDir = BUNDLED_RULES_DIR) {
   const entries = await readdir(bundledRulesDir, { withFileTypes: true })
   const rules = entries
     .filter(e => e.isDirectory() && !e.name.startsWith('.'))
-    .filter(e => existsSync(join(bundledRulesDir, e.name, `${e.name}.mdc`)))
+    .filter(e => existsSync(join(bundledRulesDir, e.name, 'main.mdc')))
     .map(e => e.name)
     .toSorted((a, b) => a.localeCompare(b))
   if (rules.length === 0) {
-    throw new Error(`У каталозі rules/ пакету немає підкаталогів з <id>.mdc. Створіть ${CONFIG_FILE} вручну.`)
+    throw new Error(`У каталозі rules/ пакету немає підкаталогів з main.mdc. Створіть ${CONFIG_FILE} вручну.`)
   }
   return rules
 }
@@ -407,18 +407,18 @@ function normalizeRuleName(ruleName) {
 }
 
 /**
- * Читає вміст правила з каталогу `rules/<id>/<id>.mdc` установленого пакету
- * (наприклад `node_modules/@nitra/cursor/rules/<id>/<id>.mdc` або кеш npx).
+ * Читає вміст правила з каталогу `rules/<id>/main.mdc` установленого пакету
+ * (наприклад `node_modules/@nitra/cursor/rules/<id>/main.mdc` або кеш npx).
  * @param {string} rule елемент масиву rules з `.n-cursor.json`
  * @param {string} [bundledRulesDir] каталог `rules/` у корені пакету-джерела
  * @returns {Promise<string>} текст правила для запису в `.cursor/rules/n-*.mdc`
  */
 async function readBundledRuleContent(rule, bundledRulesDir = BUNDLED_RULES_DIR) {
   const id = normalizeRuleName(rule)
-  const bundledPath = join(bundledRulesDir, id, `${id}.mdc`)
+  const bundledPath = join(bundledRulesDir, id, 'main.mdc')
   if (!existsSync(bundledPath)) {
     throw new Error(
-      `Немає файлу ${id}/${id}.mdc у ${bundledRulesDir}. Оновіть ${PACKAGE_NAME} або приберіть "${rule}" з rules у ${CONFIG_FILE}.`
+      `Немає файлу ${id}/main.mdc у ${bundledRulesDir}. Оновіть ${PACKAGE_NAME} або приберіть "${rule}" з rules у ${CONFIG_FILE}.`
     )
   }
   const text = await readFile(bundledPath, 'utf8')
@@ -1515,9 +1515,17 @@ try {
 
       break
     }
+    case 'hook': {
+      // Thin hook entrypoint для Claude Code hooks. Делегує в runLint, перекодовує exit 1→2.
+      //   --post-tool-use  PostToolUse: file_path зі stdin JSON
+      //   --stop           Stop: робоче дерево vs HEAD
+      const { runHookCli } = await import('../scripts/hook.mjs')
+      process.exitCode = await runHookCli(args)
+
+      break
+    }
     case 'post-tool-use-check': {
-      // Викликається з .claude/settings.json як PostToolUse hook Claude Code.
-      // Маршрутизує змінений файл у релевантні правила і прокидає `fix` лише з ними.
+      // @deprecated: використовуй `hook --post-tool-use`
       const code = await runPostToolUseCheckCli()
       process.exitCode = code
 
@@ -1661,7 +1669,7 @@ try {
     default: {
       console.error(`❌ Невідома команда: ${command}`)
       console.error(
-        `   Очікується: (без аргументів) синхронізація правил, rename-yaml-extensions, post-tool-use-check, adr-normalize-local, lint (включно зі scope: lint ga|rego|k8s|docker|text), lint-doc-files, fix-doc-files, coverage, coverage-fix, analyze-escalation, taze, start-check, change, release, skill, trace, doc-aggregate`
+        `   Очікується: (без аргументів) синхронізація правил, rename-yaml-extensions, hook, adr-normalize-local, lint (включно зі scope: lint ga|rego|k8s|docker|text), fix-doc-files, coverage, coverage-fix, analyze-escalation, taze, start-check, change, release, skill, trace, doc-aggregate`
       )
       process.exitCode = 1
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "12.8.8",
+  "version": "12.9.0",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",
@@ -53,11 +53,11 @@
     "rename-yaml-extensions": "bun ./bin/n-cursor.js rename-yaml-extensions"
   },
   "dependencies": {
-    "@7n/mt": "^0.5.0",
-    "oxc-parser": "^0.128.0",
+    "@7n/mt": "^0.5.1",
+    "oxc-parser": "^0.137.0",
     "picomatch": "^4.0.4",
-    "smol-toml": "^1.6.1",
-    "yaml": "^2.8.3",
+    "smol-toml": "^1.7.0",
+    "yaml": "^2.9.0",
     "zod": "^4.4.3"
   },
   "engines": {

package/rules/abie/docs/index.md

@@ -8,5 +8,4 @@ resource: npm/rules/abie/
 
 | Файл                | Тип       |
 | ------------------- | --------- |
-| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

package/rules/abie/lib/docs/http-route.md

@@ -3,26 +3,25 @@ type: JS Module
 title: http-route.mjs
 resource: npm/rules/abie/lib/http-route.mjs
 docgen:
-  crc: 3ec544d6
+  crc: 1ffd9c0b
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
 ---
 
-Файл надає інструмент для порівняльного аналізу конфігурації HTTP-маршрутів. Він виконує порівняння кількості `backendRefs` для сервісів `auth-run-hl` та `file-link-hl` у базових маніфестах пакета з кількістю патчів, визначеною в оверлеях. Цей механізм використовується для синхронізації кількості патчів у верхньому рівні з фактичною кількістю посилань у базі. (abie.mdc)
+## Огляд
 
-## Поведінка
+Виконує крос-документну аналітику для підрахунку `backendRefs` до спільних сервісів (`auth-run-hl`, `file-link-hl`) у base-маніфестах пакета, що знаходяться поза overlay `ua`. Використовується фіксований список спільних сервісів, визначений через `ABIE_SHARED_CROSS_NS_BACKEND_NAMES`. Функція `analyzeAbieSharedBackendRefsInPackageK8s` підраховує ці посилання. Це забезпечує синхронізацію числа патчів namespace в overlay із кількістю base-reference, використовуючи `ua_http_route-концерном` для забезпечення узгодженості (abie.mdc).
 
-ABIE_SHARED_CROSS_NS_BACKEND_NAMES
-Визначає список спільних сервісів, які підлягають аналітиці.
+## Поведінка
 
-analyzeAbieSharedBackendRefsInPackageK8s
-Збирає кількість посилань на спільні бекенди та порушення вимог до namespace у базових документах HTTPRoute пакета.
+ABIE_SHARED_CROSS_NS_BACKEND_NAMES надає фіксований список назв спільних сервісів (`auth-run-hl`, `file-link-hl`), які підлягають аналізу.
+analyzeAbieSharedBackendRefsInPackageK8s збирає кількість посилань на спільні сервіси (`backendRefs`) у base-маніфестах пакета (виключаючи overlay `ua`) та виявляє порушення вимог до цих посилань (наприклад, відсутність `namespace: dev` або `port: 8080` (abie.mdc)).
 
 ## Публічний API
 
-ABIE_SHARED_CROSS_NS_BACKEND_NAMES — Формує імена для крос-нішових зв'язків між бекендами. (abie.mdc)
-
-analyzeAbieSharedBackendRefsInPackageK8s — Збирає кількість спільних посилань `backendRefs` та базові помилки з YAML-файлів пакета, ігноруючи неймспейс `dev`. (abie.mdc)
+ABIE_SHARED_CROSS_NS_BACKEND_NAMES — Визначає імена бекендів, що використовуються між різними неймспейсами.
+analyzeAbieSharedBackendRefsInPackageK8s — Підраховує кількість посилань на спільні бекенди у YAML-файлах пакета (крім overlay ua) та фіксує базові помилки (без неймспейсу dev). (abie.mdc)
 
 ## Гарантії поведінки
 
-- Read-only: файл не виконує операцій запису у файлову систему.
-- Не звертається до мережі.
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/abie/lib/http-route.mjs

@@ -27,6 +27,9 @@ function checkSharedBackendRef(br, rel, errors) {
   if (typeof brRec.namespace !== 'string' || brRec.namespace !== 'dev') {
     errors.push(`${rel}: HTTPRoute backendRefs до ${name} має містити namespace: dev (abie.mdc)`)
   }
+  if (brRec.port !== 8080) {
+    errors.push(`${rel}: HTTPRoute backendRefs до ${name} має містити port: 8080 (abie.mdc)`)
+  }
   return 1
 }
 

package/rules/abie/policy/health_check_policy/health_check_policy.mdc

@@ -8,10 +8,12 @@ Rego-пакет: `abie.health_check_policy`
 
 - `apiVersion` — точно `networking.gke.io/v1`;
 - `metadata.name` — непорожній рядок;
+- `metadata.namespace` — `dev`;
 - `spec.default.config.type` — `HTTP`;
 - `spec.default.config.httpHealthCheck.requestPath` — непорожній, починається з `/`;
-- `spec.default.config.httpHealthCheck.port` — `8080`;
+- `spec.default.config.httpHealthCheck.port` — `8080` (обов'язковий, відсутність теж помилка);
 - `spec.targetRef.kind` — `Service`;
+- `spec.targetRef.group` — порожній рядок `''` (якщо поле присутнє);
 - `spec.targetRef.name` — `<metadata.name>-hl` (якщо `metadata.name` вже закінчується на `-hl` — використовується як є).
 
 FS-парність HCP↔Deployment та modeline `$schema` у `hc.yaml` — поза Rego, у `js/hc_pairing.mjs`. JS-опис структури та приклад — у `js/hc_pairing.mdc`.

package/rules/abie/policy/health_check_policy/health_check_policy.rego

@@ -61,6 +61,15 @@ deny contains "HealthCheckPolicy: metadata.name має бути непорожн
 	trim_space(name) == ""
 }
 
+# ── deny: metadata.namespace ──────────────────────────────────────────────
+
+deny contains msg if {
+	is_health_check_policy
+	ns := object.get(object.get(input, "metadata", {}), "namespace", "")
+	ns != "dev"
+	msg := sprintf("HealthCheckPolicy: metadata.namespace має бути dev (зараз %q) (abie.mdc)", [ns])
+}
+
 # ── deny: spec.default.config.type ────────────────────────────────────────
 
 deny contains "HealthCheckPolicy: spec.default.config.type має бути HTTP (abie.mdc)" if {
@@ -87,6 +96,12 @@ deny contains msg if {
 
 # ── deny: port == 8080 ────────────────────────────────────────────────────
 
+deny contains "HealthCheckPolicy: spec.default.config.httpHealthCheck.port має бути 8080 (abie.mdc)" if {
+	is_health_check_policy
+	is_object(http_health_check)
+	object.get(http_health_check, "port", null) == null
+}
+
 deny contains msg if {
 	is_health_check_policy
 	is_object(http_health_check)
@@ -108,6 +123,18 @@ deny contains msg if {
 	msg := sprintf("HealthCheckPolicy: targetRef.kind має бути Service (зараз %q) (abie.mdc)", [kind])
 }
 
+# ── deny: targetRef.group == '' ───────────────────────────────────────────
+
+deny contains msg if {
+	is_health_check_policy
+	target_ref := object.get(object.get(input, "spec", {}), "targetRef", {})
+	is_object(target_ref)
+	group := object.get(target_ref, "group", null)
+	group != null
+	group != ""
+	msg := sprintf("HealthCheckPolicy: targetRef.group має бути порожнім рядком '' (зараз %q) (abie.mdc)", [group])
+}
+
 # ── deny: targetRef.name = `<hcp.metadata.name>-hl` (exact, з нормалізацією)
 
 deny contains msg if {

package/rules/adr/docs/index.md

@@ -8,5 +8,4 @@ resource: npm/rules/adr/
 
 | Файл | Тип |
 |---|---|
-| [fix.mjs](fix.md) | JS Module |
 | [main.mjs](main.md) | JS Module |

package/rules/adr/js/madr_format.mdc

@@ -93,4 +93,16 @@ docs/adr/
 └── hooks.json                 # Cursor Agent stop-hooks для тих самих скриптів
 ```
 
-`.gitignore` у корені проєкту повинен містити базові рядки (`node_modules/`, `dist/`, `*.secret`) і патерни для ADR Stop-hook (**`.claude/hooks/*.log`**, `.claude/hooks/.normalize-state`, `.claude/hooks/.normalize.lock`). Канонічний фрагмент (дописується `npx @nitra/cursor`, коли правило `adr` увімкнене): [.gitignore.snippet](./templates/hooks/.gitignore.snippet).
+`.gitignore` у корені проєкту повинен містити базові рядки (`node_modules/`, `dist/`, `*.secret`) і патерни для ADR Stop-hook (**`.claude/hooks/*.log`**, `.claude/hooks/.normalize-state`, `.claude/hooks/.normalize.lock`). Канонічний фрагмент (дописується `npx @nitra/cursor`, коли правило `adr` увімкнене):
+
+```gitignore
+node_modules/
+dist/
+*.secret
+
+# @nitra/cursor (adr) — локальні артефакти Stop-hook, не коміти
+.claude/hooks/*.log
+.claude/hooks/.normalize-state
+.claude/hooks/.normalize.lock
+.claude/scheduled_tasks.lock
+```

package/rules/bun/docs/index.md

@@ -8,5 +8,4 @@ resource: npm/rules/bun/
 
 | Файл                | Тип       |
 | ------------------- | --------- |
-| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

package/rules/bun/policy/package_json/package_json.rego

@@ -24,6 +24,18 @@ deny contains msg if {
 	msg := sprintf("package.json: поле %s — %s", [field, reason])
 }
 
+# ── deny: scripts.lint / scripts.lint-* заборонені (bun.mdc lint) ────────
+
+deny contains msg if {
+	is_object(input.scripts)
+	some script_name, _ in input.scripts
+	regex.match(`^lint(-.*)?$`, script_name)
+	msg := sprintf(
+		"package.json: scripts.%s заборонений — лінт запускається через n-cursor lint, не через package.json-скрипти (bun.mdc)",
+		[script_name]
+	)
+}
+
 # ── deny: devDependencies — лише `@nitra/*` + root-only тестові peer/tools ─
 
 deny contains msg if {

package/rules/capacitor/docs/index.md

@@ -8,5 +8,4 @@ resource: npm/rules/capacitor/
 
 | Файл                | Тип       |
 | ------------------- | --------- |
-| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

package/rules/changelog/docs/index.md

@@ -8,5 +8,4 @@ resource: npm/rules/changelog/
 
 | Файл                | Тип       |
 | ------------------- | --------- |
-| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

package/rules/ci4/docs/index.md

@@ -8,5 +8,4 @@ resource: npm/rules/ci4/
 
 | Файл                | Тип       |
 | ------------------- | --------- |
-| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

package/rules/doc-files/docs/index.md

@@ -8,5 +8,4 @@ resource: npm/rules/doc-files/
 
 | Файл                | Тип       |
 | ------------------- | --------- |
-| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

package/rules/doc-files/docs/main.md

@@ -3,26 +3,24 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/doc-files/main.mjs
 docgen:
-  crc: 64f215a5
+  crc: 82caefcd
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 100
+  score: 90
 ---
 
 ## Огляд
 
-Модуль перевіряє відповідність коду та документації, спираючись на конфігурацію `meta.json`. Функція `run` перевіряє консистентність між кодом та документацією. Функція `lint` перевіряє застарілі описи документації.
+Модуль перевіряє відповідність конфігурацій політики джерелам коду, спираючись на `meta.json`. Він також аналізує документацію на відповідність джерелам коду, виявляючи застарілі або нерелевантні описи.
 
 ## Поведінка
 
-run виконує перевірку консистентності між кодом та документацією.
-
-lint перевіряє, чи не застаріли описи документації, і може автоматично їх оновлювати, якщо це дозволено конфігурацією `meta.json`.
+run виконує перевірку відповідності до політики, порівнюючи конфігурації з джерелами коду.
+lint перевіряє, чи відповідає документація джерелам коду, виявляючи застарілі описи та сирітські доки, а також може автоматично їх виправляти за умови наявності конфігурації `meta.json: llmFix:true`.
 
 ## Публічний API
 
-run — виконує основну перевірку, яка включає аналіз JS-задач, застосування політик та посилання на MDC.
-lint — сканує файли документації на наявність застарілих елементів, з можливістю автоматичного виправлення за умови активації LLM.
-llmFix — виконує добровільну генерацію виправлень за допомогою LLM, якщо це дозволено в конфігурації.
+run — основна точка входу, яка виконує перевірку (JS-залежності $\rightarrow$ політики $\rightarrow$ посилання MDC) та запускає перевірку на застарілі файли.
+lint — збирає дані для перевірки документаційних файлів, з можливістю автоматичного виправлення за умови ввімкнення LLM-функціоналу.
 
 ## Гарантії поведінки
 

package/rules/doc-files/main.mjs

@@ -101,8 +101,7 @@ function collectStale(files, cwd) {
  */
 export async function lint(files, cwd = process.cwd(), { readOnly = false, llmFix = false } = {}) {
   const stale = collectStale(files, cwd)
-  // Orphan-детект тільки при повному скані; при точковому (files визначено) — не релевантно
-  const orphans = files === undefined ? scanOrphanedDocs(cwd) : []
+  const orphans = scanOrphanedDocs(cwd)
 
   if (stale.length === 0 && orphans.length === 0) return 0
   if (readOnly || !llmFix) {
@@ -132,7 +131,7 @@ export async function lint(files, cwd = process.cwd(), { readOnly = false, llmFi
   }
 
   const stillStale = collectStale(files, cwd)
-  const stillOrphans = files === undefined ? scanOrphanedDocs(cwd) : []
+  const stillOrphans = scanOrphanedDocs(cwd)
   if (stillStale.length === 0 && stillOrphans.length === 0) return 0
   if (stillStale.length > 0) reportStale(stillStale)
   if (stillOrphans.length > 0) {

package/rules/docker/docs/index.md

@@ -8,5 +8,4 @@ resource: npm/rules/docker/
 
 | Файл                | Тип       |
 | ------------------- | --------- |
-| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

package/rules/efes/docs/index.md

@@ -8,5 +8,4 @@ resource: npm/rules/efes/
 
 | Файл                | Тип       |
 | ------------------- | --------- |
-| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

package/rules/feedback/docs/index.md

@@ -8,5 +8,4 @@ resource: npm/rules/feedback/
 
 | Файл                | Тип       |
 | ------------------- | --------- |
-| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

package/rules/ga/docs/index.md

@@ -8,5 +8,4 @@ resource: npm/rules/ga/
 
 | Файл                | Тип       |
 | ------------------- | --------- |
-| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

package/rules/graphql/docs/index.md

@@ -8,5 +8,4 @@ resource: npm/rules/graphql/
 
 | Файл                | Тип       |
 | ------------------- | --------- |
-| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

package/rules/hasura/docs/index.md

@@ -8,5 +8,4 @@ resource: npm/rules/hasura/
 
 | Файл                | Тип       |
 | ------------------- | --------- |
-| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

package/rules/hasura/js/docs/index.md

@@ -6,6 +6,7 @@ resource: npm/rules/hasura/js/
 
 # npm/rules/hasura/js
 
-| Файл                                  | Тип       |
-| ------------------------------------- | --------- |
+| Файл | Тип |
+|---|---|
 | [internal_urls.mjs](internal_urls.md) | JS Module |
+| [migrations.mjs](migrations.md) | JS Module |

package/rules/hasura/js/docs/migrations.md

@@ -0,0 +1,30 @@
+---
+type: JS Module
+title: migrations.mjs
+resource: npm/rules/hasura/js/migrations.mjs
+docgen:
+  crc: a8e2c4c4
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+---
+
+## Огляд
+
+Функція перевіряє вміст директорії міграцій Hasura. Вона гарантує, що в директорії `hasura/migrations` відсутні файли з назвою `down.sql`, оскільки там мають бути лише файли `up.sql` (hasura.mdc).
+
+## Поведінка
+
+1. Перевіряє наявність директорії `hasura/migrations` відносно кореня репозиторію.
+2. Якщо директорія `hasura/migrations` відсутня, повідомляє, що перевірка `down.sql` не потрібна (hasura.mdc) і завершує роботу.
+3. Якщо директорія `hasura/migrations` існує, сканує її вміст.
+4. Збирає список усіх знайдених файлів з назвою `down.sql` у цій директорії.
+5. Якщо жоден файл `down.sql` не знайдено, повідомляє, що жоден `down.sql` не знайдено у `hasura/migrations/` (hasura.mdc) і завершує роботу.
+6. Якщо знайдено один або більше файлів `down.sql`, повідомляє про кожен знайдений файл, що `down.sql` заборонений у `hasura/migrations/` — у директорії міграції має бути лише `up.sql` (hasura.mdc) і завершує роботу.
+
+## Публічний API
+
+check — перевіряє відсутність файлів `down.sql` у директорії міграцій, оскільки вони не використовуються.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/hasura/js/migrations.mjs

@@ -0,0 +1,47 @@
+/** @see ./docs/migrations.md */
+import { existsSync } from 'node:fs'
+import { basename, join, relative } from 'node:path'
+
+import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
+import { walkDir } from '../../../scripts/utils/walkDir.mjs'
+
+/** Відносний шлях до директорії міграцій від кореня проєкту. */
+const MIGRATIONS_REL = 'hasura/migrations'
+
+/**
+ * Перевіряє, що у `hasura/migrations/` відсутні файли `down.sql`.
+ * Директорія міграції має містити лише `up.sql` — `down.sql` у проєкті не використовується.
+ * @param {string} [cwdParam] корінь репозиторію
+ * @returns {Promise<number>} 0 — чисто, 1 — знайдено `down.sql`
+ */
+export async function check(cwdParam = process.cwd()) {
+  const reporter = createCheckReporter()
+  const { pass, fail } = reporter
+
+  const cwd = cwdParam
+  const migrationsDir = join(cwd, MIGRATIONS_REL)
+
+  if (!existsSync(migrationsDir)) {
+    pass(`${MIGRATIONS_REL}/ відсутній — перевірка down.sql не потрібна (hasura.mdc)`)
+    return reporter.getExitCode()
+  }
+
+  /** @type {string[]} */
+  const offenders = []
+  await walkDir(migrationsDir, absPath => {
+    if (basename(absPath) === 'down.sql') {
+      offenders.push(relative(cwd, absPath))
+    }
+  })
+
+  if (offenders.length === 0) {
+    pass(`Жоден down.sql не знайдено у ${MIGRATIONS_REL}/ (hasura.mdc)`)
+    return reporter.getExitCode()
+  }
+
+  for (const file of offenders) {
+    fail(`${file}: down.sql заборонений у ${MIGRATIONS_REL}/ — у директорії міграції має бути лише up.sql (hasura.mdc)`)
+  }
+
+  return reporter.getExitCode()
+}

package/rules/image-avif/docs/index.md

@@ -8,5 +8,4 @@ resource: npm/rules/image-avif/
 
 | Файл                | Тип       |
 | ------------------- | --------- |
-| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

package/rules/image-compress/docs/index.md

@@ -8,5 +8,4 @@ resource: npm/rules/image-compress/
 
 | Файл                | Тип       |
 | ------------------- | --------- |
-| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

package/rules/js/docs/index.md

@@ -8,5 +8,4 @@ resource: npm/rules/js/
 
 | Файл                | Тип       |
 | ------------------- | --------- |
-| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

package/rules/js/js/dep-policy.mjs

@@ -0,0 +1,87 @@
+/** @see ./docs/dep-policy.md */
+import { readFile } from 'node:fs/promises'
+import { join, relative, sep } from 'node:path'
+
+import { parseSync } from 'oxc-parser'
+
+import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
+import { loadCursorIgnorePaths } from '../../../scripts/lib/load-cursor-config.mjs'
+import { walkDir } from '../../../scripts/utils/walkDir.mjs'
+import {
+  dynamicImportModule,
+  langFromPath,
+  requireCallModule,
+  walkAstWithAncestors,
+} from '../../../scripts/utils/ast-scan-utils.mjs'
+
+const JS_SOURCE_RE = /\.(?:[cm]?[jt]sx?)$/u
+
+/** Пакети, заборонені як import-specifier у будь-якому JS/TS-файлі. */
+const BANNED_SPECIFIERS = new Set(['@nitra/as-integrations-fastify'])
+
+/**
+ * Витягає з джерела всі import-specifier'и (static + dynamic + require).
+ * @param {string} source текст файлу
+ * @param {string} filePath шлях до файлу (для вибору мови OXC-парсера)
+ * @returns {string[]} список specifier'ів
+ */
+function extractImportSpecifiers(source, filePath) {
+  /** @type {string[]} */
+  const result = []
+  let parsed
+  try {
+    parsed = parseSync(filePath, source, { lang: langFromPath(filePath) })
+  } catch {
+    return result
+  }
+  for (const imp of parsed?.module?.staticImports ?? []) {
+    if (typeof imp?.moduleRequest?.value === 'string') result.push(imp.moduleRequest.value)
+  }
+  const program = parsed?.program
+  if (program && typeof program === 'object') {
+    walkAstWithAncestors(program, [], node => {
+      const dyn = dynamicImportModule(node)
+      if (dyn !== null) result.push(dyn)
+      const req = requireCallModule(node)
+      if (req !== null) result.push(req)
+    })
+  }
+  return result
+}
+
+/**
+ * Сканує всі JS/TS-файли проєкту на заборонені import-specifier'и (dep-policy.mdc).
+ * @param {string} [cwdParam] корінь репозиторію
+ * @returns {Promise<number>} 0 — чисто, 1 — знайдено заборонені specifier'и
+ */
+export async function check(cwdParam = process.cwd()) {
+  const reporter = createCheckReporter()
+  const cwd = cwdParam
+  const ignorePaths = await loadCursorIgnorePaths(cwd)
+
+  const files = []
+  await walkDir(cwd, p => {
+    if (JS_SOURCE_RE.test(p)) files.push(p)
+  }, ignorePaths)
+
+  let violations = 0
+  for (const absPath of files) {
+    const source = await readFile(absPath, 'utf8')
+    const specifiers = extractImportSpecifiers(source, absPath)
+    for (const spec of specifiers) {
+      if (BANNED_SPECIFIERS.has(spec)) {
+        const rel = relative(cwd, absPath)
+        reporter.fail(
+          `${rel}: заборонений import '${spec}' — використовуй @as-integrations/fastify (js.mdc dep-policy)`
+        )
+        violations += 1
+      }
+    }
+  }
+
+  if (violations === 0) {
+    reporter.pass(`dep-policy: перевірено ${files.length} файлів — заборонених import-specifier'ів немає (js.mdc)`)
+  }
+
+  return reporter.getExitCode()
+}