@nitra/cursor 1.9.12 → 1.9.14

package/CHANGELOG.md

@@ -4,6 +4,28 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
+## [1.9.14] - 2026-05-13
+
+### Added
+
+- **`text.markdownlint` rego — повний канон `.markdownlint-cli2.jsonc` тепер виноситься як deny:** раніше rego-полісі мала **рівно один** deny (`gitignore == true`), а решта канонічного блока з [text.mdc](mdc/text.mdc) (`config.default == true`, `MD013 == false`, `MD024.siblings_only == true`, `MD029 == false`, `MD040 == false`, `MD041 == false`) була показана як приклад, але не перевірялась. Додано 6 нових deny-правил, що покривають кожне поле канону; додаткові поля верхнього рівня (`ignores`) і додаткові MD-rules (`MD033` тощо) дозволені — канон задає мінімум. Шаблон повідомлень — через `concat` для regal style/line-length.
+- **`npm/policy/text/markdownlint/markdownlint_test.rego` — 14 нових тестів:** happy path (канонічний `.markdownlint-cli2.jsonc`), дозволені розширення (`ignores`, `MD033`), порушення для `gitignore` (відсутній / `false`), `config.default` (відсутній / `false`), `MD013/029/040/041` (`true` або відсутній), `MD024` (не object / `siblings_only: false` / відсутній). `conftest verify` — **183/183 pass** (+14). `lint-conftest` на реальному `.markdownlint-cli2.jsonc` репо: 5/5 (раніше було 1/1 — додано 4 нові тестові кейси проти реального файлу).
+
+## [1.9.13] - 2026-05-13
+
+### Removed
+
+- **`check-bun.mjs::isAllowedRootDevDependency` — видалено JS-копію, дубль rego:** функція експортувалася лише для тестів, у `check()` не викликалась; логіка «дозволено лише `@nitra/*` у кореневих `devDependencies`» давно живе у `npm/policy/bun/package_json/package_json.rego` (`not startswith(name, "@nitra/")`). Docstring помилково посилався на `check-text.mjs`, який цю функцію не імпортує. Тепер єдине джерело — rego; у `check-bun.mjs` додано коментар з посиланням на полісі.
+
+### Added
+
+- **`npm/policy/bun/package_json/package_json_test.rego` — rego-тести для bun.package_json:** 12 нових `test_*`-кейсів через `json.patch`-фікстури — happy path (без `devDependencies`, з кількома `@nitra/*`), 4 негативні `devDependencies` (`@cspell/dict-uk-ua`, `@cspell/cspell-lib`, `lodash`, `@types/node`), mixed-devDeps з конкретним повідомленням про `lodash`, заборона `packageManager`, заборона кореневих `dependencies` (порожній обʼєкт теж), агрегований `lint`-скрипт (відсутній / не покриває `bun run` / без `&& oxfmt .`). Покривається `bun run lint-rego` (169/169 pass).
+
+### Changed
+
+- **`npm/tests/check-bun.test.mjs` — прибрано `describe('isAllowedRootDevDependency')`:** імпорт і блок тестів видалено; залишено інтеграційні `check-bun`-тести у тимчасових каталогах (FS / cross-file частина).
+- **Аудит інших `check-*.mjs`**: пройдено всі 22 скрипти на наявність дубля з rego (export не викликається внутрішньо + наявне `npm/policy/<rule>/<name>/<name>.rego`). Знайдено лише цей кейс; `httpRouteMatchesNginxDefaultTpl` у `check-nginx-default-tpl.mjs` залишається — не має rego-counterpart і свідомо лишений для майбутнього використання згідно docstring. Інші експорти або викликаються у відповідному `check()` / приватних helper-ах, або не мають rego-копії.
+
 ## [1.9.12] - 2026-05-13
 
 ### Removed

package/mdc/text.mdc

