@nitra/cursor 1.13.82 → 1.13.83

package/scripts/utils/run-standard-rule.mjs

@@ -0,0 +1,34 @@
+/**
+ * Public API per-rule orchestration. Викликається з `rules/<id>/fix.mjs`.
+ *
+ * Інкапсулює: `discoverOneRule` → `runRule(applies → JS → policy → mdc-refs)`.
+ * Локальна логіка в правилах заборонена; розширення поведінки — через `ctx`-опції.
+ */
+import { basename, dirname } from 'node:path'
+
+import { discoverOneRule } from './discover-checkable-rules.mjs'
+import { runRule } from './run-rule.mjs'
+import { getOrCreateWalkCache } from './walk-cache.mjs'
+
+/**
+ * @typedef {object} RuleContext
+ * @property {Map<string, Promise<string[]>>} [walkCache] FS-walk cache між concerns одного прогону
+ *
+ * Зарезервовано на майбутнє (поки не реалізовано — додається, коли з'явиться потреба):
+ *   - `skipMdcRefs`, `skipApplies`, `onlyConcerns`.
+ * Розширення поведінки правила робиться лише через нові поля тут, не через локальну
+ * логіку в `rules/<id>/fix.mjs`.
+ */
+
+/**
+ * @param {string} ruleDir абсолютний шлях до `rules/<id>/`
+ * @param {RuleContext} [ctx] контекст прогону (walkCache тощо)
+ * @returns {Promise<number>} 0 OK, 1 violations
+ */
+export async function runStandardRule(ruleDir, ctx = {}) {
+  const ruleId = basename(ruleDir)
+  const bundledRulesDir = dirname(ruleDir)
+  const rule = await discoverOneRule(ruleDir, ruleId)
+  const walkCache = ctx.walkCache ?? getOrCreateWalkCache()
+  return runRule(rule, bundledRulesDir, walkCache)
+}

package/scripts/utils/walk-cache.mjs

@@ -0,0 +1,24 @@
+/**
+ * Module-singleton FS-walk cache, спільний для всіх concerns одного `check`-прогону.
+ * Ключі — рядкові glob/regex дескриптори; значення — `Promise<string[]>` зі списком файлів.
+ * Кеш живий у межах одного процесу (Node/Bun module-instance). Тести скидають через `resetWalkCache()`.
+ */
+
+/** @type {Map<string, Promise<string[]>> | null} */
+let cache = null
+
+/**
+ * Повертає поточний cache; lazy-ініціалізує при першому виклику.
+ * @returns {Map<string, Promise<string[]>>} module-singleton walk cache
+ */
+export function getOrCreateWalkCache() {
+  if (cache === null) cache = new Map()
+  return cache
+}
+
+/**
+ * Скидає cache (для тестів між кейсами).
+ */
+export function resetWalkCache() {
+  cache = new Map()
+}

package/scripts/utils/workspaces.mjs

@@ -11,7 +11,7 @@ import { dirname, join, relative } from 'node:path'
 const TRAILING_SLASH_RE = /\/$/
 const LEADING_DOTSLASH_RE = /^\.\//
 
-/** Glob-ігнор для workspace-патернів із `*` (узгоджено з `rules/changelog/fix/consistency/package-manifest.mjs`). */
+/** Glob-ігнор для workspace-патернів із `*` (узгоджено з `rules/changelog/js/consistency/package-manifest.mjs`). */
 export const WORKSPACE_GLOB_IGNORE = Object.freeze(['**/node_modules/**', '**/.git/**', '**/.venv/**', '**/venv/**'])
 
 /**