@nitra/cursor 1.9.21 → 1.10.0

package/{scripts/check-adr.mjs → 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.
@@ -19,28 +22,50 @@ 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'
+
+/** Один 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_HOOK_PATH = '.claude/hooks/capture-decisions.sh'
 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

@@ -0,0 +1,37 @@
+# Перевірка `.claude/settings.json` для правила adr.mdc:
+# `hooks.Stop[*]` має містити дві managed-групи — capture і normalize — у
+# кожній хоча б один елемент `hooks[]` з відповідним маркером у `command`.
+#
+# Запуск (локально):
+#   conftest test .claude/settings.json -p npm/rules/adr/policy \
+#     --namespace adr.settings_json
+#
+# Hash-порівняння bash-скриптів з канонічними bundled-варіантами і `.gitignore`-перевірки
+# — у JS (`js/check.mjs`).
+#
+# Структура каталогу збігається зі шляхом пакету (regal: directory-package-mismatch).
+# Конвенція проєкту — `import rego.v1` + multi-value `deny contains msg if { … }`
+# (.cursor/rules/conftest.mdc). Лінт — `bun run lint-rego` (regal).
+package adr.settings_json
+
+import rego.v1
+
+capture_marker := ".claude/hooks/capture-decisions.sh"
+normalize_marker := ".claude/hooks/normalize-decisions.sh"
+
+deny contains msg if {
+	not has_stop_hook_with_marker(capture_marker)
+	msg := ".claude/settings.json: відсутній Stop-hook для `capture-decisions.sh` у hooks.Stop (adr.mdc)"
+}
+
+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", ""), marker)
+}

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

@@ -0,0 +1,40 @@
+# Перевірка `.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/rules/adr/policy \
+#     --namespace adr.settings_local_json
+#
+# Структура каталогу збігається зі шляхом пакету (regal: directory-package-mismatch).
+# Конвенція проєкту — `import rego.v1` + multi-value `deny contains msg if { … }`
+# (.cursor/rules/conftest.mdc). Лінт — `bun run lint-rego` (regal).
+package adr.settings_local_json
+
+import rego.v1
+
+capture_marker := ".claude/hooks/capture-decisions.sh"
+normalize_marker := ".claude/hooks/normalize-decisions.sh"
+
+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)",
+	])
+}
+
+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", ""), marker)
+}

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

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

@@ -12,8 +12,8 @@ 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 { findAllPackageJsonPaths } from './utils/find-package-json-paths.mjs'
+import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
+import { findAllPackageJsonPaths } from '../../../scripts/utils/find-package-json-paths.mjs'
 import {
   findMssqlPerRequestConnectionInText,
   findSharedMssqlRequestInText,
@@ -22,9 +22,9 @@ import {
   findUnsafeMssqlInListUnparsedInText,
   findUnsafeMssqlInListMissingEmptyGuardInText,
   isMssqlScanSourceFile
-} from './utils/mssql-pool-scan.mjs'
-import { loadCursorIgnorePaths } from './utils/load-cursor-config.mjs'
-import { walkDir } from './utils/walkDir.mjs'
+} from '../../../scripts/utils/mssql-pool-scan.mjs'
+import { loadCursorIgnorePaths } from '../../../scripts/utils/load-cursor-config.mjs'
+import { walkDir } from '../../../scripts/utils/walkDir.mjs'
 
 const VERSION_PREFIX_RE = /^[\^~>=<]+\s*/u
 const SEMVER_RE = /^(\d+)\.(\d+)\.(\d+)/u

package/rules/js-run/auto.md

@@ -0,0 +1 @@
+якщо це вкладена директорія з package.json (не в корені) та в devDependencies немає vite

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

@@ -37,21 +37,21 @@ import {
   findBunyanImportsInText,
   isBunyanScanSourceFile,
   shouldSkipFileForBunyanScan
-} from './utils/bunyan-imports.mjs'
-import { findUncheckedProcessEnvInText, isCheckEnvScanSourceFile } from './utils/check-env-scan.mjs'
-import { createCheckReporter } from './utils/check-reporter.mjs'
-import { runConftestBatch } from './utils/run-conftest-batch.mjs'
-import { findConnFileRuleViolations, isConnFileRulesSourceFile } from './utils/conn-file-rules.mjs'
+} from '../../../scripts/utils/bunyan-imports.mjs'
+import { findUncheckedProcessEnvInText, isCheckEnvScanSourceFile } from '../../../scripts/utils/check-env-scan.mjs'
+import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
+import { runConftestBatch } from '../../../scripts/utils/run-conftest-batch.mjs'
+import { findConnFileRuleViolations, isConnFileRulesSourceFile } from '../../../scripts/utils/conn-file-rules.mjs'
 import {
   findConnFactoryImportsInText,
   isConnImportsScanSourceFile,
   isInsideConnDir,
   resolveConnDirFromPackageJson
-} from './utils/conn-imports-scan.mjs'
-import { loadCursorIgnorePaths } from './utils/load-cursor-config.mjs'
-import { findPromiseSetTimeoutInText, isPromiseSetTimeoutScanSourceFile } from './utils/promise-settimeout-scan.mjs'
-import { walkDir } from './utils/walkDir.mjs'
-import { getMonorepoPackageRootDirs } from './utils/workspaces.mjs'
+} from '../../../scripts/utils/conn-imports-scan.mjs'
+import { loadCursorIgnorePaths } from '../../../scripts/utils/load-cursor-config.mjs'
+import { findPromiseSetTimeoutInText, isPromiseSetTimeoutScanSourceFile } from '../../../scripts/utils/promise-settimeout-scan.mjs'
+import { walkDir } from '../../../scripts/utils/walkDir.mjs'
+import { getMonorepoPackageRootDirs } from '../../../scripts/utils/workspaces.mjs'
 
 /**
  * Чи існує непорожній за змістом маркер каталогу `src/` (рекомендована структура js-run).
@@ -92,7 +92,7 @@ function checkBackendJsconfigWhenSrcPresent(rootDir, absPackageRoot, label, fail
     return
   }
   const violations = runConftestBatch({
-    policyDirRel: 'js_run/jsconfig',
+    policyDirRel: 'js-run/jsconfig',
     namespace: 'js_run.jsconfig',
     files: [jcPath]
   })

package/rules/k8s/auto.md

@@ -0,0 +1 @@
+якщо присутня хоч одна директорія k8s

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

@@ -134,10 +134,10 @@ import { basename, dirname, join, relative, resolve } from 'node:path'
 
 import { isSeq, parseAllDocuments, parseDocument } from 'yaml'
 
-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 { 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'
 
 /** Версія набору схем yannh — узгоджено з k8s.mdc */
 const YANNH_PIN = 'v1.33.9-standalone-strict'