@nitra/cursor 12.3.2 → 12.4.0

package/rules/style-lint/policy/package_json/package_json.rego

@@ -10,16 +10,6 @@ package style_lint.package_json
 
 import rego.v1
 
-# ── deny: substring requirements у scripts (contains) ────────────────────
-
-deny contains msg if {
-	some script_name, needles in data.template.contains.scripts
-	actual := object.get(object.get(input, "scripts", {}), script_name, "")
-	some needle in needles
-	not contains(actual, needle)
-	msg := sprintf("package.json: scripts.%s має містити %q (style-lint.mdc)", [script_name, needle])
-}
-
 # ── deny: 2-level snippet walker (для stylelint.extends, якщо поле є) ────
 
 deny contains msg if {

package/rules/style-lint/style-lint.mdc

@@ -95,16 +95,17 @@ $white-a1: color.adjust(white, $alpha: -0.85);
 
 - **Джерело правил:** перед тим як писати або суттєво змінювати **`.css`**, **`.scss`** або стилі в **`.vue`**, переглянь у корені проєкту (і в релевантних пакетах монорепо, якщо є) поле **`stylelint`** у **`package.json`** (зокрема `extends`), наявні **`.stylelintrc.*`**, **`stylelint.config.*`** та **`.stylelintignore`**. Не покладайся на «типові» правила stylelint з пам’яті — дотримуйся **проєктного** **`@nitra/stylelint-config`** і будь-яких локальних доповнень у репозиторії.
 - **Форматування** узгоджуй з **`n-text.mdc`** (oxfmt / `.oxfmtrc.json` для css, scss тощо), щоб форматер і stylelint не суперечили один одному.
-- **Запуск stylelint:** лише **`npx stylelint`**. Локально — через скрипт **`lint-style`** (`bun run lint-style`, з `--fix`); у **GitHub Actions** у кроці **`run`** викликай `npx stylelint '**/*.{css,scss,vue}'` напряму **без `--fix`** (CI — read-only, нуль мутацій; не через **`bun run lint-style`**). Не використовуй **`bunx stylelint`**. Після змін запускай **`bun run lint-style`** і виправляй усе, що лишилось після auto-fix; за потреби — повний `bun run lint` (навичка **`/n-lint`**).
+- **Запуск stylelint:** лише через **`n-cursor lint style-lint`** (локально — з auto-fix; у CI — `--read-only`, нуль мутацій). Під капотом — `npx stylelint`; **не** використовуй **`bunx stylelint`**. Після змін запускай **`n-cursor lint style-lint`** і виправляй усе, що лишилось після auto-fix; за потреби — повний прогін `n-cursor lint --full`.
 - **Не розширюй винятки:** не додавай зайві **`stylelint-disable`** без потреби; краще підлаштувати стилі під правила проєкту.
 
 ## Канон
 
 ### `package.json`
 
-- `lint-style` (substring requirement): [package.json.contains.json](./policy/package_json/template/package.json.contains.json)
 - `stylelint.extends`: [package.json.snippet.json](./policy/package_json/template/package.json.snippet.json)
 
+Окремого `lint-style` скрипта немає — запуск через **`n-cursor lint style-lint`** (CI — `--read-only`).
+
 ### `.vscode/extensions.json`
 
 - Канон `recommendations`: [extensions.json.snippet.json](./policy/vscode_extensions/template/extensions.json.snippet.json)
@@ -120,9 +121,6 @@ $white-a1: color.adjust(white, $alpha: -0.85);
 **`package.json`:**
 
 ```json title="package.json"
-  "scripts": {
-    "lint-style": "npx stylelint '**/*.{css,scss,vue}' --fix",
-  },
   "devDependencies": {
     "@nitra/stylelint-config": "^1.4.0"
   },
@@ -131,7 +129,7 @@ $white-a1: color.adjust(white, $alpha: -0.85);
   },
 ```
 
-Додай **`.github/workflows/lint-style.yml`** (лише **`.yml`**, **`ga.mdc`**): після **`checkout`** — локальний composite **`setup-bun-deps`**, далі `npx stylelint '**/*.{css,scss,vue}'` (CI — без `--fix`) у кроці **`run`**. **Не** дублюй окремі кроки **`setup-node`** / **`oven-sh/setup-bun`** / кеш / **`npm install`**.
+Додай **`.github/workflows/lint-style.yml`** (лише **`.yml`**, **`ga.mdc`**): після **`checkout`** — локальний composite **`setup-bun-deps`**, далі `n-cursor lint style-lint --read-only` у кроці **`run`**. **Не** дублюй окремі кроки **`setup-node`** / **`oven-sh/setup-bun`** / кеш / **`npm install`**.
 
 ```yaml title=".github/workflows/lint-style.yml"
 name: StyleLint

package/rules/text/js/formatting.mjs

@@ -94,25 +94,20 @@ function checkTextConfigsExistence(passFn, failFn, cwd) {
 }
 
 /**
- * Перевіряє package.json для текстового стека: складний `lint-text` скрипт і
- * виклик `n-cursor lint-text --read-only` у відповідному workflow (CI — нуль мутацій). Решта (Prettier-заборона,
- * `@nitra/cspell-dict ^2.0.0+`, заборона `markdownlint-cli2` у залежностях,
- * `@nitra/*` гейт) — у Rego (`text.package_json`, `bun.package_json`).
+ * Перевіряє CI-workflow текстового стека: крок `n-cursor lint text --read-only` у
+ * `.github/workflows/lint-text.yml` (CI — нуль мутацій). Окремого `lint-text` скрипта в
+ * `package.json` немає — лінт через `n-cursor lint text`. Решта package.json-перевірок
+ * (Prettier-заборона, `@nitra/cspell-dict`, `@nitra/*` гейт) — у Rego (`text.package_json`, `bun.package_json`).
  * @param {(msg: string) => void} passFn callback при успішній перевірці
  * @param {(msg: string) => void} failFn callback при помилці
  * @param {string} cwd корінь репозиторію
  */
-async function checkPackageJsonText(passFn, failFn, cwd) {
-  const pkgPath = join(cwd, 'package.json')
-  if (!existsSync(pkgPath)) return
-  const pkg = JSON.parse(await readFile(pkgPath, 'utf8'))
-  checkLintTextScript(pkg.scripts?.['lint-text'], passFn, failFn)
-
+async function checkLintTextWorkflow(passFn, failFn, cwd) {
   const lintTextWf = join(cwd, '.github/workflows/lint-text.yml')
   if (existsSync(lintTextWf)) {
     const wf = await readFile(lintTextWf, 'utf8')
     const root = parseWorkflowYaml(wf)
-    const canonRun = 'n-cursor lint-text --read-only'
+    const canonRun = 'n-cursor lint text --read-only'
     const ok = root ? anyRunStepIncludes(root, canonRun) : wf.includes(canonRun)
     if (ok) {
       passFn(`lint-text.yml викликає ${canonRun}`)
@@ -124,25 +119,6 @@ async function checkPackageJsonText(passFn, failFn, cwd) {
   }
 }
 
-/**
- * Перевіряє скрипт lint-text: канонічний — `n-cursor lint-text` (CLI пакета `@nitra/cursor` робить
- * `cspell` → `runShellcheckText()` → `bunx markdownlint-cli2 --fix` → `runV8rWithGlobs()`).
- * Дозволено whitespace навколо команди.
- * @param {unknown} lintText значення `scripts.lint-text` з package.json
- * @param {(msg: string) => void} passFn callback при успішній перевірці
- * @param {(msg: string) => void} failFn callback при помилці
- */
-function checkLintTextScript(lintText, passFn, failFn) {
-  const lt = typeof lintText === 'string' ? lintText.trim() : ''
-  if (lt === 'n-cursor lint-text') {
-    passFn('lint-text делегує CLI n-cursor lint-text (cspell + shellcheck + markdownlint + v8r)')
-  } else {
-    failFn(
-      'package.json: lint-text має бути "n-cursor lint-text" — CLI пакета @nitra/cursor виконує cspell → shellcheck → markdownlint-cli2 → v8r (text.mdc)'
-    )
-  }
-}
-
 /**
  * Перевіряє відповідність проєкту правилам text.mdc.
  * @param {string} [cwd] корінь репозиторію
@@ -166,7 +142,7 @@ export async function check(cwd = process.cwd()) {
     }
   }
 
-  await checkPackageJsonText(pass, fail, cwd)
+  await checkLintTextWorkflow(pass, fail, cwd)
 
   return reporter.getExitCode()
 }

package/rules/text/policy/lint_text/template/lint-text.yml.snippet.yml

@@ -58,4 +58,4 @@ jobs:
           | sh -s -- -b /usr/local/bin
 
       - name: Lint text
-        run: n-cursor lint-text --read-only
+        run: n-cursor lint text --read-only

package/rules/ga/policy/package_json/package_json.rego

@@ -1,20 +0,0 @@
-# Перевірка кореневого `package.json` для GitHub Actions tooling (ga.mdc).
-#
-# Канон надходить через --data: { "template": { "contains": ... } }
-# Структура --data сформована з template/package.json.contains.json.
-#
-# Конвенція проєкту — `import rego.v1` + multi-value `deny contains msg if { … }`
-# (.cursor/rules/conftest.mdc). Лінт — `bun run lint-rego` (regal).
-package ga.package_json
-
-import rego.v1
-
-# Кожне рядкове поле з contains має містити кожен substring.
-# Відсутність ключа → `""` → contains() = false → deny.
-deny contains msg if {
-	some script_name, needles in data.template.contains.scripts
-	actual := object.get(object.get(input, "scripts", {}), script_name, "")
-	some needle in needles
-	not contains(actual, needle)
-	msg := sprintf("package.json: scripts.%s має містити %q (ga.mdc)", [script_name, needle])
-}

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

@@ -1,8 +0,0 @@
-{
-  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
-  "files": {
-    "single": "package.json",
-    "required": true
-  },
-  "missingMessage": "package.json не існує — потрібен lint-ga у scripts (ga.mdc)"
-}

package/rules/ga/policy/package_json/template/package.json.contains.json

@@ -1 +0,0 @@
-{ "scripts": { "lint-ga": ["n-cursor lint-ga"] } }

package/rules/php/policy/package_json/package_json.rego

@@ -1,16 +0,0 @@
-# Перевірка `package.json` (php.mdc).
-#
-# Канон надходить через --data: { "template": { "contains": ... } }
-# Структура --data сформована з template/package.json.contains.json.
-# FS-перевірки (`composer.json`, наявність `package.json` як такого) — у JS.
-package php.package_json
-
-import rego.v1
-
-deny contains msg if {
-	some script_name, needles in data.template.contains.scripts
-	actual := object.get(object.get(input, "scripts", {}), script_name, "")
-	some needle in needles
-	not contains(actual, needle)
-	msg := sprintf("package.json: scripts.%s має містити %q (php.mdc)", [script_name, needle])
-}

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

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

package/rules/php/policy/package_json/template/package.json.contains.json

@@ -1,5 +0,0 @@
-{
-  "scripts": {
-    "lint-php": ["bun"]
-  }
-}

package/rules/python/policy/package_json/package_json.rego

@@ -1,16 +0,0 @@
-# Перевірка `package.json` (python.mdc).
-#
-# Канон надходить через --data: { "template": { "contains": ... } }
-# Структура --data сформована з template/package.json.contains.json.
-# FS-перевірки (наявність `package.json` як такого) — у JS.
-package python.package_json
-
-import rego.v1
-
-deny contains msg if {
-	some script_name, needles in data.template.contains.scripts
-	actual := object.get(object.get(input, "scripts", {}), script_name, "")
-	some needle in needles
-	not contains(actual, needle)
-	msg := sprintf("package.json: scripts.%s має містити %q (python.mdc)", [script_name, needle])
-}

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

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

package/rules/python/policy/package_json/template/package.json.contains.json

@@ -1,5 +0,0 @@
-{
-  "scripts": {
-    "lint-python": ["bun"]
-  }
-}

package/rules/rego/policy/package_json/package_json.rego

@@ -1,16 +0,0 @@
-# Перевірка `package.json` для rego (rego.mdc).
-#
-# Канон надходить через --data: { "template": { "snippet": ... } }
-# Структура --data сформована з template/package.json.snippet.json.
-# Дозволяємо whitespace навколо значення (trim_space) — допуск, який мав
-# попередній inline-варіант.
-package rego.package_json
-
-import rego.v1
-
-deny contains msg if {
-	some script_name, expected in data.template.snippet.scripts
-	actual := object.get(object.get(input, "scripts", {}), script_name, "")
-	trim_space(actual) != expected
-	msg := sprintf("package.json: scripts.%s має бути %q (rego.mdc)", [script_name, expected])
-}

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

@@ -1,5 +0,0 @@
-{
-  "$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/package_json/template/package.json.snippet.json

@@ -1 +0,0 @@
-{ "scripts": { "lint-rego": "n-cursor lint-rego" } }

package/rules/rust/policy/package_json/package_json.rego

@@ -1,18 +0,0 @@
-# Перевірка `package.json` для правила rust (rust.mdc).
-#
-# Канон надходить через --data: { "template": { "contains": ... } }
-# Структура --data сформована з template/package.json.contains.json.
-# Перевіряємо substring-вимоги до scripts.lint-rust: усі три кроки
-# (`cargo fmt`, `cargo clippy --fix`, фінальний `cargo clippy ... -D warnings`)
-# мають бути присутніми у значенні скрипта.
-package rust.package_json
-
-import rego.v1
-
-deny contains msg if {
-	some script_name, needles in data.template.contains.scripts
-	actual := object.get(object.get(input, "scripts", {}), script_name, "")
-	some needle in needles
-	not contains(actual, needle)
-	msg := sprintf("package.json: scripts.%s має містити %q (rust.mdc)", [script_name, needle])
-}

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

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

package/rules/rust/policy/package_json/template/package.json.contains.json

@@ -1,9 +0,0 @@
-{
-  "scripts": {
-    "lint-rust": [
-      "cargo fmt --all",
-      "cargo clippy --fix --allow-staged --allow-dirty",
-      "cargo clippy --all-targets --all-features -- -D warnings"
-    ]
-  }
-}

package/rules/security/policy/package_json/template/package.json.contains.json

@@ -1 +0,0 @@
-{ "scripts": { "lint": ["bun run lint-security"] } }

package/rules/security/policy/package_json/template/package.json.snippet.json

@@ -1,5 +0,0 @@
-{
-  "scripts": {
-    "lint-security": "trufflehog filesystem . --no-update --exclude-paths .trufflehog-exclude --results=verified,unknown --fail"
-  }
-}

package/rules/style-lint/policy/package_json/template/package.json.contains.json

@@ -1,5 +0,0 @@
-{
-  "scripts": {
-    "lint-style": ["npx stylelint"]
-  }
-}