@nitra/cursor 1.10.0 → 1.11.0

package/rules/abie/utils/yaml.mjs

@@ -0,0 +1,72 @@
+/**
+ * Спільні YAML-хелпери для abie-перевірок: парсинг документів з опційним modeline,
+ * BOM-strip, regex для `# yaml-language-server: $schema=` і поділу на рядки.
+ */
+import { readFile } from 'node:fs/promises'
+
+import { parseAllDocuments } from 'yaml'
+
+export const MODELINE_RE = /^#\s*yaml-language-server:\s*\$schema=(\S+)\s*$/
+export const LINE_SPLIT_RE = /\r?\n/u
+
+/**
+ * Прибирає BOM на початку файлу.
+ * @param {string} s вміст
+ * @returns {string}
+ */
+export function stripBom(s) {
+  return s.startsWith('') ? s.slice(1) : s
+}
+
+/**
+ * Чи YAML-документ — це `kind: Deployment`.
+ * @param {unknown} obj корінь YAML-документа
+ * @returns {boolean}
+ */
+export function isDeploymentDoc(obj) {
+  return (
+    obj !== null &&
+    typeof obj === 'object' &&
+    !Array.isArray(obj) &&
+    /** @type {Record<string, unknown>} */ (obj).kind === 'Deployment'
+  )
+}
+
+/**
+ * No-op fail-handler для функцій, що мовчки повертають null/[] при помилці парсингу.
+ * @param {string} _msg ігнорується
+ */
+export const silentFail = _msg => {
+  /* silent — пошкоджені файли ловить check-k8s */
+}
+
+/**
+ * Зчитує і парсить YAML-документи з файлу. BOM і modeline (перший рядок `$schema`)
+ * автоматично прибираються перед `parseAllDocuments`. При помилці читання/парсингу
+ * викликає `failFn` і повертає `null`.
+ * @param {string} abs абсолютний шлях
+ * @param {string} rel відносний (для повідомлень)
+ * @param {(msg: string) => void} failFn
+ * @returns {Promise<import('yaml').Document[] | null>}
+ */
+export async function readAndParseYamlDocs(abs, rel, failFn) {
+  let raw
+  try {
+    raw = await readFile(abs, 'utf8')
+  } catch (error) {
+    const msg = error instanceof Error ? error.message : String(error)
+    failFn(`${rel}: не вдалося прочитати (${msg})`)
+    return null
+  }
+  const body = stripBom(raw)
+  const lines = body.split(LINE_SPLIT_RE)
+  const first = lines[0] ?? ''
+  const rest = MODELINE_RE.test(first.trim()) ? lines.slice(1).join('\n') : body
+  try {
+    return parseAllDocuments(rest)
+  } catch (error) {
+    const msg = error instanceof Error ? error.message : String(error)
+    failFn(`${rel}: YAML (${msg})`)
+    return null
+  }
+}

package/rules/adr/policy/settings_json/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": ".claude/settings.json" }
+}

package/rules/adr/policy/settings_local_json/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": ".claude/settings.local.json" }
+}

package/rules/bun/policy/bunfig/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": "bunfig.toml" }
+}

package/rules/bun/policy/package_json/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": "package.json" }
+}

package/rules/capacitor/policy/package_json/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": "package.json" }
+}

package/rules/docker/policy/lint_docker_yml/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": ".github/workflows/lint-docker.yml" }
+}

package/rules/docker/policy/package_json/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": "package.json" }
+}

package/rules/hasura/policy/svc_hl/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": "hasura/k8s/base/svc-hl.yaml" }
+}

package/rules/image-avif/policy/package_json/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "walkGlob": "**/package.json" }
+}

package/rules/image-compress/policy/package_json/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": "package.json" }
+}

package/rules/js-bun-db/policy/package_json/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "walkGlob": "**/package.json" }
+}

package/rules/js-bun-redis/policy/package_json/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "walkGlob": "**/package.json" }
+}

package/rules/js-lint/policy/lint_js_yml/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": ".github/workflows/lint-js.yml" }
+}

package/rules/js-lint/policy/package_json/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": "package.json" }
+}

package/rules/js-mssql/policy/package_json/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "walkGlob": "**/package.json" }
+}

