@nitra/cursor 1.27.7 → 1.28.0

package/rules/js-bun-db/js/safety.mjs

@@ -327,13 +327,14 @@ function messageForBunSqlInListGuard(rel, v) {
 
 /**
  * Перевіряє відповідність проєкту правилу js-bun-db.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 repoRoot = process.cwd()
+  const repoRoot = cwd
   const rootPkg = join(repoRoot, 'package.json')
   if (!existsSync(rootPkg)) {
     pass('js-bun-db: package.json у корені відсутній — перевірку пропущено')

package/rules/js-lint/js/tooling.mjs

@@ -9,6 +9,7 @@
  *
  * Per-document вимоги (`lint-js`, `@nitra/eslint-config`, root `engines`, `.jscpd.json`,
  * `.vscode/extensions.json`, `lint-js.yml`) — у policy-пакетах `js_lint.*`.
+ * @param {string} cwd корінь репозиторію
  */
 import { existsSync } from 'node:fs'
 import { copyFile, readFile } from 'node:fs/promises'
@@ -170,20 +171,21 @@ export function verifyOxlintRcAgainstCanonical(cfg, canonical) {
  * Перевіряє ESLint flat config файл.
  * @param {(msg: string) => void} passFn callback при успішній перевірці
  * @param {(msg: string) => void} failFn callback при помилці
+ * @param {string} cwd корінь репозиторію
  */
-async function checkEslintConfig(passFn, failFn) {
+async function checkEslintConfig(passFn, failFn, cwd) {
   let eslintPath
-  if (existsSync('eslint.config.js')) {
+  if (existsSync(join(cwd, 'eslint.config.js'))) {
     eslintPath = 'eslint.config.js'
     passFn('eslint.config.js існує')
-  } else if (existsSync('eslint.config.mjs')) {
+  } else if (existsSync(join(cwd, 'eslint.config.mjs'))) {
     eslintPath = 'eslint.config.mjs'
     passFn('eslint.config.mjs існує')
   } else {
     failFn('Відсутній eslint.config.js або eslint.config.mjs — flat config з getConfig (js-lint.mdc)')
     return
   }
-  const eslintRaw = await readFile(eslintPath, 'utf8')
+  const eslintRaw = await readFile(join(cwd, eslintPath), 'utf8')
   const checks = [
     {
       needle: 'getConfig',
@@ -236,15 +238,17 @@ function checkPackageJsonTypeModule(label, pkg, passFn, failFn) {
  * @param {unknown[]} workspaces поле workspaces з package.json
  * @param {(msg: string) => void} passFn callback при успішній перевірці
  * @param {(msg: string) => void} failFn callback при помилці
+ * @param {string} cwd корінь репозиторію
  */
-async function checkWorkspacePackages(workspaces, passFn, failFn) {
+async function checkWorkspacePackages(workspaces, passFn, failFn, cwd) {
   for (const ws of workspaces) {
-    const wsPkgPath = `${ws}/package.json`
-    if (existsSync(wsPkgPath)) {
-      const wsPkg = JSON.parse(await readFile(wsPkgPath, 'utf8'))
-      checkPackageJsonTypeModule(wsPkgPath, wsPkg, passFn, failFn)
-      checkEnginesNode(wsPkgPath, wsPkg, passFn, failFn)
-      checkEnginesBun(wsPkgPath, wsPkg, passFn, failFn)
+    const wsPkgRel = `${ws}/package.json`
+    const wsPkgAbs = join(cwd, wsPkgRel)
+    if (existsSync(wsPkgAbs)) {
+      const wsPkg = JSON.parse(await readFile(wsPkgAbs, 'utf8'))
+      checkPackageJsonTypeModule(wsPkgRel, wsPkg, passFn, failFn)
+      checkEnginesNode(wsPkgRel, wsPkg, passFn, failFn)
+      checkEnginesBun(wsPkgRel, wsPkg, passFn, failFn)
     }
   }
 }
@@ -298,27 +302,31 @@ function checkEnginesBun(label, pkg, passFn, failFn) {
  * — теж у Rego.
  * @param {(msg: string) => void} passFn callback при успішній перевірці
  * @param {(msg: string) => void} failFn callback при помилці
+ * @param {string} cwd корінь репозиторію
  */
-async function checkPackageJsonJsLint(passFn, failFn) {
-  if (!existsSync('package.json')) return
-  const pkg = JSON.parse(await readFile('package.json', 'utf8'))
+async function checkPackageJsonJsLint(passFn, failFn, cwd) {
+  const pkgPath = join(cwd, 'package.json')
+  if (!existsSync(pkgPath)) return
+  const pkg = JSON.parse(await readFile(pkgPath, 'utf8'))
   const workspaces = Array.isArray(pkg.workspaces) ? pkg.workspaces : []
-  await checkWorkspacePackages(workspaces, passFn, failFn)
+  await checkWorkspacePackages(workspaces, passFn, failFn, cwd)
 }
 
 /**
  * Перевіряє .oxlintrc.json.
  * @param {(msg: string) => void} passFn callback при успішній перевірці
  * @param {(msg: string) => void} failFn callback при помилці
+ * @param {string} cwd корінь репозиторію
  */
-async function checkOxlintRc(passFn, failFn) {
-  if (!existsSync('.oxlintrc.json')) {
+async function checkOxlintRc(passFn, failFn, cwd) {
+  const oxPath = join(cwd, '.oxlintrc.json')
+  if (!existsSync(oxPath)) {
     failFn('.oxlintrc.json не існує — додай конфіг oxlint (js-lint.mdc)')
     return
   }
   let oxCfg
   try {
-    oxCfg = JSON.parse(await readFile('.oxlintrc.json', 'utf8'))
+    oxCfg = JSON.parse(await readFile(oxPath, 'utf8'))
   } catch {
     failFn('.oxlintrc.json не є валідним JSON')
     return
@@ -348,16 +356,18 @@ async function checkOxlintRc(passFn, failFn) {
  * заборона `--fix` у CI) валідує `npm/policy/js_lint/lint_js_yml/`.
  * @param {(msg: string) => void} passFn callback при успішній перевірці
  * @param {(msg: string) => void} failFn callback при помилці
+ * @param {string} cwd корінь репозиторію
  */
-async function checkLintJsWorkflows(passFn, failFn) {
-  if (existsSync('.github/workflows/lint-js.yml')) {
+async function checkLintJsWorkflows(passFn, failFn, cwd) {
+  if (existsSync(join(cwd, '.github/workflows/lint-js.yml'))) {
     passFn('.github/workflows/lint-js.yml є (структуру перевіряє npx @nitra/cursor fix → js_lint.lint_js_yml)')
   } else {
     failFn('.github/workflows/lint-js.yml не існує — створи його (див. rules/js-lint/fix.mjs / js-lint.mdc)')
   }
 
-  if (existsSync('.github/workflows/lint.yml')) {
-    const lintYml = await readFile('.github/workflows/lint.yml', 'utf8')
+  const lintYmlPath = join(cwd, '.github/workflows/lint.yml')
+  if (existsSync(lintYmlPath)) {
+    const lintYml = await readFile(lintYmlPath, 'utf8')
     if (lintYml.includes('bunx oxlint') && lintYml.includes('bunx eslint') && lintYml.includes('jscpd')) {
       failFn('.github/workflows/lint.yml дублює кроки lint-js.yml — залиш один workflow на лінт JS (js-lint.mdc)')
     } else {
@@ -374,9 +384,11 @@ async function checkLintJsWorkflows(passFn, failFn) {
  * будь-які; це side effect — описано у js-lint.mdc).
  * @param {(msg: string) => void} passFn callback при успішній перевірці
  * @param {(msg: string) => void} failFn callback при помилці
+ * @param {string} cwd корінь репозиторію
  */
-async function checkKnipConfig(passFn, failFn) {
-  if (existsSync('knip.json')) {
+async function checkKnipConfig(passFn, failFn, cwd) {
+  const knipPath = join(cwd, 'knip.json')
+  if (existsSync(knipPath)) {
     passFn('knip.json існує')
     return
   }
@@ -387,26 +399,27 @@ async function checkKnipConfig(passFn, failFn) {
     )
     return
   }
-  await copyFile(KNIP_CANONICAL_JSON_PATH, 'knip.json')
+  await copyFile(KNIP_CANONICAL_JSON_PATH, knipPath)
   passFn('knip.json створено з канонічного npm/rules/js-lint/js/data/tooling/knip-canonical.json (js-lint.mdc)')
 }
 
 /**
  * Перевіряє відповідність проєкту правилам js-lint.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, fail } = reporter
 
-  await checkEslintConfig(pass, fail)
-  await checkPackageJsonJsLint(pass, fail)
-  await checkOxlintRc(pass, fail)
-  await checkLintJsWorkflows(pass, fail)
-  await checkKnipConfig(pass, fail)
+  await checkEslintConfig(pass, fail, cwd)
+  await checkPackageJsonJsLint(pass, fail, cwd)
+  await checkOxlintRc(pass, fail, cwd)
+  await checkLintJsWorkflows(pass, fail, cwd)
+  await checkKnipConfig(pass, fail, cwd)
 
   for (const dup of ['.eslintrc', '.eslintrc.js', '.eslintrc.json', '.eslintrc.yml']) {
-    if (existsSync(dup)) fail(`Знайдено застарілий конфіг ESLint: ${dup} — видали, використовуй flat config`)
+    if (existsSync(join(cwd, dup))) fail(`Знайдено застарілий конфіг ESLint: ${dup} — видали, використовуй flat config`)
   }
 
   return reporter.getExitCode()

package/rules/js-run/js/runtime.mjs

@@ -31,6 +31,7 @@
  *
  * Per-document валідація `package.json` (bunyan, `node` у `scripts`) делегована rego-пакету
  * `js_run.package_json` у `npm/rules/js-run/policy/package_json/`; JS — cross-file (AST, FS).
+ * @param {string} cwd корінь репозиторію
  */
 import { existsSync, statSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
@@ -78,11 +79,12 @@ function backendPackageHasSrcDir(absPackageRoot) {
  * @param {(msg: string) => void} fail callback для повідомлень про порушення
  * @param {(msg: string) => void} passFn callback для повідомлень про успішну перевірку
  * @returns {void}
+ * @param {string} cwd корінь репозиторію
  */
-function checkBackendJsconfigWhenSrcPresent(rootDir, absPackageRoot, label, fail, passFn) {
+function checkBackendJsconfigWhenSrcPresent(rootDir, absPackageRoot, label, fail, passFn, cwd) {
   if (!backendPackageHasSrcDir(absPackageRoot)) return
 
-  const jcPath = join(rootDir, 'jsconfig.json')
+  const jcPath = join(cwd, rootDir, 'jsconfig.json')
   if (!existsSync(jcPath)) {
     fail(
       `${label}є каталог src/, але немає jsconfig.json — додай канонічний файл з js-run.mdc ` +
@@ -318,11 +320,12 @@ async function checkPromiseSetTimeoutPause(absPackageRoot, sourcePaths, label, f
  * @param {(msg: string) => void} fail функція зворотного виклику для реєстрації помилки перевірки
  * @param {(msg: string) => void} passFn успішне повідомлення (як у check-reporter)
  * @returns {Promise<void>} завершується після перевірок цього пакета
+ * @param {string} cwd корінь репозиторію
  */
-async function checkWorkspacePackage(rootDir, ignorePaths, fail, passFn) {
+async function checkWorkspacePackage(rootDir, ignorePaths, fail, passFn, cwd) {
   const label = `[${rootDir}] `
-  const absPackageRoot = join(process.cwd(), rootDir)
-  const pkgJson = await loadPackageJson(rootDir)
+  const absPackageRoot = join(cwd, rootDir)
+  const pkgJson = await loadPackageJson(rootDir, cwd)
 
   // Frontend-пакети (vite у devDependencies) виходять за межі js-run:
   // браузерний бандл не має `node:process`, а `process.env.*` бандлер
@@ -333,7 +336,7 @@ async function checkWorkspacePackage(rootDir, ignorePaths, fail, passFn) {
     return
   }
 
-  await checkBackendJsconfigWhenSrcPresent(rootDir, absPackageRoot, label, fail, passFn)
+  await checkBackendJsconfigWhenSrcPresent(rootDir, absPackageRoot, label, fail, passFn, cwd)
 
   const importViolations = await checkBunyanImports(absPackageRoot, ignorePaths, label, fail)
   if (importViolations === 0) {
@@ -368,7 +371,7 @@ async function checkWorkspacePackage(rootDir, ignorePaths, fail, passFn) {
     passFn(`${label}немає 'new Promise(r => setTimeout(r, ms))' — паузи через 'node:timers/promises'`)
   }
 
-  checkOtelConfigmap(rootDir, passFn)
+  checkOtelConfigmap(rootDir, passFn, cwd)
 }
 
 /**
@@ -392,9 +395,10 @@ function packageJsonHasViteDevDependency(pkgJson) {
  * лише AST-перевірка імпортів.
  * @param {string} rootDir відносний шлях workspace
  * @returns {Promise<unknown>} розпарсений package.json або null
+ * @param {string} cwd корінь репозиторію
  */
-async function loadPackageJson(rootDir) {
-  const pkgPath = join(rootDir, 'package.json')
+async function loadPackageJson(rootDir, cwd) {
+  const pkgPath = join(cwd, rootDir, 'package.json')
   if (!existsSync(pkgPath)) return null
   return JSON.parse(await readFile(pkgPath, 'utf8'))
 }
@@ -407,9 +411,10 @@ async function loadPackageJson(rootDir) {
  * @param {string} rootDir відносний шлях workspace
  * @param {(msg: string) => void} passFn успішне повідомлення
  * @returns {void}
+ * @param {string} cwd корінь репозиторію
  */
-function checkOtelConfigmap(rootDir, passFn) {
-  const configmapPath = join(rootDir, 'k8s', 'base', 'configmap.yaml')
+function checkOtelConfigmap(rootDir, passFn, cwd) {
+  const configmapPath = join(cwd, rootDir, 'k8s', 'base', 'configmap.yaml')
   if (!existsSync(configmapPath)) return
   passFn(`${rootDir}/k8s/base/configmap.yaml є (OTEL — npx @nitra/cursor fix → js_run.configmap)`)
 }
@@ -417,12 +422,13 @@ function checkOtelConfigmap(rootDir, passFn) {
 /**
  * Перевіряє відповідність проєкту правилам js-run.mdc лише для workspace-пакетів (не корінь репо).
  * @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 roots = await getMonorepoPackageRootDirs()
+  const roots = await getMonorepoPackageRootDirs(cwd)
   const workspaceRoots = roots.filter(r => r !== '.')
 
   if (workspaceRoots.length === 0) {
@@ -430,9 +436,9 @@ export async function check() {
     return reporter.getExitCode()
   }
 
-  const ignorePaths = await loadCursorIgnorePaths(process.cwd())
+  const ignorePaths = await loadCursorIgnorePaths(cwd)
   for (const r of workspaceRoots) {
-    await checkWorkspacePackage(r, ignorePaths, fail, pass)
+    await checkWorkspacePackage(r, ignorePaths, fail, pass, cwd)
   }
 
   return reporter.getExitCode()

package/rules/k8s/js/manifests.mjs

@@ -6773,13 +6773,14 @@ function runAllK8sRego(root, yamlFiles, fail) {
 
 /**
  * Точка входу `check k8s`: повний набір перевірок маніфестів і структури `…/k8s` (див. JSDoc на початку файлу).
+ * @param {string} [cwd] корінь репозиторію
  * @returns {Promise<number>} `process.exitCode`: 0 при успіху, 1 при будь-якому `fail(...)`
  */
-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)
 
   await rewriteBatchV1beta1ApiVersionInK8sYamlFiles(root, ignorePaths, fail, pass)

package/rules/nginx-default-tpl/js/template.mjs

@@ -397,13 +397,14 @@ function checkVscodeNginx(passFn, failFn) {
 
 /**
  * Перевіряє відповідність проєкту правилам nginx-default-tpl.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, fail } = reporter
 
-  const root = process.cwd()
+  const root = cwd
   const ignorePaths = await loadCursorIgnorePaths(root)
 
   const { renamed: tplRenamed, overwritten: tplOverwritten } = await migrateDefaultTplConfFiles(root, ignorePaths)