@nitra/cursor 1.10.0 → 1.11.1

package/rules/php/js/{check.mjs → tooling/check.mjs}

@@ -11,7 +11,7 @@
  */
 import { existsSync } from 'node:fs'
 
-import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
+import { createCheckReporter } from '../../../../scripts/utils/check-reporter.mjs'
 
 /**
  * Перевіряє відповідність проєкту правилам php.mdc.

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/js/{check.mjs → tooling/check.mjs}

@@ -19,7 +19,7 @@
 import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
 
-import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
+import { createCheckReporter } from '../../../../scripts/utils/check-reporter.mjs'
 
 /**
  * Альтернатива полю `stylelint` у `package.json` — зовнішній файл конфігу. Якщо

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/tauri/js/{check.mjs → tooling/check.mjs}

@@ -18,8 +18,8 @@
 import { existsSync, statSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
 
-import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
-import { runConftestBatch } from '../../../scripts/utils/run-conftest-batch.mjs'
+import { createCheckReporter } from '../../../../scripts/utils/check-reporter.mjs'
+import { runConftestBatch } from '../../../../scripts/utils/run-conftest-batch.mjs'
 
 /**
  * Чи є префікс `@tauri-apps/` у ключах `dependencies` або `devDependencies`.

package/rules/text/js/{check.mjs → formatting/check.mjs}

@@ -32,8 +32,8 @@
 import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
 
-import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
-import { anyRunStepIncludes, parseWorkflowYaml } from '../../../scripts/utils/gha-workflow.mjs'
+import { createCheckReporter } from '../../../../scripts/utils/check-reporter.mjs'
+import { anyRunStepIncludes, parseWorkflowYaml } from '../../../../scripts/utils/gha-workflow.mjs'
 
 /** Заголовок абзацу про апостроф у text.mdc / n-text.mdc. */
 const UK_APOSTROPHE_HEADING = '**Український апостроф:**'

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/js/{check.mjs → packages/check.mjs}

@@ -21,16 +21,16 @@ import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
 import { join, relative } from 'node:path'
 
-import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
+import { createCheckReporter } from '../../../../scripts/utils/check-reporter.mjs'
 import {
   findForbiddenNodeImportsInVueFile,
   findForbiddenVueImportsInSourceFile,
   isVueImportScanSourceFile,
   shouldSkipFileForVueImportScan
-} from '../../../scripts/utils/vue-forbidden-imports.mjs'
-import { loadCursorIgnorePaths } from '../../../scripts/utils/load-cursor-config.mjs'
-import { walkDir } from '../../../scripts/utils/walkDir.mjs'
-import { getMonorepoPackageRootDirs } from '../../../scripts/utils/workspaces.mjs'
+} from '../../../../scripts/utils/vue-forbidden-imports.mjs'
+import { loadCursorIgnorePaths } from '../../../../scripts/utils/load-cursor-config.mjs'
+import { walkDir } from '../../../../scripts/utils/walkDir.mjs'
+import { getMonorepoPackageRootDirs } from '../../../../scripts/utils/workspaces.mjs'
 
 const ESBUILD_RE = /\besbuild\b/
 

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>)'."
+    }
+  }
+}