@nitra/cursor 1.13.13 → 1.13.14

package/CHANGELOG.md

@@ -4,6 +4,20 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
+## [1.13.14] - 2026-05-17
+
+### Added
+
+- `bun` rule template/ міграція (Phase 4): 2 концерни — `bunfig` (snippet-walker 2-level, `[install].linker = "hoisted"`) + `package_json` (partial — top-level deny-fields у template).
+- `bunfig_test.rego` створено з нуля (раніше тестів не було) — 5 позитивних/негативних + drift.
+
+### Changed
+
+- `bun.bunfig.rego` — використовує той самий 2-level snippet-walker, що `ga.vscode_settings` (leaf-by-leaf + guard на non-object section).
+- `bun.package_json.rego` — top-level deny-fields (`packageManager`, `dependencies`) тепер читаються з `data.template.deny`. Сентинельний value у `object.get(input, field, "__bun_missing__")` зберігає behavior «field present навіть якщо порожній обʼєкт». Логіка `@nitra/*`-only у devDependencies та lint-aggregator (cross-script) лишається у rego — це inverse-patterns, які не виносяться у template.
+- `bun.mdc` — inline `bunfig.toml` snippet замінено на template-link; додано посилання на `package.json.deny.json` для документації заборонених top-level полів.
+- `docs/adr/template-dir-concern-inventory.md` — `bun.*` концерни позначено ✓; додано Phase 4 у прогрес-секцію; tally: 15/39 (38%).
+
 ## [1.13.13] - 2026-05-17
 
 ### Added

package/package.json

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

package/rules/bun/bun.mdc

@@ -34,10 +34,7 @@ Lockfile у репозиторії: `bun.lock`.
 
 У корені репозиторію має бути **`bunfig.toml`** з **hoisted** лінкером (пласке `node_modules`, сумісне з інструментами, які не розуміють ізольований layout Bun):
 
-```toml title="bunfig.toml"
-[install]
-linker = "hoisted"
-```
+- Канон `bunfig.toml`: [bunfig.toml.snippet.toml](./policy/bunfig/template/bunfig.toml.snippet.toml)
 
 Для Bun monorepo:
 
@@ -45,9 +42,9 @@ linker = "hoisted"
 - Якщо залежність потрібна лише одному пакету, додавати її в директорії цього пакета.
 - У CI та локально запускати скрипти через `bun run`.
 
-В кореневому в package.json не повинно бути `dependencies`, а в `devDependencies` — тільки модулі `@nitra/*`
+В кореневому в package.json не повинно бути `dependencies`, а в `devDependencies` — тільки модулі `@nitra/*`. Якщо в package.json є поля `packageManager`, то прибрати їх, також прибрати всі директорії та файли для yarn.
 
-Якщо в package.json є поля `packageManager`, то прибрати їх, також прибрати всі директорії та файли для yarn
+- Заборонені top-level поля у root `package.json` (з причинами): [package.json.deny.json](./policy/package_json/template/package.json.deny.json)
 
 Коли зміна відбувається в Dockerfile, то використовувати
 

package/rules/bun/policy/bunfig/bunfig.rego

@@ -1,33 +1,29 @@
-# Порт перевірки `checkBunfigHoisted` з `npm/scripts/check-bun.mjs` (bun.mdc).
+# Перевірка `bunfig.toml` для bun (bun.mdc).
 #
-# Запуск (локально):
-#   conftest test bunfig.toml -p npm/policy/bun --namespace bun.bunfig
-#
-# Conftest парсить `.toml` нативно: секція `[install]` стає обʼєктом `input.install`.
-# FS-перевірки (наявність самого `bunfig.toml`, `bun.lock`, заборонені lockfile-и
-# `package-lock.json` тощо, директорія `.yarn/`) живуть у `check-bun.mjs` — Rego
-# працює лише з вже завантаженим input.
-#
-# Структура каталогу збігається зі шляхом пакету (regal: directory-package-mismatch).
-# Конвенція проєкту — `import rego.v1` + multi-value `deny contains msg if { … }`
-# (.cursor/rules/conftest.mdc). Лінт — `bun run lint-rego` (regal).
+# Канон надходить через --data: { "template": { "snippet": ... } }
+# Структура --data сформована з template/bunfig.toml.snippet.toml.
+# Snippet — 2-рівнева мапа (section → key → expected). Walker такий самий,
+# як для ga.vscode_settings: leaf-by-leaf коли section-обʼєкт існує + окремий
+# deny коли section відсутній / не обʼєкт.
 package bun.bunfig
 
 import rego.v1
 
