@nitra/cursor 1.9.20 → 1.9.23

package/CHANGELOG.md

@@ -4,6 +4,30 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
+## [1.9.23] - 2026-05-14
+
+### Fixed
+
+- `npm/package.json#files`: додано негативні glob-патерни `!**/*.test.mjs`, `!**/test-helpers.mjs`, `!**/fixtures/**`, щоб після переїзду тестів у `rules/<rule>/js/`, `scripts/`, `scripts/utils/` вони не потрапляли в опубліковану npm-таrball (вимагає правило `npm-module`).
+- `npm/package.json#devDependencies`: додано `@nitra/cursor: ^1.9.22` (auto-fill від `ensure-nitra-cursor-dev-dependencies.mjs`).
+
+## [1.9.22] - 2026-05-14
+
+### Changed
+
+- **Rule-centric структура пакета.** Кожне правило тепер живе в одній директорії `npm/rules/{rule}/` з усіма своїми артефактами: `{rule}.mdc`, `auto.md` (умова автоактивації), `policy/` (rego-поліси), `js/` (check.mjs + опційні run/lint + co-located *.test.mjs + fixtures/). Видалив каталог правила — правило зникло без слідів у `bin/auto-rules.md`, `npm/policy/`, `npm/scripts/`. Дзеркальна структура для скілів у `npm/skills/{skill}/` (SKILL.md + auto.md + js/).
+- **Тести співрозташовуються з джерелами.** ~50 файлів з `npm/tests/` переїхали в `npm/rules/{rule}/js/*.test.mjs` (тести правил), `npm/scripts/*.test.mjs` (тести інфраструктури), `npm/scripts/utils/*.test.mjs` (тести утиліт). `tests/helpers.mjs` → `scripts/utils/test-helpers.mjs`. `npm/tests/` залишається тільки для 3 крос-правильних інтеграційних тестів.
+- **`bin/n-cursor.js`**: `BUNDLED_MDC_DIR` → `BUNDLED_RULES_DIR`. `discoverBundledRuleNames` і `discoverCheckScripts` тепер обходять підкаталоги `rules/` замість файлів у `mdc/` чи `check-*.mjs` у `scripts/`. Резолвер check-скриптів: `rules/{rule}/js/check.mjs`. `readBundledRuleContent` читає `rules/{rule}/{rule}.mdc`.
+- **`scripts/utils/run-conftest-batch.mjs` та `scripts/lint-conftest.mjs`**: шляхи до rego-полісі — `rules/{rule}/policy/{name}/` (замість `policy/{rule}/{name}/`). Snake_case `policyDirRel` у JS-call sites замінено на kebab-case.
+- **`npm/package.json#files`**: `mdc` і `policy` видалено, додано `rules`. `scripts.test`: `bun test tests` → `bun test` (рекурсивний пошук `*.test.mjs`).
+- **`.cursor/rules/scripts.mdc`** (v1.5): додано секцію «Структура правила» з документацією rule-centric layout для майбутніх правил. Path-references у `npm/CLAUDE.md` оновлено.
+
+### Removed
+
+- `npm/mdc/` (24 файли) — вміст переїхав у `npm/rules/{rule}/{rule}.mdc`.
+- `npm/policy/` (24 каталоги) — вміст переїхав у `npm/rules/{rule}/policy/`.
+- `npm/bin/auto-rules.md`, `npm/bin/auto-skills.md` — замінено на per-rule і per-skill `auto.md` в кожному каталозі.
+
 ## [1.9.20] - 2026-05-14
 
 ### Added

package/bin/n-cursor.js

@@ -21,7 +21,7 @@
  *
  * Якщо у корені репозиторію немає .n-cursor.json, спочатку перейменовується за наявності nitra-cursor.json;
  * у `.cursor/rules` файли `nitra-*.mdc` перейменовуються на `n-*.mdc`; інакше конфіг створюється автоматично
- * з усіма правилами з каталогу mdc пакету (їх можна відредагувати після створення). У файлі завжди має бути
+ * з усіма правилами з каталогу rules/ пакету (їх можна відредагувати після створення). У файлі завжди має бути
  * поле `$schema` з посиланням на JSON Schema пакету (публічний URL для IDE); при зчитуванні конфігу воно додається або виправляється на диску, якщо відсутнє або некоректне.
  * Масиви `rules`, `skills`, `disable-rules` і `disable-skills` при записі сортуються за алфавітом.
  *
