@nitra/cursor 1.8.179 → 1.8.184

package/scripts/check-image.mjs

@@ -187,9 +187,7 @@ async function checkLegacyCacheRemoved(pass, fail) {
   }
   const lines = await readGitignoreLines()
   if (lines && lines.includes(LEGACY_CACHE_FILENAME)) {
-    fail(
-      `.gitignore: прибери застарілий рядок \`${LEGACY_CACHE_FILENAME}\` — split-cache 3.2.0 його не використовує`
-    )
+    fail(`.gitignore: прибери застарілий рядок \`${LEGACY_CACHE_FILENAME}\` — split-cache 3.2.0 його не використовує`)
     return
   }
   pass(`${LEGACY_CACHE_FILENAME} відсутній (міграція на split-cache завершена)`)
@@ -203,7 +201,9 @@ async function checkLegacyCacheRemoved(pass, fail) {
  */
 function packageHasAvifDisabled(pkg) {
   const cfg = pkg[PKG_CONFIG_FIELD]
-  return Boolean(cfg && typeof cfg === 'object' && /** @type {Record<string, unknown>} */ (cfg)['disable-avif'] === true)
+  return Boolean(
+    cfg && typeof cfg === 'object' && /** @type {Record<string, unknown>} */ (cfg)['disable-avif'] === true
+  )
 }
 
 /**
@@ -213,9 +213,10 @@ function packageHasAvifDisabled(pkg) {
  * один раз (інакше при обході кореня `.` ми б повторно зайшли в `demo/` і подвоїли звіти).
  * @param {string} packageRoot відносний шлях до кореня пакета (наприклад `'.'` або `'demo'`)
  * @param {string[]} otherRootsAbs абсолютні шляхи інших workspace-коренів — їх піддерева пропускаємо
+ * @param {string[]} ignorePaths абсолютні шляхи каталогів, повністю виключених з обходу
  * @param {(msg: string) => void} pass callback при успішній перевірці
  * @param {(msg: string) => void} fail callback при помилці
- * @returns {Promise<void>}
+ * @returns {Promise<void>} резолвиться по завершенню перевірки одного пакета
  */
 async function checkVueAvifImportsInPackage(packageRoot, otherRootsAbs, ignorePaths, pass, fail) {
   const absRoot = join(process.cwd(), packageRoot)
@@ -263,9 +264,10 @@ async function checkVueAvifImportsInPackage(packageRoot, otherRootsAbs, ignorePa
  * Сканує всі workspace-пакети: для кожного перевіряє opt-out і за потреби викликає
  * перевірку Vue-imports. Перевірка пропускається, якщо в репозиторії немає workspaces
  * або немає `.vue`-файлів — тоді `image` правило не для цього проєкту.
+ * @param {string[]} ignorePaths абсолютні шляхи каталогів, повністю виключених з обходу
  * @param {(msg: string) => void} pass callback при успішній перевірці
  * @param {(msg: string) => void} fail callback при помилці
- * @returns {Promise<void>}
+ * @returns {Promise<void>} резолвиться по завершенню перевірки всіх workspace-пакетів
  */
 async function checkVueAvifImports(ignorePaths, pass, fail) {
   const roots = await getMonorepoPackageRootDirs()
@@ -275,7 +277,9 @@ async function checkVueAvifImports(ignorePaths, pass, fail) {
     if (!existsSync(pkgPath)) continue
     const pkg = JSON.parse(await readFile(pkgPath, 'utf8'))
     if (packageHasAvifDisabled(pkg)) {
-      pass(`[${root === '.' ? 'корінь' : root}] avif-import enforcement вимкнено через "@nitra/minify-image.disable-avif"`)
+      pass(
+        `[${root === '.' ? 'корінь' : root}] avif-import enforcement вимкнено через "@nitra/minify-image.disable-avif"`
+      )
       continue
     }
     const otherRootsAbs = roots.filter(r => r !== root && r !== '.').map(r => absRootsByRel.get(r) ?? '')

package/scripts/check-js-bun-db.mjs

@@ -23,7 +23,7 @@
  */
 import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
-import { join, relative, sep } from 'node:path'
+import { join, relative } from 'node:path'
 
 import { createCheckReporter } from './utils/check-reporter.mjs'
 import {
@@ -35,6 +35,7 @@ import {
   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'
 
@@ -50,30 +51,10 @@ function asObject(v) {
   return /** @type {Record<string, unknown>} */ (v)
 }
 
-/**
- * Знаходить всі `package.json` у репозиторії (крім пропущених директорій у walkDir).
- * @param {string} repoRoot абсолютний шлях до кореня репозиторію
- * @returns {Promise<string[]>} абсолютні шляхи, відсортовані за відносним шляхом
- */
-async function findAllPackageJsonPaths(repoRoot, ignorePaths) {
-  /** @type {string[]} */
-  const paths = []
-  await walkDir(
-    repoRoot,
-    absPath => {
-      if (absPath.endsWith(`${sep}package.json`)) {
-        paths.push(absPath)
-      }
-    },
-    ignorePaths
-  )
-  paths.sort((a, b) => relative(repoRoot, a).localeCompare(relative(repoRoot, b)))
-  return paths
-}
-
 /**
  * Збирає абсолютні шляхи JS/TS джерел у репозиторії для скану Bun SQL патернів.
  * @param {string} repoRoot абсолютний шлях до кореня репозиторію
+ * @param {string[]} ignorePaths абсолютні шляхи каталогів, повністю виключених з обходу
  * @returns {Promise<string[]>} абсолютні шляхи, відсортовані за відносним шляхом
  */
 async function findAllSourcePathsForBunSqlScan(repoRoot, ignorePaths) {

package/scripts/check-js-lint.mjs

@@ -145,7 +145,9 @@ function compareOxlintIgnorePatterns(expected, actual, failures) {
     return
   }
   if (!Array.isArray(actual)) {
-    failures.push('.oxlintrc.json: поле "ignorePatterns" має бути масивом (канон задає мінімум, додаткові патерни дозволені)')
+    failures.push(
+      '.oxlintrc.json: поле "ignorePatterns" має бути масивом (канон задає мінімум, додаткові патерни дозволені)'
+    )
     return
   }
   const set = new Set(actual)

package/scripts/check-js-mssql.mjs

@@ -10,9 +10,10 @@
  */
 import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
-import { join, relative, sep } from 'node:path'
+import { join, relative } from 'node:path'
 
 import { createCheckReporter } from './utils/check-reporter.mjs'
+import { findAllPackageJsonPaths } from './utils/find-package-json-paths.mjs'
 import {
   findMssqlPerRequestConnectionInText,
   findSharedMssqlRequestInText,
@@ -31,30 +32,10 @@ const SEMVER_RE = /^(\d+)\.(\d+)\.(\d+)/u
 /** Мінімальна дозволена версія mssql (js-mssql.mdc). */
 const MIN_MSSQL_VERSION = { major: 12, minor: 5, patch: 0 }
 
-/**
- * Знаходить всі `package.json` у репозиторії (крім пропущених директорій у walkDir).
- * @param {string} repoRoot абсолютний шлях до кореня репозиторію
- * @returns {Promise<string[]>} абсолютні шляхи, відсортовані за відносним шляхом
- */
-async function findAllPackageJsonPaths(repoRoot, ignorePaths) {
-  /** @type {string[]} */
-  const paths = []
-  await walkDir(
-    repoRoot,
-    absPath => {
-      if (absPath.endsWith(`${sep}package.json`)) {
-        paths.push(absPath)
-      }
-    },
-    ignorePaths
-  )
-  paths.sort((a, b) => relative(repoRoot, a).localeCompare(relative(repoRoot, b)))
-  return paths
-}
-
 /**
  * Збирає абсолютні шляхи JS/TS джерел у репозиторії для скану mssql.
  * @param {string} repoRoot абсолютний шлях до кореня репозиторію
+ * @param {string[]} ignorePaths абсолютні шляхи каталогів, повністю виключених з обходу
  * @returns {Promise<string[]>} абсолютні шляхи, відсортовані за відносним шляхом
  */
 async function findAllSourcePathsForMssqlScan(repoRoot, ignorePaths) {
@@ -258,9 +239,10 @@ function reportZeroMssqlSourceViolations(counters, pass) {
 /**
  * Аудит усіх JS/TS-джерел репо щодо безпечного використання mssql.
  * @param {string} repoRoot корінь репозиторію
+ * @param {string[]} ignorePaths абсолютні шляхи каталогів, повністю виключених з обходу
  * @param {(msg: string) => void} pass pass callback
  * @param {(msg: string) => void} fail fail callback
- * @returns {Promise<void>}
+ * @returns {Promise<void>} резолвиться по завершенню аудиту всіх знайдених джерел
  */
 async function auditMssqlSources(repoRoot, ignorePaths, pass, fail) {
   const sourcePaths = await findAllSourcePathsForMssqlScan(repoRoot, ignorePaths)

package/scripts/check-js-run.mjs

@@ -17,7 +17,11 @@
  *    `node:process` (для опційних). Коли `env` імпортовано з `@nitra/check-env`,
  *    кожен `env.X` має бути закритий літеральним викликом `checkEnv(['X', ...])`
  *    у тому ж файлі або коментарем `// \@nitra/cursor ignore-next-line checkEnv`
- *    на попередньому рядку (див. `utils/check-env-scan.mjs`).
+ *    на попередньому рядку (див. `utils/check-env-scan.mjs`);
+ *  - «depcheck у GitHub Actions з path-фільтром»: для кожного workflow з `paths:`,
+ *    обмеженим каталогом цього пакета (`<rootDir>/...`), має бути крок
+ *    `npx depcheck --ignores="graphql,bun"` (плюс інші, за потреби) з
+ *    `working-directory: <rootDir>` (див. `utils/depcheck-workflow.mjs`).
  */
 import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
@@ -30,6 +34,7 @@ import {
 } from './utils/bunyan-imports.mjs'
 import { findUncheckedProcessEnvInText, isCheckEnvScanSourceFile } from './utils/check-env-scan.mjs'
 import { createCheckReporter } from './utils/check-reporter.mjs'
+import { findDepcheckViolationsForPackage, readAllWorkflowFiles } from './utils/depcheck-workflow.mjs'
 import {
   findConnFactoryImportsInText,
   isConnImportsScanSourceFile,
@@ -53,6 +58,7 @@ function relPosix(absPackageRoot, absPath) {
 /**
  * Сканує джерела пакета на заборонені імпорти `@nitra/bunyan` / `bunyan`.
  * @param {string} absPackageRoot абсолютний шлях до кореня пакета
+ * @param {string[]} ignorePaths абсолютні шляхи каталогів, повністю виключених з обходу
  * @param {string} label префікс повідомлення `[<pkg>] `
  * @param {(msg: string) => void} fail callback при помилці
  * @returns {Promise<number>} кількість знайдених порушень
@@ -86,6 +92,7 @@ async function checkBunyanImports(absPackageRoot, ignorePaths, label, fail) {
 /**
  * Збирає всі JS/TS-файли пакета (без node_modules, dist тощо).
  * @param {string} absPackageRoot абсолютний шлях до кореня пакета
+ * @param {string[]} ignorePaths абсолютні шляхи каталогів, повністю виключених з обходу
  * @returns {Promise<string[]>} абсолютні шляхи до файлів
  */
 async function collectSourceFiles(absPackageRoot, ignorePaths) {
@@ -158,15 +165,26 @@ async function checkProcessEnvUsage(absPackageRoot, sourcePaths, label, fail) {
 /**
  * Перевіряє відповідність правилам js-run.mdc для одного workspace-пакета.
  * @param {string} rootDir відносний шлях workspace (не `'.'`)
+ * @param {string[]} ignorePaths абсолютні шляхи каталогів, повністю виключених з обходу
+ * @param {{ relPath: string, content: string }[]} workflows кешований список workflow-файлів репо
  * @param {(msg: string) => void} fail функція зворотного виклику для реєстрації помилки перевірки
  * @param {(msg: string) => void} passFn успішне повідомлення (як у check-reporter)
  * @returns {Promise<void>} завершується після перевірок цього пакета
  */
-async function checkWorkspacePackage(rootDir, ignorePaths, fail, passFn) {
+async function checkWorkspacePackage(rootDir, ignorePaths, workflows, fail, passFn) {
   const label = `[${rootDir}] `
   const absPackageRoot = join(process.cwd(), rootDir)
   const pkgJson = await loadPackageJsonAndCheckBunyanDeps(rootDir, label, fail)
 
+  // Frontend-пакети (vite у devDependencies) виходять за межі js-run:
+  // браузерний бандл не має `node:process`, а `process.env.*` бандлер
+  // обробляє самостійно. Перевірку process.env / conn-аліасів пропускаємо,
+  // bunyan-залежність уже звірено в `loadPackageJsonAndCheckBunyanDeps`.
+  if (packageJsonHasViteDevDependency(pkgJson)) {
+    passFn(`${label}vite-пакет (frontend) — js-run пропущено (process.env / conn-aliases / OTEL configmap)`)
+    return
+  }
+
   const importViolations = await checkBunyanImports(absPackageRoot, ignorePaths, label, fail)
   if (importViolations === 0) {
     passFn(`${label}немає імпортів '@nitra/bunyan' / 'bunyan' у джерелах`)
@@ -188,6 +206,47 @@ async function checkWorkspacePackage(rootDir, ignorePaths, fail, passFn) {
   }
 
   await checkOtelConfigmap(rootDir, label, fail, passFn)
+
+  checkDepcheckInWorkflows(rootDir, workflows, label, fail, passFn)
+}
+
+/**
+ * Перевіряє правило «depcheck у workflow» для одного пакета.
+ *
+ * Для кожного `.github/workflows/*.yml`, чий `paths:` обмежено до `<rootDir>/...`,
+ * має бути крок `npx depcheck --ignores="graphql,bun"` з `working-directory: <rootDir>`.
+ * Якщо в репо немає каталогу `.github/workflows`, перевірка no-op.
+ * @param {string} rootDir відносний шлях workspace-пакета
+ * @param {{ relPath: string, content: string }[]} workflows кешований список workflow-файлів
+ * @param {string} label префікс повідомлення `[<pkg>] `
+ * @param {(msg: string) => void} fail callback при помилці
+ * @param {(msg: string) => void} passFn успішне повідомлення
+ * @returns {void}
+ */
+function checkDepcheckInWorkflows(rootDir, workflows, label, fail, passFn) {
+  if (workflows.length === 0) return
+  const violations = findDepcheckViolationsForPackage(workflows, rootDir.replace(/\\/g, '/'))
+  if (violations.length === 0) {
+    passFn(`${label}depcheck у path-scoped workflow налаштовано (або відсутній path-scoped workflow для пакета)`)
+    return
+  }
+  for (const v of violations) {
+    fail(`${label}${v}`)
+  }
+}
+
+/**
+ * Чи має пакет `vite` у `devDependencies` (маркер frontend-пакета — vite/quasar/capacitor SPA).
+ * Семантично ідентично `packageJsonLacksViteDevDependency` з `auto-rules.mjs`, але
+ * приймає вже розпарсений pkgJson.
+ * @param {unknown} pkgJson розпарсений `package.json` пакета (або null)
+ * @returns {boolean} true, якщо `vite` присутній у `devDependencies`
+ */
+function packageJsonHasViteDevDependency(pkgJson) {
+  if (!pkgJson || typeof pkgJson !== 'object' || Array.isArray(pkgJson)) return false
+  const devDeps = /** @type {Record<string, unknown>} */ (pkgJson).devDependencies
+  if (!devDeps || typeof devDeps !== 'object' || Array.isArray(devDeps)) return false
+  return Object.hasOwn(devDeps, 'vite')
 }
 
 /**
@@ -255,8 +314,9 @@ export async function check() {
   }
 
   const ignorePaths = await loadCursorIgnorePaths(process.cwd())
+  const workflows = await readAllWorkflowFiles(process.cwd())
   for (const r of workspaceRoots) {
-    await checkWorkspacePackage(r, ignorePaths, fail, pass)
+    await checkWorkspacePackage(r, ignorePaths, workflows, fail, pass)
   }
 
   return reporter.getExitCode()

package/scripts/check-k8s.mjs

@@ -1339,43 +1339,44 @@ function failIfExplicitPatchTargetsNotInCatalog(rel, first, catalog, fail) {
  * @returns {void}
  */
 function failIfExplicitPatchTargetsHaveRedundantGroupVersion(rel, first, catalog, fail) {
-  for (const { section, index, target } of extractExplicitPatchTargetsFromKustomization(first)) {
-    if (target === null || typeof target !== 'object' || Array.isArray(target)) {
-      continue
-    }
-    const t = /** @type {Record<string, unknown>} */ (target)
-    const kind = typeof t.kind === 'string' ? t.kind.trim() : ''
-    const name = typeof t.name === 'string' ? t.name.trim() : ''
-    if (kind === '' || name === '') {
-      continue
-    }
-    if (patchTargetUsesSelector(t)) {
-      continue
-    }
-    const tgtGroup = typeof t.group === 'string' ? t.group.trim() : ''
-    const tgtVersion = typeof t.version === 'string' ? t.version.trim() : ''
-    if (tgtGroup === '' && tgtVersion === '') {
-      continue
-    }
-    const matchingByKindName = catalog.filter(r => r.kind === kind && r.name === name)
-    const distinctGvk = new Set(matchingByKindName.map(r => `${r.group}/${r.version}`))
-    if (distinctGvk.size > 1) {
-      continue
-    }
-    /** @type {string[]} */
-    const redundant = []
-    if (tgtGroup !== '') {
-      redundant.push('group')
-    }
-    if (tgtVersion !== '') {
-      redundant.push('version')
-    }
+  for (const entry of extractExplicitPatchTargetsFromKustomization(first)) {
+    const violation = describePatchTargetRedundancy(entry, catalog)
+    if (violation === null) continue
+    const { section, index, kind, name, redundant } = violation
     fail(
       `${rel}: ${section}[${index}].target — прибери зайві поля ${redundant.join(', ')}; для kind=${kind}, name=${name} в інвентарі немає колізії між різними API-групами/версіями (див. k8s.mdc «patches[].target: лише kind і name»)`
     )
   }
 }
 
+/**
+ * Аналізує один patch.target: повертає опис надлишкових полів `group`/`version`,
+ * якщо в інвентарі для пари (kind, name) немає колізії GVK; інакше `null`.
+ * @param {{ section: string, index: number, target: unknown }} entry елемент із `extractExplicitPatchTargetsFromKustomization`
+ * @param {KustomizeResourceDescriptor[]} catalog інвентар resources/bases/…
+ * @returns {{ section: string, index: number, kind: string, name: string, redundant: string[] } | null} опис порушення або `null`
+ */
+function describePatchTargetRedundancy(entry, catalog) {
+  const { section, index, target } = entry
+  if (target === null || typeof target !== 'object' || Array.isArray(target)) return null
+  const t = /** @type {Record<string, unknown>} */ (target)
+  const kind = typeof t.kind === 'string' ? t.kind.trim() : ''
+  const name = typeof t.name === 'string' ? t.name.trim() : ''
+  if (kind === '' || name === '') return null
+  if (patchTargetUsesSelector(t)) return null
+  const tgtGroup = typeof t.group === 'string' ? t.group.trim() : ''
+  const tgtVersion = typeof t.version === 'string' ? t.version.trim() : ''
+  if (tgtGroup === '' && tgtVersion === '') return null
+  const matchingByKindName = catalog.filter(r => r.kind === kind && r.name === name)
+  const distinctGvk = new Set(matchingByKindName.map(r => `${r.group}/${r.version}`))
+  if (distinctGvk.size > 1) return null
+  /** @type {string[]} */
+  const redundant = []
+  if (tgtGroup !== '') redundant.push('group')
+  if (tgtVersion !== '') redundant.push('version')
+  return { section, index, kind, name, redundant }
+}
+
 /**
  * Документи з YAML-файлу мають мати дескриптор у **catalog** (інвентар resources).
  * @param {string} rel відносний шлях до kustomization.yaml
@@ -1636,7 +1637,7 @@ export function baseKustomizationNamespaceViolation(obj) {
 /**
  * Збирає всі `*.yaml` та `*.yml` під деревом від кореня cwd, якщо шлях містить сегмент `k8s` (для `.yml` далі — помилка перейменування).
  * @param {string} root корінь репозиторію (cwd)
- * @param {string[]} [ignorePaths=[]] шляхи каталогів, повністю виключених з обходу
+ * @param {string[]} [ignorePaths] шляхи каталогів, повністю виключених з обходу
  * @returns {Promise<string[]>} відсортовані абсолютні шляхи до файлів
  */
 async function findK8sYamlFiles(root, ignorePaths = []) {

package/scripts/check-nginx-default-tpl.mjs

@@ -35,6 +35,7 @@ const GZIP_EXTENSION_RE = /\*\.(?:js|css)/u
 /**
  * Збирає абсолютні шляхи до **default.conf.template** у репозиторії; шлях `tests/fixtures` не обходиться як проєктний шаблон.
  * @param {string} root корінь cwd
+ * @param {string[]} ignorePaths абсолютні шляхи каталогів, повністю виключених з обходу
  * @returns {Promise<string[]>} відсортовані абсолютні шляхи до шаблонів
  */
 export async function findDefaultConfTemplatePaths(root, ignorePaths = []) {
@@ -57,6 +58,7 @@ export async function findDefaultConfTemplatePaths(root, ignorePaths = []) {
  * Знаходить у дереві від `root` усі **default.tpl.conf**. Якщо поруч немає **default.conf.template** —
  * перейменовує файл; якщо є — перезаписує **default.conf.template** вмістом **default.tpl.conf** і видаляє **default.tpl.conf**.
  * @param {string} root корінь обходу (зазвичай cwd репозиторію)
+ * @param {string[]} ignorePaths абсолютні шляхи каталогів, повністю виключених з обходу
  * @returns {Promise<{ renamed: string[], overwritten: string[] }>} відносні шляхи до обробленого **default.tpl.conf** (для звіту)
  */
 export async function migrateDefaultTplConfFiles(root, ignorePaths = []) {
@@ -322,6 +324,7 @@ async function checkTemplateFile(abs, root, passFn, failFn) {
 /**
  * Перевіряє Dockerfile на наявність gzip та envsubst.
  * @param {string} root корінь репозиторію
+ * @param {string[]} ignorePaths абсолютні шляхи каталогів, повністю виключених з обходу
  * @param {(msg: string) => void} passFn callback при успішній перевірці
  * @param {(msg: string) => void} failFn callback при помилці
  */

package/scripts/check-npm-module.mjs

@@ -36,6 +36,7 @@ const EMIT_TYPES_CONFIG = 'npm/tsconfig.emit-types.json'
 
 /**
  * Чи є під `npm/src` хоча б один `.js` (рекурсивно).
+ * @param {string[]} [ignorePaths] абсолютні шляхи каталогів, повністю виключених з обходу
  * @returns {Promise<boolean>} `true`, якщо знайдено хоча б один `.js`
  */
 async function npmSrcTreeHasJsFile(ignorePaths = []) {

package/scripts/check-vue.mjs

@@ -115,6 +115,7 @@ async function collectEsbuildMatchesInFiles(absPackageRoot, files, maxMatches) {
  * Сканує дерево пакета на згадки `esbuild` і підказує заміну на `rolldown`.
  * @param {string} rootDir відносний шлях до пакета
  * @param {string} absPackageRoot абсолютний шлях до кореня пакета
+ * @param {string[]} ignorePaths абсолютні шляхи каталогів, повністю виключених з обходу
  * @param {string} prefix параметр prefix
  * @param {(msg: string) => void} passFn callback при успішній перевірці
  * @param {(msg: string) => void} fail callback при помилці
@@ -342,9 +343,7 @@ async function checkVueNodeImportViolations(rootDir, absPackageRoot, ignorePaths
     }
   }
   if (nodeImportViolations === 0) {
-    passFn(
-      `${prefix}немає імпортів Node-нативних модулів у .vue (проскановано ${ukFilesCountPhrase(vuePaths.length)})`
-    )
+    passFn(`${prefix}немає імпортів Node-нативних модулів у .vue (проскановано ${ukFilesCountPhrase(vuePaths.length)})`)
   }
 }
 
@@ -354,18 +353,17 @@ async function checkVueNodeImportViolations(rootDir, absPackageRoot, ignorePaths
  * Якщо `unplugin-auto-import` не сконфігурований на `'vue'` у `vite.config`, явні value-імпорти
  * формально не заборонені — їх видалення зламає код. У цьому випадку перевірка пропускається,
  * а fail про відсутній `'vue'` у `AutoImport.imports` уже зареєстровано в `checkViteConfig`.
- * @param {string} rootDir параметр rootDir
- * @param {string} absPackageRoot параметр absPackageRoot
- * @param {string} prefix параметр prefix
+ * @param {string} rootDir відносний шлях до пакета
+ * @param {string} absPackageRoot абсолютний шлях до кореня пакета
+ * @param {string[]} ignorePaths абсолютні шляхи каталогів, повністю виключених з обходу
  * @param {boolean} hasVueAutoImport чи `AutoImport({ imports: [..., 'vue', ...] })` сконфігуровано
+ * @param {string} prefix префікс повідомлення `[<pkg>] `
  * @param {(msg: string) => void} passFn callback при успішній перевірці
  * @param {(msg: string) => void} fail callback при помилці
  */
 async function checkVueImportViolations(rootDir, absPackageRoot, ignorePaths, hasVueAutoImport, prefix, passFn, fail) {
   if (!hasVueAutoImport) {
-    passFn(
-      `${prefix}value-імпорти з 'vue' не заборонені — спершу додай 'vue' до AutoImport.imports у vite.config`
-    )
+    passFn(`${prefix}value-імпорти з 'vue' не заборонені — спершу додай 'vue' до AutoImport.imports у vite.config`)
     return
   }
   /** @type {string[]} */
@@ -400,6 +398,7 @@ async function checkVueImportViolations(rootDir, absPackageRoot, ignorePaths, ha
 /**
  * Перевіряє залежності та vite.config одного Vue-пакета.
  * @param {string} rootDir відносний шлях до пакета
+ * @param {string[]} ignorePaths абсолютні шляхи каталогів, повністю виключених з обходу
  * @param {(msg: string) => void} fail функція зворотного виклику для реєстрації помилки перевірки
  * @param {(msg: string) => void} passFn успішне повідомлення (як у check-reporter)
  * @returns {Promise<void>} завершується після перевірок залежностей, `vite.config` і сканування джерел на імпорти з `vue`
@@ -444,7 +443,15 @@ async function checkVuePackage(rootDir, ignorePaths, fail, passFn) {
   )
 
   const { hasVueAutoImport } = await checkViteConfig(rootDir, prefix, passFn, fail)
-  await checkVueImportViolations(rootDir, join(process.cwd(), rootDir), ignorePaths, hasVueAutoImport, prefix, passFn, fail)
+  await checkVueImportViolations(
+    rootDir,
+    join(process.cwd(), rootDir),
+    ignorePaths,
+    hasVueAutoImport,
+    prefix,
+    passFn,
+    fail
+  )
   await checkVueNodeImportViolations(rootDir, join(process.cwd(), rootDir), ignorePaths, prefix, passFn, fail)
   await checkEsbuildMentions(rootDir, join(process.cwd(), rootDir), ignorePaths, prefix, passFn, fail)
 }

package/scripts/claude-stop-hook.mjs

@@ -11,25 +11,27 @@
  *   `npx --no @nitra/cursor stop-hook`
  */
 import { spawn } from 'node:child_process'
+import { once } from 'node:events'
 
 /**
  * Зчитує stdin до EOF як utf8 рядок. Якщо stdin порожній (TTY) — повертає '' одразу.
  * @returns {Promise<string>} вміст stdin
  */
-function readStdin() {
-  return new Promise(resolve => {
-    if (process.stdin.isTTY) {
-      resolve('')
-      return
-    }
-    let data = ''
-    process.stdin.setEncoding('utf8')
-    process.stdin.on('data', chunk => {
-      data += chunk
-    })
-    process.stdin.on('end', () => resolve(data))
-    process.stdin.on('error', () => resolve(data))
+async function readStdin() {
+  if (process.stdin.isTTY) {
+    return ''
+  }
+  process.stdin.setEncoding('utf8')
+  const chunks = []
+  process.stdin.on('data', chunk => {
+    chunks.push(chunk)
   })
+  try {
+    await once(process.stdin, 'end')
+  } catch {
+    // 'error' на stdin — повертаємо те, що встигли зібрати
+  }
+  return chunks.join('')
 }
 
 /**
@@ -60,12 +62,13 @@ export async function runStopHookCli() {
   if (isRecursiveStopHookCall(stdin)) {
     return 0
   }
-  return new Promise(resolve => {
-    const child = spawn('npx', ['--no', '@nitra/cursor', 'check'], { stdio: 'inherit' })
-    child.on('exit', code => resolve(code ?? 1))
-    child.on('error', err => {
-      process.stderr.write(`stop-hook: не вдалося запустити npx @nitra/cursor check — ${err.message}\n`)
-      resolve(1)
-    })
-  })
+  // eslint-disable-next-line sonarjs/no-os-command-from-path -- npx як стандартне dev-середовище через PATH; альтернативи (хардкод шляху) непортативні
+  const child = spawn('npx', ['--no', '@nitra/cursor', 'check'], { stdio: 'inherit' })
+  try {
+    const [code] = await once(child, 'exit')
+    return code ?? 1
+  } catch (error) {
+    process.stderr.write(`stop-hook: не вдалося запустити npx @nitra/cursor check — ${error.message}\n`)
+    return 1
+  }
 }

package/scripts/lint-ga.mjs

@@ -18,7 +18,6 @@ import { resolveCmd } from './utils/resolve-cmd.mjs'
 
 /**
  * Опис залежності preflight-ом: бінарник, для чого потрібен, і команди встановлення.
- *
  * @typedef {object} PreflightDep
  * @property {string} bin ім'я виконуваного файлу (на Windows додається `.exe` за потреби)
  * @property {string[]} winBins альтернативні імена на Windows (`shellcheck.exe`); якщо нема — fallback на `bin`

package/scripts/rename-yaml-extensions.mjs

@@ -68,6 +68,7 @@ export function replaceExtension(relPosix, newExt) {
 /**
  * Збирає операції перейменування (без виконання).
  * @param {string} rootAbs абсолютний корінь репозиторію
+ * @param {string[]} ignorePaths абсолютні шляхи каталогів, повністю виключених з обходу
  * @returns {Promise<Array<{ kind: 'k8s' | 'github', fromAbs: string, toAbs: string, relFrom: string, relTo: string }>>} відсортовані операції перейменування без запису на диск
  */
 async function collectRenameOps(rootAbs, ignorePaths) {

package/scripts/run-docker.mjs

@@ -29,6 +29,7 @@ export function isLintDockerfileName(name) {
 /**
  * Збирає абсолютні шляхи для lint-docker.
  * @param {string} root корінь репозиторію
+ * @param {string[]} [ignorePaths] абсолютні шляхи каталогів, повністю виключених з обходу
  * @returns {Promise<string[]>} відсортовані абсолютні шляхи
  */
 export async function findLintDockerfilePaths(root, ignorePaths = []) {

package/scripts/run-k8s.mjs

@@ -59,6 +59,7 @@ export function k8sRootFromFile(absFile) {
 /**
  * Унікальні корені `k8s` за наявності `*.yaml` під деревом cwd.
  * @param {string} root корінь репозиторію
+ * @param {string[]} [ignorePaths] абсолютні шляхи каталогів, повністю виключених з обходу
  * @returns {Promise<string[]>} відсортовані абсолютні шляхи до каталогів `k8s`
  */
 export async function findK8sRoots(root, ignorePaths = []) {