+# Leaf-by-leaf: section присутня й обʼєкт.
 deny contains msg if {
-	# `object.get(…, false)` дає визначене значення, коли поля немає, інакше
-	# `not is_object(input.install)` повернув би `undefined`, і правило мовчки
-	# не спрацювало б (той самий патерн, що й у `ga.workflow_common`).
-	not is_object(object.get(input, "install", false))
-	msg := "bunfig.toml: відсутня секція [install] (bun.mdc)"
+	some section, expected_inner in data.template.snippet
+	inner := object.get(input, section, {})
+	is_object(inner)
+	some leaf_key, expected_value in expected_inner
+	actual := object.get(inner, leaf_key, null)
+	actual != expected_value
+	msg := sprintf("bunfig.toml: у секції [%s] має бути %s = %q (bun.mdc)", [section, leaf_key, expected_value])
 }
 
+# Section відсутня (null) або не обʼєкт.
 deny contains msg if {
-	is_object(object.get(input, "install", false))
-
-	# `object.get(…, null)` робить значення визначеним, інакше при відсутньому
-	# `linker` порівняння `!= "hoisted"` дало б `undefined`, не `true`.
-	object.get(input.install, "linker", null) != "hoisted"
-	msg := "bunfig.toml: у секції [install] має бути linker = \"hoisted\" (bun.mdc)"
+	some section in object.keys(data.template.snippet)
+	raw := object.get(input, section, null)
+	not is_object(raw)
+	msg := sprintf("bunfig.toml: відсутня секція [%s] (bun.mdc)", [section])
 }

package/rules/bun/policy/bunfig/template/bunfig.toml.snippet.toml

@@ -0,0 +1,2 @@
+[install]
+linker = "hoisted"

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

@@ -1,47 +1,38 @@
-# Порт структурних перевірок `package.json` з `npm/scripts/check-bun.mjs` (bun.mdc).
+# Перевірка кореневого `package.json` для bun (bun.mdc).
 #
-# Запуск (локально, КОРЕНЕВИЙ package.json):
-#   conftest test package.json -p npm/policy/bun --namespace bun.package_json
+# Канон надходить через --data: { "template": { "deny": ... } }
+# Структура --data сформована з template/package.json.deny.json
+# (top-level fields заборонені у root).
 #
-# Перевіряє: відсутність `packageManager`, відсутність кореневих `dependencies`,
-# у `devDependencies` лише `@nitra/*`, агрегований `lint`-скрипт (якщо є `lint-*`
-# скрипти): покриває всі lint-* через `bun run`, закінчується на `&& oxfmt .`.
+# Логіка, що ЛИШАЄТЬСЯ у rego (inverse-patterns, не виносяться у template):
+#  - `devDependencies` лише `@nitra/*` (inverse-pattern: every dep must match)
+#  - Агрегований `lint` скрипт (cross-script aggregation logic)
 #
 # Перевірки, які ЗАЛИШИЛИСЬ у JS (потребують FS / cross-file):
 #  - `lint-docker` / `lint-k8s` коли `.n-cursor.json:rules` містить відповідне
 #    правило (потрібен другий файл-вхід — у Rego без `--combine` не зробити).
-#
-# Структура каталогу збігається зі шляхом пакету (regal: directory-package-mismatch).
-# Конвенція проєкту — `import rego.v1` + multi-value `deny contains msg if { … }`
-# (.cursor/rules/conftest.mdc). Лінт — `bun run lint-rego` (regal).
 package bun.package_json
 
 import rego.v1
 
 # ── Шаблони повідомлень ────────────────────────────────────────────────────
 