@@ -36,7 +36,7 @@
  * `github-actions/` пакету при кожному успішному синку (workflows з правил ga / js-lint / text).
  *
  * Skills копіюються з npm/skills пакету лише для id з масиву «skills» у .n-cursor.json
- * (у JSON — без префікса, як імена файлів у mdc/ без n-). У пакеті джерело — каталоги
+ * (у JSON — без префікса, як імена каталогів у rules/ без n-). У пакеті джерело — каталоги
  * skills/<id>/ (без префікса); у проєкті — .cursor/skills/n-<id>/ (префікс n-, як n-*.mdc).
  * Якщо ключа skills немає, за замовчуванням підтягуються всі підкаталоги skills/ (лише імена без префікса n-).
  * Зайві каталоги n-* у .cursor/skills, яких немає у списку, видаляються.
@@ -67,7 +67,7 @@ import {
 import { detectAutoSkills } from '../scripts/auto-skills.mjs'
 import { runStopHookCli } from '../scripts/claude-stop-hook.mjs'
 import { ensureNitraCursorInRootDevDependencies } from '../scripts/ensure-nitra-cursor-dev-dependencies.mjs'
-import { runLintGaCli } from '../scripts/lint-ga.mjs'
+import { runLintGaCli } from '../rules/ga/js/lint.mjs'
 import { syncClaudeConfig } from '../scripts/sync-claude-config.mjs'
 import { upgradeNitraCursorToLatestAndBunInstall } from '../scripts/upgrade-nitra-cursor-and-install.mjs'
 import { runRenameYamlExtensionsCli } from './rename-yaml-extensions.mjs'
@@ -85,11 +85,11 @@ const COMMANDS_DIR = '.claude/commands'
 const RULE_PREFIX = 'n-'
 
 const binDir = dirname(fileURLToPath(import.meta.url))
-const BUNDLED_MDC_DIR = join(binDir, '..', 'mdc')
+const BUNDLED_RULES_DIR = join(binDir, '..', 'rules')
 const BUNDLED_SCRIPTS_DIR = join(binDir, '..', 'scripts')
 const BUNDLED_SKILLS_DIR = join(binDir, '..', 'skills')
 const BUNDLED_AGENTS_TEMPLATE_PATH = join(binDir, '..', AGENTS_TEMPLATE_FILE)
-/** Корінь установленого пакету (каталог з `mdc/`, `github-actions/`, …) */
+/** Корінь установленого пакету (каталог з `rules/`, `github-actions/`, …) */
 const BUNDLED_PACKAGE_ROOT = join(binDir, '..')
 
 const YAML_FRONTMATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---/
@@ -116,25 +116,27 @@ function sortConfigIdArrays(config) {
 }
 
 /**
- * Імена правил (без .mdc) з каталогу mdc поточної інсталяції пакету
- * @param {string} [bundledMdcDir] каталог `mdc/` у корені пакету (за замовчуванням — з поточного процесу)
- * @returns {Promise<string[]>} відсортовані імена файлів правил без суфікса .mdc
+ * Імена правил з каталогу `rules/` поточної інсталяції пакету. Кожне правило — окремий
+ * підкаталог `rules/<id>/`, у якому має бути `<id>.mdc`.
+ * @param {string} [bundledRulesDir] каталог `rules/` у корені пакету
+ * @returns {Promise<string[]>} відсортовані id правил (імена підкаталогів)
  */
-async function discoverBundledRuleNames(bundledMdcDir = BUNDLED_MDC_DIR) {
-  if (!existsSync(bundledMdcDir)) {
+async function discoverBundledRuleNames(bundledRulesDir = BUNDLED_RULES_DIR) {
+  if (!existsSync(bundledRulesDir)) {
     throw new Error(
       `Не знайдено каталог правил пакету.\n` +
-        `Очікуваний шлях: ${bundledMdcDir}\n` +
+        `Очікуваний шлях: ${bundledRulesDir}\n` +
         `Перевстановіть ${PACKAGE_NAME} або створіть ${CONFIG_FILE} вручну.`
     )
   }
-  const names = await readdir(bundledMdcDir)
-  const rules = names
-    .filter(n => n.endsWith('.mdc'))
-    .map(n => n.slice(0, -'.mdc'.length))
+  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`)))
+    .map(e => e.name)
     .toSorted((a, b) => a.localeCompare(b))
   if (rules.length === 0) {
-    throw new Error(`У каталозі mdc пакету немає файлів .mdc. Створіть ${CONFIG_FILE} вручну.`)
+    throw new Error(`У каталозі rules/ пакету немає підкаталогів з <id>.mdc. Створіть ${CONFIG_FILE} вручну.`)
   }
   return rules
 }
@@ -203,15 +205,15 @@ async function migrateLegacyConfigIfNeeded() {
 
 /**
  * Зчитує конфіг .n-cursor.json з поточної директорії
- * @param {{ bundledMdcDir?: string, bundledSkillsDir?: string }} [paths] каталоги з пакету-джерела (після `bun i` — зазвичай `node_modules/@nitra/cursor`)
+ * @param {{ bundledRulesDir?: string, bundledSkillsDir?: string }} [paths] каталоги з пакету-джерела (після `bun i` — зазвичай `node_modules/@nitra/cursor`)
  * @returns {Promise<{ $schema: string, rules: string[], skills: string[], version?: string } & Record<string, unknown>>} rules, skills (id без префікса n-); поле version у файлі за наявності ігнорується при синхронізації правил
  */
 async function readConfig(paths = {}) {
-  const bundledMdcDir = paths.bundledMdcDir ?? BUNDLED_MDC_DIR
+  const bundledRulesDir = paths.bundledRulesDir ?? BUNDLED_RULES_DIR
   const bundledSkillsDir = paths.bundledSkillsDir ?? BUNDLED_SKILLS_DIR
   await migrateLegacyConfigIfNeeded()
   const configPath = join(cwd(), CONFIG_FILE)
-  const availableRules = await discoverBundledRuleNames(bundledMdcDir)
+  const availableRules = await discoverBundledRuleNames(bundledRulesDir)
   const availableSkills = await discoverBundledSkillNames(bundledSkillsDir)
 
   /**
@@ -231,7 +233,7 @@ async function readConfig(paths = {}) {
   }
 
   /**
-   * Автодописує правила/skills за `auto-rules.md` і синхронізує `$schema`.
+   * Автодописує правила/skills за `rules/<rule>/auto.md` і синхронізує `$schema`.
    * @param {Record<string, unknown>} parsedConfig сирий обʼєкт конфігу
    * @returns {Promise<Record<string, unknown>>} нормалізований конфіг
    */
@@ -350,29 +352,31 @@ function logRuleMigrationsIfAny(parsedConfig) {
 }
 
 /**
- * Витягує чисте ім'я файлу правила (без шляху, але зберігає .mdc)
- * "npm/mdc/text.mdc" → "text.mdc"
- * "text"             → "text.mdc"
+ * Витягує чистий id правила без шляху і без .mdc.
+ * "npm/rules/text/text.mdc" → "text"
+ * "text.mdc"                → "text"
+ * "text"                    → "text"
  * @param {string} ruleName шлях або базове ім'я, з суфіксом .mdc або без
- * @returns {string} лише ім'я файлу з суфіксом .mdc
+ * @returns {string} id правила (без .mdc, без шляху)
  */
 function normalizeRuleName(ruleName) {
-  const name = ruleName.endsWith('.mdc') ? ruleName : `${ruleName}.mdc`
-  return basename(name)
+  const name = basename(String(ruleName).trim())
+  return name.endsWith('.mdc') ? name.slice(0, -'.mdc'.length) : name
 }
 
 /**
- * Читає вміст правила з каталогу `mdc/` установленого пакету (наприклад `node_modules/@nitra/cursor/mdc` або кеш npx).
+ * Читає вміст правила з каталогу `rules/<id>/<id>.mdc` установленого пакету
+ * (наприклад `node_modules/@nitra/cursor/rules/<id>/<id>.mdc` або кеш npx).
  * @param {string} rule елемент масиву rules з `.n-cursor.json`
- * @param {string} [bundledMdcDir] каталог `mdc/` у корені пакету-джерела
+ * @param {string} [bundledRulesDir] каталог `rules/` у корені пакету-джерела
  * @returns {Promise<string>} текст правила для запису в `.cursor/rules/n-*.mdc`
  */
-function readBundledRuleContent(rule, bundledMdcDir = BUNDLED_MDC_DIR) {
-  const bundledName = normalizeRuleName(rule)
-  const bundledPath = join(bundledMdcDir, bundledName)
+function readBundledRuleContent(rule, bundledRulesDir = BUNDLED_RULES_DIR) {
+  const id = normalizeRuleName(rule)
+  const bundledPath = join(bundledRulesDir, id, `${id}.mdc`)
   if (!existsSync(bundledPath)) {
     throw new Error(
-      `Немає файлу ${bundledName} у ${bundledMdcDir}. Оновіть ${PACKAGE_NAME} або приберіть "${rule}" з rules у ${CONFIG_FILE}.`
+      `Немає файлу ${id}/${id}.mdc у ${bundledRulesDir}. Оновіть ${PACKAGE_NAME} або приберіть "${rule}" з rules у ${CONFIG_FILE}.`
     )
   }
   return readFile(bundledPath, 'utf8')
@@ -515,7 +519,7 @@ async function listProjectRulesMdcFiles() {
  * @returns {Set<string>} множина очікуваних імен файлів (наприклад n-bun.mdc)
  */
 function expectedManagedRuleBasenames(configRules) {
-  return new Set(configRules.map(rule => `${RULE_PREFIX}${normalizeRuleName(rule)}`))
+  return new Set(configRules.map(rule => `${RULE_PREFIX}${normalizeRuleName(rule)}.mdc`))
 }
 
 /**
@@ -939,19 +943,19 @@ async function runSyncStep(prefix, action) {
 /**
  * Копіює керовані `.mdc` файли з пакету до `.cursor/rules`.
  * @param {string[]} rules список rules з конфігу
- * @param {string} bundledMdcDir каталог `mdc` пакету-джерела
+ * @param {string} bundledRulesDir каталог `mdc` пакету-джерела
  * @param {string} rulesDir абсолютний шлях до `.cursor/rules`
  * @returns {Promise<{ successCount: number, failCount: number }>} статистика копіювання
  */
-async function syncManagedRuleFiles(rules, bundledMdcDir, rulesDir) {
+async function syncManagedRuleFiles(rules, bundledRulesDir, rulesDir) {
   let successCount = 0
   let failCount = 0
   for (const rule of rules) {
-    const fileName = `${RULE_PREFIX}${normalizeRuleName(rule)}`
+    const fileName = `${RULE_PREFIX}${normalizeRuleName(rule)}.mdc`
     const destPath = join(rulesDir, fileName)
     try {
       process.stdout.write(`  ⬇  ${rule} → ${RULES_DIR}/${fileName} ... `)
-      const content = await readBundledRuleContent(rule, bundledMdcDir)
+      const content = await readBundledRuleContent(rule, bundledRulesDir)
       await writeFile(destPath, content, 'utf8')
       console.log(`✅`)
       successCount++
@@ -982,15 +986,17 @@ function logRemovedManagedItems(title, basePath, names) {
 }
 
 /**
- * Знаходить доступні check-скрипти у каталозі scripts пакету
- * @returns {Promise<string[]>} відсортовані імена правил (наприклад ['bun', 'ga', 'js-lint'])
+ * Знаходить доступні check-скрипти. Кожне правило з check-скриптом тримає його у
+ * `rules/<id>/js/check.mjs` (rule-centric layout).
+ * @returns {Promise<string[]>} відсортовані id правил, для яких є check.mjs
  */
 async function discoverCheckScripts() {
-  if (!existsSync(BUNDLED_SCRIPTS_DIR)) return []
-  const names = await readdir(BUNDLED_SCRIPTS_DIR)
-  return names
-    .filter(n => n.startsWith('check-') && n.endsWith('.mjs'))
-    .map(n => n.slice('check-'.length, -'.mjs'.length))
+  if (!existsSync(BUNDLED_RULES_DIR)) return []
+  const entries = await readdir(BUNDLED_RULES_DIR, { withFileTypes: true })
+  return entries
+    .filter(e => e.isDirectory() && !e.name.startsWith('.'))
+    .filter(e => existsSync(join(BUNDLED_RULES_DIR, e.name, 'js', 'check.mjs')))
+    .map(e => e.name)
     .toSorted((a, b) => a.localeCompare(b))
 }
 
@@ -1090,10 +1096,10 @@ async function runChecks(requestedRules) {
   let totalFailed = 0
 
   for (const rule of rulesToCheck) {
-    const scriptPath = join(BUNDLED_SCRIPTS_DIR, `check-${rule}.mjs`)
+    const scriptPath = join(BUNDLED_RULES_DIR, rule, 'js', 'check.mjs')
     console.log(`📋 ${rule}:`)
     try {
-      // eslint-disable-next-line no-unsanitized/method -- rule валідовано проти available, scriptPath будується з фіксованої BUNDLED_SCRIPTS_DIR
+      // eslint-disable-next-line no-unsanitized/method -- rule валідовано проти available, scriptPath будується з фіксованої BUNDLED_RULES_DIR
       const { check } = await import(scriptPath)
       const code = await check()
       if (code !== 0) totalFailed++
@@ -1201,11 +1207,11 @@ async function runSync() {
 
   await reexecIfPackageVersionChanged(effectivePackageRoot)
 
-  const bundledMdcDir = join(effectivePackageRoot, 'mdc')
+  const bundledRulesDir = join(effectivePackageRoot, 'mdc')
   const bundledSkillsDir = join(effectivePackageRoot, 'skills')
   const bundledAgentsTemplatePath = join(effectivePackageRoot, AGENTS_TEMPLATE_FILE)
 
-  const config = await runSyncStep('❌ ', () => readConfig({ bundledMdcDir, bundledSkillsDir }))
+  const config = await runSyncStep('❌ ', () => readConfig({ bundledRulesDir, bundledSkillsDir }))
 
   const { rules, skills, version, ignore } = config
   const claudeConfigEnabled = config['claude-config'] !== false
@@ -1230,7 +1236,7 @@ async function runSync() {
 
   const rulesDir = join(cwd(), RULES_DIR)
   await mkdir(rulesDir, { recursive: true })
-  const { successCount, failCount } = await syncManagedRuleFiles(rules, bundledMdcDir, rulesDir)
+  const { successCount, failCount } = await syncManagedRuleFiles(rules, bundledRulesDir, rulesDir)
 
   await runSyncStep(`❌ Не вдалося прибрати зайві файли в ${RULES_DIR}: `, async () => {
     const removed = await removeOrphanManagedRuleFiles(rulesDir, rules)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "1.9.20",
+  "version": "1.9.23",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",
@@ -24,21 +24,23 @@
   },
   "files": [
     "types",
-    "mdc",
+    "rules",
     "bin",
     "github-actions",
-    "policy",
     "schemas",
     "scripts",
     "skills",
     ".claude-template",
     "AGENTS.template.md",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "!**/*.test.mjs",
+    "!**/test-helpers.mjs",
+    "!**/fixtures/**"
   ],
   "type": "module",
   "types": "./types/bin/n-cursor.d.ts",
   "scripts": {
-    "test": "bun test tests",
+    "test": "bun test",
     "rename-yaml-extensions": "bun ./bin/n-cursor.js rename-yaml-extensions"
   },
   "dependencies": {
@@ -48,5 +50,8 @@
   "engines": {
     "bun": ">=1.3",
     "node": ">=25"
+  },
+  "devDependencies": {
+    "@nitra/cursor": "^1.9.22"
   }
 }

package/rules/abie/auto.md

@@ -0,0 +1 @@
+якщо в кореневому package.json в секції "repository" присутній текст "<https://github.com/abinbevefes/**/>"

package/{scripts/check-abie.mjs → rules/abie/js/check.mjs}

@@ -45,11 +45,11 @@ import { basename, dirname, join, relative } from 'node:path'
 
 import { parseAllDocuments } from 'yaml'
 
-import { pathHasK8sSegment } from './check-k8s.mjs'
-import { createCheckReporter } from './utils/check-reporter.mjs'
-import { loadCursorIgnorePaths } from './utils/load-cursor-config.mjs'
-import { runConftestBatch } from './utils/run-conftest-batch.mjs'
-import { walkDir } from './utils/walkDir.mjs'
+import { pathHasK8sSegment } from '../../k8s/js/check.mjs'
+import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
+import { loadCursorIgnorePaths } from '../../../scripts/utils/load-cursor-config.mjs'
+import { runConftestBatch } from '../../../scripts/utils/run-conftest-batch.mjs'
+import { walkDir } from '../../../scripts/utils/walkDir.mjs'
 
 const CONFIG_FILE = '.n-cursor.json'
 

package/{scripts/check-adr.mjs → rules/adr/js/check.mjs}

@@ -19,7 +19,7 @@ import { delimiter, dirname, join } from 'node:path'
 import { env } from 'node:process'
 import { fileURLToPath } from 'node:url'
 
-import { createCheckReporter } from './utils/check-reporter.mjs'
+import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
 
 const PROJECT_HOOK_PATH = '.claude/hooks/capture-decisions.sh'
 const PROJECT_SETTINGS_PATH = '.claude/settings.json'

package/rules/bun/auto.md

@@ -0,0 +1 @@
+якщо в корені проекту є package.json

package/{scripts/check-bun.mjs → rules/bun/js/check.mjs}

@@ -18,7 +18,7 @@
 import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
 
-import { createCheckReporter } from './utils/check-reporter.mjs'
+import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
 
 // Перевірка `devDependencies` кореневого `package.json` (дозволено лише `@nitra/*`)
 // — у rego (`npm/policy/bun/package_json/`). JS-копії `isAllowedRootDevDependency`

package/rules/capacitor/auto.md

@@ -0,0 +1 @@
+якщо в проекті є хоч один файл capacitor.config.json

package/{scripts/check-capacitor.mjs → rules/capacitor/js/check.mjs}

@@ -25,7 +25,7 @@ import { existsSync } from 'node:fs'
 import { readdir, readFile } from 'node:fs/promises'
 import { join, relative } from 'node:path'
 
-import { createCheckReporter } from './utils/check-reporter.mjs'
+import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
 
 /** Мінімальна допустима мажорна версія Capacitor (capacitor.mdc) */
 const MIN_CAPACITOR_MAJOR = 8

package/rules/changelog/auto.md

@@ -0,0 +1 @@
+[bun]

package/{scripts/check-changelog.mjs → rules/changelog/js/check.mjs}

@@ -27,8 +27,8 @@ import { readFile } from 'node:fs/promises'
 import { join } from 'node:path'
 import { promisify } from 'node:util'
 
-import { createCheckReporter } from './utils/check-reporter.mjs'
-import { getMonorepoPackageRootDirs } from './utils/workspaces.mjs'
+import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
+import { getMonorepoPackageRootDirs } from '../../../scripts/utils/workspaces.mjs'
 
 const execFileAsync = promisify(execFile)
 

package/rules/docker/auto.md

@@ -0,0 +1 @@
+якщо в проекті є хоч один Dockerfile

package/{scripts/check-docker.mjs → rules/docker/js/check.mjs}

@@ -30,11 +30,11 @@
 import { readFile } from 'node:fs/promises'
 import { basename } from 'node:path'
 
-import { getMirrorGcrHint, getFromImageToken } from './utils/docker-mirror.mjs'
-import { lintDockerfileWithHadolint, posixRel } from './utils/docker-hadolint.mjs'
-import { createCheckReporter } from './utils/check-reporter.mjs'
-import { loadCursorIgnorePaths } from './utils/load-cursor-config.mjs'
-import { walkDir } from './utils/walkDir.mjs'
+import { getMirrorGcrHint, getFromImageToken } from '../../../scripts/utils/docker-mirror.mjs'
+import { lintDockerfileWithHadolint, posixRel } from '../../../scripts/utils/docker-hadolint.mjs'
+import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
+import { loadCursorIgnorePaths } from '../../../scripts/utils/load-cursor-config.mjs'
+import { walkDir } from '../../../scripts/utils/walkDir.mjs'
 
 const NEWLINE_RE = /\r?\n/
 const BUN_INSTALL_RE = /\bbun\s+(?:install|i)\b/iu

package/{scripts/run-docker.mjs → rules/docker/js/run.mjs}

@@ -9,11 +9,11 @@
  */
 import { basename } from 'node:path'
 
-import { isRunAsCli } from './cli-entry.mjs'
-import { lintDockerfileWithHadolint, posixRel } from './utils/docker-hadolint.mjs'
-import { createCheckReporter } from './utils/check-reporter.mjs'
-import { loadCursorIgnorePaths } from './utils/load-cursor-config.mjs'
-import { walkDir } from './utils/walkDir.mjs'
+import { isRunAsCli } from '../../../scripts/cli-entry.mjs'
+import { lintDockerfileWithHadolint, posixRel } from '../../../scripts/utils/docker-hadolint.mjs'
+import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
+import { loadCursorIgnorePaths } from '../../../scripts/utils/load-cursor-config.mjs'
+import { walkDir } from '../../../scripts/utils/walkDir.mjs'
 
 /**
  * Чи входить файл до набору lint-docker: Dockerfile або *.Dockerfile (*.dockerfile).

package/rules/ga/auto.md

@@ -0,0 +1 @@
+якщо присутня директорія .github/workflows

package/{scripts/check-ga.mjs → rules/ga/js/check.mjs}

@@ -19,10 +19,10 @@ import { readdir, readFile } from 'node:fs/promises'
 import { execFileSync } from 'node:child_process'
 import { join } from 'node:path'
 
-import { createCheckReporter } from './utils/check-reporter.mjs'
-import { eventPathsIncludeExact, parseWorkflowYaml } from './utils/gha-workflow.mjs'
-import { resolveCmd } from './utils/resolve-cmd.mjs'
-import { runConftestBatch } from './utils/run-conftest-batch.mjs'
+import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
+import { eventPathsIncludeExact, parseWorkflowYaml } from '../../../scripts/utils/gha-workflow.mjs'
+import { resolveCmd } from '../../../scripts/utils/resolve-cmd.mjs'
+import { runConftestBatch } from '../../../scripts/utils/run-conftest-batch.mjs'
 
 /** Шаблони наявності MegaLinter у вмісті workflow */
 const MEGALINTER_USE_PATTERNS = [/oxsecurity\/megalinter-action/i, /megalinter\/megalinter/i]

package/{scripts/lint-ga.mjs → rules/ga/js/lint.mjs}

@@ -22,8 +22,8 @@
 import { spawnSync } from 'node:child_process'
 import { platform } from 'node:process'
 
-import { check as checkGa } from './check-ga.mjs'
-import { resolveCmd } from './utils/resolve-cmd.mjs'
+import { check as checkGa } from './check.mjs'
+import { resolveCmd } from '../../../scripts/utils/resolve-cmd.mjs'
 
 /**
  * Опис залежності preflight-ом: бінарник, для чого потрібен, і команди встановлення.

package/rules/graphql/auto.md

@@ -0,0 +1 @@
+якщо хоч в одному js або vue файлі присутній gql` темплейт літерал

package/{scripts/check-graphql.mjs → rules/graphql/js/check.mjs}

@@ -10,15 +10,15 @@ import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
 import { relative } from 'node:path'
 
-import { createCheckReporter } from './utils/check-reporter.mjs'
+import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
 import {
   isGqlScanSourceFile,
   shouldSkipFileForGqlScan,
   sourceFileHasGqlTaggedTemplate
-} from './utils/graphql-gql-scan.mjs'
-import { loadCursorIgnorePaths } from './utils/load-cursor-config.mjs'
-import { runConftestBatch } from './utils/run-conftest-batch.mjs'
-import { walkDir } from './utils/walkDir.mjs'
+} from '../../../scripts/utils/graphql-gql-scan.mjs'
+import { loadCursorIgnorePaths } from '../../../scripts/utils/load-cursor-config.mjs'
+import { runConftestBatch } from '../../../scripts/utils/run-conftest-batch.mjs'
+import { walkDir } from '../../../scripts/utils/walkDir.mjs'
 
 /** Очікуваний файл GraphQL Config у корені (graphql.mdc). */
 export const GRAPHQL_RC_FILENAME = '.graphqlrc.yml'

package/rules/hasura/auto.md

@@ -0,0 +1 @@
+якщо в директорії присутній config.yaml, який містить рядок `metadata_directory: metadata`

package/{scripts/check-hasura.mjs → rules/hasura/js/check.mjs}

@@ -27,10 +27,10 @@ import { basename, join, relative } from 'node:path'
 
 import { parseAllDocuments } from 'yaml'
 
-import { getRepositoryUrl } from './auto-rules.mjs'
-import { createCheckReporter } from './utils/check-reporter.mjs'
-import { loadCursorIgnorePaths } from './utils/load-cursor-config.mjs'
-import { walkDir } from './utils/walkDir.mjs'
+import { getRepositoryUrl } from '../../../scripts/auto-rules.mjs'
+import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
+import { loadCursorIgnorePaths } from '../../../scripts/utils/load-cursor-config.mjs'
+import { walkDir } from '../../../scripts/utils/walkDir.mjs'
 
 const NITRA_REPOSITORY_URL_MARKER = 'https://github.com/nitra/'
 const ABIE_REPOSITORY_URL_MARKER = 'https://github.com/abinbevefes/'

package/rules/image-avif/auto.md

@@ -0,0 +1 @@
+[vue, image-compress]

package/{scripts/check-image-avif.mjs → rules/image-avif/js/check.mjs}

@@ -25,11 +25,11 @@ import { join, relative } from 'node:path'
 import { spawnSync } from 'node:child_process'
 import { env } from 'node:process'
 
-import { createCheckReporter } from './utils/check-reporter.mjs'
-import { loadCursorIgnorePaths } from './utils/load-cursor-config.mjs'
-import { resolveCmd } from './utils/resolve-cmd.mjs'
-import { walkDir } from './utils/walkDir.mjs'
-import { getMonorepoPackageRootDirs } from './utils/workspaces.mjs'
+import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
+import { loadCursorIgnorePaths } from '../../../scripts/utils/load-cursor-config.mjs'
+import { resolveCmd } from '../../../scripts/utils/resolve-cmd.mjs'
+import { walkDir } from '../../../scripts/utils/walkDir.mjs'
+import { getMonorepoPackageRootDirs } from '../../../scripts/utils/workspaces.mjs'
 
 /** Імʼя CLI-пакета, який генерує AVIF. */
 const MINIFY_PACKAGE_NAME = '@nitra/minify-image'

package/rules/image-compress/auto.md

@@ -0,0 +1 @@
+[bun]

package/{scripts/check-image-compress.mjs → rules/image-compress/js/check.mjs}

@@ -19,7 +19,7 @@
 import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
 
-import { createCheckReporter } from './utils/check-reporter.mjs'
+import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
 
 /** Імʼя committed-кешу (sha1 + originalSize + size) у `@nitra/minify-image` ≥ 3.2.0. */
 const HASH_CACHE_FILENAME = '.n-minify-image.tsv'

package/rules/js-bun-db/auto.md

@@ -0,0 +1 @@
+якщо в хоч одному package.json в секції dependencies присутній пакет pg, pg-format або mysql2 або є імпорт sql/SQL з Bun (приклад: import { sql } from "bun")

package/{scripts/check-js-bun-db.mjs → rules/js-bun-db/js/check.mjs}

@@ -25,7 +25,7 @@ import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
 import { join, relative } from 'node:path'
 
-import { createCheckReporter } from './utils/check-reporter.mjs'
+import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
 import {
   findBunSqlPerRequestConnectionInText,
   findBunSqlPgLeftoverCallInText,
@@ -36,10 +36,10 @@ import {
   findUnsafeBunSqlInListMissingEmptyGuardInText,
   isBunSqlScanSourceFile,
   textHasBunSqlImport
-} from './utils/bun-sql-scan.mjs'
-import { findAllPackageJsonPaths } from './utils/find-package-json-paths.mjs'
-import { loadCursorIgnorePaths } from './utils/load-cursor-config.mjs'
-import { walkDir } from './utils/walkDir.mjs'
+} from '../../../scripts/utils/bun-sql-scan.mjs'
+import { findAllPackageJsonPaths } from '../../../scripts/utils/find-package-json-paths.mjs'
+import { loadCursorIgnorePaths } from '../../../scripts/utils/load-cursor-config.mjs'
+import { walkDir } from '../../../scripts/utils/walkDir.mjs'
 
 /**
  * Збирає абсолютні шляхи JS/TS джерел у репозиторії для скану Bun SQL патернів.

package/rules/js-bun-redis/auto.md

@@ -0,0 +1 @@
+якщо в хоч одному package.json в секції dependencies присутній пакет ioredis або node-redis

package/{scripts/check-js-bun-redis.mjs → rules/js-bun-redis/js/check.mjs}

@@ -14,10 +14,10 @@ import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
 import { join, relative } from 'node:path'
 
-import { createCheckReporter } from './utils/check-reporter.mjs'
-import { loadCursorIgnorePaths } from './utils/load-cursor-config.mjs'
-import { findRedisImportsInText, isRedisScanSourceFile, shouldSkipFileForRedisScan } from './utils/redis-imports.mjs'
-import { walkDir } from './utils/walkDir.mjs'
+import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
+import { loadCursorIgnorePaths } from '../../../scripts/utils/load-cursor-config.mjs'
+import { findRedisImportsInText, isRedisScanSourceFile, shouldSkipFileForRedisScan } from '../../../scripts/utils/redis-imports.mjs'
+import { walkDir } from '../../../scripts/utils/walkDir.mjs'
 
 /**
  * Збирає абсолютні шляхи JS/TS джерел у репозиторії для скану заборонених redis-імпортів.

package/rules/js-lint/auto.md

@@ -0,0 +1 @@
+якщо присутній хоч один js файл

package/{scripts/check-js-lint.mjs → rules/js-lint/js/check.mjs}

@@ -16,7 +16,7 @@ import { copyFile, readFile } from 'node:fs/promises'
 import { dirname, join } from 'node:path'
 import { fileURLToPath } from 'node:url'
 
-import { createCheckReporter } from './utils/check-reporter.mjs'
+import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
 
 /** Шлях до канонічного oxlint JSON у цьому пакеті (для перевірки та тестів). */
 export const OXLINT_CANONICAL_JSON_PATH = join(

package/rules/js-mssql/auto.md

@@ -0,0 +1 @@
+якщо в хоч одному package.json в секції dependencies присутній пакет mssql