package/rules/js-run/policy/configmap/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "walkGlob": "**/k8s/*/configmap.yaml" }
+}

package/rules/js-run/policy/package_json/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "walkGlob": "**/package.json" }
+}

package/rules/k8s/policy/base_kustomization/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "walkGlob": "**/k8s/**/base/**/kustomization.yaml" }
+}

package/rules/k8s/policy/base_manifest/target.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": {
+    "walkGlob": [
+      "**/k8s/**/base/**/*.yaml",
+      "**/k8s/**/base/**/*.yml",
+      "!**/k8s/**/base/**/kustomization.yaml"
+    ]
+  }
+}

package/rules/k8s/policy/gateway/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "walkGlob": ["**/k8s/**/*.yaml", "**/k8s/**/*.yml"] }
+}

package/rules/k8s/policy/hpa_pdb/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "walkGlob": ["**/k8s/**/*.yaml", "**/k8s/**/*.yml"] }
+}

package/rules/k8s/policy/kustomization/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "walkGlob": "**/k8s/**/kustomization.yaml" }
+}

package/rules/k8s/policy/manifest/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "walkGlob": ["**/k8s/**/*.yaml", "**/k8s/**/*.yml"] }
+}

package/rules/k8s/policy/svc_hl_yaml/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "walkGlob": "**/k8s/**/svc-hl.yaml" }
+}

package/rules/k8s/policy/svc_yaml/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "walkGlob": "**/k8s/**/svc.yaml" }
+}

package/rules/npm-module/policy/emit_types_config/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": "npm/tsconfig.emit-types.json" }
+}

package/rules/npm-module/policy/npm_package_json/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": "npm/package.json" }
+}

package/rules/npm-module/policy/npm_publish_yml/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": ".github/workflows/npm-publish.yml" }
+}

package/rules/npm-module/policy/root_package_json/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": "package.json" }
+}

package/rules/php/policy/lint_php_yml/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": ".github/workflows/lint-php.yml" }
+}

package/rules/php/policy/package_json/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": "package.json" }
+}

package/rules/rego/js/applies/check.mjs

@@ -0,0 +1,54 @@
+/**
+ * Applies-гейт правила `rego` (rego.mdc): правило застосовне, лише якщо в репозиторії є
+ * хоча б один `.rego`-файл (під типовими skip-ами і `.n-cursor.json:ignore`).
+ *
+ * Якщо `.rego` нема — CLI пропускає правило цілком (включно з polices `package_json`,
+ * `vscode_extensions`, `vscode_settings`), бо вимоги rego-tooling неактуальні. Якщо є — CLI
+ * прогонить policy-концерни через `target.json`-маніфести у `rules/rego/policy/<name>/`.
+ *
+ * JS тут лишається лише як cross-file гейт: walkDir не виразити декларативно через `target.json`.
+ * Друк короткого pass-повідомлення з контекстом робить `check()` (необовʼязковий).
+ */
+import { createCheckReporter } from '../../../../scripts/utils/check-reporter.mjs'
+import { loadCursorIgnorePaths } from '../../../../scripts/utils/load-cursor-config.mjs'
+import { walkDir } from '../../../../scripts/utils/walkDir.mjs'
+
+/**
+ * Чи є хоча б один `.rego`-файл у дереві від `cwd`. Зупиняється на першому матчі.
+ * @param {string} root абсолютний шлях кореня
+ * @param {string[]} ignorePaths шляхи каталогів, повністю виключених з обходу
+ * @returns {Promise<boolean>} `true`, якщо знайдено хоч один `.rego`
+ */
+async function projectHasRegoFiles(root, ignorePaths) {
+  let found = false
+  await walkDir(
+    root,
+    p => {
+      if (p.endsWith('.rego')) {
+        found = true
+      }
+    },
+    ignorePaths
+  )
+  return found
+}
+
+/**
+ * Rule-level applies-гейт: CLI пропускає правило, якщо в репо немає `.rego` файлів.
+ * @returns {Promise<boolean>} `true`, якщо правило застосовне
+ */
+export async function applies() {
+  const root = process.cwd()
+  const ignorePaths = await loadCursorIgnorePaths(root)
+  return projectHasRegoFiles(root, ignorePaths)
+}
+
+/**
+ * Друкує короткий context-pass — самі полісі прогонить CLI через `policy/<name>/target.json`.
+ * @returns {Promise<number>} 0 — все ок (фактичні порушення повертають policy-концерни)
+ */
+export async function check() {
+  const reporter = createCheckReporter()
+  reporter.pass('Знайдено *.rego у дереві — перевіряємо канонічні конфіги rego.mdc')
+  return reporter.getExitCode()
+}