-# Через `concat` — дотримуємося regal style/line-length.
 lint_aggregate_missing_template := concat(" ", [
 	"У package.json є скрипти %v, але немає агрегованого `lint`.",
 	"Додай скрипт, який запускає їх через `bun run` (bun.mdc)",
 ])
 
-# ── deny: заборонені поля ──────────────────────────────────────────────────
-
-deny contains msg if {
-	pm := object.get(input, "packageManager", "")
-	pm != ""
-	msg := sprintf("package.json містить поле packageManager: %q — видали його (bun.mdc)", [pm])
-}
+# ── deny: заборонені top-level поля (template-driven) ─────────────────────
 
-# `dependencies` не повинно бути взагалі — навіть пусте `{}`. Сентинельний рядок
-# дозволяє відрізнити «поле відсутнє» від «поле є з будь-яким значенням».
+# Сентинельний value відрізняє «поле відсутнє» від «поле є з будь-яким значенням»
+# (наприклад `dependencies: {}` — присутнє але порожнє → теж заборонено).
 deny contains msg if {
-	object.get(input, "dependencies", "__bun_missing__") != "__bun_missing__"
-	msg := "Кореневий package.json не повинен містити поле dependencies — додай залежності в workspace-пакети (bun.mdc)"
+	some field, reason in data.template.deny
+	object.get(input, field, "__bun_missing__") != "__bun_missing__"
+	msg := sprintf("package.json: поле %s — %s", [field, reason])
 }
 
-# ── deny: devDependencies — лише `@nitra/*` ───────────────────────────────
+# ── deny: devDependencies — лише `@nitra/*` (inverse pattern; не виноситься у template) ─
 
 deny contains msg if {
 	is_object(input.devDependencies)
@@ -50,11 +41,7 @@ deny contains msg if {
 	msg := sprintf("Кореневі devDependencies: дозволені лише @nitra/* — прибери або перенеси: %s (bun.mdc)", [name])
 }
 
-# ── deny: агрегований lint-скрипт ─────────────────────────────────────────
-#
-# Якщо в `scripts` є хоч один `lint-*`, має бути скрипт `lint`, у якому
-# через `bun run <ім'я>` викликається кожен такий скрипт; рядок завершується
-# на `&& oxfmt .`.
+# ── deny: агрегований lint-скрипт (cross-script aggregation logic) ───────
 
 deny contains msg if {
 	count(lint_prefixed_scripts) > 0
@@ -73,22 +60,17 @@ deny contains msg if {
 deny contains msg if {
 	count(lint_prefixed_scripts) > 0
 	lint_script != ""
-
-	# Перевіряємо, що рядок завершується `&& oxfmt .` (з можливими пробілами/табами).
-	# Trim не потрібен — пробіли/таби в кінці допускаємо в самому regex (`[ \t]*$`).
 	not regex.match(`&&[ \t]+oxfmt[ \t]+\.[ \t]*$`, lint_script)
 	msg := "Скрипт `lint` має закінчуватися на `&& oxfmt .` (bun.mdc)"
 }
 
 # ── helpers ────────────────────────────────────────────────────────────────
 
-# Ключі скриптів, що починаються з `lint-` (наприклад `lint-js`, `lint-ga`).
 lint_prefixed_scripts := [name |
 	some name, _ in object.get(input, "scripts", {})
 	startswith(name, "lint-")
 ]
 
-# Значення `scripts.lint` як рядок (порожній, якщо поля немає або тип не string).
 default lint_script := ""
 
 lint_script := input.scripts.lint if is_string(input.scripts.lint)

package/rules/bun/policy/package_json/template/package.json.deny.json

@@ -0,0 +1,4 @@
+{
+  "packageManager": "видали поле — Bun не потребує packageManager (bun.mdc)",
+  "dependencies": "кореневий package.json не повинен містити dependencies — додай у workspace-пакети (bun.mdc)"
+}