@nitra/cursor 1.8.170 → 1.8.173

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)
     }