@@ -144,6 +144,9 @@ version: '1.26'
   "config": {
     "default": true,
     "MD013": false,
+    "MD024": {
+      "siblings_only": true
+    },
     "MD029": false,
     "MD040": false,
     "MD041": false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "1.9.12",
+  "version": "1.9.14",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",

package/policy/bun/package_json/package_json_test.rego

@@ -0,0 +1,109 @@
+# Тести для `bun.package_json`. Запуск:
+#   conftest verify -p npm/policy/bun/package_json
+package bun.package_json_test
+
+import rego.v1
+
+import data.bun.package_json
+
+valid_pkg := {
+	"name": "n-cursor",
+	"devDependencies": {"@nitra/eslint-config": "^3.9.2"},
+}
+
+# ── happy path ────────────────────────────────────────────────────────────
+
+test_allow_minimal if {
+	count(package_json.deny) == 0 with input as valid_pkg
+}
+
+test_allow_multiple_nitra_deps if {
+	pkg := json.patch(valid_pkg, [{
+		"op": "replace",
+		"path": "/devDependencies",
+		"value": {"@nitra/eslint-config": "^3.9.2", "@nitra/cspell-dict": "^2.0.0", "@nitra/stylelint-config": "^1.0.0"},
+	}])
+	count(package_json.deny) == 0 with input as pkg
+}
+
+test_allow_no_dev_dependencies if {
+	pkg := json.patch(valid_pkg, [{"op": "remove", "path": "/devDependencies"}])
+	count(package_json.deny) == 0 with input as pkg
+}
+
+# ── deny: devDependencies лише @nitra/* ──────────────────────────────────
+
+test_deny_non_nitra_devdep if {
+	cases := [
+		{"@cspell/dict-uk-ua": "^2.0.0"},
+		{"@cspell/cspell-lib": "^9.0.0"},
+		{"lodash": "*"},
+		{"@types/node": "^24.0.0"},
+	]
+	some bad in cases
+	pkg := json.patch(valid_pkg, [{"op": "replace", "path": "/devDependencies", "value": bad}])
+	count(package_json.deny) > 0 with input as pkg
+}
+
+test_deny_mixed_dev_deps_only_flags_non_nitra if {
+	pkg := json.patch(valid_pkg, [{
+		"op": "replace",
+		"path": "/devDependencies",
+		"value": {"@nitra/eslint-config": "^3.9.2", "lodash": "*"},
+	}])
+	some msg in package_json.deny with input as pkg
+	contains(msg, "lodash")
+}
+
+# ── deny: packageManager ─────────────────────────────────────────────────
+
+test_deny_package_manager_field if {
+	pkg := json.patch(valid_pkg, [{"op": "add", "path": "/packageManager", "value": "pnpm@9.0.0"}])
+	count(package_json.deny) > 0 with input as pkg
+}
+
+# ── deny: dependencies у кореневому ──────────────────────────────────────
+
+test_deny_root_dependencies_present if {
+	pkg := json.patch(valid_pkg, [{"op": "add", "path": "/dependencies", "value": {"lodash": "*"}}])
+	count(package_json.deny) > 0 with input as pkg
+}
+
+test_deny_empty_dependencies_object if {
+	pkg := json.patch(valid_pkg, [{"op": "add", "path": "/dependencies", "value": {}}])
+	count(package_json.deny) > 0 with input as pkg
+}
+
+# ── deny: агрегований lint ───────────────────────────────────────────────
+
+test_deny_lint_prefixed_without_aggregate if {
+	pkg := json.patch(valid_pkg, [{"op": "add", "path": "/scripts", "value": {"lint-js": "echo"}}])
+	count(package_json.deny) > 0 with input as pkg
+}
+
+test_allow_lint_aggregate_calls_subscript_and_oxfmt if {
+	pkg := json.patch(valid_pkg, [{
+		"op": "add",
+		"path": "/scripts",
+		"value": {"lint-js": "echo", "lint": "bun run lint-js && oxfmt ."},
+	}])
+	count(package_json.deny) == 0 with input as pkg
+}
+
+test_deny_lint_aggregate_missing_oxfmt if {
+	pkg := json.patch(valid_pkg, [{
+		"op": "add",
+		"path": "/scripts",
+		"value": {"lint-js": "echo", "lint": "bun run lint-js"},
+	}])
+	count(package_json.deny) > 0 with input as pkg
+}
+
+test_deny_lint_aggregate_missing_subscript_via_bun_run if {
+	pkg := json.patch(valid_pkg, [{
+		"op": "add",
+		"path": "/scripts",
+		"value": {"lint-js": "echo", "lint-text": "echo", "lint": "bun run lint-js && oxfmt ."},
+	}])
+	count(package_json.deny) > 0 with input as pkg
+}

package/policy/text/markdownlint/markdownlint.rego

@@ -8,6 +8,12 @@
 # У випадку справжнього JSONC з `//` коментарями цей крок мовчки ігноруватиметься
 # (conftest skip). FS-перевірка (наявність файлу) живе у JS.
 #
+# Перевіряє канонічний baseline з text.mdc (мінімум — додаткові ключі дозволені):
+#   { "gitignore": true,
+#     "config": { "default": true, "MD013": false, "MD024": {"siblings_only": true},
+#                 "MD029": false, "MD040": false, "MD041": false } }
+# MD041 off навмисно — `.mdc` з frontmatter (див. text.mdc).
+#
 # Структура каталогу збігається зі шляхом пакету (regal: directory-package-mismatch).
 # Конвенція проєкту — `import rego.v1` + multi-value `deny contains msg if { … }`
 # (.cursor/rules/conftest.mdc). Лінт — `bun run lint-rego` (regal).
@@ -15,7 +21,50 @@ package text.markdownlint
 
 import rego.v1
 
+# ── Шаблони повідомлень ────────────────────────────────────────────────────
+
+config_rule_template := concat(" ", [
+	".markdownlint-cli2.jsonc: config.%s має бути %v",
+	"(зараз: %v) (text.mdc)",
+])
+
+# ── deny: gitignore ───────────────────────────────────────────────────────
+
 deny contains msg if {
 	object.get(input, "gitignore", null) != true
 	msg := ".markdownlint-cli2.jsonc: додай на верхньому рівні \"gitignore\": true (text.mdc)"
 }
+
+# ── deny: config.default ──────────────────────────────────────────────────
+
+deny contains msg if {
+	config := object.get(input, "config", {})
+	object.get(config, "default", null) != true
+	msg := sprintf(config_rule_template, ["default", true, object.get(config, "default", null)])
+}
+
+# ── deny: MD013 / MD029 / MD040 / MD041 повинні бути `false` ──────────────
+
+deny contains msg if {
+	config := object.get(input, "config", {})
+	some rule in {"MD013", "MD029", "MD040", "MD041"}
+	object.get(config, rule, null) != false
+	msg := sprintf(config_rule_template, [rule, false, object.get(config, rule, null)])
+}
+
+# ── deny: MD024.siblings_only == true ─────────────────────────────────────
+
+deny contains msg if {
+	config := object.get(input, "config", {})
+	md024 := object.get(config, "MD024", null)
+	not is_object(md024)
+	msg := sprintf(config_rule_template, ["MD024", "{\"siblings_only\": true}", md024])
+}
+
+deny contains msg if {
+	config := object.get(input, "config", {})
+	md024 := object.get(config, "MD024", {})
+	is_object(md024)
+	object.get(md024, "siblings_only", null) != true
+	msg := sprintf(config_rule_template, ["MD024.siblings_only", true, object.get(md024, "siblings_only", null)])
+}

package/policy/text/markdownlint/markdownlint_test.rego

@@ -0,0 +1,98 @@
+# Тести для `text.markdownlint`. Запуск:
+#   conftest verify -p npm/policy/text/markdownlint
+package text.markdownlint_test
+
+import rego.v1
+
+import data.text.markdownlint
+
+valid_cfg := {
+	"gitignore": true,
+	"config": {
+		"default": true,
+		"MD013": false,
+		"MD024": {"siblings_only": true},
+		"MD029": false,
+		"MD040": false,
+		"MD041": false,
+	},
+}
+
+# ── happy path ────────────────────────────────────────────────────────────
+
+test_allow_canonical if {
+	count(markdownlint.deny) == 0 with input as valid_cfg
+}
+
+test_allow_with_additional_top_level_keys if {
+	cfg := json.patch(valid_cfg, [{"op": "add", "path": "/ignores", "value": ["**/adr/**"]}])
+	count(markdownlint.deny) == 0 with input as cfg
+}
+
+test_allow_with_additional_md_rules if {
+	cfg := json.patch(valid_cfg, [{"op": "add", "path": "/config/MD033", "value": {"allowed_elements": ["a"]}}])
+	count(markdownlint.deny) == 0 with input as cfg
+}
+
+# ── gitignore ─────────────────────────────────────────────────────────────
+
+test_deny_missing_gitignore if {
+	cfg := json.patch(valid_cfg, [{"op": "remove", "path": "/gitignore"}])
+	count(markdownlint.deny) > 0 with input as cfg
+}
+
+test_deny_gitignore_false if {
+	cfg := json.patch(valid_cfg, [{"op": "replace", "path": "/gitignore", "value": false}])
+	count(markdownlint.deny) > 0 with input as cfg
+}
+
+# ── config.default ────────────────────────────────────────────────────────
+
+test_deny_default_false if {
+	cfg := json.patch(valid_cfg, [{"op": "replace", "path": "/config/default", "value": false}])
+	count(markdownlint.deny) > 0 with input as cfg
+}
+
+test_deny_default_missing if {
+	cfg := json.patch(valid_cfg, [{"op": "remove", "path": "/config/default"}])
+	count(markdownlint.deny) > 0 with input as cfg
+}
+
+# ── MD013 / MD029 / MD040 / MD041 — повинні бути false ────────────────────
+
+test_deny_md013_true if {
+	cfg := json.patch(valid_cfg, [{"op": "replace", "path": "/config/MD013", "value": true}])
+	count(markdownlint.deny) > 0 with input as cfg
+}
+
+test_deny_md029_missing if {
+	cfg := json.patch(valid_cfg, [{"op": "remove", "path": "/config/MD029"}])
+	count(markdownlint.deny) > 0 with input as cfg
+}
+
+test_deny_md040_true if {
+	cfg := json.patch(valid_cfg, [{"op": "replace", "path": "/config/MD040", "value": true}])
+	count(markdownlint.deny) > 0 with input as cfg
+}
+
+test_deny_md041_true if {
+	cfg := json.patch(valid_cfg, [{"op": "replace", "path": "/config/MD041", "value": true}])
+	count(markdownlint.deny) > 0 with input as cfg
+}
+
+# ── MD024.siblings_only ──────────────────────────────────────────────────
+
+test_deny_md024_not_object if {
+	cfg := json.patch(valid_cfg, [{"op": "replace", "path": "/config/MD024", "value": false}])
+	count(markdownlint.deny) > 0 with input as cfg
+}
+
+test_deny_md024_siblings_only_false if {
+	cfg := json.patch(valid_cfg, [{"op": "replace", "path": "/config/MD024/siblings_only", "value": false}])
+	count(markdownlint.deny) > 0 with input as cfg
+}
+
+test_deny_md024_missing if {
+	cfg := json.patch(valid_cfg, [{"op": "remove", "path": "/config/MD024"}])
+	count(markdownlint.deny) > 0 with input as cfg
+}

package/scripts/check-bun.mjs

@@ -20,17 +20,9 @@ import { readFile } from 'node:fs/promises'
 
 import { createCheckReporter } from './utils/check-reporter.mjs'
 
-/**
- * Чи ім'я пакета дозволене в кореневих `devDependencies` за bun.mdc (лише **`@nitra/*`**).
- *
- * Залишилася як експорт для `check-text.mjs` і тестів — `bun.package_json` Rego
- * робить ту саму перевірку для check-runner-а.
- * @param {string} name ключ з поля `devDependencies`
- * @returns {boolean} true, якщо префікс дозволений
- */
-export function isAllowedRootDevDependency(name) {
-  return name.startsWith('@nitra/')
-}
+// Перевірка `devDependencies` кореневого `package.json` (дозволено лише `@nitra/*`)
+// — у rego (`npm/policy/bun/package_json/`). JS-копії `isAllowedRootDevDependency`
+// видалено, щоб не було двох джерел істини.
 
 /**
  * Зчитує ідентифікатори правил з `.n-cursor.json` (поле `rules`).