package/rules/rego/policy/package_json/target.json

@@ -0,0 +1,5 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": "package.json", "required": true },
+  "missingMessage": "package.json не існує — створи згідно rego.mdc (rego.package_json)"
+}

package/rules/rego/policy/vscode_extensions/target.json

@@ -0,0 +1,5 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": ".vscode/extensions.json", "required": true },
+  "missingMessage": ".vscode/extensions.json не існує — створи згідно rego.mdc (rego.vscode_extensions)"
+}

package/rules/rego/policy/vscode_settings/target.json

@@ -0,0 +1,5 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": ".vscode/settings.json", "required": true },
+  "missingMessage": ".vscode/settings.json не існує — створи згідно rego.mdc (rego.vscode_settings)"
+}

package/rules/style-lint/policy/lint_style_yml/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": ".github/workflows/lint-style.yml" }
+}

package/rules/style-lint/policy/package_json/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": "package.json" }
+}

package/rules/style-lint/policy/vscode_extensions/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": ".vscode/extensions.json" }
+}

package/rules/style-lint/policy/vscode_settings/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": ".vscode/settings.json" }
+}

package/rules/text/policy/cspell/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": ".cspell.json" }
+}

package/rules/text/policy/markdownlint/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": ".markdownlint-cli2.jsonc" }
+}

package/rules/text/policy/oxfmtrc/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": ".oxfmtrc.json" }
+}

package/rules/text/policy/package_json/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": "package.json" }
+}

package/rules/text/policy/vscode_extensions/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": ".vscode/extensions.json" }
+}

package/rules/text/policy/vscode_settings/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": ".vscode/settings.json" }
+}

package/rules/vue/policy/package_json/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "walkGlob": "**/package.json" }
+}

package/schemas/target.json

@@ -0,0 +1,58 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "title": "Rego policy target manifest",
+  "description": "Маніфест поряд із <name>.rego: декларує, які файли проєкту фідити в conftest для цієї полісі. Лежить у npm/rules/<id>/policy/<name>/target.json (per-policy, поруч із <name>.rego). CLI читає й передає у runConftestBatch — JS-оркестратор у js/<name>/check.mjs не зобовʼязаний дублювати виклик. Namespace полісі обчислюється з шляху: <id>.<name>, відповідно `package <id>.<name>` у .rego.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["files"],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "format": "uri",
+      "description": "Опційне посилання на JSON Schema для IDE-валідації; очікувано https://unpkg.com/@nitra/cursor/schemas/target.json"
+    },
+    "files": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["single"],
+          "properties": {
+            "single": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Відносний шлях від кореня репозиторію (posix). Заборонені сегменти '..' і абсолютні шляхи."
+            },
+            "required": {
+              "type": "boolean",
+              "description": "true → fail при відсутності файла з відповідним missingMessage; false/відсутнє → silent skip (полісі не запускається). За замовчуванням false."
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["walkGlob"],
+          "properties": {
+            "walkGlob": {
+              "oneOf": [
+                { "type": "string", "minLength": 1 },
+                {
+                  "type": "array",
+                  "minItems": 1,
+                  "items": { "type": "string", "minLength": 1 }
+                }
+              ],
+              "description": "Один або декілька picomatch-globів (matched проти відносного posix-шляху). walkDir від cwd із загальними skip-ами + .n-cursor.json:ignore."
+            }
+          }
+        }
+      ]
+    },
+    "missingMessage": {
+      "type": "string",
+      "description": "Override дефолтного fail-повідомлення при відсутності required:single файла. Без значення CLI використає шаблон '<path> не існує (<id>.<name>)'."
+    }
+  }
+}