@nitra/cursor 1.15.1 → 1.16.0

package/CHANGELOG.md

@@ -4,6 +4,18 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
+## [1.16.0] - 2026-05-24
+
+### Changed
+
+- **`utils/` vs `lib/` (js-lint.mdc):** усі 10 каталогів `npm/rules/<rule>/utils/` перейменовано в `npm/rules/<rule>/lib/` — їхній вміст domain-bound (запускає hadolint, парсить kustomize/k8s-tree, конкретні AST-сканери правила, читання `.n-cursor.json` тощо), що за правилом `utils/` vs `lib/` має жити в `lib/`. Зачеплені правила: `abie`, `changelog`, `docker`, `graphql`, `js-bun-db`, `js-lint`, `js-mssql`, `js-run`, `rust`, `vue`. Тести й `__fixtures__/` переїхали разом із батьківським каталогом. 26 внутрішніх `'../utils/'`-імпортів у `js/`/`lint/` і 3 зовнішніх з `npm/scripts/auto-rules.mjs` оновлено на `'../lib/'` / `'../<rule>/lib/'`. JSDoc-шлях у `npm/rules/js-lint/lib/rebuild-oxlint-canonical.mjs` (приклад запуску) і JSDoc-натяк у `npm/rules/rust/lib/has-cargo-toml.mjs` теж оновлені.
+- **`npm/scripts/utils/` розщеплено на `utils/` + `lib/`:** 19 файлів (`run-rule`, `run-rule-cli`, `run-standard-rule`, `run-standard-lint`, `run-lint-step`, `run-conftest-batch`, `discover-checkable-rules`, `discover-check-rules-from-cursor`, `list-rule-ids`, `load-cursor-config`, `read-n-cursor-config-lite`, `resolve-target-files`, `check-mdc-template-refs`, `check-reporter`, `gha-workflow`, `generated-markdown`, `inline-template-links`, `template`, `workspaces`) і 14 відповідних тестів + `__fixtures__/` переїхали у `npm/scripts/lib/`. У `npm/scripts/utils/` залишилися 9 справді generic-файлів (`ast-scan-utils`, `find-package-json-paths`, `pass`, `resolve-cmd`, `test-helpers`, `walk-cache`, `walkDir`, `with-lock`, `worktree-fingerprint`) + 4 їхні тести. `~220` імпортів `scripts/utils/<lib-file>` по всьому `npm/` оновлено на `scripts/lib/<lib-file>`; внутрішні lib→utils переходи (`check-reporter→pass`, `resolve-target-files→walkDir`, `run-conftest-batch→resolve-cmd`, `run-lint-step→resolve-cmd`, `run-rule-cli→walk-cache`, `run-standard-lint→with-lock`, `run-standard-rule→walk-cache,with-lock`) переписані на `'../utils/<file>'`; lib-тести з залежністю від `test-helpers` — на `'../../utils/test-helpers.mjs'`.
+- **`scripts/utils/redis-imports.mjs` → `npm/rules/js-bun-redis/lib/redis-imports.mjs`** (+тест). Симетрично до `bunyan-imports`/`vue-forbidden-imports`: per-rule сканер живе в самому правилі, а не в спільних скриптах. Імпорт `scripts/utils/ast-scan-utils.mjs` зберігся (це справді generic helper).
+
+### Added
+
+- **Новий концерн `js-lint.utils_imports`** (`npm/rules/js-lint/js/utils_imports.mjs`): обходить кожен `utils/`-каталог у monorepo-воркспейсах і падає, якщо знаходить relative-імпорт з `..` у не-тестовому `.[cm]?[jt]sx?`-файлі. Дозволені лише same-dir (`./X`), bare-пакети та `node:*`; cross-rule, конфіги проєкту чи sibling-utils → fail з підказкою «перенеси у `lib/`». Тести (`*.test.mjs`) і будь-який `__fixtures__/` пропускаються — тестам легально треба `../X`. У `js-lint.mdc` під секцією «Структура спільних модулів: `utils/` vs `lib/`» додано абзац про автоматичну перевірку.
+
 ## [1.15.1] - 2026-05-24
 
 ### Fixed

