@nitra/cursor 1.8.171 → 1.8.177

package/scripts/check-vue.mjs

@@ -20,6 +20,7 @@ import {
   isVueImportScanSourceFile,
   shouldSkipFileForVueImportScan
 } from './utils/vue-forbidden-imports.mjs'
+import { loadCursorIgnorePaths } from './utils/load-cursor-config.mjs'
 import { walkDir } from './utils/walkDir.mjs'
 import { getMonorepoPackageRootDirs } from './utils/workspaces.mjs'
 
@@ -113,14 +114,18 @@ async function collectEsbuildMatchesInFiles(absPackageRoot, files, maxMatches) {
  * @param {(msg: string) => void} passFn callback при успішній перевірці
  * @param {(msg: string) => void} fail callback при помилці
  */
-async function checkEsbuildMentions(rootDir, absPackageRoot, prefix, passFn, fail) {
+async function checkEsbuildMentions(rootDir, absPackageRoot, ignorePaths, prefix, passFn, fail) {
   /** @type {{ rel: string }[]} */
   const candidates = []
-  await walkDir(absPackageRoot, absPath => {
-    const rel = relative(absPackageRoot, absPath).split('\\').join('/')
-    if (!isEsbuildScanFile(rel)) return
-    candidates.push({ rel })
-  })
+  await walkDir(
+    absPackageRoot,
+    absPath => {
+      const rel = relative(absPackageRoot, absPath).split('\\').join('/')
+      if (!isEsbuildScanFile(rel)) return
+      candidates.push({ rel })
+    },
+    ignorePaths
+  )
 
   const maxMatches = 30
   const matches = await collectEsbuildMatchesInFiles(absPackageRoot, candidates, maxMatches)
@@ -308,7 +313,7 @@ async function checkViteConfig(rootDir, prefix, passFn, fail) {
  * @param {(msg: string) => void} passFn callback при успішній перевірці
  * @param {(msg: string) => void} fail callback при помилці
  */
-async function checkVueImportViolations(rootDir, absPackageRoot, hasVueAutoImport, prefix, passFn, fail) {
+async function checkVueImportViolations(rootDir, absPackageRoot, ignorePaths, hasVueAutoImport, prefix, passFn, fail) {
   if (!hasVueAutoImport) {
     passFn(
       `${prefix}value-імпорти з 'vue' не заборонені — спершу додай 'vue' до AutoImport.imports у vite.config`
@@ -317,12 +322,16 @@ async function checkVueImportViolations(rootDir, absPackageRoot, hasVueAutoImpor
   }
   /** @type {string[]} */
   const sourcePaths = []
-  await walkDir(absPackageRoot, absPath => {
-    const rel = relative(absPackageRoot, absPath).split('\\').join('/')
-    if (!shouldSkipFileForVueImportScan(rel) && isVueImportScanSourceFile(rel)) {
-      sourcePaths.push(absPath)
-    }
-  })
+  await walkDir(
+    absPackageRoot,
+    absPath => {
+      const rel = relative(absPackageRoot, absPath).split('\\').join('/')
+      if (!shouldSkipFileForVueImportScan(rel) && isVueImportScanSourceFile(rel)) {
+        sourcePaths.push(absPath)
+      }
+    },
+    ignorePaths
+  )
 
   let importViolations = 0
   for (const absPath of sourcePaths) {
@@ -347,7 +356,7 @@ async function checkVueImportViolations(rootDir, absPackageRoot, hasVueAutoImpor
  * @param {(msg: string) => void} passFn успішне повідомлення (як у check-reporter)
  * @returns {Promise<void>} завершується після перевірок залежностей, `vite.config` і сканування джерел на імпорти з `vue`
  */
-async function checkVuePackage(rootDir, fail, passFn) {
+async function checkVuePackage(rootDir, ignorePaths, fail, passFn) {
   const prefix = `[${packageLabel(rootDir)}] `
   const pkg = JSON.parse(await readFile(join(rootDir, 'package.json'), 'utf8'))
   const deps = pkg.dependencies || {}
@@ -387,8 +396,8 @@ async function checkVuePackage(rootDir, fail, passFn) {
   )
 
   const { hasVueAutoImport } = await checkViteConfig(rootDir, prefix, passFn, fail)
-  await checkVueImportViolations(rootDir, join(process.cwd(), rootDir), hasVueAutoImport, prefix, passFn, fail)
-  await checkEsbuildMentions(rootDir, join(process.cwd(), rootDir), prefix, passFn, fail)
+  await checkVueImportViolations(rootDir, join(process.cwd(), rootDir), ignorePaths, hasVueAutoImport, prefix, passFn, fail)
+  await checkEsbuildMentions(rootDir, join(process.cwd(), rootDir), ignorePaths, prefix, passFn, fail)
 }
 
 /**
@@ -446,8 +455,9 @@ export async function check() {
 
   await checkVueVolarRecommendation(pass, fail)
 
+  const ignorePaths = await loadCursorIgnorePaths(process.cwd())
   for (const r of vueRoots) {
-    await checkVuePackage(r, fail, pass)
+    await checkVuePackage(r, ignorePaths, fail, pass)
   }
 
   return reporter.getExitCode()

package/scripts/rename-yaml-extensions.mjs

@@ -14,6 +14,7 @@ import { rename } from 'node:fs/promises'
 import { cwd } from 'node:process'
 import { relative, resolve } from 'node:path'
 
+import { loadCursorIgnorePaths } from './utils/load-cursor-config.mjs'
 import { walkDir } from './utils/walkDir.mjs'
 
 const K8S_YML_RE = /\.yml$/iu
@@ -69,37 +70,41 @@ export function replaceExtension(relPosix, newExt) {
  * @param {string} rootAbs абсолютний корінь репозиторію
  * @returns {Promise<Array<{ kind: 'k8s' | 'github', fromAbs: string, toAbs: string, relFrom: string, relTo: string }>>} відсортовані операції перейменування без запису на диск
  */
-async function collectRenameOps(rootAbs) {
+async function collectRenameOps(rootAbs, ignorePaths) {
   /** @type {Array<{ kind: 'k8s' | 'github', fromAbs: string, toAbs: string, relFrom: string, relTo: string }>} */
   const ops = []
 
-  await walkDir(rootAbs, fileAbs => {
-    const rel = posixRelFromRoot(rootAbs, fileAbs)
-    if (rel === null) return
-    if (pathMatchesK8sYml(rel)) {
-      const relTo = replaceExtension(rel, '.yaml')
-      if (relTo === rel) return
-      ops.push({
-        kind: 'k8s',
-        fromAbs: resolve(rootAbs, rel),
-        toAbs: resolve(rootAbs, relTo),
-        relFrom: rel,
-        relTo
-      })
-      return
-    }
-    if (pathMatchesGithubYaml(rel)) {
-      const relTo = replaceExtension(rel, '.yml')
-      if (relTo === rel) return
-      ops.push({
-        kind: 'github',
-        fromAbs: resolve(rootAbs, rel),
-        toAbs: resolve(rootAbs, relTo),
-        relFrom: rel,
-        relTo
-      })
-    }
-  })
+  await walkDir(
+    rootAbs,
+    fileAbs => {
+      const rel = posixRelFromRoot(rootAbs, fileAbs)
+      if (rel === null) return
+      if (pathMatchesK8sYml(rel)) {
+        const relTo = replaceExtension(rel, '.yaml')
+        if (relTo === rel) return
+        ops.push({
+          kind: 'k8s',
+          fromAbs: resolve(rootAbs, rel),
+          toAbs: resolve(rootAbs, relTo),
+          relFrom: rel,
+          relTo
+        })
+        return
+      }
+      if (pathMatchesGithubYaml(rel)) {
+        const relTo = replaceExtension(rel, '.yml')
+        if (relTo === rel) return
+        ops.push({
+          kind: 'github',
+          fromAbs: resolve(rootAbs, rel),
+          toAbs: resolve(rootAbs, relTo),
+          relFrom: rel,
+          relTo
+        })
+      }
+    },
+    ignorePaths
+  )
 
   ops.sort((a, b) => {
     const ko = (a.kind === 'k8s' ? 0 : 1) - (b.kind === 'k8s' ? 0 : 1)
@@ -119,7 +124,8 @@ async function collectRenameOps(rootAbs) {
 export async function renameYamlExtensions(root, options = {}) {
   const dryRun = options.dryRun === true
   const rootAbs = resolve(root)
-  const ops = await collectRenameOps(rootAbs)
+  const ignorePaths = await loadCursorIgnorePaths(rootAbs)
+  const ops = await collectRenameOps(rootAbs, ignorePaths)
 
   /** @type { { relFrom: string, relTo: string }[]} */
   const renamed = []

package/scripts/run-docker.mjs

@@ -12,6 +12,7 @@ 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'
 
 /**
@@ -30,12 +31,16 @@ export function isLintDockerfileName(name) {
  * @param {string} root корінь репозиторію
  * @returns {Promise<string[]>} відсортовані абсолютні шляхи
  */
-export async function findLintDockerfilePaths(root) {
+export async function findLintDockerfilePaths(root, ignorePaths = []) {
   /** @type {string[]} */
   const out = []
-  await walkDir(root, p => {
-    if (isLintDockerfileName(basename(p))) out.push(p)
-  })
+  await walkDir(
+    root,
+    p => {
+      if (isLintDockerfileName(basename(p))) out.push(p)
+    },
+    ignorePaths
+  )
   return out.toSorted((a, b) => a.localeCompare(b))
 }
 
@@ -48,7 +53,8 @@ async function main() {
   const { pass, fail } = reporter
 
   const root = process.cwd()
-  const files = await findLintDockerfilePaths(root)
+  const ignorePaths = await loadCursorIgnorePaths(root)
+  const files = await findLintDockerfilePaths(root, ignorePaths)
 
   if (files.length === 0) {
     pass('lint-docker: немає Dockerfile / *.Dockerfile — hadolint пропущено')

package/scripts/run-k8s.mjs

@@ -16,6 +16,7 @@ import { spawnSync } from 'node:child_process'
 import { basename, dirname } from 'node:path'
 
 import { isRunAsCli } from './cli-entry.mjs'
+import { loadCursorIgnorePaths } from './utils/load-cursor-config.mjs'
 import { resolveCmd } from './utils/resolve-cmd.mjs'
 import { walkDir } from './utils/walkDir.mjs'
 
@@ -60,15 +61,19 @@ export function k8sRootFromFile(absFile) {
  * @param {string} root корінь репозиторію
  * @returns {Promise<string[]>} відсортовані абсолютні шляхи до каталогів `k8s`
  */
-export async function findK8sRoots(root) {
+export async function findK8sRoots(root, ignorePaths = []) {
   /** @type {Set<string>} */
   const roots = new Set()
-  await walkDir(root, p => {
-    if (!pathHasK8sSegment(p)) return
-    if (!YAML_EXT_RE.test(p)) return
-    const k8sRoot = k8sRootFromFile(p)
-    if (k8sRoot) roots.add(k8sRoot)
-  })
+  await walkDir(
+    root,
+    p => {
+      if (!pathHasK8sSegment(p)) return
+      if (!YAML_EXT_RE.test(p)) return
+      const k8sRoot = k8sRootFromFile(p)
+      if (k8sRoot) roots.add(k8sRoot)
+    },
+    ignorePaths
+  )
   return [...roots].toSorted((a, b) => a.localeCompare(b))
 }
 
@@ -134,7 +139,8 @@ function runKubescape(dirs) {
  */
 async function main() {
   const root = process.cwd()
-  const dirs = await findK8sRoots(root)
+  const ignorePaths = await loadCursorIgnorePaths(root)
+  const dirs = await findK8sRoots(root, ignorePaths)
 
   if (dirs.length === 0) {
     console.log('run-k8s: немає *.yaml під k8s — kubeconform і kubescape пропущено')

package/scripts/utils/load-cursor-config.mjs

@@ -0,0 +1,53 @@
+/**
+ * Утиліта читання `.n-cursor.json` у корені репозиторію.
+ *
+ * Зараз експортує `loadCursorIgnorePaths(root)` — список абсолютних posix-шляхів каталогів,
+ * які check-скрипти повністю виключають з обходу (поле `ignore` у конфізі).
+ */
+import { existsSync } from 'node:fs'
+import { readFile } from 'node:fs/promises'
+import { isAbsolute, join, resolve, sep } from 'node:path'
+
+const CONFIG_FILE = '.n-cursor.json'
+
+/**
+ * Нормалізує шлях до абсолютного posix-формату без trailing-slash.
+ * Відносні шляхи розв'язуються від `root`.
+ * @param {string} root абсолютний корінь репозиторію
+ * @param {string} p шлях з конфігу (відносний або абсолютний)
+ * @returns {string} абсолютний posix-шлях
+ */
+function toAbsPosix(root, p) {
+  const trimmed = String(p).trim()
+  const abs = isAbsolute(trimmed) ? trimmed : resolve(root, trimmed)
+  return abs.split(sep).join('/').replace(/\/+$/, '')
+}
+
+/**
+ * Читає `.n-cursor.json` з кореня та повертає нормалізовані ignore-шляхи.
+ * Якщо файлу нема, поле `ignore` відсутнє чи має невалідний формат — повертає порожній масив.
+ * Сам конфіг не валідується (це робить v8r/окрема перевірка) — лише поле `ignore`.
+ * @param {string} root абсолютний корінь репозиторію
+ * @returns {Promise<string[]>} абсолютні posix-шляхи без trailing-slash
+ */
+export async function loadCursorIgnorePaths(root) {
+  const file = join(root, CONFIG_FILE)
+  if (!existsSync(file)) return []
+  let raw
+  try {
+    raw = JSON.parse(await readFile(file, 'utf8'))
+  } catch {
+    return []
+  }
+  const list = raw?.ignore
+  if (!Array.isArray(list)) return []
+  /** @type {string[]} */
+  const out = []
+  for (const item of list) {
+    if (typeof item !== 'string') continue
+    const v = item.trim()
+    if (v.length === 0) continue
+    out.push(toAbsPosix(root, v))
+  }
+  return out
+}

package/scripts/utils/walkDir.mjs

@@ -2,19 +2,60 @@
  * Рекурсивний обхід каталогів для скриптів перевірки (Dockerfile, k8s YAML тощо).
  *
  * Обходить дерево від заданого кореня; для кожного звичайного файлу викликає переданий callback.
- * Каталоги node_modules, .git, dist, coverage, .turbo, .next не заходяться. Якщо readdir для
- * каталогу не вдається — тихо виходить без throw.
+ * Каталоги node_modules, .git, dist, coverage, .turbo, .next не заходяться.
+ * Додатково можна передати `ignorePaths` — повні шляхи каталогів (абсолютні posix), які слід
+ * пропускати разом з усім вмістом (поле `ignore` у `.n-cursor.json`). Якщо readdir для каталогу
+ * не вдається — тихо виходить без throw.
  */
 import { readdir } from 'node:fs/promises'
-import { join } from 'node:path'
+import { isAbsolute, join, resolve, sep } from 'node:path'
 
 /**
- * Рекурсивно обходить каталог, пропускає типові артефакти збірки та залежностей.
+ * Перетворює довільний шлях у абсолютний posix-формат без trailing-slash.
+ * @param {string} p шлях
+ * @returns {string} абсолютний posix-шлях
+ */
+function toAbsPosix(p) {
+  const abs = isAbsolute(p) ? p : resolve(p)
+  return abs.split(sep).join('/').replace(/\/+$/, '')
+}
+
+/**
+ * Чи каталог `dirAbsPosix` входить у список ignore (точний збіг або префікс з '/').
+ * Часткові збіги басенейму не враховуються (postgres-master-test ≠ postgres-master).
+ * @param {string} dirAbsPosix абсолютний posix-шлях каталогу
+ * @param {string[]} ignorePosix вже нормалізовані ignore-шляхи
+ * @returns {boolean}
+ */
+function isIgnoredDir(dirAbsPosix, ignorePosix) {
+  for (const ig of ignorePosix) {
+    if (dirAbsPosix === ig) return true
+    if (dirAbsPosix.startsWith(`${ig}/`)) return true
+  }
+  return false
+}
+
+/**
+ * Рекурсивно обходить каталог, пропускає типові артефакти збірки/залежностей та `ignorePaths`.
  * @param {string} dir абсолютний шлях
  * @param {(filePath: string) => void} onFile виклик для кожного файлу
+ * @param {string[]} [ignorePaths=[]] шляхи каталогів (відносні від cwd або абсолютні), що повністю виключаються з обходу
+ * @returns {Promise<void>}
+ */
+export async function walkDir(dir, onFile, ignorePaths = []) {
+  const ignorePosix = ignorePaths.map(toAbsPosix)
+  await walkDirInner(dir, onFile, ignorePosix)
+}
+
+/**
+ * Внутрішній рекурсор. ignorePosix вже нормалізовано — не нормалізуємо повторно на кожному рівні.
+ * @param {string} dir
+ * @param {(filePath: string) => void} onFile
+ * @param {string[]} ignorePosix
  * @returns {Promise<void>}
  */
-export async function walkDir(dir, onFile) {
+async function walkDirInner(dir, onFile, ignorePosix) {
+  if (ignorePosix.length > 0 && isIgnoredDir(toAbsPosix(dir), ignorePosix)) return
   let entries
   try {
     entries = await readdir(dir, { withFileTypes: true })
@@ -31,9 +72,9 @@ export async function walkDir(dir, onFile) {
         e.name === 'coverage' ||
         e.name === '.turbo' ||
         e.name === '.next'
-      if (!skipDir) {
-        await walkDir(p, onFile)
-      }
+      if (skipDir) continue
+      if (ignorePosix.length > 0 && isIgnoredDir(toAbsPosix(p), ignorePosix)) continue
+      await walkDirInner(p, onFile, ignorePosix)
     } else if (e.isFile()) {
       onFile(p)
     }