@nitra/cursor 1.27.7 → 1.28.0

package/rules/ga/js/workflows.mjs

@@ -44,14 +44,15 @@ const REQUIRED_WORKFLOWS = ['clean-ga-workflows.yml', 'clean-merged-branch.yml',
  * Використовує `git ls-files` з pathspec-магiєю `:(glob)`, щоб не реалізовувати glob engine вручну
  * і не сканувати файлову систему рекурсивно.
  * @param {string} globPattern glob з workflow (наприклад "files/**" або "image-migration-new/**")
+ * @param {string} cwd робочий каталог для `git`
  * @returns {boolean} true, якщо є хоча б один збіг
  */
-function gitHasAnyTrackedFileMatchingGlob(globPattern) {
+function gitHasAnyTrackedFileMatchingGlob(globPattern, cwd) {
   const p = String(globPattern ?? '').trim()
   if (!p) return false
   if (p.startsWith('!')) return true
   try {
-    const out = execFileSync('git', ['ls-files', '-z', '--', `:(glob)${p}`], { encoding: 'utf8' })
+    const out = execFileSync('git', ['ls-files', '-z', '--', `:(glob)${p}`], { encoding: 'utf8', cwd })
     return out.length > 0
   } catch {
     return false
@@ -84,15 +85,16 @@ function shouldValidateWorkflowPathsGlob(p) {
  * @param {unknown} raw сирий елемент масиву paths
  * @param {(msg: string) => void} passFn pass
  * @param {(msg: string) => void} failFn fail
+ * @param {string} cwd робочий каталог для `git`
  */
-function verifyOnePathsGlob(relPath, eventName, raw, passFn, failFn) {
+function verifyOnePathsGlob(relPath, eventName, raw, passFn, failFn, cwd) {
   const p = String(raw ?? '').trim()
   if (!p) return
   if (!shouldValidateWorkflowPathsGlob(p)) {
     passFn(`${relPath}: on.${eventName}.paths glob пропущено для перевірки існування: ${JSON.stringify(p)}`)
     return
   }
-  if (gitHasAnyTrackedFileMatchingGlob(p)) {
+  if (gitHasAnyTrackedFileMatchingGlob(p, cwd)) {
     passFn(`${relPath}: on.${eventName}.paths glob матчитсья: ${JSON.stringify(p)}`)
   } else {
     failFn(`${relPath}: on.${eventName}.paths glob не матчитсья ні на один файл: ${JSON.stringify(p)}`)
@@ -105,8 +107,9 @@ function verifyOnePathsGlob(relPath, eventName, raw, passFn, failFn) {
  * @param {Record<string, unknown>} root parsed YAML workflow
  * @param {(msg: string) => void} passFn pass
  * @param {(msg: string) => void} failFn fail
+ * @param {string} cwd робочий каталог для `git`
  */
-function verifyWorkflowEventPathsGlobsExist(relPath, root, passFn, failFn) {
+function verifyWorkflowEventPathsGlobsExist(relPath, root, passFn, failFn, cwd) {
   const on = getObjKey(root, 'on')
   if (!on || typeof on !== 'object') return
 
@@ -119,7 +122,7 @@ function verifyWorkflowEventPathsGlobsExist(relPath, root, passFn, failFn) {
   for (const [eventName, paths] of candidates) {
     if (!Array.isArray(paths)) continue
     for (const raw of paths) {
-      verifyOnePathsGlob(relPath, eventName, raw, passFn, failFn)
+      verifyOnePathsGlob(relPath, eventName, raw, passFn, failFn, cwd)
     }
   }
 }
@@ -138,7 +141,7 @@ function getObjKey(obj, key) {
 
 /**
  * Перевіряє apply-workflow на наявність paths trigger.
- * @param {string} wfDir директорія workflows
+ * @param {string} wfDir абсолютна директорія workflows
  * @param {string[]} files список файлів у директорії
  * @param {string} filename параметр filename
  * @param {string} expectedPath параметр expectedPath
@@ -147,7 +150,7 @@ function getObjKey(obj, key) {
  */
 async function checkApplyWorkflow(wfDir, files, filename, expectedPath, passFn, failFn) {
   if (!files.includes(filename)) return
-  const content = await readFile(`${wfDir}/${filename}`, 'utf8')
+  const content = await readFile(join(wfDir, filename), 'utf8')
   const root = parseWorkflowYaml(content)
   const ok = root ? eventPathsIncludeExact(root, 'push', expectedPath) : content.includes(expectedPath)
   if (ok) {
@@ -159,22 +162,24 @@ async function checkApplyWorkflow(wfDir, files, filename, expectedPath, passFn,
 
 /**
  * Перевіряє відсутність MegaLinter у workflows та конфіг-файлах.
- * @param {string} wfDir директорія workflows
+ * @param {string} wfDir абсолютна директорія workflows
  * @param {string[]} ymlWorkflows параметр ymlWorkflows
+ * @param {string} wfDirRel відносний шлях директорії workflows для повідомлень
+ * @param {string} cwd корінь репозиторію
  * @param {(msg: string) => void} passFn callback при успішній перевірці
  * @param {(msg: string) => void} failFn callback при помилці
  */
-async function checkMegalinter(wfDir, ymlWorkflows, passFn, failFn) {
+async function checkMegalinter(wfDir, ymlWorkflows, wfDirRel, cwd, passFn, failFn) {
   let found = false
   for (const f of ymlWorkflows) {
     const content = await readFile(join(wfDir, f), 'utf8')
     if (MEGALINTER_USE_PATTERNS.some(re => re.test(content))) {
       found = true
-      failFn(`MegaLinter у workflow ${wfDir}/${f} — видали інтеграцію (ga.mdc: MegaLinter)`)
+      failFn(`MegaLinter у workflow ${wfDirRel}/${f} — видали інтеграцію (ga.mdc: MegaLinter)`)
     }
   }
   for (const name of MEGALINTER_CONFIG_NAMES) {
-    if (existsSync(name)) {
+    if (existsSync(join(cwd, name))) {
       found = true
       failFn(`Файл ${name} — видали конфіг MegaLinter (ga.mdc: MegaLinter)`)
     }
@@ -210,16 +215,16 @@ export function checkShellcheckInstalled(passFn, failFn) {
 
 /**
  * Перевіряє розширення workflow-файлів і наявність обов'язкових workflow.
- * @param {string} wfDir шлях до директорії workflows
+ * @param {string} wfDirRel відносний шлях директорії workflows для повідомлень
  * @param {string[]} files список файлів у wfDir
  * @param {(msg: string) => void} pass callback при успішній перевірці
  * @param {(msg: string) => void} fail callback при помилці
  */
-function checkGaWorkflowFiles(wfDir, files, pass, fail) {
+function checkGaWorkflowFiles(wfDirRel, files, pass, fail) {
   const yamlFiles = files.filter(f => f.endsWith('.yaml'))
   if (yamlFiles.length > 0) {
     for (const f of yamlFiles) {
-      fail(`Workflow з розширенням .yaml: ${wfDir}/${f} — перейменуй на .yml`)
+      fail(`Workflow з розширенням .yaml: ${wfDirRel}/${f} — перейменуй на .yml`)
     }
   } else {
     pass('Всі workflows мають розширення .yml')
@@ -228,7 +233,7 @@ function checkGaWorkflowFiles(wfDir, files, pass, fail) {
   const notYmlFiles = files.filter(f => !f.endsWith('.yml'))
   if (notYmlFiles.length > 0) {
     for (const f of notYmlFiles) {
-      fail(`Workflow має бути з розширенням .yml: ${wfDir}/${f} (ga.mdc)`)
+      fail(`Workflow має бути з розширенням .yml: ${wfDirRel}/${f} (ga.mdc)`)
     }
   }
 
@@ -236,7 +241,7 @@ function checkGaWorkflowFiles(wfDir, files, pass, fail) {
     if (files.includes(f)) {
       pass(`${f} існує`)
     } else {
-      fail(`Відсутній ${wfDir}/${f}`)
+      fail(`Відсутній ${wfDirRel}/${f}`)
     }
   }
 }
@@ -277,22 +282,24 @@ const GA_PER_WORKFLOW_REGO_TARGETS = [
  * бо кожен namespace застосовний лише до свого файла), потім один батч-спавн
  * `ga.workflow_common` на всі `.github/workflows/*.yml`. Hard-fail без
  * `conftest` у PATH — узгоджено з Plan B (див. `runConftestBatch`).
- * @param {string} wfDir шлях до `.github/workflows`
+ * @param {string} wfDir абсолютний шлях до `.github/workflows`
  * @param {string[]} ymlWorkflows відносні (від `wfDir`) імена файлів `*.yml`
+ * @param {string} cwd корінь репозиторію
  * @param {(msg: string) => void} pass callback при успішній перевірці
  * @param {(msg: string) => void} fail callback при помилці
  * @returns {void}
  */
-async function runAllGaRego(wfDir, ymlWorkflows, pass, fail) {
+async function runAllGaRego(wfDir, ymlWorkflows, cwd, pass, fail) {
   for (const target of GA_PER_WORKFLOW_REGO_TARGETS) {
-    if (!existsSync(target.workflow)) continue
+    const targetAbs = join(cwd, target.workflow)
+    if (!existsSync(targetAbs)) continue
     const concernDir = join(GA_POLICY_DIR, target.policyDirRel.split('/')[1])
     const tpl = await loadTemplate(concernDir)
     const templateData = tpl[basename(target.workflow)]
     const violations = runConftestBatch({
       policyDirRel: target.policyDirRel,
       namespace: target.namespace,
-      files: [target.workflow],
+      files: [targetAbs],
       templateData
     })
     for (const v of violations) fail(`${target.workflow}: ${v.message}`)
@@ -328,16 +335,18 @@ async function runAllGaRego(wfDir, ymlWorkflows, pass, fail) {
  * config, megalinter залишки тощо). `bun run lint-ga` додатково запускає
  * `actionlint` + `zizmor` зовнішніми тулчейнами і **викликає цю ж `check()`** —
  * тобто rego-частина живе тут, не в `lint-ga.mjs`.
+ * @param {string} [cwd] корінь репозиторію
  * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
  */
-export async function check() {
+export async function check(cwd = process.cwd()) {
   const reporter = createCheckReporter()
   const { pass, fail } = reporter
 
-  const wfDir = '.github/workflows'
+  const wfDirRel = '.github/workflows'
+  const wfDir = join(cwd, wfDirRel)
 
   if (!existsSync(wfDir)) {
-    fail(`Директорія ${wfDir} не існує`)
+    fail(`Директорія ${wfDirRel} не існує`)
     return reporter.getExitCode()
   }
 
@@ -346,23 +355,23 @@ export async function check() {
 
   // Rego-крок (per-workflow + workflow_common) — на початку, як єдине джерело
   // істини для пер-документних структурних правил workflow-файлів.
-  await runAllGaRego(wfDir, ymlWorkflows, pass, fail)
+  await runAllGaRego(wfDir, ymlWorkflows, cwd, pass, fail)
 
-  const setupBunDepsAction = '.github/actions/setup-bun-deps/action.yml'
-  if (existsSync(setupBunDepsAction)) {
-    pass(`${setupBunDepsAction} існує`)
+  const setupBunDepsActionRel = '.github/actions/setup-bun-deps/action.yml'
+  if (existsSync(join(cwd, setupBunDepsActionRel))) {
+    pass(`${setupBunDepsActionRel} існує`)
   } else {
     fail(
-      `Відсутній ${setupBunDepsAction} — запустіть npx @nitra/cursor або скопіюйте з пакету (ga.mdc: composite setup-bun-deps)`
+      `Відсутній ${setupBunDepsActionRel} — запустіть npx @nitra/cursor або скопіюйте з пакету (ga.mdc: composite setup-bun-deps)`
     )
   }
 
-  checkGaWorkflowFiles(wfDir, files, pass, fail)
+  checkGaWorkflowFiles(wfDirRel, files, pass, fail)
 
   await checkApplyWorkflow(wfDir, files, 'apply-k8s.yml', '**/k8s/**/*.yaml', pass, fail)
   await checkApplyWorkflow(wfDir, files, 'apply-nats-consumer.yml', '**/consumer.yaml', pass, fail)
 
-  await checkMegalinter(wfDir, ymlWorkflows, pass, fail)
+  await checkMegalinter(wfDir, ymlWorkflows, wfDirRel, cwd, pass, fail)
 
   // git-залежна перевірка `on.push.paths` glob-ів (вимагає `git ls-files`) —
   // лишається в JS, бо conftest не має доступу до файлової системи репо.
@@ -370,7 +379,7 @@ export async function check() {
     const content = await readFile(join(wfDir, f), 'utf8')
     const parsed = parseWorkflowYaml(content)
     if (parsed) {
-      verifyWorkflowEventPathsGlobsExist(`${wfDir}/${f}`, parsed, pass, fail)
+      verifyWorkflowEventPathsGlobsExist(`${wfDirRel}/${f}`, parsed, pass, fail, cwd)
     }
   }
 

package/rules/graphql/js/tooling.mjs

@@ -5,10 +5,11 @@
  * Обхід репозиторію — **`walkDir`** від **`process.cwd()`** (пропуски як у інших check). Кандидати — **`.vue`** та **`.js`/`.ts`/`.jsx`/`.tsx`** тощо; пропуск **`.d.ts`**, **auto-imports.d.ts** тощо — **`shouldSkipFileForGqlScan`**.
  *
  * Виявлення **`gql`** — **oxc-parser** після витягування `<script>` з SFC (**`graphql-gql-scan.mjs`**). Якщо збігів немає — перевірка завершується успішно без вимог до конфігів.
+ * @param {string} cwd корінь репозиторію
  */
 import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
-import { relative } from 'node:path'
+import { join, relative } from 'node:path'
 
 import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
 import {
@@ -75,20 +76,22 @@ async function collectGqlHits(root, candidates) {
  * @param {(msg: string) => void} pass success-репортер
  * @param {(msg: string) => void} fail fail-репортер
  * @returns {void}
+ * @param {string} cwd корінь репозиторію
  */
-function checkExtensionsRecommendation(pass, fail) {
-  const path = '.vscode/extensions.json'
-  if (!existsSync(path)) {
-    fail(`${path} не існує — створи файл і додай у recommendations ${REQUIRED_GRAPHQL_VSCODE_EXTENSION} (graphql.mdc)`)
+function checkExtensionsRecommendation(pass, fail, cwd) {
+  const pathRel = '.vscode/extensions.json'
+  const pathAbs = join(cwd, pathRel)
+  if (!existsSync(pathAbs)) {
+    fail(`${pathRel} не існує — створи файл і додай у recommendations ${REQUIRED_GRAPHQL_VSCODE_EXTENSION} (graphql.mdc)`)
     return
   }
   const violations = runConftestBatch({
     policyDirRel: 'graphql/vscode_extensions',
     namespace: 'graphql.vscode_extensions',
-    files: [path]
+    files: [pathAbs]
   })
   if (violations.length === 0) {
-    pass(`${path} відповідає graphql.vscode_extensions (rego)`)
+    pass(`${pathRel} відповідає graphql.vscode_extensions (rego)`)
     return
   }
   for (const v of violations) fail(v.message)
@@ -98,12 +101,13 @@ function checkExtensionsRecommendation(pass, fail) {
  * Перевіряє graphql.mdc: умовна вимога .graphqlrc.yml і graphql.vscode-graphql
  * за наявності gql tagged templates.
  * @returns {Promise<number>} 0 — OK, 1 — порушення
+ * @param {string} [cwd] корінь репозиторію
  */
-export async function check() {
+export async function check(cwd = process.cwd()) {
   const reporter = createCheckReporter()
   const { pass, fail } = reporter
 
-  const root = process.cwd()
+  const root = cwd
   const ignorePaths = await loadCursorIgnorePaths(root)
   const candidates = await collectScanCandidates(root, ignorePaths)
   const hits = await collectGqlHits(root, candidates)
@@ -117,7 +121,7 @@ export async function check() {
 
   pass(`Знайдено gql\`…\` у ${hits.length} файлі(ах): ${hits.slice(0, 5).join(', ')}${hits.length > 5 ? '…' : ''}`)
 
-  if (existsSync(GRAPHQL_RC_FILENAME)) {
+  if (existsSync(join(root, GRAPHQL_RC_FILENAME))) {
     pass(`${GRAPHQL_RC_FILENAME} існує`)
   } else {
     fail(
@@ -125,7 +129,7 @@ export async function check() {
     )
   }
 
-  checkExtensionsRecommendation(pass, fail)
+  checkExtensionsRecommendation(pass, fail, root)
 
   return reporter.getExitCode()
 }

package/rules/hasura/js/internal_urls.mjs

@@ -129,14 +129,15 @@ async function collectEnvFiles(root, ignorePaths) {
 /**
  * Перевіряє один `.env` файл на коректність `HASURA_GRAPHQL_ENDPOINT`.
  * Якщо в файлі немає змінної — вважаємо OK.
- * @param {string} relPath відносний шлях файла
+ * @param {string} relPath відносний (posix) шлях файла відносно `cwd` (для повідомлень)
+ * @param {string} cwd корінь репозиторію
  * @param {{ service: string | null, namespace: string | null }} expected очікувані сегменти з YAML
  * @param {{ pass: (msg: string) => void, fail: (msg: string) => void }} reporter репортер
  * @returns {Promise<void>}
  */
-async function checkEnvFile(relPath, expected, reporter) {
+async function checkEnvFile(relPath, cwd, expected, reporter) {
   const { pass, fail } = reporter
-  const content = await readFile(relPath, 'utf8')
+  const content = await readFile(join(cwd, relPath), 'utf8')
   const m = content.match(HASURA_ENDPOINT_LINE_RE)
   if (!m) {
     return
@@ -169,14 +170,16 @@ async function checkEnvFile(relPath, expected, reporter) {
 
 /**
  * Зчитує URL репозиторію з кореневого `package.json` (або null, якщо файла немає / не валідний).
+ * @param {string} cwd корінь репозиторію
  * @returns {Promise<string | null>} URL з поля `repository`
  */
-async function readRootRepositoryUrl() {
-  if (!existsSync('package.json')) {
+async function readRootRepositoryUrl(cwd) {
+  const pkgPath = join(cwd, 'package.json')
+  if (!existsSync(pkgPath)) {
     return null
   }
   try {
-    const pkg = JSON.parse(await readFile('package.json', 'utf8'))
+    const pkg = JSON.parse(await readFile(pkgPath, 'utf8'))
     return getRepositoryUrl(pkg?.repository)
   } catch {
     return null
@@ -198,19 +201,20 @@ export function isNitraOrAbieRepository(url) {
 
 /**
  * Перевіряє hasura.mdc для поточного робочого каталогу.
+ * @param {string} [cwd] корінь репозиторію
  * @returns {Promise<number>} 0 — OK / правило не застосовується, 1 — порушення
  */
-export async function check() {
+export async function check(cwd = process.cwd()) {
   const reporter = createCheckReporter()
   const { pass } = reporter
 
-  const repositoryUrl = await readRootRepositoryUrl()
+  const repositoryUrl = await readRootRepositoryUrl(cwd)
   if (!isNitraOrAbieRepository(repositoryUrl)) {
     pass('Пропущено: репозиторій не nitra і не abie (hasura.mdc застосовується лише до них)')
     return reporter.getExitCode()
   }
 
-  const root = process.cwd()
+  const root = cwd
   const expected = {
     service: await readYamlMetadataName(join(root, HASURA_SVC_HL_FILE), 'Service'),
     namespace: await readYamlMetadataName(join(root, HASURA_NAMESPACE_FILE), 'Namespace')
@@ -224,7 +228,7 @@ export async function check() {
   }
 
   for (const rel of envFiles) {
-    await checkEnvFile(rel, expected, reporter)
+    await checkEnvFile(rel, root, expected, reporter)
   }
 
   // Якщо у файлах не було жодної згадки HASURA_GRAPHQL_ENDPOINT — повідом про це.

package/rules/image-avif/js/avif_generation.mjs

@@ -23,6 +23,7 @@
  * підтримується сучасними браузерами) і не вмикати в публічних сайтах. Перевірка скрипта
  * `lint-image` (заборона `--avif` у ньому) залишається у `image-compress` — тут вона не
  * дублюється.
+ * @param {string} cwd корінь репозиторію
  */
 import { existsSync } from 'node:fs'
 import { readFile, unlink, writeFile } from 'node:fs/promises'
@@ -47,6 +48,7 @@ const PKG_CONFIG_FIELD = '@nitra/minify-image'
  * платформи — `.avif` всередині — це продукт попереднього `bun run build`/Capacitor sync,
  * а не кандидати на видалення. `walkDir` уже скіпає `node_modules`, `.git`, `dist`,
  * `coverage`, `.turbo`, `.next` — додатково для cleanup ігноруємо ще ці.
+ * @param {string} cwd корінь репозиторію
  */
 const CLEANUP_EXTRA_IGNORE_DIR_NAMES = new Set(['build', 'android', 'ios', '.output', '.nuxt', '.cache'])
 
@@ -54,6 +56,7 @@ const CLEANUP_EXTRA_IGNORE_DIR_NAMES = new Set(['build', 'android', 'ios', '.out
  * Регексп для імпортів raster-зображень у `.vue` файлах.
  * Захоплює `import name from '...ext'` (як default, так і type-only форми не потрібні —
  * type-imports asset-ів не існує). Захоплюється повний шлях у групі 1.
+ * @param {string} cwd корінь репозиторію
  */
 const VUE_RASTER_IMPORT_RE = /import\s+\w[\w$]*\s+from\s+['"]([^'"\n]+\.(?:png|jpe?g|gif))['"]/giu
 
@@ -64,6 +67,7 @@ const VUE_RASTER_IMPORT_RE = /import\s+\w[\w$]*\s+from\s+['"]([^'"\n]+\.(?:png|j
  *
  * Лукбехайнд `(?<![:\-_.])` виключає реактивне `:src="..."` (там JS-вираз — змінна або виклик,
  * перевіряється через імпорт), `data-src="..."` і `obj.src=...` у `<script>`.
+ * @param {string} cwd корінь репозиторію
  */
 const VUE_RASTER_STATIC_SRC_RE = /(?<![:\-_.])\bsrc\s*=\s*['"]([^'"\s]+\.(?:png|jpe?g|gif))['"]/giu
 
@@ -72,6 +76,7 @@ const VUE_RASTER_STATIC_SRC_RE = /(?<![:\-_.])\bsrc\s*=\s*['"]([^'"\s]+\.(?:png|
  * так і `<img src="....png.avif" />`). Потрібен лише для збору множини «живих» AVIF —
  * щоб після авто-заміни знати, які `<...>.avif` файли ще на щось посилаються, а які
  * є сиротами і підлягають видаленню.
+ * @param {string} cwd корінь репозиторію
  */
 const VUE_AVIF_REF_RE = /['"]([^'"\s]+\.(?:png|jpe?g|gif)\.avif)['"]/giu
 
@@ -144,6 +149,7 @@ function resolveImageCandidates(importPath, sourceAbsPath, packageRootAbs) {
  * @property {number} rewrittenRefs скільки конкретних посилань переписано на `.avif`
  * @property {number} rewrittenFiles у скількох `.vue`/`.html` файлах хоч одне посилання змінилося
  * @property {number} failedRefs скільки конкретних посилань не вдалося переписати (`.avif` не існував)
+ * @param {string} cwd корінь репозиторію
  */
 
 /**
@@ -166,9 +172,10 @@ function resolveImageCandidates(importPath, sourceAbsPath, packageRootAbs) {
  * @param {RewriteStats} stats глобальні лічильники, що мутуються тут
  * @param {(msg: string) => void} fail callback при помилці
  * @returns {Promise<void>} визначається по завершенню перевірки одного пакета
+ * @param {string} cwd корінь репозиторію
  */
-async function checkVueAvifImportsInPackage(packageRoot, otherRootsAbs, ignorePaths, usedAvifAbs, stats, fail) {
-  const absRoot = join(process.cwd(), packageRoot)
+async function checkVueAvifImportsInPackage(packageRoot, otherRootsAbs, ignorePaths, usedAvifAbs, stats, fail, cwd) {
+  const absRoot = join(cwd, packageRoot)
   const label = packageRoot === '.' ? 'корінь' : packageRoot
   /** @type {string[]} */
   const targetFiles = []
@@ -184,7 +191,7 @@ async function checkVueAvifImportsInPackage(packageRoot, otherRootsAbs, ignorePa
   if (targetFiles.length === 0) return
 
   for (const absPath of targetFiles) {
-    const rel = relative(process.cwd(), absPath).split('\\').join('/')
+    const rel = relative(cwd, absPath).split('\\').join('/')
     const original = await readFile(absPath, 'utf8')
     let updated = original
 
@@ -258,26 +265,27 @@ async function checkVueAvifImportsInPackage(packageRoot, otherRootsAbs, ignorePa
  * @param {RewriteStats} stats глобальні лічильники rewrite/fail (мутуються нижче)
  * @param {(msg: string) => void} pass callback при успішній перевірці
  * @param {(msg: string) => void} fail callback при помилці
+ * @param {string} cwd корінь репозиторію
  * @returns {Promise<string[]>} абсолютні шляхи коренів пакетів з активним opt-out
  */
-async function checkVueAvifImports(ignorePaths, usedAvifAbs, stats, pass, fail) {
-  const roots = await getMonorepoPackageRootDirs()
-  const absRootsByRel = new Map(roots.map(r => [r, join(process.cwd(), r)]))
+async function checkVueAvifImports(ignorePaths, usedAvifAbs, stats, pass, fail, cwd) {
+  const roots = await getMonorepoPackageRootDirs(cwd)
+  const absRootsByRel = new Map(roots.map(r => [r, join(cwd, r)]))
   /** @type {string[]} */
   const optedOutAbs = []
   for (const root of roots) {
-    const pkgPath = join(root, 'package.json')
+    const pkgPath = join(cwd, root, 'package.json')
     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"`
       )
-      optedOutAbs.push(absRootsByRel.get(root) ?? join(process.cwd(), root))
+      optedOutAbs.push(absRootsByRel.get(root) ?? join(cwd, root))
       continue
     }
     const otherRootsAbs = roots.filter(r => r !== root && r !== '.').map(r => absRootsByRel.get(r) ?? '')
-    await checkVueAvifImportsInPackage(root, otherRootsAbs, ignorePaths, usedAvifAbs, stats, fail)
+    await checkVueAvifImportsInPackage(root, otherRootsAbs, ignorePaths, usedAvifAbs, stats, fail, cwd)
   }
   return optedOutAbs
 }
@@ -296,17 +304,18 @@ async function checkVueAvifImports(ignorePaths, usedAvifAbs, stats, pass, fail)
  * все одно не сканували б, тож вони не мають провокувати запуск AVIF-етапу).
  * @param {string[]} ignorePaths абсолютні шляхи каталогів, повністю виключених з обходу
  * @returns {Promise<boolean>} `true`, якщо знайдено принаймні одне raster-посилання
+ * @param {string} cwd корінь репозиторію
  */
-async function hasAnyVueRasterReference(ignorePaths) {
-  const roots = await getMonorepoPackageRootDirs()
-  const absRootsByRel = new Map(roots.map(r => [r, join(process.cwd(), r)]))
+async function hasAnyVueRasterReference(ignorePaths, cwd) {
+  const roots = await getMonorepoPackageRootDirs(cwd)
+  const absRootsByRel = new Map(roots.map(r => [r, join(cwd, r)]))
   for (const root of roots) {
-    const pkgPath = join(root, 'package.json')
+    const pkgPath = join(cwd, root, 'package.json')
     if (existsSync(pkgPath)) {
       const pkg = JSON.parse(await readFile(pkgPath, 'utf8'))
       if (packageHasAvifDisabled(pkg)) continue
     }
-    const absRoot = absRootsByRel.get(root) ?? join(process.cwd(), root)
+    const absRoot = absRootsByRel.get(root) ?? join(cwd, root)
     const otherRootsAbs = roots.filter(r => r !== root && r !== '.').map(r => absRootsByRel.get(r) ?? '')
     /** @type {string[]} */
     const targetFiles = []
@@ -338,8 +347,9 @@ async function hasAnyVueRasterReference(ignorePaths) {
  * відсутні `.avif` фейлять окремо). У тестах та інших ізольованих середовищах npx
  * можна вимкнути через `NITRA_CURSOR_NO_AVIF_RUN=1` — тоді ця функція no-op.
  * @returns {void}
+ * @param {string} cwd корінь репозиторію
  */
-function runAvifGeneration() {
+function runAvifGeneration(cwd) {
   if (env.NITRA_CURSOR_NO_AVIF_RUN === '1') return
   const npxPath = resolveCmd('npx')
   if (!npxPath) {
@@ -350,6 +360,7 @@ function runAvifGeneration() {
   }
   const result = spawnSync(npxPath, [MINIFY_PACKAGE_NAME, '--src=.', '--write', '--avif'], {
     stdio: 'inherit',
+    cwd,
     env
   })
   if (result.error) {
@@ -379,12 +390,13 @@ function runAvifGeneration() {
  * `.avif` під ними не вважаємо сиротами і не видаляємо
  * @param {string[]} ignorePaths абсолютні шляхи каталогів, повністю виключених з обходу
  * @returns {Promise<number>} кількість видалених сиріт
+ * @param {string} cwd корінь репозиторію
  */
-async function cleanupOrphanAvifs(usedAvifAbs, optedOutAbs, ignorePaths) {
+async function cleanupOrphanAvifs(usedAvifAbs, optedOutAbs, ignorePaths, cwd) {
   /** @type {string[]} */
   const orphans = []
   await walkDir(
-    process.cwd(),
+    cwd,
     absPath => {
       if (!absPath.endsWith('.avif')) return
       if (usedAvifAbs.has(absPath)) return
@@ -404,27 +416,28 @@ async function cleanupOrphanAvifs(usedAvifAbs, optedOutAbs, ignorePaths) {
 /**
  * Виконує AVIF-етап: запуск AVIF-генерації, авто-заміна raster-посилань у `.vue`/`.html`,
  * видалення AVIF-сиріт. Не валідує `package.json`/`lint-image` — це вже у `image-compress`.
+ * @param {string} [cwd] корінь репозиторію
  * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
  */
-export async function check() {
+export async function check(cwd = process.cwd()) {
   const reporter = createCheckReporter()
   const { pass, fail } = reporter
 
-  const ignorePaths = await loadCursorIgnorePaths(process.cwd())
+  const ignorePaths = await loadCursorIgnorePaths(cwd)
 
-  if (!(await hasAnyVueRasterReference(ignorePaths))) {
+  if (!(await hasAnyVueRasterReference(ignorePaths, cwd))) {
     pass('image-avif: у .vue/.html немає raster-посилань для переписування — AVIF-генерація і cleanup пропущені')
     return reporter.getExitCode()
   }
 
-  runAvifGeneration()
+  runAvifGeneration(cwd)
 
   /** @type {Set<string>} */
   const usedAvifAbs = new Set()
   /** @type {RewriteStats} */
   const stats = { rewrittenRefs: 0, rewrittenFiles: 0, failedRefs: 0 }
-  const optedOutAbs = await checkVueAvifImports(ignorePaths, usedAvifAbs, stats, pass, fail)
-  const orphansDeleted = await cleanupOrphanAvifs(usedAvifAbs, optedOutAbs, ignorePaths)
+  const optedOutAbs = await checkVueAvifImports(ignorePaths, usedAvifAbs, stats, pass, fail, cwd)
+  const orphansDeleted = await cleanupOrphanAvifs(usedAvifAbs, optedOutAbs, ignorePaths, cwd)
 
   pass(
     `image-avif: rewrote ${stats.rewrittenRefs} reference${stats.rewrittenRefs === 1 ? '' : 's'} in ${stats.rewrittenFiles} file${stats.rewrittenFiles === 1 ? '' : 's'}; ` +

package/rules/image-compress/js/package_setup.mjs

@@ -18,6 +18,7 @@
  */
 import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
+import { join } from 'node:path'
 
 import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
 
@@ -29,11 +30,13 @@ const LEGACY_CACHE_FILENAME = '.minify-image-cache.tsv'
 
 /**
  * Зчитує всі змістовні рядки `.gitignore` (без коментарів і порожніх). Якщо файла нема — `null`.
+ * @param {string} cwd корінь репозиторію
  * @returns {Promise<string[] | null>} список trim-нутих рядків або `null`
  */
-async function readGitignoreLines() {
-  if (!existsSync('.gitignore')) return null
-  const raw = await readFile('.gitignore', 'utf8')
+async function readGitignoreLines(cwd) {
+  const gitignorePath = join(cwd, '.gitignore')
+  if (!existsSync(gitignorePath)) return null
+  const raw = await readFile(gitignorePath, 'utf8')
   return raw
     .split('\n')
     .map(l => l.trim())
@@ -49,9 +52,10 @@ async function readGitignoreLines() {
  * @param {(msg: string) => void} pass callback при успішній перевірці
  * @param {(msg: string) => void} fail callback при помилці
  * @returns {Promise<void>}
+ * @param {string} cwd корінь репозиторію
  */
-async function checkHashCacheNotIgnored(pass, fail) {
-  const lines = await readGitignoreLines()
+async function checkHashCacheNotIgnored(pass, fail, cwd) {
+  const lines = await readGitignoreLines(cwd)
   if (lines && lines.includes(HASH_CACHE_FILENAME)) {
     fail(
       `.gitignore: прибери рядок \`${HASH_CACHE_FILENAME}\` — це закомічений source of truth split-cache 3.2.0 (image-compress.mdc)`
@@ -68,9 +72,10 @@ async function checkHashCacheNotIgnored(pass, fail) {
  * @param {(msg: string) => void} pass callback при успішній перевірці
  * @param {(msg: string) => void} fail callback при помилці
  * @returns {Promise<void>}
+ * @param {string} cwd корінь репозиторію
  */
-async function checkLegacyCacheRemoved(pass, fail) {
-  if (existsSync(LEGACY_CACHE_FILENAME)) {
+async function checkLegacyCacheRemoved(pass, fail, cwd) {
+  if (existsSync(join(cwd, LEGACY_CACHE_FILENAME))) {
     fail(
       `${LEGACY_CACHE_FILENAME} застарілий (split-cache 3.2.0) — видали: ` +
         `\`git rm --cached ${LEGACY_CACHE_FILENAME} 2>/dev/null || true && rm -f ${LEGACY_CACHE_FILENAME}\` ` +
@@ -78,7 +83,7 @@ async function checkLegacyCacheRemoved(pass, fail) {
     )
     return
   }
-  const lines = await readGitignoreLines()
+  const lines = await readGitignoreLines(cwd)
   if (lines && lines.includes(LEGACY_CACHE_FILENAME)) {
     fail(`.gitignore: прибери застарілий рядок \`${LEGACY_CACHE_FILENAME}\` — split-cache 3.2.0 його не використовує`)
     return
@@ -90,20 +95,21 @@ async function checkLegacyCacheRemoved(pass, fail) {
  * Перевіряє відповідність проєкту правилу `image-compress.mdc`: `.n-minify-image.tsv` НЕ
  * в `.gitignore`, застарілий `.minify-image-cache.tsv` видалений. CI-workflow для image
  * не вимагається — лінт зображень виконується лише локально.
+ * @param {string} [cwd] корінь репозиторію
  * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
  */
-export async function check() {
+export async function check(cwd = process.cwd()) {
   const reporter = createCheckReporter()
   const { pass, fail } = reporter
 
-  if (!existsSync('package.json')) {
+  if (!existsSync(join(cwd, 'package.json'))) {
     fail('package.json не знайдено в корені — додай (image-compress.mdc)')
     return reporter.getExitCode()
   }
   pass('package.json є (структуру перевіряє npx @nitra/cursor fix → image_compress.package_json)')
 
-  await checkHashCacheNotIgnored(pass, fail)
-  await checkLegacyCacheRemoved(pass, fail)
+  await checkHashCacheNotIgnored(pass, fail, cwd)
+  await checkLegacyCacheRemoved(pass, fail, cwd)
 
   return reporter.getExitCode()
 }