package/bin/n-cursor.js

@@ -70,8 +70,8 @@ import { cwd, env } from 'node:process'
 import { fileURLToPath } from 'node:url'
 
 import { buildAgentsCommandBulletItems } from '../scripts/build-agents-commands.mjs'
-import { formatGeneratedMarkdownLines, renderAgentsTemplate } from '../scripts/utils/generated-markdown.mjs'
-import { inlineTemplateLinks } from '../scripts/utils/inline-template-links.mjs'
+import { formatGeneratedMarkdownLines, renderAgentsTemplate } from '../scripts/lib/generated-markdown.mjs'
+import { inlineTemplateLinks } from '../scripts/lib/inline-template-links.mjs'
 import {
   detectAutoRules,
   detectLegacyRuleIds,
@@ -81,8 +81,8 @@ import {
 } from '../scripts/auto-rules.mjs'
 import { detectAutoSkills } from '../scripts/auto-skills.mjs'
 import { runStopHookCli } from '../scripts/claude-stop-hook.mjs'
-import { discoverCheckRulesFromCursorRules } from '../scripts/utils/discover-check-rules-from-cursor.mjs'
-import { listRuleIds } from '../scripts/utils/list-rule-ids.mjs'
+import { discoverCheckRulesFromCursorRules } from '../scripts/lib/discover-check-rules-from-cursor.mjs'
+import { listRuleIds } from '../scripts/lib/list-rule-ids.mjs'
 import { ensureNitraCursorInRootDevDependencies } from '../scripts/ensure-nitra-cursor-dev-dependencies.mjs'
 import { runLintDocker } from '../rules/docker/lint/lint.mjs'
 import { runLintGaCli } from '../rules/ga/lint/lint.mjs'

package/package.json

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

package/rules/abie/fix.mjs

@@ -1,9 +1,9 @@
-import { runStandardRule } from '../../scripts/utils/run-standard-rule.mjs'
+import { runStandardRule } from '../../scripts/lib/run-standard-rule.mjs'
 
 /**
  * Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
  * Library mode: викликається CLI orchestration через `import + run(ctx)`.
- * @param {import('../../scripts/utils/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
+ * @param {import('../../scripts/lib/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
  * @returns {Promise<number>} 0 — OK, 1 — порушення
  */
 export function run(ctx) {
@@ -13,7 +13,7 @@ export function run(ctx) {
 if (import.meta.main) {
   // Standalone: bun rules/<id>/fix.mjs — повний еквівалент `npx @nitra/cursor fix <id>`
   // (config-loading + whitelist + summary). Дві ролі fix.mjs: library (run) + standalone (main).
-  const { runRuleCli } = await import('../../scripts/utils/run-rule-cli.mjs')
+  const { runRuleCli } = await import('../../scripts/lib/run-rule-cli.mjs')
   // eslint-disable-next-line unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
   process.exit(await runRuleCli(import.meta.dirname))
 }

package/rules/abie/js/applies.mjs

@@ -3,9 +3,9 @@
  * Якщо повертає `false` — CLI пропускає всі концерни (JS і policy) цього правила.
  * `check()` друкує тільки context-pass; решта концернів роблять справжню роботу.
  */
-import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
+import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
 
-import { isAbieRuleEnabled } from '../utils/enabled.mjs'
+import { isAbieRuleEnabled } from '../lib/enabled.mjs'
 
 /**
  * @returns {Promise<boolean>} `true` — правило застосовне; `false` — пропустити

package/rules/abie/js/env_dns.mjs

@@ -9,10 +9,10 @@
 import { readFile } from 'node:fs/promises'
 import { basename, relative } from 'node:path'
 
-import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
-import { loadCursorIgnorePaths } from '../../../scripts/utils/load-cursor-config.mjs'
+import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
+import { loadCursorIgnorePaths } from '../../../scripts/lib/load-cursor-config.mjs'
 
-import { abieEnvNameFromBasename, collectAbieEnvFiles, validateAbieEnvInternalUrls } from '../utils/env-dns.mjs'
+import { abieEnvNameFromBasename, collectAbieEnvFiles, validateAbieEnvInternalUrls } from '../lib/env-dns.mjs'
 
 /**
  * @returns {Promise<number>} результат

package/rules/abie/js/firebase_hosting.mjs

@@ -7,7 +7,7 @@ import { existsSync } from 'node:fs'
 import { readdir } from 'node:fs/promises'
 import { join } from 'node:path'
 
-import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
+import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
 
 const SKIP_TOP_DIR_NAMES = new Set(['.git', 'node_modules'])
 

package/rules/abie/js/hc_pairing.mjs

@@ -10,11 +10,11 @@ import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
 import { relative } from 'node:path'
 
-import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
-import { loadCursorIgnorePaths } from '../../../scripts/utils/load-cursor-config.mjs'
+import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
+import { loadCursorIgnorePaths } from '../../../scripts/lib/load-cursor-config.mjs'
 
-import { validateAbieHcModeline } from '../utils/hc-yaml.mjs'
-import { collectDeploymentDirs, findK8sYamlFiles } from '../utils/k8s-tree.mjs'
+import { validateAbieHcModeline } from '../lib/hc-yaml.mjs'
+import { collectDeploymentDirs, findK8sYamlFiles } from '../lib/k8s-tree.mjs'
 
 /**
  * @returns {Promise<number>} результат

package/rules/abie/js/ua_http_route.mjs

@@ -10,20 +10,20 @@
 import { readFile } from 'node:fs/promises'
 import { relative } from 'node:path'
 
-import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
-import { loadCursorIgnorePaths } from '../../../scripts/utils/load-cursor-config.mjs'
+import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
+import { loadCursorIgnorePaths } from '../../../scripts/lib/load-cursor-config.mjs'
 
-import { analyzeAbieSharedBackendRefsInPackageK8s } from '../utils/http-route.mjs'
-import { findK8sYamlFiles } from '../utils/k8s-tree.mjs'
+import { analyzeAbieSharedBackendRefsInPackageK8s } from '../lib/http-route.mjs'
+import { findK8sYamlFiles } from '../lib/k8s-tree.mjs'
 import {
   getCombinedNginxRunPatchTextFromKustomization,
   validateAbieNginxRunHttpRoutePatches
-} from '../utils/kustomization-patches.mjs'
+} from '../lib/kustomization-patches.mjs'
 import {
   abiePackageDirFromK8sOverlay,
   abieOverlayRequiresHttpRouteByVite,
   isUaKustomizationPath
-} from '../utils/overlay-paths.mjs'
+} from '../lib/overlay-paths.mjs'
 
 /**
  * @returns {Promise<number>} результат

package/rules/abie/js/ua_node_selector.mjs

@@ -8,12 +8,12 @@
 import { readFile } from 'node:fs/promises'
 import { relative } from 'node:path'
 
-import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
-import { loadCursorIgnorePaths } from '../../../scripts/utils/load-cursor-config.mjs'
+import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
+import { loadCursorIgnorePaths } from '../../../scripts/lib/load-cursor-config.mjs'
 
-import { collectDeploymentDirs, findK8sYamlFiles } from '../utils/k8s-tree.mjs'
-import { kustomizationHasAbieDeploymentNodeSelectorPatch } from '../utils/kustomization-patches.mjs'
-import { abieOverlayK8sTreeHasDeployment, isUaKustomizationPath } from '../utils/overlay-paths.mjs'
+import { collectDeploymentDirs, findK8sYamlFiles } from '../lib/k8s-tree.mjs'
+import { kustomizationHasAbieDeploymentNodeSelectorPatch } from '../lib/kustomization-patches.mjs'
+import { abieOverlayK8sTreeHasDeployment, isUaKustomizationPath } from '../lib/overlay-paths.mjs'
 
 /**
  * @returns {Promise<number>} результат

package/rules/adr/fix.mjs

@@ -1,9 +1,9 @@
-import { runStandardRule } from '../../scripts/utils/run-standard-rule.mjs'
+import { runStandardRule } from '../../scripts/lib/run-standard-rule.mjs'
 
 /**
  * Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
  * Library mode: викликається CLI orchestration через `import + run(ctx)`.
- * @param {import('../../scripts/utils/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
+ * @param {import('../../scripts/lib/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
  * @returns {Promise<number>} 0 — OK, 1 — порушення
  */
 export function run(ctx) {
@@ -13,7 +13,7 @@ export function run(ctx) {
 if (import.meta.main) {
   // Standalone: bun rules/<id>/fix.mjs — повний еквівалент `npx @nitra/cursor fix <id>`
   // (config-loading + whitelist + summary). Дві ролі fix.mjs: library (run) + standalone (main).
-  const { runRuleCli } = await import('../../scripts/utils/run-rule-cli.mjs')
+  const { runRuleCli } = await import('../../scripts/lib/run-rule-cli.mjs')
   // eslint-disable-next-line unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
   process.exit(await runRuleCli(import.meta.dirname))
 }

package/rules/adr/js/hooks.mjs

@@ -24,7 +24,7 @@ import { delimiter, dirname, join } from 'node:path'
 import { env } from 'node:process'
 import { fileURLToPath } from 'node:url'
 
-import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
+import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
 
 /** Один hook-артефакт: bash-скрипт + його лог-файл, які перевіряємо однотипно. */
 const HOOK_ARTIFACTS = /** @type {const} */ ([
@@ -82,7 +82,7 @@ function gitignoreLineCoversHookLog(line, logPath) {
 
 /**
  * Перевіряє наявність і канонічність одного hook-скрипта.
- * @param {import('../../../../scripts/utils/check-reporter.mjs').CheckReporter} reporter репортер для збору результатів
+ * @param {import('../../../../scripts/lib/check-reporter.mjs').CheckReporter} reporter репортер для збору результатів
  * @param {string} scriptName базове ім'я скрипта (наприклад `capture-decisions.sh`)
  * @returns {Promise<void>}
  */
@@ -111,7 +111,7 @@ async function checkHookScript(reporter, scriptName) {
  * `.claude/settings.local.json`. Структуру (`hooks.Stop[]` містить групу з
  * `capture-decisions.sh`; `settings.local.json` не дублює) валідують
  * `npm/policy/adr/settings_json/` і `npm/policy/adr/settings_local_json/`.
- * @param {import('../../../../scripts/utils/check-reporter.mjs').CheckReporter} reporter репортер
+ * @param {import('../../../../scripts/lib/check-reporter.mjs').CheckReporter} reporter репортер
  */
 function checkProjectSettings(reporter) {
   const { pass, fail } = reporter
@@ -164,7 +164,7 @@ function cursorConfigHasStopHook(config, marker) {
 
 /**
  * Перевіряє project-level Cursor hooks config для ADR stop-hooks.
- * @param {import('../../../../scripts/utils/check-reporter.mjs').CheckReporter} reporter репортер
+ * @param {import('../../../../scripts/lib/check-reporter.mjs').CheckReporter} reporter репортер
  * @returns {Promise<void>}
  */
 async function checkCursorHooks(reporter) {
@@ -190,7 +190,7 @@ async function checkCursorHooks(reporter) {
 
 /**
  * Перевіряє `.gitignore` на ігнорування лог-файлу одного хука.
- * @param {import('../../../../scripts/utils/check-reporter.mjs').CheckReporter} reporter репортер для збору результатів
+ * @param {import('../../../../scripts/lib/check-reporter.mjs').CheckReporter} reporter репортер для збору результатів
  * @param {string} logName базове ім'я лог-файлу (наприклад `capture-decisions.log`)
  * @param {string} gitignoreContent попередньо прочитаний вміст `.gitignore`
  * @returns {void}
@@ -211,7 +211,7 @@ function checkGitignoreForLog(reporter, logName, gitignoreContent) {
 
 /**
  * Перевіряє `.gitignore` для всіх hook-логів одним проходом.
- * @param {import('../../../../scripts/utils/check-reporter.mjs').CheckReporter} reporter репортер для збору результатів
+ * @param {import('../../../../scripts/lib/check-reporter.mjs').CheckReporter} reporter репортер для збору результатів
  * @returns {Promise<void>}
  */
 async function checkGitignore(reporter) {
@@ -251,7 +251,7 @@ function isBinaryInPath(name) {
 /**
  * Інформативна перевірка: чи доступний бодай один LLM CLI (`claude` або `cursor-agent`).
  * Якщо жодного немає — це warning (`pass` з підказкою), бо хук просто мовчки no-op'ає.
- * @param {import('../../../../scripts/utils/check-reporter.mjs').CheckReporter} reporter репортер для збору результатів
+ * @param {import('../../../../scripts/lib/check-reporter.mjs').CheckReporter} reporter репортер для збору результатів
  * @returns {void}
  */
 function checkLlmCliAvailable(reporter) {

package/rules/bun/fix.mjs

@@ -1,9 +1,9 @@
-import { runStandardRule } from '../../scripts/utils/run-standard-rule.mjs'
+import { runStandardRule } from '../../scripts/lib/run-standard-rule.mjs'
 
 /**
  * Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
  * Library mode: викликається CLI orchestration через `import + run(ctx)`.
- * @param {import('../../scripts/utils/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
+ * @param {import('../../scripts/lib/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
  * @returns {Promise<number>} 0 — OK, 1 — порушення
  */
 export function run(ctx) {
@@ -13,7 +13,7 @@ export function run(ctx) {
 if (import.meta.main) {
   // Standalone: bun rules/<id>/fix.mjs — повний еквівалент `npx @nitra/cursor fix <id>`
   // (config-loading + whitelist + summary). Дві ролі fix.mjs: library (run) + standalone (main).
-  const { runRuleCli } = await import('../../scripts/utils/run-rule-cli.mjs')
+  const { runRuleCli } = await import('../../scripts/lib/run-rule-cli.mjs')
   // eslint-disable-next-line unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
   process.exit(await runRuleCli(import.meta.dirname))
 }

package/rules/bun/js/layout.mjs

@@ -20,7 +20,7 @@
 import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
 
-import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
+import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
 
 /** Розділювач токенів у `scripts.lint` (послідовність пробільних символів). */
 const WHITESPACE_RE = /\s+/u

package/rules/capacitor/fix.mjs

@@ -1,9 +1,9 @@
-import { runStandardRule } from '../../scripts/utils/run-standard-rule.mjs'
+import { runStandardRule } from '../../scripts/lib/run-standard-rule.mjs'
 
 /**
  * Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
  * Library mode: викликається CLI orchestration через `import + run(ctx)`.
- * @param {import('../../scripts/utils/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
+ * @param {import('../../scripts/lib/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
  * @returns {Promise<number>} 0 — OK, 1 — порушення
  */
 export function run(ctx) {
@@ -13,7 +13,7 @@ export function run(ctx) {
 if (import.meta.main) {
   // Standalone: bun rules/<id>/fix.mjs — повний еквівалент `npx @nitra/cursor fix <id>`
   // (config-loading + whitelist + summary). Дві ролі fix.mjs: library (run) + standalone (main).
-  const { runRuleCli } = await import('../../scripts/utils/run-rule-cli.mjs')
+  const { runRuleCli } = await import('../../scripts/lib/run-rule-cli.mjs')
   // eslint-disable-next-line unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
   process.exit(await runRuleCli(import.meta.dirname))
 }

package/rules/capacitor/js/platforms.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 '../../../scripts/utils/check-reporter.mjs'
+import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
 
 /** Мінімальна допустима мажорна версія Capacitor (capacitor.mdc) */
 const MIN_CAPACITOR_MAJOR = 8

package/rules/changelog/fix.mjs

@@ -1,9 +1,9 @@
-import { runStandardRule } from '../../scripts/utils/run-standard-rule.mjs'
+import { runStandardRule } from '../../scripts/lib/run-standard-rule.mjs'
 
 /**
  * Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
  * Library mode: викликається CLI orchestration через `import + run(ctx)`.
- * @param {import('../../scripts/utils/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
+ * @param {import('../../scripts/lib/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
  * @returns {Promise<number>} 0 — OK, 1 — порушення
  */
 export function run(ctx) {
@@ -13,7 +13,7 @@ export function run(ctx) {
 if (import.meta.main) {
   // Standalone: bun rules/<id>/fix.mjs — повний еквівалент `npx @nitra/cursor fix <id>`
   // (config-loading + whitelist + summary). Дві ролі fix.mjs: library (run) + standalone (main).
-  const { runRuleCli } = await import('../../scripts/utils/run-rule-cli.mjs')
+  const { runRuleCli } = await import('../../scripts/lib/run-rule-cli.mjs')
   // eslint-disable-next-line unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
   process.exit(await runRuleCli(import.meta.dirname))
 }

package/rules/changelog/js/consistency.mjs

@@ -22,13 +22,13 @@ import { readFile } from 'node:fs/promises'
 import { join } from 'node:path'
 import { promisify } from 'node:util'
 
-import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
+import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
 import {
   getMonorepoProjectRootDirs,
   manifestFilePath,
   parsePyprojectFields,
   readPackageManifest
-} from '../utils/package-manifest.mjs'
+} from '../lib/package-manifest.mjs'
 
 const execFileAsync = promisify(execFile)
 

package/rules/changelog/{utils → lib}/package-manifest.mjs

@@ -8,7 +8,7 @@ import { dirname, join, relative } from 'node:path'
 
 import { parse as parseToml } from 'smol-toml'
 
-import { getMonorepoPackageRootDirs, isIgnoredWorkspaceRoot } from '../../../scripts/utils/workspaces.mjs'
+import { getMonorepoPackageRootDirs, isIgnoredWorkspaceRoot } from '../../../scripts/lib/workspaces.mjs'
 
 /**
  * @typedef {'npm' | 'python'} PackageKind

package/rules/ci4/fix.mjs

@@ -1,9 +1,9 @@
-import { runStandardRule } from '../../scripts/utils/run-standard-rule.mjs'
+import { runStandardRule } from '../../scripts/lib/run-standard-rule.mjs'
 
 /**
  * Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
  * Library mode: викликається CLI orchestration через `import + run(ctx)`.
- * @param {import('../../scripts/utils/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
+ * @param {import('../../scripts/lib/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
  * @returns {Promise<number>} 0 — OK, 1 — порушення
  */
 export function run(ctx) {
@@ -13,7 +13,7 @@ export function run(ctx) {
 if (import.meta.main) {
   // Standalone: bun rules/<id>/fix.mjs — повний еквівалент `npx @nitra/cursor fix <id>`
   // (config-loading + whitelist + summary). Дві ролі fix.mjs: library (run) + standalone (main).
-  const { runRuleCli } = await import('../../scripts/utils/run-rule-cli.mjs')
+  const { runRuleCli } = await import('../../scripts/lib/run-rule-cli.mjs')
   // eslint-disable-next-line unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
   process.exit(await runRuleCli(import.meta.dirname))
 }

package/rules/docker/fix.mjs

@@ -1,9 +1,9 @@
-import { runStandardRule } from '../../scripts/utils/run-standard-rule.mjs'
+import { runStandardRule } from '../../scripts/lib/run-standard-rule.mjs'
 
 /**
  * Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
  * Library mode: викликається CLI orchestration через `import + run(ctx)`.
- * @param {import('../../scripts/utils/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
+ * @param {import('../../scripts/lib/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
  * @returns {Promise<number>} 0 — OK, 1 — порушення
  */
 export function run(ctx) {
@@ -13,7 +13,7 @@ export function run(ctx) {
 if (import.meta.main) {
   // Standalone: bun rules/<id>/fix.mjs — повний еквівалент `npx @nitra/cursor fix <id>`
   // (config-loading + whitelist + summary). Дві ролі fix.mjs: library (run) + standalone (main).
-  const { runRuleCli } = await import('../../scripts/utils/run-rule-cli.mjs')
+  const { runRuleCli } = await import('../../scripts/lib/run-rule-cli.mjs')
   // eslint-disable-next-line unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
   process.exit(await runRuleCli(import.meta.dirname))
 }

package/rules/docker/js/lint.mjs

@@ -30,10 +30,10 @@
 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 '../../../scripts/utils/check-reporter.mjs'
-import { loadCursorIgnorePaths } from '../../../scripts/utils/load-cursor-config.mjs'
+import { getMirrorGcrHint, getFromImageToken } from '../lib/docker-mirror.mjs'
+import { lintDockerfileWithHadolint, posixRel } from '../lib/docker-hadolint.mjs'
+import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
+import { loadCursorIgnorePaths } from '../../../scripts/lib/load-cursor-config.mjs'
 import { walkDir } from '../../../scripts/utils/walkDir.mjs'
 
 const NEWLINE_RE = /\r?\n/

package/rules/docker/lint/lint.mjs

@@ -13,11 +13,11 @@
 import { basename } from 'node:path'
 
 import { isRunAsCli } from '../../../scripts/cli-entry.mjs'
-import { lintDockerfileWithHadolint, posixRel } from '../utils/docker-hadolint.mjs'
-import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
-import { loadCursorIgnorePaths } from '../../../scripts/utils/load-cursor-config.mjs'
+import { lintDockerfileWithHadolint, posixRel } from '../lib/docker-hadolint.mjs'
+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 { runStandardLint } from '../../../scripts/utils/run-standard-lint.mjs'
+import { runStandardLint } from '../../../scripts/lib/run-standard-lint.mjs'
 
 /**
  * Чи входить файл до набору lint-docker: Dockerfile або *.Dockerfile (*.dockerfile).

package/rules/efes/fix.mjs

@@ -1,9 +1,9 @@
-import { runStandardRule } from '../../scripts/utils/run-standard-rule.mjs'
+import { runStandardRule } from '../../scripts/lib/run-standard-rule.mjs'
 
 /**
  * Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
  * Library mode: викликається CLI orchestration через `import + run(ctx)`.
- * @param {import('../../scripts/utils/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
+ * @param {import('../../scripts/lib/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
  * @returns {Promise<number>} 0 — OK, 1 — порушення
  */
 export function run(ctx) {
@@ -13,7 +13,7 @@ export function run(ctx) {
 if (import.meta.main) {
   // Standalone: bun rules/<id>/fix.mjs — повний еквівалент `npx @nitra/cursor fix <id>`
   // (config-loading + whitelist + summary). Дві ролі fix.mjs: library (run) + standalone (main).
-  const { runRuleCli } = await import('../../scripts/utils/run-rule-cli.mjs')
+  const { runRuleCli } = await import('../../scripts/lib/run-rule-cli.mjs')
   // eslint-disable-next-line unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
   process.exit(await runRuleCli(import.meta.dirname))
 }

package/rules/feedback/fix.mjs

@@ -1,9 +1,9 @@
-import { runStandardRule } from '../../scripts/utils/run-standard-rule.mjs'
+import { runStandardRule } from '../../scripts/lib/run-standard-rule.mjs'
 
 /**
  * Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
  * Library mode: викликається CLI orchestration через `import + run(ctx)`.
- * @param {import('../../scripts/utils/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
+ * @param {import('../../scripts/lib/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
  * @returns {Promise<number>} 0 — OK, 1 — порушення
  */
 export function run(ctx) {
@@ -13,7 +13,7 @@ export function run(ctx) {
 if (import.meta.main) {
   // Standalone: bun rules/<id>/fix.mjs — повний еквівалент `npx @nitra/cursor fix <id>`
   // (config-loading + whitelist + summary). Дві ролі fix.mjs: library (run) + standalone (main).
-  const { runRuleCli } = await import('../../scripts/utils/run-rule-cli.mjs')
+  const { runRuleCli } = await import('../../scripts/lib/run-rule-cli.mjs')
   // eslint-disable-next-line unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
   process.exit(await runRuleCli(import.meta.dirname))
 }

package/rules/ga/fix.mjs

@@ -1,9 +1,9 @@
-import { runStandardRule } from '../../scripts/utils/run-standard-rule.mjs'
+import { runStandardRule } from '../../scripts/lib/run-standard-rule.mjs'
 
 /**
  * Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
  * Library mode: викликається CLI orchestration через `import + run(ctx)`.
- * @param {import('../../scripts/utils/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
+ * @param {import('../../scripts/lib/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
  * @returns {Promise<number>} 0 — OK, 1 — порушення
  */
 export function run(ctx) {
@@ -13,7 +13,7 @@ export function run(ctx) {
 if (import.meta.main) {
   // Standalone: bun rules/<id>/fix.mjs — повний еквівалент `npx @nitra/cursor fix <id>`
   // (config-loading + whitelist + summary). Дві ролі fix.mjs: library (run) + standalone (main).
-  const { runRuleCli } = await import('../../scripts/utils/run-rule-cli.mjs')
+  const { runRuleCli } = await import('../../scripts/lib/run-rule-cli.mjs')
   // eslint-disable-next-line unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
   process.exit(await runRuleCli(import.meta.dirname))
 }

package/rules/ga/js/workflows.mjs

@@ -20,11 +20,11 @@ import { execFileSync } from 'node:child_process'
 import { basename, dirname, join } from 'node:path'
 import { fileURLToPath } from 'node:url'
 
-import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
-import { eventPathsIncludeExact, parseWorkflowYaml } from '../../../scripts/utils/gha-workflow.mjs'
+import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
+import { eventPathsIncludeExact, parseWorkflowYaml } from '../../../scripts/lib/gha-workflow.mjs'
 import { resolveCmd } from '../../../scripts/utils/resolve-cmd.mjs'
-import { runConftestBatch } from '../../../scripts/utils/run-conftest-batch.mjs'
-import { loadTemplate } from '../../../scripts/utils/template.mjs'
+import { runConftestBatch } from '../../../scripts/lib/run-conftest-batch.mjs'
+import { loadTemplate } from '../../../scripts/lib/template.mjs'
 
 const HERE = dirname(fileURLToPath(import.meta.url))
 const GA_POLICY_DIR = join(HERE, '..', '..', 'policy')

package/rules/ga/lint/lint.mjs

@@ -31,8 +31,8 @@ import { platform } from 'node:process'
 
 import { check as checkGa } from '../js/workflows.mjs'
 import { resolveCmd } from '../../../scripts/utils/resolve-cmd.mjs'
-import { runLintStep } from '../../../scripts/utils/run-lint-step.mjs'
-import { runStandardLint } from '../../../scripts/utils/run-standard-lint.mjs'
+import { runLintStep } from '../../../scripts/lib/run-lint-step.mjs'
+import { runStandardLint } from '../../../scripts/lib/run-standard-lint.mjs'
 
 /**
  * Опис залежності preflight-ом: бінарник, для чого потрібен, і команди встановлення.

package/rules/graphql/fix.mjs

@@ -1,9 +1,9 @@
-import { runStandardRule } from '../../scripts/utils/run-standard-rule.mjs'
+import { runStandardRule } from '../../scripts/lib/run-standard-rule.mjs'
 
 /**
  * Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
  * Library mode: викликається CLI orchestration через `import + run(ctx)`.
- * @param {import('../../scripts/utils/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
+ * @param {import('../../scripts/lib/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
  * @returns {Promise<number>} 0 — OK, 1 — порушення
  */
 export function run(ctx) {
@@ -13,7 +13,7 @@ export function run(ctx) {
 if (import.meta.main) {
   // Standalone: bun rules/<id>/fix.mjs — повний еквівалент `npx @nitra/cursor fix <id>`
   // (config-loading + whitelist + summary). Дві ролі fix.mjs: library (run) + standalone (main).
-  const { runRuleCli } = await import('../../scripts/utils/run-rule-cli.mjs')
+  const { runRuleCli } = await import('../../scripts/lib/run-rule-cli.mjs')
   // eslint-disable-next-line unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
   process.exit(await runRuleCli(import.meta.dirname))
 }

package/rules/graphql/js/tooling.mjs

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